@ferchy/n8n-nodes-aimc-toolkit 0.1.38 → 0.1.40

package/README.md

@@ -48,80 +48,6 @@ n8n is powerful, but real workflows often need basic utilities (validation, pars
 npm install @ferchy/n8n-nodes-aimc-toolkit
 ```
 
----
-
-## Important: FFmpeg for Docker/Self-Hosted Users
-
-**If you're using AIMC Media node and see "FFmpeg not found" errors, read this!**
-
-### Why Do I Need to Install FFmpeg Separately?
-
-When you install a community node in n8n, **only the JavaScript code is installed** - not system binaries like FFmpeg. Here's why:
-
-1. **npm packages can only include JavaScript** - FFmpeg is a compiled binary program, not JavaScript code
-2. **We include ffmpeg-static** which tries to download a pre-compiled FFmpeg, but it often fails in Docker because:
-   - The binary is compiled for a different architecture (ARM vs x86)
-   - Docker containers may block the download
-   - The binary may not have execute permissions
-3. **n8n runs inside a container** - even if FFmpeg is on your host machine, the container can't access it
-
-### The Solution
-
-**Install FFmpeg directly in your n8n container.** This takes 30 seconds:
-
-```bash
-# For Docker (run this command)
-docker exec -it your-n8n-container apk add --no-cache ffmpeg
-
-# Or add to your Dockerfile for permanent installation
-FROM n8nio/n8n:latest
-USER root
-RUN apk add --no-cache ffmpeg
-USER node
-```
-
-Once installed, AIMC Media will **automatically detect** FFmpeg at /usr/bin/ffmpeg - no environment variables needed!
-
-### Quick Test
-
-After installing FFmpeg, try this URL in AIMC Media:
-```
-http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ForBiggerEscapes.mp4
-```
-
----
-
-## FFmpeg Setup
-
-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. System FFmpeg (e.g., /usr/bin/ffmpeg)
-3. Bundled ffmpeg-static / ffprobe-static
-
-### Docker (n8n official image)
-```bash
-docker exec container apk add --no-cache ffmpeg
-```
-
-### Custom Dockerfile (any host)
-Works for Coolify, Docker Compose, Kubernetes, or any Docker host.
-```dockerfile
-FROM n8nio/n8n:latest
-RUN apk add --no-cache ffmpeg
-```
-
-### Debian/Ubuntu
-```bash
-apt-get update && apt-get install -y ffmpeg
-```
-
-### macOS
-```bash
-brew install ffmpeg
-```
-
 ## Nodes
 
 ### AIMC Code
@@ -197,6 +123,21 @@ Input URL: https://example.com/video.mp4
 Output Format: webm
 ```
 
+## FFmpeg Setup (AIMC Media)
+
+FFmpeg must be installed on the same host/container where n8n runs. AIMC Media uses, in order:
+1. `FFMPEG_PATH` / `FFPROBE_PATH` environment variables
+2. System FFmpeg on `PATH`
+3. Bundled `ffmpeg-static` / `ffprobe-static` (if available)
+
+**Install examples**
+- Docker (inside container): `docker exec -it <container> apk add --no-cache ffmpeg`
+- Dockerfile (any host): `FROM n8nio/n8n:latest` then `RUN apk add --no-cache ffmpeg`
+- Debian/Ubuntu: `apt-get update && apt-get install -y ffmpeg`
+- macOS (local dev): `brew install ffmpeg`
+
+**Quick test**: use `http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ForBiggerEscapes.mp4` as Input URL.
+
 ### AIMC Social Scraper
 
 **Coming Soon!**
@@ -205,85 +146,69 @@ Social media scraping functionality is currently under development.
 
 ## Library Reference (AIMC Code)
 
-Libraries are available as globals or via `libs.<name>`. Examples are short and copy-paste friendly.
+Libraries are available as globals or via `libs.<name>`. Each group lists what’s included and what it’s used for.
 
 ### HTTP and Networking
-- **`axios`** — HTTP client. Example: `const { data } = await axios.get(url);`
-- **`qs`** — querystring builder/parser. Example: `qs.stringify({ filter: { status: 'open' } })`
-- **`FormData`** — multipart uploads. Example: `const form = new FormData(); form.append('file', $binary.data);`
-- **`httpProxyAgent`** — HTTP(S) proxy routing. Example: `axios.get(url, { httpAgent: new httpProxyAgent('http://host:8080') })`
-- **`socksProxyAgent`** — SOCKS proxy support. Example: `axios.get(url, { httpAgent: new socksProxyAgent('socks5://host:1080') })`
+- `axios` — HTTP client
+- `qs` — querystring builder/parser
+- `FormData` — multipart uploads
+- `httpProxyAgent` — HTTP(S) proxy routing
+- `socksProxyAgent` — SOCKS proxy support
 
 ### Parsing and Formats
-- **`YAML`** — YAML parse/stringify. Example: `const obj = YAML.parse(text);`
-- **`toml`** — TOML parsing. Example: `const obj = toml.parse(text);`
-- **`ini`** — INI parsing. Example: `const cfg = ini.parse(text);`
-- **`xml2js`** — XML to JS objects. Example: `const obj = await xml2js.parseStringPromise(xml);`
-- **`XMLParser`** — fast XML parsing. Example: `const obj = new XMLParser().parse(xml);`
-- **`papaparse` / `Papa`** — CSV parsing. Example: `papaparse.parse(csv, { header: true }).data;`
-- **`csvParse`** — CSV parsing (callback/stream). Example: `csvParse(csv, { columns: true }, (err, rows) => {});`
-- **`protobufjs` / `protobuf`** — Protobuf support. Example: `const root = await protobuf.load('schema.proto');`
-- **`Handlebars`** — templating. Example: `Handlebars.compile('Hi {{name}}')({ name: 'AIMC' });`
+- `YAML`, `toml`, `ini` — config formats
+- `xml2js`, `XMLParser` — XML parsing
+- `papaparse` / `Papa`, `csvParse` — CSV parsing
+- `protobufjs` / `protobuf` — Protobuf
+- `Handlebars` — templates
 
 ### Validation and Schema
-- **`zod` / `z`** — schema validation. Example: `z.object({ id: z.string() }).parse(input);`
-- **`joi` / `Joi`** — expressive validation. Example: `Joi.object({ id: Joi.string().required() }).validate(input);`
-- **`yup`** — object schema validation. Example: `await yup.object({ email: yup.string().email() }).validate(input);`
-- **`Ajv`** — JSON Schema validation. Example: `new Ajv().compile(schema)(input);`
-- **`validator`** — common validators. Example: `validator.isEmail(email);`
+- `zod` / `z`, `joi` / `Joi`, `yup` — schemas
+- `Ajv` — JSON Schema validation
+- `validator` — common validators
 
 ### Dates, Time, and Scheduling
-- **`dayjs`** — date formatting/math. Example: `dayjs().add(1, 'day').format('YYYY-MM-DD');`
-- **`dateFns`** — functional date utils. Example: `dateFns.addDays(new Date(), 7);`
-- **`dateFnsTz`** — timezone helpers. Example: `dateFnsTz.formatInTimeZone(new Date(), 'UTC', 'yyyy-MM-dd');`
-- **`moment`** — timezone-aware dates. Example: `moment().tz('America/New_York').format();`
-- **`cronParser`** — cron parsing. Example: `cronParser.parseExpression('0 * * * *').next().toString();`
-- **`ms`** — duration parsing. Example: `ms('2h');`
+- `dayjs`, `dateFns`, `dateFnsTz`, `moment` — date utilities
+- `cronParser` — cron parsing
+- `ms` — duration parsing
 
 ### Text, Search, and Similarity
-- **`cheerio`** — HTML parsing. Example: `const $ = cheerio.load(html); $('title').text();`
-- **`fuzzy`** — fuzzy search (Fuse.js). Example: `new fuzzy(list, { keys: ['title'] }).search('term');`
-- **`stringSimilarity`** — string similarity score. Example: `stringSimilarity.compareTwoStrings(a, b);`
-- **`marked`** — Markdown to HTML. Example: `marked.parse('# Title');`
-- **`slug`** — slugify strings. Example: `slug('My Title');`
-- **`pluralize`** — pluralization. Example: `pluralize('person', 2);`
-- **`htmlToText`** — HTML to text. Example: `htmlToText.convert('<b>hi</b>');`
+- `cheerio` — HTML parsing
+- `fuzzy` — fuzzy search
+- `stringSimilarity` — similarity score
+- `marked` — Markdown to HTML
+- `slug`, `pluralize`, `htmlToText` — text utilities
 
 ### Utilities and Math
-- **`_` / `lodash`** — data helpers. Example: `_.uniqBy(items, 'id');`
-- **`uuid`** — UUID generation. Example: `uuid.v4();`
-- **`nanoid`** — compact IDs. Example: `nanoid();`
-- **`bytes`** — parse/format bytes. Example: `bytes('1MB');`
-- **`jsonDiff`** — JSON diffing. Example: `jsonDiff.diff(a, b);`
-- **`pRetry`** — retry helper. Example: `await pRetry(() => axios.get(url), { retries: 3 });`
-- **`pLimit`** — concurrency limiter. Example: `const limit = pLimit(3); await Promise.all(tasks.map((t) => limit(t)));`
-- **`math`** — math utilities. Example: `math.evaluate('2 * (3 + 4)');`
-- **`currency`** — money math. Example: `currency(12.5).add(3).format();`
+- `_` / `lodash` — data helpers
+- `uuid`, `nanoid` — IDs
+- `bytes` — byte parsing/formatting
+- `jsonDiff` — JSON diffing
+- `pRetry`, `pLimit` — retry & concurrency
+- `math`, `currency` — math and money
 
 ### Language and NLP
-- **`franc`** — language detection. Example: `franc('This is English');`
-- **`compromise`** — NLP helpers. Example: `compromise('Hello world').nouns().out('array');`
+- `franc` — language detection
+- `compromise` — NLP helpers
 
 ### Media and Files
-- **`QRCode` / `qrcode`** — QR generation. Example: `await QRCode.toDataURL('hello');`
-- **`ytdl`** — media downloads. Example: `const stream = ytdl(url, { quality: 'highest' });`
-- **`ffmpeg`** — FFmpeg pipelines. Example: `ffmpeg('in.mp4').size('1280x?').save('out.mp4');`
-- **`ffmpegStatic`** — FFmpeg binary path. Example: `ffmpeg.setFfmpegPath(ffmpegStatic);`
-- **`ffprobeStatic`** — ffprobe binary path. Example: `ffmpeg.setFfprobePath(ffprobeStatic);`
-- **`pdfLib`** — PDF creation/editing. Example: `const pdf = await pdfLib.PDFDocument.create();`
-- **`archiver`** — zip archives. Example: `const archive = archiver('zip');`
-- **`Jimp`** — image processing. Example: `const img = await Jimp.read(buffer); img.resize(256, 256);`
+- `QRCode` / `qrcode` — QR generation
+- `ytdl` — media downloads
+- `ffmpeg`, `ffmpegStatic`, `ffprobeStatic` — FFmpeg pipelines
+- `pdfLib` — PDF creation/editing
+- `archiver` — zip archives
+- `Jimp` — image processing
 
 ### Database
-- **`knex`** — SQL query builder. Example: `const db = knex({ client: 'pg', connection: process.env.DB_URL });`
+- `knex` — SQL query builder
 
 ### Other Utilities
-- **`phoneNumber`** — phone parsing. Example: `phoneNumber.parsePhoneNumber('+14155552671').formatInternational();`
-- **`iban`** — IBAN validation. Example: `iban.isValid('GB82WEST12345698765432');`
+- `phoneNumber` — phone parsing
+- `iban` — IBAN validation
 
 ### Optional Native Helpers
-- **`bufferutil`** — optional native buffer helpers (if installed).
-- **`utf8Validate`** — optional UTF-8 validation (if installed).
+- `bufferutil` — optional native buffer helpers (if installed)
+- `utf8Validate` — optional UTF-8 validation (if installed)
 
 ## Configuration
 

package/package.json

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