promaster 1.2.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "promaster",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Interactive CLI to browse Markdown (blog/memory/books) from a public GitHub repo and save it as browser-ready HTML.",
   "type": "module",
   "bin": {

package/src/commands/list.js

@@ -1,8 +1,10 @@
-import { select, checkbox, confirm } from "@inquirer/prompts";
+import { select, checkbox, confirm, input } from "@inquirer/prompts";
 import { resolve, dirname } from "node:path";
+import { rmSync } from "node:fs";
+import { rm } from "node:fs/promises";
 import { resolveRepo, CATEGORIES } from "../config.js";
 import { listMarkdown, lastCommitDate, fetchRaw, HttpError } from "../github.js";
-import { save, OUTPUT_ROOT } from "../download.js";
+import { save, saveTemp, OUTPUT_ROOT } from "../download.js";
 import { openInBrowser } from "../open.js";
 
 const CONCURRENCY = 5;
@@ -54,6 +56,12 @@ export async function runList() {
     return;
   }
 
+  // books: open immediately, never persist — delete the temp files on exit.
+  if (category === "books") {
+    await openEphemeral(picked, ctx);
+    return;
+  }
+
   const saved = [];
   for (const file of picked) {
     const content = await fetchRaw(file.download_url, ctx);
@@ -73,4 +81,47 @@ export async function runList() {
   }
 }
 
+// Render picks to OS temp, auto-open in the browser, then delete once the
+// user is done (Enter) or aborts (Ctrl+C). Nothing is left on disk.
+async function openEphemeral(picked, ctx) {
+  const dirs = [];
+  const cleanup = () => {
+    while (dirs.length) {
+      try {
+        rmSync(dirs.pop(), { recursive: true, force: true });
+      } catch {
+        /* best effort */
+      }
+    }
+  };
+
+  const onSigint = () => {
+    cleanup();
+    process.exit(130);
+  };
+  process.on("SIGINT", onSigint);
+
+  try {
+    for (const file of picked) {
+      const content = await fetchRaw(file.download_url, ctx);
+      const { path, dir } = await saveTemp(file, content);
+      dirs.push(dir);
+      openInBrowser(path);
+      console.log(`Opened in browser: ${file.name}`);
+    }
+
+    console.log("\nThese are temporary — nothing is saved to disk.");
+    await input({
+      message: `Press Enter when you're done to delete the temporary file${
+        picked.length === 1 ? "" : "s"
+      }`,
+    });
+  } finally {
+    process.off("SIGINT", onSigint);
+    for (const dir of dirs.splice(0)) {
+      await rm(dir, { recursive: true, force: true }).catch(() => {});
+    }
+  }
+}
+
 export { HttpError };

package/src/download.js

@@ -1,5 +1,6 @@
-import { mkdir, writeFile } from "node:fs/promises";
+import { mkdir, mkdtemp, writeFile } from "node:fs/promises";
 import { basename, extname, resolve } from "node:path";
+import { tmpdir } from "node:os";
 import { mdToHtml } from "./render.js";
 
 export const OUTPUT_ROOT = "promaster-data";
@@ -40,3 +41,19 @@ export async function save(category, file, content) {
   await writeFile(dest, html, "utf8");
   return dest;
 }
+
+/**
+ * Render markdown to HTML in a fresh OS temp directory (never under
+ * promaster-data). Returns { path, dir } so the caller can delete `dir`
+ * once the user is done viewing — nothing is persisted.
+ */
+export async function saveTemp(file, content) {
+  const dir = await mkdtemp(resolve(tmpdir(), "promaster-"));
+  const base = safeName(file.name);
+  const ext = extname(base);
+  const title = ext ? base.slice(0, -ext.length) : base;
+  const html = mdToHtml(content, { title });
+  const path = resolve(dir, htmlName(file.name));
+  await writeFile(path, html, "utf8");
+  return { path, dir };
+}