@invonetwork/web-sdk 0.4.2 → 0.5.0

package/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to `@invonetwork/web-sdk` are documented here. This project
 [Semantic Versioning](https://semver.org/). Releases are managed with
 [changesets](https://github.com/changesets/changesets).
 
+## [0.5.0] — 2026-07-01
+
+Support partner `metadata` end-to-end on the purchase flow (additive, backward-compatible).
+
+- **`PurchaseCompletedData.metadata?`** — the `purchase.completed` webhook now echoes your
+  metadata back (all rails); `event.data.metadata` is typed.
+- **`purchaseCurrency`** now accepts and forwards `metadata` (the direct `/purchase-currency`
+  endpoint accepts it too, matching `createCheckout`).
+
 ## [0.4.2] — 2026-06-30
 
 Fixes from an independent line-by-line audit against the live backend.

package/README.md

@@ -183,6 +183,7 @@ const purchase = await server.purchaseCurrency({
   purchaseReference: crypto.randomUUID(), // idempotency key, required
   rail: "platform",
   paymentMethodId: "pm_...",              // a tokenized payment method
+  metadata: { yourOrderId: "ord_42" },    // echoed back on the purchase.completed webhook
 });
 // purchase.status:
 //   "success"          → captured, purchase.newBalance updated
@@ -369,7 +370,7 @@ export const POST = createWebhookHandler({
 
 | Event | Fires for | Use it to |
 |---|---|---|
-| `purchase.completed` | every currency-purchase rail | grant currency (payload: `transaction_id, order_id, player_email, identity_id, usd_amount, currency_amount, currency_name, new_balance, rail`) |
+| `purchase.completed` | every currency-purchase rail | grant currency (payload: `transaction_id, order_id, player_email, identity_id, usd_amount, currency_amount, currency_name, new_balance, rail, metadata`) — `metadata` echoes what you passed to `createCheckout`/`purchaseCurrency` |
 | `purchase.failed` / `purchase.disputed` | `platform` rail only | handle failures/disputes |
 | `purchase.refunded` | `game` / `steam` rails | handle refunds |
 | `item.purchased` | every item purchase | **grant the in-game item** (payload includes `transaction_id, order_id, player_email, identity_id, item_id, item_name, item_quantity, unit_price, total_price, currency_name, new_balance, fee_breakdown`) |

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as ClientConfig, a as CallOptions, A as ApproveResult, b as ConfirmReceiptResult, L as LinkDeviceResult } from './types-CBMLNwbe.cjs';
-export { I as InvoError, c as InvoErrorInfo, d as InvoHooks, e as InvoRequestInfo, f as InvoResponseInfo, R as Rail, V as VerificationMethod } from './types-CBMLNwbe.cjs';
+import { C as ClientConfig, a as CallOptions, A as ApproveResult, b as ConfirmReceiptResult, L as LinkDeviceResult } from './types-CZdmipNK.cjs';
+export { I as InvoError, c as InvoErrorInfo, d as InvoHooks, e as InvoRequestInfo, f as InvoResponseInfo, R as Rail, V as VerificationMethod } from './types-CZdmipNK.cjs';
 
 declare class InvoClient {
     private readonly http;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ClientConfig, a as CallOptions, A as ApproveResult, b as ConfirmReceiptResult, L as LinkDeviceResult } from './types-CBMLNwbe.js';
-export { I as InvoError, c as InvoErrorInfo, d as InvoHooks, e as InvoRequestInfo, f as InvoResponseInfo, R as Rail, V as VerificationMethod } from './types-CBMLNwbe.js';
+import { C as ClientConfig, a as CallOptions, A as ApproveResult, b as ConfirmReceiptResult, L as LinkDeviceResult } from './types-CZdmipNK.js';
+export { I as InvoError, c as InvoErrorInfo, d as InvoHooks, e as InvoRequestInfo, f as InvoResponseInfo, R as Rail, V as VerificationMethod } from './types-CZdmipNK.js';
 
 declare class InvoClient {
     private readonly http;

package/dist/server.cjs

@@ -631,6 +631,7 @@ var InvoServer = class {
     if (input.savedCardId) body["saved_card_id"] = input.savedCardId;
     if (input.playerName) body["player_name"] = input.playerName;
     if (input.playerPhone) body["player_phone"] = input.playerPhone;
+    if (input.metadata) body["metadata"] = input.metadata;
     const raw = await this.http.post(
       "/api/currency-purchases/purchase-currency",
       body,

package/dist/server.d.cts

@@ -1,5 +1,5 @@
-import { I as InvoError, S as ServerConfig, a as CallOptions, P as PlayerToken, g as InitiateSendInput, h as InitiateResult, i as InitiateTransferInput, j as CreateCheckoutInput, k as CreateCheckoutResult, l as PurchaseInput, m as PurchaseResult, n as ConfirmPaymentResult, O as OrderDetailsResult, o as PurchaseItemInput, p as PurchaseItemResult, q as ItemHistoryQuery, r as ItemHistoryResult, s as ItemOrderQuery, t as PlayerBalanceQuery, u as PlayerBalanceResult, v as InboundPendingQuery, w as InboundPendingResult } from './types-CBMLNwbe.cjs';
-export { x as CurrencyBalance, y as InboundPendingItem, c as InvoErrorInfo, d as InvoHooks, e as InvoRequestInfo, f as InvoResponseInfo, R as Rail, V as VerificationMethod } from './types-CBMLNwbe.cjs';
+import { I as InvoError, S as ServerConfig, a as CallOptions, P as PlayerToken, g as InitiateSendInput, h as InitiateResult, i as InitiateTransferInput, j as CreateCheckoutInput, k as CreateCheckoutResult, l as PurchaseInput, m as PurchaseResult, n as ConfirmPaymentResult, O as OrderDetailsResult, o as PurchaseItemInput, p as PurchaseItemResult, q as ItemHistoryQuery, r as ItemHistoryResult, s as ItemOrderQuery, t as PlayerBalanceQuery, u as PlayerBalanceResult, v as InboundPendingQuery, w as InboundPendingResult } from './types-CZdmipNK.cjs';
+export { x as CurrencyBalance, y as InboundPendingItem, c as InvoErrorInfo, d as InvoHooks, e as InvoRequestInfo, f as InvoResponseInfo, R as Rail, V as VerificationMethod } from './types-CZdmipNK.cjs';
 
 interface VerifyWebhookOptions {
     /** Max age of the signed timestamp, in seconds. Default 300 (5 min). */
@@ -25,6 +25,8 @@ interface PurchaseCompletedData {
     currency_name: string;
     new_balance: string;
     rail: string;
+    /** The metadata you passed to createCheckout/purchaseCurrency, echoed back (all rails). */
+    metadata?: Record<string, unknown>;
     [key: string]: unknown;
 }
 interface PurchaseEventData {

package/dist/server.d.ts

@@ -1,5 +1,5 @@
-import { I as InvoError, S as ServerConfig, a as CallOptions, P as PlayerToken, g as InitiateSendInput, h as InitiateResult, i as InitiateTransferInput, j as CreateCheckoutInput, k as CreateCheckoutResult, l as PurchaseInput, m as PurchaseResult, n as ConfirmPaymentResult, O as OrderDetailsResult, o as PurchaseItemInput, p as PurchaseItemResult, q as ItemHistoryQuery, r as ItemHistoryResult, s as ItemOrderQuery, t as PlayerBalanceQuery, u as PlayerBalanceResult, v as InboundPendingQuery, w as InboundPendingResult } from './types-CBMLNwbe.js';
-export { x as CurrencyBalance, y as InboundPendingItem, c as InvoErrorInfo, d as InvoHooks, e as InvoRequestInfo, f as InvoResponseInfo, R as Rail, V as VerificationMethod } from './types-CBMLNwbe.js';
+import { I as InvoError, S as ServerConfig, a as CallOptions, P as PlayerToken, g as InitiateSendInput, h as InitiateResult, i as InitiateTransferInput, j as CreateCheckoutInput, k as CreateCheckoutResult, l as PurchaseInput, m as PurchaseResult, n as ConfirmPaymentResult, O as OrderDetailsResult, o as PurchaseItemInput, p as PurchaseItemResult, q as ItemHistoryQuery, r as ItemHistoryResult, s as ItemOrderQuery, t as PlayerBalanceQuery, u as PlayerBalanceResult, v as InboundPendingQuery, w as InboundPendingResult } from './types-CZdmipNK.js';
+export { x as CurrencyBalance, y as InboundPendingItem, c as InvoErrorInfo, d as InvoHooks, e as InvoRequestInfo, f as InvoResponseInfo, R as Rail, V as VerificationMethod } from './types-CZdmipNK.js';
 
 interface VerifyWebhookOptions {
     /** Max age of the signed timestamp, in seconds. Default 300 (5 min). */
@@ -25,6 +25,8 @@ interface PurchaseCompletedData {
     currency_name: string;
     new_balance: string;
     rail: string;
+    /** The metadata you passed to createCheckout/purchaseCurrency, echoed back (all rails). */
+    metadata?: Record<string, unknown>;
     [key: string]: unknown;
 }
 interface PurchaseEventData {

package/dist/server.js

@@ -382,6 +382,7 @@ var InvoServer = class {
     if (input.savedCardId) body["saved_card_id"] = input.savedCardId;
     if (input.playerName) body["player_name"] = input.playerName;
     if (input.playerPhone) body["player_phone"] = input.playerPhone;
+    if (input.metadata) body["metadata"] = input.metadata;
     const raw = await this.http.post(
       "/api/currency-purchases/purchase-currency",
       body,

package/dist/{types-CBMLNwbe.d.cts → types-CZdmipNK.d.cts}

@@ -176,6 +176,8 @@ interface PurchaseInput {
     savedCardId?: string;
     playerName?: string;
     playerPhone?: string;
+    /** Arbitrary metadata echoed back on the purchase.completed webhook (data.metadata). */
+    metadata?: Record<string, unknown>;
 }
 type PurchaseStatus = "success" | "requires_action" | "pending_payment";
 interface PurchaseResult {

package/dist/{types-CBMLNwbe.d.ts → types-CZdmipNK.d.ts}

@@ -176,6 +176,8 @@ interface PurchaseInput {
     savedCardId?: string;
     playerName?: string;
     playerPhone?: string;
+    /** Arbitrary metadata echoed back on the purchase.completed webhook (data.metadata). */
+    metadata?: Record<string, unknown>;
 }
 type PurchaseStatus = "success" | "requires_action" | "pending_payment";
 interface PurchaseResult {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@invonetwork/web-sdk",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "INVO Web SDK — currency purchase + passkey (WebAuthn) verification for partner web platforms.",
   "license": "SEE LICENSE IN LICENSE",
   "private": false,