@crowdedkingdoms/crowdyjs 17.13.0-dev.1 → 18.0.0-dev.1

package/dist/kit/racing.d.ts

@@ -1,85 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,99 +0,0 @@
-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/shared.d.ts

@@ -1,73 +0,0 @@
-import { CrowdyGraphQLError } from '../errors.js';
-import type { GameModelAPI } from '../domains/gameModel.js';
-import type { GameModelInvokeMutation } from '../generated/graphql.js';
-/** The raw server result of a `gameModelInvoke` call. */
-export type RawInvokeResult = GameModelInvokeMutation['gameModelInvoke'];
-/**
- * A kit invoke outcome: the server's authority/evaluation verdict plus the
- * parsed return value. Authority denials and expression errors are **not**
- * exceptions — check {@link success}.
- *
- * Older `cks-game-api` builds violate that contract for policy denials: they
- * throw a GraphQL error with `extensions.code === 'FORBIDDEN'` instead of
- * resolving with `success: false`. {@link kitInvoke} tolerates both server
- * generations by mapping that error onto a denial result — see {@link raw}
- * for how to recognize the mapped case.
- */
-export interface KitInvokeResult<T = unknown> {
-    /** `false` when the invoke policy denied the caller or the logic errored (rolled back). */
-    success: boolean;
-    /** The parsed `returnValueJson`, when present and `success` is true. */
-    returnValue?: T;
-    /** The server's error message when `success` is false. */
-    errorMessage?: string;
-    /**
-     * The full server result (event id, applied mutations, …).
-     *
-     * When an older server reported a policy denial as a `FORBIDDEN` GraphQL
-     * error (see the interface doc above), no server result exists; the SDK
-     * synthesizes a minimal one — `success: false`, `errorMessage` from the
-     * GraphQL error, `eventId: ''`, and no applied mutations.
-     */
-    raw: RawInvokeResult;
-}
-/**
- * Is this thrown error a **gameplay verdict** rather than a transport/user
- * error — i.e. should a kit invoke helper resolve `{ success: false }`
- * instead of rethrowing? Two server shapes qualify:
- *
- * 1. `FORBIDDEN` — older `cks-game-api` builds threw this for invoke-policy
- *    denials instead of resolving with `success: false`.
- * 2. `BAD_REQUEST` with a message starting `"Invoke params violate"` — the
- *    typed invoke-contract violation `computeInvoke` raises when declared
- *    params fail pre-sandbox validation (game-api 2026-07-19+). To a kit
- *    caller that is a referee "no", not an exception.
- *
- * Anything else (UNAUTHENTICATED, rate limits, network failures, other
- * BAD_REQUESTs like a disabled module) stays a thrown error.
- */
-export declare function isKitVerdictError(error: unknown): error is CrowdyGraphQLError;
-/** Wrap a raw invoke result, parsing the JSON return value. */
-export declare function toKitInvokeResult<T>(raw: RawInvokeResult): KitInvokeResult<T>;
-/**
- * Invoke a model function and wrap the result.
- *
- * Server-generation tolerance: current `cks-game-api` builds resolve policy
- * denials with `success: false` (the kit contract), but older builds throw a
- * {@link CrowdyGraphQLError} with `extensions.code === 'FORBIDDEN'` instead.
- * This helper catches every {@link isKitVerdictError | gameplay-verdict
- * error} (the legacy FORBIDDEN denial and the typed invoke-contract
- * violation) and maps it to a `{ success: false, errorMessage }` result with
- * a synthesized {@link KitInvokeResult.raw}, so kit callers see one contract
- * against both server generations. Any other error is rethrown unchanged.
- */
-export declare function kitInvoke<T = unknown>(gameModel: GameModelAPI, input: {
-    appId: string;
-    functionName: string;
-    selfContainerId: string;
-    params?: Record<string, unknown>;
-    sessionId?: string;
-}): Promise<KitInvokeResult<T>>;
-/** Read a container's visible properties as a parsed object. */
-export declare function kitContainerProperties(gameModel: GameModelAPI, appId: string, containerId: string): Promise<Record<string, unknown>>;
-//# sourceMappingURL=shared.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/kit/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;AAEzE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,2FAA2F;IAC3F,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,WAAW,CAAC,EAAE,CAAC,CAAC;IAChB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,GAAG,EAAE,eAAe,CAAC;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAO7E;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,GAAG,eAAe,CAAC,CAAC,CAAC,CAe7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAAC,CAAC,GAAG,OAAO,EACzC,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE;IACL,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAmC7B;AAED,gEAAgE;AAChE,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAOlC"}

package/dist/kit/shared.js

@@ -1,101 +0,0 @@
-import { CrowdyGraphQLError } from '../errors.js';
-/**
- * Is this thrown error a **gameplay verdict** rather than a transport/user
- * error — i.e. should a kit invoke helper resolve `{ success: false }`
- * instead of rethrowing? Two server shapes qualify:
- *
- * 1. `FORBIDDEN` — older `cks-game-api` builds threw this for invoke-policy
- *    denials instead of resolving with `success: false`.
- * 2. `BAD_REQUEST` with a message starting `"Invoke params violate"` — the
- *    typed invoke-contract violation `computeInvoke` raises when declared
- *    params fail pre-sandbox validation (game-api 2026-07-19+). To a kit
- *    caller that is a referee "no", not an exception.
- *
- * Anything else (UNAUTHENTICATED, rate limits, network failures, other
- * BAD_REQUESTs like a disabled module) stays a thrown error.
- */
-export function isKitVerdictError(error) {
-    if (!(error instanceof CrowdyGraphQLError))
-        return false;
-    if (error.code === 'FORBIDDEN')
-        return true;
-    return (error.code === 'BAD_REQUEST' &&
-        error.message.startsWith('Invoke params violate'));
-}
-/** Wrap a raw invoke result, parsing the JSON return value. */
-export function toKitInvokeResult(raw) {
-    let returnValue;
-    if (raw.success && raw.returnValueJson != null) {
-        try {
-            returnValue = JSON.parse(raw.returnValueJson);
-        }
-        catch {
-            returnValue = undefined;
-        }
-    }
-    return {
-        success: raw.success,
-        returnValue,
-        errorMessage: raw.errorMessage ?? undefined,
-        raw,
-    };
-}
-/**
- * Invoke a model function and wrap the result.
- *
- * Server-generation tolerance: current `cks-game-api` builds resolve policy
- * denials with `success: false` (the kit contract), but older builds throw a
- * {@link CrowdyGraphQLError} with `extensions.code === 'FORBIDDEN'` instead.
- * This helper catches every {@link isKitVerdictError | gameplay-verdict
- * error} (the legacy FORBIDDEN denial and the typed invoke-contract
- * violation) and maps it to a `{ success: false, errorMessage }` result with
- * a synthesized {@link KitInvokeResult.raw}, so kit callers see one contract
- * against both server generations. Any other error is rethrown unchanged.
- */
-export async function kitInvoke(gameModel, input) {
-    let raw;
-    try {
-        raw = await gameModel.invoke({
-            appId: input.appId,
-            functionName: input.functionName,
-            selfContainerId: input.selfContainerId,
-            paramsJson: JSON.stringify(input.params ?? {}),
-            ...(input.sessionId !== undefined ? { sessionId: input.sessionId } : {}),
-        });
-    }
-    catch (error) {
-        if (isKitVerdictError(error)) {
-            return {
-                success: false,
-                returnValue: undefined,
-                errorMessage: error.message,
-                raw: {
-                    eventId: '',
-                    functionName: input.functionName,
-                    success: false,
-                    policyBypassed: null,
-                    returnValueJson: null,
-                    // Synthesised locally from a THROWN verdict, so there is no server
-                    // attribution to carry. Null rather than a guessed blame: `playerFaultOf`
-                    // reads null as "not a question about whose code failed", which is exactly
-                    // right for a scope violation caught on the way in.
-                    fault: null,
-                    errorMessage: error.message,
-                    mutationsApplied: [],
-                },
-            };
-        }
-        throw error;
-    }
-    return toKitInvokeResult(raw);
-}
-/** Read a container's visible properties as a parsed object. */
-export async function kitContainerProperties(gameModel, appId, containerId) {
-    const state = await gameModel.containerState({ appId, containerId });
-    try {
-        return JSON.parse(state.propertiesJson);
-    }
-    catch {
-        return {};
-    }
-}

package/dist/kit/telemetry.d.ts

@@ -1,66 +0,0 @@
-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

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

@@ -1 +0,0 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/kit/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvD,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IAOrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;gBAGrC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,mBAAwB;IAMnC;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAK9D,+DAA+D;IACzD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB5E,qDAAqD;IAC/C,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;YAiB3E,aAAa;CA0B5B;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,eAAe,SAAqB;;;;;;;;;;;;;;EAmCtE"}

package/dist/kit/telemetry.js

@@ -1,133 +0,0 @@
-import { kitContainerProperties } from './shared.js';
-/**
- * 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 class TelemetryKit {
-    constructor(appId, gameModel, options = {}) {
-        this.appId = appId;
-        this.gameModel = gameModel;
-        /** event name -> counter container id (cached per session). */
-        this.counterIds = new Map();
-        this.counterTypeName = options.counterTypeName ?? 'TelemetryCounter';
-        this.sampleRate = options.sampleRate ?? 1;
-    }
-    /**
-     * 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, props = {}) {
-        if (Math.random() > this.sampleRate)
-            return;
-        void this.bump(name, props).catch(() => undefined);
-    }
-    /** The awaitable form of {@link track} for tests/backfills. */
-    async bump(name, props = {}) {
-        const containerId = await this.ensureCounter(name);
-        const current = await kitContainerProperties(this.gameModel, String(this.appId), containerId);
-        await this.gameModel.setProperty({
-            appId: this.appId,
-            containerId,
-            key: 'count',
-            valueType: 'int',
-            valueJson: String(Number(current.count ?? 0) + 1),
-        });
-        if (Object.keys(props).length > 0) {
-            await this.gameModel.setProperty({
-                appId: this.appId,
-                containerId,
-                key: 'last_props',
-                valueType: 'string',
-                valueJson: JSON.stringify(JSON.stringify(props).slice(0, 500)),
-            });
-        }
-    }
-    /** Read the sampled counters (dashboards, tests). */
-    async counters() {
-        const containers = await this.gameModel.containers({
-            appId: this.appId,
-            typeName: this.counterTypeName,
-        });
-        return Promise.all(containers.map(async (c) => {
-            const props = await kitContainerProperties(this.gameModel, String(this.appId), c.containerId);
-            return {
-                eventName: String(props.event_name ?? ''),
-                count: Number(props.count ?? 0),
-                lastProps: String(props.last_props ?? ''),
-            };
-        }));
-    }
-    async ensureCounter(name) {
-        const cached = this.counterIds.get(name);
-        if (cached)
-            return cached;
-        const containers = await this.gameModel.containers({
-            appId: this.appId,
-            typeName: this.counterTypeName,
-        });
-        for (const c of containers) {
-            const props = await kitContainerProperties(this.gameModel, String(this.appId), c.containerId);
-            if (String(props.event_name ?? '') === name) {
-                this.counterIds.set(name, c.containerId);
-                return c.containerId;
-            }
-        }
-        const created = await this.gameModel.createContainer({
-            appId: this.appId,
-            typeName: this.counterTypeName,
-            displayName: `telemetry ${name}`,
-            properties: [
-                { key: 'event_name', valueType: 'string', valueJson: JSON.stringify(name) },
-                { key: 'count', valueType: 'int', valueJson: '0' },
-            ],
-        });
-        this.counterIds.set(name, created.containerId);
-        return created.containerId;
-    }
-}
-/** The telemetry blueprint: one counter type; the convention is the point. */
-export function telemetryBlueprint(counterTypeName = 'TelemetryCounter') {
-    return {
-        name: 'telemetry',
-        containerTypes: [
-            {
-                typeName: counterTypeName,
-                displayName: 'Telemetry counter',
-                description: "One sampled event counter (event_name + count + last_props). Naming convention: '<area>.<action>'.",
-            },
-        ],
-        propertyDefinitions: [
-            {
-                containerTypeName: counterTypeName,
-                key: 'event_name',
-                valueType: 'string',
-                defaultValueJson: '""',
-                description: "The tracked event's convention name ('<area>.<action>').",
-            },
-            {
-                containerTypeName: counterTypeName,
-                key: 'count',
-                valueType: 'int',
-                defaultValueJson: '0',
-                description: 'Sampled occurrence count.',
-            },
-            {
-                containerTypeName: counterTypeName,
-                key: 'last_props',
-                valueType: 'string',
-                defaultValueJson: '""',
-                description: 'The last tracked props JSON (spot-debugging, not a warehouse).',
-            },
-        ],
-    };
-}

package/dist/kit/territory.d.ts

@@ -1,97 +0,0 @@
-import type { GameModelAPI } from '../domains/gameModel.js';
-import type { Scalars } from '../generated/graphql.js';
-import type { EngineDetector } from './engine.js';
-import { type ControlPointEvent } from './wire.js';
-/** Options for {@link TerritoryKit}. */
-export interface TerritoryKitOptions {
-    /** The territory engine module name. Defaults to `'territory'`. */
-    moduleName?: string;
-}
-/** A control point as the engine reports it. */
-export interface KitControlPoint {
-    pointId: string;
-    x: number;
-    z: number;
-    radius: number;
-    owner: string;
-    challenger: string;
-    progress: number;
-    incomePerMin: number;
-    siegeOpen: boolean;
-}
-/**
- * Runtime helpers for the territory engine (Wave 3): control-point state,
- * faction standings, and the admin CRUD for the map (factions, members,
- * points). Capture itself is pure presence — stand inside a point's radius
- * with your faction; the engine does the rest and announces flips as
- * type-96 events.
- *
- * Obtained via `client.kit(appId).territory`.
- */
-export declare class TerritoryKit {
-    private readonly appId;
-    private readonly gameModel;
-    private readonly engines;
-    private readonly moduleName;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, engines: EngineDetector, options?: TerritoryKitOptions);
-    /** Is the territory engine deployed + enabled (cached per session)? */
-    engineAvailable(): Promise<boolean>;
-    /** Every control point with live capture state. */
-    points(): Promise<KitControlPoint[]>;
-    /** Faction standings (id + treasury). */
-    factions(): Promise<Array<{
-        factionId: string;
-        gold: number;
-    }>>;
-    /** Engine totals (flips, income paid). */
-    status(): Promise<Record<string, unknown>>;
-    /** STUDIO (admin) — create a faction. */
-    defineFaction(factionId: string, displayName?: string): Promise<{
-        __typename?: "GmContainer";
-        containerId: string;
-        appId: string;
-        sessionId: string | null;
-        typeName: string;
-        displayName: string;
-        description: string | null;
-        ownerUserId: string | null;
-        metadataJson: string;
-    }>;
-    /** STUDIO (admin) — enroll a player in a faction. */
-    enroll(userId: string, factionId: string): Promise<{
-        __typename?: "GmContainer";
-        containerId: string;
-        appId: string;
-        sessionId: string | null;
-        typeName: string;
-        displayName: string;
-        description: string | null;
-        ownerUserId: string | null;
-        metadataJson: string;
-    }>;
-    /** STUDIO (admin) — create a control point. */
-    definePoint(input: {
-        pointId: string;
-        x: number;
-        z: number;
-        radius: number;
-        incomePerMin?: number;
-        siegeFromMin?: number;
-        siegeToMin?: 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;
-    }>;
-    /** Parse a type-96 control-point server event (flips). */
-    parseControlPoint(bytes: Uint8Array): ControlPointEvent | null;
-    private invoke;
-}
-//# sourceMappingURL=territory.d.ts.map