@voltro/plugin-rooms 0.0.0-stage → 0.87.0

package/dist/worldLeases.js

@@ -0,0 +1,78 @@
+import { ProtocolError as e } from "./errors.js";
+import { Effect as t, Option as n } from "effect";
+import { randomUUID as r } from "node:crypto";
+import { HotError as i } from "@voltro/kv/hot/contract";
+//#region src/worldLeases.ts
+var a = /* @__PURE__ */ new WeakMap(), o = /* @__PURE__ */ new WeakSet(), s = (e) => a.get(e), c = (e) => typeof e == "object" && !!e && o.has(e);
+function l() {
+	throw new e({ detail: "Invalid World transition lease admission" });
+}
+var u = (e) => typeof e == "string" && /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,190}$/.test(e) ? e : l(), d = (e) => {
+	(!e || Object.getPrototypeOf(e) !== Object.prototype) && l();
+	for (let t of Reflect.ownKeys(e)) {
+		let n = Object.getOwnPropertyDescriptor(e, t);
+		(typeof t != "string" || ![
+			"namespace",
+			"tenantId",
+			"ttlMs"
+		].includes(t) || !n?.enumerable || !("value" in n)) && l();
+	}
+	let t = e.namespace, n = u(e.tenantId), r = e.ttlMs;
+	return (typeof t != "string" || !/^[A-Za-z0-9][A-Za-z0-9:_-]{0,95}$/.test(t) || !Number.isSafeInteger(r) || r <= 0) && l(), Object.freeze({
+		namespace: t,
+		tenantId: n,
+		ttlMs: r
+	});
+}, f = (s, c) => {
+	let { namespace: f, tenantId: p, ttlMs: m } = d(c);
+	(typeof s.setNx != "function" || typeof s.compareDelete != "function" || typeof s.compareExpire != "function") && l();
+	let h = s.setNx.bind(s), g = s.compareDelete.bind(s), _ = s.compareExpire.bind(s), v = (n) => t.suspend(() => {
+		let r;
+		try {
+			r = n();
+		} catch {
+			return t.fail(new e({ detail: "World transition lease provider refused admission" }));
+		}
+		return t.isEffect(r) ? r.pipe(t.mapError((e) => new i({
+			operation: e.operation,
+			key: "worldTransitionLease",
+			reason: e.reason
+		})), t.flatMap((n) => typeof n == "boolean" ? t.succeed(n) : t.fail(new e({ detail: "Invalid World transition lease result" })))) : t.fail(new e({ detail: "World transition lease provider must return an Effect" }));
+	}), y = (e) => `${f}:wt:${Buffer.from(JSON.stringify([p, u(e)]), "utf8").toString("base64url")}`;
+	return Object.freeze({
+		tenantId: p,
+		acquire: (e) => {
+			let i = y(e);
+			return t.suspend(() => {
+				let e = r();
+				return v(() => h(i, e, m)).pipe(t.map((t) => {
+					if (!t) return n.none();
+					let r = Object.freeze({
+						renew: () => v(() => _(i, e, m)),
+						release: () => v(() => g(i, e))
+					});
+					return a.set(r, e), n.some(r);
+				}));
+			});
+		},
+		verify: (r, i) => t.suspend(() => {
+			let a;
+			try {
+				a = y(r), (typeof i != "string" || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(i)) && l();
+			} catch {
+				return t.fail(new e({ detail: "Invalid World transition lease admission" }));
+			}
+			return v(() => _(a, i, m)).pipe(t.map((e) => {
+				if (!e) return n.none();
+				let t = Object.freeze({ renew: () => v(() => _(a, i, m)) });
+				return o.add(t), n.some(t);
+			}));
+		})
+	});
+}, p = async (t, n) => {
+	let r = d(n);
+	if (!t.connectionRegistry || typeof t.hotStore != "function") throw new e({ detail: "World transition leases require the app-owned registry and tenant HotStore" });
+	return f(await t.hotStore.bind(t)({ tenantId: r.tenantId }), r);
+};
+//#endregion
+export { p as bindWorldTransitionLeases, c as isVerifiedWorldTransitionLease, f as makeWorldTransitionLeases, s as worldTransitionLeaseToken };

package/dist/worldManifest.js

@@ -0,0 +1,25 @@
+//#region src/worldManifest.ts
+var e = Object.freeze({
+	slots: Object.freeze({
+		onWorldChange: Object.freeze({
+			defaultExport: "defaultWorldOnWorldChange",
+			fixtureExport: "worldOnWorldChangeSlotFixture"
+		}),
+		layerPolicy: Object.freeze({
+			defaultExport: "defaultWorldLayerPolicy",
+			fixtureExport: "worldLayerPolicySlotFixture"
+		}),
+		transitionPolicy: Object.freeze({
+			defaultExport: "defaultWorldTransitionPolicy",
+			fixtureExport: "worldTransitionPolicySlotFixture"
+		})
+	}),
+	ports: Object.freeze({ transition: Object.freeze({
+		tagExport: "WorldTransitionPort",
+		fakeLayerExport: "worldTransitionFakeLayer",
+		fixtureExport: "worldTransitionPortFixture"
+	}) }),
+	events: Object.freeze([])
+});
+//#endregion
+export { e as worldSystemContractManifest };

package/dist/worldMovement.js

@@ -0,0 +1,63 @@
+import { ProtocolError as e } from "./errors.js";
+import { captureWorldData as t } from "./worldData.js";
+//#region src/worldMovement.ts
+function n() {
+	throw new e({ detail: "World movement requires finite positions in its acquired source cell" });
+}
+var r = (e) => {
+	let r = t(e, 128);
+	return !Array.isArray(r) || r.length !== 2 || !r.every(Number.isFinite) ? n() : r;
+}, i = (e) => {
+	if (e === 0) return -Number.MIN_VALUE;
+	let t = /* @__PURE__ */ new DataView(/* @__PURE__ */ new ArrayBuffer(8));
+	return t.setFloat64(0, e), t.setBigUint64(0, t.getBigUint64(0) + (e > 0 ? -1n : 1n)), t.getFloat64(0);
+}, a = (e) => {
+	let a = t(e, 256);
+	if (!Array.isArray(a) || a.length !== 2) return n();
+	let o = r(a[0]), s = r(a[1]), c = Object.freeze([i(s[0]), i(s[1])]);
+	if (o[0] >= s[0] || o[1] >= s[1] || c[0] < o[0] || c[1] < o[1]) return n();
+	let l = (e) => e[0] >= o[0] && e[0] < s[0] && e[1] >= o[1] && e[1] < s[1], u = (e, t) => {
+		let i = r(e), a = r(t);
+		if (!l(i)) return n();
+		if (l(a)) return Object.freeze({
+			at: a,
+			clamped: !1
+		});
+		let u = 1;
+		for (let e of [0, 1]) {
+			let t = a[e] - i[e];
+			if (!Number.isFinite(t)) return n();
+			t > 0 && a[e] >= s[e] && (u = Math.min(u, (c[e] - i[e]) / t)), t < 0 && a[e] < o[e] && (u = Math.min(u, (o[e] - i[e]) / t));
+		}
+		let d = Object.freeze([0, 1].map((e) => Math.max(o[e], Math.min(c[e], i[e] + (a[e] - i[e]) * u))));
+		return l(d) ? Object.freeze({
+			at: d,
+			clamped: !0
+		}) : n();
+	};
+	return Object.freeze({
+		bounds: a,
+		approach: (e, t, a) => {
+			let d = r(e), f = r(t);
+			if (!l(d) || !Number.isFinite(a) || a < 0) return n();
+			let p, m = Infinity;
+			for (let e of [0, 1]) {
+				let t = f[e] - d[e];
+				if (!Number.isFinite(t)) return n();
+				if (t === 0) continue;
+				let r = t > 0 ? s[e] - f[e] : f[e] - o[e], i = ((t > 0 ? s[e] : o[e]) - d[e]) / t;
+				r <= a && i < m && (p = e, m = i);
+			}
+			if (p === void 0) return null;
+			let h = p, g = +(h === 0), _ = f[h] > d[h], v = _ ? f[h] >= s[h] : f[h] < o[h], y = [0, 0];
+			return y[h] = _ ? s[h] : i(o[h]), y[g] = Math.max(o[g], Math.min(c[g], d[g] + (f[g] - d[g]) * m)), y.every(Number.isFinite) ? Object.freeze({
+				sourceAt: u(d, f).at,
+				targetAt: Object.freeze(y),
+				crossing: v
+			}) : n();
+		},
+		constrain: u
+	});
+};
+//#endregion
+export { a as makeWorldCellMovement };

package/dist/worldPersistence.js

@@ -0,0 +1,134 @@
+import { BudgetExceeded as e, ProtocolError as t } from "./errors.js";
+import { Effect as n } from "effect";
+import { randomUUID as r } from "node:crypto";
+//#region src/worldPersistence.ts
+function i(e) {
+	throw new t({ detail: e });
+}
+var a = (e) => typeof e == "string" && /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,190}$/.test(e) ? e : i("Invalid World persistence scope"), o = (e) => typeof e == "number" && Number.isSafeInteger(e) && e > 0 && e < 2147483647 ? e : i("Invalid World persistence budget"), s = (e) => {
+	(!e || Object.getPrototypeOf(e) !== Object.prototype) && i("World persistence requires own options");
+	for (let t of Reflect.ownKeys(e)) {
+		let n = Object.getOwnPropertyDescriptor(e, t);
+		(typeof t != "string" || ![
+			"tenantId",
+			"roomId",
+			"maxEntries",
+			"maxRows",
+			"maxDelayMs",
+			"epochNow",
+			"onPersisted"
+		].includes(t) || !n?.enumerable || !("value" in n)) && i("Invalid World persistence option");
+	}
+}, c = (e) => Array.isArray(e) ? e.map(c) : typeof e == "object" && e ? Object.fromEntries(Object.entries(e).sort(([e], [t]) => e < t ? -1 : +(e > t)).map(([e, t]) => [e, c(t)])) : e, l = (e, t) => e.tenantId === t.tenantId && e.entityId === t.entityId && e.source.worldId === t.source.worldId && e.source.zoneId === t.source.zoneId && e.source.layer === t.source.layer && e.source.roomId === t.source.roomId && e.source.epoch === t.source.epoch, u = (r) => n.suspend(() => {
+	let i;
+	try {
+		i = r();
+	} catch (r) {
+		return n.fail(r instanceof e || r instanceof t ? r : new t({ detail: "World persistence operation remains incomplete" }));
+	}
+	return n.isEffect(i) ? i : n.fail(new t({ detail: "World persistence provider requires an Effect" }));
+}), d = (d, f) => {
+	s(f);
+	let p = a(f.tenantId), m = a(f.roomId), h = o(f.maxEntries), g = o(f.maxRows ?? 500), _ = o(f.maxDelayMs ?? 1e3), v = f.epochNow, y = f.onPersisted;
+	(g > h || g > o(d.persistenceBatchRows) || typeof v != "function" || typeof y != "function" || typeof d.capturePersistence != "function" || typeof d.persistBatchFromCommand != "function" || typeof d.observe != "function") && i("World persistence requires complete source and budgets");
+	let b = d.capturePersistence.bind(d), x = d.persistBatchFromCommand.bind(d), S = d.observe.bind(d), C = /* @__PURE__ */ new Map(), w = null, T = 0, E = !1, D = !1, O = !1, k = 0, A = () => {
+		let e = v();
+		return (!Number.isSafeInteger(e) || e < k || e < 0 || e > 864e13) && i("World persistence clock moved backwards or is invalid"), k = e, e;
+	}, j = () => {
+		let e = null;
+		for (let t of C.values()) e = e === null ? t.firstAt : Math.min(e, t.firstAt);
+		for (let t of w?.rows ?? []) e = e === null ? t.firstAt : Math.min(e, t.firstAt);
+		return e;
+	}, M = () => Object.freeze({
+		dirty: C.size,
+		pending: w?.rows.length ?? 0,
+		oldestAt: j(),
+		closing: D,
+		closed: O
+	}), N = (t) => {
+		(D || O) && i("World persistence is closing");
+		let n = b(t), r = n.input;
+		(r.tenantId !== p || r.source.roomId !== m) && i("World persistence snapshot escaped its owner");
+		let a = C.get(r.entityId), o = w?.rows.find((e) => e.input.entityId === r.entityId), s = a ?? o;
+		if (s && (!l(s.input, r) || s.cellId !== n.cellId || s.input.expectedRevision !== r.expectedRevision) && i("World persistence snapshot changed its active owner or revision"), !s && C.size >= h) throw new e({
+			budget: "worldPersistenceEntries",
+			limit: h
+		});
+		T === 2 ** 53 - 1 && i("World persistence generation exhausted"), C.set(r.entityId, Object.freeze({
+			input: r,
+			cellId: n.cellId,
+			generation: ++T,
+			firstAt: s?.firstAt ?? A()
+		}));
+	}, P = () => {
+		if (O) return !1;
+		if (w !== null || C.size >= g) return !0;
+		let e = j();
+		return e !== null && A() - e >= _;
+	}, F = (e, t) => {
+		let n = e.input;
+		(t === null || t.tenantId !== p || t.entityId !== n.entityId || t.revision !== n.expectedRevision + 1 || t.worldId !== n.source.worldId || t.zoneId !== n.source.zoneId || t.layer !== n.source.layer || t.cellId !== e.cellId || t.roomId !== m || t.epoch !== n.source.epoch || JSON.stringify(c(t.data)) !== JSON.stringify(c(n.data))) && i("World persistence confirmation lost its exact committed snapshot");
+	}, I = () => u(() => n.gen(function* () {
+		if (w === null) {
+			if (C.size === 0) return;
+			let e = [...C.values()].sort((e, t) => e.input.entityId < t.input.entityId ? -1 : +(e.input.entityId > t.input.entityId)).slice(0, g);
+			w = Object.freeze({
+				rows: Object.freeze(e),
+				origin: Object.freeze({
+					tenantId: p,
+					roomId: m,
+					requestId: `world-persist:${r()}`
+				})
+			});
+		}
+		let e = w;
+		yield* u(() => x(e.rows.map((e) => e.input), e.origin));
+		let t = [];
+		for (let n of e.rows) {
+			let e = yield* u(() => S({
+				tenantId: p,
+				entityId: n.input.entityId
+			}));
+			F(n, e), t.push(e);
+		}
+		A();
+		let n = [];
+		for (let t of e.rows) {
+			let e = C.get(t.input.entityId);
+			!e || e.generation === t.generation ? n.push([t.input.entityId, null]) : n.push([t.input.entityId, Object.freeze({
+				...e,
+				input: b({
+					...e.input,
+					expectedRevision: t.input.expectedRevision + 1
+				}).input
+			})]);
+		}
+		let a;
+		try {
+			a = y(Object.freeze(t));
+		} catch {
+			i("World persistence actor revision update remains incomplete");
+		}
+		a !== void 0 && (a instanceof Promise && a.catch(() => void 0), i("World persistence actor revision update must be synchronous"));
+		for (let [e, t] of n) t === null ? C.delete(e) : C.set(e, t);
+		w = null;
+	})), L = (e) => n.suspend(() => O ? n.void : E ? n.fail(new t({ detail: "World persistence flush is already running" })) : (E = !0, n.uninterruptible(u(e)).pipe(n.ensuring(n.sync(() => {
+		E = !1;
+	}))))), R = () => L(I);
+	return Object.freeze({
+		mark: N,
+		observation: M,
+		isDue: P,
+		flush: R,
+		runDue: () => u(() => P() ? R() : n.void),
+		close: () => L(() => n.gen(function* () {
+			D = !0;
+			let e = Math.ceil(h / g) + 1;
+			for (let t = 0; t < e && (w !== null || C.size > 0); t++) yield* I();
+			if (w !== null || C.size > 0) return yield* n.fail(new t({ detail: "World persistence shutdown retains incomplete batches" }));
+			O = !0;
+		}))
+	});
+};
+//#endregion
+export { d as makeWorldPersistence };

package/dist/worldProjection.js

@@ -0,0 +1,221 @@
+import { BudgetExceeded as e, ProtocolError as t } from "./errors.js";
+import { captureWorldCatalog as n, worldCellAt as r } from "./world.js";
+import { Effect as i, Option as a } from "effect";
+import { HotError as o, readHotStoreWithFallback as s } from "@voltro/kv/hot/contract";
+//#region src/worldProjection.ts
+function c(e) {
+	throw new t({ detail: e });
+}
+var l = (e) => typeof e == "string" && e.length > 0 && e.length <= 191 && e.trim() === e ? e : c("Invalid World projection identity"), u = (e, t = 0) => typeof e == "number" && Number.isSafeInteger(e) && e >= t ? e : c("Invalid World projection counter"), d = (e, t) => {
+	(typeof e != "object" || !e || Object.getPrototypeOf(e) !== Object.prototype) && c("World projection requires plain own data");
+	for (let n of Reflect.ownKeys(e)) {
+		let r = Object.getOwnPropertyDescriptor(e, n);
+		(typeof n != "string" || !t.includes(n) || !r?.enumerable || !("value" in r)) && c("Invalid World projection field");
+	}
+}, f = (e) => {
+	d(e, [
+		"namespace",
+		"tenantId",
+		"world",
+		"ttlMs",
+		"maxEntries",
+		"maxPayloadBytes",
+		"onUnavailable"
+	]);
+	let t = e.namespace, r = l(e.tenantId), i = n([e.world])[0], a = u(e.ttlMs, 1), o = u(e.maxEntries, 1), s = u(e.maxPayloadBytes, 1), f = e.onUnavailable ?? "fail";
+	return (typeof t != "string" || !/^[a-zA-Z0-9][a-zA-Z0-9:_-]{0,95}$/.test(t) || o === 2 ** 53 - 1 || f !== "fail" && f !== "degrade") && c("Invalid World projection namespace, budgets or availability policy"), Object.freeze({
+		namespace: t,
+		tenantId: r,
+		world: i,
+		ttlMs: a,
+		maxEntries: o,
+		maxPayloadBytes: s,
+		onUnavailable: f
+	});
+}, p = (e, t) => {
+	d(e, [
+		"zoneId",
+		"cellId",
+		"layer",
+		"roomId",
+		"hostId",
+		"epoch",
+		"revision",
+		"players",
+		"state"
+	]);
+	let n = (t) => Object.getOwnPropertyDescriptor(e, t)?.value, i = l(n("zoneId")), a = l(n("cellId")), o = t.zones.find((e) => e.id === i);
+	o || c("World projection refers to an unconfigured zone");
+	let s = a.split(":"), f = Number(s[1]), p = Number(s[2]);
+	(s.length !== 3 || s[0] !== i || !Number.isSafeInteger(f) || f < 0 || String(f) !== s[1] || !Number.isSafeInteger(p) || p < 0 || String(p) !== s[2]) && c("Invalid World projection cell");
+	let m = o.cells?.size ?? Math.max(o.bounds[1][0] - o.bounds[0][0], o.bounds[1][1] - o.bounds[0][1]);
+	r(t, {
+		zone: i,
+		at: [o.bounds[0][0] + f * m, o.bounds[0][1] + p * m]
+	}).id !== a && c("World projection escaped configured geometry");
+	let h = u(n("layer"), 1), g = l(n("roomId")), _ = n("hostId"), v = _ === null ? null : l(_), y = u(n("epoch"), 1), b = u(n("revision"), 1), x = u(n("players")), S = n("state");
+	return (S !== "live" && S !== "hibernated" || S === "hibernated" && (v !== null || x !== 0) || S === "live" && v === null || o.layering !== void 0 && x > o.layering.maxPlayers) && c("Contradictory World projection hint"), Object.freeze({
+		zoneId: i,
+		cellId: a,
+		layer: h,
+		roomId: g,
+		hostId: v,
+		epoch: y,
+		revision: b,
+		players: x,
+		state: S
+	});
+}, m = (n, r, l) => {
+	let { namespace: u, tenantId: m, world: h, ttlMs: g, maxEntries: _, maxPayloadBytes: v, onUnavailable: y } = f(l);
+	typeof n.list != "function" && c("World projection requires an actual SQL source");
+	let b = n.list.bind(n), x = `${u}:world-cells:${Buffer.from(JSON.stringify([m, h.name]), "utf8").toString("base64url")}`, S = (t) => {
+		if (!Array.isArray(t) || t.length > _ || Reflect.ownKeys(t).length !== t.length + 1) throw new e({
+			budget: "worldProjectionEntries",
+			limit: _
+		});
+		let n = [], r = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Set();
+		for (let e = 0; e < t.length; e++) {
+			let a = Object.getOwnPropertyDescriptor(t, String(e));
+			(!a || !("value" in a)) && c("World projection entries must be own data");
+			let o = p(a.value, h), s = JSON.stringify([
+				o.zoneId,
+				o.cellId,
+				o.layer
+			]);
+			(r.has(s) || i.has(o.roomId)) && c("Duplicate World projection routing identity"), r.add(s), i.add(o.roomId), n.push(o);
+		}
+		return Object.freeze(n);
+	}, C = () => i.suspend(() => {
+		let n;
+		try {
+			n = b({
+				tenantId: m,
+				worldId: h.name
+			}, _);
+		} catch {
+			return i.fail(new t({ detail: "World projection source admission remains incomplete" }));
+		}
+		return i.isEffect(n) ? n.pipe(i.flatMap((n) => i.try({
+			try: () => {
+				if (!Array.isArray(n) || Object.getPrototypeOf(n) !== Array.prototype || n.length > _ || Reflect.ownKeys(n).length !== n.length + 1) throw new e({
+					budget: "worldProjectionEntries",
+					limit: _
+				});
+				for (let e = 0; e < n.length; e++) {
+					let t = Object.getOwnPropertyDescriptor(n, String(e));
+					(!t?.enumerable || !("value" in t)) && c("World SQL projection source must contain own data");
+				}
+				let t = n.map((e) => (d(e, [
+					"id",
+					"tenantId",
+					"worldId",
+					"zoneId",
+					"cellId",
+					"layer",
+					"roomId",
+					"hostId",
+					"epoch",
+					"revision",
+					"players",
+					"state",
+					"updatedAt"
+				]), (e.tenantId !== m || e.worldId !== h.name) && c("World SQL source escaped the exact projection scope"), {
+					zoneId: e.zoneId,
+					cellId: e.cellId,
+					layer: e.layer,
+					roomId: e.roomId,
+					hostId: e.hostId,
+					epoch: e.epoch,
+					revision: e.revision,
+					players: e.players,
+					state: e.state
+				})), r = S(t);
+				if (Buffer.byteLength(JSON.stringify({
+					version: 1,
+					tenantId: m,
+					worldId: h.name,
+					entries: r
+				}), "utf8") > v) throw new e({
+					budget: "worldProjectionPayloadBytes",
+					limit: v
+				});
+				return r;
+			},
+			catch: (n) => n instanceof e ? n : new t({ detail: "World projection SQL source failed admission" })
+		}))) : i.fail(new t({ detail: "World projection source must return an Effect" }));
+	}), w = (e) => i.try({
+		try: () => {
+			Buffer.byteLength(e, "utf8") > v && c("World projection cached payload exceeds its read budget");
+			let t = JSON.parse(e);
+			d(t, [
+				"version",
+				"tenantId",
+				"worldId",
+				"entries"
+			]);
+			let n = (e) => Object.getOwnPropertyDescriptor(t, e)?.value;
+			(n("version") !== 1 || n("tenantId") !== m || n("worldId") !== h.name) && c("Cached World projection escaped its scope");
+			let r = n("entries");
+			return Array.isArray(r) || c("Missing World projection entries"), S(r);
+		},
+		catch: () => new t({ detail: "Cached World routing hints failed admission" })
+	}), T = (e, t) => t.pipe(i.mapError((t) => t._tag === "HotError" ? new o({
+		operation: e,
+		key: "worldCells",
+		reason: t.reason
+	}) : t));
+	return Object.freeze({
+		hints: () => T("worldCellsRead", i.gen(function* () {
+			let e = yield* s({
+				store: r,
+				onUnavailable: y,
+				read: (e) => e.hget(x, "payload", { consistency: "primary" }).pipe(i.map((e) => ({
+					kind: "hot",
+					value: e
+				}))),
+				fallback: () => C().pipe(i.map((e) => ({
+					kind: "sql",
+					value: e
+				})))
+			});
+			return e.kind === "sql" ? e.value : a.isNone(e.value) ? yield* C() : yield* w(e.value.value);
+		})),
+		rebuildFromSource: () => T("worldCellsRebuild", i.gen(function* () {
+			let t = yield* C(), n = JSON.stringify({
+				version: 1,
+				tenantId: m,
+				worldId: h.name,
+				entries: t
+			});
+			return Buffer.byteLength(n, "utf8") > v ? yield* i.fail(new e({
+				budget: "worldProjectionPayloadBytes",
+				limit: v
+			})) : (yield* r.hset(x, { payload: n }, { ttlMs: g }), Object.freeze({ entries: t.length }));
+		})),
+		invalidate: () => T("worldCellsInvalidate", r.delete(x).pipe(i.asVoid))
+	});
+}, h = async (e, t, n) => {
+	d(n, [
+		"namespace",
+		"tenantId",
+		"world",
+		"ttlMs",
+		"maxEntries",
+		"maxPayloadBytes",
+		"availabilityRole"
+	]);
+	let r = n.availabilityRole, i = e.connectionAvailability?.bind(e), a = e.hotStore?.bind(e);
+	(!e.connectionRegistry || !a || r !== void 0 && !i) && c("World projection requires the app-owned connection registry and tenant HotStore"), r !== void 0 && l(r);
+	let o = r === void 0 ? "fail" : i(r), s = f({
+		namespace: n.namespace,
+		tenantId: n.tenantId,
+		world: n.world,
+		ttlMs: n.ttlMs,
+		maxEntries: n.maxEntries,
+		maxPayloadBytes: n.maxPayloadBytes,
+		onUnavailable: o
+	});
+	return m(t, await a({ tenantId: s.tenantId }), s);
+};
+//#endregion
+export { h as bindWorldCellProjection, m as makeWorldCellProjection };

package/dist/worldReact.js

@@ -0,0 +1,110 @@
+import { createElement as e, useId as t, useLayoutEffect as n, useRef as r, useState as i, useSyncExternalStore as a } from "react";
+//#region src/worldReact.ts
+var o = (e) => a((t) => e.subscribe(t), () => e.observation, () => e.observation), s = {
+	en: {
+		title: "Moving to another location",
+		preparing: "Reserving the destination",
+		loading: "Loading the destination",
+		switching: "Switching connections",
+		failed: "The move is not confirmed",
+		help: "Your source remains selected until the server confirms the commit. A connected destination alone does not confirm the move.",
+		committed: "The server confirmed the destination. Connection cleanup or buffered delivery may still be incomplete.",
+		uncertain: "Check the saved request to continue. Cancelling also requires confirmation from the server.",
+		reserve: "Reserve",
+		connect: "Connect",
+		welcome: "Receive Welcome",
+		assets: "Load assets",
+		commit: "Confirm commit",
+		cleanup: "Finish connections",
+		retry: "Check and continue",
+		cancel: "Request cancellation",
+		actionError: "The request remains incomplete. Check it again."
+	},
+	de: {
+		title: "Ortswechsel",
+		preparing: "Ziel wird reserviert",
+		loading: "Ziel wird geladen",
+		switching: "Verbindungen werden umgeschaltet",
+		failed: "Der Ortswechsel ist nicht bestätigt",
+		help: "Die Quelle bleibt ausgewählt, bis der Server den Commit bestätigt. Eine verbundene Ziel-Session bestätigt den Wechsel allein nicht.",
+		committed: "Der Server hat das Ziel bestätigt. Verbindungsbereinigung oder gepufferte Übertragung können noch unvollständig sein.",
+		uncertain: "Prüfe den gespeicherten Request, um fortzufahren. Auch Abbrechen benötigt eine Bestätigung vom Server.",
+		reserve: "Reservieren",
+		connect: "Verbinden",
+		welcome: "Welcome empfangen",
+		assets: "Assets laden",
+		commit: "Commit bestätigen",
+		cleanup: "Verbindungen abschließen",
+		retry: "Prüfen und fortsetzen",
+		cancel: "Abbruch anfordern",
+		actionError: "Der Request bleibt unvollständig. Prüfe ihn erneut."
+	}
+}, c = ({ client: a, locale: c, showSeamless: l = !1, tip: u, className: d }) => {
+	let f = o(a), p = s[c], m = t(), h = t(), [g, _] = i(!1), [v, y] = i(!1), b = r({
+		client: a,
+		revision: 0,
+		mounted: !1
+	});
+	n(() => (b.current = {
+		client: a,
+		revision: b.current.revision + 1,
+		mounted: !0
+	}, _(!1), y(!1), () => {
+		b.current.mounted = !1, b.current.revision++;
+	}), [a]);
+	let x = (e) => {
+		if (g || b.current.client !== a || !b.current.mounted) return;
+		let t = b.current.revision;
+		_(!0), y(!1);
+		let n = () => b.current.mounted && b.current.client === a && b.current.revision === t;
+		Promise.resolve().then(() => a[e]()).then(() => {
+			n() && _(!1);
+		}, () => {
+			n() && (_(!1), y(!0));
+		});
+	};
+	if (f.status === "idle" || f.status === "settled" || f.status === "closed" || f.mode === "seamless" && !l && f.status !== "failed") return null;
+	let S = f.committed ? p.switching : p[f.status];
+	return e("section", {
+		className: d ?? "mx-auto w-full max-w-xl space-y-4 rounded-xl border border-border bg-background p-5 text-foreground",
+		"aria-labelledby": m,
+		"aria-describedby": h,
+		"aria-busy": g
+	}, e("h2", {
+		id: m,
+		className: "text-xl font-semibold"
+	}, p.title), e("p", {
+		role: "status",
+		"aria-live": "polite",
+		className: "text-base font-medium"
+	}, S), e("p", {
+		id: h,
+		className: "max-w-prose text-sm text-muted-foreground"
+	}, f.committed ? p.committed : f.status === "failed" ? p.uncertain : p.help), e("ol", { className: "flex flex-wrap gap-x-4 gap-y-2 text-sm" }, ...[
+		"reserve",
+		"connect",
+		"welcome",
+		"assets",
+		"commit",
+		"cleanup"
+	].map((t) => e("li", {
+		key: t,
+		"aria-current": f.step === t ? "step" : void 0,
+		className: f.step === t ? "font-semibold text-foreground" : "text-muted-foreground"
+	}, p[t]))), u === void 0 ? null : e("div", { className: "text-sm" }, u), f.status === "failed" ? e("div", { className: "space-y-3" }, v ? e("p", {
+		role: "alert",
+		className: "text-sm"
+	}, p.actionError) : null, e("div", { className: "flex flex-wrap gap-2" }, e("button", {
+		type: "button",
+		"aria-disabled": g,
+		className: "rounded-md bg-primary px-3 py-2 text-sm font-medium text-primary-foreground focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring",
+		onClick: () => x("resume")
+	}, p.retry), f.committed ? null : e("button", {
+		type: "button",
+		"aria-disabled": g,
+		className: "rounded-md border border-input px-3 py-2 text-sm font-medium focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring",
+		onClick: () => x("cancel")
+	}, p.cancel))) : null);
+};
+//#endregion
+export { c as TransitionScreen, o as useWorldTransition };

package/dist/worldRecoveryActor.js

@@ -0,0 +1,35 @@
+import { ProtocolError as e } from "./errors.js";
+import { captureWorldData as t } from "./worldData.js";
+//#region src/worldRecoveryActor.ts
+var n = /* @__PURE__ */ new WeakSet(), r = (t, r) => {
+	if (!t || !n.has(t) || t.scope.tenantId !== r.tenantId || t.scope.roomId !== r.roomId || t.scope.hostId !== r.hostId || t.scope.epoch !== r.epoch || t.scope.priorEpoch !== r.priorEpoch || (t.scope.worldRecoveryEpoch ?? t.scope.priorEpoch) !== (r.worldRecoveryEpoch ?? r.priorEpoch)) throw new e({ detail: "World recovery actor requires its active adoption scope" });
+	return t;
+}, i = async (i, a, o) => {
+	let s = Object.freeze({ ...i }), c, l, u = !1, d = Object.freeze({
+		scope: s,
+		rollback: async (n, i, o, f) => {
+			if (r(d, s), c) throw new e({ detail: "World recovery actor already has an outstanding rollback" });
+			let p = t(n, 4096);
+			if (p.tenantId !== s.tenantId || p.roomId !== s.roomId) throw new e({ detail: "World recovery rollback escaped its Room" });
+			let m = Promise.resolve().then(() => a(p, i, o, f, d));
+			c = m;
+			try {
+				await m;
+			} catch (e) {
+				throw u = !0, l = e, e;
+			} finally {
+				c === m && (c = void 0);
+			}
+		}
+	});
+	n.add(d);
+	try {
+		let e = await o(d);
+		if (c && await c, u) throw l;
+		return e;
+	} finally {
+		n.delete(d), c && await c;
+	}
+};
+//#endregion
+export { r as captureWorldRecoveryActor, i as withWorldRecoveryActor };