@xopcai/xopc 0.0.89 → 0.0.91

package/dist/src/notes/service.js

@@ -0,0 +1,331 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { attachmentIdFromTarget, buildNoteAttachmentRef } from "./attachment-ref.js";
+import { partitionAttachmentsByReference } from "./note-attachment-sync.js";
+import { randomUUID } from "node:crypto";
+//#region src/notes/service.ts
+init_logger();
+const log = createLogger("NotesService");
+function inferKind(text, hasAttachments, attachments) {
+	if (hasAttachments && attachments?.length && attachments.every((item) => item.type === "audio")) return "voice";
+	if (hasAttachments) return "media";
+	if (!text) return "thought";
+	const lower = text.toLowerCase();
+	if (/^(todo|task|remind|buy|call|email|meet|finish|submit|send)\b/i.test(lower) || /\b(明天|今天|记得|别忘|待办|提醒)\b/.test(text)) return "todo";
+	if (/^https?:\/\//.test(text.trim())) return "bookmark";
+	return "thought";
+}
+function createBlockId() {
+	return `block_${Date.now()}_${randomUUID().slice(0, 8)}`;
+}
+const IMAGE_MARKDOWN = /^!\[([^\]]*)\]\(([^)]+)\)$/;
+function noteTextToBlocks(text, noteId) {
+	if (!text?.trim()) return void 0;
+	const now = Date.now();
+	return text.split(/\n{2,}/).map((part) => {
+		const trimmed = part.trim();
+		if (noteId) {
+			const imageMatch = trimmed.match(IMAGE_MARKDOWN);
+			if (imageMatch) {
+				const attachmentId = attachmentIdFromTarget(imageMatch[2], noteId);
+				if (attachmentId) return {
+					id: createBlockId(),
+					type: "image",
+					attachmentId,
+					alt: imageMatch[1] || void 0,
+					createdAt: now,
+					updatedAt: now
+				};
+			}
+		}
+		return {
+			id: createBlockId(),
+			type: "paragraph",
+			text: trimmed,
+			createdAt: now,
+			updatedAt: now
+		};
+	});
+}
+function blocksToPlainText(blocks, noteId) {
+	if (!blocks?.length) return void 0;
+	return blocks.map((block) => {
+		if (block.type === "divider") return "---";
+		if (block.type === "todo") return `${block.checked ? "[x]" : "[ ]"} ${block.text}`;
+		if (block.type === "image") {
+			if (noteId) return `![${block.alt ?? ""}](${buildNoteAttachmentRef(noteId, block.attachmentId)})`;
+			return block.alt ?? "";
+		}
+		return block.text;
+	}).filter((text) => text.trim().length > 0).join("\n\n");
+}
+function createAiOrganizedBlocks(blocks, instruction) {
+	const now = Date.now();
+	const lines = (blocksToPlainText(blocks) || "").split(/\n+/).map((line) => line.trim()).filter(Boolean);
+	const wantsTodos = /待办|todo|task|行动|提醒/i.test(instruction);
+	const wantsSummary = /摘要|总结|summary|压缩/i.test(instruction);
+	if (wantsTodos) {
+		const candidates = lines.filter((line) => /要|需|记得|todo|task|完成|提交|联系|跟进|提醒/i.test(line));
+		return (candidates.length ? candidates : lines).slice(0, 12).map((line) => ({
+			id: createBlockId(),
+			type: "todo",
+			text: line.replace(/^[-*\d.\s\[\]x]+/i, "").trim(),
+			checked: false,
+			createdAt: now,
+			updatedAt: now
+		}));
+	}
+	if (wantsSummary) {
+		const summary = lines.join(" ").slice(0, 220);
+		return [{
+			id: createBlockId(),
+			type: "paragraph",
+			text: summary,
+			createdAt: now,
+			updatedAt: now
+		}];
+	}
+	const titleText = lines[0]?.slice(0, 40) || "整理后的笔记";
+	const bodyLines = lines.slice(1).length ? lines.slice(1) : lines;
+	return [{
+		id: createBlockId(),
+		type: "heading",
+		text: titleText,
+		level: 2,
+		createdAt: now,
+		updatedAt: now
+	}, ...bodyLines.map((line) => ({
+		id: createBlockId(),
+		type: "bulletList",
+		text: line.replace(/^[-*\d.\s]+/, "").trim(),
+		indent: 0,
+		createdAt: now,
+		updatedAt: now
+	}))];
+}
+const SNAPSHOT_THROTTLE_MS = 6e4;
+const MAX_SNAPSHOTS_PER_NOTE = 30;
+var NotesService = class {
+	store;
+	lastSnapshotAt = /* @__PURE__ */ new Map();
+	constructor(store) {
+		this.store = store;
+	}
+	async initialize() {
+		await this.store.initialize();
+		log.debug("NotesService initialized");
+	}
+	async quickCapture(text, source) {
+		const now = Date.now();
+		const id = randomUUID();
+		const blocks = noteTextToBlocks(text, id);
+		const note = {
+			id,
+			kind: inferKind(text),
+			status: "inbox",
+			text,
+			blocks,
+			createdAt: now,
+			updatedAt: now,
+			capturedVia: source,
+			localVersion: 0,
+			remoteVersion: 1
+		};
+		await this.store.addNote(note);
+		log.debug({
+			id: note.id,
+			kind: note.kind
+		}, "Quick capture");
+		return note;
+	}
+	async createNote(params) {
+		const now = Date.now();
+		const id = randomUUID();
+		const blocks = params.blocks ?? noteTextToBlocks(params.text, id);
+		const text = params.text ?? blocksToPlainText(blocks, id);
+		const note = {
+			id,
+			title: params.title,
+			kind: params.kind || inferKind(text),
+			status: "inbox",
+			text,
+			blocks,
+			createdAt: now,
+			updatedAt: now,
+			capturedVia: params.capturedVia,
+			tags: params.tags,
+			pinned: params.pinned,
+			localVersion: 0,
+			remoteVersion: 1
+		};
+		await this.store.addNote(note);
+		log.debug({
+			id: note.id,
+			kind: note.kind
+		}, "Note created");
+		return note;
+	}
+	async getNote(id) {
+		return this.store.getNote(id);
+	}
+	async updateNote(id, patch, trigger = "edit") {
+		const existing = await this.store.getNote(id);
+		if (!existing) return null;
+		const contentTouched = patch.text !== void 0 || patch.blocks !== void 0 || patch.title !== void 0;
+		if (contentTouched) await this.maybeSaveSnapshot(existing, trigger);
+		const normalizedPatch = { ...patch };
+		if (patch.blocks) normalizedPatch.text = patch.text ?? blocksToPlainText(patch.blocks, existing.id);
+		else if (typeof patch.text === "string") normalizedPatch.blocks = patch.blocks ?? noteTextToBlocks(patch.text, existing.id);
+		normalizedPatch.remoteVersion = (existing.remoteVersion ?? 0) + 1;
+		if (contentTouched) {
+			const merged = {
+				...existing,
+				...normalizedPatch,
+				id: existing.id,
+				createdAt: existing.createdAt,
+				updatedAt: Date.now()
+			};
+			const reconciled = await this.reconcileAttachments(merged);
+			normalizedPatch.attachments = reconciled.attachments;
+			normalizedPatch.kind = reconciled.kind;
+		}
+		return this.store.updateNote(id, normalizedPatch);
+	}
+	async reconcileAttachments(note) {
+		const { kept, removed } = partitionAttachmentsByReference(note);
+		if (removed.length === 0) return note;
+		for (const attachment of removed) await this.store.deleteAttachmentFile(note.id, attachment.relativePath);
+		log.debug({
+			noteId: note.id,
+			removedIds: removed.map((attachment) => attachment.id)
+		}, "Pruned orphan note attachments");
+		const hasAttachments = kept.length > 0;
+		return {
+			...note,
+			attachments: hasAttachments ? kept : void 0,
+			kind: inferKind(note.text, hasAttachments, kept)
+		};
+	}
+	async syncNote(id, patch, baseRemoteVersion) {
+		const existing = await this.store.getNote(id);
+		if (!existing) return {
+			note: null,
+			conflict: false
+		};
+		const currentRemoteVersion = existing.remoteVersion ?? 0;
+		if (baseRemoteVersion !== void 0 && baseRemoteVersion < currentRemoteVersion) return {
+			note: existing,
+			conflict: true
+		};
+		return {
+			note: await this.updateNote(id, patch, "sync"),
+			conflict: false
+		};
+	}
+	async createAiEditPatch(id, instruction, blocks) {
+		const note = await this.store.getNote(id);
+		if (!note) return null;
+		const organizedBlocks = createAiOrganizedBlocks(blocks?.length ? blocks : note.blocks ?? noteTextToBlocks(note.text, note.id) ?? [], instruction);
+		return {
+			message: "AI edit patch generated",
+			patch: {
+				id: randomUUID(),
+				summary: `已根据「${instruction.slice(0, 40)}」生成可预览的块级整理建议`,
+				operations: [{
+					type: "replaceBlocks",
+					blocks: organizedBlocks
+				}]
+			}
+		};
+	}
+	async deleteNote(id) {
+		const deleted = await this.store.deleteNote(id);
+		if (deleted) {
+			await this.store.deleteAllSnapshots(id);
+			this.lastSnapshotAt.delete(id);
+		}
+		return deleted;
+	}
+	async listNotes(query = {}) {
+		return this.store.listNotes(query);
+	}
+	async addAttachment(noteId, file) {
+		const note = await this.store.getNote(noteId);
+		if (!note) return null;
+		const { relativePath, size } = await this.store.saveAttachment(noteId, file.name, file.buffer);
+		const attachment = {
+			id: randomUUID(),
+			type: inferAttachmentType(file.mimeType),
+			mimeType: file.mimeType,
+			fileName: file.name,
+			size,
+			relativePath,
+			duration: file.duration
+		};
+		const attachments = [...note.attachments || [], attachment];
+		const kind = note.kind === "thought" && attachment.type === "audio" ? "voice" : note.kind === "thought" ? "media" : note.kind;
+		await this.store.updateNote(noteId, {
+			attachments,
+			kind
+		});
+		return attachment;
+	}
+	async getAttachmentPath(noteId, attachmentId) {
+		const note = await this.store.getNote(noteId);
+		if (!note) return null;
+		const attachment = note.attachments?.find((a) => a.id === attachmentId);
+		if (!attachment) return null;
+		return {
+			filePath: this.store.resolveAttachmentPath(noteId, attachment.relativePath),
+			mimeType: attachment.mimeType,
+			fileName: attachment.fileName
+		};
+	}
+	async listNoteHistory(noteId) {
+		return this.store.listSnapshots(noteId);
+	}
+	async getNoteSnapshot(noteId, timestamp) {
+		return this.store.getSnapshot(noteId, timestamp);
+	}
+	async restoreNoteSnapshot(noteId, timestamp) {
+		const snapshot = await this.store.getSnapshot(noteId, timestamp);
+		if (!snapshot) return null;
+		const existing = await this.store.getNote(noteId);
+		if (!existing) return null;
+		await this.store.saveSnapshot(existing, "restore");
+		this.lastSnapshotAt.set(noteId, Date.now());
+		await this.store.pruneSnapshots(noteId, MAX_SNAPSHOTS_PER_NOTE);
+		return this.store.updateNote(noteId, {
+			title: snapshot.title,
+			text: snapshot.text,
+			blocks: snapshot.blocks,
+			tags: snapshot.tags
+		});
+	}
+	async flush() {
+		await this.store.flush();
+	}
+	async maybeSaveSnapshot(note, trigger) {
+		if (trigger !== "edit") {
+			await this.store.saveSnapshot(note, trigger);
+			this.lastSnapshotAt.set(note.id, Date.now());
+			await this.store.pruneSnapshots(note.id, MAX_SNAPSHOTS_PER_NOTE);
+			return;
+		}
+		const last = this.lastSnapshotAt.get(note.id) ?? 0;
+		if (Date.now() - last < SNAPSHOT_THROTTLE_MS) return;
+		await this.store.saveSnapshot(note, trigger);
+		this.lastSnapshotAt.set(note.id, Date.now());
+		await this.store.pruneSnapshots(note.id, MAX_SNAPSHOTS_PER_NOTE);
+	}
+};
+function inferAttachmentType(mimeType) {
+	if (mimeType.startsWith("image/")) return "image";
+	if (mimeType.startsWith("video/")) return "video";
+	if (mimeType.startsWith("audio/")) return "audio";
+	return "file";
+}
+//#endregion
+export { NotesService };
+
+//# sourceMappingURL=service.js.map

package/dist/src/notes/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","names":[],"sources":["../../../src/notes/service.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { createLogger } from '../utils/logger.js';\nimport { buildNoteAttachmentRef, attachmentIdFromTarget } from './attachment-ref.js';\nimport { partitionAttachmentsByReference } from './note-attachment-sync.js';\nimport { NotesStore } from './store.js';\nimport type {\n  CaptureSource,\n  CreateNoteParams,\n  Note,\n  NoteAiPatch,\n  NoteAttachment,\n  NoteBlock,\n  NoteIndexEntry,\n  NoteKind,\n  NoteSnapshot,\n  NoteSnapshotEntry,\n  NotesListQuery,\n  SnapshotTrigger,\n} from './types.js';\n\nconst log = createLogger('NotesService');\n\nfunction inferKind(\n  text?: string,\n  hasAttachments?: boolean,\n  attachments?: NoteAttachment[],\n): NoteKind {\n  if (hasAttachments && attachments?.length && attachments.every((item) => item.type === 'audio')) {\n    return 'voice';\n  }\n  if (hasAttachments) return 'media';\n  if (!text) return 'thought';\n  const lower = text.toLowerCase();\n  if (/^(todo|task|remind|buy|call|email|meet|finish|submit|send)\\b/i.test(lower) ||\n      /\\b(明天|今天|记得|别忘|待办|提醒)\\b/.test(text)) {\n    return 'todo';\n  }\n  if (/^https?:\\/\\//.test(text.trim())) return 'bookmark';\n  return 'thought';\n}\n\nfunction createBlockId(): string {\n  return `block_${Date.now()}_${randomUUID().slice(0, 8)}`;\n}\n\nconst IMAGE_MARKDOWN = /^!\\[([^\\]]*)\\]\\(([^)]+)\\)$/;\n\nfunction noteTextToBlocks(text?: string, noteId?: string): NoteBlock[] | undefined {\n  if (!text?.trim()) return undefined;\n  const now = Date.now();\n  return text.split(/\\n{2,}/).map((part) => {\n    const trimmed = part.trim();\n    if (noteId) {\n      const imageMatch = trimmed.match(IMAGE_MARKDOWN);\n      if (imageMatch) {\n        const attachmentId = attachmentIdFromTarget(imageMatch[2], noteId);\n        if (attachmentId) {\n          return {\n            id: createBlockId(),\n            type: 'image' as const,\n            attachmentId,\n            alt: imageMatch[1] || undefined,\n            createdAt: now,\n            updatedAt: now,\n          };\n        }\n      }\n    }\n    return {\n      id: createBlockId(),\n      type: 'paragraph' as const,\n      text: trimmed,\n      createdAt: now,\n      updatedAt: now,\n    };\n  });\n}\n\nfunction blocksToPlainText(blocks?: NoteBlock[], noteId?: string): string | undefined {\n  if (!blocks?.length) return undefined;\n  return blocks\n    .map((block) => {\n      if (block.type === 'divider') return '---';\n      if (block.type === 'todo') return `${block.checked ? '[x]' : '[ ]'} ${block.text}`;\n      if (block.type === 'image') {\n        if (noteId) {\n          return `![${block.alt ?? ''}](${buildNoteAttachmentRef(noteId, block.attachmentId)})`;\n        }\n        return block.alt ?? '';\n      }\n      return block.text;\n    })\n    .filter((text) => text.trim().length > 0)\n    .join('\\n\\n');\n}\n\nfunction createAiOrganizedBlocks(blocks: NoteBlock[], instruction: string): NoteBlock[] {\n  const now = Date.now();\n  const plainText = blocksToPlainText(blocks) || '';\n  const lines = plainText\n    .split(/\\n+/)\n    .map((line) => line.trim())\n    .filter(Boolean);\n  const wantsTodos = /待办|todo|task|行动|提醒/i.test(instruction);\n  const wantsSummary = /摘要|总结|summary|压缩/i.test(instruction);\n\n  if (wantsTodos) {\n    const candidates = lines.filter((line) => /要|需|记得|todo|task|完成|提交|联系|跟进|提醒/i.test(line));\n    return (candidates.length ? candidates : lines).slice(0, 12).map((line) => ({\n      id: createBlockId(),\n      type: 'todo' as const,\n      text: line.replace(/^[-*\\d.\\s\\[\\]x]+/i, '').trim(),\n      checked: false,\n      createdAt: now,\n      updatedAt: now,\n    }));\n  }\n\n  if (wantsSummary) {\n    const summary = lines.join(' ').slice(0, 220);\n    return [{\n      id: createBlockId(),\n      type: 'paragraph',\n      text: summary,\n      createdAt: now,\n      updatedAt: now,\n    }];\n  }\n\n  const titleText = lines[0]?.slice(0, 40) || '整理后的笔记';\n  const bodyLines = lines.slice(1).length ? lines.slice(1) : lines;\n  return [\n    {\n      id: createBlockId(),\n      type: 'heading',\n      text: titleText,\n      level: 2,\n      createdAt: now,\n      updatedAt: now,\n    },\n    ...bodyLines.map((line) => ({\n      id: createBlockId(),\n      type: 'bulletList' as const,\n      text: line.replace(/^[-*\\d.\\s]+/, '').trim(),\n      indent: 0,\n      createdAt: now,\n      updatedAt: now,\n    })),\n  ];\n}\n\nconst SNAPSHOT_THROTTLE_MS = 60_000;\nconst MAX_SNAPSHOTS_PER_NOTE = 30;\n\nexport class NotesService {\n  private store: NotesStore;\n  private lastSnapshotAt = new Map<string, number>();\n\n  constructor(store: NotesStore) {\n    this.store = store;\n  }\n\n  async initialize(): Promise<void> {\n    await this.store.initialize();\n    log.debug('NotesService initialized');\n  }\n\n  async quickCapture(text: string, source: CaptureSource): Promise<Note> {\n    const now = Date.now();\n    const id = randomUUID();\n    const blocks = noteTextToBlocks(text, id);\n    const note: Note = {\n      id,\n      kind: inferKind(text),\n      status: 'inbox',\n      text,\n      blocks,\n      createdAt: now,\n      updatedAt: now,\n      capturedVia: source,\n      localVersion: 0,\n      remoteVersion: 1,\n    };\n    await this.store.addNote(note);\n    log.debug({ id: note.id, kind: note.kind }, 'Quick capture');\n    return note;\n  }\n\n  async createNote(params: CreateNoteParams): Promise<Note> {\n    const now = Date.now();\n    const id = randomUUID();\n    const blocks = params.blocks ?? noteTextToBlocks(params.text, id);\n    const text = params.text ?? blocksToPlainText(blocks, id);\n    const note: Note = {\n      id,\n      title: params.title,\n      kind: params.kind || inferKind(text),\n      status: 'inbox',\n      text,\n      blocks,\n      createdAt: now,\n      updatedAt: now,\n      capturedVia: params.capturedVia,\n      tags: params.tags,\n      pinned: params.pinned,\n      localVersion: 0,\n      remoteVersion: 1,\n    };\n    await this.store.addNote(note);\n    log.debug({ id: note.id, kind: note.kind }, 'Note created');\n    return note;\n  }\n\n  async getNote(id: string): Promise<Note | null> {\n    return this.store.getNote(id);\n  }\n\n  async updateNote(id: string, patch: Partial<Note>, trigger: SnapshotTrigger = 'edit'): Promise<Note | null> {\n    const existing = await this.store.getNote(id);\n    if (!existing) return null;\n\n    const contentTouched = patch.text !== undefined || patch.blocks !== undefined || patch.title !== undefined;\n    if (contentTouched) {\n      await this.maybeSaveSnapshot(existing, trigger);\n    }\n\n    const normalizedPatch: Partial<Note> = { ...patch };\n    if (patch.blocks) {\n      normalizedPatch.text = patch.text ?? blocksToPlainText(patch.blocks, existing.id);\n    } else if (typeof patch.text === 'string') {\n      normalizedPatch.blocks = patch.blocks ?? noteTextToBlocks(patch.text, existing.id);\n    }\n    normalizedPatch.remoteVersion = (existing.remoteVersion ?? 0) + 1;\n\n    if (contentTouched) {\n      const merged: Note = {\n        ...existing,\n        ...normalizedPatch,\n        id: existing.id,\n        createdAt: existing.createdAt,\n        updatedAt: Date.now(),\n      };\n      const reconciled = await this.reconcileAttachments(merged);\n      normalizedPatch.attachments = reconciled.attachments;\n      normalizedPatch.kind = reconciled.kind;\n    }\n\n    return this.store.updateNote(id, normalizedPatch);\n  }\n\n  private async reconcileAttachments(note: Note): Promise<Note> {\n    const { kept, removed } = partitionAttachmentsByReference(note);\n    if (removed.length === 0) return note;\n\n    for (const attachment of removed) {\n      await this.store.deleteAttachmentFile(note.id, attachment.relativePath);\n    }\n\n    log.debug(\n      { noteId: note.id, removedIds: removed.map((attachment) => attachment.id) },\n      'Pruned orphan note attachments',\n    );\n\n    const hasAttachments = kept.length > 0;\n    return {\n      ...note,\n      attachments: hasAttachments ? kept : undefined,\n      kind: inferKind(note.text, hasAttachments, kept),\n    };\n  }\n\n  async syncNote(\n    id: string,\n    patch: Partial<Note>,\n    baseRemoteVersion?: number,\n  ): Promise<{ note: Note | null; conflict: boolean }> {\n    const existing = await this.store.getNote(id);\n    if (!existing) return { note: null, conflict: false };\n\n    const currentRemoteVersion = existing.remoteVersion ?? 0;\n    if (baseRemoteVersion !== undefined && baseRemoteVersion < currentRemoteVersion) {\n      return { note: existing, conflict: true };\n    }\n\n    const updated = await this.updateNote(id, patch, 'sync');\n    return { note: updated, conflict: false };\n  }\n\n  async createAiEditPatch(\n    id: string,\n    instruction: string,\n    blocks?: NoteBlock[],\n  ): Promise<{ message: string; patch: NoteAiPatch } | null> {\n    const note = await this.store.getNote(id);\n    if (!note) return null;\n\n    const sourceBlocks = blocks?.length ? blocks : note.blocks ?? noteTextToBlocks(note.text, note.id) ?? [];\n    const organizedBlocks = createAiOrganizedBlocks(sourceBlocks, instruction);\n    const patch: NoteAiPatch = {\n      id: randomUUID(),\n      summary: `已根据「${instruction.slice(0, 40)}」生成可预览的块级整理建议`,\n      operations: [{ type: 'replaceBlocks', blocks: organizedBlocks }],\n    };\n\n    return {\n      message: 'AI edit patch generated',\n      patch,\n    };\n  }\n\n  async deleteNote(id: string): Promise<boolean> {\n    const deleted = await this.store.deleteNote(id);\n    if (deleted) {\n      await this.store.deleteAllSnapshots(id);\n      this.lastSnapshotAt.delete(id);\n    }\n    return deleted;\n  }\n\n  async listNotes(query: NotesListQuery = {}): Promise<{ items: NoteIndexEntry[]; total: number }> {\n    return this.store.listNotes(query);\n  }\n\n  async addAttachment(\n    noteId: string,\n    file: { name: string; buffer: Buffer; mimeType: string; duration?: number },\n  ): Promise<NoteAttachment | null> {\n    const note = await this.store.getNote(noteId);\n    if (!note) return null;\n\n    const { relativePath, size } = await this.store.saveAttachment(noteId, file.name, file.buffer);\n\n    const attachment: NoteAttachment = {\n      id: randomUUID(),\n      type: inferAttachmentType(file.mimeType),\n      mimeType: file.mimeType,\n      fileName: file.name,\n      size,\n      relativePath,\n      duration: file.duration,\n    };\n\n    const attachments = [...(note.attachments || []), attachment];\n    const kind: NoteKind =\n      note.kind === 'thought' && attachment.type === 'audio'\n        ? 'voice'\n        : note.kind === 'thought'\n          ? 'media'\n          : note.kind;\n    await this.store.updateNote(noteId, { attachments, kind });\n\n    return attachment;\n  }\n\n  async getAttachmentPath(\n    noteId: string,\n    attachmentId: string,\n  ): Promise<{ filePath: string; mimeType: string; fileName: string } | null> {\n    const note = await this.store.getNote(noteId);\n    if (!note) return null;\n\n    const attachment = note.attachments?.find((a) => a.id === attachmentId);\n    if (!attachment) return null;\n\n    const fullPath = this.store.resolveAttachmentPath(noteId, attachment.relativePath);\n    return { filePath: fullPath, mimeType: attachment.mimeType, fileName: attachment.fileName };\n  }\n\n  async listNoteHistory(noteId: string): Promise<NoteSnapshotEntry[]> {\n    return this.store.listSnapshots(noteId);\n  }\n\n  async getNoteSnapshot(noteId: string, timestamp: number): Promise<NoteSnapshot | null> {\n    return this.store.getSnapshot(noteId, timestamp);\n  }\n\n  async restoreNoteSnapshot(noteId: string, timestamp: number): Promise<Note | null> {\n    const snapshot = await this.store.getSnapshot(noteId, timestamp);\n    if (!snapshot) return null;\n    const existing = await this.store.getNote(noteId);\n    if (!existing) return null;\n\n    await this.store.saveSnapshot(existing, 'restore');\n    this.lastSnapshotAt.set(noteId, Date.now());\n    await this.store.pruneSnapshots(noteId, MAX_SNAPSHOTS_PER_NOTE);\n\n    return this.store.updateNote(noteId, {\n      title: snapshot.title,\n      text: snapshot.text,\n      blocks: snapshot.blocks,\n      tags: snapshot.tags,\n    });\n  }\n\n  async flush(): Promise<void> {\n    await this.store.flush();\n  }\n\n  private async maybeSaveSnapshot(note: Note, trigger: SnapshotTrigger): Promise<void> {\n    if (trigger !== 'edit') {\n      await this.store.saveSnapshot(note, trigger);\n      this.lastSnapshotAt.set(note.id, Date.now());\n      await this.store.pruneSnapshots(note.id, MAX_SNAPSHOTS_PER_NOTE);\n      return;\n    }\n    const last = this.lastSnapshotAt.get(note.id) ?? 0;\n    if (Date.now() - last < SNAPSHOT_THROTTLE_MS) return;\n    await this.store.saveSnapshot(note, trigger);\n    this.lastSnapshotAt.set(note.id, Date.now());\n    await this.store.pruneSnapshots(note.id, MAX_SNAPSHOTS_PER_NOTE);\n  }\n}\n\nfunction inferAttachmentType(mimeType: string): NoteAttachment['type'] {\n  if (mimeType.startsWith('image/')) return 'image';\n  if (mimeType.startsWith('video/')) return 'video';\n  if (mimeType.startsWith('audio/')) return 'audio';\n  return 'file';\n}\n"],"mappings":"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"}

package/dist/src/notes/store.d.ts

@@ -0,0 +1,33 @@
+import type { Note, NoteIndexEntry, NoteSnapshot, NoteSnapshotEntry, NotesListQuery, SnapshotTrigger } from './types.js';
+export declare class NotesStore {
+    private indexCache;
+    private dirty;
+    private saveTimeout;
+    private initialized;
+    initialize(): Promise<void>;
+    addNote(note: Note): Promise<void>;
+    getNote(id: string): Promise<Note | null>;
+    updateNote(id: string, patch: Partial<Note>): Promise<Note | null>;
+    deleteNote(id: string): Promise<boolean>;
+    listNotes(query?: NotesListQuery): Promise<{
+        items: NoteIndexEntry[];
+        total: number;
+    }>;
+    saveAttachment(noteId: string, fileName: string, buffer: Buffer): Promise<{
+        relativePath: string;
+        size: number;
+    }>;
+    resolveAttachmentPath(noteId: string, relativePath: string): string;
+    deleteAttachmentFile(noteId: string, relativePath: string): Promise<void>;
+    saveSnapshot(note: Note, trigger: SnapshotTrigger): Promise<void>;
+    listSnapshots(noteId: string): Promise<NoteSnapshotEntry[]>;
+    getSnapshot(noteId: string, timestamp: number): Promise<NoteSnapshot | null>;
+    pruneSnapshots(noteId: string, maxCount: number): Promise<void>;
+    deleteAllSnapshots(noteId: string): Promise<void>;
+    flush(): Promise<void>;
+    private loadIndex;
+    private writeIndex;
+    private writeNoteItem;
+    private scheduleIndexSave;
+    private rebuildIndexFromItems;
+}