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

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