@voltro/plugin-rooms 0.0.0-stage → 0.87.0

package/dist/apiBinding.js

@@ -0,0 +1,678 @@
+import { BudgetExceeded as e, ProtocolError as t, WorldTransitionCooldown as n } from "./errors.js";
+import { captureSimulationBytes as r } from "./simulationBytes.js";
+import { geometryOwnData as i } from "./geometryTileCodec.js";
+import { captureGeometryDense as a, captureGeometryPersistenceScope as o, captureGeometryPrivacyTarget as s, geometryPersistenceId as c } from "./geometryPersistenceData.js";
+import { captureRoomGeometryReloadRequest as l, captureRoomGeometryRollbackRequest as u } from "./geometryAdminData.js";
+import { captureGeometryPreparedScope as d } from "./geometryPrepared.js";
+import { decodeGeometryPatch as f } from "./geometryPatch.js";
+import { worldTransitionRequest as p } from "./worldCommands.js";
+import { captureGeometryAssetReadGrant as m, captureGeometryAssetReadRequest as h } from "./geometryAssetData.js";
+import { captureWorldClientPendingInput as g } from "./worldClientPendingInput.js";
+import { RoomReservationSchema as _ } from "./reservationSchemas.js";
+import { worldClientReceipt as v, worldClientTicket as y } from "./worldClient.js";
+import { captureWorldCatalog as b } from "./world.js";
+import { assertRoomSubjectAdmission as x } from "./subjectAdmission.js";
+import { assertGeometryJournalPatchReceipt as S, captureGeometryJournalArchiveReference as C } from "./geometryJournalArchiveData.js";
+import { RoomReaperPort as w, RoomReservePort as T, RoomSubjectPrivacyPort as ee, WorldClientControlPort as te } from "./ports.js";
+import { geometryPersistenceDigest as E } from "./geometryPersistenceCapture.js";
+import { GeometryPersistencePort as ne } from "./geometryPersistencePorts.js";
+import { GeometryVersionMigrationPort as re, captureGeometryMigrationReceipt as D, captureGeometryMigrationRequest as ie } from "./geometryMigrations.js";
+import { RoomCatalog as O } from "./catalog.js";
+import { RoomGeometryAdministrationPort as ae } from "./geometryAdministrationPorts.js";
+import { captureGeometryJournalRetentionPayload as oe, captureGeometryJournalRetentionResult as se } from "./geometryJournalRetentionWorkflowData.js";
+import { GeometryJournalRetentionSweepPort as ce } from "./geometryJournalRetentionSweep.js";
+import { GeometryJournalArchiveIndexPort as le } from "./geometryJournalArchiveIndex.js";
+import { GeometryAssetReadGrantPort as ue } from "./geometryAssetPorts.js";
+import { GeometryStaticReadGrantPort as de } from "./geometryReadPorts.js";
+import { GeometryManifestPort as fe } from "./geometryManifestPorts.js";
+import { captureGeometryStreamManifest as k } from "./geometryManifestData.js";
+import { captureRoomsGeometryBinding as A, makeRoomsGeometryFacade as pe } from "./geometryApiBinding.js";
+import { captureAdmittedRoomPoolTopology as j, captureRoomPoolCatalog as M } from "./roomPoolTopology.js";
+import { captureRoomAccessRecheckInput as me, captureRoomCloseAllInput as he, captureRoomCloseInput as ge, captureRoomKickInput as _e } from "./moderation.js";
+import { Subject as N } from "@voltro/protocol";
+import { Cause as P, Effect as F, Layer as I, Option as L, Schema as R } from "effect";
+//#region src/apiBinding.ts
+var z = class extends Error {
+	retryCleanup;
+	name = "RoomsApiBindFailure";
+	constructor(e) {
+		super("Rooms API binding cleanup remains incomplete"), this.retryCleanup = e;
+	}
+}, B = class {
+	name;
+	binder;
+	worlds;
+	worldState;
+	worldClientControls;
+	geometryReadUrls;
+	geometryMigrationsEnabled;
+	geometryAssetUrls;
+	geometryJournalArchives;
+	geometryJournalRetention;
+	geometryAdminControls;
+	catalog;
+	pools;
+	phase = "unbound";
+	binding = null;
+	releaseBinding = null;
+	controller = null;
+	bindingTask = null;
+	closeTask = null;
+	active = 0;
+	store = null;
+	idle = null;
+	reservation;
+	privacy;
+	reaper;
+	moderation;
+	worldClientControl;
+	geometry;
+	geometryManifest;
+	geometryReadGrants;
+	geometryAssetGrants;
+	geometryMigration;
+	geometryArchives;
+	geometryAdministration;
+	geometryRetention;
+	services;
+	constructor(n, _, v = Object.freeze([]), O = "none", A = !1, j = !1, M = !1, P = !1, L = !1, z = !1, B = !1) {
+		if (this.name = n, this.binder = _, this.worlds = v, this.worldState = O, this.worldClientControls = A, this.geometryReadUrls = j, this.geometryMigrationsEnabled = M, this.geometryAssetUrls = P, this.geometryJournalArchives = L, this.geometryJournalRetention = z, this.geometryAdminControls = B, this.worlds = b(v), ![
+			"none",
+			"entities",
+			"transitions"
+		].includes(O) || O !== "none" && !this.worlds.length) throw new t({ detail: "World state requires a configured World catalogue" });
+		if (typeof A != "boolean" || A && O !== "transitions") throw new t({ detail: "World client controls require transition state" });
+		if (typeof j != "boolean" || j && !this.worlds.some((e) => e.geometry)) throw new t({ detail: "Geometry read URL routes require an actual geometry World" });
+		if (typeof P != "boolean" || P && !this.worlds.some((e) => e.geometry)) throw new t({ detail: "Geometry assets require an actual geometry World" });
+		if (typeof M != "boolean" || M && !this.worlds.some((e) => e.geometry)) throw new t({ detail: "Geometry migrations require an actual geometry World" });
+		if (typeof L != "boolean" || L && !this.worlds.some((e) => e.geometry)) throw new t({ detail: "Geometry journal archives require an actual geometry World" });
+		if (typeof z != "boolean" || z && !L) throw new t({ detail: "Geometry retention requires its actual archive module" });
+		if (this.geometryRetention = Object.freeze({ run: (e) => this.capturedCall(() => oe(e), (e, n) => !this.geometryJournalRetention || !e.geometry?.retention ? F.fail(new t({ detail: "Actual geometry retention sweep is not installed" })) : F.uninterruptible(F.suspend(() => {
+			let r = e.geometry.retention.run(n);
+			return F.isEffect(r) ? r : F.fail(new t({ detail: "Geometry retention requires its actual sweep Effect" }));
+		})).pipe(F.flatMap((e) => F.try({
+			try: () => se(e),
+			catch: () => new t({ detail: "Geometry retention did not confirm its bounded result" })
+		})))) }), typeof B != "boolean" || B && !this.worlds.some((e) => e.geometry)) throw new t({ detail: "Geometry administration requires its actual geometry World" });
+		this.geometryAdministration = Object.freeze({
+			reload: (e, n, r) => this.capturedCall(() => ({
+				roomId: c(e),
+				request: l(n),
+				subject: R.decodeUnknownSync(N)(structuredClone(r))
+			}), (e, n) => !this.geometryAdminControls || !e.geometry?.administration ? F.fail(new t({ detail: "Actual geometry administration source is not installed" })) : F.uninterruptible(F.suspend(() => {
+				let r = e.geometry.administration.reload(n.roomId, n.request, n.subject);
+				return F.isEffect(r) ? r : F.fail(new t({ detail: "Geometry administration requires its actual Effect" }));
+			})).pipe(F.flatMap((e) => e === void 0 ? F.void : F.fail(new t({ detail: "Actual geometry reload remains incomplete" }))))),
+			rollback: (e, n, r) => this.capturedCall(() => ({
+				roomId: c(e),
+				request: u(n),
+				subject: R.decodeUnknownSync(N)(structuredClone(r))
+			}), (e, n) => !this.geometryAdminControls || !e.geometry?.administration ? F.fail(new t({ detail: "Actual geometry administration source is not installed" })) : F.uninterruptible(F.suspend(() => {
+				let r = e.geometry.administration.rollback(n.roomId, n.request, n.subject);
+				return F.isEffect(r) ? r : F.fail(new t({ detail: "Geometry administration requires its actual Effect" }));
+			})).pipe(F.flatMap((e) => e === void 0 ? F.void : F.fail(new t({ detail: "Actual geometry rollback remains incomplete" }))))),
+			chunks: (e, n) => this.capturedCall(() => ({
+				roomId: c(e),
+				subject: R.decodeUnknownSync(N)(structuredClone(n))
+			}), (e, n) => {
+				let r = e.geometry?.administration?.chunks;
+				return !this.geometryAdminControls || !r ? F.fail(new t({ detail: "The geometry chunk view is not installed" })) : F.suspend(() => {
+					let e = r(n.roomId, n.subject);
+					return F.isEffect(e) ? e : F.fail(new t({ detail: "Geometry administration requires its actual Effect" }));
+				});
+			})
+		}), this.reservation = Object.freeze({
+			reserve: (e, t) => this.capturedCall(() => ({
+				input: structuredClone(e),
+				subject: structuredClone(t)
+			}), (e, t) => e.reservation.reserve(t.input, t.subject)),
+			resume: (e, t) => this.capturedCall(() => structuredClone(t), (t, n) => t.reservation.resume(e, n)),
+			leave: (e, t, n) => this.capturedCall(() => {
+				if (!(t instanceof Uint8Array) || t.byteLength < 1 || t.byteLength > 8192) throw Error("Invalid withdrawal bytes");
+				return {
+					token: Uint8Array.from(t),
+					subject: structuredClone(n)
+				};
+			}, (t, n) => t.reservation.leave(e, n.token, n.subject)),
+			list: (e, t, n) => this.capturedCall(() => structuredClone(t), (t, r) => t.reservation.list(e, r, n)),
+			prepareMatch: (e, n) => this.capturedCall(() => ({
+				input: structuredClone(e),
+				subject: structuredClone(n)
+			}), (e, n) => e.reservation.prepareMatch ? e.reservation.prepareMatch(n.input, n.subject) : F.fail(new t({ detail: "This Rooms binding cannot prepare match Rooms" })))
+		}), this.privacy = Object.freeze({
+			erase: (e) => this.privacyCall(e, (e, n) => e.privacy.erase(n).pipe(F.flatMap(() => e.geometry?.migrations === void 0 ? F.void : e.geometry.migrations.eraseSubject({
+				tenantId: n.target.tenantId,
+				requestId: n.requestId,
+				subject: {
+					id: n.target.subjectId,
+					kind: n.target.kind
+				}
+			}).pipe(F.mapError(() => new t({ detail: "Geometry migration erasure remains incomplete" })))), F.flatMap(() => e.worldState === void 0 ? F.void : e.worldState.onErase(n.target.subjectId, {
+				tenantId: n.target.tenantId,
+				requestId: n.requestId,
+				kind: n.target.kind
+			}).pipe(F.mapError(() => new t({ detail: "World state erasure remains incomplete" })))), F.flatMap(() => e.geometry === void 0 ? F.void : e.geometry.service.eraseSubject({
+				tenantId: n.target.tenantId,
+				requestId: n.requestId,
+				subject: {
+					id: n.target.subjectId,
+					kind: n.target.kind
+				}
+			}).pipe(F.mapError(() => new t({ detail: "Geometry erasure remains incomplete" })))), F.flatMap(() => e.geometry?.archives === void 0 ? F.void : e.geometry.archives.eraseSubject({
+				tenantId: n.target.tenantId,
+				requestId: n.requestId,
+				subject: {
+					id: n.target.subjectId,
+					kind: n.target.kind
+				}
+			}).pipe(F.mapError(() => new t({ detail: "Geometry archive erasure remains incomplete" })))))),
+			export: (e) => this.privacyCall(e, (e, n) => F.gen(function* () {
+				let r = yield* e.privacy.export(n), i = e.worldState === void 0 ? null : yield* e.worldState.onExport(n.target.subjectId, {
+					tenantId: n.target.tenantId,
+					requestId: n.requestId,
+					kind: n.target.kind
+				}).pipe(F.mapError(() => new t({ detail: "World state export remains incomplete" })));
+				if (e.geometry === void 0) return i === null ? r : Object.freeze({
+					rooms: r,
+					world: i
+				});
+				let a = {
+					tenantId: n.target.tenantId,
+					requestId: n.requestId,
+					subject: {
+						id: n.target.subjectId,
+						kind: n.target.kind
+					}
+				}, o = yield* e.geometry.service.exportSubject(a).pipe(F.mapError(() => new t({ detail: "Geometry export remains incomplete" }))), s = e.geometry.archives === void 0 ? null : yield* e.geometry.archives.exportSubject(a).pipe(F.mapError(() => new t({ detail: "Geometry archive export remains incomplete" })));
+				if (e.geometry.migrations === void 0) return Object.freeze({
+					rooms: r,
+					...i === null ? {} : { world: i },
+					geometry: o,
+					...s === null ? {} : { geometryArchives: s }
+				});
+				let c = yield* e.geometry.migrations.exportSubject(a).pipe(F.mapError(() => new t({ detail: "Geometry migration export remains incomplete" })));
+				return Object.freeze({
+					rooms: r,
+					...i === null ? {} : { world: i },
+					geometry: o,
+					geometryMigrations: c,
+					...s === null ? {} : { geometryArchives: s }
+				});
+			}))
+		}), this.geometry = pe(this.worlds, (e) => this.call((n) => n.geometry === void 0 ? F.fail(new t({ detail: "World geometry is not installed in this Rooms API owner" })) : e(n.geometry.service))), this.geometryManifest = Object.freeze({ observe: (e) => this.capturedCall(() => {
+			let n = d(e), r = this.worlds.find((e) => e.name === n.worldId);
+			if (!r?.geometry || r.geometry.kind !== n.kind) throw new t({ detail: "Geometry manifest escaped the installed World kind" });
+			return n;
+		}, (e, n) => e.geometry?.manifest ? e.geometry.manifest.observe(n).pipe(F.flatMap((e) => F.try({
+			try: () => {
+				let t = k(e, 4096, 16777216);
+				if (JSON.stringify(t.scope) !== JSON.stringify(n)) throw Error("Changed geometry manifest root");
+				return t;
+			},
+			catch: () => new t({ detail: "Geometry manifest response does not match its admitted root" })
+		}))) : F.fail(new t({ detail: "Actual geometry manifest source is not installed" }))) }), this.geometryReadGrants = Object.freeze({ grant: (e, n) => this.capturedCall(() => {
+			let r = o(e), i = R.decodeUnknownSync(N)(structuredClone(n)), a = this.worlds.find((e) => e.name === r.worldId);
+			if (!a?.geometry || a.geometry.kind !== r.kind || i.type !== "user" || i.tenantId !== r.tenantId || !i.id.trim()) throw new t({ detail: "Geometry read grant escaped actual World/tenant player" });
+			return i.scopes && Object.freeze(i.scopes), {
+				scope: r,
+				subject: Object.freeze(i)
+			};
+		}, (e, n) => {
+			if (!e.geometry?.manifest || !e.geometry.readGrants || !this.store) return F.fail(new t({ detail: "Actual geometry manifest/Storage grant source is not installed" }));
+			let r = this.store, i = e.geometry.manifest, a = e.geometry.readGrants, o = {
+				tenantId: n.scope.tenantId,
+				kind: n.scope.kind,
+				worldId: n.scope.worldId,
+				layerSetId: n.scope.layerSetId,
+				version: n.scope.version
+			}, s = () => F.tryPromise({
+				try: () => x(r, {
+					tenantId: n.scope.tenantId,
+					subjectId: n.subject.id
+				}),
+				catch: () => new t({ detail: "Geometry Subject admission remains unavailable" })
+			});
+			return F.uninterruptible(s().pipe(F.flatMap(() => i.observe(o)), F.flatMap((e) => F.try({
+				try: () => {
+					let t = k(e, 4096, 16777216);
+					if (JSON.stringify(t.scope) !== JSON.stringify(o)) throw Error("Changed grant manifest root");
+					let r = t.chunks.find((e) => e.cx === n.scope.cx && e.cy === n.scope.cy && e.cz === n.scope.cz);
+					if (!r) throw Error("No actual immutable reference");
+					return r;
+				},
+				catch: () => new t({ detail: "Geometry immutable reference remains unavailable" })
+			})), F.flatMap((e) => a.grant(e, n.subject)), F.flatMap((e) => F.try({
+				try: () => {
+					if (typeof e != "string" || e.length > 16384) throw Error("Invalid read locator");
+					let t = new URL(e);
+					if (!["http:", "https:"].includes(t.protocol) || t.username || t.password || t.hash) throw Error("Forbidden read locator");
+					return t.href;
+				},
+				catch: () => new t({ detail: "Geometry read locator remains unavailable" })
+			})), F.flatMap((e) => s().pipe(F.as(e))), F.catchCause(() => F.fail(new t({ detail: "Actual scoped geometry read grant remains unavailable" })))));
+		}) }), this.geometryAssetGrants = Object.freeze({ grant: (e, n) => this.capturedCall(() => {
+			let r = h(e), i = R.decodeUnknownSync(N)(structuredClone(n)), a = this.worlds.find((e) => e.name === r.worldId);
+			if (!this.geometryAssetUrls || !a?.geometry || i.type !== "user" || i.tenantId !== r.tenantId || !i.id.trim()) throw new t({ detail: "Geometry asset grant escaped its installed World/current tenant Subject" });
+			return i.scopes && Object.freeze(i.scopes), {
+				request: r,
+				subject: Object.freeze(i)
+			};
+		}, (e, n) => {
+			if (!e.geometry?.assetGrants || !this.store) return F.fail(new t({ detail: "Actual geometry asset grant source is not installed" }));
+			let r = this.store, i = e.geometry.assetGrants, a = () => F.tryPromise({
+				try: () => x(r, {
+					tenantId: n.request.tenantId,
+					subjectId: n.subject.id
+				}),
+				catch: () => new t({ detail: "Geometry asset Subject admission remains unavailable" })
+			});
+			return F.uninterruptible(a().pipe(F.flatMap(() => {
+				let e = i.grant(n.request, n.subject);
+				return F.isEffect(e) ? e : F.fail(new t({ detail: "Actual geometry asset grant Effect required" }));
+			}), F.flatMap((e) => F.try({
+				try: () => m(e),
+				catch: () => new t({ detail: "Geometry asset grant response remains unavailable" })
+			})), F.flatMap((e) => a().pipe(F.as(e))), F.catchCause(() => F.fail(new t({ detail: "Actual scoped geometry asset read remains unavailable" })))));
+		}) });
+		let V = (e) => {
+			let n = o(e), r = this.worlds.find((e) => e.name === n.worldId);
+			if (!this.geometryJournalArchives || !r?.geometry || r.geometry.kind !== n.kind) throw new t({ detail: "Geometry archive escaped its installed World" });
+			return n;
+		}, H = (e) => this.call((n) => n.geometry?.archives === void 0 ? F.fail(new t({ detail: "Geometry archive index source is not installed" })) : F.uninterruptible(e(n.geometry.archives)));
+		this.geometryArchives = Object.freeze({
+			archive: (e, n) => this.capturedCall(() => ({
+				scope: V(e),
+				requestId: c(n)
+			}), (e, n) => e.geometry?.archives ? e.geometry.archives.archive(n.scope, n.requestId).pipe(F.flatMap((e) => F.try({
+				try: () => {
+					let t = C(e);
+					if (JSON.stringify(t.receipt.scope) !== JSON.stringify(n.scope) || t.receipt.requestId !== n.requestId) throw Error("Archive reference changed scope");
+					return t;
+				},
+				catch: () => new t({ detail: "Geometry archive reference escaped its captured request" })
+			}))) : F.fail(new t({ detail: "Actual geometry archive index is not installed" }))),
+			load: (e, n) => this.capturedCall(() => ({
+				scope: V(e),
+				requestId: c(n)
+			}), (e, n) => e.geometry?.archives ? e.geometry.archives.load(n.scope, n.requestId).pipe(F.flatMap((e) => F.try({
+				try: () => {
+					let t = r(e, 16777216, "geometryArchiveFacadeBytes"), i = f(t, { maxBytes: 16777216 }).metadata, a = n.scope;
+					if (i.kind !== a.kind || i.worldId !== a.worldId || i.version !== a.version || i.layerSetId !== a.layerSetId || i.cx !== a.cx || i.cy !== a.cy || i.cz !== a.cz) throw Error("Archive bytes changed scope");
+					return t;
+				},
+				catch: () => new t({ detail: "Geometry archive bytes escaped their captured scope" })
+			}))) : F.fail(new t({ detail: "Actual geometry archive index is not installed" }))),
+			exportSubject: (n) => {
+				try {
+					let o = s(n);
+					return H((n) => n.exportSubject(o).pipe(F.flatMap((n) => F.try({
+						try: () => {
+							let t = 0;
+							return a(n, 4096, (n) => {
+								let a = i(n, ["reference", "patch"]), s = C(a.reference), c = this.worlds.find((e) => e.name === s.receipt.scope.worldId), l = r(a.patch, 16777216, "geometryArchiveExportBytes");
+								if (!c?.geometry || c.geometry.kind !== s.receipt.scope.kind || s.receipt.scope.tenantId !== o.tenantId || l.length !== s.size) throw Error("Archive export changed scope");
+								if (S(s.receipt, f(l, { maxBytes: 16777216 }).metadata), t += l.length + new TextEncoder().encode(JSON.stringify(s)).length, t > 16777216) throw new e({
+									budget: "geometryArchiveExportBytes",
+									limit: 16777216
+								});
+								return Object.freeze({
+									reference: s,
+									patch: l
+								});
+							});
+						},
+						catch: () => new t({ detail: "Geometry archive export escaped its installed scope" })
+					}))));
+				} catch {
+					return F.fail(new t({ detail: "Geometry archive export target refused" }));
+				}
+			},
+			eraseSubject: (e) => {
+				try {
+					let n = s(e);
+					return H((e) => e.eraseSubject(n).pipe(F.flatMap((e) => e === void 0 ? F.void : F.fail(new t({ detail: "Geometry archive erase did not confirm void" })))));
+				} catch {
+					return F.fail(new t({ detail: "Geometry archive erase target refused" }));
+				}
+			}
+		});
+		let U = (e) => this.call((n) => n.geometry?.migrations === void 0 ? F.fail(new t({ detail: "Geometry migration source is not installed" })) : F.uninterruptible(e(n.geometry.migrations)));
+		this.geometryMigration = Object.freeze({
+			migrate: (e) => {
+				try {
+					let n = ie(e), r = this.worlds.find((e) => e.name === n.from.worldId);
+					if (!r?.geometry || r.geometry.kind !== n.from.kind || n.to.worldId !== r.name || n.to.kind !== r.geometry.kind) throw new t({ detail: "Geometry migration escaped actual installed World" });
+					return U((e) => e.migrate(n).pipe(F.flatMap((e) => F.try({
+						try: () => {
+							let t = D(e);
+							if (JSON.stringify(t.from) !== JSON.stringify(n.from) || JSON.stringify(t.to) !== JSON.stringify(n.to) || t.fromRevision !== n.expectedRevision || t.requestKey !== E(JSON.stringify([n.from.tenantId, n.requestId])) || t.inputSha256 !== E(JSON.stringify(n))) throw Error("Changed migration receipt");
+							return t;
+						},
+						catch: () => new t({ detail: "Migration receipt does not match its captured request" })
+					}))));
+				} catch {
+					return F.fail(new t({ detail: "Geometry migration request could not be captured" }));
+				}
+			},
+			eraseSubject: (e) => {
+				try {
+					let n = s(e);
+					return U((e) => e.eraseSubject(n).pipe(F.flatMap((e) => e === void 0 ? F.void : F.fail(new t({ detail: "Migration erasure did not confirm void" })))));
+				} catch {
+					return F.fail(new t({ detail: "Geometry migration privacy target could not be captured" }));
+				}
+			},
+			exportSubject: (e) => {
+				try {
+					let n = s(e);
+					return U((e) => e.exportSubject(n).pipe(F.flatMap((e) => F.try({
+						try: () => {
+							let t = a(e, 4096, D);
+							if (t.some((e) => e.from.tenantId !== n.tenantId) || new Set(t.map((e) => e.requestKey)).size !== t.length || new TextEncoder().encode(JSON.stringify(t)).length > 16777216) throw Error("Changed migration export scope");
+							return t;
+						},
+						catch: () => new t({ detail: "Migration export escaped its captured scope or budget" })
+					}))));
+				} catch {
+					return F.fail(new t({ detail: "Geometry migration privacy target could not be captured" }));
+				}
+			}
+		}), this.reaper = Object.freeze({ run: (e) => this.capturedCall(() => Object.freeze({ ...e }), (e, t) => e.reaper.run(t)) });
+		let W = () => F.fail(new t({ detail: "Room moderation is not installed" }));
+		this.moderation = Object.freeze({
+			kick: (e) => this.capturedCall(() => _e(e), (e, t) => e.moderation === void 0 ? W() : e.moderation.kick(t)),
+			close: (e) => this.capturedCall(() => ge(e), (e, t) => e.moderation === void 0 ? W() : e.moderation.close(t)),
+			closeAll: (e) => this.capturedCall(() => he(e), (e, t) => e.moderation === void 0 ? W() : e.moderation.closeAll(t)),
+			rollbackGeometry: (e, t) => this.capturedCall(() => ({
+				input: structuredClone(e),
+				staff: structuredClone(t)
+			}), (e, t) => e.moderation?.rollbackGeometry === void 0 ? W() : e.moderation.rollbackGeometry(t.input, t.staff)),
+			recheckAccess: (e) => this.capturedCall(() => me(e), (e, t) => e.moderation?.recheckAccess === void 0 ? W() : e.moderation.recheckAccess(t))
+		});
+		let G = (e) => {
+			let n = R.decodeUnknownSync(N)(structuredClone(e));
+			if (n.type !== "user" || typeof n.tenantId != "string" || !n.tenantId.trim()) throw new t({ detail: "World client controls require an authenticated tenant player" });
+			return n.scopes && Object.freeze(n.scopes), Object.freeze(n);
+		}, K = (e) => this.call((n) => n.worldClientControl === void 0 ? F.fail(new t({ detail: "World client controls are not installed" })) : e(n.worldClientControl.service));
+		this.worldClientControl = Object.freeze({
+			pending: (e, n) => this.capturedCall(() => ({
+				input: g(e),
+				subject: G(n)
+			}), (e, n) => e.worldClientControl?.service.pending ? e.worldClientControl.service.pending(n.input, n.subject) : F.fail(new t({ detail: "World pending transition discovery is not installed" }))),
+			join: (e, n) => this.capturedCall(() => G(n), (n, r) => n.worldClientControl?.service.join ? n.worldClientControl.service.join(e, r) : F.fail(new t({ detail: "World join is not installed" }))),
+			reservation: (e, n) => this.capturedCall(() => G(n), (n, r) => n.worldClientControl?.service.reservation ? n.worldClientControl.service.reservation(e, r) : F.fail(new t({ detail: "World target Seat control is not installed" }))),
+			follow: (e, n) => this.capturedCall(() => G(n), (n, r) => n.worldClientControl?.service.follow ? n.worldClientControl.service.follow(e, r) : F.fail(new t({ detail: "World follower Seat control is not installed" }))),
+			prepare: (e, n, r) => {
+				try {
+					let t = p(n), i = G(r);
+					return K((n) => n.prepare(e, t, i));
+				} catch {
+					return F.fail(new t({ detail: "World client intention could not be captured" }));
+				}
+			},
+			observe: (e, n) => this.capturedCall(() => G(n), (n, r) => n.worldClientControl === void 0 ? F.fail(new t({ detail: "World client controls are not installed" })) : n.worldClientControl.service.observe(e, r)),
+			commit: (e, n) => {
+				try {
+					let t = y(e), r = G(n);
+					return K((e) => e.commit(t, r));
+				} catch {
+					return F.fail(new t({ detail: "World client ticket could not be captured" }));
+				}
+			},
+			cancel: (e, n) => this.capturedCall(() => G(n), (n, r) => n.worldClientControl === void 0 ? F.fail(new t({ detail: "World client controls are not installed" })) : n.worldClientControl.service.cancel(e, r))
+		});
+		let q = I.mergeAll(I.succeed(T, this.reservation), I.succeed(ee, this.privacy), I.succeed(w, this.reaper)), J = A ? I.merge(q, I.succeed(te, this.worldClientControl)) : q, Y = this.worlds.some((e) => e.geometry !== void 0) ? I.mergeAll(J, I.succeed(ne, this.geometry), I.succeed(fe, this.geometryManifest), I.succeed(de, this.geometryReadGrants)) : J, X = P ? I.merge(Y, I.succeed(ue, this.geometryAssetGrants)) : Y, Z = L ? I.merge(X, I.succeed(le, this.geometryArchives)) : X, Q = z ? I.merge(Z, I.succeed(ce, this.geometryRetention)) : Z, $ = B ? I.merge(Q, I.succeed(ae, this.geometryAdministration)) : Q;
+		this.services = M ? I.merge($, I.succeed(re, this.geometryMigration)) : $;
+	}
+	status() {
+		return Object.freeze({
+			phase: this.phase,
+			activeCalls: this.active
+		});
+	}
+	inspect(e) {
+		return this.call(() => F.uninterruptible(F.tryPromise({
+			try: () => {
+				if (!this.store) throw Error("Unbound inspection store");
+				return e(this.store);
+			},
+			catch: () => new t({ detail: "Rooms directory inspection could not be completed" })
+		})));
+	}
+	call(e) {
+		return F.acquireUseRelease(F.try({
+			try: () => {
+				if (this.phase !== "ready" || !this.binding) throw Error("Unbound owner");
+				return this.active++, this.binding;
+			},
+			catch: () => new t({ detail: "Rooms API control is unavailable or shutting down" })
+		}), (n) => F.suspend(() => {
+			let r = e(n);
+			return F.isEffect(r) ? r : F.fail(new t({ detail: "Rooms API ports must return an Effect" }));
+		}), () => F.sync(() => {
+			if (this.active--, this.active === 0) {
+				let e = this.idle;
+				this.idle = null, e?.();
+			}
+		}));
+	}
+	capturedCall(e, n) {
+		try {
+			let t = e();
+			return this.call((e) => n(e, t));
+		} catch {
+			return F.fail(new t({ detail: "Rooms API request could not be captured" }));
+		}
+	}
+	privacyCall(e, n) {
+		if (typeof e?.requestId != "string" || !e.requestId.trim() || typeof e.target?.subjectId != "string" || !e.target.subjectId.trim() || typeof e.target.tenantId != "string" || !e.target.tenantId.trim() || e.target.kind !== "guest" && e.target.kind !== "user") return F.fail(new t({ detail: "Rooms privacy requires an explicit trusted tenant and subject" }));
+		let r = Object.freeze({
+			requestId: e.requestId,
+			target: Object.freeze({
+				subjectId: e.target.subjectId,
+				tenantId: e.target.tenantId,
+				kind: e.target.kind
+			})
+		});
+		return this.call((e) => F.uninterruptible(n(e, r)));
+	}
+	configureCatalog(e) {
+		if (this.phase !== "unbound" || this.bindingTask || this.releaseBinding) throw new t({ detail: "Room catalog configuration must precede API binding" });
+		let n = new O(e.inventory(), { previousHistory: e.history });
+		this.pools !== void 0 && M(this.pools, n.inventory().map((e) => e.descriptor.name)), this.catalog = n;
+	}
+	configurePools(e, n) {
+		if (this.phase !== "unbound" || this.bindingTask || this.releaseBinding) throw new t({ detail: "Room pool configuration must precede API binding" });
+		let r = n === void 0 ? this.catalog : new O(n.inventory(), { previousHistory: n.history });
+		this.pools = r === void 0 ? j(e) : M(e, r.inventory().map((e) => e.descriptor.name)), this.catalog = r;
+	}
+	bind(e, r) {
+		if (this.phase !== "unbound" || this.bindingTask || this.releaseBinding) return Promise.reject(new t({ detail: "Rooms API owner is already binding or retained for cleanup" }));
+		if (!this.binder) return Promise.reject(new t({ detail: "Rooms requires an API-to-host control and coordinated privacy binding" }));
+		this.phase = "binding";
+		let i = new AbortController();
+		this.controller = i;
+		let a = (async () => {
+			try {
+				let a = await this.binder(e, Object.freeze({
+					pools: this.pools,
+					catalog: this.catalog,
+					pluginName: this.name,
+					host: r,
+					signal: i.signal,
+					worlds: this.worlds,
+					worldState: this.worldState,
+					worldClientControls: this.worldClientControls,
+					geometryMigrations: this.geometryMigrationsEnabled,
+					geometryAssetUrls: this.geometryAssetUrls,
+					geometryJournalArchives: this.geometryJournalArchives,
+					geometryJournalRetention: this.geometryJournalRetention,
+					geometryAdminControls: this.geometryAdminControls
+				}));
+				if (typeof a?.release != "function") throw new t({ detail: "Rooms binding must return its complete resource lifetime" });
+				this.releaseBinding = a.release.bind(a);
+				let o = Object.getOwnPropertyDescriptor(a, "pools");
+				if (o && (!o.enumerable || !("value" in o)) || !o && "pools" in a || this.pools !== void 0 && o?.value !== this.pools) throw new t({ detail: "Rooms API provider did not retain the app pool topology" });
+				let s = a.reservation, c = a.privacy, l = a.reaper, u = Object.getOwnPropertyDescriptor(a, "geometry");
+				if (u && (!u.enumerable || !("value" in u)) || !u && "geometry" in a) throw new t({ detail: "Rooms geometry binding refuses accessors or inherited providers" });
+				let d = this.worlds.some((e) => e.geometry !== void 0), f = u?.value;
+				if (d !== (f !== void 0)) throw new t({ detail: "Declared World geometry requires exactly its actual source binding" });
+				let p = d ? A(f, this.worlds) : void 0;
+				if (this.geometryReadUrls && (!p?.manifest || !p.readGrants)) throw new t({ detail: "Configured geometry read URLs require actual manifest and Storage grant sources" });
+				if (this.geometryJournalArchives !== (p?.archives !== void 0)) throw new t({ detail: "Geometry archive module requires exactly its actual index/privacy binding" });
+				if (this.geometryAdminControls !== (p?.administration !== void 0)) throw new t({ detail: "Geometry administration requires exactly its actual configured source" });
+				if (this.geometryJournalRetention !== (p?.retention !== void 0)) throw new t({ detail: "Geometry retention module requires exactly its actual sweep binding" });
+				if (this.geometryAssetUrls !== (p?.assetGrants !== void 0)) throw new t({ detail: "Geometry asset module requires exactly its actual source binding" });
+				if (this.geometryMigrationsEnabled !== (p?.migrations !== void 0)) throw new t({ detail: "Geometry migration module requires exactly its actual service and privacy binding" });
+				let m;
+				if (this.worldState === "none") {
+					if (a.worldState !== void 0) throw new t({ detail: "Unconfigured World state binding refuses admission" });
+				} else {
+					let e = a.worldState;
+					if (!e) throw new t({ detail: "Configured World state requires its actual privacy source" });
+					for (let n of [
+						"worlds",
+						"transitionsEnabled",
+						"onErase",
+						"onExport"
+					]) {
+						let r = Object.getOwnPropertyDescriptor(e, n);
+						if (!r || !("value" in r)) throw new t({ detail: "World state binding requires own data and methods" });
+					}
+					let n = b(e.worlds);
+					if (n.length !== this.worlds.length || n.some((e, t) => e !== this.worlds[t]) || e.transitionsEnabled !== (this.worldState === "transitions") || typeof e.onErase != "function" || typeof e.onExport != "function") throw new t({ detail: "World state source does not match declared catalogue/schema" });
+					let r = e.onErase.bind(e), i = e.onExport.bind(e), o = (e) => F.suspend(() => {
+						let n = e();
+						return F.isEffect(n) ? n : F.fail(new t({ detail: "World state privacy source requires an Effect" }));
+					});
+					m = Object.freeze({
+						worlds: n,
+						transitionsEnabled: e.transitionsEnabled,
+						onErase: (e, t) => o(() => r(e, t)),
+						onExport: (e, t) => o(() => i(e, t))
+					});
+				}
+				let h, x = Object.getOwnPropertyDescriptor(a, "worldClientControl");
+				if (x && !("value" in x)) throw new t({ detail: "World client binding refuses accessors" });
+				let S = x?.value;
+				if (this.worldClientControls) {
+					if (!S) throw new t({ detail: "Configured World client controls require their actual service" });
+					for (let e of ["worlds", "service"]) {
+						let n = Object.getOwnPropertyDescriptor(S, e);
+						if (!n || !("value" in n)) throw new t({ detail: "World client binding requires own data" });
+					}
+					let e = b(S.worlds), r = S.service;
+					if (e.length !== this.worlds.length || e.some((e, t) => e !== this.worlds[t])) throw new t({ detail: "World client catalogue does not match declared state" });
+					for (let e of [
+						"prepare",
+						"observe",
+						"commit",
+						"cancel"
+					]) {
+						let n = r && Object.getOwnPropertyDescriptor(r, e);
+						if (!n || !("value" in n) || typeof n.value != "function") throw new t({ detail: "World client control requires complete own methods" });
+					}
+					let i = Object.getOwnPropertyDescriptor(r, "reservation");
+					if (i && (!("value" in i) || typeof i.value != "function") || !i && "reservation" in r) throw new t({ detail: "World target Seat control requires an own method" });
+					let a = i ? r.reservation.bind(r) : void 0, o = Object.getOwnPropertyDescriptor(r, "follow");
+					if (o && (!("value" in o) || typeof o.value != "function") || !o && "follow" in r) throw new t({ detail: "World follower control requires an own method" });
+					let s = o ? r.follow.bind(r) : void 0, c = Object.getOwnPropertyDescriptor(r, "pending");
+					if (c && (!("value" in c) || typeof c.value != "function") || !c && "pending" in r) throw new t({ detail: "World pending transition discovery requires an own method" });
+					let l = c ? r.pending.bind(r) : void 0, u = Object.getOwnPropertyDescriptor(r, "join");
+					if (u && (!("value" in u) || typeof u.value != "function") || !u && "join" in r) throw new t({ detail: "World join control requires an own method" });
+					let d = u ? r.join.bind(r) : void 0, f = r.prepare.bind(r), p = r.observe.bind(r), m = r.commit.bind(r), x = r.cancel.bind(r), C = (e, r) => F.uninterruptible(F.suspend(() => {
+						let n = e();
+						return F.isEffect(n) ? n.pipe(F.map(r)) : F.fail(new t({ detail: "World client control requires an Effect" }));
+					})).pipe(F.catchCause((e) => {
+						let r = P.findErrorOption(e);
+						return F.fail(L.isSome(r) && r.value instanceof n ? r.value : new t({ detail: "World client control remains incomplete" }));
+					}));
+					h = Object.freeze({
+						worlds: e,
+						service: Object.freeze({
+							...l === void 0 ? {} : { pending: (e, t) => C(() => l(g(e), t), (e) => e === null ? null : v(e)) },
+							...d === void 0 ? {} : { join: (e, t) => C(() => d(e, t), (e) => Object.freeze({
+								entityId: e.entityId,
+								reservation: structuredClone(R.decodeUnknownSync(R.toType(_))(e.reservation))
+							})) },
+							...a === void 0 ? {} : { reservation: (e, t) => C(() => a(e, t), (e) => structuredClone(R.decodeUnknownSync(R.toType(_))(e))) },
+							...s === void 0 ? {} : { follow: (e, t) => C(() => s(e, t), (e) => structuredClone(R.decodeUnknownSync(R.toType(_))(e))) },
+							prepare: (e, t, n) => C(() => f(e, t, n), y),
+							observe: (e, t) => C(() => p(e, t), v),
+							commit: (e, t) => C(() => m(e, t), v),
+							cancel: (e, t) => C(() => x(e, t), v)
+						})
+					});
+				} else if (S !== void 0) throw new t({ detail: "Unconfigured World client control refuses admission" });
+				let C = Object.getOwnPropertyDescriptor(a, "moderation");
+				if (C && (!("value" in C) || C.value !== void 0 && [
+					"kick",
+					"close",
+					"closeAll"
+				].some((e) => typeof Reflect.get(C.value, e) != "function")) || !C && "moderation" in a) throw new t({ detail: "Rooms moderation binding requires own kick, close and closeAll methods" });
+				let w = C?.value, T = w === void 0 ? void 0 : Object.freeze({
+					kick: w.kick.bind(w),
+					close: w.close.bind(w),
+					closeAll: w.closeAll.bind(w),
+					...typeof w.rollbackGeometry == "function" ? { rollbackGeometry: w.rollbackGeometry.bind(w) } : {},
+					...typeof w.recheckAccess == "function" ? { recheckAccess: w.recheckAccess.bind(w) } : {}
+				});
+				if (!s || !c || !l || [
+					"reserve",
+					"resume",
+					"leave",
+					"list"
+				].some((e) => typeof Reflect.get(s, e) != "function") || typeof c.erase != "function" || typeof c.export != "function" || typeof l.run != "function") throw new t({ detail: "Rooms binding must provide complete reservation, coordinated privacy and reaper ports" });
+				if (this.binding = Object.freeze({
+					reservation: Object.freeze({
+						reserve: s.reserve.bind(s),
+						resume: s.resume.bind(s),
+						leave: s.leave.bind(s),
+						list: s.list.bind(s),
+						...typeof s.prepareMatch == "function" ? { prepareMatch: s.prepareMatch.bind(s) } : {}
+					}),
+					privacy: Object.freeze({
+						erase: c.erase.bind(c),
+						export: c.export.bind(c)
+					}),
+					reaper: Object.freeze({ run: l.run.bind(l) }),
+					...T === void 0 ? {} : { moderation: T },
+					worldState: m,
+					worldClientControl: h,
+					geometry: p,
+					release: this.releaseBinding
+				}), i.signal.aborted) throw new t({ detail: "Rooms API acquisition was cancelled" });
+				this.store = Object.freeze({ query: e.query.bind(e) }), this.phase = "ready";
+			} catch (e) {
+				if (i.abort(), e instanceof z && (this.releaseBinding = e.retryCleanup), this.releaseBinding) try {
+					await this.releaseBinding(), this.releaseBinding = null, this.binding = null;
+				} catch {}
+				throw this.phase === "binding" && (this.phase = this.releaseBinding ? "closing" : "unbound"), new t({ detail: "Rooms API binding did not complete" });
+			}
+		})();
+		return this.bindingTask = a, a.then(() => {
+			this.bindingTask = null;
+		}, () => {
+			this.bindingTask = null;
+		}), a;
+	}
+	close() {
+		if (this.closeTask) return this.closeTask;
+		this.phase = "closing", this.controller?.abort();
+		let e = (async () => {
+			try {
+				await this.bindingTask;
+			} catch {}
+			this.active > 0 && await new Promise((e) => {
+				this.idle = e;
+			}), this.releaseBinding && await this.releaseBinding(), this.binding = null, this.releaseBinding = null, this.controller = null, this.store = null, this.phase = "unbound";
+		})();
+		return this.closeTask = e, e.then(() => {
+			this.closeTask = null;
+		}, () => {
+			this.closeTask = null;
+		}), e;
+	}
+};
+//#endregion
+export { z as RoomsApiBindFailure, B as RoomsApiOwner };