@p11-core/cli 0.0.5 → 0.0.7

package/dist/index.js

@@ -3628,9 +3628,13 @@ async function main() {
   if (!isKnownTopLevelCommand(program2, command)) throw new Error(`Unknown command: ${command}`);
   await program2.parseAsync(process.argv);
 }
-function createCliProgram() {
+function createCliProgram(options = {}) {
   const program2 = new Command();
+  const warnBeforeAction = options.warnIfUpdateAvailable ?? warnIfUpdateAvailable;
   program2.name("p11").description("Share and inspect p11 document pages.");
+  program2.hook("preAction", async () => {
+    await warnBeforeAction();
+  });
   program2.addHelpText(
     "after",
     `
@@ -3638,25 +3642,27 @@ function createCliProgram() {
 Environment:
   P11_API_URL  Defaults to ${builtDefaultApiUrl}`
   );
-  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, options) => {
-    await warnIfUpdateAvailable();
-    await publish(input, normalizePublishOptions(options));
+  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) => {
+    await publish(input, normalizePublishOptions(options2));
   });
   allowLegacyParserBehavior(shareCommand);
-  const commentsCommand = program2.command("comments").description("Fetch exported comments for a read/edit URL or id.").argument("[readUrl|editUrl|readId|editId]").option("--json", "Print comments as JSON.").option("--output [file]", "Write comments JSON to a file.").option("--version [n]", "Fetch comments for a specific page version.").option("--api-url [url]", "Override the p11 API URL.").action(async (target, options) => {
-    await warnIfUpdateAvailable();
-    await comments(target, normalizeCommentsOptions(options));
+  const commentsCommand = program2.command("comments").description("Fetch exported comments for a read/edit URL or id.").argument("[readUrl|editUrl|readId|editId]").option("--json", "Print comments as JSON.").option("--output [file]", "Write comments JSON to a file.").option("--version [n]", "Fetch comments for a specific page version.").option("--api-url [url]", "Override the p11 API URL.").action(async (target, options2) => {
+    await comments(target, normalizeCommentsOptions(options2));
   });
   allowLegacyParserBehavior(commentsCommand);
-  program2.command("history").description("List saved read/edit links.").option("--json", "Print saved history as JSON.").action(async (options) => {
-    await history(normalizeHistoryOptions(options));
+  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));
   });
   const docsCommand = program2.command("docs").description("Print p11 authoring docs.").argument("[topic]", "Docs topic: components or sharing.").action(async (topic) => {
     await docs(topic);
   });
   allowLegacyParserBehavior(docsCommand);
-  const exampleCommand = program2.command("example").description("Print or write a p11 example document.").argument("[name]", "Example name: all-components.").option("--output [file]", "Write the example to a file.").action(async (name, options) => {
-    await example(name, normalizeExampleOptions(options));
+  const exampleCommand = program2.command("example").description("Print or write a p11 example document.").argument("[name]", "Example name: all-components.").option("--output [file]", "Write the example to a file.").action(async (name, options2) => {
+    await example(name, normalizeExampleOptions(options2));
   });
   allowLegacyParserBehavior(exampleCommand);
   return program2;
@@ -3682,6 +3688,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
@@ -3813,6 +3825,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;
@@ -4320,6 +4356,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}.`);
@@ -4432,6 +4473,8 @@ export {
   buildPageModule,
   commentsApiUrlForTarget,
   commentsExportJson,
+  createCliProgram,
+  deleteApiUrlForTarget,
   isNewerVersion,
   parseCommentsTarget,
   parseEditId,

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,14 @@ 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.
 
-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.5",
+  "version": "0.0.7",
   "license": "UNLICENSED",
   "type": "module",
   "bin": {