@carno.js/core 1.1.1 → 1.1.2

package/src/context/Context.d.ts

@@ -1,36 +0,0 @@
-/**
- * Request Context for Turbo.
- *
- * Lazy initialization for maximum performance:
- * - Query parsed only when accessed
- * - Body parsed only when needed
- * - Minimal allocations in hot path
- */
-export declare class Context {
-    readonly req: Request;
-    params: Record<string, string>;
-    locals: Record<string, any>;
-    private _query;
-    private _body;
-    private _bodyParsed;
-    private _url;
-    private _status;
-    constructor(req: Request, params?: Record<string, string>);
-    get status(): number;
-    set status(value: number);
-    get url(): URL;
-    get query(): Record<string, string>;
-    get body(): any;
-    parseBody(): Promise<any>;
-    get method(): string;
-    get headers(): Headers;
-    get path(): string;
-    json(data: any, status?: number): Response;
-    text(data: string, status?: number): Response;
-    html(data: string, status?: number): Response;
-    redirect(url: string, status?: number): Response;
-    /**
-     * Creates a Context from a job (for queue processing).
-     */
-    static createFromJob(job: any): Context;
-}

package/src/cors/CorsHandler.d.ts

@@ -1,47 +0,0 @@
-/**
- * CORS Configuration types.
- */
-export type CorsOrigin = string | string[] | RegExp | ((origin: string) => boolean);
-export interface CorsConfig {
-    origins: CorsOrigin;
-    methods?: string[];
-    allowedHeaders?: string[];
-    exposedHeaders?: string[];
-    credentials?: boolean;
-    maxAge?: number;
-}
-export declare const DEFAULT_CORS_METHODS: string[];
-export declare const DEFAULT_CORS_HEADERS: string[];
-/**
- * CORS Handler - Pre-computes headers at startup for maximum performance.
- */
-export declare class CorsHandler {
-    private readonly cache;
-    private readonly methodsStr;
-    private readonly headersStr;
-    private readonly exposedStr;
-    private readonly maxAgeStr;
-    private readonly hasCredentials;
-    private readonly isWildcard;
-    private readonly matcher;
-    private readonly preflightResponse;
-    constructor(config: CorsConfig);
-    /**
-     * Handle preflight (OPTIONS) request.
-     */
-    preflight(origin: string): Response;
-    /**
-     * Apply CORS headers to a response.
-     */
-    apply(response: Response, origin: string): Response;
-    /**
-     * Check if origin is allowed.
-     */
-    isAllowed(origin: string): boolean;
-    /**
-     * Get cached CORS headers for origin.
-     */
-    private getHeaders;
-    private buildHeaders;
-    private buildMatcher;
-}

package/src/decorators/Controller.d.ts

@@ -1,13 +0,0 @@
-import type { ControllerOptions } from '../metadata';
-/**
- * Marks a class as a controller with a base path.
- *
- * @example
- * // Simple path
- * @Controller('/users')
- *
- * @example
- * // With options
- * @Controller({ path: '/users', children: [ProfileController] })
- */
-export declare function Controller(pathOrOptions?: string | ControllerOptions): ClassDecorator;

package/src/decorators/Inject.d.ts

@@ -1,6 +0,0 @@
-import type { Token } from '../container/Container';
-/**
- * Explicitly specifies which token to inject.
- * Useful for interfaces or when automatic detection fails.
- */
-export declare function Inject(token: Token): ParameterDecorator;

package/src/decorators/Middleware.d.ts

@@ -1,5 +0,0 @@
-/**
- * Middleware decorator.
- * Can be applied to controllers or individual methods.
- */
-export declare function Use(...middlewares: Function[]): ClassDecorator & MethodDecorator;

package/src/decorators/Service.d.ts

@@ -1,9 +0,0 @@
-import { Scope } from '../container/Container';
-export interface ServiceOptions {
-    scope?: Scope;
-}
-/**
- * Marks a class as an injectable service.
- * Services are singleton by default.
- */
-export declare function Service(options?: ServiceOptions): ClassDecorator;

package/src/decorators/methods.d.ts

@@ -1,7 +0,0 @@
-export declare const Get: (path?: string) => any;
-export declare const Post: (path?: string) => any;
-export declare const Put: (path?: string) => any;
-export declare const Delete: (path?: string) => any;
-export declare const Patch: (path?: string) => any;
-export declare const Head: (path?: string) => any;
-export declare const Options: (path?: string) => any;

package/src/decorators/params.d.ts

@@ -1,13 +0,0 @@
-export type ParamType = 'param' | 'query' | 'body' | 'header' | 'req' | 'ctx' | 'locals';
-export interface ParamMetadata {
-    type: ParamType;
-    key?: string;
-    index: number;
-}
-export declare function Param(key?: string): ParameterDecorator;
-export declare function Query(key?: string): ParameterDecorator;
-export declare function Body(key?: string): ParameterDecorator;
-export declare function Header(key?: string): ParameterDecorator;
-export declare function Req(): ParameterDecorator;
-export declare function Ctx(): ParameterDecorator;
-export declare function Locals(key?: string): ParameterDecorator;

package/src/events/Lifecycle.d.ts

@@ -1,54 +0,0 @@
-/**
- * Lifecycle Event Types.
- */
-export declare enum EventType {
-    /** Called when DI container initializes, before server starts */
-    INIT = "onInit",
-    /** Called right after application is fully bootstrapped */
-    BOOT = "onBoot",
-    /** Called when application receives SIGTERM/SIGINT */
-    SHUTDOWN = "onShutdown"
-}
-/**
- * Stored event handler info.
- */
-export interface EventHandler {
-    target: any;
-    methodName: string;
-    priority: number;
-}
-/**
- * Metadata key for storing events.
- */
-export declare const EVENTS_META: unique symbol;
-/**
- * Register an event handler (called by decorators).
- */
-export declare function registerEvent(type: EventType, target: any, methodName: string, priority?: number): void;
-/**
- * Get all handlers for an event type, sorted by priority (descending).
- */
-export declare function getEventHandlers(type: EventType): EventHandler[];
-/**
- * Check if any handlers exist for an event type.
- */
-export declare function hasEventHandlers(type: EventType): boolean;
-/**
- * Clear all event handlers (for testing).
- */
-export declare function clearEventRegistry(): void;
-/**
- * Called when DI container initializes, before the server starts.
- * Use for database connections, cache warming, etc.
- */
-export declare function OnApplicationInit(priority?: number): (target: any, propertyKey: string) => void;
-/**
- * Called right after the application is fully bootstrapped and server is ready.
- * Use for logging, health checks, etc.
- */
-export declare function OnApplicationBoot(priority?: number): (target: any, propertyKey: string) => void;
-/**
- * Called when application receives SIGTERM or SIGINT.
- * Use for graceful cleanup, closing connections, etc.
- */
-export declare function OnApplicationShutdown(priority?: number): (target: any, propertyKey: string) => void;

package/src/exceptions/HttpException.d.ts

@@ -1,43 +0,0 @@
-/**
- * Base HTTP Exception class.
- * Throw this from handlers to return custom HTTP error responses.
- */
-export declare class HttpException extends Error {
-    readonly statusCode: number;
-    readonly errors?: any[];
-    constructor(statusCode: number, message: string, errors?: any[]);
-    /**
-     * Convert exception to Response.
-     */
-    toResponse(): Response;
-}
-export declare class BadRequestException extends HttpException {
-    constructor(message?: string, errors?: any[]);
-}
-export declare class UnauthorizedException extends HttpException {
-    constructor(message?: string);
-}
-export declare class ForbiddenException extends HttpException {
-    constructor(message?: string);
-}
-export declare class NotFoundException extends HttpException {
-    constructor(message?: string);
-}
-export declare class MethodNotAllowedException extends HttpException {
-    constructor(message?: string);
-}
-export declare class ConflictException extends HttpException {
-    constructor(message?: string);
-}
-export declare class UnprocessableEntityException extends HttpException {
-    constructor(message?: string, errors?: any[]);
-}
-export declare class TooManyRequestsException extends HttpException {
-    constructor(message?: string);
-}
-export declare class InternalServerErrorException extends HttpException {
-    constructor(message?: string);
-}
-export declare class ServiceUnavailableException extends HttpException {
-    constructor(message?: string);
-}

package/src/index.d.ts

@@ -1,42 +0,0 @@
-/**
- * Carno - Ultra-Fast HTTP Framework
- *
- * Design principles:
- * 1. ZERO abstraction at runtime - everything compiled at startup
- * 2. Direct Bun.serve() with native routes
- * 3. JIT compiled handlers with AOT async detection
- * 4. No intermediate layers in hot path
- * 5. Radix tree router for dynamic routes
- */
-import 'reflect-metadata';
-export { Carno } from './Carno';
-export type { MiddlewareHandler, CarnoConfig } from './Carno';
-export { Context } from './context/Context';
-export { Controller } from './decorators/Controller';
-export type { ControllerOptions } from './metadata';
-export { Get, Post, Put, Delete, Patch, Head, Options } from './decorators/methods';
-export { Param, Query, Body, Header, Req, Ctx, Locals } from './decorators/params';
-export { Use, Use as Middleware } from './decorators/Middleware';
-export type { CarnoMiddleware, CarnoClosure } from './middleware/CarnoMiddleware';
-export { Service } from './decorators/Service';
-export { Inject } from './decorators/Inject';
-export { Container, Scope } from './container/Container';
-export type { Token, ProviderConfig } from './container/Container';
-export { RadixRouter } from './router/RadixRouter';
-export type { RouteMatch } from './router/RadixRouter';
-export { CorsHandler } from './cors/CorsHandler';
-export type { CorsConfig, CorsOrigin } from './cors/CorsHandler';
-export type { ValidatorAdapter, ValidationResult, ValidationError, ValidationConfig } from './validation/ValidatorAdapter';
-export { Schema, getSchema, VALIDATION_SCHEMA } from './validation/ValidatorAdapter';
-export { ZodAdapter, ValidationException } from './validation/ZodAdapter';
-export { ValibotAdapter } from './validation/ValibotAdapter';
-export { HttpException, BadRequestException, UnauthorizedException, ForbiddenException, NotFoundException, MethodNotAllowedException, ConflictException, UnprocessableEntityException, TooManyRequestsException, InternalServerErrorException, ServiceUnavailableException } from './exceptions/HttpException';
-export { EventType, OnApplicationInit, OnApplicationBoot, OnApplicationShutdown } from './events/Lifecycle';
-export { CacheService } from './cache/CacheService';
-export { MemoryDriver } from './cache/MemoryDriver';
-export { RedisDriver } from './cache/RedisDriver';
-export type { RedisConfig } from './cache/RedisDriver';
-export type { CacheDriver, CacheConfig } from './cache/CacheDriver';
-export { createTestHarness, withTestApp } from './testing/TestHarness';
-export type { TestHarness, TestOptions } from './testing/TestHarness';
-export { Metadata, isObject, isString } from './utils/Metadata';

package/src/metadata.d.ts

@@ -1,41 +0,0 @@
-import { Scope } from './container/Container';
-/**
- * Controller options for the @Controller decorator.
- */
-export interface ControllerOptions {
-    path?: string;
-    scope?: Scope;
-    children?: any[];
-}
-/**
- * Controller metadata stored on controller classes.
- */
-export interface ControllerMeta {
-    path: string;
-    scope?: Scope;
-    children?: any[];
-}
-/**
- * Route metadata stored on controllers.
- */
-export interface RouteInfo {
-    method: 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head' | 'options';
-    path: string;
-    handlerName: string;
-}
-/**
- * Middleware metadata.
- */
-export interface MiddlewareInfo {
-    handler: Function;
-    target?: string;
-}
-/**
- * Metadata keys.
- */
-export declare const CONTROLLER_META: unique symbol;
-export declare const ROUTES_META: unique symbol;
-export declare const PARAMS_META: unique symbol;
-export declare const MIDDLEWARE_META: unique symbol;
-export declare const SERVICE_META: unique symbol;
-export declare const INJECT_META: unique symbol;

package/src/middleware/CarnoMiddleware.d.ts

@@ -1,12 +0,0 @@
-import type { Context } from '../context/Context';
-/**
- * Closure function to call the next middleware in the chain.
- */
-export type CarnoClosure = () => void | Promise<void>;
-/**
- * Interface for onion-style middleware.
- * Middleware must call next() to continue the chain.
- */
-export interface CarnoMiddleware {
-    handle(ctx: Context, next: CarnoClosure): void | Promise<void>;
-}

package/src/router/RadixRouter.d.ts

@@ -1,19 +0,0 @@
-/**
- * Ultra-fast Radix Router for Turbo.
- *
- * Optimizations:
- * - Char code comparisons (no string allocations)
- * - Frozen empty params object
- * - O(1) method lookup via char code index
- * - Minimal allocations in hot path
- */
-export interface RouteMatch<T> {
-    store: T;
-    params: Record<string, string>;
-}
-export declare class RadixRouter<T> {
-    private roots;
-    add(method: string, path: string, store: T): void;
-    find(method: string, path: string): RouteMatch<T> | null;
-    private matchPath;
-}

package/src/testing/TestHarness.d.ts

@@ -1,71 +0,0 @@
-import type { Server } from 'bun';
-import { Carno, type CarnoConfig } from '../Carno';
-import { Container, type Token } from '../container/Container';
-/**
- * Test configuration options.
- */
-export interface TestOptions {
-    config?: CarnoConfig;
-    listen?: boolean | number;
-    port?: number;
-    controllers?: (new (...args: any[]) => any)[];
-    services?: (Token | any)[];
-    plugins?: Carno[];
-}
-/**
- * Test harness - provides utilities for testing Carno applications.
- */
-export interface TestHarness {
-    /** The Carno app instance */
-    app: Carno;
-    /** The internal DI container */
-    container: Container;
-    /** The HTTP server (if listening) */
-    server?: Server<any>;
-    /** The port the server is running on */
-    port?: number;
-    /** Resolve a service from the container */
-    resolve<T>(token: Token<T>): T;
-    /** Make an HTTP request to the app */
-    request(path: string, init?: RequestInit): Promise<Response>;
-    /** Make a GET request */
-    get(path: string, init?: Omit<RequestInit, 'method'>): Promise<Response>;
-    /** Make a POST request */
-    post(path: string, body?: any, init?: Omit<RequestInit, 'method' | 'body'>): Promise<Response>;
-    /** Make a PUT request */
-    put(path: string, body?: any, init?: Omit<RequestInit, 'method' | 'body'>): Promise<Response>;
-    /** Make a DELETE request */
-    delete(path: string, init?: Omit<RequestInit, 'method'>): Promise<Response>;
-    /** Close the test harness and cleanup */
-    close(): Promise<void>;
-}
-/**
- * Create a test harness for Turbo applications.
- *
- * @example
- * ```typescript
- * const harness = await createTestHarness({
- *   controllers: [UserController],
- *   services: [UserService],
- *   listen: true
- * });
- *
- * const response = await harness.get('/users');
- * expect(response.status).toBe(200);
- *
- * await harness.close();
- * ```
- */
-export declare function createTestHarness(options?: TestOptions): Promise<TestHarness>;
-/**
- * Run a test routine with automatic harness cleanup.
- *
- * @example
- * ```typescript
- * await withTestApp(async (harness) => {
- *   const response = await harness.get('/health');
- *   expect(response.status).toBe(200);
- * }, { controllers: [HealthController], listen: true });
- * ```
- */
-export declare function withTestApp(routine: (harness: TestHarness) => Promise<void>, options?: TestOptions): Promise<void>;

package/src/utils/Metadata.d.ts

@@ -1,20 +0,0 @@
-/**
- * Utility class for handling metadata operations.
- * Wraps Reflect.getMetadata and Reflect.defineMetadata.
- */
-export declare class Metadata {
-    static get<T = any>(key: string | symbol, target: any): T | undefined;
-    static set(key: string | symbol, value: any, target: any): void;
-    static has(key: string | symbol, target: any): boolean;
-    static delete(key: string | symbol, target: any): boolean;
-    static keys(target: any): (string | symbol)[];
-    static getType(target: any, propertyKey: string | symbol): any;
-}
-/**
- * Type guard for checking if value is an object.
- */
-export declare function isObject(value: unknown): value is Record<string, any>;
-/**
- * Type guard for checking if value is a string.
- */
-export declare function isString(value: unknown): value is string;

package/src/utils/parseQuery.d.ts

@@ -1,23 +0,0 @@
-/**
- * High-performance query string parser.
- *
- * Based on Elysia's approach - uses manual string parsing with charCodeAt()
- * instead of new URL() for significant performance gains.
- *
- * Benchmark: ~10x faster than new URL().searchParams
- */
-/**
- * Parse query string from a full URL.
- * Extracts the query portion and parses key-value pairs.
- *
- * @param url Full URL string (e.g., "http://localhost/path?foo=bar&baz=123")
- * @returns Record<string, string> - parsed query parameters
- */
-export declare function parseQueryFromURL(url: string): Record<string, string>;
-/**
- * Parse query string directly.
- *
- * @param input Query string without leading '?' (e.g., "foo=bar&baz=123")
- * @returns Record<string, string> - parsed query parameters
- */
-export declare function parseQueryString(input: string): Record<string, string>;

package/src/validation/ValibotAdapter.d.ts

@@ -1,30 +0,0 @@
-import type { ValidatorAdapter, ValidationResult } from './ValidatorAdapter';
-/**
- * Valibot Adapter for Turbo validation.
- *
- * Usage:
- * ```typescript
- * import * as v from 'valibot';
- *
- * @Schema(v.object({
- *   name: v.pipe(v.string(), v.minLength(1)),
- *   email: v.pipe(v.string(), v.email())
- * }))
- * class CreateUserDto {
- *   name: string;
- *   email: string;
- * }
- * ```
- */
-export declare class ValibotAdapter implements ValidatorAdapter {
-    readonly name = "ValibotAdapter";
-    private schemaCache;
-    private valibot;
-    constructor();
-    private ensureValibot;
-    hasValidation(target: any): boolean;
-    validate<T>(target: any, value: unknown): ValidationResult<T>;
-    validateOrThrow<T>(target: any, value: unknown): T;
-    private getOrCacheSchema;
-    private formatErrors;
-}

package/src/validation/ValidatorAdapter.d.ts

@@ -1,54 +0,0 @@
-/**
- * Validation result type.
- */
-export interface ValidationResult<T = any> {
-    success: boolean;
-    data?: T;
-    errors?: ValidationError[];
-}
-export interface ValidationError {
-    path: string;
-    message: string;
-}
-/**
- * Base interface for validation adapters.
- * Adapters provide validation capabilities for different libraries.
- */
-export interface ValidatorAdapter {
-    /**
-     * Validator name for debugging.
-     */
-    readonly name: string;
-    /**
-     * Check if a target has validation schema.
-     */
-    hasValidation(target: any): boolean;
-    /**
-     * Validate and transform a value.
-     * Returns result object instead of throwing for better performance.
-     */
-    validate<T>(target: any, value: unknown): ValidationResult<T>;
-    /**
-     * Validate and transform, throwing on error.
-     * Used when you want to short-circuit on failure.
-     */
-    validateOrThrow<T>(target: any, value: unknown): T;
-}
-/**
- * Validation configuration for Turbo.
- */
-export interface ValidationConfig {
-    adapter: ValidatorAdapter;
-}
-/**
- * Symbol for storing validation schema on DTOs.
- */
-export declare const VALIDATION_SCHEMA: unique symbol;
-/**
- * Decorator to attach a validation schema to a DTO class.
- */
-export declare function Schema(schema: any): ClassDecorator;
-/**
- * Get the validation schema from a DTO class.
- */
-export declare function getSchema(target: any): any | undefined;

package/src/validation/ZodAdapter.d.ts

@@ -1,35 +0,0 @@
-import type { ValidatorAdapter, ValidationResult, ValidationError } from './ValidatorAdapter';
-/**
- * Zod Adapter - Default validation adapter for Turbo.
- *
- * Usage:
- * ```typescript
- * import { z } from 'zod';
- *
- * @Schema(z.object({
- *   name: z.string().min(1),
- *   email: z.string().email()
- * }))
- * class CreateUserDto {
- *   name: string;
- *   email: string;
- * }
- * ```
- */
-export declare class ZodAdapter implements ValidatorAdapter {
-    readonly name = "ZodAdapter";
-    private schemaCache;
-    hasValidation(target: any): boolean;
-    validate<T>(target: any, value: unknown): ValidationResult<T>;
-    validateOrThrow<T>(target: any, value: unknown): T;
-    private getOrCacheSchema;
-    private formatErrors;
-}
-/**
- * Validation exception thrown when validation fails.
- */
-export declare class ValidationException extends Error {
-    readonly errors: ValidationError[];
-    constructor(errors: ValidationError[]);
-    toResponse(): Response;
-}