@catafal/notion-cli 5.9.0

package/dist/commands/append.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Append Shortcut Command
+ *
+ * Quick-append content to any existing Notion page by name, URL, ID, or bookmark.
+ * Combines resolveNotionId (name → page ID) with appendBlockChildren (content → blocks).
+ *
+ * This is the "write to existing page" counterpart of `quick` (which creates new pages).
+ *
+ *   notion-cli append "Daily Log" "New note"
+ *   notion-cli append PAGE_URL "## Heading\n\nBody"
+ *   echo "piped text" | notion-cli append "Daily Log"
+ */
+import { Command } from '@oclif/core';
+export default class Append extends Command {
+    static description: string;
+    static aliases: string[];
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static args: {
+        target: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        content: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'page-size': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        retry: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'no-cache': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        minimal: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    /** Read all data from stdin (for piped input). */
+    private readStdin;
+}

package/dist/commands/append.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * Append Shortcut Command
+ *
+ * Quick-append content to any existing Notion page by name, URL, ID, or bookmark.
+ * Combines resolveNotionId (name → page ID) with appendBlockChildren (content → blocks).
+ *
+ * This is the "write to existing page" counterpart of `quick` (which creates new pages).
+ *
+ *   notion-cli append "Daily Log" "New note"
+ *   notion-cli append PAGE_URL "## Heading\n\nBody"
+ *   echo "piped text" | notion-cli append "Daily Log"
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const notion = require("../notion");
+const notion_resolver_1 = require("../utils/notion-resolver");
+const markdown_to_blocks_1 = require("../utils/markdown-to-blocks");
+const base_flags_1 = require("../base-flags");
+const errors_1 = require("../errors");
+class Append extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(Append);
+        // 1. Get content — from arg or stdin (checked before try/catch so oclif
+        //    error() isn't accidentally caught by the NotionCLIError handler)
+        let content = args.content || '';
+        if (!content && !process.stdin.isTTY) {
+            content = await this.readStdin();
+        }
+        if (!content) {
+            this.log('No content provided.\n' +
+                'Usage: notion-cli append "Page Name" "content to add"\n' +
+                '   or: echo "content" | notion-cli append "Page Name"');
+            process.exit(1);
+            return;
+        }
+        try {
+            // 2. Resolve target page — supports names, URLs, IDs, bookmarks, fuzzy
+            const pageId = await (0, notion_resolver_1.resolveNotionId)(args.target, 'page');
+            // 3. Convert markdown content to Notion blocks
+            const children = (0, markdown_to_blocks_1.markdownToBlocks)(content);
+            // 4. Append blocks to the page
+            const res = await notion.appendBlockChildren({
+                block_id: pageId,
+                children,
+            });
+            // 5. Output
+            if (flags.json) {
+                this.log(JSON.stringify({
+                    success: true,
+                    data: res,
+                    timestamp: new Date().toISOString(),
+                }, null, 2));
+            }
+            else {
+                this.log(`Appended to: ${args.target}`);
+                this.log(`${res.results.length} block(s) added`);
+            }
+            process.exit(0);
+        }
+        catch (error) {
+            const cliError = error instanceof errors_1.NotionCLIError
+                ? error
+                : (0, errors_1.wrapNotionError)(error, {
+                    endpoint: 'blocks.children.append',
+                    resourceType: 'page',
+                    attemptedId: args.target,
+                });
+            if (flags.json) {
+                this.log(JSON.stringify(cliError.toJSON(), null, 2));
+            }
+            else {
+                this.error(cliError.toHumanString());
+            }
+            process.exit(1);
+        }
+    }
+    /** Read all data from stdin (for piped input). */
+    readStdin() {
+        return new Promise((resolve) => {
+            const chunks = [];
+            process.stdin.on('data', (chunk) => chunks.push(chunk));
+            process.stdin.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8').trim()));
+        });
+    }
+}
+Append.description = 'Append content to an existing page by name, URL, or ID';
+Append.aliases = ['a'];
+Append.examples = [
+    {
+        description: 'Append text to a page by name',
+        command: '$ notion-cli append "Daily Log" "New note to add"',
+    },
+    {
+        description: 'Append markdown content',
+        command: '$ notion-cli append "Knowledge Hub" "## Section\\n\\nSome content"',
+    },
+    {
+        description: 'Pipe content from stdin',
+        command: '$ echo "Piped content" | notion-cli append "Daily Log"',
+    },
+    {
+        description: 'Use page URL or ID directly',
+        command: '$ notion-cli append PAGE_ID "Quick fix note" --json',
+    },
+];
+Append.args = {
+    target: core_1.Args.string({
+        required: true,
+        description: 'Page name, bookmark, URL, or ID',
+    }),
+    content: core_1.Args.string({
+        required: false,
+        description: 'Markdown content to append',
+    }),
+};
+Append.flags = {
+    ...base_flags_1.AutomationFlags,
+};
+exports.default = Append;

package/dist/commands/batch/delete.d.ts

@@ -0,0 +1,42 @@
+import { Command } from '@oclif/core';
+export default class BatchDelete extends Command {
+    static description: string;
+    static aliases: string[];
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static args: {
+        ids: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'page-size': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        retry: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'no-cache': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        minimal: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        markdown: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'compact-json': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        pretty: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        columns: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        sort: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        filter: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        csv: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        extended: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'no-truncate': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'no-header': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        ids: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        raw: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    /**
+     * Read IDs from stdin, one per line. Times out after 5s if no input.
+     */
+    private readStdin;
+    /**
+     * Delete a single block. Resolves URL/name/ID first, then calls Notion API.
+     */
+    private deleteResource;
+    run(): Promise<void>;
+}

package/dist/commands/batch/delete.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const table_formatter_1 = require("../../utils/table-formatter");
+const notion = require("../../notion");
+const helper_1 = require("../../helper");
+const base_flags_1 = require("../../base-flags");
+const errors_1 = require("../../errors");
+const readline = require("readline");
+const notion_resolver_1 = require("../../utils/notion-resolver");
+class BatchDelete extends core_1.Command {
+    /**
+     * Read IDs from stdin, one per line. Times out after 5s if no input.
+     */
+    async readStdin() {
+        return new Promise((resolve, reject) => {
+            const ids = [];
+            const rl = readline.createInterface({
+                input: process.stdin,
+                output: process.stdout,
+                terminal: false,
+            });
+            rl.on('line', (line) => {
+                const trimmed = line.trim();
+                if (trimmed) {
+                    ids.push(trimmed);
+                }
+            });
+            rl.on('close', () => {
+                resolve(ids);
+            });
+            rl.on('error', (err) => {
+                reject(err);
+            });
+            setTimeout(() => {
+                rl.close();
+                resolve(ids);
+            }, 5000);
+        });
+    }
+    /**
+     * Delete a single block. Resolves URL/name/ID first, then calls Notion API.
+     */
+    async deleteResource(id) {
+        try {
+            const resolvedId = await (0, notion_resolver_1.resolveNotionId)(id, 'page');
+            const data = await notion.deleteBlock(resolvedId);
+            return {
+                id,
+                success: true,
+                data,
+            };
+        }
+        catch (error) {
+            const cliError = error instanceof errors_1.NotionCLIError
+                ? error
+                : (0, errors_1.wrapNotionError)(error, {
+                    resourceType: 'block',
+                    attemptedId: id,
+                    endpoint: 'blocks.delete'
+                });
+            return {
+                id,
+                success: false,
+                error: cliError.code,
+                message: cliError.userMessage,
+            };
+        }
+    }
+    async run() {
+        const { args, flags } = await this.parse(BatchDelete);
+        try {
+            // Collect IDs from args, --ids flag, or stdin
+            let ids = [];
+            if (args.ids) {
+                ids = args.ids.split(',').map(id => id.trim()).filter(id => id);
+            }
+            else if (flags.ids) {
+                ids = flags.ids.split(',').map(id => id.trim()).filter(id => id);
+            }
+            else if (!process.stdin.isTTY) {
+                ids = await this.readStdin();
+            }
+            if (ids.length === 0) {
+                throw new errors_1.NotionCLIError(errors_1.NotionCLIErrorCode.VALIDATION_ERROR, 'No IDs provided. Use --ids flag, positional argument, or pipe IDs via stdin', [
+                    {
+                        description: 'Provide IDs via --ids flag',
+                        command: 'notion-cli batch delete --ids ID1,ID2,ID3'
+                    },
+                    {
+                        description: 'Or pipe IDs from a file',
+                        command: 'cat block_ids.txt | notion-cli batch delete'
+                    }
+                ]);
+            }
+            // Delete all blocks in parallel
+            const results = await Promise.all(ids.map(id => this.deleteResource(id)));
+            const successCount = results.filter(r => r.success).length;
+            const failureCount = results.filter(r => !r.success).length;
+            // JSON output for automation
+            if (flags.json) {
+                this.log(JSON.stringify({
+                    success: successCount > 0,
+                    total: results.length,
+                    succeeded: successCount,
+                    failed: failureCount,
+                    results,
+                    timestamp: new Date().toISOString(),
+                }, null, 2));
+                process.exit(failureCount === 0 ? 0 : 1);
+                return;
+            }
+            // Compact JSON output
+            if (flags['compact-json']) {
+                (0, helper_1.outputCompactJson)({
+                    total: results.length,
+                    succeeded: successCount,
+                    failed: failureCount,
+                    results,
+                });
+                process.exit(failureCount === 0 ? 0 : 1);
+                return;
+            }
+            // Raw JSON output
+            if (flags.raw) {
+                (0, helper_1.outputRawJson)(results);
+                process.exit(failureCount === 0 ? 0 : 1);
+                return;
+            }
+            // Table output (default)
+            const tableData = results.map(result => ({
+                id: result.id,
+                status: result.success ? 'deleted' : 'failed',
+                content: result.success && result.data
+                    ? (0, helper_1.getBlockPlainText)(result.data) || '-'
+                    : result.message || result.error || 'Unknown error',
+            }));
+            const columns = {
+                id: {},
+                status: {},
+                content: {},
+            };
+            const options = {
+                printLine: this.log.bind(this),
+                ...flags,
+            };
+            (0, table_formatter_1.formatTable)(tableData, columns, options);
+            this.log(`\nTotal: ${results.length} | Deleted: ${successCount} | Failed: ${failureCount}`);
+            process.exit(failureCount === 0 ? 0 : 1);
+        }
+        catch (error) {
+            const cliError = error instanceof errors_1.NotionCLIError
+                ? error
+                : (0, errors_1.wrapNotionError)(error, { endpoint: 'batch.delete' });
+            if (flags.json) {
+                this.log(JSON.stringify(cliError.toJSON(), null, 2));
+            }
+            else {
+                this.error(cliError.toHumanString());
+            }
+            process.exit(1);
+        }
+    }
+}
+BatchDelete.description = 'Batch delete multiple blocks in parallel';
+BatchDelete.aliases = ['batch:d'];
+BatchDelete.examples = [
+    {
+        description: 'Delete multiple blocks via --ids flag',
+        command: '$ notion-cli batch delete --ids BLOCK_ID_1,BLOCK_ID_2,BLOCK_ID_3 --json',
+    },
+    {
+        description: 'Delete blocks from stdin (one ID per line)',
+        command: '$ cat block_ids.txt | notion-cli batch delete --json',
+    },
+    {
+        description: 'Delete using Notion URLs (auto-resolved)',
+        command: '$ notion-cli batch delete --ids "https://notion.so/Page-abc123,https://notion.so/Other-def456"',
+    },
+];
+BatchDelete.args = {
+    ids: core_1.Args.string({
+        required: false,
+        description: 'Comma-separated list of block IDs to delete (or use --ids flag or stdin)',
+    }),
+};
+BatchDelete.flags = {
+    ids: core_1.Flags.string({
+        description: 'Comma-separated list of block IDs to delete',
+    }),
+    raw: core_1.Flags.boolean({
+        char: 'r',
+        description: 'output raw json',
+    }),
+    ...table_formatter_1.tableFlags,
+    ...base_flags_1.OutputFormatFlags,
+    ...base_flags_1.AutomationFlags,
+};
+exports.default = BatchDelete;

package/dist/commands/batch/retrieve.d.ts

@@ -0,0 +1,43 @@
+import { Command } from '@oclif/core';
+export default class BatchRetrieve extends Command {
+    static description: string;
+    static aliases: string[];
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static args: {
+        ids: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'page-size': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        retry: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'no-cache': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        minimal: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        markdown: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'compact-json': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        pretty: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        columns: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        sort: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        filter: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        csv: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        extended: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'no-truncate': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'no-header': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        ids: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        type: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        raw: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    /**
+     * Read IDs from stdin
+     */
+    private readStdin;
+    /**
+     * Retrieve a single resource and handle errors
+     */
+    private retrieveResource;
+    run(): Promise<void>;
+}