@koalarx/nest 3.1.49 → 4.0.1

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

@@ -0,0 +1,203 @@
+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 { 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";
+import { syncCacheConstantsWithoutOAuth } from "./sync-auth-strategy-files.js";
+const partsToRemove = [
+  {
+    path: "src/infra/repositories/repository.module.ts",
+    removeImports: [
+      "@/domain/repositories/iperson.repository",
+      "@/infra/repositories/person.repository",
+      "./person.repository",
+      "@/domain/repositories/iuser.repository",
+      "@/infra/repositories/user.repository"
+    ],
+    replace: [
+      {
+        from: `providers: [
+    { provide: IPersonRepository, useClass: PersonRepository },
+    { provide: IUserRepository, useClass: UserRepository },
+  ],
+`,
+        to: ""
+      },
+      {
+        from: `providers: [{ provide: IPersonRepository, useClass: PersonRepository }],
+`,
+        to: ""
+      },
+      {
+        from: `providers: [{ provide: IUserRepository, useClass: UserRepository }],
+`,
+        to: ""
+      },
+      { from: ", IPersonRepository", to: "" },
+      { from: ", IUserRepository", to: "" }
+    ]
+  },
+  {
+    path: "src/infra/database/data-source-factory.ts",
+    removeImports: [
+      "@/domain/entities/person/person",
+      "@/domain/entities/person/person-address",
+      "@/domain/entities/person/person-contact",
+      "@/domain/entities/user/user"
+    ],
+    replace: [
+      {
+        from: "entities: [Person, PersonAddress, PersonContact, User],",
+        to: "entities: [],"
+      },
+      {
+        from: "entities: [Person, PersonAddress, PersonContact],",
+        to: "entities: [],"
+      },
+      {
+        from: "entities: [User],",
+        to: "entities: [],"
+      }
+    ]
+  },
+  {
+    path: "src/host/app.module.ts",
+    removeImports: [
+      "./controllers/person/person.module",
+      "@/application/person/jobs/events/person/inactive-person/inactive-person.handler",
+      "@/application/person/jobs/cron/create-person.job",
+      "@/application/person/jobs/cron/delete-inactive.job"
+    ],
+    replace: [
+      { from: `PersonModule,
+`, to: "" },
+      { from: `imports: [PersonModule],
+      `, to: "" }
+    ]
+  },
+  {
+    path: "src/application/mapping/mapping.provider.ts",
+    removeImports: ["./person.mapper"],
+    replace: [{ from: "PersonMapper.createMap();", to: "" }]
+  }
+];
+const defaultTemplatePathsToRemove = [
+  "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/auth/auth.controller.e2e.spec.ts",
+  "src/test/app-auth-test.module.ts",
+  "src/test/create-auth-e2e-test-app.ts"
+];
+const defaultTemplatePathsToRemoveWithoutAuth = [
+  "src/test/application/auth-link.handler.spec.ts",
+  "src/test/application/exchange-code.handler.spec.ts",
+  "src/test/application/login.handler.spec.ts",
+  "src/test/application/refresh-token.handler.spec.ts",
+  "src/test/application/scalar-oauth-token.handler.spec.ts",
+  "src/test/core/auth.guard.spec.ts",
+  "src/test/core/jwt.strategy.spec.ts",
+  "src/test/core/oauth-provider.registry.spec.ts",
+  "src/test/core/profiles.guard.spec.ts",
+  "src/test/host/is-public-open-api.spec.ts",
+  "src/test/host/oauth-callback.controller.spec.ts",
+  "src/test/infra/jwt-token.service.spec.ts",
+  "src/test/infra/logged-user-info.service.spec.ts",
+  "src/test/infra/oauth2-auth.service.spec.ts",
+  "src/test/services/logged-user-info.fake-service.ts",
+  "src/test/utils/jwt-test-keys.ts",
+  "src/test/core/env.spec.ts",
+  "src/test/core/oauth-provider.registry.spec.ts",
+  "src/host/decorators/scalar-token-endpoint.decorator.ts",
+  "src/host/decorators/restriction-by-profile.decorator.ts"
+];
+const defaultTemplateAuthArtifactPaths = [
+  "src/application/auth",
+  "src/domain/auth",
+  "src/domain/entities/user",
+  "src/domain/repositories/iuser.repository.ts",
+  "src/domain/dtos/logged-user-info.dto.ts",
+  "src/domain/services",
+  "src/infra/auth",
+  "src/infra/repositories/user.repository.ts",
+  "src/infra/services/logged-user-info.service.ts",
+  "src/host/security",
+  "src/host/controllers/auth",
+  "src/host/controllers/oauth2",
+  "src/core/types/auth-provider-config-response.type.ts",
+  "src/core/utils/hash-password.ts",
+  "src/core/utils/name-to-login.ts"
+];
+function removePaths(projectName, paths) {
+  for (const relativePath of paths) {
+    rmSync(path.join(resolveProjectPath(projectName), relativePath), {
+      recursive: true,
+      force: true
+    });
+  }
+}
+export async function removeSampleParts(projectName) {
+  for (const part of partsToRemove) {
+    const partPath = path.join(resolveProjectPath(projectName), part.path);
+    let content = readFileSync(partPath, "utf8");
+    if (part.removeImports?.length) {
+      content = removeImportLines(content, part.removeImports);
+    }
+    for (const replace of part.replace ?? []) {
+      content = content.replace(replace.from, replace.to);
+    }
+    writeFileSync(partPath, content, "utf8");
+  }
+  patchAppModuleJobs(projectName, { eventHandlers: [], cronJobs: [] });
+  removePaths(projectName, defaultTemplatePathsToRemove);
+}
+export async function cleanDefaultTemplateWithoutAuth(projectName) {
+  stripDefaultProjectAuth(projectName);
+  stripDefineDocumentationAuth(projectName);
+  stripEnvAuth(projectName);
+  removePaths(projectName, defaultTemplatePathsToRemoveWithoutAuth);
+  removePaths(projectName, defaultTemplateAuthArtifactPaths);
+  pruneCoreAuthForSlimTemplate(projectName);
+  syncCacheConstantsWithoutOAuth(projectName);
+}
+function patchAppModuleForInfra(content) {
+  if (content.includes("InfraModule")) {
+    return content;
+  }
+  const patched = content.replace("import { ConfigModule } from '@nestjs/config';", `import { ConfigModule } from '@nestjs/config';
+import { InfraModule } from '@/infra/infra.module';`);
+  return patched.replace(/(ConfigModule\.forRoot\(\{[\s\S]*?\}\),)\n/, `$1
+    InfraModule,
+`);
+}
+function stripDefaultProjectAuth(projectName) {
+  const projectRoot = resolveProjectPath(projectName);
+  const appModulePath = path.join(projectRoot, "src/host/app.module.ts");
+  const mainPath = path.join(projectRoot, "src/host/main.ts");
+  if (existsSync(appModulePath)) {
+    patchAppModuleJobs(projectName, { eventHandlers: [], cronJobs: [] });
+    let appModule = readFileSync(appModulePath, "utf8");
+    appModule = removeImportLines(appModule, [
+      "./controllers/auth/auth.module",
+      "./security/security.module"
+    ]);
+    appModule = appModule.replace(/\s*SecurityModule,\n/g, "").replace(/\s*AuthModule,\n/g, "");
+    appModule = patchAppModuleForInfra(appModule);
+    writeFileSync(appModulePath, appModule, "utf8");
+  }
+  if (existsSync(mainPath)) {
+    let main = readFileSync(mainPath, "utf8");
+    main = removeImportLines(main, [
+      "./security/guards/auth.guard",
+      "./security/guards/profiles.guard"
+    ]);
+    main = main.replace(/\n {2}app\.useGlobalGuards\([\s\S]*?\);\n/, `
+`);
+    writeFileSync(mainPath, stripMainOptionalFeatures(main), "utf8");
+  }
+}

package/cli/utils/resolve-project-path.js

@@ -0,0 +1,19 @@
+import path from "node:path";
+import { existsSync } from "node:fs";
+export function resolveProjectPath(projectName) {
+  const cwd = process.cwd();
+  if (!projectName || projectName === ".") {
+    return cwd;
+  }
+  if (path.isAbsolute(projectName)) {
+    return projectName;
+  }
+  const nestedPath = path.join(cwd, projectName);
+  if (existsSync(path.join(nestedPath, "package.json"))) {
+    return nestedPath;
+  }
+  if (path.basename(cwd) === projectName && existsSync(path.join(cwd, "package.json"))) {
+    return cwd;
+  }
+  return nestedPath;
+}

package/cli/utils/restore-person-features.js

@@ -0,0 +1,64 @@
+import { cpSync, existsSync, mkdirSync } from "node:fs";
+import path from "node:path";
+import { getSourceCodePath } from "./get-source-code-path.js";
+import { patchAppModuleExampleJobs } from "./patch-jobs-module.js";
+import { resolveProjectPath } from "./resolve-project-path.js";
+function projectFile(projectName, relativePath) {
+  return path.join(resolveProjectPath(projectName), relativePath);
+}
+function hasPersonModule(projectName) {
+  return existsSync(projectFile(projectName, "src/host/controllers/person/person.module.ts"));
+}
+export function copyFromTemplate(relativePath, projectName = "") {
+  const sourcePath = path.join(getSourceCodePath(), relativePath);
+  const targetPath = projectFile(projectName, relativePath);
+  mkdirSync(path.dirname(targetPath), { recursive: true });
+  cpSync(sourcePath, targetPath, { recursive: true, force: true });
+}
+export async function restorePersonCacheFeatures(projectName) {
+  if (!hasPersonModule(projectName)) {
+    return;
+  }
+  const files = [
+    "src/application/person/create/create-person.handler.ts",
+    "src/application/person/update/update-person.handler.ts",
+    "src/application/person/delete/delete-person.handler.ts",
+    "src/application/person/read-many/read-many-person.handler.ts",
+    "src/application/person/jobs/events/person/inactive-person/inactive-person.handler.ts",
+    "src/core/utils/person-list-cache.ts",
+    "src/core/utils/build-list-cache-key.ts"
+  ];
+  for (const file of files) {
+    copyFromTemplate(file, projectName);
+  }
+}
+export async function restorePersonCronJobs(projectName) {
+  if (!hasPersonModule(projectName)) {
+    return;
+  }
+  copyFromTemplate("src/application/person/jobs/cron", projectName);
+  patchAppModuleExampleJobs(projectName, {
+    eventJobs: existsSync(projectFile(projectName, "src/application/person/jobs/events/person/inactive-person/inactive-person.handler.ts")),
+    cronJobs: true
+  });
+}
+export async function restorePersonEventJobs(projectName) {
+  if (!hasPersonModule(projectName)) {
+    return;
+  }
+  copyFromTemplate("src/application/person/jobs/events", projectName);
+  patchAppModuleExampleJobs(projectName, {
+    eventJobs: true,
+    cronJobs: existsSync(projectFile(projectName, "src/application/person/jobs/cron/create-person.job.ts"))
+  });
+}
+export async function restorePersonAuthExample(projectName) {
+  if (!hasPersonModule(projectName)) {
+    return;
+  }
+  copyFromTemplate("src/host/controllers/person/delete-person.controller.ts", projectName);
+}
+export async function upgradeCacheToRedis(projectName) {
+  copyFromTemplate("src/infra/common/redis-cache.service.ts", projectName);
+  copyFromTemplate("src/infra/common/cache-service.provider.ts", projectName);
+}

package/cli/utils/run-command.js

@@ -0,0 +1,31 @@
+import { spawn } from "node:child_process";
+import { isCliVerbose } from "./cli-options.js";
+export function runCommand(command, cwd = process.cwd(), options = {}) {
+  return new Promise((resolve, reject) => {
+    const verbose = options.verbose ?? isCliVerbose();
+    const childProcess = spawn(command[0], command.slice(1), {
+      cwd,
+      stdio: verbose ? "inherit" : "pipe"
+    });
+    let stderr = "";
+    childProcess.stderr?.on("data", (chunk) => {
+      if (verbose) {
+        return;
+      }
+      stderr += chunk.toString();
+    });
+    childProcess.on("close", (code) => {
+      if (code !== 0) {
+        if (!verbose && stderr.trim()) {
+          process.stderr.write(stderr);
+        }
+        reject(new Error(`Command ${command.join(" ")} failed with code ${code}`));
+        return;
+      }
+      resolve();
+    });
+    childProcess.on("error", (error) => {
+      reject(error);
+    });
+  });
+}

package/cli/utils/sync-auth-strategy-files.js

@@ -0,0 +1,63 @@
+import { cpSync, mkdirSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { AuthStrategy } from "../constants/domain.js";
+import { getSourceCodePath } from "./get-source-code-path.js";
+import { resolveProjectPath } from "./resolve-project-path.js";
+const envSpecJwtOnly = `import { describe, expect, it } from 'bun:test';
+import { envSchema } from '@/core/env';
+
+describe('envSchema', () => {
+  it('interpreta CRON_JOBS_ENABLED=false como desabilitado', () => {
+    const env = envSchema.parse({
+      NODE_ENV: 'test',
+      DATABASE_URL: 'postgres://localhost/test',
+      CRON_JOBS_ENABLED: 'false',
+    });
+
+    expect(env.CRON_JOBS_ENABLED).toBe(false);
+  });
+});
+`;
+const cacheConstantsJwtOnly = `/** Prefixos e chaves do cache distribuído / em memória. */
+export const CacheKeyPrefix = {
+  RED_LOCK: 'redLock:',
+} as const;
+
+/** TTLs em segundos para entradas de cache. */
+export const CacheTtlSeconds = {
+  /** Listagem paginada de Person (2 minutos). */
+  PERSON_LIST: 120,
+} as const;
+
+/** TTL padrão do RedLock quando não derivado do cron (segundos). */
+export const DEFAULT_RED_LOCK_TTL_SECONDS = 30;
+`;
+function writeCacheConstantsWithoutOAuth(projectName) {
+  writeProjectFile(projectName, "src/core/constants/cache.constants.ts", cacheConstantsJwtOnly);
+}
+function writeProjectFile(projectName, relativePath, content) {
+  const filePath = path.join(resolveProjectPath(projectName), relativePath);
+  mkdirSync(path.dirname(filePath), { recursive: true });
+  writeFileSync(filePath, content);
+}
+function restoreProjectFile(projectName, relativePath) {
+  cpSync(path.join(getSourceCodePath(), relativePath), path.join(resolveProjectPath(projectName), relativePath), { force: true });
+}
+export function syncAuthStrategySupportFiles(projectName, strategies) {
+  const hasJwt = strategies.includes(AuthStrategy.JWT);
+  const hasOauth = strategies.includes(AuthStrategy.OAUTH2);
+  if (hasJwt && !hasOauth) {
+    writeProjectFile(projectName, "src/test/core/env.spec.ts", envSpecJwtOnly);
+    writeCacheConstantsWithoutOAuth(projectName);
+    return;
+  }
+  for (const relativePath of [
+    "src/test/core/env.spec.ts",
+    "src/core/constants/cache.constants.ts"
+  ]) {
+    restoreProjectFile(projectName, relativePath);
+  }
+}
+export function syncCacheConstantsWithoutOAuth(projectName) {
+  writeCacheConstantsWithoutOAuth(projectName);
+}

package/koala-nest/.env.example

@@ -0,0 +1,34 @@
+PORT=3000
+NODE_ENV=develop
+DATABASE_URL=postgresql://postgres:root@localhost:5432/koala_nest
+
+# Redis (opcional)
+# Instância única: pode omitir — usa memória local (cache, state OAuth2, lock de CronJob em dev).
+# Várias réplicas: recomendado para cache/lock/state OAuth2 consistentes entre processos.
+# REDIS_CONNECTION_STRING=redis://localhost:6379
+# CACHE_KEY_PREFIX=koala-nest
+
+# Cron jobs de exemplo (create/delete person). Habilitado no template para demonstração em dev.
+CRON_JOBS_ENABLED=true
+BOOTSTRAP_DELAY_MS=0
+
+# JWT (RS256 — chaves em base64) — ative com `kl-nest new --auth jwt` ou `kl-nest add auth jwt`
+JWT_PRIVATE_KEY=
+JWT_PUBLIC_KEY=
+JWT_ACCESS_TOKEN_EXPIRES_IN=15m
+JWT_REFRESH_TOKEN_EXPIRES_IN=7d
+API_HOST=http://localhost:3000
+
+# Usuário demo (migration Init): admin@example.com / admin123
+
+# OAuth2 — N provedores via OAUTH2_PROVIDERS (google,microsoft são exemplos)
+# Para cada CHAVE: OAUTH2_{CHAVE}_DOMAIN (OIDC) ou URLs manuais (_AUTHORIZATION_URL, _TOKEN_URL, _USERINFO_URL)
+OAUTH2_PROVIDERS=google,microsoft
+OAUTH2_GOOGLE_DOMAIN=https://accounts.google.com
+OAUTH2_GOOGLE_CLIENT_ID=
+OAUTH2_GOOGLE_CLIENT_SECRET=
+OAUTH2_GOOGLE_SCOPE=openid profile email
+OAUTH2_MICROSOFT_DOMAIN=https://login.microsoftonline.com/common/v2.0
+OAUTH2_MICROSOFT_CLIENT_ID=
+OAUTH2_MICROSOFT_CLIENT_SECRET=
+OAUTH2_MICROSOFT_SCOPE=openid profile email

package/koala-nest/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all"
+}

package/koala-nest/README.md

@@ -0,0 +1,51 @@
+# Koala Nest
+
+Template NestJS com arquitetura em camadas (application, domain, host, infra) usado pela CLI `kl-nest`.
+
+## Documentação
+
+A documentação completa está em [`libs/doc`](../../doc). Para subir o site localmente, na raiz do monorepo:
+
+```bash
+bun run dev:docs
+```
+
+## Desenvolvimento local
+
+```bash
+bun install
+cp .env.example .env
+bun run build
+bun run start:dev
+```
+
+Documentação OpenAPI/Scalar: `http://localhost:3000/doc`
+
+## Testes
+
+```bash
+bun run test              # unitários da lib (Bun)
+bun run test:e2e          # E2E da lib (requer DATABASE_URL)
+```
+
+Testes da CLI e da documentação ficam em `libs/cli` e `libs/doc/site` — na raiz do monorepo use `bun run test:cli` e `bun run test:docs`.
+
+## Autenticação
+
+O template **Exemplo de CRUD** sobe apenas `PersonModule`. Ao criar um projeto com `kl-nest new`, a CLI instala JWT ou OAuth2 e aplica patches em `app.module.ts` e `main.ts` (`SecurityModule`, `AuthModule`, guards globais).
+
+## Dependências Koala
+
+| Pacote | Uso |
+|--------|-----|
+| [`@koalarx/utils`](https://www.npmjs.com/package/@koalarx/utils) | `delay`, validação/máscara CPF-CNPJ, utilitários de string/data |
+
+Veja a [documentação Koala Utils](../../doc/markdown/pt/core/koala-utils.md).
+
+## Scripts úteis
+
+| Script | Descrição |
+|--------|-----------|
+| `start:debug` | Nest em watch com inspector |
+| `migration:run` | Aplica migrations TypeORM |
+| `migration:generate` | Gera migration a partir das entidades |

package/koala-nest/bunfig.toml

@@ -0,0 +1,7 @@
+[test]
+root = "src"
+preload = ["./src/test/setup.ts"]
+timeoutMs = 60000
+
+[loader]
+".ts" = "tsx"

package/koala-nest/eslint.config.mjs

@@ -0,0 +1,55 @@
+// @ts-check
+import eslint from '@eslint/js';
+import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+const sharedRules = {
+  '@typescript-eslint/no-explicit-any': 'off',
+  '@typescript-eslint/no-floating-promises': 'off',
+  '@typescript-eslint/no-unsafe-argument': 'off',
+  '@typescript-eslint/no-unsafe-call': 'off',
+  '@typescript-eslint/no-unsafe-member-access': 'off',
+  '@typescript-eslint/no-unsafe-assignment': 'off',
+  '@typescript-eslint/no-unsafe-return': 'off',
+  '@typescript-eslint/no-unsafe-function-type': 'off',
+  '@typescript-eslint/no-unused-vars': [
+    'error',
+    {
+      argsIgnorePattern: '^_',
+      varsIgnorePattern: '^_',
+    },
+  ],
+  'prettier/prettier': ['error', { endOfLine: 'auto' }],
+};
+
+export default tseslint.config(
+  {
+    ignores: ['eslint.config.mjs'],
+  },
+  eslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked,
+  eslintPluginPrettierRecommended,
+  {
+    languageOptions: {
+      globals: {
+        ...globals.node,
+        ...globals.jest,
+      },
+      sourceType: 'module',
+      parserOptions: {
+        project: ['./tsconfig.json', './tsconfig.spec.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    rules: sharedRules,
+  },
+  {
+    files: ['src/test/**/*.ts'],
+    rules: {
+      '@typescript-eslint/require-await': 'off',
+      '@typescript-eslint/no-misused-promises': 'off',
+      '@typescript-eslint/await-thenable': 'off',
+    },
+  },
+);

package/koala-nest/nest-cli.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "entryFile": "host/main",
+  "compilerOptions": {
+    "deleteOutDir": true
+  }
+}

package/koala-nest/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "koala-nest",
+  "version": "0.0.1",
+  "description": "",
+  "author": "",
+  "private": true,
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "nest build",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:cli": "prettier --write \"../cli/**/*.ts\"",
+    "format:all": "prettier --write \"src/**/*.ts\" \"../cli/**/*.ts\"",
+    "fix:all": "prettier --write \"src/**/*.ts\" \"../cli/**/*.ts\" && eslint \"src/**/*.ts\" --fix && cd ../cli && ../koala-nest/node_modules/.bin/eslint \"**/*.ts\" --fix",
+    "start": "nest start",
+    "start:dev": "nest start --watch",
+    "start:debug": "nest start --debug --watch",
+    "start:prod": "node dist/host/main",
+    "lint": "eslint \"src/**/*.ts\" --fix",
+    "lint:all": "eslint \"src/**/*.ts\" --fix && cd ../cli && ../koala-nest/node_modules/.bin/eslint \"**/*.ts\" --fix",
+    "test": "bun test src/test/core/ src/test/application/ src/test/infra/ src/test/host/is-public-open-api.spec.ts src/test/host/oauth-callback.controller.spec.ts src/test/host/errors.filter.spec.ts",
+    "test:e2e": "bun test --preload ./src/test/setup-e2e.ts src/test/host/controllers/",
+    "test:watch": "bun test --watch",
+    "migration:generate": "bun ./src/infra/database/migrations/generate-migration.ts",
+    "migration:run": "bun ./node_modules/typeorm/cli.js migration:run -d ./src/infra/database/migrations/migration-datasource.ts",
+    "migration:revert": "bun ./node_modules/typeorm/cli.js migration:revert -d ./src/infra/database/migrations/migration-datasource.ts"
+  },
+  "dependencies": {
+    "@koalarx/utils": "^4.2.3",
+    "@nestjs/axios": "^4.0.1",
+    "@nestjs/common": "^11.0.1",
+    "@nestjs/config": "^4.0.4",
+    "@nestjs/core": "^11.0.1",
+    "@nestjs/jwt": "^11.0.0",
+    "@nestjs/passport": "^11.0.0",
+    "@nestjs/platform-express": "^11.0.1",
+    "@nestjs/swagger": "^11.4.4",
+    "@nestjs/terminus": "^11.0.0",
+    "@scalar/nestjs-api-reference": "^1.2.3",
+    "bcrypt": "^6.0.0",
+    "cookie-parser": "^1.4.7",
+    "cron-parser": "^5.5.0",
+    "ioredis": "^5.11.1",
+    "passport": "^0.7.0",
+    "passport-jwt": "^4.0.1",
+    "pg": "^8.21.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "typeorm": "^1.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.18.0",
+    "@nestjs/cli": "^11.0.0",
+    "@nestjs/schematics": "^11.0.0",
+    "@nestjs/testing": "^11.0.1",
+    "@types/bun": "^1.3.14",
+    "@types/cookie-parser": "^1.4.10",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.10.7",
+    "@types/passport-jwt": "^4.0.1",
+    "@types/pg": "^8.11.6",
+    "@types/supertest": "^6.0.2",
+    "dotenv": "^16.4.7",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.2.2",
+    "globals": "^16.0.0",
+    "prettier": "^3.4.2",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.1.0",
+    "ts-jest": "^29.2.5",
+    "ts-loader": "^9.5.2",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.20.0"
+  }
+}

package/koala-nest/src/application/auth/common/auth-token.response.ts

@@ -0,0 +1,15 @@
+import { ApiProperty } from '@nestjs/swagger';
+
+export class AuthTokenResponse {
+  @ApiProperty()
+  accessToken: string;
+
+  @ApiProperty({ name: 'access_token' })
+  access_token: string;
+
+  @ApiProperty()
+  refreshToken: string;
+
+  @ApiProperty({ name: 'refresh_token' })
+  refresh_token: string;
+}

package/koala-nest/src/application/auth/common/user-claims.ts

@@ -0,0 +1,6 @@
+import { JwtClaims } from '@/core/auth/jwt-claims';
+import { User } from '@/domain/entities/user/user';
+
+export function userToJwtClaims(user: User): JwtClaims {
+  return { sub: user.id };
+}