@kurdel/runtime 0.1.0-beta.1

package/lib/middlewares/error-handle.js

@@ -0,0 +1,30 @@
+import { HttpError } from '@kurdel/core/http';
+import { isHttpError } from '../http/is-http-error.js';
+export const errorHandler = async (ctx, next) => {
+    try {
+        return await next();
+    }
+    catch (err) {
+        if (err instanceof HttpError) {
+            return {
+                kind: 'json',
+                status: err.status,
+                body: {
+                    error: err.message,
+                    ...(err.details ? { details: err.details } : {}),
+                },
+            };
+        }
+        if (isHttpError(err)) {
+            ctx.res.status(err.status).send(err.message ?? 'Error');
+            return;
+        }
+        console.error(err);
+        return {
+            kind: 'json',
+            status: 500,
+            body: { error: 'Internal Server Error' },
+        };
+    }
+};
+//# sourceMappingURL=error-handle.js.map

package/lib/middlewares/error-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handle.js","sourceRoot":"","sources":["../../src/middlewares/error-handle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,CAAC,MAAM,YAAY,GAAe,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;IAC1D,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;YAC7B,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,IAAI,EAAE;oBACJ,KAAK,EAAE,GAAG,CAAC,OAAO;oBAClB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxD;aACF,CAAC;QACJ,CAAC;QAED,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEnB,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE;SACzC,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/lib/middlewares/index.d.ts

@@ -0,0 +1,2 @@
+export * from './create-validator.js';
+export * from './schema-validator.js';

package/lib/middlewares/index.js

@@ -0,0 +1,3 @@
+export * from './create-validator.js';
+export * from './schema-validator.js';
+//# sourceMappingURL=index.js.map

package/lib/middlewares/index.js.map

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

package/lib/middlewares/json-body-parser.d.ts

@@ -0,0 +1,14 @@
+import type { Middleware } from '@kurdel/core/http';
+/**
+ * Parses JSON request body and assigns it to ctx.body.
+ *
+ * Usage:
+ *   appConfig.middlewares = [jsonBodyParser];
+ *
+ * Then in controller:
+ *   async create(ctx: HttpContext<Deps, { name: string }>) {
+ *     if (!ctx.body?.name) throw BadRequest('Name is required');
+ *     ...
+ *   }
+ */
+export declare const jsonBodyParser: Middleware;

package/lib/middlewares/json-body-parser.js

@@ -0,0 +1,23 @@
+/**
+ * Parses JSON request body and assigns it to ctx.body.
+ *
+ * Usage:
+ *   appConfig.middlewares = [jsonBodyParser];
+ *
+ * Then in controller:
+ *   async create(ctx: HttpContext<Deps, { name: string }>) {
+ *     if (!ctx.body?.name) throw BadRequest('Name is required');
+ *     ...
+ *   }
+ */
+export const jsonBodyParser = async (ctx, next) => {
+    const contentType = ctx.req.headers?.['content-type'] ?? '';
+    if (!contentType.includes('application/json')) {
+        return next();
+    }
+    if (ctx.req.body && typeof ctx.req.body === 'object') {
+        ctx.body = ctx.req.body;
+    }
+    return next();
+};
+//# sourceMappingURL=json-body-parser.js.map

package/lib/middlewares/json-body-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-body-parser.js","sourceRoot":"","sources":["../../src/middlewares/json-body-parser.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,cAAc,GAAe,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;IAC5D,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAC5D,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;IAED,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrD,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC,CAAC"}

package/lib/middlewares/schema-validator.d.ts

@@ -0,0 +1,13 @@
+import { type Middleware } from '@kurdel/core/http';
+/**
+ * ## schemaValidator
+ *
+ * Global middleware that performs runtime validation of incoming
+ * requests based on the {@link RouteSchema} defined in `ctx.route.schema`.
+ *
+ * No explicit schema injection required — it works automatically
+ * for any route that defines `schema` in its metadata.
+ *
+ * If validation fails, it returns a 400 JSON response.
+ */
+export declare const schemaValidator: Middleware;

package/lib/middlewares/schema-validator.js

@@ -0,0 +1,44 @@
+import { ValidationError, } from '@kurdel/core/http';
+/**
+ * ## schemaValidator
+ *
+ * Global middleware that performs runtime validation of incoming
+ * requests based on the {@link RouteSchema} defined in `ctx.route.schema`.
+ *
+ * No explicit schema injection required — it works automatically
+ * for any route that defines `schema` in its metadata.
+ *
+ * If validation fails, it returns a 400 JSON response.
+ */
+export const schemaValidator = async (ctx, next) => {
+    const schema = ctx.route?.schema;
+    if (!schema) {
+        // No schema — just pass through
+        return next();
+    }
+    try {
+        // Validate each part if present in schema
+        if (schema.params) {
+            ctx.params = await schema.params.validate(ctx.params);
+        }
+        if (schema.query) {
+            ctx.query = await schema.query.validate(ctx.query);
+        }
+        if (schema.body) {
+            ctx.body = await schema.body.validate(ctx.body);
+        }
+    }
+    catch (err) {
+        if (err instanceof ValidationError) {
+            return ctx.json(400, {
+                error: 'Bad Request',
+                message: err.message,
+                field: err.field,
+                details: err.details,
+            });
+        }
+        throw err;
+    }
+    return next();
+};
+//# sourceMappingURL=schema-validator.js.map

package/lib/middlewares/schema-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.js","sourceRoot":"","sources":["../../src/middlewares/schema-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAe,KAAK,EAAE,GAAgB,EAAE,IAAI,EAAE,EAAE;IAC1E,MAAM,MAAM,GAA4B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC;IAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,gCAAgC;QAChC,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;IAED,IAAI,CAAC;QACH,0CAA0C;QAC1C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACjB,GAAW,CAAC,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChB,GAAW,CAAC,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACf,GAAW,CAAC,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;YACnC,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE;gBACnB,KAAK,EAAE,aAAa;gBACpB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,OAAO,EAAE,GAAG,CAAC,OAAO;aACrB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC,CAAC"}

package/lib/modules/controller-module.d.ts

@@ -0,0 +1,23 @@
+import type { Container } from '@kurdel/ioc';
+import type { ControllerConfig } from '@kurdel/core/http';
+import type { AppModule, ProviderConfig } from '@kurdel/core/app';
+/**
+ * ## ControllerModule
+ *
+ * Responsible for:
+ * - Registering all controller providers in the IoC container.
+ * - Instantiating and initializing the `RuntimeRouter`.
+ * - Binding declared middlewares to the `MiddlewareRegistry`.
+ */
+export declare class ControllerModule implements AppModule {
+    private readonly controllers;
+    readonly exports: {
+        controllerConfigs: import("@kurdel/ioc").InjectionToken<ControllerConfig[]>;
+    };
+    readonly providers: ProviderConfig[];
+    constructor(controllers: ControllerConfig[]);
+    /**
+     * Initializes router and middleware registry after IoC bootstrap.
+     */
+    register(ioc: Container): Promise<void>;
+}

package/lib/modules/controller-module.js

@@ -0,0 +1,76 @@
+import { TOKENS } from '@kurdel/core/tokens';
+import { RuntimeControllerResolver } from '../http/runtime-controller-resolver.js';
+import { RuntimeRouter } from '../http/runtime-router.js';
+import { ensureTemplateEngineBinding } from '../template/ensure-template-engine-binding.js';
+/**
+ * ## ControllerModule
+ *
+ * Responsible for:
+ * - Registering all controller providers in the IoC container.
+ * - Instantiating and initializing the `RuntimeRouter`.
+ * - Binding declared middlewares to the `MiddlewareRegistry`.
+ */
+export class ControllerModule {
+    constructor(controllers) {
+        this.controllers = controllers;
+        this.exports = {
+            controllerConfigs: TOKENS.ControllerConfigs,
+        };
+        this.providers = [
+            {
+                provide: TOKENS.ControllerResolver,
+                useFactory: (ioc) => new RuntimeControllerResolver(ioc),
+                singleton: true,
+            },
+            {
+                provide: TOKENS.Router,
+                useClass: RuntimeRouter,
+                singleton: true,
+            },
+            ...controllers.map(c => ({
+                provide: c.use,
+                useClass: c.use,
+                deps: {
+                    ...c.deps,
+                    view: TOKENS.TemplateEngineToken,
+                },
+            })),
+            {
+                provide: TOKENS.ControllerConfigs,
+                useInstance: controllers,
+            },
+        ];
+    }
+    /**
+     * Initializes router and middleware registry after IoC bootstrap.
+     */
+    async register(ioc) {
+        // Ensure that a template engine is bound before controller creation.
+        ensureTemplateEngineBinding(ioc);
+        const resolver = ioc.get(TOKENS.ControllerResolver);
+        const router = ioc.get(TOKENS.Router);
+        const registry = ioc.get(TOKENS.MiddlewareRegistry);
+        const configs = ioc.get(TOKENS.ControllerConfigs);
+        // Initialize router (build route table)
+        router.init(resolver, configs);
+        // Register controller-scoped middlewares
+        for (const cfg of this.controllers) {
+            for (const entry of cfg.middlewares ?? []) {
+                const reg = typeof entry === 'function'
+                    ? { use: entry, zone: 'pre', priority: 0 }
+                    : {
+                        use: entry.use,
+                        zone: entry.zone ?? 'pre',
+                        priority: entry.priority ?? 0,
+                        action: entry.action,
+                    };
+                registry.useFor(cfg.use, reg.use, {
+                    zone: reg.zone,
+                    priority: reg.priority,
+                    action: reg.action,
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=controller-module.js.map

package/lib/modules/controller-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-module.js","sourceRoot":"","sources":["../../src/modules/controller-module.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAE7F;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAgB;IAO3B,YAA6B,WAA+B;QAA/B,gBAAW,GAAX,WAAW,CAAoB;QANnD,YAAO,GAAG;YACjB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;SAC5C,CAAC;QAKA,IAAI,CAAC,SAAS,GAAG;YACf;gBACE,OAAO,EAAE,MAAM,CAAC,kBAAkB;gBAClC,UAAU,EAAE,CAAC,GAAc,EAAE,EAAE,CAAC,IAAI,yBAAyB,CAAC,GAAG,CAAC;gBAClE,SAAS,EAAE,IAAI;aAChB;YACD;gBACE,OAAO,EAAE,MAAM,CAAC,MAAM;gBACtB,QAAQ,EAAE,aAAuD;gBACjE,SAAS,EAAE,IAAI;aAChB;YACD,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvB,OAAO,EAAE,CAAC,CAAC,GAAG;gBACd,QAAQ,EAAE,CAAC,CAAC,GAAG;gBACf,IAAI,EAAE;oBACJ,GAAG,CAAC,CAAC,IAAI;oBACT,IAAI,EAAE,MAAM,CAAC,mBAAmB;iBACjC;aACF,CAAC,CAAC;YACH;gBACE,OAAO,EAAE,MAAM,CAAC,iBAAiB;gBACjC,WAAW,EAAE,WAAW;aACzB;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,GAAc;QAC3B,qEAAqE;QACrE,2BAA2B,CAAC,GAAG,CAAC,CAAC;QAEjC,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAqB,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAgB,MAAM,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAqB,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAqB,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAEtE,wCAAwC;QACxC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE/B,yCAAyC;QACzC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;gBAC1C,MAAM,GAAG,GACP,OAAO,KAAK,KAAK,UAAU;oBACzB,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE;oBAC1C,CAAC,CAAC;wBACE,GAAG,EAAE,KAAK,CAAC,GAAG;wBACd,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK;wBACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC;wBAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;qBACrB,CAAC;gBAER,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE;oBAChC,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,MAAM,EAAE,GAAG,CAAC,MAAM;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/lib/modules/database-module.d.ts

@@ -0,0 +1,25 @@
+import type { IoCContainer } from '@kurdel/ioc';
+import { IDatabase } from '@kurdel/db';
+import type { AppConfig, AppModule } from '@kurdel/core/app';
+export declare class NoopDatabase implements IDatabase {
+    query: () => Promise<void>;
+    get: () => Promise<void>;
+    all: () => Promise<void>;
+    run: () => Promise<void>;
+    transaction<T>(): Promise<T>;
+    close: () => Promise<void>;
+    private error;
+}
+/**
+ * DatabaseModule
+ *
+ * - Provides a database connection if enabled
+ * - Exports the IDatabase token
+ * - Falls back to NoopDatabase when disabled
+ */
+export declare class DatabaseModule implements AppModule<AppConfig> {
+    readonly exports: {
+        db: symbol;
+    };
+    register(ioc: IoCContainer, config: AppConfig): Promise<void>;
+}

package/lib/modules/database-module.js

@@ -0,0 +1,40 @@
+import { IDatabase, DBConnector } from '@kurdel/db';
+import { TOKENS } from '@kurdel/core/tokens';
+export class NoopDatabase {
+    constructor() {
+        this.query = this.error;
+        this.get = this.error;
+        this.all = this.error;
+        this.run = this.error;
+        this.close = this.error;
+    }
+    async transaction() {
+        throw new Error('Database is disabled (db=false in config)');
+    }
+    async error() {
+        throw new Error('Database is disabled (db=false in config)');
+    }
+}
+/**
+ * DatabaseModule
+ *
+ * - Provides a database connection if enabled
+ * - Exports the IDatabase token
+ * - Falls back to NoopDatabase when disabled
+ */
+export class DatabaseModule {
+    constructor() {
+        this.exports = { db: IDatabase };
+    }
+    async register(ioc, config) {
+        if (config.db === false) {
+            ioc.bind(IDatabase).toInstance(new NoopDatabase());
+            return;
+        }
+        const connector = new DBConnector();
+        const connection = await connector.run();
+        ioc.bind(IDatabase).toInstance(connection);
+        ioc.get(TOKENS.OnShutdown).push(() => connection.close());
+    }
+}
+//# sourceMappingURL=database-module.js.map

package/lib/modules/database-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-module.js","sourceRoot":"","sources":["../../src/modules/database-module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,OAAO,YAAY;IAAzB;QACE,UAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACnB,QAAG,GAAG,IAAI,CAAC,KAAK,CAAC;QACjB,QAAG,GAAG,IAAI,CAAC,KAAK,CAAC;QACjB,QAAG,GAAG,IAAI,CAAC,KAAK,CAAC;QAIjB,UAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAKrB,CAAC;IARC,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAGO,KAAK,CAAC,KAAK;QACjB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IAA3B;QACW,YAAO,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;IAavC,CAAC;IAXC,KAAK,CAAC,QAAQ,CAAC,GAAiB,EAAE,MAAiB;QACjD,IAAI,MAAM,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,WAAW,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC;QACzC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC3C,GAAG,CAAC,GAAG,CAAmB,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9E,CAAC;CACF"}

package/lib/modules/index.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/modules/index.js

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

package/lib/modules/index.js.map

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

package/lib/modules/lifecycle-module.d.ts

@@ -0,0 +1,9 @@
+import type { Container } from '@kurdel/ioc';
+import type { AppModule, AppConfig } from '@kurdel/core/app';
+export declare class LifecycleModule implements AppModule<AppConfig> {
+    readonly exports: {
+        onStart: import("@kurdel/ioc").InjectionToken<import("@kurdel/core/app").LifecycleHook[]>;
+        onShutdown: import("@kurdel/ioc").InjectionToken<import("@kurdel/core/app").LifecycleHook[]>;
+    };
+    register(ioc: Container): Promise<void>;
+}

package/lib/modules/lifecycle-module.js

@@ -0,0 +1,17 @@
+import { TOKENS } from '@kurdel/core/tokens';
+export class LifecycleModule {
+    constructor() {
+        this.exports = {
+            onStart: TOKENS.OnStart,
+            onShutdown: TOKENS.OnShutdown,
+        };
+    }
+    async register(ioc) {
+        // Initialize arrays only once; if already present, keep them
+        if (!ioc.has(TOKENS.OnStart))
+            ioc.set(TOKENS.OnStart, []);
+        if (!ioc.has(TOKENS.OnShutdown))
+            ioc.set(TOKENS.OnShutdown, []);
+    }
+}
+//# sourceMappingURL=lifecycle-module.js.map

package/lib/modules/lifecycle-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-module.js","sourceRoot":"","sources":["../../src/modules/lifecycle-module.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,OAAO,eAAe;IAA5B;QACW,YAAO,GAAG;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;IAOJ,CAAC;IALC,KAAK,CAAC,QAAQ,CAAC,GAAc;QAC3B,6DAA6D;QAC7D,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;CACF"}

package/lib/modules/middleware-module.d.ts

@@ -0,0 +1,18 @@
+import type { Container } from '@kurdel/ioc';
+import type { AppModule, ProviderConfig } from '@kurdel/core/app';
+import type { MiddlewareRegistration, MiddlewareRegistry } from '@kurdel/core/http';
+/**
+ * MiddlewareModule
+ *
+ * - Provides a singleton MiddlewareRegistry
+ * - Registers default global middlewares and app-provided ones
+ */
+export declare class MiddlewareModule implements AppModule {
+    private middlewares;
+    readonly exports: {
+        registry: import("@kurdel/ioc").InjectionToken<MiddlewareRegistry>;
+    };
+    readonly providers: ProviderConfig[];
+    constructor(middlewares: MiddlewareRegistration[]);
+    register(ioc: Container): Promise<void>;
+}

package/lib/modules/middleware-module.js

@@ -0,0 +1,45 @@
+import { TOKENS } from '@kurdel/core/tokens';
+import { RuntimeMiddlewareRegistry } from '../http/runtime-middleware-registry.js';
+import { errorHandler } from '../middlewares/error-handle.js';
+import { jsonBodyParser } from '../middlewares/json-body-parser.js';
+/**
+ * MiddlewareModule
+ *
+ * - Provides a singleton MiddlewareRegistry
+ * - Registers default global middlewares and app-provided ones
+ */
+export class MiddlewareModule {
+    constructor(middlewares) {
+        this.middlewares = middlewares;
+        this.exports = {
+            registry: TOKENS.MiddlewareRegistry,
+        };
+        this.providers = [
+            {
+                provide: TOKENS.MiddlewareRegistry,
+                useClass: RuntimeMiddlewareRegistry,
+                singleton: true,
+            },
+        ];
+    }
+    async register(ioc) {
+        const registry = ioc.get(TOKENS.MiddlewareRegistry);
+        // Recommended order:
+        // 1) parsers (json) → 2) user middlewares → 3) error handler (last)
+        registry.use(errorHandler, {
+            zone: 'pre',
+            priority: 0,
+        });
+        for (const entry of this.middlewares) {
+            registry.use(entry.use, {
+                zone: entry.zone,
+                priority: entry.priority,
+            });
+        }
+        registry.use(jsonBodyParser, {
+            zone: 'post',
+            priority: 0,
+        });
+    }
+}
+//# sourceMappingURL=middleware-module.js.map

package/lib/modules/middleware-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-module.js","sourceRoot":"","sources":["../../src/modules/middleware-module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAI7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAErE;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAa3B,YAAoB,WAAqC;QAArC,gBAAW,GAAX,WAAW,CAA0B;QAZhD,YAAO,GAAG;YACjB,QAAQ,EAAE,MAAM,CAAC,kBAAkB;SACpC,CAAC;QAEO,cAAS,GAAqB;YACrC;gBACE,OAAO,EAAE,MAAM,CAAC,kBAAkB;gBAClC,QAAQ,EAAE,yBAAyB;gBACnC,SAAS,EAAE,IAAI;aAChB;SACF,CAAC;IAE0D,CAAC;IAE7D,KAAK,CAAC,QAAQ,CAAC,GAAc;QAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAqB,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAExE,qBAAqB;QACrB,oEAAoE;QACpE,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE;YACzB,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE;YAC3B,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;IACL,CAAC;CACF"}

package/lib/modules/model-module.d.ts

@@ -0,0 +1,17 @@
+import type { IoCContainer } from '@kurdel/ioc';
+import type { AppModule, AppConfig } from '@kurdel/core/app';
+import type { ModelList } from '@kurdel/core/db';
+/**
+ * ModelModule
+ *
+ * - Registers models from all HttpModules
+ * - Models depend on IDatabase
+ */
+export declare class ModelModule implements AppModule<AppConfig> {
+    private models;
+    readonly imports: {
+        db: symbol;
+    };
+    constructor(models: ModelList);
+    register(ioc: IoCContainer): Promise<void>;
+}

package/lib/modules/model-module.js

@@ -0,0 +1,24 @@
+import { IDatabase } from '@kurdel/db';
+/**
+ * ModelModule
+ *
+ * - Registers models from all HttpModules
+ * - Models depend on IDatabase
+ */
+export class ModelModule {
+    constructor(models) {
+        this.models = models;
+        this.imports = { db: IDatabase };
+    }
+    async register(ioc) {
+        this.models.forEach(model => {
+            if ('use' in model) {
+                ioc.put(model.use).with({ db: IDatabase, ...model.deps });
+            }
+            else {
+                ioc.put(model).with({ db: IDatabase });
+            }
+        });
+    }
+}
+//# sourceMappingURL=model-module.js.map

package/lib/modules/model-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-module.js","sourceRoot":"","sources":["../../src/modules/model-module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIvC;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IAGtB,YAAoB,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;QAF5B,YAAO,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;IAEG,CAAC;IAEzC,KAAK,CAAC,QAAQ,CAAC,GAAiB;QAC9B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YAC1B,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;gBACnB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5D,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YACzC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/lib/modules/server-module.d.ts

@@ -0,0 +1,30 @@
+import type { Container } from '@kurdel/ioc';
+import { ModulePriority, type AppConfig, type AppModule } from '@kurdel/core/app';
+import type { ServerAdapter, Router, ControllerConfig, MiddlewareRegistry, ControllerResolver } from '@kurdel/core/http';
+/**
+ * ServerModule: wires the HTTP ServerAdapter to the Router.
+ *
+ * ## Responsibilities
+ * - Binds the platform-agnostic `ServerAdapter` (provided externally)
+ * - Initializes the `Router` with controller metadata and global middlewares
+ * - Creates the `RuntimeRequestOrchestrator` to handle per-request execution
+ * - Subscribes the orchestrator to incoming HTTP requests from the adapter
+ *
+ * ## Design Notes
+ * - The module itself contains **no platform-specific logic**
+ * - Orchestrator fully owns request lifecycle (scope, middleware, controller, render)
+ */
+export declare class ServerModule implements AppModule<AppConfig> {
+    readonly priority = ModulePriority.Server;
+    readonly imports: {
+        router: import("@kurdel/ioc").InjectionToken<Router>;
+        registry: import("@kurdel/ioc").InjectionToken<MiddlewareRegistry>;
+        controllerConfigs: import("@kurdel/ioc").InjectionToken<ControllerConfig[]>;
+        controllerResolver: import("@kurdel/ioc").InjectionToken<ControllerResolver>;
+        server: import("@kurdel/ioc").InjectionToken<ServerAdapter<import("@kurdel/common").HttpRequest, import("@kurdel/common").HttpResponse>>;
+    };
+    readonly exports: {
+        server: import("@kurdel/ioc").InjectionToken<ServerAdapter<import("@kurdel/common").HttpRequest, import("@kurdel/common").HttpResponse>>;
+    };
+    register(ioc: Container): Promise<void>;
+}

package/lib/modules/server-module.js

@@ -0,0 +1,65 @@
+import { ModulePriority } from '@kurdel/core/app';
+import { TOKENS } from '@kurdel/core/tokens';
+import { NoopResponseRenderer } from '../http/noop-response-renderer.js';
+import { RuntimeRequestOrchestrator } from '../http/runtime-request-orchestrator.js';
+/**
+ * ServerModule: wires the HTTP ServerAdapter to the Router.
+ *
+ * ## Responsibilities
+ * - Binds the platform-agnostic `ServerAdapter` (provided externally)
+ * - Initializes the `Router` with controller metadata and global middlewares
+ * - Creates the `RuntimeRequestOrchestrator` to handle per-request execution
+ * - Subscribes the orchestrator to incoming HTTP requests from the adapter
+ *
+ * ## Design Notes
+ * - The module itself contains **no platform-specific logic**
+ * - Orchestrator fully owns request lifecycle (scope, middleware, controller, render)
+ */
+export class ServerModule {
+    constructor() {
+        this.priority = ModulePriority.Server;
+        this.imports = {
+            router: TOKENS.Router,
+            registry: TOKENS.MiddlewareRegistry,
+            controllerConfigs: TOKENS.ControllerConfigs,
+            controllerResolver: TOKENS.ControllerResolver,
+            server: TOKENS.ServerAdapter,
+        };
+        this.exports = {
+            server: TOKENS.ServerAdapter,
+        };
+    }
+    async register(ioc) {
+        const adapter = ioc.get(TOKENS.ServerAdapter);
+        const router = ioc.get(TOKENS.Router);
+        const registry = ioc.get(TOKENS.MiddlewareRegistry);
+        const controllerConfigs = ioc.get(TOKENS.ControllerConfigs);
+        const resolver = ioc.get(TOKENS.ControllerResolver);
+        const renderer = ioc.get(TOKENS.ResponseRenderer);
+        // --- ensure a response renderer exists
+        if (!ioc.has(TOKENS.ResponseRenderer)) {
+            ioc.bind(TOKENS.ResponseRenderer).toInstance(new NoopResponseRenderer());
+        }
+        // --- initialize router once with all metadata
+        router.init(resolver, controllerConfigs);
+        // --- compose orchestrator for request lifecycle
+        const orchestrator = new RuntimeRequestOrchestrator(router, renderer, registry);
+        // --- connect adapter to orchestrator
+        adapter.on(async (req, res) => {
+            const scope = ioc.createScope?.() ?? ioc;
+            try {
+                await orchestrator.execute(req, res, scope);
+            }
+            catch (err) {
+                // fallback-level error safety
+                if (process.env.NODE_ENV !== 'test') {
+                    console.error(`[ServerModule] Uncaught error in orchestrator for ${req.method} ${req.url}:`, err);
+                }
+                if (res.statusCode !== 500)
+                    res.statusCode = 500;
+                renderer.render(res, { status: 500, kind: 'text', body: 'Internal Server Error' });
+            }
+        });
+    }
+}
+//# sourceMappingURL=server-module.js.map

package/lib/modules/server-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-module.js","sourceRoot":"","sources":["../../src/modules/server-module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAkC,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAU7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AAEtF;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,YAAY;IAAzB;QACW,aAAQ,GAAG,cAAc,CAAC,MAAM,CAAC;QAEjC,YAAO,GAAG;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,kBAAkB;YACnC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,MAAM,EAAE,MAAM,CAAC,aAAa;SAC7B,CAAC;QAEO,YAAO,GAAG;YACjB,MAAM,EAAE,MAAM,CAAC,aAAa;SAC7B,CAAC;IAwCJ,CAAC;IAtCC,KAAK,CAAC,QAAQ,CAAC,GAAc;QAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAgB,MAAM,CAAC,aAAa,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAqB,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACxE,MAAM,iBAAiB,GAAG,GAAG,CAAC,GAAG,CAAqB,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAChF,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAqB,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAmB,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAEpE,wCAAwC;QACxC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACtC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,UAAU,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,+CAA+C;QAC/C,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAEzC,iDAAiD;QACjD,MAAM,YAAY,GAAG,IAAI,0BAA0B,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEhF,sCAAsC;QACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,EAAE,IAAI,GAAG,CAAC;YAEzC,IAAI,CAAC;gBACH,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,8BAA8B;gBAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;oBACpC,OAAO,CAAC,KAAK,CACX,qDAAqD,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,EAC7E,GAAG,CACJ,CAAC;gBACJ,CAAC;gBACD,IAAK,GAAW,CAAC,UAAU,KAAK,GAAG;oBAAG,GAAW,CAAC,UAAU,GAAG,GAAG,CAAC;gBACnE,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC;YACrF,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/lib/template/ensure-template-engine-binding.d.ts

@@ -0,0 +1,2 @@
+import type { Container } from '@kurdel/ioc';
+export declare function ensureTemplateEngineBinding(ioc: Container): void;

package/lib/template/ensure-template-engine-binding.js

@@ -0,0 +1,8 @@
+import { TOKENS } from '@kurdel/core/tokens';
+import { NoopTemplateEngine } from '../template/noop-template-engine.js';
+export function ensureTemplateEngineBinding(ioc) {
+    if (!ioc.has(TOKENS.TemplateEngineToken)) {
+        ioc.bind(TOKENS.TemplateEngineToken).toInstance(new NoopTemplateEngine());
+    }
+}
+//# sourceMappingURL=ensure-template-engine-binding.js.map

package/lib/template/ensure-template-engine-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-template-engine-binding.js","sourceRoot":"","sources":["../../src/template/ensure-template-engine-binding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE1E,MAAM,UAAU,2BAA2B,CAAC,GAAc;IACxD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,UAAU,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC"}

package/lib/template/index.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/template/index.js

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

package/lib/template/index.js.map

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

package/lib/template/noop-template-engine.d.ts

@@ -0,0 +1,4 @@
+import type { TemplateEngine } from '@kurdel/core/template';
+export declare class NoopTemplateEngine implements TemplateEngine {
+    render(_t: string, _d: Record<string, unknown>): Promise<string>;
+}

package/lib/template/noop-template-engine.js

@@ -0,0 +1,6 @@
+export class NoopTemplateEngine {
+    async render(_t, _d) {
+        throw new Error('No template engine configured.');
+    }
+}
+//# sourceMappingURL=noop-template-engine.js.map