@lpenguin/notion-cli 1.0.0

package/dist/commands/page/write.js

@@ -0,0 +1,109 @@
+/**
+ * notion-cli page write <page-id> --file <path>
+ *
+ * Replace a Notion page's content with Markdown from a file or stdin.
+ * Uses @tryfabric/martian to convert Markdown → Notion blocks.
+ *
+ * WARNING: This replaces ALL existing content on the page.
+ * Use `page patch` for partial edits.
+ *
+ * This command is NOT idempotent (replaces content).
+ */
+import {} from 'commander';
+import { readFileSync } from 'node:fs';
+import { getClient } from '../../lib/client.js';
+import { markdownToNotionBlocks, processImageUploads } from '../../lib/markdown.js';
+import { printSuccess, printError, isJsonMode } from '../../lib/output.js';
+import { isDryRun } from '../../lib/safety.js';
+import { withRateLimit } from '../../lib/rate-limit.js';
+import { parseNotionId } from '../../utils/id.js';
+import { unescapeString } from '../../utils/string.js';
+import {} from '../../lib/types.js';
+import { toCliError } from '../../lib/errors.js';
+import { ValidationError } from '../../lib/errors.js';
+import * as logger from '../../utils/logger.js';
+export function registerPageWriteCommand(page) {
+    page
+        .command('write')
+        .description('Replace a Notion page content with Markdown. Reads from --file or stdin.')
+        .argument('<page-id>', 'Notion page ID or URL')
+        .option('-f, --file <path>', 'Path to Markdown file')
+        .option('--content <markdown>', 'Inline Markdown content')
+        .action(async (rawId, cmdOpts) => {
+        try {
+            const opts = page.optsWithGlobals();
+            const pageId = parseNotionId(rawId);
+            const client = getClient(opts.token);
+            // Get markdown content from file, --content, or stdin
+            const markdown = await resolveContent(cmdOpts.file, cmdOpts.content);
+            // Convert to Notion blocks
+            let blocks = markdownToNotionBlocks(markdown);
+            // Process and upload file:// images
+            blocks = await processImageUploads(client, blocks);
+            logger.debug(`Will replace page content with ${String(blocks.length)} blocks.`);
+            // Dry run check
+            if (isDryRun(opts.dryRun)) {
+                if (isJsonMode()) {
+                    printSuccess({
+                        pageId,
+                        blocksWritten: blocks.length,
+                        dryRun: true,
+                    });
+                }
+                return;
+            }
+            // Clear existing content using erase_content: true
+            await withRateLimit(() => client.pages.update({
+                page_id: pageId,
+                erase_content: true,
+            }), 'pages.update (erase_content)');
+            // Append new blocks (in chunks of 100 — Notion API limit)
+            let totalWritten = 0;
+            for (let i = 0; i < blocks.length; i += 100) {
+                const chunk = blocks.slice(i, i + 100);
+                await withRateLimit(() => client.blocks.children.append({
+                    block_id: pageId,
+                    children: chunk,
+                }), 'blocks.children.append');
+                totalWritten += chunk.length;
+            }
+            const result = {
+                pageId,
+                blocksWritten: totalWritten,
+            };
+            if (isJsonMode()) {
+                printSuccess(result);
+            }
+        }
+        catch (err) {
+            const cliErr = toCliError(err);
+            printError(cliErr.code, cliErr.message);
+            process.exitCode = cliErr.exitCode;
+        }
+    });
+}
+/**
+ * Resolve Markdown content from file, inline, or stdin.
+ */
+async function resolveContent(filePath, inlineContent) {
+    if (filePath !== undefined) {
+        return readFileSync(filePath, 'utf-8');
+    }
+    if (inlineContent !== undefined) {
+        return unescapeString(inlineContent);
+    }
+    // Read from stdin
+    if (!process.stdin.isTTY) {
+        return readStdin();
+    }
+    throw new ValidationError('No content provided. Use --file, --content, or pipe via stdin.');
+}
+function readStdin() {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        process.stdin.on('data', (chunk) => chunks.push(chunk));
+        process.stdin.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+        process.stdin.on('error', reject);
+    });
+}
+//# sourceMappingURL=write.js.map

package/dist/commands/page/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/commands/page/write.ts"],"names":[],"mappings":"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"}

package/dist/commands/search.d.ts

@@ -0,0 +1,18 @@
+/**
+ * notion-cli search <query>
+ *
+ * Unified search across all pages and databases accessible to the integration.
+ * Returns IDs, titles, URLs, and types — perfect for AI agents to discover
+ * content before reading/patching.
+ *
+ * Options:
+ *   --type page|database   Filter by object type
+ *   --sort last_edited     Sort by last edited time
+ *   --limit N              Max results (default 10)
+ *   --cursor <cursor>      Pagination cursor
+ *
+ * This command is idempotent and read-only.
+ */
+import { type Command } from 'commander';
+export declare function registerSearchCommand(program: Command): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyH5D"}

package/dist/commands/search.js

@@ -0,0 +1,129 @@
+/**
+ * notion-cli search <query>
+ *
+ * Unified search across all pages and databases accessible to the integration.
+ * Returns IDs, titles, URLs, and types — perfect for AI agents to discover
+ * content before reading/patching.
+ *
+ * Options:
+ *   --type page|database   Filter by object type
+ *   --sort last_edited     Sort by last edited time
+ *   --limit N              Max results (default 10)
+ *   --cursor <cursor>      Pagination cursor
+ *
+ * This command is idempotent and read-only.
+ */
+import {} from 'commander';
+import { getClient } from '../lib/client.js';
+import { printSuccess, printError, formatTable, isJsonMode } from '../lib/output.js';
+import { withRateLimit } from '../lib/rate-limit.js';
+import {} from '../lib/types.js';
+import { toCliError, ValidationError } from '../lib/errors.js';
+import * as logger from '../utils/logger.js';
+export function registerSearchCommand(program) {
+    program
+        .command('search')
+        .description('Search across all Notion pages and databases.')
+        .argument('<query>', 'Search query text')
+        .option('--type <type>', 'Filter by type: page or database')
+        .option('--sort <direction>', 'Sort by last_edited_time: ascending or descending', 'descending')
+        .option('-l, --limit <n>', 'Maximum results to return', '10')
+        .option('--cursor <cursor>', 'Pagination cursor from a previous response')
+        .action(async (query, cmdOpts) => {
+        try {
+            const opts = program.optsWithGlobals();
+            const client = getClient(opts.token);
+            const limit = parseInt(cmdOpts.limit ?? '10', 10);
+            // Validate type filter
+            if (cmdOpts.type !== undefined && cmdOpts.type !== 'page' && cmdOpts.type !== 'database') {
+                throw new ValidationError('--type must be "page" or "database".');
+            }
+            // Build search params
+            const searchParams = {
+                query,
+                page_size: Math.min(limit, 100),
+                start_cursor: cmdOpts.cursor,
+            };
+            if (cmdOpts.type !== undefined) {
+                searchParams['filter'] = { value: cmdOpts.type, property: 'object' };
+            }
+            if (cmdOpts.sort !== undefined) {
+                searchParams['sort'] = {
+                    direction: cmdOpts.sort,
+                    timestamp: 'last_edited_time',
+                };
+            }
+            const response = await withRateLimit(() => client.search(searchParams), 'search');
+            const results = response.results.map((item) => {
+                const obj = item;
+                const objectType = obj['object'];
+                let title = 'Untitled';
+                if (objectType === 'page') {
+                    const props = obj['properties'];
+                    if (props !== undefined) {
+                        for (const prop of Object.values(props)) {
+                            if (prop['type'] === 'title') {
+                                const titleArr = prop['title'];
+                                if (titleArr !== undefined && titleArr.length > 0) {
+                                    title = titleArr[0]?.['plain_text'] ?? 'Untitled';
+                                }
+                                break;
+                            }
+                        }
+                    }
+                }
+                else if (objectType === 'database') {
+                    const titleArr = obj['title'];
+                    if (titleArr !== undefined && titleArr.length > 0) {
+                        title = titleArr[0]?.['plain_text'] ?? 'Untitled';
+                    }
+                }
+                return {
+                    id: item.id,
+                    type: objectType,
+                    title,
+                    url: obj['url'] ?? '',
+                    lastEditedTime: obj['last_edited_time'] ?? '',
+                };
+            });
+            const searchResults = {
+                results,
+                hasMore: response.has_more,
+                nextCursor: response.next_cursor ?? undefined,
+            };
+            if (isJsonMode()) {
+                printSuccess(searchResults, {
+                    hasMore: response.has_more,
+                    cursor: response.next_cursor ?? undefined,
+                    totalCount: results.length,
+                });
+            }
+            else {
+                if (results.length === 0) {
+                    logger.info('No results found.');
+                }
+                else {
+                    for (const r of results) {
+                        const table = formatTable([
+                            ['ID', r.id],
+                            ['Type', r.type],
+                            ['Title', r.title],
+                            ['URL', r.url],
+                            ['Last edited', r.lastEditedTime],
+                        ]);
+                        process.stdout.write(`${table}\n\n`);
+                    }
+                    if (searchResults.hasMore) {
+                        logger.info(`More results available. Use --cursor ${searchResults.nextCursor ?? ''}`);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            const cliErr = toCliError(err);
+            printError(cliErr.code, cliErr.message);
+            process.exitCode = cliErr.exitCode;
+        }
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+/**
+ * notion-cli — Read and edit Notion pages, databases, and blocks
+ * through Markdown and CSV. Designed for AI agent workflows.
+ *
+ * Usage:
+ *   notion-cli search <query>                          Search pages & databases
+ *   notion-cli page read <id>                          Read page as Markdown
+ *   notion-cli page create --parent <id> --file <path> Create page from Markdown
+ *   notion-cli page write <id> [--file <path>]        Replace page content
+ *   notion-cli page write-properties <id> --file <f>  Update page properties from CSV
+ *   notion-cli page list [--query <text>]              List pages
+ *   notion-cli db query <id> [--filter <json>]         Query database → CSV
+ *   notion-cli db export <id> --out <file.csv>         Export database → CSV
+ *   notion-cli db insert <id> --file <file.csv>        Insert CSV rows as new pages
+ *   notion-cli db update <id> --file <file.csv>        Update existing pages from CSV
+ *   notion-cli db delete <id> --ids <id1,id2>          Archive (delete) pages by ID
+ *   notion-cli db list                                 List databases
+ *   notion-cli db schema <id>                          Show DB schema
+ *
+ * Global flags:
+ *   --json        Structured JSON output (for AI agents)
+ *   --token       Override Notion API token
+ *   --dry-run     Preview changes without executing
+ *   --verbose     Debug output to stderr
+ *   --no-color    Disable colored output
+ *
+ * Authentication:
+ *   Set NOTION_TOKEN env var, or use --token, or create ~/.notion-cli.json
+ *
+ * AI Agent Usage:
+ *   All commands support --json for parseable output.
+ *   Data goes to stdout; status/progress goes to stderr.
+ *   Exit codes: 0=success, 1=error, 2=validation, 3=auth, 4=not_found, 5=rate_limited
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG"}

package/dist/index.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+/**
+ * notion-cli — Read and edit Notion pages, databases, and blocks
+ * through Markdown and CSV. Designed for AI agent workflows.
+ *
+ * Usage:
+ *   notion-cli search <query>                          Search pages & databases
+ *   notion-cli page read <id>                          Read page as Markdown
+ *   notion-cli page create --parent <id> --file <path> Create page from Markdown
+ *   notion-cli page write <id> [--file <path>]        Replace page content
+ *   notion-cli page write-properties <id> --file <f>  Update page properties from CSV
+ *   notion-cli page list [--query <text>]              List pages
+ *   notion-cli db query <id> [--filter <json>]         Query database → CSV
+ *   notion-cli db export <id> --out <file.csv>         Export database → CSV
+ *   notion-cli db insert <id> --file <file.csv>        Insert CSV rows as new pages
+ *   notion-cli db update <id> --file <file.csv>        Update existing pages from CSV
+ *   notion-cli db delete <id> --ids <id1,id2>          Archive (delete) pages by ID
+ *   notion-cli db list                                 List databases
+ *   notion-cli db schema <id>                          Show DB schema
+ *
+ * Global flags:
+ *   --json        Structured JSON output (for AI agents)
+ *   --token       Override Notion API token
+ *   --dry-run     Preview changes without executing
+ *   --verbose     Debug output to stderr
+ *   --no-color    Disable colored output
+ *
+ * Authentication:
+ *   Set NOTION_TOKEN env var, or use --token, or create ~/.notion-cli.json
+ *
+ * AI Agent Usage:
+ *   All commands support --json for parseable output.
+ *   Data goes to stdout; status/progress goes to stderr.
+ *   Exit codes: 0=success, 1=error, 2=validation, 3=auth, 4=not_found, 5=rate_limited
+ */
+import { Command } from 'commander';
+import { setJsonMode } from './lib/output.js';
+import { setVerbose } from './utils/logger.js';
+import { printError } from './lib/output.js';
+import { toCliError } from './lib/errors.js';
+// Page commands
+import { registerPageReadCommand } from './commands/page/read.js';
+import { registerPageCreateCommand } from './commands/page/create.js';
+import { registerPageWriteCommand } from './commands/page/write.js';
+import { registerPageWritePropertiesCommand } from './commands/page/write-properties.js';
+import { registerPagePatchCommand } from './commands/page/patch.js';
+import { registerPageListCommand } from './commands/page/list.js';
+// Database commands
+import { registerDbQueryCommand } from './commands/database/query.js';
+import { registerDbExportCommand } from './commands/database/export.js';
+import { registerDbInsertCommand } from './commands/database/insert.js';
+import { registerDbUpdateCommand } from './commands/database/update.js';
+import { registerDbDeleteCommand } from './commands/database/delete.js';
+import { registerDbListCommand } from './commands/database/list.js';
+import { registerDbCreateCommand } from './commands/database/create.js';
+import { registerDbSchemaCommand } from './commands/database/schema.js';
+// Search command
+import { registerSearchCommand } from './commands/search.js';
+const program = new Command();
+program
+    .name('notion-cli')
+    .version('1.0.0')
+    .description('CLI for reading and editing Notion entries through Markdown and CSV. AI agent friendly.')
+    .option('--json', 'Output as structured JSON (for AI agents)')
+    .option('--token <token>', 'Notion API integration token')
+    .option('--dry-run', 'Preview changes without executing writes')
+    .option('-v, --verbose', 'Enable verbose/debug output')
+    .option('--no-color', 'Disable colored output')
+    .hook('preAction', (_thisCommand, actionCommand) => {
+    const opts = actionCommand.optsWithGlobals();
+    if (opts.json === true) {
+        setJsonMode(true);
+    }
+    if (opts.verbose === true) {
+        setVerbose(true);
+    }
+});
+// ── Page subcommand group ──────────────────────────────────────────
+const page = program
+    .command('page')
+    .description('Read, write, and create Notion pages.');
+registerPageReadCommand(page);
+registerPageCreateCommand(page);
+registerPageWriteCommand(page);
+registerPageWritePropertiesCommand(page);
+registerPagePatchCommand(page);
+registerPageListCommand(page);
+// ── Database subcommand group ──────────────────────────────────────
+const db = program
+    .command('db')
+    .description('Query, export, import, and inspect Notion databases.');
+registerDbQueryCommand(db);
+registerDbExportCommand(db);
+registerDbInsertCommand(db);
+registerDbUpdateCommand(db);
+registerDbDeleteCommand(db);
+registerDbListCommand(db);
+registerDbCreateCommand(db);
+registerDbSchemaCommand(db);
+// ── Search command (top-level) ─────────────────────────────────────
+registerSearchCommand(program);
+// ── Global error handler ───────────────────────────────────────────
+program.exitOverride();
+async function main() {
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (err) {
+        // Commander throws for --help and --version, don't treat as errors
+        const commanderErr = err;
+        if (commanderErr.code === 'commander.helpDisplayed' ||
+            commanderErr.code === 'commander.version') {
+            return;
+        }
+        const cliErr = toCliError(err);
+        printError(cliErr.code, cliErr.message);
+        process.exitCode = cliErr.exitCode;
+    }
+}
+void main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,gBAAgB;AAChB,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,kCAAkC,EAAE,MAAM,qCAAqC,CAAC;AACzF,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,oBAAoB;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE,iBAAiB;AACjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CACV,yFAAyF,CAC1F;KACA,MAAM,CAAC,QAAQ,EAAE,2CAA2C,CAAC;KAC7D,MAAM,CAAC,iBAAiB,EAAE,8BAA8B,CAAC;KACzD,MAAM,CAAC,WAAW,EAAE,0CAA0C,CAAC;KAC/D,MAAM,CAAC,eAAe,EAAE,6BAA6B,CAAC;KACtD,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC;KAC9C,IAAI,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,EAAE;IACjD,MAAM,IAAI,GAAG,aAAa,CAAC,eAAe,EAGtC,CAAC;IAEL,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACvB,WAAW,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC1B,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,sEAAsE;AACtE,MAAM,IAAI,GAAG,OAAO;KACjB,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,uCAAuC,CAAC,CAAC;AAExD,uBAAuB,CAAC,IAAI,CAAC,CAAC;AAC9B,yBAAyB,CAAC,IAAI,CAAC,CAAC;AAChC,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAC/B,kCAAkC,CAAC,IAAI,CAAC,CAAC;AACzC,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAC/B,uBAAuB,CAAC,IAAI,CAAC,CAAC;AAE9B,sEAAsE;AACtE,MAAM,EAAE,GAAG,OAAO;KACf,OAAO,CAAC,IAAI,CAAC;KACb,WAAW,CAAC,sDAAsD,CAAC,CAAC;AAEvE,sBAAsB,CAAC,EAAE,CAAC,CAAC;AAC3B,uBAAuB,CAAC,EAAE,CAAC,CAAC;AAC5B,uBAAuB,CAAC,EAAE,CAAC,CAAC;AAC5B,uBAAuB,CAAC,EAAE,CAAC,CAAC;AAC5B,uBAAuB,CAAC,EAAE,CAAC,CAAC;AAC5B,qBAAqB,CAAC,EAAE,CAAC,CAAC;AAC1B,uBAAuB,CAAC,EAAE,CAAC,CAAC;AAC5B,uBAAuB,CAAC,EAAE,CAAC,CAAC;AAE5B,sEAAsE;AACtE,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAE/B,sEAAsE;AACtE,OAAO,CAAC,YAAY,EAAE,CAAC;AAEvB,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,mEAAmE;QACnE,MAAM,YAAY,GAAG,GAAwB,CAAC;QAC9C,IACE,YAAY,CAAC,IAAI,KAAK,yBAAyB;YAC/C,YAAY,CAAC,IAAI,KAAK,mBAAmB,EACzC,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC/B,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACrC,CAAC;AACH,CAAC;AAED,KAAK,IAAI,EAAE,CAAC"}

package/dist/lib/block-patch.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Surgical block-level patching.
+ *
+ * Instead of deleting all blocks and recreating them, this module
+ * enables targeted edits by tracking which markdown lines correspond
+ * to which Notion blocks.
+ *
+ * Key concepts:
+ * - BlockLineMapping: Maps a block ID to its line range in the markdown
+ * - PatchPlan: Describes which blocks to delete and what to insert
+ *
+ * The flow:
+ * 1. Fetch MdBlocks from Notion (via notion-to-md)
+ * 2. Build line mapping via mdBlocksToMarkdown (unified converter in markdown.ts)
+ * 3. Given a line range edit, compute which blocks are affected
+ * 4. Execute the plan: delete affected blocks, insert new content
+ */
+import { type BlockLineMapping, type PatchPlan } from './types.js';
+export { mdBlocksToMarkdown as buildBlockLineMap } from './markdown.js';
+/**
+ * Compute a patch plan given block mappings and a line range to replace.
+ *
+ * Determines which blocks need to be deleted and where to insert new content.
+ *
+ * Rules:
+ * - Blocks fully contained in [startLine, endLine] are deleted
+ * - Blocks that partially overlap are also deleted (they need to be reconstructed)
+ * - New content is inserted after the last unaffected block before the range
+ *
+ * @param mappings - Block-to-line mappings from buildBlockLineMap
+ * @param startLine - 1-indexed start line of the edit (inclusive)
+ * @param endLine - 1-indexed end line of the edit (inclusive)
+ * @param newContent - The replacement markdown content
+ * @returns A plan describing deletions and insertions
+ */
+export declare function computePatchPlan(mappings: readonly BlockLineMapping[], startLine: number, endLine: number, newContent: string): PatchPlan;
+/**
+ * Find a block mapping by line number.
+ *
+ * @param mappings - Block mappings to search
+ * @param line - The line number to find
+ * @returns The block containing this line, or undefined
+ */
+export declare function findBlockAtLine(mappings: readonly BlockLineMapping[], line: number): BlockLineMapping | undefined;
+/**
+ * Get content that should be preserved from partially affected blocks.
+ *
+ * When a block partially overlaps with the edit range, we need to keep
+ * the lines that are outside the edit range.
+ *
+ * @param mapping - The block mapping
+ * @param markdown - Full markdown content
+ * @param startLine - Edit start line
+ * @param endLine - Edit end line
+ * @returns Lines to preserve (before and after the edit range)
+ */
+export declare function getPreservedContent(mapping: BlockLineMapping, markdown: string, startLine: number, endLine: number): {
+    before: string;
+    after: string;
+};
+//# sourceMappingURL=block-patch.d.ts.map

package/dist/lib/block-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-patch.d.ts","sourceRoot":"","sources":["../../src/lib/block-patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,SAAS,EAEf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,kBAAkB,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAExE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,SAAS,CAsCX;AA0FD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,IAAI,EAAE,MAAM,GACX,gBAAgB,GAAG,SAAS,CAY9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAmBnC"}