@vantienkhai/shippage-cli 0.1.0 → 0.2.0

package/README.md

@@ -2,15 +2,41 @@
 
 Publish HTML, Markdown, and text files into Shippage from AI agents or scripts.
 
+## Install
+
+```bash
+npm i -g @vantienkhai/shippage-cli
+```
+
+## Authenticate
+
+Run browser login once:
+
+```bash
+shippage login
+```
+
+The CLI opens Shippage in your browser, asks you to confirm a short code, then
+saves a long-lived API key to `~/.config/shippage/config.json`. Environment
+variables still override the saved config:
+
 ```bash
-export SHIPPAGE_API_URL=http://localhost:3000
-export SHIPPAGE_TOKEN=<supabase-access-token>
+export SHIPPAGE_API_URL="https://shippage.vantienkhai-uet.workers.dev"
+export SHIPPAGE_TOKEN="<your spg_ API key>"
+```
 
-shippage publish ./out/article.html --title "AI Search Glossary" --visibility unlisted --noindex
-shippage bulk "out/**/*.html" --visibility unlisted --noindex
+## Commands
+
+```bash
+shippage login
+shippage publish ./out/article.html --title "AI Search Glossary" --slug ai-search-glossary --visibility public
+shippage bulk "out/**/*.html" --visibility unlisted
 shippage list
 shippage share abc123 --visibility private --private-token
 shippage domain add docs.example.com
+shippage domain verify docs.example.com
 ```
 
 For anonymous publishing, omit `SHIPPAGE_TOKEN`. Anonymous pages are ownerless until a later claim flow is added.
+
+Visibility controls search behavior automatically: `public` pages are indexable; `unlisted` and `private` pages are `noindex`.

package/dist/index.js

@@ -21,17 +21,58 @@ var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 
 // src/index.ts
 import "dotenv/config";
-import fs from "fs/promises";
-import path from "path";
+import { spawn } from "child_process";
+import fs2 from "fs/promises";
+import path2 from "path";
 import { Command } from "commander";
 import chalk from "chalk";
 import { globby } from "globby";
+
+// src/config.ts
+import fs from "fs/promises";
+import os from "os";
+import path from "path";
+function parseCliConfig(value) {
+  try {
+    const parsed = JSON.parse(value);
+    return __spreadValues(__spreadValues({}, typeof parsed.apiUrl === "string" ? { apiUrl: parsed.apiUrl } : {}), typeof parsed.token === "string" ? { token: parsed.token } : {});
+  } catch (e) {
+    return {};
+  }
+}
+function mergeCliConfig(current, update) {
+  return __spreadValues(__spreadValues({}, current), update);
+}
+function cliConfigPath() {
+  const root = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
+  return path.join(root, "shippage", "config.json");
+}
+async function readCliConfig() {
+  try {
+    return parseCliConfig(await fs.readFile(cliConfigPath(), "utf8"));
+  } catch (e) {
+    return {};
+  }
+}
+async function writeCliConfig(update) {
+  const configPath = cliConfigPath();
+  await fs.mkdir(path.dirname(configPath), { recursive: true, mode: 448 });
+  const config = mergeCliConfig(await readCliConfig(), update);
+  await fs.writeFile(configPath, `${JSON.stringify(config, null, 2)}
+`, { mode: 384 });
+  await fs.chmod(configPath, 384);
+  return configPath;
+}
+
+// src/index.ts
 var program = new Command();
+var DEFAULT_API_URL = "https://shippage.vantienkhai-uet.workers.dev";
+var storedConfig = {};
 function apiUrl() {
-  return (process.env.SHIPPAGE_API_URL || "http://localhost:3000").replace(/\/$/, "");
+  return (process.env.SHIPPAGE_API_URL || storedConfig.apiUrl || DEFAULT_API_URL).replace(/\/$/, "");
 }
 function apiToken() {
-  return process.env.SHIPPAGE_TOKEN;
+  return process.env.SHIPPAGE_TOKEN || storedConfig.token;
 }
 async function requestJson(endpoint, init = {}) {
   const headers = new Headers(init.headers);
@@ -47,32 +88,64 @@ async function requestJson(endpoint, init = {}) {
   return payload;
 }
 async function publishFile(filePath, options) {
-  const absolute = path.resolve(filePath);
-  const buffer = await fs.readFile(absolute);
+  const absolute = path2.resolve(filePath);
+  const buffer = await fs2.readFile(absolute);
   const form = new FormData();
-  const extension = path.extname(filePath).toLowerCase();
+  const extension = path2.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));
+  form.set("file", new Blob([buffer], { type }), path2.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.name("shippage").description("CLI for Shippage fast HTML publishing").version("0.2.0");
+program.command("login").description("Open a browser and save a long-lived Shippage login").option("--token <token>", "Shippage API key").option("--api-url <url>", "Shippage API URL").option("--no-open", "Do not open the browser automatically").action(async (options) => {
+  const loginApiUrl = (options.apiUrl || apiUrl()).replace(/\/$/, "");
+  if (options.token) {
+    const configPath = await writeCliConfig({ apiUrl: loginApiUrl, token: options.token });
+    console.log(chalk.green(`Saved Shippage credentials to ${configPath}`));
+    return;
+  }
+  const response = await fetch(`${loginApiUrl}/api/cli-auth/device`, { method: "POST" });
+  const request = await response.json();
+  if (!response.ok || !request.deviceCode || !request.userCode || !request.verificationUrl || !request.expiresAt) {
+    throw new Error(request.error || "Unable to start browser login.");
+  }
+  console.log(`Open: ${request.verificationUrl}`);
+  console.log(`Confirm code: ${chalk.bold(request.userCode)}`);
+  if (options.open) {
+    try {
+      await openBrowser(request.verificationUrl);
+      console.log(chalk.dim("Opened your browser. Waiting for authorization..."));
+    } catch (e) {
+      console.log(chalk.yellow("Could not open a browser automatically. Open the URL above."));
+    }
+  } else {
+    console.log(chalk.dim("Waiting for authorization..."));
+  }
+  const interval = Math.max(1, request.interval || 2) * 1e3;
+  const expiresAt = new Date(request.expiresAt).getTime();
+  while (Date.now() < expiresAt) {
+    await sleep(interval);
+    const pollResponse = await fetch(`${loginApiUrl}/api/cli-auth/device?device_code=${encodeURIComponent(request.deviceCode)}`);
+    const poll = await pollResponse.json();
+    if (pollResponse.status === 202 || poll.status === "pending") continue;
+    if (!pollResponse.ok || !poll.token) {
+      throw new Error(poll.error || "Browser login failed.");
+    }
+    const configPath = await writeCliConfig({ apiUrl: poll.apiUrl || loginApiUrl, token: poll.token });
+    console.log(chalk.green(`Logged in. Credentials saved to ${configPath}`));
+    return;
   }
+  throw new Error("Browser login expired. Run shippage login again.");
 });
-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) => {
+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").action(async (file, options) => {
   const result = await publishFile(file, options);
   console.log(chalk.green("Published"));
   console.log(`${result.title}: ${result.shareUrl}`);
@@ -80,7 +153,7 @@ program.command("publish").argument("<file>", "HTML, Markdown, or text file").op
     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) => {
+program.command("bulk").argument("<pattern>", "Glob pattern, for example out/**/*.html").option("--visibility <visibility>", "public, unlisted, or private", "unlisted").action(async (pattern, options) => {
   const files = await globby(pattern, { onlyFiles: true });
   if (!files.length) {
     console.log(chalk.yellow("No files matched."));
@@ -88,7 +161,7 @@ program.command("bulk").argument("<pattern>", "Glob pattern, for example out/**/
   }
   for (const file of files) {
     const result = await publishFile(file, __spreadProps(__spreadValues({}, options), {
-      title: path.basename(file, path.extname(file))
+      title: path2.basename(file, path2.extname(file))
     }));
     console.log(`${chalk.green("Published")} ${file} -> ${result.shareUrl}`);
   }
@@ -99,13 +172,12 @@ program.command("list").description("List pages owned by the current token").act
     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) => {
+program.command("share").argument("<shareId>", "Page share id").option("--visibility <visibility>", "public, unlisted, or private").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
@@ -154,7 +226,28 @@ domain.command("remove").argument("<domain>", "Domain name").action(async (domai
   });
   console.log(chalk.green(`Removed ${domainName}`));
 });
-program.parseAsync().catch((error) => {
-  console.error(chalk.red(error instanceof Error ? error.message : "Command failed"));
-  process.exit(1);
-});
+void bootstrap();
+async function bootstrap() {
+  try {
+    storedConfig = await readCliConfig();
+    await program.parseAsync();
+  } catch (error) {
+    console.error(chalk.red(error instanceof Error ? error.message : "Command failed"));
+    process.exit(1);
+  }
+}
+function sleep(milliseconds) {
+  return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+function openBrowser(url) {
+  const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
+  const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, { detached: true, stdio: "ignore" });
+    child.once("error", reject);
+    child.once("spawn", () => {
+      child.unref();
+      resolve();
+    });
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vantienkhai/shippage-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Publish HTML, Markdown, and text files to Shippage from AI agents or scripts.",
   "license": "MIT",
   "type": "module",