@dealcrawl/sdk 2.12.0 → 2.14.0

package/dist/index.js

@@ -2672,6 +2672,77 @@ var KeysResource = class {
   }
 };
 
+// src/resources/postprocessors.ts
+var PostprocessorsResource = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  /**
+   * List all available postprocessors
+   *
+   * Returns information about each postprocessor including:
+   * - Supported domains
+   * - Extracted fields
+   * - Description
+   *
+   * @example
+   * ```ts
+   * const result = await client.postprocessors.list();
+   * console.log(result.postprocessors);
+   * // [
+   * //   {
+   * //     name: "amazon",
+   * //     domains: ["amazon.com", "amazon.fr", ...],
+   * //     extractedFields: ["productId", "seller", "shipping", ...],
+   * //     description: "Amazon product page enrichment..."
+   * //   },
+   * //   ...
+   * // ]
+   * console.log(result.totalDomains); // 15
+   * ```
+   */
+  async list() {
+    const result = await get(
+      this.ctx,
+      "/v1/postprocessors"
+    );
+    return result.data;
+  }
+  /**
+   * Check which postprocessor applies to a given URL
+   *
+   * Useful for:
+   * - Determining if a URL will be enriched before scraping
+   * - Understanding what data will be extracted
+   * - Filtering URLs by supported sites
+   *
+   * @example
+   * ```ts
+   * // Check Amazon URL
+   * const check = await client.postprocessors.check({
+   *   url: "https://www.amazon.fr/dp/B09V3KXJPB"
+   * });
+   * console.log(check.hasPostprocessor); // true
+   * console.log(check.postprocessor);    // "amazon"
+   * console.log(check.extractedFields);  // ["productId", "seller", "shipping", ...]
+   *
+   * // Check unsupported URL
+   * const noMatch = await client.postprocessors.check({
+   *   url: "https://example.com/product"
+   * });
+   * console.log(noMatch.hasPostprocessor); // false
+   * console.log(noMatch.postprocessor);    // null
+   * ```
+   */
+  async check(options) {
+    const result = await get(
+      this.ctx,
+      `/v1/postprocessors/check?url=${encodeURIComponent(options.url)}`
+    );
+    return result.data;
+  }
+};
+
 // src/resources/scrape.ts
 var ScrapeResource = class {
   constructor(ctx) {
@@ -3170,6 +3241,116 @@ var StatusResource = class {
   }
 };
 
+// src/resources/usage.ts
+var UsageResource = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  /**
+   * Get current usage and quotas
+   *
+   * Returns the current billing period usage statistics including:
+   * - Current usage counts for all operation types
+   * - Quota limits based on tier
+   * - Percentage used for each resource
+   * - Time until quota reset
+   *
+   * @example
+   * ```ts
+   * const usage = await client.usage.current();
+   * console.log(usage.tier);          // "pro"
+   * console.log(usage.usage.scrapes); // 150
+   * console.log(usage.quotas.scrapes); // 10000
+   * console.log(usage.percentUsed.scrapes); // 1.5
+   * console.log(usage.billingPeriod.daysRemaining); // 15
+   * ```
+   */
+  async current() {
+    const result = await get(this.ctx, "/v1/usage");
+    return result.data;
+  }
+  /**
+   * Get historical usage data
+   *
+   * Returns monthly usage snapshots for billing analysis.
+   *
+   * @example
+   * ```ts
+   * const history = await client.usage.history({ months: 6 });
+   * history.data.forEach(period => {
+   *   console.log(`${period.periodStart}: ${period.usage.scrapes} scrapes`);
+   * });
+   * ```
+   */
+  async history(options = {}) {
+    const params = new URLSearchParams();
+    if (options.months) {
+      params.set("months", options.months.toString());
+    }
+    const query = params.toString();
+    const result = await get(
+      this.ctx,
+      `/v1/usage/history${query ? `?${query}` : ""}`
+    );
+    return result.data;
+  }
+  /**
+   * Get LLM token usage summary
+   *
+   * Returns aggregated token consumption and estimated costs.
+   *
+   * @example
+   * ```ts
+   * const tokens = await client.usage.tokens({ days: 30 });
+   * console.log(tokens.totals.totalTokens);      // 1234567
+   * console.log(tokens.totals.estimatedCostUsd); // 12.34
+   * tokens.breakdown.forEach(item => {
+   *   console.log(`${item.provider}/${item.model}: ${item.totalTokens} tokens`);
+   * });
+   * ```
+   */
+  async tokens(options = {}) {
+    const params = new URLSearchParams();
+    if (options.days) {
+      params.set("days", options.days.toString());
+    }
+    if (options.provider) {
+      params.set("provider", options.provider);
+    }
+    const query = params.toString();
+    const result = await get(
+      this.ctx,
+      `/v1/usage/tokens${query ? `?${query}` : ""}`
+    );
+    return result.data;
+  }
+  /**
+   * Get daily token usage breakdown
+   *
+   * Returns day-by-day token consumption for charting.
+   *
+   * @example
+   * ```ts
+   * const daily = await client.usage.dailyTokens({ days: 7 });
+   * daily.daily.forEach(day => {
+   *   console.log(`${day.date}: ${day.totalTokens} tokens ($${day.estimatedCostUsd})`);
+   * });
+   * ```
+   */
+  async dailyTokens(options = {}) {
+    const params = new URLSearchParams();
+    if (options.days) {
+      params.set("days", options.days.toString());
+    }
+    const query = params.toString();
+    const result = await get(
+      this.ctx,
+      `/v1/usage/tokens/daily${query ? `?${query}` : ""}`
+    );
+    return result.data;
+  }
+};
+
 // src/resources/webhooks.ts
 var WebhooksResource = class {
   constructor(ctx) {
@@ -3694,6 +3875,54 @@ var DealCrawl = class {
    * ```
    */
   events;
+  /**
+   * Postprocessors resource - Discover site-specific enrichment postprocessors
+   *
+   * Postprocessors automatically enrich scrape results for supported e-commerce sites
+   * (Amazon, Fnac, eBay) with additional data like seller info, shipping, availability.
+   *
+   * @example
+   * ```ts
+   * // List all available postprocessors
+   * const list = await client.postprocessors.list();
+   * console.log(list.postprocessors);
+   * // [{ name: "amazon", domains: ["amazon.com", ...], extractedFields: [...] }, ...]
+   *
+   * // Check if a URL will be enriched
+   * const check = await client.postprocessors.check({
+   *   url: "https://www.amazon.fr/dp/B09V3KXJPB"
+   * });
+   * console.log(check.hasPostprocessor); // true
+   * console.log(check.postprocessor);    // "amazon"
+   * console.log(check.extractedFields);  // ["productId", "seller", ...]
+   * ```
+   */
+  postprocessors;
+  /**
+   * Usage resource - Monitor usage, quotas, and token consumption
+   *
+   * @example
+   * ```ts
+   * // Get current usage and quotas
+   * const usage = await client.usage.current();
+   * console.log(usage.tier);          // "pro"
+   * console.log(usage.usage.scrapes); // 150
+   * console.log(usage.quotas.scrapes); // 10000
+   * console.log(usage.percentUsed.scrapes); // 1.5
+   *
+   * // Get historical usage
+   * const history = await client.usage.history({ months: 6 });
+   *
+   * // Get LLM token usage
+   * const tokens = await client.usage.tokens({ days: 30 });
+   * console.log(tokens.totals.totalTokens);
+   * console.log(tokens.totals.estimatedCostUsd);
+   *
+   * // Get daily token breakdown
+   * const daily = await client.usage.dailyTokens({ days: 7 });
+   * ```
+   */
+  usage;
   // ============================================
   // CONSTRUCTOR
   // ============================================
@@ -3754,6 +3983,8 @@ var DealCrawl = class {
     this.screenshots = new ScreenshotsResource(this.ctx);
     this.auth = new AuthResource(this.ctx);
     this.events = new EventsResource(this.ctx);
+    this.postprocessors = new PostprocessorsResource(this.ctx);
+    this.usage = new UsageResource(this.ctx);
   }
   // ============================================
   // POLLING METHODS
@@ -3912,10 +4143,12 @@ exports.ERROR_MESSAGES = ERROR_MESSAGES;
 exports.EventsResource = EventsResource;
 exports.ExtractResource = ExtractResource;
 exports.KeysResource = KeysResource;
+exports.PostprocessorsResource = PostprocessorsResource;
 exports.ScrapeResource = ScrapeResource;
 exports.ScreenshotsResource = ScreenshotsResource;
 exports.SearchResource = SearchResource;
 exports.StatusResource = StatusResource;
+exports.UsageResource = UsageResource;
 exports.WebhooksResource = WebhooksResource;
 exports.default = DealCrawl;
 exports.getErrorMessage = getErrorMessage;