weplan 0.2.0 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # weplan
 
-Deploy a self-contained HTML file and get back a shareable link — in one command, in under a second. Built for CLI and agent workflows.
+Deploy a self-contained HTML file and get back a shareable link in one command, in under a second. Built for CLI and agent workflows.
 
 ```console
 $ npx weplan create report.html

package/dist/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { readFileSync as readFileSync2 } from "node:fs";
-import { extname } from "node:path";
+import { mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { extname, join as join2 } from "node:path";
 import { parseArgs } from "node:util";
 
 // ../../packages/core/src/index.ts
@@ -66,6 +66,28 @@ class WeplanClient {
   async delete(slug) {
     await this.request("DELETE", `/api/pages/${encodeURIComponent(slug)}`);
   }
+  async fetchPage(slug) {
+    const headers = { accept: "application/json" };
+    if (this.token)
+      headers["authorization"] = `Bearer ${this.token}`;
+    let response;
+    try {
+      response = await this.fetchFn(`${this.baseUrl}/p/${encodeURIComponent(slug)}`, { headers });
+    } catch (cause) {
+      throw new WeplanError(`could not reach ${this.baseUrl}: ${cause.message}`, 0);
+    }
+    if (!response.ok) {
+      let message = `${response.status} ${response.statusText}`;
+      try {
+        const parsed = await response.json();
+        if (parsed.error)
+          message = parsed.error;
+      } catch {}
+      throw new WeplanError(message, response.status);
+    }
+    const visibility = response.headers.get("x-weplan-visibility") === "private" ? "private" : "public";
+    return { html: await response.text(), visibility };
+  }
   async health() {
     return this.request("GET", "/health");
   }
@@ -228,7 +250,7 @@ async function pasteLogin(client, config, log) {
   const pasted = (await prompt("  Code: ")).trim();
   const separator = pasted.indexOf(".");
   if (separator === -1 || pasted.slice(0, separator) !== state) {
-    throw new Error("invalid or expired sign-in code — start sign-in again and paste the full code");
+    throw new Error("invalid or expired sign-in code; start sign-in again and paste the full code");
   }
   const exchange = await client.exchangeCode(pasted.slice(separator + 1));
   return { apiKey: exchange.apiKey, email: exchange.user.email };
@@ -245,12 +267,14 @@ function prompt(question) {
 
 // src/index.ts
 var DEFAULT_URL = "https://plan.wecodeph.dev";
-var VERSION = "0.2.0";
-var HELP = `weplan — deploy a self-contained HTML file, get a shareable link
+var VERSION = "0.3.0";
+var HELP = `weplan: deploy a self-contained HTML file, get a shareable link
 
 Usage
   weplan create <file.html> [--name <name>] [--private] [--allow <emails>]
   weplan update <slug> <file.html>          Replace a page's content, same URL
+  weplan get <url|slug> [--assets <dir>]    Print a page's HTML; --assets writes it to <dir>/index.html
+                                            and extracts embedded images to files (for vision review)
   weplan access <slug> [--public|--private] [--allow <emails>] [--revoke <emails>]
   weplan list                               List your pages
   weplan delete <slug>                      Delete a page
@@ -314,12 +338,66 @@ function printPage(page, verb, asJson) {
   if (page.allow?.length)
     lines.push("", `  allowed: ${page.allow.join(", ")}`);
   if (page.expiresAt) {
-    lines.push("", `  anonymous upload — expires ${page.expiresAt}. Run \`weplan login\` to keep pages.`);
+    lines.push("", `  anonymous upload, expires ${page.expiresAt}. Run \`weplan login\` to keep pages.`);
   }
   process.stdout.write(lines.join(`
 `) + `
 `);
 }
+function parsePageTarget(target, asJson) {
+  if (!/^https?:\/\//i.test(target)) {
+    if (!/^[a-z0-9][a-z0-9-]{1,62}$/.test(target))
+      fail(`not a weplan slug or page URL: ${target}`, asJson);
+    return { slug: target };
+  }
+  let url;
+  try {
+    url = new URL(target);
+  } catch {
+    fail(`not a valid URL: ${target}`, asJson);
+  }
+  const match = url.pathname.match(/^\/p\/([^/]+)\/?$/);
+  if (!match)
+    fail(`not a weplan page URL (expected https://host/p/<slug>): ${target}`, asJson);
+  return { slug: decodeURIComponent(match[1]), origin: url.origin };
+}
+var IMAGE_EXTENSIONS = {
+  "image/png": "png",
+  "image/jpeg": "jpg",
+  "image/jpg": "jpg",
+  "image/gif": "gif",
+  "image/webp": "webp",
+  "image/bmp": "bmp",
+  "image/avif": "avif",
+  "image/svg+xml": "svg",
+  "image/x-icon": "ico",
+  "image/vnd.microsoft.icon": "ico"
+};
+function extractAssets(html, dir) {
+  mkdirSync2(dir, { recursive: true });
+  const images = [];
+  const seen = new Map;
+  const rewritten = html.replace(/data:(image\/[a-z0-9.+-]+);base64,([A-Za-z0-9+/=\s]+)/gi, (whole, type, data) => {
+    const mime = type.toLowerCase();
+    const ext = IMAGE_EXTENSIONS[mime];
+    if (!ext)
+      return whole;
+    const existing = seen.get(whole);
+    if (existing)
+      return existing;
+    const buffer = Buffer.from(data.replace(/\s+/g, ""), "base64");
+    if (buffer.length === 0)
+      return whole;
+    const name = `img-${images.length + 1}.${ext}`;
+    writeFileSync2(join2(dir, name), buffer);
+    images.push({ path: join2(dir, name), type: mime, bytes: buffer.length });
+    seen.set(whole, name);
+    return name;
+  });
+  const htmlPath = join2(dir, "index.html");
+  writeFileSync2(htmlPath, rewritten);
+  return { htmlPath, images };
+}
 function splitEmails(value) {
   if (!value)
     return;
@@ -335,6 +413,7 @@ async function main() {
       public: { type: "boolean", default: false },
       allow: { type: "string" },
       revoke: { type: "string" },
+      assets: { type: "string" },
       paste: { type: "boolean", default: false },
       json: { type: "boolean", default: false },
       url: { type: "string" },
@@ -378,6 +457,46 @@ async function main() {
       printPage(page, "Deployed", asJson);
       return;
     }
+    case "get": {
+      const target = positionals[1];
+      if (!target)
+        fail("usage: weplan get <url|slug>", asJson);
+      const { slug, origin } = parsePageTarget(target, asJson);
+      const reader = origin && origin !== client.baseUrl ? new WeplanClient({ baseUrl: origin, token }) : client;
+      const page = await reader.fetchPage(slug);
+      const pageUrl = `${reader.baseUrl}/p/${slug}`;
+      if (flags.assets) {
+        const saved2 = extractAssets(page.html, flags.assets);
+        if (asJson) {
+          process.stdout.write(JSON.stringify({ slug, url: pageUrl, visibility: page.visibility, size: Buffer.byteLength(page.html), htmlPath: saved2.htmlPath, images: saved2.images }) + `
+`);
+          return;
+        }
+        const lines = [`Saved ${saved2.htmlPath} (${formatSize(Buffer.byteLength(page.html))}, ${page.visibility})`];
+        if (saved2.images.length) {
+          lines.push(`${saved2.images.length} embedded image${saved2.images.length === 1 ? "" : "s"} extracted:`);
+          for (const image of saved2.images)
+            lines.push(`  ${image.path}  ${image.type}  ${formatSize(image.bytes)}`);
+        } else {
+          lines.push("no embedded images");
+        }
+        process.stdout.write(lines.join(`
+`) + `
+`);
+        return;
+      }
+      if (asJson) {
+        process.stdout.write(JSON.stringify({ slug, url: pageUrl, visibility: page.visibility, size: Buffer.byteLength(page.html), html: page.html }) + `
+`);
+        return;
+      }
+      process.stdout.write(page.html);
+      if (!page.html.endsWith(`
+`))
+        process.stdout.write(`
+`);
+      return;
+    }
     case "update": {
       const [, slug, file] = positionals;
       if (!slug || !file)
@@ -469,14 +588,14 @@ Signed in as ${result.email}. Credentials saved to ${configPath()}
     case "status": {
       const health = await client.health();
       process.stdout.write(asJson ? JSON.stringify(health) + `
-` : `ok — ${baseUrl}
+` : `ok: ${baseUrl}
   login: ${health.loginEnabled ? "enabled" : "not configured"}
   anonymous uploads: ${health.anonymousUploads ? "enabled (12h expiry)" : "disabled"}
 `);
       return;
     }
     default:
-      fail(`unknown command "${command}" — run weplan --help`, asJson);
+      fail(`unknown command "${command}"; run weplan --help`, asJson);
   }
 }
 main().catch((cause) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weplan",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Deploy a self-contained HTML file and get back a shareable link. Built for CLI and agent workflows.",
   "license": "MIT",
   "type": "module",