@venizia/ignis-kernel 0.2.0-4 → 0.2.0-41

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

@@ -1,6 +1,6 @@
 import { Container } from '../../helpers/inversion/container';
 import type { ValueOrPromise } from '@venizia/ignis-helpers/common';
-import type { IApplicationConfigs, IApplicationInfo } from './types';
+import type { IApplicationConfigs, IApplicationInfo } from './common';
 export declare abstract class AbstractApplication extends Container {
     protected configs: IApplicationConfigs;
     protected projectRoot: string;
@@ -12,6 +12,11 @@ export declare abstract class AbstractApplication extends Container {
     });
     abstract getAppInfo(): ValueOrPromise<IApplicationInfo>;
     abstract preConfigure(): ValueOrPromise<void>;
+    /**
+     * Runs after every registration sweep (datasources, components, controllers) has already
+     * completed. Registering a new one here is not auto-registered and silently does nothing -
+     * call `configure()` manually instead.
+     */
     abstract postConfigure(): ValueOrPromise<void>;
     abstract staticConfigure(): void;
     abstract setupMiddlewares(opts?: {

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

@@ -1 +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"}
+{"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,UAAU,CAAC;AAEtE,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;IAE7C;;;;OAIG;IACH,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/cjs/base/applications/abstract.js.map

@@ -1 +1 @@
-{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/base/applications/abstract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/base/applications/abstract.ts"],"names":[],"mappings":";;;AAAA,gDAAiD;AACjD,6DAA0D;AAE1D,sDAAuD;AACvD,0DAAqD;AAGrD,MAAsB,mBAAoB,SAAQ,qBAAS;IAOzD,YAAY,IAAoD;QAC9D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC/B,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QALX,mBAAc,GAAoE,EAAE,CAAC;QACrF,kBAAa,GAAoE,EAAE,CAAC;QAM1F,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE;YACvC,YAAY,EAAE;gBACZ,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,IAAI,IAAI,CAAC,6BAA6B,EAAE;aAC7E;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5E,CAAC;IAoBS,6BAA6B;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,cAAc;QACZ,MAAM,WAAW,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAS,EAAE,GAAG,EAAE,uBAAY,CAAC,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACvF,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,qBAAqB,CAAC,IAA8D;QAClF,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC;aACpC,KAAK,CAAC,6CAA6C,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3E,CAAC;IAED,qMAAqM;IAC3L,KAAK,CAAC,qBAAqB;QACnC,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAE9E,MAAM,QAAQ,GAAkD,EAAE,CAAC;QAEnE,KAAK,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACvD,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAE5B,IAAI,CAAC;gBACH,MAAM,IAAI,EAAE,CAAC;YACf,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,qDAAqD,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;gBACvF,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;gBACrC,SAAS;YACX,CAAC;YAED,MAAM,CAAC,IAAI,CACT,gDAAgD,EAChD,UAAU,EACV,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CACtB,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,MAAM,IAAA,eAAQ,EAAC;YACb,UAAU,EAAE,aAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;YACrD,OAAO,EAAE,sDAAsD,QAAQ;iBACpE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,UAAU,KAAK,OAAO,CAAC,KAAK,GAAG,CAAC;iBAC1D,IAAI,CAAC,IAAI,CAAC,EAAE;SAChB,CAAC,CAAC;IACL,CAAC;IAED,oBAAoB,CAAC,IAA8D;QACjF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC;aACnC,KAAK,CAAC,4CAA4C,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1E,CAAC;IAES,KAAK,CAAC,oBAAoB;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC/D,KAAK,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACtD,IAAI,CAAC;gBACH,MAAM,IAAI,EAAE,CAAC;YACf,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,oDAAoD,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;IACH,CAAC;IAES,oBAAoB;QAC5B,IAAI,CAAC,IAAI,CAAc;YACrB,GAAG,EAAE,uBAAY,CAAC,oBAAoB;SACvC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI;QACF,IAAI,CAAC,oBAAoB,EAAE,CAAC;IAC9B,CAAC;CACF;AAhID,kDAgIC"}

package/dist/cjs/base/applications/artifact-index.d.ts

@@ -0,0 +1,41 @@
+import type { TClass } from '@venizia/ignis-helpers/common';
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+import type { IArtifactIndex, TArtifactIndexInput } from './common';
+/** Turns a `configs.artifacts` input into the classes to register: flattens nested indexes, drops the classes whose `when` says no, orders the rest. It never touches the container - `registerArtifacts` does the binding. */
+export declare class ArtifactIndexHelper extends BaseHelper {
+    static readonly SINGLETON_REALM_KEY = "artifact-index-helper";
+    private constructor();
+    static getInstance(): ArtifactIndexHelper;
+    /** Maps an artifact type to the index field that carries it. `ArtifactTypes.MODEL` is deliberately absent: a model has a binding namespace but no index field, because its repository registers it. */
+    private static readonly INDEX_FIELD_BY_TYPE;
+    /** The index a decorator-only application has: every class a stereotype saw at import time, bucketed by its type. `when` and `order` still apply - `resolve` does that, exactly as it does for a declared index. */
+    buildDiscoveredIndex(): IArtifactIndex;
+    /** Every kind of the input, each already filtered by `when` and sorted by `order`, keyed the way `IArtifactIndex` is. */
+    resolve(opts: {
+        input: TArtifactIndexInput;
+        application: unknown;
+    }): Promise<Required<IArtifactIndex>>;
+    /**
+     * Topologically sort configurations based on `after` dependencies.
+     * Siblings with no dependency relation are sorted deterministically by class name.
+     * Throws if an unknown `after` dependency is referenced or if a dependency cycle is detected.
+     */
+    sortConfigurationsTopologically(opts: {
+        classes: ReadonlyArray<TClass<any>>;
+    }): TClass<any>[];
+    /** One index, or arrays nested to any depth, as a flat list in input order; a conditional entry contributes its subtree only when its `when` answers true. */
+    flatten(opts: {
+        input: TArtifactIndexInput;
+        application: unknown;
+    }): Promise<IArtifactIndex[]>;
+    /** Positional on purpose: a type predicate narrows its own parameter, and an options object would narrow the wrapper instead of `input`. */
+    private isConditional;
+    /** The classes of one kind across every index, minus those whose `when` says no, sorted by `order` (stable). The `when` conditions run concurrently: each reads config and environment, never another artifact. */
+    select<Field extends keyof IArtifactIndex>(opts: {
+        indexes: IArtifactIndex[];
+        field: Field;
+        application: unknown;
+    }): Promise<NonNullable<IArtifactIndex[Field]>[number][]>;
+    private isSelected;
+}
+//# sourceMappingURL=artifact-index.d.ts.map

package/dist/cjs/base/applications/artifact-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-index.d.ts","sourceRoot":"","sources":["../../../../src/base/applications/artifact-index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAA6B,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAG/F,+NAA+N;AAC/N,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,MAAM,CAAC,QAAQ,CAAC,mBAAmB,2BAA2B;IAE9D,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,mBAAmB;IAOzC,uMAAuM;IACvM,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAOzC;IAEF,oNAAoN;IACpN,oBAAoB,IAAI,cAAc;IAqBtC,yHAAyH;IACnH,OAAO,CAAC,IAAI,EAAE;QAClB,KAAK,EAAE,mBAAmB,CAAC;QAC3B,WAAW,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IA0CrC;;;;OAIG;IACH,+BAA+B,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;KAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE;IA0E7F,8JAA8J;IACxJ,OAAO,CAAC,IAAI,EAAE;QAClB,KAAK,EAAE,mBAAmB,CAAC;QAC3B,WAAW,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAsB7B,4IAA4I;IAC5I,OAAO,CAAC,aAAa;IAMrB,mNAAmN;IAC7M,MAAM,CAAC,KAAK,SAAS,MAAM,cAAc,EAAE,IAAI,EAAE;QACrD,OAAO,EAAE,cAAc,EAAE,CAAC;QAC1B,KAAK,EAAE,KAAK,CAAC;QACb,WAAW,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YA8B3C,UAAU;CAWzB"}

package/dist/cjs/base/applications/artifact-index.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArtifactIndexHelper = void 0;
+const inversion_1 = require("../../helpers/inversion");
+const singleton_realm_1 = require("../../helpers/singleton-realm");
+const inversion_2 = require("../../helpers/inversion");
+const core_1 = require("@venizia/ignis-helpers/core");
+const common_1 = require("./common");
+/** Turns a `configs.artifacts` input into the classes to register: flattens nested indexes, drops the classes whose `when` says no, orders the rest. It never touches the container - `registerArtifacts` does the binding. */
+class ArtifactIndexHelper extends core_1.BaseHelper {
+    static { this.SINGLETON_REALM_KEY = 'artifact-index-helper'; }
+    constructor() {
+        super({ scope: ArtifactIndexHelper.name });
+    }
+    static getInstance() {
+        return singleton_realm_1.SingletonRealm.resolve({
+            key: ArtifactIndexHelper.SINGLETON_REALM_KEY,
+            create: () => new ArtifactIndexHelper(),
+        });
+    }
+    /** Maps an artifact type to the index field that carries it. `ArtifactTypes.MODEL` is deliberately absent: a model has a binding namespace but no index field, because its repository registers it. */
+    static { this.INDEX_FIELD_BY_TYPE = {
+        [inversion_2.ArtifactTypes.CONFIGURATION]: common_1.ArtifactIndexFields.CONFIGURATIONS,
+        [inversion_2.ArtifactTypes.DATASOURCE]: common_1.ArtifactIndexFields.DATA_SOURCES,
+        [inversion_2.ArtifactTypes.COMPONENT]: common_1.ArtifactIndexFields.COMPONENTS,
+        [inversion_2.ArtifactTypes.REPOSITORY]: common_1.ArtifactIndexFields.REPOSITORIES,
+        [inversion_2.ArtifactTypes.SERVICE]: common_1.ArtifactIndexFields.SERVICES,
+        [inversion_2.ArtifactTypes.CONTROLLER]: common_1.ArtifactIndexFields.CONTROLLERS,
+    }; }
+    /** The index a decorator-only application has: every class a stereotype saw at import time, bucketed by its type. `when` and `order` still apply - `resolve` does that, exactly as it does for a declared index. */
+    buildDiscoveredIndex() {
+        const registry = inversion_1.MetadataRegistry.getInstance();
+        const index = {};
+        for (const target of registry.getDiscoveredArtifacts()) {
+            if (!(0, inversion_2.isClass)(target)) {
+                continue;
+            }
+            const type = registry.getArtifactMetadata({ target })?.type;
+            const field = type ? ArtifactIndexHelper.INDEX_FIELD_BY_TYPE[type] : undefined;
+            if (!field) {
+                continue;
+            }
+            index[field] = [...(index[field] ?? []), target];
+        }
+        return index;
+    }
+    /** Every kind of the input, each already filtered by `when` and sorted by `order`, keyed the way `IArtifactIndex` is. */
+    async resolve(opts) {
+        const { input, application } = opts;
+        const indexes = await this.flatten({ input, application });
+        const rawConfigurations = await this.select({
+            indexes,
+            field: common_1.ArtifactIndexFields.CONFIGURATIONS,
+            application,
+        });
+        const configurations = this.sortConfigurationsTopologically({
+            classes: rawConfigurations,
+        });
+        const dataSources = await this.select({
+            indexes,
+            field: common_1.ArtifactIndexFields.DATA_SOURCES,
+            application,
+        });
+        const components = await this.select({
+            indexes,
+            field: common_1.ArtifactIndexFields.COMPONENTS,
+            application,
+        });
+        const repositories = await this.select({
+            indexes,
+            field: common_1.ArtifactIndexFields.REPOSITORIES,
+            application,
+        });
+        const services = await this.select({
+            indexes,
+            field: common_1.ArtifactIndexFields.SERVICES,
+            application,
+        });
+        const controllers = await this.select({
+            indexes,
+            field: common_1.ArtifactIndexFields.CONTROLLERS,
+            application,
+        });
+        return { configurations, dataSources, components, repositories, services, controllers };
+    }
+    /**
+     * Topologically sort configurations based on `after` dependencies.
+     * Siblings with no dependency relation are sorted deterministically by class name.
+     * Throws if an unknown `after` dependency is referenced or if a dependency cycle is detected.
+     */
+    sortConfigurationsTopologically(opts) {
+        const { classes } = opts;
+        if (classes.length === 0) {
+            return [];
+        }
+        const registry = inversion_1.MetadataRegistry.getInstance();
+        const classMap = new Map();
+        for (const target of classes) {
+            classMap.set(target.name, target);
+        }
+        // Build graph: edge A -> B means A must run before B (B declared after: [A])
+        const inDegree = new Map();
+        const adjacency = new Map();
+        for (const target of classes) {
+            inDegree.set(target.name, 0);
+            adjacency.set(target.name, []);
+        }
+        for (const target of classes) {
+            const metadata = registry.getArtifactMetadata({ target });
+            const afterList = metadata?.after ?? [];
+            for (const prereq of afterList) {
+                const prereqName = typeof prereq === 'function' ? prereq.name : String(prereq);
+                if (!classMap.has(prereqName)) {
+                    throw (0, core_1.getError)({
+                        message: `[sortConfigurationsTopologically][${target.name}] Declared 'after' dependency '${prereqName}' is not registered as a configuration`,
+                    });
+                }
+                adjacency.get(prereqName).push(target.name);
+                inDegree.set(target.name, (inDegree.get(target.name) ?? 0) + 1);
+            }
+        }
+        // Kahn's algorithm with priority queue (sorted by class name for deterministic sibling ordering)
+        const available = [];
+        for (const [name, deg] of inDegree.entries()) {
+            if (deg === 0) {
+                available.push(name);
+            }
+        }
+        available.sort((a, b) => a.localeCompare(b));
+        const sortedNames = [];
+        while (available.length > 0) {
+            const current = available.shift();
+            sortedNames.push(current);
+            const dependents = adjacency.get(current) ?? [];
+            for (const dep of dependents) {
+                const newDeg = inDegree.get(dep) - 1;
+                inDegree.set(dep, newDeg);
+                if (newDeg === 0) {
+                    available.push(dep);
+                    available.sort((a, b) => a.localeCompare(b));
+                }
+            }
+        }
+        if (sortedNames.length !== classes.length) {
+            const unvisited = classes.filter(c => !sortedNames.includes(c.name)).map(c => c.name);
+            throw (0, core_1.getError)({
+                message: `[sortConfigurationsTopologically] Dependency cycle detected in configurations: ${unvisited.join(', ')}`,
+            });
+        }
+        return sortedNames.map(name => classMap.get(name));
+    }
+    /** One index, or arrays nested to any depth, as a flat list in input order; a conditional entry contributes its subtree only when its `when` answers true. */
+    async flatten(opts) {
+        const { input, application } = opts;
+        if (Array.isArray(input)) {
+            const nested = await Promise.all(input.map(entry => this.flatten({ input: entry, application })));
+            return nested.flat();
+        }
+        if (this.isConditional(input)) {
+            const isSelected = await input.when({ application });
+            if (!isSelected) {
+                this.logger.debug('Skipped by condition | conditional index entry');
+                return [];
+            }
+            return this.flatten({ input: input.index, application });
+        }
+        return [input];
+    }
+    /** Positional on purpose: a type predicate narrows its own parameter, and an options object would narrow the wrapper instead of `input`. */
+    isConditional(entry) {
+        return 'when' in entry && 'index' in entry;
+    }
+    /** The classes of one kind across every index, minus those whose `when` says no, sorted by `order` (stable). The `when` conditions run concurrently: each reads config and environment, never another artifact. */
+    async select(opts) {
+        const { indexes, field, application } = opts;
+        const registry = inversion_1.MetadataRegistry.getInstance();
+        // De-duplicated: discovery and a declared index can name the same class, and registering it
+        // twice trips `bootChecks.binding.allowOverride: false`. First mention wins its position.
+        const listed = [...new Set(indexes.flatMap(index => [...(index[field] ?? [])]))];
+        const decisions = await Promise.all(listed.map(target => this.isSelected({ target, application })));
+        const kept = listed.filter((target, position) => {
+            if (decisions[position]) {
+                return true;
+            }
+            this.logger.debug('Skipped by condition | kind: %s | class: %s', field, target.name);
+            return false;
+        });
+        return kept
+            .map((target, position) => ({
+            target,
+            position,
+            order: registry.getArtifactMetadata({ target })?.order ?? 0,
+        }))
+            .sort((a, b) => a.order - b.order || a.position - b.position)
+            .map(entry => entry.target);
+    }
+    async isSelected(opts) {
+        const { target, application } = opts;
+        const when = inversion_1.MetadataRegistry.getInstance().getArtifactMetadata({ target })?.when;
+        if (!when) {
+            return true;
+        }
+        return when({ application });
+    }
+}
+exports.ArtifactIndexHelper = ArtifactIndexHelper;
+//# sourceMappingURL=artifact-index.js.map

package/dist/cjs/base/applications/artifact-index.js.map

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

package/dist/cjs/base/applications/boot-sequence.d.ts

@@ -0,0 +1,33 @@
+import type { TConstValue, ValueOrPromise } from '@venizia/ignis-helpers/common';
+/** The step names the kernel defines - the vocabulary a subclass targets with `BootSequence.insertAfter`. A server application adds its own on top (`ServerBootSteps` in `@venizia/ignis`). */
+export declare class BootSteps {
+    static readonly STATIC_CONFIGURE = "staticConfigure";
+    static readonly REGISTER_ARTIFACTS = "registerArtifacts";
+    static readonly PRE_CONFIGURE = "preConfigure";
+    static readonly REGISTER_DEFAULT_MIDDLEWARES = "registerDefaultMiddlewares";
+    static readonly REGISTER_CONFIGURATIONS = "registerConfigurations";
+    static readonly REGISTER_DATA_SOURCES = "registerDataSources";
+    static readonly REGISTER_COMPONENTS = "registerComponents";
+    static readonly REGISTER_CONTRIBUTED_DATA_SOURCES = "registerContributedDataSources";
+    static readonly REGISTER_CONTROLLERS = "registerControllers";
+    static readonly POST_CONFIGURE = "postConfigure";
+    static readonly VERIFY_BINDINGS = "verifyBindings";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+export type TBootStep = TConstValue<typeof BootSteps>;
+export interface IBootSequenceStep {
+    name: string;
+    run: () => ValueOrPromise<void>;
+}
+/** Composes a boot sequence by name instead of copying the array - a subclass reads exactly what it adds by reading its own override, without diffing two files by eye. */
+export declare class BootSequence {
+    /** A duplicated name is refused as loudly as a missing one - picking the first match would splice a step into the wrong place silently. */
+    private static indexOf;
+    static insertAfter(opts: {
+        steps: IBootSequenceStep[];
+        target: string;
+        step: IBootSequenceStep;
+    }): IBootSequenceStep[];
+}
+//# sourceMappingURL=boot-sequence.d.ts.map

package/dist/cjs/base/applications/boot-sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-sequence.d.ts","sourceRoot":"","sources":["../../../../src/base/applications/boot-sequence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGjF,+LAA+L;AAC/L,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,gBAAgB,qBAAqB;IACrD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,uBAAuB;IACzD,MAAM,CAAC,QAAQ,CAAC,aAAa,kBAAkB;IAC/C,MAAM,CAAC,QAAQ,CAAC,4BAA4B,gCAAgC;IAC5E,MAAM,CAAC,QAAQ,CAAC,uBAAuB,4BAA4B;IACnE,MAAM,CAAC,QAAQ,CAAC,qBAAqB,yBAAyB;IAC9D,MAAM,CAAC,QAAQ,CAAC,mBAAmB,wBAAwB;IAC3D,MAAM,CAAC,QAAQ,CAAC,iCAAiC,oCAAoC;IACrF,MAAM,CAAC,QAAQ,CAAC,oBAAoB,yBAAyB;IAC7D,MAAM,CAAC,QAAQ,CAAC,cAAc,mBAAmB;IACjD,MAAM,CAAC,QAAQ,CAAC,eAAe,oBAAoB;IACnD,MAAM,CAAC,QAAQ,CAAC,UAAU,cAYvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,SAAS,CAAC,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,2KAA2K;AAC3K,qBAAa,YAAY;IACvB,2IAA2I;IAC3I,OAAO,CAAC,MAAM,CAAC,OAAO;IAsBtB,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QACvB,KAAK,EAAE,iBAAiB,EAAE,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,iBAAiB,CAAC;KACzB,GAAG,iBAAiB,EAAE;CAMxB"}

package/dist/cjs/base/applications/boot-sequence.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BootSequence = exports.BootSteps = void 0;
+const core_1 = require("@venizia/ignis-helpers/core");
+/** The step names the kernel defines - the vocabulary a subclass targets with `BootSequence.insertAfter`. A server application adds its own on top (`ServerBootSteps` in `@venizia/ignis`). */
+class BootSteps {
+    static { this.STATIC_CONFIGURE = 'staticConfigure'; }
+    static { this.REGISTER_ARTIFACTS = 'registerArtifacts'; }
+    static { this.PRE_CONFIGURE = 'preConfigure'; }
+    static { this.REGISTER_DEFAULT_MIDDLEWARES = 'registerDefaultMiddlewares'; }
+    static { this.REGISTER_CONFIGURATIONS = 'registerConfigurations'; }
+    static { this.REGISTER_DATA_SOURCES = 'registerDataSources'; }
+    static { this.REGISTER_COMPONENTS = 'registerComponents'; }
+    static { this.REGISTER_CONTRIBUTED_DATA_SOURCES = 'registerContributedDataSources'; }
+    static { this.REGISTER_CONTROLLERS = 'registerControllers'; }
+    static { this.POST_CONFIGURE = 'postConfigure'; }
+    static { this.VERIFY_BINDINGS = 'verifyBindings'; }
+    static { this.SCHEME_SET = new Set([
+        this.STATIC_CONFIGURE,
+        this.REGISTER_ARTIFACTS,
+        this.PRE_CONFIGURE,
+        this.REGISTER_DEFAULT_MIDDLEWARES,
+        this.REGISTER_CONFIGURATIONS,
+        this.REGISTER_DATA_SOURCES,
+        this.REGISTER_COMPONENTS,
+        this.REGISTER_CONTRIBUTED_DATA_SOURCES,
+        this.REGISTER_CONTROLLERS,
+        this.POST_CONFIGURE,
+        this.VERIFY_BINDINGS,
+    ]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+exports.BootSteps = BootSteps;
+/** Composes a boot sequence by name instead of copying the array - a subclass reads exactly what it adds by reading its own override, without diffing two files by eye. */
+class BootSequence {
+    /** A duplicated name is refused as loudly as a missing one - picking the first match would splice a step into the wrong place silently. */
+    static indexOf(opts) {
+        const { steps, target } = opts;
+        const matches = steps.flatMap((step, index) => (step.name === target ? [index] : []));
+        const known = steps.map(step => step.name).join(', ');
+        switch (matches.length) {
+            case 0: {
+                throw (0, core_1.getError)({
+                    message: `[BootSequence] Unknown step: '${target}' | Known steps: ${known}`,
+                });
+            }
+            case 1: {
+                return matches[0];
+            }
+            default: {
+                throw (0, core_1.getError)({
+                    message: `[BootSequence] Ambiguous step: '${target}' appears ${matches.length} times | Known steps: ${known}`,
+                });
+            }
+        }
+    }
+    static insertAfter(opts) {
+        const { steps, target, step } = opts;
+        const index = BootSequence.indexOf({ steps, target });
+        return [...steps.slice(0, index + 1), step, ...steps.slice(index + 1)];
+    }
+}
+exports.BootSequence = BootSequence;
+//# sourceMappingURL=boot-sequence.js.map

package/dist/cjs/base/applications/boot-sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-sequence.js","sourceRoot":"","sources":["../../../../src/base/applications/boot-sequence.ts"],"names":[],"mappings":";;;AACA,sDAAuD;AAEvD,+LAA+L;AAC/L,MAAa,SAAS;aACJ,qBAAgB,GAAG,iBAAiB,CAAC;aACrC,uBAAkB,GAAG,mBAAmB,CAAC;aACzC,kBAAa,GAAG,cAAc,CAAC;aAC/B,iCAA4B,GAAG,4BAA4B,CAAC;aAC5D,4BAAuB,GAAG,wBAAwB,CAAC;aACnD,0BAAqB,GAAG,qBAAqB,CAAC;aAC9C,wBAAmB,GAAG,oBAAoB,CAAC;aAC3C,sCAAiC,GAAG,gCAAgC,CAAC;aACrE,yBAAoB,GAAG,qBAAqB,CAAC;aAC7C,mBAAc,GAAG,eAAe,CAAC;aACjC,oBAAe,GAAG,gBAAgB,CAAC;aACnC,eAAU,GAAG,IAAI,GAAG,CAAS;QAC3C,IAAI,CAAC,gBAAgB;QACrB,IAAI,CAAC,kBAAkB;QACvB,IAAI,CAAC,aAAa;QAClB,IAAI,CAAC,4BAA4B;QACjC,IAAI,CAAC,uBAAuB;QAC5B,IAAI,CAAC,qBAAqB;QAC1B,IAAI,CAAC,mBAAmB;QACxB,IAAI,CAAC,iCAAiC;QACtC,IAAI,CAAC,oBAAoB;QACzB,IAAI,CAAC,cAAc;QACnB,IAAI,CAAC,eAAe;KACrB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AA5BH,8BA6BC;AASD,2KAA2K;AAC3K,MAAa,YAAY;IACvB,2IAA2I;IACnI,MAAM,CAAC,OAAO,CAAC,IAAoD;QACzE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtF,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEtD,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;YACvB,KAAK,CAAC,CAAC,CAAC,CAAC;gBACP,MAAM,IAAA,eAAQ,EAAC;oBACb,OAAO,EAAE,iCAAiC,MAAM,oBAAoB,KAAK,EAAE;iBAC5E,CAAC,CAAC;YACL,CAAC;YACD,KAAK,CAAC,CAAC,CAAC,CAAC;gBACP,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,IAAA,eAAQ,EAAC;oBACb,OAAO,EAAE,mCAAmC,MAAM,aAAa,OAAO,CAAC,MAAM,yBAAyB,KAAK,EAAE;iBAC9G,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAIlB;QACC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACrC,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAEtD,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC;CACF;AAlCD,oCAkCC"}

package/dist/cjs/base/applications/common/constants.d.ts

@@ -0,0 +1,15 @@
+import type { TConstValue } from '@venizia/ignis-helpers/common';
+/** The `IArtifactIndex` field names, in registration order. `@venizia/ignis-boot` mirrors these values in its own `ArtifactIndexFields` - boot cannot depend on kernel. */
+export declare class ArtifactIndexFields {
+    static readonly CONFIGURATIONS = "configurations";
+    static readonly DATA_SOURCES = "dataSources";
+    static readonly COMPONENTS = "components";
+    static readonly REPOSITORIES = "repositories";
+    static readonly SERVICES = "services";
+    static readonly CONTROLLERS = "controllers";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+export type TArtifactIndexField = TConstValue<typeof ArtifactIndexFields>;
+export declare const SecFetchSiteValues: readonly ["same-origin", "same-site", "none", "cross-site"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/cjs/base/applications/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/base/applications/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,2KAA2K;AAC3K,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,cAAc,oBAAoB;IAClD,MAAM,CAAC,QAAQ,CAAC,YAAY,iBAAiB;IAC7C,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAkB;IAC9C,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAE5C,MAAM,CAAC,QAAQ,CAAC,UAAU,cAOvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE1E,eAAO,MAAM,kBAAkB,6DAA8D,CAAC"}

package/dist/cjs/base/applications/common/constants.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecFetchSiteValues = exports.ArtifactIndexFields = void 0;
+/** The `IArtifactIndex` field names, in registration order. `@venizia/ignis-boot` mirrors these values in its own `ArtifactIndexFields` - boot cannot depend on kernel. */
+class ArtifactIndexFields {
+    static { this.CONFIGURATIONS = 'configurations'; }
+    static { this.DATA_SOURCES = 'dataSources'; }
+    static { this.COMPONENTS = 'components'; }
+    static { this.REPOSITORIES = 'repositories'; }
+    static { this.SERVICES = 'services'; }
+    static { this.CONTROLLERS = 'controllers'; }
+    static { this.SCHEME_SET = new Set([
+        this.CONFIGURATIONS,
+        this.DATA_SOURCES,
+        this.COMPONENTS,
+        this.REPOSITORIES,
+        this.SERVICES,
+        this.CONTROLLERS,
+    ]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+exports.ArtifactIndexFields = ArtifactIndexFields;
+exports.SecFetchSiteValues = ['same-origin', 'same-site', 'none', 'cross-site'];
+//# sourceMappingURL=constants.js.map

package/dist/cjs/base/applications/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/base/applications/common/constants.ts"],"names":[],"mappings":";;;AAEA,2KAA2K;AAC3K,MAAa,mBAAmB;aACd,mBAAc,GAAG,gBAAgB,CAAC;aAClC,iBAAY,GAAG,aAAa,CAAC;aAC7B,eAAU,GAAG,YAAY,CAAC;aAC1B,iBAAY,GAAG,cAAc,CAAC;aAC9B,aAAQ,GAAG,UAAU,CAAC;aACtB,gBAAW,GAAG,aAAa,CAAC;aAE5B,eAAU,GAAG,IAAI,GAAG,CAAS;QAC3C,IAAI,CAAC,cAAc;QACnB,IAAI,CAAC,YAAY;QACjB,IAAI,CAAC,UAAU;QACf,IAAI,CAAC,YAAY;QACjB,IAAI,CAAC,QAAQ;QACb,IAAI,CAAC,WAAW;KACjB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAnBH,kDAoBC;AAIY,QAAA,kBAAkB,GAAG,CAAC,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,CAAU,CAAC"}

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/applications/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0CAAwB"}

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

@@ -0,0 +1,66 @@
+import type { OpenAPIHono } from '@hono/zod-openapi';
+import type { ValueOrPromise } from '@venizia/ignis-helpers/common';
+import type { Env, Schema } from 'hono';
+import type { TControllerTransport } from '../../../controllers/common/constants';
+import type { IComponentMixin, IControllerMixin, IRepositoryMixin, IServiceMixin, IStaticServeMixin } from '../../../mixins/common';
+import type { TArtifactIndexInput } from './artifacts';
+/** No `host`/`port`: a browser Worker has neither, and carrying them here made one silently configured with `localhost:3000`. `@venizia/ignis` widens this shape with both - see its `IServerApplicationConfigs`. */
+export interface IApplicationConfigs {
+    path: {
+        base: string;
+        isStrict: boolean;
+    };
+    requestId?: {
+        isStrict: boolean;
+    };
+    favicon?: string;
+    /** `environment` is the host's ambient environment name. Set it where there is none to read - a browser Worker - so the error middleware can tell "no ambient environment" from "misconfigured". Absent on a server, which reads `process.env.NODE_ENV`. */
+    error?: {
+        rootKey?: string;
+        environment?: string;
+    };
+    /** Generated indexes to register before `preConfigure` - one, or an array composed from several packages. */
+    artifacts?: TArtifactIndexInput;
+    /** Registers every class a stereotype decorated, so an application lists none of its own. Off by default: an absent `artifacts` keeps meaning "register nothing", never "register everything". Both together register the union, de-duplicated - which is how an application discovers its own classes and still composes a library index. */
+    discoverArtifacts?: boolean;
+    /** Boot-time checks. Without `binding`, nothing is verified, and hand registration and same-key override stay allowed. */
+    bootChecks?: {
+        binding?: {
+            doVerify: boolean;
+            allowManual: boolean;
+            allowOverride: boolean;
+        };
+    };
+    /** Controller transports to enable. Defaults to ['rest']. */
+    transports?: TControllerTransport[];
+    asyncContext?: {
+        enable: boolean;
+    };
+    debug?: {
+        shouldShowRoutes?: boolean;
+    };
+    [key: string]: any;
+}
+export interface IApplicationInfo {
+    name: string;
+    version: string;
+    description: string;
+    author?: {
+        name: string;
+        email: string;
+        url?: string;
+    };
+    [extra: string | symbol]: any;
+}
+/** Exactly what EVERY host implements. `getServerHost`/`getServerPort`/`getServerAddress`/`start`/`stop` are not here on purpose - a browser Worker can implement none of them; they live on `@venizia/ignis`'s `IServerApplication`. */
+export interface IApplication<AppEnv extends Env = Env, AppSchema extends Schema = Schema, BasePath extends string = '/'> {
+    getProjectRoot(): string;
+    getProjectConfigs(): IApplicationConfigs;
+    getServer(): OpenAPIHono<AppEnv, AppSchema, BasePath>;
+    getRootRouter(): OpenAPIHono<AppEnv, AppSchema, BasePath>;
+    setupMiddlewares(): ValueOrPromise<void>;
+    initialize(): ValueOrPromise<void>;
+}
+export interface IRestApplication extends IApplication, IComponentMixin, IControllerMixin, IRepositoryMixin, IServiceMixin, IStaticServeMixin {
+}
+//# sourceMappingURL=application.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../../../../../src/base/applications/common/types/application.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,qNAAqN;AACrN,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAC1C,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4PAA4P;IAC5P,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAEnD,6GAA6G;IAC7G,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAEhC,8UAA8U;IAC9U,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,0HAA0H;IAC1H,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE;YAAE,QAAQ,EAAE,OAAO,CAAC;YAAC,WAAW,EAAE,OAAO,CAAC;YAAC,aAAa,EAAE,OAAO,CAAA;SAAE,CAAC;KAC/E,CAAC;IAEF,6DAA6D;IAC7D,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAEpC,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IACnC,KAAK,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;CAC/B;AAED,yOAAyO;AACzO,MAAM,WAAW,YAAY,CAC3B,MAAM,SAAS,GAAG,GAAG,GAAG,EACxB,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,QAAQ,SAAS,MAAM,GAAG,GAAG;IAE7B,cAAc,IAAI,MAAM,CAAC;IACzB,iBAAiB,IAAI,mBAAmB,CAAC;IACzC,SAAS,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACtD,aAAa,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAE1D,gBAAgB,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IAEzC,UAAU,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,gBACf,SACE,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,iBAAiB;CAAG"}

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

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

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

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

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

@@ -0,0 +1,24 @@
+import type { TArtifactCondition } from '../../../../helpers/inversion/common/types';
+import type { TClass } from '@venizia/ignis-helpers/common';
+import type { BaseComponent } from '../../../components';
+import type { BaseConfiguration } from '../../../configurations';
+import type { IDataSource } from '../../../datasources';
+import type { IRepository } from '../../../repositories';
+import type { IService } from '../../../services';
+/** The shape `@venizia/ignis-boot`'s generator emits and `registerArtifacts()` consumes. Kinds are registered in this field order. */
+export interface IArtifactIndex {
+    configurations?: ReadonlyArray<TClass<BaseConfiguration>>;
+    dataSources?: ReadonlyArray<TClass<IDataSource>>;
+    components?: ReadonlyArray<TClass<BaseComponent>>;
+    repositories?: ReadonlyArray<TClass<IRepository>>;
+    services?: ReadonlyArray<TClass<IService>>;
+    controllers?: ReadonlyArray<TClass<unknown>>;
+}
+/** An index (or nested indexes) registered only when `when` answers true - the run-mode gate: a worker keeps its controllers out of the container instead of mounting routes no security step guards. Extends the never-typed kind fields so code that destructures kinds from a non-array input still compiles against the union. */
+export interface IConditionalArtifactIndex extends Partial<Record<keyof IArtifactIndex, never>> {
+    when: TArtifactCondition;
+    index: TArtifactIndexInput;
+}
+/** One index, a conditional entry, or any nesting of arrays of them - a library exports one, an application composes several. */
+export type TArtifactIndexInput = IArtifactIndex | IConditionalArtifactIndex | TArtifactIndexInput[];
+//# sourceMappingURL=artifacts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../../../../src/base/applications/common/types/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,sIAAsI;AACtI,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC1D,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IAClD,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3C,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;CAC9C;AAED,sUAAsU;AACtU,MAAM,WAAW,yBAA0B,SAAQ,OAAO,CAAC,MAAM,CAAC,MAAM,cAAc,EAAE,KAAK,CAAC,CAAC;IAC7F,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAED,iIAAiI;AACjI,MAAM,MAAM,mBAAmB,GAC7B,cAAc,GAAG,yBAAyB,GAAG,mBAAmB,EAAE,CAAC"}