@sendclipper/node 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## 0.1.0 — 2026-10-16
+
+First release.
+
+- `emails.send`, `batch.send`, `emails.get`, `emails.list`, `emails.iterate`, `emails.stats`.
+- Templates (with tags and image assets), domains, sandboxes (including the JSON door and `waitFor`), webhooks and their dispatches, contacts, audiences, suppressions, mailboxes, automations, workspace and API keys.
+- Every method resolves to `{ data, error, headers }`.
+- Automatic `Idempotency-Key` on every JSON write; retries on network errors, 429 and 5xx.
+- `react` support through the optional `@react-email/render`.
+- `verifyWebhook()` for `X-SendClipper-Signature-V2`, rotation-aware.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SendClipper
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,209 @@
-# Temporary Holding Version
+# SendClipper Node.js SDK
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The official Node.js library for the [SendClipper](https://sendclipper.com) email API.
+
+```bash
+npm install @sendclipper/node
+```
+
+Node.js 20 or newer. No runtime dependencies. ESM and CommonJS.
+
+## Setup
+
+Create an API key in the dashboard under **API keys**.
+
+```js
+import { SendClipper } from '@sendclipper/node';
+
+const sc = new SendClipper('sc_live_xxxxxxxxxxxxxxxx');
+// or: new SendClipper()  — reads SENDCLIPPER_API_KEY
+```
+
+## Send an email
+
+```js
+const { data, error } = await sc.emails.send({
+  from: 'hello@send.acme.io',
+  to: 'ada@lumen.io',
+  subject: 'Your receipt',
+  html: '<p>Thanks for your order.</p>',
+  text: 'Thanks for your order.',
+});
+
+if (error) {
+  console.error(error.name, error.message); // e.g. domain_not_verified
+} else {
+  console.log(`Email ${data.id} accepted`);
+}
+```
+
+`from` must be a bare address on a domain you verified in SendClipper. Each message has one recipient in `to`; for several, use `batch.send`.
+
+## Send with a template
+
+Design and publish a template in the dashboard, then send it by id or by its send name:
+
+```js
+await sc.emails.send({
+  from: 'hello@send.acme.io',
+  to: 'ada@lumen.io',
+  templateId: 'tpl_9f2b7c10ad42', // or template: 'welcome'
+  variables: { first_name: 'Ada' },
+});
+```
+
+A tag with no value and no `{{tag|fallback}}` is refused by name (`template_variables_missing`), never sent blank.
+
+## Send with React
+
+Install `@react-email/render` and pass a component:
+
+```jsx
+import { WelcomeEmail } from './emails/welcome';
+
+await sc.emails.send({
+  from: 'hello@send.acme.io',
+  to: 'ada@lumen.io',
+  subject: 'Welcome',
+  react: <WelcomeEmail firstName="Ada" />,
+});
+```
+
+The SDK renders it to `html` and a plain-text `text` before sending.
+
+## Send a batch
+
+Up to 500 messages in one request. Each item is accepted or refused on its own:
+
+```js
+const { data } = await sc.batch.send([
+  { from: 'hello@send.acme.io', to: 'ada@lumen.io', subject: 'Hi Ada', html: '<p>Hi</p>' },
+  { from: 'hello@send.acme.io', to: 'alan@lumen.io', templateId: 'tpl_9f2b7c10ad42', variables: { first_name: 'Alan' } },
+]);
+
+for (const item of data.data) {
+  if (item.status === 'failed') console.warn(item.index, item.error.code);
+}
+```
+
+## Errors
+
+API methods never throw for an API refusal or a network failure. They resolve to `{ data, error, headers }`, and exactly one of `data` and `error` is set:
+
+```ts
+type ErrorResponse = {
+  name: string;              // SendClipper's code: 'validation_failed', 'rate_limited', 'network_error', …
+  message: string;           // a sentence for a person
+  statusCode: number | null; // null when no answer arrived (network, timeout, abort)
+  detail?: unknown;          // code-specific facts
+};
+```
+
+The async iterators (`emails.iterate()` and friends) throw a `SendClipperApiError` instead, since a loop has no `error` to hand back.
+
+## Retries and idempotency
+
+Network errors, `429` and `5xx` answers are retried twice with backoff, honouring `Retry-After`. Every JSON write carries an `Idempotency-Key`, and the API answers a repeated key with the first result for 24 hours. A retried send therefore never goes out twice.
+
+To make your own retries safe as well (a job that runs again after a crash), pass a key that names the logical operation:
+
+```js
+await sc.emails.send(params, { idempotencyKey: `order-${order.id}-receipt` });
+```
+
+## Request options
+
+Every method takes request options as its last argument:
+
+```js
+await sc.emails.list(
+  { status: 'bounced' },
+  { signal: AbortSignal.timeout(5000), headers: { 'X-Trace-Id': traceId } },
+);
+```
+
+| Option | Meaning |
+|---|---|
+| `idempotencyKey` | Your own key for a write |
+| `signal` | Abort the call |
+| `timeoutMs` | Per-attempt timeout (default 30 000) |
+| `maxRetries` | Retries for this call (default 2) |
+| `headers` | Extra request headers |
+
+Client options: `new SendClipper(key, { baseUrl, timeoutMs, maxRetries, fetch, defaultHeaders })`. `baseUrl` also reads `SENDCLIPPER_BASE_URL`.
+
+## Verify webhooks
+
+SendClipper signs each delivery. Verify it against the **raw** body, before parsing:
+
+```js
+import express from 'express';
+import { verifyWebhook, WebhookVerificationError } from '@sendclipper/node';
+
+app.post('/hooks/sendclipper', express.raw({ type: 'application/json' }), (req, res) => {
+  try {
+    const event = verifyWebhook({
+      payload: req.body, // a Buffer, not parsed JSON
+      headers: req.headers,
+      secret: process.env.SENDCLIPPER_WEBHOOK_SECRET,
+    });
+    // event.id is stable across retries: deduplicate on it
+    console.log(event.event, event.data.to);
+    res.sendStatus(200);
+  } catch (err) {
+    if (err instanceof WebhookVerificationError) return res.status(400).send(err.reason);
+    throw err;
+  }
+});
+```
+
+During a secret rotation a delivery carries two signatures and either one is accepted. A delivery signed more than five minutes away from now is refused. `sc.webhooks.verify(...)` is the same function.
+
+To test your handler locally, `signatureHeader(secret, rawBody)` builds a valid header.
+
+## Sandboxes
+
+A sandbox traps mail while you develop: nothing is delivered.
+
+```js
+const { data: box } = await sc.sandboxes.create({ name: 'my-app-dev' });
+const { data: creds } = await sc.sandboxes.credentials(box.id); // SMTP host, port, user, password
+
+// Or send through the sandbox's JSON door with its own token, using the same fields as emails.send():
+const { data: token } = await sc.sandboxes.resetCredentials(box.id);
+await sc.sandboxes.send(token.apiToken, { from: 'app@example.com', to: 'test@example.com', subject: 'Hi', html: '<p>Hi</p>' });
+
+// In a test: wait for the message to arrive
+const { data: msg } = await sc.sandboxes.messages.waitFor(box.id, { match: (m) => m.subject === 'Hi' });
+```
+
+## Everything else
+
+| Resource | Methods |
+|---|---|
+| `emails` | `send`, `get`, `list`, `iterate`, `stats` |
+| `batch` | `send` |
+| `domains` | `list`, `create`, `records`, `verify`, `enableReceiving`, `disableReceiving`, `setRegion`, `deletionPreview`, `remove` |
+| `templates` | `list`, `get`, `html`, `create`, `update`, `remove`, `duplicate`, `publish`, `unpublish`, `preview`, `setTags`, `projects` |
+| `templates.tags` | `list`, `create`, `update`, `remove` |
+| `templates.assets` | `list`, `upload` |
+| `sandboxes` | `list`, `get`, `create`, `update`, `remove`, `credentials`, `resetCredentials`, `send` |
+| `sandboxes.messages` | `list`, `get`, `raw`, `remove`, `clear`, `markAllRead`, `waitFor` |
+| `webhooks` | `list`, `create`, `update`, `remove`, `rotateSecret`, `deliveries`, `verify` |
+| `webhooks.dispatches` | `list`, `iterate`, `get`, `replay`, `replayAll` |
+| `contacts` | `list`, `iterate`, `create`, `import`, `importPreview`, `export` |
+| `audiences` | `list` |
+| `suppressions` | `list`, `iterate`, `create`, `remove`, `export` |
+| `mailboxes` | `list`, `get`, `create`, `update`, `archive` |
+| `mailboxes.messages` | `list`, `iterate`, `get`, `attachment` |
+| `automations` | `enroll` |
+| `workspace` | `get` |
+| `apiKeys` | `list` |
+
+Management routes need a key with **Full access**. A sending-only key can call `emails.send` and `batch.send`.
+
+Full API reference: <https://sendclipper.com/docs>.
+
+## License
+
+MIT

package/dist/cjs/core.d.ts

@@ -0,0 +1,95 @@
+export declare const DEFAULT_BASE_URL = "https://sendclipper.com";
+export interface ClientOptions {
+    /** Defaults to `process.env.SENDCLIPPER_API_KEY`. A `sc_live_…` key. */
+    apiKey?: string;
+    /** Defaults to `process.env.SENDCLIPPER_BASE_URL`, then `https://sendclipper.com`. No `/v1`. */
+    baseUrl?: string;
+    /** Per attempt, in milliseconds. Default 30 000. */
+    timeoutMs?: number;
+    /**
+     * Retries after a network error, a 429 or a 5xx. Default 2. A mutation is
+     * only retried when it carries an `Idempotency-Key`, which the SDK adds to
+     * every JSON mutation, so a retried send can never go out twice.
+     */
+    maxRetries?: number;
+    /** Your own `fetch` (a proxy agent, a test double). Defaults to the global one. */
+    fetch?: typeof fetch;
+    /** Sent on every request. */
+    defaultHeaders?: Record<string, string>;
+}
+/** What an API refusal or a network failure looks like. */
+export interface ErrorResponse {
+    /** SendClipper's machine-readable code: `domain_not_verified`, `validation_failed`, `rate_limited`, `network_error`, … */
+    name: string;
+    /** A sentence meant for a person. */
+    message: string;
+    /** The HTTP status, or `null` when no answer arrived (network, timeout, abort). */
+    statusCode: number | null;
+    /** Extra, code-specific facts (e.g. the missing template tags). */
+    detail?: unknown;
+}
+/** Every API method resolves to this. Exactly one of `data` and `error` is set. */
+export type Result<T> = ({
+    data: T;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+}) & {
+    headers: Record<string, string> | null;
+};
+export type Query = Record<string, string | number | boolean | undefined | null>;
+export interface RequestOptions {
+    /** Your own key, reused when YOU retry the same logical call later. */
+    idempotencyKey?: string;
+    /** Override the client's timeout for this call. */
+    timeoutMs?: number;
+    /** Override the client's retry count for this call. */
+    maxRetries?: number;
+    /** Abort the call from outside. */
+    signal?: AbortSignal;
+    /** Extra headers for this call. */
+    headers?: Record<string, string>;
+}
+/** What a download resolves to. */
+export interface DownloadedFile {
+    bytes: Uint8Array;
+    contentType: string | null;
+    filename: string | null;
+}
+interface InternalRequest extends RequestOptions {
+    method: string;
+    path: string;
+    query?: Query;
+    body?: unknown;
+    form?: FormData;
+    as?: 'json' | 'text' | 'bytes';
+    /** Replaces the API key (the sandbox JSON door takes an `sc_sbx_` token). */
+    bearer?: string;
+}
+export declare class HttpClient {
+    readonly baseUrl: string;
+    private readonly apiKey;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    private readonly fetchImpl;
+    private readonly defaultHeaders;
+    constructor(opts?: ClientOptions);
+    /**
+     * The public face of every API method: never throws for an API refusal or
+     * a network failure, it answers `{ data, error, headers }`.
+     */
+    call<T>(req: InternalRequest): Promise<Result<T>>;
+    /** Like `call()`, but throws `SendClipperApiError` / `SendClipperConnectionError`. */
+    request<T>(req: InternalRequest): Promise<{
+        data: T;
+        headers: Record<string, string>;
+    }>;
+    private fetchOnce;
+}
+/** `encodeURIComponent` for one path segment. */
+export declare function seg(value: string): string;
+/** Turn a `Result` back into a value, throwing its error. Used by the iterators. */
+export declare function unwrap<T>(res: Result<T>): T;
+export {};
+//# sourceMappingURL=core.d.ts.map

package/dist/cjs/core.d.ts.map

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

package/dist/cjs/core.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = exports.DEFAULT_BASE_URL = void 0;
+exports.seg = seg;
+exports.unwrap = unwrap;
+const node_crypto_1 = require("node:crypto");
+const errors_js_1 = require("./errors.js");
+const version_js_1 = require("./version.js");
+exports.DEFAULT_BASE_URL = 'https://sendclipper.com';
+const RETRYABLE_STATUS = new Set([408, 429, 500, 502, 503, 504]);
+const MAX_RETRY_AFTER_MS = 60_000;
+class HttpClient {
+    baseUrl;
+    apiKey;
+    timeoutMs;
+    maxRetries;
+    fetchImpl;
+    defaultHeaders;
+    constructor(opts = {}) {
+        const env = typeof process !== 'undefined' ? process.env : {};
+        this.apiKey = opts.apiKey ?? env.SENDCLIPPER_API_KEY;
+        this.baseUrl = (opts.baseUrl ?? env.SENDCLIPPER_BASE_URL ?? exports.DEFAULT_BASE_URL).replace(/\/+$/, '').replace(/\/v1$/, '');
+        this.timeoutMs = opts.timeoutMs ?? 30_000;
+        this.maxRetries = Math.max(0, opts.maxRetries ?? 2);
+        const f = opts.fetch ?? globalThis.fetch;
+        if (typeof f !== 'function') {
+            throw new Error('@sendclipper/node needs a global fetch (Node.js 18 or newer) or a `fetch` option.');
+        }
+        this.fetchImpl = f;
+        this.defaultHeaders = opts.defaultHeaders ?? {};
+    }
+    /**
+     * The public face of every API method: never throws for an API refusal or
+     * a network failure, it answers `{ data, error, headers }`.
+     */
+    async call(req) {
+        try {
+            const { data, headers } = await this.request(req);
+            return { data, error: null, headers };
+        }
+        catch (err) {
+            if (err instanceof errors_js_1.SendClipperApiError) {
+                return { data: null, error: errorResponseOf(err), headers: err.headers ? headersOf(err.headers) : null };
+            }
+            if (err instanceof errors_js_1.SendClipperConnectionError) {
+                return { data: null, error: { name: 'network_error', message: err.message, statusCode: null }, headers: null };
+            }
+            if (req.signal?.aborted) {
+                return {
+                    data: null,
+                    error: { name: 'network_error', message: 'The request was aborted.', statusCode: null },
+                    headers: null,
+                };
+            }
+            throw err;
+        }
+    }
+    /** Like `call()`, but throws `SendClipperApiError` / `SendClipperConnectionError`. */
+    async request(req) {
+        const bearer = req.bearer ?? this.apiKey;
+        if (!bearer) {
+            throw new errors_js_1.SendClipperApiError(401, 'api_key_missing', 'No SendClipper API key. Pass one to `new SendClipper("sc_live_…")` or set SENDCLIPPER_API_KEY.');
+        }
+        const url = new URL(`${this.baseUrl}/v1${req.path.startsWith('/') ? req.path : `/${req.path}`}`);
+        for (const [k, v] of Object.entries(req.query ?? {})) {
+            if (v !== undefined && v !== null && v !== '')
+                url.searchParams.set(k, String(v));
+        }
+        const headers = {
+            Authorization: `Bearer ${bearer}`,
+            Accept: req.as === 'json' || !req.as ? 'application/json' : '*/*',
+            'User-Agent': `sendclipper-node/${version_js_1.VERSION}`,
+            ...this.defaultHeaders,
+            ...(req.headers ?? {}),
+        };
+        let body;
+        if (req.form) {
+            body = req.form;
+        }
+        else if (req.body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+            body = JSON.stringify(req.body);
+        }
+        const isRead = req.method === 'GET' || req.method === 'HEAD';
+        // The API de-duplicates every JSON mutation on this header for 24 hours.
+        // A multipart body is not fingerprinted server-side, so it gets no key and
+        // is never retried.
+        if (!isRead && !req.form) {
+            headers['Idempotency-Key'] = req.idempotencyKey ?? `sc-node-${(0, node_crypto_1.randomUUID)()}`;
+        }
+        else if (req.idempotencyKey) {
+            headers['Idempotency-Key'] = req.idempotencyKey;
+        }
+        const canRetry = isRead || Boolean(headers['Idempotency-Key']);
+        const maxRetries = canRetry ? Math.max(0, req.maxRetries ?? this.maxRetries) : 0;
+        for (let attempt = 0;; attempt++) {
+            let res;
+            try {
+                res = await this.fetchOnce(url, req.method, headers, body, req.timeoutMs ?? this.timeoutMs, req.signal);
+            }
+            catch (err) {
+                if (req.signal?.aborted)
+                    throw err;
+                if (attempt < maxRetries) {
+                    await sleep(backoffMs(attempt));
+                    continue;
+                }
+                throw err;
+            }
+            if (!res.ok && RETRYABLE_STATUS.has(res.status) && attempt < maxRetries) {
+                await res.body?.cancel().catch(() => undefined);
+                await sleep(retryAfterMs(res.headers) ?? backoffMs(attempt));
+                continue;
+            }
+            if (!res.ok) {
+                const err = (0, errors_js_1.toApiError)(res.status, await res.text(), res.headers);
+                // Our own earlier attempt is still running server-side (a timeout
+                // that was not a failure). Its result is replayed once it finishes.
+                if (err.code === 'idempotency_key_in_flight' && attempt < maxRetries) {
+                    await sleep(retryAfterMs(res.headers) ?? backoffMs(attempt));
+                    continue;
+                }
+                throw err;
+            }
+            const responseHeaders = headersOf(res.headers);
+            if (req.as === 'bytes') {
+                const file = {
+                    bytes: new Uint8Array(await res.arrayBuffer()),
+                    contentType: res.headers.get('content-type'),
+                    filename: filenameOf(res.headers.get('content-disposition')),
+                };
+                return { data: file, headers: responseHeaders };
+            }
+            const text = await res.text();
+            if (req.as === 'text' || !text)
+                return { data: (req.as === 'text' ? text : null), headers: responseHeaders };
+            try {
+                return { data: JSON.parse(text), headers: responseHeaders };
+            }
+            catch {
+                return { data: text, headers: responseHeaders };
+            }
+        }
+    }
+    async fetchOnce(url, method, headers, body, timeoutMs, outer) {
+        const ctrl = new AbortController();
+        const onAbort = () => ctrl.abort(outer?.reason);
+        if (outer) {
+            if (outer.aborted)
+                ctrl.abort(outer.reason);
+            else
+                outer.addEventListener('abort', onAbort, { once: true });
+        }
+        const timer = setTimeout(() => ctrl.abort(new Error('timeout')), timeoutMs);
+        try {
+            return await this.fetchImpl(url, { method, headers, body, signal: ctrl.signal });
+        }
+        catch (err) {
+            if (outer?.aborted)
+                throw err;
+            const timedOut = ctrl.signal.aborted;
+            throw new errors_js_1.SendClipperConnectionError(timedOut
+                ? `SendClipper did not answer within ${timeoutMs} ms (${method} ${url.pathname}).`
+                : `Could not reach SendClipper at ${this.baseUrl}: ${err.message}`, err);
+        }
+        finally {
+            clearTimeout(timer);
+            outer?.removeEventListener('abort', onAbort);
+        }
+    }
+}
+exports.HttpClient = HttpClient;
+function backoffMs(attempt) {
+    const base = Math.min(8_000, 500 * 2 ** attempt);
+    return base / 2 + Math.random() * (base / 2);
+}
+function retryAfterMs(headers) {
+    const raw = headers.get('retry-after');
+    if (!raw)
+        return undefined;
+    const seconds = Number(raw);
+    if (Number.isFinite(seconds) && seconds >= 0)
+        return Math.min(MAX_RETRY_AFTER_MS, seconds * 1000);
+    const at = Date.parse(raw);
+    if (Number.isNaN(at))
+        return undefined;
+    return Math.min(MAX_RETRY_AFTER_MS, Math.max(0, at - Date.now()));
+}
+function filenameOf(disposition) {
+    if (!disposition)
+        return null;
+    const star = /filename\*\s*=\s*(?:UTF-8'')?([^;]+)/i.exec(disposition);
+    if (star?.[1]) {
+        try {
+            return decodeURIComponent(star[1].trim().replace(/^"|"$/g, ''));
+        }
+        catch {
+            /* fall through to the plain form */
+        }
+    }
+    const plain = /filename\s*=\s*"?([^";]+)"?/i.exec(disposition);
+    return plain?.[1]?.trim() ?? null;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** `encodeURIComponent` for one path segment. */
+function seg(value) {
+    return encodeURIComponent(value);
+}
+function headersOf(h) {
+    const out = {};
+    h.forEach((value, key) => {
+        out[key] = value;
+    });
+    return out;
+}
+function errorResponseOf(err) {
+    const e = { name: err.code, message: err.message, statusCode: err.status };
+    if (err.detail !== undefined)
+        e.detail = err.detail;
+    return e;
+}
+/** Turn a `Result` back into a value, throwing its error. Used by the iterators. */
+function unwrap(res) {
+    if (res.error) {
+        throw new errors_js_1.SendClipperApiError(res.error.statusCode ?? 0, res.error.name, res.error.message, res.error.detail);
+    }
+    return res.data;
+}
+//# sourceMappingURL=core.js.map

package/dist/cjs/core.js.map

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

package/dist/cjs/errors.d.ts

@@ -0,0 +1,34 @@
+/** Base class for everything this SDK throws on purpose. */
+export declare class SendClipperError extends Error {
+    constructor(message: string);
+}
+/**
+ * The API answered with a non-2xx status. `code` is the API's own
+ * machine-readable reason (`domain_not_verified`, `template_variables_missing`,
+ * `rate_limited`, …) and is the field to branch on; `message` is a sentence
+ * meant for a person.
+ */
+export declare class SendClipperApiError extends SendClipperError {
+    readonly status: number;
+    readonly code: string;
+    readonly detail?: unknown | undefined;
+    readonly headers?: Headers | undefined;
+    constructor(status: number, code: string, message: string, detail?: unknown | undefined, headers?: Headers | undefined);
+}
+/** The request never got an answer: DNS, TLS, a reset socket or the timeout. */
+export declare class SendClipperConnectionError extends SendClipperError {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+/** `webhooks.verify()` refused a delivery. `reason` says which check failed. */
+export declare class WebhookVerificationError extends SendClipperError {
+    readonly reason: 'missing_header' | 'malformed_header' | 'timestamp_out_of_tolerance' | 'signature_mismatch' | 'invalid_payload';
+    constructor(reason: 'missing_header' | 'malformed_header' | 'timestamp_out_of_tolerance' | 'signature_mismatch' | 'invalid_payload', message: string);
+}
+/**
+ * The API answers refusals in two shapes: the house envelope
+ * `{ error: { code, message, detail? } }` and Nest's default
+ * `{ statusCode, message: string | string[], error }` (request validation).
+ */
+export declare function toApiError(status: number, text: string, headers?: Headers): SendClipperApiError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;IAErD,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO;gBAJjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACN,MAAM,CAAC,EAAE,OAAO,YAAA,EAChB,OAAO,CAAC,EAAE,OAAO,YAAA;CAK7B;AAED,gFAAgF;AAChF,qBAAa,0BAA2B,SAAQ,gBAAgB;IAG5D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;gBADxB,OAAO,EAAE,MAAM,EACN,KAAK,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,gFAAgF;AAChF,qBAAa,wBAAyB,SAAQ,gBAAgB;IAE1D,QAAQ,CAAC,MAAM,EACX,gBAAgB,GAChB,kBAAkB,GAClB,4BAA4B,GAC5B,oBAAoB,GACpB,iBAAiB;gBALZ,MAAM,EACX,gBAAgB,GAChB,kBAAkB,GAClB,4BAA4B,GAC5B,oBAAoB,GACpB,iBAAiB,EACrB,OAAO,EAAE,MAAM;CAKlB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAyC/F"}