@stack0/sdk 0.2.8 → 0.2.9

package/dist/screenshots/index.mjs

@@ -0,0 +1,421 @@
+// 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() {
+    return {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${this.apiKey}`
+    };
+  }
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    try {
+      const response = await fetch(url, {
+        method,
+        headers: this.getHeaders(),
+        body: body ? JSON.stringify(body) : 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 patch(path, body) {
+    return this.request("PATCH", path, body);
+  }
+};
+
+// src/screenshots/client.ts
+var Screenshots = class {
+  http;
+  constructor(config) {
+    this.http = new HttpClient(config);
+  }
+  // ==========================================================================
+  // SCREENSHOTS
+  // ==========================================================================
+  /**
+   * Capture a screenshot of a URL
+   *
+   * @example
+   * ```typescript
+   * const { id, status } = await screenshots.capture({
+   *   url: 'https://example.com',
+   *   format: 'png',
+   *   fullPage: true,
+   *   deviceType: 'desktop',
+   * });
+   *
+   * // Poll for completion
+   * const screenshot = await screenshots.get({ id });
+   * console.log(screenshot.imageUrl);
+   * ```
+   */
+  async capture(request) {
+    return this.http.post("/webdata/screenshots", request);
+  }
+  /**
+   * Get a screenshot by ID
+   *
+   * @example
+   * ```typescript
+   * const screenshot = await screenshots.get({ id: 'screenshot-id' });
+   * if (screenshot.status === 'completed') {
+   *   console.log(screenshot.imageUrl);
+   * }
+   * ```
+   */
+  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();
+    const path = `/webdata/screenshots/${request.id}${query ? `?${query}` : ""}`;
+    const response = await this.http.get(path);
+    return this.convertDates(response);
+  }
+  /**
+   * List screenshots with pagination and filters
+   *
+   * @example
+   * ```typescript
+   * const { items, nextCursor } = await screenshots.list({
+   *   status: 'completed',
+   *   limit: 20,
+   * });
+   * ```
+   */
+  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", request.limit.toString());
+    if (request.cursor) params.set("cursor", request.cursor);
+    const query = params.toString();
+    const response = await this.http.get(
+      `/webdata/screenshots${query ? `?${query}` : ""}`
+    );
+    return {
+      ...response,
+      items: response.items.map((item) => this.convertDates(item))
+    };
+  }
+  /**
+   * Delete a screenshot
+   *
+   * @example
+   * ```typescript
+   * await screenshots.delete({ id: 'screenshot-id' });
+   * ```
+   */
+  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.delete(
+      `/webdata/screenshots/${request.id}${query ? `?${query}` : ""}`
+    );
+  }
+  /**
+   * Capture a screenshot and wait for completion
+   *
+   * @example
+   * ```typescript
+   * const screenshot = await screenshots.captureAndWait({
+   *   url: 'https://example.com',
+   *   format: 'png',
+   * });
+   * console.log(screenshot.imageUrl);
+   * ```
+   */
+  async captureAndWait(request, options = {}) {
+    const { pollInterval = 1e3, timeout = 6e4 } = options;
+    const startTime = Date.now();
+    const { id } = await this.capture(request);
+    while (Date.now() - startTime < timeout) {
+      const screenshot = await this.get({
+        id,
+        environment: request.environment,
+        projectId: request.projectId
+      });
+      if (screenshot.status === "completed" || screenshot.status === "failed") {
+        if (screenshot.status === "failed") {
+          throw new Error(screenshot.error || "Screenshot failed");
+        }
+        return screenshot;
+      }
+      await new Promise((resolve) => setTimeout(resolve, pollInterval));
+    }
+    throw new Error("Screenshot timed out");
+  }
+  // ==========================================================================
+  // BATCH JOBS
+  // ==========================================================================
+  /**
+   * Create a batch screenshot job for multiple URLs
+   *
+   * @example
+   * ```typescript
+   * const { id, totalUrls } = await screenshots.batch({
+   *   urls: [
+   *     'https://example.com',
+   *     'https://example.org',
+   *   ],
+   *   config: { format: 'png', fullPage: true },
+   * });
+   *
+   * // Poll for completion
+   * const job = await screenshots.getBatchJob({ id });
+   * console.log(`Progress: ${job.processedUrls}/${job.totalUrls}`);
+   * ```
+   */
+  async batch(request) {
+    return this.http.post("/webdata/batch/screenshots", request);
+  }
+  /**
+   * Get a batch job by ID
+   */
+  async getBatchJob(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();
+    const path = `/webdata/batch/${request.id}${query ? `?${query}` : ""}`;
+    const response = await this.http.get(path);
+    return this.convertBatchJobDates(response);
+  }
+  /**
+   * List batch jobs with pagination and filters
+   */
+  async listBatchJobs(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);
+    params.set("type", "screenshot");
+    if (request.limit) params.set("limit", request.limit.toString());
+    if (request.cursor) params.set("cursor", request.cursor);
+    const query = params.toString();
+    const response = await this.http.get(
+      `/webdata/batch${query ? `?${query}` : ""}`
+    );
+    return {
+      ...response,
+      items: response.items.map((item) => this.convertBatchJobDates(item))
+    };
+  }
+  /**
+   * Cancel a batch job
+   */
+  async cancelBatchJob(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.post(
+      `/webdata/batch/${request.id}/cancel${query ? `?${query}` : ""}`,
+      {}
+    );
+  }
+  /**
+   * Create a batch screenshot job and wait for completion
+   */
+  async batchAndWait(request, options = {}) {
+    const { pollInterval = 2e3, timeout = 3e5 } = options;
+    const startTime = Date.now();
+    const { id } = await this.batch(request);
+    while (Date.now() - startTime < timeout) {
+      const job = await this.getBatchJob({
+        id,
+        environment: request.environment,
+        projectId: request.projectId
+      });
+      if (job.status === "completed" || job.status === "failed" || job.status === "cancelled") {
+        return job;
+      }
+      await new Promise((resolve) => setTimeout(resolve, pollInterval));
+    }
+    throw new Error("Batch job timed out");
+  }
+  // ==========================================================================
+  // SCHEDULES
+  // ==========================================================================
+  /**
+   * Create a scheduled screenshot job
+   *
+   * @example
+   * ```typescript
+   * const { id } = await screenshots.createSchedule({
+   *   name: 'Daily homepage screenshot',
+   *   url: 'https://example.com',
+   *   frequency: 'daily',
+   *   config: { format: 'png', fullPage: true },
+   * });
+   * ```
+   */
+  async createSchedule(request) {
+    return this.http.post("/webdata/schedules", {
+      ...request,
+      type: "screenshot"
+    });
+  }
+  /**
+   * Update a schedule
+   */
+  async updateSchedule(request) {
+    const { id, environment, projectId, ...data } = request;
+    const params = new URLSearchParams();
+    if (environment) params.set("environment", environment);
+    if (projectId) params.set("projectId", projectId);
+    const query = params.toString();
+    return this.http.post(
+      `/webdata/schedules/${id}${query ? `?${query}` : ""}`,
+      data
+    );
+  }
+  /**
+   * Get a schedule by ID
+   */
+  async getSchedule(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();
+    const path = `/webdata/schedules/${request.id}${query ? `?${query}` : ""}`;
+    const response = await this.http.get(path);
+    return this.convertScheduleDates(response);
+  }
+  /**
+   * List schedules with pagination and filters
+   */
+  async listSchedules(request = {}) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    params.set("type", "screenshot");
+    if (request.isActive !== void 0) params.set("isActive", request.isActive.toString());
+    if (request.limit) params.set("limit", request.limit.toString());
+    if (request.cursor) params.set("cursor", request.cursor);
+    const query = params.toString();
+    const response = await this.http.get(
+      `/webdata/schedules${query ? `?${query}` : ""}`
+    );
+    return {
+      ...response,
+      items: response.items.map((item) => this.convertScheduleDates(item))
+    };
+  }
+  /**
+   * Delete a schedule
+   */
+  async deleteSchedule(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.delete(
+      `/webdata/schedules/${request.id}${query ? `?${query}` : ""}`
+    );
+  }
+  /**
+   * Toggle a schedule on or off
+   */
+  async toggleSchedule(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.post(
+      `/webdata/schedules/${request.id}/toggle${query ? `?${query}` : ""}`,
+      {}
+    );
+  }
+  // ==========================================================================
+  // HELPERS
+  // ==========================================================================
+  convertDates(screenshot) {
+    if (typeof screenshot.createdAt === "string") {
+      screenshot.createdAt = new Date(screenshot.createdAt);
+    }
+    if (screenshot.completedAt && typeof screenshot.completedAt === "string") {
+      screenshot.completedAt = new Date(screenshot.completedAt);
+    }
+    return screenshot;
+  }
+  convertBatchJobDates(job) {
+    if (typeof job.createdAt === "string") {
+      job.createdAt = new Date(job.createdAt);
+    }
+    if (job.startedAt && typeof job.startedAt === "string") {
+      job.startedAt = new Date(job.startedAt);
+    }
+    if (job.completedAt && typeof job.completedAt === "string") {
+      job.completedAt = new Date(job.completedAt);
+    }
+    return job;
+  }
+  convertScheduleDates(schedule) {
+    if (typeof schedule.createdAt === "string") {
+      schedule.createdAt = new Date(schedule.createdAt);
+    }
+    if (typeof schedule.updatedAt === "string") {
+      schedule.updatedAt = new Date(schedule.updatedAt);
+    }
+    if (schedule.lastRunAt && typeof schedule.lastRunAt === "string") {
+      schedule.lastRunAt = new Date(schedule.lastRunAt);
+    }
+    if (schedule.nextRunAt && typeof schedule.nextRunAt === "string") {
+      schedule.nextRunAt = new Date(schedule.nextRunAt);
+    }
+    return schedule;
+  }
+};
+
+export { Screenshots };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/screenshots/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/http-client.ts","../../src/screenshots/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,GAAqC;AAC3C,IAAA,OAAO;AAAA,MACL,cAAA,EAAgB,kBAAA;AAAA,MAChB,aAAA,EAAe,CAAA,OAAA,EAAU,IAAA,CAAK,MAAM,CAAA;AAAA,KACtC;AAAA,EACF;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;AAElC,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,QAChC,MAAA;AAAA,QACA,OAAA,EAAS,KAAK,UAAA,EAAW;AAAA,QACzB,IAAA,EAAM,IAAA,GAAO,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA,GAAI,KAAA;AAAA,OACrC,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,KAAA,CAAS,IAAA,EAAc,IAAA,EAA2B;AACtD,IAAA,OAAO,IAAA,CAAK,OAAA,CAAW,OAAA,EAAS,IAAA,EAAM,IAAI,CAAA;AAAA,EAC5C;AACF,CAAA;;;AChEO,IAAM,cAAN,MAAkB;AAAA,EACf,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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBA,MAAM,QAAQ,OAAA,EAAqE;AACjF,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,IAAA,CAA+B,sBAAA,EAAwB,OAAO,CAAA;AAAA,EACjF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAM,IAAI,OAAA,EAAoD;AAC5D,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;AAEhE,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,MAAM,IAAA,GAAO,wBAAwB,OAAA,CAAQ,EAAE,GAAG,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAE,CAAA,CAAA;AAE1E,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,CAAK,IAAgB,IAAI,CAAA;AACrD,IAAA,OAAO,IAAA,CAAK,aAAa,QAAQ,CAAA;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAM,IAAA,CAAK,OAAA,GAAkC,EAAC,EAAqC;AACjF,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AAEnC,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,QAAQ,GAAA,EAAK,MAAA,CAAO,GAAA,CAAI,KAAA,EAAO,QAAQ,GAAG,CAAA;AAC9C,IAAA,IAAI,OAAA,CAAQ,OAAO,MAAA,CAAO,GAAA,CAAI,SAAS,OAAA,CAAQ,KAAA,CAAM,UAAU,CAAA;AAC/D,IAAA,IAAI,QAAQ,MAAA,EAAQ,MAAA,CAAO,GAAA,CAAI,QAAA,EAAU,QAAQ,MAAM,CAAA;AAEvD,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,CAAK,GAAA;AAAA,MAC/B,CAAA,oBAAA,EAAuB,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,KAAK,EAAE,CAAA;AAAA,KACjD;AAEA,IAAA,OAAO;AAAA,MACL,GAAG,QAAA;AAAA,MACH,KAAA,EAAO,SAAS,KAAA,CAAM,GAAA,CAAI,CAAC,IAAA,KAAS,IAAA,CAAK,YAAA,CAAa,IAAI,CAAC;AAAA,KAC7D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,OAAO,OAAA,EAA8D;AACzE,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;AAEhE,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,OAAO,KAAK,IAAA,CAAK,MAAA;AAAA,MACf,CAAA,qBAAA,EAAwB,QAAQ,EAAE,CAAA,EAAG,QAAQ,CAAA,CAAA,EAAI,KAAK,KAAK,EAAE,CAAA;AAAA,KAC/D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,cAAA,CACJ,OAAA,EACA,OAAA,GAAuD,EAAC,EACnC;AACrB,IAAA,MAAM,EAAE,YAAA,GAAe,GAAA,EAAM,OAAA,GAAU,KAAM,GAAI,OAAA;AACjD,IAAA,MAAM,SAAA,GAAY,KAAK,GAAA,EAAI;AAE3B,IAAA,MAAM,EAAE,EAAA,EAAG,GAAI,MAAM,IAAA,CAAK,QAAQ,OAAO,CAAA;AAEzC,IAAA,OAAO,IAAA,CAAK,GAAA,EAAI,GAAI,SAAA,GAAY,OAAA,EAAS;AACvC,MAAA,MAAM,UAAA,GAAa,MAAM,IAAA,CAAK,GAAA,CAAI;AAAA,QAChC,EAAA;AAAA,QACA,aAAa,OAAA,CAAQ,WAAA;AAAA,QACrB,WAAW,OAAA,CAAQ;AAAA,OACpB,CAAA;AAED,MAAA,IAAI,UAAA,CAAW,MAAA,KAAW,WAAA,IAAe,UAAA,CAAW,WAAW,QAAA,EAAU;AACvE,QAAA,IAAI,UAAA,CAAW,WAAW,QAAA,EAAU;AAClC,UAAA,MAAM,IAAI,KAAA,CAAM,UAAA,CAAW,KAAA,IAAS,mBAAmB,CAAA;AAAA,QACzD;AACA,QAAA,OAAO,UAAA;AAAA,MACT;AAEA,MAAA,MAAM,IAAI,OAAA,CAAQ,CAAC,YAAY,UAAA,CAAW,OAAA,EAAS,YAAY,CAAC,CAAA;AAAA,IAClE;AAEA,IAAA,MAAM,IAAI,MAAM,sBAAsB,CAAA;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBA,MAAM,MAAM,OAAA,EAAsE;AAChF,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,IAAA,CAA0B,4BAAA,EAA8B,OAAO,CAAA;AAAA,EAClF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,YAAY,OAAA,EAA0D;AAC1E,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;AAEhE,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,MAAM,IAAA,GAAO,kBAAkB,OAAA,CAAQ,EAAE,GAAG,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAE,CAAA,CAAA;AAEpE,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,CAAK,IAAwB,IAAI,CAAA;AAC7D,IAAA,OAAO,IAAA,CAAK,qBAAqB,QAAQ,CAAA;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAAA,CAAc,OAAA,GAAgC,EAAC,EAAyC;AAC5F,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AAEnC,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,MAAA,CAAO,GAAA,CAAI,QAAQ,YAAY,CAAA;AAC/B,IAAA,IAAI,OAAA,CAAQ,OAAO,MAAA,CAAO,GAAA,CAAI,SAAS,OAAA,CAAQ,KAAA,CAAM,UAAU,CAAA;AAC/D,IAAA,IAAI,QAAQ,MAAA,EAAQ,MAAA,CAAO,GAAA,CAAI,QAAA,EAAU,QAAQ,MAAM,CAAA;AAEvD,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,CAAK,GAAA;AAAA,MAC/B,CAAA,cAAA,EAAiB,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,KAAK,EAAE,CAAA;AAAA,KAC3C;AAEA,IAAA,OAAO;AAAA,MACL,GAAG,QAAA;AAAA,MACH,KAAA,EAAO,SAAS,KAAA,CAAM,GAAA,CAAI,CAAC,IAAA,KAAS,IAAA,CAAK,oBAAA,CAAqB,IAAI,CAAC;AAAA,KACrE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe,OAAA,EAA4D;AAC/E,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;AAEhE,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,OAAO,KAAK,IAAA,CAAK,IAAA;AAAA,MACf,CAAA,eAAA,EAAkB,QAAQ,EAAE,CAAA,OAAA,EAAU,QAAQ,CAAA,CAAA,EAAI,KAAK,KAAK,EAAE,CAAA,CAAA;AAAA,MAC9D;AAAC,KACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,YAAA,CACJ,OAAA,EACA,OAAA,GAAuD,EAAC,EAC3B;AAC7B,IAAA,MAAM,EAAE,YAAA,GAAe,GAAA,EAAM,OAAA,GAAU,KAAO,GAAI,OAAA;AAClD,IAAA,MAAM,SAAA,GAAY,KAAK,GAAA,EAAI;AAE3B,IAAA,MAAM,EAAE,EAAA,EAAG,GAAI,MAAM,IAAA,CAAK,MAAM,OAAO,CAAA;AAEvC,IAAA,OAAO,IAAA,CAAK,GAAA,EAAI,GAAI,SAAA,GAAY,OAAA,EAAS;AACvC,MAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,WAAA,CAAY;AAAA,QACjC,EAAA;AAAA,QACA,aAAa,OAAA,CAAQ,WAAA;AAAA,QACrB,WAAW,OAAA,CAAQ;AAAA,OACpB,CAAA;AAED,MAAA,IAAI,GAAA,CAAI,WAAW,WAAA,IAAe,GAAA,CAAI,WAAW,QAAA,IAAY,GAAA,CAAI,WAAW,WAAA,EAAa;AACvF,QAAA,OAAO,GAAA;AAAA,MACT;AAEA,MAAA,MAAM,IAAI,OAAA,CAAQ,CAAC,YAAY,UAAA,CAAW,OAAA,EAAS,YAAY,CAAC,CAAA;AAAA,IAClE;AAEA,IAAA,MAAM,IAAI,MAAM,qBAAqB,CAAA;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,MAAM,eAAe,OAAA,EAA2E;AAC9F,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,IAAA,CAA6B,oBAAA,EAAsB;AAAA,MAClE,GAAG,OAAA;AAAA,MACH,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe,OAAA,EAAyE;AAC5F,IAAA,MAAM,EAAE,EAAA,EAAI,WAAA,EAAa,SAAA,EAAW,GAAG,MAAK,GAAI,OAAA;AAEhD,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AACnC,IAAA,IAAI,WAAA,EAAa,MAAA,CAAO,GAAA,CAAI,aAAA,EAAe,WAAW,CAAA;AACtD,IAAA,IAAI,SAAA,EAAW,MAAA,CAAO,GAAA,CAAI,WAAA,EAAa,SAAS,CAAA;AAEhD,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,OAAO,KAAK,IAAA,CAAK,IAAA;AAAA,MACf,sBAAsB,EAAE,CAAA,EAAG,QAAQ,CAAA,CAAA,EAAI,KAAK,KAAK,EAAE,CAAA,CAAA;AAAA,MACnD;AAAA,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,YAAY,OAAA,EAA0D;AAC1E,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;AAEhE,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,MAAM,IAAA,GAAO,sBAAsB,OAAA,CAAQ,EAAE,GAAG,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAE,CAAA,CAAA;AAExE,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,CAAK,IAAwB,IAAI,CAAA;AAC7D,IAAA,OAAO,IAAA,CAAK,qBAAqB,QAAQ,CAAA;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAAA,CAAc,OAAA,GAAgC,EAAC,EAAyC;AAC5F,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AAEnC,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,MAAA,CAAO,GAAA,CAAI,QAAQ,YAAY,CAAA;AAC/B,IAAA,IAAI,OAAA,CAAQ,aAAa,MAAA,EAAW,MAAA,CAAO,IAAI,UAAA,EAAY,OAAA,CAAQ,QAAA,CAAS,QAAA,EAAU,CAAA;AACtF,IAAA,IAAI,OAAA,CAAQ,OAAO,MAAA,CAAO,GAAA,CAAI,SAAS,OAAA,CAAQ,KAAA,CAAM,UAAU,CAAA;AAC/D,IAAA,IAAI,QAAQ,MAAA,EAAQ,MAAA,CAAO,GAAA,CAAI,QAAA,EAAU,QAAQ,MAAM,CAAA;AAEvD,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,CAAK,GAAA;AAAA,MAC/B,CAAA,kBAAA,EAAqB,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,KAAK,EAAE,CAAA;AAAA,KAC/C;AAEA,IAAA,OAAO;AAAA,MACL,GAAG,QAAA;AAAA,MACH,KAAA,EAAO,SAAS,KAAA,CAAM,GAAA,CAAI,CAAC,IAAA,KAAS,IAAA,CAAK,oBAAA,CAAqB,IAAI,CAAC;AAAA,KACrE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe,OAAA,EAA4D;AAC/E,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;AAEhE,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,OAAO,KAAK,IAAA,CAAK,MAAA;AAAA,MACf,CAAA,mBAAA,EAAsB,QAAQ,EAAE,CAAA,EAAG,QAAQ,CAAA,CAAA,EAAI,KAAK,KAAK,EAAE,CAAA;AAAA,KAC7D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe,OAAA,EAA6D;AAChF,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;AAEhE,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,OAAO,KAAK,IAAA,CAAK,IAAA;AAAA,MACf,CAAA,mBAAA,EAAsB,QAAQ,EAAE,CAAA,OAAA,EAAU,QAAQ,CAAA,CAAA,EAAI,KAAK,KAAK,EAAE,CAAA,CAAA;AAAA,MAClE;AAAC,KACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAMQ,aAAa,UAAA,EAAoC;AACvD,IAAA,IAAI,OAAO,UAAA,CAAW,SAAA,KAAc,QAAA,EAAU;AAC5C,MAAA,UAAA,CAAW,SAAA,GAAY,IAAI,IAAA,CAAK,UAAA,CAAW,SAAS,CAAA;AAAA,IACtD;AACA,IAAA,IAAI,UAAA,CAAW,WAAA,IAAe,OAAO,UAAA,CAAW,gBAAgB,QAAA,EAAU;AACxE,MAAA,UAAA,CAAW,WAAA,GAAc,IAAI,IAAA,CAAK,UAAA,CAAW,WAAW,CAAA;AAAA,IAC1D;AACA,IAAA,OAAO,UAAA;AAAA,EACT;AAAA,EAEQ,qBAAqB,GAAA,EAA6C;AACxE,IAAA,IAAI,OAAO,GAAA,CAAI,SAAA,KAAc,QAAA,EAAU;AACrC,MAAA,GAAA,CAAI,SAAA,GAAY,IAAI,IAAA,CAAK,GAAA,CAAI,SAAS,CAAA;AAAA,IACxC;AACA,IAAA,IAAI,GAAA,CAAI,SAAA,IAAa,OAAO,GAAA,CAAI,cAAc,QAAA,EAAU;AACtD,MAAA,GAAA,CAAI,SAAA,GAAY,IAAI,IAAA,CAAK,GAAA,CAAI,SAAS,CAAA;AAAA,IACxC;AACA,IAAA,IAAI,GAAA,CAAI,WAAA,IAAe,OAAO,GAAA,CAAI,gBAAgB,QAAA,EAAU;AAC1D,MAAA,GAAA,CAAI,WAAA,GAAc,IAAI,IAAA,CAAK,GAAA,CAAI,WAAW,CAAA;AAAA,IAC5C;AACA,IAAA,OAAO,GAAA;AAAA,EACT;AAAA,EAEQ,qBAAqB,QAAA,EAAkD;AAC7E,IAAA,IAAI,OAAO,QAAA,CAAS,SAAA,KAAc,QAAA,EAAU;AAC1C,MAAA,QAAA,CAAS,SAAA,GAAY,IAAI,IAAA,CAAK,QAAA,CAAS,SAAS,CAAA;AAAA,IAClD;AACA,IAAA,IAAI,OAAO,QAAA,CAAS,SAAA,KAAc,QAAA,EAAU;AAC1C,MAAA,QAAA,CAAS,SAAA,GAAY,IAAI,IAAA,CAAK,QAAA,CAAS,SAAS,CAAA;AAAA,IAClD;AACA,IAAA,IAAI,QAAA,CAAS,SAAA,IAAa,OAAO,QAAA,CAAS,cAAc,QAAA,EAAU;AAChE,MAAA,QAAA,CAAS,SAAA,GAAY,IAAI,IAAA,CAAK,QAAA,CAAS,SAAS,CAAA;AAAA,IAClD;AACA,IAAA,IAAI,QAAA,CAAS,SAAA,IAAa,OAAO,QAAA,CAAS,cAAc,QAAA,EAAU;AAChE,MAAA,QAAA,CAAS,SAAA,GAAY,IAAI,IAAA,CAAK,QAAA,CAAS,SAAS,CAAA;AAAA,IAClD;AACA,IAAA,OAAO,QAAA;AAAA,EACT;AACF","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(): Record<string, string> {\n    return {\n      \"Content-Type\": \"application/json\",\n      Authorization: `Bearer ${this.apiKey}`,\n    };\n  }\n\n  async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n\n    try {\n      const response = await fetch(url, {\n        method,\n        headers: this.getHeaders(),\n        body: body ? JSON.stringify(body) : 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 patch<T>(path: string, body: unknown): Promise<T> {\n    return this.request<T>(\"PATCH\", path, body);\n  }\n}\n","/**\n * Stack0 Screenshots Client\n * Capture high-quality screenshots of any webpage\n */\n\nimport { HttpClient, type HttpClientConfig } from \"../lib/http-client\";\nimport type {\n  CreateBatchResponse,\n  GetBatchJobRequest,\n  ListBatchJobsRequest,\n  CreateScheduleResponse,\n  GetScheduleRequest,\n  ListSchedulesRequest,\n} from \"../lib/shared-types\";\nimport type {\n  Screenshot,\n  CreateScreenshotRequest,\n  CreateScreenshotResponse,\n  GetScreenshotRequest,\n  ListScreenshotsRequest,\n  ListScreenshotsResponse,\n  BatchScreenshotJob,\n  CreateBatchScreenshotsRequest,\n  ScreenshotBatchJobsResponse,\n  ScreenshotSchedule,\n  CreateScreenshotScheduleRequest,\n  UpdateScreenshotScheduleRequest,\n  ScreenshotSchedulesResponse,\n} from \"./types\";\n\nexport class Screenshots {\n  private http: HttpClient;\n\n  constructor(config: HttpClientConfig) {\n    this.http = new HttpClient(config);\n  }\n\n  // ==========================================================================\n  // SCREENSHOTS\n  // ==========================================================================\n\n  /**\n   * Capture a screenshot of a URL\n   *\n   * @example\n   * ```typescript\n   * const { id, status } = await screenshots.capture({\n   *   url: 'https://example.com',\n   *   format: 'png',\n   *   fullPage: true,\n   *   deviceType: 'desktop',\n   * });\n   *\n   * // Poll for completion\n   * const screenshot = await screenshots.get({ id });\n   * console.log(screenshot.imageUrl);\n   * ```\n   */\n  async capture(request: CreateScreenshotRequest): Promise<CreateScreenshotResponse> {\n    return this.http.post<CreateScreenshotResponse>(\"/webdata/screenshots\", request);\n  }\n\n  /**\n   * Get a screenshot by ID\n   *\n   * @example\n   * ```typescript\n   * const screenshot = await screenshots.get({ id: 'screenshot-id' });\n   * if (screenshot.status === 'completed') {\n   *   console.log(screenshot.imageUrl);\n   * }\n   * ```\n   */\n  async get(request: GetScreenshotRequest): Promise<Screenshot> {\n    const params = new URLSearchParams();\n    if (request.environment) params.set(\"environment\", request.environment);\n    if (request.projectId) params.set(\"projectId\", request.projectId);\n\n    const query = params.toString();\n    const path = `/webdata/screenshots/${request.id}${query ? `?${query}` : \"\"}`;\n\n    const response = await this.http.get<Screenshot>(path);\n    return this.convertDates(response);\n  }\n\n  /**\n   * List screenshots with pagination and filters\n   *\n   * @example\n   * ```typescript\n   * const { items, nextCursor } = await screenshots.list({\n   *   status: 'completed',\n   *   limit: 20,\n   * });\n   * ```\n   */\n  async list(request: ListScreenshotsRequest = {}): Promise<ListScreenshotsResponse> {\n    const params = new URLSearchParams();\n\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\", request.limit.toString());\n    if (request.cursor) params.set(\"cursor\", request.cursor);\n\n    const query = params.toString();\n    const response = await this.http.get<ListScreenshotsResponse>(\n      `/webdata/screenshots${query ? `?${query}` : \"\"}`\n    );\n\n    return {\n      ...response,\n      items: response.items.map((item) => this.convertDates(item)),\n    };\n  }\n\n  /**\n   * Delete a screenshot\n   *\n   * @example\n   * ```typescript\n   * await screenshots.delete({ id: 'screenshot-id' });\n   * ```\n   */\n  async delete(request: GetScreenshotRequest): 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\n    const query = params.toString();\n    return this.http.delete<{ success: boolean }>(\n      `/webdata/screenshots/${request.id}${query ? `?${query}` : \"\"}`\n    );\n  }\n\n  /**\n   * Capture a screenshot and wait for completion\n   *\n   * @example\n   * ```typescript\n   * const screenshot = await screenshots.captureAndWait({\n   *   url: 'https://example.com',\n   *   format: 'png',\n   * });\n   * console.log(screenshot.imageUrl);\n   * ```\n   */\n  async captureAndWait(\n    request: CreateScreenshotRequest,\n    options: { pollInterval?: number; timeout?: number } = {}\n  ): Promise<Screenshot> {\n    const { pollInterval = 1000, timeout = 60000 } = options;\n    const startTime = Date.now();\n\n    const { id } = await this.capture(request);\n\n    while (Date.now() - startTime < timeout) {\n      const screenshot = await this.get({\n        id,\n        environment: request.environment,\n        projectId: request.projectId,\n      });\n\n      if (screenshot.status === \"completed\" || screenshot.status === \"failed\") {\n        if (screenshot.status === \"failed\") {\n          throw new Error(screenshot.error || \"Screenshot failed\");\n        }\n        return screenshot;\n      }\n\n      await new Promise((resolve) => setTimeout(resolve, pollInterval));\n    }\n\n    throw new Error(\"Screenshot timed out\");\n  }\n\n  // ==========================================================================\n  // BATCH JOBS\n  // ==========================================================================\n\n  /**\n   * Create a batch screenshot job for multiple URLs\n   *\n   * @example\n   * ```typescript\n   * const { id, totalUrls } = await screenshots.batch({\n   *   urls: [\n   *     'https://example.com',\n   *     'https://example.org',\n   *   ],\n   *   config: { format: 'png', fullPage: true },\n   * });\n   *\n   * // Poll for completion\n   * const job = await screenshots.getBatchJob({ id });\n   * console.log(`Progress: ${job.processedUrls}/${job.totalUrls}`);\n   * ```\n   */\n  async batch(request: CreateBatchScreenshotsRequest): Promise<CreateBatchResponse> {\n    return this.http.post<CreateBatchResponse>(\"/webdata/batch/screenshots\", request);\n  }\n\n  /**\n   * Get a batch job by ID\n   */\n  async getBatchJob(request: GetBatchJobRequest): Promise<BatchScreenshotJob> {\n    const params = new URLSearchParams();\n    if (request.environment) params.set(\"environment\", request.environment);\n    if (request.projectId) params.set(\"projectId\", request.projectId);\n\n    const query = params.toString();\n    const path = `/webdata/batch/${request.id}${query ? `?${query}` : \"\"}`;\n\n    const response = await this.http.get<BatchScreenshotJob>(path);\n    return this.convertBatchJobDates(response);\n  }\n\n  /**\n   * List batch jobs with pagination and filters\n   */\n  async listBatchJobs(request: ListBatchJobsRequest = {}): Promise<ScreenshotBatchJobsResponse> {\n    const params = new URLSearchParams();\n\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    params.set(\"type\", \"screenshot\");\n    if (request.limit) params.set(\"limit\", request.limit.toString());\n    if (request.cursor) params.set(\"cursor\", request.cursor);\n\n    const query = params.toString();\n    const response = await this.http.get<ScreenshotBatchJobsResponse>(\n      `/webdata/batch${query ? `?${query}` : \"\"}`\n    );\n\n    return {\n      ...response,\n      items: response.items.map((item) => this.convertBatchJobDates(item)),\n    };\n  }\n\n  /**\n   * Cancel a batch job\n   */\n  async cancelBatchJob(request: GetBatchJobRequest): 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\n    const query = params.toString();\n    return this.http.post<{ success: boolean }>(\n      `/webdata/batch/${request.id}/cancel${query ? `?${query}` : \"\"}`,\n      {}\n    );\n  }\n\n  /**\n   * Create a batch screenshot job and wait for completion\n   */\n  async batchAndWait(\n    request: CreateBatchScreenshotsRequest,\n    options: { pollInterval?: number; timeout?: number } = {}\n  ): Promise<BatchScreenshotJob> {\n    const { pollInterval = 2000, timeout = 300000 } = options;\n    const startTime = Date.now();\n\n    const { id } = await this.batch(request);\n\n    while (Date.now() - startTime < timeout) {\n      const job = await this.getBatchJob({\n        id,\n        environment: request.environment,\n        projectId: request.projectId,\n      });\n\n      if (job.status === \"completed\" || job.status === \"failed\" || job.status === \"cancelled\") {\n        return job;\n      }\n\n      await new Promise((resolve) => setTimeout(resolve, pollInterval));\n    }\n\n    throw new Error(\"Batch job timed out\");\n  }\n\n  // ==========================================================================\n  // SCHEDULES\n  // ==========================================================================\n\n  /**\n   * Create a scheduled screenshot job\n   *\n   * @example\n   * ```typescript\n   * const { id } = await screenshots.createSchedule({\n   *   name: 'Daily homepage screenshot',\n   *   url: 'https://example.com',\n   *   frequency: 'daily',\n   *   config: { format: 'png', fullPage: true },\n   * });\n   * ```\n   */\n  async createSchedule(request: CreateScreenshotScheduleRequest): Promise<CreateScheduleResponse> {\n    return this.http.post<CreateScheduleResponse>(\"/webdata/schedules\", {\n      ...request,\n      type: \"screenshot\",\n    });\n  }\n\n  /**\n   * Update a schedule\n   */\n  async updateSchedule(request: UpdateScreenshotScheduleRequest): Promise<{ success: boolean }> {\n    const { id, environment, projectId, ...data } = request;\n\n    const params = new URLSearchParams();\n    if (environment) params.set(\"environment\", environment);\n    if (projectId) params.set(\"projectId\", projectId);\n\n    const query = params.toString();\n    return this.http.post<{ success: boolean }>(\n      `/webdata/schedules/${id}${query ? `?${query}` : \"\"}`,\n      data\n    );\n  }\n\n  /**\n   * Get a schedule by ID\n   */\n  async getSchedule(request: GetScheduleRequest): Promise<ScreenshotSchedule> {\n    const params = new URLSearchParams();\n    if (request.environment) params.set(\"environment\", request.environment);\n    if (request.projectId) params.set(\"projectId\", request.projectId);\n\n    const query = params.toString();\n    const path = `/webdata/schedules/${request.id}${query ? `?${query}` : \"\"}`;\n\n    const response = await this.http.get<ScreenshotSchedule>(path);\n    return this.convertScheduleDates(response);\n  }\n\n  /**\n   * List schedules with pagination and filters\n   */\n  async listSchedules(request: ListSchedulesRequest = {}): Promise<ScreenshotSchedulesResponse> {\n    const params = new URLSearchParams();\n\n    if (request.environment) params.set(\"environment\", request.environment);\n    if (request.projectId) params.set(\"projectId\", request.projectId);\n    params.set(\"type\", \"screenshot\");\n    if (request.isActive !== undefined) params.set(\"isActive\", request.isActive.toString());\n    if (request.limit) params.set(\"limit\", request.limit.toString());\n    if (request.cursor) params.set(\"cursor\", request.cursor);\n\n    const query = params.toString();\n    const response = await this.http.get<ScreenshotSchedulesResponse>(\n      `/webdata/schedules${query ? `?${query}` : \"\"}`\n    );\n\n    return {\n      ...response,\n      items: response.items.map((item) => this.convertScheduleDates(item)),\n    };\n  }\n\n  /**\n   * Delete a schedule\n   */\n  async deleteSchedule(request: GetScheduleRequest): 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\n    const query = params.toString();\n    return this.http.delete<{ success: boolean }>(\n      `/webdata/schedules/${request.id}${query ? `?${query}` : \"\"}`\n    );\n  }\n\n  /**\n   * Toggle a schedule on or off\n   */\n  async toggleSchedule(request: GetScheduleRequest): Promise<{ isActive: 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\n    const query = params.toString();\n    return this.http.post<{ isActive: boolean }>(\n      `/webdata/schedules/${request.id}/toggle${query ? `?${query}` : \"\"}`,\n      {}\n    );\n  }\n\n  // ==========================================================================\n  // HELPERS\n  // ==========================================================================\n\n  private convertDates(screenshot: Screenshot): Screenshot {\n    if (typeof screenshot.createdAt === \"string\") {\n      screenshot.createdAt = new Date(screenshot.createdAt);\n    }\n    if (screenshot.completedAt && typeof screenshot.completedAt === \"string\") {\n      screenshot.completedAt = new Date(screenshot.completedAt);\n    }\n    return screenshot;\n  }\n\n  private convertBatchJobDates(job: BatchScreenshotJob): BatchScreenshotJob {\n    if (typeof job.createdAt === \"string\") {\n      job.createdAt = new Date(job.createdAt);\n    }\n    if (job.startedAt && typeof job.startedAt === \"string\") {\n      job.startedAt = new Date(job.startedAt);\n    }\n    if (job.completedAt && typeof job.completedAt === \"string\") {\n      job.completedAt = new Date(job.completedAt);\n    }\n    return job;\n  }\n\n  private convertScheduleDates(schedule: ScreenshotSchedule): ScreenshotSchedule {\n    if (typeof schedule.createdAt === \"string\") {\n      schedule.createdAt = new Date(schedule.createdAt);\n    }\n    if (typeof schedule.updatedAt === \"string\") {\n      schedule.updatedAt = new Date(schedule.updatedAt);\n    }\n    if (schedule.lastRunAt && typeof schedule.lastRunAt === \"string\") {\n      schedule.lastRunAt = new Date(schedule.lastRunAt);\n    }\n    if (schedule.nextRunAt && typeof schedule.nextRunAt === \"string\") {\n      schedule.nextRunAt = new Date(schedule.nextRunAt);\n    }\n    return schedule;\n  }\n}\n"]}

package/dist/shared-types-B0PyC7cF.d.mts

@@ -0,0 +1,40 @@
+/**
+ * Shared types used across multiple SDK modules
+ */
+type Environment = "sandbox" | "production";
+type BatchJobStatus = "pending" | "processing" | "completed" | "failed" | "cancelled";
+type ScheduleFrequency = "hourly" | "daily" | "weekly" | "monthly";
+interface GetBatchJobRequest {
+    id: string;
+    environment?: Environment;
+    projectId?: string;
+}
+interface ListBatchJobsRequest {
+    environment?: Environment;
+    projectId?: string;
+    status?: BatchJobStatus;
+    limit?: number;
+    cursor?: string;
+}
+interface CreateBatchResponse {
+    id: string;
+    status: BatchJobStatus;
+    totalUrls: number;
+}
+interface GetScheduleRequest {
+    id: string;
+    environment?: Environment;
+    projectId?: string;
+}
+interface ListSchedulesRequest {
+    environment?: Environment;
+    projectId?: string;
+    isActive?: boolean;
+    limit?: number;
+    cursor?: string;
+}
+interface CreateScheduleResponse {
+    id: string;
+}
+
+export type { BatchJobStatus as B, CreateBatchResponse as C, Environment as E, GetBatchJobRequest as G, ListBatchJobsRequest as L, ScheduleFrequency as S, GetScheduleRequest as a, ListSchedulesRequest as b, CreateScheduleResponse as c };

package/dist/shared-types-B0PyC7cF.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shared types used across multiple SDK modules
+ */
+type Environment = "sandbox" | "production";
+type BatchJobStatus = "pending" | "processing" | "completed" | "failed" | "cancelled";
+type ScheduleFrequency = "hourly" | "daily" | "weekly" | "monthly";
+interface GetBatchJobRequest {
+    id: string;
+    environment?: Environment;
+    projectId?: string;
+}
+interface ListBatchJobsRequest {
+    environment?: Environment;
+    projectId?: string;
+    status?: BatchJobStatus;
+    limit?: number;
+    cursor?: string;
+}
+interface CreateBatchResponse {
+    id: string;
+    status: BatchJobStatus;
+    totalUrls: number;
+}
+interface GetScheduleRequest {
+    id: string;
+    environment?: Environment;
+    projectId?: string;
+}
+interface ListSchedulesRequest {
+    environment?: Environment;
+    projectId?: string;
+    isActive?: boolean;
+    limit?: number;
+    cursor?: string;
+}
+interface CreateScheduleResponse {
+    id: string;
+}
+
+export type { BatchJobStatus as B, CreateBatchResponse as C, Environment as E, GetBatchJobRequest as G, ListBatchJobsRequest as L, ScheduleFrequency as S, GetScheduleRequest as a, ListSchedulesRequest as b, CreateScheduleResponse as c };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stack0/sdk",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Official Stack0 SDK for Node.js",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -20,6 +20,21 @@
       "types": "./dist/cdn/index.d.ts",
       "require": "./dist/cdn/index.js",
       "import": "./dist/cdn/index.mjs"
+    },
+    "./screenshots": {
+      "types": "./dist/screenshots/index.d.ts",
+      "require": "./dist/screenshots/index.js",
+      "import": "./dist/screenshots/index.mjs"
+    },
+    "./extraction": {
+      "types": "./dist/extraction/index.d.ts",
+      "require": "./dist/extraction/index.js",
+      "import": "./dist/extraction/index.mjs"
+    },
+    "./webdata": {
+      "types": "./dist/webdata/index.d.ts",
+      "require": "./dist/webdata/index.js",
+      "import": "./dist/webdata/index.mjs"
     }
   },
   "files": [
@@ -34,6 +49,10 @@
     "cdn",
     "assets",
     "file-upload",
+    "screenshots",
+    "webpage-capture",
+    "ai-extraction",
+    "web-scraping",
     "api",
     "sdk"
   ],