@invonetwork/web-sdk 3.23.0 → 3.24.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -220,11 +220,18 @@ var InvoError = class _InvoError extends Error {
220
220
  get isNotPlatformTenant() {
221
221
  return this.code === "NOT_A_PLATFORM_TENANT";
222
222
  }
223
- /** True if a Platform Commerce purchase, or a `purchaseItem` spend, was too small for the
224
- * fee to round above zero (`AMOUNT_BELOW_MINIMUM`, 400) — raise the amount. `purchaseItem`
225
- * rounds `totalPrice` to cents before this check. */
223
+ /**
224
+ * True on `AMOUNT_BELOW_MINIMUM` (400), which three calls answer:
225
+ * - a Platform Commerce purchase, or a `purchaseItem` spend, too small for the fee to
226
+ * round above zero: raise the amount (`purchaseItem` rounds `totalPrice` to cents
227
+ * before this check);
228
+ * - initiate-send / initiate-transfer below the sending title's minimum (backend
229
+ * 2026-10-12): the limit is on {@link minimumAmount}, in the title's own currency
230
+ * ({@link limitCurrencyName}). On the wallet transfer route {@link code} stays
231
+ * `INVALID_AMOUNT`; this predicate reads `error_code` too.
232
+ */
226
233
  get isAmountBelowMinimum() {
227
- return this.code === "AMOUNT_BELOW_MINIMUM";
234
+ return this.code === "AMOUNT_BELOW_MINIMUM" || this.bodyObject()["error_code"] === "AMOUNT_BELOW_MINIMUM";
228
235
  }
229
236
  /**
230
237
  * True if the `rail` you sent disagrees with the storefront key you
@@ -967,12 +974,38 @@ var InvoError = class _InvoError extends Error {
967
974
  return typeof e === "string" && e.startsWith("SIGNAL_");
968
975
  }
969
976
  /**
970
- * True when `registerPlayer` found the player already in your game with a DIFFERENT
971
- * phone (`PHONE_MISMATCH`, 409). Nothing changed; use `updatePlayerPhone` to change it.
977
+ * True when the phone you supplied is not the one on file for that player
978
+ * (`PHONE_MISMATCH`). Two places answer it:
979
+ * - `registerPlayer` (409): the player is already in your game with a different
980
+ * phone. Nothing changed; use `updatePlayerPhone` to change it.
981
+ * - initiate-send / initiate-transfer (400, since backend 2026-10-12): the sender
982
+ * phone does not match. Change the number first with `requestPhoneChange`.
972
983
  * (`mintPlayerToken` reports the same situation as `phoneMismatch: true` on success.)
973
984
  */
974
985
  get isPhoneMismatch() {
975
- return this.code === "PHONE_MISMATCH";
986
+ return this.code === "PHONE_MISMATCH" || this.bodyObject()["error_code"] === "PHONE_MISMATCH";
987
+ }
988
+ /**
989
+ * True when a send or transfer amount is above the sending title's maximum or the
990
+ * network ceiling for one move (`AMOUNT_ABOVE_MAXIMUM`, 400). See {@link maximumAmount}.
991
+ */
992
+ get isAmountAboveMaximum() {
993
+ return this.code === "AMOUNT_ABOVE_MAXIMUM" || this.bodyObject()["error_code"] === "AMOUNT_ABOVE_MAXIMUM";
994
+ }
995
+ /** The minimum amount (decimal string) on an `AMOUNT_BELOW_MINIMUM` refusal. */
996
+ get minimumAmount() {
997
+ const v = this.bodyObject()["minimum_amount"];
998
+ return typeof v === "string" ? v : void 0;
999
+ }
1000
+ /** The maximum amount (decimal string) on an `AMOUNT_ABOVE_MAXIMUM` refusal. */
1001
+ get maximumAmount() {
1002
+ const v = this.bodyObject()["maximum_amount"];
1003
+ return typeof v === "string" ? v : void 0;
1004
+ }
1005
+ /** The sending title's currency name on an amount-limit refusal, when it has one. */
1006
+ get limitCurrencyName() {
1007
+ const v = this.bodyObject()["currency_name"];
1008
+ return typeof v === "string" ? v : void 0;
976
1009
  }
977
1010
  /**
978
1011
  * True when the phone you supplied belongs to another email
@@ -1571,5 +1604,5 @@ function toApprovePhoneChangeResult(raw, changeRequestId) {
1571
1604
  }
1572
1605
 
1573
1606
  export { Http, InvoError, assertSecureBaseUrl, creditFields, phoneChangeSignalMessage, receiptFields, toApprovePhoneChangeResult, toDestinationsResult, toLoyaltyCardsResult, toLoyaltyVaultResult, toPhoneChangeApprovalsResult, toPhoneChangeRequest, toRedeemRewardResult, toRequestPhoneChangeResult, toRewardsPageLink };
1574
- //# sourceMappingURL=chunk-BOD4WOWO.js.map
1575
- //# sourceMappingURL=chunk-BOD4WOWO.js.map
1607
+ //# sourceMappingURL=chunk-7BYAUHTA.js.map
1608
+ //# sourceMappingURL=chunk-7BYAUHTA.js.map
package/dist/index.cjs CHANGED
@@ -222,11 +222,18 @@ var InvoError = class _InvoError extends Error {
222
222
  get isNotPlatformTenant() {
223
223
  return this.code === "NOT_A_PLATFORM_TENANT";
224
224
  }
225
- /** True if a Platform Commerce purchase, or a `purchaseItem` spend, was too small for the
226
- * fee to round above zero (`AMOUNT_BELOW_MINIMUM`, 400) — raise the amount. `purchaseItem`
227
- * rounds `totalPrice` to cents before this check. */
225
+ /**
226
+ * True on `AMOUNT_BELOW_MINIMUM` (400), which three calls answer:
227
+ * - a Platform Commerce purchase, or a `purchaseItem` spend, too small for the fee to
228
+ * round above zero: raise the amount (`purchaseItem` rounds `totalPrice` to cents
229
+ * before this check);
230
+ * - initiate-send / initiate-transfer below the sending title's minimum (backend
231
+ * 2026-10-12): the limit is on {@link minimumAmount}, in the title's own currency
232
+ * ({@link limitCurrencyName}). On the wallet transfer route {@link code} stays
233
+ * `INVALID_AMOUNT`; this predicate reads `error_code` too.
234
+ */
228
235
  get isAmountBelowMinimum() {
229
- return this.code === "AMOUNT_BELOW_MINIMUM";
236
+ return this.code === "AMOUNT_BELOW_MINIMUM" || this.bodyObject()["error_code"] === "AMOUNT_BELOW_MINIMUM";
230
237
  }
231
238
  /**
232
239
  * True if the `rail` you sent disagrees with the storefront key you
@@ -969,12 +976,38 @@ var InvoError = class _InvoError extends Error {
969
976
  return typeof e === "string" && e.startsWith("SIGNAL_");
970
977
  }
971
978
  /**
972
- * True when `registerPlayer` found the player already in your game with a DIFFERENT
973
- * phone (`PHONE_MISMATCH`, 409). Nothing changed; use `updatePlayerPhone` to change it.
979
+ * True when the phone you supplied is not the one on file for that player
980
+ * (`PHONE_MISMATCH`). Two places answer it:
981
+ * - `registerPlayer` (409): the player is already in your game with a different
982
+ * phone. Nothing changed; use `updatePlayerPhone` to change it.
983
+ * - initiate-send / initiate-transfer (400, since backend 2026-10-12): the sender
984
+ * phone does not match. Change the number first with `requestPhoneChange`.
974
985
  * (`mintPlayerToken` reports the same situation as `phoneMismatch: true` on success.)
975
986
  */
976
987
  get isPhoneMismatch() {
977
- return this.code === "PHONE_MISMATCH";
988
+ return this.code === "PHONE_MISMATCH" || this.bodyObject()["error_code"] === "PHONE_MISMATCH";
989
+ }
990
+ /**
991
+ * True when a send or transfer amount is above the sending title's maximum or the
992
+ * network ceiling for one move (`AMOUNT_ABOVE_MAXIMUM`, 400). See {@link maximumAmount}.
993
+ */
994
+ get isAmountAboveMaximum() {
995
+ return this.code === "AMOUNT_ABOVE_MAXIMUM" || this.bodyObject()["error_code"] === "AMOUNT_ABOVE_MAXIMUM";
996
+ }
997
+ /** The minimum amount (decimal string) on an `AMOUNT_BELOW_MINIMUM` refusal. */
998
+ get minimumAmount() {
999
+ const v = this.bodyObject()["minimum_amount"];
1000
+ return typeof v === "string" ? v : void 0;
1001
+ }
1002
+ /** The maximum amount (decimal string) on an `AMOUNT_ABOVE_MAXIMUM` refusal. */
1003
+ get maximumAmount() {
1004
+ const v = this.bodyObject()["maximum_amount"];
1005
+ return typeof v === "string" ? v : void 0;
1006
+ }
1007
+ /** The sending title's currency name on an amount-limit refusal, when it has one. */
1008
+ get limitCurrencyName() {
1009
+ const v = this.bodyObject()["currency_name"];
1010
+ return typeof v === "string" ? v : void 0;
978
1011
  }
979
1012
  /**
980
1013
  * True when the phone you supplied belongs to another email
package/dist/index.d.cts CHANGED
@@ -1,5 +1,5 @@
1
- import { A as ApproveResult, C as ConfirmReceiptResult, P as PurchaseStatusResult, a as PurchaseCredited, b as PurchaseExpired, c as PurchaseRefunded, d as PurchaseRefused, e as CheckoutClientConfig, H as Http, f as PurchaseStatusInput, g as CallOptions, W as WaitForPurchaseInput, M as MountCheckoutOptions, h as CheckoutMountHandle, i as ClientConfig, j as PhoneChangeApprovalsResult, k as ApprovePhoneChangeInput, l as ApprovePhoneChangeResult, L as LinkDeviceResult, m as PendingCollectResult, D as DestinationsQuery, n as DestinationsResult, B as BalanceResult, o as LoyaltyCardsResult, p as LoyaltyVaultResult, R as RedeemRewardResult, q as RewardsPageLink, E as EnrollmentBeginResult, r as EnrollmentVerifyResult, s as RecoveryBeginResult, t as RecoveryCompleteResult } from './types-C7vpPqsF.cjs';
2
- export { u as BalanceRow, v as CheckoutPurchaseStatus, w as ClaimDelivery, x as DestinationGame, I as InvoError, y as InvoErrorInfo, z as InvoHooks, F as InvoRequestInfo, G as InvoResponseInfo, J as LoyaltyCard, K as LoyaltyCardReward, N as LoyaltyCardStep, O as LoyaltyRewardState, Q as LoyaltyStepProgress, S as LoyaltyStepState, T as LoyaltyVaultEntry, U as PendingCollectItem, V as PhoneChangeApproval, X as PhoneChangeDeviceSignal, Y as PurchaseRefusalReason, Z as Rail, _ as VerificationMethod } from './types-C7vpPqsF.cjs';
1
+ import { A as ApproveResult, C as ConfirmReceiptResult, P as PurchaseStatusResult, a as PurchaseCredited, b as PurchaseExpired, c as PurchaseRefunded, d as PurchaseRefused, e as CheckoutClientConfig, H as Http, f as PurchaseStatusInput, g as CallOptions, W as WaitForPurchaseInput, M as MountCheckoutOptions, h as CheckoutMountHandle, i as ClientConfig, j as PhoneChangeApprovalsResult, k as ApprovePhoneChangeInput, l as ApprovePhoneChangeResult, L as LinkDeviceResult, m as PendingCollectResult, D as DestinationsQuery, n as DestinationsResult, B as BalanceResult, o as LoyaltyCardsResult, p as LoyaltyVaultResult, R as RedeemRewardResult, q as RewardsPageLink, E as EnrollmentBeginResult, r as EnrollmentVerifyResult, s as RecoveryBeginResult, t as RecoveryCompleteResult } from './types-Cjd4SAR8.cjs';
2
+ export { u as BalanceRow, v as CheckoutPurchaseStatus, w as ClaimDelivery, x as DestinationGame, I as InvoError, y as InvoErrorInfo, z as InvoHooks, F as InvoRequestInfo, G as InvoResponseInfo, J as LoyaltyCard, K as LoyaltyCardReward, N as LoyaltyCardStep, O as LoyaltyRewardState, Q as LoyaltyStepProgress, S as LoyaltyStepState, T as LoyaltyVaultEntry, U as PendingCollectItem, V as PhoneChangeApproval, X as PhoneChangeDeviceSignal, Y as PurchaseRefusalReason, Z as Rail, _ as VerificationMethod } from './types-Cjd4SAR8.cjs';
3
3
 
4
4
  /** The four device-approval flows (`begin.flow`). */
5
5
  type HostedFlow = "transfer" | "send" | "send_receipt" | "transfer_receipt";
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { A as ApproveResult, C as ConfirmReceiptResult, P as PurchaseStatusResult, a as PurchaseCredited, b as PurchaseExpired, c as PurchaseRefunded, d as PurchaseRefused, e as CheckoutClientConfig, H as Http, f as PurchaseStatusInput, g as CallOptions, W as WaitForPurchaseInput, M as MountCheckoutOptions, h as CheckoutMountHandle, i as ClientConfig, j as PhoneChangeApprovalsResult, k as ApprovePhoneChangeInput, l as ApprovePhoneChangeResult, L as LinkDeviceResult, m as PendingCollectResult, D as DestinationsQuery, n as DestinationsResult, B as BalanceResult, o as LoyaltyCardsResult, p as LoyaltyVaultResult, R as RedeemRewardResult, q as RewardsPageLink, E as EnrollmentBeginResult, r as EnrollmentVerifyResult, s as RecoveryBeginResult, t as RecoveryCompleteResult } from './types-C7vpPqsF.js';
2
- export { u as BalanceRow, v as CheckoutPurchaseStatus, w as ClaimDelivery, x as DestinationGame, I as InvoError, y as InvoErrorInfo, z as InvoHooks, F as InvoRequestInfo, G as InvoResponseInfo, J as LoyaltyCard, K as LoyaltyCardReward, N as LoyaltyCardStep, O as LoyaltyRewardState, Q as LoyaltyStepProgress, S as LoyaltyStepState, T as LoyaltyVaultEntry, U as PendingCollectItem, V as PhoneChangeApproval, X as PhoneChangeDeviceSignal, Y as PurchaseRefusalReason, Z as Rail, _ as VerificationMethod } from './types-C7vpPqsF.js';
1
+ import { A as ApproveResult, C as ConfirmReceiptResult, P as PurchaseStatusResult, a as PurchaseCredited, b as PurchaseExpired, c as PurchaseRefunded, d as PurchaseRefused, e as CheckoutClientConfig, H as Http, f as PurchaseStatusInput, g as CallOptions, W as WaitForPurchaseInput, M as MountCheckoutOptions, h as CheckoutMountHandle, i as ClientConfig, j as PhoneChangeApprovalsResult, k as ApprovePhoneChangeInput, l as ApprovePhoneChangeResult, L as LinkDeviceResult, m as PendingCollectResult, D as DestinationsQuery, n as DestinationsResult, B as BalanceResult, o as LoyaltyCardsResult, p as LoyaltyVaultResult, R as RedeemRewardResult, q as RewardsPageLink, E as EnrollmentBeginResult, r as EnrollmentVerifyResult, s as RecoveryBeginResult, t as RecoveryCompleteResult } from './types-Cjd4SAR8.js';
2
+ export { u as BalanceRow, v as CheckoutPurchaseStatus, w as ClaimDelivery, x as DestinationGame, I as InvoError, y as InvoErrorInfo, z as InvoHooks, F as InvoRequestInfo, G as InvoResponseInfo, J as LoyaltyCard, K as LoyaltyCardReward, N as LoyaltyCardStep, O as LoyaltyRewardState, Q as LoyaltyStepProgress, S as LoyaltyStepState, T as LoyaltyVaultEntry, U as PendingCollectItem, V as PhoneChangeApproval, X as PhoneChangeDeviceSignal, Y as PurchaseRefusalReason, Z as Rail, _ as VerificationMethod } from './types-Cjd4SAR8.js';
3
3
 
4
4
  /** The four device-approval flows (`begin.flow`). */
5
5
  type HostedFlow = "transfer" | "send" | "send_receipt" | "transfer_receipt";
package/dist/index.js CHANGED
@@ -1,5 +1,5 @@
1
- import { InvoError, assertSecureBaseUrl, Http, toPhoneChangeApprovalsResult, phoneChangeSignalMessage, toApprovePhoneChangeResult, toDestinationsResult, toLoyaltyCardsResult, toLoyaltyVaultResult, toRedeemRewardResult, toRewardsPageLink, receiptFields } from './chunk-BOD4WOWO.js';
2
- export { InvoError, phoneChangeSignalMessage } from './chunk-BOD4WOWO.js';
1
+ import { InvoError, assertSecureBaseUrl, Http, toPhoneChangeApprovalsResult, phoneChangeSignalMessage, toApprovePhoneChangeResult, toDestinationsResult, toLoyaltyCardsResult, toLoyaltyVaultResult, toRedeemRewardResult, toRewardsPageLink, receiptFields } from './chunk-7BYAUHTA.js';
2
+ export { InvoError, phoneChangeSignalMessage } from './chunk-7BYAUHTA.js';
3
3
 
4
4
  // src/shared/webauthn.ts
5
5
  function malformedOptions(field) {
package/dist/server.cjs CHANGED
@@ -224,11 +224,18 @@ var InvoError = class _InvoError extends Error {
224
224
  get isNotPlatformTenant() {
225
225
  return this.code === "NOT_A_PLATFORM_TENANT";
226
226
  }
227
- /** True if a Platform Commerce purchase, or a `purchaseItem` spend, was too small for the
228
- * fee to round above zero (`AMOUNT_BELOW_MINIMUM`, 400) — raise the amount. `purchaseItem`
229
- * rounds `totalPrice` to cents before this check. */
227
+ /**
228
+ * True on `AMOUNT_BELOW_MINIMUM` (400), which three calls answer:
229
+ * - a Platform Commerce purchase, or a `purchaseItem` spend, too small for the fee to
230
+ * round above zero: raise the amount (`purchaseItem` rounds `totalPrice` to cents
231
+ * before this check);
232
+ * - initiate-send / initiate-transfer below the sending title's minimum (backend
233
+ * 2026-10-12): the limit is on {@link minimumAmount}, in the title's own currency
234
+ * ({@link limitCurrencyName}). On the wallet transfer route {@link code} stays
235
+ * `INVALID_AMOUNT`; this predicate reads `error_code` too.
236
+ */
230
237
  get isAmountBelowMinimum() {
231
- return this.code === "AMOUNT_BELOW_MINIMUM";
238
+ return this.code === "AMOUNT_BELOW_MINIMUM" || this.bodyObject()["error_code"] === "AMOUNT_BELOW_MINIMUM";
232
239
  }
233
240
  /**
234
241
  * True if the `rail` you sent disagrees with the storefront key you
@@ -971,12 +978,38 @@ var InvoError = class _InvoError extends Error {
971
978
  return typeof e === "string" && e.startsWith("SIGNAL_");
972
979
  }
973
980
  /**
974
- * True when `registerPlayer` found the player already in your game with a DIFFERENT
975
- * phone (`PHONE_MISMATCH`, 409). Nothing changed; use `updatePlayerPhone` to change it.
981
+ * True when the phone you supplied is not the one on file for that player
982
+ * (`PHONE_MISMATCH`). Two places answer it:
983
+ * - `registerPlayer` (409): the player is already in your game with a different
984
+ * phone. Nothing changed; use `updatePlayerPhone` to change it.
985
+ * - initiate-send / initiate-transfer (400, since backend 2026-10-12): the sender
986
+ * phone does not match. Change the number first with `requestPhoneChange`.
976
987
  * (`mintPlayerToken` reports the same situation as `phoneMismatch: true` on success.)
977
988
  */
978
989
  get isPhoneMismatch() {
979
- return this.code === "PHONE_MISMATCH";
990
+ return this.code === "PHONE_MISMATCH" || this.bodyObject()["error_code"] === "PHONE_MISMATCH";
991
+ }
992
+ /**
993
+ * True when a send or transfer amount is above the sending title's maximum or the
994
+ * network ceiling for one move (`AMOUNT_ABOVE_MAXIMUM`, 400). See {@link maximumAmount}.
995
+ */
996
+ get isAmountAboveMaximum() {
997
+ return this.code === "AMOUNT_ABOVE_MAXIMUM" || this.bodyObject()["error_code"] === "AMOUNT_ABOVE_MAXIMUM";
998
+ }
999
+ /** The minimum amount (decimal string) on an `AMOUNT_BELOW_MINIMUM` refusal. */
1000
+ get minimumAmount() {
1001
+ const v = this.bodyObject()["minimum_amount"];
1002
+ return typeof v === "string" ? v : void 0;
1003
+ }
1004
+ /** The maximum amount (decimal string) on an `AMOUNT_ABOVE_MAXIMUM` refusal. */
1005
+ get maximumAmount() {
1006
+ const v = this.bodyObject()["maximum_amount"];
1007
+ return typeof v === "string" ? v : void 0;
1008
+ }
1009
+ /** The sending title's currency name on an amount-limit refusal, when it has one. */
1010
+ get limitCurrencyName() {
1011
+ const v = this.bodyObject()["currency_name"];
1012
+ return typeof v === "string" ? v : void 0;
980
1013
  }
981
1014
  /**
982
1015
  * True when the phone you supplied belongs to another email
@@ -1495,7 +1528,7 @@ function toPhoneChangeRequest(raw) {
1495
1528
  }
1496
1529
 
1497
1530
  // src/version.ts
1498
- var SDK_VERSION = "3.23.0";
1531
+ var SDK_VERSION = "3.24.1";
1499
1532
 
1500
1533
  // src/shared/types.ts
1501
1534
  function isRefundPendingApproval(r) {
@@ -1917,6 +1950,10 @@ function toPlayerActivityEntry(raw) {
1917
1950
  createdAt: strOrNull3(raw["created_at"]),
1918
1951
  completedAt: strOrNull3(raw["completed_at"]),
1919
1952
  orderId: strOrNull3(raw["order_id"]),
1953
+ // Additive fee fields (backend 2026-10-12): set only when INVO sent the key.
1954
+ ..."fee_amount" in raw ? { feeAmount: strOrNull3(raw["fee_amount"]) } : {},
1955
+ ..."net_amount" in raw ? { netAmount: strOrNull3(raw["net_amount"]) } : {},
1956
+ ..."gross_amount" in raw ? { grossAmount: strOrNull3(raw["gross_amount"]) } : {},
1920
1957
  raw
1921
1958
  };
1922
1959
  }
package/dist/server.d.cts CHANGED
@@ -1,12 +1,12 @@
1
- import { I as InvoError, H as Http, $ as AuthHeader, a0 as CardSetupSessionInput, g as CallOptions, a1 as CardSetupSessionResult, a2 as CardSetupInput, a3 as CardSetupResult, a4 as CardSetupConfirmInput, a5 as CardSetupConfirmResult, a6 as PlayerCardsResult, a7 as PlatformPurchaseInput, a8 as PlatformPurchaseResult, a9 as PlatformOrderStatusResult, aa as PlatformPurchaseHistoryQuery, ab as PlatformPurchaseHistoryResult, ac as PlatformRefundInput, ad as PlatformRefundResult, ae as CreateSubscriptionInput, af as SubscriptionResult, ag as GetSubscriptionOptions, ah as GetSubscriptionResult, ai as ListSubscriptionsOptions, aj as SubscriptionListResult, ak as CancelSubscriptionOptions, al as CancelResult, am as ChangeAmountResult, an as SetPaymentMethodInput, ao as SetPaymentMethodResult, ap as RefundSubscriptionInput, aq as RefundResult, ar as SteamSubscriptionInitInput, as as SteamInitResult, at as SteamFinalizeSubscriptionResult, au as SandboxClockResult, av as SandboxFailureOutcome, aw as SandboxForceFailureOptions, ax as SandboxForceAuthChallengeOptions, ay as ServerConfig, az as MintPlayerTokenInput, aA as PlayerToken, aB as RegisterPlayerInput, aC as RegisterPlayerResult, aD as UpdatePlayerPhoneInput, aE as UpdatePlayerPhoneResult, aF as RequestPhoneChangeInput, aG as RequestPhoneChangeResult, aH as PhoneChangeRequest, aI as InitiateSendInput, aJ as InitiateResult, aK as InitiateTransferInput, aL as CreateCheckoutInput, aM as CreateCheckoutResult, aN as PurchaseInput, aO as PurchaseResult, aP as CurrencyPurchaseQuoteInput, aQ as CurrencyPurchaseQuote, aR as ConfirmPaymentResult, aS as OrderDetailsResult, aT as SteamPacksQuery, aU as SteamPacksResult, aV as SteamInitPurchaseInput, aW as SteamInitPurchaseResult, aX as SteamFinalizeInput, aY as SteamFinalizeResult, aZ as PurchaseItemInput, a_ as PurchaseItemResult, a$ as ItemHistoryQuery, b0 as ItemHistoryResult, b1 as ItemOrderQuery, b2 as PlayerActivityQuery, b3 as PlayerActivityResult, b4 as PlayerActivityEntry, b5 as PlayerBalanceQuery, b6 as PlayerBalanceResult, o as LoyaltyCardsResult, b7 as InboundPendingQuery, b8 as InboundPendingResult, b9 as LinkedIdentitiesQuery, ba as LinkedIdentitiesResult, bb as SmsVerifyResult, bc as ClaimTransferInput, bd as ClaimResult, be as ClaimCurrencyInput, bf as TransactionStatusResult, bg as GuardianApprovalStatusResult, bh as ServerDestinationsQuery, n as DestinationsResult, bi as PhoneShareContact, bj as PhoneShareInitiateResult, bk as PhoneShareApproveInput, bl as PhoneShareApproveResult, bm as PhoneShareStatusResult, bn as BeginDeviceApprovalInput, bo as DeviceApprovalGrant, bp as PollDeviceApprovalInput, bq as DeviceApprovalPollResult, br as ConfirmDeviceEnrollmentInput, bs as ConfirmDeviceEnrollmentResult, bt as ApproveWithDeviceCodeInput, bu as DeviceApprovalSettleResult, bv as CompleteDeviceApprovalInput, bw as CompleteDeviceApprovalResult } from './types-C7vpPqsF.cjs';
2
- export { bx as CardSetupStatus, by as CheckoutWarning, w as ClaimDelivery, bz as CurrencyBalance, bA as CurrencyPurchaseQuoteBreakdown, x as DestinationGame, bB as DeviceApprovalChannel, bC as DeviceApprovalEnrollment, bD as DeviceApprovalFlow, bE as DeviceApprovalPollStatus, bF as DeviceEnrollmentDecision, bG as DeviceEnrollmentRespond, bH as ExpiryReason, bI as FeeTakenFrom, bJ as FirstCharge, bK as FirstChargeStatus, bL as FundingSource, bM as InboundPendingItem, y as InvoErrorInfo, z as InvoHooks, F as InvoRequestInfo, G as InvoResponseInfo, bN as LinkedIdentityEmail, J as LoyaltyCard, K as LoyaltyCardReward, N as LoyaltyCardStep, O as LoyaltyRewardState, Q as LoyaltyStepProgress, S as LoyaltyStepState, bO as MinPurchaseWarning, bP as PhoneChangeConfirmation, bQ as PhoneChangeRequestStatus, bR as PlatformPurchaseStatus, bS as PlayerActivityType, Z as Rail, bT as RefundInitiation, bU as RefundPendingApproval, bV as RefundProcessingFeeBasis, bW as RefundReceipt, bX as RefundRevenueShareAttribution, bY as RefundWarning, bZ as SandboxClockState, b_ as SavedCard, b$ as SteamPack, c0 as SteamUserSession, c1 as Subscription, c2 as SubscriptionBaseInput, c3 as SubscriptionConsent, c4 as SubscriptionConsentInput, c5 as SubscriptionFundingRail, c6 as SubscriptionInterval, c7 as SubscriptionRevenueShare, c8 as SubscriptionRevenueShareInput, c9 as SubscriptionStatus, ca as UnacknowledgedPurchaseOutcome, _ as VerificationMethod, cb as isRefundPendingApproval } from './types-C7vpPqsF.cjs';
1
+ import { I as InvoError, H as Http, $ as AuthHeader, a0 as CardSetupSessionInput, g as CallOptions, a1 as CardSetupSessionResult, a2 as CardSetupInput, a3 as CardSetupResult, a4 as CardSetupConfirmInput, a5 as CardSetupConfirmResult, a6 as PlayerCardsResult, a7 as PlatformPurchaseInput, a8 as PlatformPurchaseResult, a9 as PlatformOrderStatusResult, aa as PlatformPurchaseHistoryQuery, ab as PlatformPurchaseHistoryResult, ac as PlatformRefundInput, ad as PlatformRefundResult, ae as CreateSubscriptionInput, af as SubscriptionResult, ag as GetSubscriptionOptions, ah as GetSubscriptionResult, ai as ListSubscriptionsOptions, aj as SubscriptionListResult, ak as CancelSubscriptionOptions, al as CancelResult, am as ChangeAmountResult, an as SetPaymentMethodInput, ao as SetPaymentMethodResult, ap as RefundSubscriptionInput, aq as RefundResult, ar as SteamSubscriptionInitInput, as as SteamInitResult, at as SteamFinalizeSubscriptionResult, au as SandboxClockResult, av as SandboxFailureOutcome, aw as SandboxForceFailureOptions, ax as SandboxForceAuthChallengeOptions, ay as ServerConfig, az as MintPlayerTokenInput, aA as PlayerToken, aB as RegisterPlayerInput, aC as RegisterPlayerResult, aD as UpdatePlayerPhoneInput, aE as UpdatePlayerPhoneResult, aF as RequestPhoneChangeInput, aG as RequestPhoneChangeResult, aH as PhoneChangeRequest, aI as InitiateSendInput, aJ as InitiateResult, aK as InitiateTransferInput, aL as CreateCheckoutInput, aM as CreateCheckoutResult, aN as PurchaseInput, aO as PurchaseResult, aP as CurrencyPurchaseQuoteInput, aQ as CurrencyPurchaseQuote, aR as ConfirmPaymentResult, aS as OrderDetailsResult, aT as SteamPacksQuery, aU as SteamPacksResult, aV as SteamInitPurchaseInput, aW as SteamInitPurchaseResult, aX as SteamFinalizeInput, aY as SteamFinalizeResult, aZ as PurchaseItemInput, a_ as PurchaseItemResult, a$ as ItemHistoryQuery, b0 as ItemHistoryResult, b1 as ItemOrderQuery, b2 as PlayerActivityQuery, b3 as PlayerActivityResult, b4 as PlayerActivityEntry, b5 as PlayerBalanceQuery, b6 as PlayerBalanceResult, o as LoyaltyCardsResult, b7 as InboundPendingQuery, b8 as InboundPendingResult, b9 as LinkedIdentitiesQuery, ba as LinkedIdentitiesResult, bb as SmsVerifyResult, bc as ClaimTransferInput, bd as ClaimResult, be as ClaimCurrencyInput, bf as TransactionStatusResult, bg as GuardianApprovalStatusResult, bh as ServerDestinationsQuery, n as DestinationsResult, bi as PhoneShareContact, bj as PhoneShareInitiateResult, bk as PhoneShareApproveInput, bl as PhoneShareApproveResult, bm as PhoneShareStatusResult, bn as BeginDeviceApprovalInput, bo as DeviceApprovalGrant, bp as PollDeviceApprovalInput, bq as DeviceApprovalPollResult, br as ConfirmDeviceEnrollmentInput, bs as ConfirmDeviceEnrollmentResult, bt as ApproveWithDeviceCodeInput, bu as DeviceApprovalSettleResult, bv as CompleteDeviceApprovalInput, bw as CompleteDeviceApprovalResult } from './types-Cjd4SAR8.cjs';
2
+ export { bx as CardSetupStatus, by as CheckoutWarning, w as ClaimDelivery, bz as CurrencyBalance, bA as CurrencyPurchaseQuoteBreakdown, x as DestinationGame, bB as DeviceApprovalChannel, bC as DeviceApprovalEnrollment, bD as DeviceApprovalFlow, bE as DeviceApprovalPollStatus, bF as DeviceEnrollmentDecision, bG as DeviceEnrollmentRespond, bH as ExpiryReason, bI as FeeTakenFrom, bJ as FirstCharge, bK as FirstChargeStatus, bL as FundingSource, bM as InboundPendingItem, y as InvoErrorInfo, z as InvoHooks, F as InvoRequestInfo, G as InvoResponseInfo, bN as LinkedIdentityEmail, J as LoyaltyCard, K as LoyaltyCardReward, N as LoyaltyCardStep, O as LoyaltyRewardState, Q as LoyaltyStepProgress, S as LoyaltyStepState, bO as MinPurchaseWarning, bP as PhoneChangeConfirmation, bQ as PhoneChangeRequestStatus, bR as PlatformPurchaseStatus, bS as PlayerActivityType, Z as Rail, bT as RefundInitiation, bU as RefundPendingApproval, bV as RefundProcessingFeeBasis, bW as RefundReceipt, bX as RefundRevenueShareAttribution, bY as RefundWarning, bZ as SandboxClockState, b_ as SavedCard, b$ as SteamPack, c0 as SteamUserSession, c1 as Subscription, c2 as SubscriptionBaseInput, c3 as SubscriptionConsent, c4 as SubscriptionConsentInput, c5 as SubscriptionFundingRail, c6 as SubscriptionInterval, c7 as SubscriptionRevenueShare, c8 as SubscriptionRevenueShareInput, c9 as SubscriptionStatus, ca as UnacknowledgedPurchaseOutcome, _ as VerificationMethod, cb as isRefundPendingApproval } from './types-Cjd4SAR8.cjs';
3
3
 
4
4
  /**
5
5
  * The package version, as sent in the server User-Agent. A test pins this to
6
6
  * `package.json` so it cannot drift silently (it did: the UA read 3.0.0 through 3.7.0).
7
7
  * Bump it with the changeset flow.
8
8
  */
9
- declare const SDK_VERSION = "3.23.0";
9
+ declare const SDK_VERSION = "3.24.1";
10
10
 
11
11
  interface VerifyWebhookOptions {
12
12
  /** Max age of the signed timestamp, in seconds. Default 300 (5 min). */
@@ -366,6 +366,25 @@ interface PlayerPhoneChangedData {
366
366
  previous_identity_id: string;
367
367
  [key: string]: unknown;
368
368
  }
369
+ /**
370
+ * `identity.passkey_reset`: a player replaced a lost INVO passkey through recovery, on
371
+ * INVO's approval or claim page or in your app through `recoveryBegin` /
372
+ * `recoveryComplete` (the in-app path sends it since backend 2026-10-12). Sent to the
373
+ * game the recovery ran in. Sending money out is paused for that player until
374
+ * `cooldown_until`; receiving and collecting still work. Tell the player, or flag the
375
+ * account, if they did not start it.
376
+ */
377
+ interface IdentityPasskeyResetData {
378
+ /** The player's opaque identity id (the same id `player.phone_changed` carries). */
379
+ identity_id: string;
380
+ /** `"hosted_device"`, `"hosted_claim"` or `"sdk"`. */
381
+ reset_via: "hosted_device" | "hosted_claim" | "sdk" | (string & {});
382
+ /** ISO timestamp: until when sending money out is paused for this player. */
383
+ cooldown_until: string | null;
384
+ /** How many passkeys were switched off. */
385
+ deactivated_count: number;
386
+ [key: string]: unknown;
387
+ }
369
388
  /**
370
389
  * The block every subscription event carries EXCEPT `subscription.renewed` and
371
390
  * `subscription.refunded`, which have their own shapes. `identity_id` is an opaque,
@@ -808,6 +827,9 @@ type InvoWebhookEvent = (WebhookBase & {
808
827
  }) | (WebhookBase & {
809
828
  event_type: "player.phone_changed";
810
829
  data: PlayerPhoneChangedData;
830
+ }) | (WebhookBase & {
831
+ event_type: "identity.passkey_reset";
832
+ data: IdentityPasskeyResetData;
811
833
  }) | (WebhookBase & {
812
834
  event_type: "webhook.test";
813
835
  data: Record<string, unknown>;
@@ -1857,4 +1879,4 @@ declare class InvoServer {
1857
1879
  private toInitiateResult;
1858
1880
  }
1859
1881
 
1860
- export { ApproveWithDeviceCodeInput, BeginDeviceApprovalInput, CallOptions, CancelResult, CancelSubscriptionOptions, CardSetupConfirmInput, CardSetupConfirmResult, CardSetupInput, CardSetupResult, CardSetupSessionInput, CardSetupSessionResult, CardsServer, ChangeAmountResult, ClaimCurrencyInput, ClaimResult, ClaimTransferInput, CompleteDeviceApprovalInput, CompleteDeviceApprovalResult, ConfirmDeviceEnrollmentInput, ConfirmDeviceEnrollmentResult, ConfirmPaymentResult, CreateCheckoutInput, CreateCheckoutResult, CreateSubscriptionInput, CurrencyPurchaseQuote, CurrencyPurchaseQuoteInput, DestinationsResult, DeviceApprovalGrant, DeviceApprovalPollResult, DeviceApprovalSettleResult, GetSubscriptionOptions, GetSubscriptionResult, GuardianApprovalStatusResult, InboundPendingQuery, InboundPendingResult, InitiateResult, InitiateSendInput, InitiateTransferInput, InvoError, InvoServer, type InvoWebhookEvent, ItemHistoryQuery, ItemHistoryResult, ItemOrderQuery, type ItemPurchasedData, LinkedIdentitiesQuery, LinkedIdentitiesResult, ListSubscriptionsOptions, LoyaltyCardsResult, MintPlayerTokenInput, OrderDetailsResult, type PayoutStatusChangedData, PhoneChangeRequest, PhoneShareApproveInput, PhoneShareApproveResult, PhoneShareContact, PhoneShareInitiateResult, PhoneShareStatusResult, type PlatformCommercePurchasedData, type PlatformCommerceRefundedData, PlatformCommerceServer, PlatformOrderStatusResult, PlatformPurchaseHistoryQuery, PlatformPurchaseHistoryResult, PlatformPurchaseInput, PlatformPurchaseResult, PlatformRefundInput, PlatformRefundResult, PlayerActivityEntry, PlayerActivityQuery, PlayerActivityResult, PlayerBalanceQuery, PlayerBalanceResult, PlayerCardsResult, type PlayerPhoneChangedData, PlayerToken, PollDeviceApprovalInput, type PurchaseCompletedData, type PurchaseEventData, PurchaseInput, PurchaseItemInput, PurchaseItemResult, PurchaseResult, RefundResult, RefundSubscriptionInput, RegisterPlayerInput, RegisterPlayerResult, RequestPhoneChangeInput, RequestPhoneChangeResult, SDK_VERSION, SandboxClockResult, SandboxFailureOutcome, SandboxForceAuthChallengeOptions, SandboxForceFailureOptions, SandboxServer, SandboxSubscriptionsServer, ServerConfig, ServerDestinationsQuery, SetPaymentMethodInput, SetPaymentMethodResult, SmsVerifyResult, SteamFinalizeInput, SteamFinalizeResult, SteamFinalizeSubscriptionResult, SteamInitPurchaseInput, SteamInitPurchaseResult, SteamInitResult, SteamPacksQuery, SteamPacksResult, SteamSubscriptionInitInput, type SubscriptionAuthenticationRequiredData, type SubscriptionCanceledData, type SubscriptionEventCommon, type SubscriptionExpiredData, SubscriptionListResult, type SubscriptionPastDueData, type SubscriptionPaymentFailedData, type SubscriptionRefundApprovedData, type SubscriptionRefundDetail, type SubscriptionRefundRejectedData, type SubscriptionRefundRequestData, type SubscriptionRefundedData, type SubscriptionRenewalFunding, type SubscriptionRenewalSplit, type SubscriptionRenewedData, SubscriptionResult, type SubscriptionRevenueShareAttribution, type SubscriptionTrialEventFields, SubscriptionsServer, TransactionStatusResult, type TransferEventData, UpdatePlayerPhoneInput, UpdatePlayerPhoneResult, type VerifyWebhookOptions, type WebhookHandlerOptions, createWebhookHandler, verifyWebhook, verifyWebhookAsync };
1882
+ export { ApproveWithDeviceCodeInput, BeginDeviceApprovalInput, CallOptions, CancelResult, CancelSubscriptionOptions, CardSetupConfirmInput, CardSetupConfirmResult, CardSetupInput, CardSetupResult, CardSetupSessionInput, CardSetupSessionResult, CardsServer, ChangeAmountResult, ClaimCurrencyInput, ClaimResult, ClaimTransferInput, CompleteDeviceApprovalInput, CompleteDeviceApprovalResult, ConfirmDeviceEnrollmentInput, ConfirmDeviceEnrollmentResult, ConfirmPaymentResult, CreateCheckoutInput, CreateCheckoutResult, CreateSubscriptionInput, CurrencyPurchaseQuote, CurrencyPurchaseQuoteInput, DestinationsResult, DeviceApprovalGrant, DeviceApprovalPollResult, DeviceApprovalSettleResult, GetSubscriptionOptions, GetSubscriptionResult, GuardianApprovalStatusResult, type IdentityPasskeyResetData, InboundPendingQuery, InboundPendingResult, InitiateResult, InitiateSendInput, InitiateTransferInput, InvoError, InvoServer, type InvoWebhookEvent, ItemHistoryQuery, ItemHistoryResult, ItemOrderQuery, type ItemPurchasedData, LinkedIdentitiesQuery, LinkedIdentitiesResult, ListSubscriptionsOptions, LoyaltyCardsResult, MintPlayerTokenInput, OrderDetailsResult, type PayoutStatusChangedData, PhoneChangeRequest, PhoneShareApproveInput, PhoneShareApproveResult, PhoneShareContact, PhoneShareInitiateResult, PhoneShareStatusResult, type PlatformCommercePurchasedData, type PlatformCommerceRefundedData, PlatformCommerceServer, PlatformOrderStatusResult, PlatformPurchaseHistoryQuery, PlatformPurchaseHistoryResult, PlatformPurchaseInput, PlatformPurchaseResult, PlatformRefundInput, PlatformRefundResult, PlayerActivityEntry, PlayerActivityQuery, PlayerActivityResult, PlayerBalanceQuery, PlayerBalanceResult, PlayerCardsResult, type PlayerPhoneChangedData, PlayerToken, PollDeviceApprovalInput, type PurchaseCompletedData, type PurchaseEventData, PurchaseInput, PurchaseItemInput, PurchaseItemResult, PurchaseResult, RefundResult, RefundSubscriptionInput, RegisterPlayerInput, RegisterPlayerResult, RequestPhoneChangeInput, RequestPhoneChangeResult, SDK_VERSION, SandboxClockResult, SandboxFailureOutcome, SandboxForceAuthChallengeOptions, SandboxForceFailureOptions, SandboxServer, SandboxSubscriptionsServer, ServerConfig, ServerDestinationsQuery, SetPaymentMethodInput, SetPaymentMethodResult, SmsVerifyResult, SteamFinalizeInput, SteamFinalizeResult, SteamFinalizeSubscriptionResult, SteamInitPurchaseInput, SteamInitPurchaseResult, SteamInitResult, SteamPacksQuery, SteamPacksResult, SteamSubscriptionInitInput, type SubscriptionAuthenticationRequiredData, type SubscriptionCanceledData, type SubscriptionEventCommon, type SubscriptionExpiredData, SubscriptionListResult, type SubscriptionPastDueData, type SubscriptionPaymentFailedData, type SubscriptionRefundApprovedData, type SubscriptionRefundDetail, type SubscriptionRefundRejectedData, type SubscriptionRefundRequestData, type SubscriptionRefundedData, type SubscriptionRenewalFunding, type SubscriptionRenewalSplit, type SubscriptionRenewedData, SubscriptionResult, type SubscriptionRevenueShareAttribution, type SubscriptionTrialEventFields, SubscriptionsServer, TransactionStatusResult, type TransferEventData, UpdatePlayerPhoneInput, UpdatePlayerPhoneResult, type VerifyWebhookOptions, type WebhookHandlerOptions, createWebhookHandler, verifyWebhook, verifyWebhookAsync };
package/dist/server.d.ts CHANGED
@@ -1,12 +1,12 @@
1
- import { I as InvoError, H as Http, $ as AuthHeader, a0 as CardSetupSessionInput, g as CallOptions, a1 as CardSetupSessionResult, a2 as CardSetupInput, a3 as CardSetupResult, a4 as CardSetupConfirmInput, a5 as CardSetupConfirmResult, a6 as PlayerCardsResult, a7 as PlatformPurchaseInput, a8 as PlatformPurchaseResult, a9 as PlatformOrderStatusResult, aa as PlatformPurchaseHistoryQuery, ab as PlatformPurchaseHistoryResult, ac as PlatformRefundInput, ad as PlatformRefundResult, ae as CreateSubscriptionInput, af as SubscriptionResult, ag as GetSubscriptionOptions, ah as GetSubscriptionResult, ai as ListSubscriptionsOptions, aj as SubscriptionListResult, ak as CancelSubscriptionOptions, al as CancelResult, am as ChangeAmountResult, an as SetPaymentMethodInput, ao as SetPaymentMethodResult, ap as RefundSubscriptionInput, aq as RefundResult, ar as SteamSubscriptionInitInput, as as SteamInitResult, at as SteamFinalizeSubscriptionResult, au as SandboxClockResult, av as SandboxFailureOutcome, aw as SandboxForceFailureOptions, ax as SandboxForceAuthChallengeOptions, ay as ServerConfig, az as MintPlayerTokenInput, aA as PlayerToken, aB as RegisterPlayerInput, aC as RegisterPlayerResult, aD as UpdatePlayerPhoneInput, aE as UpdatePlayerPhoneResult, aF as RequestPhoneChangeInput, aG as RequestPhoneChangeResult, aH as PhoneChangeRequest, aI as InitiateSendInput, aJ as InitiateResult, aK as InitiateTransferInput, aL as CreateCheckoutInput, aM as CreateCheckoutResult, aN as PurchaseInput, aO as PurchaseResult, aP as CurrencyPurchaseQuoteInput, aQ as CurrencyPurchaseQuote, aR as ConfirmPaymentResult, aS as OrderDetailsResult, aT as SteamPacksQuery, aU as SteamPacksResult, aV as SteamInitPurchaseInput, aW as SteamInitPurchaseResult, aX as SteamFinalizeInput, aY as SteamFinalizeResult, aZ as PurchaseItemInput, a_ as PurchaseItemResult, a$ as ItemHistoryQuery, b0 as ItemHistoryResult, b1 as ItemOrderQuery, b2 as PlayerActivityQuery, b3 as PlayerActivityResult, b4 as PlayerActivityEntry, b5 as PlayerBalanceQuery, b6 as PlayerBalanceResult, o as LoyaltyCardsResult, b7 as InboundPendingQuery, b8 as InboundPendingResult, b9 as LinkedIdentitiesQuery, ba as LinkedIdentitiesResult, bb as SmsVerifyResult, bc as ClaimTransferInput, bd as ClaimResult, be as ClaimCurrencyInput, bf as TransactionStatusResult, bg as GuardianApprovalStatusResult, bh as ServerDestinationsQuery, n as DestinationsResult, bi as PhoneShareContact, bj as PhoneShareInitiateResult, bk as PhoneShareApproveInput, bl as PhoneShareApproveResult, bm as PhoneShareStatusResult, bn as BeginDeviceApprovalInput, bo as DeviceApprovalGrant, bp as PollDeviceApprovalInput, bq as DeviceApprovalPollResult, br as ConfirmDeviceEnrollmentInput, bs as ConfirmDeviceEnrollmentResult, bt as ApproveWithDeviceCodeInput, bu as DeviceApprovalSettleResult, bv as CompleteDeviceApprovalInput, bw as CompleteDeviceApprovalResult } from './types-C7vpPqsF.js';
2
- export { bx as CardSetupStatus, by as CheckoutWarning, w as ClaimDelivery, bz as CurrencyBalance, bA as CurrencyPurchaseQuoteBreakdown, x as DestinationGame, bB as DeviceApprovalChannel, bC as DeviceApprovalEnrollment, bD as DeviceApprovalFlow, bE as DeviceApprovalPollStatus, bF as DeviceEnrollmentDecision, bG as DeviceEnrollmentRespond, bH as ExpiryReason, bI as FeeTakenFrom, bJ as FirstCharge, bK as FirstChargeStatus, bL as FundingSource, bM as InboundPendingItem, y as InvoErrorInfo, z as InvoHooks, F as InvoRequestInfo, G as InvoResponseInfo, bN as LinkedIdentityEmail, J as LoyaltyCard, K as LoyaltyCardReward, N as LoyaltyCardStep, O as LoyaltyRewardState, Q as LoyaltyStepProgress, S as LoyaltyStepState, bO as MinPurchaseWarning, bP as PhoneChangeConfirmation, bQ as PhoneChangeRequestStatus, bR as PlatformPurchaseStatus, bS as PlayerActivityType, Z as Rail, bT as RefundInitiation, bU as RefundPendingApproval, bV as RefundProcessingFeeBasis, bW as RefundReceipt, bX as RefundRevenueShareAttribution, bY as RefundWarning, bZ as SandboxClockState, b_ as SavedCard, b$ as SteamPack, c0 as SteamUserSession, c1 as Subscription, c2 as SubscriptionBaseInput, c3 as SubscriptionConsent, c4 as SubscriptionConsentInput, c5 as SubscriptionFundingRail, c6 as SubscriptionInterval, c7 as SubscriptionRevenueShare, c8 as SubscriptionRevenueShareInput, c9 as SubscriptionStatus, ca as UnacknowledgedPurchaseOutcome, _ as VerificationMethod, cb as isRefundPendingApproval } from './types-C7vpPqsF.js';
1
+ import { I as InvoError, H as Http, $ as AuthHeader, a0 as CardSetupSessionInput, g as CallOptions, a1 as CardSetupSessionResult, a2 as CardSetupInput, a3 as CardSetupResult, a4 as CardSetupConfirmInput, a5 as CardSetupConfirmResult, a6 as PlayerCardsResult, a7 as PlatformPurchaseInput, a8 as PlatformPurchaseResult, a9 as PlatformOrderStatusResult, aa as PlatformPurchaseHistoryQuery, ab as PlatformPurchaseHistoryResult, ac as PlatformRefundInput, ad as PlatformRefundResult, ae as CreateSubscriptionInput, af as SubscriptionResult, ag as GetSubscriptionOptions, ah as GetSubscriptionResult, ai as ListSubscriptionsOptions, aj as SubscriptionListResult, ak as CancelSubscriptionOptions, al as CancelResult, am as ChangeAmountResult, an as SetPaymentMethodInput, ao as SetPaymentMethodResult, ap as RefundSubscriptionInput, aq as RefundResult, ar as SteamSubscriptionInitInput, as as SteamInitResult, at as SteamFinalizeSubscriptionResult, au as SandboxClockResult, av as SandboxFailureOutcome, aw as SandboxForceFailureOptions, ax as SandboxForceAuthChallengeOptions, ay as ServerConfig, az as MintPlayerTokenInput, aA as PlayerToken, aB as RegisterPlayerInput, aC as RegisterPlayerResult, aD as UpdatePlayerPhoneInput, aE as UpdatePlayerPhoneResult, aF as RequestPhoneChangeInput, aG as RequestPhoneChangeResult, aH as PhoneChangeRequest, aI as InitiateSendInput, aJ as InitiateResult, aK as InitiateTransferInput, aL as CreateCheckoutInput, aM as CreateCheckoutResult, aN as PurchaseInput, aO as PurchaseResult, aP as CurrencyPurchaseQuoteInput, aQ as CurrencyPurchaseQuote, aR as ConfirmPaymentResult, aS as OrderDetailsResult, aT as SteamPacksQuery, aU as SteamPacksResult, aV as SteamInitPurchaseInput, aW as SteamInitPurchaseResult, aX as SteamFinalizeInput, aY as SteamFinalizeResult, aZ as PurchaseItemInput, a_ as PurchaseItemResult, a$ as ItemHistoryQuery, b0 as ItemHistoryResult, b1 as ItemOrderQuery, b2 as PlayerActivityQuery, b3 as PlayerActivityResult, b4 as PlayerActivityEntry, b5 as PlayerBalanceQuery, b6 as PlayerBalanceResult, o as LoyaltyCardsResult, b7 as InboundPendingQuery, b8 as InboundPendingResult, b9 as LinkedIdentitiesQuery, ba as LinkedIdentitiesResult, bb as SmsVerifyResult, bc as ClaimTransferInput, bd as ClaimResult, be as ClaimCurrencyInput, bf as TransactionStatusResult, bg as GuardianApprovalStatusResult, bh as ServerDestinationsQuery, n as DestinationsResult, bi as PhoneShareContact, bj as PhoneShareInitiateResult, bk as PhoneShareApproveInput, bl as PhoneShareApproveResult, bm as PhoneShareStatusResult, bn as BeginDeviceApprovalInput, bo as DeviceApprovalGrant, bp as PollDeviceApprovalInput, bq as DeviceApprovalPollResult, br as ConfirmDeviceEnrollmentInput, bs as ConfirmDeviceEnrollmentResult, bt as ApproveWithDeviceCodeInput, bu as DeviceApprovalSettleResult, bv as CompleteDeviceApprovalInput, bw as CompleteDeviceApprovalResult } from './types-Cjd4SAR8.js';
2
+ export { bx as CardSetupStatus, by as CheckoutWarning, w as ClaimDelivery, bz as CurrencyBalance, bA as CurrencyPurchaseQuoteBreakdown, x as DestinationGame, bB as DeviceApprovalChannel, bC as DeviceApprovalEnrollment, bD as DeviceApprovalFlow, bE as DeviceApprovalPollStatus, bF as DeviceEnrollmentDecision, bG as DeviceEnrollmentRespond, bH as ExpiryReason, bI as FeeTakenFrom, bJ as FirstCharge, bK as FirstChargeStatus, bL as FundingSource, bM as InboundPendingItem, y as InvoErrorInfo, z as InvoHooks, F as InvoRequestInfo, G as InvoResponseInfo, bN as LinkedIdentityEmail, J as LoyaltyCard, K as LoyaltyCardReward, N as LoyaltyCardStep, O as LoyaltyRewardState, Q as LoyaltyStepProgress, S as LoyaltyStepState, bO as MinPurchaseWarning, bP as PhoneChangeConfirmation, bQ as PhoneChangeRequestStatus, bR as PlatformPurchaseStatus, bS as PlayerActivityType, Z as Rail, bT as RefundInitiation, bU as RefundPendingApproval, bV as RefundProcessingFeeBasis, bW as RefundReceipt, bX as RefundRevenueShareAttribution, bY as RefundWarning, bZ as SandboxClockState, b_ as SavedCard, b$ as SteamPack, c0 as SteamUserSession, c1 as Subscription, c2 as SubscriptionBaseInput, c3 as SubscriptionConsent, c4 as SubscriptionConsentInput, c5 as SubscriptionFundingRail, c6 as SubscriptionInterval, c7 as SubscriptionRevenueShare, c8 as SubscriptionRevenueShareInput, c9 as SubscriptionStatus, ca as UnacknowledgedPurchaseOutcome, _ as VerificationMethod, cb as isRefundPendingApproval } from './types-Cjd4SAR8.js';
3
3
 
4
4
  /**
5
5
  * The package version, as sent in the server User-Agent. A test pins this to
6
6
  * `package.json` so it cannot drift silently (it did: the UA read 3.0.0 through 3.7.0).
7
7
  * Bump it with the changeset flow.
8
8
  */
9
- declare const SDK_VERSION = "3.23.0";
9
+ declare const SDK_VERSION = "3.24.1";
10
10
 
11
11
  interface VerifyWebhookOptions {
12
12
  /** Max age of the signed timestamp, in seconds. Default 300 (5 min). */
@@ -366,6 +366,25 @@ interface PlayerPhoneChangedData {
366
366
  previous_identity_id: string;
367
367
  [key: string]: unknown;
368
368
  }
369
+ /**
370
+ * `identity.passkey_reset`: a player replaced a lost INVO passkey through recovery, on
371
+ * INVO's approval or claim page or in your app through `recoveryBegin` /
372
+ * `recoveryComplete` (the in-app path sends it since backend 2026-10-12). Sent to the
373
+ * game the recovery ran in. Sending money out is paused for that player until
374
+ * `cooldown_until`; receiving and collecting still work. Tell the player, or flag the
375
+ * account, if they did not start it.
376
+ */
377
+ interface IdentityPasskeyResetData {
378
+ /** The player's opaque identity id (the same id `player.phone_changed` carries). */
379
+ identity_id: string;
380
+ /** `"hosted_device"`, `"hosted_claim"` or `"sdk"`. */
381
+ reset_via: "hosted_device" | "hosted_claim" | "sdk" | (string & {});
382
+ /** ISO timestamp: until when sending money out is paused for this player. */
383
+ cooldown_until: string | null;
384
+ /** How many passkeys were switched off. */
385
+ deactivated_count: number;
386
+ [key: string]: unknown;
387
+ }
369
388
  /**
370
389
  * The block every subscription event carries EXCEPT `subscription.renewed` and
371
390
  * `subscription.refunded`, which have their own shapes. `identity_id` is an opaque,
@@ -808,6 +827,9 @@ type InvoWebhookEvent = (WebhookBase & {
808
827
  }) | (WebhookBase & {
809
828
  event_type: "player.phone_changed";
810
829
  data: PlayerPhoneChangedData;
830
+ }) | (WebhookBase & {
831
+ event_type: "identity.passkey_reset";
832
+ data: IdentityPasskeyResetData;
811
833
  }) | (WebhookBase & {
812
834
  event_type: "webhook.test";
813
835
  data: Record<string, unknown>;
@@ -1857,4 +1879,4 @@ declare class InvoServer {
1857
1879
  private toInitiateResult;
1858
1880
  }
1859
1881
 
1860
- export { ApproveWithDeviceCodeInput, BeginDeviceApprovalInput, CallOptions, CancelResult, CancelSubscriptionOptions, CardSetupConfirmInput, CardSetupConfirmResult, CardSetupInput, CardSetupResult, CardSetupSessionInput, CardSetupSessionResult, CardsServer, ChangeAmountResult, ClaimCurrencyInput, ClaimResult, ClaimTransferInput, CompleteDeviceApprovalInput, CompleteDeviceApprovalResult, ConfirmDeviceEnrollmentInput, ConfirmDeviceEnrollmentResult, ConfirmPaymentResult, CreateCheckoutInput, CreateCheckoutResult, CreateSubscriptionInput, CurrencyPurchaseQuote, CurrencyPurchaseQuoteInput, DestinationsResult, DeviceApprovalGrant, DeviceApprovalPollResult, DeviceApprovalSettleResult, GetSubscriptionOptions, GetSubscriptionResult, GuardianApprovalStatusResult, InboundPendingQuery, InboundPendingResult, InitiateResult, InitiateSendInput, InitiateTransferInput, InvoError, InvoServer, type InvoWebhookEvent, ItemHistoryQuery, ItemHistoryResult, ItemOrderQuery, type ItemPurchasedData, LinkedIdentitiesQuery, LinkedIdentitiesResult, ListSubscriptionsOptions, LoyaltyCardsResult, MintPlayerTokenInput, OrderDetailsResult, type PayoutStatusChangedData, PhoneChangeRequest, PhoneShareApproveInput, PhoneShareApproveResult, PhoneShareContact, PhoneShareInitiateResult, PhoneShareStatusResult, type PlatformCommercePurchasedData, type PlatformCommerceRefundedData, PlatformCommerceServer, PlatformOrderStatusResult, PlatformPurchaseHistoryQuery, PlatformPurchaseHistoryResult, PlatformPurchaseInput, PlatformPurchaseResult, PlatformRefundInput, PlatformRefundResult, PlayerActivityEntry, PlayerActivityQuery, PlayerActivityResult, PlayerBalanceQuery, PlayerBalanceResult, PlayerCardsResult, type PlayerPhoneChangedData, PlayerToken, PollDeviceApprovalInput, type PurchaseCompletedData, type PurchaseEventData, PurchaseInput, PurchaseItemInput, PurchaseItemResult, PurchaseResult, RefundResult, RefundSubscriptionInput, RegisterPlayerInput, RegisterPlayerResult, RequestPhoneChangeInput, RequestPhoneChangeResult, SDK_VERSION, SandboxClockResult, SandboxFailureOutcome, SandboxForceAuthChallengeOptions, SandboxForceFailureOptions, SandboxServer, SandboxSubscriptionsServer, ServerConfig, ServerDestinationsQuery, SetPaymentMethodInput, SetPaymentMethodResult, SmsVerifyResult, SteamFinalizeInput, SteamFinalizeResult, SteamFinalizeSubscriptionResult, SteamInitPurchaseInput, SteamInitPurchaseResult, SteamInitResult, SteamPacksQuery, SteamPacksResult, SteamSubscriptionInitInput, type SubscriptionAuthenticationRequiredData, type SubscriptionCanceledData, type SubscriptionEventCommon, type SubscriptionExpiredData, SubscriptionListResult, type SubscriptionPastDueData, type SubscriptionPaymentFailedData, type SubscriptionRefundApprovedData, type SubscriptionRefundDetail, type SubscriptionRefundRejectedData, type SubscriptionRefundRequestData, type SubscriptionRefundedData, type SubscriptionRenewalFunding, type SubscriptionRenewalSplit, type SubscriptionRenewedData, SubscriptionResult, type SubscriptionRevenueShareAttribution, type SubscriptionTrialEventFields, SubscriptionsServer, TransactionStatusResult, type TransferEventData, UpdatePlayerPhoneInput, UpdatePlayerPhoneResult, type VerifyWebhookOptions, type WebhookHandlerOptions, createWebhookHandler, verifyWebhook, verifyWebhookAsync };
1882
+ export { ApproveWithDeviceCodeInput, BeginDeviceApprovalInput, CallOptions, CancelResult, CancelSubscriptionOptions, CardSetupConfirmInput, CardSetupConfirmResult, CardSetupInput, CardSetupResult, CardSetupSessionInput, CardSetupSessionResult, CardsServer, ChangeAmountResult, ClaimCurrencyInput, ClaimResult, ClaimTransferInput, CompleteDeviceApprovalInput, CompleteDeviceApprovalResult, ConfirmDeviceEnrollmentInput, ConfirmDeviceEnrollmentResult, ConfirmPaymentResult, CreateCheckoutInput, CreateCheckoutResult, CreateSubscriptionInput, CurrencyPurchaseQuote, CurrencyPurchaseQuoteInput, DestinationsResult, DeviceApprovalGrant, DeviceApprovalPollResult, DeviceApprovalSettleResult, GetSubscriptionOptions, GetSubscriptionResult, GuardianApprovalStatusResult, type IdentityPasskeyResetData, InboundPendingQuery, InboundPendingResult, InitiateResult, InitiateSendInput, InitiateTransferInput, InvoError, InvoServer, type InvoWebhookEvent, ItemHistoryQuery, ItemHistoryResult, ItemOrderQuery, type ItemPurchasedData, LinkedIdentitiesQuery, LinkedIdentitiesResult, ListSubscriptionsOptions, LoyaltyCardsResult, MintPlayerTokenInput, OrderDetailsResult, type PayoutStatusChangedData, PhoneChangeRequest, PhoneShareApproveInput, PhoneShareApproveResult, PhoneShareContact, PhoneShareInitiateResult, PhoneShareStatusResult, type PlatformCommercePurchasedData, type PlatformCommerceRefundedData, PlatformCommerceServer, PlatformOrderStatusResult, PlatformPurchaseHistoryQuery, PlatformPurchaseHistoryResult, PlatformPurchaseInput, PlatformPurchaseResult, PlatformRefundInput, PlatformRefundResult, PlayerActivityEntry, PlayerActivityQuery, PlayerActivityResult, PlayerBalanceQuery, PlayerBalanceResult, PlayerCardsResult, type PlayerPhoneChangedData, PlayerToken, PollDeviceApprovalInput, type PurchaseCompletedData, type PurchaseEventData, PurchaseInput, PurchaseItemInput, PurchaseItemResult, PurchaseResult, RefundResult, RefundSubscriptionInput, RegisterPlayerInput, RegisterPlayerResult, RequestPhoneChangeInput, RequestPhoneChangeResult, SDK_VERSION, SandboxClockResult, SandboxFailureOutcome, SandboxForceAuthChallengeOptions, SandboxForceFailureOptions, SandboxServer, SandboxSubscriptionsServer, ServerConfig, ServerDestinationsQuery, SetPaymentMethodInput, SetPaymentMethodResult, SmsVerifyResult, SteamFinalizeInput, SteamFinalizeResult, SteamFinalizeSubscriptionResult, SteamInitPurchaseInput, SteamInitPurchaseResult, SteamInitResult, SteamPacksQuery, SteamPacksResult, SteamSubscriptionInitInput, type SubscriptionAuthenticationRequiredData, type SubscriptionCanceledData, type SubscriptionEventCommon, type SubscriptionExpiredData, SubscriptionListResult, type SubscriptionPastDueData, type SubscriptionPaymentFailedData, type SubscriptionRefundApprovedData, type SubscriptionRefundDetail, type SubscriptionRefundRejectedData, type SubscriptionRefundRequestData, type SubscriptionRefundedData, type SubscriptionRenewalFunding, type SubscriptionRenewalSplit, type SubscriptionRenewedData, SubscriptionResult, type SubscriptionRevenueShareAttribution, type SubscriptionTrialEventFields, SubscriptionsServer, TransactionStatusResult, type TransferEventData, UpdatePlayerPhoneInput, UpdatePlayerPhoneResult, type VerifyWebhookOptions, type WebhookHandlerOptions, createWebhookHandler, verifyWebhook, verifyWebhookAsync };
package/dist/server.js CHANGED
@@ -1,9 +1,9 @@
1
- import { InvoError, assertSecureBaseUrl, Http, toRequestPhoneChangeResult, toPhoneChangeRequest, receiptFields, creditFields, toLoyaltyCardsResult, toDestinationsResult } from './chunk-BOD4WOWO.js';
2
- export { InvoError } from './chunk-BOD4WOWO.js';
1
+ import { InvoError, assertSecureBaseUrl, Http, toRequestPhoneChangeResult, toPhoneChangeRequest, receiptFields, creditFields, toLoyaltyCardsResult, toDestinationsResult } from './chunk-7BYAUHTA.js';
2
+ export { InvoError } from './chunk-7BYAUHTA.js';
3
3
  import { createHmac, timingSafeEqual } from 'crypto';
4
4
 
5
5
  // src/version.ts
6
- var SDK_VERSION = "3.23.0";
6
+ var SDK_VERSION = "3.24.1";
7
7
 
8
8
  // src/shared/types.ts
9
9
  function isRefundPendingApproval(r) {
@@ -425,6 +425,10 @@ function toPlayerActivityEntry(raw) {
425
425
  createdAt: strOrNull(raw["created_at"]),
426
426
  completedAt: strOrNull(raw["completed_at"]),
427
427
  orderId: strOrNull(raw["order_id"]),
428
+ // Additive fee fields (backend 2026-10-12): set only when INVO sent the key.
429
+ ..."fee_amount" in raw ? { feeAmount: strOrNull(raw["fee_amount"]) } : {},
430
+ ..."net_amount" in raw ? { netAmount: strOrNull(raw["net_amount"]) } : {},
431
+ ..."gross_amount" in raw ? { grossAmount: strOrNull(raw["gross_amount"]) } : {},
428
432
  raw
429
433
  };
430
434
  }
@@ -189,9 +189,16 @@ declare class InvoError extends Error {
189
189
  * (spend game currency) or `createCheckout`/`purchaseCurrency` (buy currency) instead.
190
190
  */
191
191
  get isNotPlatformTenant(): boolean;
192
- /** True if a Platform Commerce purchase, or a `purchaseItem` spend, was too small for the
193
- * fee to round above zero (`AMOUNT_BELOW_MINIMUM`, 400) — raise the amount. `purchaseItem`
194
- * rounds `totalPrice` to cents before this check. */
192
+ /**
193
+ * True on `AMOUNT_BELOW_MINIMUM` (400), which three calls answer:
194
+ * - a Platform Commerce purchase, or a `purchaseItem` spend, too small for the fee to
195
+ * round above zero: raise the amount (`purchaseItem` rounds `totalPrice` to cents
196
+ * before this check);
197
+ * - initiate-send / initiate-transfer below the sending title's minimum (backend
198
+ * 2026-10-12): the limit is on {@link minimumAmount}, in the title's own currency
199
+ * ({@link limitCurrencyName}). On the wallet transfer route {@link code} stays
200
+ * `INVALID_AMOUNT`; this predicate reads `error_code` too.
201
+ */
195
202
  get isAmountBelowMinimum(): boolean;
196
203
  /**
197
204
  * True if the `rail` you sent disagrees with the storefront key you
@@ -730,11 +737,26 @@ declare class InvoError extends Error {
730
737
  */
731
738
  get isDeviceSignalRejected(): boolean;
732
739
  /**
733
- * True when `registerPlayer` found the player already in your game with a DIFFERENT
734
- * phone (`PHONE_MISMATCH`, 409). Nothing changed; use `updatePlayerPhone` to change it.
740
+ * True when the phone you supplied is not the one on file for that player
741
+ * (`PHONE_MISMATCH`). Two places answer it:
742
+ * - `registerPlayer` (409): the player is already in your game with a different
743
+ * phone. Nothing changed; use `updatePlayerPhone` to change it.
744
+ * - initiate-send / initiate-transfer (400, since backend 2026-10-12): the sender
745
+ * phone does not match. Change the number first with `requestPhoneChange`.
735
746
  * (`mintPlayerToken` reports the same situation as `phoneMismatch: true` on success.)
736
747
  */
737
748
  get isPhoneMismatch(): boolean;
749
+ /**
750
+ * True when a send or transfer amount is above the sending title's maximum or the
751
+ * network ceiling for one move (`AMOUNT_ABOVE_MAXIMUM`, 400). See {@link maximumAmount}.
752
+ */
753
+ get isAmountAboveMaximum(): boolean;
754
+ /** The minimum amount (decimal string) on an `AMOUNT_BELOW_MINIMUM` refusal. */
755
+ get minimumAmount(): string | undefined;
756
+ /** The maximum amount (decimal string) on an `AMOUNT_ABOVE_MAXIMUM` refusal. */
757
+ get maximumAmount(): string | undefined;
758
+ /** The sending title's currency name on an amount-limit refusal, when it has one. */
759
+ get limitCurrencyName(): string | undefined;
738
760
  /**
739
761
  * True when the phone you supplied belongs to another email
740
762
  * (`PHONE_SHARE_APPROVAL_REQUIRED`, 409) on `mintPlayerToken`, `registerPlayer` or
@@ -1600,6 +1622,21 @@ interface PlayerActivityEntry {
1600
1622
  createdAt: string | null;
1601
1623
  completedAt: string | null;
1602
1624
  orderId: string | null;
1625
+ /**
1626
+ * Sends and transfers only (absent on purchases). The sender pays the whole fee out of
1627
+ * the amount sent; the recipient pays nothing. On the sender's entry (`"out"` /
1628
+ * `"self"`) `amount` is the gross sent and `feeAmount` / `netAmount` (what the
1629
+ * recipient gets) are set. On the recipient's entry (`"in"`) `amount` is what arrived
1630
+ * and `grossAmount` / `feeAmount` are set. While a send waits to be collected these
1631
+ * show the fee that will apply; `null` when it ended without being collected. On the
1632
+ * recipient's entry for a send or transfer from another game, `grossAmount` and
1633
+ * `feeAmount` are in the recipient's currency, so `grossAmount - feeAmount === amount`.
1634
+ */
1635
+ feeAmount?: string | null;
1636
+ /** Sender side: what the recipient receives (gross minus fee). See {@link feeAmount}. */
1637
+ netAmount?: string | null;
1638
+ /** Recipient side: what the sender sent before the fee. See {@link feeAmount}. */
1639
+ grossAmount?: string | null;
1603
1640
  raw: Record<string, unknown>;
1604
1641
  }
1605
1642
  /** One page of `getPlayerActivity`. */
@@ -189,9 +189,16 @@ declare class InvoError extends Error {
189
189
  * (spend game currency) or `createCheckout`/`purchaseCurrency` (buy currency) instead.
190
190
  */
191
191
  get isNotPlatformTenant(): boolean;
192
- /** True if a Platform Commerce purchase, or a `purchaseItem` spend, was too small for the
193
- * fee to round above zero (`AMOUNT_BELOW_MINIMUM`, 400) — raise the amount. `purchaseItem`
194
- * rounds `totalPrice` to cents before this check. */
192
+ /**
193
+ * True on `AMOUNT_BELOW_MINIMUM` (400), which three calls answer:
194
+ * - a Platform Commerce purchase, or a `purchaseItem` spend, too small for the fee to
195
+ * round above zero: raise the amount (`purchaseItem` rounds `totalPrice` to cents
196
+ * before this check);
197
+ * - initiate-send / initiate-transfer below the sending title's minimum (backend
198
+ * 2026-10-12): the limit is on {@link minimumAmount}, in the title's own currency
199
+ * ({@link limitCurrencyName}). On the wallet transfer route {@link code} stays
200
+ * `INVALID_AMOUNT`; this predicate reads `error_code` too.
201
+ */
195
202
  get isAmountBelowMinimum(): boolean;
196
203
  /**
197
204
  * True if the `rail` you sent disagrees with the storefront key you
@@ -730,11 +737,26 @@ declare class InvoError extends Error {
730
737
  */
731
738
  get isDeviceSignalRejected(): boolean;
732
739
  /**
733
- * True when `registerPlayer` found the player already in your game with a DIFFERENT
734
- * phone (`PHONE_MISMATCH`, 409). Nothing changed; use `updatePlayerPhone` to change it.
740
+ * True when the phone you supplied is not the one on file for that player
741
+ * (`PHONE_MISMATCH`). Two places answer it:
742
+ * - `registerPlayer` (409): the player is already in your game with a different
743
+ * phone. Nothing changed; use `updatePlayerPhone` to change it.
744
+ * - initiate-send / initiate-transfer (400, since backend 2026-10-12): the sender
745
+ * phone does not match. Change the number first with `requestPhoneChange`.
735
746
  * (`mintPlayerToken` reports the same situation as `phoneMismatch: true` on success.)
736
747
  */
737
748
  get isPhoneMismatch(): boolean;
749
+ /**
750
+ * True when a send or transfer amount is above the sending title's maximum or the
751
+ * network ceiling for one move (`AMOUNT_ABOVE_MAXIMUM`, 400). See {@link maximumAmount}.
752
+ */
753
+ get isAmountAboveMaximum(): boolean;
754
+ /** The minimum amount (decimal string) on an `AMOUNT_BELOW_MINIMUM` refusal. */
755
+ get minimumAmount(): string | undefined;
756
+ /** The maximum amount (decimal string) on an `AMOUNT_ABOVE_MAXIMUM` refusal. */
757
+ get maximumAmount(): string | undefined;
758
+ /** The sending title's currency name on an amount-limit refusal, when it has one. */
759
+ get limitCurrencyName(): string | undefined;
738
760
  /**
739
761
  * True when the phone you supplied belongs to another email
740
762
  * (`PHONE_SHARE_APPROVAL_REQUIRED`, 409) on `mintPlayerToken`, `registerPlayer` or
@@ -1600,6 +1622,21 @@ interface PlayerActivityEntry {
1600
1622
  createdAt: string | null;
1601
1623
  completedAt: string | null;
1602
1624
  orderId: string | null;
1625
+ /**
1626
+ * Sends and transfers only (absent on purchases). The sender pays the whole fee out of
1627
+ * the amount sent; the recipient pays nothing. On the sender's entry (`"out"` /
1628
+ * `"self"`) `amount` is the gross sent and `feeAmount` / `netAmount` (what the
1629
+ * recipient gets) are set. On the recipient's entry (`"in"`) `amount` is what arrived
1630
+ * and `grossAmount` / `feeAmount` are set. While a send waits to be collected these
1631
+ * show the fee that will apply; `null` when it ended without being collected. On the
1632
+ * recipient's entry for a send or transfer from another game, `grossAmount` and
1633
+ * `feeAmount` are in the recipient's currency, so `grossAmount - feeAmount === amount`.
1634
+ */
1635
+ feeAmount?: string | null;
1636
+ /** Sender side: what the recipient receives (gross minus fee). See {@link feeAmount}. */
1637
+ netAmount?: string | null;
1638
+ /** Recipient side: what the sender sent before the fee. See {@link feeAmount}. */
1639
+ grossAmount?: string | null;
1603
1640
  raw: Record<string, unknown>;
1604
1641
  }
1605
1642
  /** One page of `getPlayerActivity`. */