@nile-squad/nylonpay-ts 1.0.9 → 1.1.0

package/dist/index.js

@@ -147,6 +147,7 @@ var KNOWN_CATEGORIES = /* @__PURE__ */ new Set([
   "rate_limit",
   "account",
   "provider",
+  "duplicate",
   "not_found",
   "internal",
   "network",
@@ -372,6 +373,7 @@ function parseError(error) {
 
 // src/payment.ts
 var STATUS_TO_EVENT = {
+  pending: "processing",
   successful: "success",
   failed: "failed",
   processing: "processing",
@@ -395,6 +397,7 @@ function createPaymentInstance(initialResponse, deps) {
     status: normalizeStatus(initialResponse.status),
     transaction: null,
     pollingTimer: null,
+    lastStatusEvent: null,
     resolved: false,
     pollAttempts: 0,
     pollStartTime: Date.now(),
@@ -413,6 +416,7 @@ function createPaymentInstance(initialResponse, deps) {
   function emitEvent(event, error, category, retryable) {
     const data = {
       event,
+      reference: state.reference,
       transaction: state.transaction ?? void 0,
       error,
       category,
@@ -449,18 +453,17 @@ function createPaymentInstance(initialResponse, deps) {
       return;
     }
     const newStatus = normalizeStatus(response.status);
-    const oldStatus = state.status;
     state.status = newStatus;
-    if (newStatus !== oldStatus) {
-      const event = statusToEvent(newStatus);
-      if (event) {
-        if (TERMINAL_STATES.has(newStatus)) {
-          await handleTerminalState(newStatus);
-          return;
-        }
-        emitEvent(event);
-      }
+    const event = statusToEvent(newStatus);
+    if (!event || event === state.lastStatusEvent) {
+      return;
+    }
+    state.lastStatusEvent = event;
+    if (TERMINAL_STATES.has(newStatus)) {
+      await handleTerminalState(newStatus);
+      return;
     }
+    emitEvent(event);
   }
   function handlePollError(error) {
     const parsed = parseError(error);
@@ -514,6 +517,15 @@ function createPaymentInstance(initialResponse, deps) {
       }, 0);
       return;
     }
+    const initialEvent = statusToEvent(state.status);
+    if (initialEvent) {
+      state.lastStatusEvent = initialEvent;
+      setTimeout(() => {
+        if (!state.resolved) {
+          emitEvent(initialEvent);
+        }
+      }, 0);
+    }
     scheduleNextPoll();
   }
   function stopUpdates() {
@@ -593,6 +605,15 @@ function createPaymentInstance(initialResponse, deps) {
   }
   return paymentInstance;
 }
+
+// src/phone.ts
+function normalizePhone(phone) {
+  let normalized = phone.replace(/\s+/g, "").replace(/^\+/, "");
+  if (normalized.startsWith("0") && normalized.length === 10) {
+    normalized = `256${normalized.slice(1)}`;
+  }
+  return normalized;
+}
 var DEFAULT_TOLERANCE_SECONDS = 300;
 function decodePayload(payload) {
   return typeof payload === "string" ? payload : Buffer.from(payload).toString("utf8");
@@ -668,10 +689,21 @@ async function runHook(hook, ...args) {
 function throwValidation(message) {
   throw createSdkError({ category: "validation", message });
 }
-function validateAmount(amount) {
+function validateCollectionAmount(amount) {
+  if (!Number.isInteger(amount) || amount <= 0) {
+    throwValidation("amount must be a positive integer");
+  }
+  if (amount < 500) {
+    throwValidation("Collection amount must be at least 500 UGX");
+  }
+}
+function validatePayoutAmount(amount) {
   if (!Number.isInteger(amount) || amount <= 0) {
     throwValidation("amount must be a positive integer");
   }
+  if (amount < 5e3) {
+    throwValidation("Payout amount must be at least 5000 UGX");
+  }
 }
 function validateNonEmpty(value, fieldName) {
   if (!value || value.trim() === "") {
@@ -702,14 +734,19 @@ function createSdkInstance(config) {
   };
   async function collectPayment(input) {
     const reference = resolveReference(input.reference);
-    validateAmount(input.amount);
+    validateCollectionAmount(input.amount);
     validateNonEmpty(input.customer.name, "customer.name");
     validateNonEmpty(input.customer.phoneNumber, "customer.phoneNumber");
+    const normalizedPhone = normalizePhone(input.customer.phoneNumber);
     validateNonEmpty(input.description, "description");
     if (input.method === "bank" && !input.bank) {
       throwValidation('bank details are required when method is "bank"');
     }
-    let payload = { ...input, reference };
+    let payload = {
+      ...input,
+      reference,
+      customer: { ...input.customer, phoneNumber: normalizedPhone }
+    };
     const mutated = await runHook(config.hooks?.beforeCollect, payload);
     if (mutated != null)
       payload = { ...mutated, reference: mutated.reference ?? reference };
@@ -733,14 +770,19 @@ function createSdkInstance(config) {
   }
   async function collectPaymentAndResolve(input) {
     const reference = resolveReference(input.reference);
-    validateAmount(input.amount);
+    validateCollectionAmount(input.amount);
     validateNonEmpty(input.customer.name, "customer.name");
     validateNonEmpty(input.customer.phoneNumber, "customer.phoneNumber");
+    const normalizedPhone = normalizePhone(input.customer.phoneNumber);
     validateNonEmpty(input.description, "description");
     if (input.method === "bank" && !input.bank) {
       throwValidation('bank details are required when method is "bank"');
     }
-    let payload = { ...input, reference };
+    let payload = {
+      ...input,
+      reference,
+      customer: { ...input.customer, phoneNumber: normalizedPhone }
+    };
     const mutated = await runHook(config.hooks?.beforeCollect, payload);
     if (mutated != null)
       payload = { ...mutated, reference: mutated.reference ?? reference };
@@ -760,9 +802,10 @@ function createSdkInstance(config) {
   }
   async function makePayout(input) {
     const reference = resolveReference(input.reference);
-    validateAmount(input.amount);
+    validatePayoutAmount(input.amount);
     validateNonEmpty(input.customer.name, "customer.name");
     validateNonEmpty(input.customer.phoneNumber, "customer.phoneNumber");
+    const normalizedPhone = normalizePhone(input.customer.phoneNumber);
     validateNonEmpty(input.description, "description");
     validateNonEmpty(
       input.destination.accountHolderName,
@@ -772,7 +815,11 @@ function createSdkInstance(config) {
       input.destination.accountNumber,
       "destination.accountNumber"
     );
-    let payload = { ...input, reference };
+    let payload = {
+      ...input,
+      reference,
+      customer: { ...input.customer, phoneNumber: normalizedPhone }
+    };
     const mutated = await runHook(config.hooks?.beforePayout, payload);
     if (mutated != null)
       payload = { ...mutated, reference: mutated.reference ?? reference };
@@ -796,9 +843,10 @@ function createSdkInstance(config) {
   }
   async function makePayoutAndResolve(input) {
     const reference = resolveReference(input.reference);
-    validateAmount(input.amount);
+    validatePayoutAmount(input.amount);
     validateNonEmpty(input.customer.name, "customer.name");
     validateNonEmpty(input.customer.phoneNumber, "customer.phoneNumber");
+    const normalizedPhone = normalizePhone(input.customer.phoneNumber);
     validateNonEmpty(input.description, "description");
     validateNonEmpty(
       input.destination.accountHolderName,
@@ -808,7 +856,11 @@ function createSdkInstance(config) {
       input.destination.accountNumber,
       "destination.accountNumber"
     );
-    let payload = { ...input, reference };
+    let payload = {
+      ...input,
+      reference,
+      customer: { ...input.customer, phoneNumber: normalizedPhone }
+    };
     const mutated = await runHook(config.hooks?.beforePayout, payload);
     if (mutated != null)
       payload = { ...mutated, reference: mutated.reference ?? reference };
@@ -852,9 +904,10 @@ function createSdkInstance(config) {
   }
   async function verifyPhone(input) {
     validateNonEmpty(input.phoneNumber, "phoneNumber");
+    const normalizedPhone = normalizePhone(input.phoneNumber);
     const result = await transport.send({
       action: SDK_ACTIONS.verifyPhone,
-      payload: input
+      payload: { ...input, phoneNumber: normalizedPhone }
     });
     if (result.isOk) {
       return Ok(result.value);
@@ -863,7 +916,7 @@ function createSdkInstance(config) {
   }
   async function createInvoice(input) {
     const reference = resolveReference(input.reference);
-    validateAmount(input.amount);
+    validateCollectionAmount(input.amount);
     validateNonEmpty(input.description, "description");
     if (input.items) {
       if (input.items.length > 50) {