@stack0/sdk 0.2.8 → 0.2.9

package/dist/index.js

@@ -387,6 +387,736 @@ var CDN = class {
   }
 };
 
+// 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;
+  }
+};
+
+// src/extraction/client.ts
+var Extraction = class {
+  http;
+  constructor(config) {
+    this.http = new HttpClient(config);
+  }
+  // ==========================================================================
+  // EXTRACTIONS
+  // ==========================================================================
+  /**
+   * Extract content from a URL
+   *
+   * @example
+   * ```typescript
+   * const { id, status } = await extraction.extract({
+   *   url: 'https://example.com/article',
+   *   mode: 'markdown',
+   *   includeMetadata: true,
+   * });
+   *
+   * // Poll for completion
+   * const result = await extraction.get({ id });
+   * console.log(result.markdown);
+   * ```
+   */
+  async extract(request) {
+    return this.http.post("/webdata/extractions", request);
+  }
+  /**
+   * Get an extraction by ID
+   *
+   * @example
+   * ```typescript
+   * const extraction = await extraction.get({ id: 'extraction-id' });
+   * if (extraction.status === 'completed') {
+   *   console.log(extraction.markdown);
+   *   console.log(extraction.pageMetadata);
+   * }
+   * ```
+   */
+  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/extractions/${request.id}${query ? `?${query}` : ""}`;
+    const response = await this.http.get(path);
+    return this.convertDates(response);
+  }
+  /**
+   * List extractions with pagination and filters
+   *
+   * @example
+   * ```typescript
+   * const { items, nextCursor } = await extraction.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/extractions${query ? `?${query}` : ""}`
+    );
+    return {
+      ...response,
+      items: response.items.map((item) => this.convertDates(item))
+    };
+  }
+  /**
+   * Delete an extraction
+   *
+   * @example
+   * ```typescript
+   * await extraction.delete({ id: 'extraction-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/extractions/${request.id}${query ? `?${query}` : ""}`
+    );
+  }
+  /**
+   * Extract content and wait for completion
+   *
+   * @example
+   * ```typescript
+   * const extraction = await extraction.extractAndWait({
+   *   url: 'https://example.com/article',
+   *   mode: 'markdown',
+   * });
+   * console.log(extraction.markdown);
+   * ```
+   */
+  async extractAndWait(request, options = {}) {
+    const { pollInterval = 1e3, timeout = 6e4 } = options;
+    const startTime = Date.now();
+    const { id } = await this.extract(request);
+    while (Date.now() - startTime < timeout) {
+      const extraction = await this.get({
+        id,
+        environment: request.environment,
+        projectId: request.projectId
+      });
+      if (extraction.status === "completed" || extraction.status === "failed") {
+        if (extraction.status === "failed") {
+          throw new Error(extraction.error || "Extraction failed");
+        }
+        return extraction;
+      }
+      await new Promise((resolve) => setTimeout(resolve, pollInterval));
+    }
+    throw new Error("Extraction timed out");
+  }
+  // ==========================================================================
+  // BATCH JOBS
+  // ==========================================================================
+  /**
+   * Create a batch extraction job for multiple URLs
+   *
+   * @example
+   * ```typescript
+   * const { id, totalUrls } = await extraction.batch({
+   *   urls: [
+   *     'https://example.com/article1',
+   *     'https://example.com/article2',
+   *   ],
+   *   config: { mode: 'markdown' },
+   * });
+   * ```
+   */
+  async batch(request) {
+    return this.http.post("/webdata/batch/extractions", 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", "extraction");
+    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 extraction 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 extraction job
+   *
+   * @example
+   * ```typescript
+   * const { id } = await extraction.createSchedule({
+   *   name: 'Daily price monitoring',
+   *   url: 'https://competitor.com/pricing',
+   *   frequency: 'daily',
+   *   config: { mode: 'schema', schema: { ... } },
+   * });
+   * ```
+   */
+  async createSchedule(request) {
+    return this.http.post("/webdata/schedules", {
+      ...request,
+      type: "extraction"
+    });
+  }
+  /**
+   * 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", "extraction");
+    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}` : ""}`,
+      {}
+    );
+  }
+  // ==========================================================================
+  // USAGE
+  // ==========================================================================
+  /**
+   * Get usage statistics
+   *
+   * @example
+   * ```typescript
+   * const usage = await extraction.getUsage({
+   *   periodStart: '2024-01-01T00:00:00Z',
+   *   periodEnd: '2024-01-31T23:59:59Z',
+   * });
+   * console.log(`Extractions: ${usage.extractionsTotal}`);
+   * console.log(`Tokens used: ${usage.extractionTokensUsed}`);
+   * ```
+   */
+  async getUsage(request = {}) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.periodStart) params.set("periodStart", request.periodStart);
+    if (request.periodEnd) params.set("periodEnd", request.periodEnd);
+    const query = params.toString();
+    const response = await this.http.get(
+      `/webdata/usage${query ? `?${query}` : ""}`
+    );
+    return this.convertUsageDates(response);
+  }
+  // ==========================================================================
+  // HELPERS
+  // ==========================================================================
+  convertDates(extraction) {
+    if (typeof extraction.createdAt === "string") {
+      extraction.createdAt = new Date(extraction.createdAt);
+    }
+    if (extraction.completedAt && typeof extraction.completedAt === "string") {
+      extraction.completedAt = new Date(extraction.completedAt);
+    }
+    return extraction;
+  }
+  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;
+  }
+  convertUsageDates(usage) {
+    if (typeof usage.periodStart === "string") {
+      usage.periodStart = new Date(usage.periodStart);
+    }
+    if (typeof usage.periodEnd === "string") {
+      usage.periodEnd = new Date(usage.periodEnd);
+    }
+    return usage;
+  }
+};
+
 // src/webdata/client.ts
 var Webdata = class {
   http;
@@ -991,6 +1721,11 @@ var Webdata = class {
 var Stack0 = class {
   mail;
   cdn;
+  screenshots;
+  extraction;
+  /**
+   * @deprecated Use `screenshots` and `extraction` instead. Will be removed in a future version.
+   */
   webdata;
   constructor(config) {
     const clientConfig = {
@@ -999,13 +1734,17 @@ var Stack0 = class {
     };
     this.mail = new Mail(clientConfig);
     this.cdn = new CDN(clientConfig);
+    this.screenshots = new Screenshots(clientConfig);
+    this.extraction = new Extraction(clientConfig);
     this.webdata = new Webdata(clientConfig);
   }
 };
 var src_default = Stack0;
 
 exports.CDN = CDN;
+exports.Extraction = Extraction;
 exports.Mail = Mail;
+exports.Screenshots = Screenshots;
 exports.Stack0 = Stack0;
 exports.Webdata = Webdata;
 exports.default = src_default;