@andrzejchm/notion-cli 0.7.0 → 0.9.0

package/dist/cli.js

@@ -4,7 +4,7 @@
 import { readFileSync } from "fs";
 import { dirname, join as join3 } from "path";
 import { fileURLToPath } from "url";
-import { Command as Command22 } from "commander";
+import { Command as Command23 } from "commander";
 
 // src/commands/append.ts
 import { Command } from "commander";
@@ -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" } }
   });
 }
@@ -659,7 +661,22 @@ async function replaceMarkdown(client, pageId, newMarkdown, options) {
     }
   });
 }
-async function createPage(client, parentId, title, markdown) {
+function buildIconCover(options) {
+  const result = {};
+  if (options?.icon) {
+    const isUrl = /^https?:\/\//i.test(options.icon);
+    if (isUrl) {
+      result.icon = { type: "external", external: { url: options.icon } };
+    } else {
+      result.icon = { type: "emoji", emoji: options.icon };
+    }
+  }
+  if (options?.cover) {
+    result.cover = { type: "external", external: { url: options.cover } };
+  }
+  return result;
+}
+async function createPage(client, parentId, title, markdown, options) {
   const response = await client.pages.create({
     parent: { type: "page_id", page_id: parentId },
     properties: {
@@ -667,7 +684,24 @@ async function createPage(client, parentId, title, markdown) {
         title: [{ type: "text", text: { content: title, link: null } }]
       }
     },
-    ...markdown.trim() ? { markdown } : {}
+    ...markdown.trim() ? { markdown } : {},
+    ...buildIconCover(options)
+  });
+  const url = "url" in response ? response.url : response.id;
+  return url;
+}
+async function createPageInDatabase(client, databaseId, titlePropName, title, extraProperties, markdown, options) {
+  const properties = {
+    ...extraProperties,
+    [titlePropName]: {
+      title: [{ type: "text", text: { content: title, link: null } }]
+    }
+  };
+  const response = await client.pages.create({
+    parent: { type: "database_id", database_id: databaseId },
+    properties,
+    ...markdown.trim() ? { markdown } : {},
+    ...buildIconCover(options)
   });
   const url = "url" in response ? response.url : response.id;
   return url;
@@ -737,6 +771,102 @@ function appendCommand() {
   return cmd;
 }
 
+// src/commands/archive.ts
+import { Command as Command2 } from "commander";
+
+// src/output/format.ts
+var _mode = "auto";
+function setOutputMode(mode) {
+  _mode = mode;
+}
+function getOutputMode() {
+  return _mode;
+}
+function isatty() {
+  return Boolean(process.stdout.isTTY);
+}
+function isHumanMode() {
+  if (_mode === "json") return false;
+  if (_mode === "md") return false;
+  return true;
+}
+function formatJSON(data) {
+  return JSON.stringify(data, null, 2);
+}
+var COLUMN_CAPS = {
+  TITLE: 50,
+  ID: 36
+};
+var DEFAULT_MAX_COL_WIDTH = 40;
+function getColumnCap(header) {
+  return COLUMN_CAPS[header.toUpperCase()] ?? DEFAULT_MAX_COL_WIDTH;
+}
+function truncate(str, maxLen) {
+  if (str.length <= maxLen) return str;
+  return `${str.slice(0, maxLen - 1)}\u2026`;
+}
+function formatTable(rows, headers) {
+  const colWidths = headers.map((header, colIdx) => {
+    const cap = getColumnCap(header);
+    const headerLen = header.length;
+    const maxRowLen = rows.reduce((max, row) => {
+      const cell = row[colIdx] ?? "";
+      return Math.max(max, cell.length);
+    }, 0);
+    return Math.min(Math.max(headerLen, maxRowLen), cap);
+  });
+  const sep = "\u2500";
+  const colSep = "  ";
+  const headerRow = headers.map((h, i) => h.padEnd(colWidths[i])).join(colSep);
+  const separatorRow = colWidths.map((w) => sep.repeat(w)).join(colSep);
+  const dataRows = rows.map(
+    (row) => headers.map((_, i) => {
+      const cell = row[i] ?? "";
+      return truncate(cell, colWidths[i]).padEnd(colWidths[i]);
+    }).join(colSep)
+  );
+  return [headerRow, separatorRow, ...dataRows].join("\n");
+}
+function printOutput(data, tableHeaders, tableRows) {
+  const mode = getOutputMode();
+  if (mode === "json") {
+    process.stdout.write(`${formatJSON(data)}
+`);
+  } else if (isHumanMode() && tableHeaders && tableRows) {
+    printWithPager(`${formatTable(tableRows, tableHeaders)}
+`);
+  }
+}
+function printWithPager(text) {
+  process.stdout.write(text);
+}
+
+// src/commands/archive.ts
+function archiveCommand() {
+  const cmd = new Command2("archive");
+  cmd.description("archive (trash) a Notion page").argument("<id/url>", "Notion page ID or URL").action(
+    withErrorHandling(async (idOrUrl) => {
+      const { token, source } = await resolveToken();
+      reportTokenSource(source);
+      const client = createNotionClient(token);
+      const id = parseNotionId(idOrUrl);
+      const uuid = toUuid(id);
+      const updatedPage = await client.pages.update({
+        page_id: uuid,
+        archived: true
+      });
+      const mode = getOutputMode();
+      if (mode === "json") {
+        process.stdout.write(`${formatJSON(updatedPage)}
+`);
+      } else {
+        process.stdout.write("Page archived.\n");
+      }
+    })
+  );
+  return cmd;
+}
+
 // src/commands/auth/index.ts
 function authDefaultAction(authCmd2) {
   return async () => {
@@ -746,7 +876,7 @@ function authDefaultAction(authCmd2) {
 
 // src/commands/auth/login.ts
 import { input } from "@inquirer/prompts";
-import { Command as Command2 } from "commander";
+import { Command as Command3 } from "commander";
 
 // src/oauth/oauth-flow.ts
 import { spawn } from "child_process";
@@ -993,7 +1123,7 @@ Waiting for callback (up to 120 seconds)...
 
 // src/commands/auth/login.ts
 function loginCommand() {
-  const cmd = new Command2("login");
+  const cmd = new Command3("login");
   cmd.description("authenticate with Notion via OAuth").option("--profile <name>", "profile name to store credentials in").option(
     "--manual",
     "print auth URL instead of opening browser (for headless OAuth)"
@@ -1056,7 +1186,7 @@ function loginCommand() {
 
 // src/commands/auth/logout.ts
 import { select } from "@inquirer/prompts";
-import { Command as Command3 } from "commander";
+import { Command as Command4 } from "commander";
 function profileLabel(name, profile) {
   const parts = [];
   if (profile.oauth_access_token)
@@ -1069,7 +1199,7 @@ function profileLabel(name, profile) {
   return `${bold(name)}  ${dim(authDesc)}${workspace}`;
 }
 function logoutCommand() {
-  const cmd = new Command3("logout");
+  const cmd = new Command4("logout");
   cmd.description("remove a profile and its credentials").option(
     "--profile <name>",
     "profile name to remove (skips interactive selector)"
@@ -1127,9 +1257,9 @@ function logoutCommand() {
 }
 
 // src/commands/auth/status.ts
-import { Command as Command4 } from "commander";
+import { Command as Command5 } from "commander";
 function statusCommand() {
-  const cmd = new Command4("status");
+  const cmd = new Command5("status");
   cmd.description("show authentication status for the active profile").option("--profile <name>", "profile name to check").action(
     withErrorHandling(async (opts) => {
       let profileName = opts.profile;
@@ -1187,94 +1317,57 @@ function statusCommand() {
 }
 
 // src/commands/comment-add.ts
-import { Command as Command5 } from "commander";
+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 Command5("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");
-    })
+  const cmd = new Command6("comment");
+  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;
 }
 
 // src/commands/comments.ts
-import { Command as Command6 } from "commander";
-
-// src/output/format.ts
-var _mode = "auto";
-function setOutputMode(mode) {
-  _mode = mode;
-}
-function getOutputMode() {
-  return _mode;
-}
-function isatty() {
-  return Boolean(process.stdout.isTTY);
-}
-function isHumanMode() {
-  if (_mode === "json") return false;
-  if (_mode === "md") return false;
-  return true;
-}
-function formatJSON(data) {
-  return JSON.stringify(data, null, 2);
-}
-var COLUMN_CAPS = {
-  TITLE: 50,
-  ID: 36
-};
-var DEFAULT_MAX_COL_WIDTH = 40;
-function getColumnCap(header) {
-  return COLUMN_CAPS[header.toUpperCase()] ?? DEFAULT_MAX_COL_WIDTH;
-}
-function truncate(str, maxLen) {
-  if (str.length <= maxLen) return str;
-  return `${str.slice(0, maxLen - 1)}\u2026`;
-}
-function formatTable(rows, headers) {
-  const colWidths = headers.map((header, colIdx) => {
-    const cap = getColumnCap(header);
-    const headerLen = header.length;
-    const maxRowLen = rows.reduce((max, row) => {
-      const cell = row[colIdx] ?? "";
-      return Math.max(max, cell.length);
-    }, 0);
-    return Math.min(Math.max(headerLen, maxRowLen), cap);
-  });
-  const sep = "\u2500";
-  const colSep = "  ";
-  const headerRow = headers.map((h, i) => h.padEnd(colWidths[i])).join(colSep);
-  const separatorRow = colWidths.map((w) => sep.repeat(w)).join(colSep);
-  const dataRows = rows.map(
-    (row) => headers.map((_, i) => {
-      const cell = row[i] ?? "";
-      return truncate(cell, colWidths[i]).padEnd(colWidths[i]);
-    }).join(colSep)
-  );
-  return [headerRow, separatorRow, ...dataRows].join("\n");
-}
-function printOutput(data, tableHeaders, tableRows) {
-  const mode = getOutputMode();
-  if (mode === "json") {
-    process.stdout.write(`${formatJSON(data)}
-`);
-  } else if (isHumanMode() && tableHeaders && tableRows) {
-    printWithPager(`${formatTable(tableRows, tableHeaders)}
-`);
-  }
-}
-function printWithPager(text) {
-  process.stdout.write(text);
-}
+import { Command as Command7 } from "commander";
 
 // src/output/paginate.ts
 async function paginateResults(fetcher) {
@@ -1291,8 +1384,16 @@ 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 Command6("comments");
+  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(
     withErrorHandling(async (idOrUrl, opts) => {
       if (opts.json) setOutputMode("json");
@@ -1313,17 +1414,23 @@ 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;
 }
 
 // src/commands/completion.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 var BASH_COMPLETION = `# notion bash completion
 _notion_completion() {
   local cur prev words cword
@@ -1425,7 +1532,7 @@ complete -c notion -n '__fish_seen_subcommand_from completion' -a zsh -d 'zsh co
 complete -c notion -n '__fish_seen_subcommand_from completion' -a fish -d 'fish completion script'
 `;
 function completionCommand() {
-  const cmd = new Command7("completion");
+  const cmd = new Command8("completion");
   cmd.description("output shell completion script").argument("<shell>", "shell type (bash, zsh, fish)").action(
     withErrorHandling(async (shell) => {
       switch (shell) {
@@ -1451,40 +1558,6 @@ function completionCommand() {
 }
 
 // src/commands/create-page.ts
-import { Command as Command8 } from "commander";
-function createPageCommand() {
-  const cmd = new Command8("create-page");
-  cmd.description("create a new Notion page under a parent page").requiredOption("--parent <id/url>", "parent page ID or URL").requiredOption("--title <title>", "page title").option(
-    "-m, --message <markdown>",
-    "inline markdown content for the page body"
-  ).action(
-    withErrorHandling(
-      async (opts) => {
-        const { token, source } = await resolveToken();
-        reportTokenSource(source);
-        const client = createNotionClient(token);
-        let markdown = "";
-        if (opts.message) {
-          markdown = opts.message;
-        } else if (!process.stdin.isTTY) {
-          markdown = await readStdin();
-        }
-        const parentUuid = toUuid(parseNotionId(opts.parent));
-        const url = await createPage(
-          client,
-          parentUuid,
-          opts.title,
-          markdown
-        );
-        process.stdout.write(`${url}
-`);
-      }
-    )
-  );
-  return cmd;
-}
-
-// src/commands/db/query.ts
 import { Command as Command9 } from "commander";
 
 // src/services/database.service.ts
@@ -1510,7 +1583,8 @@ async function fetchDatabaseSchema(client, dbId) {
       properties[name] = config;
     }
   }
-  return { id: dbId, title, properties };
+  const databaseId = "parent" in ds && ds.parent && typeof ds.parent === "object" && "database_id" in ds.parent ? ds.parent.database_id : dbId;
+  return { id: dbId, databaseId, title, properties };
 }
 async function queryDatabase(client, dbId, opts = {}) {
   const rawPages = await paginateResults(
@@ -1651,18 +1725,213 @@ function displayPropertyValue(prop) {
   }
 }
 
-// src/commands/db/query.ts
-var SKIP_TYPES_IN_AUTO = /* @__PURE__ */ new Set(["relation", "rich_text", "people"]);
-function autoSelectColumns(schema, entries) {
-  const termWidth = process.stdout.columns || 120;
-  const COL_SEP = 2;
-  const candidates = Object.values(schema.properties).filter((p) => !SKIP_TYPES_IN_AUTO.has(p.type)).map((p) => p.name);
-  const widths = candidates.map((col) => {
-    const header = col.toUpperCase().length;
-    const maxData = entries.reduce(
-      (max, e) => Math.max(max, (e.properties[col] ?? "").length),
-      0
-    );
+// src/services/update.service.ts
+var UNSUPPORTED_TYPES = /* @__PURE__ */ new Set([
+  "relation",
+  "formula",
+  "rollup",
+  "created_time",
+  "created_by",
+  "last_edited_time",
+  "last_edited_by",
+  "files",
+  "unique_id",
+  "verification",
+  "button"
+]);
+function buildPropertyUpdate(propName, propType, value) {
+  if (UNSUPPORTED_TYPES.has(propType)) {
+    throw new CliError(
+      ErrorCodes.INVALID_ARG,
+      `Property "${propName}" has type "${propType}" which cannot be set via the CLI.`,
+      "Supported types: title, rich_text, select, status, multi_select, number, checkbox, url, email, phone_number, date"
+    );
+  }
+  if (value === "") {
+    return null;
+  }
+  switch (propType) {
+    case "title":
+      return { title: [{ type: "text", text: { content: value } }] };
+    case "rich_text":
+      return { rich_text: [{ type: "text", text: { content: value } }] };
+    case "select":
+      return { select: { name: value } };
+    case "status":
+      return { status: { name: value } };
+    case "multi_select":
+      return {
+        multi_select: value.split(",").map((v) => v.trim()).filter(Boolean).map((v) => ({ name: v }))
+      };
+    case "number": {
+      const n = Number(value);
+      if (Number.isNaN(n)) {
+        throw new CliError(
+          ErrorCodes.INVALID_ARG,
+          `Invalid number value "${value}" for property "${propName}".`,
+          'Provide a numeric value, e.g. --prop "Count=42"'
+        );
+      }
+      return { number: n };
+    }
+    case "checkbox": {
+      const lower = value.toLowerCase();
+      return { checkbox: lower === "true" || lower === "yes" };
+    }
+    case "url":
+      return { url: value };
+    case "email":
+      return { email: value };
+    case "phone_number":
+      return { phone_number: value };
+    case "date": {
+      const parts = value.split(",");
+      const start = parts[0].trim();
+      const end = parts[1]?.trim();
+      return { date: end ? { start, end } : { start } };
+    }
+    default:
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Property "${propName}" has unsupported type "${propType}".`,
+        "Supported types: title, rich_text, select, status, multi_select, number, checkbox, url, email, phone_number, date"
+      );
+  }
+}
+function buildPropertiesPayload(propStrings, schemaOrPage) {
+  const isPage = "object" in schemaOrPage && schemaOrPage.object === "page";
+  const schema = isPage ? schemaOrPage.properties : schemaOrPage;
+  const result = {};
+  for (const propString of propStrings) {
+    const eqIdx = propString.indexOf("=");
+    if (eqIdx === -1) {
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Invalid --prop value: "${propString}". Expected format: "PropertyName=Value".`,
+        'Example: --prop "Status=Done"'
+      );
+    }
+    const propName = propString.slice(0, eqIdx).trim();
+    const value = propString.slice(eqIdx + 1);
+    const schemaProp = schema[propName];
+    if (!schemaProp) {
+      const available = Object.keys(schema).join(", ");
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Property "${propName}" not found on this page.`,
+        `Available properties: ${available}`
+      );
+    }
+    const propType = schemaProp.type;
+    const payload = buildPropertyUpdate(propName, propType, value);
+    result[propName] = payload;
+  }
+  return result;
+}
+async function updatePageProperties(client, pageId, properties) {
+  const response = await client.pages.update({
+    page_id: pageId,
+    properties
+  });
+  return response;
+}
+
+// src/commands/create-page.ts
+function collectProps(val, acc) {
+  acc.push(val);
+  return acc;
+}
+async function tryGetDatabaseSchema(client, uuid) {
+  try {
+    return await fetchDatabaseSchema(client, uuid);
+  } catch {
+    return null;
+  }
+}
+function createPageCommand() {
+  const cmd = new Command9("create-page");
+  cmd.description("create a new Notion page under a parent page or database").requiredOption("--parent <id/url>", "parent page or database ID/URL").requiredOption("--title <title>", "page title").option(
+    "-m, --message <markdown>",
+    "inline markdown content for the page body"
+  ).option(
+    "--prop <property=value>",
+    "set a property value (repeatable, database parents only)",
+    collectProps,
+    []
+  ).option("--icon <emoji-or-url>", "page icon \u2014 emoji character or image URL").option("--cover <url>", "page cover image URL").action(
+    withErrorHandling(async (opts) => {
+      const { token, source } = await resolveToken();
+      reportTokenSource(source);
+      const client = createNotionClient(token);
+      let markdown = "";
+      if (opts.message) {
+        markdown = opts.message;
+      } else if (!process.stdin.isTTY) {
+        markdown = await readStdin();
+      }
+      const parentUuid = toUuid(parseNotionId(opts.parent));
+      const iconCover = { icon: opts.icon, cover: opts.cover };
+      const dbSchema = await tryGetDatabaseSchema(client, parentUuid);
+      if (dbSchema) {
+        const titleEntry = Object.entries(dbSchema.properties).find(
+          ([, prop]) => prop.type === "title"
+        );
+        if (!titleEntry) {
+          throw new CliError(
+            ErrorCodes.API_ERROR,
+            "Database has no title property.",
+            "This database cannot accept new pages."
+          );
+        }
+        const [titlePropName] = titleEntry;
+        const extraProperties = opts.prop.length > 0 ? buildPropertiesPayload(opts.prop, dbSchema.properties) : {};
+        const url = await createPageInDatabase(
+          client,
+          dbSchema.databaseId,
+          titlePropName,
+          opts.title,
+          extraProperties,
+          markdown,
+          iconCover
+        );
+        process.stdout.write(`${url}
+`);
+      } else {
+        if (opts.prop.length > 0) {
+          throw new CliError(
+            ErrorCodes.INVALID_ARG,
+            "--prop is only supported when the parent is a database.",
+            "To set properties, use a database ID/URL as --parent"
+          );
+        }
+        const url = await createPage(
+          client,
+          parentUuid,
+          opts.title,
+          markdown,
+          iconCover
+        );
+        process.stdout.write(`${url}
+`);
+      }
+    })
+  );
+  return cmd;
+}
+
+// src/commands/db/query.ts
+import { Command as Command10 } from "commander";
+var SKIP_TYPES_IN_AUTO = /* @__PURE__ */ new Set(["relation", "rich_text", "people"]);
+function autoSelectColumns(schema, entries) {
+  const termWidth = process.stdout.columns || 120;
+  const COL_SEP = 2;
+  const candidates = Object.values(schema.properties).filter((p) => !SKIP_TYPES_IN_AUTO.has(p.type)).map((p) => p.name);
+  const widths = candidates.map((col) => {
+    const header = col.toUpperCase().length;
+    const maxData = entries.reduce(
+      (max, e) => Math.max(max, (e.properties[col] ?? "").length),
+      0
+    );
     return Math.min(Math.max(header, maxData), 40);
   });
   const selected = [];
@@ -1679,7 +1948,7 @@ function autoSelectColumns(schema, entries) {
   return selected;
 }
 function dbQueryCommand() {
-  return new Command9("query").description("Query database entries with optional filtering and sorting").argument("<id>", "Notion database ID or URL").option(
+  return new Command10("query").description("Query database entries with optional filtering and sorting").argument("<id>", "Notion database ID or URL").option(
     "--filter <filter>",
     'Filter entries (repeatable): --filter "Status=Done"',
     collect,
@@ -1734,9 +2003,9 @@ function collect(value, previous) {
 }
 
 // src/commands/db/schema.ts
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 function dbSchemaCommand() {
-  return new Command10("schema").description("Show database schema (property names, types, and options)").argument("<id>", "Notion database ID or URL").option("--json", "Output raw JSON").action(
+  return new Command11("schema").description("Show database schema (property names, types, and options)").argument("<id>", "Notion database ID or URL").option("--json", "Output raw JSON").action(
     withErrorHandling(async (id, options) => {
       const { token } = await resolveToken();
       const client = createNotionClient(token);
@@ -1760,13 +2029,13 @@ function dbSchemaCommand() {
 }
 
 // src/commands/edit-page.ts
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 function collect2(val, acc) {
   acc.push(val);
   return acc;
 }
 function editPageCommand() {
-  const cmd = new Command11("edit-page");
+  const cmd = new Command12("edit-page");
   cmd.description(
     "replace a Notion page's content \u2014 full page or a targeted section"
   ).argument("<id/url>", "Notion page ID or URL").option(
@@ -1864,7 +2133,7 @@ function editPageCommand() {
 
 // src/commands/init.ts
 import { confirm, input as input2, password } from "@inquirer/prompts";
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 async function runInitFlow() {
   const profileName = await input2({
     message: "Profile name:",
@@ -1944,7 +2213,7 @@ async function runInitFlow() {
   stderrWrite(dim("  notion auth login"));
 }
 function initCommand() {
-  const cmd = new Command12("init");
+  const cmd = new Command13("init");
   cmd.description("authenticate with Notion and save a profile").action(
     withErrorHandling(async () => {
       if (!process.stdin.isTTY) {
@@ -1962,7 +2231,7 @@ function initCommand() {
 
 // src/commands/ls.ts
 import { isFullPageOrDataSource } from "@notionhq/client";
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 function getTitle(item) {
   if (item.object === "data_source") {
     return item.title.map((t) => t.plain_text).join("") || "(untitled)";
@@ -1979,7 +2248,7 @@ function displayType(item) {
   return item.object === "data_source" ? "database" : item.object;
 }
 function lsCommand() {
-  const cmd = new Command13("ls");
+  const cmd = new Command14("ls");
   cmd.description("list accessible Notion pages and databases").option(
     "--type <type>",
     "filter by object type (page or database)",
@@ -1989,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)"
@@ -2002,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
         });
@@ -2042,10 +2324,10 @@ function lsCommand() {
 // src/commands/open.ts
 import { exec } from "child_process";
 import { promisify } from "util";
-import { Command as Command14 } from "commander";
+import { Command as Command15 } from "commander";
 var execAsync = promisify(exec);
 function openCommand() {
-  const cmd = new Command14("open");
+  const cmd = new Command15("open");
   cmd.description("open a Notion page in the default browser").argument("<id/url>", "Notion page ID or URL").action(
     withErrorHandling(async (idOrUrl) => {
       const id = parseNotionId(idOrUrl);
@@ -2061,9 +2343,9 @@ function openCommand() {
 }
 
 // src/commands/profile/list.ts
-import { Command as Command15 } from "commander";
+import { Command as Command16 } from "commander";
 function profileListCommand() {
-  const cmd = new Command15("list");
+  const cmd = new Command16("list");
   cmd.description("list all authentication profiles").action(
     withErrorHandling(async () => {
       const config = await readGlobalConfig();
@@ -2092,9 +2374,9 @@ function profileListCommand() {
 }
 
 // src/commands/profile/remove.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 function profileRemoveCommand() {
-  const cmd = new Command16("remove");
+  const cmd = new Command17("remove");
   cmd.description("remove an authentication profile").argument("<name>", "profile name to remove").action(
     withErrorHandling(async (name) => {
       const config = await readGlobalConfig();
@@ -2120,9 +2402,9 @@ function profileRemoveCommand() {
 }
 
 // src/commands/profile/use.ts
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 function profileUseCommand() {
-  const cmd = new Command17("use");
+  const cmd = new Command18("use");
   cmd.description("switch the active profile").argument("<name>", "profile name to activate").action(
     withErrorHandling(async (name) => {
       const config = await readGlobalConfig();
@@ -2145,7 +2427,7 @@ function profileUseCommand() {
 }
 
 // src/commands/read.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 
 // src/output/markdown.ts
 import { Chalk as Chalk2 } from "chalk";
@@ -2285,7 +2567,7 @@ async function fetchPageMarkdown(client, pageId) {
 
 // src/commands/read.ts
 function readCommand() {
-  return new Command18("read").description("Read a Notion page as markdown").argument("<id>", "Notion page ID or URL").action(
+  return new Command19("read").description("Read a Notion page as markdown").argument("<id>", "Notion page ID or URL").action(
     withErrorHandling(async (id) => {
       const { token } = await resolveToken();
       const client = createNotionClient(token);
@@ -2311,7 +2593,7 @@ function readCommand() {
 
 // src/commands/search.ts
 import { isFullPageOrDataSource as isFullPageOrDataSource2 } from "@notionhq/client";
-import { Command as Command19 } from "commander";
+import { Command as Command20 } from "commander";
 function getTitle2(item) {
   if (item.object === "data_source") {
     return item.title.map((t) => t.plain_text).join("") || "(untitled)";
@@ -2331,7 +2613,7 @@ function displayType2(item) {
   return item.object === "data_source" ? "database" : item.object;
 }
 function searchCommand() {
-  const cmd = new Command19("search");
+  const cmd = new Command20("search");
   cmd.description("search Notion workspace by keyword").argument("<query>", "search keyword").option(
     "--type <type>",
     "filter by object type (page or database)",
@@ -2341,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)"
@@ -2356,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
         });
@@ -2389,128 +2684,17 @@ function searchCommand() {
 }
 
 // src/commands/update.ts
-import { Command as Command20 } from "commander";
-
-// src/services/update.service.ts
-var UNSUPPORTED_TYPES = /* @__PURE__ */ new Set([
-  "relation",
-  "formula",
-  "rollup",
-  "created_time",
-  "created_by",
-  "last_edited_time",
-  "last_edited_by",
-  "files",
-  "unique_id",
-  "verification",
-  "button"
-]);
-function buildPropertyUpdate(propName, propType, value) {
-  if (UNSUPPORTED_TYPES.has(propType)) {
-    throw new CliError(
-      ErrorCodes.INVALID_ARG,
-      `Property "${propName}" has type "${propType}" which cannot be set via the CLI.`,
-      "Supported types: title, rich_text, select, status, multi_select, number, checkbox, url, email, phone_number, date"
-    );
-  }
-  if (value === "") {
-    return null;
-  }
-  switch (propType) {
-    case "title":
-      return { title: [{ type: "text", text: { content: value } }] };
-    case "rich_text":
-      return { rich_text: [{ type: "text", text: { content: value } }] };
-    case "select":
-      return { select: { name: value } };
-    case "status":
-      return { status: { name: value } };
-    case "multi_select":
-      return {
-        multi_select: value.split(",").map((v) => v.trim()).filter(Boolean).map((v) => ({ name: v }))
-      };
-    case "number": {
-      const n = Number(value);
-      if (Number.isNaN(n)) {
-        throw new CliError(
-          ErrorCodes.INVALID_ARG,
-          `Invalid number value "${value}" for property "${propName}".`,
-          'Provide a numeric value, e.g. --prop "Count=42"'
-        );
-      }
-      return { number: n };
-    }
-    case "checkbox": {
-      const lower = value.toLowerCase();
-      return { checkbox: lower === "true" || lower === "yes" };
-    }
-    case "url":
-      return { url: value };
-    case "email":
-      return { email: value };
-    case "phone_number":
-      return { phone_number: value };
-    case "date": {
-      const parts = value.split(",");
-      const start = parts[0].trim();
-      const end = parts[1]?.trim();
-      return { date: end ? { start, end } : { start } };
-    }
-    default:
-      throw new CliError(
-        ErrorCodes.INVALID_ARG,
-        `Property "${propName}" has unsupported type "${propType}".`,
-        "Supported types: title, rich_text, select, status, multi_select, number, checkbox, url, email, phone_number, date"
-      );
-  }
-}
-function buildPropertiesPayload(propStrings, page) {
-  const result = {};
-  for (const propString of propStrings) {
-    const eqIdx = propString.indexOf("=");
-    if (eqIdx === -1) {
-      throw new CliError(
-        ErrorCodes.INVALID_ARG,
-        `Invalid --prop value: "${propString}". Expected format: "PropertyName=Value".`,
-        'Example: --prop "Status=Done"'
-      );
-    }
-    const propName = propString.slice(0, eqIdx).trim();
-    const value = propString.slice(eqIdx + 1);
-    const schemaProp = page.properties[propName];
-    if (!schemaProp) {
-      const available = Object.keys(page.properties).join(", ");
-      throw new CliError(
-        ErrorCodes.INVALID_ARG,
-        `Property "${propName}" not found on this page.`,
-        `Available properties: ${available}`
-      );
-    }
-    const propType = schemaProp.type;
-    const payload = buildPropertyUpdate(propName, propType, value);
-    result[propName] = payload;
-  }
-  return result;
-}
-async function updatePageProperties(client, pageId, properties) {
-  const response = await client.pages.update({
-    page_id: pageId,
-    properties
-  });
-  return response;
-}
-
-// src/commands/update.ts
-function collectProps(val, acc) {
+import { Command as Command21 } from "commander";
+function collectProps2(val, acc) {
   acc.push(val);
   return acc;
 }
 function updateCommand() {
-  const cmd = new Command20("update");
+  const cmd = new Command21("update");
   cmd.description("update properties on a Notion page").argument("<id/url>", "Notion page ID or URL").option(
     "--prop <property=value>",
     "set a property value (repeatable)",
-    collectProps,
+    collectProps2,
     []
   ).option("--title <title>", "set the page title").action(
     withErrorHandling(async (idOrUrl, opts) => {
@@ -2564,7 +2748,7 @@ function updateCommand() {
 }
 
 // src/commands/users.ts
-import { Command as Command21 } from "commander";
+import { Command as Command22 } from "commander";
 function getEmailOrWorkspace(user) {
   if (user.type === "person") {
     return user.person.email ?? "\u2014";
@@ -2576,7 +2760,7 @@ function getEmailOrWorkspace(user) {
   return "\u2014";
 }
 function usersCommand() {
-  const cmd = new Command21("users");
+  const cmd = new Command22("users");
   cmd.description("list all users in the workspace").option("--json", "output as JSON").action(
     withErrorHandling(async (opts) => {
       if (opts.json) setOutputMode("json");
@@ -2607,7 +2791,7 @@ var __dirname = dirname(__filename);
 var pkg = JSON.parse(
   readFileSync(join3(__dirname, "../package.json"), "utf-8")
 );
-var program = new Command22();
+var program = new Command23();
 program.name("notion").description("Notion CLI \u2014 read Notion pages and databases from the terminal").version(pkg.version);
 program.option("--verbose", "show API requests/responses").option("--color", "force color output").option("--json", "force JSON output (overrides TTY detection)").option("--md", "force markdown output for page content");
 program.configureOutput({
@@ -2628,7 +2812,7 @@ program.hook("preAction", (thisCommand) => {
     setOutputMode("md");
   }
 });
-var authCmd = new Command22("auth").description("manage Notion authentication");
+var authCmd = new Command23("auth").description("manage Notion authentication");
 authCmd.action(authDefaultAction(authCmd));
 authCmd.addCommand(loginCommand());
 authCmd.addCommand(logoutCommand());
@@ -2638,7 +2822,7 @@ authCmd.addCommand(profileUseCommand());
 authCmd.addCommand(profileRemoveCommand());
 program.addCommand(authCmd);
 program.addCommand(initCommand(), { hidden: true });
-var profileCmd = new Command22("profile").description(
+var profileCmd = new Command23("profile").description(
   "manage authentication profiles"
 );
 profileCmd.addCommand(profileListCommand());
@@ -2656,7 +2840,8 @@ program.addCommand(appendCommand());
 program.addCommand(createPageCommand());
 program.addCommand(editPageCommand());
 program.addCommand(updateCommand());
-var dbCmd = new Command22("db").description("Database operations");
+program.addCommand(archiveCommand());
+var dbCmd = new Command23("db").description("Database operations");
 dbCmd.addCommand(dbSchemaCommand());
 dbCmd.addCommand(dbQueryCommand());
 program.addCommand(dbCmd);