release: 0.1.0-alpha.19 (#30)

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.18"
+  ".": "0.1.0-alpha.19"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 12
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/the-san-francisco-compute-company%2Fsfc-nodes-3ed2b55187b3b17772db0e76c4007d8828b37fdf49a87fb664cdf994db49cb42.yml
-openapi_spec_hash: 749a02e6ffc075b8d4e70a7a7800286a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/the-san-francisco-compute-company%2Fsfc-nodes-f5f616455c00f00755e37240a294c96c2353b63aa8238d54f03ff16831f321f3.yml
+openapi_spec_hash: 5d24f0033a95eabe54df671a80d0d91f
 config_hash: 6b29dc1aa86a29d01a2db850fd9b2bf0

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.0-alpha.19 (2025-10-02)
+
+Full Changelog: [v0.1.0-alpha.18...v0.1.0-alpha.19](https://github.com/sfcompute/nodes-typescript/compare/v0.1.0-alpha.18...v0.1.0-alpha.19)
+
+### Features
+
+* **api:** api update ([15676d7](https://github.com/sfcompute/nodes-typescript/commit/15676d70865603989b24b71d217f712c8f48ed21))
+
 ## 0.1.0-alpha.18 (2025-10-02)
 
 Full Changelog: [v0.1.0-alpha.17...v0.1.0-alpha.18](https://github.com/sfcompute/nodes-typescript/compare/v0.1.0-alpha.17...v0.1.0-alpha.18)

README.md

@@ -48,6 +48,60 @@ const listResponseNode: SFCNodes.ListResponseNode = await client.nodes.list();
 
 Documentation for each method, request param, and response field are available in docstrings and will appear on hover in most modern editors.
 
+## File uploads
+
+Request parameters that correspond to file uploads can be passed in many different forms:
+
+- `File` (or an object with the same structure)
+- a `fetch` `Response` (or an object with the same structure)
+- an `fs.ReadStream`
+- the return value of our `toFile` helper
+
+```ts
+import fs from 'fs';
+import SFCNodes, { toFile } from '@sfcompute/nodes-sdk-alpha';
+
+const client = new SFCNodes();
+
+// If you have access to Node `fs` we recommend using `fs.createReadStream()`:
+await client.nodes.create({
+  desired_count: 1,
+  max_price_per_node_hour: 1000,
+  zone: 'hayesvalley',
+  cloud_init_user_data: fs.createReadStream('/path/to/file'),
+});
+
+// Or if you have the web `File` API you can pass a `File` instance:
+await client.nodes.create({
+  desired_count: 1,
+  max_price_per_node_hour: 1000,
+  zone: 'hayesvalley',
+  cloud_init_user_data: new File(['my bytes'], 'file'),
+});
+
+// You can also pass a `fetch` `Response`:
+await client.nodes.create({
+  desired_count: 1,
+  max_price_per_node_hour: 1000,
+  zone: 'hayesvalley',
+  cloud_init_user_data: await fetch('https://somesite/file'),
+});
+
+// Finally, if none of the above are convenient, you can use our `toFile` helper:
+await client.nodes.create({
+  desired_count: 1,
+  max_price_per_node_hour: 1000,
+  zone: 'hayesvalley',
+  cloud_init_user_data: await toFile(Buffer.from('my bytes'), 'file'),
+});
+await client.nodes.create({
+  desired_count: 1,
+  max_price_per_node_hour: 1000,
+  zone: 'hayesvalley',
+  cloud_init_user_data: await toFile(new Uint8Array([0, 1, 2]), 'file'),
+});
+```
+
 ## Handling errors
 
 When the library is unable to connect to the API,

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sfcompute/nodes-sdk-alpha",
-  "version": "0.1.0-alpha.18",
+  "version": "0.1.0-alpha.19",
   "description": "The official TypeScript library for the SFC Nodes API",
   "author": "SFC Nodes <[email protected]>",
   "types": "dist/index.d.ts",

src/resources/nodes.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../core/resource';
 import * as NodesAPI from './nodes';
 import { APIPromise } from '../core/api-promise';
+import { type Uploadable } from '../core/uploads';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
@@ -110,7 +111,7 @@ export interface CreateNodesRequest {
   /**
    * User script to be executed during the VM's boot process
    */
-  cloud_init_user_data?: Array<number>;
+  cloud_init_user_data?: Uploadable;
 
   /**
    * End time as Unix timestamp in seconds If provided, end time must be aligned to
@@ -439,7 +440,7 @@ export interface NodeCreateParams {
   /**
    * User script to be executed during the VM's boot process
    */
-  cloud_init_user_data?: Array<number>;
+  cloud_init_user_data?: Uploadable;
 
   /**
    * End time as Unix timestamp in seconds If provided, end time must be aligned to
@@ -495,9 +496,10 @@ export interface NodeExtendParams {
 
 export interface NodeRedeployParams {
   /**
-   * Update the cloud init user data for VMs running on this node
+   * Update the cloud init user data for VMs running on this node Data should be
+   * base64 encoded
    */
-  cloud_init_user_data?: Array<number>;
+  cloud_init_user_data?: Uploadable;
 
   /**
    * Redeploy node with this VM image ID

src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-alpha.18'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.19'; // x-release-please-version

tests/api-resources/nodes.test.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import SFCNodes from '@sfcompute/nodes-sdk-alpha';
+import SFCNodes, { toFile } from '@sfcompute/nodes-sdk-alpha';
 
 const client = new SFCNodes({
   bearerToken: 'My Bearer Token',
@@ -30,7 +30,7 @@ describe('resource nodes', () => {
       desired_count: 1,
       max_price_per_node_hour: 1000,
       zone: 'hayesvalley',
-      cloud_init_user_data: [0],
+      cloud_init_user_data: await toFile(Buffer.from('# my file contents'), 'README.md'),
       end_at: 0,
       image_id: 'vmi_1234567890abcdef',
       names: ['cuda-crunch'],