@innv/nest-initializer 0.2.1 → 0.3.0

package/dist/esm/starters/mongoose.starter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose.starter.js","sourceRoot":"","sources":["../../../src/starters/mongoose.starter.ts"],"names":[],"mappings":";;AAuBA,sDAiBC;AAxCD,2CAA+C;AAC/C,+CAAyE;AAsBzE,SAAgB,qBAAqB,CAAC,UAAkC,EAAE;IACxE,MAAM,EAAE,SAAS,GAAG,WAAW,EAAE,eAAe,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAElE,MAAM,qBAAqB,GAAG,yBAAc,CAAC,YAAY,CAAC;QACxD,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,CAAC,sBAAa,CAAC;QAEvB,UAAU,EAAE,CAAC,aAA4B,EAAyB,EAAE,CAAC,CAAC;YACpE,GAAG,EAAE,aAAa,CAAC,GAAG,CAAS,SAAS,CAAC;YACzC,GAAG,eAAe;SACnB,CAAC;KACH,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC"}

package/dist/esm/starters/typeorm.starter.d.ts

@@ -0,0 +1,12 @@
+import { TypeOrmModuleOptions } from '@nestjs/typeorm';
+import { AppInitializerPlugin } from '../core';
+export interface TypeOrmStarterOptions {
+    autoLoadEntities?: boolean;
+    runMigrationsOnStartup?: boolean;
+    databaseUrlEnvKey?: string;
+    typeOrmOptions?: Omit<TypeOrmModuleOptions, 'url' | 'autoLoadEntities' | 'synchronize'>;
+}
+export declare function createTypeOrmStarter(options?: TypeOrmStarterOptions): {
+    module: import("@nestjs/common").DynamicModule;
+    plugins: AppInitializerPlugin[];
+};

package/dist/esm/starters/typeorm.starter.js

@@ -4,10 +4,6 @@ exports.createTypeOrmStarter = createTypeOrmStarter;
 const config_1 = require("@nestjs/config");
 const typeorm_1 = require("@nestjs/typeorm");
 const plugins_1 = require("../plugins");
-/**
- * Cria o módulo dinâmico para o "Starter" de TypeORM.
- * Esta função constrói toda a configuração necessária para o TypeOrmModule.
- */
 function createTypeOrmStarter(options = {}) {
     const { autoLoadEntities = true, runMigrationsOnStartup = false, databaseUrlEnvKey = 'DATABASE_URL', typeOrmOptions = {}, } = options;
     const typeOrmDynamicModule = typeorm_1.TypeOrmModule.forRootAsync({
@@ -29,3 +25,4 @@ function createTypeOrmStarter(options = {}) {
         plugins: plugins,
     };
 }
+//# sourceMappingURL=typeorm.starter.js.map

package/dist/esm/starters/typeorm.starter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeorm.starter.js","sourceRoot":"","sources":["../../../src/starters/typeorm.starter.ts"],"names":[],"mappings":";;AAuBA,oDA6BC;AApDD,2CAA+C;AAC/C,6CAAsE;AAGtE,wCAAoD;AAmBpD,SAAgB,oBAAoB,CAAC,UAAiC,EAAE;IACtE,MAAM,EACJ,gBAAgB,GAAG,IAAI,EACvB,sBAAsB,GAAG,KAAK,EAC9B,iBAAiB,GAAG,cAAc,EAClC,cAAc,GAAG,EAAE,GACpB,GAAG,OAAO,CAAC;IAEZ,MAAM,oBAAoB,GAAG,uBAAa,CAAC,YAAY,CAAC;QACtD,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,CAAC,sBAAa,CAAC;QACvB,UAAU,EAAE,CAAC,aAA4B,EAAwB,EAAE,CACjE,CAAC;YACC,GAAG,EAAE,aAAa,CAAC,GAAG,CAAS,iBAAiB,CAAC;YACjD,gBAAgB,EAAE,gBAAgB;YAClC,WAAW,EAAE,KAAK;YAClB,GAAG,cAAc;SAClB,CAAyB;KAC7B,CAAC,CAAC;IAEH,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,sBAAsB,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,gCAAsB,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO;QACL,MAAM,EAAE,oBAAoB;QAC5B,OAAO,EAAE,OAAO;KACjB,CAAC;AACJ,CAAC"}

package/dist/types/core/app-initializer.d.ts

@@ -1,3 +1,4 @@
+import 'reflect-metadata';
 import { CanActivate, ExceptionFilter, INestApplication, NestInterceptor, PipeTransform, Type, ValidationPipeOptions, VersioningOptions } from '@nestjs/common';
 import { CorsOptions } from '@nestjs/common/interfaces/external/cors-options.interface';
 import { AbstractHttpAdapter } from '@nestjs/core';
@@ -5,27 +6,13 @@ import { SwaggerCustomOptions, SwaggerDocumentOptions } from '@nestjs/swagger';
 import { TerminusHealthCheckOptions } from '../features';
 import { CachingStarterOptions, MongooseStarterOptions, TypeOrmStarterOptions } from '../starters';
 import { ResponseMapper } from '../interceptors/response-pattern.interceptor';
-/**
- * Interface que todos os plugins do AppInitializer devem implementar.
- */
 export interface AppInitializerPlugin {
-    /**
-     * Método que será executado durante a inicialização para aplicar a lógica do plugin.
-     * Pode ser síncrono ou assíncrono.
-     * @param app A instância da aplicação NestJS (INestApplication).
-     */
     apply(app: INestApplication): Promise<void> | void;
 }
-/**
- * Representa uma tag na documentação Swagger (OpenAPI).
- */
 export type SwaggerDocumentTags = {
     name: string;
     description?: string;
 };
-/**
- * Opções para a configuração do Swagger (OpenAPI).
- */
 export type SwaggerOptions = {
     title: string;
     description: string;
@@ -35,14 +22,7 @@ export type SwaggerOptions = {
     documentOptions?: SwaggerDocumentOptions;
     customOptions?: SwaggerCustomOptions;
 };
-/**
- * Assinatura da função de callback usada para configurar o inicializador.
- * @param app A instância do AppInitializer a ser configurada.
- */
 type AppConfigurator<T extends INestApplication> = (app: AppInitializer<T>) => void;
-/**
- * Uma classe fluente (Builder) para inicializar uma aplicação NestJS de forma declarativa.
- */
 export declare class AppInitializer<T extends INestApplication = INestApplication> {
     private app;
     private readonly module;
@@ -56,173 +36,43 @@ export declare class AppInitializer<T extends INestApplication = INestApplicatio
     private readonly setupFunctions;
     private readonly plugins;
     private readonly featureModules;
-    private advancedSwaggerUiOptions?;
     private autoDiscoveredComponents?;
     private readonly globalProviders;
+    private readonly nexusClientProviders;
     private readonly globalInterceptors;
     private readonly factoryGeneratedControllers;
     private constructor();
-    /**
-     * Aplica um conjunto de configurações padrão recomendadas para o ambiente de desenvolvimento.
-     * Inclui Swagger e um logger de requisições.
-     * @param swaggerOptions Opções para customizar a documentação Swagger.
-     */
     useDevelopmentDefaults(swaggerOptions: Omit<SwaggerOptions, 'path'>): this;
-    /**
-     * Aplica um conjunto de configurações padrão recomendadas para o ambiente de produção.
-     * Inclui Helmet, compressão, graceful shutdown e um rate limiter básico.
-     */
     useProductionDefaults(): this;
-    /**
-     * Aplica um bloco de configurações de forma condicional.
-     * @param condition A condição booleana. Se for `true`, o callback de configuração será executado.
-     * @param configure A função de callback que recebe o builder para aplicar as configurações.
-     */
     when(condition: boolean, configure: (builder: this) => void): this;
     withHealthCheck(options: TerminusHealthCheckOptions): this;
-    /**
-     * Habilita a coleta e exposição de métricas no padrão Prometheus
-     * no endpoint /metrics. Inclui métricas padrão do Node.js
-     * e métricas de latência de requisições HTTP.
-     */
     withMetrics(): this;
     static bootstrap<T extends INestApplication = INestApplication>(module: Type, configurator: AppConfigurator<T>): Promise<void>;
     static bootstrap<T extends INestApplication = INestApplication>(module: Type, adapter: AbstractHttpAdapter, configurator: AppConfigurator<T>): Promise<void>;
-    /**
-     * Define a porta em que a aplicação vai rodar.
-     * @param port O número da porta.
-     */
     onPort(port: number): this;
-    /**
-     * Registra um plugin para ser executado durante a inicialização.
-     * @param plugin Uma instância de um objeto que implementa a interface AppInitializerPlugin.
-     */
     withPlugin(plugin: AppInitializerPlugin): this;
-    /**
-     * Habilita e configura o versionamento da API.
-     * @param options As opções de versionamento do NestJS.
-     */
     withVersioning(options: VersioningOptions): this;
-    /**
-     * Define um prefixo global para todas as rotas da aplicação (ex: /api/v1).
-     * @param prefix O prefixo a ser aplicado.
-     */
     withGlobalPrefix(prefix: string): this;
-    /**
-     * Habilita e configura o Cross-Origin Resource Sharing (CORS).
-     * @param options As opções de configuração do CORS.
-     */
     withCors(options?: CorsOptions): this;
-    /**
-     * Adiciona o ValidationPipe global com opções customizadas.
-     * Esta é a forma recomendada de habilitar a validação padrão.
-     * @param options Opções de configuração para o ValidationPipe.
-     */
     withValidationPipe(options?: ValidationPipeOptions): this;
-    /**
-     * Registra um Pipe global customizado (ex: um pipe de parsing).
-     * O pipe participará da Injeção de Dependência.
-     * @param pipe A *classe* do pipe a ser registrada.
-     */
     useGlobalPipe(pipe: Type<PipeTransform>): this;
-    /**
-     * Registra um Filtro de Exceção global (ex: HttpExceptionFilter).
-     * O filtro participará da Injeção de Dependência.
-     * @param filter A *classe* do filtro a ser registrada.
-     */
     useGlobalFilter(filter: Type<ExceptionFilter>): this;
-    /**
-     * Registra um Guard global (ex: JwtAuthGuard).
-     * O guard participará da Injeção de Dependência.
-     * @param guard A *classe* do guard a ser registrada.
-     */
     useGlobalGuard(guard: Type<CanActivate>): this;
-    /**
-     * Registra um Interceptor global (ex: LoggingInterceptor).
-     * O interceptor participará da Injeção de Dependência.
-     * @param interceptor A *classe* do interceptor a ser registrada.
-     */
     useGlobalInterceptor(interceptor: Type<NestInterceptor>): this;
-    /**
-     * Registra o ClassSerializerInterceptor globalmente.
-     * Essencial para transformações de DTO (@Exclude, @Expose).
-     * Ele automaticamente recebe o Reflector via DI.
-     */
     withClassSerializer(): this;
-    /**
-     * Habilita e configura a documentação da API via Swagger (OpenAPI).
-     * @param options As opções para construir a documentação.
-     */
     withSwagger(options: SwaggerOptions): this;
-    /**
-     * Aplica customizações avançadas à interface do Swagger UI.
-     * Isso pode incluir temas, scripts e outras configurações visuais.
-     * Por padrão, aplica um tema escuro e algumas configurações de layout.
-     */
-    withAdvancedSwaggerUI(): this;
-    /**
-     * Habilita os 'shutdown hooks' do NestJS para um desligamento gracioso.
-     */
     withGracefulShutdown(): this;
-    /**
-     * Adiciona o middleware de segurança Helmet com configurações padrão.
-     */
     useHelmet(): this;
-    /**
-     * Adiciona o middleware de compressão (gzip) para as respostas.
-     */
     enableCompression(): this;
-    /**
-     * Carrega e valida as variáveis de ambiente na inicialização
-     * usando um schema de validação (classe com decoradores class-validator).
-     * Se a validação falhar, a aplicação não será iniciada.
-     * @param schema A classe de schema para validar (ex: EnvironmentVariables).
-     */
     withValidatedConfig<T extends object>(schema: Type<T>): this;
-    /**
-     * Configura e registra automaticamente o TypeOrmModule (Estilo "Starter").
-     * @param options Opções para o "Starter" de TypeORM.
-     */
     withTypeOrm(options?: TypeOrmStarterOptions): this;
-    /**
-     * Configura e registra automaticamente o MongooseModule (Estilo "Starter").
-     * Usa a configuração global (de .withValidatedConfig) para se conectar
-     * ao MongoDB e descobre schemas automaticamente.
-     *
-     * @param options Opções para o "Starter" de Mongoose.
-     */
     withMongoose(options?: MongooseStarterOptions): this;
-    /**
-     * Configura e registra automaticamente o CacheModule (Estilo "Starter").
-     * Usa a configuração global (de .withValidatedConfig) para se conectar
-     * ao Redis e torna o cache globalmente disponível.
-     *
-     * @param options Opções para o "Starter" de Cache.
-     */
     withCaching(options?: CachingStarterOptions): this;
-    /**
-     * Retorna a instância da aplicação NestJS (INestApplication) após a inicialização.
-     * @throws Error se a aplicação ainda não foi inicializada.
-     */
     getApp(): T;
-    /**
-     * Habilita a descoberta e registro automático de Providers e Controllers.
-     * Varre o projeto em busca de classes com @Injectable() e @Controller()
-     * e as adiciona ao módulo raiz.
-     * @param options Opções para configurar a descoberta.
-     */
     withAutoDiscovery(options: {
         basePath: string;
     }): this;
-    /**
-     * Adiciona um Interceptor global diretamente (instância).
-     * @param interceptor
-     */
     addGlobalInterceptor(interceptor: NestInterceptor): this;
-    /**
-     * Adiciona um ResponseMapper global para padronizar respostas.
-     * @param mapper
-     */
     withResponseMapper<T>(mapper: ResponseMapper<T>): this;
     private listen;
 }

package/dist/types/core/auto-discovery.helper.d.ts

@@ -3,13 +3,8 @@ import { Reflector } from '@nestjs/core';
 interface DiscoveredComponents {
     providers: Type[];
     controllers: Type[];
+    nexusClients: Type[];
 }
 type RequireFn = (id: string) => any;
-/**
- * Descobre componentes NestJS (Providers e Controllers) em um diretório.
- * @param basePath O diretório raiz para a varredura.
- * @param reflectorInst Uma instância do Reflector.
- * @param requireFn A função 'require' a ser usada (padrão: Node's require).
- */
 export declare function discoverComponents(basePath: string, reflectorInst: Reflector, requireFn?: RequireFn): DiscoveredComponents;
 export {};

package/dist/types/core/config-validator.helper.d.ts

@@ -1,9 +1,2 @@
 import { Type } from '@nestjs/common';
-/**
- * Valida um objeto de configuração (ex: process.env) contra uma classe de schema.
- * Se a validação falhar, lança um erro detalhado.
- * @param config O objeto de configuração a ser validado (geralmente process.env).
- * @param schema A classe de schema com decoradores do class-validator.
- * @returns O objeto de configuração validado e transformado.
- */
 export declare function validateConfig<T extends object>(config: Record<string, any>, schema: Type<T>): T;

package/dist/types/plugins/typeorm-migration.plugin.d.ts

@@ -1,15 +1,6 @@
 import { INestApplication } from '@nestjs/common';
 import { AppInitializerPlugin } from '../core';
-/**
- * Um plugin do AppInitializer que executa automaticamente as migrations
- * do TypeORM na inicialização da aplicação.
- */
 export declare class TypeOrmMigrationPlugin implements AppInitializerPlugin {
     private readonly logger;
-    /**
-     * Método 'apply' que será chamado pelo AppInitializer durante o bootstrap.
-     * Este método é assíncrono para poder aguardar a conclusão das migrations.
-     * @param app A instância da aplicação NestJS.
-     */
     apply(app: INestApplication): Promise<void>;
 }

package/dist/types/starters/caching.starter.d.ts

@@ -1,20 +1,5 @@
-/**
- * Opções para o "Starter" de Cache (Redis).
- */
 export interface CachingStarterOptions {
-    /**
-     * Chave do .env que contém a URL de conexão com o Redis.
-     * (Padrão: 'REDIS_URL')
-     */
     redisUrlEnvKey?: string;
-    /**
-     * Tempo de vida (TTL) padrão para os itens em cache, em segundos.
-     * (Padrão: 300 segundos / 5 minutos)
-     */
     defaultTtlInSeconds?: number;
 }
-/**
- * Cria o módulo dinâmico para o "Starter" de Cache.
- * Configura o CacheModule para ser global e usar o Redis.
- */
 export declare function createCachingStarter(options?: CachingStarterOptions): import("@nestjs/common").DynamicModule;

package/dist/types/starters/mongoose.starter.d.ts

@@ -1,23 +1,8 @@
 import { MongooseModuleOptions } from '@nestjs/mongoose';
-/**
- * Opções para o "Starter" de Mongoose (MongoDB).
- */
 export interface MongooseStarterOptions {
-    /**
-     * Chave do .env que contém a URI de conexão com o MongoDB.
-     * (Padrão: 'MONGO_URI')
-     */
     uriEnvKey?: string;
-    /**
-     * Permite sobrescrever qualquer outra opção de configuração do Mongoose
-     * (ex: { retryAttempts: 2 }).
-     */
     mongooseOptions?: Omit<MongooseModuleOptions, 'uri'>;
 }
-/**
- * Cria o módulo dinâmico para o "Starter" de Mongoose.
- * Configura o MongooseModule para ser global e usar a URI do .env.
- */
 export declare function createMongooseStarter(options?: MongooseStarterOptions): {
     module: import("@nestjs/common").DynamicModule;
     plugins: never[];

package/dist/types/starters/typeorm.starter.d.ts

@@ -1,18 +1,11 @@
 import { TypeOrmModuleOptions } from '@nestjs/typeorm';
 import { AppInitializerPlugin } from '../core';
-/**
- * Opções para o "Starter" de TypeORM.
- */
 export interface TypeOrmStarterOptions {
     autoLoadEntities?: boolean;
     runMigrationsOnStartup?: boolean;
     databaseUrlEnvKey?: string;
     typeOrmOptions?: Omit<TypeOrmModuleOptions, 'url' | 'autoLoadEntities' | 'synchronize'>;
 }
-/**
- * Cria o módulo dinâmico para o "Starter" de TypeORM.
- * Esta função constrói toda a configuração necessária para o TypeOrmModule.
- */
 export declare function createTypeOrmStarter(options?: TypeOrmStarterOptions): {
     module: import("@nestjs/common").DynamicModule;
     plugins: AppInitializerPlugin[];

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "@innv/nest-initializer",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Uma plataforma fluente e opinativa para inicializar e configurar aplicações NestJS com as melhores práticas.",
   "author": "Innovare",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/innovare-tech/nest-initializer.git"
+    "url": "git+https://github.com/innovare-tech/innv-genesis.git",
+    "directory": "packages/nest-initializer"
   },
   "bugs": {
-    "url": "https://github.com/innovare-tech/nest-initializer/issues"
+    "url": "https://github.com/innovare-tech/innv-genesis/issues"
   },
-  "homepage": "https://github.com/innovare-tech/nest-initializer/issues#readme",
+  "homepage": "https://github.com/innovare-tech/innv-genesis/tree/main/packages/nest-initializer#readme",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
@@ -21,19 +22,8 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "scripts": {
-    "test": "jest --coverage",
-    "test:watch": "jest --watch",
-    "build:clean": "rimraf dist",
-    "build:cjs": "tsc -p tsconfig.build-cjs.json",
-    "build:esm": "tsc -p tsconfig.build-esm.json",
-    "build:types": "tsc -p tsconfig.build-types.json",
-    "build": "npm run build:clean && npm run build:cjs && npm run build:esm && npm run build:types",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier --write \"{src,test}/**/*.ts\"",
-    "prepare": "husky install",
-    "prepublishOnly": "npm run lint && npm test && npm run build"
+  "publishConfig": {
+    "access": "public"
   },
   "dependencies": {
     "cache-manager-redis-store": "3.0.1",
@@ -41,7 +31,9 @@
     "glob": "11.0.3",
     "helmet": "8.1.0",
     "morgan": "^1.10.1",
-    "zod": "4.1.12"
+    "tslib": "^2.6.3",
+    "zod": "4.1.12",
+    "@innv/nexus": "0.2.0"
   },
   "peerDependencies": {
     "@nestjs/axios": "^4.0.1",
@@ -106,7 +98,6 @@
   "devDependencies": {
     "@commitlint/cli": "^19.3.0",
     "@commitlint/config-conventional": "^19.2.2",
-    "@eslint/js": "^9.38.0",
     "@nestjs/axios": "^4.0.1",
     "@nestjs/cache-manager": "^3.0.1",
     "@nestjs/common": "^11.1.6",
@@ -119,18 +110,14 @@
     "@nestjs/testing": "^11.1.7",
     "@nestjs/typeorm": "^11.0.0",
     "@types/compression": "^1.7.5",
+    "@types/express": "^5.0.5",
+    "@types/express-rate-limit": "^6.0.2",
     "@types/jest": "^29.5.14",
     "@types/morgan": "^1.9.10",
     "@types/node": "^18.19.3",
-    "@typescript-eslint/eslint-plugin": "^7.10.0",
-    "@typescript-eslint/parser": "^7.10.0",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.2",
-    "eslint": "^8.57.0",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-prettier": "^5.1.3",
     "express-rate-limit": "^8.1.0",
-    "globals": "^15.0.0",
     "husky": "^9.0.11",
     "jest": "^29.7.0",
     "prettier": "^3.2.5",
@@ -139,9 +126,7 @@
     "rimraf": "^5.0.7",
     "rxjs": "^7.8.1",
     "ts-jest": "^29.4.5",
-    "typeorm": "^0.3.27",
-    "typescript": "^5.4.5",
-    "typescript-eslint": "^8.46.2"
+    "typeorm": "^0.3.27"
   },
   "keywords": [
     "nestjs",
@@ -155,5 +140,15 @@
     "starter",
     "actuator",
     "auto-discovery"
-  ]
-}
+  ],
+  "scripts": {
+    "test": "jest --coverage",
+    "test:watch": "jest --watch",
+    "build:clean": "rimraf dist",
+    "build:cjs": "tsc -p tsconfig.build-cjs.json",
+    "build:esm": "tsc -p tsconfig.build-esm.json",
+    "build:types": "tsc -p tsconfig.build-types.json",
+    "build": "npm run build:clean && npm run build:cjs && npm run build:esm && npm run build:types",
+    "format": "prettier --write \"{src,test}/**/*.ts\""
+  }
+}