@dryinov8/zumbopay-ts 1.0.0

package/dist/chunk-YULBG3E6.mjs

@@ -0,0 +1,338 @@
+// src/phone.ts
+function normalizePhone(phone) {
+  let cleaned = phone.replace(/\D/g, "");
+  if (cleaned.startsWith("0")) {
+    cleaned = cleaned.slice(1);
+  }
+  if (cleaned.length === 9) {
+    cleaned = "258" + cleaned;
+  }
+  return cleaned;
+}
+function detectOperator(phone) {
+  const normalized = normalizePhone(phone);
+  if (normalized.length !== 12 || !normalized.startsWith("258")) {
+    return "unknown";
+  }
+  const prefix = normalized.slice(3, 5);
+  if (prefix === "84" || prefix === "85") {
+    return "mpesa";
+  }
+  if (prefix === "86" || prefix === "87") {
+    return "emola";
+  }
+  if (prefix === "82" || prefix === "83") {
+    return "mkesh";
+  }
+  return "unknown";
+}
+function getOperatorLabel(operator) {
+  switch (operator) {
+    case "mpesa":
+      return "Vodacom M-Pesa";
+    case "emola":
+      return "Movitel e-Mola";
+    case "mkesh":
+      return "Tmcel mKesh";
+    default:
+      return "Desconhecida";
+  }
+}
+function isValidMozPhone(phone) {
+  return detectOperator(phone) !== "unknown";
+}
+
+// src/client.ts
+var ZumboPayClient = class {
+  config;
+  cachedWallets = null;
+  walletsCacheExpiresAt = 0;
+  constructor(config) {
+    const envWallets = {};
+    let defaultEnabled = true;
+    if (typeof process !== "undefined" && process?.env) {
+      if (process.env.ZUMBOPAY_ENABLED !== void 0) {
+        defaultEnabled = process.env.ZUMBOPAY_ENABLED === "true" || process.env.ZUMBOPAY_ENABLED === "1";
+      }
+      if (process.env.ZUMBOPAY_WALLET_MPESA) {
+        envWallets.mpesa = process.env.ZUMBOPAY_WALLET_MPESA;
+      }
+      if (process.env.ZUMBOPAY_WALLET_EMOLA) {
+        envWallets.emola = process.env.ZUMBOPAY_WALLET_EMOLA;
+      }
+      if (process.env.ZUMBOPAY_WALLET_MKESH) {
+        envWallets.mkesh = process.env.ZUMBOPAY_WALLET_MKESH;
+      }
+      if (process.env.ZUMBOPAY_WALLET_CARD) {
+        envWallets.card = process.env.ZUMBOPAY_WALLET_CARD;
+      }
+    }
+    this.config = {
+      apiKey: config.apiKey,
+      merchantId: config.merchantId,
+      baseUrl: config.baseUrl?.replace(/\/+$/, "") || "https://zumbopay.com/api/public/v1",
+      webhookSecret: config.webhookSecret,
+      wallets: {
+        ...envWallets,
+        ...config.wallets || {}
+      },
+      enabled: config.enabled !== void 0 ? config.enabled : defaultEnabled,
+      timeout: config.timeout || 15e3
+    };
+  }
+  /**
+   * Returns whether the ZumboPay client is currently active.
+   * If false, all mutations (STK push, checkouts) are gracefully silenced.
+   */
+  isEnabled() {
+    return Boolean(this.config.enabled);
+  }
+  /**
+   * Programmatically enable or disable the gateway (kill-switch toggle).
+   */
+  setEnabled(enabled) {
+    this.config.enabled = enabled;
+  }
+  /**
+   * Returns configured base URL.
+   */
+  getBaseUrl() {
+    return this.config.baseUrl;
+  }
+  /**
+   * Resolves a valid Wallet UUID for a given operator or channel.
+   */
+  async resolveWalletId(channel) {
+    if (this.config.wallets[channel]) {
+      return this.config.wallets[channel];
+    }
+    const wallets = await this.listWallets();
+    const match = wallets.find(
+      (w) => w.is_active !== false && (w.method?.toLowerCase() === channel || w.wallet_code?.toLowerCase().includes(channel) || w.name?.toLowerCase().includes(channel))
+    );
+    if (match) {
+      return match.id;
+    }
+    const active = wallets.find((w) => w.is_active !== false);
+    return active?.id;
+  }
+  /**
+   * Resolves the proper wallet ID for a Mozambican phone number.
+   */
+  async resolveWalletIdForPhone(phone) {
+    const operator = detectOperator(phone);
+    if (operator === "unknown") {
+      return void 0;
+    }
+    return this.resolveWalletId(operator);
+  }
+  /**
+   * Initiates a direct STK Push prompt to a mobile phone (M-Pesa, e-Mola, mKesh).
+   */
+  async stkPush(request) {
+    if (!this.isEnabled()) {
+      return {
+        success: false,
+        status: "disabled",
+        reference: null,
+        message: "O gateway de pagamento ZumboPay est\xE1 temporariamente desativado."
+      };
+    }
+    const normalizedPhone = normalizePhone(request.phone);
+    const walletId = request.walletId || await this.resolveWalletIdForPhone(normalizedPhone);
+    const sourceId = request.reference || `stk-${Date.now()}`;
+    const payload = {
+      phone: normalizedPhone,
+      amount: request.amount,
+      wallet_id: walletId,
+      reference: sourceId,
+      customer_name: request.customerName,
+      description: request.description
+    };
+    try {
+      const res = await this.fetchWithTimeout("/charges", {
+        method: "POST",
+        headers: this.getHeaders(),
+        body: JSON.stringify(payload)
+      });
+      const data = await res.json().catch(() => ({}));
+      if (res.ok) {
+        const status = (data.data?.status || data.status || "pending").toLowerCase();
+        const code = data.code || data.data?.code;
+        const isSuccess = status === "success" || status === "succeeded" || status === "completed" || code === "INS-0";
+        return {
+          success: true,
+          status: isSuccess ? "success" : status,
+          reference: data.data?.reference || sourceId,
+          message: isSuccess ? "Pagamento efetuado com sucesso!" : "Pedido de pagamento enviado para o seu telem\xF3vel. Por favor confirme com o seu PIN.",
+          raw: data
+        };
+      }
+      return {
+        success: false,
+        status: "declined",
+        reference: null,
+        message: data.error?.message || data.message || "O pagamento foi recusado ou expirou no telem\xF3vel.",
+        raw: data
+      };
+    } catch (err) {
+      const error = err;
+      if (error.name === "AbortError" || error.message.includes("timeout")) {
+        return {
+          success: true,
+          status: "pending",
+          reference: sourceId,
+          message: "O pedido foi enviado. Por favor verifique o telem\xF3vel e confirme com o PIN.",
+          raw: { timeout: true }
+        };
+      }
+      return {
+        success: false,
+        status: "failed",
+        reference: null,
+        message: error.message || "Falha na comunica\xE7\xE3o com o ZumboPay."
+      };
+    }
+  }
+  /**
+   * Creates a Hosted Checkout URL for credit/debit card & multicanal payments.
+   */
+  async createCheckout(request) {
+    if (!this.isEnabled()) {
+      return {
+        success: false,
+        checkoutUrl: null,
+        reference: null,
+        message: "O gateway de pagamento ZumboPay est\xE1 temporariamente desativado."
+      };
+    }
+    const walletId = request.walletId || await this.resolveWalletId("card") || await this.resolveWalletId("mpesa");
+    const sourceId = request.reference || `chk-${Date.now()}`;
+    const payload = {
+      title: request.title,
+      amount: request.amount,
+      currency: request.currency || "MZN",
+      channels: request.channels || ["card", "mpesa", "emola", "mkesh"],
+      wallet_id: walletId,
+      reference: sourceId,
+      return_url: request.returnUrl,
+      redirect_url: request.returnUrl,
+      cancel_url: request.cancelUrl,
+      metadata: request.metadata
+    };
+    try {
+      const res = await this.fetchWithTimeout("/checkouts", {
+        method: "POST",
+        headers: this.getHeaders(),
+        body: JSON.stringify(payload)
+      });
+      const data = await res.json().catch(() => ({}));
+      if (res.ok) {
+        const checkoutUrl = data.data?.checkout_url || data.checkout_url || data.data?.url || data.url || null;
+        return {
+          success: true,
+          checkoutUrl,
+          reference: data.data?.reference || sourceId,
+          message: "Sess\xE3o de checkout criada com sucesso.",
+          raw: data
+        };
+      }
+      return {
+        success: false,
+        checkoutUrl: null,
+        reference: null,
+        message: data.error?.message || data.message || "N\xE3o foi poss\xEDvel gerar a p\xE1gina de checkout.",
+        raw: data
+      };
+    } catch (err) {
+      const error = err;
+      return {
+        success: false,
+        checkoutUrl: null,
+        reference: null,
+        message: error.message || "Erro de conex\xE3o ao criar checkout."
+      };
+    }
+  }
+  /**
+   * Queries status of an existing charge/checkout transaction.
+   */
+  async getStatus(referenceOrId) {
+    const res = await this.fetchWithTimeout(
+      `/charges/${encodeURIComponent(referenceOrId)}`,
+      {
+        method: "GET",
+        headers: this.getHeaders()
+      }
+    );
+    const data = await res.json().catch(() => ({}));
+    const payload = data.data || data;
+    const status = (payload.status || "pending").toLowerCase();
+    const isPaid = status === "success" || status === "succeeded" || status === "completed" || payload.is_paid === true;
+    return {
+      success: res.ok,
+      status,
+      paid: isPaid,
+      reference: payload.reference || referenceOrId,
+      amount: payload.amount,
+      currency: payload.currency || "MZN",
+      channel: payload.channel,
+      paidAt: payload.paid_at || payload.updated_at || null,
+      raw: data
+    };
+  }
+  /**
+   * Lists all wallets associated with the merchant account (cached for 10 minutes).
+   */
+  async listWallets() {
+    const now = Date.now();
+    if (this.cachedWallets && now < this.walletsCacheExpiresAt) {
+      return this.cachedWallets;
+    }
+    try {
+      const res = await this.fetchWithTimeout("/wallets", {
+        method: "GET",
+        headers: this.getHeaders()
+      });
+      if (res.ok) {
+        const data = await res.json();
+        this.cachedWallets = data.data || data || [];
+        this.walletsCacheExpiresAt = now + 10 * 60 * 1e3;
+        return this.cachedWallets;
+      }
+      return [];
+    } catch {
+      return [];
+    }
+  }
+  getHeaders() {
+    return {
+      Authorization: `Bearer ${this.config.apiKey}`,
+      "X-Merchant-Id": this.config.merchantId,
+      "Content-Type": "application/json",
+      Accept: "application/json"
+    };
+  }
+  async fetchWithTimeout(endpoint, options) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.config.timeout);
+    const url = `${this.config.baseUrl}${endpoint}`;
+    try {
+      return await fetch(url, {
+        ...options,
+        signal: controller.signal
+      });
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+};
+
+export {
+  normalizePhone,
+  detectOperator,
+  getOperatorLabel,
+  isValidMozPhone,
+  ZumboPayClient
+};
+//# sourceMappingURL=chunk-YULBG3E6.mjs.map

package/dist/chunk-YULBG3E6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/phone.ts","../src/client.ts"],"sourcesContent":["import type { MobileOperator } from './types.js';\n\n/**\n * Normalizes any Mozambican telephone string into the standard 12-digit format `258XXXXXXXXX`.\n * Removes spaces, hyphens, parentheses, and prefixes (+258, 258, 0).\n */\nexport function normalizePhone(phone: string): string {\n  let cleaned = phone.replace(/\\D/g, '');\n\n  // Remove leading 0 (e.g. 0841234567 -> 841234567)\n  if (cleaned.startsWith('0')) {\n    cleaned = cleaned.slice(1);\n  }\n\n  // Prepend 258 if 9-digit national number\n  if (cleaned.length === 9) {\n    cleaned = '258' + cleaned;\n  }\n\n  return cleaned;\n}\n\n/**\n * Detects mobile network operator from phone number:\n * - Vodacom (M-Pesa): 84, 85\n * - Movitel (e-Mola): 86, 87\n * - Tmcel (mKesh): 82, 83\n */\nexport function detectOperator(phone: string): MobileOperator {\n  const normalized = normalizePhone(phone);\n\n  if (normalized.length !== 12 || !normalized.startsWith('258')) {\n    return 'unknown';\n  }\n\n  const prefix = normalized.slice(3, 5);\n\n  if (prefix === '84' || prefix === '85') {\n    return 'mpesa';\n  }\n  if (prefix === '86' || prefix === '87') {\n    return 'emola';\n  }\n  if (prefix === '82' || prefix === '83') {\n    return 'mkesh';\n  }\n\n  return 'unknown';\n}\n\n/**\n * Returns human-readable label for a mobile operator.\n */\nexport function getOperatorLabel(operator: MobileOperator): string {\n  switch (operator) {\n    case 'mpesa':\n      return 'Vodacom M-Pesa';\n    case 'emola':\n      return 'Movitel e-Mola';\n    case 'mkesh':\n      return 'Tmcel mKesh';\n    default:\n      return 'Desconhecida';\n  }\n}\n\n/**\n * Validates whether the number is a valid 9-digit Mozambican mobile number (with or without 258).\n */\nexport function isValidMozPhone(phone: string): boolean {\n  return detectOperator(phone) !== 'unknown';\n}\n","import { detectOperator, normalizePhone } from './phone.js';\nimport type {\n  CheckoutRequest,\n  CheckoutResponse,\n  StkPushRequest,\n  StkPushResponse,\n  TransactionStatusResponse,\n  WalletItem,\n  ZumboPayConfig,\n  ZumboPayWallets,\n} from './types.js';\n\nexport class ZumboPayClient {\n  private readonly config: Required<\n    Omit<ZumboPayConfig, 'webhookSecret' | 'wallets'>\n  > & {\n    webhookSecret?: string;\n    wallets: ZumboPayWallets;\n  };\n\n  private cachedWallets: WalletItem[] | null = null;\n  private walletsCacheExpiresAt = 0;\n\n  constructor(config: ZumboPayConfig) {\n    const envWallets: ZumboPayWallets = {};\n    let defaultEnabled = true;\n\n    // Read environment variables if available in Node.js / server environment\n    if (typeof process !== 'undefined' && process?.env) {\n      if (process.env.ZUMBOPAY_ENABLED !== undefined) {\n        defaultEnabled =\n          process.env.ZUMBOPAY_ENABLED === 'true' ||\n          process.env.ZUMBOPAY_ENABLED === '1';\n      }\n\n      if (process.env.ZUMBOPAY_WALLET_MPESA) {\n        envWallets.mpesa = process.env.ZUMBOPAY_WALLET_MPESA;\n      }\n      if (process.env.ZUMBOPAY_WALLET_EMOLA) {\n        envWallets.emola = process.env.ZUMBOPAY_WALLET_EMOLA;\n      }\n      if (process.env.ZUMBOPAY_WALLET_MKESH) {\n        envWallets.mkesh = process.env.ZUMBOPAY_WALLET_MKESH;\n      }\n      if (process.env.ZUMBOPAY_WALLET_CARD) {\n        envWallets.card = process.env.ZUMBOPAY_WALLET_CARD;\n      }\n    }\n\n    this.config = {\n      apiKey: config.apiKey,\n      merchantId: config.merchantId,\n      baseUrl:\n        config.baseUrl?.replace(/\\/+$/, '') ||\n        'https://zumbopay.com/api/public/v1',\n      webhookSecret: config.webhookSecret,\n      wallets: {\n        ...envWallets,\n        ...(config.wallets || {}),\n      },\n      enabled: config.enabled !== undefined ? config.enabled : defaultEnabled,\n      timeout: config.timeout || 15000,\n    };\n  }\n\n  /**\n   * Returns whether the ZumboPay client is currently active.\n   * If false, all mutations (STK push, checkouts) are gracefully silenced.\n   */\n  public isEnabled(): boolean {\n    return Boolean(this.config.enabled);\n  }\n\n  /**\n   * Programmatically enable or disable the gateway (kill-switch toggle).\n   */\n  public setEnabled(enabled: boolean): void {\n    this.config.enabled = enabled;\n  }\n\n  /**\n   * Returns configured base URL.\n   */\n  public getBaseUrl(): string {\n    return this.config.baseUrl;\n  }\n\n  /**\n   * Resolves a valid Wallet UUID for a given operator or channel.\n   */\n  public async resolveWalletId(\n    channel: 'mpesa' | 'emola' | 'mkesh' | 'card'\n  ): Promise<string | undefined> {\n    // 1. Check explicitly configured wallet\n    if (this.config.wallets[channel]) {\n      return this.config.wallets[channel];\n    }\n\n    // 2. Discover dynamically from list of wallets\n    const wallets = await this.listWallets();\n    const match = wallets.find(\n      (w) =>\n        w.is_active !== false &&\n        (w.method?.toLowerCase() === channel ||\n          w.wallet_code?.toLowerCase().includes(channel) ||\n          w.name?.toLowerCase().includes(channel))\n    );\n\n    if (match) {\n      return match.id;\n    }\n\n    // 3. Fallback to any active wallet\n    const active = wallets.find((w) => w.is_active !== false);\n    return active?.id;\n  }\n\n  /**\n   * Resolves the proper wallet ID for a Mozambican phone number.\n   */\n  public async resolveWalletIdForPhone(\n    phone: string\n  ): Promise<string | undefined> {\n    const operator = detectOperator(phone);\n    if (operator === 'unknown') {\n      return undefined;\n    }\n    return this.resolveWalletId(operator);\n  }\n\n  /**\n   * Initiates a direct STK Push prompt to a mobile phone (M-Pesa, e-Mola, mKesh).\n   */\n  public async stkPush(request: StkPushRequest): Promise<StkPushResponse> {\n    if (!this.isEnabled()) {\n      return {\n        success: false,\n        status: 'disabled',\n        reference: null,\n        message:\n          'O gateway de pagamento ZumboPay está temporariamente desativado.',\n      };\n    }\n\n    const normalizedPhone = normalizePhone(request.phone);\n    const walletId =\n      request.walletId ||\n      (await this.resolveWalletIdForPhone(normalizedPhone));\n\n    const sourceId = request.reference || `stk-${Date.now()}`;\n\n    const payload = {\n      phone: normalizedPhone,\n      amount: request.amount,\n      wallet_id: walletId,\n      reference: sourceId,\n      customer_name: request.customerName,\n      description: request.description,\n    };\n\n    try {\n      const res = await this.fetchWithTimeout('/charges', {\n        method: 'POST',\n        headers: this.getHeaders(),\n        body: JSON.stringify(payload),\n      });\n\n      const data = await res.json().catch(() => ({}));\n\n      if (res.ok) {\n        const status = (\n          data.data?.status ||\n          data.status ||\n          'pending'\n        ).toLowerCase();\n        const code = data.code || data.data?.code;\n        const isSuccess =\n          status === 'success' ||\n          status === 'succeeded' ||\n          status === 'completed' ||\n          code === 'INS-0';\n\n        return {\n          success: true,\n          status: isSuccess ? 'success' : status,\n          reference: data.data?.reference || sourceId,\n          message: isSuccess\n            ? 'Pagamento efetuado com sucesso!'\n            : 'Pedido de pagamento enviado para o seu telemóvel. Por favor confirme com o seu PIN.',\n          raw: data,\n        };\n      }\n\n      return {\n        success: false,\n        status: 'declined',\n        reference: null,\n        message:\n          data.error?.message ||\n          data.message ||\n          'O pagamento foi recusado ou expirou no telemóvel.',\n        raw: data,\n      };\n    } catch (err: unknown) {\n      const error = err as Error;\n\n      // Handle USSD network timeouts gracefully as pending\n      if (error.name === 'AbortError' || error.message.includes('timeout')) {\n        return {\n          success: true,\n          status: 'pending',\n          reference: sourceId,\n          message:\n            'O pedido foi enviado. Por favor verifique o telemóvel e confirme com o PIN.',\n          raw: { timeout: true },\n        };\n      }\n\n      return {\n        success: false,\n        status: 'failed',\n        reference: null,\n        message: error.message || 'Falha na comunicação com o ZumboPay.',\n      };\n    }\n  }\n\n  /**\n   * Creates a Hosted Checkout URL for credit/debit card & multicanal payments.\n   */\n  public async createCheckout(\n    request: CheckoutRequest\n  ): Promise<CheckoutResponse> {\n    if (!this.isEnabled()) {\n      return {\n        success: false,\n        checkoutUrl: null,\n        reference: null,\n        message:\n          'O gateway de pagamento ZumboPay está temporariamente desativado.',\n      };\n    }\n\n    const walletId =\n      request.walletId ||\n      (await this.resolveWalletId('card')) ||\n      (await this.resolveWalletId('mpesa'));\n\n    const sourceId = request.reference || `chk-${Date.now()}`;\n\n    const payload = {\n      title: request.title,\n      amount: request.amount,\n      currency: request.currency || 'MZN',\n      channels: request.channels || ['card', 'mpesa', 'emola', 'mkesh'],\n      wallet_id: walletId,\n      reference: sourceId,\n      return_url: request.returnUrl,\n      redirect_url: request.returnUrl,\n      cancel_url: request.cancelUrl,\n      metadata: request.metadata,\n    };\n\n    try {\n      const res = await this.fetchWithTimeout('/checkouts', {\n        method: 'POST',\n        headers: this.getHeaders(),\n        body: JSON.stringify(payload),\n      });\n\n      const data = await res.json().catch(() => ({}));\n\n      if (res.ok) {\n        const checkoutUrl =\n          data.data?.checkout_url ||\n          data.checkout_url ||\n          data.data?.url ||\n          data.url ||\n          null;\n\n        return {\n          success: true,\n          checkoutUrl,\n          reference: data.data?.reference || sourceId,\n          message: 'Sessão de checkout criada com sucesso.',\n          raw: data,\n        };\n      }\n\n      return {\n        success: false,\n        checkoutUrl: null,\n        reference: null,\n        message:\n          data.error?.message ||\n          data.message ||\n          'Não foi possível gerar a página de checkout.',\n        raw: data,\n      };\n    } catch (err: unknown) {\n      const error = err as Error;\n      return {\n        success: false,\n        checkoutUrl: null,\n        reference: null,\n        message: error.message || 'Erro de conexão ao criar checkout.',\n      };\n    }\n  }\n\n  /**\n   * Queries status of an existing charge/checkout transaction.\n   */\n  public async getStatus(\n    referenceOrId: string\n  ): Promise<TransactionStatusResponse> {\n    const res = await this.fetchWithTimeout(\n      `/charges/${encodeURIComponent(referenceOrId)}`,\n      {\n        method: 'GET',\n        headers: this.getHeaders(),\n      }\n    );\n\n    const data = await res.json().catch(() => ({}));\n    const payload = data.data || data;\n    const status = (payload.status || 'pending').toLowerCase();\n    const isPaid =\n      status === 'success' ||\n      status === 'succeeded' ||\n      status === 'completed' ||\n      payload.is_paid === true;\n\n    return {\n      success: res.ok,\n      status,\n      paid: isPaid,\n      reference: payload.reference || referenceOrId,\n      amount: payload.amount,\n      currency: payload.currency || 'MZN',\n      channel: payload.channel,\n      paidAt: payload.paid_at || payload.updated_at || null,\n      raw: data,\n    };\n  }\n\n  /**\n   * Lists all wallets associated with the merchant account (cached for 10 minutes).\n   */\n  public async listWallets(): Promise<WalletItem[]> {\n    const now = Date.now();\n    if (this.cachedWallets && now < this.walletsCacheExpiresAt) {\n      return this.cachedWallets;\n    }\n\n    try {\n      const res = await this.fetchWithTimeout('/wallets', {\n        method: 'GET',\n        headers: this.getHeaders(),\n      });\n\n      if (res.ok) {\n        const data = await res.json();\n        this.cachedWallets = (data.data || data || []) as WalletItem[];\n        this.walletsCacheExpiresAt = now + 10 * 60 * 1000;\n        return this.cachedWallets;\n      }\n      return [];\n    } catch {\n      return [];\n    }\n  }\n\n  private getHeaders(): Record<string, string> {\n    return {\n      Authorization: `Bearer ${this.config.apiKey}`,\n      'X-Merchant-Id': this.config.merchantId,\n      'Content-Type': 'application/json',\n      Accept: 'application/json',\n    };\n  }\n\n  private async fetchWithTimeout(\n    endpoint: string,\n    options: RequestInit\n  ): Promise<Response> {\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.config.timeout);\n\n    const url = `${this.config.baseUrl}${endpoint}`;\n\n    try {\n      return await fetch(url, {\n        ...options,\n        signal: controller.signal,\n      });\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/client-CO8dBkq7.d.mts

@@ -0,0 +1,188 @@
+type MobileOperator = 'mpesa' | 'emola' | 'mkesh' | 'unknown';
+type PaymentStatus = 'pending' | 'processing' | 'success' | 'succeeded' | 'completed' | 'failed' | 'declined' | 'cancelled' | 'expired' | 'disabled';
+interface ZumboPayWallets {
+    mpesa?: string;
+    emola?: string;
+    mkesh?: string;
+    card?: string;
+    [key: string]: string | undefined;
+}
+interface ZumboPayConfig {
+    /**
+     * ZumboPay Secret API Key
+     */
+    apiKey: string;
+    /**
+     * ZumboPay Merchant ID
+     */
+    merchantId: string;
+    /**
+     * Base API URL (defaults to https://zumbopay.com/api/public/v1)
+     */
+    baseUrl?: string;
+    /**
+     * Webhook signing secret for HMAC verification
+     */
+    webhookSecret?: string;
+    /**
+     * Pre-configured Wallet UUIDs for specific channels
+     */
+    wallets?: ZumboPayWallets;
+    /**
+     * Global kill-switch / activation toggle.
+     * If false, all checkout and STK push operations are gracefully silenced
+     * and return a disabled status without making external network calls.
+     * Defaults to true (or checks process.env.ZUMBOPAY_ENABLED when available).
+     */
+    enabled?: boolean;
+    /**
+     * Request timeout in milliseconds (defaults to 15000)
+     */
+    timeout?: number;
+}
+interface StkPushRequest {
+    /**
+     * Amount in Principal currency units (e.g. 150.00 MZN)
+     */
+    amount: number;
+    /**
+     * Mozambican phone number (Vodacom, Movitel, or Tmcel)
+     */
+    phone: string;
+    /**
+     * Commercial transaction reference / order ID
+     */
+    reference?: string;
+    /**
+     * Customer full name
+     */
+    customerName?: string;
+    /**
+     * Specific Wallet UUID (optional, will be auto-resolved from phone if omitted)
+     */
+    walletId?: string;
+    /**
+     * Description / note
+     */
+    description?: string;
+}
+interface StkPushResponse {
+    success: boolean;
+    status: PaymentStatus;
+    reference: string | null;
+    message: string;
+    raw?: Record<string, unknown>;
+}
+interface CheckoutRequest {
+    /**
+     * Amount in Principal currency units (e.g. 500.00 MZN)
+     */
+    amount: number;
+    /**
+     * Payment title / product name
+     */
+    title: string;
+    /**
+     * Currency code (defaults to MZN)
+     */
+    currency?: string;
+    /**
+     * Commercial transaction reference / order ID
+     */
+    reference?: string;
+    /**
+     * Return URL after successful payment
+     */
+    returnUrl?: string;
+    /**
+     * Cancel URL if user aborts
+     */
+    cancelUrl?: string;
+    /**
+     * Allowed payment channels (defaults to ['card', 'mpesa', 'emola', 'mkesh'])
+     */
+    channels?: string[];
+    /**
+     * Specific Wallet UUID
+     */
+    walletId?: string;
+    /**
+     * Additional metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+interface CheckoutResponse {
+    success: boolean;
+    checkoutUrl: string | null;
+    reference: string | null;
+    message: string;
+    raw?: Record<string, unknown>;
+}
+interface TransactionStatusResponse {
+    success: boolean;
+    status: PaymentStatus;
+    paid: boolean;
+    reference: string;
+    amount?: number;
+    currency?: string;
+    channel?: string;
+    paidAt?: string | null;
+    raw?: Record<string, unknown>;
+}
+interface WalletItem {
+    id: string;
+    wallet_code?: string;
+    name?: string;
+    method?: string;
+    currency?: string;
+    balance?: number;
+    is_active?: boolean;
+}
+
+declare class ZumboPayClient {
+    private readonly config;
+    private cachedWallets;
+    private walletsCacheExpiresAt;
+    constructor(config: ZumboPayConfig);
+    /**
+     * Returns whether the ZumboPay client is currently active.
+     * If false, all mutations (STK push, checkouts) are gracefully silenced.
+     */
+    isEnabled(): boolean;
+    /**
+     * Programmatically enable or disable the gateway (kill-switch toggle).
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Returns configured base URL.
+     */
+    getBaseUrl(): string;
+    /**
+     * Resolves a valid Wallet UUID for a given operator or channel.
+     */
+    resolveWalletId(channel: 'mpesa' | 'emola' | 'mkesh' | 'card'): Promise<string | undefined>;
+    /**
+     * Resolves the proper wallet ID for a Mozambican phone number.
+     */
+    resolveWalletIdForPhone(phone: string): Promise<string | undefined>;
+    /**
+     * Initiates a direct STK Push prompt to a mobile phone (M-Pesa, e-Mola, mKesh).
+     */
+    stkPush(request: StkPushRequest): Promise<StkPushResponse>;
+    /**
+     * Creates a Hosted Checkout URL for credit/debit card & multicanal payments.
+     */
+    createCheckout(request: CheckoutRequest): Promise<CheckoutResponse>;
+    /**
+     * Queries status of an existing charge/checkout transaction.
+     */
+    getStatus(referenceOrId: string): Promise<TransactionStatusResponse>;
+    /**
+     * Lists all wallets associated with the merchant account (cached for 10 minutes).
+     */
+    listWallets(): Promise<WalletItem[]>;
+    private getHeaders;
+    private fetchWithTimeout;
+}
+
+export { type CheckoutRequest as C, type MobileOperator as M, type PaymentStatus as P, type StkPushRequest as S, type TransactionStatusResponse as T, type WalletItem as W, ZumboPayClient as Z, type CheckoutResponse as a, type StkPushResponse as b, type ZumboPayConfig as c, type ZumboPayWallets as d };