@soapjs/cli 1.0.0 → 1.0.2

package/build/commands/create/project-plan.js

@@ -3,7 +3,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createControllersTs = exports.createResourcesTs = exports.createProjectFiles = exports.targetRoot = exports.zonesOptions = exports.contractsOptions = exports.docsOptions = exports.telemetryOptions = exports.realtimeOptions = exports.messagingOptions = exports.authOptions = exports.databaseOptions = exports.parseCsvOption = exports.createSoapConfigBundle = exports.createDefaultCapabilities = void 0;
+exports.zonesOptions = exports.contractsOptions = exports.docsOptions = exports.telemetryOptions = exports.realtimeOptions = exports.messagingOptions = exports.authOptions = exports.databaseOptions = void 0;
+exports.createDefaultCapabilities = createDefaultCapabilities;
+exports.createSoapConfigBundle = createSoapConfigBundle;
+exports.parseCsvOption = parseCsvOption;
+exports.targetRoot = targetRoot;
+exports.createProjectFiles = createProjectFiles;
+exports.createResourcesTs = createResourcesTs;
+exports.createControllersTs = createControllersTs;
 const path_1 = __importDefault(require("path"));
 const naming_1 = require("../../templates/naming");
 function createDefaultCapabilities() {
@@ -18,7 +25,6 @@ function createDefaultCapabilities() {
         contracts: [],
     };
 }
-exports.createDefaultCapabilities = createDefaultCapabilities;
 function createSoapConfigBundle(plan) {
     const defaultAuth = plan.capabilities.auth[0] ?? "none";
     const brunoEnabled = plan.capabilities.apiClient.includes("bruno");
@@ -79,7 +85,6 @@ function createSoapConfigBundle(plan) {
         },
     };
 }
-exports.createSoapConfigBundle = createSoapConfigBundle;
 function parseCsvOption(value, allowed) {
     if (!value) {
         return [];
@@ -93,13 +98,12 @@ function parseCsvOption(value, allowed) {
     }
     return Array.from(new Set(normalized));
 }
-exports.parseCsvOption = parseCsvOption;
 exports.databaseOptions = ["mongo", "postgres", "mysql", "sqlite", "redis"];
 const sqlDatabaseOptions = ["postgres", "mysql", "sqlite"];
 exports.authOptions = ["jwt", "api-key", "local"];
 exports.messagingOptions = ["in-memory", "kafka"];
 exports.realtimeOptions = ["ws"];
-exports.telemetryOptions = ["logs", "otel-noop"];
+exports.telemetryOptions = ["logs", "otel-noop", "metrics", "memory"];
 exports.docsOptions = ["openapi"];
 exports.contractsOptions = ["zod"];
 exports.zonesOptions = ["public", "private", "admin"];
@@ -109,7 +113,6 @@ function enabledSqlDatabases(capabilities) {
 function targetRoot(cwd, name) {
     return path_1.default.resolve(cwd, name);
 }
-exports.targetRoot = targetRoot;
 function createProjectFiles(plan) {
     const packageJson = {
         name: plan.name,
@@ -243,11 +246,16 @@ function createProjectFiles(plan) {
         ...createBrunoFiles(plan),
     ];
 }
-exports.createProjectFiles = createProjectFiles;
 function createIndexTs(plan) {
     const docsImports = plan.capabilities.docs.includes("openapi")
         ? "import { DocumentationPlugin } from '@soapjs/soap-openapi';\n"
         : "";
+    const expressImport = plan.capabilities.telemetry.includes("memory")
+        ? "import { createApp, MemoryMonitoringPlugin } from '@soapjs/soap-express';"
+        : "import { createApp } from '@soapjs/soap-express';";
+    const authImport = plan.capabilities.auth.length > 0
+        ? "import { createAuthRouter } from '@soapjs/soap-express/auth';\n"
+        : "";
     const socketImport = plan.capabilities.realtime.includes("ws")
         ? "import { createSocketRuntime } from './common/sockets/socket.setup';\n"
         : "";
@@ -256,32 +264,51 @@ function createIndexTs(plan) {
         ? `\n    plugins: [\n      {\n        plugin: new DocumentationPlugin(),\n        options: {\n          info: {\n            title: '${plan.name} API',\n            version: '0.1.0',\n          },\n          servers: [{ url: \`http://localhost:\${config.port}\`, description: 'Local' }],\n          interactivePath: '/docs',\n          openApiPath: '/openapi.json',\n        },\n      },\n    ],`
         : "";
     const cqrsOption = plan.architecture === "cqrs" ? "\n    cqrs: true," : "";
+    const authRegistration = plan.capabilities.auth.length > 0
+        ? `\n  app.registerAuth(auth);\n  app.getApp().use(createAuthRouter(auth, {\n    basePath: '/auth',\n    strategy: '${defaultAuthStrategy(plan)}',\n    routes: {\n      login: { path: '/auth/login', strategy: '${loginAuthStrategy(plan)}' },\n      logout: { path: '/auth/logout', strategy: '${loginAuthStrategy(plan)}' },\n      refresh: { path: '/auth/refresh', strategy: 'jwt', enabled: ${usesJwtAuth(plan)} },\n      me: { path: '/auth/me', strategy: '${defaultAuthStrategy(plan)}' },\n      verify: { path: '/auth/verify', strategy: '${defaultAuthStrategy(plan)}' },\n    },\n  }));\n`
+        : "";
+    const metrics = plan.capabilities.telemetry.includes("metrics")
+        ? `\n  app.useMetrics({\n    enabled: true,\n    exposeEndpoint: true,\n    metricsPath: '/metrics',\n    metricsFormat: 'prometheus',\n  });\n`
+        : "";
+    const memory = plan.capabilities.telemetry.includes("memory")
+        ? `\n  const memoryMonitoringOptions = {\n    enabled: true,\n    exposeEndpoints: true,\n    basePath: '/memory',\n    includeInRequest: false,\n  };\n  let memoryMonitoringPlugin: MemoryMonitoringPlugin | undefined;\n\n  try {\n    app.useMemoryMonitoring(memoryMonitoringOptions);\n  } catch (error) {\n    memoryMonitoringPlugin = new MemoryMonitoringPlugin(memoryMonitoringOptions, logger);\n    (memoryMonitoringPlugin as { version?: string }).version ??= '0.1.0';\n    app.usePlugin(memoryMonitoringPlugin, memoryMonitoringOptions);\n  }\n\n  const getMemorySummary = () => app.getMemorySummary() ?? memoryMonitoringPlugin?.getMemorySummary();\n  app.getApp().get('/memory', (_req, res) => res.json(getMemorySummary()));\n  app.getApp().get('/memory/summary', (_req, res) => res.json(getMemorySummary()));\n  app.getApp().get('/memory/health', (_req, res) => {\n    const summary = getMemorySummary();\n    res.status(summary?.status === 'critical' ? 503 : 200).json({ status: summary?.status ?? 'unknown', summary });\n  });\n`
+        : "";
+    const socketRuntime = plan.capabilities.realtime.includes("ws")
+        ? `\n  const socketRuntime = createSocketRuntime(config, app.getServer());\n  app.registerDrainable(socketRuntime);\n`
+        : "";
     return `import 'reflect-metadata';
-import { bootstrap } from '@soapjs/soap-express';
-${docsImports}${socketImport}${cqrsImport}import './features';
+${expressImport}
+${docsImports}${authImport}${socketImport}${cqrsImport}import './features';
 import { config } from './config/config';
 import { controllers } from './config/controllers';
 import { buildContainer } from './config/dependencies';
 
 async function main(): Promise<void> {
-  const { container, drainables, logger, authStrategies } = await buildContainer(config);
+  const { container, drainables, logger, auth } = await buildContainer(config);
 
-  const app = await bootstrap({
-    port: config.port,
+  const app = createApp({
     container,
     logger,
     drainables,
     controllers,
     middleware: {
-      cors: true,
-      helmet: true,
       logging: true,
       compression: true,
     },
-    auth: authStrategies,
+    app: {
+      security: ${createSecurityConfig(plan)},
+    },
     healthCheck: true,${cqrsOption}${docsPlugin}
   });
-${plan.capabilities.realtime.includes("ws") ? `\n  const socketRuntime = createSocketRuntime(config, app.getServer());\n  app.registerDrainable(socketRuntime);\n` : ""}
+${authRegistration}${metrics}${memory}
+
+  const cqrsReady = (app as unknown as { cqrsReady?: Promise<void> }).cqrsReady;
+  if (cqrsReady) {
+    await cqrsReady;
+  }
+
+  await app.start(config.port);
+${socketRuntime}
 
   logger.info('${plan.name} API ready', { port: config.port });
 }
@@ -292,6 +319,41 @@ main().catch((error) => {
 });
 `;
 }
+function defaultAuthStrategy(plan) {
+    if (plan.capabilities.auth.includes("jwt"))
+        return "jwt";
+    if (plan.capabilities.auth.includes("local"))
+        return "local";
+    if (plan.capabilities.auth.includes("api-key"))
+        return "api-key";
+    return "jwt";
+}
+function loginAuthStrategy(plan) {
+    if (plan.capabilities.auth.includes("local") || plan.capabilities.auth.includes("jwt"))
+        return "local";
+    if (plan.capabilities.auth.includes("api-key"))
+        return "api-key";
+    return defaultAuthStrategy(plan);
+}
+function createSecurityConfig(plan) {
+    const throttle = plan.capabilities.auth.length > 0
+        ? `{
+        global: { windowMs: 60_000, max: 300 },
+        routes: {
+          'POST /auth/login': { windowMs: 60_000, max: 5 },
+          'POST /auth/refresh': { windowMs: 60_000, max: 20, keyBy: 'user' },
+          'GET /auth/oauth/:provider/callback': { windowMs: 60_000, max: 30 },
+        },
+      }`
+        : "{ global: { windowMs: 60_000, max: 300 } }";
+    return `{
+      disablePoweredBy: true,
+      trustProxy: 1,
+      helmet: true,
+      cors: true,
+      throttle: ${throttle},
+    }`;
+}
 function createConfigTs(plan) {
     const mongo = plan.capabilities.databases.includes("mongo")
         ? "\n  mongoUri: readEnv('MONGO_URI', 'mongodb://localhost:27017/app'),"
@@ -314,10 +376,10 @@ function createConfigTs(plan) {
     const sockets = plan.capabilities.realtime.includes("ws")
         ? "\n  wsPath: readEnv('WS_PATH', '/ws'),\n  wsHeartbeatMs: Number(readEnv('WS_HEARTBEAT_MS', '30000')),"
         : "";
-    const jwt = plan.capabilities.auth.includes("jwt") || plan.capabilities.auth.includes("local")
-        ? "\n  jwtSecret: readEnv('JWT_SECRET', 'dev-secret'),"
+    const jwt = plan.capabilities.auth.length > 0
+        ? "\n  jwtAccessSecret: readEnv('JWT_ACCESS_SECRET', 'dev-access-secret'),\n  jwtRefreshSecret: readEnv('JWT_REFRESH_SECRET', 'dev-refresh-secret'),"
         : "";
-    const apiKey = plan.capabilities.auth.includes("api-key")
+    const apiKey = plan.capabilities.auth.length > 0
         ? "\n  apiKeyHeader: readEnv('API_KEY_HEADER', 'x-api-key'),\n  devApiKey: readEnv('DEV_API_KEY', 'dev-api-key'),"
         : "";
     return `import 'dotenv/config';
@@ -343,21 +405,21 @@ export type AppConfig = typeof config;
 }
 function createDependenciesTs(plan) {
     const authImport = plan.capabilities.auth.length > 0
-        ? "import { createAuthStrategies } from '../features/auth/auth.setup';\n"
+        ? "import { SoapAuth } from '@soapjs/soap-auth';\nimport { createAuthProvider } from '../features/auth/auth.setup';\n"
         : "";
     const mongoImport = plan.capabilities.databases.includes("mongo")
-        ? "import { SoapMongo } from '@soapjs/soap-node-mongo';\nimport { createMongoClient } from '../common/data/mongo/mongo.client';\n"
+        ? "import { SoapMongo } from '@soapjs/soap-mongo';\nimport { createMongoClient } from '../common/data/mongo/mongo.client';\n"
         : "";
     const sqlDatabases = enabledSqlDatabases(plan.capabilities);
     const sqlImport = sqlDatabases.length > 0
-        ? `import { SoapSQL } from '@soapjs/soap-node-sql';
+        ? `import { SoapSQL } from '@soapjs/soap-sql';
 ${sqlDatabases.map((database) => `import { create${(0, naming_1.createNameVariants)(database).pascalName}Client } from '../common/data/${database}/${database}.client';`).join("\n")}
 `
         : "";
     const eventImport = plan.capabilities.messaging.length > 0
         ? "import { DomainEventBus } from '@soapjs/soap/cqrs';\nimport { createEventBus } from '../common/events/event-bus.setup';\n"
         : "";
-    const authStrategies = plan.capabilities.auth.length > 0 ? "createAuthStrategies(_config)" : "[]";
+    const authProvider = plan.capabilities.auth.length > 0 ? "await createAuthProvider(_config, logger)" : "undefined";
     const resourceContextType = [
         plan.capabilities.databases.includes("mongo") ? "  mongo?: SoapMongo;" : undefined,
         sqlDatabases.length > 0 ? "  sql?: Partial<Record<'postgres' | 'mysql' | 'sqlite', SoapSQL>>;" : undefined,
@@ -377,9 +439,9 @@ ${sqlDatabases.map((database) => {
     const eventSetup = plan.capabilities.messaging.length > 0
         ? `\n  const eventBusRuntime = await createEventBus(_config, logger);\n  container.bindValue(DomainEventBus.Token, eventBusRuntime.bus);\n  if (eventBusRuntime.drainable) {\n    drainables.push(eventBusRuntime.drainable);\n  }\n`
         : "";
+    const authReturnType = plan.capabilities.auth.length > 0 ? "  auth: SoapAuth;" : "  auth?: undefined;";
     return `import { ConsoleLogger, DIContainer } from '@soapjs/soap-express';
 import { Drainable } from '@soapjs/soap/events';
-import { AuthStrategy } from '@soapjs/soap/http';
 import { AppConfig } from './config';
 import { registerResources } from './resources';
 ${mongoImport}${sqlImport}${eventImport}${authImport}
@@ -392,13 +454,13 @@ export async function buildContainer(_config: AppConfig): Promise<{
   container: DIContainer;
   drainables: Drainable[];
   logger: ConsoleLogger;
-  authStrategies: AuthStrategy[];
+${authReturnType}
 }> {
   const container = new DIContainer();
   const logger = new ConsoleLogger();
   const drainables: Drainable[] = [];
   const resources: ResourceContext = {};
-  const authStrategies: AuthStrategy[] = ${authStrategies};
+  const auth = ${authProvider};
 ${mongoSetup}${sqlSetup}${eventSetup}
 
   await registerResources(container, resources);
@@ -407,7 +469,7 @@ ${mongoSetup}${sqlSetup}${eventSetup}
     container,
     drainables,
     logger,
-    authStrategies,
+    auth,
   };
 }
 `;
@@ -432,7 +494,6 @@ ${resources.map((resource) => `  await ${resource.functionName}(container, resou
 }
 `;
 }
-exports.createResourcesTs = createResourcesTs;
 function createMongoFiles(plan) {
     if (!plan.capabilities.databases.includes("mongo")) {
         return [];
@@ -441,7 +502,7 @@ function createMongoFiles(plan) {
         {
             path: "src/config/mongo.config.ts",
             type: "config",
-            content: `import { MongoConfig } from '@soapjs/soap-node-mongo';
+            content: `import { MongoConfig } from '@soapjs/soap-mongo';
 import { AppConfig } from './config';
 
 export function createMongoConfig(config: Pick<AppConfig, 'mongoUri'>): MongoConfig {
@@ -462,7 +523,7 @@ export function createMongoConfig(config: Pick<AppConfig, 'mongoUri'>): MongoCon
         {
             path: "src/common/data/mongo/mongo.client.ts",
             type: "config",
-            content: `import { SoapMongo } from '@soapjs/soap-node-mongo';
+            content: `import { SoapMongo } from '@soapjs/soap-mongo';
 import { AppConfig } from '../../../config/config';
 import { createMongoConfig } from '../../../config/mongo.config';
 
@@ -474,7 +535,7 @@ export async function createMongoClient(config: AppConfig): Promise<SoapMongo> {
         {
             path: "src/common/data/mongo/mongo.source-factory.ts",
             type: "config",
-            content: `import { MongoSource, SoapMongo } from '@soapjs/soap-node-mongo';
+            content: `import { MongoSource, SoapMongo } from '@soapjs/soap-mongo';
 import { Document } from 'mongodb';
 
 export function createMongoSource<T extends Document = Document>(mongo: SoapMongo, collectionName: string): MongoSource<T> {
@@ -494,7 +555,7 @@ function createSqlFiles(plan) {
         {
             path: "src/common/data/sql/sql.source-factory.ts",
             type: "config",
-            content: `import { SoapSQL, SqlDataSource } from '@soapjs/soap-node-sql';
+            content: `import { SoapSQL, SqlDataSource } from '@soapjs/soap-sql';
 
 export function createSqlSource<T = Record<string, unknown>>(sql: SoapSQL, tableName: string): SqlDataSource<T> {
   return new SqlDataSource<T>(sql, tableName);
@@ -515,7 +576,7 @@ function createSqlDatabaseFiles(database) {
         {
             path: `src/config/${database}.config.ts`,
             type: "config",
-            content: `import { SqlDatabaseConfig } from '@soapjs/soap-node-sql';
+            content: `import { SqlDatabaseConfig } from '@soapjs/soap-sql';
 import { AppConfig } from './config';
 
 export function create${names.pascalName}Config(config: Pick<AppConfig, '${configProperty}'>): SqlDatabaseConfig {
@@ -529,7 +590,7 @@ ${createSqlConfigProperties(database, configProperty)}
         {
             path: `src/common/data/${database}/${database}.client.ts`,
             type: "config",
-            content: `import { SoapSQL } from '@soapjs/soap-node-sql';
+            content: `import { SoapSQL } from '@soapjs/soap-sql';
 import { AppConfig } from '../../../config/config';
 import { create${names.pascalName}Config } from '../../../config/${database}.config';
 
@@ -543,6 +604,11 @@ export async function create${names.pascalName}Client(config: AppConfig): Promis
 function createSqlConfigProperties(database, configProperty) {
     if (database === "sqlite") {
         return `    type: 'sqlite',
+    host: 'localhost',
+    port: 0,
+    database: config.${configProperty}.filename,
+    username: '',
+    password: '',
     filename: config.${configProperty}.filename,`;
     }
     const sqlType = database === "postgres" ? "postgresql" : "mysql";
@@ -563,14 +629,6 @@ function createCqrsFiles(plan) {
             type: "config",
             content: `// Generated CQRS handler imports. Updated by soap add command/query.
 export {};
-`,
-        },
-        {
-            path: "src/types/soap-express-cqrs.d.ts",
-            type: "config",
-            content: `declare module '@soapjs/soap-express/cqrs' {
-  export * from '@soapjs/soap-express/build/cqrs';
-}
 `,
         },
     ];
@@ -653,7 +711,7 @@ export function createKafkaConfig(config: Pick<AppConfig, 'kafkaBrokers'>) {
         }, {
             path: "src/common/events/kafka/kafka.client.ts",
             type: "config",
-            content: `import { KafkaEventBus } from '@soapjs/soap-node-kafka';
+            content: `import { KafkaEventBus } from '@soapjs/soap-kafka';
 import { AppConfig } from '../../../config/config';
 import { createKafkaConfig } from '../../../config/kafka.config';
 
@@ -664,7 +722,7 @@ export function createKafkaClient(config: AppConfig): KafkaEventBus<Record<strin
         }, {
             path: "src/common/events/kafka/kafka-event-bus.ts",
             type: "config",
-            content: `import { KafkaDomainEventBus } from '@soapjs/soap-node-kafka';
+            content: `import { KafkaDomainEventBus } from '@soapjs/soap-kafka';
 import { Logger } from '@soapjs/soap/common';
 import { AppConfig } from '../../../config/config';
 import { createKafkaClient } from './kafka.client';
@@ -699,7 +757,7 @@ export const socketHandlers: AppSocketHandler[] = [];
             type: "config",
             content: `import { Server } from 'http';
 import { Drainable } from '@soapjs/soap/events';
-import { SocketMessage, SocketServer, WebSocketServerAdapter } from '@soapjs/soap-node-socket';
+import { SocketMessage, SocketServer, WebSocketServerAdapter } from '@soapjs/soap-socket';
 import { AppConfig } from '../../config/config';
 import { socketHandlers } from '../../config/sockets';
 
@@ -763,17 +821,9 @@ ${names}
 ];
 `;
 }
-exports.createControllersTs = createControllersTs;
 function createInitialControllers(plan) {
-    if (!usesJwtAuth(plan)) {
-        return [];
-    }
-    return [
-        {
-            className: "AuthController",
-            importPath: "../features/auth/api/auth.controller",
-        },
-    ];
+    void plan;
+    return [];
 }
 function createEnvExample(plan) {
     const lines = ["NODE_ENV=development", "PORT=3000", "LOG_LEVEL=debug"];
@@ -793,7 +843,7 @@ function createEnvExample(plan) {
         lines.push("REDIS_URL=redis://localhost:6379");
     }
     if (plan.capabilities.auth.includes("jwt") || plan.capabilities.auth.includes("local")) {
-        lines.push("JWT_SECRET=change-me");
+        lines.push("JWT_ACCESS_SECRET=change-me-access", "JWT_REFRESH_SECRET=change-me-refresh");
     }
     if (plan.capabilities.auth.includes("api-key")) {
         lines.push("API_KEY_HEADER=x-api-key", "DEV_API_KEY=dev-api-key");
@@ -847,6 +897,7 @@ curl http://localhost:3000/openapi.json
 `
         : "";
     const authSection = createReadmeAuthSection(plan);
+    const monitoringSection = createReadmeMonitoringSection(plan);
     const addCommands = `## Add More Code
 
 \`\`\`bash
@@ -860,6 +911,8 @@ soap update config --add-api-client bruno
 
 Generated SoapJS service.
 
+Requires Node.js 24.17.0 or newer. The generated runtime uses SoapJS 0.14, soap-auth 1.x, and the soap-express security/auth helpers.
+
 ## Capabilities
 
 - Framework: ${plan.framework}
@@ -892,7 +945,7 @@ Build:
 ${buildCommand}
 \`\`\`
 
-${dockerSection}${brunoSection}${openApiSection}${authSection}## Folder Structure
+${dockerSection}${brunoSection}${openApiSection}${authSection}${monitoringSection}## Folder Structure
 
 \`\`\`txt
 src/
@@ -915,6 +968,25 @@ src/
 Generated metadata is stored in \`.soap/\`.
 
 ${addCommands}
+`;
+}
+function createReadmeMonitoringSection(plan) {
+    const endpoints = [];
+    if (plan.capabilities.telemetry.includes("metrics")) {
+        endpoints.push("- Metrics: http://localhost:3000/metrics");
+    }
+    if (plan.capabilities.telemetry.includes("memory")) {
+        endpoints.push("- Memory monitoring: http://localhost:3000/memory");
+    }
+    if (endpoints.length === 0) {
+        return "";
+    }
+    return `## Monitoring
+
+Monitoring endpoints are opt-in and were generated because telemetry includes \`${plan.capabilities.telemetry.filter((item) => item === "metrics" || item === "memory").join(", ")}\`.
+
+${endpoints.join("\n")}
+
 `;
 }
 function createReadmeAuthSection(plan) {
@@ -927,7 +999,7 @@ Default Bruno login variables:
 - email: \`admin@example.com\`
 - password: \`admin123\`
 
-Set \`JWT_SECRET\` in \`.env.example\` or your local \`.env\`.
+Auth is registered through \`SoapAuth.create(...)\` and \`createAuthRouter(...)\`. Set \`JWT_ACCESS_SECRET\` and \`JWT_REFRESH_SECRET\` in \`.env.example\` or your local \`.env\`.
 
 `);
     }
@@ -939,12 +1011,17 @@ Default header and key:
 - \`API_KEY_HEADER=x-api-key\`
 - \`DEV_API_KEY=dev-api-key\`
 
+API key auth uses \`createApiKeyAuthConfig(...)\` with a development \`retrieveUserByApiKey\` implementation.
+
 `);
     }
-    return sections.length > 0 ? `## Auth\n\n${sections.join("\n")}` : "";
+    const security = sections.length > 0
+        ? `Route-specific throttling is enabled for \`POST /auth/login\`, \`POST /auth/refresh\`, and OAuth callbacks through soap-express security config.\n\n`
+        : "";
+    return sections.length > 0 ? `## Auth\n\n${security}${sections.join("\n")}` : "";
 }
 function createDockerfile() {
-    return `FROM node:20-alpine
+    return `FROM node:24-alpine
 WORKDIR /app
 COPY package*.json ./
 RUN npm install
@@ -1039,16 +1116,24 @@ function createAuthFiles(plan) {
             path: "src/features/auth/domain/auth-user.ts",
             type: "config",
             owner: "auth",
-            content: `export interface AuthUser {
-  id: string;
-  email: string;
-  name: string;
-  roles: string[];
+            content: `import { AuthUser as SoapAuthUser } from '@soapjs/soap/http';
+
+export interface AuthUser extends SoapAuthUser {
+  name?: string;
+}
+`,
+        },
+        {
+            path: "src/types/soap-express-auth.d.ts",
+            type: "config",
+            owner: "auth",
+            content: `declare module '@soapjs/soap-express/auth' {
+  export * from '@soapjs/soap-express/build/auth';
 }
 `,
         },
     ];
-    if (usesJwtAuth(plan)) {
+    if (usesJwtAuth(plan) || plan.capabilities.auth.includes("api-key")) {
         files.push({
             path: "src/features/auth/data/dev-users.ts",
             type: "config",
@@ -1072,151 +1157,6 @@ export const devUsers: DevUser[] = [
 export function findDevUser(email: string): DevUser | undefined {
   return devUsers.find((user) => user.email === email);
 }
-`,
-        }, {
-            path: "src/features/auth/auth.tokens.ts",
-            type: "config",
-            owner: "auth",
-            content: `import jwt from 'jsonwebtoken';
-import { AuthUser } from './domain/auth-user';
-
-export interface AuthTokenPayload {
-  sub: string;
-  email: string;
-  name: string;
-  roles: string[];
-}
-
-export function signAccessToken(user: AuthUser, secret: string): string {
-  return jwt.sign(
-    {
-      sub: user.id,
-      email: user.email,
-      name: user.name,
-      roles: user.roles,
-    },
-    secret,
-    { expiresIn: '1h' }
-  );
-}
-
-export function verifyAccessToken(token: string, secret: string): AuthUser {
-  const payload = jwt.verify(token, secret) as AuthTokenPayload;
-
-  return {
-    id: payload.sub,
-    email: payload.email,
-    name: payload.name,
-    roles: payload.roles ?? [],
-  };
-}
-`,
-        }, {
-            path: "src/features/auth/jwt.strategy.ts",
-            type: "config",
-            owner: "auth",
-            content: `import { AuthStrategy, HttpContext } from '@soapjs/soap/http';
-import { verifyAccessToken } from './auth.tokens';
-import { AuthUser } from './domain/auth-user';
-
-export class JwtAuthStrategy implements AuthStrategy<AuthUser> {
-  readonly name = 'jwt';
-
-  constructor(private readonly secret: string) {}
-
-  async authenticate(ctx: HttpContext) {
-    const authorization = ctx.req.headers.authorization;
-    const header = Array.isArray(authorization) ? authorization[0] : authorization;
-
-    if (!header?.startsWith('Bearer ')) {
-      return null;
-    }
-
-    const token = header.slice('Bearer '.length);
-    const user = verifyAccessToken(token, this.secret);
-
-    return { user };
-  }
-}
-`,
-        }, {
-            path: "src/features/auth/api/auth.controller.ts",
-            type: "config",
-            owner: "auth",
-            content: `import { Request } from 'express';
-import { Auth, Controller, Get, Post } from '@soapjs/soap-express';
-import { config } from '../../../config/config';
-import { signAccessToken } from '../auth.tokens';
-import { findDevUser } from '../data/dev-users';
-
-@Controller('/auth', {
-  apiDoc: {
-    tags: ['Auth'],
-    description: 'Development auth endpoints generated by SoapJS CLI',
-  },
-})
-export class AuthController {
-  @Post('/login')
-  async login(req: Request): Promise<unknown> {
-    const { email, password } = req.body ?? {};
-    const user = typeof email === 'string' ? findDevUser(email) : undefined;
-
-    if (!user || user.password !== password) {
-      return { error: 'Invalid credentials' };
-    }
-
-    const { password: _password, ...safeUser } = user;
-    const accessToken = signAccessToken(safeUser, config.jwtSecret);
-
-    return {
-      accessToken,
-      user: safeUser,
-    };
-  }
-
-  @Get('/me')
-  @Auth('jwt')
-  async me(req: Request): Promise<unknown> {
-    return (req as Request & { user?: unknown }).user;
-  }
-}
-`,
-        });
-    }
-    if (plan.capabilities.auth.includes("api-key")) {
-        files.push({
-            path: "src/features/auth/api-key.strategy.ts",
-            type: "config",
-            owner: "auth",
-            content: `import { AuthStrategy, HttpContext } from '@soapjs/soap/http';
-import { AuthUser } from './domain/auth-user';
-
-export class ApiKeyAuthStrategy implements AuthStrategy<AuthUser> {
-  readonly name = 'api-key';
-
-  constructor(
-    private readonly headerName: string,
-    private readonly expectedApiKey: string
-  ) {}
-
-  async authenticate(ctx: HttpContext) {
-    const value = ctx.req.headers[this.headerName.toLowerCase()];
-    const apiKey = Array.isArray(value) ? value[0] : value;
-
-    if (!apiKey || apiKey !== this.expectedApiKey) {
-      return null;
-    }
-
-    return {
-      user: {
-        id: 'api-key-client',
-        email: 'api-key@example.com',
-        name: 'API Key Client',
-        roles: ['admin'],
-      },
-    };
-  }
-}
 `,
         });
     }
@@ -1238,34 +1178,139 @@ function usesJwtAuth(plan) {
 }
 function createAuthSetupTs(plan) {
     const imports = [
-        "import { AuthStrategy } from '@soapjs/soap/http';",
+        "import { SoapAuth } from '@soapjs/soap-auth';",
+        "import { createApiKeyAuthConfig, createJwtAuthConfig, createLocalAuthConfig } from '@soapjs/soap-auth/recipes';",
+        "import { Logger } from '@soapjs/soap/common';",
         "import { AppConfig } from '../../config/config';",
+        "import { AuthUser } from './domain/auth-user';",
+        "import { devUsers, findDevUser } from './data/dev-users';",
     ];
-    const body = ["  const strategies: AuthStrategy[] = [];"];
-    if (usesJwtAuth(plan)) {
-        imports.push("import { JwtAuthStrategy } from './jwt.strategy';");
-        body.push("", "  strategies.push(new JwtAuthStrategy(config.jwtSecret));");
+    const httpConfigs = [];
+    if (plan.capabilities.auth.includes("jwt")) {
+        httpConfigs.push(`    jwt: createJwtConfig(config),`);
+    }
+    if (plan.capabilities.auth.includes("local") || plan.capabilities.auth.includes("jwt")) {
+        httpConfigs.push(`    local: createLocalConfig(config),`);
     }
     if (plan.capabilities.auth.includes("api-key")) {
-        imports.push("import { ApiKeyAuthStrategy } from './api-key.strategy';");
-        body.push("", "  strategies.push(new ApiKeyAuthStrategy(config.apiKeyHeader, config.devApiKey));");
+        httpConfigs.push(`    apiKey: createApiKeyConfig(config),`);
     }
-    body.push("", "  return strategies;");
     return `${imports.join("\n")}
 
-export function createAuthStrategies(config: AppConfig): AuthStrategy[] {
-${body.join("\n")}
+interface DevLoginPayload {
+  identifier?: string;
+  email?: string;
+  password?: string;
+}
+
+function safeUser(user: AuthUser & { password?: string }): AuthUser {
+  return {
+    id: user.id,
+    email: user.email,
+    name: user.name,
+    roles: user.roles,
+  };
+}
+
+async function fetchUser(payload: unknown): Promise<AuthUser | null> {
+  const id = typeof payload === 'object' && payload !== null && 'id' in payload ? String((payload as { id: unknown }).id) : undefined;
+  const email = typeof payload === 'string'
+    ? payload
+    : typeof payload === 'object' && payload !== null && 'email' in payload
+      ? String((payload as { email: unknown }).email)
+      : undefined;
+  const user = id
+    ? devUsers.find((candidate) => candidate.id === id)
+    : email
+      ? findDevUser(email)
+      : undefined;
+
+  return user ? safeUser(user) : null;
+}
+
+function createJwtConfig(config: AppConfig) {
+  return createJwtAuthConfig({
+    accessSecret: config.jwtAccessSecret,
+    refreshSecret: config.jwtRefreshSecret,
+    user: { fetchUser },
+    accessToken: {
+      options: { expiresIn: '15m' },
+      buildPayload: (user: AuthUser) => ({ id: user.id, email: user.email, roles: user.roles }),
+    },
+    refreshToken: {
+      options: { expiresIn: '7d' },
+      buildPayload: (user: AuthUser) => ({ id: user.id }),
+    },
+    routes: {
+      login: { path: '/auth/login' },
+      refresh: { path: '/auth/refresh' },
+      logout: { path: '/auth/logout' },
+    },
+  });
+}
+
+function createLocalConfig(_config: AppConfig) {
+  return createLocalAuthConfig({
+    basePath: '/auth',
+    credentials: {
+      extractCredentials: <TCredentials>(context: unknown): TCredentials => {
+        const authContext = context as { body?: DevLoginPayload; req?: { body?: DevLoginPayload } };
+        const body = authContext.body ?? authContext.req?.body ?? {};
+        return {
+          identifier: body.identifier ?? body.email ?? '',
+          password: body.password ?? '',
+        } as TCredentials;
+      },
+      verifyCredentials: async (identifier: string, password: string) => {
+        const user = findDevUser(identifier);
+        return user?.password === password;
+      },
+    },
+    user: { fetchUser },
+    routes: {
+      login: { path: '/auth/login' },
+      logout: { path: '/auth/logout' },
+    },
+  });
+}
+
+function createApiKeyConfig(config: AppConfig) {
+  return createApiKeyAuthConfig({
+    keyType: 'long-term',
+    extractApiKey: (context: unknown) => {
+      const authContext = context as { req?: { headers?: Record<string, string | string[] | undefined> }; headers?: Record<string, string | string[] | undefined> };
+      const headers = authContext.req?.headers ?? authContext.headers ?? {};
+      const value = headers[config.apiKeyHeader.toLowerCase()];
+      return Array.isArray(value) ? value[0] ?? null : value ?? null;
+    },
+    retrieveUserByApiKey: async (apiKey: string): Promise<AuthUser | null> => {
+      if (apiKey !== config.devApiKey) {
+        return null;
+      }
+
+      return {
+        id: 'api-key-client',
+        email: 'api-key@example.com',
+        name: 'API Key Client',
+        roles: ['admin'],
+      };
+    },
+    trackApiKeyUsage: async (_apiKey: string) => undefined,
+  });
+}
+
+export async function createAuthProvider(config: AppConfig, logger?: Logger): Promise<SoapAuth> {
+  return SoapAuth.create({
+    logger,
+    http: {
+${httpConfigs.join("\n")}
+    },
+  });
 }
 `;
 }
 function createAuthIndexTs(plan) {
     const exports = ["export * from './auth.setup';", "export * from './domain/auth-user';"];
-    if (usesJwtAuth(plan)) {
-        exports.push("export * from './api/auth.controller';", "export * from './auth.tokens';", "export * from './jwt.strategy';");
-    }
-    if (plan.capabilities.auth.includes("api-key")) {
-        exports.push("export * from './api-key.strategy';");
-    }
     return `${exports.join("\n")}\n`;
 }
 function createFeaturesIndexTs(plan) {