n8n-nodes-shortgenius 0.1.0

package/dist/nodes/ShortGenius/ShortGenius.node.js

@@ -0,0 +1,1071 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShortGenius = void 0;
+const vendor_1 = require("../../src/vendor");
+const n8n_workflow_1 = require("n8n-workflow");
+/**
+ * Action node for the ShortGenius API.
+ *
+ * Mirrors the @shortgenius/sdk surface: Videos, Series, Images, Audio, Voices,
+ * Music, Connections, Credits, Webhooks. Each operation maps directly to a
+ * method on the SDK client so the shape stays in sync when new endpoints land.
+ *
+ * ShortGenius is single-user — the API key authenticates and there is NO
+ * organization parameter anywhere.
+ */
+class ShortGenius {
+    description = {
+        displayName: 'ShortGenius',
+        name: 'shortGenius',
+        icon: 'file:ShortGenius.svg',
+        group: ['transform'],
+        version: 1,
+        usableAsTool: true,
+        subtitle: '={{$parameter["resource"] + ": " + $parameter["operation"]}}',
+        description: 'Generate AI videos, images, and audio, and manage your ShortGenius account',
+        defaults: { name: 'ShortGenius' },
+        inputs: ['main'],
+        outputs: ['main'],
+        credentials: [{ name: 'shortGeniusApi', required: true }],
+        properties: [
+            {
+                displayName: 'Resource',
+                name: 'resource',
+                type: 'options',
+                noDataExpression: true,
+                default: 'video',
+                options: [
+                    { name: 'Video', value: 'video' },
+                    { name: 'Series', value: 'series' },
+                    { name: 'Image', value: 'image' },
+                    { name: 'Audio', value: 'audio' },
+                    { name: 'Voice', value: 'voice' },
+                    { name: 'Music', value: 'music' },
+                    { name: 'Connection', value: 'connection' },
+                    { name: 'Credits', value: 'credits' },
+                    { name: 'Webhook', value: 'webhook' }
+                ]
+            },
+            // ---------------------------------------------------------------------
+            // Video operations
+            // ---------------------------------------------------------------------
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                default: 'list',
+                displayOptions: { show: { resource: ['video'] } },
+                options: [
+                    { name: 'List', value: 'list', action: 'List videos', description: 'List the videos in your account' },
+                    { name: 'Get', value: 'get', action: 'Get a video', description: 'Get a single video by ID' },
+                    { name: 'Create', value: 'create', action: 'Create a video', description: 'Render a video from drafted content' },
+                    { name: 'Draft', value: 'draft', action: 'Draft a video', description: 'Write a video script from a topic' },
+                    { name: 'Draft From URL', value: 'draftUrl', action: 'Draft a video from a URL', description: 'Summarize a webpage into a video script' },
+                    { name: 'Draft From Script', value: 'draftScript', action: 'Draft a video from a script', description: 'Build scenes from your own script' },
+                    { name: 'Draft Quiz', value: 'draftQuiz', action: 'Draft a quiz video', description: 'Write a quiz video from a topic' },
+                    { name: 'Draft News', value: 'draftNews', action: 'Draft a news video', description: 'Write a news video from a topic' },
+                    { name: 'Generate Topics', value: 'topics', action: 'Generate video topics', description: 'Brainstorm video topic ideas' }
+                ]
+            },
+            // ---------------------------------------------------------------------
+            // Series operations
+            // ---------------------------------------------------------------------
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                default: 'list',
+                displayOptions: { show: { resource: ['series'] } },
+                options: [
+                    { name: 'List', value: 'list', action: 'List series', description: 'List the series in your account' },
+                    { name: 'Get', value: 'get', action: 'Get a series', description: 'Get a single series and its episodes by ID' },
+                    { name: 'Create', value: 'create', action: 'Create a series', description: 'Start a recurring, scheduled video series' }
+                ]
+            },
+            // ---------------------------------------------------------------------
+            // Image operations
+            // ---------------------------------------------------------------------
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                default: 'list',
+                displayOptions: { show: { resource: ['image'] } },
+                options: [
+                    { name: 'List', value: 'list', action: 'List images', description: 'List the images in your account' },
+                    { name: 'Get', value: 'get', action: 'Get an image', description: 'Get a single image by ID' },
+                    { name: 'Create', value: 'create', action: 'Create an image', description: 'Generate an image from a prompt' },
+                    { name: 'List Styles', value: 'styles', action: 'List image styles', description: 'List the available image styles' }
+                ]
+            },
+            // ---------------------------------------------------------------------
+            // Audio operations
+            // ---------------------------------------------------------------------
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                default: 'list',
+                displayOptions: { show: { resource: ['audio'] } },
+                options: [
+                    { name: 'List', value: 'list', action: 'List audio', description: 'List the audio clips in your account' },
+                    { name: 'Get', value: 'get', action: 'Get an audio clip', description: 'Get a single audio clip by ID' },
+                    { name: 'Create Speech', value: 'speech', action: 'Create speech audio', description: 'Generate text-to-speech audio' }
+                ]
+            },
+            // ---------------------------------------------------------------------
+            // Voice operations
+            // ---------------------------------------------------------------------
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                default: 'list',
+                displayOptions: { show: { resource: ['voice'] } },
+                options: [
+                    { name: 'List', value: 'list', action: 'List voices', description: 'List the available text-to-speech voices' },
+                    { name: 'Get', value: 'get', action: 'Get a voice', description: 'Get a single voice by ID' }
+                ]
+            },
+            // ---------------------------------------------------------------------
+            // Music operations
+            // ---------------------------------------------------------------------
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                default: 'genres',
+                displayOptions: { show: { resource: ['music'] } },
+                options: [
+                    { name: 'List Genres', value: 'genres', action: 'List music genres', description: 'List the available soundtrack genres' },
+                    { name: 'List Tracks', value: 'tracks', action: 'List tracks in a genre', description: 'List the soundtracks in a genre' }
+                ]
+            },
+            // ---------------------------------------------------------------------
+            // Connection operations
+            // ---------------------------------------------------------------------
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                default: 'list',
+                displayOptions: { show: { resource: ['connection'] } },
+                options: [
+                    { name: 'List', value: 'list', action: 'List connections', description: 'List your publishing connections' }
+                ]
+            },
+            // ---------------------------------------------------------------------
+            // Credits operations
+            // ---------------------------------------------------------------------
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                default: 'get',
+                displayOptions: { show: { resource: ['credits'] } },
+                options: [
+                    { name: 'Get Balance', value: 'get', action: 'Get the credit balance', description: 'Get your current credit balance' }
+                ]
+            },
+            // ---------------------------------------------------------------------
+            // Webhook operations
+            // ---------------------------------------------------------------------
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                default: 'list',
+                displayOptions: { show: { resource: ['webhook'] } },
+                options: [
+                    { name: 'List Endpoints', value: 'list', action: 'List webhook endpoints' },
+                    { name: 'Create Endpoint', value: 'create', action: 'Create a webhook endpoint' },
+                    { name: 'Delete Endpoint', value: 'delete', action: 'Delete a webhook endpoint' }
+                ]
+            },
+            // =====================================================================
+            // Shared pagination (List operations)
+            // =====================================================================
+            {
+                displayName: 'Page',
+                name: 'page',
+                type: 'number',
+                default: 0,
+                typeOptions: { minValue: 0 },
+                description: 'Page number to fetch (0 = first page)',
+                displayOptions: {
+                    show: {
+                        resource: ['video', 'series', 'image', 'audio', 'voice'],
+                        operation: ['list']
+                    }
+                }
+            },
+            {
+                displayName: 'Limit',
+                name: 'limit',
+                type: 'number',
+                default: 20,
+                typeOptions: { minValue: 1, maxValue: 100 },
+                description: 'Max number of items per page',
+                displayOptions: {
+                    show: {
+                        resource: ['video', 'series', 'image', 'audio', 'voice'],
+                        operation: ['list']
+                    }
+                }
+            },
+            // =====================================================================
+            // Video: Get — ID
+            // =====================================================================
+            {
+                displayName: 'Video ID',
+                name: 'videoId',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'ShortGenius video ID (UUID)',
+                displayOptions: { show: { resource: ['video'], operation: ['get'] } }
+            },
+            // Video: Draft — topic + duration + locale
+            {
+                displayName: 'Topic',
+                name: 'topic',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'The history of the Roman Empire',
+                description: 'The topic to write a video about',
+                displayOptions: { show: { resource: ['video'], operation: ['draft', 'draftQuiz', 'draftNews'] } }
+            },
+            {
+                displayName: 'Duration (Seconds)',
+                name: 'duration',
+                type: 'options',
+                default: '60',
+                required: true,
+                description: 'Desired length of the final script in seconds (best-effort)',
+                options: [
+                    { name: '60', value: '60' },
+                    { name: '90', value: '90' },
+                    { name: '120', value: '120' },
+                    { name: '180', value: '180' },
+                    { name: '240', value: '240' },
+                    { name: '300', value: '300' },
+                    { name: '360', value: '360' },
+                    { name: '420', value: '420' },
+                    { name: '480', value: '480' },
+                    { name: '540', value: '540' },
+                    { name: '600', value: '600' },
+                    { name: '660', value: '660' },
+                    { name: '720', value: '720' },
+                    { name: '780', value: '780' },
+                    { name: '840', value: '840' },
+                    { name: '900', value: '900' }
+                ],
+                displayOptions: { show: { resource: ['video'], operation: ['draft'] } }
+            },
+            {
+                displayName: 'Locale',
+                name: 'locale',
+                type: 'string',
+                default: '',
+                placeholder: 'en-US',
+                description: 'Optional locale for the generated video (e.g. en-US). Leave blank to auto-detect.',
+                displayOptions: { show: { resource: ['video'], operation: ['draft', 'draftUrl', 'draftQuiz', 'draftNews'] } }
+            },
+            // Video: Draft From URL — url + prompt
+            {
+                displayName: 'URL',
+                name: 'url',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'https://example.com/article',
+                description: 'URL of a webpage to summarize into a video',
+                displayOptions: { show: { resource: ['video'], operation: ['draftUrl'] } }
+            },
+            {
+                displayName: 'Prompt',
+                name: 'prompt',
+                type: 'string',
+                default: '',
+                description: 'Optional instructions for the AI reading the webpage',
+                displayOptions: { show: { resource: ['video'], operation: ['draftUrl'] } }
+            },
+            // Video: Draft From Script — script
+            {
+                displayName: 'Script',
+                name: 'script',
+                type: 'string',
+                typeOptions: { rows: 4 },
+                default: '',
+                required: true,
+                description: 'The content you want the AI to narrate',
+                displayOptions: { show: { resource: ['video'], operation: ['draftScript'] } }
+            },
+            // Video: Generate Topics
+            {
+                displayName: 'Parent Topic',
+                name: 'parentTopic',
+                type: 'string',
+                default: '',
+                description: 'Optional base idea or theme for generating topics',
+                displayOptions: { show: { resource: ['video'], operation: ['topics'] } }
+            },
+            {
+                displayName: 'Number of Topics',
+                name: 'numberOfTopics',
+                type: 'number',
+                default: 10,
+                typeOptions: { minValue: 1, maxValue: 100 },
+                description: 'Approximate number of topics to generate (max 100)',
+                displayOptions: { show: { resource: ['video'], operation: ['topics'] } }
+            },
+            {
+                displayName: 'Locale',
+                name: 'locale',
+                type: 'string',
+                default: '',
+                placeholder: 'en-US',
+                description: 'Optional locale for the generated topics',
+                displayOptions: { show: { resource: ['video'], operation: ['topics'] } }
+            },
+            {
+                displayName: 'Content Type',
+                name: 'contentType',
+                type: 'options',
+                default: 'Custom',
+                description: 'Optional content type to bias the topics',
+                options: [
+                    { name: 'Custom', value: 'Custom' },
+                    { name: 'News', value: 'News' },
+                    { name: 'Quiz', value: 'Quiz' },
+                    { name: 'History', value: 'History' },
+                    { name: 'Scary', value: 'Scary' },
+                    { name: 'Motivational', value: 'Motivational' },
+                    { name: 'Bedtime', value: 'Bedtime' },
+                    { name: 'Fun Facts', value: 'FunFacts' },
+                    { name: 'Life Tips', value: 'LifeTips' },
+                    { name: 'ELI5', value: 'ELI5' },
+                    { name: 'Philosophy', value: 'Philosophy' },
+                    { name: 'Blog', value: 'Blog' },
+                    { name: 'Ad', value: 'Ad' }
+                ],
+                displayOptions: { show: { resource: ['video'], operation: ['topics'] } }
+            },
+            // Video: Create — connection IDs, title, caption + optional fields
+            {
+                displayName: 'Connection IDs',
+                name: 'connectionIds',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'uuid-1, uuid-2',
+                description: 'Comma-separated publishing connection IDs. Use the Connection: List operation to find them.',
+                displayOptions: { show: { resource: ['video'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Title',
+                name: 'title',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'The title of the video',
+                displayOptions: { show: { resource: ['video'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Caption',
+                name: 'caption',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'The description shown beside the video when posted to social media',
+                displayOptions: { show: { resource: ['video'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Scenes (JSON)',
+                name: 'scenes',
+                type: 'json',
+                default: '',
+                description: 'Optional array of scenes from a draft. Not required for Quiz videos.',
+                displayOptions: { show: { resource: ['video'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Content Type',
+                name: 'contentType',
+                type: 'options',
+                default: 'Custom',
+                options: [
+                    { name: 'Custom', value: 'Custom' },
+                    { name: 'News', value: 'News' },
+                    { name: 'Quiz', value: 'Quiz' },
+                    { name: 'History', value: 'History' },
+                    { name: 'Scary', value: 'Scary' },
+                    { name: 'Motivational', value: 'Motivational' },
+                    { name: 'Bedtime', value: 'Bedtime' },
+                    { name: 'Fun Facts', value: 'FunFacts' },
+                    { name: 'Life Tips', value: 'LifeTips' },
+                    { name: 'ELI5', value: 'ELI5' },
+                    { name: 'Philosophy', value: 'Philosophy' },
+                    { name: 'Blog', value: 'Blog' },
+                    { name: 'Ad', value: 'Ad' }
+                ],
+                displayOptions: { show: { resource: ['video'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Aspect Ratio',
+                name: 'aspectRatio',
+                type: 'options',
+                default: '9:16',
+                options: [
+                    { name: 'Vertical (9:16)', value: '9:16' },
+                    { name: 'Horizontal (16:9)', value: '16:9' },
+                    { name: 'Square (1:1)', value: '1:1' }
+                ],
+                displayOptions: { show: { resource: ['video'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Image Style ID',
+                name: 'imageStyleId',
+                type: 'string',
+                default: '',
+                description: 'Optional image style ID. Use the Image: List Styles operation to find them. Blank lets the AI choose.',
+                displayOptions: { show: { resource: ['video'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Voice ID',
+                name: 'voiceId',
+                type: 'string',
+                default: '',
+                description: 'Optional voice ID. Use the Voice: List operation to find them.',
+                displayOptions: { show: { resource: ['video'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Soundtrack ID',
+                name: 'soundtrackId',
+                type: 'string',
+                default: '',
+                description: 'Optional soundtrack ID. Use the Music: List Tracks operation to find them.',
+                displayOptions: { show: { resource: ['video'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Publish At',
+                name: 'publishAt',
+                type: 'string',
+                default: '',
+                placeholder: '2026-01-01T12:00:00Z',
+                description: 'Optional ISO 8601 timestamp to schedule publishing',
+                displayOptions: { show: { resource: ['video'], operation: ['create'] } }
+            },
+            // =====================================================================
+            // Series: Get — ID
+            // =====================================================================
+            {
+                displayName: 'Series ID',
+                name: 'seriesId',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'ShortGenius series ID',
+                displayOptions: { show: { resource: ['series'], operation: ['get'] } }
+            },
+            // Series: Create
+            {
+                displayName: 'Connection IDs',
+                name: 'connectionIds',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'uuid-1, uuid-2',
+                description: 'Comma-separated publishing connection IDs. Use the Connection: List operation to find them.',
+                displayOptions: { show: { resource: ['series'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Parent Topic',
+                name: 'parentTopic',
+                type: 'string',
+                default: '',
+                description: 'Optional theme for auto-generating episode topics',
+                displayOptions: { show: { resource: ['series'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Topics',
+                name: 'topics',
+                type: 'string',
+                default: '',
+                description: 'Optional comma-separated list of explicit episode topics',
+                displayOptions: { show: { resource: ['series'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Content Type',
+                name: 'contentType',
+                type: 'options',
+                default: 'Custom',
+                options: [
+                    { name: 'Custom', value: 'Custom' },
+                    { name: 'News', value: 'News' },
+                    { name: 'Quiz', value: 'Quiz' },
+                    { name: 'History', value: 'History' },
+                    { name: 'Scary', value: 'Scary' },
+                    { name: 'Motivational', value: 'Motivational' },
+                    { name: 'Bedtime', value: 'Bedtime' },
+                    { name: 'Fun Facts', value: 'FunFacts' },
+                    { name: 'Life Tips', value: 'LifeTips' },
+                    { name: 'ELI5', value: 'ELI5' },
+                    { name: 'Philosophy', value: 'Philosophy' },
+                    { name: 'Blog', value: 'Blog' },
+                    { name: 'Ad', value: 'Ad' }
+                ],
+                displayOptions: { show: { resource: ['series'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Aspect Ratio',
+                name: 'aspectRatio',
+                type: 'options',
+                default: '9:16',
+                options: [
+                    { name: 'Vertical (9:16)', value: '9:16' },
+                    { name: 'Horizontal (16:9)', value: '16:9' },
+                    { name: 'Square (1:1)', value: '1:1' }
+                ],
+                displayOptions: { show: { resource: ['series'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Duration (Seconds)',
+                name: 'duration',
+                type: 'options',
+                default: '60',
+                description: 'Desired length of each episode in seconds (best-effort)',
+                options: [
+                    { name: '60', value: '60' },
+                    { name: '90', value: '90' },
+                    { name: '120', value: '120' },
+                    { name: '180', value: '180' },
+                    { name: '240', value: '240' },
+                    { name: '300', value: '300' },
+                    { name: '360', value: '360' },
+                    { name: '420', value: '420' },
+                    { name: '480', value: '480' },
+                    { name: '540', value: '540' },
+                    { name: '600', value: '600' },
+                    { name: '660', value: '660' },
+                    { name: '720', value: '720' },
+                    { name: '780', value: '780' },
+                    { name: '840', value: '840' },
+                    { name: '900', value: '900' }
+                ],
+                displayOptions: { show: { resource: ['series'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Voice IDs',
+                name: 'voiceIds',
+                type: 'string',
+                default: '',
+                description: 'Optional comma-separated voice IDs to rotate through',
+                displayOptions: { show: { resource: ['series'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Schedule (JSON)',
+                name: 'schedule',
+                type: 'json',
+                default: '',
+                description: 'Optional posting schedule object',
+                displayOptions: { show: { resource: ['series'], operation: ['create'] } }
+            },
+            // =====================================================================
+            // Image: Get — ID
+            // =====================================================================
+            {
+                displayName: 'Image ID',
+                name: 'imageId',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'ShortGenius image ID',
+                displayOptions: { show: { resource: ['image'], operation: ['get'] } }
+            },
+            // Image: Create
+            {
+                displayName: 'Prompt',
+                name: 'prompt',
+                type: 'string',
+                typeOptions: { rows: 3 },
+                default: '',
+                required: true,
+                placeholder: 'A neon city skyline at dusk',
+                description: 'Text prompt describing the image to generate',
+                displayOptions: { show: { resource: ['image'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Aspect Ratio',
+                name: 'aspectRatio',
+                type: 'options',
+                default: '9:16',
+                required: true,
+                options: [
+                    { name: 'Vertical (9:16)', value: '9:16' },
+                    { name: 'Horizontal (16:9)', value: '16:9' },
+                    { name: 'Square (1:1)', value: '1:1' }
+                ],
+                displayOptions: { show: { resource: ['image'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Image Style ID',
+                name: 'imageStyleId',
+                type: 'string',
+                default: '',
+                description: 'Optional image style ID. Use the Image: List Styles operation to find them.',
+                displayOptions: { show: { resource: ['image'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Quality',
+                name: 'quality',
+                type: 'options',
+                default: 'high',
+                options: [
+                    { name: 'Low', value: 'low' },
+                    { name: 'Medium', value: 'medium' },
+                    { name: 'High', value: 'high' }
+                ],
+                description: 'Generation quality',
+                displayOptions: { show: { resource: ['image'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Wait for Generation',
+                name: 'waitForGeneration',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to block until the image finishes generating before returning',
+                displayOptions: { show: { resource: ['image'], operation: ['create'] } }
+            },
+            // =====================================================================
+            // Audio: Get — ID
+            // =====================================================================
+            {
+                displayName: 'Audio ID',
+                name: 'audioId',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'ShortGenius audio ID',
+                displayOptions: { show: { resource: ['audio'], operation: ['get'] } }
+            },
+            // Audio: Create Speech
+            {
+                displayName: 'Text',
+                name: 'text',
+                type: 'string',
+                typeOptions: { rows: 3 },
+                default: '',
+                required: true,
+                description: 'The text to synthesize into speech',
+                displayOptions: { show: { resource: ['audio'], operation: ['speech'] } }
+            },
+            {
+                displayName: 'Voice ID',
+                name: 'voiceId',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'Voice to narrate with. Use the Voice: List operation to find them.',
+                displayOptions: { show: { resource: ['audio'], operation: ['speech'] } }
+            },
+            {
+                displayName: 'Locale',
+                name: 'locale',
+                type: 'string',
+                default: '',
+                placeholder: 'en-US',
+                description: 'Optional locale for the speech',
+                displayOptions: { show: { resource: ['audio'], operation: ['speech'] } }
+            },
+            {
+                displayName: 'Wait for Generation',
+                name: 'waitForGeneration',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to block until the audio finishes generating before returning',
+                displayOptions: { show: { resource: ['audio'], operation: ['speech'] } }
+            },
+            // =====================================================================
+            // Voice: List filter + Get — ID
+            // =====================================================================
+            {
+                displayName: 'Locale',
+                name: 'locale',
+                type: 'string',
+                default: '',
+                placeholder: 'en-US',
+                description: 'Optional locale filter for the voices',
+                displayOptions: { show: { resource: ['voice'], operation: ['list'] } }
+            },
+            {
+                displayName: 'Voice ID',
+                name: 'voiceId',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'ShortGenius voice ID',
+                displayOptions: { show: { resource: ['voice'], operation: ['get'] } }
+            },
+            // =====================================================================
+            // Music: List Tracks — genre ID
+            // =====================================================================
+            {
+                displayName: 'Genre ID',
+                name: 'genreId',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'Music genre ID. Use the Music: List Genres operation to find them.',
+                displayOptions: { show: { resource: ['music'], operation: ['tracks'] } }
+            },
+            // =====================================================================
+            // Webhook: Create — url + events + description
+            // =====================================================================
+            {
+                displayName: 'Endpoint URL',
+                name: 'url',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'https://example.com/webhooks/shortgenius',
+                displayOptions: { show: { resource: ['webhook'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Events',
+                name: 'events',
+                type: 'multiOptions',
+                default: ['video.completed'],
+                options: [
+                    { name: 'Video Created', value: 'video.created' },
+                    { name: 'Video Completed', value: 'video.completed' },
+                    { name: 'Video Published', value: 'video.published' },
+                    { name: 'Series Created', value: 'series.created' },
+                    { name: 'Image Completed', value: 'image.completed' },
+                    { name: 'Audio Completed', value: 'audio.completed' },
+                    { name: 'All Events', value: '*' }
+                ],
+                required: true,
+                displayOptions: { show: { resource: ['webhook'], operation: ['create'] } }
+            },
+            {
+                displayName: 'Description',
+                name: 'description',
+                type: 'string',
+                default: '',
+                displayOptions: { show: { resource: ['webhook'], operation: ['create'] } }
+            },
+            // Webhook: Delete — endpoint ID
+            {
+                displayName: 'Endpoint ID',
+                name: 'endpointId',
+                type: 'string',
+                default: '',
+                required: true,
+                displayOptions: { show: { resource: ['webhook'], operation: ['delete'] } }
+            }
+        ]
+    };
+    async execute() {
+        const credentials = await this.getCredentials('shortGeniusApi');
+        const client = new vendor_1.ShortGenius({
+            apiKey: credentials.apiKey,
+            baseUrl: credentials.baseUrl || undefined
+        });
+        // Split a comma-separated string field into a trimmed, non-empty array.
+        const splitCsv = (raw) => raw
+            .split(',')
+            .map(s => s.trim())
+            .filter(Boolean);
+        // Parse an n8n `json` field that may be a parsed value or a raw string.
+        const parseJson = (raw) => {
+            if (typeof raw !== 'string')
+                return raw;
+            const trimmed = raw.trim();
+            return trimmed ? JSON.parse(trimmed) : undefined;
+        };
+        const items = this.getInputData();
+        const out = [];
+        for (let i = 0; i < items.length; i++) {
+            const resource = this.getNodeParameter('resource', i);
+            const operation = this.getNodeParameter('operation', i);
+            try {
+                let result;
+                if (resource === 'video') {
+                    if (operation === 'list') {
+                        const page = this.getNodeParameter('page', i, 0);
+                        const limit = this.getNodeParameter('limit', i, 20);
+                        result = await client.videos.list({ page, limit });
+                    }
+                    else if (operation === 'get') {
+                        const videoId = this.getNodeParameter('videoId', i);
+                        result = await client.videos.get(videoId);
+                    }
+                    else if (operation === 'draft') {
+                        const topic = this.getNodeParameter('topic', i);
+                        const duration = this.getNodeParameter('duration', i);
+                        const locale = this.getNodeParameter('locale', i, '');
+                        result = await client.videos.draft({ topic, duration, locale: locale || undefined });
+                    }
+                    else if (operation === 'draftUrl') {
+                        const url = this.getNodeParameter('url', i);
+                        const prompt = this.getNodeParameter('prompt', i, '');
+                        const locale = this.getNodeParameter('locale', i, '');
+                        result = await client.videos.draftFromUrl({ url, prompt: prompt || undefined, locale: locale || undefined });
+                    }
+                    else if (operation === 'draftScript') {
+                        const script = this.getNodeParameter('script', i);
+                        result = await client.videos.draftFromScript({ script });
+                    }
+                    else if (operation === 'draftQuiz') {
+                        const topic = this.getNodeParameter('topic', i);
+                        const locale = this.getNodeParameter('locale', i, '');
+                        result = await client.videos.draftQuiz({ topic, locale: locale || undefined });
+                    }
+                    else if (operation === 'draftNews') {
+                        const topic = this.getNodeParameter('topic', i);
+                        const locale = this.getNodeParameter('locale', i, '');
+                        result = await client.videos.draftNews({ topic, locale: locale || undefined });
+                    }
+                    else if (operation === 'topics') {
+                        const parentTopic = this.getNodeParameter('parentTopic', i, '');
+                        const numberOfTopics = this.getNodeParameter('numberOfTopics', i, 10);
+                        const locale = this.getNodeParameter('locale', i, '');
+                        const contentType = this.getNodeParameter('contentType', i, 'Custom');
+                        result = await client.videos.generateTopics({
+                            parent_topic: parentTopic || undefined,
+                            number_of_topics: numberOfTopics || undefined,
+                            locale: locale || undefined,
+                            content_type: contentType || undefined
+                        });
+                    }
+                    else if (operation === 'create') {
+                        const connectionIds = splitCsv(this.getNodeParameter('connectionIds', i, ''));
+                        const title = this.getNodeParameter('title', i);
+                        const caption = this.getNodeParameter('caption', i);
+                        const scenes = parseJson(this.getNodeParameter('scenes', i, ''));
+                        const contentType = this.getNodeParameter('contentType', i, 'Custom');
+                        const aspectRatio = this.getNodeParameter('aspectRatio', i, '9:16');
+                        const imageStyleId = this.getNodeParameter('imageStyleId', i, '');
+                        const voiceId = this.getNodeParameter('voiceId', i, '');
+                        const soundtrackId = this.getNodeParameter('soundtrackId', i, '');
+                        const publishAt = this.getNodeParameter('publishAt', i, '');
+                        result = await client.videos.create({
+                            connection_ids: connectionIds,
+                            title,
+                            caption,
+                            scenes,
+                            content_type: contentType || undefined,
+                            aspect_ratio: aspectRatio || undefined,
+                            image_style_id: imageStyleId || undefined,
+                            voice_id: voiceId || undefined,
+                            soundtrack_id: soundtrackId || undefined,
+                            publish_at: publishAt || undefined
+                        });
+                    }
+                }
+                else if (resource === 'series') {
+                    if (operation === 'list') {
+                        const page = this.getNodeParameter('page', i, 0);
+                        const limit = this.getNodeParameter('limit', i, 20);
+                        result = await client.series.list({ page, limit });
+                    }
+                    else if (operation === 'get') {
+                        const seriesId = this.getNodeParameter('seriesId', i);
+                        result = await client.series.get(seriesId);
+                    }
+                    else if (operation === 'create') {
+                        const connectionIds = splitCsv(this.getNodeParameter('connectionIds', i, ''));
+                        const parentTopic = this.getNodeParameter('parentTopic', i, '');
+                        const topicsCsv = splitCsv(this.getNodeParameter('topics', i, ''));
+                        const contentType = this.getNodeParameter('contentType', i, 'Custom');
+                        const aspectRatio = this.getNodeParameter('aspectRatio', i, '9:16');
+                        const duration = this.getNodeParameter('duration', i, '60');
+                        const voiceIds = splitCsv(this.getNodeParameter('voiceIds', i, ''));
+                        const schedule = parseJson(this.getNodeParameter('schedule', i, ''));
+                        result = await client.series.create({
+                            connection_ids: connectionIds,
+                            parent_topic: parentTopic || undefined,
+                            // /series expects topics as objects ({ topic }) and duration as a number.
+                            topics: topicsCsv.length > 0 ? topicsCsv.map(topic => ({ topic })) : undefined,
+                            content_type: contentType || undefined,
+                            aspect_ratio: aspectRatio || undefined,
+                            duration: duration ? Number(duration) : undefined,
+                            voice_ids: voiceIds.length > 0 ? voiceIds : undefined,
+                            schedule: schedule || undefined
+                        });
+                    }
+                }
+                else if (resource === 'image') {
+                    if (operation === 'list') {
+                        const page = this.getNodeParameter('page', i, 0);
+                        const limit = this.getNodeParameter('limit', i, 20);
+                        result = await client.images.list({ page, limit });
+                    }
+                    else if (operation === 'get') {
+                        const imageId = this.getNodeParameter('imageId', i);
+                        result = await client.images.get(imageId);
+                    }
+                    else if (operation === 'styles') {
+                        result = await client.images.styles();
+                    }
+                    else if (operation === 'create') {
+                        const prompt = this.getNodeParameter('prompt', i);
+                        const aspectRatio = this.getNodeParameter('aspectRatio', i);
+                        const imageStyleId = this.getNodeParameter('imageStyleId', i, '');
+                        const quality = this.getNodeParameter('quality', i, 'high');
+                        const waitForGeneration = this.getNodeParameter('waitForGeneration', i, false);
+                        result = await client.images.create({
+                            prompt,
+                            aspect_ratio: aspectRatio,
+                            image_style_id: imageStyleId || undefined,
+                            quality: quality || undefined,
+                            wait_for_generation: waitForGeneration || undefined
+                        });
+                    }
+                }
+                else if (resource === 'audio') {
+                    if (operation === 'list') {
+                        const page = this.getNodeParameter('page', i, 0);
+                        const limit = this.getNodeParameter('limit', i, 20);
+                        result = await client.audio.list({ page, limit });
+                    }
+                    else if (operation === 'get') {
+                        const audioId = this.getNodeParameter('audioId', i);
+                        result = await client.audio.get(audioId);
+                    }
+                    else if (operation === 'speech') {
+                        const text = this.getNodeParameter('text', i);
+                        const voiceId = this.getNodeParameter('voiceId', i);
+                        const locale = this.getNodeParameter('locale', i, '');
+                        const waitForGeneration = this.getNodeParameter('waitForGeneration', i, false);
+                        result = await client.audio.createSpeech({
+                            text,
+                            voice_id: voiceId,
+                            locale: locale || undefined,
+                            wait_for_generation: waitForGeneration || undefined
+                        });
+                    }
+                }
+                else if (resource === 'voice') {
+                    if (operation === 'list') {
+                        const locale = this.getNodeParameter('locale', i, '');
+                        const page = this.getNodeParameter('page', i, 0);
+                        const limit = this.getNodeParameter('limit', i, 20);
+                        result = await client.audio.voices({ locale: locale || undefined, page, limit });
+                    }
+                    else if (operation === 'get') {
+                        const voiceId = this.getNodeParameter('voiceId', i);
+                        result = await client.audio.voice(voiceId);
+                    }
+                }
+                else if (resource === 'music') {
+                    if (operation === 'genres') {
+                        result = await client.music.genres();
+                    }
+                    else if (operation === 'tracks') {
+                        const genreId = this.getNodeParameter('genreId', i);
+                        result = await client.music.tracks(genreId);
+                    }
+                }
+                else if (resource === 'connection') {
+                    if (operation === 'list') {
+                        result = await client.connections.list();
+                    }
+                }
+                else if (resource === 'credits') {
+                    if (operation === 'get') {
+                        result = await client.credits.get();
+                    }
+                }
+                else if (resource === 'webhook') {
+                    if (operation === 'list') {
+                        result = await client.webhooks.listEndpoints();
+                    }
+                    else if (operation === 'create') {
+                        const url = this.getNodeParameter('url', i);
+                        const events = this.getNodeParameter('events', i);
+                        const description = this.getNodeParameter('description', i, '');
+                        result = await client.webhooks.createEndpoint({
+                            url,
+                            events,
+                            description: description || undefined
+                        });
+                    }
+                    else if (operation === 'delete') {
+                        const endpointId = this.getNodeParameter('endpointId', i);
+                        await client.webhooks.deleteEndpoint(endpointId);
+                        result = { ok: true, deleted: endpointId };
+                    }
+                }
+                if (result === undefined) {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unsupported resource/operation combination: ${resource}.${operation}`, { itemIndex: i });
+                }
+                // n8n expects each output item to be wrapped in { json: ... }.
+                // Array-returning operations (and the paginated { videos } / { series }
+                // / { images } / { audio } envelopes) are split into one item per row so
+                // downstream nodes can iterate naturally. Cast through unknown because
+                // n8n's IDataObject is stricter than Record<string, unknown> — upstream
+                // SDK return types are intentionally loose.
+                const push = (row) => {
+                    out.push({ json: row, pairedItem: { item: i } });
+                };
+                const envelopeKey = ['videos', 'series', 'images', 'audio'].find(k => result && typeof result === 'object' && Array.isArray(result[k]));
+                if (Array.isArray(result)) {
+                    for (const row of result)
+                        push(row);
+                }
+                else if (envelopeKey) {
+                    for (const row of result[envelopeKey])
+                        push(row);
+                }
+                else {
+                    push(result);
+                }
+            }
+            catch (err) {
+                const message = err instanceof vendor_1.ShortGeniusError
+                    ? err.detail || err.message
+                    : err instanceof Error
+                        ? err.message
+                        : String(err);
+                // Per-item Continue On Fail: emit the error as this item's output and
+                // keep going, so prior items' results survive and later items still run.
+                if (this.continueOnFail()) {
+                    out.push({
+                        json: { error: message, ...(err instanceof vendor_1.ShortGeniusError ? { status: err.status } : {}) },
+                        pairedItem: { item: i }
+                    });
+                    continue;
+                }
+                if (err instanceof vendor_1.ShortGeniusError) {
+                    // Vendored SDK HTTP error → n8n's convention is NodeApiError. Extract
+                    // the error fields into a JsonObject so workflow branches can read
+                    // status / message / request_id.
+                    throw new n8n_workflow_1.NodeApiError(this.getNode(), {
+                        status: err.status,
+                        message: err.detail || err.message,
+                        request_id: err.requestId
+                    }, {
+                        itemIndex: i,
+                        message,
+                        httpCode: err.status ? String(err.status) : undefined,
+                        description: `HTTP ${err.status}${err.requestId ? ` (request ${err.requestId})` : ''}`
+                    });
+                }
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), err, { itemIndex: i });
+            }
+        }
+        return [out];
+    }
+}
+exports.ShortGenius = ShortGenius;