@crowdedkingdoms/crowdyjs 8.19.1 → 8.21.0

package/README.md

@@ -20,7 +20,10 @@ CrowdyJS v4 targets browsers by default and uses native `fetch`, `WebSocket`, `c
 > `client.playerModel` (owner/grid-confined flexible data + automations), first-class grid
 > ownership methods on `client.gameApps`, and app code-admission methods on
 > `client.apps` require the 2026-07-20 game-api/management-api player-runtime
-> schemas. Older servers reject only those operations during GraphQL validation.
+> schemas. Player-authorized one-chunk claims and owner release through
+> `marketplace.claimGridChunk` / `marketplace.releaseClaimedGrid` require the
+> corresponding 2026-07-22 Game API claim schema. Older servers reject only
+> those operations during GraphQL validation.
 
 > **Player-code authoring DX:** `playerCompute.setRequires`,
 > `marketplace.trustGridAuthor`, self-authored `gridClientMods` fields, and
@@ -117,8 +120,10 @@ If `managementUrl` is omitted, the SDK falls back to `httpUrl` for backwards-com
 | `client.compute` | **Compute Modules** — server-side Rust/WASM logic: author + deploy source (`upsertModule`, `deployVersion`, `waitForCompile`), triggers + policy, synchronous `invoke`, and monitoring (`moduleRuns`, `moduleStats`, `moduleLogs`, `appDiagnostics`). Modules run server-only; see [Compute Modules docs](https://docs.crowdedkingdoms.com/game-api/compute-modules). |
 | `client.playerCompute` | Player-authored SERVER/CLIENT Rust/WASM bound to player-owned grids: deploy source, activate/deactivate, list modules/versions, and delete self-authored modules. |
 | `client.playerModel` | Player-owned flexible model containers and grid-confined automations (`containers`, `createContainer`, `setProperty`, `automations`, `createAutomation`, …). |
+| `client.marketplace` | Player-code store/install/consent flows plus player-authorized grid claims: `claimGridOwnership` preserves the existing-grid policy flow, while `claimGridChunk` atomically creates and owns one chunk under `SELF_CLAIM` and `releaseClaimedGrid` releases an eligible owner-created claim. |
 | `client.udp` | UDP proxy subscriptions + spatial mutations (`sendActorUpdate`, `sendVoxelUpdate`, `sendAudioPacket`, `sendTextPacket`, `sendClientEvent`). |
 | `client.realtime` | Connection status, manual `connect()` / `disconnect()`, `onStatus()` listener. |
+| `client.refreshGameplayToken()` | Safely rotates an active game client's app token: disconnects the old-token UDP proxy, refreshes/stores the token, and opens the new-token proxy while existing realtime handlers resubscribe in place. |
 | `client.world(appId)` | Higher-level helpers for browser games (`actor.join`, `actor.sendState`, `actor.sendText`). |
 
 `PlayerCodeBroker` is the P1 page-side browser security skeleton: it transfers
@@ -160,9 +165,16 @@ Auth, user reads, and the studio-admin / operator surfaces target `managementUrl
 3. Subscribe to UDP proxy notifications with `game.udp.subscribe(handlers, appId)` — `appId` is **required** (the SDK opens the realtime socket on demand and scopes it to that app).
 4. Join a chunk by sending an initial actor update.
 5. Send actor, voxel, text, audio, and client-event updates through `game.udp` or the higher-level `game.world(appId)` helpers.
-6. Call `game.udp.disconnect()` when leaving the world; `game.portal.refresh()` before the token expires to keep playing.
+6. Before the app token expires, call `game.refreshGameplayToken()` while gameplay is active. It closes the old-token UDP proxy before rotating the token, opens the new-token proxy, and lets the existing realtime subscription restart without adding handlers. Use `game.portal.refresh()` directly only when no UDP proxy lifecycle needs to be preserved.
 7. Call `client.close()` (and `game.close()`) when disposing the SDK instances.
 
+`refreshGameplayToken()` deliberately stops on the first failed stage. If the
+old proxy cannot confirm disconnect, no refresh is attempted and the old token
+remains active. If refresh fails, the old token is still retained (although its
+proxy was closed and may be reopened). If the new proxy connect fails, the
+fresh token remains stored; surface the error and retry `game.udp.connect()`
+instead of rotating again.
+
 ## Per-app routing
 
 When a player is about to join an app, query its routing fields on the management API first:
@@ -502,10 +514,15 @@ location.assign(await overworld.portal.handleAuthorizeRequest());
 
 // Game origin, on callback boot: exchange code+verifier -> app token (stored).
 const entered = await game.portal.completeEntry();
-// Keep playing past expiry without re-portaling (same app):
-await game.portal.refresh();
+// Keep active UDP gameplay running past expiry without orphaning the old proxy:
+await game.refreshGameplayToken();
 ```
 
+`portal.refresh()` remains available for clients with no active UDP lifecycle.
+Once a proxy or realtime gameplay session is active, prefer
+`refreshGameplayToken()` so the old Bearer closes its proxy before the token is
+revoked.
+
 Game-to-game routes through the Overworld for a fresh per-game token. New
 realtime codes: `APP_TOKEN_REQUIRED`, `APP_SCOPE_MISMATCH`; new `UdpErrorCode`:
 `TOKEN_EXPIRED`. See [MIGRATION.md](MIGRATION.md) for the full v7 breaking guide.

package/dist/crowdy-client.d.ts

@@ -32,7 +32,7 @@ import { GameKitClient, type GameKitOptions } from './kit/index.js';
 import { AuthAPI } from './domains/auth.js';
 import { UsersAPI } from './domains/users.js';
 import { AppsAPI } from './domains/apps.js';
-import { PortalAPI, type PkceStore } from './domains/portal.js';
+import { PortalAPI, type AppTokenResponse, type PkceStore } from './domains/portal.js';
 import { PlatformAPI } from './domains/platform.js';
 import { OrganizationsAPI } from './domains/organizations.js';
 import { AppAccessAPI } from './domains/appAccess.js';
@@ -117,6 +117,7 @@ export interface CrowdyClientConfig {
     lbCookieStore?: LbCookieStore;
 }
 export declare class CrowdyClient {
+    private gameplayTokenRefresh;
     /** Shared token state for both game-api and management-api requests. */
     readonly session: AuthState;
     /** game-api HTTP client. */
@@ -213,6 +214,33 @@ export declare class CrowdyClient {
     setToken(token: string | null): void;
     /** Read the current Bearer token (null if no session). */
     getToken(): string | null;
+    /**
+     * Rotate an active gameplay token without orphaning its old UDP proxy.
+     *
+     * This is the supported refresh path while a game client has an open UDP
+     * proxy: it disconnects that proxy while the old Bearer token is still
+     * active, calls {@link PortalAPI.refresh} to rotate and store the new token,
+     * then opens a proxy authenticated by the new token. The session token
+     * listener restarts the existing realtime subscription in place, so its
+     * registered notification handlers are retained rather than duplicated.
+     * Concurrent calls share one in-flight rotation.
+     *
+     * Failure semantics:
+     * - If the old proxy disconnect rejects or does not confirm closure, rotation
+     *   is aborted and the old token remains active.
+     * - If refresh rejects, the old token remains active (the old proxy has
+     *   already closed and can be opened again with {@link UdpAPI.connect}).
+     * - If opening the new proxy rejects, the fresh token remains active. Surface
+     *   the error and retry {@link UdpAPI.connect}; do not repeat the rotation
+     *   merely to retry that connection.
+     *
+     * @returns The fresh app-scoped token response stored on this client.
+     * @throws {CrowdyProtocolError} if the old proxy does not confirm closure.
+     * @throws Transport or GraphQL errors from the disconnect, refresh, or
+     *   reconnect step, with token state preserved as described above.
+     */
+    refreshGameplayToken(): Promise<AppTokenResponse>;
+    private performGameplayTokenRefresh;
     /**
      * Ergonomic, app-scoped realtime facade. `client.world(appId)` returns a
      * {@link WorldClient} whose `actor()` and `subscribe()` helpers pass `appId`

package/dist/crowdy-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crowdy-client.d.ts","sourceRoot":"","sources":["../src/crowdy-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IAEjC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAGnC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,wEAAwE;IACxE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,mFAAmF;IACnF,QAAQ,CAAC,EAAE;QACT,4EAA4E;QAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iDAAiD;QACjD,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,8EAA8E;QAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,+EAA+E;QAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,qBAAa,YAAY;IACvB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IAGnC,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IACzC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;IACjD,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAGzB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,gFAAgF;IAChF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IAEzC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;gBAEnB,MAAM,GAAE,kBAAuB;IAmG3C,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIpC,0DAA0D;IAC1D,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAIjC;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa;IAS3D,gEAAgE;IAChE,KAAK,IAAI,IAAI;CAId;AAED,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,kBAAuB,GAC9B,YAAY,CAEd"}
+{"version":3,"file":"crowdy-client.d.ts","sourceRoot":"","sources":["../src/crowdy-client.ts"],"names":[],"mappings":"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"}

package/dist/crowdy-client.js

@@ -25,12 +25,13 @@ import { GraphQLClient } from './client.js';
 import { LbCookieStore } from './lb-cookie-store.js';
 import { RealtimeMetrics } from './metrics.js';
 import { SubscriptionManager } from './subscriptions.js';
+import { CrowdyProtocolError } from './errors.js';
 import { WorldClient } from './world.js';
 import { GameKitClient } from './kit/index.js';
 import { AuthAPI } from './domains/auth.js';
 import { UsersAPI } from './domains/users.js';
 import { AppsAPI } from './domains/apps.js';
-import { PortalAPI } from './domains/portal.js';
+import { PortalAPI, } from './domains/portal.js';
 import { PlatformAPI } from './domains/platform.js';
 import { OrganizationsAPI } from './domains/organizations.js';
 import { AppAccessAPI } from './domains/appAccess.js';
@@ -62,6 +63,7 @@ import { MarketplaceAPI } from './domains/marketplace.js';
 import { PlayerModelAPI } from './domains/playerModel.js';
 export class CrowdyClient {
     constructor(config = {}) {
+        this.gameplayTokenRefresh = null;
         this.session = new AuthState(config.tokenStore);
         const lbCookieStore = config.lbCookieStore ?? new LbCookieStore();
         this.graphql = new GraphQLClient({
@@ -146,6 +148,56 @@ export class CrowdyClient {
     getToken() {
         return this.session.getToken();
     }
+    /**
+     * Rotate an active gameplay token without orphaning its old UDP proxy.
+     *
+     * This is the supported refresh path while a game client has an open UDP
+     * proxy: it disconnects that proxy while the old Bearer token is still
+     * active, calls {@link PortalAPI.refresh} to rotate and store the new token,
+     * then opens a proxy authenticated by the new token. The session token
+     * listener restarts the existing realtime subscription in place, so its
+     * registered notification handlers are retained rather than duplicated.
+     * Concurrent calls share one in-flight rotation.
+     *
+     * Failure semantics:
+     * - If the old proxy disconnect rejects or does not confirm closure, rotation
+     *   is aborted and the old token remains active.
+     * - If refresh rejects, the old token remains active (the old proxy has
+     *   already closed and can be opened again with {@link UdpAPI.connect}).
+     * - If opening the new proxy rejects, the fresh token remains active. Surface
+     *   the error and retry {@link UdpAPI.connect}; do not repeat the rotation
+     *   merely to retry that connection.
+     *
+     * @returns The fresh app-scoped token response stored on this client.
+     * @throws {CrowdyProtocolError} if the old proxy does not confirm closure.
+     * @throws Transport or GraphQL errors from the disconnect, refresh, or
+     *   reconnect step, with token state preserved as described above.
+     */
+    async refreshGameplayToken() {
+        if (this.gameplayTokenRefresh)
+            return this.gameplayTokenRefresh;
+        const operation = this.performGameplayTokenRefresh();
+        this.gameplayTokenRefresh = operation;
+        try {
+            return await operation;
+        }
+        finally {
+            if (this.gameplayTokenRefresh === operation) {
+                this.gameplayTokenRefresh = null;
+            }
+        }
+    }
+    async performGameplayTokenRefresh() {
+        const disconnected = await this.udp.disconnect();
+        if (!disconnected) {
+            throw new CrowdyProtocolError({
+                message: 'UDP proxy did not confirm disconnect; gameplay token rotation was aborted',
+            });
+        }
+        const token = await this.portal.refresh();
+        await this.udp.connect();
+        return token;
+    }
     /**
      * Ergonomic, app-scoped realtime facade. `client.world(appId)` returns a
      * {@link WorldClient} whose `actor()` and `subscribe()` helpers pass `appId`

package/dist/domains/marketplace.d.ts

@@ -1,5 +1,5 @@
 import type { GraphQLClient } from '../client.js';
-import { type MarketplaceCreateAccountSessionMutation, type MarketplaceCreateAccountSessionMutationVariables, type MarketplaceCreateOrgAccountSessionMutation, type MarketplaceCreateOrgAccountSessionMutationVariables, type MarketplaceRenewAcquisitionMutationVariables, type MarketplaceTopUpAcquisitionMutationVariables, type MarketplaceRefundAcquisitionMutationVariables, type MarketplaceGridListingsQueryVariables, type MarketplacePurchaseGridMutationVariables, type MarketplaceSetListingPricingMutationVariables, type MarketplaceSetOrgShareMutationVariables, type MarketplaceBeginSellerOnboardingMutationVariables, type MarketplaceBeginOrgSellerOnboardingMutationVariables, type MarketplaceRequestPayoutMutationVariables, type MarketplaceSpendPayoutToWalletMutationVariables, type MarketplaceCommerceRiskQueueQueryVariables, type MarketplaceDecideRiskFlagMutationVariables, type MarketplaceCreateGridListingMutationVariables, type MarketplaceGridListingsQuery, type MarketplacePurchaseGridMutation, type MarketplaceBeginSellerOnboardingMutation, type MarketplaceBeginOrgSellerOnboardingMutation, type MarketplaceMySellerBalanceQuery, type MarketplaceCommerceRiskQueueQuery, type MarketplaceCreateGridListingMutation, type MarketplaceListingsQuery, type MarketplaceListingsQueryVariables, type MarketplaceListingVersionsQuery, type MarketplaceListingVersionsQueryVariables, type MarketplaceMyAcquisitionsQuery, type MarketplaceMyAcquisitionsQueryVariables, type MarketplaceMyInstallsQuery, type MarketplaceMyInstallsQueryVariables, type MarketplaceGridClientModsQuery, type MarketplaceGridClientModsQueryVariables, type MarketplaceClientArtifactQuery, type MarketplaceClientArtifactQueryVariables, type MarketplacePublishListingMutation, type MarketplacePublishListingMutationVariables, type MarketplacePublishVersionMutation, type MarketplacePublishVersionMutationVariables, type MarketplaceAcquireMutation, type MarketplaceAcquireMutationVariables, type MarketplaceInstallMutation, type MarketplaceInstallMutationVariables, type MarketplaceUninstallMutationVariables, type MarketplaceConsentGridClientModMutationVariables, type MarketplaceTrustGridAuthorMutation, type MarketplaceTrustGridAuthorMutationVariables, type MarketplaceGridClaimPolicyQuery, type MarketplaceGridClaimPolicyQueryVariables, type MarketplaceGridClaimRequestsQuery, type MarketplaceGridClaimRequestsQueryVariables, type MarketplaceClaimGridOwnershipMutation, type MarketplaceClaimGridOwnershipMutationVariables, type MarketplaceDecideGridClaimMutation, type MarketplaceDecideGridClaimMutationVariables, type MarketplaceIssueGridClaimInviteMutationVariables, type MarketplaceAdmissionQueueQuery, type MarketplaceAdmissionQueueQueryVariables, type MarketplaceAppListingsQuery, type MarketplaceAppListingsQueryVariables, type MarketplaceAppAcquisitionsQuery, type MarketplaceAppAcquisitionsQueryVariables, type MarketplaceTransferListingMutation, type MarketplaceTransferListingMutationVariables, type MarketplaceSetListingStatusMutation, type MarketplaceSetListingStatusMutationVariables, type MarketplaceSetGridClaimPolicyMutation, type MarketplaceSetGridClaimPolicyMutationVariables } from '../generated/graphql.js';
+import { type MarketplaceCreateAccountSessionMutation, type MarketplaceCreateAccountSessionMutationVariables, type MarketplaceCreateOrgAccountSessionMutation, type MarketplaceCreateOrgAccountSessionMutationVariables, type MarketplaceRenewAcquisitionMutationVariables, type MarketplaceTopUpAcquisitionMutationVariables, type MarketplaceRefundAcquisitionMutationVariables, type MarketplaceGridListingsQueryVariables, type MarketplacePurchaseGridMutationVariables, type MarketplaceSetListingPricingMutationVariables, type MarketplaceSetOrgShareMutationVariables, type MarketplaceBeginSellerOnboardingMutationVariables, type MarketplaceBeginOrgSellerOnboardingMutationVariables, type MarketplaceRequestPayoutMutationVariables, type MarketplaceSpendPayoutToWalletMutationVariables, type MarketplaceCommerceRiskQueueQueryVariables, type MarketplaceDecideRiskFlagMutationVariables, type MarketplaceCreateGridListingMutationVariables, type MarketplaceGridListingsQuery, type MarketplacePurchaseGridMutation, type MarketplaceBeginSellerOnboardingMutation, type MarketplaceBeginOrgSellerOnboardingMutation, type MarketplaceMySellerBalanceQuery, type MarketplaceCommerceRiskQueueQuery, type MarketplaceCreateGridListingMutation, type MarketplaceListingsQuery, type MarketplaceListingsQueryVariables, type MarketplaceListingVersionsQuery, type MarketplaceListingVersionsQueryVariables, type MarketplaceMyAcquisitionsQuery, type MarketplaceMyAcquisitionsQueryVariables, type MarketplaceMyInstallsQuery, type MarketplaceMyInstallsQueryVariables, type MarketplaceGridClientModsQuery, type MarketplaceGridClientModsQueryVariables, type MarketplaceClientArtifactQuery, type MarketplaceClientArtifactQueryVariables, type MarketplacePublishListingMutation, type MarketplacePublishListingMutationVariables, type MarketplacePublishVersionMutation, type MarketplacePublishVersionMutationVariables, type MarketplaceAcquireMutation, type MarketplaceAcquireMutationVariables, type MarketplaceInstallMutation, type MarketplaceInstallMutationVariables, type MarketplaceUninstallMutationVariables, type MarketplaceConsentGridClientModMutationVariables, type MarketplaceTrustGridAuthorMutation, type MarketplaceTrustGridAuthorMutationVariables, type MarketplaceGridClaimPolicyQuery, type MarketplaceGridClaimPolicyQueryVariables, type MarketplaceGridClaimRequestsQuery, type MarketplaceGridClaimRequestsQueryVariables, type MarketplaceClaimGridOwnershipMutation, type MarketplaceClaimGridOwnershipMutationVariables, type MarketplaceClaimGridChunkMutation, type MarketplaceClaimGridChunkMutationVariables, type MarketplaceReleaseClaimedGridMutation, type MarketplaceReleaseClaimedGridMutationVariables, type MarketplaceDecideGridClaimMutation, type MarketplaceDecideGridClaimMutationVariables, type MarketplaceIssueGridClaimInviteMutationVariables, type MarketplaceAdmissionQueueQuery, type MarketplaceAdmissionQueueQueryVariables, type MarketplaceAppListingsQuery, type MarketplaceAppListingsQueryVariables, type MarketplaceAppAcquisitionsQuery, type MarketplaceAppAcquisitionsQueryVariables, type MarketplaceTransferListingMutation, type MarketplaceTransferListingMutationVariables, type MarketplaceSetListingStatusMutation, type MarketplaceSetListingStatusMutationVariables, type MarketplaceSetGridClaimPolicyMutation, type MarketplaceSetGridClaimPolicyMutationVariables } from '../generated/graphql.js';
 /**
  * The P4a player-code marketplace (free mode) — exposed as
  * `client.marketplace`. Player-facing browse/publish/acquire/install/consent
@@ -67,6 +67,17 @@ export declare class MarketplaceAPI {
     gridClaimRequests(variables: MarketplaceGridClaimRequestsQueryVariables): Promise<MarketplaceGridClaimRequestsQuery['gridClaimRequests']>;
     /** Claim grid ownership under the app policy (server-authorized, D4). */
     claimGridOwnership(variables: MarketplaceClaimGridOwnershipMutationVariables): Promise<MarketplaceClaimGridOwnershipMutation['claimGridOwnership']>;
+    /**
+     * Atomically create and claim one chunk under the app's SELF_CLAIM policy.
+     * Uses the authenticated player, rejects protected/overlapping chunks, and
+     * returns authoritative bounds plus effective build/mod permissions.
+     */
+    claimGridChunk(variables: MarketplaceClaimGridChunkMutationVariables): Promise<MarketplaceClaimGridChunkMutation['claimGridChunk']>;
+    /**
+     * Release a one-chunk grid created by `claimGridChunk`. The authenticated
+     * caller must still own the claim; other grid origins cannot be released.
+     */
+    releaseClaimedGrid(variables: MarketplaceReleaseClaimedGridMutationVariables): Promise<MarketplaceReleaseClaimedGridMutation['releaseClaimedGrid']>;
     /** Approve or deny a pending claim request (approvers/staff). */
     decideGridClaim(variables: MarketplaceDecideGridClaimMutationVariables): Promise<MarketplaceDecideGridClaimMutation['decideGridClaim']>;
     /** Issue a standing claim invite (approvers/staff; INVITE mode). */

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

@@ -1 +1 @@
-{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../../src/domains/marketplace.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../../src/domains/marketplace.ts"],"names":[],"mappings":"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"}

package/dist/domains/marketplace.js

@@ -1,4 +1,4 @@
-import { MarketplaceListingsDocument, MarketplaceListingVersionsDocument, MarketplaceMyAcquisitionsDocument, MarketplaceMyInstallsDocument, MarketplaceGridClientModsDocument, MarketplaceClientArtifactDocument, MarketplacePublishListingDocument, MarketplacePublishVersionDocument, MarketplaceAcquireDocument, MarketplaceInstallDocument, MarketplaceUninstallDocument, MarketplaceConsentGridClientModDocument, MarketplaceTrustGridAuthorDocument, MarketplaceGridClaimPolicyDocument, MarketplaceGridClaimRequestsDocument, MarketplaceClaimGridOwnershipDocument, MarketplaceDecideGridClaimDocument, MarketplaceIssueGridClaimInviteDocument, MarketplaceAdmissionQueueDocument, MarketplaceAppListingsDocument, MarketplaceAppAcquisitionsDocument, MarketplaceTransferListingDocument, MarketplaceSetListingStatusDocument, MarketplaceSetGridClaimPolicyDocument, MarketplaceRenewAcquisitionDocument, MarketplaceTopUpAcquisitionDocument, MarketplaceRefundAcquisitionDocument, MarketplaceGridListingsDocument, MarketplacePurchaseGridDocument, MarketplaceSetListingPricingDocument, MarketplaceSetOrgShareDocument, MarketplaceBeginSellerOnboardingDocument, MarketplaceBeginOrgSellerOnboardingDocument, MarketplaceCreateAccountSessionDocument, MarketplaceCreateOrgAccountSessionDocument, MarketplaceMySellerBalanceDocument, MarketplaceRequestPayoutDocument, MarketplaceSpendPayoutToWalletDocument, MarketplaceCommerceRiskQueueDocument, MarketplaceDecideRiskFlagDocument, MarketplaceCreateGridListingDocument, } from '../generated/graphql.js';
+import { MarketplaceListingsDocument, MarketplaceListingVersionsDocument, MarketplaceMyAcquisitionsDocument, MarketplaceMyInstallsDocument, MarketplaceGridClientModsDocument, MarketplaceClientArtifactDocument, MarketplacePublishListingDocument, MarketplacePublishVersionDocument, MarketplaceAcquireDocument, MarketplaceInstallDocument, MarketplaceUninstallDocument, MarketplaceConsentGridClientModDocument, MarketplaceTrustGridAuthorDocument, MarketplaceGridClaimPolicyDocument, MarketplaceGridClaimRequestsDocument, MarketplaceClaimGridOwnershipDocument, MarketplaceClaimGridChunkDocument, MarketplaceReleaseClaimedGridDocument, MarketplaceDecideGridClaimDocument, MarketplaceIssueGridClaimInviteDocument, MarketplaceAdmissionQueueDocument, MarketplaceAppListingsDocument, MarketplaceAppAcquisitionsDocument, MarketplaceTransferListingDocument, MarketplaceSetListingStatusDocument, MarketplaceSetGridClaimPolicyDocument, MarketplaceRenewAcquisitionDocument, MarketplaceTopUpAcquisitionDocument, MarketplaceRefundAcquisitionDocument, MarketplaceGridListingsDocument, MarketplacePurchaseGridDocument, MarketplaceSetListingPricingDocument, MarketplaceSetOrgShareDocument, MarketplaceBeginSellerOnboardingDocument, MarketplaceBeginOrgSellerOnboardingDocument, MarketplaceCreateAccountSessionDocument, MarketplaceCreateOrgAccountSessionDocument, MarketplaceMySellerBalanceDocument, MarketplaceRequestPayoutDocument, MarketplaceSpendPayoutToWalletDocument, MarketplaceCommerceRiskQueueDocument, MarketplaceDecideRiskFlagDocument, MarketplaceCreateGridListingDocument, } from '../generated/graphql.js';
 /**
  * The P4a player-code marketplace (free mode) — exposed as
  * `client.marketplace`. Player-facing browse/publish/acquire/install/consent
@@ -125,6 +125,23 @@ export class MarketplaceAPI {
         const data = await this.game.request(MarketplaceClaimGridOwnershipDocument, variables);
         return data.claimGridOwnership;
     }
+    /**
+     * Atomically create and claim one chunk under the app's SELF_CLAIM policy.
+     * Uses the authenticated player, rejects protected/overlapping chunks, and
+     * returns authoritative bounds plus effective build/mod permissions.
+     */
+    async claimGridChunk(variables) {
+        const data = await this.game.request(MarketplaceClaimGridChunkDocument, variables);
+        return data.claimGridChunk;
+    }
+    /**
+     * Release a one-chunk grid created by `claimGridChunk`. The authenticated
+     * caller must still own the claim; other grid origins cannot be released.
+     */
+    async releaseClaimedGrid(variables) {
+        const data = await this.game.request(MarketplaceReleaseClaimedGridDocument, variables);
+        return data.releaseClaimedGrid;
+    }
     /** Approve or deny a pending claim request (approvers/staff). */
     async decideGridClaim(variables) {
         const data = await this.game.request(MarketplaceDecideGridClaimDocument, variables);

package/dist/generated/graphql.d.ts

@@ -904,6 +904,24 @@ export type Chunk = {
     /** BASE64-encoded binary blob of the dense voxel-type grid. When present, the DECODED buffer is exactly 4096 bytes: one unsigned byte (voxel type 0-255) per voxel, indexed as x + y*16 + z*256 with x,y,z in 0-15. Null when the chunk has no voxel grid yet. Decode from base64 before reading. */
     voxels: Maybe<Scalars['String']['output']>;
 };
+/** Authoritative result of an ordinary player claiming one chunk as a new grid under SELF_CLAIM. Grid creation, title assignment, and direct ACL grants are committed atomically. */
+export type ChunkClaimResult = {
+    __typename?: 'ChunkClaimResult';
+    /** Full effective runtime permission-key set materialized for the caller on the new grid after grid limits are applied. */
+    effectivePermissionKeys: Array<Scalars['String']['output']>;
+    /** Id of the one-chunk grid created for this claim. */
+    gridId: Scalars['BigInt']['output'];
+    /** High corner of the claimed grid. It equals lowChunk because a player claim covers exactly one chunk. */
+    highChunk: ChunkCoordinates;
+    /** Low corner of the claimed grid. It equals highChunk because a player claim covers exactly one chunk. */
+    lowChunk: ChunkCoordinates;
+    /** True when the effective ACL contains both write and run permission for at least one player-code target (server or client). */
+    moddable: Scalars['Boolean']['output'];
+    /** New current user ownership record created atomically with the grid. */
+    ownership: GridOwnership;
+    /** App claim policy applied by the server. This mutation succeeds only for SELF_CLAIM. */
+    policy: GridClaimPolicy;
+};
 /** Integer (x, y, z) address of a 16x16x16-voxel chunk within an app's world grid. Each unit step moves one whole chunk (16 voxels) along that axis. Components are signed 64-bit integers serialized as decimal strings (see the BigInt scalar). */
 export type ChunkCoordinates = {
     __typename?: 'ChunkCoordinates';
@@ -3566,6 +3584,8 @@ export type Mutation = {
     changePassword: Scalars['Boolean']['output'];
     /** Self-service: the authenticated caller claims access to an app via its free, open-by-default tier. Requires authentication only (no org membership needed). ENTITLEMENT CHANGE: grants the free default tier as a 'system' grant and notifies the game API. Idempotent: returns the existing row if already granted, and never overrides a prior revoke. Errors if the app has no free default tier or is archived. */
     claimFreeAppAccess: AppUserAccess;
+    /** Claim one currently unclaimed chunk as a new player-owned grid. Requires an ordinary app-scoped player token and active app access, but never manage_apps. The app's policy must be SELF_CLAIM. The server validates the app's grid assignment and peer-overlap rules, then atomically creates a one-chunk grid, assigns current-user ownership, grants access/update_voxel_data/use_voice_chat/teleport plus player-code keys already carried by the caller's tier, and materializes the effective ACL. Conflicts and policy denials throw GraphQL errors; no partial grid, ownership, or grant rows remain. */
+    claimGridChunk: ChunkClaimResult;
     /** Claim grid ownership under the app's claim policy (D4, server-authorized — no client manage_apps involved). SELF_CLAIM assigns ownership immediately; APPROVAL creates a pending request for designated approvers; INVITE requires a standing invite (consumed on use); MARKETPLACE_ONLY refuses (ownership arrives only via grid purchase, P4b). The grid must exist and have no current owner; game rules gate who may attempt a claim. */
     claimGridOwnership: GridClaimResult;
     /** Complete a magic-link sign-in with the emailed token; returns a session AuthResponse. Public (the token authorizes the call); throws if invalid/expired/used. */
@@ -3808,6 +3828,8 @@ export type Mutation = {
     refundPlayerCodeAcquisition: Scalars['Int']['output'];
     /** Registers a new email + password account: creates the (initially unconfirmed) account, emails a confirmation link, and returns an AuthResponse with a session `token` for immediate use (send as `Authorization: Bearer <token>`). If an account already exists for the email (e.g. created via magic link/social), the password is attached pending email confirmation and no session is returned (throws CONFLICT). Public. */
     register: AuthResponse;
+    /** Release a one-chunk grid previously created through claimGridChunk. Requires an ordinary app-scoped player token and the caller must still be its current user owner. Refuses foreign grids, studio/marketplace grids, and grids assigned through legacy claimGridOwnership. Atomically removes active install attachments, self-claim ownership, direct/effective ACL rows, and the grid so its chunk can be claimed again. Player modules on the grid are deleted by the grid cascade. */
+    releaseClaimedGrid: ReleaseClaimedGridResult;
     /** Remove a member from a channel. Requires the 'manage_members' channel permission, except that any member may remove themselves. Notifies Buddy to stop routing to the removed member. Returns true if a membership was removed. */
     removeChannelMember: Scalars['Boolean']['output'];
     /** Removes a user from an organization. Requires the 'manage_members' permission on the org (super admins bypass). DESTRUCTIVE: revokes the user's membership and role assignments in that org. Returns false if the user was not a member. */
@@ -4046,6 +4068,10 @@ export type MutationChangePasswordArgs = {
 export type MutationClaimFreeAppAccessArgs = {
     appId: Scalars['BigInt']['input'];
 };
+export type MutationClaimGridChunkArgs = {
+    appId: Scalars['BigInt']['input'];
+    chunk: ChunkCoordinatesInput;
+};
 export type MutationClaimGridOwnershipArgs = {
     appId: Scalars['BigInt']['input'];
     gridId: Scalars['BigInt']['input'];
@@ -4467,6 +4493,10 @@ export type MutationRefundPlayerCodeAcquisitionArgs = {
 export type MutationRegisterArgs = {
     registerUserInput: RegisterUserInput;
 };
+export type MutationReleaseClaimedGridArgs = {
+    appId: Scalars['BigInt']['input'];
+    gridId: Scalars['BigInt']['input'];
+};
 export type MutationRemoveChannelMemberArgs = {
     groupId: Scalars['BigInt']['input'];
     userId: Scalars['BigInt']['input'];
@@ -6917,6 +6947,20 @@ export type RegisterUserInput = {
     /** Password for the new account (min 8 characters). */
     password: Scalars['String']['input'];
 };
+/** Result of releasing a grid created by the caller through claimGridChunk. The ownership, direct/effective ACL, and grid have been removed atomically, making its chunk claimable again. */
+export type ReleaseClaimedGridResult = {
+    __typename?: 'ReleaseClaimedGridResult';
+    /** Id of the self-claimed grid that was removed. */
+    gridId: Scalars['BigInt']['output'];
+    /** High corner of the removed one-chunk grid. */
+    highChunk: ChunkCoordinates;
+    /** Low corner of the removed one-chunk grid. */
+    lowChunk: ChunkCoordinates;
+    /** Claim policy under which the removed grid was created. */
+    policy: GridClaimPolicy;
+    /** True after the ownership, ACL rows, and grid were removed in one committed transaction. */
+    released: Scalars['Boolean']['output'];
+};
 /** Request an emailed magic-link to sign in (passwordless). */
 export type RequestLoginLinkInput = {
     /** Email address to send the one-time sign-in link to. */
@@ -13647,6 +13691,67 @@ export type MarketplaceClaimGridOwnershipMutation = {
         claimRequestId: string | null;
     };
 };
+export type MarketplaceClaimGridChunkMutationVariables = Exact<{
+    appId: Scalars['BigInt']['input'];
+    chunk: ChunkCoordinatesInput;
+}>;
+export type MarketplaceClaimGridChunkMutation = {
+    __typename?: 'Mutation';
+    claimGridChunk: {
+        __typename?: 'ChunkClaimResult';
+        gridId: string;
+        policy: GridClaimPolicy;
+        moddable: boolean;
+        effectivePermissionKeys: Array<string>;
+        lowChunk: {
+            __typename?: 'ChunkCoordinates';
+            x: string;
+            y: string;
+            z: string;
+        };
+        highChunk: {
+            __typename?: 'ChunkCoordinates';
+            x: string;
+            y: string;
+            z: string;
+        };
+        ownership: {
+            __typename?: 'GridOwnership';
+            gridOwnershipId: string;
+            ownerKind: GridOwnerKind;
+            ownerRef: string;
+            tenure: GridTenure;
+            acquiredVia: string;
+            acquiredAt: string;
+            expiresAt: string | null;
+        };
+    };
+};
+export type MarketplaceReleaseClaimedGridMutationVariables = Exact<{
+    appId: Scalars['BigInt']['input'];
+    gridId: Scalars['BigInt']['input'];
+}>;
+export type MarketplaceReleaseClaimedGridMutation = {
+    __typename?: 'Mutation';
+    releaseClaimedGrid: {
+        __typename?: 'ReleaseClaimedGridResult';
+        gridId: string;
+        policy: GridClaimPolicy;
+        released: boolean;
+        lowChunk: {
+            __typename?: 'ChunkCoordinates';
+            x: string;
+            y: string;
+            z: string;
+        };
+        highChunk: {
+            __typename?: 'ChunkCoordinates';
+            x: string;
+            y: string;
+            z: string;
+        };
+    };
+};
 export type MarketplaceDecideGridClaimMutationVariables = Exact<{
     appId: Scalars['BigInt']['input'];
     requestId: Scalars['String']['input'];
@@ -17219,6 +17324,8 @@ export declare const MarketplaceConsentGridClientModDocument: DocumentNode<Marke
 export declare const MarketplaceGridClaimPolicyDocument: DocumentNode<MarketplaceGridClaimPolicyQuery, MarketplaceGridClaimPolicyQueryVariables>;
 export declare const MarketplaceGridClaimRequestsDocument: DocumentNode<MarketplaceGridClaimRequestsQuery, MarketplaceGridClaimRequestsQueryVariables>;
 export declare const MarketplaceClaimGridOwnershipDocument: DocumentNode<MarketplaceClaimGridOwnershipMutation, MarketplaceClaimGridOwnershipMutationVariables>;
+export declare const MarketplaceClaimGridChunkDocument: DocumentNode<MarketplaceClaimGridChunkMutation, MarketplaceClaimGridChunkMutationVariables>;
+export declare const MarketplaceReleaseClaimedGridDocument: DocumentNode<MarketplaceReleaseClaimedGridMutation, MarketplaceReleaseClaimedGridMutationVariables>;
 export declare const MarketplaceDecideGridClaimDocument: DocumentNode<MarketplaceDecideGridClaimMutation, MarketplaceDecideGridClaimMutationVariables>;
 export declare const MarketplaceIssueGridClaimInviteDocument: DocumentNode<MarketplaceIssueGridClaimInviteMutation, MarketplaceIssueGridClaimInviteMutationVariables>;
 export declare const MarketplaceAdmissionQueueDocument: DocumentNode<MarketplaceAdmissionQueueQuery, MarketplaceAdmissionQueueQueryVariables>;