@ferchy/n8n-nodes-aimc-toolkit 0.1.10 → 0.1.12

package/README.md

@@ -42,25 +42,37 @@ npm install @ferchy/n8n-nodes-aimc-toolkit
 
 ## FFmpeg Setup
 
-AIMC Media will use the first available option:
+AIMC Media runs inside your n8n host/container, so FFmpeg must be available there.
+It will use the first available option:
 
 1. `FFMPEG_PATH` / `FFPROBE_PATH` environment variables
 2. Bundled `ffmpeg-static` / `ffprobe-static`
 3. System FFmpeg on `PATH`
 
-If `ffmpeg-static` cannot install in your environment, install system FFmpeg.
+If `ffmpeg-static` cannot install in your environment, install system FFmpeg on the same machine/container where n8n runs.
 
-### Docker (n8n official image)
+### Docker (n8n official image, run inside the container)
 ```bash
 docker exec <container> apk add --no-cache ffmpeg
 ```
 
-### Debian/Ubuntu
+### Coolify (recommended: custom Dockerfile)
+If you deploy n8n via Coolify, install FFmpeg in the container image.
+
+Example `Dockerfile`:
+```dockerfile
+FROM n8nio/n8n:latest
+RUN apk add --no-cache ffmpeg
+```
+
+Then point Coolify to the Dockerfile (or use its "Custom Dockerfile" option) and redeploy.
+
+### Debian/Ubuntu (server/VM running n8n)
 ```bash
 apt-get update && apt-get install -y ffmpeg
 ```
 
-### macOS (Homebrew)
+### macOS (local dev only)
 ```bash
 brew install ffmpeg
 ```
@@ -236,6 +248,9 @@ Provide Python code and set a variable named `result` to return output.
 ### Media Helpers
 - `qrcode` (global `QRCode` or `qrcode`): generate QR codes as data URLs or images.
 - `@distube/ytdl-core` (global `ytdl`): download media from supported sources. Use for media ingestion flows.
+- `fluent-ffmpeg` (global `ffmpeg`): build FFmpeg pipelines in JS when you need custom media logic.
+- `ffmpeg-static` (global `ffmpegStatic`): path to a bundled FFmpeg binary (if available).
+- `ffprobe-static` (global `ffprobeStatic`): path to a bundled ffprobe binary (if available).
 
 ### Database and Query Helpers
 - `knex` (global `knex`): SQL query builder. Use for lightweight DB queries when allowed by your environment.

package/dist/nodes/AimcCode/AimcCode.node.js

@@ -107,6 +107,9 @@ const libraryLoaders = {
     ytdl: () => require('@distube/ytdl-core'),
     httpProxyAgent: () => require('http-proxy-agent'),
     socksProxyAgent: () => require('socks-proxy-agent'),
+    ffmpeg: () => require('fluent-ffmpeg'),
+    ffmpegStatic: () => require('ffmpeg-static'),
+    ffprobeStatic: () => require('ffprobe-static'),
     bufferutil: optionalRequire('bufferutil'),
     utf8Validate: optionalRequire('utf-8-validate'),
 };
@@ -442,7 +445,7 @@ class AimcCode {
                             language: ['javascript'],
                         },
                     },
-                    default: `// AIMC Code node\n// Use libs.<name> or direct globals like axios, _, zod\n\n// Example: transform all items\nconst data = $input.all().map((entry) => entry.json);\nconst ids = data.map((row) => nanoid());\n\nreturn data.map((row, index) => ({\n  ...row,\n  id: ids[index],\n  processedAt: utils.now(),\n}));\n`,
+                    default: `// AIMC Code (JavaScript)\n// Libraries are globals or available via libs.<name>\n// HTTP: axios, qs, FormData, httpProxyAgent, socksProxyAgent\n// Parse: YAML, toml, xml2js, XMLParser, papaparse/Papa, protobufjs\n// Validate: zod (z), joi (Joi), yup, Ajv, validator\n// Dates: dayjs, dateFns, dateFnsTz, moment, cronParser, ms\n// Text: cheerio, htmlToText, marked, slug, pluralize, fuzzy, stringSimilarity, compromise, franc\n// Utils: lodash (_), uuid, nanoid, bytes, jsonDiff, pRetry\n// Media: qrcode/QRCode, ytdl, ffmpeg, ffmpegStatic, ffprobeStatic\n// DB: knex\n// Other: phoneNumber, iban\n// Optional native: bufferutil, utf8Validate\n//\n// AIMC Connect Mode (AI) gives you:\n// ai, aiModel, aiTools, aiMemory, aiVectorStore, aiChain, aiDocument, aiEmbedding, aiOutputParser, aiTextSplitter\n\n// Run Once for Each Item\nif (typeof item !== 'undefined') {\n  return {\n    mode: 'runOnceForEachItem',\n    item: item.json,\n    id: nanoid(),\n    receivedAt: utils.now(),\n  };\n}\n\n// Run Once for All Items\nconst rows = $input.all().map((entry) => entry.json);\nreturn rows.map((row) => ({\n  ...row,\n  id: nanoid(),\n  processedAt: utils.now(),\n}));\n`,
                     description: 'Write JavaScript to transform data.',
                     noDataExpression: true,
                 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ferchy/n8n-nodes-aimc-toolkit",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "AIMC Toolkit nodes for n8n: code execution and media operations.",
   "license": "MIT",
   "author": "Ferchy",