@crowdedkingdoms/crowdyjs 18.10.0 → 18.11.0-dev.1

package/dist/kit/runtime.js

@@ -0,0 +1,194 @@
+import { CrowdyExecError, } from '../domains/exec.js';
+import { KitError, newActionId, withActionId } from './protocol.js';
+/** Subscriptions one connection holds at most (the gateway refuses the next). */
+export const KIT_SUBSCRIPTIONS_MAX = 256;
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/** A token bucket: `capacity` tokens a window, refilled continuously. */
+class Budget {
+    constructor(capacity, windowMs) {
+        this.capacity = capacity;
+        this.windowMs = windowMs;
+        this.last = Date.now();
+        this.blockedUntil = 0;
+        this.tokens = capacity;
+    }
+    refill() {
+        const now = Date.now();
+        this.tokens = Math.min(this.capacity, this.tokens + ((now - this.last) * this.capacity) / this.windowMs);
+        this.last = now;
+    }
+    async take() {
+        for (;;) {
+            const wait = this.blockedUntil - Date.now();
+            if (wait > 0) {
+                await sleep(wait);
+                continue;
+            }
+            this.refill();
+            if (this.tokens >= 1) {
+                this.tokens -= 1;
+                return;
+            }
+            await sleep(Math.ceil(((1 - this.tokens) * this.windowMs) / this.capacity));
+        }
+    }
+    /** The gateway said to wait: nothing is sent until `ms` from now. */
+    hold(ms) {
+        this.blockedUntil = Math.max(this.blockedUntil, Date.now() + ms);
+        this.tokens = 0;
+    }
+}
+/**
+ * The kit's way to the app's hubs: one {@link ExecConnection} shared by every kit module,
+ * opened when first needed. It paces what it sends to a budget below the gateway's limit,
+ * sends a call again when that is safe (it did not run, or it carries an action id the hub
+ * answers once), counts subscriptions under the gateway's cap, and turns a hub's coded
+ * refusal into a {@link KitError}.
+ */
+export class KitRuntime {
+    constructor(appId, exec, options = {}, whoAmI) {
+        this.appId = appId;
+        this.exec = exec;
+        this.options = options;
+        this.whoAmI = whoAmI;
+        this.conn = null;
+        this.connecting = null;
+        this.ended = null;
+        this.subs = new Map();
+        this.reconnectListeners = new Set();
+        this.endedListeners = new Set();
+        this.me = null;
+        this.budget = new Budget(Math.max(1, options.callBudget ?? 100), Math.max(1, options.budgetWindowMs ?? 10000));
+        this.retries = Math.max(0, options.retries ?? 2);
+    }
+    /** The connection, opened on first use. */
+    async connection() {
+        if (this.ended !== null)
+            throw new CrowdyExecError('Denied', `access ended: ${this.ended}`);
+        if (this.conn)
+            return this.conn;
+        if (!this.connecting) {
+            this.connecting = this.open().catch((e) => {
+                this.connecting = null;
+                throw e;
+            });
+        }
+        return this.connecting;
+    }
+    async open() {
+        let c = this.options.connection;
+        if (!c) {
+            if (!this.exec)
+                throw new CrowdyExecError('Unavailable', 'the kit has no exec client to connect with');
+            c = this.options.developer
+                ? await this.exec.connectAsDeveloper(this.appId, this.options.connect)
+                : await this.exec.connect(this.appId, this.options.connect);
+        }
+        c.onReconnect((host) => {
+            for (const l of [...this.reconnectListeners])
+                l(host);
+        });
+        c.onAccessEnded((reason) => {
+            this.ended = reason;
+            for (const l of [...this.endedListeners])
+                l(reason);
+        });
+        this.conn = c;
+        return c;
+    }
+    /** The player's id, from the options or `users.me`; null when neither knows it. */
+    async playerId() {
+        if (this.options.playerId !== undefined)
+            return String(this.options.playerId);
+        if (!this.me) {
+            this.me = this.whoAmI ? this.whoAmI().catch(() => null) : Promise.resolve(null);
+        }
+        return this.me;
+    }
+    /**
+     * Calls a hub's endpoint, `args` as MessagePack, and returns the decoded reply.
+     * @throws {KitError} for a hub's coded refusal; {@link CrowdyExecError} for the platform's.
+     */
+    async call(nodeType, key, method, args, options = {}) {
+        const actionId = options.action === true ? newActionId() : typeof options.action === 'string' ? options.action : undefined;
+        const sent = actionId ? withActionId(args, actionId) : args;
+        for (let attempt = 0;; attempt++) {
+            await this.budget.take();
+            const conn = await this.connection();
+            try {
+                return await conn.call(nodeType, key, method, sent, { timeoutMs: options.timeoutMs });
+            }
+            catch (e) {
+                const err = KitError.from(e);
+                if (attempt < this.retries && err instanceof CrowdyExecError && !(err instanceof KitError)) {
+                    if (err.status === 'Busy' && err.rateLimited) {
+                        this.budget.hold(err.retryAfterMs ?? 1000);
+                        continue;
+                    }
+                    const didNotRun = err.status === 'Busy' || err.status === 'RateLimited';
+                    const unknown = err.status === 'DeadlineExceeded' || err.status === 'Unavailable' || err.status === 'Moved';
+                    if (didNotRun || (actionId && unknown)) {
+                        await sleep(Math.min(2000, 200 * 2 ** attempt) * (0.5 + Math.random() / 2));
+                        continue;
+                    }
+                }
+                throw err;
+            }
+        }
+    }
+    /**
+     * Receives what a hub publishes on `topic`. Returns the function that stops this handler
+     * (and the subscription with the last one).
+     * @throws {KitError} `limit` past {@link KIT_SUBSCRIPTIONS_MAX} subscriptions.
+     */
+    async subscribe(nodeType, key, topic, onPush) {
+        const k = `${nodeType}\u0000${key}\u0000${topic}`;
+        const held = this.subs.get(k) ?? 0;
+        if (held === 0) {
+            if (this.subs.size >= KIT_SUBSCRIPTIONS_MAX) {
+                throw new KitError('limit', `a connection holds at most ${KIT_SUBSCRIPTIONS_MAX} subscriptions`);
+            }
+            await this.budget.take();
+        }
+        const conn = await this.connection();
+        const stop = await conn.subscribe(nodeType, key, topic, onPush);
+        this.subs.set(k, (this.subs.get(k) ?? 0) + 1);
+        let stopped = false;
+        return async () => {
+            if (stopped)
+                return;
+            stopped = true;
+            const left = (this.subs.get(k) ?? 1) - 1;
+            if (left > 0) {
+                this.subs.set(k, left);
+            }
+            else {
+                this.subs.delete(k);
+                await this.budget.take();
+            }
+            await stop();
+        };
+    }
+    /** How many distinct topics the kit subscribes to. */
+    get subscriptions() {
+        return this.subs.size;
+    }
+    /** Called with the new host after the connection reconnects; kit mirrors resync then. */
+    onReconnect(listener) {
+        this.reconnectListeners.add(listener);
+        return () => this.reconnectListeners.delete(listener);
+    }
+    /** Called once when the player's access ended (close code 4403); nothing reconnects. */
+    onAccessEnded(listener) {
+        this.endedListeners.add(listener);
+        return () => this.endedListeners.delete(listener);
+    }
+    /** Closes the connection the kit opened (not one it was given). */
+    close() {
+        if (this.conn && !this.options.connection)
+            this.conn.close();
+        this.conn = null;
+        this.connecting = null;
+        this.subs.clear();
+    }
+}

package/dist/kit/store.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The kit's observable value: `get` the current value, `subscribe` to hear each new one. The
+ * shape React's `useSyncExternalStore(store.subscribe, store.get)` takes, and that any other
+ * framework wraps in a line.
+ */
+export interface KitStore<T> {
+    get(): T;
+    /** Calls `listener` with every new value; returns the function that stops it. */
+    subscribe(listener: (value: T) => void): () => void;
+}
+/** A {@link KitStore} its owner sets. */
+export declare class WritableKitStore<T> implements KitStore<T> {
+    private value;
+    private readonly listeners;
+    constructor(initial: T);
+    get(): T;
+    subscribe(listener: (value: T) => void): () => void;
+    set(value: T): void;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/kit/store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,GAAG,IAAI,CAAC,CAAC;IACT,iFAAiF;IACjF,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACrD;AAED,yCAAyC;AACzC,qBAAa,gBAAgB,CAAC,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;gBAE/C,OAAO,EAAE,CAAC;IAItB,GAAG,IAAI,CAAC;IAIR,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAKnD,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;CAUpB"}

package/dist/kit/store.js

@@ -0,0 +1,25 @@
+/** A {@link KitStore} its owner sets. */
+export class WritableKitStore {
+    constructor(initial) {
+        this.listeners = new Set();
+        this.value = initial;
+    }
+    get() {
+        return this.value;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    set(value) {
+        this.value = value;
+        for (const l of [...this.listeners]) {
+            try {
+                l(value);
+            }
+            catch {
+                /* a listener's exception is its own */
+            }
+        }
+    }
+}

package/dist/kit/topology.d.ts

@@ -0,0 +1,69 @@
+import type { ExecAPI, ExecBuild, ExecManifestType, ExecNodeTypeInput, ExecStarterPack } from '../domains/exec.js';
+/** The crates one build takes at most (the game API's `execBuild`). */
+export declare const KIT_BUILD_MAX_CRATES = 16;
+/** The node API scopes a manifest may declare (ck-exec `bounds::NODE_API_SCOPES`). */
+export declare const KIT_NODE_API_SCOPES: readonly string[];
+/** A manifest as the kit composes it: the root hub and each node type. */
+export interface KitManifest {
+    root: string;
+    types: Record<string, ExecNodeTypeInput | ExecManifestType>;
+}
+/** What {@link KitTopology.plan} composes: a manifest, and the starter crates it builds. */
+export interface KitTopologyPlan {
+    root: string;
+    types: Record<string, ExecNodeTypeInput>;
+    /** The starter crates the types name, each built once. */
+    crates: string[];
+}
+/** Changes to a planned type: a seed, limits, replicas, scopes, `client`, ... */
+export interface KitPlanOptions {
+    overrides?: Record<string, Partial<ExecNodeTypeInput>>;
+}
+/** How {@link KitTopology.deploy} waits for its build. */
+export interface KitDeployOptions {
+    /** Default 10 minutes. */
+    timeoutMs?: number;
+    /** Called with the build once it is done. */
+    onBuild?: (build: ExecBuild) => void;
+}
+/**
+ * What the execution manager would refuse in `manifest`, in its words (ck-exec
+ * `Manifest::problems`, less the digests, which the build fills in): the root is a hub
+ * without a parent, every other type has a defined parent, `calls` name defined types or `*`,
+ * replicas are for spokes, scopes are known. Empty when it deploys.
+ */
+export declare function kitManifestProblems(manifest: KitManifest): string[];
+/**
+ * An app's tree of kit hubs, composed from the starter packs (`exec.starters`): pick the node
+ * types a game uses, and {@link plan} adds the hubs they hang under and the ones they call,
+ * checks the tree, and {@link deploy} builds the crates on the platform and deploys them.
+ * For the app's developers (the org's `manage_compute`), from an identity session.
+ */
+export declare class KitTopology {
+    private readonly appId;
+    private readonly exec;
+    private packed;
+    constructor(appId: string, exec: ExecAPI | undefined);
+    private api;
+    /** The starter packs this tier's toolchain carries (fetched once). */
+    pack(): Promise<ExecStarterPack>;
+    /** The node types the packs offer. */
+    types(): Promise<string[]>;
+    /**
+     * A manifest with the types in `select`, the types they hang under up to the root, and the
+     * types they call (by name, not `*`), from the packs' manifest.
+     * @throws {CrowdyError} for a type the packs do not have, a tree the manager would refuse,
+     *   or more crates than one build takes.
+     */
+    plan(select: readonly string[], options?: KitPlanOptions): Promise<KitTopologyPlan>;
+    /**
+     * Builds the plan's crates on the platform, waits, and deploys the manifest with the build.
+     * Resolves with the deployed version and the build id.
+     * @throws {CrowdyError} when the build fails (its log in the message).
+     */
+    deploy(plan: KitTopologyPlan, options?: KitDeployOptions): Promise<{
+        version: number;
+        buildId: string;
+    }>;
+}
+//# sourceMappingURL=topology.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topology.d.ts","sourceRoot":"","sources":["../../src/kit/topology.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,SAAS,EAET,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAE5B,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAUhD,CAAC;AAEF,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,gBAAgB,CAAC,CAAC;CAC7D;AAED,4FAA4F;AAC5F,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACzC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;CACxD;AAED,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC;AAID;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,EAAE,CA0BnE;AAED;;;;;GAKG;AACH,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,OAAO,CAAC,MAAM,CAAyC;gBAGpC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,GAAG,SAAS;IAG5C,OAAO,CAAC,GAAG;IAKX,sEAAsE;IACtE,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAYhC,sCAAsC;IAChC,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIhC;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IA8B7F;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAiBnH"}

package/dist/kit/topology.js

@@ -0,0 +1,156 @@
+import { CrowdyError } from '../errors.js';
+/** The crates one build takes at most (the game API's `execBuild`). */
+export const KIT_BUILD_MAX_CRATES = 16;
+/** The node API scopes a manifest may declare (ck-exec `bounds::NODE_API_SCOPES`). */
+export const KIT_NODE_API_SCOPES = [
+    'players.read',
+    'players.write',
+    'world.read',
+    'world.write',
+    'grids.read',
+    'permissions.write',
+    'grids.write',
+    'access.read',
+    'access.write',
+];
+const NAME = /^[A-Za-z0-9_-]{1,64}$/;
+/**
+ * What the execution manager would refuse in `manifest`, in its words (ck-exec
+ * `Manifest::problems`, less the digests, which the build fills in): the root is a hub
+ * without a parent, every other type has a defined parent, `calls` name defined types or `*`,
+ * replicas are for spokes, scopes are known. Empty when it deploys.
+ */
+export function kitManifestProblems(manifest) {
+    const out = [];
+    const types = manifest.types;
+    const root = types[manifest.root];
+    if (!root)
+        out.push(`root type \`${manifest.root}\` is not defined`);
+    else if (root.kind !== 'hub')
+        out.push('the root type must be a hub');
+    else if (root.parent)
+        out.push('the root type has no parent');
+    for (const [name, t] of Object.entries(types)) {
+        if (!NAME.test(name))
+            out.push(`type name \`${name}\` must be 1-64 letters, digits, \`-\` or \`_\``);
+        if (name !== manifest.root) {
+            if (!t.parent)
+                out.push(`\`${name}\` needs a parent`);
+            else if (!types[t.parent])
+                out.push(`\`${name}\`: parent \`${t.parent}\` is not defined`);
+        }
+        for (const c of t.calls ?? []) {
+            if (c !== '*' && !types[c])
+                out.push(`\`${name}\` calls \`${c}\`, which is not defined`);
+        }
+        if (t.kind === 'hub' && (t.replicas !== undefined || t.max_replicas !== undefined || t.concurrency !== undefined)) {
+            out.push(`\`${name}\`: replicas, max_replicas and concurrency are for spokes`);
+        }
+        for (const s of t.scopes ?? []) {
+            if (!KIT_NODE_API_SCOPES.includes(s)) {
+                out.push(`\`${name}\`: unknown node API scope \`${s}\` (allowed: ${KIT_NODE_API_SCOPES.join(', ')})`);
+            }
+        }
+    }
+    return out;
+}
+/**
+ * An app's tree of kit hubs, composed from the starter packs (`exec.starters`): pick the node
+ * types a game uses, and {@link plan} adds the hubs they hang under and the ones they call,
+ * checks the tree, and {@link deploy} builds the crates on the platform and deploys them.
+ * For the app's developers (the org's `manage_compute`), from an identity session.
+ */
+export class KitTopology {
+    constructor(appId, exec) {
+        this.appId = appId;
+        this.exec = exec;
+        this.packed = null;
+    }
+    api() {
+        if (!this.exec)
+            throw new CrowdyError({ message: 'the kit has no exec client' });
+        return this.exec;
+    }
+    /** The starter packs this tier's toolchain carries (fetched once). */
+    pack() {
+        if (!this.packed) {
+            this.packed = this.api()
+                .starters(this.appId)
+                .catch((e) => {
+                this.packed = null;
+                throw e;
+            });
+        }
+        return this.packed;
+    }
+    /** The node types the packs offer. */
+    async types() {
+        return Object.keys((await this.pack()).manifest.types);
+    }
+    /**
+     * A manifest with the types in `select`, the types they hang under up to the root, and the
+     * types they call (by name, not `*`), from the packs' manifest.
+     * @throws {CrowdyError} for a type the packs do not have, a tree the manager would refuse,
+     *   or more crates than one build takes.
+     */
+    async plan(select, options = {}) {
+        const pack = await this.pack();
+        const all = pack.manifest.types;
+        const chosen = new Set();
+        const add = (name) => {
+            if (chosen.has(name))
+                return;
+            const t = all[name];
+            if (!t)
+                throw new CrowdyError({ message: `the starter packs have no node type '${name}' (they have ${Object.keys(all).join(', ')})` });
+            chosen.add(name);
+            if (t.parent)
+                add(t.parent);
+            for (const c of t.calls ?? [])
+                if (c !== '*')
+                    add(c);
+        };
+        add(pack.manifest.root);
+        for (const name of select)
+            add(name);
+        const types = {};
+        for (const name of chosen) {
+            const merged = { ...all[name], ...(options.overrides?.[name] ?? {}) };
+            // A type calls only what the plan holds.
+            if (merged.calls)
+                merged.calls = merged.calls.filter((c) => c === '*' || chosen.has(c));
+            types[name] = merged;
+        }
+        const problems = kitManifestProblems({ root: pack.manifest.root, types });
+        if (problems.length)
+            throw new CrowdyError({ message: `the composed manifest would be refused: ${problems.join('; ')}` });
+        const crates = [...new Set(Object.values(types).map((t) => t.crate).filter((c) => typeof c === 'string'))];
+        if (crates.length > KIT_BUILD_MAX_CRATES) {
+            throw new CrowdyError({ message: `${crates.length} crates are more than one build takes (${KIT_BUILD_MAX_CRATES})` });
+        }
+        return { root: pack.manifest.root, types, crates };
+    }
+    /**
+     * Builds the plan's crates on the platform, waits, and deploys the manifest with the build.
+     * Resolves with the deployed version and the build id.
+     * @throws {CrowdyError} when the build fails (its log in the message).
+     */
+    async deploy(plan, options = {}) {
+        const pack = await this.pack();
+        const crates = plan.crates.map((name) => {
+            const s = pack.starters.find((x) => x.crate === name);
+            if (!s)
+                throw new CrowdyError({ message: `the starter packs have no crate '${name}'` });
+            return { name, files: s.files };
+        });
+        const exec = this.api();
+        const queued = await exec.build(this.appId, crates);
+        const done = await exec.waitForBuild(this.appId, queued.buildId, { timeoutMs: options.timeoutMs });
+        options.onBuild?.(done);
+        if (done.status !== 'succeeded') {
+            throw new CrowdyError({ message: `build ${done.buildId} ${done.status}: ${(done.log ?? '').slice(-2000)}` });
+        }
+        const { version } = await exec.deploy({ appId: this.appId, root: plan.root, types: plan.types, buildId: done.buildId });
+        return { version, buildId: done.buildId };
+    }
+}

package/dist/kit/wire.d.ts

@@ -1,9 +1,11 @@
 /**
- * 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.
+ * The kit's realtime wire: the server-event registry kit hubs emit through
+ * the realtime tier (`ckx_sdk::kit::wire` is its source: ids 77 and 90-101,
+ * JSON bodies with camelCase keys, an app's own from 1000), and the 48-byte
+ * engine pose layout with its flag bits, for hubs that show actors with it
+ * rather than with `KitActorState` (`realtime.ts`). The registry's bodies are
+ * held to ck-exec's `kit-protocol.json` by the kit protocol unit suite: a
+ * change lands in `ckx_sdk::kit::wire` 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,
@@ -76,6 +78,14 @@ export declare const EVENT_CONTROL_POINT = 96;
 export declare const EVENT_RACE_TIMING = 97;
 /** Zone change: shrinking circles, event areas (kit-sim zones). */
 export declare const EVENT_ZONE_CHANGE = 98;
+/** Encounter: a wave began or was cleared, a boss changed phase (directors). */
+export declare const EVENT_ENCOUNTER = 99;
+/** Possession: the contested object (a ball) changed hands, or a goal was scored. */
+export declare const EVENT_POSSESSION = 100;
+/** An emote: a client event players send, the kit's convention ({@link EmotesKit}). */
+export declare const EVENT_EMOTE = 101;
+/** The first event type an app's own events may use. */
+export declare const EVENT_APP_FIRST = 1000;
 /** Split an engine server-event payload into its type + JSON body. */
 export declare function parseEngineEvent(bytes: Uint8Array): {
     eventType: number;
@@ -183,4 +193,34 @@ export interface ZoneChangeEvent {
 }
 /** Parse a zone-change event; null when the payload is another type. */
 export declare function parseZoneChangeEvent(bytes: Uint8Array): ZoneChangeEvent | null;
+/** A parsed type-99 encounter event (a wave began or was cleared, a boss changed phase). */
+export interface EncounterEvent {
+    /** `'wave_started'`, `'wave_cleared'`, `'boss_phase'` or `'finished'`. */
+    kind: string;
+    encounterId: string;
+    wave: number;
+    phase: number;
+    body: Record<string, unknown>;
+}
+/** Parse an encounter event; null when the payload is another type. */
+export declare function parseEncounterEvent(bytes: Uint8Array): EncounterEvent | null;
+/** A parsed type-100 possession event (the contested object changed hands, or a goal). */
+export interface PossessionEvent {
+    /** `'claimed'`, `'passed'`, `'loose'` or `'goal'`. */
+    kind: string;
+    holderId: string | null;
+    team: string | null;
+    body: Record<string, unknown>;
+}
+/** Parse a possession event; null when the payload is another type. */
+export declare function parsePossessionEvent(bytes: Uint8Array): PossessionEvent | null;
+/** A parsed type-101 emote (a client event, the kit's convention). */
+export interface EmoteEvent {
+    emote: string;
+    /** The actor the emote is aimed at, if any. */
+    targetUuid: string | null;
+    body: Record<string, unknown>;
+}
+/** Parse an emote; null when the payload is another type. */
+export declare function parseEmoteEvent(bytes: Uint8Array): EmoteEvent | 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,11 @@
 /**
- * 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.
+ * The kit's realtime wire: the server-event registry kit hubs emit through
+ * the realtime tier (`ckx_sdk::kit::wire` is its source: ids 77 and 90-101,
+ * JSON bodies with camelCase keys, an app's own from 1000), and the 48-byte
+ * engine pose layout with its flag bits, for hubs that show actors with it
+ * rather than with `KitActorState` (`realtime.ts`). The registry's bodies are
+ * held to ck-exec's `kit-protocol.json` by the kit protocol unit suite: a
+ * change lands in `ckx_sdk::kit::wire` 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,
@@ -130,6 +132,14 @@ export const EVENT_CONTROL_POINT = 96;
 export const EVENT_RACE_TIMING = 97;
 /** Zone change: shrinking circles, event areas (kit-sim zones). */
 export const EVENT_ZONE_CHANGE = 98;
+/** Encounter: a wave began or was cleared, a boss changed phase (directors). */
+export const EVENT_ENCOUNTER = 99;
+/** Possession: the contested object (a ball) changed hands, or a goal was scored. */
+export const EVENT_POSSESSION = 100;
+/** An emote: a client event players send, the kit's convention ({@link EmotesKit}). */
+export const EVENT_EMOTE = 101;
+/** The first event type an app's own events may use. */
+export const EVENT_APP_FIRST = 1000;
 /** Split an engine server-event payload into its type + JSON body. */
 export function parseEngineEvent(bytes) {
     if (bytes.length < 2)
@@ -278,3 +288,39 @@ export function parseZoneChangeEvent(bytes) {
         body: parsed.body,
     };
 }
+/** Parse an encounter event; null when the payload is another type. */
+export function parseEncounterEvent(bytes) {
+    const parsed = parseEngineEvent(bytes);
+    if (!parsed || parsed.eventType !== EVENT_ENCOUNTER)
+        return null;
+    return {
+        kind: String(parsed.body.kind ?? ''),
+        encounterId: String(parsed.body.encounterId ?? ''),
+        wave: Number(parsed.body.wave ?? 0),
+        phase: Number(parsed.body.phase ?? 0),
+        body: parsed.body,
+    };
+}
+/** Parse a possession event; null when the payload is another type. */
+export function parsePossessionEvent(bytes) {
+    const parsed = parseEngineEvent(bytes);
+    if (!parsed || parsed.eventType !== EVENT_POSSESSION)
+        return null;
+    return {
+        kind: String(parsed.body.kind ?? ''),
+        holderId: parsed.body.holderId != null ? String(parsed.body.holderId) : null,
+        team: parsed.body.team != null ? String(parsed.body.team) : null,
+        body: parsed.body,
+    };
+}
+/** Parse an emote; null when the payload is another type. */
+export function parseEmoteEvent(bytes) {
+    const parsed = parseEngineEvent(bytes);
+    if (!parsed || parsed.eventType !== EVENT_EMOTE)
+        return null;
+    return {
+        emote: String(parsed.body.emote ?? ''),
+        targetUuid: parsed.body.targetUuid != null ? String(parsed.body.targetUuid) : null,
+        body: parsed.body,
+    };
+}