n8n-nodes-substack 1.7.3 → 3.0.2

package/README.md

@@ -1,100 +1,60 @@
+> [!WARNING]
+> This package is superseded by [n8n-nodes-substack-new](https://github.com/jakub-k-slys/n8n-nodes-substack-new),
+> which connects to [Substack Gateway OSS](https://github.com/jakub-k-slys/substack-gateway-oss)
+> and supports full read and write operations. This package remains
+> available but is no longer actively developed.
+
 # n8n-nodes-substack
 
 [![npm version](https://badge.fury.io/js/n8n-nodes-substack.svg)](https://badge.fury.io/js/n8n-nodes-substack)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Tests](https://github.com/jakub-k-slys/n8n-nodes-substack/actions/workflows/test.yaml/badge.svg)](https://github.com/jakub-k-slys/n8n-nodes-substack/actions/workflows/test.yaml)
 
-This n8n community node provides read-only access to the Substack API, enabling you to automate content discovery and analytics workflows with Substack publications.
-
-[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
+Read-only n8n community node for Substack. Enables content discovery and
+analytics workflows against Substack publications.
 
 ## Features
 
-- **Profile Operations**: Get profile information, followees, and publication data
-- **Post Operations**: Retrieve posts with pagination support
-- **Note Operations**: Access notes from publications and create new notes programmatically with optional title and body content, supporting both simple text and advanced JSON formatting
-- **Comment Operations**: Get comments for posts
-- **Secure Authentication**: API key authentication with publication address
-- **Powered by substack-api**: Uses the robust [substack-api](https://www.npmjs.com/package/substack-api) library for reliable API interactions
-
-## Quick Start
-
-### Get Your Profile Information
-
-```json
-{
-  "nodes": [
-    {
-      "name": "Get My Profile",
-      "type": "n8n-nodes-substack.substack",
-      "parameters": {
-        "resource": "profile",
-        "operation": "getOwnProfile"
-      },
-      "credentials": {
-        "substackApi": "your-credential-id"
-      }
-    }
-  ]
-}
-```
-
-### Retrieve Recent Posts
-
-```json
-{
-  "nodes": [
-    {
-      "name": "Get Recent Posts",
-      "type": "n8n-nodes-substack.substack",
-      "parameters": {
-        "resource": "post",
-        "operation": "getAll",
-        "limit": 10
-      },
-      "credentials": {
-        "substackApi": "your-credential-id"
-      }
-    }
-  ]
-}
-```
+- Profile operations: get profile information and publication data
+- Post operations: retrieve posts with pagination
+- Note operations: read and create notes
+- Comment operations: get comments for posts
 
 ## Installation
 
-### n8n Cloud
-
-1. Go to **Settings** > **Community Nodes**
-2. Click **Install a community node**
-3. Enter `n8n-nodes-substack`
-4. Click **Install**
-
 ### Self-hosted n8n
 
-Install the node in your n8n installation directory:
-
 ```bash
 npm install n8n-nodes-substack
 ```
 
-Then restart your n8n instance.
+Restart n8n after installation.
 
-### Credentials Setup
+### Credentials
 
-1. Add the Substack node to your workflow
-2. Create new credentials with:
-   - **Publication Address**: Your Substack domain (e.g., `myblog.substack.com`)
-   - **API Key**: Your Substack API key
+Add credentials with:
+- **Publication Address**: your Substack domain (e.g. `myblog.substack.com`)
+- **API Key**: your Substack API key
 
 ## Documentation
 
-📖 **[Complete Documentation](docs/)** - Comprehensive guides for all operations
+- [Resource Guides](docs/resources/)
+- [Development Guide](docs/contributing.md)
+- [Testing Guide](docs/testing.md)
+- [Architecture](docs/design.md)
+
+## Author
+
+Built by [Jakub Slys](https://iam.slys.dev) — Backend Engineer building
+distributed systems for telecoms, running a self-hosted Kubernetes homelab,
+and building AI automation pipelines with n8n, MCP, and Claude.
+
+I write about building this kind of tooling — n8n workflows, self-hosted AI
+automation, and the engineering decisions behind them — at
+[iam.slys.dev](https://iam.slys.dev).
 
-- **[Resource Guides](docs/resources/)** - Detailed documentation for Profile, Post, Note, and Comment operations
-- **[Development Guide](docs/contributing.md)** - Contributing to the project
-- **[Testing Guide](docs/testing.md)** - Testing practices and procedures
-- **[Architecture](docs/design.md)** - Design decisions and project structure
+→ [iam.slys.dev](https://iam.slys.dev)
 
 ## License
 
-[MIT](LICENSE.md)
+MIT

package/dist/credentials/SubstackApi.credentials.js

@@ -25,7 +25,7 @@ class SubstackApi {
                 typeOptions: {
                     password: true,
                 },
-                description: 'The substack.sid cookie value used for authentication',
+                description: 'The private API token for authentication',
                 required: true,
             },
         ];

package/dist/credentials/SubstackApi.credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"SubstackApi.credentials.js","sourceRoot":"","sources":["../../credentials/SubstackApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,WAAW;IAAxB;QACC,SAAI,GAAG,aAAa,CAAC;QACrB,gBAAW,GAAG,cAAc,CAAC;QAC7B,qBAAgB,GAAG,qCAAqC,CAAC;QACzD,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,qBAAqB;gBAClC,IAAI,EAAE,oBAAoB;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,6BAA6B;gBAC1C,WAAW,EAAE,8EAA8E;gBAC3F,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,KAAK;aACnB;YACD;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,WAAW,EAAE,uDAAuD;gBACpE,QAAQ,EAAE,IAAI;aACd;SACD,CAAC;QAIF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,MAAM,EAAE,uCAAuC;iBAC/C;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,8CAA8C;gBACvD,GAAG,EAAE,sBAAsB;gBAC3B,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACR,MAAM,EAAE,uCAAuC;iBAC/C;aACD;SACD,CAAC;IACH,CAAC;CAAA;AAjDD,kCAiDC"}
+{"version":3,"file":"SubstackApi.credentials.js","sourceRoot":"","sources":["../../credentials/SubstackApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,WAAW;IAAxB;QACC,SAAI,GAAG,aAAa,CAAC;QACrB,gBAAW,GAAG,cAAc,CAAC;QAC7B,qBAAgB,GAAG,qCAAqC,CAAC;QACzD,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,qBAAqB;gBAClC,IAAI,EAAE,oBAAoB;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,6BAA6B;gBAC1C,WAAW,EAAE,8EAA8E;gBAC3F,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,KAAK;aACnB;YACD;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,WAAW,EAAE,0CAA0C;gBACvD,QAAQ,EAAE,IAAI;aACd;SACD,CAAC;QAIF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,MAAM,EAAE,uCAAuC;iBAC/C;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,8CAA8C;gBACvD,GAAG,EAAE,sBAAsB;gBAC3B,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACR,MAAM,EAAE,uCAAuC;iBAC/C;aACD;SACD,CAAC;IACH,CAAC;CAAA;AAjDD,kCAiDC"}

package/dist/nodes/Substack/Comment.fields.js

@@ -32,5 +32,19 @@ exports.commentFields = [
             minValue: 1,
         },
     },
+    {
+        displayName: 'Comment ID',
+        name: 'commentId',
+        type: 'string',
+        default: '',
+        description: 'The ID of the comment to retrieve',
+        displayOptions: {
+            show: {
+                resource: ['comment'],
+                operation: ['getCommentById'],
+            },
+        },
+        required: true,
+    },
 ];
 //# sourceMappingURL=Comment.fields.js.map

package/dist/nodes/Substack/Comment.fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"Comment.fields.js","sourceRoot":"","sources":["../../../nodes/Substack/Comment.fields.ts"],"names":[],"mappings":";;;AAEa,QAAA,aAAa,GAAsB;IAI/C;QACC,WAAW,EAAE,SAAS;QACtB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,wCAAwC;QACrD,cAAc,EAAE;YACf,IAAI,EAAE;gBACL,QAAQ,EAAE,CAAC,SAAS,CAAC;gBACrB,SAAS,EAAE,CAAC,QAAQ,CAAC;aACrB;SACD;QACD,QAAQ,EAAE,IAAI;KACd;IACD;QACC,WAAW,EAAE,OAAO;QACpB,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,iCAAiC;QAC9C,cAAc,EAAE;YACf,IAAI,EAAE;gBACL,QAAQ,EAAE,CAAC,SAAS,CAAC;gBACrB,SAAS,EAAE,CAAC,QAAQ,CAAC;aACrB;SACD;QACD,WAAW,EAAE;YACZ,QAAQ,EAAE,CAAC;SACX;KACD;CACD,CAAC"}
+{"version":3,"file":"Comment.fields.js","sourceRoot":"","sources":["../../../nodes/Substack/Comment.fields.ts"],"names":[],"mappings":";;;AAEa,QAAA,aAAa,GAAsB;IAI/C;QACC,WAAW,EAAE,SAAS;QACtB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,wCAAwC;QACrD,cAAc,EAAE;YACf,IAAI,EAAE;gBACL,QAAQ,EAAE,CAAC,SAAS,CAAC;gBACrB,SAAS,EAAE,CAAC,QAAQ,CAAC;aACrB;SACD;QACD,QAAQ,EAAE,IAAI;KACd;IACD;QACC,WAAW,EAAE,OAAO;QACpB,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,iCAAiC;QAC9C,cAAc,EAAE;YACf,IAAI,EAAE;gBACL,QAAQ,EAAE,CAAC,SAAS,CAAC;gBACrB,SAAS,EAAE,CAAC,QAAQ,CAAC;aACrB;SACD;QACD,WAAW,EAAE;YACZ,QAAQ,EAAE,CAAC;SACX;KACD;IAID;QACC,WAAW,EAAE,YAAY;QACzB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,mCAAmC;QAChD,cAAc,EAAE;YACf,IAAI,EAAE;gBACL,QAAQ,EAAE,CAAC,SAAS,CAAC;gBACrB,SAAS,EAAE,CAAC,gBAAgB,CAAC;aAC7B;SACD;QACD,QAAQ,EAAE,IAAI;KACd;CACD,CAAC"}

package/dist/nodes/Substack/Comment.operations.d.ts

@@ -2,7 +2,8 @@ import { IExecuteFunctions, INodeProperties } from 'n8n-workflow';
 import { SubstackClient } from 'substack-api';
 import { IStandardResponse } from './types';
 export declare enum CommentOperation {
-    GetAll = "getAll"
+    GetAll = "getAll",
+    GetCommentById = "getCommentById"
 }
 export declare const commentOperations: INodeProperties[];
 export declare const commentOperationHandlers: Record<CommentOperation, (executeFunctions: IExecuteFunctions, client: SubstackClient, publicationAddress: string, itemIndex: number) => Promise<IStandardResponse>>;

package/dist/nodes/Substack/Comment.operations.js

@@ -7,6 +7,7 @@ const SubstackUtils_1 = require("./SubstackUtils");
 var CommentOperation;
 (function (CommentOperation) {
     CommentOperation["GetAll"] = "getAll";
+    CommentOperation["GetCommentById"] = "getCommentById";
 })(CommentOperation || (exports.CommentOperation = CommentOperation = {}));
 exports.commentOperations = [
     {
@@ -27,6 +28,12 @@ exports.commentOperations = [
                 description: 'Get all comments for a specific post',
                 action: 'Get all comments',
             },
+            {
+                name: 'Get Comment by ID',
+                value: CommentOperation.GetCommentById,
+                description: 'Get a specific comment by its ID',
+                action: 'Get comment by ID',
+            },
         ],
     },
 ];
@@ -36,8 +43,8 @@ async function getAll(executeFunctions, client, publicationAddress, itemIndex) {
         const limitParam = executeFunctions.getNodeParameter('limit', itemIndex, '');
         const limit = OperationUtils_1.OperationUtils.parseLimit(limitParam);
         const post = await client.postForId(postId);
-        const commentsIterable = post.comments();
-        const results = await OperationUtils_1.OperationUtils.executeAsyncIterable(commentsIterable, limit, (comment) => DataFormatters_1.DataFormatters.formatComment(comment, postId), publicationAddress);
+        const commentsIterable = await post.comments();
+        const results = await OperationUtils_1.OperationUtils.executeAsyncIterable(commentsIterable, limit, (comment, publicationAddress) => DataFormatters_1.DataFormatters.formatComment(comment, postId), publicationAddress);
         return {
             success: true,
             data: results,
@@ -52,7 +59,27 @@ async function getAll(executeFunctions, client, publicationAddress, itemIndex) {
         });
     }
 }
+async function getCommentById(executeFunctions, client, publicationAddress, itemIndex) {
+    try {
+        const commentId = OperationUtils_1.OperationUtils.parseNumericParam(executeFunctions.getNodeParameter('commentId', itemIndex), 'commentId');
+        const comment = await client.commentForId(commentId);
+        const result = DataFormatters_1.DataFormatters.formatComment(comment);
+        return {
+            success: true,
+            data: result,
+            metadata: { status: 'success' },
+        };
+    }
+    catch (error) {
+        return SubstackUtils_1.SubstackUtils.formatErrorResponse({
+            message: error.message,
+            node: executeFunctions.getNode(),
+            itemIndex,
+        });
+    }
+}
 exports.commentOperationHandlers = {
     [CommentOperation.GetAll]: getAll,
+    [CommentOperation.GetCommentById]: getCommentById,
 };
 //# sourceMappingURL=Comment.operations.js.map

package/dist/nodes/Substack/Comment.operations.js.map

@@ -1 +1 @@
-{"version":3,"file":"Comment.operations.js","sourceRoot":"","sources":["../../../nodes/Substack/Comment.operations.ts"],"names":[],"mappings":";;;AAGA,4DAAyD;AACzD,4DAAyD;AACzD,mDAAgD;AAEhD,IAAY,gBAEX;AAFD,WAAY,gBAAgB;IAC3B,qCAAiB,CAAA;AAClB,CAAC,EAFW,gBAAgB,gCAAhB,gBAAgB,QAE3B;AAEY,QAAA,iBAAiB,GAAsB;IACnD;QACC,WAAW,EAAE,WAAW;QACxB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,QAAQ;QACjB,gBAAgB,EAAE,IAAI;QACtB,cAAc,EAAE;YACf,IAAI,EAAE;gBACL,QAAQ,EAAE,CAAC,SAAS,CAAC;aACrB;SACD;QACD,OAAO,EAAE;YACR;gBACC,IAAI,EAAE,kBAAkB;gBACxB,KAAK,EAAE,gBAAgB,CAAC,MAAM;gBAC9B,WAAW,EAAE,sCAAsC;gBACnD,MAAM,EAAE,kBAAkB;aAC1B;SACD;KACD;CACD,CAAC;AAEF,KAAK,UAAU,MAAM,CACpB,gBAAmC,EACnC,MAAsB,EACtB,kBAA0B,EAC1B,SAAiB;IAEjB,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,+BAAc,CAAC,iBAAiB,CAC9C,gBAAgB,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,EACtD,QAAQ,CACR,CAAC;QACF,MAAM,UAAU,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,+BAAc,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAEpD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,+BAAc,CAAC,oBAAoB,CACxD,gBAAgB,EAChB,KAAK,EACL,CAAC,OAAY,EAAE,EAAE,CAAC,+BAAc,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,EAC/D,kBAAkB,CAClB,CAAC;QAEF,OAAO;YACN,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;SAC/B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,6BAAa,CAAC,mBAAmB,CAAC;YACxC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE;YAChC,SAAS;SACT,CAAC,CAAC;IACJ,CAAC;AACF,CAAC;AAEY,QAAA,wBAAwB,GAQjC;IACH,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM;CACjC,CAAC"}
+{"version":3,"file":"Comment.operations.js","sourceRoot":"","sources":["../../../nodes/Substack/Comment.operations.ts"],"names":[],"mappings":"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"}

package/dist/nodes/Substack/MarkdownParser.d.ts

@@ -0,0 +1,11 @@
+import type { OwnProfile } from 'substack-api';
+export declare class MarkdownParser {
+    static parseMarkdownToNoteStructured(markdown: string, noteBuilder: ReturnType<OwnProfile['newNote']>): ReturnType<ReturnType<OwnProfile['newNote']>['paragraph']>;
+    static parseMarkdownToNote(markdown: string, noteBuilder: ReturnType<OwnProfile['newNote']>): ReturnType<ReturnType<OwnProfile['newNote']>['paragraph']>;
+    private static preprocessMarkdown;
+    private static processTokensStructured;
+    private static processHeadingStructured;
+    private static processParagraphStructured;
+    private static processListStructured;
+    private static processInlineTokensStructured;
+}

package/dist/nodes/Substack/MarkdownParser.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarkdownParser = void 0;
+const marked_1 = require("marked");
+marked_1.marked.setOptions({
+    gfm: true,
+    breaks: false,
+});
+function decodeHtmlEntities(text) {
+    const entityMap = {
+        ''': "'",
+        '"': '"',
+        '&': '&',
+        '&lt;': '<',
+        '&gt;': '>',
+        '&nbsp;': ' ',
+    };
+    return text.replace(/&#?\w+;/g, (entity) => entityMap[entity] || entity);
+}
+class MarkdownParser {
+    static parseMarkdownToNoteStructured(markdown, noteBuilder) {
+        if (!markdown.trim()) {
+            throw new Error('Note body cannot be empty - at least one paragraph with content is required');
+        }
+        const processedMarkdown = this.preprocessMarkdown(markdown);
+        const tokens = marked_1.marked.lexer(processedMarkdown);
+        const meaningfulTokens = tokens.filter((token) => token.type === 'paragraph' || token.type === 'heading' || token.type === 'list');
+        if (meaningfulTokens.length === 0) {
+            throw new Error('Note must contain at least one paragraph with actual content');
+        }
+        const contentTracker = { meaningfulNodesCreated: 0 };
+        let currentBuilder = null;
+        currentBuilder = this.processTokensStructured(tokens, noteBuilder, contentTracker);
+        if (contentTracker.meaningfulNodesCreated === 0) {
+            throw new Error('Note must contain at least one paragraph with actual content');
+        }
+        if (!currentBuilder) {
+            throw new Error('Failed to create note content');
+        }
+        return currentBuilder;
+    }
+    static parseMarkdownToNote(markdown, noteBuilder) {
+        return this.parseMarkdownToNoteStructured(markdown, noteBuilder);
+    }
+    static preprocessMarkdown(markdown) {
+        return markdown.replace(/\\n/g, '\n');
+    }
+    static processTokensStructured(tokens, noteBuilder, contentTracker) {
+        let currentBuilder = null;
+        for (const token of tokens) {
+            let newBuilder = null;
+            switch (token.type) {
+                case 'heading':
+                    newBuilder = this.processHeadingStructured(token, noteBuilder, currentBuilder, contentTracker);
+                    break;
+                case 'paragraph':
+                    newBuilder = this.processParagraphStructured(token, noteBuilder, currentBuilder, contentTracker);
+                    break;
+                case 'list':
+                    newBuilder = this.processListStructured(token, noteBuilder, currentBuilder, contentTracker);
+                    break;
+                case 'space':
+                    break;
+                default:
+                    if (token.text) {
+                        const decodedText = decodeHtmlEntities(token.text);
+                        if (currentBuilder) {
+                            newBuilder = currentBuilder.paragraph().text(decodedText);
+                        }
+                        else {
+                            newBuilder = noteBuilder.paragraph().text(decodedText);
+                        }
+                        contentTracker.meaningfulNodesCreated++;
+                    }
+                    break;
+            }
+            if (newBuilder) {
+                currentBuilder = newBuilder;
+            }
+        }
+        return currentBuilder;
+    }
+    static processHeadingStructured(token, noteBuilder, currentBuilder, contentTracker) {
+        const hasContent = (token.tokens && token.tokens.some((t) => t.text && t.text.trim())) ||
+            (token.text && token.text.trim());
+        if (!hasContent) {
+            return currentBuilder;
+        }
+        let paragraphBuilder = currentBuilder ? currentBuilder.paragraph() : noteBuilder.paragraph();
+        if (token.tokens && token.tokens.length > 0) {
+            paragraphBuilder = this.processInlineTokensStructured(token.tokens, paragraphBuilder, true);
+        }
+        else if (token.text) {
+            paragraphBuilder = paragraphBuilder.bold(decodeHtmlEntities(token.text));
+        }
+        contentTracker.meaningfulNodesCreated++;
+        return paragraphBuilder;
+    }
+    static processParagraphStructured(token, noteBuilder, currentBuilder, contentTracker) {
+        const hasContent = (token.tokens && token.tokens.some((t) => t.text && t.text.trim())) ||
+            (token.text && token.text.trim());
+        if (!hasContent) {
+            return currentBuilder;
+        }
+        const text = token.text ? token.text.trim() : '';
+        const normalizedText = text.replace(/\s+/g, ' ').trim();
+        const isOnlyListMarkers = /^([-*+]|(\d+\.))+(\s*([-*+]|(\d+\.)))*$/.test(normalizedText);
+        const isEmptyListMarkers = normalizedText === '- * 1.' || /^[-*+\d.\s]+$/.test(normalizedText);
+        if (isOnlyListMarkers || isEmptyListMarkers) {
+            return currentBuilder;
+        }
+        let paragraphBuilder = currentBuilder ? currentBuilder.paragraph() : noteBuilder.paragraph();
+        if (token.tokens && token.tokens.length > 0) {
+            paragraphBuilder = this.processInlineTokensStructured(token.tokens, paragraphBuilder);
+        }
+        else if (token.text) {
+            paragraphBuilder = paragraphBuilder.text(decodeHtmlEntities(token.text));
+        }
+        contentTracker.meaningfulNodesCreated++;
+        return paragraphBuilder;
+    }
+    static processListStructured(token, noteBuilder, currentBuilder, contentTracker) {
+        if (!token.items)
+            return currentBuilder;
+        let finalBuilder = currentBuilder;
+        let listItemNumber = 1;
+        token.items.forEach((item, index) => {
+            const hasContent = (item.tokens && item.tokens.some((t) => t.text && t.text.trim())) ||
+                (item.text && item.text.trim());
+            if (!hasContent) {
+                return;
+            }
+            let actualContent = '';
+            if (item.tokens && item.tokens.length > 0) {
+                const firstToken = item.tokens[0];
+                if (firstToken && firstToken.tokens) {
+                    const meaningfulInlineTokens = firstToken.tokens.filter((t) => t.text && t.text.trim());
+                    if (meaningfulInlineTokens.length > 0) {
+                        actualContent = meaningfulInlineTokens.map((t) => t.text.trim()).join('');
+                    }
+                }
+                else if (firstToken && firstToken.text && firstToken.text.trim()) {
+                    actualContent = firstToken.text.trim();
+                }
+            }
+            else if (item.text && item.text.trim()) {
+                actualContent = item.text.trim();
+            }
+            if (!actualContent) {
+                return;
+            }
+            let paragraphBuilder = finalBuilder ? finalBuilder.paragraph() : noteBuilder.paragraph();
+            if (token.ordered) {
+                paragraphBuilder = paragraphBuilder.text(`${listItemNumber}. `);
+                listItemNumber++;
+            }
+            else {
+                paragraphBuilder = paragraphBuilder.text('• ');
+            }
+            if (item.tokens && item.tokens.length > 0) {
+                const firstToken = item.tokens[0];
+                if (firstToken && firstToken.tokens) {
+                    paragraphBuilder = this.processInlineTokensStructured(firstToken.tokens, paragraphBuilder);
+                }
+                else if (firstToken && firstToken.text) {
+                    paragraphBuilder = paragraphBuilder.text(decodeHtmlEntities(firstToken.text));
+                }
+            }
+            else if (item.text) {
+                paragraphBuilder = paragraphBuilder.text(decodeHtmlEntities(item.text));
+            }
+            contentTracker.meaningfulNodesCreated++;
+            finalBuilder = paragraphBuilder;
+        });
+        return finalBuilder;
+    }
+    static processInlineTokensStructured(tokens, paragraphBuilder, isHeading = false) {
+        let currentBuilder = paragraphBuilder;
+        for (const token of tokens) {
+            if (!token.text || !token.text.trim()) {
+                continue;
+            }
+            switch (token.type) {
+                case 'text':
+                    const decodedText = decodeHtmlEntities(token.text);
+                    if (isHeading) {
+                        currentBuilder = currentBuilder.bold(decodedText);
+                    }
+                    else {
+                        currentBuilder = currentBuilder.text(decodedText);
+                    }
+                    break;
+                case 'strong':
+                    currentBuilder = currentBuilder.bold(decodeHtmlEntities(token.text));
+                    break;
+                case 'em':
+                    currentBuilder = currentBuilder.italic(decodeHtmlEntities(token.text));
+                    break;
+                case 'codespan':
+                    currentBuilder = currentBuilder.code(decodeHtmlEntities(token.text));
+                    break;
+                case 'link':
+                    if (token.text) {
+                        const decodedLinkText = decodeHtmlEntities(token.text);
+                        currentBuilder = currentBuilder.text(`${decodedLinkText} (${token.href})`);
+                    }
+                    else {
+                        currentBuilder = currentBuilder.text(token.href);
+                    }
+                    break;
+                default:
+                    if (token.text) {
+                        const decodedFallbackText = decodeHtmlEntities(token.text);
+                        if (isHeading) {
+                            currentBuilder = currentBuilder.bold(decodedFallbackText);
+                        }
+                        else {
+                            currentBuilder = currentBuilder.text(decodedFallbackText);
+                        }
+                    }
+                    break;
+            }
+        }
+        return currentBuilder;
+    }
+}
+exports.MarkdownParser = MarkdownParser;
+//# sourceMappingURL=MarkdownParser.js.map

package/dist/nodes/Substack/MarkdownParser.js.map

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

package/dist/nodes/Substack/Note.fields.js

@@ -7,7 +7,7 @@ exports.noteFields = [
         name: 'body',
         type: 'string',
         default: '',
-        description: 'The content of the note. Supports Markdown formatting.',
+        description: 'The content of the note. Must contain at least one paragraph with actual content. Markdown formatting is supported in Advanced mode.',
         displayOptions: {
             show: {
                 resource: ['note'],
@@ -18,7 +18,32 @@ exports.noteFields = [
         typeOptions: {
             rows: 4,
         },
-        placeholder: 'Write your note content here... (Supports Markdown: **bold**, *italic*, # headings, [links](url), - lists)',
+        placeholder: 'Write your note content here... (Advanced mode supports Markdown: **bold**, *italic*, # headings, [links](url), - lists)',
+    },
+    {
+        displayName: 'Content Type',
+        name: 'contentType',
+        type: 'options',
+        default: 'simple',
+        description: 'Choose how to format the content',
+        displayOptions: {
+            show: {
+                resource: ['note'],
+                operation: ['create'],
+            },
+        },
+        options: [
+            {
+                name: 'Simple Text',
+                value: 'simple',
+                description: 'Plain text content with structured validation',
+            },
+            {
+                name: 'Advanced (Markdown)',
+                value: 'advanced',
+                description: 'Supports Markdown formatting: **bold**, *italic*, # headings, - lists, [links](URL). Builder prevents invalid notes.',
+            },
+        ],
     },
     {
         displayName: 'Visibility',
@@ -132,6 +157,36 @@ exports.noteFields = [
             minValue: 1,
         },
     },
+    {
+        displayName: 'User ID',
+        name: 'userId',
+        type: 'number',
+        default: 0,
+        description: 'The user ID to get notes for',
+        displayOptions: {
+            show: {
+                resource: ['note'],
+                operation: ['getNotesById'],
+            },
+        },
+        required: true,
+    },
+    {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        default: 50,
+        description: 'Max number of results to return',
+        displayOptions: {
+            show: {
+                resource: ['note'],
+                operation: ['getNotesById'],
+            },
+        },
+        typeOptions: {
+            minValue: 1,
+        },
+    },
     {
         displayName: 'Note ID',
         name: 'noteId',

package/dist/nodes/Substack/Note.fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"Note.fields.js","sourceRoot":"","sources":["../../../nodes/Substack/Note.fields.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Note.fields.js","sourceRoot":"","sources":["../../../nodes/Substack/Note.fields.ts"],"names":[],"mappings":"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"}

package/dist/nodes/Substack/Note.operations.d.ts

@@ -5,6 +5,7 @@ export declare enum NoteOperation {
     Create = "create",
     Get = "get",
     GetNotesBySlug = "getNotesBySlug",
+    GetNotesById = "getNotesById",
     GetNoteById = "getNoteById"
 }
 export declare const noteOperations: INodeProperties[];