@typeonce/ritmo-devtools 0.6.0 → 0.8.0

package/dist/Replay.js

@@ -0,0 +1,335 @@
+import * as Result from "@typeonce/ritmo/Result";
+import * as Format from "./Format.js";
+import { libraryVersion } from "./internal/version.js";
+import * as Rendered from "./Rendered.js";
+import * as Session from "./Session.js";
+/** The `@typeonce/ritmo-devtools` version written into replay files. */
+export const version = libraryVersion;
+/** A sink that keeps replays in memory (for tests, or for a host that delivers them itself). */
+export const memorySink = () => {
+    const files = [];
+    return { files, save: (file) => { files.push(file); } };
+};
+/** FNV-1a over a string, as 8 hex digits: a cheap fingerprint for checkpoints and schemas. */
+const fingerprint = (text) => {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < text.length; index++) {
+        hash ^= text.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193) >>> 0;
+    }
+    return hash.toString(16).padStart(8, "0");
+};
+/** The schema's fingerprint: what must match for a replay to load. */
+export const schemaHash = (debug) => {
+    const description = debug.describe();
+    return fingerprint(JSON.stringify({
+        components: description.components.map(({ name, storage }) => ({ name, storage })),
+        resources: description.resources.map(({ name, storage }) => ({ name, storage })),
+        events: description.events,
+        relations: description.relations,
+        machines: description.machines.map(({ name, states }) => ({ name, states }))
+    }));
+};
+const worldHash = (snapshot) => fingerprint(JSON.stringify(snapshot));
+const isRecord = (value) => typeof value === "object" && value !== null;
+const isSource = (value) => isRecord(value) && typeof value["snapshot"] === "function";
+/** The names of the services a schedule needs. */
+const serviceNames = (schedule) => schedule.requirements.flatMap((requirement) => isRecord(requirement) && requirement["kind"] === "service" && typeof requirement["name"] === "string" ? [requirement["name"]] : []);
+/**
+ * Starts recording a runtime made with `debug: { hostClock }`. The schedule's source
+ * services have their `snapshot` wrapped to record what the systems got; the
+ * services must not be frozen.
+ */
+export const recorder = (runtime, options) => {
+    const keepTicks = Math.max(1, Math.ceil(options.keep / options.step.dt));
+    const everyTicks = Math.max(1, Math.round((options.every ?? 5) / options.step.dt));
+    const constants = {};
+    const restores = [];
+    let current;
+    for (const name of serviceNames(options.schedule)) {
+        const service = runtime.services[name];
+        if (!isSource(service)) {
+            constants[name] = service;
+            continue;
+        }
+        const own = service.snapshot;
+        Reflect.set(service, "snapshot", () => {
+            const value = own.call(service);
+            if (current !== undefined) {
+                const calls = current.get(name);
+                if (calls === undefined)
+                    current.set(name, [value]);
+                else
+                    calls.push(value);
+            }
+            return value;
+        });
+        restores.push(() => Reflect.set(service, "snapshot", own));
+    }
+    let tick = 0;
+    let sent = [];
+    let ticks = [];
+    /** Snapshot points still needed: the newest one at or before the window start, and every later one. */
+    let points = [];
+    let checkpoints = [];
+    const previous = new Map();
+    const broken = new Set();
+    const takePoint = () => {
+        const snapshot = runtime.snapshot();
+        points.push({ tick, snapshot, pendingCommands: runtime.debug.dump({ limit: 0 }).pendingCommands.length });
+        checkpoints.push({ tick, hash: worldHash(snapshot) });
+        const windowStart = tick - keepTicks;
+        let firstNeeded = -1;
+        for (let index = 0; index < points.length; index++)
+            if (points[index].tick <= windowStart)
+                firstNeeded = index;
+        if (firstNeeded > 0) {
+            points = points.slice(firstNeeded);
+            ticks = ticks.filter((record) => record.tick > points[0].tick);
+            checkpoints = checkpoints.filter((checkpoint) => checkpoint.tick >= points[0].tick);
+        }
+    };
+    takePoint();
+    const save = (reason) => {
+        const start = points[0];
+        const file = {
+            format: "ritmo-replay",
+            version: 1,
+            library: libraryVersion,
+            schema: schemaHash(runtime.debug),
+            schedule: options.name,
+            reason,
+            savedAt: options.hostClock.now(),
+            constants,
+            start,
+            ticks: ticks.filter((record) => record.tick > start.tick),
+            checkpoints: checkpoints.filter((checkpoint) => checkpoint.tick >= start.tick)
+        };
+        options.sink.save(file);
+        return file;
+    };
+    const check = runtime.inspect;
+    const stopObserving = runtime.debug.observeHost((event) => {
+        if (event.type === "send") {
+            sent.push({ event: event.event, value: event.value });
+            return;
+        }
+        if (event.type === "failure.ignored") {
+            // An unread failure is a failure nobody saw: save it like one.
+            if (options.saveOn?.failure === true)
+                save(Format.ignoredFailure(event));
+            return;
+        }
+        if (!event.schedules.includes(options.schedule))
+            return;
+        if (event.type === "tick.start") {
+            tick += 1;
+            current = new Map();
+            return;
+        }
+        const calls = current ?? new Map();
+        current = undefined;
+        const changed = {};
+        for (const [name, values] of calls) {
+            const text = JSON.stringify(values);
+            if (previous.get(name) !== text)
+                changed[name] = values;
+            previous.set(name, text);
+        }
+        ticks.push({
+            tick,
+            ...(Object.keys(changed).length > 0 ? { services: changed } : {}),
+            ...(sent.length > 0 ? { sent } : {})
+        });
+        sent = [];
+        if (tick % everyTicks === 0)
+            takePoint();
+        if (event.outcome !== "ok" && options.saveOn?.failure === true) {
+            save(`tick ${tick} ${event.outcome === "defect" ? "threw" : "failed"}: ${describeError(event.error)}`);
+        }
+        for (const invariant of options.saveOn?.invariants ?? []) {
+            const message = check(invariant.inspector);
+            if (message === undefined) {
+                broken.delete(invariant.name);
+            }
+            else if (!broken.has(invariant.name)) {
+                broken.add(invariant.name);
+                save(`invariant ${invariant.name} broke at tick ${tick}: ${message}`);
+            }
+        }
+    });
+    return {
+        save,
+        ticks: () => tick,
+        stop: () => {
+            stopObserving();
+            for (const restore of restores)
+                restore();
+        }
+    };
+};
+const describeError = (error) => {
+    if (error instanceof Error)
+        return error.message;
+    if (isRecord(error) && typeof error["system"] === "string")
+        return `${error["system"]} returned ${JSON.stringify(error["error"])}`;
+    return JSON.stringify(error) ?? String(error);
+};
+/** Checks the shape of untrusted replay data (`JSON.parse` output). */
+export const parse = (data) => {
+    const invalid = (message) => Result.failure({ _tag: "InvalidReplay", message });
+    if (!isRecord(data) || data["format"] !== "ritmo-replay")
+        return invalid("not a ritmo replay (format)");
+    if (data["version"] !== 1)
+        return invalid(`unsupported replay version ${JSON.stringify(data["version"])}`);
+    for (const key of ["library", "schema", "schedule", "reason"]) {
+        if (typeof data[key] !== "string")
+            return invalid(`${key} must be a string`);
+    }
+    const start = data["start"];
+    if (!isRecord(start) || typeof start["tick"] !== "number" || !isRecord(start["snapshot"]))
+        return invalid("start must hold a tick and a snapshot");
+    if (!Array.isArray(data["ticks"]) || !data["ticks"].every((record) => isRecord(record) && typeof record["tick"] === "number"))
+        return invalid("ticks must be tick records");
+    if (!Array.isArray(data["checkpoints"]))
+        return invalid("checkpoints must be a list");
+    if (!isRecord(data["constants"]))
+        return invalid("constants must be an object");
+    // The snapshot itself is validated by `restore`, and service values by the systems that read them.
+    return Result.success(data);
+};
+/**
+ * Opens a replay: builds the game with `make(playback)`, checks the schema,
+ * restores the start, and returns a session ready to `play`.
+ */
+export const session = (make, file) => {
+    /** The last tick replayed (the start's tick before any). */
+    let ran = file.start.tick;
+    let calls = new Map();
+    const latest = new Map();
+    const byTick = new Map(file.ticks.map((record) => [record.tick, record]));
+    const playback = {
+        source: (descriptor) => ({
+            snapshot: () => {
+                const values = latest.get(descriptor.name) ?? [];
+                const index = calls.get(descriptor.name) ?? 0;
+                calls.set(descriptor.name, index + 1);
+                // Each call this tick returns what the recorded call returned (the last one again past the end).
+                return values[Math.min(index, values.length - 1)];
+            }
+        }),
+        constant: (descriptor) => file.constants[descriptor.name]
+    };
+    const target = make(playback);
+    const schedule = target.schedules[file.schedule];
+    if (schedule === undefined)
+        return Result.failure({ _tag: "MissingSchedule", schedule: file.schedule });
+    const current = schemaHash(target.runtime.debug);
+    if (current !== file.schema) {
+        return Result.failure({ _tag: "SchemaMismatch", message: "replay recorded with an older schema", recorded: file.schema, current });
+    }
+    const restored = target.runtime.restore(file.start.snapshot);
+    if (!restored.ok)
+        return Result.failure({ _tag: "RestoreFailed", error: restored.error });
+    const replay = Session.make(target.runtime, { schedules: { [file.schedule]: schedule }, hostClock: target.hostClock });
+    const send = target.runtime.send;
+    const events = new Map(target.runtime.debug.describe().events.map(({ name }) => [name, { kind: "event", name, key: Symbol.for(`ritmo/event/${name}`) }]));
+    const hashes = new Map([[ran, worldHash(target.runtime.snapshot())]]);
+    const recorded = new Map(file.checkpoints.map(({ tick, hash }) => [tick, hash]));
+    const last = file.ticks.at(-1)?.tick ?? file.start.tick;
+    const play = (options = {}) => {
+        const to = Math.min(options.to ?? last, last);
+        const frames = Math.max(0, to - ran);
+        const diverged = [];
+        const run = replay.run(file.schedule, {
+            frames,
+            // `until` runs after each frame: the tick is checked, and the next one's input set up before it runs.
+            until: () => {
+                ran += 1;
+                const hash = worldHash(target.runtime.snapshot());
+                hashes.set(ran, hash);
+                const expected = recorded.get(ran);
+                if (expected !== undefined && expected !== hash)
+                    diverged.push({ tick: ran, recorded: expected, replayed: hash });
+                prepare(ran + 1);
+                return false;
+            }
+        });
+        return Rendered.make({ run: run.data, diverged }, diverged.length === 0
+            ? `${run.text}\ncheckpoints match`
+            : `${run.text}\nDIVERGED at ${diverged.map((entry) => `tick ${entry.tick}`).join(", ")}: the simulation is not deterministic, or the code changed since recording`);
+    };
+    /** Sets up tick `next`: its sends, and its sources' values. */
+    const prepare = (next) => {
+        const record = byTick.get(next);
+        for (const [name, values] of Object.entries(record?.services ?? {}))
+            latest.set(name, values);
+        calls = new Map();
+        for (const { event, value } of record?.sent ?? []) {
+            const descriptor = events.get(event);
+            if (descriptor !== undefined)
+                send(descriptor, value);
+        }
+    };
+    prepare(ran + 1);
+    return Result.success({
+        session: replay,
+        file,
+        play,
+        hashes: () => hashes,
+        snapshot: () => target.runtime.snapshot()
+    });
+};
+/**
+ * Replays twice and compares the world after every tick: different hashes
+ * mean the simulation reads something the replay does not hold (wall time,
+ * `Math.random`, host state).
+ */
+export const verify = (make, file) => {
+    const first = session(make, file);
+    if (!first.ok)
+        return first;
+    const second = session(make, file);
+    if (!second.ok)
+        return second;
+    const played = first.value.play();
+    second.value.play();
+    const ticks = [...first.value.hashes().keys()].sort((left, right) => left - right);
+    const firstDifference = ticks.find((tick) => first.value.hashes().get(tick) !== second.value.hashes().get(tick));
+    const deterministic = firstDifference === undefined;
+    return Result.success(Rendered.make({ deterministic, firstDifference, diverged: played.data.diverged }, deterministic
+        ? `deterministic over ${ticks.length - 1} ticks${played.data.diverged.length === 0 ? ", and matches the recording" : `, but differs from the recording at tick ${played.data.diverged[0].tick}`}`
+        : `NOT deterministic: two replays differ from tick ${firstDifference}`));
+};
+/**
+ * Cuts ticks `from`..`to` (recorder tick numbers) into a smaller replay that
+ * starts at the end of tick `from - 1`: few enough ticks to keep next to a
+ * test and play with `session`.
+ */
+export const extract = (make, file, range) => {
+    const opened = session(make, file);
+    if (!opened.ok)
+        return opened;
+    opened.value.play({ to: range.from - 1 });
+    const start = opened.value.snapshot();
+    // Each kept tick carries its sources' values in full, so the extract does not depend on earlier ticks.
+    const latest = new Map();
+    const ticks = [];
+    for (const record of file.ticks) {
+        for (const [name, values] of Object.entries(record.services ?? {}))
+            latest.set(name, values);
+        if (record.tick < range.from || record.tick > range.to)
+            continue;
+        ticks.push({ tick: record.tick, services: Object.fromEntries(latest), ...(record.sent === undefined ? {} : { sent: record.sent }) });
+    }
+    opened.value.play({ to: range.to });
+    const checkpoints = [...opened.value.hashes()].filter(([tick]) => tick >= range.from - 1 && tick <= range.to).map(([tick, hash]) => ({ tick, hash }));
+    return Result.success({
+        ...file,
+        reason: `${file.reason} (ticks ${range.from}-${range.to})`,
+        start: { tick: range.from - 1, snapshot: start, pendingCommands: 0 },
+        ticks,
+        checkpoints
+    });
+};
+//# sourceMappingURL=Replay.js.map

package/dist/Replay.js.map

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

package/dist/ReplayNodeSink.d.ts

@@ -0,0 +1,11 @@
+import type * as Replay from "./Replay.ts";
+/** Where the last replay was written, and every path written so far. */
+export interface NodeSink extends Replay.Sink {
+    readonly written: ReadonlyArray<string>;
+}
+/** The file name of a replay: its save time, then its tick count. */
+export declare const fileName: (file: Replay.ReplayFile) => string;
+export declare const make: (options: {
+    readonly directory: string;
+}) => NodeSink;
+//# sourceMappingURL=ReplayNodeSink.d.ts.map

package/dist/ReplayNodeSink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplayNodeSink.d.ts","sourceRoot":"","sources":["../src/ReplayNodeSink.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAE1C,wEAAwE;AACxE,MAAM,WAAW,QAAS,SAAQ,MAAM,CAAC,IAAI;IAC3C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACxC;AAED,qEAAqE;AACrE,eAAO,MAAM,QAAQ,SAAU,MAAM,CAAC,UAAU,KAAG,MACqE,CAAA;AAExH,eAAO,MAAM,IAAI,YAAa;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAAG,QAW9D,CAAA"}

package/dist/ReplayNodeSink.js

@@ -0,0 +1,29 @@
+/**
+ * A `Replay.Sink` for Node: each saved replay becomes a JSON file in a
+ * directory. For headless runs (bots, scripts) that record replays.
+ *
+ * @module ReplayNodeSink
+ * @docGroup devtools
+ *
+ * @example
+ * ```ts
+ * const recorder = Replay.recorder(runtime, { ..., sink: ReplayNodeSink.make({ directory: ".replays" }) })
+ * ```
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+/** The file name of a replay: its save time, then its tick count. */
+export const fileName = (file) => `${new Date(file.savedAt).toISOString().replaceAll(":", "-")}-tick-${file.ticks.at(-1)?.tick ?? file.start.tick}.json`;
+export const make = (options) => {
+    const written = [];
+    return {
+        written,
+        save: (file) => {
+            mkdirSync(options.directory, { recursive: true });
+            const path = join(options.directory, fileName(file));
+            writeFileSync(path, `${JSON.stringify(file)}\n`);
+            written.push(path);
+        }
+    };
+};
+//# sourceMappingURL=ReplayNodeSink.js.map

package/dist/ReplayNodeSink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplayNodeSink.js","sourceRoot":"","sources":["../src/ReplayNodeSink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAShC,qEAAqE;AACrE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAuB,EAAU,EAAE,CAC1D,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,OAAO,CAAA;AAExH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,OAAuC,EAAY,EAAE;IACxE,MAAM,OAAO,GAAkB,EAAE,CAAA;IACjC,OAAO;QACL,OAAO;QACP,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;YACb,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YACjD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;YACpD,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAChD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpB,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/ReplayVitePlugin.d.ts

@@ -0,0 +1,41 @@
+/**
+ * A Vite plugin (Node side) that receives the replays `ReplayViteSink`
+ * posts from the page and writes them into the game's repository as
+ * `.replays/<time>.json`, logging the path, the tick count, and the reason.
+ * Development only: it does nothing in a build.
+ *
+ * Add `.replays/` to the game's `.gitignore`.
+ *
+ * @module ReplayVitePlugin
+ * @docGroup devtools
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import * as ReplayVitePlugin from "@typeonce/ritmo-devtools/ReplayVitePlugin"
+ * export default defineConfig({ plugins: [ReplayVitePlugin.plugin()] })
+ * ```
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+/** The part of Vite's dev server the plugin uses. */
+export interface DevServer {
+    readonly middlewares: {
+        readonly use: (path: string, handler: (request: IncomingMessage, response: ServerResponse, next: () => void) => void) => void;
+    };
+    readonly config: {
+        readonly root: string;
+        readonly logger: {
+            readonly info: (message: string) => void;
+        };
+    };
+}
+/** A Vite plugin object. */
+export interface Plugin {
+    readonly name: string;
+    readonly apply: "serve";
+    readonly configureServer: (server: DevServer) => void;
+}
+export declare const plugin: (options?: {
+    readonly directory?: string;
+}) => Plugin;
+//# sourceMappingURL=ReplayVitePlugin.d.ts.map

package/dist/ReplayVitePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplayVitePlugin.d.ts","sourceRoot":"","sources":["../src/ReplayVitePlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAMhE,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,KAAK,IAAI,CAAA;KAC9H,CAAA;IACD,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;SAAE,CAAA;KAAE,CAAA;CAC1G;AAED,4BAA4B;AAC5B,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAA;CACtD;AAED,eAAO,MAAM,MAAM,aAAa;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,KAAQ,MAkCrE,CAAA"}

package/dist/ReplayVitePlugin.js

@@ -0,0 +1,41 @@
+import * as Replay from "./Replay.js";
+import * as ReplayNodeSink from "./ReplayNodeSink.js";
+import { endpoint } from "./ReplayViteSink.js";
+export const plugin = (options = {}) => ({
+    name: "ritmo-replays",
+    apply: "serve",
+    configureServer: (server) => {
+        const sink = ReplayNodeSink.make({ directory: `${server.config.root}/${options.directory ?? ".replays"}` });
+        server.middlewares.use(endpoint, (request, response, next) => {
+            if (request.method !== "POST")
+                return next();
+            let body = "";
+            request.setEncoding("utf8");
+            request.on("data", (chunk) => {
+                body += chunk;
+            });
+            request.on("end", () => {
+                let data;
+                try {
+                    data = JSON.parse(body);
+                }
+                catch {
+                    data = undefined;
+                }
+                const parsed = Replay.parse(data);
+                if (!parsed.ok) {
+                    response.statusCode = 400;
+                    response.end(parsed.error._tag === "InvalidReplay" ? parsed.error.message : parsed.error._tag);
+                    return;
+                }
+                sink.save(parsed.value);
+                const path = sink.written.at(-1).slice(server.config.root.length + 1);
+                const ticks = parsed.value.ticks.length;
+                server.config.logger.info(`[ritmo] replay saved: ${path} (${ticks} ticks): ${parsed.value.reason}`);
+                response.statusCode = 201;
+                response.end(path);
+            });
+        });
+    }
+});
+//# sourceMappingURL=ReplayVitePlugin.js.map

package/dist/ReplayVitePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplayVitePlugin.js","sourceRoot":"","sources":["../src/ReplayVitePlugin.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAiB9C,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,GAAoC,EAAE,EAAU,EAAE,CAAC,CAAC;IAChF,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,OAAO;IACd,eAAe,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,SAAS,IAAI,UAAU,EAAE,EAAE,CAAC,CAAA;QAC3G,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;YAC3D,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;gBAAE,OAAO,IAAI,EAAE,CAAA;YAC5C,IAAI,IAAI,GAAG,EAAE,CAAA;YACb,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;YAC3B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACnC,IAAI,IAAI,KAAK,CAAA;YACf,CAAC,CAAC,CAAA;YACF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACrB,IAAI,IAAa,CAAA;gBACjB,IAAI,CAAC;oBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;gBACzB,CAAC;gBAAC,MAAM,CAAC;oBACP,IAAI,GAAG,SAAS,CAAA;gBAClB,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;gBACjC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;oBACf,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAA;oBACzB,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;oBAC9F,OAAM;gBACR,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACvB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;gBACtE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAA;gBACvC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,IAAI,KAAK,KAAK,YAAY,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;gBACnG,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAA;gBACzB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACpB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;CACF,CAAC,CAAA"}

package/dist/ReplayViteSink.d.ts

@@ -0,0 +1,30 @@
+/**
+ * A `Replay.Sink` for a page served by Vite in development: each saved
+ * replay is posted to the dev server, where `ReplayVitePlugin` writes it
+ * into the game's repository (`.replays/`). The page's `fetch` is passed in.
+ *
+ * @module ReplayViteSink
+ * @docGroup devtools
+ *
+ * @example
+ * ```ts
+ * if (import.meta.env.DEV) {
+ *   const sink = ReplayViteSink.make({ fetch: (url, init) => fetch(url, init) })
+ * }
+ * ```
+ */
+import type * as Replay from "./Replay.ts";
+/** The dev server's endpoint for replays (what `ReplayVitePlugin` serves). */
+export declare const endpoint = "/__ritmo/replays";
+export interface Options {
+    /** The page's `fetch` (or any function with its shape for these two arguments). */
+    readonly fetch: (url: string, init: {
+        readonly method: "POST";
+        readonly headers: Readonly<Record<string, string>>;
+        readonly body: string;
+    }) => Promise<unknown>;
+    /** Called when a post fails (the dev server is down, the plugin is not installed). */
+    readonly onError?: (error: unknown) => void;
+}
+export declare const make: (options: Options) => Replay.Sink;
+//# sourceMappingURL=ReplayViteSink.d.ts.map

package/dist/ReplayViteSink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplayViteSink.d.ts","sourceRoot":"","sources":["../src/ReplayViteSink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAE1C,8EAA8E;AAC9E,eAAO,MAAM,QAAQ,qBAAqB,CAAA;AAE1C,MAAM,WAAW,OAAO;IACtB,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/J,sFAAsF;IACtF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAC5C;AAED,eAAO,MAAM,IAAI,YAAa,OAAO,KAAG,MAAM,CAAC,IAK7C,CAAA"}

package/dist/ReplayViteSink.js

@@ -0,0 +1,9 @@
+/** The dev server's endpoint for replays (what `ReplayVitePlugin` serves). */
+export const endpoint = "/__ritmo/replays";
+export const make = (options) => ({
+    save: (file) => {
+        void options.fetch(endpoint, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(file) })
+            .catch((error) => options.onError?.(error));
+    }
+});
+//# sourceMappingURL=ReplayViteSink.js.map

package/dist/ReplayViteSink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplayViteSink.js","sourceRoot":"","sources":["../src/ReplayViteSink.ts"],"names":[],"mappings":"AAiBA,8EAA8E;AAC9E,MAAM,CAAC,MAAM,QAAQ,GAAG,kBAAkB,CAAA;AAS1C,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,OAAgB,EAAe,EAAE,CAAC,CAAC;IACtD,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QACb,KAAK,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;aAC1H,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IACxD,CAAC;CACF,CAAC,CAAA"}