docblocks-core 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # docblocks-core
 
+## 0.1.3
+
+### Patch Changes
+
+- 5971d30: `PresenceState` now passes through the awareness payload's sharing
+  contract fields — the consumer user identity (`userId` / `name`), the
+  opaque ciphertext selection entries (`selections`), and the publication
+  counter (`seq`). The ws-provider mapper validates them defensively; a
+  legacy frame keeps its pre-sharing shape.
+
 ## 0.1.2
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1287,6 +1287,27 @@ interface PresenceState {
   selection: PresenceSelection | null;
   /** Unix milliseconds. Staleness handling (TTL) is a consumer concern. */
   updatedAt: number;
+  /**
+   * Consumer-provided stable user identity (optional; absent on legacy
+   * peers). `peerId` is the anonymous transport-level identifier —
+   * `userId` is the only addressable identity.
+   */
+  userId?: string;
+  /** Consumer-provided roster display label (optional). */
+  name?: string;
+  /**
+   * Opaque ciphertext selection entries (optional): one per share
+   * target, no target id inside the entry — the recipient tries each
+   * entry with its own decryptor. Absent when the peer shares with
+   * everyone (plaintext `selection`) or not at all.
+   */
+  selections?: string[];
+  /**
+   * Monotonic per-publisher selection publication counter (optional):
+   * the recipient discards a decrypted selection whose `seq` is older
+   * than the last accepted one for the peer (the async decrypt race).
+   */
+  seq?: number;
 }
 /**
  * Transport for syncing one document with peers.

package/dist/index.mjs

@@ -6255,6 +6255,18 @@ function parseSelection(value) {
 	if (isStringArray(sel.blocks)) return { blocks: [...sel.blocks] };
 	return null;
 }
+/** The sharing-contract presence extras (identity, ciphertext entries, the
+*  publication counter): defensive validation, absent for legacy peers. */
+function parsePresenceExtras(value) {
+	if (typeof value !== "object" || value === null) return {};
+	const state = value;
+	const extras = {};
+	if (typeof state.userId === "string") extras.userId = state.userId;
+	if (typeof state.name === "string") extras.name = state.name;
+	if (isStringArray(state.selections)) extras.selections = [...state.selections];
+	if (typeof state.seq === "number") extras.seq = state.seq;
+	return extras;
+}
 /** The default socket factory: the global WebSocket, normalized to WsLike. */
 const defaultWebSocketImpl = (url) => {
 	const ws = new WebSocket(url);
@@ -6591,7 +6603,8 @@ var WsSyncProvider = class {
 			peers.push({
 				peerId: String(clientID),
 				selection: parseSelection(state.selection),
-				updatedAt: typeof state.updatedAt === "number" ? state.updatedAt : 0
+				updatedAt: typeof state.updatedAt === "number" ? state.updatedAt : 0,
+				...parsePresenceExtras(state)
 			});
 		});
 		return peers;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docblocks-core",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Headless CRDT document engine: schema v1, Doc (commands/transactions/undo), sync providers. Yjs-based, zero UI dependencies.",
   "type": "module",
   "license": "MIT",