@p11-core/cli 0.0.6 → 0.0.8

package/dist/index.js

@@ -3469,7 +3469,7 @@ var require_commander = __commonJS({
 import { realpathSync } from "fs";
 import { chmod, mkdir, mkdtemp, readFile, readdir, rename, rm, stat, writeFile } from "fs/promises";
 import { createRequire } from "module";
-import { homedir } from "os";
+import { homedir, tmpdir } from "os";
 import path from "path";
 import { fileURLToPath } from "url";
 import process from "process";
@@ -3640,9 +3640,10 @@ function createCliProgram(options = {}) {
     `
 
 Environment:
-  P11_API_URL  Defaults to ${builtDefaultApiUrl}`
+  P11_API_URL    Defaults to ${builtDefaultApiUrl}
+  P11_BUILD_DIR  Directory for temporary share build files. Defaults to the OS temp directory.`
   );
-  const shareCommand = program2.command("share").description("Share a review link for a page.").argument("[page.tsx]").option("--json", "Print the API response as JSON.").option("--edit-url [url]", "Share a new version using an edit URL or edit id.").option("--api-url [url]", "Override the p11 API URL.").action(async (input, options2) => {
+  const shareCommand = program2.command("share").description("Share a review link for a page.").argument("[page.tsx]").option("--json", "Print the API response as JSON.").option("--edit-url [url]", "Share a new version using an edit URL or edit id.").option("--api-url [url]", "Override the p11 API URL.").option("--build-dir [dir]", "Directory for temporary build files.").action(async (input, options2) => {
     await publish(input, normalizePublishOptions(options2));
   });
   allowLegacyParserBehavior(shareCommand);
@@ -3650,6 +3651,10 @@ Environment:
     await comments(target, normalizeCommentsOptions(options2));
   });
   allowLegacyParserBehavior(commentsCommand);
+  const deleteCommand = program2.command("delete").description("Delete a document and all of its versions and comments.").argument("[editUrl|editId]").option("--json", "Print the API response as JSON.").option("--api-url [url]", "Override the p11 API URL.").action(async (target, options2) => {
+    await deleteDocument(target, normalizeDeleteOptions(options2));
+  });
+  allowLegacyParserBehavior(deleteCommand);
   program2.command("history").description("List saved read/edit links.").option("--json", "Print saved history as JSON.").action(async (options2) => {
     await history(normalizeHistoryOptions(options2));
   });
@@ -3673,7 +3678,8 @@ function normalizePublishOptions(options) {
   return {
     json: options.json,
     editUrl: optionString(options.editUrl, "--edit-url requires a URL or edit id."),
-    apiUrl: optionString(options.apiUrl, "--api-url requires a URL.")
+    apiUrl: optionString(options.apiUrl, "--api-url requires a URL."),
+    buildDir: optionString(options.buildDir, "--build-dir requires a directory path.")
   };
 }
 function normalizeCommentsOptions(options) {
@@ -3684,6 +3690,12 @@ function normalizeCommentsOptions(options) {
     apiUrl: optionString(options.apiUrl, "--api-url requires a URL.")
   };
 }
+function normalizeDeleteOptions(options) {
+  return {
+    json: options.json,
+    apiUrl: optionString(options.apiUrl, "--api-url requires a URL.")
+  };
+}
 function normalizeHistoryOptions(options) {
   return {
     json: options.json
@@ -3709,10 +3721,12 @@ async function publish(input, options) {
   if (!/\.[cm]?[tj]sx?$/.test(resolvedInput)) {
     throw new Error("File input must be a .tsx, .jsx, .ts, or .js page file.");
   }
-  const cleanupDir = await mkdtemp(path.join(process.cwd(), ".p11-build-"));
+  const buildParentDir = resolveBuildParentDir(options.buildDir);
+  await mkdir(buildParentDir, { recursive: true });
+  const cleanupDir = await mkdtemp(path.join(buildParentDir, "p11-build-"));
   const distDir = path.join(cleanupDir, "dist");
-  await buildPageModule(resolvedInput, distDir);
   try {
+    await buildPageModule(resolvedInput, distDir);
     await ensureIndexHtml(distDir);
     const zipBytes = await zipDirectory(distDir);
     const editUrl = options.editUrl ?? "";
@@ -3815,6 +3829,30 @@ async function comments(target, options) {
     printComments(data);
   }
 }
+async function deleteDocument(target, options) {
+  if (!target) {
+    throw new Error("Usage: p11 delete <editUrl|editId> [--json] [--api-url URL]");
+  }
+  const url = deleteApiUrlForTarget(target, {
+    apiUrl: options.apiUrl
+  });
+  const response = await fetch(url, {
+    method: "DELETE"
+  });
+  const text = await response.text();
+  if (!response.ok) {
+    throw new Error(`Delete failed (${response.status}): ${responseErrorMessage(text)}`);
+  }
+  const data = JSON.parse(text);
+  if (options.json) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  console.log(`Deleted ${data.docId ?? "document"}`);
+  if (data.readId) console.log(`readId: ${data.readId}`);
+  if (data.editId) console.log(`editId: ${data.editId}`);
+  if (data.deletedAt) console.log(`deletedAt: ${data.deletedAt}`);
+}
 async function appendPublishHistory(data, metadata = {}, filePath = historyFilePath()) {
   const entry = publishHistoryEntry(data, metadata);
   if (!entry.readUrl && !entry.editUrl) return;
@@ -4073,34 +4111,48 @@ async function buildPageModule(inputFile, outDir) {
       "</html>"
     ].join("\n")
   );
-  await build({
-    root: tempDir,
-    base: "./",
-    configFile: false,
-    logLevel: "warn",
-    plugins: [react(), tailwindcss()],
-    resolve: {
-      alias: {
-        "@p11-core/components/styles.css": componentStyles,
-        "@p11-core/components": componentEntry,
-        "@recogito/text-annotator/text-annotator.css": textAnnotatorStyles,
-        "@recogito/text-annotator": textAnnotatorEntry,
-        "react/jsx-runtime": nodeRequire.resolve("react/jsx-runtime"),
-        "react/jsx-dev-runtime": nodeRequire.resolve("react/jsx-dev-runtime"),
-        "react-dom/client": nodeRequire.resolve("react-dom/client"),
-        "react-dom": nodeRequire.resolve("react-dom"),
-        react: nodeRequire.resolve("react")
+  const previousCwd = process.cwd();
+  try {
+    process.chdir(tempDir);
+    await build({
+      root: ".",
+      base: "./",
+      configFile: false,
+      logLevel: "warn",
+      plugins: [react(), tailwindcss()],
+      resolve: {
+        alias: {
+          "@p11-core/components/styles.css": componentStyles,
+          "@p11-core/components": componentEntry,
+          "@recogito/text-annotator/text-annotator.css": textAnnotatorStyles,
+          "@recogito/text-annotator": textAnnotatorEntry,
+          "react/jsx-runtime": nodeRequire.resolve("react/jsx-runtime"),
+          "react/jsx-dev-runtime": nodeRequire.resolve("react/jsx-dev-runtime"),
+          "react-dom/client": nodeRequire.resolve("react-dom/client"),
+          "react-dom": nodeRequire.resolve("react-dom"),
+          react: nodeRequire.resolve("react")
+        },
+        dedupe: ["react", "react-dom"]
       },
-      dedupe: ["react", "react-dom"]
-    },
-    build: {
-      outDir: path.relative(tempDir, outDir),
-      emptyOutDir: true,
-      assetsDir: "assets"
-    }
-  });
+      build: {
+        outDir: path.relative(tempDir, outDir),
+        emptyOutDir: true,
+        assetsDir: "assets",
+        rollupOptions: {
+          input: {
+            index: "index.html"
+          }
+        }
+      }
+    });
+  } finally {
+    process.chdir(previousCwd);
+  }
   await writeFile(path.join(outDir, P11_MANIFEST_FILE), JSON.stringify({ runtimeVersion: P11_RUNTIME_VERSION }, null, 2));
 }
+function resolveBuildParentDir(buildDir) {
+  return path.resolve(buildDir || process.env.P11_BUILD_DIR || tmpdir());
+}
 function validatePageSource(code, inputFile = "page.tsx") {
   validatePageAst(parsePageSource(code), inputFile);
 }
@@ -4322,6 +4374,11 @@ function commentsApiUrlForTarget(value, options = {}) {
   if (version !== void 0) url.searchParams.set("v", String(version));
   return url;
 }
+function deleteApiUrlForTarget(value, options = {}) {
+  const target = parseEditTarget(value);
+  const apiUrl = normalizeApiUrl(String(options.apiUrl ?? target.apiUrl ?? defaultApiUrl));
+  return new URL(`/api/edit/${encodeURIComponent(target.editId)}`, apiUrl);
+}
 function parseAccessTarget(value, allowedKinds, expected, options = {}) {
   const trimmed = value.trim();
   if (!trimmed) throw new Error(`Missing ${expected}.`);
@@ -4435,10 +4492,12 @@ export {
   commentsApiUrlForTarget,
   commentsExportJson,
   createCliProgram,
+  deleteApiUrlForTarget,
   isNewerVersion,
   parseCommentsTarget,
   parseEditId,
   parseReadId,
   readHistoryEntries,
+  resolveBuildParentDir,
   validatePageSource
 };

package/docs/index.md

@@ -9,6 +9,7 @@ p11 share <page.tsx>
 p11 share <page.tsx> --edit-url <editUrl>
 p11 history
 p11 comments <readUrl|editUrl|readId|editId>
+p11 delete <editUrl|editId>
 ```
 
 Add `--json` when scripting or when exact structured fields are needed.
@@ -28,4 +29,4 @@ p11 example all-components
 p11 example all-components --output ./all-components.tsx
 ```
 
-Use `p11 share --help`, `p11 comments --help`, and `p11 history --help` for command-specific flags.
+Use `p11 share --help`, `p11 comments --help`, `p11 delete --help`, and `p11 history --help` for command-specific flags.

package/docs/sharing.md

@@ -26,8 +26,15 @@ p11 comments <readUrl|editUrl|readId|editId> --version 1
 p11 comments <readUrl|editUrl|readId|editId> --output comments.json
 ```
 
+Delete a shared document and all of its versions, comments, and replies:
+
+```bash
+p11 delete <editUrl|editId>
+```
+
 Add `--json` when scripting or when exact structured fields are needed.
 
 `P11_API_URL` overrides the default API URL. `--api-url <url>` can override it per command.
+Temporary share builds are created under the OS temp directory by default. Use `P11_BUILD_DIR` or `--build-dir <dir>` only when you need to inspect or redirect the transient build workspace.
 
-Edit URLs are bearer credentials for updating a document. Keep them private.
+Edit URLs are bearer credentials for updating or deleting a document. Keep them private.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@p11-core/cli",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "license": "UNLICENSED",
   "type": "module",
   "bin": {