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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,26 +1,21 @@
1
1
  {
2
2
  "name": "n8n-nodes-notion-advanced",
3
- "version": "1.1.25-beta",
3
+ "version": "1.1.27-beta",
4
4
  "description": "Advanced n8n Notion nodes: Full-featured workflow node + AI Agent Tool for intelligent Notion automation with 25+ block types (BETA)",
5
5
  "scripts": {
6
- "build": "node dev-notes/build-for-install.js",
7
- "build-ts": "tsc && npm run copy-files",
8
- "copy-files": "copyfiles -u 1 \"nodes/**/*.{png,svg}\" dist/",
9
- "dev": "tsc --watch",
10
- "format": "prettier --write .",
11
- "lint": "eslint . --ext .ts",
12
- "prepublishOnly": "npm run build"
6
+ "build": "echo 'Already built'",
7
+ "prepublishOnly": "echo 'Files already built, ready to publish'"
13
8
  },
14
9
  "files": [
15
- "dist",
16
- "README.md",
17
- "LICENSE"
10
+ "nodes/",
11
+ "NotionAdvanced/",
12
+ "package.json"
18
13
  ],
19
14
  "n8n": {
20
15
  "n8nNodesApiVersion": 1,
21
16
  "nodes": [
22
- "dist/nodes/NotionAdvanced/NotionAdvanced.node.js",
23
- "dist/nodes/NotionAdvanced/NotionAITool.node.js"
17
+ "nodes/NotionAdvanced/NotionAdvanced.node.js",
18
+ "nodes/NotionAdvanced/NotionAITool.node.js"
24
19
  ]
25
20
  },
26
21
  "keywords": [
package/LICENSE DELETED
@@ -1,21 +0,0 @@
1
- MIT License
2
-
3
- Copyright (c) 2024 n8n Community
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
package/README.md DELETED
@@ -1,306 +0,0 @@
1
- # n8n Notion Advanced Nodes
2
-
3
- A comprehensive n8n community package that provides complete access to the Notion API v2022-06-28 with support for all block types, rich text formatting, and CRUD operations. Includes both a full-featured workflow node and an AI Agent Tool for intelligent automation.
4
-
5
- ## What's Included
6
-
7
- ### 1. **Notion Advanced** - Full-Featured Workflow Node
8
- Complete Notion integration for traditional n8n workflows with comprehensive CRUD operations and all 25+ block types.
9
-
10
- ### 2. **Notion AI Tool** - AI Agent Integration
11
- Specialized tool designed for n8n's AI Agent Nodes, enabling natural language Notion automation.
12
-
13
- 📖 **For AI Agent usage, see [AI-TOOL-USAGE.md](./AI-TOOL-USAGE.md)**
14
-
15
- ## Features
16
-
17
- ### Complete Block Type Support
18
- - **Basic Text Blocks**: paragraph, heading_1/2/3, bulleted_list_item, numbered_list_item, to_do, toggle, quote, callout, divider
19
- - **Code Blocks**: code with syntax highlighting support for 170+ languages
20
- - **Media Blocks**: image, video, audio, file, pdf with upload and external URL support
21
- - **Interactive Blocks**: bookmark, embed, link_preview, equation (LaTeX)
22
- - **Advanced Layout**: table, table_row, column_list, column, synced_block, template, table_of_contents
23
- - **Database Integration**: child_database, child_page references
24
-
25
- ### Rich Text Formatting
26
- - **Annotations**: bold, italic, strikethrough, underline, code
27
- - **Colors**: All 10 text colors and 9 background colors
28
- - **Links**: Internal page links and external URLs
29
- - **Mentions**: User, page, database, and date mentions
30
- - **Equations**: Inline and block LaTeX math expressions
31
-
32
- ### Operations
33
- - **Pages**: Create, read, update, archive, search with full property support
34
- - **Blocks**: Create, read, update, delete, get children, append children
35
- - **Databases**: Get, query, create with complete schema support
36
- - **Users**: Get, list workspace users
37
-
38
- ## Installation
39
-
40
- ### Via n8n GUI (Recommended)
41
- 1. Open n8n Settings → Community Nodes
42
- 2. Click "Install a community node"
43
- 3. Enter: `n8n-nodes-notion-advanced`
44
- 4. Click Install
45
-
46
- ### Via npm
47
- ```bash
48
- npm install n8n-nodes-notion-advanced
49
- ```
50
-
51
- 📖 **For detailed installation instructions including Docker setup, development mode, and troubleshooting, see [INSTALLATION.md](./INSTALLATION.md)**
52
-
53
- ## Quick Start
54
-
55
- ### For AI Agents
56
- ```markdown
57
- 1. Add AI Agent Node to your workflow
58
- 2. Configure your chat model (OpenAI, Anthropic, etc.)
59
- 3. Add "Notion AI Tool" from available tools
60
- 4. Configure Notion credentials
61
- 5. AI Agent can now create/manage Notion content with natural language!
62
-
63
- Example: "Create a project plan page with timeline and milestones"
64
- ```
65
-
66
- ### For Traditional Workflows
67
- ```markdown
68
- 1. Add "Notion Advanced" node to your workflow
69
- 2. Configure Notion credentials
70
- 3. Choose resource (Page/Block/Database/User)
71
- 4. Select operation and configure parameters
72
- 5. Execute comprehensive Notion operations
73
- ```
74
-
75
- ## Prerequisites
76
-
77
- - n8n instance (self-hosted or cloud)
78
- - Notion API integration with appropriate permissions
79
- - Existing `notionApi` credentials configured in n8n
80
-
81
- ## Usage
82
-
83
- ### Setting up Credentials
84
-
85
- This node uses the existing n8n Notion API credentials. Ensure you have:
86
-
87
- 1. Created a Notion integration at https://developers.notion.com/
88
- 2. Added the integration to your Notion workspace
89
- 3. Configured the `notionApi` credential in n8n with your integration token
90
-
91
- ### Basic Examples
92
-
93
- #### Creating a Page
94
-
95
- ```json
96
- {
97
- "resource": "page",
98
- "operation": "create",
99
- "parent": "page-id-or-url",
100
- "title": "My New Page",
101
- "properties": {
102
- "property": [
103
- {
104
- "name": "Status",
105
- "type": "select",
106
- "value": "{\"name\": \"In Progress\"}"
107
- }
108
- ]
109
- }
110
- }
111
- ```
112
-
113
- #### Adding Blocks to a Page
114
-
115
- ```json
116
- {
117
- "resource": "block",
118
- "operation": "create",
119
- "parentId": "page-id",
120
- "blocks": {
121
- "block": [
122
- {
123
- "type": "paragraph",
124
- "content": "This is a simple paragraph"
125
- },
126
- {
127
- "type": "heading_1",
128
- "content": "Main Heading",
129
- "properties": "{\"color\": \"blue\"}"
130
- },
131
- {
132
- "type": "code",
133
- "content": "console.log('Hello World');",
134
- "properties": "{\"language\": \"javascript\"}"
135
- }
136
- ]
137
- }
138
- }
139
- ```
140
-
141
- #### Rich Text with Formatting
142
-
143
- ```json
144
- {
145
- "type": "paragraph",
146
- "richText": "[{\"type\": \"text\", \"text\": {\"content\": \"Bold text\"}, \"annotations\": {\"bold\": true}}, {\"type\": \"text\", \"text\": {\"content\": \" and \"}, \"annotations\": {}}, {\"type\": \"text\", \"text\": {\"content\": \"italic text\", \"link\": {\"url\": \"https://example.com\"}}, \"annotations\": {\"italic\": true, \"color\": \"blue\"}}]"
147
- }
148
- ```
149
-
150
- ## Block Types Reference
151
-
152
- ### Text Blocks
153
-
154
- | Block Type | Properties | Description |
155
- |------------|-----------|-------------|
156
- | `paragraph` | `rich_text`, `color`, `children` | Basic text paragraph |
157
- | `heading_1` | `rich_text`, `color`, `is_toggleable` | Top-level heading |
158
- | `heading_2` | `rich_text`, `color`, `is_toggleable` | Second-level heading |
159
- | `heading_3` | `rich_text`, `color`, `is_toggleable` | Third-level heading |
160
- | `bulleted_list_item` | `rich_text`, `color`, `children` | Bullet point list item |
161
- | `numbered_list_item` | `rich_text`, `color`, `children` | Numbered list item |
162
- | `to_do` | `rich_text`, `checked`, `color`, `children` | Checkbox item |
163
- | `toggle` | `rich_text`, `color`, `children` | Collapsible section |
164
- | `quote` | `rich_text`, `color`, `children` | Block quote |
165
- | `callout` | `rich_text`, `icon`, `color`, `children` | Highlighted callout |
166
-
167
- ### Code Blocks
168
-
169
- | Block Type | Properties | Description |
170
- |------------|-----------|-------------|
171
- | `code` | `rich_text`, `language`, `caption` | Code block with syntax highlighting |
172
-
173
- **Supported Languages**: JavaScript, Python, Java, C++, HTML, CSS, SQL, JSON, XML, and 160+ more.
174
-
175
- ### Media Blocks
176
-
177
- | Block Type | Properties | Description |
178
- |------------|-----------|-------------|
179
- | `image` | `url`, `caption` | Image from URL or upload |
180
- | `video` | `url`, `caption` | Video embed or upload |
181
- | `audio` | `url`, `caption` | Audio file |
182
- | `file` | `url`, `caption` | Generic file attachment |
183
- | `pdf` | `url`, `caption` | PDF document |
184
-
185
- ### Interactive Blocks
186
-
187
- | Block Type | Properties | Description |
188
- |------------|-----------|-------------|
189
- | `bookmark` | `url`, `caption` | Website bookmark with preview |
190
- | `embed` | `url`, `caption` | Embedded content |
191
- | `link_preview` | `url` | Auto-generated link preview |
192
- | `equation` | `expression` | LaTeX mathematical expression |
193
-
194
- ### Layout Blocks
195
-
196
- | Block Type | Properties | Description |
197
- |------------|-----------|-------------|
198
- | `table` | `table_width`, `has_column_header`, `has_row_header`, `children` | Data table |
199
- | `table_row` | `cells` | Table row with cells |
200
- | `column_list` | `children` | Container for columns |
201
- | `column` | `children` | Individual column |
202
- | `divider` | None | Horizontal divider line |
203
-
204
- ### Advanced Blocks
205
-
206
- | Block Type | Properties | Description |
207
- |------------|-----------|-------------|
208
- | `synced_block` | `synced_from`, `children` | Synchronized content block |
209
- | `template` | `rich_text`, `children` | Template block |
210
- | `table_of_contents` | `color` | Auto-generated table of contents |
211
- | `child_database` | `title` | Inline database |
212
- | `child_page` | `title` | Child page reference |
213
-
214
- ## Rich Text Formatting
215
-
216
- ### Annotations
217
-
218
- ```json
219
- {
220
- "annotations": {
221
- "bold": true,
222
- "italic": false,
223
- "strikethrough": false,
224
- "underline": true,
225
- "code": false,
226
- "color": "blue"
227
- }
228
- }
229
- ```
230
-
231
- ### Colors
232
-
233
- **Text Colors**: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`
234
-
235
- **Background Colors**: `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background`
236
-
237
- ### Links
238
-
239
- ```json
240
- {
241
- "text": {
242
- "content": "Link text",
243
- "link": {
244
- "url": "https://example.com"
245
- }
246
- }
247
- }
248
- ```
249
-
250
- ## Error Handling
251
-
252
- The node provides comprehensive error handling:
253
-
254
- - **Credential Validation**: Automatically validates API credentials
255
- - **Input Validation**: Validates all required fields and block structures
256
- - **API Error Mapping**: Maps Notion API errors to user-friendly messages
257
- - **Graceful Degradation**: Continues processing with `continueOnFail` option
258
-
259
- ## Performance Features
260
-
261
- - **Pagination Support**: Automatically handles paginated responses
262
- - **Batch Operations**: Efficient bulk block creation and updates
263
- - **Credential Caching**: Reuses authentication across requests
264
- - **Request Optimization**: Minimizes API calls with intelligent batching
265
-
266
- ## Troubleshooting
267
-
268
- ### Common Issues
269
-
270
- 1. **Permission Errors**: Ensure your Notion integration has access to the target pages/databases
271
- 2. **Invalid Block Types**: Check that all block properties match the expected schema
272
- 3. **Rate Limiting**: The node respects Notion's rate limits automatically
273
- 4. **Large Content**: For pages with many blocks, consider using batch operations
274
-
275
- ### Debug Tips
276
-
277
- - Enable n8n's debug mode to see full API requests/responses
278
- - Validate JSON strings in block properties before sending
279
- - Test with simple blocks before adding complex formatting
280
- - Check Notion's API documentation for the latest block schemas
281
-
282
- ## API Reference
283
-
284
- This node implements Notion API version `2022-06-28`. For the most up-to-date API documentation, visit:
285
- https://developers.notion.com/reference
286
-
287
- ## Contributing
288
-
289
- Contributions are welcome! Please:
290
-
291
- 1. Fork the repository
292
- 2. Create a feature branch
293
- 3. Add tests for new functionality
294
- 4. Submit a pull request
295
-
296
- ## License
297
-
298
- MIT License - see LICENSE file for details.
299
-
300
- ## Support
301
-
302
- For issues and questions:
303
- - Check the troubleshooting section
304
- - Review Notion's API documentation
305
- - Open an issue on GitHub
306
- - Join the n8n community forum
package/dist/package.json DELETED
@@ -1,78 +0,0 @@
1
- {
2
- "name": "n8n-nodes-notion-advanced",
3
- "version": "1.1.25-beta",
4
- "description": "Advanced n8n Notion nodes: Full-featured workflow node + AI Agent Tool for intelligent Notion automation with 25+ block types (BETA)",
5
- "scripts": {
6
- "build": "node dev-notes/build-for-install.js",
7
- "build-ts": "tsc && npm run copy-files",
8
- "copy-files": "copyfiles -u 1 \"nodes/**/*.{png,svg}\" dist/",
9
- "dev": "tsc --watch",
10
- "format": "prettier --write .",
11
- "lint": "eslint . --ext .ts",
12
- "prepublishOnly": "npm run build"
13
- },
14
- "files": [
15
- "dist",
16
- "README.md",
17
- "LICENSE"
18
- ],
19
- "n8n": {
20
- "n8nNodesApiVersion": 1,
21
- "nodes": [
22
- "dist/nodes/NotionAdvanced/NotionAdvanced.node.js",
23
- "dist/nodes/NotionAdvanced/NotionAITool.node.js"
24
- ]
25
- },
26
- "keywords": [
27
- "n8n-community-node-package",
28
- "notion",
29
- "productivity",
30
- "api",
31
- "blocks",
32
- "rich-text",
33
- "database",
34
- "pages",
35
- "automation",
36
- "workflow",
37
- "integration",
38
- "notion-api",
39
- "block-types",
40
- "formatting",
41
- "ai",
42
- "ai-agent",
43
- "ai-tool",
44
- "chatgpt",
45
- "claude",
46
- "llm",
47
- "natural-language",
48
- "intelligent-automation"
49
- ],
50
- "license": "MIT",
51
- "homepage": "https://github.com/your-username/n8n-notion-advanced-node#readme",
52
- "author": {
53
- "name": "AZ-IT.US",
54
- "email": "azuniga6290@gmail.com"
55
- },
56
- "repository": {
57
- "type": "git",
58
- "url": "https://github.com/AZ-IT-US/n8n-notion-advanced-node.git"
59
- },
60
- "engines": {
61
- "node": ">=16.10",
62
- "pnpm": ">=7.18"
63
- },
64
- "packageManager": "pnpm@7.18.0",
65
- "devDependencies": {
66
- "@types/node": "^24.1.0",
67
- "@typescript-eslint/eslint-plugin": "^8.38.0",
68
- "@typescript-eslint/parser": "^8.38.0",
69
- "copyfiles": "^2.4.1",
70
- "eslint": "^9.32.0",
71
- "eslint-plugin-n8n-nodes-base": "^1.11.0",
72
- "prettier": "^3.6.2",
73
- "typescript": "^5.1.3"
74
- },
75
- "peerDependencies": {
76
- "n8n-workflow": "^1.82.0"
77
- }
78
- }
@@ -1,15 +0,0 @@
1
- import type { RichTextObject, Block } from '../types/NotionTypes';
2
- export declare function testRichTextCreation(): void;
3
- export declare function testRichTextParsing(): void;
4
- export declare function testBlockCreation(): void;
5
- export declare function testBlockInputConversion(): void;
6
- export declare function testBlockValidation(): void;
7
- export declare function testTableCreation(): void;
8
- export declare function testComplexRichText(): void;
9
- export declare function testAllBlockTypes(): void;
10
- export declare function testTypicalWorkflow(): void;
11
- export declare function runAllTests(): void;
12
- export declare const testData: {
13
- sampleRichText: RichTextObject[];
14
- sampleBlocks: Block[];
15
- };