@voltro/plugin-rooms 0.0.0-stage → 0.88.0

package/dist/worldGroupSupervisor.js

@@ -0,0 +1,119 @@
+import { ProtocolError as e } from "./errors.js";
+import { captureWorldData as t } from "./worldData.js";
+import { captureWorldGroupCommandReceipt as n } from "./worldGroupCommand.js";
+import { worldTransitionGroupFromRecords as r } from "./worldTransitionGroup.js";
+import { Effect as i, Result as a } from "effect";
+// src/worldGroupSupervisor.ts
+function o() {
+	throw new e({ detail: "World group supervisor requires complete bounded actual providers" });
+}
+var s = (e, t) => {
+	e && typeof e == "object" && Object.getPrototypeOf(e) === Object.prototype && Reflect.ownKeys(e).length === t.length || o();
+	for (let n of Reflect.ownKeys(e)) {
+		let r = Object.getOwnPropertyDescriptor(e, n);
+		typeof n == "string" && t.includes(n) && r?.enumerable && "value" in r || o();
+	}
+}, c = (e, t) => {
+	let n = Object.getOwnPropertyDescriptor(e, t);
+	return !n || !("value" in n) || typeof n.value != "function" ? o() : n.value.bind(e);
+}, l = (t) => i.suspend(() => {
+	let n = t();
+	return i.isEffect(n) ? n : i.fail(new e({ detail: "World group supervisor requires an actual Effect" }));
+}).pipe(i.catchCause(() => i.fail(new e({ detail: "World group continuation remains incomplete" })))), u = (u) => {
+	s(u, [
+		"tenantId",
+		"maxCommands",
+		"maxMembers",
+		"maxPageBytes",
+		"epochNow",
+		"states",
+		"preparation",
+		"deadline",
+		"authorize"
+	]);
+	let { tenantId: d, maxCommands: f, maxMembers: p, maxPageBytes: m } = u;
+	(typeof d != "string" || !/^[A-Za-z0-9][A-Za-z0-9_.:-]*$/.test(d) || d.length > 191 || ![
+		f,
+		p,
+		m
+	].every((e) => Number.isSafeInteger(e) && e > 0)) && o();
+	let h = c(u, "epochNow"), g = c(u.states, "scanGroupCommands"), _ = c(u.states, "acknowledgeGroupCommand"), v = c(u.preparation, "prepare"), y = c(u.deadline, "advance"), b = c(u, "authorize"), x = null, S = !1, C = (e, t) => {
+		if (!e || typeof e != "object" || Object.getPrototypeOf(e) !== Object.prototype) return o();
+		let n = Object.getOwnPropertyDescriptor(e, t);
+		return n?.enumerable && "value" in n ? n.value : o();
+	}, w = (e) => {
+		s(e, ["groups", "nextCursor"]), (!Array.isArray(e.groups) || e.groups.length > f) && o();
+		let i = e.groups.map((e) => (s(e, ["command", "records"]), (!Array.isArray(e.records) || !e.records.length || e.records.length > p) && o(), {
+			command: n(e.command),
+			records: e.records.map((e) => ({
+				origin: C(e, "origin"),
+				subject: C(e, "subject"),
+				group: C(e, "group"),
+				revision: C(e, "revision"),
+				command: n(C(e, "groupCommand"))
+			}))
+		})), a = t({
+			groups: i,
+			nextCursor: e.nextCursor
+		}, m);
+		a.nextCursor !== null && (!/^[a-f0-9]{64}$/.test(a.nextCursor) || x !== null && a.nextCursor <= x) && o();
+		let c = /* @__PURE__ */ new Set();
+		for (let e of a.groups) {
+			(e.command.origin.tenantId !== d || !r(e.records) || e.records.some((t) => t.origin.tenantId !== d || JSON.stringify(t.command) !== JSON.stringify(e.command))) && o();
+			let t = JSON.stringify(e.command.origin);
+			c.has(t) && o(), c.add(t);
+		}
+		return a;
+	};
+	return Object.freeze({ runDue: () => i.suspend(() => S ? i.fail(new e({ detail: "World group supervisor cannot overlap its bounded page" })) : (S = !0, l(() => i.gen(function* () {
+		let t = w(yield* l(() => g({
+			tenantId: d,
+			limit: f,
+			...x === null ? {} : { after: x }
+		})));
+		x = t.nextCursor;
+		let n = 0, s = 0, c = 0;
+		for (let e of t.groups) {
+			let t = yield* i.result(l(() => i.gen(function* () {
+				yield* l(() => b(e.command));
+				let t = (t) => l(() => i.gen(function* () {
+					if (![
+						"waiting",
+						"settled",
+						"rolledBack"
+					].includes(t.state)) return o();
+					let n = w({
+						groups: [t.group],
+						nextCursor: null
+					}).groups[0];
+					return JSON.stringify(n.command) !== JSON.stringify(e.command) || JSON.stringify(r(n.records)) !== JSON.stringify(r(e.records)) ? o() : t.state === "waiting" ? "waiting" : (yield* l(() => _({
+						origin: n.command.origin,
+						members: n.records.map((e) => ({
+							origin: e.origin,
+							expectedRevision: e.revision
+						}))
+					})), "completed");
+				})), n = h();
+				if (!Number.isSafeInteger(n) || n < 0) return o();
+				if (!(e.command.intent.onTimeout === "cancel" && n >= e.command.waitUntil)) {
+					let n = yield* i.result(l(() => v(e.command.intent, e.command.origin)));
+					if (a.isFailure(n)) {
+						let r = yield* l(() => y(e.command.intent, e.command.origin));
+						return r.state === "waiting" ? yield* i.fail(n.failure) : yield* t(r);
+					}
+				}
+				return yield* t(yield* l(() => y(e.command.intent, e.command.origin)));
+			})));
+			a.isFailure(t) ? c++ : t.success === "waiting" ? n++ : s++;
+		}
+		return c ? yield* i.fail(new e({ detail: `World group page retains ${c} failed command continuations` })) : Object.freeze({
+			visited: t.groups.length,
+			waiting: n,
+			completed: s,
+			nextCursor: x
+		});
+	})).pipe(i.ensuring(i.sync(() => {
+		S = !1;
+	}))))) });
+};
+export { u as makeWorldGroupSupervisor };

package/dist/worldHandoffMetrics.js

@@ -0,0 +1,58 @@
+import { captureWorldData as e } from "./worldData.js";
+// src/worldHandoffMetrics.ts
+var t = Object.freeze([
+	10,
+	50,
+	100,
+	250,
+	500,
+	1e3,
+	2500,
+	5e3,
+	1e4,
+	3e4,
+	6e4
+]), n = () => {
+	let e = ["settled", "rolledBack"].map((e) => ({
+		result: e,
+		count: 0,
+		durationMs: 0,
+		buckets: t.map(() => 0)
+	})), n = !0;
+	return Object.freeze({
+		observe: (r) => {
+			if (!n || r.mode !== "seamless" || r.phase !== "settled" && r.phase !== "rolledBack") return;
+			let i = e[r.phase === "settled" ? 0 : 1], a = r.updatedAt - r.createdAt;
+			if (!Number.isSafeInteger(r.createdAt) || r.createdAt < 0 || !Number.isSafeInteger(r.updatedAt) || !Number.isSafeInteger(a) || a < 0 || i.count === 2 ** 53 - 1 || i.durationMs > 2 ** 53 - 1 - a) n = !1;
+			else {
+				i.count++, i.durationMs += a;
+				for (let e = 0; e < t.length; e++) a <= t[e] && i.buckets[e]++;
+			}
+		},
+		snapshot: () => n ? Object.freeze({
+			scope: "acknowledged-source-lifetime",
+			results: Object.freeze(e.map((e) => Object.freeze({
+				...e,
+				buckets: Object.freeze([...e.buckets])
+			})))
+		}) : null
+	});
+}, r = (n) => {
+	if (n == null) return null;
+	try {
+		let r = e(n, 4096);
+		if (r.scope !== "acknowledged-source-lifetime" || Object.keys(r).sort().join(",") !== "results,scope" || !Array.isArray(r.results) || r.results.length !== 2) return null;
+		for (let e = 0; e < 2; e++) {
+			let n = r.results[e];
+			if (!n || n.result !== (e === 0 ? "settled" : "rolledBack") || Object.keys(n).sort().join(",") !== "buckets,count,durationMs,result" || !Number.isSafeInteger(n.count) || n.count < 0 || !Number.isSafeInteger(n.durationMs) || n.durationMs < 0 || n.count === 0 && n.durationMs !== 0 || !Array.isArray(n.buckets) || n.buckets.length !== t.length) return null;
+			for (let e = 0; e < n.buckets.length; e++) {
+				let t = n.buckets[e];
+				if (!Number.isSafeInteger(t) || t < (n.buckets[e - 1] ?? 0) || t > n.count) return null;
+			}
+		}
+		return r;
+	} catch {
+		return null;
+	}
+};
+export { r as captureWorldHandoffMetrics, n as makeWorldHandoffMetrics, t as worldHandoffDurationBuckets };

package/dist/worldHandoffView.js

@@ -0,0 +1,99 @@
+import { ProtocolError as e } from "./errors.js";
+import { simulationOwnData as t } from "./simulationAuthoring.js";
+import { captureWorldData as n } from "./worldData.js";
+import { WorldClientRequestIdSchema as r } from "./worldClientSchemas.js";
+import { Result as i, Schema as a } from "effect";
+// src/worldHandoffView.ts
+var o = () => new e({ detail: "World handoff presentation requires bounded actual delivered snapshots" }), s = (e) => {
+	let s = [
+		"maxBytes",
+		"maxHoldMs",
+		"now",
+		"contains"
+	];
+	t(e, s, s);
+	let { maxBytes: c, maxHoldMs: l } = e;
+	if (!Number.isSafeInteger(c) || c < 1 || c > 16777216 || !Number.isSafeInteger(l) || l < 1 || l > 3e5 || typeof e.now != "function" || typeof e.contains != "function") throw o();
+	let u = e.now.bind(e), d = e.contains.bind(e), f = -1, p, m = () => {
+		let e = u();
+		if (!Number.isSafeInteger(e) || e < 0 || e < f || e > 2 ** 53 - 1 - l) throw o();
+		return f = e, e;
+	}, h = (e) => {
+		let t = n(e, c);
+		if (Object.keys(t).sort().join(",") !== "epoch,receivedAt,state,tick" || !Number.isSafeInteger(t.epoch) || t.epoch < 1 || !Number.isSafeInteger(t.tick) || t.tick < 0 || !Number.isFinite(t.receivedAt) || t.receivedAt < 0) throw o();
+		return t;
+	}, g = (e, t) => {
+		let n = d(e.state, t);
+		if (n instanceof Promise && n.catch(() => void 0), typeof n != "boolean") throw o();
+		return n;
+	}, _ = () => (p && m() >= p.expiresAt && (p = void 0), p);
+	return Object.freeze({
+		begin: (e, t, n) => {
+			if (_() || i.isFailure(a.decodeUnknownResult(r)(e)) || !/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,190}$/.test(t)) throw o();
+			let s = h(n);
+			if (!g(s, t)) throw o();
+			p = {
+				requestId: e,
+				entityId: t,
+				snapshot: s,
+				expiresAt: m() + l,
+				enabled: !1,
+				committed: !1
+			};
+		},
+		prepare: (e, t) => {
+			if (e === "portal") {
+				p = void 0;
+				return;
+			}
+			if (e !== "seamless") throw o();
+			let r = _();
+			if (!r) return;
+			let i = n(t, 1024);
+			if (Object.keys(i).sort().join(",") !== "epoch,roomId" || typeof i.roomId != "string" || !i.roomId || i.roomId.length > 191 || !Number.isSafeInteger(i.epoch) || i.epoch < 1 || r.target && (r.target.roomId !== i.roomId || r.target.epoch !== i.epoch)) throw o();
+			r.enabled = !0, r.target = i;
+		},
+		source: (e) => {
+			let t = _();
+			if (!t || t.committed || !e) return;
+			let n = h(e);
+			if (n.epoch !== t.snapshot.epoch || n.tick < t.snapshot.tick) throw o();
+			g(n, t.entityId) && (t.snapshot = n);
+		},
+		commit: () => {
+			let e = _();
+			e?.enabled && (e.committed = !0);
+		},
+		rollback: () => {
+			p = void 0;
+		},
+		read: (e, t) => {
+			let n = _(), r = t === null ? null : h(t);
+			return n?.enabled ? r && (!n.committed || e === n.target?.roomId && r.epoch === n.target.epoch) && g(r, n.entityId) ? (n.committed && e === n.target?.roomId && r.epoch === n.target.epoch && (p = void 0), Object.freeze({
+				snapshot: r,
+				handoff: !1
+			})) : Object.freeze({
+				snapshot: n.snapshot,
+				handoff: !0,
+				requestId: n.requestId,
+				entityId: n.entityId
+			}) : r === null ? null : Object.freeze({
+				snapshot: r,
+				handoff: !1
+			});
+		},
+		observation: () => {
+			let e = _();
+			return Object.freeze({
+				retained: e !== void 0,
+				enabled: e?.enabled ?? !1,
+				committed: e?.committed ?? !1,
+				expiresAt: e?.expiresAt ?? null
+			});
+		},
+		close: () => {
+			p = void 0;
+		}
+	});
+};
+export { s as makeWorldHandoffView };

package/dist/worldHostSource.js

@@ -0,0 +1,68 @@
+import { ProtocolError as e } from "./errors.js";
+// src/worldHostSource.ts
+var t = (t) => {
+	let n = () => {
+		throw new e({ detail: "World Host source requires own recovery and optional transition observation capabilities" });
+	};
+	t && typeof t == "object" || n();
+	let r = Object.getOwnPropertyDescriptor(t, "handoffMetrics");
+	(r && (!("value" in r) || typeof r.value != "function") || !r && "handoffMetrics" in t) && n();
+	let i = Object.getOwnPropertyDescriptor(t, "recoverRoom");
+	i && "value" in i && typeof i.value == "function" || n();
+	let a = Object.getOwnPropertyDescriptor(t, "admitActorNeighbor");
+	(a && (!("value" in a) || typeof a.value != "function") || !a && "admitActorNeighbor" in t) && n();
+	let o = Object.getOwnPropertyDescriptor(t, "admitActorProjection");
+	(o && (!("value" in o) || typeof o.value != "function") || !o && "admitActorProjection" in t) && n();
+	let s = Object.getOwnPropertyDescriptor(t, "admitActorPlayer");
+	(s && (!("value" in s) || typeof s.value != "function") || !s && "admitActorPlayer" in t) && n();
+	let c = Object.getOwnPropertyDescriptor(t, "transitions");
+	(c && !("value" in c) || !c && "transitions" in t) && n();
+	let l;
+	if (c?.value !== void 0) {
+		let e = c.value;
+		e && typeof e == "object" || n();
+		let t = Object.getOwnPropertyDescriptor(e, "observe");
+		t && "value" in t && typeof t.value == "function" || n();
+		let r = Object.getOwnPropertyDescriptor(e, "scanSourceTransitions");
+		(r && (!("value" in r) || typeof r.value != "function") || !r && "scanSourceTransitions" in e) && n();
+		let i = Object.getOwnPropertyDescriptor(e, "retainActorSnapshot");
+		(i && (!("value" in i) || typeof i.value != "function") || !i && "retainActorSnapshot" in e) && n();
+		let a = Object.getOwnPropertyDescriptor(e, "retainActorDeparture");
+		(a && (!("value" in a) || typeof a.value != "function") || !a && "retainActorDeparture" in e) && n();
+		let o = Object.getOwnPropertyDescriptor(e, "finalizeActorSnapshot");
+		(o && (!("value" in o) || typeof o.value != "function") || !o && "finalizeActorSnapshot" in e) && n();
+		let s = Object.getOwnPropertyDescriptor(e, "admitActorSeat");
+		(s && (!("value" in s) || typeof s.value != "function") || !s && "admitActorSeat" in e) && n();
+		let u = Object.getOwnPropertyDescriptor(e, "admitActorGhost");
+		(u && (!("value" in u) || typeof u.value != "function") || !u && "admitActorGhost" in e) && n();
+		let d = Object.getOwnPropertyDescriptor(e, "admitActorTarget");
+		(d && (!("value" in d) || typeof d.value != "function") || !d && "admitActorTarget" in e) && n();
+		let f = Object.getOwnPropertyDescriptor(e, "admitActorSource");
+		(f && (!("value" in f) || typeof f.value != "function") || !f && "admitActorSource" in e) && n();
+		let p = Object.getOwnPropertyDescriptor(e, "admitActorSourceRecovery");
+		(p && (!("value" in p) || typeof p.value != "function") || !p && "admitActorSourceRecovery" in e) && n();
+		let m = Object.getOwnPropertyDescriptor(e, "observeActorReceipt");
+		(m && (!("value" in m) || typeof m.value != "function") || !m && "observeActorReceipt" in e) && n(), l = Object.freeze({
+			...r ? { scanSourceTransitions: r.value.bind(e) } : {},
+			...u ? { admitActorGhost: u.value.bind(e) } : {},
+			...a ? { retainActorDeparture: a.value.bind(e) } : {},
+			...o ? { finalizeActorSnapshot: o.value.bind(e) } : {},
+			...s ? { admitActorSeat: s.value.bind(e) } : {},
+			...m ? { observeActorReceipt: m.value.bind(e) } : {},
+			...p ? { admitActorSourceRecovery: p.value.bind(e) } : {},
+			...f ? { admitActorSource: f.value.bind(e) } : {},
+			...d ? { admitActorTarget: d.value.bind(e) } : {},
+			...i ? { retainActorSnapshot: i.value.bind(e) } : {},
+			observe: t.value.bind(e)
+		});
+	}
+	return Object.freeze({
+		...r ? { handoffMetrics: r.value.bind(t) } : {},
+		...a ? { admitActorNeighbor: a.value.bind(t) } : {},
+		...o ? { admitActorProjection: o.value.bind(t) } : {},
+		...s ? { admitActorPlayer: s.value.bind(t) } : {},
+		recoverRoom: i.value.bind(t),
+		...l ? { transitions: l } : {}
+	});
+};
+export { t as captureRoomWorldEntitySource };

package/dist/worldInspectEndpoint.js

@@ -0,0 +1,249 @@
+import { defaultWorldLayerPolicy as e } from "./worldLayers.js";
+import { defaultWorldOnWorldChange as t } from "./worldChange.js";
+import { defaultWorldTransitionPolicy as n } from "./worldTransitions.js";
+import { decodeWorldInspection as r } from "./worldInspection.js";
+import { ROOMS_TABLE as i, WORLD_TRANSITIONS_TABLE as a } from "./identities.js";
+import { captureWorldCatalog as o, worldCellAt as s } from "./world.js";
+import { WORLD_CELLS_TABLE as c } from "./worldCells.js";
+import { and as l, eq as u, gt as d, or as f } from "@voltro/database";
+import { Effect as p, Result as m } from "effect";
+import { parseReplicaSelection as h } from "@voltro/protocol/inspect";
+// src/worldInspectEndpoint.ts
+var g = (e) => {
+	if (typeof e != "string" || e.length === 0 || e.length > 191 || e.trim() !== e) throw Error("Invalid World inspection identity");
+	return e;
+}, _ = (e, t = 0) => {
+	if (typeof e != "number" || !Number.isSafeInteger(e) || e < t) throw Error("Invalid World inspection counter");
+	return e;
+}, v = (e) => {
+	let t = e instanceof Date ? e : typeof e == "string" ? new Date(e) : null;
+	if (t === null || !Number.isFinite(t.getTime())) throw Error("Invalid World observation timestamp");
+	return t.toISOString();
+}, y = (y, b, x = y.worldState) => {
+	let S = o(b), C = y.worldClientControls;
+	return {
+		method: "GET",
+		path: "/worlds",
+		scope: "shared-store",
+		description: "Configured World geometry and paged redacted SQL routing observations",
+		handler: (o) => p.gen(function* () {
+			let b = yield* p.result(p.try({
+				try: () => {
+					let e = new URL(o.url, "http://inspect.local").searchParams;
+					h(e), e.delete("replica"), e.delete("replicas");
+					for (let t of e.keys()) if (![
+						"tenantId",
+						"worldId",
+						"after",
+						"transitionsAfter"
+					].includes(t) || e.getAll(t).length !== 1) throw Error("Invalid World inspection query");
+					let t = g(e.get("tenantId")), n = e.has("worldId") ? g(e.get("worldId")) : null, r = e.has("after") ? g(e.get("after")) : null, i = e.has("transitionsAfter") ? g(e.get("transitionsAfter")) : null;
+					if (n === null && (r !== null || i !== null) || i !== null && x !== "transitions" || n !== null && !S.some((e) => e.name === n)) throw Error("Invalid configured World selection");
+					return {
+						tenantId: t,
+						worldId: n,
+						after: r,
+						transitionsAfter: i
+					};
+				},
+				catch: () => "Invalid query"
+			}));
+			if (m.isFailure(b)) return {
+				kind: "json",
+				status: 400,
+				data: { error: "World inspection requires one tenantId and a configured worldId before a cursor" }
+			};
+			let w = b.success, T = S.map((e) => e.name);
+			if (w.worldId === null) return {
+				kind: "json",
+				data: r({
+					worldState: x,
+					worldClientControls: C,
+					catalog: T,
+					page: {
+						...w,
+						nextAfter: null
+					},
+					world: null,
+					cells: [],
+					transitions: null
+				})
+			};
+			let E = S.find((e) => e.name === w.worldId), D = yield* p.result(y.inspect(async (o) => {
+				if (E.zones.length > 256) throw Error("World geometry exceeds inspection budget");
+				let p = await o.query({
+					table: c,
+					predicate: l(u("tenantId", w.tenantId), u("worldId", E.name), ...w.after === null ? [] : [d("id", w.after)]),
+					order: [{
+						column: "id",
+						direction: "asc"
+					}],
+					take: 51,
+					skip: void 0,
+					projection: [
+						"id",
+						"tenantId",
+						"worldId",
+						"zoneId",
+						"cellId",
+						"layer",
+						"roomId",
+						"hostId",
+						"epoch",
+						"revision",
+						"players",
+						"state",
+						"updatedAt"
+					]
+				});
+				if (p.length > 51 || new Set(p.map((e) => e.id)).size !== p.length || p.some((e, t) => e.tenantId !== w.tenantId || e.worldId !== E.name || w.after !== null && g(e.id) <= w.after || t > 0 && g(p[t - 1].id) >= g(e.id))) throw Error("World inspection scope/order mismatch");
+				let m = p.slice(0, 50), h = [...new Set(m.map((e) => g(e.roomId)))], y = h.length === 0 ? [] : await o.query({
+					table: i,
+					predicate: l(u("tenantId", w.tenantId), f(...h.map((e) => u("id", e)))),
+					order: [],
+					take: h.length + 1,
+					skip: void 0,
+					projection: [
+						"id",
+						"tenantId",
+						"name",
+						"hostId",
+						"epoch",
+						"clients",
+						"maxClients",
+						"state"
+					]
+				});
+				if (y.length > h.length || new Set(y.map((e) => e.id)).size !== y.length || y.some((e) => e.tenantId !== w.tenantId || !h.includes(g(e.id)))) throw Error("World referenced Room scope mismatch");
+				let b = m.map((e) => {
+					let t = E.zones.find((t) => t.id === e.zoneId);
+					if (!t) throw Error("Unknown stored World zone");
+					let n = g(e.cellId).split(":"), r = Number(n[1]), i = Number(n[2]), a = t.cells?.size ?? Math.max(t.bounds[1][0] - t.bounds[0][0], t.bounds[1][1] - t.bounds[0][1]);
+					if (n.length !== 3 || n[0] !== t.id || !Number.isSafeInteger(r) || r < 0 || String(r) !== n[1] || !Number.isSafeInteger(i) || i < 0 || String(i) !== n[2]) throw Error("Invalid stored World cell");
+					let o = s(E, {
+						zone: t.id,
+						at: [t.bounds[0][0] + r * a, t.bounds[0][1] + i * a]
+					}), c = _(e.players), l = _(e.epoch, 1), u = e.state, d = e.hostId, f = y.find((t) => t.id === e.roomId);
+					if (o.id !== e.cellId || u !== "creating" && u !== "live" && u !== "hibernated" || u === "hibernated" && (d !== null || c !== 0) || u === "creating" && l === 1 && c !== 0 || (u === "live" || u === "creating") && (d === null || g(d).length === 0)) throw Error("Invalid stored World routing observation");
+					let p = f !== void 0 && f.name === t.room && f.hostId === d && f.epoch === l && f.clients === c && f.state === u && c <= _(f.maxClients, 1) && (t.layering === void 0 || t.layering.maxPlayers === f.maxClients);
+					return {
+						id: g(e.id),
+						zoneId: t.id,
+						cellId: o.id,
+						layer: _(e.layer, 1),
+						bounds: o.bounds,
+						players: c,
+						epoch: l,
+						revision: _(e.revision, 1),
+						state: u,
+						roomObservation: f === void 0 ? "missing" : p ? "matching" : "stale",
+						updatedAt: v(e.updatedAt)
+					};
+				}), D = null;
+				if (x === "transitions") {
+					let e = await o.query({
+						table: a,
+						predicate: l(u("tenantId", w.tenantId), f(u("sourceWorldId", E.name), u("targetWorldId", E.name)), ...w.transitionsAfter === null ? [] : [d("id", w.transitionsAfter)]),
+						order: [{
+							column: "id",
+							direction: "asc"
+						}],
+						take: 51,
+						skip: void 0,
+						projection: [
+							"id",
+							"tenantId",
+							"sourceWorldId",
+							"targetWorldId",
+							"source",
+							"target",
+							"mode",
+							"phase",
+							"revision",
+							"entityRevision",
+							"createdAt",
+							"updatedAt",
+							"committedAt"
+						]
+					});
+					if (e.length > 51 || new Set(e.map((e) => e.id)).size !== e.length || e.some((t, n) => t.tenantId !== w.tenantId || t.sourceWorldId !== E.name && t.targetWorldId !== E.name || w.transitionsAfter !== null && g(t.id) <= w.transitionsAfter || n > 0 && g(e[n - 1].id) >= g(t.id))) throw Error("World transition inspection escaped its page scope");
+					let t = (e, t) => {
+						if (!e || typeof e != "object" || Object.getPrototypeOf(e) !== Object.prototype) throw Error("Invalid recorded transition location");
+						for (let t of Reflect.ownKeys(e)) {
+							let n = Object.getOwnPropertyDescriptor(e, t);
+							if (typeof t != "string" || ![
+								"worldId",
+								"zoneId",
+								"at",
+								"layer",
+								"roomId",
+								"epoch"
+							].includes(t) || !n?.enumerable || !("value" in n)) throw Error("Invalid transition location field");
+						}
+						let n = e, r = S.find((e) => e.name === n.worldId);
+						if (!r || n.worldId !== t) throw Error("Unconfigured transition location");
+						let i = s(r, {
+							zone: g(n.zoneId),
+							at: n.at
+						});
+						return g(n.roomId), _(n.epoch, 1), {
+							worldId: r.name,
+							zoneId: g(n.zoneId),
+							cellId: i.id,
+							layer: _(n.layer, 1)
+						};
+					}, n = e.slice(0, 50).map((e) => ({
+						id: g(e.id),
+						mode: e.mode,
+						phase: e.phase,
+						revision: _(e.revision, 1),
+						entityRevision: _(e.entityRevision, 1),
+						source: t(e.source, e.sourceWorldId),
+						target: t(e.target, e.targetWorldId),
+						createdAt: v(e.createdAt),
+						updatedAt: v(e.updatedAt),
+						committedAt: e.committedAt === null ? null : v(e.committedAt)
+					}));
+					D = {
+						after: w.transitionsAfter,
+						nextAfter: e.length > 50 ? n.at(-1).id : null,
+						entries: n
+					};
+				}
+				return r({
+					worldState: x,
+					worldClientControls: C,
+					transitions: D,
+					catalog: T,
+					page: {
+						...w,
+						nextAfter: p.length > 50 ? b.at(-1).id : null
+					},
+					world: {
+						id: E.name,
+						bounds: E.map.bounds,
+						zones: E.zones.map((e) => ({
+							id: e.id,
+							bounds: e.bounds,
+							cellSize: e.cells?.size ?? null,
+							maxPlayers: e.layering?.maxPlayers ?? null
+						})),
+						layerPolicy: E.strategies.layerPolicy === e ? "default" : "custom",
+						transitionPolicy: E.strategies.transitionPolicy === n ? "default" : "custom",
+						worldChangePolicy: E.strategies.onWorldChange === t ? "default" : "custom"
+					},
+					cells: b
+				});
+			}));
+			return m.isFailure(D) ? {
+				kind: "json",
+				status: 503,
+				data: { error: "World SQL inspection is unavailable. Load it again." }
+			} : {
+				kind: "json",
+				data: D.success
+			};
+		})
+	};
+};
+export { y as roomsWorldInspectEndpoint };