mdpockla 0.1.1 → 0.2.0

package/src/commands/note.mjs

@@ -1,178 +1,327 @@
-import { promises as fs } from "node:fs";
-import path from "node:path";
-import { api } from "../lib/http.mjs";
-import { parseArgs } from "../lib/args.mjs";
-
-/**
- * Each command does its own argv parsing (via parseArgs) so the
- * --flag set is documented at the call site. The bodies are
- * intentionally one-liners over `api()` — the HTTP API is the source
- * of truth.
- *
- * Output convention: human-readable to stdout, share URL on the last
- * line so piping into another tool yields the URL alone.
- */
-
-export async function noteCreate(argv) {
-  const args = parseArgs(argv, {
-    title: { type: "string" },
-    public: { type: "boolean" },
-    tag: { type: "string", repeatable: true },
-    json: { type: "boolean" },
-  });
-  const file = args._[0];
-  if (!file) throw exit("Usage: mdpockla note create <file>");
-  const abs = path.resolve(file);
-  const content = await fs.readFile(abs, "utf8");
-  const ext = path.extname(abs).toLowerCase();
-  const content_type = ext === ".html" || ext === ".htm" ? "html" : "markdown";
-
-  const note = await api("POST", "/api/v1/notes", {
-    body: {
-      title: args.title,
-      content,
-      content_type,
-      visibility: args.public ? "public" : "private",
-      tags: args.tag.length ? args.tag : undefined,
-    },
-  });
-  if (args.json) process.stdout.write(JSON.stringify(note, null, 2) + "\n");
-  else process.stdout.write(note.url + "\n");
-}
-
-export async function noteEdit(argv) {
-  const args = parseArgs(argv, {
-    content: { type: "string" },
-    title: { type: "string" },
-    visibility: { type: "string" },
-    tag: { type: "string", repeatable: true },
-    json: { type: "boolean" },
-  });
-  const target = args._[0];
-  if (!target) throw exit("Usage: mdpockla note edit <id|url> [...]");
-  const body = {};
-  if (args.title) body.title = args.title;
-  if (args.visibility) body.visibility = args.visibility;
-  if (args.tag.length) body.tags = args.tag;
-  if (args.content) {
-    const abs = path.resolve(args.content);
-    body.content = await fs.readFile(abs, "utf8");
-    const ext = path.extname(abs).toLowerCase();
-    body.content_type = ext === ".html" || ext === ".htm" ? "html" : "markdown";
-  }
-  if (Object.keys(body).length === 0) {
-    throw exit("Nothing to update — pass at least one of --content, --title, --visibility, --tag");
-  }
-  const note = await api("PATCH", `/api/v1/notes/${encodeURIComponent(target)}`, {
-    body,
-  });
-  if (args.json) process.stdout.write(JSON.stringify(note, null, 2) + "\n");
-  else process.stdout.write(note.url + "\n");
-}
-
-export async function noteGet(argv) {
-  const args = parseArgs(argv, {
-    output: { type: "string" },
-    json: { type: "boolean" },
-  });
-  const target = args._[0];
-  if (!target) throw exit("Usage: mdpockla note get <id|url> [--output FILE]");
-  const note = await api("GET", `/api/v1/notes/${encodeURIComponent(target)}`);
-  if (args.json) {
-    process.stdout.write(JSON.stringify(note, null, 2) + "\n");
-    return;
-  }
-  if (args.output) {
-    await fs.writeFile(path.resolve(args.output), note.content);
-    process.stdout.write(`Wrote ${args.output}\n`);
-  } else {
-    process.stdout.write(note.content);
-    if (!note.content.endsWith("\n")) process.stdout.write("\n");
-  }
-}
-
-export async function noteList(argv) {
-  const args = parseArgs(argv, {
-    mine: { type: "boolean" },
-    shared: { type: "boolean" },
-    query: { type: "string" },
-    limit: { type: "string" },
-    json: { type: "boolean" },
-  });
-  const filter = args.mine ? "mine" : args.shared ? "shared" : "all";
-  const limit = args.limit ? Number.parseInt(args.limit, 10) : undefined;
-  const res = await api("GET", "/api/v1/notes", {
-    query: { filter, query: args.query, limit },
-  });
-  if (args.json) {
-    process.stdout.write(JSON.stringify(res, null, 2) + "\n");
-    return;
-  }
-  if (res.notes.length === 0) {
-    process.stdout.write("No notes.\n");
-    return;
-  }
-  for (const n of res.notes) {
-    process.stdout.write(
-      `${n.url}  ${n.visibility.padEnd(7)}  ${truncate(n.title, 60)}\n`
-    );
-  }
-}
-
-export async function noteDelete(argv) {
-  const target = argv[0];
-  if (!target) throw exit("Usage: mdpockla note delete <id|url>");
-  await api("DELETE", `/api/v1/notes/${encodeURIComponent(target)}`);
-  process.stdout.write("Deleted.\n");
-}
-
-export async function noteShare(argv) {
-  const args = parseArgs(argv, {
-    visibility: { type: "string" },
-  });
-  const target = args._[0];
-  if (!target || !args.visibility) {
-    throw exit("Usage: mdpockla note share <id|url> --visibility public|private");
-  }
-  const note = await api("POST", `/api/v1/notes/${encodeURIComponent(target)}/share`, {
-    body: { visibility: args.visibility },
-  });
-  process.stdout.write(note.url + "\n");
-}
-
-export async function noteCollaboratorAdd(argv) {
-  const [target, email] = argv;
-  if (!target || !email) {
-    throw exit("Usage: mdpockla note collaborator add <id|url> <email>");
-  }
-  const note = await api(
-    "POST",
-    `/api/v1/notes/${encodeURIComponent(target)}/collaborators`,
-    { body: { email } }
-  );
-  process.stdout.write(note.url + "\n");
-}
-
-export async function noteCollaboratorRemove(argv) {
-  const [target, email] = argv;
-  if (!target || !email) {
-    throw exit("Usage: mdpockla note collaborator remove <id|url> <email>");
-  }
-  const note = await api(
-    "DELETE",
-    `/api/v1/notes/${encodeURIComponent(target)}/collaborators`,
-    { query: { email } }
-  );
-  process.stdout.write(note.url + "\n");
-}
-
-function truncate(s, n) {
-  if (!s) return "";
-  return s.length > n ? s.slice(0, n - 1) + "…" : s;
-}
-
-function exit(message, code = 2) {
-  const err = new Error(message);
-  err.exitCode = code;
-  return err;
-}
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { api } from "../lib/http.mjs";
+import { parseArgs } from "../lib/args.mjs";
+
+/**
+ * Each command does its own argv parsing (via parseArgs) so the
+ * --flag set is documented at the call site. The bodies are
+ * intentionally one-liners over `api()` — the HTTP API is the source
+ * of truth.
+ *
+ * Output convention: human-readable to stdout, share URL on the last
+ * line so piping into another tool yields the URL alone.
+ */
+
+export async function noteCreate(argv) {
+  const args = parseArgs(argv, {
+    title: { type: "string" },
+    public: { type: "boolean" },
+    tag: { type: "string", repeatable: true },
+    json: { type: "boolean" },
+  });
+  const file = args._[0];
+  if (!file) throw exit("Usage: mdpockla note create <file>");
+  const abs = path.resolve(file);
+  const content = await fs.readFile(abs, "utf8");
+  const ext = path.extname(abs).toLowerCase();
+  const content_type = ext === ".html" || ext === ".htm" ? "html" : "markdown";
+
+  const note = await api("POST", "/api/v1/notes", {
+    body: {
+      title: args.title,
+      content,
+      content_type,
+      visibility: args.public ? "public" : "private",
+      tags: args.tag.length ? args.tag : undefined,
+    },
+  });
+  if (args.json) process.stdout.write(JSON.stringify(note, null, 2) + "\n");
+  else process.stdout.write(note.url + "\n");
+}
+
+export async function noteEdit(argv) {
+  const args = parseArgs(argv, {
+    content: { type: "string" },
+    title: { type: "string" },
+    visibility: { type: "string" },
+    tag: { type: "string", repeatable: true },
+    "save-version": { type: "boolean" },
+    label: { type: "string" },
+    json: { type: "boolean" },
+  });
+  const target = args._[0];
+  if (!target) throw exit("Usage: mdpockla note edit <id|url> [...]");
+  const body = {};
+  if (args.title) body.title = args.title;
+  if (args.visibility) body.visibility = args.visibility;
+  if (args.tag.length) body.tags = args.tag;
+  if (args.content) {
+    const abs = path.resolve(args.content);
+    body.content = await fs.readFile(abs, "utf8");
+    const ext = path.extname(abs).toLowerCase();
+    body.content_type = ext === ".html" || ext === ".htm" ? "html" : "markdown";
+  }
+  if (Object.keys(body).length === 0) {
+    throw exit("Nothing to update — pass at least one of --content, --title, --visibility, --tag");
+  }
+  const note = await api("PATCH", `/api/v1/notes/${encodeURIComponent(target)}`, {
+    body,
+  });
+  if (args["save-version"]) {
+    try {
+      await api(
+        "POST",
+        `/api/v1/notes/${encodeURIComponent(target)}/versions`,
+        { body: { label: args.label ?? null } }
+      );
+    } catch (err) {
+      // Snapshot failed but the edit landed — surface the warning but
+      // exit 0 so the user can see the share URL.
+      process.stderr.write(
+        `warning: --save-version failed: ${err.message ?? err}\n`
+      );
+    }
+  }
+  if (args.json) process.stdout.write(JSON.stringify(note, null, 2) + "\n");
+  else process.stdout.write(note.url + "\n");
+}
+
+export async function noteGet(argv) {
+  const args = parseArgs(argv, {
+    output: { type: "string" },
+    version: { type: "string" },
+    json: { type: "boolean" },
+  });
+  const target = args._[0];
+  if (!target) throw exit("Usage: mdpockla note get <id|url> [--output FILE]");
+  const query = {};
+  if (args.version) {
+    const v = Number.parseInt(args.version, 10);
+    if (!Number.isFinite(v) || v <= 0) {
+      throw exit("--version must be a positive integer");
+    }
+    query.version = v;
+  }
+  const note = await api("GET", `/api/v1/notes/${encodeURIComponent(target)}`, {
+    query: Object.keys(query).length ? query : undefined,
+  });
+  if (args.json) {
+    process.stdout.write(JSON.stringify(note, null, 2) + "\n");
+    return;
+  }
+  if (args.output) {
+    await fs.writeFile(path.resolve(args.output), note.content);
+    process.stdout.write(`Wrote ${args.output}\n`);
+  } else {
+    process.stdout.write(note.content);
+    if (!note.content.endsWith("\n")) process.stdout.write("\n");
+  }
+}
+
+export async function noteList(argv) {
+  const args = parseArgs(argv, {
+    mine: { type: "boolean" },
+    shared: { type: "boolean" },
+    query: { type: "string" },
+    limit: { type: "string" },
+    json: { type: "boolean" },
+  });
+  const filter = args.mine ? "mine" : args.shared ? "shared" : "all";
+  const limit = args.limit ? Number.parseInt(args.limit, 10) : undefined;
+  const res = await api("GET", "/api/v1/notes", {
+    query: { filter, query: args.query, limit },
+  });
+  if (args.json) {
+    process.stdout.write(JSON.stringify(res, null, 2) + "\n");
+    return;
+  }
+  if (res.notes.length === 0) {
+    process.stdout.write("No notes.\n");
+    return;
+  }
+  for (const n of res.notes) {
+    process.stdout.write(
+      `${n.url}  ${n.visibility.padEnd(7)}  ${truncate(n.title, 60)}\n`
+    );
+  }
+}
+
+export async function noteDelete(argv) {
+  const target = argv[0];
+  if (!target) throw exit("Usage: mdpockla note delete <id|url>");
+  await api("DELETE", `/api/v1/notes/${encodeURIComponent(target)}`);
+  process.stdout.write("Deleted.\n");
+}
+
+export async function noteShare(argv) {
+  const args = parseArgs(argv, {
+    visibility: { type: "string" },
+  });
+  const target = args._[0];
+  if (!target || !args.visibility) {
+    throw exit("Usage: mdpockla note share <id|url> --visibility public|private");
+  }
+  const note = await api("POST", `/api/v1/notes/${encodeURIComponent(target)}/share`, {
+    body: { visibility: args.visibility },
+  });
+  process.stdout.write(note.url + "\n");
+}
+
+export async function noteCollaboratorAdd(argv) {
+  const [target, email] = argv;
+  if (!target || !email) {
+    throw exit("Usage: mdpockla note collaborator add <id|url> <email>");
+  }
+  const note = await api(
+    "POST",
+    `/api/v1/notes/${encodeURIComponent(target)}/collaborators`,
+    { body: { email } }
+  );
+  process.stdout.write(note.url + "\n");
+}
+
+export async function noteCollaboratorRemove(argv) {
+  const [target, email] = argv;
+  if (!target || !email) {
+    throw exit("Usage: mdpockla note collaborator remove <id|url> <email>");
+  }
+  const note = await api(
+    "DELETE",
+    `/api/v1/notes/${encodeURIComponent(target)}/collaborators`,
+    { query: { email } }
+  );
+  process.stdout.write(note.url + "\n");
+}
+
+// ------------------------------------------------------------
+// note version <verb>
+// ------------------------------------------------------------
+
+export async function noteVersionSave(argv) {
+  const args = parseArgs(argv, {
+    label: { type: "string" },
+    json: { type: "boolean" },
+  });
+  const target = args._[0];
+  if (!target) throw exit("Usage: mdpockla note version save <id|url> [--label TEXT]");
+  const v = await api(
+    "POST",
+    `/api/v1/notes/${encodeURIComponent(target)}/versions`,
+    { body: { label: args.label ?? null } }
+  );
+  if (args.json) process.stdout.write(JSON.stringify(v, null, 2) + "\n");
+  else process.stdout.write(v.url + "\n");
+}
+
+export async function noteVersionList(argv) {
+  const args = parseArgs(argv, {
+    json: { type: "boolean" },
+  });
+  const target = args._[0];
+  if (!target) throw exit("Usage: mdpockla note version list <id|url>");
+  const res = await api(
+    "GET",
+    `/api/v1/notes/${encodeURIComponent(target)}/versions`
+  );
+  if (args.json) {
+    process.stdout.write(JSON.stringify(res, null, 2) + "\n");
+    return;
+  }
+  if (res.versions.length === 0) {
+    process.stdout.write("No saved versions.\n");
+    return;
+  }
+  for (const v of res.versions) {
+    const created = new Date(v.created_at).toLocaleDateString("en-US", {
+      month: "short",
+      day: "numeric",
+      year: "numeric",
+    });
+    const author = (v.author?.name || v.author?.email || "?").padEnd(16);
+    const label = v.label || (v.restored_from ? `restored from v${v.restored_from}` : "");
+    process.stdout.write(
+      `v${String(v.version).padEnd(3)} ${created.padEnd(14)} ${author} ${label}\n`
+    );
+  }
+}
+
+export async function noteVersionGet(argv) {
+  const args = parseArgs(argv, {
+    output: { type: "string" },
+    json: { type: "boolean" },
+  });
+  const target = args._[0];
+  const versionRaw = args._[1];
+  if (!target || !versionRaw) {
+    throw exit("Usage: mdpockla note version get <id|url> <version> [--output FILE]");
+  }
+  const version = Number.parseInt(versionRaw, 10);
+  if (!Number.isFinite(version) || version <= 0) {
+    throw exit("<version> must be a positive integer");
+  }
+  const v = await api(
+    "GET",
+    `/api/v1/notes/${encodeURIComponent(target)}/versions/${version}`
+  );
+  if (args.json) {
+    process.stdout.write(JSON.stringify(v, null, 2) + "\n");
+    return;
+  }
+  if (args.output) {
+    await fs.writeFile(path.resolve(args.output), v.content);
+    process.stdout.write(`Wrote ${args.output}\n`);
+  } else {
+    process.stdout.write(v.content);
+    if (!v.content.endsWith("\n")) process.stdout.write("\n");
+  }
+}
+
+export async function noteVersionRestore(argv) {
+  const args = parseArgs(argv, {
+    json: { type: "boolean" },
+  });
+  const target = args._[0];
+  const versionRaw = args._[1];
+  if (!target || !versionRaw) {
+    throw exit("Usage: mdpockla note version restore <id|url> <version>");
+  }
+  const version = Number.parseInt(versionRaw, 10);
+  if (!Number.isFinite(version) || version <= 0) {
+    throw exit("<version> must be a positive integer");
+  }
+  const v = await api(
+    "POST",
+    `/api/v1/notes/${encodeURIComponent(target)}/versions/${version}/restore`
+  );
+  if (args.json) process.stdout.write(JSON.stringify(v, null, 2) + "\n");
+  else process.stdout.write(v.url + "\n");
+}
+
+export async function noteVersionDelete(argv) {
+  const target = argv[0];
+  const versionRaw = argv[1];
+  if (!target || !versionRaw) {
+    throw exit("Usage: mdpockla note version delete <id|url> <version>");
+  }
+  const version = Number.parseInt(versionRaw, 10);
+  if (!Number.isFinite(version) || version <= 0) {
+    throw exit("<version> must be a positive integer");
+  }
+  await api(
+    "DELETE",
+    `/api/v1/notes/${encodeURIComponent(target)}/versions/${version}`
+  );
+  process.stdout.write(`Deleted v${version}.\n`);
+}
+
+function truncate(s, n) {
+  if (!s) return "";
+  return s.length > n ? s.slice(0, n - 1) + "…" : s;
+}
+
+function exit(message, code = 2) {
+  const err = new Error(message);
+  err.exitCode = code;
+  return err;
+}