@invonetwork/web-sdk 3.32.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 -1484
- package/README.md +28 -1
- package/dist/{chunk-RPGRRZFY.js → chunk-DHVHKFQH.js} +58 -5
- package/dist/{chunk-QEJB6HC7.js → chunk-HQLPT2DY.js} +21 -2
- package/dist/{chunk-2XOKKKFR.js → chunk-MJAJXYFX.js} +3 -3
- package/dist/chunk-VWUFSA6U.js +6 -0
- package/dist/game-server.cjs +74 -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 +20 -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-ICho9KsV.d.ts → hosted-approval-CL3DfrGS.d.ts} +1 -1
- package/dist/{hosted-approval-li0XZFz-.d.cts → hosted-approval-CYqqberu.d.cts} +1 -1
- package/dist/index.cjs +19 -0
- package/dist/index.d.cts +4 -4
- package/dist/index.d.ts +4 -4
- package/dist/index.js +2 -2
- package/dist/{server-jAn9dNM3.d.cts → server-5_g5C-no.d.cts} +13 -2
- package/dist/{server-B-KKg5P0.d.ts → server-Dhao5prR.d.ts} +13 -2
- package/dist/server.cjs +74 -2
- package/dist/server.d.cts +3 -3
- package/dist/server.d.ts +3 -3
- package/dist/server.js +3 -3
- package/dist/{types-CaPHNjOU.d.cts → types-DUfQR48n.d.cts} +45 -3
- package/dist/{types-CaPHNjOU.d.ts → types-DUfQR48n.d.ts} +45 -3
- package/dist/{version-CqwGhQXV.d.cts → version-DKfrEYU1.d.cts} +1 -1
- package/dist/{version-CqwGhQXV.d.ts → version-DKfrEYU1.d.ts} +1 -1
- package/package.json +91 -91
- package/dist/chunk-LVVPRVPU.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).
|
|
@@ -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
|
@@ -349,6 +349,25 @@ var InvoError = class _InvoError extends Error {
|
|
|
349
349
|
get isPaymentsPaused() {
|
|
350
350
|
return this.code === "PAYMENTS_PAUSED";
|
|
351
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
|
+
}
|
|
352
371
|
/** True when init-purchase was given a `packId` that is not in INVO's Steam
|
|
353
372
|
* catalogue (`UNKNOWN_STEAM_PACK`, 400). The error body's
|
|
354
373
|
* `valid_pack_ids` lists what exists; re-fetch `steamPacks()` — the
|
|
@@ -1650,7 +1669,7 @@ function toPhoneChangeRequest(raw) {
|
|
|
1650
1669
|
}
|
|
1651
1670
|
|
|
1652
1671
|
// src/version.ts
|
|
1653
|
-
var SDK_VERSION = "3.
|
|
1672
|
+
var SDK_VERSION = "3.33.0";
|
|
1654
1673
|
|
|
1655
1674
|
// src/payouts.ts
|
|
1656
1675
|
var AMOUNT = /^\d+(\.\d{1,2})?$/;
|
|
@@ -2339,6 +2358,23 @@ function toPlayerActivityEntry(raw) {
|
|
|
2339
2358
|
raw
|
|
2340
2359
|
};
|
|
2341
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
|
+
}
|
|
2342
2378
|
function toPlatformOrderStatus(raw, fallbackOrderId) {
|
|
2343
2379
|
return {
|
|
2344
2380
|
orderId: raw["order_id"] ?? fallbackOrderId ?? "",
|
|
@@ -2645,6 +2681,10 @@ var PlatformCommerceServer = class {
|
|
|
2645
2681
|
if (input.successUrl) body["success_url"] = input.successUrl;
|
|
2646
2682
|
if (input.cancelUrl) body["cancel_url"] = input.cancelUrl;
|
|
2647
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
|
+
}
|
|
2648
2688
|
const raw = await this.http.post(
|
|
2649
2689
|
"/api/platform-commerce/purchase",
|
|
2650
2690
|
body,
|
|
@@ -2653,7 +2693,9 @@ var PlatformCommerceServer = class {
|
|
|
2653
2693
|
{ idempotent: true, signal: opts?.signal }
|
|
2654
2694
|
);
|
|
2655
2695
|
const status = String(raw["status"] ?? "");
|
|
2656
|
-
if (status === "
|
|
2696
|
+
if (status === "pending_approval") {
|
|
2697
|
+
requireField2(raw["approval_id"], "approval_id", raw);
|
|
2698
|
+
} else if (status === "requires_payment") {
|
|
2657
2699
|
requireField2(raw["checkout_url"], "checkout_url", raw);
|
|
2658
2700
|
} else {
|
|
2659
2701
|
requireField2(raw["order_id"], "order_id", raw);
|
|
@@ -2674,9 +2716,39 @@ var PlatformCommerceServer = class {
|
|
|
2674
2716
|
amountUsd: raw["amount_usd"] ?? null,
|
|
2675
2717
|
idempotentReplay: raw["idempotent_replay"] === true,
|
|
2676
2718
|
...minPurchaseWarningField(raw),
|
|
2719
|
+
...raw["approval_id"] != null ? { approvalId: String(raw["approval_id"]) } : {},
|
|
2720
|
+
..."approval_url" in raw ? { approvalUrl: raw["approval_url"] ?? null } : {},
|
|
2677
2721
|
raw
|
|
2678
2722
|
};
|
|
2679
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
|
+
}
|
|
2680
2752
|
/** Poll an order's status: `completed` (balance immediately; card after the webhook),
|
|
2681
2753
|
* `pending_payment` (card awaiting confirmation), or `refunded`. Once the sale has settled,
|
|
2682
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
|
|
@@ -297,6 +297,17 @@ declare class InvoError extends Error {
|
|
|
297
297
|
* Not retryable until INVO resumes payments; show a neutral "purchases are
|
|
298
298
|
* unavailable right now" message. */
|
|
299
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;
|
|
300
311
|
/** True when init-purchase was given a `packId` that is not in INVO's Steam
|
|
301
312
|
* catalogue (`UNKNOWN_STEAM_PACK`, 400). The error body's
|
|
302
313
|
* `valid_pack_ids` lists what exists; re-fetch `steamPacks()` — the
|
|
@@ -1876,12 +1887,19 @@ interface PlatformPurchaseInput {
|
|
|
1876
1887
|
successUrl?: string;
|
|
1877
1888
|
/** Card leg only: where the hosted checkout sends the buyer on cancel. */
|
|
1878
1889
|
cancelUrl?: string;
|
|
1879
|
-
/**
|
|
1890
|
+
/** Your correlation object, echoed back on the platform_commerce.* webhooks (both legs). */
|
|
1880
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;
|
|
1881
1899
|
}
|
|
1882
1900
|
/** "success" → BALANCE leg settled synchronously. "requires_payment" → CARD leg: send
|
|
1883
1901
|
* the buyer to `checkoutUrl` (INVO's hosted checkout page). */
|
|
1884
|
-
type PlatformPurchaseStatus = "success" | "requires_payment";
|
|
1902
|
+
type PlatformPurchaseStatus = "success" | "requires_payment" | "pending_approval";
|
|
1885
1903
|
interface PlatformPurchaseResult {
|
|
1886
1904
|
/** "success" (balance settled) | "requires_payment" (card — send the buyer to `checkoutUrl`). */
|
|
1887
1905
|
status: string;
|
|
@@ -1913,6 +1931,30 @@ interface PlatformPurchaseResult {
|
|
|
1913
1931
|
* the purchase throws `400 BELOW_CARD_MINIMUM` (`err.isBelowCardMinimum`). Absent otherwise.
|
|
1914
1932
|
*/
|
|
1915
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>;
|
|
1916
1958
|
raw: Record<string, unknown>;
|
|
1917
1959
|
}
|
|
1918
1960
|
interface PlatformOrderStatusResult {
|
|
@@ -3746,4 +3788,4 @@ interface RewardsPageLink {
|
|
|
3746
3788
|
raw: Record<string, unknown>;
|
|
3747
3789
|
}
|
|
3748
3790
|
|
|
3749
|
-
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 };
|
|
@@ -297,6 +297,17 @@ declare class InvoError extends Error {
|
|
|
297
297
|
* Not retryable until INVO resumes payments; show a neutral "purchases are
|
|
298
298
|
* unavailable right now" message. */
|
|
299
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;
|
|
300
311
|
/** True when init-purchase was given a `packId` that is not in INVO's Steam
|
|
301
312
|
* catalogue (`UNKNOWN_STEAM_PACK`, 400). The error body's
|
|
302
313
|
* `valid_pack_ids` lists what exists; re-fetch `steamPacks()` — the
|
|
@@ -1876,12 +1887,19 @@ interface PlatformPurchaseInput {
|
|
|
1876
1887
|
successUrl?: string;
|
|
1877
1888
|
/** Card leg only: where the hosted checkout sends the buyer on cancel. */
|
|
1878
1889
|
cancelUrl?: string;
|
|
1879
|
-
/**
|
|
1890
|
+
/** Your correlation object, echoed back on the platform_commerce.* webhooks (both legs). */
|
|
1880
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;
|
|
1881
1899
|
}
|
|
1882
1900
|
/** "success" → BALANCE leg settled synchronously. "requires_payment" → CARD leg: send
|
|
1883
1901
|
* the buyer to `checkoutUrl` (INVO's hosted checkout page). */
|
|
1884
|
-
type PlatformPurchaseStatus = "success" | "requires_payment";
|
|
1902
|
+
type PlatformPurchaseStatus = "success" | "requires_payment" | "pending_approval";
|
|
1885
1903
|
interface PlatformPurchaseResult {
|
|
1886
1904
|
/** "success" (balance settled) | "requires_payment" (card — send the buyer to `checkoutUrl`). */
|
|
1887
1905
|
status: string;
|
|
@@ -1913,6 +1931,30 @@ interface PlatformPurchaseResult {
|
|
|
1913
1931
|
* the purchase throws `400 BELOW_CARD_MINIMUM` (`err.isBelowCardMinimum`). Absent otherwise.
|
|
1914
1932
|
*/
|
|
1915
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>;
|
|
1916
1958
|
raw: Record<string, unknown>;
|
|
1917
1959
|
}
|
|
1918
1960
|
interface PlatformOrderStatusResult {
|
|
@@ -3746,4 +3788,4 @@ interface RewardsPageLink {
|
|
|
3746
3788
|
raw: Record<string, unknown>;
|
|
3747
3789
|
}
|
|
3748
3790
|
|
|
3749
|
-
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 };
|