@catafal/notion-cli 5.9.0

package/dist/commands/daily/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Daily Command
+ *
+ * Zero-friction daily journal entries. After one-time setup:
+ *   `notion-cli daily`             → create (or find) today's entry
+ *   `notion-cli daily "My note"`   → create with body, or append if entry exists
+ *
+ * Queries the configured database by date to detect existing entries,
+ * so you never get duplicate pages for the same day.
+ */
+import { Command } from '@oclif/core';
+export default class Daily extends Command {
+    static description: string;
+    static aliases: string[];
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static args: {
+        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>;
+}

package/dist/commands/daily/index.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * Daily Command
+ *
+ * Zero-friction daily journal entries. After one-time setup:
+ *   `notion-cli daily`             → create (or find) today's entry
+ *   `notion-cli daily "My note"`   → create with body, or append if entry exists
+ *
+ * Queries the configured database by date to detect existing entries,
+ * so you never get duplicate pages for the same day.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const dayjs = require("dayjs");
+const notion = require("../../notion");
+const daily_config_1 = require("../../utils/daily-config");
+const markdown_to_blocks_1 = require("../../utils/markdown-to-blocks");
+const base_flags_1 = require("../../base-flags");
+const errors_1 = require("../../errors");
+class Daily extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(Daily);
+        try {
+            // 1. Load config — fail fast if not set up
+            const config = await (0, daily_config_1.loadDailyConfig)();
+            if (!config) {
+                this.error('Daily journal not configured yet.\n' +
+                    'Run setup first:\n' +
+                    '  notion-cli daily setup DB_ID          (existing database)\n' +
+                    '  notion-cli daily setup --auto PAGE_ID  (auto-create database)');
+                process.exit(1);
+                return;
+            }
+            // 2. Today's date — used for both the entry title and the date filter
+            const today = dayjs();
+            const todayISO = today.format('YYYY-MM-DD');
+            const title = today.format(config.title_format);
+            // 3. Check if today's entry already exists (query by date property)
+            const existingPages = await notion.fetchAllPagesInDS(config.database_id, {
+                property: config.date_property,
+                date: { equals: todayISO },
+            });
+            // 4. Build content blocks from the positional arg (if provided)
+            const children = args.content
+                ? (0, markdown_to_blocks_1.markdownToBlocks)(args.content)
+                : undefined;
+            if (existingPages.length > 0) {
+                // Entry exists — append content or just show the link
+                const page = existingPages[0];
+                if (children && children.length > 0) {
+                    await notion.appendBlockChildren({ block_id: page.id, children });
+                }
+                if (flags.json) {
+                    this.log(JSON.stringify({
+                        success: true,
+                        action: children ? 'appended' : 'found',
+                        data: page,
+                        timestamp: new Date().toISOString()
+                    }, null, 2));
+                }
+                else {
+                    this.log(children ? `Appended to: ${title}` : `Today's entry: ${title}`);
+                    this.log(page.url);
+                }
+            }
+            else {
+                // No entry for today — create one
+                const properties = {
+                    [config.title_property]: {
+                        title: [{ text: { content: title } }],
+                    },
+                    [config.date_property]: {
+                        date: { start: todayISO },
+                    },
+                };
+                const res = await notion.createPage({
+                    parent: { data_source_id: config.database_id },
+                    properties,
+                    ...(children && { children }),
+                });
+                if (flags.json) {
+                    this.log(JSON.stringify({
+                        success: true,
+                        action: 'created',
+                        data: res,
+                        timestamp: new Date().toISOString()
+                    }, null, 2));
+                }
+                else {
+                    this.log(`Created: ${title}`);
+                    this.log(res.url);
+                }
+            }
+            process.exit(0);
+        }
+        catch (error) {
+            const cliError = error instanceof errors_1.NotionCLIError
+                ? error
+                : (0, errors_1.wrapNotionError)(error, { endpoint: 'daily', resourceType: 'page' });
+            if (flags.json) {
+                this.log(JSON.stringify(cliError.toJSON(), null, 2));
+            }
+            else {
+                this.error(cliError.toHumanString());
+            }
+            process.exit(1);
+        }
+    }
+}
+Daily.description = 'Create or open today\'s daily journal entry';
+Daily.aliases = ['d'];
+Daily.examples = [
+    {
+        description: 'Create today\'s entry',
+        command: '$ notion-cli daily',
+    },
+    {
+        description: 'Create entry with body content',
+        command: '$ notion-cli daily "Had a productive standup"',
+    },
+    {
+        description: 'First-time setup (see `daily setup --help`)',
+        command: '$ notion-cli daily setup DB_ID',
+    },
+];
+Daily.args = {
+    content: core_1.Args.string({
+        required: false,
+        description: 'Text to add to today\'s entry (appended if entry already exists)',
+    }),
+};
+Daily.flags = {
+    ...base_flags_1.AutomationFlags,
+};
+exports.default = Daily;

package/dist/commands/daily/setup.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Daily Setup Command
+ *
+ * One-time configuration for the `daily` command.
+ * Two modes:
+ *   Manual — point to an existing database that has a Date property.
+ *   Auto   — create a new "Daily Journal" database under a parent page.
+ *
+ * After setup, `notion-cli daily` works with zero arguments.
+ */
+import { Command } from '@oclif/core';
+export default class DailySetup extends Command {
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static args: {
+        target: 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>;
+        auto: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    /**
+     * Manual mode: resolve an existing database and detect its title + date properties.
+     * Fails if the database has no date-type property.
+     */
+    private manualSetup;
+    /**
+     * Auto mode: create a minimal "Daily Journal" database under a parent page.
+     * Schema: Name (title) + Date (date) — intentionally minimal.
+     */
+    private autoSetup;
+}

package/dist/commands/daily/setup.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * Daily Setup Command
+ *
+ * One-time configuration for the `daily` command.
+ * Two modes:
+ *   Manual — point to an existing database that has a Date property.
+ *   Auto   — create a new "Daily Journal" database under a parent page.
+ *
+ * After setup, `notion-cli daily` works with zero arguments.
+ */
+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 daily_config_1 = require("../../utils/daily-config");
+const base_flags_1 = require("../../base-flags");
+const errors_1 = require("../../errors");
+class DailySetup extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(DailySetup);
+        try {
+            // Must provide exactly one mode: target (manual) or --auto
+            if (!args.target && !flags.auto) {
+                this.error('Provide a database ID (manual) or --auto PAGE_ID (auto-create).\n' +
+                    '  Manual: notion-cli daily setup DB_ID\n' +
+                    '  Auto:   notion-cli daily setup --auto PAGE_ID');
+                process.exit(1);
+                return;
+            }
+            if (args.target && flags.auto) {
+                this.error('Cannot use both target database and --auto. Choose one mode.');
+                process.exit(1);
+                return;
+            }
+            let databaseId;
+            let titleProperty;
+            let dateProperty;
+            if (flags.auto) {
+                const result = await this.autoSetup(flags.auto);
+                databaseId = result.databaseId;
+                titleProperty = result.titleProperty;
+                dateProperty = result.dateProperty;
+            }
+            else {
+                const result = await this.manualSetup(args.target);
+                databaseId = result.databaseId;
+                titleProperty = result.titleProperty;
+                dateProperty = result.dateProperty;
+            }
+            // Persist config to ~/.notion-cli/daily.json
+            const config = (0, daily_config_1.createDailyConfig)(databaseId, titleProperty, dateProperty);
+            await (0, daily_config_1.saveDailyConfig)(config);
+            if (flags.json) {
+                this.log(JSON.stringify({
+                    success: true,
+                    data: config,
+                    timestamp: new Date().toISOString()
+                }, null, 2));
+            }
+            else {
+                this.log('Daily journal configured!');
+                this.log(`  Database:       ${databaseId}`);
+                this.log(`  Title property: ${titleProperty}`);
+                this.log(`  Date property:  ${dateProperty}`);
+                this.log('\nRun "notion-cli daily" to create today\'s entry.');
+            }
+            process.exit(0);
+        }
+        catch (error) {
+            const cliError = error instanceof errors_1.NotionCLIError
+                ? error
+                : (0, errors_1.wrapNotionError)(error, { endpoint: 'daily.setup', resourceType: 'database' });
+            if (flags.json) {
+                this.log(JSON.stringify(cliError.toJSON(), null, 2));
+            }
+            else {
+                this.error(cliError.toHumanString());
+            }
+            process.exit(1);
+        }
+    }
+    /**
+     * Manual mode: resolve an existing database and detect its title + date properties.
+     * Fails if the database has no date-type property.
+     */
+    async manualSetup(target) {
+        const dbId = await (0, notion_resolver_1.resolveNotionId)(target, 'database');
+        const schema = await notion.retrieveDataSource(dbId);
+        let titleProperty = 'Name';
+        let dateProperty = null;
+        if (schema.properties) {
+            for (const [name, prop] of Object.entries(schema.properties)) {
+                if (prop.type === 'title')
+                    titleProperty = name;
+                // Take the first date property found
+                if (prop.type === 'date' && !dateProperty)
+                    dateProperty = name;
+            }
+        }
+        if (!dateProperty) {
+            throw new errors_1.NotionCLIError(errors_1.NotionCLIErrorCode.VALIDATION_ERROR, 'This database has no Date property.', [{ description: 'Add a Date property to your database in Notion, then run setup again.' }], { resourceType: 'database', attemptedId: dbId });
+        }
+        return { databaseId: dbId, titleProperty, dateProperty };
+    }
+    /**
+     * Auto mode: create a minimal "Daily Journal" database under a parent page.
+     * Schema: Name (title) + Date (date) — intentionally minimal.
+     */
+    async autoSetup(parentTarget) {
+        const parentId = await (0, notion_resolver_1.resolveNotionId)(parentTarget, 'page');
+        const dbProps = {
+            parent: { type: 'page_id', page_id: parentId },
+            title: [{ type: 'text', text: { content: 'Daily Journal' } }],
+            initial_data_source: {
+                properties: {
+                    Name: { title: {} },
+                    Date: { date: {} },
+                },
+            },
+        };
+        const res = await notion.createDb(dbProps);
+        return { databaseId: res.id, titleProperty: 'Name', dateProperty: 'Date' };
+    }
+}
+DailySetup.description = 'Configure the daily journal command';
+DailySetup.examples = [
+    {
+        description: 'Point to an existing database (manual)',
+        command: '$ notion-cli daily setup DB_ID_OR_URL',
+    },
+    {
+        description: 'Auto-create a daily journal database',
+        command: '$ notion-cli daily setup --auto PAGE_ID_OR_URL',
+    },
+];
+DailySetup.args = {
+    target: core_1.Args.string({
+        required: false,
+        description: 'Existing database ID or URL (manual mode)',
+    }),
+};
+DailySetup.flags = {
+    auto: core_1.Flags.string({
+        description: 'Auto-create database under this parent page (pass page ID or URL)',
+    }),
+    ...base_flags_1.AutomationFlags,
+};
+exports.default = DailySetup;

package/dist/commands/db/create.d.ts

@@ -0,0 +1,31 @@
+import { Command } from '@oclif/core';
+export default class DbCreate extends Command {
+    static description: string;
+    static aliases: string[];
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static args: {
+        page_id: 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>;
+        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>;
+        title: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        raw: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/db/create.js

@@ -0,0 +1,124 @@
+"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 notion_resolver_1 = require("../../utils/notion-resolver");
+class DbCreate extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(DbCreate);
+        try {
+            // Resolve ID from URL, direct ID, or name (future)
+            const pageId = await (0, notion_resolver_1.resolveNotionId)(args.page_id, 'page');
+            console.log(`Creating a database in page ${pageId}`);
+            const dbTitle = flags.title;
+            // TODO: support other properties
+            const dbProps = {
+                parent: {
+                    type: 'page_id',
+                    page_id: pageId,
+                },
+                title: [
+                    {
+                        type: 'text',
+                        text: {
+                            content: dbTitle,
+                        },
+                    },
+                ],
+                initial_data_source: {
+                    properties: {
+                        Name: {
+                            title: {},
+                        },
+                    },
+                },
+            };
+            const res = await notion.createDb(dbProps);
+            // Handle JSON output for automation
+            if (flags.json) {
+                this.log(JSON.stringify({
+                    success: true,
+                    data: res,
+                    timestamp: new Date().toISOString()
+                }, null, 2));
+                process.exit(0);
+                return;
+            }
+            // Handle raw JSON output (legacy)
+            if (flags.raw) {
+                (0, helper_1.outputRawJson)(res);
+                process.exit(0);
+                return;
+            }
+            // Handle table output
+            const columns = {
+                title: {
+                    get: (row) => {
+                        return (0, helper_1.getDbTitle)(row);
+                    },
+                },
+                object: {},
+                id: {},
+                url: {},
+            };
+            const options = {
+                printLine: this.log.bind(this),
+                ...flags,
+            };
+            (0, table_formatter_1.formatTable)([res], columns, options);
+            process.exit(0);
+        }
+        catch (error) {
+            const cliError = error instanceof errors_1.NotionCLIError
+                ? error
+                : (0, errors_1.wrapNotionError)(error, {
+                    resourceType: 'database',
+                    endpoint: 'databases.create'
+                });
+            if (flags.json) {
+                this.log(JSON.stringify(cliError.toJSON(), null, 2));
+            }
+            else {
+                this.error(cliError.toHumanString());
+            }
+            process.exit(1);
+        }
+    }
+}
+DbCreate.description = 'Create a database with an initial data source (table)';
+DbCreate.aliases = ['db:c'];
+DbCreate.examples = [
+    {
+        description: 'Create a database with an initial data source',
+        command: `$ notion-cli db create PAGE_ID -t 'My Database'`,
+    },
+    {
+        description: 'Create a database using page URL',
+        command: `$ notion-cli db create https://notion.so/PAGE_ID -t 'My Database'`,
+    },
+    {
+        description: 'Create a database with an initial data source and output raw json',
+        command: `$ notion-cli db create PAGE_ID -t 'My Database' -r`,
+    },
+];
+DbCreate.args = {
+    page_id: core_1.Args.string({ required: true, description: 'Parent page ID or URL where the database will be created' }),
+};
+DbCreate.flags = {
+    title: core_1.Flags.string({
+        char: 't',
+        description: 'Title for the database (and initial data source)',
+        required: true,
+    }),
+    raw: core_1.Flags.boolean({
+        char: 'r',
+        description: 'output raw json',
+    }),
+    ...table_formatter_1.tableFlags,
+    ...base_flags_1.AutomationFlags,
+};
+exports.default = DbCreate;

package/dist/commands/db/query.d.ts

@@ -0,0 +1,41 @@
+import { Command } from '@oclif/core';
+export default class DbQuery extends Command {
+    static description: string;
+    static aliases: string[];
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static args: {
+        database_id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        filter: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'file-filter': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        search: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        select: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        rawFilter: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        fileFilter: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        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>;
+        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>;
+        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>;
+        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>;
+        'page-all': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'sort-property': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'sort-direction': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        raw: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}