@venizia/ignis 0.4.3 → 0.4.5

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

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

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

package/dist/base/applications/boot-steps.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"boot-steps.d.ts","sourceRoot":"","sources":["../../../src/base/applications/boot-steps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,mKAAmK;AACnK,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,MAAM,CAAC,QAAQ,CAAC,mBAAmB,sBAAsB;IACzD,MAAM,CAAC,QAAQ,CAAC,aAAa,kBAAkB;IAC/C,MAAM,CAAC,QAAQ,CAAC,eAAe,oBAAoB;IACnD,MAAM,CAAC,QAAQ,CAAC,sBAAsB,0BAA0B;IAChE,MAAM,CAAC,QAAQ,CAAC,6BAA6B,gCAAgC;IAG7E,gBAAyB,UAAU,cAOhC;CACJ;AAED,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/base/applications/boot-steps.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServerBootSteps = void 0;
-const ignis_kernel_1 = require("@venizia/ignis-kernel");
-/** The kernel's step names plus the ones only a server runs - the full vocabulary `BaseApplication.getBootSequence()` publishes for `BootSequence.insertAfter`. */
-class ServerBootSteps extends ignis_kernel_1.BootSteps {
-    static { this.PRINT_START_UP_INFO = 'printStartUpInfo'; }
-    static { this.VALIDATE_ENVS = 'validateEnvs'; }
-    static { this.HYDRATE_SECRETS = 'hydrateSecrets'; }
-    static { this.WIRE_SECRET_ROTATABLES = 'wireSecretRotatables'; }
-    static { this.VALIDATE_SCOPE_FILTER_SUPPORT = 'validateScopeFilterSupport'; }
-    // The kernel's names plus these; `isValid` is inherited and reads this set through `this`.
-    static { this.SCHEME_SET = new Set([
-        ...ignis_kernel_1.BootSteps.SCHEME_SET,
-        this.PRINT_START_UP_INFO,
-        this.VALIDATE_ENVS,
-        this.HYDRATE_SECRETS,
-        this.WIRE_SECRET_ROTATABLES,
-        this.VALIDATE_SCOPE_FILTER_SUPPORT,
-    ]); }
-}
-exports.ServerBootSteps = ServerBootSteps;
-//# sourceMappingURL=boot-steps.js.map

package/dist/base/applications/boot-steps.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"boot-steps.js","sourceRoot":"","sources":["../../../src/base/applications/boot-steps.ts"],"names":[],"mappings":";;;AAAA,wDAAkD;AAGlD,mKAAmK;AACnK,MAAa,eAAgB,SAAQ,wBAAS;aAC5B,wBAAmB,GAAG,kBAAkB,CAAC;aACzC,kBAAa,GAAG,cAAc,CAAC;aAC/B,oBAAe,GAAG,gBAAgB,CAAC;aACnC,2BAAsB,GAAG,sBAAsB,CAAC;aAChD,kCAA6B,GAAG,4BAA4B,CAAC;IAE7E,2FAA2F;aAClE,eAAU,GAAG,IAAI,GAAG,CAAS;QACpD,GAAG,wBAAS,CAAC,UAAU;QACvB,IAAI,CAAC,mBAAmB;QACxB,IAAI,CAAC,aAAa;QAClB,IAAI,CAAC,eAAe;QACpB,IAAI,CAAC,sBAAsB;QAC3B,IAAI,CAAC,6BAA6B;KACnC,CAAC,CAAC;;AAfL,0CAgBC","sourcesContent":["import { BootSteps } from '@venizia/ignis-kernel';\nimport type { TConstValue } from '@venizia/ignis-helpers/common';\n\n/** The kernel's step names plus the ones only a server runs - the full vocabulary `BaseApplication.getBootSequence()` publishes for `BootSequence.insertAfter`. */\nexport class ServerBootSteps extends BootSteps {\n  static readonly PRINT_START_UP_INFO = 'printStartUpInfo';\n  static readonly VALIDATE_ENVS = 'validateEnvs';\n  static readonly HYDRATE_SECRETS = 'hydrateSecrets';\n  static readonly WIRE_SECRET_ROTATABLES = 'wireSecretRotatables';\n  static readonly VALIDATE_SCOPE_FILTER_SUPPORT = 'validateScopeFilterSupport';\n\n  // The kernel's names plus these; `isValid` is inherited and reads this set through `this`.\n  static override readonly SCHEME_SET = new Set<string>([\n    ...BootSteps.SCHEME_SET,\n    this.PRINT_START_UP_INFO,\n    this.VALIDATE_ENVS,\n    this.HYDRATE_SECRETS,\n    this.WIRE_SECRET_ROTATABLES,\n    this.VALIDATE_SCOPE_FILTER_SUPPORT,\n  ]);\n}\n\nexport type TServerBootStep = TConstValue<typeof ServerBootSteps>;\n"]}

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

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

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

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

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

@@ -1,18 +0,0 @@
-"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("./types"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/applications/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB","sourcesContent":["export * from './types';\n"]}

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

@@ -1,46 +0,0 @@
-import type { IApplication, IApplicationConfigs as IKernelApplicationConfigs } from '@venizia/ignis-kernel';
-import type { Env, Schema } from 'hono';
-/** `any`, resolved at runtime from `@hono/node-server` - naming its real type would make that package a hard dependency. */
-export type TNodeServerInstance = any;
-/**
- * What a host with a real socket configures on top of the kernel's shape. `host` and `port` are
- * meaningless to a browser Worker, which is why they are not on the kernel's own interface - see
- * {@link IServerApplication}.
- */
-export interface IServerApplicationConfigs extends IKernelApplicationConfigs {
-    host?: string;
-    port?: number;
-    /** Bound as `CoreBindings.APPLICATION_PROJECT_ROOT` at construction and handed to `ModuleUtility`; default `process.cwd()`. Must be the directory holding `node_modules` at run time - never `__dirname` inside a compiled binary. */
-    projectRoot?: string;
-    /** Bun-only socket options passed straight to `Bun.serve`; the node runtime logs a warning and ignores them. Unset keys keep Bun's own defaults. */
-    server?: IServerRuntimeConfigs;
-}
-/** The `Bun.serve` options an application has a reason to change without re-implementing `startBunModule`. */
-export interface IServerRuntimeConfigs {
-    /** Seconds a connection may sit idle before Bun closes it; Bun caps it at 255. */
-    idleTimeout?: number;
-    /** Largest request body in bytes. */
-    maxRequestBodySize?: number;
-}
-/**
- * The kernel's contract plus what only a listening server can answer. `RestApplication` deliberately
- * implements none of these: a browser Worker has no host, no port, and nothing to `start()` - it
- * answers `postMessage` instead.
- */
-/** Options of `ServerApplication.installShutdownSignals`. */
-export interface IShutdownSignalsOptions {
-    /** The signals that stop the application. Default `['SIGTERM', 'SIGINT']`. */
-    signals?: NodeJS.Signals[];
-    /** How long a shutdown may take before the process is force-exited with code 1. Default `15_000`. */
-    timeoutMs?: number;
-    /** What ends the process: `process.exit` by default. A seam for tests and for hosts that exit differently. */
-    exit?: (code: number) => void;
-}
-export interface IServerApplication<AppEnv extends Env = Env, AppSchema extends Schema = Schema, BasePath extends string = '/'> extends IApplication<AppEnv, AppSchema, BasePath> {
-    getServerHost(): string;
-    getServerPort(): number;
-    getServerAddress(): string;
-    start(): Promise<void> | void;
-    stop(): Promise<void> | void;
-}
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/base/applications/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,IAAI,yBAAyB,EACjD,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAExC,4HAA4H;AAC5H,MAAM,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEtC;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,yBAAyB;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sOAAsO;IACtO,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oJAAoJ;IACpJ,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED,8GAA8G;AAC9G,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,6DAA6D;AAC7D,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IAE3B,qGAAqG;IACrG,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,8GAA8G;IAC9G,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB,CACjC,MAAM,SAAS,GAAG,GAAG,GAAG,EACxB,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,QAAQ,SAAS,MAAM,GAAG,GAAG,CAC7B,SAAQ,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC;IACjD,aAAa,IAAI,MAAM,CAAC;IACxB,aAAa,IAAI,MAAM,CAAC;IACxB,gBAAgB,IAAI,MAAM,CAAC;IAE3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9B"}

package/dist/base/applications/common/types.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/base/applications/common/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/base/applications/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  IApplication,\n  IApplicationConfigs as IKernelApplicationConfigs,\n} from '@venizia/ignis-kernel';\nimport type { Env, Schema } from 'hono';\n\n/** `any`, resolved at runtime from `@hono/node-server` - naming its real type would make that package a hard dependency. */\nexport type TNodeServerInstance = any;\n\n/**\n * What a host with a real socket configures on top of the kernel's shape. `host` and `port` are\n * meaningless to a browser Worker, which is why they are not on the kernel's own interface - see\n * {@link IServerApplication}.\n */\nexport interface IServerApplicationConfigs extends IKernelApplicationConfigs {\n  host?: string;\n  port?: number;\n  /** Bound as `CoreBindings.APPLICATION_PROJECT_ROOT` at construction and handed to `ModuleUtility`; default `process.cwd()`. Must be the directory holding `node_modules` at run time - never `__dirname` inside a compiled binary. */\n  projectRoot?: string;\n  /** Bun-only socket options passed straight to `Bun.serve`; the node runtime logs a warning and ignores them. Unset keys keep Bun's own defaults. */\n  server?: IServerRuntimeConfigs;\n}\n\n/** The `Bun.serve` options an application has a reason to change without re-implementing `startBunModule`. */\nexport interface IServerRuntimeConfigs {\n  /** Seconds a connection may sit idle before Bun closes it; Bun caps it at 255. */\n  idleTimeout?: number;\n  /** Largest request body in bytes. */\n  maxRequestBodySize?: number;\n}\n\n/**\n * The kernel's contract plus what only a listening server can answer. `RestApplication` deliberately\n * implements none of these: a browser Worker has no host, no port, and nothing to `start()` - it\n * answers `postMessage` instead.\n */\n/** Options of `ServerApplication.installShutdownSignals`. */\nexport interface IShutdownSignalsOptions {\n  /** The signals that stop the application. Default `['SIGTERM', 'SIGINT']`. */\n  signals?: NodeJS.Signals[];\n\n  /** How long a shutdown may take before the process is force-exited with code 1. Default `15_000`. */\n  timeoutMs?: number;\n\n  /** What ends the process: `process.exit` by default. A seam for tests and for hosts that exit differently. */\n  exit?: (code: number) => void;\n}\n\nexport interface IServerApplication<\n  AppEnv extends Env = Env,\n  AppSchema extends Schema = Schema,\n  BasePath extends string = '/',\n> extends IApplication<AppEnv, AppSchema, BasePath> {\n  getServerHost(): string;\n  getServerPort(): number;\n  getServerAddress(): string;\n\n  start(): Promise<void> | void;\n  stop(): Promise<void> | void;\n}\n"]}

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

@@ -1,6 +0,0 @@
-export * from '@venizia/ignis-kernel';
-export * from './base';
-export * from './boot-steps';
-export * from './common';
-export * from './server';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base/applications/index.ts"],"names":[],"mappings":"AAGA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/base/applications/index.js

@@ -1,25 +0,0 @@
-"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 });
-// `abstract.ts`, `rest.ts` and `types.ts` moved to the kernel; `base.ts` (BaseApplication) and
-// `server.ts` (ServerApplication) stay - both are node-shaped (secrets/boot wiring, the listening
-// server).
-__exportStar(require("@venizia/ignis-kernel"), exports);
-__exportStar(require("./base"), exports);
-__exportStar(require("./boot-steps"), exports);
-__exportStar(require("./common"), exports);
-__exportStar(require("./server"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/base/applications/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+FAA+F;AAC/F,kGAAkG;AAClG,WAAW;AACX,wDAAsC;AAEtC,yCAAuB;AACvB,+CAA6B;AAC7B,2CAAyB;AACzB,2CAAyB","sourcesContent":["// `abstract.ts`, `rest.ts` and `types.ts` moved to the kernel; `base.ts` (BaseApplication) and\n// `server.ts` (ServerApplication) stay - both are node-shaped (secrets/boot wiring, the listening\n// server).\nexport * from '@venizia/ignis-kernel';\n\nexport * from './base';\nexport * from './boot-steps';\nexport * from './common';\nexport * from './server';\n"]}