@invonetwork/web-sdk 3.31.0 → 3.33.0
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/CHANGELOG.md +1490 -1474
- package/README.md +2990 -2959
- package/dist/{chunk-UW66W2N6.js → chunk-DHVHKFQH.js} +58 -5
- package/dist/{chunk-LMN2V4YT.js → chunk-HQLPT2DY.js} +31 -2
- package/dist/{chunk-5T75PCZN.js → chunk-MJAJXYFX.js} +3 -3
- package/dist/chunk-VWUFSA6U.js +6 -0
- package/dist/game-server.cjs +84 -2
- package/dist/game-server.d.cts +4 -4
- package/dist/game-server.d.ts +4 -4
- package/dist/game-server.js +5 -5
- package/dist/game.cjs +30 -1
- package/dist/game.d.cts +3 -3
- package/dist/game.d.ts +3 -3
- package/dist/game.js +3 -3
- package/dist/{hosted-approval-Dp-BigX9.d.ts → hosted-approval-CL3DfrGS.d.ts} +1 -1
- package/dist/{hosted-approval-BBQHClAP.d.cts → hosted-approval-CYqqberu.d.cts} +1 -1
- package/dist/index.cjs +29 -0
- package/dist/index.d.cts +4 -4
- package/dist/index.d.ts +4 -4
- package/dist/index.js +2 -2
- package/dist/{server-D9bKfiY6.d.cts → server-5_g5C-no.d.cts} +15 -4
- package/dist/{server-CaALJEML.d.ts → server-Dhao5prR.d.ts} +15 -4
- package/dist/server.cjs +84 -2
- package/dist/server.d.cts +3 -3
- package/dist/server.d.ts +3 -3
- package/dist/server.js +3 -3
- package/dist/{types-CBanzneD.d.cts → types-DUfQR48n.d.cts} +53 -3
- package/dist/{types-CBanzneD.d.ts → types-DUfQR48n.d.ts} +53 -3
- package/dist/{version-B4Eincjj.d.cts → version-DKfrEYU1.d.cts} +1 -1
- package/dist/{version-B4Eincjj.d.ts → version-DKfrEYU1.d.ts} +1 -1
- package/package.json +91 -91
- package/dist/chunk-CI7PHE6L.js +0 -6
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { I as InvoError, H as Http, $ as AuthHeader, g as CallOptions, a0 as PlatformPurchaseInput, a1 as PlatformPurchaseResult, a2 as
|
|
1
|
+
import { I as InvoError, H as Http, $ as AuthHeader, g as CallOptions, a0 as PlatformPurchaseInput, a1 as PlatformPurchaseResult, a2 as PlatformApprovalResult, a3 as PlatformOrderStatusResult, a4 as PlatformPurchaseHistoryQuery, a5 as PlatformPurchaseHistoryResult, a6 as PlatformRefundInput, a7 as PlatformRefundResult, a8 as CreateSubscriptionInput, a9 as SubscriptionResult, aa as GetSubscriptionOptions, ab as GetSubscriptionResult, ac as ListSubscriptionsOptions, ad as SubscriptionListResult, ae as CancelSubscriptionOptions, af as CancelResult, ag as ChangeAmountResult, ah as SetPaymentMethodInput, ai as SetPaymentMethodResult, aj as RefundSubscriptionInput, ak as RefundResult, al as SteamSubscriptionInitInput, am as SteamInitResult, an as SteamFinalizeSubscriptionResult, ao as CardSetupSessionInput, ap as CardSetupSessionResult, aq as CardSetupInput, ar as CardSetupResult, as as CardSetupConfirmInput, at as CardSetupConfirmResult, au as PlayerCardsResult, av as SandboxClockResult, aw as SandboxFailureOutcome, ax as SandboxForceFailureOptions, ay as SandboxForceAuthChallengeOptions, az as ServerConfig, aA as MintPlayerTokenInput, aB as PlayerToken, aC as RegisterPlayerInput, aD as RegisterPlayerResult, aE as UpdatePlayerPhoneInput, aF as UpdatePlayerPhoneResult, aG as RequestPhoneChangeInput, aH as RequestPhoneChangeResult, aI as PhoneChangeRequest, aJ as InitiateSendInput, aK as InitiateResult, aL as InitiateTransferInput, aM as CreateCheckoutInput, aN as CreateCheckoutResult, a as PurchaseStatusResult, aO as PurchaseInput, aP as PurchaseResult, aQ as CurrencyPurchaseQuoteInput, aR as CurrencyPurchaseQuote, aS as ConfirmPaymentResult, aT as OrderDetailsResult, aU as SteamPacksQuery, aV as SteamPacksResult, aW as SteamInitPurchaseInput, aX as SteamInitPurchaseResult, aY as SteamFinalizeInput, aZ as SteamFinalizeResult, a_ as PurchaseItemInput, a$ as PurchaseItemResult, b0 as ItemHistoryQuery, b1 as ItemHistoryResult, b2 as ItemOrderQuery, b3 as PlayerActivityQuery, b4 as PlayerActivityResult, b5 as PlayerActivityEntry, b6 as PlayerBalanceQuery, b7 as PlayerBalanceResult, q as LoyaltyCardsResult, b8 as InboundPendingQuery, b9 as InboundPendingResult, ba as LinkedIdentitiesQuery, bb as LinkedIdentitiesResult, bc as SmsVerifyResult, bd as ClaimTransferInput, be as ClaimResult, bf as ClaimCurrencyInput, bg as TransactionStatusResult, bh as GuardianApprovalStatusResult, bi as ServerDestinationsQuery, p as DestinationsResult, bj as PhoneShareContact, bk as PhoneShareInitiateResult, bl as PhoneShareApproveInput, bm as PhoneShareApproveResult, bn as PhoneShareStatusResult, bo as BeginDeviceApprovalInput, bp as DeviceApprovalGrant, bq as PollDeviceApprovalInput, br as DeviceApprovalPollResult, bs as ConfirmDeviceEnrollmentInput, bt as ConfirmDeviceEnrollmentResult, bu as ApproveWithDeviceCodeInput, bv as DeviceApprovalSettleResult, bw as CompleteDeviceApprovalInput, bx as CompleteDeviceApprovalResult } from './types-DUfQR48n.js';
|
|
2
2
|
import { b as ReportServerGameEventInput, a as ReportGameEventResult } from './loyalty-events-CmDw2ZoR.js';
|
|
3
|
-
import './version-
|
|
3
|
+
import './version-DKfrEYU1.js';
|
|
4
4
|
|
|
5
5
|
/**
|
|
6
6
|
* Pick the INVO environment from the game secret alone (3.28.0).
|
|
@@ -125,8 +125,8 @@ interface PurchaseEventData {
|
|
|
125
125
|
* to you. The guarantee is a Merchant of Record term; Open-tier card payments made before
|
|
126
126
|
* November 8, 2026 keep it, later ones do not (`false`, passed through at cost). `false`
|
|
127
127
|
* for any other dispute, handled as before. Never sent on a coin purchase
|
|
128
|
-
* dispute (a
|
|
129
|
-
*
|
|
128
|
+
* dispute (a coin purchase dispute reports what it charged you in `spent_coins_charged_usd`),
|
|
129
|
+
* nor on an opened or won event. Do not read absence as either value.
|
|
130
130
|
*/
|
|
131
131
|
guarantee_covered?: boolean;
|
|
132
132
|
/**
|
|
@@ -1207,6 +1207,17 @@ declare class PlatformCommerceServer {
|
|
|
1207
1207
|
* `err.isNotPlatformTenant` (403).
|
|
1208
1208
|
*/
|
|
1209
1209
|
purchase(input: PlatformPurchaseInput, opts?: CallOptions): Promise<PlatformPurchaseResult>;
|
|
1210
|
+
/** Read a buyer-approved purchase (3.33.0) by `approvalId` or by your `clientRequestId`
|
|
1211
|
+
* (exactly one). A fallback to the webhooks: `completed` carries `orderId`; an ending
|
|
1212
|
+
* without a sale carries `reason`. Throws `err.isApprovalNotFound` (404). */
|
|
1213
|
+
getApproval(key: {
|
|
1214
|
+
approvalId?: string;
|
|
1215
|
+
clientRequestId?: string;
|
|
1216
|
+
}, opts?: CallOptions): Promise<PlatformApprovalResult>;
|
|
1217
|
+
/** Withdraw a buyer-approved purchase that is still waiting (3.33.0).
|
|
1218
|
+
* `platform_commerce.declined` follows with reason `cancelled`. Throws
|
|
1219
|
+
* `err.isApprovalAlreadyEnded` (409) when it had already ended. */
|
|
1220
|
+
cancelApproval(approvalId: string, opts?: CallOptions): Promise<PlatformApprovalResult>;
|
|
1210
1221
|
/** Poll an order's status: `completed` (balance immediately; card after the webhook),
|
|
1211
1222
|
* `pending_payment` (card awaiting confirmation), or `refunded`. Once the sale has settled,
|
|
1212
1223
|
* `invoFeeUsd` / `partnerShareUsd` say what INVO kept and what you earned (additive). */
|
package/dist/server.cjs
CHANGED
|
@@ -339,6 +339,35 @@ var InvoError = class _InvoError extends Error {
|
|
|
339
339
|
get isPartnerRailSuspended() {
|
|
340
340
|
return this.code === "PARTNER_RAIL_SUSPENDED";
|
|
341
341
|
}
|
|
342
|
+
/** True when INVO has paused new payments on the developer account
|
|
343
|
+
* (`PAYMENTS_PAUSED`, 403; additive, 3.32.0). Every call that starts a payment returns it:
|
|
344
|
+
* coin purchase, checkout session, Platform Commerce card purchase, new
|
|
345
|
+
* subscription, Steam purchase or subscription start. Refunds, reads,
|
|
346
|
+
* balances, transfers and renewals of existing subscriptions keep working.
|
|
347
|
+
* Not retryable until INVO resumes payments; show a neutral "purchases are
|
|
348
|
+
* unavailable right now" message. */
|
|
349
|
+
get isPaymentsPaused() {
|
|
350
|
+
return this.code === "PAYMENTS_PAUSED";
|
|
351
|
+
}
|
|
352
|
+
/** A buyer-approved balance purchase cannot start (`BALANCE_UNAVAILABLE`, 400; 3.33.0):
|
|
353
|
+
* the buyer is unknown here or their balance is short. One answer on purpose; the
|
|
354
|
+
* balance is never disclosed. Offer another way to pay. */
|
|
355
|
+
get isBalanceUnavailable() {
|
|
356
|
+
return this.code === "BALANCE_UNAVAILABLE";
|
|
357
|
+
}
|
|
358
|
+
/** Buyer approval is not available (`APPROVAL_NOT_AVAILABLE`, 503 or 409; 3.33.0). */
|
|
359
|
+
get isApprovalNotAvailable() {
|
|
360
|
+
return this.code === "APPROVAL_NOT_AVAILABLE";
|
|
361
|
+
}
|
|
362
|
+
/** No buyer-approved purchase with that id in your store (`APPROVAL_NOT_FOUND`, 404). */
|
|
363
|
+
get isApprovalNotFound() {
|
|
364
|
+
return this.code === "APPROVAL_NOT_FOUND";
|
|
365
|
+
}
|
|
366
|
+
/** `cancelApproval` on an approval that already ended (`APPROVAL_ALREADY_ENDED`, 409).
|
|
367
|
+
* Read it with `getApproval`: it may have completed. */
|
|
368
|
+
get isApprovalAlreadyEnded() {
|
|
369
|
+
return this.code === "APPROVAL_ALREADY_ENDED";
|
|
370
|
+
}
|
|
342
371
|
/** True when init-purchase was given a `packId` that is not in INVO's Steam
|
|
343
372
|
* catalogue (`UNKNOWN_STEAM_PACK`, 400). The error body's
|
|
344
373
|
* `valid_pack_ids` lists what exists; re-fetch `steamPacks()` — the
|
|
@@ -1640,7 +1669,7 @@ function toPhoneChangeRequest(raw) {
|
|
|
1640
1669
|
}
|
|
1641
1670
|
|
|
1642
1671
|
// src/version.ts
|
|
1643
|
-
var SDK_VERSION = "3.
|
|
1672
|
+
var SDK_VERSION = "3.33.0";
|
|
1644
1673
|
|
|
1645
1674
|
// src/payouts.ts
|
|
1646
1675
|
var AMOUNT = /^\d+(\.\d{1,2})?$/;
|
|
@@ -2329,6 +2358,23 @@ function toPlayerActivityEntry(raw) {
|
|
|
2329
2358
|
raw
|
|
2330
2359
|
};
|
|
2331
2360
|
}
|
|
2361
|
+
function toPlatformApproval(raw) {
|
|
2362
|
+
const s = (k) => raw[k] == null ? null : String(raw[k]);
|
|
2363
|
+
const meta = raw["metadata"];
|
|
2364
|
+
return {
|
|
2365
|
+
approvalId: String(raw["approval_id"] ?? ""),
|
|
2366
|
+
clientRequestId: String(raw["client_request_id"] ?? ""),
|
|
2367
|
+
status: String(raw["status"] ?? ""),
|
|
2368
|
+
reason: s("reason"),
|
|
2369
|
+
totalPrice: s("total_price"),
|
|
2370
|
+
orderId: raw["order_id"] ?? null,
|
|
2371
|
+
transactionId: s("transaction_id"),
|
|
2372
|
+
expiresAt: s("expires_at"),
|
|
2373
|
+
decidedAt: s("decided_at"),
|
|
2374
|
+
metadata: meta && typeof meta === "object" && !Array.isArray(meta) ? meta : {},
|
|
2375
|
+
raw
|
|
2376
|
+
};
|
|
2377
|
+
}
|
|
2332
2378
|
function toPlatformOrderStatus(raw, fallbackOrderId) {
|
|
2333
2379
|
return {
|
|
2334
2380
|
orderId: raw["order_id"] ?? fallbackOrderId ?? "",
|
|
@@ -2635,6 +2681,10 @@ var PlatformCommerceServer = class {
|
|
|
2635
2681
|
if (input.successUrl) body["success_url"] = input.successUrl;
|
|
2636
2682
|
if (input.cancelUrl) body["cancel_url"] = input.cancelUrl;
|
|
2637
2683
|
if (input.metadata) body["metadata"] = input.metadata;
|
|
2684
|
+
if (input.requirePlayerApproval === true) {
|
|
2685
|
+
body["require_player_approval"] = true;
|
|
2686
|
+
if (input.returnUrl) body["return_url"] = input.returnUrl;
|
|
2687
|
+
}
|
|
2638
2688
|
const raw = await this.http.post(
|
|
2639
2689
|
"/api/platform-commerce/purchase",
|
|
2640
2690
|
body,
|
|
@@ -2643,7 +2693,9 @@ var PlatformCommerceServer = class {
|
|
|
2643
2693
|
{ idempotent: true, signal: opts?.signal }
|
|
2644
2694
|
);
|
|
2645
2695
|
const status = String(raw["status"] ?? "");
|
|
2646
|
-
if (status === "
|
|
2696
|
+
if (status === "pending_approval") {
|
|
2697
|
+
requireField2(raw["approval_id"], "approval_id", raw);
|
|
2698
|
+
} else if (status === "requires_payment") {
|
|
2647
2699
|
requireField2(raw["checkout_url"], "checkout_url", raw);
|
|
2648
2700
|
} else {
|
|
2649
2701
|
requireField2(raw["order_id"], "order_id", raw);
|
|
@@ -2664,9 +2716,39 @@ var PlatformCommerceServer = class {
|
|
|
2664
2716
|
amountUsd: raw["amount_usd"] ?? null,
|
|
2665
2717
|
idempotentReplay: raw["idempotent_replay"] === true,
|
|
2666
2718
|
...minPurchaseWarningField(raw),
|
|
2719
|
+
...raw["approval_id"] != null ? { approvalId: String(raw["approval_id"]) } : {},
|
|
2720
|
+
..."approval_url" in raw ? { approvalUrl: raw["approval_url"] ?? null } : {},
|
|
2667
2721
|
raw
|
|
2668
2722
|
};
|
|
2669
2723
|
}
|
|
2724
|
+
/** Read a buyer-approved purchase (3.33.0) by `approvalId` or by your `clientRequestId`
|
|
2725
|
+
* (exactly one). A fallback to the webhooks: `completed` carries `orderId`; an ending
|
|
2726
|
+
* without a sale carries `reason`. Throws `err.isApprovalNotFound` (404). */
|
|
2727
|
+
async getApproval(key, opts) {
|
|
2728
|
+
const id = key?.approvalId;
|
|
2729
|
+
const crid = key?.clientRequestId;
|
|
2730
|
+
if (Boolean(id) === Boolean(crid)) {
|
|
2731
|
+
throw invalidInput2("approvalId", id, "provide exactly one of approvalId or clientRequestId");
|
|
2732
|
+
}
|
|
2733
|
+
const path = id ? `/api/platform-commerce/approvals/${encodeURIComponent(String(id))}` : `/api/platform-commerce/approvals?${new URLSearchParams({ client_request_id: String(crid) }).toString()}`;
|
|
2734
|
+
const raw = await this.http.get(path, this.auth, { signal: opts?.signal });
|
|
2735
|
+
return toPlatformApproval(raw);
|
|
2736
|
+
}
|
|
2737
|
+
/** Withdraw a buyer-approved purchase that is still waiting (3.33.0).
|
|
2738
|
+
* `platform_commerce.declined` follows with reason `cancelled`. Throws
|
|
2739
|
+
* `err.isApprovalAlreadyEnded` (409) when it had already ended. */
|
|
2740
|
+
async cancelApproval(approvalId, opts) {
|
|
2741
|
+
if (typeof approvalId !== "string" || !approvalId.trim()) {
|
|
2742
|
+
throw invalidInput2("approvalId", approvalId, "is required");
|
|
2743
|
+
}
|
|
2744
|
+
const raw = await this.http.post(
|
|
2745
|
+
`/api/platform-commerce/approvals/${encodeURIComponent(approvalId)}/cancel`,
|
|
2746
|
+
{},
|
|
2747
|
+
this.auth,
|
|
2748
|
+
{ idempotent: true, signal: opts?.signal }
|
|
2749
|
+
);
|
|
2750
|
+
return toPlatformApproval(raw);
|
|
2751
|
+
}
|
|
2670
2752
|
/** Poll an order's status: `completed` (balance immediately; card after the webhook),
|
|
2671
2753
|
* `pending_payment` (card awaiting confirmation), or `refunded`. Once the sale has settled,
|
|
2672
2754
|
* `invoFeeUsd` / `partnerShareUsd` say what INVO kept and what you earned (additive). */
|
package/dist/server.d.cts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export {
|
|
1
|
+
export { bu as ApproveWithDeviceCodeInput, bo as BeginDeviceApprovalInput, g as CallOptions, af as CancelResult, ae as CancelSubscriptionOptions, as as CardSetupConfirmInput, at as CardSetupConfirmResult, aq as CardSetupInput, ar as CardSetupResult, ao as CardSetupSessionInput, ap as CardSetupSessionResult, by as CardSetupStatus, ag as ChangeAmountResult, bz as CheckoutWarning, bf as ClaimCurrencyInput, y as ClaimDelivery, be as ClaimResult, bd as ClaimTransferInput, bw as CompleteDeviceApprovalInput, bx as CompleteDeviceApprovalResult, bs as ConfirmDeviceEnrollmentInput, bt as ConfirmDeviceEnrollmentResult, aS as ConfirmPaymentResult, aM as CreateCheckoutInput, aN as CreateCheckoutResult, a8 as CreateSubscriptionInput, bA as CurrencyBalance, aR as CurrencyPurchaseQuote, bB as CurrencyPurchaseQuoteBreakdown, aQ as CurrencyPurchaseQuoteInput, D as DestinationGame, p as DestinationsResult, bC as DeviceApprovalChannel, bD as DeviceApprovalEnrollment, bE as DeviceApprovalFlow, bp as DeviceApprovalGrant, br as DeviceApprovalPollResult, bF as DeviceApprovalPollStatus, bv as DeviceApprovalSettleResult, bG as DeviceEnrollmentDecision, bH as DeviceEnrollmentRespond, bI as ExpiryReason, bJ as FeeTakenFrom, bK as FirstCharge, bL as FirstChargeStatus, bM as FundingSource, aa as GetSubscriptionOptions, ab as GetSubscriptionResult, bh as GuardianApprovalStatusResult, bN as InboundPendingItem, b8 as InboundPendingQuery, b9 as InboundPendingResult, aK as InitiateResult, aJ as InitiateSendInput, aL as InitiateTransferInput, I as InvoError, z as InvoErrorInfo, F as InvoHooks, G as InvoRequestInfo, J as InvoResponseInfo, b0 as ItemHistoryQuery, b1 as ItemHistoryResult, b2 as ItemOrderQuery, ba as LinkedIdentitiesQuery, bb as LinkedIdentitiesResult, bO as LinkedIdentityEmail, ac as ListSubscriptionsOptions, K as LoyaltyCard, N as LoyaltyCardReward, O as LoyaltyCardStep, q as LoyaltyCardsResult, Q as LoyaltyRewardState, S as LoyaltyStepProgress, T as LoyaltyStepState, bP as MinPurchaseWarning, aA as MintPlayerTokenInput, aT as OrderDetailsResult, bQ as PhoneChangeConfirmation, aI as PhoneChangeRequest, bR as PhoneChangeRequestStatus, bl as PhoneShareApproveInput, bm as PhoneShareApproveResult, bj as PhoneShareContact, bk as PhoneShareInitiateResult, bn as PhoneShareStatusResult, a2 as PlatformApprovalResult, a3 as PlatformOrderStatusResult, a4 as PlatformPurchaseHistoryQuery, a5 as PlatformPurchaseHistoryResult, a0 as PlatformPurchaseInput, a1 as PlatformPurchaseResult, bS as PlatformPurchaseStatus, a6 as PlatformRefundInput, a7 as PlatformRefundResult, b5 as PlayerActivityEntry, b3 as PlayerActivityQuery, b4 as PlayerActivityResult, bT as PlayerActivityType, b6 as PlayerBalanceQuery, b7 as PlayerBalanceResult, au as PlayerCardsResult, aB as PlayerToken, bq as PollDeviceApprovalInput, aO as PurchaseInput, a_ as PurchaseItemInput, a$ as PurchaseItemResult, aP as PurchaseResult, Z as Rail, bU as RefundInitiation, bV as RefundPendingApproval, bW as RefundProcessingFeeBasis, bX as RefundReceipt, ak as RefundResult, bY as RefundRevenueShareAttribution, aj as RefundSubscriptionInput, bZ as RefundWarning, aC as RegisterPlayerInput, aD as RegisterPlayerResult, aG as RequestPhoneChangeInput, aH as RequestPhoneChangeResult, av as SandboxClockResult, b_ as SandboxClockState, aw as SandboxFailureOutcome, ay as SandboxForceAuthChallengeOptions, ax as SandboxForceFailureOptions, b$ as SavedCard, az as ServerConfig, bi as ServerDestinationsQuery, ah as SetPaymentMethodInput, ai as SetPaymentMethodResult, bc as SmsVerifyResult, aY as SteamFinalizeInput, aZ as SteamFinalizeResult, an as SteamFinalizeSubscriptionResult, aW as SteamInitPurchaseInput, aX as SteamInitPurchaseResult, am as SteamInitResult, c0 as SteamPack, aU as SteamPacksQuery, aV as SteamPacksResult, al as SteamSubscriptionInitInput, c1 as SteamUserSession, c2 as Subscription, c3 as SubscriptionBaseInput, c4 as SubscriptionConsent, c5 as SubscriptionConsentInput, c6 as SubscriptionFundingRail, c7 as SubscriptionInterval, ad as SubscriptionListResult, a9 as SubscriptionResult, c8 as SubscriptionRevenueShare, c9 as SubscriptionRevenueShareInput, ca as SubscriptionStatus, bg as TransactionStatusResult, cb as UnacknowledgedPurchaseOutcome, aE as UpdatePlayerPhoneInput, aF as UpdatePlayerPhoneResult, _ as VerificationMethod, cc as isRefundPendingApproval } from './types-DUfQR48n.cjs';
|
|
2
2
|
export { G as GameEventType, R as ReportGameEventInput, a as ReportGameEventResult, b as ReportServerGameEventInput } from './loyalty-events-CmDw2ZoR.cjs';
|
|
3
|
-
export { C as CardsServer, D as DEMO_KEY_PREFIX, E as EnvironmentUnknownError, c as IdentityPasskeyResetData, a as InvoEnvironment, I as InvoServer, d as InvoWebhookEvent, e as ItemPurchasedData, L as ListPayeesQuery, f as ListPayeesResult, g as ListPayoutsQuery, h as ListPayoutsResult, P as PRODUCTION_BASE_URL, j as PayableBlocker, k as Payee, l as PayeeInvite, m as PayeeStatus, n as PayeeStatusChangedData, o as Payout, p as PayoutStatus, q as PayoutStatusChangedData, s as PayoutsServer, t as PlatformCommercePurchasedData, u as PlatformCommerceRefundedData, w as PlatformCommerceServer, x as PlayerPhoneChangedData, y as PurchaseCompletedData, z as PurchaseEventData, R as RegisterPayeeInput, A as RegisterPayeeResult, B as RequestPayoutInput, F as RequestPayoutResult, G as ReturnReasonCode, S as SANDBOX_BASE_URL, H as SandboxServer, J as SandboxSubscriptionsServer, K as SubscriptionAuthenticationRequiredData, M as SubscriptionCanceledData, N as SubscriptionEventCommon, O as SubscriptionExpiredData, Q as SubscriptionPastDueData, T as SubscriptionPaymentFailedData, U as SubscriptionRefundApprovedData, V as SubscriptionRefundDetail, W as SubscriptionRefundRejectedData, X as SubscriptionRefundRequestData, Y as SubscriptionRefundedData, Z as SubscriptionRenewalFunding, _ as SubscriptionRenewalSplit, $ as SubscriptionRenewedData, a0 as SubscriptionRevenueShareAttribution, a1 as SubscriptionTrialEventFields, a2 as SubscriptionsServer, a3 as TransferEventData, a4 as VerifyWebhookOptions, a5 as WebhookHandlerOptions, b as baseUrlForKey, a6 as createWebhookHandler, i as isDemoKey, r as resolveEnvironment, a7 as verifyWebhook, a8 as verifyWebhookAsync } from './server-
|
|
4
|
-
export { S as SDK_VERSION } from './version-
|
|
3
|
+
export { C as CardsServer, D as DEMO_KEY_PREFIX, E as EnvironmentUnknownError, c as IdentityPasskeyResetData, a as InvoEnvironment, I as InvoServer, d as InvoWebhookEvent, e as ItemPurchasedData, L as ListPayeesQuery, f as ListPayeesResult, g as ListPayoutsQuery, h as ListPayoutsResult, P as PRODUCTION_BASE_URL, j as PayableBlocker, k as Payee, l as PayeeInvite, m as PayeeStatus, n as PayeeStatusChangedData, o as Payout, p as PayoutStatus, q as PayoutStatusChangedData, s as PayoutsServer, t as PlatformCommercePurchasedData, u as PlatformCommerceRefundedData, w as PlatformCommerceServer, x as PlayerPhoneChangedData, y as PurchaseCompletedData, z as PurchaseEventData, R as RegisterPayeeInput, A as RegisterPayeeResult, B as RequestPayoutInput, F as RequestPayoutResult, G as ReturnReasonCode, S as SANDBOX_BASE_URL, H as SandboxServer, J as SandboxSubscriptionsServer, K as SubscriptionAuthenticationRequiredData, M as SubscriptionCanceledData, N as SubscriptionEventCommon, O as SubscriptionExpiredData, Q as SubscriptionPastDueData, T as SubscriptionPaymentFailedData, U as SubscriptionRefundApprovedData, V as SubscriptionRefundDetail, W as SubscriptionRefundRejectedData, X as SubscriptionRefundRequestData, Y as SubscriptionRefundedData, Z as SubscriptionRenewalFunding, _ as SubscriptionRenewalSplit, $ as SubscriptionRenewedData, a0 as SubscriptionRevenueShareAttribution, a1 as SubscriptionTrialEventFields, a2 as SubscriptionsServer, a3 as TransferEventData, a4 as VerifyWebhookOptions, a5 as WebhookHandlerOptions, b as baseUrlForKey, a6 as createWebhookHandler, i as isDemoKey, r as resolveEnvironment, a7 as verifyWebhook, a8 as verifyWebhookAsync } from './server-5_g5C-no.cjs';
|
|
4
|
+
export { S as SDK_VERSION } from './version-DKfrEYU1.cjs';
|
package/dist/server.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export {
|
|
1
|
+
export { bu as ApproveWithDeviceCodeInput, bo as BeginDeviceApprovalInput, g as CallOptions, af as CancelResult, ae as CancelSubscriptionOptions, as as CardSetupConfirmInput, at as CardSetupConfirmResult, aq as CardSetupInput, ar as CardSetupResult, ao as CardSetupSessionInput, ap as CardSetupSessionResult, by as CardSetupStatus, ag as ChangeAmountResult, bz as CheckoutWarning, bf as ClaimCurrencyInput, y as ClaimDelivery, be as ClaimResult, bd as ClaimTransferInput, bw as CompleteDeviceApprovalInput, bx as CompleteDeviceApprovalResult, bs as ConfirmDeviceEnrollmentInput, bt as ConfirmDeviceEnrollmentResult, aS as ConfirmPaymentResult, aM as CreateCheckoutInput, aN as CreateCheckoutResult, a8 as CreateSubscriptionInput, bA as CurrencyBalance, aR as CurrencyPurchaseQuote, bB as CurrencyPurchaseQuoteBreakdown, aQ as CurrencyPurchaseQuoteInput, D as DestinationGame, p as DestinationsResult, bC as DeviceApprovalChannel, bD as DeviceApprovalEnrollment, bE as DeviceApprovalFlow, bp as DeviceApprovalGrant, br as DeviceApprovalPollResult, bF as DeviceApprovalPollStatus, bv as DeviceApprovalSettleResult, bG as DeviceEnrollmentDecision, bH as DeviceEnrollmentRespond, bI as ExpiryReason, bJ as FeeTakenFrom, bK as FirstCharge, bL as FirstChargeStatus, bM as FundingSource, aa as GetSubscriptionOptions, ab as GetSubscriptionResult, bh as GuardianApprovalStatusResult, bN as InboundPendingItem, b8 as InboundPendingQuery, b9 as InboundPendingResult, aK as InitiateResult, aJ as InitiateSendInput, aL as InitiateTransferInput, I as InvoError, z as InvoErrorInfo, F as InvoHooks, G as InvoRequestInfo, J as InvoResponseInfo, b0 as ItemHistoryQuery, b1 as ItemHistoryResult, b2 as ItemOrderQuery, ba as LinkedIdentitiesQuery, bb as LinkedIdentitiesResult, bO as LinkedIdentityEmail, ac as ListSubscriptionsOptions, K as LoyaltyCard, N as LoyaltyCardReward, O as LoyaltyCardStep, q as LoyaltyCardsResult, Q as LoyaltyRewardState, S as LoyaltyStepProgress, T as LoyaltyStepState, bP as MinPurchaseWarning, aA as MintPlayerTokenInput, aT as OrderDetailsResult, bQ as PhoneChangeConfirmation, aI as PhoneChangeRequest, bR as PhoneChangeRequestStatus, bl as PhoneShareApproveInput, bm as PhoneShareApproveResult, bj as PhoneShareContact, bk as PhoneShareInitiateResult, bn as PhoneShareStatusResult, a2 as PlatformApprovalResult, a3 as PlatformOrderStatusResult, a4 as PlatformPurchaseHistoryQuery, a5 as PlatformPurchaseHistoryResult, a0 as PlatformPurchaseInput, a1 as PlatformPurchaseResult, bS as PlatformPurchaseStatus, a6 as PlatformRefundInput, a7 as PlatformRefundResult, b5 as PlayerActivityEntry, b3 as PlayerActivityQuery, b4 as PlayerActivityResult, bT as PlayerActivityType, b6 as PlayerBalanceQuery, b7 as PlayerBalanceResult, au as PlayerCardsResult, aB as PlayerToken, bq as PollDeviceApprovalInput, aO as PurchaseInput, a_ as PurchaseItemInput, a$ as PurchaseItemResult, aP as PurchaseResult, Z as Rail, bU as RefundInitiation, bV as RefundPendingApproval, bW as RefundProcessingFeeBasis, bX as RefundReceipt, ak as RefundResult, bY as RefundRevenueShareAttribution, aj as RefundSubscriptionInput, bZ as RefundWarning, aC as RegisterPlayerInput, aD as RegisterPlayerResult, aG as RequestPhoneChangeInput, aH as RequestPhoneChangeResult, av as SandboxClockResult, b_ as SandboxClockState, aw as SandboxFailureOutcome, ay as SandboxForceAuthChallengeOptions, ax as SandboxForceFailureOptions, b$ as SavedCard, az as ServerConfig, bi as ServerDestinationsQuery, ah as SetPaymentMethodInput, ai as SetPaymentMethodResult, bc as SmsVerifyResult, aY as SteamFinalizeInput, aZ as SteamFinalizeResult, an as SteamFinalizeSubscriptionResult, aW as SteamInitPurchaseInput, aX as SteamInitPurchaseResult, am as SteamInitResult, c0 as SteamPack, aU as SteamPacksQuery, aV as SteamPacksResult, al as SteamSubscriptionInitInput, c1 as SteamUserSession, c2 as Subscription, c3 as SubscriptionBaseInput, c4 as SubscriptionConsent, c5 as SubscriptionConsentInput, c6 as SubscriptionFundingRail, c7 as SubscriptionInterval, ad as SubscriptionListResult, a9 as SubscriptionResult, c8 as SubscriptionRevenueShare, c9 as SubscriptionRevenueShareInput, ca as SubscriptionStatus, bg as TransactionStatusResult, cb as UnacknowledgedPurchaseOutcome, aE as UpdatePlayerPhoneInput, aF as UpdatePlayerPhoneResult, _ as VerificationMethod, cc as isRefundPendingApproval } from './types-DUfQR48n.js';
|
|
2
2
|
export { G as GameEventType, R as ReportGameEventInput, a as ReportGameEventResult, b as ReportServerGameEventInput } from './loyalty-events-CmDw2ZoR.js';
|
|
3
|
-
export { C as CardsServer, D as DEMO_KEY_PREFIX, E as EnvironmentUnknownError, c as IdentityPasskeyResetData, a as InvoEnvironment, I as InvoServer, d as InvoWebhookEvent, e as ItemPurchasedData, L as ListPayeesQuery, f as ListPayeesResult, g as ListPayoutsQuery, h as ListPayoutsResult, P as PRODUCTION_BASE_URL, j as PayableBlocker, k as Payee, l as PayeeInvite, m as PayeeStatus, n as PayeeStatusChangedData, o as Payout, p as PayoutStatus, q as PayoutStatusChangedData, s as PayoutsServer, t as PlatformCommercePurchasedData, u as PlatformCommerceRefundedData, w as PlatformCommerceServer, x as PlayerPhoneChangedData, y as PurchaseCompletedData, z as PurchaseEventData, R as RegisterPayeeInput, A as RegisterPayeeResult, B as RequestPayoutInput, F as RequestPayoutResult, G as ReturnReasonCode, S as SANDBOX_BASE_URL, H as SandboxServer, J as SandboxSubscriptionsServer, K as SubscriptionAuthenticationRequiredData, M as SubscriptionCanceledData, N as SubscriptionEventCommon, O as SubscriptionExpiredData, Q as SubscriptionPastDueData, T as SubscriptionPaymentFailedData, U as SubscriptionRefundApprovedData, V as SubscriptionRefundDetail, W as SubscriptionRefundRejectedData, X as SubscriptionRefundRequestData, Y as SubscriptionRefundedData, Z as SubscriptionRenewalFunding, _ as SubscriptionRenewalSplit, $ as SubscriptionRenewedData, a0 as SubscriptionRevenueShareAttribution, a1 as SubscriptionTrialEventFields, a2 as SubscriptionsServer, a3 as TransferEventData, a4 as VerifyWebhookOptions, a5 as WebhookHandlerOptions, b as baseUrlForKey, a6 as createWebhookHandler, i as isDemoKey, r as resolveEnvironment, a7 as verifyWebhook, a8 as verifyWebhookAsync } from './server-
|
|
4
|
-
export { S as SDK_VERSION } from './version-
|
|
3
|
+
export { C as CardsServer, D as DEMO_KEY_PREFIX, E as EnvironmentUnknownError, c as IdentityPasskeyResetData, a as InvoEnvironment, I as InvoServer, d as InvoWebhookEvent, e as ItemPurchasedData, L as ListPayeesQuery, f as ListPayeesResult, g as ListPayoutsQuery, h as ListPayoutsResult, P as PRODUCTION_BASE_URL, j as PayableBlocker, k as Payee, l as PayeeInvite, m as PayeeStatus, n as PayeeStatusChangedData, o as Payout, p as PayoutStatus, q as PayoutStatusChangedData, s as PayoutsServer, t as PlatformCommercePurchasedData, u as PlatformCommerceRefundedData, w as PlatformCommerceServer, x as PlayerPhoneChangedData, y as PurchaseCompletedData, z as PurchaseEventData, R as RegisterPayeeInput, A as RegisterPayeeResult, B as RequestPayoutInput, F as RequestPayoutResult, G as ReturnReasonCode, S as SANDBOX_BASE_URL, H as SandboxServer, J as SandboxSubscriptionsServer, K as SubscriptionAuthenticationRequiredData, M as SubscriptionCanceledData, N as SubscriptionEventCommon, O as SubscriptionExpiredData, Q as SubscriptionPastDueData, T as SubscriptionPaymentFailedData, U as SubscriptionRefundApprovedData, V as SubscriptionRefundDetail, W as SubscriptionRefundRejectedData, X as SubscriptionRefundRequestData, Y as SubscriptionRefundedData, Z as SubscriptionRenewalFunding, _ as SubscriptionRenewalSplit, $ as SubscriptionRenewedData, a0 as SubscriptionRevenueShareAttribution, a1 as SubscriptionTrialEventFields, a2 as SubscriptionsServer, a3 as TransferEventData, a4 as VerifyWebhookOptions, a5 as WebhookHandlerOptions, b as baseUrlForKey, a6 as createWebhookHandler, i as isDemoKey, r as resolveEnvironment, a7 as verifyWebhook, a8 as verifyWebhookAsync } from './server-Dhao5prR.js';
|
|
4
|
+
export { S as SDK_VERSION } from './version-DKfrEYU1.js';
|
package/dist/server.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
export { CardsServer, DEMO_KEY_PREFIX, EnvironmentUnknownError, InvoServer, PRODUCTION_BASE_URL, PayoutsServer, PlatformCommerceServer, SANDBOX_BASE_URL, SandboxServer, SandboxSubscriptionsServer, SubscriptionsServer, baseUrlForKey, createWebhookHandler, isDemoKey, isRefundPendingApproval, resolveEnvironment, verifyWebhook, verifyWebhookAsync } from './chunk-
|
|
2
|
-
export { SDK_VERSION } from './chunk-
|
|
3
|
-
export { InvoError } from './chunk-
|
|
1
|
+
export { CardsServer, DEMO_KEY_PREFIX, EnvironmentUnknownError, InvoServer, PRODUCTION_BASE_URL, PayoutsServer, PlatformCommerceServer, SANDBOX_BASE_URL, SandboxServer, SandboxSubscriptionsServer, SubscriptionsServer, baseUrlForKey, createWebhookHandler, isDemoKey, isRefundPendingApproval, resolveEnvironment, verifyWebhook, verifyWebhookAsync } from './chunk-DHVHKFQH.js';
|
|
2
|
+
export { SDK_VERSION } from './chunk-VWUFSA6U.js';
|
|
3
|
+
export { InvoError } from './chunk-HQLPT2DY.js';
|
|
4
4
|
//# sourceMappingURL=server.js.map
|
|
5
5
|
//# sourceMappingURL=server.js.map
|
|
@@ -289,6 +289,25 @@ declare class InvoError extends Error {
|
|
|
289
289
|
* admin intervened. Terminal from the game's seat: no retry can succeed
|
|
290
290
|
* until the studio resolves it in the INVO console. */
|
|
291
291
|
get isPartnerRailSuspended(): boolean;
|
|
292
|
+
/** True when INVO has paused new payments on the developer account
|
|
293
|
+
* (`PAYMENTS_PAUSED`, 403; additive, 3.32.0). Every call that starts a payment returns it:
|
|
294
|
+
* coin purchase, checkout session, Platform Commerce card purchase, new
|
|
295
|
+
* subscription, Steam purchase or subscription start. Refunds, reads,
|
|
296
|
+
* balances, transfers and renewals of existing subscriptions keep working.
|
|
297
|
+
* Not retryable until INVO resumes payments; show a neutral "purchases are
|
|
298
|
+
* unavailable right now" message. */
|
|
299
|
+
get isPaymentsPaused(): boolean;
|
|
300
|
+
/** A buyer-approved balance purchase cannot start (`BALANCE_UNAVAILABLE`, 400; 3.33.0):
|
|
301
|
+
* the buyer is unknown here or their balance is short. One answer on purpose; the
|
|
302
|
+
* balance is never disclosed. Offer another way to pay. */
|
|
303
|
+
get isBalanceUnavailable(): boolean;
|
|
304
|
+
/** Buyer approval is not available (`APPROVAL_NOT_AVAILABLE`, 503 or 409; 3.33.0). */
|
|
305
|
+
get isApprovalNotAvailable(): boolean;
|
|
306
|
+
/** No buyer-approved purchase with that id in your store (`APPROVAL_NOT_FOUND`, 404). */
|
|
307
|
+
get isApprovalNotFound(): boolean;
|
|
308
|
+
/** `cancelApproval` on an approval that already ended (`APPROVAL_ALREADY_ENDED`, 409).
|
|
309
|
+
* Read it with `getApproval`: it may have completed. */
|
|
310
|
+
get isApprovalAlreadyEnded(): boolean;
|
|
292
311
|
/** True when init-purchase was given a `packId` that is not in INVO's Steam
|
|
293
312
|
* catalogue (`UNKNOWN_STEAM_PACK`, 400). The error body's
|
|
294
313
|
* `valid_pack_ids` lists what exists; re-fetch `steamPacks()` — the
|
|
@@ -1868,12 +1887,19 @@ interface PlatformPurchaseInput {
|
|
|
1868
1887
|
successUrl?: string;
|
|
1869
1888
|
/** Card leg only: where the hosted checkout sends the buyer on cancel. */
|
|
1870
1889
|
cancelUrl?: string;
|
|
1871
|
-
/**
|
|
1890
|
+
/** Your correlation object, echoed back on the platform_commerce.* webhooks (both legs). */
|
|
1872
1891
|
metadata?: Record<string, unknown>;
|
|
1892
|
+
/** Balance leg (3.33.0): nothing is debited until the BUYER approves on INVO's page with
|
|
1893
|
+
* their INVO passkey. The response is `status: "pending_approval"` with `approvalId` and
|
|
1894
|
+
* `approvalUrl`. Use it whenever the buyer's email comes from a public page. The card leg
|
|
1895
|
+
* ignores it (paying by card is the buyer's approval). */
|
|
1896
|
+
requirePlayerApproval?: boolean;
|
|
1897
|
+
/** With `requirePlayerApproval`: the approval page's "Back to the store" link (https). */
|
|
1898
|
+
returnUrl?: string;
|
|
1873
1899
|
}
|
|
1874
1900
|
/** "success" → BALANCE leg settled synchronously. "requires_payment" → CARD leg: send
|
|
1875
1901
|
* the buyer to `checkoutUrl` (INVO's hosted checkout page). */
|
|
1876
|
-
type PlatformPurchaseStatus = "success" | "requires_payment";
|
|
1902
|
+
type PlatformPurchaseStatus = "success" | "requires_payment" | "pending_approval";
|
|
1877
1903
|
interface PlatformPurchaseResult {
|
|
1878
1904
|
/** "success" (balance settled) | "requires_payment" (card — send the buyer to `checkoutUrl`). */
|
|
1879
1905
|
status: string;
|
|
@@ -1905,6 +1931,30 @@ interface PlatformPurchaseResult {
|
|
|
1905
1931
|
* the purchase throws `400 BELOW_CARD_MINIMUM` (`err.isBelowCardMinimum`). Absent otherwise.
|
|
1906
1932
|
*/
|
|
1907
1933
|
minPurchaseWarning?: MinPurchaseWarning;
|
|
1934
|
+
/** Additive (3.33.0), `pending_approval` only: the buyer-approved purchase's id. */
|
|
1935
|
+
approvalId?: string;
|
|
1936
|
+
/** Additive (3.33.0), `pending_approval` only: send the buyer here. `null` on a retry of a
|
|
1937
|
+
* purchase still waiting (`idempotentReplay: true`): keep the first response's URL. */
|
|
1938
|
+
approvalUrl?: string | null;
|
|
1939
|
+
raw: Record<string, unknown>;
|
|
1940
|
+
}
|
|
1941
|
+
/** A buyer-approved balance purchase (`getApproval` / `cancelApproval`, 3.33.0). */
|
|
1942
|
+
interface PlatformApprovalResult {
|
|
1943
|
+
approvalId: string;
|
|
1944
|
+
clientRequestId: string;
|
|
1945
|
+
/** "pending_approval" | "completed" | "declined" | "expired" | "cancelled" | "failed". */
|
|
1946
|
+
status: string;
|
|
1947
|
+
/** Why it ended without a sale: declined, buyer_cannot_approve, expired, cancelled,
|
|
1948
|
+
* insufficient_balance, recovery_hold or settlement_failed. Null while pending and when
|
|
1949
|
+
* completed. */
|
|
1950
|
+
reason: string | null;
|
|
1951
|
+
totalPrice: string | null;
|
|
1952
|
+
/** The sale's order once completed; read it with `getStatus`. */
|
|
1953
|
+
orderId: string | number | null;
|
|
1954
|
+
transactionId: string | null;
|
|
1955
|
+
expiresAt: string | null;
|
|
1956
|
+
decidedAt: string | null;
|
|
1957
|
+
metadata: Record<string, unknown>;
|
|
1908
1958
|
raw: Record<string, unknown>;
|
|
1909
1959
|
}
|
|
1910
1960
|
interface PlatformOrderStatusResult {
|
|
@@ -3738,4 +3788,4 @@ interface RewardsPageLink {
|
|
|
3738
3788
|
raw: Record<string, unknown>;
|
|
3739
3789
|
}
|
|
3740
3790
|
|
|
3741
|
-
export { type AuthHeader as $, type ApproveResult as A, type BalanceResult as B, type CheckoutClientConfig as C, type DestinationGame as D, type EnrollmentBeginResult as E, type InvoHooks as F, type InvoRequestInfo as G, Http as H, InvoError as I, type InvoResponseInfo as J, type LoyaltyCard as K, type LinkDeviceResult as L, type MountCheckoutOptions as M, type LoyaltyCardReward as N, type LoyaltyCardStep as O, type PendingCollectItem as P, type LoyaltyRewardState as Q, type RedeemRewardResult as R, type LoyaltyStepProgress as S, type LoyaltyStepState as T, type LoyaltyVaultEntry as U, type PhoneChangeApproval as V, type WaitForPurchaseInput as W, type PhoneChangeDeviceSignal as X, type PurchaseRefusalReason as Y, type Rail as Z, type VerificationMethod as _, type PurchaseStatusResult as a, type
|
|
3791
|
+
export { type AuthHeader as $, type ApproveResult as A, type BalanceResult as B, type CheckoutClientConfig as C, type DestinationGame as D, type EnrollmentBeginResult as E, type InvoHooks as F, type InvoRequestInfo as G, Http as H, InvoError as I, type InvoResponseInfo as J, type LoyaltyCard as K, type LinkDeviceResult as L, type MountCheckoutOptions as M, type LoyaltyCardReward as N, type LoyaltyCardStep as O, type PendingCollectItem as P, type LoyaltyRewardState as Q, type RedeemRewardResult as R, type LoyaltyStepProgress as S, type LoyaltyStepState as T, type LoyaltyVaultEntry as U, type PhoneChangeApproval as V, type WaitForPurchaseInput as W, type PhoneChangeDeviceSignal as X, type PurchaseRefusalReason as Y, type Rail as Z, type VerificationMethod as _, type PurchaseStatusResult as a, type PurchaseItemResult as a$, type PlatformPurchaseInput as a0, type PlatformPurchaseResult as a1, type PlatformApprovalResult as a2, type PlatformOrderStatusResult as a3, type PlatformPurchaseHistoryQuery as a4, type PlatformPurchaseHistoryResult as a5, type PlatformRefundInput as a6, type PlatformRefundResult as a7, type CreateSubscriptionInput as a8, type SubscriptionResult as a9, type MintPlayerTokenInput as aA, type PlayerToken as aB, type RegisterPlayerInput as aC, type RegisterPlayerResult as aD, type UpdatePlayerPhoneInput as aE, type UpdatePlayerPhoneResult as aF, type RequestPhoneChangeInput as aG, type RequestPhoneChangeResult as aH, type PhoneChangeRequest as aI, type InitiateSendInput as aJ, type InitiateResult as aK, type InitiateTransferInput as aL, type CreateCheckoutInput as aM, type CreateCheckoutResult as aN, type PurchaseInput as aO, type PurchaseResult as aP, type CurrencyPurchaseQuoteInput as aQ, type CurrencyPurchaseQuote as aR, type ConfirmPaymentResult as aS, type OrderDetailsResult as aT, type SteamPacksQuery as aU, type SteamPacksResult as aV, type SteamInitPurchaseInput as aW, type SteamInitPurchaseResult as aX, type SteamFinalizeInput as aY, type SteamFinalizeResult as aZ, type PurchaseItemInput as a_, type GetSubscriptionOptions as aa, type GetSubscriptionResult as ab, type ListSubscriptionsOptions as ac, type SubscriptionListResult as ad, type CancelSubscriptionOptions as ae, type CancelResult as af, type ChangeAmountResult as ag, type SetPaymentMethodInput as ah, type SetPaymentMethodResult as ai, type RefundSubscriptionInput as aj, type RefundResult as ak, type SteamSubscriptionInitInput as al, type SteamInitResult as am, type SteamFinalizeSubscriptionResult as an, type CardSetupSessionInput as ao, type CardSetupSessionResult as ap, type CardSetupInput as aq, type CardSetupResult as ar, type CardSetupConfirmInput as as, type CardSetupConfirmResult as at, type PlayerCardsResult as au, type SandboxClockResult as av, type SandboxFailureOutcome as aw, type SandboxForceFailureOptions as ax, type SandboxForceAuthChallengeOptions as ay, type ServerConfig as az, type PurchaseCredited as b, type SavedCard as b$, type ItemHistoryQuery as b0, type ItemHistoryResult as b1, type ItemOrderQuery as b2, type PlayerActivityQuery as b3, type PlayerActivityResult as b4, type PlayerActivityEntry as b5, type PlayerBalanceQuery as b6, type PlayerBalanceResult as b7, type InboundPendingQuery as b8, type InboundPendingResult as b9, type CurrencyBalance as bA, type CurrencyPurchaseQuoteBreakdown as bB, type DeviceApprovalChannel as bC, type DeviceApprovalEnrollment as bD, type DeviceApprovalFlow as bE, type DeviceApprovalPollStatus as bF, type DeviceEnrollmentDecision as bG, type DeviceEnrollmentRespond as bH, type ExpiryReason as bI, type FeeTakenFrom as bJ, type FirstCharge as bK, type FirstChargeStatus as bL, type FundingSource as bM, type InboundPendingItem as bN, type LinkedIdentityEmail as bO, type MinPurchaseWarning as bP, type PhoneChangeConfirmation as bQ, type PhoneChangeRequestStatus as bR, type PlatformPurchaseStatus as bS, type PlayerActivityType as bT, type RefundInitiation as bU, type RefundPendingApproval as bV, type RefundProcessingFeeBasis as bW, type RefundReceipt as bX, type RefundRevenueShareAttribution as bY, type RefundWarning as bZ, type SandboxClockState as b_, type LinkedIdentitiesQuery as ba, type LinkedIdentitiesResult as bb, type SmsVerifyResult as bc, type ClaimTransferInput as bd, type ClaimResult as be, type ClaimCurrencyInput as bf, type TransactionStatusResult as bg, type GuardianApprovalStatusResult as bh, type ServerDestinationsQuery as bi, type PhoneShareContact as bj, type PhoneShareInitiateResult as bk, type PhoneShareApproveInput as bl, type PhoneShareApproveResult as bm, type PhoneShareStatusResult as bn, type BeginDeviceApprovalInput as bo, type DeviceApprovalGrant as bp, type PollDeviceApprovalInput as bq, type DeviceApprovalPollResult as br, type ConfirmDeviceEnrollmentInput as bs, type ConfirmDeviceEnrollmentResult as bt, type ApproveWithDeviceCodeInput as bu, type DeviceApprovalSettleResult as bv, type CompleteDeviceApprovalInput as bw, type CompleteDeviceApprovalResult as bx, type CardSetupStatus as by, type CheckoutWarning as bz, type PurchaseExpired as c, type SteamPack as c0, type SteamUserSession as c1, type Subscription as c2, type SubscriptionBaseInput as c3, type SubscriptionConsent as c4, type SubscriptionConsentInput as c5, type SubscriptionFundingRail as c6, type SubscriptionInterval as c7, type SubscriptionRevenueShare as c8, type SubscriptionRevenueShareInput as c9, type SubscriptionStatus as ca, type UnacknowledgedPurchaseOutcome as cb, isRefundPendingApproval as cc, type PurchaseRefunded as d, type PurchaseRefused as e, type PurchaseStatusInput as f, type CallOptions as g, type CheckoutMountHandle as h, type ClientConfig as i, type ConfirmReceiptResult as j, type PhoneChangeApprovalsResult as k, type ApprovePhoneChangeInput as l, type ApprovePhoneChangeResult as m, type PendingCollectResult as n, type DestinationsQuery as o, type DestinationsResult as p, type LoyaltyCardsResult as q, type LoyaltyVaultResult as r, type RewardsPageLink as s, type EnrollmentVerifyResult as t, type RecoveryBeginResult as u, type RecoveryCompleteResult as v, type BalanceRow as w, type CheckoutPurchaseStatus as x, type ClaimDelivery as y, type InvoErrorInfo as z };
|
|
@@ -289,6 +289,25 @@ declare class InvoError extends Error {
|
|
|
289
289
|
* admin intervened. Terminal from the game's seat: no retry can succeed
|
|
290
290
|
* until the studio resolves it in the INVO console. */
|
|
291
291
|
get isPartnerRailSuspended(): boolean;
|
|
292
|
+
/** True when INVO has paused new payments on the developer account
|
|
293
|
+
* (`PAYMENTS_PAUSED`, 403; additive, 3.32.0). Every call that starts a payment returns it:
|
|
294
|
+
* coin purchase, checkout session, Platform Commerce card purchase, new
|
|
295
|
+
* subscription, Steam purchase or subscription start. Refunds, reads,
|
|
296
|
+
* balances, transfers and renewals of existing subscriptions keep working.
|
|
297
|
+
* Not retryable until INVO resumes payments; show a neutral "purchases are
|
|
298
|
+
* unavailable right now" message. */
|
|
299
|
+
get isPaymentsPaused(): boolean;
|
|
300
|
+
/** A buyer-approved balance purchase cannot start (`BALANCE_UNAVAILABLE`, 400; 3.33.0):
|
|
301
|
+
* the buyer is unknown here or their balance is short. One answer on purpose; the
|
|
302
|
+
* balance is never disclosed. Offer another way to pay. */
|
|
303
|
+
get isBalanceUnavailable(): boolean;
|
|
304
|
+
/** Buyer approval is not available (`APPROVAL_NOT_AVAILABLE`, 503 or 409; 3.33.0). */
|
|
305
|
+
get isApprovalNotAvailable(): boolean;
|
|
306
|
+
/** No buyer-approved purchase with that id in your store (`APPROVAL_NOT_FOUND`, 404). */
|
|
307
|
+
get isApprovalNotFound(): boolean;
|
|
308
|
+
/** `cancelApproval` on an approval that already ended (`APPROVAL_ALREADY_ENDED`, 409).
|
|
309
|
+
* Read it with `getApproval`: it may have completed. */
|
|
310
|
+
get isApprovalAlreadyEnded(): boolean;
|
|
292
311
|
/** True when init-purchase was given a `packId` that is not in INVO's Steam
|
|
293
312
|
* catalogue (`UNKNOWN_STEAM_PACK`, 400). The error body's
|
|
294
313
|
* `valid_pack_ids` lists what exists; re-fetch `steamPacks()` — the
|
|
@@ -1868,12 +1887,19 @@ interface PlatformPurchaseInput {
|
|
|
1868
1887
|
successUrl?: string;
|
|
1869
1888
|
/** Card leg only: where the hosted checkout sends the buyer on cancel. */
|
|
1870
1889
|
cancelUrl?: string;
|
|
1871
|
-
/**
|
|
1890
|
+
/** Your correlation object, echoed back on the platform_commerce.* webhooks (both legs). */
|
|
1872
1891
|
metadata?: Record<string, unknown>;
|
|
1892
|
+
/** Balance leg (3.33.0): nothing is debited until the BUYER approves on INVO's page with
|
|
1893
|
+
* their INVO passkey. The response is `status: "pending_approval"` with `approvalId` and
|
|
1894
|
+
* `approvalUrl`. Use it whenever the buyer's email comes from a public page. The card leg
|
|
1895
|
+
* ignores it (paying by card is the buyer's approval). */
|
|
1896
|
+
requirePlayerApproval?: boolean;
|
|
1897
|
+
/** With `requirePlayerApproval`: the approval page's "Back to the store" link (https). */
|
|
1898
|
+
returnUrl?: string;
|
|
1873
1899
|
}
|
|
1874
1900
|
/** "success" → BALANCE leg settled synchronously. "requires_payment" → CARD leg: send
|
|
1875
1901
|
* the buyer to `checkoutUrl` (INVO's hosted checkout page). */
|
|
1876
|
-
type PlatformPurchaseStatus = "success" | "requires_payment";
|
|
1902
|
+
type PlatformPurchaseStatus = "success" | "requires_payment" | "pending_approval";
|
|
1877
1903
|
interface PlatformPurchaseResult {
|
|
1878
1904
|
/** "success" (balance settled) | "requires_payment" (card — send the buyer to `checkoutUrl`). */
|
|
1879
1905
|
status: string;
|
|
@@ -1905,6 +1931,30 @@ interface PlatformPurchaseResult {
|
|
|
1905
1931
|
* the purchase throws `400 BELOW_CARD_MINIMUM` (`err.isBelowCardMinimum`). Absent otherwise.
|
|
1906
1932
|
*/
|
|
1907
1933
|
minPurchaseWarning?: MinPurchaseWarning;
|
|
1934
|
+
/** Additive (3.33.0), `pending_approval` only: the buyer-approved purchase's id. */
|
|
1935
|
+
approvalId?: string;
|
|
1936
|
+
/** Additive (3.33.0), `pending_approval` only: send the buyer here. `null` on a retry of a
|
|
1937
|
+
* purchase still waiting (`idempotentReplay: true`): keep the first response's URL. */
|
|
1938
|
+
approvalUrl?: string | null;
|
|
1939
|
+
raw: Record<string, unknown>;
|
|
1940
|
+
}
|
|
1941
|
+
/** A buyer-approved balance purchase (`getApproval` / `cancelApproval`, 3.33.0). */
|
|
1942
|
+
interface PlatformApprovalResult {
|
|
1943
|
+
approvalId: string;
|
|
1944
|
+
clientRequestId: string;
|
|
1945
|
+
/** "pending_approval" | "completed" | "declined" | "expired" | "cancelled" | "failed". */
|
|
1946
|
+
status: string;
|
|
1947
|
+
/** Why it ended without a sale: declined, buyer_cannot_approve, expired, cancelled,
|
|
1948
|
+
* insufficient_balance, recovery_hold or settlement_failed. Null while pending and when
|
|
1949
|
+
* completed. */
|
|
1950
|
+
reason: string | null;
|
|
1951
|
+
totalPrice: string | null;
|
|
1952
|
+
/** The sale's order once completed; read it with `getStatus`. */
|
|
1953
|
+
orderId: string | number | null;
|
|
1954
|
+
transactionId: string | null;
|
|
1955
|
+
expiresAt: string | null;
|
|
1956
|
+
decidedAt: string | null;
|
|
1957
|
+
metadata: Record<string, unknown>;
|
|
1908
1958
|
raw: Record<string, unknown>;
|
|
1909
1959
|
}
|
|
1910
1960
|
interface PlatformOrderStatusResult {
|
|
@@ -3738,4 +3788,4 @@ interface RewardsPageLink {
|
|
|
3738
3788
|
raw: Record<string, unknown>;
|
|
3739
3789
|
}
|
|
3740
3790
|
|
|
3741
|
-
export { type AuthHeader as $, type ApproveResult as A, type BalanceResult as B, type CheckoutClientConfig as C, type DestinationGame as D, type EnrollmentBeginResult as E, type InvoHooks as F, type InvoRequestInfo as G, Http as H, InvoError as I, type InvoResponseInfo as J, type LoyaltyCard as K, type LinkDeviceResult as L, type MountCheckoutOptions as M, type LoyaltyCardReward as N, type LoyaltyCardStep as O, type PendingCollectItem as P, type LoyaltyRewardState as Q, type RedeemRewardResult as R, type LoyaltyStepProgress as S, type LoyaltyStepState as T, type LoyaltyVaultEntry as U, type PhoneChangeApproval as V, type WaitForPurchaseInput as W, type PhoneChangeDeviceSignal as X, type PurchaseRefusalReason as Y, type Rail as Z, type VerificationMethod as _, type PurchaseStatusResult as a, type
|
|
3791
|
+
export { type AuthHeader as $, type ApproveResult as A, type BalanceResult as B, type CheckoutClientConfig as C, type DestinationGame as D, type EnrollmentBeginResult as E, type InvoHooks as F, type InvoRequestInfo as G, Http as H, InvoError as I, type InvoResponseInfo as J, type LoyaltyCard as K, type LinkDeviceResult as L, type MountCheckoutOptions as M, type LoyaltyCardReward as N, type LoyaltyCardStep as O, type PendingCollectItem as P, type LoyaltyRewardState as Q, type RedeemRewardResult as R, type LoyaltyStepProgress as S, type LoyaltyStepState as T, type LoyaltyVaultEntry as U, type PhoneChangeApproval as V, type WaitForPurchaseInput as W, type PhoneChangeDeviceSignal as X, type PurchaseRefusalReason as Y, type Rail as Z, type VerificationMethod as _, type PurchaseStatusResult as a, type PurchaseItemResult as a$, type PlatformPurchaseInput as a0, type PlatformPurchaseResult as a1, type PlatformApprovalResult as a2, type PlatformOrderStatusResult as a3, type PlatformPurchaseHistoryQuery as a4, type PlatformPurchaseHistoryResult as a5, type PlatformRefundInput as a6, type PlatformRefundResult as a7, type CreateSubscriptionInput as a8, type SubscriptionResult as a9, type MintPlayerTokenInput as aA, type PlayerToken as aB, type RegisterPlayerInput as aC, type RegisterPlayerResult as aD, type UpdatePlayerPhoneInput as aE, type UpdatePlayerPhoneResult as aF, type RequestPhoneChangeInput as aG, type RequestPhoneChangeResult as aH, type PhoneChangeRequest as aI, type InitiateSendInput as aJ, type InitiateResult as aK, type InitiateTransferInput as aL, type CreateCheckoutInput as aM, type CreateCheckoutResult as aN, type PurchaseInput as aO, type PurchaseResult as aP, type CurrencyPurchaseQuoteInput as aQ, type CurrencyPurchaseQuote as aR, type ConfirmPaymentResult as aS, type OrderDetailsResult as aT, type SteamPacksQuery as aU, type SteamPacksResult as aV, type SteamInitPurchaseInput as aW, type SteamInitPurchaseResult as aX, type SteamFinalizeInput as aY, type SteamFinalizeResult as aZ, type PurchaseItemInput as a_, type GetSubscriptionOptions as aa, type GetSubscriptionResult as ab, type ListSubscriptionsOptions as ac, type SubscriptionListResult as ad, type CancelSubscriptionOptions as ae, type CancelResult as af, type ChangeAmountResult as ag, type SetPaymentMethodInput as ah, type SetPaymentMethodResult as ai, type RefundSubscriptionInput as aj, type RefundResult as ak, type SteamSubscriptionInitInput as al, type SteamInitResult as am, type SteamFinalizeSubscriptionResult as an, type CardSetupSessionInput as ao, type CardSetupSessionResult as ap, type CardSetupInput as aq, type CardSetupResult as ar, type CardSetupConfirmInput as as, type CardSetupConfirmResult as at, type PlayerCardsResult as au, type SandboxClockResult as av, type SandboxFailureOutcome as aw, type SandboxForceFailureOptions as ax, type SandboxForceAuthChallengeOptions as ay, type ServerConfig as az, type PurchaseCredited as b, type SavedCard as b$, type ItemHistoryQuery as b0, type ItemHistoryResult as b1, type ItemOrderQuery as b2, type PlayerActivityQuery as b3, type PlayerActivityResult as b4, type PlayerActivityEntry as b5, type PlayerBalanceQuery as b6, type PlayerBalanceResult as b7, type InboundPendingQuery as b8, type InboundPendingResult as b9, type CurrencyBalance as bA, type CurrencyPurchaseQuoteBreakdown as bB, type DeviceApprovalChannel as bC, type DeviceApprovalEnrollment as bD, type DeviceApprovalFlow as bE, type DeviceApprovalPollStatus as bF, type DeviceEnrollmentDecision as bG, type DeviceEnrollmentRespond as bH, type ExpiryReason as bI, type FeeTakenFrom as bJ, type FirstCharge as bK, type FirstChargeStatus as bL, type FundingSource as bM, type InboundPendingItem as bN, type LinkedIdentityEmail as bO, type MinPurchaseWarning as bP, type PhoneChangeConfirmation as bQ, type PhoneChangeRequestStatus as bR, type PlatformPurchaseStatus as bS, type PlayerActivityType as bT, type RefundInitiation as bU, type RefundPendingApproval as bV, type RefundProcessingFeeBasis as bW, type RefundReceipt as bX, type RefundRevenueShareAttribution as bY, type RefundWarning as bZ, type SandboxClockState as b_, type LinkedIdentitiesQuery as ba, type LinkedIdentitiesResult as bb, type SmsVerifyResult as bc, type ClaimTransferInput as bd, type ClaimResult as be, type ClaimCurrencyInput as bf, type TransactionStatusResult as bg, type GuardianApprovalStatusResult as bh, type ServerDestinationsQuery as bi, type PhoneShareContact as bj, type PhoneShareInitiateResult as bk, type PhoneShareApproveInput as bl, type PhoneShareApproveResult as bm, type PhoneShareStatusResult as bn, type BeginDeviceApprovalInput as bo, type DeviceApprovalGrant as bp, type PollDeviceApprovalInput as bq, type DeviceApprovalPollResult as br, type ConfirmDeviceEnrollmentInput as bs, type ConfirmDeviceEnrollmentResult as bt, type ApproveWithDeviceCodeInput as bu, type DeviceApprovalSettleResult as bv, type CompleteDeviceApprovalInput as bw, type CompleteDeviceApprovalResult as bx, type CardSetupStatus as by, type CheckoutWarning as bz, type PurchaseExpired as c, type SteamPack as c0, type SteamUserSession as c1, type Subscription as c2, type SubscriptionBaseInput as c3, type SubscriptionConsent as c4, type SubscriptionConsentInput as c5, type SubscriptionFundingRail as c6, type SubscriptionInterval as c7, type SubscriptionRevenueShare as c8, type SubscriptionRevenueShareInput as c9, type SubscriptionStatus as ca, type UnacknowledgedPurchaseOutcome as cb, isRefundPendingApproval as cc, type PurchaseRefunded as d, type PurchaseRefused as e, type PurchaseStatusInput as f, type CallOptions as g, type CheckoutMountHandle as h, type ClientConfig as i, type ConfirmReceiptResult as j, type PhoneChangeApprovalsResult as k, type ApprovePhoneChangeInput as l, type ApprovePhoneChangeResult as m, type PendingCollectResult as n, type DestinationsQuery as o, type DestinationsResult as p, type LoyaltyCardsResult as q, type LoyaltyVaultResult as r, type RewardsPageLink as s, type EnrollmentVerifyResult as t, type RecoveryBeginResult as u, type RecoveryCompleteResult as v, type BalanceRow as w, type CheckoutPurchaseStatus as x, type ClaimDelivery as y, type InvoErrorInfo as z };
|