fd-importer

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

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

---

✨ Можливості

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

---

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

``bash
npm install fd-importer
``

---

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

🔹 CommonJS (Node.js require)



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

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

---



🔹 ESM (Node.js import)



`js
import importer from 'fd-importer';

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

---

⚙️ API

`ts
fdImporter(path, options?)
`

$3

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

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

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

$3

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

❗ Обмеження

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

📜 Ліцензія

MIT