@crowdedkingdoms/crowdyjs 8.15.0 → 8.16.0

package/dist/domains/playerWallet.js

@@ -0,0 +1,106 @@
+import { PlayerWalletBalanceDocument, PlayerWalletTransactionsDocument, PlayerUsageChargesDocument, PlayerSpendCapsDocument, SetPlayerSpendCapDocument, PlayerAutoBillingDocument, SetPlayerAutoBillingDocument, BeginPlayerCardSetupDocument, PlayerRuntimeStatesDocument, PlayerWasmPoliciesDocument, SetPlayerWasmPolicyDocument, DeletePlayerWasmPolicyDocument, PlayerRateMarkupDocument, SetPlayerRateMarkupDocument, AppPlayerUsageDocument, AppPlayerMarkupAccruedDocument, } from '../generated/graphql.js';
+/**
+ * The player wallet and player-billing surface (player compute P2, DN-5) —
+ * exposed as `client.playerWallet` and routed to the Management API.
+ *
+ * Every viewer-scoped call operates on the CALLER's own wallet: balance,
+ * ledger, hourly usage charges (platform vs studio-markup split), self-set
+ * spend caps, auto-recharge config, and per-app gate states. Fund the wallet
+ * via `client.payments.createCheckout` with purpose `PLAYER_WALLET_TOPUP`.
+ *
+ * The studio-scoped calls (policies, markup, per-player usage, accrued
+ * markup) require the corresponding org permissions (`manage_compute`,
+ * `manage_billing`, `view_compute_diagnostics`, `view_billing`).
+ */
+export class PlayerWalletAPI {
+    constructor(graphql) {
+        this.graphql = graphql;
+    }
+    /** The caller's wallet, created empty on first access (never null). */
+    async balance() {
+        const data = await this.graphql.request(PlayerWalletBalanceDocument, {});
+        return data.playerWalletBalance;
+    }
+    /** The caller's wallet ledger, newest first. */
+    async transactions(variables = {}) {
+        const data = await this.graphql.request(PlayerWalletTransactionsDocument, variables);
+        return data.playerWalletTransactions;
+    }
+    /**
+     * The caller's posted hourly usage charges; each splits platformCents vs
+     * markupCents with a per-metric snapshot ("what is this grid costing me").
+     */
+    async charges(variables = {}) {
+        const data = await this.graphql.request(PlayerUsageChargesDocument, variables);
+        return data.playerUsageCharges;
+    }
+    /** The caller's self-set spend caps with running counters. */
+    async spendCaps() {
+        const data = await this.graphql.request(PlayerSpendCapsDocument, {});
+        return data.playerSpendCaps;
+    }
+    /** Set (or clear with null limits) a global or per-app self spend cap. */
+    async setSpendCap(variables) {
+        const data = await this.graphql.request(SetPlayerSpendCapDocument, variables);
+        return data.setPlayerSpendCap;
+    }
+    /** The caller's auto-recharge settings. */
+    async autoBilling() {
+        const data = await this.graphql.request(PlayerAutoBillingDocument, {});
+        return data.playerAutoBilling;
+    }
+    /** Configure auto-recharge (requires a vaulted payment method to enable). */
+    async setAutoBilling(variables) {
+        const data = await this.graphql.request(SetPlayerAutoBillingDocument, variables);
+        return data.setPlayerAutoBilling;
+    }
+    /**
+     * Begin vaulting a card on the caller's player wallet (P4b): returns the
+     * Stripe SetupIntent client secret + publishable key the browser confirms.
+     * On success the card is saved for wallet auto-recharge and rent auto-renew.
+     */
+    async beginCardSetup() {
+        const data = await this.graphql.request(BeginPlayerCardSetupDocument, {});
+        return data.beginPlayerCardSetup;
+    }
+    /** The caller's per-app gate states (absence means active). */
+    async runtimeStates() {
+        const data = await this.graphql.request(PlayerRuntimeStatesDocument, {});
+        return data.playerRuntimeStates;
+    }
+    /** Studio: list an app's player policy rows (`view_compute_diagnostics`). */
+    async policies(variables) {
+        const data = await this.graphql.request(PlayerWasmPoliciesDocument, variables);
+        return data.playerWasmPolicies;
+    }
+    /** Studio: upsert a player policy row (`manage_compute`). */
+    async setPolicy(variables) {
+        const data = await this.graphql.request(SetPlayerWasmPolicyDocument, variables);
+        return data.setPlayerWasmPolicy;
+    }
+    /** Studio: delete a player policy row (`manage_compute`). */
+    async deletePolicy(variables) {
+        const data = await this.graphql.request(DeletePlayerWasmPolicyDocument, variables);
+        return data.deletePlayerWasmPolicy;
+    }
+    /** Studio: read the app's player rate-card markup in bps (`view_billing`). */
+    async rateMarkup(variables) {
+        const data = await this.graphql.request(PlayerRateMarkupDocument, variables);
+        return data.playerRateMarkup;
+    }
+    /** Studio: set the app's player rate-card markup in bps (`manage_billing`). */
+    async setRateMarkup(variables) {
+        const data = await this.graphql.request(SetPlayerRateMarkupDocument, variables);
+        return data.setPlayerRateMarkup;
+    }
+    /** Studio: per-player usage aggregate (`view_compute_diagnostics`). */
+    async appPlayerUsage(variables) {
+        const data = await this.graphql.request(AppPlayerUsageDocument, variables);
+        return data.appPlayerUsage;
+    }
+    /** Studio: total accrued markup income in cents (`view_billing`). */
+    async appMarkupAccrued(variables) {
+        const data = await this.graphql.request(AppPlayerMarkupAccruedDocument, variables);
+        return data.appPlayerMarkupAccrued;
+    }
+}