@weconjs/core 0.1.1 → 1.1.0

package/README.md

@@ -5,6 +5,19 @@
 [![npm version](https://img.shields.io/npm/v/@weconjs/core.svg)](https://www.npmjs.com/package/@weconjs/core)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+## Table of Contents
+
+- [Installation](#installation)
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Configuration System](#configuration-system)
+- [Module System](#module-system)
+- [Server Factory](#server-factory)
+- [Database Integration](#database-integration)
+- [Logging](#logging)
+- [API Reference](#api-reference)
+- [Testing](#testing)
+
 ## Installation
 
 ```bash
@@ -13,18 +26,36 @@ npm install @weconjs/core
 yarn add @weconjs/core
 ```
 
+### Optional Dependencies
+
+```bash
+# Winston logging with daily file rotation
+npm install winston winston-daily-rotate-file
+
+# Field-level access control for Mongoose
+npm install @weconjs/mongoose-field-shield
+```
+
 ## Features
 
-- 🔧 **Configuration System** - Mode-based config with inheritance
-- 📦 **Module System** - Auto-discovery and dependency resolution
-- 🌐 **i18n Support** - Auto-load translations from modules
-- 🔌 **Socket.IO Integration** - Auto-discover socket handlers
-- 🗄️ **Database Connection** - MongoDB/Mongoose integration
-- 🚀 **Server Factory** - Express server setup in one call
+| Feature | Description |
+|---------|-------------|
+| **Configuration System** | Mode-based configuration with inheritance (development, staging, production) |
+| **Module System** | Auto-discovery, dependency resolution, and lifecycle hooks |
+| **i18n Support** | Automatic translation file loading from module directories |
+| **Socket.IO Integration** | Auto-discover and register socket handlers and middleware |
+| **Database Connection** | MongoDB/Mongoose with URI builders, plugins, retry logic |
+| **Server Factory** | Complete Express bootstrap with HTTPS, graceful shutdown |
+| **Winston Logger** | Production-ready logging with console and file rotation |
+| **Response Helpers** | Standardized API responses via `res.respond()` |
+| **HTTPS Support** | Built-in SSL/TLS certificate loading and validation |
+| **Graceful Shutdown** | Proper SIGTERM/SIGINT handling with cleanup hooks |
+
+---
 
 ## Quick Start
 
-### Define Configuration
+### 1. Create Configuration File
 
 ```typescript
 // wecon.config.ts
@@ -35,94 +66,482 @@ export default defineConfig({
     name: 'my-api',
     version: '1.0.0',
   },
-  port: 3000,
   modes: {
     development: {
-      database: { uri: 'mongodb://localhost:27017/myapp' },
+      port: 3000,
+      database: {
+        mongoose: {
+          protocol: 'mongodb',
+          host: 'localhost',
+          port: 27017,
+          database: 'myapp_dev',
+        },
+      },
+      logging: { level: 'debug' },
     },
     production: {
-      database: { uri: process.env.DATABASE_URL },
+      port: 8080,
+      database: {
+        mongoose: {
+          protocol: 'mongodb+srv',
+          host: process.env.DB_HOST,
+          database: 'myapp',
+          username: process.env.DB_USER,
+          password: process.env.DB_PASSWORD,
+        },
+      },
+      logging: { 
+        level: 'info', 
+        enableFile: true,
+        directory: './logs',
+      },
+      https: {
+        enabled: true,
+        keyPath: './certs/privkey.pem',
+        certPath: './certs/fullchain.pem',
+      },
+    },
+  },
+  modules: ['./src/modules/users', './src/modules/auth'],
+  features: {
+    i18n: { 
+      enabled: true, 
+      defaultLocale: 'en',
+      supported: ['en', 'es', 'fr'],
+    },
+    fieldShield: {
+      enabled: true,
+      strict: true,
     },
   },
 });
 ```
 
-### Define Modules
+### 2. Define a Module
 
 ```typescript
 // src/modules/users/users.module.ts
 import { defineModule } from '@weconjs/core';
+import { Routes, Route } from '@weconjs/lib';
+import { userController } from './controllers/user.controller.js';
+
+const usersRoutes = new Routes({
+  prefix: '/users',
+  routes: [
+    new Route({ method: 'get', path: '/', handler: userController.findAll }),
+    new Route({ method: 'get', path: '/:id', handler: userController.findById }),
+    new Route({ method: 'post', path: '/', handler: userController.create }),
+    new Route({ method: 'put', path: '/:id', handler: userController.update }),
+    new Route({ method: 'delete', path: '/:id', handler: userController.delete }),
+  ],
+});
 
 export default defineModule({
   name: 'users',
   description: 'User management module',
-  routes: userRoutes,
+  routes: usersRoutes,
+  dependencies: ['auth'], // Load auth module first
   onInit: async (ctx) => {
-    console.log('Users module initialized');
+    ctx.logger.info('Users module initialized');
+    // Setup module-specific resources
   },
 });
 ```
 
-### Create Application
+### 3. Create Application Entry Point
+
+```typescript
+// src/main.ts
+import path from 'path';
+import { 
+  createWecon, 
+  loadConfig, 
+  buildUriFromConfig, 
+  type WeconContext 
+} from '@weconjs/core';
+
+async function main() {
+  // Load configuration with mode resolution
+  const config = await loadConfig(
+    path.resolve(process.cwd(), 'wecon.config.ts'),
+    process.env.NODE_ENV
+  );
+
+  console.log(`Starting ${config.app.name} v${config.app.version}`);
+  console.log(`Mode: ${config.mode}`);
+
+  // Dynamic import after config is loaded
+  const { wecon, modules } = await import('./bootstrap.js');
+
+  // Create and configure the application
+  const app = await createWecon({
+    config,
+    modules: [...modules],
+    wecon,
+    middleware: [], // Your custom middleware array
+    database: {
+      enabled: true,
+      uri: buildUriFromConfig(config.database),
+      plugins: [], // Global Mongoose plugins
+      debug: config.mode === 'development',
+    },
+    plugins: {
+      fieldShield: config.features?.fieldShield?.enabled
+        ? { strict: config.features.fieldShield.strict ?? true }
+        : false,
+    },
+    i18n: {
+      enabled: config.features?.i18n?.enabled ?? false,
+      modulesDir: './src/modules',
+    },
+    logger: {
+      useWinston: true,
+      level: config.logging?.level ?? 'info',
+      appName: config.app.name,
+      enableFile: config.logging?.enableFile ?? false,
+      logsDir: config.logging?.directory ?? './logs',
+    },
+    hooks: {
+      onBoot: async (ctx: WeconContext) => {
+        ctx.logger.info('Application ready to receive requests');
+      },
+      onShutdown: async (ctx: WeconContext) => {
+        ctx.logger.info('Application shutting down...');
+        // Cleanup resources, close connections
+      },
+    },
+  });
+
+  await app.start();
+}
+
+main().catch((err) => {
+  console.error('Failed to start application:', err);
+  process.exit(1);
+});
+```
+
+---
+
+## Configuration System
+
+### Mode-Based Configuration
+
+Define environment-specific settings that inherit from a base configuration:
+
+```typescript
+import { defineConfig } from '@weconjs/core';
+
+export default defineConfig({
+  // Base configuration (shared across all modes)
+  app: { name: 'my-api', version: '1.0.0' },
+  
+  // Mode-specific overrides
+  modes: {
+    development: {
+      port: 3000,
+      logging: { level: 'debug' },
+    },
+    staging: {
+      port: 3000,
+      logging: { level: 'info' },
+    },
+    production: {
+      port: 8080,
+      logging: { level: 'warn', enableFile: true },
+    },
+  },
+});
+```
+
+### Loading Configuration
+
+```typescript
+import { loadConfig, resolveConfig } from '@weconjs/core';
+
+// Load and resolve for current environment
+const config = await loadConfig('./wecon.config.ts', process.env.NODE_ENV);
+
+// Or load and resolve separately
+const rawConfig = await loadConfig('./wecon.config.ts');
+const resolved = resolveConfig(rawConfig, 'production');
+```
+
+---
+
+## Module System
+
+### Module Definition
+
+```typescript
+import { defineModule, type WeconContext } from '@weconjs/core';
+
+export default defineModule({
+  name: 'auth',
+  description: 'Authentication and authorization',
+  routes: authRoutes,
+  
+  // Declare dependencies (loaded first)
+  dependencies: ['database-seeds'],
+  
+  // Lifecycle hooks
+  onInit: async (module, ctx: WeconContext) => {
+    // Called when module is registered
+    ctx.logger.debug(`${module.name} module initializing`);
+  },
+  
+  onBoot: async (module, ctx: WeconContext) => {
+    // Called after all modules initialized, before server starts
+    await seedDefaultRoles(ctx);
+  },
+  
+  onShutdown: async (module, ctx: WeconContext) => {
+    // Called on graceful shutdown
+    await cleanupSessions();
+  },
+});
+```
+
+### Module Discovery
+
+The framework automatically resolves dependencies using topological sorting:
 
 ```typescript
-// src/index.ts
-import { createWecon, resolveConfig, loadConfig, createDatabaseConnection } from '@weconjs/core';
+import { resolveModuleDependencies, loadModule } from '@weconjs/core';
 
-const config = resolveConfig(await loadConfig(), process.env.NODE_ENV);
-const db = await createDatabaseConnection({ uri: config.database.uri });
+const modules = await Promise.all([
+  loadModule('./src/modules/users'),
+  loadModule('./src/modules/auth'),
+  loadModule('./src/modules/orders'),
+]);
+
+// Returns modules in correct initialization order
+const sorted = resolveModuleDependencies(modules);
+```
+
+---
+
+## Server Factory
+
+### Basic Usage
+
+```typescript
+import { createWecon } from '@weconjs/core';
 
 const app = await createWecon({
   config,
-  modules: [usersModule, authModule],
+  modules,
+  wecon, // @weconjs/lib instance
+});
+
+await app.start();
+```
+
+### Full Configuration
+
+```typescript
+const app = await createWecon({
+  config,
+  modules,
+  wecon,
+  
+  // Custom Express middleware
+  middleware: [cors(), helmet(), rateLimit()],
+  
+  // Database configuration
+  database: {
+    enabled: true,
+    uri: 'mongodb://localhost/myapp',
+    plugins: [timestampPlugin, auditPlugin],
+    debug: true,
+    retryAttempts: 5,
+    retryDelay: 2000,
+  },
+  
+  // FieldShield integration
+  plugins: {
+    fieldShield: { strict: true },
+  },
+  
+  // i18n configuration
+  i18n: {
+    enabled: true,
+    modulesDir: './src/modules',
+  },
+  
+  // Logger configuration
+  logger: {
+    useWinston: true,
+    level: 'info',
+    appName: 'my-api',
+    enableFile: true,
+    logsDir: './logs',
+  },
+  
+  // Lifecycle hooks
   hooks: {
-    onBoot: async () => {
-      await db.connect();
-    },
+    onBoot: async (ctx) => { /* Server starting */ },
+    onShutdown: async (ctx) => { /* Cleanup */ },
+    onModuleInit: async (module, ctx) => { /* Module loaded */ },
   },
 });
+```
 
-await app.start();
+### Response Helpers
+
+The server factory installs `res.respond()` on all Express responses:
+
+```typescript
+// Controller example
+async findAll(req: Request, res: Response) {
+  const users = await userService.findAll();
+  
+  res.respond({
+    success: true,
+    data: users,
+    meta: { total: users.length },
+  });
+}
+
+// Error response
+res.respond({
+  success: false,
+  message: req.t('user_not_found'),
+  errors: [{ code: 'NOT_FOUND', field: 'id' }],
+}, 404);
+```
+
+---
+
+## Database Integration
+
+### URI Builder
+
+Build MongoDB connection strings from configuration:
+
+```typescript
+import { buildMongoUri, buildUriFromConfig } from '@weconjs/core';
+
+// From individual parts
+const uri = buildMongoUri({
+  protocol: 'mongodb+srv',
+  host: 'cluster.mongodb.net',
+  database: 'myapp',
+  username: 'user',
+  password: 'pass',
+  options: { retryWrites: 'true', w: 'majority' },
+});
+
+// From config object
+const uri = buildUriFromConfig(config.database);
 ```
 
+### Database Connection
+
+```typescript
+import { createDatabaseConnection } from '@weconjs/core';
+
+const db = await createDatabaseConnection({
+  uri: 'mongodb://localhost/myapp',
+  plugins: [timestampPlugin],
+  debug: process.env.NODE_ENV === 'development',
+  retryAttempts: 5,
+  retryDelay: 2000,
+});
+```
+
+---
+
+## Logging
+
+### Winston Logger
+
+```typescript
+import { createWinstonLogger, createConsoleLogger } from '@weconjs/core';
+
+// Winston with file rotation (requires winston + winston-daily-rotate-file)
+const logger = await createWinstonLogger({
+  level: 'info',
+  appName: 'my-api',
+  enableFile: true,
+  logsDir: './logs',
+});
+
+// Console-only fallback
+const logger = createConsoleLogger({
+  level: 'debug',
+  appName: 'my-api',
+});
+
+logger.info('Server started', { port: 3000 });
+logger.error('Database connection failed', { error: err.message });
+```
+
+---
+
 ## API Reference
 
 ### Configuration
 
-- `defineConfig(config)` - Define application configuration
-- `resolveConfig(config, mode)` - Resolve config for a specific mode
-- `loadConfig()` - Load config from `wecon.config.ts`
+| Function | Description |
+|----------|-------------|
+| `defineConfig(config)` | Define application configuration with TypeScript support |
+| `resolveConfig(config, mode)` | Resolve configuration for a specific mode |
+| `loadConfig(path, mode?)` | Load configuration file and optionally resolve mode |
 
 ### Modules
 
-- `defineModule(definition)` - Define a module
-- `loadModule(path)` - Load a module from file
-- `resolveModuleDependencies(modules)` - Topologically sort modules
+| Function | Description |
+|----------|-------------|
+| `defineModule(definition)` | Define a module with routes and lifecycle hooks |
+| `loadModule(path)` | Load a module from file path |
+| `resolveModuleDependencies(modules)` | Sort modules by dependencies |
 
 ### Server
 
-- `createWecon(options)` - Create Wecon application
-- `initI18n(modulesDir)` - Initialize i18n middleware
-- `createDatabaseConnection(options)` - Create database connection
+| Function | Description |
+|----------|-------------|
+| `createWecon(options)` | Create and configure Wecon application |
 
-### Socket.IO
+### Database
+
+| Function | Description |
+|----------|-------------|
+| `createDatabaseConnection(options)` | Create MongoDB connection with retry logic |
+| `buildMongoUri(parts)` | Build MongoDB URI from parts |
+| `buildUriFromConfig(config)` | Build URI from database config object |
 
-- `setupSocketIO(httpServer, modulesDir, options)` - Setup Socket.IO
-- `discoverSocketHandlers(modulesDir)` - Find socket handlers
-- `discoverSocketMiddleware(modulesDir)` - Find socket middleware
+### Logging
 
-### Context
+| Function | Description |
+|----------|-------------|
+| `createWinstonLogger(options)` | Create Winston logger with file rotation |
+| `createConsoleLogger(options)` | Create console-based logger |
+
+### Socket.IO
 
-- `createContext(options)` - Create application context
-- `createLogger(options)` - Create logger instance
+| Function | Description |
+|----------|-------------|
+| `setupSocketIO(server, modulesDir, options)` | Setup Socket.IO with auto-discovery |
+| `discoverSocketHandlers(modulesDir)` | Find socket handlers in modules |
+| `discoverSocketMiddleware(modulesDir)` | Find socket middleware in modules |
+
+---
 
 ## Testing
 
 ```bash
-yarn test    # Run tests
-yarn build   # Build package
+yarn test      # Run all 82 unit tests
+yarn build     # Build TypeScript to dist/
 ```
 
+## Requirements
+
+- Node.js >= 18.0.0
+- TypeScript >= 5.0.0
+- Express 5.x
+- Mongoose 8.x
+
 ## License
 
 MIT © [weconjs](https://github.com/weconjs)

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAc,MAAM,YAAY,CAAC;AAiC1E;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAiB7D;AAwED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,CAoChB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,CAYzB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAc,MAAM,YAAY,CAAC;AAiC1E;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAiB7D;AAwED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,CAqChB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,CAYzB"}

package/dist/config.js

@@ -143,6 +143,7 @@ export function resolveConfig(config, mode) {
         https: { ...DEFAULT_CONFIG.https },
         features: { ...DEFAULT_CONFIG.features },
         modules: [...(config.modules ?? [])],
+        moduleConfigs: { ...(config.moduleConfigs ?? {}) },
     };
     // Apply mode-specific configuration if defined
     if (config.modes && config.modes[targetMode]) {

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH;;GAEG;AACH,MAAM,cAAc,GAA4B;IAC9C,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE;QACR,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE;YACR,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,WAAW;SACtB;KACF;IACD,OAAO,EAAE;QACP,KAAK,EAAE,MAAM;QACb,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,KAAK;KAClB;IACD,KAAK,EAAE;QACL,OAAO,EAAE,KAAK;KACf;IACD,QAAQ,EAAE;QACR,WAAW,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;QAC9C,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;QAC5C,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;QAC3B,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;KAC3B;IACD,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,2BAA2B;IAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,yDAAyD;IACzD,OAAO;QACL,GAAG,EAAE;YACH,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI;YACrB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO;SACvC;QACD,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;KAC1B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAChB,MAAS,EACT,MAAkB;IAElB,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAO,CAAC;IAElC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,MAAM,CAAC,GAAc,CAAC,CAAC;QAC3C,MAAM,WAAW,GAAG,MAAM,CAAC,GAAc,CAAC,CAAC;QAE3C,IACE,WAAW;YACX,OAAO,WAAW,KAAK,QAAQ;YAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YAC3B,WAAW;YACX,OAAO,WAAW,KAAK,QAAQ;YAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAC3B,CAAC;YACA,MAAkC,CAAC,GAAG,CAAC,GAAG,SAAS,CAClD,WAAqB,EACrB,WAAqB,CACtB,CAAC;QACJ,CAAC;aAAM,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YACpC,MAAkC,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;QACzD,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,WAAW,CAClB,KAAiC,EACjC,QAAgB,EAChB,UAAuB,IAAI,GAAG,EAAE;IAEhC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,+CAA+C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CACrE,MAAM,CACP,OAAO,QAAQ,EAAE,CACnB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,8BAA8B,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEtB,yDAAyD;IACzD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,kBAAkB,EAAE,GAAG,IAAI,CAAC;QACnD,OAAO,SAAS,CAAC,UAAU,EAAE,kBAAyC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAmB,EACnB,IAAa;IAEb,MAAM,UAAU,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC;IAEjE,sBAAsB;IACtB,IAAI,QAAQ,GAAmB;QAC7B,GAAG,EAAE;YACH,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI;YACrB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO;SACvC;QACD,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,cAAc,CAAC,IAAK;QAC1B,QAAQ,EAAE,EAAE,GAAG,cAAc,CAAC,QAAQ,EAAE;QACxC,OAAO,EAAE,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE;QACtC,KAAK,EAAE,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE;QAClC,QAAQ,EAAE,EAAE,GAAG,cAAc,CAAC,QAAQ,EAAE;QACxC,OAAO,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;KACrC,CAAC;IAEF,+CAA+C;IAC/C,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAEzD,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE;YAC7B,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;SACG,CAAC,CAAC;IAChC,CAAC;IAED,iBAAiB;IACjB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,QAAQ,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,UAAkB,EAClB,IAAa;IAEb,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAgB,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC;QAEjE,OAAO,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,yCAAyC,UAAU,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/context.d.ts

@@ -6,24 +6,22 @@
  */
 import type { Application } from "express";
 import type { Server } from "socket.io";
+import type { z } from "zod";
 import type { WeconContext, ResolvedConfig, WeconLogger } from "./types.js";
 /**
- * Create a Wecon application context
- *
- * @param options - Context options
- * @returns The application context
+ * Create a Wecon application context.
+ * Includes service registry and typed module config access.
  */
 export declare function createContext(options: {
     config: ResolvedConfig;
     app: Application;
     io?: Server;
     logger?: WeconLogger;
+    /** Zod schemas for module configs (used by setModuleConfig validation) */
+    moduleSchemas?: Map<string, z.ZodType>;
 }): WeconContext;
 /**
- * Enhance the logger based on configuration
- *
- * @param config - The resolved configuration
- * @param customLogger - Optional custom logger implementation
+ * Create a level-aware logger from config.
  */
 export declare function createLogger(config: ResolvedConfig, customLogger?: WeconLogger): WeconLogger;
 //# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EAEZ,MAAM,YAAY,CAAC;AAYpB;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,WAAW,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,YAAY,CAuBf;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EACtB,YAAY,CAAC,EAAE,WAAW,GACzB,WAAW,CAiCb"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EAEZ,MAAM,YAAY,CAAC;AASpB;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,WAAW,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;CACxC,GAAG,YAAY,CAgDf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EACtB,YAAY,CAAC,EAAE,WAAW,GACzB,WAAW,CAuBb"}