@ferchy/n8n-nodes-aimc-toolkit 0.1.35 → 0.1.37

package/README.md

@@ -145,6 +145,21 @@ 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.
+```
+
 ### AIMC Media
 
 **Operations**
@@ -176,58 +191,78 @@ Social media scraping functionality is currently under development.
 
 ## Library Reference (AIMC Code)
 
-Libraries are available as globals or via libs.name.
+Libraries are available as globals or via `libs.<name>`. Examples below are minimal and meant to be copy-paste friendly.
 
 ### HTTP and Networking
-- 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
+- `axios`: HTTP client. Example: `const { data } = await axios.get('https://api.example.com');`
+- `qs`: querystring builder/parser. Example: `qs.stringify({ filter: { status: 'open' } })`.
+- `FormData`: multipart uploads. Example: `const form = new FormData(); form.append('file', $binary.data);`
+- `httpProxyAgent`: route HTTP(S) via proxy. Example: `axios.get(url, { httpAgent: new httpProxyAgent('http://user:pass@host:8080') });`
+- `socksProxyAgent`: SOCKS proxy support. Example: `axios.get(url, { httpAgent: new socksProxyAgent('socks5://host:1080') });`
+
+### Data Parsing and Templates
+- `YAML`: parse/stringify YAML. Example: `const obj = YAML.parse(text);`
+- `toml`: parse TOML. Example: `const obj = toml.parse(text);`
+- `ini`: parse INI files. 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;`
+- `Handlebars`: templates. Example: `const tpl = Handlebars.compile('Hi {{name}}'); tpl({ name: 'AIMC' });`
+- `protobufjs` / `protobuf`: Protobuf support. Example: `const root = await protobuf.load('schema.proto');`
+
+### 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 validator. Example: `const validate = new Ajv().compile(schema); validate(input);`
+- `validator`: common validators. Example: `validator.isEmail(email);`
+
+### 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 schedule parsing. Example: `cronParser.parseExpression('0 * * * *').next().toString();`
+- `ms`: duration parsing. Example: `ms('2h');`
+
+### Text, Search, and Similarity
+- `cheerio`: HTML parsing. Example: `const $ = cheerio.load(html); $('title').text();`
+- `fuzzy` (Fuse.js): fuzzy search. Example: `const fuse = new fuzzy(list, { keys: ['title'] }); fuse.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>');`
 
 ### IDs and Utilities
-- 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
+- `_` / `lodash`: utility helpers. Example: `_.uniqBy(items, 'id');`
+- `uuid`: UUID generation. Example: `uuid.v4();`
+- `nanoid`: compact IDs. Example: `nanoid();`
+- `bytes`: parse/format bytes. Example: `bytes(1024);` or `bytes('1MB');`
+- `jsonDiff`: JSON diffing. Example: `jsonDiff.diff(a, b);`
+- `pRetry`: retry helper. Example: `await pRetry(() => axios.get(url), { retries: 3 });`
+
+### Language and NLP
+- `franc`: language detection. Example: `franc('This is English');`
+- `compromise`: NLP utilities. Example: `compromise('Hello world').nouns().out('array');`
+
+### Media and Files
+- `QRCode` / `qrcode`: QR generation. Example: `await QRCode.toDataURL('hello');`
+- `ytdl`: media downloads. Example: `const stream = ytdl(url, { quality: 'highest' });`
+- `ffmpeg` (fluent-ffmpeg): build 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);`
+
+### Database
+- `knex`: SQL query builder. Example: `const db = knex({ client: 'pg', connection: process.env.DB_URL });`
+
+### Other Utilities
+- `phoneNumber` (libphonenumber-js): phone parsing. Example: `phoneNumber.parsePhoneNumber('+14155552671').formatInternational();`
+- `iban`: IBAN validation. Example: `iban.isValid('GB82WEST12345698765432');`
+
+### Optional Native Helpers
+- `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.35",
+  "version": "0.1.37",
   "description": "AIMC Toolkit nodes for n8n: code execution and media operations.",
   "license": "MIT",
   "author": "Ferchy",