@bevorai/sdk 0.1.1 → 0.2.0-rc2

package/dist/resources/codes.d.ts

@@ -1,14 +1,14 @@
 import type { BevorClient, RequestOptions } from "../client.js";
-import type { PaginatedResource } from "../pagination.js";
+import { PaginatedResource } from "../pagination.js";
 import { EventResource } from "../streaming.js";
-import type { ID } from "../types/literals.js";
-import type { CodeConnectedRepoBody, CodePasteBody, CodePublicRepoBody, CodeQueryParams, CodeScanBody } from "../types/requests.js";
-import type { ChatSchema, CodeEventData, CodeMappingSchema, GraphSnapshotEdge, Pagination, ResultsResponse } from "../types/responses.js";
+import type { CodeEventData } from "../types/events.js";
+import type { Pagination, ResultsResponse } from "../types/generics.js";
+import type { GraphSnapshotEdge } from "../types/graph_data.js";
+import type { CodeCreateConnectedRepoBody, CodeCreateExplorerScanBody, CodeCreatePasteBody, CodeCreatePublicRepoBody, CodeListParams } from "../types/requests.js";
+import type { Chat, CodeVersionInstance } from "../types/responses.js";
 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 {
@@ -17,48 +17,109 @@ export declare class CodesResources {
     readonly nodes: NodeResources;
     constructor(client: BevorClient);
     /** Methods bound to one code version. */
-    with(codeId: ID): BoundCodesResources;
-    /** GET `/v1/codes` */
-    list(query?: CodeQueryParams, options?: WithoutPagination): Promise<Pagination<CodeMappingSchema>>;
-    list(query: CodeQueryParams | undefined, options: WithPagination): Promise<PaginatedResource<CodeMappingSchema>>;
-    /** GET `/v1/codes/{code_id}` */
-    get(codeId: ID, options?: RequestOptions): Promise<CodeMappingSchema>;
-    /** GET `/v1/codes/{code_id}/edges` (all edges for the snapshot) */
-    edges(codeId: ID, options?: RequestOptions): Promise<ResultsResponse<GraphSnapshotEdge>>;
-    /** POST `/v1/codes/{code_id}/retry` */
-    retry(codeId: ID, options?: RequestOptions): Promise<CodeMappingSchema>;
-    /** POST `/v1/codes/scan` */
-    createScan(body: CodeScanBody, options?: RequestOptions): Promise<CodeMappingSchema>;
-    /** POST `/v1/codes/paste` */
-    createPaste(body: CodePasteBody, options?: RequestOptions): Promise<CodeMappingSchema>;
-    /** POST `/v1/codes/repo` */
-    createPublicRepo(body: CodePublicRepoBody, options?: WithoutStreaming): Promise<CodeMappingSchema>;
-    createPublicRepo(body: CodePublicRepoBody, options: WithStreaming): Promise<CodeResource>;
-    /** POST `/v1/codes/connected-repo` */
-    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`. */
+    with(codeId: string): BoundCodesResources;
+    /**
+     * GET `/v1/codes`
+     *
+     * Code versions in the project.
+     */
+    list(query?: CodeListParams, options?: WithoutPagination): Promise<Pagination<CodeVersionInstance>>;
+    list(query: CodeListParams | undefined, options: WithPagination): Promise<PaginatedResource<CodeVersionInstance>>;
+    /**
+     * GET `/v1/codes/{code_id}`
+     *
+     * A code version.
+     */
+    get(codeId: string, options?: RequestOptions): Promise<CodeVersionInstance>;
+    /**
+     * GET `/v1/codes/{code_id}/edges`
+     *
+     * Every edge in the code graph.
+     */
+    edges(codeId: string, options?: RequestOptions): Promise<ResultsResponse<GraphSnapshotEdge>>;
+    /**
+     * POST `/v1/codes/{code_id}/retry`
+     *
+     * Reprocess code that failed processing.
+     */
+    retry(codeId: string, options?: RequestOptions): Promise<CodeVersionInstance>;
+    /**
+     * POST `/v1/codes/scan`
+     *
+     * Fetch a deployed contract's verified source.
+     */
+    createScan(body: CodeCreateExplorerScanBody, options?: RequestOptions): Promise<CodeVersionInstance>;
+    /**
+     * POST `/v1/codes/paste`
+     *
+     * Code from pasted source.
+     */
+    createPaste(body: CodeCreatePasteBody, options?: RequestOptions): Promise<CodeVersionInstance>;
+    /**
+     * POST `/v1/codes/repo`
+     *
+     * Clone a public GitHub repository.
+     */
+    createPublicRepo(body: CodeCreatePublicRepoBody, options?: WithoutStreaming): Promise<CodeVersionInstance>;
+    createPublicRepo(body: CodeCreatePublicRepoBody, options: WithStreaming): Promise<EventResource<CodeVersionInstance, CodeEventData>>;
+    /**
+     * POST `/v1/codes/connected-repo`
+     *
+     * Clone a repository connected through the GitHub app.
+     */
+    createConnectedRepo(body: CodeCreateConnectedRepoBody, options?: WithoutStreaming): Promise<CodeVersionInstance>;
+    createConnectedRepo(body: CodeCreateConnectedRepoBody, options: WithStreaming): Promise<EventResource<CodeVersionInstance, 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). */
-    createFile(files: readonly UploadFile[], options?: RequestOptions): Promise<CodeMappingSchema>;
-    /** POST `/v1/codes/folder` with a raw zip body, authorized by `signingKey`. */
-    uploadFolderZip(signingKey: string, zip: Uint8Array, options?: WithoutStreaming): Promise<CodeMappingSchema>;
-    uploadFolderZip(signingKey: string, zip: Uint8Array, options: WithStreaming): Promise<CodeResource>;
-    /** POST `/v1/chats` */
-    createChat(codeId: ID, options?: RequestOptions): Promise<ChatSchema>;
+    /**
+     * POST `/v1/codes/file`
+     *
+     * Code from an uploaded file. Only the first file is used.
+     */
+    createFile(files: readonly UploadFile[], options?: RequestOptions): Promise<CodeVersionInstance>;
+    /**
+     * 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<CodeVersionInstance>;
+    uploadFolderZip(signingKey: string, zip: Uint8Array, options: WithStreaming): Promise<EventResource<CodeVersionInstance, CodeEventData>>;
+    /**
+     * POST `/v1/chats`
+     *
+     * Start a chat about code.
+     */
+    createChat(codeId: string, options?: RequestOptions): Promise<Chat>;
 }
 /** Bound to one code version; methods omit `codeId`. */
 export declare class BoundCodesResources {
     #private;
-    readonly codeId: ID;
+    readonly codeId: string;
     readonly files: BoundFileResources;
     readonly nodes: BoundNodeResources;
-    constructor(parent: CodesResources, codeId: ID);
-    /** GET `/v1/codes/{code_id}` */
-    get(options?: RequestOptions): Promise<CodeMappingSchema>;
-    /** GET `/v1/codes/{code_id}/edges` */
+    constructor(parent: CodesResources, codeId: string);
+    /**
+     * GET `/v1/codes/{code_id}`
+     *
+     * A code version.
+     */
+    get(options?: RequestOptions): Promise<CodeVersionInstance>;
+    /**
+     * GET `/v1/codes/{code_id}/edges`
+     *
+     * Every edge in the code graph.
+     */
     edges(options?: RequestOptions): Promise<ResultsResponse<GraphSnapshotEdge>>;
-    /** POST `/v1/codes/{code_id}/retry` */
-    retry(options?: RequestOptions): Promise<CodeMappingSchema>;
+    /**
+     * POST `/v1/codes/{code_id}/retry`
+     *
+     * Reprocess code that failed processing.
+     */
+    retry(options?: RequestOptions): Promise<CodeVersionInstance>;
 }
 //# 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

@@ -1,3 +1,4 @@
+import { PaginatedResource } from "../pagination.js";
 import { EventResource } from "../streaming.js";
 import { FileResources } from "./files.js";
 import { NodeResources } from "./nodes.js";
@@ -15,29 +16,55 @@ export class CodesResources {
     with(codeId) {
         return new BoundCodesResources(this, codeId);
     }
-    list(query, options = {}) {
-        return this.#client.paginate("/v1/codes", query, options);
+    async list(query, options = {}) {
+        const { withPagination, ...requestOptions } = options;
+        const fetchPage = (page) => this.#client.request("GET", "/v1/codes", {
+            ...requestOptions,
+            query: { ...query, page },
+        });
+        const first = await fetchPage(query?.page ?? 0);
+        return withPagination ? new PaginatedResource(first, fetchPage) : first;
     }
-    /** 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,
@@ -64,13 +91,18 @@ export class CodesResources {
                     const parsed = JSON.parse(event.data).data;
                     if (!parsed || parsed.id !== data.id)
                         return null;
-                    return { ...parsed, type: "code.status" };
+                    const result = {
+                        ...parsed,
+                        type: "code.status",
+                    };
+                    return result;
                 }
                 if (event.event === "code.step") {
                     const parsed = JSON.parse(event.data).data;
                     if (!parsed || parsed.id !== data.id)
                         return null;
-                    return { ...parsed, type: "code.step" };
+                    const result = { ...parsed, type: "code.step" };
+                    return result;
                 }
                 return null;
             },
@@ -108,14 +140,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 +170,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 +208,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 +232,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

@@ -1,26 +1,36 @@
 import type { BevorClient, RequestOptions } from "../client.js";
-import type { ID } from "../types/literals.js";
-import type { GraphSnapshotFile, ResultsResponse } from "../types/responses.js";
+import type { ResultsResponse } from "../types/generics.js";
+import type { GraphSnapshotFile } from "../types/graph_data.js";
 /** Unbound: every method takes the `codeId`. */
 export declare class FileResources {
     #private;
     constructor(client: BevorClient);
     /** Methods bound to one code version. */
-    with(codeId: ID): BoundFileResources;
+    with(codeId: string): 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(codeId: ID, fileId: ID, options?: RequestOptions): Promise<GraphSnapshotFile>;
-    /** GET `/v1/codes/{code_id}/files/{file_id}/content` (decoded UTF-8 text) */
-    content(codeId: ID, fileId: ID, options?: RequestOptions): Promise<string>;
+    list(codeId: string, options?: RequestOptions): Promise<ResultsResponse<GraphSnapshotFile>>;
+    /**
+     * GET `/v1/codes/{code_id}/files/{file_id}`
+     *
+     * A file's metadata.
+     */
+    get(codeId: string, fileId: string, options?: RequestOptions): Promise<GraphSnapshotFile>;
+    /**
+     * GET `/v1/codes/{code_id}/files/{file_id}/content`
+     *
+     * A file's text.
+     */
+    content(codeId: string, fileId: string, options?: RequestOptions): Promise<string>;
 }
 /** Bound to one code version; methods omit `codeId`. */
 export declare class BoundFileResources {
     #private;
-    readonly codeId: ID;
-    constructor(parent: FileResources, codeId: ID);
+    readonly codeId: string;
+    constructor(parent: FileResources, codeId: string);
     list(options?: RequestOptions): Promise<ResultsResponse<GraphSnapshotFile>>;
-    get(fileId: ID, options?: RequestOptions): Promise<GraphSnapshotFile>;
-    content(fileId: ID, options?: RequestOptions): Promise<string>;
+    /** A file's metadata. */
+    get(fileId: string, options?: RequestOptions): Promise<GraphSnapshotFile>;
+    /** A file's text. */
+    content(fileId: string, 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;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,gDAAgD;AAChD,qBAAa,aAAa;;IAGzB,YAAY,MAAM,EAAE,WAAW,EAE9B;IAED,yCAAyC;IACzC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAEvC;IAED,sCAAsC;IACtC,IAAI,CACH,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,CAE7C;IAED;;;;OAIG;IACH,GAAG,CACF,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAM5B;IAED;;;;OAIG;IACG,OAAO,CACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CASjB;CACD;AAED,wDAAwD;AACxD,qBAAa,kBAAkB;;IAE9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAGhD;IAED,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,CAE1E;IAED,yBAAyB;IACzB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAExE;IAED,qBAAqB;IACrB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAEjE;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,MAAc;QAClB,OAAO,IAAI,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,sCAAsC;IACtC,IAAI,CACH,MAAc,EACd,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,MAAc,EACd,MAAc,EACd,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,MAAc,EACd,MAAc,EACd,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,CAAS;IAExB,YAAY,MAAqB,EAAE,MAAc;QAChD,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,MAAc,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,qBAAqB;IACrB,OAAO,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;CACD"}

package/dist/resources/findings.d.ts

@@ -1,49 +1,85 @@
 import type { BevorClient, RequestOptions } from "../client.js";
-import type { PaginatedResource } from "../pagination.js";
-import type { ID } from "../types/literals.js";
-import type { EditFindingBody, FindingsQueryParams } from "../types/requests.js";
-import type { ExistsResponse, FindingCommentSchema, FindingSchema, Pagination, ResultsResponse } from "../types/responses.js";
+import { PaginatedResource } from "../pagination.js";
+import type { ExistsResponse, Pagination, ResultsResponse } from "../types/generics.js";
+import type { FindingEditBody, FindingListParams } from "../types/requests.js";
+import type { Finding, FindingComment } from "../types/responses.js";
 import type { WithoutPagination, WithPagination } from "./shared.js";
 export declare class FindingResources {
     #private;
     constructor(client: BevorClient);
     /** Methods bound to one finding. */
-    with(findingId: ID): BoundFindingResources;
-    /** GET `/v1/findings` */
-    list(query?: FindingsQueryParams, options?: WithoutPagination): Promise<Pagination<FindingSchema>>;
-    list(query: FindingsQueryParams | undefined, options: WithPagination): Promise<PaginatedResource<FindingSchema>>;
+    with(findingId: string): BoundFindingResources;
+    /**
+     * GET `/v1/findings`
+     *
+     * Findings across the project.
+     */
+    list(query?: FindingListParams, options?: WithoutPagination): Promise<Pagination<Finding>>;
+    list(query: FindingListParams | undefined, options: WithPagination): Promise<PaginatedResource<Finding>>;
     /** GET `/v1/findings/{finding_id}` */
-    get(findingId: ID, options?: RequestOptions): Promise<FindingSchema>;
-    /** PATCH `/v1/findings/{finding_id}` */
-    editMetadata(findingId: ID, body: EditFindingBody, options?: RequestOptions): Promise<FindingSchema>;
-    /** DELETE `/v1/findings/{finding_id}` */
-    delete(findingId: ID, options?: RequestOptions): Promise<FindingSchema>;
-    /** POST `/v1/findings/{finding_id}/revert` */
-    revert(findingId: ID, options?: RequestOptions): Promise<ExistsResponse<FindingSchema>>;
-    /** PATCH `/v1/findings/{finding_id}/status` */
-    toggleAcknowledgement(findingId: ID, options?: RequestOptions): Promise<FindingSchema>;
+    get(findingId: string, options?: RequestOptions): Promise<Finding>;
+    /**
+     * PATCH `/v1/findings/{finding_id}`
+     *
+     * Stage an edit to a finding.
+     */
+    editMetadata(findingId: string, body: FindingEditBody, options?: RequestOptions): Promise<Finding>;
+    /**
+     * DELETE `/v1/findings/{finding_id}`
+     *
+     * Stage a finding's deletion.
+     */
+    delete(findingId: string, options?: RequestOptions): Promise<Finding>;
+    /**
+     * POST `/v1/findings/{finding_id}/revert`
+     *
+     * Discard a finding's staged change.
+     */
+    revert(findingId: string, options?: RequestOptions): Promise<ExistsResponse<Finding>>;
+    /**
+     * PATCH `/v1/findings/{finding_id}/status`
+     *
+     * Toggle whether a finding is acknowledged.
+     */
+    toggleAcknowledgement(findingId: string, options?: RequestOptions): Promise<Finding>;
     /** GET `/v1/findings/{finding_id}/comments` */
-    comments(findingId: ID, options?: RequestOptions): Promise<ResultsResponse<FindingCommentSchema>>;
+    comments(findingId: string, options?: RequestOptions): Promise<ResultsResponse<FindingComment>>;
     /** POST `/v1/findings/{finding_id}/comments` */
-    comment(findingId: ID, message: string, options?: RequestOptions): Promise<FindingCommentSchema>;
+    comment(findingId: string, message: string, options?: RequestOptions): Promise<FindingComment>;
 }
 export declare class BoundFindingResources {
     #private;
-    readonly findingId: ID;
-    constructor(parent: FindingResources, findingId: ID);
+    readonly findingId: string;
+    constructor(parent: FindingResources, findingId: string);
     /** GET `/v1/findings/{finding_id}` */
-    get(options?: RequestOptions): Promise<FindingSchema>;
-    /** PATCH `/v1/findings/{finding_id}` */
-    editMetadata(body: EditFindingBody, options?: RequestOptions): Promise<FindingSchema>;
-    /** DELETE `/v1/findings/{finding_id}` */
-    delete(options?: RequestOptions): Promise<FindingSchema>;
-    /** POST `/v1/findings/{finding_id}/revert` */
-    revert(options?: RequestOptions): Promise<ExistsResponse<FindingSchema>>;
-    /** PATCH `/v1/findings/{finding_id}/status` */
-    toggleAcknowledgement(options?: RequestOptions): Promise<FindingSchema>;
+    get(options?: RequestOptions): Promise<Finding>;
+    /**
+     * PATCH `/v1/findings/{finding_id}`
+     *
+     * Stage an edit to a finding.
+     */
+    editMetadata(body: FindingEditBody, options?: RequestOptions): Promise<Finding>;
+    /**
+     * DELETE `/v1/findings/{finding_id}`
+     *
+     * Stage a finding's deletion.
+     */
+    delete(options?: RequestOptions): Promise<Finding>;
+    /**
+     * POST `/v1/findings/{finding_id}/revert`
+     *
+     * Discard a finding's staged change.
+     */
+    revert(options?: RequestOptions): Promise<ExistsResponse<Finding>>;
+    /**
+     * PATCH `/v1/findings/{finding_id}/status`
+     *
+     * Toggle whether a finding is acknowledged.
+     */
+    toggleAcknowledgement(options?: RequestOptions): Promise<Finding>;
     /** GET `/v1/findings/{finding_id}/comments` */
-    comments(options?: RequestOptions): Promise<ResultsResponse<FindingCommentSchema>>;
+    comments(options?: RequestOptions): Promise<ResultsResponse<FindingComment>>;
     /** POST `/v1/findings/{finding_id}/comments` */
-    comment(message: string, options?: RequestOptions): Promise<FindingCommentSchema>;
+    comment(message: string, options?: RequestOptions): Promise<FindingComment>;
 }
 //# sourceMappingURL=findings.d.ts.map