@crowdedkingdoms/crowdyjs 8.8.0 → 8.10.0

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"territory.d.ts","sourceRoot":"","sources":["../../src/kit/territory.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,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE3E,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAIrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGjB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,cAAc,EACxC,OAAO,GAAE,mBAAwB;IAKnC,uEAAuE;IACvE,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAInC,mDAAmD;IAC7C,MAAM,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAiB1C,yCAAyC;IACnC,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAUrE,0CAA0C;IACpC,MAAM;IAIZ,yCAAyC;IACnC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;;;;;;;;;;;IAY3D,qDAAqD;IAC/C,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;;;;;;;;;;;IAY9C,+CAA+C;IACzC,WAAW,CAAC,KAAK,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;;;;;;;;;;;IA0BD,0DAA0D;IAC1D,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,iBAAiB,GAAG,IAAI;YAIhD,MAAM;CAOrB"}

package/dist/kit/territory.js

@@ -0,0 +1,114 @@
+import { parseControlPointEvent } from './wire.js';
+/**
+ * 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 class TerritoryKit {
+    constructor(appId, gameModel, engines, options = {}) {
+        this.appId = appId;
+        this.gameModel = gameModel;
+        this.engines = engines;
+        this.moduleName = options.moduleName ?? 'territory';
+    }
+    /** Is the territory engine deployed + enabled (cached per session)? */
+    engineAvailable() {
+        return this.engines.has(this.moduleName);
+    }
+    /** Every control point with live capture state. */
+    async points() {
+        const body = await this.invoke('points', {});
+        return Array.isArray(body.points)
+            ? body.points.map((p) => ({
+                pointId: String(p.pointId ?? ''),
+                x: Number(p.x ?? 0),
+                z: Number(p.z ?? 0),
+                radius: Number(p.radius ?? 0),
+                owner: String(p.owner ?? ''),
+                challenger: String(p.challenger ?? ''),
+                progress: Number(p.progress ?? 0),
+                incomePerMin: Number(p.incomePerMin ?? 0),
+                siegeOpen: p.siegeOpen === true,
+            }))
+            : [];
+    }
+    /** Faction standings (id + treasury). */
+    async factions() {
+        const body = await this.invoke('factions', {});
+        return Array.isArray(body.factions)
+            ? body.factions.map((f) => ({
+                factionId: String(f.factionId ?? ''),
+                gold: Number(f.gold ?? 0),
+            }))
+            : [];
+    }
+    /** Engine totals (flips, income paid). */
+    async status() {
+        return this.invoke('status', {});
+    }
+    /** STUDIO (admin) — create a faction. */
+    async defineFaction(factionId, displayName) {
+        return this.gameModel.createContainer({
+            appId: this.appId,
+            typeName: 'Faction',
+            displayName: displayName ?? `faction-${factionId}`,
+            properties: [
+                { key: 'faction_id', valueType: 'string', valueJson: JSON.stringify(factionId) },
+                { key: 'gold', valueType: 'int', valueJson: '0' },
+            ],
+        });
+    }
+    /** STUDIO (admin) — enroll a player in a faction. */
+    async enroll(userId, factionId) {
+        return this.gameModel.createContainer({
+            appId: this.appId,
+            typeName: 'FactionMember',
+            displayName: `member-${userId}`,
+            properties: [
+                { key: 'user_id', valueType: 'string', valueJson: JSON.stringify(userId) },
+                { key: 'faction_id', valueType: 'string', valueJson: JSON.stringify(factionId) },
+            ],
+        });
+    }
+    /** STUDIO (admin) — create a control point. */
+    async definePoint(input) {
+        return this.gameModel.createContainer({
+            appId: this.appId,
+            typeName: 'ControlPoint',
+            displayName: input.displayName ?? `cp-${input.pointId}`,
+            properties: [
+                { key: 'point_id', valueType: 'string', valueJson: JSON.stringify(input.pointId) },
+                { key: 'x', valueType: 'int', valueJson: String(Math.round(input.x)) },
+                { key: 'z', valueType: 'int', valueJson: String(Math.round(input.z)) },
+                { key: 'radius', valueType: 'int', valueJson: String(Math.round(input.radius)) },
+                { key: 'owner_faction', valueType: 'string', valueJson: '""' },
+                {
+                    key: 'income_per_min',
+                    valueType: 'int',
+                    valueJson: String(input.incomePerMin ?? 0),
+                },
+                ...(input.siegeFromMin !== undefined
+                    ? [{ key: 'siege_from_min', valueType: 'int', valueJson: String(input.siegeFromMin) }]
+                    : []),
+                ...(input.siegeToMin !== undefined
+                    ? [{ key: 'siege_to_min', valueType: 'int', valueJson: String(input.siegeToMin) }]
+                    : []),
+            ],
+        });
+    }
+    /** Parse a type-96 control-point server event (flips). */
+    parseControlPoint(bytes) {
+        return parseControlPointEvent(bytes);
+    }
+    async invoke(exportName, params) {
+        const result = await this.engines.invoke(this.moduleName, exportName, params);
+        if (!result.success) {
+            throw new Error(`territory.${exportName} failed: ${result.reason ?? 'unknown'}`);
+        }
+        return result.body;
+    }
+}

package/dist/kit/wire.d.ts

@@ -66,6 +66,16 @@ export declare const EVENT_TURN = 91;
 export declare const EVENT_SCORE = 92;
 /** Match proposal (matchmaking → matches handoff). */
 export declare const EVENT_PROPOSAL = 93;
+/** Ability cast/impact (kit-play abilities). */
+export declare const EVENT_ABILITY = 94;
+/** Movement-envelope violation (movement-warden, observe/flag). */
+export declare const EVENT_MOVEMENT_VIOLATION = 95;
+/** Control-point state change (territory). */
+export declare const EVENT_CONTROL_POINT = 96;
+/** Race timing: checkpoint/lap/finish (kit-play timing). */
+export declare const EVENT_RACE_TIMING = 97;
+/** Zone change: shrinking circles, event areas (kit-sim zones). */
+export declare const EVENT_ZONE_CHANGE = 98;
 /** Split an engine server-event payload into its type + JSON body. */
 export declare function parseEngineEvent(bytes: Uint8Array): {
     eventType: number;
@@ -121,4 +131,45 @@ export interface ProposalEvent {
 }
 /** Parse a proposal event; null when the payload is another type. */
 export declare function parseProposalEvent(bytes: Uint8Array): ProposalEvent | null;
+/** A parsed type-94 ability cast/impact event. */
+export interface AbilityEvent {
+    /** `'cast'` or `'impact'`. */
+    kind: string;
+    abilityId: string;
+    casterId: string;
+    victimId: string | null;
+    damage: number;
+    body: Record<string, unknown>;
+}
+/** Parse an ability event; null when the payload is another type. */
+export declare function parseAbilityEvent(bytes: Uint8Array): AbilityEvent | null;
+/** A parsed type-95 movement-violation event (observe/flag posture). */
+export interface MovementViolationEvent {
+    /** `'speed'`, `'teleport'`, or `'bounds'`. */
+    kind: string;
+    userId: string;
+    detail: string;
+    body: Record<string, unknown>;
+}
+/** Parse a movement-violation event; null when the payload is another type. */
+export declare function parseMovementViolation(bytes: Uint8Array): MovementViolationEvent | null;
+/** A parsed type-96 control-point state event (territory flips). */
+export interface ControlPointEvent {
+    pointId: string;
+    owner: string;
+    previousOwner: string;
+    body: Record<string, unknown>;
+}
+/** Parse a control-point event; null when the payload is another type. */
+export declare function parseControlPointEvent(bytes: Uint8Array): ControlPointEvent | null;
+/** A parsed type-97 race-timing event (checkpoint/lap/finish). */
+export interface RaceTimingEvent {
+    /** `'started'`, `'checkpoint'`, `'lap'`, or `'finished'`. */
+    kind: string;
+    courseId: string;
+    userId: string;
+    body: Record<string, unknown>;
+}
+/** Parse a race-timing event; null when the payload is another type. */
+export declare function parseRaceTimingEvent(bytes: Uint8Array): RaceTimingEvent | null;
 //# sourceMappingURL=wire.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/kit/wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,4EAA4E;AAC5E,eAAO,MAAM,aAAa,IAAS,CAAC;AACpC,eAAO,MAAM,QAAQ,IAAS,CAAC;AAC/B,eAAO,MAAM,QAAQ,IAAS,CAAC;AAC/B,eAAO,MAAM,cAAc,IAAS,CAAC;AAErC,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAiBtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAqBrE;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAI3D;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,UAAU,CAAC,UAAU,CAiBlD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,CAM5E;AAMD,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,uEAAuE;AACvE,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,oDAAoD;AACpD,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,8CAA8C;AAC9C,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,sDAAsD;AACtD,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,sEAAsE;AACtE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,GAChB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAY7D;AAED,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,kBAAkB,GAAG,IAAI,CAS/E;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,GAAG,IAAI,CASxE;AAED,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CASlE;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAepE;AAED,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI,CAW1E"}
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/kit/wire.ts"],"names":[],"mappings":"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"}

package/dist/kit/wire.js

@@ -120,6 +120,16 @@ export const EVENT_TURN = 91;
 export const EVENT_SCORE = 92;
 /** Match proposal (matchmaking → matches handoff). */
 export const EVENT_PROPOSAL = 93;
+/** Ability cast/impact (kit-play abilities). */
+export const EVENT_ABILITY = 94;
+/** Movement-envelope violation (movement-warden, observe/flag). */
+export const EVENT_MOVEMENT_VIOLATION = 95;
+/** Control-point state change (territory). */
+export const EVENT_CONTROL_POINT = 96;
+/** Race timing: checkpoint/lap/finish (kit-play timing). */
+export const EVENT_RACE_TIMING = 97;
+/** Zone change: shrinking circles, event areas (kit-sim zones). */
+export const EVENT_ZONE_CHANGE = 98;
 /** Split an engine server-event payload into its type + JSON body. */
 export function parseEngineEvent(bytes) {
     if (bytes.length < 2)
@@ -204,3 +214,53 @@ export function parseProposalEvent(bytes) {
         body: parsed.body,
     };
 }
+/** Parse an ability event; null when the payload is another type. */
+export function parseAbilityEvent(bytes) {
+    const parsed = parseEngineEvent(bytes);
+    if (!parsed || parsed.eventType !== EVENT_ABILITY)
+        return null;
+    return {
+        kind: String(parsed.body.kind ?? ''),
+        abilityId: String(parsed.body.abilityId ?? ''),
+        casterId: String(parsed.body.casterId ?? ''),
+        victimId: parsed.body.victimId != null ? String(parsed.body.victimId) : null,
+        damage: Number(parsed.body.damage ?? 0),
+        body: parsed.body,
+    };
+}
+/** Parse a movement-violation event; null when the payload is another type. */
+export function parseMovementViolation(bytes) {
+    const parsed = parseEngineEvent(bytes);
+    if (!parsed || parsed.eventType !== EVENT_MOVEMENT_VIOLATION)
+        return null;
+    return {
+        kind: String(parsed.body.kind ?? ''),
+        userId: String(parsed.body.userId ?? ''),
+        detail: String(parsed.body.detail ?? ''),
+        body: parsed.body,
+    };
+}
+/** Parse a control-point event; null when the payload is another type. */
+export function parseControlPointEvent(bytes) {
+    const parsed = parseEngineEvent(bytes);
+    if (!parsed || parsed.eventType !== EVENT_CONTROL_POINT)
+        return null;
+    return {
+        pointId: String(parsed.body.pointId ?? ''),
+        owner: String(parsed.body.owner ?? ''),
+        previousOwner: String(parsed.body.previousOwner ?? ''),
+        body: parsed.body,
+    };
+}
+/** Parse a race-timing event; null when the payload is another type. */
+export function parseRaceTimingEvent(bytes) {
+    const parsed = parseEngineEvent(bytes);
+    if (!parsed || parsed.eventType !== EVENT_RACE_TIMING)
+        return null;
+    return {
+        kind: String(parsed.body.kind ?? ''),
+        courseId: String(parsed.body.courseId ?? ''),
+        userId: String(parsed.body.userId ?? ''),
+        body: parsed.body,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crowdedkingdoms/crowdyjs",
-  "version": "8.8.0",
+  "version": "8.10.0",
   "description": "Client SDK for Crowded Kingdoms GraphQL API with UDP proxy support",
   "type": "module",
   "main": "dist/index.js",