@pcg/core 1.0.0-alpha.1 → 1.0.0-alpha.2

package/dist/index.d.ts

@@ -1,966 +1,11 @@
-import { ArgumentsHost, ConsoleLogger, DynamicModule, HttpException, HttpServer, HttpStatus, LogLevel, LoggerService, OnModuleInit, Provider, Type, ValidationError, ValidationPipe } from "@nestjs/common";
-import { BaseEntity, DataSource, EntityManager, LogLevel as LogLevel$1, LogMessage, ObjectLiteral, Repository, SelectQueryBuilder } from "typeorm";
-import * as _nestjs_config0 from "@nestjs/config";
-import { isObject } from "@pcg/predicates";
-import { AbstractLogger } from "typeorm/logger/AbstractLogger.js";
-import * as winston from "winston";
-import { LogEntry, Logger as Logger$1, LoggerOptions } from "winston";
-import { ActionScopes, ActionScopesArray, IUser } from "@pcg/auth";
-import { LoggerOptions as LoggerOptions$1 } from "typeorm/logger/LoggerOptions.js";
-import { ModuleMetadata } from "@nestjs/common/interfaces";
-import { Format } from "logform";
-import { PostgresConnectionOptions } from "typeorm/driver/postgres/PostgresConnectionOptions.js";
+import { ObjectLiteral, SelectQueryBuilder } from "typeorm";
+import { Type } from "@nestjs/common";
+import { CurrentUser } from "#/context/current-user";
 import { Request } from "express";
+import { MaybeNull } from "#/types/maybe";
 
-//#region src/enums/app-env.enum.d.ts
-/**
- * Application environment enum
- */
-declare enum AppEnv {
-  /**
-   * Local environment.
-   * Used for local development on your machine.
-   */
-  LOCAL = "local",
-  /**
-   * Test environment.
-   * Used when running tests.
-   */
-  TEST = "test",
-  /**
-   * Development environment.
-   * Used when deploying to a development server.
-   * Development server provide early access to new features.
-   */
-  DEVELOPMENT = "development",
-  /**
-   * Stage environment.
-   * Used when deploying to a stage server.
-   * Stage is a pre-production environment.
-   */
-  STAGE = "stage",
-  /**
-   * Production environment.
-   * Used when deploying to a production server.
-   */
-  PRODUCTION = "production",
-}
-//#endregion
-//#region src/enums/app-mode.enum.d.ts
-declare enum AppMode {
-  STANDALONE = "standalone",
-  PARENT = "parent",
-  CHILD = "child",
-}
-//#endregion
-//#region src/configs/app.config.d.ts
-/**
- * NestJS injection token for app config
- */
-declare const APP_CONFIG_TOKEN = "APP_CONFIG_TOKEN";
-declare const InjectAppConfig: () => PropertyDecorator & ParameterDecorator;
-/**
- * Application config environment variables
- */
-declare class AppConfigEnvironmentVariables {
-  /**
-   * Application port
-   * @example
-   * ```yaml
-   * PORT: 3000
-   * ```
-   */
-  PORT: number;
-  /**
-   * Application host
-   * @example
-   * ```yaml
-   * APP_HOST: 'https://app-api.example.com'
-   * # or
-   * APP_HOST: 'http://localhost:3000'
-   * ```
-   */
-  APP_HOST: string;
-  /**
-   * Application UI host
-   * @example
-   * ```yaml
-   * APP_UI_HOST: 'https://app.example.com'
-   * # or
-   * APP_UI_HOST: 'http://localhost:4200'
-   * ```
-   */
-  APP_UI_HOST: string;
-  /**
-   * Application environment. Can be 'local', 'development', 'stage', 'production'
-   * @example
-   * ```yaml
-   * APP_ENV: 'local'
-   * ```
-   */
-  APP_ENV: AppEnv;
-  /**
-   * Application service account id (user with type SA in users table)
-   * @example
-   * ```yaml
-   * APP_SERVICE_ACCOUNT_ID: 'hcu:xxxxxxxxxxx'
-   * ```
-   */
-  APP_SERVICE_ACCOUNT_ID?: string;
-  /**
-   * Application fallback language
-   * @example
-   * ```yaml
-   * FALLBACK_LANGUAGE: 'es'
-   * ```
-   */
-  FALLBACK_LANGUAGE: string;
-}
-interface AppConfigType {
-  /**
-   * Application environment
-   * @example 'local', 'development', 'stage', 'production'
-   */
-  env: AppEnv;
-  /**
-   * Application name
-   * @example 'Jetstream'
-   */
-  name: string;
-  /**
-   * Application shortname
-   * @example 'js'
-   */
-  shortname: string;
-  /**
-   * Application port
-   * @example 3000
-   */
-  port: number;
-  /**
-   * Application mode
-   * @example 'standalone'
-   */
-  mode: AppMode;
-  /**
-   * Application host
-   * @example 'https://app-api.example.com or http://localhost:3000'
-   */
-  host?: string;
-  /**
-   * Application UI host
-   * @example 'https://app.example.com or http://localhost:8080'
-   */
-  uiHost?: string;
-  /**
-   * Application fallback language
-   * @example 'en'
-   */
-  fallbackLanguage: string;
-  /**
-   * Application service account id (user with type SA in users table)
-   * @example 'hcu:xxxxxxxxxxx'
-   */
-  appServiceAccountId?: string;
-}
-interface AppConfigOptions {
-  name: string;
-  shortname: string;
-  mode?: AppMode;
-}
-/**
- * Create Main Application Config
- * @example
- * ```ts
- * // src/config/index.ts
- *
- * import { createAppConfig } from '#/dist/configs';
- *
- * export const appConfig = createAppConfig({
- *  name: 'Jetstream',
- *  shortname: 'js',
- * });
- * ```
- */
-declare const createAppConfig: (opts: AppConfigOptions) => (() => AppConfigType) & _nestjs_config0.ConfigFactoryKeyHost<AppConfigType>;
-//#endregion
-//#region src/modules/id/id.service.d.ts
-/**
- * An IdService is a service within your application that provides methods to generate unique IDs
- * for entities and other data objects.
- */
-declare class IdService {
-  private readonly appConfig;
-  constructor(appConfig: AppConfigType);
-  /**
-   * Returns a delimiter string based on the current environment.
-   * This delimiter is used in constructing the entity IDs.
-   * The delimiter is ':dev:' for development environments,
-   * :stage:' for staging environments and ':' for other environments.
-   *
-   * This allows for better differentiation and traceability of entities across various environments.
-   */
-  get delimiter(): ":test:" | ":dev:" | ":stage:" | ":";
-  /**
-   * Generates unique id for entity
-   * @param prefix - entity id prefix in database (e.g. 'u' for users)
-   * @param app - app shortname (e.g. 'js')
-   * @returns id in format 'jsu:xxxxxxxxxxx' or 'jsu:stage:xxxxxxxxxxx' for staging environment
-   */
-  generateEntityId(prefix: string, app?: string): string;
-  /**
-   * Generates unique id with length 11
-   * @returns id in format 'xxxxxxxxxxx'
-   */
-  generateId(size?: number): string;
-}
-//#endregion
-//#region src/types/maybe.d.ts
-type MaybeNull<T> = T | null;
-//#endregion
-//#region src/context/current-user.d.ts
-interface CurrentUser extends IUser {
-  /**
-   * User email address
-   * @example
-   * ```ts
-   * 'john.doe@example.com'
-   * ```
-   */
-  email: string;
-  /**
-   * User's first name
-   * @example
-   * ```ts
-   * 'John'
-   * ```
-   */
-  firstName: string;
-  /**
-   * User's last name
-   * @example
-   * ```ts
-   * 'Doe'
-   * ```
-   */
-  lastName: string;
-  /**
-   * User's full name
-   * @example
-   * ```ts
-   * 'John Doe'
-   * ```
-   */
-  fullName: string;
-  /**
-   * Indicates who logged in as this user
-   * @example
-   * ```ts
-   * 'hcu:78thsjvx24hrx' // ID of user who impersonated this user
-   * ```
-   */
-  impersonatedByUserId?: string | null;
-}
-//#endregion
-//#region src/context/service-method-context.d.ts
-/**
- * Context object for base service methods.
- */
-interface BaseServiceMethodContext {
-  /**
-   * The current user making the request.
-   */
-  user: CurrentUser;
-  /**
-   * An optional request ID.
-   */
-  requestId?: string;
-  /**
-   * Make the request silent, meaning no notifications and actions will be sent.
-   */
-  isSilent?: boolean;
-  /**
-   * Checks if the user has permission to perform the specified action.
-   * @param action The action to check permission for.
-   * @param actionScopes Optional scopes to check permission against.
-   * @returns True if the user has permission, false otherwise.
-   */
-  isGranted(action: string, actionScopes?: ActionScopes | ActionScopesArray): boolean;
-  /**
-   * Check permission and throw AccessDenied error if user doesn't have permission
-   * @param action - action string
-   * @param scopes - scopes where action was executed
-   * @throws AccessDenied error if the user doesn't have the permission
-   */
-  validateAccess(action: string, scopes?: ActionScopes | ActionScopesArray): void;
-  /**
-   * Check permission and throw AccessDenied error if user doesn't have permission
-   * @param action - action string
-   * @param actionScopes - scopes where action was executed
-   * @throws AccessDenied error if the user doesn't have the permission
-   */
-  transaction?: EntityManager;
-}
-//#endregion
-//#region src/logger/classes/nest-system-logger.d.ts
-declare class NestSystemLogger extends ConsoleLogger {
-  private readonly logger;
-  protected printMessages(messages: unknown[], context?: string | undefined, logLevel?: LogLevel | undefined): void;
-  protected stringifyMessage(message: unknown): string;
-  private getWinstonLogLevel;
-}
-//#endregion
-//#region src/context/action-context.d.ts
-/**
- * GraphQL base action context
- * Used for mutations and queries
- */
-interface IBaseActionContext {
-  /**
-   * Request ID
-   * Used for logging to track request
-   */
-  requestId: string;
-  /**
-   * Current user who executes action
-   */
-  user: CurrentUser;
-  /**
-   * Check if current user from context has permission
-   * @param action - action string
-   * @param actionScopes - scopes where action was executed
-   */
-  isGranted(action: string, actionScopes?: ActionScopes | ActionScopesArray): boolean;
-  /**
-   * Check permission and throw AccessDenied error if user doesn't have permission
-   * @param action - action string
-   * @param scopes - scopes where action was executed
-   * @throws AccessDenied error if the user doesn't have the permission
-   */
-  validateAccess(action: string, scopes?: ActionScopes | ActionScopesArray): void;
-}
-//#endregion
-//#region src/context/platform-method-context.d.ts
-interface BasePlatformMethodContext extends BaseServiceMethodContext {
-  organizationId: string;
-}
-//#endregion
-//#region src/errors/nest-error.d.ts
-/**
- * Configuration options for creating a NestError instance.
- *
- * @interface NestErrorOptions
- */
-interface NestErrorOptions {
-  /** The human-readable error message describing what went wrong */
-  message: string;
-  /**
-   * A unique identifier or error code for categorizing and handling the error
-   * @example
-   * 'AUTH_USER_NOT_FOUND'
-   * */
-  key: string;
-  /** The underlying error that caused this error, if any */
-  cause?: unknown;
-  /** Additional contextual information related to the error occurrence */
-  context?: Record<string, unknown>;
-  /**
-   * Whether the error should be silenced (i.e., not logged or reported)
-   */
-  silent?: boolean;
-}
-/**
- * Custom error class for NestJS applications that extends the native Error class.
- *
- * This error class provides additional context and structured error handling
- * capabilities beyond the standard Error object.
- *
- * @example
- * ```typescript
- * throw new NestError({
- *   key: 'AUTH_USER_NOT_FOUND',
- *   message: 'User with the specified ID was not found',
- *   context: { userId: '123' },
- *   cause: originalError
- * });
- * ```
- */
-declare class NestError extends Error {
-  key: string;
-  context?: Record<string, unknown>;
-  httpStatusCode: HttpStatus;
-  silent: boolean;
-  constructor(opts: NestErrorOptions);
-}
-//#endregion
-//#region src/errors/forbidden.error.d.ts
-declare class ForbiddenError extends NestError {
-  constructor(opts: NestErrorOptions);
-}
-//#endregion
-//#region src/errors/access-denied.error.d.ts
-interface AccessDeniedErrorOptions {
-  action: string;
-  context: Record<string, unknown>;
-  message?: string;
-}
-declare class AccessDeniedError extends ForbiddenError {
-  constructor(opts: AccessDeniedErrorOptions);
-}
-//#endregion
-//#region src/errors/bad-request.error.d.ts
-declare class BadRequestError extends NestError {
-  constructor(opts: NestErrorOptions);
-}
-//#endregion
-//#region src/errors/input-validation.error.d.ts
-declare class InputValidationError extends NestError {
-  constructor(errors?: ValidationError[]);
-}
-//#endregion
-//#region src/errors/not-found.error.d.ts
-declare class NotFoundError extends NestError {
-  constructor(opts: NestErrorOptions);
-}
-//#endregion
-//#region src/errors/unauthorized.error.d.ts
-declare class UnauthorizedError extends NestError {
-  constructor(opts: NestErrorOptions);
-}
-//#endregion
-//#region src/logger/logger.interfaces.d.ts
-type LoggerModuleOptions = LoggerOptions;
-type WinstonLogLevel = 'error' | 'warn' | 'info' | 'http' | 'verbose' | 'debug' | 'silly';
-/**
- * Logger logger context with specific data for logging
- */
-interface LoggerContext {
-  /**
-   * Scope where the message was logged
-   * @example 'VideoService'
-   */
-  scope?: string;
-  /**
-   * Action where the message was logged
-   * @example 'createOutput'
-   */
-  action?: string;
-  /**
-   * Request ID
-   * Special marker to identify request in logs
-   */
-  requestId?: string;
-  /**
-   * Additional data
-   */
-  [key: string]: unknown;
-}
-interface InfoObject extends LoggerContext {
-  message: string;
-}
-interface LoggerModuleOptionsFactory {
-  createLoggerModuleOptions(): Promise<LoggerModuleOptions> | LoggerModuleOptions;
-}
-interface LoggerModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
-  useFactory?: (...args: any[]) => Promise<LoggerModuleOptions> | LoggerModuleOptions;
-  inject?: any[];
-  useClass?: Type<LoggerModuleOptionsFactory>;
-}
-/**
- * Error object that is destructured and logged by Logger
- */
-interface DestructuredError {
-  /**
-   * Error message text
-   */
-  message?: string;
-  /**
-   * Error stack from Error object (`Error.stack`)
-   */
-  stack?: string;
-  /**
-   * Error key from 'enum'
-   * @example 'NST_SA_EMAIL_NOT_UNIQUE'
-   */
-  errorKey?: string;
-  /**
-   * HTTP status code
-   * @example 400
-   */
-  statusCode?: number;
-  /**
-   * Child error.
-   */
-  cause?: DestructuredError;
-  /**
-   * Error context (additional data)
-   */
-  context?: LoggerContext;
-  /**
-   * Response body if error is HTTPError
-   */
-  body?: unknown;
-}
-//#endregion
-//#region src/logger/classes/logger.d.ts
-/**
- * Logger with context for NestJS (from NestKit)
- */
-declare class Logger {
-  private readonly winstonLogger;
-  private context;
-  constructor(winstonLogger: Logger$1, context?: LoggerContext);
-  /**
-   * Created child logger with specific context
-   * @param context - object with scope, action and other data
-   * @returns - new logger with context
-   * @example
-   * ```ts
-   * class SomeService {
-   *  logger: Logger;
-   *
-   *  constructor(
-   *   @InjectLoggerFactory() private readonly loggerFactory: LoggerFactory,
-   * ) {
-   *  // Create logger for this service
-   *  this.winstonLogger = this.winstonLoggerFactory.create({
-   *   scope: SomeService.name,
-   *  })
-   * }
-   *
-   * // Create child logger for some method
-   * getOne(id: string) {
-   *   const logger = this.winstonLogger.child({
-   *    action: this.someMethod.name,
-   *    id,
-   *   });
-   * }
-   * ```
-   */
-  child(context: LoggerContext): Logger;
-  /**
-   * Created child logger for nest service method
-   * Automatically parse service method context and add it to logger context
-   * @param name - service method name
-   * @param ctx - service method context
-   * @param other - custom logger context
-   * @returns - new logger with context
-   */
-  forMethod(name: string, ctx?: BaseServiceMethodContext, other?: LoggerContext): Logger;
-  /**
-   * Set data to logger context
-   * @param key - context data key (ex: 'firstName')
-   * @param value - context data value (ex: 'John')
-   */
-  setContext(key: string, value: unknown): void;
-  setContext(context: LoggerContext): void;
-  /**
-   * Get logger context data
-   * @returns - logger context
-   */
-  getContext(): LoggerContext;
-  /**
-   * Write a 'log' level log.
-   */
-  log(entry: LogEntry): void;
-  log(level: WinstonLogLevel, message: string, context?: LoggerContext): void;
-  /**
-   * Write a 'info' level log.
-   */
-  info(message: string, context?: LoggerContext): void;
-  info(infoObject: InfoObject): void;
-  /**
-   * Write an 'error' level log.
-   */
-  error(message: string, context?: LoggerContext): void;
-  error(message: string, error: Error, context?: LoggerContext): void;
-  error(error: NestError): void;
-  error(error: Error, context?: LoggerContext): void;
-  /**
-   * Creates plain object from error
-   * @see {@link DestructuredError}
-   */
-  protected destructureError(error: unknown): DestructuredError;
-  /**
-   * Write a 'warn' level log.
-   */
-  warn(message: string, context?: LoggerContext): void;
-  warn(infoObject: InfoObject): void;
-  /**
-   * Write a 'debug' level log.
-   */
-  debug(message: string, context?: LoggerContext): void;
-  debug(infoObject: InfoObject): void;
-  /**
-   * Write a 'verbose' level log.
-   */
-  verbose(message: string, context?: LoggerContext): void;
-  verbose(infoObject: InfoObject): void;
-}
-//#endregion
-//#region src/logger/classes/typeorm-logger.d.ts
-declare class TypeOrmLoggerOptions {
-  enabled?: boolean;
-  logger: Logger;
-  levels?: LoggerOptions$1;
-}
-declare class TypeOrmLogger extends AbstractLogger {
-  logger: Logger;
-  constructor(opts: TypeOrmLoggerOptions);
-  /**
-   * Write log to specific output.
-   */
-  protected writeLog(level: LogLevel$1,
-  // "query" | "schema" | "error" | "warn" | "info" | "log" | "migration";
-  logMessage: LogMessage | LogMessage[]): void;
-  private getCtx;
-}
-//#endregion
-//#region src/logger/classes/logger-factory.d.ts
-/**
- * Logger factory for creating loggers with predefined context
- * Factory is singleton, so it keep original winston `Logger` instance
- * and is can be injected to any service
- */
-declare class LoggerFactory {
-  private readonly winstonLogger;
-  private context;
-  constructor(winstonLogger: Logger$1, context?: LoggerContext);
-  /**
-   * Created new logger with specific context merge it with global context
-   * @param context - specific action with scope, and other data
-   * @returns - new logger with context
-   * @example
-   * ```ts
-   * class SomeService {
-   *  logger: Logger;
-   *
-   *  constructor(
-   *   @InjectLoggerFactory() private readonly loggerFactory: LoggerFactory,
-   * ) {
-   *  // Create logger for this service
-   *  this.logger = this.loggerFactory.create({
-   *   scope: SomeService.name,
-   *  })
-   * }
-   * ```
-   */
-  create(context?: LoggerContext): Logger;
-  createTypeOrmLogger(opts: Omit<TypeOrmLoggerOptions, 'logger'>): TypeOrmLogger;
-}
-//#endregion
-//#region src/logger/logger.constants.d.ts
-/**
- * Injection token for Winston logger module configuration options
- */
-declare const NESTKIT_LOGGER_MODULE_OPTIONS = "NestKitLoggerModuleOptions";
-/**
- * Injection token for the Winston logger instance provider
- */
-declare const NESTKIT_WINSTON_LOGGER_PROVIDER = "NestKitLogger";
-/**
- * Injection token for the main NestKit logger provider
- */
-declare const NESTKIT_LOGGER_PROVIDER = "NestKitLogger";
-/**
- * Injection token for the NestJS system logger provider
- */
-declare const NESTKIT_SYSTEM_LOGGER_PROVIDER = "NestKitSystemLogger";
-/**
- * Injection token for the logger factory provider
- */
-declare const NESTKIT_LOGGER_FACTORY_PROVIDER = "NestKitLoggerFactory";
-//#endregion
-//#region src/logger/logger.module.d.ts
-declare class LoggerModule {
-  static forRoot(options: LoggerModuleOptions): DynamicModule;
-  static forRootAsync(options: LoggerModuleAsyncOptions): DynamicModule;
-  static createLogger(options: LoggerModuleOptions): LoggerService;
-}
-//#endregion
-//#region src/logger/logger.providers.d.ts
-/**
- * Syntax sugar. Injects logger via NESTKIT_LOGGER_PROVIDER token
- * @example
- * ```ts
- * class SomeService {
- *  constructor(
- *   @InjectLogger() private readonly logger: Logger
- *  ) {}
- * ```
- */
-declare const InjectLogger: () => PropertyDecorator & ParameterDecorator;
-/**
- * Syntax sugar. Injects winston logger factory by WINSTON_MODULE_FACTORY_PROVIDER token
- * @example
- * ```ts
- * class SomeService {
- *  constructor(
- *   @InjectLoggerFactory() private readonly loggerFactory: LoggerFactory
- *  ) {}
- * ```
- */
-declare const InjectLoggerFactory: () => PropertyDecorator & ParameterDecorator;
-declare const createNestLogger: (loggerOpts: LoggerModuleOptions) => Logger$1;
-declare const createLoggerProviders: (loggerOpts: LoggerModuleOptions) => Provider[];
-declare const createLoggerAsyncProviders: (options: LoggerModuleAsyncOptions) => Provider[];
-//#endregion
-//#region src/logger/winston.tools.d.ts
-/**
- * Options for nest-like formatting
- */
-interface CreatePrettyMessageOptions {
-  /**
-   * Application name
-   * @example 'Jetstream'
-   */
-  appName: string;
-  /**
-   * Log level (info, error, warn, debug, verbose, log)
-   * @example 'info'
-   */
-  level: LogLevel;
-  /**
-   * Timestamp in ISO 8601 format
-   * @example '2021-06-10T16:33:42.000Z'
-   */
-  timestamp: string;
-  /**
-   * Message text
-   * @example 'Failed to create cloudlfare output'
-   */
-  message: string;
-  /**
-   * Scope where the message was logged
-   * @example 'VideoService'
-   */
-  scope?: string;
-  /**
-   * Action where the message was logged
-   * @example 'createOutput'
-   */
-  action?: string;
-  /**
-   * Error stack from Error object (`Error.stack`)
-   */
-  stack?: string;
-  /**
-   * Message context (additional data)
-   * @example { id: 'xxx' }
-   */
-  context: Record<string, unknown>;
-  /**
-   * Error key from 'enum'
-   * @example 'NST_SA_EMAIL_NOT_UNIQUE'
-   */
-  errorKey?: string;
-  /**
-   * HTTP status code
-   * @example '400'
-   */
-  statusCode?: string;
-  /**
-   * Parent path for child errors
-   * @example 'MainService.start --> VideoService.createOutput'
-   */
-  parentPath?: string;
-  /**
-   * Error cause
-   */
-  cause?: DestructuredError;
-  /**
-   * Recursion depth
-   * @example 0
-   */
-  deep?: number;
-}
-/**
- * Create a pretty message for the logger with nest-like formatting
- * Use recursion to print child errors
- * @param vars - message variables
- * @returns - formatted message
- * @example
- * [Jetstream]  - 6/10/2022, 4:33:42 PM      ERROR [VideoService.createOutput] Failed to create cloudlfare output
- */
-declare const createPrettyMessage: ({
-  appName,
-  action,
-  level,
-  timestamp,
-  message,
-  scope,
-  stack,
-  errorKey,
-  context,
-  parentPath,
-  cause,
-  deep
-}: CreatePrettyMessageOptions) => string;
-/**
- * Create a nest-like console format
- * @param appName - App name (Jetstream, WHATSBIBLE, etc.)
- * @returns Winston format
- */
-declare const nestLikeConsoleFormat: (appName?: string) => Format;
-//#endregion
-//#region src/configs/logger.config.d.ts
-/**
- * NestJS injection token for Logger config
- */
-declare const LOGGER_CONFIG_TOKEN = "LOGGER_CONFIG_TOKEN";
-declare const InjectLoggerConfig: () => PropertyDecorator & ParameterDecorator;
-interface CreateLoggerConfigOptions {
-  appName: string;
-  useConsole?: boolean;
-  consoleLevel?: winston.LoggerOptions['level'];
-  transports?: winston.transport[];
-}
-/**
- * Create NestJS Logger config
- * @example
- * ```ts
- * // src/config/index.ts
- *
- * import { createLoggerConfig } from '#/dist/configs';
- *
- * export const LoggerConfig = createLoggerConfig();
- * ```
- */
-declare const createLoggerConfig: (opts: CreateLoggerConfigOptions) => (() => winston.LoggerOptions) & _nestjs_config0.ConfigFactoryKeyHost<winston.LoggerOptions>;
-//#endregion
-//#region src/abstracts/nestjs-service.d.ts
-/**
- * Abstract service class for NestJS services
- * Automatically initializes logger with the constructor name as scope
- */
-declare abstract class NestJsService implements OnModuleInit {
-  protected readonly loggerFactory: LoggerFactory;
-  protected logger: Logger;
-  /**
-   * Initialize logger using the constructor name as scope
-   */
-  onModuleInit(): void;
-}
-//#endregion
-//#region src/abstracts/nestjs-resource-service.d.ts
-interface NestJsResourceFilter {
-  ids?: string[];
-  search?: string;
-}
-interface GetOneByOptions {
-  id?: string;
-}
-interface NestJsResourceServiceParams<T extends BaseEntity, GOBO extends GetOneByOptions, F extends NestJsResourceFilter, O> {
-  entity: {
-    type: Type<T>;
-    idPrefix: string;
-    alias: string;
-  };
-  types: {
-    getByOpts: GOBO;
-    filter: F;
-    orderBy: O;
-  };
-}
-declare abstract class NestJsResourceService<T extends BaseEntity, GOBO extends GetOneByOptions, F extends NestJsResourceFilter, O> extends NestJsService {
-  private readonly params;
-  constructor(params: NestJsResourceServiceParams<T, GOBO, F, O>);
-  protected readonly idService: IdService;
-  protected readonly dataSource: DataSource;
-  get repository(): Repository<T>;
-  protected generateEntityId(): string;
-  get entityName(): string;
-  get alias(): string;
-  getOneBy<GOBO extends GetOneByOptions>(opts: GOBO): Promise<MaybeNull<T>>;
-  getOne(id: string): Promise<MaybeNull<T>>;
-  getOneByOrFail<GOBO extends GetOneByOptions>(opts: GOBO, ctx: BaseServiceMethodContext): Promise<T>;
-  protected getOneOrFail(id: string, ctx: BaseServiceMethodContext): Promise<T>;
-  protected applyFilterToQuery(query: SelectQueryBuilder<T>, filter?: F): void;
-  protected applySearchToQuery(query: SelectQueryBuilder<T>, search?: string): void;
-  protected applyOrderByToQuery(query: SelectQueryBuilder<T>, orderBy: O): void;
-}
-//#endregion
-//#region src/configs/db.config.d.ts
-/**
- * NestJS injection token for postgres db config
- */
-declare const DB_CONFIG_TOKEN = "DB_CONFIG_TOKEN";
-declare const InjectDbConfig: () => PropertyDecorator & ParameterDecorator;
-/**
- * Postgres Database Config
- */
-declare const createDbConfig: (opts?: Partial<PostgresConnectionOptions>) => (() => PostgresConnectionOptions) & _nestjs_config0.ConfigFactoryKeyHost<PostgresConnectionOptions>;
-//#endregion
-//#region src/enums/app-server.enum.d.ts
-/**
- * Enum for the NestJS server mode
- */
-declare enum AppServer {
-  /**
-   * NestJS HTTP server with GraphQL
-   */
-  HTTP = "http",
-  /**
-   * NestJS gRPC server
-   */
-  GRPC = "grpc",
-  /**
-   * NestJS WebSocket server
-   */
-  WS = "ws",
-  /**
-   * Run as a worker
-   */
-  WORKER = "worker",
-  /**
-   * Run as an agent
-   */
-  AGENT = "agent",
-  /**
-   * Run as an bot (e.g. Slack bot)
-   */
-  BOT = "bot",
-  /**
-   * Run as Cloud Run job
-   */
-  CLOUDRUN_JOB = "cloudrun-job",
-}
-//#endregion
-//#region src/enums/worker-mode.enum.d.ts
-declare enum WorkerMode {
-  /**
-   * Run jobs in loop
-   */
-  LOOP = "loop",
-  /**
-   * Run one job and exit
-   */
-  ONE_JOB = "one-job",
-}
-//#endregion
-//#region src/tools/compose.d.ts
-type Constructor = new (...args: any[]) => any;
-type MixinFunction<TInput, TOutput> = (source: TInput) => TOutput;
-/**
- * Compose a class by applying mixins to it.
- * The code is inspired by https://justinfagnani.com/2015/12/21/real-mixins-with-javascript-classes/, its
- * just that I have added the support for static types too.
- *
- * @param baseClass - The base class to extend
- * @param mixins - One or more mixin functions to apply sequentially
- * @returns The composed class with all mixins applied
- */
-declare function compose<TBase extends Constructor, TResult1>(baseClass: TBase, mixin1: MixinFunction<TBase, TResult1>): TResult1;
-declare function compose<TBase extends Constructor, TResult1, TResult2>(baseClass: TBase, mixin1: MixinFunction<TBase, TResult1>, mixin2: MixinFunction<TResult1, TResult2>): TResult2;
-declare function compose<TBase extends Constructor, TResult1, TResult2, TResult3>(baseClass: TBase, mixin1: MixinFunction<TBase, TResult1>, mixin2: MixinFunction<TResult1, TResult2>, mixin3: MixinFunction<TResult2, TResult3>): TResult3;
-declare function compose<TBase extends Constructor, TResult1, TResult2, TResult3, TResult4>(baseClass: TBase, mixin1: MixinFunction<TBase, TResult1>, mixin2: MixinFunction<TResult1, TResult2>, mixin3: MixinFunction<TResult2, TResult3>, mixin4: MixinFunction<TResult3, TResult4>): TResult4;
-declare function compose<TBase extends Constructor, TResult1, TResult2, TResult3, TResult4, TResult5>(baseClass: TBase, mixin1: MixinFunction<TBase, TResult1>, mixin2: MixinFunction<TResult1, TResult2>, mixin3: MixinFunction<TResult2, TResult3>, mixin4: MixinFunction<TResult3, TResult4>, mixin5: MixinFunction<TResult4, TResult5>): TResult5;
-declare function compose<TBase extends Constructor, TResult1, TResult2, TResult3, TResult4, TResult5, TResult6>(baseClass: TBase, mixin1: MixinFunction<TBase, TResult1>, mixin2: MixinFunction<TResult1, TResult2>, mixin3: MixinFunction<TResult2, TResult3>, mixin4: MixinFunction<TResult3, TResult4>, mixin5: MixinFunction<TResult4, TResult5>, mixin6: MixinFunction<TResult5, TResult6>): TResult6;
-declare function compose<TBase extends Constructor, TResult1, TResult2, TResult3, TResult4, TResult5, TResult6, TResult7>(baseClass: TBase, mixin1: MixinFunction<TBase, TResult1>, mixin2: MixinFunction<TResult1, TResult2>, mixin3: MixinFunction<TResult2, TResult3>, mixin4: MixinFunction<TResult3, TResult4>, mixin5: MixinFunction<TResult4, TResult5>, mixin6: MixinFunction<TResult5, TResult6>, mixin7: MixinFunction<TResult6, TResult7>): TResult7;
-declare function compose<TBase extends Constructor, TResult1, TResult2, TResult3, TResult4, TResult5, TResult6, TResult7, TResult8>(baseClass: TBase, mixin1: MixinFunction<TBase, TResult1>, mixin2: MixinFunction<TResult1, TResult2>, mixin3: MixinFunction<TResult2, TResult3>, mixin4: MixinFunction<TResult3, TResult4>, mixin5: MixinFunction<TResult4, TResult5>, mixin6: MixinFunction<TResult5, TResult6>, mixin7: MixinFunction<TResult6, TResult7>, mixin8: MixinFunction<TResult7, TResult8>): TResult8;
-declare function compose<TBase extends Constructor, TResult1, TResult2, TResult3, TResult4, TResult5, TResult6, TResult7, TResult8, TResult9>(baseClass: TBase, mixin1: MixinFunction<TBase, TResult1>, mixin2: MixinFunction<TResult1, TResult2>, mixin3: MixinFunction<TResult2, TResult3>, mixin4: MixinFunction<TResult3, TResult4>, mixin5: MixinFunction<TResult4, TResult5>, mixin6: MixinFunction<TResult5, TResult6>, mixin7: MixinFunction<TResult6, TResult7>, mixin8: MixinFunction<TResult7, TResult8>, mixin9: MixinFunction<TResult8, TResult9>): TResult9;
-//#endregion
 //#region src/tools/convert-to-bigint.d.ts
+
 /**
  * Converts a number or string value to a BigInt, preserving null and undefined values.
  *
@@ -979,66 +24,6 @@ declare function compose<TBase extends Constructor, TResult1, TResult2, TResult3
  */
 declare const convertToBigInt: (value: number | string | undefined | null) => bigint | undefined | null;
 //#endregion
-//#region src/types/list-meta.d.ts
-interface ListMeta {
-  /**
-   * Total count of items
-   */
-  total?: number;
-  /**
-   * Count of items in current page
-   */
-  limit?: number;
-  /**
-   * Offset of current page
-   */
-  offset?: number;
-}
-//#endregion
-//#region src/tools/create-list-meta.d.ts
-interface CreateListMetaOptions<T extends ObjectLiteral> {
-  /**
-   * Typeorm query builder
-   */
-  query: SelectQueryBuilder<T>;
-  /**
-   * If true, total count will be calculated by additional SELECT COUNT.
-   */
-  needCountTotal?: boolean;
-  /**
-   * Limit of items
-   */
-  limit?: number;
-  /**
-   * Offset of items
-   */
-  offset?: number;
-}
-/**
- * Create list meta object
- * @returns list meta object
- * @example
- * class UsersService {
- *  async getMany(opts: GetManyUsersOptions): Promise<[User[], ListMeta]> {
- *    ...
- *   return Promise.all([
- *     query.getMany(),
- *     createListMeta<User>({
- *       query,
- *       needCountTotal,
- *       limit,
- *       offset,
- *     }),
- *   ]);
- * }
- */
-declare const createListMeta: <T extends ObjectLiteral>({
-  query,
-  needCountTotal,
-  limit,
-  offset
-}: CreateListMetaOptions<T>) => Promise<ListMeta>;
-//#endregion
 //#region src/tools/define-statuses.d.ts
 /**
  * Define statuses. Returns array of statuses from filter or default statuses
@@ -1074,71 +59,6 @@ declare const defineStatuses: <T>(statuses: T[] | undefined, defaultStatuses: T[
  * ```
  */
 declare const validateEnv: <T>(cls: Type<T>) => T;
-/**
- * Returns a string with a dash prefix based on the current environment.
- * If the environment is development or local, returns '-dev'.
- * If the environment is stage, returns '-stage'.
- * Otherwise, returns an empty string.
- *
- * @returns a string with a dash prefix based on the current environment
- * @example
- * ```typescript
- * const name = `my-app${withDashEnv()}`;
- * ```
- */
-declare const withDashEnv: () => "-dev" | "-stage" | "";
-/**
- * Returns a string with a dash prefix based on the current environment.
- * If the environment is development or local, returns '.dev'.
- * If the environment is stage, returns '.stage'.
- * Otherwise, returns an empty string.
- *
- * @returns a string with a dot prefix based on the current environment
- * @example
- * ```typescript
- * const name = `config${withDotEnv()}`;
- * ```
- */
-declare const withDotEnv: () => "" | ".dev" | ".stage";
-/**
- * Returns a string with a colon prefix based on the current environment.
- * If the environment is development or local, returns ':dev'.
- * If the environment is stage, returns ':stage'.
- * Otherwise, returns an empty string.
- *
- * @returns a string with a colon prefix based on the current environment
- * @example
- * ```typescript
- * const name = `my:app${withColonEnv()}`;
- * ```
- */
-declare const withColonEnv: () => "" | ":dev" | ":stage";
-/**
- * Returns a string with an underscore prefix based on the current environment.
- * If the environment is development or local, returns '_dev'.
- * If the environment is stage, returns '_stage'.
- * Otherwise, returns an empty string.
- *
- * @returns a string with an underscore prefix based on the current environment
- * @example
- * ```typescript
- * const name = `my_app${withUnderscoreEnv()}`;
- * ```
- */
-declare const withUnderscoreEnv: () => "" | "_dev" | "_stage";
-//#endregion
-//#region src/tools/fetch-total-with-query.d.ts
-/**
- * Returns total count of items with typeorm query
- * @param query - typeorm query builder
- * @returns total count of items
- */
-/**
- * Returns total count of items with typeorm query
- * @param query - typeorm query builder
- * @returns total count of items
- */
-declare const fetchTotalWithQuery: <T extends ObjectLiteral>(query: SelectQueryBuilder<T>) => Promise<number>;
 //#endregion
 //#region src/tools/generate-entity-id.d.ts
 /**
@@ -1171,21 +91,6 @@ interface NestExpressRequest extends Request {
 //#region src/tools/get-request-language.d.ts
 declare const getRequestLanguage: (req: NestExpressRequest, fallbackLanguage: string) => string;
 //#endregion
-//#region src/tools/postgres/locale-to-pg-collate.d.ts
-/**
- * Converts a locale string to a PostgreSQL collation identifier.
- *
- * @param locale - The locale string to convert (e.g., 'uk', 'en')
- * @returns The PostgreSQL collation identifier (e.g., 'uk_UA', 'en_US')
- *
- * @example
- * ```typescript
- * localeToPgCollate('uk') // returns 'uk_UA'
- * localeToPgCollate('en') // returns 'en_US'
- * ```
- */
-declare const localeToPgCollate: (locale: string) => string;
-//#endregion
 //#region src/tools/remove-undefined-properties.d.ts
 type DefinedValuesOnly<T> = { [K in keyof T]: T[K] extends undefined ? never : K }[keyof T];
 type UndefinedRemoved<T> = { [K in DefinedValuesOnly<T>]: T[K] };
@@ -1228,6 +133,21 @@ declare const pauseWithPromise: (ms: number) => Promise<void>;
  */
 declare const wait: (ms: number) => Promise<void>;
 //#endregion
+//#region src/tools/postgres/locale-to-pg-collate.d.ts
+/**
+ * Converts a locale string to a PostgreSQL collation identifier.
+ *
+ * @param locale - The locale string to convert (e.g., 'uk', 'en')
+ * @returns The PostgreSQL collation identifier (e.g., 'uk_UA', 'en_US')
+ *
+ * @example
+ * ```typescript
+ * localeToPgCollate('uk') // returns 'uk_UA'
+ * localeToPgCollate('en') // returns 'en_US'
+ * ```
+ */
+declare const localeToPgCollate: (locale: string) => string;
+//#endregion
 //#region src/tools/typeorm/add-filter.d.ts
 /**
  * Adds a filter condition to a TypeORM SelectQueryBuilder based on the provided field and value(s).
@@ -1284,28 +204,6 @@ declare const addFilterByField: <T extends ObjectLiteral, K$1 extends (keyof T &
  */
 declare const ensureInnerJoin: <T extends ObjectLiteral>(query: SelectQueryBuilder<T>, entity: Function | string, alias: string, condition?: string) => void;
 //#endregion
-//#region src/tools/typeorm/ensure-left-join.d.ts
-/**
- * Ensures a left join is added to a TypeORM query builder if the alias is not already in use.
- *
- * This function checks if the specified alias is already being used in the query.
- * If the alias is available, it performs a left join with the provided entity, alias, and optional condition.
- * If the alias is already busy, the function returns early without modifying the query.
- *
- * @template T - The entity type that extends ObjectLiteral
- * @param query - The TypeORM SelectQueryBuilder instance to add the left join to
- * @param entity - The entity class (Function) or table name (string) to join
- * @param alias - The alias name to use for the joined entity
- * @param condition - Optional join condition as a string (e.g., "alias.id = entity.foreignId")
- * @returns void
- *
- * @example
- * ```typescript
- * ensureLeftJoin(queryBuilder, User, 'user', 'user.id = post.userId');
- * ```
- */
-declare const ensureLeftJoin: <T extends ObjectLiteral>(query: SelectQueryBuilder<T>, entity: Function | string, alias: string, condition?: string) => void;
-//#endregion
 //#region src/tools/typeorm/is-alias-already-busy.d.ts
 /**
  * Checks if a given alias is already used in the query builder's join attributes.
@@ -1330,61 +228,5 @@ declare const ensureLeftJoin: <T extends ObjectLiteral>(query: SelectQueryBuilde
  */
 declare const isAliasAlreadyBusy: <T extends ObjectLiteral>(query: SelectQueryBuilder<T>, alias: string) => boolean;
 //#endregion
-//#region src/validation/validation-pipe.d.ts
-declare class NestKitValidationPipe extends ValidationPipe {
-  createExceptionFactory(): (validationErrors?: ValidationError[]) => any;
-}
-//#endregion
-//#region src/exceptions/http-exception-response.d.ts
-/**
- * NestJS HttpException response object
- * @example
- * exception.getResponse()
- */
-interface HttpExceptionResponse {
-  /**
-   * Error message text
-   */
-  message: string;
-  /**
-   * Error key from 'enum'
-   */
-  key: string;
-  /**
-   * Error object
-   */
-  error?: Error;
-  /**
-   * Error context (additional data)
-   */
-  context: LoggerContext;
-  /**
-   * Don't log error
-   */
-  silent?: boolean;
-}
-//#endregion
-//#region src/exceptions/http-exceptions.filter.d.ts
-/**
- * Http exception filter for NestJS
- * It is used to correctly log all http exceptions
- * @deprecated use NestErrorFilter instead
- * @see NestErrorFilter
- * @example
- * ```ts
- * // main.ts
- * const { httpAdapter } = app.get(HttpAdapterHost);
- * const loggerFactory = app.get(WINSTON_MODULE_FACTORY_PROVIDER);
- * app.useGlobalFilters(new HttpExceptionFilter(httpAdapter, loggerFactory));
- * ```
- */
-declare class HttpExceptionFilter {
-  protected readonly applicationRef: HttpServer;
-  private readonly loggerFactory;
-  private readonly logger;
-  constructor(applicationRef: HttpServer, loggerFactory: LoggerFactory);
-  catch(exception: HttpException, host: ArgumentsHost): HttpException | undefined;
-}
-//#endregion
-export { APP_CONFIG_TOKEN, AccessDeniedError, AccessDeniedErrorOptions, AppConfigEnvironmentVariables, AppConfigOptions, AppConfigType, AppEnv, AppMode, AppServer, BadRequestError, BasePlatformMethodContext, BaseServiceMethodContext, Constructor, CreateListMetaOptions, CreateLoggerConfigOptions, CreatePrettyMessageOptions, CurrentUser, DB_CONFIG_TOKEN, DestructuredError, ForbiddenError, GetOneByOptions, HttpExceptionFilter, HttpExceptionResponse, IBaseActionContext, InfoObject, InjectAppConfig, InjectDbConfig, InjectLogger, InjectLoggerConfig, InjectLoggerFactory, InputValidationError, LOGGER_CONFIG_TOKEN, Logger, LoggerContext, LoggerFactory, LoggerModule, LoggerModuleAsyncOptions, LoggerModuleOptions, LoggerModuleOptionsFactory, NESTKIT_LOGGER_FACTORY_PROVIDER, NESTKIT_LOGGER_MODULE_OPTIONS, NESTKIT_LOGGER_PROVIDER, NESTKIT_SYSTEM_LOGGER_PROVIDER, NESTKIT_WINSTON_LOGGER_PROVIDER, NestError, NestErrorOptions, NestJsResourceFilter, NestJsResourceService, NestJsResourceServiceParams, NestJsService, NestKitValidationPipe, NestSystemLogger, NotFoundError, TypeOrmLogger, TypeOrmLoggerOptions, UnauthorizedError, WinstonLogLevel, WorkerMode, addFilterByField, compose, convertToBigInt, createAppConfig, createDbConfig, createListMeta, createLoggerAsyncProviders, createLoggerConfig, createLoggerProviders, createNestLogger, createPrettyMessage, defineStatuses, ensureInnerJoin, ensureLeftJoin, extractRequestId, fetchTotalWithQuery, generateEntityId, generateRequestId, getRequestLanguage, isAliasAlreadyBusy, isObject, localeToPgCollate, nestLikeConsoleFormat, pauseWithPromise, removeUndefinedProperties, stringifyOpts, validateEnv, wait, withColonEnv, withDashEnv, withDotEnv, withUnderscoreEnv };
+export { addFilterByField, convertToBigInt, defineStatuses, ensureInnerJoin, extractRequestId, generateEntityId, generateRequestId, getRequestLanguage, isAliasAlreadyBusy, localeToPgCollate, pauseWithPromise, removeUndefinedProperties, stringifyOpts, validateEnv, wait };
 //# sourceMappingURL=index.d.ts.map