@cosmneo/onion-lasagna 0.2.0 → 0.3.0

package/dist/http/server/index.d.cts

@@ -1,265 +1,8 @@
-import { R as RouteDefinition, H as HttpMethod, j as RouterConfig, m as RouterKeys, G as GetRoute, k as RouterDefinition } from '../../router-definition.type-ynBhT16T.cjs';
+import { d as RouterConfig, e as RouterDefinition, g as RouterKeys, G as GetRoute, R as RouteDefinition } from '../../router-definition.type-BElX-Pl4.cjs';
+import { d as SimpleHandlerFn, e as SimpleHandlerConfig, V as ValidatedRequest, T as TypedContext, U as UseCasePort, a as HandlerResponse, M as MiddlewareFunction, C as CreateServerRoutesOptions, b as UnifiedRouteInput } from '../../types-afYpL7Ap.cjs';
+export { H as HandlerContext, c as RawHttpRequest, R as RouteHandlerConfig, S as ServerRoutesConfig } from '../../types-afYpL7Ap.cjs';
 import '../schema/types.cjs';
 
-/**
- * @fileoverview Server types for the unified route system.
- *
- * @module unified/server/types
- */
-
-/**
- * A validated request with typed data.
- * This is what handlers receive after validation passes.
- */
-interface ValidatedRequest<TRoute extends RouteDefinition> {
-    /**
-     * Validated request body.
-     */
-    readonly body: TRoute['_types']['body'];
-    /**
-     * Validated query parameters.
-     */
-    readonly query: TRoute['_types']['query'];
-    /**
-     * Validated path parameters.
-     */
-    readonly pathParams: TRoute['_types']['pathParams'];
-    /**
-     * Validated headers.
-     */
-    readonly headers: TRoute['_types']['headers'];
-    /**
-     * Raw request object for advanced use cases.
-     */
-    readonly raw: {
-        readonly method: string;
-        readonly url: string;
-        readonly headers: Record<string, string>;
-    };
-}
-/**
- * Typed context based on route definition.
- * If the route defines a context schema, this will be the validated type.
- * Otherwise, it falls back to the generic HandlerContext.
- */
-type TypedContext<TRoute extends RouteDefinition> = TRoute['_types']['context'] extends undefined ? HandlerContext : TRoute['_types']['context'];
-/**
- * Context passed to handlers.
- * Can be extended with custom context via serverRoutes options.
- */
-interface HandlerContext {
-    /**
-     * Request ID for tracing.
-     */
-    readonly requestId?: string;
-    /**
-     * Additional context data.
-     */
-    readonly [key: string]: unknown;
-}
-/**
- * Response from a handler.
- */
-interface HandlerResponse<TData = unknown> {
-    /**
-     * HTTP status code.
-     */
-    readonly status: number;
-    /**
-     * Response body.
-     */
-    readonly body?: TData;
-    /**
-     * Response headers.
-     */
-    readonly headers?: Record<string, string>;
-}
-/**
- * Use case port interface for unified routes.
- *
- * This is a simplified version that accepts any input/output types (plain objects).
- * It's structurally compatible with `BaseInboundPort`, so existing use case
- * implementations work without changes.
- *
- * @typeParam TInput - Input type (plain object or void for no input)
- * @typeParam TOutput - Output type (plain object or void for no output)
- *
- * @example
- * ```typescript
- * // Define plain types for use case contracts
- * type CreateProjectInput = {
- *   name: string;
- *   description?: string;
- * };
- *
- * type CreateProjectOutput = {
- *   projectId: string;
- * };
- *
- * // Use case implements this interface
- * class CreateProjectUseCase implements UseCasePort<CreateProjectInput, CreateProjectOutput> {
- *   async execute(input: CreateProjectInput): Promise<CreateProjectOutput> {
- *     // ... implementation
- *     return { projectId: '...' };
- *   }
- * }
- * ```
- */
-interface UseCasePort<TInput = void, TOutput = void> {
-    execute(input?: TInput): Promise<TOutput>;
-}
-/**
- * Handler configuration for a single route.
- *
- * Mirrors the BaseController pattern with three components:
- * - `requestMapper`: Maps validated HTTP request to use case input
- * - `useCase`: The use case to execute
- * - `responseMapper`: Maps use case output to HTTP response
- *
- * @typeParam TRoute - The route definition type
- * @typeParam TInput - Use case input type (plain object)
- * @typeParam TOutput - Use case output type (plain object)
- *
- * @example
- * ```typescript
- * const config: RouteHandlerConfig<typeof createProjectRoute, CreateProjectInput, CreateProjectOutput> = {
- *   requestMapper: (req) => ({
- *     name: req.body.name,
- *     description: req.body.description,
- *   }),
- *   useCase: createProjectUseCase,
- *   responseMapper: (out) => ({
- *     status: 201,
- *     body: { projectId: out.projectId },
- *   }),
- * };
- * ```
- */
-interface RouteHandlerConfig<TRoute extends RouteDefinition, TInput = void, TOutput = void> {
-    /**
-     * Maps the validated HTTP request to use case input.
-     * The request has already been validated by the route's schemas.
-     * Context is typed based on the route's context schema (if defined).
-     */
-    readonly requestMapper: (req: ValidatedRequest<TRoute>, ctx: TypedContext<TRoute>) => TInput;
-    /**
-     * The use case to execute.
-     * Can be any object with an `execute` method matching `UseCasePort`.
-     */
-    readonly useCase: UseCasePort<TInput, TOutput>;
-    /**
-     * Maps the use case output to an HTTP response.
-     * Determines the status code and response body.
-     */
-    readonly responseMapper: (output: TOutput) => HandlerResponse;
-    /**
-     * Middleware to run before the handler.
-     */
-    readonly middleware?: readonly MiddlewareFunction[];
-}
-/**
- * Middleware function type.
- */
-type MiddlewareFunction = (request: unknown, context: HandlerContext, next: () => Promise<HandlerResponse>) => Promise<HandlerResponse>;
-/**
- * Simple handler function that directly returns a response.
- * Use this for simple routes that don't need the use case pattern.
- */
-type SimpleHandlerFn<TRoute extends RouteDefinition> = (req: ValidatedRequest<TRoute>, ctx: TypedContext<TRoute>) => Promise<HandlerResponse> | HandlerResponse;
-/**
- * Configuration for a simple handler (no use case).
- */
-interface SimpleHandlerConfig<TRoute extends RouteDefinition> {
-    readonly handler: SimpleHandlerFn<TRoute>;
-    readonly middleware?: readonly MiddlewareFunction[];
-}
-/**
- * Configuration mapping route keys to handlers.
- *
- * Each route key maps to a `RouteHandlerConfig` with:
- * - The route definition for that key (provides request/response types)
- * - User-defined input/output types for the use case
- *
- * The `TInput` and `TOutput` types are inferred from the `useCase` property,
- * so you don't need to specify them explicitly.
- */
-type ServerRoutesConfig<T extends RouterConfig> = {
-    [K in RouterKeys<T>]: RouteHandlerConfig<GetRoute<T, K>, any, any>;
-};
-/**
- * Options for creating server routes.
- */
-interface CreateServerRoutesOptions {
-    /**
-     * Global middleware to run before all handlers.
-     */
-    readonly middleware?: readonly MiddlewareFunction[];
-    /**
-     * Whether to validate incoming requests against route schemas.
-     * When enabled, invalid requests throw InvalidRequestError.
-     * @default true
-     */
-    readonly validateRequest?: boolean;
-    /**
-     * Whether to validate outgoing responses against route schemas.
-     * When enabled, invalid responses throw ControllerError.
-     * Useful for catching bugs and ensuring API contract compliance.
-     * @default true
-     */
-    readonly validateResponse?: boolean;
-    /**
-     * Context factory to create handler context.
-     */
-    readonly createContext?: (rawRequest: unknown) => HandlerContext;
-    /**
-     * Allow partial handler configuration (not all routes need handlers).
-     * When true, missing handlers are silently skipped.
-     * When false (default), missing handlers throw an error.
-     * @default false
-     * @internal Used by builder pattern's buildPartial()
-     */
-    readonly allowPartial?: boolean;
-}
-/**
- * Route input compatible with framework adapters.
- * This is the output of serverRoutes().build().
- */
-interface UnifiedRouteInput {
-    /**
-     * HTTP method.
-     */
-    readonly method: HttpMethod;
-    /**
-     * URL path pattern.
-     */
-    readonly path: string;
-    /**
-     * Handler function.
-     */
-    readonly handler: (rawRequest: RawHttpRequest, context?: HandlerContext) => Promise<HandlerResponse>;
-    /**
-     * Route metadata for documentation.
-     */
-    readonly metadata: {
-        readonly operationId?: string;
-        readonly summary?: string;
-        readonly description?: string;
-        readonly tags?: readonly string[];
-        readonly deprecated?: boolean;
-    };
-}
-/**
- * Raw HTTP request from the framework.
- */
-interface RawHttpRequest {
-    readonly method: string;
-    readonly url: string;
-    readonly headers: Record<string, string | string[] | undefined>;
-    readonly body?: unknown;
-    readonly query?: Record<string, string | string[] | undefined>;
-    readonly params?: Record<string, string>;
-}
-
 /**
  * @fileoverview Builder pattern for creating type-safe server routes.
  *
@@ -442,4 +185,4 @@ interface ServerRoutesBuilder<T extends RouterConfig, THandled extends string =
  */
 declare function serverRoutes<T extends RouterConfig>(router: T | RouterDefinition<T>): ServerRoutesBuilder<T, never>;
 
-export { type BuilderHandlerConfig, type CreateServerRoutesOptions, type HandlerContext, type HandlerResponse, type MiddlewareFunction, type MissingHandlersError, type RawHttpRequest, type RouteHandlerConfig, type ServerRoutesBuilder, type ServerRoutesConfig, type TypedContext, type UnifiedRouteInput, type UseCasePort, type ValidatedRequest, serverRoutes };
+export { type BuilderHandlerConfig, CreateServerRoutesOptions, HandlerResponse, MiddlewareFunction, type MissingHandlersError, type ServerRoutesBuilder, TypedContext, UnifiedRouteInput, UseCasePort, ValidatedRequest, serverRoutes };

package/dist/http/server/index.d.ts

@@ -1,265 +1,8 @@
-import { R as RouteDefinition, H as HttpMethod, j as RouterConfig, m as RouterKeys, G as GetRoute, k as RouterDefinition } from '../../router-definition.type-DORVlLNk.js';
+import { d as RouterConfig, e as RouterDefinition, g as RouterKeys, G as GetRoute, R as RouteDefinition } from '../../router-definition.type-DxG8ncJZ.js';
+import { d as SimpleHandlerFn, e as SimpleHandlerConfig, V as ValidatedRequest, T as TypedContext, U as UseCasePort, a as HandlerResponse, M as MiddlewareFunction, C as CreateServerRoutesOptions, b as UnifiedRouteInput } from '../../types-B6Q1iCgf.js';
+export { H as HandlerContext, c as RawHttpRequest, R as RouteHandlerConfig, S as ServerRoutesConfig } from '../../types-B6Q1iCgf.js';
 import '../schema/types.js';
 
-/**
- * @fileoverview Server types for the unified route system.
- *
- * @module unified/server/types
- */
-
-/**
- * A validated request with typed data.
- * This is what handlers receive after validation passes.
- */
-interface ValidatedRequest<TRoute extends RouteDefinition> {
-    /**
-     * Validated request body.
-     */
-    readonly body: TRoute['_types']['body'];
-    /**
-     * Validated query parameters.
-     */
-    readonly query: TRoute['_types']['query'];
-    /**
-     * Validated path parameters.
-     */
-    readonly pathParams: TRoute['_types']['pathParams'];
-    /**
-     * Validated headers.
-     */
-    readonly headers: TRoute['_types']['headers'];
-    /**
-     * Raw request object for advanced use cases.
-     */
-    readonly raw: {
-        readonly method: string;
-        readonly url: string;
-        readonly headers: Record<string, string>;
-    };
-}
-/**
- * Typed context based on route definition.
- * If the route defines a context schema, this will be the validated type.
- * Otherwise, it falls back to the generic HandlerContext.
- */
-type TypedContext<TRoute extends RouteDefinition> = TRoute['_types']['context'] extends undefined ? HandlerContext : TRoute['_types']['context'];
-/**
- * Context passed to handlers.
- * Can be extended with custom context via serverRoutes options.
- */
-interface HandlerContext {
-    /**
-     * Request ID for tracing.
-     */
-    readonly requestId?: string;
-    /**
-     * Additional context data.
-     */
-    readonly [key: string]: unknown;
-}
-/**
- * Response from a handler.
- */
-interface HandlerResponse<TData = unknown> {
-    /**
-     * HTTP status code.
-     */
-    readonly status: number;
-    /**
-     * Response body.
-     */
-    readonly body?: TData;
-    /**
-     * Response headers.
-     */
-    readonly headers?: Record<string, string>;
-}
-/**
- * Use case port interface for unified routes.
- *
- * This is a simplified version that accepts any input/output types (plain objects).
- * It's structurally compatible with `BaseInboundPort`, so existing use case
- * implementations work without changes.
- *
- * @typeParam TInput - Input type (plain object or void for no input)
- * @typeParam TOutput - Output type (plain object or void for no output)
- *
- * @example
- * ```typescript
- * // Define plain types for use case contracts
- * type CreateProjectInput = {
- *   name: string;
- *   description?: string;
- * };
- *
- * type CreateProjectOutput = {
- *   projectId: string;
- * };
- *
- * // Use case implements this interface
- * class CreateProjectUseCase implements UseCasePort<CreateProjectInput, CreateProjectOutput> {
- *   async execute(input: CreateProjectInput): Promise<CreateProjectOutput> {
- *     // ... implementation
- *     return { projectId: '...' };
- *   }
- * }
- * ```
- */
-interface UseCasePort<TInput = void, TOutput = void> {
-    execute(input?: TInput): Promise<TOutput>;
-}
-/**
- * Handler configuration for a single route.
- *
- * Mirrors the BaseController pattern with three components:
- * - `requestMapper`: Maps validated HTTP request to use case input
- * - `useCase`: The use case to execute
- * - `responseMapper`: Maps use case output to HTTP response
- *
- * @typeParam TRoute - The route definition type
- * @typeParam TInput - Use case input type (plain object)
- * @typeParam TOutput - Use case output type (plain object)
- *
- * @example
- * ```typescript
- * const config: RouteHandlerConfig<typeof createProjectRoute, CreateProjectInput, CreateProjectOutput> = {
- *   requestMapper: (req) => ({
- *     name: req.body.name,
- *     description: req.body.description,
- *   }),
- *   useCase: createProjectUseCase,
- *   responseMapper: (out) => ({
- *     status: 201,
- *     body: { projectId: out.projectId },
- *   }),
- * };
- * ```
- */
-interface RouteHandlerConfig<TRoute extends RouteDefinition, TInput = void, TOutput = void> {
-    /**
-     * Maps the validated HTTP request to use case input.
-     * The request has already been validated by the route's schemas.
-     * Context is typed based on the route's context schema (if defined).
-     */
-    readonly requestMapper: (req: ValidatedRequest<TRoute>, ctx: TypedContext<TRoute>) => TInput;
-    /**
-     * The use case to execute.
-     * Can be any object with an `execute` method matching `UseCasePort`.
-     */
-    readonly useCase: UseCasePort<TInput, TOutput>;
-    /**
-     * Maps the use case output to an HTTP response.
-     * Determines the status code and response body.
-     */
-    readonly responseMapper: (output: TOutput) => HandlerResponse;
-    /**
-     * Middleware to run before the handler.
-     */
-    readonly middleware?: readonly MiddlewareFunction[];
-}
-/**
- * Middleware function type.
- */
-type MiddlewareFunction = (request: unknown, context: HandlerContext, next: () => Promise<HandlerResponse>) => Promise<HandlerResponse>;
-/**
- * Simple handler function that directly returns a response.
- * Use this for simple routes that don't need the use case pattern.
- */
-type SimpleHandlerFn<TRoute extends RouteDefinition> = (req: ValidatedRequest<TRoute>, ctx: TypedContext<TRoute>) => Promise<HandlerResponse> | HandlerResponse;
-/**
- * Configuration for a simple handler (no use case).
- */
-interface SimpleHandlerConfig<TRoute extends RouteDefinition> {
-    readonly handler: SimpleHandlerFn<TRoute>;
-    readonly middleware?: readonly MiddlewareFunction[];
-}
-/**
- * Configuration mapping route keys to handlers.
- *
- * Each route key maps to a `RouteHandlerConfig` with:
- * - The route definition for that key (provides request/response types)
- * - User-defined input/output types for the use case
- *
- * The `TInput` and `TOutput` types are inferred from the `useCase` property,
- * so you don't need to specify them explicitly.
- */
-type ServerRoutesConfig<T extends RouterConfig> = {
-    [K in RouterKeys<T>]: RouteHandlerConfig<GetRoute<T, K>, any, any>;
-};
-/**
- * Options for creating server routes.
- */
-interface CreateServerRoutesOptions {
-    /**
-     * Global middleware to run before all handlers.
-     */
-    readonly middleware?: readonly MiddlewareFunction[];
-    /**
-     * Whether to validate incoming requests against route schemas.
-     * When enabled, invalid requests throw InvalidRequestError.
-     * @default true
-     */
-    readonly validateRequest?: boolean;
-    /**
-     * Whether to validate outgoing responses against route schemas.
-     * When enabled, invalid responses throw ControllerError.
-     * Useful for catching bugs and ensuring API contract compliance.
-     * @default true
-     */
-    readonly validateResponse?: boolean;
-    /**
-     * Context factory to create handler context.
-     */
-    readonly createContext?: (rawRequest: unknown) => HandlerContext;
-    /**
-     * Allow partial handler configuration (not all routes need handlers).
-     * When true, missing handlers are silently skipped.
-     * When false (default), missing handlers throw an error.
-     * @default false
-     * @internal Used by builder pattern's buildPartial()
-     */
-    readonly allowPartial?: boolean;
-}
-/**
- * Route input compatible with framework adapters.
- * This is the output of serverRoutes().build().
- */
-interface UnifiedRouteInput {
-    /**
-     * HTTP method.
-     */
-    readonly method: HttpMethod;
-    /**
-     * URL path pattern.
-     */
-    readonly path: string;
-    /**
-     * Handler function.
-     */
-    readonly handler: (rawRequest: RawHttpRequest, context?: HandlerContext) => Promise<HandlerResponse>;
-    /**
-     * Route metadata for documentation.
-     */
-    readonly metadata: {
-        readonly operationId?: string;
-        readonly summary?: string;
-        readonly description?: string;
-        readonly tags?: readonly string[];
-        readonly deprecated?: boolean;
-    };
-}
-/**
- * Raw HTTP request from the framework.
- */
-interface RawHttpRequest {
-    readonly method: string;
-    readonly url: string;
-    readonly headers: Record<string, string | string[] | undefined>;
-    readonly body?: unknown;
-    readonly query?: Record<string, string | string[] | undefined>;
-    readonly params?: Record<string, string>;
-}
-
 /**
  * @fileoverview Builder pattern for creating type-safe server routes.
  *
@@ -442,4 +185,4 @@ interface ServerRoutesBuilder<T extends RouterConfig, THandled extends string =
  */
 declare function serverRoutes<T extends RouterConfig>(router: T | RouterDefinition<T>): ServerRoutesBuilder<T, never>;
 
-export { type BuilderHandlerConfig, type CreateServerRoutesOptions, type HandlerContext, type HandlerResponse, type MiddlewareFunction, type MissingHandlersError, type RawHttpRequest, type RouteHandlerConfig, type ServerRoutesBuilder, type ServerRoutesConfig, type TypedContext, type UnifiedRouteInput, type UseCasePort, type ValidatedRequest, serverRoutes };
+export { type BuilderHandlerConfig, CreateServerRoutesOptions, HandlerResponse, MiddlewareFunction, type MissingHandlersError, type ServerRoutesBuilder, TypedContext, UnifiedRouteInput, UseCasePort, ValidatedRequest, serverRoutes };

package/dist/http/server/index.js

@@ -1,10 +1,10 @@
 import {
   serverRoutes
-} from "../../chunk-GGSAAZPM.js";
+} from "../../chunk-AUMHMWDD.js";
 import "../../chunk-T7S574XQ.js";
 import "../../chunk-ZG26OQFN.js";
 import "../../chunk-A4JUAZK4.js";
-import "../../chunk-DS7TE6KZ.js";
+import "../../chunk-XP6PLTV2.js";
 export {
   serverRoutes
 };