@dealcrawl/sdk 2.0.0

package/dist/sdk/src/error.js

@@ -0,0 +1,115 @@
+import { ERROR_CODES } from "@dealcrawl/shared";
+/**
+ * Custom error class for DealCrawl SDK
+ * Provides structured error handling with error codes
+ */
+export class DealCrawlError extends Error {
+    /** Error code from ERROR_CODES */
+    code;
+    /** HTTP status code from the API response */
+    statusCode;
+    /** Additional error details */
+    details;
+    /** Retry-After header value in seconds (for rate limiting) */
+    retryAfter;
+    constructor(options) {
+        super(options.message);
+        this.name = "DealCrawlError";
+        this.code = options.code;
+        this.statusCode = options.statusCode ?? 500;
+        this.details = options.details;
+        this.retryAfter = options.retryAfter;
+        // Maintains proper stack trace for where our error was thrown
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, DealCrawlError);
+        }
+    }
+    /**
+     * Check if the error is retryable
+     * Rate limits and transient errors are retryable
+     */
+    isRetryable() {
+        const retryableCodes = [
+            ERROR_CODES.RATE_LIMIT_EXCEEDED,
+            ERROR_CODES.SERVICE_UNAVAILABLE,
+            ERROR_CODES.REDIS_ERROR,
+            ERROR_CODES.DATABASE_ERROR,
+        ];
+        return retryableCodes.includes(this.code);
+    }
+    /**
+     * Check if the error is due to authentication issues
+     */
+    isAuthError() {
+        const authCodes = [
+            ERROR_CODES.INVALID_API_KEY,
+            ERROR_CODES.MISSING_API_KEY,
+            ERROR_CODES.API_KEY_EXPIRED,
+            ERROR_CODES.ACCOUNT_SUSPENDED,
+        ];
+        return authCodes.includes(this.code);
+    }
+    /**
+     * Check if the error is due to rate limiting
+     */
+    isRateLimited() {
+        return this.code === ERROR_CODES.RATE_LIMIT_EXCEEDED;
+    }
+    /**
+     * Check if the error is due to quota exceeded
+     */
+    isQuotaExceeded() {
+        return this.code === ERROR_CODES.QUOTA_EXCEEDED;
+    }
+    /**
+     * Convert error to JSON-serializable object
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            statusCode: this.statusCode,
+            details: this.details,
+            retryAfter: this.retryAfter,
+        };
+    }
+    /**
+     * Create a DealCrawlError from an API error response
+     */
+    static fromResponse(statusCode, body) {
+        const code = body.code || mapStatusCodeToErrorCode(statusCode);
+        const message = body.message || body.error || "An error occurred";
+        return new DealCrawlError({
+            code,
+            message,
+            statusCode,
+            details: body.details,
+        });
+    }
+}
+/**
+ * Map HTTP status codes to error codes
+ */
+function mapStatusCodeToErrorCode(statusCode) {
+    switch (statusCode) {
+        case 400:
+            return ERROR_CODES.INVALID_REQUEST;
+        case 401:
+            return ERROR_CODES.INVALID_API_KEY;
+        case 403:
+            return ERROR_CODES.ACCOUNT_SUSPENDED;
+        case 404:
+            return ERROR_CODES.JOB_NOT_FOUND;
+        case 429:
+            return ERROR_CODES.RATE_LIMIT_EXCEEDED;
+        case 500:
+            return ERROR_CODES.INTERNAL_ERROR;
+        case 503:
+            return ERROR_CODES.SERVICE_UNAVAILABLE;
+        default:
+            return ERROR_CODES.INTERNAL_ERROR;
+    }
+}
+export { ERROR_CODES };
+//# sourceMappingURL=error.js.map

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

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

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

@@ -0,0 +1,58 @@
+/**
+ * DealCrawl SDK
+ *
+ * Official SDK for the DealCrawl web scraping and crawling API.
+ *
+ * @packageDocumentation
+ *
+ * @example Basic usage
+ * ```ts
+ * import { DealCrawl } from "@dealcrawl/sdk";
+ *
+ * const client = new DealCrawl({ apiKey: "sk_xxx" });
+ *
+ * // Scrape a single 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);
+ * ```
+ *
+ * @example Crawl with template
+ * ```ts
+ * const job = await client.crawl.withTemplate("ecommerce", {
+ *   url: "https://shop.example.com",
+ *   maxPages: 100
+ * });
+ * ```
+ *
+ * @example Extract structured data
+ * ```ts
+ * const job = await client.extract.withSchema(
+ *   "https://example.com/product",
+ *   {
+ *     type: "object",
+ *     properties: {
+ *       name: { type: "string" },
+ *       price: { type: "number" }
+ *     }
+ *   }
+ * );
+ * ```
+ */
+export { DealCrawl } from "./client";
+export { DealCrawlError, ERROR_CODES, type ErrorCode } from "./error";
+export { ScrapeResource, CrawlResource, ExtractResource, DorkResource, StatusResource, DataResource, WebhooksResource, KeysResource, AccountResource, } from "./resources";
+export type { DealCrawlConfig, RequestContext } from "./types/config";
+export { DEFAULT_CONFIG } from "./types/config";
+export type { ScreenshotOptions, ScrapeOptions, CrawlOptions, CrawlTemplate, CrawlTemplateId, ExtractOptions, ExtractModel, DorkOptions, GetDealsOptions, JobStatusFilter, JobTypeFilter, SortOrder, ListJobsOptions, ListDealsOptions, ExportFormat, ExportJobsOptions, ExportDealsOptions, WebhookEvent, CreateWebhookOptions, UpdateWebhookOptions, ApiKeyScope, CreateApiKeyOptions, RotateApiKeyOptions, ListApiKeysOptions, GetApiKeyStatsOptions, ProductCategory, UpdatePreferencesOptions, } from "./types/options";
+export type { JobResponse, PaginationInfo, ScrapeJobResponse, CrawlJobResponse, CrawlAnalysisResponse, ExtractJobResponse, DorkJobResponse, DealMetrics, CheckpointInfo, JobStatusResponse, JobDealsResponse, DealSummary, ResumeJobResponse, JobMetricsResponse, CancelJobResponse, JobSummary, ListJobsResponse, ProductInfo, PricingInfo, DealItem, ListDealsResponse, DealDetails, ClientStatsResponse, WebhookItem, CreateWebhookResponse, ListWebhooksResponse, UpdateWebhookResponse, DeleteWebhookResponse, TestWebhookResponse, ApiKeyInfo, CreatedApiKey, ListKeysResponse, CreateKeyResponse, RotateKeyResponse, DeleteKeyResponse, KeyStatsResponse, UsageStats, ClientPreferences, AccountInfoResponse, AccountMetricsResponse, DealUpMetrics, DealUpMetricsResponse, CrawlRecommendation, RecommendationsResponse, PreferencesResponse, UpdatePreferencesResponse, } from "./types/responses";
+export type { WaitOptions, WaitResult } from "./utils/polling";
+export { waitForResult, waitForAll, waitForAny, pollUntil, } from "./utils/polling";
+export type { JobStatus, RateLimitInfo, PaginatedResponse, ApiResponse, ApiError, ScrapeResult, CrawlResult, DorkResult, ExtractedDeal, DealScoreSummary, Signal, PriceSignal, DiscountSignal, ParsedPage, } from "@dealcrawl/shared";
+export { DealCrawl as default } from "./client";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAMH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAMrC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAMtE,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,aAAa,CAAC;AAMrB,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMhD,YAAY,EAEV,iBAAiB,EACjB,aAAa,EAEb,YAAY,EACZ,aAAa,EACb,eAAe,EAEf,cAAc,EACd,YAAY,EAEZ,WAAW,EAEX,eAAe,EAEf,eAAe,EACf,aAAa,EACb,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAElB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EAEpB,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EAErB,eAAe,EACf,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAMzB,YAAY,EAEV,WAAW,EACX,cAAc,EAEd,iBAAiB,EAEjB,gBAAgB,EAChB,qBAAqB,EAErB,kBAAkB,EAElB,eAAe,EAEf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EAEjB,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EAEnB,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EAEnB,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAEhB,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAM3B,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EACL,aAAa,EACb,UAAU,EACV,UAAU,EACV,SAAS,GACV,MAAM,iBAAiB,CAAC;AAOzB,YAAY,EAEV,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,QAAQ,EAER,YAAY,EACZ,WAAW,EACX,UAAU,EAEV,aAAa,EACb,gBAAgB,EAEhB,MAAM,EACN,WAAW,EACX,cAAc,EAEd,UAAU,GACX,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EAAE,SAAS,IAAI,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/sdk/src/index.js

@@ -0,0 +1,65 @@
+/**
+ * DealCrawl SDK
+ *
+ * Official SDK for the DealCrawl web scraping and crawling API.
+ *
+ * @packageDocumentation
+ *
+ * @example Basic usage
+ * ```ts
+ * import { DealCrawl } from "@dealcrawl/sdk";
+ *
+ * const client = new DealCrawl({ apiKey: "sk_xxx" });
+ *
+ * // Scrape a single 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);
+ * ```
+ *
+ * @example Crawl with template
+ * ```ts
+ * const job = await client.crawl.withTemplate("ecommerce", {
+ *   url: "https://shop.example.com",
+ *   maxPages: 100
+ * });
+ * ```
+ *
+ * @example Extract structured data
+ * ```ts
+ * const job = await client.extract.withSchema(
+ *   "https://example.com/product",
+ *   {
+ *     type: "object",
+ *     properties: {
+ *       name: { type: "string" },
+ *       price: { type: "number" }
+ *     }
+ *   }
+ * );
+ * ```
+ */
+// ============================================
+// MAIN CLIENT
+// ============================================
+export { DealCrawl } from "./client";
+// ============================================
+// ERROR HANDLING
+// ============================================
+export { DealCrawlError, ERROR_CODES } from "./error";
+// ============================================
+// RESOURCE CLASSES
+// ============================================
+export { ScrapeResource, CrawlResource, ExtractResource, DorkResource, StatusResource, DataResource, WebhooksResource, KeysResource, AccountResource, } from "./resources";
+export { DEFAULT_CONFIG } from "./types/config";
+export { waitForResult, waitForAll, waitForAny, pollUntil, } from "./utils/polling";
+// ============================================
+// DEFAULT EXPORT
+// ============================================
+export { DealCrawl as default } from "./client";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,+CAA+C;AAC/C,cAAc;AACd,+CAA+C;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,+CAA+C;AAC/C,iBAAiB;AACjB,+CAA+C;AAE/C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAkB,MAAM,SAAS,CAAC;AAEtE,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,aAAa,CAAC;AAOrB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAiHhD,OAAO,EACL,aAAa,EACb,UAAU,EACV,UAAU,EACV,SAAS,GACV,MAAM,iBAAiB,CAAC;AA6BzB,+CAA+C;AAC/C,iBAAiB;AACjB,+CAA+C;AAE/C,OAAO,EAAE,SAAS,IAAI,OAAO,EAAE,MAAM,UAAU,CAAC"}

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

@@ -0,0 +1,143 @@
+/**
+ * Account Resource
+ * Handles account information and preferences
+ */
+import type { RequestContext } from "../types/config";
+import type { UpdatePreferencesOptions } from "../types/options";
+import type { AccountInfoResponse, AccountMetricsResponse, DealUpMetricsResponse, RecommendationsResponse, PreferencesResponse, UpdatePreferencesResponse } from "../types/responses";
+/**
+ * Account resource class
+ * Provides methods for account information and preferences
+ */
+export declare class AccountResource {
+    private ctx;
+    constructor(ctx: RequestContext);
+    /**
+     * Get current account information
+     *
+     * @example
+     * ```ts
+     * const account = await client.account.get();
+     * console.log(account.name);
+     * console.log(account.tier);
+     * console.log(account.usage);
+     * ```
+     */
+    get(): Promise<AccountInfoResponse>;
+    /**
+     * Get detailed account metrics
+     *
+     * @example
+     * ```ts
+     * const metrics = await client.account.getMetrics();
+     * console.log(metrics.dealMetrics.totalDeals);
+     * console.log(metrics.categoryPerformance);
+     * ```
+     */
+    getMetrics(): Promise<AccountMetricsResponse>;
+    /**
+     * Get DealUp sync metrics (pro/enterprise only)
+     *
+     * @example
+     * ```ts
+     * const dealup = await client.account.getDealUpMetrics();
+     * console.log(dealup.sync.totalSynced);
+     * console.log(dealup.sync.clicksGenerated);
+     * ```
+     */
+    getDealUpMetrics(): Promise<DealUpMetricsResponse>;
+    /**
+     * Get crawl recommendations
+     * AI-suggested URLs to crawl based on past performance
+     *
+     * @example
+     * ```ts
+     * const recommendations = await client.account.getRecommendations();
+     * recommendations.recommendations.forEach(r => {
+     *   console.log(r.url, r.reason, r.estimatedDeals);
+     * });
+     * ```
+     */
+    getRecommendations(): Promise<RecommendationsResponse>;
+    /**
+     * Get current preferences
+     *
+     * @example
+     * ```ts
+     * const prefs = await client.account.getPreferences();
+     * console.log(prefs.preferences.minDealScore);
+     * console.log(prefs.preferences.autoSync);
+     * ```
+     */
+    getPreferences(): Promise<PreferencesResponse>;
+    /**
+     * Update account preferences
+     *
+     * @example
+     * ```ts
+     * const updated = await client.account.updatePreferences({
+     *   minDealScore: 70,
+     *   autoSync: true,
+     *   preferredCategories: ["software", "courses"]
+     * });
+     * ```
+     */
+    updatePreferences(options: UpdatePreferencesOptions): Promise<UpdatePreferencesResponse>;
+    /**
+     * Track a DealUp click (webhook endpoint)
+     * Used internally by DealUp to track click-through
+     *
+     * @example
+     * ```ts
+     * await client.account.trackClick("deal_abc123", "homepage");
+     * ```
+     */
+    trackClick(dealId: string, source?: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get remaining quota for a resource
+     *
+     * @example
+     * ```ts
+     * const remaining = await client.account.getRemainingQuota("scrapes");
+     * console.log(`${remaining} scrapes left this period`);
+     * ```
+     */
+    getRemainingQuota(resource: "scrapes" | "crawls" | "dorks"): Promise<number>;
+    /**
+     * Check if account has quota for a resource
+     *
+     * @example
+     * ```ts
+     * if (await client.account.hasQuota("crawls", 5)) {
+     *   // Safe to start 5 crawls
+     * }
+     * ```
+     */
+    hasQuota(resource: "scrapes" | "crawls" | "dorks", needed?: number): Promise<boolean>;
+    /**
+     * Get account tier
+     *
+     * @example
+     * ```ts
+     * const tier = await client.account.getTier();
+     * if (tier === "enterprise") {
+     *   // Enable advanced features
+     * }
+     * ```
+     */
+    getTier(): Promise<"free" | "pro" | "enterprise">;
+    /**
+     * Check if account is pro or enterprise tier
+     *
+     * @example
+     * ```ts
+     * if (await client.account.isPremium()) {
+     *   // Show premium features
+     * }
+     * ```
+     */
+    isPremium(): Promise<boolean>;
+}
+//# sourceMappingURL=account.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../../../src/resources/account.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,oBAAoB,CAAC;AAG5B;;;GAGG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,cAAc;IAEvC;;;;;;;;;;OAUG;IACG,GAAG,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAKzC;;;;;;;;;OASG;IACG,UAAU,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAQnD;;;;;;;;;OASG;IACG,gBAAgB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAQxD;;;;;;;;;;;OAWG;IACG,kBAAkB,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAQ5D;;;;;;;;;OASG;IACG,cAAc,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAQpD;;;;;;;;;;;OAWG;IACG,iBAAiB,CACrB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,yBAAyB,CAAC;IAcrC;;;;;;;;OAQG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAgBhC;;;;;;;;OAQG;IACG,iBAAiB,CACrB,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,GACvC,OAAO,CAAC,MAAM,CAAC;IAMlB;;;;;;;;;OASG;IACG,QAAQ,CACZ,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,EACxC,MAAM,GAAE,MAAU,GACjB,OAAO,CAAC,OAAO,CAAC;IAKnB;;;;;;;;;;OAUG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,GAAG,YAAY,CAAC;IAKvD;;;;;;;;;OASG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAIpC"}

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

@@ -0,0 +1,186 @@
+/**
+ * Account Resource
+ * Handles account information and preferences
+ */
+import { get, patch, post } from "../utils/request";
+/**
+ * Account resource class
+ * Provides methods for account information and preferences
+ */
+export class AccountResource {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    /**
+     * Get current account information
+     *
+     * @example
+     * ```ts
+     * const account = await client.account.get();
+     * console.log(account.name);
+     * console.log(account.tier);
+     * console.log(account.usage);
+     * ```
+     */
+    async get() {
+        const result = await get(this.ctx, "/v1/client");
+        return result.data;
+    }
+    /**
+     * Get detailed account metrics
+     *
+     * @example
+     * ```ts
+     * const metrics = await client.account.getMetrics();
+     * console.log(metrics.dealMetrics.totalDeals);
+     * console.log(metrics.categoryPerformance);
+     * ```
+     */
+    async getMetrics() {
+        const result = await get(this.ctx, "/v1/client/metrics");
+        return result.data;
+    }
+    /**
+     * Get DealUp sync metrics (pro/enterprise only)
+     *
+     * @example
+     * ```ts
+     * const dealup = await client.account.getDealUpMetrics();
+     * console.log(dealup.sync.totalSynced);
+     * console.log(dealup.sync.clicksGenerated);
+     * ```
+     */
+    async getDealUpMetrics() {
+        const result = await get(this.ctx, "/v1/client/dealup");
+        return result.data;
+    }
+    /**
+     * Get crawl recommendations
+     * AI-suggested URLs to crawl based on past performance
+     *
+     * @example
+     * ```ts
+     * const recommendations = await client.account.getRecommendations();
+     * recommendations.recommendations.forEach(r => {
+     *   console.log(r.url, r.reason, r.estimatedDeals);
+     * });
+     * ```
+     */
+    async getRecommendations() {
+        const result = await get(this.ctx, "/v1/client/recommendations");
+        return result.data;
+    }
+    /**
+     * Get current preferences
+     *
+     * @example
+     * ```ts
+     * const prefs = await client.account.getPreferences();
+     * console.log(prefs.preferences.minDealScore);
+     * console.log(prefs.preferences.autoSync);
+     * ```
+     */
+    async getPreferences() {
+        const result = await get(this.ctx, "/v1/client/preferences");
+        return result.data;
+    }
+    /**
+     * Update account preferences
+     *
+     * @example
+     * ```ts
+     * const updated = await client.account.updatePreferences({
+     *   minDealScore: 70,
+     *   autoSync: true,
+     *   preferredCategories: ["software", "courses"]
+     * });
+     * ```
+     */
+    async updatePreferences(options) {
+        const result = await patch(this.ctx, "/v1/client/preferences", {
+            preferredCategories: options.preferredCategories,
+            minDealScore: options.minDealScore,
+            autoSync: options.autoSync,
+            webhookEnabled: options.webhookEnabled,
+        });
+        return result.data;
+    }
+    /**
+     * Track a DealUp click (webhook endpoint)
+     * Used internally by DealUp to track click-through
+     *
+     * @example
+     * ```ts
+     * await client.account.trackClick("deal_abc123", "homepage");
+     * ```
+     */
+    async trackClick(dealId, source) {
+        const result = await post(this.ctx, "/v1/client/dealup/click", {
+            dealId,
+            source,
+        });
+        return result.data;
+    }
+    // ============================================
+    // CONVENIENCE METHODS
+    // ============================================
+    /**
+     * Get remaining quota for a resource
+     *
+     * @example
+     * ```ts
+     * const remaining = await client.account.getRemainingQuota("scrapes");
+     * console.log(`${remaining} scrapes left this period`);
+     * ```
+     */
+    async getRemainingQuota(resource) {
+        const account = await this.get();
+        const usage = account.usage[resource];
+        return usage.limit - usage.used;
+    }
+    /**
+     * Check if account has quota for a resource
+     *
+     * @example
+     * ```ts
+     * if (await client.account.hasQuota("crawls", 5)) {
+     *   // Safe to start 5 crawls
+     * }
+     * ```
+     */
+    async hasQuota(resource, needed = 1) {
+        const remaining = await this.getRemainingQuota(resource);
+        return remaining >= needed;
+    }
+    /**
+     * Get account tier
+     *
+     * @example
+     * ```ts
+     * const tier = await client.account.getTier();
+     * if (tier === "enterprise") {
+     *   // Enable advanced features
+     * }
+     * ```
+     */
+    async getTier() {
+        const account = await this.get();
+        return account.tier;
+    }
+    /**
+     * Check if account is pro or enterprise tier
+     *
+     * @example
+     * ```ts
+     * if (await client.account.isPremium()) {
+     *   // Show premium features
+     * }
+     * ```
+     */
+    async isPremium() {
+        const tier = await this.getTier();
+        return tier === "pro" || tier === "enterprise";
+    }
+}
+//# sourceMappingURL=account.js.map

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

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

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

@@ -0,0 +1,87 @@
+/**
+ * Crawl Resource
+ * Handles website crawling operations
+ */
+import type { RequestContext } from "../types/config";
+import type { CrawlOptions, CrawlTemplate, CrawlTemplateId } from "../types/options";
+import type { CrawlJobResponse, CrawlAnalysisResponse } from "../types/responses";
+/**
+ * Crawl resource class
+ * Provides methods for website crawling
+ */
+export declare class CrawlResource {
+    private ctx;
+    constructor(ctx: RequestContext);
+    /**
+     * Create a new crawl job
+     *
+     * @example
+     * ```ts
+     * const job = await client.crawl.create({
+     *   url: "https://example.com",
+     *   maxDepth: 3,
+     *   maxPages: 100,
+     *   extractDeal: true
+     * });
+     * console.log(job.jobId);
+     * ```
+     */
+    create(options: CrawlOptions): Promise<CrawlJobResponse>;
+    /**
+     * Create a crawl job using a template
+     *
+     * @example
+     * ```ts
+     * const job = await client.crawl.withTemplate("ecommerce", {
+     *   url: "https://shop.example.com",
+     *   maxPages: 200 // Override template default
+     * });
+     * ```
+     */
+    withTemplate(templateId: CrawlTemplateId, options: CrawlOptions): Promise<CrawlJobResponse>;
+    /**
+     * List available crawl templates
+     *
+     * @example
+     * ```ts
+     * const templates = client.crawl.listTemplates();
+     * templates.forEach(t => console.log(t.name, t.description));
+     * ```
+     */
+    listTemplates(): CrawlTemplate[];
+    /**
+     * Get a specific template by ID
+     *
+     * @example
+     * ```ts
+     * const template = client.crawl.getTemplate("ecommerce");
+     * console.log(template.defaultOptions);
+     * ```
+     */
+    getTemplate(templateId: CrawlTemplateId): CrawlTemplate | undefined;
+    /**
+     * Analyze a URL before crawling
+     * Returns recommended settings based on site structure
+     *
+     * @example
+     * ```ts
+     * const analysis = await client.crawl.analyze("https://shop.example.com");
+     * console.log(analysis.recommendedTemplate);
+     * console.log(analysis.estimatedPages);
+     * ```
+     */
+    analyze(url: string): Promise<CrawlAnalysisResponse>;
+    /**
+     * Crawl a URL with deal extraction enabled
+     * Convenience method for e-commerce crawling
+     *
+     * @example
+     * ```ts
+     * const job = await client.crawl.forDeals("https://shop.example.com", {
+     *   minDealScore: 70
+     * });
+     * ```
+     */
+    forDeals(url: string, options?: Omit<CrawlOptions, "url" | "extractDeal" | "prioritizeDealPages">): Promise<CrawlJobResponse>;
+}
+//# sourceMappingURL=crawl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crawl.d.ts","sourceRoot":"","sources":["../../../../src/resources/crawl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAiF5B;;;GAGG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,cAAc;IAEvC;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsB9D;;;;;;;;;;OAUG;IACG,YAAY,CAChB,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,gBAAgB,CAAC;IAQ5B;;;;;;;;OAQG;IACH,aAAa,IAAI,aAAa,EAAE;IAIhC;;;;;;;;OAQG;IACH,WAAW,CAAC,UAAU,EAAE,eAAe,GAAG,aAAa,GAAG,SAAS;IAInE;;;;;;;;;;OAUG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAW1D;;;;;;;;;;OAUG;IACG,QAAQ,CACZ,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,aAAa,GAAG,qBAAqB,CAAC,GAC1E,OAAO,CAAC,gBAAgB,CAAC;CAQ7B"}