@ferchy/n8n-nodes-aimc-toolkit 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AIMC Toolkit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,249 @@
+# AIMC Toolkit for n8n
+
+AIMC Toolkit is a community node package for n8n with two focused nodes:
+
+- **AIMC Code**: run JavaScript with a practical toolbox of libraries.
+- **AIMC Media**: FFmpeg-powered media operations without extra glue nodes.
+
+## Why I Built This
+
+n8n is powerful, but real workflows often need basic utilities (validation, parsing, HTTP) and media tasks (convert, compress, merge). I built AIMC Toolkit to remove the busywork and keep workflows short, readable, and fast.
+
+## Who This Is For
+
+- Automation builders who want fewer nodes and faster iterations.
+- Agencies handling content workflows, clips, and format conversions.
+- Founders and teams building internal tooling on n8n.
+- Power users who want a better code node and real media ops.
+
+## Why AIMC Toolkit
+
+- **Fewer nodes, cleaner flows**: consolidate multiple steps into one code node.
+- **Media ready**: convert, compress, merge, and inspect media in one place.
+- **Practical libraries**: parsing, validation, dates, and web utilities built in.
+
+## Installation
+
+### Prerequisites
+- n8n is already installed and running (self-hosted or desktop).
+- Community nodes are enabled in your n8n instance.
+- n8n Cloud does not support community nodes.
+
+### Community Nodes (Recommended)
+1. Open **Settings > Community Nodes** in n8n.
+2. Install: `@ferchy/n8n-nodes-aimc-toolkit`.
+
+### Manual
+```bash
+npm install @ferchy/n8n-nodes-aimc-toolkit
+```
+
+## FFmpeg Setup
+
+AIMC Media 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.
+
+### Docker (n8n official image)
+```bash
+docker exec <container> apk add --no-cache ffmpeg
+```
+
+### Debian/Ubuntu
+```bash
+apt-get update && apt-get install -y ffmpeg
+```
+
+### macOS (Homebrew)
+```bash
+brew install ffmpeg
+```
+
+## Nodes
+
+### AIMC Code
+
+**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`).
+
+**Example: normalize data**
+```javascript
+const rows = $input.all().map((i) => i.json);
+const ids = rows.map(() => nanoid());
+
+return rows.map((row, index) => ({
+  ...row,
+  id: ids[index],
+  normalizedEmail: validator.normalizeEmail(row.email || ''),
+  createdAt: utils.now(),
+}));
+```
+
+**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 Media
+
+**Operations**
+- Convert / Transcode
+- Compress
+- Extract Audio
+- Merge Video + Audio
+- Metadata (ffprobe)
+
+**Key Options**
+- **Input Mode**: Binary or File Path
+- **Output Mode**: Binary or File Path
+- **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
+```
+
+**Large Files**
+Use **Input Mode = File Path** to avoid loading big files into memory.
+
+## 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.
+
+### 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.
+
+### 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.
+
+### 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.
+
+## Configuration
+
+Environment variables:
+
+- `FFMPEG_PATH`: custom FFmpeg binary path
+- `FFPROBE_PATH`: custom ffprobe binary path
+
+## Troubleshooting
+
+- **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`.
+
+## License
+
+MIT

package/dist/nodes/AimcCode/AimcCode.node.d.ts

@@ -0,0 +1,5 @@
+import { INodeExecutionData, INodeType, INodeTypeDescription, IExecuteFunctions } from 'n8n-workflow';
+export declare class AimcCode implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}