n8n-nodes-preroll 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Trevor O'Hare
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+# n8n-nodes-preroll
+
+n8n community node for [PreRoll](https://preroll.io) — podcast production management.
+
+Interact with your PreRoll instance from n8n workflows: manage clients, shows, episodes, deliverables, tags, and AI features. Includes a trigger node for real-time webhook events.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
+
+**npm package name:** `n8n-nodes-preroll`
+
+## Credentials
+
+You need a PreRoll API key to authenticate:
+
+1. Log in to your PreRoll instance
+2. Go to **Settings → API Keys**
+3. Click **Create API Key** and copy the key (starts with `pr_`)
+4. In n8n, create a new **PreRoll API** credential with your API key and base URL
+
+> API keys require a Pro or Studio plan.
+
+## Nodes
+
+### PreRoll
+
+The main node supports these resources and operations:
+
+| Resource | Operations |
+|----------|-----------|
+| **Client** | Get, Get Many, Create, Update, Delete |
+| **Show** | Get, Get Many, Create, Update, Delete |
+| **Episode** | Get, Get Many, Create, Update, Delete |
+| **Deliverable** | Get, Get Many, Create, Update |
+| **Tag** | Get Many, Create, Update, Delete |
+| **Meeting Note** | Get Many, Create |
+| **Pipeline Stage** | Get Many |
+| **Activity** | Get Many |
+| **AI** | Get Credits, Get Transcription, Transcribe Episode, Generate Content, Run Pipeline |
+| **Dashboard** | Get Overview |
+
+### PreRoll Trigger
+
+Webhook-based trigger that starts workflows when events occur in PreRoll:
+
+- `episode.status_changed` — Episode status updated
+- `episode.stage_changed` — Episode moved to a different pipeline stage
+- `episode.published` — Episode published
+- `episode.scheduled` — Episode scheduled for publishing
+- `deliverable.submitted` — New deliverable submitted for review
+- `deliverable.approved` — Deliverable approved by client
+- `deliverable.revision_requested` — Client requested revisions on a deliverable
+- `deliverable.resubmitted` — Deliverable resubmitted after revision
+
+The trigger node automatically registers and deregisters webhook endpoints in PreRoll when the workflow is activated/deactivated.
+
+## Example Workflows
+
+### Notify Slack when an episode is published
+
+1. Add a **PreRoll Trigger** node with event `episode.published`
+2. Connect to a **Slack** node to post a message
+
+### Auto-transcribe new episodes
+
+1. Add a **PreRoll Trigger** node with event `episode.stage_changed`
+2. Add an **IF** node to check if the new stage is "Editing"
+3. Connect to a **PreRoll** node → AI → Transcribe Episode
+
+### Weekly episode report
+
+1. Add a **Schedule Trigger** (every Monday)
+2. Connect to a **PreRoll** node → Dashboard → Get Overview
+3. Connect to an **Email** node to send the summary
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Link for local testing
+npm link
+cd ~/.n8n/custom
+npm link n8n-nodes-preroll
+```
+
+## License
+
+MIT

package/dist/credentials/PreRollApi.credentials.d.ts

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

package/dist/credentials/PreRollApi.credentials.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreRollApi = void 0;
+class PreRollApi {
+    constructor() {
+        this.name = 'preRollApi';
+        this.displayName = 'PreRoll API';
+        this.documentationUrl = 'https://preroll.io/docs/api';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                placeholder: 'pr_...',
+                description: 'API key from PreRoll Settings → API Keys',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://api.preroll.io',
+                description: 'Base URL of your PreRoll instance',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/api/v1/dashboard',
+            },
+        };
+    }
+}
+exports.PreRollApi = PreRollApi;

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

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

package/dist/nodes/PreRoll/PreRoll.node.js

@@ -0,0 +1,340 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreRoll = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const ClientDescription_1 = require("./resources/ClientDescription");
+const ShowDescription_1 = require("./resources/ShowDescription");
+const EpisodeDescription_1 = require("./resources/EpisodeDescription");
+const DeliverableDescription_1 = require("./resources/DeliverableDescription");
+const TagDescription_1 = require("./resources/TagDescription");
+const MeetingNoteDescription_1 = require("./resources/MeetingNoteDescription");
+const PipelineStageDescription_1 = require("./resources/PipelineStageDescription");
+const ActivityDescription_1 = require("./resources/ActivityDescription");
+const AiDescription_1 = require("./resources/AiDescription");
+const DashboardDescription_1 = require("./resources/DashboardDescription");
+class PreRoll {
+    constructor() {
+        this.description = {
+            displayName: 'PreRoll',
+            name: 'preRoll',
+            icon: 'file:preroll.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Interact with PreRoll — podcast production management',
+            defaults: {
+                name: 'PreRoll',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'preRollApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        { name: 'Activity', value: 'activity' },
+                        { name: 'AI', value: 'ai' },
+                        { name: 'Client', value: 'client' },
+                        { name: 'Dashboard', value: 'dashboard' },
+                        { name: 'Deliverable', value: 'deliverable' },
+                        { name: 'Episode', value: 'episode' },
+                        { name: 'Meeting Note', value: 'meetingNote' },
+                        { name: 'Pipeline Stage', value: 'pipelineStage' },
+                        { name: 'Show', value: 'show' },
+                        { name: 'Tag', value: 'tag' },
+                    ],
+                    default: 'episode',
+                },
+                ...ClientDescription_1.clientOperations,
+                ...ClientDescription_1.clientFields,
+                ...ShowDescription_1.showOperations,
+                ...ShowDescription_1.showFields,
+                ...EpisodeDescription_1.episodeOperations,
+                ...EpisodeDescription_1.episodeFields,
+                ...DeliverableDescription_1.deliverableOperations,
+                ...DeliverableDescription_1.deliverableFields,
+                ...TagDescription_1.tagOperations,
+                ...TagDescription_1.tagFields,
+                ...MeetingNoteDescription_1.meetingNoteOperations,
+                ...MeetingNoteDescription_1.meetingNoteFields,
+                ...PipelineStageDescription_1.pipelineStageOperations,
+                ...PipelineStageDescription_1.pipelineStageFields,
+                ...ActivityDescription_1.activityOperations,
+                ...ActivityDescription_1.activityFields,
+                ...AiDescription_1.aiOperations,
+                ...AiDescription_1.aiFields,
+                ...DashboardDescription_1.dashboardOperations,
+                ...DashboardDescription_1.dashboardFields,
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const resource = this.getNodeParameter('resource', 0);
+        const operation = this.getNodeParameter('operation', 0);
+        const credentials = await this.getCredentials('preRollApi');
+        const baseUrl = credentials.baseUrl.replace(/\/$/, '');
+        for (let i = 0; i < items.length; i++) {
+            try {
+                let responseData;
+                // ────────── Client ──────────
+                if (resource === 'client') {
+                    if (operation === 'getAll') {
+                        responseData = await apiRequest.call(this, 'GET', baseUrl, '/clients');
+                    }
+                    else if (operation === 'get') {
+                        const id = this.getNodeParameter('clientId', i);
+                        responseData = await apiRequest.call(this, 'GET', baseUrl, `/clients/${id}`);
+                    }
+                    else if (operation === 'create') {
+                        const name = this.getNodeParameter('name', i);
+                        const additional = this.getNodeParameter('additionalFields', i);
+                        responseData = await apiRequest.call(this, 'POST', baseUrl, '/clients', { name, ...additional });
+                    }
+                    else if (operation === 'update') {
+                        const id = this.getNodeParameter('clientId', i);
+                        const fields = this.getNodeParameter('updateFields', i);
+                        responseData = await apiRequest.call(this, 'PATCH', baseUrl, `/clients/${id}`, fields);
+                    }
+                    else if (operation === 'delete') {
+                        const id = this.getNodeParameter('clientId', i);
+                        await apiRequest.call(this, 'DELETE', baseUrl, `/clients/${id}`);
+                        responseData = { success: true };
+                    }
+                    else {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown operation: ${operation}`);
+                    }
+                    // ────────── Show ──────────
+                }
+                else if (resource === 'show') {
+                    if (operation === 'getAll') {
+                        const clientId = this.getNodeParameter('clientId', i);
+                        const qs = clientId ? `?client_id=${clientId}` : '';
+                        responseData = await apiRequest.call(this, 'GET', baseUrl, `/shows${qs}`);
+                    }
+                    else if (operation === 'get') {
+                        const id = this.getNodeParameter('showId', i);
+                        responseData = await apiRequest.call(this, 'GET', baseUrl, `/shows/${id}`);
+                    }
+                    else if (operation === 'create') {
+                        const clientId = this.getNodeParameter('clientId', i);
+                        const name = this.getNodeParameter('name', i);
+                        const additional = this.getNodeParameter('additionalFields', i);
+                        responseData = await apiRequest.call(this, 'POST', baseUrl, '/shows', { client_id: clientId, name, ...additional });
+                    }
+                    else if (operation === 'update') {
+                        const id = this.getNodeParameter('showId', i);
+                        const fields = this.getNodeParameter('updateFields', i);
+                        responseData = await apiRequest.call(this, 'PATCH', baseUrl, `/shows/${id}`, fields);
+                    }
+                    else if (operation === 'delete') {
+                        const id = this.getNodeParameter('showId', i);
+                        await apiRequest.call(this, 'DELETE', baseUrl, `/shows/${id}`);
+                        responseData = { success: true };
+                    }
+                    else {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown operation: ${operation}`);
+                    }
+                    // ────────── Episode ──────────
+                }
+                else if (resource === 'episode') {
+                    if (operation === 'getAll') {
+                        const filters = this.getNodeParameter('filters', i);
+                        const params = new URLSearchParams();
+                        for (const [key, val] of Object.entries(filters)) {
+                            if (val !== '' && val !== undefined && val !== false)
+                                params.set(key, String(val));
+                        }
+                        const qs = params.toString() ? `?${params}` : '';
+                        responseData = await apiRequest.call(this, 'GET', baseUrl, `/episodes${qs}`);
+                    }
+                    else if (operation === 'get') {
+                        const showId = this.getNodeParameter('showId', i);
+                        const episodeId = this.getNodeParameter('episodeId', i);
+                        responseData = await apiRequest.call(this, 'GET', baseUrl, `/shows/${showId}/episodes/${episodeId}`);
+                    }
+                    else if (operation === 'create') {
+                        const showId = this.getNodeParameter('showId', i);
+                        const title = this.getNodeParameter('title', i);
+                        const additional = this.getNodeParameter('additionalFields', i);
+                        responseData = await apiRequest.call(this, 'POST', baseUrl, `/shows/${showId}/episodes`, { title, ...additional });
+                    }
+                    else if (operation === 'update') {
+                        const showId = this.getNodeParameter('showId', i);
+                        const episodeId = this.getNodeParameter('episodeId', i);
+                        const fields = this.getNodeParameter('updateFields', i);
+                        responseData = await apiRequest.call(this, 'PATCH', baseUrl, `/shows/${showId}/episodes/${episodeId}`, fields);
+                    }
+                    else if (operation === 'delete') {
+                        const showId = this.getNodeParameter('showId', i);
+                        const episodeId = this.getNodeParameter('episodeId', i);
+                        await apiRequest.call(this, 'DELETE', baseUrl, `/shows/${showId}/episodes/${episodeId}`);
+                        responseData = { success: true };
+                    }
+                    else {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown operation: ${operation}`);
+                    }
+                    // ────────── Deliverable ──────────
+                }
+                else if (resource === 'deliverable') {
+                    if (operation === 'getAll') {
+                        const filters = this.getNodeParameter('filters', i);
+                        const params = new URLSearchParams();
+                        for (const [key, val] of Object.entries(filters)) {
+                            if (val !== '' && val !== undefined)
+                                params.set(key, String(val));
+                        }
+                        const qs = params.toString() ? `?${params}` : '';
+                        responseData = await apiRequest.call(this, 'GET', baseUrl, `/deliverables${qs}`);
+                    }
+                    else if (operation === 'get') {
+                        const id = this.getNodeParameter('deliverableId', i);
+                        responseData = await apiRequest.call(this, 'GET', baseUrl, `/deliverables/${id}`);
+                    }
+                    else if (operation === 'create') {
+                        const showId = this.getNodeParameter('showId', i);
+                        const title = this.getNodeParameter('title', i);
+                        const additional = this.getNodeParameter('additionalFields', i);
+                        responseData = await apiRequest.call(this, 'POST', baseUrl, '/deliverables', { show_id: showId, title, ...additional });
+                    }
+                    else if (operation === 'update') {
+                        const id = this.getNodeParameter('deliverableId', i);
+                        const fields = this.getNodeParameter('updateFields', i);
+                        responseData = await apiRequest.call(this, 'PATCH', baseUrl, `/deliverables/${id}`, fields);
+                    }
+                    else {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown operation: ${operation}`);
+                    }
+                    // ────────── Tag ──────────
+                }
+                else if (resource === 'tag') {
+                    if (operation === 'getAll') {
+                        responseData = await apiRequest.call(this, 'GET', baseUrl, '/tags');
+                    }
+                    else if (operation === 'create') {
+                        const name = this.getNodeParameter('name', i);
+                        const color = this.getNodeParameter('color', i);
+                        responseData = await apiRequest.call(this, 'POST', baseUrl, '/tags', { name, color });
+                    }
+                    else if (operation === 'update') {
+                        const id = this.getNodeParameter('tagId', i);
+                        const fields = this.getNodeParameter('updateFields', i);
+                        responseData = await apiRequest.call(this, 'PATCH', baseUrl, `/tags/${id}`, fields);
+                    }
+                    else if (operation === 'delete') {
+                        const id = this.getNodeParameter('tagId', i);
+                        await apiRequest.call(this, 'DELETE', baseUrl, `/tags/${id}`);
+                        responseData = { success: true };
+                    }
+                    else {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown operation: ${operation}`);
+                    }
+                    // ────────── Meeting Note ──────────
+                }
+                else if (resource === 'meetingNote') {
+                    const clientId = this.getNodeParameter('clientId', i);
+                    if (operation === 'getAll') {
+                        responseData = await apiRequest.call(this, 'GET', baseUrl, `/clients/${clientId}/notes`);
+                    }
+                    else if (operation === 'create') {
+                        const content = this.getNodeParameter('content', i);
+                        const additional = this.getNodeParameter('additionalFields', i);
+                        responseData = await apiRequest.call(this, 'POST', baseUrl, `/clients/${clientId}/notes`, { content, ...additional });
+                    }
+                    else {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown operation: ${operation}`);
+                    }
+                    // ────────── Pipeline Stage ──────────
+                }
+                else if (resource === 'pipelineStage') {
+                    const showId = this.getNodeParameter('showId', i);
+                    responseData = await apiRequest.call(this, 'GET', baseUrl, `/shows/${showId}/stages`);
+                    // ────────── Activity ──────────
+                }
+                else if (resource === 'activity') {
+                    const showId = this.getNodeParameter('showId', i);
+                    const limit = this.getNodeParameter('limit', i);
+                    responseData = await apiRequest.call(this, 'GET', baseUrl, `/activity?show_id=${showId}&limit=${limit}`);
+                    // ────────── AI ──────────
+                }
+                else if (resource === 'ai') {
+                    if (operation === 'getCredits') {
+                        responseData = await apiRequest.call(this, 'GET', baseUrl, '/ai/credits');
+                    }
+                    else if (operation === 'getTranscription') {
+                        const episodeId = this.getNodeParameter('episodeId', i);
+                        responseData = await apiRequest.call(this, 'GET', baseUrl, `/episodes/${episodeId}/transcription`);
+                    }
+                    else if (operation === 'transcribe') {
+                        const episodeId = this.getNodeParameter('episodeId', i);
+                        const audioUrl = this.getNodeParameter('audioUrl', i);
+                        responseData = await apiRequest.call(this, 'POST', baseUrl, `/episodes/${episodeId}/transcribe`, {
+                            source_type: 'url',
+                            audio_url: audioUrl,
+                        });
+                    }
+                    else if (operation === 'generate') {
+                        const episodeId = this.getNodeParameter('episodeId', i);
+                        const generationType = this.getNodeParameter('generationType', i);
+                        const options = this.getNodeParameter('generateOptions', i);
+                        responseData = await apiRequest.call(this, 'POST', baseUrl, `/episodes/${episodeId}/generate`, {
+                            type: generationType,
+                            ...options,
+                        });
+                    }
+                    else if (operation === 'runPipeline') {
+                        const showId = this.getNodeParameter('showId', i);
+                        const episodeId = this.getNodeParameter('episodeId', i);
+                        responseData = await apiRequest.call(this, 'POST', baseUrl, `/shows/${showId}/episodes/${episodeId}/pipeline`, {});
+                    }
+                    else {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown operation: ${operation}`);
+                    }
+                    // ────────── Dashboard ──────────
+                }
+                else if (resource === 'dashboard') {
+                    responseData = await apiRequest.call(this, 'GET', baseUrl, '/dashboard');
+                }
+                else {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown resource: ${resource}`);
+                }
+                const executionData = this.helpers.constructExecutionMetaData(this.helpers.returnJsonArray(responseData), { itemData: { item: i } });
+                returnData.push(...executionData);
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    const executionData = this.helpers.constructExecutionMetaData(this.helpers.returnJsonArray({ error: error.message }), { itemData: { item: i } });
+                    returnData.push(...executionData);
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return [returnData];
+    }
+}
+exports.PreRoll = PreRoll;
+async function apiRequest(method, baseUrl, path, body) {
+    const options = {
+        method: method,
+        url: `${baseUrl}/api/v1${path}`,
+        json: true,
+    };
+    if (body && Object.keys(body).length > 0) {
+        options.body = body;
+    }
+    const response = await this.helpers.httpRequestWithAuthentication.call(this, 'preRollApi', options);
+    if (method === 'DELETE') {
+        return { success: true };
+    }
+    return (response.data ?? response);
+}

package/dist/nodes/PreRoll/PreRollTrigger.node.d.ts

@@ -0,0 +1,12 @@
+import { IHookFunctions, INodeType, INodeTypeDescription, IWebhookFunctions, IWebhookResponseData } from 'n8n-workflow';
+export declare class PreRollTrigger implements INodeType {
+    description: INodeTypeDescription;
+    webhookMethods: {
+        default: {
+            checkExists(this: IHookFunctions): Promise<boolean>;
+            create(this: IHookFunctions): Promise<boolean>;
+            delete(this: IHookFunctions): Promise<boolean>;
+        };
+    };
+    webhook(this: IWebhookFunctions): Promise<IWebhookResponseData>;
+}