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

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./version.cjs"),t=require("./errors.cjs"),n=require("./limits.cjs"),r=require("./settingsSchema.cjs"),i=require("./settings.cjs"),a=require("./pluginRuntime.cjs"),o=require("./manifestSchema.cjs"),s=require("./types.cjs"),c=require("./schemas.cjs"),l=require("./relay.cjs"),u=require("./items.cjs"),d=require("./security.cjs");exports.AddressSchema=c.AddressSchema,exports.AnswerRecordSchema=c.AnswerRecordSchema,exports.BOARD_ADDRESS=s.BOARD_ADDRESS,exports.DataScopeSchema=c.DataScopeSchema,exports.ErrorReportSchema=c.ErrorReportSchema,exports.HOST_API_METHODS=s.HOST_API_METHODS,exports.HandshakeSchema=c.HandshakeSchema,exports.HostAsSchema=o.HostAsSchema,exports.LIMITS=n.LIMITS,exports.LocalizedTextSchema=r.LocalizedTextSchema,exports.MemizyRuntimeSchema=o.MemizyRuntimeSchema,exports.MultiplayerModeSchema=o.MultiplayerModeSchema,exports.OutgoingMessageSchema=c.OutgoingMessageSchema,exports.PLUGIN_API_METHODS=s.PLUGIN_API_METHODS,exports.PLUGIN_DEVICES=d.PLUGIN_DEVICES,exports.PROTOCOL_ERROR_CODES=t.PROTOCOL_ERROR_CODES,exports.PROTOCOL_VERSION=e.PROTOCOL_VERSION,exports.PluginManifestError=o.PluginManifestError,exports.PluginPermissionsSchema=o.PluginPermissionsSchema,exports.ProtocolError=t.ProtocolError,exports.RELAY_PROTOCOL=l.RELAY_PROTOCOL,exports.SERVER_ADDRESS=s.SERVER_ADDRESS,exports.SETTINGS_ADDRESS=s.SETTINGS_ADDRESS,exports.ServiceNameSchema=o.ServiceNameSchema,exports.SessionResultSchema=c.SessionResultSchema,exports.SettingDefinitionSchema=r.SettingDefinitionSchema,exports.SettingsUpdateSchema=c.SettingsUpdateSchema,exports.compareProtocolVersions=e.compareProtocolVersions,exports.extractManifestFromHtml=a.extractManifestFromHtml,exports.isProtocolErrorCode=t.isProtocolErrorCode,exports.isProtocolSupported=e.isProtocolSupported,exports.localize=i.localize,exports.negotiateProtocolVersion=e.negotiateProtocolVersion,exports.parsePluginManifest=o.parsePluginManifest,exports.parseProtocolVersion=e.parseProtocolVersion,exports.prepareDisplaySet=u.prepareDisplaySet,exports.readPluginManifestFromHtml=o.readPluginManifestFromHtml,exports.resolveSettings=i.resolveSettings,exports.safeParsePluginManifest=o.safeParsePluginManifest,exports.settingsForMode=i.settingsForMode,exports.toProtocolError=t.toProtocolError,exports.validateSettingValue=i.validateSettingValue;

package/dist/index.js

@@ -0,0 +1,13 @@
+import { PROTOCOL_VERSION as e, compareProtocolVersions as t, isProtocolSupported as n, negotiateProtocolVersion as r, parseProtocolVersion as i } from "./version.js";
+import { PROTOCOL_ERROR_CODES as a, ProtocolError as o, isProtocolErrorCode as s, toProtocolError as c } from "./errors.js";
+import { LIMITS as l } from "./limits.js";
+import { LocalizedTextSchema as u, SettingDefinitionSchema as d } from "./settingsSchema.js";
+import { localize as f, resolveSettings as p, settingsForMode as m, validateSettingValue as h } from "./settings.js";
+import { extractManifestFromHtml as g } from "./pluginRuntime.js";
+import { HostAsSchema as _, MemizyRuntimeSchema as v, MultiplayerModeSchema as y, PluginManifestError as b, PluginPermissionsSchema as x, ServiceNameSchema as S, parsePluginManifest as C, readPluginManifestFromHtml as w, safeParsePluginManifest as T } from "./manifestSchema.js";
+import { BOARD_ADDRESS as E, HOST_API_METHODS as D, PLUGIN_API_METHODS as O, SERVER_ADDRESS as k, SETTINGS_ADDRESS as A } from "./types.js";
+import { AddressSchema as j, AnswerRecordSchema as M, DataScopeSchema as N, ErrorReportSchema as P, HandshakeSchema as F, OutgoingMessageSchema as I, SessionResultSchema as L, SettingsUpdateSchema as R } from "./schemas.js";
+import { RELAY_PROTOCOL as z } from "./relay.js";
+import { prepareDisplaySet as B } from "./items.js";
+import { PLUGIN_DEVICES as V } from "./security.js";
+export { j as AddressSchema, M as AnswerRecordSchema, E as BOARD_ADDRESS, N as DataScopeSchema, P as ErrorReportSchema, D as HOST_API_METHODS, F as HandshakeSchema, _ as HostAsSchema, l as LIMITS, u as LocalizedTextSchema, v as MemizyRuntimeSchema, y as MultiplayerModeSchema, I as OutgoingMessageSchema, O as PLUGIN_API_METHODS, V as PLUGIN_DEVICES, a as PROTOCOL_ERROR_CODES, e as PROTOCOL_VERSION, b as PluginManifestError, x as PluginPermissionsSchema, o as ProtocolError, z as RELAY_PROTOCOL, k as SERVER_ADDRESS, A as SETTINGS_ADDRESS, S as ServiceNameSchema, L as SessionResultSchema, d as SettingDefinitionSchema, R as SettingsUpdateSchema, t as compareProtocolVersions, g as extractManifestFromHtml, s as isProtocolErrorCode, n as isProtocolSupported, f as localize, r as negotiateProtocolVersion, C as parsePluginManifest, i as parseProtocolVersion, B as prepareDisplaySet, w as readPluginManifestFromHtml, p as resolveSettings, T as safeParsePluginManifest, m as settingsForMode, c as toProtocolError, h as validateSettingValue };

package/dist/internal.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./limits.cjs"),t=require("./pluginRuntime.cjs"),n=require("./schemas.cjs"),r=require("./relay.cjs"),i=require("./items.cjs"),a=require("./security.cjs"),o=require("./polyfills.cjs");exports.HOST_API_ARGS=n.HOST_API_ARGS,exports.LIBRARY_ORIGINS=a.LIBRARY_ORIGINS,exports.RELAY_LIMITS=r.RELAY_LIMITS,exports.RateLimiter=e.RateLimiter,exports.assertJsonWithin=e.assertJsonWithin,exports.displayItem=i.displayItem,exports.ensureConnectionPolyfills=o.ensureConnectionPolyfills,exports.findNonJson=e.findNonJson,exports.injectContentPolicy=a.injectContentPolicy,exports.isPin=r.isPin,exports.jsonByteSize=e.jsonByteSize,exports.normalizePlayerName=r.normalizePlayerName,exports.parseHostCall=n.parseHostCall,exports.pluginAllowAttribute=a.pluginAllowAttribute,exports.pluginContentPolicy=a.pluginContentPolicy,exports.publicItem=i.publicItem,exports.seededRandom=i.seededRandom,exports.toRuntime=t.toRuntime;

package/dist/internal.js

@@ -0,0 +1,8 @@
+import { RateLimiter as e, assertJsonWithin as t, findNonJson as n, jsonByteSize as r } from "./limits.js";
+import { toRuntime as i } from "./pluginRuntime.js";
+import { HOST_API_ARGS as a, parseHostCall as o } from "./schemas.js";
+import { RELAY_LIMITS as s, isPin as c, normalizePlayerName as l } from "./relay.js";
+import { displayItem as u, publicItem as d, seededRandom as f } from "./items.js";
+import { LIBRARY_ORIGINS as p, injectContentPolicy as m, pluginAllowAttribute as h, pluginContentPolicy as g } from "./security.js";
+import { ensureConnectionPolyfills as _ } from "./polyfills.js";
+export { a as HOST_API_ARGS, p as LIBRARY_ORIGINS, s as RELAY_LIMITS, e as RateLimiter, t as assertJsonWithin, u as displayItem, _ as ensureConnectionPolyfills, n as findNonJson, m as injectContentPolicy, c as isPin, r as jsonByteSize, l as normalizePlayerName, o as parseHostCall, h as pluginAllowAttribute, g as pluginContentPolicy, d as publicItem, f as seededRandom, i as toRuntime };

package/dist/items.cjs

@@ -0,0 +1 @@
+let e=require("@memizy/oqse");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.prompts=n(a.prompts,i),a.matches=n(a.matches,i),a;case`timeline`:return a.shuffle!==!1&&(a.events=n(a.events,i,t=>(0,e.isTimelineOrderCorrect)(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":[`correctAnswers`],matrix:[`correctCells`],"open-ended":[`sampleAnswer`,`rubric`],"chess-puzzle":[`correctAnswers`]},s=[`options`,`items`,`prompts`,`matches`,`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)}}}exports.displayItem=i,exports.prepareDisplaySet=l,exports.publicItem=c,exports.seededRandom=t;

package/dist/items.js

@@ -0,0 +1,114 @@
+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.prompts = n(a.prompts, i), a.matches = n(a.matches, 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": ["correctAnswers"],
+	matrix: ["correctCells"],
+	"open-ended": ["sampleAnswer", "rubric"],
+	"chess-puzzle": ["correctAnswers"]
+}, s = [
+	"options",
+	"items",
+	"prompts",
+	"matches",
+	"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,answersPerSecond:10,answerBurst:20,serviceBytes:65536,serviceResultBytes:262144,servicesPerMinute:30,assetsPerSecond:10,assetBurst:20,assetBytes:2097152,errorReportsPerSecond:5,errorReportBurst:10},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,73 @@
+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,
+	answersPerSecond: 10,
+	answerBurst: 20,
+	serviceBytes: 65536,
+	serviceResultBytes: 262144,
+	servicesPerMinute: 30,
+	assetsPerSecond: 10,
+	assetBurst: 20,
+	assetBytes: 2097152,
+	errorReportsPerSecond: 5,
+	errorReportBurst: 10
+}, 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:3145728,bundleBytes:8388608,playersPerRoom:100,playerFramesPerSecond:60,playerFrameBurst:120,hostFramesPerSecond:3e3,hostFrameBurst:6e3,nameLength:32,authLength:4096,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,22 @@
+//#region src/relay.ts
+var e = 1, t = {
+	frameBytes: 3145728,
+	bundleBytes: 8388608,
+	playersPerRoom: 100,
+	playerFramesPerSecond: 60,
+	playerFrameBurst: 120,
+	hostFramesPerSecond: 3e3,
+	hostFrameBurst: 6e3,
+	nameLength: 32,
+	authLength: 4096,
+	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.enum([`plugin`,`set`]),l=t.z.looseObject({values:t.z.record(t.z.string(),t.z.unknown()),valid:t.z.boolean(),message:t.z.string().max(500).optional()}),u=t.z.looseObject({scores:t.z.record(i,t.z.number().finite()).optional(),summary:t.z.string().max(1e3).optional()}),d=t.z.looseObject({code:r(100),message:t.z.string().max(2e3),context:t.z.record(t.z.string(),t.z.unknown()).optional()}),f={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]),saveData:t.z.tuple([c,t.z.unknown()]),updateSettings:t.z.tuple([l]),getAsset:t.z.tuple([r(200),r(128).optional()]),end:t.z.tuple([u]),reportError:t.z.tuple([d]),service:t.z.tuple([r(100),t.z.unknown()])};function p(t,r){let i=f[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=c,exports.ErrorReportSchema=d,exports.HOST_API_ARGS=f,exports.HandshakeSchema=a,exports.OutgoingMessageSchema=o,exports.SessionResultSchema=u,exports.SettingsUpdateSchema=l,exports.parseHostCall=p;

package/dist/schemas.js

@@ -0,0 +1,74 @@
+import { ProtocolError as e } from "./errors.js";
+import { z as t } from "zod";
+import { formatOQSEErrors as n } from "@memizy/oqse";
+//#region src/schemas.ts
+var r = (e) => t.string().min(1).max(e), i = t.string().min(1).max(128), a = t.looseObject({
+	protocol: t.string().regex(/^\d+\.\d+$/, "protocol must be in MAJOR.MINOR format"),
+	sdk: t.looseObject({
+		name: r(200),
+		version: r(100)
+	}),
+	plugin: t.looseObject({
+		id: r(500),
+		version: r(100)
+	}),
+	features: t.array(r(100)).max(100)
+}), o = t.looseObject({
+	to: t.union([
+		t.literal("authority"),
+		t.literal("all"),
+		t.array(i).min(1).max(500)
+	]),
+	data: t.unknown()
+}), s = t.looseObject({
+	playerId: i.optional(),
+	itemId: r(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: 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.enum(["plugin", "set"]), l = t.looseObject({
+	values: t.record(t.string(), t.unknown()),
+	valid: t.boolean(),
+	message: t.string().max(500).optional()
+}), u = t.looseObject({
+	scores: t.record(i, t.number().finite()).optional(),
+	summary: t.string().max(1e3).optional()
+}), d = t.looseObject({
+	code: r(100),
+	message: t.string().max(2e3),
+	context: t.record(t.string(), t.unknown()).optional()
+}), f = {
+	hello: t.tuple([a]),
+	ready: t.tuple([]),
+	send: t.tuple([o]),
+	saveSnapshot: t.tuple([t.unknown()]),
+	recordAnswer: t.tuple([s]),
+	saveData: t.tuple([c, t.unknown()]),
+	updateSettings: t.tuple([l]),
+	getAsset: t.tuple([r(200), r(128).optional()]),
+	end: t.tuple([u]),
+	reportError: t.tuple([d]),
+	service: t.tuple([r(100), t.unknown()])
+};
+function p(t, r) {
+	let i = f[t].safeParse(r);
+	if (!i.success) throw new e("INVALID_ARGUMENT", `${t}: ${n(i.error).join("; ")}`);
+	return i.data;
+}
+//#endregion
+export { i as AddressSchema, s as AnswerRecordSchema, c as DataScopeSchema, d as ErrorReportSchema, f as HOST_API_ARGS, a as HandshakeSchema, o as OutgoingMessageSchema, u as SessionResultSchema, l as SettingsUpdateSchema, p 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;