@veloxts/core 0.6.107 → 0.7.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @veloxts/core
 
+## 0.7.1
+
+### Patch Changes
+
+- security audit, bumps dependency packages
+
+## 0.7.0
+
+### Minor Changes
+
+- chore(deps): update Prisma from 7.3.0 to 7.4.0
+
 ## 0.6.107
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,6 @@
 # @veloxts/core
 
-> **Early Access (v0.6.x)**
+> **Early Access (v0.7.x)**
 
 Core foundation package for VeloxTS Framework - provides the Fastify wrapper, plugin system, error handling, and base context. Learn more at [@veloxts/velox](https://www.npmjs.com/package/@veloxts/velox).
 

package/dist/app.js

@@ -13,6 +13,8 @@ import { registerStatic } from './plugins/static.js';
 import { printBanner } from './utils/banner.js';
 import { mergeConfig, validateConfig } from './utils/config.js';
 import { LifecycleManager } from './utils/lifecycle.js';
+import { createLogger } from './utils/logger.js';
+const log = createLogger('core');
 /**
  * Main VeloxTS application instance
  *
@@ -187,7 +189,7 @@ export class VeloxApp {
             }
             catch (handlerError) {
                 // Last resort error handling - prevents unhandled rejections
-                console.error('Critical error in error handler:', handlerError);
+                log.error('Critical error in error handler:', handlerError);
                 if (!reply.sent) {
                     return reply.status(500).send({
                         error: 'InternalServerError',

package/dist/errors/formatter.js

@@ -6,7 +6,9 @@
  *
  * @module errors/formatter
  */
+import { createLogger } from '../utils/logger.js';
 import { getErrorEntry } from './catalog.js';
+const log = createLogger('core');
 // ============================================================================
 // ANSI Color Codes (for terminal output)
 // ============================================================================
@@ -298,7 +300,7 @@ export function formatErrorOneLine(error, catalogCode) {
  * @param catalogCode - Optional catalog error code
  */
 export function logError(error, catalogCode) {
-    console.error(formatError(error, catalogCode));
+    log.error(formatError(error, catalogCode));
 }
 /**
  * Log a warning with pretty formatting
@@ -314,7 +316,7 @@ export function logWarning(message, suggestion) {
         lines.push(`   ${color('→', 'gray')} ${suggestion}`);
     }
     lines.push('');
-    console.warn(lines.join('\n'));
+    log.warn(lines.join('\n'));
 }
 /**
  * Log a deprecation warning

package/dist/errors.js

@@ -6,6 +6,8 @@
 // Import catalog for use in error classes
 import { ERROR_CATALOG } from './errors/catalog.js';
 import { formatError as _formatError } from './errors/formatter.js';
+import { createLogger } from './utils/logger.js';
+const log = createLogger('core');
 // Re-export the enhanced error catalog, formatter, and fail()
 export { ERROR_CATALOG, ERROR_DOMAINS, extractErrorLocation, fail, formatError, formatErrorForApi, formatErrorOneLine, getDocsUrl, getErrorEntry, getErrorsByDomain, isKnownErrorCode, isVeloxFailure, logDeprecation, logError, logWarning, VeloxFailure, } from './errors/index.js';
 /**
@@ -126,7 +128,7 @@ export class VeloxError extends Error {
      * Log this error with pretty formatting
      */
     log() {
-        console.error(this.format());
+        log.error(this.format());
     }
 }
 /**

package/dist/index.d.ts

@@ -32,3 +32,5 @@ export type { AuthContextExtension, CombineContexts, ContextExtension, CoreConte
 export type { CacheControl, StaticOptions } from './plugins/static.js';
 export { registerStatic } from './plugins/static.js';
 export { requestLogger } from './plugins/request-logger.js';
+export type { Logger, LogLevel } from './utils/logger.js';
+export { createLogger } from './utils/logger.js';

package/dist/index.js

@@ -35,3 +35,4 @@ export { registerStatic } from './plugins/static.js';
 // Request Logging (Development)
 // ============================================================================
 export { requestLogger } from './plugins/request-logger.js';
+export { createLogger } from './utils/logger.js';

package/dist/utils/lifecycle.js

@@ -3,6 +3,8 @@
  * Handles graceful shutdown and cleanup
  * @module utils/lifecycle
  */
+import { createLogger } from './logger.js';
+const log = createLogger('core');
 /**
  * Manages graceful shutdown for the VeloxTS application
  *
@@ -68,7 +70,7 @@ export class LifecycleManager {
             }
             catch (error) {
                 // Log error but continue with other handlers
-                console.error('Error during shutdown handler execution:', error);
+                log.error('Error during shutdown handler execution:', error);
             }
         }
         this.isShuttingDown = false;
@@ -87,14 +89,14 @@ export class LifecycleManager {
         const signals = ['SIGINT', 'SIGTERM'];
         signals.forEach((signal) => {
             const handler = async () => {
-                console.log(`\nReceived ${signal}, initiating graceful shutdown...`);
+                log.info(`\nReceived ${signal}, initiating graceful shutdown...`);
                 try {
                     await onShutdown();
-                    console.log('Graceful shutdown completed');
+                    log.info('Graceful shutdown completed');
                     process.exit(0);
                 }
                 catch (error) {
-                    console.error('Error during graceful shutdown:', error);
+                    log.error('Error during graceful shutdown:', error);
                     process.exit(1);
                 }
             };

package/dist/utils/logger.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Structured Logger
+ *
+ * Minimal logging utility that respects VELOX_LOG_LEVEL environment variable.
+ * Replaces raw console.* calls in library code with namespaced, level-aware logging.
+ */
+/** Supported log levels, ordered by verbosity. */
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
+/** Logger instance returned by createLogger. */
+export interface Logger {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}
+/**
+ * Create a namespaced logger that respects VELOX_LOG_LEVEL.
+ *
+ * @param namespace - Logger namespace (e.g. 'router', 'auth')
+ * @returns Logger with debug/info/warn/error methods
+ *
+ * @example
+ * ```typescript
+ * import { createLogger } from '@veloxts/core';
+ *
+ * const log = createLogger('router');
+ * log.info('Route registered:', method, path);
+ * log.warn('Deprecated route pattern detected');
+ * log.error('Failed to register route:', error);
+ * ```
+ */
+export declare function createLogger(namespace: string): Logger;

package/dist/utils/logger.js

@@ -0,0 +1,59 @@
+/**
+ * Structured Logger
+ *
+ * Minimal logging utility that respects VELOX_LOG_LEVEL environment variable.
+ * Replaces raw console.* calls in library code with namespaced, level-aware logging.
+ */
+const LEVEL_PRIORITY = {
+    silent: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+};
+function getLogLevel() {
+    const env = (process.env.VELOX_LOG_LEVEL ?? 'warn').toLowerCase();
+    if (env in LEVEL_PRIORITY)
+        return env;
+    return 'warn';
+}
+/**
+ * Create a namespaced logger that respects VELOX_LOG_LEVEL.
+ *
+ * @param namespace - Logger namespace (e.g. 'router', 'auth')
+ * @returns Logger with debug/info/warn/error methods
+ *
+ * @example
+ * ```typescript
+ * import { createLogger } from '@veloxts/core';
+ *
+ * const log = createLogger('router');
+ * log.info('Route registered:', method, path);
+ * log.warn('Deprecated route pattern detected');
+ * log.error('Failed to register route:', error);
+ * ```
+ */
+export function createLogger(namespace) {
+    const prefix = `[@veloxts/${namespace}]`;
+    function shouldLog(level) {
+        return LEVEL_PRIORITY[level] <= LEVEL_PRIORITY[getLogLevel()];
+    }
+    return {
+        debug: (...args) => {
+            if (shouldLog('debug'))
+                console.debug(prefix, ...args);
+        },
+        info: (...args) => {
+            if (shouldLog('info'))
+                console.info(prefix, ...args);
+        },
+        warn: (...args) => {
+            if (shouldLog('warn'))
+                console.warn(prefix, ...args);
+        },
+        error: (...args) => {
+            if (shouldLog('error'))
+                console.error(prefix, ...args);
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/core",
-  "version": "0.6.107",
+  "version": "0.7.1",
   "description": "Fastify wrapper and plugin system for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",
@@ -43,7 +43,7 @@
   },
   "devDependencies": {
     "@fastify/static": "9.0.0",
-    "@types/node": "25.1.0",
+    "@types/node": "25.2.3",
     "@vitest/coverage-v8": "4.0.18",
     "typescript": "5.9.3",
     "vitest": "4.0.18"