htmlship 0.2.0 → 0.3.0

package/dist/cli.js

@@ -53,8 +53,16 @@ var init_errors = __esm({
 
 // src/build.ts
 import { spawnSync } from "child_process";
-import { existsSync, readFileSync, statSync } from "fs";
-import { dirname, extname, isAbsolute, join, relative, resolve } from "path";
+import {
+  existsSync,
+  readdirSync,
+  readFileSync,
+  renameSync,
+  statSync,
+  unlinkSync,
+  writeFileSync
+} from "fs";
+import { dirname, extname, isAbsolute, join, relative, resolve, sep } from "path";
 function detectPackageManager(dir) {
   for (const [file, pm] of LOCKFILES) {
     if (existsSync(join(dir, file))) return pm;
@@ -121,16 +129,61 @@ function exec(command, cwd, timeout, log) {
     throw new HTMLShipError(`build exited with code ${r.status}: \`${command}\``);
   }
 }
+function looksLikeNextJs(dir) {
+  if (existsSync(join(dir, ".next"))) return true;
+  return ["next.config.js", "next.config.mjs", "next.config.ts", "next.config.cjs"].some(
+    (f) => existsSync(join(dir, f))
+  );
+}
+function noOutputMessage(dir) {
+  const base = `no build output found (looked for ${OUTPUT_DIR_CANDIDATES.map((c) => `${c}/`).join(", ")}; use --out to specify)`;
+  if (looksLikeNextJs(dir)) {
+    return `${base}.
+This looks like a Next.js app: \`next build\` writes a server build to .next/, which is not statically hostable. Add \`output: "export"\` to your next.config to emit a static out/ folder, then re-run. Note: deploy inlines a single-page static app \u2014 server-rendered or multi-route Next.js sites are not supported.`;
+  }
+  return base;
+}
 function resolveOutputDir(dir, override) {
-  const candidates = override ? [override] : ["dist", "build"];
+  const candidates = override ? [override] : OUTPUT_DIR_CANDIDATES;
   for (const c of candidates) {
     const p = isAbsolute(c) ? c : join(dir, c);
     if (existsSync(p) && statSync(p).isDirectory()) return p;
   }
   throw new HTMLShipError(
-    override ? `build output dir not found: ${override}` : "no build output found (looked for dist/ and build/; use --out to specify)"
+    override ? `build output dir not found: ${override}` : noOutputMessage(dir)
   );
 }
+function isNextServerBuild(dir) {
+  return existsSync(join(dir, "BUILD_ID")) || existsSync(join(dir, "server")) && existsSync(join(dir, "static"));
+}
+function noEntryMessage(outDir, htmls) {
+  if (isNextServerBuild(outDir)) {
+    return `no static HTML entry in ${outDir} \u2014 this looks like a Next.js server build, not a static site. Set \`output: "export"\` in your next.config (this emits a fully static out/ folder); changing distDir alone only renames the server build. Note: apps that use middleware or server rendering cannot be statically exported.`;
+  }
+  if (htmls.length > 1) {
+    return `no index.html in ${outDir}, but found ${htmls.length} HTML files (${htmls.slice(0, 4).join(", ")}${htmls.length > 4 ? ", \u2026" : ""}). deploy ships a single page \u2014 pass --entry <file> to choose one.`;
+  }
+  return `entry HTML not found in ${outDir} (looked for index.html); pass --entry <file> to specify it.`;
+}
+function resolveEntry(outDir, entryOverride) {
+  if (entryOverride) {
+    const p = join(outDir, entryOverride);
+    if (existsSync(p)) return p;
+    throw new HTMLShipError(`entry HTML not found: ${p}`);
+  }
+  for (const name of ["index.html", "200.html", "index.htm"]) {
+    const p = join(outDir, name);
+    if (existsSync(p)) return p;
+  }
+  let htmls = [];
+  try {
+    htmls = readdirSync(outDir).filter((f) => f.toLowerCase().endsWith(".html"));
+  } catch {
+    htmls = [];
+  }
+  if (htmls.length === 1) return join(outDir, htmls[0]);
+  throw new HTMLShipError(noEntryMessage(outDir, htmls));
+}
 function mimeFor(p) {
   return MIME[extname(p).toLowerCase()] ?? "application/octet-stream";
 }
@@ -232,6 +285,108 @@ function formatBytes(n) {
   if (n < 1024 * 1024) return `${(n / 1024).toFixed(1)} KB`;
   return `${(n / (1024 * 1024)).toFixed(2)} MB`;
 }
+function isNextProject(dir) {
+  if (NEXT_CONFIGS.some((f) => existsSync(join(dir, f)))) return true;
+  try {
+    const pkg = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
+    return Boolean(pkg.dependencies?.["next"] || pkg.devDependencies?.["next"]);
+  } catch {
+    return false;
+  }
+}
+function injectNextBase(dir) {
+  const existing = NEXT_CONFIGS.find((f) => existsSync(join(dir, f)));
+  if (existing && existing.endsWith(".ts")) {
+    throw new HTMLShipError(
+      `Next .ts config isn't auto-configured yet. Temporarily set basePath and assetPrefix to "${SITE_BASE_PLACEHOLDER}" and output: "export" in next.config.ts, or convert it to next.config.mjs, then re-run.`
+    );
+  }
+  const wrapper = join(dir, "next.config.mjs");
+  const base = SITE_BASE_PLACEHOLDER;
+  if (!existing) {
+    writeFileSync(
+      wrapper,
+      `export default { output: 'export', basePath: '${base}', assetPrefix: '${base}', images: { unoptimized: true }, trailingSlash: true };
+`
+    );
+    return () => {
+      try {
+        unlinkSync(wrapper);
+      } catch {
+      }
+    };
+  }
+  const ext = extname(existing);
+  const backupName = `next.config.__hsorig__${ext}`;
+  renameSync(join(dir, existing), join(dir, backupName));
+  writeFileSync(
+    wrapper,
+    `import orig from './${backupName}';
+const base = '${base}';
+const over = { output: 'export', basePath: base, assetPrefix: base, images: { ...(typeof orig === 'object' && orig ? orig.images : {}), unoptimized: true }, trailingSlash: true };
+export default typeof orig === 'function' ? ((...a) => ({ ...orig(...a), ...over })) : { ...orig, ...over };
+`
+  );
+  return () => {
+    try {
+      unlinkSync(wrapper);
+    } catch {
+    }
+    try {
+      renameSync(join(dir, backupName), join(dir, existing));
+    } catch {
+    }
+  };
+}
+function packageSite(outDir, maxBytes = 10 * 1024 * 1024) {
+  const files = [];
+  let total = 0;
+  const walk = (d) => {
+    for (const e of readdirSync(d, { withFileTypes: true })) {
+      const full = join(d, e.name);
+      if (e.isDirectory()) walk(full);
+      else if (e.isFile()) {
+        const buf = readFileSync(full);
+        total += buf.length;
+        if (total > maxBytes) {
+          throw new HTMLShipError(`site exceeds the ${maxBytes / (1024 * 1024)} MB limit`);
+        }
+        files.push({ path: relative(outDir, full).split(sep).join("/"), content: buf.toString("base64") });
+      }
+    }
+  };
+  walk(outDir);
+  return { files, bytes: total };
+}
+function buildAndPackageSite(dir, opts = {}) {
+  const log = opts.log ?? (() => {
+  });
+  const project = detectProject(dir, opts.buildCmd);
+  const next = !opts.buildCmd && isNextProject(dir);
+  log(`project:   ${dir}`);
+  log(`pkg mgr:   ${project.packageManager}`);
+  log(`framework: ${next ? "next.js (static export)" : "multi-file"}`);
+  const cleanup = next ? injectNextBase(dir) : () => {
+  };
+  try {
+    if (next) log(`base:      ${SITE_BASE_PLACEHOLDER} (injected for path hosting)`);
+    runBuild(project, {
+      install: opts.install,
+      buildCmd: opts.buildCmd,
+      timeoutMs: opts.timeoutMs,
+      log
+    });
+  } finally {
+    cleanup();
+  }
+  const outDir = resolveOutputDir(dir, opts.out);
+  const entryAbs = resolveEntry(outDir, opts.entry);
+  const entry = relative(outDir, entryAbs).split(sep).join("/");
+  const { files, bytes } = packageSite(outDir);
+  log(`output:    ${outDir}`);
+  log(`packaged:  ${files.length} files, ${formatBytes(bytes)}`);
+  return { files, bytes, entry, framework: next ? "next" : "multi-file" };
+}
 function buildAndInline(dir, opts = {}) {
   const log = opts.log ?? (() => {
   });
@@ -246,18 +401,20 @@ function buildAndInline(dir, opts = {}) {
     log
   });
   const outDir = resolveOutputDir(dir, opts.out);
-  const entry = join(outDir, opts.entry ?? "index.html");
+  const entry = resolveEntry(outDir, opts.entry);
   const result = inlineHtml(outDir, entry);
   log(`output:    ${outDir}`);
   log(`inlined:   ${formatBytes(result.bytes)} single HTML`);
   for (const w of result.warnings) log(`warning:   ${w}`);
   return result;
 }
-var LOCKFILES, DEFAULT_BUILD_TIMEOUT_MS, MIME;
+var SITE_BASE_PLACEHOLDER, NEXT_CONFIGS, LOCKFILES, DEFAULT_BUILD_TIMEOUT_MS, OUTPUT_DIR_CANDIDATES, MIME;
 var init_build = __esm({
   "src/build.ts"() {
     "use strict";
     init_errors();
+    SITE_BASE_PLACEHOLDER = "/__htmlship_base__";
+    NEXT_CONFIGS = ["next.config.mjs", "next.config.js", "next.config.cjs", "next.config.ts"];
     LOCKFILES = [
       ["pnpm-lock.yaml", "pnpm"],
       ["yarn.lock", "yarn"],
@@ -266,6 +423,7 @@ var init_build = __esm({
       ["package-lock.json", "npm"]
     ];
     DEFAULT_BUILD_TIMEOUT_MS = 5 * 6e4;
+    OUTPUT_DIR_CANDIDATES = ["dist", "build", "out"];
     MIME = {
       ".png": "image/png",
       ".jpg": "image/jpeg",
@@ -292,7 +450,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "0.2.0";
+    VERSION = "0.3.0";
   }
 });
 
@@ -352,6 +510,37 @@ var init_client = __esm({
           sandboxMode: "relaxed"
         });
       }
+      /** Upload a multi-file static site (built locally) and get its URL. */
+      async deploySite(files, options = {}) {
+        const body = { files };
+        if (options.entry) body["entry"] = options.entry;
+        if (options.title != null) body["title"] = options.title;
+        if (options.password != null) body["password"] = options.password;
+        if (options.expiresIn != null) body["expires_in"] = options.expiresIn;
+        return await this.request("POST", "/api/v1/sites", { body });
+      }
+      /**
+       * Build a local project and deploy it, auto-choosing single-file inlining
+       * (SPA) vs. multi-file site hosting (Next.js, or when options.site is set).
+       */
+      async deployProject(projectDir, options = {}) {
+        const useSite = options.singleFile ? false : options.site || isNextProject(projectDir);
+        if (useSite) {
+          const { files, entry } = buildAndPackageSite(projectDir, {
+            buildCmd: options.buildCmd,
+            out: options.out,
+            entry: options.entry,
+            install: options.install
+          });
+          return await this.deploySite(files, {
+            entry,
+            title: options.title ?? null,
+            password: options.password ?? null,
+            expiresIn: options.expiresIn ?? null
+          });
+        }
+        return await this.deploy(projectDir, options);
+      }
       async get(slug) {
         return await this.request("GET", `/api/v1/pages/${encodeURIComponent(slug)}`);
       }
@@ -503,22 +692,24 @@ function buildMcpServer(client) {
   server.registerTool(
     "deploy_project",
     {
-      description: "Build a local frontend project (npm/pnpm/yarn/bun) and publish the compiled app as one self-contained, script-enabled page. Runs the project's build script ON THIS MACHINE, inlines the output (dist/ or build/) into a single HTML file, and publishes it with relaxed sandboxing so its JavaScript runs in an isolated origin. The owner_key returned is the only credential to update or delete this page later \u2014 save it.",
+      description: "Build a local frontend project (npm/pnpm/yarn/bun) and deploy the compiled app. Runs the project's build script ON THIS MACHINE. Single-page apps (Vite/CRA) are inlined into one self-contained, script-enabled page; multi-file sites (Next.js static export, auto-detected) are hosted at view.htmlship.com/{slug}/. Both run with relaxed sandboxing so their JS runs in an isolated origin. The owner_key returned is the only credential to update or delete this later \u2014 save it.",
       inputSchema: {
         dir: z.string().describe("Path to the project directory (must contain package.json)."),
         build_cmd: z.string().optional().describe("Override the build command (default: detected build/build:prod script)."),
-        out: z.string().optional().describe("Build output directory (default: auto-detect dist/ or build/)."),
+        out: z.string().optional().describe("Build output directory (default: auto-detect dist/, build/, out/)."),
+        site: z.boolean().optional().describe("Force multi-file site hosting (auto-detected for Next.js)."),
         install: z.boolean().optional().describe("Run dependency install before building."),
         title: z.string().optional().describe("Optional human-readable title."),
         password: z.string().optional().describe("Optional password required before viewing."),
         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 ({ dir, build_cmd, out, install, title, password, expires_in }) => {
+    async ({ dir, build_cmd, out, site, install, title, password, expires_in }) => {
       try {
-        const page = await c.deploy(dir, {
+        const page = await c.deployProject(dir, {
           buildCmd: build_cmd ?? void 0,
           out: out ?? void 0,
+          site: site ?? void 0,
           install: install ?? void 0,
           title: title ?? null,
           password: password ?? null,
@@ -634,7 +825,7 @@ init_errors();
 import { createInterface } from "readline/promises";
 
 // src/keystore.ts
-import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync, chmodSync } from "fs";
+import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync as writeFileSync2, chmodSync } from "fs";
 import { homedir } from "os";
 import { join as join2 } from "path";
 function createKeyStore(overrideDir) {
@@ -657,7 +848,7 @@ function createKeyStore(overrideDir) {
     for (const key of Object.keys(data).sort()) {
       sorted[key] = data[key];
     }
-    writeFileSync(file, JSON.stringify(sorted, null, 2), "utf8");
+    writeFileSync2(file, JSON.stringify(sorted, null, 2), "utf8");
     try {
       chmodSync(file, 384);
     } catch {
@@ -770,43 +961,69 @@ async function tryClipboardCopy(text) {
 }
 
 // src/commands/deploy.ts
-var MAX_BYTES = 10 * 1024 * 1024;
+var MAX_INLINE_BYTES = 10 * 1024 * 1024;
 function registerDeploy(program) {
   program.command("deploy").description(
-    "Build a frontend project and publish the compiled app as one self-contained page."
-  ).argument("[dir]", "project directory (default: current directory)", ".").option("--build-cmd <cmd>", "Override the build command (default: detected from package.json)").option("--out <dir>", "Build output directory (default: auto-detect dist/ or build/)").option("--entry <file>", "Entry HTML within the output dir (default: index.html)").option("--install", "Run dependency install before building").option("--dry-run", "Build and inline, but report a summary instead of publishing").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(dir, opts) {
+    "Build a frontend project and deploy it \u2014 a single-page app as one inlined page, or a multi-file site (Next.js, etc.) at view.htmlship.com/{slug}/."
+  ).argument("[dir]", "project directory (default: current directory)", ".").option("--build-cmd <cmd>", "Override the build command (default: detected from package.json)").option("--out <dir>", "Build output directory (default: auto-detect dist/, build/, out/)").option("--entry <file>", "Entry HTML within the output dir (default: index.html)").option("--site", "Force multi-file site hosting (auto-detected for Next.js)").option("--single-file", "Force single-file inlining (one self-contained page)").option("--install", "Run dependency install before building").option("--dry-run", "Build, but report a summary instead of publishing").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(dir, opts) {
     const projectDir = resolve2(dir);
     const log = opts.quiet ? () => {
     } : (m) => process.stderr.write(`${m}
 `);
-    const { html, bytes } = buildAndInline(projectDir, {
-      buildCmd: opts.buildCmd,
-      out: opts.out,
-      entry: opts.entry,
-      install: opts.install,
-      log
-    });
-    if (bytes > MAX_BYTES) {
-      throw new HTMLShipError(
-        `inlined page is ${formatBytes(bytes)}, exceeds the ${formatBytes(MAX_BYTES)} limit`
-      );
-    }
-    if (opts.dryRun) {
-      log("dry-run:   built and inlined OK; not published");
-      return;
-    }
     const apiUrl = this.parent?.opts()?.apiUrl;
     const client = new HTMLShipClient({ baseUrl: apiUrl });
+    const expiresIn = opts.expiresIn ? Number.parseInt(opts.expiresIn, 10) : null;
+    const useSite = opts.singleFile ? false : opts.site || isNextProject(projectDir);
     let page;
-    try {
-      page = await client.publish(html, {
-        title: opts.title ?? null,
-        password: opts.password ?? null,
-        expiresIn: opts.expiresIn ? Number.parseInt(opts.expiresIn, 10) : null,
-        sandboxMode: "relaxed"
+    if (useSite) {
+      const { files, entry } = buildAndPackageSite(projectDir, {
+        buildCmd: opts.buildCmd,
+        out: opts.out,
+        entry: opts.entry,
+        install: opts.install,
+        log
       });
-    } catch (err) {
-      throw new HTMLShipError(`deploy failed: ${err.message}`);
+      if (opts.dryRun) {
+        log("dry-run:   built and packaged OK; not published");
+        return;
+      }
+      try {
+        page = await client.deploySite(files, {
+          entry,
+          title: opts.title ?? null,
+          password: opts.password ?? null,
+          expiresIn
+        });
+      } catch (err) {
+        throw new HTMLShipError(`deploy failed: ${err.message}`);
+      }
+    } else {
+      const { html, bytes } = buildAndInline(projectDir, {
+        buildCmd: opts.buildCmd,
+        out: opts.out,
+        entry: opts.entry,
+        install: opts.install,
+        log
+      });
+      if (bytes > MAX_INLINE_BYTES) {
+        throw new HTMLShipError(
+          `inlined page is ${formatBytes(bytes)}, exceeds the ${formatBytes(MAX_INLINE_BYTES)} limit \u2014 try --site for multi-file hosting`
+        );
+      }
+      if (opts.dryRun) {
+        log("dry-run:   built and inlined OK; not published");
+        return;
+      }
+      try {
+        page = await client.publish(html, {
+          title: opts.title ?? null,
+          password: opts.password ?? null,
+          expiresIn,
+          sandboxMode: "relaxed"
+        });
+      } catch (err) {
+        throw new HTMLShipError(`deploy failed: ${err.message}`);
+      }
     }
     const keys = createKeyStore();
     keys.remember(page.slug, {
@@ -825,7 +1042,10 @@ function registerDeploy(program) {
 `);
     process.stderr.write(`owner_key: ${page.owner_key}  (saved to ${keys.file})
 `);
-    process.stderr.write("sandbox:   relaxed (scripts run in an isolated origin)\n");
+    process.stderr.write(
+      `sandbox:   relaxed${useSite ? " \xB7 multi-file site" : ""} (scripts run in an isolated origin)
+`
+    );
     if (page.expires_at) {
       process.stderr.write(`expires:   ${page.expires_at}
 `);

package/package.json

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