@dealcrawl/sdk 2.1.3 → 2.2.0

package/dist/index.js

@@ -1544,11 +1544,21 @@ var KeysResource = class {
    *
    * @example
    * ```ts
+   * // Simple revoke
    * await client.keys.revoke("key_abc123");
+   *
+   * // With reason
+   * await client.keys.revoke("key_abc123", {
+   *   reason: "Key compromised"
+   * });
    * ```
    */
-  async revoke(keyId) {
-    const result = await del(this.ctx, `/v1/keys/${keyId}`);
+  async revoke(keyId, options = {}) {
+    const result = await del(
+      this.ctx,
+      `/v1/keys/${keyId}`,
+      options.reason ? { reason: options.reason } : void 0
+    );
     return result.data;
   }
   /**
@@ -1624,6 +1634,8 @@ var ScrapeResource = class {
       detectSignals: options.detectSignals ?? true,
       extractWithAI: options.extractWithAI,
       extractDeal: options.extractDeal,
+      extractMultipleDeals: options.extractMultipleDeals,
+      maxDeals: options.maxDeals,
       useAdvancedModel: options.useAdvancedModel,
       minDealScore: options.minDealScore,
       screenshot: options.screenshot,
@@ -1652,6 +1664,25 @@ var ScrapeResource = class {
       ...options
     });
   }
+  /**
+   * Scrape a list page and extract multiple deals
+   * Use for category pages, deal lists, search results
+   *
+   * @example
+   * ```ts
+   * const job = await client.scrape.extractDeals(
+   *   "https://amazon.fr/deals",
+   *   { maxDeals: 30, useAdvancedModel: true }
+   * );
+   * ```
+   */
+  async extractDeals(url, options) {
+    return this.create({
+      url,
+      extractMultipleDeals: true,
+      ...options
+    });
+  }
   /**
    * Scrape a URL with screenshot capture
    * Convenience method for screenshot capture
@@ -1674,6 +1705,185 @@ var ScrapeResource = class {
       ...options
     });
   }
+  // ============================================
+  // BATCH SCRAPING METHODS
+  // ============================================
+  /**
+   * Create a batch scrape job for multiple URLs
+   * Scrapes 1-100 URLs in a single request
+   *
+   * @example
+   * ```ts
+   * const batch = await client.scrape.batch({
+   *   urls: [
+   *     { url: "https://shop1.com/product1" },
+   *     { url: "https://shop2.com/deal", extractDeal: true }
+   *   ],
+   *   defaults: { detectSignals: true }
+   * });
+   * console.log(batch.batchId, batch.results);
+   * ```
+   */
+  async batch(options) {
+    const body = {
+      urls: options.urls,
+      defaults: options.defaults,
+      webhookUrl: options.webhookUrl,
+      priority: options.priority,
+      delayMs: options.delay
+    };
+    const result = await post(
+      this.ctx,
+      "/v1/scrape/batch",
+      body
+    );
+    return result.data;
+  }
+  /**
+   * Get status of a batch scrape operation
+   *
+   * @example
+   * ```ts
+   * const status = await client.scrape.getBatchStatus(batchId);
+   * console.log(`Completed: ${status.completed}/${status.total}`);
+   * ```
+   */
+  async getBatchStatus(batchId) {
+    const result = await get(
+      this.ctx,
+      `/v1/scrape/batch/${batchId}`
+    );
+    return result.data;
+  }
+  /**
+   * Batch scrape with deal extraction enabled for all URLs
+   * Convenience method for deal-focused batch scraping
+   *
+   * @example
+   * ```ts
+   * const batch = await client.scrape.batchForDeals([
+   *   "https://shop1.com/sale",
+   *   "https://shop2.com/deals"
+   * ]);
+   * ```
+   */
+  async batchForDeals(urls, options) {
+    return this.batch({
+      urls: urls.map((url) => ({ url })),
+      defaults: {
+        extractDeal: true,
+        detectSignals: true,
+        ...options?.defaults
+      },
+      ...options
+    });
+  }
+};
+
+// src/resources/search.ts
+var SearchResource = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  /**
+   * Create a new search job
+   *
+   * @example
+   * ```ts
+   * const result = await client.search.create({
+   *   query: "laptop deals black friday",
+   *   maxResults: 20,
+   *   useDealScoring: true
+   * });
+   * ```
+   */
+  async create(options) {
+    const body = {
+      query: options.query,
+      limit: options.maxResults,
+      scrapeResults: options.autoScrape,
+      maxScrapeResults: options.autoScrapeLimit,
+      useAiOptimization: options.useAiOptimization,
+      aiProvider: options.aiProvider,
+      aiModel: options.aiModel,
+      useDealScoring: options.useDealScoring,
+      skipCache: options.skipCache,
+      filters: options.filters,
+      webhook: options.webhook
+    };
+    const result = await post(this.ctx, "/v1/search", body);
+    return result.data;
+  }
+  /**
+   * Search with AI query optimization
+   * Convenience method for AI-enhanced searches
+   *
+   * @example
+   * ```ts
+   * const result = await client.search.withAI("iphone discount", {
+   *   aiProvider: "openai",
+   *   aiModel: "gpt-4o-mini"
+   * });
+   * ```
+   */
+  async withAI(query, options) {
+    return this.create({
+      query,
+      useAiOptimization: true,
+      ...options
+    });
+  }
+  /**
+   * Search with deal scoring enabled
+   * Scores each result for deal relevance (0-100)
+   *
+   * @example
+   * ```ts
+   * const result = await client.search.forDeals("gaming laptop");
+   * ```
+   */
+  async forDeals(query, options) {
+    return this.create({
+      query,
+      useDealScoring: true,
+      ...options
+    });
+  }
+  /**
+   * Search and auto-scrape top results
+   * Creates scrape jobs for the best matching URLs
+   *
+   * @example
+   * ```ts
+   * const result = await client.search.andScrape("promo codes", {
+   *   autoScrapeLimit: 5
+   * });
+   * console.log(result.data.scrapedJobIds);
+   * ```
+   */
+  async andScrape(query, options) {
+    return this.create({
+      query,
+      autoScrape: true,
+      ...options
+    });
+  }
+  /**
+   * Check search API status
+   * Returns availability and features info
+   *
+   * @example
+   * ```ts
+   * const status = await client.search.getStatus();
+   * if (status.available) {
+   *   console.log(`Provider: ${status.provider}`);
+   * }
+   * ```
+   */
+  async getStatus() {
+    const result = await get(this.ctx, "/v1/search/status");
+    return result.data;
+  }
 };
 
 // src/resources/status.ts
@@ -1995,17 +2205,38 @@ var DealCrawl = class {
   // RESOURCES
   // ============================================
   /**
-   * Scrape resource - Single page scraping
+   * Scrape resource - Single page and batch scraping
    *
    * @example
    * ```ts
+   * // Single page
    * const job = await client.scrape.create({
    *   url: "https://example.com",
    *   extractDeal: true
    * });
+   *
+   * // Batch scraping
+   * const batch = await client.scrape.batch({
+   *   urls: [{ url: "https://shop1.com" }, { url: "https://shop2.com" }]
+   * });
    * ```
    */
   scrape;
+  /**
+   * Search resource - Web search with AI optimization
+   *
+   * @example
+   * ```ts
+   * const result = await client.search.create({
+   *   query: "laptop deals",
+   *   useDealScoring: true
+   * });
+   *
+   * // With AI optimization
+   * const result = await client.search.withAI("iphone discount");
+   * ```
+   */
+  search;
   /**
    * Crawl resource - Website crawling
    *
@@ -2142,6 +2373,7 @@ var DealCrawl = class {
       onRateLimit: config.onRateLimit
     };
     this.scrape = new ScrapeResource(this.ctx);
+    this.search = new SearchResource(this.ctx);
     this.crawl = new CrawlResource(this.ctx);
     this.extract = new ExtractResource(this.ctx);
     this.dork = new DorkResource(this.ctx);
@@ -2257,6 +2489,22 @@ var DealCrawl = class {
     const job = await this.extract.create(options);
     return this.waitForResult(job.jobId, waitOptions);
   }
+  /**
+   * Search and return results directly
+   * Note: Search is synchronous, no waiting needed
+   *
+   * @example
+   * ```ts
+   * const result = await client.searchAndWait({
+   *   query: "gaming laptop deals",
+   *   useDealScoring: true
+   * });
+   * console.log(result.data.results);
+   * ```
+   */
+  async searchAndWait(options) {
+    return this.search.create(options);
+  }
 };
 
 exports.AccountResource = AccountResource;
@@ -2270,6 +2518,7 @@ exports.ERROR_CODES = ERROR_CODES;
 exports.ExtractResource = ExtractResource;
 exports.KeysResource = KeysResource;
 exports.ScrapeResource = ScrapeResource;
+exports.SearchResource = SearchResource;
 exports.StatusResource = StatusResource;
 exports.WebhooksResource = WebhooksResource;
 exports.default = DealCrawl;