@crowdedkingdoms/crowdyjs 8.8.0 → 8.9.0

package/dist/kit/liveops.js

@@ -0,0 +1,183 @@
+import { liveopsNames } from './blueprints/liveops.js';
+import { kitContainerProperties, kitInvoke } from './shared.js';
+import { parseEngineEvent, EVENT_ZONE_CHANGE } from './wire.js';
+/**
+ * Runtime helpers for the liveops blueprint: event windows (admin CRUD +
+ * active reads — engine-backed when the liveops-scheduler is deployed),
+ * seasons with battle-pass composition, and the type-98 zone-change parser.
+ *
+ * Obtained via `client.kit(appId).liveops`.
+ */
+export class LiveopsKit {
+    constructor(appId, gameModel, options = {}, engines) {
+        this.appId = appId;
+        this.gameModel = gameModel;
+        this.engines = engines;
+        this.names = liveopsNames(options.typePrefix ?? '');
+        this.moduleName = options.moduleName ?? 'liveops-scheduler';
+    }
+    /** Is the liveops-scheduler engine deployed + enabled (cached)? */
+    engineAvailable() {
+        if (!this.engines)
+            return Promise.resolve(false);
+        return this.engines.has(this.moduleName);
+    }
+    /** STUDIO (admin) — create an event window. */
+    async defineWindow(input) {
+        return this.gameModel.createContainer({
+            appId: this.appId,
+            typeName: this.names.windowType,
+            displayName: input.displayName ?? `Window ${input.windowId}`,
+            properties: [
+                { key: 'window_id', valueType: 'string', valueJson: JSON.stringify(input.windowId) },
+                ...(input.opensAtMs !== undefined
+                    ? [{ key: 'opens_at_ms', valueType: 'int', valueJson: String(input.opensAtMs) }]
+                    : []),
+                ...(input.closesAtMs !== undefined
+                    ? [{ key: 'closes_at_ms', valueType: 'int', valueJson: String(input.closesAtMs) }]
+                    : []),
+                {
+                    key: 'modifiers',
+                    valueType: 'string',
+                    valueJson: JSON.stringify(JSON.stringify(input.modifiers ?? {})),
+                },
+            ],
+        });
+    }
+    /** Every window (model read). */
+    async windows() {
+        const containers = await this.gameModel.containers({
+            appId: this.appId,
+            typeName: this.names.windowType,
+        });
+        return Promise.all(containers.map(async (c) => {
+            const props = await kitContainerProperties(this.gameModel, String(this.appId), c.containerId);
+            let modifiers = {};
+            try {
+                modifiers = JSON.parse(String(props.modifiers ?? '{}'));
+            }
+            catch {
+                /* opaque */
+            }
+            return {
+                containerId: c.containerId,
+                windowId: String(props.window_id ?? ''),
+                active: props.active === true,
+                opensAtMs: Number(props.opens_at_ms ?? 0),
+                closesAtMs: Number(props.closes_at_ms ?? 0),
+                modifiers,
+            };
+        }));
+    }
+    /**
+     * The ACTIVE windows. Engine path (scheduler deployed): the module's
+     * authoritative view; otherwise filters the model read.
+     */
+    async activeWindows() {
+        if (this.engines && (await this.engineAvailable())) {
+            const result = await this.engines.invoke(this.moduleName, 'active_windows', {});
+            if (result.success && Array.isArray(result.body.windows)) {
+                const all = await this.windows();
+                const activeIds = new Set(result.body.windows.map((w) => String(w.windowId)));
+                return all.filter((w) => activeIds.has(w.windowId));
+            }
+        }
+        return (await this.windows()).filter((w) => w.active);
+    }
+    /** STUDIO (admin/automation) — open a window through the model function. */
+    async openWindow(windowContainerId, sessionId) {
+        return kitInvoke(this.gameModel, {
+            appId: String(this.appId),
+            functionName: this.names.openWindowFn,
+            selfContainerId: windowContainerId,
+            ...(sessionId !== undefined ? { sessionId } : {}),
+        });
+    }
+    /** STUDIO (admin/automation) — close a window through the model function. */
+    async closeWindow(windowContainerId, sessionId) {
+        return kitInvoke(this.gameModel, {
+            appId: String(this.appId),
+            functionName: this.names.closeWindowFn,
+            selfContainerId: windowContainerId,
+            ...(sessionId !== undefined ? { sessionId } : {}),
+        });
+    }
+    /** STUDIO (admin) — create a season (+ battle-pass composition). */
+    async defineSeason(input) {
+        return this.gameModel.createContainer({
+            appId: this.appId,
+            typeName: this.names.seasonType,
+            displayName: input.displayName ?? `Season ${input.seasonId}`,
+            properties: [
+                { key: 'season_id', valueType: 'string', valueJson: JSON.stringify(input.seasonId) },
+                ...(input.startsAtMs !== undefined
+                    ? [{ key: 'starts_at_ms', valueType: 'int', valueJson: String(input.startsAtMs) }]
+                    : []),
+                ...(input.endsAtMs !== undefined
+                    ? [{ key: 'ends_at_ms', valueType: 'int', valueJson: String(input.endsAtMs) }]
+                    : []),
+                ...(input.passTrack !== undefined
+                    ? [{ key: 'pass_track', valueType: 'string', valueJson: JSON.stringify(input.passTrack) }]
+                    : []),
+                {
+                    key: 'pass_features',
+                    valueType: 'string',
+                    valueJson: JSON.stringify(JSON.stringify(input.passFeatures ?? [])),
+                },
+            ],
+        });
+    }
+    /** Every season (model read). */
+    async seasons() {
+        const containers = await this.gameModel.containers({
+            appId: this.appId,
+            typeName: this.names.seasonType,
+        });
+        return Promise.all(containers.map(async (c) => {
+            const props = await kitContainerProperties(this.gameModel, String(this.appId), c.containerId);
+            let passFeatures = [];
+            try {
+                passFeatures = JSON.parse(String(props.pass_features ?? '[]')).map(String);
+            }
+            catch {
+                /* opaque */
+            }
+            return {
+                containerId: c.containerId,
+                seasonId: String(props.season_id ?? ''),
+                active: props.active === true,
+                startsAtMs: Number(props.starts_at_ms ?? 0),
+                endsAtMs: Number(props.ends_at_ms ?? 0),
+                passTrack: String(props.pass_track ?? ''),
+                passFeatures,
+            };
+        }));
+    }
+    /** The active season, when one exists. */
+    async currentSeason() {
+        return (await this.seasons()).find((s) => s.active) ?? null;
+    }
+    /** STUDIO (admin/automation) — activate a season through the model function. */
+    async activateSeason(seasonContainerId, sessionId) {
+        return kitInvoke(this.gameModel, {
+            appId: String(this.appId),
+            functionName: this.names.activateSeasonFn,
+            selfContainerId: seasonContainerId,
+            ...(sessionId !== undefined ? { sessionId } : {}),
+        });
+    }
+    /** Parse a type-98 zone-change server event (BR circles, event areas). */
+    parseZoneChange(bytes) {
+        const parsed = parseEngineEvent(bytes);
+        if (!parsed || parsed.eventType !== EVENT_ZONE_CHANGE)
+            return null;
+        return {
+            kind: String(parsed.body.kind ?? ''),
+            phase: parsed.body.phase != null ? Number(parsed.body.phase) : null,
+            radiusNow: Number(parsed.body.radiusNow ?? 0),
+            centerX: Number(parsed.body.centerX ?? 0),
+            centerZ: Number(parsed.body.centerZ ?? 0),
+            body: parsed.body,
+        };
+    }
+}

package/dist/kit/loot.d.ts

@@ -1,8 +1,14 @@
 import type { GameModelAPI } from '../domains/gameModel.js';
+import type { EngineDetector } from './engine.js';
 import type { Scalars } from '../generated/graphql.js';
 import { type KitInvokeResult } from './shared.js';
 /** Options for {@link LootKit}. Must match the deployed loot blueprint. */
 export interface LootKitOptions {
+    /**
+     * The big-table loot module (pity timers, audit trails). Defaults to
+     * `'loot-engine'`; the gacha-shrine example ships this contract.
+     */
+    engineModuleName?: string;
     /** The `typePrefix` the loot blueprint was deployed with. */
     typePrefix?: string;
 }
@@ -29,9 +35,24 @@ export interface KitLootRoll {
 export declare class LootKit {
     private readonly appId;
     private readonly gameModel;
+    private readonly engines?;
     private readonly names;
     private readonly typePrefix;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: LootKitOptions);
+    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: LootKitOptions, engines?: EngineDetector | undefined);
+    private readonly engineModuleName;
+    /**
+     * Is a big-table loot module deployed + enabled (cached per session)?
+     * When true, {@link enginePull} routes rolls through server-held RNG with
+     * pity timers + audit trails; the blueprint's weighted model rolls stay
+     * for small tables (the coexistence policy — "the server picks the path").
+     */
+    engineAvailable(): Promise<boolean>;
+    /** Pull from the module's table (pity-timer path); count caps at 10. */
+    enginePull(count?: number): Promise<Record<string, unknown>>;
+    /** Your pity counters + roll totals from the module. */
+    enginePity(): Promise<Record<string, unknown>>;
+    /** Your rolling audit trail from the module (dispute resolution). */
+    engineAudit(): Promise<Record<string, unknown>>;
     /**
      * Create an unrolled `LootRoll` for a table, owned by `ownerUserId` (who
      * will claim it). Event-drop automations pick from the pool of unrolled

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

@@ -1 +1 @@
-{"version":3,"file":"loot.d.ts","sourceRoot":"","sources":["../../src/kit/loot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,qBAAa,OAAO;IAKhB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGjB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,cAAmB;IAM9B;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE;QACtB,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;;;;;;;;;;;IAqBD;;;;;;OAMG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAU9E;;;;OAIG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAShF,6BAA6B;IACvB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAYjD;;;OAGG;IACG,KAAK,CACT,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACvC,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GAC1D,OAAO,CAAC,WAAW,EAAE,CAAC;IAwBzB;;;OAGG;IACG,OAAO,CACX,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;;;;;;;;;;;;;;;;;YAYtC,MAAM;CAoBrB"}
+{"version":3,"file":"loot.d.ts","sourceRoot":"","sources":["../../src/kit/loot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,qBAAa,OAAO;IAKhB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAP3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGjB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,cAAmB,EACX,OAAO,CAAC,EAAE,cAAc,YAAA;IAO3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C;;;;;OAKG;IACH,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAKnC,wEAAwE;IAClE,UAAU,CAAC,KAAK,SAAI;IAO1B,wDAAwD;IAClD,UAAU;IAOhB,qEAAqE;IAC/D,WAAW;IAOjB;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE;QACtB,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;;;;;;;;;;;IAqBD;;;;;;OAMG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAU9E;;;;OAIG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAShF,6BAA6B;IACvB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAYjD;;;OAGG;IACG,KAAK,CACT,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACvC,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GAC1D,OAAO,CAAC,WAAW,EAAE,CAAC;IAwBzB;;;OAGG;IACG,OAAO,CACX,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;;;;;;;;;;;;;;;;;YAYtC,MAAM;CAoBrB"}

package/dist/kit/loot.js

@@ -10,11 +10,51 @@ import { kitContainerProperties, kitInvoke, } from './shared.js';
  * Obtained via `client.kit(appId).loot`.
  */
 export class LootKit {
-    constructor(appId, gameModel, options = {}) {
+    constructor(appId, gameModel, options = {}, engines) {
         this.appId = appId;
         this.gameModel = gameModel;
+        this.engines = engines;
         this.typePrefix = options.typePrefix ?? '';
         this.names = lootNames(this.typePrefix);
+        this.engineModuleName = options.engineModuleName ?? 'loot-engine';
+    }
+    /**
+     * Is a big-table loot module deployed + enabled (cached per session)?
+     * When true, {@link enginePull} routes rolls through server-held RNG with
+     * pity timers + audit trails; the blueprint's weighted model rolls stay
+     * for small tables (the coexistence policy — "the server picks the path").
+     */
+    engineAvailable() {
+        if (!this.engines)
+            return Promise.resolve(false);
+        return this.engines.has(this.engineModuleName);
+    }
+    /** Pull from the module's table (pity-timer path); count caps at 10. */
+    async enginePull(count = 1) {
+        if (!this.engines)
+            throw new Error('loot engine unavailable: compute domain not wired');
+        const result = await this.engines.invoke(this.engineModuleName, 'pull', { count });
+        if (!result.success)
+            throw new Error(`loot.pull failed: ${result.reason ?? 'unknown'}`);
+        return result.body;
+    }
+    /** Your pity counters + roll totals from the module. */
+    async enginePity() {
+        if (!this.engines)
+            throw new Error('loot engine unavailable: compute domain not wired');
+        const result = await this.engines.invoke(this.engineModuleName, 'pity', {});
+        if (!result.success)
+            throw new Error(`loot.pity failed: ${result.reason ?? 'unknown'}`);
+        return result.body;
+    }
+    /** Your rolling audit trail from the module (dispute resolution). */
+    async engineAudit() {
+        if (!this.engines)
+            throw new Error('loot engine unavailable: compute domain not wired');
+        const result = await this.engines.invoke(this.engineModuleName, 'audit', {});
+        if (!result.success)
+            throw new Error(`loot.audit failed: ${result.reason ?? 'unknown'}`);
+        return result.body;
     }
     /**
      * Create an unrolled `LootRoll` for a table, owned by `ownerUserId` (who

package/dist/kit/moderation.d.ts

@@ -0,0 +1,73 @@
+import type { GameModelAPI } from '../domains/gameModel.js';
+import type { Scalars } from '../generated/graphql.js';
+/** Options for {@link ModerationKit}. */
+export interface ModerationKitOptions {
+    /** The `typePrefix` the moderation blueprint was deployed with. */
+    typePrefix?: string;
+}
+/** A parsed report row. */
+export interface KitModReport {
+    containerId: string;
+    reporterUserId: string;
+    subjectUserId: string;
+    reason: string;
+    detail: string;
+    status: string;
+    resolution: string;
+    filedAtMs: number;
+}
+/**
+ * Runtime helpers for the moderation blueprint: file reports, read the
+ * admin escalation queue, resolve reports, and manage the caller's personal
+ * mute list (client-enforced chat filtering). Enforcement stays on platform
+ * surfaces — tier revocation and grid permissions.
+ *
+ * Obtained via `client.kit(appId).moderation`.
+ */
+export declare class ModerationKit {
+    private readonly appId;
+    private readonly gameModel;
+    private readonly names;
+    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: ModerationKitOptions);
+    /** File a report (creates the caller's report row in the queue). */
+    report(input: {
+        reporterUserId: string;
+        subjectUserId: string;
+        reason: string;
+        detail?: string;
+    }): Promise<{
+        __typename?: "GmContainer";
+        containerId: string;
+        appId: string;
+        sessionId: string | null;
+        typeName: string;
+        displayName: string;
+        description: string | null;
+        ownerUserId: string | null;
+        metadataJson: string;
+    }>;
+    /** The escalation queue (admins; filter by status, default `'open'`). */
+    queue(status?: string): Promise<KitModReport[]>;
+    /** ADMIN — resolve a report with a disposition. */
+    resolve(reportContainerId: string, status: 'actioned' | 'dismissed', resolution: string): Promise<import("./shared.js").KitInvokeResult<string>>;
+    /** Mute a player (adds to YOUR client-enforced mute list). */
+    mute(ownerUserId: string, mutedUserId: string): Promise<{
+        __typename?: "GmContainer";
+        containerId: string;
+        appId: string;
+        sessionId: string | null;
+        typeName: string;
+        displayName: string;
+        description: string | null;
+        ownerUserId: string | null;
+        metadataJson: string;
+    }>;
+    /** Unmute: delete the matching mute row. */
+    unmute(ownerUserId: string, mutedUserId: string): Promise<boolean>;
+    /** The caller's mute list (feed it to your chat renderer). */
+    mutes(ownerUserId: string): Promise<Array<{
+        containerId: string;
+        mutedUserId: string;
+    }>>;
+}
+//# sourceMappingURL=moderation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"moderation.d.ts","sourceRoot":"","sources":["../../src/kit/moderation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAIvD,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,2BAA2B;AAC3B,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,qBAAa,aAAa;IAItB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;gBAGrB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,oBAAyB;IAKpC,oEAAoE;IAC9D,MAAM,CAAC,KAAK,EAAE;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;;;;;;;;;;;IAeD,yEAAyE;IACnE,KAAK,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyBrD,mDAAmD;IAC7C,OAAO,CAAC,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW,EAAE,UAAU,EAAE,MAAM;IAS7F,8DAA8D;IACxD,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;;;;;;;;;;;IAYnD,4CAA4C;IACtC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQxE,8DAA8D;IACxD,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAmB/F"}

package/dist/kit/moderation.js

@@ -0,0 +1,103 @@
+import { moderationNames } from './blueprints/moderation.js';
+import { kitContainerProperties, kitInvoke } from './shared.js';
+/**
+ * Runtime helpers for the moderation blueprint: file reports, read the
+ * admin escalation queue, resolve reports, and manage the caller's personal
+ * mute list (client-enforced chat filtering). Enforcement stays on platform
+ * surfaces — tier revocation and grid permissions.
+ *
+ * Obtained via `client.kit(appId).moderation`.
+ */
+export class ModerationKit {
+    constructor(appId, gameModel, options = {}) {
+        this.appId = appId;
+        this.gameModel = gameModel;
+        this.names = moderationNames(options.typePrefix ?? '');
+    }
+    /** File a report (creates the caller's report row in the queue). */
+    async report(input) {
+        return this.gameModel.createContainer({
+            appId: this.appId,
+            typeName: this.names.reportType,
+            displayName: `report ${input.reason} vs ${input.subjectUserId}`,
+            properties: [
+                { key: 'reporter_user_id', valueType: 'string', valueJson: JSON.stringify(input.reporterUserId) },
+                { key: 'subject_user_id', valueType: 'string', valueJson: JSON.stringify(input.subjectUserId) },
+                { key: 'reason', valueType: 'string', valueJson: JSON.stringify(input.reason) },
+                { key: 'detail', valueType: 'string', valueJson: JSON.stringify((input.detail ?? '').slice(0, 500)) },
+                { key: 'filed_at_ms', valueType: 'int', valueJson: String(Date.now()) },
+            ],
+        });
+    }
+    /** The escalation queue (admins; filter by status, default `'open'`). */
+    async queue(status = 'open') {
+        const containers = await this.gameModel.containers({
+            appId: this.appId,
+            typeName: this.names.reportType,
+        });
+        const rows = await Promise.all(containers.map(async (c) => {
+            const props = await kitContainerProperties(this.gameModel, String(this.appId), c.containerId);
+            return {
+                containerId: c.containerId,
+                reporterUserId: String(props.reporter_user_id ?? ''),
+                subjectUserId: String(props.subject_user_id ?? ''),
+                reason: String(props.reason ?? ''),
+                detail: String(props.detail ?? ''),
+                status: String(props.status ?? 'open'),
+                resolution: String(props.resolution ?? ''),
+                filedAtMs: Number(props.filed_at_ms ?? 0),
+            };
+        }));
+        return rows
+            .filter((r) => !status || r.status === status)
+            .sort((a, b) => a.filedAtMs - b.filedAtMs);
+    }
+    /** ADMIN — resolve a report with a disposition. */
+    async resolve(reportContainerId, status, resolution) {
+        return kitInvoke(this.gameModel, {
+            appId: String(this.appId),
+            functionName: this.names.resolveReportFn,
+            selfContainerId: reportContainerId,
+            params: { status, resolution },
+        });
+    }
+    /** Mute a player (adds to YOUR client-enforced mute list). */
+    async mute(ownerUserId, mutedUserId) {
+        return this.gameModel.createContainer({
+            appId: this.appId,
+            typeName: this.names.muteType,
+            displayName: `mute ${mutedUserId}`,
+            properties: [
+                { key: 'owner_user_id', valueType: 'string', valueJson: JSON.stringify(ownerUserId) },
+                { key: 'muted_user_id', valueType: 'string', valueJson: JSON.stringify(mutedUserId) },
+            ],
+        });
+    }
+    /** Unmute: delete the matching mute row. */
+    async unmute(ownerUserId, mutedUserId) {
+        const mutes = await this.mutes(ownerUserId);
+        const row = mutes.find((m) => m.mutedUserId === mutedUserId);
+        if (!row)
+            return false;
+        await this.gameModel.deleteContainer({ appId: this.appId, containerId: row.containerId });
+        return true;
+    }
+    /** The caller's mute list (feed it to your chat renderer). */
+    async mutes(ownerUserId) {
+        const containers = await this.gameModel.containers({
+            appId: this.appId,
+            typeName: this.names.muteType,
+        });
+        const rows = await Promise.all(containers.map(async (c) => {
+            const props = await kitContainerProperties(this.gameModel, String(this.appId), c.containerId);
+            return {
+                containerId: c.containerId,
+                ownerUserId: String(props.owner_user_id ?? ''),
+                mutedUserId: String(props.muted_user_id ?? ''),
+            };
+        }));
+        return rows
+            .filter((r) => r.ownerUserId === String(ownerUserId))
+            .map(({ containerId, mutedUserId }) => ({ containerId, mutedUserId }));
+    }
+}

package/dist/kit/movement.d.ts

@@ -0,0 +1,78 @@
+import type { GameModelAPI } from '../domains/gameModel.js';
+import type { Scalars } from '../generated/graphql.js';
+import type { EngineDetector } from './engine.js';
+import { type MovementViolationEvent } from './wire.js';
+/** Options for {@link MovementKit}. */
+export interface MovementKitOptions {
+    /** The warden module name. Defaults to `'movement-warden'`. */
+    moduleName?: string;
+    /** The warden-config container type. Defaults to `'WardenConfig'`. */
+    configTypeName?: string;
+}
+/** A user's violation book as the warden reports it. */
+export interface KitViolations {
+    userId: string;
+    speed: number;
+    teleport: number;
+    bounds: number;
+    log: Array<{
+        atMs: number;
+        kind: string;
+        detail: string;
+    }>;
+}
+/**
+ * Runtime helpers for the movement-warden (Wave 3, observe/flag posture):
+ * read violation books, inspect the live envelope config, and parse type-95
+ * violation events. The warden never corrects or kicks — client prediction
+ * stays exactly as it is; games decide what flags mean (scoreboard shame,
+ * moderation reports, tournament DQs).
+ *
+ * Client-prediction guidance: keep your movement client-authoritative and
+ * SMOOTH — the envelopes are generous (speed tolerance + one-sample jitter
+ * forgiveness) so honest clients never flag; teleports (fast travel,
+ * respawns) should be paired with game-known context you can correlate
+ * against the violation log.
+ *
+ * Obtained via `client.kit(appId).movement`.
+ */
+export declare class MovementKit {
+    private readonly appId;
+    private readonly gameModel;
+    private readonly engines;
+    private readonly moduleName;
+    private readonly configTypeName;
+    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, engines: EngineDetector, options?: MovementKitOptions);
+    /** Is the warden deployed + enabled (cached per session)? */
+    engineAvailable(): Promise<boolean>;
+    /** A user's violation book (your own without an argument). */
+    violations(userId?: string): Promise<KitViolations>;
+    /** The live envelope configuration (posture is always `'observe'` v1). */
+    config(): Promise<Record<string, unknown>>;
+    /** Warden totals (watched actors, flagged users, samples). */
+    status(): Promise<Record<string, unknown>>;
+    /** STUDIO (admin) — create/adjust the WardenConfig container. */
+    defineConfig(input: {
+        displayName?: string;
+        chunk?: [number, number, number];
+        radiusXz?: number;
+        maxSpeed?: number;
+        maxTeleport?: number;
+        bounds?: [number, number, number, number];
+        tolerancePct?: number;
+    }): Promise<{
+        __typename?: "GmContainer";
+        containerId: string;
+        appId: string;
+        sessionId: string | null;
+        typeName: string;
+        displayName: string;
+        description: string | null;
+        ownerUserId: string | null;
+        metadataJson: string;
+    }>;
+    /** Parse a type-95 movement-violation server event. */
+    parseViolation(bytes: Uint8Array): MovementViolationEvent | null;
+    private invoke;
+}
+//# sourceMappingURL=movement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"movement.d.ts","sourceRoot":"","sources":["../../src/kit/movement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAA0B,KAAK,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEhF,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAGrB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,cAAc,EACxC,OAAO,GAAE,kBAAuB;IAMlC,6DAA6D;IAC7D,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAInC,8DAA8D;IACxD,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBzD,0EAA0E;IACpE,MAAM;IAIZ,8DAA8D;IACxD,MAAM;IAIZ,iEAAiE;IAC3D,YAAY,CAAC,KAAK,EAAE;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;;;;;;;;;;;IAsCD,uDAAuD;IACvD,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,sBAAsB,GAAG,IAAI;YAIlD,MAAM;CAOrB"}

package/dist/kit/movement.js

@@ -0,0 +1,103 @@
+import { parseMovementViolation } from './wire.js';
+/**
+ * Runtime helpers for the movement-warden (Wave 3, observe/flag posture):
+ * read violation books, inspect the live envelope config, and parse type-95
+ * violation events. The warden never corrects or kicks — client prediction
+ * stays exactly as it is; games decide what flags mean (scoreboard shame,
+ * moderation reports, tournament DQs).
+ *
+ * Client-prediction guidance: keep your movement client-authoritative and
+ * SMOOTH — the envelopes are generous (speed tolerance + one-sample jitter
+ * forgiveness) so honest clients never flag; teleports (fast travel,
+ * respawns) should be paired with game-known context you can correlate
+ * against the violation log.
+ *
+ * Obtained via `client.kit(appId).movement`.
+ */
+export class MovementKit {
+    constructor(appId, gameModel, engines, options = {}) {
+        this.appId = appId;
+        this.gameModel = gameModel;
+        this.engines = engines;
+        this.moduleName = options.moduleName ?? 'movement-warden';
+        this.configTypeName = options.configTypeName ?? 'WardenConfig';
+    }
+    /** Is the warden deployed + enabled (cached per session)? */
+    engineAvailable() {
+        return this.engines.has(this.moduleName);
+    }
+    /** A user's violation book (your own without an argument). */
+    async violations(userId) {
+        const body = await this.invoke('violations', userId ? { userId } : {});
+        return {
+            userId: String(body.userId ?? ''),
+            speed: Number(body.speed ?? 0),
+            teleport: Number(body.teleport ?? 0),
+            bounds: Number(body.bounds ?? 0),
+            log: Array.isArray(body.log)
+                ? body.log.map((entry) => ({
+                    atMs: Number(entry.atMs ?? 0),
+                    kind: String(entry.kind ?? ''),
+                    detail: String(entry.detail ?? ''),
+                }))
+                : [],
+        };
+    }
+    /** The live envelope configuration (posture is always `'observe'` v1). */
+    async config() {
+        return this.invoke('config', {});
+    }
+    /** Warden totals (watched actors, flagged users, samples). */
+    async status() {
+        return this.invoke('status', {});
+    }
+    /** STUDIO (admin) — create/adjust the WardenConfig container. */
+    async defineConfig(input) {
+        const properties = [
+            ...(input.chunk
+                ? [
+                    { key: 'chunk_x', valueType: 'int', valueJson: String(input.chunk[0]) },
+                    { key: 'chunk_y', valueType: 'int', valueJson: String(input.chunk[1]) },
+                    { key: 'chunk_z', valueType: 'int', valueJson: String(input.chunk[2]) },
+                ]
+                : []),
+            ...(input.radiusXz !== undefined
+                ? [{ key: 'radius_xz', valueType: 'int', valueJson: String(input.radiusXz) }]
+                : []),
+            ...(input.maxSpeed !== undefined
+                ? [{ key: 'max_speed', valueType: 'int', valueJson: String(input.maxSpeed) }]
+                : []),
+            ...(input.maxTeleport !== undefined
+                ? [{ key: 'max_teleport', valueType: 'int', valueJson: String(input.maxTeleport) }]
+                : []),
+            ...(input.bounds
+                ? [
+                    { key: 'min_x', valueType: 'int', valueJson: String(input.bounds[0]) },
+                    { key: 'max_x', valueType: 'int', valueJson: String(input.bounds[1]) },
+                    { key: 'min_z', valueType: 'int', valueJson: String(input.bounds[2]) },
+                    { key: 'max_z', valueType: 'int', valueJson: String(input.bounds[3]) },
+                ]
+                : []),
+            ...(input.tolerancePct !== undefined
+                ? [{ key: 'tolerance_pct', valueType: 'int', valueJson: String(input.tolerancePct) }]
+                : []),
+        ];
+        return this.gameModel.createContainer({
+            appId: this.appId,
+            typeName: this.configTypeName,
+            displayName: input.displayName ?? 'warden-config',
+            properties,
+        });
+    }
+    /** Parse a type-95 movement-violation server event. */
+    parseViolation(bytes) {
+        return parseMovementViolation(bytes);
+    }
+    async invoke(exportName, params) {
+        const result = await this.engines.invoke(this.moduleName, exportName, params);
+        if (!result.success) {
+            throw new Error(`movement.${exportName} failed: ${result.reason ?? 'unknown'}`);
+        }
+        return result.body;
+    }
+}