@andrzejchm/notion-cli 0.6.0 → 0.8.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 Command21 } from "commander";
+import { Command as Command23 } from "commander";
 
 // src/commands/append.ts
 import { Command } from "commander";
@@ -598,6 +598,30 @@ function buildContentRange(content) {
   }
   return content;
 }
+async function searchAndReplace(client, pageId, updates, options) {
+  await client.pages.updateMarkdown({
+    page_id: pageId,
+    type: "update_content",
+    update_content: {
+      content_updates: updates.map((u) => ({
+        old_str: u.oldStr,
+        new_str: u.newStr,
+        ...options?.replaceAll && { replace_all_matches: true }
+      })),
+      ...options?.allowDeletingContent && { allow_deleting_content: true }
+    }
+  });
+}
+async function replacePageContent(client, pageId, newContent, options) {
+  await client.pages.updateMarkdown({
+    page_id: pageId,
+    type: "replace_content",
+    replace_content: {
+      new_str: newContent,
+      ...options?.allowDeletingContent && { allow_deleting_content: true }
+    }
+  });
+}
 async function replaceMarkdown(client, pageId, newMarkdown, options) {
   const current = await client.pages.retrieveMarkdown({ page_id: pageId });
   const currentContent = current.markdown.trim();
@@ -635,7 +659,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: {
@@ -643,7 +682,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;
@@ -713,6 +769,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 () => {
@@ -722,7 +874,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";
@@ -969,7 +1121,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)"
@@ -1032,7 +1184,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)
@@ -1045,7 +1197,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)"
@@ -1103,9 +1255,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;
@@ -1163,9 +1315,9 @@ function statusCommand() {
 }
 
 // src/commands/comment-add.ts
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 function commentAddCommand() {
-  const cmd = new Command5("comment");
+  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();
@@ -1183,74 +1335,7 @@ function commentAddCommand() {
 }
 
 // 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) {
@@ -1268,7 +1353,7 @@ async function paginateResults(fetcher) {
 
 // src/commands/comments.ts
 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");
@@ -1299,7 +1384,7 @@ function commentsCommand() {
 }
 
 // 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
@@ -1401,7 +1486,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) {
@@ -1427,40 +1512,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
@@ -1486,7 +1537,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(
@@ -1627,7 +1679,202 @@ function displayPropertyValue(prop) {
   }
 }
 
+// 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;
@@ -1655,7 +1902,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,
@@ -1710,9 +1957,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);
@@ -1736,29 +1983,59 @@ 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(
     "-m, --message <markdown>",
     "new markdown content for the page body"
   ).option(
+    "--find <text>",
+    "text to find (repeatable, pair with --replace)",
+    collect2,
+    []
+  ).option(
+    "--replace <text>",
+    "replacement text (repeatable, pair with --find)",
+    collect2,
+    []
+  ).option("--all", "replace all matches of each --find pattern").option(
     "--range <selector>",
-    'ellipsis selector to replace only a section, e.g. "## My Section...last line"'
+    '[deprecated] ellipsis selector to replace only a section, e.g. "## My Section...last line"'
   ).option(
     "--allow-deleting-content",
-    "allow deletion when using --range (always true for full-page replace)"
+    "allow deletion of child pages/databases"
   ).action(
     withErrorHandling(async (idOrUrl, opts) => {
       const { token, source } = await resolveToken();
       reportTokenSource(source);
       const client = createNotionClient(token);
-      if (opts.allowDeletingContent && !opts.range) {
-        process.stderr.write(
-          "Warning: --allow-deleting-content has no effect without --range (full-page replace always allows deletion).\n"
-        );
+      const pageId = parseNotionId(idOrUrl);
+      const uuid = toUuid(pageId);
+      if (opts.find.length > 0) {
+        if (opts.find.length !== opts.replace.length) {
+          throw new CliError(
+            ErrorCodes.INVALID_ARG,
+            `Mismatched --find/--replace: got ${opts.find.length} --find and ${opts.replace.length} --replace flags.`,
+            "Provide the same number of --find and --replace flags, paired by position."
+          );
+        }
+        const updates = opts.find.map((oldStr, i) => ({
+          oldStr,
+          newStr: opts.replace[i]
+        }));
+        await searchAndReplace(client, uuid, updates, {
+          replaceAll: opts.all ?? false,
+          allowDeletingContent: opts.allowDeletingContent ?? false
+        });
+        process.stdout.write("Page content updated.\n");
+        return;
       }
       let markdown = "";
       if (opts.message) {
@@ -1769,38 +2046,39 @@ function editPageCommand() {
           throw new CliError(
             ErrorCodes.INVALID_ARG,
             "No content provided (stdin was empty).",
-            "Pass markdown via -m/--message or pipe non-empty content through stdin"
+            "Pass content via -m/--message for full replacement, --find/--replace for targeted edits, or pipe content through stdin"
           );
         }
       } else {
         throw new CliError(
           ErrorCodes.INVALID_ARG,
           "No content provided.",
-          "Pass markdown via -m/--message or pipe it through stdin"
+          "Pass content via -m/--message for full replacement, --find/--replace for targeted edits, or pipe content through stdin"
         );
       }
-      const pageId = parseNotionId(idOrUrl);
-      const uuid = toUuid(pageId);
-      try {
-        if (opts.range) {
+      if (opts.range) {
+        try {
           await replaceMarkdown(client, uuid, markdown, {
             range: opts.range,
             allowDeletingContent: opts.allowDeletingContent ?? false
           });
-        } else {
-          await replaceMarkdown(client, uuid, markdown);
-        }
-      } catch (error2) {
-        if (opts.range && isNotionValidationError(error2)) {
-          throw new CliError(
-            ErrorCodes.INVALID_ARG,
-            `Selector not found: "${opts.range}". ${error2.message}`,
-            SELECTOR_HINT,
-            error2
-          );
+        } catch (error2) {
+          if (isNotionValidationError(error2)) {
+            throw new CliError(
+              ErrorCodes.INVALID_ARG,
+              `Selector not found: "${opts.range}". ${error2.message}`,
+              SELECTOR_HINT,
+              error2
+            );
+          }
+          throw error2;
         }
-        throw error2;
+        process.stdout.write("Page content replaced.\n");
+        return;
       }
+      await replacePageContent(client, uuid, markdown, {
+        allowDeletingContent: opts.allowDeletingContent ?? false
+      });
       process.stdout.write("Page content replaced.\n");
     })
   );
@@ -1809,7 +2087,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:",
@@ -1889,7 +2167,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) {
@@ -1907,7 +2185,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)";
@@ -1924,7 +2202,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)",
@@ -1987,10 +2265,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);
@@ -2006,9 +2284,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();
@@ -2037,9 +2315,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();
@@ -2065,9 +2343,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();
@@ -2090,7 +2368,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";
@@ -2230,7 +2508,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);
@@ -2256,7 +2534,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)";
@@ -2276,7 +2554,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)",
@@ -2333,8 +2611,72 @@ function searchCommand() {
   return cmd;
 }
 
+// src/commands/update.ts
+import { Command as Command21 } from "commander";
+function collectProps2(val, acc) {
+  acc.push(val);
+  return acc;
+}
+function updateCommand() {
+  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)",
+    collectProps2,
+    []
+  ).option("--title <title>", "set the page title").action(
+    withErrorHandling(async (idOrUrl, opts) => {
+      if (opts.title === void 0 && opts.prop.length === 0) {
+        throw new CliError(
+          ErrorCodes.INVALID_ARG,
+          "No properties to update.",
+          'Provide at least one --prop "Name=Value" or --title "New Title"'
+        );
+      }
+      const { token, source } = await resolveToken();
+      reportTokenSource(source);
+      const client = createNotionClient(token);
+      const id = parseNotionId(idOrUrl);
+      const uuid = toUuid(id);
+      const page = await client.pages.retrieve({
+        page_id: uuid
+      });
+      const properties = buildPropertiesPayload(opts.prop, page);
+      if (opts.title !== void 0) {
+        const titleEntry = Object.entries(page.properties).find(
+          ([, prop]) => prop.type === "title"
+        );
+        if (!titleEntry) {
+          throw new CliError(
+            ErrorCodes.INVALID_ARG,
+            "This page has no title property.",
+            "Use --prop to set properties by name instead"
+          );
+        }
+        const [titlePropName] = titleEntry;
+        properties[titlePropName] = {
+          title: [{ type: "text", text: { content: opts.title } }]
+        };
+      }
+      const updatedPage = await updatePageProperties(
+        client,
+        uuid,
+        properties
+      );
+      const mode = getOutputMode();
+      if (mode === "json") {
+        process.stdout.write(`${formatJSON(updatedPage)}
+`);
+      } else {
+        process.stdout.write("Page updated.\n");
+      }
+    })
+  );
+  return cmd;
+}
+
 // src/commands/users.ts
-import { Command as Command20 } from "commander";
+import { Command as Command22 } from "commander";
 function getEmailOrWorkspace(user) {
   if (user.type === "person") {
     return user.person.email ?? "\u2014";
@@ -2346,7 +2688,7 @@ function getEmailOrWorkspace(user) {
   return "\u2014";
 }
 function usersCommand() {
-  const cmd = new Command20("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");
@@ -2377,7 +2719,7 @@ var __dirname = dirname(__filename);
 var pkg = JSON.parse(
   readFileSync(join3(__dirname, "../package.json"), "utf-8")
 );
-var program = new Command21();
+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({
@@ -2398,7 +2740,7 @@ program.hook("preAction", (thisCommand) => {
     setOutputMode("md");
   }
 });
-var authCmd = new Command21("auth").description("manage Notion authentication");
+var authCmd = new Command23("auth").description("manage Notion authentication");
 authCmd.action(authDefaultAction(authCmd));
 authCmd.addCommand(loginCommand());
 authCmd.addCommand(logoutCommand());
@@ -2408,7 +2750,7 @@ authCmd.addCommand(profileUseCommand());
 authCmd.addCommand(profileRemoveCommand());
 program.addCommand(authCmd);
 program.addCommand(initCommand(), { hidden: true });
-var profileCmd = new Command21("profile").description(
+var profileCmd = new Command23("profile").description(
   "manage authentication profiles"
 );
 profileCmd.addCommand(profileListCommand());
@@ -2425,7 +2767,9 @@ program.addCommand(commentAddCommand());
 program.addCommand(appendCommand());
 program.addCommand(createPageCommand());
 program.addCommand(editPageCommand());
-var dbCmd = new Command21("db").description("Database operations");
+program.addCommand(updateCommand());
+program.addCommand(archiveCommand());
+var dbCmd = new Command23("db").description("Database operations");
 dbCmd.addCommand(dbSchemaCommand());
 dbCmd.addCommand(dbQueryCommand());
 program.addCommand(dbCmd);