@infograb/notion-cli 5.9.0

package/dist/commands/sync.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const notion_1 = require("../notion");
+const retry_1 = require("../retry");
+const workspace_cache_1 = require("../utils/workspace-cache");
+const base_flags_1 = require("../base-flags");
+const errors_1 = require("../errors");
+const token_validator_1 = require("../utils/token-validator");
+class Sync extends core_1.Command {
+    async run() {
+        const { flags } = await this.parse(Sync);
+        const startTime = Date.now();
+        try {
+            // Verify NOTION_TOKEN is set (throws if not)
+            (0, token_validator_1.validateNotionToken)();
+            if (!flags.json) {
+                core_1.ux.action.start('Syncing workspace databases');
+            }
+            // Fetch all databases from Notion API with progress updates
+            const databases = await this.fetchAllDatabases(flags.json);
+            // const _fetchTime = Date.now() - startTime
+            if (!flags.json) {
+                core_1.ux.action.stop(`Found ${databases.length} database${databases.length === 1 ? '' : 's'}`);
+                core_1.ux.action.start('Generating search aliases');
+            }
+            // Build cache entries
+            const cacheEntries = databases.map(db => (0, workspace_cache_1.buildCacheEntry)(db));
+            if (!flags.json) {
+                core_1.ux.action.stop();
+                core_1.ux.action.start('Saving cache');
+            }
+            // Save to cache
+            const cache = {
+                version: '1.0.0',
+                lastSync: new Date().toISOString(),
+                databases: cacheEntries,
+            };
+            await (0, workspace_cache_1.saveCache)(cache);
+            const cachePath = await (0, workspace_cache_1.getCachePath)();
+            const executionTime = Date.now() - startTime;
+            // Build comprehensive metadata
+            const metadata = {
+                sync_time: new Date().toISOString(),
+                execution_time_ms: executionTime,
+                databases_found: databases.length,
+                cache_ttls: {
+                    in_memory: {
+                        data_source_ms: parseInt(process.env.NOTION_CLI_CACHE_DS_TTL || '600000', 10),
+                        page_ms: parseInt(process.env.NOTION_CLI_CACHE_PAGE_TTL || '60000', 10),
+                        user_ms: parseInt(process.env.NOTION_CLI_CACHE_USER_TTL || '3600000', 10),
+                        block_ms: parseInt(process.env.NOTION_CLI_CACHE_BLOCK_TTL || '30000', 10),
+                    },
+                    workspace: {
+                        persistence: 'until next sync',
+                        recommended_sync_interval_hours: 24,
+                    },
+                },
+                next_recommended_sync: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString(),
+                cache_location: cachePath,
+            };
+            if (flags.json) {
+                this.log(JSON.stringify({
+                    success: true,
+                    data: {
+                        databases: cacheEntries.map(db => ({
+                            id: db.id,
+                            title: db.title,
+                            aliases: db.aliases,
+                            url: db.url,
+                        })),
+                        summary: {
+                            total: databases.length,
+                            cached_at: cache.lastSync,
+                            cache_version: cache.version,
+                        },
+                    },
+                    metadata,
+                }, null, 2));
+            }
+            else {
+                core_1.ux.action.stop();
+                // Enhanced completion summary
+                const elapsedSeconds = (executionTime / 1000).toFixed(2);
+                this.log(`\n✓ Synced ${databases.length} database${databases.length === 1 ? '' : 's'} in ${elapsedSeconds}s`);
+                this.log('');
+                this.log(`📁 Cache: ${cachePath}`);
+                this.log(`🕐 Last updated: ${new Date(cache.lastSync).toLocaleString()}`);
+                this.log(`📊 Databases: ${databases.length} total`);
+                this.log('');
+                this.log(`Next sync recommended: ${new Date(metadata.next_recommended_sync).toLocaleString()}`);
+                if (databases.length > 0) {
+                    this.log('\nIndexed databases:');
+                    cacheEntries.slice(0, 10).forEach(db => {
+                        const aliasesStr = db.aliases.slice(0, 3).join(', ');
+                        this.log(`  • ${db.title} (aliases: ${aliasesStr})`);
+                    });
+                    if (databases.length > 10) {
+                        this.log(`  ... and ${databases.length - 10} more`);
+                    }
+                    this.log('\nTry: notion-cli list');
+                }
+                else {
+                    this.log('\nNo databases found in workspace.');
+                    this.log('Make sure your integration has access to databases.');
+                }
+            }
+            process.exit(0);
+        }
+        catch (error) {
+            const cliError = error instanceof errors_1.NotionCLIError
+                ? error
+                : (0, errors_1.wrapNotionError)(error, {
+                    endpoint: 'search',
+                    resourceType: 'database'
+                });
+            if (flags.json) {
+                this.log(JSON.stringify(cliError.toJSON(), null, 2));
+            }
+            else {
+                core_1.ux.action.stop('failed');
+                this.error(cliError.toHumanString());
+            }
+            process.exit(1);
+        }
+    }
+    /**
+     * Fetch all databases from Notion API with pagination
+     */
+    async fetchAllDatabases(isJsonMode) {
+        const databases = [];
+        let cursor = undefined;
+        while (true) {
+            const response = await (0, retry_1.fetchWithRetry)(() => notion_1.client.search({
+                filter: {
+                    value: 'data_source',
+                    property: 'object',
+                },
+                start_cursor: cursor,
+                page_size: 100, // Max allowed by API
+            }), {
+                context: 'sync:fetchAllDatabases',
+                config: { maxRetries: 5 }, // Higher retries for sync
+            });
+            databases.push(...response.results);
+            // Show progress update (only in non-JSON mode)
+            if (!isJsonMode && response.has_more) {
+                // Update the spinner text to show current count
+                core_1.ux.action.start(`Syncing workspace databases (found ${databases.length} so far)`);
+            }
+            if (!response.has_more || !response.next_cursor) {
+                break;
+            }
+            cursor = response.next_cursor;
+        }
+        return databases;
+    }
+}
+Sync.description = 'Sync workspace databases to local cache for fast lookups';
+Sync.aliases = ['db:sync'];
+Sync.examples = [
+    {
+        description: 'Sync all workspace databases',
+        command: 'notion-cli sync',
+    },
+    {
+        description: 'Force resync even if cache exists',
+        command: 'notion-cli sync --force',
+    },
+    {
+        description: 'Sync and output as JSON',
+        command: 'notion-cli sync --json',
+    },
+];
+Sync.flags = {
+    force: core_1.Flags.boolean({
+        char: 'f',
+        description: 'Force resync even if cache is fresh',
+        default: false,
+    }),
+    ...base_flags_1.AutomationFlags,
+};
+exports.default = Sync;

package/dist/commands/user/list.d.ts

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

package/dist/commands/user/list.js

@@ -0,0 +1,99 @@
+"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");
+class UserList extends core_1.Command {
+    async run() {
+        const { flags } = await this.parse(UserList);
+        try {
+            let res = await notion.listUser();
+            // Apply minimal flag to strip metadata
+            if (flags.minimal) {
+                res = (0, helper_1.stripMetadata)(res);
+            }
+            // 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 = {
+                id: {},
+                name: {},
+                object: {},
+                type: {},
+                person_or_bot: {
+                    header: 'person/bot',
+                    get: (row) => {
+                        if (row.type === 'person') {
+                            return row.person;
+                        }
+                        return row.bot;
+                    },
+                },
+                avatar_url: {},
+            };
+            const options = {
+                printLine: this.log.bind(this),
+                ...flags,
+            };
+            (0, table_formatter_1.formatTable)(res.results, columns, options);
+            process.exit(0);
+        }
+        catch (error) {
+            const cliError = error instanceof errors_1.NotionCLIError
+                ? error
+                : (0, errors_1.wrapNotionError)(error, {
+                    resourceType: 'user',
+                    endpoint: 'users.list'
+                });
+            if (flags.json) {
+                this.log(JSON.stringify(cliError.toJSON(), null, 2));
+            }
+            else {
+                this.error(cliError.toHumanString());
+            }
+            process.exit(1);
+        }
+    }
+}
+UserList.description = 'List all users';
+UserList.aliases = ['user:l'];
+UserList.examples = [
+    {
+        description: 'List all users',
+        command: `$ notion-cli user list`,
+    },
+    {
+        description: 'List all users and output raw json',
+        command: `$ notion-cli user list -r`,
+    },
+    {
+        description: 'List all users and output JSON for automation',
+        command: `$ notion-cli user list --json`,
+    },
+];
+UserList.flags = {
+    raw: core_1.Flags.boolean({
+        char: 'r',
+        description: 'output raw json',
+    }),
+    ...table_formatter_1.tableFlags,
+    ...base_flags_1.AutomationFlags,
+};
+exports.default = UserList;

package/dist/commands/user/retrieve/bot.d.ts

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

package/dist/commands/user/retrieve/bot.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const notion = require("../../../notion");
+const helper_1 = require("../../../helper");
+const base_flags_1 = require("../../../base-flags");
+const errors_1 = require("../../../errors");
+const table_formatter_1 = require("../../../utils/table-formatter");
+class UserRetrieveBot extends core_1.Command {
+    async run() {
+        const { flags } = await this.parse(UserRetrieveBot);
+        try {
+            const res = await notion.botUser();
+            // 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 = {
+                id: {},
+                name: {},
+                object: {},
+                type: {},
+                person_or_bot: {
+                    header: 'person/bot',
+                    get: (row) => {
+                        if (row.type === 'person') {
+                            return row.person;
+                        }
+                        return row.bot;
+                    },
+                },
+                avatar_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: 'user',
+                    endpoint: 'users.me'
+                });
+            if (flags.json) {
+                this.log(JSON.stringify(cliError.toJSON(), null, 2));
+            }
+            else {
+                this.error(cliError.toHumanString());
+            }
+            process.exit(1);
+        }
+    }
+}
+UserRetrieveBot.description = 'Retrieve a bot user';
+UserRetrieveBot.aliases = ['user:r:b'];
+UserRetrieveBot.examples = [
+    {
+        description: 'Retrieve a bot user',
+        command: `$ notion-cli user retrieve:bot`,
+    },
+    {
+        description: 'Retrieve a bot user and output raw json',
+        command: `$ notion-cli user retrieve:bot -r`,
+    },
+    {
+        description: 'Retrieve a bot user and output JSON for automation',
+        command: `$ notion-cli user retrieve:bot --json`,
+    },
+];
+UserRetrieveBot.args = {};
+UserRetrieveBot.flags = {
+    raw: core_1.Flags.boolean({
+        char: 'r',
+        description: 'output raw json',
+    }),
+    ...table_formatter_1.tableFlags,
+    ...base_flags_1.AutomationFlags,
+};
+exports.default = UserRetrieveBot;

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

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

package/dist/commands/user/retrieve.js

@@ -0,0 +1,103 @@
+"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");
+class UserRetrieve extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(UserRetrieve);
+        try {
+            let res = await notion.retrieveUser(args.user_id);
+            // Apply minimal flag to strip metadata
+            if (flags.minimal) {
+                res = (0, helper_1.stripMetadata)(res);
+            }
+            // 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 = {
+                id: {},
+                name: {},
+                object: {},
+                type: {},
+                person_or_bot: {
+                    header: 'person/bot',
+                    get: (row) => {
+                        if (row.type === 'person') {
+                            return row.person;
+                        }
+                        return row.bot;
+                    },
+                },
+                avatar_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: 'user',
+                    attemptedId: args.user_id,
+                    endpoint: 'users.retrieve'
+                });
+            if (flags.json) {
+                this.log(JSON.stringify(cliError.toJSON(), null, 2));
+            }
+            else {
+                this.error(cliError.toHumanString());
+            }
+            process.exit(1);
+        }
+    }
+}
+UserRetrieve.description = 'Retrieve a user';
+UserRetrieve.aliases = ['user:r'];
+UserRetrieve.examples = [
+    {
+        description: 'Retrieve a user',
+        command: `$ notion-cli user retrieve USER_ID`,
+    },
+    {
+        description: 'Retrieve a user and output raw json',
+        command: `$ notion-cli user retrieve USER_ID -r`,
+    },
+    {
+        description: 'Retrieve a user and output JSON for automation',
+        command: `$ notion-cli user retrieve USER_ID --json`,
+    },
+];
+UserRetrieve.args = {
+    user_id: core_1.Args.string(),
+};
+UserRetrieve.flags = {
+    raw: core_1.Flags.boolean({
+        char: 'r',
+        description: 'output raw json',
+    }),
+    ...table_formatter_1.tableFlags,
+    ...base_flags_1.AutomationFlags,
+};
+exports.default = UserRetrieve;

package/dist/commands/whoami.d.ts

@@ -0,0 +1,19 @@
+import { Command } from '@oclif/core';
+export default class Whoami extends Command {
+    static description: string;
+    static aliases: string[];
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    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>;
+}