@mixedbread/sdk 0.1.0-alpha.8

package/resources/parsing/jobs.d.ts

@@ -0,0 +1,278 @@
+import { APIResource } from "../../resource.js";
+import * as Core from "../../core.js";
+import { LimitOffset, type LimitOffsetParams } from "../../pagination.js";
+import { Uploadable } from "../../uploads.js";
+export declare class Jobs extends APIResource {
+    /**
+     * Start a parse job for the provided file.
+     *
+     * Args: params: The parameters for creating a parse job.
+     *
+     * Returns: The created parsing job.
+     */
+    create(body: JobCreateParams, options?: Core.RequestOptions): Core.APIPromise<ParsingJob>;
+    /**
+     * Get detailed information about a specific parse job.
+     *
+     * Args: job_id: The ID of the parse job.
+     *
+     * Returns: Detailed information about the parse job.
+     */
+    retrieve(jobId: string, options?: Core.RequestOptions): Core.APIPromise<ParsingJob>;
+    /**
+     * List parsing jobs with pagination.
+     *
+     * Args: limit: The number of items to return. offset: The number of items to skip.
+     *
+     * Returns: List of parsing jobs with pagination.
+     */
+    list(query?: JobListParams, options?: Core.RequestOptions): Core.PagePromise<JobListResponsesLimitOffset, JobListResponse>;
+    list(options?: Core.RequestOptions): Core.PagePromise<JobListResponsesLimitOffset, JobListResponse>;
+    /**
+     * Delete a specific parse job.
+     *
+     * Args: job_id: The ID of the parse job to delete.
+     *
+     * Returns: The deleted parsing job.
+     */
+    delete(jobId: string, options?: Core.RequestOptions): Core.APIPromise<JobDeleteResponse>;
+    /**
+     * Cancel a specific parse job.
+     *
+     * Args: job_id: The ID of the parse job to cancel.
+     *
+     * Returns: The cancelled parsing job.
+     */
+    cancel(jobId: string, options?: Core.RequestOptions): Core.APIPromise<ParsingJob>;
+    /**
+     * Poll for a job's status until it reaches a terminal state.
+     *
+     * @param jobId - The ID of the job to poll
+     * @param pollIntervalMs - The interval between polls in milliseconds (default: 500)
+     * @param pollTimeoutMs - The maximum time to poll for in milliseconds (default: no timeout)
+     * @param options - Additional request options
+     * @returns The job object once it reaches a terminal state
+     */
+    poll(jobId: string, pollIntervalMs?: number, pollTimeoutMs?: number, options?: Core.RequestOptions): Promise<ParsingJob>;
+    /**
+     * Create a parsing job and wait for it to complete.
+     *
+     * @param body - Parameters for creating a parse job
+     * @param pollIntervalMs - The interval between polls in milliseconds (default: 500)
+     * @param pollTimeoutMs - The maximum time to poll for in milliseconds (default: no timeout)
+     * @param options - Additional request options
+     * @returns The job object once it reaches a terminal state
+     */
+    createAndPoll(body: JobCreateParams, pollIntervalMs?: number, pollTimeoutMs?: number, options?: Core.RequestOptions): Promise<ParsingJob>;
+    /**
+     * Upload a file to the files API and then create a parsing job for it.
+     * Note the job will be asynchronously processed.
+     *
+     * @param file - The file to upload
+     * @param body - Additional parameters for creating a parse job
+     * @param options - Additional request options
+     * @returns The created parsing job
+     */
+    upload(file: Uploadable, body?: Omit<JobCreateParams, 'file_id'>, options?: Core.RequestOptions): Promise<ParsingJob>;
+    /**
+     * Upload a file and create a parsing job, then poll until processing is complete.
+     *
+     * @param file - The file to upload
+     * @param body - Additional parameters for creating a parse job
+     * @param pollIntervalMs - The interval between polls in milliseconds (default: 500)
+     * @param pollTimeoutMs - The maximum time to poll for in milliseconds (default: no timeout)
+     * @param options - Additional request options
+     * @returns The job object once it reaches a terminal state
+     */
+    uploadAndPoll(file: Uploadable, body?: Omit<JobCreateParams, 'file_id'>, pollIntervalMs?: number, pollTimeoutMs?: number, options?: Core.RequestOptions): Promise<ParsingJob>;
+}
+export declare class JobListResponsesLimitOffset extends LimitOffset<JobListResponse> {
+}
+/**
+ * A job for parsing documents with its current state and result.
+ */
+export interface ParsingJob {
+    /**
+     * The ID of the job
+     */
+    id: string;
+    /**
+     * The status of the job
+     */
+    status: 'pending' | 'in_progress' | 'cancelled' | 'completed' | 'failed';
+    /**
+     * The error of the job
+     */
+    error?: unknown;
+    /**
+     * Result of document parsing operation.
+     */
+    result?: ParsingJob.Result | null;
+    /**
+     * The started time of the job
+     */
+    started_at?: string | null;
+    /**
+     * The finished time of the job
+     */
+    finished_at?: string | null;
+    /**
+     * The creation time of the job
+     */
+    created_at?: string;
+    /**
+     * The updated time of the job
+     */
+    updated_at?: string | null;
+    /**
+     * The type of the object
+     */
+    object?: 'parsing_job';
+}
+export declare namespace ParsingJob {
+    /**
+     * Result of document parsing operation.
+     */
+    interface Result {
+        /**
+         * The strategy used for chunking the document
+         */
+        chunking_strategy: 'page';
+        /**
+         * The format of the returned content
+         */
+        return_format: 'html' | 'markdown' | 'plain';
+        /**
+         * The types of elements extracted
+         */
+        element_types: Array<'caption' | 'footnote' | 'formula' | 'list-item' | 'page-footer' | 'page-header' | 'picture' | 'section-header' | 'table' | 'text' | 'title'>;
+        /**
+         * List of extracted chunks from the document
+         */
+        chunks: Array<Result.Chunk>;
+    }
+    namespace Result {
+        /**
+         * A chunk of text extracted from a document page.
+         */
+        interface Chunk {
+            /**
+             * The full content of the chunk
+             */
+            content: string;
+            /**
+             * The content to be used for embedding
+             */
+            content_to_embed: string;
+            /**
+             * List of elements contained in this chunk
+             */
+            elements: Array<Chunk.Element>;
+        }
+        namespace Chunk {
+            /**
+             * Represents an extracted element from a document with its content and metadata.
+             */
+            interface Element {
+                /**
+                 * The type of the extracted element
+                 */
+                type: 'caption' | 'footnote' | 'formula' | 'list-item' | 'page-footer' | 'page-header' | 'picture' | 'section-header' | 'table' | 'text' | 'title';
+                /**
+                 * The confidence score of the extraction
+                 */
+                confidence: number;
+                /**
+                 * The bounding box coordinates [x1, y1, x2, y2]
+                 */
+                bbox: Array<unknown>;
+                /**
+                 * The page number where the element was found
+                 */
+                page: number;
+                /**
+                 * The full content of the extracted element
+                 */
+                content: string;
+                /**
+                 * A brief summary of the element's content
+                 */
+                summary?: string | null;
+            }
+        }
+    }
+}
+/**
+ * A parsing job item for list responses, omitting result and error fields.
+ */
+export interface JobListResponse {
+    /**
+     * The ID of the job
+     */
+    id: string;
+    /**
+     * The status of the job
+     */
+    status: 'pending' | 'in_progress' | 'cancelled' | 'completed' | 'failed';
+    /**
+     * The started time of the job
+     */
+    started_at?: string | null;
+    /**
+     * The finished time of the job
+     */
+    finished_at?: string | null;
+    /**
+     * The creation time of the job
+     */
+    created_at?: string;
+    /**
+     * The updated time of the job
+     */
+    updated_at?: string | null;
+    /**
+     * The type of the object
+     */
+    object?: 'parsing_job';
+}
+/**
+ * A deleted parsing job.
+ */
+export interface JobDeleteResponse {
+    /**
+     * The ID of the deleted job
+     */
+    id: string;
+    /**
+     * Whether the job was deleted
+     */
+    deleted?: boolean;
+    /**
+     * The type of the object
+     */
+    object?: 'parsing_job';
+}
+export interface JobCreateParams {
+    /**
+     * The ID of the file to parse
+     */
+    file_id: string;
+    /**
+     * The elements to extract from the document
+     */
+    element_types?: Array<'caption' | 'footnote' | 'formula' | 'list-item' | 'page-footer' | 'page-header' | 'picture' | 'section-header' | 'table' | 'text' | 'title'> | null;
+    /**
+     * The strategy to use for chunking the content
+     */
+    chunking_strategy?: 'page';
+    /**
+     * The format of the returned content
+     */
+    return_format?: 'html' | 'markdown' | 'plain';
+}
+export interface JobListParams extends LimitOffsetParams {
+}
+export declare namespace Jobs {
+    export { type ParsingJob as ParsingJob, type JobListResponse as JobListResponse, type JobDeleteResponse as JobDeleteResponse, JobListResponsesLimitOffset as JobListResponsesLimitOffset, type JobCreateParams as JobCreateParams, type JobListParams as JobListParams, };
+}
+//# sourceMappingURL=jobs.d.ts.map

package/resources/parsing/jobs.d.ts.map

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

package/resources/parsing/jobs.js

@@ -0,0 +1,147 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobListResponsesLimitOffset = exports.Jobs = void 0;
+const resource_1 = require("../../resource.js");
+const core_1 = require("../../core.js");
+const pagination_1 = require("../../pagination.js");
+const polling = __importStar(require("../../lib/polling.js"));
+class Jobs extends resource_1.APIResource {
+    /**
+     * Start a parse job for the provided file.
+     *
+     * Args: params: The parameters for creating a parse job.
+     *
+     * Returns: The created parsing job.
+     */
+    create(body, options) {
+        return this._client.post('/v1/parsing/jobs', { body, ...options });
+    }
+    /**
+     * Get detailed information about a specific parse job.
+     *
+     * Args: job_id: The ID of the parse job.
+     *
+     * Returns: Detailed information about the parse job.
+     */
+    retrieve(jobId, options) {
+        return this._client.get(`/v1/parsing/jobs/${jobId}`, options);
+    }
+    list(query = {}, options) {
+        if ((0, core_1.isRequestOptions)(query)) {
+            return this.list({}, query);
+        }
+        return this._client.getAPIList('/v1/parsing/jobs', JobListResponsesLimitOffset, { query, ...options });
+    }
+    /**
+     * Delete a specific parse job.
+     *
+     * Args: job_id: The ID of the parse job to delete.
+     *
+     * Returns: The deleted parsing job.
+     */
+    delete(jobId, options) {
+        return this._client.delete(`/v1/parsing/jobs/${jobId}`, options);
+    }
+    /**
+     * Cancel a specific parse job.
+     *
+     * Args: job_id: The ID of the parse job to cancel.
+     *
+     * Returns: The cancelled parsing job.
+     */
+    cancel(jobId, options) {
+        return this._client.patch(`/v1/parsing/jobs/${jobId}`, options);
+    }
+    /**
+     * Poll for a job's status until it reaches a terminal state.
+     *
+     * @param jobId - The ID of the job to poll
+     * @param pollIntervalMs - The interval between polls in milliseconds (default: 500)
+     * @param pollTimeoutMs - The maximum time to poll for in milliseconds (default: no timeout)
+     * @param options - Additional request options
+     * @returns The job object once it reaches a terminal state
+     */
+    async poll(jobId, pollIntervalMs, pollTimeoutMs, options) {
+        const pollingIntervalMs = pollIntervalMs || 500;
+        const pollingTimeoutMs = pollTimeoutMs;
+        return polling.poll({
+            fn: () => this.retrieve(jobId, options),
+            condition: (result) => result.status === 'completed' || result.status === 'failed' || result.status === 'cancelled',
+            intervalSeconds: pollingIntervalMs / 1000,
+            ...(pollingTimeoutMs && { timeoutSeconds: pollingTimeoutMs / 1000 }),
+        });
+    }
+    /**
+     * Create a parsing job and wait for it to complete.
+     *
+     * @param body - Parameters for creating a parse job
+     * @param pollIntervalMs - The interval between polls in milliseconds (default: 500)
+     * @param pollTimeoutMs - The maximum time to poll for in milliseconds (default: no timeout)
+     * @param options - Additional request options
+     * @returns The job object once it reaches a terminal state
+     */
+    async createAndPoll(body, pollIntervalMs, pollTimeoutMs, options) {
+        const job = await this.create(body, options);
+        return this.poll(job.id, pollIntervalMs, pollTimeoutMs, options);
+    }
+    /**
+     * Upload a file to the files API and then create a parsing job for it.
+     * Note the job will be asynchronously processed.
+     *
+     * @param file - The file to upload
+     * @param body - Additional parameters for creating a parse job
+     * @param options - Additional request options
+     * @returns The created parsing job
+     */
+    async upload(file, body, options) {
+        const fileUploadResponse = await this._client.files.create({ file }, options);
+        return this.create({
+            file_id: fileUploadResponse.id,
+            ...body,
+        }, options);
+    }
+    /**
+     * Upload a file and create a parsing job, then poll until processing is complete.
+     *
+     * @param file - The file to upload
+     * @param body - Additional parameters for creating a parse job
+     * @param pollIntervalMs - The interval between polls in milliseconds (default: 500)
+     * @param pollTimeoutMs - The maximum time to poll for in milliseconds (default: no timeout)
+     * @param options - Additional request options
+     * @returns The job object once it reaches a terminal state
+     */
+    async uploadAndPoll(file, body, pollIntervalMs, pollTimeoutMs, options) {
+        const job = await this.upload(file, body, options);
+        return this.poll(job.id, pollIntervalMs, pollTimeoutMs, options);
+    }
+}
+exports.Jobs = Jobs;
+class JobListResponsesLimitOffset extends pagination_1.LimitOffset {
+}
+exports.JobListResponsesLimitOffset = JobListResponsesLimitOffset;
+Jobs.JobListResponsesLimitOffset = JobListResponsesLimitOffset;
+//# sourceMappingURL=jobs.js.map

package/resources/parsing/jobs.js.map

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

package/resources/parsing/jobs.mjs

@@ -0,0 +1,119 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../resource.mjs";
+import { isRequestOptions } from "../../core.mjs";
+import { LimitOffset } from "../../pagination.mjs";
+import * as polling from "../../lib/polling.mjs";
+export class Jobs extends APIResource {
+    /**
+     * Start a parse job for the provided file.
+     *
+     * Args: params: The parameters for creating a parse job.
+     *
+     * Returns: The created parsing job.
+     */
+    create(body, options) {
+        return this._client.post('/v1/parsing/jobs', { body, ...options });
+    }
+    /**
+     * Get detailed information about a specific parse job.
+     *
+     * Args: job_id: The ID of the parse job.
+     *
+     * Returns: Detailed information about the parse job.
+     */
+    retrieve(jobId, options) {
+        return this._client.get(`/v1/parsing/jobs/${jobId}`, options);
+    }
+    list(query = {}, options) {
+        if (isRequestOptions(query)) {
+            return this.list({}, query);
+        }
+        return this._client.getAPIList('/v1/parsing/jobs', JobListResponsesLimitOffset, { query, ...options });
+    }
+    /**
+     * Delete a specific parse job.
+     *
+     * Args: job_id: The ID of the parse job to delete.
+     *
+     * Returns: The deleted parsing job.
+     */
+    delete(jobId, options) {
+        return this._client.delete(`/v1/parsing/jobs/${jobId}`, options);
+    }
+    /**
+     * Cancel a specific parse job.
+     *
+     * Args: job_id: The ID of the parse job to cancel.
+     *
+     * Returns: The cancelled parsing job.
+     */
+    cancel(jobId, options) {
+        return this._client.patch(`/v1/parsing/jobs/${jobId}`, options);
+    }
+    /**
+     * Poll for a job's status until it reaches a terminal state.
+     *
+     * @param jobId - The ID of the job to poll
+     * @param pollIntervalMs - The interval between polls in milliseconds (default: 500)
+     * @param pollTimeoutMs - The maximum time to poll for in milliseconds (default: no timeout)
+     * @param options - Additional request options
+     * @returns The job object once it reaches a terminal state
+     */
+    async poll(jobId, pollIntervalMs, pollTimeoutMs, options) {
+        const pollingIntervalMs = pollIntervalMs || 500;
+        const pollingTimeoutMs = pollTimeoutMs;
+        return polling.poll({
+            fn: () => this.retrieve(jobId, options),
+            condition: (result) => result.status === 'completed' || result.status === 'failed' || result.status === 'cancelled',
+            intervalSeconds: pollingIntervalMs / 1000,
+            ...(pollingTimeoutMs && { timeoutSeconds: pollingTimeoutMs / 1000 }),
+        });
+    }
+    /**
+     * Create a parsing job and wait for it to complete.
+     *
+     * @param body - Parameters for creating a parse job
+     * @param pollIntervalMs - The interval between polls in milliseconds (default: 500)
+     * @param pollTimeoutMs - The maximum time to poll for in milliseconds (default: no timeout)
+     * @param options - Additional request options
+     * @returns The job object once it reaches a terminal state
+     */
+    async createAndPoll(body, pollIntervalMs, pollTimeoutMs, options) {
+        const job = await this.create(body, options);
+        return this.poll(job.id, pollIntervalMs, pollTimeoutMs, options);
+    }
+    /**
+     * Upload a file to the files API and then create a parsing job for it.
+     * Note the job will be asynchronously processed.
+     *
+     * @param file - The file to upload
+     * @param body - Additional parameters for creating a parse job
+     * @param options - Additional request options
+     * @returns The created parsing job
+     */
+    async upload(file, body, options) {
+        const fileUploadResponse = await this._client.files.create({ file }, options);
+        return this.create({
+            file_id: fileUploadResponse.id,
+            ...body,
+        }, options);
+    }
+    /**
+     * Upload a file and create a parsing job, then poll until processing is complete.
+     *
+     * @param file - The file to upload
+     * @param body - Additional parameters for creating a parse job
+     * @param pollIntervalMs - The interval between polls in milliseconds (default: 500)
+     * @param pollTimeoutMs - The maximum time to poll for in milliseconds (default: no timeout)
+     * @param options - Additional request options
+     * @returns The job object once it reaches a terminal state
+     */
+    async uploadAndPoll(file, body, pollIntervalMs, pollTimeoutMs, options) {
+        const job = await this.upload(file, body, options);
+        return this.poll(job.id, pollIntervalMs, pollTimeoutMs, options);
+    }
+}
+export class JobListResponsesLimitOffset extends LimitOffset {
+}
+Jobs.JobListResponsesLimitOffset = JobListResponsesLimitOffset;
+//# sourceMappingURL=jobs.mjs.map

package/resources/parsing/jobs.mjs.map

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

package/resources/parsing/parsing.d.ts

@@ -0,0 +1,10 @@
+import { APIResource } from "../../resource.js";
+import * as JobsAPI from "./jobs.js";
+import { JobCreateParams, JobDeleteResponse, JobListParams, JobListResponse, JobListResponsesLimitOffset, Jobs, ParsingJob } from "./jobs.js";
+export declare class Parsing extends APIResource {
+    jobs: JobsAPI.Jobs;
+}
+export declare namespace Parsing {
+    export { Jobs as Jobs, type ParsingJob as ParsingJob, type JobListResponse as JobListResponse, type JobDeleteResponse as JobDeleteResponse, JobListResponsesLimitOffset as JobListResponsesLimitOffset, type JobCreateParams as JobCreateParams, type JobListParams as JobListParams, };
+}
+//# sourceMappingURL=parsing.d.ts.map

package/resources/parsing/parsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.d.ts","sourceRoot":"","sources":["../../src/resources/parsing/parsing.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,OAAO,MAAM,QAAQ,CAAC;AAClC,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,2BAA2B,EAC3B,IAAI,EACJ,UAAU,EACX,MAAM,QAAQ,CAAC;AAEhB,qBAAa,OAAQ,SAAQ,WAAW;IACtC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAkC;CACrD;AAKD,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,IAAI,IAAI,IAAI,EACZ,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,2BAA2B,IAAI,2BAA2B,EAC1D,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,aAAa,IAAI,aAAa,GACpC,CAAC;CACH"}

package/resources/parsing/parsing.js

@@ -0,0 +1,40 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Parsing = void 0;
+const resource_1 = require("../../resource.js");
+const JobsAPI = __importStar(require("./jobs.js"));
+const jobs_1 = require("./jobs.js");
+class Parsing extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.jobs = new JobsAPI.Jobs(this._client);
+    }
+}
+exports.Parsing = Parsing;
+Parsing.Jobs = jobs_1.Jobs;
+Parsing.JobListResponsesLimitOffset = jobs_1.JobListResponsesLimitOffset;
+//# sourceMappingURL=parsing.js.map

package/resources/parsing/parsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.js","sourceRoot":"","sources":["../../src/resources/parsing/parsing.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtF,gDAA6C;AAC7C,mDAAkC;AAClC,oCAQgB;AAEhB,MAAa,OAAQ,SAAQ,sBAAW;IAAxC;;QACE,SAAI,GAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;CAAA;AAFD,0BAEC;AAED,OAAO,CAAC,IAAI,GAAG,WAAI,CAAC;AACpB,OAAO,CAAC,2BAA2B,GAAG,kCAA2B,CAAC"}

package/resources/parsing/parsing.mjs

@@ -0,0 +1,13 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../resource.mjs";
+import * as JobsAPI from "./jobs.mjs";
+import { JobListResponsesLimitOffset, Jobs, } from "./jobs.mjs";
+export class Parsing extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.jobs = new JobsAPI.Jobs(this._client);
+    }
+}
+Parsing.Jobs = Jobs;
+Parsing.JobListResponsesLimitOffset = JobListResponsesLimitOffset;
+//# sourceMappingURL=parsing.mjs.map

package/resources/parsing/parsing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.mjs","sourceRoot":"","sources":["../../src/resources/parsing/parsing.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,OAAO;OACZ,EAKL,2BAA2B,EAC3B,IAAI,GAEL;AAED,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAAxC;;QACE,SAAI,GAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;CAAA;AAED,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;AACpB,OAAO,CAAC,2BAA2B,GAAG,2BAA2B,CAAC"}