@kurdel/core 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Andrii Sorokin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,54 @@
+# @kurdel/core
+
+Core **contracts** and **interfaces** for the Kurdel framework.  
+Contains stable, runtime-independent API definitions used by all other packages.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @kurdel/core
+```
+
+---
+
+## 📘 Purpose
+
+* Framework-agnostic HTTP contracts (`Controller`, `ActionResult`, `HttpContext`)
+* Tokens and metadata utilities
+* Base abstractions for routers, modules, and middlewares
+* Type-safe route definitions (no decorators)
+
+---
+
+## 🔧 Example
+
+```ts
+import { Controller, route, Ok, type HttpContext } from '@kurdel/core/http';
+
+export class UserController extends Controller {
+  readonly routes = {
+    list: route({ method: 'GET', path: '/users' })(this.list),
+  };
+
+  async list(_ctx: HttpContext) {
+    return Ok([{ id: 1, name: 'Ada Lovelace' }]);
+  }
+}
+```
+
+---
+
+## 🔗 Used by
+
+* `@kurdel/runtime`
+* `@kurdel/runtime-node`
+* `@kurdel/facade`
+* `@kurdel/template-ejs`
+
+---
+
+## 📄 License
+
+MIT © Andrii Sorokin

package/lib/app/app-config.d.ts

@@ -0,0 +1,9 @@
+import type { Newable } from '@kurdel/common';
+import type { Model } from '../db/index.js';
+import type { HttpModule } from '../http/index.js';
+import type { AppModule } from '../app/index.js';
+export interface AppConfig {
+    db?: boolean;
+    models?: Newable<Model>[];
+    modules?: (AppModule | HttpModule)[];
+}

package/lib/app/app-config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=app-config.js.map

package/lib/app/app-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.js","sourceRoot":"","sources":["../../src/app/app-config.ts"],"names":[],"mappings":""}

package/lib/app/app-module.d.ts

@@ -0,0 +1,75 @@
+import type { Identifier, Container } from '@kurdel/ioc';
+import type { AppConfig } from '../app/index.js';
+/**
+ * ## ClassProviderConfig
+ *
+ * Registers a class constructor as a provider.
+ * Instances are created by the IoC container, optionally with:
+ * - explicit `deps` mapping for constructor injection
+ * - lifecycle mode (`singleton` or per-scope)
+ */
+export type ClassProviderConfig<T = any> = {
+    provide: Identifier<T>;
+    useClass: new (...args: any[]) => T;
+    deps?: Record<string, Identifier<unknown>>;
+    singleton?: boolean;
+};
+/**
+ * ## InstanceProviderConfig
+ *
+ * Registers a pre-constructed instance.
+ * No lifecycle or dependency metadata — the provided instance is used as-is.
+ */
+export type InstanceProviderConfig<T = any> = {
+    provide: Identifier<T>;
+    useInstance: T;
+};
+/**
+ * ## FactoryProviderConfig
+ *
+ * Registers a factory function.
+ * The function receives the IoC container and must produce a value.
+ * Can optionally opt into singleton mode.
+ */
+export type FactoryProviderConfig<T = any> = {
+    provide: Identifier<T>;
+    useFactory: (ioc: Container) => T | Promise<T>;
+    singleton?: boolean;
+};
+/**
+ * ## ProviderConfig
+ *
+ * Unified provider registration type for feature modules.
+ * Covers:
+ * - class providers
+ * - instance providers
+ * - factory providers
+ */
+export type ProviderConfig<T = any> = ClassProviderConfig<T> | InstanceProviderConfig<T> | FactoryProviderConfig<T>;
+/**
+ * ## AppModule
+ *
+ * Feature module — a self-contained composition unit.
+ *
+ * Provides:
+ * - dependency tokens
+ * - configuration-driven providers
+ * - optional setup logic via `register()`
+ *
+ * Modules define what they export and what dependencies they require.
+ */
+export interface AppModule<TConfig = AppConfig> {
+    /** Determines initialization order (lower = earlier). */
+    readonly priority?: number;
+    /** Tokens or modules this one depends on. */
+    readonly imports?: Identifier<any>[] | Record<string, Identifier<any>>;
+    /** Tokens this module exports for other modules. */
+    readonly exports?: Identifier<any>[] | Record<string, Identifier<any>>;
+    /** Declarative provider registrations. */
+    readonly providers?: ProviderConfig[];
+    /**
+     * Imperative setup hook.
+     * Called once during application initialization.
+     */
+    register?(ioc: Container, config: TConfig): Promise<void> | void;
+}

package/lib/app/app-module.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=app-module.js.map

package/lib/app/app-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-module.js","sourceRoot":"","sources":["../../src/app/app-module.ts"],"names":[],"mappings":""}

package/lib/app/app-tokens.d.ts

@@ -0,0 +1,4 @@
+export declare const APP_TOKENS: {
+    OnStart: import("@kurdel/ioc").InjectionToken<import("../app/index.js").LifecycleHook[]>;
+    OnShutdown: import("@kurdel/ioc").InjectionToken<import("../app/index.js").LifecycleHook[]>;
+};

package/lib/app/app-tokens.js

@@ -0,0 +1,6 @@
+import { createGlobalToken } from '@kurdel/ioc';
+export const APP_TOKENS = {
+    OnStart: createGlobalToken('@kurdel/core/app:on-start'),
+    OnShutdown: createGlobalToken('@kurdel/core/app:on-shutdown'),
+};
+//# sourceMappingURL=app-tokens.js.map

package/lib/app/app-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-tokens.js","sourceRoot":"","sources":["../../src/app/app-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,iBAAiB,CAAgB,2BAA2B,CAAC;IACtE,UAAU,EAAE,iBAAiB,CAAmB,8BAA8B,CAAC;CAChF,CAAC"}

package/lib/app/application.d.ts

@@ -0,0 +1,23 @@
+import type { Container } from '@kurdel/ioc';
+import type { RunningServer } from '../http/index.js';
+import type { AppModule } from '../app/index.js';
+/**
+ * Public application contract.
+ * Exposes a DI container (by interface), allows composing modules,
+ * and starting the HTTP server via a façade in the runtime.
+ */
+export interface Application {
+    /** DI container exposed by interface type (implementation is hidden). */
+    readonly container: Container;
+    /** Register additional modules before startup. */
+    use(...modules: AppModule[]): void;
+    /**
+     * Start the server and get a handle for tests and shutdown.
+     * Kept compatible with previous signature by making callback optional.
+     */
+    listen(port: number, callback?: () => void): RunningServer;
+    /**
+     * Expose underlying IoC container for advanced use cases.
+     */
+    getContainer(): Container;
+}

package/lib/app/application.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=application.js.map

package/lib/app/application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.js","sourceRoot":"","sources":["../../src/app/application.ts"],"names":[],"mappings":""}

package/lib/app/index.d.ts

@@ -0,0 +1,6 @@
+export * from './application.js';
+export * from './app-config.js';
+export * from './app-module.js';
+export * from './app-tokens.js';
+export * from './lifecycle.js';
+export * from './module-priority.js';

package/lib/app/index.js

@@ -0,0 +1,7 @@
+export * from './application.js';
+export * from './app-config.js';
+export * from './app-module.js';
+export * from './app-tokens.js';
+export * from './lifecycle.js';
+export * from './module-priority.js';
+//# sourceMappingURL=index.js.map

package/lib/app/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}

package/lib/app/lifecycle.d.ts

@@ -0,0 +1,3 @@
+export type LifecycleHook = () => void | Promise<void>;
+export type OnStartHook = LifecycleHook;
+export type OnShutdownHook = LifecycleHook;

package/lib/app/lifecycle.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lifecycle.js.map

package/lib/app/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/app/lifecycle.ts"],"names":[],"mappings":""}

package/lib/app/module-priority.d.ts

@@ -0,0 +1,33 @@
+/**
+ * ## ModulePriority
+ *
+ * Standard initialization weights for Kurdel application modules.
+ *
+ * Lower number → earlier initialization.
+ *
+ * Recommended lifecycle:
+ *
+ * 10  Lifecycle   — framework boot logic, configuration preparation
+ * 20  Database    — database clients/drivers
+ * 30  User        — user-defined modules (default fallback)
+ * 40  Model       — model definition + schema registration
+ * 50  Middleware  — global middleware registry
+ * 60  Auth        — authentication/authorization middleware hookup
+ * 70  Controller  — controller registration + route table build
+ * 80  Platform    — platform-specific bindings (Node/Express/Fastify/etc.)
+ * 90  Server      — server start module
+ *
+ * 100 Custom — fallback for modules without explicit priority
+ */
+export declare enum ModulePriority {
+    Lifecycle = 10,
+    Database = 20,
+    User = 30,
+    Model = 40,
+    Middleware = 50,
+    Auth = 60,
+    Controller = 70,
+    Platform = 80,
+    Server = 90,
+    Custom = 100
+}

package/lib/app/module-priority.js

@@ -0,0 +1,35 @@
+/**
+ * ## ModulePriority
+ *
+ * Standard initialization weights for Kurdel application modules.
+ *
+ * Lower number → earlier initialization.
+ *
+ * Recommended lifecycle:
+ *
+ * 10  Lifecycle   — framework boot logic, configuration preparation
+ * 20  Database    — database clients/drivers
+ * 30  User        — user-defined modules (default fallback)
+ * 40  Model       — model definition + schema registration
+ * 50  Middleware  — global middleware registry
+ * 60  Auth        — authentication/authorization middleware hookup
+ * 70  Controller  — controller registration + route table build
+ * 80  Platform    — platform-specific bindings (Node/Express/Fastify/etc.)
+ * 90  Server      — server start module
+ *
+ * 100 Custom — fallback for modules without explicit priority
+ */
+export var ModulePriority;
+(function (ModulePriority) {
+    ModulePriority[ModulePriority["Lifecycle"] = 10] = "Lifecycle";
+    ModulePriority[ModulePriority["Database"] = 20] = "Database";
+    ModulePriority[ModulePriority["User"] = 30] = "User";
+    ModulePriority[ModulePriority["Model"] = 40] = "Model";
+    ModulePriority[ModulePriority["Middleware"] = 50] = "Middleware";
+    ModulePriority[ModulePriority["Auth"] = 60] = "Auth";
+    ModulePriority[ModulePriority["Controller"] = 70] = "Controller";
+    ModulePriority[ModulePriority["Platform"] = 80] = "Platform";
+    ModulePriority[ModulePriority["Server"] = 90] = "Server";
+    ModulePriority[ModulePriority["Custom"] = 100] = "Custom";
+})(ModulePriority || (ModulePriority = {}));
+//# sourceMappingURL=module-priority.js.map

package/lib/app/module-priority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-priority.js","sourceRoot":"","sources":["../../src/app/module-priority.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAN,IAAY,cAWX;AAXD,WAAY,cAAc;IACxB,8DAAc,CAAA;IACd,4DAAa,CAAA;IACb,oDAAS,CAAA;IACT,sDAAU,CAAA;IACV,gEAAe,CAAA;IACf,oDAAS,CAAA;IACT,gEAAe,CAAA;IACf,4DAAa,CAAA;IACb,wDAAW,CAAA;IACX,yDAAY,CAAA;AACd,CAAC,EAXW,cAAc,KAAd,cAAc,QAWzB"}

package/lib/db/index.d.ts

@@ -0,0 +1 @@
+export * from './model.js';

package/lib/db/index.js

@@ -0,0 +1,2 @@
+export * from './model.js';
+//# sourceMappingURL=index.js.map

package/lib/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/lib/db/model.d.ts

@@ -0,0 +1,23 @@
+import type { Newable } from '@kurdel/common';
+import type { Identifier } from '@kurdel/ioc';
+import type { IDatabase } from '@kurdel/db';
+interface ModelDeps {
+    db: IDatabase;
+}
+export declare abstract class Model {
+    private db;
+    private builder;
+    protected abstract table: string;
+    constructor(deps: ModelDeps);
+    create(data: Record<string, any>): Promise<void>;
+    find(field: string, values: any[]): Promise<any>;
+    findAll(): Promise<any>;
+}
+export interface ModelConfig {
+    /** Controller class */
+    use: Newable<Model>;
+    /** Dependencies to be injected from IoC */
+    deps?: Record<string, Identifier>;
+}
+export type ModelList = (Newable<Model> | ModelConfig)[];
+export {};

package/lib/db/model.js

@@ -0,0 +1,17 @@
+import { QueryBuilder } from '@kurdel/db';
+export class Model {
+    constructor(deps) {
+        this.db = deps.db;
+        this.builder = new QueryBuilder();
+    }
+    async create(data) {
+        return this.db.run(this.builder.insert(this.table, data).build());
+    }
+    async find(field, values) {
+        return this.db.get(this.builder.select('*').from(this.table).where(`${field} = ?`, values).build());
+    }
+    async findAll() {
+        return this.db.all(this.builder.select('*').from(this.table).build());
+    }
+}
+//# sourceMappingURL=model.js.map

package/lib/db/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/db/model.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM1C,MAAM,OAAgB,KAAK;IAKzB,YAAY,IAAe;QACzB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IACpC,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,IAAyB;QAC3C,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,MAAa;QAC5C,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,EAAE,CAChF,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACxE,CAAC;CACF"}

package/lib/http/errors/http-error.d.ts

@@ -0,0 +1,5 @@
+export declare class HttpError extends Error {
+    readonly status: number;
+    readonly details?: unknown;
+    constructor(status: number, message: string, details?: unknown);
+}

package/lib/http/errors/http-error.js

@@ -0,0 +1,9 @@
+export class HttpError extends Error {
+    constructor(status, message, details) {
+        super(message);
+        Object.setPrototypeOf(this, new.target.prototype);
+        this.status = status;
+        this.details = details;
+    }
+}
+//# sourceMappingURL=http-error.js.map

package/lib/http/errors/http-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-error.js","sourceRoot":"","sources":["../../../src/http/errors/http-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAU,SAAQ,KAAK;IAIlC,YAAY,MAAc,EAAE,OAAe,EAAE,OAAiB;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/lib/http/errors/index.d.ts

@@ -0,0 +1,2 @@
+export * from './http-error.js';
+export * from './validation-error.js';

package/lib/http/errors/index.js

@@ -0,0 +1,3 @@
+export * from './http-error.js';
+export * from './validation-error.js';
+//# sourceMappingURL=index.js.map

package/lib/http/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/http/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}

package/lib/http/errors/validation-error.d.ts

@@ -0,0 +1,9 @@
+import type { JsonValue } from '../../http/types.js';
+/**
+ * Error raised when schema validation fails.
+ */
+export declare class ValidationError extends Error {
+    readonly field?: string | undefined;
+    readonly details?: JsonValue;
+    constructor(message: string, field?: string | undefined, details?: JsonValue);
+}

package/lib/http/errors/validation-error.js

@@ -0,0 +1,12 @@
+/**
+ * Error raised when schema validation fails.
+ */
+export class ValidationError extends Error {
+    constructor(message, field, details) {
+        super(message);
+        this.field = field;
+        this.details = details;
+        this.name = 'ValidationError';
+    }
+}
+//# sourceMappingURL=validation-error.js.map

package/lib/http/errors/validation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.js","sourceRoot":"","sources":["../../../src/http/errors/validation-error.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YACE,OAAe,EACN,KAAc,EACd,OAAmB;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,UAAK,GAAL,KAAK,CAAS;QACd,YAAO,GAAP,OAAO,CAAY;QAG5B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/lib/http/http-context.d.ts

@@ -0,0 +1,107 @@
+import type { AuthContext, AuthUser, HttpRequest, HttpResponse } from '@kurdel/common';
+import type { Container } from '@kurdel/ioc';
+import type { JsonValue, Query, ActionResult, RouteMatch } from '../http/index.js';
+/**
+ * ## HttpContext
+ *
+ * Immutable per-request execution context for Kurdel runtime.
+ *
+ * Each incoming request produces a unique `HttpContext` instance,
+ * which travels through middleware and controller pipelines.
+ *
+ * It encapsulates parsed HTTP data, route metadata, and helper
+ * methods for constructing `ActionResult` responses.
+ */
+export interface HttpContext<
+/** Parsed request body type */
+TBody = unknown, 
+/** URL parameters extracted from route */
+TParams extends Record<string, string> = Record<string, string>, 
+/** Streamable response type (e.g. for SSR or files) */
+TReadable = unknown> {
+    /**
+     * Request-scoped dependency container.
+     *
+     * Allows middleware and controllers to resolve:
+     * - auth registry
+     * - user service
+     * - db session/transaction
+     * - logger
+     * - anything else bound in this scope
+     */
+    readonly scope: Container;
+    /**
+     * Underlying HTTP request abstraction provided by the active adapter.
+     */
+    readonly req: HttpRequest;
+    /**
+     * Underlying HTTP response abstraction provided by the active adapter.
+     * Used by the renderer to send the actual response.
+     */
+    readonly res: HttpResponse;
+    /**
+     * Fully parsed request URL including pathname and query string.
+     */
+    readonly url: URL;
+    /**
+     * Parsed query parameters of the current request.
+     */
+    query: Query;
+    /**
+     * Path parameters extracted from the matched route.
+     */
+    params: TParams;
+    /**
+     * Parsed request body (if available and supported by middleware).
+     */
+    body?: TBody;
+    /**
+     * Matched route information, including schema and controller metadata.
+     * Useful for validation or dynamic response generation.
+     */
+    route?: RouteMatch;
+    /**
+     * Authenticated user associated with this request.
+     *
+     * Populated by authentication middleware (auth zone).
+     * Undefined for public routes or when authentication is not required.
+     */
+    user?: AuthUser;
+    /** Full authentication result, including strategy and credential metadata. */
+    auth?: AuthContext;
+    /**
+     * The last computed {@link ActionResult} for this request.
+     *
+     * Populated by the orchestrator or renderer after a middleware
+     * or controller produces a result.
+     *
+     * Logging / metrics middleware may rely on this value even if
+     * the pipeline was short-circuited (e.g., by authentication).
+     */
+    result?: ActionResult<TReadable>;
+    /**
+     * Constructs a JSON response with the given HTTP status code.
+     *
+     * @param status - HTTP status code
+     * @param body - JSON-serializable object
+     */
+    json(status: number, body: JsonValue): ActionResult<TReadable>;
+    /**
+     * Constructs a plain-text response with the given status and message.
+     *
+     * @param status - HTTP status code
+     * @param body - Text content
+     */
+    text(status: number, body: string): ActionResult<TReadable>;
+    /**
+     * Constructs a redirect response to the given location.
+     *
+     * @param status - HTTP redirect status (3xx)
+     * @param location - Target URL or path
+     */
+    redirect(status: number, location: string): ActionResult<TReadable>;
+    /**
+     * Constructs a 204 "No Content" response.
+     */
+    noContent(): ActionResult<TReadable>;
+}

package/lib/http/http-context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http-context.js.map

package/lib/http/http-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-context.js","sourceRoot":"","sources":["../../src/http/http-context.ts"],"names":[],"mappings":""}

package/lib/http/http-module.d.ts

@@ -0,0 +1,61 @@
+import type { ModelList } from '../db/model.js';
+import type { AppModule } from '../app/app-module.js';
+import type { AppConfig } from '../app/app-config.js';
+import type { Middleware, ControllerConfig, MiddlewareRegistration } from '../http/index.js';
+/**
+ * HttpModule
+ *
+ * Extension of the base AppModule contract for modules
+ * that operate in an HTTP context.
+ *
+ * Purpose:
+ * - Declare a list of middleware provided by this module
+ * - Declare a list of controllers provided by this module
+ * - Declare a list of middleware provided by this module
+ *
+ * @example
+ * ```ts
+ * export class UserModule implements HttpModule {
+ *   readonly models = [UserModel];
+ *   readonly controllers = [UserController];
+ *   readonly middlewares = [AuthMiddleware];
+ *
+ *   readonly providers = [
+ *     { provide: UserService, useClass: UserService, isSingleton: true }
+ *   ];
+ *
+ *   async register(ioc: IoCContainer) {
+ *     // everything else is handled via providers
+ *   }
+ * }
+ * ```
+ */
+export interface HttpModule<TConfig = AppConfig, out TReadable = unknown> extends AppModule<TConfig> {
+    /**
+     * Models that should be registered
+     * through the ModelModule
+     */
+    readonly models?: ModelList;
+    /**
+     * Controllers that should be registered
+     * through the ControllerModule
+     */
+    readonly controllers?: ControllerConfig[];
+    /**
+     * Global middlewares provided by this module.
+     *
+     * Middlewares may be defined either as raw functions:
+     * ```ts
+     * readonly middlewares = [loggingMiddleware];
+     * ```
+     *
+     * or as structured registrations with zone and priority:
+     * ```ts
+     * readonly middlewares = [
+     *   { use: loggingMiddleware, zone: 'post', priority: 10 },
+     *   { use: corsMiddleware, zone: 'pre', priority: 0 },
+     * ];
+     * ```
+     */
+    readonly middlewares?: Array<Middleware<unknown, TReadable> | MiddlewareRegistration>;
+}

package/lib/http/http-module.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http-module.js.map

package/lib/http/http-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-module.js","sourceRoot":"","sources":["../../src/http/http-module.ts"],"names":[],"mappings":""}

package/lib/http/http-tokens.d.ts

@@ -0,0 +1,10 @@
+import type { ServerAdapter, Router, Controller, ControllerConfig, MiddlewareRegistry, ControllerResolver, ResponseRenderer } from '../http/index.js';
+export declare const HTTP_TOKENS: {
+    ServerAdapter: import("@kurdel/ioc").InjectionToken<ServerAdapter<import("@kurdel/common").HttpRequest, import("@kurdel/common").HttpResponse>>;
+    Router: import("@kurdel/ioc").InjectionToken<Router>;
+    ControllerClasses: import("@kurdel/ioc").InjectionToken<Controller<{}>[]>;
+    ControllerConfigs: import("@kurdel/ioc").InjectionToken<ControllerConfig[]>;
+    MiddlewareRegistry: import("@kurdel/ioc").InjectionToken<MiddlewareRegistry>;
+    ControllerResolver: import("@kurdel/ioc").InjectionToken<ControllerResolver>;
+    ResponseRenderer: import("@kurdel/ioc").InjectionToken<ResponseRenderer>;
+};