@carno.js/core 1.1.0 → 1.1.2

package/dist/index.d.mjs

@@ -1,78 +0,0 @@
-import "reflect-metadata";
-import { Carno } from "./Carno.mjs";
-import { Context } from "./context/Context.mjs";
-import { Controller } from "./decorators/Controller.mjs";
-import { Get, Post, Put, Delete, Patch, Head, Options } from "./decorators/methods.mjs";
-import { Param, Query, Body, Header, Req, Ctx, Locals } from "./decorators/params.mjs";
-import { Use, Use as Use2 } from "./decorators/Middleware.mjs";
-import { Service } from "./decorators/Service.mjs";
-import { Inject } from "./decorators/Inject.mjs";
-import { Container, Scope } from "./container/Container.mjs";
-import { RadixRouter } from "./router/RadixRouter.mjs";
-import { CorsHandler } from "./cors/CorsHandler.mjs";
-import { Schema, getSchema, VALIDATION_SCHEMA } from "./validation/ValidatorAdapter.mjs";
-import { ZodAdapter, ValidationException } from "./validation/ZodAdapter.mjs";
-import { ValibotAdapter } from "./validation/ValibotAdapter.mjs";
-import { HttpException, BadRequestException, UnauthorizedException, ForbiddenException, NotFoundException, MethodNotAllowedException, ConflictException, UnprocessableEntityException, TooManyRequestsException, InternalServerErrorException, ServiceUnavailableException } from "./exceptions/HttpException.mjs";
-import { EventType, OnApplicationInit, OnApplicationBoot, OnApplicationShutdown } from "./events/Lifecycle.mjs";
-import { CacheService } from "./cache/CacheService.mjs";
-import { MemoryDriver } from "./cache/MemoryDriver.mjs";
-import { RedisDriver } from "./cache/RedisDriver.mjs";
-import { createTestHarness, withTestApp } from "./testing/TestHarness.mjs";
-import { Metadata, isObject, isString } from "./utils/Metadata.mjs";
-export {
-  BadRequestException,
-  Body,
-  CacheService,
-  Carno,
-  ConflictException,
-  Container,
-  Context,
-  Controller,
-  CorsHandler,
-  Ctx,
-  Delete,
-  EventType,
-  ForbiddenException,
-  Get,
-  Head,
-  Header,
-  HttpException,
-  Inject,
-  InternalServerErrorException,
-  Locals,
-  MemoryDriver,
-  Metadata,
-  MethodNotAllowedException,
-  Use2 as Middleware,
-  NotFoundException,
-  OnApplicationBoot,
-  OnApplicationInit,
-  OnApplicationShutdown,
-  Options,
-  Param,
-  Patch,
-  Post,
-  Put,
-  Query,
-  RadixRouter,
-  RedisDriver,
-  Req,
-  Schema,
-  Scope,
-  Service,
-  ServiceUnavailableException,
-  TooManyRequestsException,
-  UnauthorizedException,
-  UnprocessableEntityException,
-  Use,
-  VALIDATION_SCHEMA,
-  ValibotAdapter,
-  ValidationException,
-  ZodAdapter,
-  createTestHarness,
-  getSchema,
-  isObject,
-  isString,
-  withTestApp
-};

package/dist/metadata.d.js

@@ -1,13 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from == "object" || typeof from == "function")
-    for (let key of __getOwnPropNames(from))
-      !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: !0 }), mod);
-var metadata_d_exports = {};
-module.exports = __toCommonJS(metadata_d_exports);

package/dist/middleware/CarnoMiddleware.d.js

@@ -1,13 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from == "object" || typeof from == "function")
-    for (let key of __getOwnPropNames(from))
-      !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: !0 }), mod);
-var CarnoMiddleware_d_exports = {};
-module.exports = __toCommonJS(CarnoMiddleware_d_exports);

package/dist/router/RadixRouter.d.js

@@ -1,13 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from == "object" || typeof from == "function")
-    for (let key of __getOwnPropNames(from))
-      !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: !0 }), mod);
-var RadixRouter_d_exports = {};
-module.exports = __toCommonJS(RadixRouter_d_exports);

package/dist/testing/TestHarness.d.js

@@ -1,13 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from == "object" || typeof from == "function")
-    for (let key of __getOwnPropNames(from))
-      !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: !0 }), mod);
-var TestHarness_d_exports = {};
-module.exports = __toCommonJS(TestHarness_d_exports);

package/dist/utils/Metadata.d.js

@@ -1,13 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from == "object" || typeof from == "function")
-    for (let key of __getOwnPropNames(from))
-      !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: !0 }), mod);
-var Metadata_d_exports = {};
-module.exports = __toCommonJS(Metadata_d_exports);

package/dist/utils/parseQuery.d.js

@@ -1,13 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from == "object" || typeof from == "function")
-    for (let key of __getOwnPropNames(from))
-      !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: !0 }), mod);
-var parseQuery_d_exports = {};
-module.exports = __toCommonJS(parseQuery_d_exports);

package/dist/validation/ValibotAdapter.d.js

@@ -1,13 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from == "object" || typeof from == "function")
-    for (let key of __getOwnPropNames(from))
-      !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: !0 }), mod);
-var ValibotAdapter_d_exports = {};
-module.exports = __toCommonJS(ValibotAdapter_d_exports);

package/dist/validation/ValidatorAdapter.d.js

@@ -1,13 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from == "object" || typeof from == "function")
-    for (let key of __getOwnPropNames(from))
-      !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: !0 }), mod);
-var ValidatorAdapter_d_exports = {};
-module.exports = __toCommonJS(ValidatorAdapter_d_exports);

package/dist/validation/ZodAdapter.d.js

@@ -1,13 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from == "object" || typeof from == "function")
-    for (let key of __getOwnPropNames(from))
-      !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: !0 }), mod);
-var ZodAdapter_d_exports = {};
-module.exports = __toCommonJS(ZodAdapter_d_exports);

package/src/Carno.d.ts

@@ -1,135 +0,0 @@
-import 'reflect-metadata';
-import { Context } from './context/Context';
-import type { Token, ProviderConfig } from './container/Container';
-import { type CorsConfig } from './cors/CorsHandler';
-import type { ValidatorAdapter } from './validation/ValidatorAdapter';
-import type { CacheConfig } from './cache/CacheDriver';
-export type MiddlewareHandler = (ctx: Context) => Response | void | Promise<Response | void>;
-/**
- * Carno plugin configuration.
- */
-export interface CarnoConfig {
-    exports?: (Token | ProviderConfig)[];
-    globalMiddlewares?: MiddlewareHandler[];
-    disableStartupLog?: boolean;
-    cors?: CorsConfig;
-    validation?: ValidatorAdapter | boolean | (new (...args: any[]) => ValidatorAdapter);
-    cache?: CacheConfig | boolean;
-}
-/**
- * Carno Application - Ultra-aggressive performance.
- *
- * ZERO runtime work in hot path:
- * - All responses pre-created at startup
- * - Direct Bun native routes - no fetch fallback needed
- * - No function calls in hot path
- */
-export declare class Carno {
-    config: CarnoConfig;
-    private _controllers;
-    private _services;
-    private _middlewares;
-    private routes;
-    private container;
-    private corsHandler;
-    private hasCors;
-    private validator;
-    private server;
-    private hasInitHooks;
-    private hasBootHooks;
-    private hasShutdownHooks;
-    constructor(config?: CarnoConfig);
-    /**
-     * Use a Carno plugin.
-     * Imports controllers, services, middlewares, and routes from another Carno instance.
-     */
-    use(plugin: Carno): this;
-    private findServiceInPlugin;
-    private getServiceToken;
-    private shouldCloneService;
-    /**
-     * Register one or more services/providers.
-     */
-    services(serviceClass: Token | ProviderConfig | (Token | ProviderConfig)[]): this;
-    /**
-     * Register one or more global middlewares.
-     */
-    middlewares(handler: MiddlewareHandler | MiddlewareHandler[]): this;
-    /**
-     * Register one or more controllers.
-     */
-    controllers(controllerClass: (new (...args: any[]) => any) | (new (...args: any[]) => any)[]): this;
-    /**
-     * Register a route programmatically.
-     * Useful for plugins that need to register routes without controllers.
-     *
-     * @example
-     * ```ts
-     * app.route('GET', '/health', () => ({ status: 'ok' }));
-     * app.route('POST', '/webhook', async (ctx) => {
-     *   const data = await ctx.parseBody();
-     *   return { received: true };
-     * });
-     * ```
-     */
-    route(method: string, path: string, handler: Response | Function): this;
-    /**
-     * Bulk register multiple routes at once.
-     *
-     * @example
-     * ```ts
-     * app.addRoutes({
-     *   '/api/users': {
-     *     'GET': () => ({ users: [] }),
-     *     'POST': (ctx) => ({ created: true })
-     *   },
-     *   '/api/health': {
-     *     'GET': () => ({ status: 'ok' })
-     *   }
-     * });
-     * ```
-     */
-    addRoutes(routes: Record<string, Record<string, Response | Function>>): this;
-    /**
-     * Get a service instance from the container.
-     */
-    get<T>(token: Token<T>): T;
-    listen(port?: number): void;
-    private bootstrap;
-    private compileRoutes;
-    private compileController;
-    /**
-     * Register a route with Bun's native router format.
-     * Path: "/users/:id", Method: "GET", Handler: Function or Response
-     */
-    private registerRoute;
-    private createStaticResponse;
-    private createHandler;
-    private resolveMiddleware;
-    /**
-     * Apply CORS headers to a response.
-     */
-    private applyCors;
-    /**
-     * Fallback handler - only called for unmatched routes.
-     * All matched routes go through Bun's native router.
-     */
-    private handleNotFound;
-    private buildResponse;
-    private normalizePath;
-    private hasParams;
-    stop(): void;
-    /**
-     * Error handler for Bun.serve.
-     * Converts exceptions to proper HTTP responses.
-     */
-    private handleError;
-    /**
-     * Execute lifecycle hooks for a specific event type.
-     */
-    private executeLifecycleHooks;
-    /**
-     * Register SIGTERM/SIGINT handlers for graceful shutdown.
-     */
-    private registerShutdownHandlers;
-}

package/src/DefaultRoutes.d.ts

@@ -1,19 +0,0 @@
-/**
- * Default routes controller.
- * Auto-registered by Turbo for common endpoints.
- */
-export declare class DefaultRoutes {
-    /**
-     * Favicon - returns empty response to prevent 404.
-     */
-    favicon(): Response;
-}
-/**
- * Pre-compiled static responses for maximum performance.
- * Use these directly in Bun.serve static routes.
- */
-export declare const DEFAULT_STATIC_ROUTES: {
-    '/health': Response;
-    '/ready': Response;
-    '/favicon.ico': Response;
-};

package/src/cache/CacheDriver.d.ts

@@ -1,43 +0,0 @@
-/**
- * Cache Driver Interface.
- * Implement this to add new cache backends (Redis, Memcached, etc.)
- */
-export interface CacheDriver {
-    /**
-     * Driver name for debugging.
-     */
-    readonly name: string;
-    /**
-     * Get a value from cache.
-     */
-    get<T>(key: string): Promise<T | null>;
-    /**
-     * Set a value in cache.
-     * @param ttl Time to live in seconds (optional)
-     */
-    set<T>(key: string, value: T, ttl?: number): Promise<boolean>;
-    /**
-     * Delete a value from cache.
-     */
-    del(key: string): Promise<boolean>;
-    /**
-     * Check if key exists.
-     */
-    has(key: string): Promise<boolean>;
-    /**
-     * Clear all cached values.
-     */
-    clear(): Promise<void>;
-    /**
-     * Close connection (for Redis, etc.)
-     */
-    close?(): Promise<void>;
-}
-/**
- * Cache configuration.
- */
-export interface CacheConfig {
-    driver?: CacheDriver;
-    prefix?: string;
-    defaultTtl?: number;
-}

package/src/cache/CacheService.d.ts

@@ -1,89 +0,0 @@
-import type { CacheDriver, CacheConfig } from './CacheDriver';
-/**
- * CacheService - High-performance caching with driver pattern.
- *
- * Features:
- * - In-memory (default) or Redis backend
- * - getOrSet for cache-aside pattern
- * - Key prefixing for namespacing
- * - Configurable default TTL
- *
- * Usage:
- * ```typescript
- * const cache = new CacheService();
- *
- * // Basic operations
- * await cache.set('user:123', { name: 'John' }, 3600);
- * const user = await cache.get<User>('user:123');
- *
- * // Cache-aside pattern
- * const user = await cache.getOrSet('user:123',
- *   async () => db.findUser(123),
- *   3600
- * );
- * ```
- */
-export declare class CacheService {
-    private driver;
-    private prefix;
-    private defaultTtl;
-    constructor(config?: CacheConfig);
-    /**
-     * Get the full key with prefix.
-     */
-    private key;
-    /**
-     * Get a value from cache.
-     */
-    get<T>(key: string): Promise<T | null>;
-    /**
-     * Set a value in cache.
-     * @param ttl Time to live in seconds
-     */
-    set<T>(key: string, value: T, ttl?: number): Promise<boolean>;
-    /**
-     * Delete a value from cache.
-     */
-    del(key: string): Promise<boolean>;
-    /**
-     * Check if key exists.
-     */
-    has(key: string): Promise<boolean>;
-    /**
-     * Clear all cached values.
-     */
-    clear(): Promise<void>;
-    /**
-     * Get value from cache or compute and store it.
-     * This is the cache-aside pattern - most commonly used method.
-     *
-     * @param key Cache key
-     * @param cb Callback to compute value if not cached
-     * @param ttl Time to live in seconds
-     */
-    getOrSet<T>(key: string, cb: () => Promise<T>, ttl?: number): Promise<T>;
-    /**
-     * Get multiple values at once.
-     */
-    getMany<T>(keys: string[]): Promise<(T | null)[]>;
-    /**
-     * Set multiple values at once.
-     */
-    setMany<T>(entries: Array<{
-        key: string;
-        value: T;
-        ttl?: number;
-    }>): Promise<boolean[]>;
-    /**
-     * Delete multiple values at once.
-     */
-    delMany(keys: string[]): Promise<boolean[]>;
-    /**
-     * Close the cache driver connection.
-     */
-    close(): Promise<void>;
-    /**
-     * Get the underlying driver (for advanced use).
-     */
-    getDriver(): CacheDriver;
-}

package/src/cache/MemoryDriver.d.ts

@@ -1,32 +0,0 @@
-import type { CacheDriver } from './CacheDriver';
-/**
- * In-Memory Cache Driver.
- * Ultra-fast, perfect for single-instance applications.
- *
- * Features:
- * - O(1) get/set/del operations
- * - Lazy expiration (checked on access)
- * - Periodic cleanup of expired entries
- */
-export declare class MemoryDriver implements CacheDriver {
-    readonly name = "MemoryDriver";
-    private cache;
-    private cleanupInterval;
-    constructor(cleanupIntervalMs?: number);
-    get<T>(key: string): Promise<T | null>;
-    set<T>(key: string, value: T, ttl?: number): Promise<boolean>;
-    del(key: string): Promise<boolean>;
-    has(key: string): Promise<boolean>;
-    clear(): Promise<void>;
-    close(): Promise<void>;
-    /**
-     * Remove expired entries.
-     */
-    private cleanup;
-    /**
-     * Get cache stats (for debugging).
-     */
-    stats(): {
-        size: number;
-    };
-}

package/src/cache/RedisDriver.d.ts

@@ -1,34 +0,0 @@
-import type { CacheDriver } from './CacheDriver';
-/**
- * Redis Cache Driver Configuration.
- */
-export interface RedisConfig {
-    host?: string;
-    port?: number;
-    password?: string;
-    db?: number;
-    url?: string;
-}
-/**
- * Redis Cache Driver.
- * For distributed caching in multi-instance deployments.
- *
- * Uses Bun's native Redis client for maximum performance.
- */
-export declare class RedisDriver implements CacheDriver {
-    private config;
-    readonly name = "RedisDriver";
-    private client;
-    private connected;
-    constructor(config?: RedisConfig);
-    /**
-     * Connect to Redis (lazy - connects on first use).
-     */
-    private ensureConnected;
-    get<T>(key: string): Promise<T | null>;
-    set<T>(key: string, value: T, ttl?: number): Promise<boolean>;
-    del(key: string): Promise<boolean>;
-    has(key: string): Promise<boolean>;
-    clear(): Promise<void>;
-    close(): Promise<void>;
-}

package/src/compiler/JITCompiler.d.ts

@@ -1,36 +0,0 @@
-/**
- * JIT Compiler for Turbo.
- *
- * Aggressive AOT optimizations:
- * - Detects async at compile time (not runtime)
- * - Generates specialized handlers via new Function()
- * - Inlines parameter access
- * - Zero overhead for simple handlers
- */
-import type { ParamType } from '../decorators/params';
-export interface ParamInfo {
-    type: ParamType;
-    key?: string;
-    index: number;
-}
-export interface CompiledHandler {
-    fn: Function;
-    isAsync: boolean;
-    isStatic: boolean;
-    staticValue?: any;
-}
-/**
- * Detects if function is async at compile time.
- * Checks: async keyword, await usage, generators, .then()
- */
-export declare function isAsyncFunction(fn: Function): boolean;
-/**
- * Detects if handler returns a static value.
- * Static handlers can be pre-computed at startup.
- */
-export declare function isStaticHandler(fn: Function): boolean;
-/**
- * Compiles handler with inlined parameter access.
- * Uses new Function() for maximum V8 optimization.
- */
-export declare function compileHandler(instance: any, methodName: string, params: ParamInfo[]): CompiledHandler;

package/src/container/Container.d.ts

@@ -1,38 +0,0 @@
-/**
- * Lightweight DI Container for Turbo.
- *
- * Features:
- * - Constructor injection via reflect-metadata
- * - Singleton scope by default
- * - Request scope support
- * - Lazy instantiation
- */
-export type Token<T = any> = new (...args: any[]) => T;
-export declare enum Scope {
-    SINGLETON = "singleton",// Always the same instance
-    REQUEST = "request",// New instance per request
-    INSTANCE = "instance"
-}
-export interface ProviderConfig<T = any> {
-    token: Token<T>;
-    useClass?: Token<T>;
-    useValue?: T;
-    scope?: Scope;
-}
-export declare class Container {
-    private configs;
-    private instances;
-    private resolving;
-    register<T>(config: ProviderConfig<T> | Token<T>): this;
-    get<T>(token: Token<T>): T;
-    has(token: Token): boolean;
-    /**
-     * Resolves a token to return instance and its effective scope.
-     */
-    private resolveInternal;
-    private createInstance;
-    private getDependencies;
-    private isPrimitive;
-    private normalizeConfig;
-    clear(): void;
-}