@silentjma/n8n-nodes-unraid 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -4,6 +4,32 @@ All notable changes to this package. Versions follow [semver](https://semver.org
 
 ## Unreleased
 
+## 0.1.2 - 2026-10-26
+
+Fixes n8n Creator Portal vetting ("Can't find credential file in repo").
+
+### Changed
+- Sources moved to n8n's standard layout: `credentials/`, `nodes/` and `lib/` at the repo root, no longer under `src/`. n8n's tools map `package.json`'s `dist/credentials/X.js` to `credentials/X.ts` in the repo. The published files and their `dist/` paths are unchanged.
+- The credential's *Ignore SSL Issues* field is now named `ignoreSslIssues`. n8n's lint rules treat any field name containing "cert" as a secret. Credentials saved with the old `allowUnauthorizedCerts` field keep working: it is still declared (hidden) and still read.
+- `npm run lint` no longer needs exemptions for n8n's `no-credential-reuse` and `credential-password-field` rules.
+
+## 0.1.1 - 2026-10-26
+
+Passes n8n's community package scanner (`npx @n8n/scan-community-package @silentjma/n8n-nodes-unraid`).
+
+### Fixed
+- `package.json`: `author` now includes the npm owner's email. The scanner requires an author email (`valid-author`), and n8n's Creator Portal reads it from npm to match the package to its owner ("Error getting author email from npm").
+- Nodes declare their inputs and outputs with `NodeConnectionTypes.Main`.
+- Errors from an operation are always raised as `NodeApiError` or `NodeOperationError`, with the item index, so n8n shows them properly per item.
+- An invalid log filter pattern now fails with a clear node error. It no longer throws a plain `Error` from the log helpers.
+
+### Added
+- Credential icon. Node icons use the light/dark form.
+- `npm run lint` now includes n8n's community node rules (`@n8n/eslint-plugin-community-nodes`, the ruleset the scanner runs), so CI catches scan failures before a release. ESLint is pinned to 9.29.0 to match that plugin.
+
+### Docs
+- Telegram needs a public HTTPS webhook. Set `N8N_WEBHOOK_URL`; on n8n 2.x, `WEBHOOK_URL` alone leaves test webhooks on the editor URL.
+
 ### Project
 - Community files: CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, SUPPORT, issue and pull request templates, Dependabot.
 - CI on every push and pull request. A release workflow publishes to npm with provenance when a `v*` tag is pushed.

package/README.md

@@ -10,10 +10,12 @@ Unofficial n8n community nodes for the [Unraid API](https://docs.unraid.net/API/
 - **Unraid**: an action node for System, Array, Disk, Share, Docker Container, Virtual Machine, Log File and Notification, plus a Custom GraphQL operation.
 - **Unraid Trigger**: a polling trigger for new log lines (syslog or a container log), health problems, notifications, container state changes and container updates.
 
-Both nodes use the same built-in rules ([src/lib/analysis.ts](src/lib/analysis.ts)). The rules tag log lines and health findings as `info`, `warning` or `critical` and attach **suggested next steps**.
+Both nodes use the same built-in rules ([lib/analysis.ts](lib/analysis.ts)). The rules tag log lines and health findings as `info`, `warning` or `critical` and attach **suggested next steps**.
 
 ## Installation
 
+📦 **npm:** [@silentjma/n8n-nodes-unraid](https://www.npmjs.com/package/@silentjma/n8n-nodes-unraid)
+
 **Community Nodes (recommended):** in n8n, open **Settings › Community Nodes › Install** and enter `@silentjma/n8n-nodes-unraid`.
 
 **Manual / custom folder:** run `npm pack` and extract the tarball's `package/` folder into `~/.n8n/custom/n8n-nodes-unraid`. In Docker that is `/home/node/.n8n/custom`, which on Unraid is usually `/mnt/user/appdata/n8n/custom`. Then restart n8n.
@@ -46,6 +48,9 @@ Prefer workflows without a community node? [n8n-unraid-telegram-workflows](https
 | Notification | Create (optionally only if unique), Get Many, Get Overview, Get Warnings and Alerts, Archive, Archive All |
 | Custom GraphQL | Execute any query or mutation |
 
+
+<img width="638" height="763" alt="{0E837C8A-E0E8-4CB5-903F-C4CD4459B37A}" src="https://github.com/user-attachments/assets/a3143eab-9a77-4ef6-99b7-35f639eb996e" />
+
 Containers can be given by **name** (`plex`) or ID.
 
 ## Unraid Trigger events
@@ -71,6 +76,9 @@ On the first poll, the trigger only records a baseline. Turn on *Emit Existing o
 | [Unraid · Docker updates & actions](workflows/unraid-docker.json) | Weekly (Sun 04:00), and called by the bot | Weekly: updates every container that has a new image, except `cfg.excludeFromUpdates`. It reports only when something changed. Also answers the Docker commands. |
 | [Unraid · Sysadmin & Telegram bot](workflows/unraid-sysadmin-bot.json) | Telegram Trigger | The bot. Answers the sysadmin commands and forwards Docker commands to the Docker workflow. |
 
+<img width="1184" height="743" alt="image" src="https://github.com/user-attachments/assets/606adfce-023e-4d05-b873-b86bea7c8f0e" />
+
+
 A Telegram bot delivers updates to a single webhook, so **only the bot workflow has a Telegram Trigger**. The other two just send messages.
 
 ### Commands
@@ -104,7 +112,8 @@ help - All commands
 ### Setup
 
 1. Create a bot with @BotFather and add a **Telegram** credential in n8n with its token.
-2. Import the three workflows. In each one, select the **Unraid API** credential (`https://192.168.178.2`, Ignore SSL Issues on) and the Telegram credential.
+   n8n must be reachable at a **public HTTPS** address (for example a Cloudflare Tunnel or a reverse proxy), and the n8n container needs `N8N_WEBHOOK_URL=https://<that host>/`, otherwise Telegram rejects the trigger with *Bad request*. See [SUPPORT.md](SUPPORT.md).
+2. Import the three workflows. In each one, select the **Unraid API** credential (your server as `https://<unraid-ip>`, Ignore SSL Issues on) and the Telegram credential.
 3. Publish the **Sysadmin & Telegram bot** workflow and send the bot any message. While `cfg.allowedChatIds` is empty, the bot only replies with your chat ID and runs nothing else.
 4. Put that ID in **Bot settings › cfg.allowedChatIds**, **Alert settings › cfg.telegramChatId** and **Settings › cfg.telegramChatId** (Docker workflow). After that, the bot ignores every other chat.
 5. In the bot's **Run Docker workflow** node, pick *Unraid · Docker updates & actions*. Alternatively, regenerate with `DOCKER_WORKFLOW_ID=<id> npm run workflow` and re-import.
@@ -124,7 +133,7 @@ npm run build && npm run lint && npm run typecheck && npm test
 npm pack   # -> silentjma-n8n-nodes-unraid-0.1.0.tgz
 ```
 
-The queries in [src/lib/queries.ts](src/lib/queries.ts) are written against `api/generated-schema.graphql` from the unraid/api repository. Check them again when Unraid changes the schema.
+The queries in [lib/queries.ts](lib/queries.ts) are written against `api/generated-schema.graphql` from the unraid/api repository. Check them again when Unraid changes the schema.
 
 ## Support and contributing
 

package/dist/credentials/UnraidApi.credentials.js

@@ -4,6 +4,7 @@ exports.UnraidApi = void 0;
 class UnraidApi {
     name = 'unraidApi';
     displayName = 'Unraid API';
+    icon = { light: 'file:../nodes/Unraid/unraid.svg', dark: 'file:../nodes/Unraid/unraid.svg' };
     documentationUrl = 'https://docs.unraid.net/API/how-to-use-the-api/';
     properties = [
         {
@@ -26,11 +27,21 @@ class UnraidApi {
         },
         {
             displayName: 'Ignore SSL Issues',
-            name: 'allowUnauthorizedCerts',
+            name: 'ignoreSslIssues',
             type: 'boolean',
             default: false,
             description: 'Whether to connect even if the server uses a self-signed or otherwise invalid certificate (the default for Unraid on a LAN IP)',
         },
+        // Pre-0.1.2 name of "Ignore SSL Issues". Kept hidden so credentials saved with it keep working:
+        // n8n only loads stored values for declared fields. The password option satisfies n8n's name-based
+        // lint rule (the name contains "cert"); it has no effect on a hidden field.
+        {
+            displayName: 'Ignore SSL Issues (Legacy)',
+            name: 'allowUnauthorizedCerts',
+            type: 'hidden',
+            typeOptions: { password: true },
+            default: false,
+        },
     ];
     authenticate = {
         type: 'generic',
@@ -45,7 +56,7 @@ class UnraidApi {
             baseURL: '={{$credentials.serverUrl.replace(/\\/+$/, "")}}',
             url: '/graphql',
             method: 'POST',
-            skipSslCertificateValidation: '={{$credentials.allowUnauthorizedCerts}}',
+            skipSslCertificateValidation: '={{$credentials.ignoreSslIssues === true || $credentials.allowUnauthorizedCerts === true}}',
             headers: { 'Content-Type': 'application/json' },
             body: { query: '{ online info { os { hostname } } }' },
         },

package/dist/lib/client.js

@@ -16,7 +16,8 @@ async function unraidGraphql(query, variables = {}) {
             headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
             body: { query, variables },
             json: true,
-            skipSslCertificateValidation: credentials.allowUnauthorizedCerts === true,
+            // allowUnauthorizedCerts: the field's name before 0.1.2, still set on older saved credentials.
+            skipSslCertificateValidation: credentials.ignoreSslIssues === true || credentials.allowUnauthorizedCerts === true,
         }));
     }
     catch (error) {

package/dist/lib/logs.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.splitLogContent = splitLogContent;
+exports.invalidPatternReason = invalidPatternReason;
 exports.compilePattern = compilePattern;
 exports.filterLogLines = filterLogLines;
 // Log text -> structured lines, optionally filtered by regex and classified with suggested next steps.
@@ -11,16 +12,22 @@ function splitLogContent(content, startLine) {
         raw.pop();
     return raw.map((line, i) => ({ lineNumber: startLine ? startLine + i : undefined, line }));
 }
-function compilePattern(pattern) {
+/** Why a filter pattern is not a valid regular expression, or null when it is fine (or empty). */
+function invalidPatternReason(pattern) {
     if (!pattern?.trim())
-        return undefined;
+        return null;
     try {
-        return new RegExp(pattern, 'i');
+        new RegExp(pattern, 'i');
+        return null;
     }
     catch (error) {
-        throw new Error(`Invalid filter pattern "${pattern}": ${error.message}`);
+        return `Invalid filter pattern "${pattern}": ${error.message}`;
     }
 }
+/** Case-insensitive regex for a filter pattern; undefined when empty or invalid (validate with invalidPatternReason first). */
+function compilePattern(pattern) {
+    return invalidPatternReason(pattern) === null && pattern?.trim() ? new RegExp(pattern, 'i') : undefined;
+}
 function filterLogLines(lines, filter) {
     const regex = compilePattern(filter.pattern);
     const out = [];

package/dist/nodes/Unraid/Unraid.node.js

@@ -451,14 +451,14 @@ class Unraid {
     description = {
         displayName: 'Unraid',
         name: 'unraid',
-        icon: 'file:unraid.svg',
+        icon: { light: 'file:unraid.svg', dark: 'file:unraid.svg' },
         group: ['transform'],
         version: 1,
         subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
         description: 'Monitor and control an Unraid server through its GraphQL API',
         defaults: { name: 'Unraid' },
-        inputs: ['main'],
-        outputs: ['main'],
+        inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+        outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
         usableAsTool: true,
         credentials: [{ name: 'unraidApi', required: true }],
         properties,
@@ -579,6 +579,9 @@ class Unraid {
                     }
                     else if (operation === 'getLogs') {
                         const o = this.getNodeParameter('logOptions', i, {});
+                        const badPattern = (0, logs_1.invalidPatternReason)(o.pattern);
+                        if (badPattern)
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), badPattern, { itemIndex: i });
                         const vars = { id: await containerId(), tail: this.getNodeParameter('tail', i) };
                         if (o.since)
                             vars.since = new Date(o.since).toISOString();
@@ -632,6 +635,9 @@ class Unraid {
                     }
                     else {
                         const o = this.getNodeParameter('logOptions', i, {});
+                        const badPattern = (0, logs_1.invalidPatternReason)(o.pattern);
+                        if (badPattern)
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), badPattern, { itemIndex: i });
                         const vars = { path: this.getNodeParameter('logPath', i), lines: this.getNodeParameter('lines', i) };
                         if (Number(o.startLine) > 0)
                             vars.startLine = Number(o.startLine);
@@ -701,9 +707,11 @@ class Unraid {
                     out.push({ json: { error: error.message }, pairedItem: { item: i } });
                     continue;
                 }
-                if (error instanceof n8n_workflow_1.NodeOperationError && error.context.itemIndex === undefined)
-                    error.context.itemIndex = i;
-                throw error;
+                // Keep NodeApiError (it carries the HTTP details); wrap anything else so n8n shows it per item.
+                const nodeError = error instanceof n8n_workflow_1.NodeApiError ? error : new n8n_workflow_1.NodeOperationError(this.getNode(), error, { itemIndex: i });
+                if (nodeError.context.itemIndex === undefined)
+                    nodeError.context.itemIndex = i;
+                throw nodeError;
             }
         }
         return [out];

package/dist/nodes/UnraidTrigger/UnraidTrigger.node.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UnraidTrigger = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
 const analysis_1 = require("../../lib/analysis");
 const client_1 = require("../../lib/client");
 const containers_1 = require("../../lib/containers");
@@ -17,7 +18,7 @@ class UnraidTrigger {
     description = {
         displayName: 'Unraid Trigger',
         name: 'unraidTrigger',
-        icon: 'file:unraid.svg',
+        icon: { light: 'file:unraid.svg', dark: 'file:unraid.svg' },
         group: ['trigger'],
         version: 1,
         subtitle: '={{$parameter["event"]}}',
@@ -25,7 +26,7 @@ class UnraidTrigger {
         defaults: { name: 'Unraid Trigger' },
         polling: true,
         inputs: [],
-        outputs: ['main'],
+        outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
         credentials: [{ name: 'unraidApi', required: true }],
         properties: [
             {
@@ -153,6 +154,9 @@ class UnraidTrigger {
     async poll() {
         const event = this.getNodeParameter('event');
         const options = this.getNodeParameter('options', {});
+        const badPattern = (0, logs_1.invalidPatternReason)(options.pattern);
+        if (badPattern)
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), badPattern);
         const state = this.getWorkflowStaticData('node');
         const manual = this.getMode() === 'manual';
         const emitExisting = manual || options.emitExisting === true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silentjma/n8n-nodes-unraid",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Unofficial n8n community nodes for the Unraid GraphQL API: Docker, array, VMs, logs, notifications and a polling trigger for log/alert watching.",
   "keywords": [
     "n8n-community-node-package",
@@ -13,6 +13,7 @@
   "license": "MIT",
   "author": {
     "name": "Mohamed Ayoub Jabane",
+    "email": "kilwanitro@gmail.com",
     "url": "https://github.com/SilentJMA"
   },
   "homepage": "https://github.com/SilentJMA/n8n-nodes-unraid#readme",
@@ -62,9 +63,10 @@
     ]
   },
   "devDependencies": {
-    "@eslint/js": "9.39.5",
+    "@eslint/js": "9.29.0",
+    "@n8n/eslint-plugin-community-nodes": "0.37.0",
     "@types/node": "22.20.5",
-    "eslint": "9.39.5",
+    "eslint": "9.29.0",
     "eslint-plugin-n8n-nodes-base": "1.16.7",
     "n8n-workflow": "2.43.5",
     "typescript": "5.9.3",