@dealcrawl/sdk 2.0.0

package/dist/sdk/src/resources/webhooks.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Webhooks Resource
+ * Handles webhook CRUD operations
+ */
+import type { RequestContext } from "../types/config";
+import type { CreateWebhookOptions, UpdateWebhookOptions } from "../types/options";
+import type { CreateWebhookResponse, ListWebhooksResponse, WebhookItem, UpdateWebhookResponse, DeleteWebhookResponse, TestWebhookResponse } from "../types/responses";
+/**
+ * Webhooks resource class
+ * Provides methods for managing webhooks
+ */
+export declare class WebhooksResource {
+    private ctx;
+    constructor(ctx: RequestContext);
+    /**
+     * Create a new webhook
+     *
+     * @example
+     * ```ts
+     * const webhook = await client.webhooks.create({
+     *   event: "deal.found",
+     *   url: "https://my-server.com/webhooks/deals",
+     *   secret: "my-webhook-secret",
+     *   minDealScore: 70
+     * });
+     * console.log(webhook.webhookId);
+     * ```
+     */
+    create(options: CreateWebhookOptions): Promise<CreateWebhookResponse>;
+    /**
+     * List all webhooks
+     *
+     * @example
+     * ```ts
+     * const webhooks = await client.webhooks.list();
+     * webhooks.webhooks.forEach(w => {
+     *   console.log(w.event, w.url, w.active);
+     * });
+     * ```
+     */
+    list(): Promise<ListWebhooksResponse>;
+    /**
+     * Get a webhook by ID
+     *
+     * @example
+     * ```ts
+     * const webhook = await client.webhooks.get("webhook_abc123");
+     * console.log(webhook.event);
+     * ```
+     */
+    get(webhookId: string): Promise<WebhookItem>;
+    /**
+     * Update a webhook
+     *
+     * @example
+     * ```ts
+     * const updated = await client.webhooks.update("webhook_abc123", {
+     *   minDealScore: 80,
+     *   active: false
+     * });
+     * ```
+     */
+    update(webhookId: string, options: UpdateWebhookOptions): Promise<UpdateWebhookResponse>;
+    /**
+     * Delete a webhook
+     *
+     * @example
+     * ```ts
+     * await client.webhooks.delete("webhook_abc123");
+     * ```
+     */
+    delete(webhookId: string): Promise<DeleteWebhookResponse>;
+    /**
+     * Test a webhook by sending a test payload
+     *
+     * @example
+     * ```ts
+     * const result = await client.webhooks.test("webhook_abc123");
+     * if (result.delivered) {
+     *   console.log(`Delivered in ${result.responseTime}ms`);
+     * } else {
+     *   console.log(`Failed: ${result.error}`);
+     * }
+     * ```
+     */
+    test(webhookId: string): Promise<TestWebhookResponse>;
+    /**
+     * Enable a webhook
+     * Convenience method for activating a webhook
+     *
+     * @example
+     * ```ts
+     * await client.webhooks.enable("webhook_abc123");
+     * ```
+     */
+    enable(webhookId: string): Promise<UpdateWebhookResponse>;
+    /**
+     * Disable a webhook
+     * Convenience method for deactivating a webhook
+     *
+     * @example
+     * ```ts
+     * await client.webhooks.disable("webhook_abc123");
+     * ```
+     */
+    disable(webhookId: string): Promise<UpdateWebhookResponse>;
+    /**
+     * Get active webhooks only
+     *
+     * @example
+     * ```ts
+     * const active = await client.webhooks.getActive();
+     * ```
+     */
+    getActive(): Promise<WebhookItem[]>;
+    /**
+     * Get webhooks by event type
+     *
+     * @example
+     * ```ts
+     * const dealWebhooks = await client.webhooks.getByEvent("deal.found");
+     * ```
+     */
+    getByEvent(event: CreateWebhookOptions["event"]): Promise<WebhookItem[]>;
+}
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/sdk/src/resources/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../../../src/resources/webhooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAG5B;;;GAGG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,cAAc;IAEvC;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAY3E;;;;;;;;;;OAUG;IACG,IAAI,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAK3C;;;;;;;;OAQG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQlD;;;;;;;;;;OAUG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAejC;;;;;;;OAOG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAQ/D;;;;;;;;;;;;OAYG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQ3D;;;;;;;;OAQG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI/D;;;;;;;;OAQG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIhE;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAKzC;;;;;;;OAOG;IACG,UAAU,CACd,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,GACnC,OAAO,CAAC,WAAW,EAAE,CAAC;CAI1B"}

package/dist/sdk/src/resources/webhooks.js

@@ -0,0 +1,167 @@
+/**
+ * Webhooks Resource
+ * Handles webhook CRUD operations
+ */
+import { get, post, patch, del } from "../utils/request";
+/**
+ * Webhooks resource class
+ * Provides methods for managing webhooks
+ */
+export class WebhooksResource {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    /**
+     * Create a new webhook
+     *
+     * @example
+     * ```ts
+     * const webhook = await client.webhooks.create({
+     *   event: "deal.found",
+     *   url: "https://my-server.com/webhooks/deals",
+     *   secret: "my-webhook-secret",
+     *   minDealScore: 70
+     * });
+     * console.log(webhook.webhookId);
+     * ```
+     */
+    async create(options) {
+        const result = await post(this.ctx, "/v1/webhooks", {
+            event: options.event,
+            url: options.url,
+            secret: options.secret,
+            minDealScore: options.minDealScore,
+            categories: options.categories,
+            active: options.active,
+        });
+        return result.data;
+    }
+    /**
+     * List all webhooks
+     *
+     * @example
+     * ```ts
+     * const webhooks = await client.webhooks.list();
+     * webhooks.webhooks.forEach(w => {
+     *   console.log(w.event, w.url, w.active);
+     * });
+     * ```
+     */
+    async list() {
+        const result = await get(this.ctx, "/v1/webhooks");
+        return result.data;
+    }
+    /**
+     * Get a webhook by ID
+     *
+     * @example
+     * ```ts
+     * const webhook = await client.webhooks.get("webhook_abc123");
+     * console.log(webhook.event);
+     * ```
+     */
+    async get(webhookId) {
+        const result = await get(this.ctx, `/v1/webhooks/${webhookId}`);
+        return result.data;
+    }
+    /**
+     * Update a webhook
+     *
+     * @example
+     * ```ts
+     * const updated = await client.webhooks.update("webhook_abc123", {
+     *   minDealScore: 80,
+     *   active: false
+     * });
+     * ```
+     */
+    async update(webhookId, options) {
+        const result = await patch(this.ctx, `/v1/webhooks/${webhookId}`, {
+            url: options.url,
+            secret: options.secret,
+            minDealScore: options.minDealScore,
+            categories: options.categories,
+            active: options.active,
+        });
+        return result.data;
+    }
+    /**
+     * Delete a webhook
+     *
+     * @example
+     * ```ts
+     * await client.webhooks.delete("webhook_abc123");
+     * ```
+     */
+    async delete(webhookId) {
+        const result = await del(this.ctx, `/v1/webhooks/${webhookId}`);
+        return result.data;
+    }
+    /**
+     * Test a webhook by sending a test payload
+     *
+     * @example
+     * ```ts
+     * const result = await client.webhooks.test("webhook_abc123");
+     * if (result.delivered) {
+     *   console.log(`Delivered in ${result.responseTime}ms`);
+     * } else {
+     *   console.log(`Failed: ${result.error}`);
+     * }
+     * ```
+     */
+    async test(webhookId) {
+        const result = await post(this.ctx, `/v1/webhooks/${webhookId}/test`);
+        return result.data;
+    }
+    /**
+     * Enable a webhook
+     * Convenience method for activating a webhook
+     *
+     * @example
+     * ```ts
+     * await client.webhooks.enable("webhook_abc123");
+     * ```
+     */
+    async enable(webhookId) {
+        return this.update(webhookId, { active: true });
+    }
+    /**
+     * Disable a webhook
+     * Convenience method for deactivating a webhook
+     *
+     * @example
+     * ```ts
+     * await client.webhooks.disable("webhook_abc123");
+     * ```
+     */
+    async disable(webhookId) {
+        return this.update(webhookId, { active: false });
+    }
+    /**
+     * Get active webhooks only
+     *
+     * @example
+     * ```ts
+     * const active = await client.webhooks.getActive();
+     * ```
+     */
+    async getActive() {
+        const all = await this.list();
+        return all.webhooks.filter((w) => w.active);
+    }
+    /**
+     * Get webhooks by event type
+     *
+     * @example
+     * ```ts
+     * const dealWebhooks = await client.webhooks.getByEvent("deal.found");
+     * ```
+     */
+    async getByEvent(event) {
+        const all = await this.list();
+        return all.webhooks.filter((w) => w.event === event);
+    }
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/sdk/src/resources/webhooks.js.map

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

package/dist/sdk/src/types/config.d.ts

@@ -0,0 +1,45 @@
+import type { RateLimitInfo } from "@dealcrawl/shared";
+/**
+ * SDK Configuration options
+ */
+export interface DealCrawlConfig {
+    /** API key for authentication (required) */
+    apiKey: string;
+    /** Base URL for the API (default: https://api.dealcrawl.dev) */
+    baseUrl?: string;
+    /** Default timeout for requests in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Maximum number of retries for failed requests (default: 3) */
+    maxRetries?: number;
+    /** Delay between retries in milliseconds (default: 1000) */
+    retryDelay?: number;
+    /** Callback when rate limit is hit */
+    onRateLimit?: (info: RateLimitInfo) => void;
+}
+/**
+ * Internal request context passed to resources
+ */
+export interface RequestContext {
+    /** Base URL for API requests */
+    baseUrl: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** Default timeout in milliseconds */
+    timeout: number;
+    /** Maximum number of retries */
+    maxRetries: number;
+    /** Delay between retries in milliseconds */
+    retryDelay: number;
+    /** Rate limit callback */
+    onRateLimit?: (info: RateLimitInfo) => void;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: {
+    readonly baseUrl: "https://api.dealcrawl.dev";
+    readonly timeout: 30000;
+    readonly maxRetries: 3;
+    readonly retryDelay: 1000;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/sdk/src/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IAEf,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAEhB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IAEf,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IAEnB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC"}

package/dist/sdk/src/types/config.js

@@ -0,0 +1,10 @@
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    baseUrl: "https://api.dealcrawl.dev",
+    timeout: 30000,
+    maxRetries: 3,
+    retryDelay: 1000,
+};
+//# sourceMappingURL=config.js.map

package/dist/sdk/src/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/types/config.ts"],"names":[],"mappings":"AAgDA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,2BAA2B;IACpC,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,IAAI;CACR,CAAC"}

package/dist/sdk/src/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Types barrel export
+ * Re-exports all types from the SDK
+ */
+export * from "./config";
+export * from "./options";
+export * from "./responses";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/sdk/src/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * Types barrel export
+ * Re-exports all types from the SDK
+ */
+export * from "./config";
+export * from "./options";
+export * from "./responses";
+//# sourceMappingURL=index.js.map

package/dist/sdk/src/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/sdk/src/types/options.d.ts

@@ -0,0 +1,286 @@
+/**
+ * SDK Request Options Types
+ * These types define the options for SDK methods
+ */
+/** Screenshot capture options */
+export interface ScreenshotOptions {
+    /** Enable screenshot capture */
+    enabled: boolean;
+    /** Capture full page or viewport only (default: false) */
+    fullPage?: boolean;
+    /** Viewport width in pixels (default: 1280, min: 320, max: 3840) */
+    width?: number;
+    /** Viewport height in pixels (default: 720, min: 240, max: 2160) */
+    height?: number;
+    /** Image format (default: png) */
+    format?: "png" | "jpeg" | "webp";
+    /** JPEG/WebP quality 0-100 (default: 80, only for jpeg/webp) */
+    quality?: number;
+}
+/** Options for scraping a single page */
+export interface ScrapeOptions {
+    /** URL to scrape (required) */
+    url: string;
+    /** Detect signals like prices, discounts, urgency (default: true) */
+    detectSignals?: boolean;
+    /** Extract content using AI */
+    extractWithAI?: boolean;
+    /** Extract deal-specific information (product, price, discount, urgency) */
+    extractDeal?: boolean;
+    /** Use advanced AI model (GPT-4o) for complex pages - higher cost, better quality */
+    useAdvancedModel?: boolean;
+    /** Minimum deal score threshold (0-100) - only returns deals above this score */
+    minDealScore?: number;
+    /** Screenshot configuration */
+    screenshot?: ScreenshotOptions;
+    /** HTML tags to exclude from content (e.g., ["nav", "footer", "aside", "script"]) */
+    excludeTags?: string[];
+    /** CSS selectors to exclude from content (e.g., [".sidebar", "#comments"]) */
+    excludeSelectors?: string[];
+    /** Only extract main content area (default: true) */
+    onlyMainContent?: boolean;
+    /** Custom headers for the request */
+    headers?: Record<string, string>;
+    /** Timeout in milliseconds (default: 30000, max: 120000) */
+    timeout?: number;
+}
+/** Options for crawling a website */
+export interface CrawlOptions {
+    /** Starting URL for the crawl (required) */
+    url: string;
+    /** Alias for url - Starting URL for the crawl */
+    startUrl?: string;
+    /** Prompt to guide the crawl (optional) */
+    prompt?: string;
+    /** Maximum depth to crawl (default: 3, max: 5) */
+    maxDepth?: number;
+    /** Maximum pages to crawl (default: 100, max: 1000) */
+    maxPages?: number;
+    /** Delay between requests in ms (default: 1000, min: 100, max: 10000) */
+    delayMs?: number;
+    /** Detect signals on crawled pages (default: true) */
+    detectSignals?: boolean;
+    /** Extract content using AI */
+    extractWithAI?: boolean;
+    /** Extract deal-specific information from each page */
+    extractDeal?: boolean;
+    /** Minimum deal score threshold (0-100) */
+    minDealScore?: number;
+    /** Prioritize pages likely to contain deals (default: true) */
+    prioritizeDealPages?: boolean;
+    /** Follow links to external domains (default: false) */
+    followExternalLinks?: boolean;
+    /** List of allowed domains to crawl */
+    allowedDomains?: string[];
+    /** URL patterns to exclude from crawling */
+    excludePatterns?: string[];
+}
+/** Crawl template identifier */
+export type CrawlTemplateId = "ecommerce" | "blog" | "docs" | "marketplace" | "custom";
+/** Crawl template definition */
+export interface CrawlTemplate {
+    id: CrawlTemplateId;
+    name: string;
+    description: string;
+    defaultOptions: Partial<CrawlOptions>;
+}
+/** LLM model options for extraction */
+export type ExtractModel = "gpt-4o-mini" | "gpt-4o" | "claude-3-haiku" | "claude-3-sonnet";
+/** Options for structured data extraction */
+export interface ExtractOptions {
+    /** URL to extract data from (required) */
+    url: string;
+    /** JSON Schema for structured extraction */
+    schema?: Record<string, unknown>;
+    /** Natural language prompt for extraction */
+    prompt?: string;
+    /** Extract only main content or full page (default: true) */
+    onlyMainContent?: boolean;
+    /** HTML tags to exclude from content */
+    excludeTags?: string[];
+    /** CSS selectors to exclude from content */
+    excludeSelectors?: string[];
+    /** LLM model to use (default: gpt-4o-mini) */
+    model?: ExtractModel;
+    /** Temperature for LLM (0-1, default: 0.1) */
+    temperature?: number;
+    /** Webhook configuration for async notification */
+    webhook?: {
+        url: string;
+        headers?: Record<string, string>;
+    };
+    /** Custom headers for the scrape request */
+    headers?: Record<string, string>;
+    /** Timeout in milliseconds */
+    timeout?: number;
+}
+/** Options for Google Dork searches */
+export interface DorkOptions {
+    /** Search query (required) */
+    query: string;
+    /** Limit search to specific site */
+    site?: string;
+    /** Search for specific file types */
+    fileType?: string;
+    /** Search for term in URL */
+    inUrl?: string;
+    /** Search for term in title */
+    inTitle?: string;
+    /** Maximum results to return (default: 10, max: 100) */
+    maxResults?: number;
+    /** Region code (2 letter ISO code) */
+    region?: string;
+}
+/** Options for getting job deals */
+export interface GetDealsOptions {
+    /** Minimum deal score to filter by */
+    minScore?: number;
+    /** Maximum number of deals to return (default: 50, max: 100) */
+    limit?: number;
+}
+/** Job status filter options */
+export type JobStatusFilter = "pending" | "active" | "completed" | "failed" | "delayed" | "paused";
+/** Job type filter options */
+export type JobTypeFilter = "scrape" | "crawl" | "dork" | "extract";
+/** Sort order */
+export type SortOrder = "asc" | "desc";
+/** Options for listing jobs */
+export interface ListJobsOptions {
+    /** Page number (default: 1) */
+    page?: number;
+    /** Items per page (default: 20, max: 100) */
+    limit?: number;
+    /** Filter by job status */
+    status?: JobStatusFilter;
+    /** Filter by job type */
+    type?: JobTypeFilter;
+    /** Sort field */
+    sortBy?: "created_at" | "updated_at" | "status";
+    /** Sort order */
+    sortOrder?: SortOrder;
+    /** Filter from date (ISO string) */
+    fromDate?: string;
+    /** Filter to date (ISO string) */
+    toDate?: string;
+}
+/** Options for listing deals */
+export interface ListDealsOptions {
+    /** Page number (default: 1) */
+    page?: number;
+    /** Items per page (default: 20, max: 100) */
+    limit?: number;
+    /** Minimum deal score */
+    minScore?: number;
+    /** Maximum price */
+    maxPrice?: number;
+    /** Filter by category */
+    category?: string;
+    /** Filter by merchant name */
+    merchant?: string;
+    /** Filter by sync status to DealUp */
+    synced?: boolean;
+    /** Sort field */
+    sortBy?: "deal_score" | "current_price" | "discount_percent" | "created_at";
+    /** Sort order */
+    sortOrder?: SortOrder;
+}
+/** Export format options */
+export type ExportFormat = "json" | "csv";
+/** Options for exporting jobs */
+export interface ExportJobsOptions {
+    /** Export format (default: json) */
+    format?: ExportFormat;
+    /** Filter by job status */
+    status?: JobStatusFilter;
+    /** Filter by job type */
+    type?: JobTypeFilter;
+    /** Filter from date (ISO string) */
+    fromDate?: string;
+    /** Filter to date (ISO string) */
+    toDate?: string;
+}
+/** Options for exporting deals */
+export interface ExportDealsOptions {
+    /** Export format (default: json) */
+    format?: ExportFormat;
+    /** Minimum deal score */
+    minScore?: number;
+    /** Maximum price */
+    maxPrice?: number;
+    /** Filter by category */
+    category?: string;
+    /** Include raw signals in export */
+    includeRawSignals?: boolean;
+}
+/** Webhook event types */
+export type WebhookEvent = "deal.found" | "deal.synced" | "crawl.completed" | "crawl.failed";
+/** Options for creating a webhook */
+export interface CreateWebhookOptions {
+    /** Event type to subscribe to */
+    event: WebhookEvent;
+    /** URL to receive webhook notifications */
+    url: string;
+    /** Secret for signature verification */
+    secret?: string;
+    /** Only notify for deals above this score (default: 70) */
+    minDealScore?: number;
+    /** Filter by product categories */
+    categories?: string[];
+    /** Active status (default: true) */
+    active?: boolean;
+}
+/** Options for updating a webhook */
+export interface UpdateWebhookOptions {
+    /** New URL */
+    url?: string;
+    /** New secret */
+    secret?: string;
+    /** New minimum deal score */
+    minDealScore?: number;
+    /** New categories filter */
+    categories?: string[];
+    /** Active status */
+    active?: boolean;
+}
+/** API key scope */
+export type ApiKeyScope = "scrape:read" | "scrape:write" | "crawl:read" | "crawl:write" | "dork:read" | "dork:write" | "data:read" | "data:write" | "webhooks:manage" | "keys:manage" | "account:read" | "account:write";
+/** Options for creating an API key */
+export interface CreateApiKeyOptions {
+    /** Key name/description */
+    name: string;
+    /** Scopes for the key */
+    scopes?: ApiKeyScope[];
+    /** Days until expiration (optional) */
+    expiresInDays?: number;
+    /** IP allowlist (optional) */
+    ipAllowlist?: string[];
+}
+/** Options for rotating an API key */
+export interface RotateApiKeyOptions {
+    /** New name for the rotated key */
+    newName?: string;
+}
+/** Options for listing API keys */
+export interface ListApiKeysOptions {
+    /** Include revoked keys */
+    includeRevoked?: boolean;
+}
+/** Options for getting API key stats */
+export interface GetApiKeyStatsOptions {
+    /** Number of days to get stats for (default: 30) */
+    days?: number;
+}
+/** Product category */
+export type ProductCategory = "courses" | "software" | "physical" | "services" | "other";
+/** Options for updating preferences */
+export interface UpdatePreferencesOptions {
+    /** Preferred product categories */
+    preferredCategories?: ProductCategory[];
+    /** Minimum deal score for notifications */
+    minDealScore?: number;
+    /** Auto-sync deals to DealUp */
+    autoSync?: boolean;
+    /** Enable webhook notifications */
+    webhookEnabled?: boolean;
+}
+//# sourceMappingURL=options.d.ts.map