fd-importer

fd-importer — простий імпортер модулів з папки для Node.js.
Автоматично завантажує всі файли з вказаної директорії та повертає об’єкт, де ключі — це імена файлів (без розширення), а значення — це експортовані модулі.

Підтримує CommonJS і ESM.

✨ Можливості

• Імпорт усіх файлів із директорії (лише перший рівень).
• Пропуск файлів за першим символом (наприклад, !ignored.js).
• Підтримка CommonJS require() та ESM import() (асинхронно).
• Зручне створення об’єкта модулів:
  { filenameWithoutExt: exportedModule }.

📦 Встановлення

npm install fd-importer

📚 Використання

🔹 CommonJS (Node.js require)

const importer = require('fd-importer');

(async () => {
  const modules = await importer('src/modules');
  console.log(modules); 
})();

🔹 ESM (Node.js import)

import importer from 'fd-importer';

const modules = await importer('src/modules');
console.log(modules);

⚙️ API

fdImporter(path, options?)

Параметри

| параметр | тип | опис | | ---------------------- | --------- | ---------------------------------------------------------------------- | | path | string | Шлях до директорії з модулями | | options.blocked_char | string | Файли, що починаються з цього символу, пропускаються. (default: "!") | | options.debug | boolean | Показувати повні помилки. (default: false) |

🧪 Приклад структури директорії

handlers/
  login.js
  logout.js
  !ignore.js

Результат імпорту:

{
  login: require('./handlers/login.js'),
  logout: require('./handlers/logout.js')
}

❗ Обмеження

• Імпортує лише файли першого рівня (без рекурсії).
• Працює тільки з файлами, які можна імпортувати через require() або import().
• Виконання модулів відбувається при імпорті — не використовуйте на ненадійних папках.

📜 Ліцензія

MIT