@stack0/sdk 0.2.8 → 0.3.0

package/dist/index.js

@@ -385,6 +385,874 @@ var CDN = class {
     }
     return folder;
   }
+  // ============================================================================
+  // Video Transcoding Methods
+  // ============================================================================
+  /**
+   * Start a video transcoding job
+   *
+   * @example
+   * ```typescript
+   * const job = await cdn.transcode({
+   *   projectSlug: 'my-project',
+   *   assetId: 'video-asset-id',
+   *   outputFormat: 'hls',
+   *   variants: [
+   *     { quality: '720p', codec: 'h264' },
+   *     { quality: '1080p', codec: 'h264' },
+   *   ],
+   *   webhookUrl: 'https://your-app.com/webhook',
+   * });
+   * console.log(`Job started: ${job.id}`);
+   * ```
+   */
+  async transcode(request) {
+    const response = await this.http.post("/cdn/video/transcode", request);
+    return this.convertJobDates(response);
+  }
+  /**
+   * Get a transcoding job by ID
+   *
+   * @example
+   * ```typescript
+   * const job = await cdn.getJob('job-id');
+   * console.log(`Status: ${job.status}, Progress: ${job.progress}%`);
+   * ```
+   */
+  async getJob(jobId) {
+    const response = await this.http.get(`/cdn/video/jobs/${jobId}`);
+    return this.convertJobDates(response);
+  }
+  /**
+   * List transcoding jobs with filters
+   *
+   * @example
+   * ```typescript
+   * const { jobs, total } = await cdn.listJobs({
+   *   projectSlug: 'my-project',
+   *   status: 'processing',
+   *   limit: 20,
+   * });
+   * ```
+   */
+  async listJobs(request) {
+    const params = new URLSearchParams();
+    params.set("projectSlug", request.projectSlug);
+    if (request.assetId) params.set("assetId", request.assetId);
+    if (request.status) params.set("status", request.status);
+    if (request.limit) params.set("limit", request.limit.toString());
+    if (request.offset) params.set("offset", request.offset.toString());
+    const response = await this.http.get(`/cdn/video/jobs?${params.toString()}`);
+    return {
+      ...response,
+      jobs: response.jobs.map((job) => this.convertJobDates(job))
+    };
+  }
+  /**
+   * Cancel a pending or processing transcoding job
+   *
+   * @example
+   * ```typescript
+   * await cdn.cancelJob('job-id');
+   * ```
+   */
+  async cancelJob(jobId) {
+    return this.http.post(`/cdn/video/jobs/${jobId}/cancel`, {});
+  }
+  /**
+   * Get streaming URLs for a transcoded video
+   *
+   * @example
+   * ```typescript
+   * const urls = await cdn.getStreamingUrls('asset-id');
+   * console.log(`HLS URL: ${urls.hlsUrl}`);
+   * console.log(`MP4 720p: ${urls.mp4Urls.find(u => u.quality === '720p')?.url}`);
+   * ```
+   */
+  async getStreamingUrls(assetId) {
+    return this.http.get(`/cdn/video/stream/${assetId}`);
+  }
+  /**
+   * Generate a thumbnail from a video at a specific timestamp
+   *
+   * @example
+   * ```typescript
+   * const thumbnail = await cdn.getThumbnail({
+   *   assetId: 'video-asset-id',
+   *   timestamp: 10.5, // 10.5 seconds into the video
+   *   width: 320,
+   *   format: 'webp',
+   * });
+   * console.log(`Thumbnail URL: ${thumbnail.url}`);
+   * ```
+   */
+  async getThumbnail(request) {
+    const params = new URLSearchParams();
+    params.set("timestamp", request.timestamp.toString());
+    if (request.width) params.set("width", request.width.toString());
+    if (request.format) params.set("format", request.format);
+    return this.http.get(
+      `/cdn/video/thumbnail/${request.assetId}?${params.toString()}`
+    );
+  }
+  /**
+   * Extract audio from a video file
+   *
+   * @example
+   * ```typescript
+   * const { jobId } = await cdn.extractAudio({
+   *   projectSlug: 'my-project',
+   *   assetId: 'video-asset-id',
+   *   format: 'mp3',
+   *   bitrate: 192,
+   * });
+   * ```
+   */
+  async extractAudio(request) {
+    return this.http.post("/cdn/video/extract-audio", request);
+  }
+  convertJobDates(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;
+  }
+};
+
+// 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
@@ -987,10 +1855,324 @@ var Webdata = class {
   }
 };
 
+// src/integrations/client.ts
+var CRM = class {
+  http;
+  constructor(http) {
+    this.http = http;
+  }
+  // Contacts
+  async listContacts(connectionId, options) {
+    const params = new URLSearchParams({ connectionId });
+    if (options?.cursor) params.set("cursor", options.cursor);
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.sortBy) params.set("sortBy", options.sortBy);
+    if (options?.sortOrder) params.set("sortOrder", options.sortOrder);
+    return this.http.get(`/integrations/crm/contacts?${params}`);
+  }
+  async getContact(connectionId, id) {
+    return this.http.get(`/integrations/crm/contacts/${id}?connectionId=${connectionId}`);
+  }
+  async createContact(connectionId, data) {
+    return this.http.post("/integrations/crm/contacts", { connectionId, data });
+  }
+  async updateContact(connectionId, id, data) {
+    return this.http.patch(`/integrations/crm/contacts/${id}`, { connectionId, data });
+  }
+  async deleteContact(connectionId, id) {
+    return this.http.delete(`/integrations/crm/contacts/${id}?connectionId=${connectionId}`);
+  }
+  // Companies
+  async listCompanies(connectionId, options) {
+    const params = new URLSearchParams({ connectionId });
+    if (options?.cursor) params.set("cursor", options.cursor);
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.sortBy) params.set("sortBy", options.sortBy);
+    if (options?.sortOrder) params.set("sortOrder", options.sortOrder);
+    return this.http.get(`/integrations/crm/companies?${params}`);
+  }
+  async getCompany(connectionId, id) {
+    return this.http.get(`/integrations/crm/companies/${id}?connectionId=${connectionId}`);
+  }
+  async createCompany(connectionId, data) {
+    return this.http.post("/integrations/crm/companies", { connectionId, data });
+  }
+  async updateCompany(connectionId, id, data) {
+    return this.http.patch(`/integrations/crm/companies/${id}`, { connectionId, data });
+  }
+  async deleteCompany(connectionId, id) {
+    return this.http.delete(`/integrations/crm/companies/${id}?connectionId=${connectionId}`);
+  }
+  // Deals
+  async listDeals(connectionId, options) {
+    const params = new URLSearchParams({ connectionId });
+    if (options?.cursor) params.set("cursor", options.cursor);
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.sortBy) params.set("sortBy", options.sortBy);
+    if (options?.sortOrder) params.set("sortOrder", options.sortOrder);
+    return this.http.get(`/integrations/crm/deals?${params}`);
+  }
+  async getDeal(connectionId, id) {
+    return this.http.get(`/integrations/crm/deals/${id}?connectionId=${connectionId}`);
+  }
+  async createDeal(connectionId, data) {
+    return this.http.post("/integrations/crm/deals", { connectionId, data });
+  }
+  async updateDeal(connectionId, id, data) {
+    return this.http.patch(`/integrations/crm/deals/${id}`, { connectionId, data });
+  }
+  async deleteDeal(connectionId, id) {
+    return this.http.delete(`/integrations/crm/deals/${id}?connectionId=${connectionId}`);
+  }
+};
+var Storage = class {
+  http;
+  constructor(http) {
+    this.http = http;
+  }
+  // Files
+  async listFiles(connectionId, folderId, options) {
+    const params = new URLSearchParams({ connectionId });
+    if (folderId) params.set("folderId", folderId);
+    if (options?.cursor) params.set("cursor", options.cursor);
+    if (options?.limit) params.set("limit", String(options.limit));
+    return this.http.get(`/integrations/storage/files?${params}`);
+  }
+  async getFile(connectionId, id) {
+    return this.http.get(`/integrations/storage/files/${id}?connectionId=${connectionId}`);
+  }
+  async uploadFile(connectionId, input) {
+    const base64Data = input.data instanceof ArrayBuffer ? btoa(String.fromCharCode(...new Uint8Array(input.data))) : btoa(String.fromCharCode(...input.data));
+    return this.http.post("/integrations/storage/files", {
+      connectionId,
+      name: input.name,
+      mimeType: input.mimeType,
+      data: base64Data,
+      folderId: input.folderId
+    });
+  }
+  async deleteFile(connectionId, id) {
+    return this.http.delete(`/integrations/storage/files/${id}?connectionId=${connectionId}`);
+  }
+  async downloadFile(connectionId, id) {
+    const response = await this.http.get(
+      `/integrations/storage/files/${id}/download?connectionId=${connectionId}`
+    );
+    const binaryString = atob(response.data);
+    const bytes = new Uint8Array(binaryString.length);
+    for (let i = 0; i < binaryString.length; i++) {
+      bytes[i] = binaryString.charCodeAt(i);
+    }
+    return {
+      data: bytes.buffer,
+      mimeType: response.mimeType,
+      filename: response.filename
+    };
+  }
+  // Folders
+  async listFolders(connectionId, parentId, options) {
+    const params = new URLSearchParams({ connectionId });
+    if (parentId) params.set("parentId", parentId);
+    if (options?.cursor) params.set("cursor", options.cursor);
+    if (options?.limit) params.set("limit", String(options.limit));
+    return this.http.get(`/integrations/storage/folders?${params}`);
+  }
+  async getFolder(connectionId, id) {
+    return this.http.get(`/integrations/storage/folders/${id}?connectionId=${connectionId}`);
+  }
+  async createFolder(connectionId, data) {
+    return this.http.post("/integrations/storage/folders", { connectionId, ...data });
+  }
+  async deleteFolder(connectionId, id) {
+    return this.http.delete(`/integrations/storage/folders/${id}?connectionId=${connectionId}`);
+  }
+};
+var Communication = class {
+  http;
+  constructor(http) {
+    this.http = http;
+  }
+  // Channels
+  async listChannels(connectionId, options) {
+    const params = new URLSearchParams({ connectionId });
+    if (options?.cursor) params.set("cursor", options.cursor);
+    if (options?.limit) params.set("limit", String(options.limit));
+    return this.http.get(`/integrations/communication/channels?${params}`);
+  }
+  async getChannel(connectionId, id) {
+    return this.http.get(`/integrations/communication/channels/${id}?connectionId=${connectionId}`);
+  }
+  // Messages
+  async listMessages(connectionId, channelId, options) {
+    const params = new URLSearchParams({ connectionId, channelId });
+    if (options?.cursor) params.set("cursor", options.cursor);
+    if (options?.limit) params.set("limit", String(options.limit));
+    return this.http.get(`/integrations/communication/messages?${params}`);
+  }
+  async sendMessage(connectionId, input) {
+    return this.http.post("/integrations/communication/messages", { connectionId, ...input });
+  }
+  // Users
+  async listUsers(connectionId, options) {
+    const params = new URLSearchParams({ connectionId });
+    if (options?.cursor) params.set("cursor", options.cursor);
+    if (options?.limit) params.set("limit", String(options.limit));
+    return this.http.get(`/integrations/communication/users?${params}`);
+  }
+};
+var Productivity = class {
+  http;
+  constructor(http) {
+    this.http = http;
+  }
+  // Documents
+  async listDocuments(connectionId, parentId, options) {
+    const params = new URLSearchParams({ connectionId });
+    if (parentId) params.set("parentId", parentId);
+    if (options?.cursor) params.set("cursor", options.cursor);
+    if (options?.limit) params.set("limit", String(options.limit));
+    return this.http.get(`/integrations/productivity/documents?${params}`);
+  }
+  async getDocument(connectionId, id) {
+    return this.http.get(`/integrations/productivity/documents/${id}?connectionId=${connectionId}`);
+  }
+  async createDocument(connectionId, data) {
+    return this.http.post("/integrations/productivity/documents", { connectionId, ...data });
+  }
+  async updateDocument(connectionId, id, data) {
+    return this.http.patch(`/integrations/productivity/documents/${id}`, { connectionId, ...data });
+  }
+  // Tables
+  async listTables(connectionId, options) {
+    const params = new URLSearchParams({ connectionId });
+    if (options?.cursor) params.set("cursor", options.cursor);
+    if (options?.limit) params.set("limit", String(options.limit));
+    return this.http.get(`/integrations/productivity/tables?${params}`);
+  }
+  async getTable(connectionId, id) {
+    return this.http.get(`/integrations/productivity/tables/${id}?connectionId=${connectionId}`);
+  }
+  // Table Rows
+  async listTableRows(connectionId, tableId, options) {
+    const params = new URLSearchParams({ connectionId });
+    if (options?.cursor) params.set("cursor", options.cursor);
+    if (options?.limit) params.set("limit", String(options.limit));
+    return this.http.get(`/integrations/productivity/tables/${tableId}/rows?${params}`);
+  }
+  async getTableRow(connectionId, tableId, rowId) {
+    return this.http.get(
+      `/integrations/productivity/tables/${tableId}/rows/${rowId}?connectionId=${connectionId}`
+    );
+  }
+  async createTableRow(connectionId, tableId, data) {
+    return this.http.post(`/integrations/productivity/tables/${tableId}/rows`, {
+      connectionId,
+      ...data
+    });
+  }
+  async updateTableRow(connectionId, tableId, rowId, data) {
+    return this.http.patch(`/integrations/productivity/tables/${tableId}/rows/${rowId}`, {
+      connectionId,
+      ...data
+    });
+  }
+  async deleteTableRow(connectionId, tableId, rowId) {
+    return this.http.delete(
+      `/integrations/productivity/tables/${tableId}/rows/${rowId}?connectionId=${connectionId}`
+    );
+  }
+};
+var Integrations = class {
+  http;
+  crm;
+  storage;
+  communication;
+  productivity;
+  constructor(config) {
+    this.http = new HttpClient(config);
+    this.crm = new CRM(this.http);
+    this.storage = new Storage(this.http);
+    this.communication = new Communication(this.http);
+    this.productivity = new Productivity(this.http);
+  }
+  // ============================================================================
+  // CONNECTORS
+  // ============================================================================
+  /**
+   * List all available connectors
+   */
+  async listConnectors(category) {
+    const params = category ? `?category=${category}` : "";
+    return this.http.get(`/integrations/connectors${params}`);
+  }
+  /**
+   * Get a specific connector
+   */
+  async getConnector(slug) {
+    return this.http.get(`/integrations/connectors/${slug}`);
+  }
+  // ============================================================================
+  // CONNECTIONS
+  // ============================================================================
+  /**
+   * List all connections
+   */
+  async listConnections(options) {
+    const params = new URLSearchParams();
+    if (options?.connectorId) params.set("connectorId", options.connectorId);
+    if (options?.status) params.set("status", options.status);
+    const queryString = params.toString();
+    return this.http.get(`/integrations/connections${queryString ? `?${queryString}` : ""}`);
+  }
+  /**
+   * Get a specific connection
+   */
+  async getConnection(id) {
+    return this.http.get(`/integrations/connections/${id}`);
+  }
+  /**
+   * Create a new connection (initiates OAuth flow)
+   * Returns the OAuth authorization URL to redirect the user to
+   */
+  async createConnection(connectorSlug, options) {
+    return this.http.post("/integrations/connections", {
+      connectorSlug,
+      ...options
+    });
+  }
+  /**
+   * Delete a connection
+   */
+  async deleteConnection(id) {
+    return this.http.delete(`/integrations/connections/${id}`);
+  }
+  /**
+   * Test a connection's credentials
+   */
+  async testConnection(id) {
+    return this.http.post(`/integrations/connections/${id}/test`, {});
+  }
+  // ============================================================================
+  // PASSTHROUGH
+  // ============================================================================
+  /**
+   * Make a raw passthrough request to the provider API
+   */
+  async passthrough(request) {
+    return this.http.post("/integrations/passthrough", request);
+  }
+};
+
 // src/index.ts
 var Stack0 = class {
   mail;
   cdn;
+  screenshots;
+  extraction;
+  integrations;
+  /**
+   * @deprecated Use `screenshots` and `extraction` instead. Will be removed in a future version.
+   */
   webdata;
   constructor(config) {
     const clientConfig = {
@@ -999,13 +2181,19 @@ var Stack0 = class {
     };
     this.mail = new Mail(clientConfig);
     this.cdn = new CDN(clientConfig);
+    this.screenshots = new Screenshots(clientConfig);
+    this.extraction = new Extraction(clientConfig);
+    this.integrations = new Integrations(clientConfig);
     this.webdata = new Webdata(clientConfig);
   }
 };
 var src_default = Stack0;
 
 exports.CDN = CDN;
+exports.Extraction = Extraction;
+exports.Integrations = Integrations;
 exports.Mail = Mail;
+exports.Screenshots = Screenshots;
 exports.Stack0 = Stack0;
 exports.Webdata = Webdata;
 exports.default = src_default;