@andrzejchm/notion-cli 0.8.0 → 0.9.0

package/README.md

@@ -37,7 +37,7 @@ Fetch and follow instructions from https://raw.githubusercontent.com/andrzejchm/
 - **`notion db query`** — filter, sort, and select columns from any database
 - **`notion append`** — append markdown content to an existing page
 - **`notion create-page`** — create a new page with markdown body, prints URL to stdout
-- **`notion comment`** — add a comment to a page
+- **`notion comment`** — add a comment to a page, block, or discussion thread
 - **Agent-friendly** — plain text tables by default; `--json` for machine-readable output
 - **Flexible auth** — interactive setup or `NOTION_API_TOKEN` env var
 - **Accepts URLs** — pass full Notion URLs anywhere an ID is expected
@@ -70,6 +70,12 @@ my-summarize-command | notion create-page --parent "$PAGE_ID" --title "Auto Summ
 # Add a comment to a page
 notion comment "$PAGE_ID" -m "Reviewed and approved."
 
+# Reply to an existing discussion thread
+notion comment --reply-to "$DISCUSSION_ID" -m "Agreed, let's proceed."
+
+# Comment on a specific block
+notion comment --block "$BLOCK_ID" -m "This section needs revision."
+
 # List everything your integration can access
 notion ls
 ```
@@ -85,15 +91,15 @@ notion ls
 | `notion auth status` | Show current auth state |
 | `notion auth list` | List all saved profiles |
 | `notion auth use <name>` | Switch the active profile |
-| `notion search <query>` | Search pages and databases by title |
-| `notion ls` | List all accessible pages and databases |
+| `notion search <query>` | Search pages and databases by title (`--sort asc\|desc`) |
+| `notion ls` | List all accessible pages and databases (`--sort asc\|desc`) |
 | `notion open <id\|url>` | Open a page in your browser |
 | `notion read <id\|url>` | Read a page as markdown |
 | `notion db schema <id\|url>` | Show database property schema and valid values |
 | `notion db query <id\|url>` | Query database entries with filtering and sorting |
 | `notion users` | List workspace members |
 | `notion comments <id\|url>` | Read page comments |
-| `notion comment <id\|url> -m <text>` | Add a comment to a page |
+| `notion comment [id\|url] -m <text>` | Add a comment to a page, block, or thread |
 | `notion append <id\|url> -m <markdown>` | Append markdown blocks to a page |
 | `notion edit-page <id\|url> --find <old> --replace <new>` | Search-and-replace text on a page |
 | `notion edit-page <id\|url> -m <markdown>` | Replace entire page content |
@@ -102,6 +108,15 @@ notion ls
 | `notion archive <id\|url>` | Archive (trash) a page |
 | `notion completion bash\|zsh\|fish` | Install shell tab completion |
 
+### `notion search` / `notion ls` flags
+
+| Flag | Example | Description |
+|------|---------|-------------|
+| `--sort` | `--sort desc` | Sort by last edited time (`asc` or `desc`) |
+| `--type` | `--type page` | Filter by object type (`page` or `database`) |
+| `--cursor` | `--cursor <cursor>` | Pagination cursor from a previous `--next` hint |
+| `--json` | `--json` | Force JSON output |
+
 ### `notion db query` flags
 
 | Flag | Example | Description |

package/dist/cli.js

@@ -543,23 +543,25 @@ function reportTokenSource(source) {
 }
 
 // src/services/write.service.ts
-async function addComment(client, pageId, text, options = {}) {
-  await client.comments.create({
-    parent: { page_id: pageId },
-    rich_text: [
-      {
-        type: "text",
-        text: { content: text, link: null },
-        annotations: {
-          bold: false,
-          italic: false,
-          strikethrough: false,
-          underline: false,
-          code: false,
-          color: "default"
-        }
+async function addComment(client, target, text, options = {}) {
+  const richText = [
+    {
+      type: "text",
+      text: { content: text, link: null },
+      annotations: {
+        bold: false,
+        italic: false,
+        strikethrough: false,
+        underline: false,
+        code: false,
+        color: "default"
       }
-    ],
+    }
+  ];
+  const targetPayload = target.type === "reply" ? { discussion_id: target.discussionId } : target.type === "block" ? { parent: { block_id: target.blockId } } : { parent: { page_id: target.pageId } };
+  await client.comments.create({
+    ...targetPayload,
+    rich_text: richText,
     ...options.asUser && { display_name: { type: "user" } }
   });
 }
@@ -1316,20 +1318,50 @@ function statusCommand() {
 
 // src/commands/comment-add.ts
 import { Command as Command6 } from "commander";
+function resolveTarget(idOrUrl, opts) {
+  const targetCount = [idOrUrl, opts.replyTo, opts.block].filter(
+    Boolean
+  ).length;
+  if (targetCount > 1) {
+    throw new CliError(
+      ErrorCodes.INVALID_ARG,
+      "Provide only one target: a page ID/URL, --reply-to, or --block.",
+      "These options are mutually exclusive"
+    );
+  }
+  if (opts.replyTo) {
+    return { type: "reply", discussionId: opts.replyTo };
+  }
+  if (opts.block) {
+    return { type: "block", blockId: opts.block };
+  }
+  if (idOrUrl) {
+    const id = parseNotionId(idOrUrl);
+    return { type: "page", pageId: toUuid(id) };
+  }
+  throw new CliError(
+    ErrorCodes.INVALID_ARG,
+    "Provide a page ID/URL, --reply-to <discussion-id>, or --block <block-id>."
+  );
+}
 function commentAddCommand() {
   const cmd = new Command6("comment");
-  cmd.description("add a comment to a Notion page").argument("<id/url>", "Notion page ID or URL").requiredOption("-m, --message <text>", "comment text to post").action(
-    withErrorHandling(async (idOrUrl, opts) => {
-      const { token, source } = await resolveToken();
-      reportTokenSource(source);
-      const client = createNotionClient(token);
-      const id = parseNotionId(idOrUrl);
-      const uuid = toUuid(id);
-      await addComment(client, uuid, opts.message, {
-        asUser: source === "oauth"
-      });
-      process.stdout.write("Comment added.\n");
-    })
+  cmd.description("add a comment to a Notion page, block, or discussion thread").argument("[id/url]", "Notion page ID or URL").requiredOption("-m, --message <text>", "comment text to post").option(
+    "--reply-to <discussion-id>",
+    "reply to an existing discussion thread"
+  ).option("--block <block-id>", "comment on a specific block").action(
+    withErrorHandling(
+      async (idOrUrl, opts) => {
+        const target = resolveTarget(idOrUrl, opts);
+        const { token, source } = await resolveToken();
+        reportTokenSource(source);
+        const client = createNotionClient(token);
+        await addComment(client, target, opts.message, {
+          asUser: source === "oauth"
+        });
+        process.stdout.write("Comment added.\n");
+      }
+    )
   );
   return cmd;
 }
@@ -1352,6 +1384,14 @@ async function paginateResults(fetcher) {
 }
 
 // src/commands/comments.ts
+function formatParent(parent) {
+  switch (parent.type) {
+    case "page_id":
+      return "page";
+    case "block_id":
+      return `block:${parent.block_id.slice(0, 8)}`;
+  }
+}
 function commentsCommand() {
   const cmd = new Command7("comments");
   cmd.description("list comments on a Notion page").argument("<id/url>", "Notion page ID or URL").option("--json", "output as JSON").action(
@@ -1374,10 +1414,16 @@ function commentsCommand() {
         return [
           comment.created_time.split("T")[0],
           `${comment.created_by.id.slice(0, 8)}...`,
+          comment.discussion_id.slice(0, 8),
+          formatParent(comment.parent),
           text.slice(0, 80) + (text.length > 80 ? "\u2026" : "")
         ];
       });
-      printOutput(comments, ["DATE", "AUTHOR ID", "COMMENT"], rows);
+      printOutput(
+        comments,
+        ["DATE", "AUTHOR ID", "DISCUSSION", "PARENT", "COMMENT"],
+        rows
+      );
     })
   );
   return cmd;
@@ -2212,6 +2258,15 @@ function lsCommand() {
       }
       return val;
     }
+  ).option(
+    "--sort <direction>",
+    "sort by last edited time (asc or desc)",
+    (val) => {
+      if (val !== "asc" && val !== "desc") {
+        throw new Error('--sort must be "asc" or "desc"');
+      }
+      return val;
+    }
   ).option(
     "--cursor <cursor>",
     "start from this pagination cursor (from a previous --next hint)"
@@ -2225,6 +2280,10 @@ function lsCommand() {
         reportTokenSource(source);
         const notion = createNotionClient(token);
         const response = await notion.search({
+          sort: opts.sort ? {
+            timestamp: "last_edited_time",
+            direction: opts.sort === "asc" ? "ascending" : "descending"
+          } : void 0,
           start_cursor: opts.cursor,
           page_size: 20
         });
@@ -2564,6 +2623,15 @@ function searchCommand() {
       }
       return val;
     }
+  ).option(
+    "--sort <direction>",
+    "sort by last edited time (asc or desc)",
+    (val) => {
+      if (val !== "asc" && val !== "desc") {
+        throw new Error('--sort must be "asc" or "desc"');
+      }
+      return val;
+    }
   ).option(
     "--cursor <cursor>",
     "start from this pagination cursor (from a previous --next hint)"
@@ -2579,6 +2647,10 @@ function searchCommand() {
         const response = await notion.search({
           query,
           filter: opts.type ? { property: "object", value: toSdkFilterValue(opts.type) } : void 0,
+          sort: opts.sort ? {
+            timestamp: "last_edited_time",
+            direction: opts.sort === "asc" ? "ascending" : "descending"
+          } : void 0,
           start_cursor: opts.cursor,
           page_size: 20
         });