@deeptable/deeptable 0.1.0-alpha.1 → 0.1.0-alpha.3

package/resources/structured-sheets/tables.d.mts

@@ -0,0 +1,145 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Tables extends APIResource {
+    /**
+     * Get details of a specific table extracted from the structured sheet. Only
+     * available when conversion status is 'completed'.
+     *
+     * @example
+     * ```ts
+     * const tableResponse =
+     *   await client.structuredSheets.tables.retrieve(
+     *     'tbl_01kfxgjd94fn9stqm45rqr2pnz',
+     *     {
+     *       structured_sheets_id: 'ss_01kfxgjd94fn9stqm42nejb627',
+     *     },
+     *   );
+     * ```
+     */
+    retrieve(tableID: string, params: TableRetrieveParams, options?: RequestOptions): APIPromise<TableResponse>;
+    /**
+     * List all tables extracted from the structured sheet. Only available when
+     * conversion status is 'completed'.
+     *
+     * @example
+     * ```ts
+     * const tables = await client.structuredSheets.tables.list(
+     *   'ss_01kfxgjd94fn9stqm42nejb627',
+     * );
+     * ```
+     */
+    list(structuredSheetsID: string, options?: RequestOptions): APIPromise<TableListResponse>;
+    /**
+     * Download the table data in the specified format.
+     *
+     * Available formats:
+     *
+     * - `parquet`: Apache Parquet columnar format (recommended for data analysis)
+     * - `csv`: Comma-separated values (compatible with any spreadsheet application)
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.structuredSheets.tables.download(
+     *     'tbl_01kfxgjd94fn9stqm45rqr2pnz',
+     *     {
+     *       structured_sheets_id: 'ss_01kfxgjd94fn9stqm42nejb627',
+     *       format: 'parquet',
+     *     },
+     *   );
+     *
+     * const content = await response.blob();
+     * console.log(content);
+     * ```
+     */
+    download(tableID: string, params: TableDownloadParams, options?: RequestOptions): APIPromise<Response>;
+}
+/**
+ * Response representing a table extracted from a structured sheet.
+ *
+ * This is returned from GET (retrieve) and list table endpoints. Table names use
+ * SQL naming conventions (e.g., monthly_head_count).
+ */
+export interface TableResponse {
+    /**
+     * The unique identifier for this table.
+     */
+    id: string;
+    /**
+     * The timestamp when this table was created.
+     */
+    created_at: string;
+    /**
+     * The name of the table using SQL naming conventions.
+     */
+    name: string;
+    /**
+     * The original Excel sheet name this table came from.
+     */
+    sheet_name: string;
+    /**
+     * Normalized sheet name for use in SQLite table names and export filenames
+     * (lowercase, snake_case).
+     */
+    sheet_name_normalized: string;
+    /**
+     * The ID of the structured sheet this table belongs to.
+     */
+    structured_sheet_id: string;
+    /**
+     * The type of table (relational, aggregation, or tableless).
+     */
+    type: 'relational' | 'aggregation' | 'tableless';
+    /**
+     * The object type, which is always 'table'.
+     */
+    object?: 'table';
+}
+/**
+ * Paginated response for listing tables from a structured sheet.
+ *
+ * Uses cursor-based pagination for efficient iteration through results.
+ */
+export interface TableListResponse {
+    /**
+     * List of tables.
+     */
+    data: Array<TableResponse>;
+    /**
+     * Whether there are more results available after this page.
+     */
+    has_more: boolean;
+    /**
+     * Unique identifier for a table.
+     */
+    first_id?: string | null;
+    /**
+     * Unique identifier for a table.
+     */
+    last_id?: string | null;
+    /**
+     * The object type, which is always 'list'.
+     */
+    object?: 'list';
+}
+export interface TableRetrieveParams {
+    /**
+     * The unique identifier of the structured sheets conversion.
+     */
+    structured_sheets_id: string;
+}
+export interface TableDownloadParams {
+    /**
+     * Path param: The unique identifier of the structured sheets conversion.
+     */
+    structured_sheets_id: string;
+    /**
+     * Query param: The format to download the table data in.
+     */
+    format: 'parquet' | 'csv';
+}
+export declare namespace Tables {
+    export { type TableResponse as TableResponse, type TableListResponse as TableListResponse, type TableRetrieveParams as TableRetrieveParams, type TableDownloadParams as TableDownloadParams, };
+}
+//# sourceMappingURL=tables.d.mts.map

package/resources/structured-sheets/tables.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.mts","sourceRoot":"","sources":["../../src/resources/structured-sheets/tables.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAGzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,aAAa,CAAC;IAK5B;;;;;;;;;;OAUG;IACH,IAAI,CAAC,kBAAkB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,iBAAiB,CAAC;IAIzF;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;CASvG;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,IAAI,EAAE,YAAY,GAAG,aAAa,GAAG,WAAW,CAAC;IAEjD;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAE3B;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,KAAK,CAAC;CAC3B;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/structured-sheets/tables.d.ts

@@ -0,0 +1,145 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Tables extends APIResource {
+    /**
+     * Get details of a specific table extracted from the structured sheet. Only
+     * available when conversion status is 'completed'.
+     *
+     * @example
+     * ```ts
+     * const tableResponse =
+     *   await client.structuredSheets.tables.retrieve(
+     *     'tbl_01kfxgjd94fn9stqm45rqr2pnz',
+     *     {
+     *       structured_sheets_id: 'ss_01kfxgjd94fn9stqm42nejb627',
+     *     },
+     *   );
+     * ```
+     */
+    retrieve(tableID: string, params: TableRetrieveParams, options?: RequestOptions): APIPromise<TableResponse>;
+    /**
+     * List all tables extracted from the structured sheet. Only available when
+     * conversion status is 'completed'.
+     *
+     * @example
+     * ```ts
+     * const tables = await client.structuredSheets.tables.list(
+     *   'ss_01kfxgjd94fn9stqm42nejb627',
+     * );
+     * ```
+     */
+    list(structuredSheetsID: string, options?: RequestOptions): APIPromise<TableListResponse>;
+    /**
+     * Download the table data in the specified format.
+     *
+     * Available formats:
+     *
+     * - `parquet`: Apache Parquet columnar format (recommended for data analysis)
+     * - `csv`: Comma-separated values (compatible with any spreadsheet application)
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.structuredSheets.tables.download(
+     *     'tbl_01kfxgjd94fn9stqm45rqr2pnz',
+     *     {
+     *       structured_sheets_id: 'ss_01kfxgjd94fn9stqm42nejb627',
+     *       format: 'parquet',
+     *     },
+     *   );
+     *
+     * const content = await response.blob();
+     * console.log(content);
+     * ```
+     */
+    download(tableID: string, params: TableDownloadParams, options?: RequestOptions): APIPromise<Response>;
+}
+/**
+ * Response representing a table extracted from a structured sheet.
+ *
+ * This is returned from GET (retrieve) and list table endpoints. Table names use
+ * SQL naming conventions (e.g., monthly_head_count).
+ */
+export interface TableResponse {
+    /**
+     * The unique identifier for this table.
+     */
+    id: string;
+    /**
+     * The timestamp when this table was created.
+     */
+    created_at: string;
+    /**
+     * The name of the table using SQL naming conventions.
+     */
+    name: string;
+    /**
+     * The original Excel sheet name this table came from.
+     */
+    sheet_name: string;
+    /**
+     * Normalized sheet name for use in SQLite table names and export filenames
+     * (lowercase, snake_case).
+     */
+    sheet_name_normalized: string;
+    /**
+     * The ID of the structured sheet this table belongs to.
+     */
+    structured_sheet_id: string;
+    /**
+     * The type of table (relational, aggregation, or tableless).
+     */
+    type: 'relational' | 'aggregation' | 'tableless';
+    /**
+     * The object type, which is always 'table'.
+     */
+    object?: 'table';
+}
+/**
+ * Paginated response for listing tables from a structured sheet.
+ *
+ * Uses cursor-based pagination for efficient iteration through results.
+ */
+export interface TableListResponse {
+    /**
+     * List of tables.
+     */
+    data: Array<TableResponse>;
+    /**
+     * Whether there are more results available after this page.
+     */
+    has_more: boolean;
+    /**
+     * Unique identifier for a table.
+     */
+    first_id?: string | null;
+    /**
+     * Unique identifier for a table.
+     */
+    last_id?: string | null;
+    /**
+     * The object type, which is always 'list'.
+     */
+    object?: 'list';
+}
+export interface TableRetrieveParams {
+    /**
+     * The unique identifier of the structured sheets conversion.
+     */
+    structured_sheets_id: string;
+}
+export interface TableDownloadParams {
+    /**
+     * Path param: The unique identifier of the structured sheets conversion.
+     */
+    structured_sheets_id: string;
+    /**
+     * Query param: The format to download the table data in.
+     */
+    format: 'parquet' | 'csv';
+}
+export declare namespace Tables {
+    export { type TableResponse as TableResponse, type TableListResponse as TableListResponse, type TableRetrieveParams as TableRetrieveParams, type TableDownloadParams as TableDownloadParams, };
+}
+//# sourceMappingURL=tables.d.ts.map

package/resources/structured-sheets/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../src/resources/structured-sheets/tables.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAGzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,aAAa,CAAC;IAK5B;;;;;;;;;;OAUG;IACH,IAAI,CAAC,kBAAkB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,iBAAiB,CAAC;IAIzF;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;CASvG;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,IAAI,EAAE,YAAY,GAAG,aAAa,GAAG,WAAW,CAAC;IAEjD;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAE3B;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,KAAK,CAAC;CAC3B;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/structured-sheets/tables.js

@@ -0,0 +1,76 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tables = void 0;
+const resource_1 = require("../../core/resource.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+class Tables extends resource_1.APIResource {
+    /**
+     * Get details of a specific table extracted from the structured sheet. Only
+     * available when conversion status is 'completed'.
+     *
+     * @example
+     * ```ts
+     * const tableResponse =
+     *   await client.structuredSheets.tables.retrieve(
+     *     'tbl_01kfxgjd94fn9stqm45rqr2pnz',
+     *     {
+     *       structured_sheets_id: 'ss_01kfxgjd94fn9stqm42nejb627',
+     *     },
+     *   );
+     * ```
+     */
+    retrieve(tableID, params, options) {
+        const { structured_sheets_id } = params;
+        return this._client.get((0, path_1.path) `/v1/structured-sheets/${structured_sheets_id}/tables/${tableID}`, options);
+    }
+    /**
+     * List all tables extracted from the structured sheet. Only available when
+     * conversion status is 'completed'.
+     *
+     * @example
+     * ```ts
+     * const tables = await client.structuredSheets.tables.list(
+     *   'ss_01kfxgjd94fn9stqm42nejb627',
+     * );
+     * ```
+     */
+    list(structuredSheetsID, options) {
+        return this._client.get((0, path_1.path) `/v1/structured-sheets/${structuredSheetsID}/tables`, options);
+    }
+    /**
+     * Download the table data in the specified format.
+     *
+     * Available formats:
+     *
+     * - `parquet`: Apache Parquet columnar format (recommended for data analysis)
+     * - `csv`: Comma-separated values (compatible with any spreadsheet application)
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.structuredSheets.tables.download(
+     *     'tbl_01kfxgjd94fn9stqm45rqr2pnz',
+     *     {
+     *       structured_sheets_id: 'ss_01kfxgjd94fn9stqm42nejb627',
+     *       format: 'parquet',
+     *     },
+     *   );
+     *
+     * const content = await response.blob();
+     * console.log(content);
+     * ```
+     */
+    download(tableID, params, options) {
+        const { structured_sheets_id, ...query } = params;
+        return this._client.get((0, path_1.path) `/v1/structured-sheets/${structured_sheets_id}/tables/${tableID}/download`, {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: 'application/vnd.apache.parquet' }, options?.headers]),
+            __binaryResponse: true,
+        });
+    }
+}
+exports.Tables = Tables;
+//# sourceMappingURL=tables.js.map

package/resources/structured-sheets/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../../src/resources/structured-sheets/tables.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CACN,OAAe,EACf,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,CAAC;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,yBAAyB,oBAAoB,WAAW,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1G,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CAAC,kBAA0B,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,yBAAyB,kBAAkB,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7F,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,OAAe,EAAE,MAA2B,EAAE,OAAwB;QAC7E,MAAM,EAAE,oBAAoB,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,yBAAyB,oBAAoB,WAAW,OAAO,WAAW,EAAE;YACtG,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,gCAAgC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACvF,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;CACF;AAxED,wBAwEC"}

package/resources/structured-sheets/tables.mjs

@@ -0,0 +1,72 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Tables extends APIResource {
+    /**
+     * Get details of a specific table extracted from the structured sheet. Only
+     * available when conversion status is 'completed'.
+     *
+     * @example
+     * ```ts
+     * const tableResponse =
+     *   await client.structuredSheets.tables.retrieve(
+     *     'tbl_01kfxgjd94fn9stqm45rqr2pnz',
+     *     {
+     *       structured_sheets_id: 'ss_01kfxgjd94fn9stqm42nejb627',
+     *     },
+     *   );
+     * ```
+     */
+    retrieve(tableID, params, options) {
+        const { structured_sheets_id } = params;
+        return this._client.get(path `/v1/structured-sheets/${structured_sheets_id}/tables/${tableID}`, options);
+    }
+    /**
+     * List all tables extracted from the structured sheet. Only available when
+     * conversion status is 'completed'.
+     *
+     * @example
+     * ```ts
+     * const tables = await client.structuredSheets.tables.list(
+     *   'ss_01kfxgjd94fn9stqm42nejb627',
+     * );
+     * ```
+     */
+    list(structuredSheetsID, options) {
+        return this._client.get(path `/v1/structured-sheets/${structuredSheetsID}/tables`, options);
+    }
+    /**
+     * Download the table data in the specified format.
+     *
+     * Available formats:
+     *
+     * - `parquet`: Apache Parquet columnar format (recommended for data analysis)
+     * - `csv`: Comma-separated values (compatible with any spreadsheet application)
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.structuredSheets.tables.download(
+     *     'tbl_01kfxgjd94fn9stqm45rqr2pnz',
+     *     {
+     *       structured_sheets_id: 'ss_01kfxgjd94fn9stqm42nejb627',
+     *       format: 'parquet',
+     *     },
+     *   );
+     *
+     * const content = await response.blob();
+     * console.log(content);
+     * ```
+     */
+    download(tableID, params, options) {
+        const { structured_sheets_id, ...query } = params;
+        return this._client.get(path `/v1/structured-sheets/${structured_sheets_id}/tables/${tableID}/download`, {
+            query,
+            ...options,
+            headers: buildHeaders([{ Accept: 'application/vnd.apache.parquet' }, options?.headers]),
+            __binaryResponse: true,
+        });
+    }
+}
+//# sourceMappingURL=tables.mjs.map

package/resources/structured-sheets/tables.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.mjs","sourceRoot":"","sources":["../../src/resources/structured-sheets/tables.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CACN,OAAe,EACf,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,CAAC;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,yBAAyB,oBAAoB,WAAW,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1G,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CAAC,kBAA0B,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,yBAAyB,kBAAkB,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7F,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,OAAe,EAAE,MAA2B,EAAE,OAAwB;QAC7E,MAAM,EAAE,oBAAoB,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,yBAAyB,oBAAoB,WAAW,OAAO,WAAW,EAAE;YACtG,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,gCAAgC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACvF,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;CACF"}

package/src/client.ts

@@ -21,10 +21,11 @@ import { APIPromise } from './core/api-promise';
 import { File, FileListParams, FileUploadParams, Files, FilesCursorIDPage } from './resources/files';
 import {
   StructuredSheetCreateParams,
+  StructuredSheetDownloadParams,
   StructuredSheetListParams,
-  StructuredSheetResponse,
-  StructuredSheetResponsesCursorIDPage,
   StructuredSheets,
+  StructuredSheetsResponse,
+  StructuredSheetsResponsesCursorIDPage,
 } from './resources/structured-sheets/structured-sheets';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
@@ -765,9 +766,10 @@ export declare namespace DeepTable {
 
   export {
     StructuredSheets as StructuredSheets,
-    type StructuredSheetResponse as StructuredSheetResponse,
-    type StructuredSheetResponsesCursorIDPage as StructuredSheetResponsesCursorIDPage,
+    type StructuredSheetsResponse as StructuredSheetsResponse,
+    type StructuredSheetsResponsesCursorIDPage as StructuredSheetsResponsesCursorIDPage,
     type StructuredSheetCreateParams as StructuredSheetCreateParams,
     type StructuredSheetListParams as StructuredSheetListParams,
+    type StructuredSheetDownloadParams as StructuredSheetDownloadParams,
   };
 }

package/src/resources/files.ts

@@ -16,7 +16,7 @@ export class Files extends APIResource {
    * @example
    * ```ts
    * const file = await client.files.retrieve(
-   *   'file_01abc2def3ghjkmnpqrs4uvwxy',
+   *   'file_01kfxgjd94fn9stqm414vjb0s8',
    * );
    * ```
    */
@@ -48,7 +48,7 @@ export class Files extends APIResource {
    * @example
    * ```ts
    * await client.files.delete(
-   *   'file_01abc2def3ghjkmnpqrs4uvwxy',
+   *   'file_01kfxgjd94fn9stqm414vjb0s8',
    * );
    * ```
    */
@@ -59,6 +59,30 @@ export class Files extends APIResource {
     });
   }
 
+  /**
+   * Download the original uploaded file content.
+   *
+   * @example
+   * ```ts
+   * const response = await client.files.download(
+   *   'file_01kfxgjd94fn9stqm414vjb0s8',
+   * );
+   *
+   * const content = await response.blob();
+   * console.log(content);
+   * ```
+   */
+  download(fileID: string, options?: RequestOptions): APIPromise<Response> {
+    return this._client.get(path`/v1/files/${fileID}/content`, {
+      ...options,
+      headers: buildHeaders([
+        { Accept: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' },
+        options?.headers,
+      ]),
+      __binaryResponse: true,
+    });
+  }
+
   /**
    * Upload an Excel spreadsheet file for later processing.
    *

package/src/resources/index.ts

@@ -9,8 +9,9 @@ export {
 } from './files';
 export {
   StructuredSheets,
-  type StructuredSheetResponse,
+  type StructuredSheetsResponse,
   type StructuredSheetCreateParams,
   type StructuredSheetListParams,
-  type StructuredSheetResponsesCursorIDPage,
+  type StructuredSheetDownloadParams,
+  type StructuredSheetsResponsesCursorIDPage,
 } from './structured-sheets/structured-sheets';

package/src/resources/structured-sheets/index.ts

@@ -1,10 +1,17 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Exports } from './exports';
 export {
   StructuredSheets,
-  type StructuredSheetResponse,
+  type StructuredSheetsResponse,
   type StructuredSheetCreateParams,
   type StructuredSheetListParams,
-  type StructuredSheetResponsesCursorIDPage,
+  type StructuredSheetDownloadParams,
+  type StructuredSheetsResponsesCursorIDPage,
 } from './structured-sheets';
+export {
+  Tables,
+  type TableResponse,
+  type TableListResponse,
+  type TableRetrieveParams,
+  type TableDownloadParams,
+} from './tables';