@narcisbodea/smstunnel-sdk 1.1.0 → 1.1.2

package/dist/node/index.d.ts

@@ -0,0 +1,228 @@
+/**
+ * SMSTunnel Node.js Client
+ *
+ * Standalone client that connects directly to the SMSTunnel API.
+ * Works in Node.js (18+) without NestJS or any framework.
+ *
+ * @example
+ * ```typescript
+ * import { SmsTunnelNodeClient } from '@narcisbodea/smstunnel-sdk/node';
+ *
+ * const client = new SmsTunnelNodeClient({
+ *   apiKey: 'sk_live_xxx',
+ *   serverUrl: 'https://smstunnel.io',
+ * });
+ *
+ * // Send SMS
+ * const result = await client.sendSms('+40721123456', 'Hello!');
+ *
+ * // E2E: check status, get public key, send encrypted
+ * const e2e = await client.getDeviceE2EStatus('device-id');
+ * ```
+ */
+interface SmsTunnelNodeClientOptions {
+    /** SMSTunnel API key (sk_live_...) */
+    apiKey: string;
+    /** SMSTunnel server URL (default: https://smstunnel.io) */
+    serverUrl?: string;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
+interface SendSmsResponse {
+    success: boolean;
+    messageId?: string;
+    queued?: boolean;
+    data?: {
+        messageId: string;
+        branded: boolean;
+        queued?: boolean;
+        remaining: {
+            clean: number;
+            total: number | string;
+        };
+    };
+    error?: string;
+}
+interface SendBulkSmsResponse {
+    success: boolean;
+    data?: {
+        messageIds: string[];
+        branded: boolean;
+        count: number;
+        remaining: {
+            clean: number;
+            total: number | string;
+        };
+    };
+    error?: string;
+}
+interface MessageStatusResponse {
+    success: boolean;
+    data?: {
+        id: string;
+        phoneNumber: string;
+        status: 'pending' | 'sent' | 'delivered' | 'failed';
+        sentAt?: string;
+        deliveredAt?: string;
+        errorMessage?: string | null;
+    };
+    error?: string;
+}
+interface DevicesResponse {
+    success: boolean;
+    data?: {
+        devices: Array<{
+            id: string;
+            name: string;
+            isOnline: boolean;
+            lastSeen?: string;
+        }>;
+        online: number;
+        total: number;
+    };
+    error?: string;
+}
+interface AccountUsageResponse {
+    success: boolean;
+    data?: Record<string, any>;
+    error?: string;
+}
+interface ReceivedSmsResponse {
+    success: boolean;
+    data?: {
+        messages: Array<{
+            id: string;
+            from: string;
+            body: string;
+            receivedAt: string;
+            deviceId: string;
+        }>;
+        total: number;
+        page: number;
+    };
+    error?: string;
+}
+interface DeviceE2EStatus {
+    encryptionEnabled: boolean;
+    hasPublicKey: boolean;
+    publicKeyFingerprint?: string;
+    keyCreatedAt?: string;
+}
+interface DevicePublicKeyInfo {
+    deviceId: string;
+    deviceName: string;
+    publicKey: string;
+}
+interface VerifyDeviceKeyResult {
+    valid: boolean;
+    currentFingerprint?: string;
+    needsRePairing: boolean;
+}
+interface E2EPairingResponse {
+    success: boolean;
+    data?: {
+        token: string;
+        qrData: string;
+        expiresAt: string;
+    };
+    error?: string;
+}
+interface E2EPairingStatusResponse {
+    success: boolean;
+    data?: {
+        status: 'pending' | 'completed' | 'expired';
+        publicKey?: string;
+        publicKeyFingerprint?: string;
+        deviceId?: string;
+        deviceName?: string;
+    };
+    error?: string;
+}
+interface PairingTokenStatusResponse {
+    status: 'pending' | 'completed' | 'expired';
+    source?: string;
+    displayName?: string;
+    pairedDeviceId?: string;
+    pairingId?: string;
+}
+declare class SmsTunnelNodeClient {
+    private readonly apiKey;
+    private readonly serverUrl;
+    private readonly timeout;
+    constructor(options: SmsTunnelNodeClientOptions);
+    /** Send a single SMS */
+    sendSms(to: string, message: string, deviceId?: string): Promise<SendSmsResponse>;
+    /** Send 2FA SMS */
+    send2FaSms(to: string, message: string): Promise<SendSmsResponse>;
+    /** Send bulk SMS */
+    sendBulkSms(to: string[], message: string, deviceId?: string): Promise<SendBulkSmsResponse>;
+    /** Get message delivery status */
+    getMessageStatus(messageId: string): Promise<MessageStatusResponse>;
+    /** Get received SMS (inbox) */
+    getReceivedSms(params?: {
+        limit?: number;
+        page?: number;
+        since?: string;
+        phone?: string;
+        deviceId?: string;
+    }): Promise<ReceivedSmsResponse>;
+    /** List devices */
+    getDevices(): Promise<DevicesResponse>;
+    /** Get account usage stats */
+    getUsage(): Promise<AccountUsageResponse>;
+    /** Get E2E encryption status for a device */
+    getDeviceE2EStatus(deviceId: string): Promise<{
+        success: boolean;
+        data: DeviceE2EStatus;
+    }>;
+    /** Get device public key for E2E encryption */
+    getDevicePublicKey(deviceId: string): Promise<{
+        success: boolean;
+        data: DevicePublicKeyInfo;
+    }>;
+    /**
+     * Verify that a stored fingerprint matches the current device key.
+     * If it doesn't match, the device was reinstalled and re-pairing is needed.
+     */
+    verifyDeviceKey(deviceId: string, storedFingerprint: string): Promise<VerifyDeviceKeyResult>;
+    /** Send encrypted SMS (payload already encrypted with device RSA public key) */
+    sendEncryptedSms(encryptedPayload: string, deviceId: string, options?: {
+        is2FA?: boolean;
+        expectedFingerprint?: string;
+    }): Promise<SendSmsResponse>;
+    /** Create E2E pairing request (generates QR code) */
+    createE2EPairing(params?: {
+        siteName?: string;
+        siteUrl?: string;
+    }): Promise<E2EPairingResponse>;
+    /** Get E2E pairing status (poll this after creating a pairing) */
+    getE2EPairingStatus(token: string): Promise<E2EPairingStatusResponse>;
+    /** Create pairing token (unified v2 flow) */
+    createPairingToken(params: {
+        source: 'dashboard' | 'wordpress' | 'enterprise' | 'saas' | 'api' | 'e2e';
+        displayName: string;
+        displayUrl?: string;
+        context?: Record<string, any>;
+        expiresInMinutes?: number;
+    }): Promise<any>;
+    /** Get pairing token status (for polling) */
+    getPairingTokenStatus(token: string): Promise<PairingTokenStatusResponse>;
+    /** List all active pairings */
+    listPairings(): Promise<any[]>;
+    /** Unpair (revoke) a pairing */
+    unpair(pairingId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Poll E2E pairing until completed, expired, or timeout.
+     * Returns the final status.
+     */
+    pollE2EPairing(token: string, options?: {
+        intervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<E2EPairingStatusResponse>;
+    private get;
+    private post;
+}
+
+export { type AccountUsageResponse, type DeviceE2EStatus, type DevicePublicKeyInfo, type DevicesResponse, type E2EPairingResponse, type E2EPairingStatusResponse, type MessageStatusResponse, type PairingTokenStatusResponse, type ReceivedSmsResponse, type SendBulkSmsResponse, type SendSmsResponse, SmsTunnelNodeClient, type SmsTunnelNodeClientOptions, type VerifyDeviceKeyResult };

package/dist/node/index.js

@@ -0,0 +1,208 @@
+"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/node/index.ts
+var node_exports = {};
+__export(node_exports, {
+  SmsTunnelNodeClient: () => SmsTunnelNodeClient
+});
+module.exports = __toCommonJS(node_exports);
+var SmsTunnelNodeClient = class {
+  constructor(options) {
+    if (!options.apiKey) {
+      throw new Error("API key is required");
+    }
+    this.apiKey = options.apiKey;
+    this.serverUrl = (options.serverUrl || "https://smstunnel.io").replace(/\/$/, "");
+    this.timeout = options.timeout || 3e4;
+  }
+  // ─── SMS ────────────────────────────────────────────
+  /** Send a single SMS */
+  async sendSms(to, message, deviceId) {
+    return this.post("/api/v1/sms/send", { to, message, deviceId });
+  }
+  /** Send 2FA SMS */
+  async send2FaSms(to, message) {
+    return this.post("/api/v1/sms/send-2fa", { to, message });
+  }
+  /** Send bulk SMS */
+  async sendBulkSms(to, message, deviceId) {
+    return this.post("/api/v1/sms/send-bulk", { to, message, deviceId });
+  }
+  /** Get message delivery status */
+  async getMessageStatus(messageId) {
+    return this.get(`/api/v1/sms/status/${messageId}`);
+  }
+  /** Get received SMS (inbox) */
+  async getReceivedSms(params) {
+    const query = new URLSearchParams();
+    if (params?.limit) query.set("limit", String(params.limit));
+    if (params?.page) query.set("page", String(params.page));
+    if (params?.since) query.set("since", params.since);
+    if (params?.phone) query.set("phone", params.phone);
+    if (params?.deviceId) query.set("deviceId", params.deviceId);
+    const qs = query.toString();
+    return this.get(`/api/v1/sms/received${qs ? "?" + qs : ""}`);
+  }
+  // ─── Devices ────────────────────────────────────────
+  /** List devices */
+  async getDevices() {
+    return this.get("/api/v1/devices");
+  }
+  /** Get account usage stats */
+  async getUsage() {
+    return this.get("/api/v1/account/usage");
+  }
+  // ─── E2E Encryption ────────────────────────────────
+  /** Get E2E encryption status for a device */
+  async getDeviceE2EStatus(deviceId) {
+    return this.get(`/api/v1/devices/${encodeURIComponent(deviceId)}/e2e-status`);
+  }
+  /** Get device public key for E2E encryption */
+  async getDevicePublicKey(deviceId) {
+    return this.get(`/api/v1/devices/${encodeURIComponent(deviceId)}/public-key`);
+  }
+  /**
+   * Verify that a stored fingerprint matches the current device key.
+   * If it doesn't match, the device was reinstalled and re-pairing is needed.
+   */
+  async verifyDeviceKey(deviceId, storedFingerprint) {
+    const res = await this.getDeviceE2EStatus(deviceId);
+    const status = res.data;
+    if (!status?.hasPublicKey || !status?.publicKeyFingerprint) {
+      return { valid: false, needsRePairing: true };
+    }
+    const matches = status.publicKeyFingerprint === storedFingerprint;
+    return {
+      valid: matches,
+      currentFingerprint: status.publicKeyFingerprint,
+      needsRePairing: !matches
+    };
+  }
+  /** Send encrypted SMS (payload already encrypted with device RSA public key) */
+  async sendEncryptedSms(encryptedPayload, deviceId, options) {
+    if (options?.expectedFingerprint) {
+      const verification = await this.verifyDeviceKey(deviceId, options.expectedFingerprint);
+      if (verification.needsRePairing) {
+        return {
+          success: false,
+          error: "Device key changed since last pairing, re-pairing needed"
+        };
+      }
+    }
+    return this.post("/api/v1/sms/send", {
+      encrypted: true,
+      encryptedPayload,
+      deviceId,
+      is2FA: options?.is2FA || false
+    });
+  }
+  // ─── E2E Pairing ───────────────────────────────────
+  /** Create E2E pairing request (generates QR code) */
+  async createE2EPairing(params) {
+    return this.post("/api/v1/e2e/pair", params || {});
+  }
+  /** Get E2E pairing status (poll this after creating a pairing) */
+  async getE2EPairingStatus(token) {
+    return this.get(`/api/v1/e2e/pair/${encodeURIComponent(token)}`);
+  }
+  // ─── Unified Pairing v2 ────────────────────────────
+  /** Create pairing token (unified v2 flow) */
+  async createPairingToken(params) {
+    return this.post("/api/v1/pairing/create", params);
+  }
+  /** Get pairing token status (for polling) */
+  async getPairingTokenStatus(token) {
+    return this.get(`/api/v1/pairing/${encodeURIComponent(token)}`);
+  }
+  /** List all active pairings */
+  async listPairings() {
+    return this.get("/api/v1/pairings");
+  }
+  /** Unpair (revoke) a pairing */
+  async unpair(pairingId) {
+    return this.post(`/api/v1/unpair/${encodeURIComponent(pairingId)}`, {});
+  }
+  // ─── Helpers ────────────────────────────────────────
+  /**
+   * Poll E2E pairing until completed, expired, or timeout.
+   * Returns the final status.
+   */
+  async pollE2EPairing(token, options) {
+    const interval = options?.intervalMs || 2e3;
+    const timeout = options?.timeoutMs || 3e5;
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+      const status = await this.getE2EPairingStatus(token);
+      if (status.data?.status !== "pending") {
+        return status;
+      }
+      await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+    return { success: true, data: { status: "expired" } };
+  }
+  // ─── Internal ──────────────────────────────────────
+  async get(path) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const res = await fetch(`${this.serverUrl}${path}`, {
+        headers: {
+          "X-API-Key": this.apiKey,
+          "Content-Type": "application/json"
+        },
+        signal: controller.signal
+      });
+      const data = await res.json();
+      if (!res.ok) {
+        throw new Error(data?.message || data?.error || `HTTP ${res.status}`);
+      }
+      return data;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  async post(path, body) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const res = await fetch(`${this.serverUrl}${path}`, {
+        method: "POST",
+        headers: {
+          "X-API-Key": this.apiKey,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+      const data = await res.json();
+      if (!res.ok) {
+        throw new Error(data?.message || data?.error || `HTTP ${res.status}`);
+      }
+      return data;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SmsTunnelNodeClient
+});
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/node/index.ts"],"sourcesContent":["/**\r\n * SMSTunnel Node.js Client\r\n *\r\n * Standalone client that connects directly to the SMSTunnel API.\r\n * Works in Node.js (18+) without NestJS or any framework.\r\n *\r\n * @example\r\n * ```typescript\r\n * import { SmsTunnelNodeClient } from '@narcisbodea/smstunnel-sdk/node';\r\n *\r\n * const client = new SmsTunnelNodeClient({\r\n *   apiKey: 'sk_live_xxx',\r\n *   serverUrl: 'https://smstunnel.io',\r\n * });\r\n *\r\n * // Send SMS\r\n * const result = await client.sendSms('+40721123456', 'Hello!');\r\n *\r\n * // E2E: check status, get public key, send encrypted\r\n * const e2e = await client.getDeviceE2EStatus('device-id');\r\n * ```\r\n */\r\n\r\n// ─── Options ────────────────────────────────────────\r\n\r\nexport interface SmsTunnelNodeClientOptions {\r\n  /** SMSTunnel API key (sk_live_...) */\r\n  apiKey: string;\r\n  /** SMSTunnel server URL (default: https://smstunnel.io) */\r\n  serverUrl?: string;\r\n  /** Request timeout in ms (default: 30000) */\r\n  timeout?: number;\r\n}\r\n\r\n// ─── Response types ─────────────────────────────────\r\n\r\nexport interface SendSmsResponse {\r\n  success: boolean;\r\n  messageId?: string;\r\n  queued?: boolean;\r\n  data?: {\r\n    messageId: string;\r\n    branded: boolean;\r\n    queued?: boolean;\r\n    remaining: { clean: number; total: number | string };\r\n  };\r\n  error?: string;\r\n}\r\n\r\nexport interface SendBulkSmsResponse {\r\n  success: boolean;\r\n  data?: {\r\n    messageIds: string[];\r\n    branded: boolean;\r\n    count: number;\r\n    remaining: { clean: number; total: number | string };\r\n  };\r\n  error?: string;\r\n}\r\n\r\nexport interface MessageStatusResponse {\r\n  success: boolean;\r\n  data?: {\r\n    id: string;\r\n    phoneNumber: string;\r\n    status: 'pending' | 'sent' | 'delivered' | 'failed';\r\n    sentAt?: string;\r\n    deliveredAt?: string;\r\n    errorMessage?: string | null;\r\n  };\r\n  error?: string;\r\n}\r\n\r\nexport interface DevicesResponse {\r\n  success: boolean;\r\n  data?: {\r\n    devices: Array<{\r\n      id: string;\r\n      name: string;\r\n      isOnline: boolean;\r\n      lastSeen?: string;\r\n    }>;\r\n    online: number;\r\n    total: number;\r\n  };\r\n  error?: string;\r\n}\r\n\r\nexport interface AccountUsageResponse {\r\n  success: boolean;\r\n  data?: Record<string, any>;\r\n  error?: string;\r\n}\r\n\r\nexport interface ReceivedSmsResponse {\r\n  success: boolean;\r\n  data?: {\r\n    messages: Array<{\r\n      id: string;\r\n      from: string;\r\n      body: string;\r\n      receivedAt: string;\r\n      deviceId: string;\r\n    }>;\r\n    total: number;\r\n    page: number;\r\n  };\r\n  error?: string;\r\n}\r\n\r\n// ─── E2E types ──────────────────────────────────────\r\n\r\nexport interface DeviceE2EStatus {\r\n  encryptionEnabled: boolean;\r\n  hasPublicKey: boolean;\r\n  publicKeyFingerprint?: string;\r\n  keyCreatedAt?: string;\r\n}\r\n\r\nexport interface DevicePublicKeyInfo {\r\n  deviceId: string;\r\n  deviceName: string;\r\n  publicKey: string;\r\n}\r\n\r\nexport interface VerifyDeviceKeyResult {\r\n  valid: boolean;\r\n  currentFingerprint?: string;\r\n  needsRePairing: boolean;\r\n}\r\n\r\n// ─── Pairing types ──────────────────────────────────\r\n\r\nexport interface E2EPairingResponse {\r\n  success: boolean;\r\n  data?: {\r\n    token: string;\r\n    qrData: string;\r\n    expiresAt: string;\r\n  };\r\n  error?: string;\r\n}\r\n\r\nexport interface E2EPairingStatusResponse {\r\n  success: boolean;\r\n  data?: {\r\n    status: 'pending' | 'completed' | 'expired';\r\n    publicKey?: string;\r\n    publicKeyFingerprint?: string;\r\n    deviceId?: string;\r\n    deviceName?: string;\r\n  };\r\n  error?: string;\r\n}\r\n\r\nexport interface PairingTokenStatusResponse {\r\n  status: 'pending' | 'completed' | 'expired';\r\n  source?: string;\r\n  displayName?: string;\r\n  pairedDeviceId?: string;\r\n  pairingId?: string;\r\n}\r\n\r\n// ─── Client ─────────────────────────────────────────\r\n\r\nexport class SmsTunnelNodeClient {\r\n  private readonly apiKey: string;\r\n  private readonly serverUrl: string;\r\n  private readonly timeout: number;\r\n\r\n  constructor(options: SmsTunnelNodeClientOptions) {\r\n    if (!options.apiKey) {\r\n      throw new Error('API key is required');\r\n    }\r\n    this.apiKey = options.apiKey;\r\n    this.serverUrl = (options.serverUrl || 'https://smstunnel.io').replace(/\\/$/, '');\r\n    this.timeout = options.timeout || 30000;\r\n  }\r\n\r\n  // ─── SMS ────────────────────────────────────────────\r\n\r\n  /** Send a single SMS */\r\n  async sendSms(to: string, message: string, deviceId?: string): Promise<SendSmsResponse> {\r\n    return this.post('/api/v1/sms/send', { to, message, deviceId });\r\n  }\r\n\r\n  /** Send 2FA SMS */\r\n  async send2FaSms(to: string, message: string): Promise<SendSmsResponse> {\r\n    return this.post('/api/v1/sms/send-2fa', { to, message });\r\n  }\r\n\r\n  /** Send bulk SMS */\r\n  async sendBulkSms(\r\n    to: string[],\r\n    message: string,\r\n    deviceId?: string,\r\n  ): Promise<SendBulkSmsResponse> {\r\n    return this.post('/api/v1/sms/send-bulk', { to, message, deviceId });\r\n  }\r\n\r\n  /** Get message delivery status */\r\n  async getMessageStatus(messageId: string): Promise<MessageStatusResponse> {\r\n    return this.get(`/api/v1/sms/status/${messageId}`);\r\n  }\r\n\r\n  /** Get received SMS (inbox) */\r\n  async getReceivedSms(params?: {\r\n    limit?: number;\r\n    page?: number;\r\n    since?: string;\r\n    phone?: string;\r\n    deviceId?: string;\r\n  }): Promise<ReceivedSmsResponse> {\r\n    const query = new URLSearchParams();\r\n    if (params?.limit) query.set('limit', String(params.limit));\r\n    if (params?.page) query.set('page', String(params.page));\r\n    if (params?.since) query.set('since', params.since);\r\n    if (params?.phone) query.set('phone', params.phone);\r\n    if (params?.deviceId) query.set('deviceId', params.deviceId);\r\n    const qs = query.toString();\r\n    return this.get(`/api/v1/sms/received${qs ? '?' + qs : ''}`);\r\n  }\r\n\r\n  // ─── Devices ────────────────────────────────────────\r\n\r\n  /** List devices */\r\n  async getDevices(): Promise<DevicesResponse> {\r\n    return this.get('/api/v1/devices');\r\n  }\r\n\r\n  /** Get account usage stats */\r\n  async getUsage(): Promise<AccountUsageResponse> {\r\n    return this.get('/api/v1/account/usage');\r\n  }\r\n\r\n  // ─── E2E Encryption ────────────────────────────────\r\n\r\n  /** Get E2E encryption status for a device */\r\n  async getDeviceE2EStatus(deviceId: string): Promise<{ success: boolean; data: DeviceE2EStatus }> {\r\n    return this.get(`/api/v1/devices/${encodeURIComponent(deviceId)}/e2e-status`);\r\n  }\r\n\r\n  /** Get device public key for E2E encryption */\r\n  async getDevicePublicKey(deviceId: string): Promise<{ success: boolean; data: DevicePublicKeyInfo }> {\r\n    return this.get(`/api/v1/devices/${encodeURIComponent(deviceId)}/public-key`);\r\n  }\r\n\r\n  /**\r\n   * Verify that a stored fingerprint matches the current device key.\r\n   * If it doesn't match, the device was reinstalled and re-pairing is needed.\r\n   */\r\n  async verifyDeviceKey(deviceId: string, storedFingerprint: string): Promise<VerifyDeviceKeyResult> {\r\n    const res = await this.getDeviceE2EStatus(deviceId);\r\n    const status = res.data;\r\n    if (!status?.hasPublicKey || !status?.publicKeyFingerprint) {\r\n      return { valid: false, needsRePairing: true };\r\n    }\r\n    const matches = status.publicKeyFingerprint === storedFingerprint;\r\n    return {\r\n      valid: matches,\r\n      currentFingerprint: status.publicKeyFingerprint,\r\n      needsRePairing: !matches,\r\n    };\r\n  }\r\n\r\n  /** Send encrypted SMS (payload already encrypted with device RSA public key) */\r\n  async sendEncryptedSms(\r\n    encryptedPayload: string,\r\n    deviceId: string,\r\n    options?: { is2FA?: boolean; expectedFingerprint?: string },\r\n  ): Promise<SendSmsResponse> {\r\n    // Verify E2E status before sending\r\n    if (options?.expectedFingerprint) {\r\n      const verification = await this.verifyDeviceKey(deviceId, options.expectedFingerprint);\r\n      if (verification.needsRePairing) {\r\n        return {\r\n          success: false,\r\n          error: 'Device key changed since last pairing, re-pairing needed',\r\n        };\r\n      }\r\n    }\r\n\r\n    return this.post('/api/v1/sms/send', {\r\n      encrypted: true,\r\n      encryptedPayload,\r\n      deviceId,\r\n      is2FA: options?.is2FA || false,\r\n    });\r\n  }\r\n\r\n  // ─── E2E Pairing ───────────────────────────────────\r\n\r\n  /** Create E2E pairing request (generates QR code) */\r\n  async createE2EPairing(params?: {\r\n    siteName?: string;\r\n    siteUrl?: string;\r\n  }): Promise<E2EPairingResponse> {\r\n    return this.post('/api/v1/e2e/pair', params || {});\r\n  }\r\n\r\n  /** Get E2E pairing status (poll this after creating a pairing) */\r\n  async getE2EPairingStatus(token: string): Promise<E2EPairingStatusResponse> {\r\n    return this.get(`/api/v1/e2e/pair/${encodeURIComponent(token)}`);\r\n  }\r\n\r\n  // ─── Unified Pairing v2 ────────────────────────────\r\n\r\n  /** Create pairing token (unified v2 flow) */\r\n  async createPairingToken(params: {\r\n    source: 'dashboard' | 'wordpress' | 'enterprise' | 'saas' | 'api' | 'e2e';\r\n    displayName: string;\r\n    displayUrl?: string;\r\n    context?: Record<string, any>;\r\n    expiresInMinutes?: number;\r\n  }): Promise<any> {\r\n    return this.post('/api/v1/pairing/create', params);\r\n  }\r\n\r\n  /** Get pairing token status (for polling) */\r\n  async getPairingTokenStatus(token: string): Promise<PairingTokenStatusResponse> {\r\n    return this.get(`/api/v1/pairing/${encodeURIComponent(token)}`);\r\n  }\r\n\r\n  /** List all active pairings */\r\n  async listPairings(): Promise<any[]> {\r\n    return this.get('/api/v1/pairings');\r\n  }\r\n\r\n  /** Unpair (revoke) a pairing */\r\n  async unpair(pairingId: string): Promise<{ success: boolean }> {\r\n    return this.post(`/api/v1/unpair/${encodeURIComponent(pairingId)}`, {});\r\n  }\r\n\r\n  // ─── Helpers ────────────────────────────────────────\r\n\r\n  /**\r\n   * Poll E2E pairing until completed, expired, or timeout.\r\n   * Returns the final status.\r\n   */\r\n  async pollE2EPairing(\r\n    token: string,\r\n    options?: { intervalMs?: number; timeoutMs?: number },\r\n  ): Promise<E2EPairingStatusResponse> {\r\n    const interval = options?.intervalMs || 2000;\r\n    const timeout = options?.timeoutMs || 300000; // 5 min default\r\n    const start = Date.now();\r\n\r\n    while (Date.now() - start < timeout) {\r\n      const status = await this.getE2EPairingStatus(token);\r\n      if (status.data?.status !== 'pending') {\r\n        return status;\r\n      }\r\n      await new Promise((resolve) => setTimeout(resolve, interval));\r\n    }\r\n\r\n    return { success: true, data: { status: 'expired' } };\r\n  }\r\n\r\n  // ─── Internal ──────────────────────────────────────\r\n\r\n  private async get<T = any>(path: string): Promise<T> {\r\n    const controller = new AbortController();\r\n    const timer = setTimeout(() => controller.abort(), this.timeout);\r\n\r\n    try {\r\n      const res = await fetch(`${this.serverUrl}${path}`, {\r\n        headers: {\r\n          'X-API-Key': this.apiKey,\r\n          'Content-Type': 'application/json',\r\n        },\r\n        signal: controller.signal,\r\n      });\r\n\r\n      const data = await res.json();\r\n      if (!res.ok) {\r\n        throw new Error(data?.message || data?.error || `HTTP ${res.status}`);\r\n      }\r\n      return data as T;\r\n    } finally {\r\n      clearTimeout(timer);\r\n    }\r\n  }\r\n\r\n  private async post<T = any>(path: string, body: any): Promise<T> {\r\n    const controller = new AbortController();\r\n    const timer = setTimeout(() => controller.abort(), this.timeout);\r\n\r\n    try {\r\n      const res = await fetch(`${this.serverUrl}${path}`, {\r\n        method: 'POST',\r\n        headers: {\r\n          'X-API-Key': this.apiKey,\r\n          'Content-Type': 'application/json',\r\n        },\r\n        body: JSON.stringify(body),\r\n        signal: controller.signal,\r\n      });\r\n\r\n      const data = await res.json();\r\n      if (!res.ok) {\r\n        throw new Error(data?.message || data?.error || `HTTP ${res.status}`);\r\n      }\r\n      return data as T;\r\n    } finally {\r\n      clearTimeout(timer);\r\n    }\r\n  }\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/node/index.mjs

@@ -0,0 +1,183 @@
+// src/node/index.ts
+var SmsTunnelNodeClient = class {
+  constructor(options) {
+    if (!options.apiKey) {
+      throw new Error("API key is required");
+    }
+    this.apiKey = options.apiKey;
+    this.serverUrl = (options.serverUrl || "https://smstunnel.io").replace(/\/$/, "");
+    this.timeout = options.timeout || 3e4;
+  }
+  // ─── SMS ────────────────────────────────────────────
+  /** Send a single SMS */
+  async sendSms(to, message, deviceId) {
+    return this.post("/api/v1/sms/send", { to, message, deviceId });
+  }
+  /** Send 2FA SMS */
+  async send2FaSms(to, message) {
+    return this.post("/api/v1/sms/send-2fa", { to, message });
+  }
+  /** Send bulk SMS */
+  async sendBulkSms(to, message, deviceId) {
+    return this.post("/api/v1/sms/send-bulk", { to, message, deviceId });
+  }
+  /** Get message delivery status */
+  async getMessageStatus(messageId) {
+    return this.get(`/api/v1/sms/status/${messageId}`);
+  }
+  /** Get received SMS (inbox) */
+  async getReceivedSms(params) {
+    const query = new URLSearchParams();
+    if (params?.limit) query.set("limit", String(params.limit));
+    if (params?.page) query.set("page", String(params.page));
+    if (params?.since) query.set("since", params.since);
+    if (params?.phone) query.set("phone", params.phone);
+    if (params?.deviceId) query.set("deviceId", params.deviceId);
+    const qs = query.toString();
+    return this.get(`/api/v1/sms/received${qs ? "?" + qs : ""}`);
+  }
+  // ─── Devices ────────────────────────────────────────
+  /** List devices */
+  async getDevices() {
+    return this.get("/api/v1/devices");
+  }
+  /** Get account usage stats */
+  async getUsage() {
+    return this.get("/api/v1/account/usage");
+  }
+  // ─── E2E Encryption ────────────────────────────────
+  /** Get E2E encryption status for a device */
+  async getDeviceE2EStatus(deviceId) {
+    return this.get(`/api/v1/devices/${encodeURIComponent(deviceId)}/e2e-status`);
+  }
+  /** Get device public key for E2E encryption */
+  async getDevicePublicKey(deviceId) {
+    return this.get(`/api/v1/devices/${encodeURIComponent(deviceId)}/public-key`);
+  }
+  /**
+   * Verify that a stored fingerprint matches the current device key.
+   * If it doesn't match, the device was reinstalled and re-pairing is needed.
+   */
+  async verifyDeviceKey(deviceId, storedFingerprint) {
+    const res = await this.getDeviceE2EStatus(deviceId);
+    const status = res.data;
+    if (!status?.hasPublicKey || !status?.publicKeyFingerprint) {
+      return { valid: false, needsRePairing: true };
+    }
+    const matches = status.publicKeyFingerprint === storedFingerprint;
+    return {
+      valid: matches,
+      currentFingerprint: status.publicKeyFingerprint,
+      needsRePairing: !matches
+    };
+  }
+  /** Send encrypted SMS (payload already encrypted with device RSA public key) */
+  async sendEncryptedSms(encryptedPayload, deviceId, options) {
+    if (options?.expectedFingerprint) {
+      const verification = await this.verifyDeviceKey(deviceId, options.expectedFingerprint);
+      if (verification.needsRePairing) {
+        return {
+          success: false,
+          error: "Device key changed since last pairing, re-pairing needed"
+        };
+      }
+    }
+    return this.post("/api/v1/sms/send", {
+      encrypted: true,
+      encryptedPayload,
+      deviceId,
+      is2FA: options?.is2FA || false
+    });
+  }
+  // ─── E2E Pairing ───────────────────────────────────
+  /** Create E2E pairing request (generates QR code) */
+  async createE2EPairing(params) {
+    return this.post("/api/v1/e2e/pair", params || {});
+  }
+  /** Get E2E pairing status (poll this after creating a pairing) */
+  async getE2EPairingStatus(token) {
+    return this.get(`/api/v1/e2e/pair/${encodeURIComponent(token)}`);
+  }
+  // ─── Unified Pairing v2 ────────────────────────────
+  /** Create pairing token (unified v2 flow) */
+  async createPairingToken(params) {
+    return this.post("/api/v1/pairing/create", params);
+  }
+  /** Get pairing token status (for polling) */
+  async getPairingTokenStatus(token) {
+    return this.get(`/api/v1/pairing/${encodeURIComponent(token)}`);
+  }
+  /** List all active pairings */
+  async listPairings() {
+    return this.get("/api/v1/pairings");
+  }
+  /** Unpair (revoke) a pairing */
+  async unpair(pairingId) {
+    return this.post(`/api/v1/unpair/${encodeURIComponent(pairingId)}`, {});
+  }
+  // ─── Helpers ────────────────────────────────────────
+  /**
+   * Poll E2E pairing until completed, expired, or timeout.
+   * Returns the final status.
+   */
+  async pollE2EPairing(token, options) {
+    const interval = options?.intervalMs || 2e3;
+    const timeout = options?.timeoutMs || 3e5;
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+      const status = await this.getE2EPairingStatus(token);
+      if (status.data?.status !== "pending") {
+        return status;
+      }
+      await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+    return { success: true, data: { status: "expired" } };
+  }
+  // ─── Internal ──────────────────────────────────────
+  async get(path) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const res = await fetch(`${this.serverUrl}${path}`, {
+        headers: {
+          "X-API-Key": this.apiKey,
+          "Content-Type": "application/json"
+        },
+        signal: controller.signal
+      });
+      const data = await res.json();
+      if (!res.ok) {
+        throw new Error(data?.message || data?.error || `HTTP ${res.status}`);
+      }
+      return data;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  async post(path, body) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const res = await fetch(`${this.serverUrl}${path}`, {
+        method: "POST",
+        headers: {
+          "X-API-Key": this.apiKey,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+      const data = await res.json();
+      if (!res.ok) {
+        throw new Error(data?.message || data?.error || `HTTP ${res.status}`);
+      }
+      return data;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+};
+export {
+  SmsTunnelNodeClient
+};
+//# sourceMappingURL=index.mjs.map