@voltro/plugin-rooms 0.0.0-stage → 0.87.0

package/dist/worldReturnAnchor.js

@@ -0,0 +1,49 @@
+import { ProtocolError as e } from "./errors.js";
+import { captureWorldData as t } from "./worldData.js";
+import { worldCellAt as n } from "./world.js";
+//#region src/worldReturnAnchor.ts
+var r = (r, i) => {
+	let a = () => {
+		throw new e({ detail: "Invalid immutable World entity return anchor" });
+	}, o = t(r, 4096), s = (e, t) => {
+		if (!e || Object.getPrototypeOf(e) !== Object.prototype || Reflect.ownKeys(e).length !== t.length || t.some((t) => !Object.hasOwn(e, t))) return a();
+	}, c = (e, t = 191) => typeof e == "string" && e.length <= t && /^[A-Za-z0-9][A-Za-z0-9_.:-]*$/.test(e) ? e : a(), l = (e) => typeof e == "number" && Number.isSafeInteger(e) && e > 0 && e <= 2147483647 ? e : a();
+	s(o, [
+		"instanceId",
+		"instance",
+		"instanceRoomId",
+		"groupKey",
+		"entryTransitionId",
+		"enteredRevision",
+		"source"
+	]), s(o.source, [
+		"worldId",
+		"zoneId",
+		"at",
+		"layer",
+		"roomId",
+		"epoch"
+	]);
+	let u = c(o.source.worldId, 120), d = i.find((e) => e.name === u), f = c(o.source.zoneId, 120);
+	return !d || typeof o.groupKey != "string" || !/^[a-f0-9]{64}$/.test(o.groupKey) ? a() : (n(d, {
+		zone: f,
+		at: o.source.at
+	}), Object.freeze({
+		instanceId: c(o.instanceId),
+		instance: c(o.instance, 120),
+		instanceRoomId: c(o.instanceRoomId),
+		groupKey: o.groupKey,
+		entryTransitionId: c(o.entryTransitionId),
+		enteredRevision: l(o.enteredRevision),
+		source: Object.freeze({
+			worldId: u,
+			zoneId: f,
+			at: Object.freeze([o.source.at[0], o.source.at[1]]),
+			layer: l(o.source.layer),
+			roomId: c(o.source.roomId),
+			epoch: l(o.source.epoch)
+		})
+	}));
+};
+//#endregion
+export { r as captureWorldEntityReturnAnchor };

package/dist/worldRoomHooks.js

@@ -0,0 +1,57 @@
+import { RoomAuthoringError as e } from "./errors.js";
+//#region src/worldRoomHooks.ts
+var t = (t, n) => {
+	let r = () => {
+		throw new e({
+			room: t,
+			detail: "World hooks require own callable onEnter, onExit, onGhost and persistEntity fields"
+		});
+	};
+	(!n || Object.getPrototypeOf(n) !== Object.prototype || Reflect.ownKeys(n).some((e) => typeof e != "string" || ![
+		"onEnter",
+		"onExit",
+		"onGhost",
+		"persistEntity",
+		"maxPendingTransitions",
+		"movement",
+		"onMemberEnter"
+	].includes(e))) && r();
+	let i = Object.getOwnPropertyDescriptor(n, "maxPendingTransitions");
+	i && (!i.enumerable || !("value" in i)) && r();
+	let a = i?.value ?? 128;
+	(!Number.isSafeInteger(a) || a < 1 || a > 4096) && r();
+	let o = (e) => {
+		let t = Object.getOwnPropertyDescriptor(n, e);
+		return (!t?.enumerable || !("value" in t) || typeof t.value != "function") && r(), t.value;
+	}, s = Object.getOwnPropertyDescriptor(n, "movement"), c;
+	if (s) {
+		(!s.enumerable || !("value" in s)) && r();
+		let e = s.value, t = [
+			"maxEntities",
+			"maxBytesPerTick",
+			"position",
+			"move"
+		];
+		(!e || Object.getPrototypeOf(e) !== Object.prototype || Reflect.ownKeys(e).length !== t.length || t.some((t) => {
+			let n = Object.getOwnPropertyDescriptor(e, t);
+			return !n?.enumerable || !("value" in n);
+		}) || !Number.isSafeInteger(e.maxEntities) || e.maxEntities < 1 || e.maxEntities > 4095 || !Number.isSafeInteger(e.maxBytesPerTick) || e.maxBytesPerTick < 1 || e.maxBytesPerTick > 16777216 || typeof e.position != "function" || typeof e.move != "function") && r(), c = Object.freeze({
+			maxEntities: e.maxEntities,
+			maxBytesPerTick: e.maxBytesPerTick,
+			position: e.position.bind(e),
+			move: e.move.bind(e)
+		});
+	}
+	let l = Object.getOwnPropertyDescriptor(n, "onMemberEnter");
+	return l && (!l.enumerable || !("value" in l) || typeof l.value != "function") && r(), Object.freeze({
+		maxPendingTransitions: a,
+		...c ? { movement: c } : {},
+		onEnter: o("onEnter"),
+		onExit: o("onExit"),
+		onGhost: o("onGhost"),
+		persistEntity: o("persistEntity"),
+		...l ? { onMemberEnter: l.value } : {}
+	});
+};
+//#endregion
+export { t as captureRoomWorldHooks };

package/dist/worldRoomPool.js

@@ -0,0 +1,27 @@
+import { ProtocolError as e } from "./errors.js";
+import { ROOM_HOSTS_TABLE as t } from "./identities.js";
+import { eq as n } from "@voltro/database";
+//#region src/worldRoomPool.ts
+var r = async (r, i, a, o = !1) => {
+	if (i.hosts === void 0) return;
+	let s = () => {
+		throw new e({ detail: "World Room does not belong to its configured pool" });
+	};
+	if (a.pool !== i.hosts.pool && s(), a.hostId === null) {
+		a.state !== "hibernated" && s();
+		return;
+	}
+	(typeof a.hostId != "string" || !a.hostId) && s();
+	let c = await r.query({
+		table: t,
+		predicate: n("id", a.hostId),
+		order: [],
+		take: 2,
+		skip: void 0,
+		projection: ["id", "pool"],
+		...o ? { lock: "update" } : {}
+	});
+	(c.length !== 1 || c[0].id !== a.hostId || c[0].pool !== i.hosts.pool) && s();
+};
+//#endregion
+export { r as assertWorldRoomPool };

package/dist/worldRoomSteps.js

@@ -0,0 +1,133 @@
+import { ProtocolError as e } from "./errors.js";
+import { admitWorldTransitionStep as t, worldTransitionExecutionGroupTokens as n, worldTransitionExecutionLeaseToken as r } from "./worldTransitionExecutor.js";
+import { Effect as i, Option as a } from "effect";
+//#region src/worldRoomSteps.ts
+var o = (t, n) => i.tryPromise({
+	try: t,
+	catch: (t) => t instanceof e ? t : new e({ detail: n })
+}), s = (t) => Object.freeze({
+	step: (n, r) => o(async () => {
+		let { roomId: i, tenantId: a, epoch: o, origin: s, maxBytes: c } = n;
+		switch (n.action) {
+			case "snapshot":
+				await t.captureWorldTransitionSnapshot(i, a, o, s, c);
+				return;
+			case "preview":
+				await t.previewWorldTransition(i, a, o, s, c);
+				return;
+			case "ghost":
+				await t.ghostWorldTransition(i, a, o, s, r, c);
+				return;
+			case "detach":
+				await t.applyWorldSourceTransition(i, a, o, s, "detach", r, c);
+				return;
+			case "restore":
+				await t.applyWorldSourceTransition(i, a, o, s, "rollback", r, c);
+				return;
+			case "commit":
+				await t.commitWorldTransition(i, a, o, s, r, c);
+				return;
+			case "withdraw":
+				await t.withdrawWorldTargetSession(i, a, o, s, r, c);
+				return;
+			case "retire":
+				if (!n.receipt) throw new e({ detail: "World receipt retirement names its receipt" });
+				await t.retireWorldReceipt(i, a, o, s, n.receipt.requestId, n.receipt.operation);
+				return;
+		}
+	}, "World Room step did not complete"),
+	capture: (e) => o(() => t.captureWorldEntity(e.roomId, e.tenantId, e.epoch, e.entityId, e.maxBytes), "World entity capture did not complete")
+}), c = Object.freeze({
+	prepare: ["snapshot", "preview"],
+	ghost: ["ghost"],
+	detach: ["detach"],
+	switchClient: ["detach"],
+	enter: ["preview"],
+	settle: ["commit"],
+	rollback: ["withdraw", "restore"],
+	retire: ["retire"]
+}), l = (t) => {
+	let i = t === void 0 ? void 0 : r(t);
+	if (t === void 0 || i === void 0) throw new e({ detail: "A remote World step needs an active leased executor callback" });
+	let a = n(t);
+	return Object.freeze({
+		transitionId: t.transitionId,
+		revision: t.revision,
+		entityId: t.entityId,
+		operation: t.operation,
+		leaseToken: i,
+		...a ? { group: Object.freeze(a.map(({ record: e, leaseToken: t }) => Object.freeze({
+			transitionId: e.id,
+			revision: e.revision,
+			entityId: e.entityId,
+			origin: Object.freeze({
+				tenantId: e.origin.tenantId,
+				roomId: e.origin.roomId,
+				requestId: e.origin.requestId
+			}),
+			leaseToken: t
+		}))) } : {}
+	});
+}, u = (n, r) => {
+	let o = s(n), l = r.verify?.bind(r);
+	if (l === void 0) throw new e({ detail: "Remote World steps need leases that verify a holder" });
+	return (s, u) => i.gen(function* () {
+		let d = n.options.worldEntities?.transitions;
+		if (!d || s.origin.tenantId !== s.tenantId || r.tenantId !== s.tenantId || !c[u.operation]?.includes(s.action)) return yield* i.fail(new e({ detail: "World step is not admitted on this Host" }));
+		let f = d.observe(s.origin);
+		if (!i.isEffect(f)) return yield* i.fail(new e({ detail: "World step requires actual transition observation" }));
+		let p = yield* f.pipe(i.mapError(() => new e({ detail: "World step transition is unavailable" })));
+		if (!p || p.id !== u.transitionId || p.revision !== u.revision || p.entityId !== u.entityId || p.origin.roomId !== s.origin.roomId || p.origin.requestId !== s.origin.requestId) return yield* i.fail(new e({ detail: "World step names a transition that is no longer current" }));
+		let m = yield* l(u.entityId, u.leaseToken).pipe(i.mapError(() => new e({ detail: "World step lease is unavailable" })));
+		if (a.isNone(m)) return yield* i.fail(new e({ detail: "World step sender no longer holds the transition lease" }));
+		if (u.group === void 0) return yield* t({
+			record: p,
+			operation: u.operation,
+			lease: m.value
+		}, (e) => o.step(s, e));
+		if (!u.group.some((e) => e.transitionId === p.id && e.entityId === p.entityId && e.leaseToken === u.leaseToken)) return yield* i.fail(new e({ detail: "World group step does not name its own transition" }));
+		let h = yield* i.forEach(u.group, (t) => i.gen(function* () {
+			if (t.origin.tenantId !== s.tenantId) return yield* i.fail(new e({ detail: "World group member is outside the step tenant" }));
+			let n = d.observe(t.origin);
+			if (!i.isEffect(n)) return yield* i.fail(new e({ detail: "World step requires actual transition observation" }));
+			let r = yield* n.pipe(i.mapError(() => new e({ detail: "World step transition is unavailable" })));
+			if (!r || r.id !== t.transitionId || r.revision !== t.revision || r.entityId !== t.entityId) return yield* i.fail(new e({ detail: "World group member is no longer current" }));
+			let o = yield* l(t.entityId, t.leaseToken).pipe(i.mapError(() => new e({ detail: "World step lease is unavailable" })));
+			return a.isNone(o) ? yield* i.fail(new e({ detail: "World step sender no longer holds a group member lease" })) : {
+				record: r,
+				lease: o.value
+			};
+		}));
+		return yield* t({
+			record: p,
+			operation: u.operation,
+			lease: m.value,
+			group: h
+		}, (e) => o.step(s, e));
+	});
+}, d = (t) => {
+	let n = (n, r, a) => t.ownership(r, n).pipe(i.mapError(() => new e({ detail: "World Room ownership is unavailable" })), i.flatMap((t) => t && t.hostId !== null && t.epoch === a && t.state === "live" ? i.succeed(t.hostId) : i.fail(new e({ detail: "World Room has no live owner at this epoch" })))), r = (t) => t instanceof e ? t : new e({ detail: "Remote World step did not complete" });
+	return Object.freeze({
+		step: (e, a) => i.suspend(() => {
+			let o;
+			try {
+				o = l(a);
+			} catch (e) {
+				return i.fail(r(e));
+			}
+			return n(e.tenantId, e.roomId, e.epoch).pipe(i.flatMap((n) => t.world.step(n, e, o).pipe(i.mapError(r))));
+		}),
+		capture: (e) => n(e.tenantId, e.roomId, e.epoch).pipe(i.flatMap((n) => t.world.capture(n, e).pipe(i.mapError(r))))
+	});
+}, f = (t) => {
+	let n = (n, r, a) => i.suspend(() => {
+		let o = t.local();
+		return o === void 0 ? i.succeed(t.remote) : t.ownership(r, n).pipe(i.mapError(() => new e({ detail: "World Room ownership is unavailable" })), i.map((e) => e && e.hostId === o.host.id && e.epoch === a ? s(o) : t.remote));
+	});
+	return Object.freeze({
+		step: (e, t) => n(e.tenantId, e.roomId, e.epoch).pipe(i.flatMap((n) => n.step(e, t))),
+		capture: (e) => n(e.tenantId, e.roomId, e.epoch).pipe(i.flatMap((t) => t.capture(e)))
+	});
+};
+//#endregion
+export { s as controllerWorldRoomSteps, u as hostWorldRoomStepHandler, d as remoteWorldRoomSteps, f as routedWorldRoomSteps, l as worldRoomStepAuthority };

package/dist/worldSeatBinding.js

@@ -0,0 +1,36 @@
+import { ProtocolError as e } from "./errors.js";
+//#region src/worldSeatBinding.ts
+var t = (t) => {
+	let n = () => {
+		throw new e({ detail: "Invalid durable World target Seat binding" });
+	};
+	if (!t || typeof t != "object" || Array.isArray(t) || ![Object.prototype, null].includes(Object.getPrototypeOf(t))) return n();
+	let r = [
+		"transitionId",
+		"sourceRoomId",
+		"requestId",
+		"entityId"
+	];
+	if (Reflect.ownKeys(t).length !== r.length) return n();
+	let i = r.map((e) => {
+		let r = Object.getOwnPropertyDescriptor(t, e);
+		return !r || !("value" in r) || typeof r.value != "string" || r.value.length > (e === "requestId" ? 384 : 191) || !/^[A-Za-z0-9][A-Za-z0-9_.:/-]*$/.test(r.value) ? n() : r.value;
+	});
+	return Object.freeze({
+		transitionId: i[0],
+		sourceRoomId: i[1],
+		requestId: i[2],
+		entityId: i[3]
+	});
+}, n = (n) => {
+	if (n == null) return;
+	if (typeof n != "object" || Array.isArray(n) || ![Object.prototype, null].includes(Object.getPrototypeOf(n))) throw new e({ detail: "Invalid Room batch admission receipt" });
+	let r = Object.getOwnPropertyDescriptor(n, "worldTarget");
+	if (r) {
+		if (!("value" in r)) throw new e({ detail: "World target Seat binding must be own data" });
+		return t(r.value);
+	}
+	if ("worldTarget" in n) throw new e({ detail: "Inherited World target Seat binding" });
+};
+//#endregion
+export { t as captureWorldTargetSeatBinding, n as worldTargetSeatBindingFromReceipt };