n8n-nodes-iterationlayer 1.0.1

package/dist/nodes/IterationLayer/descriptions/imageTransformation.js

@@ -0,0 +1,364 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.imageTransformationProperties = void 0;
+const shared_js_1 = require("./shared.js");
+const OPERATION_TYPE_OPTIONS = [
+    { name: "Resize", value: "resize" },
+    { name: "Crop", value: "crop" },
+    { name: "Smart Crop", value: "smart_crop" },
+    { name: "Extend", value: "extend" },
+    { name: "Trim", value: "trim" },
+    { name: "Rotate", value: "rotate" },
+    { name: "Flip (Vertical)", value: "flip" },
+    { name: "Flop (Horizontal)", value: "flop" },
+    { name: "Blur", value: "blur" },
+    { name: "Sharpen", value: "sharpen" },
+    { name: "Modulate", value: "modulate" },
+    { name: "Tint", value: "tint" },
+    { name: "Grayscale", value: "grayscale" },
+    { name: "Invert Colors", value: "invert_colors" },
+    { name: "Auto Contrast", value: "auto_contrast" },
+    { name: "Gamma", value: "gamma" },
+    { name: "Opacity", value: "opacity" },
+    { name: "Remove Transparency", value: "remove_transparency" },
+    { name: "Threshold", value: "threshold" },
+    { name: "Denoise", value: "denoise" },
+    { name: "Convert Format", value: "convert" },
+    { name: "Upscale", value: "upscale" },
+    { name: "Compress to Size", value: "compress_to_size" },
+    { name: "Remove Background", value: "remove_background" },
+];
+const FIT_OPTIONS = [
+    { name: "Cover", value: "cover" },
+    { name: "Contain", value: "contain" },
+    { name: "Fill", value: "fill" },
+    { name: "Inside", value: "inside" },
+    { name: "Outside", value: "outside" },
+];
+const FORMAT_OPTIONS = [
+    { name: "PNG", value: "png" },
+    { name: "JPEG", value: "jpeg" },
+    { name: "WebP", value: "webp" },
+    { name: "AVIF", value: "avif" },
+    { name: "HEIF", value: "heif" },
+];
+const UPSCALE_FACTOR_OPTIONS = [
+    { name: "2x", value: 2 },
+    { name: "3x", value: 3 },
+    { name: "4x", value: 4 },
+];
+function withResourceDisplay(property) {
+    return {
+        ...property,
+        displayOptions: {
+            ...property.displayOptions,
+            show: {
+                ...property.displayOptions?.show,
+                resource: ["imageTransformation"],
+            },
+        },
+    };
+}
+exports.imageTransformationProperties = [
+    withResourceDisplay(shared_js_1.fileInputModeProperty),
+    withResourceDisplay(shared_js_1.fileBinaryPropertyNameProperty),
+    withResourceDisplay(shared_js_1.fileUrlProperty),
+    withResourceDisplay(shared_js_1.fileNameProperty),
+    {
+        displayName: "Operations",
+        name: "operations",
+        type: "fixedCollection",
+        typeOptions: { multipleValues: true },
+        default: {},
+        placeholder: "Add Operation",
+        description: "Image transformation operations to apply sequentially",
+        displayOptions: {
+            show: {
+                resource: ["imageTransformation"],
+            },
+        },
+        options: [
+            {
+                displayName: "Operation",
+                name: "operationValues",
+                values: [
+                    {
+                        displayName: "Type",
+                        name: "operationType",
+                        type: "options",
+                        options: OPERATION_TYPE_OPTIONS,
+                        default: "resize",
+                    },
+                    {
+                        displayName: "Width (px)",
+                        name: "widthInPx",
+                        type: "number",
+                        default: 800,
+                        displayOptions: {
+                            show: {
+                                operationType: ["resize", "crop", "smart_crop"],
+                            },
+                        },
+                    },
+                    {
+                        displayName: "Height (px)",
+                        name: "heightInPx",
+                        type: "number",
+                        default: 600,
+                        displayOptions: {
+                            show: {
+                                operationType: ["resize", "crop", "smart_crop"],
+                            },
+                        },
+                    },
+                    {
+                        displayName: "Fit",
+                        name: "fit",
+                        type: "options",
+                        options: FIT_OPTIONS,
+                        default: "cover",
+                        displayOptions: {
+                            show: { operationType: ["resize"] },
+                        },
+                    },
+                    {
+                        displayName: "Left (px)",
+                        name: "leftInPx",
+                        type: "number",
+                        default: 0,
+                        displayOptions: {
+                            show: { operationType: ["crop"] },
+                        },
+                    },
+                    {
+                        displayName: "Top (px)",
+                        name: "topInPx",
+                        type: "number",
+                        default: 0,
+                        displayOptions: {
+                            show: { operationType: ["crop"] },
+                        },
+                    },
+                    {
+                        displayName: "Angle (Degrees)",
+                        name: "angleInDegrees",
+                        type: "number",
+                        default: 90,
+                        displayOptions: {
+                            show: { operationType: ["rotate"] },
+                        },
+                    },
+                    {
+                        displayName: "Background Color",
+                        name: "hexColor",
+                        type: "string",
+                        default: "#FFFFFF",
+                        description: "Hex color for the background",
+                        displayOptions: {
+                            show: {
+                                operationType: ["rotate", "extend", "remove_transparency", "remove_background"],
+                            },
+                        },
+                    },
+                    {
+                        displayName: "Sigma",
+                        name: "sigma",
+                        type: "number",
+                        default: 3,
+                        displayOptions: {
+                            show: { operationType: ["blur", "sharpen"] },
+                        },
+                    },
+                    {
+                        displayName: "Brightness",
+                        name: "brightness",
+                        type: "number",
+                        default: 1,
+                        description: "Brightness multiplier (1 = unchanged)",
+                        displayOptions: {
+                            show: { operationType: ["modulate"] },
+                        },
+                    },
+                    {
+                        displayName: "Saturation",
+                        name: "saturation",
+                        type: "number",
+                        default: 1,
+                        description: "Saturation multiplier (1 = unchanged)",
+                        displayOptions: {
+                            show: { operationType: ["modulate"] },
+                        },
+                    },
+                    {
+                        displayName: "Hue",
+                        name: "hue",
+                        type: "number",
+                        default: 0,
+                        description: "Hue rotation in degrees",
+                        displayOptions: {
+                            show: { operationType: ["modulate"] },
+                        },
+                    },
+                    {
+                        displayName: "Tint Color",
+                        name: "tintHexColor",
+                        type: "string",
+                        default: "#FF0000",
+                        displayOptions: {
+                            show: { operationType: ["tint"] },
+                        },
+                    },
+                    {
+                        displayName: "Gamma",
+                        name: "gamma",
+                        type: "number",
+                        default: 2.2,
+                        displayOptions: {
+                            show: { operationType: ["gamma"] },
+                        },
+                    },
+                    {
+                        displayName: "Opacity (%)",
+                        name: "opacityInPercent",
+                        type: "number",
+                        default: 50,
+                        typeOptions: { minValue: 0, maxValue: 100 },
+                        displayOptions: {
+                            show: { operationType: ["opacity"] },
+                        },
+                    },
+                    {
+                        displayName: "Threshold",
+                        name: "thresholdValue",
+                        type: "number",
+                        default: 128,
+                        displayOptions: {
+                            show: { operationType: ["threshold", "trim"] },
+                        },
+                    },
+                    {
+                        displayName: "Grayscale",
+                        name: "isGrayscale",
+                        type: "boolean",
+                        default: true,
+                        displayOptions: {
+                            show: { operationType: ["threshold"] },
+                        },
+                    },
+                    {
+                        displayName: "Denoise Size",
+                        name: "denoiseSize",
+                        type: "number",
+                        default: 3,
+                        displayOptions: {
+                            show: { operationType: ["denoise"] },
+                        },
+                    },
+                    {
+                        displayName: "Output Format",
+                        name: "convertFormat",
+                        type: "options",
+                        options: FORMAT_OPTIONS,
+                        default: "webp",
+                        displayOptions: {
+                            show: { operationType: ["convert"] },
+                        },
+                    },
+                    {
+                        displayName: "Quality",
+                        name: "quality",
+                        type: "number",
+                        default: 85,
+                        typeOptions: { minValue: 1, maxValue: 100 },
+                        description: "Output quality (1-100)",
+                        displayOptions: {
+                            show: { operationType: ["convert"] },
+                        },
+                    },
+                    {
+                        displayName: "Upscale Factor",
+                        name: "upscaleFactor",
+                        type: "options",
+                        options: UPSCALE_FACTOR_OPTIONS,
+                        default: 2,
+                        displayOptions: {
+                            show: { operationType: ["upscale"] },
+                        },
+                    },
+                    {
+                        displayName: "Max File Size (Bytes)",
+                        name: "maxFileSizeInBytes",
+                        type: "number",
+                        default: 500_000,
+                        description: "Target maximum file size in bytes",
+                        displayOptions: {
+                            show: { operationType: ["compress_to_size"] },
+                        },
+                    },
+                    {
+                        displayName: "Top (px)",
+                        name: "extendTopInPx",
+                        type: "number",
+                        default: 0,
+                        displayOptions: {
+                            show: { operationType: ["extend"] },
+                        },
+                    },
+                    {
+                        displayName: "Bottom (px)",
+                        name: "extendBottomInPx",
+                        type: "number",
+                        default: 0,
+                        displayOptions: {
+                            show: { operationType: ["extend"] },
+                        },
+                    },
+                    {
+                        displayName: "Left (px)",
+                        name: "extendLeftInPx",
+                        type: "number",
+                        default: 0,
+                        displayOptions: {
+                            show: { operationType: ["extend"] },
+                        },
+                    },
+                    {
+                        displayName: "Right (px)",
+                        name: "extendRightInPx",
+                        type: "number",
+                        default: 0,
+                        displayOptions: {
+                            show: { operationType: ["extend"] },
+                        },
+                    },
+                ],
+            },
+        ],
+    },
+    {
+        displayName: "Async Mode",
+        name: "isAsync",
+        type: "boolean",
+        default: false,
+        description: "Whether to process asynchronously. Results will be delivered to the webhook URL.",
+        displayOptions: {
+            show: {
+                resource: ["imageTransformation"],
+            },
+        },
+    },
+    {
+        displayName: "Webhook URL",
+        name: "webhookUrl",
+        type: "string",
+        default: "",
+        placeholder: "https://your-app.com/webhooks/result",
+        description: "HTTPS URL for async result delivery",
+        displayOptions: {
+            show: {
+                resource: ["imageTransformation"],
+                isAsync: [true],
+            },
+        },
+    },
+];

package/dist/nodes/IterationLayer/descriptions/shared.d.ts

@@ -0,0 +1,7 @@
+import type { INodeProperties } from "n8n-workflow";
+export declare const fileInputModeProperty: INodeProperties;
+export declare const fileBinaryPropertyNameProperty: INodeProperties;
+export declare const fileUrlProperty: INodeProperties;
+export declare const fileNameProperty: INodeProperties;
+export declare const asyncModeProperty: INodeProperties;
+export declare const webhookUrlProperty: INodeProperties;

package/dist/nodes/IterationLayer/descriptions/shared.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webhookUrlProperty = exports.asyncModeProperty = exports.fileNameProperty = exports.fileUrlProperty = exports.fileBinaryPropertyNameProperty = exports.fileInputModeProperty = void 0;
+exports.fileInputModeProperty = {
+    displayName: "File Input Mode",
+    name: "fileInputMode",
+    type: "options",
+    options: [
+        {
+            name: "Binary Data from Previous Node",
+            value: "binaryData",
+        },
+        {
+            name: "URL",
+            value: "url",
+        },
+    ],
+    default: "binaryData",
+    description: "How to provide the input file",
+};
+exports.fileBinaryPropertyNameProperty = {
+    displayName: "Binary Property",
+    name: "fileBinaryPropertyName",
+    type: "string",
+    default: "data",
+    description: "The name of the binary property containing the file data",
+    displayOptions: {
+        show: {
+            fileInputMode: ["binaryData"],
+        },
+    },
+};
+exports.fileUrlProperty = {
+    displayName: "File URL",
+    name: "fileUrl",
+    type: "string",
+    default: "",
+    placeholder: "https://example.com/document.pdf",
+    description: "Publicly accessible URL of the file",
+    displayOptions: {
+        show: {
+            fileInputMode: ["url"],
+        },
+    },
+};
+exports.fileNameProperty = {
+    displayName: "File Name",
+    name: "fileName",
+    type: "string",
+    default: "",
+    placeholder: "document.pdf",
+    description: "Name of the file including extension (e.g., invoice.pdf). Used to determine the file type.",
+};
+exports.asyncModeProperty = {
+    displayName: "Async Mode",
+    name: "isAsync",
+    type: "boolean",
+    default: false,
+    description: "Whether to process the request asynchronously. When enabled, the API returns immediately and delivers results to the webhook URL.",
+};
+exports.webhookUrlProperty = {
+    displayName: "Webhook URL",
+    name: "webhookUrl",
+    type: "string",
+    default: "",
+    placeholder: "https://your-app.com/webhooks/result",
+    description: "HTTPS URL where the result will be delivered when processing is complete",
+    displayOptions: {
+        show: {
+            isAsync: [true],
+        },
+    },
+};

package/dist/nodes/IterationLayer/descriptions/sheetGeneration.d.ts

@@ -0,0 +1,2 @@
+import type { INodeProperties } from "n8n-workflow";
+export declare const sheetGenerationProperties: INodeProperties[];

package/dist/nodes/IterationLayer/descriptions/sheetGeneration.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sheetGenerationProperties = void 0;
+const FORMAT_OPTIONS = [
+    { name: "XLSX", value: "xlsx" },
+    { name: "CSV", value: "csv" },
+    { name: "Markdown", value: "markdown" },
+];
+exports.sheetGenerationProperties = [
+    {
+        displayName: "Output Format",
+        name: "sheetFormat",
+        type: "options",
+        options: FORMAT_OPTIONS,
+        default: "xlsx",
+        description: "The spreadsheet format to generate",
+        displayOptions: {
+            show: {
+                resource: ["sheetGeneration"],
+            },
+        },
+    },
+    {
+        displayName: "Sheets (JSON)",
+        name: "sheetsJson",
+        type: "json",
+        default: '[\n  {\n    "name": "Sheet 1",\n    "columns": [\n      {\n        "name": "Name"\n      },\n      {\n        "name": "Amount"\n      }\n    ],\n    "rows": [\n      [\n        "Item A",\n        100\n      ],\n      [\n        "Item B",\n        200\n      ]\n    ]\n  }\n]',
+        description: "JSON array of sheets. Each sheet has a name, columns (with name and optional width), and rows of cell values. See https://iterationlayer.com/docs/sheet-generation for the full schema.",
+        displayOptions: {
+            show: {
+                resource: ["sheetGeneration"],
+            },
+        },
+    },
+    {
+        displayName: "Styles (JSON)",
+        name: "sheetStylesJson",
+        type: "json",
+        default: "{}",
+        description: "Optional JSON object with header and body cell styles.",
+        displayOptions: {
+            show: {
+                resource: ["sheetGeneration"],
+            },
+        },
+    },
+    {
+        displayName: "Async Mode",
+        name: "isAsync",
+        type: "boolean",
+        default: false,
+        description: "Whether to process asynchronously. Results will be delivered to the webhook URL.",
+        displayOptions: {
+            show: {
+                resource: ["sheetGeneration"],
+            },
+        },
+    },
+    {
+        displayName: "Webhook URL",
+        name: "webhookUrl",
+        type: "string",
+        default: "",
+        placeholder: "https://your-app.com/webhooks/result",
+        description: "HTTPS URL for async result delivery",
+        displayOptions: {
+            show: {
+                resource: ["sheetGeneration"],
+                isAsync: [true],
+            },
+        },
+    },
+];

package/dist/nodes/IterationLayer/helpers/binaryData.d.ts

@@ -0,0 +1,2 @@
+import type { IBinaryKeyData, IExecuteFunctions } from "n8n-workflow";
+export declare function toBinaryOutput(executeFunctions: IExecuteFunctions, base64Buffer: string, mimeType: string, fileBaseName: string): Promise<IBinaryKeyData>;

package/dist/nodes/IterationLayer/helpers/binaryData.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toBinaryOutput = toBinaryOutput;
+const EXTENSION_BY_MIME_TYPE = {
+    "image/png": "png",
+    "image/jpeg": "jpg",
+    "image/webp": "webp",
+    "image/avif": "avif",
+    "image/heif": "heif",
+    "image/tiff": "tiff",
+    "image/gif": "gif",
+    "application/pdf": "pdf",
+    "application/vnd.openxmlformats-officedocument.wordprocessingml.document": "docx",
+    "application/epub+zip": "epub",
+    "application/vnd.openxmlformats-officedocument.presentationml.presentation": "pptx",
+};
+async function toBinaryOutput(executeFunctions, base64Buffer, mimeType, fileBaseName) {
+    const extension = EXTENSION_BY_MIME_TYPE[mimeType] ?? "bin";
+    const fileName = `${fileBaseName}.${extension}`;
+    const buffer = Buffer.from(base64Buffer, "base64");
+    const binaryData = await executeFunctions.helpers.prepareBinaryData(buffer, fileName, mimeType);
+    return { data: binaryData };
+}

package/dist/nodes/IterationLayer/helpers/fileInput.d.ts

@@ -0,0 +1,15 @@
+import type { IExecuteFunctions } from "n8n-workflow";
+interface FileInputBase64 {
+    type: "base64";
+    name: string;
+    base64: string;
+}
+interface FileInputUrl {
+    type: "url";
+    name: string;
+    url: string;
+}
+type FileInput = FileInputBase64 | FileInputUrl;
+export declare function getFileInput(executeFunctions: IExecuteFunctions, itemIndex: number): Promise<FileInput>;
+export declare function getMultipleFileInputs(executeFunctions: IExecuteFunctions, itemIndex: number): Promise<FileInput[]>;
+export {};

package/dist/nodes/IterationLayer/helpers/fileInput.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFileInput = getFileInput;
+exports.getMultipleFileInputs = getMultipleFileInputs;
+async function getFileInput(executeFunctions, itemIndex) {
+    const fileInputMode = executeFunctions.getNodeParameter("fileInputMode", itemIndex);
+    const fileName = executeFunctions.getNodeParameter("fileName", itemIndex);
+    if (fileInputMode === "url") {
+        const fileUrl = executeFunctions.getNodeParameter("fileUrl", itemIndex);
+        return { type: "url", name: fileName, url: fileUrl };
+    }
+    const binaryPropertyName = executeFunctions.getNodeParameter("fileBinaryPropertyName", itemIndex);
+    const binaryData = await executeFunctions.helpers.getBinaryDataBuffer(itemIndex, binaryPropertyName);
+    return {
+        type: "base64",
+        name: fileName,
+        base64: binaryData.toString("base64"),
+    };
+}
+async function getMultipleFileInputs(executeFunctions, itemIndex) {
+    const filesCollection = executeFunctions.getNodeParameter("files", itemIndex, {});
+    const fileEntries = filesCollection.fileValues ?? [];
+    const fileInputs = [];
+    for (const entry of fileEntries) {
+        if (entry.fileInputMode === "url") {
+            fileInputs.push({
+                type: "url",
+                name: entry.fileName,
+                url: entry.fileUrl ?? "",
+            });
+        }
+        else {
+            const binaryPropertyName = entry.fileBinaryPropertyName ?? "data";
+            const binaryData = await executeFunctions.helpers.getBinaryDataBuffer(itemIndex, binaryPropertyName);
+            fileInputs.push({
+                type: "base64",
+                name: entry.fileName,
+                base64: binaryData.toString("base64"),
+            });
+        }
+    }
+    return fileInputs;
+}

package/dist/nodes/IterationLayer/iterationlayer.svg

@@ -0,0 +1,7 @@
+<svg viewBox="0 0 500 500" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="500" height="500" rx="170" fill="black"/>
+  <rect x="50" y="50" width="400" height="400" rx="140" fill="white"/>
+  <rect x="100" y="100" width="300" height="300" rx="90" fill="black"/>
+  <rect x="150" y="150" width="200" height="200" rx="60" fill="white"/>
+  <rect x="200" y="200" width="100" height="100" rx="30" fill="black"/>
+</svg>

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "n8n-nodes-iterationlayer",
+  "version": "1.0.1",
+  "description": "n8n community node for the Iteration Layer API — document extraction, image transformation, image generation, and document generation.",
+  "keywords": [
+    "n8n-community-node-package"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Iteration Layer",
+    "email": "support@iterationlayer.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/iterationlayer/n8n-nodes-iterationlayer"
+  },
+  "homepage": "https://iterationlayer.com/docs/n8n",
+  "main": "index.js",
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/IterationLayerApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/IterationLayer/IterationLayer.node.js"
+    ]
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && cp src/nodes/IterationLayer/iterationlayer.svg dist/nodes/IterationLayer/",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src __tests__",
+    "format": "biome format --write src __tests__ *.ts *.json",
+    "format:check": "biome format src __tests__ *.ts *.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "n8n-workflow": ">=1.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.6",
+    "@types/node": "22.19.15",
+    "n8n-workflow": "1.72.0",
+    "typescript": "5.8.3",
+    "vitest": "4.0.18"
+  }
+}