@venizia/ignis 0.4.2 → 0.4.4

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@venizia/ignis",
-  "version": "0.4.2",
-  "description": "High-performance TypeScript server infrastructure combining LoopBack 4 enterprise architecture (decorator-based DI, repository pattern, component system) with Hono speed (~140k req/s). Features auto-generated OpenAPI docs, Drizzle ORM type-safe SQL, JWT/Basic authentication, Casbin authorization, convention-based bootstrapping, and pluggable components for health checks, Swagger UI, mail, Socket.IO, and static assets. Built for Bun and Node.js.",
+  "version": "0.4.4",
+  "description": "TypeScript server framework with decorator-based DI, the repository pattern and a component system, on Hono. Features auto-generated OpenAPI docs, Drizzle ORM type-safe SQL, JWT/Basic authentication, Casbin authorization, convention-based bootstrapping, and pluggable components for health checks, Swagger UI, mail, Socket.IO, and static assets. Built for Bun and Node.js.",
   "keywords": [
     "access-control",
     "amazon-ses",
@@ -36,13 +36,10 @@
     "ioc",
     "jose",
     "jwt",
-    "loopback",
-    "loopback4",
     "mail",
     "middleware",
     "mixin",
     "model",
-    "nestjs-alternative",
     "nodejs",
     "nodemailer",
     "openapi",
@@ -100,85 +97,84 @@
   "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+      "types": "./dist/esm/index.d.ts",
+      "default": "./dist/esm/index.js"
     },
     "./postgres": {
-      "types": "./dist/connectors/postgres/index.d.ts",
-      "default": "./dist/connectors/postgres/index.js"
+      "types": "./dist/esm/connectors/postgres/index.d.ts",
+      "default": "./dist/esm/connectors/postgres/index.js"
     },
     "./relational": {
-      "types": "./dist/connectors/relational/index.d.ts",
-      "default": "./dist/connectors/relational/index.js"
+      "types": "./dist/esm/connectors/relational/index.d.ts",
+      "default": "./dist/esm/connectors/relational/index.js"
     },
     "./postgres/node-postgres": {
-      "types": "./dist/connectors/postgres/drivers/node-postgres.d.ts",
-      "default": "./dist/connectors/postgres/drivers/node-postgres.js"
+      "types": "./dist/esm/connectors/postgres/drivers/node-postgres.d.ts",
+      "default": "./dist/esm/connectors/postgres/drivers/node-postgres.js"
     },
     "./postgres/postgres-js": {
-      "types": "./dist/connectors/postgres/drivers/postgres-js.d.ts",
-      "import": "./dist/connectors/postgres/drivers/postgres-js.mjs",
-      "default": "./dist/connectors/postgres/drivers/postgres-js.js"
+      "types": "./dist/esm/connectors/postgres/drivers/postgres-js.d.ts",
+      "default": "./dist/esm/connectors/postgres/drivers/postgres-js.js"
     },
     "./postgres/pglite": {
-      "types": "./dist/connectors/postgres/drivers/pglite.d.ts",
-      "default": "./dist/connectors/postgres/drivers/pglite.js"
+      "types": "./dist/esm/connectors/postgres/drivers/pglite.d.ts",
+      "default": "./dist/esm/connectors/postgres/drivers/pglite.js"
     },
     "./postgres/supabase": {
-      "types": "./dist/connectors/postgres/supabase/index.d.ts",
-      "default": "./dist/connectors/postgres/supabase/index.js"
+      "types": "./dist/esm/connectors/postgres/supabase/index.d.ts",
+      "default": "./dist/esm/connectors/postgres/supabase/index.js"
     },
     "./sqlite": {
-      "types": "./dist/connectors/sqlite/index.d.ts",
-      "default": "./dist/connectors/sqlite/index.js"
+      "types": "./dist/esm/connectors/sqlite/index.d.ts",
+      "default": "./dist/esm/connectors/sqlite/index.js"
     },
     "./sqlite/libsql": {
-      "types": "./dist/connectors/sqlite/drivers/libsql.d.ts",
-      "default": "./dist/connectors/sqlite/drivers/libsql.js"
+      "types": "./dist/esm/connectors/sqlite/drivers/libsql.d.ts",
+      "default": "./dist/esm/connectors/sqlite/drivers/libsql.js"
     },
     "./search": {
-      "types": "./dist/connectors/search/index.d.ts",
-      "default": "./dist/connectors/search/index.js"
+      "types": "./dist/esm/connectors/search/index.d.ts",
+      "default": "./dist/esm/connectors/search/index.js"
     },
     "./search/controllers": {
-      "types": "./dist/connectors/search/controllers/index.d.ts",
-      "default": "./dist/connectors/search/controllers/index.js"
+      "types": "./dist/esm/connectors/search/controllers/index.d.ts",
+      "default": "./dist/esm/connectors/search/controllers/index.js"
     },
     "./meilisearch": {
-      "types": "./dist/connectors/meilisearch/index.d.ts",
-      "default": "./dist/connectors/meilisearch/index.js"
+      "types": "./dist/esm/connectors/meilisearch/index.d.ts",
+      "default": "./dist/esm/connectors/meilisearch/index.js"
     },
     "./socket-io": {
-      "types": "./dist/components/socket-io/index.d.ts",
-      "default": "./dist/components/socket-io/index.js"
+      "types": "./dist/esm/components/socket-io/index.d.ts",
+      "default": "./dist/esm/components/socket-io/index.js"
     },
     "./mail": {
-      "types": "./dist/components/mail/index.d.ts",
-      "default": "./dist/components/mail/index.js"
+      "types": "./dist/esm/components/mail/index.d.ts",
+      "default": "./dist/esm/components/mail/index.js"
     },
     "./grpc": {
-      "types": "./dist/components/controller/grpc/index.d.ts",
-      "default": "./dist/components/controller/grpc/index.js"
+      "types": "./dist/esm/components/controller/grpc/index.d.ts",
+      "default": "./dist/esm/components/controller/grpc/index.js"
     },
     "./static-asset": {
-      "types": "./dist/components/static-asset/index.d.ts",
-      "default": "./dist/components/static-asset/index.js"
+      "types": "./dist/esm/components/static-asset/index.d.ts",
+      "default": "./dist/esm/components/static-asset/index.js"
     },
     "./websocket": {
-      "types": "./dist/components/websocket/index.d.ts",
-      "default": "./dist/components/websocket/index.js"
+      "types": "./dist/esm/components/websocket/index.d.ts",
+      "default": "./dist/esm/components/websocket/index.js"
     },
     "./typesense": {
-      "types": "./dist/connectors/typesense/index.d.ts",
-      "default": "./dist/connectors/typesense/index.js"
+      "types": "./dist/esm/connectors/typesense/index.d.ts",
+      "default": "./dist/esm/connectors/typesense/index.js"
     },
     "./typesense/controllers": {
-      "types": "./dist/connectors/typesense/controllers/index.d.ts",
-      "default": "./dist/connectors/typesense/controllers/index.js"
+      "types": "./dist/esm/connectors/typesense/controllers/index.d.ts",
+      "default": "./dist/esm/connectors/typesense/controllers/index.js"
     },
     "./testing": {
-      "types": "./dist/testing/index.d.ts",
-      "default": "./dist/testing/index.js"
+      "types": "./dist/esm/testing/index.d.ts",
+      "default": "./dist/esm/testing/index.js"
     },
     "./package.json": "./package.json"
   },
@@ -191,26 +187,25 @@
     "prepublishOnly": "make rebuild"
   },
   "dependencies": {
-    "@venizia/ignis-connectors": "0.4.2",
-    "@venizia/ignis-filter": "0.4.2",
-    "@venizia/ignis-helpers": "0.4.2",
-    "@venizia/ignis-inversion": "0.4.2",
-    "@venizia/ignis-kernel": "0.4.2",
+    "@venizia/ignis-connectors": "0.4.4",
+    "@venizia/ignis-filter": "0.4.4",
+    "@venizia/ignis-helpers": "0.4.4",
+    "@venizia/ignis-inversion": "0.4.4",
+    "@venizia/ignis-kernel": "0.4.4",
     "reflect-metadata": "^0.2.2"
   },
   "devDependencies": {
     "@asteasolutions/zod-to-openapi": "^9.1.0",
     "@connectrpc/connect": "^2.2.0",
     "@electric-sql/pglite": "^0.5.10",
-    "@hono/node-server": "^2.1.5",
     "@hono/swagger-ui": "^0.6.1",
     "@libsql/client": "^0.17.4",
     "@socket.io/bun-engine": "^0.1.2",
     "@types/bun": "^1.4.3",
     "@types/nodemailer": "^8.0.2",
     "@types/pg": "^8.23.1",
-    "@venizia/dev-configs": "0.4.2",
-    "@venizia/ignis-boot": "0.4.2",
+    "@venizia/dev-configs": "0.4.4",
+    "@venizia/ignis-boot": "0.4.4",
     "casbin": "^5.51.1",
     "eslint": "^10.13.0",
     "meilisearch": "^0.62.0",
@@ -226,7 +221,6 @@
     "@aws-sdk/client-sesv2": "^3.1154.0",
     "@connectrpc/connect": "^2.2.0",
     "@electric-sql/pglite": "^0.5.10",
-    "@hono/node-server": "^2.1.5",
     "@hono/swagger-ui": "^0.6.1",
     "@hono/zod-openapi": "^1.6.3",
     "@libsql/client": "^0.17.4",
@@ -259,9 +253,6 @@
     "@electric-sql/pglite": {
       "optional": true
     },
-    "@hono/node-server": {
-      "optional": true
-    },
     "@hono/swagger-ui": {
       "optional": true
     },

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

@@ -1,62 +0,0 @@
-import type { ILogger } from '@venizia/ignis-helpers/core';
-import type { ValueOrPromise } from '@venizia/ignis-helpers/common';
-import type { ISecretHydrateEntry, ISecretsHelper, ISecretsRegistration } from '@venizia/ignis-helpers';
-import { AppErrorMiddleware } from '../middlewares';
-import { ServerApplication } from './server';
-import type { IRestApplication } from '@venizia/ignis-kernel';
-import type { IBootSequenceStep } from '@venizia/ignis-kernel';
-export declare abstract class BaseApplication extends ServerApplication implements IRestApplication {
-    protected secretsProvider?: ISecretsHelper;
-    protected secretsRegistration?: ISecretsRegistration;
-    protected normalizePath(...segments: string[]): string;
-    /** Adds the gRPC branch the kernel cannot own: `GrpcComponent` needs `AbstractGrpcController`, core-only code that reaches `node:module`. */
-    registerControllers(): Promise<void>;
-    registerSecrets(): ValueOrPromise<ISecretsRegistration>;
-    hydrateSecrets(): Promise<void>;
-    /** Applies each hydrate entry in declaration order; paths that resolve empty while declaring an expectation are collected in `emptyHydrations` rather than failing here. */
-    protected hydrateSecretEntries(opts: {
-        provider: ISecretsHelper;
-        registration: ISecretsRegistration;
-        emptyHydrations: string[];
-        logger: ILogger;
-    }): Promise<void>;
-    protected mergeSecretsIntoEnv(opts: {
-        bundle: Record<string, string>;
-        entry: ISecretHydrateEntry;
-    }): Record<string, string>;
-    /** A hydrate entry declares an expectation only via explicit `keys` or a non-empty `prefix`; such an entry resolving to zero env values is a misconfiguration boot must not silently absorb. */
-    protected hydrateEntryDeclaresExpectation(opts: {
-        entry: ISecretHydrateEntry;
-    }): boolean;
-    wireSecretRotatables(): Promise<void>;
-    static(opts: {
-        restPath?: string;
-        folderPath: string;
-    }): this;
-    /**
-     * Every value is read HERE, not destructured at module load: an application that loads its
-     * `.env` in its own entrypoint does so after this module is imported, and a module-load snapshot
-     * would print the defaults for a host that configured everything correctly.
-     */
-    protected printStartUpInfo(opts: {
-        scope: string;
-    }): void;
-    /** Swaps in the `ErrorPrettier`-backed formatter - `node:util`, so the kernel cannot build it. */
-    protected buildErrorMiddleware(): AppErrorMiddleware;
-    /** Adds what only a listening server has, on top of the kernel's three - which stay in `RestApplication` so a browser Worker answers with the same envelope. */
-    protected registerDefaultMiddlewares(): Promise<void>;
-    /** Lives here rather than on `AbstractApplication` - `applicationEnvironment` reads `process.env` at module load, so a kernel-pure ancestor cannot carry it; this is the layer that already depends on it. */
-    protected validateEnvs(): void;
-    /**
-     * Version tripwire, body identical to `RestApplication.initialize()`: a stale kernel without
-     * `getBootSequence()`/`runBootSequence()` throws here before any socket binds.
-     */
-    initialize(): Promise<void>;
-    protected getBootSequence(): IBootSequenceStep[];
-    /**
-     * Refuses to start when a model's `settings.access` cannot take effect. Both failures are
-     * silent at runtime and opposite: a search-backed model returns too many rows, a context-less one none.
-     */
-    protected validateScopeFilterSupport(): void;
-}
-//# sourceMappingURL=base.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/base/applications/base.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EACV,mBAAmB,EAEnB,cAAc,EACd,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAYhC,OAAO,EAAE,kBAAkB,EAAgB,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAgC/D,8BAAsB,eAAgB,SAAQ,iBAAkB,YAAW,gBAAgB;IACzF,SAAS,CAAC,eAAe,CAAC,EAAE,cAAc,CAAC;IAC3C,SAAS,CAAC,mBAAmB,CAAC,EAAE,oBAAoB,CAAC;IAErD,SAAS,CAAC,aAAa,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAKtD,6IAA6I;IAC9H,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuDnD,eAAe,IAAI,cAAc,CAAC,oBAAoB,CAAC;IAIjD,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAwErC,4KAA4K;cAC5J,oBAAoB,CAAC,IAAI,EAAE;QACzC,QAAQ,EAAE,cAAc,CAAC;QACzB,YAAY,EAAE,oBAAoB,CAAC;QACnC,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,MAAM,EAAE,OAAO,CAAC;KACjB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBjB,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE;QAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,KAAK,EAAE,mBAAmB,CAAC;KAC5B,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAY1B,gMAAgM;IAChM,SAAS,CAAC,+BAA+B,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,mBAAmB,CAAA;KAAE,GAAG,OAAO;IAQlF,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3C,MAAM,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAwCtD;;;;OAIG;IACH,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;IAgClD,kGAAkG;cAC/E,oBAAoB,IAAI,kBAAkB;IAO7D,gKAAgK;cACvI,0BAA0B;IA4BnD,8MAA8M;IAC9M,SAAS,CAAC,YAAY;IAmDtB;;;OAGG;IACY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;cAIvB,eAAe,IAAI,iBAAiB,EAAE;IAyCzD;;;OAGG;IACH,SAAS,CAAC,0BAA0B,IAAI,IAAI;CAG7C"}

package/dist/base/applications/base.js

@@ -1,367 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseApplication = void 0;
-const ignis_connectors_1 = require("@venizia/ignis-connectors");
-const ignis_kernel_1 = require("@venizia/ignis-kernel");
-const ignis_kernel_2 = require("@venizia/ignis-kernel");
-const environments_1 = require("../../common/environments");
-const components_1 = require("../../components");
-const grpc_1 = require("../../components/controller/grpc");
-const ignis_kernel_3 = require("@venizia/ignis-kernel");
-const core_1 = require("@venizia/ignis-helpers/core");
-const common_1 = require("@venizia/ignis-helpers/common");
-const ignis_helpers_1 = require("@venizia/ignis-helpers");
-const context_storage_1 = require("hono/context-storage");
-const middlewares_1 = require("../middlewares");
-const boot_steps_1 = require("./boot-steps");
-const server_1 = require("./server");
-/** Maps a secret bundle to env names: the explicit `keys` mapping when present, otherwise every bundle key under `prefix`. */
-const selectSecretEnvKeys = (opts) => {
-    const { bundle, entry } = opts;
-    const merged = {};
-    if (!entry.keys) {
-        const bundleEntries = Object.entries(bundle);
-        for (const [rawKey, value] of bundleEntries) {
-            merged[`${entry.prefix ?? ''}${rawKey}`] = value;
-        }
-        return merged;
-    }
-    const entryKeysEntries = Object.entries(entry.keys);
-    for (const [rawKey, envKey] of entryKeysEntries) {
-        const value = bundle[rawKey];
-        if (value === undefined) {
-            continue;
-        }
-        merged[envKey] = value;
-    }
-    return merged;
-};
-class BaseApplication extends server_1.ServerApplication {
-    normalizePath(...segments) {
-        const joined = segments.join('/').replace(/\/+/g, '/').replace(/\/$/, '');
-        return joined || '/';
-    }
-    /** Adds the gRPC branch the kernel cannot own: `GrpcComponent` needs `AbstractGrpcController`, core-only code that reaches `node:module`. */
-    async registerControllers() {
-        await super.registerControllers();
-        await (0, ignis_helpers_1.executeWithPerformanceMeasure)({
-            logger: this.logger,
-            description: 'Register application gRPC controllers',
-            scope: this.registerControllers.name,
-            task: async () => {
-                const transports = this.configs.transports ?? [ignis_kernel_1.ControllerTransports.REST];
-                for (const transport of transports) {
-                    if (transport === ignis_kernel_1.ControllerTransports.REST) {
-                        continue;
-                    }
-                    if (transport !== ignis_kernel_1.ControllerTransports.GRPC) {
-                        throw (0, core_1.getError)({
-                            statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
-                            message: `[registerControllers] Unsupported transport: '${transport}'`,
-                        });
-                    }
-                    const grpcComponent = new grpc_1.GrpcComponent(this);
-                    await grpcComponent.configure();
-                }
-                // Warn if gRPC controllers exist but gRPC transport is not enabled
-                if (transports.includes(ignis_kernel_1.ControllerTransports.GRPC)) {
-                    return;
-                }
-                const allBindings = this.findByTag({ tag: ignis_kernel_2.BindingNamespaces.CONTROLLER });
-                for (const binding of allBindings) {
-                    const target = binding.getBindingMeta({ type: ignis_kernel_3.BindingValueTypes.CLASS });
-                    if (!target) {
-                        continue;
-                    }
-                    const metadata = ignis_kernel_3.MetadataRegistry.getInstance().getControllerMetadata({ target });
-                    if (metadata?.transport !== ignis_kernel_1.ControllerTransports.GRPC) {
-                        continue;
-                    }
-                    this.logger
-                        .for(this.registerControllers.name)
-                        .error('gRPC controller "%s" discovered but gRPC transport is not enabled. Add "%s" to transports config.', binding.key, ignis_kernel_1.ControllerTransports.GRPC);
-                }
-            },
-        });
-    }
-    registerSecrets() {
-        return { provider: ignis_helpers_1.SecretProviders.SYSTEM_ENVS };
-    }
-    async hydrateSecrets() {
-        const logger = this.logger.for(this.hydrateSecrets.name);
-        const registration = await this.registerSecrets();
-        let provider;
-        const emptyHydrations = [];
-        try {
-            provider = await (0, ignis_helpers_1.createSecretsHelper)({ ...registration, identifier: 'app' });
-            await provider.configure();
-            await this.hydrateSecretEntries({ provider, registration, emptyHydrations, logger });
-            const registrationLease = registration.lease ?? [];
-            for (const entry of registrationLease) {
-                await provider.lease({ path: entry.path, key: entry.key });
-            }
-        }
-        catch (error) {
-            const env = ignis_helpers_1.Environment.current;
-            if (!ignis_helpers_1.Environment.DEVELOPMENT_ENVS.has(env.toLowerCase())) {
-                throw (0, core_1.getError)({
-                    message: `[hydrateSecrets] Secret provider failed in non-development environment | env: ${env}`,
-                });
-            }
-            logger.warn('Secret provider failed; falling back to system-envs | env: %s | error: %s', env, error);
-            if (provider) {
-                await provider
-                    .shutdown()
-                    .catch((shutdownError) => logger.error('Failed to shut down partially-built provider during fallback | error: %s', shutdownError));
-            }
-            provider = await (0, ignis_helpers_1.createSecretsHelper)({
-                provider: ignis_helpers_1.SecretProviders.SYSTEM_ENVS,
-                identifier: 'app',
-            });
-        }
-        if (!provider) {
-            throw (0, core_1.getError)({ message: '[hydrateSecrets] No secrets provider resolved' });
-        }
-        if (emptyHydrations.length > 0) {
-            const env = ignis_helpers_1.Environment.current;
-            if (!ignis_helpers_1.Environment.DEVELOPMENT_ENVS.has(env.toLowerCase())) {
-                throw (0, core_1.getError)({
-                    message: `[hydrateSecrets] Hydrate entries resolved to an empty secret bundle in non-development environment | env: ${env} | paths: ${emptyHydrations.join(', ')}`,
-                });
-            }
-            logger.warn('Hydrate entries resolved to an empty secret bundle; continuing in development | env: %s | paths: %s', env, emptyHydrations.join(', '));
-        }
-        this.bind({ key: ignis_kernel_2.CoreBindings.APPLICATION_CONFIG })
-            .toProvider(() => provider)
-            .setScope(ignis_kernel_3.BindingScopes.SINGLETON);
-        this.registerPostStopHook({ identifier: 'secrets.shutdown', hook: () => provider.shutdown() });
-        this.secretsProvider = provider;
-        this.secretsRegistration = registration;
-    }
-    /** Applies each hydrate entry in declaration order; paths that resolve empty while declaring an expectation are collected in `emptyHydrations` rather than failing here. */
-    async hydrateSecretEntries(opts) {
-        const { provider, registration, emptyHydrations, logger } = opts;
-        const registrationHydrate = registration.hydrate ?? [];
-        for (const entry of registrationHydrate) {
-            const bundle = await provider.getBundle({ path: entry.path });
-            const merged = this.mergeSecretsIntoEnv({ bundle, entry });
-            if (Object.keys(merged).length > 0) {
-                continue;
-            }
-            if (this.hydrateEntryDeclaresExpectation({ entry })) {
-                emptyHydrations.push(entry.path);
-                continue;
-            }
-            logger.warn('Hydrate entry resolved to an empty bundle and declares no expected keys | path: %s', entry.path);
-        }
-    }
-    mergeSecretsIntoEnv(opts) {
-        const { bundle, entry } = opts;
-        const merged = selectSecretEnvKeys({ bundle, entry });
-        const mergedEntries = Object.entries(merged);
-        for (const [key, value] of mergedEntries) {
-            process.env[key] = value;
-        }
-        ignis_helpers_1.applicationEnvironment.merge({ envs: merged });
-        return merged;
-    }
-    /** A hydrate entry declares an expectation only via explicit `keys` or a non-empty `prefix`; such an entry resolving to zero env values is a misconfiguration boot must not silently absorb. */
-    hydrateEntryDeclaresExpectation(opts) {
-        const { entry } = opts;
-        if (entry.keys && Object.keys(entry.keys).length > 0) {
-            return true;
-        }
-        return typeof entry.prefix === 'string' && entry.prefix.length > 0;
-    }
-    async wireSecretRotatables() {
-        const logger = this.logger.for(this.wireSecretRotatables.name);
-        const provider = this.secretsProvider;
-        const registration = this.secretsRegistration;
-        if (!provider || !registration?.lease?.length) {
-            return;
-        }
-        for (const entry of registration.lease) {
-            const instance = this.get({ key: entry.key, isOptional: true });
-            if (instance && typeof instance.onSecretRotated === 'function') {
-                provider.registerRotatable({ key: entry.key, target: instance });
-                logger.info('Wired rotatable | key: %s', entry.key);
-                continue;
-            }
-            logger.debug('Lease key has no rotatable consumer | key: %s', entry.key);
-        }
-    }
-    static(opts) {
-        const { restPath = '*', folderPath } = opts;
-        const server = this.getServer();
-        switch (this.runtime) {
-            case common_1.RuntimeModules.BUN: {
-                const { serveStatic } = require('hono/bun');
-                server.use(restPath, serveStatic({ root: folderPath }));
-                break;
-            }
-            case common_1.RuntimeModules.NODE: {
-                try {
-                    const { serveStatic } = require('@hono/node-server/serve-static');
-                    server.use(restPath, serveStatic({ root: folderPath }));
-                }
-                catch (error) {
-                    this.logger.for(this.static.name).error('Failed to serve static file | Error: %s', error);
-                    throw (0, core_1.getError)({
-                        message: `[static] @hono/node-server is required for Node.js runtime. Please install '@hono/node-server'`,
-                    });
-                }
-                break;
-            }
-            default: {
-                throw (0, core_1.getError)({
-                    message: '[static] Invalid server runtime to config static loader!',
-                });
-            }
-        }
-        this.logger
-            .for(this.static.name)
-            .debug('Registered static files | runtime: %s | path: %s | folder: %s', this.runtime, restPath, folderPath);
-        return this;
-    }
-    /**
-     * Every value is read HERE, not destructured at module load: an application that loads its
-     * `.env` in its own entrypoint does so after this module is imported, and a module-load snapshot
-     * would print the defaults for a host that configured everything correctly.
-     */
-    printStartUpInfo(opts) {
-        const { scope } = opts;
-        const read = (key, fallback) => (0, core_1.blankToUndefined)(process.env[key]) ?? fallback;
-        const divider = '------------------------------------------------------------------------';
-        this.logger.for(scope).info(divider);
-        this.logger
-            .for(scope)
-            .info('Starting application... | Name: %s | Env: %s | Runtime: %s', read(environments_1.EnvironmentKeys.APP_ENV_APPLICATION_NAME, 'PNT'), ignis_helpers_1.Environment.ambient, this.runtime);
-        this.logger
-            .for(scope)
-            .info('AllowEmptyEnv: %s | Prefix: %s', read('ALLOW_EMPTY_ENV_VALUE', 'true'), read('APPLICATION_ENV_PREFIX', 'APP_ENV'));
-        this.logger.for(scope).info('RunMode: %s', process.env.RUN_MODE);
-        this.logger
-            .for(scope)
-            .info('Timezone: %s', read(environments_1.EnvironmentKeys.APP_ENV_APPLICATION_TIMEZONE, 'Asia/Ho_Chi_Minh'));
-        this.logger
-            .for(scope)
-            .info('LogPath: %s', read(environments_1.EnvironmentKeys.APP_ENV_LOGGER_FOLDER_PATH, './'));
-        this.logger.for(scope).info(divider);
-    }
-    /** Swaps in the `ErrorPrettier`-backed formatter - `node:util`, so the kernel cannot build it. */
-    buildErrorMiddleware() {
-        return new middlewares_1.AppErrorMiddleware({
-            logger: this.logger,
-            rootKey: this.configs.error?.rootKey ?? undefined,
-        });
-    }
-    /** Adds what only a listening server has, on top of the kernel's three - which stay in `RestApplication` so a browser Worker answers with the same envelope. */
-    async registerDefaultMiddlewares() {
-        await (0, ignis_helpers_1.executeWithPerformanceMeasure)({
-            logger: this.logger,
-            scope: this.registerDefaultMiddlewares.name,
-            description: 'Register default application server handler',
-            task: async () => {
-                const server = this.getServer();
-                await super.registerDefaultMiddlewares();
-                // Always installed, not only under `asyncContext.enable`: `tryGetContext()` answers "no context"
-                // without a store, and a `contextStorage()` the application registered itself stays visible to
-                // the enrichers. Inside a method body because every package declares `sideEffects: false`.
-                ignis_kernel_3.RequestContextRegistry.setResolver({ resolver: () => (0, context_storage_1.tryGetContext)() });
-                if (this.configs.asyncContext?.enable) {
-                    server.use((0, context_storage_1.contextStorage)());
-                }
-                // Request-body parsing and the access log; the request id it reads is already installed
-                // above (also works around the Bun + Hono body-parsing bug: https://github.com/honojs/middleware/issues/81).
-                this.component(components_1.RequestTrackerComponent);
-                server.use((0, middlewares_1.emojiFavicon)({ icon: this.configs.favicon ?? '🔥' }));
-            },
-        });
-    }
-    /** Lives here rather than on `AbstractApplication` - `applicationEnvironment` reads `process.env` at module load, so a kernel-pure ancestor cannot carry it; this is the layer that already depends on it. */
-    validateEnvs() {
-        const t = performance.now();
-        const envKeys = ignis_helpers_1.applicationEnvironment.keys();
-        // Permissive by DEFAULT: a name a host leaves empty is the host's business, and an empty value
-        // already falls back to `defaultValue` at read time, so refusing to boot over one fights the
-        // reader rather than helping it. Set ALLOW_EMPTY_ENV_VALUE to `false` or `0` to turn the check
-        // on. Read once rather than per key, and a blank value reads as unset - the same rule every
-        // other env read follows.
-        const configured = (0, core_1.blankToUndefined)(process.env.ALLOW_EMPTY_ENV_VALUE);
-        const allowsEmpty = configured === undefined || (0, ignis_helpers_1.toBoolean)(configured);
-        this.logger
-            .for(this.initialize.name)
-            .info('Envs: %s | START Validating application environments | Empty values: %s', envKeys.length, allowsEmpty ? 'ALLOWED (default)' : 'REJECTED');
-        if (allowsEmpty) {
-            this.logger
-                .for(this.validateEnvs.name)
-                .info('Envs: %s | SKIPPED - set ALLOW_EMPTY_ENV_VALUE=false to reject empty values', envKeys.length);
-            return;
-        }
-        for (const argKey of envKeys) {
-            const argValue = ignis_helpers_1.applicationEnvironment.get(argKey);
-            if (!(0, common_1.isEmpty)({ value: argValue })) {
-                continue;
-            }
-            throw (0, core_1.getError)({
-                message: `[validateEnvs] Invalid Application Environment! Key: ${argKey} | Value: ${argValue}`,
-            });
-        }
-        this.logger
-            .for(this.validateEnvs.name)
-            .info('Envs: %s | DONE Validating application environments | Took: %s (ms)', envKeys.length, performance.now() - t);
-    }
-    /**
-     * Version tripwire, body identical to `RestApplication.initialize()`: a stale kernel without
-     * `getBootSequence()`/`runBootSequence()` throws here before any socket binds.
-     */
-    async initialize() {
-        await this.runBootSequence({ steps: this.getBootSequence() });
-    }
-    getBootSequence() {
-        const steps = [
-            {
-                name: boot_steps_1.ServerBootSteps.PRINT_START_UP_INFO,
-                run: () => this.printStartUpInfo({ scope: this.initialize.name }),
-            },
-            { name: boot_steps_1.ServerBootSteps.VALIDATE_ENVS, run: () => this.validateEnvs() },
-            {
-                name: boot_steps_1.ServerBootSteps.REGISTER_DEFAULT_MIDDLEWARES,
-                run: () => this.registerDefaultMiddlewares(),
-            },
-            ...super.getBootSequence(),
-        ];
-        const withHydrate = ignis_kernel_3.BootSequence.insertAfter({
-            steps,
-            target: boot_steps_1.ServerBootSteps.PRE_CONFIGURE,
-            step: { name: boot_steps_1.ServerBootSteps.HYDRATE_SECRETS, run: () => this.hydrateSecrets() },
-        });
-        // Components can contribute datasources, so wire rotatables only after the contributed sweep -
-        // a lease key pointing at a component-contributed datasource would otherwise resolve to nothing.
-        const withRotatables = ignis_kernel_3.BootSequence.insertAfter({
-            steps: withHydrate,
-            target: boot_steps_1.ServerBootSteps.REGISTER_CONTRIBUTED_DATA_SOURCES,
-            step: {
-                name: boot_steps_1.ServerBootSteps.WIRE_SECRET_ROTATABLES,
-                run: () => this.wireSecretRotatables(),
-            },
-        });
-        return [
-            ...withRotatables,
-            // Last, so a model registered by a component is covered too.
-            {
-                name: boot_steps_1.ServerBootSteps.VALIDATE_SCOPE_FILTER_SUPPORT,
-                run: () => this.validateScopeFilterSupport(),
-            },
-        ];
-    }
-    /**
-     * Refuses to start when a model's `settings.access` cannot take effect. Both failures are
-     * silent at runtime and opposite: a search-backed model returns too many rows, a context-less one none.
-     */
-    validateScopeFilterSupport() {
-        (0, ignis_connectors_1.assertScopeFilterSupported)({ asyncContextEnabled: this.configs.asyncContext?.enable ?? false });
-    }
-}
-exports.BaseApplication = BaseApplication;
-//# sourceMappingURL=base.js.map