@inno-isw/react-native-rtp 0.1.0 → 0.2.0

package/lib/module/validate.js

@@ -64,11 +64,53 @@ export function toRtpRequest(payload) {
     payee: payload.payee,
     narration: payload.narration,
     transactionRef: payload.transactionRef,
+    orderNumber: payload.orderNumber,
+    deepLink: payload.deepLink,
+    actionMessage: payload.actionMessage,
     expiresAt: payload.expiresAt,
     recipient: payload.recipient
   };
 }
 
+/**
+ * Build a partial-request patch from an incoming payload, copying only the
+ * fields that are actually present. Used to overlay retrieved backend details
+ * without a partial response erasing data already held from the push.
+ */
+export function toRequestPatch(payload) {
+  const patch = {};
+  if (payload.rtpId !== undefined) patch.id = payload.rtpId;
+  if (payload.amount !== undefined) patch.amount = toAmount(payload.amount);
+  if (payload.currency !== undefined) patch.currency = payload.currency;
+  if (payload.payer !== undefined) patch.payer = payload.payer;
+  if (payload.payee !== undefined) patch.payee = payload.payee;
+  if (payload.narration !== undefined) patch.narration = payload.narration;
+  if (payload.transactionRef !== undefined) patch.transactionRef = payload.transactionRef;
+  if (payload.orderNumber !== undefined) patch.orderNumber = payload.orderNumber;
+  if (payload.deepLink !== undefined) patch.deepLink = payload.deepLink;
+  if (payload.actionMessage !== undefined) patch.actionMessage = payload.actionMessage;
+  if (payload.expiresAt !== undefined) patch.expiresAt = payload.expiresAt;
+  if (payload.recipient !== undefined) patch.recipient = payload.recipient;
+  return patch;
+}
+
+/**
+ * Overlay a patch onto an existing request. Only defined, non-null values are
+ * copied so a partial response never erases information already held.
+ */
+export function mergeRequest(current, patch) {
+  const next = {
+    ...current
+  };
+  for (const key of Object.keys(patch)) {
+    const value = patch[key];
+    if (value !== undefined && value !== null) {
+      next[key] = value;
+    }
+  }
+  return next;
+}
+
 /** Pure expiry check. Re-evaluated on every transition, not just on receive. */
 export function isExpired(request, now) {
   const expiry = new Date(request.expiresAt).getTime();

package/lib/module/validate.js.map

@@ -1 +1 @@
-{"version":3,"names":["REQUIRED_FIELDS","isRtpPayload","payload","candidate","type","rtpId","findValidationErrors","errors","record","field","undefined","push","expiresAt","Number","isNaN","Date","getTime","side","party","name","toAmount","value","parsed","toRtpRequest","id","amount","currency","payer","payee","narration","transactionRef","recipient","isExpired","request","now","expiry"],"sourceRoot":"../../src","sources":["validate.ts"],"mappings":";;AAEA;AACA,MAAMA,eAAe,GAAG,CACtB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,OAAO,EACP,OAAO,EACP,WAAW,CACH;;AAEV;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAACC,OAAgB,EAAyB;EACpE,IAAI,CAACA,OAAO,IAAI,OAAOA,OAAO,KAAK,QAAQ,EAAE;IAC3C,OAAO,KAAK;EACd;EACA,MAAMC,SAAS,GAAGD,OAAkC;EACpD,OAAOC,SAAS,CAACC,IAAI,KAAK,KAAK,IAAI,OAAOD,SAAS,CAACE,KAAK,KAAK,QAAQ;AACxE;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAACJ,OAAmB,EAAY;EAClE,MAAMK,MAAgB,GAAG,EAAE;EAC3B,MAAMC,MAAM,GAAGN,OAA6C;EAE5D,KAAK,MAAMO,KAAK,IAAIT,eAAe,EAAE;IACnC,IAAIQ,MAAM,CAACC,KAAK,CAAC,KAAKC,SAAS,IAAIF,MAAM,CAACC,KAAK,CAAC,KAAK,IAAI,EAAE;MACzDF,MAAM,CAACI,IAAI,CAACF,KAAK,CAAC;IACpB;EACF;EAEA,IACEP,OAAO,CAACU,SAAS,KAAKF,SAAS,IAC/BG,MAAM,CAACC,KAAK,CAAC,IAAIC,IAAI,CAACb,OAAO,CAACU,SAAS,CAAC,CAACI,OAAO,CAAC,CAAC,CAAC,EACnD;IACAT,MAAM,CAACI,IAAI,CAAC,WAAW,CAAC;EAC1B;EAEA,KAAK,MAAMM,IAAI,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAW;IAC9C,MAAMC,KAAK,GAAGhB,OAAO,CAACe,IAAI,CAAyB;IACnD,IAAI,CAACC,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,IAAI,OAAOA,KAAK,CAACC,IAAI,KAAK,QAAQ,EAAE;MACzEZ,MAAM,CAACI,IAAI,CAAC,GAAGM,IAAI,OAAO,CAAC;IAC7B;EACF;EAEA,OAAOV,MAAM;AACf;;AAEA;AACA,SAASa,QAAQA,CAACC,KAAc,EAAU;EACxC,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;IAC7B,OAAOA,KAAK;EACd;EACA,MAAMC,MAAM,GAAGT,MAAM,CAACQ,KAAK,CAAC;EAC5B,OAAOR,MAAM,CAACC,KAAK,CAACQ,MAAM,CAAC,GAAG,CAAC,GAAGA,MAAM;AAC1C;;AAEA;AACA,OAAO,SAASC,YAAYA,CAACrB,OAAmB,EAAc;EAC5D,OAAO;IACLsB,EAAE,EAAEtB,OAAO,CAACG,KAAK;IACjBoB,MAAM,EAAEL,QAAQ,CAAClB,OAAO,CAACuB,MAAM,CAAC;IAChCC,QAAQ,EAAExB,OAAO,CAACwB,QAAQ;IAC1BC,KAAK,EAAEzB,OAAO,CAACyB,KAAK;IACpBC,KAAK,EAAE1B,OAAO,CAAC0B,KAAK;IACpBC,SAAS,EAAE3B,OAAO,CAAC2B,SAAS;IAC5BC,cAAc,EAAE5B,OAAO,CAAC4B,cAAc;IACtClB,SAAS,EAAEV,OAAO,CAACU,SAAS;IAC5BmB,SAAS,EAAE7B,OAAO,CAAC6B;EACrB,CAAC;AACH;;AAEA;AACA,OAAO,SAASC,SAASA,CAACC,OAAmB,EAAEC,GAAW,EAAW;EACnE,MAAMC,MAAM,GAAG,IAAIpB,IAAI,CAACkB,OAAO,CAACrB,SAAS,CAAC,CAACI,OAAO,CAAC,CAAC;EACpD,IAAIH,MAAM,CAACC,KAAK,CAACqB,MAAM,CAAC,EAAE;IACxB,OAAO,KAAK;EACd;EACA,OAAOA,MAAM,IAAID,GAAG;AACtB","ignoreList":[]}
+{"version":3,"names":["REQUIRED_FIELDS","isRtpPayload","payload","candidate","type","rtpId","findValidationErrors","errors","record","field","undefined","push","expiresAt","Number","isNaN","Date","getTime","side","party","name","toAmount","value","parsed","toRtpRequest","id","amount","currency","payer","payee","narration","transactionRef","orderNumber","deepLink","actionMessage","recipient","toRequestPatch","patch","mergeRequest","current","next","key","Object","keys","isExpired","request","now","expiry"],"sourceRoot":"../../src","sources":["validate.ts"],"mappings":";;AAEA;AACA,MAAMA,eAAe,GAAG,CACtB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,OAAO,EACP,OAAO,EACP,WAAW,CACH;;AAEV;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAACC,OAAgB,EAAyB;EACpE,IAAI,CAACA,OAAO,IAAI,OAAOA,OAAO,KAAK,QAAQ,EAAE;IAC3C,OAAO,KAAK;EACd;EACA,MAAMC,SAAS,GAAGD,OAAkC;EACpD,OAAOC,SAAS,CAACC,IAAI,KAAK,KAAK,IAAI,OAAOD,SAAS,CAACE,KAAK,KAAK,QAAQ;AACxE;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAACJ,OAAmB,EAAY;EAClE,MAAMK,MAAgB,GAAG,EAAE;EAC3B,MAAMC,MAAM,GAAGN,OAA6C;EAE5D,KAAK,MAAMO,KAAK,IAAIT,eAAe,EAAE;IACnC,IAAIQ,MAAM,CAACC,KAAK,CAAC,KAAKC,SAAS,IAAIF,MAAM,CAACC,KAAK,CAAC,KAAK,IAAI,EAAE;MACzDF,MAAM,CAACI,IAAI,CAACF,KAAK,CAAC;IACpB;EACF;EAEA,IACEP,OAAO,CAACU,SAAS,KAAKF,SAAS,IAC/BG,MAAM,CAACC,KAAK,CAAC,IAAIC,IAAI,CAACb,OAAO,CAACU,SAAS,CAAC,CAACI,OAAO,CAAC,CAAC,CAAC,EACnD;IACAT,MAAM,CAACI,IAAI,CAAC,WAAW,CAAC;EAC1B;EAEA,KAAK,MAAMM,IAAI,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAW;IAC9C,MAAMC,KAAK,GAAGhB,OAAO,CAACe,IAAI,CAAyB;IACnD,IAAI,CAACC,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,IAAI,OAAOA,KAAK,CAACC,IAAI,KAAK,QAAQ,EAAE;MACzEZ,MAAM,CAACI,IAAI,CAAC,GAAGM,IAAI,OAAO,CAAC;IAC7B;EACF;EAEA,OAAOV,MAAM;AACf;;AAEA;AACA,SAASa,QAAQA,CAACC,KAAc,EAAU;EACxC,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;IAC7B,OAAOA,KAAK;EACd;EACA,MAAMC,MAAM,GAAGT,MAAM,CAACQ,KAAK,CAAC;EAC5B,OAAOR,MAAM,CAACC,KAAK,CAACQ,MAAM,CAAC,GAAG,CAAC,GAAGA,MAAM;AAC1C;;AAEA;AACA,OAAO,SAASC,YAAYA,CAACrB,OAAmB,EAAc;EAC5D,OAAO;IACLsB,EAAE,EAAEtB,OAAO,CAACG,KAAK;IACjBoB,MAAM,EAAEL,QAAQ,CAAClB,OAAO,CAACuB,MAAM,CAAC;IAChCC,QAAQ,EAAExB,OAAO,CAACwB,QAAQ;IAC1BC,KAAK,EAAEzB,OAAO,CAACyB,KAAK;IACpBC,KAAK,EAAE1B,OAAO,CAAC0B,KAAK;IACpBC,SAAS,EAAE3B,OAAO,CAAC2B,SAAS;IAC5BC,cAAc,EAAE5B,OAAO,CAAC4B,cAAc;IACtCC,WAAW,EAAE7B,OAAO,CAAC6B,WAAW;IAChCC,QAAQ,EAAE9B,OAAO,CAAC8B,QAAQ;IAC1BC,aAAa,EAAE/B,OAAO,CAAC+B,aAAa;IACpCrB,SAAS,EAAEV,OAAO,CAACU,SAAS;IAC5BsB,SAAS,EAAEhC,OAAO,CAACgC;EACrB,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAC5BjC,OAA4B,EACP;EACrB,MAAMkC,KAA0B,GAAG,CAAC,CAAC;EACrC,IAAIlC,OAAO,CAACG,KAAK,KAAKK,SAAS,EAAE0B,KAAK,CAACZ,EAAE,GAAGtB,OAAO,CAACG,KAAK;EACzD,IAAIH,OAAO,CAACuB,MAAM,KAAKf,SAAS,EAAE0B,KAAK,CAACX,MAAM,GAAGL,QAAQ,CAAClB,OAAO,CAACuB,MAAM,CAAC;EACzE,IAAIvB,OAAO,CAACwB,QAAQ,KAAKhB,SAAS,EAAE0B,KAAK,CAACV,QAAQ,GAAGxB,OAAO,CAACwB,QAAQ;EACrE,IAAIxB,OAAO,CAACyB,KAAK,KAAKjB,SAAS,EAAE0B,KAAK,CAACT,KAAK,GAAGzB,OAAO,CAACyB,KAAK;EAC5D,IAAIzB,OAAO,CAAC0B,KAAK,KAAKlB,SAAS,EAAE0B,KAAK,CAACR,KAAK,GAAG1B,OAAO,CAAC0B,KAAK;EAC5D,IAAI1B,OAAO,CAAC2B,SAAS,KAAKnB,SAAS,EAAE0B,KAAK,CAACP,SAAS,GAAG3B,OAAO,CAAC2B,SAAS;EACxE,IAAI3B,OAAO,CAAC4B,cAAc,KAAKpB,SAAS,EACtC0B,KAAK,CAACN,cAAc,GAAG5B,OAAO,CAAC4B,cAAc;EAC/C,IAAI5B,OAAO,CAAC6B,WAAW,KAAKrB,SAAS,EACnC0B,KAAK,CAACL,WAAW,GAAG7B,OAAO,CAAC6B,WAAW;EACzC,IAAI7B,OAAO,CAAC8B,QAAQ,KAAKtB,SAAS,EAAE0B,KAAK,CAACJ,QAAQ,GAAG9B,OAAO,CAAC8B,QAAQ;EACrE,IAAI9B,OAAO,CAAC+B,aAAa,KAAKvB,SAAS,EACrC0B,KAAK,CAACH,aAAa,GAAG/B,OAAO,CAAC+B,aAAa;EAC7C,IAAI/B,OAAO,CAACU,SAAS,KAAKF,SAAS,EAAE0B,KAAK,CAACxB,SAAS,GAAGV,OAAO,CAACU,SAAS;EACxE,IAAIV,OAAO,CAACgC,SAAS,KAAKxB,SAAS,EAAE0B,KAAK,CAACF,SAAS,GAAGhC,OAAO,CAACgC,SAAS;EACxE,OAAOE,KAAK;AACd;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAC1BC,OAAmB,EACnBF,KAA0B,EACd;EACZ,MAAMG,IAAgB,GAAG;IAAE,GAAGD;EAAQ,CAAC;EACvC,KAAK,MAAME,GAAG,IAAIC,MAAM,CAACC,IAAI,CAACN,KAAK,CAAC,EAA0B;IAC5D,MAAMf,KAAK,GAAGe,KAAK,CAACI,GAAG,CAAC;IACxB,IAAInB,KAAK,KAAKX,SAAS,IAAIW,KAAK,KAAK,IAAI,EAAE;MACxCkB,IAAI,CAASC,GAAG,CAAC,GAAGnB,KAAK;IAC5B;EACF;EACA,OAAOkB,IAAI;AACb;;AAEA;AACA,OAAO,SAASI,SAASA,CAACC,OAAmB,EAAEC,GAAW,EAAW;EACnE,MAAMC,MAAM,GAAG,IAAI/B,IAAI,CAAC6B,OAAO,CAAChC,SAAS,CAAC,CAACI,OAAO,CAAC,CAAC;EACpD,IAAIH,MAAM,CAACC,KAAK,CAACgC,MAAM,CAAC,EAAE;IACxB,OAAO,KAAK;EACd;EACA,OAAOA,MAAM,IAAID,GAAG;AACtB","ignoreList":[]}

package/lib/typescript/src/client.d.ts

@@ -1,11 +1,20 @@
+import type { RtpStatus } from './constants.js';
 import type { RtpClient, RtpClientOptions } from './types.js';
+/**
+ * Map a backend status string onto the normalized SDK status.
+ *
+ * Unknown values are deliberately **not** treated as success — they map to
+ * `undefined` so the caller can decide, rather than silently reporting an
+ * approved payment for a status the client does not understand.
+ */
+export declare function normalizeBackendStatus(raw: unknown): RtpStatus | undefined;
 /**
  * Create a portable Request-to-Pay client.
  *
  * The client owns validation, de-duplication, expiry, status computation and
- * the accept/decline/status calls. It owns no UI, no navigation and no crypto.
- * Every external effect is injected so the same contract can be re-implemented
- * on other platforms.
+ * the accept/decline/retrieve calls. It owns no UI, no navigation and no
+ * crypto. Every external effect is injected so the same contract can be
+ * re-implemented on other platforms.
  */
 export declare function createRtpClient(options: RtpClientOptions): RtpClient;
 //# sourceMappingURL=client.d.ts.map

package/lib/typescript/src/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAKjB,MAAM,YAAS,CAAC;AAOjB;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA+MpE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAY,SAAS,EAAE,MAAM,gBAAa,CAAC;AAUvD,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAMjB,MAAM,YAAS,CAAC;AAejB;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAwB1E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAgWpE"}

package/lib/typescript/src/constants.d.ts

@@ -7,6 +7,8 @@
 export declare const RTP_STATUS: {
     /** Payload arrived and passed validation, but is not yet actionable. */
     readonly RECEIVED: "RECEIVED";
+    /** Authorization details are being fetched from the backend. */
+    readonly RETRIEVING: "RETRIEVING";
     /** Expired before it could be actioned. */
     readonly EXPIRED: "EXPIRED";
     /** Valid, but the user is not authenticated yet (login gate). */
@@ -15,6 +17,8 @@ export declare const RTP_STATUS: {
     readonly READY: "READY";
     /** Accept/decline in flight. */
     readonly PROCESSING: "PROCESSING";
+    /** Backend accepted the action but a final decision is still pending. */
+    readonly PENDING: "PENDING";
     /** Backend confirmed acceptance. */
     readonly ACCEPTED: "ACCEPTED";
     /** Backend confirmed (or user initiated) a decline. */
@@ -37,6 +41,7 @@ export type RtpEvent = (typeof RTP_EVENT)[keyof typeof RTP_EVENT];
 export declare const RTP_ERROR: {
     readonly INVALID_PAYLOAD: "INVALID_PAYLOAD";
     readonly RECIPIENT_MISMATCH: "RECIPIENT_MISMATCH";
+    readonly RETRIEVE_FAILED: "RETRIEVE_FAILED";
     readonly NETWORK_ERROR: "NETWORK_ERROR";
     readonly BACKEND_REJECTED: "BACKEND_REJECTED";
     readonly UNKNOWN: "UNKNOWN";

package/lib/typescript/src/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,UAAU;IACrB,wEAAwE;;IAExE,2CAA2C;;IAE3C,iEAAiE;;IAEjE,sEAAsE;;IAEtE,gCAAgC;;IAEhC,oCAAoC;;IAEpC,uDAAuD;;IAEvD,wEAAwE;;CAEhE,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAErE,oCAAoC;AACpC,eAAO,MAAM,SAAS;IACpB,8CAA8C;;IAE9C,uCAAuC;;IAEvC,sCAAsC;;CAE9B,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAElE,uEAAuE;AACvE,eAAO,MAAM,SAAS;;;;;;CAMZ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,UAAU;IACrB,wEAAwE;;IAExE,gEAAgE;;IAEhE,2CAA2C;;IAE3C,iEAAiE;;IAEjE,sEAAsE;;IAEtE,gCAAgC;;IAEhC,yEAAyE;;IAEzE,oCAAoC;;IAEpC,uDAAuD;;IAEvD,wEAAwE;;CAEhE,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAErE,oCAAoC;AACpC,eAAO,MAAM,SAAS;IACpB,8CAA8C;;IAE9C,uCAAuC;;IAEvC,sCAAsC;;CAE9B,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAElE,uEAAuE;AACvE,eAAO,MAAM,SAAS;;;;;;;CAOZ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC"}

package/lib/typescript/src/index.d.ts

@@ -1,7 +1,7 @@
-export { createRtpClient } from './client.js';
+export { createRtpClient, normalizeBackendStatus } from './client.js';
 export { RTP_STATUS, RTP_EVENT, RTP_ERROR } from './constants.js';
 export type { RtpStatus, RtpEvent, RtpError } from './constants.js';
-export { isRtpPayload, findValidationErrors, toRtpRequest, isExpired, } from './validate.js';
+export { isRtpPayload, findValidationErrors, toRtpRequest, toRequestPatch, mergeRequest, isExpired, } from './validate.js';
 export { mapPushToRtp } from './push.js';
 export type { PushEnvelope } from './push.js';
 export type { RtpPayload, RtpParty, RtpRequest, RtpCredential, RtpResult, RtpReceiveOutcome, RtpTransport, RtpStorage, RtpHttpResponse, RtpClient, RtpClientOptions, RtpEventMap, RtpUnsubscribe, } from './types.js';

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAU,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAa,CAAC;AAC/D,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAa,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,SAAS,GACV,MAAM,eAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAQ,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,MAAM,WAAQ,CAAC;AAG3C,YAAY,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,cAAc,GACf,MAAM,YAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,wBAAqB,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAqB,CAAC;AAG7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAsB,CAAC;AAC3D,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,YAAY,GACb,MAAM,yBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAAuB,CAAC;AAC3E,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,aAAU,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAa,CAAC;AAC/D,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAa,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,SAAS,GACV,MAAM,eAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAQ,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,MAAM,WAAQ,CAAC;AAG3C,YAAY,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,cAAc,GACf,MAAM,YAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,wBAAqB,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAqB,CAAC;AAG7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAsB,CAAC;AAC3D,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,YAAY,GACb,MAAM,yBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAAuB,CAAC;AAC3E,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAAuB,CAAC"}

package/lib/typescript/src/mock/makeRtpPayload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"makeRtpPayload.d.ts","sourceRoot":"","sources":["../../../../src/mock/makeRtpPayload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAU,CAAC;AAO3C,MAAM,WAAW,uBAAwB,SAAQ,OAAO,CACtD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC,CAC3D;IACC,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,SAAS,GAAE,uBAA4B,GACtC,UAAU,CAkCZ;AAED,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAChC,SAAS,GAAE,uBAA4B,GACtC,UAAU,CAEZ"}
+{"version":3,"file":"makeRtpPayload.d.ts","sourceRoot":"","sources":["../../../../src/mock/makeRtpPayload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAU,CAAC;AAO3C,MAAM,WAAW,uBAAwB,SAAQ,OAAO,CACtD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC,CAC3D;IACC,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,SAAS,GAAE,uBAA4B,GACtC,UAAU,CAqCZ;AAED,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAChC,SAAS,GAAE,uBAA4B,GACtC,UAAU,CAEZ"}

package/lib/typescript/src/mock/mockTransport.d.ts

@@ -6,8 +6,14 @@ export interface MockTransportOptions {
     failAccept?: boolean;
     /** Simulate a network failure on decline. */
     failDecline?: boolean;
+    /** Simulate a network failure on retrieve (details fetch). */
+    failRetrieve?: boolean;
     /** Backend status to return for accept. */
-    acceptStatus?: 'ACCEPTED' | 'DECLINED' | 'FAILED';
+    acceptStatus?: 'ACCEPTED' | 'DECLINED' | 'FAILED' | 'PENDING' | 'EXPIRED';
+    /** Backend status to return for retrieve. Unknown values fall through to READY. */
+    retrieveStatus?: string;
+    /** Request details to return from retrieve (overlaid onto the held request). */
+    retrieveRequest?: Record<string, unknown>;
 }
 export interface RecordedCall {
     method: 'post' | 'get';

package/lib/typescript/src/mock/mockTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mockTransport.d.ts","sourceRoot":"","sources":["../../../../src/mock/mockTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,aAAU,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;CACnD;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,YAAY,CAAC;IACxB,mEAAmE;IACnE,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAOD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,oBAAyB,GACjC,aAAa,CAgEf"}
+{"version":3,"file":"mockTransport.d.ts","sourceRoot":"","sources":["../../../../src/mock/mockTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,aAAU,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1E,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,YAAY,CAAC;IACxB,mEAAmE;IACnE,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAOD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,oBAAyB,GACjC,aAAa,CA0Ef"}

package/lib/typescript/src/react/RtpProvider.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { RtpClient, RtpCredential, RtpRequest, RtpResult } from '../types.js';
+import type { RtpClient, RtpCredential, RtpReceiveOutcome, RtpRequest, RtpResult } from '../types.js';
 import type { RtpStatus } from '../constants.js';
 /**
  * A minimal persistence port for the provider. The host supplies its own
@@ -32,14 +32,18 @@ export interface RtpContextValue {
     status: RtpStatus | null;
     /** True when a request is ready for the user to act on. */
     isReady: boolean;
+    /** True while authorization details are being fetched from the backend. */
+    isLoading: boolean;
     /** Accept the active request with an opaque credential. */
     accept: (credential?: RtpCredential) => Promise<RtpResult | undefined>;
     /** Decline the active request. */
     decline: (reason?: string) => Promise<RtpResult | undefined>;
+    /** Fetch/refresh authorization details for the active request. */
+    retrieve: (id?: string) => Promise<RtpResult | undefined>;
     /** Dismiss the active request from the UI. */
     dismiss: () => void;
     /** Feed a raw decoded payload into the client (for host push adapters). */
-    receive: (payload: unknown) => void;
+    receive: (payload: unknown) => Promise<RtpReceiveOutcome | undefined>;
     /** Last terminal result, for rendering feedback. */
     lastResult: RtpResult | null;
 }

package/lib/typescript/src/react/RtpProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RtpProvider.d.ts","sourceRoot":"","sources":["../../../../src/react/RtpProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAU,CAAC;AAEhF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAc,CAAC;AAI9C;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IACjE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9D,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,MAAM,EAAE,SAAS,CAAC;IAClB,yEAAyE;IACzE,eAAe,EAAE,OAAO,CAAC;IACzB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,8CAA8C;IAC9C,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACvE,kCAAkC;IAClC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAC7D,8CAA8C;IAC9C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,2EAA2E;IAC3E,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,oDAAoD;IACpD,UAAU,EAAE,SAAS,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,UAAU,uCAA8C,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,eAAe,EACf,OAAO,EACP,iBAAiB,EACjB,QAAQ,GACT,EAAE,gBAAgB,qBAkHlB;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,eAAe,CAQxC"}
+{"version":3,"file":"RtpProvider.d.ts","sourceRoot":"","sources":["../../../../src/react/RtpProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,SAAS,EACV,MAAM,aAAU,CAAC;AAElB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAc,CAAC;AAI9C;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IACjE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9D,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,MAAM,EAAE,SAAS,CAAC;IAClB,yEAAyE;IACzE,eAAe,EAAE,OAAO,CAAC;IACzB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,8CAA8C;IAC9C,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACvE,kCAAkC;IAClC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAC7D,kEAAkE;IAClE,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAC1D,8CAA8C;IAC9C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,2EAA2E;IAC3E,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;IACtE,oDAAoD;IACpD,UAAU,EAAE,SAAS,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,UAAU,uCAA8C,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,eAAe,EACf,OAAO,EACP,iBAAiB,EACjB,QAAQ,GACT,EAAE,gBAAgB,qBA2IlB;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,eAAe,CAQxC"}

package/lib/typescript/src/types.d.ts

@@ -26,6 +26,12 @@ export interface RtpPayload {
     narration?: string;
     /** Backend reference for the transaction. */
     transactionRef?: string;
+    /** Merchant/issuer order number for the request (distinct from transactionRef). */
+    orderNumber?: string;
+    /** Secure transaction / deep-link reference the host can use to open the flow. */
+    deepLink?: string;
+    /** Instruction shown to the customer describing the action required. */
+    actionMessage?: string;
     /** ISO 8601 timestamp after which the request can no longer be actioned. */
     expiresAt: string;
     /** Alias (phone/email) the request is addressed to, for identity matching. */
@@ -50,6 +56,9 @@ export interface RtpRequest {
     payee: RtpParty;
     narration?: string;
     transactionRef?: string;
+    orderNumber?: string;
+    deepLink?: string;
+    actionMessage?: string;
     expiresAt: string;
     recipient?: string;
 }
@@ -125,6 +134,8 @@ export interface RtpEventMap {
 export interface RtpClient {
     isRtp: (payload: unknown) => payload is RtpPayload;
     receive: (payload: unknown) => Promise<RtpReceiveOutcome>;
+    /** Fetch/refresh authorization details for a request from the backend. */
+    retrieve: (id: string) => Promise<RtpResult>;
     resumeAuth: () => void;
     accept: (params: {
         id: string;

package/lib/typescript/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/validate.d.ts

@@ -17,6 +17,17 @@ export declare function isRtpPayload(payload: unknown): payload is RtpPayload;
 export declare function findValidationErrors(payload: RtpPayload): string[];
 /** Map a validated payload into the normalized request held by the SDK. */
 export declare function toRtpRequest(payload: RtpPayload): RtpRequest;
+/**
+ * Build a partial-request patch from an incoming payload, copying only the
+ * fields that are actually present. Used to overlay retrieved backend details
+ * without a partial response erasing data already held from the push.
+ */
+export declare function toRequestPatch(payload: Partial<RtpPayload>): Partial<RtpRequest>;
+/**
+ * Overlay a patch onto an existing request. Only defined, non-null values are
+ * copied so a partial response never erases information already held.
+ */
+export declare function mergeRequest(current: RtpRequest, patch: Partial<RtpRequest>): RtpRequest;
 /** Pure expiry check. Re-evaluated on every transition, not just on receive. */
 export declare function isExpired(request: RtpRequest, now: number): boolean;
 //# sourceMappingURL=validate.d.ts.map

package/lib/typescript/src/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,UAAU,EAAE,UAAU,EAAE,MAAM,YAAS,CAAC;AAYhE;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,UAAU,CAMpE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,EAAE,CAyBlE;AAWD,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAY5D;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAMnE"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,UAAU,EAAE,UAAU,EAAE,MAAM,YAAS,CAAC;AAYhE;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,UAAU,CAMpE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,EAAE,CAyBlE;AAWD,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAe5D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAC3B,OAAO,CAAC,UAAU,CAAC,CAkBrB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GACzB,UAAU,CASZ;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAMnE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inno-isw/react-native-rtp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Request to Pay SDK for React Native",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/client.ts

@@ -5,12 +5,15 @@ import {
   findValidationErrors,
   isExpired,
   isRtpPayload,
+  mergeRequest,
+  toRequestPatch,
   toRtpRequest,
 } from './validate';
 import type {
   RtpClient,
   RtpClientOptions,
   RtpCredential,
+  RtpPayload,
   RtpReceiveOutcome,
   RtpRequest,
   RtpResult,
@@ -21,13 +24,54 @@ interface Entry {
   status: RtpStatus;
 }
 
+/** Statuses after which a request is finished with. */
+const TERMINAL_STATUSES: ReadonlySet<RtpStatus> = new Set([
+  RTP_STATUS.ACCEPTED,
+  RTP_STATUS.DECLINED,
+  RTP_STATUS.EXPIRED,
+  RTP_STATUS.FAILED,
+]);
+
+/**
+ * Map a backend status string onto the normalized SDK status.
+ *
+ * Unknown values are deliberately **not** treated as success — they map to
+ * `undefined` so the caller can decide, rather than silently reporting an
+ * approved payment for a status the client does not understand.
+ */
+export function normalizeBackendStatus(raw: unknown): RtpStatus | undefined {
+  if (typeof raw !== 'string') {
+    return undefined;
+  }
+  switch (raw.toUpperCase()) {
+    case 'ACCEPTED':
+    case 'APPROVED':
+    case 'SUCCESS':
+    case 'SUCCESSFUL':
+      return RTP_STATUS.ACCEPTED;
+    case 'DECLINED':
+    case 'USER_DECLINED':
+      return RTP_STATUS.DECLINED;
+    case 'EXPIRED':
+      return RTP_STATUS.EXPIRED;
+    case 'PENDING':
+    case 'PROCESSING':
+      return RTP_STATUS.PENDING;
+    case 'FAILED':
+    case 'REJECTED':
+      return RTP_STATUS.FAILED;
+    default:
+      return undefined;
+  }
+}
+
 /**
  * Create a portable Request-to-Pay client.
  *
  * The client owns validation, de-duplication, expiry, status computation and
- * the accept/decline/status calls. It owns no UI, no navigation and no crypto.
- * Every external effect is injected so the same contract can be re-implemented
- * on other platforms.
+ * the accept/decline/retrieve calls. It owns no UI, no navigation and no
+ * crypto. Every external effect is injected so the same contract can be
+ * re-implemented on other platforms.
  */
 export function createRtpClient(options: RtpClientOptions): RtpClient {
   const {
@@ -46,11 +90,57 @@ export function createRtpClient(options: RtpClientOptions): RtpClient {
   const emitter = createEmitter();
   const entries = new Map<string, Entry>();
 
+  // --- expiry scheduling --------------------------------------------------
+  // Expiry is not only evaluated lazily: an inactive timer fires at `expiresAt`
+  // so a request cannot remain actionable after it has lapsed (INDV-3807/3808).
+  let expiryTimer: ReturnType<typeof setTimeout> | undefined;
+  let expiryTimerId: string | undefined;
+
+  function clearExpiryTimer(): void {
+    if (expiryTimer !== undefined) {
+      clearTimeout(expiryTimer);
+    }
+    expiryTimer = undefined;
+    expiryTimerId = undefined;
+  }
+
+  function scheduleExpiry(entry: Entry): void {
+    clearExpiryTimer();
+
+    const expiry = new Date(entry.request.expiresAt).getTime();
+    if (Number.isNaN(expiry)) {
+      return;
+    }
+
+    const id = entry.request.id;
+    expiryTimerId = id;
+    expiryTimer = setTimeout(
+      () => {
+        const current = entries.get(id);
+        if (!current || TERMINAL_STATUSES.has(current.status)) {
+          return;
+        }
+        logger('[react-native-rtp] request expired:', id);
+        emitResult({ id, status: RTP_STATUS.EXPIRED });
+      },
+      Math.max(0, expiry - now())
+    );
+
+    // Never keep a Node process (e.g. Jest) alive for a pending expiry.
+    const handle = expiryTimer as unknown as { unref?: () => void };
+    if (typeof handle?.unref === 'function') {
+      handle.unref();
+    }
+  }
+
   function setStatus(id: string, status: RtpStatus): void {
     const entry = entries.get(id);
     if (entry) {
       entry.status = status;
     }
+    if (TERMINAL_STATUSES.has(status) && expiryTimerId === id) {
+      clearExpiryTimer();
+    }
     emitter.emit(RTP_EVENT.STATE, { id, status });
   }
 
@@ -89,7 +179,8 @@ export function createRtpClient(options: RtpClientOptions): RtpClient {
     }
 
     const request = toRtpRequest(payload);
-    entries.set(id, { request, status: RTP_STATUS.RECEIVED });
+    const entry: Entry = { request, status: RTP_STATUS.RECEIVED };
+    entries.set(id, entry);
 
     if (isExpired(request, now())) {
       const result = emitResult({ id, status: RTP_STATUS.EXPIRED });
@@ -100,6 +191,7 @@ export function createRtpClient(options: RtpClientOptions): RtpClient {
 
     if (!currentUser) {
       setStatus(id, RTP_STATUS.AWAITING_AUTH);
+      scheduleExpiry(entry);
       return { handled: true, request, status: RTP_STATUS.AWAITING_AUTH };
     }
 
@@ -114,10 +206,84 @@ export function createRtpClient(options: RtpClientOptions): RtpClient {
     }
 
     setStatus(id, RTP_STATUS.READY);
+    scheduleExpiry(entry);
     emitter.emit(RTP_EVENT.REQUEST, request);
     return { handled: true, request, status: RTP_STATUS.READY };
   }
 
+  /**
+   * Fetch (or refresh) authorization details for a request from the backend,
+   * and reconcile the backend status. This is the "retrieve details" step the
+   * authorization page needs before it can be trusted (INDV-3804).
+   */
+  async function retrieve(id: string): Promise<RtpResult> {
+    const entry = entries.get(id);
+    if (!entry) {
+      return fail(id, RTP_ERROR.UNKNOWN);
+    }
+
+    if (isExpired(entry.request, now())) {
+      return emitResult({ id, status: RTP_STATUS.EXPIRED });
+    }
+
+    if (TERMINAL_STATUSES.has(entry.status)) {
+      return { id, status: entry.status };
+    }
+
+    setStatus(id, RTP_STATUS.RETRIEVING);
+
+    try {
+      const headers = await getAuthHeaders();
+      const res = await transport.get(`${basePath}/${id}`, headers);
+      const data = (res?.data ?? {}) as Record<string, unknown>;
+
+      const mapped = normalizeBackendStatus(data.status);
+
+      if (
+        mapped === RTP_STATUS.EXPIRED ||
+        mapped === RTP_STATUS.DECLINED ||
+        mapped === RTP_STATUS.FAILED
+      ) {
+        return emitResult({
+          id,
+          status: mapped,
+          data,
+          error:
+            mapped === RTP_STATUS.FAILED
+              ? RTP_ERROR.BACKEND_REJECTED
+              : undefined,
+        });
+      }
+
+      if (mapped === RTP_STATUS.ACCEPTED) {
+        return emitResult({ id, status: RTP_STATUS.ACCEPTED, data });
+      }
+
+      if (mapped === RTP_STATUS.PENDING) {
+        return emitResult({ id, status: RTP_STATUS.PENDING, data });
+      }
+
+      // Merge any returned details (a full payload, or nested under `request`).
+      const incoming = (data.request ?? data) as
+        Partial<RtpPayload> | undefined;
+      if (incoming && typeof incoming === 'object') {
+        entry.request = mergeRequest(entry.request, toRequestPatch(incoming));
+      }
+
+      if (isExpired(entry.request, now())) {
+        return emitResult({ id, status: RTP_STATUS.EXPIRED });
+      }
+
+      setStatus(id, RTP_STATUS.READY);
+      scheduleExpiry(entry);
+      emitter.emit(RTP_EVENT.REQUEST, entry.request);
+      return { id, status: RTP_STATUS.READY, data };
+    } catch (err) {
+      logger('[react-native-rtp] retrieve failed:', err);
+      return fail(id, RTP_ERROR.RETRIEVE_FAILED);
+    }
+  }
+
   /**
    * Called by the host after a successful login to release any requests that
    * were waiting on the auth gate.
@@ -149,6 +315,7 @@ export function createRtpClient(options: RtpClientOptions): RtpClient {
       }
 
       setStatus(id, RTP_STATUS.READY);
+      scheduleExpiry(entry);
       emitter.emit(RTP_EVENT.REQUEST, entry.request);
     }
   }
@@ -176,18 +343,22 @@ export function createRtpClient(options: RtpClientOptions): RtpClient {
         { credential },
         headers
       );
-      const backendStatus = res?.data?.status;
-      const status: RtpStatus =
-        backendStatus === 'DECLINED'
-          ? RTP_STATUS.DECLINED
-          : backendStatus === 'FAILED'
-            ? RTP_STATUS.FAILED
-            : RTP_STATUS.ACCEPTED;
+      const data = (res?.data ?? {}) as Record<string, unknown>;
+
+      // If the backend returned a status we recognise, honour it. If it
+      // returned no status at all, the accept call itself succeeded. If it
+      // returned a status we do NOT understand, fail closed rather than
+      // showing the customer an approved payment we cannot vouch for.
+      const hasStatus = data.status !== undefined && data.status !== null;
+      const mapped = normalizeBackendStatus(data.status);
+      const status: RtpStatus = hasStatus
+        ? (mapped ?? RTP_STATUS.FAILED)
+        : RTP_STATUS.ACCEPTED;
 
       return emitResult({
         id,
         status,
-        data: res?.data,
+        data,
         error:
           status === RTP_STATUS.FAILED ? RTP_ERROR.BACKEND_REJECTED : undefined,
       });
@@ -216,7 +387,21 @@ export function createRtpClient(options: RtpClientOptions): RtpClient {
         { reason },
         headers
       );
-      return emitResult({ id, status: RTP_STATUS.DECLINED, data: res?.data });
+      const data = (res?.data ?? {}) as Record<string, unknown>;
+
+      const mapped = normalizeBackendStatus(data.status);
+      const status: RtpStatus =
+        mapped === RTP_STATUS.EXPIRED || mapped === RTP_STATUS.FAILED
+          ? mapped
+          : RTP_STATUS.DECLINED;
+
+      return emitResult({
+        id,
+        status,
+        data,
+        error:
+          status === RTP_STATUS.FAILED ? RTP_ERROR.BACKEND_REJECTED : undefined,
+      });
     } catch (err) {
       logger('[react-native-rtp] decline failed:', err);
       return fail(id, RTP_ERROR.NETWORK_ERROR);
@@ -226,12 +411,16 @@ export function createRtpClient(options: RtpClientOptions): RtpClient {
   return {
     isRtp: isRtpPayload,
     receive,
+    retrieve,
     resumeAuth,
     accept,
     decline,
     getStatus: (id: string) => entries.get(id)?.status,
     getRequest: (id: string) => entries.get(id)?.request,
     acknowledge: (id: string) => {
+      if (expiryTimerId === id) {
+        clearExpiryTimer();
+      }
       entries.delete(id);
     },
     on: emitter.on,

package/src/constants.ts

@@ -7,6 +7,8 @@
 export const RTP_STATUS = {
   /** Payload arrived and passed validation, but is not yet actionable. */
   RECEIVED: 'RECEIVED',
+  /** Authorization details are being fetched from the backend. */
+  RETRIEVING: 'RETRIEVING',
   /** Expired before it could be actioned. */
   EXPIRED: 'EXPIRED',
   /** Valid, but the user is not authenticated yet (login gate). */
@@ -15,6 +17,8 @@ export const RTP_STATUS = {
   READY: 'READY',
   /** Accept/decline in flight. */
   PROCESSING: 'PROCESSING',
+  /** Backend accepted the action but a final decision is still pending. */
+  PENDING: 'PENDING',
   /** Backend confirmed acceptance. */
   ACCEPTED: 'ACCEPTED',
   /** Backend confirmed (or user initiated) a decline. */
@@ -41,6 +45,7 @@ export type RtpEvent = (typeof RTP_EVENT)[keyof typeof RTP_EVENT];
 export const RTP_ERROR = {
   INVALID_PAYLOAD: 'INVALID_PAYLOAD',
   RECIPIENT_MISMATCH: 'RECIPIENT_MISMATCH',
+  RETRIEVE_FAILED: 'RETRIEVE_FAILED',
   NETWORK_ERROR: 'NETWORK_ERROR',
   BACKEND_REJECTED: 'BACKEND_REJECTED',
   UNKNOWN: 'UNKNOWN',