@kabyeon/nexusjs 0.6.5

package/dist/core/di/tokens.d.ts

@@ -0,0 +1,98 @@
+/**
+ * DI Token system.
+ *
+ * A token identifies a provider that can be injected. Tokens are either:
+ * - A class (constructor function)
+ * - A string (string token, for non-class providers like config values)
+ * - A Symbol
+ *
+ * Classes are the most common form: they identify both the implementation
+ * (instantiated by the container) and the abstract type to request.
+ */
+import type { HttpMethod } from "../constants.js";
+export type { HttpMethod } from "../constants.js";
+export type InjectionToken<T = unknown> = (abstract new (...args: any[]) => T) | (new (...args: any[]) => T) | string | symbol;
+export interface Type<T = any> {
+    new (...args: any[]): T;
+}
+export interface AbstractType<T = any> {
+    prototype: T;
+}
+/** Narrow token type for runtime use. */
+export type ProviderToken<T = unknown> = InjectionToken<T>;
+/** Optional injection token; undefined means "no token provided". */
+export type OptionalFactoryDependency = {
+    token: InjectionToken<any>;
+    optional: boolean;
+};
+/**
+ * Provider definitions. A provider tells the container how to build
+ * an instance for a given token.
+ */
+export interface ClassProvider<T = any> {
+    provide: InjectionToken<T>;
+    useClass: Type<T>;
+    scope?: ProviderScope;
+}
+export interface ValueProvider<T = any> {
+    provide: InjectionToken<T>;
+    useValue: T;
+    scope?: ProviderScope;
+}
+export interface FactoryProvider<T = any> {
+    provide: InjectionToken<T>;
+    useFactory: (...args: any[]) => T | Promise<T>;
+    inject?: Array<InjectionToken<any> | OptionalFactoryDependency>;
+    scope?: ProviderScope;
+}
+export interface ExistingProvider<T = any> {
+    provide: InjectionToken<T>;
+    useExisting: InjectionToken<any>;
+    scope?: ProviderScope;
+}
+export type Provider<T = any> = Type<T> | ClassProvider<T> | ValueProvider<T> | FactoryProvider<T> | ExistingProvider<T>;
+/**
+ * Provider lifecycle scope.
+ * - singleton: one instance per container (default).
+ * - request: a new instance per HTTP request.
+ * - transient: a new instance on every injection.
+ */
+export type ProviderScope = "singleton" | "request" | "transient";
+/** Module configuration options. */
+export interface ModuleOptions {
+    controllers?: Type[];
+    providers?: Provider[];
+    imports?: Type[];
+    exports?: InjectionToken[];
+}
+/** Decorator metadata shape for @Module. */
+export interface ModuleMetadata extends ModuleOptions {
+}
+/** Decorator metadata shape for @Controller. */
+export interface ControllerMetadata {
+    prefix: string;
+}
+/** Parameter descriptor produced by parameter decorators. */
+export interface ParamMetadata {
+    index: number;
+    type: number;
+    name?: string;
+    data?: Record<string, any>;
+}
+/** Validation metadata for a route handler. */
+export interface ValidationMetadata {
+    body?: any;
+    query?: any;
+    params?: any;
+    headers?: any;
+}
+/** Route handler metadata. */
+export interface RouteMetadata {
+    method: HttpMethod;
+    path: string;
+    propertyKey: string | symbol;
+    handler: (...args: any[]) => any;
+    validation?: ValidationMetadata;
+    middlewares?: Array<(c: any, next: any) => Promise<any> | any>;
+}
+//# sourceMappingURL=tokens.d.ts.map

package/dist/core/di/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/core/di/tokens.ts"],"names":[],"mappings":"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"}

package/dist/core/http/context.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Framework context types.
+ *
+ * The HTTP layer is built on Hono, so the request handler receives a
+ * Hono context (`c`) which exposes `c.req`, `c.res`, `c.json`, etc.
+ *
+ * The framework adds:
+ * - `c.var.nexus` for framework-injected properties (current user,
+ *   container snapshot for the request, etc.)
+ * - `NexusResponse` helpers for streaming views and returning view
+ *   objects in a uniform way.
+ */
+import type { Context as HonoContext, Next } from "hono";
+import type { ApplicationContainer } from "../di/container.js";
+export type NexusContext = HonoContext;
+export type NexusNext = Next;
+/** Framework-specific data attached to Hono's `c.var`. */
+export interface NexusContextVar {
+    /** Root container available during the request lifetime. */
+    container: ApplicationContainer;
+    /** Resolved authenticated user (filled by @Auth middleware). */
+    user?: any;
+    /** Per-request state bag. */
+    state: Record<string, any>;
+    /** Cached parsed body, validation result, etc. */
+    cache: Map<string, any>;
+}
+/** Helper: typed access to `c.var.nexus`. */
+export declare function getNexusVar(c: NexusContext): NexusContextVar;
+//# sourceMappingURL=context.d.ts.map

package/dist/core/http/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/core/http/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC;AACvC,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC;AAE7B,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC/B,4DAA4D;IAC5D,SAAS,EAAE,oBAAoB,CAAC;IAChC,gEAAgE;IAChE,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,kDAAkD;IAClD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACxB;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,GAAG,eAAe,CAG5D"}

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

@@ -0,0 +1,8 @@
+/**
+ * HTTP barrel exports.
+ */
+export * from "./context.js";
+export * from "./middleware.js";
+export * from "./router.js";
+export * from "./server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/http/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/core/http/middleware.d.ts

@@ -0,0 +1,31 @@
+/**
+ * HTTP middleware primitives.
+ *
+ * Middleware in Nexus is just a Hono-compatible function: `(c, next) => ...`.
+ * The framework exposes a few ready-made middlewares (logger, CORS, error)
+ * and lets users write their own.
+ */
+import type { Context, Next } from "hono";
+/** A Nexus/Hono middleware signature. */
+export type Middleware = (c: Context, next: Next) => any | Promise<any>;
+/** Simple request logger. Logs method, URL, status, duration. */
+export declare function logger(): Middleware;
+/**
+ * CORS middleware.
+ *
+ * An explicit origin (string or string[]) is required. The function does
+ * not default to '*' because that is unsafe with credentials. Pass '*'
+ * explicitly via `origin: '*'` only if you know your API has no cookies.
+ */
+export declare function cors(options: {
+    origin: string | string[];
+    methods?: string[];
+    headers?: string[];
+    credentials?: boolean;
+}): Middleware;
+/**
+ * Catch-all error handler. Translates errors with `status` and `body`
+ * properties into JSON responses.
+ */
+export declare function errorHandler(): Middleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/core/http/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/core/http/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE1C,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAExE,iEAAiE;AACjE,wBAAgB,MAAM,IAAI,UAAU,CASnC;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE;IAC7B,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,UAAU,CAkCb;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,UAAU,CAazC"}

package/dist/core/http/router.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Router.
+ *
+ * The router is responsible for translating the framework's declarative
+ * metadata (controllers + @Get/@Post + param decorators + validation)
+ * into Hono route handlers.
+ *
+ * It supports three registration styles:
+ * 1. **Nest style**  — class decorators (@Controller, @Get, ...)
+ * 2. **Adonis style** — `router.get('/users', UserController, 'list')`
+ * 3. **Functional style** — `app.get('/users', async (c) => ...)`
+ *
+ * The router does NOT own the Hono instance; it just adds routes to
+ * the Hono app passed to `Router.create(app, container)`.
+ */
+import "reflect-metadata";
+import type { Hono } from "hono";
+import type { ApplicationContainer, DIContainer } from "../di/container.js";
+import type { HttpMethod, Type } from "../di/tokens.js";
+export interface NexusRouter {
+    /** Register a controller class (Nest style). */
+    registerController(controller: Type<any>, container?: DIContainer): void;
+    /** Register a method handler in Adonis style. */
+    add(method: HttpMethod, path: string, handler: any, methodName?: string, container?: DIContainer): void;
+    /** Register a raw Hono-compatible handler. */
+    raw(method: HttpMethod, path: string, handler: HonoHandler): void;
+    /** Return the underlying Hono instance. */
+    getHono(): Hono;
+    /** Return all registered routes (for OpenAPI spec generation). */
+    getRoutes(): Array<{
+        method: string;
+        path: string;
+        target: any;
+        propertyKey: string | symbol;
+        validation?: {
+            body?: unknown;
+            query?: unknown;
+            params?: unknown;
+            headers?: unknown;
+        };
+    }>;
+}
+export type HonoHandler = (c: any, next?: any) => any | Promise<any>;
+/** Factory: build a router wrapping a Hono instance + container. */
+export declare function createRouter(hono: Hono, container: ApplicationContainer): NexusRouter;
+//# sourceMappingURL=router.d.ts.map

package/dist/core/http/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/core/http/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAa5E,OAAO,KAAK,EAAE,UAAU,EAAiB,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvE,MAAM,WAAW,WAAW;IAC3B,gDAAgD;IAChD,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACzE,iDAAiD;IACjD,GAAG,CACF,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,GAAG,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,WAAW,GACrB,IAAI,CAAC;IACR,8CAA8C;IAC9C,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAClE,2CAA2C;IAC3C,OAAO,IAAI,IAAI,CAAC;IAChB,kEAAkE;IAClE,SAAS,IAAI,KAAK,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,GAAG,CAAC;QACZ,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;QAC7B,UAAU,CAAC,EAAE;YACZ,IAAI,CAAC,EAAE,OAAO,CAAC;YACf,KAAK,CAAC,EAAE,OAAO,CAAC;YAChB,MAAM,CAAC,EAAE,OAAO,CAAC;YACjB,OAAO,CAAC,EAAE,OAAO,CAAC;SAClB,CAAC;KACF,CAAC,CAAC;CACH;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AA6YrE,oEAAoE;AACpE,wBAAgB,YAAY,CAC3B,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,oBAAoB,GAC7B,WAAW,CAEb"}

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

@@ -0,0 +1,58 @@
+/**
+ * HTTP server.
+ *
+ * Builds a Hono app, attaches framework-level middleware (logging, CORS,
+ * error handler), and returns a configured server instance. The Hono app
+ * is exposed for users who want to register additional routes/middleware.
+ *
+ * Server.start() chooses the correct runtime adapter (Bun, Node, or
+ * Cloudflare) automatically based on the global environment.
+ */
+import "reflect-metadata";
+import { Hono } from "hono";
+import type { ApplicationContainer } from "../di/container.js";
+import { type NexusRouter } from "./router.js";
+export interface NexusServerOptions {
+    /** Enable request logging (default: true). */
+    logging?: boolean;
+    /**
+     * Enable the framework error handler (default: true). CORS is NOT
+     * installed automatically; use `app.use(cors({ origin }))` for explicit
+     * cross-origin setup.
+     */
+    errorHandler?: boolean;
+    /** Port for the underlying HTTP server (Bun/Node). */
+    port?: number;
+}
+export declare class NexusServer {
+    readonly app: Hono;
+    readonly container: ApplicationContainer;
+    readonly router: NexusRouter;
+    private options;
+    constructor(container: ApplicationContainer, options?: NexusServerOptions);
+    /** Install the framework's built-in middleware. */
+    private bootstrap;
+    /** Register additional global middleware. */
+    use(...handlers: any[]): this;
+    /** Override the port (use before start()). */
+    setPort(port: number): this;
+    /**
+     * Start the HTTP server using the best available runtime adapter.
+     * Returns the underlying server handle (Bun.Server, Node http.Server, or
+     * a fetch-compatible Hono instance for Cloudflare Workers).
+     */
+    start(): Promise<any>;
+    /**
+     * For serverless / Edge runtimes: return a fetch handler that can be
+     * exported from a Workers entry point.
+     */
+    get fetch(): (req: Request, env?: any, ctx?: any) => Promise<Response>;
+}
+/**
+ * Auto-detect the current runtime. Order matters:
+ * - Bun first (most specific)
+ * - Node next
+ * - Cloudflare Workers last (no Bun/Node globals)
+ */
+export declare function detectRuntime(): Promise<"bun" | "node" | "cloudflare">;
+//# sourceMappingURL=server.d.ts.map

package/dist/core/http/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/core/http/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IAClC,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,WAAW;IACvB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,OAAO,CAAC,OAAO,CAA+B;gBAG7C,SAAS,EAAE,oBAAoB,EAC/B,OAAO,GAAE,kBAAuB;IAajC,mDAAmD;IACnD,OAAO,CAAC,SAAS;IAYjB,6CAA6C;IAC7C,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAK7B,8CAA8C;IAC9C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;IAmB3B;;;OAGG;IACH,IAAI,KAAK,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,CAErE;CACD;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,KAAK,GAAG,MAAM,GAAG,YAAY,CAAC,CAI5E"}

package/dist/core/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Nexus framework — public entry point.
+ *
+ * Re-exports the public surface of every core module so users can
+ * `import { ... } from 'nexusjs'` without reaching into subpaths.
+ *
+ * Public surface intentionally stays small; advanced users can deep-import
+ * from `nexusjs/core/<module>` for sub-paths.
+ */
+export * from "./decorators/index.js";
+export * from "./di/index.js";
+export * from "./http/index.js";
+export * from "./validation/index.js";
+export * from "../view/index.js";
+export * from "./orm/index.js";
+export * from "./runtime/index.js";
+export { Application, type ApplicationOptions } from "./application.js";
+export { METADATA_KEY, PARAM_TYPES, HTTP_METHODS } from "./constants.js";
+export type { MetadataKey, ParamType, HttpMethod } from "./constants.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,uBAAuB,CAAC;AAGtC,cAAc,eAAe,CAAC;AAG9B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGxE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/core/orm/drizzle-adapter.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Drizzle ORM adapter.
+ *
+ * Provides a thin, opt-in integration with Drizzle. The framework does
+ * not bundle Drizzle as a hard dependency — users install it on demand:
+ *
+ *     bun add drizzle-orm
+ *
+ * The adapter exposes a `getDb(schema, client)` helper and a
+ * `DrizzleModule` class that wires a Drizzle client into the DI container.
+ *
+ * The adapter intentionally stays small: full ORM ergonomics live in
+ * Drizzle itself; the framework just integrates it.
+ */
+import type { DIContainer } from "../di/container.js";
+/** Minimal subset of Drizzle's API we care about. */
+export interface DrizzleLike<Schema extends Record<string, any> = any> {
+    select: (...args: any[]) => any;
+    insert: (...args: any[]) => any;
+    update: (...args: any[]) => any;
+    delete: (...args: any[]) => any;
+    query: Record<string, (...args: any[]) => any>;
+    schema: Schema;
+}
+/** Database client options the adapter knows how to construct. */
+export interface DrizzleConfig<Schema extends Record<string, any> = any> {
+    /** Pre-built Drizzle instance. */
+    instance?: DrizzleLike<Schema>;
+    /** Schema definition (passed to drizzle()). */
+    schema?: Schema;
+    /** Database client (any driver: bun:sqlite, pg, mysql2, etc.). */
+    client?: any;
+    /** Drizzle driver factory, e.g. `drizzle` from drizzle-orm/bun-sqlite. */
+    driver?: (...args: any[]) => DrizzleLike<Schema>;
+}
+/**
+ * Module that registers a Drizzle instance under a token. Use the
+ * returned provider token with `@Inject()` to access the DB from services.
+ *
+ * @example
+ * ```ts
+ * const dbModule = new DrizzleModule('DB', {
+ *   schema,
+ *   driver: drizzle,
+ * });
+ *
+ * @Module({ imports: [dbModule.asModule()] })
+ * class UserModule {}
+ * ```
+ */
+export declare class DrizzleModule<Schema extends Record<string, any> = any> {
+    private config;
+    readonly token: string;
+    constructor(token: string | undefined, config: DrizzleConfig<Schema>);
+    /**
+     * Build the actual Drizzle instance. Throws a helpful error if neither
+     * a pre-built instance nor a driver+schema is configured.
+     */
+    build(): DrizzleLike<Schema>;
+    /**
+     * Export a list of providers so users can drop this module into
+     * `@Module({ imports: [...] })`. We return a synthetic class that the
+     * module scanner recognises.
+     */
+    asModule(): {
+        new (): {};
+    };
+    /** Register the Drizzle instance into a container manually. */
+    registerInto(container: DIContainer): void;
+}
+/** Convenience: build a Drizzle instance directly (used in tests and CLI). */
+export declare function getDb<Schema extends Record<string, any> = any>(config: DrizzleConfig<Schema>): Promise<DrizzleLike<Schema>>;
+//# sourceMappingURL=drizzle-adapter.d.ts.map

package/dist/core/orm/drizzle-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-adapter.d.ts","sourceRoot":"","sources":["../../../src/core/orm/drizzle-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,qDAAqD;AACrD,MAAM,WAAW,WAAW,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IACpE,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IAChC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IAChC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IAChC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC;CACf;AAED,kEAAkE;AAClE,MAAM,WAAW,aAAa,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IACtE,kCAAkC;IAClC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,0EAA0E;IAC1E,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,WAAW,CAAC,MAAM,CAAC,CAAC;CACjD;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAa,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IAKjE,OAAO,CAAC,MAAM;IAJf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAGtB,KAAK,EAAE,MAAM,YAAO,EACZ,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC;IAKtC;;;OAGG;IACH,KAAK,IAAI,WAAW,CAAC,MAAM,CAAC;IAa5B;;;;OAIG;IACH,QAAQ;;;IAWR,+DAA+D;IAC/D,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;CAM1C;AAED,8EAA8E;AAC9E,wBAAsB,KAAK,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EACnE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC3B,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAQ9B"}

package/dist/core/orm/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * ORM adapter barrel.
+ */
+export * from "./drizzle-adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/orm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/orm/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,sBAAsB,CAAC"}

package/dist/core/runtime/bun.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Bun runtime adapter.
+ *
+ * Uses Bun's native HTTP server (Bun.serve) which is built on top of
+ * uWebSockets and provides the fastest HTTP throughput in JavaScript.
+ *
+ * Usage:
+ *   const { bunAdapter } = await import('nexusjs/runtime');
+ *   bunAdapter(honoApp, 3000);
+ */
+import type { Hono } from "hono";
+export declare function bunAdapter(app: Hono, port?: number): any;
+//# sourceMappingURL=bun.d.ts.map

package/dist/core/runtime/bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/bun.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,wBAAgB,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,GAAE,MAAa,GAAG,GAAG,CAiB9D"}

package/dist/core/runtime/cloudflare.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Cloudflare Workers runtime adapter.
+ *
+ * Returns a fetch handler suitable for `export default { fetch }` in a
+ * Workers entry point. The Hono app is the actual fetch handler, so this
+ * is mostly a thin wrapper.
+ *
+ * Usage:
+ *   // src/worker.ts
+ *   import { bootstrap } from './app.js';
+ *   const { fetch } = bootstrap();
+ *   export default { fetch };
+ */
+import type { Hono } from "hono";
+export declare function cloudflareAdapter(app: Hono): {
+    fetch: (req: Request, env?: any, ctx?: any) => Response | Promise<Response>;
+};
+//# sourceMappingURL=cloudflare.d.ts.map

package/dist/core/runtime/cloudflare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/cloudflare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,IAAI;iBAE5B,OAAO,QAAQ,GAAG,QAAQ,GAAG;EAE3C"}

package/dist/core/runtime/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Runtime adapter barrel.
+ *
+ * These adapters are dynamic-imported by the server because they target
+ * different runtimes; importing all of them at startup would pull in
+ * Node-specific modules (http, etc.) on Cloudflare Workers, which fail.
+ */
+export * from "./bun.js";
+export * from "./node.js";
+export * from "./cloudflare.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}

package/dist/core/runtime/node.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Node.js runtime adapter.
+ *
+ * Falls back to the standard `node:http` module. Bun can also run this
+ * adapter when targeting Node-compatible servers, but Bun's native
+ * adapter is significantly faster — only use this on actual Node.
+ */
+import type { Hono } from "hono";
+export declare function nodeAdapter(app: Hono, port?: number): any;
+//# sourceMappingURL=node.d.ts.map

package/dist/core/runtime/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/node.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGjC,wBAAgB,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,GAAE,MAAa,GAAG,GAAG,CAmD/D"}

package/dist/core/validation/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Validation barrel.
+ */
+export * from "./validator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/validation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,gBAAgB,CAAC"}

package/dist/core/validation/validator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Zod-based validation pipeline.
+ *
+ * `validateRequest` runs the configured Zod schemas for each request part
+ * and either returns the parsed value or throws a ValidationError.
+ *
+ * Schemas are read from @Validate({ body, query, params, headers }) on the
+ * handler method.
+ */
+import type { ZodError } from "zod";
+import type { ValidationMetadata } from "../di/tokens.js";
+export declare class ValidationError extends Error {
+    readonly status = 400;
+    readonly issues: ZodError["issues"];
+    constructor(zodError: ZodError);
+}
+export interface ValidationInput {
+    body?: unknown;
+    query?: unknown;
+    params?: unknown;
+    headers?: unknown;
+}
+export interface ValidationResult {
+    body?: unknown;
+    query?: unknown;
+    params?: unknown;
+    headers?: unknown;
+}
+/**
+ * Validate the request using the handler's @Validate metadata. Returns
+ * parsed values keyed by part. Throws ValidationError on the first
+ * failure (body → query → params → headers order).
+ */
+export declare function validateRequest(metadata: ValidationMetadata | undefined, input: ValidationInput): ValidationResult;
+/**
+ * Default error formatter for ValidationError.
+ * Renders a JSON body suitable for the framework's HTTP layer.
+ */
+export declare function formatValidationError(err: ValidationError): {
+    status: number;
+    body: {
+        error: string;
+        issues: ZodError["issues"];
+    };
+};
+//# sourceMappingURL=validator.d.ts.map

package/dist/core/validation/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/core/validation/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAa,MAAM,KAAK,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,qBAAa,eAAgB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAExB,QAAQ,EAAE,QAAQ;CAK9B;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC9B,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EACxC,KAAK,EAAE,eAAe,GACpB,gBAAgB,CAqBlB;AAyBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAC;CACpD,CAQA"}

package/dist/crypto/encryption.d.ts

@@ -0,0 +1,71 @@
+/**
+ * `EncryptionService` — AES-256-GCM symmetric encryption + HMAC
+ * sign/unsign helpers.
+ *
+ * Use cases:
+ * - **Encrypt** sensitive data before storing it (e.g. session
+ *   blobs in cookies or DB).
+ * - **Sign** stateless values that need to be tamper-proof (e.g.
+ *   session IDs, CSRF tokens, password-reset links, signed URLs).
+ *
+ * The service derives two 32-byte keys from the user's master
+ * `key` config: one for AES-GCM, one for HMAC. The keys are
+ * distinct (HKDF-SHA256 with a per-purpose salt) so a leak of one
+ * doesn't compromise the other.
+ *
+ * Encrypted format (v1):
+ *   `v1.<base64url(iv)>.<base64url(tag)>.<base64url(ciphertext)>`
+ *   where `iv` is 12 bytes and `tag` is 16 bytes (GCM auth tag).
+ *
+ * Signed format:
+ *   `<base64url(value)>.<base64url(hmac)>`
+ */
+import type { EncryptedValue, EncryptOptions, SignedValue } from "./types.js";
+export declare class EncryptionService {
+    private readonly aesKey;
+    private readonly hmacKey;
+    constructor(masterKey: string);
+    /**
+     * Encrypt a string. The output is self-describing and includes
+     * the IV, auth tag, expiry, and purpose (if any) in the MAC.
+     *
+     * Format: `v1.<iv>.<tag>.<ciphertext>.<mac>`
+     */
+    encrypt(value: string, options?: EncryptOptions): EncryptedValue;
+    /**
+     * Decrypt a value previously produced by `encrypt()`. Throws
+     * if the value is malformed, the MAC doesn't match, the
+     * purpose doesn't match, or the expiry has passed.
+     */
+    decrypt<T = string>(payload: string): T;
+    /** True if the string was produced by `encrypt()`. */
+    isEncrypted(value: string): boolean;
+    /**
+     * Sign a string with the framework's HMAC key. The output is
+     * `<base64url(value)>.<base64url(hmac)>`.
+     *
+     * Useful for stateless session cookies, CSRF tokens, etc.
+     */
+    sign(value: string, purpose?: string): SignedValue;
+    /**
+     * Sign a pre-encoded value (no extra b64-encoding). The output
+     * is just the base64url MAC. Useful for cookie / token formats
+     * where the value is already b64-encoded.
+     *
+     * The caller is responsible for joining the value and signature.
+     */
+    signRaw(value: string, purpose?: string): string;
+    /**
+     * Verify a raw signature (from `signRaw`) against a pre-encoded
+     * value. Returns `true` on match, `false` otherwise.
+     */
+    verifyRaw(value: string, signature: string, purpose?: string): boolean;
+    /**
+     * Verify and extract a previously signed value. Returns the
+     * original value on success, `null` on failure (malformed,
+     * wrong purpose, MAC mismatch).
+     */
+    unsign(signed: string, purpose?: string): string | null;
+    private macOver;
+}
+//# sourceMappingURL=encryption.d.ts.map

package/dist/crypto/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../../src/crypto/encryption.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAUH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9E,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,SAAS,EAAE,MAAM;IAQ7B;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,cAAc;IAsBpE;;;;OAIG;IACH,OAAO,CAAC,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC;IAkCvC,sDAAsD;IACtD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOnC;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,WAAW;IAS9C;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,MAAM;IAS5C;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,OAAO;IAWlE;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,MAAM,GAAG,IAAI;IAmBnD,OAAO,CAAC,OAAO;CAQf"}