@veloxts/velox 0.7.0 → 0.7.2

package/CHANGELOG.md

@@ -1,6 +1,42 @@
 # @veloxts/velox
 
-## 1.0.0
+## 0.7.2
+
+### Patch Changes
+
+- chore(auth,core,create,cli,client,orm,mcp,router,validation,web): simplify code for clarity and maintainability
+- Updated dependencies
+  - @veloxts/auth@0.7.2
+  - @veloxts/cache@0.7.2
+  - @veloxts/core@0.7.2
+  - @veloxts/events@0.7.2
+  - @veloxts/mail@0.7.2
+  - @veloxts/orm@0.7.2
+  - @veloxts/queue@0.7.2
+  - @veloxts/router@0.7.2
+  - @veloxts/scheduler@0.7.2
+  - @veloxts/storage@0.7.2
+  - @veloxts/validation@0.7.2
+
+## 0.7.1
+
+### Patch Changes
+
+- security audit, bumps dependency packages
+- Updated dependencies
+  - @veloxts/auth@0.7.1
+  - @veloxts/cache@0.7.1
+  - @veloxts/core@0.7.1
+  - @veloxts/events@0.7.1
+  - @veloxts/mail@0.7.1
+  - @veloxts/orm@0.7.1
+  - @veloxts/queue@0.7.1
+  - @veloxts/router@0.7.1
+  - @veloxts/scheduler@0.7.1
+  - @veloxts/storage@0.7.1
+  - @veloxts/validation@0.7.1
+
+## 0.7.0
 
 ### Minor Changes
 

package/dist/presets/defaults.js

@@ -160,77 +160,32 @@ const productionAuthPreset = {
     },
 };
 /**
- * Create production preset with validated environment variables.
+ * Build a production preset from environment variable values.
+ * Accepts either validated or raw values.
  */
-function createProductionPreset(env) {
+function buildProductionPreset(vars) {
     return {
         cache: {
             driver: 'redis',
-            config: {
-                url: env.REDIS_URL,
-            },
+            config: { url: vars.REDIS_URL },
         },
         queue: {
             driver: 'bullmq',
-            config: {
-                url: env.REDIS_URL,
-            },
+            config: { url: vars.REDIS_URL },
         },
         mail: {
             driver: 'resend',
-            config: {
-                apiKey: env.RESEND_API_KEY,
-            },
+            config: { apiKey: vars.RESEND_API_KEY },
         },
         storage: {
             driver: 's3',
-            bucket: env.S3_BUCKET,
-            region: env.AWS_REGION,
+            bucket: vars.S3_BUCKET,
+            region: vars.AWS_REGION,
         },
         events: {
             driver: 'ws',
             path: '/ws',
-            redis: env.REDIS_URL,
-        },
-        scheduler: {
-            tasks: [],
-        },
-        auth: productionAuthPreset,
-    };
-}
-/**
- * Create production preset with current environment variables (unvalidated).
- * Used for the module-level export. Prefer getPreset('production') which validates.
- */
-function createProductionPresetFromEnv() {
-    return {
-        cache: {
-            driver: 'redis',
-            config: {
-                url: process.env.REDIS_URL,
-            },
-        },
-        queue: {
-            driver: 'bullmq',
-            config: {
-                url: process.env.REDIS_URL,
-            },
-        },
-        mail: {
-            driver: 'resend',
-            config: {
-                apiKey: process.env.RESEND_API_KEY ?? '',
-            },
-        },
-        storage: {
-            driver: 's3',
-            bucket: process.env.S3_BUCKET ?? '',
-            region: process.env.AWS_REGION ?? 'us-east-1',
-        },
-        events: {
-            driver: 'ws',
-            path: '/ws',
-            redis: process.env.REDIS_URL,
+            redis: vars.REDIS_URL,
         },
         scheduler: {
             tasks: [],
@@ -254,7 +209,12 @@ function createProductionPresetFromEnv() {
  *
  * @see validateProductionEnv() to check if all required vars are set
  */
-export const productionPreset = createProductionPresetFromEnv();
+export const productionPreset = buildProductionPreset({
+    REDIS_URL: process.env.REDIS_URL,
+    RESEND_API_KEY: process.env.RESEND_API_KEY ?? '',
+    S3_BUCKET: process.env.S3_BUCKET ?? '',
+    AWS_REGION: process.env.AWS_REGION ?? 'us-east-1',
+});
 /**
  * Get preset configuration for an environment.
  * For production, validates required environment variables first.
@@ -267,11 +227,8 @@ export function getPreset(env) {
             return developmentPreset;
         case 'test':
             return testPreset;
-        case 'production': {
-            const env = validateProductionEnv();
-            // Return fresh preset to pick up env vars set after module load
-            return createProductionPreset(env);
-        }
+        case 'production':
+            return buildProductionPreset(validateProductionEnv());
     }
 }
 /**

package/dist/presets/env.js

@@ -2,23 +2,32 @@
  * Environment detection utilities.
  */
 /**
- * Detect current environment from NODE_ENV.
- * Defaults to 'development' if not set or unrecognized.
+ * Normalize a raw environment string to a recognized Environment value.
+ * Returns undefined if the value is not recognized.
  */
-export function detectEnvironment() {
-    const env = process.env.NODE_ENV?.toLowerCase().trim();
-    switch (env) {
+function normalizeEnvironment(value) {
+    const normalized = value?.toLowerCase().trim();
+    switch (normalized) {
         case 'production':
         case 'prod':
             return 'production';
         case 'test':
         case 'testing':
             return 'test';
-        default:
-            // 'development', 'dev', undefined, or any unrecognized value
+        case 'development':
+        case 'dev':
             return 'development';
+        default:
+            return undefined;
     }
 }
+/**
+ * Detect current environment from NODE_ENV.
+ * Defaults to 'development' if not set or unrecognized.
+ */
+export function detectEnvironment() {
+    return normalizeEnvironment(process.env.NODE_ENV) ?? 'development';
+}
 /**
  * Check if current environment is development.
  */
@@ -42,15 +51,9 @@ export function isTest() {
  * @throws Error if environment is not recognized.
  */
 export function validateEnvironment(env) {
-    const normalized = env.toLowerCase().trim();
-    if (normalized === 'production' || normalized === 'prod') {
-        return 'production';
-    }
-    if (normalized === 'test' || normalized === 'testing') {
-        return 'test';
-    }
-    if (normalized === 'development' || normalized === 'dev') {
-        return 'development';
+    const result = normalizeEnvironment(env);
+    if (!result) {
+        throw new Error(`Invalid environment: "${env}". Must be one of: development, test, production`);
     }
-    throw new Error(`Invalid environment: "${env}". Must be one of: development, test, production`);
+    return result;
 }

package/dist/presets/plugin.d.ts

@@ -1,7 +1,7 @@
 /**
  * Preset plugin for automatic ecosystem package registration.
  */
-import type { VeloxApp } from '@veloxts/core';
+import { type VeloxApp } from '@veloxts/core';
 import type { AuthPreset, EcosystemPreset, Environment, PresetOptions } from './types.js';
 /**
  * Register ecosystem plugins based on preset configuration.

package/dist/presets/plugin.js

@@ -1,55 +1,33 @@
 /**
  * Preset plugin for automatic ecosystem package registration.
  */
+import { createLogger } from '@veloxts/core';
 import { getPreset } from './defaults.js';
 import { detectEnvironment } from './env.js';
 import { mergeDeep } from './merge.js';
+const log = createLogger('velox');
+/**
+ * Extract the driver name from a package config object.
+ */
+function getDriver(config, defaultDriver) {
+    if (config !== null && typeof config === 'object' && 'driver' in config) {
+        const driver = config.driver;
+        if (typeof driver === 'string')
+            return driver;
+    }
+    return defaultDriver;
+}
 /**
  * All ecosystem packages that can be registered.
  */
 const PACKAGES = {
-    cache: {
-        name: '@veloxts/cache',
-        importPath: '@veloxts/cache',
-        pluginExport: 'cachePlugin',
-        getDriver: (c) => c?.driver ?? 'memory',
-    },
-    queue: {
-        name: '@veloxts/queue',
-        importPath: '@veloxts/queue',
-        pluginExport: 'queuePlugin',
-        getDriver: (c) => c?.driver ?? 'sync',
-    },
-    mail: {
-        name: '@veloxts/mail',
-        importPath: '@veloxts/mail',
-        pluginExport: 'mailPlugin',
-        getDriver: (c) => c?.driver ?? 'log',
-    },
-    storage: {
-        name: '@veloxts/storage',
-        importPath: '@veloxts/storage',
-        pluginExport: 'storagePlugin',
-        getDriver: (c) => c?.driver ?? 'local',
-    },
-    events: {
-        name: '@veloxts/events',
-        importPath: '@veloxts/events',
-        pluginExport: 'eventsPlugin',
-        getDriver: (c) => c?.driver ?? 'ws',
-    },
-    scheduler: {
-        name: '@veloxts/scheduler',
-        importPath: '@veloxts/scheduler',
-        pluginExport: 'schedulerPlugin',
-        getDriver: () => 'cron',
-    },
-    auth: {
-        name: '@veloxts/auth',
-        importPath: '@veloxts/auth',
-        pluginExport: 'authPlugin',
-        getDriver: () => 'jwt',
-    },
+    cache: { name: '@veloxts/cache', pluginExport: 'cachePlugin', defaultDriver: 'memory' },
+    queue: { name: '@veloxts/queue', pluginExport: 'queuePlugin', defaultDriver: 'sync' },
+    mail: { name: '@veloxts/mail', pluginExport: 'mailPlugin', defaultDriver: 'log' },
+    storage: { name: '@veloxts/storage', pluginExport: 'storagePlugin', defaultDriver: 'local' },
+    events: { name: '@veloxts/events', pluginExport: 'eventsPlugin', defaultDriver: 'ws' },
+    scheduler: { name: '@veloxts/scheduler', pluginExport: 'schedulerPlugin', defaultDriver: 'cron' },
+    auth: { name: '@veloxts/auth', pluginExport: 'authPlugin', defaultDriver: 'jwt' },
 };
 /**
  * Packages that require special handling and are NOT auto-registered.
@@ -89,20 +67,18 @@ export async function registerEcosystemPlugins(app, preset, options) {
         const info = PACKAGES[pkg];
         try {
             // Dynamic import to avoid hard dependency
-            const module = await import(info.importPath);
+            const module = await import(info.name);
             const plugin = module[info.pluginExport];
             if (!plugin) {
                 throw new Error(`Plugin export '${info.pluginExport}' not found`);
             }
             await app.register(plugin(config));
             if (!options?.silent) {
-                const driver = info.getDriver(config);
-                console.log(`  ✓ ${info.name} [${driver}]`);
+                log.info(`  ✓ ${info.name} [${getDriver(config, info.defaultDriver)}]`);
             }
         }
         catch (error) {
             const err = error;
-            // Check if it's a module not found error
             if (err.message?.includes('Cannot find module') || err.code === 'ERR_MODULE_NOT_FOUND') {
                 throw new Error(`Package ${info.name} is not installed. Install it with: pnpm add ${info.name}`);
             }
@@ -143,31 +119,24 @@ export async function registerEcosystemPlugins(app, preset, options) {
 export async function usePresets(app, options = {}) {
     const env = options.env ?? detectEnvironment();
     const basePreset = getPreset(env);
-    // Merge overrides with base preset using type-safe helper
-    // Partial<T> is assignable to DeepPartial<T> for single-level overrides
-    const merge = (base, override) => {
-        if (!base)
-            return undefined;
-        if (!override)
-            return base;
-        // Partial<T> is compatible with DeepPartial<T> at the first level
-        return mergeDeep(base, override);
-    };
-    const finalPreset = {
-        cache: merge(basePreset.cache, options.overrides?.cache),
-        queue: merge(basePreset.queue, options.overrides?.queue),
-        mail: merge(basePreset.mail, options.overrides?.mail),
-        storage: merge(basePreset.storage, options.overrides?.storage),
-        events: merge(basePreset.events, options.overrides?.events),
-        scheduler: merge(basePreset.scheduler, options.overrides?.scheduler),
-        auth: merge(basePreset.auth, options.overrides?.auth),
-    };
+    // Merge each package's overrides with its base preset
+    const finalPreset = { ...basePreset };
+    if (options.overrides) {
+        for (const key of Object.keys(options.overrides)) {
+            const base = basePreset[key];
+            const override = options.overrides[key];
+            if (base && override) {
+                // Partial<T> is compatible with DeepPartial<T> at the first level
+                finalPreset[key] = mergeDeep(base, override);
+            }
+        }
+    }
     if (!options.silent) {
-        console.log(`\n📦 VeloxTS Ecosystem Presets [${env}]`);
+        log.info(`\nVeloxTS Ecosystem Presets [${env}]`);
     }
     await registerEcosystemPlugins(app, finalPreset, options);
     if (!options.silent) {
-        console.log('');
+        log.info('');
     }
 }
 /**

package/dist/presets/server.js

@@ -24,13 +24,9 @@ function isValidLogLevel(value) {
  * @param defaultLevel - Fallback level if value is invalid
  */
 function parseLogLevel(value, defaultLevel) {
-    if (value === undefined) {
-        return defaultLevel;
-    }
     if (isValidLogLevel(value)) {
         return value;
     }
-    // Invalid log level - return default
     return defaultLevel;
 }
 /**
@@ -41,14 +37,11 @@ function parseLogLevel(value, defaultLevel) {
  * @param defaultPort - Fallback port if value is invalid
  */
 function parsePort(value, defaultPort) {
-    if (value === undefined) {
+    if (value === undefined)
         return defaultPort;
-    }
     const parsed = parseInt(value, 10);
-    // Check for NaN and ensure port is in valid range (1-65535)
-    if (Number.isNaN(parsed) || parsed < 1 || parsed > 65535) {
+    if (Number.isNaN(parsed) || parsed < 1 || parsed > 65535)
         return defaultPort;
-    }
     return parsed;
 }
 /**

package/dist/presets/validate.js

@@ -4,7 +4,9 @@
  * Validates that required environment variables, secrets, and security
  * settings are properly configured before the application starts.
  */
+import { createLogger } from '@veloxts/core';
 import { detectEnvironment } from './env.js';
+const log = createLogger('velox');
 /**
  * Default security requirements for production.
  */
@@ -130,36 +132,29 @@ export function validateSecurityOrThrow(requirements) {
     }
     const result = validateSecurity(requirements);
     if (!result.valid) {
-        const errorLines = result.errors.map((e) => {
-            let line = `  [${e.category}] ${e.key}: ${e.message}`;
-            if (e.suggestion) {
-                line += `\n    Suggestion: ${e.suggestion}`;
+        const formatIssue = (issue) => {
+            let line = `  [${issue.category}] ${issue.key}: ${issue.message}`;
+            if (issue.suggestion) {
+                line += `\n    Suggestion: ${issue.suggestion}`;
             }
             return line;
-        });
-        const warningLines = result.warnings.map((w) => {
-            let line = `  [${w.category}] ${w.key}: ${w.message}`;
-            if (w.suggestion) {
-                line += `\n    Suggestion: ${w.suggestion}`;
-            }
-            return line;
-        });
-        let message = `Production security validation failed:\n\n${errorLines.join('\n\n')}`;
-        if (warningLines.length > 0) {
-            message += `\n\nWarnings:\n${warningLines.join('\n\n')}`;
+        };
+        let message = `Production security validation failed:\n\n${result.errors.map(formatIssue).join('\n\n')}`;
+        if (result.warnings.length > 0) {
+            message += `\n\nWarnings:\n${result.warnings.map(formatIssue).join('\n\n')}`;
         }
         throw new Error(message);
     }
     // Log warnings even if validation passes
     if (result.warnings.length > 0) {
-        console.warn('\nSecurity warnings:');
+        log.warn('\nSecurity warnings:');
         for (const warning of result.warnings) {
-            console.warn(`  [${warning.category}] ${warning.key}: ${warning.message}`);
+            log.warn(`  [${warning.category}] ${warning.key}: ${warning.message}`);
             if (warning.suggestion) {
-                console.warn(`    Suggestion: ${warning.suggestion}`);
+                log.warn(`    Suggestion: ${warning.suggestion}`);
             }
         }
-        console.warn('');
+        log.warn('');
     }
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/velox",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Complete VeloxTS framework - batteries included",
   "type": "module",
   "main": "./dist/index.js",
@@ -39,30 +39,30 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@veloxts/router": "0.7.0",
-    "@veloxts/core": "0.7.0",
-    "@veloxts/orm": "0.7.0",
-    "@veloxts/validation": "0.7.0",
-    "@veloxts/auth": "0.7.0"
+    "@veloxts/core": "0.7.2",
+    "@veloxts/validation": "0.7.2",
+    "@veloxts/router": "0.7.2",
+    "@veloxts/orm": "0.7.2",
+    "@veloxts/auth": "0.7.2"
   },
   "devDependencies": {
     "typescript": "5.9.3",
     "vitest": "4.0.18",
-    "@veloxts/cache": "0.7.0",
-    "@veloxts/events": "0.7.0",
-    "@veloxts/mail": "0.7.0",
-    "@veloxts/queue": "0.7.0",
-    "@veloxts/scheduler": "0.7.0",
-    "@veloxts/storage": "0.7.0"
+    "@veloxts/events": "0.7.2",
+    "@veloxts/queue": "0.7.2",
+    "@veloxts/scheduler": "0.7.2",
+    "@veloxts/storage": "0.7.2",
+    "@veloxts/cache": "0.7.2",
+    "@veloxts/mail": "0.7.2"
   },
   "peerDependencies": {
     "zod": "^4.3.0",
-    "@veloxts/queue": "0.7.0",
-    "@veloxts/mail": "0.7.0",
-    "@veloxts/cache": "0.7.0",
-    "@veloxts/storage": "0.7.0",
-    "@veloxts/scheduler": "0.7.0",
-    "@veloxts/events": "0.7.0"
+    "@veloxts/cache": "0.7.2",
+    "@veloxts/queue": "0.7.2",
+    "@veloxts/storage": "0.7.2",
+    "@veloxts/mail": "0.7.2",
+    "@veloxts/events": "0.7.2",
+    "@veloxts/scheduler": "0.7.2"
   },
   "peerDependenciesMeta": {
     "@veloxts/cache": {