release: 0.1.0-alpha.13 (#24)

stainless-app[bot] · web-flow · commit 54acda757e0f · 2025-09-08T19:46:38.000-04:00
Co-authored-by: stainless-app[bot] &lt;142633134+stainless-app[bot]@users.noreply.github.com&gt;
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.12"
+  ".": "0.1.0-alpha.13"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 9
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/the-san-francisco-compute-company%2Fsfc-nodes-64b3af1a7aa80906205b3369d34afb7c2686ab1c184f4683d81f2e3adffa255e.yml
-openapi_spec_hash: 4a63ec0585f1f25c42f1a612345f7ab4
-config_hash: b63d685bc4feb4db73f82791193686bd
+configured_endpoints: 13
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/the-san-francisco-compute-company%2Fsfc-nodes-94c657d18a94013c3a191579d7a41e20d5b40861844489a05a0316c74604e61c.yml
+openapi_spec_hash: 0ca0c3bdefefb0f150cf193809bb083a
+config_hash: 20852160fd697b0edb4b28a75eff4223
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.1.0-alpha.13 (2025-09-08)
+
+Full Changelog: [v0.1.0-alpha.12...v0.1.0-alpha.13](https://github.com/sfcompute/nodes-typescript/compare/v0.1.0-alpha.12...v0.1.0-alpha.13)
+
+### Features
+
+* **api:** add vm images resources and update formatting ([ec522b7](https://github.com/sfcompute/nodes-typescript/commit/ec522b78c974e70ecd2c58f0bbe85ab4537112ab))
+* **api:** disable retries ([6188d02](https://github.com/sfcompute/nodes-typescript/commit/6188d028d12cefaa902e099988b7e9276627a0af))
+
+
+### Chores
+
+* ci build action ([cc7fec2](https://github.com/sfcompute/nodes-typescript/commit/cc7fec2a36cc3bc72373536ae733d1da4a44b18d))
+
 ## 0.1.0-alpha.12 (2025-09-05)
 
 Full Changelog: [v0.1.0-alpha.11...v0.1.0-alpha.12](https://github.com/sfcompute/nodes-typescript/compare/v0.1.0-alpha.11...v0.1.0-alpha.12)
diff --git a/README.md b/README.md
@@ -82,7 +82,7 @@ Error codes are as follows:
 
 ### Retries
 
-Certain errors will be automatically retried 2 times by default, with a short exponential backoff.
+Certain errors will be automatically retried 0 times by default, with a short exponential backoff.
 Connection errors (for example, due to a network connectivity problem), 408 Request Timeout, 409 Conflict,
 429 Rate Limit, and >=500 Internal errors will all be retried by default.
 
diff --git a/api.md b/api.md
@@ -1,14 +1,14 @@
-# Vms
+# VMs
 
 Types:
 
-- <code><a href="./src/resources/vms/vms.ts">VmLogsResponse</a></code>
-- <code><a href="./src/resources/vms/vms.ts">VmSSHResponse</a></code>
+- <code><a href="./src/resources/vms/vms.ts">VMLogsResponse</a></code>
+- <code><a href="./src/resources/vms/vms.ts">VMSSHResponse</a></code>
 
 Methods:
 
-- <code title="get /v0/vms/logs2">client.vms.<a href="./src/resources/vms/vms.ts">logs</a>({ ...params }) -> VmLogsResponse</code>
-- <code title="get /v0/vms/ssh">client.vms.<a href="./src/resources/vms/vms.ts">ssh</a>({ ...params }) -> VmSSHResponse</code>
+- <code title="get /v0/vms/logs2">client.vms.<a href="./src/resources/vms/vms.ts">logs</a>({ ...params }) -> VMLogsResponse</code>
+- <code title="get /v0/vms/ssh">client.vms.<a href="./src/resources/vms/vms.ts">ssh</a>({ ...params }) -> VMSSHResponse</code>
 
 ## Script
 
@@ -23,6 +23,22 @@ Methods:
 - <code title="post /v0/vms/script">client.vms.script.<a href="./src/resources/vms/script.ts">create</a>({ ...params }) -> ScriptCreateResponse</code>
 - <code title="get /v0/vms/script">client.vms.script.<a href="./src/resources/vms/script.ts">retrieve</a>() -> ScriptRetrieveResponse</code>
 
+## Images
+
+Types:
+
+- <code><a href="./src/resources/vms/images.ts">ImageCompleteUploadResponse</a></code>
+- <code><a href="./src/resources/vms/images.ts">ImageGetResponse</a></code>
+- <code><a href="./src/resources/vms/images.ts">ImageStartUploadResponse</a></code>
+- <code><a href="./src/resources/vms/images.ts">ImageUploadResponse</a></code>
+
+Methods:
+
+- <code title="patch /v1/vms/images/{image_id}/complete_upload">client.vms.images.<a href="./src/resources/vms/images.ts">completeUpload</a>(imageID) -> ImageCompleteUploadResponse</code>
+- <code title="get /v1/vms/images/{image_id}">client.vms.images.<a href="./src/resources/vms/images.ts">get</a>(imageID) -> ImageGetResponse</code>
+- <code title="post /v1/vms/images/start_upload">client.vms.images.<a href="./src/resources/vms/images.ts">startUpload</a>({ ...params }) -> ImageStartUploadResponse</code>
+- <code title="post /v1/vms/images/{image_id}/upload">client.vms.images.<a href="./src/resources/vms/images.ts">upload</a>(imageID, { ...params }) -> ImageUploadResponse</code>
+
 # Nodes
 
 Types:
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@sfcompute/nodes-sdk-alpha",
-  "version": "0.1.0-alpha.12",
+  "version": "0.1.0-alpha.13",
   "description": "The official TypeScript library for the SFC Nodes API",
   "author": "SFC Nodes <hello@sfcompute.com>",
   "types": "dist/index.d.ts",
diff --git a/scripts/utils/upload-artifact.sh b/scripts/utils/upload-artifact.sh
@@ -12,7 +12,7 @@ if [[ "$SIGNED_URL" == "null" ]]; then
   exit 1
 fi
 
-UPLOAD_RESPONSE=$(tar -cz "${BUILD_PATH:-dist}" | curl -v -X PUT \
+UPLOAD_RESPONSE=$(tar "${BASE_PATH:+-C$BASE_PATH}" -cz "${ARTIFACT_PATH:-dist}" | curl -v -X PUT \
   -H "Content-Type: application/gzip" \
   --data-binary @- "$SIGNED_URL" 2>&1)
 
diff --git a/src/client.ts b/src/client.ts
@@ -34,7 +34,7 @@ import {
   Nodes,
   Status,
 } from './resources/nodes';
-import { VmLogsParams, VmLogsResponse, VmSSHParams, VmSSHResponse, Vms } from './resources/vms/vms';
+import { VMLogsParams, VMLogsResponse, VMSSHParams, VMSSHResponse, VMs } from './resources/vms/vms';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -88,7 +88,7 @@ export interface ClientOptions {
    * The maximum number of times that the client will retry a request in case of a
    * temporary failure, like a network error or a 5XX error from the server.
    *
-   * @default 2
+   * @default 0
    */
   maxRetries?: number | undefined;
 
@@ -149,7 +149,7 @@ export class SFCNodes {
    * @param {number} [opts.timeout=1 minute] - The maximum amount of time (in milliseconds) the client will wait for a response before timing out.
    * @param {MergedRequestInit} [opts.fetchOptions] - Additional `RequestInit` options to be passed to `fetch` calls.
    * @param {Fetch} [opts.fetch] - Specify a custom `fetch` function implementation.
-   * @param {number} [opts.maxRetries=2] - The maximum number of times the client will retry a request.
+   * @param {number} [opts.maxRetries=0] - The maximum number of times the client will retry a request.
    * @param {HeadersLike} opts.defaultHeaders - Default headers to include with every request to the API.
    * @param {Record<string, string | undefined>} opts.defaultQuery - Default query parameters to include with every request to the API.
    */
@@ -175,7 +175,7 @@ export class SFCNodes {
       parseLogLevel(readEnv('SFC_NODES_LOG'), "process.env['SFC_NODES_LOG']", this) ??
       defaultLogLevel;
     this.fetchOptions = options.fetchOptions;
-    this.maxRetries = options.maxRetries ?? 2;
+    this.maxRetries = options.maxRetries ?? 0;
     this.fetch = options.fetch ?? Shims.getDefaultFetch();
     this.#encoder = Opts.FallbackEncoder;
 
@@ -722,22 +722,22 @@ export class SFCNodes {
 
   static toFile = Uploads.toFile;
 
-  vms: API.Vms = new API.Vms(this);
+  vms: API.VMs = new API.VMs(this);
   nodes: API.Nodes = new API.Nodes(this);
 }
 
-SFCNodes.Vms = Vms;
+SFCNodes.VMs = VMs;
 SFCNodes.Nodes = Nodes;
 
 export declare namespace SFCNodes {
   export type RequestOptions = Opts.RequestOptions;
 
   export {
-    Vms as Vms,
-    type VmLogsResponse as VmLogsResponse,
-    type VmSSHResponse as VmSSHResponse,
-    type VmLogsParams as VmLogsParams,
-    type VmSSHParams as VmSSHParams,
+    VMs as VMs,
+    type VMLogsResponse as VMLogsResponse,
+    type VMSSHResponse as VMSSHResponse,
+    type VMLogsParams as VMLogsParams,
+    type VMSSHParams as VMSSHParams,
   };
 
   export {
diff --git a/src/internal/request-options.ts b/src/internal/request-options.ts
@@ -40,7 +40,7 @@ export type RequestOptions = {
    * The maximum number of times that the client will retry a request in case of a
    * temporary failure, like a network error or a 5XX error from the server.
    *
-   * @default 2
+   * @default 0
    */
   maxRetries?: number;
 
diff --git a/src/resources/index.ts b/src/resources/index.ts
@@ -17,4 +17,4 @@ export {
   type NodeListParams,
   type NodeExtendParams,
 } from './nodes';
-export { Vms, type VmLogsResponse, type VmSSHResponse, type VmLogsParams, type VmSSHParams } from './vms/vms';
+export { VMs, type VMLogsResponse, type VMSSHResponse, type VMLogsParams, type VMSSHParams } from './vms/vms';
diff --git a/src/resources/nodes.ts b/src/resources/nodes.ts
@@ -232,19 +232,19 @@ export namespace ListResponseNode {
      */
     updated_at?: number | null;
 
-    vms?: Data.Vms | null;
+    vms?: Data.VMs | null;
 
     zone?: string | null;
   }
 
   export namespace Data {
-    export interface Vms {
-      data: Array<Vms.Data>;
+    export interface VMs {
+      data: Array<VMs.Data>;
 
       object: string;
     }
 
-    export namespace Vms {
+    export namespace VMs {
       export interface Data {
         id: string;
 
@@ -314,19 +314,19 @@ export interface Node {
    */
   updated_at?: number | null;
 
-  vms?: Node.Vms | null;
+  vms?: Node.VMs | null;
 
   zone?: string | null;
 }
 
 export namespace Node {
-  export interface Vms {
-    data: Array<Vms.Data>;
+  export interface VMs {
+    data: Array<VMs.Data>;
 
     object: string;
   }
 
-  export namespace Vms {
+  export namespace VMs {
     export interface Data {
       id: string;
 
diff --git a/src/resources/vms/images.ts b/src/resources/vms/images.ts
@@ -0,0 +1,121 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Images extends APIResource {
+  completeUpload(imageID: string, options?: RequestOptions): APIPromise<ImageCompleteUploadResponse> {
+    return this._client.patch(path`/v1/vms/images/${imageID}/complete_upload`, options);
+  }
+
+  get(imageID: string, options?: RequestOptions): APIPromise<ImageGetResponse> {
+    return this._client.get(path`/v1/vms/images/${imageID}`, options);
+  }
+
+  startUpload(body: ImageStartUploadParams, options?: RequestOptions): APIPromise<ImageStartUploadResponse> {
+    return this._client.post('/v1/vms/images/start_upload', { body, ...options });
+  }
+
+  upload(
+    imageID: string,
+    body: ImageUploadParams,
+    options?: RequestOptions,
+  ): APIPromise<ImageUploadResponse> {
+    return this._client.post(path`/v1/vms/images/${imageID}/upload`, { body, ...options });
+  }
+}
+
+/**
+ * Response body for completing a multipart upload
+ */
+export interface ImageCompleteUploadResponse {
+  /**
+   * The image ID
+   */
+  image_id: string;
+
+  object: 'image';
+
+  /**
+   * Status of the upload verification
+   */
+  upload_status: string;
+}
+
+/**
+ * Response body for image download presigned URL generation
+ */
+export interface ImageGetResponse {
+  /**
+   * The presigned URL that can be used to download the image
+   */
+  download_url: string;
+
+  etag: string;
+
+  /**
+   * Timestamp when the presigned URL expires (RFC 3339 format)
+   */
+  expires_at: string;
+
+  /**
+   * The image ID
+   */
+  image_id: string;
+
+  object: 'image';
+}
+
+/**
+ * Response body for starting a multipart upload
+ */
+export interface ImageStartUploadResponse {
+  /**
+   * The image ID for the created image
+   */
+  image_id: string;
+
+  object: 'image';
+}
+
+/**
+ * Response body for image upload presigned URL generation
+ */
+export interface ImageUploadResponse {
+  /**
+   * Timestamp when the presigned URL expires (RFC 3339 format)
+   */
+  expires_at: string;
+
+  /**
+   * The presigned URL that can be used to upload the image part
+   */
+  upload_url: string;
+}
+
+export interface ImageStartUploadParams {
+  /**
+   * Name of the image file
+   */
+  name: string;
+}
+
+export interface ImageUploadParams {
+  /**
+   * part idx (1-based)
+   */
+  part_id: number;
+}
+
+export declare namespace Images {
+  export {
+    type ImageCompleteUploadResponse as ImageCompleteUploadResponse,
+    type ImageGetResponse as ImageGetResponse,
+    type ImageStartUploadResponse as ImageStartUploadResponse,
+    type ImageUploadResponse as ImageUploadResponse,
+    type ImageStartUploadParams as ImageStartUploadParams,
+    type ImageUploadParams as ImageUploadParams,
+  };
+}
diff --git a/src/resources/vms/index.ts b/src/resources/vms/index.ts
@@ -1,10 +1,19 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  Images,
+  type ImageCompleteUploadResponse,
+  type ImageGetResponse,
+  type ImageStartUploadResponse,
+  type ImageUploadResponse,
+  type ImageStartUploadParams,
+  type ImageUploadParams,
+} from './images';
 export {
   Script,
   type UserData,
   type ScriptCreateResponse,
   type ScriptRetrieveResponse,
   type ScriptCreateParams,
 } from './script';
-export { Vms, type VmLogsResponse, type VmSSHResponse, type VmLogsParams, type VmSSHParams } from './vms';
+export { VMs, type VMLogsResponse, type VMSSHResponse, type VMLogsParams, type VMSSHParams } from './vms';
diff --git a/src/resources/vms/vms.ts b/src/resources/vms/vms.ts
diff --git a/src/version.ts b/src/version.ts
diff --git a/tests/api-resources/vms/images.test.ts b/tests/api-resources/vms/images.test.ts
diff --git a/tests/index.test.ts b/tests/index.test.ts

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "0.1.0-alpha.12"`
	`2`	`+ ".": "0.1.0-alpha.13"`
`3`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@sfcompute/nodes-sdk-alpha",`
`3`		`- "version": "0.1.0-alpha.12",`
	`3`	`+ "version": "0.1.0-alpha.13",`
`4`	`4`	`"description": "The official TypeScript library for the SFC Nodes API",`
`5`	`5`	`"author": "SFC Nodes <[email protected]>",`
`6`	`6`	`"types": "dist/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -40,7 +40,7 @@ export type RequestOptions = {`
`40`	`40`	`* The maximum number of times that the client will retry a request in case of a`
`41`	`41`	`* temporary failure, like a network error or a 5XX error from the server.`
`42`	`42`	`*`
`43`		`- * @default 2`
	`43`	`+ * @default 0`
`44`	`44`	`*/`
`45`	`45`	`maxRetries?: number;`
`46`	`46`