dsh-quicknote 0.1.0 → 0.1.1

package/lib/index.js

@@ -74,10 +74,13 @@ function registerRoutes(ctx, store) {
 			{
 				path: `${API}/notes/create`,
 				methods: ["POST"],
-				fetch: wrap(async (request) => json(200, {
-					ok: true,
-					note: await store.add((await body(request)).text)
-				}))
+				fetch: wrap(async (request) => {
+					const input = await body(request);
+					return json(200, {
+						ok: true,
+						note: await store.add(input.text, input.origin)
+					});
+				})
 			},
 			{
 				path: `${API}/notes/update`,
@@ -99,8 +102,23 @@ function registerRoutes(ctx, store) {
 				methods: ["POST"],
 				fetch: wrap(async (request) => json(200, {
 					ok: true,
-					removed: await store.remove((await body(request)).id)
+					note: await store.remove((await body(request)).id)
 				}))
+			},
+			{
+				path: `${API}/notes/restore`,
+				methods: ["POST"],
+				fetch: wrap(async (request) => {
+					try {
+						return json(200, {
+							ok: true,
+							note: await store.restore((await body(request)).note)
+						});
+					} catch (error) {
+						if (String(error?.message) === "invalid-note") throw new HttpError(400, "invalid-note");
+						throw error;
+					}
+				})
 			}
 		];
 		for (const route of routes) scope.effect(() => registry.register({
@@ -113,9 +131,43 @@ function registerRoutes(ctx, store) {
 }
 // src/host/store.ts
 const MAX_TEXT = 2e4;
+function parseNote(value) {
+	if (value === null || typeof value !== "object") return null;
+	const raw = value;
+	if (typeof raw.id !== "string" || raw.id === "" || raw.id.length > 128) return null;
+	if (typeof raw.text !== "string") return null;
+	const text = raw.text.trim();
+	if (text === "" || text.length > MAX_TEXT) return null;
+	const createdAt = typeof raw.createdAt === "number" && Number.isFinite(raw.createdAt) ? raw.createdAt : Date.now();
+	const note = {
+		id: raw.id,
+		text,
+		done: raw.done === true,
+		createdAt
+	};
+	const origin = parseOrigin(raw.origin);
+	if (origin) note.origin = origin;
+	return note;
+}
+function parseOrigin(value) {
+	if (value === null || typeof value !== "object") return void 0;
+	const sessionId = String(value.sessionId ?? "");
+	const title = String(value.title ?? "");
+	if (sessionId === "" && title === "") return void 0;
+	return {
+		sessionId,
+		title
+	};
+}
 /** A small durable store: one JSON file, atomic whole-file writes, newest first. */
 function createStore(file) {
 	let cache = null;
+	let tail = Promise.resolve();
+	function serialized(run) {
+		const result = tail.then(run);
+		tail = result.then(() => void 0, () => void 0);
+		return result;
+	}
 	async function load() {
 		if (cache) return cache;
 		try {
@@ -128,46 +180,70 @@ function createStore(file) {
 	}
 	async function save(notes) {
 		await mkdir(dirname(file), { recursive: true });
-		const temporary = `${file}.${process.pid}.tmp`;
+		const temporary = `${file}.${process.pid}.${randomUUID()}.tmp`;
 		await writeFile(temporary, `${JSON.stringify({ notes }, null, 2)}\n`, { mode: 384 });
 		await rename(temporary, file);
 		cache = notes;
 	}
 	return {
 		file,
-		async list() {
-			return [...await load()];
+		list() {
+			return serialized(async () => [...await load()]);
+		},
+		add(text, origin) {
+			return serialized(async () => {
+				const value = String(text ?? "").trim();
+				if (value === "") throw new Error("empty-note");
+				if (value.length > MAX_TEXT) throw new Error("note-too-long");
+				const notes = await load();
+				const createdAt = Math.max(Date.now(), (notes[0]?.createdAt ?? 0) + 1);
+				const note = {
+					id: randomUUID(),
+					text: value,
+					done: false,
+					createdAt
+				};
+				const cleanOrigin = parseOrigin(origin);
+				if (cleanOrigin) note.origin = cleanOrigin;
+				await save([note, ...notes]);
+				return note;
+			});
 		},
-		async add(text) {
-			const value = String(text ?? "").trim();
-			if (value === "") throw new Error("empty-note");
-			if (value.length > MAX_TEXT) throw new Error("note-too-long");
-			const note = {
-				id: randomUUID(),
-				text: value,
-				done: false,
-				createdAt: Date.now()
-			};
-			await save([note, ...await load()]);
-			return note;
+		update(id, done) {
+			return serialized(async () => {
+				const notes = await load();
+				const current = notes.find((note) => note.id === id);
+				if (!current) return null;
+				const updated = {
+					...current,
+					done
+				};
+				await save(notes.map((note) => note.id === id ? updated : note));
+				return updated;
+			});
 		},
-		async update(id, done) {
-			const notes = await load();
-			const current = notes.find((note) => note.id === id);
-			if (!current) return null;
-			const updated = {
-				...current,
-				done
-			};
-			await save(notes.map((note) => note.id === id ? updated : note));
-			return updated;
+		remove(id) {
+			return serialized(async () => {
+				const notes = await load();
+				const removed = notes.find((note) => note.id === id) ?? null;
+				if (!removed) return null;
+				await save(notes.filter((note) => note.id !== id));
+				return removed;
+			});
 		},
-		async remove(id) {
-			const notes = await load();
-			const next = notes.filter((note) => note.id !== id);
-			if (next.length === notes.length) return false;
-			await save(next);
-			return true;
+		restore(value) {
+			return serialized(async () => {
+				const note = parseNote(value);
+				if (!note) throw new Error("invalid-note");
+				const notes = await load();
+				const existing = notes.find((item) => item.id === note.id);
+				if (existing) return existing;
+				const index = notes.findIndex((item) => item.createdAt <= note.createdAt);
+				const next = [...notes];
+				next.splice(index === -1 ? notes.length : index, 0, note);
+				await save(next);
+				return note;
+			});
 		}
 	};
 }

package/llms.txt

@@ -28,3 +28,5 @@
 - Package: dsh-quicknote
 - Patch row: `dsh-quicknote`
 - Client module id: `dsh-quicknote`
+- Storage: `~/.dsh/quicknote/notes.json`
+- Routes: `/api/quicknote/notes`, `/create`, `/update`, `/delete`, `/restore`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-quicknote",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Capture a note from the DSH composer, keep it out of the way, and manage the list on one page.",
   "license": "MIT",
   "author": "dsh-kit contributors",
@@ -71,7 +71,7 @@
     "type": "git",
     "url": "git+https://github.com/dsh-kit/dsh-quicknote.git"
   },
-  "homepage": "https://github.com/dsh-kit/dsh-quicknote",
+  "homepage": "https://dsh-kit.github.io/dsh-quicknote/",
   "bugs": {
     "url": "https://github.com/dsh-kit/dsh-quicknote/issues"
   }