htmlship 0.1.3 → 0.1.5

package/README.md

@@ -6,8 +6,8 @@ CLI + MCP server for [HTMLShip](https://htmlship.com) — host and share HTML pa
 # Publish an HTML file
 npx htmlship publish report.html
 
-# Pipe from stdin
-cat report.html | npx htmlship publish -
+# Password-protect a page
+npx htmlship publish report.html --password "demo-pass"
 
 # Inspect / update / delete using the saved owner key
 npx htmlship get <slug>
@@ -18,7 +18,7 @@ npx htmlship list-mine
 
 ## MCP server
 
-`htmlship mcp` starts a stdio MCP server with three tools: `publish_html`, `fetch_html`, `update_html`.
+`htmlship mcp` starts a stdio MCP server with three tools: `publish_html` (with optional `password`), `fetch_html`, `update_html`.
 
 ### Claude Desktop / Claude Code / Cursor
 

package/dist/cli.js

@@ -56,7 +56,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "0.1.3";
+    VERSION = "0.1.5";
   }
 });
 
@@ -207,13 +207,15 @@ function buildMcpServer(client) {
       inputSchema: {
         html: z.string().describe("The HTML body to publish."),
         title: z.string().optional().describe("Optional human-readable title."),
+        password: z.string().optional().describe("Optional password required before viewing the page."),
         expires_in: z.number().int().min(1).max(60 * 24 * 7).optional().describe("Optional TTL in minutes (1\u201310080, i.e. up to 7 days).")
       }
     },
-    async ({ html, title, expires_in }) => {
+    async ({ html, title, password, expires_in }) => {
       try {
         const page = await c.publish(html, {
           title: title ?? null,
+          password: password ?? null,
           expiresIn: expires_in ?? null
         });
         return {
@@ -386,23 +388,29 @@ function createKeyStore(overrideDir) {
 
 // src/commands/delete.ts
 function registerDelete(program) {
-  program.command("delete").description("Soft-delete a page.").argument("<slug>", "Page slug").option("--owner-key <key>", "Owner key (defaults to local store)").option("-y, --yes", "Skip confirmation").action(async function(slug, opts) {
+  program.command("delete").description("Soft-delete a page.").argument("<slug>", "Page slug").option("--owner-key <key>", "Owner key (defaults to local store, else prompted)").option("-y, --yes", "Skip confirmation").action(async function(slug, opts) {
     const keys = createKeyStore();
-    const ownerKey = opts.ownerKey ?? keys.lookupOwnerKey(slug);
-    if (!ownerKey) {
-      throw new HTMLShipError(
-        `no owner key for '${slug}' in ${keys.file}; pass --owner-key explicitly`
-      );
-    }
-    if (!opts.yes) {
+    let ownerKey = opts.ownerKey ?? keys.lookupOwnerKey(slug);
+    if (!opts.yes || !ownerKey) {
       const rl = createInterface({ input: process.stdin, output: process.stderr });
-      const answer = await rl.question(`Delete page '${slug}'? [y/N] `);
-      rl.close();
-      if (!/^y(es)?$/i.test(answer.trim())) {
-        process.stderr.write("Aborted.\n");
-        return;
+      try {
+        if (!opts.yes) {
+          const answer = await rl.question(`Delete page '${slug}'? [y/N] `);
+          if (!/^y(es)?$/i.test(answer.trim())) {
+            process.stderr.write("Aborted.\n");
+            return;
+          }
+        }
+        if (!ownerKey) {
+          ownerKey = (await rl.question(`owner_key for '${slug}': `)).trim();
+        }
+      } finally {
+        rl.close();
       }
     }
+    if (!ownerKey) {
+      throw new HTMLShipError("owner_key is required");
+    }
     const apiUrl = this.parent?.opts()?.apiUrl;
     const client = new HTMLShipClient({ baseUrl: apiUrl });
     await client.delete(slug, ownerKey);
@@ -575,15 +583,22 @@ function registerPublish(program) {
 // src/commands/update.ts
 init_client();
 init_errors();
+import { createInterface as createInterface2 } from "readline/promises";
 function registerUpdate(program) {
-  program.command("update").description("Replace HTML for an existing page.").argument("<slug>", "Page slug").argument("[source]", "file path, '-' for stdin").option("-f, --file <path>", "HTML file path").option("--title <title>", "Optional new title").option("--owner-key <key>", "Owner key (defaults to local store)").action(async function(slug, source, opts) {
+  program.command("update").description("Replace HTML for an existing page.").argument("<slug>", "Page slug").argument("[source]", "file path, '-' for stdin").option("-f, --file <path>", "HTML file path").option("--title <title>", "Optional new title").option("--owner-key <key>", "Owner key (defaults to local store, else prompted)").action(async function(slug, source, opts) {
     const html = readHtmlFromSource(source, opts.file);
     const keys = createKeyStore();
-    const ownerKey = opts.ownerKey ?? keys.lookupOwnerKey(slug);
+    let ownerKey = opts.ownerKey ?? keys.lookupOwnerKey(slug);
     if (!ownerKey) {
-      throw new HTMLShipError(
-        `no owner key for '${slug}' in ${keys.file}; pass --owner-key explicitly`
-      );
+      const rl = createInterface2({ input: process.stdin, output: process.stderr });
+      try {
+        ownerKey = (await rl.question(`owner_key for '${slug}': `)).trim();
+      } finally {
+        rl.close();
+      }
+      if (!ownerKey) {
+        throw new HTMLShipError("owner_key is required");
+      }
     }
     const apiUrl = this.parent?.opts()?.apiUrl;
     const client = new HTMLShipClient({ baseUrl: apiUrl });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "htmlship",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Host and share HTML pages from LLMs and coding agents in one line. CLI + MCP server.",
   "keywords": [
     "html",