@rshval/back-kit 1.1.3 → 1.1.5

package/README.md

@@ -1,148 +1,187 @@
 # @rshval/back-kit
 
-Публичный npm-пакет `@rshval/back-kit` с серверными утилитами для Node.js/TypeScript проектов.
+Public npm package `@rshval/back-kit` with server-side utilities for Node.js/TypeScript projects.
 
-> Репозиторий используется для внутренних проектов автора. Любое использование третьими лицами выполняется на их страх и риск.
+> This repository is used for the author's internal projects. Any third-party usage is at your own risk.
 
-## Установка
+## Installation
 
 ```bash
 npm i @rshval/back-kit
 ```
 
-Пакет ESM-only (`"type": "module"`). Для CommonJS используйте динамический `import()`.
+The package is ESM-only (`"type": "module"`). For CommonJS, use dynamic `import()`.
+
+## Quick navigation
+
+- [Email](#1-email)
+- [Config and JWT](#2-config-and-jwt)
+- [Helper utilities](#3-helper-utilities)
+- [Validation](#4-validation)
+- [Builders](#5-builders-config-bound)
+- [Database](#6-database)
+- [Cache](#7-cache)
+- [Logging](#8-logging)
+- [WebSocket client](#9-websocket-client)
+- [Paymaster](#10-paymaster)
+- [Mail templates](#11-mail-templates)
+- [Audit changes](#12-audit-changes)
+- [Seed functions](#13-seed-functions)
+- [API client](#14-api-client)
 
 ---
 
-## Все экспортируемые функции и примеры использования
+## API and usage examples
 
-Ниже перечислены все публичные экспорты из пакета (через `src/index.ts`) и короткие примеры.
+Below are the public exports from the package (via `src/index.ts`) with short examples. For key APIs, there are separate **production examples** that show practical integration patterns for real services.
 
 ### 1) Email
 
 #### `createMailOptions({ from, to, subject, text })`
-Создаёт объект параметров письма для nodemailer. Поддерживает `to` как строку (обычная отправка) или объект формы (`MailOptionsBody`) для заявок/обратной связи.
+
+Creates a nodemailer mail options object. Supports `to` as a string (regular send) or a form object (`MailOptionsBody`) for requests/feedback scenarios.
 
 ```ts
-import { createMailOptions } from '@rshval/back-kit'
+import { createMailOptions } from '@rshval/back-kit';
 
 const options = createMailOptions({
   from: 'robot@example.com',
   to: 'user@example.com',
   subject: 'Hello',
-  text: 'Welcome!'
-})
+  text: 'Welcome!',
+});
 ```
 
 #### `sendEmailWithConfig({ nodemailerConfig, to, subject, text })`
-Создаёт transport через nodemailer, отправляет письмо и возвращает строку с результатом отправки.
+
+Creates a nodemailer transport, sends an email, and returns a string with the send result.
 
 ```ts
-import { sendEmailWithConfig } from '@rshval/back-kit'
+import { sendEmailWithConfig } from '@rshval/back-kit';
 
 await sendEmailWithConfig({
   nodemailerConfig: {
     host: 'smtp.example.com',
     port: 465,
     secure: true,
-    auth: { user: 'robot@example.com', pass: '***' }
+    auth: { user: 'robot@example.com', pass: '***' },
   },
   to: 'user@example.com',
   subject: 'Reset password',
-  text: 'Code: 123456'
-})
+  text: 'Code: 123456',
+});
+```
+
+**Production example**:
+
+```ts
+import { buildSendEmail } from '@rshval/back-kit';
+
+const sendEmailWithConfig = buildSendEmail(runtimeConfig);
+await sendEmailWithConfig(to, subject, text);
 ```
 
 ---
 
-### 2) Конфиг и JWT
+### 2) Config and JWT
 
 #### `getBaseUrlByConfig(config, baseUrl?)`
-Строит base URL по конфигу приложения. В `development` добавляет `:port`.
+
+Builds a base URL from app config. In `development`, adds `:port`.
 
 ```ts
-import { getBaseUrlByConfig } from '@rshval/back-kit'
+import { getBaseUrlByConfig } from '@rshval/back-kit';
 
 const base = getBaseUrlByConfig(
   {
     NODE_ENV: 'development',
     server: { domain: 'localhost', port: 3000 },
-    jwt: {}
+    jwt: {},
   },
-  '/api'
-)
+  '/api',
+);
 // //localhost:3000/api
 ```
 
 #### `createTokenByConfig({ config, user, expiresIn })`
-Создаёт JWT-токен на основе `config.jwt.JWT_KEY` (или `JWT_KEY_NO_ENV`).
+
+Creates a JWT token based on `config.jwt.JWT_KEY` (or `JWT_KEY_NO_ENV`).
 
 ```ts
-import { createTokenByConfig } from '@rshval/back-kit'
+import { createTokenByConfig } from '@rshval/back-kit';
 
 const token = createTokenByConfig({
   config: {
     server: { domain: 'example.com' },
-    jwt: { JWT_KEY: 'super-secret' }
+    jwt: { JWT_KEY: 'super-secret' },
   },
   user: { _id: '64a...' },
-  expiresIn: '7d'
-})
+  expiresIn: '7d',
+});
 ```
 
 ---
 
-### 3) Вспомогательные утилиты
+### 3) Helper utilities
 
 #### `createPinCode(min?, max?)`
-Генерирует случайный числовой PIN в диапазоне (`10000..99990` по умолчанию).
+
+Generates a random numeric PIN in range (`10000..99990` by default).
 
 ```ts
-import { createPinCode } from '@rshval/back-kit'
+import { createPinCode } from '@rshval/back-kit';
 
-const pin = createPinCode()
+const pin = createPinCode();
 ```
 
 #### `getIp(req)`
-Пытается определить IP клиента из `req.ip`, сокетов и `x-forwarded-for`.
+
+Attempts to detect client IP from `req.ip`, sockets, and `x-forwarded-for`.
 
 ```ts
-import { getIp } from '@rshval/back-kit'
+import { getIp } from '@rshval/back-kit';
 
-const ip = await getIp(req)
+const ip = await getIp(req);
 ```
 
 #### `translitUrl(str)`
-Транслитерирует строку в URL-friendly slug (`-`, lower-case).
+
+Transliterates a string into a URL-friendly slug (`-`, lower-case).
 
 ```ts
-import { translitUrl } from '@rshval/back-kit'
+import { translitUrl } from '@rshval/back-kit';
 
-const slug = translitUrl('Пример страницы')
+const slug = translitUrl('Page example');
 // primer-stranicy
 ```
 
 ---
 
-### 4) Валидация
+### 4) Validation
 
 #### `patternEmail()`
-Возвращает RegExp для проверки email.
+
+Returns a RegExp for email validation.
 
 #### `patternPassword()`
-Возвращает RegExp для пароля (минимум 8 символов, буквы + цифры).
+
+Returns a RegExp for password validation (at least 8 chars, letters + digits).
 
 #### `isValidEmail(val)`
-Проверяет корректность email.
+
+Checks whether an email is valid.
 
 #### `isValidPhoneNumber(val)`
-Проверяет номер телефона через `libphonenumber-js`.
+
+Validates a phone number via `libphonenumber-js`.
 
 #### `isValidCode(code, length)`
-Проверяет длину кода.
+
+Checks code length.
 
 #### `isEmpty(val)`
-Проверяет пустую строку (`trim`) или пустой объект.
+
+Checks for an empty string (`trim`) or an empty object.
 
 ```ts
 import {
@@ -151,152 +190,196 @@ import {
   isValidEmail,
   isValidPhoneNumber,
   isValidCode,
-  isEmpty
-} from '@rshval/back-kit'
+  isEmpty,
+} from '@rshval/back-kit';
 
-const emailRegex = patternEmail()
-const passwordRegex = patternPassword()
+const emailRegex = patternEmail();
+const passwordRegex = patternPassword();
 
-isValidEmail('user@example.com') // true
-isValidPhoneNumber('+79991234567') // true/false
-isValidCode('123456', 6) // true
-isEmpty('   ') // true
-isEmpty({}) // true
+isValidEmail('user@example.com'); // true
+isValidPhoneNumber('+79991234567'); // true/false
+isValidCode('123456', 6); // true
+isEmpty('   '); // true
+isEmpty({}); // true
 ```
 
 ---
 
-### 5) Билдеры (привязка к конфигу)
+### 5) Builders (config-bound)
 
 #### `buildGetBaseUrl(config)`
-Возвращает функцию `(baseUrl?) => string`.
+
+Returns a function `(baseUrl?) => string`.
 
 #### `buildCreateToken(config)`
-Возвращает функцию создания JWT с уже «зашитым» конфигом.
+
+Returns a JWT creator function with pre-bound config.
 
 #### `buildSendEmail(nodemailerConfig)`
-Возвращает функцию отправки email с уже «зашитым» SMTP-конфигом.
+
+Returns an email sender function with pre-bound SMTP config.
 
 ```ts
 import {
   buildGetBaseUrl,
   buildCreateToken,
-  buildSendEmail
-} from '@rshval/back-kit'
+  buildSendEmail,
+} from '@rshval/back-kit';
 
 const getBaseUrl = buildGetBaseUrl({
   NODE_ENV: 'production',
   server: { domain: 'example.com' },
-  jwt: { JWT_KEY: 'secret' }
-})
+  jwt: { JWT_KEY: 'secret' },
+});
 
 const createToken = buildCreateToken({
   server: { domain: 'example.com' },
-  jwt: { JWT_KEY: 'secret' }
-})
+  jwt: { JWT_KEY: 'secret' },
+});
 
 const sendEmail = buildSendEmail({
   host: 'smtp.example.com',
   port: 465,
   secure: true,
-  auth: { user: 'robot@example.com', pass: '***' }
-})
+  auth: { user: 'robot@example.com', pass: '***' },
+});
 ```
 
 ---
 
-### 6) База данных
+### 6) Database
 
 #### `startMongoDatabase(options)`
-Запускает подключение к MongoDB через mongoose, логирует статусы и умеет ретраить подключение.
+
+Starts MongoDB connection via mongoose, logs statuses, and supports connection retries.
 
 ```ts
-import { startMongoDatabase } from '@rshval/back-kit'
+import { startMongoDatabase } from '@rshval/back-kit';
 
 await startMongoDatabase({
   config: {
     name: 'main',
     connect: process.env.MONGO_URI,
-    params: {}
+    params: {},
   },
-  logger: console
-})
+  logger: console,
+});
+```
+
+**Production example**:
+
+```ts
+await startMongoDatabase({
+  config: config.database,
+  logger,
+  setCacheStatus: (status) =>
+    cache.set(cacheIdDatabase, { status }, undefined, undefined, cacheTtl30m),
+});
 ```
 
 ---
 
-### 7) Кэш
+### 7) Cache
 
 #### `createCacheService(options?)`
-Создаёт LRU cache-сервис с методами:
+
+Creates an LRU cache service with methods:
+
 - `get(key)`
 - `set(key, data, compareKey?, compareValue?, ttlMs?)`
 - `delete(key)`
 - `getId(val)`
 - `keys()`
 - `clear()`
-- `entries()` *(если `exposeEntries: true`)*
-- `values()` *(если `exposeValues: true`)*
+- `entries()` _(if `exposeEntries: true`)_
+- `values()` _(if `exposeValues: true`)_
 
 ```ts
-import { createCacheService } from '@rshval/back-kit'
+import { createCacheService } from '@rshval/back-kit';
 
-const cache = createCacheService({ ttl: 60_000 })
-const key = cache.getId({ service: 'users', page: 1 })
-await cache.set(key, [{ s: 'state', data: [1, 2, 3] }])
-const value = await cache.get(key)
+const cache = createCacheService({ ttl: 60_000 });
+const key = cache.getId({ service: 'users', page: 1 });
+await cache.set(key, [{ s: 'state', data: [1, 2, 3] }]);
+const value = await cache.get(key);
 ```
 
 #### `createCacheMiddleware({ cache, ... })`
-Создаёт middleware-обёртку над cache-сервисом с методами:
+
+Creates a middleware wrapper over the cache service with methods:
+
 - `get(id)`
 - `set(id, data, expDataTime)`
 - `del(id)`
-- `delByPrefix(prefix)` *(если `includeDelByPrefix: true`)*
+- `delByPrefix(prefix)` _(if `includeDelByPrefix: true`)_
 
 ```ts
-import { createCacheService, createCacheMiddleware } from '@rshval/back-kit'
+import { createCacheService, createCacheMiddleware } from '@rshval/back-kit';
 
-const cache = createCacheService({ supportTtlInSet: true })
+const cache = createCacheService({ supportTtlInSet: true });
 const cm = createCacheMiddleware({
   cache,
   passTtlToCacheSet: true,
-  includeDelByPrefix: true
-})
+  includeDelByPrefix: true,
+});
 
-await cm.set('users:list', [{ id: 1 }], 60_000)
-const cached = await cm.get('users:list')
-await cm.delByPrefix?.('users:')
+await cm.set('users:list', [{ id: 1 }], 60_000);
+const cached = await cm.get('users:list');
+await cm.delByPrefix?.('users:');
+```
+
+**Production example**:
+
+```ts
+const cache = createCacheService({ supportTtlInSet: true });
+const cacheMiddleware = createCacheMiddleware({
+  cache,
+  passTtlToCacheSet: true,
+  includeDelByPrefix: true,
+});
+
+export const { get, set, del } = cacheMiddleware;
+export const delByPrefix = cacheMiddleware.delByPrefix!;
 ```
 
 ---
 
-### 8) Логирование
+### 8) Logging
 
 #### `createLoggerService({ rootdir? })`
-Возвращает фабрику логгеров. Для каждого namespace (`std`) пишет:
+
+Returns a logger factory. For each namespace (`std`) it writes:
+
 - `logs/<std>/stdout.log`
 - `logs/<std>/stderr.log`
 
 ```ts
-import { createLoggerService } from '@rshval/back-kit'
+import { createLoggerService } from '@rshval/back-kit';
 
-const makeLogger = createLoggerService({ rootdir: process.cwd() })
-const logger = makeLogger('api')
-logger.log('started')
+const makeLogger = createLoggerService({ rootdir: process.cwd() });
+const logger = makeLogger('api');
+logger.log('started');
+```
+
+**Production example**:
+
+```ts
+const loggerService = createLoggerService();
+const logger = loggerService('api');
 ```
 
 ---
 
-### 9) WebSocket клиент
+### 9) WebSocket client
 
 #### `createSocketClientService(options)`
-Создаёт сервис клиента `socket.io` с методами:
-- `doSocketClient()` — старт подключения
-- `getSocketClient()` — вернуть текущий инстанс
+
+Creates a `socket.io` client service with methods:
+
+- `doSocketClient()` — start connection
+- `getSocketClient()` — return current instance
 
 ```ts
-import { createSocketClientService } from '@rshval/back-kit'
+import { createSocketClientService } from '@rshval/back-kit';
 
 const ws = createSocketClientService({
   wsName: 'worker',
@@ -304,10 +387,24 @@ const ws = createSocketClientService({
   logger: console,
   runWorkers: () => {
     // jobs
-  }
-})
+  },
+});
+
+ws.doSocketClient();
+```
 
-ws.doSocketClient()
+**Production example**:
+
+```ts
+const socketClientService = createSocketClientService({
+  wsName: config.ws.name,
+  socketBase: SOCKET_BASE,
+  logger,
+  runWorkers: socketClientWorkers,
+  socketClientInterval: config.settings.socketClientInterval,
+});
+
+socketClientService.doSocketClient();
 ```
 
 ---
@@ -315,44 +412,58 @@ ws.doSocketClient()
 ### 10) Paymaster
 
 #### `createPaymasterService({ paymaster, clientServer, serverBaseUrl })`
-Создаёт сервис с методами:
-- `createPaymentLink({...})` — сформировать ссылку на оплату
-- `validateCallback(payload, rawBody?)` — проверить подпись callback
-- `parseCallback(payload)` — нормализовать callback в удобный объект
+
+Creates a service with methods:
+
+- `createPaymentLink({...})` — build payment URL
+- `validateCallback(payload, rawBody?)` — verify callback signature
+- `parseCallback(payload)` — normalize callback into a convenient object
 
 ```ts
-import { createPaymasterService } from '@rshval/back-kit'
+import { createPaymasterService } from '@rshval/back-kit';
 
 const paymaster = createPaymasterService({
   paymaster: {
     merchantId: 'merchant-id',
     secretKey: 'secret',
     checkoutUrl: 'https://paymaster.ru/Payment/Init',
-    checkSignature: true
+    checkSignature: true,
   },
   clientServer: 'https://site.example.com',
-  serverBaseUrl: 'https://api.example.com'
-})
+  serverBaseUrl: 'https://api.example.com',
+});
 
 const link = paymaster.createPaymentLink({
   requestId: 'order_123',
   amount: 1499,
-  description: 'Order #123'
-})
+  description: 'Order #123',
+});
+```
+
+**Production example**:
+
+```ts
+export const paymasterService = createPaymasterService({
+  paymaster: config.platforms.paymaster,
+  clientServer: config.clientServer,
+  serverBaseUrl: config.server.baseUrl,
+});
 ```
 
 ---
 
-### 11) Почтовые шаблоны
+### 11) Mail templates
 
 #### `createMailTemplateService({ findTemplate, sendEmail })`
-Создаёт сервис шаблонов email с методами:
-- `extractVariables(template)` — список `{{variables}}`
-- `renderTemplate(template, context?)` — рендер subject/body
-- `sendByKey({ key, to, context? })` — найти шаблон, отрендерить и отправить
+
+Creates an email template service with methods:
+
+- `extractVariables(template)` — list of `{{variables}}`
+- `renderTemplate(template, context?)` — render subject/body
+- `sendByKey({ key, to, context? })` — find template, render, and send
 
 ```ts
-import { createMailTemplateService } from '@rshval/back-kit'
+import { createMailTemplateService } from '@rshval/back-kit';
 
 const mailTemplates = createMailTemplateService({
   findTemplate: async ({ key }) =>
@@ -360,36 +471,49 @@ const mailTemplates = createMailTemplateService({
       ? { subject: 'Hi, {{user.name}}', bodyText: 'Hello {{user.name}}!' }
       : null,
   sendEmail: async (to, subject, text) => {
-    console.log('send', to, subject, text)
-  }
-})
+    console.log('send', to, subject, text);
+  },
+});
 
 await mailTemplates.sendByKey({
   key: 'welcome',
   to: 'user@example.com',
-  context: { user: { name: 'Alex' } }
-})
+  context: { user: { name: 'Alex' } },
+});
+```
+
+**Production example**:
+
+```ts
+const sendEmailWithConfig = buildSendEmail(runtimeConfig);
+
+export const mailTemplateService = createMailTemplateService({
+  findTemplate: ({ key }) => MailTemplate.findOne({ key, isActive: true }),
+  sendEmail: sendEmailWithConfig,
+});
 ```
 
 ---
 
-### 12) Аудит изменений
+### 12) Audit changes
 
 #### `buildAuditChanges({ beforeData, afterData, fieldsToCheck, protectedFields? })`
-Сравнивает данные «до/после» и возвращает массив изменений по выбранным полям.
+
+Compares before/after data and returns an array of changes for selected fields.
 
 #### `createAuditLog({ ..., save })`
-Создаёт запись аудита через переданную функцию `save`. Если изменений нет — возвращает `null`.
+
+Creates an audit record via provided `save` function. Returns `null` when no changes exist.
 
 ```ts
-import { buildAuditChanges, createAuditLog } from '@rshval/back-kit'
+import { buildAuditChanges, createAuditLog } from '@rshval/back-kit';
 
 const changes = buildAuditChanges({
   beforeData: { name: 'Old', role: 'user' },
   afterData: { name: 'New', role: 'user' },
   fieldsToCheck: ['name', 'role'],
-  protectedFields: ['role']
-})
+  protectedFields: ['role'],
+});
 
 await createAuditLog({
   entityType: 'user',
@@ -397,34 +521,60 @@ await createAuditLog({
   action: 'update',
   changedBy: '507f191e810c19729de860ea',
   changes,
-  save: async (payload) => payload
-})
+  save: async (payload) => payload,
+});
+```
+
+**Production example**:
+
+```ts
+await createAuditLog({
+  entityType,
+  entityId,
+  action,
+  changedBy,
+  changes,
+  meta,
+  save: async (payload) => AuditLog.create(payload),
+});
 ```
 
 ---
 
-### 13) Seed-функции
+### 13) Seed functions
 
 #### `createSeedFunctions({ cache, retryDelayMs? })`
-Возвращает методы:
-- `checkDatabaseIsConnected()` — проверяет состояние БД через кэш
-- `setSeedData(SeedModel, arr)` — добавляет seed-данные после подтверждения подключения
+
+Returns methods:
+
+- `checkDatabaseIsConnected()` — checks DB state via cache
+- `setSeedData(SeedModel, arr)` — inserts seed data after connection check
 
 ```ts
-import { createSeedFunctions, createCacheService } from '@rshval/back-kit'
+import { createSeedFunctions, createCacheService } from '@rshval/back-kit';
 
-const cache = createCacheService()
-const { setSeedData } = createSeedFunctions({ cache })
+const cache = createCacheService();
+const { setSeedData } = createSeedFunctions({ cache });
 
 // await setSeedData(UserModel, [{ name: 'Admin' }])
 ```
 
+**Production example**:
+
+```ts
+export const { checkDatabaseIsConnected, setSeedData } = createSeedFunctions({
+  cache,
+});
+```
+
 ---
 
-### 14) API-клиент
+### 14) API client
 
 #### `createApiService({ userAgent, logger? })`
-Возвращает HTTP-клиент с методами:
+
+Returns an HTTP client with methods:
+
 - `get(path, token?)`
 - `getXml(path, token?)`
 - `del(path, token?)`
@@ -432,53 +582,77 @@ const { setSeedData } = createSeedFunctions({ cache })
 - `put(path, data, token)`
 
 ```ts
-import { createApiService } from '@rshval/back-kit'
+import { createApiService } from '@rshval/back-kit';
 
-const api = createApiService({ userAgent: 'my-service/1.0.0', logger: console })
+const api = createApiService({
+  userAgent: 'my-service/1.0.0',
+  logger: console,
+});
 
-const users = await api.get('https://api.example.com/users')
-const created = await api.post('https://api.example.com/users', { name: 'Alex' })
+const users = await api.get('https://api.example.com/users');
+const created = await api.post('https://api.example.com/users', {
+  name: 'Alex',
+});
 ```
 
-Также экспортируется тип токена:
+**Production example**:
 
 ```ts
-import type { Token } from '@rshval/back-kit'
+const apiService = createApiService({
+  userAgent: config.api.userAgent,
+  logger,
+});
+
+export const { get, getXml, del, post, put } = apiService;
+```
+
+Token type is also exported:
+
+```ts
+import type { Token } from '@rshval/back-kit';
 ```
 
 ---
 
-### 15) Прочие экспортированные утилиты
+### 15) Other exported utilities
 
 #### `add(a, b)`
-Возвращает сумму двух чисел.
+
+Returns the sum of two numbers.
 
 #### `test2()`
-Логирует `99` и возвращает `8`.
+
+Logs `99` and returns `8`.
 
 ```ts
-import { add, test2 } from '@rshval/back-kit'
+import { add, test2 } from '@rshval/back-kit';
 
-add(2, 3) // 5
-test2() // 8
+add(2, 3); // 5
+test2(); // 8
 ```
 
 ---
 
-## Подготовка к публикации в npm
+## Preparing for npm publication
+
+See detailed guide: [`docs/publishing.md`](docs/publishing.md).
+
+Short wording for npm description:
 
-См. подробную инструкцию: [`docs/publishing.md`](docs/publishing.md).
+- A set of service factories (`create*`, `build*`) and ready-to-use utilities/validators.
+- DI-friendly API: dependencies are injected externally (`logger`, `cache`, `save`, `findTemplate`).
+- Important behavior options (`supportTtlInSet`, `passTtlToCacheSet`, `includeDelByPrefix`) should be documented near examples.
 
 ---
 
-## Разработка (standalone)
+## Development (standalone)
 
 ```bash
 npm install
 npm run build
 ```
 
-## Экспорты
+## Exports
 
 - ESM: `dist/index.js`
-- Типы: `dist/index.d.ts`
+- Types: `dist/index.d.ts`

package/dist/seed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoB,KAAK,EAAE,MAAM,UAAU,CAAC;AAExD,UAAU,gBAAgB;IACxB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAC;IAC1C,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACpC;AAED,UAAU,0BAA0B;IAClC,KAAK,EAAE,gBAAgB,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,mBAAmB,GAAI,0BAGjC,0BAA0B;;6BAwBd,OAAO,KAAK,OAClB,MAAM,EAAE,KACZ,OAAO,CAAC,IAAI,CAAC;CAkDjB,CAAC"}
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoB,KAAK,EAAE,MAAM,UAAU,CAAC;AAExD,UAAU,gBAAgB;IACxB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAC;IAC1C,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACpC;AAED,UAAU,0BAA0B;IAClC,KAAK,EAAE,gBAAgB,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,mBAAmB,GAAI,0BAGjC,0BAA0B;;6BAwBd,OAAO,KAAK,OAClB,MAAM,EAAE,KACZ,OAAO,CAAC,IAAI,CAAC;CAmDjB,CAAC"}

package/dist/seed.js

@@ -20,7 +20,10 @@ export const createSeedFunctions = ({ cache, retryDelayMs = 1000, }) => {
     const setSeedData = async (SeedModel, arr) => {
         const databaseIsConnected = await checkDatabaseIsConnected();
         if (databaseIsConnected) {
-            const spinner = ora(chalk.gray('add seed data - ' + SeedModel.modelName)).start();
+            const spinner = ora({
+                text: chalk.gray('add seed data - ' + SeedModel.modelName),
+                stream: process.stdout,
+            }).start();
             const arrs = [];
             let done2 = 0;
             for (let i = 0; i < arr.length; i++) {

package/dist/seed.js.map

@@ -1 +1 @@
-{"version":3,"file":"seed.js","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AAatB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,EAClC,KAAK,EACL,YAAY,GAAG,IAAI,GACQ,EAAE,EAAE;IAC/B,MAAM,wBAAwB,GAAG,KAAK,IAAI,EAAE;QAC1C,MAAM,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC;YAClC,OAAO,EAAE,UAAU;SACpB,CAAC,CAAC;QAEH,IAAI,kBAAuB,CAAC;QAE5B,IAAI,eAAe,EAAE,CAAC;YACpB,kBAAkB,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACxD,CAAC;QAED,IACE,kBAAkB;YAClB,kBAAkB,CAAC,MAAM;YACzB,kBAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,EAC5C,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,EACvB,SAAuB,EACvB,GAAa,EACE,EAAE;QACjB,MAAM,mBAAmB,GAAG,MAAM,wBAAwB,EAAE,CAAC;QAE7D,IAAI,mBAAmB,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,GAAG,CACjB,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC,SAAS,CAAC,CACrD,CAAC,KAAK,EAAE,CAAC;YAIV,MAAM,IAAI,GAAU,EAAE,CAAC;YACvB,IAAI,KAAK,GAAG,CAAC,CAAC;YAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpC,MAAM,GAAG,GAAQ,MAAM,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAEf,IAAI,EAAE,KAAK,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;oBAC3B,IAAI,IAAI,GAAG,CAAC,CAAC;oBAEb,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;wBACxB,MAAM,IAAI;6BACP,IAAI,EAAE;6BACN,IAAI,CAAC,GAAG,EAAE;4BACT,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;gCAC3B,OAAO,IAAI,CAAC;4BACd,CAAC;wBACH,CAAC,CAAC;6BACD,KAAK,CAAC,GAAG,EAAE;4BACV,OAAO,IAAI,CAAC;wBACd,CAAC,CAAC,CAAC;oBACP,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC;YACxE,OAAO,CAAC,OAAO,EAAE,CAAC;YAElB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;QAE1B,OAAO,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC;IAEF,OAAO;QACL,wBAAwB;QACxB,WAAW;KACZ,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AAatB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,EAClC,KAAK,EACL,YAAY,GAAG,IAAI,GACQ,EAAE,EAAE;IAC/B,MAAM,wBAAwB,GAAG,KAAK,IAAI,EAAE;QAC1C,MAAM,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC;YAClC,OAAO,EAAE,UAAU;SACpB,CAAC,CAAC;QAEH,IAAI,kBAAuB,CAAC;QAE5B,IAAI,eAAe,EAAE,CAAC;YACpB,kBAAkB,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACxD,CAAC;QAED,IACE,kBAAkB;YAClB,kBAAkB,CAAC,MAAM;YACzB,kBAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,EAC5C,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,EACvB,SAAuB,EACvB,GAAa,EACE,EAAE;QACjB,MAAM,mBAAmB,GAAG,MAAM,wBAAwB,EAAE,CAAC;QAE7D,IAAI,mBAAmB,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,GAAG,CAAC;gBAClB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC,SAAS,CAAC;gBAC1D,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC,KAAK,EAAE,CAAC;YAIX,MAAM,IAAI,GAAU,EAAE,CAAC;YACvB,IAAI,KAAK,GAAG,CAAC,CAAC;YAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpC,MAAM,GAAG,GAAQ,MAAM,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAEf,IAAI,EAAE,KAAK,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;oBAC3B,IAAI,IAAI,GAAG,CAAC,CAAC;oBAEb,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;wBACxB,MAAM,IAAI;6BACP,IAAI,EAAE;6BACN,IAAI,CAAC,GAAG,EAAE;4BACT,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;gCAC3B,OAAO,IAAI,CAAC;4BACd,CAAC;wBACH,CAAC,CAAC;6BACD,KAAK,CAAC,GAAG,EAAE;4BACV,OAAO,IAAI,CAAC;wBACd,CAAC,CAAC,CAAC;oBACP,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC;YACxE,OAAO,CAAC,OAAO,EAAE,CAAC;YAElB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;QAE1B,OAAO,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC;IAEF,OAAO;QACL,wBAAwB;QACxB,WAAW;KACZ,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rshval/back-kit",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
@@ -25,7 +25,7 @@
   },
   "author": "",
   "license": "MIT",
-  "description": "Backend utilities for Node.js services used in rshval monorepos",
+  "description": "Backend toolkit of service factories (create*/build*), validators and Node.js API utilities with DI-friendly patterns",
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
     "@types/jsonwebtoken": "^9.0.10",