@crowdedkingdoms/crowdyjs 8.8.0 → 8.10.0

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;
+    }
+}

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

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

package/dist/kit/quests.d.ts

@@ -1,10 +1,13 @@
 import type { GameModelAPI } from '../domains/gameModel.js';
 import type { Scalars, SeedPropertyInput } from '../generated/graphql.js';
+import { type KitOwnerIdKind } from './blueprints/index.js';
 import { type KitInvokeResult } from './shared.js';
 /** Options for {@link QuestsKit}. Must match the deployed quests blueprint. */
 export interface QuestsKitOptions {
     /** The `typePrefix` the quests blueprint was deployed with. */
     typePrefix?: string;
+    /** Must match questsBlueprint.ownerIdKind. Defaults to `int`. */
+    ownerIdKind?: KitOwnerIdKind;
 }
 /** A parsed view of one quest catalog row. */
 export interface KitQuestDef {
@@ -42,6 +45,7 @@ export declare class QuestsKit {
     private readonly appId;
     private readonly gameModel;
     private readonly names;
+    private readonly ownerIdKind;
     constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: QuestsKitOptions);
     /** List the quest catalog (admin-seeded QuestDef containers). */
     catalog(): Promise<KitQuestDef[]>;

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

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

package/dist/kit/quests.js

@@ -1,4 +1,4 @@
-import { questsNames } from './blueprints/index.js';
+import { questsNames, } from './blueprints/index.js';
 import { kitContainerProperties, kitInvoke, } from './shared.js';
 /**
  * Runtime helpers for the {@link questsBlueprint} conventions: browse the
@@ -13,6 +13,7 @@ export class QuestsKit {
         this.appId = appId;
         this.gameModel = gameModel;
         this.names = questsNames(options.typePrefix ?? '');
+        this.ownerIdKind = options.ownerIdKind ?? 'int';
     }
     /** List the quest catalog (admin-seeded QuestDef containers). */
     async catalog() {
@@ -82,7 +83,13 @@ export class QuestsKit {
             displayName: options.displayName ?? `Quest ${questId} ${ownerUserId}`,
             ...(options.sessionId !== undefined ? { sessionId: options.sessionId } : {}),
             properties: [
-                { key: 'owner_user_id', valueType: 'int', valueJson: String(ownerUserId) },
+                {
+                    key: 'owner_user_id',
+                    valueType: this.ownerIdKind,
+                    valueJson: this.ownerIdKind === 'string'
+                        ? JSON.stringify(String(ownerUserId))
+                        : String(ownerUserId),
+                },
                 { key: 'quest_id', valueType: 'string', valueJson: JSON.stringify(questId) },
                 {
                     key: 'target',

package/dist/kit/racing.d.ts

@@ -0,0 +1,85 @@
+import type { GameModelAPI } from '../domains/gameModel.js';
+import type { Scalars } from '../generated/graphql.js';
+import type { EngineDetector } from './engine.js';
+import { type RaceTimingEvent } from './wire.js';
+/** Options for {@link RacingKit}. */
+export interface RacingKitOptions {
+    /** The racing engine module name. Defaults to `'racing'`. */
+    moduleName?: string;
+    /** The possession (ball) engine module name. Defaults to `'possession'`. */
+    possessionModuleName?: string;
+    /** The course container type. Defaults to `'Course'`. */
+    courseTypeName?: string;
+}
+/** Your live run as the engine reports it. */
+export interface KitRaceRun {
+    courseId: string;
+    started: boolean;
+    lap: number;
+    nextGate: number;
+    splitsMs: number[];
+    bestLapMs: number;
+    finished: boolean;
+    totalMs: number;
+}
+/**
+ * Runtime helpers for the racing engine (Wave 3, G16) and its possession
+ * sub-template (G17 sports-lite): server-timed gates/laps from the pose
+ * stream (type-97 events), course records with ghost replays on the actor
+ * lane (suffix `ghost:<courseId>`, FLAG_RESERVED3), and the authoritative
+ * ball (claim/steal/pass/shoot; lane suffix `ball`).
+ *
+ * Obtained via `client.kit(appId).racing`.
+ */
+export declare class RacingKit {
+    private readonly appId;
+    private readonly gameModel;
+    private readonly engines;
+    private readonly moduleName;
+    private readonly possessionModuleName;
+    private readonly courseTypeName;
+    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, engines: EngineDetector, options?: RacingKitOptions);
+    /** Is the racing engine deployed + enabled (cached per session)? */
+    engineAvailable(): Promise<boolean>;
+    /** Is the possession (ball) engine deployed + enabled? */
+    possessionAvailable(): Promise<boolean>;
+    /** STUDIO (admin) — create a course (`gates` = [[x, z, radius], ...]). */
+    defineCourse(input: {
+        courseId: string;
+        gates: Array<[number, number, number]>;
+        laps?: number;
+        displayName?: string;
+    }): Promise<{
+        __typename?: "GmContainer";
+        containerId: string;
+        appId: string;
+        sessionId: string | null;
+        typeName: string;
+        displayName: string;
+        description: string | null;
+        ownerUserId: string | null;
+        metadataJson: string;
+    }>;
+    /** Enter a course: your next pose through gate 0 starts the clock. */
+    enter(courseId: string): Promise<Record<string, unknown>>;
+    /** Your live run (splits, lap, next gate). */
+    raceStatus(): Promise<KitRaceRun>;
+    /** The course record (holder, time, ghost length). */
+    best(courseId: string): Promise<Record<string, unknown>>;
+    /** Replay the course-record ghost onto the actor lane. */
+    ghostPlay(courseId: string): Promise<Record<string, unknown>>;
+    /** Parse a type-97 race-timing server event. */
+    parseRaceTiming(bytes: Uint8Array): RaceTimingEvent | null;
+    /** Join the ball match (teams fill by join order). */
+    joinMatch(): Promise<Record<string, unknown>>;
+    /** Claim the free ball (or steal after the protection window). */
+    claim(): Promise<Record<string, unknown>>;
+    /** Pass along a direction (holder only). */
+    pass(dirX: number, dirZ: number): Promise<Record<string, unknown>>;
+    /** Shoot at the opposing goal (holder only; the server aims). */
+    shoot(): Promise<Record<string, unknown>>;
+    /** The live ball match (teams, ball, standings, summary). */
+    matchState(): Promise<Record<string, unknown>>;
+    private invoke;
+}
+//# sourceMappingURL=racing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"racing.d.ts","sourceRoot":"","sources":["../../src/kit/racing.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,EAAwB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAEvE,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,qBAAa,SAAS;IAMlB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,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,gBAAqB;IAOhC,oEAAoE;IACpE,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAInC,0DAA0D;IAC1D,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAIvC,0EAA0E;IACpE,YAAY,CAAC,KAAK,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;;;;;;;;;;;IAaD,sEAAsE;IAChE,KAAK,CAAC,QAAQ,EAAE,MAAM;IAI5B,8CAA8C;IACxC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAcvC,sDAAsD;IAChD,IAAI,CAAC,QAAQ,EAAE,MAAM;IAI3B,0DAA0D;IACpD,SAAS,CAAC,QAAQ,EAAE,MAAM;IAIhC,gDAAgD;IAChD,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,GAAG,IAAI;IAM1D,sDAAsD;IAChD,SAAS;IAIf,kEAAkE;IAC5D,KAAK;IAIX,4CAA4C;IACtC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAIrC,iEAAiE;IAC3D,KAAK;IAIX,6DAA6D;IACvD,UAAU;YAIF,MAAM;CAOrB"}

package/dist/kit/racing.js

@@ -0,0 +1,99 @@
+import { parseRaceTimingEvent } from './wire.js';
+/**
+ * Runtime helpers for the racing engine (Wave 3, G16) and its possession
+ * sub-template (G17 sports-lite): server-timed gates/laps from the pose
+ * stream (type-97 events), course records with ghost replays on the actor
+ * lane (suffix `ghost:<courseId>`, FLAG_RESERVED3), and the authoritative
+ * ball (claim/steal/pass/shoot; lane suffix `ball`).
+ *
+ * Obtained via `client.kit(appId).racing`.
+ */
+export class RacingKit {
+    constructor(appId, gameModel, engines, options = {}) {
+        this.appId = appId;
+        this.gameModel = gameModel;
+        this.engines = engines;
+        this.moduleName = options.moduleName ?? 'racing';
+        this.possessionModuleName = options.possessionModuleName ?? 'possession';
+        this.courseTypeName = options.courseTypeName ?? 'Course';
+    }
+    /** Is the racing engine deployed + enabled (cached per session)? */
+    engineAvailable() {
+        return this.engines.has(this.moduleName);
+    }
+    /** Is the possession (ball) engine deployed + enabled? */
+    possessionAvailable() {
+        return this.engines.has(this.possessionModuleName);
+    }
+    /** STUDIO (admin) — create a course (`gates` = [[x, z, radius], ...]). */
+    async defineCourse(input) {
+        return this.gameModel.createContainer({
+            appId: this.appId,
+            typeName: this.courseTypeName,
+            displayName: input.displayName ?? `course-${input.courseId}`,
+            properties: [
+                { key: 'course_id', valueType: 'string', valueJson: JSON.stringify(input.courseId) },
+                { key: 'gates', valueType: 'string', valueJson: JSON.stringify(JSON.stringify(input.gates)) },
+                { key: 'laps', valueType: 'int', valueJson: String(input.laps ?? 1) },
+            ],
+        });
+    }
+    /** Enter a course: your next pose through gate 0 starts the clock. */
+    async enter(courseId) {
+        return this.invoke(this.moduleName, 'enter', { courseId });
+    }
+    /** Your live run (splits, lap, next gate). */
+    async raceStatus() {
+        const body = await this.invoke(this.moduleName, 'race_status', {});
+        return {
+            courseId: String(body.courseId ?? ''),
+            started: body.started === true,
+            lap: Number(body.lap ?? 0),
+            nextGate: Number(body.nextGate ?? 0),
+            splitsMs: Array.isArray(body.splitsMs) ? body.splitsMs.map(Number) : [],
+            bestLapMs: Number(body.bestLapMs ?? 0),
+            finished: body.finished === true,
+            totalMs: Number(body.totalMs ?? 0),
+        };
+    }
+    /** The course record (holder, time, ghost length). */
+    async best(courseId) {
+        return this.invoke(this.moduleName, 'best', { courseId });
+    }
+    /** Replay the course-record ghost onto the actor lane. */
+    async ghostPlay(courseId) {
+        return this.invoke(this.moduleName, 'ghost_play', { courseId });
+    }
+    /** Parse a type-97 race-timing server event. */
+    parseRaceTiming(bytes) {
+        return parseRaceTimingEvent(bytes);
+    }
+    // -- possession (sports-lite ball) ----------------------------------------
+    /** Join the ball match (teams fill by join order). */
+    async joinMatch() {
+        return this.invoke(this.possessionModuleName, 'join_match', {});
+    }
+    /** Claim the free ball (or steal after the protection window). */
+    async claim() {
+        return this.invoke(this.possessionModuleName, 'claim', {});
+    }
+    /** Pass along a direction (holder only). */
+    async pass(dirX, dirZ) {
+        return this.invoke(this.possessionModuleName, 'pass', { dirX, dirZ });
+    }
+    /** Shoot at the opposing goal (holder only; the server aims). */
+    async shoot() {
+        return this.invoke(this.possessionModuleName, 'shoot', {});
+    }
+    /** The live ball match (teams, ball, standings, summary). */
+    async matchState() {
+        return this.invoke(this.possessionModuleName, 'match_state', {});
+    }
+    async invoke(moduleName, exportName, params) {
+        const result = await this.engines.invoke(moduleName, exportName, params);
+        if (!result.success) {
+            throw new Error(`racing.${exportName} failed: ${result.reason ?? 'unknown'}`);
+        }
+        return result.body;
+    }
+}

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

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

package/dist/kit/telemetry.d.ts

@@ -0,0 +1,66 @@
+import type { GameModelAPI } from '../domains/gameModel.js';
+import type { Scalars } from '../generated/graphql.js';
+/** Options for {@link TelemetryKit}. */
+export interface TelemetryKitOptions {
+    /** The counter container type name. Defaults to `'TelemetryCounter'`. */
+    counterTypeName?: string;
+    /**
+     * Sample rate for `track()` in [0, 1] — the client-side budget knob.
+     * Defaults to 1 (every event).
+     */
+    sampleRate?: number;
+}
+/**
+ * Game analytics events (matrix P7) — MODEL-THIN by design: `track()`
+ * writes a naming-convention row into the existing model event log via a
+ * fire-and-forget container property bump, and sampled counters live in
+ * ordinary `TelemetryCounter` containers (`event_name` + `count`). Export
+ * and BI are platform concerns, deliberately out of scope; the convention
+ * is the abstraction.
+ *
+ * Naming convention: `<area>.<action>` (e.g. `ftue.step_completed`,
+ * `shop.purchase`). Keep cardinality low — counters are containers.
+ *
+ * Obtained via `client.kit(appId).telemetry`.
+ */
+export declare class TelemetryKit {
+    private readonly appId;
+    private readonly gameModel;
+    private readonly counterTypeName;
+    private readonly sampleRate;
+    /** event name -> counter container id (cached per session). */
+    private readonly counterIds;
+    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: TelemetryKitOptions);
+    /**
+     * Track one event — fire-and-forget (never throws, never blocks
+     * gameplay): bumps the event's sampled counter. `props` ride the
+     * container's last-props snapshot for spot-debugging (NOT a warehouse).
+     */
+    track(name: string, props?: Record<string, unknown>): void;
+    /** The awaitable form of {@link track} for tests/backfills. */
+    bump(name: string, props?: Record<string, unknown>): Promise<void>;
+    /** Read the sampled counters (dashboards, tests). */
+    counters(): Promise<Array<{
+        eventName: string;
+        count: number;
+        lastProps: string;
+    }>>;
+    private ensureCounter;
+}
+/** The telemetry blueprint: one counter type; the convention is the point. */
+export declare function telemetryBlueprint(counterTypeName?: string): {
+    name: string;
+    containerTypes: {
+        typeName: string;
+        displayName: string;
+        description: string;
+    }[];
+    propertyDefinitions: {
+        containerTypeName: string;
+        key: string;
+        valueType: string;
+        defaultValueJson: string;
+        description: string;
+    }[];
+};
+//# sourceMappingURL=telemetry.d.ts.map