@voltro/plugin-rooms 0.0.0-stage → 0.88.0

package/dist/worldEntityCodec.js

@@ -0,0 +1,20 @@
+import { RoomAuthoringError as e } from "./errors.js";
+import { RoomStateCodec as t } from "./stateCodec.js";
+import { Schema as n } from "effect";
+// src/worldEntityCodec.ts
+var r = (r, i = {}) => {
+	let a = () => {
+		throw new e({
+			room: "world-entity-codec",
+			detail: "World transfer requires a declared non-optional entities string record"
+		});
+	}, o = (e) => e.encoding === void 0 ? e : a(), s = o(r.ast);
+	if (s._tag !== "Objects") return a();
+	let c = s.propertySignatures.find((e) => e.name === "entities");
+	if (!c || c.type.context?.isOptional) return a();
+	let l = o(c.type);
+	if (l._tag !== "Objects" || l.propertySignatures.length !== 0 || l.indexSignatures.length !== 1) return a();
+	let u = l.indexSignatures[0];
+	return u.parameter._tag === "String" ? new t(n.make(u.type), i) : a();
+};
+export { r as roomWorldEntityCodec };

package/dist/worldEntityHandoffView.js

@@ -0,0 +1,153 @@
+import { BudgetExceeded as e, ProtocolError as t } from "./errors.js";
+import { simulationOwnData as n } from "./simulationAuthoring.js";
+import { captureWorldData as r } from "./worldData.js";
+import { encodeRoomFrame as i } from "./wire.js";
+import { Result as a } from "effect";
+// src/worldEntityHandoffView.ts
+var o = () => new t({ detail: "Entity handoff presentation requires bounded exact delivered views" }), s = (e) => typeof e == "string" && /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,190}$/.test(e), c = (t) => {
+	let c = [
+		"maxEntities",
+		"maxBytes",
+		"maxHoldMs",
+		"maxConnections",
+		"now",
+		"entity"
+	];
+	n(t, c, c);
+	let { maxEntities: l, maxBytes: u, maxHoldMs: d, maxConnections: f } = t;
+	if (!Number.isSafeInteger(l) || l < 1 || l > 4095 || !Number.isSafeInteger(u) || u < 1 || u > 16777216 || !Number.isSafeInteger(d) || d < 1 || d > 3e5 || !Number.isSafeInteger(f) || f < 1 || f > 128 || typeof t.now != "function" || typeof t.entity != "function") throw o();
+	let p = t.now.bind(t), m = t.entity.bind(t), h = new TextEncoder(), g = /* @__PURE__ */ new Map(), _ = /* @__PURE__ */ new Map(), v = /* @__PURE__ */ new Map(), y = 0, b = -1, x = !1, S, C = () => {
+		let e = p();
+		if (!Number.isSafeInteger(e) || e < 0 || e < b || e > 2 ** 53 - 1 - d) throw o();
+		return b = e, e;
+	}, w = (e) => {
+		let t = g.get(e);
+		t && (y -= t.bytes, g.delete(e));
+	}, T = () => {
+		let e = C();
+		for (let [t, n] of g) n.value.expiresAt <= e && w(t);
+		return e;
+	}, E = () => {
+		if (S !== void 0) throw S;
+		if (x) throw o();
+	}, D = (e, t) => {
+		if (!Number.isSafeInteger(e.epoch) || e.epoch < 1 || !Number.isSafeInteger(e.tick) || e.tick < 0 || !Number.isFinite(e.receivedAt) || e.receivedAt < 0) throw o();
+		let n = m(e.state, t);
+		if (n instanceof Promise) throw n.catch(() => void 0), o();
+		return n;
+	}, O = (e, t) => {
+		if (E(), T(), !s(e)) throw o();
+		if (t) for (let [n, r] of g) {
+			let i = r.value;
+			i.targetRoomId === e && i.targetEpoch === t.epoch && D(t, i.entityId) !== void 0 && w(n);
+		}
+	}, k = (t, n, c) => {
+		E();
+		let f = T();
+		if (!s(t) || a.isFailure(i(n))) throw o();
+		let p = JSON.stringify([
+			t,
+			n.sourceEpoch,
+			n.transitionId,
+			n.entityId
+		]), m = g.get(p);
+		if (m && (m.value.targetRoomId !== n.targetRoomId || m.value.targetEpoch !== n.targetEpoch)) throw o();
+		if (n.phase === "cancelled") {
+			m && w(p);
+			return;
+		}
+		if (m || !c || c.epoch !== n.sourceEpoch || c.tick > n.tick) return;
+		let _ = D(c, n.entityId);
+		if (_ === void 0) return;
+		for (let e of g.values()) if (e.value.sourceRoomId === t && e.value.sourceEpoch === n.sourceEpoch && e.value.entityId === n.entityId) throw o();
+		if (g.size >= l) throw new e({
+			budget: "worldHandoffEntities",
+			limit: l
+		});
+		if (y >= u) throw new e({
+			budget: "worldHandoffProjectionBytes",
+			limit: u
+		});
+		let v = r({
+			transitionId: n.transitionId,
+			entityId: n.entityId,
+			sourceRoomId: t,
+			sourceEpoch: n.sourceEpoch,
+			sourceTick: c.tick,
+			receivedAt: c.receivedAt,
+			targetRoomId: n.targetRoomId,
+			targetEpoch: n.targetEpoch,
+			expiresAt: f + Math.min(d, n.holdMs),
+			entity: _
+		}, u - y), b = h.encode(JSON.stringify(v)).byteLength;
+		g.set(p, {
+			value: v,
+			bytes: b
+		}), y += b;
+	}, A = () => {
+		x = !0, g.clear(), y = 0;
+		let e = [];
+		for (let t of [..._.values()]) try {
+			t();
+		} catch (t) {
+			e.push(t);
+		}
+		if (e.length) throw AggregateError(e, "World handoff listener cleanup incomplete");
+	};
+	return Object.freeze({
+		notice: k,
+		observe: O,
+		read: (e, t) => (O(e, t), Object.freeze([...g.values()].filter(({ value: n }) => !(n.sourceRoomId !== e && n.targetRoomId !== e || t && !(n.sourceRoomId === e && n.sourceEpoch === t.epoch || n.targetRoomId === e && n.targetEpoch === t.epoch) || t && t.epoch === n.sourceEpoch && e === n.sourceRoomId && D(t, n.entityId) !== void 0)).map((e) => e.value))),
+		attach: (t, n) => {
+			if (E(), T(), !s(t) || _.has(t)) throw o();
+			if (_.size >= f) throw new e({
+				budget: "worldHandoffConnections",
+				limit: f
+			});
+			let r = n.deliveredSnapshot.bind(n), i = n.onWorldHandoff.bind(n), a = n.subscribe.bind(n), c = [], l = () => {
+				let e = [];
+				for (let t of [...c]) try {
+					t(), c.splice(c.indexOf(t), 1);
+				} catch (t) {
+					e.push(t);
+				}
+				if (c.length || (_.delete(t), v.delete(t)), e.length) throw AggregateError(e, "World handoff binding cleanup incomplete");
+			}, u = (e) => {
+				if (!x) try {
+					e();
+				} catch (e) {
+					S = e;
+					try {
+						A();
+					} catch (t) {
+						S = AggregateError([e, t], "World handoff presentation and cleanup failed");
+					}
+				}
+			};
+			_.set(t, l), v.set(t, r);
+			try {
+				if (c.push(i((e) => u(() => {
+					k(t, e, r());
+					let n = v.get(e.targetRoomId);
+					n && O(e.targetRoomId, n());
+				}))), x || (c.push(a(() => u(() => O(t, r())))), x)) throw S ?? o();
+				O(t, r());
+			} catch (e) {
+				try {
+					l();
+				} catch (t) {
+					throw AggregateError([e, t], "World handoff attachment failed");
+				}
+				throw e;
+			}
+			return l;
+		},
+		stats: () => (E(), T(), Object.freeze({
+			entities: g.size,
+			bytes: y,
+			connections: _.size
+		})),
+		close: A
+	});
+};
+export { c as makeWorldEntityHandoffView };

package/dist/worldGeometry.js

@@ -0,0 +1,169 @@
+import { RoomAuthoringError as e } from "./errors.js";
+import { geometryOwnData as t } from "./geometryTileCodec.js";
+import { captureGeometryEditStrategies as n } from "./geometryEdits.js";
+import { captureGeometryDerivationStrategies as r } from "./geometryDerivationStrategies.js";
+import { defaultGeometryMigrateDelta as i } from "./geometryMigrationStrategies.js";
+import { captureGeometryCompactionStrategies as a } from "./geometryCompactionStrategies.js";
+// src/worldGeometry.ts
+var o = /* @__PURE__ */ new WeakSet(), s = /* @__PURE__ */ new WeakMap();
+function c() {
+	throw new e({
+		room: "world-geometry",
+		detail: "World geometry requires complete bounded own configuration and an explicit source"
+	});
+}
+var l = (e, t = 96) => typeof e == "string" && e.length <= t && /^[A-Za-z0-9][A-Za-z0-9._:-]*$/.test(e) ? e : c(), u = (e, t, n) => typeof e == "number" && Number.isSafeInteger(e) && e >= t && e <= n ? e === 0 ? 0 : e : c(), d = (e) => typeof e == "number" && Number.isFinite(e) && e > 0 && Number.isInteger(e * 65536) && e * 65536 <= 2147483647 ? e * 65536 : c(), f = (e) => (o.add(e), Object.freeze(e)), p = (e, n = {}) => {
+	let r = t(n, ["channel"], []);
+	return f({
+		_tag: "GeometrySource",
+		kind: "cms",
+		key: l(e, 191),
+		channel: Object.hasOwn(r, "channel") ? l(r.channel, 64) : "live"
+	});
+}, m = (e) => typeof e != "string" || e.length > 4096 || !e.startsWith("./") || e.includes("\\") || e.includes("%") || e.slice(2).split("/").some((e) => !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(e) || e === "." || e === "..") ? c() : f({
+	_tag: "GeometrySource",
+	kind: "imported",
+	directory: e
+}), h = (e) => {
+	let n = t(e, ["seed", "generator"]);
+	return typeof n.generator == "function" ? f({
+		_tag: "GeometrySource",
+		kind: "procedural",
+		seed: u(n.seed, 0, 4294967295),
+		generator: n.generator
+	}) : c();
+}, g = (e) => typeof e != "object" || !e || !o.has(e) ? c() : e, _ = (e, t, n) => {
+	if (!Array.isArray(e) || Object.getPrototypeOf(e) !== Array.prototype || e.length > t || Reflect.ownKeys(e).length !== e.length + 1) return c();
+	let r = [];
+	for (let t = 0; t < e.length; t++) {
+		let i = Object.getOwnPropertyDescriptor(e, String(t));
+		if (!i?.enumerable || !("value" in i)) return c();
+		r.push(n(i.value));
+	}
+	return Object.freeze(r);
+}, v = (e, n, r) => Object.hasOwn(e, n) ? t(e[n], r, []) : {}, y = (e, t, n, r, i) => Object.hasOwn(e, t) ? u(e[t], r, i) : n, b = (e, t, n) => Object.hasOwn(e, t) ? typeof e[t] == "boolean" ? e[t] : c() : n, x = (e, o) => {
+	if (l(o), s.has(e)) return s.get(e) === o ? e : c();
+	let f = t(e, [
+		"_tag",
+		"kind",
+		"static",
+		"chunkSize",
+		"chunkSizeRaw",
+		"dynamic",
+		"collision",
+		"nav",
+		"streaming",
+		"lod",
+		"budgets",
+		"strategies"
+	], ["kind", "static"]), p = f.kind;
+	if (![
+		"2d-tiles",
+		"2d-heightfield",
+		"3d-voxel",
+		"3d-shapes"
+	].includes(p)) return c();
+	let m = v(f, "strategies", [
+		"migrateDelta",
+		"opValidator",
+		"applyOp",
+		"collisionDerive",
+		"navDerive",
+		"compaction"
+	]), h = Object.hasOwn(m, "migrateDelta") ? m.migrateDelta : i, x = a(Object.hasOwn(m, "compaction") ? { compaction: m.compaction } : {}), S = r({
+		...Object.hasOwn(m, "collisionDerive") ? { collisionDerive: m.collisionDerive } : {},
+		...Object.hasOwn(m, "navDerive") ? { navDerive: m.navDerive } : {}
+	}), C = n({
+		...Object.hasOwn(m, "opValidator") ? { opValidator: m.opValidator } : {},
+		...Object.hasOwn(m, "applyOp") ? { applyOp: m.applyOp } : {}
+	});
+	if (typeof h != "function") return c();
+	let w = g(f.static), T = Object.hasOwn(f, "chunkSize") ? f.chunkSize : 64, E = d(T), D = v(f, "dynamic", [
+		"enabled",
+		"maxDeltaBytesPerChunk",
+		"persist"
+	]), O = v(D, "persist", ["everyMs", "onUnload"]), k = Object.freeze({
+		enabled: b(D, "enabled", !1),
+		maxDeltaBytesPerChunk: y(D, "maxDeltaBytesPerChunk", 262144, 512, 16777216),
+		persist: Object.freeze({
+			everyMs: y(O, "everyMs", 1e4, 1, 864e5),
+			onUnload: b(O, "onUnload", !0)
+		})
+	}), A = v(f, "collision", [
+		"derive",
+		"resolution",
+		"resolutionRaw"
+	]), j = p === "2d-heightfield" ? "heightfield" : p === "3d-shapes" ? "shapes" : "bitgrid", M = Object.hasOwn(A, "derive") ? A.derive : j, N = Object.hasOwn(A, "resolution") ? A.resolution : .25, P = d(N);
+	if (M !== j || P > E || E % P !== 0) return c();
+	let F = Object.freeze({
+		derive: j,
+		resolution: N,
+		resolutionRaw: P
+	}), I = v(f, "nav", [
+		"derive",
+		"navBudgetMs",
+		"maxAdvanceSteps"
+	]), L = Object.hasOwn(I, "derive") ? I.derive : p === "2d-tiles" ? "grid" : "none", R = Object.hasOwn(I, "navBudgetMs") ? I.navBudgetMs : 2;
+	if (L !== "grid" && L !== "none" || L === "grid" && p !== "2d-tiles" || typeof R != "number" || !Number.isFinite(R) || R <= 0 || R > 1e3) return c();
+	let z = Object.freeze({
+		derive: L,
+		navBudgetMs: R,
+		maxAdvanceSteps: y(I, "maxAdvanceSteps", 64, 1, 4096)
+	}), B = v(f, "streaming", ["client", "cell"]), V = v(B, "client", [
+		"radiusChunks",
+		"prefetchChunks",
+		"maxConcurrent",
+		"maxCachedChunks"
+	]), H = v(B, "cell", ["marginChunks"]), U = y(V, "radiusChunks", 3, 0, 64), W = y(V, "prefetchChunks", 5, 0, 128), G = y(V, "maxConcurrent", 4, 1, 64), K = y(V, "maxCachedChunks", p.startsWith("3d-") ? 512 : 256, 1, 65536), q = y(H, "marginChunks", 1, 0, 64), J = v(f, "budgets", [
+		"maxPreparedChunks",
+		"maxPreparedBytes",
+		"maxLodLevels",
+		"maxRayCells",
+		"maxOverlapTests"
+	]), Y = Object.freeze({
+		maxPreparedChunks: y(J, "maxPreparedChunks", 256, 1, 65536),
+		maxPreparedBytes: y(J, "maxPreparedBytes", 52428800, 512, 268435456),
+		maxLodLevels: y(J, "maxLodLevels", 8, 0, 32),
+		maxRayCells: y(J, "maxRayCells", 4096, 1, 1048576),
+		maxOverlapTests: y(J, "maxOverlapTests", 4096, 1, 1048576)
+	});
+	if (W < U || G > K || K < (2 * U + 1) ** (p.startsWith("3d-") ? 3 : 2)) return c();
+	let X = p === "2d-tiles" ? ["tiles"] : p === "2d-heightfield" ? ["heights", "heightsCoarse"] : p === "3d-voxel" ? ["voxels"] : ["shapes"], Z = Object.hasOwn(f, "lod") ? _(f.lod, Y.maxLodLevels, (e) => {
+		let n = t(e, ["beyondChunks", "fields"]), r = u(n.beyondChunks, U, 1024), i = _(n.fields, X.length, (e) => typeof e == "string" && X.includes(e) ? e : c());
+		return !i.length || new Set(i).size !== i.length ? c() : Object.freeze({
+			beyondChunks: r,
+			fields: i
+		});
+	}) : Object.freeze([]);
+	for (let e = 1; e < Z.length; e++) if (Z[e - 1].beyondChunks >= Z[e].beyondChunks) return c();
+	if (Object.hasOwn(f, "_tag") && f._tag !== "WorldGeometry" || Object.hasOwn(f, "chunkSizeRaw") && f.chunkSizeRaw !== E || Object.hasOwn(A, "resolutionRaw") && A.resolutionRaw !== P) return c();
+	let Q = Object.freeze({
+		_tag: "WorldGeometry",
+		kind: p,
+		static: w,
+		chunkSize: T,
+		chunkSizeRaw: E,
+		dynamic: k,
+		collision: F,
+		nav: z,
+		strategies: Object.freeze({
+			...x,
+			...S,
+			...C,
+			migrateDelta: h
+		}),
+		streaming: Object.freeze({
+			client: Object.freeze({
+				radiusChunks: U,
+				prefetchChunks: W,
+				maxConcurrent: G,
+				maxCachedChunks: K
+			}),
+			cell: Object.freeze({ marginChunks: q })
+		}),
+		lod: Z,
+		budgets: Y
+	});
+	return s.set(Q, o), Q;
+};
+export { g as captureGeometrySource, x as captureWorldGeometry, p as cmsGeometry, m as importedGeometry, h as procedural };

package/dist/worldGhostAdmission.js

@@ -0,0 +1,64 @@
+import { ProtocolError as e } from "./errors.js";
+import { captureRoomTransportDataMethod as t } from "./transportAuthoring.js";
+// src/worldGhostAdmission.ts
+var n = () => new e({ detail: "World ghost connection admission refused" }), r = (e, r) => {
+	let i = [
+		"carrier",
+		"epochNow",
+		"maxNonces",
+		"maxInFlight",
+		"authorize"
+	];
+	if (!r || Object.getPrototypeOf(r) !== Object.prototype || Reflect.ownKeys(r).length !== i.length || i.some((e) => {
+		let t = Object.getOwnPropertyDescriptor(r, e);
+		return !t?.enumerable || !("value" in t);
+	}) || typeof r.epochNow != "function" || typeof r.authorize != "function" || !Number.isSafeInteger(r.maxNonces) || r.maxNonces < 1 || r.maxNonces > 65536 || !Number.isSafeInteger(r.maxInFlight) || r.maxInFlight < 1 || r.maxInFlight > r.maxNonces) throw n();
+	let a = t(r.carrier, "readHello", "Ghost admission requires actual signed Hello verification"), o = t(r.carrier, "welcome", "Ghost admission requires actual Welcome signing"), s = t(e, "admitWorldGhostHandshake", "Ghost admission requires actual Host authority"), c = r.authorize.bind(r), l = r.epochNow.bind(r), u = r.maxNonces, d = r.maxInFlight, f = /* @__PURE__ */ new Map(), p = /* @__PURE__ */ new Set(), m = -1, h = !1, g, _ = () => {
+		let e = l();
+		if (!Number.isSafeInteger(e) || e < m || e < 0) throw n();
+		return m = e, e;
+	}, v = () => {
+		let e = _();
+		for (let [t, n] of f) !n.active && n.expiresAt <= e && f.delete(t);
+	};
+	return Object.freeze({
+		accept: (e, t) => {
+			let r;
+			try {
+				if (h || t.aborted || p.size >= d || (v(), r = a(e), r.expiresAt <= _() || f.has(r.nonce) || f.size >= u)) throw n();
+				f.set(r.nonce, {
+					expiresAt: r.expiresAt,
+					active: !0
+				});
+			} catch (e) {
+				return Promise.reject(e);
+			}
+			let i = Promise.resolve().then(async () => {
+				try {
+					if (h || t.aborted || (await s(r, c), h || t.aborted || r.expiresAt <= _())) throw n();
+					return Object.freeze({
+						hello: r,
+						welcome: o(r)
+					});
+				} finally {
+					let e = f.get(r.nonce);
+					e && (e.active = !1);
+				}
+			});
+			return p.add(i), i.then(() => {
+				p.delete(i);
+			}, () => {
+				p.delete(i);
+			}), i;
+		},
+		close: () => (h = !0, g || (g = Promise.allSettled([...p]).then(() => {
+			f.clear();
+		}), g)),
+		snapshot: () => (v(), Object.freeze({
+			nonces: f.size,
+			active: p.size,
+			closed: h
+		}))
+	});
+};
+export { r as makeWorldGhostAdmission };

package/dist/worldGhostDestination.js

@@ -0,0 +1,117 @@
+import { ProtocolError as e } from "./errors.js";
+import { simulationOwnData as t } from "./simulationAuthoring.js";
+import { captureWorldData as n } from "./worldData.js";
+import { roomHostTransportEndpoints as r } from "./transportEndpoints.js";
+import { ROOMS_TABLE as i, ROOM_HOSTS_TABLE as a } from "./identities.js";
+import { WORLD_CELLS_TABLE as o } from "./worldCells.js";
+import { and as s, eq as c } from "@voltro/database";
+import { Effect as l } from "effect";
+// src/worldGhostDestination.ts
+function u() {
+	throw new e({ detail: "World ghost destination is not currently admitted" });
+}
+var d = (e) => typeof e == "string" && e.length > 0 && e.length <= 191 && e.trim() === e ? e : u(), f = (e) => {
+	let t = e instanceof Date ? e.getTime() : typeof e == "string" ? Date.parse(e) : NaN;
+	return Number.isSafeInteger(t) && t >= 0 ? t : u();
+}, p = (p, m) => {
+	let h = [
+		"tenantId",
+		"source",
+		"path",
+		"epochNow",
+		"heartbeatTtlMs",
+		"authorize"
+	];
+	t(m, h, h);
+	let g = d(m.tenantId), _ = n(m.source, 1024), v = m.path, y = m.heartbeatTtlMs;
+	t(_, [
+		"hostId",
+		"instanceId",
+		"startedAt"
+	], [
+		"hostId",
+		"instanceId",
+		"startedAt"
+	]), d(_.hostId), d(_.instanceId), (!Number.isSafeInteger(_.startedAt) || _.startedAt < 0 || typeof v != "string" || v.length > 191 || !/^\/[A-Za-z0-9/_-]+$/.test(v) || v.startsWith("//") || !Number.isSafeInteger(y) || y < 1 || y > 2147483647 || typeof m.epochNow != "function" || typeof m.authorize != "function") && u();
+	let b = m.epochNow.bind(m), x = m.authorize.bind(m), S = () => {
+		let e = b();
+		return Number.isSafeInteger(e) && e >= 0 ? e : u();
+	}, C = async (e, t) => {
+		let n = await p.query({
+			table: e,
+			predicate: t,
+			order: [],
+			take: 2,
+			skip: void 0,
+			projection: void 0
+		});
+		return n.length === 1 ? n[0] : u();
+	}, w = async (e) => {
+		let t = await C(a, c("id", e));
+		return (t.ready !== !0 || t.draining !== !1 || f(t.lastHeartbeatAt) <= S() - y) && u(), {
+			row: t,
+			peer: Object.freeze({
+				hostId: e,
+				instanceId: d(t.instanceId),
+				startedAt: f(t.membershipStartedAt)
+			})
+		};
+	};
+	return Object.freeze({ resolve: (t) => {
+		let a;
+		try {
+			a = n(t, 4096), a && a.tenantId === g && a.state === "live" && a.hostId !== null || u();
+			for (let e of [
+				a.id,
+				a.worldId,
+				a.zoneId,
+				a.cellId,
+				a.roomId,
+				a.hostId
+			]) d(e);
+			[
+				a.layer,
+				a.epoch,
+				a.revision
+			].every((e) => Number.isSafeInteger(e) && e > 0) || u();
+		} catch (t) {
+			return l.fail(t instanceof e ? t : new e({ detail: "Invalid World ghost cell observation" }));
+		}
+		return l.uninterruptible(l.tryPromise({
+			try: async () => {
+				let e = x(a);
+				l.isEffect(e) && await l.runPromise(e) === void 0 || u();
+				let t = async () => {
+					let e = await C(o, s(c("id", a.id), c("tenantId", g)));
+					for (let t of [
+						"worldId",
+						"zoneId",
+						"cellId",
+						"layer",
+						"roomId",
+						"hostId",
+						"epoch",
+						"revision",
+						"state"
+					]) e[t] !== a[t] && u();
+					let t = await C(i, s(c("id", a.roomId), c("tenantId", g)));
+					(t.hostId !== a.hostId || t.epoch !== a.epoch || t.state !== "live") && u();
+				};
+				await t();
+				let n = await w(_.hostId), d = await w(a.hostId);
+				(n.peer.instanceId !== _.instanceId || n.peer.startedAt !== _.startedAt || (n.row.pool ?? null) !== (d.row.pool ?? null)) && u();
+				let f = new URL(r(d.row.publicAddress, d.row.webTransportAddress).ws);
+				f.toString().length > 2048 && u(), f.pathname = v, await t();
+				let p = await w(a.hostId), m = await w(_.hostId);
+				return (p.peer.instanceId !== d.peer.instanceId || p.peer.startedAt !== d.peer.startedAt || p.row.publicAddress !== d.row.publicAddress || (p.row.pool ?? null) !== (d.row.pool ?? null) || m.peer.instanceId !== _.instanceId || m.peer.startedAt !== _.startedAt || (m.row.pool ?? null) !== (p.row.pool ?? null)) && u(), Object.freeze({
+					address: f.toString(),
+					source: _,
+					target: p.peer,
+					cell: a
+				});
+			},
+			catch: (t) => t instanceof e ? t : new e({ detail: "World ghost routing lookup remains incomplete" })
+		}));
+	} });
+};
+export { p as dataStoreWorldGhostDestination };

package/dist/worldGhostGateway.js

@@ -0,0 +1,131 @@
+import { ProtocolError as e } from "./errors.js";
+import { simulationOwnData as t } from "./simulationAuthoring.js";
+import { captureWorldData as n } from "./worldData.js";
+import { captureRoomTransportDataMethod as r } from "./transportAuthoring.js";
+import { gatewayRoomTransport as i } from "./transport.js";
+import { defineWebSocket as a } from "@voltro/protocol";
+// src/worldGhostGateway.ts
+var o = () => new e({ detail: "World ghost gateway acquisition remains incomplete" }), s = (e, s) => {
+	let c = [
+		"path",
+		"admission",
+		"authorize",
+		"ingress",
+		"limits",
+		"maxConnections",
+		"maxSignedBytes",
+		"verificationTimeoutMs"
+	];
+	t(s, c, c);
+	let l = s.maxConnections, u = s.maxSignedBytes, d = s.verificationTimeoutMs;
+	if (!Number.isSafeInteger(l) || l < 1 || l > 65536 || !Number.isSafeInteger(u) || u < 1024 || u > 65536 || !Number.isSafeInteger(d) || d < 1 || d > 6e4 || typeof s.authorize != "function") throw o();
+	let f = n(s.ingress, 1024), p = n(s.limits, 1024), m = s.authorize.bind(s), h = r(s.admission, "accept", "Ghost gateway requires actual signed admission"), g = r(s.admission, "close", "Ghost gateway requires admission withdrawal"), _ = r(e, "bindWorldGhostTransport", "Ghost gateway requires actual target binding");
+	if (!Number.isSafeInteger(p.maxMessageBytes) || p.maxMessageBytes < Math.max(u + 1, f.maxFrameBytes + 1, 1025) || !Number.isSafeInteger(p.maxPendingBytes) || p.maxPendingBytes < p.maxMessageBytes || !Number.isSafeInteger(p.maxPendingMessages) || p.maxPendingMessages < 1) throw o();
+	let v = /* @__PURE__ */ new Map(), y = !1, b, x = (e) => {
+		if (e.closed = !0, e.cleanup) return e.cleanup;
+		let t = Promise.resolve().then(async () => {
+			let t = [];
+			try {
+				e.connection?.close(1e3, "World ghost gateway ended");
+			} catch (e) {
+				t.push(e);
+			}
+			e.verifying && await e.verifying.catch(() => void 0), e.setup && await e.setup.catch(() => void 0);
+			try {
+				await e.binding?.close();
+			} catch (e) {
+				t.push(e);
+			}
+			if (t.length) throw AggregateError(t, "Ghost gateway cleanup remains incomplete");
+			e.signal.removeEventListener("abort", e.abort), v.get(e.signal) === e && v.delete(e.signal);
+		});
+		return e.cleanup = t, t.catch(() => {
+			e.cleanup === t && (e.cleanup = void 0);
+		}), t;
+	}, S = a({
+		path: s.path,
+		auth: "token",
+		verificationTimeoutMs: d,
+		limits: p,
+		verify: (e, t) => {
+			if (y || t.signal.aborted || v.has(t.signal) || v.size >= l || !(e instanceof Uint8Array) || !e.length || e.length > u) return null;
+			let n;
+			try {
+				n = new TextDecoder("utf-8", { fatal: !0 }).decode(e);
+			} catch {
+				return null;
+			}
+			let r = {
+				signal: t.signal,
+				closed: !1,
+				abort: () => {
+					x(r).catch(() => void 0);
+				}
+			};
+			v.set(t.signal, r), t.signal.addEventListener("abort", r.abort, { once: !0 });
+			let i = Promise.resolve().then(async () => {
+				try {
+					let e = await h(n, t.signal);
+					return y || r.closed || t.signal.aborted ? null : (r.verified = e, { subject: {
+						type: "serviceAccount",
+						id: e.hello.nonce,
+						tenantId: e.hello.tenantId,
+						scopes: []
+					} });
+				} catch {
+					return null;
+				}
+			});
+			return r.verifying = i, i.then((e) => {
+				e === null && x(r).catch(() => void 0);
+			}), i;
+		},
+		onConnection: (e) => {
+			let t = v.get(e.signal);
+			if (y || !t?.verified || t.closed || t.setup || e.signal.aborted) throw o();
+			t.connection = e;
+			let n = Promise.resolve().then(async () => {
+				try {
+					let n = t.verified;
+					if (t.binding = await _(n.hello, i(e), f, m), y || t.closed || e.signal.aborted) throw o();
+					let r = new TextEncoder().encode(n.welcome);
+					if (!r.length || r.length > u) throw o();
+					let a = new Uint8Array(r.length + 1);
+					if (a[0] = 0, a.set(r, 1), await e.sendAsync(a), y || t.closed || e.signal.aborted) throw o();
+					return () => {
+						x(t).catch(() => void 0);
+					};
+				} catch (n) {
+					t.closed = !0;
+					try {
+						e.close(1008, "World ghost gateway setup refused");
+					} catch {}
+					throw n;
+				}
+			});
+			return t.setup = n, n.catch(() => {
+				x(t).catch(() => void 0);
+			}), n;
+		}
+	});
+	return Object.freeze({
+		route: S,
+		runDue: async () => {
+			if ((await Promise.allSettled([...v.values()].filter((e) => e.closed || e.signal.aborted).map(x))).some((e) => e.status === "rejected")) throw o();
+		},
+		close: () => {
+			if (y = !0, b) return b;
+			let e = (async () => {
+				if ((await Promise.allSettled([g(), ...[...v.values()].map(x)])).some((e) => e.status === "rejected")) throw o();
+			})();
+			return b = e, e.catch(() => {
+				b === e && (b = void 0);
+			}), e;
+		},
+		snapshot: () => Object.freeze({
+			connections: v.size,
+			closed: y
+		})
+	});
+};
+export { s as makeWorldGhostGateway };