@llamaindex/llama-cloud 0.14.1

package/resources/beta/sheets.d.ts

@@ -0,0 +1,319 @@
+import { APIResource } from "../../core/resource.js";
+import * as FilesAPI from "../files.js";
+import * as ParsingAPI from "../parsing.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { PagePromise, PaginatedClassifyJobs, type PaginatedClassifyJobsParams } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+import { PollingOptions } from "../../core/polling.js";
+export declare class Sheets extends APIResource {
+    /**
+     * Create a spreadsheet parsing job. Experimental: This endpoint is not yet ready
+     * for production use and is subject to change at any time.
+     */
+    create(params: SheetCreateParams, options?: RequestOptions): APIPromise<SheetsJob>;
+    /**
+     * List spreadsheet parsing jobs. Experimental: This endpoint is not yet ready for
+     * production use and is subject to change at any time.
+     */
+    list(query?: SheetListParams | null | undefined, options?: RequestOptions): PagePromise<SheetsJobsPaginatedClassifyJobs, SheetsJob>;
+    /**
+     * Delete a spreadsheet parsing job and its associated data. Experimental: This
+     * endpoint is not yet ready for production use and is subject to change at any
+     * time.
+     */
+    deleteJob(spreadsheetJobID: string, params?: SheetDeleteJobParams | null | undefined, options?: RequestOptions): APIPromise<unknown>;
+    /**
+     * Get a spreadsheet parsing job.
+     *
+     * When include_results=True (default), the response will include extracted regions
+     * and results if the job is complete, eliminating the need for a separate /results
+     * call.
+     *
+     * Experimental: This endpoint is not yet ready for production use and is subject
+     * to change at any time.
+     */
+    get(spreadsheetJobID: string, query?: SheetGetParams | null | undefined, options?: RequestOptions): APIPromise<SheetsJob>;
+    /**
+     * Generate a presigned URL to download a specific extracted region. Experimental:
+     * This endpoint is not yet ready for production use and is subject to change at
+     * any time.
+     */
+    getResultTable(regionType: 'table' | 'extra' | 'cell_metadata', params: SheetGetResultTableParams, options?: RequestOptions): APIPromise<FilesAPI.PresignedURL>;
+    /**
+     * Create a spreadsheet parsing job and wait for it to complete, returning the job with results.
+     *
+     * This is a convenience method that combines create() and waitForCompletion()
+     * into a single call for the most common end-to-end workflow.
+     *
+     * @param params - Parameters including the file_id and parsing configuration
+     * @param options - Request and polling configuration options
+     * @returns The completed SheetsJob with results included
+     * @throws {PollingTimeoutError} If the job doesn't complete within the timeout period
+     * @throws {PollingError} If the job fails or is cancelled
+     *
+     * @example
+     * ```typescript
+     * import LlamaCloud from 'llama-cloud';
+     *
+     * const client = new LlamaCloud({ apiKey: '...' });
+     *
+     * // One-shot: create job, wait for completion, and get results
+     * const job = await client.beta.sheets.parse({
+     *   file_id: 'file_123',
+     *   verbose: true
+     * });
+     *
+     * // Results are ready to use immediately
+     * for (const region of job.regions ?? []) {
+     *   console.log(`Region ${region.region_id}: ${region.region_type}`);
+     * }
+     * ```
+     */
+    parse(params: SheetParseParams, options?: RequestOptions): Promise<SheetsJob>;
+    /**
+     * Wait for a spreadsheet parsing job to complete by polling until it reaches a terminal state.
+     *
+     * This method polls the job status at regular intervals until the job completes
+     * successfully or fails. It uses configurable backoff strategies to optimize
+     * polling behavior.
+     *
+     * @param spreadsheetJobID - The ID of the spreadsheet job to wait for
+     * @param params - Query parameters and polling configuration
+     * @param options - Additional request options
+     * @returns The completed SheetsJob with results included
+     * @throws {PollingTimeoutError} If the job doesn't complete within the timeout period
+     * @throws {PollingError} If the job fails or is cancelled
+     *
+     * @example
+     * ```typescript
+     * import LlamaCloud from 'llama-cloud';
+     *
+     * const client = new LlamaCloud({ apiKey: '...' });
+     *
+     * // Create a spreadsheet parsing job
+     * const job = await client.beta.sheets.create({ file_id: 'file_123' });
+     *
+     * // Wait for it to complete
+     * const completedJob = await client.beta.sheets.waitForCompletion(job.id, {
+     *   verbose: true
+     * });
+     *
+     * // Access the results
+     * for (const region of completedJob.regions ?? []) {
+     *   console.log(`Region ${region.region_id}: ${region.region_type}`);
+     * }
+     * ```
+     */
+    waitForCompletion(spreadsheetJobID: string, params?: SheetWaitForCompletionParams | null | undefined, options?: RequestOptions): Promise<SheetsJob>;
+}
+export type SheetsJobsPaginatedClassifyJobs = PaginatedClassifyJobs<SheetsJob>;
+/**
+ * A spreadsheet parsing job
+ */
+export interface SheetsJob {
+    /**
+     * The ID of the job
+     */
+    id: string;
+    /**
+     * Configuration for the parsing job
+     */
+    config: SheetsParsingConfig;
+    /**
+     * When the job was created
+     */
+    created_at: string;
+    /**
+     * The ID of the input file
+     */
+    file_id: string | null;
+    /**
+     * The ID of the project
+     */
+    project_id: string;
+    /**
+     * The status of the parsing job
+     */
+    status: ParsingAPI.StatusEnum;
+    /**
+     * When the job was last updated
+     */
+    updated_at: string;
+    /**
+     * The ID of the user
+     */
+    user_id: string;
+    /**
+     * Any errors encountered
+     */
+    errors?: Array<string>;
+    /**
+     * @deprecated Schema for a file.
+     */
+    file?: FilesAPI.File | null;
+    /**
+     * All extracted regions (populated when job is complete)
+     */
+    regions?: Array<SheetsJob.Region>;
+    /**
+     * Whether the job completed successfully
+     */
+    success?: boolean | null;
+    /**
+     * Metadata for each processed worksheet (populated when job is complete)
+     */
+    worksheet_metadata?: Array<SheetsJob.WorksheetMetadata>;
+}
+export declare namespace SheetsJob {
+    /**
+     * A summary of a single extracted region from a spreadsheet
+     */
+    interface Region {
+        /**
+         * Location of the region in the spreadsheet
+         */
+        location: string;
+        /**
+         * Type of the extracted region
+         */
+        region_type: string;
+        /**
+         * Worksheet name where region was found
+         */
+        sheet_name: string;
+        /**
+         * Generated description for the region
+         */
+        description?: string | null;
+        /**
+         * Unique identifier for this region within the file
+         */
+        region_id?: string;
+        /**
+         * Generated title for the region
+         */
+        title?: string | null;
+    }
+    /**
+     * Metadata about a worksheet in a spreadsheet
+     */
+    interface WorksheetMetadata {
+        /**
+         * Name of the worksheet
+         */
+        sheet_name: string;
+        /**
+         * Generated description of the worksheet
+         */
+        description?: string | null;
+        /**
+         * Generated title for the worksheet
+         */
+        title?: string | null;
+    }
+}
+/**
+ * Configuration for spreadsheet parsing and region extraction
+ */
+export interface SheetsParsingConfig {
+    /**
+     * A1 notation of the range to extract a single region from. If None, the entire
+     * sheet is used.
+     */
+    extraction_range?: string | null;
+    /**
+     * Return a flattened dataframe when a detected table is recognized as
+     * hierarchical.
+     */
+    flatten_hierarchical_tables?: boolean;
+    /**
+     * Whether to generate additional metadata (title, description) for each extracted
+     * region.
+     */
+    generate_additional_metadata?: boolean;
+    /**
+     * Whether to include hidden cells when extracting regions from the spreadsheet.
+     */
+    include_hidden_cells?: boolean;
+    /**
+     * The names of the sheets to extract regions from. If empty, all sheets will be
+     * processed.
+     */
+    sheet_names?: Array<string> | null;
+    /**
+     * Influences how likely similar-looking regions are merged into a single table.
+     * Useful for spreadsheets that either have sparse tables (strong merging) or many
+     * distinct tables close together (weak merging).
+     */
+    table_merge_sensitivity?: 'strong' | 'weak';
+    /**
+     * Enables experimental processing. Accuracy may be impacted.
+     */
+    use_experimental_processing?: boolean;
+}
+export type SheetDeleteJobResponse = unknown;
+export interface SheetCreateParams {
+    /**
+     * Body param: The ID of the file to parse
+     */
+    file_id: string;
+    /**
+     * Query param
+     */
+    organization_id?: string | null;
+    /**
+     * Query param
+     */
+    project_id?: string | null;
+    /**
+     * Body param: Configuration for the parsing job
+     */
+    config?: SheetsParsingConfig;
+}
+export interface SheetListParams extends PaginatedClassifyJobsParams {
+    include_results?: boolean;
+    organization_id?: string | null;
+    project_id?: string | null;
+}
+export interface SheetDeleteJobParams {
+    organization_id?: string | null;
+    project_id?: string | null;
+}
+export interface SheetGetParams {
+    include_results?: boolean;
+    organization_id?: string | null;
+    project_id?: string | null;
+}
+export interface SheetGetResultTableParams {
+    /**
+     * Path param
+     */
+    spreadsheet_job_id: string;
+    /**
+     * Path param
+     */
+    region_id: string;
+    /**
+     * Query param
+     */
+    expires_at_seconds?: number | null;
+    /**
+     * Query param
+     */
+    organization_id?: string | null;
+    /**
+     * Query param
+     */
+    project_id?: string | null;
+}
+export interface SheetParseParams extends SheetCreateParams, PollingOptions {
+}
+export interface SheetWaitForCompletionParams extends PollingOptions {
+    include_results?: boolean;
+    organization_id?: string | null;
+    project_id?: string | null;
+}
+export declare namespace Sheets {
+    export { type SheetsJob as SheetsJob, type SheetsParsingConfig as SheetsParsingConfig, type SheetDeleteJobResponse as SheetDeleteJobResponse, type SheetsJobsPaginatedClassifyJobs as SheetsJobsPaginatedClassifyJobs, type SheetCreateParams as SheetCreateParams, type SheetListParams as SheetListParams, type SheetDeleteJobParams as SheetDeleteJobParams, type SheetGetParams as SheetGetParams, type SheetGetResultTableParams as SheetGetResultTableParams, type SheetParseParams as SheetParseParams, type SheetWaitForCompletionParams as SheetWaitForCompletionParams, };
+}
+//# sourceMappingURL=sheets.d.ts.map

package/resources/beta/sheets.d.ts.map

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

package/resources/beta/sheets.js

@@ -0,0 +1,177 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sheets = void 0;
+const resource_1 = require("../../core/resource.js");
+const pagination_1 = require("../../core/pagination.js");
+const path_1 = require("../../internal/utils/path.js");
+const polling_1 = require("../../core/polling.js");
+class Sheets extends resource_1.APIResource {
+    /**
+     * Create a spreadsheet parsing job. Experimental: This endpoint is not yet ready
+     * for production use and is subject to change at any time.
+     */
+    create(params, options) {
+        const { organization_id, project_id, ...body } = params;
+        return this._client.post('/api/v1/beta/sheets/jobs', {
+            query: { organization_id, project_id },
+            body,
+            ...options,
+        });
+    }
+    /**
+     * List spreadsheet parsing jobs. Experimental: This endpoint is not yet ready for
+     * production use and is subject to change at any time.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/api/v1/beta/sheets/jobs', (pagination_1.PaginatedClassifyJobs), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Delete a spreadsheet parsing job and its associated data. Experimental: This
+     * endpoint is not yet ready for production use and is subject to change at any
+     * time.
+     */
+    deleteJob(spreadsheetJobID, params = {}, options) {
+        const { organization_id, project_id } = params ?? {};
+        return this._client.delete((0, path_1.path) `/api/v1/beta/sheets/jobs/${spreadsheetJobID}`, {
+            query: { organization_id, project_id },
+            ...options,
+        });
+    }
+    /**
+     * Get a spreadsheet parsing job.
+     *
+     * When include_results=True (default), the response will include extracted regions
+     * and results if the job is complete, eliminating the need for a separate /results
+     * call.
+     *
+     * Experimental: This endpoint is not yet ready for production use and is subject
+     * to change at any time.
+     */
+    get(spreadsheetJobID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/api/v1/beta/sheets/jobs/${spreadsheetJobID}`, { query, ...options });
+    }
+    /**
+     * Generate a presigned URL to download a specific extracted region. Experimental:
+     * This endpoint is not yet ready for production use and is subject to change at
+     * any time.
+     */
+    getResultTable(regionType, params, options) {
+        const { spreadsheet_job_id, region_id, ...query } = params;
+        return this._client.get((0, path_1.path) `/api/v1/beta/sheets/jobs/${spreadsheet_job_id}/regions/${region_id}/result/${regionType}`, { query, ...options });
+    }
+    /**
+     * Create a spreadsheet parsing job and wait for it to complete, returning the job with results.
+     *
+     * This is a convenience method that combines create() and waitForCompletion()
+     * into a single call for the most common end-to-end workflow.
+     *
+     * @param params - Parameters including the file_id and parsing configuration
+     * @param options - Request and polling configuration options
+     * @returns The completed SheetsJob with results included
+     * @throws {PollingTimeoutError} If the job doesn't complete within the timeout period
+     * @throws {PollingError} If the job fails or is cancelled
+     *
+     * @example
+     * ```typescript
+     * import LlamaCloud from 'llama-cloud';
+     *
+     * const client = new LlamaCloud({ apiKey: '...' });
+     *
+     * // One-shot: create job, wait for completion, and get results
+     * const job = await client.beta.sheets.parse({
+     *   file_id: 'file_123',
+     *   verbose: true
+     * });
+     *
+     * // Results are ready to use immediately
+     * for (const region of job.regions ?? []) {
+     *   console.log(`Region ${region.region_id}: ${region.region_type}`);
+     * }
+     * ```
+     */
+    async parse(params, options) {
+        const { pollingInterval, maxInterval, timeout, backoff, verbose, ...createParams } = params;
+        // Create the job
+        const job = await this.create(createParams, options);
+        // Wait for completion
+        const pollingOptions = { ...options };
+        if (pollingInterval !== undefined)
+            pollingOptions.pollingInterval = pollingInterval;
+        if (maxInterval !== undefined)
+            pollingOptions.maxInterval = maxInterval;
+        if (timeout !== undefined)
+            pollingOptions.timeout = timeout;
+        if (backoff !== undefined)
+            pollingOptions.backoff = backoff;
+        if (verbose !== undefined)
+            pollingOptions.verbose = verbose;
+        // Only pass query params that are valid for waitForCompletion
+        const waitParams = {
+            ...pollingOptions,
+        };
+        if (createParams.organization_id !== undefined)
+            waitParams.organization_id = createParams.organization_id;
+        if (createParams.project_id !== undefined)
+            waitParams.project_id = createParams.project_id;
+        return this.waitForCompletion(job.id, waitParams);
+    }
+    /**
+     * Wait for a spreadsheet parsing job to complete by polling until it reaches a terminal state.
+     *
+     * This method polls the job status at regular intervals until the job completes
+     * successfully or fails. It uses configurable backoff strategies to optimize
+     * polling behavior.
+     *
+     * @param spreadsheetJobID - The ID of the spreadsheet job to wait for
+     * @param params - Query parameters and polling configuration
+     * @param options - Additional request options
+     * @returns The completed SheetsJob with results included
+     * @throws {PollingTimeoutError} If the job doesn't complete within the timeout period
+     * @throws {PollingError} If the job fails or is cancelled
+     *
+     * @example
+     * ```typescript
+     * import LlamaCloud from 'llama-cloud';
+     *
+     * const client = new LlamaCloud({ apiKey: '...' });
+     *
+     * // Create a spreadsheet parsing job
+     * const job = await client.beta.sheets.create({ file_id: 'file_123' });
+     *
+     * // Wait for it to complete
+     * const completedJob = await client.beta.sheets.waitForCompletion(job.id, {
+     *   verbose: true
+     * });
+     *
+     * // Access the results
+     * for (const region of completedJob.regions ?? []) {
+     *   console.log(`Region ${region.region_id}: ${region.region_type}`);
+     * }
+     * ```
+     */
+    async waitForCompletion(spreadsheetJobID, params = {}, options) {
+        const { pollingInterval, maxInterval, timeout, backoff, verbose, ...queryParams } = params ?? {};
+        const pollingOptions = {
+            pollingInterval: pollingInterval ?? 1.0,
+            maxInterval: maxInterval ?? 5.0,
+            timeout: timeout ?? 300.0,
+            backoff: backoff ?? 'linear',
+            verbose: verbose ?? false,
+        };
+        return (0, polling_1.pollUntilComplete)(async () => {
+            return this.get(spreadsheetJobID, { include_results: true, ...queryParams }, options);
+        }, (job) => job.status === 'SUCCESS' || job.status === 'PARTIAL_SUCCESS', (job) => job.status === 'ERROR' || job.status === 'CANCELLED', (job) => {
+            const errorParts = [`Job ${spreadsheetJobID} failed with status: ${job.status}`];
+            if (job.errors && job.errors.length > 0) {
+                errorParts.push(`Errors: ${job.errors.join(', ')}`);
+            }
+            return errorParts.join(' | ');
+        }, pollingOptions);
+    }
+}
+exports.Sheets = Sheets;
+//# sourceMappingURL=sheets.js.map

package/resources/beta/sheets.js.map

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

package/resources/beta/sheets.mjs

@@ -0,0 +1,173 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { PaginatedClassifyJobs } from "../../core/pagination.mjs";
+import { path } from "../../internal/utils/path.mjs";
+import { pollUntilComplete } from "../../core/polling.mjs";
+export class Sheets extends APIResource {
+    /**
+     * Create a spreadsheet parsing job. Experimental: This endpoint is not yet ready
+     * for production use and is subject to change at any time.
+     */
+    create(params, options) {
+        const { organization_id, project_id, ...body } = params;
+        return this._client.post('/api/v1/beta/sheets/jobs', {
+            query: { organization_id, project_id },
+            body,
+            ...options,
+        });
+    }
+    /**
+     * List spreadsheet parsing jobs. Experimental: This endpoint is not yet ready for
+     * production use and is subject to change at any time.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/api/v1/beta/sheets/jobs', (PaginatedClassifyJobs), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Delete a spreadsheet parsing job and its associated data. Experimental: This
+     * endpoint is not yet ready for production use and is subject to change at any
+     * time.
+     */
+    deleteJob(spreadsheetJobID, params = {}, options) {
+        const { organization_id, project_id } = params ?? {};
+        return this._client.delete(path `/api/v1/beta/sheets/jobs/${spreadsheetJobID}`, {
+            query: { organization_id, project_id },
+            ...options,
+        });
+    }
+    /**
+     * Get a spreadsheet parsing job.
+     *
+     * When include_results=True (default), the response will include extracted regions
+     * and results if the job is complete, eliminating the need for a separate /results
+     * call.
+     *
+     * Experimental: This endpoint is not yet ready for production use and is subject
+     * to change at any time.
+     */
+    get(spreadsheetJobID, query = {}, options) {
+        return this._client.get(path `/api/v1/beta/sheets/jobs/${spreadsheetJobID}`, { query, ...options });
+    }
+    /**
+     * Generate a presigned URL to download a specific extracted region. Experimental:
+     * This endpoint is not yet ready for production use and is subject to change at
+     * any time.
+     */
+    getResultTable(regionType, params, options) {
+        const { spreadsheet_job_id, region_id, ...query } = params;
+        return this._client.get(path `/api/v1/beta/sheets/jobs/${spreadsheet_job_id}/regions/${region_id}/result/${regionType}`, { query, ...options });
+    }
+    /**
+     * Create a spreadsheet parsing job and wait for it to complete, returning the job with results.
+     *
+     * This is a convenience method that combines create() and waitForCompletion()
+     * into a single call for the most common end-to-end workflow.
+     *
+     * @param params - Parameters including the file_id and parsing configuration
+     * @param options - Request and polling configuration options
+     * @returns The completed SheetsJob with results included
+     * @throws {PollingTimeoutError} If the job doesn't complete within the timeout period
+     * @throws {PollingError} If the job fails or is cancelled
+     *
+     * @example
+     * ```typescript
+     * import LlamaCloud from 'llama-cloud';
+     *
+     * const client = new LlamaCloud({ apiKey: '...' });
+     *
+     * // One-shot: create job, wait for completion, and get results
+     * const job = await client.beta.sheets.parse({
+     *   file_id: 'file_123',
+     *   verbose: true
+     * });
+     *
+     * // Results are ready to use immediately
+     * for (const region of job.regions ?? []) {
+     *   console.log(`Region ${region.region_id}: ${region.region_type}`);
+     * }
+     * ```
+     */
+    async parse(params, options) {
+        const { pollingInterval, maxInterval, timeout, backoff, verbose, ...createParams } = params;
+        // Create the job
+        const job = await this.create(createParams, options);
+        // Wait for completion
+        const pollingOptions = { ...options };
+        if (pollingInterval !== undefined)
+            pollingOptions.pollingInterval = pollingInterval;
+        if (maxInterval !== undefined)
+            pollingOptions.maxInterval = maxInterval;
+        if (timeout !== undefined)
+            pollingOptions.timeout = timeout;
+        if (backoff !== undefined)
+            pollingOptions.backoff = backoff;
+        if (verbose !== undefined)
+            pollingOptions.verbose = verbose;
+        // Only pass query params that are valid for waitForCompletion
+        const waitParams = {
+            ...pollingOptions,
+        };
+        if (createParams.organization_id !== undefined)
+            waitParams.organization_id = createParams.organization_id;
+        if (createParams.project_id !== undefined)
+            waitParams.project_id = createParams.project_id;
+        return this.waitForCompletion(job.id, waitParams);
+    }
+    /**
+     * Wait for a spreadsheet parsing job to complete by polling until it reaches a terminal state.
+     *
+     * This method polls the job status at regular intervals until the job completes
+     * successfully or fails. It uses configurable backoff strategies to optimize
+     * polling behavior.
+     *
+     * @param spreadsheetJobID - The ID of the spreadsheet job to wait for
+     * @param params - Query parameters and polling configuration
+     * @param options - Additional request options
+     * @returns The completed SheetsJob with results included
+     * @throws {PollingTimeoutError} If the job doesn't complete within the timeout period
+     * @throws {PollingError} If the job fails or is cancelled
+     *
+     * @example
+     * ```typescript
+     * import LlamaCloud from 'llama-cloud';
+     *
+     * const client = new LlamaCloud({ apiKey: '...' });
+     *
+     * // Create a spreadsheet parsing job
+     * const job = await client.beta.sheets.create({ file_id: 'file_123' });
+     *
+     * // Wait for it to complete
+     * const completedJob = await client.beta.sheets.waitForCompletion(job.id, {
+     *   verbose: true
+     * });
+     *
+     * // Access the results
+     * for (const region of completedJob.regions ?? []) {
+     *   console.log(`Region ${region.region_id}: ${region.region_type}`);
+     * }
+     * ```
+     */
+    async waitForCompletion(spreadsheetJobID, params = {}, options) {
+        const { pollingInterval, maxInterval, timeout, backoff, verbose, ...queryParams } = params ?? {};
+        const pollingOptions = {
+            pollingInterval: pollingInterval ?? 1.0,
+            maxInterval: maxInterval ?? 5.0,
+            timeout: timeout ?? 300.0,
+            backoff: backoff ?? 'linear',
+            verbose: verbose ?? false,
+        };
+        return pollUntilComplete(async () => {
+            return this.get(spreadsheetJobID, { include_results: true, ...queryParams }, options);
+        }, (job) => job.status === 'SUCCESS' || job.status === 'PARTIAL_SUCCESS', (job) => job.status === 'ERROR' || job.status === 'CANCELLED', (job) => {
+            const errorParts = [`Job ${spreadsheetJobID} failed with status: ${job.status}`];
+            if (job.errors && job.errors.length > 0) {
+                errorParts.push(`Errors: ${job.errors.join(', ')}`);
+            }
+            return errorParts.join(' | ');
+        }, pollingOptions);
+    }
+}
+//# sourceMappingURL=sheets.mjs.map