@memizy/protocol 0.0.0-stage → 1.0.0-rc.5

package/dist/items.js

@@ -0,0 +1,116 @@
+import { isTimelineOrderCorrect as e } from "@memizy/oqse";
+//#region src/items.ts
+function t(e) {
+	let t = 2166136261;
+	for (let n = 0; n < e.length; n++) t = Math.imul(t ^ e.charCodeAt(n), 16777619);
+	let n = t >>> 0;
+	return () => {
+		n = n + 1831565813 >>> 0;
+		let e = n;
+		return e = Math.imul(e ^ e >>> 15, e | 1), e ^= e + Math.imul(e ^ e >>> 7, e | 61), ((e ^ e >>> 14) >>> 0) / 4294967296;
+	};
+}
+function n(e, t, n) {
+	for (let r = 0; r < 6; r++) {
+		let r = [...e];
+		for (let e = r.length - 1; e > 0; e--) {
+			let n = Math.floor(t() * (e + 1));
+			[r[e], r[n]] = [r[n], r[e]];
+		}
+		if (!n || r.length < 2 || !n(r)) return r;
+	}
+	return [...e.slice(1), e[0]];
+}
+var r = (e) => (t) => t.every((t, n) => t.id === e[n]);
+function i(t, i) {
+	let a = structuredClone(t);
+	switch (a.type) {
+		case "mcq-single":
+		case "mcq-multi": return a.shuffle !== !1 && (a.options = n(a.options, i)), a;
+		case "fill-in-select":
+			for (let e of Object.values(a.blanks ?? {})) e.shuffle !== !1 && (e.options = n(e.options, i));
+			return a;
+		case "sort-items": return a.items = n(a.items, i, r(a.correctOrder)), a;
+		case "match-pairs": return a.prompts = n(a.prompts, i), a.matches = n(a.matches, i), a;
+		case "match-complex": return a.leftItems = n(a.leftItems, i), a.rightItems = n(a.rightItems, i), a;
+		case "timeline": return a.shuffle !== !1 && (a.events = n(a.events, i, (t) => e(t))), a;
+		case "categorize": return a.items = n(a.items, i), a;
+		case "diagram-label": return a.requireTyping || (a.labels = n(a.labels, i)), a;
+		default: return a;
+	}
+}
+var a = ["explanation", "incorrectFeedback"], o = {
+	note: ["hiddenContent"],
+	flashcard: ["back"],
+	"true-false": ["correctAnswer"],
+	"mcq-single": ["correctId"],
+	"mcq-multi": ["correctIds"],
+	"short-answer": ["correctAnswers"],
+	"sort-items": ["correctOrder"],
+	"match-pairs": ["pairs"],
+	"match-complex": ["connections"],
+	slider: ["correctAnswer"],
+	"numeric-input": ["correctAnswer"],
+	"math-input": ["correctAnswer", "alternativeAnswers"],
+	matrix: ["correctCells"],
+	"open-ended": ["sampleAnswer", "rubric"],
+	"chess-puzzle": ["correctAnswers"]
+}, s = [
+	"options",
+	"items",
+	"prompts",
+	"matches",
+	"leftItems",
+	"rightItems",
+	"categories",
+	"rows",
+	"columns",
+	"labels"
+];
+function c(e) {
+	let t = e.type, n = structuredClone(e);
+	for (let e of a) delete n[e];
+	if (Array.isArray(n.sources)) for (let e of n.sources) e && typeof e == "object" && delete e.quote;
+	if (t.startsWith("x-")) return delete n.solution, n.answerHidden = !0, n;
+	for (let e of o[t] ?? []) delete n[e];
+	for (let e of s) if (Array.isArray(n[e])) for (let t of n[e]) t && typeof t == "object" && delete t.explanation;
+	switch (t) {
+		case "fill-in-blanks":
+			n.blanks = Object.fromEntries(Object.keys(n.blanks ?? {}).map((e) => [e, []]));
+			break;
+		case "fill-in-select":
+			for (let e of Object.values(n.blanks ?? {})) {
+				delete e.correctId;
+				for (let t of e.options ?? []) delete t.explanation;
+			}
+			break;
+		case "categorize":
+			for (let e of n.items ?? []) delete e.correctCategoryId;
+			break;
+		case "timeline":
+			for (let e of n.events ?? []) delete e.date, delete e.precision;
+			break;
+		case "diagram-label":
+			for (let e of n.zones ?? []) delete e.correctLabelId;
+			n.requireTyping && (n.labels = []);
+			break;
+		case "pin-on-image":
+		case "pin-on-model": n.hotspots = [];
+	}
+	return n.answerHidden = !0, n;
+}
+function l(e, n) {
+	let r = n === void 0 ? null : t(n), a = e.items.map((e) => r ? i(e, r) : structuredClone(e));
+	return {
+		set: {
+			meta: e.meta,
+			items: a
+		},
+		publicSet: {
+			meta: e.meta,
+			items: a.map(c)
+		}
+	};
+}
+//#endregion
+export { i as displayItem, l as prepareDisplaySet, c as publicItem, t as seededRandom };

package/dist/limits.cjs

@@ -0,0 +1 @@
+const e=require("./errors.cjs");var t={messageBytes:65536,messagesPerSecond:30,messageBurst:60,snapshotBytes:1048576,snapshotsPerSecond:2,dataBytes:262144,dataWritesPerSecond:1,helloTimeoutMs:1e4,answerBytes:4096,generatedItemBytes:32768,serviceBytes:65536,servicesPerMinute:30},n=64;function r(e,t=`$`,i=0,a=new Set){if(e===null||typeof e==`string`||typeof e==`boolean`)return null;if(typeof e==`number`)return Number.isFinite(e)?null:`${t} is not a finite number`;if(typeof e!=`object`)return`${t} is a ${typeof e}`;if(i>=n)return`${t} is nested deeper than ${n} levels`;if(a.has(e))return`${t} contains a circular reference`;if(Array.isArray(e)){a.add(e);for(let n=0;n<e.length;n++){let o=r(e[n],`${t}[${n}]`,i+1,a);if(o)return o}return a.delete(e),null}let o=Object.getPrototypeOf(e);if(o!==Object.prototype&&o!==null)return`${t} is not a plain object`;a.add(e);for(let[n,o]of Object.entries(e)){let e=r(o,`${t}.${n}`,i+1,a);if(e)return e}return a.delete(e),null}function i(e){return new TextEncoder().encode(JSON.stringify(e)).length}function a(t,n,a,o){let s=r(t);if(s)throw new e.ProtocolError(`INVALID_ARGUMENT`,`${o} must be plain JSON: ${s}.`);let c=i(t);if(c>n)throw new e.ProtocolError(a,`${o} is ${c} bytes; the limit is ${n} bytes.`);return c}var o=class{rate;burst;now;tokens;last;constructor(e,t,n=()=>Date.now()){this.rate=e,this.burst=t,this.now=n,this.tokens=t,this.last=n()}tryTake(e=1){let t=this.now();return this.tokens=Math.min(this.burst,this.tokens+(t-this.last)/1e3*this.rate),this.last=t,this.tokens<e?!1:(this.tokens-=e,!0)}};exports.LIMITS=t,exports.RateLimiter=o,exports.assertJsonWithin=a,exports.findNonJson=r,exports.jsonByteSize=i;

package/dist/limits.js

@@ -0,0 +1,65 @@
+import { ProtocolError as e } from "./errors.js";
+//#region src/limits.ts
+var t = {
+	messageBytes: 65536,
+	messagesPerSecond: 30,
+	messageBurst: 60,
+	snapshotBytes: 1048576,
+	snapshotsPerSecond: 2,
+	dataBytes: 262144,
+	dataWritesPerSecond: 1,
+	helloTimeoutMs: 1e4,
+	answerBytes: 4096,
+	generatedItemBytes: 32768,
+	serviceBytes: 65536,
+	servicesPerMinute: 30
+}, n = 64;
+function r(e, t = "$", i = 0, a = /* @__PURE__ */ new Set()) {
+	if (e === null || typeof e == "string" || typeof e == "boolean") return null;
+	if (typeof e == "number") return Number.isFinite(e) ? null : `${t} is not a finite number`;
+	if (typeof e != "object") return `${t} is a ${typeof e}`;
+	if (i >= n) return `${t} is nested deeper than ${n} levels`;
+	if (a.has(e)) return `${t} contains a circular reference`;
+	if (Array.isArray(e)) {
+		a.add(e);
+		for (let n = 0; n < e.length; n++) {
+			let o = r(e[n], `${t}[${n}]`, i + 1, a);
+			if (o) return o;
+		}
+		return a.delete(e), null;
+	}
+	let o = Object.getPrototypeOf(e);
+	if (o !== Object.prototype && o !== null) return `${t} is not a plain object`;
+	a.add(e);
+	for (let [n, o] of Object.entries(e)) {
+		let e = r(o, `${t}.${n}`, i + 1, a);
+		if (e) return e;
+	}
+	return a.delete(e), null;
+}
+function i(e) {
+	return new TextEncoder().encode(JSON.stringify(e)).length;
+}
+function a(t, n, a, o) {
+	let s = r(t);
+	if (s) throw new e("INVALID_ARGUMENT", `${o} must be plain JSON: ${s}.`);
+	let c = i(t);
+	if (c > n) throw new e(a, `${o} is ${c} bytes; the limit is ${n} bytes.`);
+	return c;
+}
+var o = class {
+	rate;
+	burst;
+	now;
+	tokens;
+	last;
+	constructor(e, t, n = () => Date.now()) {
+		this.rate = e, this.burst = t, this.now = n, this.tokens = t, this.last = n();
+	}
+	tryTake(e = 1) {
+		let t = this.now();
+		return this.tokens = Math.min(this.burst, this.tokens + (t - this.last) / 1e3 * this.rate), this.last = t, this.tokens < e ? !1 : (this.tokens -= e, !0);
+	}
+};
+//#endregion
+export { t as LIMITS, o as RateLimiter, a as assertJsonWithin, r as findNonJson, i as jsonByteSize };

package/dist/manifestSchema.cjs

@@ -0,0 +1,2 @@
+const e=require("./settingsSchema.cjs"),t=require("./pluginRuntime.cjs");let n=require("zod"),r=require("@memizy/oqse");var i=n.z.string().regex(/^\d+\.\d+$/,`Protocol version must be in MAJOR.MINOR format (e.g. "1.0")`),a=n.z.enum([`presenter`,`player`]),o=n.z.looseObject({players:n.z.looseObject({min:n.z.number().int().min(1,`players.min must be at least 1`),max:n.z.number().int().max(200,`players.max must be at most 200`),recommended:n.z.number().int().positive().optional()}).refine(e=>e.min<=e.max,{message:`players.min must not be greater than players.max`,path:[`min`]}).refine(e=>e.recommended===void 0||e.recommended>=e.min&&e.recommended<=e.max,{message:`players.recommended must be between min and max`,path:[`recommended`]}),hostAs:n.z.array(a).min(1,`hostAs must contain "presenter" and/or "player"`).refine(e=>new Set(e).size===e.length,`hostAs must not contain duplicates`),lateJoin:n.z.boolean().optional()}),s=n.z.string().regex(/^(https|wss):\/\/[a-z0-9.-]+(:\d{1,5})?$/i,`A network origin is "https://host" or "wss://host" (no path)`),c=n.z.string().max(100).regex(/^[a-z][a-z0-9-]*(\.[a-z0-9][a-z0-9-]*)*$/,`A service name is lowercase segments joined by dots (e.g. "chess.puzzles")`),l=n.z.looseObject({network:n.z.array(s).max(20).optional(),devices:n.z.array(n.z.enum([`camera`,`microphone`,`geolocation`,`serial`,`bluetooth`])).max(5).optional()}),u=n.z.looseObject({protocol:i,set:n.z.enum([`required`,`optional`,`none`]).optional(),modes:n.z.looseObject({solo:n.z.looseObject({}).optional(),multiplayer:o.optional()}),settings:n.z.array(e.SettingDefinitionSchema).optional(),settingsScreen:n.z.looseObject({size:n.z.enum([`compact`,`large`])}).optional(),display:n.z.looseObject({orientation:n.z.enum([`any`,`portrait`,`landscape`]).optional()}).optional(),permissions:l.optional(),services:n.z.array(c).max(20).optional()}).refine(e=>e.modes.solo!==void 0||e.modes.multiplayer!==void 0,{message:`modes must declare "solo" and/or "multiplayer"`,path:[`modes`]}).refine(e=>e.settingsScreen===void 0||e.modes.multiplayer!==void 0,{message:`settingsScreen is only used in the multiplayer lobby; declare modes.multiplayer or remove it`,path:[`settingsScreen`]}).refine(e=>{let t=(e.settings??[]).map(e=>e.id);return new Set(t).size===t.length},{message:`Setting ids must be unique`,path:[`settings`]});function d(e){let n=[],i=r.OQSEManifestSchema.safeParse(e);i.success||n.push(...(0,r.formatOQSEErrors)(i.error));let a=e?.appSpecific?.memizy;if(a===void 0)n.push(`appSpecific.memizy: Missing the Memizy runtime block (protocol, modes, …)`);else{let e=u.safeParse(a);e.success||n.push(...(0,r.formatOQSEErrors)(e.error).map(e=>`appSpecific.memizy.${e}`))}if(n.length>0)return{success:!1,errors:n};let o=(0,r.withManifestDefaults)(e),s=t.toRuntime(o.appSpecific.memizy),c=o.capabilities.types;return s.set!==`none`&&(!Array.isArray(c)||c.length===0)?{success:!1,errors:[`capabilities.types: Declare the item types the game shows, or "set": "none" in appSpecific.memizy for a game without questions.`]}:{success:!0,manifest:o,runtime:s}}var f=class extends Error{errors;constructor(e){super(`Invalid plugin manifest:\n${e.join(`
+`)}`),this.name=`PluginManifestError`,this.errors=e}};function p(e){let t=d(e);if(!t.success)throw new f(t.errors);return{manifest:t.manifest,runtime:t.runtime}}function m(e){let n=t.extractManifestFromHtml(e);return n.success?d(n.data):{success:!1,errors:[n.error]}}exports.HostAsSchema=a,exports.MemizyRuntimeSchema=u,exports.MultiplayerModeSchema=o,exports.PluginManifestError=f,exports.PluginPermissionsSchema=l,exports.ServiceNameSchema=c,exports.parsePluginManifest=p,exports.readPluginManifestFromHtml=m,exports.safeParsePluginManifest=d;

package/dist/manifestSchema.js

@@ -0,0 +1,107 @@
+import { SettingDefinitionSchema as e } from "./settingsSchema.js";
+import { extractManifestFromHtml as t, toRuntime as n } from "./pluginRuntime.js";
+import { z as r } from "zod";
+import { OQSEManifestSchema as i, formatOQSEErrors as a, withManifestDefaults as o } from "@memizy/oqse";
+//#region src/manifestSchema.ts
+var s = r.string().regex(/^\d+\.\d+$/, "Protocol version must be in MAJOR.MINOR format (e.g. \"1.0\")"), c = r.enum(["presenter", "player"]), l = r.looseObject({
+	players: r.looseObject({
+		min: r.number().int().min(1, "players.min must be at least 1"),
+		max: r.number().int().max(200, "players.max must be at most 200"),
+		recommended: r.number().int().positive().optional()
+	}).refine((e) => e.min <= e.max, {
+		message: "players.min must not be greater than players.max",
+		path: ["min"]
+	}).refine((e) => e.recommended === void 0 || e.recommended >= e.min && e.recommended <= e.max, {
+		message: "players.recommended must be between min and max",
+		path: ["recommended"]
+	}),
+	hostAs: r.array(c).min(1, "hostAs must contain \"presenter\" and/or \"player\"").refine((e) => new Set(e).size === e.length, "hostAs must not contain duplicates"),
+	lateJoin: r.boolean().optional()
+}), u = r.string().regex(/^(https|wss):\/\/[a-z0-9.-]+(:\d{1,5})?$/i, "A network origin is \"https://host\" or \"wss://host\" (no path)"), d = r.string().max(100).regex(/^[a-z][a-z0-9-]*(\.[a-z0-9][a-z0-9-]*)*$/, "A service name is lowercase segments joined by dots (e.g. \"chess.puzzles\")"), f = r.looseObject({
+	network: r.array(u).max(20).optional(),
+	devices: r.array(r.enum([
+		"camera",
+		"microphone",
+		"geolocation",
+		"serial",
+		"bluetooth"
+	])).max(5).optional()
+}), p = r.looseObject({
+	protocol: s,
+	set: r.enum([
+		"required",
+		"optional",
+		"none"
+	]).optional(),
+	modes: r.looseObject({
+		solo: r.looseObject({}).optional(),
+		multiplayer: l.optional()
+	}),
+	settings: r.array(e).optional(),
+	settingsScreen: r.looseObject({ size: r.enum(["compact", "large"]) }).optional(),
+	display: r.looseObject({ orientation: r.enum([
+		"any",
+		"portrait",
+		"landscape"
+	]).optional() }).optional(),
+	permissions: f.optional(),
+	services: r.array(d).max(20).optional()
+}).refine((e) => e.modes.solo !== void 0 || e.modes.multiplayer !== void 0, {
+	message: "modes must declare \"solo\" and/or \"multiplayer\"",
+	path: ["modes"]
+}).refine((e) => e.settingsScreen === void 0 || e.modes.multiplayer !== void 0, {
+	message: "settingsScreen is only used in the multiplayer lobby; declare modes.multiplayer or remove it",
+	path: ["settingsScreen"]
+}).refine((e) => {
+	let t = (e.settings ?? []).map((e) => e.id);
+	return new Set(t).size === t.length;
+}, {
+	message: "Setting ids must be unique",
+	path: ["settings"]
+});
+function m(e) {
+	let t = [], r = i.safeParse(e);
+	r.success || t.push(...a(r.error));
+	let s = e?.appSpecific?.memizy;
+	if (s === void 0) t.push("appSpecific.memizy: Missing the Memizy runtime block (protocol, modes, …)");
+	else {
+		let e = p.safeParse(s);
+		e.success || t.push(...a(e.error).map((e) => `appSpecific.memizy.${e}`));
+	}
+	if (t.length > 0) return {
+		success: !1,
+		errors: t
+	};
+	let c = o(e), l = n(c.appSpecific.memizy), u = c.capabilities.types;
+	return l.set !== "none" && (!Array.isArray(u) || u.length === 0) ? {
+		success: !1,
+		errors: ["capabilities.types: Declare the item types the game shows, or \"set\": \"none\" in appSpecific.memizy for a game without questions."]
+	} : {
+		success: !0,
+		manifest: c,
+		runtime: l
+	};
+}
+var h = class extends Error {
+	errors;
+	constructor(e) {
+		super(`Invalid plugin manifest:\n${e.join("\n")}`), this.name = "PluginManifestError", this.errors = e;
+	}
+};
+function g(e) {
+	let t = m(e);
+	if (!t.success) throw new h(t.errors);
+	return {
+		manifest: t.manifest,
+		runtime: t.runtime
+	};
+}
+function _(e) {
+	let n = t(e);
+	return n.success ? m(n.data) : {
+		success: !1,
+		errors: [n.error]
+	};
+}
+//#endregion
+export { c as HostAsSchema, p as MemizyRuntimeSchema, l as MultiplayerModeSchema, h as PluginManifestError, f as PluginPermissionsSchema, d as ServiceNameSchema, g as parsePluginManifest, _ as readPluginManifestFromHtml, m as safeParsePluginManifest };

package/dist/pluginRuntime.cjs

@@ -0,0 +1 @@
+var e=/<script\b[^>]*\btype\s*=\s*["']application\/oqse-manifest\+json["'][^>]*>([\s\S]*?)<\/script\s*>/i;function t(t){let n=e.exec(t);if(!n)return{success:!1,error:`No <script type="application/oqse-manifest+json"> data island found.`};try{return{success:!0,data:JSON.parse(n[1])}}catch(e){return{success:!1,error:`The manifest data island is not valid JSON: ${e.message}`}}}function n(e){let t=e.modes.multiplayer,n=t?{players:{min:t.players.min,max:t.players.max,...t.players.recommended!==void 0&&{recommended:t.players.recommended}},hostAs:[...t.hostAs],lateJoin:t.lateJoin??!0}:null,r=[];return e.modes.solo&&r.push(`solo`),n?.hostAs.includes(`presenter`)&&r.push(`board`),n&&r.push(`controller`),n&&e.settingsScreen&&r.push(`settings`),{protocol:e.protocol,set:e.set??`required`,solo:e.modes.solo!==void 0,multiplayer:n,settings:e.settings??[],settingsScreen:e.settingsScreen?{size:e.settingsScreen.size}:null,orientation:e.display?.orientation??`any`,views:r,permissions:{network:[...new Set(e.permissions?.network??[])],devices:[...new Set(e.permissions?.devices??[])]},services:[...new Set(e.services??[])]}}exports.extractManifestFromHtml=t,exports.toRuntime=n;

package/dist/pluginRuntime.js

@@ -0,0 +1,48 @@
+//#region src/pluginRuntime.ts
+var e = /<script\b[^>]*\btype\s*=\s*["']application\/oqse-manifest\+json["'][^>]*>([\s\S]*?)<\/script\s*>/i;
+function t(t) {
+	let n = e.exec(t);
+	if (!n) return {
+		success: !1,
+		error: "No <script type=\"application/oqse-manifest+json\"> data island found."
+	};
+	try {
+		return {
+			success: !0,
+			data: JSON.parse(n[1])
+		};
+	} catch (e) {
+		return {
+			success: !1,
+			error: `The manifest data island is not valid JSON: ${e.message}`
+		};
+	}
+}
+function n(e) {
+	let t = e.modes.multiplayer, n = t ? {
+		players: {
+			min: t.players.min,
+			max: t.players.max,
+			...t.players.recommended !== void 0 && { recommended: t.players.recommended }
+		},
+		hostAs: [...t.hostAs],
+		lateJoin: t.lateJoin ?? !0
+	} : null, r = [];
+	return e.modes.solo && r.push("solo"), n?.hostAs.includes("presenter") && r.push("board"), n && r.push("controller"), n && e.settingsScreen && r.push("settings"), {
+		protocol: e.protocol,
+		set: e.set ?? "required",
+		solo: e.modes.solo !== void 0,
+		multiplayer: n,
+		settings: e.settings ?? [],
+		settingsScreen: e.settingsScreen ? { size: e.settingsScreen.size } : null,
+		orientation: e.display?.orientation ?? "any",
+		views: r,
+		permissions: {
+			network: [...new Set(e.permissions?.network ?? [])],
+			devices: [...new Set(e.permissions?.devices ?? [])]
+		},
+		services: [...new Set(e.services ?? [])]
+	};
+}
+//#endregion
+export { t as extractManifestFromHtml, n as toRuntime };

package/dist/polyfills.cjs

@@ -0,0 +1 @@
+function e(){typeof Promise.withResolvers!=`function`&&Object.defineProperty(Promise,"withResolvers",{configurable:!0,writable:!0,value:function(){let e,t;return{promise:new this((n,r)=>{e=n,t=r}),resolve:e,reject:t}}}),typeof Object.hasOwn!=`function`&&Object.defineProperty(Object,"hasOwn",{configurable:!0,writable:!0,value:(e,t)=>Object.prototype.hasOwnProperty.call(e,t)})}exports.ensureConnectionPolyfills=e;

package/dist/polyfills.js

@@ -0,0 +1,23 @@
+//#region src/polyfills.ts
+function e() {
+	typeof Promise.withResolvers != "function" && Object.defineProperty(Promise, "withResolvers", {
+		configurable: !0,
+		writable: !0,
+		value: function() {
+			let e, t;
+			return {
+				promise: new this((n, r) => {
+					e = n, t = r;
+				}),
+				resolve: e,
+				reject: t
+			};
+		}
+	}), typeof Object.hasOwn != "function" && Object.defineProperty(Object, "hasOwn", {
+		configurable: !0,
+		writable: !0,
+		value: (e, t) => Object.prototype.hasOwnProperty.call(e, t)
+	});
+}
+//#endregion
+export { e as ensureConnectionPolyfills };

package/dist/relay.cjs

@@ -0,0 +1 @@
+var e=1,t={frameBytes:2097152,bundleBytes:8388608,playersPerRoom:100,playerFramesPerSecond:60,playerFrameBurst:120,hostFramesPerSecond:3e3,hostFrameBurst:6e3,nameLength:32,hostAwayMs:6e5,roomTtlMs:216e5};function n(e){return typeof e==`string`?e.replace(/\s+/g,` `).trim().slice(0,t.nameLength):``}function r(e){return typeof e==`string`&&/^\d{6}$/.test(e)}exports.RELAY_LIMITS=t,exports.RELAY_PROTOCOL=e,exports.isPin=r,exports.normalizePlayerName=n;

package/dist/relay.js

@@ -0,0 +1,21 @@
+//#region src/relay.ts
+var e = 1, t = {
+	frameBytes: 2097152,
+	bundleBytes: 8388608,
+	playersPerRoom: 100,
+	playerFramesPerSecond: 60,
+	playerFrameBurst: 120,
+	hostFramesPerSecond: 3e3,
+	hostFrameBurst: 6e3,
+	nameLength: 32,
+	hostAwayMs: 6e5,
+	roomTtlMs: 216e5
+};
+function n(e) {
+	return typeof e == "string" ? e.replace(/\s+/g, " ").trim().slice(0, t.nameLength) : "";
+}
+function r(e) {
+	return typeof e == "string" && /^\d{6}$/.test(e);
+}
+//#endregion
+export { t as RELAY_LIMITS, e as RELAY_PROTOCOL, r as isPin, n as normalizePlayerName };

package/dist/schemas.cjs

@@ -0,0 +1 @@
+const e=require("./errors.cjs");let t=require("zod"),n=require("@memizy/oqse");var r=e=>t.z.string().min(1).max(e),i=t.z.string().min(1).max(128),a=t.z.looseObject({protocol:t.z.string().regex(/^\d+\.\d+$/,`protocol must be in MAJOR.MINOR format`),sdk:t.z.looseObject({name:r(200),version:r(100)}),plugin:t.z.looseObject({id:r(500),version:r(100)}),features:t.z.array(r(100)).max(100)}),o=t.z.looseObject({to:t.z.union([t.z.literal(`authority`),t.z.literal(`all`),t.z.array(i).min(1).max(500)]),data:t.z.unknown()}),s=t.z.looseObject({playerId:i.optional(),itemId:r(128),isCorrect:t.z.boolean(),confidence:t.z.union([t.z.literal(1),t.z.literal(2),t.z.literal(3),t.z.literal(4)]).optional(),timeSpentMs:t.z.number().int().nonnegative().optional(),hintsUsed:t.z.number().int().nonnegative().optional(),isSkipped:t.z.boolean().optional(),answer:t.z.unknown().optional(),item:t.z.looseObject({id:r(128),type:r(64)}).optional()}).refine(e=>!e.item||e.item.id===e.itemId,{message:`item.id must equal itemId`,path:[`item`,`id`]}),c=t.z.record(r(128),n.ProgressRecordSchema),l=t.z.enum([`plugin`,`set`]),u=t.z.looseObject({values:t.z.record(t.z.string(),t.z.unknown()),valid:t.z.boolean(),message:t.z.string().max(500).optional()}),d=t.z.looseObject({scores:t.z.record(i,t.z.number().finite()).optional(),summary:t.z.string().max(1e3).optional()}),f=t.z.looseObject({height:t.z.union([t.z.number().positive().max(1e5),t.z.literal(`auto`)])}),p=t.z.looseObject({code:r(100),message:t.z.string().max(2e3),context:t.z.record(t.z.string(),t.z.unknown()).optional()}),m={hello:t.z.tuple([a]),ready:t.z.tuple([]),send:t.z.tuple([o]),saveSnapshot:t.z.tuple([t.z.unknown()]),recordAnswer:t.z.tuple([s]),saveProgress:t.z.tuple([c]),saveData:t.z.tuple([l,t.z.unknown()]),updateSettings:t.z.tuple([u]),getAsset:t.z.tuple([r(200),r(128).optional()]),end:t.z.tuple([d]),resize:t.z.tuple([f]),reportError:t.z.tuple([p]),exit:t.z.tuple([]),service:t.z.tuple([r(100),t.z.unknown()])};function h(t,r){let i=m[t].safeParse(r);if(!i.success)throw new e.ProtocolError(`INVALID_ARGUMENT`,`${t}: ${(0,n.formatOQSEErrors)(i.error).join(`; `)}`);return i.data}exports.AddressSchema=i,exports.AnswerRecordSchema=s,exports.DataScopeSchema=l,exports.ErrorReportSchema=p,exports.HOST_API_ARGS=m,exports.HandshakeSchema=a,exports.OutgoingMessageSchema=o,exports.ProgressRecordsSchema=c,exports.ResizeRequestSchema=f,exports.SessionResultSchema=d,exports.SettingsUpdateSchema=u,exports.parseHostCall=h;

package/dist/schemas.js

@@ -0,0 +1,77 @@
+import { ProtocolError as e } from "./errors.js";
+import { z as t } from "zod";
+import { ProgressRecordSchema as n, formatOQSEErrors as r } from "@memizy/oqse";
+//#region src/schemas.ts
+var i = (e) => t.string().min(1).max(e), a = t.string().min(1).max(128), o = t.looseObject({
+	protocol: t.string().regex(/^\d+\.\d+$/, "protocol must be in MAJOR.MINOR format"),
+	sdk: t.looseObject({
+		name: i(200),
+		version: i(100)
+	}),
+	plugin: t.looseObject({
+		id: i(500),
+		version: i(100)
+	}),
+	features: t.array(i(100)).max(100)
+}), s = t.looseObject({
+	to: t.union([
+		t.literal("authority"),
+		t.literal("all"),
+		t.array(a).min(1).max(500)
+	]),
+	data: t.unknown()
+}), c = t.looseObject({
+	playerId: a.optional(),
+	itemId: i(128),
+	isCorrect: t.boolean(),
+	confidence: t.union([
+		t.literal(1),
+		t.literal(2),
+		t.literal(3),
+		t.literal(4)
+	]).optional(),
+	timeSpentMs: t.number().int().nonnegative().optional(),
+	hintsUsed: t.number().int().nonnegative().optional(),
+	isSkipped: t.boolean().optional(),
+	answer: t.unknown().optional(),
+	item: t.looseObject({
+		id: i(128),
+		type: i(64)
+	}).optional()
+}).refine((e) => !e.item || e.item.id === e.itemId, {
+	message: "item.id must equal itemId",
+	path: ["item", "id"]
+}), l = t.record(i(128), n), u = t.enum(["plugin", "set"]), d = t.looseObject({
+	values: t.record(t.string(), t.unknown()),
+	valid: t.boolean(),
+	message: t.string().max(500).optional()
+}), f = t.looseObject({
+	scores: t.record(a, t.number().finite()).optional(),
+	summary: t.string().max(1e3).optional()
+}), p = t.looseObject({ height: t.union([t.number().positive().max(1e5), t.literal("auto")]) }), m = t.looseObject({
+	code: i(100),
+	message: t.string().max(2e3),
+	context: t.record(t.string(), t.unknown()).optional()
+}), h = {
+	hello: t.tuple([o]),
+	ready: t.tuple([]),
+	send: t.tuple([s]),
+	saveSnapshot: t.tuple([t.unknown()]),
+	recordAnswer: t.tuple([c]),
+	saveProgress: t.tuple([l]),
+	saveData: t.tuple([u, t.unknown()]),
+	updateSettings: t.tuple([d]),
+	getAsset: t.tuple([i(200), i(128).optional()]),
+	end: t.tuple([f]),
+	resize: t.tuple([p]),
+	reportError: t.tuple([m]),
+	exit: t.tuple([]),
+	service: t.tuple([i(100), t.unknown()])
+};
+function g(t, n) {
+	let i = h[t].safeParse(n);
+	if (!i.success) throw new e("INVALID_ARGUMENT", `${t}: ${r(i.error).join("; ")}`);
+	return i.data;
+}
+//#endregion
+export { a as AddressSchema, c as AnswerRecordSchema, u as DataScopeSchema, m as ErrorReportSchema, h as HOST_API_ARGS, o as HandshakeSchema, s as OutgoingMessageSchema, l as ProgressRecordsSchema, p as ResizeRequestSchema, f as SessionResultSchema, d as SettingsUpdateSchema, g as parseHostCall };

package/dist/security.cjs

@@ -0,0 +1 @@
+var e=[`https://cdn.jsdelivr.net`,`https://unpkg.com`,`https://cdnjs.cloudflare.com`,`https://esm.sh`],t=[`https://fonts.googleapis.com`,`https://fonts.gstatic.com`],n=[`camera`,`microphone`,`geolocation`,`serial`,`bluetooth`];function r(n,r){let i=r&&/^https?:\/\//.test(r)?[r]:[],a=n?.permissions.network??[],o=(...e)=>[...new Set(e.flat())].join(` `);return[`default-src 'none'`,`script-src 'unsafe-inline' 'wasm-unsafe-eval' blob: ${o(e,i)}`,`style-src 'unsafe-inline' ${o(e,t,i)}`,`font-src data: ${o(e,t,i)}`,`img-src data: blob: https:`,`media-src data: blob: https:`,`connect-src data: blob: ${o(e,i,a)}`,`worker-src blob: ${o(e,i)}`,`frame-src 'none'`,`form-action 'none'`,`base-uri 'none'`].join(`; `)}function i(e){return(e?.permissions.devices??[]).map(e=>`${e} *`).join(`; `)}function a(e,t){let n=`<meta http-equiv="Content-Security-Policy" content="${t.replace(/"/g,`&quot;`)}">`,r=/<head\b[^>]*>/i.exec(e);if(r)return e.slice(0,r.index+r[0].length)+n+e.slice(r.index+r[0].length);let i=/^\s*<!doctype[^>]*>/i.exec(e);return i?e.slice(0,i[0].length)+`<head>${n}</head>`+e.slice(i[0].length):`<head>${n}</head>${e}`}exports.LIBRARY_ORIGINS=e,exports.PLUGIN_DEVICES=n,exports.injectContentPolicy=a,exports.pluginAllowAttribute=i,exports.pluginContentPolicy=r;

package/dist/security.js

@@ -0,0 +1,40 @@
+//#region src/security.ts
+var e = [
+	"https://cdn.jsdelivr.net",
+	"https://unpkg.com",
+	"https://cdnjs.cloudflare.com",
+	"https://esm.sh"
+], t = ["https://fonts.googleapis.com", "https://fonts.gstatic.com"], n = [
+	"camera",
+	"microphone",
+	"geolocation",
+	"serial",
+	"bluetooth"
+];
+function r(n, r) {
+	let i = r && /^https?:\/\//.test(r) ? [r] : [], a = n?.permissions.network ?? [], o = (...e) => [...new Set(e.flat())].join(" ");
+	return [
+		"default-src 'none'",
+		`script-src 'unsafe-inline' 'wasm-unsafe-eval' blob: ${o(e, i)}`,
+		`style-src 'unsafe-inline' ${o(e, t, i)}`,
+		`font-src data: ${o(e, t, i)}`,
+		"img-src data: blob: https:",
+		"media-src data: blob: https:",
+		`connect-src data: blob: ${o(e, i, a)}`,
+		`worker-src blob: ${o(e, i)}`,
+		"frame-src 'none'",
+		"form-action 'none'",
+		"base-uri 'none'"
+	].join("; ");
+}
+function i(e) {
+	return (e?.permissions.devices ?? []).map((e) => `${e} *`).join("; ");
+}
+function a(e, t) {
+	let n = `<meta http-equiv="Content-Security-Policy" content="${t.replace(/"/g, "&quot;")}">`, r = /<head\b[^>]*>/i.exec(e);
+	if (r) return e.slice(0, r.index + r[0].length) + n + e.slice(r.index + r[0].length);
+	let i = /^\s*<!doctype[^>]*>/i.exec(e);
+	return i ? e.slice(0, i[0].length) + `<head>${n}</head>` + e.slice(i[0].length) : `<head>${n}</head>${e}`;
+}
+//#endregion
+export { e as LIBRARY_ORIGINS, n as PLUGIN_DEVICES, a as injectContentPolicy, i as pluginAllowAttribute, r as pluginContentPolicy };

package/dist/settings.cjs

@@ -0,0 +1 @@
+function e(e,t){switch(e.type){case`number`:return typeof t!=`number`||!Number.isFinite(t)?`must be a number`:e.min!==void 0&&t<e.min?`must be at least ${e.min}`:e.max!==void 0&&t>e.max?`must be at most ${e.max}`:null;case`boolean`:return typeof t==`boolean`?null:`must be true or false`;case`select`:return e.options.some(e=>e.value===t)?null:`must be one of the options`;case`text`:return typeof t==`string`?e.maxLength!==void 0&&t.length>e.maxLength?`must be at most ${e.maxLength} characters`:null:`must be text`}}function t(t,n={}){let r={},i=[];for(let a of t){if(!(a.id in n)){r[a.id]=a.default;continue}let t=e(a,n[a.id]);t?(i.push(`${a.id}: ${t}`),r[a.id]=a.default):r[a.id]=n[a.id]}for(let e of Object.keys(n))t.some(t=>t.id===e)||i.push(`${e}: unknown setting`);return{values:r,errors:i}}function n(e,t){return e.filter(e=>!e.modes||e.modes.includes(t))}function r(e,t){if(typeof e==`string`)return e;let n=t.split(`-`)[0];return e[t]??e[n]??e.en??Object.values(e)[0]}exports.localize=r,exports.resolveSettings=t,exports.settingsForMode=n,exports.validateSettingValue=e;

package/dist/settings.js

@@ -0,0 +1,35 @@
+//#region src/settings.ts
+function e(e, t) {
+	switch (e.type) {
+		case "number": return typeof t != "number" || !Number.isFinite(t) ? "must be a number" : e.min !== void 0 && t < e.min ? `must be at least ${e.min}` : e.max !== void 0 && t > e.max ? `must be at most ${e.max}` : null;
+		case "boolean": return typeof t == "boolean" ? null : "must be true or false";
+		case "select": return e.options.some((e) => e.value === t) ? null : "must be one of the options";
+		case "text": return typeof t == "string" ? e.maxLength !== void 0 && t.length > e.maxLength ? `must be at most ${e.maxLength} characters` : null : "must be text";
+	}
+}
+function t(t, n = {}) {
+	let r = {}, i = [];
+	for (let a of t) {
+		if (!(a.id in n)) {
+			r[a.id] = a.default;
+			continue;
+		}
+		let t = e(a, n[a.id]);
+		t ? (i.push(`${a.id}: ${t}`), r[a.id] = a.default) : r[a.id] = n[a.id];
+	}
+	for (let e of Object.keys(n)) t.some((t) => t.id === e) || i.push(`${e}: unknown setting`);
+	return {
+		values: r,
+		errors: i
+	};
+}
+function n(e, t) {
+	return e.filter((e) => !e.modes || e.modes.includes(t));
+}
+function r(e, t) {
+	if (typeof e == "string") return e;
+	let n = t.split("-")[0];
+	return e[t] ?? e[n] ?? e.en ?? Object.values(e)[0];
+}
+//#endregion
+export { r as localize, t as resolveSettings, n as settingsForMode, e as validateSettingValue };

package/dist/settingsSchema.cjs

@@ -0,0 +1 @@
+let e=require("zod");var t=e.z.union([e.z.string().min(1,`Text must not be empty`),e.z.record(e.z.string().min(2),e.z.string().min(1)).refine(e=>Object.keys(e).length>0,`Localized text needs at least one language`)]),n={id:e.z.string().regex(/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/,`Setting id must start with a letter and contain only letters, digits, "_" and "-"`),label:t,description:t.optional(),modes:e.z.array(e.z.enum([`solo`,`multiplayer`])).min(1,`modes needs at least one mode`).optional()},r=e.z.looseObject({...n,type:e.z.literal(`number`),default:e.z.number().finite(),min:e.z.number().finite().optional(),max:e.z.number().finite().optional(),step:e.z.number().positive().optional()}).refine(e=>e.min===void 0||e.max===void 0||e.min<=e.max,{message:`min must not be greater than max`,path:[`min`]}).refine(e=>(e.min===void 0||e.default>=e.min)&&(e.max===void 0||e.default<=e.max),{message:`default is outside min/max`,path:[`default`]}),i=e.z.looseObject({...n,type:e.z.literal(`boolean`),default:e.z.boolean()}),a=e.z.union([e.z.string(),e.z.number().finite(),e.z.boolean()]),o=e.z.looseObject({...n,type:e.z.literal(`select`),options:e.z.array(e.z.looseObject({value:a,label:t})).min(1,`A select setting needs at least one option`),default:a}).refine(e=>new Set(e.options.map(e=>e.value)).size===e.options.length,{message:`Option values must be unique`,path:[`options`]}).refine(e=>e.options.some(t=>t.value===e.default),{message:`default must be one of the option values`,path:[`default`]}),s=e.z.looseObject({...n,type:e.z.literal(`text`),default:e.z.string(),maxLength:e.z.number().int().positive().optional()}).refine(e=>e.maxLength===void 0||e.default.length<=e.maxLength,{message:`default is longer than maxLength`,path:[`default`]}),c=e.z.discriminatedUnion(`type`,[r,i,o,s]);exports.LocalizedTextSchema=t,exports.SettingDefinitionSchema=c;

package/dist/settingsSchema.js

@@ -0,0 +1,58 @@
+import { z as e } from "zod";
+//#region src/settingsSchema.ts
+var t = e.union([e.string().min(1, "Text must not be empty"), e.record(e.string().min(2), e.string().min(1)).refine((e) => Object.keys(e).length > 0, "Localized text needs at least one language")]), n = {
+	id: e.string().regex(/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/, "Setting id must start with a letter and contain only letters, digits, \"_\" and \"-\""),
+	label: t,
+	description: t.optional(),
+	modes: e.array(e.enum(["solo", "multiplayer"])).min(1, "modes needs at least one mode").optional()
+}, r = e.looseObject({
+	...n,
+	type: e.literal("number"),
+	default: e.number().finite(),
+	min: e.number().finite().optional(),
+	max: e.number().finite().optional(),
+	step: e.number().positive().optional()
+}).refine((e) => e.min === void 0 || e.max === void 0 || e.min <= e.max, {
+	message: "min must not be greater than max",
+	path: ["min"]
+}).refine((e) => (e.min === void 0 || e.default >= e.min) && (e.max === void 0 || e.default <= e.max), {
+	message: "default is outside min/max",
+	path: ["default"]
+}), i = e.looseObject({
+	...n,
+	type: e.literal("boolean"),
+	default: e.boolean()
+}), a = e.union([
+	e.string(),
+	e.number().finite(),
+	e.boolean()
+]), o = e.looseObject({
+	...n,
+	type: e.literal("select"),
+	options: e.array(e.looseObject({
+		value: a,
+		label: t
+	})).min(1, "A select setting needs at least one option"),
+	default: a
+}).refine((e) => new Set(e.options.map((e) => e.value)).size === e.options.length, {
+	message: "Option values must be unique",
+	path: ["options"]
+}).refine((e) => e.options.some((t) => t.value === e.default), {
+	message: "default must be one of the option values",
+	path: ["default"]
+}), s = e.looseObject({
+	...n,
+	type: e.literal("text"),
+	default: e.string(),
+	maxLength: e.number().int().positive().optional()
+}).refine((e) => e.maxLength === void 0 || e.default.length <= e.maxLength, {
+	message: "default is longer than maxLength",
+	path: ["default"]
+}), c = e.discriminatedUnion("type", [
+	r,
+	i,
+	o,
+	s
+]);
+//#endregion
+export { t as LocalizedTextSchema, c as SettingDefinitionSchema };