@stack0/sdk 0.5.11 → 0.5.12

package/dist/crawl/index.mjs

@@ -0,0 +1,176 @@
+// src/lib/http-client.ts
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || "https://api.stack0.dev/v1";
+  }
+  getHeaders(includeContentType = true) {
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`
+    };
+    if (includeContentType) {
+      headers["Content-Type"] = "application/json";
+    }
+    return headers;
+  }
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const bodyString = body === void 0 ? void 0 : JSON.stringify(body);
+    const hasBody = bodyString !== void 0;
+    try {
+      const response = await fetch(url, {
+        method,
+        headers: this.getHeaders(hasBody),
+        body: hasBody ? bodyString : void 0
+      });
+      if (!response.ok) {
+        await this.handleErrorResponse(response);
+      }
+      const data = await response.json();
+      return data;
+    } catch (error) {
+      if (error instanceof Error && "statusCode" in error) {
+        throw error;
+      }
+      throw this.createError("Network error", error);
+    }
+  }
+  async handleErrorResponse(response) {
+    let errorBody;
+    try {
+      errorBody = await response.json();
+    } catch {
+      errorBody = { message: response.statusText };
+    }
+    const error = new Error(errorBody?.message || `HTTP ${response.status}`);
+    error.statusCode = response.status;
+    error.code = errorBody?.code ?? "";
+    error.response = errorBody;
+    throw error;
+  }
+  createError(message, cause) {
+    const error = new Error(message);
+    error.cause = cause;
+    return error;
+  }
+  async get(path) {
+    return this.request("GET", path);
+  }
+  async post(path, body) {
+    return this.request("POST", path, body);
+  }
+  async put(path, body) {
+    return this.request("PUT", path, body);
+  }
+  async delete(path) {
+    return this.request("DELETE", path);
+  }
+  async deleteWithBody(path, body) {
+    return this.request("DELETE", path, body);
+  }
+  async patch(path, body) {
+    return this.request("PATCH", path, body);
+  }
+};
+
+// src/crawl/client.ts
+var Crawl$ = class {
+  http;
+  constructor(config) {
+    this.http = new HttpClient(config);
+  }
+  /**
+   * Start a crawl.
+   *
+   * @example
+   * ```typescript
+   * const { id } = await stack0.crawl.start({
+   *   url: 'https://docs.example.com',
+   *   maxDepth: 3,
+   *   maxPages: 200,
+   *   formats: ['markdown', 'links'],
+   * });
+   * ```
+   */
+  async start(request) {
+    return this.http.post("/webdata/crawl", request);
+  }
+  /**
+   * Get a crawl by ID. Pass `includePages: true` to include the scraped pages.
+   */
+  async get(request) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    if (request.includePages) params.set("includePages", "true");
+    const query = params.toString();
+    return this.http.get(`/webdata/crawl/${request.id}${query ? `?${query}` : ""}`);
+  }
+  async list(request = {}) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    if (request.status) params.set("status", request.status);
+    if (request.url) params.set("url", request.url);
+    if (request.limit) params.set("limit", String(request.limit));
+    if (request.cursor) params.set("cursor", request.cursor);
+    const query = params.toString();
+    return this.http.get(`/webdata/crawl${query ? `?${query}` : ""}`);
+  }
+  async listPages(request) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    if (request.limit) params.set("limit", String(request.limit));
+    if (request.cursor) params.set("cursor", request.cursor);
+    const query = params.toString();
+    return this.http.get(
+      `/webdata/crawl/${request.crawlId}/pages${query ? `?${query}` : ""}`
+    );
+  }
+  async cancel(request) {
+    return this.http.post(`/webdata/crawl/${request.id}/cancel`, {
+      environment: request.environment,
+      projectId: request.projectId
+    });
+  }
+  async delete(request) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    const query = params.toString();
+    return this.http.deleteWithBody(
+      `/webdata/crawl/${request.id}${query ? `?${query}` : ""}`,
+      request
+    );
+  }
+  /**
+   * Start a crawl and poll until it completes. Returns the full Crawl record
+   * with pages included.
+   */
+  async startAndWait(request, options = {}) {
+    const { pollInterval = 2e3, timeout = 6e5, includePages = true } = options;
+    const { id } = await this.start(request);
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+      const crawl = await this.get({
+        id,
+        environment: request.environment,
+        projectId: request.projectId,
+        includePages
+      });
+      if (crawl.status === "completed" || crawl.status === "failed" || crawl.status === "cancelled") {
+        if (crawl.status === "failed") throw new Error(crawl.error || "Crawl failed");
+        return crawl;
+      }
+      await new Promise((r) => setTimeout(r, pollInterval));
+    }
+    throw new Error("Crawl timed out");
+  }
+};
+
+export { Crawl$ as Crawl, Crawl$ };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/crawl/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/http-client.ts","../../src/crawl/client.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * HTTP client for Stack0 API\n * Handles authentication, request/response formatting, and error handling\n */\n\nexport interface HttpClientConfig {\n  apiKey: string;\n  baseUrl?: string;\n}\n\nexport class HttpClient {\n  private apiKey: string;\n  private baseUrl: string;\n\n  constructor(config: HttpClientConfig) {\n    this.apiKey = config.apiKey;\n    this.baseUrl = config.baseUrl || \"https://api.stack0.dev/v1\";\n  }\n\n  private getHeaders(includeContentType = true): Record<string, string> {\n    const headers: Record<string, string> = {\n      Authorization: `Bearer ${this.apiKey}`,\n    };\n    if (includeContentType) {\n      headers[\"Content-Type\"] = \"application/json\";\n    }\n    return headers;\n  }\n\n  async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const bodyString = body === undefined ? undefined : JSON.stringify(body);\n    const hasBody = bodyString !== undefined;\n\n    try {\n      const response = await fetch(url, {\n        method,\n        headers: this.getHeaders(hasBody),\n        body: hasBody ? bodyString : undefined,\n      });\n\n      if (!response.ok) {\n        await this.handleErrorResponse(response);\n      }\n\n      const data = await response.json();\n      return data as T;\n    } catch (error) {\n      if (error instanceof Error && \"statusCode\" in error) {\n        throw error; // Re-throw our custom errors\n      }\n      throw this.createError(\"Network error\", error);\n    }\n  }\n\n  private async handleErrorResponse(response: Response): Promise<never> {\n    let errorBody: { message: string } | undefined;\n    try {\n      errorBody = (await response.json()) as { message: string };\n    } catch {\n      errorBody = { message: response.statusText };\n    }\n\n    const error = new Error(errorBody?.message || `HTTP ${response.status}`) as Error & {\n      statusCode: number;\n      code: string;\n      response: unknown;\n    };\n    error.statusCode = response.status;\n    error.code = (errorBody as unknown as { code: string } | undefined)?.code ?? \"\";\n    error.response = errorBody;\n    throw error;\n  }\n\n  private createError(message: string, cause?: unknown): Error {\n    const error = new Error(message) as Error & { cause: unknown };\n    error.cause = cause;\n    return error;\n  }\n\n  async get<T>(path: string): Promise<T> {\n    return this.request<T>(\"GET\", path);\n  }\n\n  async post<T>(path: string, body: unknown): Promise<T> {\n    return this.request<T>(\"POST\", path, body);\n  }\n\n  async put<T>(path: string, body: unknown): Promise<T> {\n    return this.request<T>(\"PUT\", path, body);\n  }\n\n  async delete<T>(path: string): Promise<T> {\n    return this.request<T>(\"DELETE\", path);\n  }\n\n  async deleteWithBody<T>(path: string, body: unknown): Promise<T> {\n    return this.request<T>(\"DELETE\", path, body);\n  }\n\n  async patch<T>(path: string, body: unknown): Promise<T> {\n    return this.request<T>(\"PATCH\", path, body);\n  }\n}\n","/**\n * Stack0 Crawl Client\n * Recursively crawl a website and extract content from every page.\n */\n\nimport { HttpClient, type HttpClientConfig } from \"../lib/http-client\";\nimport type {\n  CancelCrawlRequest,\n  Crawl,\n  CreateCrawlRequest,\n  CreateCrawlResponse,\n  GetCrawlRequest,\n  ListCrawlPagesRequest,\n  ListCrawlPagesResponse,\n  ListCrawlsRequest,\n  ListCrawlsResponse,\n} from \"./types\";\n\nexport class Crawl$ {\n  private http: HttpClient;\n\n  constructor(config: HttpClientConfig) {\n    this.http = new HttpClient(config);\n  }\n\n  /**\n   * Start a crawl.\n   *\n   * @example\n   * ```typescript\n   * const { id } = await stack0.crawl.start({\n   *   url: 'https://docs.example.com',\n   *   maxDepth: 3,\n   *   maxPages: 200,\n   *   formats: ['markdown', 'links'],\n   * });\n   * ```\n   */\n  async start(request: CreateCrawlRequest): Promise<CreateCrawlResponse> {\n    return this.http.post<CreateCrawlResponse>(\"/webdata/crawl\", request);\n  }\n\n  /**\n   * Get a crawl by ID. Pass `includePages: true` to include the scraped pages.\n   */\n  async get(request: GetCrawlRequest): Promise<Crawl> {\n    const params = new URLSearchParams();\n    if (request.environment) params.set(\"environment\", request.environment);\n    if (request.projectId) params.set(\"projectId\", request.projectId);\n    if (request.includePages) params.set(\"includePages\", \"true\");\n    const query = params.toString();\n    return this.http.get<Crawl>(`/webdata/crawl/${request.id}${query ? `?${query}` : \"\"}`);\n  }\n\n  async list(request: ListCrawlsRequest = {}): Promise<ListCrawlsResponse> {\n    const params = new URLSearchParams();\n    if (request.environment) params.set(\"environment\", request.environment);\n    if (request.projectId) params.set(\"projectId\", request.projectId);\n    if (request.status) params.set(\"status\", request.status);\n    if (request.url) params.set(\"url\", request.url);\n    if (request.limit) params.set(\"limit\", String(request.limit));\n    if (request.cursor) params.set(\"cursor\", request.cursor);\n    const query = params.toString();\n    return this.http.get<ListCrawlsResponse>(`/webdata/crawl${query ? `?${query}` : \"\"}`);\n  }\n\n  async listPages(request: ListCrawlPagesRequest): Promise<ListCrawlPagesResponse> {\n    const params = new URLSearchParams();\n    if (request.environment) params.set(\"environment\", request.environment);\n    if (request.projectId) params.set(\"projectId\", request.projectId);\n    if (request.limit) params.set(\"limit\", String(request.limit));\n    if (request.cursor) params.set(\"cursor\", request.cursor);\n    const query = params.toString();\n    return this.http.get<ListCrawlPagesResponse>(\n      `/webdata/crawl/${request.crawlId}/pages${query ? `?${query}` : \"\"}`,\n    );\n  }\n\n  async cancel(request: CancelCrawlRequest): Promise<{ success: boolean }> {\n    return this.http.post<{ success: boolean }>(`/webdata/crawl/${request.id}/cancel`, {\n      environment: request.environment,\n      projectId: request.projectId,\n    });\n  }\n\n  async delete(request: CancelCrawlRequest): Promise<{ success: boolean }> {\n    const params = new URLSearchParams();\n    if (request.environment) params.set(\"environment\", request.environment);\n    if (request.projectId) params.set(\"projectId\", request.projectId);\n    const query = params.toString();\n    return this.http.deleteWithBody<{ success: boolean }>(\n      `/webdata/crawl/${request.id}${query ? `?${query}` : \"\"}`,\n      request,\n    );\n  }\n\n  /**\n   * Start a crawl and poll until it completes. Returns the full Crawl record\n   * with pages included.\n   */\n  async startAndWait(\n    request: CreateCrawlRequest,\n    options: { pollInterval?: number; timeout?: number; includePages?: boolean } = {},\n  ): Promise<Crawl> {\n    const { pollInterval = 2000, timeout = 600_000, includePages = true } = options;\n    const { id } = await this.start(request);\n    const start = Date.now();\n\n    while (Date.now() - start < timeout) {\n      const crawl = await this.get({\n        id,\n        environment: request.environment,\n        projectId: request.projectId,\n        includePages,\n      });\n      if (crawl.status === \"completed\" || crawl.status === \"failed\" || crawl.status === \"cancelled\") {\n        if (crawl.status === \"failed\") throw new Error(crawl.error || \"Crawl failed\");\n        return crawl;\n      }\n      await new Promise((r) => setTimeout(r, pollInterval));\n    }\n    throw new Error(\"Crawl timed out\");\n  }\n}\n\nexport { Crawl$ as Crawl };\n"]}

package/dist/documents/index.d.mts

@@ -0,0 +1,84 @@
+import { a as HttpClientConfig } from '../http-client-Cgie_Rv6.mjs';
+import { E as Environment } from '../shared-types-CjKSP5Xc.mjs';
+
+type DocumentStatus = "pending" | "processing" | "completed" | "failed";
+interface CreateDocumentRequest {
+    environment?: Environment;
+    projectId?: string;
+    url?: string;
+    fileUrl?: string;
+    contentType?: "pdf" | "docx" | "auto";
+    webhookUrl?: string;
+    webhookSecret?: string;
+    metadata?: Record<string, unknown>;
+}
+interface CreateDocumentResponse {
+    id: string;
+    status: DocumentStatus;
+}
+interface WebdataDocument {
+    id: string;
+    organizationId: string;
+    projectId?: string;
+    environment: Environment;
+    source: "url" | "upload";
+    sourceUrl?: string;
+    fileUrl?: string;
+    contentType?: string;
+    fileSize?: number;
+    status: DocumentStatus;
+    markdown?: string;
+    pageCount?: number;
+    error?: string;
+    processingTimeMs?: number;
+    createdAt: Date | string;
+    completedAt?: Date | string;
+}
+interface GetDocumentRequest {
+    id: string;
+    environment?: Environment;
+    projectId?: string;
+}
+interface ListDocumentsRequest {
+    environment?: Environment;
+    projectId?: string;
+    status?: DocumentStatus;
+    limit?: number;
+    cursor?: string;
+}
+interface ListDocumentsResponse {
+    items: WebdataDocument[];
+    nextCursor?: string;
+}
+
+/**
+ * Stack0 Documents Client
+ * Parse PDF and DOCX documents into clean markdown.
+ */
+
+declare class Documents {
+    private http;
+    constructor(config: HttpClientConfig);
+    /**
+     * Parse a document from a URL or a previously-uploaded file URL.
+     *
+     * @example
+     * ```typescript
+     * const { id } = await stack0.documents.parse({
+     *   url: 'https://example.com/whitepaper.pdf',
+     * });
+     * ```
+     */
+    parse(request: CreateDocumentRequest): Promise<CreateDocumentResponse>;
+    get(request: GetDocumentRequest): Promise<WebdataDocument>;
+    list(request?: ListDocumentsRequest): Promise<ListDocumentsResponse>;
+    delete(request: GetDocumentRequest): Promise<{
+        success: boolean;
+    }>;
+    parseAndWait(request: CreateDocumentRequest, options?: {
+        pollInterval?: number;
+        timeout?: number;
+    }): Promise<WebdataDocument>;
+}
+
+export { type CreateDocumentRequest, type CreateDocumentResponse, type DocumentStatus, Documents, type GetDocumentRequest, type ListDocumentsRequest, type ListDocumentsResponse, type WebdataDocument };

package/dist/documents/index.d.ts

@@ -0,0 +1,84 @@
+import { a as HttpClientConfig } from '../http-client-Cgie_Rv6.js';
+import { E as Environment } from '../shared-types-CjKSP5Xc.js';
+
+type DocumentStatus = "pending" | "processing" | "completed" | "failed";
+interface CreateDocumentRequest {
+    environment?: Environment;
+    projectId?: string;
+    url?: string;
+    fileUrl?: string;
+    contentType?: "pdf" | "docx" | "auto";
+    webhookUrl?: string;
+    webhookSecret?: string;
+    metadata?: Record<string, unknown>;
+}
+interface CreateDocumentResponse {
+    id: string;
+    status: DocumentStatus;
+}
+interface WebdataDocument {
+    id: string;
+    organizationId: string;
+    projectId?: string;
+    environment: Environment;
+    source: "url" | "upload";
+    sourceUrl?: string;
+    fileUrl?: string;
+    contentType?: string;
+    fileSize?: number;
+    status: DocumentStatus;
+    markdown?: string;
+    pageCount?: number;
+    error?: string;
+    processingTimeMs?: number;
+    createdAt: Date | string;
+    completedAt?: Date | string;
+}
+interface GetDocumentRequest {
+    id: string;
+    environment?: Environment;
+    projectId?: string;
+}
+interface ListDocumentsRequest {
+    environment?: Environment;
+    projectId?: string;
+    status?: DocumentStatus;
+    limit?: number;
+    cursor?: string;
+}
+interface ListDocumentsResponse {
+    items: WebdataDocument[];
+    nextCursor?: string;
+}
+
+/**
+ * Stack0 Documents Client
+ * Parse PDF and DOCX documents into clean markdown.
+ */
+
+declare class Documents {
+    private http;
+    constructor(config: HttpClientConfig);
+    /**
+     * Parse a document from a URL or a previously-uploaded file URL.
+     *
+     * @example
+     * ```typescript
+     * const { id } = await stack0.documents.parse({
+     *   url: 'https://example.com/whitepaper.pdf',
+     * });
+     * ```
+     */
+    parse(request: CreateDocumentRequest): Promise<CreateDocumentResponse>;
+    get(request: GetDocumentRequest): Promise<WebdataDocument>;
+    list(request?: ListDocumentsRequest): Promise<ListDocumentsResponse>;
+    delete(request: GetDocumentRequest): Promise<{
+        success: boolean;
+    }>;
+    parseAndWait(request: CreateDocumentRequest, options?: {
+        pollInterval?: number;
+        timeout?: number;
+    }): Promise<WebdataDocument>;
+}
+
+export { type CreateDocumentRequest, type CreateDocumentResponse, type DocumentStatus, Documents, type GetDocumentRequest, type ListDocumentsRequest, type ListDocumentsResponse, type WebdataDocument };

package/dist/documents/index.js

@@ -0,0 +1,144 @@
+'use strict';
+
+// src/lib/http-client.ts
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || "https://api.stack0.dev/v1";
+  }
+  getHeaders(includeContentType = true) {
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`
+    };
+    if (includeContentType) {
+      headers["Content-Type"] = "application/json";
+    }
+    return headers;
+  }
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const bodyString = body === void 0 ? void 0 : JSON.stringify(body);
+    const hasBody = bodyString !== void 0;
+    try {
+      const response = await fetch(url, {
+        method,
+        headers: this.getHeaders(hasBody),
+        body: hasBody ? bodyString : void 0
+      });
+      if (!response.ok) {
+        await this.handleErrorResponse(response);
+      }
+      const data = await response.json();
+      return data;
+    } catch (error) {
+      if (error instanceof Error && "statusCode" in error) {
+        throw error;
+      }
+      throw this.createError("Network error", error);
+    }
+  }
+  async handleErrorResponse(response) {
+    let errorBody;
+    try {
+      errorBody = await response.json();
+    } catch {
+      errorBody = { message: response.statusText };
+    }
+    const error = new Error(errorBody?.message || `HTTP ${response.status}`);
+    error.statusCode = response.status;
+    error.code = errorBody?.code ?? "";
+    error.response = errorBody;
+    throw error;
+  }
+  createError(message, cause) {
+    const error = new Error(message);
+    error.cause = cause;
+    return error;
+  }
+  async get(path) {
+    return this.request("GET", path);
+  }
+  async post(path, body) {
+    return this.request("POST", path, body);
+  }
+  async put(path, body) {
+    return this.request("PUT", path, body);
+  }
+  async delete(path) {
+    return this.request("DELETE", path);
+  }
+  async deleteWithBody(path, body) {
+    return this.request("DELETE", path, body);
+  }
+  async patch(path, body) {
+    return this.request("PATCH", path, body);
+  }
+};
+
+// src/documents/client.ts
+var Documents = class {
+  http;
+  constructor(config) {
+    this.http = new HttpClient(config);
+  }
+  /**
+   * Parse a document from a URL or a previously-uploaded file URL.
+   *
+   * @example
+   * ```typescript
+   * const { id } = await stack0.documents.parse({
+   *   url: 'https://example.com/whitepaper.pdf',
+   * });
+   * ```
+   */
+  async parse(request) {
+    return this.http.post("/webdata/documents", request);
+  }
+  async get(request) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    const q = params.toString();
+    return this.http.get(`/webdata/documents/${request.id}${q ? `?${q}` : ""}`);
+  }
+  async list(request = {}) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    if (request.status) params.set("status", request.status);
+    if (request.limit) params.set("limit", String(request.limit));
+    if (request.cursor) params.set("cursor", request.cursor);
+    const q = params.toString();
+    return this.http.get(`/webdata/documents${q ? `?${q}` : ""}`);
+  }
+  async delete(request) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    const q = params.toString();
+    return this.http.deleteWithBody(
+      `/webdata/documents/${request.id}${q ? `?${q}` : ""}`,
+      request
+    );
+  }
+  async parseAndWait(request, options = {}) {
+    const { pollInterval = 2e3, timeout = 18e4 } = options;
+    const { id } = await this.parse(request);
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+      const doc = await this.get({ id, environment: request.environment, projectId: request.projectId });
+      if (doc.status === "completed" || doc.status === "failed") {
+        if (doc.status === "failed") throw new Error(doc.error || "Document parsing failed");
+        return doc;
+      }
+      await new Promise((r) => setTimeout(r, pollInterval));
+    }
+    throw new Error("Document parsing timed out");
+  }
+};
+
+exports.Documents = Documents;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/documents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/http-client.ts","../../src/documents/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * HTTP client for Stack0 API\n * Handles authentication, request/response formatting, and error handling\n */\n\nexport interface HttpClientConfig {\n  apiKey: string;\n  baseUrl?: string;\n}\n\nexport class HttpClient {\n  private apiKey: string;\n  private baseUrl: string;\n\n  constructor(config: HttpClientConfig) {\n    this.apiKey = config.apiKey;\n    this.baseUrl = config.baseUrl || \"https://api.stack0.dev/v1\";\n  }\n\n  private getHeaders(includeContentType = true): Record<string, string> {\n    const headers: Record<string, string> = {\n      Authorization: `Bearer ${this.apiKey}`,\n    };\n    if (includeContentType) {\n      headers[\"Content-Type\"] = \"application/json\";\n    }\n    return headers;\n  }\n\n  async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const bodyString = body === undefined ? undefined : JSON.stringify(body);\n    const hasBody = bodyString !== undefined;\n\n    try {\n      const response = await fetch(url, {\n        method,\n        headers: this.getHeaders(hasBody),\n        body: hasBody ? bodyString : undefined,\n      });\n\n      if (!response.ok) {\n        await this.handleErrorResponse(response);\n      }\n\n      const data = await response.json();\n      return data as T;\n    } catch (error) {\n      if (error instanceof Error && \"statusCode\" in error) {\n        throw error; // Re-throw our custom errors\n      }\n      throw this.createError(\"Network error\", error);\n    }\n  }\n\n  private async handleErrorResponse(response: Response): Promise<never> {\n    let errorBody: { message: string } | undefined;\n    try {\n      errorBody = (await response.json()) as { message: string };\n    } catch {\n      errorBody = { message: response.statusText };\n    }\n\n    const error = new Error(errorBody?.message || `HTTP ${response.status}`) as Error & {\n      statusCode: number;\n      code: string;\n      response: unknown;\n    };\n    error.statusCode = response.status;\n    error.code = (errorBody as unknown as { code: string } | undefined)?.code ?? \"\";\n    error.response = errorBody;\n    throw error;\n  }\n\n  private createError(message: string, cause?: unknown): Error {\n    const error = new Error(message) as Error & { cause: unknown };\n    error.cause = cause;\n    return error;\n  }\n\n  async get<T>(path: string): Promise<T> {\n    return this.request<T>(\"GET\", path);\n  }\n\n  async post<T>(path: string, body: unknown): Promise<T> {\n    return this.request<T>(\"POST\", path, body);\n  }\n\n  async put<T>(path: string, body: unknown): Promise<T> {\n    return this.request<T>(\"PUT\", path, body);\n  }\n\n  async delete<T>(path: string): Promise<T> {\n    return this.request<T>(\"DELETE\", path);\n  }\n\n  async deleteWithBody<T>(path: string, body: unknown): Promise<T> {\n    return this.request<T>(\"DELETE\", path, body);\n  }\n\n  async patch<T>(path: string, body: unknown): Promise<T> {\n    return this.request<T>(\"PATCH\", path, body);\n  }\n}\n","/**\n * Stack0 Documents Client\n * Parse PDF and DOCX documents into clean markdown.\n */\n\nimport { HttpClient, type HttpClientConfig } from \"../lib/http-client\";\nimport type {\n  CreateDocumentRequest,\n  CreateDocumentResponse,\n  GetDocumentRequest,\n  ListDocumentsRequest,\n  ListDocumentsResponse,\n  WebdataDocument,\n} from \"./types\";\n\nexport class Documents {\n  private http: HttpClient;\n\n  constructor(config: HttpClientConfig) {\n    this.http = new HttpClient(config);\n  }\n\n  /**\n   * Parse a document from a URL or a previously-uploaded file URL.\n   *\n   * @example\n   * ```typescript\n   * const { id } = await stack0.documents.parse({\n   *   url: 'https://example.com/whitepaper.pdf',\n   * });\n   * ```\n   */\n  async parse(request: CreateDocumentRequest): Promise<CreateDocumentResponse> {\n    return this.http.post<CreateDocumentResponse>(\"/webdata/documents\", request);\n  }\n\n  async get(request: GetDocumentRequest): Promise<WebdataDocument> {\n    const params = new URLSearchParams();\n    if (request.environment) params.set(\"environment\", request.environment);\n    if (request.projectId) params.set(\"projectId\", request.projectId);\n    const q = params.toString();\n    return this.http.get<WebdataDocument>(`/webdata/documents/${request.id}${q ? `?${q}` : \"\"}`);\n  }\n\n  async list(request: ListDocumentsRequest = {}): Promise<ListDocumentsResponse> {\n    const params = new URLSearchParams();\n    if (request.environment) params.set(\"environment\", request.environment);\n    if (request.projectId) params.set(\"projectId\", request.projectId);\n    if (request.status) params.set(\"status\", request.status);\n    if (request.limit) params.set(\"limit\", String(request.limit));\n    if (request.cursor) params.set(\"cursor\", request.cursor);\n    const q = params.toString();\n    return this.http.get<ListDocumentsResponse>(`/webdata/documents${q ? `?${q}` : \"\"}`);\n  }\n\n  async delete(request: GetDocumentRequest): Promise<{ success: boolean }> {\n    const params = new URLSearchParams();\n    if (request.environment) params.set(\"environment\", request.environment);\n    if (request.projectId) params.set(\"projectId\", request.projectId);\n    const q = params.toString();\n    return this.http.deleteWithBody<{ success: boolean }>(\n      `/webdata/documents/${request.id}${q ? `?${q}` : \"\"}`,\n      request,\n    );\n  }\n\n  async parseAndWait(\n    request: CreateDocumentRequest,\n    options: { pollInterval?: number; timeout?: number } = {},\n  ): Promise<WebdataDocument> {\n    const { pollInterval = 2000, timeout = 180_000 } = options;\n    const { id } = await this.parse(request);\n    const start = Date.now();\n    while (Date.now() - start < timeout) {\n      const doc = await this.get({ id, environment: request.environment, projectId: request.projectId });\n      if (doc.status === \"completed\" || doc.status === \"failed\") {\n        if (doc.status === \"failed\") throw new Error(doc.error || \"Document parsing failed\");\n        return doc;\n      }\n      await new Promise((r) => setTimeout(r, pollInterval));\n    }\n    throw new Error(\"Document parsing timed out\");\n  }\n}\n"]}