@crowdedkingdoms/crowdyjs 8.7.0 → 8.9.0

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

@@ -60,6 +60,22 @@ export declare function engineLanes(): Record<string, (state: EnginePose) => boo
 export declare const EVENT_CONTACT_DAMAGE = 77;
 /** Weather/season transition from a world engine (kit-sim weather). */
 export declare const EVENT_WEATHER = 90;
+/** Turn changed (kit-play turns; match engines). */
+export declare const EVENT_TURN = 91;
+/** Score / match summary (kit-play score). */
+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;
@@ -84,4 +100,76 @@ export interface WeatherEvent {
 }
 /** Parse a weather event; null when the payload is another type. */
 export declare function parseWeatherEvent(bytes: Uint8Array): WeatherEvent | null;
+/** A parsed type-91 turn-changed event (match engines). */
+export interface TurnEvent {
+    actorId: string;
+    round: number;
+    turnInRound: number;
+    body: Record<string, unknown>;
+}
+/** Parse a turn event; null when the payload is another type. */
+export declare function parseTurnEvent(bytes: Uint8Array): TurnEvent | null;
+/** A parsed type-92 score/summary event (match engines). */
+export interface ScoreEvent {
+    /** Per-actor standings when present. */
+    standings: Array<{
+        actorId: string;
+        score: number;
+        rank: number;
+    }>;
+    winnerId: string | null;
+    body: Record<string, unknown>;
+}
+/** Parse a score event; null when the payload is another type. */
+export declare function parseScoreEvent(bytes: Uint8Array): ScoreEvent | null;
+/** A parsed type-93 match-proposal event (matchmaking handoff). */
+export interface ProposalEvent {
+    proposalId: string;
+    mode: string;
+    players: string[];
+    body: Record<string, unknown>;
+}
+/** 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;AAEhC,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"}
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/kit/wire.ts"],"names":[],"mappings":"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"}

package/dist/kit/wire.js

@@ -114,6 +114,22 @@ export function engineLanes() {
 export const EVENT_CONTACT_DAMAGE = 77;
 /** Weather/season transition from a world engine (kit-sim weather). */
 export const EVENT_WEATHER = 90;
+/** Turn changed (kit-play turns; match engines). */
+export const EVENT_TURN = 91;
+/** Score / match summary (kit-play score). */
+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)
@@ -154,3 +170,97 @@ export function parseWeatherEvent(bytes) {
         body: parsed.body,
     };
 }
+/** Parse a turn event; null when the payload is another type. */
+export function parseTurnEvent(bytes) {
+    const parsed = parseEngineEvent(bytes);
+    if (!parsed || parsed.eventType !== EVENT_TURN)
+        return null;
+    return {
+        actorId: String(parsed.body.actorId ?? ''),
+        round: Number(parsed.body.round ?? 0),
+        turnInRound: Number(parsed.body.turnInRound ?? 0),
+        body: parsed.body,
+    };
+}
+/** Parse a score event; null when the payload is another type. */
+export function parseScoreEvent(bytes) {
+    const parsed = parseEngineEvent(bytes);
+    if (!parsed || parsed.eventType !== EVENT_SCORE)
+        return null;
+    const standings = Array.isArray(parsed.body.standings)
+        ? parsed.body.standings.map((s) => ({
+            actorId: String(s.actorId ?? ''),
+            score: Number(s.score ?? 0),
+            rank: Number(s.rank ?? 0),
+        }))
+        : [];
+    return {
+        standings,
+        winnerId: parsed.body.winnerId != null ? String(parsed.body.winnerId) : null,
+        body: parsed.body,
+    };
+}
+/** Parse a proposal event; null when the payload is another type. */
+export function parseProposalEvent(bytes) {
+    const parsed = parseEngineEvent(bytes);
+    if (!parsed || parsed.eventType !== EVENT_PROPOSAL)
+        return null;
+    return {
+        proposalId: String(parsed.body.proposalId ?? ''),
+        mode: String(parsed.body.mode ?? ''),
+        players: Array.isArray(parsed.body.players)
+            ? parsed.body.players.map(String)
+            : [],
+        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.7.0",
+  "version": "8.9.0",
   "description": "Client SDK for Crowded Kingdoms GraphQL API with UDP proxy support",
   "type": "module",
   "main": "dist/index.js",