@blankdotpage/cli 0.1.1 → 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

@@ -3,7 +3,6 @@
 // src/index.ts
 import fs2 from "node:fs/promises";
 import os2 from "node:os";
-import { spawn } from "node:child_process";
 import { URL } from "node:url";
 
 // src/lib/args.ts
@@ -41,10 +40,67 @@ function booleanFlag(flags, key) {
   return flags[key] === true;
 }
 
+// src/lib/browser.ts
+import {
+  spawn
+} from "node:child_process";
+function getLaunchCommand(platform, url) {
+  if (platform === "darwin") {
+    return { command: "open", args: [url] };
+  }
+  if (platform === "linux") {
+    return { command: "xdg-open", args: [url] };
+  }
+  if (platform === "win32") {
+    return { command: "cmd", args: ["/c", "start", "", url] };
+  }
+  return null;
+}
+function toError(error) {
+  return error instanceof Error ? error : new Error(String(error));
+}
+function openBrowser(url, options = {}) {
+  const platform = options.platform ?? process.platform;
+  const launch = getLaunchCommand(platform, url);
+  if (!launch) {
+    return false;
+  }
+  const spawnCommand = options.spawnCommand ?? ((command, args, spawnOptions) => spawn(command, args, spawnOptions));
+  const onError = options.onError ?? (() => {
+  });
+  try {
+    const child = spawnCommand(launch.command, launch.args, {
+      stdio: "ignore",
+      detached: true
+    });
+    child.once("error", (error) => {
+      onError(toError(error));
+    });
+    child.unref();
+    return true;
+  } catch (error) {
+    onError(toError(error));
+    return false;
+  }
+}
+
 // src/lib/config.ts
 import os from "node:os";
 import path from "node:path";
 import fs from "node:fs/promises";
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+function readOptionalString(input, key) {
+  const value = input[key];
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "string") {
+    throw new Error(`Invalid CLI config value for "${key}"`);
+  }
+  return value;
+}
 function resolveConfigPath() {
   if (process.env.BLANKPAGE_CLI_CONFIG_PATH) {
     return process.env.BLANKPAGE_CLI_CONFIG_PATH;
@@ -55,15 +111,39 @@ async function loadConfig() {
   const configPath = resolveConfigPath();
   try {
     const raw = await fs.readFile(configPath, "utf8");
-    return JSON.parse(raw);
-  } catch {
-    return {};
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch (error) {
+      throw new Error(
+        `Failed to parse CLI config file at ${configPath}: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+    if (!isObject(parsed)) {
+      throw new Error(
+        `Invalid CLI config file at ${configPath}: expected an object`
+      );
+    }
+    return {
+      appUrl: readOptionalString(parsed, "appUrl"),
+      token: readOptionalString(parsed, "token"),
+      tokenExpiresAt: readOptionalString(parsed, "tokenExpiresAt")
+    };
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return {};
+    }
+    throw error;
   }
 }
 async function saveConfig(config) {
   const configPath = resolveConfigPath();
-  await fs.mkdir(path.dirname(configPath), { recursive: true });
-  await fs.writeFile(configPath, JSON.stringify(config, null, 2), "utf8");
+  await fs.mkdir(path.dirname(configPath), { recursive: true, mode: 448 });
+  await fs.writeFile(configPath, JSON.stringify(config, null, 2), {
+    encoding: "utf8",
+    mode: 384
+  });
+  await fs.chmod(configPath, 384);
 }
 
 // src/lib/http.ts
@@ -212,23 +292,6 @@ function requireToken(token) {
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
-function maybeOpenBrowser(url) {
-  const platform = process.platform;
-  if (platform === "darwin") {
-    spawn("open", [url], { stdio: "ignore", detached: true }).unref();
-    return;
-  }
-  if (platform === "linux") {
-    spawn("xdg-open", [url], { stdio: "ignore", detached: true }).unref();
-    return;
-  }
-  if (platform === "win32") {
-    spawn("cmd", ["/c", "start", "", url], {
-      stdio: "ignore",
-      detached: true
-    }).unref();
-  }
-}
 function output(json, payload, text) {
   if (json) {
     printJson(payload);
@@ -243,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");
@@ -265,13 +411,16 @@ async function commandLogin(ctx) {
     {
       event: "login_started",
       authorizeUrl: started.authorizeUrl,
-      challengeId: started.challengeId,
-      challengeSecret: started.challengeSecret
+      challengeId: started.challengeId
     },
     `Open this URL to authorize: ${started.authorizeUrl}`
   );
   if (!noBrowser) {
-    maybeOpenBrowser(started.authorizeUrl);
+    openBrowser(started.authorizeUrl, {
+      onError: (error) => {
+        printError(`Could not open browser automatically: ${error.message}`);
+      }
+    });
   }
   const deadline = Date.now() + timeoutSeconds * 1e3;
   while (Date.now() < deadline) {
@@ -337,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) {
@@ -365,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;
@@ -385,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;
@@ -408,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);
@@ -438,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);
@@ -537,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]
 `);
 }
@@ -567,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.1",
+  "version": "0.1.3",
   "description": "CLI for Blank Page",
   "type": "module",
   "files": [