@bevorai/sdk 0.1.1 → 0.2.0-rc1

package/dist/resources/chats.d.ts

@@ -13,20 +13,35 @@ export declare class ChatResources {
     createForAnalysis(versionId: ID, options?: RequestOptions): Promise<ChatSchema>;
     /** POST `/v1/chats` */
     createForCode(codeId: ID, options?: RequestOptions): Promise<ChatSchema>;
-    /** GET `/v1/chats` */
+    /**
+     * GET `/v1/chats`
+     *
+     * Chats in the project.
+     */
     list(query?: ChatsQueryParams, options?: WithoutPagination): Promise<Pagination<ChatSchema>>;
     list(query: ChatsQueryParams | undefined, options: WithPagination): Promise<PaginatedResource<ChatSchema>>;
     /** GET `/v1/chats/{chat_id}` */
     get(chatId: ID, options?: RequestOptions): Promise<ChatSchema>;
     /** GET `/v1/chats/{chat_id}/messages` */
     messages(chatId: ID, options?: RequestOptions): Promise<ResultsResponse<ChatMessageSchema>>;
-    /** POST `/v1/chats/{chat_id}/sync` */
+    /**
+     * POST `/v1/chats/{chat_id}/sync`
+     *
+     * Send a message and wait for the full reply.
+     */
     sync(chatId: ID, body: ChatMessageBody, options?: RequestOptions): Promise<ChatMessageSchema>;
-    /** POST `/v1/chats/{chat_id}/session-token`; the token for `stream`. */
+    /**
+     * POST `/v1/chats/{chat_id}/session-token`
+     *
+     * A single-use token for one chat stream. Generate it server-side.
+     */
     sessionToken(chatId: ID, options?: RequestOptions): Promise<string>;
     /**
-     * POST `/v1/chats/{chat_id}/stream`. Get `sessionToken` with `sessionToken()` first.
-     * Lines that aren't a valid streamed message are skipped.
+     * POST `/v1/chats/{chat_id}/stream`
+     *
+     * Use session_token() for initial request
+     *
+     * Send a message and stream the reply.
      */
     stream(chatId: ID, sessionToken: string, body: ChatMessageBody, options?: RequestOptions): AsyncGenerator<StreamedMessageType>;
 }
@@ -38,11 +53,21 @@ export declare class BoundChatResources {
     get(options?: RequestOptions): Promise<ChatSchema>;
     /** GET `/v1/chats/{chat_id}/messages` */
     messages(options?: RequestOptions): Promise<ResultsResponse<ChatMessageSchema>>;
-    /** POST `/v1/chats/{chat_id}/sync` */
+    /**
+     * POST `/v1/chats/{chat_id}/sync`
+     *
+     * Send a message and wait for the full reply.
+     */
     sync(body: ChatMessageBody, options?: RequestOptions): Promise<ChatMessageSchema>;
     /** POST `/v1/chats/{chat_id}/session-token` */
     sessionToken(options?: RequestOptions): Promise<string>;
-    /** POST `/v1/chats/{chat_id}/stream` */
+    /**
+     * POST `/v1/chats/{chat_id}/stream`
+     *
+     * Use session_token() for initial request
+     *
+     * Send a message and stream the reply.
+     */
     stream(sessionToken: string, body: ChatMessageBody, options?: RequestOptions): AsyncGenerator<StreamedMessageType>;
 }
 //# sourceMappingURL=chats.d.ts.map

package/dist/resources/chats.d.ts.map

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

package/dist/resources/chats.js

@@ -51,14 +51,22 @@ export class ChatResources {
     messages(chatId, options) {
         return this.#client.request("GET", `/v1/chats/${chatId}/messages`, options);
     }
-    /** POST `/v1/chats/{chat_id}/sync` */
+    /**
+     * POST `/v1/chats/{chat_id}/sync`
+     *
+     * Send a message and wait for the full reply.
+     */
     sync(chatId, body, options) {
         return this.#client.request("POST", `/v1/chats/${chatId}/sync`, {
             ...options,
             json: body,
         });
     }
-    /** POST `/v1/chats/{chat_id}/session-token`; the token for `stream`. */
+    /**
+     * POST `/v1/chats/{chat_id}/session-token`
+     *
+     * A single-use token for one chat stream. Generate it server-side.
+     */
     async sessionToken(chatId, options) {
         const data = await this.#client.request("POST", `/v1/chats/${chatId}/session-token`, options);
         if (!data?.token)
@@ -66,13 +74,17 @@ export class ChatResources {
         return String(data.token);
     }
     /**
-     * POST `/v1/chats/{chat_id}/stream`. Get `sessionToken` with `sessionToken()` first.
-     * Lines that aren't a valid streamed message are skipped.
+     * POST `/v1/chats/{chat_id}/stream`
+     *
+     * Use session_token() for initial request
+     *
+     * Send a message and stream the reply.
      */
     async *stream(chatId, sessionToken, body, options) {
         const lines = this.#client.streamLines("POST", `/v1/chats/${chatId}/stream`, {
             ...options,
             json: { ...body, token: sessionToken },
+            authenticated: false,
         });
         for await (const line of lines) {
             if (!line)
@@ -98,7 +110,11 @@ export class BoundChatResources {
     messages(options) {
         return this.#parent.messages(this.chatId, options);
     }
-    /** POST `/v1/chats/{chat_id}/sync` */
+    /**
+     * POST `/v1/chats/{chat_id}/sync`
+     *
+     * Send a message and wait for the full reply.
+     */
     sync(body, options) {
         return this.#parent.sync(this.chatId, body, options);
     }
@@ -106,7 +122,13 @@ export class BoundChatResources {
     sessionToken(options) {
         return this.#parent.sessionToken(this.chatId, options);
     }
-    /** POST `/v1/chats/{chat_id}/stream` */
+    /**
+     * POST `/v1/chats/{chat_id}/stream`
+     *
+     * Use session_token() for initial request
+     *
+     * Send a message and stream the reply.
+     */
     stream(sessionToken, body, options) {
         return this.#parent.stream(this.chatId, sessionToken, body, options);
     }

package/dist/resources/chats.js.map

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

package/dist/resources/codes.d.ts

@@ -7,8 +7,6 @@ import type { ChatSchema, CodeEventData, CodeMappingSchema, GraphSnapshotEdge, P
 import { type BoundFileResources, FileResources } from "./files.js";
 import { type BoundNodeResources, NodeResources } from "./nodes.js";
 import type { WithoutPagination, WithoutStreaming, WithPagination, WithStreaming } from "./shared.js";
-/** A code version still being processed, with its progress events. */
-export type CodeResource = EventResource<CodeMappingSchema, CodeEventData>;
 /** A file for `createFile`: its name and contents. */
 export type UploadFile = readonly [name: string, content: Uint8Array | Blob];
 export declare class CodesResources {
@@ -18,33 +16,82 @@ export declare class CodesResources {
     constructor(client: BevorClient);
     /** Methods bound to one code version. */
     with(codeId: ID): BoundCodesResources;
-    /** GET `/v1/codes` */
+    /**
+     * GET `/v1/codes`
+     *
+     * Code versions in the project.
+     */
     list(query?: CodeQueryParams, options?: WithoutPagination): Promise<Pagination<CodeMappingSchema>>;
     list(query: CodeQueryParams | undefined, options: WithPagination): Promise<PaginatedResource<CodeMappingSchema>>;
-    /** GET `/v1/codes/{code_id}` */
+    /**
+     * GET `/v1/codes/{code_id}`
+     *
+     * A code version.
+     */
     get(codeId: ID, options?: RequestOptions): Promise<CodeMappingSchema>;
-    /** GET `/v1/codes/{code_id}/edges` (all edges for the snapshot) */
+    /**
+     * GET `/v1/codes/{code_id}/edges`
+     *
+     * Every edge in the code graph.
+     */
     edges(codeId: ID, options?: RequestOptions): Promise<ResultsResponse<GraphSnapshotEdge>>;
-    /** POST `/v1/codes/{code_id}/retry` */
+    /**
+     * POST `/v1/codes/{code_id}/retry`
+     *
+     * Reprocess code that failed processing.
+     */
     retry(codeId: ID, options?: RequestOptions): Promise<CodeMappingSchema>;
-    /** POST `/v1/codes/scan` */
+    /**
+     * POST `/v1/codes/scan`
+     *
+     * Fetch a deployed contract's verified source.
+     */
     createScan(body: CodeScanBody, options?: RequestOptions): Promise<CodeMappingSchema>;
-    /** POST `/v1/codes/paste` */
+    /**
+     * POST `/v1/codes/paste`
+     *
+     * Code from pasted source.
+     */
     createPaste(body: CodePasteBody, options?: RequestOptions): Promise<CodeMappingSchema>;
-    /** POST `/v1/codes/repo` */
+    /**
+     * POST `/v1/codes/repo`
+     *
+     * Clone a public GitHub repository.
+     */
     createPublicRepo(body: CodePublicRepoBody, options?: WithoutStreaming): Promise<CodeMappingSchema>;
-    createPublicRepo(body: CodePublicRepoBody, options: WithStreaming): Promise<CodeResource>;
-    /** POST `/v1/codes/connected-repo` */
+    createPublicRepo(body: CodePublicRepoBody, options: WithStreaming): Promise<EventResource<CodeMappingSchema, CodeEventData>>;
+    /**
+     * POST `/v1/codes/connected-repo`
+     *
+     * Clone a repository connected through the GitHub app.
+     */
     createConnectedRepo(body: CodeConnectedRepoBody, options?: WithoutStreaming): Promise<CodeMappingSchema>;
-    createConnectedRepo(body: CodeConnectedRepoBody, options: WithStreaming): Promise<CodeResource>;
-    /** POST `/v1/codes/signing-key`; returns the short-lived key for `uploadFolderZip`. */
+    createConnectedRepo(body: CodeConnectedRepoBody, options: WithStreaming): Promise<EventResource<CodeMappingSchema, CodeEventData>>;
+    /**
+     * POST `/v1/codes/signing-key`
+     *
+     * A short-lived, single-use key that authorizes one folder upload. Generate it server-side,
+     * so the API key never reaches the uploading client.
+     */
     generateSigningKey(options?: RequestOptions): Promise<string>;
-    /** POST `/v1/codes/file` (multipart upload; the server uses the first file). */
+    /**
+     * POST `/v1/codes/file`
+     *
+     * Code from an uploaded file. Only the first file is used.
+     */
     createFile(files: readonly UploadFile[], options?: RequestOptions): Promise<CodeMappingSchema>;
-    /** POST `/v1/codes/folder` with a raw zip body, authorized by `signingKey`. */
+    /**
+     * POST `/v1/codes/folder`
+     *
+     * Upload a zipped folder. Authorized by a signing key; the API key isn't sent.
+     */
     uploadFolderZip(signingKey: string, zip: Uint8Array, options?: WithoutStreaming): Promise<CodeMappingSchema>;
-    uploadFolderZip(signingKey: string, zip: Uint8Array, options: WithStreaming): Promise<CodeResource>;
-    /** POST `/v1/chats` */
+    uploadFolderZip(signingKey: string, zip: Uint8Array, options: WithStreaming): Promise<EventResource<CodeMappingSchema, CodeEventData>>;
+    /**
+     * POST `/v1/chats`
+     *
+     * Start a chat about code.
+     */
     createChat(codeId: ID, options?: RequestOptions): Promise<ChatSchema>;
 }
 /** Bound to one code version; methods omit `codeId`. */
@@ -54,11 +101,23 @@ export declare class BoundCodesResources {
     readonly files: BoundFileResources;
     readonly nodes: BoundNodeResources;
     constructor(parent: CodesResources, codeId: ID);
-    /** GET `/v1/codes/{code_id}` */
+    /**
+     * GET `/v1/codes/{code_id}`
+     *
+     * A code version.
+     */
     get(options?: RequestOptions): Promise<CodeMappingSchema>;
-    /** GET `/v1/codes/{code_id}/edges` */
+    /**
+     * GET `/v1/codes/{code_id}/edges`
+     *
+     * Every edge in the code graph.
+     */
     edges(options?: RequestOptions): Promise<ResultsResponse<GraphSnapshotEdge>>;
-    /** POST `/v1/codes/{code_id}/retry` */
+    /**
+     * POST `/v1/codes/{code_id}/retry`
+     *
+     * Reprocess code that failed processing.
+     */
     retry(options?: RequestOptions): Promise<CodeMappingSchema>;
 }
 //# sourceMappingURL=codes.d.ts.map

package/dist/resources/codes.d.ts.map

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

package/dist/resources/codes.js

@@ -18,26 +18,46 @@ export class CodesResources {
     list(query, options = {}) {
         return this.#client.paginate("/v1/codes", query, options);
     }
-    /** GET `/v1/codes/{code_id}` */
+    /**
+     * GET `/v1/codes/{code_id}`
+     *
+     * A code version.
+     */
     get(codeId, options) {
         return this.#client.request("GET", `/v1/codes/${codeId}`, options);
     }
-    /** GET `/v1/codes/{code_id}/edges` (all edges for the snapshot) */
+    /**
+     * GET `/v1/codes/{code_id}/edges`
+     *
+     * Every edge in the code graph.
+     */
     edges(codeId, options) {
         return this.#client.request("GET", `/v1/codes/${codeId}/edges`, options);
     }
-    /** POST `/v1/codes/{code_id}/retry` */
+    /**
+     * POST `/v1/codes/{code_id}/retry`
+     *
+     * Reprocess code that failed processing.
+     */
     retry(codeId, options) {
         return this.#client.request("POST", `/v1/codes/${codeId}/retry`, options);
     }
-    /** POST `/v1/codes/scan` */
+    /**
+     * POST `/v1/codes/scan`
+     *
+     * Fetch a deployed contract's verified source.
+     */
     createScan(body, options) {
         return this.#client.request("POST", "/v1/codes/scan", {
             ...options,
             json: body,
         });
     }
-    /** POST `/v1/codes/paste` */
+    /**
+     * POST `/v1/codes/paste`
+     *
+     * Code from pasted source.
+     */
     createPaste(body, options) {
         return this.#client.request("POST", "/v1/codes/paste", {
             ...options,
@@ -108,14 +128,23 @@ export class CodesResources {
             },
         });
     }
-    /** POST `/v1/codes/signing-key`; returns the short-lived key for `uploadFolderZip`. */
+    /**
+     * POST `/v1/codes/signing-key`
+     *
+     * A short-lived, single-use key that authorizes one folder upload. Generate it server-side,
+     * so the API key never reaches the uploading client.
+     */
     async generateSigningKey(options) {
         const data = await this.#client.request("POST", "/v1/codes/signing-key", options);
         if (!data?.signing_key)
             throw new Error("signing-key response is missing `signing_key`");
         return String(data.signing_key);
     }
-    /** POST `/v1/codes/file` (multipart upload; the server uses the first file). */
+    /**
+     * POST `/v1/codes/file`
+     *
+     * Code from an uploaded file. Only the first file is used.
+     */
     createFile(files, options) {
         if (files.length === 0)
             throw new Error("files must contain at least one [filename, content] pair");
@@ -129,14 +158,17 @@ export class CodesResources {
     }
     async uploadFolderZip(signingKey, zip, options = {}) {
         const { withStreaming, ...requestOptions } = options;
+        const { headers: initialHeaders, ...rest } = requestOptions;
         const data = await this.#client.request("POST", "/v1/codes/folder", {
-            ...requestOptions,
+            ...rest,
             headers: {
-                ...requestOptions.headers,
-                "content-type": "application/octet-stream",
+                ...initialHeaders,
+                "content-type": "application/zip",
             },
             query: { signing_key: signingKey },
             body: zip,
+            // the signing key is the credential, so this is safe to call from a browser
+            authenticated: false,
         });
         if (!withStreaming)
             return data;
@@ -164,7 +196,11 @@ export class CodesResources {
             },
         });
     }
-    /** POST `/v1/chats` */
+    /**
+     * POST `/v1/chats`
+     *
+     * Start a chat about code.
+     */
     createChat(codeId, options) {
         return this.#client.request("POST", "/v1/chats", {
             ...options,
@@ -184,15 +220,27 @@ export class BoundCodesResources {
         this.files = parent.files.with(codeId);
         this.nodes = parent.nodes.with(codeId);
     }
-    /** GET `/v1/codes/{code_id}` */
+    /**
+     * GET `/v1/codes/{code_id}`
+     *
+     * A code version.
+     */
     get(options) {
         return this.#parent.get(this.codeId, options);
     }
-    /** GET `/v1/codes/{code_id}/edges` */
+    /**
+     * GET `/v1/codes/{code_id}/edges`
+     *
+     * Every edge in the code graph.
+     */
     edges(options) {
         return this.#parent.edges(this.codeId, options);
     }
-    /** POST `/v1/codes/{code_id}/retry` */
+    /**
+     * POST `/v1/codes/{code_id}/retry`
+     *
+     * Reprocess code that failed processing.
+     */
     retry(options) {
         return this.#parent.retry(this.codeId, options);
     }

package/dist/resources/codes.js.map

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

package/dist/resources/files.d.ts

@@ -9,9 +9,17 @@ export declare class FileResources {
     with(codeId: ID): BoundFileResources;
     /** GET `/v1/codes/{code_id}/files` */
     list(codeId: ID, options?: RequestOptions): Promise<ResultsResponse<GraphSnapshotFile>>;
-    /** GET `/v1/codes/{code_id}/files/{file_id}` (metadata only) */
+    /**
+     * GET `/v1/codes/{code_id}/files/{file_id}`
+     *
+     * A file's metadata.
+     */
     get(codeId: ID, fileId: ID, options?: RequestOptions): Promise<GraphSnapshotFile>;
-    /** GET `/v1/codes/{code_id}/files/{file_id}/content` (decoded UTF-8 text) */
+    /**
+     * GET `/v1/codes/{code_id}/files/{file_id}/content`
+     *
+     * A file's text.
+     */
     content(codeId: ID, fileId: ID, options?: RequestOptions): Promise<string>;
 }
 /** Bound to one code version; methods omit `codeId`. */
@@ -20,7 +28,9 @@ export declare class BoundFileResources {
     readonly codeId: ID;
     constructor(parent: FileResources, codeId: ID);
     list(options?: RequestOptions): Promise<ResultsResponse<GraphSnapshotFile>>;
+    /** A file's metadata. */
     get(fileId: ID, options?: RequestOptions): Promise<GraphSnapshotFile>;
+    /** A file's text. */
     content(fileId: ID, options?: RequestOptions): Promise<string>;
 }
 //# sourceMappingURL=files.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/resources/files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEhF,gDAAgD;AAChD,qBAAa,aAAa;;IAGzB,YAAY,MAAM,EAAE,WAAW,EAE9B;IAED,yCAAyC;IACzC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,kBAAkB,CAEnC;IAED,sCAAsC;IACtC,IAAI,CACH,MAAM,EAAE,EAAE,EACV,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,CAE7C;IAED,gEAAgE;IAChE,GAAG,CACF,MAAM,EAAE,EAAE,EACV,MAAM,EAAE,EAAE,EACV,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAM5B;IAED,6EAA6E;IACvE,OAAO,CACZ,MAAM,EAAE,EAAE,EACV,MAAM,EAAE,EAAE,EACV,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CASjB;CACD;AAED,wDAAwD;AACxD,qBAAa,kBAAkB;;IAE9B,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;IAEpB,YAAY,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAG5C;IAED,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,CAE1E;IAED,GAAG,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAEpE;IAED,OAAO,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7D;CACD"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/resources/files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEhF,gDAAgD;AAChD,qBAAa,aAAa;;IAGzB,YAAY,MAAM,EAAE,WAAW,EAE9B;IAED,yCAAyC;IACzC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,kBAAkB,CAEnC;IAED,sCAAsC;IACtC,IAAI,CACH,MAAM,EAAE,EAAE,EACV,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,CAE7C;IAED;;;;OAIG;IACH,GAAG,CACF,MAAM,EAAE,EAAE,EACV,MAAM,EAAE,EAAE,EACV,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAM5B;IAED;;;;OAIG;IACG,OAAO,CACZ,MAAM,EAAE,EAAE,EACV,MAAM,EAAE,EAAE,EACV,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CASjB;CACD;AAED,wDAAwD;AACxD,qBAAa,kBAAkB;;IAE9B,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;IAEpB,YAAY,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAG5C;IAED,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,CAE1E;IAED,yBAAyB;IACzB,GAAG,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAEpE;IAED,qBAAqB;IACrB,OAAO,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7D;CACD"}

package/dist/resources/files.js

@@ -12,11 +12,19 @@ export class FileResources {
     list(codeId, options) {
         return this.#client.request("GET", `/v1/codes/${codeId}/files`, options);
     }
-    /** GET `/v1/codes/{code_id}/files/{file_id}` (metadata only) */
+    /**
+     * GET `/v1/codes/{code_id}/files/{file_id}`
+     *
+     * A file's metadata.
+     */
     get(codeId, fileId, options) {
         return this.#client.request("GET", `/v1/codes/${codeId}/files/${fileId}`, options);
     }
-    /** GET `/v1/codes/{code_id}/files/{file_id}/content` (decoded UTF-8 text) */
+    /**
+     * GET `/v1/codes/{code_id}/files/{file_id}/content`
+     *
+     * A file's text.
+     */
     async content(codeId, fileId, options) {
         const data = await this.#client.request("GET", `/v1/codes/${codeId}/files/${fileId}/content`, options);
         if (typeof data?.content !== "string")
@@ -35,9 +43,11 @@ export class BoundFileResources {
     list(options) {
         return this.#parent.list(this.codeId, options);
     }
+    /** A file's metadata. */
     get(fileId, options) {
         return this.#parent.get(this.codeId, fileId, options);
     }
+    /** A file's text. */
     content(fileId, options) {
         return this.#parent.content(this.codeId, fileId, options);
     }

package/dist/resources/files.js.map

@@ -1 +1 @@
-{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/resources/files.ts"],"names":[],"mappings":"AAIA,gDAAgD;AAChD,MAAM,OAAO,aAAa;IAChB,OAAO,CAAc;IAE9B,YAAY,MAAmB;QAC9B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC,MAAU;QACd,OAAO,IAAI,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,sCAAsC;IACtC,IAAI,CACH,MAAU,EACV,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,MAAM,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED,gEAAgE;IAChE,GAAG,CACF,MAAU,EACV,MAAU,EACV,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAC1B,KAAK,EACL,aAAa,MAAM,UAAU,MAAM,EAAE,EACrC,OAAO,CACP,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,OAAO,CACZ,MAAU,EACV,MAAU,EACV,OAAwB;QAExB,MAAM,IAAI,GAAuC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAC1E,KAAK,EACL,aAAa,MAAM,UAAU,MAAM,UAAU,EAC7C,OAAO,CACP,CAAC;QACF,IAAI,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ;YACpC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;CACD;AAED,wDAAwD;AACxD,MAAM,OAAO,kBAAkB;IACrB,OAAO,CAAgB;IACvB,MAAM,CAAK;IAEpB,YAAY,MAAqB,EAAE,MAAU;QAC5C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,OAAwB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,GAAG,CAAC,MAAU,EAAE,OAAwB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,CAAC,MAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;CACD"}
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/resources/files.ts"],"names":[],"mappings":"AAIA,gDAAgD;AAChD,MAAM,OAAO,aAAa;IAChB,OAAO,CAAc;IAE9B,YAAY,MAAmB;QAC9B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC,MAAU;QACd,OAAO,IAAI,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,sCAAsC;IACtC,IAAI,CACH,MAAU,EACV,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,MAAM,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED;;;;OAIG;IACH,GAAG,CACF,MAAU,EACV,MAAU,EACV,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAC1B,KAAK,EACL,aAAa,MAAM,UAAU,MAAM,EAAE,EACrC,OAAO,CACP,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CACZ,MAAU,EACV,MAAU,EACV,OAAwB;QAExB,MAAM,IAAI,GAAuC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAC1E,KAAK,EACL,aAAa,MAAM,UAAU,MAAM,UAAU,EAC7C,OAAO,CACP,CAAC;QACF,IAAI,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ;YACpC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;CACD;AAED,wDAAwD;AACxD,MAAM,OAAO,kBAAkB;IACrB,OAAO,CAAgB;IACvB,MAAM,CAAK;IAEpB,YAAY,MAAqB,EAAE,MAAU;QAC5C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,OAAwB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,yBAAyB;IACzB,GAAG,CAAC,MAAU,EAAE,OAAwB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,qBAAqB;IACrB,OAAO,CAAC,MAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;CACD"}