@infograb/notion-cli 5.9.0

package/dist/utils/table-formatter.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * Table formatting utility to replace oclif v2's ux.table
+ * Provides backward-compatible table flags and formatting
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tableFlags = void 0;
+exports.formatTable = formatTable;
+const core_1 = require("@oclif/core");
+const Table = require("cli-table3");
+/**
+ * Table flags compatible with oclif v2's ux.table.flags()
+ */
+exports.tableFlags = {
+    columns: core_1.Flags.string({
+        description: 'Only show provided columns (comma-separated)',
+        exclusive: ['extended'],
+    }),
+    sort: core_1.Flags.string({
+        description: 'Property to sort by (prepend with - for descending)',
+    }),
+    filter: core_1.Flags.string({
+        description: 'Filter property by substring match',
+    }),
+    csv: core_1.Flags.boolean({
+        description: 'Output in CSV format',
+        exclusive: ['no-truncate'],
+    }),
+    extended: core_1.Flags.boolean({
+        char: 'x',
+        description: 'Show extra columns',
+    }),
+    'no-truncate': core_1.Flags.boolean({
+        description: 'Do not truncate output to fit screen',
+        exclusive: ['csv'],
+    }),
+    'no-header': core_1.Flags.boolean({
+        description: 'Hide table header from output',
+    }),
+};
+/**
+ * Format and display a table (compatible with oclif v2's ux.table)
+ */
+function formatTable(data, columns, options = {}) {
+    if (data.length === 0) {
+        return;
+    }
+    const printLine = options.printLine || console.log;
+    // Filter columns based on options
+    let selectedColumns = Object.keys(columns);
+    if (options.columns) {
+        const requestedCols = options.columns.split(',').map(c => c.trim());
+        selectedColumns = selectedColumns.filter(col => requestedCols.includes(col));
+    }
+    if (!options.extended) {
+        selectedColumns = selectedColumns.filter(col => !columns[col].extended);
+    }
+    // Filter rows
+    let filteredData = data;
+    if (options.filter) {
+        const [filterCol, filterVal] = options.filter.split('=');
+        if (filterVal) {
+            filteredData = data.filter(row => {
+                var _a;
+                const val = ((_a = columns[filterCol]) === null || _a === void 0 ? void 0 : _a.get) ? columns[filterCol].get(row) : row[filterCol];
+                return String(val).includes(filterVal);
+            });
+        }
+    }
+    // Sort data
+    if (options.sort) {
+        const descending = options.sort.startsWith('-');
+        const sortCol = descending ? options.sort.slice(1) : options.sort;
+        filteredData = [...filteredData].sort((a, b) => {
+            var _a, _b;
+            const aVal = ((_a = columns[sortCol]) === null || _a === void 0 ? void 0 : _a.get) ? columns[sortCol].get(a) : a[sortCol];
+            const bVal = ((_b = columns[sortCol]) === null || _b === void 0 ? void 0 : _b.get) ? columns[sortCol].get(b) : b[sortCol];
+            const comparison = String(aVal).localeCompare(String(bVal));
+            return descending ? -comparison : comparison;
+        });
+    }
+    // Output as CSV
+    if (options.csv) {
+        if (!options['no-header']) {
+            const headers = selectedColumns.map(col => columns[col].header || col);
+            printLine(headers.join(','));
+        }
+        filteredData.forEach(row => {
+            const values = selectedColumns.map(col => {
+                const val = columns[col].get ? columns[col].get(row) : row[col];
+                const str = String(val || '');
+                // Escape CSV values
+                return str.includes(',') || str.includes('"') ? `"${str.replace(/"/g, '""')}"` : str;
+            });
+            printLine(values.join(','));
+        });
+        return;
+    }
+    // Output as table
+    const headers = selectedColumns.map(col => columns[col].header || col);
+    const table = new Table({
+        head: options['no-header'] ? [] : headers,
+        style: {
+            head: ['cyan'],
+            border: ['gray']
+        },
+        wordWrap: !options['no-truncate'],
+        colWidths: selectedColumns.map(col => {
+            if (options['no-truncate'])
+                return undefined;
+            return columns[col].minWidth || undefined;
+        }),
+    });
+    filteredData.forEach(row => {
+        const values = selectedColumns.map(col => {
+            const val = columns[col].get ? columns[col].get(row) : row[col];
+            return String(val !== undefined && val !== null ? val : '');
+        });
+        table.push(values);
+    });
+    printLine(table.toString());
+}

package/dist/utils/terminal-banner.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Terminal banner and color utilities for consistent branding
+ * Used across postinstall script and init command
+ */
+/**
+ * ANSI color codes for cross-platform terminal compatibility
+ */
+export declare const colors: {
+    readonly reset: "\u001B[0m";
+    readonly bright: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+    readonly green: "\u001B[32m";
+    readonly blue: "\u001B[34m";
+    readonly cyan: "\u001B[36m";
+    readonly gray: "\u001B[90m";
+    readonly yellow: "\u001B[33m";
+    readonly magenta: "\u001B[35m";
+};
+/**
+ * ASCII art banner for Notion CLI
+ * Displayed during install and setup
+ * Uses terminal's default color (black/white depending on theme)
+ */
+export declare const ASCII_BANNER = "\n\u2588\u2588\u2588\u2557   \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2557   \u2588\u2588\u2557     \u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557     \u2588\u2588\u2557\n\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551    \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551     \u2588\u2588\u2551\n\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551   \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551    \u2588\u2588\u2551     \u2588\u2588\u2551     \u2588\u2588\u2551\n\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551   \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551    \u2588\u2588\u2551     \u2588\u2588\u2551     \u2588\u2588\u2551\n\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D   \u2588\u2588\u2551   \u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551    \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551\n\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D    \u255A\u2550\u255D   \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D\n";

package/dist/utils/terminal-banner.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Terminal banner and color utilities for consistent branding
+ * Used across postinstall script and init command
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASCII_BANNER = exports.colors = void 0;
+/**
+ * ANSI color codes for cross-platform terminal compatibility
+ */
+exports.colors = {
+    reset: '\x1b[0m',
+    bright: '\x1b[1m',
+    dim: '\x1b[2m',
+    green: '\x1b[32m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+    yellow: '\x1b[33m',
+    magenta: '\x1b[35m',
+};
+/**
+ * ASCII art banner for Notion CLI
+ * Displayed during install and setup
+ * Uses terminal's default color (black/white depending on theme)
+ */
+exports.ASCII_BANNER = `
+███╗   ██╗ ██████╗ ████████╗██╗ ██████╗ ███╗   ██╗     ██████╗██╗     ██╗
+████╗  ██║██╔═══██╗╚══██╔══╝██║██╔═══██╗████╗  ██║    ██╔════╝██║     ██║
+██╔██╗ ██║██║   ██║   ██║   ██║██║   ██║██╔██╗ ██║    ██║     ██║     ██║
+██║╚██╗██║██║   ██║   ██║   ██║██║   ██║██║╚██╗██║    ██║     ██║     ██║
+██║ ╚████║╚██████╔╝   ██║   ██║╚██████╔╝██║ ╚████║    ╚██████╗███████╗██║
+╚═╝  ╚═══╝ ╚═════╝    ╚═╝   ╚═╝ ╚═════╝ ╚═╝  ╚═══╝     ╚═════╝╚══════╝╚═╝
+`;

package/dist/utils/token-validator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Token Validation Utility
+ *
+ * Provides consistent token validation across all commands that interact with the Notion API.
+ * This ensures users get helpful, actionable error messages before attempting API calls.
+ */
+/**
+ * Masks a Notion token for safe display in logs and console output
+ *
+ * Shows only the prefix and last 3 characters to prevent token leakage
+ * in screen recordings, terminal sharing, or logs.
+ *
+ * @param token - The token to mask
+ * @returns Masked token string (e.g., "secret_***...***abc")
+ *
+ * @example
+ * ```typescript
+ * const token = "secret_1234567890abcdef"
+ * const masked = maskToken(token)
+ * // Returns: "secret_***...***def"
+ * ```
+ */
+export declare function maskToken(token: string): string;
+/**
+ * Validates that NOTION_TOKEN environment variable is set
+ *
+ * @throws {NotionCLIError} If token is not set, throws with helpful suggestions
+ *
+ * @example
+ * ```typescript
+ * import { validateNotionToken } from '../utils/token-validator'
+ *
+ * // In your command's run() method:
+ * async run() {
+ *   const { flags } = await this.parse(MyCommand)
+ *   validateNotionToken() // Throws if token not set
+ *
+ *   // Continue with API calls...
+ * }
+ * ```
+ */
+/**
+ * Valid Notion token prefixes.
+ * - "secret_": Internal integration tokens (legacy format, still valid)
+ * - "ntn_": New token format introduced September 2024
+ */
+export declare const VALID_TOKEN_PREFIXES: readonly ["secret_", "ntn_"];
+/**
+ * Checks whether a token string has a recognized Notion token prefix.
+ *
+ * @param token - The token to check
+ * @returns true if the token starts with a known Notion prefix
+ */
+export declare function hasValidTokenPrefix(token: string): boolean;
+export declare function validateNotionToken(): void;

package/dist/utils/token-validator.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Token Validation Utility
+ *
+ * Provides consistent token validation across all commands that interact with the Notion API.
+ * This ensures users get helpful, actionable error messages before attempting API calls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_TOKEN_PREFIXES = void 0;
+exports.maskToken = maskToken;
+exports.hasValidTokenPrefix = hasValidTokenPrefix;
+exports.validateNotionToken = validateNotionToken;
+const errors_1 = require("../errors");
+/**
+ * Masks a Notion token for safe display in logs and console output
+ *
+ * Shows only the prefix and last 3 characters to prevent token leakage
+ * in screen recordings, terminal sharing, or logs.
+ *
+ * @param token - The token to mask
+ * @returns Masked token string (e.g., "secret_***...***abc")
+ *
+ * @example
+ * ```typescript
+ * const token = "secret_1234567890abcdef"
+ * const masked = maskToken(token)
+ * // Returns: "secret_***...***def"
+ * ```
+ */
+function maskToken(token) {
+    if (!token)
+        return "";
+    if (token.length <= 10) {
+        // Token too short to safely mask, obscure completely
+        // Threshold: 10 chars ensures at least 3 chars are masked after prefix+suffix
+        return "***";
+    }
+    // Show prefix (secret_ or ntn_) and last 3 chars
+    // For unknown prefixes: use max 4 chars to ensure at least 4 chars are masked
+    const prefix = token.startsWith("secret_")
+        ? "secret_"
+        : token.startsWith("ntn_")
+            ? "ntn_"
+            : token.slice(0, Math.min(4, token.length - 7));
+    const suffix = token.slice(-3);
+    return `${prefix}***...***${suffix}`;
+}
+/**
+ * Validates that NOTION_TOKEN environment variable is set
+ *
+ * @throws {NotionCLIError} If token is not set, throws with helpful suggestions
+ *
+ * @example
+ * ```typescript
+ * import { validateNotionToken } from '../utils/token-validator'
+ *
+ * // In your command's run() method:
+ * async run() {
+ *   const { flags } = await this.parse(MyCommand)
+ *   validateNotionToken() // Throws if token not set
+ *
+ *   // Continue with API calls...
+ * }
+ * ```
+ */
+/**
+ * Valid Notion token prefixes.
+ * - "secret_": Internal integration tokens (legacy format, still valid)
+ * - "ntn_": New token format introduced September 2024
+ */
+exports.VALID_TOKEN_PREFIXES = ["secret_", "ntn_"];
+/**
+ * Checks whether a token string has a recognized Notion token prefix.
+ *
+ * @param token - The token to check
+ * @returns true if the token starts with a known Notion prefix
+ */
+function hasValidTokenPrefix(token) {
+    return exports.VALID_TOKEN_PREFIXES.some((prefix) => token.startsWith(prefix));
+}
+function validateNotionToken() {
+    if (!process.env.NOTION_TOKEN) {
+        throw errors_1.NotionCLIErrorFactory.tokenMissing();
+    }
+}

package/dist/utils/update-notifier.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Update notifier utility
+ * Checks for new versions of notion-cli and notifies users non-intrusively
+ *
+ * Runs asynchronously in background, doesn't block CLI execution
+ * Caches results for 1 day to avoid unnecessary npm registry checks
+ * Respects NO_UPDATE_NOTIFIER environment variable and CI environments
+ */
+/**
+ * Check for updates and notify user if a new version is available
+ *
+ * This runs asynchronously and won't block CLI execution.
+ * Checks are cached for 1 day by default.
+ *
+ * Set DEBUG=1 environment variable to see error messages if update check fails.
+ *
+ * @example
+ * ```bash
+ * # Silent mode (default)
+ * notion-cli --version
+ *
+ * # Debug mode
+ * DEBUG=1 notion-cli --version
+ * ```
+ */
+export declare function checkForUpdates(): void;

package/dist/utils/update-notifier.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Update notifier utility
+ * Checks for new versions of notion-cli and notifies users non-intrusively
+ *
+ * Runs asynchronously in background, doesn't block CLI execution
+ * Caches results for 1 day to avoid unnecessary npm registry checks
+ * Respects NO_UPDATE_NOTIFIER environment variable and CI environments
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkForUpdates = checkForUpdates;
+/**
+ * Check for updates and notify user if a new version is available
+ *
+ * This runs asynchronously and won't block CLI execution.
+ * Checks are cached for 1 day by default.
+ *
+ * Set DEBUG=1 environment variable to see error messages if update check fails.
+ *
+ * @example
+ * ```bash
+ * # Silent mode (default)
+ * notion-cli --version
+ *
+ * # Debug mode
+ * DEBUG=1 notion-cli --version
+ * ```
+ */
+function checkForUpdates() {
+    try {
+        // Load dependencies dynamically to avoid rootDir issues
+        const updateNotifier = require('update-notifier').default || require('update-notifier');
+        const packageJson = require('../../package.json');
+        // Initialize update notifier with package info
+        const notifier = updateNotifier({
+            pkg: packageJson,
+            updateCheckInterval: 1000 * 60 * 60 * 24, // Check once per day
+        });
+        // Show notification if update is available
+        // This displays a yellow-bordered box with update info
+        notifier.notify({
+            defer: true, // Show notification after command completes (non-intrusive)
+            isGlobal: true, // This is a global CLI tool
+        });
+    }
+    catch (error) {
+        // Silently fail - don't break CLI if update check fails
+        // This could happen if npm registry is unreachable, network issues, etc.
+        // Debug mode: Show error details for troubleshooting
+        if (process.env.DEBUG) {
+            console.error('Update check failed:', error instanceof Error ? error.message : error);
+        }
+    }
+}

package/dist/utils/workspace-cache.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Workspace Cache Utility
+ *
+ * Manages persistent caching of workspace databases for fast name-to-ID resolution.
+ * Cache is stored at ~/.notion-cli/databases.json
+ */
+import { GetDataSourceResponse, DataSourceObjectResponse } from '@notionhq/client/build/src/api-endpoints';
+export interface CachedDatabase {
+    id: string;
+    title: string;
+    titleNormalized: string;
+    aliases: string[];
+    url?: string;
+    lastEditedTime?: string;
+    properties?: Record<string, any>;
+}
+export interface WorkspaceCache {
+    version: string;
+    lastSync: string;
+    databases: CachedDatabase[];
+}
+/**
+ * Get the cache directory path
+ */
+export declare function getCacheDir(): string;
+/**
+ * Get the cache file path
+ */
+export declare function getCachePath(): Promise<string>;
+/**
+ * Ensure cache directory exists
+ */
+export declare function ensureCacheDir(): Promise<void>;
+/**
+ * Load cache from disk
+ * Returns null if cache doesn't exist or is corrupted
+ */
+export declare function loadCache(): Promise<WorkspaceCache | null>;
+/**
+ * Save cache to disk (atomic write)
+ */
+export declare function saveCache(data: WorkspaceCache): Promise<void>;
+/**
+ * Generate search aliases from a database title
+ *
+ * @example
+ * generateAliases('Tasks Database')
+ * // Returns: ['tasks database', 'tasks', 'task', 'tasks db', 'task db', 'td']
+ */
+export declare function generateAliases(title: string): string[];
+/**
+ * Build a cached database entry from a data source response
+ */
+export declare function buildCacheEntry(dataSource: GetDataSourceResponse | DataSourceObjectResponse): CachedDatabase;
+/**
+ * Create an empty cache
+ */
+export declare function createEmptyCache(): WorkspaceCache;

package/dist/utils/workspace-cache.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * Workspace Cache Utility
+ *
+ * Manages persistent caching of workspace databases for fast name-to-ID resolution.
+ * Cache is stored at ~/.notion-cli/databases.json
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCacheDir = getCacheDir;
+exports.getCachePath = getCachePath;
+exports.ensureCacheDir = ensureCacheDir;
+exports.loadCache = loadCache;
+exports.saveCache = saveCache;
+exports.generateAliases = generateAliases;
+exports.buildCacheEntry = buildCacheEntry;
+exports.createEmptyCache = createEmptyCache;
+const fs = require("fs/promises");
+const path = require("path");
+const os = require("os");
+const client_1 = require("@notionhq/client");
+const CACHE_VERSION = '1.0.0';
+const CACHE_DIR_NAME = '.notion-cli';
+const CACHE_FILE_NAME = 'databases.json';
+/**
+ * Get the cache directory path
+ */
+function getCacheDir() {
+    return path.join(os.homedir(), CACHE_DIR_NAME);
+}
+/**
+ * Get the cache file path
+ */
+async function getCachePath() {
+    return path.join(getCacheDir(), CACHE_FILE_NAME);
+}
+/**
+ * Ensure cache directory exists
+ */
+async function ensureCacheDir() {
+    const cacheDir = getCacheDir();
+    try {
+        await fs.mkdir(cacheDir, { recursive: true });
+    }
+    catch (error) {
+        if (error.code !== 'EEXIST') {
+            throw new Error(`Failed to create cache directory: ${error.message}`);
+        }
+    }
+}
+/**
+ * Load cache from disk
+ * Returns null if cache doesn't exist or is corrupted
+ */
+async function loadCache() {
+    try {
+        const cachePath = await getCachePath();
+        const content = await fs.readFile(cachePath, 'utf-8');
+        const cache = JSON.parse(content);
+        // Validate cache structure
+        if (!cache.version || !Array.isArray(cache.databases)) {
+            console.warn('Cache file is corrupted, will rebuild on next sync');
+            return null;
+        }
+        return cache;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            // Cache doesn't exist yet
+            return null;
+        }
+        // Parse error or other error
+        console.warn(`Failed to load cache: ${error.message}`);
+        return null;
+    }
+}
+/**
+ * Save cache to disk (atomic write)
+ */
+async function saveCache(data) {
+    await ensureCacheDir();
+    const cachePath = await getCachePath();
+    const tmpPath = `${cachePath}.tmp`;
+    try {
+        // Write to temporary file
+        await fs.writeFile(tmpPath, JSON.stringify(data, null, 2), 'utf-8');
+        // Atomic rename (replaces old file)
+        await fs.rename(tmpPath, cachePath);
+    }
+    catch (error) {
+        // Clean up temp file if it exists
+        try {
+            await fs.unlink(tmpPath);
+        }
+        catch {
+            // Intentionally empty - cache directory may not exist
+        }
+        throw new Error(`Failed to save cache: ${error.message}`);
+    }
+}
+/**
+ * Generate search aliases from a database title
+ *
+ * @example
+ * generateAliases('Tasks Database')
+ * // Returns: ['tasks database', 'tasks', 'task', 'tasks db', 'task db', 'td']
+ */
+function generateAliases(title) {
+    const aliases = new Set();
+    const normalized = title.toLowerCase().trim();
+    // Add full title (normalized)
+    aliases.add(normalized);
+    // Add title without common suffixes
+    const withoutSuffixes = normalized.replace(/\s+(database|db|table|list|tracker|log)$/i, '');
+    if (withoutSuffixes !== normalized) {
+        aliases.add(withoutSuffixes);
+    }
+    // Add title with common suffixes
+    if (withoutSuffixes !== normalized) {
+        aliases.add(`${withoutSuffixes} db`);
+        aliases.add(`${withoutSuffixes} database`);
+    }
+    // Add singular/plural variants
+    if (withoutSuffixes.endsWith('s')) {
+        aliases.add(withoutSuffixes.slice(0, -1)); // Remove 's'
+    }
+    else {
+        aliases.add(`${withoutSuffixes}s`); // Add 's'
+    }
+    // Add acronym if multi-word (e.g., "Meeting Notes" → "mn")
+    const words = withoutSuffixes.split(/\s+/);
+    if (words.length > 1) {
+        const acronym = words.map(w => w[0]).join('');
+        if (acronym.length >= 2) {
+            aliases.add(acronym);
+        }
+    }
+    return Array.from(aliases);
+}
+/**
+ * Build a cached database entry from a data source response
+ */
+function buildCacheEntry(dataSource) {
+    let title = 'Untitled';
+    let properties = {};
+    let url;
+    let lastEditedTime;
+    if ((0, client_1.isFullDataSource)(dataSource)) {
+        if (dataSource.title && dataSource.title.length > 0) {
+            title = dataSource.title[0].plain_text;
+        }
+        // Extract property schema
+        if (dataSource.properties) {
+            properties = dataSource.properties;
+        }
+        // Extract URL if available
+        if ('url' in dataSource) {
+            url = dataSource.url;
+        }
+        // Extract last edited time
+        if ('last_edited_time' in dataSource) {
+            lastEditedTime = dataSource.last_edited_time;
+        }
+    }
+    const titleNormalized = title.toLowerCase().trim();
+    const aliases = generateAliases(title);
+    return {
+        id: dataSource.id,
+        title,
+        titleNormalized,
+        aliases,
+        url,
+        lastEditedTime,
+        properties,
+    };
+}
+/**
+ * Create an empty cache
+ */
+function createEmptyCache() {
+    return {
+        version: CACHE_VERSION,
+        lastSync: new Date().toISOString(),
+        databases: [],
+    };
+}