@joystyk/session 0.0.0-stage → 0.2.0

package/dist/browser/index.d.ts

@@ -0,0 +1,48 @@
+import type { AiRunner, Clock, FrameScheduler, JobRunner, Reporter, SaveStore, Visibility } from '../ports.js';
+export { workerPreparer } from './preparer.js';
+export { createGameAudio, watchGameAudio, type GameAudioService, type AudioEnvironment } from './audio.js';
+/** `performance.now()` and `setTimeout`. */
+export declare const browserClock: () => Clock;
+/** The Page Visibility API. `pagehide` also counts as hidden, for pages entering the back/forward cache. */
+export declare const documentVisibility: (doc?: Document) => Visibility;
+/** `requestAnimationFrame`, passing the frame's timestamp. */
+export declare const animationFrames: () => FrameScheduler;
+/**
+ * A save slot in Web Storage, until the `storage` package's IndexedDB store exists. Writes
+ * reject when storage is unavailable or full (private browsing, quota).
+ */
+export declare const webStorageSaveStore: (key: string, storage?: Storage) => SaveStore & {
+    read(): unknown;
+};
+/**
+ * Runs each job in a fresh worker from `createWorker(kind)`. The worker receives
+ * `{ id, kind, payload }` and answers with one message: the job outcome
+ * (`{ ok: true, value, presentation? }` or `{ ok: false, reason }`). Cancelling, or the
+ * answer arriving, terminates the worker. The runner parses the answer.
+ */
+export declare const workerJobRunner: (createWorker: (kind: string) => Worker) => JobRunner;
+/**
+ * Runs each AI choice in a fresh worker from `createWorker()`, for games whose manifest
+ * declares heavy AI. The worker receives the `AiTask` (`{ view, seat, level, rng }`, all
+ * JSON) and answers with one message: the command. A game's worker entry is a few lines:
+ *
+ * ```ts
+ * // games/<id>/jobs/ai.worker.ts
+ * import { restoreRng } from '@joystyk/kit';
+ * import { engine } from '../engine/index.js';
+ * onmessage = ({ data }) => postMessage(engine.ai.choose(data.view, data.seat, data.level, restoreRng(data.rng)));
+ * ```
+ *
+ * Cancelling terminates the worker, which is the only way to stop a search that's running.
+ * The runner parses the answer with the engine's command schema.
+ */
+export declare const workerAiRunner: <View>(createWorker: () => Worker) => AiRunner<View>;
+/** Logs caught bugs to the console. */
+export declare const consoleReporter: Reporter;
+/** The usual browser ports in one object, to spread into a runner's options. */
+export declare const browserPorts: () => {
+    readonly clock: Clock;
+    readonly visibility: Visibility;
+    readonly frames: FrameScheduler;
+    readonly report: Reporter;
+};

package/dist/browser/index.js

@@ -0,0 +1,140 @@
+import { createGameAudio, watchGameAudio } from "./audio.js";
+import { workerPreparer } from "./preparer.js";
+//#region src/browser/index.ts
+/** `performance.now()` and `setTimeout`. */
+var browserClock = () => ({
+	now: () => performance.now(),
+	after: (ms, callback) => {
+		const id = setTimeout(callback, ms);
+		return () => clearTimeout(id);
+	}
+});
+/** The Page Visibility API. `pagehide` also counts as hidden, for pages entering the back/forward cache. */
+var documentVisibility = (doc = document) => ({
+	hidden: () => doc.visibilityState === "hidden",
+	subscribe: (listener) => {
+		const onChange = () => listener(doc.visibilityState === "hidden");
+		const onHide = () => listener(true);
+		const view = doc.defaultView;
+		doc.addEventListener("visibilitychange", onChange);
+		view?.addEventListener("pagehide", onHide);
+		view?.addEventListener("pageshow", onChange);
+		return () => {
+			doc.removeEventListener("visibilitychange", onChange);
+			view?.removeEventListener("pagehide", onHide);
+			view?.removeEventListener("pageshow", onChange);
+		};
+	}
+});
+/** `requestAnimationFrame`, passing the frame's timestamp. */
+var animationFrames = () => ({ request: (callback) => {
+	const id = requestAnimationFrame(callback);
+	return () => cancelAnimationFrame(id);
+} });
+/**
+* A save slot in Web Storage, until the `storage` package's IndexedDB store exists. Writes
+* reject when storage is unavailable or full (private browsing, quota).
+*/
+var webStorageSaveStore = (key, storage = localStorage) => ({
+	write: (save) => {
+		try {
+			storage.setItem(key, JSON.stringify(save));
+			return Promise.resolve();
+		} catch (error) {
+			return Promise.reject(error instanceof Error ? error : new Error(String(error)));
+		}
+	},
+	clear: () => {
+		try {
+			storage.removeItem(key);
+			return Promise.resolve();
+		} catch (error) {
+			return Promise.reject(error instanceof Error ? error : new Error(String(error)));
+		}
+	},
+	/** The stored value, unparsed beyond JSON (restore parses it), or null. */
+	read: () => {
+		try {
+			const raw = storage.getItem(key);
+			return raw === null ? null : JSON.parse(raw);
+		} catch {
+			return null;
+		}
+	}
+});
+/**
+* Runs each job in a fresh worker from `createWorker(kind)`. The worker receives
+* `{ id, kind, payload }` and answers with one message: the job outcome
+* (`{ ok: true, value, presentation? }` or `{ ok: false, reason }`). Cancelling, or the
+* answer arriving, terminates the worker. The runner parses the answer.
+*/
+var workerJobRunner = (createWorker) => ({ run: (job, _spec) => {
+	const worker = createWorker(job.kind);
+	const result = new Promise((resolve, reject) => {
+		worker.onmessage = (event) => {
+			worker.terminate();
+			resolve(event.data);
+		};
+		worker.onerror = (event) => {
+			worker.terminate();
+			reject(new Error(event.message || `The ${job.kind} worker failed.`));
+		};
+	});
+	worker.postMessage({
+		id: job.id,
+		kind: job.kind,
+		payload: job.payload
+	});
+	return {
+		result,
+		cancel: () => worker.terminate()
+	};
+} });
+/**
+* Runs each AI choice in a fresh worker from `createWorker()`, for games whose manifest
+* declares heavy AI. The worker receives the `AiTask` (`{ view, seat, level, rng }`, all
+* JSON) and answers with one message: the command. A game's worker entry is a few lines:
+*
+* ```ts
+* // games/<id>/jobs/ai.worker.ts
+* import { restoreRng } from '@joystyk/kit';
+* import { engine } from '../engine/index.ts';
+* onmessage = ({ data }) => postMessage(engine.ai.choose(data.view, data.seat, data.level, restoreRng(data.rng)));
+* ```
+*
+* Cancelling terminates the worker, which is the only way to stop a search that's running.
+* The runner parses the answer with the engine's command schema.
+*/
+var workerAiRunner = (createWorker) => ({ choose: (task) => {
+	const worker = createWorker();
+	const result = new Promise((resolve, reject) => {
+		worker.onmessage = (event) => {
+			worker.terminate();
+			resolve(event.data);
+		};
+		worker.onerror = (event) => {
+			worker.terminate();
+			reject(new Error(event.message || "The AI worker failed."));
+		};
+	});
+	worker.postMessage(task);
+	return {
+		result,
+		cancel: () => worker.terminate()
+	};
+} });
+/** Logs caught bugs to the console. */
+var consoleReporter = (error, context) => {
+	console.error(`[session] ${context}`, error);
+};
+/** The usual browser ports in one object, to spread into a runner's options. */
+var browserPorts = () => ({
+	clock: browserClock(),
+	visibility: documentVisibility(),
+	frames: animationFrames(),
+	report: consoleReporter
+});
+//#endregion
+export { animationFrames, browserClock, browserPorts, consoleReporter, createGameAudio, documentVisibility, watchGameAudio, webStorageSaveStore, workerAiRunner, workerJobRunner, workerPreparer };
+
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/browser/index.ts"],"sourcesContent":["// @joystyk/session/browser: the runners' ports, implemented with browser APIs. The core\n// package never touches these globals; the launcher passes these adapters in.\nimport type { JobRequest, JobSpec, SaveEnvelope } from '@joystyk/contracts';\nimport type {\n  AiRunner,\n  AiTask,\n  Clock,\n  FrameScheduler,\n  JobRunner,\n  Reporter,\n  SaveStore,\n  Task,\n  Visibility,\n} from '../ports.ts';\nexport { workerPreparer } from './preparer.ts';\nexport { createGameAudio, watchGameAudio, type GameAudioService, type AudioEnvironment } from './audio.ts';\n\n/** `performance.now()` and `setTimeout`. */\nexport const browserClock = (): Clock => ({\n  now: () => performance.now(),\n  after: (ms, callback) => {\n    const id = setTimeout(callback, ms);\n    return () => clearTimeout(id);\n  },\n});\n\n/** The Page Visibility API. `pagehide` also counts as hidden, for pages entering the back/forward cache. */\nexport const documentVisibility = (doc: Document = document): Visibility => ({\n  hidden: () => doc.visibilityState === 'hidden',\n  subscribe: (listener) => {\n    const onChange = (): void => listener(doc.visibilityState === 'hidden');\n    const onHide = (): void => listener(true);\n    const view = doc.defaultView;\n    doc.addEventListener('visibilitychange', onChange);\n    view?.addEventListener('pagehide', onHide);\n    view?.addEventListener('pageshow', onChange);\n    return () => {\n      doc.removeEventListener('visibilitychange', onChange);\n      view?.removeEventListener('pagehide', onHide);\n      view?.removeEventListener('pageshow', onChange);\n    };\n  },\n});\n\n/** `requestAnimationFrame`, passing the frame's timestamp. */\nexport const animationFrames = (): FrameScheduler => ({\n  request: (callback) => {\n    const id = requestAnimationFrame(callback);\n    return () => cancelAnimationFrame(id);\n  },\n});\n\n/**\n * A save slot in Web Storage, until the `storage` package's IndexedDB store exists. Writes\n * reject when storage is unavailable or full (private browsing, quota).\n */\nexport const webStorageSaveStore = (key: string, storage: Storage = localStorage): SaveStore & { read(): unknown } => ({\n  write: (save: SaveEnvelope) => {\n    try {\n      storage.setItem(key, JSON.stringify(save));\n      return Promise.resolve();\n    } catch (error) {\n      return Promise.reject(error instanceof Error ? error : new Error(String(error)));\n    }\n  },\n  clear: () => {\n    try {\n      storage.removeItem(key);\n      return Promise.resolve();\n    } catch (error) {\n      return Promise.reject(error instanceof Error ? error : new Error(String(error)));\n    }\n  },\n  /** The stored value, unparsed beyond JSON (restore parses it), or null. */\n  read: () => {\n    try {\n      const raw = storage.getItem(key);\n      return raw === null ? null : (JSON.parse(raw) as unknown);\n    } catch {\n      return null;\n    }\n  },\n});\n\n/**\n * Runs each job in a fresh worker from `createWorker(kind)`. The worker receives\n * `{ id, kind, payload }` and answers with one message: the job outcome\n * (`{ ok: true, value, presentation? }` or `{ ok: false, reason }`). Cancelling, or the\n * answer arriving, terminates the worker. The runner parses the answer.\n */\nexport const workerJobRunner = (createWorker: (kind: string) => Worker): JobRunner => ({\n  run: (job: JobRequest, _spec: JobSpec): Task<unknown> => {\n    const worker = createWorker(job.kind);\n    const result = new Promise<unknown>((resolve, reject) => {\n      worker.onmessage = (event: MessageEvent<unknown>) => {\n        worker.terminate();\n        resolve(event.data);\n      };\n      worker.onerror = (event) => {\n        worker.terminate();\n        reject(new Error(event.message || `The ${job.kind} worker failed.`));\n      };\n    });\n    worker.postMessage({ id: job.id, kind: job.kind, payload: job.payload });\n    return { result, cancel: () => worker.terminate() };\n  },\n});\n\n/**\n * Runs each AI choice in a fresh worker from `createWorker()`, for games whose manifest\n * declares heavy AI. The worker receives the `AiTask` (`{ view, seat, level, rng }`, all\n * JSON) and answers with one message: the command. A game's worker entry is a few lines:\n *\n * ```ts\n * // games/<id>/jobs/ai.worker.ts\n * import { restoreRng } from '@joystyk/kit';\n * import { engine } from '../engine/index.ts';\n * onmessage = ({ data }) => postMessage(engine.ai.choose(data.view, data.seat, data.level, restoreRng(data.rng)));\n * ```\n *\n * Cancelling terminates the worker, which is the only way to stop a search that's running.\n * The runner parses the answer with the engine's command schema.\n */\nexport const workerAiRunner = <View>(createWorker: () => Worker): AiRunner<View> => ({\n  choose: (task: AiTask<View>): Task<unknown> => {\n    const worker = createWorker();\n    const result = new Promise<unknown>((resolve, reject) => {\n      worker.onmessage = (event: MessageEvent<unknown>) => {\n        worker.terminate();\n        resolve(event.data);\n      };\n      worker.onerror = (event) => {\n        worker.terminate();\n        reject(new Error(event.message || 'The AI worker failed.'));\n      };\n    });\n    worker.postMessage(task);\n    return { result, cancel: () => worker.terminate() };\n  },\n});\n\n/** Logs caught bugs to the console. */\nexport const consoleReporter: Reporter = (error, context) => {\n  console.error(`[session] ${context}`, error);\n};\n\n/** The usual browser ports in one object, to spread into a runner's options. */\nexport const browserPorts = (): {\n  readonly clock: Clock;\n  readonly visibility: Visibility;\n  readonly frames: FrameScheduler;\n  readonly report: Reporter;\n} => ({\n  clock: browserClock(),\n  visibility: documentVisibility(),\n  frames: animationFrames(),\n  report: consoleReporter,\n});\n"],"mappings":";;;;AAkBA,IAAa,sBAA6B;CACxC,WAAW,YAAY,IAAI;CAC3B,QAAQ,IAAI,aAAa;EACvB,MAAM,KAAK,WAAW,UAAU,EAAE;EAClC,aAAa,aAAa,EAAE;CAC9B;AACF;;AAGA,IAAa,sBAAsB,MAAgB,cAA0B;CAC3E,cAAc,IAAI,oBAAoB;CACtC,YAAY,aAAa;EACvB,MAAM,iBAAuB,SAAS,IAAI,oBAAoB,QAAQ;EACtE,MAAM,eAAqB,SAAS,IAAI;EACxC,MAAM,OAAO,IAAI;EACjB,IAAI,iBAAiB,oBAAoB,QAAQ;EACjD,MAAM,iBAAiB,YAAY,MAAM;EACzC,MAAM,iBAAiB,YAAY,QAAQ;EAC3C,aAAa;GACX,IAAI,oBAAoB,oBAAoB,QAAQ;GACpD,MAAM,oBAAoB,YAAY,MAAM;GAC5C,MAAM,oBAAoB,YAAY,QAAQ;EAChD;CACF;AACF;;AAGA,IAAa,yBAAyC,EACpD,UAAU,aAAa;CACrB,MAAM,KAAK,sBAAsB,QAAQ;CACzC,aAAa,qBAAqB,EAAE;AACtC,EACF;;;;;AAMA,IAAa,uBAAuB,KAAa,UAAmB,kBAAmD;CACrH,QAAQ,SAAuB;EAC7B,IAAI;GACF,QAAQ,QAAQ,KAAK,KAAK,UAAU,IAAI,CAAC;GACzC,OAAO,QAAQ,QAAQ;EACzB,SAAS,OAAO;GACd,OAAO,QAAQ,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC,CAAC;EACjF;CACF;CACA,aAAa;EACX,IAAI;GACF,QAAQ,WAAW,GAAG;GACtB,OAAO,QAAQ,QAAQ;EACzB,SAAS,OAAO;GACd,OAAO,QAAQ,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC,CAAC;EACjF;CACF;;CAEA,YAAY;EACV,IAAI;GACF,MAAM,MAAM,QAAQ,QAAQ,GAAG;GAC/B,OAAO,QAAQ,OAAO,OAAQ,KAAK,MAAM,GAAG;EAC9C,QAAQ;GACN,OAAO;EACT;CACF;AACF;;;;;;;AAQA,IAAa,mBAAmB,kBAAuD,EACrF,MAAM,KAAiB,UAAkC;CACvD,MAAM,SAAS,aAAa,IAAI,IAAI;CACpC,MAAM,SAAS,IAAI,SAAkB,SAAS,WAAW;EACvD,OAAO,aAAa,UAAiC;GACnD,OAAO,UAAU;GACjB,QAAQ,MAAM,IAAI;EACpB;EACA,OAAO,WAAW,UAAU;GAC1B,OAAO,UAAU;GACjB,OAAO,IAAI,MAAM,MAAM,WAAW,OAAO,IAAI,KAAK,gBAAgB,CAAC;EACrE;CACF,CAAC;CACD,OAAO,YAAY;EAAE,IAAI,IAAI;EAAI,MAAM,IAAI;EAAM,SAAS,IAAI;CAAQ,CAAC;CACvE,OAAO;EAAE;EAAQ,cAAc,OAAO,UAAU;CAAE;AACpD,EACF;;;;;;;;;;;;;;;;AAiBA,IAAa,kBAAwB,kBAAgD,EACnF,SAAS,SAAsC;CAC7C,MAAM,SAAS,aAAa;CAC5B,MAAM,SAAS,IAAI,SAAkB,SAAS,WAAW;EACvD,OAAO,aAAa,UAAiC;GACnD,OAAO,UAAU;GACjB,QAAQ,MAAM,IAAI;EACpB;EACA,OAAO,WAAW,UAAU;GAC1B,OAAO,UAAU;GACjB,OAAO,IAAI,MAAM,MAAM,WAAW,uBAAuB,CAAC;EAC5D;CACF,CAAC;CACD,OAAO,YAAY,IAAI;CACvB,OAAO;EAAE;EAAQ,cAAc,OAAO,UAAU;CAAE;AACpD,EACF;;AAGA,IAAa,mBAA6B,OAAO,YAAY;CAC3D,QAAQ,MAAM,aAAa,WAAW,KAAK;AAC7C;;AAGA,IAAa,sBAKP;CACJ,OAAO,aAAa;CACpB,YAAY,mBAAmB;CAC/B,QAAQ,gBAAgB;CACxB,QAAQ;AACV"}

package/dist/browser/preparer.d.ts

@@ -0,0 +1,3 @@
+import { type AsyncPreparer, type Json, type Validator } from '@joystyk/contracts';
+/** A one-request worker, with cancellation and a validated response at the browser boundary. */
+export declare function workerPreparer<S extends Json, C extends Json>(setup: Validator<S>, config: Validator<C>, createWorker: () => Worker): AsyncPreparer<S, C>;

package/dist/browser/preparer.js

@@ -0,0 +1,73 @@
+import { err, gameError } from "@joystyk/contracts";
+//#region src/browser/preparer.ts
+/** A one-request worker, with cancellation and a validated response at the browser boundary. */
+function workerPreparer(setup, config, createWorker) {
+	let disposed = false;
+	const pending = /* @__PURE__ */ new Map();
+	const reply = { "~standard": {
+		version: 1,
+		vendor: "joystyk",
+		validate: async (value) => {
+			if (typeof value !== "object" || value === null) return { issues: [{ message: "Invalid preparer reply." }] };
+			const row = value;
+			if (row["ok"] === true) {
+				const decoded = await config["~standard"].validate(row["value"]);
+				return decoded.issues === void 0 ? { value: {
+					ok: true,
+					value: decoded.value
+				} } : decoded;
+			}
+			if (row["ok"] === false && typeof row["error"] === "object" && row["error"] !== null) {
+				const error = row["error"];
+				if (typeof error["code"] === "string" && typeof error["message"] === "string") return { value: err(gameError(error["code"], error["message"])) };
+			}
+			return { issues: [{ message: "Invalid preparer reply." }] };
+		}
+	} };
+	return {
+		setup,
+		prepare: async (choice, rng) => {
+			if (disposed) return err(gameError("Disposed", "The game was closed."));
+			const decoded = await setup["~standard"].validate(choice);
+			if (decoded.issues !== void 0) return err(gameError("BadSetup", "The game setup could not be read."));
+			if (disposed) return err(gameError("Disposed", "The game was closed."));
+			return new Promise((resolve) => {
+				let worker;
+				try {
+					worker = createWorker();
+				} catch {
+					resolve(err(gameError("WorkerFailed", "The game could not be prepared. Try again.")));
+					return;
+				}
+				const finish = (result) => {
+					if (!pending.delete(worker)) return;
+					worker.terminate();
+					resolve(result);
+				};
+				pending.set(worker, finish);
+				worker.addEventListener("message", (event) => {
+					Promise.resolve(reply["~standard"].validate(event.data)).then((parsed) => finish(parsed.issues === void 0 ? parsed.value : err(gameError("BadConfig", "The prepared game could not be read."))), () => finish(err(gameError("BadConfig", "The prepared game could not be read."))));
+				});
+				worker.addEventListener("error", () => finish(err(gameError("WorkerFailed", "The game worker could not finish."))));
+				worker.addEventListener("messageerror", () => finish(err(gameError("BadConfig", "The prepared game could not be read."))));
+				try {
+					worker.postMessage({
+						setup: decoded.value,
+						seed: rng.save()
+					});
+				} catch {
+					finish(err(gameError("WorkerFailed", "The game could not be prepared. Try again.")));
+				}
+			});
+		},
+		dispose: () => {
+			if (disposed) return;
+			disposed = true;
+			for (const finish of pending.values()) finish(err(gameError("Disposed", "The game was closed.")));
+		}
+	};
+}
+//#endregion
+export { workerPreparer };
+
+//# sourceMappingURL=preparer.js.map

package/dist/browser/preparer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preparer.js","names":[],"sources":["../../src/browser/preparer.ts"],"sourcesContent":["import { err, gameError, type AsyncPreparer, type Json, type Result, type Validator } from '@joystyk/contracts';\n\n/** A one-request worker, with cancellation and a validated response at the browser boundary. */\nexport function workerPreparer<S extends Json, C extends Json>(\n  setup: Validator<S>,\n  config: Validator<C>,\n  createWorker: () => Worker,\n): AsyncPreparer<S, C> {\n  let disposed = false;\n  const pending = new Map<Worker, (result: Result<C>) => void>();\n  const reply: Validator<Result<C>> = {\n    '~standard': {\n      version: 1,\n      vendor: 'joystyk',\n      validate: async (value) => {\n        if (typeof value !== 'object' || value === null) return { issues: [{ message: 'Invalid preparer reply.' }] };\n        const row = value as Record<string, unknown>;\n        if (row['ok'] === true) {\n          const decoded = await config['~standard'].validate(row['value']);\n          return decoded.issues === undefined ? { value: { ok: true, value: decoded.value } } : decoded;\n        }\n        if (row['ok'] === false && typeof row['error'] === 'object' && row['error'] !== null) {\n          const error = row['error'] as Record<string, unknown>;\n          if (typeof error['code'] === 'string' && typeof error['message'] === 'string')\n            return { value: err(gameError(error['code'], error['message'])) };\n        }\n        return { issues: [{ message: 'Invalid preparer reply.' }] };\n      },\n    },\n  };\n  return {\n    setup,\n    prepare: async (choice, rng) => {\n      if (disposed) return err(gameError('Disposed', 'The game was closed.'));\n      const decoded = await setup['~standard'].validate(choice);\n      if (decoded.issues !== undefined) return err(gameError('BadSetup', 'The game setup could not be read.'));\n      if (disposed) return err(gameError('Disposed', 'The game was closed.'));\n      return new Promise<Result<C>>((resolve) => {\n        let worker: Worker;\n        try {\n          worker = createWorker();\n        } catch {\n          resolve(err(gameError('WorkerFailed', 'The game could not be prepared. Try again.')));\n          return;\n        }\n        const finish = (result: Result<C>) => {\n          if (!pending.delete(worker)) return;\n          worker.terminate();\n          resolve(result);\n        };\n        pending.set(worker, finish);\n        worker.addEventListener('message', (event: MessageEvent<unknown>) => {\n          void Promise.resolve(reply['~standard'].validate(event.data)).then(\n            (parsed) =>\n              finish(\n                parsed.issues === undefined\n                  ? parsed.value\n                  : err(gameError('BadConfig', 'The prepared game could not be read.')),\n              ),\n            () => finish(err(gameError('BadConfig', 'The prepared game could not be read.'))),\n          );\n        });\n        worker.addEventListener('error', () =>\n          finish(err(gameError('WorkerFailed', 'The game worker could not finish.'))),\n        );\n        worker.addEventListener('messageerror', () =>\n          finish(err(gameError('BadConfig', 'The prepared game could not be read.'))),\n        );\n        try {\n          worker.postMessage({ setup: decoded.value, seed: rng.save() });\n        } catch {\n          finish(err(gameError('WorkerFailed', 'The game could not be prepared. Try again.')));\n        }\n      });\n    },\n    dispose: () => {\n      if (disposed) return;\n      disposed = true;\n      for (const finish of pending.values()) finish(err(gameError('Disposed', 'The game was closed.')));\n    },\n  };\n}\n"],"mappings":";;;AAGA,SAAgB,eACd,OACA,QACA,cACqB;CACrB,IAAI,WAAW;CACf,MAAM,0BAAU,IAAI,IAAyC;CAC7D,MAAM,QAA8B,EAClC,aAAa;EACX,SAAS;EACT,QAAQ;EACR,UAAU,OAAO,UAAU;GACzB,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,0BAA0B,CAAC,EAAE;GAC3G,MAAM,MAAM;GACZ,IAAI,IAAI,UAAU,MAAM;IACtB,MAAM,UAAU,MAAM,OAAO,YAAY,CAAC,SAAS,IAAI,QAAQ;IAC/D,OAAO,QAAQ,WAAW,KAAA,IAAY,EAAE,OAAO;KAAE,IAAI;KAAM,OAAO,QAAQ;IAAM,EAAE,IAAI;GACxF;GACA,IAAI,IAAI,UAAU,SAAS,OAAO,IAAI,aAAa,YAAY,IAAI,aAAa,MAAM;IACpF,MAAM,QAAQ,IAAI;IAClB,IAAI,OAAO,MAAM,YAAY,YAAY,OAAO,MAAM,eAAe,UACnE,OAAO,EAAE,OAAO,IAAI,UAAU,MAAM,SAAS,MAAM,UAAU,CAAC,EAAE;GACpE;GACA,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,0BAA0B,CAAC,EAAE;EAC5D;CACF,EACF;CACA,OAAO;EACL;EACA,SAAS,OAAO,QAAQ,QAAQ;GAC9B,IAAI,UAAU,OAAO,IAAI,UAAU,YAAY,sBAAsB,CAAC;GACtE,MAAM,UAAU,MAAM,MAAM,YAAY,CAAC,SAAS,MAAM;GACxD,IAAI,QAAQ,WAAW,KAAA,GAAW,OAAO,IAAI,UAAU,YAAY,mCAAmC,CAAC;GACvG,IAAI,UAAU,OAAO,IAAI,UAAU,YAAY,sBAAsB,CAAC;GACtE,OAAO,IAAI,SAAoB,YAAY;IACzC,IAAI;IACJ,IAAI;KACF,SAAS,aAAa;IACxB,QAAQ;KACN,QAAQ,IAAI,UAAU,gBAAgB,4CAA4C,CAAC,CAAC;KACpF;IACF;IACA,MAAM,UAAU,WAAsB;KACpC,IAAI,CAAC,QAAQ,OAAO,MAAM,GAAG;KAC7B,OAAO,UAAU;KACjB,QAAQ,MAAM;IAChB;IACA,QAAQ,IAAI,QAAQ,MAAM;IAC1B,OAAO,iBAAiB,YAAY,UAAiC;KACnE,QAAa,QAAQ,MAAM,YAAY,CAAC,SAAS,MAAM,IAAI,CAAC,CAAC,CAAC,MAC3D,WACC,OACE,OAAO,WAAW,KAAA,IACd,OAAO,QACP,IAAI,UAAU,aAAa,sCAAsC,CAAC,CACxE,SACI,OAAO,IAAI,UAAU,aAAa,sCAAsC,CAAC,CAAC,CAClF;IACF,CAAC;IACD,OAAO,iBAAiB,eACtB,OAAO,IAAI,UAAU,gBAAgB,mCAAmC,CAAC,CAAC,CAC5E;IACA,OAAO,iBAAiB,sBACtB,OAAO,IAAI,UAAU,aAAa,sCAAsC,CAAC,CAAC,CAC5E;IACA,IAAI;KACF,OAAO,YAAY;MAAE,OAAO,QAAQ;MAAO,MAAM,IAAI,KAAK;KAAE,CAAC;IAC/D,QAAQ;KACN,OAAO,IAAI,UAAU,gBAAgB,4CAA4C,CAAC,CAAC;IACrF;GACF,CAAC;EACH;EACA,eAAe;GACb,IAAI,UAAU;GACd,WAAW;GACX,KAAK,MAAM,UAAU,QAAQ,OAAO,GAAG,OAAO,IAAI,UAAU,YAAY,sBAAsB,CAAC,CAAC;EAClG;CACF;AACF"}

package/dist/browser/rooms.d.ts

@@ -0,0 +1,35 @@
+import { type CreateRoomRequest, type CreateRoomResponse, type RoomInfo } from '@joystyk/rooms/protocol';
+import type { SocketFactory, TokenStore } from '../remote.js';
+/** The room server's WebSocket URL for a page on `origin`: same host, `/ws` (Traefik routes it). */
+export declare const roomsSocketUrl: (origin: string) => string;
+/** A `SocketFactory` over the browser's `WebSocket`. */
+export declare const browserSocket: (url: string) => SocketFactory;
+/**
+ * Seat tokens in local storage, one key per room code, so every tab of this browser presents
+ * the same token and the newest tab takes the seat (room-server.md section 5.5). Storage that
+ * throws (blocked site data) falls back to memory for this page.
+ */
+export declare const webStorageTokens: (storage?: Storage | null) => TokenStore;
+/** 32 URL-safe characters from the browser's cryptographic randomness. */
+export declare const randomActionId: () => string;
+/** Why a room request failed, worded for players. */
+export type RoomRequestError = {
+    readonly status: number;
+    readonly message: string;
+};
+/** `POST /api/rooms`: creates a room and returns its code with the creator's seat token. */
+export declare const createRoom: (origin: string, request: CreateRoomRequest, fetcher?: typeof fetch) => Promise<{
+    readonly ok: true;
+    readonly value: CreateRoomResponse;
+} | {
+    readonly ok: false;
+    readonly error: RoomRequestError;
+}>;
+/** `GET /api/rooms/:code`: the room's game build, phase and open seats, or why not. */
+export declare const fetchRoomInfo: (origin: string, code: string, fetcher?: typeof fetch) => Promise<{
+    readonly ok: true;
+    readonly value: RoomInfo;
+} | {
+    readonly ok: false;
+    readonly error: RoomRequestError;
+}>;

package/dist/browser/rooms.js

@@ -0,0 +1,140 @@
+import { CreateRoomResponseSchema, RoomInfoSchema } from "@joystyk/rooms/protocol";
+//#region src/browser/rooms.ts
+/** The room server's WebSocket URL for a page on `origin`: same host, `/ws` (Traefik routes it). */
+var roomsSocketUrl = (origin) => {
+	const url = new URL("/ws", origin);
+	url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+	return url.href;
+};
+/** A `SocketFactory` over the browser's `WebSocket`. */
+var browserSocket = (url) => (events) => {
+	const ws = new WebSocket(url);
+	let closed = false;
+	const finish = (code) => {
+		if (closed) return;
+		closed = true;
+		events.close(code);
+	};
+	ws.addEventListener("open", () => events.open());
+	ws.addEventListener("message", (event) => {
+		if (typeof event.data === "string") events.message(event.data);
+	});
+	ws.addEventListener("close", (event) => finish(event.code));
+	ws.addEventListener("error", () => finish(1006));
+	return {
+		send: (text) => {
+			if (ws.readyState === WebSocket.OPEN) ws.send(text);
+		},
+		close: (code, reason) => {
+			closed = true;
+			if (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING) ws.close(code ?? 1e3, reason);
+		}
+	};
+};
+/**
+* Seat tokens in local storage, one key per room code, so every tab of this browser presents
+* the same token and the newest tab takes the seat (room-server.md section 5.5). Storage that
+* throws (blocked site data) falls back to memory for this page.
+*/
+var webStorageTokens = (storage = globalThis.localStorage ?? null) => {
+	const memory = /* @__PURE__ */ new Map();
+	const key = (room) => `joystyk:room-token:${room}`;
+	return {
+		get: (room) => {
+			try {
+				return storage?.getItem(key(room)) ?? memory.get(room) ?? null;
+			} catch {
+				return memory.get(room) ?? null;
+			}
+		},
+		set: (room, token) => {
+			memory.set(room, token);
+			try {
+				storage?.setItem(key(room), token);
+			} catch {}
+		},
+		delete: (room) => {
+			memory.delete(room);
+			try {
+				storage?.removeItem(key(room));
+			} catch {}
+		}
+	};
+};
+/** 32 URL-safe characters from the browser's cryptographic randomness. */
+var randomActionId = () => crypto.randomUUID().replaceAll("-", "");
+var ROOM_ERRORS = {
+	400: "The room could not be set up with those settings.",
+	403: "This page may not open rooms.",
+	404: "This game can't be played online here.",
+	413: "The room could not be set up with those settings.",
+	429: "Too many rooms were opened from here. Try again later.",
+	503: "The room server is busy or restarting. Try again in a moment."
+};
+var roomError = (status) => ({
+	status,
+	message: ROOM_ERRORS[status] ?? "The room server couldn't be reached. Check your connection, then try again."
+});
+/** `POST /api/rooms`: creates a room and returns its code with the creator's seat token. */
+var createRoom = async (origin, request, fetcher = fetch) => {
+	let response;
+	try {
+		response = await fetcher(new URL("/api/rooms", origin), {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify(request)
+		});
+	} catch {
+		return {
+			ok: false,
+			error: roomError(0)
+		};
+	}
+	if (response.status !== 201) return {
+		ok: false,
+		error: roomError(response.status)
+	};
+	const parsed = CreateRoomResponseSchema.safeParse(await response.json().catch(() => null));
+	return parsed.success ? {
+		ok: true,
+		value: parsed.data
+	} : {
+		ok: false,
+		error: roomError(0)
+	};
+};
+/** `GET /api/rooms/:code`: the room's game build, phase and open seats, or why not. */
+var fetchRoomInfo = async (origin, code, fetcher = fetch) => {
+	let response;
+	try {
+		response = await fetcher(new URL(`/api/rooms/${encodeURIComponent(code)}`, origin));
+	} catch {
+		return {
+			ok: false,
+			error: roomError(0)
+		};
+	}
+	if (response.status === 404) return {
+		ok: false,
+		error: {
+			status: 404,
+			message: "No room has that code. Check it, or ask for a new link."
+		}
+	};
+	if (!response.ok) return {
+		ok: false,
+		error: roomError(response.status)
+	};
+	const parsed = RoomInfoSchema.safeParse(await response.json().catch(() => null));
+	return parsed.success ? {
+		ok: true,
+		value: parsed.data
+	} : {
+		ok: false,
+		error: roomError(0)
+	};
+};
+//#endregion
+export { browserSocket, createRoom, fetchRoomInfo, randomActionId, roomsSocketUrl, webStorageTokens };
+
+//# sourceMappingURL=rooms.js.map

package/dist/browser/rooms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rooms.js","names":[],"sources":["../../src/browser/rooms.ts"],"sourcesContent":["// @joystyk/session/browser/rooms: the remote session client's ports for server rooms, with\n// browser APIs: a WebSocket, seat tokens in local storage, action IDs from the CSPRNG, and the\n// room server's HTTP API. A separate entry, so pages that never open a room never load the\n// protocol's schemas; the launcher imports it from the stage, on the first Start.\nimport {\n  CreateRoomResponseSchema,\n  RoomInfoSchema,\n  type CreateRoomRequest,\n  type CreateRoomResponse,\n  type RoomInfo,\n} from '@joystyk/rooms/protocol';\nimport type { RemoteSocket, SocketEvents, SocketFactory, TokenStore } from '../remote.ts';\n\n/** The room server's WebSocket URL for a page on `origin`: same host, `/ws` (Traefik routes it). */\nexport const roomsSocketUrl = (origin: string): string => {\n  const url = new URL('/ws', origin);\n  url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';\n  return url.href;\n};\n\n/** A `SocketFactory` over the browser's `WebSocket`. */\nexport const browserSocket =\n  (url: string): SocketFactory =>\n  (events: SocketEvents): RemoteSocket => {\n    const ws = new WebSocket(url);\n    let closed = false;\n    const finish = (code: number): void => {\n      if (closed) return;\n      closed = true;\n      events.close(code);\n    };\n    ws.addEventListener('open', () => events.open());\n    ws.addEventListener('message', (event: MessageEvent<unknown>) => {\n      if (typeof event.data === 'string') events.message(event.data);\n    });\n    ws.addEventListener('close', (event) => finish(event.code));\n    ws.addEventListener('error', () => finish(1006));\n    return {\n      send: (text) => {\n        if (ws.readyState === WebSocket.OPEN) ws.send(text);\n      },\n      close: (code, reason) => {\n        closed = true;\n        if (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING) ws.close(code ?? 1000, reason);\n      },\n    };\n  };\n\n/**\n * Seat tokens in local storage, one key per room code, so every tab of this browser presents\n * the same token and the newest tab takes the seat (room-server.md section 5.5). Storage that\n * throws (blocked site data) falls back to memory for this page.\n */\nexport const webStorageTokens = (storage: Storage | null = globalThis.localStorage ?? null): TokenStore => {\n  const memory = new Map<string, string>();\n  const key = (room: string): string => `joystyk:room-token:${room}`;\n  return {\n    get: (room) => {\n      try {\n        return storage?.getItem(key(room)) ?? memory.get(room) ?? null;\n      } catch {\n        return memory.get(room) ?? null;\n      }\n    },\n    set: (room, token) => {\n      memory.set(room, token);\n      try {\n        storage?.setItem(key(room), token);\n      } catch {\n        // Kept in memory for this page.\n      }\n    },\n    delete: (room) => {\n      memory.delete(room);\n      try {\n        storage?.removeItem(key(room));\n      } catch {\n        // Nothing stored.\n      }\n    },\n  };\n};\n\n/** 32 URL-safe characters from the browser's cryptographic randomness. */\nexport const randomActionId = (): string => crypto.randomUUID().replaceAll('-', '');\n\n/** Why a room request failed, worded for players. */\nexport type RoomRequestError = { readonly status: number; readonly message: string };\n\nconst ROOM_ERRORS: Readonly<Record<number, string>> = {\n  400: 'The room could not be set up with those settings.',\n  403: 'This page may not open rooms.',\n  404: \"This game can't be played online here.\",\n  413: 'The room could not be set up with those settings.',\n  429: 'Too many rooms were opened from here. Try again later.',\n  503: 'The room server is busy or restarting. Try again in a moment.',\n};\n\nconst roomError = (status: number): RoomRequestError => ({\n  status,\n  message: ROOM_ERRORS[status] ?? \"The room server couldn't be reached. Check your connection, then try again.\",\n});\n\n/** `POST /api/rooms`: creates a room and returns its code with the creator's seat token. */\nexport const createRoom = async (\n  origin: string,\n  request: CreateRoomRequest,\n  fetcher: typeof fetch = fetch,\n): Promise<\n  { readonly ok: true; readonly value: CreateRoomResponse } | { readonly ok: false; readonly error: RoomRequestError }\n> => {\n  let response: Response;\n  try {\n    response = await fetcher(new URL('/api/rooms', origin), {\n      method: 'POST',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify(request),\n    });\n  } catch {\n    return { ok: false, error: roomError(0) };\n  }\n  if (response.status !== 201) return { ok: false, error: roomError(response.status) };\n  const parsed = CreateRoomResponseSchema.safeParse(await response.json().catch(() => null));\n  return parsed.success ? { ok: true, value: parsed.data as CreateRoomResponse } : { ok: false, error: roomError(0) };\n};\n\n/** `GET /api/rooms/:code`: the room's game build, phase and open seats, or why not. */\nexport const fetchRoomInfo = async (\n  origin: string,\n  code: string,\n  fetcher: typeof fetch = fetch,\n): Promise<\n  { readonly ok: true; readonly value: RoomInfo } | { readonly ok: false; readonly error: RoomRequestError }\n> => {\n  let response: Response;\n  try {\n    response = await fetcher(new URL(`/api/rooms/${encodeURIComponent(code)}`, origin));\n  } catch {\n    return { ok: false, error: roomError(0) };\n  }\n  if (response.status === 404)\n    return { ok: false, error: { status: 404, message: 'No room has that code. Check it, or ask for a new link.' } };\n  if (!response.ok) return { ok: false, error: roomError(response.status) };\n  const parsed = RoomInfoSchema.safeParse(await response.json().catch(() => null));\n  return parsed.success ? { ok: true, value: parsed.data as RoomInfo } : { ok: false, error: roomError(0) };\n};\n"],"mappings":"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"}

package/dist/fixed-step.d.ts

@@ -0,0 +1,66 @@
+import { type FixedStepSimulation, type GameError, type GameSession, type Json, type Migration, type Result, type RngState, type SaveEnvelope, type SeatId, type SeatInfo, type SimulationReplay, type SimulationSnapshot } from '@joystyk/contracts';
+import { type FrameScheduler, type Reporter, type RngFactory, type SaveStore, type Visibility } from './ports.js';
+import { type RunnerManifest } from './saves.js';
+/** What the game's UI dispatches to a fixed-step runner. */
+export type FixedStepInput<Input> = {
+    readonly kind: 'input';
+    readonly input: Input;
+} | {
+    readonly kind: 'pause';
+} | {
+    readonly kind: 'resume';
+};
+/** The contract's `SimulationSnapshot` plus the tick events since the last snapshot. */
+export type FixedStepSnapshot<View, Event> = SimulationSnapshot<View> & {
+    /** One-off events from the ticks since the previous snapshot, for sound and effects. */
+    readonly events: readonly Event[];
+    /** Active play time: ticks × step length, so a pause stops it. */
+    readonly elapsedMs: number;
+};
+export interface FixedStepRunner<Input, View, Event> extends GameSession<FixedStepSnapshot<View, Event>, FixedStepInput<Input>> {
+    /**
+     * How far real time has run into the next tick, from 0 up to 1. A renderer may interpolate
+     * between the last two states with it; it never changes the simulation.
+     */
+    alpha(): number;
+    /** A checkpoint of the current tick. */
+    save(): SaveEnvelope;
+    /** The replay log so far, or null after restoring a checkpoint that had none. */
+    replay(): SimulationReplay | null;
+}
+export type FixedStepPorts = {
+    readonly manifest: RunnerManifest;
+    /** Restores the random state. Default: the kit's `restoreRng`. */
+    readonly restoreRng?: RngFactory;
+    readonly frames: FrameScheduler;
+    readonly visibility?: Visibility;
+    /** Checkpoints go here on the simulation's request, pause, hide, outcome and dispose. */
+    readonly storage?: SaveStore;
+    /** The viewer. Default: seat 0. */
+    readonly seat?: SeatId | null;
+    /**
+     * The most ticks one frame may run. After a long stall the rest of the backlog is dropped
+     * instead of freezing the page. Default: a tenth of a second's worth (6 at 60 Hz).
+     */
+    readonly maxStepsPerFrame?: number;
+    /** Start paused, e.g. behind a "Press to start" screen. Default false. */
+    readonly startPaused?: boolean;
+    readonly freeze?: boolean;
+    readonly report?: Reporter;
+};
+export type FixedStepOptions = FixedStepPorts & {
+    readonly seats: readonly SeatInfo[];
+    /** Decoded with the simulation's config schema. */
+    readonly config: unknown;
+    readonly seed: RngState;
+};
+export type FixedStepRestoreOptions = FixedStepPorts & {
+    readonly migrations: readonly Migration[];
+};
+/** Starts a new real-time game. Fails when the config is invalid or `init` refuses it. */
+export declare const createFixedStepRunner: <State extends Json, Input extends Json, View, Event extends Json, Config extends Json>(simulation: FixedStepSimulation<State, Input, View, Event, Config>, options: FixedStepOptions) => Result<FixedStepRunner<Input, View, Event>, GameError>;
+/**
+ * Resumes a checkpoint. When the checkpoint carries a replay that still reproduces it, the
+ * replay log continues; otherwise the game resumes without one.
+ */
+export declare const restoreFixedStepRunner: <State extends Json, Input extends Json, View, Event extends Json, Config extends Json>(simulation: FixedStepSimulation<State, Input, View, Event, Config>, save: unknown, options: FixedStepRestoreOptions) => Result<FixedStepRunner<Input, View, Event>, GameError>;