@crowdedkingdoms/crowdyjs 18.10.0 → 18.12.0-dev.1

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