@flayerlabs/gamemode-spec 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,124 @@
+/**
+ * The contract between a game and the platform.
+ *
+ * Nothing in this file knows what any game is about. If a concept here can be named after a
+ * particular game — a score curve, a question, a projectile — it is in the wrong file.
+ *
+ * The whole platform rests on one property: a game's rules are a PURE FUNCTION of state and a
+ * command. Everything else — durability, replay, reconnect, anti-cheat forensics, running the
+ * same rules in a browser and on a server — is a consequence of that, not an addition to it.
+ */
+/** A player, opaque to the platform. In practice a lowercased wallet address. */
+export type PlayerId = string;
+/** When a round's window opens and closes. Absolute epoch milliseconds. */
+export interface RoundWindow {
+    opensAt: number;
+    closesAt: number;
+}
+/**
+ * What the platform asks a game to decide on.
+ *
+ * Every command carries `at` — the authoritative time it happened. A game reads time from here
+ * and nowhere else. There is no clock in scope and no ambient randomness: `seed` is supplied so
+ * anything a game wants to randomise is derived, and therefore reproducible.
+ */
+export type Command<Action> = {
+    kind: 'join';
+    player: PlayerId;
+    seed: number;
+    at: number;
+} | {
+    kind: 'leave';
+    player: PlayerId;
+    at: number;
+} | {
+    kind: 'action';
+    player: PlayerId;
+    action: Action;
+    at: number;
+}
+/** The platform woke the round at a time the game asked for via {@link GameModule.nextWakeAt}. */
+ | {
+    kind: 'wake';
+    at: number;
+};
+/** Points awarded to a player. The platform converts these to spending allowance; it does not
+ *  know or care how they were earned. */
+export interface Award {
+    player: PlayerId;
+    points: number;
+}
+/**
+ * What a game decides in response to a command.
+ *
+ * Awards are separate from events on purpose. A game may accept an action now and pay for it
+ * later — a quiz must, or a player learns they answered correctly by watching their own balance
+ * before the reveal, and the reveal stops meaning anything.
+ */
+export interface Decision<Event> {
+    events: readonly Event[];
+    awards?: readonly Award[];
+}
+/**
+ * A refused command. `code` is stable and machine-readable — alerting and months of history key
+ * on it, so it is never renamed, only added to. Player-facing copy lives in the client.
+ *
+ * Never put a threshold in a code. A refusal a cheater can calibrate against is an oracle.
+ */
+export interface Refusal {
+    refuse: string;
+}
+export declare function isRefusal<E>(result: Decision<E> | Refusal): result is Refusal;
+/** The most a single player can earn in one round. The platform checks this against the pool's
+ *  on-chain per-wallet cap before a round is allowed to start. */
+export interface RewardBounds {
+    maxPointsPerPlayer: number;
+}
+/**
+ * A game.
+ *
+ * `decide` and `evolve` must be pure: same inputs, same outputs, forever. No clock, no
+ * randomness, no I/O, no module-level mutable state. This is enforced by lint rather than by
+ * review, because it is the property everything else depends on.
+ */
+export interface GameModule<Config, State, Event, Action, PublicView, PlayerView> {
+    /** Stable identifier, unique across games. */
+    readonly id: string;
+    /** Reject anything that is not a well-formed action, including anything oversized. Returning
+     *  null refuses the command before it reaches {@link decide}. */
+    parseAction(input: unknown): Action | null;
+    /** Build the starting state. Deterministic in `seed`. */
+    initRound(config: Config, seed: number, window: RoundWindow): State;
+    /** The trust boundary. Pure. The only thing that may award points. */
+    decide(state: State, command: Command<Action>): Decision<Event> | Refusal;
+    /** Apply one event. Pure. */
+    evolve(state: State, event: Event): State;
+    /**
+     * What everyone sees, including spectators and anyone reading the socket.
+     *
+     * A value that must stay hidden must not appear in this type. Do not return it and filter
+     * downstream — the type is the enforcement, which is what makes a leak unrenderable rather
+     * than merely unlikely.
+     */
+    publicView(state: State): PublicView;
+    /** What one player sees. Anything private belongs here. */
+    playerView(state: State, player: PlayerId): PlayerView;
+    /**
+     * When the game next needs waking, or null if it is waiting only on players. Absolute epoch
+     * milliseconds.
+     *
+     * Each wake must ask for a time strictly LATER than the one being served. A phase that ends at
+     * the instant it begins has no duration, and asking to be woken at the time it already is would
+     * spin forever. If two things must happen back to back, they are two phases with real durations —
+     * which is usually what the product wanted anyway.
+     */
+    nextWakeAt(state: State): number | null;
+    /** Declared up front so the platform can refuse an incoherent economy before anyone plays. */
+    rewardBounds(config: Config): RewardBounds;
+}
+/**
+ * Authoring entry point. Exists for type inference — writing a `GameModule` literal directly
+ * means naming six type arguments by hand.
+ */
+export declare function defineGame<Config, State, Event, Action, PublicView, PlayerView>(game: GameModule<Config, State, Event, Action, PublicView, PlayerView>): GameModule<Config, State, Event, Action, PublicView, PlayerView>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * The contract between a game and the platform.
+ *
+ * Nothing in this file knows what any game is about. If a concept here can be named after a
+ * particular game — a score curve, a question, a projectile — it is in the wrong file.
+ *
+ * The whole platform rests on one property: a game's rules are a PURE FUNCTION of state and a
+ * command. Everything else — durability, replay, reconnect, anti-cheat forensics, running the
+ * same rules in a browser and on a server — is a consequence of that, not an addition to it.
+ */
+export function isRefusal(result) {
+    return 'refuse' in result;
+}
+/**
+ * Authoring entry point. Exists for type inference — writing a `GameModule` literal directly
+ * means naming six type arguments by hand.
+ */
+export function defineGame(game) {
+    return game;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsDH,MAAM,UAAU,SAAS,CAAI,MAA6B;IACxD,OAAO,QAAQ,IAAI,MAAM,CAAC;AAC5B,CAAC;AA2DD;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,IAAsE;IAEtE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/live.d.ts

@@ -0,0 +1,139 @@
+import type { PlayerId } from './index.js';
+/** Static launch facts that are safe for every game and spectator to render. */
+export interface LaunchContext {
+    readonly roundId: string;
+    readonly poolId: string;
+    readonly coinAddress: string | null;
+    readonly name: string;
+    readonly symbol: string;
+    readonly imageUrl: string | null;
+    readonly opensAt: number;
+    readonly closesAt: number;
+    /** The chart/standings settlement tail may outlive gameplay and claim issuance. */
+    readonly booksCloseAt: number;
+}
+/** Check an untrusted launch response before using it to choose a room or trusted service. */
+export declare function isLaunchContext(input: unknown): input is LaunchContext;
+export type ConnectionState = 'connecting' | 'connected' | 'reconnecting' | 'superseded' | 'ended';
+/**
+ * Who is currently connected. Telemetry, and deliberately nothing more.
+ *
+ * This carries no readiness, because the platform has no opinion about what "ready" means. A game
+ * that gates its lobby on players being ready defines a ready Action of its own: it then travels
+ * the same authenticated, ordered, persisted path as every other action and arrives in `decide()`,
+ * where it can actually change the round.
+ *
+ * Readiness modelled here instead was a rule the rules module could not see. It could not be
+ * replayed, it could not decide anything, and it imposed one lobby policy on every kind of game —
+ * a live quiz, a shooter and a turn-based game do not agree about when to start, and should not
+ * have to.
+ */
+export interface PresenceState {
+    connectedCount: number;
+}
+export interface PlayerIdentity {
+    player: PlayerId;
+    displayName: string | null;
+    avatarUrl: string | null;
+}
+export interface Reaction {
+    player: PlayerId;
+    id: string;
+}
+export interface MarketPrice {
+    at: number;
+    /** Display price of one whole coin in ETH. Market data never participates in scoring. */
+    priceEth: number;
+}
+export interface MarketTrade {
+    /** Stable across reconnects, normally transaction hash plus log index. */
+    id: string;
+    at: number;
+    player: PlayerId | null;
+    side: 'buy' | 'sell';
+    spendWei: bigint;
+    priceEth: number | null;
+    transactionHash?: string;
+}
+export interface MarketState {
+    status: 'unavailable' | 'loading' | 'live' | 'stale';
+    prices: readonly MarketPrice[];
+    trades: readonly MarketTrade[];
+    marketCapUsd: number | null;
+}
+export interface WireMarketTrade extends Omit<MarketTrade, 'spendWei'> {
+    spendWei: string;
+}
+export interface WireMarketState extends Omit<MarketState, 'trades'> {
+    trades: readonly WireMarketTrade[];
+}
+/** Authoritative ledger state. A signed but unsettled authorisation remains held. */
+export interface EconomyBalance {
+    /** Immutable entitlement rate for this round. This is wei, not a live dollar quote. */
+    weiPerPoint: bigint;
+    earnedWei: bigint;
+    heldWei: bigint;
+    spentWei: bigint;
+    availableWei: bigint;
+    /**
+     * When the earliest outstanding hold expires, in epoch ms, or null when nothing is held.
+     *
+     * A player who opens the buy dialog and then declines keeps that allowance held until this
+     * passes, which is correct — the authorisation is still live and could still be spent. But
+     * without the deadline on the balance, a game cannot explain the gap between what a player
+     * earned and what they can spend, so it either tracks the deadline itself or shows a number
+     * that is wrong for five minutes.
+     */
+    holdExpiresAt: number | null;
+}
+/** Stable player-facing reasons a platform buy did not happen. */
+export type BuyFailure = 'nothing-to-spend' | 'declined' | 'not-enough-for-fees' | 'window-closed' | 'try-again';
+/**
+ * JSON-safe form used on the wire.
+ *
+ * The wei fields cross as decimal strings because JSON has no bigint. `holdExpiresAt` is an
+ * ordinary millisecond number and stays one.
+ */
+export type WireEconomyBalance = {
+    [Key in keyof Omit<EconomyBalance, 'holdExpiresAt'>]: string;
+} & {
+    holdExpiresAt: number | null;
+};
+/** Keep cosmetic reaction identifiers bounded and safe to use as asset keys. */
+export declare function isReactionId(id: string): boolean;
+export declare const LIVE_PROTOCOL_VERSION: 1;
+export type LiveServerFrame<PublicView, PlayerView> = {
+    v: typeof LIVE_PROTOCOL_VERSION;
+    type: 'snapshot';
+    sequence: number;
+    now: number;
+    view: PublicView;
+    you: PlayerView | null;
+    economy: WireEconomyBalance;
+    launch: LaunchContext;
+    presence: PresenceState;
+} | {
+    v: typeof LIVE_PROTOCOL_VERSION;
+    type: 'reaction';
+    reaction: Reaction;
+} | {
+    v: typeof LIVE_PROTOCOL_VERSION;
+    type: 'market';
+    market: WireMarketState;
+} | {
+    v: typeof LIVE_PROTOCOL_VERSION;
+    type: 'presence';
+    presence: PresenceState;
+};
+/**
+ * Everything a client may say over the socket.
+ *
+ * Reactions only. Actions go over HTTP so they are ordered and persisted with the round, and
+ * readiness is an ordinary action for whichever games want one.
+ */
+export type LiveClientFrame = {
+    v: typeof LIVE_PROTOCOL_VERSION;
+    type: 'reaction';
+    id: string;
+};
+//# sourceMappingURL=live.d.ts.map

package/dist/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../src/live.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAID,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAsBtE;AAED,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,YAAY,GAAG,OAAO,CAAC;AAEnG;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,QAAQ,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,QAAQ,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACrD,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;IACpE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC;IAClE,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CACpC;AAED,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,uFAAuF;IACvF,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;;;OAQG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,kEAAkE;AAClE,MAAM,MAAM,UAAU,GAClB,kBAAkB,GAClB,UAAU,GACV,qBAAqB,GACrB,eAAe,GACf,WAAW,CAAC;AAEhB;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;KAC9B,GAAG,IAAI,MAAM,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG,MAAM;CAC7D,GAAG;IAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAErC,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,eAAO,MAAM,qBAAqB,EAAG,CAAU,CAAC;AAEhD,MAAM,MAAM,eAAe,CAAC,UAAU,EAAE,UAAU,IAC9C;IACE,CAAC,EAAE,OAAO,qBAAqB,CAAC;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,aAAa,CAAC;CACzB,GACD;IAAE,CAAC,EAAE,OAAO,qBAAqB,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACzE;IAAE,CAAC,EAAE,OAAO,qBAAqB,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GAC5E;IAAE,CAAC,EAAE,OAAO,qBAAqB,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,CAAC,EAAE,OAAO,qBAAqB,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/live.js

@@ -0,0 +1,30 @@
+const ADDRESS = /^0x[0-9a-fA-F]{40}$/;
+/** Check an untrusted launch response before using it to choose a room or trusted service. */
+export function isLaunchContext(input) {
+    if (typeof input !== 'object' || input === null)
+        return false;
+    const value = input;
+    return (typeof value.roundId === 'string' &&
+        value.roundId.length > 0 &&
+        value.roundId.length <= 128 &&
+        typeof value.poolId === 'string' &&
+        value.poolId.length > 0 &&
+        value.poolId.length <= 128 &&
+        (value.coinAddress === null || (typeof value.coinAddress === 'string' && ADDRESS.test(value.coinAddress))) &&
+        typeof value.name === 'string' &&
+        value.name.length <= 256 &&
+        typeof value.symbol === 'string' &&
+        value.symbol.length <= 64 &&
+        (value.imageUrl === null || (typeof value.imageUrl === 'string' && value.imageUrl.length <= 2_048)) &&
+        Number.isSafeInteger(value.opensAt) &&
+        Number.isSafeInteger(value.closesAt) &&
+        Number.isSafeInteger(value.booksCloseAt) &&
+        value.opensAt < value.closesAt &&
+        value.closesAt <= value.booksCloseAt);
+}
+/** Keep cosmetic reaction identifiers bounded and safe to use as asset keys. */
+export function isReactionId(id) {
+    return /^[A-Za-z0-9._:-]{1,64}$/.test(id);
+}
+export const LIVE_PROTOCOL_VERSION = 1;
+//# sourceMappingURL=live.js.map

package/dist/live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.js","sourceRoot":"","sources":["../src/live.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,GAAG,qBAAqB,CAAC;AAEtC,8FAA8F;AAC9F,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,KAAK,GAAG,KAAgC,CAAC;IAC/C,OAAO,CACL,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACxB,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG;QAC3B,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACvB,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG;QAC1B,CAAC,KAAK,CAAC,WAAW,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QAC1G,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,GAAG;QACxB,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE;QACzB,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;QACnG,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;QACpC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC;QACvC,KAAK,CAAC,OAAkB,GAAI,KAAK,CAAC,QAAmB;QACrD,KAAK,CAAC,QAAmB,IAAK,KAAK,CAAC,YAAuB,CAC7D,CAAC;AACJ,CAAC;AAsGD,gFAAgF;AAChF,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAU,CAAC"}

package/dist/round.d.ts

@@ -0,0 +1,58 @@
+import type { Award, Command, Decision, GameModule, PlayerId, Refusal, RoundWindow } from './index.js';
+/**
+ * Drives a game module through commands. Pure, in-memory, no I/O.
+ *
+ * This is the only implementation of "how to run a round". The server persists around it and the
+ * browser mock runs it directly, so a game cannot behave one way offline and another way live —
+ * there is no second copy to drift. The reference games this platform replaces had exactly that
+ * bug: two copies of the same scoring rules, disagreeing about a constant, with the mechanism
+ * meant to pin them not covering the part that moved.
+ *
+ * Ordering is the platform's job, not the game's: commands are applied one at a time, in the
+ * order they arrive here.
+ */
+export declare class Round<Config, State, Event, Action, PublicView, PlayerView> {
+    private readonly game;
+    private state;
+    readonly window: RoundWindow;
+    private readonly onAward?;
+    private readonly points;
+    /**
+     * @param onAward Called for every award as it happens, including ones produced by a wake that
+     * `send` ran on the way to a command. A durable caller needs this: it has to write the state and
+     * the money in one transaction, and it cannot see inside a wake any other way.
+     */
+    private constructor();
+    /** Begin a new round. */
+    static start<Config, State, Event, Action, PublicView, PlayerView>(game: GameModule<Config, State, Event, Action, PublicView, PlayerView>, config: Config, seed: number, window: RoundWindow, onAward?: (award: Award) => void): Round<Config, State, Event, Action, PublicView, PlayerView>;
+    /**
+     * Pick a round back up from a stored state.
+     *
+     * Nothing is replayed and nothing recomputed: the state is the game's own and the platform never
+     * inspects it, so resuming is a straight substitution. That is what makes a restart cheap.
+     */
+    static resume<Config, State, Event, Action, PublicView, PlayerView>(game: GameModule<Config, State, Event, Action, PublicView, PlayerView>, state: State, window: RoundWindow, onAward?: (award: Award) => void): Round<Config, State, Event, Action, PublicView, PlayerView>;
+    /**
+     * Apply one command. Fires any wakes that fall due at or before it first, so a game never sees
+     * an action from after a deadline it asked to be woken for.
+     */
+    send(command: Command<Action>): Decision<Event> | Refusal;
+    /**
+     * Fire every wake due at or before `time`, and report how many fired.
+     *
+     * The count is what a durable caller needs: zero means nothing changed and there is nothing to
+     * write. Never send a wake through {@link send} to achieve this — `send` runs due wakes on the
+     * way to the command, so a synthetic wake command fires the same deadline twice and collapses
+     * whatever phase sat between them.
+     */
+    advanceTo(time: number): number;
+    private runWakesUpTo;
+    private apply;
+    private credit;
+    pointsFor(player: PlayerId): number;
+    publicView(): PublicView;
+    playerView(player: PlayerId): PlayerView;
+    /** For replay assertions. Structural equality of this is what determinism means. */
+    snapshot(): State;
+}
+//# sourceMappingURL=round.d.ts.map

package/dist/round.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round.d.ts","sourceRoot":"","sources":["../src/round.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGvG;;;;;;;;;;;GAWG;AACH,qBAAa,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU;IASnE,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,KAAK;IACb,QAAQ,CAAC,MAAM,EAAE,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAX3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IAEtD;;;;OAIG;IACH,OAAO;IAOP,yBAAyB;IACzB,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAC/D,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,EACtE,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC/B,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC;IAI9D;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAChE,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,EACtE,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC/B,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC;IAI9D;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO;IAKzD;;;;;;;OAOG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI/B,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,KAAK;IAab,OAAO,CAAC,MAAM;IAQd,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM;IAInC,UAAU,IAAI,UAAU;IAIxB,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU;IAIxC,oFAAoF;IACpF,QAAQ,IAAI,KAAK;CAGlB"}

package/dist/round.js

@@ -0,0 +1,123 @@
+import { isRefusal } from './index.js';
+/**
+ * Drives a game module through commands. Pure, in-memory, no I/O.
+ *
+ * This is the only implementation of "how to run a round". The server persists around it and the
+ * browser mock runs it directly, so a game cannot behave one way offline and another way live —
+ * there is no second copy to drift. The reference games this platform replaces had exactly that
+ * bug: two copies of the same scoring rules, disagreeing about a constant, with the mechanism
+ * meant to pin them not covering the part that moved.
+ *
+ * Ordering is the platform's job, not the game's: commands are applied one at a time, in the
+ * order they arrive here.
+ */
+export class Round {
+    game;
+    state;
+    window;
+    onAward;
+    points = new Map();
+    /**
+     * @param onAward Called for every award as it happens, including ones produced by a wake that
+     * `send` ran on the way to a command. A durable caller needs this: it has to write the state and
+     * the money in one transaction, and it cannot see inside a wake any other way.
+     */
+    constructor(game, state, window, onAward) {
+        this.game = game;
+        this.state = state;
+        this.window = window;
+        this.onAward = onAward;
+    }
+    /** Begin a new round. */
+    static start(game, config, seed, window, onAward) {
+        return new Round(game, game.initRound(config, seed, window), window, onAward);
+    }
+    /**
+     * Pick a round back up from a stored state.
+     *
+     * Nothing is replayed and nothing recomputed: the state is the game's own and the platform never
+     * inspects it, so resuming is a straight substitution. That is what makes a restart cheap.
+     */
+    static resume(game, state, window, onAward) {
+        return new Round(game, state, window, onAward);
+    }
+    /**
+     * Apply one command. Fires any wakes that fall due at or before it first, so a game never sees
+     * an action from after a deadline it asked to be woken for.
+     */
+    send(command) {
+        this.runWakesUpTo(command.at);
+        return this.apply(command);
+    }
+    /**
+     * Fire every wake due at or before `time`, and report how many fired.
+     *
+     * The count is what a durable caller needs: zero means nothing changed and there is nothing to
+     * write. Never send a wake through {@link send} to achieve this — `send` runs due wakes on the
+     * way to the command, so a synthetic wake command fires the same deadline twice and collapses
+     * whatever phase sat between them.
+     */
+    advanceTo(time) {
+        return this.runWakesUpTo(time);
+    }
+    runWakesUpTo(time) {
+        // A wake may schedule the next one. Bounded by each wake having to move strictly forward.
+        let previous = -Infinity;
+        let fired = 0;
+        for (;;) {
+            const at = this.game.nextWakeAt(this.state);
+            if (at === null)
+                return fired;
+            if (!Number.isFinite(at)) {
+                throw new Error(`${this.game.id}: nextWakeAt returned a non-finite time`);
+            }
+            if (!Number.isSafeInteger(at)) {
+                throw new Error(`${this.game.id}: nextWakeAt returned a non-safe-integer time`);
+            }
+            if (at > this.window.closesAt) {
+                throw new Error(`${this.game.id}: nextWakeAt ${at} is after the round closes at ${this.window.closesAt}`);
+            }
+            if (at > time)
+                return fired;
+            if (at <= previous) {
+                throw new Error(`${this.game.id}: nextWakeAt did not advance past ${at}`);
+            }
+            previous = at;
+            this.apply({ kind: 'wake', at });
+            fired += 1;
+        }
+    }
+    apply(command) {
+        const result = this.game.decide(this.state, command);
+        if (isRefusal(result))
+            return result;
+        for (const event of result.events) {
+            this.state = this.game.evolve(this.state, event);
+        }
+        for (const award of result.awards ?? []) {
+            this.credit(award);
+        }
+        return result;
+    }
+    credit(award) {
+        if (!Number.isFinite(award.points) || award.points < 0) {
+            throw new Error(`${this.game.id}: award of ${award.points} points to ${award.player}`);
+        }
+        this.points.set(award.player, (this.points.get(award.player) ?? 0) + award.points);
+        this.onAward?.(award);
+    }
+    pointsFor(player) {
+        return this.points.get(player) ?? 0;
+    }
+    publicView() {
+        return this.game.publicView(this.state);
+    }
+    playerView(player) {
+        return this.game.playerView(this.state, player);
+    }
+    /** For replay assertions. Structural equality of this is what determinism means. */
+    snapshot() {
+        return this.state;
+    }
+}
+//# sourceMappingURL=round.js.map

package/dist/round.js.map

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

package/dist/schedule.d.ts

@@ -0,0 +1,18 @@
+import type { RoundWindow } from './index.js';
+export interface ScheduleStep<Value> {
+    value: Value;
+    durationMs: number;
+}
+export interface ScheduledStep<Value> {
+    value: Value;
+    startsAt: number;
+    endsAt: number;
+}
+export declare class ScheduleWindowError extends RangeError {
+    readonly requiredMs: number;
+    readonly availableMs: number;
+    constructor(requiredMs: number, availableMs: number);
+}
+/** Turn relative authored durations into the absolute timestamps a round can replay forever. */
+export declare function scheduleWithin<Value>(window: RoundWindow, steps: readonly ScheduleStep<Value>[]): ScheduledStep<Value>[];
+//# sourceMappingURL=schedule.d.ts.map

package/dist/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../src/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,YAAY,CAAC,KAAK;IACjC,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa,CAAC,KAAK;IAClC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,mBAAoB,SAAQ,UAAU;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM;gBAAhD,UAAU,EAAE,MAAM,EAAW,WAAW,EAAE,MAAM;CAItE;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,KAAK,EAClC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,SAAS,YAAY,CAAC,KAAK,CAAC,EAAE,GACpC,aAAa,CAAC,KAAK,CAAC,EAAE,CAiCxB"}

package/dist/schedule.js

@@ -0,0 +1,44 @@
+export class ScheduleWindowError extends RangeError {
+    requiredMs;
+    availableMs;
+    constructor(requiredMs, availableMs) {
+        super(`schedule needs ${requiredMs}ms but the round window has ${availableMs}ms`);
+        this.requiredMs = requiredMs;
+        this.availableMs = availableMs;
+        this.name = 'ScheduleWindowError';
+    }
+}
+/** Turn relative authored durations into the absolute timestamps a round can replay forever. */
+export function scheduleWithin(window, steps) {
+    if (!Number.isSafeInteger(window.opensAt) ||
+        !Number.isSafeInteger(window.closesAt) ||
+        window.closesAt <= window.opensAt) {
+        throw new RangeError('schedule needs safe-integer timestamps whose close is after its open');
+    }
+    const availableMs = window.closesAt - window.opensAt;
+    if (!Number.isSafeInteger(availableMs)) {
+        throw new RangeError('schedule round-window duration is outside the safe-integer range');
+    }
+    let cursor = window.opensAt;
+    const scheduled = steps.map((step, index) => {
+        if (!Number.isSafeInteger(step.durationMs) || step.durationMs <= 0) {
+            throw new RangeError(`schedule phase ${index} must have a positive safe-integer duration`);
+        }
+        const endsAt = cursor + step.durationMs;
+        if (!Number.isSafeInteger(endsAt)) {
+            throw new RangeError(`schedule phase ${index} ends outside the safe-integer timestamp range`);
+        }
+        const scheduledStep = { value: step.value, startsAt: cursor, endsAt };
+        cursor = scheduledStep.endsAt;
+        return scheduledStep;
+    });
+    if (cursor > window.closesAt) {
+        const requiredMs = cursor - window.opensAt;
+        if (!Number.isSafeInteger(requiredMs)) {
+            throw new RangeError('schedule duration is outside the safe-integer range');
+        }
+        throw new ScheduleWindowError(requiredMs, availableMs);
+    }
+    return scheduled;
+}
+//# sourceMappingURL=schedule.js.map

package/dist/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../src/schedule.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IAC5B;IAA6B;IAAlD,YAAqB,UAAkB,EAAW,WAAmB;QACnE,KAAK,CAAC,kBAAkB,UAAU,+BAA+B,WAAW,IAAI,CAAC,CAAC;QAD/D,eAAU,GAAV,UAAU,CAAQ;QAAW,gBAAW,GAAX,WAAW,CAAQ;QAEnE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,gGAAgG;AAChG,MAAM,UAAU,cAAc,CAC5B,MAAmB,EACnB,KAAqC;IAErC,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC;QACrC,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC;QACtC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,EACjC,CAAC;QACD,MAAM,IAAI,UAAU,CAAC,sEAAsE,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,UAAU,CAAC,kEAAkE,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;IAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC1C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;YACnE,MAAM,IAAI,UAAU,CAAC,kBAAkB,KAAK,6CAA6C,CAAC,CAAC;QAC7F,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,UAAU,CAAC,kBAAkB,KAAK,gDAAgD,CAAC,CAAC;QAChG,CAAC;QACD,MAAM,aAAa,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACtE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;QAC9B,OAAO,aAAa,CAAC;IACvB,CAAC,CAAC,CAAC;IACH,IAAI,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,UAAU,CAAC,qDAAqD,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,IAAI,mBAAmB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}