@dealcrawl/sdk 2.0.0

package/dist/sdk/src/client.d.ts

@@ -0,0 +1,285 @@
+/**
+ * DealCrawl SDK Client
+ * Main entry point for the SDK
+ *
+ * @example
+ * ```ts
+ * import { DealCrawl } from "@dealcrawl/sdk";
+ *
+ * const client = new DealCrawl({ apiKey: "sk_xxx" });
+ *
+ * // Scrape a page
+ * const job = await client.scrape.create({
+ *   url: "https://example.com/product",
+ *   extractDeal: true
+ * });
+ *
+ * // Wait for result
+ * const result = await client.waitForResult(job.jobId);
+ * console.log(result);
+ * ```
+ */
+import type { DealCrawlConfig } from "./types/config";
+import type { WaitOptions, WaitResult } from "./utils/polling";
+import { ScrapeResource } from "./resources/scrape";
+import { CrawlResource } from "./resources/crawl";
+import { ExtractResource } from "./resources/extract";
+import { DorkResource } from "./resources/dork";
+import { StatusResource } from "./resources/status";
+import { DataResource } from "./resources/data";
+import { WebhooksResource } from "./resources/webhooks";
+import { KeysResource } from "./resources/keys";
+import { AccountResource } from "./resources/account";
+/**
+ * DealCrawl SDK Client
+ *
+ * Provides access to all DealCrawl API endpoints through
+ * organized resource classes following a Stripe-like pattern.
+ *
+ * @example
+ * ```ts
+ * const client = new DealCrawl({ apiKey: "sk_xxx" });
+ *
+ * // Core operations
+ * await client.scrape.create({ url: "..." });
+ * await client.crawl.create({ url: "...", maxPages: 100 });
+ * await client.extract.create({ url: "...", schema: {...} });
+ * await client.dork.create({ query: "..." });
+ *
+ * // Status & polling
+ * await client.status.get(jobId);
+ * await client.waitForResult(jobId);
+ *
+ * // Data access
+ * await client.data.listJobs();
+ * await client.data.listDeals();
+ *
+ * // Management
+ * await client.webhooks.create({...});
+ * await client.keys.create({...});
+ * await client.account.get();
+ * ```
+ */
+export declare class DealCrawl {
+    /** Internal request context */
+    private readonly ctx;
+    /**
+     * Scrape resource - Single page scraping
+     *
+     * @example
+     * ```ts
+     * const job = await client.scrape.create({
+     *   url: "https://example.com",
+     *   extractDeal: true
+     * });
+     * ```
+     */
+    readonly scrape: ScrapeResource;
+    /**
+     * Crawl resource - Website crawling
+     *
+     * @example
+     * ```ts
+     * const job = await client.crawl.create({
+     *   url: "https://shop.example.com",
+     *   maxPages: 100
+     * });
+     *
+     * // With template
+     * const job = await client.crawl.withTemplate("ecommerce", {
+     *   url: "https://shop.example.com"
+     * });
+     * ```
+     */
+    readonly crawl: CrawlResource;
+    /**
+     * Extract resource - LLM-based structured data extraction
+     *
+     * @example
+     * ```ts
+     * const job = await client.extract.create({
+     *   url: "https://example.com/product",
+     *   schema: { type: "object", properties: {...} }
+     * });
+     * ```
+     */
+    readonly extract: ExtractResource;
+    /**
+     * Dork resource - Google Dork searches
+     *
+     * @example
+     * ```ts
+     * const job = await client.dork.create({
+     *   query: "discount coupon",
+     *   site: "amazon.com"
+     * });
+     * ```
+     */
+    readonly dork: DorkResource;
+    /**
+     * Status resource - Job status management
+     *
+     * @example
+     * ```ts
+     * const status = await client.status.get(jobId);
+     * const deals = await client.status.getDeals(jobId);
+     * await client.status.cancel(jobId);
+     * ```
+     */
+    readonly status: StatusResource;
+    /**
+     * Data resource - Jobs and deals data access
+     *
+     * @example
+     * ```ts
+     * const jobs = await client.data.listJobs();
+     * const deals = await client.data.listDeals({ minScore: 70 });
+     * const stats = await client.data.getStats();
+     * ```
+     */
+    readonly data: DataResource;
+    /**
+     * Webhooks resource - Webhook management
+     *
+     * @example
+     * ```ts
+     * await client.webhooks.create({
+     *   event: "deal.found",
+     *   url: "https://..."
+     * });
+     * ```
+     */
+    readonly webhooks: WebhooksResource;
+    /**
+     * Keys resource - API key management
+     *
+     * @example
+     * ```ts
+     * const newKey = await client.keys.create({
+     *   name: "Production",
+     *   scopes: ["scrape:write"]
+     * });
+     * ```
+     */
+    readonly keys: KeysResource;
+    /**
+     * Account resource - Account info and preferences
+     *
+     * @example
+     * ```ts
+     * const account = await client.account.get();
+     * await client.account.updatePreferences({
+     *   minDealScore: 70
+     * });
+     * ```
+     */
+    readonly account: AccountResource;
+    /**
+     * Create a new DealCrawl client
+     *
+     * @param config - Client configuration
+     *
+     * @example
+     * ```ts
+     * // Minimal config
+     * const client = new DealCrawl({ apiKey: "sk_xxx" });
+     *
+     * // Full config
+     * const client = new DealCrawl({
+     *   apiKey: "sk_xxx",
+     *   baseUrl: "https://api.dealcrawl.dev",
+     *   timeout: 30000,
+     *   maxRetries: 3,
+     *   retryDelay: 1000,
+     *   onRateLimit: (info) => console.log("Rate limited!", info)
+     * });
+     * ```
+     */
+    constructor(config: DealCrawlConfig);
+    /**
+     * Wait for a job to complete
+     * Polls the status endpoint until the job finishes
+     *
+     * @example
+     * ```ts
+     * const job = await client.scrape.create({ url: "..." });
+     *
+     * // Simple wait
+     * const result = await client.waitForResult(job.jobId);
+     *
+     * // With options
+     * const result = await client.waitForResult(job.jobId, {
+     *   pollInterval: 1000,
+     *   timeout: 60000,
+     *   onProgress: (status) => console.log(status.progress)
+     * });
+     * ```
+     */
+    waitForResult<T = unknown>(jobId: string, options?: WaitOptions): Promise<WaitResult<T>>;
+    /**
+     * Wait for multiple jobs to complete
+     * Returns when all jobs are done
+     *
+     * @example
+     * ```ts
+     * const jobs = await Promise.all([
+     *   client.scrape.create({ url: "url1" }),
+     *   client.scrape.create({ url: "url2" }),
+     * ]);
+     *
+     * const results = await client.waitForAll(jobs.map(j => j.jobId));
+     * ```
+     */
+    waitForAll<T = unknown>(jobIds: string[], options?: WaitOptions): Promise<WaitResult<T>[]>;
+    /**
+     * Wait for any job to complete
+     * Returns as soon as one job finishes
+     *
+     * @example
+     * ```ts
+     * const jobIds = ["job1", "job2", "job3"];
+     * const firstResult = await client.waitForAny(jobIds);
+     * ```
+     */
+    waitForAny<T = unknown>(jobIds: string[], options?: WaitOptions): Promise<WaitResult<T>>;
+    /**
+     * Scrape a URL and wait for result
+     * Combines create and waitForResult
+     *
+     * @example
+     * ```ts
+     * const result = await client.scrapeAndWait({
+     *   url: "https://example.com",
+     *   extractDeal: true
+     * });
+     * ```
+     */
+    scrapeAndWait<T = unknown>(options: Parameters<ScrapeResource["create"]>[0], waitOptions?: WaitOptions): Promise<WaitResult<T>>;
+    /**
+     * Crawl a URL and wait for result
+     * Combines create and waitForResult
+     *
+     * @example
+     * ```ts
+     * const result = await client.crawlAndWait({
+     *   url: "https://shop.example.com",
+     *   maxPages: 50
+     * });
+     * ```
+     */
+    crawlAndWait<T = unknown>(options: Parameters<CrawlResource["create"]>[0], waitOptions?: WaitOptions): Promise<WaitResult<T>>;
+    /**
+     * Extract data and wait for result
+     * Combines create and waitForResult
+     *
+     * @example
+     * ```ts
+     * const result = await client.extractAndWait({
+     *   url: "https://example.com/product",
+     *   schema: { type: "object", properties: {...} }
+     * });
+     * ```
+     */
+    extractAndWait<T = unknown>(options: Parameters<ExtractResource["create"]>[0], waitOptions?: WaitOptions): Promise<WaitResult<T>>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/sdk/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/sdk/src/client.js

@@ -0,0 +1,336 @@
+/**
+ * DealCrawl SDK Client
+ * Main entry point for the SDK
+ *
+ * @example
+ * ```ts
+ * import { DealCrawl } from "@dealcrawl/sdk";
+ *
+ * const client = new DealCrawl({ apiKey: "sk_xxx" });
+ *
+ * // Scrape a page
+ * const job = await client.scrape.create({
+ *   url: "https://example.com/product",
+ *   extractDeal: true
+ * });
+ *
+ * // Wait for result
+ * const result = await client.waitForResult(job.jobId);
+ * console.log(result);
+ * ```
+ */
+import { DEFAULT_CONFIG } from "./types/config";
+import { waitForResult, waitForAll, waitForAny } from "./utils/polling";
+// Import resources
+import { ScrapeResource } from "./resources/scrape";
+import { CrawlResource } from "./resources/crawl";
+import { ExtractResource } from "./resources/extract";
+import { DorkResource } from "./resources/dork";
+import { StatusResource } from "./resources/status";
+import { DataResource } from "./resources/data";
+import { WebhooksResource } from "./resources/webhooks";
+import { KeysResource } from "./resources/keys";
+import { AccountResource } from "./resources/account";
+/**
+ * DealCrawl SDK Client
+ *
+ * Provides access to all DealCrawl API endpoints through
+ * organized resource classes following a Stripe-like pattern.
+ *
+ * @example
+ * ```ts
+ * const client = new DealCrawl({ apiKey: "sk_xxx" });
+ *
+ * // Core operations
+ * await client.scrape.create({ url: "..." });
+ * await client.crawl.create({ url: "...", maxPages: 100 });
+ * await client.extract.create({ url: "...", schema: {...} });
+ * await client.dork.create({ query: "..." });
+ *
+ * // Status & polling
+ * await client.status.get(jobId);
+ * await client.waitForResult(jobId);
+ *
+ * // Data access
+ * await client.data.listJobs();
+ * await client.data.listDeals();
+ *
+ * // Management
+ * await client.webhooks.create({...});
+ * await client.keys.create({...});
+ * await client.account.get();
+ * ```
+ */
+export class DealCrawl {
+    /** Internal request context */
+    ctx;
+    // ============================================
+    // RESOURCES
+    // ============================================
+    /**
+     * Scrape resource - Single page scraping
+     *
+     * @example
+     * ```ts
+     * const job = await client.scrape.create({
+     *   url: "https://example.com",
+     *   extractDeal: true
+     * });
+     * ```
+     */
+    scrape;
+    /**
+     * Crawl resource - Website crawling
+     *
+     * @example
+     * ```ts
+     * const job = await client.crawl.create({
+     *   url: "https://shop.example.com",
+     *   maxPages: 100
+     * });
+     *
+     * // With template
+     * const job = await client.crawl.withTemplate("ecommerce", {
+     *   url: "https://shop.example.com"
+     * });
+     * ```
+     */
+    crawl;
+    /**
+     * Extract resource - LLM-based structured data extraction
+     *
+     * @example
+     * ```ts
+     * const job = await client.extract.create({
+     *   url: "https://example.com/product",
+     *   schema: { type: "object", properties: {...} }
+     * });
+     * ```
+     */
+    extract;
+    /**
+     * Dork resource - Google Dork searches
+     *
+     * @example
+     * ```ts
+     * const job = await client.dork.create({
+     *   query: "discount coupon",
+     *   site: "amazon.com"
+     * });
+     * ```
+     */
+    dork;
+    /**
+     * Status resource - Job status management
+     *
+     * @example
+     * ```ts
+     * const status = await client.status.get(jobId);
+     * const deals = await client.status.getDeals(jobId);
+     * await client.status.cancel(jobId);
+     * ```
+     */
+    status;
+    /**
+     * Data resource - Jobs and deals data access
+     *
+     * @example
+     * ```ts
+     * const jobs = await client.data.listJobs();
+     * const deals = await client.data.listDeals({ minScore: 70 });
+     * const stats = await client.data.getStats();
+     * ```
+     */
+    data;
+    /**
+     * Webhooks resource - Webhook management
+     *
+     * @example
+     * ```ts
+     * await client.webhooks.create({
+     *   event: "deal.found",
+     *   url: "https://..."
+     * });
+     * ```
+     */
+    webhooks;
+    /**
+     * Keys resource - API key management
+     *
+     * @example
+     * ```ts
+     * const newKey = await client.keys.create({
+     *   name: "Production",
+     *   scopes: ["scrape:write"]
+     * });
+     * ```
+     */
+    keys;
+    /**
+     * Account resource - Account info and preferences
+     *
+     * @example
+     * ```ts
+     * const account = await client.account.get();
+     * await client.account.updatePreferences({
+     *   minDealScore: 70
+     * });
+     * ```
+     */
+    account;
+    // ============================================
+    // CONSTRUCTOR
+    // ============================================
+    /**
+     * Create a new DealCrawl client
+     *
+     * @param config - Client configuration
+     *
+     * @example
+     * ```ts
+     * // Minimal config
+     * const client = new DealCrawl({ apiKey: "sk_xxx" });
+     *
+     * // Full config
+     * const client = new DealCrawl({
+     *   apiKey: "sk_xxx",
+     *   baseUrl: "https://api.dealcrawl.dev",
+     *   timeout: 30000,
+     *   maxRetries: 3,
+     *   retryDelay: 1000,
+     *   onRateLimit: (info) => console.log("Rate limited!", info)
+     * });
+     * ```
+     */
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new Error("API key is required");
+        }
+        // Build request context
+        this.ctx = {
+            apiKey: config.apiKey,
+            baseUrl: config.baseUrl ?? DEFAULT_CONFIG.baseUrl,
+            timeout: config.timeout ?? DEFAULT_CONFIG.timeout,
+            maxRetries: config.maxRetries ?? DEFAULT_CONFIG.maxRetries,
+            retryDelay: config.retryDelay ?? DEFAULT_CONFIG.retryDelay,
+            onRateLimit: config.onRateLimit,
+        };
+        // Initialize resources
+        this.scrape = new ScrapeResource(this.ctx);
+        this.crawl = new CrawlResource(this.ctx);
+        this.extract = new ExtractResource(this.ctx);
+        this.dork = new DorkResource(this.ctx);
+        this.status = new StatusResource(this.ctx);
+        this.data = new DataResource(this.ctx);
+        this.webhooks = new WebhooksResource(this.ctx);
+        this.keys = new KeysResource(this.ctx);
+        this.account = new AccountResource(this.ctx);
+    }
+    // ============================================
+    // POLLING METHODS
+    // ============================================
+    /**
+     * Wait for a job to complete
+     * Polls the status endpoint until the job finishes
+     *
+     * @example
+     * ```ts
+     * const job = await client.scrape.create({ url: "..." });
+     *
+     * // Simple wait
+     * const result = await client.waitForResult(job.jobId);
+     *
+     * // With options
+     * const result = await client.waitForResult(job.jobId, {
+     *   pollInterval: 1000,
+     *   timeout: 60000,
+     *   onProgress: (status) => console.log(status.progress)
+     * });
+     * ```
+     */
+    async waitForResult(jobId, options) {
+        return waitForResult(this.ctx, jobId, options);
+    }
+    /**
+     * Wait for multiple jobs to complete
+     * Returns when all jobs are done
+     *
+     * @example
+     * ```ts
+     * const jobs = await Promise.all([
+     *   client.scrape.create({ url: "url1" }),
+     *   client.scrape.create({ url: "url2" }),
+     * ]);
+     *
+     * const results = await client.waitForAll(jobs.map(j => j.jobId));
+     * ```
+     */
+    async waitForAll(jobIds, options) {
+        return waitForAll(this.ctx, jobIds, options);
+    }
+    /**
+     * Wait for any job to complete
+     * Returns as soon as one job finishes
+     *
+     * @example
+     * ```ts
+     * const jobIds = ["job1", "job2", "job3"];
+     * const firstResult = await client.waitForAny(jobIds);
+     * ```
+     */
+    async waitForAny(jobIds, options) {
+        return waitForAny(this.ctx, jobIds, options);
+    }
+    // ============================================
+    // CONVENIENCE METHODS
+    // ============================================
+    /**
+     * Scrape a URL and wait for result
+     * Combines create and waitForResult
+     *
+     * @example
+     * ```ts
+     * const result = await client.scrapeAndWait({
+     *   url: "https://example.com",
+     *   extractDeal: true
+     * });
+     * ```
+     */
+    async scrapeAndWait(options, waitOptions) {
+        const job = await this.scrape.create(options);
+        return this.waitForResult(job.jobId, waitOptions);
+    }
+    /**
+     * Crawl a URL and wait for result
+     * Combines create and waitForResult
+     *
+     * @example
+     * ```ts
+     * const result = await client.crawlAndWait({
+     *   url: "https://shop.example.com",
+     *   maxPages: 50
+     * });
+     * ```
+     */
+    async crawlAndWait(options, waitOptions) {
+        const job = await this.crawl.create(options);
+        return this.waitForResult(job.jobId, waitOptions);
+    }
+    /**
+     * Extract data and wait for result
+     * Combines create and waitForResult
+     *
+     * @example
+     * ```ts
+     * const result = await client.extractAndWait({
+     *   url: "https://example.com/product",
+     *   schema: { type: "object", properties: {...} }
+     * });
+     * ```
+     */
+    async extractAndWait(options, waitOptions) {
+        const job = await this.extract.create(options);
+        return this.waitForResult(job.jobId, waitOptions);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/sdk/src/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/sdk/src/error.d.ts

@@ -0,0 +1,54 @@
+import { ERROR_CODES, type ErrorCode } from "@dealcrawl/shared";
+/**
+ * Custom error class for DealCrawl SDK
+ * Provides structured error handling with error codes
+ */
+export declare class DealCrawlError extends Error {
+    /** Error code from ERROR_CODES */
+    readonly code: ErrorCode;
+    /** HTTP status code from the API response */
+    readonly statusCode: number;
+    /** Additional error details */
+    readonly details?: Record<string, unknown>;
+    /** Retry-After header value in seconds (for rate limiting) */
+    readonly retryAfter?: number;
+    constructor(options: {
+        code: ErrorCode;
+        message: string;
+        statusCode?: number;
+        details?: Record<string, unknown>;
+        retryAfter?: number;
+    });
+    /**
+     * Check if the error is retryable
+     * Rate limits and transient errors are retryable
+     */
+    isRetryable(): boolean;
+    /**
+     * Check if the error is due to authentication issues
+     */
+    isAuthError(): boolean;
+    /**
+     * Check if the error is due to rate limiting
+     */
+    isRateLimited(): boolean;
+    /**
+     * Check if the error is due to quota exceeded
+     */
+    isQuotaExceeded(): boolean;
+    /**
+     * Convert error to JSON-serializable object
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Create a DealCrawlError from an API error response
+     */
+    static fromResponse(statusCode: number, body: {
+        code?: string;
+        message?: string;
+        error?: string;
+        details?: Record<string, unknown>;
+    }): DealCrawlError;
+}
+export { ERROR_CODES, type ErrorCode };
+//# sourceMappingURL=error.d.ts.map

package/dist/sdk/src/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAEzB,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3C,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE;QACnB,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAcD;;;OAGG;IACH,WAAW,IAAI,OAAO;IAUtB;;OAEG;IACH,WAAW,IAAI,OAAO;IAUtB;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAWjC;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAC3F,cAAc;CAWlB;AA0BD,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,CAAC"}