@voltro/plugin-economy 0.0.0-stage → 0.88.0

package/dist/web.d.ts

@@ -0,0 +1,2257 @@
+import { ActionProcedureDescriptor } from '@voltro/protocol';
+import { ActionState } from '@voltro/client';
+import { QueryProcedureDescriptor } from '@voltro/protocol';
+import { Schema } from 'effect';
+import { SubscriptionIdle } from '@voltro/client';
+import { SubscriptionState } from '@voltro/client';
+import { YieldableError } from 'effect/Cause';
+
+/** Explicit browser capabilities; missing Web Locks/storage never falls back to memory. */
+export declare const browserShopPurchaseJournal: (storage: Pick<Storage, "getItem" | "setItem" | "removeItem">, locks: Pick<LockManager, "request">) => ShopPurchaseJournal;
+
+export declare const browserTradeIntentionJournal: (storage: Pick<Storage, "getItem" | "setItem" | "removeItem">, locks: Pick<LockManager, "request">) => TradeIntentionJournal;
+
+/** Store only explicit intentions under stable app+authenticated account scope; no credentials/state. */
+export declare const captureTradeIntention: (input: unknown) => TradeIntention;
+
+/** Pure detached wire shape only. New admission must still validate actual
+ * currencies and rules; originals compare before current declarations. */
+declare const captureTradeProposeIntention: (input: TradeProposeInput) => Readonly<{
+    toId: string | null;
+    offered: TradeLeg;
+    requested: TradeLeg;
+    durationMs: number;
+    requestId: string;
+}>;
+
+declare const codesRedeemDescriptor: ActionProcedureDescriptor<"economy.redeem", Schema.Struct<{
+    readonly code: Schema.String;
+    readonly requestId: Schema.String;
+}>, Schema.Struct<{
+    readonly operationId: Schema.String;
+    readonly codeId: Schema.String;
+    readonly version: Schema.String;
+    readonly campaign: Schema.String;
+    readonly at: Schema.Number;
+    readonly transfers: Schema.$Array<Schema.Struct<{
+        readonly txId: Schema.String;
+        readonly currency: Schema.String;
+        readonly amount: Schema.String;
+        readonly at: Schema.Number;
+    }>>;
+    readonly grants: Schema.$Array<Schema.Struct<{
+        readonly operationId: Schema.String;
+        readonly kind: Schema.Literal<"grant">;
+        readonly changes: Schema.$Array<Schema.Struct<{
+            readonly instanceId: Schema.String;
+            readonly delta: Schema.Number;
+        }>>;
+        readonly at: Schema.Number;
+    }>>;
+}>, typeof EconomyError>;
+
+declare const containerOpenDescriptor: ActionProcedureDescriptor<"economy.openContainer", Schema.Struct<{
+    readonly containerId: Schema.String;
+    readonly containerVersion: Schema.String;
+    readonly containerDigest: Schema.String;
+    readonly disclosureDigest: Schema.String;
+    readonly requestId: Schema.String;
+    readonly currency: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+    readonly operationId: Schema.String;
+    readonly containerId: Schema.String;
+    readonly containerVersion: Schema.String;
+    readonly containerDigest: Schema.String;
+    readonly dropId: Schema.String;
+    readonly rarity: Schema.String;
+    readonly previousMisses: Schema.Number;
+    readonly misses: Schema.Number;
+    readonly sequence: Schema.Number;
+    readonly at: Schema.Number;
+    readonly distribution: Schema.Struct<{
+        readonly entries: Schema.$Array<Schema.Struct<{
+            readonly dropId: Schema.String;
+            readonly weight: Schema.String;
+        }>>;
+        readonly total: Schema.String;
+        readonly guaranteed: Schema.Boolean;
+    }>;
+    readonly pricePaid: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"free">;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"virtual">;
+        readonly currency: Schema.String;
+        readonly amount: Schema.String;
+    }>]>;
+    readonly transfers: Schema.$Array<Schema.Struct<{
+        readonly txId: Schema.String;
+        readonly currency: Schema.String;
+        readonly amount: Schema.String;
+        readonly at: Schema.Number;
+    }>>;
+    readonly grants: Schema.$Array<Schema.Struct<{
+        readonly operationId: Schema.String;
+        readonly kind: Schema.Literal<"grant">;
+        readonly changes: Schema.$Array<Schema.Struct<{
+            readonly instanceId: Schema.String;
+            readonly delta: Schema.Number;
+        }>>;
+        readonly at: Schema.Number;
+    }>>;
+}>, typeof EconomyError>;
+
+/** Transport is the installed Shop buy action (e.g. useShopBuy().run). No new runtime. */
+export declare const createShopPurchaseRecovery: (journal: ShopPurchaseJournal, buy: (input: ShopBuyInput) => Promise<ShopOrderReceipt>) => ShopPurchaseRecovery;
+
+/** Callers connect the three installed action hooks. Retry stays explicit and keeps the Web Lock through settlement. */
+export declare const createTradeRecovery: (journal: TradeIntentionJournal, input: TradeIntentionTransport) => TradeRecovery;
+
+declare type EconomyAmountInput = string | number | bigint;
+
+/** Redacted codes; never carries owners, amounts or provider payloads. */
+declare class EconomyError extends EconomyError_base {
+}
+
+declare const EconomyError_base: Schema.Class<EconomyError, Schema.TaggedStruct<"EconomyError", {
+    readonly code: Schema.Literals<readonly ["invalid_currency", "invalid_amount", "overflow", "invalid_price", "real_money_disabled", "invalid_input", "invalid_record", "currency_cap_reached", "insufficient_funds", "conflict", "forbidden", "unavailable", "not_found", "erased", "limit_exceeded", "already_redeemed"]>;
+}>, YieldableError>;
+
+declare const iapEntitledDescriptor: QueryProcedureDescriptor<"economy.iap.entitled", Schema.Struct<{
+    readonly offerId: Schema.String;
+}>, Schema.Struct<{
+    readonly offerId: Schema.String;
+    readonly entitled: Schema.Boolean;
+    readonly expiresAt: Schema.NullOr<Schema.Number>;
+    readonly observedAt: Schema.Number;
+}>, typeof EconomyError>;
+
+declare const iapReceiptDescriptor: QueryProcedureDescriptor<"economy.iap.receipt", Schema.Struct<{
+    readonly receiptDigest: Schema.String;
+    readonly channel: Schema.Literals<readonly ["ios", "android", "steam", "web"]>;
+    readonly offerId: Schema.String;
+    readonly offerVersion: Schema.String;
+    readonly requestId: Schema.String;
+}>, Schema.Union<readonly [Schema.Struct<{
+    readonly requestId: Schema.String;
+    readonly state: Schema.Literals<readonly ["not-observed", "pending"]>;
+}>, Schema.Struct<{
+    readonly requestId: Schema.String;
+    readonly state: Schema.Literal<"fulfilled">;
+    readonly receipt: Schema.Struct<{
+        readonly orderId: Schema.String;
+        readonly offerId: Schema.String;
+        readonly offerVersion: Schema.String;
+        readonly quantity: Schema.Number;
+        readonly at: Schema.Number;
+        readonly pricePaid: Schema.NullOr<Schema.Struct<{
+            readonly currency: Schema.String;
+            readonly units: Schema.String;
+            readonly scale: Schema.Number;
+        }>>;
+        readonly transfers: Schema.$Array<Schema.Struct<{
+            readonly txId: Schema.String;
+            readonly currency: Schema.String;
+            readonly amount: Schema.String;
+            readonly at: Schema.Number;
+        }>>;
+        readonly grants: Schema.$Array<Schema.Struct<{
+            readonly operationId: Schema.String;
+            readonly kind: Schema.Literal<"grant">;
+            readonly changes: Schema.$Array<Schema.Struct<{
+                readonly instanceId: Schema.String;
+                readonly delta: Schema.Number;
+            }>>;
+            readonly at: Schema.Number;
+        }>>;
+    }>;
+    readonly refund: Schema.optional<Schema.Struct<{
+        readonly sequence: Schema.Number;
+        readonly state: Schema.Literals<readonly ["active", "partially-refunded", "revoked"]>;
+        readonly refundNumerator: Schema.Number;
+        readonly refundDenominator: Schema.Number;
+        readonly observedAt: Schema.Number;
+    }>>;
+}>, Schema.Struct<{
+    readonly requestId: Schema.String;
+    readonly state: Schema.Literals<readonly ["partially-refunded", "refunded"]>;
+    readonly receipt: Schema.Struct<{
+        readonly orderId: Schema.String;
+        readonly offerId: Schema.String;
+        readonly offerVersion: Schema.String;
+        readonly quantity: Schema.Number;
+        readonly at: Schema.Number;
+        readonly pricePaid: Schema.NullOr<Schema.Struct<{
+            readonly currency: Schema.String;
+            readonly units: Schema.String;
+            readonly scale: Schema.Number;
+        }>>;
+        readonly transfers: Schema.$Array<Schema.Struct<{
+            readonly txId: Schema.String;
+            readonly currency: Schema.String;
+            readonly amount: Schema.String;
+            readonly at: Schema.Number;
+        }>>;
+        readonly grants: Schema.$Array<Schema.Struct<{
+            readonly operationId: Schema.String;
+            readonly kind: Schema.Literal<"grant">;
+            readonly changes: Schema.$Array<Schema.Struct<{
+                readonly instanceId: Schema.String;
+                readonly delta: Schema.Number;
+            }>>;
+            readonly at: Schema.Number;
+        }>>;
+    }>;
+    readonly refund: Schema.Struct<{
+        readonly sequence: Schema.Number;
+        readonly state: Schema.Literals<readonly ["active", "partially-refunded", "revoked"]>;
+        readonly refundNumerator: Schema.Number;
+        readonly refundDenominator: Schema.Number;
+        readonly observedAt: Schema.Number;
+    }>;
+}>]>, typeof EconomyError>;
+
+declare const loyaltyMineDescriptor: QueryProcedureDescriptor<"economy.loyalty.mine", Schema.Struct<{
+    readonly loyaltyId: Schema.String;
+}>, Schema.Struct<{
+    readonly loyalty: Schema.Struct<{
+        readonly id: Schema.String;
+        readonly version: Schema.String;
+        readonly titleKey: Schema.String;
+        readonly decay: Schema.Literals<readonly ["none", "seasonal"]>;
+        readonly pointsFrom: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly kind: Schema.Literals<readonly ["purchase.real", "purchase.virtual"]>;
+            readonly currency: Schema.String;
+            readonly numerator: Schema.String;
+            readonly denominator: Schema.String;
+        }>>;
+        readonly tiers: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly at: Schema.String;
+            readonly perks: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+                readonly id: Schema.String;
+                readonly kind: Schema.Literals<readonly ["xpMultiplier", "discount"]>;
+                readonly bps: Schema.Number;
+            }>, Schema.Struct<{
+                readonly id: Schema.String;
+                readonly kind: Schema.Literal<"chatBadge">;
+                readonly badgeId: Schema.String;
+            }>, Schema.Struct<{
+                readonly id: Schema.String;
+                readonly kind: Schema.Literal<"inboxGift">;
+                readonly items: Schema.$Array<Schema.Struct<{
+                    readonly itemId: Schema.String;
+                    readonly qty: Schema.Number;
+                }>>;
+                readonly currencies: Schema.$Array<Schema.Struct<{
+                    readonly currency: Schema.String;
+                    readonly amount: Schema.String;
+                }>>;
+            }>]>>;
+        }>>;
+    }>;
+    readonly rulesVersion: Schema.String;
+    readonly seasonId: Schema.NullOr<Schema.String>;
+    readonly points: Schema.String;
+    readonly tierId: Schema.String;
+    readonly perks: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly id: Schema.String;
+        readonly kind: Schema.Literals<readonly ["xpMultiplier", "discount"]>;
+        readonly bps: Schema.Number;
+    }>, Schema.Struct<{
+        readonly id: Schema.String;
+        readonly kind: Schema.Literal<"chatBadge">;
+        readonly badgeId: Schema.String;
+    }>, Schema.Struct<{
+        readonly id: Schema.String;
+        readonly kind: Schema.Literal<"inboxGift">;
+        readonly items: Schema.$Array<Schema.Struct<{
+            readonly itemId: Schema.String;
+            readonly qty: Schema.Number;
+        }>>;
+        readonly currencies: Schema.$Array<Schema.Struct<{
+            readonly currency: Schema.String;
+            readonly amount: Schema.String;
+        }>>;
+    }>]>>;
+}>, typeof EconomyError>;
+
+declare const loyaltyReceiptDescriptor: QueryProcedureDescriptor<"economy.loyalty.receipt", Schema.Struct<{
+    readonly requestId: Schema.String;
+}>, Schema.Union<readonly [Schema.Struct<{
+    readonly requestId: Schema.String;
+    readonly state: Schema.Literal<"not-observed">;
+}>, Schema.Struct<{
+    readonly requestId: Schema.String;
+    readonly state: Schema.Literal<"fulfilled">;
+    readonly receipt: Schema.Struct<{
+        readonly operationId: Schema.String;
+        readonly requestId: Schema.String;
+        readonly loyaltyId: Schema.String;
+        readonly entry: Schema.Union<readonly [Schema.Struct<{
+            readonly kind: Schema.Literal<"credit">;
+            readonly sourceId: Schema.String;
+            readonly purchaseId: Schema.String;
+            readonly purchaseAmount: Schema.String;
+            readonly numerator: Schema.String;
+            readonly denominator: Schema.String;
+            readonly id: Schema.String;
+            readonly sequence: Schema.Number;
+            readonly at: Schema.Number;
+            readonly seasonId: Schema.NullOr<Schema.String>;
+            readonly delta: Schema.String;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"reverse">;
+            readonly originalId: Schema.String;
+            readonly refundId: Schema.String;
+            readonly totalRefunded: Schema.String;
+            readonly id: Schema.String;
+            readonly sequence: Schema.Number;
+            readonly at: Schema.Number;
+            readonly seasonId: Schema.NullOr<Schema.String>;
+            readonly delta: Schema.String;
+        }>]>;
+        readonly points: Schema.String;
+    }>;
+}>]>, typeof EconomyError>;
+
+declare const piggyReceiptDescriptor: QueryProcedureDescriptor<"economy.piggyBanks.receipt", Schema.Struct<{
+    readonly requestId: Schema.String;
+}>, Schema.Union<readonly [Schema.Struct<{
+    readonly requestId: Schema.String;
+    readonly state: Schema.Literal<"not-observed">;
+}>, Schema.Struct<{
+    readonly requestId: Schema.String;
+    readonly state: Schema.Literal<"fulfilled">;
+    readonly receipt: Schema.Union<readonly [Schema.Struct<{
+        readonly event: Schema.Struct<{
+            readonly kind: Schema.Literal<"fill">;
+            readonly authorityId: Schema.String;
+            readonly eventId: Schema.String;
+            readonly sourceId: Schema.String;
+            readonly acceptedAmount: Schema.String;
+            readonly delta: Schema.String;
+            readonly id: Schema.String;
+            readonly sequence: Schema.Number;
+            readonly at: Schema.Number;
+        }>;
+        readonly operationId: Schema.String;
+        readonly requestId: Schema.String;
+        readonly bankId: Schema.String;
+        readonly available: Schema.String;
+    }>, Schema.Struct<{
+        readonly event: Schema.Struct<{
+            readonly kind: Schema.Literal<"unlock">;
+            readonly amount: Schema.String;
+            readonly remaining: Schema.String;
+            readonly id: Schema.String;
+            readonly sequence: Schema.Number;
+            readonly at: Schema.Number;
+        }>;
+        readonly value: Schema.Struct<{
+            readonly orderId: Schema.String;
+            readonly offerId: Schema.String;
+            readonly offerVersion: Schema.String;
+            readonly offerDigest: Schema.String;
+            readonly quantity: Schema.Number;
+            readonly at: Schema.Number;
+            readonly pricePaid: Schema.Union<readonly [Schema.Struct<{
+                readonly kind: Schema.Literal<"free">;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"virtual">;
+                readonly currency: Schema.String;
+                readonly amount: Schema.String;
+            }>]>;
+            readonly transfers: Schema.$Array<Schema.Struct<{
+                readonly txId: Schema.String;
+                readonly currency: Schema.String;
+                readonly amount: Schema.String;
+                readonly at: Schema.Number;
+            }>>;
+            readonly grants: Schema.$Array<Schema.Struct<{
+                readonly operationId: Schema.String;
+                readonly kind: Schema.Literal<"grant">;
+                readonly changes: Schema.$Array<Schema.Struct<{
+                    readonly instanceId: Schema.String;
+                    readonly delta: Schema.Number;
+                }>>;
+                readonly at: Schema.Number;
+            }>>;
+        }>;
+        readonly operationId: Schema.String;
+        readonly requestId: Schema.String;
+        readonly bankId: Schema.String;
+        readonly available: Schema.String;
+    }>]>;
+}>]>, typeof EconomyError>;
+
+declare const shopBuyDescriptor: ActionProcedureDescriptor<"shop.buy", Schema.Struct<{
+    readonly offerId: Schema.String;
+    readonly offerVersion: Schema.String;
+    readonly offerDigest: Schema.String;
+    readonly requestId: Schema.String;
+    readonly currency: Schema.optional<Schema.String>;
+    readonly qty: Schema.optional<Schema.Number>;
+}>, Schema.Struct<{
+    readonly orderId: Schema.String;
+    readonly offerId: Schema.String;
+    readonly offerVersion: Schema.String;
+    readonly offerDigest: Schema.String;
+    readonly quantity: Schema.Number;
+    readonly at: Schema.Number;
+    readonly pricePaid: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"free">;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"virtual">;
+        readonly currency: Schema.String;
+        readonly amount: Schema.String;
+    }>]>;
+    readonly transfers: Schema.$Array<Schema.Struct<{
+        readonly txId: Schema.String;
+        readonly currency: Schema.String;
+        readonly amount: Schema.String;
+        readonly at: Schema.Number;
+    }>>;
+    readonly grants: Schema.$Array<Schema.Struct<{
+        readonly operationId: Schema.String;
+        readonly kind: Schema.Literal<"grant">;
+        readonly changes: Schema.$Array<Schema.Struct<{
+            readonly instanceId: Schema.String;
+            readonly delta: Schema.Number;
+        }>>;
+        readonly at: Schema.Number;
+    }>>;
+}>, typeof EconomyError>;
+
+declare interface ShopBuyInput {
+    readonly offerId: string;
+    readonly offerVersion: string;
+    readonly offerDigest: string;
+    readonly requestId: string;
+    readonly currency?: string | undefined;
+    readonly qty?: number | undefined;
+}
+
+declare interface ShopOrderReceipt {
+    readonly orderId: string;
+    readonly offerId: string;
+    readonly offerVersion: string;
+    readonly offerDigest: string;
+    readonly quantity: number;
+    readonly at: number;
+    readonly pricePaid: {
+        readonly kind: 'free';
+    } | {
+        readonly kind: 'virtual';
+        readonly currency: string;
+        readonly amount: string;
+    };
+    readonly transfers: readonly {
+        readonly txId: string;
+        readonly currency: string;
+        readonly amount: string;
+        readonly at: number;
+    }[];
+    readonly grants: readonly {
+        readonly operationId: string;
+        readonly kind: 'grant';
+        readonly changes: readonly {
+            readonly instanceId: string;
+            readonly delta: number;
+        }[];
+        readonly at: number;
+    }[];
+}
+
+/** The implementation must hold one cross-tab lock through the entire callback. */
+export declare interface ShopPurchaseJournal {
+    readonly withLocked: <A>(scope: string, work: (slot: ShopPurchaseSlot) => Promise<A>) => Promise<A>;
+}
+
+/** Nonterminal observations never authorize a new request identity or prove that no purchase can commit. */
+declare type ShopPurchaseObservation = {
+    readonly requestId: string;
+    readonly state: 'not-observed' | 'pending';
+} | {
+    readonly requestId: string;
+    readonly state: 'fulfilled';
+    readonly receipt: ShopOrderReceipt;
+};
+
+export declare interface ShopPurchaseRecovery {
+    /** Every call invalidates queued/in-flight continuations, even away then back. */
+    readonly selectScope: (scope: string | undefined) => void;
+    readonly pending: () => Promise<ShopPurchaseReference | undefined>;
+    /** A user selects an intention; durably acknowledge it before any transport. */
+    readonly begin: (input: ShopBuyInput) => Promise<ShopPurchaseReference>;
+    /** Explicit retry of the saved intention; never automatic replay or a fresh ID. */
+    readonly retry: (original: ShopBuyInput) => Promise<ShopOrderReceipt>;
+    readonly observe: (input: ShopPurchaseObservation) => Promise<ShopPurchaseReference | undefined>;
+}
+
+export declare interface ShopPurchaseReference {
+    readonly version: 1;
+    /** Stable app + authenticated account/tenant scope; no endpoint credentials. */
+    readonly scope: string;
+    readonly request: ShopBuyInput;
+}
+
+export declare interface ShopPurchaseSlot {
+    readonly read: () => ShopPurchaseReference | undefined;
+    readonly write: (reference: ShopPurchaseReference) => void;
+    readonly clear: (reference: ShopPurchaseReference) => void;
+}
+
+declare const subscriptionReceiptDescriptor: QueryProcedureDescriptor<"economy.subscriptions.receipt", Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"start">;
+    readonly intent: Schema.Struct<{
+        readonly subscriptionId: Schema.String;
+        readonly subscriptionVersion: Schema.String;
+        readonly subscriptionDigest: Schema.String;
+        readonly requestId: Schema.String;
+        readonly currency: Schema.optional<Schema.String>;
+    }>;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literals<readonly ["renew", "daily", "cancel"]>;
+    readonly intent: Schema.Struct<{
+        readonly entitlementId: Schema.String;
+        readonly requestId: Schema.String;
+    }>;
+}>]>, Schema.Union<readonly [Schema.Struct<{
+    readonly requestId: Schema.String;
+    readonly state: Schema.Literal<"not-observed">;
+}>, Schema.Struct<{
+    readonly requestId: Schema.String;
+    readonly state: Schema.Literal<"fulfilled">;
+    readonly receipt: Schema.Union<readonly [Schema.Struct<{
+        readonly operationId: Schema.String;
+        readonly entitlementId: Schema.String;
+        readonly kind: Schema.Literals<readonly ["start", "renew", "daily"]>;
+        readonly at: Schema.Number;
+        readonly periodIndex: Schema.Number;
+        readonly day: Schema.NullOr<Schema.Number>;
+        readonly window: Schema.Struct<{
+            readonly startsAt: Schema.Number;
+            readonly expiresAt: Schema.Number;
+            readonly graceUntil: Schema.Number;
+            readonly state: Schema.Literals<readonly ["active", "grace", "expired"]>;
+        }>;
+        readonly value: Schema.Struct<{
+            readonly orderId: Schema.String;
+            readonly offerId: Schema.String;
+            readonly offerVersion: Schema.String;
+            readonly offerDigest: Schema.String;
+            readonly quantity: Schema.Number;
+            readonly at: Schema.Number;
+            readonly pricePaid: Schema.Union<readonly [Schema.Struct<{
+                readonly kind: Schema.Literal<"free">;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"virtual">;
+                readonly currency: Schema.String;
+                readonly amount: Schema.String;
+            }>]>;
+            readonly transfers: Schema.$Array<Schema.Struct<{
+                readonly txId: Schema.String;
+                readonly currency: Schema.String;
+                readonly amount: Schema.String;
+                readonly at: Schema.Number;
+            }>>;
+            readonly grants: Schema.$Array<Schema.Struct<{
+                readonly operationId: Schema.String;
+                readonly kind: Schema.Literal<"grant">;
+                readonly changes: Schema.$Array<Schema.Struct<{
+                    readonly instanceId: Schema.String;
+                    readonly delta: Schema.Number;
+                }>>;
+                readonly at: Schema.Number;
+            }>>;
+        }>;
+    }>, Schema.Struct<{
+        readonly operationId: Schema.String;
+        readonly entitlementId: Schema.String;
+        readonly at: Schema.Number;
+        readonly renews: Schema.Literal<false>;
+    }>]>;
+}>]>, typeof EconomyError>;
+
+declare interface TradeAcceptInput {
+    readonly tradeId: string;
+    readonly tradeDigest: string;
+    readonly requestId: string;
+}
+
+declare interface TradeCurrencyIntention {
+    readonly currency: string;
+    readonly amount: EconomyAmountInput;
+}
+
+export declare type TradeIntention = {
+    readonly kind: 'propose';
+    readonly input: TradeProposeInput;
+} | {
+    readonly kind: 'accept';
+    readonly input: TradeAcceptInput;
+} | {
+    readonly kind: 'cancel';
+    readonly input: {
+        readonly tradeId: string;
+        readonly requestId: string;
+    };
+};
+
+export declare interface TradeIntentionJournal {
+    readonly withLocked: <A>(scope: string, work: (slot: TradeIntentionSlot) => Promise<A>) => Promise<A>;
+}
+
+export declare interface TradeIntentionReference {
+    readonly version: 1;
+    readonly scope: string;
+    readonly request: TradeIntention;
+}
+
+export declare interface TradeIntentionSlot {
+    readonly read: () => TradeIntentionReference | undefined;
+    readonly write: (reference: TradeIntentionReference) => void;
+    readonly clear: (reference: TradeIntentionReference) => void;
+}
+
+export declare interface TradeIntentionTransport {
+    readonly propose: (input: ReturnType<typeof captureTradeProposeIntention>) => Promise<TradeReceipt>;
+    readonly accept: (input: TradeAcceptInput) => Promise<TradeReceipt>;
+    readonly cancel: (input: {
+        readonly tradeId: string;
+        readonly requestId: string;
+    }) => Promise<TradeReceipt>;
+}
+
+declare interface TradeItemIntention {
+    readonly instanceId: string;
+    readonly qty: number;
+}
+
+declare interface TradeLeg {
+    readonly items: readonly TradeItemIntention[];
+    readonly currencies: readonly {
+        readonly currency: string;
+        readonly amount: string;
+    }[];
+}
+
+declare interface TradeLegDefinition {
+    readonly items: readonly TradeItemIntention[];
+    readonly currencies: readonly TradeCurrencyIntention[];
+}
+
+declare type TradeObservation = {
+    readonly requestId: string;
+    readonly state: 'not-observed';
+} | {
+    readonly requestId: string;
+    readonly state: 'fulfilled';
+    readonly receipt: TradeReceipt;
+};
+
+declare interface TradeProposeInput {
+    readonly toId: string | null;
+    readonly offered: TradeLegDefinition;
+    readonly requested: TradeLegDefinition;
+    readonly durationMs: number;
+    readonly requestId: string;
+}
+
+declare interface TradeReceipt {
+    readonly operationId: string;
+    readonly requestId: string;
+    readonly trade: TradeView;
+}
+
+declare const tradeReceiptDescriptor: QueryProcedureDescriptor<"economy.trades.receipt", Schema.Struct<{
+    readonly requestId: Schema.String;
+}>, Schema.Union<readonly [Schema.Struct<{
+    readonly requestId: Schema.String;
+    readonly state: Schema.Literal<"not-observed">;
+}>, Schema.Struct<{
+    readonly requestId: Schema.String;
+    readonly state: Schema.Literal<"fulfilled">;
+    readonly receipt: Schema.Struct<{
+        readonly operationId: Schema.String;
+        readonly requestId: Schema.String;
+        readonly trade: Schema.Struct<{
+            readonly tradeId: Schema.String;
+            readonly tradeDigest: Schema.String;
+            readonly proposerId: Schema.String;
+            readonly toId: Schema.NullOr<Schema.String>;
+            readonly offered: Schema.Struct<{
+                readonly items: Schema.$Array<Schema.Struct<{
+                    readonly instanceId: Schema.String;
+                    readonly qty: Schema.Number;
+                }>>;
+                readonly currencies: Schema.$Array<Schema.Struct<{
+                    readonly currency: Schema.String;
+                    readonly amount: Schema.String;
+                }>>;
+            }>;
+            readonly requested: Schema.Struct<{
+                readonly items: Schema.$Array<Schema.Struct<{
+                    readonly instanceId: Schema.String;
+                    readonly qty: Schema.Number;
+                }>>;
+                readonly currencies: Schema.$Array<Schema.Struct<{
+                    readonly currency: Schema.String;
+                    readonly amount: Schema.String;
+                }>>;
+            }>;
+            readonly createdAt: Schema.Number;
+            readonly expiresAt: Schema.Number;
+            readonly state: Schema.Literals<readonly ["proposed", "accepted", "cancelled", "expired"]>;
+            readonly accepterId: Schema.NullOr<Schema.String>;
+            readonly rulesVersion: Schema.String;
+            readonly taxes: Schema.$Array<Schema.Struct<{
+                readonly leg: Schema.Literals<readonly ["offered", "requested"]>;
+                readonly currency: Schema.String;
+                readonly gross: Schema.String;
+                readonly net: Schema.String;
+                readonly tax: Schema.String;
+            }>>;
+        }>;
+    }>;
+}>]>, typeof EconomyError>;
+
+export declare interface TradeRecovery {
+    readonly selectScope: (scope: string | undefined) => void;
+    readonly pending: () => Promise<TradeIntentionReference | undefined>;
+    readonly begin: (intention: TradeIntention) => Promise<TradeIntentionReference>;
+    readonly retry: (original: TradeIntention) => Promise<TradeReceipt>;
+    readonly observe: (observation: TradeObservation) => Promise<TradeIntentionReference | undefined>;
+}
+
+declare interface TradeTaxView {
+    readonly leg: 'offered' | 'requested';
+    readonly currency: string;
+    readonly gross: string;
+    readonly net: string;
+    readonly tax: string;
+}
+
+declare interface TradeView {
+    readonly tradeId: string;
+    readonly tradeDigest: string;
+    readonly proposerId: string;
+    readonly toId: string | null;
+    readonly offered: TradeLeg;
+    readonly requested: TradeLeg;
+    readonly createdAt: number;
+    readonly expiresAt: number;
+    readonly state: 'proposed' | 'accepted' | 'cancelled' | 'expired';
+    readonly accepterId: string | null;
+    readonly rulesVersion: string;
+    readonly taxes: readonly TradeTaxView[];
+}
+
+export declare const useAcceptTrade: (apiName?: string) => ActionState<{
+    readonly tradeId: string;
+    readonly tradeDigest: string;
+    readonly requestId: string;
+}, {
+    readonly operationId: string;
+    readonly requestId: string;
+    readonly trade: {
+        readonly tradeId: string;
+        readonly tradeDigest: string;
+        readonly proposerId: string;
+        readonly toId: string | null;
+        readonly offered: {
+            readonly items: readonly {
+                readonly instanceId: string;
+                readonly qty: number;
+            }[];
+            readonly currencies: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        };
+        readonly requested: {
+            readonly items: readonly {
+                readonly instanceId: string;
+                readonly qty: number;
+            }[];
+            readonly currencies: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        };
+        readonly createdAt: number;
+        readonly expiresAt: number;
+        readonly state: "expired" | "cancelled" | "accepted" | "proposed";
+        readonly accepterId: string | null;
+        readonly rulesVersion: string;
+        readonly taxes: readonly {
+            readonly leg: "requested" | "offered";
+            readonly currency: string;
+            readonly gross: string;
+            readonly net: string;
+            readonly tax: string;
+        }[];
+    };
+}>;
+
+export declare const useActiveSubscriptions: (apiName?: string) => SubscriptionState<readonly {
+    readonly entitlementId: string;
+    readonly subscription: {
+        readonly id: string;
+        readonly version: string;
+        readonly titleKey: string;
+        readonly price: {
+            readonly kind: "free";
+        } | {
+            readonly kind: "virtual";
+            readonly options: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        } | {
+            readonly prices: {
+                readonly [x: string]: number;
+            };
+            readonly storeProductIds: {
+                readonly [x: string]: string;
+            };
+            readonly kind: "real";
+        } | {
+            readonly kind: "mixed";
+            readonly real: {
+                readonly prices: {
+                    readonly [x: string]: number;
+                };
+                readonly storeProductIds: {
+                    readonly [x: string]: string;
+                };
+            };
+            readonly virtual: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        };
+        readonly period: {
+            readonly unit: "day" | "week" | "month";
+            readonly count: number;
+        };
+        readonly grants: {
+            readonly onPurchase: {
+                readonly items: readonly {
+                    readonly itemId: string;
+                    readonly qty: number;
+                }[];
+                readonly currencies: readonly {
+                    readonly currency: string;
+                    readonly amount: string;
+                }[];
+            };
+            readonly daily: {
+                readonly items: readonly {
+                    readonly itemId: string;
+                    readonly qty: number;
+                }[];
+                readonly currencies: readonly {
+                    readonly currency: string;
+                    readonly amount: string;
+                }[];
+            };
+        };
+        readonly graceDays: number;
+        readonly coolingOff: {
+            readonly days: number;
+            readonly overrideReason: string | null;
+        };
+        readonly disclosure: {
+            readonly durationKey: string;
+            readonly renewalKey: string;
+            readonly cancellationPath: string;
+        };
+    };
+    readonly subscriptionDigest: string;
+    readonly originAt: number;
+    readonly periodIndex: number;
+    readonly window: {
+        readonly startsAt: number;
+        readonly expiresAt: number;
+        readonly graceUntil: number;
+        readonly state: "expired" | "active" | "grace";
+    };
+    readonly currency: string | null;
+    readonly renews: boolean;
+    readonly cancelledAt: number | null;
+}[]>;
+
+export declare const useCancelSubscription: (apiName?: string) => ActionState<{
+    readonly entitlementId: string;
+    readonly requestId: string;
+}, {
+    readonly operationId: string;
+    readonly entitlementId: string;
+    readonly at: number;
+    readonly renews: false;
+}>;
+
+export declare const useCancelTrade: (apiName?: string) => ActionState<{
+    readonly tradeId: string;
+    readonly requestId: string;
+}, {
+    readonly operationId: string;
+    readonly requestId: string;
+    readonly trade: {
+        readonly tradeId: string;
+        readonly tradeDigest: string;
+        readonly proposerId: string;
+        readonly toId: string | null;
+        readonly offered: {
+            readonly items: readonly {
+                readonly instanceId: string;
+                readonly qty: number;
+            }[];
+            readonly currencies: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        };
+        readonly requested: {
+            readonly items: readonly {
+                readonly instanceId: string;
+                readonly qty: number;
+            }[];
+            readonly currencies: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        };
+        readonly createdAt: number;
+        readonly expiresAt: number;
+        readonly state: "expired" | "cancelled" | "accepted" | "proposed";
+        readonly accepterId: string | null;
+        readonly rulesVersion: string;
+        readonly taxes: readonly {
+            readonly leg: "requested" | "offered";
+            readonly currency: string;
+            readonly gross: string;
+            readonly net: string;
+            readonly tax: string;
+        }[];
+    };
+}>;
+
+/** Explicit fresh server read, including after the observed expiry deadline. */
+export declare const useCheckIapEntitlement: (apiName?: string) => ActionState<{
+    readonly offerId: string;
+}, {
+    readonly offerId: string;
+    readonly entitled: boolean;
+    readonly expiresAt: number | null;
+    readonly observedAt: number;
+}>;
+
+export declare const useClaimSubscriptionDaily: (apiName?: string) => ActionState<{
+    readonly entitlementId: string;
+    readonly requestId: string;
+}, {
+    readonly operationId: string;
+    readonly entitlementId: string;
+    readonly kind: "start" | "daily" | "renew";
+    readonly at: number;
+    readonly periodIndex: number;
+    readonly day: number | null;
+    readonly window: {
+        readonly startsAt: number;
+        readonly expiresAt: number;
+        readonly graceUntil: number;
+        readonly state: "expired" | "active" | "grace";
+    };
+    readonly value: {
+        readonly orderId: string;
+        readonly offerId: string;
+        readonly offerVersion: string;
+        readonly offerDigest: string;
+        readonly quantity: number;
+        readonly at: number;
+        readonly pricePaid: {
+            readonly kind: "free";
+        } | {
+            readonly kind: "virtual";
+            readonly currency: string;
+            readonly amount: string;
+        };
+        readonly transfers: readonly {
+            readonly txId: string;
+            readonly currency: string;
+            readonly amount: string;
+            readonly at: number;
+        }[];
+        readonly grants: readonly {
+            readonly operationId: string;
+            readonly kind: "grant";
+            readonly changes: readonly {
+                readonly instanceId: string;
+                readonly delta: number;
+            }[];
+            readonly at: number;
+        }[];
+    };
+}>;
+
+/** Keep the original request until a fulfilled receipt is observed. This hook
+ * does not persist code values or create a durable browser recovery journal. */
+export declare const useCodeReceipt: (input: typeof codesRedeemDescriptor.input.Type | undefined, apiName?: string) => SubscriptionIdle | SubscriptionState<{
+    readonly requestId: string;
+    readonly state: "pending" | "not-observed";
+} | {
+    readonly requestId: string;
+    readonly state: "fulfilled";
+    readonly receipt: {
+        readonly operationId: string;
+        readonly codeId: string;
+        readonly version: string;
+        readonly campaign: string;
+        readonly at: number;
+        readonly transfers: readonly {
+            readonly txId: string;
+            readonly currency: string;
+            readonly amount: string;
+            readonly at: number;
+        }[];
+        readonly grants: readonly {
+            readonly operationId: string;
+            readonly kind: "grant";
+            readonly changes: readonly {
+                readonly instanceId: string;
+                readonly delta: number;
+            }[];
+            readonly at: number;
+        }[];
+    };
+}>;
+
+/** Explicit original-intention retry. Availability follows the configured channel completion authority. */
+export declare const useCompleteIap: (apiName?: string) => ActionState<{
+    readonly receipt: string;
+    readonly channel: "web" | "ios" | "android" | "steam";
+    readonly offerId: string;
+    readonly offerVersion: string;
+    readonly requestId: string;
+}, {
+    readonly orderId: string;
+    readonly channel: "web" | "ios" | "android" | "steam";
+    readonly operation: "finish" | "finalize" | "acknowledge" | "consume";
+    readonly observedAt: number;
+}>;
+
+export declare const useContainerReceipt: (input: typeof containerOpenDescriptor.input.Type | undefined, apiName?: string) => SubscriptionIdle | SubscriptionState<{
+    readonly requestId: string;
+    readonly state: "pending" | "not-observed";
+} | {
+    readonly requestId: string;
+    readonly state: "fulfilled";
+    readonly receipt: {
+        readonly operationId: string;
+        readonly containerId: string;
+        readonly containerVersion: string;
+        readonly containerDigest: string;
+        readonly dropId: string;
+        readonly rarity: string;
+        readonly previousMisses: number;
+        readonly misses: number;
+        readonly sequence: number;
+        readonly at: number;
+        readonly distribution: {
+            readonly entries: readonly {
+                readonly dropId: string;
+                readonly weight: string;
+            }[];
+            readonly total: string;
+            readonly guaranteed: boolean;
+        };
+        readonly pricePaid: {
+            readonly kind: "free";
+        } | {
+            readonly kind: "virtual";
+            readonly currency: string;
+            readonly amount: string;
+        };
+        readonly transfers: readonly {
+            readonly txId: string;
+            readonly currency: string;
+            readonly amount: string;
+            readonly at: number;
+        }[];
+        readonly grants: readonly {
+            readonly operationId: string;
+            readonly kind: "grant";
+            readonly changes: readonly {
+                readonly instanceId: string;
+                readonly delta: number;
+            }[];
+            readonly at: number;
+        }[];
+    };
+}>;
+
+export declare const useContainers: (apiName?: string) => SubscriptionState<readonly {
+    readonly container: {
+        readonly id: string;
+        readonly version: string;
+        readonly group: string;
+        readonly price: {
+            readonly kind: "free";
+        } | {
+            readonly kind: "virtual";
+            readonly options: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        } | {
+            readonly prices: {
+                readonly [x: string]: number;
+            };
+            readonly storeProductIds: {
+                readonly [x: string]: string;
+            };
+            readonly kind: "real";
+        } | {
+            readonly kind: "mixed";
+            readonly real: {
+                readonly prices: {
+                    readonly [x: string]: number;
+                };
+                readonly storeProductIds: {
+                    readonly [x: string]: string;
+                };
+            };
+            readonly virtual: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        };
+        readonly countries: readonly string[];
+        readonly drops: readonly {
+            readonly id: string;
+            readonly rarity: string;
+            readonly weight: string;
+            readonly items: readonly {
+                readonly itemId: string;
+                readonly qty: number;
+            }[];
+            readonly currencies: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        }[];
+        readonly pity: {
+            readonly guaranteed: string;
+            readonly after: number;
+            readonly softFrom: number | null;
+            readonly softRampBps: number;
+        } | null;
+    };
+    readonly containerDigest: string;
+    readonly disclosureDigest: string;
+    readonly misses: number;
+    readonly price: {
+        readonly kind: "free";
+    } | {
+        readonly kind: "virtual";
+        readonly options: readonly {
+            readonly currency: string;
+            readonly amount: string;
+        }[];
+    } | {
+        readonly prices: {
+            readonly [x: string]: number;
+        };
+        readonly storeProductIds: {
+            readonly [x: string]: string;
+        };
+        readonly kind: "real";
+    } | {
+        readonly kind: "mixed";
+        readonly real: {
+            readonly prices: {
+                readonly [x: string]: number;
+            };
+            readonly storeProductIds: {
+                readonly [x: string]: string;
+            };
+        };
+        readonly virtual: readonly {
+            readonly currency: string;
+            readonly amount: string;
+        }[];
+    };
+    readonly disclosure: {
+        readonly guaranteed: boolean;
+        readonly probabilities: readonly {
+            readonly dropId: string;
+            readonly numerator: string;
+            readonly denominator: string;
+        }[];
+    };
+}[]>;
+
+export declare const useIapAccount: (apiName?: string) => ActionState<{
+    readonly channel: "web" | "ios" | "android" | "steam";
+}, string>;
+
+/** SQL changes invalidate this observation; a clock deadline alone does not. */
+export declare const useIapEntitlement: (input: typeof iapEntitledDescriptor.input.Type | undefined, apiName?: string) => SubscriptionIdle | SubscriptionState<{
+    readonly offerId: string;
+    readonly entitled: boolean;
+    readonly expiresAt: number | null;
+    readonly observedAt: number;
+}>;
+
+/** Hash-only observation; no raw receipt, automatic retry or browser journal. */
+export declare const useIapReceipt: (input: typeof iapReceiptDescriptor.input.Type | undefined, apiName?: string) => SubscriptionIdle | SubscriptionState<{
+    readonly requestId: string;
+    readonly state: "pending" | "not-observed";
+} | {
+    readonly state: "fulfilled";
+    readonly requestId: string;
+    readonly receipt: {
+        readonly orderId: string;
+        readonly offerId: string;
+        readonly offerVersion: string;
+        readonly quantity: number;
+        readonly at: number;
+        readonly pricePaid: {
+            readonly currency: string;
+            readonly units: string;
+            readonly scale: number;
+        } | null;
+        readonly transfers: readonly {
+            readonly txId: string;
+            readonly currency: string;
+            readonly amount: string;
+            readonly at: number;
+        }[];
+        readonly grants: readonly {
+            readonly operationId: string;
+            readonly kind: "grant";
+            readonly changes: readonly {
+                readonly instanceId: string;
+                readonly delta: number;
+            }[];
+            readonly at: number;
+        }[];
+    };
+    readonly refund?: {
+        readonly sequence: number;
+        readonly state: "revoked" | "active" | "partially-refunded";
+        readonly refundNumerator: number;
+        readonly refundDenominator: number;
+        readonly observedAt: number;
+    } | undefined;
+} | {
+    readonly requestId: string;
+    readonly state: "partially-refunded" | "refunded";
+    readonly receipt: {
+        readonly orderId: string;
+        readonly offerId: string;
+        readonly offerVersion: string;
+        readonly quantity: number;
+        readonly at: number;
+        readonly pricePaid: {
+            readonly currency: string;
+            readonly units: string;
+            readonly scale: number;
+        } | null;
+        readonly transfers: readonly {
+            readonly txId: string;
+            readonly currency: string;
+            readonly amount: string;
+            readonly at: number;
+        }[];
+        readonly grants: readonly {
+            readonly operationId: string;
+            readonly kind: "grant";
+            readonly changes: readonly {
+                readonly instanceId: string;
+                readonly delta: number;
+            }[];
+            readonly at: number;
+        }[];
+    };
+    readonly refund: {
+        readonly sequence: number;
+        readonly state: "revoked" | "active" | "partially-refunded";
+        readonly refundNumerator: number;
+        readonly refundDenominator: number;
+        readonly observedAt: number;
+    };
+}>;
+
+export declare const useLoyalty: (input: typeof loyaltyMineDescriptor.input.Type | undefined, apiName?: string) => SubscriptionIdle | SubscriptionState<{
+    readonly loyalty: {
+        readonly id: string;
+        readonly version: string;
+        readonly titleKey: string;
+        readonly decay: "none" | "seasonal";
+        readonly pointsFrom: readonly {
+            readonly id: string;
+            readonly kind: "purchase.real" | "purchase.virtual";
+            readonly currency: string;
+            readonly numerator: string;
+            readonly denominator: string;
+        }[];
+        readonly tiers: readonly {
+            readonly id: string;
+            readonly at: string;
+            readonly perks: readonly ({
+                readonly id: string;
+                readonly kind: "xpMultiplier" | "discount";
+                readonly bps: number;
+            } | {
+                readonly id: string;
+                readonly kind: "chatBadge";
+                readonly badgeId: string;
+            } | {
+                readonly id: string;
+                readonly kind: "inboxGift";
+                readonly items: readonly {
+                    readonly itemId: string;
+                    readonly qty: number;
+                }[];
+                readonly currencies: readonly {
+                    readonly currency: string;
+                    readonly amount: string;
+                }[];
+            })[];
+        }[];
+    };
+    readonly rulesVersion: string;
+    readonly seasonId: string | null;
+    readonly points: string;
+    readonly tierId: string;
+    readonly perks: readonly ({
+        readonly id: string;
+        readonly kind: "xpMultiplier" | "discount";
+        readonly bps: number;
+    } | {
+        readonly id: string;
+        readonly kind: "chatBadge";
+        readonly badgeId: string;
+    } | {
+        readonly id: string;
+        readonly kind: "inboxGift";
+        readonly items: readonly {
+            readonly itemId: string;
+            readonly qty: number;
+        }[];
+        readonly currencies: readonly {
+            readonly currency: string;
+            readonly amount: string;
+        }[];
+    })[];
+}>;
+
+export declare const useLoyaltyPrograms: (apiName?: string) => SubscriptionState<readonly {
+    readonly id: string;
+    readonly version: string;
+    readonly titleKey: string;
+    readonly decay: "none" | "seasonal";
+    readonly pointsFrom: readonly {
+        readonly id: string;
+        readonly kind: "purchase.real" | "purchase.virtual";
+        readonly currency: string;
+        readonly numerator: string;
+        readonly denominator: string;
+    }[];
+    readonly tiers: readonly {
+        readonly id: string;
+        readonly at: string;
+        readonly perks: readonly ({
+            readonly id: string;
+            readonly kind: "xpMultiplier" | "discount";
+            readonly bps: number;
+        } | {
+            readonly id: string;
+            readonly kind: "chatBadge";
+            readonly badgeId: string;
+        } | {
+            readonly id: string;
+            readonly kind: "inboxGift";
+            readonly items: readonly {
+                readonly itemId: string;
+                readonly qty: number;
+            }[];
+            readonly currencies: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        })[];
+    }[];
+}[]>;
+
+export declare const useLoyaltyReceipt: (input: typeof loyaltyReceiptDescriptor.input.Type | undefined, apiName?: string) => SubscriptionIdle | SubscriptionState<{
+    readonly requestId: string;
+    readonly state: "not-observed";
+} | {
+    readonly requestId: string;
+    readonly state: "fulfilled";
+    readonly receipt: {
+        readonly operationId: string;
+        readonly requestId: string;
+        readonly loyaltyId: string;
+        readonly entry: {
+            readonly kind: "credit";
+            readonly sourceId: string;
+            readonly purchaseId: string;
+            readonly purchaseAmount: string;
+            readonly numerator: string;
+            readonly denominator: string;
+            readonly id: string;
+            readonly sequence: number;
+            readonly at: number;
+            readonly seasonId: string | null;
+            readonly delta: string;
+        } | {
+            readonly kind: "reverse";
+            readonly originalId: string;
+            readonly refundId: string;
+            readonly totalRefunded: string;
+            readonly id: string;
+            readonly sequence: number;
+            readonly at: number;
+            readonly seasonId: string | null;
+            readonly delta: string;
+        };
+        readonly points: string;
+    };
+}>;
+
+export declare const useOpenContainer: (apiName?: string) => ActionState<{
+    readonly requestId: string;
+    readonly containerDigest: string;
+    readonly disclosureDigest: string;
+    readonly containerId: string;
+    readonly containerVersion: string;
+    readonly currency?: string | undefined;
+}, {
+    readonly operationId: string;
+    readonly containerId: string;
+    readonly containerVersion: string;
+    readonly containerDigest: string;
+    readonly dropId: string;
+    readonly rarity: string;
+    readonly previousMisses: number;
+    readonly misses: number;
+    readonly sequence: number;
+    readonly at: number;
+    readonly distribution: {
+        readonly entries: readonly {
+            readonly dropId: string;
+            readonly weight: string;
+        }[];
+        readonly total: string;
+        readonly guaranteed: boolean;
+    };
+    readonly pricePaid: {
+        readonly kind: "free";
+    } | {
+        readonly kind: "virtual";
+        readonly currency: string;
+        readonly amount: string;
+    };
+    readonly transfers: readonly {
+        readonly txId: string;
+        readonly currency: string;
+        readonly amount: string;
+        readonly at: number;
+    }[];
+    readonly grants: readonly {
+        readonly operationId: string;
+        readonly kind: "grant";
+        readonly changes: readonly {
+            readonly instanceId: string;
+            readonly delta: number;
+        }[];
+        readonly at: number;
+    }[];
+}>;
+
+/** Opens the payment provider's page where the player cancels a subscription or changes the card; send them to `url`. */
+export declare const useOpenIapManagement: (apiName?: string) => ActionState<{
+    readonly channel: "web" | "ios" | "android" | "steam";
+    readonly returnUrl: string;
+}, {
+    readonly url: string;
+}>;
+
+export declare const usePiggyBankReceipt: (input: typeof piggyReceiptDescriptor.input.Type | undefined, apiName?: string) => SubscriptionIdle | SubscriptionState<{
+    readonly requestId: string;
+    readonly state: "not-observed";
+} | {
+    readonly requestId: string;
+    readonly state: "fulfilled";
+    readonly receipt: {
+        readonly event: {
+            readonly kind: "fill";
+            readonly authorityId: string;
+            readonly eventId: string;
+            readonly sourceId: string;
+            readonly acceptedAmount: string;
+            readonly delta: string;
+            readonly id: string;
+            readonly sequence: number;
+            readonly at: number;
+        };
+        readonly operationId: string;
+        readonly requestId: string;
+        readonly bankId: string;
+        readonly available: string;
+    } | {
+        readonly event: {
+            readonly kind: "unlock";
+            readonly amount: string;
+            readonly remaining: string;
+            readonly id: string;
+            readonly sequence: number;
+            readonly at: number;
+        };
+        readonly value: {
+            readonly orderId: string;
+            readonly offerId: string;
+            readonly offerVersion: string;
+            readonly offerDigest: string;
+            readonly quantity: number;
+            readonly at: number;
+            readonly pricePaid: {
+                readonly kind: "free";
+            } | {
+                readonly kind: "virtual";
+                readonly currency: string;
+                readonly amount: string;
+            };
+            readonly transfers: readonly {
+                readonly txId: string;
+                readonly currency: string;
+                readonly amount: string;
+                readonly at: number;
+            }[];
+            readonly grants: readonly {
+                readonly operationId: string;
+                readonly kind: "grant";
+                readonly changes: readonly {
+                    readonly instanceId: string;
+                    readonly delta: number;
+                }[];
+                readonly at: number;
+            }[];
+        };
+        readonly operationId: string;
+        readonly requestId: string;
+        readonly bankId: string;
+        readonly available: string;
+    };
+}>;
+
+export declare const usePiggyBanks: (apiName?: string) => SubscriptionState<readonly {
+    readonly bank: {
+        readonly id: string;
+        readonly version: string;
+        readonly titleKey: string;
+        readonly currency: string;
+        readonly cap: string;
+        readonly unlock: {
+            readonly kind: "free";
+        } | {
+            readonly kind: "virtual";
+            readonly options: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        } | {
+            readonly prices: {
+                readonly [x: string]: number;
+            };
+            readonly storeProductIds: {
+                readonly [x: string]: string;
+            };
+            readonly kind: "real";
+        } | {
+            readonly kind: "mixed";
+            readonly real: {
+                readonly prices: {
+                    readonly [x: string]: number;
+                };
+                readonly storeProductIds: {
+                    readonly [x: string]: string;
+                };
+            };
+            readonly virtual: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        };
+        readonly fillFrom: readonly string[];
+        readonly reset: "onUnlock";
+    };
+    readonly bankDigest: string;
+    readonly available: string;
+    readonly cycles: number;
+}[]>;
+
+export declare const useProposeTrade: (apiName?: string) => ActionState<{
+    readonly toId: string | null;
+    readonly offered: {
+        readonly items: readonly {
+            readonly instanceId: string;
+            readonly qty: number;
+        }[];
+        readonly currencies: readonly {
+            readonly currency: string;
+            readonly amount: string;
+        }[];
+    };
+    readonly requested: {
+        readonly items: readonly {
+            readonly instanceId: string;
+            readonly qty: number;
+        }[];
+        readonly currencies: readonly {
+            readonly currency: string;
+            readonly amount: string;
+        }[];
+    };
+    readonly durationMs: number;
+    readonly requestId: string;
+}, {
+    readonly operationId: string;
+    readonly requestId: string;
+    readonly trade: {
+        readonly tradeId: string;
+        readonly tradeDigest: string;
+        readonly proposerId: string;
+        readonly toId: string | null;
+        readonly offered: {
+            readonly items: readonly {
+                readonly instanceId: string;
+                readonly qty: number;
+            }[];
+            readonly currencies: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        };
+        readonly requested: {
+            readonly items: readonly {
+                readonly instanceId: string;
+                readonly qty: number;
+            }[];
+            readonly currencies: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        };
+        readonly createdAt: number;
+        readonly expiresAt: number;
+        readonly state: "expired" | "cancelled" | "accepted" | "proposed";
+        readonly accepterId: string | null;
+        readonly rulesVersion: string;
+        readonly taxes: readonly {
+            readonly leg: "requested" | "offered";
+            readonly currency: string;
+            readonly gross: string;
+            readonly net: string;
+            readonly tax: string;
+        }[];
+    };
+}>;
+
+export declare const useRedeemCode: (apiName?: string) => ActionState<{
+    readonly code: string;
+    readonly requestId: string;
+}, {
+    readonly operationId: string;
+    readonly codeId: string;
+    readonly version: string;
+    readonly campaign: string;
+    readonly at: number;
+    readonly transfers: readonly {
+        readonly txId: string;
+        readonly currency: string;
+        readonly amount: string;
+        readonly at: number;
+    }[];
+    readonly grants: readonly {
+        readonly operationId: string;
+        readonly kind: "grant";
+        readonly changes: readonly {
+            readonly instanceId: string;
+            readonly delta: number;
+        }[];
+        readonly at: number;
+    }[];
+}>;
+
+export declare const useRedeemIap: (apiName?: string) => ActionState<{
+    readonly receipt: string;
+    readonly channel: "web" | "ios" | "android" | "steam";
+    readonly offerId: string;
+    readonly offerVersion: string;
+    readonly requestId: string;
+}, {
+    readonly orderId: string;
+    readonly offerId: string;
+    readonly offerVersion: string;
+    readonly quantity: number;
+    readonly at: number;
+    readonly pricePaid: {
+        readonly currency: string;
+        readonly units: string;
+        readonly scale: number;
+    } | null;
+    readonly transfers: readonly {
+        readonly txId: string;
+        readonly currency: string;
+        readonly amount: string;
+        readonly at: number;
+    }[];
+    readonly grants: readonly {
+        readonly operationId: string;
+        readonly kind: "grant";
+        readonly changes: readonly {
+            readonly instanceId: string;
+            readonly delta: number;
+        }[];
+        readonly at: number;
+    }[];
+}>;
+
+export declare const useShopBuy: (apiName?: string) => ActionState<{
+    readonly requestId: string;
+    readonly offerId: string;
+    readonly offerVersion: string;
+    readonly offerDigest: string;
+    readonly currency?: string | undefined;
+    readonly qty?: number | undefined;
+}, {
+    readonly orderId: string;
+    readonly offerId: string;
+    readonly offerVersion: string;
+    readonly offerDigest: string;
+    readonly quantity: number;
+    readonly at: number;
+    readonly pricePaid: {
+        readonly kind: "free";
+    } | {
+        readonly kind: "virtual";
+        readonly currency: string;
+        readonly amount: string;
+    };
+    readonly transfers: readonly {
+        readonly txId: string;
+        readonly currency: string;
+        readonly amount: string;
+        readonly at: number;
+    }[];
+    readonly grants: readonly {
+        readonly operationId: string;
+        readonly kind: "grant";
+        readonly changes: readonly {
+            readonly instanceId: string;
+            readonly delta: number;
+        }[];
+        readonly at: number;
+    }[];
+}>;
+
+export declare const useShopOffers: (apiName?: string) => SubscriptionState<readonly {
+    readonly offerDigest: string;
+    readonly offer: {
+        readonly id: string;
+        readonly version: string;
+        readonly titleKey: string;
+        readonly price: {
+            readonly kind: "free";
+        } | {
+            readonly kind: "virtual";
+            readonly options: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        } | {
+            readonly prices: {
+                readonly [x: string]: number;
+            };
+            readonly storeProductIds: {
+                readonly [x: string]: string;
+            };
+            readonly kind: "real";
+        } | {
+            readonly kind: "mixed";
+            readonly real: {
+                readonly prices: {
+                    readonly [x: string]: number;
+                };
+                readonly storeProductIds: {
+                    readonly [x: string]: string;
+                };
+            };
+            readonly virtual: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        };
+        readonly items: readonly {
+            readonly itemId: string;
+            readonly qty: number;
+        }[];
+        readonly currencies: readonly {
+            readonly currency: string;
+            readonly amount: string;
+        }[];
+        readonly from: number | null;
+        readonly until: number | null;
+        readonly segment: string | null;
+        readonly flag: string | null;
+        readonly countries: readonly string[];
+        readonly limits: {
+            readonly perPlayer: number | null;
+            readonly perDay: number | null;
+            readonly global: number | null;
+        };
+        readonly oneTime: boolean;
+        readonly maxQuantity: number;
+    };
+    readonly price: {
+        readonly kind: "free";
+    } | {
+        readonly kind: "virtual";
+        readonly options: readonly {
+            readonly currency: string;
+            readonly amount: string;
+        }[];
+    } | {
+        readonly prices: {
+            readonly [x: string]: number;
+        };
+        readonly storeProductIds: {
+            readonly [x: string]: string;
+        };
+        readonly kind: "real";
+    } | {
+        readonly kind: "mixed";
+        readonly real: {
+            readonly prices: {
+                readonly [x: string]: number;
+            };
+            readonly storeProductIds: {
+                readonly [x: string]: string;
+            };
+        };
+        readonly virtual: readonly {
+            readonly currency: string;
+            readonly amount: string;
+        }[];
+    };
+}[]>;
+
+/** Subscribe using the original saved intention; nonterminal observations must keep that identity. */
+export declare const useShopReceipt: (input: typeof shopBuyDescriptor.input.Type | undefined, apiName?: string) => SubscriptionIdle | SubscriptionState<{
+    readonly requestId: string;
+    readonly state: "pending" | "not-observed";
+} | {
+    readonly requestId: string;
+    readonly state: "fulfilled";
+    readonly receipt: {
+        readonly orderId: string;
+        readonly offerId: string;
+        readonly offerVersion: string;
+        readonly offerDigest: string;
+        readonly quantity: number;
+        readonly at: number;
+        readonly pricePaid: {
+            readonly kind: "free";
+        } | {
+            readonly kind: "virtual";
+            readonly currency: string;
+            readonly amount: string;
+        };
+        readonly transfers: readonly {
+            readonly txId: string;
+            readonly currency: string;
+            readonly amount: string;
+            readonly at: number;
+        }[];
+        readonly grants: readonly {
+            readonly operationId: string;
+            readonly kind: "grant";
+            readonly changes: readonly {
+                readonly instanceId: string;
+                readonly delta: number;
+            }[];
+            readonly at: number;
+        }[];
+    };
+}>;
+
+/** Starts a web checkout; send the player to `redirectUrl`, then redeem `checkoutId` as the receipt. */
+export declare const useStartIapCheckout: (apiName?: string) => ActionState<{
+    readonly returnUrl: string;
+    readonly channel: "web" | "ios" | "android" | "steam";
+    readonly offerId: string;
+    readonly offerVersion: string;
+    readonly requestId: string;
+}, {
+    readonly checkoutId: string;
+    readonly redirectUrl: string;
+    readonly expiresAt: number;
+}>;
+
+export declare const useStartSubscription: (apiName?: string) => ActionState<{
+    readonly requestId: string;
+    readonly subscriptionDigest: string;
+    readonly subscriptionId: string;
+    readonly subscriptionVersion: string;
+    readonly currency?: string | undefined;
+}, {
+    readonly operationId: string;
+    readonly entitlementId: string;
+    readonly kind: "start" | "daily" | "renew";
+    readonly at: number;
+    readonly periodIndex: number;
+    readonly day: number | null;
+    readonly window: {
+        readonly startsAt: number;
+        readonly expiresAt: number;
+        readonly graceUntil: number;
+        readonly state: "expired" | "active" | "grace";
+    };
+    readonly value: {
+        readonly orderId: string;
+        readonly offerId: string;
+        readonly offerVersion: string;
+        readonly offerDigest: string;
+        readonly quantity: number;
+        readonly at: number;
+        readonly pricePaid: {
+            readonly kind: "free";
+        } | {
+            readonly kind: "virtual";
+            readonly currency: string;
+            readonly amount: string;
+        };
+        readonly transfers: readonly {
+            readonly txId: string;
+            readonly currency: string;
+            readonly amount: string;
+            readonly at: number;
+        }[];
+        readonly grants: readonly {
+            readonly operationId: string;
+            readonly kind: "grant";
+            readonly changes: readonly {
+                readonly instanceId: string;
+                readonly delta: number;
+            }[];
+            readonly at: number;
+        }[];
+    };
+}>;
+
+/** Observation only; callers retain the saved original until terminal evidence.
+ * No durable browser journal, automatic retry or provider authority is supplied. */
+export declare const useSubscriptionReceipt: (input: typeof subscriptionReceiptDescriptor.input.Type | undefined, apiName?: string) => SubscriptionIdle | SubscriptionState<{
+    readonly requestId: string;
+    readonly state: "not-observed";
+} | {
+    readonly requestId: string;
+    readonly state: "fulfilled";
+    readonly receipt: {
+        readonly operationId: string;
+        readonly entitlementId: string;
+        readonly kind: "start" | "daily" | "renew";
+        readonly at: number;
+        readonly periodIndex: number;
+        readonly day: number | null;
+        readonly window: {
+            readonly startsAt: number;
+            readonly expiresAt: number;
+            readonly graceUntil: number;
+            readonly state: "expired" | "active" | "grace";
+        };
+        readonly value: {
+            readonly orderId: string;
+            readonly offerId: string;
+            readonly offerVersion: string;
+            readonly offerDigest: string;
+            readonly quantity: number;
+            readonly at: number;
+            readonly pricePaid: {
+                readonly kind: "free";
+            } | {
+                readonly kind: "virtual";
+                readonly currency: string;
+                readonly amount: string;
+            };
+            readonly transfers: readonly {
+                readonly txId: string;
+                readonly currency: string;
+                readonly amount: string;
+                readonly at: number;
+            }[];
+            readonly grants: readonly {
+                readonly operationId: string;
+                readonly kind: "grant";
+                readonly changes: readonly {
+                    readonly instanceId: string;
+                    readonly delta: number;
+                }[];
+                readonly at: number;
+            }[];
+        };
+    } | {
+        readonly operationId: string;
+        readonly entitlementId: string;
+        readonly at: number;
+        readonly renews: false;
+    };
+}>;
+
+export declare const useSubscriptions: (apiName?: string) => SubscriptionState<readonly {
+    readonly subscription: {
+        readonly id: string;
+        readonly version: string;
+        readonly titleKey: string;
+        readonly price: {
+            readonly kind: "free";
+        } | {
+            readonly kind: "virtual";
+            readonly options: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        } | {
+            readonly prices: {
+                readonly [x: string]: number;
+            };
+            readonly storeProductIds: {
+                readonly [x: string]: string;
+            };
+            readonly kind: "real";
+        } | {
+            readonly kind: "mixed";
+            readonly real: {
+                readonly prices: {
+                    readonly [x: string]: number;
+                };
+                readonly storeProductIds: {
+                    readonly [x: string]: string;
+                };
+            };
+            readonly virtual: readonly {
+                readonly currency: string;
+                readonly amount: string;
+            }[];
+        };
+        readonly period: {
+            readonly unit: "day" | "week" | "month";
+            readonly count: number;
+        };
+        readonly grants: {
+            readonly onPurchase: {
+                readonly items: readonly {
+                    readonly itemId: string;
+                    readonly qty: number;
+                }[];
+                readonly currencies: readonly {
+                    readonly currency: string;
+                    readonly amount: string;
+                }[];
+            };
+            readonly daily: {
+                readonly items: readonly {
+                    readonly itemId: string;
+                    readonly qty: number;
+                }[];
+                readonly currencies: readonly {
+                    readonly currency: string;
+                    readonly amount: string;
+                }[];
+            };
+        };
+        readonly graceDays: number;
+        readonly coolingOff: {
+            readonly days: number;
+            readonly overrideReason: string | null;
+        };
+        readonly disclosure: {
+            readonly durationKey: string;
+            readonly renewalKey: string;
+            readonly cancellationPath: string;
+        };
+    };
+    readonly subscriptionDigest: string;
+}[]>;
+
+/** Original receipt observation only; no durable journal or automatic retry. */
+export declare const useTradeReceipt: (input: typeof tradeReceiptDescriptor.input.Type | undefined, apiName?: string) => SubscriptionIdle | SubscriptionState<{
+    readonly requestId: string;
+    readonly state: "not-observed";
+} | {
+    readonly requestId: string;
+    readonly state: "fulfilled";
+    readonly receipt: {
+        readonly operationId: string;
+        readonly requestId: string;
+        readonly trade: {
+            readonly tradeId: string;
+            readonly tradeDigest: string;
+            readonly proposerId: string;
+            readonly toId: string | null;
+            readonly offered: {
+                readonly items: readonly {
+                    readonly instanceId: string;
+                    readonly qty: number;
+                }[];
+                readonly currencies: readonly {
+                    readonly currency: string;
+                    readonly amount: string;
+                }[];
+            };
+            readonly requested: {
+                readonly items: readonly {
+                    readonly instanceId: string;
+                    readonly qty: number;
+                }[];
+                readonly currencies: readonly {
+                    readonly currency: string;
+                    readonly amount: string;
+                }[];
+            };
+            readonly createdAt: number;
+            readonly expiresAt: number;
+            readonly state: "expired" | "cancelled" | "accepted" | "proposed";
+            readonly accepterId: string | null;
+            readonly rulesVersion: string;
+            readonly taxes: readonly {
+                readonly leg: "requested" | "offered";
+                readonly currency: string;
+                readonly gross: string;
+                readonly net: string;
+                readonly tax: string;
+            }[];
+        };
+    };
+}>;
+
+export declare const useTrades: (apiName?: string) => SubscriptionState<readonly {
+    readonly tradeId: string;
+    readonly tradeDigest: string;
+    readonly proposerId: string;
+    readonly toId: string | null;
+    readonly offered: {
+        readonly items: readonly {
+            readonly instanceId: string;
+            readonly qty: number;
+        }[];
+        readonly currencies: readonly {
+            readonly currency: string;
+            readonly amount: string;
+        }[];
+    };
+    readonly requested: {
+        readonly items: readonly {
+            readonly instanceId: string;
+            readonly qty: number;
+        }[];
+        readonly currencies: readonly {
+            readonly currency: string;
+            readonly amount: string;
+        }[];
+    };
+    readonly createdAt: number;
+    readonly expiresAt: number;
+    readonly state: "expired" | "cancelled" | "accepted" | "proposed";
+    readonly accepterId: string | null;
+    readonly rulesVersion: string;
+    readonly taxes: readonly {
+        readonly leg: "requested" | "offered";
+        readonly currency: string;
+        readonly gross: string;
+        readonly net: string;
+        readonly tax: string;
+    }[];
+}[]>;
+
+export declare const useUnlockPiggyBank: (apiName?: string) => ActionState<{
+    readonly requestId: string;
+    readonly bankDigest: string;
+    readonly bankId: string;
+    readonly bankVersion: string;
+    readonly currency?: string | undefined;
+}, {
+    readonly event: {
+        readonly kind: "fill";
+        readonly authorityId: string;
+        readonly eventId: string;
+        readonly sourceId: string;
+        readonly acceptedAmount: string;
+        readonly delta: string;
+        readonly id: string;
+        readonly sequence: number;
+        readonly at: number;
+    };
+    readonly operationId: string;
+    readonly requestId: string;
+    readonly bankId: string;
+    readonly available: string;
+} | {
+    readonly event: {
+        readonly kind: "unlock";
+        readonly amount: string;
+        readonly remaining: string;
+        readonly id: string;
+        readonly sequence: number;
+        readonly at: number;
+    };
+    readonly value: {
+        readonly orderId: string;
+        readonly offerId: string;
+        readonly offerVersion: string;
+        readonly offerDigest: string;
+        readonly quantity: number;
+        readonly at: number;
+        readonly pricePaid: {
+            readonly kind: "free";
+        } | {
+            readonly kind: "virtual";
+            readonly currency: string;
+            readonly amount: string;
+        };
+        readonly transfers: readonly {
+            readonly txId: string;
+            readonly currency: string;
+            readonly amount: string;
+            readonly at: number;
+        }[];
+        readonly grants: readonly {
+            readonly operationId: string;
+            readonly kind: "grant";
+            readonly changes: readonly {
+                readonly instanceId: string;
+                readonly delta: number;
+            }[];
+            readonly at: number;
+        }[];
+    };
+    readonly operationId: string;
+    readonly requestId: string;
+    readonly bankId: string;
+    readonly available: string;
+}>;
+
+export declare const useWallets: (apiName?: string) => SubscriptionState<readonly {
+    readonly currency: string;
+    readonly balance: string;
+    readonly updatedAt: number | null;
+}[]>;
+
+export { }