htmlship 0.1.2 → 0.1.4

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.2";
+    VERSION = "0.1.4";
   }
 });
 
@@ -90,24 +90,24 @@ var init_client = __esm({
         if (options.password != null) body["password"] = options.password;
         if (options.expiresIn != null) body["expires_in"] = options.expiresIn;
         if (options.parentSlug != null) body["parent_slug"] = options.parentSlug;
-        return await this.request("POST", "/api/v1/pastes", { body });
+        return await this.request("POST", "/api/v1/pages", { body });
       }
       async get(slug) {
-        return await this.request("GET", `/api/v1/pastes/${encodeURIComponent(slug)}`);
+        return await this.request("GET", `/api/v1/pages/${encodeURIComponent(slug)}`);
       }
       async update(slug, html, ownerKey, options = {}) {
         const body = { html };
         if (options.title != null) body["title"] = options.title;
         return await this.request(
           "PATCH",
-          `/api/v1/pastes/${encodeURIComponent(slug)}`,
+          `/api/v1/pages/${encodeURIComponent(slug)}`,
           { body, headers: { "X-Owner-Key": ownerKey } }
         );
       }
       async delete(slug, ownerKey) {
         await this.request(
           "DELETE",
-          `/api/v1/pastes/${encodeURIComponent(slug)}`,
+          `/api/v1/pages/${encodeURIComponent(slug)}`,
           { headers: { "X-Owner-Key": ownerKey }, expectNoBody: true }
         );
       }
@@ -121,7 +121,7 @@ var init_client = __esm({
         if (options.expiresIn != null) body["expires_in"] = options.expiresIn;
         return await this.request(
           "POST",
-          `/api/v1/pastes/${encodeURIComponent(parentSlug)}/version`,
+          `/api/v1/pages/${encodeURIComponent(parentSlug)}/version`,
           { body }
         );
       }
@@ -178,7 +178,7 @@ var init_client = __esm({
             }
             return text;
           } catch {
-            return text;
+            return `HTTP ${response.status}`;
           }
         } catch {
           return `HTTP ${response.status}`;
@@ -203,17 +203,19 @@ function buildMcpServer(client) {
   server.registerTool(
     "publish_html",
     {
-      description: "Publish an HTML document and get a public URL. The owner_key returned is the only credential to update or delete this paste later \u2014 save it.",
+      description: "Publish an HTML document and get a public URL. The owner_key returned is the only credential to update or delete this page later \u2014 save it.",
       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 paste = await c.publish(html, {
+        const page = await c.publish(html, {
           title: title ?? null,
+          password: password ?? null,
           expiresIn: expires_in ?? null
         });
         return {
@@ -222,10 +224,10 @@ function buildMcpServer(client) {
               type: "text",
               text: JSON.stringify(
                 {
-                  url: paste.url,
-                  slug: paste.slug,
-                  owner_key: paste.owner_key,
-                  expires_at: paste.expires_at
+                  url: page.url,
+                  slug: page.slug,
+                  owner_key: page.owner_key,
+                  expires_at: page.expires_at
                 },
                 null,
                 2
@@ -241,20 +243,20 @@ function buildMcpServer(client) {
   server.registerTool(
     "fetch_html",
     {
-      description: "Fetch a paste's metadata. To view the rendered HTML, open the `url` in a browser \u2014 the content is served from a sandboxed subdomain.",
+      description: "Fetch a page's metadata. To view the rendered HTML, open the `url` in a browser \u2014 the content is served from a sandboxed subdomain.",
       inputSchema: {
-        slug: z.string().describe("The paste's short identifier.")
+        slug: z.string().describe("The page's short identifier.")
       }
     },
     async ({ slug }) => {
       try {
-        const paste = await c.get(slug);
+        const page = await c.get(slug);
         return {
-          content: [{ type: "text", text: JSON.stringify(paste, null, 2) }]
+          content: [{ type: "text", text: JSON.stringify(page, null, 2) }]
         };
       } catch (err) {
         if (err instanceof NotFoundError) {
-          return errorResult("fetch_html", new HTMLShipError(`paste '${slug}' not found`));
+          return errorResult("fetch_html", new HTMLShipError(`page '${slug}' not found`));
         }
         return errorResult("fetch_html", err);
       }
@@ -263,9 +265,9 @@ function buildMcpServer(client) {
   server.registerTool(
     "update_html",
     {
-      description: "Replace the HTML for an existing paste. Requires the original owner_key.",
+      description: "Replace the HTML for an existing page. Requires the original owner_key.",
       inputSchema: {
-        slug: z.string().describe("The paste's short identifier."),
+        slug: z.string().describe("The page's short identifier."),
         html: z.string().describe("The new HTML body."),
         owner_key: z.string().describe("The owner key returned at publish time."),
         title: z.string().optional().describe("Optional new title.")
@@ -273,13 +275,13 @@ function buildMcpServer(client) {
     },
     async ({ slug, html, owner_key, title }) => {
       try {
-        const paste = await c.update(slug, html, owner_key, { title: title ?? null });
+        const page = await c.update(slug, html, owner_key, { title: title ?? null });
         return {
           content: [
             {
               type: "text",
               text: JSON.stringify(
-                { url: paste.url, slug: paste.slug, updated_at: paste.updated_at },
+                { url: page.url, slug: page.slug, updated_at: page.updated_at },
                 null,
                 2
               )
@@ -386,7 +388,7 @@ function createKeyStore(overrideDir) {
 
 // src/commands/delete.ts
 function registerDelete(program) {
-  program.command("delete").description("Soft-delete a paste.").argument("<slug>", "Paste 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)").option("-y, --yes", "Skip confirmation").action(async function(slug, opts) {
     const keys = createKeyStore();
     const ownerKey = opts.ownerKey ?? keys.lookupOwnerKey(slug);
     if (!ownerKey) {
@@ -396,7 +398,7 @@ function registerDelete(program) {
     }
     if (!opts.yes) {
       const rl = createInterface({ input: process.stdin, output: process.stderr });
-      const answer = await rl.question(`Delete paste '${slug}'? [y/N] `);
+      const answer = await rl.question(`Delete page '${slug}'? [y/N] `);
       rl.close();
       if (!/^y(es)?$/i.test(answer.trim())) {
         process.stderr.write("Aborted.\n");
@@ -416,16 +418,16 @@ function registerDelete(program) {
 init_client();
 init_errors();
 function registerGet(program) {
-  program.command("get").description("Show metadata for a paste.").argument("<slug>", "Paste slug").action(async function(slug) {
+  program.command("get").description("Show metadata for a page.").argument("<slug>", "Page slug").action(async function(slug) {
     const apiUrl = this.parent?.opts()?.apiUrl;
     const client = new HTMLShipClient({ baseUrl: apiUrl });
     try {
-      const paste = await client.get(slug);
-      process.stdout.write(`${JSON.stringify(paste, null, 2)}
+      const page = await client.get(slug);
+      process.stdout.write(`${JSON.stringify(page, null, 2)}
 `);
     } catch (err) {
       if (err instanceof NotFoundError) {
-        throw new HTMLShipError(`paste '${slug}' not found`);
+        throw new HTMLShipError(`page '${slug}' not found`);
       }
       throw err;
     }
@@ -436,12 +438,12 @@ function registerGet(program) {
 init_client();
 init_errors();
 function registerListMine(program) {
-  program.command("list-mine").description("List pastes whose owner keys are saved locally.").option("--limit <n>", "max entries to show", "20").action(async function(opts) {
+  program.command("list-mine").description("List pages whose owner keys are saved locally.").option("--limit <n>", "max entries to show", "20").action(async function(opts) {
     const keys = createKeyStore();
     const data = keys.load();
     const entries = Object.entries(data);
     if (entries.length === 0) {
-      process.stdout.write(`No saved pastes in ${keys.file}.
+      process.stdout.write(`No saved pages in ${keys.file}.
 `);
       return;
     }
@@ -452,13 +454,13 @@ function registerListMine(program) {
     const rows = await Promise.all(
       sorted.map(async ([slug, info]) => {
         try {
-          const paste = await client.get(slug);
+          const page = await client.get(slug);
           return {
             slug,
             url: info.url,
-            title: paste.title ?? info.title ?? "",
-            size: `${paste.size_bytes}B`,
-            views: String(paste.view_count),
+            title: page.title ?? info.title ?? "",
+            size: `${page.size_bytes}B`,
+            views: String(page.view_count),
             status: "ok"
           };
         } catch (err) {
@@ -530,13 +532,13 @@ async function tryClipboardCopy(text) {
 
 // src/commands/publish.ts
 function registerPublish(program) {
-  program.command("publish").description("Publish an HTML document and get a URL.").argument("[source]", "file path, '-' for stdin (default: stdin if piped)").option("-f, --file <path>", "HTML file path").option("--title <title>", "Optional title").option("--password <password>", "Password-protect the paste").option("--expires-in <minutes>", "Minutes until expiry (1\u201310080, i.e. up to 7 days)").option("--no-clipboard", "Don't copy URL to clipboard").option("-q, --quiet", "Print only the URL").action(async function(source, opts) {
+  program.command("publish").description("Publish an HTML document and get a URL.").argument("[source]", "file path, '-' for stdin (default: stdin if piped)").option("-f, --file <path>", "HTML file path").option("--title <title>", "Optional title").option("--password <password>", "Password-protect the page").option("--expires-in <minutes>", "Minutes until expiry (1\u201310080, i.e. up to 7 days)").option("--no-clipboard", "Don't copy URL to clipboard").option("-q, --quiet", "Print only the URL").action(async function(source, opts) {
     const html = readHtmlFromSource(source, opts.file);
     const apiUrl = this.parent?.opts()?.apiUrl;
     const client = new HTMLShipClient({ baseUrl: apiUrl });
-    let paste;
+    let page;
     try {
-      paste = await client.publish(html, {
+      page = await client.publish(html, {
         title: opts.title ?? null,
         password: opts.password ?? null,
         expiresIn: opts.expiresIn ? Number.parseInt(opts.expiresIn, 10) : null
@@ -545,28 +547,28 @@ function registerPublish(program) {
       throw new HTMLShipError(`publish failed: ${err.message}`);
     }
     const keys = createKeyStore();
-    keys.remember(paste.slug, {
-      owner_key: paste.owner_key,
-      url: paste.url,
+    keys.remember(page.slug, {
+      owner_key: page.owner_key,
+      url: page.url,
       title: opts.title ?? null
     });
     if (opts.quiet) {
-      process.stdout.write(`${paste.url}
+      process.stdout.write(`${page.url}
 `);
       return;
     }
-    process.stdout.write(`${paste.url}
+    process.stdout.write(`${page.url}
 `);
-    process.stderr.write(`slug:      ${paste.slug}
+    process.stderr.write(`slug:      ${page.slug}
 `);
-    process.stderr.write(`owner_key: ${paste.owner_key}  (saved to ${keys.file})
+    process.stderr.write(`owner_key: ${page.owner_key}  (saved to ${keys.file})
 `);
-    if (paste.expires_at) {
-      process.stderr.write(`expires:   ${paste.expires_at}
+    if (page.expires_at) {
+      process.stderr.write(`expires:   ${page.expires_at}
 `);
     }
     if (opts.noClipboard !== true) {
-      const copied = await tryClipboardCopy(paste.url);
+      const copied = await tryClipboardCopy(page.url);
       if (copied) process.stderr.write("(URL copied to clipboard)\n");
     }
   });
@@ -576,7 +578,7 @@ function registerPublish(program) {
 init_client();
 init_errors();
 function registerUpdate(program) {
-  program.command("update").description("Replace HTML for an existing paste.").argument("<slug>", "Paste 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)").action(async function(slug, source, opts) {
     const html = readHtmlFromSource(source, opts.file);
     const keys = createKeyStore();
     const ownerKey = opts.ownerKey ?? keys.lookupOwnerKey(slug);
@@ -587,8 +589,8 @@ function registerUpdate(program) {
     }
     const apiUrl = this.parent?.opts()?.apiUrl;
     const client = new HTMLShipClient({ baseUrl: apiUrl });
-    const paste = await client.update(slug, html, ownerKey, { title: opts.title ?? null });
-    process.stdout.write(`${paste.url}
+    const page = await client.update(slug, html, ownerKey, { title: opts.title ?? null });
+    process.stdout.write(`${page.url}
 `);
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "htmlship",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Host and share HTML pages from LLMs and coding agents in one line. CLI + MCP server.",
   "keywords": [
     "html",
@@ -16,7 +16,7 @@
   "homepage": "https://htmlship.com",
   "repository": {
     "type": "git",
-    "url": "https://github.com/htmlship/htmlship.git",
+    "url": "git+https://github.com/htmlship/htmlship.git",
     "directory": "npm"
   },
   "license": "MIT",
@@ -26,7 +26,7 @@
     "node": ">=18"
   },
   "bin": {
-    "htmlship": "./dist/cli.js"
+    "htmlship": "dist/cli.js"
   },
   "files": [
     "dist",