@dealcrawl/sdk 2.6.0 → 2.9.0

package/dist/index.d.mts

@@ -26,6 +26,7 @@ interface PaginatedResponse<T> {
         page: number;
         limit: number;
         total: number;
+        totalPages: number;
         hasMore: boolean;
     };
 }
@@ -97,6 +98,8 @@ interface ParsedPage {
     title?: string;
     description?: string;
     content?: string;
+    /** Markdown version of content (when outputMarkdown is enabled) */
+    markdown?: string;
     language?: string;
     /** @deprecated Use linksMetadata instead */
     links?: string[];
@@ -175,6 +178,10 @@ interface ExtractedDeal {
         category?: string;
         description?: string;
         imageUrl?: string;
+        /** Multiple product images (gallery) */
+        imageUrls?: string[];
+        /** Stored image URL in Supabase Storage */
+        imageStoredUrl?: string;
         sku?: string;
     };
     pricing: {
@@ -299,13 +306,88 @@ interface ValidationError {
     /** Received value */
     received?: unknown;
 }
+/** Base action options for resilience */
+interface ActionBaseOptions {
+    /** Don't fail the job if this action fails */
+    optional?: boolean;
+    /** Number of retries (1-5) */
+    retries?: number;
+    /** Delay before executing action (ms) */
+    delayBefore?: number;
+}
+/** Click action */
+interface ClickAction$1 extends ActionBaseOptions {
+    type: "click";
+    selector: string;
+    waitAfter?: number;
+    button?: "left" | "right" | "middle";
+    clickCount?: number;
+    force?: boolean;
+}
+/** Scroll action */
+interface ScrollAction$1 extends ActionBaseOptions {
+    type: "scroll";
+    direction: "up" | "down" | "left" | "right" | "to-element";
+    selector?: string;
+    amount?: number;
+    smooth?: boolean;
+}
+/** Write action */
+interface WriteAction$1 extends ActionBaseOptions {
+    type: "write";
+    selector: string;
+    text: string;
+    clearFirst?: boolean;
+    pressEnter?: boolean;
+    typeDelay?: number;
+}
+/** Wait action */
+interface WaitAction$1 extends ActionBaseOptions {
+    type: "wait";
+    milliseconds?: number;
+    selector?: string;
+    condition?: "visible" | "hidden" | "attached" | "detached";
+    timeout?: number;
+}
+/** Press action */
+interface PressAction$1 extends ActionBaseOptions {
+    type: "press";
+    key: string;
+    modifiers?: ("Alt" | "Control" | "Meta" | "Shift")[];
+}
+/** Screenshot action */
+interface ScreenshotAction extends ActionBaseOptions {
+    type: "screenshot";
+    fullPage?: boolean;
+    selector?: string;
+    format?: "png" | "jpeg";
+    quality?: number;
+    name?: string;
+}
+/** Hover action */
+interface HoverAction$1 extends ActionBaseOptions {
+    type: "hover";
+    selector: string;
+    duration?: number;
+}
+/** Select action */
+interface SelectAction$1 extends ActionBaseOptions {
+    type: "select";
+    selector: string;
+    value: string | string[];
+    byLabel?: boolean;
+}
+/** Union of all action types */
+type ActionInput = ClickAction$1 | ScrollAction$1 | WriteAction$1 | WaitAction$1 | PressAction$1 | ScreenshotAction | HoverAction$1 | SelectAction$1;
 
 /**
  * SDK Configuration options
  */
 interface DealCrawlConfig {
-    /** API key for authentication (required) */
-    apiKey: string;
+    /** API key for authentication (required unless clientId is provided) */
+    apiKey?: string;
+    /** Client ID for internal authentication (alternative to apiKey) */
+    clientId?: string;
     /** Base URL for the API (default: https://api.dealcrawl.dev) */
     baseUrl?: string;
     /** Default timeout for requests in milliseconds (default: 30000) */
@@ -323,8 +405,10 @@ interface DealCrawlConfig {
 interface RequestContext {
     /** Base URL for API requests */
     baseUrl: string;
-    /** API key for authentication */
-    apiKey: string;
+    /** API key for authentication (optional if clientId is provided) */
+    apiKey?: string;
+    /** Client ID for internal authentication (alternative to apiKey) */
+    clientId?: string;
     /** Default timeout in milliseconds */
     timeout: number;
     /** Maximum number of retries */
@@ -990,6 +1074,7 @@ declare function pollUntil<T>(fetchFn: () => Promise<T>, conditionFn: (data: T)
  * SDK Request Options Types
  * These types define the options for SDK methods
  */
+
 /** Screenshot capture options */
 interface ScreenshotOptions {
     /** Enable screenshot capture */
@@ -1037,6 +1122,12 @@ interface ScrapeOptions {
     headers?: Record<string, string>;
     /** Timeout in milliseconds (default: 30000, max: 120000) */
     timeout?: number;
+    /** Convert content to Markdown (GFM) (default: false) */
+    outputMarkdown?: boolean;
+    /** Base URL for resolving relative URLs in markdown (defaults to scraped URL) */
+    markdownBaseUrl?: string;
+    /** Browser actions to execute before scraping (max: 20) */
+    actions?: ActionInput[];
 }
 /** Individual URL item for batch scraping */
 interface BatchScrapeItem {
@@ -1056,6 +1147,12 @@ interface BatchScrapeItem {
     headers?: Record<string, string>;
     /** Override timeout for this URL */
     timeout?: number;
+    /** Override outputMarkdown for this URL */
+    outputMarkdown?: boolean;
+    /** Override markdownBaseUrl for this URL */
+    markdownBaseUrl?: string;
+    /** Override actions for this URL */
+    actions?: ActionInput[];
 }
 /** Default options applied to all URLs in a batch */
 interface BatchScrapeDefaults {
@@ -1087,6 +1184,12 @@ interface BatchScrapeDefaults {
     headers?: Record<string, string>;
     /** Timeout in milliseconds */
     timeout?: number;
+    /** Convert content to Markdown (GFM) */
+    outputMarkdown?: boolean;
+    /** Base URL for resolving relative URLs in markdown */
+    markdownBaseUrl?: string;
+    /** Browser actions to execute before scraping */
+    actions?: ActionInput[];
 }
 /** Options for batch scraping multiple URLs */
 interface BatchScrapeOptions {
@@ -1211,6 +1314,14 @@ interface CrawlOptions {
     webhookUrl?: string;
     /** Auto-sync discovered deals to DealUp */
     syncToDealup?: boolean;
+    /** Don't save crawl results - Zero Data Retention (Pro/Enterprise only) */
+    noStore?: boolean;
+    /** Download and store product images to Supabase Storage (default: true) */
+    downloadImages?: boolean;
+    /** Maximum images per deal for gallery (default: 5, max: 10) */
+    maxImagesPerDeal?: number;
+    /** Image download timeout in ms (default: 10000) */
+    imageDownloadTimeout?: number;
     /** Site-specific config name from registry */
     siteConfig?: string;
     /** Job template to use (ecommerce, blog, docs, marketplace, custom) */
@@ -1219,6 +1330,10 @@ interface CrawlOptions {
     useSmartRouting?: boolean;
     /** Priority queue override (Enterprise only) */
     priority?: CrawlPriority;
+    /** Convert pages to Markdown (GFM) (default: false) */
+    outputMarkdown?: boolean;
+    /** Base URL for resolving relative URLs in markdown */
+    markdownBaseUrl?: string;
 }
 /** Crawl template identifier */
 type CrawlTemplateId = "ecommerce" | "blog" | "docs" | "marketplace" | "custom";
@@ -3113,9 +3228,12 @@ declare class DealCrawl {
      *
      * @example
      * ```ts
-     * // Minimal config
+     * // With API key
      * const client = new DealCrawl({ apiKey: "sk_xxx" });
      *
+     * // With Client ID (for internal calls)
+     * const client = new DealCrawl({ clientId: "uuid-xxx" });
+     *
      * // Full config
      * const client = new DealCrawl({
      *   apiKey: "sk_xxx",
@@ -3510,4 +3628,4 @@ declare const ERROR_MESSAGES: Record<ErrorCode, string>;
  */
 declare function getErrorMessage(code: ErrorCode): string;
 
-export { ALL_API_KEY_SCOPES, type AccountInfoResponse, type AccountMetricsResponse, AccountResource, type AgentAction, type AgentActionType, type AgentCompletionReason, type AgentJobResponse, type AgentModel, type AgentOptions, AgentResource, type AgentResultResponse, type AgentStatusResponse, type AgentStepResponse, type ApiError, type ApiKeyInfo, type ApiKeyScope, type ApiResponse, type BatchScrapeDefaults, type BatchScrapeItem, type BatchScrapeOptions, type BatchScrapeResponse, type BatchScrapeResultItem, type BatchStatusResponse, type CancelJobResponse, type CheckpointInfo, type ClickAction, type ClientPreferences, type ClientStatsResponse, type CrawlAnalysisResponse, type CrawlError, type CrawlJobResponse, type CrawlMode, type CrawlOptions, type CrawlRecommendation, CrawlResource, type CrawlResult, type CrawlStats, type CrawlTemplate, type CrawlTemplateId, type CreateApiKeyOptions, type CreateKeyResponse, type CreateWebhookOptions, type CreateWebhookResponse, type CreatedApiKey, DEFAULT_API_KEY_SCOPES, DEFAULT_CONFIG, DataResource, DealCrawl, type DealCrawlConfig, DealCrawlError, type DealDetails, type DealItem, type DealMetrics, type DealScoreSummary, type DealSummary, type DealUpMetrics, type DealUpMetricsResponse, type DeleteKeyResponse, type DeleteWebhookResponse, type DiscountSignal, type DorkJobResponse, type DorkOptions, DorkResource, type DorkResult, ERROR_CODES, ERROR_MESSAGES, type EngineSelection, type EngineType, type ErrorCode, type ExportDealsOptions, type ExportFormat, type ExportJobsOptions, type ExtractJobResponse, type ExtractModel, type ExtractOptions, ExtractResource, type ExtractedDeal, type ExtractionErrorDetails, type FallbackConfig, type FallbackMetadata, type FallbackResult, type FallbackSource, type GetApiKeyStatsOptions, type GetDealsOptions, type HoverAction, type JobDealsResponse, type JobMetricsResponse, type JobResponse, type JobStatus, type JobStatusFilter, type JobStatusResponse, type JobSummary, type JobTypeFilter, type KeyStatsResponse, KeysResource, type ListApiKeysOptions, type ListDealsOptions, type ListDealsResponse, type ListJobsOptions, type ListJobsResponse, type ListKeysResponse, type ListWebhooksResponse, type PaginatedResponse, type PaginationInfo, type ParsedPage, type PreferencesResponse, type PressAction, type PriceSignal, type PricingInfo, type ProductCategory, type ProductInfo, type RateLimitInfo, type RecommendationsResponse, type RequestContext, type ResumeJobResponse, type RevokeApiKeyOptions, type RotateApiKeyOptions, type RotateKeyResponse, type ScrapeJobResponse, type ScrapeOptions, ScrapeResource, type ScrapeResult, type ScreenshotAgentAction, type ScreenshotOptions, type ScreenshotResult, type ScrollAction, type SearchAiModel, type SearchAiProvider, type SearchData, type SearchDateRange, type SearchFilters, type SearchJobResponse, type SearchOptions, SearchResource, type SearchResultItem, type SearchStatusResponse, type SelectAction, type Signal, type SortOrder, StatusResource, type TestWebhookResponse, type UpdatePreferencesOptions, type UpdatePreferencesResponse, type UpdateWebhookOptions, type UpdateWebhookResponse, type UrgencyLevel, type UsageStats, type ValidationError, type ValidationResult, type WaitAction, type WaitOptions, type WaitResult, type WebhookEvent, type WebhookItem, WebhooksResource, type WriteAction, DealCrawl as default, getErrorMessage, pollUntil, waitForAll, waitForAny, waitForResult };
+export { ALL_API_KEY_SCOPES, type AccountInfoResponse, type AccountMetricsResponse, AccountResource, type ActionBaseOptions, type ActionInput, type AgentAction, type AgentActionType, type AgentCompletionReason, type AgentJobResponse, type AgentModel, type AgentOptions, AgentResource, type AgentResultResponse, type AgentStatusResponse, type AgentStepResponse, type ApiError, type ApiKeyInfo, type ApiKeyScope, type ApiResponse, type BatchScrapeDefaults, type BatchScrapeItem, type BatchScrapeOptions, type BatchScrapeResponse, type BatchScrapeResultItem, type BatchStatusResponse, type CancelJobResponse, type CheckpointInfo, type ClickAction, type ClientPreferences, type ClientStatsResponse, type CrawlAnalysisResponse, type CrawlError, type CrawlJobResponse, type CrawlMode, type CrawlOptions, type CrawlRecommendation, CrawlResource, type CrawlResult, type CrawlStats, type CrawlTemplate, type CrawlTemplateId, type CreateApiKeyOptions, type CreateKeyResponse, type CreateWebhookOptions, type CreateWebhookResponse, type CreatedApiKey, DEFAULT_API_KEY_SCOPES, DEFAULT_CONFIG, DataResource, DealCrawl, type DealCrawlConfig, DealCrawlError, type DealDetails, type DealItem, type DealMetrics, type DealScoreSummary, type DealSummary, type DealUpMetrics, type DealUpMetricsResponse, type DeleteKeyResponse, type DeleteWebhookResponse, type DiscountSignal, type DorkJobResponse, type DorkOptions, DorkResource, type DorkResult, ERROR_CODES, ERROR_MESSAGES, type EngineSelection, type EngineType, type ErrorCode, type ExportDealsOptions, type ExportFormat, type ExportJobsOptions, type ExtractJobResponse, type ExtractModel, type ExtractOptions, ExtractResource, type ExtractedDeal, type ExtractionErrorDetails, type FallbackConfig, type FallbackMetadata, type FallbackResult, type FallbackSource, type GetApiKeyStatsOptions, type GetDealsOptions, type HoverAction, type JobDealsResponse, type JobMetricsResponse, type JobResponse, type JobStatus, type JobStatusFilter, type JobStatusResponse, type JobSummary, type JobTypeFilter, type KeyStatsResponse, KeysResource, type ListApiKeysOptions, type ListDealsOptions, type ListDealsResponse, type ListJobsOptions, type ListJobsResponse, type ListKeysResponse, type ListWebhooksResponse, type PaginatedResponse, type PaginationInfo, type ParsedPage, type PreferencesResponse, type PressAction, type PriceSignal, type PricingInfo, type ProductCategory, type ProductInfo, type RateLimitInfo, type RecommendationsResponse, type RequestContext, type ResumeJobResponse, type RevokeApiKeyOptions, type RotateApiKeyOptions, type RotateKeyResponse, type ScrapeJobResponse, type ScrapeOptions, ScrapeResource, type ScrapeResult, type ScreenshotAction, type ScreenshotAgentAction, type ScreenshotOptions, type ScreenshotResult, type ScrollAction, type SearchAiModel, type SearchAiProvider, type SearchData, type SearchDateRange, type SearchFilters, type SearchJobResponse, type SearchOptions, SearchResource, type SearchResultItem, type SearchStatusResponse, type SelectAction, type ClickAction$1 as SharedClickAction, type HoverAction$1 as SharedHoverAction, type PressAction$1 as SharedPressAction, type ScrollAction$1 as SharedScrollAction, type SelectAction$1 as SharedSelectAction, type WaitAction$1 as SharedWaitAction, type WriteAction$1 as SharedWriteAction, type Signal, type SortOrder, StatusResource, type TestWebhookResponse, type UpdatePreferencesOptions, type UpdatePreferencesResponse, type UpdateWebhookOptions, type UpdateWebhookResponse, type UrgencyLevel, type UsageStats, type ValidationError, type ValidationResult, type WaitAction, type WaitOptions, type WaitResult, type WebhookEvent, type WebhookItem, WebhooksResource, type WriteAction, DealCrawl as default, getErrorMessage, pollUntil, waitForAll, waitForAny, waitForResult };

package/dist/index.d.ts

@@ -26,6 +26,7 @@ interface PaginatedResponse<T> {
         page: number;
         limit: number;
         total: number;
+        totalPages: number;
         hasMore: boolean;
     };
 }
@@ -97,6 +98,8 @@ interface ParsedPage {
     title?: string;
     description?: string;
     content?: string;
+    /** Markdown version of content (when outputMarkdown is enabled) */
+    markdown?: string;
     language?: string;
     /** @deprecated Use linksMetadata instead */
     links?: string[];
@@ -175,6 +178,10 @@ interface ExtractedDeal {
         category?: string;
         description?: string;
         imageUrl?: string;
+        /** Multiple product images (gallery) */
+        imageUrls?: string[];
+        /** Stored image URL in Supabase Storage */
+        imageStoredUrl?: string;
         sku?: string;
     };
     pricing: {
@@ -299,13 +306,88 @@ interface ValidationError {
     /** Received value */
     received?: unknown;
 }
+/** Base action options for resilience */
+interface ActionBaseOptions {
+    /** Don't fail the job if this action fails */
+    optional?: boolean;
+    /** Number of retries (1-5) */
+    retries?: number;
+    /** Delay before executing action (ms) */
+    delayBefore?: number;
+}
+/** Click action */
+interface ClickAction$1 extends ActionBaseOptions {
+    type: "click";
+    selector: string;
+    waitAfter?: number;
+    button?: "left" | "right" | "middle";
+    clickCount?: number;
+    force?: boolean;
+}
+/** Scroll action */
+interface ScrollAction$1 extends ActionBaseOptions {
+    type: "scroll";
+    direction: "up" | "down" | "left" | "right" | "to-element";
+    selector?: string;
+    amount?: number;
+    smooth?: boolean;
+}
+/** Write action */
+interface WriteAction$1 extends ActionBaseOptions {
+    type: "write";
+    selector: string;
+    text: string;
+    clearFirst?: boolean;
+    pressEnter?: boolean;
+    typeDelay?: number;
+}
+/** Wait action */
+interface WaitAction$1 extends ActionBaseOptions {
+    type: "wait";
+    milliseconds?: number;
+    selector?: string;
+    condition?: "visible" | "hidden" | "attached" | "detached";
+    timeout?: number;
+}
+/** Press action */
+interface PressAction$1 extends ActionBaseOptions {
+    type: "press";
+    key: string;
+    modifiers?: ("Alt" | "Control" | "Meta" | "Shift")[];
+}
+/** Screenshot action */
+interface ScreenshotAction extends ActionBaseOptions {
+    type: "screenshot";
+    fullPage?: boolean;
+    selector?: string;
+    format?: "png" | "jpeg";
+    quality?: number;
+    name?: string;
+}
+/** Hover action */
+interface HoverAction$1 extends ActionBaseOptions {
+    type: "hover";
+    selector: string;
+    duration?: number;
+}
+/** Select action */
+interface SelectAction$1 extends ActionBaseOptions {
+    type: "select";
+    selector: string;
+    value: string | string[];
+    byLabel?: boolean;
+}
+/** Union of all action types */
+type ActionInput = ClickAction$1 | ScrollAction$1 | WriteAction$1 | WaitAction$1 | PressAction$1 | ScreenshotAction | HoverAction$1 | SelectAction$1;
 
 /**
  * SDK Configuration options
  */
 interface DealCrawlConfig {
-    /** API key for authentication (required) */
-    apiKey: string;
+    /** API key for authentication (required unless clientId is provided) */
+    apiKey?: string;
+    /** Client ID for internal authentication (alternative to apiKey) */
+    clientId?: string;
     /** Base URL for the API (default: https://api.dealcrawl.dev) */
     baseUrl?: string;
     /** Default timeout for requests in milliseconds (default: 30000) */
@@ -323,8 +405,10 @@ interface DealCrawlConfig {
 interface RequestContext {
     /** Base URL for API requests */
     baseUrl: string;
-    /** API key for authentication */
-    apiKey: string;
+    /** API key for authentication (optional if clientId is provided) */
+    apiKey?: string;
+    /** Client ID for internal authentication (alternative to apiKey) */
+    clientId?: string;
     /** Default timeout in milliseconds */
     timeout: number;
     /** Maximum number of retries */
@@ -990,6 +1074,7 @@ declare function pollUntil<T>(fetchFn: () => Promise<T>, conditionFn: (data: T)
  * SDK Request Options Types
  * These types define the options for SDK methods
  */
+
 /** Screenshot capture options */
 interface ScreenshotOptions {
     /** Enable screenshot capture */
@@ -1037,6 +1122,12 @@ interface ScrapeOptions {
     headers?: Record<string, string>;
     /** Timeout in milliseconds (default: 30000, max: 120000) */
     timeout?: number;
+    /** Convert content to Markdown (GFM) (default: false) */
+    outputMarkdown?: boolean;
+    /** Base URL for resolving relative URLs in markdown (defaults to scraped URL) */
+    markdownBaseUrl?: string;
+    /** Browser actions to execute before scraping (max: 20) */
+    actions?: ActionInput[];
 }
 /** Individual URL item for batch scraping */
 interface BatchScrapeItem {
@@ -1056,6 +1147,12 @@ interface BatchScrapeItem {
     headers?: Record<string, string>;
     /** Override timeout for this URL */
     timeout?: number;
+    /** Override outputMarkdown for this URL */
+    outputMarkdown?: boolean;
+    /** Override markdownBaseUrl for this URL */
+    markdownBaseUrl?: string;
+    /** Override actions for this URL */
+    actions?: ActionInput[];
 }
 /** Default options applied to all URLs in a batch */
 interface BatchScrapeDefaults {
@@ -1087,6 +1184,12 @@ interface BatchScrapeDefaults {
     headers?: Record<string, string>;
     /** Timeout in milliseconds */
     timeout?: number;
+    /** Convert content to Markdown (GFM) */
+    outputMarkdown?: boolean;
+    /** Base URL for resolving relative URLs in markdown */
+    markdownBaseUrl?: string;
+    /** Browser actions to execute before scraping */
+    actions?: ActionInput[];
 }
 /** Options for batch scraping multiple URLs */
 interface BatchScrapeOptions {
@@ -1211,6 +1314,14 @@ interface CrawlOptions {
     webhookUrl?: string;
     /** Auto-sync discovered deals to DealUp */
     syncToDealup?: boolean;
+    /** Don't save crawl results - Zero Data Retention (Pro/Enterprise only) */
+    noStore?: boolean;
+    /** Download and store product images to Supabase Storage (default: true) */
+    downloadImages?: boolean;
+    /** Maximum images per deal for gallery (default: 5, max: 10) */
+    maxImagesPerDeal?: number;
+    /** Image download timeout in ms (default: 10000) */
+    imageDownloadTimeout?: number;
     /** Site-specific config name from registry */
     siteConfig?: string;
     /** Job template to use (ecommerce, blog, docs, marketplace, custom) */
@@ -1219,6 +1330,10 @@ interface CrawlOptions {
     useSmartRouting?: boolean;
     /** Priority queue override (Enterprise only) */
     priority?: CrawlPriority;
+    /** Convert pages to Markdown (GFM) (default: false) */
+    outputMarkdown?: boolean;
+    /** Base URL for resolving relative URLs in markdown */
+    markdownBaseUrl?: string;
 }
 /** Crawl template identifier */
 type CrawlTemplateId = "ecommerce" | "blog" | "docs" | "marketplace" | "custom";
@@ -3113,9 +3228,12 @@ declare class DealCrawl {
      *
      * @example
      * ```ts
-     * // Minimal config
+     * // With API key
      * const client = new DealCrawl({ apiKey: "sk_xxx" });
      *
+     * // With Client ID (for internal calls)
+     * const client = new DealCrawl({ clientId: "uuid-xxx" });
+     *
      * // Full config
      * const client = new DealCrawl({
      *   apiKey: "sk_xxx",
@@ -3510,4 +3628,4 @@ declare const ERROR_MESSAGES: Record<ErrorCode, string>;
  */
 declare function getErrorMessage(code: ErrorCode): string;
 
-export { ALL_API_KEY_SCOPES, type AccountInfoResponse, type AccountMetricsResponse, AccountResource, type AgentAction, type AgentActionType, type AgentCompletionReason, type AgentJobResponse, type AgentModel, type AgentOptions, AgentResource, type AgentResultResponse, type AgentStatusResponse, type AgentStepResponse, type ApiError, type ApiKeyInfo, type ApiKeyScope, type ApiResponse, type BatchScrapeDefaults, type BatchScrapeItem, type BatchScrapeOptions, type BatchScrapeResponse, type BatchScrapeResultItem, type BatchStatusResponse, type CancelJobResponse, type CheckpointInfo, type ClickAction, type ClientPreferences, type ClientStatsResponse, type CrawlAnalysisResponse, type CrawlError, type CrawlJobResponse, type CrawlMode, type CrawlOptions, type CrawlRecommendation, CrawlResource, type CrawlResult, type CrawlStats, type CrawlTemplate, type CrawlTemplateId, type CreateApiKeyOptions, type CreateKeyResponse, type CreateWebhookOptions, type CreateWebhookResponse, type CreatedApiKey, DEFAULT_API_KEY_SCOPES, DEFAULT_CONFIG, DataResource, DealCrawl, type DealCrawlConfig, DealCrawlError, type DealDetails, type DealItem, type DealMetrics, type DealScoreSummary, type DealSummary, type DealUpMetrics, type DealUpMetricsResponse, type DeleteKeyResponse, type DeleteWebhookResponse, type DiscountSignal, type DorkJobResponse, type DorkOptions, DorkResource, type DorkResult, ERROR_CODES, ERROR_MESSAGES, type EngineSelection, type EngineType, type ErrorCode, type ExportDealsOptions, type ExportFormat, type ExportJobsOptions, type ExtractJobResponse, type ExtractModel, type ExtractOptions, ExtractResource, type ExtractedDeal, type ExtractionErrorDetails, type FallbackConfig, type FallbackMetadata, type FallbackResult, type FallbackSource, type GetApiKeyStatsOptions, type GetDealsOptions, type HoverAction, type JobDealsResponse, type JobMetricsResponse, type JobResponse, type JobStatus, type JobStatusFilter, type JobStatusResponse, type JobSummary, type JobTypeFilter, type KeyStatsResponse, KeysResource, type ListApiKeysOptions, type ListDealsOptions, type ListDealsResponse, type ListJobsOptions, type ListJobsResponse, type ListKeysResponse, type ListWebhooksResponse, type PaginatedResponse, type PaginationInfo, type ParsedPage, type PreferencesResponse, type PressAction, type PriceSignal, type PricingInfo, type ProductCategory, type ProductInfo, type RateLimitInfo, type RecommendationsResponse, type RequestContext, type ResumeJobResponse, type RevokeApiKeyOptions, type RotateApiKeyOptions, type RotateKeyResponse, type ScrapeJobResponse, type ScrapeOptions, ScrapeResource, type ScrapeResult, type ScreenshotAgentAction, type ScreenshotOptions, type ScreenshotResult, type ScrollAction, type SearchAiModel, type SearchAiProvider, type SearchData, type SearchDateRange, type SearchFilters, type SearchJobResponse, type SearchOptions, SearchResource, type SearchResultItem, type SearchStatusResponse, type SelectAction, type Signal, type SortOrder, StatusResource, type TestWebhookResponse, type UpdatePreferencesOptions, type UpdatePreferencesResponse, type UpdateWebhookOptions, type UpdateWebhookResponse, type UrgencyLevel, type UsageStats, type ValidationError, type ValidationResult, type WaitAction, type WaitOptions, type WaitResult, type WebhookEvent, type WebhookItem, WebhooksResource, type WriteAction, DealCrawl as default, getErrorMessage, pollUntil, waitForAll, waitForAny, waitForResult };
+export { ALL_API_KEY_SCOPES, type AccountInfoResponse, type AccountMetricsResponse, AccountResource, type ActionBaseOptions, type ActionInput, type AgentAction, type AgentActionType, type AgentCompletionReason, type AgentJobResponse, type AgentModel, type AgentOptions, AgentResource, type AgentResultResponse, type AgentStatusResponse, type AgentStepResponse, type ApiError, type ApiKeyInfo, type ApiKeyScope, type ApiResponse, type BatchScrapeDefaults, type BatchScrapeItem, type BatchScrapeOptions, type BatchScrapeResponse, type BatchScrapeResultItem, type BatchStatusResponse, type CancelJobResponse, type CheckpointInfo, type ClickAction, type ClientPreferences, type ClientStatsResponse, type CrawlAnalysisResponse, type CrawlError, type CrawlJobResponse, type CrawlMode, type CrawlOptions, type CrawlRecommendation, CrawlResource, type CrawlResult, type CrawlStats, type CrawlTemplate, type CrawlTemplateId, type CreateApiKeyOptions, type CreateKeyResponse, type CreateWebhookOptions, type CreateWebhookResponse, type CreatedApiKey, DEFAULT_API_KEY_SCOPES, DEFAULT_CONFIG, DataResource, DealCrawl, type DealCrawlConfig, DealCrawlError, type DealDetails, type DealItem, type DealMetrics, type DealScoreSummary, type DealSummary, type DealUpMetrics, type DealUpMetricsResponse, type DeleteKeyResponse, type DeleteWebhookResponse, type DiscountSignal, type DorkJobResponse, type DorkOptions, DorkResource, type DorkResult, ERROR_CODES, ERROR_MESSAGES, type EngineSelection, type EngineType, type ErrorCode, type ExportDealsOptions, type ExportFormat, type ExportJobsOptions, type ExtractJobResponse, type ExtractModel, type ExtractOptions, ExtractResource, type ExtractedDeal, type ExtractionErrorDetails, type FallbackConfig, type FallbackMetadata, type FallbackResult, type FallbackSource, type GetApiKeyStatsOptions, type GetDealsOptions, type HoverAction, type JobDealsResponse, type JobMetricsResponse, type JobResponse, type JobStatus, type JobStatusFilter, type JobStatusResponse, type JobSummary, type JobTypeFilter, type KeyStatsResponse, KeysResource, type ListApiKeysOptions, type ListDealsOptions, type ListDealsResponse, type ListJobsOptions, type ListJobsResponse, type ListKeysResponse, type ListWebhooksResponse, type PaginatedResponse, type PaginationInfo, type ParsedPage, type PreferencesResponse, type PressAction, type PriceSignal, type PricingInfo, type ProductCategory, type ProductInfo, type RateLimitInfo, type RecommendationsResponse, type RequestContext, type ResumeJobResponse, type RevokeApiKeyOptions, type RotateApiKeyOptions, type RotateKeyResponse, type ScrapeJobResponse, type ScrapeOptions, ScrapeResource, type ScrapeResult, type ScreenshotAction, type ScreenshotAgentAction, type ScreenshotOptions, type ScreenshotResult, type ScrollAction, type SearchAiModel, type SearchAiProvider, type SearchData, type SearchDateRange, type SearchFilters, type SearchJobResponse, type SearchOptions, SearchResource, type SearchResultItem, type SearchStatusResponse, type SelectAction, type ClickAction$1 as SharedClickAction, type HoverAction$1 as SharedHoverAction, type PressAction$1 as SharedPressAction, type ScrollAction$1 as SharedScrollAction, type SelectAction$1 as SharedSelectAction, type WaitAction$1 as SharedWaitAction, type WriteAction$1 as SharedWriteAction, type Signal, type SortOrder, StatusResource, type TestWebhookResponse, type UpdatePreferencesOptions, type UpdatePreferencesResponse, type UpdateWebhookOptions, type UpdateWebhookResponse, type UrgencyLevel, type UsageStats, type ValidationError, type ValidationResult, type WaitAction, type WaitOptions, type WaitResult, type WebhookEvent, type WebhookItem, WebhooksResource, type WriteAction, DealCrawl as default, getErrorMessage, pollUntil, waitForAll, waitForAny, waitForResult };

package/dist/index.js

@@ -477,12 +477,17 @@ async function request(ctx, path, options = {}) {
       currentController = null;
     };
     try {
+      const headers = {
+        "Content-Type": "application/json"
+      };
+      if (ctx.apiKey) {
+        headers["Authorization"] = `Bearer ${ctx.apiKey}`;
+      } else if (ctx.clientId) {
+        headers["X-Client-ID"] = ctx.clientId;
+      }
       const response = await fetch(url, {
         method,
-        headers: {
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${ctx.apiKey}`
-        },
+        headers,
         body: body ? JSON.stringify(body) : void 0,
         signal: controller.signal
       });
@@ -2897,9 +2902,12 @@ var DealCrawl = class {
    *
    * @example
    * ```ts
-   * // Minimal config
+   * // With API key
    * const client = new DealCrawl({ apiKey: "sk_xxx" });
    *
+   * // With Client ID (for internal calls)
+   * const client = new DealCrawl({ clientId: "uuid-xxx" });
+   *
    * // Full config
    * const client = new DealCrawl({
    *   apiKey: "sk_xxx",
@@ -2912,11 +2920,17 @@ var DealCrawl = class {
    * ```
    */
   constructor(config) {
-    if (!config.apiKey || !config.apiKey.trim()) {
-      throw new Error("API key is required");
+    const hasApiKey = config.apiKey && config.apiKey.trim();
+    const hasClientId = config.clientId && config.clientId.trim();
+    if (!hasApiKey && !hasClientId) {
+      throw new Error("Either API key or Client ID is required");
+    }
+    if (hasApiKey && hasClientId) {
+      throw new Error("Provide either API key OR Client ID, not both");
     }
     this.ctx = {
       apiKey: config.apiKey,
+      clientId: config.clientId,
       baseUrl: config.baseUrl ?? DEFAULT_CONFIG.baseUrl,
       timeout: config.timeout ?? DEFAULT_CONFIG.timeout,
       maxRetries: config.maxRetries ?? DEFAULT_CONFIG.maxRetries,