@crowdedkingdoms/crowdyjs 8.1.0 → 8.3.0

package/dist/kit/matches.d.ts

@@ -0,0 +1,140 @@
+import type { ChannelsAPI } from '../domains/channels.js';
+import type { GameModelAPI } from '../domains/gameModel.js';
+import type { UdpAPI } from '../domains/udp.js';
+import type { Scalars } from '../generated/graphql.js';
+import { type KitInvokeResult } from './shared.js';
+/** Options for {@link MatchesKit}. Must match the deployed matches blueprint. */
+export interface MatchesKitOptions {
+    /** The `typePrefix` the matches blueprint was deployed with. */
+    typePrefix?: string;
+    /**
+     * The 32-ASCII-char actor uuid used as the sender id on channel pings.
+     * Defaults to a random uuid per kit instance.
+     */
+    actorUuid?: string;
+}
+/** A parsed view of one match. */
+export interface KitMatch {
+    /** The session backing the match (participants + turn order). */
+    sessionId: string;
+    /** The MatchMeta container id (the `self` of the lifecycle functions). */
+    metaId: string;
+    displayName: string;
+    creatorUserId: number;
+    mode: string;
+    state: string;
+    round: number;
+    maxPlayers: number;
+    winnerUserId: number;
+    /** The per-match notification channel (0 when none was wired). */
+    channelId: string;
+    /** Present when the blueprint was deployed with `turnTick`. */
+    tickCount?: number;
+}
+/** One row of the match standings. */
+export interface KitMatchScore {
+    containerId: string;
+    ownerUserId: string | null;
+    points: number;
+}
+/**
+ * Runtime helpers for the {@link matchesBlueprint} conventions: sessions ARE
+ * the match primitive — `create` makes a session + a `MatchMeta` + a
+ * per-match channel; turn order goes through the platform's session-turn
+ * authority; lifecycle functions ping the channel post-commit and
+ * {@link onMatchChanged} wraps the notify-to-pull loop (subscribe →
+ * `"match_changed"` ping → re-pull state).
+ *
+ * Obtained via `client.kit(appId).matches`.
+ */
+export declare class MatchesKit {
+    private readonly appId;
+    private readonly gameModel;
+    private readonly channels;
+    private readonly udp;
+    private readonly names;
+    private readonly actorUuid;
+    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, channels: ChannelsAPI | undefined, udp: UdpAPI | undefined, options?: MatchesKitOptions);
+    private requireChannels;
+    private requireUdp;
+    /**
+     * Create a match: a session (the platform match primitive), a per-match
+     * notification channel, and the session-scoped `MatchMeta`.
+     *
+     * @param input.creatorUserId - The calling player's user id (stored so the
+     *   creator may start/advance/end the match).
+     */
+    create(input: {
+        creatorUserId: Scalars['BigInt']['input'];
+        mode?: string;
+        maxPlayers?: number;
+        displayName?: string;
+    }): Promise<KitMatch>;
+    /** List joinable matches (metas still in the lobby state). */
+    open(): Promise<KitMatch[]>;
+    /** Read one match by its MatchMeta container. */
+    get(metaId: string): Promise<KitMatch>;
+    /** Join a match: session participation + the notification channel. */
+    join(match: KitMatch): Promise<{
+        __typename?: "GmSessionParticipant";
+        sessionId: string;
+        userId: string;
+        role: string;
+    }>;
+    /** Start the match (creator or host). Pings the match channel post-commit. */
+    start(match: KitMatch): Promise<KitInvokeResult<string>>;
+    /** Advance to the next round (creator or host). */
+    advanceRound(match: KitMatch): Promise<KitInvokeResult<number>>;
+    /** Whether it is `userId`'s session turn right now. */
+    myTurn(match: KitMatch, userId: Scalars['BigInt']['input']): Promise<boolean>;
+    /**
+     * Pass the turn to the next player via the platform's session-turn
+     * authority (current holder, host, or admin — enforced by the service),
+     * then ping the match channel so everyone re-pulls.
+     */
+    endTurn(match: KitMatch, nextUserId: Scalars['BigInt']['input']): Promise<{
+        __typename?: "GmSession";
+        sessionId: string;
+        appId: string;
+        name: string | null;
+        status: string;
+        createdByUserId: string | null;
+        currentTurnUserId: string | null;
+        metadataJson: string;
+    }>;
+    /** Find-or-create a player's session-scoped Score row. */
+    ensureScore(match: KitMatch, ownerUserId: Scalars['BigInt']['input']): Promise<{
+        __typename?: "GmContainer";
+        containerId: string;
+        appId: string;
+        sessionId: string | null;
+        typeName: string;
+        displayName: string;
+        description: string | null;
+        ownerUserId: string | null;
+        metadataJson: string;
+    }>;
+    /**
+     * Add points to a Score row — trusted (host-refereed by default).
+     * Resolves with the new points.
+     */
+    score(match: KitMatch, scoreId: string, points: number): Promise<KitInvokeResult<number>>;
+    /** The match standings, highest points first (client-side sort). */
+    standings(match: KitMatch): Promise<KitMatchScore[]>;
+    /** Finish the match and record the winner (creator or host). */
+    finish(match: KitMatch, winnerUserId: Scalars['BigInt']['input']): Promise<KitInvokeResult<string>>;
+    /**
+     * Manually ping the match channel with `"match_changed"` (the lifecycle
+     * functions do this automatically via their declared notifications; use
+     * this after out-of-band changes such as `endTurn`).
+     */
+    notifyChanged(match: KitMatch): Promise<boolean>;
+    /**
+     * The notify-to-pull loop, wrapped: subscribe to the app's notifications,
+     * and on every ping of THIS match's channel re-pull the match state and
+     * hand it to `callback`. Returns the unsubscribe function.
+     */
+    onMatchChanged(match: KitMatch, callback: (match: KitMatch) => void): () => void;
+    private toMatch;
+}
+//# sourceMappingURL=matches.d.ts.map

package/dist/kit/matches.d.ts.map

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

package/dist/kit/matches.js

@@ -0,0 +1,253 @@
+import { encodeBase64, generateCrowdyUuid } from '../utils.js';
+import { matchesNames } from './blueprints/index.js';
+import { kitContainerProperties, kitInvoke, } from './shared.js';
+/**
+ * Runtime helpers for the {@link matchesBlueprint} conventions: sessions ARE
+ * the match primitive — `create` makes a session + a `MatchMeta` + a
+ * per-match channel; turn order goes through the platform's session-turn
+ * authority; lifecycle functions ping the channel post-commit and
+ * {@link onMatchChanged} wraps the notify-to-pull loop (subscribe →
+ * `"match_changed"` ping → re-pull state).
+ *
+ * Obtained via `client.kit(appId).matches`.
+ */
+export class MatchesKit {
+    constructor(appId, gameModel, channels, udp, options = {}) {
+        this.appId = appId;
+        this.gameModel = gameModel;
+        this.channels = channels;
+        this.udp = udp;
+        this.names = matchesNames(options.typePrefix ?? '');
+        this.actorUuid = options.actorUuid ?? generateCrowdyUuid();
+    }
+    requireChannels() {
+        if (!this.channels) {
+            throw new Error('kit.matches needs the channels domain — construct the kit via client.kit(appId)');
+        }
+        return this.channels;
+    }
+    requireUdp() {
+        if (!this.udp) {
+            throw new Error('kit.matches needs the udp domain — construct the kit via client.kit(appId)');
+        }
+        return this.udp;
+    }
+    /**
+     * Create a match: a session (the platform match primitive), a per-match
+     * notification channel, and the session-scoped `MatchMeta`.
+     *
+     * @param input.creatorUserId - The calling player's user id (stored so the
+     *   creator may start/advance/end the match).
+     */
+    async create(input) {
+        const session = await this.gameModel.createSession({
+            appId: this.appId,
+            name: input.displayName ?? `match-${input.mode ?? 'default'}`,
+        });
+        const channel = await this.requireChannels().create({
+            appId: this.appId,
+            name: `match-${session.sessionId}`,
+            description: 'Per-match notification channel (kit.matches notify-to-pull).',
+        });
+        const meta = await this.gameModel.createContainer({
+            appId: this.appId,
+            typeName: this.names.metaType,
+            displayName: input.displayName ?? `Match ${session.sessionId}`,
+            sessionId: session.sessionId,
+            properties: [
+                {
+                    key: 'creator_user_id',
+                    valueType: 'int',
+                    valueJson: String(input.creatorUserId),
+                },
+                { key: 'mode', valueType: 'string', valueJson: JSON.stringify(input.mode ?? '') },
+                {
+                    key: 'max_players',
+                    valueType: 'int',
+                    valueJson: String(input.maxPlayers ?? 0),
+                },
+                { key: 'channel_id', valueType: 'int', valueJson: String(channel.groupId) },
+            ],
+        });
+        return this.toMatch(meta.containerId, session.sessionId, meta.displayName);
+    }
+    /** List joinable matches (metas still in the lobby state). */
+    async open() {
+        const metas = await this.gameModel.containers({
+            appId: this.appId,
+            typeName: this.names.metaType,
+        });
+        const matches = await Promise.all(metas
+            .filter((m) => m.sessionId != null)
+            .map((m) => this.toMatch(m.containerId, String(m.sessionId), m.displayName)));
+        return matches.filter((m) => m.state === 'lobby');
+    }
+    /** Read one match by its MatchMeta container. */
+    async get(metaId) {
+        const meta = await this.gameModel.container({
+            appId: this.appId,
+            containerId: metaId,
+        });
+        return this.toMatch(meta.containerId, meta.sessionId != null ? String(meta.sessionId) : '', meta.displayName);
+    }
+    /** Join a match: session participation + the notification channel. */
+    async join(match) {
+        const participant = await this.gameModel.joinSession({
+            appId: this.appId,
+            sessionId: match.sessionId,
+        });
+        if (match.channelId !== '0' && match.channelId !== '') {
+            await this.requireChannels().join(match.channelId);
+        }
+        return participant;
+    }
+    /** Start the match (creator or host). Pings the match channel post-commit. */
+    async start(match) {
+        return kitInvoke(this.gameModel, {
+            appId: String(this.appId),
+            functionName: this.names.startFn,
+            selfContainerId: match.metaId,
+            sessionId: match.sessionId,
+            params: {},
+        });
+    }
+    /** Advance to the next round (creator or host). */
+    async advanceRound(match) {
+        return kitInvoke(this.gameModel, {
+            appId: String(this.appId),
+            functionName: this.names.advanceRoundFn,
+            selfContainerId: match.metaId,
+            sessionId: match.sessionId,
+            params: {},
+        });
+    }
+    /** Whether it is `userId`'s session turn right now. */
+    async myTurn(match, userId) {
+        const session = await this.gameModel.session({
+            appId: this.appId,
+            sessionId: match.sessionId,
+        });
+        return (session.currentTurnUserId != null &&
+            String(session.currentTurnUserId) === String(userId));
+    }
+    /**
+     * Pass the turn to the next player via the platform's session-turn
+     * authority (current holder, host, or admin — enforced by the service),
+     * then ping the match channel so everyone re-pulls.
+     */
+    async endTurn(match, nextUserId) {
+        const session = await this.gameModel.setSessionTurn({
+            appId: this.appId,
+            sessionId: match.sessionId,
+            userId: nextUserId,
+        });
+        await this.notifyChanged(match);
+        return session;
+    }
+    /** Find-or-create a player's session-scoped Score row. */
+    async ensureScore(match, ownerUserId) {
+        const scores = await this.gameModel.containers({
+            appId: this.appId,
+            typeName: this.names.scoreType,
+            sessionId: match.sessionId,
+        });
+        const mine = scores.find((c) => c.ownerUserId != null && String(c.ownerUserId) === String(ownerUserId));
+        if (mine)
+            return mine;
+        return this.gameModel.createContainer({
+            appId: this.appId,
+            typeName: this.names.scoreType,
+            displayName: `Score ${ownerUserId}`,
+            sessionId: match.sessionId,
+            properties: [
+                { key: 'owner_user_id', valueType: 'int', valueJson: String(ownerUserId) },
+            ],
+        });
+    }
+    /**
+     * Add points to a Score row — trusted (host-refereed by default).
+     * Resolves with the new points.
+     */
+    async score(match, scoreId, points) {
+        return kitInvoke(this.gameModel, {
+            appId: String(this.appId),
+            functionName: this.names.scoreFn,
+            selfContainerId: scoreId,
+            sessionId: match.sessionId,
+            params: { points },
+        });
+    }
+    /** The match standings, highest points first (client-side sort). */
+    async standings(match) {
+        const scores = await this.gameModel.containers({
+            appId: this.appId,
+            typeName: this.names.scoreType,
+            sessionId: match.sessionId,
+        });
+        const rows = await Promise.all(scores.map(async (c) => {
+            const props = await kitContainerProperties(this.gameModel, String(this.appId), c.containerId);
+            return {
+                containerId: c.containerId,
+                ownerUserId: c.ownerUserId != null ? String(c.ownerUserId) : null,
+                points: Number(props.points ?? 0),
+            };
+        }));
+        return rows.sort((a, b) => b.points - a.points);
+    }
+    /** Finish the match and record the winner (creator or host). */
+    async finish(match, winnerUserId) {
+        return kitInvoke(this.gameModel, {
+            appId: String(this.appId),
+            functionName: this.names.endFn,
+            selfContainerId: match.metaId,
+            sessionId: match.sessionId,
+            params: { winner_user_id: Number(winnerUserId) },
+        });
+    }
+    /**
+     * Manually ping the match channel with `"match_changed"` (the lifecycle
+     * functions do this automatically via their declared notifications; use
+     * this after out-of-band changes such as `endTurn`).
+     */
+    async notifyChanged(match) {
+        if (match.channelId === '0' || match.channelId === '')
+            return false;
+        return this.requireUdp().sendChannelMessage({
+            channelId: match.channelId,
+            uuid: this.actorUuid,
+            payload: encodeBase64(new TextEncoder().encode('match_changed')),
+        });
+    }
+    /**
+     * The notify-to-pull loop, wrapped: subscribe to the app's notifications,
+     * and on every ping of THIS match's channel re-pull the match state and
+     * hand it to `callback`. Returns the unsubscribe function.
+     */
+    onMatchChanged(match, callback) {
+        return this.requireUdp().subscribe({
+            channelMessage: (notification) => {
+                if (String(notification.channelId) !== String(match.channelId))
+                    return;
+                void this.get(match.metaId).then(callback);
+            },
+        }, String(this.appId));
+    }
+    async toMatch(metaId, sessionId, displayName) {
+        const props = await kitContainerProperties(this.gameModel, String(this.appId), metaId);
+        return {
+            sessionId,
+            metaId,
+            displayName,
+            creatorUserId: Number(props.creator_user_id ?? 0),
+            mode: String(props.mode ?? ''),
+            state: String(props.state ?? ''),
+            round: Number(props.round ?? 0),
+            maxPlayers: Number(props.max_players ?? 0),
+            winnerUserId: Number(props.winner_user_id ?? 0),
+            channelId: String(props.channel_id ?? '0'),
+            ...(props.tick_count !== undefined
+                ? { tickCount: Number(props.tick_count) }
+                : {}),
+        };
+    }
+}

package/dist/kit/npcs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"npcs.d.ts","sourceRoot":"","sources":["../../src/kit/npcs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG1E,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,OAAO;IAIhB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAGf,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,cAAmB;IAK9B,0EAA0E;IACpE,KAAK,CAAC,KAAK,EAAE;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;QACjC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;;;;;;;;;;;IAuBD;;;;OAIG;IACG,IAAI,CAAC,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAclF,gDAAgD;IAC1C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ3C,8EAA8E;IACxE,MAAM,CAAC,cAAc,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;IAInC;;;OAGG;IACG,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQzD,6EAA6E;IACvE,KAAK,CAAC,aAAa,CAAC,EAAE,MAAM;;;;;;;;;;;;sBA+B8lgc,CAAC;;;;;;;;;;IAxBjogc,2DAA2D;IACrD,IAAI,CAAC,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;;;;;;;;;;;;;;;;;;;;;;YAIzE,KAAK;CAkBpB"}
+{"version":3,"file":"npcs.d.ts","sourceRoot":"","sources":["../../src/kit/npcs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG1E,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,OAAO;IAIhB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAGf,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,cAAmB;IAK9B,0EAA0E;IACpE,KAAK,CAAC,KAAK,EAAE;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;QACjC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;;;;;;;;;;;IAuBD;;;;OAIG;IACG,IAAI,CAAC,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAclF,gDAAgD;IAC1C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ3C,8EAA8E;IACxE,MAAM,CAAC,cAAc,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;IAInC;;;OAGG;IACG,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQzD,6EAA6E;IACvE,KAAK,CAAC,aAAa,CAAC,EAAE,MAAM;;;;;;;;;;;;sBA+B+2gc,CAAC;;;;;;;;;;IAxBl5gc,2DAA2D;IACrD,IAAI,CAAC,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;;;;;;;;;;;;;;;;;;;;;;YAIzE,KAAK;CAkBpB"}

package/dist/kit/objects.d.ts

@@ -25,12 +25,20 @@ export declare class ObjectsKit {
     /**
      * Instantiate a lockable object (admin/studio call — the type is
      * admin-instantiable). For key-gated objects set `requiredKeyId` to the key
-     * id that opens it; for owner-gated objects set `ownerUserId`.
+     * id that opens it; for owner-gated objects set `ownerUserId`; for
+     * chunk-permission-gated objects set `chunk` to where the object stands
+     * (feeds the `has_chunk_permission` policy).
      */
     create(input: {
         displayName: string;
         requiredKeyId?: string;
         ownerUserId?: Scalars['BigInt']['input'];
+        /** The chunk the object occupies (chunkPermission authority). */
+        chunk?: {
+            x: number;
+            y: number;
+            z: number;
+        };
         properties?: SeedPropertyInput[];
         sessionId?: string;
     }): Promise<{

package/dist/kit/objects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../src/kit/objects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE1E,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,qBAAa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAGf,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,iBAAsB;IAKjC;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACzC,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;QACjC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;;;;;;;;;;;IAwBD;;;;OAIG;IACG,QAAQ,CAAC,KAAK,EAAE;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACrC,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;;;;;;;;;;;IAiBD,yCAAyC;IACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;;;;;;;;;;;IAU/C;;;;OAIG;IACG,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/B,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IASpC,8DAA8D;IACxD,KAAK,CACT,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/B,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IASpC,gDAAgD;IAC1C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAShD,8CAA8C;IACxC,IAAI,CAAC,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;;;;;;;;;;;CAOhD"}
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../src/kit/objects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE1E,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,qBAAa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAGf,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,iBAAsB;IAKjC;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACzC,iEAAiE;QACjE,KAAK,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5C,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;QACjC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;;;;;;;;;;;IA+BD;;;;OAIG;IACG,QAAQ,CAAC,KAAK,EAAE;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACrC,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;;;;;;;;;;;IAiBD,yCAAyC;IACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;;;;;;;;;;;IAU/C;;;;OAIG;IACG,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/B,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IASpC,8DAA8D;IACxD,KAAK,CACT,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/B,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IASpC,gDAAgD;IAC1C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAShD,8CAA8C;IACxC,IAAI,CAAC,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;;;;;;;;;;;CAOhD"}

package/dist/kit/objects.js

@@ -1,4 +1,4 @@
-import { lockNames } from './blueprints.js';
+import { lockNames } from './blueprints/index.js';
 import { kitContainerProperties, kitInvoke, } from './shared.js';
 /**
  * Runtime helpers for the {@link lockBlueprint} conventions: instantiate
@@ -18,7 +18,9 @@ export class ObjectsKit {
     /**
      * Instantiate a lockable object (admin/studio call — the type is
      * admin-instantiable). For key-gated objects set `requiredKeyId` to the key
-     * id that opens it; for owner-gated objects set `ownerUserId`.
+     * id that opens it; for owner-gated objects set `ownerUserId`; for
+     * chunk-permission-gated objects set `chunk` to where the object stands
+     * (feeds the `has_chunk_permission` policy).
      */
     async create(input) {
         const properties = [
@@ -32,6 +34,13 @@ export class ObjectsKit {
                     },
                 ]
                 : []),
+            ...(input.chunk
+                ? [
+                    { key: 'cx', valueType: 'int', valueJson: String(input.chunk.x) },
+                    { key: 'cy', valueType: 'int', valueJson: String(input.chunk.y) },
+                    { key: 'cz', valueType: 'int', valueJson: String(input.chunk.z) },
+                ]
+                : []),
             ...(input.properties ?? []),
         ];
         return this.gameModel.createContainer({

package/dist/kit/plots.d.ts

@@ -0,0 +1,81 @@
+import type { GameAppsAPI } from '../domains/gameApps.js';
+import type { GameModelAPI } from '../domains/gameModel.js';
+import type { Scalars, SeedPropertyInput } from '../generated/graphql.js';
+import { type KitInvokeResult } from './shared.js';
+/** Options for {@link PlotsKit}. Must match the deployed plot blueprint. */
+export interface PlotsKitOptions {
+    /** The `typeName` the plot blueprint was deployed with. Defaults to `'Plot'`. */
+    typeName?: string;
+}
+/** A parsed view of one plot. */
+export interface KitPlot {
+    containerId: string;
+    displayName: string;
+    gridId: number;
+    price: number;
+    /** 0 when unowned. */
+    ownerUserId: number;
+    rentPrice?: number;
+    rentTtlSeconds?: number;
+}
+/**
+ * Runtime helpers for the {@link plotBlueprint} conventions: list/create
+ * plots and drive the buy/rent/evict functions whose permission effects grant
+ * or revoke real, replication-enforced grid permissions transactionally with
+ * the currency mutation. Authorization (wallet ownership, price, plot
+ * ownership) is enforced server-side — a denial resolves with
+ * `success: false`, never an exception.
+ *
+ * Obtained via `client.kit(appId).plots`.
+ */
+export declare class PlotsKit {
+    private readonly appId;
+    private readonly gameModel;
+    private readonly gameApps;
+    private readonly names;
+    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, gameApps: GameAppsAPI, options?: PlotsKitOptions);
+    /**
+     * Instantiate a plot over an existing grid (admin — the type is
+     * admin-instantiable). Create the grid first (`client.gameApps.createGrid`)
+     * and pass its id here.
+     */
+    create(input: {
+        displayName: string;
+        gridId: Scalars['BigInt']['input'];
+        price: number;
+        rentPrice?: number;
+        rentTtlSeconds?: number;
+        properties?: SeedPropertyInput[];
+    }): Promise<{
+        __typename?: "GmContainer";
+        containerId: string;
+        appId: string;
+        sessionId: string | null;
+        typeName: string;
+        displayName: string;
+        description: string | null;
+        ownerUserId: string | null;
+        metadataJson: string;
+    }>;
+    /** List plots with parsed state (grid, price, current owner). */
+    list(): Promise<KitPlot[]>;
+    /**
+     * Buy a plot: spends the price from the caller's wallet AND grants the
+     * blueprint's grid permissions in one transaction. Resolves with the
+     * wallet's remaining balance.
+     */
+    buy(plotId: string, walletId: string): Promise<KitInvokeResult<number>>;
+    /**
+     * Rent a plot (blueprint deployed with `rentable: true`): like {@link buy}
+     * but the grant expires after the plot's `rent_ttl_seconds`.
+     */
+    rent(plotId: string, walletId: string): Promise<KitInvokeResult<number>>;
+    /** Revoke a user's permissions on a plot (plot owner or app admin). */
+    evict(plotId: string, targetUserId: Scalars['BigInt']['input']): Promise<KitInvokeResult>;
+    /**
+     * A user's effective permission keys on a plot's grid (for HUD display —
+     * enforcement happens server-side regardless).
+     */
+    accessOf(userId: Scalars['BigInt']['input'], gridId: Scalars['BigInt']['input']): Promise<string[]>;
+}
+//# sourceMappingURL=plots.d.ts.map

package/dist/kit/plots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plots.d.ts","sourceRoot":"","sources":["../../src/kit/plots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE1E,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,iCAAiC;AACjC,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,qBAAa,QAAQ;IAIjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAGf,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,WAAW,EACtC,OAAO,GAAE,eAAoB;IAK/B;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACnC,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;KAClC;;;;;;;;;;;IA0BD,iEAAiE;IAC3D,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IA2BhC;;;;OAIG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAS7E;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAS9E,uEAAuE;IACjE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAS/F;;;OAGG;IACG,QAAQ,CACZ,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAClC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GACjC,OAAO,CAAC,MAAM,EAAE,CAAC;CAQrB"}

package/dist/kit/plots.js

@@ -0,0 +1,113 @@
+import { plotNames } from './blueprints/index.js';
+import { kitContainerProperties, kitInvoke, } from './shared.js';
+/**
+ * Runtime helpers for the {@link plotBlueprint} conventions: list/create
+ * plots and drive the buy/rent/evict functions whose permission effects grant
+ * or revoke real, replication-enforced grid permissions transactionally with
+ * the currency mutation. Authorization (wallet ownership, price, plot
+ * ownership) is enforced server-side — a denial resolves with
+ * `success: false`, never an exception.
+ *
+ * Obtained via `client.kit(appId).plots`.
+ */
+export class PlotsKit {
+    constructor(appId, gameModel, gameApps, options = {}) {
+        this.appId = appId;
+        this.gameModel = gameModel;
+        this.gameApps = gameApps;
+        this.names = plotNames(options.typeName);
+    }
+    /**
+     * Instantiate a plot over an existing grid (admin — the type is
+     * admin-instantiable). Create the grid first (`client.gameApps.createGrid`)
+     * and pass its id here.
+     */
+    async create(input) {
+        const properties = [
+            { key: 'grid_id', valueType: 'int', valueJson: String(input.gridId) },
+            { key: 'price', valueType: 'int', valueJson: String(input.price) },
+            ...(input.rentPrice !== undefined
+                ? [{ key: 'rent_price', valueType: 'int', valueJson: String(input.rentPrice) }]
+                : []),
+            ...(input.rentTtlSeconds !== undefined
+                ? [
+                    {
+                        key: 'rent_ttl_seconds',
+                        valueType: 'int',
+                        valueJson: String(input.rentTtlSeconds),
+                    },
+                ]
+                : []),
+            ...(input.properties ?? []),
+        ];
+        return this.gameModel.createContainer({
+            appId: this.appId,
+            typeName: this.names.plotType,
+            displayName: input.displayName,
+            properties,
+        });
+    }
+    /** List plots with parsed state (grid, price, current owner). */
+    async list() {
+        const containers = await this.gameModel.containers({
+            appId: this.appId,
+            typeName: this.names.plotType,
+        });
+        return Promise.all(containers.map(async (c) => {
+            const props = await kitContainerProperties(this.gameModel, String(this.appId), c.containerId);
+            return {
+                containerId: c.containerId,
+                displayName: c.displayName,
+                gridId: Number(props.grid_id ?? 0),
+                price: Number(props.price ?? 0),
+                ownerUserId: Number(props.owner_user_id ?? 0),
+                ...(props.rent_price !== undefined ? { rentPrice: Number(props.rent_price) } : {}),
+                ...(props.rent_ttl_seconds !== undefined
+                    ? { rentTtlSeconds: Number(props.rent_ttl_seconds) }
+                    : {}),
+            };
+        }));
+    }
+    /**
+     * Buy a plot: spends the price from the caller's wallet AND grants the
+     * blueprint's grid permissions in one transaction. Resolves with the
+     * wallet's remaining balance.
+     */
+    async buy(plotId, walletId) {
+        return kitInvoke(this.gameModel, {
+            appId: String(this.appId),
+            functionName: this.names.buyFn,
+            selfContainerId: plotId,
+            params: { wallet_id: walletId },
+        });
+    }
+    /**
+     * Rent a plot (blueprint deployed with `rentable: true`): like {@link buy}
+     * but the grant expires after the plot's `rent_ttl_seconds`.
+     */
+    async rent(plotId, walletId) {
+        return kitInvoke(this.gameModel, {
+            appId: String(this.appId),
+            functionName: this.names.rentFn,
+            selfContainerId: plotId,
+            params: { wallet_id: walletId },
+        });
+    }
+    /** Revoke a user's permissions on a plot (plot owner or app admin). */
+    async evict(plotId, targetUserId) {
+        return kitInvoke(this.gameModel, {
+            appId: String(this.appId),
+            functionName: this.names.evictFn,
+            selfContainerId: plotId,
+            params: { target_user_id: Number(targetUserId) },
+        });
+    }
+    /**
+     * A user's effective permission keys on a plot's grid (for HUD display —
+     * enforcement happens server-side regardless).
+     */
+    async accessOf(userId, gridId) {
+        const res = await this.gameApps.userPermissions(String(this.appId), String(gridId), String(userId));
+        return [...res.permissionKeys];
+    }
+}