Files
n8n-nodes-wizpixel-flow/nodes/WizPixelFlow/WizPixelFlow.node.ts
Niko e7c692426b Update nodes/WizPixelFlow/WizPixelFlow.node.ts
feat: add job_type field, align jobs.php URL, expand terminal statuses v0.1.1
2026-03-08 19:33:15 +00:00

260 lines
9.3 KiB
TypeScript

import {
IDataObject,
IExecuteFunctions,
INodeExecutionData,
INodeType,
INodeTypeDescription,
NodeOperationError,
} from 'n8n-workflow';
const OUTPUT_FORMATS = [
{ name: 'Leaderboard 728x90', value: 'leaderboard_728x90' },
{ name: 'Medium Rectangle 300x250', value: 'medium_rectangle_300x250' },
{ name: 'Half Page 300x600', value: 'half_page_300x600' },
{ name: 'Large Rectangle 336x280', value: 'large_rectangle_336x280' },
{ name: 'Billboard 970x250', value: 'billboard_970x250' },
{ name: 'Wide Skyscraper 160x600', value: 'wide_skyscraper_160x600' },
{ name: 'Skyscraper 120x600', value: 'skyscraper_120x600' },
{ name: 'Small Rectangle 300x100', value: 'small_rectangle_300x100' },
{ name: 'Square 250x250', value: 'square_250x250' },
{ name: 'Small Square 200x200', value: 'small_square_200x200' },
{ name: 'Banner 468x60', value: 'banner_468x60' },
{ name: 'Half Banner 234x60', value: 'half_banner_234x60' },
{ name: 'Micro Bar 88x31', value: 'micro_bar_88x31' },
{ name: 'Square Post 1080x1080', value: 'square_post_1080x1080' },
{ name: 'Portrait Post 1080x1350', value: 'portrait_post_1080x1350' },
{ name: 'Stories 1080x1920', value: 'stories_1080x1920' },
{ name: 'Shorts 1080x1920', value: 'shorts_1080x1920' },
{ name: 'Landscape 1280x720', value: 'landscape_1280x720' },
{ name: 'LinkedIn Banner 1584x396', value: 'linkedin_banner_1584x396' },
{ name: 'LinkedIn Square 1200x1200', value: 'linkedin_square_1200x1200' },
{ name: 'Twitter Card 1200x628', value: 'twitter_card_1200x628' },
{ name: 'Twitter Square 1080x1080', value: 'twitter_square_1080x1080' },
];
const TERMINAL_STATUSES = ['done', 'failed', 'complete', 'error'];
export class WizPixelFlow implements INodeType {
description: INodeTypeDescription = {
displayName: 'WizPixel Flow',
name: 'wizPixelFlow',
icon: 'file:wizpixel-flow.svg',
group: ['transform'],
version: 1,
subtitle: '={{$parameter["operation"]}}',
description: 'Render HTML5 banners and MP4 videos with WizPixel Flow',
defaults: { name: 'WizPixel Flow' },
inputs: ['main'],
outputs: ['main'],
credentials: [{ name: 'wizPixelFlowApi', required: true }],
properties: [
{
displayName: 'Operation',
name: 'operation',
type: 'options',
noDataExpression: true,
options: [
{ name: 'Render', value: 'render', description: 'Submit a render job' },
{ name: 'Get Job', value: 'getJob', description: 'Get status of a render job' },
{ name: 'List Templates', value: 'listTemplates', description: 'List available templates' },
],
default: 'render',
},
{
displayName: 'Template ID',
name: 'templateId',
type: 'string',
default: '',
required: true,
displayOptions: { show: { operation: ['render'] } },
description: 'UID of the Flow template to render',
},
{
displayName: 'Job Type',
name: 'jobType',
type: 'options',
options: [
{ name: 'Banner (HTML5)', value: 'banner' },
{ name: 'Video (MP4)', value: 'video' },
],
default: 'banner',
required: true,
displayOptions: { show: { operation: ['render'] } },
description: 'Render HTML5 banners or MP4 videos (different credit pools)',
},
{
displayName: 'Output Formats',
name: 'outputFormats',
type: 'multiOptions',
options: OUTPUT_FORMATS,
default: ['leaderboard_728x90', 'medium_rectangle_300x250'],
required: true,
displayOptions: { show: { operation: ['render'] } },
},
{
displayName: 'Locales',
name: 'locales',
type: 'string',
default: 'en',
displayOptions: { show: { operation: ['render'] } },
description: 'Comma-separated locale codes, e.g. en,it,fr',
},
{
displayName: 'Variables (JSON)',
name: 'variables',
type: 'json',
default: '{}',
displayOptions: { show: { operation: ['render'] } },
description: 'Key/value pairs for {{variable}} substitution',
},
{
displayName: 'Wait for Completion',
name: 'waitForCompletion',
type: 'boolean',
default: true,
displayOptions: { show: { operation: ['render'] } },
description: 'Poll until done and return ZIP download URL',
},
{
displayName: 'Poll Interval (seconds)',
name: 'pollInterval',
type: 'number',
default: 5,
displayOptions: { show: { operation: ['render'], waitForCompletion: [true] } },
},
{
displayName: 'Max Wait (seconds)',
name: 'maxWait',
type: 'number',
default: 300,
displayOptions: { show: { operation: ['render'], waitForCompletion: [true] } },
},
{
displayName: 'Job ID',
name: 'jobId',
type: 'string',
default: '',
required: true,
displayOptions: { show: { operation: ['getJob'] } },
},
{
displayName: 'Limit',
name: 'limit',
type: 'number',
default: 50,
typeOptions: { minValue: 1, maxValue: 200 },
displayOptions: { show: { operation: ['listTemplates'] } },
},
],
};
async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
const credentials = await this.getCredentials('wizPixelFlowApi');
const baseUrl = (credentials.baseUrl as string).replace(/\/$/, '');
const apiKey = credentials.apiKey as string;
const headers = { 'X-WPF-API-Key': apiKey, 'Content-Type': 'application/json' };
const items = this.getInputData();
const returnData: INodeExecutionData[] = [];
const parse = (r: unknown): IDataObject =>
(typeof r === 'string' ? JSON.parse(r) : r) as IDataObject;
for (let i = 0; i < items.length; i++) {
const operation = this.getNodeParameter('operation', i) as string;
try {
if (operation === 'render') {
const templateId = this.getNodeParameter('templateId', i) as string;
const jobType = this.getNodeParameter('jobType', i) as string;
const outputFormats = this.getNodeParameter('outputFormats', i) as string[];
const localesRaw = this.getNodeParameter('locales', i) as string;
const variablesRaw = this.getNodeParameter('variables', i) as string;
const waitForCompletion = this.getNodeParameter('waitForCompletion', i) as boolean;
const pollInterval = this.getNodeParameter('pollInterval', i) as number;
const maxWait = this.getNodeParameter('maxWait', i) as number;
const locales = localesRaw.split(',').map((l) => l.trim()).filter(Boolean);
const variables = typeof variablesRaw === 'string' ? JSON.parse(variablesRaw) : variablesRaw;
const body = {
template_id: templateId,
job_type: jobType,
formats: outputFormats,
locales,
variables,
};
const submitted = parse(
await this.helpers.httpRequest({
method: 'POST',
url: `${baseUrl}/render`,
headers,
body: JSON.stringify(body),
}),
);
if (!waitForCompletion) {
returnData.push({ json: submitted });
continue;
}
const jobId = submitted.job_id as string;
const deadline = Date.now() + maxWait * 1000;
let jobData: IDataObject = {};
while (Date.now() < deadline) {
await new Promise((r) => setTimeout(r, pollInterval * 1000));
jobData = parse(
await this.helpers.httpRequest({
method: 'GET',
url: `${baseUrl}/jobs.php?id=${jobId}`,
headers,
}),
);
const job = jobData.job as IDataObject | undefined;
if (job?.status && TERMINAL_STATUSES.includes(job.status as string)) break;
}
returnData.push({ json: jobData });
} else if (operation === 'getJob') {
const jobId = this.getNodeParameter('jobId', i) as string;
returnData.push({
json: parse(
await this.helpers.httpRequest({
method: 'GET',
url: `${baseUrl}/jobs.php?id=${jobId}`,
headers,
}),
),
});
} else if (operation === 'listTemplates') {
const limit = this.getNodeParameter('limit', i) as number;
returnData.push({
json: parse(
await this.helpers.httpRequest({
method: 'GET',
url: `${baseUrl}/templates?limit=${limit}`,
headers,
}),
),
});
}
} catch (error) {
if (this.continueOnFail()) {
returnData.push({
json: { error: (error as Error).message } as IDataObject,
pairedItem: i,
});
} else {
throw new NodeOperationError(this.getNode(), error as Error, { itemIndex: i });
}
}
}
return [returnData];
}
}