Merge pull request #513 from val-town/release-please--branches--main--changes--next--components--sdk

sophiehouser · web-flow · commit 5fe15bda9861 · 2025-03-04T10:04:35.000-05:00
release: 0.32.0
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.31.0"
+  ".": "0.32.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,2 +1,2 @@
-configured_endpoints: 35
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/val-town%2Fval-town-96c5c8e7372c1cfedb047e16fe48ce6cbf1a5c1ce242931b9347306942cc765c.yml
+configured_endpoints: 37
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/val-town%2Fval-town-d84dfa83575ab69d557d177944a1fa6146ad9fdd6fc555f6bb352a48f6a1daa0.yml
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.32.0 (2025-03-03)
+
+Full Changelog: [v0.31.0...v0.32.0](https://github.com/val-town/sdk/compare/v0.31.0...v0.32.0)
+
+### Features
+
+* **api:** api update ([#514](https://github.com/val-town/sdk/issues/514)) ([6c7c72e](https://github.com/val-town/sdk/commit/6c7c72e497dc8aa97a063d184e13fe231fbe5f37))
+
+
+### Documentation
+
+* update URLs from stainlessapi.com to stainless.com ([#512](https://github.com/val-town/sdk/issues/512)) ([11d8163](https://github.com/val-town/sdk/commit/11d8163ca8152102368f97e6c6d13fca98ca44b7))
+
 ## 0.31.0 (2025-02-25)
 
 Full Changelog: [v0.30.0...v0.31.0](https://github.com/val-town/sdk/compare/v0.30.0...v0.31.0)
diff --git a/README.md b/README.md
@@ -6,7 +6,7 @@ This library provides convenient access to the Val Town REST API from server-sid
 
 The REST API documentation can be found on [docs.val.town](https://docs.val.town). The full API of this library can be found in [api.md](api.md).
 
-It is generated with [Stainless](https://www.stainlessapi.com/).
+It is generated with [Stainless](https://www.stainless.com/).
 
 ## Installation
 
diff --git a/SECURITY.md b/SECURITY.md
@@ -2,9 +2,9 @@
 
 ## Reporting Security Issues
 
-This SDK is generated by [Stainless Software Inc](http://stainlessapi.com). Stainless takes security seriously, and encourages you to report any security vulnerability promptly so that appropriate action can be taken.
+This SDK is generated by [Stainless Software Inc](http://stainless.com). Stainless takes security seriously, and encourages you to report any security vulnerability promptly so that appropriate action can be taken.
 
-To report a security issue, please contact the Stainless team at security@stainlessapi.com.
+To report a security issue, please contact the Stainless team at security@stainless.com.
 
 ## Responsible Disclosure
 
diff --git a/api.md b/api.md
@@ -170,23 +170,27 @@ Methods:
 
 Types:
 
+- <code><a href="./src/resources/projects/projects.ts">ProjectCreateResponse</a></code>
 - <code><a href="./src/resources/projects/projects.ts">ProjectRetrieveResponse</a></code>
 - <code><a href="./src/resources/projects/projects.ts">ProjectListResponse</a></code>
 
 Methods:
 
+- <code title="post /v1/projects">client.projects.<a href="./src/resources/projects/projects.ts">create</a>({ ...params }) -> ProjectCreateResponse</code>
 - <code title="get /v1/projects/{project_id}">client.projects.<a href="./src/resources/projects/projects.ts">retrieve</a>(projectId) -> ProjectRetrieveResponse</code>
 - <code title="get /v1/projects">client.projects.<a href="./src/resources/projects/projects.ts">list</a>({ ...params }) -> ProjectListResponsesPageCursorURL</code>
 
 ## Branches
 
 Types:
 
+- <code><a href="./src/resources/projects/branches.ts">BranchCreateResponse</a></code>
 - <code><a href="./src/resources/projects/branches.ts">BranchRetrieveResponse</a></code>
 - <code><a href="./src/resources/projects/branches.ts">BranchListResponse</a></code>
 
 Methods:
 
+- <code title="post /v1/projects/{project_id}/branches">client.projects.branches.<a href="./src/resources/projects/branches.ts">create</a>(projectId, { ...params }) -> BranchCreateResponse</code>
 - <code title="get /v1/projects/{project_id}/branches/{branch_id}">client.projects.branches.<a href="./src/resources/projects/branches.ts">retrieve</a>(projectId, branchId) -> BranchRetrieveResponse</code>
 - <code title="get /v1/projects/{project_id}/branches">client.projects.branches.<a href="./src/resources/projects/branches.ts">list</a>(projectId, { ...params }) -> BranchListResponsesPageCursorURL</code>
 
@@ -196,10 +200,9 @@ Types:
 
 - <code><a href="./src/resources/projects/files.ts">FileRetrieveResponse</a></code>
 - <code><a href="./src/resources/projects/files.ts">FileListResponse</a></code>
-- <code><a href="./src/resources/projects/files.ts">FileContentResponse</a></code>
 
 Methods:
 
 - <code title="get /v1/projects/{project_id}/files/{path}">client.projects.files.<a href="./src/resources/projects/files.ts">retrieve</a>(projectId, path, { ...params }) -> FileRetrieveResponse</code>
 - <code title="get /v1/projects/{project_id}/files">client.projects.files.<a href="./src/resources/projects/files.ts">list</a>(projectId, { ...params }) -> FileListResponsesPageCursorURL</code>
-- <code title="get /v1/projects/{project_id}/files/{path}/content">client.projects.files.<a href="./src/resources/projects/files.ts">content</a>(projectId, path, { ...params }) -> unknown</code>
+- <code title="get /v1/projects/{project_id}/files/{path}/content">client.projects.files.<a href="./src/resources/projects/files.ts">content</a>(projectId, path, { ...params }) -> Response</code>
diff --git a/jsr.json b/jsr.json
@@ -1,6 +1,6 @@
 {
   "name": "@valtown/sdk",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "exports": "./index.ts",
   "publish": {
     "exclude": [
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@valtown/sdk",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "The official TypeScript library for the Val Town API",
   "author": "Val Town <support@val.town>",
   "types": "dist/index.d.ts",
diff --git a/src/index.ts b/src/index.ts
@@ -13,6 +13,8 @@ import { Sqlite, SqliteBatchParams, SqliteBatchResponse, SqliteExecuteParams } f
 import { Alias } from './resources/alias/alias';
 import { Me } from './resources/me/me';
 import {
+  ProjectCreateParams,
+  ProjectCreateResponse,
   ProjectListParams,
   ProjectListResponse,
   ProjectListResponsesPageCursorURL,
@@ -272,9 +274,11 @@ export declare namespace ValTown {
 
   export {
     Projects as Projects,
+    type ProjectCreateResponse as ProjectCreateResponse,
     type ProjectRetrieveResponse as ProjectRetrieveResponse,
     type ProjectListResponse as ProjectListResponse,
     ProjectListResponsesPageCursorURL as ProjectListResponsesPageCursorURL,
+    type ProjectCreateParams as ProjectCreateParams,
     type ProjectListParams as ProjectListParams,
   };
 
diff --git a/src/resources/index.ts b/src/resources/index.ts
@@ -8,8 +8,10 @@ export { Me } from './me/me';
 export {
   ProjectListResponsesPageCursorURL,
   Projects,
+  type ProjectCreateResponse,
   type ProjectRetrieveResponse,
   type ProjectListResponse,
+  type ProjectCreateParams,
   type ProjectListParams,
 } from './projects/projects';
 export { Search } from './search/search';
diff --git a/src/resources/projects/branches.ts b/src/resources/projects/branches.ts
@@ -5,6 +5,17 @@ import * as Core from '../../core';
 import { PageCursorURL, type PageCursorURLParams } from '../../pagination';
 
 export class Branches extends APIResource {
+  /**
+   * [BETA] Create a new branch
+   */
+  create(
+    projectId: string,
+    body: BranchCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<BranchCreateResponse> {
+    return this._client.post(`/v1/projects/${projectId}/branches`, { body, ...options });
+  }
+
   /**
    * [BETA] Get a branch by id
    */
@@ -33,6 +44,45 @@ export class Branches extends APIResource {
 
 export class BranchListResponsesPageCursorURL extends PageCursorURL<BranchListResponse> {}
 
+/**
+ * A Branch
+ */
+export interface BranchCreateResponse {
+  /**
+   * The id of the branch
+   */
+  id: string;
+
+  createdAt: string;
+
+  /**
+   * The id of the branch this branch was forked from
+   */
+  forkedBranchId: string | null;
+
+  links: BranchCreateResponse.Links;
+
+  name: string;
+
+  updatedAt: string;
+
+  version: number;
+}
+
+export namespace BranchCreateResponse {
+  export interface Links {
+    /**
+     * The URL of this resource on Val Town
+     */
+    html: string;
+
+    /**
+     * The URL of this resource on this API
+     */
+    self: string;
+  }
+}
+
 /**
  * A Branch
  */
@@ -111,15 +161,27 @@ export namespace BranchListResponse {
   }
 }
 
+export interface BranchCreateParams {
+  name: string;
+
+  /**
+   * The branch ID to fork from. If this is not specified, the new branch will be
+   * forked from main.
+   */
+  branchId?: string;
+}
+
 export interface BranchListParams extends PageCursorURLParams {}
 
 Branches.BranchListResponsesPageCursorURL = BranchListResponsesPageCursorURL;
 
 export declare namespace Branches {
   export {
+    type BranchCreateResponse as BranchCreateResponse,
     type BranchRetrieveResponse as BranchRetrieveResponse,
     type BranchListResponse as BranchListResponse,
     BranchListResponsesPageCursorURL as BranchListResponsesPageCursorURL,
+    type BranchCreateParams as BranchCreateParams,
     type BranchListParams as BranchListParams,
   };
 }
diff --git a/src/resources/projects/files.ts b/src/resources/projects/files.ts
@@ -5,6 +5,7 @@ import { isRequestOptions } from '../../core';
 import * as Core from '../../core';
 import * as Shared from '../shared';
 import { PageCursorURL, type PageCursorURLParams } from '../../pagination';
+import { type Response } from '../../_shims/index';
 
 export class Files extends APIResource {
   /**
@@ -41,14 +42,14 @@ export class Files extends APIResource {
     path: string,
     params?: FileContentParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<unknown>;
-  content(projectId: string, path: string, options?: Core.RequestOptions): Core.APIPromise<unknown>;
+  ): Core.APIPromise<Response>;
+  content(projectId: string, path: string, options?: Core.RequestOptions): Core.APIPromise<Response>;
   content(
     projectId: string,
     path: string,
     params: FileContentParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
-  ): Core.APIPromise<unknown> {
+  ): Core.APIPromise<Response> {
     if (isRequestOptions(params)) {
       return this.content(projectId, path, {}, params);
     }
@@ -64,13 +65,15 @@ export class Files extends APIResource {
       query,
       ...options,
       headers: {
+        Accept: 'application/octet-stream',
         ...(cacheControl != null ? { 'Cache-Control': cacheControl } : undefined),
         ...(ifMatch != null ? { 'If-Match': ifMatch } : undefined),
         ...(ifModifiedSince != null ? { 'If-Modified-Since': ifModifiedSince } : undefined),
         ...(ifNoneMatch != null ? { 'If-None-Match': ifNoneMatch } : undefined),
         ...(ifUnmodifiedSince != null ? { 'If-Unmodified-Since': ifUnmodifiedSince } : undefined),
         ...options?.headers,
       },
+      __binaryResponse: true,
     });
   }
 }
@@ -183,8 +186,6 @@ export namespace FileListResponse {
   }
 }
 
-export type FileContentResponse = unknown;
-
 export interface FileRetrieveParams {
   /**
    * Maximum items to return in each paginated response
@@ -267,7 +268,6 @@ export declare namespace Files {
   export {
     type FileRetrieveResponse as FileRetrieveResponse,
     type FileListResponse as FileListResponse,
-    type FileContentResponse as FileContentResponse,
     FileListResponsesPageCursorURL as FileListResponsesPageCursorURL,
     type FileRetrieveParams as FileRetrieveParams,
     type FileListParams as FileListParams,
diff --git a/src/resources/projects/index.ts b/src/resources/projects/index.ts
@@ -3,24 +3,27 @@
 export {
   BranchListResponsesPageCursorURL,
   Branches,
+  type BranchCreateResponse,
   type BranchRetrieveResponse,
   type BranchListResponse,
+  type BranchCreateParams,
   type BranchListParams,
 } from './branches';
 export {
   FileListResponsesPageCursorURL,
   Files,
   type FileRetrieveResponse,
   type FileListResponse,
-  type FileContentResponse,
   type FileRetrieveParams,
   type FileListParams,
   type FileContentParams,
 } from './files';
 export {
   ProjectListResponsesPageCursorURL,
   Projects,
+  type ProjectCreateResponse,
   type ProjectRetrieveResponse,
   type ProjectListResponse,
+  type ProjectCreateParams,
   type ProjectListParams,
 } from './projects';
diff --git a/src/resources/projects/projects.ts b/src/resources/projects/projects.ts
diff --git a/src/version.ts b/src/version.ts
diff --git a/tests/api-resources/projects/branches.test.ts b/tests/api-resources/projects/branches.test.ts
diff --git a/tests/api-resources/projects/files.test.ts b/tests/api-resources/projects/files.test.ts
diff --git a/tests/api-resources/projects/projects.test.ts b/tests/api-resources/projects/projects.test.ts

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "0.31.0"`
	`2`	`+ ".": "0.32.0"`
`3`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@valtown/sdk",`
`3`		`- "version": "0.31.0",`
	`3`	`+ "version": "0.32.0",`
`4`	`4`	`"exports": "./index.ts",`
`5`	`5`	`"publish": {`
`6`	`6`	`"exclude": [`