@valtown/sdk 0.35.0 → 0.37.0

package/src/resources/projects/files.ts

@@ -1,10 +1,8 @@
 // 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 {
@@ -13,28 +11,27 @@ export class Files extends APIResource {
    */
   create(
     projectId: string,
-    path: string,
     params: FileCreateParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<FileCreateResponse> {
-    const { branch_id, ...body } = params;
-    return this._client.post(`/v1/projects/${projectId}/files/${path}`, {
-      query: { branch_id },
+    const { path, branch_id, ...body } = params;
+    return this._client.post(`/v1/projects/${projectId}/files`, {
+      query: { path, branch_id },
       body,
       ...options,
     });
   }
 
   /**
-   * Get metadata for files and directories in a project at the specified path
+   * Get metadata for files and directories in a project. If path is an empty string,
+   * returns files at the root directory.
    */
   retrieve(
     projectId: string,
-    path: string,
     query: FileRetrieveParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<FileRetrieveResponse> {
-    return this._client.get(`/v1/projects/${projectId}/files/${path}`, { query, ...options });
+    return this._client.get(`/v1/projects/${projectId}/files`, { query, ...options });
   }
 
   /**
@@ -42,39 +39,28 @@ export class Files extends APIResource {
    */
   update(
     projectId: string,
-    path: string,
-    params?: FileUpdateParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<FileUpdateResponse>;
-  update(projectId: string, path: string, options?: Core.RequestOptions): Core.APIPromise<FileUpdateResponse>;
-  update(
-    projectId: string,
-    path: string,
-    params: FileUpdateParams | Core.RequestOptions = {},
+    params: FileUpdateParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<FileUpdateResponse> {
-    if (isRequestOptions(params)) {
-      return this.update(projectId, path, {}, params);
-    }
-    const { branch_id, ...body } = params;
-    return this._client.put(`/v1/projects/${projectId}/files/${path}`, {
-      query: { branch_id },
+    const { path, branch_id, ...body } = params;
+    return this._client.put(`/v1/projects/${projectId}/files`, {
+      query: { path, branch_id },
       body,
       ...options,
     });
   }
 
   /**
-   * Get metadata for files and directories in a project at the root directory
+   * [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.
    */
-  list(
-    projectId: string,
-    query: FileListParams,
-    options?: Core.RequestOptions,
-  ): Core.PagePromise<FileListResponsesPageCursorURL, FileListResponse> {
-    return this._client.getAPIList(`/v1/projects/${projectId}/files`, FileListResponsesPageCursorURL, {
-      query,
+  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 },
       ...options,
+      headers: { Accept: '*/*', ...options?.headers },
     });
   }
 
@@ -83,20 +69,9 @@ export class Files extends APIResource {
    */
   getContent(
     projectId: string,
-    path: string,
-    params?: FileGetContentParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<Response>;
-  getContent(projectId: string, path: string, options?: Core.RequestOptions): Core.APIPromise<Response>;
-  getContent(
-    projectId: string,
-    path: string,
-    params: FileGetContentParams | Core.RequestOptions = {},
+    params: FileGetContentParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<Response> {
-    if (isRequestOptions(params)) {
-      return this.getContent(projectId, path, {}, params);
-    }
     const {
       'Cache-Control': cacheControl,
       'If-Match': ifMatch,
@@ -105,7 +80,7 @@ export class Files extends APIResource {
       'If-Unmodified-Since': ifUnmodifiedSince,
       ...query
     } = params;
-    return this._client.get(`/v1/projects/${projectId}/files/${path}/content`, {
+    return this._client.get(`/v1/projects/${projectId}/files/content`, {
       query,
       ...options,
       headers: {
@@ -122,8 +97,6 @@ export class Files extends APIResource {
   }
 }
 
-export class FileListResponsesPageCursorURL extends PageCursorURL<FileListResponse> {}
-
 /**
  * A File or Directory's Metadata
  */
@@ -291,61 +264,16 @@ export namespace FileUpdateResponse {
   }
 }
 
-/**
- * A File or Directory's Metadata
- */
-export interface FileListResponse {
-  /**
-   * The id of the resource
-   */
-  id: string;
-
-  links: FileListResponse.Links;
-
-  name: string;
-
-  /**
-   * The id of the parent resource
-   */
-  parentId: string | null;
-
-  path: string;
-
-  type: 'directory' | 'file' | 'interval' | 'http' | 'email' | 'script';
-
-  updatedAt: string;
-
-  version: number;
-}
-
-export namespace FileListResponse {
-  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;
-  }
-}
-
 export type FileCreateParams = FileCreateParams.Variant0 | FileCreateParams.Variant1;
 
 export declare namespace FileCreateParams {
   export interface Variant0 {
+    /**
+     * Query param: Path to a file or directory (e.g. 'dir/subdir/file.ts'). Pass in an
+     * empty string to represent the root directory.
+     */
+    path: string;
+
     /**
      * Body param:
      */
@@ -364,6 +292,12 @@ export declare namespace FileCreateParams {
   }
 
   export interface Variant1 {
+    /**
+     * Query param: Path to a file or directory (e.g. 'dir/subdir/file.ts'). Pass in an
+     * empty string to represent the root directory.
+     */
+    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.
@@ -394,11 +328,22 @@ export interface FileRetrieveParams {
    */
   offset: number;
 
+  /**
+   * Path to a file or directory (e.g. 'dir/subdir/file.ts'). Pass in an empty string
+   * to represent the root directory.
+   */
+  path: string;
+
   /**
    * Id to query
    */
   branch_id?: string;
 
+  /**
+   * Whether to recursively act on all files in the project
+   */
+  recursive?: boolean;
+
   /**
    * Specific branch version to query
    */
@@ -406,6 +351,12 @@ export interface FileRetrieveParams {
 }
 
 export interface FileUpdateParams {
+  /**
+   * Query param: Path to a file or directory (e.g. 'dir/subdir/file.ts'). Pass in an
+   * empty string to represent the root directory.
+   */
+  path: string;
+
   /**
    * Query param: The specified branch of the resource. Defaults to main if not
    * provided.
@@ -434,24 +385,31 @@ export interface FileUpdateParams {
   type?: 'file' | 'interval' | 'http' | 'email' | 'script';
 }
 
-export interface FileListParams extends PageCursorURLParams {
+export interface FileDeleteParams {
   /**
-   * Id to query
+   * Path to a file or directory (e.g. 'dir/subdir/file.ts'). Pass in an empty string
+   * to represent the root directory.
    */
-  branch_id?: string;
+  path: string;
 
   /**
-   * Whether to recursively list all files in the project
+   * The specified branch of the resource. Defaults to main if not provided.
    */
-  recursive?: boolean;
+  branch_id?: string;
 
   /**
-   * Specific branch version to query
+   * Whether to recursively act on all files in the project
    */
-  version?: number;
+  recursive?: boolean;
 }
 
 export interface FileGetContentParams {
+  /**
+   * Query param: Path to a file or directory (e.g. 'dir/subdir/file.ts'). Pass in an
+   * empty string to represent the root directory.
+   */
+  path: string;
+
   /**
    * Query param: Id to query
    */
@@ -488,19 +446,15 @@ export interface FileGetContentParams {
   'If-Unmodified-Since'?: string;
 }
 
-Files.FileListResponsesPageCursorURL = FileListResponsesPageCursorURL;
-
 export declare namespace Files {
   export {
     type FileCreateResponse as FileCreateResponse,
     type FileRetrieveResponse as FileRetrieveResponse,
     type FileUpdateResponse as FileUpdateResponse,
-    type FileListResponse as FileListResponse,
-    FileListResponsesPageCursorURL as FileListResponsesPageCursorURL,
     type FileCreateParams as FileCreateParams,
     type FileRetrieveParams as FileRetrieveParams,
     type FileUpdateParams as FileUpdateParams,
-    type FileListParams as FileListParams,
+    type FileDeleteParams as FileDeleteParams,
     type FileGetContentParams as FileGetContentParams,
   };
 }

package/src/resources/projects/index.ts

@@ -10,16 +10,14 @@ export {
   type BranchListParams,
 } from './branches';
 export {
-  FileListResponsesPageCursorURL,
   Files,
   type FileCreateResponse,
   type FileRetrieveResponse,
   type FileUpdateResponse,
-  type FileListResponse,
   type FileCreateParams,
   type FileRetrieveParams,
   type FileUpdateParams,
-  type FileListParams,
+  type FileDeleteParams,
   type FileGetContentParams,
 } from './files';
 export {

package/src/resources/projects/projects.ts

@@ -16,10 +16,8 @@ import * as FilesAPI from './files';
 import {
   FileCreateParams,
   FileCreateResponse,
+  FileDeleteParams,
   FileGetContentParams,
-  FileListParams,
-  FileListResponse,
-  FileListResponsesPageCursorURL,
   FileRetrieveParams,
   FileRetrieveResponse,
   FileUpdateParams,
@@ -58,6 +56,16 @@ export class Projects extends APIResource {
   ): Core.PagePromise<ProjectListResponsesPageCursorURL, ProjectListResponse> {
     return this._client.getAPIList('/v1/projects', ProjectListResponsesPageCursorURL, { query, ...options });
   }
+
+  /**
+   * [BETA] Delete a project
+   */
+  delete(projectId: string, options?: Core.RequestOptions): Core.APIPromise<void> {
+    return this._client.delete(`/v1/projects/${projectId}`, {
+      ...options,
+      headers: { Accept: '*/*', ...options?.headers },
+    });
+  }
 }
 
 export class ProjectListResponsesPageCursorURL extends PageCursorURL<ProjectListResponse> {}
@@ -221,8 +229,6 @@ export interface ProjectCreateParams {
   privacy: 'public' | 'unlisted' | 'private';
 
   description?: string;
-
-  imageUrl?: string;
 }
 
 export interface ProjectListParams extends PageCursorURLParams {}
@@ -231,7 +237,6 @@ Projects.ProjectListResponsesPageCursorURL = ProjectListResponsesPageCursorURL;
 Projects.Branches = Branches;
 Projects.BranchListResponsesPageCursorURL = BranchListResponsesPageCursorURL;
 Projects.Files = Files;
-Projects.FileListResponsesPageCursorURL = FileListResponsesPageCursorURL;
 
 export declare namespace Projects {
   export {
@@ -258,12 +263,10 @@ export declare namespace Projects {
     type FileCreateResponse as FileCreateResponse,
     type FileRetrieveResponse as FileRetrieveResponse,
     type FileUpdateResponse as FileUpdateResponse,
-    type FileListResponse as FileListResponse,
-    FileListResponsesPageCursorURL as FileListResponsesPageCursorURL,
     type FileCreateParams as FileCreateParams,
     type FileRetrieveParams as FileRetrieveParams,
     type FileUpdateParams as FileUpdateParams,
-    type FileListParams as FileListParams,
+    type FileDeleteParams as FileDeleteParams,
     type FileGetContentParams as FileGetContentParams,
   };
 }

package/src/resources/projects.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './projects/index';

package/src/resources/search.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './search/index';

package/src/resources/shared.ts

@@ -47,6 +47,8 @@ export interface BasicVal {
    */
   type: 'interval' | 'http' | 'express' | 'email' | 'script' | 'rpc' | 'httpnext';
 
+  updatedAt: string;
+
   /**
    * The URL of this resource on the Val Town website
    */
@@ -148,6 +150,8 @@ export interface ExtendedVal {
    */
   type: 'interval' | 'http' | 'express' | 'email' | 'script' | 'rpc' | 'httpnext';
 
+  updatedAt: string;
+
   /**
    * The URL of this resource on the Val Town website
    */

package/src/resources/users.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './users/index';

package/src/resources/vals/index.ts

@@ -2,9 +2,11 @@
 
 export {
   Vals,
+  type ValListResponse,
   type ValCancelEvaluationResponse,
   type ValCreateParams,
   type ValUpdateParams,
+  type ValListParams,
   type ValCreateOrUpdateParams,
 } from './vals';
 export {

package/src/resources/vals/vals.ts

@@ -54,6 +54,13 @@ export class Vals extends APIResource {
     });
   }
 
+  /**
+   * List all vals including all public vals and your unlisted and private vals
+   */
+  list(query: ValListParams, options?: Core.RequestOptions): Core.APIPromise<ValListResponse> {
+    return this._client.get('/v1/vals', { query, ...options });
+  }
+
   /**
    * Delete a val
    */
@@ -87,6 +94,18 @@ export class Vals extends APIResource {
   }
 }
 
+/**
+ * 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
@@ -151,6 +170,29 @@ export interface ValUpdateParams {
   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;
+
+  /**
+   * 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';
+
+  /**
+   * User ID to filter by
+   */
+  userId?: string;
+}
+
 export interface ValCreateOrUpdateParams {
   /**
    * Val source code as TypeScript
@@ -168,9 +210,11 @@ Vals.VersionListResponsesPageCursorURL = VersionListResponsesPageCursorURL;
 
 export declare namespace Vals {
   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,
   };
 

package/src/resources/vals.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './vals/index';

package/src/resources.ts

@@ -0,0 +1 @@
+export * from './resources/index';

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.35.0'; // x-release-please-version
+export const VERSION = '0.37.0'; // x-release-please-version

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.35.0";
+export declare const VERSION = "0.37.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.35.0'; // x-release-please-version
+exports.VERSION = '0.37.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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