@koalarx/nest-cli 3.0.3 → 3.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Igor D. Rangel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/commands/new-project/index.js

@@ -0,0 +1,70 @@
+import chalk from 'chalk';
+import { execSync } from 'node:child_process';
+import { cpSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const TEMPLATE_BASE = join(__dirname, '../../templates/startup-project');
+const TEMPLATES_DIR = join(__dirname, '../../templates');
+export async function newProject(projectName) {
+    const targetDir = join(process.cwd(), projectName);
+    console.log(chalk.blue('🚀 Criando projeto Koala Nest...'));
+    console.log(chalk.gray(`📁 Destino: ${targetDir}\n`));
+    console.log(chalk.yellow('📋 Copiando estrutura base...'));
+    cpSync(TEMPLATE_BASE, targetDir, {
+        recursive: true,
+        filter: (src) => {
+            const isBlacklisted = src.includes('node_modules') ||
+                (src.includes('dist') && !src.includes('dist-cli')) ||
+                src.includes('.git');
+            return !isBlacklisted;
+        }
+    });
+    console.log(chalk.yellow('📦 Adicionando configurações extras...'));
+    const dockerfilePath = join(TEMPLATES_DIR, 'startup-project', 'Dockerfile');
+    try {
+        cpSync(dockerfilePath, join(targetDir, 'Dockerfile'));
+    }
+    catch {
+        console.log(chalk.red('⚠️  Dockerfile não encontrado nos templates, pulando...'));
+    }
+    console.log(chalk.yellow('⚙️  Configurando package.json...'));
+    const packageJsonPath = join(targetDir, 'package.json');
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    packageJson.name = projectName;
+    writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+    console.log(chalk.yellow('📄 Atualizando README...'));
+    const readmePath = join(targetDir, 'README.md');
+    let readme = readFileSync(readmePath, 'utf-8');
+    readme = readme.replace(/\[projectName\]/g, projectName);
+    writeFileSync(readmePath, readme);
+    console.log(chalk.yellow('🔐 Criando arquivo .env...'));
+    const envTemplate = readFileSync(join(TEMPLATES_DIR, 'env', 'config.txt'), 'utf-8');
+    const envContent = envTemplate.replace(/\[projectName\]/g, projectName.replace(/-/g, '_'));
+    writeFileSync(join(targetDir, '.env'), envContent);
+    console.log(chalk.yellow('🚫 Criando .gitignore...'));
+    const gitIgnoreContent = readFileSync(join(TEMPLATES_DIR, 'gitignore', 'config.txt'), 'utf-8');
+    writeFileSync(join(targetDir, '.gitignore'), gitIgnoreContent);
+    console.log(chalk.yellow('\n📥 Instalando dependências...'));
+    try {
+        execSync(`cd ${projectName} && bun install`, {
+            stdio: 'inherit',
+        });
+        console.log(chalk.yellow('🔨 Gerando Prisma Client...'));
+        execSync(`cd ${projectName} && bun run prisma:generate`, {
+            stdio: 'inherit',
+        });
+    }
+    catch {
+        console.log(chalk.red('⚠️  Erro ao instalar dependências. Execute manualmente:'));
+        console.log(chalk.gray(`  cd ${projectName}`));
+        console.log(chalk.gray(`  bun install`));
+        console.log(chalk.gray(`  bun run prisma:generate`));
+    }
+    console.log(chalk.green('\n✅ Projeto criado com sucesso!'));
+    console.log(chalk.cyan('\n📚 Próximos passos:'));
+    console.log(chalk.gray(`  cd ${projectName}`));
+    console.log(chalk.gray(`  bun run start:dev`));
+    console.log(chalk.gray(`\n📖 Documentação: https://github.com/igordrangel/koala-nest\n`));
+}

package/commands/new-project/new-project.js

@@ -0,0 +1,69 @@
+import chalk from 'chalk';
+import { execSync } from 'node:child_process';
+import { cpSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const TEMPLATE_BASE = join(__dirname, '../../../example');
+const TEMPLATES_DIR = join(__dirname, '../../templates');
+export async function newProject(projectName) {
+    const targetDir = join(process.cwd(), projectName);
+    console.log(chalk.blue('🚀 Criando projeto Koala Nest...'));
+    console.log(chalk.gray(`📁 Destino: ${targetDir}\n`));
+    console.log(chalk.yellow('📋 Copiando estrutura base...'));
+    cpSync(TEMPLATE_BASE, targetDir, {
+        recursive: true,
+        filter: (src) => {
+            return !src.includes('node_modules') &&
+                !src.includes('dist') &&
+                !src.includes('.git');
+        }
+    });
+    console.log(chalk.yellow('📦 Adicionando configurações extras...'));
+    const dockerfilePath = join(TEMPLATES_DIR, 'startup-project', 'Dockerfile');
+    try {
+        cpSync(dockerfilePath, join(targetDir, 'Dockerfile'));
+    }
+    catch {
+        console.log(chalk.red('⚠️  Dockerfile não encontrado nos templates, pulando...'));
+    }
+    console.log(chalk.yellow('⚙️  Configurando package.json...'));
+    const packageJsonPath = join(targetDir, 'package.json');
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    packageJson.name = projectName;
+    writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+    console.log(chalk.yellow('📄 Atualizando README...'));
+    const readmePath = join(targetDir, 'README.md');
+    let readme = readFileSync(readmePath, 'utf-8');
+    readme = readme.replace(/\[projectName\]/g, projectName);
+    writeFileSync(readmePath, readme);
+    console.log(chalk.yellow('🔐 Criando arquivo .env...'));
+    const envTemplate = readFileSync(join(TEMPLATES_DIR, 'env', 'config.txt'), 'utf-8');
+    const envContent = envTemplate.replace(/\[projectName\]/g, projectName.replace(/-/g, '_'));
+    writeFileSync(join(targetDir, '.env'), envContent);
+    console.log(chalk.yellow('🚫 Criando .gitignore...'));
+    const gitIgnoreContent = readFileSync(join(TEMPLATES_DIR, 'gitignore', 'config.txt'), 'utf-8');
+    writeFileSync(join(targetDir, '.gitignore'), gitIgnoreContent);
+    console.log(chalk.yellow('\n📥 Instalando dependências...'));
+    try {
+        execSync(`cd ${projectName} && bun install`, {
+            stdio: 'inherit',
+        });
+        console.log(chalk.yellow('🔨 Gerando Prisma Client...'));
+        execSync(`cd ${projectName} && bun build:prisma`, {
+            stdio: 'inherit',
+        });
+    }
+    catch {
+        console.log(chalk.red('⚠️  Erro ao instalar dependências. Execute manualmente:'));
+        console.log(chalk.gray(`  cd ${projectName}`));
+        console.log(chalk.gray(`  bun install`));
+        console.log(chalk.gray(`  bun build:prisma`));
+    }
+    console.log(chalk.green('\n✅ Projeto criado com sucesso!'));
+    console.log(chalk.cyan('\n📚 Próximos passos:'));
+    console.log(chalk.gray(`  cd ${projectName}`));
+    console.log(chalk.gray(`  bun run start:dev`));
+    console.log(chalk.gray(`\n📖 Documentação: https://github.com/igordrangel/koala-nest\n`));
+}

package/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import program from 'commander';
+import inquirer from 'inquirer';
+import { newProject } from './commands/new-project/index.js';
+import chalk from 'chalk';
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+const banner = `
+  _  __           _         _   _           _      ____ _     ___ 
+ | |/ /___   __ _| | __ _  | \\ | | ___  ___| |_   / ___| |   |_ _|
+ | ' // _ \\ / _\` | |/ _\` | |  \\| |/ _ \\/ __| __| | |   | |    | |
+ | . \\ (_) | (_| | | (_| | | |\\  |  __/\\__ \\ |_  | |___| |___ | |
+ |_|\\_\\___/ \\__,_|_|\\__,_| |_| \\_|\\___||___/\\__|  \\____|_____|___|
+`;
+console.log(chalk.cyan(banner));
+program.version(packageJson.version);
+program
+    .command('new [projectName]')
+    .description('Cria um novo projeto Nest com Koala Nest')
+    .action(async (projectName) => {
+    if (!projectName) {
+        projectName = await inquirer
+            .prompt([
+            {
+                type: 'input',
+                name: 'projectName',
+                message: 'Informe o nome do projeto',
+                validate: (value) => value ? true : 'Não é permitido um nome vazio',
+            },
+        ])
+            .then((answers) => answers.projectName);
+    }
+    await newProject(projectName);
+});
+program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koalarx/nest-cli",
-  "version": "3.0.3",
+  "version": "3.0.4",
   "description": "CLI para criação de projetos utilizando Koala Nest",
   "main": "index.js",
   "bin": {
@@ -24,5 +24,11 @@
   "bugs": {
     "url": "https://github.com/igordrangel/koala-nest/issues"
   },
-  "homepage": "https://github.com/igordrangel/koala-nest/tree/main/apps/koala-nest-cli#readme"
-}
+  "homepage": "https://github.com/igordrangel/koala-nest/tree/main/apps/koala-nest-cli#readme",
+  "dependencies": {
+    "chalk": "^2.4.2",
+    "commander": "^2.19.0",
+    "inquirer": "^6.2.2",
+    "shelljs": "^0.8.3"
+  }
+}

package/templates/startup-project/.prettierrc.json

@@ -0,0 +1,9 @@
+{
+  "printWidth": 80,
+  "tabWidth": 2,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "arrowParens": "always",
+  "semi": false,
+  "endOfLine": "lf"
+}

package/templates/startup-project/eslint.config.mts

@@ -0,0 +1,85 @@
+import js from '@eslint/js'
+import vitest from '@vitest/eslint-plugin'
+import globals from 'globals'
+import tseslint from 'typescript-eslint'
+import prettierConfig from 'eslint-config-prettier'
+import prettierPlugin from 'eslint-plugin-prettier'
+
+export default [
+  {
+    ignores: [
+      '**/*.json',
+      'node_modules',
+      'dist',
+      'coverage',
+      'prisma/generated',
+    ],
+  },
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  prettierConfig,
+  {
+    files: ['src/**/*.ts', 'scripts/*.mjs'],
+    languageOptions: {
+      parser: tseslint.parser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+      },
+      globals: globals.node,
+    },
+    plugins: {
+      '@typescript-eslint': tseslint.plugin,
+      prettier: prettierPlugin,
+    },
+    rules: {
+      'prettier/prettier': [
+        'warn',
+        {
+          printWidth: 80,
+          tabWidth: 2,
+          singleQuote: true,
+          trailingComma: 'all',
+          arrowParens: 'always',
+          semi: false,
+          endOfLine: 'lf',
+        },
+      ],
+      'no-unused-vars': 'off',
+      'no-useless-constructor': 'off',
+      'no-new': 'off',
+      'no-use-before-define': 'off',
+      '@typescript-eslint/no-unused-vars': 'warn',
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-unsafe-function-type': 'off',
+      '@typescript-eslint/ban-ts-comment': 'off',
+      '@typescript-eslint/no-unsafe-assignment': 'off',
+      '@typescript-eslint/no-unsafe-member-access': 'off',
+      '@typescript-eslint/no-unsafe-call': 'off',
+      'lines-between-class-members': [
+        'warn',
+        'always',
+        { exceptAfterSingleLine: true },
+      ],
+    },
+  },
+  {
+    files: [
+      'src/**/*.e2e-spec.ts',
+      'src/**/*.spec.ts',
+      'src/test/setup-e2e.ts',
+    ],
+    languageOptions: {
+      globals: {
+        ...vitest.environments.env.globals,
+      },
+    },
+    plugins: {
+      vitest,
+    },
+    rules: {
+      ...vitest.configs.recommended.rules,
+      'vitest/no-conditional-expect': 'off',
+    },
+  },
+]

package/templates/{root-files-folders → startup-project}/package.json

@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@koalarx/utils": "^4.2.1",
-    "@koalarx/nest": "KOALARX_NEST_VERSION",
+    "@koalarx/nest": "^undefined",
     "@nestjs/common": "^11.0.12",
     "@nestjs/config": "^4.0.1",
     "@nestjs/core": "^11.0.12",

package/templates/startup-project/prisma/migrations/20250320165043_init/migration.sql

@@ -0,0 +1,19 @@
+-- CreateTable
+CREATE TABLE "Person" (
+    "id" SERIAL NOT NULL,
+    "name" TEXT NOT NULL,
+
+    CONSTRAINT "Person_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "PersonPhone" (
+    "id" SERIAL NOT NULL,
+    "phone" TEXT NOT NULL,
+    "personId" INTEGER NOT NULL,
+
+    CONSTRAINT "PersonPhone_pkey" PRIMARY KEY ("id")
+);
+
+-- AddForeignKey
+ALTER TABLE "PersonPhone" ADD CONSTRAINT "PersonPhone_personId_fkey" FOREIGN KEY ("personId") REFERENCES "Person"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/templates/startup-project/prisma/migrations/20250320171528_aplicando_map_de_tabelas_e_colunas/migration.sql

@@ -0,0 +1,35 @@
+/*
+  Warnings:
+
+  - You are about to drop the `Person` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `PersonPhone` table. If the table is not empty, all the data it contains will be lost.
+
+*/
+-- DropForeignKey
+ALTER TABLE "PersonPhone" DROP CONSTRAINT "PersonPhone_personId_fkey";
+
+-- DropTable
+DROP TABLE "Person";
+
+-- DropTable
+DROP TABLE "PersonPhone";
+
+-- CreateTable
+CREATE TABLE "person" (
+    "id" SERIAL NOT NULL,
+    "name" TEXT NOT NULL,
+
+    CONSTRAINT "person_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "person_phone" (
+    "id" SERIAL NOT NULL,
+    "phone" TEXT NOT NULL,
+    "person_id" INTEGER NOT NULL,
+
+    CONSTRAINT "person_phone_pkey" PRIMARY KEY ("id")
+);
+
+-- AddForeignKey
+ALTER TABLE "person_phone" ADD CONSTRAINT "person_phone_person_id_fkey" FOREIGN KEY ("person_id") REFERENCES "person"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/templates/startup-project/prisma/migrations/20250321190248_incluindo_status_ao_person/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "person" ADD COLUMN     "active" BOOLEAN NOT NULL DEFAULT true;

package/templates/startup-project/prisma/migrations/20250326185507_incluindo_tabela_de_endereco/migration.sql

@@ -0,0 +1,19 @@
+/*
+  Warnings:
+
+  - Added the required column `person_address_id` to the `person` table without a default value. This is not possible if the table is not empty.
+
+*/
+-- AlterTable
+ALTER TABLE "person" ADD COLUMN     "person_address_id" INTEGER NOT NULL;
+
+-- CreateTable
+CREATE TABLE "person_address" (
+    "id" SERIAL NOT NULL,
+    "address" TEXT NOT NULL,
+
+    CONSTRAINT "person_address_pkey" PRIMARY KEY ("id")
+);
+
+-- AddForeignKey
+ALTER TABLE "person" ADD CONSTRAINT "person_person_address_id_fkey" FOREIGN KEY ("person_address_id") REFERENCES "person_address"("id") ON DELETE RESTRICT ON UPDATE CASCADE;

package/templates/startup-project/prisma/migrations/20250326195627_aplicando_on_delete_cascade/migration.sql

@@ -0,0 +1,5 @@
+-- DropForeignKey
+ALTER TABLE "person" DROP CONSTRAINT "person_person_address_id_fkey";
+
+-- AddForeignKey
+ALTER TABLE "person" ADD CONSTRAINT "person_person_address_id_fkey" FOREIGN KEY ("person_address_id") REFERENCES "person_address"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/templates/startup-project/prisma/migrations/20250326200821_removendo_ondelete_cascade/migration.sql

@@ -0,0 +1,5 @@
+-- DropForeignKey
+ALTER TABLE "person" DROP CONSTRAINT "person_person_address_id_fkey";
+
+-- AddForeignKey
+ALTER TABLE "person" ADD CONSTRAINT "person_person_address_id_fkey" FOREIGN KEY ("person_address_id") REFERENCES "person_address"("id") ON DELETE RESTRICT ON UPDATE CASCADE;

package/templates/startup-project/prisma/migrations/migration_lock.toml

@@ -0,0 +1,3 @@
+# Please do not edit this file manually
+# It should be added in your version-control system (e.g., Git)
+provider = "postgresql"

package/templates/startup-project/prisma/schema.prisma

@@ -0,0 +1,39 @@
+generator client {
+  provider = "prisma-client"
+  output   = "generated"
+}
+
+datasource db {
+  provider = "postgresql"
+}
+
+model Person {
+  id              Int     @id @default(autoincrement())
+  name            String
+  active          Boolean @default(true)
+  personAddressId Int     @map("person_address_id")
+
+  phones  PersonPhone[]
+  address PersonAddress @relation(fields: [personAddressId], references: [id])
+
+  @@map("person")
+}
+
+model PersonPhone {
+  id    Int    @id @default(autoincrement())
+  phone String
+
+  personId Int    @map("person_id")
+  person   Person @relation(fields: [personId], references: [id], onDelete: Cascade)
+
+  @@map("person_phone")
+}
+
+model PersonAddress {
+  id      Int    @id @default(autoincrement())
+  address String
+
+  people Person[]
+
+  @@map("person_address")
+}

package/templates/startup-project/prisma.config.ts

@@ -0,0 +1,8 @@
+import 'dotenv/config'
+import { defineConfig, env } from 'prisma/config'
+
+export default defineConfig({
+  datasource: {
+    url: env('DATABASE_URL'),
+  },
+})

package/templates/startup-project/src/application/mapping/mapping.profile.ts

@@ -0,0 +1,10 @@
+import { AutoMappingProfile } from '@koalarx/nest/core/mapping/auto-mapping-profile'
+import { Injectable } from '@nestjs/common'
+import { PersonMapping } from './person.mapping'
+
+@Injectable()
+export class MappingProfile implements AutoMappingProfile {
+  profile(): void {
+    PersonMapping.createMap()
+  }
+}

package/templates/startup-project/src/application/mapping/person.mapping.ts

@@ -0,0 +1,39 @@
+import { ReadManyPersonDto } from '@/domain/dtos/read-many-person.dto'
+import { Person } from '@/domain/entities/person/person'
+import { PersonAddress } from '@/domain/entities/person/person-address'
+import { PersonPhone } from '@/domain/entities/person/person-phone'
+import { createMap } from '@koalarx/nest/core/mapping/create-map'
+import {
+  CreatePersonAddressRequest,
+  CreatePersonPhoneRequest,
+  CreatePersonRequest,
+} from '../person/create/create-person.request'
+import { ReadManyPersonRequest } from '../person/read-many/read-many-person.request'
+import {
+  ReadPersonAddressResponse,
+  ReadPersonPhoneResponse,
+  ReadPersonResponse,
+} from '../person/read/read-person.response'
+import {
+  UpdatePersonAddressRequest,
+  UpdatePersonPhoneRequest,
+  UpdatePersonRequest,
+} from '../person/update/update-person.request'
+
+export class PersonMapping {
+  static createMap() {
+    createMap(CreatePersonAddressRequest, PersonAddress)
+    createMap(CreatePersonPhoneRequest, PersonPhone)
+    createMap(CreatePersonRequest, Person)
+
+    createMap(PersonAddress, ReadPersonAddressResponse)
+    createMap(PersonPhone, ReadPersonPhoneResponse)
+    createMap(Person, ReadPersonResponse)
+
+    createMap(ReadManyPersonRequest, ReadManyPersonDto)
+
+    createMap(UpdatePersonAddressRequest, PersonAddress)
+    createMap(UpdatePersonPhoneRequest, PersonPhone)
+    createMap(UpdatePersonRequest, Person)
+  }
+}

package/templates/startup-project/src/application/person/common/persist-person.request.ts

@@ -0,0 +1,28 @@
+import { AutoMap } from '@koalarx/nest/core/mapping/auto-mapping.decorator'
+import { ApiProperty } from '@nestjs/swagger'
+
+export class PersistPersonAddressRequest {
+  @ApiProperty({ example: 'Street 1' })
+  @AutoMap()
+  address: string
+}
+
+export class PersistPersonPhoneRequest {
+  @ApiProperty({ example: '22999999999' })
+  @AutoMap()
+  phone: string
+}
+
+export class PersistPersonRequest {
+  @ApiProperty({ example: 'John Doe' })
+  @AutoMap()
+  name: string
+
+  @ApiProperty({ type: [PersistPersonPhoneRequest] })
+  @AutoMap({ type: () => PersistPersonPhoneRequest, isArray: { addTo: true } })
+  phones: Array<PersistPersonPhoneRequest>
+
+  @ApiProperty({ type: PersistPersonAddressRequest })
+  @AutoMap({ type: () => PersistPersonAddressRequest })
+  address: PersistPersonAddressRequest
+}

package/templates/startup-project/src/application/person/create/create-person.handler.spec.ts

@@ -0,0 +1,22 @@
+import { createUnitTestApp } from '@/test/create-unit-test-app'
+import { createPersonRequestMockup } from '@/test/mockup/person/create-person-request.mockup'
+import { CreatePersonHandler } from './create-person.handler'
+
+describe('CreatePersonHandler', () => {
+  const app = createUnitTestApp()
+
+  it('should create a person', async () => {
+    const handler = app.get(CreatePersonHandler)
+    const request = createPersonRequestMockup
+
+    const result = await handler.handle(request)
+
+    expect(result.isOk()).toBeTruthy()
+
+    if (result.isOk()) {
+      expect(result.value).toEqual({
+        id: expect.any(Number),
+      })
+    }
+  })
+})

package/templates/startup-project/src/application/person/create/create-person.handler.ts

@@ -0,0 +1,39 @@
+import { Person } from '@/domain/entities/person/person'
+import { IPersonRepository } from '@/domain/repositories/iperson.repository'
+import { AutoMappingService } from '@koalarx/nest/core/mapping/auto-mapping.service'
+import { RequestHandlerBase } from '@koalarx/nest/core/request-overflow/request-handler.base'
+import {
+  ok,
+  RequestResult,
+} from '@koalarx/nest/core/request-overflow/request-result'
+import { Injectable } from '@nestjs/common'
+import { CreatePersonRequest } from './create-person.request'
+import { CreatePersonResponse } from './create-person.response'
+import { CreatePersonValidator } from './create-person.validator'
+
+@Injectable()
+export class CreatePersonHandler extends RequestHandlerBase<
+  CreatePersonRequest,
+  RequestResult<Error, CreatePersonResponse>
+> {
+  constructor(
+    private readonly mapper: AutoMappingService,
+    private readonly repository: IPersonRepository,
+  ) {
+    super()
+  }
+
+  async handle(
+    req: CreatePersonRequest,
+  ): Promise<RequestResult<Error, CreatePersonResponse>> {
+    const person = this.mapper.map(
+      new CreatePersonValidator(req).validate(),
+      CreatePersonRequest,
+      Person,
+    )
+
+    const result = await this.repository.save(person)
+
+    return ok({ id: result.id })
+  }
+}

package/templates/startup-project/src/application/person/create/create-person.request.ts

@@ -0,0 +1,11 @@
+import {
+  PersistPersonAddressRequest,
+  PersistPersonPhoneRequest,
+  PersistPersonRequest,
+} from '../common/persist-person.request'
+
+export class CreatePersonAddressRequest extends PersistPersonAddressRequest {}
+
+export class CreatePersonPhoneRequest extends PersistPersonPhoneRequest {}
+
+export class CreatePersonRequest extends PersistPersonRequest {}

package/templates/startup-project/src/application/person/create/create-person.response.ts

@@ -0,0 +1,3 @@
+import { CreatedRegistreWithIdResponse } from '@koalarx/nest/core/controllers/created-registre-response.base'
+
+export class CreatePersonResponse extends CreatedRegistreWithIdResponse {}

package/templates/startup-project/src/application/person/create/create-person.validator.ts

@@ -0,0 +1,19 @@
+import { RequestValidatorBase } from '@koalarx/nest/core/request-overflow/request-validator.base'
+import { z, ZodType, ZodTypeDef } from 'zod'
+import { CreatePersonRequest } from './create-person.request'
+
+export class CreatePersonValidator extends RequestValidatorBase<CreatePersonRequest> {
+  protected get schema(): ZodType<any, ZodTypeDef, any> {
+    return z.object({
+      name: z.string(),
+      phones: z.array(
+        z.object({
+          phone: z.string(),
+        }),
+      ),
+      address: z.object({
+        address: z.string(),
+      }),
+    })
+  }
+}