renderscreenshot 1.0.0

package/dist/esm/errors.js

@@ -0,0 +1,81 @@
+/**
+ * Mapping of error codes to their retryable status
+ */
+const RETRYABLE_ERRORS = new Set([
+    'rate_limited',
+    'timeout',
+    'render_failed',
+    'internal_error',
+]);
+/**
+ * Custom error class for RenderScreenshot API errors
+ */
+export class RenderScreenshotError extends Error {
+    /** HTTP status code */
+    httpStatus;
+    /** Error code from the API */
+    code;
+    /** Whether this error can be retried */
+    retryable;
+    /** Seconds to wait before retrying (for rate limits) */
+    retryAfter;
+    constructor(httpStatus, code, message, retryAfter) {
+        super(message);
+        this.name = 'RenderScreenshotError';
+        this.httpStatus = httpStatus;
+        this.code = code;
+        this.retryable = RETRYABLE_ERRORS.has(code);
+        if (retryAfter !== undefined) {
+            this.retryAfter = retryAfter;
+        }
+        // Maintains proper stack trace for where error was thrown (V8 only)
+        if (Error.captureStackTrace !== undefined) {
+            Error.captureStackTrace(this, RenderScreenshotError);
+        }
+    }
+    /**
+     * Create an error from an API response
+     */
+    static fromResponse(httpStatus, body, retryAfter) {
+        const code = (body.code ?? 'internal_error');
+        const message = body.message ?? body.error ?? 'An unknown error occurred';
+        return new RenderScreenshotError(httpStatus, code, message, retryAfter);
+    }
+    /**
+     * Create an invalid URL error
+     */
+    static invalidUrl(url) {
+        return new RenderScreenshotError(400, 'invalid_url', `Invalid URL provided: ${url}`);
+    }
+    /**
+     * Create an invalid request error
+     */
+    static invalidRequest(message) {
+        return new RenderScreenshotError(400, 'invalid_request', message);
+    }
+    /**
+     * Create an unauthorized error
+     */
+    static unauthorized() {
+        return new RenderScreenshotError(401, 'unauthorized', 'Invalid or missing API key');
+    }
+    /**
+     * Create a rate limited error
+     */
+    static rateLimited(retryAfter) {
+        return new RenderScreenshotError(429, 'rate_limited', 'Rate limit exceeded. Please wait before making more requests.', retryAfter);
+    }
+    /**
+     * Create a timeout error
+     */
+    static timeout() {
+        return new RenderScreenshotError(408, 'timeout', 'Screenshot request timed out');
+    }
+    /**
+     * Create an internal error
+     */
+    static internal(message) {
+        return new RenderScreenshotError(500, 'internal_error', message ?? 'An internal error occurred');
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAY;IAC1C,cAAc;IACd,SAAS;IACT,eAAe;IACf,gBAAgB;CACjB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,uBAAuB;IACd,UAAU,CAAS;IAE5B,8BAA8B;IACrB,IAAI,CAAY;IAEzB,wCAAwC;IAC/B,SAAS,CAAU;IAE5B,wDAAwD;IAC/C,UAAU,CAAU;IAE7B,YAAY,UAAkB,EAAE,IAAe,EAAE,OAAe,EAAE,UAAmB;QACnF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC/B,CAAC;QAED,oEAAoE;QACpE,IAAI,KAAK,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YAC1C,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,UAAkB,EAClB,IAAyD,EACzD,UAAmB;QAEnB,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,gBAAgB,CAAc,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,IAAI,2BAA2B,CAAC;QAC1E,OAAO,IAAI,qBAAqB,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAW;QAC3B,OAAO,IAAI,qBAAqB,CAAC,GAAG,EAAE,aAAa,EAAE,yBAAyB,GAAG,EAAE,CAAC,CAAC;IACvF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAe;QACnC,OAAO,IAAI,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY;QACjB,OAAO,IAAI,qBAAqB,CAAC,GAAG,EAAE,cAAc,EAAE,4BAA4B,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,UAAmB;QACpC,OAAO,IAAI,qBAAqB,CAC9B,GAAG,EACH,cAAc,EACd,+DAA+D,EAC/D,UAAU,CACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO;QACZ,OAAO,IAAI,qBAAqB,CAAC,GAAG,EAAE,SAAS,EAAE,8BAA8B,CAAC,CAAC;IACnF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAgB;QAC9B,OAAO,IAAI,qBAAqB,CAC9B,GAAG,EACH,gBAAgB,EAChB,OAAO,IAAI,4BAA4B,CACxC,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/index.js

@@ -0,0 +1,34 @@
+/**
+ * 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)
+ * );
+ * ```
+ */
+// Main exports
+export { Client } from './client.js';
+export { TakeOptions } from './options.js';
+export { RenderScreenshotError } from './errors.js';
+export { CacheManager } from './cache.js';
+export { verifyWebhook, parseWebhook, extractWebhookHeaders } from './webhooks.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,eAAe;AACf,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}