@vantienkhai/shippage-cli 0.1.0

package/README.md

@@ -0,0 +1,16 @@
+# Shippage CLI
+
+Publish HTML, Markdown, and text files into Shippage from AI agents or scripts.
+
+```bash
+export SHIPPAGE_API_URL=http://localhost:3000
+export SHIPPAGE_TOKEN=<supabase-access-token>
+
+shippage publish ./out/article.html --title "AI Search Glossary" --visibility unlisted --noindex
+shippage bulk "out/**/*.html" --visibility unlisted --noindex
+shippage list
+shippage share abc123 --visibility private --private-token
+shippage domain add docs.example.com
+```
+
+For anonymous publishing, omit `SHIPPAGE_TOKEN`. Anonymous pages are ownerless until a later claim flow is added.

package/dist/index.js

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+
+// src/index.ts
+import "dotenv/config";
+import fs from "fs/promises";
+import path from "path";
+import { Command } from "commander";
+import chalk from "chalk";
+import { globby } from "globby";
+var program = new Command();
+function apiUrl() {
+  return (process.env.SHIPPAGE_API_URL || "http://localhost:3000").replace(/\/$/, "");
+}
+function apiToken() {
+  return process.env.SHIPPAGE_TOKEN;
+}
+async function requestJson(endpoint, init = {}) {
+  const headers = new Headers(init.headers);
+  if (apiToken()) headers.set("Authorization", `Bearer ${apiToken()}`);
+  const response = await fetch(`${apiUrl()}${endpoint}`, __spreadProps(__spreadValues({}, init), {
+    headers
+  }));
+  const text = await response.text();
+  const payload = text ? JSON.parse(text) : {};
+  if (!response.ok) {
+    throw new Error(payload.error || `Request failed with ${response.status}`);
+  }
+  return payload;
+}
+async function publishFile(filePath, options) {
+  const absolute = path.resolve(filePath);
+  const buffer = await fs.readFile(absolute);
+  const form = new FormData();
+  const extension = path.extname(filePath).toLowerCase();
+  const type = extension === ".md" || extension === ".mdx" ? "text/markdown" : extension === ".txt" ? "text/plain" : "text/html";
+  form.set("file", new Blob([buffer], { type }), path.basename(filePath));
+  if (options.title) form.set("title", options.title);
+  if (options.description) form.set("description", options.description);
+  if (options.slug) form.set("slug", options.slug);
+  if (options.domain) form.set("domain", options.domain);
+  if (options.visibility) form.set("visibility", options.visibility);
+  if (options.noindex) form.set("noindex", "true");
+  return requestJson("/api/upload", {
+    method: "POST",
+    body: form
+  });
+}
+program.name("shippage").description("CLI for Shippage fast HTML publishing").version("0.1.0");
+program.command("login").description("Print shell export instructions for API auth").option("--token <token>", "Supabase access token").option("--api-url <url>", "Shippage API URL").action((options) => {
+  if (options.apiUrl) console.log(`export SHIPPAGE_API_URL=${JSON.stringify(options.apiUrl)}`);
+  if (options.token) console.log(`export SHIPPAGE_TOKEN=${JSON.stringify(options.token)}`);
+  if (!options.apiUrl && !options.token) {
+    console.log("Set SHIPPAGE_API_URL and SHIPPAGE_TOKEN in your shell or .env file.");
+  }
+});
+program.command("publish").argument("<file>", "HTML, Markdown, or text file").option("--title <title>", "Page title").option("--description <description>", "Page meta description").option("--slug <slug>", "Custom path slug").option("--domain <domain>", "Verified custom domain").option("--visibility <visibility>", "public, unlisted, or private", "unlisted").option("--noindex", "Keep robots noindex").action(async (file, options) => {
+  const result = await publishFile(file, options);
+  console.log(chalk.green("Published"));
+  console.log(`${result.title}: ${result.shareUrl}`);
+  if (result.customUrl) {
+    console.log(`Custom URL: ${result.customUrl}`);
+  }
+});
+program.command("bulk").argument("<pattern>", "Glob pattern, for example out/**/*.html").option("--visibility <visibility>", "public, unlisted, or private", "unlisted").option("--noindex", "Keep robots noindex").action(async (pattern, options) => {
+  const files = await globby(pattern, { onlyFiles: true });
+  if (!files.length) {
+    console.log(chalk.yellow("No files matched."));
+    return;
+  }
+  for (const file of files) {
+    const result = await publishFile(file, __spreadProps(__spreadValues({}, options), {
+      title: path.basename(file, path.extname(file))
+    }));
+    console.log(`${chalk.green("Published")} ${file} -> ${result.shareUrl}`);
+  }
+});
+program.command("list").description("List pages owned by the current token").action(async () => {
+  const payload = await requestJson("/api/pages");
+  for (const page of payload.pages) {
+    console.log(`${page.share_id}	${page.visibility}	${page.noindex ? "noindex" : "index"}	${page.canonical_path}	${page.title}`);
+  }
+});
+program.command("share").argument("<shareId>", "Page share id").option("--visibility <visibility>", "public, unlisted, or private").option("--index", "Allow indexing").option("--noindex", "Keep robots noindex").option("--private-token", "Generate a private token").option("--domain <domain>", "Attach to a verified custom domain").option("--slug <slug>", "Custom path slug on the domain").action(async (shareId, options) => {
+  const payload = await requestJson(`/api/pages/${shareId}`, {
+    method: "PATCH",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({
+      visibility: options.visibility,
+      noindex: options.index ? false : options.noindex ? true : void 0,
+      privateToken: options.privateToken,
+      domain: options.domain,
+      slug: options.slug
+    })
+  });
+  console.log(JSON.stringify(payload.page, null, 2));
+});
+program.command("delete").argument("<shareId>", "Page share id").action(async (shareId) => {
+  await requestJson(`/api/pages/${shareId}`, { method: "DELETE" });
+  console.log(chalk.green(`Deleted ${shareId}`));
+});
+var domain = program.command("domain").description("Manage custom domains");
+domain.command("add").argument("<domain>", "Domain name").action(async (domainName) => {
+  const payload = await requestJson("/api/domains", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ domain: domainName })
+  });
+  console.log(chalk.green(`Added ${payload.domain.domain}`));
+  console.log(`TXT record: ${payload.dns.txt.value}`);
+  console.log(`CNAME target: ${payload.dns.cname.target}`);
+});
+domain.command("list").action(async () => {
+  const payload = await requestJson("/api/domains");
+  for (const item of payload.domains) {
+    console.log(`${item.domain}	${item.status}	${item.verification_token}`);
+  }
+});
+domain.command("verify").argument("<domain>", "Domain name").action(async (domainName) => {
+  const payload = await requestJson("/api/domains/verify", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ domain: domainName })
+  });
+  console.log(chalk.green(payload.message));
+  console.log(`Status: ${payload.domain.status}`);
+  if (!payload.routingReady) {
+    console.log(`Add CNAME to: ${payload.dns.cname.target}`);
+  }
+});
+domain.command("remove").argument("<domain>", "Domain name").action(async (domainName) => {
+  await requestJson("/api/domains", {
+    method: "DELETE",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ domain: domainName })
+  });
+  console.log(chalk.green(`Removed ${domainName}`));
+});
+program.parseAsync().catch((error) => {
+  console.error(chalk.red(error instanceof Error ? error.message : "Command failed"));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@vantienkhai/shippage-cli",
+  "version": "0.1.0",
+  "description": "Publish HTML, Markdown, and text files to Shippage from AI agents or scripts.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "shippage": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "shippage",
+    "cli",
+    "publishing",
+    "html",
+    "ai",
+    "static"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^15.0.0",
+    "dotenv": "^17.4.2",
+    "globby": "^16.2.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "tsx": "^4.22.4",
+    "typescript": "^5.9.3"
+  }
+}