@abraca/dabra 2.6.0 → 2.8.0

package/dist/abracadabra-provider.esm.js

@@ -2298,6 +2298,21 @@ var QueryClient = class extends EventEmitter {
 	}
 };
 
+//#endregion
+//#region packages/provider/src/OutgoingMessages/QueryAwarenessMessage.ts
+var QueryAwarenessMessage = class extends OutgoingMessage {
+	constructor(..._args) {
+		super(..._args);
+		this.type = MessageType.QueryAwareness;
+		this.description = "Queries awareness states";
+	}
+	get(args) {
+		writeVarString(this.encoder, args.documentName);
+		writeVarUint(this.encoder, this.type);
+		return this.encoder;
+	}
+};
+
 //#endregion
 //#region packages/provider/src/OutgoingMessages/SyncStepOneMessage.ts
 var SyncStepOneMessage = class extends OutgoingMessage {
@@ -2580,6 +2595,7 @@ var AbracadabraBaseProvider = class extends EventEmitter {
 			clients: [this.document.clientID],
 			documentName: this.configuration.name
 		});
+		if (this.awareness) this.send(QueryAwarenessMessage, { documentName: this.configuration.name });
 	}
 	send(message, args) {
 		if (!this._isAttached) return;
@@ -15660,6 +15676,19 @@ function makeEntryMap(fields) {
 	return m;
 }
 /**
+* A label is a "placeholder" — i.e. carries no real user title — when it is
+* empty/whitespace, null/undefined, or the literal `"Untitled"` sentinel
+* (case-insensitive, so `"untitled"` from a `labelToFilename` round-trip is
+* caught too). The whole tree-label corruption class boils down to a
+* placeholder being allowed to overwrite a real title; `patchEntry` refuses
+* exactly that. Mirrors cou-sh's `isEmptyTreeLabel`.
+*/
+function isPlaceholderLabel(label) {
+	if (typeof label !== "string") return label == null;
+	const t = label.trim();
+	return t === "" || t.toLowerCase() === "untitled";
+}
+/**
 * Patch an EXISTING entry's fields per-key on its nested `Y.Map`, so a
 * concurrent edit to a *different* field by a peer is preserved instead
 * of being clobbered by a whole-entry write — the whole-entry-LWW fix
@@ -15674,21 +15703,44 @@ function makeEntryMap(fields) {
 * Self-transacting: it batches its writes in one `Y.Doc` transaction
 * (a safe reentrant no-op join when already inside one), so callers
 * don't need to pass or own a transaction.
+*
+* ── NO-DESTROY LABEL INVARIANT ──────────────────────────────────────────
+* A `label` patch that is a placeholder (empty/whitespace/"Untitled") is
+* DROPPED when the entry already holds a real (non-placeholder) label —
+* regardless of which consumer (cou-sh title-sync, fs-sync rename
+* detection, MCP, table renderers, a stale snapshot) tried it. This is the
+* source-of-truth guard against the "card title silently becomes Untitled
+* / files renamed to untitled.md" corruption: a placeholder must never win
+* over a real title. Creating a brand-new entry with an empty label (e.g.
+* a fresh kanban card) is still allowed — the guard only fires when a real
+* label already exists. Pass `{ allowLabelClear: true }` to override (the
+* single legitimate "user explicitly cleared it" path).
 */
-function patchEntry(treeMap, id, patch, removeKeys = []) {
+function patchEntry(treeMap, id, patch, removeKeys = [], opts = {}) {
 	const apply = () => {
 		const raw = treeMap.get(id);
+		let effectivePatch = patch;
+		if (!opts.allowLabelClear && Object.hasOwn(patch, "label") && isPlaceholderLabel(patch.label)) {
+			let existingLabel;
+			if (raw != null && typeof raw.get === "function") existingLabel = raw.get("label");
+			else if (raw != null && typeof raw.toJSON === "function") existingLabel = raw.toJSON()?.label;
+			else if (raw != null && typeof raw === "object") existingLabel = raw.label;
+			if (!isPlaceholderLabel(existingLabel)) {
+				const { label: _dropped, ...rest } = patch;
+				effectivePatch = rest;
+			}
+		}
 		if (raw instanceof Y.Map) {
-			for (const [k, v] of Object.entries(patch)) if (v === void 0) raw.delete(k);
+			for (const [k, v] of Object.entries(effectivePatch)) if (v === void 0) raw.delete(k);
 			else raw.set(k, v);
 			for (const k of removeKeys) raw.delete(k);
 			return;
 		}
 		const merged = {
 			...raw == null ? {} : toPlain(raw),
-			...patch
+			...effectivePatch
 		};
-		for (const [k, v] of Object.entries(patch)) if (v === void 0) delete merged[k];
+		for (const [k, v] of Object.entries(effectivePatch)) if (v === void 0) delete merged[k];
 		for (const k of removeKeys) delete merged[k];
 		treeMap.set(id, makeEntryMap(merged));
 	};
@@ -20255,8 +20307,13 @@ var ContentManager = class {
 	}
 	/**
 	* Read document content as markdown.
-	* Returns the title extracted from the TipTap documentHeader, the markdown
-	* body, tree metadata, and immediate children.
+	*
+	* Returns the markdown body, tree-derived label/type/meta, and immediate
+	* children. `title` mirrors `label` (the tree entry's display name) — it
+	* is *not* derived from a TipTap `documentHeader`, and the markdown body
+	* does NOT include YAML frontmatter. Callers that want frontmatter-style
+	* round-tripping should serialise `meta`/`type` themselves on top of the
+	* returned markdown.
 	*/
 	async read(docId) {
 		const fragment = (await this.dm.getChildProvider(docId)).document.getXmlFragment("default");
@@ -20291,7 +20348,7 @@ var ContentManager = class {
 			type,
 			meta
 		}));
-		const markdown = yjsToMarkdown(fragment, label, meta, type);
+		const { markdown } = yjsToMarkdown(fragment);
 		return {
 			label,
 			type,
@@ -20723,5 +20780,5 @@ var DocumentManager = class {
 };
 
 //#endregion
-export { AbracadabraBaseProvider, AbracadabraClient, AbracadabraProvider, AbracadabraWS, AbracadabraWebRTC, AuthMessageType, AwarenessError, BackgroundSyncManager, BackgroundSyncPersistence, BroadcastChannelSync, CHANNEL_NAMES, ChannelKeyResolver, ChatClient, ConnectionTimeout, ContentManager, CryptoIdentityKeystore, DEFAULT_FILE_CHUNK_SIZE, DEFAULT_ICE_SERVERS, DataChannelRouter, DevicePairingChannel, DeviceRegistrationService, DocKeyManager, DocumentCache, DocumentManager, E2EAbracadabraProvider, E2EEChannel, E2EOfflineStore, EncryptedChatClient, EncryptedYMap, EncryptedYText, FileBlobStore, FileTransferChannel, FileTransferHandle, Forbidden, GEO_TYPE_META_SCHEMAS, HocuspocusProvider, HocuspocusProviderWebsocket, IdentityDocProvider, KEY_EXCHANGE_CHANNEL, Kind, LocalStorageDeviceSessionStorage, ManualSignaling, MessageTooBig, MessageType, MetaManager, MetaValidationError, NotificationsClient, OfflineStore, PAGE_TYPES, PeerConnection, QUERY_PREFIX, QueryClient, QueryError, RPC_PREFIX, ResetConnection, RpcClient, RpcError, SERVER_ROOT_ID, SearchIndex, SignalingSocket, SubdocMessage, TYPE_ALIASES, TokenManager, TreeManager, TypedDocTypeMismatchError, Unauthorized, WebSocketStatus, WsReadyStates, YjsDataChannel, attachUpdatedAtObserver, awarenessStatesToArray, wordlist as bip39Wordlist, buildBlockquoteElement, buildBlocksFromMarkdown, buildBulletListElement, buildCodeBlockElement, buildHeadingElement, buildHorizontalRuleElement, buildOrderedListElement, buildParagraphElement, buildTaskListElement, decryptChatContent, decryptField, deriveIdentityDocId, deriveSeedWrappingKey, encryptChatContent, encryptField, filenameToLabel, foldRecords, generateMnemonic, isEncryptedContent, makeEncryptedYMap, makeEncryptedYText, makeEntryMap, mnemonicToEd25519Seed, mnemonicToKeyPair, normalizeRootId, parseFrontmatter, patchEntry, populateYDocFromMarkdown, readAuthMessage, readBlocksFromFragment, recordFromYAny, resolvePageType, toPlain, unwrapSeed, validateMnemonic, waitForSync, withTimeout, wrapSeed, writeAuthenticated, writeAuthentication, writePermissionDenied, writeTokenSyncRequest, yjsToMarkdown };
+export { AbracadabraBaseProvider, AbracadabraClient, AbracadabraProvider, AbracadabraWS, AbracadabraWebRTC, AuthMessageType, AwarenessError, BackgroundSyncManager, BackgroundSyncPersistence, BroadcastChannelSync, CHANNEL_NAMES, ChannelKeyResolver, ChatClient, ConnectionTimeout, ContentManager, CryptoIdentityKeystore, DEFAULT_FILE_CHUNK_SIZE, DEFAULT_ICE_SERVERS, DataChannelRouter, DevicePairingChannel, DeviceRegistrationService, DocKeyManager, DocumentCache, DocumentManager, E2EAbracadabraProvider, E2EEChannel, E2EOfflineStore, EncryptedChatClient, EncryptedYMap, EncryptedYText, FileBlobStore, FileTransferChannel, FileTransferHandle, Forbidden, GEO_TYPE_META_SCHEMAS, HocuspocusProvider, HocuspocusProviderWebsocket, IdentityDocProvider, KEY_EXCHANGE_CHANNEL, Kind, LocalStorageDeviceSessionStorage, ManualSignaling, MessageTooBig, MessageType, MetaManager, MetaValidationError, NotificationsClient, OfflineStore, PAGE_TYPES, PeerConnection, QUERY_PREFIX, QueryClient, QueryError, RPC_PREFIX, ResetConnection, RpcClient, RpcError, SERVER_ROOT_ID, SearchIndex, SignalingSocket, SubdocMessage, TYPE_ALIASES, TokenManager, TreeManager, TypedDocTypeMismatchError, Unauthorized, WebSocketStatus, WsReadyStates, YjsDataChannel, attachUpdatedAtObserver, awarenessStatesToArray, wordlist as bip39Wordlist, buildBlockquoteElement, buildBlocksFromMarkdown, buildBulletListElement, buildCodeBlockElement, buildHeadingElement, buildHorizontalRuleElement, buildOrderedListElement, buildParagraphElement, buildTaskListElement, decryptChatContent, decryptField, deriveIdentityDocId, deriveSeedWrappingKey, encryptChatContent, encryptField, filenameToLabel, foldRecords, generateMnemonic, isEncryptedContent, isPlaceholderLabel, makeEncryptedYMap, makeEncryptedYText, makeEntryMap, mnemonicToEd25519Seed, mnemonicToKeyPair, normalizeRootId, parseFrontmatter, patchEntry, populateYDocFromMarkdown, readAuthMessage, readBlocksFromFragment, recordFromYAny, resolvePageType, toPlain, unwrapSeed, validateMnemonic, waitForSync, withTimeout, wrapSeed, writeAuthenticated, writeAuthentication, writePermissionDenied, writeTokenSyncRequest, yjsToMarkdown };
 //# sourceMappingURL=abracadabra-provider.esm.js.map