@koalarx/nest 4.0.5 → 4.0.8

package/cli/commands/new/configure-test-runner.js

@@ -6,8 +6,19 @@ export function configureTestRunner(packageJson, packageManager) {
     scripts["test:watch"] = "bun test --watch";
     return;
   }
-  scripts.test = "vitest run";
-  scripts["test:watch"] = "vitest";
+  scripts.test = "vitest run --config vitest.config.ts";
+  scripts["test:watch"] = "vitest --config vitest.config.ts";
   devDependencies.vitest = "^4.1.8";
   devDependencies["vite-tsconfig-paths"] = "^5.1.4";
 }
+export function configureE2ETestRunner(packageJson, packageManager) {
+  const scripts = packageJson.scripts;
+  const devDependencies = packageJson.devDependencies;
+  devDependencies.supertest ??= "^7.1.0";
+  devDependencies["@types/supertest"] ??= "^6.0.2";
+  if (packageManager === "bun") {
+    scripts["test:e2e"] = "bun test --preload ./src/test/setup-e2e.ts src/test/host/controllers/";
+    return;
+  }
+  scripts["test:e2e"] = "vitest run --config vitest.config.e2e.ts";
+}

package/cli/commands/new/create-ddd-structure.js

@@ -3,7 +3,7 @@ import path from "node:path";
 import { DDD_LAYER_FOLDERS } from "../../constants/domain.js";
 import { patchGeneratedProjectConfig } from "../../utils/patch-generated-project.js";
 import { runCommand } from "../../utils/run-command.js";
-import { configureTestRunner } from "./configure-test-runner.js";
+import { configureE2ETestRunner, configureTestRunner } from "./configure-test-runner.js";
 export async function createDDDStructure(projectName, packageManager) {
   const folders = [...DDD_LAYER_FOLDERS];
   for (const folder of folders) {
@@ -38,14 +38,12 @@ export async function createDDDStructure(projectName, packageManager) {
   packageJson.scripts["migration:revert"] = `${migrationRunner} ${typeormCli} migration:revert ${migrationDatasource}`;
   packageJson.devDependencies ??= {};
   configureTestRunner(packageJson, packageManager);
+  configureE2ETestRunner(packageJson, packageManager);
   delete packageJson.scripts["test:cov"];
   delete packageJson.scripts["test:debug"];
-  delete packageJson.scripts["test:e2e"];
   delete packageJson.jest;
   delete packageJson.devDependencies["@types/jest"];
-  delete packageJson.devDependencies["@types/supertest"];
   delete packageJson.devDependencies["ts-jest"];
-  delete packageJson.devDependencies["supertest"];
   writeFileSync(path.join(process.cwd(), projectName, "package.json"), JSON.stringify(packageJson, null, 2));
   patchGeneratedProjectConfig(path.join(process.cwd(), projectName));
   await runCommand([packageManager, "install"], path.join(process.cwd(), projectName));

package/cli/constants/cli-project-checklist.js

@@ -5,6 +5,21 @@ import {
   resolveNewProjectOptions
 } from "./domain.js";
 import { resolveProjectFeatures } from "../utils/install-module.js";
+export const E2E_INFRA_PATHS = [
+  "src/test/setup-e2e.ts",
+  "src/test/create-e2e-test-app.ts",
+  "src/test/e2e-context.ts",
+  "src/test/utils/create-e2e-database.ts",
+  "src/test/utils/e2e-database-client.ts",
+  "src/test/host/controllers/app/app.e2e.spec.ts"
+];
+export const CRUD_E2E_EXAMPLE_PATHS = [
+  "src/test/host/controllers/person/person.controller.e2e.spec.ts",
+  "src/test/host/controllers/person/lazy-loading.e2e.spec.ts",
+  "src/test/host/controllers/auth/auth.controller.e2e.spec.ts",
+  "src/test/app-auth-test.module.ts",
+  "src/test/create-auth-e2e-test-app.ts"
+];
 export const WORKSPACE_SETUP_PATHS = [
   ".vscode/launch.json",
   ".vscode/settings.json",
@@ -14,6 +29,11 @@ export const WORKSPACE_SETUP_PATHS = [
 ];
 export const CORE_REQUIRED_PATHS = [
   "src/core/env.ts",
+  "src/core/common/list-response.base.ts",
+  "src/core/utils/initialize-undefined-array-props.ts",
+  "src/core/http/rate-limit.middleware.ts",
+  "src/core/utils/resolve-cors-origins.ts",
+  "src/host/bootstrap/apply-http-middleware.ts",
   "src/host/main.ts",
   "src/host/app.module.ts",
   "src/host/jobs/jobs.module.ts",
@@ -172,9 +192,13 @@ export function buildProjectExpectation(template, auth, features) {
   };
 }
 export function requiredPathsForExpectation(expectation) {
-  const paths = [...CORE_REQUIRED_PATHS, ...WORKSPACE_SETUP_PATHS];
+  const paths = [
+    ...CORE_REQUIRED_PATHS,
+    ...WORKSPACE_SETUP_PATHS,
+    ...E2E_INFRA_PATHS
+  ];
   if (expectation.template === Template.CRUD_SAMPLE) {
-    paths.push(...CRUD_TEMPLATE_REQUIRED_PATHS);
+    paths.push(...CRUD_TEMPLATE_REQUIRED_PATHS, ...CRUD_E2E_EXAMPLE_PATHS);
   }
   if (expectation.cache === "redis") {
     paths.push(...CACHE_REDIS_REQUIRED_PATHS);
@@ -196,7 +220,7 @@ export function requiredPathsForExpectation(expectation) {
 export function forbiddenPathsForExpectation(expectation) {
   const paths = [];
   if (expectation.template === Template.DEFAULT) {
-    paths.push(...DEFAULT_TEMPLATE_FORBIDDEN_PATHS);
+    paths.push(...DEFAULT_TEMPLATE_FORBIDDEN_PATHS, ...CRUD_E2E_EXAMPLE_PATHS);
   } else {
     paths.push(...CRUD_TEMPLATE_FORBIDDEN_PATHS);
   }

package/cli/constants/core-packages.js

@@ -5,21 +5,19 @@ export const CORE_PACKAGES = [
   "typeorm",
   "pg",
   "zod",
-  "@scalar/nestjs-api-reference"
+  "@scalar/nestjs-api-reference",
+  "cookie-parser"
 ];
+export const CORE_DEV_PACKAGES = ["@types/cookie-parser"];
 export const CACHE_PACKAGES = ["ioredis"];
 export const AUTH_PACKAGES = [
   "@nestjs/jwt",
   "@nestjs/passport",
   "passport",
   "passport-jwt",
-  "cookie-parser",
   "bcrypt"
 ];
-export const AUTH_DEV_PACKAGES = [
-  "@types/cookie-parser",
-  "@types/bcrypt"
-];
+export const AUTH_DEV_PACKAGES = ["@types/bcrypt"];
 export const CRON_PACKAGES = ["cron-parser"];
 export const HEALTH_PACKAGES = ["@nestjs/terminus", "@nestjs/axios"];
 export function devAddFlag(packageManager) {

package/cli/utils/install-module.js

@@ -11,6 +11,7 @@ import {
   AUTH_DEV_PACKAGES,
   AUTH_PACKAGES,
   CACHE_PACKAGES,
+  CORE_DEV_PACKAGES,
   CORE_PACKAGES,
   CRON_PACKAGES,
   devAddFlag,
@@ -34,7 +35,9 @@ import {
   stripInfraModuleCache
 } from "./patch-infra-module.js";
 import { patchAuthInstall } from "./patch-auth-install.js";
-import { patchMainForAuth, stripMainOptionalFeatures } from "./patch-main.js";
+import {
+  patchMainForAuth
+} from "./patch-main.js";
 import { restoreDefineDocumentationWithAuth } from "./patch-define-documentation.js";
 import { pruneCoreAuthForSlimTemplate } from "./prune-core-auth.js";
 import { removeSampleParts } from "./remove-sample-parts.js";
@@ -127,15 +130,16 @@ export async function installModule(module, template, projectName = "", options
       install("src/infra/repositories/repository.base.ts", projectName);
       install("src/infra/repositories/repository.module.ts", projectName);
       install("src/infra/infra.module.ts", projectName);
+      install("src/core/http/rate-limit.middleware.ts", projectName);
+      install("src/core/utils/resolve-cors-origins.ts", projectName);
+      install("src/host/bootstrap/apply-http-middleware.ts", projectName);
+      install("src/test/core/http/rate-limit.middleware.spec.ts", projectName);
+      install("src/test/core/resolve-cors-origins.spec.ts", projectName);
       install("src/test", projectName);
       rmSync(path.join(resolveProjectPath(projectName), "src/core/background-services"), { recursive: true, force: true });
       rmSync(path.join(resolveProjectPath(projectName), "src/core/utils/cron-expression-to-boolean.ts"), { force: true });
       rmSync(path.join(resolveProjectPath(projectName), "src/core/utils/person-list-cache.ts"), { force: true });
       rmSync(path.join(resolveProjectPath(projectName), "src/core/utils/build-list-cache-key.ts"), { force: true });
-      rmSync(path.join(resolveProjectPath(projectName), "src/host/bootstrap"), {
-        recursive: true,
-        force: true
-      });
       rmSync(path.join(resolveProjectPath(projectName), "src/host/controllers/health-check"), { recursive: true, force: true });
       rmSync(path.join(resolveProjectPath(projectName), "src/infra/services/database.indicator.service.ts"), { force: true });
       rmSync(path.join(resolveProjectPath(projectName), "src/infra/services/redis.indicator.service.ts"), { force: true });
@@ -153,10 +157,14 @@ export async function installModule(module, template, projectName = "", options
       for (const configFile of ["tsconfig.build.json", ".env.example"]) {
         cpSync(path.join(getSourceCodePath(), configFile), path.join(projectPath, configFile));
       }
+      if (packageManager !== "bun") {
+        for (const configFile of ["vitest.config.ts", "vitest.config.e2e.ts"]) {
+          cpSync(path.join(getSourceCodePath(), configFile), path.join(projectPath, configFile));
+        }
+      }
       patchInfraModuleFile(projectName, false);
-      patchMainFile(projectName, stripMainOptionalFeatures);
       if (!options.skipPackages) {
-        await installPackages(projectName, CORE_PACKAGES);
+        await installPackages(projectName, CORE_PACKAGES, CORE_DEV_PACKAGES);
       }
       if (template === Template.DEFAULT) {
         await removeSampleParts(projectName);

package/cli/utils/install-workspace-config.js

@@ -45,6 +45,8 @@ export function installWorkspaceConfig(projectName, packageManager) {
         task.command = runScriptCommand(packageManager, "start:dev");
       } else if (task.command.includes("test")) {
         task.command = runScriptCommand(packageManager, "test");
+      } else if (task.command.includes("test:e2e")) {
+        task.command = runScriptCommand(packageManager, "test:e2e");
       } else if (task.command.includes("migration:run")) {
         task.command = runScriptCommand(packageManager, "migration:run");
       }

package/cli/utils/parse-new-args.js

@@ -1,5 +1,4 @@
 import {
-  AuthStrategy,
   FEATURE_ALIASES,
   parseAuthStrategies,
   Template,

package/cli/utils/patch-app-test-module.js

@@ -0,0 +1,29 @@
+import { writeFileSync } from "node:fs";
+import path from "node:path";
+import { resolveProjectPath } from "./resolve-project-path.js";
+const defaultAppTestModule = `import { envSchema } from '@/core/env';
+import { Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+import { InfraModule } from '@/infra/infra.module';
+import { e2eDatabaseUrl } from '@/test/e2e-context';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({
+      isGlobal: true,
+      ignoreEnvFile: true,
+      validate: () =>
+        envSchema.parse({
+          PORT: 3000,
+          NODE_ENV: 'test',
+          DATABASE_URL: e2eDatabaseUrl,
+        }),
+    }),
+    InfraModule,
+  ],
+})
+export class AppTestModule {}
+`;
+export function patchAppTestModuleForDefault(projectName) {
+  writeFileSync(path.join(resolveProjectPath(projectName), "src/test/app-test.module.ts"), defaultAppTestModule);
+}

package/cli/utils/patch-env.js

@@ -8,12 +8,17 @@ import { z } from 'zod';
 
 export const envSchema = z.object({
   PORT: z.coerce.number().default(3000),
+  HOST: z.string().default('0.0.0.0'),
   NODE_ENV: z.enum(['test', 'develop', 'staging', 'production']),
   DATABASE_URL: z.string(),
   REDIS_CONNECTION_STRING: z.string().optional(),
   CACHE_KEY_PREFIX: z.string().optional(),
   CRON_JOBS_ENABLED: envBooleanSchema(false),
   BOOTSTRAP_DELAY_MS: z.coerce.number().default(0),
+  RATE_LIMIT_MAX: z.coerce.number().default(0),
+  RATE_LIMIT_WINDOW_MS: z.coerce.number().default(60_000),
+  CORS_ORIGINS: z.string().optional(),
+  BCRYPT_ROUNDS: z.coerce.number().min(4).max(15).default(10),
 });
 
 export type Env = z.infer<typeof envSchema>;
@@ -23,6 +28,8 @@ export function validateEnvConfig(config: Record<string, unknown>): Env {
 }
 `;
 const envExampleWithoutAuth = `PORT=3000
+# Endereço de bind do servidor (Docker/K8s). URLs públicas usam API_HOST.
+HOST=0.0.0.0
 NODE_ENV=develop
 DATABASE_URL=postgresql://postgres:root@localhost:5432/koala_nest
 
@@ -35,6 +42,16 @@ DATABASE_URL=postgresql://postgres:root@localhost:5432/koala_nest
 # Cron jobs internos. Ative com \`kl-nest add cron\`.
 CRON_JOBS_ENABLED=false
 BOOTSTRAP_DELAY_MS=0
+
+# Rate limit (0 = desabilitado)
+# RATE_LIMIT_MAX=300
+# RATE_LIMIT_WINDOW_MS=60000
+
+# CORS — aberto por padrão; restrinja com origens separadas por vírgula se necessário
+# CORS_ORIGINS=http://localhost:4200,https://app.example.com
+
+# Custo do bcrypt (padrão 10)
+# BCRYPT_ROUNDS=10
 `;
 export function stripEnvAuth(projectName) {
   const projectRoot = resolveProjectPath(projectName);
@@ -53,12 +70,17 @@ import { z } from 'zod';
 
 export const envSchema = z.object({
   PORT: z.coerce.number().default(3000),
+  HOST: z.string().default('0.0.0.0'),
   NODE_ENV: z.enum(['test', 'develop', 'staging', 'production']),
   DATABASE_URL: z.string(),
   REDIS_CONNECTION_STRING: z.string().optional(),
   CACHE_KEY_PREFIX: z.string().optional(),
   CRON_JOBS_ENABLED: envBooleanSchema(false),
   BOOTSTRAP_DELAY_MS: z.coerce.number().default(0),
+  RATE_LIMIT_MAX: z.coerce.number().default(0),
+  RATE_LIMIT_WINDOW_MS: z.coerce.number().default(60_000),
+  CORS_ORIGINS: z.string().optional(),
+  BCRYPT_ROUNDS: z.coerce.number().min(4).max(15).default(10),
   JWT_PRIVATE_KEY: z.string().optional(),
   JWT_PUBLIC_KEY: z.string().optional(),
   JWT_ACCESS_TOKEN_EXPIRES_IN: z.string().default('15m'),
@@ -73,6 +95,8 @@ export function validateEnvConfig(config: Record<string, unknown>): Env {
 }
 `;
 const envExampleJwtOnly = `PORT=3000
+# Endereço de bind do servidor (Docker/K8s). URLs públicas usam API_HOST.
+HOST=0.0.0.0
 NODE_ENV=develop
 DATABASE_URL=postgresql://postgres:root@localhost:5432/koala_nest
 
@@ -83,6 +107,16 @@ DATABASE_URL=postgresql://postgres:root@localhost:5432/koala_nest
 CRON_JOBS_ENABLED=false
 BOOTSTRAP_DELAY_MS=0
 
+# Rate limit (0 = desabilitado)
+# RATE_LIMIT_MAX=300
+# RATE_LIMIT_WINDOW_MS=60000
+
+# CORS — aberto por padrão; restrinja com origens separadas por vírgula se necessário
+# CORS_ORIGINS=http://localhost:4200,https://app.example.com
+
+# Custo do bcrypt (padrão 10)
+# BCRYPT_ROUNDS=10
+
 # JWT (RS256 — chaves em base64)
 JWT_PRIVATE_KEY=
 JWT_PUBLIC_KEY=

package/cli/utils/patch-main.js

@@ -1,8 +1,7 @@
-export function stripMainOptionalFeatures(content) {
-  return content.replace(/import cookieParser from 'cookie-parser';\n/, "").replace(/\n {2}app\.use\(cookieParser\(\)\);\n/, `
-`);
-}
 export function patchMainForAuth(content) {
+  if (content.includes("applyHttpMiddleware")) {
+    return content;
+  }
   if (content.includes("cookieParser()")) {
     return content;
   }

package/cli/utils/remove-sample-parts.js

@@ -2,8 +2,8 @@ import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { removeImportLines } from "./project-files.js";
 import { patchAppModuleJobs } from "./patch-jobs-module.js";
+import { patchAppTestModuleForDefault } from "./patch-app-test-module.js";
 import { resolveProjectPath } from "./resolve-project-path.js";
-import { stripMainOptionalFeatures } from "./patch-main.js";
 import { stripDefineDocumentationAuth } from "./patch-define-documentation.js";
 import { stripEnvAuth } from "./patch-env.js";
 import { pruneCoreAuthForSlimTemplate } from "./prune-core-auth.js";
@@ -85,11 +85,13 @@ const partsToRemove = [
     replace: [{ from: "PersonMapper.createMap();", to: "" }]
   }
 ];
-const defaultTemplatePathsToRemove = [
+const defaultSampleTestPathsToRemove = [
   "src/test/application",
   "src/test/mockup/person",
   "src/test/host/controllers/person/person.controller.e2e.spec.ts",
-  "src/test/host/controllers/person/lazy-loading.e2e.spec.ts",
+  "src/test/host/controllers/person/lazy-loading.e2e.spec.ts"
+];
+const defaultAuthE2ePathsToRemove = [
   "src/test/host/controllers/auth/auth.controller.e2e.spec.ts",
   "src/test/app-auth-test.module.ts",
   "src/test/create-auth-e2e-test-app.ts"
@@ -154,7 +156,11 @@ export async function removeSampleParts(projectName) {
     writeFileSync(partPath, content, "utf8");
   }
   patchAppModuleJobs(projectName, { eventHandlers: [], cronJobs: [] });
-  removePaths(projectName, defaultTemplatePathsToRemove);
+  patchAppTestModuleForDefault(projectName);
+  removePaths(projectName, [
+    ...defaultSampleTestPathsToRemove,
+    ...defaultAuthE2ePathsToRemove
+  ]);
 }
 export async function cleanDefaultTemplateWithoutAuth(projectName) {
   stripDefaultProjectAuth(projectName);
@@ -198,6 +204,6 @@ function stripDefaultProjectAuth(projectName) {
     ]);
     main = main.replace(/\n {2}app\.useGlobalGuards\([\s\S]*?\);\n/, `
 `);
-    writeFileSync(mainPath, stripMainOptionalFeatures(main), "utf8");
+    writeFileSync(mainPath, main, "utf8");
   }
 }

package/koala-nest/.env.example

@@ -1,4 +1,6 @@
 PORT=3000
+# Endereço de bind do servidor (Docker/K8s). URLs públicas usam API_HOST.
+HOST=0.0.0.0
 NODE_ENV=develop
 DATABASE_URL=postgresql://postgres:root@localhost:5432/koala_nest
 
@@ -12,6 +14,16 @@ DATABASE_URL=postgresql://postgres:root@localhost:5432/koala_nest
 CRON_JOBS_ENABLED=true
 BOOTSTRAP_DELAY_MS=0
 
+# Rate limit (0 = desabilitado)
+# RATE_LIMIT_MAX=300
+# RATE_LIMIT_WINDOW_MS=60000
+
+# CORS — aberto por padrão; restrinja com origens separadas por vírgula se necessário
+# CORS_ORIGINS=http://localhost:4200,https://app.example.com
+
+# Custo do bcrypt (padrão 10)
+# BCRYPT_ROUNDS=10
+
 # JWT (RS256 — chaves em base64) — ative com `kl-nest new --auth jwt` ou `kl-nest add auth jwt`
 JWT_PRIVATE_KEY=
 JWT_PUBLIC_KEY=

package/koala-nest/.vscode/tasks.json

@@ -25,6 +25,15 @@
       "group": "test",
       "label": "Run tests"
     },
+    {
+      "type": "shell",
+      "command": "bun run test:e2e",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "group": "test",
+      "label": "Run E2E tests"
+    },
     {
       "type": "shell",
       "command": "bun run migration:run",

package/koala-nest/src/application/common/pagination.request.ts

@@ -3,11 +3,6 @@ import { AutoMap } from '@/core/tools/mapping';
 import type { QueryDirectionType } from '@/core/types';
 import { ApiProperty } from '@nestjs/swagger';
 
-export type PaginatedRequestProps<T extends PaginationRequest> = Omit<
-  { [K in keyof T as T[K] extends Function ? never : K]: T[K] },
-  '_id'
->;
-
 export class PaginationRequest {
   @ApiProperty({
     required: false,

package/koala-nest/src/application/common/request-validator.base.ts

@@ -6,7 +6,7 @@ export abstract class RequestValidatorBase<
   protected _request: Record<string, any>;
 
   constructor(request: TRequest) {
-    this._request = { ...request };
+    this._request = RequestValidatorBase.toValidationInput(request);
   }
 
   validate(): TRequest {
@@ -30,4 +30,39 @@ export abstract class RequestValidatorBase<
   }
 
   protected abstract get schema(): ZodType;
+
+  /**
+   * Objetos plain (query HTTP) passam direto. Instâncias de classe carregam
+   * defaults nos fields — removemos os que não foram alterados para o Zod
+   * aplicar defaults/transforms sem sobrescrever query params explícitos.
+   */
+  private static toValidationInput<T extends Record<string, unknown>>(
+    request: T,
+  ): Record<string, unknown> {
+    if (request === null || typeof request !== 'object') {
+      return {};
+    }
+
+    const prototype = Object.getPrototypeOf(request);
+    const isClassInstance =
+      prototype !== null &&
+      prototype !== Object.prototype &&
+      typeof prototype.constructor === 'function';
+
+    if (!isClassInstance) {
+      return { ...request };
+    }
+
+    const Constructor = prototype.constructor as new () => T;
+    const defaultValues = new Constructor() as Record<string, unknown>;
+    const input: Record<string, unknown> = { ...request };
+
+    for (const key of Object.keys(defaultValues)) {
+      if (Object.is(input[key], defaultValues[key])) {
+        delete input[key];
+      }
+    }
+
+    return input;
+  }
 }

package/koala-nest/src/application/mapping/person.mapper.ts

@@ -15,11 +15,6 @@ import {
   ReadPersonContactResponse,
   ReadPersonResponse,
 } from '@/application/person/read/read-person.response';
-import {
-  UpdatePersonAddressRequest,
-  UpdatePersonContactRequest,
-  UpdatePersonRequest,
-} from '@/application/person/update/update-person.request';
 import { ReadManyPersonResponseItem } from '@/application/person/read-many/read-many-person.response';
 
 export class PersonMapper {
@@ -34,10 +29,6 @@ export class PersonMapper {
     createMap(CreatePersonAddressRequest, PersonAddress);
     createMap(CreatePersonContactRequest, PersonContact);
 
-    createMap(UpdatePersonRequest, Person);
-    createMap(UpdatePersonAddressRequest, PersonAddress);
-    createMap(UpdatePersonContactRequest, PersonContact);
-
     createMap(ReadManyPersonRequest, PersonQueryDto);
     createMap(Person, ReadManyPersonResponseItem);
   }

package/koala-nest/src/application/person/jobs/cron/delete-inactive.job.ts

@@ -1,16 +1,18 @@
 import { CronExpression } from '@/core/constants/cron.constants';
 import { DeletePersonHandler } from '@/application/person/delete/delete-person.handler';
-import { ReadManyPersonHandler } from '@/application/person/read-many/read-many-person.handler';
-import { ReadManyPersonRequest } from '@/application/person/read-many/read-many-person.request';
 import {
   CronJobHandlerBase,
   CronJobSettings,
   cronJobSettings,
 } from '@/core/background-services/cron-service/cron-job.handler.base';
+import { PersonQueryDto } from '@/domain/dtos/person-query.dto';
 import { ILoggingService } from '@/domain/common/ilogging.service';
 import { IRedLockService } from '@/domain/common/ired-lock.service';
+import { IPersonRepository } from '@/domain/repositories/iperson.repository';
 import { Injectable, Logger } from '@nestjs/common';
 
+const DELETE_INACTIVE_BATCH_SIZE = 100;
+
 @Injectable()
 export class DeleteInactiveJob extends CronJobHandlerBase {
   private readonly logger = new Logger(DeleteInactiveJob.name);
@@ -18,7 +20,7 @@ export class DeleteInactiveJob extends CronJobHandlerBase {
   constructor(
     redlockService: IRedLockService,
     loggingService: ILoggingService,
-    private readonly readManyPerson: ReadManyPersonHandler,
+    private readonly repository: IPersonRepository,
     private readonly deletePerson: DeletePersonHandler,
   ) {
     super(redlockService, loggingService);
@@ -31,27 +33,42 @@ export class DeleteInactiveJob extends CronJobHandlerBase {
   protected async run(): Promise<void> {
     this.logger.debug('Iniciando remoção de pessoas inativas...');
 
-    const request = new ReadManyPersonRequest();
-    request.active = false;
+    let page = 0;
+    let totalDeleted = 0;
+
+    while (true) {
+      const query = PersonQueryDto.from({
+        active: false,
+        page,
+        limit: DELETE_INACTIVE_BATCH_SIZE,
+      });
+      const { items, count } = await this.repository.findMany(query);
+
+      if (items.length === 0) {
+        break;
+      }
+
+      this.logger.debug('Removendo pessoas inativas...', items.length);
+
+      for (const person of items) {
+        await this.deletePerson.handle(person.id);
+      }
 
-    const result = await this.readManyPerson.handle(request);
+      totalDeleted += items.length;
+      page += 1;
 
-    if (result.items.length === 0) {
+      if (page * DELETE_INACTIVE_BATCH_SIZE >= count) {
+        break;
+      }
+    }
+
+    if (totalDeleted === 0) {
       this.logger.log('Nenhuma pessoa inativa encontrada.');
       this.logger.log('Job concluído sem ação.');
       return;
     }
 
-    this.logger.debug('Removendo pessoas inativas...', result.items.length);
-
-    for (const person of result.items) {
-      await this.deletePerson.handle(person.id);
-    }
-
-    this.logger.log(
-      'Pessoas inativas removidas com sucesso.',
-      result.items.length,
-    );
+    this.logger.log('Pessoas inativas removidas com sucesso.', totalDeleted);
     this.logger.log('Job concluído.');
   }
 }

package/koala-nest/src/application/person/read-many/read-many-person.response.ts

@@ -1,6 +1,5 @@
-import { ObjectClass } from '@/core/base/object-class';
+import { ListResponseBase } from '@/core/common/list-response.base';
 import { AutoMap } from '@/core/tools/mapping';
-import { ListResponse } from '@/core/types';
 import { ApiProperty } from '@nestjs/swagger';
 
 export class ReadManyPersonResponseItem {
@@ -17,14 +16,4 @@ export class ReadManyPersonResponseItem {
   active: boolean;
 }
 
-export class ReadManyPersonResponse extends ObjectClass<
-  ListResponse<ReadManyPersonResponseItem>
-> {
-  @ApiProperty({ type: [ReadManyPersonResponseItem] })
-  @AutoMap({ type: () => ReadManyPersonResponseItem })
-  items: ReadManyPersonResponseItem[];
-
-  @ApiProperty()
-  @AutoMap()
-  count: number;
-}
+export class ReadManyPersonResponse extends ListResponseBase<ReadManyPersonResponseItem> {}