@dealcrawl/sdk 2.13.0 → 2.14.0

package/dist/index.mjs

@@ -2668,6 +2668,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) {
@@ -3166,6 +3237,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) {
@@ -3690,6 +3871,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
   // ============================================
@@ -3750,6 +3979,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
@@ -3893,6 +4124,6 @@ var DealCrawl = class {
   }
 };
 
-export { AccountResource, AgentResource, AuthResource, ConvertResource, CrawlResource, DEFAULT_CONFIG, DataResource, DealCrawl, DealCrawlError, DorkResource, ERROR_CODES, ERROR_MESSAGES, EventsResource, ExtractResource, KeysResource, ScrapeResource, ScreenshotsResource, SearchResource, StatusResource, WebhooksResource, DealCrawl as default, getErrorMessage, pollUntil, waitForAll, waitForAny, waitForResult };
+export { AccountResource, AgentResource, AuthResource, ConvertResource, CrawlResource, DEFAULT_CONFIG, DataResource, DealCrawl, DealCrawlError, DorkResource, ERROR_CODES, ERROR_MESSAGES, EventsResource, ExtractResource, KeysResource, PostprocessorsResource, ScrapeResource, ScreenshotsResource, SearchResource, StatusResource, UsageResource, WebhooksResource, DealCrawl as default, getErrorMessage, pollUntil, waitForAll, waitForAny, waitForResult };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map