@crowdedkingdoms/crowdyjs 18.10.0 → 18.12.0-dev.1

package/dist/kit/modules/encounters.js

@@ -0,0 +1,57 @@
+import { HubState } from '../mirror.js';
+/** Waves, towers and bosses (the `director` starter): {@link encounter} by key. */
+export class EncountersKit {
+    constructor(runtime, nodeType = 'director') {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.encounters = new Map();
+    }
+    encounter(key) {
+        let e = this.encounters.get(key);
+        if (!e) {
+            e = new Encounter(this.runtime, this.nodeType, key);
+            this.encounters.set(key, e);
+        }
+        return e;
+    }
+}
+/**
+ * One encounter: waves of enemies down a lane to the players' base, towers the players build (a
+ * tower may not cut the lane), strikes on a cooldown, kills that pay gold, and a boss that changes
+ * phase as it weakens. {@link view} mirrors the `encounter` topic: snapshots once a second while it
+ * runs, and `event` messages (`type`: `wave_started`, `wave_cleared`, `boss_phase`, `won`, `lost`)
+ * through `view.onEvent`.
+ */
+export class Encounter {
+    constructor(runtime, nodeType, key) {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.key = key;
+        this.view = new HubState(runtime, nodeType, key, 'encounter');
+    }
+    watch() {
+        return this.view.start();
+    }
+    unwatch() {
+        return this.view.stop();
+    }
+    /** @throws {KitError} `full`. */
+    join() {
+        return this.runtime.call(this.nodeType, this.key, 'join', null, { action: true });
+    }
+    /** The first to join, or a developer. @throws {KitError} `forbidden`, `started`, `bad_request` (no way to the base). */
+    start() {
+        return this.runtime.call(this.nodeType, this.key, 'start', null, { action: true });
+    }
+    /**
+     * Builds a tower at `(x, z)`; resolves with the gold left.
+     * @throws {KitError} `blocks_lane`, `insufficient` (gold), `conflict` (taken), `bad_request`, `not_member`.
+     */
+    build(x, z) {
+        return this.runtime.call(this.nodeType, this.key, 'build', { x, z }, { action: true });
+    }
+    /** Strikes enemy `enemy`; resolves with its hp left. @throws {KitError} `cooldown`, `not_found`, `not_member`. */
+    hit(enemy) {
+        return this.runtime.call(this.nodeType, this.key, 'hit', { enemy }, { action: true });
+    }
+}

package/dist/kit/modules/instances.d.ts

@@ -0,0 +1,78 @@
+import { HubState } from '../mirror.js';
+import type { KitRuntime } from '../runtime.js';
+export interface InstanceRoom {
+    kind: 'fight' | 'treasure' | 'rest' | 'boss';
+    /** What a fight here takes. */
+    power: number;
+    done: boolean;
+}
+export interface InstanceMember {
+    player: number;
+    hp: number;
+    max_hp: number;
+    power: number;
+}
+/** What the `run` topic carries. */
+export interface InstanceRunView {
+    phase: 'unopened' | 'running' | 'cleared' | 'wiped' | 'abandoned' | 'expired';
+    owner: number | null;
+    /** The run's seed: the same seed lays out the same floors. */
+    seed: number;
+    floor: number;
+    floors: number;
+    /** The room the party is at on this floor. */
+    room: number;
+    rooms: InstanceRoom[];
+    members: InstanceMember[];
+    invited: number[];
+    gold: number;
+    relics: string[];
+    /** The grid reserved for the run, when the hub's config has a volume. */
+    grid: number | null;
+    log: string[];
+}
+/** Private runs for one party (the `instance` starter): {@link run} by key. */
+export declare class InstancesKit {
+    private readonly runtime;
+    private readonly nodeType;
+    private readonly runs;
+    constructor(runtime: KitRuntime, nodeType?: string);
+    /** The run with key `key` (a key the game makes up, one per run). */
+    run(key: string): InstanceRun;
+}
+/**
+ * One run: a party plays down floors the hub generates from the run's seed, the hub resolves each
+ * room, a party with nobody standing is wiped (permadeath), and a run nobody touches expires. A
+ * cleared or wiped run posts each member's depth to a leaderboard when the hub's config names one.
+ */
+export declare class InstanceRun {
+    private readonly runtime;
+    readonly nodeType: string;
+    readonly key: string;
+    readonly view: HubState<InstanceRunView>;
+    constructor(runtime: KitRuntime, nodeType: string, key: string);
+    watch(): Promise<InstanceRunView>;
+    unwatch(): Promise<void>;
+    /**
+     * Opens the run as its owner (a developer kit opens one for `party`); resolves with its seed.
+     * @throws {KitError} `started`, `bad_request` (party size), `conflict` (its grid could not be reserved).
+     */
+    open(options?: {
+        seed?: number;
+        party?: ReadonlyArray<number | string>;
+    }): Promise<number>;
+    /** The owner invites a player. @throws {KitError} `forbidden`, `full`. */
+    invite(player: number | string): Promise<boolean>;
+    /** An invited player joins. @throws {KitError} `forbidden`. */
+    join(): Promise<boolean>;
+    /**
+     * Resolves the room the party is at; resolves with what happened, as the log has it.
+     * @throws {KitError} `not_member`, `forbidden` (the caller is down), `conflict` (descend first), `finished`.
+     */
+    enter(): Promise<string>;
+    /** The owner leads the party to the next floor; resolves with it. @throws {KitError} `not_ready` (rooms left), `forbidden`. */
+    descend(): Promise<number>;
+    /** The owner (or a developer) ends the run. */
+    abandon(): Promise<boolean>;
+}
+//# sourceMappingURL=instances.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../../src/kit/modules/instances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IAC7C,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;IAC9E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,yEAAyE;IACzE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAED,+EAA+E;AAC/E,qBAAa,YAAY;IAIrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;gBAGpC,OAAO,EAAE,UAAU,EACnB,QAAQ,SAAa;IAGxC,qEAAqE;IACrE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;CAQ9B;AAED;;;;GAIG;AACH,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM;IALtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;gBAGtB,OAAO,EAAE,UAAU,EAC3B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM;IAKtB,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC;IAIjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB;;;OAGG;IACH,IAAI,CAAC,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAO9F,0EAA0E;IAC1E,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjD,+DAA+D;IAC/D,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxB;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAIxB,+HAA+H;IAC/H,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAI1B,+CAA+C;IAC/C,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAG5B"}

package/dist/kit/modules/instances.js

@@ -0,0 +1,72 @@
+import { HubState } from '../mirror.js';
+/** Private runs for one party (the `instance` starter): {@link run} by key. */
+export class InstancesKit {
+    constructor(runtime, nodeType = 'instance') {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.runs = new Map();
+    }
+    /** The run with key `key` (a key the game makes up, one per run). */
+    run(key) {
+        let r = this.runs.get(key);
+        if (!r) {
+            r = new InstanceRun(this.runtime, this.nodeType, key);
+            this.runs.set(key, r);
+        }
+        return r;
+    }
+}
+/**
+ * One run: a party plays down floors the hub generates from the run's seed, the hub resolves each
+ * room, a party with nobody standing is wiped (permadeath), and a run nobody touches expires. A
+ * cleared or wiped run posts each member's depth to a leaderboard when the hub's config names one.
+ */
+export class InstanceRun {
+    constructor(runtime, nodeType, key) {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.key = key;
+        this.view = new HubState(runtime, nodeType, key, 'run');
+    }
+    watch() {
+        return this.view.start();
+    }
+    unwatch() {
+        return this.view.stop();
+    }
+    /**
+     * Opens the run as its owner (a developer kit opens one for `party`); resolves with its seed.
+     * @throws {KitError} `started`, `bad_request` (party size), `conflict` (its grid could not be reserved).
+     */
+    open(options = {}) {
+        const args = {};
+        if (options.seed !== undefined)
+            args.seed = options.seed;
+        if (options.party?.length)
+            args.party = options.party.map(Number);
+        return this.runtime.call(this.nodeType, this.key, 'open', args, { action: true });
+    }
+    /** The owner invites a player. @throws {KitError} `forbidden`, `full`. */
+    invite(player) {
+        return this.runtime.call(this.nodeType, this.key, 'invite', { player: Number(player) }, { action: true });
+    }
+    /** An invited player joins. @throws {KitError} `forbidden`. */
+    join() {
+        return this.runtime.call(this.nodeType, this.key, 'join', null, { action: true });
+    }
+    /**
+     * Resolves the room the party is at; resolves with what happened, as the log has it.
+     * @throws {KitError} `not_member`, `forbidden` (the caller is down), `conflict` (descend first), `finished`.
+     */
+    enter() {
+        return this.runtime.call(this.nodeType, this.key, 'enter', null, { action: true });
+    }
+    /** The owner leads the party to the next floor; resolves with it. @throws {KitError} `not_ready` (rooms left), `forbidden`. */
+    descend() {
+        return this.runtime.call(this.nodeType, this.key, 'descend', null, { action: true });
+    }
+    /** The owner (or a developer) ends the run. */
+    abandon() {
+        return this.runtime.call(this.nodeType, this.key, 'abandon', null, { action: true });
+    }
+}

package/dist/kit/modules/leaderboards.d.ts

@@ -0,0 +1,79 @@
+import { HubState } from '../mirror.js';
+import type { KitRuntime } from '../runtime.js';
+/** A player's place on a board. */
+export interface LeaderboardRank {
+    rank: number;
+    player: number;
+    score: number;
+}
+/** What the `board` topic carries: the top of the board and the season. */
+export interface LeaderboardView {
+    season: number;
+    /** When the season began (Unix ms). */
+    season_started: number;
+    /** Players with a score this season. */
+    entries: number;
+    top: LeaderboardRank[];
+}
+/** The season, and the last one's final standings. */
+export interface LeaderboardSeason {
+    season: number;
+    started: number;
+    entries: number;
+    last: LeaderboardRank[];
+}
+/** A board's settings (developers). */
+export interface LeaderboardConfig {
+    /** `best` (by `order`), `sum` or `latest` submission. */
+    keep?: 'best' | 'sum' | 'latest';
+    /** `high` scores rank first (points) or `low` (times). */
+    order?: 'high' | 'low';
+    top_size?: number;
+    /** A cron schedule that ends the season (`0 0 * * 1`: every Monday), or null for none. */
+    season_cron?: string | null;
+    max_entries?: number;
+}
+/** Leaderboards (the `leaderboard` starter): {@link board} by name. */
+export declare class LeaderboardsKit {
+    private readonly runtime;
+    private readonly nodeType;
+    private readonly boards;
+    constructor(runtime: KitRuntime, nodeType?: string);
+    /** The board named `name` (`weekly-score`, `fastest-lap`, ...). */
+    board(name: string): LeaderboardHandle;
+}
+/**
+ * One board. The hub ranks players itself, and only other hubs and developers submit: a client
+ * never sends its own score, the hub that decided the result does (a session, a race, a run).
+ * {@link view} mirrors the `board` topic (at most once a second).
+ */
+export declare class LeaderboardHandle {
+    private readonly runtime;
+    readonly nodeType: string;
+    readonly name: string;
+    /** The `board` topic: the top of the board and the season. */
+    readonly view: HubState<LeaderboardView>;
+    constructor(runtime: KitRuntime, nodeType: string, name: string);
+    watch(): Promise<LeaderboardView>;
+    unwatch(): Promise<void>;
+    /** A page of the board, best first. */
+    top(options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<LeaderboardRank[]>;
+    /** The places around a player (the caller's own, without `player`). */
+    around(options?: {
+        player?: number | string;
+        radius?: number;
+    }): Promise<LeaderboardRank[]>;
+    /** The caller's own place, or null without a score this season. */
+    me(): Promise<LeaderboardRank | null>;
+    season(): Promise<LeaderboardSeason>;
+    /** Submits a score for `player`. Developers only (a developer kit); players are refused. */
+    submit(player: number | string, score: number): Promise<number>;
+    /** Sets the board's config. Developers only. */
+    configure(config: LeaderboardConfig): Promise<boolean>;
+    /** Ends the season now; resolves with the new season. Developers only. */
+    roll(): Promise<number>;
+}
+//# sourceMappingURL=leaderboards.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboards.d.ts","sourceRoot":"","sources":["../../../src/kit/modules/leaderboards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,eAAe,EAAE,CAAC;CACxB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,EAAE,CAAC;CACzB;AAED,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IACjC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,uEAAuE;AACvE,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;gBAG5C,OAAO,EAAE,UAAU,EACnB,QAAQ,SAAgB;IAG3C,mEAAmE;IACnE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;CAQvC;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM;IANvB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;gBAGtB,OAAO,EAAE,UAAU,EAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM;IAKvB,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC;IAIjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,uCAAuC;IACvC,GAAG,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIlF,uEAAuE;IACvE,MAAM,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAO/F,mEAAmE;IACnE,EAAE,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIrC,MAAM,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAIpC,4FAA4F;IAC5F,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/D,gDAAgD;IAChD,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD,0EAA0E;IAC1E,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;CAGxB"}

package/dist/kit/modules/leaderboards.js

@@ -0,0 +1,69 @@
+import { HubState } from '../mirror.js';
+/** Leaderboards (the `leaderboard` starter): {@link board} by name. */
+export class LeaderboardsKit {
+    constructor(runtime, nodeType = 'leaderboard') {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.boards = new Map();
+    }
+    /** The board named `name` (`weekly-score`, `fastest-lap`, ...). */
+    board(name) {
+        let b = this.boards.get(name);
+        if (!b) {
+            b = new LeaderboardHandle(this.runtime, this.nodeType, name);
+            this.boards.set(name, b);
+        }
+        return b;
+    }
+}
+/**
+ * One board. The hub ranks players itself, and only other hubs and developers submit: a client
+ * never sends its own score, the hub that decided the result does (a session, a race, a run).
+ * {@link view} mirrors the `board` topic (at most once a second).
+ */
+export class LeaderboardHandle {
+    constructor(runtime, nodeType, name) {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.name = name;
+        this.view = new HubState(runtime, nodeType, name, 'board');
+    }
+    watch() {
+        return this.view.start();
+    }
+    unwatch() {
+        return this.view.stop();
+    }
+    /** A page of the board, best first. */
+    top(options = {}) {
+        return this.runtime.call(this.nodeType, this.name, 'top', options);
+    }
+    /** The places around a player (the caller's own, without `player`). */
+    around(options = {}) {
+        const args = {};
+        if (options.player !== undefined)
+            args.player = Number(options.player);
+        if (options.radius !== undefined)
+            args.radius = options.radius;
+        return this.runtime.call(this.nodeType, this.name, 'around', args);
+    }
+    /** The caller's own place, or null without a score this season. */
+    me() {
+        return this.runtime.call(this.nodeType, this.name, 'me');
+    }
+    season() {
+        return this.runtime.call(this.nodeType, this.name, 'season');
+    }
+    /** Submits a score for `player`. Developers only (a developer kit); players are refused. */
+    submit(player, score) {
+        return this.runtime.call(this.nodeType, this.name, 'submit', { player: Number(player), score }, { action: true });
+    }
+    /** Sets the board's config. Developers only. */
+    configure(config) {
+        return this.runtime.call(this.nodeType, this.name, 'configure', config, { action: true });
+    }
+    /** Ends the season now; resolves with the new season. Developers only. */
+    roll() {
+        return this.runtime.call(this.nodeType, this.name, 'roll', null, { action: true });
+    }
+}

package/dist/kit/modules/matchmaking.d.ts

@@ -0,0 +1,107 @@
+import { HubState } from '../mirror.js';
+import type { KitRuntime } from '../runtime.js';
+import { type KitStore } from '../store.js';
+/** A player's place in a queue, as the matchmaker's `status` (and every change) answers it. */
+export type MatchPlace = {
+    state: 'idle';
+} | {
+    state: 'party';
+    leader: number;
+    members: number[];
+    confirmed: number[];
+    expires_in_ms: number;
+} | {
+    state: 'queued';
+    rating: number;
+    waited_ms: number;
+    window: number;
+} | {
+    state: 'proposed';
+    players: number[];
+    accepted: number[];
+    expires_in_ms: number;
+} | {
+    state: 'matched';
+    session: string;
+};
+/** What the `queue` topic carries: how many, never who. */
+export interface MatchQueueCounts {
+    waiting: number;
+    proposals: number;
+    forming: number;
+}
+/** A queue's settings (developers). */
+export interface MatchmakerConfig {
+    players_per_match?: number;
+    /** The rating difference a player accepts at first, and how it widens each second. */
+    window?: number;
+    widen_per_sec?: number;
+    max_window?: number;
+    accept_ms?: number;
+    /** How long a party has for its members to confirm. */
+    party_ms?: number;
+}
+/** Joining a queue: alone, as a party's leader (`party`: the others), or confirming (`leader`). */
+export interface MatchJoin {
+    rating: number;
+    party?: ReadonlyArray<number | string>;
+    leader?: number | string;
+}
+/** Where the matchmaker hubs are: type `matchmaker`, one per queue name, in the starter pack. */
+export interface MatchmakingKitOptions {
+    nodeType?: string;
+}
+/** Matchmaking queues (the `matchmaker` starter): {@link queue} by name. */
+export declare class MatchmakingKit {
+    private readonly runtime;
+    private readonly queues;
+    private readonly nodeType;
+    constructor(runtime: KitRuntime, options?: MatchmakingKitOptions);
+    /** The queue named `name` (`ranked`, `casual`, ...), one per name. */
+    queue(name: string): MatchQueue;
+}
+/**
+ * One queue. Every call's answer updates {@link place}; {@link watch} keeps it current while
+ * the player waits (the queue never names its players on its topic, so a waiting client asks)
+ * and fires {@link onMatched} with the session key once a match is made.
+ */
+export declare class MatchQueue {
+    private readonly runtime;
+    readonly nodeType: string;
+    readonly name: string;
+    /** The `queue` topic: how many are waiting. */
+    readonly counts: HubState<MatchQueueCounts>;
+    private readonly placeStore;
+    private readonly matchedListeners;
+    private lastMatched;
+    private timer;
+    constructor(runtime: KitRuntime, nodeType: string, name: string);
+    /** The player's place, as last answered. */
+    get place(): KitStore<MatchPlace>;
+    private settle;
+    /**
+     * Joins the queue (or updates the rating). With `party`, the caller leads a party of them;
+     * each member then joins with `leader`, and the party queues once all have.
+     * @throws {KitError} `conflict` (a match to accept), `limit` (party size), `forbidden`, `full`.
+     */
+    join(req: MatchJoin): Promise<MatchPlace>;
+    /** Leaves the queue, a forming party, or a proposed match (the party leaves with you). */
+    leave(): Promise<boolean>;
+    /** Accepts the proposed match; the answer is `matched` once everyone has. */
+    accept(): Promise<MatchPlace>;
+    /** Declines the proposed match; the others go back to the queue. */
+    decline(): Promise<boolean>;
+    /** Asks for the player's place. */
+    status(): Promise<MatchPlace>;
+    /** Sets the queue's config. Developers only (a developer kit). */
+    configure(config: MatchmakerConfig): Promise<boolean>;
+    /**
+     * Asks for the player's place every `intervalMs` (default 2 000) while they wait in a party,
+     * the queue or a proposal. Returns the function that stops it.
+     */
+    watch(intervalMs?: number): () => void;
+    unwatch(): void;
+    /** Called with the session key when a match is made for the player. */
+    onMatched(listener: (session: string) => void): () => void;
+}
+//# sourceMappingURL=matchmaking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matchmaking.d.ts","sourceRoot":"","sources":["../../../src/kit/modules/matchmaking.ts"],"names":[],"mappings":"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"}

package/dist/kit/modules/matchmaking.js

@@ -0,0 +1,109 @@
+import { HubState } from '../mirror.js';
+import { WritableKitStore } from '../store.js';
+/** Matchmaking queues (the `matchmaker` starter): {@link queue} by name. */
+export class MatchmakingKit {
+    constructor(runtime, options = {}) {
+        this.runtime = runtime;
+        this.queues = new Map();
+        this.nodeType = options.nodeType ?? 'matchmaker';
+    }
+    /** The queue named `name` (`ranked`, `casual`, ...), one per name. */
+    queue(name) {
+        let q = this.queues.get(name);
+        if (!q) {
+            q = new MatchQueue(this.runtime, this.nodeType, name);
+            this.queues.set(name, q);
+        }
+        return q;
+    }
+}
+const ACTIVE = new Set(['party', 'queued', 'proposed']);
+/**
+ * One queue. Every call's answer updates {@link place}; {@link watch} keeps it current while
+ * the player waits (the queue never names its players on its topic, so a waiting client asks)
+ * and fires {@link onMatched} with the session key once a match is made.
+ */
+export class MatchQueue {
+    constructor(runtime, nodeType, name) {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.name = name;
+        this.placeStore = new WritableKitStore({ state: 'idle' });
+        this.matchedListeners = new Set();
+        this.lastMatched = null;
+        this.timer = null;
+        this.counts = new HubState(runtime, nodeType, name, 'queue');
+    }
+    /** The player's place, as last answered. */
+    get place() {
+        return this.placeStore;
+    }
+    settle(p) {
+        this.placeStore.set(p);
+        if (p.state === 'matched' && p.session !== this.lastMatched) {
+            this.lastMatched = p.session;
+            for (const l of [...this.matchedListeners])
+                l(p.session);
+        }
+        return p;
+    }
+    /**
+     * Joins the queue (or updates the rating). With `party`, the caller leads a party of them;
+     * each member then joins with `leader`, and the party queues once all have.
+     * @throws {KitError} `conflict` (a match to accept), `limit` (party size), `forbidden`, `full`.
+     */
+    async join(req) {
+        const args = { rating: req.rating };
+        if (req.party?.length)
+            args.party = req.party.map(Number);
+        if (req.leader !== undefined)
+            args.leader = Number(req.leader);
+        return this.settle(await this.runtime.call(this.nodeType, this.name, 'join', args, { action: true }));
+    }
+    /** Leaves the queue, a forming party, or a proposed match (the party leaves with you). */
+    async leave() {
+        const left = await this.runtime.call(this.nodeType, this.name, 'leave', null, { action: true });
+        this.settle({ state: 'idle' });
+        return left;
+    }
+    /** Accepts the proposed match; the answer is `matched` once everyone has. */
+    async accept() {
+        return this.settle(await this.runtime.call(this.nodeType, this.name, 'accept', null, { action: true }));
+    }
+    /** Declines the proposed match; the others go back to the queue. */
+    async decline() {
+        const done = await this.runtime.call(this.nodeType, this.name, 'decline', null, { action: true });
+        this.settle({ state: 'idle' });
+        return done;
+    }
+    /** Asks for the player's place. */
+    async status() {
+        return this.settle(await this.runtime.call(this.nodeType, this.name, 'status'));
+    }
+    /** Sets the queue's config. Developers only (a developer kit). */
+    configure(config) {
+        return this.runtime.call(this.nodeType, this.name, 'configure', config, { action: true });
+    }
+    /**
+     * Asks for the player's place every `intervalMs` (default 2 000) while they wait in a party,
+     * the queue or a proposal. Returns the function that stops it.
+     */
+    watch(intervalMs = 2000) {
+        this.unwatch();
+        this.timer = setInterval(() => {
+            if (ACTIVE.has(this.placeStore.get().state))
+                void this.status().catch(() => undefined);
+        }, Math.max(500, intervalMs));
+        return () => this.unwatch();
+    }
+    unwatch() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+    }
+    /** Called with the session key when a match is made for the player. */
+    onMatched(listener) {
+        this.matchedListeners.add(listener);
+        return () => this.matchedListeners.delete(listener);
+    }
+}

package/dist/kit/modules/minigames.d.ts

@@ -0,0 +1,59 @@
+import { HubState } from '../mirror.js';
+import type { KitRuntime } from '../runtime.js';
+export interface DuelSeat {
+    player: number;
+    wins: number;
+    /** Whether this round's throw is in (never which). */
+    thrown: boolean;
+}
+export interface DuelReveal {
+    round: number;
+    /** Each seat's throw, in seat order; null when it was not in on time. */
+    hands: Array<string | null>;
+    winner: number | null;
+}
+/** What the `duel` topic carries: who has thrown, never what, until the reveal. */
+export interface DuelView {
+    phase: 'waiting' | 'playing' | 'finished';
+    seats: DuelSeat[];
+    best_of: number;
+    round: number;
+    /** When this round closes (Unix ms). */
+    deadline: number | null;
+    last: DuelReveal | null;
+    winner: number | null;
+}
+/** Two-player duels of hidden throws (the `minigame` starter): {@link duel} by table. */
+export declare class MinigamesKit {
+    private readonly runtime;
+    private readonly nodeType;
+    private readonly duels;
+    constructor(runtime: KitRuntime, nodeType?: string);
+    duel(key: string): Duel;
+}
+/**
+ * One duel: the hub keeps each round's throws until both are in (or the round's time runs out),
+ * then reveals them; the first to win a majority of `best_of` rounds wins. The starter's game is
+ * rock, paper, scissors.
+ */
+export declare class Duel {
+    private readonly runtime;
+    readonly nodeType: string;
+    readonly key: string;
+    readonly view: HubState<DuelView>;
+    constructor(runtime: KitRuntime, nodeType: string, key: string);
+    watch(): Promise<DuelView>;
+    unwatch(): Promise<void>;
+    /** Takes a seat; resolves with whether this seat started the first round. @throws {KitError} `full`. */
+    join(): Promise<boolean>;
+    /** Before the duel starts. @throws {KitError} `started`. */
+    leave(): Promise<boolean>;
+    /**
+     * The caller's hidden throw this round; resolves with whether it completed the round.
+     * @throws {KitError} `conflict` (already in, or no round open), `bad_request` (not a hand), `not_member`.
+     */
+    throw(hand: string): Promise<boolean>;
+    /** Once it is over: play again. @throws {KitError} `conflict`, `not_member`. */
+    rematch(): Promise<boolean>;
+}
+//# sourceMappingURL=minigames.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"minigames.d.ts","sourceRoot":"","sources":["../../../src/kit/modules/minigames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,mFAAmF;AACnF,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1C,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,yFAAyF;AACzF,qBAAa,YAAY;IAIrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;gBAG9B,OAAO,EAAE,UAAU,EACnB,QAAQ,SAAa;IAGxC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAQxB;AAED;;;;GAIG;AACH,qBAAa,IAAI;IAIb,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM;IALtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAGf,OAAO,EAAE,UAAU,EAC3B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM;IAKtB,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC;IAI1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,wGAAwG;IACxG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxB,4DAA4D;IAC5D,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzB;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,gFAAgF;IAChF,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAG5B"}