@crowdedkingdoms/crowdyjs 1.0.0

package/dist/domains/sharedEnvironment.d.ts

@@ -0,0 +1,133 @@
+import type { GraphQLClient } from '../client.js';
+import { type SharedEnvPlansQuery, type OrgFreeAppQuotaQuery, type AppSharedSubscriptionQuery, type AppRuntimeStateQuery, type OrgAutoBillingQuery, type OrgPaymentMethodsQuery, type PublishAppToSharedMutation, type CancelSharedSubscriptionMutation, type SetAppSpendCapsMutation, type SetAutoBillingMutation, type SetupSharedPaymentMethodMutation, type RemoveSharedPaymentMethodMutation, type PaymentProvider } from '../generated/graphql.js';
+/**
+ * Shared-environment app publishing, runtime gating, spend caps, and
+ * auto-billing — exposed as `client.sharedEnvironment` (and grouped under
+ * `client.admin`).
+ *
+ * Targets the **management-api**. {@link plans} is public; the read operations
+ * require org membership; spend-cap / auto-billing / subscription mutations
+ * require the `manage_billing` org permission; {@link publishApp} currently
+ * requires super-admin (preview). Monetary values are `*Cents` (minor units).
+ *
+ * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `FORBIDDEN` / `SCOPE_MISSING`
+ *   per the permission notes above; `IDEMPOTENCY_CONFLICT` on key reuse with
+ *   different args.
+ */
+export declare class SharedEnvironmentAPI {
+    private readonly management;
+    constructor(management: GraphQLClient);
+    /**
+     * Public catalog of paid shared-environment app-slot plans.
+     *
+     * @returns The available plans.
+     */
+    plans(): Promise<SharedEnvPlansQuery['sharedEnvPlans']>;
+    /**
+     * An org's free shared-app slot quota and usage. Caller must be an org member.
+     *
+     * @param orgId - Numeric org id.
+     * @returns The {@link FreeAppQuota}.
+     */
+    freeAppQuota(orgId: string): Promise<OrgFreeAppQuotaQuery['orgFreeAppQuota']>;
+    /**
+     * An app's paid shared subscription, or `null` when on the free quota.
+     *
+     * @param appId - Numeric app id.
+     * @returns The {@link AppSharedSubscription} or `null`.
+     */
+    appSubscription(appId: string): Promise<AppSharedSubscriptionQuery['appSharedSubscription']>;
+    /**
+     * The shared-environment runtime gate + current usage for an app.
+     *
+     * @param appId - Numeric app id.
+     * @returns The {@link AppRuntimeState}.
+     */
+    appRuntimeState(appId: string): Promise<AppRuntimeStateQuery['appRuntimeState']>;
+    /**
+     * An org's off-session auto-billing configuration.
+     *
+     * @param orgId - Numeric org id.
+     * @returns The {@link OrgAutoBilling} config.
+     */
+    autoBilling(orgId: string): Promise<OrgAutoBillingQuery['orgAutoBilling']>;
+    /**
+     * List an org's saved (vaulted) payment methods.
+     *
+     * @param orgId - Numeric org id.
+     * @returns The saved payment methods.
+     */
+    paymentMethods(orgId: string): Promise<OrgPaymentMethodsQuery['orgPaymentMethods']>;
+    /**
+     * Publish an app to the shared game-api. Free under the org quota (no charge);
+     * pass `planId` for a paid subscription (returns a checkout to complete).
+     * Currently super-admin only (preview).
+     *
+     * @param appId - Numeric app id.
+     * @param opts - Optional `planId`, `provider`, `successUrl`, `cancelUrl`, and
+     *   `idempotencyKey`.
+     * @returns The {@link PublishAppResult} (free flag + optional checkout).
+     */
+    publishApp(appId: string, opts?: {
+        planId?: string;
+        provider?: PaymentProvider;
+        successUrl?: string;
+        cancelUrl?: string;
+        idempotencyKey?: string;
+    }): Promise<PublishAppToSharedMutation['publishAppToShared']>;
+    /**
+     * Cancel an app's paid shared subscription. Requires `manage_billing`.
+     *
+     * @param appId - Numeric app id.
+     * @param idempotencyKey - Optional idempotency key for safe retries.
+     * @returns The updated {@link AppSharedSubscription}.
+     */
+    cancelSubscription(appId: string, idempotencyKey?: string): Promise<CancelSharedSubscriptionMutation['cancelSharedSubscription']>;
+    /**
+     * Set per-app hourly/daily spend caps (cents); `null` clears a cap. Requires
+     * `manage_billing`. Returns the re-evaluated runtime state.
+     *
+     * @param appId - Numeric app id.
+     * @param caps - `hourlyLimitCents` and/or `dailyLimitCents` (decimal strings).
+     * @returns The updated {@link AppRuntimeState}.
+     */
+    setSpendCaps(appId: string, caps?: {
+        hourlyLimitCents?: string | null;
+        dailyLimitCents?: string | null;
+    }): Promise<SetAppSpendCapsMutation['setAppSpendCaps']>;
+    /**
+     * Enable/disable and configure off-session auto-billing for an org. Requires
+     * `manage_billing`.
+     *
+     * @param orgId - Numeric org id.
+     * @param config - `enabled` plus optional `limitCents`, `rechargeAmountCents`,
+     *   `lowWaterThresholdCents`, and `idempotencyKey`.
+     * @returns The updated {@link OrgAutoBilling} config.
+     */
+    setAutoBilling(orgId: string, config: {
+        enabled: boolean;
+        limitCents?: string | null;
+        rechargeAmountCents?: string | null;
+        lowWaterThresholdCents?: string | null;
+        idempotencyKey?: string;
+    }): Promise<SetAutoBillingMutation['setAutoBilling']>;
+    /**
+     * Begin vaulting a card for off-session auto-billing (returns a Stripe
+     * SetupIntent client secret). No charge here. Requires `manage_billing`.
+     *
+     * @param orgId - Numeric org id.
+     * @param idempotencyKey - Optional idempotency key.
+     * @returns The {@link PaymentMethodSetup} handle.
+     */
+    setupPaymentMethod(orgId: string, idempotencyKey?: string): Promise<SetupSharedPaymentMethodMutation['setupSharedPaymentMethod']>;
+    /**
+     * Remove a saved payment method from an org. Requires `manage_billing`.
+     *
+     * @param orgId - Numeric org id.
+     * @param paymentMethodId - Numeric id of the saved method to remove.
+     * @param idempotencyKey - Optional idempotency key.
+     * @returns `true` on success.
+     */
+    removePaymentMethod(orgId: string, paymentMethodId: string, idempotencyKey?: string): Promise<RemoveSharedPaymentMethodMutation['removeSharedPaymentMethod']>;
+}
+//# sourceMappingURL=sharedEnvironment.d.ts.map

package/dist/domains/sharedEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharedEnvironment.d.ts","sourceRoot":"","sources":["../../src/domains/sharedEnvironment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAaL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,gCAAgC,EACrC,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,gCAAgC,EACrC,KAAK,iCAAiC,EACtC,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,aAAa;IAEtD;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IAK7D;;;;;OAKG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAOnD;;;;;OAKG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,0BAA0B,CAAC,uBAAuB,CAAC,CAAC;IAQ/D;;;;;OAKG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAOnD;;;;;OAKG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IAOjD;;;;;OAKG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;IAOvD;;;;;;;;;OASG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,eAAe,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;KACpB,GACL,OAAO,CAAC,0BAA0B,CAAC,oBAAoB,CAAC,CAAC;IAY5D;;;;;;OAMG;IACG,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,gCAAgC,CAAC,0BAA0B,CAAC,CAAC;IAQxE;;;;;;;OAOG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAO,GAC/E,OAAO,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;IAStD;;;;;;;;OAQG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE;QACN,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACpC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvC,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GACA,OAAO,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAYpD;;;;;;;OAOG;IACG,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,gCAAgC,CAAC,0BAA0B,CAAC,CAAC;IAQxE;;;;;;;OAOG;IACG,mBAAmB,CACvB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,EACvB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,iCAAiC,CAAC,2BAA2B,CAAC,CAAC;CAO3E"}

package/dist/domains/sharedEnvironment.js

@@ -0,0 +1,179 @@
+import { SharedEnvPlansDocument, OrgFreeAppQuotaDocument, AppSharedSubscriptionDocument, AppRuntimeStateDocument, OrgAutoBillingDocument, OrgPaymentMethodsDocument, PublishAppToSharedDocument, CancelSharedSubscriptionDocument, SetAppSpendCapsDocument, SetAutoBillingDocument, SetupSharedPaymentMethodDocument, RemoveSharedPaymentMethodDocument, } from '../generated/graphql.js';
+/**
+ * Shared-environment app publishing, runtime gating, spend caps, and
+ * auto-billing — exposed as `client.sharedEnvironment` (and grouped under
+ * `client.admin`).
+ *
+ * Targets the **management-api**. {@link plans} is public; the read operations
+ * require org membership; spend-cap / auto-billing / subscription mutations
+ * require the `manage_billing` org permission; {@link publishApp} currently
+ * requires super-admin (preview). Monetary values are `*Cents` (minor units).
+ *
+ * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `FORBIDDEN` / `SCOPE_MISSING`
+ *   per the permission notes above; `IDEMPOTENCY_CONFLICT` on key reuse with
+ *   different args.
+ */
+export class SharedEnvironmentAPI {
+    constructor(management) {
+        this.management = management;
+    }
+    /**
+     * Public catalog of paid shared-environment app-slot plans.
+     *
+     * @returns The available plans.
+     */
+    async plans() {
+        const data = await this.management.request(SharedEnvPlansDocument, {});
+        return data.sharedEnvPlans;
+    }
+    /**
+     * An org's free shared-app slot quota and usage. Caller must be an org member.
+     *
+     * @param orgId - Numeric org id.
+     * @returns The {@link FreeAppQuota}.
+     */
+    async freeAppQuota(orgId) {
+        const data = await this.management.request(OrgFreeAppQuotaDocument, {
+            orgId,
+        });
+        return data.orgFreeAppQuota;
+    }
+    /**
+     * An app's paid shared subscription, or `null` when on the free quota.
+     *
+     * @param appId - Numeric app id.
+     * @returns The {@link AppSharedSubscription} or `null`.
+     */
+    async appSubscription(appId) {
+        const data = await this.management.request(AppSharedSubscriptionDocument, { appId });
+        return data.appSharedSubscription;
+    }
+    /**
+     * The shared-environment runtime gate + current usage for an app.
+     *
+     * @param appId - Numeric app id.
+     * @returns The {@link AppRuntimeState}.
+     */
+    async appRuntimeState(appId) {
+        const data = await this.management.request(AppRuntimeStateDocument, {
+            appId,
+        });
+        return data.appRuntimeState;
+    }
+    /**
+     * An org's off-session auto-billing configuration.
+     *
+     * @param orgId - Numeric org id.
+     * @returns The {@link OrgAutoBilling} config.
+     */
+    async autoBilling(orgId) {
+        const data = await this.management.request(OrgAutoBillingDocument, {
+            orgId,
+        });
+        return data.orgAutoBilling;
+    }
+    /**
+     * List an org's saved (vaulted) payment methods.
+     *
+     * @param orgId - Numeric org id.
+     * @returns The saved payment methods.
+     */
+    async paymentMethods(orgId) {
+        const data = await this.management.request(OrgPaymentMethodsDocument, {
+            orgId,
+        });
+        return data.orgPaymentMethods;
+    }
+    /**
+     * Publish an app to the shared game-api. Free under the org quota (no charge);
+     * pass `planId` for a paid subscription (returns a checkout to complete).
+     * Currently super-admin only (preview).
+     *
+     * @param appId - Numeric app id.
+     * @param opts - Optional `planId`, `provider`, `successUrl`, `cancelUrl`, and
+     *   `idempotencyKey`.
+     * @returns The {@link PublishAppResult} (free flag + optional checkout).
+     */
+    async publishApp(appId, opts = {}) {
+        const data = await this.management.request(PublishAppToSharedDocument, {
+            appId,
+            planId: opts.planId,
+            provider: opts.provider,
+            successUrl: opts.successUrl,
+            cancelUrl: opts.cancelUrl,
+            idempotencyKey: opts.idempotencyKey,
+        });
+        return data.publishAppToShared;
+    }
+    /**
+     * Cancel an app's paid shared subscription. Requires `manage_billing`.
+     *
+     * @param appId - Numeric app id.
+     * @param idempotencyKey - Optional idempotency key for safe retries.
+     * @returns The updated {@link AppSharedSubscription}.
+     */
+    async cancelSubscription(appId, idempotencyKey) {
+        const data = await this.management.request(CancelSharedSubscriptionDocument, { appId, idempotencyKey });
+        return data.cancelSharedSubscription;
+    }
+    /**
+     * Set per-app hourly/daily spend caps (cents); `null` clears a cap. Requires
+     * `manage_billing`. Returns the re-evaluated runtime state.
+     *
+     * @param appId - Numeric app id.
+     * @param caps - `hourlyLimitCents` and/or `dailyLimitCents` (decimal strings).
+     * @returns The updated {@link AppRuntimeState}.
+     */
+    async setSpendCaps(appId, caps = {}) {
+        const data = await this.management.request(SetAppSpendCapsDocument, {
+            appId,
+            hourlyLimitCents: caps.hourlyLimitCents,
+            dailyLimitCents: caps.dailyLimitCents,
+        });
+        return data.setAppSpendCaps;
+    }
+    /**
+     * Enable/disable and configure off-session auto-billing for an org. Requires
+     * `manage_billing`.
+     *
+     * @param orgId - Numeric org id.
+     * @param config - `enabled` plus optional `limitCents`, `rechargeAmountCents`,
+     *   `lowWaterThresholdCents`, and `idempotencyKey`.
+     * @returns The updated {@link OrgAutoBilling} config.
+     */
+    async setAutoBilling(orgId, config) {
+        const data = await this.management.request(SetAutoBillingDocument, {
+            orgId,
+            enabled: config.enabled,
+            limitCents: config.limitCents,
+            rechargeAmountCents: config.rechargeAmountCents,
+            lowWaterThresholdCents: config.lowWaterThresholdCents,
+            idempotencyKey: config.idempotencyKey,
+        });
+        return data.setAutoBilling;
+    }
+    /**
+     * Begin vaulting a card for off-session auto-billing (returns a Stripe
+     * SetupIntent client secret). No charge here. Requires `manage_billing`.
+     *
+     * @param orgId - Numeric org id.
+     * @param idempotencyKey - Optional idempotency key.
+     * @returns The {@link PaymentMethodSetup} handle.
+     */
+    async setupPaymentMethod(orgId, idempotencyKey) {
+        const data = await this.management.request(SetupSharedPaymentMethodDocument, { orgId, idempotencyKey });
+        return data.setupSharedPaymentMethod;
+    }
+    /**
+     * Remove a saved payment method from an org. Requires `manage_billing`.
+     *
+     * @param orgId - Numeric org id.
+     * @param paymentMethodId - Numeric id of the saved method to remove.
+     * @param idempotencyKey - Optional idempotency key.
+     * @returns `true` on success.
+     */
+    async removePaymentMethod(orgId, paymentMethodId, idempotencyKey) {
+        const data = await this.management.request(RemoveSharedPaymentMethodDocument, { orgId, paymentMethodId, idempotencyKey });
+        return data.removeSharedPaymentMethod;
+    }
+}

package/dist/domains/state.d.ts

@@ -0,0 +1,64 @@
+import type { GraphQLClient } from '../client.js';
+import { type UserAppStateQuery, type UserAppStateQueryVariables, type UserAppStatesQuery, type UpdateUserAppStateMutation, type UpdateUserAppStateMutationVariables, type DeleteUserAppStateMutation, type DeleteUserAppStateMutationVariables } from '../generated/graphql.js';
+/**
+ * Per-user, per-app state storage on the **game-api** (formerly `userMapState`).
+ * Exposed as `client.state`.
+ *
+ * Each row is the authenticated user's own opaque state blob scoped to one app
+ * (keyed by `appId` + `userId`) — a convenient place to persist small
+ * per-player, per-game data. The `state` blob is **base64-encoded** binary
+ * (null when cleared) and `appId` is a `BigInt` sent and received as a decimal
+ * string.
+ *
+ * Every method requires an authenticated session (a Bearer game token set via
+ * `client.auth.login()` or `client.setToken()`) and only ever reads or writes
+ * the **caller's own** state, otherwise {@link CrowdyGraphQLError} is thrown
+ * (`UNAUTHENTICATED`).
+ */
+export declare class StateAPI {
+    private gql;
+    constructor(gql: GraphQLClient);
+    /**
+     * Read the authenticated user's per-app state for `appId`.
+     *
+     * @param appId - App (game) id the state is scoped to (`BigInt` as a decimal
+     *   string).
+     * @returns The {@link UserAppState} (its `state` blob base64-encoded), or
+     *   `null` when no row exists.
+     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED`.
+     */
+    getOne(appId: UserAppStateQueryVariables['appId']): Promise<UserAppStateQuery['userAppState']>;
+    /**
+     * List all of the authenticated user's per-app state rows, ordered
+     * newest-updated first. Takes no arguments.
+     *
+     * @returns The caller's {@link UserAppState} rows (each `state` blob
+     *   base64-encoded).
+     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED`.
+     */
+    getAll(): Promise<UserAppStatesQuery['userAppStates']>;
+    /**
+     * Create or replace (upsert) the authenticated user's per-app state for
+     * `input.appId`, keyed by `appId` + `userId`. Always writes the caller's own
+     * state.
+     *
+     * @param input - {@link CreateUserAppStateInput}: the target `appId` (decimal
+     *   string) and the new `state` blob (base64-encoded binary; omit/null to clear
+     *   it).
+     * @returns The upserted {@link UserAppState}.
+     * @throws {CrowdyGraphQLError} `BAD_USER_INPUT` or `UNAUTHENTICATED`.
+     */
+    update(input: UpdateUserAppStateMutationVariables['input']): Promise<UpdateUserAppStateMutation['updateUserAppState']>;
+    /**
+     * **Destructive:** delete the authenticated user's per-app state row for
+     * `appId` and return the deleted row. Acts only on the caller's own state.
+     *
+     * @param appId - App (game) id whose state row to delete (`BigInt` as a decimal
+     *   string).
+     * @returns The deleted {@link UserAppState}.
+     * @throws {CrowdyGraphQLError} when no state row exists for `appId`
+     *   (not-found), or `UNAUTHENTICATED`.
+     */
+    delete(appId: DeleteUserAppStateMutationVariables['appId']): Promise<DeleteUserAppStateMutation['deleteUserAppState']>;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/domains/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/domains/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAE/B,KAAK,kBAAkB,EAEvB,KAAK,0BAA0B,EAC/B,KAAK,mCAAmC,EAExC,KAAK,0BAA0B,EAC/B,KAAK,mCAAmC,EACzC,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAEtC;;;;;;;;OAQG;IACG,MAAM,CACV,KAAK,EAAE,0BAA0B,CAAC,OAAO,CAAC,GACzC,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAK7C;;;;;;;OAOG;IACG,MAAM,IAAI,OAAO,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAK5D;;;;;;;;;;OAUG;IACG,MAAM,CACV,KAAK,EAAE,mCAAmC,CAAC,OAAO,CAAC,GAClD,OAAO,CAAC,0BAA0B,CAAC,oBAAoB,CAAC,CAAC;IAK5D;;;;;;;;;OASG;IACG,MAAM,CACV,KAAK,EAAE,mCAAmC,CAAC,OAAO,CAAC,GAClD,OAAO,CAAC,0BAA0B,CAAC,oBAAoB,CAAC,CAAC;CAI7D"}

package/dist/domains/state.js

@@ -0,0 +1,75 @@
+import { UserAppStateDocument, UserAppStatesDocument, UpdateUserAppStateDocument, DeleteUserAppStateDocument, } from '../generated/graphql.js';
+/**
+ * Per-user, per-app state storage on the **game-api** (formerly `userMapState`).
+ * Exposed as `client.state`.
+ *
+ * Each row is the authenticated user's own opaque state blob scoped to one app
+ * (keyed by `appId` + `userId`) — a convenient place to persist small
+ * per-player, per-game data. The `state` blob is **base64-encoded** binary
+ * (null when cleared) and `appId` is a `BigInt` sent and received as a decimal
+ * string.
+ *
+ * Every method requires an authenticated session (a Bearer game token set via
+ * `client.auth.login()` or `client.setToken()`) and only ever reads or writes
+ * the **caller's own** state, otherwise {@link CrowdyGraphQLError} is thrown
+ * (`UNAUTHENTICATED`).
+ */
+export class StateAPI {
+    constructor(gql) {
+        this.gql = gql;
+    }
+    /**
+     * Read the authenticated user's per-app state for `appId`.
+     *
+     * @param appId - App (game) id the state is scoped to (`BigInt` as a decimal
+     *   string).
+     * @returns The {@link UserAppState} (its `state` blob base64-encoded), or
+     *   `null` when no row exists.
+     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED`.
+     */
+    async getOne(appId) {
+        const data = await this.gql.request(UserAppStateDocument, { appId });
+        return data.userAppState;
+    }
+    /**
+     * List all of the authenticated user's per-app state rows, ordered
+     * newest-updated first. Takes no arguments.
+     *
+     * @returns The caller's {@link UserAppState} rows (each `state` blob
+     *   base64-encoded).
+     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED`.
+     */
+    async getAll() {
+        const data = await this.gql.request(UserAppStatesDocument, undefined);
+        return data.userAppStates;
+    }
+    /**
+     * Create or replace (upsert) the authenticated user's per-app state for
+     * `input.appId`, keyed by `appId` + `userId`. Always writes the caller's own
+     * state.
+     *
+     * @param input - {@link CreateUserAppStateInput}: the target `appId` (decimal
+     *   string) and the new `state` blob (base64-encoded binary; omit/null to clear
+     *   it).
+     * @returns The upserted {@link UserAppState}.
+     * @throws {CrowdyGraphQLError} `BAD_USER_INPUT` or `UNAUTHENTICATED`.
+     */
+    async update(input) {
+        const data = await this.gql.request(UpdateUserAppStateDocument, { input });
+        return data.updateUserAppState;
+    }
+    /**
+     * **Destructive:** delete the authenticated user's per-app state row for
+     * `appId` and return the deleted row. Acts only on the caller's own state.
+     *
+     * @param appId - App (game) id whose state row to delete (`BigInt` as a decimal
+     *   string).
+     * @returns The deleted {@link UserAppState}.
+     * @throws {CrowdyGraphQLError} when no state row exists for `appId`
+     *   (not-found), or `UNAUTHENTICATED`.
+     */
+    async delete(appId) {
+        const data = await this.gql.request(DeleteUserAppStateDocument, { appId });
+        return data.deleteUserAppState;
+    }
+}