n8n-nodes-notion-advanced 1.1.26-beta → 1.1.27-beta

package/NotionAdvanced/notion.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M4.459 4.208c.746.606 1.026.56 2.428.466l13.215-.793c.28 0 .047-.28-.046-.326L17.86 1.968c-.42-.326-.981-.7-2.055-.607L3.533 2.221c-.466.047-.56.28-.374.466l1.3.979zM5.206 6.678v14.018c0 .746.373 1.027 1.214.98l14.523-.84c.841-.046.935-.56.935-1.167V6.305c0-.607-.28-.887-.747-.84l-15.177.887c-.56.047-.748.327-.748.746v-.42zm14.337.793c.093.42 0 .84-.42.888l-.7.14v10.264c-.608.327-1.168.514-1.635.514-.748 0-.935-.234-1.495-.933l-4.577-7.186v6.952L12.21 18s0 .84-1.168.84l-3.222.186c-.093-.186 0-.653.327-.746l.84-.233V9.854L7.822 9.76c-.094-.42.14-1.026.793-1.073l3.456-.233 4.764 7.279v-6.44l-1.215-.139c-.093-.514.28-.887.747-.933l3.176-.233z" fill="currentColor"/>
+</svg>

package/nodes/NotionAdvanced/NotionAITool.node.d.ts

@@ -0,0 +1,13 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription, IDataObject } from 'n8n-workflow';
+export declare class NotionAITool implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+    static createPageWithContent(executeFunctions: IExecuteFunctions, itemIndex: number): Promise<IDataObject>;
+    static addContentToPage(executeFunctions: IExecuteFunctions, itemIndex: number): Promise<IDataObject>;
+    static searchPages(executeFunctions: IExecuteFunctions, itemIndex: number): Promise<IDataObject>;
+    static updatePageProperties(executeFunctions: IExecuteFunctions, itemIndex: number): Promise<IDataObject>;
+    static createDatabaseEntry(executeFunctions: IExecuteFunctions, itemIndex: number): Promise<IDataObject>;
+    static queryDatabase(executeFunctions: IExecuteFunctions, itemIndex: number): Promise<IDataObject>;
+    static parseContentToBlocks(content: string): IDataObject[];
+    static parsePropertiesToUpdate(propertiesString: string): IDataObject;
+}

package/nodes/NotionAdvanced/NotionAITool.node.js

@@ -0,0 +1,566 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotionAITool = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const NotionUtils_1 = require("./NotionUtils");
+class NotionAITool {
+    constructor() {
+        this.description = {
+            displayName: 'Notion AI Tool',
+            name: 'notionAiTool',
+            icon: 'file:notion.svg',
+            group: ['ai'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'AI-powered tool for creating and managing Notion content. Designed for use with AI Agent Nodes.',
+            defaults: {
+                name: 'Notion AI Tool',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            usableAsTool: true,
+            codex: {
+                categories: ['Productivity', 'AI', 'Documentation'],
+                subcategories: {
+                    'Productivity': ['Notion', 'Knowledge Management'],
+                    'AI': ['AI Agent Tools', 'Natural Language Processing'],
+                    'Documentation': ['Page Creation', 'Content Management']
+                },
+                resources: {
+                    primaryDocumentation: [
+                        {
+                            url: 'https://github.com/AZ-IT-US/n8n-notion-advanced-node#ai-tool-usage',
+                        },
+                    ],
+                },
+                alias: ['notion', 'productivity', 'ai-tool', 'pages', 'database'],
+            },
+            credentials: [
+                {
+                    name: 'notionApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Create Page with Content',
+                            value: 'createPageWithContent',
+                            description: 'Create a new Notion page with structured content including text, headings, lists, and formatting',
+                            action: 'Create a Notion page with content',
+                        },
+                        {
+                            name: 'Add Content to Page',
+                            value: 'addContentToPage',
+                            description: 'Append new content blocks (paragraphs, headings, lists, etc.) to an existing Notion page',
+                            action: 'Add content to existing page',
+                        },
+                        {
+                            name: 'Search and Retrieve Pages',
+                            value: 'searchPages',
+                            description: 'Search for Notion pages by title, content, or properties and retrieve their information',
+                            action: 'Search and retrieve pages',
+                        },
+                        {
+                            name: 'Update Page Properties',
+                            value: 'updatePageProperties',
+                            description: 'Update page title, properties, status, tags, or other metadata',
+                            action: 'Update page properties',
+                        },
+                        {
+                            name: 'Create Database Entry',
+                            value: 'createDatabaseEntry',
+                            description: 'Create a new entry in a Notion database with specified properties and values',
+                            action: 'Create database entry',
+                        },
+                        {
+                            name: 'Query Database',
+                            value: 'queryDatabase',
+                            description: 'Search and filter database entries based on criteria and retrieve matching records',
+                            action: 'Query database',
+                        },
+                    ],
+                    default: 'createPageWithContent',
+                },
+                // CREATE PAGE WITH CONTENT
+                {
+                    displayName: 'Page Title',
+                    name: 'pageTitle',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['createPageWithContent'],
+                        },
+                    },
+                    default: '',
+                    description: 'The title of the new page to create',
+                },
+                {
+                    displayName: 'Parent Page/Database ID',
+                    name: 'parentId',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['createPageWithContent', 'createDatabaseEntry'],
+                        },
+                    },
+                    default: '',
+                    description: 'ID of the parent page or database where this should be created. Can be a Notion URL or page ID.',
+                },
+                {
+                    displayName: 'Content',
+                    name: 'content',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 6,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ['createPageWithContent', 'addContentToPage'],
+                        },
+                    },
+                    default: '',
+                    description: 'The content to add. Use natural language - AI will structure it into appropriate blocks (headings, paragraphs, lists, etc.)',
+                    placeholder: 'Example:\n# Main Heading\nThis is a paragraph with **bold** and *italic* text.\n\n## Subheading\n- First bullet point\n- Second bullet point\n\n> This is a quote block',
+                },
+                // ADD CONTENT TO PAGE
+                {
+                    displayName: 'Target Page ID',
+                    name: 'targetPageId',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['addContentToPage', 'updatePageProperties'],
+                        },
+                    },
+                    default: '',
+                    description: 'ID or URL of the existing page to modify',
+                },
+                // SEARCH PAGES
+                {
+                    displayName: 'Search Query',
+                    name: 'searchQuery',
+                    type: 'string',
+                    displayOptions: {
+                        show: {
+                            operation: ['searchPages'],
+                        },
+                    },
+                    default: '',
+                    description: 'Search terms to find pages. Leave empty to get all pages.',
+                },
+                // UPDATE PAGE PROPERTIES
+                {
+                    displayName: 'Properties to Update',
+                    name: 'propertiesToUpdate',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 4,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ['updatePageProperties'],
+                        },
+                    },
+                    default: '',
+                    description: 'Properties to update in JSON format or natural language. Example: {"status": "In Progress", "priority": "High"} or "Set status to Done and priority to Low"',
+                },
+                // DATABASE OPERATIONS
+                {
+                    displayName: 'Database ID',
+                    name: 'databaseId',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['queryDatabase'],
+                        },
+                    },
+                    default: '',
+                    description: 'ID or URL of the database to query',
+                },
+                {
+                    displayName: 'Entry Properties',
+                    name: 'entryProperties',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 4,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ['createDatabaseEntry'],
+                        },
+                    },
+                    default: '',
+                    description: 'Properties for the new database entry in JSON format or natural language description',
+                },
+                {
+                    displayName: 'Query Filter',
+                    name: 'queryFilter',
+                    type: 'string',
+                    displayOptions: {
+                        show: {
+                            operation: ['queryDatabase'],
+                        },
+                    },
+                    default: '',
+                    description: 'Filter criteria in natural language (e.g., "status is Done and priority is High") or JSON format',
+                },
+                // COMMON OPTIONS
+                {
+                    displayName: 'Additional Options',
+                    name: 'additionalOptions',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    default: {},
+                    options: [
+                        {
+                            displayName: 'Icon',
+                            name: 'icon',
+                            type: 'string',
+                            default: '',
+                            description: 'Emoji icon for the page (e.g., 📝, 🎯, 📊)',
+                        },
+                        {
+                            displayName: 'Cover Image URL',
+                            name: 'coverUrl',
+                            type: 'string',
+                            default: '',
+                            description: 'URL of cover image for the page',
+                        },
+                        {
+                            displayName: 'Max Results',
+                            name: 'maxResults',
+                            type: 'number',
+                            default: 20,
+                            description: 'Maximum number of results to return (1-100)',
+                        },
+                    ],
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const responseData = [];
+        // Validate credentials
+        const isValid = await NotionUtils_1.validateCredentials.call(this);
+        if (!isValid) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Invalid Notion API credentials');
+        }
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const operation = this.getNodeParameter('operation', i);
+                let result;
+                switch (operation) {
+                    case 'createPageWithContent':
+                        result = await NotionAITool.createPageWithContent(this, i);
+                        break;
+                    case 'addContentToPage':
+                        result = await NotionAITool.addContentToPage(this, i);
+                        break;
+                    case 'searchPages':
+                        result = await NotionAITool.searchPages(this, i);
+                        break;
+                    case 'updatePageProperties':
+                        result = await NotionAITool.updatePageProperties(this, i);
+                        break;
+                    case 'createDatabaseEntry':
+                        result = await NotionAITool.createDatabaseEntry(this, i);
+                        break;
+                    case 'queryDatabase':
+                        result = await NotionAITool.queryDatabase(this, i);
+                        break;
+                    default:
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown operation: ${operation}`);
+                }
+                responseData.push({
+                    operation,
+                    success: true,
+                    ...result,
+                });
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    responseData.push({
+                        error: error.message,
+                        success: false,
+                    });
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        return [this.helpers.returnJsonArray(responseData)];
+    }
+    static async createPageWithContent(executeFunctions, itemIndex) {
+        const pageTitle = executeFunctions.getNodeParameter('pageTitle', itemIndex);
+        const parentId = executeFunctions.getNodeParameter('parentId', itemIndex);
+        const content = executeFunctions.getNodeParameter('content', itemIndex, '');
+        const additionalOptions = executeFunctions.getNodeParameter('additionalOptions', itemIndex, {});
+        const resolvedParentId = await NotionUtils_1.resolvePageId.call(executeFunctions, parentId);
+        // Create the page first
+        const pageBody = {
+            parent: { page_id: resolvedParentId },
+            properties: {
+                title: {
+                    title: [(0, NotionUtils_1.createRichText)(pageTitle)],
+                },
+            },
+        };
+        // Add icon and cover if provided
+        if (additionalOptions.icon) {
+            pageBody.icon = { type: 'emoji', emoji: additionalOptions.icon };
+        }
+        if (additionalOptions.coverUrl) {
+            pageBody.cover = { type: 'external', external: { url: additionalOptions.coverUrl } };
+        }
+        const page = await NotionUtils_1.notionApiRequest.call(executeFunctions, 'POST', '/pages', pageBody);
+        // If content is provided, add it to the page
+        if (content) {
+            const blocks = NotionAITool.parseContentToBlocks(content);
+            if (blocks.length > 0) {
+                await NotionUtils_1.notionApiRequest.call(executeFunctions, 'PATCH', `/blocks/${page.id}/children`, {
+                    children: blocks,
+                });
+            }
+        }
+        return {
+            pageId: page.id,
+            title: pageTitle,
+            url: page.url,
+            message: `Created page "${pageTitle}" with content`,
+        };
+    }
+    static async addContentToPage(executeFunctions, itemIndex) {
+        const targetPageId = executeFunctions.getNodeParameter('targetPageId', itemIndex);
+        const content = executeFunctions.getNodeParameter('content', itemIndex);
+        const resolvedPageId = await NotionUtils_1.resolvePageId.call(executeFunctions, targetPageId);
+        const blocks = NotionAITool.parseContentToBlocks(content);
+        if (blocks.length === 0) {
+            throw new n8n_workflow_1.NodeOperationError(executeFunctions.getNode(), 'No valid content blocks found to add');
+        }
+        const result = await NotionUtils_1.notionApiRequest.call(executeFunctions, 'PATCH', `/blocks/${resolvedPageId}/children`, {
+            children: blocks,
+        });
+        return {
+            pageId: resolvedPageId,
+            blocksAdded: blocks.length,
+            message: `Added ${blocks.length} content blocks to page`,
+            result,
+        };
+    }
+    static async searchPages(executeFunctions, itemIndex) {
+        var _a, _b;
+        const searchQuery = executeFunctions.getNodeParameter('searchQuery', itemIndex, '');
+        const additionalOptions = executeFunctions.getNodeParameter('additionalOptions', itemIndex, {});
+        const maxResults = additionalOptions.maxResults || 20;
+        const body = {
+            page_size: Math.min(maxResults, 100),
+        };
+        if (searchQuery) {
+            body.query = searchQuery;
+        }
+        body.filter = {
+            property: 'object',
+            value: 'page',
+        };
+        const response = await NotionUtils_1.notionApiRequest.call(executeFunctions, 'POST', '/search', body);
+        return {
+            totalResults: ((_a = response.results) === null || _a === void 0 ? void 0 : _a.length) || 0,
+            pages: response.results || [],
+            message: `Found ${((_b = response.results) === null || _b === void 0 ? void 0 : _b.length) || 0} pages`,
+        };
+    }
+    static async updatePageProperties(executeFunctions, itemIndex) {
+        const targetPageId = executeFunctions.getNodeParameter('targetPageId', itemIndex);
+        const propertiesToUpdate = executeFunctions.getNodeParameter('propertiesToUpdate', itemIndex);
+        const resolvedPageId = await NotionUtils_1.resolvePageId.call(executeFunctions, targetPageId);
+        const properties = NotionAITool.parsePropertiesToUpdate(propertiesToUpdate);
+        const result = await NotionUtils_1.notionApiRequest.call(executeFunctions, 'PATCH', `/pages/${resolvedPageId}`, {
+            properties,
+        });
+        return {
+            pageId: resolvedPageId,
+            updatedProperties: Object.keys(properties),
+            message: `Updated ${Object.keys(properties).length} properties`,
+            result,
+        };
+    }
+    static async createDatabaseEntry(executeFunctions, itemIndex) {
+        const parentId = executeFunctions.getNodeParameter('parentId', itemIndex);
+        const entryProperties = executeFunctions.getNodeParameter('entryProperties', itemIndex);
+        const resolvedParentId = await NotionUtils_1.resolvePageId.call(executeFunctions, parentId);
+        const properties = NotionAITool.parsePropertiesToUpdate(entryProperties);
+        const result = await NotionUtils_1.notionApiRequest.call(executeFunctions, 'POST', '/pages', {
+            parent: { database_id: resolvedParentId },
+            properties,
+        });
+        return {
+            entryId: result.id,
+            databaseId: resolvedParentId,
+            message: 'Created new database entry',
+            result,
+        };
+    }
+    static async queryDatabase(executeFunctions, itemIndex) {
+        var _a, _b;
+        const databaseId = executeFunctions.getNodeParameter('databaseId', itemIndex);
+        const queryFilter = executeFunctions.getNodeParameter('queryFilter', itemIndex, '');
+        const additionalOptions = executeFunctions.getNodeParameter('additionalOptions', itemIndex, {});
+        const maxResults = additionalOptions.maxResults || 20;
+        const resolvedDatabaseId = await NotionUtils_1.resolvePageId.call(executeFunctions, databaseId);
+        const body = {
+            page_size: Math.min(maxResults, 100),
+        };
+        if (queryFilter) {
+            try {
+                body.filter = JSON.parse(queryFilter);
+            }
+            catch {
+                // If not JSON, create a simple text filter
+                body.filter = {
+                    property: 'Name',
+                    title: {
+                        contains: queryFilter,
+                    },
+                };
+            }
+        }
+        const response = await NotionUtils_1.notionApiRequest.call(executeFunctions, 'POST', `/databases/${resolvedDatabaseId}/query`, body);
+        return {
+            databaseId: resolvedDatabaseId,
+            totalResults: ((_a = response.results) === null || _a === void 0 ? void 0 : _a.length) || 0,
+            entries: response.results || [],
+            message: `Found ${((_b = response.results) === null || _b === void 0 ? void 0 : _b.length) || 0} database entries`,
+        };
+    }
+    static parseContentToBlocks(content) {
+        const blocks = [];
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            if (!line)
+                continue;
+            // Parse different content types
+            if (line.startsWith('# ')) {
+                blocks.push({
+                    object: 'block',
+                    type: 'heading_1',
+                    heading_1: {
+                        rich_text: [(0, NotionUtils_1.createRichText)(line.substring(2))],
+                    },
+                });
+            }
+            else if (line.startsWith('## ')) {
+                blocks.push({
+                    object: 'block',
+                    type: 'heading_2',
+                    heading_2: {
+                        rich_text: [(0, NotionUtils_1.createRichText)(line.substring(3))],
+                    },
+                });
+            }
+            else if (line.startsWith('### ')) {
+                blocks.push({
+                    object: 'block',
+                    type: 'heading_3',
+                    heading_3: {
+                        rich_text: [(0, NotionUtils_1.createRichText)(line.substring(4))],
+                    },
+                });
+            }
+            else if (line.startsWith('- ') || line.startsWith('* ')) {
+                blocks.push({
+                    object: 'block',
+                    type: 'bulleted_list_item',
+                    bulleted_list_item: {
+                        rich_text: [(0, NotionUtils_1.createRichText)(line.substring(2))],
+                    },
+                });
+            }
+            else if (line.match(/^\d+\. /)) {
+                blocks.push({
+                    object: 'block',
+                    type: 'numbered_list_item',
+                    numbered_list_item: {
+                        rich_text: [(0, NotionUtils_1.createRichText)(line.replace(/^\d+\. /, ''))],
+                    },
+                });
+            }
+            else if (line.startsWith('> ')) {
+                blocks.push({
+                    object: 'block',
+                    type: 'quote',
+                    quote: {
+                        rich_text: [(0, NotionUtils_1.createRichText)(line.substring(2))],
+                    },
+                });
+            }
+            else if (line.startsWith('```')) {
+                // Handle code blocks
+                const codeLines = [];
+                i++; // Skip the opening ```
+                while (i < lines.length && !lines[i].trim().startsWith('```')) {
+                    codeLines.push(lines[i]);
+                    i++;
+                }
+                blocks.push({
+                    object: 'block',
+                    type: 'code',
+                    code: {
+                        rich_text: [(0, NotionUtils_1.createRichText)(codeLines.join('\n'))],
+                        language: 'plain text',
+                    },
+                });
+            }
+            else {
+                // Regular paragraph
+                blocks.push({
+                    object: 'block',
+                    type: 'paragraph',
+                    paragraph: {
+                        rich_text: [(0, NotionUtils_1.createRichText)(line)],
+                    },
+                });
+            }
+        }
+        return blocks;
+    }
+    static parsePropertiesToUpdate(propertiesString) {
+        try {
+            // Try to parse as JSON first
+            return JSON.parse(propertiesString);
+        }
+        catch {
+            // If not JSON, try to parse natural language
+            const properties = {};
+            // Simple natural language parsing
+            const patterns = [
+                /set\s+(\w+)\s+to\s+(.+?)(?:\s+and|$)/gi,
+                /(\w+)\s*:\s*(.+?)(?:\s*,|$)/gi,
+                /(\w+)\s*=\s*(.+?)(?:\s*,|$)/gi,
+            ];
+            for (const pattern of patterns) {
+                let match;
+                while ((match = pattern.exec(propertiesString)) !== null) {
+                    const [, key, value] = match;
+                    properties[key.trim()] = {
+                        rich_text: [(0, NotionUtils_1.createRichText)(value.trim())],
+                    };
+                }
+            }
+            return properties;
+        }
+    }
+}
+exports.NotionAITool = NotionAITool;