@voltro/plugin-presence 0.84.0 → 0.86.0

package/THIRD-PARTY-NOTICES.md

@@ -1,70 +1,14 @@
 # Third-Party Notices — @voltro/plugin-presence
 
-This package depends on the open-source software listed below. Each is the
+This package uses the open-source software listed below. Each is the
 property of its respective copyright holders and is used under the terms of
 its license. This file is provided for attribution; it grants no rights in
 @voltro/plugin-presence itself, which is proprietary (see LICENSE).
 
-Generated from the resolved runtime dependency closure (13 packages).
+Generated from the resolved runtime dependency closure (10 packages).
 
 ---
 
-## @effect/experimental@0.61.1
-
-License: MIT
-
-```
-MIT License
-
-Copyright (c) 2023-present The Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-```
-
-## @effect/sql@0.52.1
-
-License: MIT
-
-```
-MIT License
-
-Copyright (c) 2023-present The Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-```
-
 ## @tanstack/devtools-event-client@0.4.4
 
 License: MIT
@@ -233,34 +177,6 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## layerr@3.0.0
-
-License: MIT
-
-```
-MIT License
-
-Copyright (c) 2020 Perry Mitchell
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-```
-
 ## typeid-js@1.2.0
 
 License: Apache-2.0
@@ -469,14 +385,14 @@ Apache License
    limitations under the License.
 ```
 
-## ulidx@2.4.1
+## ulid@3.0.2
 
 License: MIT
 
 ```
-MIT License
+The MIT License (MIT)
 
-Copyright (c) 2021 Perry Mitchell
+Copyright (c) 2017 Alizain Feerasta
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/errors.d.ts

@@ -1,4 +1,5 @@
 import { Schema } from 'effect';
+import { YieldableError } from 'effect/Cause';
 
 /** The caller has no presence identity — an anonymous subject (no subject id)
  *  that also passed no explicit `key`. There's nothing stable to register a
@@ -7,11 +8,9 @@ import { Schema } from 'effect';
 export declare class PresenceKeyMissing extends PresenceKeyMissing_base {
 }
 
-declare const PresenceKeyMissing_base: Schema.TaggedErrorClass<PresenceKeyMissing, "PresenceKeyMissing", {
-    readonly _tag: Schema.tag<"PresenceKeyMissing">;
-} & {
-    channel: typeof Schema.String;
-}>;
+declare const PresenceKeyMissing_base: Schema.Class<PresenceKeyMissing, Schema.TaggedStruct<"PresenceKeyMissing", {
+    readonly channel: Schema.String;
+}>, YieldableError>;
 
 /** The presence store isn't bound — `bindDataStore` never ran. This is a boot/
  *  wiring bug (the plugin wasn't installed on an app with a DataStore), not a
@@ -19,8 +18,6 @@ declare const PresenceKeyMissing_base: Schema.TaggedErrorClass<PresenceKeyMissin
 export declare class PresenceStoreUnavailable extends PresenceStoreUnavailable_base {
 }
 
-declare const PresenceStoreUnavailable_base: Schema.TaggedErrorClass<PresenceStoreUnavailable, "PresenceStoreUnavailable", {
-    readonly _tag: Schema.tag<"PresenceStoreUnavailable">;
-}>;
+declare const PresenceStoreUnavailable_base: Schema.Class<PresenceStoreUnavailable, Schema.TaggedStruct<"PresenceStoreUnavailable", {}>, YieldableError>;
 
 export { }

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import { Effect } from 'effect';
 import { ReactivityChannel } from '@voltro/protocol';
 import { Schema } from 'effect';
 import { VoltroPlugin } from '@voltro/protocol';
+import { YieldableError } from 'effect/Cause';
 
 /**
  * Wire a tracker to the transport and the membership registry.
@@ -84,11 +85,9 @@ export declare type PresenceDelta = {
 export declare class PresenceKeyMissing extends PresenceKeyMissing_base {
 }
 
-declare const PresenceKeyMissing_base: Schema.TaggedErrorClass<PresenceKeyMissing, "PresenceKeyMissing", {
-    readonly _tag: Schema.tag<"PresenceKeyMissing">;
-} & {
-    channel: typeof Schema.String;
-}>;
+declare const PresenceKeyMissing_base: Schema.Class<PresenceKeyMissing, Schema.TaggedStruct<"PresenceKeyMissing", {
+    readonly channel: Schema.String;
+}>, YieldableError>;
 
 export declare interface PresenceMember {
     /** Stable per-client key — the subject id, or a client-supplied one. */
@@ -222,9 +221,7 @@ export declare const presenceRoster: ReactivityChannel;
 export declare class PresenceStoreUnavailable extends PresenceStoreUnavailable_base {
 }
 
-declare const PresenceStoreUnavailable_base: Schema.TaggedErrorClass<PresenceStoreUnavailable, "PresenceStoreUnavailable", {
-    readonly _tag: Schema.tag<"PresenceStoreUnavailable">;
-}>;
+declare const PresenceStoreUnavailable_base: Schema.Class<PresenceStoreUnavailable, Schema.TaggedStruct<"PresenceStoreUnavailable", {}>, YieldableError>;
 
 /**
  * The merged presence view this instance can see.
@@ -245,6 +242,7 @@ export declare class PresenceTracker {
     /** This instance's id — the owner stamped on everything it tracks. */
     get owner(): string;
     private branch;
+    private removeMember;
     /**
      * Record a heartbeat from a client THIS instance holds.
      *

package/dist/index.js

@@ -1,293 +1,116 @@
-import { PresenceKeyMissing as e, PresenceStoreUnavailable as t } from "./errors.js";
-import { BASE_NAME as n, heartbeatDescriptor as r, leaveDescriptor as i, listDescriptor as a, presenceRoster as o, presenceRpcClientImports as s } from "./rpc.js";
-import { Effect as c } from "effect";
-import { definePlugin as l, pluginInstanceName as u, publishReactivity as d } from "@voltro/protocol";
-//#region src/tracker.ts
-var f = (e, t) => `${e ?? "~"}::${t}`, p = (e) => e === void 0 ? "undefined" : typeof e != "object" || !e ? JSON.stringify(e) ?? "undefined" : Array.isArray(e) ? `[${e.map(p).join(",")}]` : `{${Object.entries(e).sort(([e], [t]) => e < t ? -1 : +(e > t)).map(([e, t]) => `${JSON.stringify(e)}:${p(t)}`).join(",")}}`, m = (e, t) => e === t || e !== null && t !== null && p(e) === p(t), h = class {
-	partitions = /* @__PURE__ */ new Map();
-	selfId;
-	now;
-	constructor(e) {
-		this.selfId = e.instanceId, this.now = e.now ?? Date.now;
-	}
-	get owner() {
-		return this.selfId;
-	}
-	branch(e, t, n) {
-		let r = this.partitions.get(e);
-		r === void 0 && (r = /* @__PURE__ */ new Map(), this.partitions.set(e, r));
-		let i = f(t, n), a = r.get(i);
-		return a === void 0 && (a = {
-			tenantId: t,
-			channel: n,
-			members: /* @__PURE__ */ new Map()
-		}, r.set(i, a)), a;
-	}
-	track(e) {
-		let t = this.now(), n = e.meta ?? null, { members: r } = this.branch(this.selfId, e.tenantId, e.channel), i = r.get(e.key);
-		return r.set(e.key, {
-			key: e.key,
-			meta: n,
-			lastSeen: t
-		}), {
-			delta: {
-				op: "set",
-				channel: e.channel,
-				tenantId: e.tenantId,
-				key: e.key,
-				meta: n,
-				lastSeen: t
-			},
-			changed: i === void 0 || !m(i.meta, n)
-		};
-	}
-	untrack(e) {
-		let t = this.branch(this.selfId, e.tenantId, e.channel).members.delete(e.key);
-		return {
-			delta: {
-				op: "remove",
-				channel: e.channel,
-				tenantId: e.tenantId,
-				key: e.key
-			},
-			changed: t
-		};
-	}
-	apply(e, t) {
-		if (e === this.selfId) return !1;
-		let { members: n } = this.branch(e, t.tenantId, t.channel);
-		if (t.op === "remove") return n.delete(t.key);
-		let r = n.get(t.key);
-		return n.set(t.key, {
-			key: t.key,
-			meta: t.meta,
-			lastSeen: t.lastSeen
-		}), r === void 0 || !m(r.meta, t.meta);
-	}
-	dropOwner(e) {
-		if (e === this.selfId) return 0;
-		let t = this.partitions.get(e);
-		if (t === void 0) return 0;
-		let n = 0;
-		for (let e of t.values()) n += e.members.size;
-		return this.partitions.delete(e), n;
-	}
-	sweep(e) {
-		let t = this.partitions.get(this.selfId);
-		if (t === void 0) return [];
-		let n = this.now() - e, r = [];
-		for (let e of t.values()) for (let [t, i] of e.members) i.lastSeen >= n || (e.members.delete(t), r.push({
-			op: "remove",
-			channel: e.channel,
-			tenantId: e.tenantId,
-			key: t
-		}));
-		return r;
-	}
-	ownSnapshot() {
-		let e = [], t = this.partitions.get(this.selfId);
-		if (t === void 0) return e;
-		for (let n of t.values()) for (let t of n.members.values()) e.push({
-			op: "set",
-			channel: n.channel,
-			tenantId: n.tenantId,
-			key: t.key,
-			meta: t.meta,
-			lastSeen: t.lastSeen
-		});
-		return e;
-	}
-	roster(e, t) {
-		let n = f(t, e), r = [];
-		for (let [i, a] of this.partitions) {
-			let o = a.get(n);
-			if (o !== void 0) for (let n of o.members.values()) r.push({
-				...n,
-				owner: i,
-				channel: e,
-				tenantId: t
-			});
-		}
-		return r.sort((e, t) => t.lastSeen - e.lastSeen);
-	}
-	owners() {
-		return [...this.partitions.entries()].map(([e, t]) => {
-			let n = 0;
-			for (let e of t.values()) n += e.members.size;
-			return {
-				owner: e,
-				members: n
-			};
-		});
-	}
-	size() {
-		return this.owners().reduce((e, t) => e + t.members, 0);
-	}
-}, g = "voltro:presence", _ = (e) => typeof e == "object" && !!e && typeof e.owner == "string" && typeof e.delta == "object" && e.delta !== null, v = (e) => typeof e == "object" && !!e && typeof e.owner == "string" && Array.isArray(e.sync), y = (e) => {
-	let t = new h({
-		instanceId: e.instanceId,
-		...e.now === void 0 ? {} : { now: e.now }
-	}), n = e.logger, r = () => {
-		try {
-			e.onRosterChanged?.();
-		} catch {}
-	}, i = e.membership.onChange((e) => {
-		if (e.kind === "joined") {
-			l();
-			return;
-		}
-		let i = t.dropOwner(e.instanceId);
-		i > 0 && (n?.warn("presence: dropped members of a departed instance", {
-			instanceId: e.instanceId,
-			members: i,
-			reason: e.kind
-		}), r()), e.kind === "restarted" && l();
-	}), a = e.provider, o = e.channel ?? "voltro:presence", s = (e) => {
-		a !== void 0 && c.runPromise(a.publish(o, JSON.stringify(e))).catch(() => {});
-	}, l = () => {
-		let n = t.ownSnapshot();
-		n.length !== 0 && s({
-			owner: e.instanceId,
-			sync: n
-		});
-	}, u;
-	return a !== void 0 && c.runPromise(a.subscribe(o, (e) => {
-		let n;
-		try {
-			n = JSON.parse(e);
-		} catch {
-			return;
-		}
-		if (v(n)) {
-			let e = !1;
-			for (let r of n.sync) e = t.apply(n.owner, r) || e;
-			e && r();
-			return;
-		}
-		_(n) && t.apply(n.owner, n.delta) && r();
-	})).then((e) => {
-		u = e;
-	}, (e) => {
-		n?.warn("presence: could not subscribe — this instance will only see its own members", { cause: e });
-	}), {
-		tracker: t,
-		hasTransport: a !== void 0,
-		announce: (t) => {
-			s({
-				owner: e.instanceId,
-				delta: t
-			});
-		},
-		detach: () => {
-			i(), u?.();
-		}
-	};
-}, b = n, x = (n = {}) => {
-	if (n.timeoutMs !== void 0 && n.timeoutMs < 1e3) throw Error(`presencePlugin: \`timeoutMs\` is ${n.timeoutMs}, which expires every member before it can heartbeat again.
+import { PresenceTracker as e } from "./tracker.js";
+import { PRESENCE_BROADCAST_CHANNEL as t, attachPresenceBus as n } from "./trackerBus.js";
+import { PresenceKeyMissing as r, PresenceStoreUnavailable as i } from "./errors.js";
+import { BASE_NAME as a, heartbeatDescriptor as o, leaveDescriptor as s, listDescriptor as c, presenceRoster as l, presenceRpcClientImports as u } from "./rpc.js";
+import { Effect as d } from "effect";
+import { definePlugin as f, pluginInstanceName as p, publishReactivity as m } from "@voltro/protocol";
+//#region src/index.ts
+var h = a, g = (e = {}) => {
+	if (e.timeoutMs !== void 0 && e.timeoutMs < 1e3) throw Error(`presencePlugin: \`timeoutMs\` is ${e.timeoutMs}, which expires every member before it can heartbeat again.
   A member is online for \`timeoutMs\` after its last heartbeat, and \`usePresence\` beats every 15s by default — so this must be LARGER than your client's
   \`heartbeatMs\`, comfortably. The default pair is 30s server / 15s client.
   There is no "never expire" spelling: omit \`timeoutMs\` for the default.`);
-	let f, p = n.timeoutMs ?? 3e4, m = Math.max(1e3, Math.floor(n.sweepIntervalMs ?? p / 3)), h = u({
-		base: b,
-		alias: n.alias,
-		instance: n.name
-	}), g, _, v, x, S = () => {
-		x === void 0 && g !== void 0 && (x = setInterval(() => {
-			let e = g;
+	let t, a = e.timeoutMs ?? 3e4, g = Math.max(1e3, Math.floor(e.sweepIntervalMs ?? a / 3)), _ = p({
+		base: h,
+		alias: e.alias,
+		instance: e.name
+	}), v, y, b, x, S = () => {
+		x === void 0 && v !== void 0 && (x = setInterval(() => {
+			let e = v;
 			if (e === void 0) return;
-			let t = e.tracker.sweep(p);
+			let t = e.tracker.sweep(a);
 			if (t.length !== 0) {
 				for (let n of t) e.announce(n);
 				T();
 			}
-		}, m), x.unref?.());
+		}, g), x.unref?.());
 	}, C = (e, t) => typeof t == "string" && t.length > 0 ? t : e.request.subject?.id ?? null, w = (e) => e.request.subject?.tenantId ?? null, T = () => {
-		d(_, o);
+		m(y, l);
 	}, E = [
 		{
-			...r,
+			...o,
 			description: "Register/refresh the caller's presence in a channel.",
-			execute: (r, i) => c.gen(function* () {
-				let a = r;
-				if (!g) return yield* c.fail(new t({}));
-				let o = C(i, a.key);
-				if (o === null) return yield* c.fail(new e({ channel: a.channel }));
-				let s = n.resolveMember !== void 0 && v !== void 0 ? yield* c.promise(async () => n.resolveMember({
-					subject: i.request.subject,
+			execute: (t, n) => d.gen(function* () {
+				let a = t;
+				if (!v) return yield* d.fail(new i({}));
+				let o = C(n, a.key);
+				if (o === null) return yield* d.fail(new r({ channel: a.channel }));
+				let s = e.resolveMember !== void 0 && b !== void 0 ? yield* d.promise(async () => e.resolveMember({
+					subject: n.request.subject,
 					channel: a.channel,
 					key: o,
-					store: v
-				})) : void 0, l = n.resolveMember !== void 0 && n.identityFields !== void 0 ? Object.fromEntries(Object.entries(a.meta ?? {}).filter(([e]) => !n.identityFields.includes(e))) : a.meta, u = s === void 0 ? l : {
-					...l ?? {},
+					store: b
+				})) : void 0, c = e.resolveMember !== void 0 && e.identityFields !== void 0 ? Object.fromEntries(Object.entries(a.meta ?? {}).filter(([t]) => !e.identityFields.includes(t))) : a.meta, l = s === void 0 ? c : {
+					...c ?? {},
 					...s
-				}, d = g.tracker.track({
+				}, u = v.tracker.track({
 					channel: a.channel,
-					tenantId: w(i),
+					tenantId: w(n),
 					key: o,
-					...u === void 0 ? {} : { meta: u }
+					...l === void 0 ? {} : { meta: l }
 				});
-				return g.announce(d.delta), d.changed && T(), { ok: !0 };
+				return v.announce(u.delta), u.changed && T(), { ok: !0 };
 			})
 		},
 		{
-			...a,
+			...c,
 			description: "The online roster of a channel (heartbeat-fresh members). Push-driven — updates live.",
-			execute: (e, n) => c.gen(function* () {
-				return g ? g.tracker.roster(e.channel, w(n)).map((e) => ({
+			execute: (e, t) => d.gen(function* () {
+				return v ? v.tracker.roster(e.channel, w(t)).map((e) => ({
 					key: e.key,
 					meta: e.meta
-				})) : yield* c.fail(new t({}));
+				})) : yield* d.fail(new i({}));
 			})
 		},
 		{
-			...i,
+			...s,
 			description: "Remove the caller's presence from a channel.",
-			execute: (n, r) => c.gen(function* () {
-				let i = n;
-				if (!g) return yield* c.fail(new t({}));
-				let a = C(r, i.key);
-				if (a === null) return yield* c.fail(new e({ channel: i.channel }));
-				let o = g.tracker.untrack({
-					channel: i.channel,
-					tenantId: w(r),
+			execute: (e, t) => d.gen(function* () {
+				let n = e;
+				if (!v) return yield* d.fail(new i({}));
+				let a = C(t, n.key);
+				if (a === null) return yield* d.fail(new r({ channel: n.channel }));
+				let o = v.tracker.untrack({
+					channel: n.channel,
+					tenantId: w(t),
 					key: a
 				});
-				return g.announce(o.delta), o.changed && T(), { ok: !0 };
+				return v.announce(o.delta), o.changed && T(), { ok: !0 };
 			})
 		}
 	];
-	return l({
-		name: h,
-		baseName: b,
+	return f({
+		name: _,
+		baseName: h,
 		description: "Ephemeral realtime presence — heartbeat roster per channel.",
 		routes: E,
-		rpcClientDescriptors: s,
+		rpcClientDescriptors: u,
 		bindDataStore: (e, t) => {
-			_ = e, v = e;
-			let n = t;
-			g = y({
-				instanceId: n?.instanceId ?? `presence-${process.pid}`,
-				membership: n?.membership ?? { onChange: () => () => {} },
-				...n?.broadcast === void 0 ? {} : { provider: n.broadcast },
-				...n?.broadcastChannels?.presence === void 0 ? {} : { channel: n.broadcastChannels.presence },
+			y = e, b = e;
+			let r = t;
+			v = n({
+				instanceId: r?.instanceId ?? `presence-${process.pid}`,
+				membership: r?.membership ?? { onChange: () => () => {} },
+				...r?.broadcast === void 0 ? {} : { provider: r.broadcast },
+				...r?.broadcastChannels?.presence === void 0 ? {} : { channel: r.broadcastChannels.presence },
 				onRosterChanged: T
 			});
 		},
-		onActivate: (e) => c.sync(() => {
+		onActivate: (e) => d.sync(() => {
 			S(), e.logger.info("presence active", {
-				timeoutMs: p,
-				sweepEveryMs: m
+				timeoutMs: a,
+				sweepEveryMs: g
 			});
-			let t = Number(process.env.VOLTRO_PRESENCE_BROKER_GRACE_MS ?? 5e3), n = setTimeout(() => {
-				let t = g?.hasTransport === !0;
+			let n = Number(process.env.VOLTRO_PRESENCE_BROKER_GRACE_MS ?? 5e3), r = setTimeout(() => {
+				let t = v?.hasTransport === !0;
 				e.logger.info("presence transport", { crossInstance: t }), !t && e.logger.warn("presence: no broadcast provider — each replica sees only the clients CONNECTED TO IT. Correct for a single instance; on more than one, every screen shows a fraction of the room and nothing reports it. Add @voltro/plugin-broadcast (redis:// or nats://) to share the roster.");
-			}, t);
-			n.unref?.(), f = n;
+			}, n);
+			r.unref?.(), t = r;
 		}),
-		onDeactivate: () => c.sync(() => {
-			f !== void 0 && (clearTimeout(f), f = void 0), x !== void 0 && (clearInterval(x), x = void 0), g?.detach(), g = void 0, _ = void 0, v = void 0;
+		onDeactivate: () => d.sync(() => {
+			t !== void 0 && (clearTimeout(t), t = void 0), x !== void 0 && (clearInterval(x), x = void 0), v?.detach(), v = void 0, y = void 0, b = void 0;
 		})
 	});
 };
 //#endregion
-export { g as PRESENCE_BROADCAST_CHANNEL, e as PresenceKeyMissing, t as PresenceStoreUnavailable, h as PresenceTracker, y as attachPresenceBus, x as presencePlugin, o as presenceRoster };
+export { t as PRESENCE_BROADCAST_CHANNEL, r as PresenceKeyMissing, i as PresenceStoreUnavailable, e as PresenceTracker, n as attachPresenceBus, g as presencePlugin, l as presenceRoster };

package/dist/rpc.d.ts

@@ -3,6 +3,7 @@ import { PluginRpcClientDescriptor } from '@voltro/protocol';
 import { QueryProcedureDescriptor } from '@voltro/protocol';
 import { ReactivityChannel } from '@voltro/protocol';
 import { Schema } from 'effect';
+import { YieldableError } from 'effect/Cause';
 
 /**
  * The plugin's canonical package name — the key an app's `alias` is recorded
@@ -17,25 +18,25 @@ import { Schema } from 'effect';
 export declare const BASE_NAME = "@voltro/plugin-presence";
 
 export declare const heartbeatDescriptor: MutationProcedureDescriptor<"presence.heartbeat", Schema.Struct<{
-    channel: typeof Schema.String;
-    key: Schema.optional<typeof Schema.String>;
-    meta: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    readonly channel: Schema.String;
+    readonly key: Schema.optional<Schema.String>;
+    readonly meta: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
 }>, Schema.Struct<{
-    ok: typeof Schema.Boolean;
-}>, Schema.Union<[typeof PresenceKeyMissing, typeof PresenceStoreUnavailable]>>;
+    readonly ok: Schema.Boolean;
+}>, Schema.Union<readonly [typeof PresenceKeyMissing, typeof PresenceStoreUnavailable]>>;
 
 export declare const leaveDescriptor: MutationProcedureDescriptor<"presence.leave", Schema.Struct<{
-    channel: typeof Schema.String;
-    key: Schema.optional<typeof Schema.String>;
+    readonly channel: Schema.String;
+    readonly key: Schema.optional<Schema.String>;
 }>, Schema.Struct<{
-    ok: typeof Schema.Boolean;
-}>, Schema.Union<[typeof PresenceKeyMissing, typeof PresenceStoreUnavailable]>>;
+    readonly ok: Schema.Boolean;
+}>, Schema.Union<readonly [typeof PresenceKeyMissing, typeof PresenceStoreUnavailable]>>;
 
 export declare const listDescriptor: QueryProcedureDescriptor<"presence.list", Schema.Struct<{
-    channel: typeof Schema.String;
-}>, Schema.Array$<Schema.Struct<{
-    key: typeof Schema.String;
-    meta: Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    readonly channel: Schema.String;
+}>, Schema.$Array<Schema.Struct<{
+    readonly key: Schema.String;
+    readonly meta: Schema.NullOr<Schema.$Record<Schema.String, Schema.Unknown>>;
 }>>, typeof PresenceStoreUnavailable>;
 
 /** The caller has no presence identity — an anonymous subject (no subject id)
@@ -45,11 +46,9 @@ export declare const listDescriptor: QueryProcedureDescriptor<"presence.list", S
 declare class PresenceKeyMissing extends PresenceKeyMissing_base {
 }
 
-declare const PresenceKeyMissing_base: Schema.TaggedErrorClass<PresenceKeyMissing, "PresenceKeyMissing", {
-    readonly _tag: Schema.tag<"PresenceKeyMissing">;
-} & {
-    channel: typeof Schema.String;
-}>;
+declare const PresenceKeyMissing_base: Schema.Class<PresenceKeyMissing, Schema.TaggedStruct<"PresenceKeyMissing", {
+    readonly channel: Schema.String;
+}>, YieldableError>;
 
 /**
  * The roster's reactivity channel — presence's push target.
@@ -76,8 +75,6 @@ export declare const presenceRpcClientImports: ReadonlyArray<PluginRpcClientDesc
 declare class PresenceStoreUnavailable extends PresenceStoreUnavailable_base {
 }
 
-declare const PresenceStoreUnavailable_base: Schema.TaggedErrorClass<PresenceStoreUnavailable, "PresenceStoreUnavailable", {
-    readonly _tag: Schema.tag<"PresenceStoreUnavailable">;
-}>;
+declare const PresenceStoreUnavailable_base: Schema.Class<PresenceStoreUnavailable, Schema.TaggedStruct<"PresenceStoreUnavailable", {}>, YieldableError>;
 
 export { }

package/dist/rpc.js

@@ -4,22 +4,16 @@ import { defineMutation as r, defineQuery as i, reactivityChannel as a } from "@
 //#region src/rpc.ts
 var o = "@voltro/plugin-presence", s = a("presence"), c = n.Struct({
 	key: n.String,
-	meta: n.NullOr(n.Record({
-		key: n.String,
-		value: n.Unknown
-	}))
+	meta: n.NullOr(n.Record(n.String, n.Unknown))
 }), l = r({
 	name: "presence.heartbeat",
 	input: n.Struct({
 		channel: n.String,
 		key: n.optional(n.String),
-		meta: n.optional(n.Record({
-			key: n.String,
-			value: n.Unknown
-		}))
+		meta: n.optional(n.Record(n.String, n.Unknown))
 	}),
 	output: n.Struct({ ok: n.Boolean }),
-	error: n.Union(e, t),
+	error: n.Union([e, t]),
 	openAccess: "presence serves anonymous-capable apps; the tracked key defaults to the caller's own subject id (PresenceKeyMissing without one) and entries are tenant-scoped in the tracker"
 }), u = i({
 	name: "presence.list",
@@ -35,7 +29,7 @@ var o = "@voltro/plugin-presence", s = a("presence"), c = n.Struct({
 		key: n.optional(n.String)
 	}),
 	output: n.Struct({ ok: n.Boolean }),
-	error: n.Union(e, t),
+	error: n.Union([e, t]),
 	openAccess: "presence serves anonymous-capable apps; the key to remove defaults to the caller's own subject id (PresenceKeyMissing without one) and removal is tenant-scoped in the tracker"
 }), f = [
 	{