@venizia/ignis-kernel 0.2.0-12 → 0.2.0-14

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

@@ -0,0 +1,56 @@
+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.js';
+import type { IComponentMixin, IControllerMixin, IRepositoryMixin, IServiceMixin, IStaticServeMixin } from '../../../mixins/common/index.js';
+import type { TArtifactIndexInput } from './artifacts.js';
+/** 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;
+    };
+    asyncContext?: {
+        enable: boolean;
+    };
+    /** Generated indexes to register before `preConfigure` - one, or an array composed from several packages. */
+    artifacts?: TArtifactIndexInput;
+    debug?: {
+        shouldShowRoutes?: boolean;
+    };
+    /** Controller transports to enable. Defaults to ['rest']. */
+    transports?: TControllerTransport[];
+    [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/esm/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;IACjB,4PAA4P;IAC5P,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IACnC,6GAA6G;IAC7G,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,KAAK,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACvC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,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/esm/base/applications/common/types/application.js

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

package/dist/esm/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/esm/base/applications/common/types/artifacts.d.ts

@@ -0,0 +1,16 @@
+import type { TClass } from '@venizia/ignis-helpers/common';
+import type { BaseComponent } from '../../../components/index.js';
+import type { IDataSource } from '../../../datasources/index.js';
+import type { IRepository } from '../../../repositories/index.js';
+import type { IService } from '../../../services/index.js';
+/** The shape `@venizia/ignis-boot`'s generator emits and `registerArtifacts()` consumes. Kinds are registered in this field order. */
+export interface IArtifactIndex {
+    dataSources?: ReadonlyArray<TClass<IDataSource>>;
+    components?: ReadonlyArray<TClass<BaseComponent>>;
+    repositories?: ReadonlyArray<TClass<IRepository>>;
+    services?: ReadonlyArray<TClass<IService>>;
+    controllers?: ReadonlyArray<TClass<unknown>>;
+}
+/** One index, or any nesting of arrays of indexes - a library exports one, an application composes several. */
+export type TArtifactIndexInput = IArtifactIndex | TArtifactIndexInput[];
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/esm/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,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,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,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,+GAA+G;AAC/G,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,mBAAmB,EAAE,CAAC"}

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

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

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

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

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

@@ -0,0 +1,4 @@
+export * from './application.js';
+export * from './artifacts.js';
+export * from './middlewares.js';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,4 @@
+export * from './application.js';
+export * from './artifacts.js';
+export * from './middlewares.js';
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,44 @@
+import type { Context } from 'hono';
+import type { IPRestrictionRules as IIPRestrictionRules } from 'hono/ip-restriction';
+import { SecFetchSiteValues } from '../constants.js';
+export interface IBaseMiddlewareOptions {
+    enable: boolean;
+    path?: string;
+    [extra: string | symbol]: any;
+}
+export interface ICompressOptions extends IBaseMiddlewareOptions {
+    encoding: 'gzip' | 'deflate';
+    threshold?: number;
+}
+export type TOrigin = string | string[] | ((origin: string, c: Context) => Promise<string | undefined | null> | string | undefined | null);
+export interface ICORSOptions extends IBaseMiddlewareOptions {
+    origin: TOrigin;
+    allowMethods?: string[] | ((origin: string, c: Context) => Promise<string[]> | string[]);
+    allowHeaders?: string[];
+    maxAge?: number;
+    credentials?: boolean;
+    exposeHeaders?: string[];
+}
+export type TIsAllowedOriginHandler = (origin: string, context: Context) => boolean;
+export type TSecFetchSite = (typeof SecFetchSiteValues)[number];
+export type TIsAllowedSecFetchSiteHandler = (secFetchSite: TSecFetchSite, context: Context) => boolean;
+export interface ICSRFOptions extends IBaseMiddlewareOptions {
+    origin?: string | string[] | TIsAllowedOriginHandler;
+    secFetchSite?: TSecFetchSite | TSecFetchSite[] | TIsAllowedSecFetchSiteHandler;
+}
+export interface IBodyLimitOptions extends IBaseMiddlewareOptions {
+    maxSize: number;
+    onError?: (c: Context) => Response | Promise<Response>;
+}
+export interface IRequestIdOptions extends IBaseMiddlewareOptions {
+}
+export interface IMiddlewareConfigs {
+    requestId?: IRequestIdOptions;
+    compress?: ICompressOptions;
+    cors?: ICORSOptions;
+    csrf?: ICSRFOptions;
+    bodyLimit?: IBodyLimitOptions;
+    ipRestriction?: IBaseMiddlewareOptions & IIPRestrictionRules;
+    [extra: string | symbol]: any;
+}
+//# sourceMappingURL=middlewares.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middlewares.d.ts","sourceRoot":"","sources":["../../../../../../src/base/applications/common/types/middlewares.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,kBAAkB,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAiB,SAAQ,sBAAsB;IAC9D,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,OAAO,GACf,MAAM,GACN,MAAM,EAAE,GACR,CAAC,CACC,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,OAAO,KACP,OAAO,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;AACzE,MAAM,WAAW,YAAa,SAAQ,sBAAsB;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,CAAC;IACzF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;AACpF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,6BAA6B,GAAG,CAC1C,YAAY,EAAE,aAAa,EAC3B,OAAO,EAAE,OAAO,KACb,OAAO,CAAC;AAEb,MAAM,WAAW,YAAa,SAAQ,sBAAsB;IAC1D,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,uBAAuB,CAAC;IACrD,YAAY,CAAC,EAAE,aAAa,GAAG,aAAa,EAAE,GAAG,6BAA6B,CAAC;CAChF;AAED,MAAM,WAAW,iBAAkB,SAAQ,sBAAsB;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,iBAAkB,SAAQ,sBAAsB;CAAG;AAEpE,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,aAAa,CAAC,EAAE,sBAAsB,GAAG,mBAAmB,CAAC;IAC7D,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;CAC/B"}

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,17 +1,18 @@
 import type { TBindingNamespace } from '../../common/bindings.js';
 import type { Binding } from '../../helpers/inversion/index.js';
-import type { BaseComponent } from '../components/index.js';
-import type { IDataSource } from '../datasources/index.js';
-import type { IRepository } from '../repositories/index.js';
-import type { IService } from '../services/index.js';
-import type { TMixinOpts } from '../mixins/types.js';
 import { OpenAPIHono } from '@hono/zod-openapi';
-import type { AnyObject, IConfigurable, TClass, ValueOrPromise } from '@venizia/ignis-helpers/common';
+import type { IConfigurable, TClass, ValueOrPromise } from '@venizia/ignis-helpers/common';
 import { RequestIdGenerator } from '@venizia/ignis-helpers/core';
 import type { Env, Schema } from 'hono';
+import type { BaseComponent } from '../components/index.js';
+import type { IDataSource } from '../datasources/index.js';
 import { BaseAppErrorMiddleware } from '../middlewares/app-error/app-error.middleware.js';
+import type { TMixinOpts } from '../mixins/common/index.js';
+import type { IRepository } from '../repositories/index.js';
+import type { IService } from '../services/index.js';
 import { AbstractApplication } from './abstract.js';
-import type { IApplicationConfigs } from './types.js';
+import type { IBootSequenceStep } from './boot-sequence.js';
+import type { IApplicationConfigs, TArtifactIndexInput } from './common/index.js';
 interface IRegisterDynamicBindingsOptions<T extends IConfigurable = IConfigurable> {
     namespace: TBindingNamespace;
     onBeforeConfigure?: (opts: {
@@ -43,40 +44,68 @@ export declare abstract class RestApplication<AppEnv extends Env = Env, AppSchem
     /** The error handler the default stack installs. `@venizia/ignis` overrides it to swap in the `ErrorPrettier`-backed formatter, which reaches `node:util` and so cannot live here. */
     protected buildErrorMiddleware(): BaseAppErrorMiddleware;
     /**
-     * The three registrations every host needs, in one place, so a server and a browser Worker cannot
-     * drift: a request id, the framework's error envelope, and a JSON 404.
-     *
-     * None is optional. Hono's own defaults answer a thrown `ApplicationError` with a generic 500 and
-     * an unrouted path with `text/plain` - a caller doing `response.json()` on that 404 gets a
-     * `SyntaxError` instead of an error envelope. And without `requestId()`, `context.get(REQUEST_ID_KEY)`
-     * is `undefined`, so `context.json` drops the one field that ties a response to a log line.
-     *
-     * Registered before `initialize()`, so an application installing its own handlers still wins.
+     * The three registrations every host needs: request id, error envelope, JSON 404 - without them a
+     * thrown `ApplicationError` is a generic 500, a 404 is `text/plain`, and no response carries a request id.
+     * Registered before `initialize()`, so an application's own handlers still win.
      */
     protected registerDefaultMiddlewares(): ValueOrPromise<void>;
     /**
-     * The artifact ordering, stated ONCE: datasources before repositories can auto-resolve them, and
-     * components before controllers because a component may contribute either.
-     *
-     * A browser Worker application inherits this and writes none of it. `BaseApplication` in
-     * `@venizia/ignis` is the one deliberate override - it interleaves phases only a server has
-     * (start-up banner, env validation, secret hydration and rotation) between these steps.
+     * The artifact order, stated once: datasources before the repositories that auto-resolve them,
+     * components before the controllers they may contribute. `BaseApplication` splices its server-only
+     * steps around these by name instead of rewriting the list.
      */
+    protected getBootSequence(): IBootSequenceStep[];
     initialize(): Promise<void>;
+    /** One measured log line per step, and a failure names its step before rethrowing, so a hung or failed boot is attributable without reading the sequence. */
+    protected runBootSequence(opts: {
+        steps: IBootSequenceStep[];
+    }): Promise<void>;
     protected inspectRoutes(): void;
+    /**
+     * `configured` is the drain's state, mutated in place: a fresh `Set` gives a one-shot complete
+     * drain (`RestComponent`); `registerDynamicBindings` passes its persistent per-namespace `Set`,
+     * which is why a second sweep touches only what the first one missed.
+     */
+    drainByTag<T>(opts: {
+        tag: string;
+        configured: Set<string>;
+        onEach: (opts: {
+            binding: Binding<T>;
+        }) => Promise<void>;
+    }): Promise<void>;
     protected registerDynamicBindings<T extends IConfigurable = IConfigurable>(opts: IRegisterDynamicBindingsOptions<T>): Promise<void>;
-    component<Base extends BaseComponent, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
+    /** The same-key guard behind every artifact registration (`component`/`controller`/`service`/`repository`/`dataSource`, and core-server's `booter`). `allowOverride` defaults true to match `bind()`'s overwrite behavior - `allowOverride: false` opts into strict mode. */
+    protected assertNoBindingCollision(opts: {
+        key: string;
+        allowOverride?: boolean;
+        caller: string;
+    }): void;
+    /** Resolution order for every registration: explicit `opts` > the class's `@injectable` defaults > the derived key and the kind's default scope. `order` and `when` are `registerArtifacts`' concern, not this one. */
+    private registerArtifact;
+    component<Base extends BaseComponent>(ctor: TClass<Base>, opts?: TMixinOpts): Binding<Base>;
     registerComponents(): Promise<void>;
     /**
-     * Handles the REST branch only - the kernel has no notion of gRPC (it reaches `node:module` via
-     * `AbstractGrpcController`, core-only). `BaseApplication` extends this with the gRPC branch, the
-     * unsupported-transport error and the orphaned-gRPC-controller warning.
+     * Second DATASOURCE sweep, for datasources components contributed at any depth. Calls
+     * `registerDynamicBindings` directly: `this.registerDataSources()` is polymorphic and an override
+     * would run twice. Runs after every component, so a component a datasource registers is never configured.
      */
+    registerContributedDataSources(): Promise<void>;
+    /** REST only - the kernel has no gRPC (it reaches `node:module`). `BaseApplication` adds the gRPC branch on top. */
     registerControllers(): Promise<void>;
-    controller<Base, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
-    service<Base extends IService, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
-    repository<Base extends IRepository, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
-    dataSource<Base extends IDataSource, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
+    /** SINGLETON like `component()`: `RestComponent` mounts the one instance it resolves, so a second resolution must be that instance, not an unmounted twin. */
+    controller<Base>(ctor: TClass<Base>, opts?: TMixinOpts): Binding<Base>;
+    service<Base extends IService>(ctor: TClass<Base>, opts?: TMixinOpts): Binding<Base>;
+    repository<Base extends IRepository>(ctor: TClass<Base>, opts?: TMixinOpts): Binding<Base>;
+    dataSource<Base extends IDataSource>(ctor: TClass<Base>, opts?: TMixinOpts): Binding<Base>;
+    /** Registers one index or a composition of indexes in dependency order: datasources, components, repositories, services, controllers. `when` and `order` from each class's decorator apply; a class registered by hand before this call keeps its earlier position. */
+    registerArtifacts(index: TArtifactIndexInput): Promise<void>;
+    /** The boot step behind `configs.artifacts`; an application with none configured registers nothing here. */
+    protected registerConfiguredArtifacts(): Promise<void>;
+    private flattenArtifactIndex;
+    /** The classes of one kind across every index, minus those whose `when` says no, sorted by `order` (stable). */
+    private selectArtifacts;
+    /** Each `@provide` method becomes a lazy provider: the component is resolved (SINGLETON) and the method called on first `get`, so a provided value may depend on datasources or secrets that do not exist yet at registration time. */
+    private bindProvidedKeys;
     registerDataSources(): Promise<void>;
 }
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../../../src/base/applications/rest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,MAAM,EACN,cAAc,EACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAiC,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAChG,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AAEvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,UAAU,+BAA+B,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa;IAC/E,SAAS,EAAE,iBAAiB,CAAC;IAE7B,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,EAAE,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClF;AAED,4NAA4N;AAC5N,8BAAsB,eAAe,CACnC,MAAM,SAAS,GAAG,GAAG,GAAG,EACxB,SAAS,SAAS,MAAM,GAAG,EAAE,EAC7B,QAAQ,SAAS,MAAM,GAAG,GAAG,CAC7B,SAAQ,mBAAmB;IAC3B,OAAO,CAAC,kBAAkB,CAAmC;IAE7D,sPAAsP;IACtP,SAAS,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAA;KAAE,CAAC;IAErE,SAAS,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/D,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;gBAE9C,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE;IAehE,aAAa,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC;IAIzD,SAAS,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC;cAIlC,oBAAoB;IAWvC,oHAAoH;IACpH,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAIrC,sLAAsL;IACtL,SAAS,CAAC,oBAAoB,IAAI,sBAAsB;IAYxD;;;;;;;;;;OAUG;IACH,SAAS,CAAC,0BAA0B,IAAI,cAAc,CAAC,IAAI,CAAC;IAQ5D;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC,SAAS,CAAC,aAAa;cAeP,uBAAuB,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,EAC7E,IAAI,EAAE,+BAA+B,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC;IA4ChB,SAAS,CAAC,IAAI,SAAS,aAAa,EAAE,IAAI,SAAS,SAAS,GAAG,GAAG,EAChE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAClB,IAAI,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC;IAUV,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBzC;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB1C,UAAU,CAAC,IAAI,EAAE,IAAI,SAAS,SAAS,GAAG,GAAG,EAC3C,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAClB,IAAI,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC;IAWhB,OAAO,CAAC,IAAI,SAAS,QAAQ,EAAE,IAAI,SAAS,SAAS,GAAG,GAAG,EACzD,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAClB,IAAI,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC;IAWhB,UAAU,CAAC,IAAI,SAAS,WAAW,EAAE,IAAI,SAAS,SAAS,GAAG,GAAG,EAC/D,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAClB,IAAI,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC;IAWhB,UAAU,CAAC,IAAI,SAAS,WAAW,EAAE,IAAI,SAAS,SAAS,GAAG,GAAG,EAC/D,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAClB,IAAI,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC;IAaV,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;CAU3C"}
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../../../src/base/applications/rest.ts"],"names":[],"mappings":"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"}