@wirexapp/card-wallet-topup-web 0.1.0-beta.3

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# @wirexapp/card-wallet-topup-web
+
+## 0.1.0-beta.3
+
+### Minor Changes
+
+- da3aa2e: Add wallet top-up (Apple Pay / Google Pay) capability — `@wirexapp/card-wallet-topup-web`.
+
+  New hosted checkout model per docs/WALLET-TOPUP-DESIGN.md: a Wirex-served frame renders the transaction review (amounts fetched from the backend by estimation id — the host cannot spoof them) and the wallet buttons under Wirex's single merchant identity, so partners need no Apple/Google onboarding. Public API: `checkWalletAvailability()` (Phase-A probe, cached per session) and `createWalletTopUpForm()` (mount / update / destroy, results via callbacks with an execute watchdog and a designed-in `threeDsRequired` fallback into `@wirexapp/card-3ds-web`). React bindings: `useWalletAvailability()` + `<WalletTopUpForm />`. Protocol additions are purely additive within v1 (new init modes + wallet event types). Frame-side backend paths are the frontend contract proposal (§9) pending backend agreement.
+
+### Patch Changes
+
+- Updated dependencies [da3aa2e]
+  - @wirexapp/card-sdk-core@0.1.0-beta.3

package/README.md

@@ -0,0 +1,21 @@
+# @wirexapp/card-wallet-topup-web
+
+Top up via Apple Pay / Google Pay inside a Wirex-served checkout frame: the
+frame renders the transaction review (amounts fetched by estimation id — the
+host cannot spoof them) and the wallet buttons under Wirex's single merchant
+identity, so partners need no Apple/Google onboarding of their own. The host
+passes only an estimation reference and receives status callbacks.
+
+- `checkWalletAvailability(sdk)` — Phase-A probe (hidden frame, cached per
+  page session): `{ applePay, googlePay }` as the real tokenization path
+  would answer, per browser/context.
+- `createWalletTopUpForm(sdk, config)` — mount / update / destroy the checkout
+  frame; results via callbacks, with an execute watchdog and a designed-in
+  `threeDsRequired` fallback into `@wirexapp/card-3ds-web`.
+
+Availability rule: render a wallet entry point only where the probe says it
+can tokenize (Safari → Apple Pay, Android Chrome → Google Pay).
+
+React bindings: `useWalletAvailability()` + `<WalletTopUpForm />` in
+`@wirexapp/card-react`. Full partner docs: `partner-docs/` in the repo
+(packages → card-wallet-topup-web).

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `@wirexapp/card-wallet-topup-web` — top up via Apple Pay / Google Pay inside
+ * a Wirex-served checkout iframe. Design: docs/WALLET-TOPUP-DESIGN.md.
+ *
+ * The flow (partner's view):
+ *  1. Your backend prices the top-up through the Wirex estimate API and hands
+ *     your frontend an `estimation_id` + a short-lived `checkout_token`.
+ *  2. `checkWalletAvailability()` (once per session, before showing the row).
+ *  3. `createWalletTopUpForm(...).mount(container)` — the frame renders the
+ *     review screen (amounts fetched from the backend, not from your page) and
+ *     the wallet buttons under Wirex's merchant identity. No Apple/Google
+ *     registration, no certificates, no PCI exposure on your side.
+ *  4. The outcome arrives in `onResult`; reconcile the money-moved truth on
+ *     your backend. A `threeDsRequired` outcome plugs into
+ *     `@wirexapp/card-3ds-web`.
+ */
+import { PciWalletTopUpElement, type PciSdkConfig, type PciWalletAvailability, type PciWalletTopUpElementConfig } from '@wirexapp/card-sdk-core';
+/** Config of the combined (review + buttons) wallet checkout element. */
+export type WalletTopUpFormConfig = PciWalletTopUpElementConfig;
+export type WalletTopUpForm = PciWalletTopUpElement;
+/**
+ * Phase-A availability check. Run it before showing the wallet row at all —
+ * `false` means hide the row (`googlePay: false` on desktop/non-Chrome is
+ * expected: the cryptogram-only policy has no eligible cards there).
+ */
+export declare const checkWalletAvailability: (sdk: PciSdkConfig, options?: {
+    force?: boolean;
+}) => Promise<PciWalletAvailability>;
+/** Combined variant: review screen + wallet buttons in one Wirex-served frame. */
+export declare const createWalletTopUpForm: (sdk: PciSdkConfig, config: WalletTopUpFormConfig) => WalletTopUpForm;
+export type * from '@wirexapp/card-sdk-core';
+export { PciFrameRequestError } from '@wirexapp/card-sdk-core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAGL,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EACjC,MAAM,yBAAyB,CAAC;AAEjC,yEAAyE;AACzE,MAAM,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAOpD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,KAAK,YAAY,EACjB,UAAU;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,KAC5B,OAAO,CAAC,qBAAqB,CAY/B,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,qBAAqB,GAChC,KAAK,YAAY,EACjB,QAAQ,qBAAqB,KAC5B,eAA2F,CAAC;AAI/F,mBAAmB,yBAAyB,CAAC;AAG7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,46 @@
+/**
+ * `@wirexapp/card-wallet-topup-web` — top up via Apple Pay / Google Pay inside
+ * a Wirex-served checkout iframe. Design: docs/WALLET-TOPUP-DESIGN.md.
+ *
+ * The flow (partner's view):
+ *  1. Your backend prices the top-up through the Wirex estimate API and hands
+ *     your frontend an `estimation_id` + a short-lived `checkout_token`.
+ *  2. `checkWalletAvailability()` (once per session, before showing the row).
+ *  3. `createWalletTopUpForm(...).mount(container)` — the frame renders the
+ *     review screen (amounts fetched from the backend, not from your page) and
+ *     the wallet buttons under Wirex's merchant identity. No Apple/Google
+ *     registration, no certificates, no PCI exposure on your side.
+ *  4. The outcome arrives in `onResult`; reconcile the money-moved truth on
+ *     your backend. A `threeDsRequired` outcome plugs into
+ *     `@wirexapp/card-3ds-web`.
+ */
+import { buildFrameUrl, probeWalletAvailability, PciWalletTopUpElement, } from '@wirexapp/card-sdk-core';
+/** One probe per frame URL (environment + client) per page session — the
+ *  checks take no transaction context, so the result cannot go stale within a
+ *  session. Failed probes are not cached. */
+const availabilityCache = new Map();
+/**
+ * Phase-A availability check. Run it before showing the wallet row at all —
+ * `false` means hide the row (`googlePay: false` on desktop/non-Chrome is
+ * expected: the cryptogram-only policy has no eligible cards there).
+ */
+export const checkWalletAvailability = (sdk, options) => {
+    const frameUrl = buildFrameUrl(sdk, 'wallet-probe');
+    if (!options?.force) {
+        const cached = availabilityCache.get(frameUrl);
+        if (cached)
+            return cached;
+    }
+    const probe = probeWalletAvailability(frameUrl).catch((error) => {
+        availabilityCache.delete(frameUrl);
+        throw error;
+    });
+    availabilityCache.set(frameUrl, probe);
+    return probe;
+};
+/** Combined variant: review screen + wallet buttons in one Wirex-served frame. */
+export const createWalletTopUpForm = (sdk, config) => new PciWalletTopUpElement(buildFrameUrl(sdk, 'wallet-checkout'), config);
+// Value re-export so `error instanceof PciFrameRequestError` works when
+// imported from this package.
+export { PciFrameRequestError } from '@wirexapp/card-sdk-core';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,qBAAqB,GAItB,MAAM,yBAAyB,CAAC;AAMjC;;6CAE6C;AAC7C,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA0C,CAAC;AAE5E;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,GAAiB,EACjB,OAA6B,EACG,EAAE;IAClC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IACD,MAAM,KAAK,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACvE,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACH,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,GAAiB,EACjB,MAA6B,EACZ,EAAE,CAAC,IAAI,qBAAqB,CAAC,aAAa,CAAC,GAAG,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC;AAK/F,wEAAwE;AACxE,8BAA8B;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@wirexapp/card-wallet-topup-web",
+  "version": "0.1.0-beta.3",
+  "type": "module",
+  "description": "Top up via Apple Pay / Google Pay inside a Wirex-served checkout iframe — review screen + wallet buttons under Wirex's merchant identity; the host passes only an estimation reference. No wallet onboarding on the partner side.",
+  "license": "UNLICENSED",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node ../../scripts/fix-esm-extensions.mjs dist",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "clean": "rm -rf dist tsconfig.build.tsbuildinfo",
+    "typecheck": "yarn run -T tsc --noEmit",
+    "prepublishOnly": "yarn clean && yarn build"
+  },
+  "dependencies": {
+    "@wirexapp/card-sdk-core": "0.1.0-beta.3"
+  }
+}