@veloxts/core 0.6.87 → 0.6.89

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @veloxts/core
 
+## 0.6.89
+
+### Patch Changes
+
+- expand preset system with server config, auth presets, and security validation
+
+## 0.6.88
+
+### Patch Changes
+
+- add ecosystem presets for environment-aware configuration
+
 ## 0.6.87
 
 ### Patch Changes

package/dist/app.js

@@ -5,7 +5,7 @@
  */
 import fastify from 'fastify';
 import fp from 'fastify-plugin';
-import { createContext } from './context.js';
+import { setupContextHook } from './context.js';
 import { container } from './di/index.js';
 import { isVeloxError, VeloxError } from './errors.js';
 import { isFastifyPlugin, isVeloxPlugin, validatePluginMetadata } from './plugin.js';
@@ -163,14 +163,7 @@ export class VeloxApp {
      * @internal
      */
     _setupContext() {
-        // Create context for each request via direct assignment
-        // TypeScript's declaration merging provides type safety
-        this._server.addHook('onRequest', async (request, reply) => {
-            // Direct assignment is ~100-400ns faster than Object.defineProperty
-            // We use a mutable type assertion here because this is the framework's
-            // initialization code - the readonly constraint is for user code safety
-            request.context = createContext(request, reply);
-        });
+        setupContextHook(this._server);
     }
     /**
      * Sets up global error handling

package/dist/context.d.ts

@@ -72,6 +72,17 @@ export declare function createContext(request: FastifyRequest, reply: FastifyRep
  * ```
  */
 export declare function isContext(value: unknown): value is BaseContext;
+/**
+ * Sets up the context hook on a Fastify server
+ *
+ * This is the internal implementation used by both VeloxApp and setupTestContext
+ * to populate `request.context` on every request.
+ *
+ * @param server - Fastify server instance
+ *
+ * @internal
+ */
+export declare function setupContextHook(server: FastifyInstance): void;
 /**
  * Sets up the test context hook on a Fastify server
  *

package/dist/context.js

@@ -54,6 +54,26 @@ export function isContext(value) {
         typeof ctx.reply === 'object' &&
         ctx.reply !== null);
 }
+/**
+ * Sets up the context hook on a Fastify server
+ *
+ * This is the internal implementation used by both VeloxApp and setupTestContext
+ * to populate `request.context` on every request.
+ *
+ * @param server - Fastify server instance
+ *
+ * @internal
+ */
+export function setupContextHook(server) {
+    // Create context for each request via direct assignment
+    // TypeScript's declaration merging provides type safety
+    server.addHook('onRequest', async (request, reply) => {
+        // Direct assignment is ~100-400ns faster than Object.defineProperty
+        // We use a mutable type assertion here because this is the framework's
+        // initialization code - the readonly constraint is for user code safety
+        request.context = createContext(request, reply);
+    });
+}
 /**
  * Sets up the test context hook on a Fastify server
  *
@@ -79,7 +99,5 @@ export function isContext(value) {
  * ```
  */
 export function setupTestContext(server) {
-    server.addHook('onRequest', async (request, reply) => {
-        request.context = createContext(request, reply);
-    });
+    setupContextHook(server);
 }

package/dist/di/container.d.ts

@@ -174,6 +174,23 @@ export declare class Container {
      * @returns The normalized provider or undefined
      */
     getProvider<T>(token: InjectionToken<T>): NormalizedProvider<T> | undefined;
+    /**
+     * Validates token and retrieves provider with circular dependency checking
+     *
+     * This is the shared resolution logic used by both resolve() and resolveAsync().
+     * It handles:
+     * - Token validation
+     * - Circular dependency detection
+     * - Provider lookup (local and parent)
+     * - Auto-registration for unregistered class tokens
+     *
+     * @param token - The token to resolve
+     * @returns The normalized provider for the token
+     * @throws {VeloxError} If circular dependency detected or no provider found
+     *
+     * @internal
+     */
+    private getValidatedProvider;
     /**
      * Resolves a service from the container
      *

package/dist/di/container.js

@@ -176,23 +176,22 @@ export class Container {
     // Resolution
     // ==========================================================================
     /**
-     * Resolves a service from the container
+     * Validates token and retrieves provider with circular dependency checking
      *
-     * @param token - The token to resolve
-     * @param context - Optional resolution context (for request scope)
-     * @returns The resolved service instance
-     * @throws {VeloxError} If the service cannot be resolved
+     * This is the shared resolution logic used by both resolve() and resolveAsync().
+     * It handles:
+     * - Token validation
+     * - Circular dependency detection
+     * - Provider lookup (local and parent)
+     * - Auto-registration for unregistered class tokens
      *
-     * @example
-     * ```typescript
-     * // Basic resolution
-     * const userService = container.resolve(UserService);
+     * @param token - The token to resolve
+     * @returns The normalized provider for the token
+     * @throws {VeloxError} If circular dependency detected or no provider found
      *
-     * // With request context (for request-scoped services)
-     * const userContext = container.resolve(UserContext, { request });
-     * ```
+     * @internal
      */
-    resolve(token, context) {
+    getValidatedProvider(token) {
         validateToken(token);
         // Check for circular dependencies
         if (this.resolutionStack.has(token)) {
@@ -212,7 +211,27 @@ export class Container {
                 throw new VeloxError(`No provider found for: ${getTokenName(token)}`, 500, 'SERVICE_NOT_FOUND');
             }
         }
-        // Resolve based on scope
+        return provider;
+    }
+    /**
+     * Resolves a service from the container
+     *
+     * @param token - The token to resolve
+     * @param context - Optional resolution context (for request scope)
+     * @returns The resolved service instance
+     * @throws {VeloxError} If the service cannot be resolved
+     *
+     * @example
+     * ```typescript
+     * // Basic resolution
+     * const userService = container.resolve(UserService);
+     *
+     * // With request context (for request-scoped services)
+     * const userContext = container.resolve(UserContext, { request });
+     * ```
+     */
+    resolve(token, context) {
+        const provider = this.getValidatedProvider(token);
         return this.resolveWithScope(token, provider, context);
     }
     /**
@@ -435,23 +454,7 @@ export class Container {
      * ```
      */
     async resolveAsync(token, context) {
-        validateToken(token);
-        // Check for circular dependencies
-        if (this.resolutionStack.has(token)) {
-            const stack = [...this.resolutionStack].map((t) => getTokenName(t));
-            const current = getTokenName(token);
-            throw new VeloxError(`Circular dependency detected: ${[...stack, current].join(' -> ')}`, 500, 'CIRCULAR_DEPENDENCY');
-        }
-        // Get provider
-        let provider = this.getProvider(token);
-        if (!provider) {
-            if (this.autoRegister && isClassToken(token)) {
-                provider = this.tryAutoRegister(token);
-            }
-            if (!provider) {
-                throw new VeloxError(`No provider found for: ${getTokenName(token)}`, 500, 'SERVICE_NOT_FOUND');
-            }
-        }
+        const provider = this.getValidatedProvider(token);
         return this.resolveWithScopeAsync(token, provider, context);
     }
     /**

package/dist/index.d.ts

@@ -22,7 +22,7 @@ export type { FastifyLoggerOptions, FastifyReply, FastifyRequest } from 'fastify
 export type { StartOptions } from './app.js';
 export { VeloxApp, velox, veloxApp } from './app.js';
 export type { BaseContext } from './context.js';
-export { createContext, isContext, setupTestContext } from './context.js';
+export { createContext, isContext, setupContextHook, setupTestContext } from './context.js';
 export type { AbstractClass, ClassConstructor, ClassProvider, ContainerOptions, ExistingProvider, FactoryProvider, InjectableOptions, InjectionToken, Provider, ResolutionContext, StringToken, SymbolToken, TokenType, ValueProvider, } from './di/index.js';
 export { asClass, asExisting, asFactory, asValue, Container, container, factory, getConstructorTokens, getExplicitInjectTokens, getInjectableScope, getOptionalParams, getTokenName, Inject, Injectable, isClassProvider, isClassToken, isExistingProvider, isFactoryProvider, isInjectable, isStringToken, isSymbolToken, isValueProvider, makeInjectable, Optional, Scope, ScopeManager, scoped, setInjectTokens, singleton, token, transient, validateProvider, validateToken, value, } from './di/index.js';
 export type { ErrorCode, ErrorResponse, GenericErrorResponse, InterpolationVars, NotFoundErrorResponse, ValidationErrorResponse, VeloxCoreErrorCode, VeloxErrorCode, VeloxErrorCodeRegistry, } from './errors.js';

package/dist/index.js

@@ -24,7 +24,7 @@ const packageJson = require('../package.json');
 /** VeloxTS framework version */
 export const VELOX_VERSION = packageJson.version ?? '0.0.0-unknown';
 export { VeloxApp, velox, veloxApp } from './app.js';
-export { createContext, isContext, setupTestContext } from './context.js';
+export { createContext, isContext, setupContextHook, setupTestContext } from './context.js';
 // Dependency Injection
 export { asClass, asExisting, asFactory, asValue, Container, container, factory, getConstructorTokens, getExplicitInjectTokens, getInjectableScope, getOptionalParams, getTokenName, Inject, Injectable, isClassProvider, isClassToken, isExistingProvider, isFactoryProvider, isInjectable, isStringToken, isSymbolToken, isValueProvider, makeInjectable, Optional, Scope, ScopeManager, scoped, setInjectTokens, singleton, token, transient, validateProvider, validateToken, value, } from './di/index.js';
 export { assertNever, ConfigurationError, 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/core",
-  "version": "0.6.87",
+  "version": "0.6.89",
   "description": "Fastify wrapper, DI container, and plugin system for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",