@blankdotpage/cli 0.1.2 → 0.1.3

package/README.md

@@ -19,21 +19,19 @@ By default, CLI commands target:
 
 - `https://blank.page`
 
-Override target endpoint with either:
-
-- `--app-url https://your-preview.fly.dev`
-- `BLANKPAGE_APP_URL=https://your-preview.fly.dev`
-
 ## Commands
 
 ```bash
 blankpage login [--app-url <url>] [--no-browser]
 blankpage whoami
+blankpage list
 blankpage create <file.md>
-blankpage view <page-id>
-blankpage update <page-id> <file.md>
-blankpage delete <page-id>
+blankpage view <page-id-or-title>
+blankpage update <page-id-or-title> <file.md>
+blankpage delete <page-id-or-title>
 blankpage share <file.md> [--title "..."]
-blankpage share --page-id <page-id> [--title "..."]
+blankpage share --page-id <page-id-or-title> [--title "..."]
 blankpage unshare <link-id-or-url>
 ```
+
+Commands that accept page ids also accept page titles when the title is unique.

package/dist/index.js

@@ -306,12 +306,95 @@ function output(json, payload, text) {
 async function readMarkdownFile(filePath) {
   return fs2.readFile(filePath, "utf8");
 }
-function findPageOrThrow(state, pageId) {
-  const page = state.pages.find((entry) => entry.id === pageId);
-  if (!page) {
-    throw new Error(`Page not found: ${pageId}`);
+function inferTitleFromMarkdown(content) {
+  const lines = content.split(/\r?\n/);
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed) {
+      continue;
+    }
+    const headingMatch = trimmed.match(/^#{1,6}\s+(.+)$/);
+    if (headingMatch) {
+      const heading = headingMatch[1]?.trim();
+      if (heading) {
+        return heading;
+      }
+    }
+    return trimmed;
+  }
+  return null;
+}
+function getPageTitle(page) {
+  const explicit = page.title?.trim();
+  if (explicit) {
+    return explicit;
+  }
+  const inferred = inferTitleFromMarkdown(page.content);
+  if (inferred) {
+    return inferred;
+  }
+  return "(untitled)";
+}
+function normalizeSelector(value) {
+  return value.trim().toLowerCase();
+}
+function findPageBySelectorOrThrow(state, selector) {
+  const exactIdMatch = state.pages.find((entry) => entry.id === selector);
+  if (exactIdMatch) {
+    return exactIdMatch;
+  }
+  const normalizedSelector = normalizeSelector(selector);
+  const titleMatches = state.pages.filter(
+    (entry) => normalizeSelector(getPageTitle(entry)) === normalizedSelector
+  );
+  if (titleMatches.length === 1) {
+    return titleMatches[0];
+  }
+  if (titleMatches.length > 1) {
+    const matchesPreview = titleMatches.slice(0, 5).map((entry) => `${entry.id} (${getPageTitle(entry)})`).join(", ");
+    throw new Error(
+      `Multiple pages match "${selector}". Use page id instead: ${matchesPreview}`
+    );
+  }
+  throw new Error(`Page not found: ${selector}`);
+}
+function toListedPages(state) {
+  return [...state.pages].map((page) => ({
+    id: page.id,
+    title: getPageTitle(page),
+    lastUpdatedAt: page.lastUpdatedAt
+  })).sort((left, right) => right.lastUpdatedAt - left.lastUpdatedAt);
+}
+function truncateForTable(value, maxLength) {
+  if (value.length <= maxLength) {
+    return value;
+  }
+  if (maxLength <= 3) {
+    return value.slice(0, maxLength);
+  }
+  return `${value.slice(0, maxLength - 3)}...`;
+}
+function formatPagesTable(pages) {
+  if (pages.length === 0) {
+    return "No pages found.";
+  }
+  const idWidth = Math.max(
+    "PAGE ID".length,
+    ...pages.map((page) => page.id.length)
+  );
+  const titleWidth = Math.min(
+    48,
+    Math.max("TITLE".length, ...pages.map((page) => page.title.length))
+  );
+  const lines = [
+    `${"PAGE ID".padEnd(idWidth)}  ${"TITLE".padEnd(titleWidth)}  UPDATED`
+  ];
+  for (const page of pages) {
+    lines.push(
+      `${page.id.padEnd(idWidth)}  ${truncateForTable(page.title, titleWidth).padEnd(titleWidth)}  ${new Date(page.lastUpdatedAt).toISOString()}`
+    );
   }
-  return page;
+  return lines.join("\n");
 }
 async function commandLogin(ctx) {
   const noBrowser = booleanFlag(ctx.flags, "no-browser");
@@ -403,6 +486,17 @@ async function commandWhoAmI(ctx) {
     `${whoami.email}${whoami.handle ? ` (@${whoami.handle})` : ""}`
   );
 }
+async function commandList(ctx) {
+  if (ctx.positionals.length > 0) {
+    throw new Error("Usage: blankpage list");
+  }
+  const config = await loadConfig();
+  const token = requireToken(config.token);
+  const client = new ApiClient({ appUrl: ctx.appUrl, token });
+  const state = await fetchRemoteState(client);
+  const pages = toListedPages(state);
+  output(ctx.json, { pages }, formatPagesTable(pages));
+}
 async function commandCreate(ctx) {
   const filePath = ctx.positionals[0];
   if (!filePath) {
@@ -431,19 +525,19 @@ async function commandCreate(ctx) {
   );
 }
 async function commandView(ctx) {
-  const pageId = ctx.positionals[0];
-  if (!pageId) {
-    throw new Error("Usage: blankpage view <page-id>");
+  const pageSelector = ctx.positionals[0];
+  if (!pageSelector) {
+    throw new Error("Usage: blankpage view <page-id-or-title>");
   }
   const config = await loadConfig();
   const token = requireToken(config.token);
   const client = new ApiClient({ appUrl: ctx.appUrl, token });
   const state = await fetchRemoteState(client);
-  const page = findPageOrThrow(state, pageId);
+  const page = findPageBySelectorOrThrow(state, pageSelector);
   if (ctx.json) {
     output(ctx.json, {
       pageId: page.id,
-      title: page.title,
+      title: getPageTitle(page),
       content: page.content
     });
     return;
@@ -451,17 +545,19 @@ async function commandView(ctx) {
   printText(page.content);
 }
 async function commandUpdate(ctx) {
-  const pageId = ctx.positionals[0];
+  const pageSelector = ctx.positionals[0];
   const filePath = ctx.positionals[1];
-  if (!pageId || !filePath) {
-    throw new Error("Usage: blankpage update <page-id> <markdown-file>");
+  if (!pageSelector || !filePath) {
+    throw new Error(
+      "Usage: blankpage update <page-id-or-title> <markdown-file>"
+    );
   }
   const config = await loadConfig();
   const token = requireToken(config.token);
   const client = new ApiClient({ appUrl: ctx.appUrl, token });
   const content = await readMarkdownFile(filePath);
   const state = await fetchRemoteState(client);
-  const page = findPageOrThrow(state, pageId);
+  const page = findPageBySelectorOrThrow(state, pageSelector);
   const now = Date.now();
   page.content = content;
   page.lastUpdatedAt = now;
@@ -474,29 +570,30 @@ async function commandUpdate(ctx) {
   );
 }
 async function commandDelete(ctx) {
-  const pageId = ctx.positionals[0];
-  if (!pageId) {
-    throw new Error("Usage: blankpage delete <page-id>");
+  const pageSelector = ctx.positionals[0];
+  if (!pageSelector) {
+    throw new Error("Usage: blankpage delete <page-id-or-title>");
   }
   const config = await loadConfig();
   const token = requireToken(config.token);
   const client = new ApiClient({ appUrl: ctx.appUrl, token });
   const state = await fetchRemoteState(client);
+  const page = findPageBySelectorOrThrow(state, pageSelector);
   const before = state.pages.length;
-  state.pages = state.pages.filter((page) => page.id !== pageId);
+  state.pages = state.pages.filter((entry) => entry.id !== page.id);
   if (state.pages.length === before) {
-    throw new Error(`Page not found: ${pageId}`);
+    throw new Error(`Page not found: ${pageSelector}`);
   }
   state.lastUpdatedAt = Date.now();
   await pushRemoteState(client, state);
   output(
     ctx.json,
-    { event: "delete_success", pageId },
-    `Deleted page: ${pageId}`
+    { event: "delete_success", pageId: page.id },
+    `Deleted page: ${page.id}`
   );
 }
 async function commandShare(ctx) {
-  const pageIdFlag = stringFlag(ctx.flags, "page-id");
+  const pageSelectorFlag = stringFlag(ctx.flags, "page-id");
   const title = stringFlag(ctx.flags, "title");
   const config = await loadConfig();
   const token = requireToken(config.token);
@@ -504,20 +601,20 @@ async function commandShare(ctx) {
   const state = await fetchRemoteState(client);
   let pageId;
   let content;
-  if (pageIdFlag) {
+  if (pageSelectorFlag) {
     if (ctx.positionals.length > 0) {
       throw new Error(
         "When --page-id is used, do not pass a markdown file path."
       );
     }
-    const page = findPageOrThrow(state, pageIdFlag);
+    const page = findPageBySelectorOrThrow(state, pageSelectorFlag);
     pageId = page.id;
     content = page.content;
   } else {
     const filePath = ctx.positionals[0];
     if (!filePath) {
       throw new Error(
-        "Usage: blankpage share <markdown-file> [--title ...] or blankpage share --page-id <id>"
+        "Usage: blankpage share <markdown-file> [--title ...] or blankpage share --page-id <page-id-or-title>"
       );
     }
     content = await readMarkdownFile(filePath);
@@ -603,12 +700,13 @@ function printHelp() {
 Commands:
   blankpage login [--app-url <url>] [--no-browser] [--json]
   blankpage whoami [--app-url <url>] [--json]
+  blankpage list [--app-url <url>] [--json]
   blankpage create <markdown-file> [--app-url <url>] [--json]
-  blankpage update <page-id> <markdown-file> [--app-url <url>] [--json]
-  blankpage view <page-id> [--app-url <url>] [--json]
-  blankpage delete <page-id> [--app-url <url>] [--json]
+  blankpage update <page-id-or-title> <markdown-file> [--app-url <url>] [--json]
+  blankpage view <page-id-or-title> [--app-url <url>] [--json]
+  blankpage delete <page-id-or-title> [--app-url <url>] [--json]
   blankpage share <markdown-file> [--title "..."] [--app-url <url>] [--json]
-  blankpage share --page-id <page-id> [--title "..."] [--app-url <url>] [--json]
+  blankpage share --page-id <page-id-or-title> [--title "..."] [--app-url <url>] [--json]
   blankpage unshare <link-id-or-url> [--app-url <url>] [--json]
 `);
 }
@@ -633,6 +731,9 @@ async function main() {
     case "whoami":
       await commandWhoAmI(ctx);
       return;
+    case "list":
+      await commandList(ctx);
+      return;
     case "create":
       await commandCreate(ctx);
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blankdotpage/cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "CLI for Blank Page",
   "type": "module",
   "files": [