@memizy/host-sdk 0.0.0-stage → 1.0.0-rc.6

package/dist/relay/player.js

@@ -0,0 +1,327 @@
+import { createPluginFrame as e } from "../frame.js";
+import { RelaySocket as t, relayWebSocketUrl as n } from "./socket.js";
+import { isSerializedBlob as r, jsonToBlob as i, serializeError as a, unknownMethod as o } from "./messages.js";
+import { HOST_API_METHODS as s, PLUGIN_API_METHODS as c, RELAY_PROTOCOL as l, extractManifestFromHtml as u } from "@memizy/protocol";
+//#region src/relay/player.ts
+var d = new Set(c), f = 1e3, p = class {
+	playerId = null;
+	token;
+	name;
+	state = null;
+	hostConnected = !0;
+	hostAppVersion = null;
+	seat = void 0;
+	options;
+	socket;
+	listeners = /* @__PURE__ */ new Set();
+	bundle = null;
+	frame = null;
+	plugin = null;
+	gen = 0;
+	mountGen = 0;
+	callCounter = 0;
+	pending = /* @__PURE__ */ new Map();
+	skewMs = 0;
+	hostConfig = null;
+	mountQueue = Promise.resolve();
+	sessionEndedSent = !1;
+	constructor(e) {
+		this.options = e, this.token = e.token ?? null, this.name = e.name, this.socket = new t({
+			url: n(e.serverUrl),
+			attach: () => ({
+				t: "join",
+				protocol: l,
+				pin: e.pin,
+				name: this.name,
+				token: this.token ?? void 0,
+				...e.auth !== void 0 && { auth: e.auth }
+			}),
+			WebSocket: e.WebSocket
+		}), this.socket.onStatus((e) => this.emit({
+			type: "status",
+			status: e
+		})), this.socket.onMessage((e) => this.onServer(e));
+	}
+	get status() {
+		return this.socket.status;
+	}
+	on(e) {
+		return this.listeners.add(e), () => this.listeners.delete(e);
+	}
+	emit(e) {
+		for (let t of this.listeners) t(e);
+	}
+	refreshConfig() {
+		this.plugin && this.hostConfig && this.plugin.configChanged(this.localConfig(this.hostConfig)).catch(() => {});
+	}
+	localConfig(e) {
+		return {
+			...e,
+			...this.options.config?.()
+		};
+	}
+	rename(e) {
+		this.name = e, this.socket.send({
+			t: "rename",
+			name: e
+		});
+	}
+	claimSeat(e) {
+		this.up({
+			k: "claim",
+			seat: e
+		});
+	}
+	reconnectNow() {
+		this.socket.reconnectNow();
+	}
+	leave() {
+		this.destroyFrame(), this.socket.close();
+	}
+	onServer(e) {
+		switch (e.t) {
+			case "joined":
+				this.playerId = e.playerId, this.token = e.token, this.name = e.name, this.hostConnected = e.hostConnected, this.emit({
+					type: "joined",
+					playerId: e.playerId,
+					token: e.token,
+					name: e.name
+				}), this.up({
+					k: "hello",
+					gen: this.plugin ? this.gen : 0,
+					v: 1
+				});
+				break;
+			case "host-presence":
+				this.hostConnected = e.connected, this.emit({
+					type: "host",
+					connected: e.connected
+				}), e.connected && this.up({
+					k: "hello",
+					gen: this.plugin ? this.gen : 0,
+					v: 1
+				});
+				break;
+			case "data":
+				this.onHost(e.data);
+				break;
+			case "error":
+				this.emit({
+					type: "error",
+					code: e.code,
+					message: e.message,
+					fatal: e.fatal
+				});
+				break;
+			case "closed": {
+				let t = e.reason === "kicked" ? "kicked" : e.reason === "host" ? "closed" : "host-left";
+				this.mountQueue = this.mountQueue.then(async () => {
+					await this.endGame(t), this.emit({
+						type: "closed",
+						reason: e.reason
+					});
+				});
+				break;
+			}
+		}
+	}
+	up(e) {
+		return this.socket.send({
+			t: "up",
+			data: e
+		});
+	}
+	async onHost(e) {
+		if (typeof e == "object" && e) switch (e.k) {
+			case "state":
+				e.state.seats || (this.seat = void 0), this.state = e.state, this.emit({
+					type: "state",
+					state: e.state
+				});
+				return;
+			case "mount":
+				if (this.hostAppVersion = typeof e.v == "number" ? e.v : 0, e.gen === this.mountGen) {
+					this.mountQueue = this.mountQueue.then(() => {
+						this.plugin && this.gen === e.gen && this.up({
+							k: "mounted",
+							gen: e.gen
+						});
+					});
+					return;
+				}
+				this.mountGen = e.gen, this.mountQueue = this.mountQueue.then(() => this.mount(e.gen, e.bundle));
+				return;
+			case "unmount":
+				this.mountGen = 0, this.mountQueue = this.mountQueue.then(() => this.endGame("closed"));
+				return;
+			case "seat":
+				if (e.seat !== null && typeof e.seat != "string") return;
+				this.seat = e.seat, e.seat !== null && typeof e.name == "string" && e.name && e.name !== this.name && this.rename(e.name), this.emit({
+					type: "seat",
+					seat: e.seat
+				});
+				return;
+			case "result": {
+				let t = this.pending.get(e.id);
+				if (!t) return;
+				if (this.pending.delete(e.id), clearTimeout(t.timer), !e.ok) {
+					t.reject(Error(e.error?.message ?? "Host call failed"));
+					return;
+				}
+				let n = e.value;
+				if (t.method === "hello" && this.bundle) {
+					if (e.hostNow !== void 0) {
+						let n = Date.now();
+						this.skewMs = e.hostNow + (n - t.sentAt) / 2 - n;
+					}
+					let r = n;
+					this.hostConfig = r.config, n = {
+						...r,
+						set: structuredClone(this.bundle.data.set),
+						clock: {
+							...r.clock,
+							offsetMs: r.clock.offsetMs + this.skewMs
+						},
+						config: this.localConfig(r.config)
+					};
+				} else r(n) && (n = i(n));
+				t.resolve(n);
+				return;
+			}
+			case "call": {
+				let t = (e) => this.up(e);
+				if (!d.has(e.method)) {
+					t({
+						k: "result",
+						id: e.id,
+						ok: !1,
+						error: o(e.method)
+					});
+					return;
+				}
+				if (e.gen !== this.gen || !this.plugin) {
+					t({
+						k: "result",
+						id: e.id,
+						ok: !1,
+						error: { message: "[SESSION_ENDED] No active plugin instance." }
+					});
+					return;
+				}
+				let n = e.args;
+				if (e.method === "sessionEnded" && (this.sessionEndedSent = !0), e.method === "configChanged" && (this.hostConfig = n[0], n = [this.localConfig(this.hostConfig)]), e.method === "clockChanged") {
+					let e = n[0];
+					n = [{
+						...e,
+						offsetMs: e.offsetMs + this.skewMs
+					}];
+				}
+				try {
+					let r = this.plugin[e.method], i = await r(...n);
+					t({
+						k: "result",
+						id: e.id,
+						ok: !0,
+						value: i ?? null
+					});
+				} catch (n) {
+					t({
+						k: "result",
+						id: e.id,
+						ok: !1,
+						error: a(n)
+					});
+				}
+				return;
+			}
+		}
+	}
+	async ensureBundle(e) {
+		if (this.bundle?.version === e) return this.bundle.data;
+		let t = await (this.options.fetch ?? fetch)(new URL(`/api/rooms/${this.options.pin}/bundle`, this.options.serverUrl));
+		if (!t.ok) throw Error(`Could not download the game (${t.status}).`);
+		let n = await t.json();
+		return this.bundle = {
+			version: Number(t.headers.get("X-Bundle-Version") ?? e),
+			data: n
+		}, n;
+	}
+	async endGame(e) {
+		let t = this.plugin;
+		if (t && !this.sessionEndedSent) {
+			this.sessionEndedSent = !0;
+			let n;
+			await Promise.race([t.sessionEnded(e).catch(() => {}), new Promise((e) => n = setTimeout(e, f))]), clearTimeout(n);
+		}
+		this.destroyFrame();
+	}
+	async mount(t, n) {
+		this.destroyFrame(), this.sessionEndedSent = !1, this.gen = t;
+		try {
+			let r = await this.ensureBundle(n);
+			if (this.gen !== t) return;
+			let i = this.options.container();
+			if (!i) throw Error("No place for the game on this page.");
+			let a = u(r.pluginHtml), o = a.success ? String(a.data.appName ?? "Game") : "Game", s = this.options.transformHtml ? this.options.transformHtml(r.pluginHtml) : r.pluginHtml, c = (this.options.createFrame ?? e)(s, o, this.hostApiFor(t), i.ownerDocument);
+			this.frame = c, i.replaceChildren(c.iframe), this.emit({
+				type: "frame",
+				active: !0
+			});
+			let l = await c.plugin;
+			if (this.gen !== t) return;
+			this.plugin = l, this.up({
+				k: "mounted",
+				gen: t
+			});
+		} catch (e) {
+			if (this.gen !== t) return;
+			this.emit({
+				type: "error",
+				code: "MOUNT_FAILED",
+				message: e.message,
+				fatal: !1
+			}), this.up({
+				k: "mount-failed",
+				gen: t,
+				error: a(e)
+			});
+		}
+	}
+	hostApiFor(e) {
+		let t = {};
+		for (let n of s) t[n] = (...t) => {
+			if (this.gen !== e) return Promise.reject(/* @__PURE__ */ Error("[SESSION_ENDED] This plugin instance was replaced."));
+			let r = ++this.callCounter;
+			return new Promise((i, a) => {
+				let o = setTimeout(() => {
+					this.pending.delete(r), a(/* @__PURE__ */ Error(`[INTERNAL_ERROR] The host did not answer ${n} in time.`));
+				}, this.options.callTimeoutMs ?? 15e3);
+				this.pending.set(r, {
+					method: n,
+					sentAt: Date.now(),
+					resolve: i,
+					reject: a,
+					timer: o
+				}), this.up({
+					k: "call",
+					id: r,
+					gen: e,
+					method: n,
+					args: t
+				}) || (clearTimeout(o), this.pending.delete(r), n === "hello" ? a(/* @__PURE__ */ Error("[INTERNAL_ERROR] Offline.")) : i(void 0));
+			});
+		};
+		return t;
+	}
+	destroyFrame() {
+		let e = this.frame !== null;
+		this.frame?.destroy(), this.frame?.iframe.remove(), this.frame = null, this.plugin = null, this.gen = 0;
+		for (let e of this.pending.values()) clearTimeout(e.timer), e.reject(/* @__PURE__ */ Error("[SESSION_ENDED] The plugin instance was closed."));
+		this.pending.clear(), e && this.emit({
+			type: "frame",
+			active: !1
+		});
+	}
+};
+//#endregion
+export { p as RelayPlayer };

package/dist/relay/socket.cjs

@@ -0,0 +1 @@
+var e=class{status=`connecting`;options;ws=null;retry=0;retryTimer;pingTimer;stopped=!1;messageListeners=new Set;statusListeners=new Set;constructor(e){this.options=e,this.open()}onMessage(e){return this.messageListeners.add(e),()=>this.messageListeners.delete(e)}onStatus(e){return this.statusListeners.add(e),()=>this.statusListeners.delete(e)}send(e){return this.status!==`online`||this.ws?.readyState!==1?!1:(this.ws.send(JSON.stringify(e)),!0)}close(){this.stopped=!0,clearTimeout(this.retryTimer),clearInterval(this.pingTimer),this.ws?.close(1e3,`bye`),this.setStatus(`closed`)}reconnectNow(){this.stopped||this.status===`online`||this.status===`connecting`||(clearTimeout(this.retryTimer),this.open())}setStatus(e){if(this.status!==e){this.status=e;for(let t of this.statusListeners)t(e)}}open(){if(this.stopped)return;this.setStatus(`connecting`);let e=new(this.options.WebSocket??WebSocket)(this.options.url);this.ws=e,e.onopen=()=>{this.ws===e&&e.send(JSON.stringify(this.options.attach()))},e.onmessage=t=>{if(this.ws!==e)return;let n;try{n=JSON.parse(String(t.data))}catch{return}(n.t===`hosting`||n.t===`joined`)&&(this.retry=0,this.setStatus(`online`),clearInterval(this.pingTimer),this.pingTimer=setInterval(()=>this.send({t:`ping`}),2e4)),(n.t===`error`&&n.fatal||n.t===`closed`)&&(this.stopped=!0);for(let e of this.messageListeners)e(n);this.stopped&&this.close()},e.onclose=t=>{if(this.ws!==e)return;if(clearInterval(this.pingTimer),this.ws=null,t.reason?.startsWith(`replaced`)){this.stopped=!0,this.setStatus(`replaced`);return}if(this.stopped){this.setStatus(`closed`);return}this.setStatus(`offline`);let n=Math.min(5e3,300*2**this.retry++)+Math.random()*300;this.retryTimer=setTimeout(()=>this.open(),n)},e.onerror=()=>{}}};function t(e){let t=new URL(e);return t.protocol=t.protocol===`https:`?`wss:`:`ws:`,t.pathname=`${t.pathname.replace(/\/$/,``)}/ws`,t.href}exports.RelaySocket=e,exports.relayWebSocketUrl=t;

package/dist/relay/socket.js

@@ -0,0 +1,74 @@
+//#region src/relay/socket.ts
+var e = class {
+	status = "connecting";
+	options;
+	ws = null;
+	retry = 0;
+	retryTimer;
+	pingTimer;
+	stopped = !1;
+	messageListeners = /* @__PURE__ */ new Set();
+	statusListeners = /* @__PURE__ */ new Set();
+	constructor(e) {
+		this.options = e, this.open();
+	}
+	onMessage(e) {
+		return this.messageListeners.add(e), () => this.messageListeners.delete(e);
+	}
+	onStatus(e) {
+		return this.statusListeners.add(e), () => this.statusListeners.delete(e);
+	}
+	send(e) {
+		return this.status !== "online" || this.ws?.readyState !== 1 ? !1 : (this.ws.send(JSON.stringify(e)), !0);
+	}
+	close() {
+		this.stopped = !0, clearTimeout(this.retryTimer), clearInterval(this.pingTimer), this.ws?.close(1e3, "bye"), this.setStatus("closed");
+	}
+	reconnectNow() {
+		this.stopped || this.status === "online" || this.status === "connecting" || (clearTimeout(this.retryTimer), this.open());
+	}
+	setStatus(e) {
+		if (this.status !== e) {
+			this.status = e;
+			for (let t of this.statusListeners) t(e);
+		}
+	}
+	open() {
+		if (this.stopped) return;
+		this.setStatus("connecting");
+		let e = new (this.options.WebSocket ?? WebSocket)(this.options.url);
+		this.ws = e, e.onopen = () => {
+			this.ws === e && e.send(JSON.stringify(this.options.attach()));
+		}, e.onmessage = (t) => {
+			if (this.ws !== e) return;
+			let n;
+			try {
+				n = JSON.parse(String(t.data));
+			} catch {
+				return;
+			}
+			(n.t === "hosting" || n.t === "joined") && (this.retry = 0, this.setStatus("online"), clearInterval(this.pingTimer), this.pingTimer = setInterval(() => this.send({ t: "ping" }), 2e4)), (n.t === "error" && n.fatal || n.t === "closed") && (this.stopped = !0);
+			for (let e of this.messageListeners) e(n);
+			this.stopped && this.close();
+		}, e.onclose = (t) => {
+			if (this.ws !== e) return;
+			if (clearInterval(this.pingTimer), this.ws = null, t.reason?.startsWith("replaced")) {
+				this.stopped = !0, this.setStatus("replaced");
+				return;
+			}
+			if (this.stopped) {
+				this.setStatus("closed");
+				return;
+			}
+			this.setStatus("offline");
+			let n = Math.min(5e3, 300 * 2 ** this.retry++) + Math.random() * 300;
+			this.retryTimer = setTimeout(() => this.open(), n);
+		}, e.onerror = () => {};
+	}
+};
+function t(e) {
+	let t = new URL(e);
+	return t.protocol = t.protocol === "https:" ? "wss:" : "ws:", t.pathname = `${t.pathname.replace(/\/$/, "")}/ws`, t.href;
+}
+//#endregion
+export { e as RelaySocket, t as relayWebSocketUrl };

package/dist/session.cjs

@@ -0,0 +1 @@
+require("./version.cjs");const e=require("./plugin.cjs"),t=require("./learning.cjs"),n=require("./storage.cjs");let r=require("@memizy/protocol"),i=require("@memizy/oqse"),a=require("@memizy/protocol/internal");function o(e){try{return structuredClone(e)}catch{return JSON.parse(JSON.stringify(e))}}var s=class{id;plugin;runtime;mode;hostAs;authority;prepared;roster;settingValues;settingsOk=!0;hostConfig;isStarted=!1;isEnded=!1;pauseState={pausedMs:0,pausedAt:null};options;storage;algorithm;instances=new Map;listeners=new Set;authorityConnected=!0;startPromise=null;resumeStartPending=!1;pendingSnapshot=void 0;finished=!1;hasResult=!1;finishedSnapshot=null;snapshotTimer;pendingData=new Map;get players(){return this.roster}get settings(){return this.settingValues}get settingsValid(){return this.settingsOk}get config(){return this.hostConfig}get started(){return this.isStarted}get ended(){return this.isEnded}constructor(i){if(this.options=i,this.id=i.sessionId??`session-${Date.now().toString(36)}-${Math.random().toString(36).slice(2,8)}`,this.plugin=i.plugin,this.runtime=i.plugin.runtime,this.mode=i.mode,this.storage=i.storage??new n.MemoryStorage,this.algorithm=i.algorithm??t.leitner,this.hostConfig={locale:i.locale??`en`,theme:i.theme??`light`},i.mode===`solo`){if(!this.runtime.solo)throw Error(`The plugin does not support solo mode.`);this.hostAs=null}else{if(!this.runtime.multiplayer)throw Error(`The plugin does not support multiplayer.`);let e=i.hostAs??this.runtime.multiplayer.hostAs[0];if(!this.runtime.multiplayer.hostAs.includes(e))throw Error(`The plugin does not support hostAs "${e}".`);this.hostAs=e}let a=i.players??(i.mode===`solo`?[{id:`player`,name:`Player`,isHost:!0}]:[]);if(i.mode===`solo`&&a.length!==1)throw Error(`A solo session has exactly one player.`);if(new Set(a.map(e=>e.id)).size!==a.length)throw Error(`Player IDs must be unique.`);if(a.some(e=>e.id===r.BOARD_ADDRESS||e.id===r.SETTINGS_ADDRESS||e.id===`server`))throw Error(`Player IDs "board", "settings" and "server" are reserved.`);if(this.roster=a.map(e=>({id:e.id,name:e.name,isHost:i.mode===`solo`?!0:e.isHost??!1,connected:!0})),i.mode===`solo`)this.authority=this.roster[0].id;else if(this.hostAs===`presenter`)this.authority=r.BOARD_ADDRESS;else{let e=this.roster.find(e=>e.isHost);if(!e)throw Error(`With hostAs "player", one player must have isHost: true.`);this.authority=e.id}let s=(0,r.resolveSettings)(this.runtime.settings,i.settings??{});if(s.errors.length>0)throw Error(`Invalid settings: ${s.errors.join(`; `)}`);this.settingValues=s.values;let c=i.shuffleSeed===null?void 0:i.shuffleSeed??this.id;this.prepared=e.prepareSetForPlugin(o(i.set),i.plugin.manifest,{seed:c}),i.restore&&(this.isStarted=!0,this.resumeStartPending=!0),i.clock&&(this.pauseState={pausedMs:i.clock.pausedMs??0,pausedAt:i.clock.pausedAt??null})}on(e){return this.listeners.add(e),()=>this.listeners.delete(e)}emit(e){for(let t of this.listeners)try{t(e)}catch(e){console.error(`[memizy host] session listener failed:`,e)}}viewOf(e){return e===r.SETTINGS_ADDRESS?`settings`:this.mode===`solo`?`solo`:e===r.BOARD_ADDRESS?`board`:`controller`}addresses(){return[...this.hostAs===`presenter`?[r.BOARD_ADDRESS]:[],...this.roster.map(e=>e.id)]}async connect(e,t,n={}){let i=this.viewOf(e);if(i===`settings`){if(!this.runtime.multiplayer||!this.runtime.settingsScreen)throw Error(`The plugin has no settings screen (settingsScreen).`);if(this.isStarted)throw Error(`The settings screen is only available before the game starts.`)}else if(!this.addresses().includes(e))throw Error(`Unknown address "${e}" in this session.`);if(this.isEnded)throw Error(`The session has ended.`);this.disposeInstance(e);let o={address:e,view:i,hostApi:void 0,endpoint:t,onDispose:n.onDispose,plugin:null,ready:!1,connected:!0,disposed:!1,resumed:!1,greeted:!1,limiter:new a.RateLimiter(r.LIMITS.messagesPerSecond,r.LIMITS.messageBurst),serviceLimiter:new a.RateLimiter(r.LIMITS.servicesPerMinute/60,10),answerLimiter:new a.RateLimiter(r.LIMITS.answersPerSecond,r.LIMITS.answerBurst),assetLimiter:new a.RateLimiter(r.LIMITS.assetsPerSecond,r.LIMITS.assetBurst),errorLimiter:new a.RateLimiter(r.LIMITS.errorReportsPerSecond,r.LIMITS.errorReportBurst)};o.hostApi=this.createHostApi(o),this.instances.set(e,o),e===this.authority&&this.isStarted&&this.setAuthorityConnected(!1);try{o.plugin=await t(o.hostApi)}catch(e){if(o.disposed)return o;throw e}return o}async reload(e){let t=this.instances.get(e);if(!t)throw Error(`No instance at "${e}".`);return e===this.authority&&await this.flushSnapshot(),this.connect(e,t.endpoint,{onDispose:t.onDispose})}disconnect(e){this.disposeInstance(e),e===this.authority&&this.isStarted&&this.setAuthorityConnected(!1)}disposeInstance(e){let t=this.instances.get(e);if(t){t.disposed=!0,this.instances.delete(e);try{t.onDispose?.()}catch(e){console.warn(`[memizy host] dispose failed:`,e)}}}getInstance(e){return this.instances.get(e)}start(){if(this.mode===`solo`||this.isStarted&&!this.startPromise)return Promise.resolve();if(!this.settingsOk)return Promise.reject(Error(`The settings are not valid.`));let e=this.roster.length,t=this.runtime.multiplayer.players;return e<t.min||e>t.max?Promise.reject(Error(`This plugin needs ${t.min}–${t.max} players (now ${e}).`)):(this.startPromise??=this.runStart(),this.startPromise)}async runStart(){this.disposeInstance(r.SETTINGS_ADDRESS);let e=Date.now()+(this.options.readyTimeoutMs??15e3),t=()=>[...this.instances.values()].every(e=>e.ready),n=()=>this.instances.get(this.authority)?.ready===!0;for(;!(t()&&n())&&(Date.now()<e||!n());){if(this.isEnded)return;await c(25)}let i=this.options.countdownMs??3e3;for(let e=Math.ceil(i/1e3);e>0;e--)this.emit({type:`countdown`,secondsLeft:e}),await c(Math.min(1e3,i-(Math.ceil(i/1e3)-e)*1e3));this.isEnded||(this.isStarted=!0,this.emit({type:`started`}),await this.callPlugin(this.authority,e=>e.start()))}addPlayer(e){if(this.mode===`solo`)throw Error(`Players cannot join a solo session.`);if(this.roster.some(t=>t.id===e.id)||[r.BOARD_ADDRESS,r.SETTINGS_ADDRESS,`server`].includes(e.id))throw Error(`Player ID "${e.id}" is already used or reserved.`);if(this.isStarted&&!this.runtime.multiplayer.lateJoin)throw Error(`This game does not allow joining after the start.`);if(this.roster.length>=this.runtime.multiplayer.players.max)throw Error(`The game is full.`);this.roster=[...this.roster,{id:e.id,name:e.name,isHost:!1,connected:!0}],this.broadcastPlayers()}removePlayer(e){if(e===this.authority)throw Error(`The host cannot be removed.`);this.disposeInstance(e),this.roster=this.roster.filter(t=>t.id!==e),this.broadcastPlayers()}renamePlayer(e,t){this.roster=this.roster.map(n=>n.id===e?{...n,name:t}:n),this.broadcastPlayers()}setConnected(e,t){let n=this.instances.get(e);n&&(n.connected=t),this.roster.some(t=>t.id===e)&&(this.roster=this.roster.map(n=>n.id===e?{...n,connected:t}:n),this.broadcastPlayers()),e===this.authority?this.setAuthorityConnected(t):t&&n&&this.callPlugin(e,e=>e.authorityChanged({connected:!0}))}get services(){return this.runtime.services.filter(e=>typeof this.options.services?.[e]==`function`)}get paused(){return this.pauseState.pausedAt!==null}get clock(){return{offsetMs:0,...this.pauseState}}pause(){!this.isStarted||this.isEnded||this.paused||(this.pauseState={...this.pauseState,pausedAt:Date.now()},this.broadcastClock())}resume(){this.paused&&(this.pauseState={pausedMs:this.pauseState.pausedMs+Math.max(0,Date.now()-this.pauseState.pausedAt),pausedAt:null},this.broadcastClock())}broadcastClock(){let e=this.clock;for(let t of this.instances.keys())this.callPlugin(t,t=>t.clockChanged(e));this.emit({type:`paused`,paused:this.paused,clock:{...this.pauseState}})}setConfig(e){this.hostConfig={...this.hostConfig,...e};for(let e of this.instances.keys())this.callPlugin(e,e=>e.configChanged(this.hostConfig))}async end(e=`closed`){this.isEnded||(this.isEnded=!0,e===`finished`?await this.discardSnapshot():await this.flushSnapshot(),await this.flushData(),await Promise.all([...this.instances.keys()].map(t=>this.callPlugin(t,t=>t.sessionEnded(e)))))}createHostApi(e){let t=(t,n)=>(async()=>{if(e.disposed)throw new r.ProtocolError(`SESSION_ENDED`,`This instance has been closed.`);if(this.isEnded&&t!==`reportError`)throw new r.ProtocolError(`SESSION_ENDED`,`The session has ended.`);return n()})().catch(n=>{let i=(0,r.toProtocolError)(n);throw this.emit({type:`rejected`,address:e.address,method:t,code:i.code,message:i.detail}),i}),n=()=>e.view===`solo`||e.view===`controller`,s=(t,n)=>{if(!n)throw new r.ProtocolError(`NOT_ALLOWED_IN_VIEW`,`${t} is not available in view "${e.view}".`)},c=t=>{if(e.address!==this.authority)throw new r.ProtocolError(`NOT_AUTHORITY`,`${t} may only be called by the authority.`)};return{hello:(...n)=>t(`hello`,async()=>{let[t]=(0,a.parseHostCall)(`hello`,n);if(e.greeted)throw new r.ProtocolError(`INVALID_ARGUMENT`,`hello may only be called once per instance.`);let i=(0,r.negotiateProtocolVersion)(t.protocol,r.PROTOCOL_VERSION);if(!i)throw new r.ProtocolError(`UNSUPPORTED_PROTOCOL`,`The plugin speaks protocol ${t.protocol}; this host supports ${r.PROTOCOL_VERSION}.`);return e.greeted=!0,t.plugin.id!==this.plugin.manifest.id&&this.emit({type:`pluginError`,address:e.address,code:`PLUGIN_ID_MISMATCH`,message:`The SDK reports plugin id "${t.plugin.id}", the manifest says "${this.plugin.manifest.id}".`}),this.buildInit(e,i)}),ready:(...n)=>t(`ready`,()=>{(0,a.parseHostCall)(`ready`,n),!e.ready&&(e.ready=!0,this.emit({type:`ready`,address:e.address}),e.address===this.authority&&(this.mode===`solo`&&!this.isStarted&&!e.resumed?(this.isStarted=!0,this.emit({type:`started`}),this.callPlugin(e.address,e=>e.start())):this.isStarted&&(this.resumeStartPending&&(this.resumeStartPending=!1,e.resumed||this.callPlugin(e.address,e=>e.start())),this.setAuthorityConnected(!0))))}),send:(...n)=>t(`send`,()=>{let[t]=(0,a.parseHostCall)(`send`,n);s(`send`,e.view!==`settings`);let i=(0,a.assertJsonWithin)(t.data,r.LIMITS.messageBytes,`MESSAGE_TOO_LARGE`,`message`),o=e.address===this.authority?1/Math.max(1,this.instances.size-1):1;if(!e.limiter.tryTake(o))throw new r.ProtocolError(`RATE_LIMITED`,`More than ${r.LIMITS.messagesPerSecond} messages per second.`);if(!e.connected)return;if(t.to===`authority`){let n=this.instances.get(this.authority);if(!n||!n.connected||!this.authorityConnected)throw new r.ProtocolError(`AUTHORITY_UNAVAILABLE`,`The host is not reachable right now.`);this.deliver(e.address,this.authority,t.data,i);return}let c=t.to===`all`?[...this.instances.keys()].filter(t=>t!==e.address&&t!==r.SETTINGS_ADDRESS):t.to.filter(e=>e!==r.SETTINGS_ADDRESS);for(let n of c)this.deliver(e.address,n,t.data,i)}),saveSnapshot:(...e)=>t(`saveSnapshot`,()=>{let[t]=(0,a.parseHostCall)(`saveSnapshot`,e);if(c(`saveSnapshot`),(0,a.assertJsonWithin)(t,r.LIMITS.snapshotBytes,`SNAPSHOT_TOO_LARGE`,`snapshot`),this.finished){this.finishedSnapshot=structuredClone(t);return}this.pendingSnapshot=structuredClone(t),this.snapshotTimer??=setTimeout(()=>void this.flushSnapshot(),1e3/r.LIMITS.snapshotsPerSecond)}),recordAnswer:(...n)=>t(`recordAnswer`,async()=>{let[t]=(0,a.parseHostCall)(`recordAnswer`,n),i=this.roster.some(t=>t.id===e.address)?e.address:null,o=t.playerId??i;if(!o)throw new r.ProtocolError(`INVALID_ARGUMENT`,`recordAnswer needs a playerId on the board.`);if(o!==i&&c(`recordAnswer for another player`),!this.roster.some(e=>e.id===o))throw new r.ProtocolError(`INVALID_ARGUMENT`,`Unknown player "${o}".`);let s=e.address===this.authority?1/Math.max(1,this.roster.length):1;if(!e.answerLimiter.tryTake(s))throw new r.ProtocolError(`RATE_LIMITED`,`More than ${r.LIMITS.answersPerSecond} answers per second.`);t.answer!==void 0&&(0,a.assertJsonWithin)(t.answer,r.LIMITS.answerBytes,`DATA_TOO_LARGE`,`answer`);let l=this.prepared.set.items.find(e=>e.id===t.itemId),u=e=>Array.isArray(e)?e.filter(e=>typeof e==`string`):[];if(!l){if(!t.item)throw new r.ProtocolError(`INVALID_ARGUMENT`,`Unknown item "${t.itemId}" (attach the item for a generated one).`);(0,a.assertJsonWithin)(t.item,r.LIMITS.generatedItemBytes,`DATA_TOO_LARGE`,`item`),this.emit({type:`answer`,playerId:o,record:null,answer:t,generated:!0,skills:u(t.item.skills),tags:u(t.item.tags)});return}let d=this.userKey(o),f=this.prepared.set.meta.id,p=await this.storage.loadProgress(d,f),{item:m,...h}=t,g=this.algorithm.apply(p[t.itemId],h,new Date,structuredClone(l));await this.storage.saveProgress(d,f,{[t.itemId]:g}),this.emit({type:`answer`,playerId:o,record:g,answer:h,generated:!1,skills:u(l.skills),tags:u(l.tags)})}),saveData:(...i)=>t(`saveData`,()=>{let[t,o]=(0,a.parseHostCall)(`saveData`,i);s(`saveData`,n()),(0,a.assertJsonWithin)(o,r.LIMITS.dataBytes,`DATA_TOO_LARGE`,`plugin data (${t})`);let c=`${e.address}|${t}`,l=this.pendingData.get(c);if(l)l.value=structuredClone(o);else{let n={playerId:e.address,scope:t,value:structuredClone(o),timer:setTimeout(()=>void this.flushData(c),1e3/r.LIMITS.dataWritesPerSecond)};this.pendingData.set(c,n)}}),updateSettings:(...n)=>t(`updateSettings`,()=>{let[t]=(0,a.parseHostCall)(`updateSettings`,n);s(`updateSettings`,e.view===`settings`);let{values:i,errors:o}=(0,r.resolveSettings)(this.runtime.settings,t.values);this.settingValues=i,this.settingsOk=t.valid&&o.length===0;let c=t.message??o[0];this.emit({type:`settings`,values:i,valid:this.settingsOk,...c&&{message:c}})}),getAsset:(...n)=>t(`getAsset`,async()=>{let[t,o]=(0,a.parseHostCall)(`getAsset`,n);if(!e.assetLimiter.tryTake())throw new r.ProtocolError(`RATE_LIMITED`,`More than ${r.LIMITS.assetsPerSecond} assets per second.`);let s=o?this.options.set.items.find(e=>e.id===o):void 0,c=(0,i.resolveAsset)(t,s,this.options.set.meta);if(!c)throw new r.ProtocolError(`ASSET_NOT_FOUND`,`Asset "${t}" does not exist.`);if(this.options.loadAsset)return this.options.loadAsset(t,o);if(/^https?:/i.test(c.value)){let e=await fetch(c.value);if(e.ok)return e.blob()}throw new r.ProtocolError(`ASSET_NOT_FOUND`,`Asset "${t}" cannot be loaded by this host.`)}),end:(...e)=>t(`end`,async()=>{let[t]=(0,a.parseHostCall)(`end`,e);c(`end`),!this.hasResult&&(this.hasResult=!0,await this.discardSnapshot(),this.emit({type:`result`,result:t}))}),reportError:(...n)=>t(`reportError`,()=>{let[t]=(0,a.parseHostCall)(`reportError`,n);e.errorLimiter.tryTake()&&this.emit({type:`pluginError`,address:e.address,code:t.code,message:t.message,...t.context&&{context:t.context}})}),service:(...n)=>t(`service`,async()=>{let[t,i]=(0,a.parseHostCall)(`service`,n),s=this.services.includes(t)?this.options.services[t]:void 0;if(!s)throw new r.ProtocolError(`SERVICE_UNAVAILABLE`,`Service "${t}" is not available here (declare it in the manifest "services"; this host offers: ${this.services.join(`, `)||`none`}).`);if((0,a.assertJsonWithin)(i,r.LIMITS.serviceBytes,`MESSAGE_TOO_LARGE`,`service ${t} request`),!e.serviceLimiter.tryTake())throw new r.ProtocolError(`RATE_LIMITED`,`More than ${r.LIMITS.servicesPerMinute} service calls per minute.`);let c=this.roster.some(t=>t.id===e.address)?e.address:null,l=await s(o(i),{playerId:c,address:e.address,pluginId:this.plugin.manifest.id,setId:this.prepared.set.meta.id});return(0,a.assertJsonWithin)(l??null,r.LIMITS.serviceResultBytes,`MESSAGE_TOO_LARGE`,`service ${t} result`),o(l??null)})}}async buildInit(e,t){let n=e.view===`solo`||e.view===`controller`,r=this.prepared.set.meta.id,i=n?this.userKey(e.address):null,a=this.plugin.manifest.id;e.address===this.authority&&await this.flushSnapshot();let o=e.address===this.authority?this.finished?structuredClone(this.finishedSnapshot):await this.storage.loadSnapshot(this.id):null;return e.resumed=o!==null,{protocol:t,host:this.options.host??{name:`@memizy/host-sdk`,version:`1.0.0-rc.6`},oqseVersion:`1.0`,features:[],session:{id:this.id,mode:this.mode,hostAs:this.hostAs,view:e.view,self:e.address,authority:this.authority,lateJoin:this.isStarted&&e.view!==`settings`},players:this.roster,set:structuredClone(this.mode===`multiplayer`&&e.address!==this.authority?this.prepared.publicSet:this.prepared.set),settings:{...this.settingValues},config:this.hostConfig,clock:this.clock,services:this.services,progress:i?await this.storage.loadProgress(i,r):{},data:i?{plugin:this.pendingDataValue(e.address,`plugin`)??await this.storage.loadData(i,a,`plugin`,r)??null,set:this.pendingDataValue(e.address,`set`)??await this.storage.loadData(i,a,`set`,r)??null}:{plugin:null,set:null},snapshot:o}}userKey(e){return this.options.userKeyFor?.(e)??e}deliver(e,t,n,r){let i=this.instances.get(t);if(!i||!i.connected||!i.plugin)return;this.emit({type:`traffic`,from:e,to:t,bytes:r,data:n});let a=structuredClone(n);setTimeout(()=>void this.callPlugin(t,t=>t.deliver({from:e,data:a,sentAt:Date.now()})),0)}broadcastPlayers(){this.emit({type:`players`,players:this.roster});for(let e of this.instances.keys())this.callPlugin(e,e=>e.playersChanged(this.roster))}setAuthorityConnected(e){if(this.authorityConnected!==e){this.authorityConnected=e,this.emit({type:`authority`,connected:e});for(let t of this.instances.keys())t!==this.authority&&t!==r.SETTINGS_ADDRESS&&this.callPlugin(t,t=>t.authorityChanged({connected:e}))}}async callPlugin(e,t){let n=this.instances.get(e);if(n?.plugin&&!n.disposed)try{await t(n.plugin)}catch(t){this.emit({type:`pluginError`,address:e,code:`PLUGIN_CALL_FAILED`,message:(0,r.toProtocolError)(t).detail})}}async discardSnapshot(){this.finished||(this.finished=!0,clearTimeout(this.snapshotTimer),this.snapshotTimer=void 0,this.finishedSnapshot=this.pendingSnapshot===void 0?await this.storage.loadSnapshot(this.id):this.pendingSnapshot,this.pendingSnapshot=void 0,await this.storage.deleteSnapshot?.(this.id))}async flushSnapshot(){if(clearTimeout(this.snapshotTimer),this.snapshotTimer=void 0,this.pendingSnapshot===void 0||this.finished)return;let e=this.pendingSnapshot;this.pendingSnapshot=void 0,await this.storage.saveSnapshot(this.id,e),this.finished&&await this.storage.deleteSnapshot?.(this.id)}pendingDataValue(e,t){return this.pendingData.get(`${e}|${t}`)?.value}async flushData(e){let t=e?[[e,this.pendingData.get(e)]]:[...this.pendingData.entries()];for(let[e,n]of t)n&&(clearTimeout(n.timer),this.pendingData.delete(e),await this.storage.saveData(this.userKey(n.playerId),this.plugin.manifest.id,n.scope,this.prepared.set.meta.id,n.value))}};function c(e){return new Promise(t=>setTimeout(t,Math.max(0,e)))}exports.LocalSession=s;