@valtown/sdk 0.38.2 → 1.0.0

package/src/resources/users.ts

@@ -1,3 +1,17 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export * from './users/index';
+import { APIResource } from '../resource';
+import * as Core from '../core';
+import * as Shared from './shared';
+
+/**
+ * Access public user information and list other people’s vals
+ */
+export class Users extends APIResource {
+  /**
+   * Get basic information about a user
+   */
+  retrieve(userId: string, options?: Core.RequestOptions): Core.APIPromise<Shared.User> {
+    return this._client.get(`/v1/users/${userId}`, options);
+  }
+}

package/src/resources/{projects → vals}/branches.ts

@@ -6,46 +6,46 @@ import { PageCursorURL, type PageCursorURLParams } from '../../pagination';
 
 export class Branches extends APIResource {
   /**
-   * [BETA] Create a new branch
+   * Create a new branch
    */
   create(
-    projectId: string,
+    valId: string,
     body: BranchCreateParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<BranchCreateResponse> {
-    return this._client.post(`/v1/projects/${projectId}/branches`, { body, ...options });
+    return this._client.post(`/v2/vals/${valId}/branches`, { body, ...options });
   }
 
   /**
-   * [BETA] Get a branch by id
+   * Get a branch by id
    */
   retrieve(
-    projectId: string,
+    valId: string,
     branchId: string,
     options?: Core.RequestOptions,
   ): Core.APIPromise<BranchRetrieveResponse> {
-    return this._client.get(`/v1/projects/${projectId}/branches/${branchId}`, options);
+    return this._client.get(`/v2/vals/${valId}/branches/${branchId}`, options);
   }
 
   /**
-   * [BETA] List all branches for a project
+   * List all branches for a val
    */
   list(
-    projectId: string,
+    valId: string,
     query: BranchListParams,
     options?: Core.RequestOptions,
   ): Core.PagePromise<BranchListResponsesPageCursorURL, BranchListResponse> {
-    return this._client.getAPIList(`/v1/projects/${projectId}/branches`, BranchListResponsesPageCursorURL, {
+    return this._client.getAPIList(`/v2/vals/${valId}/branches`, BranchListResponsesPageCursorURL, {
       query,
       ...options,
     });
   }
 
   /**
-   * [BETA] Delete a branch
+   * Delete a branch
    */
-  delete(projectId: string, branchId: string, options?: Core.RequestOptions): Core.APIPromise<void> {
-    return this._client.delete(`/v1/projects/${projectId}/branches/${branchId}`, {
+  delete(valId: string, branchId: string, options?: Core.RequestOptions): Core.APIPromise<void> {
+    return this._client.delete(`/v2/vals/${valId}/branches/${branchId}`, {
       ...options,
       headers: { Accept: '*/*', ...options?.headers },
     });

package/src/resources/{projects → vals}/files.ts

@@ -7,61 +7,53 @@ import { type Response } from '../../_shims/index';
 
 export class Files extends APIResource {
   /**
-   * [BETA] Create a new file, project val or directory
+   * Create a new file, project val or directory
    */
   create(
-    projectId: string,
+    valId: string,
     params: FileCreateParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<FileCreateResponse> {
     const { path, branch_id, ...body } = params;
-    return this._client.post(`/v1/projects/${projectId}/files`, {
-      query: { path, branch_id },
-      body,
-      ...options,
-    });
+    return this._client.post(`/v2/vals/${valId}/files`, { query: { path, branch_id }, body, ...options });
   }
 
   /**
-   * Get metadata for files and directories in a project. If path is an empty string,
+   * Get metadata for files and directories in a val. If path is an empty string,
    * returns files at the root directory.
    */
   retrieve(
-    projectId: string,
+    valId: string,
     query: FileRetrieveParams,
     options?: Core.RequestOptions,
   ): Core.PagePromise<FileRetrieveResponsesPageCursorURL, FileRetrieveResponse> {
-    return this._client.getAPIList(`/v1/projects/${projectId}/files`, FileRetrieveResponsesPageCursorURL, {
+    return this._client.getAPIList(`/v2/vals/${valId}/files`, FileRetrieveResponsesPageCursorURL, {
       query,
       ...options,
     });
   }
 
   /**
-   * [BETA] Update a file's content
+   * Update a file's content
    */
   update(
-    projectId: string,
+    valId: string,
     params: FileUpdateParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<FileUpdateResponse> {
     const { path, branch_id, ...body } = params;
-    return this._client.put(`/v1/projects/${projectId}/files`, {
-      query: { path, branch_id },
-      body,
-      ...options,
-    });
+    return this._client.put(`/v2/vals/${valId}/files`, { query: { path, branch_id }, body, ...options });
   }
 
   /**
-   * [BETA] Deletes a file or a directory. To delete a directory and all of its
-   * children, use the recursive flag. To delete all files, pass in an empty path and
-   * the recursive flag.
+   * Deletes a file or a directory. To delete a directory and all of its children,
+   * use the recursive flag. To delete all files, pass in an empty path and the
+   * recursive flag.
    */
-  delete(projectId: string, params: FileDeleteParams, options?: Core.RequestOptions): Core.APIPromise<void> {
-    const { path, branch_id, recursive } = params;
-    return this._client.delete(`/v1/projects/${projectId}/files`, {
-      query: { path, branch_id, recursive },
+  delete(valId: string, params: FileDeleteParams, options?: Core.RequestOptions): Core.APIPromise<void> {
+    const { path, recursive, branch_id } = params;
+    return this._client.delete(`/v2/vals/${valId}/files`, {
+      query: { path, recursive, branch_id },
       ...options,
       headers: { Accept: '*/*', ...options?.headers },
     });
@@ -71,7 +63,7 @@ export class Files extends APIResource {
    * Download file content
    */
   getContent(
-    projectId: string,
+    valId: string,
     params: FileGetContentParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<Response> {
@@ -83,7 +75,7 @@ export class Files extends APIResource {
       'If-Unmodified-Since': ifUnmodifiedSince,
       ...query
     } = params;
-    return this._client.get(`/v1/projects/${projectId}/files/content`, {
+    return this._client.get(`/v2/vals/${valId}/files/content`, {
       query,
       ...options,
       headers: {
@@ -115,11 +107,6 @@ export interface FileCreateResponse {
 
   name: string;
 
-  /**
-   * The id of the parent resource
-   */
-  parentId: string | null;
-
   path: string;
 
   type: 'directory' | 'file' | 'interval' | 'http' | 'email' | 'script';
@@ -166,11 +153,6 @@ export interface FileRetrieveResponse {
 
   name: string;
 
-  /**
-   * The id of the parent resource
-   */
-  parentId: string | null;
-
   path: string;
 
   type: 'directory' | 'file' | 'interval' | 'http' | 'email' | 'script';
@@ -217,11 +199,6 @@ export interface FileUpdateResponse {
 
   name: string;
 
-  /**
-   * The id of the parent resource
-   */
-  parentId: string | null;
-
   path: string;
 
   type: 'directory' | 'file' | 'interval' | 'http' | 'email' | 'script';
@@ -290,8 +267,8 @@ export declare namespace FileCreateParams {
     path: string;
 
     /**
-     * Body param: Project file and val content. An empty string will create an empty
-     * file. When creating a directory, the content should be null or undefined.
+     * Body param: File and val content. An empty string will create an empty file.
+     * When creating a directory, the content should be null or undefined.
      */
     content: string;
 
@@ -316,14 +293,14 @@ export interface FileRetrieveParams extends PageCursorURLParams {
   path: string;
 
   /**
-   * Id to query
+   * Whether to recursively act on all files in the project
    */
-  branch_id?: string;
+  recursive: boolean;
 
   /**
-   * Whether to recursively act on all files in the project
+   * Id to query
    */
-  recursive?: boolean;
+  branch_id?: string;
 
   /**
    * Specific branch version to query
@@ -345,8 +322,8 @@ export interface FileUpdateParams {
   branch_id?: string;
 
   /**
-   * Body param: Project file and val content. An empty string will create an empty
-   * file. When creating a directory, the content should be null or undefined.
+   * Body param: File and val content. An empty string will create an empty file.
+   * When creating a directory, the content should be null or undefined.
    */
   content?: string;
 
@@ -356,9 +333,10 @@ export interface FileUpdateParams {
   name?: string;
 
   /**
-   * Body param: Id of the parent directory
+   * Body param: Path to the directory you'd like to move this file to (e.g.
+   * 'folder1/folder2')
    */
-  parent_id?: string | null;
+  parent_path?: string | null;
 
   /**
    * Body param:
@@ -374,14 +352,14 @@ export interface FileDeleteParams {
   path: string;
 
   /**
-   * The specified branch of the resource. Defaults to main if not provided.
+   * Whether to recursively act on all files in the project
    */
-  branch_id?: string;
+  recursive: boolean;
 
   /**
-   * Whether to recursively act on all files in the project
+   * The specified branch of the resource. Defaults to main if not provided.
    */
-  recursive?: boolean;
+  branch_id?: string;
 }
 
 export interface FileGetContentParams {

package/src/resources/vals/index.ts

@@ -1,19 +1,24 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export {
-  Vals,
-  type ValListResponse,
-  type ValCancelEvaluationResponse,
-  type ValCreateParams,
-  type ValUpdateParams,
-  type ValListParams,
-  type ValCreateOrUpdateParams,
-} from './vals';
+  BranchListResponsesPageCursorURL,
+  Branches,
+  type BranchCreateResponse,
+  type BranchRetrieveResponse,
+  type BranchListResponse,
+  type BranchCreateParams,
+  type BranchListParams,
+} from './branches';
 export {
-  VersionListResponsesPageCursorURL,
-  Versions,
-  type VersionListResponse,
-  type VersionCreateParams,
-  type VersionRetrieveParams,
-  type VersionListParams,
-} from './versions';
+  FileRetrieveResponsesPageCursorURL,
+  Files,
+  type FileCreateResponse,
+  type FileRetrieveResponse,
+  type FileUpdateResponse,
+  type FileCreateParams,
+  type FileRetrieveParams,
+  type FileUpdateParams,
+  type FileDeleteParams,
+  type FileGetContentParams,
+} from './files';
+export { Vals, type ValCreateParams, type ValListParams } from './vals';

package/src/resources/vals/vals.ts

@@ -1,229 +1,113 @@
 // 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 * as VersionsAPI from './versions';
+import { ValsPageCursorURL } from '../shared';
+import * as BranchesAPI from './branches';
 import {
-  VersionCreateParams,
-  VersionListParams,
-  VersionListResponse,
-  VersionListResponsesPageCursorURL,
-  VersionRetrieveParams,
-  Versions,
-} from './versions';
+  BranchCreateParams,
+  BranchCreateResponse,
+  BranchListParams,
+  BranchListResponse,
+  BranchListResponsesPageCursorURL,
+  BranchRetrieveResponse,
+  Branches,
+} from './branches';
+import * as FilesAPI from './files';
+import {
+  FileCreateParams,
+  FileCreateResponse,
+  FileDeleteParams,
+  FileGetContentParams,
+  FileRetrieveParams,
+  FileRetrieveResponse,
+  FileRetrieveResponsesPageCursorURL,
+  FileUpdateParams,
+  FileUpdateResponse,
+  Files,
+} from './files';
+import { type PageCursorURLParams } from '../../pagination';
 
 /**
- * Vals are runnable JavaScript, TypeScript, and JSX modules
+ * Vals are a collaborative folder of runnable JavaScript, TypeScript, and JSX modules
  */
 export class Vals extends APIResource {
-  versions: VersionsAPI.Versions = new VersionsAPI.Versions(this._client);
+  branches: BranchesAPI.Branches = new BranchesAPI.Branches(this._client);
+  files: FilesAPI.Files = new FilesAPI.Files(this._client);
 
   /**
    * Create a new val
    */
-  create(body: ValCreateParams, options?: Core.RequestOptions): Core.APIPromise<Shared.ExtendedVal> {
-    return this._client.post('/v1/vals', { body, ...options });
+  create(body: ValCreateParams, options?: Core.RequestOptions): Core.APIPromise<Shared.Val> {
+    return this._client.post('/v2/vals', { body, ...options });
   }
 
   /**
    * Get a val by id
    */
-  retrieve(valId: string, options?: Core.RequestOptions): Core.APIPromise<Shared.ExtendedVal> {
-    return this._client.get(`/v1/vals/${valId}`, options);
-  }
-
-  /**
-   * Update an existing val
-   */
-  update(valId: string, body?: ValUpdateParams, options?: Core.RequestOptions): Core.APIPromise<void>;
-  update(valId: string, options?: Core.RequestOptions): Core.APIPromise<void>;
-  update(
-    valId: string,
-    body: ValUpdateParams | Core.RequestOptions = {},
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<void> {
-    if (isRequestOptions(body)) {
-      return this.update(valId, {}, body);
-    }
-    return this._client.put(`/v1/vals/${valId}`, {
-      body,
-      ...options,
-      headers: { Accept: '*/*', ...options?.headers },
-    });
+  retrieve(valId: string, options?: Core.RequestOptions): Core.APIPromise<Shared.Val> {
+    return this._client.get(`/v2/vals/${valId}`, options);
   }
 
   /**
-   * List all vals including all public vals and your unlisted and private vals
+   * Lists all public vals
    */
-  list(query: ValListParams, options?: Core.RequestOptions): Core.APIPromise<ValListResponse> {
-    return this._client.get('/v1/vals', { query, ...options });
+  list(query: ValListParams, options?: Core.RequestOptions): Core.PagePromise<ValsPageCursorURL, Shared.Val> {
+    return this._client.getAPIList('/v2/vals', ValsPageCursorURL, { query, ...options });
   }
 
   /**
-   * Delete a val
+   * Delete a project
    */
   delete(valId: string, options?: Core.RequestOptions): Core.APIPromise<void> {
-    return this._client.delete(`/v1/vals/${valId}`, {
-      ...options,
-      headers: { Accept: '*/*', ...options?.headers },
-    });
-  }
-
-  /**
-   * Cancel a running val
-   */
-  cancelEvaluation(
-    valId: string,
-    evaluationId: string,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<ValCancelEvaluationResponse> {
-    return this._client.post(`/v1/vals/${valId}/evaluations/${evaluationId}/cancel`, options);
-  }
-
-  /**
-   * Run an existing val or create a new one
-   */
-  createOrUpdate(body: ValCreateOrUpdateParams, options?: Core.RequestOptions): Core.APIPromise<void> {
-    return this._client.put('/v1/vals', {
-      body,
+    return this._client.delete(`/v2/vals/${valId}`, {
       ...options,
       headers: { Accept: '*/*', ...options?.headers },
     });
   }
 }
 
-/**
- * A paginated result set
- */
-export interface ValListResponse {
-  data: Array<Shared.ExtendedVal>;
-
-  /**
-   * Links to use for pagination
-   */
-  links: Shared.PaginationLinks;
-}
-
-/**
- * The evaluation_id was successfully searched for and the evaluation was either
- * already done or now has been cancelled
- */
-export interface ValCancelEvaluationResponse {
-  /**
-   * True if the evaluation was found and cancelled
-   */
-  found: boolean;
-}
-
 export interface ValCreateParams {
-  /**
-   * Val source code as TypeScript
-   */
-  code: string;
-
-  /**
-   * This val’s name
-   */
-  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';
-
-  /**
-   * Readme contents, as Markdown
-   */
-  readme?: string;
-
-  /**
-   * The type of the val you want to create. Note that this does not include interval
-   * vals, because they cannot be created through the API yet.
-   */
-  type?: 'httpnext' | 'http' | 'script' | 'email';
-}
-
-export interface ValUpdateParams {
-  /**
-   * This val’s name
-   */
-  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';
-
-  /**
-   * Readme contents, as Markdown
-   */
-  readme?: string;
-
-  /**
-   * The type of the val you want to update. Note that this does not include interval
-   * vals, because they cannot be created through the API yet.
-   */
-  type?: 'httpnext' | 'http' | 'script' | 'email';
-}
-
-export interface ValListParams {
-  /**
-   * Maximum items to return in each paginated response
-   */
-  limit: number;
-
-  /**
-   * Cursor to start the pagination from
-   */
-  cursor?: string;
+  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';
+  privacy: 'public' | 'unlisted' | 'private';
 
-  /**
-   * User ID to filter by
-   */
-  userId?: string;
+  description?: string;
 }
 
-export interface ValCreateOrUpdateParams {
-  /**
-   * Val source code as TypeScript
-   */
-  code: string;
-
-  /**
-   * This val’s name
-   */
-  name: string;
-}
+export interface ValListParams extends PageCursorURLParams {}
 
-Vals.Versions = Versions;
-Vals.VersionListResponsesPageCursorURL = VersionListResponsesPageCursorURL;
+Vals.Branches = Branches;
+Vals.BranchListResponsesPageCursorURL = BranchListResponsesPageCursorURL;
+Vals.Files = Files;
+Vals.FileRetrieveResponsesPageCursorURL = FileRetrieveResponsesPageCursorURL;
 
 export declare namespace Vals {
+  export { type ValCreateParams as ValCreateParams, type ValListParams as ValListParams };
+
   export {
-    type ValListResponse as ValListResponse,
-    type ValCancelEvaluationResponse as ValCancelEvaluationResponse,
-    type ValCreateParams as ValCreateParams,
-    type ValUpdateParams as ValUpdateParams,
-    type ValListParams as ValListParams,
-    type ValCreateOrUpdateParams as ValCreateOrUpdateParams,
+    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 {
-    Versions as Versions,
-    type VersionListResponse as VersionListResponse,
-    VersionListResponsesPageCursorURL as VersionListResponsesPageCursorURL,
-    type VersionCreateParams as VersionCreateParams,
-    type VersionRetrieveParams as VersionRetrieveParams,
-    type VersionListParams as VersionListParams,
+    Files as Files,
+    type FileCreateResponse as FileCreateResponse,
+    type FileRetrieveResponse as FileRetrieveResponse,
+    type FileUpdateResponse as FileUpdateResponse,
+    FileRetrieveResponsesPageCursorURL as FileRetrieveResponsesPageCursorURL,
+    type FileCreateParams as FileCreateParams,
+    type FileRetrieveParams as FileRetrieveParams,
+    type FileUpdateParams as FileUpdateParams,
+    type FileDeleteParams as FileDeleteParams,
+    type FileGetContentParams as FileGetContentParams,
   };
 }
+
+export { ValsPageCursorURL };

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.38.2'; // x-release-please-version
+export const VERSION = '1.0.0'; // x-release-please-version

package/version.d.ts

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

package/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/version.js

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

package/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}

package/version.mjs

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

package/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}