@valtown/sdk 1.1.0 → 1.3.0

package/resources/vals/files.d.ts

@@ -5,25 +5,71 @@ import { type Response } from "../../_shims/index.js";
 export declare class Files extends APIResource {
     /**
      * Create a new file, project val or directory
+     *
+     * @example
+     * ```ts
+     * const file = await client.vals.files.create(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { path: 'path', type: 'directory' },
+     * );
+     * ```
      */
     create(valId: string, params: FileCreateParams, options?: Core.RequestOptions): Core.APIPromise<FileCreateResponse>;
     /**
      * Get metadata for files and directories in a val. If path is an empty string,
      * returns files at the root directory.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const fileRetrieveResponse of client.vals.files.retrieve(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { limit: 1, offset: 0, path: 'path', recursive: true },
+     * )) {
+     *   // ...
+     * }
+     * ```
      */
     retrieve(valId: string, query: FileRetrieveParams, options?: Core.RequestOptions): Core.PagePromise<FileRetrieveResponsesPageCursorURL, FileRetrieveResponse>;
     /**
      * Update a file's content
+     *
+     * @example
+     * ```ts
+     * const file = await client.vals.files.update(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { path: 'path' },
+     * );
+     * ```
      */
     update(valId: string, params: FileUpdateParams, options?: Core.RequestOptions): Core.APIPromise<FileUpdateResponse>;
     /**
      * 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.
+     *
+     * @example
+     * ```ts
+     * await client.vals.files.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { path: 'path', recursive: true },
+     * );
+     * ```
      */
     delete(valId: string, params: FileDeleteParams, options?: Core.RequestOptions): Core.APIPromise<void>;
     /**
      * Download file content
+     *
+     * @example
+     * ```ts
+     * const response = await client.vals.files.getContent(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { path: 'path' },
+     * );
+     *
+     * const content = await response.blob();
+     * console.log(content);
+     * ```
      */
     getContent(valId: string, params: FileGetContentParams, options?: Core.RequestOptions): Core.APIPromise<Response>;
 }

package/resources/vals/files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/resources/vals/files.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/resources/vals/files.ts"],"names":[],"mappings":"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"}

package/resources/vals/files.js

@@ -7,6 +7,14 @@ const pagination_1 = require("../../pagination.js");
 class Files extends resource_1.APIResource {
     /**
      * Create a new file, project val or directory
+     *
+     * @example
+     * ```ts
+     * const file = await client.vals.files.create(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { path: 'path', type: 'directory' },
+     * );
+     * ```
      */
     create(valId, params, options) {
         const { path, branch_id, ...body } = params;
@@ -15,6 +23,17 @@ class Files extends resource_1.APIResource {
     /**
      * Get metadata for files and directories in a val. If path is an empty string,
      * returns files at the root directory.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const fileRetrieveResponse of client.vals.files.retrieve(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { limit: 1, offset: 0, path: 'path', recursive: true },
+     * )) {
+     *   // ...
+     * }
+     * ```
      */
     retrieve(valId, query, options) {
         return this._client.getAPIList(`/v2/vals/${valId}/files`, FileRetrieveResponsesPageCursorURL, {
@@ -24,6 +43,14 @@ class Files extends resource_1.APIResource {
     }
     /**
      * Update a file's content
+     *
+     * @example
+     * ```ts
+     * const file = await client.vals.files.update(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { path: 'path' },
+     * );
+     * ```
      */
     update(valId, params, options) {
         const { path, branch_id, ...body } = params;
@@ -33,6 +60,14 @@ class Files extends resource_1.APIResource {
      * 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.
+     *
+     * @example
+     * ```ts
+     * await client.vals.files.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { path: 'path', recursive: true },
+     * );
+     * ```
      */
     delete(valId, params, options) {
         const { path, recursive, branch_id } = params;
@@ -44,6 +79,17 @@ class Files extends resource_1.APIResource {
     }
     /**
      * Download file content
+     *
+     * @example
+     * ```ts
+     * const response = await client.vals.files.getContent(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { path: 'path' },
+     * );
+     *
+     * const content = await response.blob();
+     * console.log(content);
+     * ```
      */
     getContent(valId, params, options) {
         const { 'Cache-Control': cacheControl, 'If-Match': ifMatch, 'If-Modified-Since': ifModifiedSince, 'If-None-Match': ifNoneMatch, 'If-Unmodified-Since': ifUnmodifiedSince, ...query } = params;

package/resources/vals/files.js.map

@@ -1 +1 @@
-{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/resources/vals/files.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/resources/vals/files.ts"],"names":[],"mappings":"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"}

package/resources/vals/files.mjs

@@ -4,6 +4,14 @@ import { PageCursorURL } from "../../pagination.mjs";
 export class Files extends APIResource {
     /**
      * Create a new file, project val or directory
+     *
+     * @example
+     * ```ts
+     * const file = await client.vals.files.create(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { path: 'path', type: 'directory' },
+     * );
+     * ```
      */
     create(valId, params, options) {
         const { path, branch_id, ...body } = params;
@@ -12,6 +20,17 @@ export class Files extends APIResource {
     /**
      * Get metadata for files and directories in a val. If path is an empty string,
      * returns files at the root directory.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const fileRetrieveResponse of client.vals.files.retrieve(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { limit: 1, offset: 0, path: 'path', recursive: true },
+     * )) {
+     *   // ...
+     * }
+     * ```
      */
     retrieve(valId, query, options) {
         return this._client.getAPIList(`/v2/vals/${valId}/files`, FileRetrieveResponsesPageCursorURL, {
@@ -21,6 +40,14 @@ export class Files extends APIResource {
     }
     /**
      * Update a file's content
+     *
+     * @example
+     * ```ts
+     * const file = await client.vals.files.update(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { path: 'path' },
+     * );
+     * ```
      */
     update(valId, params, options) {
         const { path, branch_id, ...body } = params;
@@ -30,6 +57,14 @@ export class Files extends APIResource {
      * 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.
+     *
+     * @example
+     * ```ts
+     * await client.vals.files.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { path: 'path', recursive: true },
+     * );
+     * ```
      */
     delete(valId, params, options) {
         const { path, recursive, branch_id } = params;
@@ -41,6 +76,17 @@ export class Files extends APIResource {
     }
     /**
      * Download file content
+     *
+     * @example
+     * ```ts
+     * const response = await client.vals.files.getContent(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { path: 'path' },
+     * );
+     *
+     * const content = await response.blob();
+     * console.log(content);
+     * ```
      */
     getContent(valId, params, options) {
         const { 'Cache-Control': cacheControl, 'If-Match': ifMatch, 'If-Modified-Since': ifModifiedSince, 'If-None-Match': ifNoneMatch, 'If-Unmodified-Since': ifUnmodifiedSince, ...query } = params;

package/resources/vals/files.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"files.mjs","sourceRoot":"","sources":["../../src/resources/vals/files.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"files.mjs","sourceRoot":"","sources":["../../src/resources/vals/files.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,aAAa,EAA4B;AAGlD,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;OAUG;IACH,MAAM,CACJ,KAAa,EACb,MAAwB,EACxB,OAA6B;QAE7B,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxG,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CACN,KAAa,EACb,KAAyB,EACzB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,KAAK,QAAQ,EAAE,kCAAkC,EAAE;YAC5F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CACJ,KAAa,EACb,MAAwB,EACxB,OAA6B;QAE7B,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvG,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAa,EAAE,MAAwB,EAAE,OAA6B;QAC3E,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,KAAK,QAAQ,EAAE;YACpD,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE;YACrC,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,UAAU,CACR,KAAa,EACb,MAA4B,EAC5B,OAA6B;QAE7B,MAAM,EACJ,eAAe,EAAE,YAAY,EAC7B,UAAU,EAAE,OAAO,EACnB,mBAAmB,EAAE,eAAe,EACpC,eAAe,EAAE,WAAW,EAC5B,qBAAqB,EAAE,iBAAiB,EACxC,GAAG,KAAK,EACT,GAAG,MAAM,CAAC;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,gBAAgB,EAAE;YACzD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,MAAM,EAAE,0BAA0B;gBAClC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACzE,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC1D,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACnF,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACvE,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACzF,GAAG,OAAO,EAAE,OAAO;aACpB;YACD,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,OAAO,kCAAmC,SAAQ,aAAmC;CAAG;AAyT9F,KAAK,CAAC,kCAAkC,GAAG,kCAAkC,CAAC"}

package/resources/vals/index.d.ts

@@ -1,4 +1,4 @@
 export { BranchListResponsesPageCursorURL, Branches, type BranchCreateResponse, type BranchRetrieveResponse, type BranchListResponse, type BranchCreateParams, type BranchListParams, } from "./branches.js";
 export { FileRetrieveResponsesPageCursorURL, Files, type FileCreateResponse, type FileRetrieveResponse, type FileUpdateResponse, type FileCreateParams, type FileRetrieveParams, type FileUpdateParams, type FileDeleteParams, type FileGetContentParams, } from "./files.js";
-export { Vals, type ValCreateParams, type ValListParams } from "./vals.js";
+export { Vals, type ValListResponse, type ValCreateParams, type ValListParams } from "./vals.js";
 //# sourceMappingURL=index.d.ts.map

package/resources/vals/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/vals/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gCAAgC,EAChC,QAAQ,EACR,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kCAAkC,EAClC,KAAK,EACL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/vals/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gCAAgC,EAChC,QAAQ,EACR,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kCAAkC,EAClC,KAAK,EACL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC"}

package/resources/vals/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/vals/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,0CAQoB;AAPlB,4HAAA,gCAAgC,OAAA;AAChC,oGAAA,QAAQ,OAAA;AAOV,oCAWiB;AAVf,2HAAA,kCAAkC,OAAA;AAClC,8FAAA,KAAK,OAAA;AAUP,kCAAwE;AAA/D,4FAAA,IAAI,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/vals/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,0CAQoB;AAPlB,4HAAA,gCAAgC,OAAA;AAChC,oGAAA,QAAQ,OAAA;AAOV,oCAWiB;AAVf,2HAAA,kCAAkC,OAAA;AAClC,8FAAA,KAAK,OAAA;AAUP,kCAA8F;AAArF,4FAAA,IAAI,OAAA"}

package/resources/vals/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/vals/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,gCAAgC,EAChC,QAAQ,GAMT;OACM,EACL,kCAAkC,EAClC,KAAK,GASN;OACM,EAAE,IAAI,EAA4C"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/vals/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,gCAAgC,EAChC,QAAQ,GAMT;OACM,EACL,kCAAkC,EAClC,KAAK,GASN;OACM,EAAE,IAAI,EAAkE"}

package/resources/vals/vals.d.ts

@@ -1,12 +1,10 @@
 import { APIResource } from "../../resource.js";
 import * as Core from "../../core.js";
 import * as Shared from "../shared.js";
-import { ValsPageCursorURL } from "../shared.js";
 import * as BranchesAPI from "./branches.js";
 import { BranchCreateParams, BranchCreateResponse, BranchListParams, BranchListResponse, BranchListResponsesPageCursorURL, BranchRetrieveResponse, Branches } from "./branches.js";
 import * as FilesAPI from "./files.js";
 import { FileCreateParams, FileCreateResponse, FileDeleteParams, FileGetContentParams, FileRetrieveParams, FileRetrieveResponse, FileRetrieveResponsesPageCursorURL, FileUpdateParams, FileUpdateResponse, Files } from "./files.js";
-import { type PageCursorURLParams } from "../../pagination.js";
 /**
  * Vals are a collaborative folder of runnable JavaScript, TypeScript, and JSX modules
  */
@@ -15,32 +13,86 @@ export declare class Vals extends APIResource {
     files: FilesAPI.Files;
     /**
      * Create a new val
+     *
+     * @example
+     * ```ts
+     * const val = await client.vals.create({
+     *   name: 'myVal',
+     *   privacy: 'public',
+     *   description: 'My val',
+     * });
+     * ```
      */
     create(body: ValCreateParams, options?: Core.RequestOptions): Core.APIPromise<Shared.Val>;
     /**
      * Get a val by id
+     *
+     * @example
+     * ```ts
+     * const val = await client.vals.retrieve(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
      */
     retrieve(valId: string, options?: Core.RequestOptions): Core.APIPromise<Shared.Val>;
     /**
-     * Lists all public vals
+     * Lists all vals including all public vals and your unlisted and private vals
+     *
+     * @example
+     * ```ts
+     * const vals = await client.vals.list({ limit: 1 });
+     * ```
      */
-    list(query: ValListParams, options?: Core.RequestOptions): Core.PagePromise<ValsPageCursorURL, Shared.Val>;
+    list(query: ValListParams, options?: Core.RequestOptions): Core.APIPromise<ValListResponse>;
     /**
      * Delete a project
+     *
+     * @example
+     * ```ts
+     * await client.vals.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
      */
     delete(valId: string, options?: Core.RequestOptions): Core.APIPromise<void>;
 }
+/**
+ * A paginated result set
+ */
+export interface ValListResponse {
+    data: Array<Shared.Val>;
+    /**
+     * Links to use for pagination
+     */
+    links: Shared.PaginationLinks;
+}
 export interface ValCreateParams {
     name: string;
     privacy: 'public' | 'unlisted' | 'private';
     description?: string;
 }
-export interface ValListParams extends PageCursorURLParams {
+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
+     */
+    user_id?: string;
 }
 export declare namespace Vals {
-    export { type ValCreateParams as ValCreateParams, type ValListParams as ValListParams };
+    export { type ValListResponse as ValListResponse, type ValCreateParams as ValCreateParams, type ValListParams as ValListParams, };
     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 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 };
 //# sourceMappingURL=vals.d.ts.map

package/resources/vals/vals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vals.d.ts","sourceRoot":"","sources":["../../src/resources/vals/vals.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,WAAW,MAAM,YAAY,CAAC;AAC1C,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,gCAAgC,EAChC,sBAAsB,EACtB,QAAQ,EACT,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,QAAQ,MAAM,SAAS,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,kCAAkC,EAClC,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,EACN,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;GAEG;AACH,qBAAa,IAAK,SAAQ,WAAW;IACnC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAA0C;IACxE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAoC;IAEzD;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC;IAIzF;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC;IAInF;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,CAAC;IAI1G;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;CAM5E;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IAEb,OAAO,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAE3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAc,SAAQ,mBAAmB;CAAG;AAO7D,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EAAE,KAAK,eAAe,IAAI,eAAe,EAAE,KAAK,aAAa,IAAI,aAAa,EAAE,CAAC;IAExF,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,gCAAgC,IAAI,gCAAgC,EACpE,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,GAC1C,CAAC;IAEF,OAAO,EACL,KAAK,IAAI,KAAK,EACd,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,kCAAkC,IAAI,kCAAkC,EACxE,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"vals.d.ts","sourceRoot":"","sources":["../../src/resources/vals/vals.ts"],"names":[],"mappings":"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"}

package/resources/vals/vals.js

@@ -24,10 +24,8 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValsPageCursorURL = exports.Vals = void 0;
+exports.Vals = void 0;
 const resource_1 = require("../../resource.js");
-const shared_1 = require("../shared.js");
-Object.defineProperty(exports, "ValsPageCursorURL", { enumerable: true, get: function () { return shared_1.ValsPageCursorURL; } });
 const BranchesAPI = __importStar(require("./branches.js"));
 const branches_1 = require("./branches.js");
 const FilesAPI = __importStar(require("./files.js"));
@@ -43,24 +41,52 @@ class Vals extends resource_1.APIResource {
     }
     /**
      * Create a new val
+     *
+     * @example
+     * ```ts
+     * const val = await client.vals.create({
+     *   name: 'myVal',
+     *   privacy: 'public',
+     *   description: 'My val',
+     * });
+     * ```
      */
     create(body, options) {
         return this._client.post('/v2/vals', { body, ...options });
     }
     /**
      * Get a val by id
+     *
+     * @example
+     * ```ts
+     * const val = await client.vals.retrieve(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
      */
     retrieve(valId, options) {
         return this._client.get(`/v2/vals/${valId}`, options);
     }
     /**
-     * Lists all public vals
+     * Lists all vals including all public vals and your unlisted and private vals
+     *
+     * @example
+     * ```ts
+     * const vals = await client.vals.list({ limit: 1 });
+     * ```
      */
     list(query, options) {
-        return this._client.getAPIList('/v2/vals', shared_1.ValsPageCursorURL, { query, ...options });
+        return this._client.get('/v2/vals', { query, ...options });
     }
     /**
      * Delete a project
+     *
+     * @example
+     * ```ts
+     * await client.vals.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
      */
     delete(valId, options) {
         return this._client.delete(`/v2/vals/${valId}`, {

package/resources/vals/vals.js.map

@@ -1 +1 @@
-{"version":3,"file":"vals.js","sourceRoot":"","sources":["../../src/resources/vals/vals.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtF,gDAA6C;AAG7C,yCAA8C;AA2GrC,kGA3GA,0BAAiB,OA2GA;AA1G1B,2DAA0C;AAC1C,4CAQoB;AACpB,qDAAoC;AACpC,sCAWiB;AAGjB;;GAEG;AACH,MAAa,IAAK,SAAQ,sBAAW;IAArC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAgC3D,CAAC;IA9BC;;OAEG;IACH,MAAM,CAAC,IAAqB,EAAE,OAA6B;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa,EAAE,OAA6B;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAoB,EAAE,OAA6B;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,0BAAiB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAa,EAAE,OAA6B;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,KAAK,EAAE,EAAE;YAC9C,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;CACF;AAlCD,oBAkCC;AAYD,IAAI,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AACzB,IAAI,CAAC,gCAAgC,GAAG,2CAAgC,CAAC;AACzE,IAAI,CAAC,KAAK,GAAG,aAAK,CAAC;AACnB,IAAI,CAAC,kCAAkC,GAAG,0CAAkC,CAAC"}
+{"version":3,"file":"vals.js","sourceRoot":"","sources":["../../src/resources/vals/vals.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtF,gDAA6C;AAG7C,2DAA0C;AAC1C,4CAQoB;AACpB,qDAAoC;AACpC,sCAWiB;AAEjB;;GAEG;AACH,MAAa,IAAK,SAAQ,sBAAW;IAArC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA4D3D,CAAC;IA1DC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAqB,EAAE,OAA6B;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAa,EAAE,OAA6B;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,KAAoB,EAAE,OAA6B;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAa,EAAE,OAA6B;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,KAAK,EAAE,EAAE;YAC9C,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;CACF;AA9DD,oBA8DC;AA6CD,IAAI,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AACzB,IAAI,CAAC,gCAAgC,GAAG,2CAAgC,CAAC;AACzE,IAAI,CAAC,KAAK,GAAG,aAAK,CAAC;AACnB,IAAI,CAAC,kCAAkC,GAAG,0CAAkC,CAAC"}

package/resources/vals/vals.mjs

@@ -1,6 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../../resource.mjs";
-import { ValsPageCursorURL } from "../shared.mjs";
 import * as BranchesAPI from "./branches.mjs";
 import { BranchListResponsesPageCursorURL, Branches, } from "./branches.mjs";
 import * as FilesAPI from "./files.mjs";
@@ -16,24 +15,52 @@ export class Vals extends APIResource {
     }
     /**
      * Create a new val
+     *
+     * @example
+     * ```ts
+     * const val = await client.vals.create({
+     *   name: 'myVal',
+     *   privacy: 'public',
+     *   description: 'My val',
+     * });
+     * ```
      */
     create(body, options) {
         return this._client.post('/v2/vals', { body, ...options });
     }
     /**
      * Get a val by id
+     *
+     * @example
+     * ```ts
+     * const val = await client.vals.retrieve(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
      */
     retrieve(valId, options) {
         return this._client.get(`/v2/vals/${valId}`, options);
     }
     /**
-     * Lists all public vals
+     * Lists all vals including all public vals and your unlisted and private vals
+     *
+     * @example
+     * ```ts
+     * const vals = await client.vals.list({ limit: 1 });
+     * ```
      */
     list(query, options) {
-        return this._client.getAPIList('/v2/vals', ValsPageCursorURL, { query, ...options });
+        return this._client.get('/v2/vals', { query, ...options });
     }
     /**
      * Delete a project
+     *
+     * @example
+     * ```ts
+     * await client.vals.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
      */
     delete(valId, options) {
         return this._client.delete(`/v2/vals/${valId}`, {
@@ -46,5 +73,4 @@ Vals.Branches = Branches;
 Vals.BranchListResponsesPageCursorURL = BranchListResponsesPageCursorURL;
 Vals.Files = Files;
 Vals.FileRetrieveResponsesPageCursorURL = FileRetrieveResponsesPageCursorURL;
-export { ValsPageCursorURL };
 //# sourceMappingURL=vals.mjs.map

package/resources/vals/vals.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"vals.mjs","sourceRoot":"","sources":["../../src/resources/vals/vals.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,iBAAiB,EAAE;OACrB,KAAK,WAAW;OAChB,EAKL,gCAAgC,EAEhC,QAAQ,GACT;OACM,KAAK,QAAQ;OACb,EAOL,kCAAkC,EAGlC,KAAK,GACN;AAGD;;GAEG;AACH,MAAM,OAAO,IAAK,SAAQ,WAAW;IAArC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAgC3D,CAAC;IA9BC;;OAEG;IACH,MAAM,CAAC,IAAqB,EAAE,OAA6B;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa,EAAE,OAA6B;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAoB,EAAE,OAA6B;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAa,EAAE,OAA6B;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,KAAK,EAAE,EAAE;YAC9C,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;CACF;AAYD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACzB,IAAI,CAAC,gCAAgC,GAAG,gCAAgC,CAAC;AACzE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;AACnB,IAAI,CAAC,kCAAkC,GAAG,kCAAkC,CAAC;AA6B7E,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"vals.mjs","sourceRoot":"","sources":["../../src/resources/vals/vals.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,KAAK,WAAW;OAChB,EAKL,gCAAgC,EAEhC,QAAQ,GACT;OACM,KAAK,QAAQ;OACb,EAOL,kCAAkC,EAGlC,KAAK,GACN;AAED;;GAEG;AACH,MAAM,OAAO,IAAK,SAAQ,WAAW;IAArC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA4D3D,CAAC;IA1DC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAqB,EAAE,OAA6B;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAa,EAAE,OAA6B;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,KAAoB,EAAE,OAA6B;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAa,EAAE,OAA6B;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,KAAK,EAAE,EAAE;YAC9C,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;CACF;AA6CD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACzB,IAAI,CAAC,gCAAgC,GAAG,gCAAgC,CAAC;AACzE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;AACnB,IAAI,CAAC,kCAAkC,GAAG,kCAAkC,CAAC"}

package/src/index.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { type Agent } from './_shims/index';
+import * as qs from './internal/qs';
 import * as Core from './core';
 import * as Errors from './error';
 import * as Pagination from './pagination';
@@ -10,11 +11,17 @@ import * as API from './resources/index';
 import { BlobListParams, BlobListResponse, BlobStoreParams, Blobs } from './resources/blobs';
 import { EmailSendParams, EmailSendResponse, Emails } from './resources/emails';
 import { Sqlite, SqliteBatchParams, SqliteBatchResponse, SqliteExecuteParams } from './resources/sqlite';
+import {
+  Telemetry,
+  TelemetryListParams,
+  TelemetryListResponse,
+  TelemetryListResponsesPageCursorURL,
+} from './resources/telemetry';
 import { Users } from './resources/users';
 import { Alias } from './resources/alias/alias';
 import { Me } from './resources/me/me';
 import { Search } from './resources/search/search';
-import { ValCreateParams, ValListParams, Vals } from './resources/vals/vals';
+import { ValCreateParams, ValListParams, ValListResponse, Vals } from './resources/vals/vals';
 
 export interface ClientOptions {
   /**
@@ -153,6 +160,10 @@ export class ValTown extends Core.APIClient {
    * Vals access a shared SQLite database
    */
   sqlite: API.Sqlite = new API.Sqlite(this);
+  /**
+   * OpenTelemetry traces for your val executions
+   */
+  telemetry: API.Telemetry = new API.Telemetry(this);
   /**
    * Vals are a collaborative folder of runnable JavaScript, TypeScript, and JSX modules
    */
@@ -177,6 +188,10 @@ export class ValTown extends Core.APIClient {
     return { Authorization: `Bearer ${this.bearerToken}` };
   }
 
+  protected override stringifyQuery(query: Record<string, unknown>): string {
+    return qs.stringify(query, { arrayFormat: 'comma' });
+  }
+
   static ValTown = this;
   static DEFAULT_TIMEOUT = 60000; // 1 minute
 
@@ -204,6 +219,8 @@ ValTown.Me = Me;
 ValTown.Blobs = Blobs;
 ValTown.Users = Users;
 ValTown.Sqlite = Sqlite;
+ValTown.Telemetry = Telemetry;
+ValTown.TelemetryListResponsesPageCursorURL = TelemetryListResponsesPageCursorURL;
 ValTown.Vals = Vals;
 ValTown.Emails = Emails;
 export declare namespace ValTown {
@@ -237,7 +254,19 @@ export declare namespace ValTown {
     type SqliteExecuteParams as SqliteExecuteParams,
   };
 
-  export { Vals as Vals, type ValCreateParams as ValCreateParams, type ValListParams as ValListParams };
+  export {
+    Telemetry as Telemetry,
+    type TelemetryListResponse as TelemetryListResponse,
+    TelemetryListResponsesPageCursorURL as TelemetryListResponsesPageCursorURL,
+    type TelemetryListParams as TelemetryListParams,
+  };
+
+  export {
+    Vals as Vals,
+    type ValListResponse as ValListResponse,
+    type ValCreateParams as ValCreateParams,
+    type ValListParams as ValListParams,
+  };
 
   export {
     Emails as Emails,