📦 @lad-tech/nsc-fast-install

⚡️ Быстрая установка только нужных зависимостей при сборке микросервисов из большого моно-репозитория

---

❓ Зачем это нужно

В монорепозиториях:

• Все зависимости обычно указываются в корневом package.json;
• У сервисов нет своих node_modules;
• Это удобно для разработки, но неэффективно для сборки контейнеров.

🔥 Проблема

При COPY node_modules в Docker попадают все зависимости, даже если сервис использует только малую часть.

📦 Это:

• Увеличивает размер образов;
• Замедляет сборку;
• Усложняет отслеживание неиспользуемых пакетов.

---

💡 Решение

nsc-fast-install:

• Работает после сборки TS → JS;
• Анализирует start.js и все require()/import;
• Выявляет реально используемые зависимости;
• Копирует только нужные пакеты в dist/node_modules.

---

🚀 Установка

npm i @lad-tech/nsc-fast-install -D

---

🛠 Использование

# указываем точку входа
npx nsc-fast-install --entryPoint services/AuthService/start.ts

# или указываем папку сервиса (ищет main из package.json)
npx nsc-fast-install --service services/AuthService

---

📌 Пояснение про entryPoint и main

Способ	Как работает
--entryPoint	Путь до исходного TS-файла (start.ts)
--service	Указывает папку, внутри которой будет найдён main в package.json
main	Должен вести на dist/.../start.js — собранный JS-файл, не .ts
❗️Важно	Анализ производится по JS, а не по TypeScript-коду

Пример:

// services/AuthService/package.json
{
  "main": "dist/AuthService/start.js"
}

---

⚠️ Возможные дефекты

1. ❌ Вы указали .ts, но не собрали проект

   Ошибка: outDir не найден или start.js не существует

   ✅ Решение: выполните tsc или npm run build перед вызовом

2. ❌ main отсутствует или указывает на несуществующий файл

   ✅ Решение: добавьте main в package.json сервиса или используйте --entryPoint

3. ❌ Некорректные импорты (например, с ошибками в RegExp)

   ✅ Убедитесь, что транспиляция прошла успешно и код валиден (analyze выполняется Babel'ом)

---

🔧 Опции CLI

Флаг	Тип	Описание
--entryPoint	string	Путь до start.ts
--service	string	Путь до папки сервиса
--output	string	Папка назначения node_modules (по умолчанию — dist/)
--exclude	string	Исключить сервисы, через ,
--tsconfig	string	Имя tsconfig.json
--verbose	boolean	Расширенный лог
--dryRun	boolean	Не копировать, только показать