sneeksdk 0.3.1

package/README.md

@@ -0,0 +1,134 @@
+# sneeksdk
+
+Node.js SDK for the **Sneek Send** API — deliver OTPs and transactional
+messages over SMS, WhatsApp, and email through Sneek's pre-approved DLT
+sender, WhatsApp BSP number, and warmed email domain.
+
+> Sneek **delivers**; your app generates and verifies its own OTP codes.
+
+## Installation
+
+```bash
+npm install sneeksdk
+```
+
+## Quick start
+
+```ts
+import { Sneek } from 'sneeksdk';
+
+const sneek = new Sneek({
+  apiUrl: process.env.SNEEK_API_URL ?? 'https://api.sneek.in',
+  apiKey: process.env.SNEEK_API_KEY!, // snk_live_… or snk_test_…
+});
+
+// Generic send (body OR template)
+await sneek.messages.send({
+  to: '+919876543210',
+  body: 'Your OTP to login to ConfHub is 482917. Do not share it.',
+  channel: 'sms', // 'auto' | 'sms' | 'whatsapp' | 'email'
+});
+
+// Channel helpers
+await sneek.sendSMS('+919876543210', 'Your code is 482917');
+await sneek.sendWhatsApp('+919876543210', 'Your code is 482917');
+await sneek.sendEmail('user@example.com', 'Your code is 482917');
+
+// OTP body-formatting helper (you generate the code yourself)
+await sneek.sendOTP({
+  to: '+919876543210',
+  code: '482917',
+  appName: 'ConfHub',
+  channel: 'auto',
+});
+
+// DLT/provider templates (server-rendered)
+await sneek.messages.send({
+  to: '+919876543210',
+  channel: 'sms',
+  template: 'otp_login',
+  variables: { appName: 'ConfHub', otp: '482917' },
+});
+```
+
+### Message intent (`type`)
+
+Declare whether a message is an OTP or a plain communication so Sneek picks the
+correct approved provider template — instead of guessing from the body text:
+
+```ts
+// Auth / OTP template
+await sneek.messages.send({ to, body: 'Your code is 482917', type: 'otp' });
+
+// Utility / communication template
+await sneek.messages.send({
+  to,
+  body: 'Your booking BK-7781 is confirmed.',
+  type: 'transactional',
+});
+```
+
+`type` accepts `'otp'` or `'transactional'`. When omitted, Sneek infers intent
+from the body (which can misclassify digit groups like `BK-7781` as an OTP), so
+**passing `type` explicitly is recommended.** `sendOTP(...)` always tags
+`type: 'otp'` for you.
+
+## Authentication
+
+Every request is sent with `Authorization: Bearer <apiKey>`. Mint keys from the
+Sneek admin (`/o/<org>/applications/<id>` → API keys). Keys are shown **once**;
+store them in your environment / secret manager. `snk_test_…` keys hit dev
+adapters; `snk_live_…` keys deliver for real.
+
+## Errors & retries
+
+- Non-2xx responses throw `SneekApiError` with `{ status, type, title, detail }`
+  (RFC-7807 problem-details).
+- Transient `5xx` and network failures are retried with exponential backoff
+  (`maxRetries`, default 2; `retryBaseMs`, default 200ms).
+
+## Idempotency & rate limits
+
+Pass `idempotencyKey` to make a send safely repeatable — the first call is
+processed and its result is replayed for any retry with the same key (per
+application), so a dropped connection never sends twice. This pairs with the
+SDK's automatic `5xx` retries.
+
+```ts
+await sneek.messages.send({
+  to: '+919876543210',
+  type: 'otp',
+  body: 'Your code is 482917',
+  idempotencyKey: 'order-4815-otp',
+});
+```
+
+Sends are rate-limited per application (your plan's per-minute / per-day quota),
+per recipient, and per source IP. Exceeding a limit throws `SneekApiError` with
+`status === 429`; the problem body carries `retry_after` (seconds).
+
+
+```ts
+import { SneekApiError } from 'sneeksdk';
+
+try {
+  await sneek.sendSMS('+91…', 'hi');
+} catch (err) {
+  if (err instanceof SneekApiError && err.status === 401) {
+    // invalid / revoked key
+  }
+}
+```
+
+## API
+
+| Method | Description |
+| --- | --- |
+| `messages.send(input)` | Send a message (body or template; optional `type` intent). Returns `202` accepted envelope. |
+| `messages.get(id)` | Fetch a previously-sent message by id. |
+| `sendSMS/sendWhatsApp/sendEmail(to, body, clientRef?)` | Channel-pinned helpers. |
+| `sendOTP({ to, code, appName?, channel?, template?, variables? })` | Format + send an OTP body. |
+
+## License
+
+UNLICENSED — © Abblor Tech Pvt Ltd.

package/dist/index.d.mts

@@ -0,0 +1,118 @@
+/**
+ * sneeksdk — 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.d.ts

@@ -0,0 +1,118 @@
+/**
+ * sneeksdk — 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

@@ -0,0 +1,194 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Sneek: () => Sneek,
+  SneekApiError: () => SneekApiError,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+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;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Sneek,
+  SneekApiError
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * sneeksdk — 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

@@ -0,0 +1,168 @@
+// 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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * sneeksdk — 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/package.json

@@ -0,0 +1,49 @@
+{
+    "name": "sneeksdk",
+    "version": "0.3.1",
+    "publishConfig": {
+        "access": "public"
+    },
+    "description": "Node.js SDK for the Sneek Messaging API",
+    "homepage": "https://sneek.in/docs",
+    "bugs": {
+        "url": "https://sneek.in/docs"
+    },
+    "main": "dist/index.js",
+    "module": "dist/index.mjs",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "type-check": "tsc --noEmit",
+        "test": "node --test --import tsx test/*.test.ts"
+    },
+    "keywords": [
+        "sneek",
+        "messaging",
+        "sms",
+        "whatsapp",
+        "email",
+        "otp"
+    ],
+    "author": "Abblor Tech Pvt Ltd <abblorltd@gmail.com> (https://sneek.in)",
+    "license": "UNLICENSED",
+    "devDependencies": {
+        "@types/node": "^20.11.0",
+        "tsup": "^8.0.0",
+        "tsx": "^4.7.0",
+        "typescript": "^5.3.3"
+    },
+    "engines": {
+        "node": ">=18"
+    }
+}