@tabstack/sdk 1.0.5 → 2.1.0

package/resources/extract.d.mts

@@ -0,0 +1,207 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class Extract extends APIResource {
+    /**
+     * Fetches a URL and extracts structured data according to a provided JSON schema
+     *
+     * @example
+     * ```ts
+     * const response = await client.extract.json({
+     *   json_schema: {
+     *     properties: {
+     *       stories: {
+     *         items: {
+     *           properties: {
+     *             author: {
+     *               description: 'Author username',
+     *               type: 'string',
+     *             },
+     *             points: {
+     *               description: 'Story points',
+     *               type: 'number',
+     *             },
+     *             title: {
+     *               description: 'Story title',
+     *               type: 'string',
+     *             },
+     *           },
+     *           type: 'object',
+     *         },
+     *         type: 'array',
+     *       },
+     *     },
+     *     type: 'object',
+     *   },
+     *   url: 'https://news.ycombinator.com',
+     * });
+     * ```
+     */
+    json(body: ExtractJsonParams, options?: RequestOptions): APIPromise<ExtractJsonResponse>;
+    /**
+     * Fetches a URL and converts its HTML content to clean Markdown format with
+     * optional metadata extraction
+     *
+     * @example
+     * ```ts
+     * const response = await client.extract.markdown({
+     *   url: 'https://example.com/blog/article',
+     * });
+     * ```
+     */
+    markdown(body: ExtractMarkdownParams, options?: RequestOptions): APIPromise<ExtractMarkdownResponse>;
+}
+export type ExtractJsonResponse = {
+    [key: string]: unknown;
+};
+export interface ExtractMarkdownResponse {
+    /**
+     * The markdown content (includes metadata as YAML frontmatter by default)
+     */
+    content: string;
+    /**
+     * The URL that was converted to markdown
+     */
+    url: string;
+    /**
+     * Extracted metadata from the page (only included when metadata parameter is true)
+     */
+    metadata?: ExtractMarkdownResponse.Metadata;
+}
+export declare namespace ExtractMarkdownResponse {
+    /**
+     * Extracted metadata from the page (only included when metadata parameter is true)
+     */
+    interface Metadata {
+        /**
+         * Author information from HTML metadata
+         */
+        author?: string;
+        /**
+         * Document creation date (ISO 8601)
+         */
+        created_at?: string;
+        /**
+         * Creator application (e.g., "Microsoft Word")
+         */
+        creator?: string;
+        /**
+         * Page description from Open Graph or HTML
+         */
+        description?: string;
+        /**
+         * Featured image URL from Open Graph
+         */
+        image?: string;
+        /**
+         * PDF keywords as array
+         */
+        keywords?: Array<string>;
+        /**
+         * Document modification date (ISO 8601)
+         */
+        modified_at?: string;
+        /**
+         * Number of pages (PDF documents)
+         */
+        page_count?: number;
+        /**
+         * PDF version (e.g., "1.5")
+         */
+        pdf_version?: string;
+        /**
+         * PDF producer software (e.g., "Adobe PDF Library")
+         */
+        producer?: string;
+        /**
+         * Publisher information from Open Graph
+         */
+        publisher?: string;
+        /**
+         * Site name from Open Graph
+         */
+        site_name?: string;
+        /**
+         * PDF-specific metadata fields (populated for PDF documents) PDF subject or
+         * summary
+         */
+        subject?: string;
+        /**
+         * Page title from Open Graph or HTML
+         */
+        title?: string;
+        /**
+         * Content type from Open Graph (e.g., article, website)
+         */
+        type?: string;
+        /**
+         * Canonical URL from Open Graph
+         */
+        url?: string;
+    }
+}
+export interface ExtractJsonParams {
+    /**
+     * JSON schema definition that describes the structure of data to extract.
+     */
+    json_schema: unknown;
+    /**
+     * URL to fetch and extract data from
+     */
+    url: string;
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    geo_target?: ExtractJsonParams.GeoTarget;
+    /**
+     * Bypass cache and force fresh data retrieval
+     */
+    nocache?: boolean;
+}
+export declare namespace ExtractJsonParams {
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    interface GeoTarget {
+        /**
+         * Country code using ISO 3166-1 alpha-2 standard (2 letters, e.g., "US", "GB",
+         * "JP"). See: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+         */
+        country?: string;
+    }
+}
+export interface ExtractMarkdownParams {
+    /**
+     * URL to fetch and convert to markdown
+     */
+    url: string;
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    geo_target?: ExtractMarkdownParams.GeoTarget;
+    /**
+     * Include extracted metadata (Open Graph and HTML metadata) as a separate field in
+     * the response
+     */
+    metadata?: boolean;
+    /**
+     * Bypass cache and force fresh data retrieval
+     */
+    nocache?: boolean;
+}
+export declare namespace ExtractMarkdownParams {
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    interface GeoTarget {
+        /**
+         * Country code using ISO 3166-1 alpha-2 standard (2 letters, e.g., "US", "GB",
+         * "JP"). See: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+         */
+        country?: string;
+    }
+}
+export declare namespace Extract {
+    export { type ExtractJsonResponse as ExtractJsonResponse, type ExtractMarkdownResponse as ExtractMarkdownResponse, type ExtractJsonParams as ExtractJsonParams, type ExtractMarkdownParams as ExtractMarkdownParams, };
+}
+//# sourceMappingURL=extract.d.mts.map

package/resources/extract.d.mts.map

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

package/resources/extract.d.ts

@@ -0,0 +1,207 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Extract extends APIResource {
+    /**
+     * Fetches a URL and extracts structured data according to a provided JSON schema
+     *
+     * @example
+     * ```ts
+     * const response = await client.extract.json({
+     *   json_schema: {
+     *     properties: {
+     *       stories: {
+     *         items: {
+     *           properties: {
+     *             author: {
+     *               description: 'Author username',
+     *               type: 'string',
+     *             },
+     *             points: {
+     *               description: 'Story points',
+     *               type: 'number',
+     *             },
+     *             title: {
+     *               description: 'Story title',
+     *               type: 'string',
+     *             },
+     *           },
+     *           type: 'object',
+     *         },
+     *         type: 'array',
+     *       },
+     *     },
+     *     type: 'object',
+     *   },
+     *   url: 'https://news.ycombinator.com',
+     * });
+     * ```
+     */
+    json(body: ExtractJsonParams, options?: RequestOptions): APIPromise<ExtractJsonResponse>;
+    /**
+     * Fetches a URL and converts its HTML content to clean Markdown format with
+     * optional metadata extraction
+     *
+     * @example
+     * ```ts
+     * const response = await client.extract.markdown({
+     *   url: 'https://example.com/blog/article',
+     * });
+     * ```
+     */
+    markdown(body: ExtractMarkdownParams, options?: RequestOptions): APIPromise<ExtractMarkdownResponse>;
+}
+export type ExtractJsonResponse = {
+    [key: string]: unknown;
+};
+export interface ExtractMarkdownResponse {
+    /**
+     * The markdown content (includes metadata as YAML frontmatter by default)
+     */
+    content: string;
+    /**
+     * The URL that was converted to markdown
+     */
+    url: string;
+    /**
+     * Extracted metadata from the page (only included when metadata parameter is true)
+     */
+    metadata?: ExtractMarkdownResponse.Metadata;
+}
+export declare namespace ExtractMarkdownResponse {
+    /**
+     * Extracted metadata from the page (only included when metadata parameter is true)
+     */
+    interface Metadata {
+        /**
+         * Author information from HTML metadata
+         */
+        author?: string;
+        /**
+         * Document creation date (ISO 8601)
+         */
+        created_at?: string;
+        /**
+         * Creator application (e.g., "Microsoft Word")
+         */
+        creator?: string;
+        /**
+         * Page description from Open Graph or HTML
+         */
+        description?: string;
+        /**
+         * Featured image URL from Open Graph
+         */
+        image?: string;
+        /**
+         * PDF keywords as array
+         */
+        keywords?: Array<string>;
+        /**
+         * Document modification date (ISO 8601)
+         */
+        modified_at?: string;
+        /**
+         * Number of pages (PDF documents)
+         */
+        page_count?: number;
+        /**
+         * PDF version (e.g., "1.5")
+         */
+        pdf_version?: string;
+        /**
+         * PDF producer software (e.g., "Adobe PDF Library")
+         */
+        producer?: string;
+        /**
+         * Publisher information from Open Graph
+         */
+        publisher?: string;
+        /**
+         * Site name from Open Graph
+         */
+        site_name?: string;
+        /**
+         * PDF-specific metadata fields (populated for PDF documents) PDF subject or
+         * summary
+         */
+        subject?: string;
+        /**
+         * Page title from Open Graph or HTML
+         */
+        title?: string;
+        /**
+         * Content type from Open Graph (e.g., article, website)
+         */
+        type?: string;
+        /**
+         * Canonical URL from Open Graph
+         */
+        url?: string;
+    }
+}
+export interface ExtractJsonParams {
+    /**
+     * JSON schema definition that describes the structure of data to extract.
+     */
+    json_schema: unknown;
+    /**
+     * URL to fetch and extract data from
+     */
+    url: string;
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    geo_target?: ExtractJsonParams.GeoTarget;
+    /**
+     * Bypass cache and force fresh data retrieval
+     */
+    nocache?: boolean;
+}
+export declare namespace ExtractJsonParams {
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    interface GeoTarget {
+        /**
+         * Country code using ISO 3166-1 alpha-2 standard (2 letters, e.g., "US", "GB",
+         * "JP"). See: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+         */
+        country?: string;
+    }
+}
+export interface ExtractMarkdownParams {
+    /**
+     * URL to fetch and convert to markdown
+     */
+    url: string;
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    geo_target?: ExtractMarkdownParams.GeoTarget;
+    /**
+     * Include extracted metadata (Open Graph and HTML metadata) as a separate field in
+     * the response
+     */
+    metadata?: boolean;
+    /**
+     * Bypass cache and force fresh data retrieval
+     */
+    nocache?: boolean;
+}
+export declare namespace ExtractMarkdownParams {
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    interface GeoTarget {
+        /**
+         * Country code using ISO 3166-1 alpha-2 standard (2 letters, e.g., "US", "GB",
+         * "JP"). See: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+         */
+        country?: string;
+    }
+}
+export declare namespace Extract {
+    export { type ExtractJsonResponse as ExtractJsonResponse, type ExtractMarkdownResponse as ExtractMarkdownResponse, type ExtractJsonParams as ExtractJsonParams, type ExtractMarkdownParams as ExtractMarkdownParams, };
+}
+//# sourceMappingURL=extract.d.ts.map

package/resources/extract.d.ts.map

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

package/resources/extract.js

@@ -0,0 +1,61 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Extract = void 0;
+const resource_1 = require("../core/resource.js");
+class Extract extends resource_1.APIResource {
+    /**
+     * Fetches a URL and extracts structured data according to a provided JSON schema
+     *
+     * @example
+     * ```ts
+     * const response = await client.extract.json({
+     *   json_schema: {
+     *     properties: {
+     *       stories: {
+     *         items: {
+     *           properties: {
+     *             author: {
+     *               description: 'Author username',
+     *               type: 'string',
+     *             },
+     *             points: {
+     *               description: 'Story points',
+     *               type: 'number',
+     *             },
+     *             title: {
+     *               description: 'Story title',
+     *               type: 'string',
+     *             },
+     *           },
+     *           type: 'object',
+     *         },
+     *         type: 'array',
+     *       },
+     *     },
+     *     type: 'object',
+     *   },
+     *   url: 'https://news.ycombinator.com',
+     * });
+     * ```
+     */
+    json(body, options) {
+        return this._client.post('/extract/json', { body, ...options });
+    }
+    /**
+     * Fetches a URL and converts its HTML content to clean Markdown format with
+     * optional metadata extraction
+     *
+     * @example
+     * ```ts
+     * const response = await client.extract.markdown({
+     *   url: 'https://example.com/blog/article',
+     * });
+     * ```
+     */
+    markdown(body, options) {
+        return this._client.post('/extract/markdown', { body, ...options });
+    }
+}
+exports.Extract = Extract;
+//# sourceMappingURL=extract.js.map

package/resources/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../src/resources/extract.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,IAAI,CAAC,IAAuB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAA2B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF;AAtDD,0BAsDC"}

package/resources/extract.mjs

@@ -0,0 +1,57 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+export class Extract extends APIResource {
+    /**
+     * Fetches a URL and extracts structured data according to a provided JSON schema
+     *
+     * @example
+     * ```ts
+     * const response = await client.extract.json({
+     *   json_schema: {
+     *     properties: {
+     *       stories: {
+     *         items: {
+     *           properties: {
+     *             author: {
+     *               description: 'Author username',
+     *               type: 'string',
+     *             },
+     *             points: {
+     *               description: 'Story points',
+     *               type: 'number',
+     *             },
+     *             title: {
+     *               description: 'Story title',
+     *               type: 'string',
+     *             },
+     *           },
+     *           type: 'object',
+     *         },
+     *         type: 'array',
+     *       },
+     *     },
+     *     type: 'object',
+     *   },
+     *   url: 'https://news.ycombinator.com',
+     * });
+     * ```
+     */
+    json(body, options) {
+        return this._client.post('/extract/json', { body, ...options });
+    }
+    /**
+     * Fetches a URL and converts its HTML content to clean Markdown format with
+     * optional metadata extraction
+     *
+     * @example
+     * ```ts
+     * const response = await client.extract.markdown({
+     *   url: 'https://example.com/blog/article',
+     * });
+     * ```
+     */
+    markdown(body, options) {
+        return this._client.post('/extract/markdown', { body, ...options });
+    }
+}
+//# sourceMappingURL=extract.mjs.map

package/resources/extract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.mjs","sourceRoot":"","sources":["../src/resources/extract.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,IAAI,CAAC,IAAuB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAA2B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF"}

package/resources/generate.d.mts

@@ -0,0 +1,79 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class Generate extends APIResource {
+    /**
+     * Fetches URL content, extracts data, and transforms it using AI based on custom
+     * instructions. Use this to generate new content, summaries, or restructured data.
+     *
+     * @example
+     * ```ts
+     * const response = await client.generate.json({
+     *   instructions:
+     *     "For each story, categorize it (tech/business/science/other) and write a one-sentence summary explaining what it's about in simple terms.",
+     *   json_schema: {
+     *     properties: {
+     *       summaries: {
+     *         items: {
+     *           properties: {
+     *             category: {
+     *               description: 'Story category (tech/business/science/etc)',
+     *               type: 'string',
+     *             },
+     *             summary: { description: 'One-sentence summary of the story', type: 'string' },
+     *             title: { description: 'Story title', type: 'string' },
+     *           },
+     *           type: 'object',
+     *         },
+     *         type: 'array',
+     *       },
+     *     },
+     *     type: 'object',
+     *   },
+     *   url: 'https://news.ycombinator.com',
+     * });
+     * ```
+     */
+    json(body: GenerateJsonParams, options?: RequestOptions): APIPromise<GenerateJsonResponse>;
+}
+export type GenerateJsonResponse = {
+    [key: string]: unknown;
+};
+export interface GenerateJsonParams {
+    /**
+     * Instructions describing how to transform the data
+     */
+    instructions: string;
+    /**
+     * JSON schema defining the structure of the transformed output
+     */
+    json_schema: unknown;
+    /**
+     * URL to fetch content from
+     */
+    url: string;
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    geo_target?: GenerateJsonParams.GeoTarget;
+    /**
+     * Bypass cache and force fresh data retrieval
+     */
+    nocache?: boolean;
+}
+export declare namespace GenerateJsonParams {
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    interface GeoTarget {
+        /**
+         * Country code using ISO 3166-1 alpha-2 standard (2 letters, e.g., "US", "GB",
+         * "JP"). See: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+         */
+        country?: string;
+    }
+}
+export declare namespace Generate {
+    export { type GenerateJsonResponse as GenerateJsonResponse, type GenerateJsonParams as GenerateJsonParams };
+}
+//# sourceMappingURL=generate.d.mts.map

package/resources/generate.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.mts","sourceRoot":"","sources":["../src/resources/generate.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;CAG3F;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC;IAE1C;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,yBAAiB,kBAAkB,CAAC;IAClC;;OAEG;IACH,UAAiB,SAAS;QACxB;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EAAE,KAAK,oBAAoB,IAAI,oBAAoB,EAAE,KAAK,kBAAkB,IAAI,kBAAkB,EAAE,CAAC;CAC7G"}