@voltro/plugin-rooms 0.0.0-stage → 0.88.0

package/dist/worldInstanceExpirySupervisor.js

@@ -0,0 +1,87 @@
+import { ProtocolError as e } from "./errors.js";
+import { captureWorldData as t } from "./worldData.js";
+import { Effect as n } from "effect";
+// src/worldInstanceExpirySupervisor.ts
+function r() {
+	throw new e({ detail: "Instance expiry supervisor requires bounded actual capabilities" });
+}
+var i = (e, t) => {
+	let n = e && typeof e == "object" ? Object.getOwnPropertyDescriptor(e, t) : void 0;
+	return !n || !("value" in n) || typeof n.value != "function" ? r() : n.value.bind(e);
+}, a = async (e) => n.isEffect(e) ? n.runPromise(e) : r(), o = (o) => {
+	let s = [
+		"tenantId",
+		"maxPageRows",
+		"maxPageBytes",
+		"source",
+		"authorize",
+		"advance"
+	];
+	(!o || Object.getPrototypeOf(o) !== Object.prototype || Reflect.ownKeys(o).length !== s.length || s.some((e) => {
+		let t = Object.getOwnPropertyDescriptor(o, e);
+		return !t?.enumerable || !("value" in t);
+	})) && r();
+	let { tenantId: c, maxPageRows: l, maxPageBytes: u } = o;
+	(typeof c != "string" || !/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,190}$/.test(c) || !Number.isSafeInteger(l) || l < 1 || l > 1024 || !Number.isSafeInteger(u) || u < 1 || u > 16777216) && r();
+	let d = i(o.source, "scan"), f = i(o.source, "inventory"), p = i(o, "authorize"), m = i(o, "advance"), h = null, g = !1;
+	return Object.freeze({ runDue: () => n.uninterruptible(n.tryPromise({
+		try: async () => {
+			if (g) return r();
+			g = !0;
+			try {
+				let e = t(await a(d({
+					afterId: h,
+					limit: l
+				})), u);
+				if (!Array.isArray(e.entries) || !Array.isArray(e.deferred) || e.entries.length + e.deferred.length > l || e.nextCursor !== null && (typeof e.nextCursor != "string" || !/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,190}$/.test(e.nextCursor))) return r();
+				let n = /* @__PURE__ */ new Set();
+				for (let t of [...e.entries.map((e) => e.id), ...e.deferred]) {
+					if (typeof t != "string" || !/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,190}$/.test(t) || n.has(t)) return r();
+					n.add(t);
+				}
+				h = e.nextCursor;
+				let i = 0, o = 0, s = 0, g = 0, _ = [...e.deferred], v = (e) => e.instance.tenantId === c ? e.blocked.length ? e.blocked.every((e) => e.reason === "openTransition") ? "pending" : "blocked" : e.members.length ? [
+					"live",
+					"hibernated",
+					"creating"
+				].includes(e.instance.roomState) && e.groupId !== null ? "ready" : "blocked" : "empty" : r();
+				for (let t of e.entries) try {
+					if (t.tenantId !== c) return r();
+					await a(p(Object.freeze(t)));
+					let e = await a(f(t)), n = v(e);
+					if (n === "empty") {
+						o++;
+						continue;
+					}
+					if (n === "pending") {
+						s++;
+						continue;
+					}
+					if (n === "blocked") {
+						g++;
+						continue;
+					}
+					if (await a(m(e)) !== void 0) return r();
+					i++;
+					let l = v(await a(f(t)));
+					l === "empty" ? o++ : l === "blocked" ? g++ : s++;
+				} catch {
+					_.push(t.id);
+				}
+				return Object.freeze({
+					visited: n.size,
+					advanced: i,
+					empty: o,
+					pending: s,
+					blocked: g,
+					deferred: Object.freeze(_),
+					nextCursor: h
+				});
+			} finally {
+				g = !1;
+			}
+		},
+		catch: () => new e({ detail: "Instance expiry supervision remains incomplete" })
+	})) });
+};
+export { o as makeWorldInstanceExpirySupervisor };

package/dist/worldInstanceLifecycle.js

@@ -0,0 +1,102 @@
+import { WORLD_INSTANCES_TABLE as e, WORLD_INSTANCE_SCOPES_TABLE as t } from "./worldInstanceState.js";
+import { ProtocolError as n } from "./errors.js";
+import { lockRoomReservationOwners as r } from "./hostClientCapacity.js";
+import { assertWorldRoomPool as i } from "./worldRoomPool.js";
+import "./worldEntities.js";
+import { and as a, eq as o } from "@voltro/database";
+// src/worldInstanceLifecycle.ts
+var s = async (t, s, c, l, u) => {
+	let d = () => {
+		throw new n({ detail: "World instance lifecycle lost retained Room authority" });
+	};
+	u(), await t.transactional(async (t) => {
+		let n = (await r(t, [c.roomId], c.tenantId)).get(c.roomId);
+		if (!n || n.epoch !== c.epoch) return d();
+		let f = await t.query({
+			table: e,
+			predicate: a(o("tenantId", c.tenantId), o("roomId", c.roomId)),
+			order: [],
+			take: 2,
+			skip: void 0,
+			projection: void 0,
+			lock: "update"
+		}), p = f[0];
+		if (f.length !== 1 || !p || p.epoch !== c.epoch) return d();
+		let m = s.find((e) => e.name === p.worldId);
+		if (!m || !m.instances.some((e) => e.id === p.instance && e.room === n.name) || s.some((e) => e.zones.some((e) => e.room === n.name))) return d();
+		await i(t, m, n, !1);
+		let h = n.state, g = n.clients, _ = p.revision;
+		if (typeof g != "number" || !Number.isSafeInteger(g) || g < 0 || typeof _ != "number" || !Number.isSafeInteger(_) || _ < 1 || (h === "hibernated" || h === "disposed" || h === "faulted" ? g !== 0 || (h === "hibernated" ? n.hostId !== null : n.hostId !== null && n.hostId !== c.hostId) : n.hostId !== c.hostId) || p.hostId !== c.hostId && (p.hostId !== null || p.state !== "hibernated") && (h !== "disposed" || p.state !== "retired")) return d();
+		if (u(), h === "disposed" || h === "faulted" || h === "hibernating") return;
+		if (h !== "creating" && h !== "live" && h !== "hibernated" || p.state === "retired" || h === "creating" && p.state === "live") return d();
+		let v = h === "hibernated" ? null : c.hostId;
+		if (p.state === h && p.hostId === v && p.players === g) return;
+		let y = l(), b = p.updatedAt instanceof Date ? p.updatedAt.getTime() : typeof p.updatedAt == "string" ? Date.parse(p.updatedAt) : NaN;
+		if (!Number.isSafeInteger(y) || !Number.isSafeInteger(b) || y < b || _ >= 2147483647 || await t.updateMany("_voltro_world_instances", {
+			state: h,
+			hostId: v,
+			players: g,
+			revision: _ + 1,
+			updatedAt: new Date(y)
+		}, { where: a(o("id", p.id), o("tenantId", c.tenantId), o("epoch", c.epoch), o("revision", _)) }) !== 1) return d();
+		u();
+	});
+}, c = async (i, s, c, l, u) => {
+	let d = () => {
+		throw new n({ detail: "Failed instance cleanup lost its exact empty disposed Room" });
+	}, f = a(o("tenantId", c.tenantId), o("roomId", c.roomId));
+	u(), await i.transactional(async (n) => {
+		let i = await n.query({
+			table: e,
+			predicate: f,
+			order: [],
+			take: 2,
+			skip: void 0,
+			projection: void 0
+		});
+		if (!i.length) return;
+		if (i.length !== 1) return d();
+		let p = i[0], m = s.find((e) => e.name === p.worldId), h = m?.instances.find((e) => e.id === p.instance);
+		if (!m || !h || p.epoch !== c.epoch || p.hostId !== c.hostId) return d();
+		let g = await n.query({
+			table: t,
+			predicate: a(o("tenantId", c.tenantId), o("worldId", m.name), o("instance", h.id)),
+			order: [],
+			take: 2,
+			skip: void 0,
+			projection: void 0,
+			lock: "update"
+		});
+		if (g.length !== 1 || g[0].maxGroups !== h.maxGroups || g[0].ttlMs !== h.ttlMs) return d();
+		let _ = (await r(n, [c.roomId], c.tenantId)).get(c.roomId);
+		if (!_ || _.name !== h.room || _.state !== "disposed" || _.clients !== 0 || _.epoch !== c.epoch || _.hostId !== c.hostId) return d();
+		let v = await n.query({
+			table: e,
+			predicate: f,
+			order: [],
+			take: 2,
+			skip: void 0,
+			projection: void 0,
+			lock: "update"
+		}), y = v[0];
+		if (v.length !== 1 || !y || y.id !== p.id || y.revision !== p.revision || (await n.query({
+			table: "_voltro_world_entities",
+			predicate: f,
+			order: [],
+			take: 1,
+			skip: void 0,
+			projection: ["id"]
+		})).length) return d();
+		if (u(), y.state === "retired") return;
+		if (y.state !== "creating") return d();
+		let b = l(), x = y.revision, S = y.updatedAt instanceof Date ? y.updatedAt.getTime() : typeof y.updatedAt == "string" ? Date.parse(y.updatedAt) : NaN;
+		if (typeof x != "number" || !Number.isSafeInteger(x) || x < 1 || x >= 2147483647 || !Number.isSafeInteger(b) || !Number.isSafeInteger(S) || b < S || await n.updateMany("_voltro_world_instances", {
+			state: "retired",
+			players: 0,
+			revision: x + 1,
+			updatedAt: new Date(b)
+		}, { where: a(o("id", y.id), o("tenantId", c.tenantId), o("revision", x), o("epoch", c.epoch)) }) !== 1) return d();
+		u();
+	});
+};
+export { c as retireFailedWorldInstanceRoom, s as synchronizeWorldInstanceRoom };

package/dist/worldInstanceState.js

@@ -0,0 +1,51 @@
+import { id as e, integer as t, table as n, text as r, timestamp as i } from "@voltro/database";
+// src/worldInstanceState.ts
+var a = "_voltro_world_instances", o = "_voltro_world_instance_scopes", s = "_voltro_world_instance_history", c = n(o, {
+	id: e({ prefix: "wiscope" }),
+	tenantId: r().maxLength(191),
+	worldId: r().maxLength(120),
+	instance: r().maxLength(120),
+	maxGroups: t(),
+	ttlMs: t()
+}).unique("byWorldInstanceScope", [
+	"tenantId",
+	"worldId",
+	"instance"
+]), l = () => ({
+	id: e({ prefix: "winst" }),
+	tenantId: r().maxLength(191),
+	worldId: r().maxLength(120),
+	instance: r().maxLength(120),
+	groupKey: r().maxLength(64),
+	roomId: r().maxLength(191),
+	hostId: r().maxLength(191).nullable(),
+	generation: t().default(1),
+	epoch: t(),
+	revision: t(),
+	players: t(),
+	state: r().maxLength(16),
+	createdAt: i(),
+	expiresAt: i(),
+	updatedAt: i()
+}), u = n(a, l()).unique("byWorldInstanceGroup", [
+	"tenantId",
+	"worldId",
+	"instance",
+	"groupKey"
+]).unique("byWorldInstanceRoom", ["tenantId", "roomId"]).index([
+	"tenantId",
+	"worldId",
+	"instance",
+	"state"
+]).index(["tenantId", "expiresAt"]), d = n(s, l()).unique("byWorldInstanceGeneration", [
+	"tenantId",
+	"worldId",
+	"instance",
+	"groupKey",
+	"generation"
+]).index(["tenantId", "roomId"]), f = Object.freeze([
+	c,
+	u,
+	d
+]);
+export { a as WORLD_INSTANCES_TABLE, s as WORLD_INSTANCE_HISTORY_TABLE, o as WORLD_INSTANCE_SCOPES_TABLE, d as worldInstanceHistoryTable, c as worldInstanceScopesTable, f as worldInstanceTables, u as worldInstancesTable };