@andrzejchm/notion-cli 0.11.0 → 0.13.0

package/dist/cli.js

@@ -4,7 +4,7 @@
 import { readFileSync as readFileSync2 } from "fs";
 import { dirname as dirname2, join as join4 } from "path";
 import { fileURLToPath } from "url";
-import { Command as Command26 } from "commander";
+import { Command as Command30 } from "commander";
 
 // src/commands/append.ts
 import { Command } from "commander";
@@ -451,9 +451,24 @@ function isNotionValidationError(error2) {
 }
 
 // src/notion/client.ts
-import { APIErrorCode, Client, isNotionClientError } from "@notionhq/client";
+import {
+  APIErrorCode,
+  Client,
+  isNotionClientError,
+  LogLevel
+} from "@notionhq/client";
+var stderrLogger = (level, message, extraInfo) => {
+  process.stderr.write(
+    `[notion-sdk] ${level}: ${message} ${JSON.stringify(extraInfo)}
+`
+  );
+};
 async function validateToken(token) {
-  const notion = new Client({ auth: token });
+  const notion = new Client({
+    auth: token,
+    logLevel: LogLevel.WARN,
+    logger: stderrLogger
+  });
   try {
     const me = await notion.users.me({});
     const bot = me;
@@ -473,7 +488,12 @@ async function validateToken(token) {
   }
 }
 function createNotionClient(token) {
-  return new Client({ auth: token, timeoutMs: 12e4 });
+  return new Client({
+    auth: token,
+    timeoutMs: 12e4,
+    logLevel: LogLevel.WARN,
+    logger: stderrLogger
+  });
 }
 
 // src/notion/url-parser.ts
@@ -542,7 +562,196 @@ function reportTokenSource(source) {
   stderrWrite(dim(`Using token from ${source}`));
 }
 
+// src/services/upload.service.ts
+import { createReadStream, existsSync, statSync } from "fs";
+import { basename, extname } from "path";
+var PART_SIZE = 20 * 1024 * 1024;
+var MIME_MAP = {
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".svg": "image/svg+xml",
+  ".bmp": "image/bmp",
+  ".ico": "image/x-icon",
+  ".tiff": "image/tiff",
+  ".tif": "image/tiff",
+  ".heic": "image/heic",
+  ".avif": "image/avif",
+  ".pdf": "application/pdf",
+  ".mp3": "audio/mpeg",
+  ".wav": "audio/wav",
+  ".ogg": "audio/ogg",
+  ".m4a": "audio/mp4",
+  ".flac": "audio/flac",
+  ".aac": "audio/aac",
+  ".mp4": "video/mp4",
+  ".mov": "video/quicktime",
+  ".avi": "video/x-msvideo",
+  ".webm": "video/webm",
+  ".mkv": "video/x-matroska",
+  ".csv": "text/csv",
+  ".json": "application/json",
+  ".txt": "text/plain",
+  ".md": "text/markdown",
+  ".html": "text/html",
+  ".xml": "application/xml",
+  ".zip": "application/zip",
+  ".gz": "application/gzip",
+  ".doc": "application/msword",
+  ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  ".xls": "application/vnd.ms-excel",
+  ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  ".ppt": "application/vnd.ms-powerpoint",
+  ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation"
+};
+function detectMimeType(filePath) {
+  const ext = extname(filePath).toLowerCase();
+  return MIME_MAP[ext] ?? "application/octet-stream";
+}
+function resolveBlockType(contentType) {
+  const base = contentType.split(";")[0].trim().toLowerCase();
+  if (base.startsWith("image/")) return "image";
+  if (base.startsWith("audio/")) return "audio";
+  if (base.startsWith("video/")) return "video";
+  if (base === "application/pdf") return "pdf";
+  return "file";
+}
+async function readStreamChunk(filePath, start, end) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    const stream = createReadStream(filePath, { start, end });
+    stream.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
+    stream.on("end", () => resolve(Buffer.concat(chunks)));
+    stream.on("error", reject);
+  });
+}
+async function uploadSinglePart(client, filePath, filename, contentType, fileSize) {
+  const upload = await client.fileUploads.create({
+    mode: "single_part",
+    filename,
+    content_type: contentType
+  });
+  const data = await readStreamChunk(filePath, 0, fileSize - 1);
+  const blob = new Blob(
+    [
+      data.buffer.slice(
+        data.byteOffset,
+        data.byteOffset + data.byteLength
+      )
+    ],
+    { type: contentType }
+  );
+  await client.fileUploads.send({
+    file_upload_id: upload.id,
+    file: { data: blob, filename }
+  });
+  return upload.id;
+}
+async function uploadMultiPart(client, filePath, filename, contentType, fileSize) {
+  const numberOfParts = Math.ceil(fileSize / PART_SIZE);
+  const upload = await client.fileUploads.create({
+    mode: "multi_part",
+    filename,
+    content_type: contentType,
+    number_of_parts: numberOfParts
+  });
+  for (let part = 0; part < numberOfParts; part++) {
+    const start = part * PART_SIZE;
+    const end = Math.min(start + PART_SIZE, fileSize) - 1;
+    const data = await readStreamChunk(filePath, start, end);
+    const blob = new Blob(
+      [
+        data.buffer.slice(
+          data.byteOffset,
+          data.byteOffset + data.byteLength
+        )
+      ],
+      { type: contentType }
+    );
+    await client.fileUploads.send({
+      file_upload_id: upload.id,
+      file: { data: blob, filename },
+      part_number: String(part + 1)
+    });
+  }
+  await client.fileUploads.complete({ file_upload_id: upload.id });
+  return upload.id;
+}
+async function uploadFile(client, filePath) {
+  const filename = basename(filePath);
+  const contentType = detectMimeType(filePath);
+  const { size: fileSize } = statSync(filePath);
+  if (fileSize === 0) {
+    throw new CliError(
+      ErrorCodes.INVALID_ARG,
+      `Cannot upload empty file: ${filename}`,
+      "Provide a file with content"
+    );
+  }
+  const fileUploadId = fileSize <= PART_SIZE ? await uploadSinglePart(
+    client,
+    filePath,
+    filename,
+    contentType,
+    fileSize
+  ) : await uploadMultiPart(
+    client,
+    filePath,
+    filename,
+    contentType,
+    fileSize
+  );
+  return { fileUploadId, filename, contentType };
+}
+function buildFileBlock(fileUploadId, blockType, caption) {
+  const captionRichText = caption ? [{ type: "text", text: { content: caption } }] : [];
+  const fileContent = {
+    file_upload: { id: fileUploadId },
+    type: "file_upload",
+    caption: captionRichText
+  };
+  switch (blockType) {
+    case "image":
+      return { type: "image", image: fileContent };
+    case "audio":
+      return { type: "audio", audio: fileContent };
+    case "video":
+      return { type: "video", video: fileContent };
+    case "pdf":
+      return { type: "pdf", pdf: fileContent };
+    case "file":
+      return { type: "file", file: fileContent };
+    default:
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Unknown block type: ${blockType}`,
+        "Valid types are: image, file, pdf, audio, video"
+      );
+  }
+}
+async function uploadFilesAsBlocks(files, opts, client) {
+  for (const filePath of files) {
+    if (!existsSync(filePath)) {
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `File not found: ${filePath}`,
+        "Provide a valid file path"
+      );
+    }
+  }
+  return Promise.all(
+    files.map(async (filePath) => {
+      const result = await uploadFile(client, filePath);
+      const blockType = opts.type ?? resolveBlockType(result.contentType);
+      return buildFileBlock(result.fileUploadId, blockType, opts.caption);
+    })
+  );
+}
+
 // src/services/write.service.ts
+import { existsSync as existsSync2 } from "fs";
 async function addComment(client, target, text, options = {}) {
   const richText = [
     {
@@ -661,22 +870,44 @@ async function replaceMarkdown(client, pageId, newMarkdown, options) {
     }
   });
 }
-function buildIconCover(options) {
+async function buildIconCover(client, options) {
   const result = {};
   if (options?.icon) {
     const isUrl = /^https?:\/\//i.test(options.icon);
     if (isUrl) {
       result.icon = { type: "external", external: { url: options.icon } };
+    } else if (existsSync2(options.icon)) {
+      const uploaded = await uploadFile(client, options.icon);
+      result.icon = {
+        type: "file_upload",
+        file_upload: { id: uploaded.fileUploadId }
+      };
     } else {
       result.icon = { type: "emoji", emoji: options.icon };
     }
   }
   if (options?.cover) {
-    result.cover = { type: "external", external: { url: options.cover } };
+    const isUrl = /^https?:\/\//i.test(options.cover);
+    if (isUrl) {
+      result.cover = { type: "external", external: { url: options.cover } };
+    } else if (existsSync2(options.cover)) {
+      const uploaded = await uploadFile(client, options.cover);
+      result.cover = {
+        type: "file_upload",
+        file_upload: { id: uploaded.fileUploadId }
+      };
+    } else {
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Cover not found: "${options.cover}" is not a valid URL or existing file path.`,
+        "Provide an http(s):// URL or a valid local file path for --cover"
+      );
+    }
   }
   return result;
 }
 async function createPage(client, parentId, title, markdown, options) {
+  const iconCover = await buildIconCover(client, options);
   const response = await client.pages.create({
     parent: { type: "page_id", page_id: parentId },
     properties: {
@@ -685,7 +916,7 @@ async function createPage(client, parentId, title, markdown, options) {
       }
     },
     ...markdown.trim() ? { markdown } : {},
-    ...buildIconCover(options)
+    ...iconCover
   });
   const url = "url" in response ? response.url : response.id;
   return url;
@@ -697,11 +928,12 @@ async function createPageInDatabase(client, databaseId, titlePropName, title, ex
       title: [{ type: "text", text: { content: title, link: null } }]
     }
   };
+  const iconCover = await buildIconCover(client, options);
   const response = await client.pages.create({
     parent: { type: "database_id", database_id: databaseId },
     properties,
     ...markdown.trim() ? { markdown } : {},
-    ...buildIconCover(options)
+    ...iconCover
   });
   const url = "url" in response ? response.url : response.id;
   return url;
@@ -717,54 +949,92 @@ async function readStdin() {
 }
 
 // src/commands/append.ts
+function collectFiles(val, acc) {
+  acc.push(val);
+  return acc;
+}
+async function resolveMarkdown(message, hasFiles) {
+  if (message) return message;
+  if (!process.stdin.isTTY && !hasFiles) return readStdin();
+  if (!hasFiles) {
+    throw new CliError(
+      ErrorCodes.INVALID_ARG,
+      "No content to append.",
+      "Pass markdown via -m/--message, pipe it through stdin, or use --file to attach files"
+    );
+  }
+  return "";
+}
+async function appendMarkdownWithErrorHandling(client, uuid, markdown, after) {
+  try {
+    await appendMarkdown(client, uuid, markdown, after ? { after } : void 0);
+  } catch (error2) {
+    if (after && isNotionValidationError(error2)) {
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Selector not found: "${after}". ${error2.message}`,
+        SELECTOR_HINT,
+        error2
+      );
+    }
+    throw error2;
+  }
+}
+async function appendFileBlocks(client, uuid, filePaths) {
+  const blocks = await uploadFilesAsBlocks(filePaths, {}, client);
+  await client.blocks.children.append({
+    block_id: uuid,
+    children: blocks
+  });
+}
 function appendCommand() {
   const cmd = new Command("append");
   cmd.description("append markdown content to a Notion page").argument("<id/url>", "Notion page ID or URL").option("-m, --message <markdown>", "markdown content to append").option(
     "--after <selector>",
     'insert after matched content \u2014 ellipsis selector, e.g. "## Section...end of section"'
+  ).option(
+    "--file <path>",
+    "attach a local file to the page (repeatable)",
+    collectFiles,
+    []
   ).action(
     withErrorHandling(
       async (idOrUrl, 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();
-        } else {
+        const hasFiles = opts.file.length > 0;
+        const markdown = await resolveMarkdown(opts.message, hasFiles);
+        const uuid = toUuid(parseNotionId(idOrUrl));
+        if (opts.after && !markdown.trim()) {
           throw new CliError(
             ErrorCodes.INVALID_ARG,
-            "No content to append.",
-            "Pass markdown via -m/--message or pipe it through stdin"
+            "--after requires markdown content (-m or stdin)",
+            "Provide markdown via -m/--message or pipe it through stdin"
           );
         }
-        if (!markdown.trim()) {
-          process.stdout.write("Nothing to append.\n");
-          return;
-        }
-        const pageId = parseNotionId(idOrUrl);
-        const uuid = toUuid(pageId);
-        try {
-          await appendMarkdown(
+        if (markdown.trim()) {
+          await appendMarkdownWithErrorHandling(
             client,
             uuid,
             markdown,
-            opts.after ? { after: opts.after } : void 0
+            opts.after
           );
-        } catch (error2) {
-          if (opts.after && isNotionValidationError(error2)) {
-            throw new CliError(
-              ErrorCodes.INVALID_ARG,
-              `Selector not found: "${opts.after}". ${error2.message}`,
-              SELECTOR_HINT,
-              error2
-            );
-          }
-          throw error2;
         }
-        process.stdout.write("Appended.\n");
+        if (hasFiles) {
+          await appendFileBlocks(client, uuid, opts.file);
+        }
+        if (hasFiles && markdown.trim()) {
+          process.stdout.write(
+            `Appended and attached ${opts.file.length} file(s).
+`
+          );
+        } else if (hasFiles) {
+          process.stdout.write(`Attached ${opts.file.length} file(s).
+`);
+        } else {
+          process.stdout.write("Appended.\n");
+        }
       }
     )
   );
@@ -842,31 +1112,96 @@ function printWithPager(text) {
 }
 
 // src/commands/archive.ts
+async function archiveEntity(client, uuid) {
+  try {
+    const result2 = await client.pages.update({
+      page_id: uuid,
+      in_trash: true
+    });
+    return { result: result2, kind: "page" };
+  } catch {
+  }
+  try {
+    const result2 = await client.dataSources.update({
+      data_source_id: uuid,
+      in_trash: true
+    });
+    return { result: result2, kind: "data_source" };
+  } catch {
+  }
+  const result = await client.databases.update({
+    database_id: uuid,
+    in_trash: true
+  });
+  return { result, kind: "database" };
+}
 function archiveCommand() {
   const cmd = new Command2("archive");
-  cmd.description("archive (trash) a Notion page").argument("<id/url>", "Notion page ID or URL").action(
+  cmd.description("archive (trash) a Notion page or database").argument("<id/url>", "Notion page or database ID/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 { result, kind } = await archiveEntity(client, uuid);
       const mode = getOutputMode();
       if (mode === "json") {
-        process.stdout.write(`${formatJSON(updatedPage)}
+        process.stdout.write(`${formatJSON(result)}
 `);
       } else {
-        process.stdout.write("Page archived.\n");
+        const label = kind === "page" ? "Page" : "Database";
+        process.stdout.write(`${label} archived.
+`);
       }
     })
   );
   return cmd;
 }
 
+// src/commands/attach.ts
+import { Command as Command3, Option } from "commander";
+function attachCommand() {
+  const cmd = new Command3("attach");
+  cmd.description("upload and attach file(s) to a Notion page").argument("<id/url>", "Notion page ID or URL").argument("<file>", "file to attach").argument("[files...]", "additional files to attach").option("--caption <text>", "caption for the file block(s)").addOption(
+    new Option(
+      "--type <type>",
+      "override auto-detected block type (image|file|pdf|audio|video)"
+    ).choices(["image", "file", "pdf", "audio", "video"])
+  ).action(
+    withErrorHandling(
+      async (idOrUrl, firstFile, extraFiles, opts) => {
+        const { token, source } = await resolveToken();
+        reportTokenSource(source);
+        const client = createNotionClient(token);
+        const pageId = toUuid(parseNotionId(idOrUrl));
+        const allFiles = [firstFile, ...extraFiles];
+        const blocks = await uploadFilesAsBlocks(
+          allFiles,
+          { caption: opts.caption, type: opts.type },
+          client
+        );
+        const response = await client.blocks.children.append({
+          block_id: pageId,
+          children: blocks
+        });
+        const mode = getOutputMode();
+        if (mode === "json") {
+          process.stdout.write(`${formatJSON(response)}
+`);
+        } else {
+          const pageUrl = `https://www.notion.so/${parseNotionId(idOrUrl)}`;
+          process.stdout.write(
+            `Attached ${allFiles.length} file(s) to ${pageUrl}
+`
+          );
+        }
+      }
+    )
+  );
+  return cmd;
+}
+
 // src/commands/auth/index.ts
 function authDefaultAction(authCmd2) {
   return async () => {
@@ -876,7 +1211,7 @@ function authDefaultAction(authCmd2) {
 
 // src/commands/auth/login.ts
 import { input } from "@inquirer/prompts";
-import { Command as Command3 } from "commander";
+import { Command as Command4 } from "commander";
 
 // src/oauth/oauth-flow.ts
 import { spawn } from "child_process";
@@ -1123,7 +1458,7 @@ Waiting for callback (up to 120 seconds)...
 
 // src/commands/auth/login.ts
 function loginCommand() {
-  const cmd = new Command3("login");
+  const cmd = new Command4("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)"
@@ -1186,7 +1521,7 @@ function loginCommand() {
 
 // src/commands/auth/logout.ts
 import { select } from "@inquirer/prompts";
-import { Command as Command4 } from "commander";
+import { Command as Command5 } from "commander";
 function profileLabel(name, profile) {
   const parts = [];
   if (profile.oauth_access_token)
@@ -1199,7 +1534,7 @@ function profileLabel(name, profile) {
   return `${bold(name)}  ${dim(authDesc)}${workspace}`;
 }
 function logoutCommand() {
-  const cmd = new Command4("logout");
+  const cmd = new Command5("logout");
   cmd.description("remove a profile and its credentials").option(
     "--profile <name>",
     "profile name to remove (skips interactive selector)"
@@ -1257,9 +1592,9 @@ function logoutCommand() {
 }
 
 // src/commands/auth/status.ts
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 function statusCommand() {
-  const cmd = new Command5("status");
+  const cmd = new Command6("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;
@@ -1317,7 +1652,7 @@ function statusCommand() {
 }
 
 // src/commands/comment-add.ts
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 function resolveTarget(idOrUrl, opts) {
   const targetCount = [idOrUrl, opts.replyTo, opts.block].filter(
     Boolean
@@ -1345,7 +1680,7 @@ function resolveTarget(idOrUrl, opts) {
   );
 }
 function commentAddCommand() {
-  const cmd = new Command6("comment");
+  const cmd = new Command7("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"
@@ -1367,7 +1702,7 @@ function commentAddCommand() {
 }
 
 // src/commands/comments.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 
 // src/output/paginate.ts
 async function paginateResults(fetcher) {
@@ -1393,7 +1728,7 @@ function formatParent(parent) {
   }
 }
 function commentsCommand() {
-  const cmd = new Command7("comments");
+  const cmd = new Command8("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");
@@ -1430,7 +1765,7 @@ function commentsCommand() {
 }
 
 // src/commands/completion.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 var BASH_COMPLETION = `# notion bash completion
 _notion_completion() {
   local cur prev words cword
@@ -1534,7 +1869,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 Command8("completion");
+  const cmd = new Command9("completion");
   cmd.description("output shell completion script").argument("<shell>", "shell type (bash, zsh, fish)").action(
     withErrorHandling(async (shell) => {
       switch (shell) {
@@ -1560,13 +1895,14 @@ function completionCommand() {
 }
 
 // src/commands/create-page.ts
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 
 // src/services/database.service.ts
 import { isFullPage } from "@notionhq/client";
 async function fetchDatabaseSchema(client, dbId) {
-  const ds = await client.dataSources.retrieve({ data_source_id: dbId });
-  const title = "title" in ds ? ds.title.map((rt) => rt.plain_text).join("") || dbId : dbId;
+  const resolvedId = await resolveDataSourceId(client, dbId);
+  const ds = await client.dataSources.retrieve({ data_source_id: resolvedId });
+  const title = "title" in ds ? ds.title.map((rt) => rt.plain_text).join("") || resolvedId : resolvedId;
   const properties = {};
   if ("properties" in ds) {
     for (const [name, prop] of Object.entries(ds.properties)) {
@@ -1585,8 +1921,8 @@ async function fetchDatabaseSchema(client, dbId) {
       properties[name] = config;
     }
   }
-  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 };
+  const databaseId = "parent" in ds && ds.parent && typeof ds.parent === "object" && "database_id" in ds.parent ? ds.parent.database_id : resolvedId;
+  return { id: resolvedId, databaseId, title, properties };
 }
 async function queryDatabase(client, dbId, opts = {}) {
   const rawPages = await paginateResults(
@@ -1806,6 +2142,81 @@ async function resolveDataSourceId(client, idOrUrl) {
     `Could not find database or data source: ${id}`
   );
 }
+function buildDatabaseUpdatePayload(opts, schema) {
+  const properties = {};
+  for (const def of opts.addProps) {
+    const { name, config } = parsePropertyDefinition(def);
+    properties[name] = config;
+  }
+  for (const name of opts.removeProps) {
+    properties[name] = null;
+  }
+  for (const raw of opts.renameProps) {
+    const colonIdx = raw.indexOf(":");
+    if (colonIdx === -1) {
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Invalid rename format: "${raw}"`,
+        'Use format: --rename-prop "OldName:NewName"'
+      );
+    }
+    const oldName = raw.slice(0, colonIdx).trim();
+    const newName = raw.slice(colonIdx + 1).trim();
+    const propConfig = schema.properties[oldName];
+    if (!propConfig) {
+      const available = Object.keys(schema.properties).join(", ");
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Property "${oldName}" not found in schema`,
+        `Available properties: ${available}`
+      );
+    }
+    properties[propConfig.id] = { name: newName };
+  }
+  for (const raw of opts.setOptions) {
+    const colonIdx = raw.indexOf(":");
+    if (colonIdx === -1) {
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Invalid set-options format: "${raw}"`,
+        'Use format: --set-options "PropertyName:opt1,opt2,opt3"'
+      );
+    }
+    const propName = raw.slice(0, colonIdx).trim();
+    const optionsStr = raw.slice(colonIdx + 1).trim();
+    const propConfig = schema.properties[propName];
+    if (!propConfig) {
+      const available = Object.keys(schema.properties).join(", ");
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Property "${propName}" not found in schema`,
+        `Available properties: ${available}`
+      );
+    }
+    if (propConfig.type !== "select" && propConfig.type !== "multi_select") {
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Property "${propName}" is of type "${propConfig.type}" \u2014 only select and multi_select properties support --set-options`
+      );
+    }
+    const options = optionsStr.split(",").map((opt) => ({ name: opt.trim() }));
+    properties[propName] = { [propConfig.type]: { options } };
+  }
+  const payload = {};
+  if (opts.title !== void 0) {
+    payload.title = [{ type: "text", text: { content: opts.title } }];
+  }
+  if (Object.keys(properties).length > 0) {
+    payload.properties = properties;
+  }
+  return payload;
+}
+async function updateDatabaseSchema(client, dataSourceId, payload) {
+  return client.dataSources.update({
+    data_source_id: dataSourceId,
+    ...payload
+  });
+}
 function displayPropertyValue(prop) {
   switch (prop.type) {
     case "title":
@@ -1848,6 +2259,7 @@ function displayPropertyValue(prop) {
 }
 
 // src/services/update.service.ts
+import { existsSync as existsSync3 } from "fs";
 var UNSUPPORTED_TYPES = /* @__PURE__ */ new Set([
   "relation",
   "formula",
@@ -1856,7 +2268,6 @@ var UNSUPPORTED_TYPES = /* @__PURE__ */ new Set([
   "created_by",
   "last_edited_time",
   "last_edited_by",
-  "files",
   "unique_id",
   "verification",
   "button"
@@ -1866,7 +2277,7 @@ function buildPropertyUpdate(propName, propType, value) {
     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"
+      "Supported types: title, rich_text, select, status, multi_select, number, checkbox, url, email, phone_number, date, files"
     );
   }
   if (value === "") {
@@ -1912,41 +2323,54 @@ function buildPropertyUpdate(propName, propType, value) {
       const end = parts[1]?.trim();
       return { date: end ? { start, end } : { start } };
     }
+    case "files":
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Property "${propName}" has type "files" which requires async upload \u2014 use buildPropertiesPayloadAsync instead.`,
+        "Use buildPropertiesPayloadAsync with a Notion client to handle file uploads"
+      );
     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"
+        "Supported types: title, rich_text, select, status, multi_select, number, checkbox, url, email, phone_number, date, files"
       );
   }
 }
-function buildPropertiesPayload(propStrings, schemaOrPage) {
+function normalizeSchema(schemaOrPage) {
   const isPage = "object" in schemaOrPage && schemaOrPage.object === "page";
-  const schema = isPage ? schemaOrPage.properties : schemaOrPage;
+  return isPage ? schemaOrPage.properties : schemaOrPage;
+}
+function parsePropString(propString) {
+  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"'
+    );
+  }
+  return [propString.slice(0, eqIdx).trim(), propString.slice(eqIdx + 1)];
+}
+function lookupSchemaProp(propName, schema) {
+  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}`
+    );
+  }
+  return schemaProp;
+}
+function buildPropertiesPayload(propStrings, schemaOrPage) {
+  const schema = normalizeSchema(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;
+    const [propName, value] = parsePropString(propString);
+    const schemaProp = lookupSchemaProp(propName, schema);
+    result[propName] = buildPropertyUpdate(propName, schemaProp.type, value);
   }
   return result;
 }
@@ -1959,7 +2383,7 @@ async function updatePageProperties(client, pageId, properties) {
 }
 
 // src/commands/create-page.ts
-function collectProps(val, acc) {
+function collectValues(val, acc) {
   acc.push(val);
   return acc;
 }
@@ -1971,16 +2395,21 @@ async function tryGetDatabaseSchema(client, uuid) {
   }
 }
 function createPageCommand() {
-  const cmd = new Command9("create-page");
+  const cmd = new Command10("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,
+    collectValues,
+    []
+  ).option("--icon <emoji-or-url>", "page icon \u2014 emoji character or image URL").option("--cover <url>", "page cover image URL").option(
+    "--file <path>",
+    "attach a local file to the page after creation (repeatable)",
+    collectValues,
     []
-  ).option("--icon <emoji-or-url>", "page icon \u2014 emoji character or image URL").option("--cover <url>", "page cover image URL").action(
+  ).action(
     withErrorHandling(async (opts) => {
       const { token, source } = await resolveToken();
       reportTokenSource(source);
@@ -1988,12 +2417,13 @@ function createPageCommand() {
       let markdown = "";
       if (opts.message) {
         markdown = opts.message;
-      } else if (!process.stdin.isTTY) {
+      } else if (!process.stdin.isTTY && opts.file.length === 0) {
         markdown = await readStdin();
       }
       const parentUuid = toUuid(parseNotionId(opts.parent));
       const iconCover = { icon: opts.icon, cover: opts.cover };
       const dbSchema = await tryGetDatabaseSchema(client, parentUuid);
+      let createdPageUrl;
       if (dbSchema) {
         const titleEntry = Object.entries(dbSchema.properties).find(
           ([, prop]) => prop.type === "title"
@@ -2007,7 +2437,7 @@ function createPageCommand() {
         }
         const [titlePropName] = titleEntry;
         const extraProperties = opts.prop.length > 0 ? buildPropertiesPayload(opts.prop, dbSchema.properties) : {};
-        const url = await createPageInDatabase(
+        createdPageUrl = await createPageInDatabase(
           client,
           dbSchema.databaseId,
           titlePropName,
@@ -2016,8 +2446,6 @@ function createPageCommand() {
           markdown,
           iconCover
         );
-        process.stdout.write(`${url}
-`);
       } else {
         if (opts.prop.length > 0) {
           throw new CliError(
@@ -2026,32 +2454,40 @@ function createPageCommand() {
             "To set properties, use a database ID/URL as --parent"
           );
         }
-        const url = await createPage(
+        createdPageUrl = await createPage(
           client,
           parentUuid,
           opts.title,
           markdown,
           iconCover
         );
-        process.stdout.write(`${url}
-`);
       }
+      if (opts.file.length > 0) {
+        const createdPageId = toUuid(parseNotionId(createdPageUrl));
+        const blocks = await uploadFilesAsBlocks(opts.file, {}, client);
+        await client.blocks.children.append({
+          block_id: createdPageId,
+          children: blocks
+        });
+      }
+      process.stdout.write(`${createdPageUrl}
+`);
     })
   );
   return cmd;
 }
 
 // src/commands/db/create.ts
-import { Command as Command10 } from "commander";
-function collectProps2(val, acc) {
+import { Command as Command11 } from "commander";
+function collectProps(val, acc) {
   acc.push(val);
   return acc;
 }
 function dbCreateCommand() {
-  return new Command10("create").description("Create a new database under a parent page").requiredOption("--parent <id/url>", "parent page ID or URL").requiredOption("--title <title>", "database title").option(
+  return new Command11("create").description("Create a new database under a parent page").requiredOption("--parent <id/url>", "parent page ID or URL").requiredOption("--title <title>", "database title").option(
     "--prop <definition>",
     'property definition (repeatable): --prop "Name:type:options"',
-    collectProps2,
+    collectProps,
     []
   ).action(
     withErrorHandling(async (opts) => {
@@ -2080,7 +2516,7 @@ function dbCreateCommand() {
 }
 
 // src/commands/db/query.ts
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 var SKIP_TYPES_IN_AUTO = /* @__PURE__ */ new Set(["relation", "rich_text", "people"]);
 function autoSelectColumns(schema, entries) {
   const termWidth = process.stdout.columns || 120;
@@ -2108,7 +2544,7 @@ function autoSelectColumns(schema, entries) {
   return selected;
 }
 function dbQueryCommand() {
-  return new Command11("query").description("Query database entries with optional filtering and sorting").argument("<id>", "Notion database ID or URL").option(
+  return new Command12("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,
@@ -2163,9 +2599,9 @@ function collect(value, previous) {
 }
 
 // src/commands/db/schema.ts
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 function dbSchemaCommand() {
-  return new Command12("schema").description("Show database schema (property names, types, and options)").argument("<id>", "Notion database ID or URL").action(
+  return new Command13("schema").description("Show database schema (property names, types, and options)").argument("<id>", "Notion database ID or URL").action(
     withErrorHandling(async (id) => {
       const { token } = await resolveToken();
       const client = createNotionClient(token);
@@ -2188,14 +2624,210 @@ function dbSchemaCommand() {
   );
 }
 
+// src/commands/db/update.ts
+import { Command as Command14 } from "commander";
+function collectProps2(val, acc) {
+  acc.push(val);
+  return acc;
+}
+function dbUpdateCommand() {
+  return new Command14("update").description(
+    "Update database schema (add/remove/rename properties, manage options)"
+  ).argument("<id/url>", "database ID or URL").option(
+    "--add-prop <definition>",
+    'add property (repeatable): --add-prop "Name:type:options"',
+    collectProps2,
+    []
+  ).option(
+    "--remove-prop <name>",
+    "remove property (repeatable)",
+    collectProps2,
+    []
+  ).option(
+    "--rename-prop <old:new>",
+    'rename property (repeatable): --rename-prop "Old:New"',
+    collectProps2,
+    []
+  ).option(
+    "--set-options <prop:opts>",
+    'set select/multi_select options (repeatable): --set-options "Status:A,B,C"',
+    collectProps2,
+    []
+  ).option("--title <title>", "update database title").action(
+    withErrorHandling(async (id, opts) => {
+      const hasOperations = opts.addProp.length > 0 || opts.removeProp.length > 0 || opts.renameProp.length > 0 || opts.setOptions.length > 0 || opts.title !== void 0;
+      if (!hasOperations) {
+        throw new CliError(
+          ErrorCodes.INVALID_ARG,
+          "No update operations specified",
+          "Provide at least one of: --add-prop, --remove-prop, --rename-prop, --set-options, --title"
+        );
+      }
+      const { token, source } = await resolveToken();
+      reportTokenSource(source);
+      const client = createNotionClient(token);
+      const dsId = await resolveDataSourceId(client, id);
+      const needsSchema = opts.renameProp.length > 0 || opts.setOptions.length > 0;
+      const schema = needsSchema ? await fetchDatabaseSchema(client, dsId) : { id: dsId, databaseId: dsId, title: "", properties: {} };
+      const payload = buildDatabaseUpdatePayload(
+        {
+          addProps: opts.addProp,
+          removeProps: opts.removeProp,
+          renameProps: opts.renameProp,
+          setOptions: opts.setOptions,
+          title: opts.title
+        },
+        schema
+      );
+      const response = await updateDatabaseSchema(client, dsId, payload);
+      if (getOutputMode() === "json") {
+        process.stdout.write(`${formatJSON(response)}
+`);
+        return;
+      }
+      if ("url" in response) {
+        process.stdout.write(`${response.url}
+`);
+      }
+    })
+  );
+}
+
+// src/commands/db/update-rows.ts
+import { Command as Command15 } from "commander";
+var LARGE_BATCH_WARNING_THRESHOLD = 10;
+var DEFAULT_CONCURRENCY = 3;
+function collectProps3(val, acc) {
+  acc.push(val);
+  return acc;
+}
+async function batchUpdate(items, fn, concurrency = DEFAULT_CONCURRENCY) {
+  const results = [];
+  for (let i = 0; i < items.length; i += concurrency) {
+    const batch = items.slice(i, i + concurrency);
+    results.push(...await Promise.all(batch.map(fn)));
+  }
+  return results;
+}
+function getPageTitle(page) {
+  for (const prop of Object.values(page.properties)) {
+    if (prop.type === "title") {
+      return prop.title.map((r) => r.plain_text).join("") || page.id;
+    }
+  }
+  return page.id;
+}
+function dbUpdateRowsCommand() {
+  return new Command15("update-rows").description("Update properties on all matching rows in a database").argument("<id>", "Notion database ID or URL").option(
+    "--filter <filter>",
+    'Filter rows (repeatable): --filter "Status=Done"',
+    collectProps3,
+    []
+  ).option(
+    "--prop <property=value>",
+    "Set a property value on matching rows (repeatable, required)",
+    collectProps3,
+    []
+  ).option("--dry-run", "Preview matching rows without making changes", false).action(
+    withErrorHandling(async (id, opts) => {
+      if (opts.prop.length === 0) {
+        throw new CliError(
+          ErrorCodes.INVALID_ARG,
+          "No properties to update.",
+          'Provide at least one --prop "Name=Value"'
+        );
+      }
+      const { token } = await resolveToken();
+      const client = createNotionClient(token);
+      const dsId = await resolveDataSourceId(client, id);
+      const schema = await fetchDatabaseSchema(client, dsId);
+      const filter = opts.filter.length ? buildFilter(opts.filter, schema) : void 0;
+      const entries = await queryDatabase(client, dsId, { filter });
+      if (opts.filter.length === 0 && entries.length > LARGE_BATCH_WARNING_THRESHOLD) {
+        process.stderr.write(
+          `Warning: no --filter specified \u2014 ${entries.length} rows will be updated.
+`
+        );
+      }
+      if (opts.dryRun) {
+        process.stderr.write(
+          `Dry run: would update ${entries.length} row(s).
+`
+        );
+        const lines = entries.map((e) => `${e.id}	${getPageTitle(e.raw)}`).join("\n");
+        if (entries.length > 0) {
+          process.stdout.write(`${lines}
+`);
+        }
+        return;
+      }
+      const results = await batchUpdate(entries, async (entry) => {
+        const title = getPageTitle(entry.raw);
+        try {
+          const properties = buildPropertiesPayload(
+            opts.prop,
+            entry.raw
+          );
+          await updatePageProperties(client, entry.id, properties);
+          return { id: entry.id, title, success: true };
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          return { id: entry.id, title, success: false, error: message };
+        }
+      });
+      const successCount = results.filter((r) => r.success).length;
+      const failureCount = results.length - successCount;
+      if (getOutputMode() === "json") {
+        process.stdout.write(`${formatJSON(results)}
+`);
+        return;
+      }
+      process.stdout.write(`Updated ${successCount} row(s).
+`);
+      if (failureCount > 0) {
+        process.stderr.write(`${failureCount} row(s) failed to update.
+`);
+        for (const r of results.filter((res) => !res.success)) {
+          process.stderr.write(`  ${r.id} (${r.title}): ${r.error}
+`);
+        }
+      }
+    })
+  );
+}
+
+// src/commands/delete-block.ts
+import { Command as Command16 } from "commander";
+function deleteBlockCommand() {
+  const cmd = new Command16("delete-block");
+  cmd.description("delete a Notion block by ID or URL").argument("<id/url>", "Notion block 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 deletedBlock = await client.blocks.delete({ block_id: uuid });
+      const mode = getOutputMode();
+      if (mode === "json") {
+        process.stdout.write(`${formatJSON(deletedBlock)}
+`);
+      } else {
+        process.stdout.write("Block deleted.\n");
+      }
+    })
+  );
+  return cmd;
+}
+
 // src/commands/edit-page.ts
-import { Command as Command13 } from "commander";
+import { Command as Command17 } from "commander";
 function collect2(val, acc) {
   acc.push(val);
   return acc;
 }
 function editPageCommand() {
-  const cmd = new Command13("edit-page");
+  const cmd = new Command17("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(
@@ -2293,7 +2925,7 @@ function editPageCommand() {
 
 // src/commands/init.ts
 import { confirm, input as input2, password } from "@inquirer/prompts";
-import { Command as Command14 } from "commander";
+import { Command as Command18 } from "commander";
 async function runInitFlow() {
   const profileName = await input2({
     message: "Profile name:",
@@ -2373,7 +3005,7 @@ async function runInitFlow() {
   stderrWrite(dim("  notion auth login"));
 }
 function initCommand() {
-  const cmd = new Command14("init");
+  const cmd = new Command18("init");
   cmd.description("authenticate with Notion and save a profile").action(
     withErrorHandling(async () => {
       if (!process.stdin.isTTY) {
@@ -2391,7 +3023,7 @@ function initCommand() {
 
 // src/commands/ls.ts
 import { isFullPageOrDataSource } from "@notionhq/client";
-import { Command as Command15 } from "commander";
+import { Command as Command19 } from "commander";
 function getTitle(item) {
   if (item.object === "data_source") {
     return item.title.map((t) => t.plain_text).join("") || "(untitled)";
@@ -2408,7 +3040,7 @@ function displayType(item) {
   return item.object === "data_source" ? "database" : item.object;
 }
 function lsCommand() {
-  const cmd = new Command15("ls");
+  const cmd = new Command19("ls");
   cmd.description("list accessible Notion pages and databases").option(
     "--type <type>",
     "filter by object type (page or database)",
@@ -2457,7 +3089,11 @@ function lsCommand() {
           );
         }
         if (items.length === 0) {
-          process.stdout.write("No accessible content found\n");
+          if (getOutputMode() === "json") {
+            process.stdout.write("[]\n");
+          } else {
+            process.stdout.write("No accessible content found\n");
+          }
           return;
         }
         const headers = ["TYPE", "TITLE", "ID", "MODIFIED"];
@@ -2482,9 +3118,9 @@ function lsCommand() {
 }
 
 // src/commands/move.ts
-import { Command as Command16 } from "commander";
+import { Command as Command20 } from "commander";
 function moveCommand() {
-  const cmd = new Command16("move");
+  const cmd = new Command20("move");
   cmd.description("move pages to a new parent").argument("<ids/urls...>", "Notion page IDs or URLs to move").option("--to <id/url>", "target page parent ID or URL").option(
     "--to-db <id/url>",
     "target database parent ID or URL (resolves to data source)"
@@ -2542,10 +3178,10 @@ function moveCommand() {
 // src/commands/open.ts
 import { exec } from "child_process";
 import { promisify } from "util";
-import { Command as Command17 } from "commander";
+import { Command as Command21 } from "commander";
 var execAsync = promisify(exec);
 function openCommand() {
-  const cmd = new Command17("open");
+  const cmd = new Command21("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);
@@ -2561,9 +3197,9 @@ function openCommand() {
 }
 
 // src/commands/profile/list.ts
-import { Command as Command18 } from "commander";
+import { Command as Command22 } from "commander";
 function profileListCommand() {
-  const cmd = new Command18("list");
+  const cmd = new Command22("list");
   cmd.description("list all authentication profiles").action(
     withErrorHandling(async () => {
       const config = await readGlobalConfig();
@@ -2592,9 +3228,9 @@ function profileListCommand() {
 }
 
 // src/commands/profile/remove.ts
-import { Command as Command19 } from "commander";
+import { Command as Command23 } from "commander";
 function profileRemoveCommand() {
-  const cmd = new Command19("remove");
+  const cmd = new Command23("remove");
   cmd.description("remove an authentication profile").argument("<name>", "profile name to remove").action(
     withErrorHandling(async (name) => {
       const config = await readGlobalConfig();
@@ -2620,9 +3256,9 @@ function profileRemoveCommand() {
 }
 
 // src/commands/profile/use.ts
-import { Command as Command20 } from "commander";
+import { Command as Command24 } from "commander";
 function profileUseCommand() {
-  const cmd = new Command20("use");
+  const cmd = new Command24("use");
   cmd.description("switch the active profile").argument("<name>", "profile name to activate").action(
     withErrorHandling(async (name) => {
       const config = await readGlobalConfig();
@@ -2645,7 +3281,7 @@ function profileUseCommand() {
 }
 
 // src/commands/read.ts
-import { Command as Command21 } from "commander";
+import { Command as Command25 } from "commander";
 
 // src/output/markdown.ts
 import { Chalk as Chalk2 } from "chalk";
@@ -2775,17 +3411,71 @@ function renderInline(text) {
 }
 
 // src/services/page.service.ts
+var UNKNOWN_BOOKMARK_REGEX = /<unknown url="([^"]*)" alt="bookmark"\/>/g;
+function extractBlockIdFromUrl(url) {
+  const fragment = new URL(url).hash.slice(1);
+  const hex = fragment.replace(/-/g, "");
+  return /^[0-9a-f]{32}$/i.test(hex) ? hex : null;
+}
+function richTextToPlainText(richText) {
+  return richText.map((rt) => rt.plain_text ?? "").join("");
+}
+async function resolveUnknownBookmarks(client, markdown) {
+  const matches = [...markdown.matchAll(UNKNOWN_BOOKMARK_REGEX)];
+  if (matches.length === 0) return markdown;
+  const tagToBlockId = /* @__PURE__ */ new Map();
+  for (const match of matches) {
+    const tag = match[0];
+    if (tagToBlockId.has(tag)) continue;
+    try {
+      const blockId = extractBlockIdFromUrl(match[1]);
+      tagToBlockId.set(tag, blockId);
+    } catch {
+      tagToBlockId.set(tag, null);
+    }
+  }
+  const blockIdToReplacement = /* @__PURE__ */ new Map();
+  await Promise.all(
+    [...new Set(tagToBlockId.values())].map(async (blockId) => {
+      if (!blockId) return;
+      try {
+        const block = await client.blocks.retrieve({
+          block_id: toUuid(blockId)
+        });
+        if (block.type !== "bookmark" || !block.bookmark) return;
+        const { url, caption } = block.bookmark;
+        const captionText = richTextToPlainText(caption).trim();
+        const replacement = captionText ? `[${captionText}](${url})` : url;
+        blockIdToReplacement.set(blockId, replacement);
+      } catch {
+      }
+    })
+  );
+  return markdown.replace(UNKNOWN_BOOKMARK_REGEX, (tag, notionUrl) => {
+    try {
+      const blockId = extractBlockIdFromUrl(notionUrl);
+      if (!blockId) return tag;
+      return blockIdToReplacement.get(blockId) ?? tag;
+    } catch {
+      return tag;
+    }
+  });
+}
 async function fetchPageMarkdown(client, pageId) {
   const [page, markdownResponse] = await Promise.all([
     client.pages.retrieve({ page_id: pageId }),
     client.pages.retrieveMarkdown({ page_id: pageId })
   ]);
-  return { page, markdown: markdownResponse.markdown };
+  const markdown = await resolveUnknownBookmarks(
+    client,
+    markdownResponse.markdown
+  );
+  return { page, markdown };
 }
 
 // src/commands/read.ts
 function readCommand() {
-  return new Command21("read").description("Read a Notion page as markdown").argument("<id>", "Notion page ID or URL").action(
+  return new Command25("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);
@@ -2811,7 +3501,7 @@ function readCommand() {
 
 // src/commands/search.ts
 import { isFullPageOrDataSource as isFullPageOrDataSource2 } from "@notionhq/client";
-import { Command as Command22 } from "commander";
+import { Command as Command26 } from "commander";
 function getTitle2(item) {
   if (item.object === "data_source") {
     return item.title.map((t) => t.plain_text).join("") || "(untitled)";
@@ -2831,7 +3521,7 @@ function displayType2(item) {
   return item.object === "data_source" ? "database" : item.object;
 }
 function searchCommand() {
-  const cmd = new Command22("search");
+  const cmd = new Command26("search");
   cmd.description("search Notion workspace by keyword").argument("<query>", "search keyword").option(
     "--type <type>",
     "filter by object type (page or database)",
@@ -2876,8 +3566,12 @@ function searchCommand() {
           (r) => isFullPageOrDataSource2(r)
         );
         if (fullResults.length === 0) {
-          process.stdout.write(`No results found for "${query}"
+          if (getOutputMode() === "json") {
+            process.stdout.write("[]\n");
+          } else {
+            process.stdout.write(`No results found for "${query}"
 `);
+          }
           return;
         }
         const headers = ["TYPE", "TITLE", "ID", "MODIFIED"];
@@ -2904,7 +3598,7 @@ function searchCommand() {
 // src/commands/skill.ts
 import {
   copyFileSync,
-  existsSync,
+  existsSync as existsSync4,
   mkdirSync,
   readFileSync,
   realpathSync
@@ -2912,7 +3606,7 @@ import {
 import { homedir as homedir2 } from "os";
 import { dirname, join as join3 } from "path";
 import chalk from "chalk";
-import { Command as Command23 } from "commander";
+import { Command as Command27 } from "commander";
 function skillPath() {
   if (!process.argv[1]) {
     throw new Error("Cannot determine install path. Run with: notion skill");
@@ -2931,7 +3625,7 @@ function skillPath() {
     )
   ];
   for (const c2 of candidates) {
-    if (existsSync(c2)) return c2;
+    if (existsSync4(c2)) return c2;
   }
   throw new Error(
     "SKILL.md not found. Reinstall with: npm install -g @andrzejchm/notion-cli"
@@ -2952,11 +3646,11 @@ function getAgentTargets() {
   ];
   return targets.map((t) => ({
     ...t,
-    detected: existsSync(dirname(t.dir))
+    detected: existsSync4(dirname(t.dir))
   }));
 }
 function installTo(source, target) {
-  if (!existsSync(target.dir)) mkdirSync(target.dir, { recursive: true });
+  if (!existsSync4(target.dir)) mkdirSync(target.dir, { recursive: true });
   const dest = join3(target.dir, "SKILL.md");
   copyFileSync(source, dest);
   return dest;
@@ -2999,7 +3693,7 @@ function installNonInteractive(source, targets) {
   }
 }
 function skillCommand() {
-  const cmd = new Command23("skill");
+  const cmd = new Command27("skill");
   cmd.description("Install the agent skill file for your coding agents").option("--print", "Print the skill file content instead of installing").option("--path <path>", "Install to a specific file path").action(
     withErrorHandling(async (opts) => {
       if (opts.print) {
@@ -3009,7 +3703,7 @@ function skillCommand() {
       const source = skillPath();
       if (opts.path) {
         const dir = dirname(opts.path);
-        if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+        if (!existsSync4(dir)) mkdirSync(dir, { recursive: true });
         copyFileSync(source, opts.path);
         process.stdout.write(`Installed to ${opts.path}
 `);
@@ -3028,17 +3722,17 @@ function skillCommand() {
 }
 
 // src/commands/update.ts
-import { Command as Command24 } from "commander";
-function collectProps3(val, acc) {
+import { Command as Command28 } from "commander";
+function collectProps4(val, acc) {
   acc.push(val);
   return acc;
 }
 function updateCommand() {
-  const cmd = new Command24("update");
+  const cmd = new Command28("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)",
-    collectProps3,
+    collectProps4,
     []
   ).option("--title <title>", "set the page title").action(
     withErrorHandling(async (idOrUrl, opts) => {
@@ -3092,7 +3786,7 @@ function updateCommand() {
 }
 
 // src/commands/users.ts
-import { Command as Command25 } from "commander";
+import { Command as Command29 } from "commander";
 function getEmailOrWorkspace(user) {
   if (user.type === "person") {
     return user.person.email ?? "\u2014";
@@ -3104,7 +3798,7 @@ function getEmailOrWorkspace(user) {
   return "\u2014";
 }
 function usersCommand() {
-  const cmd = new Command25("users");
+  const cmd = new Command29("users");
   cmd.description("list all users in the workspace").option("--json", "output as JSON").action(
     withErrorHandling(async (opts) => {
       if (opts.json) setOutputMode("json");
@@ -3135,7 +3829,7 @@ var __dirname = dirname2(__filename);
 var pkg = JSON.parse(
   readFileSync2(join4(__dirname, "../package.json"), "utf-8")
 );
-var program = new Command26();
+var program = new Command30();
 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({
@@ -3156,7 +3850,7 @@ program.hook("preAction", (thisCommand) => {
     setOutputMode("md");
   }
 });
-var authCmd = new Command26("auth").description("manage Notion authentication");
+var authCmd = new Command30("auth").description("manage Notion authentication");
 authCmd.action(authDefaultAction(authCmd));
 authCmd.addCommand(loginCommand());
 authCmd.addCommand(logoutCommand());
@@ -3166,7 +3860,7 @@ authCmd.addCommand(profileUseCommand());
 authCmd.addCommand(profileRemoveCommand());
 program.addCommand(authCmd);
 program.addCommand(initCommand(), { hidden: true });
-var profileCmd = new Command26("profile").description(
+var profileCmd = new Command30("profile").description(
   "manage authentication profiles"
 );
 profileCmd.addCommand(profileListCommand());
@@ -3181,15 +3875,19 @@ program.addCommand(commentsCommand());
 program.addCommand(readCommand());
 program.addCommand(commentAddCommand());
 program.addCommand(appendCommand());
+program.addCommand(attachCommand());
 program.addCommand(createPageCommand());
 program.addCommand(editPageCommand());
 program.addCommand(updateCommand());
 program.addCommand(archiveCommand());
+program.addCommand(deleteBlockCommand());
 program.addCommand(moveCommand());
-var dbCmd = new Command26("db").description("Database operations");
+var dbCmd = new Command30("db").description("Database operations");
 dbCmd.addCommand(dbCreateCommand());
 dbCmd.addCommand(dbSchemaCommand());
 dbCmd.addCommand(dbQueryCommand());
+dbCmd.addCommand(dbUpdateCommand());
+dbCmd.addCommand(dbUpdateRowsCommand());
 program.addCommand(dbCmd);
 program.addCommand(completionCommand());
 program.addCommand(skillCommand());