@stack0/sdk 0.5.9 → 0.5.12

package/dist/map/index.js

@@ -0,0 +1,151 @@
+'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/map/client.ts
+var Map$ = class {
+  http;
+  constructor(config) {
+    this.http = new HttpClient(config);
+  }
+  /**
+   * Start a map job.
+   *
+   * @example
+   * ```typescript
+   * const { id } = await stack0.map.create({
+   *   url: 'https://docs.example.com',
+   *   search: 'api',
+   *   limit: 1000,
+   * });
+   * ```
+   */
+  async create(request) {
+    return this.http.post("/webdata/map", 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 query = params.toString();
+    return this.http.get(`/webdata/map/${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.limit) params.set("limit", String(request.limit));
+    if (request.cursor) params.set("cursor", request.cursor);
+    const query = params.toString();
+    return this.http.get(`/webdata/map${query ? `?${query}` : ""}`);
+  }
+  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/map/${request.id}${query ? `?${query}` : ""}`,
+      request
+    );
+  }
+  /**
+   * Create a map job and poll until it completes. Maps usually finish in
+   * seconds, so default timeout is generous.
+   */
+  async createAndWait(request, options = {}) {
+    const { pollInterval = 1e3, timeout = 12e4 } = options;
+    const { id } = await this.create(request);
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+      const result = await this.get({ id, environment: request.environment, projectId: request.projectId });
+      if (result.status === "completed" || result.status === "failed") {
+        if (result.status === "failed") throw new Error(result.error || "Map failed");
+        return result;
+      }
+      await new Promise((r) => setTimeout(r, pollInterval));
+    }
+    throw new Error("Map timed out");
+  }
+};
+
+exports.Map = Map$;
+exports.Map$ = Map$;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/map/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/http-client.ts","../../src/map/client.ts"],"names":[],"mappings":";;;AAUO,IAAM,aAAN,MAAiB;AAAA,EACd,MAAA;AAAA,EACA,OAAA;AAAA,EAER,YAAY,MAAA,EAA0B;AACpC,IAAA,IAAA,CAAK,SAAS,MAAA,CAAO,MAAA;AACrB,IAAA,IAAA,CAAK,OAAA,GAAU,OAAO,OAAA,IAAW,2BAAA;AAAA,EACnC;AAAA,EAEQ,UAAA,CAAW,qBAAqB,IAAA,EAA8B;AACpE,IAAA,MAAM,OAAA,GAAkC;AAAA,MACtC,aAAA,EAAe,CAAA,OAAA,EAAU,IAAA,CAAK,MAAM,CAAA;AAAA,KACtC;AACA,IAAA,IAAI,kBAAA,EAAoB;AACtB,MAAA,OAAA,CAAQ,cAAc,CAAA,GAAI,kBAAA;AAAA,IAC5B;AACA,IAAA,OAAO,OAAA;AAAA,EACT;AAAA,EAEA,MAAM,OAAA,CAAW,MAAA,EAAgB,IAAA,EAAc,IAAA,EAA4B;AACzE,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,IAAA,CAAK,OAAO,GAAG,IAAI,CAAA,CAAA;AAClC,IAAA,MAAM,aAAa,IAAA,KAAS,MAAA,GAAY,MAAA,GAAY,IAAA,CAAK,UAAU,IAAI,CAAA;AACvE,IAAA,MAAM,UAAU,UAAA,KAAe,MAAA;AAE/B,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,QAChC,MAAA;AAAA,QACA,OAAA,EAAS,IAAA,CAAK,UAAA,CAAW,OAAO,CAAA;AAAA,QAChC,IAAA,EAAM,UAAU,UAAA,GAAa,KAAA;AAAA,OAC9B,CAAA;AAED,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAM,IAAA,CAAK,oBAAoB,QAAQ,CAAA;AAAA,MACzC;AAEA,MAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AACjC,MAAA,OAAO,IAAA;AAAA,IACT,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,KAAA,YAAiB,KAAA,IAAS,YAAA,IAAgB,KAAA,EAAO;AACnD,QAAA,MAAM,KAAA;AAAA,MACR;AACA,MAAA,MAAM,IAAA,CAAK,WAAA,CAAY,eAAA,EAAiB,KAAK,CAAA;AAAA,IAC/C;AAAA,EACF;AAAA,EAEA,MAAc,oBAAoB,QAAA,EAAoC;AACpE,IAAA,IAAI,SAAA;AACJ,IAAA,IAAI;AACF,MAAA,SAAA,GAAa,MAAM,SAAS,IAAA,EAAK;AAAA,IACnC,CAAA,CAAA,MAAQ;AACN,MAAA,SAAA,GAAY,EAAE,OAAA,EAAS,QAAA,CAAS,UAAA,EAAW;AAAA,IAC7C;AAEA,IAAA,MAAM,KAAA,GAAQ,IAAI,KAAA,CAAM,SAAA,EAAW,WAAW,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,CAAA,CAAE,CAAA;AAKvE,IAAA,KAAA,CAAM,aAAa,QAAA,CAAS,MAAA;AAC5B,IAAA,KAAA,CAAM,IAAA,GAAQ,WAAuD,IAAA,IAAQ,EAAA;AAC7E,IAAA,KAAA,CAAM,QAAA,GAAW,SAAA;AACjB,IAAA,MAAM,KAAA;AAAA,EACR;AAAA,EAEQ,WAAA,CAAY,SAAiB,KAAA,EAAwB;AAC3D,IAAA,MAAM,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAO,CAAA;AAC/B,IAAA,KAAA,CAAM,KAAA,GAAQ,KAAA;AACd,IAAA,OAAO,KAAA;AAAA,EACT;AAAA,EAEA,MAAM,IAAO,IAAA,EAA0B;AACrC,IAAA,OAAO,IAAA,CAAK,OAAA,CAAW,KAAA,EAAO,IAAI,CAAA;AAAA,EACpC;AAAA,EAEA,MAAM,IAAA,CAAQ,IAAA,EAAc,IAAA,EAA2B;AACrD,IAAA,OAAO,IAAA,CAAK,OAAA,CAAW,MAAA,EAAQ,IAAA,EAAM,IAAI,CAAA;AAAA,EAC3C;AAAA,EAEA,MAAM,GAAA,CAAO,IAAA,EAAc,IAAA,EAA2B;AACpD,IAAA,OAAO,IAAA,CAAK,OAAA,CAAW,KAAA,EAAO,IAAA,EAAM,IAAI,CAAA;AAAA,EAC1C;AAAA,EAEA,MAAM,OAAU,IAAA,EAA0B;AACxC,IAAA,OAAO,IAAA,CAAK,OAAA,CAAW,QAAA,EAAU,IAAI,CAAA;AAAA,EACvC;AAAA,EAEA,MAAM,cAAA,CAAkB,IAAA,EAAc,IAAA,EAA2B;AAC/D,IAAA,OAAO,IAAA,CAAK,OAAA,CAAW,QAAA,EAAU,IAAA,EAAM,IAAI,CAAA;AAAA,EAC7C;AAAA,EAEA,MAAM,KAAA,CAAS,IAAA,EAAc,IAAA,EAA2B;AACtD,IAAA,OAAO,IAAA,CAAK,OAAA,CAAW,OAAA,EAAS,IAAA,EAAM,IAAI,CAAA;AAAA,EAC5C;AACF,CAAA;;;ACxFO,IAAM,OAAN,MAAW;AAAA,EACR,IAAA;AAAA,EAER,YAAY,MAAA,EAA0B;AACpC,IAAA,IAAA,CAAK,IAAA,GAAO,IAAI,UAAA,CAAW,MAAM,CAAA;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,OAAO,OAAA,EAAuD;AAClE,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,IAAA,CAAwB,cAAA,EAAgB,OAAO,CAAA;AAAA,EAClE;AAAA,EAEA,MAAM,IAAI,OAAA,EAA6C;AACrD,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AACnC,IAAA,IAAI,QAAQ,WAAA,EAAa,MAAA,CAAO,GAAA,CAAI,aAAA,EAAe,QAAQ,WAAW,CAAA;AACtE,IAAA,IAAI,QAAQ,SAAA,EAAW,MAAA,CAAO,GAAA,CAAI,WAAA,EAAa,QAAQ,SAAS,CAAA;AAChE,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAgB,CAAA,aAAA,EAAgB,OAAA,CAAQ,EAAE,CAAA,EAAG,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAE,CAAA,CAAE,CAAA;AAAA,EAC1F;AAAA,EAEA,MAAM,IAAA,CAAK,OAAA,GAA2B,EAAC,EAA8B;AACnE,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AACnC,IAAA,IAAI,QAAQ,WAAA,EAAa,MAAA,CAAO,GAAA,CAAI,aAAA,EAAe,QAAQ,WAAW,CAAA;AACtE,IAAA,IAAI,QAAQ,SAAA,EAAW,MAAA,CAAO,GAAA,CAAI,WAAA,EAAa,QAAQ,SAAS,CAAA;AAChE,IAAA,IAAI,QAAQ,MAAA,EAAQ,MAAA,CAAO,GAAA,CAAI,QAAA,EAAU,QAAQ,MAAM,CAAA;AACvD,IAAA,IAAI,OAAA,CAAQ,OAAO,MAAA,CAAO,GAAA,CAAI,SAAS,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAC,CAAA;AAC5D,IAAA,IAAI,QAAQ,MAAA,EAAQ,MAAA,CAAO,GAAA,CAAI,QAAA,EAAU,QAAQ,MAAM,CAAA;AACvD,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAsB,CAAA,YAAA,EAAe,QAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAE,CAAA,CAAE,CAAA;AAAA,EAClF;AAAA,EAEA,MAAM,OAAO,OAAA,EAAuD;AAClE,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AACnC,IAAA,IAAI,QAAQ,WAAA,EAAa,MAAA,CAAO,GAAA,CAAI,aAAA,EAAe,QAAQ,WAAW,CAAA;AACtE,IAAA,IAAI,QAAQ,SAAA,EAAW,MAAA,CAAO,GAAA,CAAI,WAAA,EAAa,QAAQ,SAAS,CAAA;AAChE,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,OAAO,KAAK,IAAA,CAAK,cAAA;AAAA,MACf,CAAA,aAAA,EAAgB,QAAQ,EAAE,CAAA,EAAG,QAAQ,CAAA,CAAA,EAAI,KAAK,KAAK,EAAE,CAAA,CAAA;AAAA,MACrD;AAAA,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,aAAA,CACJ,OAAA,EACA,OAAA,GAAuD,EAAC,EACnC;AACrB,IAAA,MAAM,EAAE,YAAA,GAAe,GAAA,EAAM,OAAA,GAAU,MAAQ,GAAI,OAAA;AACnD,IAAA,MAAM,EAAE,EAAA,EAAG,GAAI,MAAM,IAAA,CAAK,OAAO,OAAO,CAAA;AACxC,IAAA,MAAM,KAAA,GAAQ,KAAK,GAAA,EAAI;AACvB,IAAA,OAAO,IAAA,CAAK,GAAA,EAAI,GAAI,KAAA,GAAQ,OAAA,EAAS;AACnC,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,GAAA,CAAI,EAAE,EAAA,EAAI,WAAA,EAAa,OAAA,CAAQ,WAAA,EAAa,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAW,CAAA;AACpG,MAAA,IAAI,MAAA,CAAO,MAAA,KAAW,WAAA,IAAe,MAAA,CAAO,WAAW,QAAA,EAAU;AAC/D,QAAA,IAAI,MAAA,CAAO,WAAW,QAAA,EAAU,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,SAAS,YAAY,CAAA;AAC5E,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,MAAM,IAAI,OAAA,CAAQ,CAAC,MAAM,UAAA,CAAW,CAAA,EAAG,YAAY,CAAC,CAAA;AAAA,IACtD;AACA,IAAA,MAAM,IAAI,MAAM,eAAe,CAAA;AAAA,EACjC;AACF","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 Map Client\n * Fast URL discovery for a domain — returns every URL without scraping.\n */\n\nimport { HttpClient, type HttpClientConfig } from \"../lib/http-client\";\nimport type {\n  CreateMapRequest,\n  CreateMapResponse,\n  GetMapRequest,\n  ListMapsRequest,\n  ListMapsResponse,\n  WebdataMap,\n} from \"./types\";\n\nexport class Map$ {\n  private http: HttpClient;\n\n  constructor(config: HttpClientConfig) {\n    this.http = new HttpClient(config);\n  }\n\n  /**\n   * Start a map job.\n   *\n   * @example\n   * ```typescript\n   * const { id } = await stack0.map.create({\n   *   url: 'https://docs.example.com',\n   *   search: 'api',\n   *   limit: 1000,\n   * });\n   * ```\n   */\n  async create(request: CreateMapRequest): Promise<CreateMapResponse> {\n    return this.http.post<CreateMapResponse>(\"/webdata/map\", request);\n  }\n\n  async get(request: GetMapRequest): Promise<WebdataMap> {\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.get<WebdataMap>(`/webdata/map/${request.id}${query ? `?${query}` : \"\"}`);\n  }\n\n  async list(request: ListMapsRequest = {}): Promise<ListMapsResponse> {\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 query = params.toString();\n    return this.http.get<ListMapsResponse>(`/webdata/map${query ? `?${query}` : \"\"}`);\n  }\n\n  async delete(request: GetMapRequest): 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/map/${request.id}${query ? `?${query}` : \"\"}`,\n      request,\n    );\n  }\n\n  /**\n   * Create a map job and poll until it completes. Maps usually finish in\n   * seconds, so default timeout is generous.\n   */\n  async createAndWait(\n    request: CreateMapRequest,\n    options: { pollInterval?: number; timeout?: number } = {},\n  ): Promise<WebdataMap> {\n    const { pollInterval = 1000, timeout = 120_000 } = options;\n    const { id } = await this.create(request);\n    const start = Date.now();\n    while (Date.now() - start < timeout) {\n      const result = await this.get({ id, environment: request.environment, projectId: request.projectId });\n      if (result.status === \"completed\" || result.status === \"failed\") {\n        if (result.status === \"failed\") throw new Error(result.error || \"Map failed\");\n        return result;\n      }\n      await new Promise((r) => setTimeout(r, pollInterval));\n    }\n    throw new Error(\"Map timed out\");\n  }\n}\n\nexport { Map$ as Map };\n"]}

package/dist/map/index.mjs

@@ -0,0 +1,148 @@
+// 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/map/client.ts
+var Map$ = class {
+  http;
+  constructor(config) {
+    this.http = new HttpClient(config);
+  }
+  /**
+   * Start a map job.
+   *
+   * @example
+   * ```typescript
+   * const { id } = await stack0.map.create({
+   *   url: 'https://docs.example.com',
+   *   search: 'api',
+   *   limit: 1000,
+   * });
+   * ```
+   */
+  async create(request) {
+    return this.http.post("/webdata/map", 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 query = params.toString();
+    return this.http.get(`/webdata/map/${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.limit) params.set("limit", String(request.limit));
+    if (request.cursor) params.set("cursor", request.cursor);
+    const query = params.toString();
+    return this.http.get(`/webdata/map${query ? `?${query}` : ""}`);
+  }
+  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/map/${request.id}${query ? `?${query}` : ""}`,
+      request
+    );
+  }
+  /**
+   * Create a map job and poll until it completes. Maps usually finish in
+   * seconds, so default timeout is generous.
+   */
+  async createAndWait(request, options = {}) {
+    const { pollInterval = 1e3, timeout = 12e4 } = options;
+    const { id } = await this.create(request);
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+      const result = await this.get({ id, environment: request.environment, projectId: request.projectId });
+      if (result.status === "completed" || result.status === "failed") {
+        if (result.status === "failed") throw new Error(result.error || "Map failed");
+        return result;
+      }
+      await new Promise((r) => setTimeout(r, pollInterval));
+    }
+    throw new Error("Map timed out");
+  }
+};
+
+export { Map$ as Map, Map$ };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/map/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/http-client.ts","../../src/map/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 Map Client\n * Fast URL discovery for a domain — returns every URL without scraping.\n */\n\nimport { HttpClient, type HttpClientConfig } from \"../lib/http-client\";\nimport type {\n  CreateMapRequest,\n  CreateMapResponse,\n  GetMapRequest,\n  ListMapsRequest,\n  ListMapsResponse,\n  WebdataMap,\n} from \"./types\";\n\nexport class Map$ {\n  private http: HttpClient;\n\n  constructor(config: HttpClientConfig) {\n    this.http = new HttpClient(config);\n  }\n\n  /**\n   * Start a map job.\n   *\n   * @example\n   * ```typescript\n   * const { id } = await stack0.map.create({\n   *   url: 'https://docs.example.com',\n   *   search: 'api',\n   *   limit: 1000,\n   * });\n   * ```\n   */\n  async create(request: CreateMapRequest): Promise<CreateMapResponse> {\n    return this.http.post<CreateMapResponse>(\"/webdata/map\", request);\n  }\n\n  async get(request: GetMapRequest): Promise<WebdataMap> {\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.get<WebdataMap>(`/webdata/map/${request.id}${query ? `?${query}` : \"\"}`);\n  }\n\n  async list(request: ListMapsRequest = {}): Promise<ListMapsResponse> {\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 query = params.toString();\n    return this.http.get<ListMapsResponse>(`/webdata/map${query ? `?${query}` : \"\"}`);\n  }\n\n  async delete(request: GetMapRequest): 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/map/${request.id}${query ? `?${query}` : \"\"}`,\n      request,\n    );\n  }\n\n  /**\n   * Create a map job and poll until it completes. Maps usually finish in\n   * seconds, so default timeout is generous.\n   */\n  async createAndWait(\n    request: CreateMapRequest,\n    options: { pollInterval?: number; timeout?: number } = {},\n  ): Promise<WebdataMap> {\n    const { pollInterval = 1000, timeout = 120_000 } = options;\n    const { id } = await this.create(request);\n    const start = Date.now();\n    while (Date.now() - start < timeout) {\n      const result = await this.get({ id, environment: request.environment, projectId: request.projectId });\n      if (result.status === \"completed\" || result.status === \"failed\") {\n        if (result.status === \"failed\") throw new Error(result.error || \"Map failed\");\n        return result;\n      }\n      await new Promise((r) => setTimeout(r, pollInterval));\n    }\n    throw new Error(\"Map timed out\");\n  }\n}\n\nexport { Map$ as Map };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stack0/sdk",
-  "version": "0.5.9",
+  "version": "0.5.12",
   "description": "Official Stack0 SDK for Node.js",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -36,13 +36,31 @@
       "require": "./dist/webdata/index.js",
       "import": "./dist/webdata/index.mjs"
     },
+    "./crawl": {
+      "types": "./dist/crawl/index.d.ts",
+      "require": "./dist/crawl/index.js",
+      "import": "./dist/crawl/index.mjs"
+    },
+    "./map": {
+      "types": "./dist/map/index.d.ts",
+      "require": "./dist/map/index.js",
+      "import": "./dist/map/index.mjs"
+    },
+    "./documents": {
+      "types": "./dist/documents/index.d.ts",
+      "require": "./dist/documents/index.js",
+      "import": "./dist/documents/index.mjs"
+    },
     "./memory": {
       "types": "./dist/memory/index.d.ts",
       "require": "./dist/memory/index.js",
       "import": "./dist/memory/index.mjs"
     }
   },
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "keywords": [
     "stack0",
     "email",