@voltro/plugin-presence 0.83.1 → 0.85.0

package/THIRD-PARTY-NOTICES.md

@@ -5,66 +5,10 @@ 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 (11 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

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

@@ -23,6 +23,14 @@ var f = (e, t) => `${e ?? "~"}::${t}`, p = (e) => e === void 0 ? "undefined" : t
 			members: /* @__PURE__ */ new Map()
 		}, r.set(i, a)), a;
 	}
+	removeMember(e, t, n, r) {
+		let i = this.partitions.get(e);
+		if (i === void 0) return !1;
+		let a = f(t, n), o = i.get(a);
+		if (o === void 0) return !1;
+		let s = o.members.delete(r);
+		return o.members.size === 0 && i.delete(a), i.size === 0 && this.partitions.delete(e), s;
+	}
 	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, {
@@ -42,7 +50,7 @@ var f = (e, t) => `${e ?? "~"}::${t}`, p = (e) => e === void 0 ? "undefined" : t
 		};
 	}
 	untrack(e) {
-		let t = this.branch(this.selfId, e.tenantId, e.channel).members.delete(e.key);
+		let t = this.removeMember(this.selfId, e.tenantId, e.channel, e.key);
 		return {
 			delta: {
 				op: "remove",
@@ -55,9 +63,8 @@ var f = (e, t) => `${e ?? "~"}::${t}`, p = (e) => e === void 0 ? "undefined" : 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);
+		if (t.op === "remove") return this.removeMember(e, t.tenantId, t.channel, t.key);
+		let { members: n } = this.branch(e, t.tenantId, t.channel), r = n.get(t.key);
 		return n.set(t.key, {
 			key: t.key,
 			meta: t.meta,
@@ -76,13 +83,16 @@ var f = (e, t) => `${e ?? "~"}::${t}`, p = (e) => e === void 0 ? "undefined" : t
 		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;
+		for (let [e, i] of t) {
+			for (let [e, t] of i.members) t.lastSeen >= n || (i.members.delete(e), r.push({
+				op: "remove",
+				channel: i.channel,
+				tenantId: i.tenantId,
+				key: e
+			}));
+			i.members.size === 0 && t.delete(e);
+		}
+		return t.size === 0 && this.partitions.delete(this.selfId), r;
 	}
 	ownSnapshot() {
 		let e = [], t = this.partitions.get(this.selfId);

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 = [
 	{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-presence",
-  "version": "0.83.1",
+  "version": "0.85.0",
   "description": "Ephemeral realtime presence — who is online in a channel, with heartbeat + live roster + per-member metadata (cursor, status — client-supplied and relayed verbatim; identity fields belong in the server-side resolveMember hook). Held in memory, owner-partitioned; cross-instance with @voltro/plugin-broadcast.",
   "keywords": [
     "voltro",
@@ -48,12 +48,12 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/client": "0.83.1",
-    "@voltro/protocol": "0.83.1"
+    "@voltro/client": "0.85.0",
+    "@voltro/protocol": "0.85.0"
   },
   "peerDependencies": {
-    "@voltro/database": "0.83.1",
-    "effect": "^3.22.2",
+    "@voltro/database": "0.85.0",
+    "effect": "4.0.1",
     "react": "^19.0.0"
   },
   "peerDependenciesMeta": {