@valtown/sdk 0.30.0 → 0.32.0

package/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,
   };
 }

package/src/resources/projects/files.ts

@@ -1,10 +1,25 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../resource';
+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 {
+  /**
+   * Get metadata for files and directories in a project at the specified path
+   */
+  retrieve(
+    projectId: string,
+    path: string,
+    query: FileRetrieveParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<FileRetrieveResponse> {
+    return this._client.get(`/v1/projects/${projectId}/files/${path}`, { query, ...options });
+  }
+
   /**
    * Get metadata for files and directories in a project at the root directory
    */
@@ -18,10 +33,113 @@ export class Files extends APIResource {
       ...options,
     });
   }
+
+  /**
+   * Download file content
+   */
+  content(
+    projectId: string,
+    path: string,
+    params?: FileContentParams,
+    options?: Core.RequestOptions,
+  ): 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<Response> {
+    if (isRequestOptions(params)) {
+      return this.content(projectId, path, {}, params);
+    }
+    const {
+      'Cache-Control': cacheControl,
+      'If-Match': ifMatch,
+      'If-Modified-Since': ifModifiedSince,
+      'If-None-Match': ifNoneMatch,
+      'If-Unmodified-Since': ifUnmodifiedSince,
+      ...query
+    } = params;
+    return this._client.get(`/v1/projects/${projectId}/files/${path}/content`, {
+      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,
+    });
+  }
 }
 
 export class FileListResponsesPageCursorURL extends PageCursorURL<FileListResponse> {}
 
+/**
+ * A paginated result set
+ */
+export interface FileRetrieveResponse {
+  data: Array<FileRetrieveResponse.Data>;
+
+  /**
+   * Links to use for pagination
+   */
+  links: Shared.PaginationLinks;
+}
+
+export namespace FileRetrieveResponse {
+  /**
+   * A File or Directory's Metadata
+   */
+  export interface Data {
+    /**
+     * The id of the resource
+     */
+    id: string;
+
+    links: Data.Links;
+
+    name: string;
+
+    path: string;
+
+    type: 'directory' | 'file' | 'interval' | 'http' | 'email' | 'script';
+
+    updatedAt: string;
+
+    version: number;
+  }
+
+  export namespace Data {
+    export interface Links {
+      /**
+       * The URL of this resource on Val Town
+       */
+      html: string;
+
+      /**
+       * The URL of this resource's source code as a module
+       */
+      module: string;
+
+      /**
+       * The URL of this resource on this API
+       */
+      self: string;
+
+      /**
+       * This resource's web endpoint, where it serves a website or API
+       */
+      endpoint?: string;
+    }
+  }
+}
+
 /**
  * A File or Directory's Metadata
  */
@@ -68,6 +186,28 @@ export namespace FileListResponse {
   }
 }
 
+export interface FileRetrieveParams {
+  /**
+   * Maximum items to return in each paginated response
+   */
+  limit: number;
+
+  /**
+   * Number of items to skip in order to deliver paginated results
+   */
+  offset: number;
+
+  /**
+   * Id to query
+   */
+  branch_id?: string;
+
+  /**
+   * Specific branch version to query
+   */
+  version?: number;
+}
+
 export interface FileListParams extends PageCursorURLParams {
   /**
    * Id to query
@@ -85,12 +225,52 @@ export interface FileListParams extends PageCursorURLParams {
   version?: number;
 }
 
+export interface FileContentParams {
+  /**
+   * Query param: Id to query
+   */
+  branch_id?: string;
+
+  /**
+   * Query param: Specific branch version to query
+   */
+  version?: number;
+
+  /**
+   * Header param:
+   */
+  'Cache-Control'?: string;
+
+  /**
+   * Header param:
+   */
+  'If-Match'?: string;
+
+  /**
+   * Header param:
+   */
+  'If-Modified-Since'?: string;
+
+  /**
+   * Header param:
+   */
+  'If-None-Match'?: string;
+
+  /**
+   * Header param:
+   */
+  'If-Unmodified-Since'?: string;
+}
+
 Files.FileListResponsesPageCursorURL = FileListResponsesPageCursorURL;
 
 export declare namespace Files {
   export {
+    type FileRetrieveResponse as FileRetrieveResponse,
     type FileListResponse as FileListResponse,
     FileListResponsesPageCursorURL as FileListResponsesPageCursorURL,
+    type FileRetrieveParams as FileRetrieveParams,
     type FileListParams as FileListParams,
+    type FileContentParams as FileContentParams,
   };
 }

package/src/resources/projects/index.ts

@@ -3,15 +3,27 @@
 export {
   BranchListResponsesPageCursorURL,
   Branches,
+  type BranchCreateResponse,
   type BranchRetrieveResponse,
   type BranchListResponse,
+  type BranchCreateParams,
   type BranchListParams,
 } from './branches';
-export { FileListResponsesPageCursorURL, Files, type FileListResponse, type FileListParams } from './files';
+export {
+  FileListResponsesPageCursorURL,
+  Files,
+  type FileRetrieveResponse,
+  type FileListResponse,
+  type FileRetrieveParams,
+  type FileListParams,
+  type FileContentParams,
+} from './files';
 export {
   ProjectListResponsesPageCursorURL,
   Projects,
+  type ProjectCreateResponse,
   type ProjectRetrieveResponse,
   type ProjectListResponse,
+  type ProjectCreateParams,
   type ProjectListParams,
 } from './projects';

package/src/resources/projects/projects.ts

@@ -4,6 +4,8 @@ import { APIResource } from '../../resource';
 import * as Core from '../../core';
 import * as BranchesAPI from './branches';
 import {
+  BranchCreateParams,
+  BranchCreateResponse,
   BranchListParams,
   BranchListResponse,
   BranchListResponsesPageCursorURL,
@@ -11,7 +13,15 @@ import {
   Branches,
 } from './branches';
 import * as FilesAPI from './files';
-import { FileListParams, FileListResponse, FileListResponsesPageCursorURL, Files } from './files';
+import {
+  FileContentParams,
+  FileListParams,
+  FileListResponse,
+  FileListResponsesPageCursorURL,
+  FileRetrieveParams,
+  FileRetrieveResponse,
+  Files,
+} from './files';
 import { PageCursorURL, type PageCursorURLParams } from '../../pagination';
 
 /**
@@ -21,6 +31,13 @@ export class Projects extends APIResource {
   branches: BranchesAPI.Branches = new BranchesAPI.Branches(this._client);
   files: FilesAPI.Files = new FilesAPI.Files(this._client);
 
+  /**
+   * [BETA] Create a new project
+   */
+  create(body: ProjectCreateParams, options?: Core.RequestOptions): Core.APIPromise<ProjectCreateResponse> {
+    return this._client.post('/v1/projects', { body, ...options });
+  }
+
   /**
    * [BETA] Get a project by id
    */
@@ -41,6 +58,57 @@ export class Projects extends APIResource {
 
 export class ProjectListResponsesPageCursorURL extends PageCursorURL<ProjectListResponse> {}
 
+/**
+ * A Project
+ */
+export interface ProjectCreateResponse {
+  /**
+   * The id of the project
+   */
+  id: string;
+
+  author: ProjectCreateResponse.Author;
+
+  createdAt: string;
+
+  description: string | null;
+
+  /**
+   * The URL of this project's image
+   */
+  imageUrl: string | null;
+
+  links: ProjectCreateResponse.Links;
+
+  name: string;
+
+  /**
+   * This resource's privacy setting. Unlisted resources do not appear on profile
+   * pages or elsewhere, but you can link to them.
+   */
+  privacy: 'public' | 'unlisted' | 'private';
+}
+
+export namespace ProjectCreateResponse {
+  export interface Author {
+    id: string;
+
+    username: string | null;
+  }
+
+  export interface Links {
+    /**
+     * The URL of this resource on Val Town
+     */
+    html: string;
+
+    /**
+     * The URL of this resource on this API
+     */
+    self: string;
+  }
+}
+
 /**
  * A Project
  */
@@ -143,6 +211,16 @@ export namespace ProjectListResponse {
   }
 }
 
+export interface ProjectCreateParams {
+  name: string;
+
+  privacy: 'public' | 'unlisted' | 'private';
+
+  description?: string;
+
+  imageUrl?: string;
+}
+
 export interface ProjectListParams extends PageCursorURLParams {}
 
 Projects.ProjectListResponsesPageCursorURL = ProjectListResponsesPageCursorURL;
@@ -153,24 +231,31 @@ Projects.FileListResponsesPageCursorURL = FileListResponsesPageCursorURL;
 
 export declare namespace Projects {
   export {
+    type ProjectCreateResponse as ProjectCreateResponse,
     type ProjectRetrieveResponse as ProjectRetrieveResponse,
     type ProjectListResponse as ProjectListResponse,
     ProjectListResponsesPageCursorURL as ProjectListResponsesPageCursorURL,
+    type ProjectCreateParams as ProjectCreateParams,
     type ProjectListParams as ProjectListParams,
   };
 
   export {
     Branches as Branches,
+    type BranchCreateResponse as BranchCreateResponse,
     type BranchRetrieveResponse as BranchRetrieveResponse,
     type BranchListResponse as BranchListResponse,
     BranchListResponsesPageCursorURL as BranchListResponsesPageCursorURL,
+    type BranchCreateParams as BranchCreateParams,
     type BranchListParams as BranchListParams,
   };
 
   export {
     Files as Files,
+    type FileRetrieveResponse as FileRetrieveResponse,
     type FileListResponse as FileListResponse,
     FileListResponsesPageCursorURL as FileListResponsesPageCursorURL,
+    type FileRetrieveParams as FileRetrieveParams,
     type FileListParams as FileListParams,
+    type FileContentParams as FileContentParams,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.30.0'; // x-release-please-version
+export const VERSION = '0.32.0'; // x-release-please-version

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.30.0";
+export declare const VERSION = "0.32.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.30.0'; // x-release-please-version
+exports.VERSION = '0.32.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.30.0'; // x-release-please-version
+export const VERSION = '0.32.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map