@invonetwork/web-sdk 3.36.0 → 3.37.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.
package/dist/game.cjs CHANGED
@@ -84,7 +84,11 @@ var InvoError = class _InvoError extends Error {
84
84
  * - registration/token-mint (phone already on another INVO account), and
85
85
  * - **claim + confirm-receipt** (`claimTransfer`/`claimCurrency`,
86
86
  * `confirmReceiptSend`/`confirmReceiptTransfer`) — the receiver phone is contested,
87
- * so INVO holds the money and texts the phone owner to approve.
87
+ * so INVO holds the money and asks the phone owner to approve.
88
+ *
89
+ * Either way the 409 has already created an approval request and contacted the phone's
90
+ * existing owner: by email when INVO has verified their address, otherwise by a text code
91
+ * (the body's `consent_channel` says which).
88
92
  *
89
93
  * NOT a failure. Show `err.message` verbatim (the backend supplies the user-facing text;
90
94
  * `phoneShareLast4` tells the UI which phone), keep the funds pending, and **retry the same
@@ -101,7 +105,8 @@ var InvoError = class _InvoError extends Error {
101
105
  const v = this.bodyObject()["approval_id"];
102
106
  return typeof v === "string" && v ? v : void 0;
103
107
  }
104
- /** Last 4 digits of the phone that must approve (`phone_last4`), for the UI message. */
108
+ /** Last 4 digits of the phone that must approve (`phone_last4`, a string such as `"4567"`),
109
+ * for the UI message. `undefined` when the body has none (an older server). */
105
110
  get phoneShareLast4() {
106
111
  const v = this.bodyObject()["phone_last4"];
107
112
  return typeof v === "string" && v ? v : void 0;
@@ -337,6 +342,27 @@ var InvoError = class _InvoError extends Error {
337
342
  get isPartnerRailSuspended() {
338
343
  return this.code === "PARTNER_RAIL_SUSPENDED";
339
344
  }
345
+ /** A payout or withdrawal was refused because the billing account owes INVO more for
346
+ * Steam or Apple coins than this payout can settle (`FLOAT_DEBT_OUTSTANDING`, 409;
347
+ * additive, 3.37.0). Nothing was created. {@link floatDebtUsd} is what is owed; the
348
+ * message is safe to show the account owner. Ask for a larger amount, or retry once the
349
+ * card on file has been charged. */
350
+ get isFloatDebtOutstanding() {
351
+ return this.code === "FLOAT_DEBT_OUTSTANDING";
352
+ }
353
+ /** On `FLOAT_DEBT_OUTSTANDING`: what the billing account owes (`float_debt_usd`), USD
354
+ * decimal string, for example `"95.00"`. `undefined` when the body does not carry it. */
355
+ get floatDebtUsd() {
356
+ const v = this.bodyObject()["float_debt_usd"];
357
+ if (typeof v === "number" && Number.isFinite(v)) return v.toFixed(2);
358
+ return typeof v === "string" && v ? v : void 0;
359
+ }
360
+ /** The billing account could not be checked, so the payout or withdrawal was not created
361
+ * (`FLOAT_CHECK_UNAVAILABLE`, 503, `retryable: true`; additive, 3.37.0). Nothing was
362
+ * changed. Retry with the same idempotency key. */
363
+ get isFloatCheckUnavailable() {
364
+ return this.code === "FLOAT_CHECK_UNAVAILABLE";
365
+ }
340
366
  /** True when INVO has paused new payments on the developer account
341
367
  * (`PAYMENTS_PAUSED`, 403; additive, 3.32.0). Every call that starts a payment returns it:
342
368
  * coin purchase, checkout session, Platform Commerce card purchase, new
@@ -1053,7 +1079,10 @@ var InvoError = class _InvoError extends Error {
1053
1079
  /**
1054
1080
  * True when the phone you supplied belongs to another email
1055
1081
  * (`PHONE_SHARE_APPROVAL_REQUIRED`, 409) on `mintPlayerToken`, `registerPlayer` or
1056
- * `updatePlayerPhone`. Nothing was created or changed. The same condition as
1082
+ * `updatePlayerPhone`. The phone may be held by a player in any game or by an INVO wallet
1083
+ * (including one created in the INVO app). No player was created or changed, but INVO has
1084
+ * created an approval request and asked the phone's owner to approve; retry the same call
1085
+ * once they have and it succeeds. The same condition as
1057
1086
  * {@link isPhoneShareApprovalRequired}, named for these registration calls.
1058
1087
  */
1059
1088
  get isPhoneShareRefused() {
@@ -4996,7 +5025,7 @@ function mountInvoUI(container, economy, options = {}) {
4996
5025
  }
4997
5026
 
4998
5027
  // src/version.ts
4999
- var SDK_VERSION = "3.36.0";
5028
+ var SDK_VERSION = "3.37.1";
5000
5029
 
5001
5030
  exports.InvoGameEconomy = InvoGameEconomy;
5002
5031
  exports.InvoGameError = InvoGameError;
package/dist/game.d.cts CHANGED
@@ -1,8 +1,8 @@
1
1
  import { i as GamePlayer, q as GameWallet, c as GameCatalog, k as GamePurchase, h as GameItemPurchase, n as GameTransferKind, d as GameCatalogItem, f as GameCurrencyBalance, p as GameTransferStatus, m as GameTransferInput, o as GameTransferStart } from './types-jUxfYjiD.cjs';
2
2
  export { e as GameCheckout, G as GameCurrencyKind, b as GameEconomyConfig, g as GameErrorBody, j as GamePremiumPack, a as GamePurchaseStatus, l as GameSession } from './types-jUxfYjiD.cjs';
3
- import { A as ApproveHostedResult } from './hosted-approval-BKI9oHwf.cjs';
4
- import { D as DestinationGame, P as PendingCollectItem } from './types-BcdXf2S5.cjs';
5
- export { S as SDK_VERSION } from './version-QIFHOifq.cjs';
3
+ import { A as ApproveHostedResult } from './hosted-approval-CxWyQOfU.cjs';
4
+ import { D as DestinationGame, P as PendingCollectItem } from './types-IRNjMV47.cjs';
5
+ export { S as SDK_VERSION } from './version-BIHJFKuj.cjs';
6
6
 
7
7
  /**
8
8
  * INVO game economy client (3.27.0), the browser half. It talks ONLY to your game server
package/dist/game.d.ts CHANGED
@@ -1,8 +1,8 @@
1
1
  import { i as GamePlayer, q as GameWallet, c as GameCatalog, k as GamePurchase, h as GameItemPurchase, n as GameTransferKind, d as GameCatalogItem, f as GameCurrencyBalance, p as GameTransferStatus, m as GameTransferInput, o as GameTransferStart } from './types-jUxfYjiD.js';
2
2
  export { e as GameCheckout, G as GameCurrencyKind, b as GameEconomyConfig, g as GameErrorBody, j as GamePremiumPack, a as GamePurchaseStatus, l as GameSession } from './types-jUxfYjiD.js';
3
- import { A as ApproveHostedResult } from './hosted-approval-fgVkugRU.js';
4
- import { D as DestinationGame, P as PendingCollectItem } from './types-BcdXf2S5.js';
5
- export { S as SDK_VERSION } from './version-QIFHOifq.js';
3
+ import { A as ApproveHostedResult } from './hosted-approval-D-CGX-LO.js';
4
+ import { D as DestinationGame, P as PendingCollectItem } from './types-IRNjMV47.js';
5
+ export { S as SDK_VERSION } from './version-BIHJFKuj.js';
6
6
 
7
7
  /**
8
8
  * INVO game economy client (3.27.0), the browser half. It talks ONLY to your game server
package/dist/game.js CHANGED
@@ -1,6 +1,6 @@
1
- import { InvoClient } from './chunk-SCFK6IVH.js';
2
- export { SDK_VERSION } from './chunk-B75DBT53.js';
3
- import { newEventId } from './chunk-BGCSSWVL.js';
1
+ import { InvoClient } from './chunk-QD5G355J.js';
2
+ export { SDK_VERSION } from './chunk-OYJUX2TH.js';
3
+ import { newEventId } from './chunk-I4GDKZFL.js';
4
4
 
5
5
  // src/game/client.ts
6
6
  var InvoGameError = class extends Error {
@@ -1,4 +1,4 @@
1
- import { A as ApproveResult, j as ConfirmReceiptResult } from './types-BcdXf2S5.cjs';
1
+ import { A as ApproveResult, j as ConfirmReceiptResult } from './types-IRNjMV47.cjs';
2
2
 
3
3
  /** The four device-approval flows (`begin.flow`). */
4
4
  type HostedFlow = "transfer" | "send" | "send_receipt" | "transfer_receipt";
@@ -1,4 +1,4 @@
1
- import { A as ApproveResult, j as ConfirmReceiptResult } from './types-BcdXf2S5.js';
1
+ import { A as ApproveResult, j as ConfirmReceiptResult } from './types-IRNjMV47.js';
2
2
 
3
3
  /** The four device-approval flows (`begin.flow`). */
4
4
  type HostedFlow = "transfer" | "send" | "send_receipt" | "transfer_receipt";
package/dist/index.cjs CHANGED
@@ -84,7 +84,11 @@ var InvoError = class _InvoError extends Error {
84
84
  * - registration/token-mint (phone already on another INVO account), and
85
85
  * - **claim + confirm-receipt** (`claimTransfer`/`claimCurrency`,
86
86
  * `confirmReceiptSend`/`confirmReceiptTransfer`) — the receiver phone is contested,
87
- * so INVO holds the money and texts the phone owner to approve.
87
+ * so INVO holds the money and asks the phone owner to approve.
88
+ *
89
+ * Either way the 409 has already created an approval request and contacted the phone's
90
+ * existing owner: by email when INVO has verified their address, otherwise by a text code
91
+ * (the body's `consent_channel` says which).
88
92
  *
89
93
  * NOT a failure. Show `err.message` verbatim (the backend supplies the user-facing text;
90
94
  * `phoneShareLast4` tells the UI which phone), keep the funds pending, and **retry the same
@@ -101,7 +105,8 @@ var InvoError = class _InvoError extends Error {
101
105
  const v = this.bodyObject()["approval_id"];
102
106
  return typeof v === "string" && v ? v : void 0;
103
107
  }
104
- /** Last 4 digits of the phone that must approve (`phone_last4`), for the UI message. */
108
+ /** Last 4 digits of the phone that must approve (`phone_last4`, a string such as `"4567"`),
109
+ * for the UI message. `undefined` when the body has none (an older server). */
105
110
  get phoneShareLast4() {
106
111
  const v = this.bodyObject()["phone_last4"];
107
112
  return typeof v === "string" && v ? v : void 0;
@@ -337,6 +342,27 @@ var InvoError = class _InvoError extends Error {
337
342
  get isPartnerRailSuspended() {
338
343
  return this.code === "PARTNER_RAIL_SUSPENDED";
339
344
  }
345
+ /** A payout or withdrawal was refused because the billing account owes INVO more for
346
+ * Steam or Apple coins than this payout can settle (`FLOAT_DEBT_OUTSTANDING`, 409;
347
+ * additive, 3.37.0). Nothing was created. {@link floatDebtUsd} is what is owed; the
348
+ * message is safe to show the account owner. Ask for a larger amount, or retry once the
349
+ * card on file has been charged. */
350
+ get isFloatDebtOutstanding() {
351
+ return this.code === "FLOAT_DEBT_OUTSTANDING";
352
+ }
353
+ /** On `FLOAT_DEBT_OUTSTANDING`: what the billing account owes (`float_debt_usd`), USD
354
+ * decimal string, for example `"95.00"`. `undefined` when the body does not carry it. */
355
+ get floatDebtUsd() {
356
+ const v = this.bodyObject()["float_debt_usd"];
357
+ if (typeof v === "number" && Number.isFinite(v)) return v.toFixed(2);
358
+ return typeof v === "string" && v ? v : void 0;
359
+ }
360
+ /** The billing account could not be checked, so the payout or withdrawal was not created
361
+ * (`FLOAT_CHECK_UNAVAILABLE`, 503, `retryable: true`; additive, 3.37.0). Nothing was
362
+ * changed. Retry with the same idempotency key. */
363
+ get isFloatCheckUnavailable() {
364
+ return this.code === "FLOAT_CHECK_UNAVAILABLE";
365
+ }
340
366
  /** True when INVO has paused new payments on the developer account
341
367
  * (`PAYMENTS_PAUSED`, 403; additive, 3.32.0). Every call that starts a payment returns it:
342
368
  * coin purchase, checkout session, Platform Commerce card purchase, new
@@ -1053,7 +1079,10 @@ var InvoError = class _InvoError extends Error {
1053
1079
  /**
1054
1080
  * True when the phone you supplied belongs to another email
1055
1081
  * (`PHONE_SHARE_APPROVAL_REQUIRED`, 409) on `mintPlayerToken`, `registerPlayer` or
1056
- * `updatePlayerPhone`. Nothing was created or changed. The same condition as
1082
+ * `updatePlayerPhone`. The phone may be held by a player in any game or by an INVO wallet
1083
+ * (including one created in the INVO app). No player was created or changed, but INVO has
1084
+ * created an approval request and asked the phone's owner to approve; retry the same call
1085
+ * once they have and it succeeds. The same condition as
1057
1086
  * {@link isPhoneShareApprovalRequired}, named for these registration calls.
1058
1087
  */
1059
1088
  get isPhoneShareRefused() {
package/dist/index.d.cts CHANGED
@@ -1,7 +1,7 @@
1
- import { a as PurchaseStatusResult, b as PurchaseCredited, c as PurchaseExpired, d as PurchaseRefunded, e as PurchaseRefused, C as CheckoutClientConfig, H as Http, f as PurchaseStatusInput, g as CallOptions, W as WaitForPurchaseInput, M as MountCheckoutOptions, h as CheckoutMountHandle, i as ClientConfig, A as ApproveResult, j as ConfirmReceiptResult, k as PhoneChangeApprovalsResult, l as ApprovePhoneChangeInput, m as ApprovePhoneChangeResult, L as LinkDeviceResult, n as PendingCollectResult, o as DestinationsQuery, p as DestinationsResult, B as BalanceResult, q as LoyaltyCardsResult, r as LoyaltyVaultResult, R as RedeemRewardResult, s as RewardsPageLink, E as EnrollmentBeginResult, t as EnrollmentVerifyResult, u as RecoveryBeginResult, v as RecoveryCompleteResult } from './types-BcdXf2S5.cjs';
2
- export { w as BalanceRow, x as CheckoutPurchaseStatus, y as ClaimDelivery, D as DestinationGame, I as InvoError, z as InvoErrorInfo, F as InvoHooks, G as InvoRequestInfo, J as InvoResponseInfo, K as LoyaltyCard, N as LoyaltyCardReward, O as LoyaltyCardStep, Q as LoyaltyRewardState, S as LoyaltyStepProgress, T as LoyaltyStepState, U as LoyaltyVaultEntry, P as PendingCollectItem, V as PhoneChangeApproval, X as PhoneChangeDeviceSignal, Y as PurchaseRefusalReason, Z as Rail, _ as VerificationMethod } from './types-BcdXf2S5.cjs';
3
- import { a as ApproveHostedOptions, A as ApproveHostedResult } from './hosted-approval-BKI9oHwf.cjs';
4
- export { E as EnrollmentDecision, b as EnrollmentRespond, H as HostedApprovalStatus, c as HostedEnrollment, d as HostedEnrollmentInput, e as HostedFlow } from './hosted-approval-BKI9oHwf.cjs';
1
+ import { a as PurchaseStatusResult, b as PurchaseCredited, c as PurchaseExpired, d as PurchaseRefunded, e as PurchaseRefused, C as CheckoutClientConfig, H as Http, f as PurchaseStatusInput, g as CallOptions, W as WaitForPurchaseInput, M as MountCheckoutOptions, h as CheckoutMountHandle, i as ClientConfig, A as ApproveResult, j as ConfirmReceiptResult, k as PhoneChangeApprovalsResult, l as ApprovePhoneChangeInput, m as ApprovePhoneChangeResult, L as LinkDeviceResult, n as PendingCollectResult, o as DestinationsQuery, p as DestinationsResult, B as BalanceResult, q as LoyaltyCardsResult, r as LoyaltyVaultResult, R as RedeemRewardResult, s as RewardsPageLink, E as EnrollmentBeginResult, t as EnrollmentVerifyResult, u as RecoveryBeginResult, v as RecoveryCompleteResult } from './types-IRNjMV47.cjs';
2
+ export { w as BalanceRow, x as CheckoutPurchaseStatus, y as ClaimDelivery, D as DestinationGame, I as InvoError, z as InvoErrorInfo, F as InvoHooks, G as InvoRequestInfo, J as InvoResponseInfo, K as LoyaltyCard, N as LoyaltyCardReward, O as LoyaltyCardStep, Q as LoyaltyRewardState, S as LoyaltyStepProgress, T as LoyaltyStepState, U as LoyaltyVaultEntry, P as PendingCollectItem, V as PhoneChangeApproval, X as PhoneChangeDeviceSignal, Y as PurchaseRefusalReason, Z as Rail, _ as VerificationMethod } from './types-IRNjMV47.cjs';
3
+ import { a as ApproveHostedOptions, A as ApproveHostedResult } from './hosted-approval-CxWyQOfU.cjs';
4
+ export { E as EnrollmentDecision, b as EnrollmentRespond, H as HostedApprovalStatus, c as HostedEnrollment, d as HostedEnrollmentInput, e as HostedFlow } from './hosted-approval-CxWyQOfU.cjs';
5
5
  import { R as ReportGameEventInput, a as ReportGameEventResult } from './loyalty-events-CmDw2ZoR.cjs';
6
6
  export { G as GameEventType } from './loyalty-events-CmDw2ZoR.cjs';
7
7
 
package/dist/index.d.ts CHANGED
@@ -1,7 +1,7 @@
1
- import { a as PurchaseStatusResult, b as PurchaseCredited, c as PurchaseExpired, d as PurchaseRefunded, e as PurchaseRefused, C as CheckoutClientConfig, H as Http, f as PurchaseStatusInput, g as CallOptions, W as WaitForPurchaseInput, M as MountCheckoutOptions, h as CheckoutMountHandle, i as ClientConfig, A as ApproveResult, j as ConfirmReceiptResult, k as PhoneChangeApprovalsResult, l as ApprovePhoneChangeInput, m as ApprovePhoneChangeResult, L as LinkDeviceResult, n as PendingCollectResult, o as DestinationsQuery, p as DestinationsResult, B as BalanceResult, q as LoyaltyCardsResult, r as LoyaltyVaultResult, R as RedeemRewardResult, s as RewardsPageLink, E as EnrollmentBeginResult, t as EnrollmentVerifyResult, u as RecoveryBeginResult, v as RecoveryCompleteResult } from './types-BcdXf2S5.js';
2
- export { w as BalanceRow, x as CheckoutPurchaseStatus, y as ClaimDelivery, D as DestinationGame, I as InvoError, z as InvoErrorInfo, F as InvoHooks, G as InvoRequestInfo, J as InvoResponseInfo, K as LoyaltyCard, N as LoyaltyCardReward, O as LoyaltyCardStep, Q as LoyaltyRewardState, S as LoyaltyStepProgress, T as LoyaltyStepState, U as LoyaltyVaultEntry, P as PendingCollectItem, V as PhoneChangeApproval, X as PhoneChangeDeviceSignal, Y as PurchaseRefusalReason, Z as Rail, _ as VerificationMethod } from './types-BcdXf2S5.js';
3
- import { a as ApproveHostedOptions, A as ApproveHostedResult } from './hosted-approval-fgVkugRU.js';
4
- export { E as EnrollmentDecision, b as EnrollmentRespond, H as HostedApprovalStatus, c as HostedEnrollment, d as HostedEnrollmentInput, e as HostedFlow } from './hosted-approval-fgVkugRU.js';
1
+ import { a as PurchaseStatusResult, b as PurchaseCredited, c as PurchaseExpired, d as PurchaseRefunded, e as PurchaseRefused, C as CheckoutClientConfig, H as Http, f as PurchaseStatusInput, g as CallOptions, W as WaitForPurchaseInput, M as MountCheckoutOptions, h as CheckoutMountHandle, i as ClientConfig, A as ApproveResult, j as ConfirmReceiptResult, k as PhoneChangeApprovalsResult, l as ApprovePhoneChangeInput, m as ApprovePhoneChangeResult, L as LinkDeviceResult, n as PendingCollectResult, o as DestinationsQuery, p as DestinationsResult, B as BalanceResult, q as LoyaltyCardsResult, r as LoyaltyVaultResult, R as RedeemRewardResult, s as RewardsPageLink, E as EnrollmentBeginResult, t as EnrollmentVerifyResult, u as RecoveryBeginResult, v as RecoveryCompleteResult } from './types-IRNjMV47.js';
2
+ export { w as BalanceRow, x as CheckoutPurchaseStatus, y as ClaimDelivery, D as DestinationGame, I as InvoError, z as InvoErrorInfo, F as InvoHooks, G as InvoRequestInfo, J as InvoResponseInfo, K as LoyaltyCard, N as LoyaltyCardReward, O as LoyaltyCardStep, Q as LoyaltyRewardState, S as LoyaltyStepProgress, T as LoyaltyStepState, U as LoyaltyVaultEntry, P as PendingCollectItem, V as PhoneChangeApproval, X as PhoneChangeDeviceSignal, Y as PurchaseRefusalReason, Z as Rail, _ as VerificationMethod } from './types-IRNjMV47.js';
3
+ import { a as ApproveHostedOptions, A as ApproveHostedResult } from './hosted-approval-D-CGX-LO.js';
4
+ export { E as EnrollmentDecision, b as EnrollmentRespond, H as HostedApprovalStatus, c as HostedEnrollment, d as HostedEnrollmentInput, e as HostedFlow } from './hosted-approval-D-CGX-LO.js';
5
5
  import { R as ReportGameEventInput, a as ReportGameEventResult } from './loyalty-events-CmDw2ZoR.js';
6
6
  export { G as GameEventType } from './loyalty-events-CmDw2ZoR.js';
7
7
 
package/dist/index.js CHANGED
@@ -1,4 +1,4 @@
1
- export { CheckoutClient, InvoClient, PlatformCommerceClient } from './chunk-SCFK6IVH.js';
2
- export { InvoError, isPurchaseCredited, isPurchaseExpired, isPurchaseRefunded, isPurchaseRefused, nothingWasCharged, phoneChangeSignalMessage } from './chunk-BGCSSWVL.js';
1
+ export { CheckoutClient, InvoClient, PlatformCommerceClient } from './chunk-QD5G355J.js';
2
+ export { InvoError, isPurchaseCredited, isPurchaseExpired, isPurchaseRefunded, isPurchaseRefused, nothingWasCharged, phoneChangeSignalMessage } from './chunk-I4GDKZFL.js';
3
3
  //# sourceMappingURL=index.js.map
4
4
  //# sourceMappingURL=index.js.map
@@ -1,6 +1,6 @@
1
- import { I as InvoError, H as Http, $ as AuthHeader, g as CallOptions, a0 as ApplePurchaseResult, a1 as PlatformPurchaseInput, a2 as PlatformPurchaseResult, a3 as PlatformApprovalResult, a4 as PlatformOrderStatusResult, a5 as PlatformPurchaseHistoryQuery, a6 as PlatformPurchaseHistoryResult, a7 as PlatformRefundInput, a8 as PlatformRefundResult, a9 as CreateSubscriptionInput, aa as SubscriptionResult, ab as GetSubscriptionOptions, ac as GetSubscriptionResult, ad as ListSubscriptionsOptions, ae as SubscriptionListResult, af as CancelSubscriptionOptions, ag as CancelResult, ah as ChangeAmountResult, ai as SetPaymentMethodInput, aj as SetPaymentMethodResult, ak as RefundSubscriptionInput, al as RefundResult, am as SteamSubscriptionInitInput, an as SteamInitResult, ao as SteamFinalizeSubscriptionResult, ap as CardSetupSessionInput, aq as CardSetupSessionResult, ar as CardSetupInput, as as CardSetupResult, at as CardSetupConfirmInput, au as CardSetupConfirmResult, av as PlayerCardsResult, aw as SandboxClockResult, ax as SandboxFailureOutcome, ay as SandboxForceFailureOptions, az as SandboxForceAuthChallengeOptions, aA as ServerConfig, aB as MintPlayerTokenInput, aC as PlayerToken, aD as RegisterPlayerInput, aE as RegisterPlayerResult, aF as UpdatePlayerPhoneInput, aG as UpdatePlayerPhoneResult, aH as RequestPhoneChangeInput, aI as RequestPhoneChangeResult, aJ as PhoneChangeRequest, aK as InitiateSendInput, aL as InitiateResult, aM as InitiateTransferInput, aN as CreateCheckoutInput, aO as CreateCheckoutResult, a as PurchaseStatusResult, aP as PurchaseInput, aQ as PurchaseResult, aR as CurrencyPurchaseQuoteInput, aS as CurrencyPurchaseQuote, aT as ConfirmPaymentResult, aU as OrderDetailsResult, aV as SteamPacksQuery, aW as SteamPacksResult, aX as SteamInitPurchaseInput, aY as SteamInitPurchaseResult, aZ as SteamFinalizeInput, a_ as SteamFinalizeResult, a$ as AppleProductsResult, b0 as VerifyApplePurchaseInput, b1 as PurchaseItemInput, b2 as PurchaseItemResult, b3 as ItemHistoryQuery, b4 as ItemHistoryResult, b5 as ItemOrderQuery, b6 as PlayerActivityQuery, b7 as PlayerActivityResult, b8 as PlayerActivityEntry, b9 as PlayerBalanceQuery, ba as PlayerBalanceResult, q as LoyaltyCardsResult, bb as InboundPendingQuery, bc as InboundPendingResult, bd as LinkedIdentitiesQuery, be as LinkedIdentitiesResult, bf as SmsVerifyResult, bg as ClaimTransferInput, bh as ClaimResult, bi as ClaimCurrencyInput, bj as TransactionStatusResult, bk as GuardianApprovalStatusResult, bl as ServerDestinationsQuery, p as DestinationsResult, bm as PhoneShareContact, bn as PhoneShareInitiateResult, bo as PhoneShareApproveInput, bp as PhoneShareApproveResult, bq as PhoneShareStatusResult, br as BeginDeviceApprovalInput, bs as DeviceApprovalGrant, bt as PollDeviceApprovalInput, bu as DeviceApprovalPollResult, bv as ConfirmDeviceEnrollmentInput, bw as ConfirmDeviceEnrollmentResult, bx as ApproveWithDeviceCodeInput, by as DeviceApprovalSettleResult, bz as CompleteDeviceApprovalInput, bA as CompleteDeviceApprovalResult } from './types-BcdXf2S5.cjs';
1
+ import { I as InvoError, H as Http, $ as AuthHeader, g as CallOptions, a0 as ApplePurchaseResult, a1 as PlatformPurchaseInput, a2 as PlatformPurchaseResult, a3 as PlatformApprovalResult, a4 as PlatformOrderStatusResult, a5 as PlatformPurchaseHistoryQuery, a6 as PlatformPurchaseHistoryResult, a7 as PlatformRefundInput, a8 as PlatformRefundResult, a9 as CreateSubscriptionInput, aa as SubscriptionResult, ab as GetSubscriptionOptions, ac as GetSubscriptionResult, ad as ListSubscriptionsOptions, ae as SubscriptionListResult, af as CancelSubscriptionOptions, ag as CancelResult, ah as ChangeAmountResult, ai as SetPaymentMethodInput, aj as SetPaymentMethodResult, ak as RefundSubscriptionInput, al as RefundResult, am as SteamSubscriptionInitInput, an as SteamInitResult, ao as SteamFinalizeSubscriptionResult, ap as CardSetupSessionInput, aq as CardSetupSessionResult, ar as CardSetupInput, as as CardSetupResult, at as CardSetupConfirmInput, au as CardSetupConfirmResult, av as PlayerCardsResult, aw as SandboxClockResult, ax as SandboxFailureOutcome, ay as SandboxForceFailureOptions, az as SandboxForceAuthChallengeOptions, aA as ServerConfig, aB as MintPlayerTokenInput, aC as PlayerToken, aD as RegisterPlayerInput, aE as RegisterPlayerResult, aF as UpdatePlayerPhoneInput, aG as UpdatePlayerPhoneResult, aH as RequestPhoneChangeInput, aI as RequestPhoneChangeResult, aJ as PhoneChangeRequest, aK as InitiateSendInput, aL as InitiateResult, aM as InitiateTransferInput, aN as CreateCheckoutInput, aO as CreateCheckoutResult, a as PurchaseStatusResult, aP as PurchaseInput, aQ as PurchaseResult, aR as CurrencyPurchaseQuoteInput, aS as CurrencyPurchaseQuote, aT as ConfirmPaymentResult, aU as OrderDetailsResult, aV as SteamPacksQuery, aW as SteamPacksResult, aX as SteamInitPurchaseInput, aY as SteamInitPurchaseResult, aZ as SteamFinalizeInput, a_ as SteamFinalizeResult, a$ as AppleProductsResult, b0 as VerifyApplePurchaseInput, b1 as PurchaseItemInput, b2 as PurchaseItemResult, b3 as ItemHistoryQuery, b4 as ItemHistoryResult, b5 as ItemOrderQuery, b6 as PlayerActivityQuery, b7 as PlayerActivityResult, b8 as PlayerActivityEntry, b9 as PlayerBalanceQuery, ba as PlayerBalanceResult, q as LoyaltyCardsResult, bb as InboundPendingQuery, bc as InboundPendingResult, bd as LinkedIdentitiesQuery, be as LinkedIdentitiesResult, bf as SmsVerifyResult, bg as ClaimTransferInput, bh as ClaimResult, bi as ClaimCurrencyInput, bj as TransactionStatusResult, bk as GuardianApprovalStatusResult, bl as ServerDestinationsQuery, p as DestinationsResult, bm as PhoneShareContact, bn as PhoneShareInitiateResult, bo as PhoneShareApproveInput, bp as PhoneShareApproveResult, bq as PhoneShareStatusResult, br as BeginDeviceApprovalInput, bs as DeviceApprovalGrant, bt as PollDeviceApprovalInput, bu as DeviceApprovalPollResult, bv as ConfirmDeviceEnrollmentInput, bw as ConfirmDeviceEnrollmentResult, bx as ApproveWithDeviceCodeInput, by as DeviceApprovalSettleResult, bz as CompleteDeviceApprovalInput, bA as CompleteDeviceApprovalResult } from './types-IRNjMV47.cjs';
2
2
  import { b as ReportServerGameEventInput, a as ReportGameEventResult } from './loyalty-events-CmDw2ZoR.cjs';
3
- import './version-QIFHOifq.cjs';
3
+ import './version-BIHJFKuj.cjs';
4
4
 
5
5
  /**
6
6
  * Pick the INVO environment from the game secret alone (3.28.0).
@@ -469,6 +469,14 @@ interface PayoutStatusChangedData {
469
469
  partner_message?: string | null;
470
470
  /** Additive (3.26.0). The payout waits for the account owner's confirmation in the console. */
471
471
  owner_confirmation_required?: boolean;
472
+ /**
473
+ * Additive (3.37.0). Present only when part of the amount asked for settled what your
474
+ * billing account owes INVO for Steam or Apple coins: the amount settled.
475
+ * `requested_amount_usd` is then the cash part.
476
+ */
477
+ offset_float_usd?: string;
478
+ /** Additive (3.37.0). Present with `offset_float_usd`: the amount asked for. */
479
+ amount_before_offset_usd?: string;
472
480
  [key: string]: unknown;
473
481
  }
474
482
  /** Creator statuses (3.25.0). */
@@ -1142,6 +1150,19 @@ interface Payout {
1142
1150
  owner_confirmation_required?: boolean;
1143
1151
  owner_confirmed_at?: string | null;
1144
1152
  created_at?: string | null;
1153
+ /**
1154
+ * 3.37.0. Present only when part of the amount asked for settled what your billing account
1155
+ * owes INVO for Steam or Apple coins: the amount settled, decimal string (USD).
1156
+ * `requested_amount_usd` is then the cash part. Absent (never `"0.00"`) when nothing was
1157
+ * settled.
1158
+ */
1159
+ offset_float_usd?: string;
1160
+ /** 3.37.0. Present with `offset_float_usd`: the amount you asked for (cash part plus `offset_float_usd`). */
1161
+ amount_before_offset_usd?: string;
1162
+ /** 3.37.0. `offset_float_usd`, mapped by the SDK, only when the payout carries it. */
1163
+ offsetFloatUsd?: string;
1164
+ /** 3.37.0. `amount_before_offset_usd`, mapped by the SDK, only when the payout carries it. */
1165
+ amountBeforeOffsetUsd?: string;
1145
1166
  [key: string]: unknown;
1146
1167
  }
1147
1168
  interface RequestPayoutInput {
@@ -1790,11 +1811,16 @@ declare class InvoServer {
1790
1811
  * Create a player in your game without moving money (`POST /api/sdk/players`), so a
1791
1812
  * first-time receiver can collect in-game. Sends no message to the player.
1792
1813
  *
1793
- * Returns `status: "created"` (new) or `"exists"` (already in your game with that
1794
- * phone), with a player token when INVO can issue one. Refusals: 409
1795
- * `err.isPhoneMismatch` (already in your game with a different phone; use
1796
- * `updatePlayerPhone`), 409 `err.isPhoneShareRefused` (the phone belongs to another
1797
- * email), 400 `INVALID_INPUT` / `INVALID_PHONE`, 429 (`err.retryAfter`).
1814
+ * Returns `status: "created"` (201, new to your game) or `"exists"` (200, already in
1815
+ * your game with that phone), with a player token when INVO can issue one (the token
1816
+ * fields are omitted otherwise). "created" can mean joining an existing INVO wallet:
1817
+ * the same email and phone as a wallet the person already has, so `identityId` is the
1818
+ * same one other games see. Refusals: 409 `err.isPhoneMismatch` (already in your game
1819
+ * with a different phone; use `updatePlayerPhone`), 409 `err.isPhoneShareRefused` (the
1820
+ * phone is held under another email, by a player or an INVO wallet: INVO asks the
1821
+ * phone's owner to approve, and the same call succeeds once they have), 400
1822
+ * `INVALID_INPUT` / `INVALID_PHONE`, 429 (`err.retryAfter`), 503
1823
+ * `sdk_verification_disabled` (the SDK player routes are switched off).
1798
1824
  */
1799
1825
  registerPlayer(input: RegisterPlayerInput, opts?: CallOptions): Promise<RegisterPlayerResult>;
1800
1826
  /**
@@ -2233,17 +2259,20 @@ declare class InvoServer {
2233
2259
  *
2234
2260
  * These three endpoints are UNAUTHENTICATED (phone-owner-driven: no game secret,
2235
2261
  * no player token) — a partner backend relays the handshake. The triggering 409
2236
- * carries `approval_id, expires_at, code_sent, existing_account_hints[], next_endpoint`.
2262
+ * carries `approval_id, expires_at, code_sent, existing_account_hints[], next_endpoint`,
2263
+ * `phone_last4` and `consent_channel` (`"email"` when the owner was emailed a link,
2264
+ * so there is no code to collect; `"sms"` when a text code went out).
2237
2265
  *
2238
2266
  * `phoneShareInitiate` is the fallback OTP send (use when the 409 didn't already
2239
2267
  * dispatch a code). NOT idempotent — never auto-retried. OTP TTL ~10 min.
2240
2268
  */
2241
2269
  phoneShareInitiate(input: PhoneShareContact, opts?: CallOptions): Promise<PhoneShareInitiateResult>;
2242
2270
  /**
2243
- * Approve a phone-share with the OTP the phone owner received. On success the grant
2244
- * is stored server-side, keyed by (phone, requesting_email) and auto-consumed — the
2245
- * caller simply RE-ISSUES the identical original request. UNAUTHENTICATED. NOT
2246
- * idempotent (attempts are counted) — never auto-retried.
2271
+ * Approve a phone-share with the OTP the phone owner received. On success the approval
2272
+ * is stored server-side, keyed by (phone, requesting_email), permanently and
2273
+ * network-wide (there is no revoke) — the caller simply RE-ISSUES the identical
2274
+ * original request. UNAUTHENTICATED. NOT idempotent (attempts are counted) — never
2275
+ * auto-retried.
2247
2276
  */
2248
2277
  phoneShareApprove(input: PhoneShareApproveInput, opts?: CallOptions): Promise<PhoneShareApproveResult>;
2249
2278
  /**
@@ -1,6 +1,6 @@
1
- import { I as InvoError, H as Http, $ as AuthHeader, g as CallOptions, a0 as ApplePurchaseResult, a1 as PlatformPurchaseInput, a2 as PlatformPurchaseResult, a3 as PlatformApprovalResult, a4 as PlatformOrderStatusResult, a5 as PlatformPurchaseHistoryQuery, a6 as PlatformPurchaseHistoryResult, a7 as PlatformRefundInput, a8 as PlatformRefundResult, a9 as CreateSubscriptionInput, aa as SubscriptionResult, ab as GetSubscriptionOptions, ac as GetSubscriptionResult, ad as ListSubscriptionsOptions, ae as SubscriptionListResult, af as CancelSubscriptionOptions, ag as CancelResult, ah as ChangeAmountResult, ai as SetPaymentMethodInput, aj as SetPaymentMethodResult, ak as RefundSubscriptionInput, al as RefundResult, am as SteamSubscriptionInitInput, an as SteamInitResult, ao as SteamFinalizeSubscriptionResult, ap as CardSetupSessionInput, aq as CardSetupSessionResult, ar as CardSetupInput, as as CardSetupResult, at as CardSetupConfirmInput, au as CardSetupConfirmResult, av as PlayerCardsResult, aw as SandboxClockResult, ax as SandboxFailureOutcome, ay as SandboxForceFailureOptions, az as SandboxForceAuthChallengeOptions, aA as ServerConfig, aB as MintPlayerTokenInput, aC as PlayerToken, aD as RegisterPlayerInput, aE as RegisterPlayerResult, aF as UpdatePlayerPhoneInput, aG as UpdatePlayerPhoneResult, aH as RequestPhoneChangeInput, aI as RequestPhoneChangeResult, aJ as PhoneChangeRequest, aK as InitiateSendInput, aL as InitiateResult, aM as InitiateTransferInput, aN as CreateCheckoutInput, aO as CreateCheckoutResult, a as PurchaseStatusResult, aP as PurchaseInput, aQ as PurchaseResult, aR as CurrencyPurchaseQuoteInput, aS as CurrencyPurchaseQuote, aT as ConfirmPaymentResult, aU as OrderDetailsResult, aV as SteamPacksQuery, aW as SteamPacksResult, aX as SteamInitPurchaseInput, aY as SteamInitPurchaseResult, aZ as SteamFinalizeInput, a_ as SteamFinalizeResult, a$ as AppleProductsResult, b0 as VerifyApplePurchaseInput, b1 as PurchaseItemInput, b2 as PurchaseItemResult, b3 as ItemHistoryQuery, b4 as ItemHistoryResult, b5 as ItemOrderQuery, b6 as PlayerActivityQuery, b7 as PlayerActivityResult, b8 as PlayerActivityEntry, b9 as PlayerBalanceQuery, ba as PlayerBalanceResult, q as LoyaltyCardsResult, bb as InboundPendingQuery, bc as InboundPendingResult, bd as LinkedIdentitiesQuery, be as LinkedIdentitiesResult, bf as SmsVerifyResult, bg as ClaimTransferInput, bh as ClaimResult, bi as ClaimCurrencyInput, bj as TransactionStatusResult, bk as GuardianApprovalStatusResult, bl as ServerDestinationsQuery, p as DestinationsResult, bm as PhoneShareContact, bn as PhoneShareInitiateResult, bo as PhoneShareApproveInput, bp as PhoneShareApproveResult, bq as PhoneShareStatusResult, br as BeginDeviceApprovalInput, bs as DeviceApprovalGrant, bt as PollDeviceApprovalInput, bu as DeviceApprovalPollResult, bv as ConfirmDeviceEnrollmentInput, bw as ConfirmDeviceEnrollmentResult, bx as ApproveWithDeviceCodeInput, by as DeviceApprovalSettleResult, bz as CompleteDeviceApprovalInput, bA as CompleteDeviceApprovalResult } from './types-BcdXf2S5.js';
1
+ import { I as InvoError, H as Http, $ as AuthHeader, g as CallOptions, a0 as ApplePurchaseResult, a1 as PlatformPurchaseInput, a2 as PlatformPurchaseResult, a3 as PlatformApprovalResult, a4 as PlatformOrderStatusResult, a5 as PlatformPurchaseHistoryQuery, a6 as PlatformPurchaseHistoryResult, a7 as PlatformRefundInput, a8 as PlatformRefundResult, a9 as CreateSubscriptionInput, aa as SubscriptionResult, ab as GetSubscriptionOptions, ac as GetSubscriptionResult, ad as ListSubscriptionsOptions, ae as SubscriptionListResult, af as CancelSubscriptionOptions, ag as CancelResult, ah as ChangeAmountResult, ai as SetPaymentMethodInput, aj as SetPaymentMethodResult, ak as RefundSubscriptionInput, al as RefundResult, am as SteamSubscriptionInitInput, an as SteamInitResult, ao as SteamFinalizeSubscriptionResult, ap as CardSetupSessionInput, aq as CardSetupSessionResult, ar as CardSetupInput, as as CardSetupResult, at as CardSetupConfirmInput, au as CardSetupConfirmResult, av as PlayerCardsResult, aw as SandboxClockResult, ax as SandboxFailureOutcome, ay as SandboxForceFailureOptions, az as SandboxForceAuthChallengeOptions, aA as ServerConfig, aB as MintPlayerTokenInput, aC as PlayerToken, aD as RegisterPlayerInput, aE as RegisterPlayerResult, aF as UpdatePlayerPhoneInput, aG as UpdatePlayerPhoneResult, aH as RequestPhoneChangeInput, aI as RequestPhoneChangeResult, aJ as PhoneChangeRequest, aK as InitiateSendInput, aL as InitiateResult, aM as InitiateTransferInput, aN as CreateCheckoutInput, aO as CreateCheckoutResult, a as PurchaseStatusResult, aP as PurchaseInput, aQ as PurchaseResult, aR as CurrencyPurchaseQuoteInput, aS as CurrencyPurchaseQuote, aT as ConfirmPaymentResult, aU as OrderDetailsResult, aV as SteamPacksQuery, aW as SteamPacksResult, aX as SteamInitPurchaseInput, aY as SteamInitPurchaseResult, aZ as SteamFinalizeInput, a_ as SteamFinalizeResult, a$ as AppleProductsResult, b0 as VerifyApplePurchaseInput, b1 as PurchaseItemInput, b2 as PurchaseItemResult, b3 as ItemHistoryQuery, b4 as ItemHistoryResult, b5 as ItemOrderQuery, b6 as PlayerActivityQuery, b7 as PlayerActivityResult, b8 as PlayerActivityEntry, b9 as PlayerBalanceQuery, ba as PlayerBalanceResult, q as LoyaltyCardsResult, bb as InboundPendingQuery, bc as InboundPendingResult, bd as LinkedIdentitiesQuery, be as LinkedIdentitiesResult, bf as SmsVerifyResult, bg as ClaimTransferInput, bh as ClaimResult, bi as ClaimCurrencyInput, bj as TransactionStatusResult, bk as GuardianApprovalStatusResult, bl as ServerDestinationsQuery, p as DestinationsResult, bm as PhoneShareContact, bn as PhoneShareInitiateResult, bo as PhoneShareApproveInput, bp as PhoneShareApproveResult, bq as PhoneShareStatusResult, br as BeginDeviceApprovalInput, bs as DeviceApprovalGrant, bt as PollDeviceApprovalInput, bu as DeviceApprovalPollResult, bv as ConfirmDeviceEnrollmentInput, bw as ConfirmDeviceEnrollmentResult, bx as ApproveWithDeviceCodeInput, by as DeviceApprovalSettleResult, bz as CompleteDeviceApprovalInput, bA as CompleteDeviceApprovalResult } from './types-IRNjMV47.js';
2
2
  import { b as ReportServerGameEventInput, a as ReportGameEventResult } from './loyalty-events-CmDw2ZoR.js';
3
- import './version-QIFHOifq.js';
3
+ import './version-BIHJFKuj.js';
4
4
 
5
5
  /**
6
6
  * Pick the INVO environment from the game secret alone (3.28.0).
@@ -469,6 +469,14 @@ interface PayoutStatusChangedData {
469
469
  partner_message?: string | null;
470
470
  /** Additive (3.26.0). The payout waits for the account owner's confirmation in the console. */
471
471
  owner_confirmation_required?: boolean;
472
+ /**
473
+ * Additive (3.37.0). Present only when part of the amount asked for settled what your
474
+ * billing account owes INVO for Steam or Apple coins: the amount settled.
475
+ * `requested_amount_usd` is then the cash part.
476
+ */
477
+ offset_float_usd?: string;
478
+ /** Additive (3.37.0). Present with `offset_float_usd`: the amount asked for. */
479
+ amount_before_offset_usd?: string;
472
480
  [key: string]: unknown;
473
481
  }
474
482
  /** Creator statuses (3.25.0). */
@@ -1142,6 +1150,19 @@ interface Payout {
1142
1150
  owner_confirmation_required?: boolean;
1143
1151
  owner_confirmed_at?: string | null;
1144
1152
  created_at?: string | null;
1153
+ /**
1154
+ * 3.37.0. Present only when part of the amount asked for settled what your billing account
1155
+ * owes INVO for Steam or Apple coins: the amount settled, decimal string (USD).
1156
+ * `requested_amount_usd` is then the cash part. Absent (never `"0.00"`) when nothing was
1157
+ * settled.
1158
+ */
1159
+ offset_float_usd?: string;
1160
+ /** 3.37.0. Present with `offset_float_usd`: the amount you asked for (cash part plus `offset_float_usd`). */
1161
+ amount_before_offset_usd?: string;
1162
+ /** 3.37.0. `offset_float_usd`, mapped by the SDK, only when the payout carries it. */
1163
+ offsetFloatUsd?: string;
1164
+ /** 3.37.0. `amount_before_offset_usd`, mapped by the SDK, only when the payout carries it. */
1165
+ amountBeforeOffsetUsd?: string;
1145
1166
  [key: string]: unknown;
1146
1167
  }
1147
1168
  interface RequestPayoutInput {
@@ -1790,11 +1811,16 @@ declare class InvoServer {
1790
1811
  * Create a player in your game without moving money (`POST /api/sdk/players`), so a
1791
1812
  * first-time receiver can collect in-game. Sends no message to the player.
1792
1813
  *
1793
- * Returns `status: "created"` (new) or `"exists"` (already in your game with that
1794
- * phone), with a player token when INVO can issue one. Refusals: 409
1795
- * `err.isPhoneMismatch` (already in your game with a different phone; use
1796
- * `updatePlayerPhone`), 409 `err.isPhoneShareRefused` (the phone belongs to another
1797
- * email), 400 `INVALID_INPUT` / `INVALID_PHONE`, 429 (`err.retryAfter`).
1814
+ * Returns `status: "created"` (201, new to your game) or `"exists"` (200, already in
1815
+ * your game with that phone), with a player token when INVO can issue one (the token
1816
+ * fields are omitted otherwise). "created" can mean joining an existing INVO wallet:
1817
+ * the same email and phone as a wallet the person already has, so `identityId` is the
1818
+ * same one other games see. Refusals: 409 `err.isPhoneMismatch` (already in your game
1819
+ * with a different phone; use `updatePlayerPhone`), 409 `err.isPhoneShareRefused` (the
1820
+ * phone is held under another email, by a player or an INVO wallet: INVO asks the
1821
+ * phone's owner to approve, and the same call succeeds once they have), 400
1822
+ * `INVALID_INPUT` / `INVALID_PHONE`, 429 (`err.retryAfter`), 503
1823
+ * `sdk_verification_disabled` (the SDK player routes are switched off).
1798
1824
  */
1799
1825
  registerPlayer(input: RegisterPlayerInput, opts?: CallOptions): Promise<RegisterPlayerResult>;
1800
1826
  /**
@@ -2233,17 +2259,20 @@ declare class InvoServer {
2233
2259
  *
2234
2260
  * These three endpoints are UNAUTHENTICATED (phone-owner-driven: no game secret,
2235
2261
  * no player token) — a partner backend relays the handshake. The triggering 409
2236
- * carries `approval_id, expires_at, code_sent, existing_account_hints[], next_endpoint`.
2262
+ * carries `approval_id, expires_at, code_sent, existing_account_hints[], next_endpoint`,
2263
+ * `phone_last4` and `consent_channel` (`"email"` when the owner was emailed a link,
2264
+ * so there is no code to collect; `"sms"` when a text code went out).
2237
2265
  *
2238
2266
  * `phoneShareInitiate` is the fallback OTP send (use when the 409 didn't already
2239
2267
  * dispatch a code). NOT idempotent — never auto-retried. OTP TTL ~10 min.
2240
2268
  */
2241
2269
  phoneShareInitiate(input: PhoneShareContact, opts?: CallOptions): Promise<PhoneShareInitiateResult>;
2242
2270
  /**
2243
- * Approve a phone-share with the OTP the phone owner received. On success the grant
2244
- * is stored server-side, keyed by (phone, requesting_email) and auto-consumed — the
2245
- * caller simply RE-ISSUES the identical original request. UNAUTHENTICATED. NOT
2246
- * idempotent (attempts are counted) — never auto-retried.
2271
+ * Approve a phone-share with the OTP the phone owner received. On success the approval
2272
+ * is stored server-side, keyed by (phone, requesting_email), permanently and
2273
+ * network-wide (there is no revoke) — the caller simply RE-ISSUES the identical
2274
+ * original request. UNAUTHENTICATED. NOT idempotent (attempts are counted) — never
2275
+ * auto-retried.
2247
2276
  */
2248
2277
  phoneShareApprove(input: PhoneShareApproveInput, opts?: CallOptions): Promise<PhoneShareApproveResult>;
2249
2278
  /**
package/dist/server.cjs CHANGED
@@ -86,7 +86,11 @@ var InvoError = class _InvoError extends Error {
86
86
  * - registration/token-mint (phone already on another INVO account), and
87
87
  * - **claim + confirm-receipt** (`claimTransfer`/`claimCurrency`,
88
88
  * `confirmReceiptSend`/`confirmReceiptTransfer`) — the receiver phone is contested,
89
- * so INVO holds the money and texts the phone owner to approve.
89
+ * so INVO holds the money and asks the phone owner to approve.
90
+ *
91
+ * Either way the 409 has already created an approval request and contacted the phone's
92
+ * existing owner: by email when INVO has verified their address, otherwise by a text code
93
+ * (the body's `consent_channel` says which).
90
94
  *
91
95
  * NOT a failure. Show `err.message` verbatim (the backend supplies the user-facing text;
92
96
  * `phoneShareLast4` tells the UI which phone), keep the funds pending, and **retry the same
@@ -103,7 +107,8 @@ var InvoError = class _InvoError extends Error {
103
107
  const v = this.bodyObject()["approval_id"];
104
108
  return typeof v === "string" && v ? v : void 0;
105
109
  }
106
- /** Last 4 digits of the phone that must approve (`phone_last4`), for the UI message. */
110
+ /** Last 4 digits of the phone that must approve (`phone_last4`, a string such as `"4567"`),
111
+ * for the UI message. `undefined` when the body has none (an older server). */
107
112
  get phoneShareLast4() {
108
113
  const v = this.bodyObject()["phone_last4"];
109
114
  return typeof v === "string" && v ? v : void 0;
@@ -339,6 +344,27 @@ var InvoError = class _InvoError extends Error {
339
344
  get isPartnerRailSuspended() {
340
345
  return this.code === "PARTNER_RAIL_SUSPENDED";
341
346
  }
347
+ /** A payout or withdrawal was refused because the billing account owes INVO more for
348
+ * Steam or Apple coins than this payout can settle (`FLOAT_DEBT_OUTSTANDING`, 409;
349
+ * additive, 3.37.0). Nothing was created. {@link floatDebtUsd} is what is owed; the
350
+ * message is safe to show the account owner. Ask for a larger amount, or retry once the
351
+ * card on file has been charged. */
352
+ get isFloatDebtOutstanding() {
353
+ return this.code === "FLOAT_DEBT_OUTSTANDING";
354
+ }
355
+ /** On `FLOAT_DEBT_OUTSTANDING`: what the billing account owes (`float_debt_usd`), USD
356
+ * decimal string, for example `"95.00"`. `undefined` when the body does not carry it. */
357
+ get floatDebtUsd() {
358
+ const v = this.bodyObject()["float_debt_usd"];
359
+ if (typeof v === "number" && Number.isFinite(v)) return v.toFixed(2);
360
+ return typeof v === "string" && v ? v : void 0;
361
+ }
362
+ /** The billing account could not be checked, so the payout or withdrawal was not created
363
+ * (`FLOAT_CHECK_UNAVAILABLE`, 503, `retryable: true`; additive, 3.37.0). Nothing was
364
+ * changed. Retry with the same idempotency key. */
365
+ get isFloatCheckUnavailable() {
366
+ return this.code === "FLOAT_CHECK_UNAVAILABLE";
367
+ }
342
368
  /** True when INVO has paused new payments on the developer account
343
369
  * (`PAYMENTS_PAUSED`, 403; additive, 3.32.0). Every call that starts a payment returns it:
344
370
  * coin purchase, checkout session, Platform Commerce card purchase, new
@@ -1055,7 +1081,10 @@ var InvoError = class _InvoError extends Error {
1055
1081
  /**
1056
1082
  * True when the phone you supplied belongs to another email
1057
1083
  * (`PHONE_SHARE_APPROVAL_REQUIRED`, 409) on `mintPlayerToken`, `registerPlayer` or
1058
- * `updatePlayerPhone`. Nothing was created or changed. The same condition as
1084
+ * `updatePlayerPhone`. The phone may be held by a player in any game or by an INVO wallet
1085
+ * (including one created in the INVO app). No player was created or changed, but INVO has
1086
+ * created an approval request and asked the phone's owner to approve; retry the same call
1087
+ * once they have and it succeeds. The same condition as
1059
1088
  * {@link isPhoneShareApprovalRequired}, named for these registration calls.
1060
1089
  */
1061
1090
  get isPhoneShareRefused() {
@@ -1868,7 +1897,7 @@ function toPhoneChangeRequest(raw) {
1868
1897
  }
1869
1898
 
1870
1899
  // src/version.ts
1871
- var SDK_VERSION = "3.36.0";
1900
+ var SDK_VERSION = "3.37.1";
1872
1901
 
1873
1902
  // src/payouts.ts
1874
1903
  var AMOUNT = /^\d+(\.\d{1,2})?$/;
@@ -1898,6 +1927,20 @@ function query(params) {
1898
1927
  }
1899
1928
  return parts.length ? `?${parts.join("&")}` : "";
1900
1929
  }
1930
+ function moneyString(v) {
1931
+ if (typeof v === "number" && Number.isFinite(v)) return v.toFixed(2);
1932
+ return typeof v === "string" && v ? v : void 0;
1933
+ }
1934
+ function withOffsetFields(p) {
1935
+ if (!p || typeof p !== "object") return p;
1936
+ const offset = moneyString(p["offset_float_usd"]);
1937
+ const before = moneyString(p["amount_before_offset_usd"]);
1938
+ if (offset === void 0 && before === void 0) return p;
1939
+ const out = { ...p };
1940
+ if (offset !== void 0) out.offsetFloatUsd = offset;
1941
+ if (before !== void 0) out.amountBeforeOffsetUsd = before;
1942
+ return out;
1943
+ }
1901
1944
  function payeePath(payeeId) {
1902
1945
  return `/api/partner-payees/${encodeURIComponent(requireText("payeeId", payeeId))}`;
1903
1946
  }
@@ -2023,7 +2066,7 @@ var PayoutsServer = class {
2023
2066
  signal: opts?.signal
2024
2067
  });
2025
2068
  return {
2026
- payout: raw["payout_request"],
2069
+ payout: withOffsetFields(raw["payout_request"]),
2027
2070
  duplicate: raw["duplicate"] === true,
2028
2071
  raw
2029
2072
  };
@@ -2035,7 +2078,7 @@ var PayoutsServer = class {
2035
2078
  this.auth,
2036
2079
  { signal: opts?.signal }
2037
2080
  );
2038
- return raw["payout_request"];
2081
+ return withOffsetFields(raw["payout_request"]);
2039
2082
  }
2040
2083
  /** Your payouts (`GET /api/partner-payouts`), optionally one creator's (`payeeId`). */
2041
2084
  async listPayouts(q = {}, opts) {
@@ -2044,7 +2087,7 @@ var PayoutsServer = class {
2044
2087
  this.auth,
2045
2088
  { signal: opts?.signal }
2046
2089
  );
2047
- return { total: Number(raw["total"] ?? 0), items: raw["items"] ?? [], raw };
2090
+ return { total: Number(raw["total"] ?? 0), items: (raw["items"] ?? []).map((p) => withOffsetFields(p)), raw };
2048
2091
  }
2049
2092
  /**
2050
2093
  * Cancel a creator payout that is still `requested`
@@ -2058,7 +2101,7 @@ var PayoutsServer = class {
2058
2101
  this.auth,
2059
2102
  { signal: opts?.signal }
2060
2103
  );
2061
- return raw["payout_request"] ?? raw["payout"];
2104
+ return withOffsetFields(raw["payout_request"] ?? raw["payout"]);
2062
2105
  }
2063
2106
  };
2064
2107
 
@@ -4311,11 +4354,16 @@ var InvoServer = class {
4311
4354
  * Create a player in your game without moving money (`POST /api/sdk/players`), so a
4312
4355
  * first-time receiver can collect in-game. Sends no message to the player.
4313
4356
  *
4314
- * Returns `status: "created"` (new) or `"exists"` (already in your game with that
4315
- * phone), with a player token when INVO can issue one. Refusals: 409
4316
- * `err.isPhoneMismatch` (already in your game with a different phone; use
4317
- * `updatePlayerPhone`), 409 `err.isPhoneShareRefused` (the phone belongs to another
4318
- * email), 400 `INVALID_INPUT` / `INVALID_PHONE`, 429 (`err.retryAfter`).
4357
+ * Returns `status: "created"` (201, new to your game) or `"exists"` (200, already in
4358
+ * your game with that phone), with a player token when INVO can issue one (the token
4359
+ * fields are omitted otherwise). "created" can mean joining an existing INVO wallet:
4360
+ * the same email and phone as a wallet the person already has, so `identityId` is the
4361
+ * same one other games see. Refusals: 409 `err.isPhoneMismatch` (already in your game
4362
+ * with a different phone; use `updatePlayerPhone`), 409 `err.isPhoneShareRefused` (the
4363
+ * phone is held under another email, by a player or an INVO wallet: INVO asks the
4364
+ * phone's owner to approve, and the same call succeeds once they have), 400
4365
+ * `INVALID_INPUT` / `INVALID_PHONE`, 429 (`err.retryAfter`), 503
4366
+ * `sdk_verification_disabled` (the SDK player routes are switched off).
4319
4367
  */
4320
4368
  async registerPlayer(input, opts) {
4321
4369
  if (typeof input.playerEmail !== "string" || !input.playerEmail.trim()) {
@@ -5491,7 +5539,9 @@ var InvoServer = class {
5491
5539
  *
5492
5540
  * These three endpoints are UNAUTHENTICATED (phone-owner-driven: no game secret,
5493
5541
  * no player token) — a partner backend relays the handshake. The triggering 409
5494
- * carries `approval_id, expires_at, code_sent, existing_account_hints[], next_endpoint`.
5542
+ * carries `approval_id, expires_at, code_sent, existing_account_hints[], next_endpoint`,
5543
+ * `phone_last4` and `consent_channel` (`"email"` when the owner was emailed a link,
5544
+ * so there is no code to collect; `"sms"` when a text code went out).
5495
5545
  *
5496
5546
  * `phoneShareInitiate` is the fallback OTP send (use when the 409 didn't already
5497
5547
  * dispatch a code). NOT idempotent — never auto-retried. OTP TTL ~10 min.
@@ -5514,10 +5564,11 @@ var InvoServer = class {
5514
5564
  return toPhoneShareInitiateResult(raw);
5515
5565
  }
5516
5566
  /**
5517
- * Approve a phone-share with the OTP the phone owner received. On success the grant
5518
- * is stored server-side, keyed by (phone, requesting_email) and auto-consumed — the
5519
- * caller simply RE-ISSUES the identical original request. UNAUTHENTICATED. NOT
5520
- * idempotent (attempts are counted) — never auto-retried.
5567
+ * Approve a phone-share with the OTP the phone owner received. On success the approval
5568
+ * is stored server-side, keyed by (phone, requesting_email), permanently and
5569
+ * network-wide (there is no revoke) — the caller simply RE-ISSUES the identical
5570
+ * original request. UNAUTHENTICATED. NOT idempotent (attempts are counted) — never
5571
+ * auto-retried.
5521
5572
  */
5522
5573
  async phoneShareApprove(input, opts) {
5523
5574
  if (typeof input.approvalId !== "string" || !input.approvalId.trim()) {