docz-cli 0.5.0 → 0.6.0

package/dist/{chunk-EBJ32KUL.js → chunk-XUT76ACQ.js}

@@ -1,6 +1,15 @@
 #!/usr/bin/env node
 
 // src/client.ts
+var ConflictError = class extends Error {
+  constructor(detail) {
+    super(
+      "Conflict: file has been modified by others. Please re-read the latest content and re-apply your changes."
+    );
+    this.detail = detail;
+    this.name = "ConflictError";
+  }
+};
 var DocSyncClient = class {
   constructor(baseUrl, token) {
     this.baseUrl = baseUrl;
@@ -48,12 +57,28 @@ var DocSyncClient = class {
       `/api/spaces/${spaceId}/tree?path=${encodeURIComponent(path)}`
     );
   }
+  async treeFull(spaceId) {
+    return this.request(`/api/spaces/${spaceId}/tree/full`);
+  }
   // --- Blob ---
   async cat(spaceId, filepath) {
     return this.request(
       `/api/spaces/${spaceId}/blob/${encodeURIComponent(filepath)}`
     );
   }
+  async catWithRef(spaceId, filepath) {
+    const res = await fetch(
+      `${this.baseUrl}/api/spaces/${spaceId}/blob/${encodeURIComponent(filepath)}`,
+      { headers: { Authorization: `Bearer ${this.token}` } }
+    );
+    if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      throw new Error(`${res.status} ${res.statusText}: ${body}`.trim());
+    }
+    const content = await res.text();
+    const ref = res.headers.get("X-Git-Ref") ?? "";
+    return { content, ref };
+  }
   // --- Write ---
   async upload(spaceId, dir, filename, content) {
     const blob = typeof content === "string" ? new Blob([content], { type: "application/octet-stream" }) : new Blob([content], { type: "application/octet-stream" });
@@ -65,6 +90,31 @@ var DocSyncClient = class {
       body: form
     });
   }
+  async save(spaceId, path, content, opts) {
+    const body = { path, content };
+    if (opts?.baseRef) body.base_ref = opts.baseRef;
+    if (opts?.message) body.message = opts.message;
+    const res = await fetch(
+      `${this.baseUrl}/api/spaces/${spaceId}/files/save`,
+      {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.token}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(body)
+      }
+    );
+    if (res.status === 409) {
+      const data = await res.json();
+      throw new ConflictError(data);
+    }
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`${res.status} ${res.statusText}: ${text}`.trim());
+    }
+    return res.json();
+  }
   async mkdir(spaceId, path) {
     await this.request(`/api/spaces/${spaceId}/files/mkdir`, {
       method: "POST",
@@ -86,6 +136,13 @@ var DocSyncClient = class {
       body: JSON.stringify({ old_path: from, new_path: to })
     });
   }
+  async rollback(spaceId, filePath, commitHash) {
+    await this.request(`/api/spaces/${spaceId}/files/rollback`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ file_path: filePath, commit_hash: commitHash })
+    });
+  }
   // --- History ---
   async log(spaceId, filepath) {
     const path = filepath ? `/api/spaces/${spaceId}/log/${encodeURIComponent(filepath)}` : `/api/spaces/${spaceId}/log/`;
@@ -95,6 +152,48 @@ var DocSyncClient = class {
   async trash(spaceId) {
     return this.request(`/api/spaces/${spaceId}/trash`);
   }
+  async restore(spaceId, path, commit) {
+    await this.request(`/api/spaces/${spaceId}/trash/restore`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ path, commit })
+    });
+  }
+  // --- Comments ---
+  async listComments(spaceId, filePath) {
+    return this.request(
+      `/api/spaces/${spaceId}/comments?path=${encodeURIComponent(filePath)}`
+    );
+  }
+  async createComment(spaceId, filePath, content) {
+    return this.request(`/api/spaces/${spaceId}/comments`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ file_path: filePath, content })
+    });
+  }
+  async replyComment(spaceId, commentId, content) {
+    return this.request(
+      `/api/spaces/${spaceId}/comments/${commentId}/replies`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ content })
+      }
+    );
+  }
+  async closeComment(spaceId, commentId) {
+    return this.request(`/api/spaces/${spaceId}/comments/${commentId}`, {
+      method: "PUT",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ is_closed: true })
+    });
+  }
+  async deleteComment(spaceId, commentId) {
+    await this.request(`/api/spaces/${spaceId}/comments/${commentId}`, {
+      method: "DELETE"
+    });
+  }
   // --- Share Links ---
   async createShareLink(spaceId, filePath, opts) {
     const body = { file_path: filePath };
@@ -137,7 +236,9 @@ var DocSyncClient = class {
   async diffFile(spaceId, filePath, to, from) {
     const params = new URLSearchParams({ to });
     if (from) params.set("from", from);
-    return this.request(`/api/spaces/${spaceId}/diff/${encodeURIComponent(filePath)}?${params}`);
+    return this.request(
+      `/api/spaces/${spaceId}/diff/${encodeURIComponent(filePath)}?${params}`
+    );
   }
   async diffSummary(spaceId, to, from) {
     const params = new URLSearchParams({ to });
@@ -192,7 +293,7 @@ function getConfigPath() {
 
 // src/commands.ts
 import { readFileSync as readFileSync2 } from "fs";
-import { basename, dirname } from "path";
+import { basename } from "path";
 function getClient() {
   const token = getToken();
   if (!token) {
@@ -262,7 +363,10 @@ async function resolveTarget(client, args) {
 }
 function parseExpires(value) {
   const match = value.match(/^(\d+)([dh])$/);
-  if (!match) throw new Error(`Invalid expires format: "${value}". Use e.g. 7d, 24h, 30d`);
+  if (!match)
+    throw new Error(
+      `Invalid expires format: "${value}". Use e.g. 7d, 24h, 30d`
+    );
   const [, num, unit] = match;
   const ms = unit === "d" ? Number(num) * 864e5 : Number(num) * 36e5;
   return new Date(Date.now() + ms).toISOString();
@@ -272,6 +376,14 @@ function extractShareToken(input) {
   if (m) return m[1];
   return input;
 }
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks).toString("utf-8");
+}
+var MAX_SAVE_SIZE = 2 * 1024 * 1024;
 function registerCommands(program) {
   program.command("login").description("Configure DocSync credentials").option("-u, --url <url>", "DocSync server URL").option("-t, --token <token>", "API token").action(async (opts) => {
     const url = opts.url ?? getBaseUrl();
@@ -308,10 +420,10 @@ function registerCommands(program) {
       console.log(`${s.name}	${tag}	${s.member_count} members	${s.id}`);
     }
   });
-  program.command("ls").description("List files \u2014 docz ls <space>[:<path>] or <url>").argument("<target...>").action(async (args) => {
+  program.command("ls").description("List files \u2014 docz ls <space>[:<path>] or <url>").argument("<target...>").option("-R, --recursive", "Recursively list all files").action(async (args, opts) => {
     const client = getClient();
     const { spaceId, path } = await resolveTarget(client, args);
-    const entries = await client.ls(spaceId, path);
+    const entries = opts.recursive ? await client.treeFull(spaceId) : await client.ls(spaceId, path);
     if (entries.length === 0) {
       console.log("(empty)");
       return;
@@ -324,7 +436,7 @@ function registerCommands(program) {
       }
     }
   });
-  program.command("cat").description("Read file content \u2014 docz cat <space>:<path> or <url>").argument("<target...>").action(async (args) => {
+  program.command("cat").description("Read file content \u2014 docz cat <space>:<path> or <url>").argument("<target...>").option("--ref", "Also output Git ref to stderr").action(async (args, opts) => {
     const client = getClient();
     const { spaceId, path } = await resolveTarget(client, args);
     if (!path) {
@@ -333,8 +445,14 @@ function registerCommands(program) {
       );
       process.exit(1);
     }
-    const content = await client.cat(spaceId, path);
-    process.stdout.write(content);
+    if (opts.ref) {
+      const result = await client.catWithRef(spaceId, path);
+      console.error(`ref: ${result.ref}`);
+      process.stdout.write(result.content);
+    } else {
+      const content = await client.cat(spaceId, path);
+      process.stdout.write(content);
+    }
   });
   program.command("upload").description("Upload file \u2014 docz upload <local-file> <space>[:<dir>]").argument("<file>", "Local file to upload").argument("<target...>").action(async (file, args) => {
     const { space, path: dir } = parseTarget(args);
@@ -346,36 +464,51 @@ function registerCommands(program) {
     const result = await client.upload(s.id, targetDir, filename, content);
     console.log(`Uploaded: ${result.path}`);
   });
-  program.command("write").description("Write content to file \u2014 docz write <space>:<path> <content>").argument("<target>", "space:dir/filename.md").argument("<content>", "File content (or - for stdin)").action(async (target, content) => {
-    const { space, path } = parseTarget([target]);
-    if (!path) {
-      console.error(
-        "Error: path is required. Usage: docz write <space>:<dir/filename> <content>"
-      );
-      process.exit(1);
-    }
-    const client = getClient();
-    const s = await client.resolveSpace(space);
-    const filename = basename(path);
-    const dir = dirname(path);
-    let body;
-    if (content === "-") {
-      const chunks = [];
-      for await (const chunk of process.stdin) {
-        chunks.push(chunk);
+  program.command("write").description("Write content to file \u2014 docz write <space>:<path> <content>").argument("<target>", "space:dir/filename.md").argument("<content>", "File content (or - for stdin)").option("--force", "Skip conflict detection").option("-m, --message <msg>", "Custom commit message").action(
+    async (target, content, opts) => {
+      const { space, path } = parseTarget([target]);
+      if (!path) {
+        console.error(
+          "Error: path is required. Usage: docz write <space>:<dir/filename> <content>"
+        );
+        process.exit(1);
+      }
+      const client = getClient();
+      const s = await client.resolveSpace(space);
+      const body = content === "-" ? await readStdin() : content;
+      if (Buffer.byteLength(body, "utf-8") > MAX_SAVE_SIZE) {
+        console.error(
+          "Error: content exceeds 2MB limit. Use `docz upload` for large files."
+        );
+        process.exit(1);
+      }
+      let baseRef;
+      if (!opts.force) {
+        try {
+          const existing = await client.catWithRef(s.id, path);
+          baseRef = existing.ref;
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : "";
+          if (!msg.includes("404")) throw err;
+        }
+      }
+      try {
+        const result = await client.save(s.id, path, body, {
+          baseRef,
+          message: opts.message
+        });
+        console.log(`Written: ${result.path} (ref: ${result.ref})`);
+      } catch (err) {
+        if (err instanceof ConflictError) {
+          console.error(
+            "Error: file was modified by someone else. Please re-read the latest content and try again."
+          );
+          process.exit(1);
+        }
+        throw err;
       }
-      body = Buffer.concat(chunks).toString("utf-8");
-    } else {
-      body = content;
     }
-    const result = await client.upload(
-      s.id,
-      dir === "." ? "" : dir,
-      filename,
-      body
-    );
-    console.log(`Written: ${result.path}`);
-  });
+  );
   program.command("mkdir").description("Create folder \u2014 docz mkdir <space>:<path>").argument("<target...>").action(async (args) => {
     const { space, path } = parseTarget(args);
     if (!path) {
@@ -421,6 +554,19 @@ function registerCommands(program) {
       console.log(`${l.hash}  ${l.date}  ${l.message}`);
     }
   });
+  program.command("rollback").description(
+    "Rollback file to a previous version \u2014 docz rollback <space>:<path> <commit>"
+  ).argument("<target>", "space:path").argument("<commit>", "Commit hash to rollback to").action(async (target, commit) => {
+    const { space, path } = parseTarget([target]);
+    if (!path) {
+      console.error("Error: file path is required.");
+      process.exit(1);
+    }
+    const client = getClient();
+    const s = await client.resolveSpace(space);
+    await client.rollback(s.id, path, commit);
+    console.log(`Rolled back: ${path} \u2192 ${commit.substring(0, 7)}`);
+  });
   program.command("trash").description("Show deleted files \u2014 docz trash <space>").argument("<space>").action(async (spaceName) => {
     const client = getClient();
     const s = await client.resolveSpace(spaceName);
@@ -435,29 +581,105 @@ function registerCommands(program) {
       );
     }
   });
-  const share = program.command("share").description("Manage share links");
-  share.command("create").description("Create share link \u2014 docz share create <space>:<path>").argument("<target>", "space:path").option("--expires <duration>", "Expiry duration (e.g. 7d, 24h)").option("--users <emails>", "Comma-separated user emails or IDs").option("--groups <ids>", "Comma-separated group IDs").action(async (target, opts) => {
+  program.command("restore").description(
+    "Restore file from trash \u2014 docz restore <space>:<path> <commit>"
+  ).argument("<target>", "space:path").argument("<commit>", "Commit hash from trash listing").action(async (target, commit) => {
+    const { space, path } = parseTarget([target]);
+    if (!path) {
+      console.error("Error: path is required.");
+      process.exit(1);
+    }
+    const client = getClient();
+    const s = await client.resolveSpace(space);
+    await client.restore(s.id, path, commit);
+    console.log(`Restored: ${path}`);
+  });
+  const comment = program.command("comment").description("Manage file comments");
+  comment.command("list").description("List comments \u2014 docz comment list <space>:<path>").argument("<target...>").action(async (args) => {
+    const client = getClient();
+    const { spaceId, path } = await resolveTarget(client, args);
+    if (!path) {
+      console.error("Error: file path is required.");
+      process.exit(1);
+    }
+    const comments = await client.listComments(spaceId, path);
+    if (comments.length === 0) {
+      console.log("No comments.");
+      return;
+    }
+    for (const c of comments) {
+      const status = c.is_closed ? " [closed]" : "";
+      console.log(`#${c.id} ${c.user_name} (${c.created_at})${status}`);
+      console.log(`  ${c.content}`);
+      for (const r of c.replies) {
+        console.log(`    \u2192 ${r.user_name}: ${r.content}`);
+      }
+    }
+  });
+  comment.command("add").description("Add comment \u2014 docz comment add <space>:<path> <content>").argument("<target>", "space:path").argument("<content>", "Comment text (or - for stdin)").action(async (target, content) => {
     const { space, path } = parseTarget([target]);
     if (!path) {
-      console.error("Error: file path is required. Usage: docz share create <space>:<path>");
+      console.error("Error: file path is required.");
       process.exit(1);
     }
     const client = getClient();
     const s = await client.resolveSpace(space);
-    const apiOpts = {};
-    if (opts.expires) apiOpts.expiresAt = parseExpires(opts.expires);
-    if (opts.users) apiOpts.userIds = opts.users.split(",").map((s2) => s2.trim());
-    if (opts.groups) apiOpts.groupIds = opts.groups.split(",").map((s2) => s2.trim());
-    const link = await client.createShareLink(s.id, path, apiOpts);
-    const baseUrl = getBaseUrl();
-    console.log(`Created share link:`);
-    console.log(`  id:      ${link.id}`);
-    console.log(`  token:   ${link.token}`);
-    console.log(`  url:     ${baseUrl}/share/${link.token}`);
-    console.log(`  expires: ${link.expires_at ?? "never"}`);
-    if (link.user_ids?.length) console.log(`  users:   ${link.user_ids.join(", ")}`);
-    if (link.group_ids?.length) console.log(`  groups:  ${link.group_ids.length}`);
+    const body = content === "-" ? await readStdin() : content;
+    const c = await client.createComment(s.id, path, body);
+    console.log(`Comment #${c.id} created.`);
+  });
+  comment.command("reply").description(
+    "Reply to comment \u2014 docz comment reply <space> <commentId> <content>"
+  ).argument("<space>").argument("<commentId>").argument("<content>", "Reply text (or - for stdin)").action(async (spaceName, commentId, content) => {
+    const client = getClient();
+    const s = await client.resolveSpace(spaceName);
+    const body = content === "-" ? await readStdin() : content;
+    const r = await client.replyComment(s.id, Number(commentId), body);
+    console.log(`Reply #${r.id} created.`);
+  });
+  comment.command("close").description("Close comment \u2014 docz comment close <space> <commentId>").argument("<space>").argument("<commentId>").action(async (spaceName, commentId) => {
+    const client = getClient();
+    const s = await client.resolveSpace(spaceName);
+    await client.closeComment(s.id, Number(commentId));
+    console.log(`Comment #${commentId} closed.`);
   });
+  comment.command("rm").description("Delete comment \u2014 docz comment rm <space> <commentId>").argument("<space>").argument("<commentId>").action(async (spaceName, commentId) => {
+    const client = getClient();
+    const s = await client.resolveSpace(spaceName);
+    await client.deleteComment(s.id, Number(commentId));
+    console.log(`Comment #${commentId} deleted.`);
+  });
+  const share = program.command("share").description("Manage share links");
+  share.command("create").description("Create share link \u2014 docz share create <space>:<path>").argument("<target>", "space:path").option("--expires <duration>", "Expiry duration (e.g. 7d, 24h)").option("--users <emails>", "Comma-separated user emails or IDs").option("--groups <ids>", "Comma-separated group IDs").action(
+    async (target, opts) => {
+      const { space, path } = parseTarget([target]);
+      if (!path) {
+        console.error(
+          "Error: file path is required. Usage: docz share create <space>:<path>"
+        );
+        process.exit(1);
+      }
+      const client = getClient();
+      const s = await client.resolveSpace(space);
+      const apiOpts = {};
+      if (opts.expires) apiOpts.expiresAt = parseExpires(opts.expires);
+      if (opts.users)
+        apiOpts.userIds = opts.users.split(",").map((s2) => s2.trim());
+      if (opts.groups)
+        apiOpts.groupIds = opts.groups.split(",").map((s2) => s2.trim());
+      const link = await client.createShareLink(s.id, path, apiOpts);
+      const baseUrl = getBaseUrl();
+      console.log("Created share link:");
+      console.log(`  id:      ${link.id}`);
+      console.log(`  token:   ${link.token}`);
+      console.log(`  url:     ${baseUrl}/share/${link.token}`);
+      console.log(`  expires: ${link.expires_at ?? "never"}`);
+      if (link.user_ids?.length)
+        console.log(`  users:   ${link.user_ids.join(", ")}`);
+      if (link.group_ids?.length)
+        console.log(`  groups:  ${link.group_ids.length}`);
+    }
+  );
   share.command("list").description("List share links \u2014 docz share list <space>").argument("<space>").option("--file <path>", "Filter by file path").action(async (spaceName, opts) => {
     const client = getClient();
     const s = await client.resolveSpace(spaceName);
@@ -469,19 +691,25 @@ function registerCommands(program) {
     for (const l of links) {
       const expires = l.expires_at ?? "never";
       const creator = l.created_by_name ?? l.created_by_email ?? l.created_by;
-      console.log(`${l.id}	${l.token}	${l.file_path}	${expires}	${creator}`);
+      console.log(
+        `${l.id}	${l.token}	${l.file_path}	${expires}	${creator}`
+      );
     }
   });
-  share.command("update").description("Update share link \u2014 docz share update <space> <link-id>").argument("<space>").argument("<linkId>").option("--expires <duration>", "New expiry duration (e.g. 30d)").option("--users <emails>", "Comma-separated user emails or IDs").option("--groups <ids>", "Comma-separated group IDs").action(async (spaceName, linkId, opts) => {
-    const client = getClient();
-    const s = await client.resolveSpace(spaceName);
-    const apiOpts = {};
-    if (opts.expires) apiOpts.expiresAt = parseExpires(opts.expires);
-    if (opts.users) apiOpts.userIds = opts.users.split(",").map((s2) => s2.trim());
-    if (opts.groups) apiOpts.groupIds = opts.groups.split(",").map((s2) => s2.trim());
-    await client.updateShareLink(s.id, linkId, apiOpts);
-    console.log(`Updated share link: ${linkId}`);
-  });
+  share.command("update").description("Update share link \u2014 docz share update <space> <link-id>").argument("<space>").argument("<linkId>").option("--expires <duration>", "New expiry duration (e.g. 30d)").option("--users <emails>", "Comma-separated user emails or IDs").option("--groups <ids>", "Comma-separated group IDs").action(
+    async (spaceName, linkId, opts) => {
+      const client = getClient();
+      const s = await client.resolveSpace(spaceName);
+      const apiOpts = {};
+      if (opts.expires) apiOpts.expiresAt = parseExpires(opts.expires);
+      if (opts.users)
+        apiOpts.userIds = opts.users.split(",").map((s2) => s2.trim());
+      if (opts.groups)
+        apiOpts.groupIds = opts.groups.split(",").map((s2) => s2.trim());
+      await client.updateShareLink(s.id, linkId, apiOpts);
+      console.log(`Updated share link: ${linkId}`);
+    }
+  );
   share.command("cat").description("Read shared file \u2014 docz share cat <token-or-url>").argument("<token>", "Share token or full URL").option("--raw", "Output raw content only").action(async (tokenArg, opts) => {
     const client = getClient();
     const token = extractShareToken(tokenArg);
@@ -489,7 +717,9 @@ function registerCommands(program) {
       try {
         const info = await client.getSharedFileInfo(token);
         console.log(`File: ${info.file_path} (${info.space_name})`);
-        console.log(`Shared by: ${info.created_by_name} | Expires: ${info.expires_at ?? "never"}`);
+        console.log(
+          `Shared by: ${info.created_by_name} | Expires: ${info.expires_at ?? "never"}`
+        );
         console.log("---");
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
@@ -553,10 +783,11 @@ function registerCommands(program) {
 }
 
 export {
+  ConflictError,
   DocSyncClient,
   getBaseUrl,
   getToken,
   parseExpires,
   registerCommands
 };
-//# sourceMappingURL=chunk-EBJ32KUL.js.map
+//# sourceMappingURL=chunk-XUT76ACQ.js.map