deepline 0.3.460 → 0.3.462

package/dist/cli/pages-DXDYYKEK.mjs

@@ -0,0 +1,252 @@
+import {
+  DeeplineClient
+} from "./chunk-7MJ6VI2T.mjs";
+import "./chunk-UDRPEZ5F.mjs";
+import "./chunk-L2VKAASU.mjs";
+import "./chunk-FAG4DFUC.mjs";
+import "./chunk-S3A4IXBQ.mjs";
+import "./chunk-UBKA33KY.mjs";
+import {
+  printCommandEnvelope
+} from "./chunk-NHRWZPWZ.mjs";
+import {
+  cliFeatureEnabled
+} from "./chunk-D6DXOUTO.mjs";
+import "./chunk-6RNQGWFD.mjs";
+import "./chunk-4QF2K7TM.mjs";
+import "./chunk-DLIRSHV6.mjs";
+import "./chunk-HBL4PM5Q.mjs";
+import "./chunk-XZAFIOUQ.mjs";
+import "./chunk-WZYKRD7T.mjs";
+import "./chunk-KRD6H754.mjs";
+
+// src/cli/commands/pages.ts
+import { readFile } from "fs/promises";
+import { extname } from "path";
+var CONTENT_TYPES = {
+  ".html": "text/html; charset=utf-8",
+  ".htm": "text/html; charset=utf-8",
+  ".json": "application/json",
+  ".txt": "text/plain; charset=utf-8",
+  ".csv": "text/csv; charset=utf-8",
+  ".md": "text/markdown; charset=utf-8",
+  ".svg": "image/svg+xml",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".pdf": "application/pdf"
+};
+var EXPIRY_UNITS = {
+  m: 60,
+  h: 3600,
+  d: 86400
+};
+function parseExpiresIn(value) {
+  const match = /^(\d+)([mhd])$/.exec(value.trim());
+  const seconds = match ? Number(match[1]) * EXPIRY_UNITS[match[2]] : 0;
+  if (!Number.isSafeInteger(seconds) || seconds <= 0) {
+    throw new Error(`--expires-in takes a value like 30m, 12h, or 7d.`);
+  }
+  return seconds;
+}
+function inferPageContentType(file) {
+  return CONTENT_TYPES[extname(file).toLowerCase()] ?? "application/octet-stream";
+}
+function audience(page) {
+  return page.public ? "public" : "workspace members";
+}
+function pageLines(page) {
+  return [
+    `${page.name}${page.state === "deleting" ? " (deleting)" : ""}`,
+    `  ${page.url}`,
+    `  visible to: ${audience(page)}`,
+    ...page.description ? [`  ${page.description}`] : [],
+    `  ${page.has_document ? `${page.content_type}, ${page.size_bytes} bytes, revision ${page.revision}` : "no content yet"}`,
+    `  created ${new Date(page.created_at).toISOString()}, updated ${new Date(page.updated_at).toISOString()}`
+  ];
+}
+function linkLine(link) {
+  const expiry = link.expires_at === null ? "never expires" : `expires ${new Date(link.expires_at).toISOString()}`;
+  return `${link.id}  ${expiry}${link.label ? `  ${link.label}` : ""}`;
+}
+function print(command, json, data, lines) {
+  printCommandEnvelope(
+    { command, ...data, render: { sections: [{ title: command, lines }] } },
+    { json: Boolean(json), text: `${lines.join("\n")}
+` }
+  );
+}
+async function run(action) {
+  try {
+    await action();
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+  }
+}
+var HOSTED_PAGES_FEATURE = "hosted-pages";
+function registerPagesCommands(program) {
+  const pages = program.command("pages", { hidden: !cliFeatureEnabled(HOSTED_PAGES_FEATURE) }).description(
+    "Publish documents at stable URLs on deepline.page and share them."
+  ).addHelpText(
+    "after",
+    `
+Examples:
+  deepline pages write report --file report.html --private
+  deepline pages list
+  deepline pages links create report --expires-in 7d
+  deepline pages set-public report
+  deepline pages delete report
+`
+  );
+  pages.command("write <name>").description("Create a page, or replace all of its content.").requiredOption("--file <path>", "File holding the page content").option("--public", "Anyone with the URL can see this page").option("--private", "Only workspace members can see this page").option("--content-type <type>", "Overrides the type from the extension").option("--description <text>", "What the page is").option("--json", "Emit raw JSON response").addHelpText(
+    "after",
+    `
+Examples:
+  deepline pages write report --file report.html --private
+  deepline pages write status --file status.json --public --description "Daily status"
+`
+  ).action(
+    async (name, options) => run(async () => {
+      if (Boolean(options.public) === Boolean(options.private)) {
+        throw new Error("Pass exactly one of --public or --private.");
+      }
+      const content = await readFile(options.file);
+      const result = await new DeeplineClient().writePage(name, {
+        public: Boolean(options.public),
+        contentBase64: content.toString("base64"),
+        contentType: options.contentType ?? inferPageContentType(options.file),
+        description: options.description
+      });
+      print("pages write", options.json, result, [
+        `${result.created ? "Created" : "Replaced"} ${result.name} (revision ${result.revision})`,
+        result.url,
+        `visible to: ${audience(result)}`,
+        ...result.warnings.map((warning) => `warning: ${warning}`)
+      ]);
+    })
+  );
+  pages.command("list").description("List this workspace's pages.").option("--cursor <cursor>", "Continue from a previous page of results").option("--limit <n>", "Results per request, up to 100", Number).option("--json", "Emit raw JSON response").addHelpText(
+    "after",
+    `
+Examples:
+  deepline pages list
+  deepline pages list --json
+`
+  ).action(
+    async (options) => run(async () => {
+      const result = await new DeeplineClient().listPages({
+        cursor: options.cursor,
+        limit: options.limit
+      });
+      print("pages list", options.json, result, [
+        `Plan allows ${result.page_limit >= 1e3 ? "unlimited" : result.page_limit} pages. Public pages: ${result.public_allowed ? "enabled" : "not enabled; use --private and pages links create"}.`,
+        ...result.pages.length === 0 ? ["No pages yet."] : [],
+        ...result.pages.flatMap(pageLines),
+        ...result.next_cursor ? [`More: --cursor ${result.next_cursor}`] : []
+      ]);
+    })
+  );
+  pages.command("get <name>").description("Show one page's details.").option("--json", "Emit raw JSON response").action(
+    async (name, options) => run(async () => {
+      const page = await new DeeplineClient().getPage(name);
+      print("pages get", options.json, page, pageLines(page));
+    })
+  );
+  pages.command("set-public <name>").description("Make a page visible to anyone with its URL.").option("--json", "Emit raw JSON response").addHelpText(
+    "after",
+    `
+Notes:
+  This is the only way a private page becomes public. Effects are immediate.
+  Needs public pages enabled for the workspace; "deepline pages list" says
+  whether they are. A later write with public: false makes it private again.
+`
+  ).action(
+    async (name, options) => run(async () => {
+      const page = await new DeeplineClient().setPageVisibility(name, true);
+      print("pages set-public", options.json, page, [
+        `${page.name} is now visible to anyone with its URL.`,
+        page.url
+      ]);
+    })
+  );
+  pages.command("set-private <name>").description("Limit a page to workspace members.").option("--json", "Emit raw JSON response").addHelpText(
+    "after",
+    `
+Notes:
+  Effects are immediate. Existing links keep working until revoked.
+`
+  ).action(
+    async (name, options) => run(async () => {
+      const page = await new DeeplineClient().setPageVisibility(name, false);
+      print("pages set-private", options.json, page, [
+        `${page.name} is now visible to workspace members only.`
+      ]);
+    })
+  );
+  pages.command("delete <name>").description("Delete a page, its content, and its links.").option("--json", "Emit raw JSON response").addHelpText(
+    "after",
+    `
+Notes:
+  The page stops being served at once. This cannot be undone. If storage
+  removal fails, the command fails, the page stays listed as deleting, and
+  running the command again finishes the job.
+`
+  ).action(
+    async (name, options) => run(async () => {
+      const result = await new DeeplineClient().deletePage(name);
+      print("pages delete", options.json, result, [`Deleted ${name}.`]);
+    })
+  );
+  const links = pages.command("links").description("Manage URLs that open a page without login.");
+  links.command("create <name>").description("Create a URL that opens a page without login.").option("--expires-in <duration>", "How long it works: 30m, 12h, 7d").option("--permanent", "The URL works until it is revoked").option("--label <text>", "What this link is for").option("--json", "Emit raw JSON response").addHelpText(
+    "after",
+    `
+Examples:
+  deepline pages links create report --expires-in 7d
+  deepline pages links create report --permanent --label "Board deck"
+`
+  ).action(
+    async (name, options) => run(async () => {
+      if (Boolean(options.expiresIn) === Boolean(options.permanent)) {
+        throw new Error("Pass exactly one of --expires-in or --permanent.");
+      }
+      const link = await new DeeplineClient().createPageLink(name, {
+        expiresInSeconds: options.expiresIn ? parseExpiresIn(options.expiresIn) : void 0,
+        permanent: options.permanent ? true : void 0,
+        label: options.label
+      });
+      print("pages links create", options.json, link, [
+        link.url,
+        linkLine(link),
+        "This URL is shown once."
+      ]);
+    })
+  );
+  links.command("list <name>").description("List a page's links. Their URLs cannot be shown again.").option("--json", "Emit raw JSON response").action(
+    async (name, options) => run(async () => {
+      const result = await new DeeplineClient().listPageLinks(name);
+      print(
+        "pages links list",
+        options.json,
+        result,
+        result.links.length === 0 ? ["No links."] : result.links.map(linkLine)
+      );
+    })
+  );
+  links.command("revoke <name> <link-id>").description("Stop a link working.").option("--json", "Emit raw JSON response").action(
+    async (name, linkId, options) => run(async () => {
+      const result = await new DeeplineClient().revokePageLink(name, linkId);
+      print("pages links revoke", options.json, result, [
+        `Revoked ${linkId}.`
+      ]);
+    })
+  );
+}
+export {
+  inferPageContentType,
+  parseExpiresIn,
+  registerPagesCommands
+};