n8n-nodes-rendrkit 0.1.0

package/README.md

@@ -0,0 +1,33 @@
+# n8n-nodes-rendrkit
+
+[n8n](https://n8n.io/) community node for [RendrKit](https://rendrkit.dev) — a Design API for AI agents that generates images from templates.
+
+## Installation
+
+1. Go to **Settings > Community Nodes** in your n8n instance
+2. Select **Install a community node**
+3. Enter `n8n-nodes-rendrkit`
+4. Agree to the risks and click **Install**
+
+## Operations
+
+### Generate Image
+Generate images using AI prompts or direct template rendering.
+
+- **Prompt mode** — Describe what you want and RendrKit generates it
+- **Direct Render mode** — Specify a template ID and fill in slots
+
+Supported sizes: 1080×1080, 1200×628, 1080×1920, 1200×1200, 1280×720
+
+### List Templates
+Retrieve all available templates with their IDs, names, descriptions, and slot definitions.
+
+## Credentials
+
+You need a RendrKit API key. Get one at [rendrkit.dev](https://rendrkit.dev).
+
+## Links
+
+- [RendrKit Website](https://rendrkit.dev)
+- [RendrKit Documentation](https://rendrkit.dev/docs)
+- [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)

package/dist/credentials/RendrKitApi.credentials.d.ts

@@ -0,0 +1,7 @@
+import { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class RendrKitApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/RendrKitApi.credentials.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RendrKitApi = void 0;
+class RendrKitApi {
+    constructor() {
+        this.name = 'rendrKitApi';
+        this.displayName = 'RendrKit API';
+        this.documentationUrl = 'https://rendrkit.dev/docs';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Your RendrKit API key',
+            },
+        ];
+    }
+}
+exports.RendrKitApi = RendrKitApi;
+//# sourceMappingURL=RendrKitApi.credentials.js.map

package/dist/credentials/RendrKitApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RendrKitApi.credentials.js","sourceRoot":"","sources":["../../credentials/RendrKitApi.credentials.ts"],"names":[],"mappings":";;;AAEA,MAAa,WAAW;IAAxB;QACE,SAAI,GAAG,aAAa,CAAC;QACrB,gBAAW,GAAG,cAAc,CAAC;QAC7B,qBAAgB,GAAG,2BAA2B,CAAC;QAC/C,eAAU,GAAsB;YAC9B;gBACE,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,uBAAuB;aACrC;SACF,CAAC;IACJ,CAAC;CAAA;AAfD,kCAeC"}

package/dist/nodes/RendrKit/RendrKit.node.d.ts

@@ -0,0 +1,5 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class RendrKit implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/RendrKit/RendrKit.node.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RendrKit = void 0;
+class RendrKit {
+    constructor() {
+        this.description = {
+            displayName: 'RendrKit',
+            name: 'rendrKit',
+            icon: 'file:rendrkit.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Generate images using RendrKit Design API',
+            defaults: {
+                name: 'RendrKit',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'rendrKitApi',
+                    required: true,
+                },
+            ],
+            requestDefaults: {
+                baseURL: 'https://api.rendrkit.dev/api/v1',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+            },
+            properties: [
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Generate Image',
+                            value: 'generateImage',
+                            description: 'Generate an image from a prompt or template',
+                            action: 'Generate an image',
+                        },
+                        {
+                            name: 'List Templates',
+                            value: 'listTemplates',
+                            description: 'List all available templates',
+                            action: 'List all templates',
+                        },
+                    ],
+                    default: 'generateImage',
+                },
+                // Generate Image fields
+                {
+                    displayName: 'Mode',
+                    name: 'mode',
+                    type: 'options',
+                    options: [
+                        { name: 'Prompt', value: 'prompt' },
+                        { name: 'Direct Render', value: 'directRender' },
+                    ],
+                    default: 'prompt',
+                    displayOptions: {
+                        show: { operation: ['generateImage'] },
+                    },
+                    description: 'Choose between AI prompt or direct template rendering',
+                },
+                {
+                    displayName: 'Prompt',
+                    name: 'prompt',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: {
+                        show: { operation: ['generateImage'], mode: ['prompt'] },
+                    },
+                    description: 'Describe the image you want to generate',
+                },
+                {
+                    displayName: 'Template ID',
+                    name: 'templateId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: {
+                        show: { operation: ['generateImage'], mode: ['directRender'] },
+                    },
+                    description: 'The template ID to render',
+                },
+                {
+                    displayName: 'Slots',
+                    name: 'slots',
+                    type: 'fixedCollection',
+                    typeOptions: { multipleValues: true },
+                    default: {},
+                    displayOptions: {
+                        show: { operation: ['generateImage'], mode: ['directRender'] },
+                    },
+                    description: 'Key-value pairs for template slots',
+                    options: [
+                        {
+                            name: 'slot',
+                            displayName: 'Slot',
+                            values: [
+                                {
+                                    displayName: 'Key',
+                                    name: 'key',
+                                    type: 'string',
+                                    default: '',
+                                },
+                                {
+                                    displayName: 'Value',
+                                    name: 'value',
+                                    type: 'string',
+                                    default: '',
+                                },
+                            ],
+                        },
+                    ],
+                },
+                {
+                    displayName: 'Size',
+                    name: 'size',
+                    type: 'options',
+                    options: [
+                        { name: '1080×1080 (Square)', value: '1080x1080' },
+                        { name: '1200×628 (Landscape)', value: '1200x628' },
+                        { name: '1080×1920 (Story)', value: '1080x1920' },
+                        { name: '1200×1200 (Square Large)', value: '1200x1200' },
+                        { name: '1280×720 (HD)', value: '1280x720' },
+                    ],
+                    default: '1080x1080',
+                    displayOptions: {
+                        show: { operation: ['generateImage'] },
+                    },
+                    description: 'Output image size',
+                },
+                {
+                    displayName: 'Logo URL',
+                    name: 'logoUrl',
+                    type: 'string',
+                    default: '',
+                    displayOptions: {
+                        show: { operation: ['generateImage'] },
+                    },
+                    description: 'Optional URL to a logo image to include',
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const credentials = await this.getCredentials('rendrKitApi');
+        const apiKey = credentials.apiKey;
+        const headers = {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+        };
+        for (let i = 0; i < items.length; i++) {
+            const operation = this.getNodeParameter('operation', i);
+            if (operation === 'generateImage') {
+                const mode = this.getNodeParameter('mode', i);
+                const size = this.getNodeParameter('size', i);
+                const logoUrl = this.getNodeParameter('logoUrl', i, '');
+                const body = { size };
+                if (mode === 'prompt') {
+                    body.prompt = this.getNodeParameter('prompt', i);
+                }
+                else {
+                    body.templateId = this.getNodeParameter('templateId', i);
+                    const slotsData = this.getNodeParameter('slots', i, {});
+                    if (slotsData.slot && slotsData.slot.length > 0) {
+                        const slots = {};
+                        for (const s of slotsData.slot) {
+                            slots[s.key] = s.value;
+                        }
+                        body.slots = slots;
+                    }
+                }
+                if (logoUrl) {
+                    body.logoUrl = logoUrl;
+                }
+                const response = await this.helpers.request({
+                    method: 'POST',
+                    url: 'https://api.rendrkit.dev/api/v1/generate',
+                    headers,
+                    body,
+                    json: true,
+                });
+                returnData.push({ json: response });
+            }
+            else if (operation === 'listTemplates') {
+                const response = await this.helpers.request({
+                    method: 'GET',
+                    url: 'https://api.rendrkit.dev/api/v1/templates',
+                    headers,
+                    json: true,
+                });
+                if (Array.isArray(response)) {
+                    for (const template of response) {
+                        returnData.push({ json: template });
+                    }
+                }
+                else {
+                    returnData.push({ json: response });
+                }
+            }
+        }
+        return [returnData];
+    }
+}
+exports.RendrKit = RendrKit;
+//# sourceMappingURL=RendrKit.node.js.map

package/dist/nodes/RendrKit/RendrKit.node.js.map

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

package/dist/nodes/RendrKit/rendrkit.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
+  <rect width="64" height="64" rx="12" fill="#6C5CE7"/>
+  <text x="32" y="44" text-anchor="middle" font-family="Arial, sans-serif" font-weight="bold" font-size="36" fill="white">R</text>
+</svg>

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "n8n-nodes-rendrkit",
+  "version": "0.1.0",
+  "description": "n8n community node for RendrKit - Design API for AI agents",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "rendrkit",
+    "design",
+    "image-generation"
+  ],
+  "license": "MIT",
+  "homepage": "https://rendrkit.dev",
+  "author": {
+    "name": "RendrKit"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rendrkit/n8n-nodes-rendrkit.git"
+  },
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc && gulp build:icons",
+    "dev": "tsc --watch",
+    "format": "prettier nodes credentials --write",
+    "lint": "eslint nodes credentials package.json",
+    "lintfix": "eslint nodes credentials package.json --fix",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/RendrKitApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/RendrKit/RendrKit.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@typescript-eslint/parser": "~7.18.0",
+    "eslint": "~8.56.0",
+    "gulp": "^4.0.2",
+    "n8n-workflow": "^1.120.9",
+    "prettier": "~3.2.0",
+    "typescript": "~5.4.0"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  }
+}