n8n-nodes-version 0.2.0

package/README.md

@@ -0,0 +1,80 @@
+# n8n-version-node
+
+> [!NOTE] 
+> [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
+>
+> [Icon](https://icons8.com/icon/9sDRgODM0vNc/refresh) is from [icons8.com](https://icons8.com/)
+
+## Features
+
+- Check current installed n8n version
+- Fetch latest version from [npm](https://www.npmjs.com/package/n8n)
+- Compare versions and determine if current is latest
+- Fetch release notes from GitHub
+- Trigger workflows based on version status
+
+## Nodes
+
+### Version Checker
+
+Checks the current n8n version and provides various options:
+
+**Options:**
+
+- **Return Latest Version Info** (default: `true`): Fetches latest version from npm and compares with current
+- **Fetch Changelog** (default: `false`): Retrieves release notes from GitHub
+  - **Changelog Version**: Choose between current or latest version
+  - **Strip Links from Changelog**: Remove markdown links from changelog text
+
+**Output Example:**
+
+```json
+{
+  "currentVersion": "1.0.0",
+  "latestVersion": "1.1.0",
+  "isLatest": false,
+  "changelog": "## Bug Fixes\n- Fixed issue with...",
+  "changelogVersion": "1.1.0"
+}
+```
+
+### Version Trigger
+
+Triggers workflows based on n8n version status using cron scheduling.
+
+**Properties:**
+
+- **Cron Expression**: Schedule for version checks (e.g., `0 * * * *` for hourly)
+- **Trigger Condition**:
+  - **Update Available**: Trigger when new version exists
+  - **On Latest Version**: Trigger when already up-to-date
+  - **Always**: Trigger on every check
+
+**Use Cases:**
+
+- Automated update notifications
+- Monitoring version status
+- Scheduled version audits
+
+## Installation
+
+```bash
+npm install n8n-nodes-version
+```
+
+## Development
+
+```bash
+# Watch mode
+npm run dev
+
+# Build
+npm run build
+
+# Lint
+npm run lint
+```
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+// This file is essentially empty in the project provided, but typically would contain exports.
+// If n8n looks for an entry point, it usually just scans package.json 'n8n' field.
+// However, 'main' is set to 'dist/index.js', so we should ensure source exists if tsconfig expects it.
+// Since tsconfig rootDir is ./, we should create an index.ts if it doesn't exist, or just rely on nodes.
+// But to be safe and clean, let's create a simple index.ts that exports nothing or acts as placeholder.

package/dist/nodes/N8nChangelog/N8nChangelog.node.js

@@ -0,0 +1,178 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.N8nChangelog = void 0;
+const https_1 = __importDefault(require("https"));
+/**
+ * Fetch changelog from GitHub releases
+ */
+function getChangelog(version) {
+    return new Promise((resolve) => {
+        try {
+            const options = {
+                hostname: 'api.github.com',
+                path: `/repos/n8n-io/n8n/releases/tags/n8n@${version}`,
+                headers: {
+                    'User-Agent': 'n8n-changelog-node',
+                },
+            };
+            https_1.default
+                .get(options, (res) => {
+                let data = '';
+                res.on('data', (chunk) => (data += chunk));
+                res.on('end', () => {
+                    try {
+                        if (res.statusCode === 404) {
+                            resolve({ body: '', error: `Release n8n@${version} not found` });
+                            return;
+                        }
+                        if (res.statusCode !== 200) {
+                            resolve({ body: '', error: `GitHub API returned status ${res.statusCode}` });
+                            return;
+                        }
+                        const parsed = JSON.parse(data);
+                        resolve({ body: parsed.body || '' });
+                    }
+                    catch (err) {
+                        console.error('[Changelog] Failed to parse GitHub response:', err);
+                        resolve({ body: '', error: 'Failed to parse GitHub response' });
+                    }
+                });
+            })
+                .on('error', (err) => {
+                console.error('[Changelog] Failed to fetch from GitHub:', err);
+                resolve({ body: '', error: `Failed to fetch from GitHub: ${err.message}` });
+            });
+        }
+        catch (err) {
+            console.error('[Changelog] Unexpected error:', err);
+            resolve({ body: '', error: `Unexpected error: ${err}` });
+        }
+    });
+}
+/**
+ * Strip markdown links from text
+ */
+function stripMarkdownLinks(text) {
+    return text.replace(/\[([^\]]+)\]\([^\)]+\)/g, '$1');
+}
+class N8nChangelog {
+    constructor() {
+        this.description = {
+            displayName: 'n8n Changelog',
+            name: 'n8nChangelog',
+            icon: 'file:n8n-version.svg',
+            group: ['transform'],
+            version: 1,
+            description: 'Fetches changelog for a specific n8n version from GitHub',
+            defaults: {
+                name: 'n8n Changelog',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            properties: [
+                {
+                    displayName: 'Version Source',
+                    name: 'versionSource',
+                    type: 'options',
+                    options: [
+                        {
+                            name: 'From Parameter',
+                            value: 'parameter',
+                        },
+                        {
+                            name: 'From Input',
+                            value: 'input',
+                        },
+                    ],
+                    default: 'parameter',
+                    description: 'Where to get the version from',
+                },
+                {
+                    displayName: 'Version',
+                    name: 'version',
+                    type: 'string',
+                    default: '',
+                    placeholder: '1.0.0',
+                    description: 'The n8n version to fetch changelog for (e.g., "1.0.0")',
+                    displayOptions: {
+                        show: {
+                            versionSource: ['parameter'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Version Field',
+                    name: 'versionField',
+                    type: 'string',
+                    default: 'latestVersion',
+                    description: 'The field name containing the version in input data',
+                    displayOptions: {
+                        show: {
+                            versionSource: ['input'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Include Links',
+                    name: 'includeLinks',
+                    type: 'boolean',
+                    default: true,
+                    description: 'Whether to keep markdown links in the changelog text',
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const versionSource = this.getNodeParameter('versionSource', i);
+                const includeLinks = this.getNodeParameter('includeLinks', i);
+                let version;
+                if (versionSource === 'input') {
+                    const versionField = this.getNodeParameter('versionField', i);
+                    version = items[i].json[versionField];
+                }
+                else {
+                    version = this.getNodeParameter('version', i);
+                }
+                if (!version) {
+                    returnData.push({
+                        json: {
+                            error: 'No version provided',
+                            changelog: '',
+                        },
+                    });
+                    continue;
+                }
+                const { body, error } = await getChangelog(version);
+                let changelog = body;
+                if (!includeLinks && changelog) {
+                    changelog = stripMarkdownLinks(changelog);
+                }
+                returnData.push({
+                    json: {
+                        version,
+                        changelog,
+                        error: error || undefined,
+                    },
+                });
+            }
+            catch (err) {
+                console.error('[Changelog] Error processing item:', err);
+                returnData.push({
+                    json: {
+                        error: `Failed to process: ${err}`,
+                        changelog: '',
+                    },
+                });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.N8nChangelog = N8nChangelog;

package/dist/nodes/N8nChangelog/n8n-version.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0,0,256,256" width="256px" height="256px" fill-rule="nonzero"><g fill="#f188a2" fill-rule="nonzero" stroke="none" stroke-width="1" stroke-linecap="butt" stroke-linejoin="miter" stroke-miterlimit="10" stroke-dasharray="" stroke-dashoffset="0" font-family="none" font-weight="none" font-size="none" text-anchor="none" style="mix-blend-mode: normal"><g transform="scale(5.12,5.12)"><path d="M20,3c-5.514,0 -10,4.486 -10,10v20.17188l-3.58594,-3.58594c-0.37701,-0.38755 -0.89487,-0.60597 -1.43555,-0.60547c-0.81349,0.00101 -1.54533,0.49459 -1.85108,1.24844c-0.30574,0.75385 -0.12447,1.61777 0.4585,2.18515l7,7c0.78106,0.78074 2.04706,0.78074 2.82812,0l7,-7c0.52248,-0.50163 0.73295,-1.24653 0.55024,-1.94742c-0.18271,-0.70088 -0.73006,-1.24823 -1.43094,-1.43094c-0.70088,-0.18271 -1.44578,0.02776 -1.94742,0.55024l-3.58594,3.58594v-20.17187c0,-3.309 2.691,-6 6,-6h10.46875l0.26563,-4zM37.9707,10c-0.52023,0.00778 -1.01695,0.21796 -1.38477,0.58594l-7,7c-0.52248,0.50163 -0.73295,1.24653 -0.55024,1.94742c0.18271,0.70088 0.73006,1.24823 1.43094,1.43094c0.70088,0.18271 1.44578,-0.02776 1.94742,-0.55024l3.58594,-3.58594v20.17188c0,3.309 -2.691,6 -6,6h-10.49023l-0.25391,4h10.74414c5.514,0 10,-4.486 10,-10v-20.17187l3.58594,3.58594c0.50163,0.52248 1.24653,0.73295 1.94742,0.55024c0.70088,-0.18271 1.24823,-0.73006 1.43094,-1.43094c0.18271,-0.70088 -0.02776,-1.44578 -0.55024,-1.94742l-7,-7c-0.38217,-0.38233 -0.90283,-0.5937 -1.44336,-0.58594z"></path></g></g></svg>

package/dist/nodes/N8nVersion/N8nVersion.node.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.N8nVersion = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const VersionUtils_1 = require("../VersionUtils");
+class N8nVersion {
+    constructor() {
+        this.description = {
+            displayName: 'Version Checker',
+            name: 'versionChecker',
+            icon: 'file:n8n-version.svg',
+            group: ['transform'],
+            version: 1,
+            description: 'Check current n8n version and optionally fetch changelog from GitHub',
+            defaults: {
+                name: 'Version Checker',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            properties: [
+                {
+                    displayName: 'Options',
+                    name: 'options',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    default: {},
+                    options: [
+                        {
+                            displayName: 'Return Latest Version Info',
+                            name: 'returnIsLatest',
+                            type: 'boolean',
+                            default: true,
+                            description: 'Whether to check and return if the current version is the latest available on npm',
+                        },
+                        {
+                            displayName: 'Fetch Changelog',
+                            name: 'fetchChangelog',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to fetch release notes from GitHub. Note: Subject to GitHub API rate limits.',
+                        },
+                        {
+                            displayName: 'Changelog Version',
+                            name: 'changelogVersion',
+                            type: 'options',
+                            default: 'latest',
+                            description: 'Which version to fetch the changelog for',
+                            displayOptions: {
+                                show: {
+                                    fetchChangelog: [true],
+                                },
+                            },
+                            options: [
+                                {
+                                    name: 'Latest Version',
+                                    value: 'latest',
+                                    description: 'Fetch changelog for the latest version from npm',
+                                },
+                                {
+                                    name: 'Current Version',
+                                    value: 'current',
+                                    description: 'Fetch changelog for the currently installed version',
+                                },
+                            ],
+                        },
+                        {
+                            displayName: 'Strip Links from Changelog',
+                            name: 'stripLinks',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to remove markdown links from the changelog text',
+                            displayOptions: {
+                                show: {
+                                    fetchChangelog: [true],
+                                },
+                            },
+                        },
+                    ],
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const options = this.getNodeParameter('options', i, {});
+                const returnIsLatest = options.returnIsLatest !== false;
+                const fetchChangelog = options.fetchChangelog === true;
+                const changelogVersion = options.changelogVersion || 'latest';
+                const stripLinks = options.stripLinks === true;
+                const json = {};
+                if (returnIsLatest) {
+                    const versions = await (0, VersionUtils_1.checkIsLatest)();
+                    json.currentVersion = versions.currentVersion;
+                    json.latestVersion = versions.latestVersion;
+                    json.isLatest = versions.isLatest;
+                    if (versions.error) {
+                        json.versionError = versions.error;
+                    }
+                }
+                else {
+                    json.currentVersion = (0, VersionUtils_1.getCurrentN8nVersion)();
+                }
+                if (fetchChangelog) {
+                    let versionToFetch;
+                    if (changelogVersion === 'latest') {
+                        if (returnIsLatest && json.latestVersion) {
+                            versionToFetch = json.latestVersion;
+                        }
+                        else {
+                            const latestVersion = await (0, VersionUtils_1.getLatestN8nVersion)();
+                            versionToFetch = latestVersion;
+                        }
+                    }
+                    else {
+                        versionToFetch = json.currentVersion;
+                    }
+                    if (versionToFetch && versionToFetch !== 'unknown') {
+                        const changelogInfo = await (0, VersionUtils_1.getChangelog)(versionToFetch);
+                        let changelog = (0, VersionUtils_1.cleanChangelog)(changelogInfo.changelog);
+                        if (stripLinks && changelog) {
+                            changelog = (0, VersionUtils_1.stripMarkdownLinks)(changelog);
+                        }
+                        json.changelog = changelog;
+                        json.changelogVersion = changelogInfo.version;
+                        if (changelogInfo.error) {
+                            json.changelogError = changelogInfo.error;
+                        }
+                    }
+                    else {
+                        json.changelogError = 'Unable to determine version for changelog fetch';
+                    }
+                }
+                returnData.push({
+                    json,
+                    pairedItem: { item: i },
+                });
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: {
+                            error: error instanceof Error ? error.message : String(error),
+                        },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Failed to process version information: ${errorMessage}`, { itemIndex: i });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.N8nVersion = N8nVersion;

package/dist/nodes/N8nVersion/n8n-version.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0,0,256,256" width="256px" height="256px" fill-rule="nonzero"><g fill="#f188a2" fill-rule="nonzero" stroke="none" stroke-width="1" stroke-linecap="butt" stroke-linejoin="miter" stroke-miterlimit="10" stroke-dasharray="" stroke-dashoffset="0" font-family="none" font-weight="none" font-size="none" text-anchor="none" style="mix-blend-mode: normal"><g transform="scale(5.12,5.12)"><path d="M20,3c-5.514,0 -10,4.486 -10,10v20.17188l-3.58594,-3.58594c-0.37701,-0.38755 -0.89487,-0.60597 -1.43555,-0.60547c-0.81349,0.00101 -1.54533,0.49459 -1.85108,1.24844c-0.30574,0.75385 -0.12447,1.61777 0.4585,2.18515l7,7c0.78106,0.78074 2.04706,0.78074 2.82812,0l7,-7c0.52248,-0.50163 0.73295,-1.24653 0.55024,-1.94742c-0.18271,-0.70088 -0.73006,-1.24823 -1.43094,-1.43094c-0.70088,-0.18271 -1.44578,0.02776 -1.94742,0.55024l-3.58594,3.58594v-20.17187c0,-3.309 2.691,-6 6,-6h10.46875l0.26563,-4zM37.9707,10c-0.52023,0.00778 -1.01695,0.21796 -1.38477,0.58594l-7,7c-0.52248,0.50163 -0.73295,1.24653 -0.55024,1.94742c0.18271,0.70088 0.73006,1.24823 1.43094,1.43094c0.70088,0.18271 1.44578,-0.02776 1.94742,-0.55024l3.58594,-3.58594v20.17188c0,3.309 -2.691,6 -6,6h-10.49023l-0.25391,4h10.74414c5.514,0 10,-4.486 10,-10v-20.17187l3.58594,3.58594c0.50163,0.52248 1.24653,0.73295 1.94742,0.55024c0.70088,-0.18271 1.24823,-0.73006 1.43094,-1.43094c0.18271,-0.70088 -0.02776,-1.44578 -0.55024,-1.94742l-7,-7c-0.38217,-0.38233 -0.90283,-0.5937 -1.44336,-0.58594z"></path></g></g></svg>

package/dist/nodes/N8nVersionTrigger/N8nVersionTrigger.node.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.N8nVersionTrigger = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const cron_1 = require("cron");
+const VersionUtils_1 = require("../VersionUtils");
+class N8nVersionTrigger {
+    constructor() {
+        this.description = {
+            displayName: 'Version Trigger',
+            name: 'versionTrigger',
+            icon: 'file:n8n-version.svg',
+            group: ['trigger'],
+            version: 1,
+            description: 'Triggers workflow based on n8n version status using cron schedule',
+            defaults: {
+                name: 'Version Trigger',
+            },
+            inputs: [],
+            outputs: ['main'],
+            properties: [
+                {
+                    displayName: 'Cron Expression',
+                    name: 'cronExpression',
+                    type: 'string',
+                    default: '0 * * * *',
+                    required: true,
+                    placeholder: '0 * * * *',
+                    description: 'Cron expression for when to check version. Examples: "0 * * * *" (hourly), "0 0 * * *" (daily), "0 0 * * 0" (weekly).',
+                },
+                {
+                    displayName: 'Trigger Condition',
+                    name: 'triggerCondition',
+                    type: 'options',
+                    default: 'update',
+                    required: true,
+                    description: 'When should the workflow be triggered',
+                    options: [
+                        {
+                            name: 'Update Available',
+                            value: 'update',
+                            description: 'Trigger only when a new version is available',
+                        },
+                        {
+                            name: 'On Latest Version',
+                            value: 'latest',
+                            description: 'Trigger only when already on the latest version',
+                        },
+                        {
+                            name: 'Always',
+                            value: 'always',
+                            description: 'Trigger on every check regardless of version status',
+                        },
+                    ],
+                },
+            ],
+        };
+    }
+    async trigger() {
+        const cronExpression = this.getNodeParameter('cronExpression');
+        const triggerCondition = this.getNodeParameter('triggerCondition');
+        let job;
+        try {
+            job = new cron_1.CronJob(cronExpression, async () => {
+                try {
+                    const { isLatest, currentVersion, latestVersion, error } = await (0, VersionUtils_1.checkIsLatest)();
+                    let shouldTrigger = false;
+                    if (triggerCondition === 'always') {
+                        shouldTrigger = true;
+                    }
+                    else if (triggerCondition === 'update') {
+                        shouldTrigger = !isLatest;
+                    }
+                    else if (triggerCondition === 'latest') {
+                        shouldTrigger = isLatest === true;
+                    }
+                    if (shouldTrigger) {
+                        this.emit([
+                            [
+                                {
+                                    json: {
+                                        currentVersion,
+                                        latestVersion,
+                                        isLatest,
+                                        error: error || undefined,
+                                        triggeredAt: new Date().toISOString(),
+                                        triggerCondition,
+                                    },
+                                },
+                            ],
+                        ]);
+                    }
+                }
+                catch (err) {
+                    console.error('[VersionTrigger] Error during cron execution:', err);
+                    // Don't stop the cron job on errors, just log them
+                }
+            }, null, true);
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Invalid cron expression: ${errorMessage}. Please use standard cron format (e.g., "0 * * * *" for hourly).`);
+        }
+        async function closeFunction() {
+            if (job) {
+                job.stop();
+            }
+        }
+        return {
+            closeFunction,
+        };
+    }
+}
+exports.N8nVersionTrigger = N8nVersionTrigger;

package/dist/nodes/N8nVersionTrigger/n8n-version.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0,0,256,256" width="256px" height="256px" fill-rule="nonzero"><g fill="#f188a2" fill-rule="nonzero" stroke="none" stroke-width="1" stroke-linecap="butt" stroke-linejoin="miter" stroke-miterlimit="10" stroke-dasharray="" stroke-dashoffset="0" font-family="none" font-weight="none" font-size="none" text-anchor="none" style="mix-blend-mode: normal"><g transform="scale(5.12,5.12)"><path d="M20,3c-5.514,0 -10,4.486 -10,10v20.17188l-3.58594,-3.58594c-0.37701,-0.38755 -0.89487,-0.60597 -1.43555,-0.60547c-0.81349,0.00101 -1.54533,0.49459 -1.85108,1.24844c-0.30574,0.75385 -0.12447,1.61777 0.4585,2.18515l7,7c0.78106,0.78074 2.04706,0.78074 2.82812,0l7,-7c0.52248,-0.50163 0.73295,-1.24653 0.55024,-1.94742c-0.18271,-0.70088 -0.73006,-1.24823 -1.43094,-1.43094c-0.70088,-0.18271 -1.44578,0.02776 -1.94742,0.55024l-3.58594,3.58594v-20.17187c0,-3.309 2.691,-6 6,-6h10.46875l0.26563,-4zM37.9707,10c-0.52023,0.00778 -1.01695,0.21796 -1.38477,0.58594l-7,7c-0.52248,0.50163 -0.73295,1.24653 -0.55024,1.94742c0.18271,0.70088 0.73006,1.24823 1.43094,1.43094c0.70088,0.18271 1.44578,-0.02776 1.94742,-0.55024l3.58594,-3.58594v20.17188c0,3.309 -2.691,6 -6,6h-10.49023l-0.25391,4h10.74414c5.514,0 10,-4.486 10,-10v-20.17187l3.58594,3.58594c0.50163,0.52248 1.24653,0.73295 1.94742,0.55024c0.70088,-0.18271 1.24823,-0.73006 1.43094,-1.43094c0.18271,-0.70088 -0.02776,-1.44578 -0.55024,-1.94742l-7,-7c-0.38217,-0.38233 -0.90283,-0.5937 -1.44336,-0.58594z"></path></g></g></svg>

package/dist/nodes/VersionUtils.js

@@ -0,0 +1,185 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripMarkdownLinks = exports.cleanChangelog = exports.getChangelog = exports.checkIsLatest = exports.getCurrentN8nVersion = exports.getLatestN8nVersion = void 0;
+const child_process_1 = require("child_process");
+const https_1 = __importDefault(require("https"));
+/**
+ * Fetches the latest n8n version from npm registry
+ * @returns Promise resolving to version string or 'unknown' on error
+ */
+function getLatestN8nVersion() {
+    return new Promise((resolve) => {
+        try {
+            https_1.default
+                .get('https://registry.npmjs.org/n8n/stable', (res) => {
+                let data = '';
+                res.on('data', (chunk) => (data += chunk));
+                res.on('end', () => {
+                    var _a;
+                    try {
+                        const parsed = JSON.parse(data);
+                        resolve((_a = parsed.version) !== null && _a !== void 0 ? _a : 'unknown');
+                    }
+                    catch (err) {
+                        console.error('[VersionUtils] Failed to parse npm registry response:', err);
+                        resolve('unknown');
+                    }
+                });
+            })
+                .on('error', (err) => {
+                console.error('[VersionUtils] Failed to fetch latest version from npm:', err);
+                resolve('unknown');
+            });
+        }
+        catch (err) {
+            console.error('[VersionUtils] Unexpected error in getLatestN8nVersion:', err);
+            resolve('unknown');
+        }
+    });
+}
+exports.getLatestN8nVersion = getLatestN8nVersion;
+/**
+ * Gets the currently installed n8n version
+ * Tries multiple methods: N8N_VERSION env var, n8n --version command, env var scan
+ * @returns Current version string or 'unknown' if not found
+ */
+function getCurrentN8nVersion() {
+    let currentVersion = process.env.N8N_VERSION;
+    // ENV first
+    if (!currentVersion) {
+        try {
+            const stdout = (0, child_process_1.execSync)('n8n --version').toString();
+            if (stdout) {
+                currentVersion = stdout.trim();
+            }
+        }
+        catch (err) {
+            console.error('[VersionUtils] Failed to execute n8n --version:', err);
+        }
+    }
+    // ENV scan fallback
+    if (!currentVersion) {
+        const versionKey = Object.keys(process.env).find((key) => key.includes('VERSION') && key.includes('N8N'));
+        if (versionKey) {
+            currentVersion = process.env[versionKey];
+        }
+    }
+    return currentVersion || 'unknown';
+}
+exports.getCurrentN8nVersion = getCurrentN8nVersion;
+/**
+ * Checks if the current n8n version is the latest available
+ * @returns Object with currentVersion, latestVersion, and isLatest flag
+ */
+async function checkIsLatest() {
+    const currentVersion = getCurrentN8nVersion();
+    const latestVersion = await getLatestN8nVersion();
+    const isLatest = currentVersion !== 'unknown' &&
+        latestVersion !== 'unknown' &&
+        currentVersion === latestVersion;
+    return {
+        currentVersion,
+        latestVersion,
+        isLatest,
+    };
+}
+exports.checkIsLatest = checkIsLatest;
+/**
+ * Fetches changelog from GitHub releases for a specific n8n version
+ * @param version - The n8n version to fetch changelog for (e.g., "1.0.0")
+ * @returns Promise resolving to changelog info with body and optional error
+ */
+function getChangelog(version) {
+    return new Promise((resolve) => {
+        try {
+            const options = {
+                hostname: 'api.github.com',
+                path: `/repos/n8n-io/n8n/releases/tags/n8n@${version}`,
+                headers: {
+                    'User-Agent': 'n8n-version-node',
+                },
+            };
+            https_1.default
+                .get(options, (res) => {
+                let data = '';
+                res.on('data', (chunk) => (data += chunk));
+                res.on('end', () => {
+                    try {
+                        if (res.statusCode === 404) {
+                            resolve({
+                                version,
+                                changelog: '',
+                                error: `Release n8n@${version} not found on GitHub`,
+                            });
+                            return;
+                        }
+                        if (res.statusCode !== 200) {
+                            resolve({
+                                version,
+                                changelog: '',
+                                error: `GitHub API returned status ${res.statusCode}`,
+                            });
+                            return;
+                        }
+                        const parsed = JSON.parse(data);
+                        resolve({
+                            version,
+                            changelog: cleanChangelog(parsed.body || ''),
+                        });
+                    }
+                    catch (err) {
+                        console.error('[VersionUtils] Failed to parse GitHub response:', err);
+                        resolve({
+                            version,
+                            changelog: '',
+                            error: 'Failed to parse GitHub response',
+                        });
+                    }
+                });
+            })
+                .on('error', (err) => {
+                console.error('[VersionUtils] Failed to fetch from GitHub:', err);
+                resolve({
+                    version,
+                    changelog: '',
+                    error: `Failed to fetch from GitHub: ${err.message}`,
+                });
+            });
+        }
+        catch (err) {
+            console.error('[VersionUtils] Unexpected error in getChangelog:', err);
+            resolve({
+                version,
+                changelog: '',
+                error: `Unexpected error: ${err}`,
+            });
+        }
+    });
+}
+exports.getChangelog = getChangelog;
+/**
+ * Cleans changelog text by normalizing line breaks and removing artifacts
+ * @param text - Raw changelog text
+ * @returns Cleaned text
+ */
+function cleanChangelog(text) {
+    if (!text)
+        return '';
+    return text
+        .replace(/\r\n/g, '\n') // Normalize Windows line endings
+        .replace(/\n{3,}/g, '\n\n') // Max 2 consecutive newlines
+        .trim();
+}
+exports.cleanChangelog = cleanChangelog;
+/**
+ * Strips markdown links from text, converting [text](url) to text
+ * @param text - Text containing markdown links
+ * @returns Text with links stripped
+ */
+function stripMarkdownLinks(text) {
+    return text.replace(/\[([^\]]+)\]\([^\)]+\)/g, '$1');
+}
+exports.stripMarkdownLinks = stripMarkdownLinks;

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "n8n-nodes-version",
+  "version": "0.2.0",
+  "description": "n8n nodes to check version, monitor updates, and fetch changelogs",
+  "keywords": [
+    "n8n-community-node-package"
+  ],
+  "license": "MIT",
+  "homepage": "",
+  "author": {
+    "name": "Community",
+    "email": "example@example.com"
+  },
+  "scripts": {
+    "build": "tsc && gulp build:icons",
+    "dev": "tsc --watch",
+    "lint": "tslint -p tsconfig.json -c tslint.json",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "prepublishOnly": "npm run build"
+  },
+  "main": "dist/index.js",
+  "n8n": {
+    "nodes": [
+      "dist/nodes/N8nVersion/N8nVersion.node.js",
+      "dist/nodes/N8nVersionTrigger/N8nVersionTrigger.node.js"
+    ]
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/cron": "^2.0.1",
+    "@types/node": "^14.14.31",
+    "gulp": "^4.0.2",
+    "n8n-core": "^0.116.0",
+    "n8n-workflow": "^0.114.0",
+    "tslint": "^6.1.2",
+    "typescript": "^4.1.3"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  },
+  "dependencies": {
+    "cron": "^4.4.0"
+  }
+}