@venizia/ignis-kernel 0.2.0-0

package/dist/cjs/utilities/index.d.ts

@@ -0,0 +1,4 @@
+export * from './error.utility';
+export * from './jsx.utility';
+export * from './schema.utility';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/utilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/dist/cjs/utilities/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./error.utility"), exports);
+__exportStar(require("./jsx.utility"), exports);
+__exportStar(require("./schema.utility"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/utilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,gDAA8B;AAC9B,mDAAiC"}

package/dist/cjs/utilities/jsx.utility.d.ts

@@ -0,0 +1,49 @@
+import { z } from '@hono/zod-openapi';
+/** Creates HTML content configuration for OpenAPI documentation. */
+export declare const htmlContent: (opts: {
+    description: string;
+    required?: boolean;
+}) => {
+    description: string;
+    content: {
+        'text/html': {
+            schema: z.ZodString;
+        };
+    };
+    required: boolean;
+};
+/** Creates HTML response configuration for OpenAPI documentation. */
+export declare const htmlResponse: (opts: {
+    description: string;
+    required?: boolean;
+}) => {
+    200: {
+        description: string;
+        content: {
+            'text/html': {
+                schema: z.ZodString;
+            };
+        };
+        required: boolean;
+    };
+    "4xx | 5xx": {
+        description: string;
+        content: {
+            'application/json': {
+                schema: z.ZodObject<{
+                    statusCode: z.ZodOptional<z.ZodNumber>;
+                    message: z.ZodString;
+                    normalized: z.ZodOptional<z.ZodObject<{
+                        text: z.ZodString;
+                        code: z.ZodString;
+                        args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                    }, z.core.$strip>>;
+                    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                    requestId: z.ZodOptional<z.ZodString>;
+                    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                }, z.core.$strip>;
+            };
+        };
+    };
+};
+//# sourceMappingURL=jsx.utility.d.ts.map

package/dist/cjs/utilities/jsx.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/jsx.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAItC,oEAAoE;AACpE,eAAO,MAAM,WAAW,GAAI,MAAM;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;CAe5E,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,YAAY,GAAI,MAAM;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAe7E,CAAC"}

package/dist/cjs/utilities/jsx.utility.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.htmlResponse = exports.htmlContent = void 0;
+const zod_openapi_1 = require("@hono/zod-openapi");
+const common_1 = require("@venizia/ignis-helpers/common");
+const types_1 = require("../base/models/common/types");
+/** Creates HTML content configuration for OpenAPI documentation. */
+const htmlContent = (opts) => {
+    const { description } = opts;
+    return {
+        description,
+        content: {
+            'text/html': {
+                schema: zod_openapi_1.z.string().openapi({
+                    description: 'HTML content',
+                    example: '<!DOCTYPE html><html><head><title>Page</title></head><body>...</body></html>',
+                }),
+            },
+        },
+        required: opts?.required ?? false,
+    };
+};
+exports.htmlContent = htmlContent;
+/** Creates HTML response configuration for OpenAPI documentation. */
+const htmlResponse = (opts) => {
+    return {
+        [common_1.HTTP.ResultCodes.RS_2.Ok]: (0, exports.htmlContent)({
+            description: opts.description,
+            required: opts.required,
+        }),
+        ['4xx | 5xx']: {
+            description: 'Error Response',
+            content: {
+                'application/json': {
+                    schema: types_1.ErrorSchema,
+                },
+            },
+        },
+    };
+};
+exports.htmlResponse = htmlResponse;
+//# sourceMappingURL=jsx.utility.js.map

package/dist/cjs/utilities/jsx.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.utility.js","sourceRoot":"","sources":["../../../src/utilities/jsx.utility.ts"],"names":[],"mappings":";;;AAAA,mDAAsC;AACtC,0DAAqD;AACrD,sDAAyD;AAEzD,oEAAoE;AAC7D,MAAM,WAAW,GAAG,CAAC,IAAiD,EAAE,EAAE;IAC/E,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAE7B,OAAO;QACL,WAAW;QACX,OAAO,EAAE;YACP,WAAW,EAAE;gBACX,MAAM,EAAE,eAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC;oBACzB,WAAW,EAAE,cAAc;oBAC3B,OAAO,EAAE,8EAA8E;iBACxF,CAAC;aACH;SACF;QACD,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,KAAK;KAClC,CAAC;AACJ,CAAC,CAAC;AAfW,QAAA,WAAW,eAetB;AAEF,qEAAqE;AAC9D,MAAM,YAAY,GAAG,CAAC,IAAiD,EAAE,EAAE;IAChF,OAAO;QACL,CAAC,aAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAA,mBAAW,EAAC;YACtC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;QACF,CAAC,WAAW,CAAC,EAAE;YACb,WAAW,EAAE,gBAAgB;YAC7B,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,mBAAW;iBACpB;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC;AAfW,QAAA,YAAY,gBAevB"}

package/dist/cjs/utilities/schema.utility.d.ts

@@ -0,0 +1,10 @@
+import { z } from '@hono/zod-openapi';
+export declare const requiredString: (opts?: {
+    min?: number;
+    max?: number;
+    fixed?: number;
+}) => z.ZodString;
+export declare const AnyObjectSchema: z.ZodObject<{}, z.core.$catchall<z.ZodAny>>;
+export type TAnyObjectSchema = z.ZodObject<z.ZodRawShape>;
+export type TInferSchema<T extends z.ZodTypeAny> = z.infer<T>;
+//# sourceMappingURL=schema.utility.d.ts.map

package/dist/cjs/utilities/schema.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/schema.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC,eAAO,MAAM,cAAc,GAAI,OAAO;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,gBAiBnF,CAAC;AAEF,eAAO,MAAM,eAAe,6CAE1B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;AAC1D,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC"}

package/dist/cjs/utilities/schema.utility.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnyObjectSchema = exports.requiredString = void 0;
+const zod_openapi_1 = require("@hono/zod-openapi");
+const requiredString = (opts) => {
+    const { min, max, fixed } = opts ?? {};
+    let rs = zod_openapi_1.z.string().nonempty();
+    if (min) {
+        rs = rs.min(min);
+    }
+    if (max) {
+        rs = rs.max(max);
+    }
+    if (fixed) {
+        rs = rs.length(fixed);
+    }
+    return rs;
+};
+exports.requiredString = requiredString;
+exports.AnyObjectSchema = zod_openapi_1.z.object().catchall(zod_openapi_1.z.any()).openapi({
+    description: 'Unknown schema',
+});
+//# sourceMappingURL=schema.utility.js.map

package/dist/cjs/utilities/schema.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.utility.js","sourceRoot":"","sources":["../../../src/utilities/schema.utility.ts"],"names":[],"mappings":";;;AAAA,mDAAsC;AAE/B,MAAM,cAAc,GAAG,CAAC,IAAqD,EAAE,EAAE;IACtF,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IACvC,IAAI,EAAE,GAAG,eAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;IAE/B,IAAI,GAAG,EAAE,CAAC;QACR,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,IAAI,GAAG,EAAE,CAAC;QACR,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAjBW,QAAA,cAAc,kBAiBzB;AAEW,QAAA,eAAe,GAAG,eAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAC,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC;IAClE,WAAW,EAAE,gBAAgB;CAC9B,CAAC,CAAC"}

package/dist/esm/base/applications/abstract.d.ts

@@ -0,0 +1,38 @@
+import { Container } from '../../helpers/inversion/container.js';
+import type { ValueOrPromise } from '@venizia/ignis-helpers/common';
+import type { IApplicationConfigs, IApplicationInfo } from './types.js';
+export declare abstract class AbstractApplication extends Container {
+    protected configs: IApplicationConfigs;
+    protected projectRoot: string;
+    private postStartHooks;
+    private postStopHooks;
+    constructor(opts: {
+        scope: string;
+        config: IApplicationConfigs;
+    });
+    abstract getAppInfo(): ValueOrPromise<IApplicationInfo>;
+    abstract preConfigure(): ValueOrPromise<void>;
+    abstract postConfigure(): ValueOrPromise<void>;
+    abstract staticConfigure(): void;
+    abstract setupMiddlewares(opts?: {
+        middlewares?: Record<string | symbol, any>;
+    }): ValueOrPromise<void>;
+    abstract initialize(): Promise<void>;
+    protected getDefaultAsyncContextEnabled(): boolean;
+    getProjectConfigs(): IApplicationConfigs;
+    getProjectRoot(): string;
+    registerPostStartHook(opts: {
+        identifier: string;
+        hook: () => ValueOrPromise<void>;
+    }): void;
+    /** Runs every post-start hook in isolation - the server is already listening, so a throwing hook must not cancel the ones behind it; failures are collected and reported as one error at the end. */
+    protected executePostStartHooks(): Promise<void>;
+    registerPostStopHook(opts: {
+        identifier: string;
+        hook: () => ValueOrPromise<void>;
+    }): void;
+    protected executePostStopHooks(): Promise<void>;
+    protected registerCoreBindings(): void;
+    init(): void;
+}
+//# sourceMappingURL=abstract.d.ts.map

package/dist/esm/base/applications/abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../src/base/applications/abstract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAErE,8BAAsB,mBAAoB,SAAQ,SAAS;IACzD,SAAS,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACvC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;IAE9B,OAAO,CAAC,cAAc,CAAuE;IAC7F,OAAO,CAAC,aAAa,CAAuE;gBAEhF,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE;IAchE,QAAQ,CAAC,UAAU,IAAI,cAAc,CAAC,gBAAgB,CAAC;IACvD,QAAQ,CAAC,YAAY,IAAI,cAAc,CAAC,IAAI,CAAC;IAC7C,QAAQ,CAAC,aAAa,IAAI,cAAc,CAAC,IAAI,CAAC;IAE9C,QAAQ,CAAC,eAAe,IAAI,IAAI;IAEhC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;KAC5C,GAAG,cAAc,CAAC,IAAI,CAAC;IAExB,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEpC,SAAS,CAAC,6BAA6B,IAAI,OAAO;IAIlD,iBAAiB,IAAI,mBAAmB;IAIxC,cAAc,IAAI,MAAM;IAMxB,qBAAqB,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,CAAA;KAAE;IAOpF,qMAAqM;cACrL,qBAAqB;IAwCrC,oBAAoB,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,CAAA;KAAE;cAOnE,oBAAoB;IAWpC,SAAS,CAAC,oBAAoB;IAM9B,IAAI;CAGL"}

package/dist/esm/base/applications/abstract.js

@@ -0,0 +1,92 @@
+import { CoreBindings } from '../../common/bindings.js';
+import { Container } from '../../helpers/inversion/container.js';
+import { getError } from '@venizia/ignis-helpers/core';
+import { HTTP } from '@venizia/ignis-helpers/common';
+export class AbstractApplication extends Container {
+    constructor(opts) {
+        const { scope, config } = opts;
+        super({ scope });
+        this.postStartHooks = [];
+        this.postStopHooks = [];
+        this.configs = Object.assign({}, config, {
+            asyncContext: {
+                enable: config?.asyncContext?.enable ?? this.getDefaultAsyncContextEnabled(),
+            },
+        });
+        this.projectRoot = this.getProjectRoot();
+        this.logger.for('constructor').info('Project root: %s', this.projectRoot);
+    }
+    getDefaultAsyncContextEnabled() {
+        return false;
+    }
+    getProjectConfigs() {
+        return this.configs;
+    }
+    getProjectRoot() {
+        const projectRoot = '';
+        this.bind({ key: CoreBindings.APPLICATION_PROJECT_ROOT }).toValue(projectRoot);
+        return projectRoot;
+    }
+    registerPostStartHook(opts) {
+        this.postStartHooks.push(opts);
+        this.logger
+            .for(this.registerPostStartHook.name)
+            .debug('Registered post-start hook | identifier: %s', opts.identifier);
+    }
+    /** Runs every post-start hook in isolation - the server is already listening, so a throwing hook must not cancel the ones behind it; failures are collected and reported as one error at the end. */
+    async executePostStartHooks() {
+        if (this.postStartHooks.length === 0) {
+            return;
+        }
+        const logger = this.logger.for(this.executePostStartHooks.name);
+        logger.info('Executing %s post-start hook(s)...', this.postStartHooks.length);
+        const failures = [];
+        for (const { identifier, hook } of this.postStartHooks) {
+            const t = performance.now();
+            try {
+                await hook();
+            }
+            catch (error) {
+                logger.error('Failed to execute hook | identifier: %s | error: %s', identifier, error);
+                failures.push({ identifier, error });
+                continue;
+            }
+            logger.info('Executed hook | identifier: %s | took: %s (ms)', identifier, performance.now() - t);
+        }
+        if (failures.length === 0) {
+            return;
+        }
+        throw getError({
+            statusCode: HTTP.ResultCodes.RS_5.InternalServerError,
+            message: `[executePostStartHooks] Failed post-start hook(s): ${failures
+                .map(failure => `${failure.identifier} (${failure.error})`)
+                .join(', ')}`,
+        });
+    }
+    registerPostStopHook(opts) {
+        this.postStopHooks.push(opts);
+        this.logger
+            .for(this.registerPostStopHook.name)
+            .debug('Registered post-stop hook | identifier: %s', opts.identifier);
+    }
+    async executePostStopHooks() {
+        const logger = this.logger.for(this.executePostStopHooks.name);
+        for (const { identifier, hook } of this.postStopHooks) {
+            try {
+                await hook();
+            }
+            catch (error) {
+                logger.error('Post-stop hook failed | identifier: %s | error: %s', identifier, error);
+            }
+        }
+    }
+    registerCoreBindings() {
+        this.bind({
+            key: CoreBindings.APPLICATION_INSTANCE,
+        }).toProvider(_ => this);
+    }
+    init() {
+        this.registerCoreBindings();
+    }
+}
+//# sourceMappingURL=abstract.js.map

package/dist/esm/base/applications/abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/base/applications/abstract.ts"],"names":[],"mappings":"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"}

package/dist/esm/base/applications/index.d.ts

@@ -0,0 +1,4 @@
+export * from './abstract.js';
+export * from './rest.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/base/applications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/base/applications/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/esm/base/applications/index.js

@@ -0,0 +1,4 @@
+export * from './abstract.js';
+export * from './rest.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/base/applications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/applications/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/esm/base/applications/rest.d.ts

@@ -0,0 +1,83 @@
+import type { TBindingNamespace } from '../../common/bindings.js';
+import type { Binding } from '../../helpers/inversion/index.js';
+import type { BaseComponent } from '../components/index.js';
+import type { IDataSource } from '../datasources/index.js';
+import type { IRepository } from '../repositories/index.js';
+import type { IService } from '../services/index.js';
+import type { TMixinOpts } from '../mixins/types.js';
+import { OpenAPIHono } from '@hono/zod-openapi';
+import type { AnyObject, IConfigurable, TClass, ValueOrPromise } from '@venizia/ignis-helpers/common';
+import { RequestIdGenerator } from '@venizia/ignis-helpers/core';
+import type { Env, Schema } from 'hono';
+import { BaseAppErrorMiddleware } from '../middlewares/app-error/app-error.middleware.js';
+import { AbstractApplication } from './abstract.js';
+import type { IApplicationConfigs } from './types.js';
+interface IRegisterDynamicBindingsOptions<T extends IConfigurable = IConfigurable> {
+    namespace: TBindingNamespace;
+    onBeforeConfigure?: (opts: {
+        binding: Binding<T>;
+    }) => Promise<void>;
+    onAfterConfigure?: (opts: {
+        binding: Binding<T>;
+        instance: T;
+    }) => Promise<void>;
+}
+/** Adds the `OpenAPIHono` router surface on top of `AbstractApplication` - no listening server, so this is the layer a browser Worker or gRPC-only host can extend without pulling in `Bun.serve` / `@hono/node-server`. */
+export declare abstract class RestApplication<AppEnv extends Env = Env, AppSchema extends Schema = {}, BasePath extends string = '/'> extends AbstractApplication {
+    private registeredBindings;
+    /** The router, and nothing else. What runtime is underneath and what socket is bound are `ServerApplication`'s to know - a browser Worker has neither, and carrying the union here made `RuntimeModules.detect()` answer `'node'` inside a Worker. */
+    protected server: {
+        hono: OpenAPIHono<AppEnv, AppSchema, BasePath>;
+    };
+    protected rootRouter: OpenAPIHono<AppEnv, AppSchema, BasePath>;
+    protected readonly requestIdGenerator: RequestIdGenerator;
+    constructor(opts: {
+        scope: string;
+        config: IApplicationConfigs;
+    });
+    getRootRouter(): OpenAPIHono<AppEnv, AppSchema, BasePath>;
+    getServer(): OpenAPIHono<AppEnv, AppSchema, BasePath>;
+    protected registerCoreBindings(): void;
+    /** The correlation id every host stamps - see {@link RequestIdGenerator} for why `crypto.randomUUID` is refused. */
+    protected generateRequestId(): string;
+    /** The error handler the default stack installs. `@venizia/ignis` overrides it to swap in the `ErrorPrettier`-backed formatter, which reaches `node:util` and so cannot live here. */
+    protected buildErrorMiddleware(): BaseAppErrorMiddleware;
+    /**
+     * The three registrations every host needs, in one place, so a server and a browser Worker cannot
+     * drift: a request id, the framework's error envelope, and a JSON 404.
+     *
+     * None is optional. Hono's own defaults answer a thrown `ApplicationError` with a generic 500 and
+     * an unrouted path with `text/plain` - a caller doing `response.json()` on that 404 gets a
+     * `SyntaxError` instead of an error envelope. And without `requestId()`, `context.get(REQUEST_ID_KEY)`
+     * is `undefined`, so `context.json` drops the one field that ties a response to a log line.
+     *
+     * Registered before `initialize()`, so an application installing its own handlers still wins.
+     */
+    protected registerDefaultMiddlewares(): ValueOrPromise<void>;
+    /**
+     * The artifact ordering, stated ONCE: datasources before repositories can auto-resolve them, and
+     * components before controllers because a component may contribute either.
+     *
+     * A browser Worker application inherits this and writes none of it. `BaseApplication` in
+     * `@venizia/ignis` is the one deliberate override - it interleaves phases only a server has
+     * (start-up banner, env validation, secret hydration and rotation) between these steps.
+     */
+    initialize(): Promise<void>;
+    protected inspectRoutes(): void;
+    protected registerDynamicBindings<T extends IConfigurable = IConfigurable>(opts: IRegisterDynamicBindingsOptions<T>): Promise<void>;
+    component<Base extends BaseComponent, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
+    registerComponents(): Promise<void>;
+    /**
+     * Handles the REST branch only - the kernel has no notion of gRPC (it reaches `node:module` via
+     * `AbstractGrpcController`, core-only). `BaseApplication` extends this with the gRPC branch, the
+     * unsupported-transport error and the orphaned-gRPC-controller warning.
+     */
+    registerControllers(): Promise<void>;
+    controller<Base, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
+    service<Base extends IService, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
+    repository<Base extends IRepository, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
+    dataSource<Base extends IDataSource, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
+    registerDataSources(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=rest.d.ts.map

package/dist/esm/base/applications/rest.d.ts.map

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