@ferchy/n8n-nodes-aimc-toolkit 0.1.31 → 0.1.33

package/README.md

@@ -12,7 +12,7 @@ n8n is powerful, but real workflows often need basic utilities (validation, pars
 
 **Inspiration**: The original idea was sparked by Kenkaii's SuperCode. I'm grateful for that work and built AIMC Toolkit as my own version, tailored to my needs and expanded with improvements over time.
 
-**Note**: Of course there will be some bugs - that's obvious! We're aware of them and the best thing is that we will continue to improve, so please be patient! 😊
+**Note**: Of course there will be some bugs - that's obvious! We're aware of them and the best thing is that we will continue to improve, so please be patient!
 
 ## Who This Is For
 
@@ -46,7 +46,7 @@ npm install @ferchy/n8n-nodes-aimc-toolkit
 
 ---
 
-## ⚠️ Important: FFmpeg for Docker/Self-Hosted Users
+## Important: FFmpeg for Docker/Self-Hosted Users
 
 **If you're using AIMC Media node and see "FFmpeg not found" errors, read this!**
 
@@ -55,7 +55,7 @@ npm install @ferchy/n8n-nodes-aimc-toolkit
 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:
+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
@@ -67,7 +67,7 @@ When you install a community node in n8n, **only the JavaScript code is installe
 
 ```bash
 # For Docker (run this command)
-docker exec -it <your-n8n-container> apk add --no-cache ffmpeg
+docker exec -it your-n8n-container apk add --no-cache ffmpeg
 
 # Or add to your Dockerfile for permanent installation
 FROM n8nio/n8n:latest
@@ -76,7 +76,7 @@ RUN apk add --no-cache ffmpeg
 USER node
 ```
 
-Once installed, AIMC Media will **automatically detect** FFmpeg at `/usr/bin/ffmpeg` - no environment variables needed!
+Once installed, AIMC Media will **automatically detect** FFmpeg at /usr/bin/ffmpeg - no environment variables needed!
 
 ### Quick Test
 
@@ -92,34 +92,27 @@ http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ForBiggerEscape
 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`
+1. FFMPEG_PATH / FFPROBE_PATH environment variables
+2. System FFmpeg (e.g., /usr/bin/ffmpeg)
+3. Bundled ffmpeg-static / ffprobe-static
 
-If `ffmpeg-static` cannot install in your environment, install system FFmpeg on the same machine/container where n8n runs.
-
-### Docker (n8n official image, run inside the container)
+### Docker (n8n official image)
 ```bash
-docker exec <container> apk add --no-cache ffmpeg
+docker exec container apk add --no-cache ffmpeg
 ```
 
-### Coolify (recommended: custom Dockerfile)
-If you deploy n8n via Coolify, install FFmpeg in the container image.
-
-Example `Dockerfile`:
+### Coolify (custom 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)
+### Debian/Ubuntu
 ```bash
 apt-get update && apt-get install -y ffmpeg
 ```
 
-### macOS (local dev only)
+### macOS
 ```bash
 brew install ffmpeg
 ```
@@ -131,8 +124,8 @@ brew install ffmpeg
 **Features**
 - Run JavaScript or Python.
 - Run once for all items or once per item.
-- Access libraries as globals (`axios`, `_`, `zod`) or via `libs`.
-- Built-in helpers (`utils.now`, `utils.safeJson`, `utils.toArray`).
+- Access libraries as globals (axios, _, zod) or via libs.
+- Built-in helpers (utils.now, utils.safeJson, utils.toArray).
 - **AIMC Connect Mode**: optional AI connectors for LLMs, tools, memory, and more.
 
 **Example: normalize data**
@@ -148,52 +141,6 @@ return rows.map((row, index) => ({
 }));
 ```
 
-**Prompt starter (for GPT/Claude)**
-If you want AI to generate your node code, paste this prompt into ChatGPT, Claude, or any GPT-style tool and fill in your task:
-```text
-You are writing code for an n8n AIMC Code node.
-Goal: <describe what you want to do>
-Execution mode: <Run Once for Each Item OR Run Once for All Items>
-Inputs: items are available as `items` (all) or `item` (single)
-Return: return a plain object or array of objects (JSON-safe)
-Libraries (globals): axios, lodash (_), zod (z), joi (Joi), yup, Ajv, validator, dayjs, dateFns, dateFnsTz, moment,
-cheerio, papaparse (Papa), yaml (YAML), xml2js, XMLParser, qs, FormData, uuid, nanoid, bytes, cronParser, ms,
-fuzzy, stringSimilarity, slug, pluralize, jsonDiff, htmlToText, marked, qrcode/QRCode, ytdl, ffmpeg, ffmpegStatic, ffprobeStatic.
-Helpers: utils.now(), utils.safeJson(), utils.toArray()
-Please return only the JavaScript code for the AIMC Code node.
-```
-
-**Example: fetch + parse XML**
-```javascript
-const response = await axios.get('https://example.com/feed.xml');
-const parsed = await xml2js.parseStringPromise(response.data);
-
-return parsed;
-```
-
-**Python Example: summarize inputs**
-```python
-# items is a list of dicts, item is the first item
-result = {
-    "count": len(items),
-    "first": items[0] if items else None
-}
-```
-
-**AIMC Connect Mode (AI)**
-Enable **AIMC Connect Mode** to attach AI connectors. When enabled, your code can use:
-
-- `ai` (object with all connectors)
-- `aiModel`, `aiTools`, `aiMemory`, `aiVectorStore`, `aiChain`, `aiDocument`
-
-Example:
-```javascript
-if (aiModel) {
-  const response = await aiModel.invoke('Summarize this input.');
-  return { summary: response };
-}
-```
-
 ### AIMC Media
 
 **Operations**
@@ -209,30 +156,6 @@ if (aiModel) {
 - **Output Format**: mp4, webm, mov, mp3, wav, and more
 - **Extra FFmpeg Args**: one per line for advanced control
 
-**Example: convert and scale**
-```
-Operation: Convert / Transcode
-Output Format: WebM
-Additional Output Options:
--vf scale=1280:-2
-```
-
-**Example: compress**
-```
-Operation: Compress
-CRF: 24
-Preset: fast
-Audio Bitrate: 128k
-```
-
-**Example: merge video + audio**
-```
-Operation: Merge Video + Audio
-Input Mode: File Path
-Video File Path: /path/to/video.mp4
-Audio File Path: /path/to/audio.mp3
-```
-
 **Example: download and convert from URL**
 ```
 Operation: Convert / Transcode
@@ -241,163 +164,89 @@ Input URL: https://example.com/video.mp4
 Output Format: webm
 ```
 
-**Large Files**
-Use **Input Mode = File Path** or **URL** to avoid loading big files into memory.
-
-**FFmpeg for Docker/Self-Hosted n8n**
-
-The `ffmpeg-static` package is included but may not work in Docker containers. If you see "FFmpeg not found" errors, install FFmpeg in your container:
-
-**Option 1: Custom Dockerfile**
-```dockerfile
-FROM n8nio/n8n:latest
-
-USER root
-RUN apk add --no-cache ffmpeg
-USER node
-```
-
-**Option 2: Environment variables** (if FFmpeg is already installed)
-```yaml
-environment:
-  - FFMPEG_PATH=/usr/bin/ffmpeg
-  - FFPROBE_PATH=/usr/bin/ffprobe
-```
-
 ### AIMC Social Scraper
 
 **Coming Soon!**
 
-Social media scraping functionality is currently under development. This node will support scraping content from various platforms including TikTok, Instagram, Twitter/X, and more.
-
-**Note**: YouTube support is already available via the **AIMC Code** node using the `ytdl` library. See the Media Helpers section for details.
+Social media scraping functionality is currently under development.
 
 ## Library Reference (AIMC Code)
 
-Libraries are available as globals or via `libs.<name>`.
-
-## Python Support (AIMC Code)
-
-Python executes locally using the configured Python binary (default: `python3`).
-Provide Python code and set a variable named `result` to return output.
-
-### Python Settings
-- **Python Path**: path to the Python binary (e.g. `python3` or `/usr/bin/python3`)
-- **Python Packages**: comma-separated list of packages
-- **Auto-install Python Packages**: runs `pip install --user` before execution
-
-### Python Tips
-- Use `items` (list of dicts) or `item` (first item) as inputs.
-- Use `params` to access node parameters.
-- Keep results JSON-serializable for best compatibility.
+Libraries are available as globals or via libs.name.
 
 ### HTTP and Networking
-- `axios` (global `axios`): HTTP client with base URL, headers, query params, timeouts, and interceptors. Use for REST APIs, uploads, downloads, and pagination.
-- `qs` (global `qs`): querystring parsing/stringifying with deep objects. Use for complex filters and API query params.
-- `form-data` (global `FormData`): multipart form uploads. Use for file uploads and mixed form fields.
-- `http-proxy-agent` (global `httpProxyAgent`): route HTTP(S) requests through proxies. Use when your environment requires a proxy.
-- `socks-proxy-agent` (global `socksProxyAgent`): SOCKS proxy support for networking. Use for private network routing.
-
-### Data Parsing and Formats
-- `yaml` (global `YAML`): parse/stringify YAML. Use for config or workflow data stored as YAML.
-- `toml` (global `toml`): parse TOML. Use for reading TOML configs.
-- `xml2js` (global `xml2js`): XML to JS objects. Use for RSS feeds and XML APIs.
-- `fast-xml-parser` (global `XMLParser`): faster XML parsing with schema options. Use when performance matters.
-- `papaparse` (global `papaparse` or `Papa`): CSV parsing and serialization. Use for spreadsheets exported as CSV.
-- `protobufjs` (global `protobufjs` or `protobuf`): encode/decode Protobuf messages. Use for services that expose `.proto` schemas.
-
-### Validation and Schema
-- `zod` (global `zod` or `z`): schema parsing and validation with strong typing. Use for payload validation and clean error messages.
-- `joi` (global `joi` or `Joi`): expressive validation schemas. Use for complex conditional validation.
-- `yup` (global `yup`): object schema validation. Use for forms and input checks.
-- `ajv` (global `Ajv`): JSON Schema validator. Use for OpenAPI/JSON Schema validation.
-- `validator` (global `validator`): common validators and sanitizers (email, URL, IP, etc.). Use for quick checks.
-
-### Dates, Time, and Scheduling
-- `dayjs` (global `dayjs`): lightweight date library. Use for formatting and date math.
-- `date-fns` (global `dateFns`): functional date utilities. Use for immutable date transformations.
-- `date-fns-tz` (global `dateFnsTz`): timezone helpers for `date-fns`. Use for timezone conversions.
-- `moment-timezone` (global `moment`): timezone-aware date formatting and parsing.
-- `cron-parser` (global `cronParser`): parse cron expressions. Use for scheduling checks and next-run calculations.
-- `ms` (global `ms`): parse/format durations. Use for `1h`, `30m`, `2d` handling.
-
-### Text, Search, and Similarity
-- `fuse.js` (global `fuzzy`): fuzzy search over arrays. Use for matching names, titles, or tags.
-- `string-similarity` (global `stringSimilarity`): compare strings by similarity score. Use for deduping or fuzzy matches.
-- `marked` (global `marked`): Markdown to HTML parser. Use for rendering user docs.
-- `slug` (global `slug`): slugify strings. Use for URLs and file names.
-- `pluralize` (global `pluralize`): pluralization and singularization helpers.
-- `html-to-text` (global `htmlToText`): convert HTML to readable plain text.
-
-### Web Scraping and Content
-- `cheerio` (global `cheerio`): jQuery-like HTML parser. Use for DOM extraction and scraping.
+- axios: HTTP client
+- qs: querystring parsing
+- FormData: multipart form uploads
+- httpProxyAgent: HTTP proxy support
+- socksProxyAgent: SOCKS proxy support
+
+### Data Parsing
+- yaml (YAML): parse/stringify YAML
+- toml: parse TOML
+- xml2js: XML to JS objects
+- XMLParser: fast XML parsing
+- papaparse (Papa): CSV parsing
+- protobufjs: Protobuf messages
+
+### Validation
+- zod (z): schema validation
+- joi (Joi): expressive validation
+- yup: object schema validation
+- Ajv: JSON Schema validator
+- validator: common validators
+
+### Dates and Time
+- dayjs: lightweight dates
+- dateFns: functional date utilities
+- dateFnsTz: timezone helpers
+- moment: timezone-aware dates
+- cronParser: cron expressions
+- ms: duration parsing
+
+### Text and Search
+- fuzzy (Fuse.js): fuzzy search
+- stringSimilarity: string comparison
+- marked: Markdown to HTML
+- slug: slugify strings
+- pluralize: pluralization
+- htmlToText: HTML to text
+- cheerio: jQuery-like HTML parser
 
 ### IDs and Utilities
-- `uuid` (global `uuid`): UUID generation. Use for stable IDs.
-- `nanoid` (global `nanoid`): compact unique IDs. Use for short IDs.
-- `bytes` (global `bytes`): parse/format byte sizes. Use for human-readable file sizes.
-
-### Language Tools
-- `franc-min` (global `franc`): language detection for text.
-- `compromise` (global `compromise`): NLP utilities (tags, sentences, entities). Use for quick text analysis.
-
-### 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.
-
-### Extra Tools
-- `json-diff-ts` (global `jsonDiff`): JSON diff and comparison utilities. Use for change detection.
-- `iban` (global `iban`): validate and format IBAN numbers.
-- `ini` (global `ini`): parse/stringify INI files.
-- `libphonenumber-js` (global `phoneNumber`): phone number parsing/formatting/validation.
-
-### Optional Native Helpers
-- `bufferutil` (global `bufferutil`): optional native Buffer helpers if installed.
-- `utf-8-validate` (global `utf8Validate`): optional UTF-8 validation if installed.
+- uuid: UUID generation
+- nanoid: compact IDs
+- bytes: byte size formatting
+
+### Media
+- ytdl: YouTube downloads
+- ffmpeg (fluent-ffmpeg): FFmpeg pipelines
+- ffmpegStatic: FFmpeg binary path
+- ffprobeStatic: ffprobe binary path
+- QRCode: QR code generation
 
 ## Configuration
 
 Environment variables:
-
-- `FFMPEG_PATH`: custom FFmpeg binary path
-- `FFPROBE_PATH`: custom ffprobe binary path
+- FFMPEG_PATH: custom FFmpeg binary path
+- FFPROBE_PATH: custom ffprobe binary path
 
 ## Troubleshooting
 
-- **FFmpeg not found**: install FFmpeg or set `FFMPEG_PATH`.
+- **FFmpeg not found**: install FFmpeg or set FFMPEG_PATH.
 - **Large files**: use File Path input mode.
-- **Binary output missing**: check `Output Mode` and `Output Binary Property`.
+- **Binary output missing**: check Output Mode and Output Binary Property.
 
 ## Legal Disclaimer
 
-**AIMC Social Scraper Disclaimer**
-
-The AIMC Social Scraper node uses web scraping techniques to extract data from social media platforms. This is **not** an official API integration and is provided for educational and personal use only.
-
-**Important Points:**
-- This scraper uses the web interface of platforms, not official APIs
-- Users must comply with each platform's Terms of Service
-- Users must comply with applicable laws and regulations (GDPR, CCPA, etc.)
-- Users are responsible for respecting rate limits and avoiding abusive behavior
-- Users must respect copyright and intellectual property rights
-- Commercial use may require explicit permission from platform owners
-- The authors and maintainers are not responsible for misuse or violations
+The AIMC Social Scraper uses web scraping techniques. This is not an official API integration.
 
-**Recommended Practices:**
-- Use session cookies to reduce rate limiting issues
-- Implement reasonable delays between requests
-- Respect robots.txt and platform guidelines
-- Only scrape publicly available content
-- Do not redistribute scraped content without permission
-- Consider using official APIs when available for production use
+**Important:**
+- Users must comply with platform Terms of Service
+- Users must comply with applicable laws (GDPR, CCPA, etc.)
+- The authors are not responsible for misuse
 
-**Use at your own risk.** If you're building a commercial product, consider using official APIs or obtaining proper licensing.
+**Use at your own risk.**
 
 ## License
 

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@ferchy/n8n-nodes-aimc-toolkit",
-  "version": "0.1.31",
+  "version": "0.1.33",
   "description": "AIMC Toolkit nodes for n8n: code execution and media operations.",
   "license": "MIT",
   "author": "Ferchy",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ferchy/n8n-nodes-aimc-toolkit"
+  },
+  "homepage": "https://github.com/ferchy/n8n-nodes-aimc-toolkit#readme",
   "engines": {
     "node": ">=18.0.0"
   },