renderscreenshot 1.0.0

package/dist/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/esm/webhooks.js

@@ -0,0 +1,147 @@
+import { createHmac, timingSafeEqual } from 'node:crypto';
+/**
+ * Verify a webhook signature
+ *
+ * Webhooks are signed using HMAC-SHA256 with the format:
+ * `sha256=hmac(secret, "${timestamp}.${payload}")`
+ *
+ * @param payload - The raw request body as a string
+ * @param signature - The X-Webhook-Signature header value
+ * @param timestamp - The X-Webhook-Timestamp header value
+ * @param secret - Your webhook signing secret from the dashboard
+ * @returns true if the signature is valid
+ *
+ * @example
+ * ```typescript
+ * import { verifyWebhook } from 'renderscreenshot';
+ *
+ * // In your webhook handler
+ * const signature = req.headers['x-webhook-signature'];
+ * const timestamp = req.headers['x-webhook-timestamp'];
+ * const payload = JSON.stringify(req.body);
+ *
+ * if (verifyWebhook(payload, signature, timestamp, process.env.WEBHOOK_SECRET)) {
+ *   // Process webhook
+ * } else {
+ *   res.status(401).send('Invalid signature');
+ * }
+ * ```
+ */
+export function verifyWebhook(payload, signature, timestamp, secret) {
+    // Validate inputs
+    if (payload === '' || signature === '' || timestamp === '' || secret === '') {
+        return false;
+    }
+    // Check timestamp to prevent replay attacks (5 minute tolerance)
+    const timestampNum = parseInt(timestamp, 10);
+    if (isNaN(timestampNum)) {
+        return false;
+    }
+    const now = Math.floor(Date.now() / 1000);
+    const tolerance = 5 * 60; // 5 minutes
+    if (Math.abs(now - timestampNum) > tolerance) {
+        return false;
+    }
+    // Compute expected signature
+    const message = `${timestamp}.${payload}`;
+    const expected = `sha256=${createHmac('sha256', secret).update(message).digest('hex')}`;
+    // Use timing-safe comparison to prevent timing attacks
+    try {
+        return timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
+    }
+    catch {
+        // Buffers have different lengths
+        return false;
+    }
+}
+/**
+ * Parse a webhook payload into a typed event object
+ *
+ * @param payload - The raw request body (string or parsed object)
+ * @returns Typed webhook event
+ *
+ * @example
+ * ```typescript
+ * import { parseWebhook, verifyWebhook } from 'renderscreenshot';
+ *
+ * // After verifying signature
+ * const event = parseWebhook(req.body);
+ *
+ * if (event.type === 'screenshot.completed') {
+ *   console.log(`Screenshot ready: ${event.data.response?.url}`);
+ * }
+ * ```
+ */
+export function parseWebhook(payload) {
+    const raw = typeof payload === 'string' ? JSON.parse(payload) : payload;
+    const data = raw;
+    const event = {
+        id: data.id,
+        type: data.event,
+        timestamp: new Date(data.timestamp),
+        data: {},
+    };
+    // Parse based on event type
+    switch (data.event) {
+        case 'screenshot.completed': {
+            const eventData = {
+                response: {
+                    url: data.data.screenshot_url ?? '',
+                    width: data.data.width ?? 0,
+                    height: data.data.height ?? 0,
+                    format: (data.data.format ?? 'png'),
+                    size: data.data.size ?? 0,
+                    cached: data.data.cached ?? false,
+                },
+            };
+            if (data.data.url !== undefined) {
+                eventData.url = data.data.url;
+            }
+            event.data = eventData;
+            break;
+        }
+        case 'screenshot.failed': {
+            const eventData = {
+                error: {
+                    code: 'render_failed',
+                    message: data.data.error ?? 'Unknown error',
+                },
+            };
+            if (data.data.url !== undefined) {
+                eventData.url = data.data.url;
+            }
+            event.data = eventData;
+            break;
+        }
+        case 'batch.completed':
+        case 'batch.failed':
+            event.data = {
+                batchId: data.id,
+            };
+            break;
+    }
+    return event;
+}
+/**
+ * Extract webhook headers from a request-like object
+ *
+ * @param headers - Headers object (works with Express, Node http, etc.)
+ * @returns Object with signature and timestamp
+ */
+export function extractWebhookHeaders(headers) {
+    const getHeader = (name) => {
+        if (headers instanceof Headers) {
+            return headers.get(name) ?? '';
+        }
+        const value = headers[name] ?? headers[name.toLowerCase()];
+        if (Array.isArray(value)) {
+            return value[0] ?? '';
+        }
+        return value ?? '';
+    };
+    return {
+        signature: getHeader('X-Webhook-Signature'),
+        timestamp: getHeader('X-Webhook-Timestamp'),
+    };
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/esm/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA4B1D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,SAAiB,EACjB,SAAiB,EACjB,MAAc;IAEd,kBAAkB;IAClB,IAAI,OAAO,KAAK,EAAE,IAAI,SAAS,KAAK,EAAE,IAAI,SAAS,KAAK,EAAE,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAC5E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iEAAiE;IACjE,MAAM,YAAY,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,YAAY;IACtC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,YAAY,CAAC,GAAG,SAAS,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6BAA6B;IAC7B,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,UAAU,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAExF,uDAAuD;IACvD,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,iCAAiC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAAC,OAAyC;IACpE,MAAM,GAAG,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAa,CAAC,CAAC,CAAC,OAAO,CAAC;IAErF,MAAM,IAAI,GAAG,GAAwB,CAAC;IAEtC,MAAM,KAAK,GAAiB;QAC1B,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,KAAyB;QACpC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QACnC,IAAI,EAAE,EAAE;KACT,CAAC;IAEF,4BAA4B;IAC5B,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,MAAM,SAAS,GAAyB;gBACtC,QAAQ,EAAE;oBACR,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE;oBACnC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;oBAC3B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC;oBAC7B,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAoC;oBACtE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;oBACzB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK;iBAClC;aACF,CAAC;YACF,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;gBAChC,SAAS,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YAChC,CAAC;YACD,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC;YACvB,MAAM;QACR,CAAC;QAED,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,MAAM,SAAS,GAAyB;gBACtC,KAAK,EAAE;oBACL,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,eAAe;iBAC5C;aACF,CAAC;YACF,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;gBAChC,SAAS,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YAChC,CAAC;YACD,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC;YACvB,MAAM;QACR,CAAC;QAED,KAAK,iBAAiB,CAAC;QACvB,KAAK,cAAc;YACjB,KAAK,CAAC,IAAI,GAAG;gBACX,OAAO,EAAE,IAAI,CAAC,EAAE;aACjB,CAAC;YACF,MAAM;IACV,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAgE;IAEhE,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE;QACzC,IAAI,OAAO,YAAY,OAAO,EAAE,CAAC;YAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxB,CAAC;QACD,OAAO,KAAK,IAAI,EAAE,CAAC;IACrB,CAAC,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,qBAAqB,CAAC;QAC3C,SAAS,EAAE,SAAS,CAAC,qBAAqB,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/dist/types/cache.d.ts

@@ -0,0 +1,96 @@
+import type { PurgeResult } from './types.js';
+/**
+ * Interface for the Client to avoid circular dependency
+ */
+interface ClientInterface {
+    request<T>(method: string, path: string, options?: {
+        body?: unknown;
+        headers?: Record<string, string>;
+        responseType?: 'json' | 'buffer';
+    }): Promise<T>;
+}
+/**
+ * Cache management methods for RenderScreenshot
+ */
+export declare class CacheManager {
+    private readonly client;
+    constructor(client: ClientInterface);
+    /**
+     * Get a cached screenshot by its cache key
+     *
+     * @param key - The cache key returned in X-Cache-Key header
+     * @returns Buffer containing the screenshot, or null if not found
+     *
+     * @example
+     * ```typescript
+     * const image = await client.cache.get('cache_xyz789');
+     * if (image) {
+     *   await fs.writeFile('cached.png', image);
+     * }
+     * ```
+     */
+    get(key: string): Promise<Buffer | null>;
+    /**
+     * Delete a single cache entry
+     *
+     * @param key - The cache key to delete
+     * @returns true if deleted, false if not found
+     *
+     * @example
+     * ```typescript
+     * const deleted = await client.cache.delete('cache_xyz789');
+     * ```
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Bulk purge cache entries by keys
+     *
+     * @param keys - Array of cache keys to purge
+     * @returns Purge result with count and keys
+     *
+     * @example
+     * ```typescript
+     * const result = await client.cache.purge(['cache_abc', 'cache_def']);
+     * console.log(`Purged ${result.purged} entries`);
+     * ```
+     */
+    purge(keys: string[]): Promise<PurgeResult>;
+    /**
+     * Purge cache entries matching a URL pattern
+     *
+     * @param pattern - Glob pattern to match source URLs (e.g., "https://mysite.com/*")
+     * @returns Purge result with count
+     *
+     * @example
+     * ```typescript
+     * const result = await client.cache.purgeUrl('https://mysite.com/blog/*');
+     * ```
+     */
+    purgeUrl(pattern: string): Promise<PurgeResult>;
+    /**
+     * Purge cache entries created before a specific date
+     *
+     * @param date - Purge entries created before this date
+     * @returns Purge result with count
+     *
+     * @example
+     * ```typescript
+     * const result = await client.cache.purgeBefore(new Date('2024-01-01'));
+     * ```
+     */
+    purgeBefore(date: Date): Promise<PurgeResult>;
+    /**
+     * Purge cache entries matching a storage path pattern
+     *
+     * @param pattern - Glob pattern for storage paths (e.g., "screenshots/2024/01/*")
+     * @returns Purge result with count
+     *
+     * @example
+     * ```typescript
+     * const result = await client.cache.purgePattern('screenshots/2024/*');
+     * ```
+     */
+    purgePattern(pattern: string): Promise<PurgeResult>;
+}
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/types/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,UAAU,eAAe;IACvB,OAAO,CAAC,CAAC,EACP,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;KAClC,GACA,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,eAAe;IAInC;;;;;;;;;;;;;OAaG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmB9C;;;;;;;;;;OAUG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ3C;;;;;;;;;;;OAWG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAMjD;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAMrD;;;;;;;;;;OAUG;IACG,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IAMnD;;;;;;;;;;OAUG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAK1D"}

package/dist/types/client.d.ts

@@ -0,0 +1,147 @@
+import type { ClientOptions, ScreenshotResponse, BatchResponse, BatchRequestItem, PresetInfo, DeviceInfo, TakeOptionsConfig } from './types.js';
+import { TakeOptions } from './options.js';
+import { CacheManager } from './cache.js';
+/**
+ * RenderScreenshot API client
+ */
+export declare class Client {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    /** Cache management methods */
+    readonly cache: CacheManager;
+    /**
+     * Create a new RenderScreenshot client
+     * @param apiKey - Your API key (rs_live_* or rs_test_*)
+     * @param options - Optional client configuration
+     */
+    constructor(apiKey: string, options?: ClientOptions);
+    /**
+     * Get the API key for internal use
+     * @internal
+     */
+    getApiKey(): string;
+    /**
+     * Get the base URL for internal use
+     * @internal
+     */
+    getBaseUrl(): string;
+    /**
+     * Get the timeout for internal use
+     * @internal
+     */
+    getTimeout(): number;
+    /**
+     * Make an authenticated request to the API
+     * @internal
+     */
+    request<T>(method: string, path: string, options?: {
+        body?: unknown;
+        headers?: Record<string, string>;
+        responseType?: 'json' | 'buffer';
+    }): Promise<T>;
+    /**
+     * Generate a signed URL for embedding screenshots
+     *
+     * @param options - Screenshot options (TakeOptions instance or config object)
+     * @param expiresAt - Expiration time for the signed URL
+     * @returns Signed URL string
+     *
+     * @example
+     * ```typescript
+     * const url = client.generateUrl(
+     *   TakeOptions.url('https://example.com').preset('og_card'),
+     *   new Date(Date.now() + 24 * 60 * 60 * 1000) // 24 hours
+     * );
+     * ```
+     */
+    generateUrl(options: TakeOptions | TakeOptionsConfig, expiresAt: Date): string;
+    /**
+     * Take a screenshot and return the binary data
+     *
+     * @param options - Screenshot options (TakeOptions instance or config object)
+     * @returns Buffer containing the screenshot binary data
+     *
+     * @example
+     * ```typescript
+     * const image = await client.take(
+     *   TakeOptions.url('https://example.com').preset('og_card')
+     * );
+     * await fs.writeFile('screenshot.png', image);
+     * ```
+     */
+    take(options: TakeOptions | TakeOptionsConfig): Promise<Buffer>;
+    /**
+     * Take a screenshot and return JSON metadata with URLs
+     *
+     * @param options - Screenshot options (TakeOptions instance or config object)
+     * @returns Screenshot response with metadata and URLs
+     *
+     * @example
+     * ```typescript
+     * const response = await client.takeJson(
+     *   TakeOptions.url('https://example.com').preset('og_card')
+     * );
+     * console.log(response.url); // CDN URL to the screenshot
+     * ```
+     */
+    takeJson(options: TakeOptions | TakeOptionsConfig): Promise<ScreenshotResponse>;
+    /**
+     * Process multiple screenshots in a batch
+     *
+     * @param urls - Array of URLs to screenshot
+     * @param options - Options to apply to all screenshots
+     * @returns Batch response with results for each URL
+     *
+     * @example
+     * ```typescript
+     * const results = await client.batch(
+     *   ['https://example1.com', 'https://example2.com'],
+     *   TakeOptions.url('').preset('og_card')
+     * );
+     * ```
+     */
+    batch(urls: string[], options?: TakeOptions | TakeOptionsConfig): Promise<BatchResponse>;
+    /**
+     * Process multiple screenshots with per-URL options
+     *
+     * @param requests - Array of batch request items with individual options
+     * @returns Batch response with results for each URL
+     *
+     * @example
+     * ```typescript
+     * const results = await client.batch([
+     *   { url: 'https://example1.com', options: { width: 1200 } },
+     *   { url: 'https://example2.com', options: { preset: 'full_page' } }
+     * ]);
+     * ```
+     */
+    batch(requests: BatchRequestItem[]): Promise<BatchResponse>;
+    /**
+     * Get the status of a batch job
+     *
+     * @param batchId - The batch job ID
+     * @returns Batch status and results
+     */
+    getBatch(batchId: string): Promise<BatchResponse>;
+    /**
+     * List all available presets
+     *
+     * @returns Array of preset configurations
+     */
+    presets(): Promise<PresetInfo[]>;
+    /**
+     * Get a single preset by ID
+     *
+     * @param id - Preset identifier
+     * @returns Preset configuration
+     */
+    preset(id: string): Promise<PresetInfo>;
+    /**
+     * List all available device presets
+     *
+     * @returns Array of device configurations
+     */
+    devices(): Promise<DeviceInfo[]>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoC1C;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAE7B;;;;OAIG;gBACS,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB;IAWvD;;;OAGG;IACH,SAAS,IAAI,MAAM;IAInB;;;OAGG;IACH,UAAU,IAAI,MAAM;IAIpB;;;OAGG;IACH,UAAU,IAAI,MAAM;IAIpB;;;OAGG;IACG,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;KAC7B,GACL,OAAO,CAAC,CAAC,CAAC;IAuDb;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,iBAAiB,EAAE,SAAS,EAAE,IAAI,GAAG,MAAM;IA8C9E;;;;;;;;;;;;;OAaG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IASrE;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQrF;;;;;;;;;;;;;;OAcG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAE9F;;;;;;;;;;;;;OAaG;IACG,KAAK,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAmCjE;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIvD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAItC;;;;;OAKG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI7C;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;CAGvC"}

package/dist/types/errors.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Error codes returned by the RenderScreenshot API
+ */
+export type ErrorCode = 'invalid_request' | 'invalid_url' | 'unauthorized' | 'forbidden' | 'not_found' | 'rate_limited' | 'timeout' | 'render_failed' | 'internal_error';
+/**
+ * Custom error class for RenderScreenshot API errors
+ */
+export declare class RenderScreenshotError extends Error {
+    /** HTTP status code */
+    readonly httpStatus: number;
+    /** Error code from the API */
+    readonly code: ErrorCode;
+    /** Whether this error can be retried */
+    readonly retryable: boolean;
+    /** Seconds to wait before retrying (for rate limits) */
+    readonly retryAfter?: number;
+    constructor(httpStatus: number, code: ErrorCode, message: string, retryAfter?: number);
+    /**
+     * Create an error from an API response
+     */
+    static fromResponse(httpStatus: number, body: {
+        code?: string;
+        message?: string;
+        error?: string;
+    }, retryAfter?: number): RenderScreenshotError;
+    /**
+     * Create an invalid URL error
+     */
+    static invalidUrl(url: string): RenderScreenshotError;
+    /**
+     * Create an invalid request error
+     */
+    static invalidRequest(message: string): RenderScreenshotError;
+    /**
+     * Create an unauthorized error
+     */
+    static unauthorized(): RenderScreenshotError;
+    /**
+     * Create a rate limited error
+     */
+    static rateLimited(retryAfter?: number): RenderScreenshotError;
+    /**
+     * Create a timeout error
+     */
+    static timeout(): RenderScreenshotError;
+    /**
+     * Create an internal error
+     */
+    static internal(message?: string): RenderScreenshotError;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,WAAW,GACX,WAAW,GACX,cAAc,GACd,SAAS,GACT,eAAe,GACf,gBAAgB,CAAC;AAYrB;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,uBAAuB;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAEzB,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAgBrF;;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,CAAA;KAAE,EACzD,UAAU,CAAC,EAAE,MAAM,GAClB,qBAAqB;IAMxB;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB;IAIrD;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB;IAI7D;;OAEG;IACH,MAAM,CAAC,YAAY,IAAI,qBAAqB;IAI5C;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,qBAAqB;IAS9D;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI,qBAAqB;IAIvC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,qBAAqB;CAOzD"}

package/dist/types/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * RenderScreenshot Node.js SDK
+ *
+ * Official Node.js/TypeScript SDK for the RenderScreenshot API.
+ *
+ * @packageDocumentation
+ * @module renderscreenshot
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * import { Client, TakeOptions } from 'renderscreenshot';
+ *
+ * const client = new Client('rs_live_xxxxx');
+ *
+ * // Take a screenshot
+ * const image = await client.take(
+ *   TakeOptions.url('https://example.com').preset('og_card')
+ * );
+ *
+ * // Generate a signed URL for embedding
+ * const url = client.generateUrl(
+ *   TakeOptions.url('https://example.com').preset('og_card'),
+ *   new Date(Date.now() + 24 * 60 * 60 * 1000)
+ * );
+ * ```
+ */
+export { Client } from './client.js';
+export { TakeOptions } from './options.js';
+export { RenderScreenshotError } from './errors.js';
+export type { ErrorCode } from './errors.js';
+export { CacheManager } from './cache.js';
+export { verifyWebhook, parseWebhook, extractWebhookHeaders } from './webhooks.js';
+export type { ClientOptions, TakeOptionsConfig, ImageFormat, WaitCondition, BlockableResource, MediaType, StorageAcl, Preset, Device, PdfPaperSize, Cookie, Geolocation, ScreenshotResponse, BatchRequestItem, BatchResponseItem, BatchResponse, CacheEntry, PurgeResult, WebhookEventType, WebhookEvent, PresetInfo, DeviceInfo, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAGnF,YAAY,EAEV,aAAa,EAGb,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,MAAM,EACN,MAAM,EACN,YAAY,EACZ,MAAM,EACN,WAAW,EAGX,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EAGb,UAAU,EACV,WAAW,EAGX,gBAAgB,EAChB,YAAY,EAGZ,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAC"}