@sneekin/sdk 0.3.2 → 1.0.0

package/dist/index.d.mts

@@ -1,118 +0,0 @@
-/**
- * @sneekin/sdk — Node.js SDK for the Sneek Send API.
- *
- *   const sneek = new Sneek({
- *       apiUrl: 'https://api.sneek.in',
- *       apiKey: process.env.SNEEK_API_KEY!, // snk_live_… / snk_test_…
- *   });
- *
- *   await sneek.messages.send({ to: '+91…', body: 'Your OTP is 123456' });
- *   await sneek.sendSMS('+91…', 'Your OTP is 123456');
- *   await sneek.sendOTP({ to: '+91…', code: '123456', appName: 'ConfHub' });
- *
- * Authenticates with `Authorization: Bearer snk_…` against the server's
- * `BearerApiKeyGuard`. No request signing — the bearer key is the credential.
- */
-interface SneekOptions {
-    /** Base URL of the Sneek API, e.g. https://api.sneek.in */
-    apiUrl: string;
-    /** Bearer API key: `snk_live_…` or `snk_test_…`. */
-    apiKey: string;
-    /** Override the global fetch (for tests / non-Node runtimes). */
-    fetch?: typeof fetch;
-    /** Max retry attempts for transient failures (5xx / network). Default 2. */
-    maxRetries?: number;
-    /** Base backoff in ms between retries (exponential). Default 200. */
-    retryBaseMs?: number;
-}
-type MessageChannel = 'sms' | 'whatsapp' | 'email';
-interface SendMessageInput {
-    to: string;
-    /** Free-form message body. Required unless `template` is given. */
-    body?: string;
-    channel?: 'auto' | MessageChannel;
-    clientRef?: string;
-    /**
-     * Declares intent so the right approved provider template is used:
-     * `otp` → auth/OTP template, `transactional` → utility/communication.
-     * When omitted, Sneek infers it from the body text.
-     */
-    type?: 'otp' | 'transactional';
-    /** Named/DLT provider template key (server-rendered). */
-    template?: string;
-    /** Variables substituted into `template`. */
-    variables?: Record<string, string | number>;
-    /**
-     * Replay-protection key. Two sends with the same key (per application)
-     * deliver only once — the first result is returned for every retry. Pair
-     * with the SDK's automatic 5xx retries to make sends safely repeatable.
-     */
-    idempotencyKey?: string;
-}
-interface SendMessageResult {
-    id: string;
-    status: 'accepted';
-    channel: MessageChannel;
-    provider: string;
-    accepted_at: string;
-    client_ref?: string;
-}
-interface SendOtpInput {
-    to: string;
-    code: string;
-    /** App/brand name shown inside the message. */
-    appName?: string;
-    channel?: 'auto' | MessageChannel;
-    clientRef?: string;
-    /**
-     * Override the default body. Receives `{appName, otp}`. When omitted a
-     * sensible default is used. Ignored if `template` is provided.
-     */
-    body?: (vars: {
-        appName: string;
-        otp: string;
-    }) => string;
-    /** DLT/provider template key, when the partner uses server-side rendering. */
-    template?: string;
-    /** Extra template variables (merged with `{appName, otp}`). */
-    variables?: Record<string, string | number>;
-}
-declare class SneekApiError extends Error {
-    status: number;
-    type: string;
-    title: string;
-    detail?: string | undefined;
-    constructor(status: number, type: string, title: string, detail?: string | undefined);
-}
-declare class Sneek {
-    private readonly apiUrl;
-    private readonly apiKey;
-    private readonly fetchImpl;
-    private readonly maxRetries;
-    private readonly retryBaseMs;
-    readonly messages: MessagesClient;
-    constructor(opts: SneekOptions);
-    /** @internal — dispatches a bearer-authenticated request with retries. */
-    request<T>(method: string, path: string, body?: unknown, extraHeaders?: Record<string, string>): Promise<T>;
-    private backoff;
-    /** Convenience: send an SMS. */
-    sendSMS(to: string, body: string, clientRef?: string): Promise<SendMessageResult>;
-    /** Convenience: send a WhatsApp message. */
-    sendWhatsApp(to: string, body: string, clientRef?: string): Promise<SendMessageResult>;
-    /** Convenience: send an email. */
-    sendEmail(to: string, body: string, clientRef?: string): Promise<SendMessageResult>;
-    /**
-     * OTP body-formatting helper. Sneek only *delivers*; the partner generates
-     * and verifies the code. This formats `{appName, otp}` into a body (or
-     * forwards a template) and sends it.
-     */
-    sendOTP(input: SendOtpInput): Promise<SendMessageResult>;
-}
-declare class MessagesClient {
-    private readonly sneek;
-    constructor(sneek: Sneek);
-    send(input: SendMessageInput): Promise<SendMessageResult>;
-    get(id: string): Promise<SendMessageResult>;
-}
-
-export { type MessageChannel, type SendMessageInput, type SendMessageResult, type SendOtpInput, Sneek, SneekApiError, type SneekOptions, Sneek as default };

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @sneekin/sdk — Node.js SDK for the Sneek Send API.\n *\n *   const sneek = new Sneek({\n *       apiUrl: 'https://api.sneek.in',\n *       apiKey: process.env.SNEEK_API_KEY!, // snk_live_… / snk_test_…\n *   });\n *\n *   await sneek.messages.send({ to: '+91…', body: 'Your OTP is 123456' });\n *   await sneek.sendSMS('+91…', 'Your OTP is 123456');\n *   await sneek.sendOTP({ to: '+91…', code: '123456', appName: 'ConfHub' });\n *\n * Authenticates with `Authorization: Bearer snk_…` against the server's\n * `BearerApiKeyGuard`. No request signing — the bearer key is the credential.\n */\n\nexport interface SneekOptions {\n    /** Base URL of the Sneek API, e.g. https://api.sneek.in */\n    apiUrl: string;\n    /** Bearer API key: `snk_live_…` or `snk_test_…`. */\n    apiKey: string;\n    /** Override the global fetch (for tests / non-Node runtimes). */\n    fetch?: typeof fetch;\n    /** Max retry attempts for transient failures (5xx / network). Default 2. */\n    maxRetries?: number;\n    /** Base backoff in ms between retries (exponential). Default 200. */\n    retryBaseMs?: number;\n}\n\nexport type MessageChannel = 'sms' | 'whatsapp' | 'email';\n\nexport interface SendMessageInput {\n    to: string;\n    /** Free-form message body. Required unless `template` is given. */\n    body?: string;\n    channel?: 'auto' | MessageChannel;\n    clientRef?: string;\n    /**\n     * Declares intent so the right approved provider template is used:\n     * `otp` → auth/OTP template, `transactional` → utility/communication.\n     * When omitted, Sneek infers it from the body text.\n     */\n    type?: 'otp' | 'transactional';\n    /** Named/DLT provider template key (server-rendered). */\n    template?: string;\n    /** Variables substituted into `template`. */\n    variables?: Record<string, string | number>;\n    /**\n     * Replay-protection key. Two sends with the same key (per application)\n     * deliver only once — the first result is returned for every retry. Pair\n     * with the SDK's automatic 5xx retries to make sends safely repeatable.\n     */\n    idempotencyKey?: string;\n}\n\nexport interface SendMessageResult {\n    id: string;\n    status: 'accepted';\n    channel: MessageChannel;\n    provider: string;\n    accepted_at: string;\n    client_ref?: string;\n}\n\nexport interface SendOtpInput {\n    to: string;\n    code: string;\n    /** App/brand name shown inside the message. */\n    appName?: string;\n    channel?: 'auto' | MessageChannel;\n    clientRef?: string;\n    /**\n     * Override the default body. Receives `{appName, otp}`. When omitted a\n     * sensible default is used. Ignored if `template` is provided.\n     */\n    body?: (vars: { appName: string; otp: string }) => string;\n    /** DLT/provider template key, when the partner uses server-side rendering. */\n    template?: string;\n    /** Extra template variables (merged with `{appName, otp}`). */\n    variables?: Record<string, string | number>;\n}\n\nexport class SneekApiError extends Error {\n    constructor(\n        public status: number,\n        public type: string,\n        public title: string,\n        public detail?: string,\n    ) {\n        super(`${title}${detail ? `: ${detail}` : ''} [${status}]`);\n        this.name = 'SneekApiError';\n    }\n}\n\nconst DEFAULT_MAX_RETRIES = 2;\nconst DEFAULT_RETRY_BASE_MS = 200;\n\nexport class Sneek {\n    private readonly apiUrl: string;\n    private readonly apiKey: string;\n    private readonly fetchImpl: typeof fetch;\n    private readonly maxRetries: number;\n    private readonly retryBaseMs: number;\n\n    readonly messages: MessagesClient;\n\n    constructor(opts: SneekOptions) {\n        if (!opts.apiUrl) throw new Error('apiUrl is required');\n        if (!opts.apiKey) throw new Error('apiKey is required');\n        this.apiUrl = opts.apiUrl.replace(/\\/+$/, '');\n        this.apiKey = opts.apiKey;\n        this.fetchImpl = opts.fetch ?? fetch;\n        this.maxRetries = opts.maxRetries ?? DEFAULT_MAX_RETRIES;\n        this.retryBaseMs = opts.retryBaseMs ?? DEFAULT_RETRY_BASE_MS;\n        this.messages = new MessagesClient(this);\n    }\n\n    /** @internal — dispatches a bearer-authenticated request with retries. */\n    async request<T>(\n        method: string,\n        path: string,\n        body?: unknown,\n        extraHeaders?: Record<string, string>,\n    ): Promise<T> {\n        const raw = body === undefined ? undefined : JSON.stringify(body);\n        let attempt = 0;\n        let lastErr: unknown;\n        for (;;) {\n            try {\n                const res = await this.fetchImpl(`${this.apiUrl}${path}`, {\n                    method,\n                    headers: {\n                        'content-type': 'application/json',\n                        authorization: `Bearer ${this.apiKey}`,\n                        ...(extraHeaders ?? {}),\n                    },\n                    body: raw,\n                });\n                const text = await res.text();\n                const parsed: unknown = text ? safeJson(text) : undefined;\n                if (!res.ok) {\n                    const p = (parsed ?? {}) as {\n                        type?: string;\n                        title?: string;\n                        detail?: string;\n                    };\n                    const err = new SneekApiError(\n                        res.status,\n                        p.type ?? 'about:blank',\n                        p.title ?? res.statusText,\n                        p.detail,\n                    );\n                    if (res.status >= 500 && attempt < this.maxRetries) {\n                        lastErr = err;\n                        await this.backoff(attempt++);\n                        continue;\n                    }\n                    throw err;\n                }\n                return parsed as T;\n            } catch (err) {\n                if (err instanceof SneekApiError) throw err;\n                if (attempt < this.maxRetries) {\n                    lastErr = err;\n                    await this.backoff(attempt++);\n                    continue;\n                }\n                throw lastErr ?? err;\n            }\n        }\n    }\n\n    private backoff(attempt: number): Promise<void> {\n        const ms = this.retryBaseMs * Math.pow(2, attempt);\n        return new Promise((resolve) => setTimeout(resolve, ms));\n    }\n\n    /** Convenience: send an SMS. */\n    sendSMS(to: string, body: string, clientRef?: string) {\n        return this.messages.send({ to, body, channel: 'sms', clientRef });\n    }\n\n    /** Convenience: send a WhatsApp message. */\n    sendWhatsApp(to: string, body: string, clientRef?: string) {\n        return this.messages.send({ to, body, channel: 'whatsapp', clientRef });\n    }\n\n    /** Convenience: send an email. */\n    sendEmail(to: string, body: string, clientRef?: string) {\n        return this.messages.send({ to, body, channel: 'email', clientRef });\n    }\n\n    /**\n     * OTP body-formatting helper. Sneek only *delivers*; the partner generates\n     * and verifies the code. This formats `{appName, otp}` into a body (or\n     * forwards a template) and sends it.\n     */\n    sendOTP(input: SendOtpInput): Promise<SendMessageResult> {\n        const appName = input.appName ?? 'your account';\n        if (input.template) {\n            return this.messages.send({\n                to: input.to,\n                channel: input.channel ?? 'auto',\n                clientRef: input.clientRef,\n                type: 'otp',\n                template: input.template,\n                variables: {\n                    appName,\n                    otp: input.code,\n                    ...(input.variables ?? {}),\n                },\n            });\n        }\n        const body = input.body\n            ? input.body({ appName, otp: input.code })\n            : `Your OTP to login to ${appName} is ${input.code}. Do not share it with anyone.`;\n        return this.messages.send({\n            to: input.to,\n            body,\n            channel: input.channel ?? 'auto',\n            clientRef: input.clientRef,\n            type: 'otp',\n        });\n    }\n}\n\nclass MessagesClient {\n    constructor(private readonly sneek: Sneek) {}\n\n    async send(input: SendMessageInput): Promise<SendMessageResult> {\n        if (!input.body && !input.template) {\n            throw new Error('send() requires either `body` or `template`');\n        }\n        const payload: Record<string, unknown> = {\n            to: input.to,\n            channel: input.channel ?? 'auto',\n        };\n        if (input.body !== undefined) payload.body = input.body;\n        if (input.type !== undefined) payload.type = input.type;\n        if (input.template !== undefined) payload.template = input.template;\n        if (input.variables !== undefined) payload.variables = input.variables;\n        if (input.clientRef) payload.client_ref = input.clientRef;\n        const headers = input.idempotencyKey\n            ? { 'idempotency-key': input.idempotencyKey }\n            : undefined;\n        return this.sneek.request<SendMessageResult>(\n            'POST',\n            '/api/messages/send',\n            payload,\n            headers,\n        );\n    }\n\n    async get(id: string): Promise<SendMessageResult> {\n        return this.sneek.request<SendMessageResult>(\n            'GET',\n            `/api/messages/${encodeURIComponent(id)}`,\n        );\n    }\n}\n\nfunction safeJson(s: string): unknown {\n    try {\n        return JSON.parse(s);\n    } catch {\n        return undefined;\n    }\n}\n\nexport default Sneek;\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -1,168 +0,0 @@
-// src/index.ts
-var SneekApiError = class extends Error {
-  constructor(status, type, title, detail) {
-    super(`${title}${detail ? `: ${detail}` : ""} [${status}]`);
-    this.status = status;
-    this.type = type;
-    this.title = title;
-    this.detail = detail;
-    this.name = "SneekApiError";
-  }
-};
-var DEFAULT_MAX_RETRIES = 2;
-var DEFAULT_RETRY_BASE_MS = 200;
-var Sneek = class {
-  apiUrl;
-  apiKey;
-  fetchImpl;
-  maxRetries;
-  retryBaseMs;
-  messages;
-  constructor(opts) {
-    if (!opts.apiUrl) throw new Error("apiUrl is required");
-    if (!opts.apiKey) throw new Error("apiKey is required");
-    this.apiUrl = opts.apiUrl.replace(/\/+$/, "");
-    this.apiKey = opts.apiKey;
-    this.fetchImpl = opts.fetch ?? fetch;
-    this.maxRetries = opts.maxRetries ?? DEFAULT_MAX_RETRIES;
-    this.retryBaseMs = opts.retryBaseMs ?? DEFAULT_RETRY_BASE_MS;
-    this.messages = new MessagesClient(this);
-  }
-  /** @internal — dispatches a bearer-authenticated request with retries. */
-  async request(method, path, body, extraHeaders) {
-    const raw = body === void 0 ? void 0 : JSON.stringify(body);
-    let attempt = 0;
-    let lastErr;
-    for (; ; ) {
-      try {
-        const res = await this.fetchImpl(`${this.apiUrl}${path}`, {
-          method,
-          headers: {
-            "content-type": "application/json",
-            authorization: `Bearer ${this.apiKey}`,
-            ...extraHeaders ?? {}
-          },
-          body: raw
-        });
-        const text = await res.text();
-        const parsed = text ? safeJson(text) : void 0;
-        if (!res.ok) {
-          const p = parsed ?? {};
-          const err = new SneekApiError(
-            res.status,
-            p.type ?? "about:blank",
-            p.title ?? res.statusText,
-            p.detail
-          );
-          if (res.status >= 500 && attempt < this.maxRetries) {
-            lastErr = err;
-            await this.backoff(attempt++);
-            continue;
-          }
-          throw err;
-        }
-        return parsed;
-      } catch (err) {
-        if (err instanceof SneekApiError) throw err;
-        if (attempt < this.maxRetries) {
-          lastErr = err;
-          await this.backoff(attempt++);
-          continue;
-        }
-        throw lastErr ?? err;
-      }
-    }
-  }
-  backoff(attempt) {
-    const ms = this.retryBaseMs * Math.pow(2, attempt);
-    return new Promise((resolve) => setTimeout(resolve, ms));
-  }
-  /** Convenience: send an SMS. */
-  sendSMS(to, body, clientRef) {
-    return this.messages.send({ to, body, channel: "sms", clientRef });
-  }
-  /** Convenience: send a WhatsApp message. */
-  sendWhatsApp(to, body, clientRef) {
-    return this.messages.send({ to, body, channel: "whatsapp", clientRef });
-  }
-  /** Convenience: send an email. */
-  sendEmail(to, body, clientRef) {
-    return this.messages.send({ to, body, channel: "email", clientRef });
-  }
-  /**
-   * OTP body-formatting helper. Sneek only *delivers*; the partner generates
-   * and verifies the code. This formats `{appName, otp}` into a body (or
-   * forwards a template) and sends it.
-   */
-  sendOTP(input) {
-    const appName = input.appName ?? "your account";
-    if (input.template) {
-      return this.messages.send({
-        to: input.to,
-        channel: input.channel ?? "auto",
-        clientRef: input.clientRef,
-        type: "otp",
-        template: input.template,
-        variables: {
-          appName,
-          otp: input.code,
-          ...input.variables ?? {}
-        }
-      });
-    }
-    const body = input.body ? input.body({ appName, otp: input.code }) : `Your OTP to login to ${appName} is ${input.code}. Do not share it with anyone.`;
-    return this.messages.send({
-      to: input.to,
-      body,
-      channel: input.channel ?? "auto",
-      clientRef: input.clientRef,
-      type: "otp"
-    });
-  }
-};
-var MessagesClient = class {
-  constructor(sneek) {
-    this.sneek = sneek;
-  }
-  async send(input) {
-    if (!input.body && !input.template) {
-      throw new Error("send() requires either `body` or `template`");
-    }
-    const payload = {
-      to: input.to,
-      channel: input.channel ?? "auto"
-    };
-    if (input.body !== void 0) payload.body = input.body;
-    if (input.type !== void 0) payload.type = input.type;
-    if (input.template !== void 0) payload.template = input.template;
-    if (input.variables !== void 0) payload.variables = input.variables;
-    if (input.clientRef) payload.client_ref = input.clientRef;
-    const headers = input.idempotencyKey ? { "idempotency-key": input.idempotencyKey } : void 0;
-    return this.sneek.request(
-      "POST",
-      "/api/messages/send",
-      payload,
-      headers
-    );
-  }
-  async get(id) {
-    return this.sneek.request(
-      "GET",
-      `/api/messages/${encodeURIComponent(id)}`
-    );
-  }
-};
-function safeJson(s) {
-  try {
-    return JSON.parse(s);
-  } catch {
-    return void 0;
-  }
-}
-var index_default = Sneek;
-export {
-  Sneek,
-  SneekApiError,
-  index_default as default
-};
-//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @sneekin/sdk — Node.js SDK for the Sneek Send API.\n *\n *   const sneek = new Sneek({\n *       apiUrl: 'https://api.sneek.in',\n *       apiKey: process.env.SNEEK_API_KEY!, // snk_live_… / snk_test_…\n *   });\n *\n *   await sneek.messages.send({ to: '+91…', body: 'Your OTP is 123456' });\n *   await sneek.sendSMS('+91…', 'Your OTP is 123456');\n *   await sneek.sendOTP({ to: '+91…', code: '123456', appName: 'ConfHub' });\n *\n * Authenticates with `Authorization: Bearer snk_…` against the server's\n * `BearerApiKeyGuard`. No request signing — the bearer key is the credential.\n */\n\nexport interface SneekOptions {\n    /** Base URL of the Sneek API, e.g. https://api.sneek.in */\n    apiUrl: string;\n    /** Bearer API key: `snk_live_…` or `snk_test_…`. */\n    apiKey: string;\n    /** Override the global fetch (for tests / non-Node runtimes). */\n    fetch?: typeof fetch;\n    /** Max retry attempts for transient failures (5xx / network). Default 2. */\n    maxRetries?: number;\n    /** Base backoff in ms between retries (exponential). Default 200. */\n    retryBaseMs?: number;\n}\n\nexport type MessageChannel = 'sms' | 'whatsapp' | 'email';\n\nexport interface SendMessageInput {\n    to: string;\n    /** Free-form message body. Required unless `template` is given. */\n    body?: string;\n    channel?: 'auto' | MessageChannel;\n    clientRef?: string;\n    /**\n     * Declares intent so the right approved provider template is used:\n     * `otp` → auth/OTP template, `transactional` → utility/communication.\n     * When omitted, Sneek infers it from the body text.\n     */\n    type?: 'otp' | 'transactional';\n    /** Named/DLT provider template key (server-rendered). */\n    template?: string;\n    /** Variables substituted into `template`. */\n    variables?: Record<string, string | number>;\n    /**\n     * Replay-protection key. Two sends with the same key (per application)\n     * deliver only once — the first result is returned for every retry. Pair\n     * with the SDK's automatic 5xx retries to make sends safely repeatable.\n     */\n    idempotencyKey?: string;\n}\n\nexport interface SendMessageResult {\n    id: string;\n    status: 'accepted';\n    channel: MessageChannel;\n    provider: string;\n    accepted_at: string;\n    client_ref?: string;\n}\n\nexport interface SendOtpInput {\n    to: string;\n    code: string;\n    /** App/brand name shown inside the message. */\n    appName?: string;\n    channel?: 'auto' | MessageChannel;\n    clientRef?: string;\n    /**\n     * Override the default body. Receives `{appName, otp}`. When omitted a\n     * sensible default is used. Ignored if `template` is provided.\n     */\n    body?: (vars: { appName: string; otp: string }) => string;\n    /** DLT/provider template key, when the partner uses server-side rendering. */\n    template?: string;\n    /** Extra template variables (merged with `{appName, otp}`). */\n    variables?: Record<string, string | number>;\n}\n\nexport class SneekApiError extends Error {\n    constructor(\n        public status: number,\n        public type: string,\n        public title: string,\n        public detail?: string,\n    ) {\n        super(`${title}${detail ? `: ${detail}` : ''} [${status}]`);\n        this.name = 'SneekApiError';\n    }\n}\n\nconst DEFAULT_MAX_RETRIES = 2;\nconst DEFAULT_RETRY_BASE_MS = 200;\n\nexport class Sneek {\n    private readonly apiUrl: string;\n    private readonly apiKey: string;\n    private readonly fetchImpl: typeof fetch;\n    private readonly maxRetries: number;\n    private readonly retryBaseMs: number;\n\n    readonly messages: MessagesClient;\n\n    constructor(opts: SneekOptions) {\n        if (!opts.apiUrl) throw new Error('apiUrl is required');\n        if (!opts.apiKey) throw new Error('apiKey is required');\n        this.apiUrl = opts.apiUrl.replace(/\\/+$/, '');\n        this.apiKey = opts.apiKey;\n        this.fetchImpl = opts.fetch ?? fetch;\n        this.maxRetries = opts.maxRetries ?? DEFAULT_MAX_RETRIES;\n        this.retryBaseMs = opts.retryBaseMs ?? DEFAULT_RETRY_BASE_MS;\n        this.messages = new MessagesClient(this);\n    }\n\n    /** @internal — dispatches a bearer-authenticated request with retries. */\n    async request<T>(\n        method: string,\n        path: string,\n        body?: unknown,\n        extraHeaders?: Record<string, string>,\n    ): Promise<T> {\n        const raw = body === undefined ? undefined : JSON.stringify(body);\n        let attempt = 0;\n        let lastErr: unknown;\n        for (;;) {\n            try {\n                const res = await this.fetchImpl(`${this.apiUrl}${path}`, {\n                    method,\n                    headers: {\n                        'content-type': 'application/json',\n                        authorization: `Bearer ${this.apiKey}`,\n                        ...(extraHeaders ?? {}),\n                    },\n                    body: raw,\n                });\n                const text = await res.text();\n                const parsed: unknown = text ? safeJson(text) : undefined;\n                if (!res.ok) {\n                    const p = (parsed ?? {}) as {\n                        type?: string;\n                        title?: string;\n                        detail?: string;\n                    };\n                    const err = new SneekApiError(\n                        res.status,\n                        p.type ?? 'about:blank',\n                        p.title ?? res.statusText,\n                        p.detail,\n                    );\n                    if (res.status >= 500 && attempt < this.maxRetries) {\n                        lastErr = err;\n                        await this.backoff(attempt++);\n                        continue;\n                    }\n                    throw err;\n                }\n                return parsed as T;\n            } catch (err) {\n                if (err instanceof SneekApiError) throw err;\n                if (attempt < this.maxRetries) {\n                    lastErr = err;\n                    await this.backoff(attempt++);\n                    continue;\n                }\n                throw lastErr ?? err;\n            }\n        }\n    }\n\n    private backoff(attempt: number): Promise<void> {\n        const ms = this.retryBaseMs * Math.pow(2, attempt);\n        return new Promise((resolve) => setTimeout(resolve, ms));\n    }\n\n    /** Convenience: send an SMS. */\n    sendSMS(to: string, body: string, clientRef?: string) {\n        return this.messages.send({ to, body, channel: 'sms', clientRef });\n    }\n\n    /** Convenience: send a WhatsApp message. */\n    sendWhatsApp(to: string, body: string, clientRef?: string) {\n        return this.messages.send({ to, body, channel: 'whatsapp', clientRef });\n    }\n\n    /** Convenience: send an email. */\n    sendEmail(to: string, body: string, clientRef?: string) {\n        return this.messages.send({ to, body, channel: 'email', clientRef });\n    }\n\n    /**\n     * OTP body-formatting helper. Sneek only *delivers*; the partner generates\n     * and verifies the code. This formats `{appName, otp}` into a body (or\n     * forwards a template) and sends it.\n     */\n    sendOTP(input: SendOtpInput): Promise<SendMessageResult> {\n        const appName = input.appName ?? 'your account';\n        if (input.template) {\n            return this.messages.send({\n                to: input.to,\n                channel: input.channel ?? 'auto',\n                clientRef: input.clientRef,\n                type: 'otp',\n                template: input.template,\n                variables: {\n                    appName,\n                    otp: input.code,\n                    ...(input.variables ?? {}),\n                },\n            });\n        }\n        const body = input.body\n            ? input.body({ appName, otp: input.code })\n            : `Your OTP to login to ${appName} is ${input.code}. Do not share it with anyone.`;\n        return this.messages.send({\n            to: input.to,\n            body,\n            channel: input.channel ?? 'auto',\n            clientRef: input.clientRef,\n            type: 'otp',\n        });\n    }\n}\n\nclass MessagesClient {\n    constructor(private readonly sneek: Sneek) {}\n\n    async send(input: SendMessageInput): Promise<SendMessageResult> {\n        if (!input.body && !input.template) {\n            throw new Error('send() requires either `body` or `template`');\n        }\n        const payload: Record<string, unknown> = {\n            to: input.to,\n            channel: input.channel ?? 'auto',\n        };\n        if (input.body !== undefined) payload.body = input.body;\n        if (input.type !== undefined) payload.type = input.type;\n        if (input.template !== undefined) payload.template = input.template;\n        if (input.variables !== undefined) payload.variables = input.variables;\n        if (input.clientRef) payload.client_ref = input.clientRef;\n        const headers = input.idempotencyKey\n            ? { 'idempotency-key': input.idempotencyKey }\n            : undefined;\n        return this.sneek.request<SendMessageResult>(\n            'POST',\n            '/api/messages/send',\n            payload,\n            headers,\n        );\n    }\n\n    async get(id: string): Promise<SendMessageResult> {\n        return this.sneek.request<SendMessageResult>(\n            'GET',\n            `/api/messages/${encodeURIComponent(id)}`,\n        );\n    }\n}\n\nfunction safeJson(s: string): unknown {\n    try {\n        return JSON.parse(s);\n    } catch {\n        return undefined;\n    }\n}\n\nexport default Sneek;\n"],"mappings":"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","names":[]}