n8n-nodes-substack-new 0.0.1

package/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright 2025 Jakub Slys
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,139 @@
+# n8n-nodes-substack-new
+
+[![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-new/actions/workflows/test.yaml/badge.svg)](https://github.com/jakub-k-slys/n8n-nodes-substack-new/actions/workflows/test.yaml)
+
+`n8n-nodes-substack-new` is an n8n community package for working with Substack through a gateway-backed client. It ships two related surfaces:
+
+- The `Substack Gateway` n8n node for workflows
+- A small typed `SubstackClient` exported from the package for direct programmatic use
+
+This repository no longer wraps a separate `substack-api` package. The client implementation lives in this codebase under [`nodes/SubstackGateway/shared/SubstackGatewayClient.ts`](/Users/jakubslys/n8n-nodes-substack-new/nodes/SubstackGateway/shared/SubstackGatewayClient.ts).
+
+## What It Supports
+
+- Profile operations
+  - Get your own profile
+  - Get a profile by publication slug
+  - List followed profiles or followed user IDs
+- Post operations
+  - List posts from your own publication
+  - List posts from another publication by slug
+  - Fetch a post by ID
+- Note operations
+  - List notes from your own publication
+  - List notes from another publication by slug
+  - Fetch a note by ID
+  - Create a note with optional attached link
+- Comment operations
+  - List comments for a post by ID
+
+## Installation
+
+Install the package into your n8n environment:
+
+```bash
+npm install n8n-nodes-substack-new
+```
+
+Then restart n8n and install `n8n-nodes-substack-new` as a community package if needed by your deployment model.
+
+## Credentials
+
+The node uses a credential named `SubstackGateway API` with three fields:
+
+- `Publication Address`
+  - Full publication URL such as `https://myblog.substack.com`
+- `Gateway URL`
+  - Optional gateway base URL
+  - Defaults to `https://substack-gateway.vercel.app`
+- `API Key`
+  - Bearer token expected by the gateway
+
+## Quick Example
+
+List recent posts from your own publication:
+
+```json
+{
+  "nodes": [
+    {
+      "name": "Get Recent Posts",
+      "type": "n8n-nodes-substack-new.substack",
+      "parameters": {
+        "resource": "post",
+        "operation": "getAll",
+        "limit": 10
+      },
+      "credentials": {
+        "substackApi": "your-credential-id"
+      }
+    }
+  ]
+}
+```
+
+Create a note:
+
+```json
+{
+  "nodes": [
+    {
+      "name": "Create Note",
+      "type": "n8n-nodes-substack-new.substack",
+      "parameters": {
+        "resource": "note",
+        "operation": "create",
+        "body": "Published from n8n",
+        "visibility": "everyone",
+        "attachment": "none"
+      },
+      "credentials": {
+        "substackApi": "your-credential-id"
+      }
+    }
+  ]
+}
+```
+
+## Direct Client Usage
+
+The package also exports a typed client:
+
+```ts
+import { SubstackClient } from 'n8n-nodes-substack-new';
+
+const client = new SubstackClient({
+  publicationUrl: 'https://myblog.substack.com',
+  token: process.env.SUBSTACK_GATEWAY_TOKEN!,
+});
+
+const ownProfile = await client.ownProfile();
+
+for await (const post of ownProfile.posts()) {
+  console.log(post.title);
+}
+```
+
+## Documentation
+
+- [Introduction](docs/introduction.md)
+- [Installation](docs/installation.md)
+- [Quickstart](docs/quickstart.md)
+- [n8n Usage](docs/n8n-usage.md)
+- [API Reference](docs/api-reference.md)
+- [Examples](docs/examples.md)
+- [Architecture](docs/design.md)
+- [Development](docs/development.md)
+- [Testing](docs/testing.md)
+
+Resource-specific docs:
+
+- [Profiles](docs/resources/profile.md)
+- [Posts](docs/resources/post.md)
+- [Notes](docs/resources/note.md)
+- [Comments](docs/resources/comment.md)
+
+## License
+
+[MIT](LICENSE.md)

package/dist/credentials/SubstackGatewayApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class SubstackApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/SubstackGatewayApi.credentials.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubstackApi = void 0;
+class SubstackApi {
+    constructor() {
+        this.name = 'substackGatewayApi';
+        this.displayName = 'SubstackGateway API';
+        this.documentationUrl = 'https://github.com/jakub-k-slys/n8n-nodes-substack';
+        this.properties = [
+            {
+                displayName: 'Publication Address',
+                name: 'publicationAddress',
+                type: 'string',
+                default: '',
+                placeholder: 'https://myblog.substack.com',
+                description: 'The full URL of your SubstackGateway publication (must include http:// or https://)',
+                required: true,
+                validateType: 'url',
+            },
+            {
+                displayName: 'Gateway URL',
+                name: 'gatewayUrl',
+                type: 'string',
+                default: 'https://substack-gateway.vercel.app',
+                description: 'Optional SubstackGateway Gateway base URL. Use this when routing requests through a self-hosted gateway.',
+                required: false,
+            },
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                default: '',
+                typeOptions: {
+                    password: true,
+                },
+                description: 'Bearer token used by the SubstackGateway Gateway (for example a base64-encoded JSON containing SubstackGateway session cookies)',
+                required: true,
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Cookie: '=substack.sid={{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '=https://{{$credentials.publicationAddress}}',
+                url: '/api/v1/subscription',
+                method: 'GET',
+                headers: {
+                    Cookie: '=substack.sid={{$credentials.apiKey}}',
+                },
+            },
+        };
+    }
+}
+exports.SubstackApi = SubstackApi;
+//# sourceMappingURL=SubstackGatewayApi.credentials.js.map

package/dist/credentials/SubstackGatewayApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubstackGatewayApi.credentials.js","sourceRoot":"","sources":["../../credentials/SubstackGatewayApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,WAAW;IAAxB;QACC,SAAI,GAAG,oBAAoB,CAAC;QAC5B,gBAAW,GAAG,qBAAqB,CAAC;QACpC,qBAAgB,GAAG,oDAAoD,CAAC;QACxE,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,qFAAqF;gBAClG,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,KAAK;aACnB;YAED;gBACC,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,qCAAqC;gBAC9C,WAAW,EACV,0GAA0G;gBAC3G,QAAQ,EAAE,KAAK;aACf;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,EACV,iIAAiI;gBAClI,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;AA5DD,kCA4DC"}

package/dist/nodes/SubstackGateway/Comment.fields.d.ts

@@ -0,0 +1,2 @@
+import { INodeProperties } from 'n8n-workflow';
+export declare const commentFields: INodeProperties[];

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commentFields = void 0;
+exports.commentFields = [
+    {
+        displayName: 'Post ID',
+        name: 'postId',
+        type: 'number',
+        default: 0,
+        description: 'The ID of the post to get comments for',
+        displayOptions: {
+            show: {
+                resource: ['comment'],
+                operation: ['getAll'],
+            },
+        },
+        required: true,
+    },
+    {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        default: 50,
+        description: 'Max number of results to return',
+        displayOptions: {
+            show: {
+                resource: ['comment'],
+                operation: ['getAll'],
+            },
+        },
+        typeOptions: {
+            minValue: 1,
+        },
+    },
+];
+//# sourceMappingURL=Comment.fields.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Comment.fields.js","sourceRoot":"","sources":["../../../nodes/SubstackGateway/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"}

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

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

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

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commentOperationHandlers = exports.commentOperations = exports.CommentOperation = void 0;
+const DataFormatters_1 = require("./shared/DataFormatters");
+const OperationUtils_1 = require("./shared/OperationUtils");
+const OperationHandler_1 = require("./shared/OperationHandler");
+var CommentOperation;
+(function (CommentOperation) {
+    CommentOperation["GetAll"] = "getAll";
+})(CommentOperation || (exports.CommentOperation = CommentOperation = {}));
+exports.commentOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        default: 'getAll',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['comment'],
+            },
+        },
+        options: [
+            {
+                name: 'Get All Comments',
+                value: CommentOperation.GetAll,
+                description: 'Get all comments for a specific post',
+                action: 'Get all comments',
+            },
+        ],
+    },
+];
+async function getAll(executeFunctions, client, publicationAddress, itemIndex) {
+    return OperationHandler_1.OperationHandler.execute(executeFunctions, itemIndex, async () => {
+        const postId = OperationUtils_1.OperationUtils.parseNumericParam(executeFunctions.getNodeParameter('postId', itemIndex), 'postId');
+        const limit = OperationHandler_1.OperationHandler.getLimit(executeFunctions, itemIndex);
+        const post = await client.postForId(postId);
+        return OperationHandler_1.OperationHandler.collectFromIterable(post.comments(), limit, (comment) => DataFormatters_1.DataFormatters.formatComment(comment, postId));
+    });
+}
+exports.commentOperationHandlers = {
+    [CommentOperation.GetAll]: getAll,
+};
+//# sourceMappingURL=Comment.operations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Comment.operations.js","sourceRoot":"","sources":["../../../nodes/SubstackGateway/Comment.operations.ts"],"names":[],"mappings":";;;AAGA,4DAAyD;AACzD,4DAAyD;AACzD,gEAA6D;AAE7D,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,OAAO,mCAAgB,CAAC,OAAO,CAAC,gBAAgB,EAAE,SAAS,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,MAAM,GAAG,+BAAc,CAAC,iBAAiB,CAC9C,gBAAgB,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,EACtD,QAAQ,CACR,CAAC;QACF,MAAM,KAAK,GAAG,mCAAgB,CAAC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;QAErE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,mCAAgB,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAC/E,+BAAc,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAC7C,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC;AAEY,QAAA,wBAAwB,GAQjC;IACH,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM;CACjC,CAAC"}

package/dist/nodes/SubstackGateway/Note.fields.d.ts

@@ -0,0 +1,2 @@
+import { INodeProperties } from 'n8n-workflow';
+export declare const noteFields: INodeProperties[];

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

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noteFields = void 0;
+exports.noteFields = [
+    {
+        displayName: 'Body',
+        name: 'body',
+        type: 'string',
+        default: '',
+        description: 'The content of the note. Supports Markdown formatting.',
+        displayOptions: {
+            show: {
+                resource: ['note'],
+                operation: ['create'],
+            },
+        },
+        required: true,
+        typeOptions: {
+            rows: 4,
+        },
+        placeholder: 'Write your note content here... (Supports Markdown: **bold**, *italic*, # headings, [links](url), - lists)',
+    },
+    {
+        displayName: 'Visibility',
+        name: 'visibility',
+        type: 'options',
+        default: 'everyone',
+        description: 'Who can see this note',
+        displayOptions: {
+            show: {
+                resource: ['note'],
+                operation: ['create'],
+            },
+        },
+        options: [
+            {
+                name: 'Everyone',
+                value: 'everyone',
+                description: 'Public note visible to everyone',
+            },
+            {
+                name: 'Subscribers',
+                value: 'subscribers',
+                description: 'Visible only to subscribers',
+            },
+        ],
+    },
+    {
+        displayName: 'Attachment',
+        name: 'attachment',
+        type: 'options',
+        default: 'none',
+        description: 'Add an attachment to the note',
+        displayOptions: {
+            show: {
+                resource: ['note'],
+                operation: ['create'],
+            },
+        },
+        options: [
+            {
+                name: 'None',
+                value: 'none',
+                description: 'No attachment',
+            },
+            {
+                name: 'Link',
+                value: 'link',
+                description: 'Attach a link to the note',
+            },
+        ],
+    },
+    {
+        displayName: 'Link URL',
+        name: 'linkUrl',
+        type: 'string',
+        default: '',
+        description: 'URL to attach to the note',
+        displayOptions: {
+            show: {
+                resource: ['note'],
+                operation: ['create'],
+                attachment: ['link'],
+            },
+        },
+        required: true,
+        placeholder: 'https://example.com',
+    },
+    {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        default: 50,
+        description: 'Max number of results to return',
+        displayOptions: {
+            show: {
+                resource: ['note'],
+                operation: ['get'],
+            },
+        },
+        typeOptions: {
+            minValue: 1,
+        },
+    },
+    {
+        displayName: 'Slug',
+        name: 'slug',
+        type: 'string',
+        default: '',
+        description: 'The publication slug (subdomain)',
+        displayOptions: {
+            show: {
+                resource: ['note'],
+                operation: ['getNotesBySlug'],
+            },
+        },
+        required: true,
+    },
+    {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        default: 50,
+        description: 'Max number of results to return',
+        displayOptions: {
+            show: {
+                resource: ['note'],
+                operation: ['getNotesBySlug'],
+            },
+        },
+        typeOptions: {
+            minValue: 1,
+        },
+    },
+    {
+        displayName: 'Note ID',
+        name: 'noteId',
+        type: 'string',
+        default: '',
+        description: 'The ID of the note to retrieve',
+        displayOptions: {
+            show: {
+                resource: ['note'],
+                operation: ['getNoteById'],
+            },
+        },
+        required: true,
+    },
+];
+//# sourceMappingURL=Note.fields.js.map

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

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

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

@@ -0,0 +1,11 @@
+import { IExecuteFunctions, INodeProperties } from 'n8n-workflow';
+import { SubstackClient } from './shared/SubstackGatewayClient';
+import { IStandardResponse } from './types';
+export declare enum NoteOperation {
+    Create = "create",
+    Get = "get",
+    GetNotesBySlug = "getNotesBySlug",
+    GetNoteById = "getNoteById"
+}
+export declare const noteOperations: INodeProperties[];
+export declare const noteOperationHandlers: Record<NoteOperation, (executeFunctions: IExecuteFunctions, client: SubstackClient, publicationAddress: string, itemIndex: number) => Promise<IStandardResponse>>;

package/dist/nodes/SubstackGateway/Note.operations.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noteOperationHandlers = exports.noteOperations = exports.NoteOperation = void 0;
+const SubstackUtils_1 = require("./SubstackUtils");
+const DataFormatters_1 = require("./shared/DataFormatters");
+const OperationUtils_1 = require("./shared/OperationUtils");
+const OperationHandler_1 = require("./shared/OperationHandler");
+var NoteOperation;
+(function (NoteOperation) {
+    NoteOperation["Create"] = "create";
+    NoteOperation["Get"] = "get";
+    NoteOperation["GetNotesBySlug"] = "getNotesBySlug";
+    NoteOperation["GetNoteById"] = "getNoteById";
+})(NoteOperation || (exports.NoteOperation = NoteOperation = {}));
+exports.noteOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        default: 'get',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['note'],
+            },
+        },
+        options: [
+            {
+                name: 'Create Note',
+                value: NoteOperation.Create,
+                description: 'Create a new SubstackGateway note',
+                action: 'Create note',
+            },
+            {
+                name: 'Get Notes',
+                value: NoteOperation.Get,
+                description: 'Get notes from own profile',
+                action: 'Get notes',
+            },
+            {
+                name: 'Get Notes From Profile by Slug',
+                value: NoteOperation.GetNotesBySlug,
+                description: 'Get notes from a profile by its publication slug',
+                action: 'Get notes by slug',
+            },
+            {
+                name: 'Get Note by ID',
+                value: NoteOperation.GetNoteById,
+                description: 'Get a specific note by its ID',
+                action: 'Get note by ID',
+            },
+        ],
+    },
+];
+async function get(executeFunctions, client, publicationAddress, itemIndex) {
+    return OperationHandler_1.OperationHandler.execute(executeFunctions, itemIndex, async () => {
+        const limit = OperationHandler_1.OperationHandler.getLimit(executeFunctions, itemIndex);
+        const profile = await OperationHandler_1.OperationHandler.resolveProfile(client);
+        return OperationHandler_1.OperationHandler.collectFromIterable(profile.notes(), limit, (note) => DataFormatters_1.DataFormatters.formatNote(note, publicationAddress));
+    });
+}
+async function getNotesBySlug(executeFunctions, client, publicationAddress, itemIndex) {
+    return OperationHandler_1.OperationHandler.execute(executeFunctions, itemIndex, async () => {
+        const slug = executeFunctions.getNodeParameter('slug', itemIndex);
+        const limit = OperationHandler_1.OperationHandler.getLimit(executeFunctions, itemIndex);
+        const profile = await OperationHandler_1.OperationHandler.resolveProfile(client, slug);
+        return OperationHandler_1.OperationHandler.collectFromIterable(profile.notes(), limit, (note) => DataFormatters_1.DataFormatters.formatNote(note, publicationAddress));
+    });
+}
+async function getNoteById(executeFunctions, client, publicationAddress, itemIndex) {
+    return OperationHandler_1.OperationHandler.execute(executeFunctions, itemIndex, async () => {
+        const noteId = OperationUtils_1.OperationUtils.parseNumericParam(executeFunctions.getNodeParameter('noteId', itemIndex), 'noteId');
+        const note = await client.noteForId(noteId);
+        return DataFormatters_1.DataFormatters.formatNote(note, publicationAddress);
+    });
+}
+async function create(executeFunctions, client, publicationAddress, itemIndex) {
+    return OperationHandler_1.OperationHandler.execute(executeFunctions, itemIndex, async () => {
+        const body = executeFunctions.getNodeParameter('body', itemIndex);
+        const visibility = executeFunctions.getNodeParameter('visibility', itemIndex, 'everyone');
+        const attachment = executeFunctions.getNodeParameter('attachment', itemIndex, 'none');
+        const linkUrl = attachment === 'link'
+            ? executeFunctions.getNodeParameter('linkUrl', itemIndex)
+            : undefined;
+        if (!body || !body.trim()) {
+            throw new Error('Note must contain at least one paragraph with content - body cannot be empty');
+        }
+        const ownProfile = await client.ownProfile();
+        const response = await ownProfile.publishNote(body.trim(), linkUrl ? { attachment: linkUrl } : undefined);
+        return {
+            success: true,
+            noteId: response.id.toString(),
+            body: body.trim(),
+            url: SubstackUtils_1.SubstackUtils.formatUrl(publicationAddress, `/p/${response.id}`),
+            date: new Date().toISOString(),
+            status: 'published',
+            visibility,
+            attachment,
+            linkUrl,
+        };
+    });
+}
+exports.noteOperationHandlers = {
+    [NoteOperation.Create]: create,
+    [NoteOperation.Get]: get,
+    [NoteOperation.GetNotesBySlug]: getNotesBySlug,
+    [NoteOperation.GetNoteById]: getNoteById,
+};
+//# sourceMappingURL=Note.operations.js.map

package/dist/nodes/SubstackGateway/Note.operations.js.map

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

package/dist/nodes/SubstackGateway/Post.fields.d.ts

@@ -0,0 +1,2 @@
+import { INodeProperties } from 'n8n-workflow';
+export declare const postFields: INodeProperties[];