n8n-nodes-tunova 0.1.0

package/README.md

@@ -0,0 +1,39 @@
+# n8n-nodes-tunova
+
+An [n8n](https://n8n.io) community node for the **[Tunova](https://tunova.ai) Suno music API** — generate
+full songs from your workflows over a simple REST API. Generation is async and **billed only on a
+successful render** (a failed generation auto-refunds).
+
+This is a community node. [Installing community nodes.](https://docs.n8n.io/integrations/community-nodes/installation/)
+
+## Installation
+
+In n8n: **Settings → Community Nodes → Install**, then enter `n8n-nodes-tunova`.
+
+## Credentials
+
+Create a **Tunova API** credential with your API key (`sk_live_…`). Get one free — 50 tokens, no card —
+at <https://tunova.ai>. The key is sent as the `X-API-Key` header; the credential's **Test** button
+calls `GET /api/me`.
+
+## Operations
+
+- **Generate Song** — submit a job from a text prompt (`prompt`, `model` default `v5.5`, optional
+  instrumental). Async: returns `202` + a `job_id`.
+- **Get Job** — poll a `job_id`; once `status` is `complete`, `clips[].audio_url` is set.
+- **Generate Lyrics** — generate song lyrics (synchronous).
+
+### Typical flow
+
+`Generate Song` → **Wait** (a few seconds) → `Get Job` → **IF** `status` is `complete`/`failed`
+(loop back to Wait otherwise) → use `clips[0].audio_url`. Or pass a `callback_url` to `POST /api/generate`
+with a raw HTTP node and take an HMAC-signed webhook instead of polling.
+
+## Resources
+
+- Tunova docs: <https://api.tunova.ai/docs>
+- Live status: <https://tunova.ai/status>
+
+## License
+
+MIT. Tunova is an independent service, not affiliated with or endorsed by Suno.

package/dist/credentials/TunovaApi.credentials.d.ts

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

package/dist/credentials/TunovaApi.credentials.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TunovaApi = void 0;
+class TunovaApi {
+    constructor() {
+        this.name = 'tunovaApi';
+        this.displayName = 'Tunova API';
+        this.documentationUrl = 'https://api.tunova.ai/docs';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Your Tunova API key (sk_live_…). Get one free (50 tokens, no card) at https://tunova.ai',
+            },
+        ];
+        // Sent as X-API-Key on every request.
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'X-API-Key': '={{$credentials.apiKey}}',
+                },
+            },
+        };
+        // "Test" button in the n8n credential UI — hits GET /api/me.
+        this.test = {
+            request: {
+                baseURL: 'https://api.tunova.ai',
+                url: '/api/me',
+            },
+        };
+    }
+}
+exports.TunovaApi = TunovaApi;

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

@@ -0,0 +1,4 @@
+import { INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class Tunova implements INodeType {
+    description: INodeTypeDescription;
+}

package/dist/nodes/Tunova/Tunova.node.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tunova = void 0;
+// n8n-workflow exports NodeConnectionType as a type (not a runtime enum) — its underlying value
+// for a standard data connection is the string 'main'. Cast keeps us compatible across versions.
+const MAIN = 'main';
+class Tunova {
+    constructor() {
+        this.description = {
+            displayName: 'Tunova',
+            name: 'tunova',
+            icon: 'file:tunova.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Generate music with the Tunova Suno API (billed only on successful renders)',
+            defaults: {
+                name: 'Tunova',
+            },
+            inputs: [MAIN],
+            outputs: [MAIN],
+            credentials: [
+                {
+                    name: 'tunovaApi',
+                    required: true,
+                },
+            ],
+            requestDefaults: {
+                baseURL: 'https://api.tunova.ai',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+            },
+            properties: [
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    default: 'generate',
+                    options: [
+                        {
+                            name: 'Generate Song',
+                            value: 'generate',
+                            action: 'Generate a song',
+                            description: 'Submit a song generation job — returns 202 + a job_id (settled on success)',
+                            routing: {
+                                request: {
+                                    method: 'POST',
+                                    url: '/api/generate',
+                                },
+                            },
+                        },
+                        {
+                            name: 'Generate Lyrics',
+                            value: 'lyrics',
+                            action: 'Generate lyrics',
+                            description: 'Generate song lyrics (synchronous)',
+                            routing: {
+                                request: {
+                                    method: 'POST',
+                                    url: '/api/lyrics',
+                                },
+                            },
+                        },
+                        {
+                            name: 'Get Job',
+                            value: 'getJob',
+                            action: 'Get a job',
+                            description: 'Poll a job for its status and finished clips',
+                            routing: {
+                                request: {
+                                    method: 'GET',
+                                    url: '=/api/jobs/{{$parameter.jobId}}',
+                                },
+                            },
+                        },
+                    ],
+                },
+                {
+                    displayName: 'Prompt',
+                    name: 'prompt',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 2,
+                    },
+                    default: '',
+                    required: true,
+                    description: 'For Generate Song: a text description (e.g. "calm rainy-night lofi"). For Generate Lyrics: the theme/brief.',
+                    displayOptions: {
+                        show: {
+                            operation: ['generate', 'lyrics'],
+                        },
+                    },
+                    routing: {
+                        send: {
+                            type: 'body',
+                            property: 'prompt',
+                        },
+                    },
+                },
+                {
+                    displayName: 'Model',
+                    name: 'model',
+                    type: 'string',
+                    default: 'v5.5',
+                    description: 'Suno model to use (per request)',
+                    displayOptions: {
+                        show: {
+                            operation: ['generate'],
+                        },
+                    },
+                    routing: {
+                        send: {
+                            type: 'body',
+                            property: 'model',
+                        },
+                    },
+                },
+                {
+                    displayName: 'Instrumental',
+                    name: 'makeInstrumental',
+                    type: 'boolean',
+                    default: false,
+                    description: 'Whether to generate an instrumental (no vocals)',
+                    displayOptions: {
+                        show: {
+                            operation: ['generate'],
+                        },
+                    },
+                    routing: {
+                        send: {
+                            type: 'body',
+                            property: 'make_instrumental',
+                        },
+                    },
+                },
+                {
+                    displayName: 'Job ID',
+                    name: 'jobId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    description: 'The job_id returned by Generate Song',
+                    displayOptions: {
+                        show: {
+                            operation: ['getJob'],
+                        },
+                    },
+                },
+            ],
+        };
+    }
+}
+exports.Tunova = Tunova;

package/dist/nodes/Tunova/tunova.svg

@@ -0,0 +1,8 @@
+<svg width="60" height="60" viewBox="0 0 60 60" xmlns="http://www.w3.org/2000/svg">
+  <rect width="60" height="60" rx="14" fill="#0d0d0d"/>
+  <path d="M17 21h26" stroke="#ffffff" stroke-width="5" stroke-linecap="round"/>
+  <path d="M30 21v18" stroke="#ffffff" stroke-width="5" stroke-linecap="round"/>
+  <circle cx="25.5" cy="40.5" r="4.5" fill="#ffffff"/>
+  <path d="M30 39V28l9-2v9" stroke="#ffffff" stroke-width="3" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
+  <circle cx="35.5" cy="35.5" r="4" fill="#ffffff"/>
+</svg>

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "n8n-nodes-tunova",
+  "version": "0.1.0",
+  "description": "n8n community node for the Tunova Suno music API — generate full songs over REST, billed only on successful renders.",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "tunova",
+    "suno",
+    "music",
+    "ai",
+    "music-generation"
+  ],
+  "license": "MIT",
+  "homepage": "https://tunova.ai",
+  "author": "Tunova",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/erliona/n8n-nodes-tunova.git"
+  },
+  "engines": {
+    "node": ">=18.10"
+  },
+  "scripts": {
+    "build": "tsc && npm run icons",
+    "icons": "mkdir -p dist/nodes/Tunova && cp nodes/Tunova/tunova.svg dist/nodes/Tunova/tunova.svg",
+    "dev": "tsc --watch",
+    "prepack": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/TunovaApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/Tunova/Tunova.node.js"
+    ]
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  },
+  "devDependencies": {
+    "n8n-workflow": "^1.60.0",
+    "typescript": "^5.5.3"
+  }
+}