release: 0.1.0-alpha.22 (#33)

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.21"
+  ".": "0.1.0-alpha.22"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 13
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/the-san-francisco-compute-company%2Fsfc-nodes-80cab7746a6cdf7657e218c427ff7e13db1ac2454eacaccf0f36120234d49a3d.yml
-openapi_spec_hash: c36b216292e88e7bd8d57ef05cf67cf2
-config_hash: 5ab998e0c5691df351205dfc14a2cfaf
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/the-san-francisco-compute-company%2Fsfc-nodes-94404552501d1e6ece9700dbddd3cd49ddc555fdb3a303747b79aea2329cf10c.yml
+openapi_spec_hash: edc38468ad76935dc4b0d6af44e84d44
+config_hash: cf202573c712b5d91a4d496f35f0ff57

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.1.0-alpha.22 (2025-10-17)
+
+Full Changelog: [v0.1.0-alpha.21...v0.1.0-alpha.22](https://github.com/sfcompute/nodes-typescript/compare/v0.1.0-alpha.21...v0.1.0-alpha.22)
+
+### Features
+
+* **api:** api update ([f930370](https://github.com/sfcompute/nodes-typescript/commit/f930370ca4c3d504de72631104b7cb953fa1c5a0))
+* **api:** api update ([d003594](https://github.com/sfcompute/nodes-typescript/commit/d003594ed31b0b93000db809a3a83eaa37ef08d0))
+* **api:** api update ([3cecf63](https://github.com/sfcompute/nodes-typescript/commit/3cecf63f4323bcaa132273ac9bce32b265e45875))
+
+
+### Chores
+
+* **internal:** use npm pack for build uploads ([f516a26](https://github.com/sfcompute/nodes-typescript/commit/f516a262b68fc4c62ba94ddff3efbb67589a59a3))
+* **jsdoc:** fix [@link](https://github.com/link) annotations to refer only to parts of the package‘s public interface ([9566d5a](https://github.com/sfcompute/nodes-typescript/commit/9566d5a2b605e95e2169e70aeae2c53748b5c9fd))
+
 ## 0.1.0-alpha.21 (2025-10-02)
 
 Full Changelog: [v0.1.0-alpha.20...v0.1.0-alpha.21](https://github.com/sfcompute/nodes-typescript/compare/v0.1.0-alpha.20...v0.1.0-alpha.21)

package.json

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

scripts/utils/upload-artifact.sh

@@ -12,9 +12,11 @@ if [[ "$SIGNED_URL" == "null" ]]; then
   exit 1
 fi
 
-UPLOAD_RESPONSE=$(tar "${BASE_PATH:+-C$BASE_PATH}" -cz "${ARTIFACT_PATH:-dist}" | curl -v -X PUT \
+TARBALL=$(cd dist && npm pack --silent)
+
+UPLOAD_RESPONSE=$(curl -v -X PUT \
   -H "Content-Type: application/gzip" \
-  --data-binary @- "$SIGNED_URL" 2>&1)
+  --data-binary "@dist/$TARBALL" "$SIGNED_URL" 2>&1)
 
 if echo "$UPLOAD_RESPONSE" | grep -q "HTTP/[0-9.]* 200"; then
   echo -e "\033[32mUploaded build to Stainless storage.\033[0m"

src/internal/to-file.ts

@@ -73,7 +73,7 @@ export type ToFileInput =
 
 /**
  * Helper for creating a {@link File} to pass to an SDK upload method from a variety of different data formats
- * @param value the raw content of the file.  Can be an {@link Uploadable}, {@link BlobLikePart}, or {@link AsyncIterable} of {@link BlobLikePart}s
+ * @param value the raw content of the file. Can be an {@link Uploadable}, BlobLikePart, or AsyncIterable of BlobLikeParts
  * @param {string=} name the name of the file. If omitted, toFile will try to determine a file name from bits if possible
  * @param {Object=} options additional properties
  * @param {string=} options.type the MIME type of the content

src/resources/nodes.ts

@@ -25,7 +25,7 @@ export class Nodes extends APIResource {
   }
 
   /**
-   * List all VM nodes for the authenticated account
+   * List all nodes for the authenticated account
    *
    * @example
    * ```ts
@@ -124,7 +124,8 @@ export interface CreateNodesRequest {
   zone: string;
 
   /**
-   * User script to be executed during the VM's boot process
+   * User script to be executed during the VM's boot process Data should be base64
+   * encoded
    */
   cloud_init_user_data?: string;
 
@@ -140,15 +141,17 @@ export interface CreateNodesRequest {
   image_id?: string;
 
   /**
-   * Custom node names Names cannot follow the vm\_{alpha_numeric_chars} as this is
-   * reserved for system-generated IDs Names cannot be numeric strings
+   * Custom node names Names cannot begin with 'vm*' or 'n*' as this is reserved for
+   * system-generated IDs Names cannot be numeric strings Names cannot exceed 128
+   * characters
    */
   names?: Array<string>;
 
   node_type?: NodeType | null;
 
   /**
-   * Start time as Unix timestamp in seconds Required for reserved nodes
+   * Start time as Unix timestamp in seconds Optional for reserved nodes. If not
+   * provided, defaults to current time
    */
   start_at?: number;
 }
@@ -453,7 +456,8 @@ export interface NodeCreateParams {
   zone: string;
 
   /**
-   * User script to be executed during the VM's boot process
+   * User script to be executed during the VM's boot process Data should be base64
+   * encoded
    */
   cloud_init_user_data?: string;
 
@@ -469,31 +473,38 @@ export interface NodeCreateParams {
   image_id?: string;
 
   /**
-   * Custom node names Names cannot follow the vm\_{alpha_numeric_chars} as this is
-   * reserved for system-generated IDs Names cannot be numeric strings
+   * Custom node names Names cannot begin with 'vm*' or 'n*' as this is reserved for
+   * system-generated IDs Names cannot be numeric strings Names cannot exceed 128
+   * characters
    */
   names?: Array<string>;
 
   node_type?: NodeType | null;
 
   /**
-   * Start time as Unix timestamp in seconds Required for reserved nodes
+   * Start time as Unix timestamp in seconds Optional for reserved nodes. If not
+   * provided, defaults to current time
    */
   start_at?: number;
 }
 
 export interface NodeListParams {
   /**
    * Filter nodes by node_id Use ?id=n_b1dc52505c6db142&id=n_b1dc52505c6db133 to
-   * specify multiple IDs. Cannot be used with name
+   * specify multiple IDs. Cannot combine with name or node_type
    */
   id?: Array<string>;
 
   /**
    * Filter nodes by their names Use ?name=val1&name=val2 to specify multiple names.
-   * Cannot be used with id
+   * Cannot combine with id or node_type
    */
   name?: Array<string>;
+
+  /**
+   * Filter nodes by their type Cannot combine with id or name
+   */
+  type?: NodeType;
 }
 
 export interface NodeExtendParams {

src/version.ts

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

tests/api-resources/nodes.test.ts

@@ -55,7 +55,10 @@ describe('resource nodes', () => {
   test.skip('list: request options and params are passed correctly', async () => {
     // ensure the request options are being passed correctly by passing an invalid HTTP method in order to cause an error
     await expect(
-      client.nodes.list({ id: ['string'], name: ['string'] }, { path: '/_stainless_unknown_path' }),
+      client.nodes.list(
+        { id: ['string'], name: ['string'], type: 'autoreserved' },
+        { path: '/_stainless_unknown_path' },
+      ),
     ).rejects.toThrow(SFCNodes.NotFoundError);
   });