@n24q02m/better-notion-mcp 1.0.0

package/build/src/tools/composite/workspace.js

@@ -0,0 +1,72 @@
+/**
+ * Workspace Mega Tool
+ * Workspace exploration and info
+ */
+import { NotionMCPError, withErrorHandling } from '../helpers/errors.js';
+import { autoPaginate } from '../helpers/pagination.js';
+/**
+ * Unified workspace tool
+ * Maps to: GET /v1/users/me and POST /v1/search
+ */
+export async function workspace(notion, input) {
+    return withErrorHandling(async () => {
+        switch (input.action) {
+            case 'info': {
+                const botUser = await notion.users.retrieve({ user_id: 'me' });
+                return {
+                    action: 'info',
+                    bot: {
+                        id: botUser.id,
+                        name: botUser.name || 'Bot',
+                        type: botUser.type,
+                        owner: botUser.bot?.owner
+                    }
+                };
+            }
+            case 'search': {
+                if (!input.query) {
+                    throw new NotionMCPError('query required for search action', 'VALIDATION_ERROR', 'Provide search query');
+                }
+                const searchParams = {
+                    query: input.query
+                };
+                if (input.filter?.object) {
+                    searchParams.filter = {
+                        value: input.filter.object,
+                        property: 'object'
+                    };
+                }
+                if (input.sort) {
+                    searchParams.sort = {
+                        direction: input.sort.direction || 'descending',
+                        timestamp: input.sort.timestamp || 'last_edited_time'
+                    };
+                }
+                // Fetch results with pagination
+                const allResults = await autoPaginate((cursor) => notion.search({
+                    ...searchParams,
+                    start_cursor: cursor,
+                    page_size: 100
+                }));
+                const results = input.limit ? allResults.slice(0, input.limit) : allResults;
+                return {
+                    action: 'search',
+                    query: input.query,
+                    total: results.length,
+                    results: results.map((item) => ({
+                        id: item.id,
+                        object: item.object,
+                        title: item.object === 'page'
+                            ? (item.properties?.title?.title?.[0]?.plain_text || item.properties?.Name?.title?.[0]?.plain_text || 'Untitled')
+                            : (item.title?.[0]?.plain_text || 'Untitled'),
+                        url: item.url,
+                        last_edited_time: item.last_edited_time
+                    }))
+                };
+            }
+            default:
+                throw new NotionMCPError(`Unknown action: ${input.action}`, 'VALIDATION_ERROR', 'Supported actions: info, search');
+        }
+    })();
+}
+//# sourceMappingURL=workspace.js.map

package/build/src/tools/composite/workspace.js.map

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

package/build/src/tools/helpers/errors.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Error Handling Utilities
+ * AI-friendly error messages and suggestions
+ */
+export declare class NotionMCPError extends Error {
+    code: string;
+    suggestion?: string | undefined;
+    details?: any | undefined;
+    constructor(message: string, code: string, suggestion?: string | undefined, details?: any | undefined);
+    toJSON(): {
+        error: string;
+        code: string;
+        message: string;
+        suggestion: string | undefined;
+        details: any;
+    };
+}
+/**
+ * Enhance Notion API error with helpful context
+ */
+export declare function enhanceError(error: any): NotionMCPError;
+/**
+ * Create AI-readable error message
+ */
+export declare function aiReadableMessage(error: NotionMCPError): string;
+/**
+ * Suggest fixes based on error
+ */
+export declare function suggestFixes(error: NotionMCPError): string[];
+/**
+ * Wrap async function with error handling
+ */
+export declare function withErrorHandling<T extends (...args: any[]) => Promise<any>>(fn: T): (...args: Parameters<T>) => Promise<ReturnType<T>>;
+/**
+ * Retry with exponential backoff
+ */
+export declare function retryWithBackoff<T>(fn: () => Promise<T>, options?: {
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffMultiplier?: number;
+}): Promise<T>;
+//# sourceMappingURL=errors.d.ts.map

package/build/src/tools/helpers/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/tools/helpers/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,cAAe,SAAQ,KAAK;IAG9B,IAAI,EAAE,MAAM;IACZ,UAAU,CAAC,EAAE,MAAM;IACnB,OAAO,CAAC,EAAE,GAAG;gBAHpB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,OAAO,CAAC,EAAE,GAAG,YAAA;IAMtB,MAAM;;;;;;;CASP;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,GAAG,cAAc,CAsBvD;AA6ED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAY/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CAyC5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EAC1E,EAAE,EAAE,CAAC,GACJ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAQpD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CACtB,GACL,OAAO,CAAC,CAAC,CAAC,CAkCZ"}

package/build/src/tools/helpers/errors.js

@@ -0,0 +1,162 @@
+/**
+ * Error Handling Utilities
+ * AI-friendly error messages and suggestions
+ */
+export class NotionMCPError extends Error {
+    constructor(message, code, suggestion, details) {
+        super(message);
+        this.code = code;
+        this.suggestion = suggestion;
+        this.details = details;
+        this.name = 'NotionMCPError';
+    }
+    toJSON() {
+        return {
+            error: this.name,
+            code: this.code,
+            message: this.message,
+            suggestion: this.suggestion,
+            details: this.details
+        };
+    }
+}
+/**
+ * Enhance Notion API error with helpful context
+ */
+export function enhanceError(error) {
+    // Notion API error
+    if (error.code) {
+        return handleNotionError(error);
+    }
+    // Network error
+    if (error.message?.includes('ECONNREFUSED') || error.message?.includes('ENOTFOUND')) {
+        return new NotionMCPError('Cannot connect to Notion API', 'NETWORK_ERROR', 'Check your internet connection and try again');
+    }
+    // Generic error
+    return new NotionMCPError(error.message || 'Unknown error occurred', 'UNKNOWN_ERROR', 'Please check your request and try again', error);
+}
+/**
+ * Handle specific Notion API errors
+ */
+function handleNotionError(error) {
+    const code = error.code;
+    const message = error.message || 'Unknown Notion API error';
+    // Log full error for debugging
+    console.error('Notion API Error:', JSON.stringify({
+        code,
+        message,
+        body: error.body,
+        status: error.status
+    }, null, 2));
+    switch (code) {
+        case 'unauthorized':
+            return new NotionMCPError('Invalid or missing Notion API token', 'UNAUTHORIZED', 'Set NOTION_TOKEN environment variable with a valid integration token from https://www.notion.so/my-integrations');
+        case 'restricted_resource':
+            return new NotionMCPError('Integration does not have access to this resource', 'RESTRICTED_RESOURCE', 'Share the page/database with your integration in Notion settings');
+        case 'object_not_found':
+            return new NotionMCPError('Page or database not found', 'NOT_FOUND', 'Check that the ID is correct and the resource exists');
+        case 'validation_error':
+            return new NotionMCPError('Invalid request parameters', 'VALIDATION_ERROR', 'Check the API documentation for valid parameter formats', error.details);
+        case 'rate_limited':
+            return new NotionMCPError('Too many requests to Notion API', 'RATE_LIMITED', 'Wait a few seconds and try again. Consider batching operations.');
+        case 'conflict_error':
+            return new NotionMCPError('Conflict with existing data', 'CONFLICT', 'The resource may have been modified. Refresh and try again.');
+        case 'service_unavailable':
+            return new NotionMCPError('Notion API is temporarily unavailable', 'SERVICE_UNAVAILABLE', 'Wait a moment and try again. Check https://status.notion.so for updates.');
+        default:
+            return new NotionMCPError(message, code.toUpperCase(), 'Check the Notion API documentation for this error code');
+    }
+}
+/**
+ * Create AI-readable error message
+ */
+export function aiReadableMessage(error) {
+    let message = `❌ ${error.message}`;
+    if (error.suggestion) {
+        message += `\n\n💡 Suggestion: ${error.suggestion}`;
+    }
+    if (error.details) {
+        message += `\n\n📋 Details: ${JSON.stringify(error.details, null, 2)}`;
+    }
+    return message;
+}
+/**
+ * Suggest fixes based on error
+ */
+export function suggestFixes(error) {
+    const suggestions = [];
+    switch (error.code) {
+        case 'UNAUTHORIZED':
+            suggestions.push('Check that NOTION_TOKEN is set in your environment');
+            suggestions.push('Verify token at https://www.notion.so/my-integrations');
+            suggestions.push('Create a new integration token if needed');
+            break;
+        case 'RESTRICTED_RESOURCE':
+            suggestions.push('Open the page/database in Notion');
+            suggestions.push('Click "..." menu → Add connections → Select your integration');
+            suggestions.push('Grant access to parent pages if needed');
+            break;
+        case 'NOT_FOUND':
+            suggestions.push('Verify the page/database ID is correct');
+            suggestions.push('Check that the resource was not deleted');
+            suggestions.push('Ensure you have access permissions');
+            break;
+        case 'VALIDATION_ERROR':
+            suggestions.push('Check parameter types and formats');
+            suggestions.push('Review required vs optional parameters');
+            suggestions.push('Verify property names match database schema');
+            break;
+        case 'RATE_LIMITED':
+            suggestions.push('Reduce request frequency');
+            suggestions.push('Implement exponential backoff retry logic');
+            suggestions.push('Batch multiple operations together');
+            break;
+        default:
+            suggestions.push('Check Notion API status at https://status.notion.so');
+            suggestions.push('Review request parameters');
+            suggestions.push('Try again in a few moments');
+    }
+    return suggestions;
+}
+/**
+ * Wrap async function with error handling
+ */
+export function withErrorHandling(fn) {
+    return async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (error) {
+            throw enhanceError(error);
+        }
+    };
+}
+/**
+ * Retry with exponential backoff
+ */
+export async function retryWithBackoff(fn, options = {}) {
+    const { maxRetries = 3, initialDelay = 1000, maxDelay = 10000, backoffMultiplier = 2 } = options;
+    let lastError;
+    let delay = initialDelay;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry on certain errors
+            if (error.code === 'UNAUTHORIZED' || error.code === 'NOT_FOUND') {
+                throw enhanceError(error);
+            }
+            // Last attempt
+            if (attempt === maxRetries) {
+                break;
+            }
+            // Wait with exponential backoff
+            await new Promise(resolve => setTimeout(resolve, delay));
+            delay = Math.min(delay * backoffMultiplier, maxDelay);
+        }
+    }
+    throw enhanceError(lastError);
+}
+//# sourceMappingURL=errors.js.map

package/build/src/tools/helpers/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/tools/helpers/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YACE,OAAe,EACR,IAAY,EACZ,UAAmB,EACnB,OAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAA;QAJP,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAS;QACnB,YAAO,GAAP,OAAO,CAAM;QAGpB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;IAC9B,CAAC;IAED,MAAM;QACJ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAA;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAU;IACrC,mBAAmB;IACnB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAA;IACjC,CAAC;IAED,gBAAgB;IAChB,IAAI,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACpF,OAAO,IAAI,cAAc,CACvB,8BAA8B,EAC9B,eAAe,EACf,8CAA8C,CAC/C,CAAA;IACH,CAAC;IAED,gBAAgB;IAChB,OAAO,IAAI,cAAc,CACvB,KAAK,CAAC,OAAO,IAAI,wBAAwB,EACzC,eAAe,EACf,yCAAyC,EACzC,KAAK,CACN,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAU;IACnC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IACvB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,0BAA0B,CAAA;IAE3D,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC;QAChD,IAAI;QACJ,OAAO;QACP,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;IAEZ,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,cAAc;YACjB,OAAO,IAAI,cAAc,CACvB,qCAAqC,EACrC,cAAc,EACd,iHAAiH,CAClH,CAAA;QAEH,KAAK,qBAAqB;YACxB,OAAO,IAAI,cAAc,CACvB,mDAAmD,EACnD,qBAAqB,EACrB,kEAAkE,CACnE,CAAA;QAEH,KAAK,kBAAkB;YACrB,OAAO,IAAI,cAAc,CACvB,4BAA4B,EAC5B,WAAW,EACX,sDAAsD,CACvD,CAAA;QAEH,KAAK,kBAAkB;YACrB,OAAO,IAAI,cAAc,CACvB,4BAA4B,EAC5B,kBAAkB,EAClB,yDAAyD,EACzD,KAAK,CAAC,OAAO,CACd,CAAA;QAEH,KAAK,cAAc;YACjB,OAAO,IAAI,cAAc,CACvB,iCAAiC,EACjC,cAAc,EACd,iEAAiE,CAClE,CAAA;QAEH,KAAK,gBAAgB;YACnB,OAAO,IAAI,cAAc,CACvB,6BAA6B,EAC7B,UAAU,EACV,6DAA6D,CAC9D,CAAA;QAEH,KAAK,qBAAqB;YACxB,OAAO,IAAI,cAAc,CACvB,uCAAuC,EACvC,qBAAqB,EACrB,0EAA0E,CAC3E,CAAA;QAEH;YACE,OAAO,IAAI,cAAc,CACvB,OAAO,EACP,IAAI,CAAC,WAAW,EAAE,EAClB,wDAAwD,CACzD,CAAA;IACL,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAqB;IACrD,IAAI,OAAO,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,CAAA;IAElC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,OAAO,IAAI,sBAAsB,KAAK,CAAC,UAAU,EAAE,CAAA;IACrD,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,IAAI,mBAAmB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAA;IACxE,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAqB;IAChD,MAAM,WAAW,GAAa,EAAE,CAAA;IAEhC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,cAAc;YACjB,WAAW,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAA;YACtE,WAAW,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAA;YACzE,WAAW,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAA;YAC5D,MAAK;QAEP,KAAK,qBAAqB;YACxB,WAAW,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAA;YACpD,WAAW,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAA;YAChF,WAAW,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAA;YAC1D,MAAK;QAEP,KAAK,WAAW;YACd,WAAW,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAA;YAC1D,WAAW,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAA;YAC3D,WAAW,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAA;YACtD,MAAK;QAEP,KAAK,kBAAkB;YACrB,WAAW,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAA;YACrD,WAAW,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAA;YAC1D,WAAW,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAA;YAC/D,MAAK;QAEP,KAAK,cAAc;YACjB,WAAW,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;YAC5C,WAAW,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAA;YAC7D,WAAW,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAA;YACtD,MAAK;QAEP;YACE,WAAW,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAA;YACvE,WAAW,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;YAC7C,WAAW,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;IAClD,CAAC;IAED,OAAO,WAAW,CAAA;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAK;IAEL,OAAO,KAAK,EAAE,GAAG,IAAmB,EAA0B,EAAE;QAC9D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,CAAC,KAAK,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAoB,EACpB,UAKI,EAAE;IAEN,MAAM,EACJ,UAAU,GAAG,CAAC,EACd,YAAY,GAAG,IAAI,EACnB,QAAQ,GAAG,KAAK,EAChB,iBAAiB,GAAG,CAAC,EACtB,GAAG,OAAO,CAAA;IAEX,IAAI,SAAc,CAAA;IAClB,IAAI,KAAK,GAAG,YAAY,CAAA;IAExB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAA;QACnB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,SAAS,GAAG,KAAK,CAAA;YAEjB,gCAAgC;YAChC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAChE,MAAM,YAAY,CAAC,KAAK,CAAC,CAAA;YAC3B,CAAC;YAED,eAAe;YACf,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC3B,MAAK;YACP,CAAC;YAED,gCAAgC;YAChC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;YACxD,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,iBAAiB,EAAE,QAAQ,CAAC,CAAA;QACvD,CAAC;IACH,CAAC;IAED,MAAM,YAAY,CAAC,SAAS,CAAC,CAAA;AAC/B,CAAC"}

package/build/src/tools/helpers/markdown.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Markdown to Notion Blocks Converter
+ * Converts markdown text to Notion block format
+ */
+export interface NotionBlock {
+    object: 'block';
+    type: string;
+    [key: string]: any;
+}
+export interface RichText {
+    type: 'text';
+    text: {
+        content: string;
+        link?: {
+            url: string;
+        } | null;
+    };
+    annotations: {
+        bold: boolean;
+        italic: boolean;
+        strikethrough: boolean;
+        underline: boolean;
+        code: boolean;
+        color: string;
+    };
+    plain_text?: string;
+    href?: string | null;
+}
+/**
+ * Convert markdown string to Notion blocks
+ */
+export declare function markdownToBlocks(markdown: string): NotionBlock[];
+/**
+ * Convert Notion blocks to markdown
+ */
+export declare function blocksToMarkdown(blocks: NotionBlock[]): string;
+/**
+ * Parse inline markdown formatting to rich text
+ */
+export declare function parseRichText(text: string): RichText[];
+/**
+ * Extract plain text from rich text
+ */
+export declare function extractPlainText(richText: RichText[]): string;
+//# sourceMappingURL=markdown.d.ts.map

package/build/src/tools/helpers/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../../src/tools/helpers/markdown.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KAC9B,CAAA;IACD,WAAW,EAAE;QACX,IAAI,EAAE,OAAO,CAAA;QACb,MAAM,EAAE,OAAO,CAAA;QACf,aAAa,EAAE,OAAO,CAAA;QACtB,SAAS,EAAE,OAAO,CAAA;QAClB,IAAI,EAAE,OAAO,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;IACD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAwEhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAyC9D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CA0FtD;AAuBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,CAE7D"}

package/build/src/tools/helpers/markdown.js

@@ -0,0 +1,320 @@
+/**
+ * Markdown to Notion Blocks Converter
+ * Converts markdown text to Notion block format
+ */
+/**
+ * Convert markdown string to Notion blocks
+ */
+export function markdownToBlocks(markdown) {
+    const lines = markdown.split('\n');
+    const blocks = [];
+    let currentList = [];
+    let currentListType = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Flush list if we're not in a list anymore
+        if (currentListType && !isListItem(line)) {
+            blocks.push(...currentList);
+            currentList = [];
+            currentListType = null;
+        }
+        // Skip empty lines
+        if (!line.trim()) {
+            continue;
+        }
+        // Heading
+        if (line.startsWith('# ')) {
+            blocks.push(createHeading(1, line.slice(2)));
+        }
+        else if (line.startsWith('## ')) {
+            blocks.push(createHeading(2, line.slice(3)));
+        }
+        else if (line.startsWith('### ')) {
+            blocks.push(createHeading(3, line.slice(4)));
+        }
+        // Code block
+        else if (line.startsWith('```')) {
+            const language = line.slice(3).trim();
+            const codeLines = [];
+            i++;
+            while (i < lines.length && !lines[i].startsWith('```')) {
+                codeLines.push(lines[i]);
+                i++;
+            }
+            blocks.push(createCodeBlock(codeLines.join('\n'), language));
+        }
+        // Bulleted list
+        else if (line.match(/^[\-\*]\s/)) {
+            const text = line.slice(2);
+            currentListType = 'bulleted';
+            currentList.push(createBulletedListItem(text));
+        }
+        // Numbered list
+        else if (line.match(/^\d+\.\s/)) {
+            const text = line.replace(/^\d+\.\s/, '');
+            currentListType = 'numbered';
+            currentList.push(createNumberedListItem(text));
+        }
+        // Quote
+        else if (line.startsWith('> ')) {
+            blocks.push(createQuote(line.slice(2)));
+        }
+        // Divider
+        else if (line.match(/^[\-\*]{3,}$/)) {
+            blocks.push(createDivider());
+        }
+        // Regular paragraph
+        else {
+            blocks.push(createParagraph(line));
+        }
+    }
+    // Flush remaining list
+    if (currentList.length > 0) {
+        blocks.push(...currentList);
+    }
+    return blocks;
+}
+/**
+ * Convert Notion blocks to markdown
+ */
+export function blocksToMarkdown(blocks) {
+    const lines = [];
+    for (const block of blocks) {
+        switch (block.type) {
+            case 'heading_1':
+                lines.push(`# ${richTextToMarkdown(block.heading_1.rich_text)}`);
+                break;
+            case 'heading_2':
+                lines.push(`## ${richTextToMarkdown(block.heading_2.rich_text)}`);
+                break;
+            case 'heading_3':
+                lines.push(`### ${richTextToMarkdown(block.heading_3.rich_text)}`);
+                break;
+            case 'paragraph':
+                lines.push(richTextToMarkdown(block.paragraph.rich_text));
+                break;
+            case 'bulleted_list_item':
+                lines.push(`- ${richTextToMarkdown(block.bulleted_list_item.rich_text)}`);
+                break;
+            case 'numbered_list_item':
+                lines.push(`1. ${richTextToMarkdown(block.numbered_list_item.rich_text)}`);
+                break;
+            case 'code':
+                lines.push('```' + (block.code.language || ''));
+                lines.push(richTextToMarkdown(block.code.rich_text));
+                lines.push('```');
+                break;
+            case 'quote':
+                lines.push(`> ${richTextToMarkdown(block.quote.rich_text)}`);
+                break;
+            case 'divider':
+                lines.push('---');
+                break;
+            default:
+                // Unsupported block type, skip
+                break;
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Parse inline markdown formatting to rich text
+ */
+export function parseRichText(text) {
+    const richText = [];
+    let current = '';
+    let bold = false;
+    let italic = false;
+    let code = false;
+    let strikethrough = false;
+    for (let i = 0; i < text.length; i++) {
+        const char = text[i];
+        const next = text[i + 1];
+        // Link [text](url)
+        if (char === '[') {
+            const closeBracket = text.indexOf(']', i);
+            const openParen = closeBracket !== -1 ? text.indexOf('(', closeBracket) : -1;
+            const closeParen = openParen !== -1 ? text.indexOf(')', openParen) : -1;
+            if (closeBracket !== -1 && openParen === closeBracket + 1 && closeParen !== -1) {
+                if (current) {
+                    richText.push(createRichText(current, { bold, italic, code, strikethrough }));
+                    current = '';
+                }
+                const linkText = text.slice(i + 1, closeBracket);
+                const linkUrl = text.slice(openParen + 1, closeParen);
+                richText.push({
+                    type: 'text',
+                    text: { content: linkText, link: { url: linkUrl } },
+                    annotations: {
+                        bold, italic, strikethrough,
+                        underline: false,
+                        code,
+                        color: 'default'
+                    }
+                });
+                i = closeParen;
+                continue;
+            }
+        }
+        // Bold **text**
+        if (char === '*' && next === '*') {
+            if (current) {
+                richText.push(createRichText(current, { bold, italic, code, strikethrough }));
+                current = '';
+            }
+            bold = !bold;
+            i++; // Skip next *
+            continue;
+        }
+        // Italic *text*
+        else if (char === '*' && next !== '*') {
+            if (current) {
+                richText.push(createRichText(current, { bold, italic, code, strikethrough }));
+                current = '';
+            }
+            italic = !italic;
+            continue;
+        }
+        // Code `text`
+        else if (char === '`') {
+            if (current) {
+                richText.push(createRichText(current, { bold, italic, code, strikethrough }));
+                current = '';
+            }
+            code = !code;
+            continue;
+        }
+        // Strikethrough ~~text~~
+        else if (char === '~' && next === '~') {
+            if (current) {
+                richText.push(createRichText(current, { bold, italic, code, strikethrough }));
+                current = '';
+            }
+            strikethrough = !strikethrough;
+            i++; // Skip next ~
+            continue;
+        }
+        current += char;
+    }
+    if (current) {
+        richText.push(createRichText(current, { bold, italic, code, strikethrough }));
+    }
+    return richText.length > 0 ? richText : [createRichText(text)];
+}
+/**
+ * Convert rich text array to plain markdown
+ */
+function richTextToMarkdown(richText) {
+    if (!richText || !Array.isArray(richText))
+        return '';
+    return richText.map(rt => {
+        if (!rt || !rt.text)
+            return '';
+        let text = rt.text.content || '';
+        const annotations = rt.annotations || {};
+        if (annotations.bold)
+            text = `**${text}**`;
+        if (annotations.italic)
+            text = `*${text}*`;
+        if (annotations.code)
+            text = `\`${text}\``;
+        if (annotations.strikethrough)
+            text = `~~${text}~~`;
+        if (rt.text.link)
+            text = `[${text}](${rt.text.link.url})`;
+        return text;
+    }).join('');
+}
+/**
+ * Extract plain text from rich text
+ */
+export function extractPlainText(richText) {
+    return richText.map(rt => rt.text.content).join('');
+}
+// Helper creators
+function createRichText(content, annotations = {}) {
+    return {
+        type: 'text',
+        text: { content, link: null },
+        annotations: {
+            bold: annotations.bold || false,
+            italic: annotations.italic || false,
+            strikethrough: annotations.strikethrough || false,
+            underline: false,
+            code: annotations.code || false,
+            color: 'default'
+        }
+    };
+}
+function createHeading(level, text) {
+    const type = `heading_${level}`;
+    return {
+        object: 'block',
+        type,
+        [type]: {
+            rich_text: parseRichText(text),
+            color: 'default'
+        }
+    };
+}
+function createParagraph(text) {
+    return {
+        object: 'block',
+        type: 'paragraph',
+        paragraph: {
+            rich_text: parseRichText(text),
+            color: 'default'
+        }
+    };
+}
+function createBulletedListItem(text) {
+    return {
+        object: 'block',
+        type: 'bulleted_list_item',
+        bulleted_list_item: {
+            rich_text: parseRichText(text),
+            color: 'default'
+        }
+    };
+}
+function createNumberedListItem(text) {
+    return {
+        object: 'block',
+        type: 'numbered_list_item',
+        numbered_list_item: {
+            rich_text: parseRichText(text),
+            color: 'default'
+        }
+    };
+}
+function createCodeBlock(code, language) {
+    return {
+        object: 'block',
+        type: 'code',
+        code: {
+            rich_text: [createRichText(code)],
+            language: language || 'plain text'
+        }
+    };
+}
+function createQuote(text) {
+    return {
+        object: 'block',
+        type: 'quote',
+        quote: {
+            rich_text: parseRichText(text),
+            color: 'default'
+        }
+    };
+}
+function createDivider() {
+    return {
+        object: 'block',
+        type: 'divider',
+        divider: {}
+    };
+}
+function isListItem(line) {
+    return line.match(/^[\-\*]\s/) !== null || line.match(/^\d+\.\s/) !== null;
+}
+//# sourceMappingURL=markdown.js.map