@crowdedkingdoms/crowdyjs 17.14.0-dev.1 → 18.0.1-dev.1

package/dist/kit/kit.d.ts

@@ -1,231 +1,31 @@
 import type { ChannelsAPI } from '../domains/channels.js';
 import type { GameAppsAPI } from '../domains/gameApps.js';
-import type { GameModelAPI } from '../domains/gameModel.js';
 import type { TeamsAPI } from '../domains/teams.js';
 import type { UdpAPI } from '../domains/udp.js';
-import type { GameModelSeedMutation, GameModelUpsertAutomationMutation, GameModelUpsertAutomationTriggerMutation, Scalars } from '../generated/graphql.js';
-import type { ComputeAPI } from '../domains/compute.js';
-import { type KitBlueprint } from './blueprints/index.js';
-import { CombatKit, type CombatKitOptions } from './combat.js';
-import { DirectorKit, type DirectorKitOptions } from './director.js';
-import { DecksKit, type DecksKitOptions } from './decks.js';
-import { EconomyKit, type EconomyKitOptions } from './economy.js';
-import { EngineDetector } from './engine.js';
-import { FeaturesKit } from './features.js';
-import { InstancesKit, type InstancesKitOptions } from './instances.js';
-import { InventoryKit, type InventoryKitOptions } from './inventory.js';
-import { LeaderboardsKit, type LeaderboardsKitOptions } from './leaderboards.js';
-import { LootKit, type LootKitOptions } from './loot.js';
-import { MatchmakingKit, type MatchmakingKitOptions } from './matchmaking.js';
-import { MinigamesKit, type MinigamesKitOptions } from './minigames.js';
-import { MobsKit, type MobsKitOptions } from './mobs.js';
-import { NpcsKit, type NpcsKitOptions } from './npcs.js';
-import { ObjectsKit, type ObjectsKitOptions } from './objects.js';
-import { PetsKit, type PetsKitOptions } from './pets.js';
-import { PlotsKit, type PlotsKitOptions } from './plots.js';
-import { MatchesKit, type MatchesKitOptions } from './matches.js';
-import { ProgressionKit, type ProgressionKitOptions } from './progression.js';
-import { QuestsKit, type QuestsKitOptions } from './quests.js';
+import type { Scalars } from '../generated/graphql.js';
 import { SocialKit, type SocialKitOptions } from './social.js';
-import { AbilitiesKit, type AbilitiesKitOptions } from './abilities.js';
-import { LiveopsKit, type LiveopsKitOptions } from './liveops.js';
-import { MovementKit, type MovementKitOptions } from './movement.js';
-import { RacingKit, type RacingKitOptions } from './racing.js';
-import { TerritoryKit, type TerritoryKitOptions } from './territory.js';
-import { ModerationKit, type ModerationKitOptions } from './moderation.js';
-import { TelemetryKit, type TelemetryKitOptions } from './telemetry.js';
-import { WorldsimKit, type WorldsimKitOptions } from './worldsim.js';
-/** Options for {@link GameKitClient}, configuring the runtime helpers to match your deployed blueprints. */
+/** Options for {@link GameKitClient}. */
 export interface GameKitOptions {
-    inventory?: InventoryKitOptions;
-    objects?: ObjectsKitOptions;
-    npcs?: NpcsKitOptions;
-    plots?: PlotsKitOptions;
-    economy?: EconomyKitOptions;
-    progression?: ProgressionKitOptions;
-    loot?: LootKitOptions;
-    quests?: QuestsKitOptions;
-    combat?: CombatKitOptions;
-    matches?: MatchesKitOptions;
-    decks?: DecksKitOptions;
-    worldsim?: WorldsimKitOptions;
-    liveops?: LiveopsKitOptions;
-    moderation?: ModerationKitOptions;
-    telemetry?: TelemetryKitOptions;
-    abilities?: AbilitiesKitOptions;
-    movement?: MovementKitOptions;
-    territory?: TerritoryKitOptions;
-    racing?: RacingKitOptions;
     social?: SocialKitOptions;
-    leaderboards?: LeaderboardsKitOptions;
-    mobs?: MobsKitOptions;
-    pets?: PetsKitOptions;
-    instances?: InstancesKitOptions;
-    director?: DirectorKitOptions;
-    matchmaking?: MatchmakingKitOptions;
-    minigames?: MinigamesKitOptions;
 }
 /**
- * The extra (non-model) domains some kit helpers compose: channels + udp for
- * matches (notify-to-pull) and social chat, teams for parties/guilds, and
- * compute for the engine-backed helpers (mobs/pets, capability detection).
+ * The domains the kit composes: teams for parties and guilds, channels and udp for chat.
  * `client.kit(appId)` wires them automatically.
  */
 export interface GameKitDomains {
     channels?: ChannelsAPI;
     teams?: TeamsAPI;
     udp?: UdpAPI;
-    compute?: ComputeAPI;
-}
-/** The result of {@link GameKitClient.deploy}: the seed outcome plus each automation/trigger upserted. */
-export interface KitDeployResult {
-    seed: GameModelSeedMutation['gameModelSeed'];
-    automations: GameModelUpsertAutomationMutation['gameModelUpsertAutomation'][];
-    automationTriggers: GameModelUpsertAutomationTriggerMutation['gameModelUpsertAutomationTrigger'][];
-    /** Engine templates deployed alongside (when `engines` was passed). */
-    engines: Array<{
-        templateName: string;
-        moduleName: string;
-        compileStatus: string;
-    }>;
-    /** Non-fatal static-analysis warnings from the seed. */
-    warnings: string[];
 }
 /**
- * App-scoped **Game Kit** facade returned by `client.kit(appId)` — high-level
- * building blocks that map traditional game concepts (inventory, lockable
- * objects with custom permissions, NPCs) onto the Game Model + Automations
- * API. Everything composes `client.gameModel`; no new server surface.
- *
- * Two phases, matching the platform's model:
- *
- * 1. **Studio (admin) loads the rules** — {@link deploy} takes declarative
- *    {@link KitBlueprint}s (built with `inventoryBlueprint`, `lockBlueprint`,
- *    `npcBlueprint`, or by hand) and seeds the container types, property
- *    schemas, policy-gated functions, and automations into the app in one
- *    idempotent pass. Requires the app-admin `manage_apps` permission — run
- *    it from a trusted admin context, never the shipped game client.
- * 2. **The game client plays** — {@link inventory}, {@link objects}, and
- *    {@link npcs} wrap the runtime calls (create/read containers, invoke the
- *    gated functions) assuming the blueprint conventions. Authorization is
- *    enforced server-side on every call.
- *
- * See the docs guides "Game API → Modeling game concepts" and
- * "CrowdyJS → Game Kit".
- *
- * @example
- * ```ts
- * // Studio setup (admin token):
- * const kit = admin.kit(appId);
- * await kit.deploy([
- *   inventoryBlueprint(),
- *   lockBlueprint({ objectTypeName: 'Door', authority: { kind: 'key' } }),
- * ]);
- *
- * // Game client (player token):
- * const kit = game.kit(appId);
- * const bag = await kit.inventory.ensure(me.userId);
- * const result = await kit.objects.open(doorId, { keyId });
- * if (!result.success) showLockedMessage(result.errorMessage);
- * ```
+ * App-scoped **Game Kit** returned by `client.kit(appId)`: parties, guilds and chat rooms
+ * over teams and channels ({@link social}). Game rules and state live in ck-exec hubs
+ * (`client.exec`); the kit's wire codecs (`encodeEnginePose`, `parseEngineEvent`, ...) and
+ * `runOptimisticAction` are standalone exports.
  */
 export declare class GameKitClient {
-    private readonly appId;
-    private readonly gameModel;
-    /** Inventory helpers (per-player bags and item stacks). */
-    readonly inventory: InventoryKit;
-    /** Lockable-object helpers (doors/chests/gates with custom permissions). */
-    readonly objects: ObjectsKit;
-    /** NPC helpers (spawn/read instances, manage the automations behind them). */
-    readonly npcs: NpcsKit;
-    /** Plot helpers (buy/rent land with transactional, enforced grid grants). */
-    readonly plots: PlotsKit;
-    /** Economy helpers (wallets, shops, escrow trades, player market). */
-    readonly economy: EconomyKit;
-    /** Progression helpers (xp/levels, skills, achievements, rating). */
-    readonly progression: ProgressionKit;
-    /** Loot helpers (server-rolled weighted tables, atomic claims). */
-    readonly loot: LootKit;
-    /** Quest helpers (catalog, progress, atomic reward turn-in, daily resets). */
-    readonly quests: QuestsKit;
-    /** Combat helpers (server-authoritative attacks, status effects, respawn). */
-    readonly combat: CombatKit;
-    /** Match helpers (lobbies, rounds, turns, scores, notify-to-pull channels). */
-    readonly matches: MatchesKit;
-    /** Deck helpers (hidden hands via owner visibility, server-dealt shuffles). */
-    readonly decks: DecksKit;
-    /** World simulation helpers (clock/weather, nodes, crops, wave counters). */
-    readonly worldsim: WorldsimKit;
-    /** Liveops helpers (event windows, seasons, battle-pass composition). */
-    readonly liveops: LiveopsKit;
-    /** Moderation helpers (reports, admin queue, personal mutes). */
-    readonly moderation: ModerationKit;
-    /** Telemetry helpers (track + sampled counters). */
-    readonly telemetry: TelemetryKit;
-    /** Realtime ability casts (abilities engine, type-94 events). */
-    readonly abilities: AbilitiesKit;
-    /** Movement-warden reads (observe/flag posture, type-95 events). */
-    readonly movement: MovementKit;
-    /** Control points + factions (territory engine, type-96 events). */
-    readonly territory: TerritoryKit;
-    /** Racing + possession (type-97 events, ghosts, the ball). */
-    readonly racing: RacingKit;
     /** Social helpers (parties, guilds, chat over teams + channels). */
     readonly social: SocialKit;
-    /** Leaderboard helpers (trusted submits, client-side ranking, seasons). */
-    readonly leaderboards: LeaderboardsKit;
-    /** Monetization helpers (feature keys, tier grants, featureGate policies). */
-    readonly features: FeaturesKit;
-    /** Mob-engine helpers (defs/slots, refereed attacks, contact events). */
-    readonly mobs: MobsKit;
-    /** Instance helpers (private world slices, seeded runs). */
-    readonly instances: InstancesKit;
-    /** Director helpers (encounter defs, run state, kill/boss reports). */
-    readonly director: DirectorKit;
-    /** Matchmaking helpers (queues, proposals, rating). */
-    readonly matchmaking: MatchmakingKit;
-    /** Minigame helpers (thin invoke wrapper for invoke-loop games). */
-    readonly minigames: MinigamesKit;
-    /** Pet helpers (adopt/summon/dismiss/rename over the npc engine). */
-    readonly pets: PetsKit;
-    /** Compute-engine capability detection shared by the engine-aware kits. */
-    readonly engines: EngineDetector;
-    private readonly compute?;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, gameApps: GameAppsAPI, options?: GameKitOptions, domains?: GameKitDomains);
-    /**
-     * Helpers for an additional lockable object type deployed under a different
-     * type name (e.g. both `Door` and `Chest` lock blueprints in one app).
-     */
-    objectsFor(objectTypeName: string, keyTypeName?: string): ObjectsKit;
-    /**
-     * **Studio (admin)** — load blueprints into the app: one transactional
-     * `gameModelSeed` for the definitions (and any seed containers/edges),
-     * followed by an `upsertAutomation` per automation and an
-     * `upsertAutomationTrigger` per event trigger. Idempotent: definitions
-     * upsert on their names, automations key on the automation name.
-     *
-     * Requires the app-admin `manage_apps` permission.
-     *
-     * @param blueprints - The blueprints to deploy. Duplicate type/function/
-     *   automation names across blueprints throw before anything is sent.
-     * @param options - `sessionId` scopes any seed containers to a session.
-     * @returns A {@link KitDeployResult} with the seed counts, the upserted
-     *   automations/triggers, and any non-fatal seed `warnings`.
-     * @throws {CrowdyGraphQLError} `FORBIDDEN` (`requiredPermission ===
-     *   'manage_apps'`) without app-admin, or `BAD_USER_INPUT` for definitions
-     *   that fail to compile.
-     */
-    deploy(blueprints: KitBlueprint | KitBlueprint[], options?: {
-        sessionId?: string;
-        /**
-         * Engine templates to deploy from the platform registry alongside the
-         * blueprints (`computeDeployTemplate` — requires the compute domain +
-         * 'manage_compute'). Each entry is a template name, optionally
-         * `'template:module'` to override the module name.
-         */
-        engines?: string[];
-        /** Wait for engine compiles (default true). */
-        waitForEngines?: boolean;
-    }): Promise<KitDeployResult>;
+    constructor(appId: Scalars['BigInt']['input'], gameApps: GameAppsAPI, options?: GameKitOptions, domains?: GameKitDomains);
 }
 //# sourceMappingURL=kit.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../../src/kit/kit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../../src/kit/kit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/D,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;gBAGzB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,cAAmB,EAC5B,OAAO,GAAE,cAAmB;CAW/B"}

package/dist/kit/kit.js

@@ -1,170 +1,12 @@
-import { mergeBlueprints } from './blueprints/index.js';
-import { CombatKit } from './combat.js';
-import { DirectorKit } from './director.js';
-import { DecksKit } from './decks.js';
-import { EconomyKit } from './economy.js';
-import { EngineDetector } from './engine.js';
-import { FeaturesKit } from './features.js';
-import { InstancesKit } from './instances.js';
-import { InventoryKit } from './inventory.js';
-import { LeaderboardsKit } from './leaderboards.js';
-import { LootKit } from './loot.js';
-import { MatchmakingKit } from './matchmaking.js';
-import { MinigamesKit } from './minigames.js';
-import { MobsKit } from './mobs.js';
-import { NpcsKit } from './npcs.js';
-import { ObjectsKit } from './objects.js';
-import { PetsKit } from './pets.js';
-import { PlotsKit } from './plots.js';
-import { MatchesKit } from './matches.js';
-import { ProgressionKit } from './progression.js';
-import { QuestsKit } from './quests.js';
 import { SocialKit } from './social.js';
-import { AbilitiesKit } from './abilities.js';
-import { LiveopsKit } from './liveops.js';
-import { MovementKit } from './movement.js';
-import { RacingKit } from './racing.js';
-import { TerritoryKit } from './territory.js';
-import { ModerationKit } from './moderation.js';
-import { TelemetryKit } from './telemetry.js';
-import { WorldsimKit } from './worldsim.js';
 /**
- * App-scoped **Game Kit** facade returned by `client.kit(appId)` — high-level
- * building blocks that map traditional game concepts (inventory, lockable
- * objects with custom permissions, NPCs) onto the Game Model + Automations
- * API. Everything composes `client.gameModel`; no new server surface.
- *
- * Two phases, matching the platform's model:
- *
- * 1. **Studio (admin) loads the rules** — {@link deploy} takes declarative
- *    {@link KitBlueprint}s (built with `inventoryBlueprint`, `lockBlueprint`,
- *    `npcBlueprint`, or by hand) and seeds the container types, property
- *    schemas, policy-gated functions, and automations into the app in one
- *    idempotent pass. Requires the app-admin `manage_apps` permission — run
- *    it from a trusted admin context, never the shipped game client.
- * 2. **The game client plays** — {@link inventory}, {@link objects}, and
- *    {@link npcs} wrap the runtime calls (create/read containers, invoke the
- *    gated functions) assuming the blueprint conventions. Authorization is
- *    enforced server-side on every call.
- *
- * See the docs guides "Game API → Modeling game concepts" and
- * "CrowdyJS → Game Kit".
- *
- * @example
- * ```ts
- * // Studio setup (admin token):
- * const kit = admin.kit(appId);
- * await kit.deploy([
- *   inventoryBlueprint(),
- *   lockBlueprint({ objectTypeName: 'Door', authority: { kind: 'key' } }),
- * ]);
- *
- * // Game client (player token):
- * const kit = game.kit(appId);
- * const bag = await kit.inventory.ensure(me.userId);
- * const result = await kit.objects.open(doorId, { keyId });
- * if (!result.success) showLockedMessage(result.errorMessage);
- * ```
+ * App-scoped **Game Kit** returned by `client.kit(appId)`: parties, guilds and chat rooms
+ * over teams and channels ({@link social}). Game rules and state live in ck-exec hubs
+ * (`client.exec`); the kit's wire codecs (`encodeEnginePose`, `parseEngineEvent`, ...) and
+ * `runOptimisticAction` are standalone exports.
  */
 export class GameKitClient {
-    constructor(appId, gameModel, gameApps, options = {}, domains = {}) {
-        this.appId = appId;
-        this.gameModel = gameModel;
-        this.compute = domains.compute;
-        this.engines = new EngineDetector(String(appId), domains.compute);
-        this.inventory = new InventoryKit(appId, gameModel, options.inventory);
-        this.objects = new ObjectsKit(appId, gameModel, options.objects);
-        this.npcs = new NpcsKit(appId, gameModel, options.npcs, this.engines);
-        this.plots = new PlotsKit(appId, gameModel, gameApps, options.plots);
-        this.economy = new EconomyKit(appId, gameModel, options.economy, this.engines);
-        this.progression = new ProgressionKit(appId, gameModel, options.progression);
-        this.loot = new LootKit(appId, gameModel, options.loot, this.engines);
-        this.quests = new QuestsKit(appId, gameModel, options.quests);
-        this.combat = new CombatKit(appId, gameModel, options.combat, this.engines);
-        this.matches = new MatchesKit(appId, gameModel, domains.channels, domains.udp, options.matches, this.engines);
-        this.decks = new DecksKit(appId, gameModel, options.decks, this.engines);
-        this.worldsim = new WorldsimKit(appId, gameModel, options.worldsim, this.engines);
-        this.liveops = new LiveopsKit(appId, gameModel, options.liveops, this.engines);
-        this.moderation = new ModerationKit(appId, gameModel, options.moderation);
-        this.telemetry = new TelemetryKit(appId, gameModel, options.telemetry);
-        this.abilities = new AbilitiesKit(appId, gameModel, this.engines, options.abilities);
-        this.movement = new MovementKit(appId, gameModel, this.engines, options.movement);
-        this.territory = new TerritoryKit(appId, gameModel, this.engines, options.territory);
-        this.racing = new RacingKit(appId, gameModel, this.engines, options.racing);
-        this.mobs = new MobsKit(appId, gameModel, this.engines, options.mobs);
-        this.pets = new PetsKit(appId, gameModel, this.engines, options.pets);
-        this.instances = new InstancesKit(appId, this.engines, options.instances);
-        this.director = new DirectorKit(appId, gameModel, this.engines, options.director);
-        this.matchmaking = new MatchmakingKit(appId, this.engines, options.matchmaking);
-        this.minigames = new MinigamesKit(appId, this.engines, options.minigames);
+    constructor(appId, gameApps, options = {}, domains = {}) {
         this.social = new SocialKit(appId, domains.teams, domains.channels, domains.udp, gameApps, options.social);
-        this.leaderboards = new LeaderboardsKit(appId, gameModel, options.leaderboards, this.engines);
-        this.features = new FeaturesKit(appId, gameModel);
-    }
-    /**
-     * Helpers for an additional lockable object type deployed under a different
-     * type name (e.g. both `Door` and `Chest` lock blueprints in one app).
-     */
-    objectsFor(objectTypeName, keyTypeName) {
-        return new ObjectsKit(this.appId, this.gameModel, {
-            objectTypeName,
-            keyTypeName,
-        });
-    }
-    /**
-     * **Studio (admin)** — load blueprints into the app: one transactional
-     * `gameModelSeed` for the definitions (and any seed containers/edges),
-     * followed by an `upsertAutomation` per automation and an
-     * `upsertAutomationTrigger` per event trigger. Idempotent: definitions
-     * upsert on their names, automations key on the automation name.
-     *
-     * Requires the app-admin `manage_apps` permission.
-     *
-     * @param blueprints - The blueprints to deploy. Duplicate type/function/
-     *   automation names across blueprints throw before anything is sent.
-     * @param options - `sessionId` scopes any seed containers to a session.
-     * @returns A {@link KitDeployResult} with the seed counts, the upserted
-     *   automations/triggers, and any non-fatal seed `warnings`.
-     * @throws {CrowdyGraphQLError} `FORBIDDEN` (`requiredPermission ===
-     *   'manage_apps'`) without app-admin, or `BAD_USER_INPUT` for definitions
-     *   that fail to compile.
-     */
-    async deploy(blueprints, options = {}) {
-        const list = Array.isArray(blueprints) ? blueprints : [blueprints];
-        const merged = mergeBlueprints(this.appId, list, options);
-        const seed = await this.gameModel.seed(merged.seedInput);
-        const automations = [];
-        for (const automation of merged.automations) {
-            automations.push(await this.gameModel.upsertAutomation(automation));
-        }
-        const automationTriggers = [];
-        for (const trigger of merged.automationTriggers) {
-            automationTriggers.push(await this.gameModel.upsertAutomationTrigger(trigger));
-        }
-        const engines = [];
-        for (const entry of options.engines ?? []) {
-            if (!this.compute) {
-                throw new Error('kit.deploy engines requires the compute domain (createCrowdyClient default)');
-            }
-            const [templateName, moduleOverride] = entry.split(':');
-            const module = await this.compute.deployTemplate({
-                appId: this.appId,
-                templateName,
-                ...(moduleOverride ? { moduleName: moduleOverride } : {}),
-            });
-            let compileStatus = 'pending';
-            if (options.waitForEngines !== false) {
-                const compiled = await this.compute.waitForCompile(this.appId, module.name);
-                compileStatus = compiled.compileStatus;
-            }
-            engines.push({ templateName, moduleName: module.name, compileStatus });
-        }
-        return {
-            seed,
-            automations,
-            automationTriggers,
-            engines,
-            warnings: [...(seed.warnings ?? [])],
-        };
     }
 }

package/dist/kit/social.d.ts

@@ -36,9 +36,7 @@ export interface KitChatMessage {
  * Runtime **social** helpers — parties, guilds, and chat rooms in familiar
  * words, wrapped over the platform's teams (membership + roles) and
  * channels (location-independent messaging) with realtime delivery via the
- * UDP notification subscription. No model schema needed; the only
- * deployable is the optional {@link guildBlueprint} composite (guild hall +
- * bank).
+ * UDP notification subscription. Nothing is deployed.
  *
  * Conventions: a party is a team named `party:<name>` paired with an
  * equally-named channel; a guild is `guild:<name>` likewise. Guild

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/social.js

@@ -3,9 +3,7 @@ import { decodeBase64, encodeBase64, generateCrowdyUuid } from '../utils.js';
  * Runtime **social** helpers — parties, guilds, and chat rooms in familiar
  * words, wrapped over the platform's teams (membership + roles) and
  * channels (location-independent messaging) with realtime delivery via the
- * UDP notification subscription. No model schema needed; the only
- * deployable is the optional {@link guildBlueprint} composite (guild hall +
- * bank).
+ * UDP notification subscription. Nothing is deployed.
  *
  * Conventions: a party is a team named `party:<name>` paired with an
  * equally-named channel; a guild is `guild:<name>` likewise. Guild

package/dist/kit/wire.d.ts

@@ -1,9 +1,9 @@
 /**
- * Engine wire registry — the client mirror of the server's
- * `crowdy-game-kit-core::wire` (the single source of truth for the actor
- * pose layout and flag-bit registry used by compute-module game engines).
- * Parity with the Rust crate is checked by the kit unit suite: any change
- * here must land in kit-core first.
+ * Engine wire registry — the client mirror of `crowdy-game-kit-core::wire`
+ * (the actor pose layout and flag-bit registry the game engines emit, and
+ * hubs that keep a game's client parsers still send). Parity with the Rust
+ * crate is checked by the kit wire unit suite: any change here must land in
+ * kit-core first.
  *
  * 48-byte little-endian pose: pos f32 x3 (0..11), yaw/pitch f32 (12..19),
  * velocity f32 x3 (20..31), flags u8 (32), held u8 (33), 34-35 reserved,
@@ -172,4 +172,15 @@ export interface RaceTimingEvent {
 }
 /** Parse a race-timing event; null when the payload is another type. */
 export declare function parseRaceTimingEvent(bytes: Uint8Array): RaceTimingEvent | null;
+/** A parsed type-98 zone-change event (a shrinking or moving play zone). */
+export interface ZoneChangeEvent {
+    kind: string;
+    phase: number | null;
+    radiusNow: number;
+    centerX: number;
+    centerZ: number;
+    body: Record<string, unknown>;
+}
+/** Parse a zone-change event; null when the payload is another type. */
+export declare function parseZoneChangeEvent(bytes: Uint8Array): ZoneChangeEvent | 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":"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"}
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/kit/wire.ts"],"names":[],"mappings":"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"}

package/dist/kit/wire.js

@@ -1,9 +1,9 @@
 /**
- * Engine wire registry — the client mirror of the server's
- * `crowdy-game-kit-core::wire` (the single source of truth for the actor
- * pose layout and flag-bit registry used by compute-module game engines).
- * Parity with the Rust crate is checked by the kit unit suite: any change
- * here must land in kit-core first.
+ * Engine wire registry — the client mirror of `crowdy-game-kit-core::wire`
+ * (the actor pose layout and flag-bit registry the game engines emit, and
+ * hubs that keep a game's client parsers still send). Parity with the Rust
+ * crate is checked by the kit wire unit suite: any change here must land in
+ * kit-core first.
  *
  * 48-byte little-endian pose: pos f32 x3 (0..11), yaw/pitch f32 (12..19),
  * velocity f32 x3 (20..31), flags u8 (32), held u8 (33), 34-35 reserved,
@@ -264,3 +264,17 @@ export function parseRaceTimingEvent(bytes) {
         body: parsed.body,
     };
 }
+/** Parse a zone-change event; null when the payload is another type. */
+export function parseZoneChangeEvent(bytes) {
+    const parsed = parseEngineEvent(bytes);
+    if (!parsed || parsed.eventType !== EVENT_ZONE_CHANGE)
+        return null;
+    return {
+        kind: String(parsed.body.kind ?? ''),
+        phase: parsed.body.phase != null ? Number(parsed.body.phase) : null,
+        radiusNow: Number(parsed.body.radiusNow ?? 0),
+        centerX: Number(parsed.body.centerX ?? 0),
+        centerZ: Number(parsed.body.centerZ ?? 0),
+        body: parsed.body,
+    };
+}