@laranex/myanmar-payments 4.0.0-dev.8 → 4.0.0-dev.9

package/CHANGELOG.md

@@ -32,3 +32,4 @@ Initial release. The version number matches the other Laranex Myanmar payments p
 - `Amount.equals()` compares by value, ignoring leading zeros too (`'01000'` equals `Amount.kyat(1000)`); text that is not plain digits with an optional fraction is never equal.
 - `CallbackRequest.rawBody` holds the exact bytes received (a string body is encoded as UTF-8), next to `body` as text, like Python's `raw_body` and Go's `Body`.
 - `WaveMoneyPaymentData` takes optional `merchantName` and `timeToLiveSeconds`, which override the configured `merchantName` and `timeToLiveSeconds` for one payment (request hash included); a blank `merchantName` or a `timeToLiveSeconds` that is not a whole number greater than 0 throws `InvalidPaymentDataError`, like the PHP SDK.
+- `KbzPayPaymentData.timeoutMinutes` is renamed to `timeToLiveSeconds` and takes seconds, like Wave Money: 60 to 7200, in whole minutes (a multiple of 60), because KBZ's `timeout_express` counts minutes (`1800` is sent as `30m`). Upgrading: multiply the old value by 60.

package/dist/cjs/kbz-pay/kbz-pay.d.ts

@@ -58,8 +58,11 @@ export interface KbzPayPaymentData {
     callbackUrl: string;
     /** The product name shown to the customer. */
     title?: string | undefined;
-    /** How long the order stays payable, 1 to 120 minutes. KBZ defaults to 120. */
-    timeoutMinutes?: number | undefined;
+    /**
+     * Seconds the customer has to pay before the order expires, 60 to 7200 in whole minutes (a multiple
+     * of 60). KBZ counts minutes, so 1800 is sent as `30m`. KBZ defaults to 7200 (120 minutes).
+     */
+    timeToLiveSeconds?: number | undefined;
     /** Free text KBZ sends back unchanged in the callback, at most 512 characters once URL-encoded. */
     callbackInfo?: string | undefined;
 }

package/dist/cjs/kbz-pay/kbz-pay.js

@@ -93,7 +93,8 @@ class KbzPay {
             .max('callbackUrl', callbackUrl, 512)
             .when(callbackUrl.includes('?'), 'callbackUrl', 'The callbackUrl field must not contain a query string.')
             .string('title', data.title)
-            .between('timeoutMinutes', data.timeoutMinutes, 1, 120)
+            .between('timeToLiveSeconds', data.timeToLiveSeconds, 60, 7200)
+            .when(Number.isInteger(data.timeToLiveSeconds) && data.timeToLiveSeconds % 60 !== 0, 'timeToLiveSeconds', 'The timeToLiveSeconds field must be a multiple of 60.')
             .string('callbackInfo', data.callbackInfo)
             .max('callbackInfo', typeof data.callbackInfo === 'string' ? (0, crypto_js_1.queryEscape)(data.callbackInfo) : undefined, 512)
             .validate();
@@ -126,9 +127,9 @@ class KbzPay {
         return new results_js_1.QrPayment({
             orderId: data.orderId,
             qrString: qrCode,
-            expiresAt: data.timeoutMinutes === undefined
+            expiresAt: data.timeToLiveSeconds === undefined
                 ? undefined
-                : new Date(Date.now() + data.timeoutMinutes * 60_000),
+                : new Date(Date.now() + data.timeToLiveSeconds * 1000),
             reference: order.prepayId,
             raw: (0, json_js_1.toPlainObject)(order.response),
         });
@@ -199,8 +200,8 @@ class KbzPay {
         if (data.title) {
             biz.title = data.title;
         }
-        if (data.timeoutMinutes !== undefined) {
-            biz.timeout_express = `${data.timeoutMinutes}m`;
+        if (data.timeToLiveSeconds !== undefined) {
+            biz.timeout_express = `${data.timeToLiveSeconds / 60}m`;
         }
         if (data.callbackInfo) {
             biz.callback_info = (0, crypto_js_1.queryEscape)(data.callbackInfo);

package/dist/esm/kbz-pay/kbz-pay.d.ts

@@ -58,8 +58,11 @@ export interface KbzPayPaymentData {
     callbackUrl: string;
     /** The product name shown to the customer. */
     title?: string | undefined;
-    /** How long the order stays payable, 1 to 120 minutes. KBZ defaults to 120. */
-    timeoutMinutes?: number | undefined;
+    /**
+     * Seconds the customer has to pay before the order expires, 60 to 7200 in whole minutes (a multiple
+     * of 60). KBZ counts minutes, so 1800 is sent as `30m`. KBZ defaults to 7200 (120 minutes).
+     */
+    timeToLiveSeconds?: number | undefined;
     /** Free text KBZ sends back unchanged in the callback, at most 512 characters once URL-encoded. */
     callbackInfo?: string | undefined;
 }

package/dist/esm/kbz-pay/kbz-pay.js

@@ -90,7 +90,8 @@ export class KbzPay {
             .max('callbackUrl', callbackUrl, 512)
             .when(callbackUrl.includes('?'), 'callbackUrl', 'The callbackUrl field must not contain a query string.')
             .string('title', data.title)
-            .between('timeoutMinutes', data.timeoutMinutes, 1, 120)
+            .between('timeToLiveSeconds', data.timeToLiveSeconds, 60, 7200)
+            .when(Number.isInteger(data.timeToLiveSeconds) && data.timeToLiveSeconds % 60 !== 0, 'timeToLiveSeconds', 'The timeToLiveSeconds field must be a multiple of 60.')
             .string('callbackInfo', data.callbackInfo)
             .max('callbackInfo', typeof data.callbackInfo === 'string' ? queryEscape(data.callbackInfo) : undefined, 512)
             .validate();
@@ -123,9 +124,9 @@ export class KbzPay {
         return new QrPayment({
             orderId: data.orderId,
             qrString: qrCode,
-            expiresAt: data.timeoutMinutes === undefined
+            expiresAt: data.timeToLiveSeconds === undefined
                 ? undefined
-                : new Date(Date.now() + data.timeoutMinutes * 60_000),
+                : new Date(Date.now() + data.timeToLiveSeconds * 1000),
             reference: order.prepayId,
             raw: toPlainObject(order.response),
         });
@@ -196,8 +197,8 @@ export class KbzPay {
         if (data.title) {
             biz.title = data.title;
         }
-        if (data.timeoutMinutes !== undefined) {
-            biz.timeout_express = `${data.timeoutMinutes}m`;
+        if (data.timeToLiveSeconds !== undefined) {
+            biz.timeout_express = `${data.timeToLiveSeconds / 60}m`;
         }
         if (data.callbackInfo) {
             biz.callback_info = queryEscape(data.callbackInfo);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laranex/myanmar-payments",
-  "version": "4.0.0-dev.8",
+  "version": "4.0.0-dev.9",
   "description": "Node.js SDK for Myanmar payment gateways: KBZ Pay, Wave Money, AYA Pay, Yoma MMQR and CyberSource. Typed requests and results, exact amounts, no runtime dependencies.",
   "keywords": [
     "laranex",