n8n-nodes-mindrouter 0.1.0

package/README.md

@@ -0,0 +1,48 @@
+# n8n-nodes-mindrouter
+
+Official [n8n](https://n8n.io) community node for [MindRouter](https://mindrouter.io) — a unified gateway to AI models with built-in Indonesian PII guardrails, spend controls, and team management.
+
+## Installation
+
+In n8n: **Settings → Community Nodes → Install**, enter:
+
+```
+n8n-nodes-mindrouter
+```
+
+Self-hosted (npm):
+
+```bash
+npm install n8n-nodes-mindrouter
+```
+
+## Credentials
+
+1. Create an API key in your [MindRouter dashboard](https://mindrouter.io) under **API Keys**.
+2. In n8n, add a **MindRouter API** credential and paste the key.
+3. Leave the base URL as `https://api.mindrouter.io/v1` unless you run a self-hosted gateway.
+
+## Operations
+
+### Chat
+
+Send a prompt (or a full OpenAI-format `messages` array) to any model your account can use. The model dropdown is loaded live from your account, so it always matches your plan and provider settings. Supports temperature, max output tokens, and a simplified output (`text`, `model`, `usage`) or the raw API response.
+
+The node is usable as a tool by n8n **AI Agent** nodes.
+
+### List Models
+
+Returns the models available to your account, including pricing metadata.
+
+## Compatibility
+
+Requires n8n 1.x and Node.js 18.10+.
+
+## Resources
+
+- [MindRouter documentation](https://mindrouter.io/docs)
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
+
+## License
+
+MIT

package/dist/credentials/MindRouterApi.credentials.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MindRouterApi = void 0;
+class MindRouterApi {
+    constructor() {
+        this.name = 'mindRouterApi';
+        this.displayName = 'MindRouter API';
+        this.documentationUrl = 'https://mindrouter.io/docs';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                required: true,
+                default: '',
+                description: 'Create one in the MindRouter dashboard under API Keys',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://api.mindrouter.io/v1',
+                description: 'Change only for a self-hosted or regional gateway',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/models',
+            },
+        };
+    }
+}
+exports.MindRouterApi = MindRouterApi;

package/dist/nodes/MindRouter/MindRouter.node.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MindRouter = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+function normalizeBaseUrl(raw) {
+    const url = String(raw !== null && raw !== void 0 ? raw : 'https://api.mindrouter.io/v1').trim();
+    return url.replace(/\/+$/, '');
+}
+class MindRouter {
+    constructor() {
+        this.description = {
+            displayName: 'MindRouter',
+            name: 'mindRouter',
+            icon: 'file:mindrouter.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Chat with AI models through the MindRouter gateway',
+            defaults: {
+                name: 'MindRouter',
+            },
+            usableAsTool: true,
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [
+                {
+                    name: 'mindRouterApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Chat',
+                            value: 'chat',
+                            action: 'Send a chat completion',
+                            description: 'Send messages to a model and get its reply',
+                        },
+                        {
+                            name: 'List Models',
+                            value: 'listModels',
+                            action: 'List available models',
+                            description: 'List the models your account can use',
+                        },
+                    ],
+                    default: 'chat',
+                },
+                {
+                    displayName: 'Model Name or ID',
+                    name: 'model',
+                    type: 'options',
+                    description: 'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+                    typeOptions: {
+                        loadOptionsMethod: 'getModels',
+                    },
+                    displayOptions: {
+                        show: { operation: ['chat'] },
+                    },
+                    required: true,
+                    default: '',
+                },
+                {
+                    displayName: 'Prompt',
+                    name: 'prompt',
+                    type: 'string',
+                    typeOptions: { rows: 4 },
+                    displayOptions: {
+                        show: { operation: ['chat'] },
+                    },
+                    required: true,
+                    default: '',
+                    description: 'The user message to send',
+                },
+                {
+                    displayName: 'Options',
+                    name: 'options',
+                    type: 'collection',
+                    placeholder: 'Add option',
+                    default: {},
+                    displayOptions: {
+                        show: { operation: ['chat'] },
+                    },
+                    options: [
+                        {
+                            displayName: 'System Prompt',
+                            name: 'systemPrompt',
+                            type: 'string',
+                            typeOptions: { rows: 3 },
+                            default: '',
+                            description: 'Instructions that steer the model, sent as the system message',
+                        },
+                        {
+                            displayName: 'Messages (JSON)',
+                            name: 'messagesJson',
+                            type: 'json',
+                            default: '',
+                            description: 'Full messages array in OpenAI format. When set, it replaces Prompt and System Prompt.',
+                        },
+                        {
+                            displayName: 'Temperature',
+                            name: 'temperature',
+                            type: 'number',
+                            typeOptions: { minValue: 0, maxValue: 2, numberPrecision: 2 },
+                            default: 1,
+                        },
+                        {
+                            displayName: 'Max Output Tokens',
+                            name: 'maxTokens',
+                            type: 'number',
+                            typeOptions: { minValue: 1 },
+                            default: 1024,
+                        },
+                        {
+                            displayName: 'Simplify Output',
+                            name: 'simplify',
+                            type: 'boolean',
+                            default: true,
+                            description: 'Whether to return just the reply text, model, and token usage instead of the raw API response',
+                        },
+                    ],
+                },
+            ],
+        };
+        this.methods = {
+            loadOptions: {
+                async getModels() {
+                    var _a;
+                    const credentials = await this.getCredentials('mindRouterApi');
+                    const baseUrl = normalizeBaseUrl(credentials.baseUrl);
+                    const response = (await this.helpers.httpRequestWithAuthentication.call(this, 'mindRouterApi', {
+                        method: 'GET',
+                        url: `${baseUrl}/models`,
+                        json: true,
+                    }));
+                    const models = (_a = response.data) !== null && _a !== void 0 ? _a : [];
+                    return models
+                        .map((m) => ({
+                        name: m.display_name || m.id,
+                        value: m.id,
+                    }))
+                        .sort((a, b) => a.name.localeCompare(b.name));
+                },
+            },
+        };
+    }
+    async execute() {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const items = this.getInputData();
+        const returnData = [];
+        const operation = this.getNodeParameter('operation', 0);
+        const credentials = await this.getCredentials('mindRouterApi');
+        const baseUrl = normalizeBaseUrl(credentials.baseUrl);
+        for (let i = 0; i < items.length; i++) {
+            try {
+                if (operation === 'listModels') {
+                    const response = (await this.helpers.httpRequestWithAuthentication.call(this, 'mindRouterApi', {
+                        method: 'GET',
+                        url: `${baseUrl}/models`,
+                        json: true,
+                    }));
+                    for (const model of (_a = response.data) !== null && _a !== void 0 ? _a : []) {
+                        returnData.push({ json: model, pairedItem: { item: i } });
+                    }
+                    continue;
+                }
+                const model = this.getNodeParameter('model', i);
+                const prompt = this.getNodeParameter('prompt', i);
+                const options = this.getNodeParameter('options', i, {});
+                let messages;
+                if (options.messagesJson) {
+                    const parsed = typeof options.messagesJson === 'string'
+                        ? JSON.parse(options.messagesJson)
+                        : options.messagesJson;
+                    if (!Array.isArray(parsed)) {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Messages (JSON) must be an array', {
+                            itemIndex: i,
+                        });
+                    }
+                    messages = parsed;
+                }
+                else {
+                    messages = [];
+                    if (options.systemPrompt) {
+                        messages.push({ role: 'system', content: options.systemPrompt });
+                    }
+                    messages.push({ role: 'user', content: prompt });
+                }
+                const body = { model, messages };
+                if (options.temperature !== undefined)
+                    body.temperature = options.temperature;
+                if (options.maxTokens !== undefined)
+                    body.max_tokens = options.maxTokens;
+                const response = (await this.helpers.httpRequestWithAuthentication.call(this, 'mindRouterApi', {
+                    method: 'POST',
+                    url: `${baseUrl}/chat/completions`,
+                    body,
+                    json: true,
+                }));
+                if (options.simplify === false) {
+                    returnData.push({ json: response, pairedItem: { item: i } });
+                }
+                else {
+                    const choices = response.choices;
+                    const message = (_b = choices === null || choices === void 0 ? void 0 : choices[0]) === null || _b === void 0 ? void 0 : _b.message;
+                    returnData.push({
+                        json: {
+                            text: (_c = message === null || message === void 0 ? void 0 : message.content) !== null && _c !== void 0 ? _c : '',
+                            model: (_d = response.model) !== null && _d !== void 0 ? _d : model,
+                            usage: (_e = response.usage) !== null && _e !== void 0 ? _e : null,
+                            finish_reason: (_g = (_f = choices === null || choices === void 0 ? void 0 : choices[0]) === null || _f === void 0 ? void 0 : _f.finish_reason) !== null && _g !== void 0 ? _g : null,
+                        },
+                        pairedItem: { item: i },
+                    });
+                }
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: { error: error.message },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return [returnData];
+    }
+}
+exports.MindRouter = MindRouter;

package/dist/nodes/MindRouter/mindrouter.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60">
+  <rect width="60" height="60" rx="12" fill="#4F46E5"/>
+  <path d="M14 42V18h6l10 14 10-14h6v24h-7V30l-9 12-9-12v12z" fill="#fff"/>
+</svg>

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "n8n-nodes-mindrouter",
+  "version": "0.1.0",
+  "description": "n8n community node for MindRouter — unified gateway to AI models with Indonesian PII guardrails",
+  "keywords": [
+    "n8n-community-node-package",
+    "mindrouter",
+    "ai",
+    "llm",
+    "gateway"
+  ],
+  "license": "MIT",
+  "homepage": "https://mindrouter.io",
+  "author": {
+    "name": "MindRouter",
+    "email": "support@mindrouter.io"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mindrouterio/mindrouterio-n8n.git"
+  },
+  "engines": {
+    "node": ">=18.10"
+  },
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc && node scripts/copy-assets.mjs",
+    "dev": "tsc --watch",
+    "lint": "eslint nodes credentials",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/MindRouterApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/MindRouter/MindRouter.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "eslint-plugin-n8n-nodes-base": "^1.16.0",
+    "n8n-workflow": "^1.70.0",
+    "typescript": "^5.6.0"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  }
+}