@venizia/ignis 0.4.7-0 → 0.4.7-2

package/dist/esm/components/websocket/handlers/bun.handler.js

@@ -1,22 +1,24 @@
 import { UuidHelper } from '@venizia/ignis-helpers/core';
-export function createBunFetchHandler(opts) {
-    const { wsPath, honoServer } = opts;
-    return async (req, server) => {
-        const url = new URL(req.url);
-        const isWebSocketUpgrade = url.pathname === wsPath && req.headers.get('upgrade')?.toLowerCase() === 'websocket';
-        if (!isWebSocketUpgrade) {
-            return honoServer.fetch(req, server);
-        }
-        // Accept connection — authentication happens post-connect via 'authenticate' event
-        const isUpgraded = server.upgrade(req, {
-            data: {
-                clientId: UuidHelper.getInstance().v4(),
-            },
-        });
-        if (!isUpgraded) {
-            return new Response('WebSocket upgrade failed', { status: 500 });
-        }
-        return undefined;
-    };
+export class WebSocketBunHandler {
+    static createFetchHandler(opts) {
+        const { wsPath, honoServer } = opts;
+        return async (req, server) => {
+            const url = new URL(req.url);
+            const isWebSocketUpgrade = url.pathname === wsPath && req.headers.get('upgrade')?.toLowerCase() === 'websocket';
+            if (!isWebSocketUpgrade) {
+                return honoServer.fetch(req, server);
+            }
+            // Accept connection - authentication happens post-connect via 'authenticate' event
+            const isUpgraded = server.upgrade(req, {
+                data: {
+                    clientId: UuidHelper.getInstance().v4(),
+                },
+            });
+            if (!isUpgraded) {
+                return new Response('WebSocket upgrade failed', { status: 500 });
+            }
+            return undefined;
+        };
+    }
 }
 //# sourceMappingURL=bun.handler.js.map

package/dist/esm/components/websocket/handlers/bun.handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"bun.handler.js","sourceRoot":"","sources":["../../../../../src/components/websocket/handlers/bun.handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,MAAM,UAAU,qBAAqB,CAAC,IAGrC;IACC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAEpC,OAAO,KAAK,EAAE,GAAY,EAAE,MAA0B,EAAiC,EAAE;QACvF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,kBAAkB,GACtB,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,KAAK,WAAW,CAAC;QAEvF,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxB,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;QAED,mFAAmF;QACnF,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;YACrC,IAAI,EAAE;gBACJ,QAAQ,EAAE,UAAU,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE;aACxC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,QAAQ,CAAC,0BAA0B,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type { TBunServerInstance } from '@/base/applications';\nimport { UuidHelper } from '@venizia/ignis-helpers/core';\nimport type { OpenAPIHono } from '@hono/zod-openapi';\n\nexport function createBunFetchHandler(opts: {\n  wsPath: string;\n  honoServer: OpenAPIHono;\n}): (req: Request, server: TBunServerInstance) => Promise<Response | undefined> {\n  const { wsPath, honoServer } = opts;\n\n  return async (req: Request, server: TBunServerInstance): Promise<Response | undefined> => {\n    const url = new URL(req.url);\n    const isWebSocketUpgrade =\n      url.pathname === wsPath && req.headers.get('upgrade')?.toLowerCase() === 'websocket';\n\n    if (!isWebSocketUpgrade) {\n      return honoServer.fetch(req, server);\n    }\n\n    // Accept connection — authentication happens post-connect via 'authenticate' event\n    const isUpgraded = server.upgrade(req, {\n      data: {\n        clientId: UuidHelper.getInstance().v4(),\n      },\n    });\n\n    if (!isUpgraded) {\n      return new Response('WebSocket upgrade failed', { status: 500 });\n    }\n\n    return undefined;\n  };\n}\n"]}
+{"version":3,"file":"bun.handler.js","sourceRoot":"","sources":["../../../../../src/components/websocket/handlers/bun.handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,MAAM,OAAO,mBAAmB;IAC9B,MAAM,CAAC,kBAAkB,CAAC,IAGzB;QACC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAEpC,OAAO,KAAK,EAAE,GAAY,EAAE,MAA0B,EAAiC,EAAE;YACvF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7B,MAAM,kBAAkB,GACtB,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,KAAK,WAAW,CAAC;YAEvF,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACxB,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACvC,CAAC;YAED,mFAAmF;YACnF,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;gBACrC,IAAI,EAAE;oBACJ,QAAQ,EAAE,UAAU,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE;iBACxC;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO,IAAI,QAAQ,CAAC,0BAA0B,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACnE,CAAC;YAED,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC;CACF","sourcesContent":["import type { TBunServerInstance } from '@/base/applications';\nimport { UuidHelper } from '@venizia/ignis-helpers/core';\nimport type { OpenAPIHono } from '@hono/zod-openapi';\n\nexport class WebSocketBunHandler {\n  static createFetchHandler(opts: {\n    wsPath: string;\n    honoServer: OpenAPIHono;\n  }): (req: Request, server: TBunServerInstance) => Promise<Response | undefined> {\n    const { wsPath, honoServer } = opts;\n\n    return async (req: Request, server: TBunServerInstance): Promise<Response | undefined> => {\n      const url = new URL(req.url);\n      const isWebSocketUpgrade =\n        url.pathname === wsPath && req.headers.get('upgrade')?.toLowerCase() === 'websocket';\n\n      if (!isWebSocketUpgrade) {\n        return honoServer.fetch(req, server);\n      }\n\n      // Accept connection - authentication happens post-connect via 'authenticate' event\n      const isUpgraded = server.upgrade(req, {\n        data: {\n          clientId: UuidHelper.getInstance().v4(),\n        },\n      });\n\n      if (!isUpgraded) {\n        return new Response('WebSocket upgrade failed', { status: 500 });\n      }\n\n      return undefined;\n    };\n  }\n}\n"]}

package/dist/esm/testing/assert-application-boots.d.ts

@@ -52,5 +52,10 @@ export interface IAssertApplicationBootsOptions {
  * It wraps `registerDynamicBindings` and `getBootSequence` on THIS instance only (an application's
  * own override of either still runs) and restores them whatever happens.
  */
-export declare const assertApplicationBoots: <Application extends BaseApplication>(application: Application | (() => Application | Promise<Application>), options?: IAssertApplicationBootsOptions) => Promise<Application>;
+export declare class ApplicationBootAssertion {
+    static assert<Application extends BaseApplication>(opts: {
+        application: Application | (() => Application | Promise<Application>);
+        options?: IAssertApplicationBootsOptions;
+    }): Promise<Application>;
+}
 //# sourceMappingURL=assert-application-boots.d.ts.map

package/dist/esm/testing/assert-application-boots.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assert-application-boots.d.ts","sourceRoot":"","sources":["../../../src/testing/assert-application-boots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAarE,4HAA4H;AAC5H,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,eAAe,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAErC;;;;OAIG;IACH,cAAc,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEpC;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAE9B;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAElC,mIAAmI;IACnI,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,yHAAyH;IACzH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAiJD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,sBAAsB,GAAU,WAAW,SAAS,eAAe,EAC9E,aAAa,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,EACrE,UAAS,8BAAmC,KAC3C,OAAO,CAAC,WAAW,CA0MrB,CAAC"}
+{"version":3,"file":"assert-application-boots.d.ts","sourceRoot":"","sources":["../../../src/testing/assert-application-boots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAarE,4HAA4H;AAC5H,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,eAAe,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAErC;;;;OAIG;IACH,cAAc,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEpC;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAE9B;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAElC,mIAAmI;IACnI,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,yHAAyH;IACzH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAiJD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,wBAAwB;WACtB,MAAM,CAAC,WAAW,SAAS,eAAe,EAAE,IAAI,EAAE;QAC7D,WAAW,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;QACtE,OAAO,CAAC,EAAE,8BAA8B,CAAC;KAC1C,GAAG,OAAO,CAAC,WAAW,CAAC;CA4MzB"}

package/dist/esm/testing/assert-application-boots.js

@@ -1,6 +1,6 @@
 import { ServerBootSteps } from '../base/applications/index.js';
 import { getError } from '@venizia/ignis-helpers/core';
-import { assertBindingsResolve } from '@venizia/ignis-inversion';
+import { BindingVerifier } from '@venizia/ignis-inversion';
 import { BindingNamespaces, BindingValueTypes, ControllerTransports, CoreBindings, MetadataRegistry, } from '@venizia/ignis-kernel';
 /** The boot sequence is the contract; these two are what the helper wraps on one instance. */
 const WRAPPED_METHODS = ['registerDynamicBindings', 'getBootSequence'];
@@ -19,7 +19,7 @@ const matchesTarget = (opts) => {
         : instance?.constructor === target);
 };
 const fail = (message) => {
-    throw getError({ message: `[assertApplicationBoots] ${message}` });
+    throw getError({ message: `[ApplicationBootAssertion.assert] ${message}` });
 };
 /** Replaces `object[name]` and returns the way back, even when `name` was inherited. */
 const patchProperty = (opts) => {
@@ -109,149 +109,152 @@ const assertNoDuplicateRoutes = (opts) => {
  * It wraps `registerDynamicBindings` and `getBootSequence` on THIS instance only (an application's
  * own override of either still runs) and restores them whatever happens.
  */
-export const assertApplicationBoots = async (application, options = {}) => {
-    const { keepDataSources = [], skipComponents = [], skipSteps = DEFAULT_SKIPPED_STEPS, verifyBindings = true, skipBindings = [], allowNoControllers = false, routes = true, } = options;
-    for (const step of skipSteps) {
-        if (!ServerBootSteps.isValid(step)) {
-            fail(`Unknown boot step in skipSteps: '${String(step)}' | Expected one of: ${[...ServerBootSteps.SCHEME_SET].join(', ')}`);
+export class ApplicationBootAssertion {
+    static async assert(opts) {
+        const { application, options = {} } = opts;
+        const { keepDataSources = [], skipComponents = [], skipSteps = DEFAULT_SKIPPED_STEPS, verifyBindings = true, skipBindings = [], allowNoControllers = false, routes = true, } = options;
+        for (const step of skipSteps) {
+            if (!ServerBootSteps.isValid(step)) {
+                fail(`Unknown boot step in skipSteps: '${String(step)}' | Expected one of: ${[...ServerBootSteps.SCHEME_SET].join(', ')}`);
+            }
         }
-    }
-    let target;
-    if (typeof application === 'function') {
-        const built = await application();
-        target = built;
-    }
-    else {
-        target = application;
-    }
-    if (bootedApplications.has(target) ||
-        Object.keys(target['registeredBindings'] ?? {}).length > 0) {
-        fail(`This application instance was already booted | A failed or finished boot leaves registrations behind, so build a new instance (pass a factory) for each call`);
-    }
-    bootedApplications.add(target);
-    for (const name of WRAPPED_METHODS) {
-        if (typeof target[name] !== 'function') {
-            fail(`The kernel method '${name}' is missing on this application | The helper cannot keep a boot offline without it, so it refuses to boot`);
+        let target;
+        if (typeof application === 'function') {
+            const built = await application();
+            target = built;
         }
-    }
-    const skippedSteps = new Set(skipSteps);
-    const patches = [];
-    let sweepsSeen = 0;
-    // The components whose `configure()` is running, innermost last: when the boot rejects, the last one is where it failed.
-    const configuringComponents = [];
-    const neutralise = async (opts) => {
-        const { namespace, binding } = opts;
-        const isDataSource = namespace === BindingNamespaces.DATASOURCE;
-        const isComponent = namespace === BindingNamespaces.COMPONENT;
-        if (!isDataSource && !isComponent) {
-            return;
-        }
-        const instance = target.get({ key: binding.key, isOptional: false });
-        if (typeof instance?.configure !== 'function') {
-            return;
+        else {
+            target = application;
         }
-        const shouldRun = isDataSource
-            ? matchesTarget({ targets: keepDataSources, binding, instance })
-            : !matchesTarget({ targets: skipComponents, binding, instance });
-        if (shouldRun) {
-            return;
+        if (bootedApplications.has(target) ||
+            Object.keys(target['registeredBindings'] ?? {}).length > 0) {
+            fail(`This application instance was already booted | A failed or finished boot leaves registrations behind, so build a new instance (pass a factory) for each call`);
         }
-        patches.push(patchProperty({ object: instance, name: 'configure', value: async () => { } }));
-    };
-    const originalRegisterDynamicBindings = target['registerDynamicBindings'];
-    const originalGetBootSequence = target['getBootSequence'];
-    const wrappedRegister = async (opts) => {
-        sweepsSeen += 1;
-        const userBefore = opts.onBeforeConfigure;
-        const userAfter = opts.onAfterConfigure;
-        return originalRegisterDynamicBindings.call(target, {
-            ...opts,
-            onBeforeConfigure: async ({ binding }) => {
-                await neutralise({ namespace: opts.namespace, binding });
-                if (opts.namespace === BindingNamespaces.COMPONENT) {
-                    const instance = target.get({ key: binding.key, isOptional: true });
-                    configuringComponents.push(String(instance?.constructor?.name ?? binding.key));
-                }
-                await userBefore?.({ binding });
-            },
-            onAfterConfigure: async ({ binding, instance }) => {
-                if (opts.namespace === BindingNamespaces.COMPONENT) {
-                    configuringComponents.pop();
-                }
-                await userAfter?.({ binding, instance });
-            },
-        });
-    };
-    patches.push(patchProperty({ object: target, name: 'registerDynamicBindings', value: wrappedRegister }));
-    patches.push(patchProperty({
-        object: target,
-        name: 'getBootSequence',
-        value: () => originalGetBootSequence.call(target).filter((step) => !skippedSteps.has(step.name)),
-    }));
-    if (target['registerDynamicBindings'] !== wrappedRegister) {
-        patches.forEach((patch) => patch.restore());
-        fail(`The wrap of 'registerDynamicBindings' did not take effect | Refusing to boot against real infrastructure`);
-    }
-    const configs = target['configs'];
-    const originalBootChecks = configs.bootChecks;
-    const originalBinding = originalBootChecks?.binding;
-    configs.bootChecks = {
-        ...originalBootChecks,
-        binding: {
-            allowManual: originalBinding?.allowManual ?? true,
-            allowOverride: originalBinding?.allowOverride ?? true,
-            doVerify: false,
-        },
-    };
-    try {
-        if (!target.isBound({ key: CoreBindings.APPLICATION_INSTANCE })) {
-            target.init();
-        }
-        await target.initialize();
-        const sweepsExpected = [
-            ServerBootSteps.REGISTER_DATA_SOURCES,
-            ServerBootSteps.REGISTER_COMPONENTS,
-            ServerBootSteps.REGISTER_CONTRIBUTED_DATA_SOURCES,
-        ].some((step) => !skippedSteps.has(step));
-        if (sweepsExpected && sweepsSeen === 0) {
-            fail(`The boot never went through 'registerDynamicBindings' | The wrap did not take effect, so datasources may have been configured`);
+        bootedApplications.add(target);
+        for (const name of WRAPPED_METHODS) {
+            if (typeof target[name] !== 'function') {
+                fail(`The kernel method '${name}' is missing on this application | The helper cannot keep a boot offline without it, so it refuses to boot`);
+            }
         }
-        if (verifyBindings) {
-            assertBindingsResolve({
-                container: target,
-                namespaces: [BindingNamespaces.SERVICE, BindingNamespaces.REPOSITORY],
-                skip: skipBindings,
-                scope: 'verifyBindings',
+        const skippedSteps = new Set(skipSteps);
+        const patches = [];
+        let sweepsSeen = 0;
+        // The components whose `configure()` is running, innermost last: when the boot rejects, the last one is where it failed.
+        const configuringComponents = [];
+        const neutralise = async (entry) => {
+            const { namespace, binding } = entry;
+            const isDataSource = namespace === BindingNamespaces.DATASOURCE;
+            const isComponent = namespace === BindingNamespaces.COMPONENT;
+            if (!isDataSource && !isComponent) {
+                return;
+            }
+            const instance = target.get({ key: binding.key, isOptional: false });
+            if (typeof instance?.configure !== 'function') {
+                return;
+            }
+            const shouldRun = isDataSource
+                ? matchesTarget({ targets: keepDataSources, binding, instance })
+                : !matchesTarget({ targets: skipComponents, binding, instance });
+            if (shouldRun) {
+                return;
+            }
+            patches.push(patchProperty({ object: instance, name: 'configure', value: async () => { } }));
+        };
+        const originalRegisterDynamicBindings = target['registerDynamicBindings'];
+        const originalGetBootSequence = target['getBootSequence'];
+        const wrappedRegister = async (sweepOptions) => {
+            sweepsSeen += 1;
+            const userBefore = sweepOptions.onBeforeConfigure;
+            const userAfter = sweepOptions.onAfterConfigure;
+            return originalRegisterDynamicBindings.call(target, {
+                ...sweepOptions,
+                onBeforeConfigure: async ({ binding }) => {
+                    await neutralise({ namespace: sweepOptions.namespace, binding });
+                    if (sweepOptions.namespace === BindingNamespaces.COMPONENT) {
+                        const instance = target.get({ key: binding.key, isOptional: true });
+                        configuringComponents.push(String(instance?.constructor?.name ?? binding.key));
+                    }
+                    await userBefore?.({ binding });
+                },
+                onAfterConfigure: async ({ binding, instance }) => {
+                    if (sweepOptions.namespace === BindingNamespaces.COMPONENT) {
+                        configuringComponents.pop();
+                    }
+                    await userAfter?.({ binding, instance });
+                },
             });
+        };
+        patches.push(patchProperty({ object: target, name: 'registerDynamicBindings', value: wrappedRegister }));
+        patches.push(patchProperty({
+            object: target,
+            name: 'getBootSequence',
+            value: () => originalGetBootSequence.call(target).filter((step) => !skippedSteps.has(step.name)),
+        }));
+        if (target['registerDynamicBindings'] !== wrappedRegister) {
+            patches.forEach((patch) => patch.restore());
+            fail(`The wrap of 'registerDynamicBindings' did not take effect | Refusing to boot against real infrastructure`);
         }
-        if (!allowNoControllers &&
-            target.findByTag({ tag: BindingNamespaces.CONTROLLER }).length === 0) {
-            fail(`The application registered no controller | A boot that registers nothing proves nothing: check the artifact index (for example the AutoArtifacts plugin under 'bun test'), or pass { allowNoControllers: true }`);
-        }
-        if (routes) {
-            assertNoDuplicateRoutes({ application: target });
-        }
-        return target;
-    }
-    catch (error) {
-        const failing = configuringComponents.at(-1);
-        if (failing) {
-            target.logger
-                .for('assertApplicationBoots')
-                .warn(`The boot failed inside component ${failing} | If it needs infrastructure, skipComponents: ['${failing}'] skips it, and skipBindings lists the services that depend on it`);
-        }
-        throw error;
-    }
-    finally {
-        for (const patch of patches.reverse()) {
-            patch.restore();
+        const configs = target['configs'];
+        const originalBootChecks = configs.bootChecks;
+        const originalBinding = originalBootChecks?.binding;
+        configs.bootChecks = {
+            ...originalBootChecks,
+            binding: {
+                allowManual: originalBinding?.allowManual ?? true,
+                allowOverride: originalBinding?.allowOverride ?? true,
+                doVerify: false,
+            },
+        };
+        try {
+            if (!target.isBound({ key: CoreBindings.APPLICATION_INSTANCE })) {
+                target.init();
+            }
+            await target.initialize();
+            const sweepsExpected = [
+                ServerBootSteps.REGISTER_DATA_SOURCES,
+                ServerBootSteps.REGISTER_COMPONENTS,
+                ServerBootSteps.REGISTER_CONTRIBUTED_DATA_SOURCES,
+            ].some((step) => !skippedSteps.has(step));
+            if (sweepsExpected && sweepsSeen === 0) {
+                fail(`The boot never went through 'registerDynamicBindings' | The wrap did not take effect, so datasources may have been configured`);
+            }
+            if (verifyBindings) {
+                BindingVerifier.assertResolve({
+                    container: target,
+                    namespaces: [BindingNamespaces.SERVICE, BindingNamespaces.REPOSITORY],
+                    skip: skipBindings,
+                    scope: 'verifyBindings',
+                });
+            }
+            if (!allowNoControllers &&
+                target.findByTag({ tag: BindingNamespaces.CONTROLLER }).length === 0) {
+                fail(`The application registered no controller | A boot that registers nothing proves nothing: check the artifact index (for example the AutoArtifacts plugin under 'bun test'), or pass { allowNoControllers: true }`);
+            }
+            if (routes) {
+                assertNoDuplicateRoutes({ application: target });
+            }
+            return target;
         }
-        if (originalBootChecks === undefined) {
-            delete configs.bootChecks;
+        catch (error) {
+            const failing = configuringComponents.at(-1);
+            if (failing) {
+                target.logger
+                    .for('ApplicationBootAssertion.assert')
+                    .warn(`The boot failed inside component ${failing} | If it needs infrastructure, skipComponents: ['${failing}'] skips it, and skipBindings lists the services that depend on it`);
+            }
+            throw error;
         }
-        else {
-            configs.bootChecks = originalBootChecks;
+        finally {
+            for (const patch of patches.reverse()) {
+                patch.restore();
+            }
+            if (originalBootChecks === undefined) {
+                delete configs.bootChecks;
+            }
+            else {
+                configs.bootChecks = originalBootChecks;
+            }
         }
     }
-};
+}
 //# sourceMappingURL=assert-application-boots.js.map

package/dist/esm/testing/assert-application-boots.js.map

@@ -1 +1 @@
-{"version":3,"file":"assert-application-boots.js","sourceRoot":"","sources":["../../../src/testing/assert-application-boots.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAwB,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAGL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AA8C/B,8FAA8F;AAC9F,MAAM,eAAe,GAAG,CAAC,yBAAyB,EAAE,iBAAiB,CAAU,CAAC;AAEhF,MAAM,qBAAqB,GAAsB;IAC/C,eAAe,CAAC,eAAe;IAC/B,eAAe,CAAC,sBAAsB;CACvC,CAAC;AAEF,kFAAkF;AAClF,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAE/B,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAAU,CAAC;AAiBjD,MAAM,aAAa,GAAG,CAAC,IAItB,EAAW,EAAE;IACZ,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAC5C,MAAM,SAAS,GAAuB,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC;IAElE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAC7B,OAAO,MAAM,KAAK,QAAQ;QACxB,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,MAAM,KAAK,SAAS;QAChD,CAAC,CAAC,QAAQ,EAAE,WAAW,KAAK,MAAM,CACrC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,OAAe,EAAS,EAAE;IACtC,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,4BAA4B,OAAO,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC,CAAC;AAEF,wFAAwF;AACxF,MAAM,aAAa,GAAG,CAAC,IAAuD,EAAU,EAAE;IACxF,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACrC,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEjE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnF,OAAO;QACL,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;gBAChD,OAAO;YACT,CAAC;YAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,IAAY,EAAU,EAAE;IAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACrF,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AAC5E,CAAC,CAAC;AAEF,8GAA8G;AAC9G,MAAM,uBAAuB,GAAG,CAAC,IAAsC,EAAQ,EAAE;IAC/E,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,MAAM,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAC;IACvD,MAAM,MAAM,GAAG,CAAC,SAAiB,EAAE,GAAW,EAAE,YAAoB,EAAQ,EAAE;QAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,GAAG,EAAkB,CAAC;QACnE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,WAAW,CAAC,SAAS,CAAyB;QAClE,GAAG,EAAE,iBAAiB,CAAC,UAAU;KAClC,CAAC,EAAE,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,KAAK,EAAE,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,MAAM;YACrB,CAAC,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;YAClE,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,QAAQ,CAAC,SAAS,KAAK,oBAAoB,CAAC,IAAI,EAAE,CAAC;YACxE,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAyB;YACvD,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;QACH,iHAAiH;QACjH,oHAAoH;QACpH,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,SAAS,EAAE,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACvD,IAAI,KAAK,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;gBACtC,SAAS;YACX,CAAC;YAED,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,aAAa,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC/F,CAAC;QAED,0GAA0G;QAC1G,8DAA8D;QAC9D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC3C,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,WAAW,EAAE;aAC/C,SAAS,CAAC,EAAE,MAAM,EAAG,MAA0B,CAAC,SAAS,EAAE,CAAC;YAC7D,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,IAAI,aAAa,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC7G,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,QAAQ,EAAE,CAAC;YACjD,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAC9C,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CACb,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,GAAG,CAAC,CAAC,CACnF,CAAC;IACF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAC1B,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,CACtB,GAAG,SAAS,mBAAmB,CAAC,GAAG,MAAM,CAAC;SACvC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,EAAE,CAC3B,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,cAAc,YAAY,SAAS,CAAC,CAAC,CAAC,GAAG,CACnE;SACA,IAAI,CAAC,IAAI,CAAC,EAAE,CAClB,CAAC;IACF,IAAI,CACF,GAAG,UAAU,CAAC,MAAM,0EAA0E,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,0GAA0G,CAC1N,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EACzC,WAAqE,EACrE,UAA0C,EAAE,EACtB,EAAE;IACxB,MAAM,EACJ,eAAe,GAAG,EAAE,EACpB,cAAc,GAAG,EAAE,EACnB,SAAS,GAAG,qBAAqB,EACjC,cAAc,GAAG,IAAI,EACrB,YAAY,GAAG,EAAE,EACjB,kBAAkB,GAAG,KAAK,EAC1B,MAAM,GAAG,IAAI,GACd,GAAG,OAAO,CAAC;IAEZ,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,IAAI,CACF,oCAAoC,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAmB,CAAC;IACxB,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,WAAW,EAAE,CAAC;QAClC,MAAM,GAAG,KAAK,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,WAAW,CAAC;IACvB,CAAC;IAED,IACE,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAC1D,CAAC;QACD,IAAI,CACF,8JAA8J,CAC/J,CAAC;IACJ,CAAC;IACD,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;YACvC,IAAI,CACF,sBAAsB,IAAI,4GAA4G,CACvI,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAAS,SAAS,CAAC,CAAC;IAChD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,yHAAyH;IACzH,MAAM,qBAAqB,GAAa,EAAE,CAAC;IAE3C,MAAM,UAAU,GAAG,KAAK,EAAE,IAGzB,EAAiB,EAAE;QAClB,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACpC,MAAM,YAAY,GAAG,SAAS,KAAK,iBAAiB,CAAC,UAAU,CAAC;QAChE,MAAM,WAAW,GAAG,SAAS,KAAK,iBAAiB,CAAC,SAAS,CAAC;QAC9D,IAAI,CAAC,YAAY,IAAI,CAAC,WAAW,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAU,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,IAAI,OAAO,QAAQ,EAAE,SAAS,KAAK,UAAU,EAAE,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,YAAY;YAC5B,CAAC,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;YAChE,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,IAAI,SAAS,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9F,CAAC,CAAC;IAEF,MAAM,+BAA+B,GAAG,MAAM,CAAC,yBAAyB,CAEtD,CAAC;IACnB,MAAM,uBAAuB,GAAG,MAAM,CAAC,iBAAiB,CAEtD,CAAC;IAEH,MAAM,eAAe,GAAG,KAAK,EAAE,IAA6B,EAAiB,EAAE;QAC7E,UAAU,IAAI,CAAC,CAAC;QAChB,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAExC,OAAO,+BAA+B,CAAC,IAAI,CAAC,MAAM,EAAE;YAClD,GAAG,IAAI;YACP,iBAAiB,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;gBACvC,MAAM,UAAU,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;gBACzD,IAAI,IAAI,CAAC,SAAS,KAAK,iBAAiB,CAAC,SAAS,EAAE,CAAC;oBACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAU,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC7E,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;gBACjF,CAAC;gBACD,MAAM,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAClC,CAAC;YACD,gBAAgB,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;gBAChD,IAAI,IAAI,CAAC,SAAS,KAAK,iBAAiB,CAAC,SAAS,EAAE,CAAC;oBACnD,qBAAqB,CAAC,GAAG,EAAE,CAAC;gBAC9B,CAAC;gBACD,MAAM,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3C,CAAC;SACF,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO,CAAC,IAAI,CACV,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAC3F,CAAC;IACF,OAAO,CAAC,IAAI,CACV,aAAa,CAAC;QACZ,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,GAAG,EAAE,CACV,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KACtF,CAAC,CACH,CAAC;IAEF,IAAK,MAAM,CAAC,yBAAyB,CAAa,KAAK,eAAe,EAAE,CAAC;QACvE,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5C,IAAI,CACF,0GAA0G,CAC3G,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAC9C,MAAM,eAAe,GAAG,kBAAkB,EAAE,OAAO,CAAC;IACpD,OAAO,CAAC,UAAU,GAAG;QACnB,GAAG,kBAAkB;QACrB,OAAO,EAAE;YACP,WAAW,EAAE,eAAe,EAAE,WAAW,IAAI,IAAI;YACjD,aAAa,EAAE,eAAe,EAAE,aAAa,IAAI,IAAI;YACrD,QAAQ,EAAE,KAAK;SAChB;KACF,CAAC;IAEF,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,oBAAoB,EAAE,CAAC,EAAE,CAAC;YAChE,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAE1B,MAAM,cAAc,GAAG;YACrB,eAAe,CAAC,qBAAqB;YACrC,eAAe,CAAC,mBAAmB;YACnC,eAAe,CAAC,iCAAiC;SAClD,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1C,IAAI,cAAc,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACvC,IAAI,CACF,+HAA+H,CAChI,CAAC;QACJ,CAAC;QAED,IAAI,cAAc,EAAE,CAAC;YACnB,qBAAqB,CAAC;gBACpB,SAAS,EAAE,MAAM;gBACjB,UAAU,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,CAAC,UAAU,CAAC;gBACrE,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,gBAAgB;aACxB,CAAC,CAAC;QACL,CAAC;QAED,IACE,CAAC,kBAAkB;YACnB,MAAM,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,iBAAiB,CAAC,UAAU,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,EACpE,CAAC;YACD,IAAI,CACF,iNAAiN,CAClN,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,uBAAuB,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,MAAM;iBACV,GAAG,CAAC,wBAAwB,CAAC;iBAC7B,IAAI,CACH,oCAAoC,OAAO,oDAAoD,OAAO,oEAAoE,CAC3K,CAAC;QACN,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACtC,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC;QAED,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,OAAO,CAAC,UAAU,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,UAAU,GAAG,kBAAkB,CAAC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC,CAAC","sourcesContent":["import type { BaseApplication } from '@/base/applications';\nimport { ServerBootSteps, type TServerBootStep } from '@/base/applications';\nimport type { AnyType, TClass } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { assertBindingsResolve } from '@venizia/ignis-inversion';\nimport {\n  type AbstractRestController,\n  type Binding,\n  BindingNamespaces,\n  BindingValueTypes,\n  ControllerTransports,\n  CoreBindings,\n  MetadataRegistry,\n} from '@venizia/ignis-kernel';\n\n/** A class (matched against the instance's constructor) or a string (matched against the binding key or the class name). */\nexport type TBootProbeTarget = TClass<AnyType> | string;\n\nexport interface IAssertApplicationBootsOptions {\n  /**\n   * Datasources whose real `configure()` runs. Every other datasource is bound and resolved but not\n   * configured, so no connection is made. Close a kept one with `await application.stop()`.\n   */\n  keepDataSources?: TBootProbeTarget[];\n\n  /**\n   * Components whose `configure()` (and so their `binding()`) is skipped, for the few that need\n   * infrastructure. Components run by default. What a skipped component would have registered is\n   * not registered.\n   */\n  skipComponents?: TBootProbeTarget[];\n\n  /**\n   * Boot steps that do not run. Default: `hydrateSecrets` and `wireSecretRotatables`, so a remote\n   * secrets provider is never contacted. A value REPLACES the default; an unknown name rejects\n   * before anything boots.\n   */\n  skipSteps?: TServerBootStep[];\n\n  /**\n   * Default `true`: after boot, resolves every service and repository with the shared core of\n   * `@venizia/ignis-inversion`, so an injection nobody references at boot still fails. An explicit value\n   * wins over the application's own `bootChecks`, whose boot step is off for the run.\n   */\n  verifyBindings?: boolean;\n\n  /**\n   * Services or repositories the verification leaves unresolved, for one whose constructor needs\n   * infrastructure. A class (exact), a class name or a binding key. A name that matches nothing rejects.\n   */\n  skipBindings?: TBootProbeTarget[];\n\n  /** Default `false`: an application that registered no controller proves nothing, for example when the artifact index was empty. */\n  allowNoControllers?: boolean;\n\n  /** Default `true`: this helper's own check that no method and path is mounted twice. IGNIS boot does not detect that. */\n  routes?: boolean;\n}\n\n/** The boot sequence is the contract; these two are what the helper wraps on one instance. */\nconst WRAPPED_METHODS = ['registerDynamicBindings', 'getBootSequence'] as const;\n\nconst DEFAULT_SKIPPED_STEPS: TServerBootStep[] = [\n  ServerBootSteps.HYDRATE_SECRETS,\n  ServerBootSteps.WIRE_SECRET_ROTATABLES,\n];\n\n/** Methods a route entry may carry that are middleware, not a mounted handler. */\nconst NON_ROUTE_METHOD = 'ALL';\n\nconst bootedApplications = new WeakSet<object>();\n\ninterface IProbeBinding {\n  key: string;\n}\n\ninterface IDynamicBindingsOptions {\n  namespace: string;\n  onBeforeConfigure?: (opts: { binding: Binding<AnyType> }) => Promise<void>;\n  onAfterConfigure?: (opts: { binding: Binding<AnyType>; instance: AnyType }) => Promise<void>;\n}\n\n/** What the helper replaced, so every path puts it back. */\ninterface IPatch {\n  restore: () => void;\n}\n\nconst matchesTarget = (opts: {\n  targets: TBootProbeTarget[];\n  binding: IProbeBinding;\n  instance: AnyType;\n}): boolean => {\n  const { targets, binding, instance } = opts;\n  const className: string | undefined = instance?.constructor?.name;\n\n  return targets.some((target) =>\n    typeof target === 'string'\n      ? target === binding.key || target === className\n      : instance?.constructor === target,\n  );\n};\n\nconst fail = (message: string): never => {\n  throw getError({ message: `[assertApplicationBoots] ${message}` });\n};\n\n/** Replaces `object[name]` and returns the way back, even when `name` was inherited. */\nconst patchProperty = (opts: { object: AnyType; name: string; value: unknown }): IPatch => {\n  const { object, name, value } = opts;\n  const descriptor = Object.getOwnPropertyDescriptor(object, name);\n\n  Object.defineProperty(object, name, { value, configurable: true, writable: true });\n\n  return {\n    restore: () => {\n      if (descriptor) {\n        Object.defineProperty(object, name, descriptor);\n        return;\n      }\n\n      delete object[name];\n    },\n  };\n};\n\nconst normalizePath = (path: string): string => {\n  const withParams = path.replace(/:[A-Za-z0-9_]+/g, ':param').replace(/\\/{2,}/g, '/');\n  return withParams.length > 1 ? withParams.replace(/\\/$/, '') : withParams;\n};\n\n/** The helper's own check: IGNIS mounts a method and path twice without complaint, and the first one wins. */\nconst assertNoDuplicateRoutes = (opts: { application: BaseApplication }): void => {\n  const { application } = opts;\n  // signature -> controller key -> how many times that controller declares it\n  const mounted = new Map<string, Map<string, number>>();\n  const record = (signature: string, key: string, declarations: number): void => {\n    const owners = mounted.get(signature) ?? new Map<string, number>();\n    owners.set(key, Math.max(owners.get(key) ?? 0, declarations));\n    mounted.set(signature, owners);\n  };\n\n  for (const binding of application.findByTag<AbstractRestController>({\n    tag: BindingNamespaces.CONTROLLER,\n  })) {\n    const target = binding.getBindingMeta({ type: BindingValueTypes.CLASS });\n    const metadata = target\n      ? MetadataRegistry.getInstance().getControllerMetadata({ target })\n      : undefined;\n\n    if (!metadata?.path || metadata.transport === ControllerTransports.GRPC) {\n      continue;\n    }\n\n    const instance = application.get<AbstractRestController>({\n      key: binding.key,\n      isOptional: true,\n    });\n    // Hono's `routes` has one entry PER HANDLER (a validator, an authenticate and the handler of one route are three\n    // entries with the same method and path), so an entry is not a declaration: a controller counts once per signature.\n    for (const route of instance?.getRouter().routes ?? []) {\n      if (route.method === NON_ROUTE_METHOD) {\n        continue;\n      }\n\n      record(`${route.method} ${normalizePath(`${metadata.path}/${route.path}`)}`, binding.key, 1);\n    }\n\n    // What the router cannot show: one controller declaring a method and path twice. Decorated routes are one\n    // metadata entry per declaration, so those are counted there.\n    const declared = new Map<string, number>();\n    for (const route of MetadataRegistry.getInstance()\n      .getRoutes({ target: (target as TClass<AnyType>).prototype })\n      ?.values() ?? []) {\n      const signature = `${String(route.method).toUpperCase()} ${normalizePath(`${metadata.path}/${route.path}`)}`;\n      declared.set(signature, (declared.get(signature) ?? 0) + 1);\n    }\n    for (const [signature, declarations] of declared) {\n      record(signature, binding.key, declarations);\n    }\n  }\n\n  const duplicates = [...mounted.entries()].filter(\n    ([, owners]) =>\n      owners.size > 1 || [...owners.values()].some((declarations) => declarations > 1),\n  );\n  if (duplicates.length === 0) {\n    return;\n  }\n\n  const lines = duplicates.map(\n    ([signature, owners]) =>\n      `${signature} | controllers: ${[...owners]\n        .map(([key, declarations]) =>\n          declarations > 1 ? `${key} (declared ${declarations} times)` : key,\n        )\n        .join(', ')}`,\n  );\n  fail(\n    `${duplicates.length} route(s) are mounted more than once, and only the first one answers | ${lines.join(' ; ')} | This is the helper's own check (IGNIS boot does not detect it); pass { routes: false } to turn it off`,\n  );\n};\n\n/**\n * Proves an IGNIS application boots, without a datasource connection, a socket or a secrets provider:\n * it runs the application's own boot sequence (`init()` then `initialize()`) and never calls `start()`,\n * so no socket is opened and no post-start hook runs.\n *\n * Datasources are bound and resolved but not configured, unless named in `keepDataSources`; the\n * secrets steps are skipped; every other step and every component runs as in a real boot. A component\n * that opens Redis, Kafka or S3 in `binding()` therefore runs for real: name it in `skipComponents`.\n * When the boot fails inside a component, one warning names it; the rejection is still the original error. When the\n * boot fails, the rejection is the original error. The application stays booted and is returned;\n * a failed boot leaves a half-booted instance, so build a new one rather than reuse it.\n *\n * It wraps `registerDynamicBindings` and `getBootSequence` on THIS instance only (an application's\n * own override of either still runs) and restores them whatever happens.\n */\nexport const assertApplicationBoots = async <Application extends BaseApplication>(\n  application: Application | (() => Application | Promise<Application>),\n  options: IAssertApplicationBootsOptions = {},\n): Promise<Application> => {\n  const {\n    keepDataSources = [],\n    skipComponents = [],\n    skipSteps = DEFAULT_SKIPPED_STEPS,\n    verifyBindings = true,\n    skipBindings = [],\n    allowNoControllers = false,\n    routes = true,\n  } = options;\n\n  for (const step of skipSteps) {\n    if (!ServerBootSteps.isValid(step)) {\n      fail(\n        `Unknown boot step in skipSteps: '${String(step)}' | Expected one of: ${[...ServerBootSteps.SCHEME_SET].join(', ')}`,\n      );\n    }\n  }\n\n  let target: Application;\n  if (typeof application === 'function') {\n    const built = await application();\n    target = built;\n  } else {\n    target = application;\n  }\n\n  if (\n    bootedApplications.has(target) ||\n    Object.keys(target['registeredBindings'] ?? {}).length > 0\n  ) {\n    fail(\n      `This application instance was already booted | A failed or finished boot leaves registrations behind, so build a new instance (pass a factory) for each call`,\n    );\n  }\n  bootedApplications.add(target);\n\n  for (const name of WRAPPED_METHODS) {\n    if (typeof target[name] !== 'function') {\n      fail(\n        `The kernel method '${name}' is missing on this application | The helper cannot keep a boot offline without it, so it refuses to boot`,\n      );\n    }\n  }\n\n  const skippedSteps = new Set<string>(skipSteps);\n  const patches: IPatch[] = [];\n  let sweepsSeen = 0;\n  // The components whose `configure()` is running, innermost last: when the boot rejects, the last one is where it failed.\n  const configuringComponents: string[] = [];\n\n  const neutralise = async (opts: {\n    namespace: string;\n    binding: Binding<AnyType>;\n  }): Promise<void> => {\n    const { namespace, binding } = opts;\n    const isDataSource = namespace === BindingNamespaces.DATASOURCE;\n    const isComponent = namespace === BindingNamespaces.COMPONENT;\n    if (!isDataSource && !isComponent) {\n      return;\n    }\n\n    const instance = target.get<AnyType>({ key: binding.key, isOptional: false });\n    if (typeof instance?.configure !== 'function') {\n      return;\n    }\n\n    const shouldRun = isDataSource\n      ? matchesTarget({ targets: keepDataSources, binding, instance })\n      : !matchesTarget({ targets: skipComponents, binding, instance });\n    if (shouldRun) {\n      return;\n    }\n\n    patches.push(patchProperty({ object: instance, name: 'configure', value: async () => {} }));\n  };\n\n  const originalRegisterDynamicBindings = target['registerDynamicBindings'] as unknown as (\n    opts: IDynamicBindingsOptions,\n  ) => Promise<void>;\n  const originalGetBootSequence = target['getBootSequence'] as unknown as () => Array<{\n    name: string;\n  }>;\n\n  const wrappedRegister = async (opts: IDynamicBindingsOptions): Promise<void> => {\n    sweepsSeen += 1;\n    const userBefore = opts.onBeforeConfigure;\n    const userAfter = opts.onAfterConfigure;\n\n    return originalRegisterDynamicBindings.call(target, {\n      ...opts,\n      onBeforeConfigure: async ({ binding }) => {\n        await neutralise({ namespace: opts.namespace, binding });\n        if (opts.namespace === BindingNamespaces.COMPONENT) {\n          const instance = target.get<AnyType>({ key: binding.key, isOptional: true });\n          configuringComponents.push(String(instance?.constructor?.name ?? binding.key));\n        }\n        await userBefore?.({ binding });\n      },\n      onAfterConfigure: async ({ binding, instance }) => {\n        if (opts.namespace === BindingNamespaces.COMPONENT) {\n          configuringComponents.pop();\n        }\n        await userAfter?.({ binding, instance });\n      },\n    });\n  };\n\n  patches.push(\n    patchProperty({ object: target, name: 'registerDynamicBindings', value: wrappedRegister }),\n  );\n  patches.push(\n    patchProperty({\n      object: target,\n      name: 'getBootSequence',\n      value: () =>\n        originalGetBootSequence.call(target).filter((step) => !skippedSteps.has(step.name)),\n    }),\n  );\n\n  if ((target['registerDynamicBindings'] as unknown) !== wrappedRegister) {\n    patches.forEach((patch) => patch.restore());\n    fail(\n      `The wrap of 'registerDynamicBindings' did not take effect | Refusing to boot against real infrastructure`,\n    );\n  }\n\n  const configs = target['configs'];\n  const originalBootChecks = configs.bootChecks;\n  const originalBinding = originalBootChecks?.binding;\n  configs.bootChecks = {\n    ...originalBootChecks,\n    binding: {\n      allowManual: originalBinding?.allowManual ?? true,\n      allowOverride: originalBinding?.allowOverride ?? true,\n      doVerify: false,\n    },\n  };\n\n  try {\n    if (!target.isBound({ key: CoreBindings.APPLICATION_INSTANCE })) {\n      target.init();\n    }\n\n    await target.initialize();\n\n    const sweepsExpected = [\n      ServerBootSteps.REGISTER_DATA_SOURCES,\n      ServerBootSteps.REGISTER_COMPONENTS,\n      ServerBootSteps.REGISTER_CONTRIBUTED_DATA_SOURCES,\n    ].some((step) => !skippedSteps.has(step));\n    if (sweepsExpected && sweepsSeen === 0) {\n      fail(\n        `The boot never went through 'registerDynamicBindings' | The wrap did not take effect, so datasources may have been configured`,\n      );\n    }\n\n    if (verifyBindings) {\n      assertBindingsResolve({\n        container: target,\n        namespaces: [BindingNamespaces.SERVICE, BindingNamespaces.REPOSITORY],\n        skip: skipBindings,\n        scope: 'verifyBindings',\n      });\n    }\n\n    if (\n      !allowNoControllers &&\n      target.findByTag({ tag: BindingNamespaces.CONTROLLER }).length === 0\n    ) {\n      fail(\n        `The application registered no controller | A boot that registers nothing proves nothing: check the artifact index (for example the AutoArtifacts plugin under 'bun test'), or pass { allowNoControllers: true }`,\n      );\n    }\n\n    if (routes) {\n      assertNoDuplicateRoutes({ application: target });\n    }\n\n    return target;\n  } catch (error) {\n    const failing = configuringComponents.at(-1);\n    if (failing) {\n      target.logger\n        .for('assertApplicationBoots')\n        .warn(\n          `The boot failed inside component ${failing} | If it needs infrastructure, skipComponents: ['${failing}'] skips it, and skipBindings lists the services that depend on it`,\n        );\n    }\n\n    throw error;\n  } finally {\n    for (const patch of patches.reverse()) {\n      patch.restore();\n    }\n\n    if (originalBootChecks === undefined) {\n      delete configs.bootChecks;\n    } else {\n      configs.bootChecks = originalBootChecks;\n    }\n  }\n};\n"]}
+{"version":3,"file":"assert-application-boots.js","sourceRoot":"","sources":["../../../src/testing/assert-application-boots.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BaseApplication } from '@/base/applications';\nimport { ServerBootSteps, type TServerBootStep } from '@/base/applications';\nimport type { AnyType, TClass } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { BindingVerifier } from '@venizia/ignis-inversion';\nimport {\n  type AbstractRestController,\n  type Binding,\n  BindingNamespaces,\n  BindingValueTypes,\n  ControllerTransports,\n  CoreBindings,\n  MetadataRegistry,\n} from '@venizia/ignis-kernel';\n\n/** A class (matched against the instance's constructor) or a string (matched against the binding key or the class name). */\nexport type TBootProbeTarget = TClass<AnyType> | string;\n\nexport interface IAssertApplicationBootsOptions {\n  /**\n   * Datasources whose real `configure()` runs. Every other datasource is bound and resolved but not\n   * configured, so no connection is made. Close a kept one with `await application.stop()`.\n   */\n  keepDataSources?: TBootProbeTarget[];\n\n  /**\n   * Components whose `configure()` (and so their `binding()`) is skipped, for the few that need\n   * infrastructure. Components run by default. What a skipped component would have registered is\n   * not registered.\n   */\n  skipComponents?: TBootProbeTarget[];\n\n  /**\n   * Boot steps that do not run. Default: `hydrateSecrets` and `wireSecretRotatables`, so a remote\n   * secrets provider is never contacted. A value REPLACES the default; an unknown name rejects\n   * before anything boots.\n   */\n  skipSteps?: TServerBootStep[];\n\n  /**\n   * Default `true`: after boot, resolves every service and repository with the shared core of\n   * `@venizia/ignis-inversion`, so an injection nobody references at boot still fails. An explicit value\n   * wins over the application's own `bootChecks`, whose boot step is off for the run.\n   */\n  verifyBindings?: boolean;\n\n  /**\n   * Services or repositories the verification leaves unresolved, for one whose constructor needs\n   * infrastructure. A class (exact), a class name or a binding key. A name that matches nothing rejects.\n   */\n  skipBindings?: TBootProbeTarget[];\n\n  /** Default `false`: an application that registered no controller proves nothing, for example when the artifact index was empty. */\n  allowNoControllers?: boolean;\n\n  /** Default `true`: this helper's own check that no method and path is mounted twice. IGNIS boot does not detect that. */\n  routes?: boolean;\n}\n\n/** The boot sequence is the contract; these two are what the helper wraps on one instance. */\nconst WRAPPED_METHODS = ['registerDynamicBindings', 'getBootSequence'] as const;\n\nconst DEFAULT_SKIPPED_STEPS: TServerBootStep[] = [\n  ServerBootSteps.HYDRATE_SECRETS,\n  ServerBootSteps.WIRE_SECRET_ROTATABLES,\n];\n\n/** Methods a route entry may carry that are middleware, not a mounted handler. */\nconst NON_ROUTE_METHOD = 'ALL';\n\nconst bootedApplications = new WeakSet<object>();\n\ninterface IProbeBinding {\n  key: string;\n}\n\ninterface IDynamicBindingsOptions {\n  namespace: string;\n  onBeforeConfigure?: (opts: { binding: Binding<AnyType> }) => Promise<void>;\n  onAfterConfigure?: (opts: { binding: Binding<AnyType>; instance: AnyType }) => Promise<void>;\n}\n\n/** What the helper replaced, so every path puts it back. */\ninterface IPatch {\n  restore: () => void;\n}\n\nconst matchesTarget = (opts: {\n  targets: TBootProbeTarget[];\n  binding: IProbeBinding;\n  instance: AnyType;\n}): boolean => {\n  const { targets, binding, instance } = opts;\n  const className: string | undefined = instance?.constructor?.name;\n\n  return targets.some((target) =>\n    typeof target === 'string'\n      ? target === binding.key || target === className\n      : instance?.constructor === target,\n  );\n};\n\nconst fail = (message: string): never => {\n  throw getError({ message: `[ApplicationBootAssertion.assert] ${message}` });\n};\n\n/** Replaces `object[name]` and returns the way back, even when `name` was inherited. */\nconst patchProperty = (opts: { object: AnyType; name: string; value: unknown }): IPatch => {\n  const { object, name, value } = opts;\n  const descriptor = Object.getOwnPropertyDescriptor(object, name);\n\n  Object.defineProperty(object, name, { value, configurable: true, writable: true });\n\n  return {\n    restore: () => {\n      if (descriptor) {\n        Object.defineProperty(object, name, descriptor);\n        return;\n      }\n\n      delete object[name];\n    },\n  };\n};\n\nconst normalizePath = (path: string): string => {\n  const withParams = path.replace(/:[A-Za-z0-9_]+/g, ':param').replace(/\\/{2,}/g, '/');\n  return withParams.length > 1 ? withParams.replace(/\\/$/, '') : withParams;\n};\n\n/** The helper's own check: IGNIS mounts a method and path twice without complaint, and the first one wins. */\nconst assertNoDuplicateRoutes = (opts: { application: BaseApplication }): void => {\n  const { application } = opts;\n  // signature -> controller key -> how many times that controller declares it\n  const mounted = new Map<string, Map<string, number>>();\n  const record = (signature: string, key: string, declarations: number): void => {\n    const owners = mounted.get(signature) ?? new Map<string, number>();\n    owners.set(key, Math.max(owners.get(key) ?? 0, declarations));\n    mounted.set(signature, owners);\n  };\n\n  for (const binding of application.findByTag<AbstractRestController>({\n    tag: BindingNamespaces.CONTROLLER,\n  })) {\n    const target = binding.getBindingMeta({ type: BindingValueTypes.CLASS });\n    const metadata = target\n      ? MetadataRegistry.getInstance().getControllerMetadata({ target })\n      : undefined;\n\n    if (!metadata?.path || metadata.transport === ControllerTransports.GRPC) {\n      continue;\n    }\n\n    const instance = application.get<AbstractRestController>({\n      key: binding.key,\n      isOptional: true,\n    });\n    // Hono's `routes` has one entry PER HANDLER (a validator, an authenticate and the handler of one route are three\n    // entries with the same method and path), so an entry is not a declaration: a controller counts once per signature.\n    for (const route of instance?.getRouter().routes ?? []) {\n      if (route.method === NON_ROUTE_METHOD) {\n        continue;\n      }\n\n      record(`${route.method} ${normalizePath(`${metadata.path}/${route.path}`)}`, binding.key, 1);\n    }\n\n    // What the router cannot show: one controller declaring a method and path twice. Decorated routes are one\n    // metadata entry per declaration, so those are counted there.\n    const declared = new Map<string, number>();\n    for (const route of MetadataRegistry.getInstance()\n      .getRoutes({ target: (target as TClass<AnyType>).prototype })\n      ?.values() ?? []) {\n      const signature = `${String(route.method).toUpperCase()} ${normalizePath(`${metadata.path}/${route.path}`)}`;\n      declared.set(signature, (declared.get(signature) ?? 0) + 1);\n    }\n    for (const [signature, declarations] of declared) {\n      record(signature, binding.key, declarations);\n    }\n  }\n\n  const duplicates = [...mounted.entries()].filter(\n    ([, owners]) =>\n      owners.size > 1 || [...owners.values()].some((declarations) => declarations > 1),\n  );\n  if (duplicates.length === 0) {\n    return;\n  }\n\n  const lines = duplicates.map(\n    ([signature, owners]) =>\n      `${signature} | controllers: ${[...owners]\n        .map(([key, declarations]) =>\n          declarations > 1 ? `${key} (declared ${declarations} times)` : key,\n        )\n        .join(', ')}`,\n  );\n  fail(\n    `${duplicates.length} route(s) are mounted more than once, and only the first one answers | ${lines.join(' ; ')} | This is the helper's own check (IGNIS boot does not detect it); pass { routes: false } to turn it off`,\n  );\n};\n\n/**\n * Proves an IGNIS application boots, without a datasource connection, a socket or a secrets provider:\n * it runs the application's own boot sequence (`init()` then `initialize()`) and never calls `start()`,\n * so no socket is opened and no post-start hook runs.\n *\n * Datasources are bound and resolved but not configured, unless named in `keepDataSources`; the\n * secrets steps are skipped; every other step and every component runs as in a real boot. A component\n * that opens Redis, Kafka or S3 in `binding()` therefore runs for real: name it in `skipComponents`.\n * When the boot fails inside a component, one warning names it; the rejection is still the original error. When the\n * boot fails, the rejection is the original error. The application stays booted and is returned;\n * a failed boot leaves a half-booted instance, so build a new one rather than reuse it.\n *\n * It wraps `registerDynamicBindings` and `getBootSequence` on THIS instance only (an application's\n * own override of either still runs) and restores them whatever happens.\n */\nexport class ApplicationBootAssertion {\n  static async assert<Application extends BaseApplication>(opts: {\n    application: Application | (() => Application | Promise<Application>);\n    options?: IAssertApplicationBootsOptions;\n  }): Promise<Application> {\n    const { application, options = {} } = opts;\n    const {\n      keepDataSources = [],\n      skipComponents = [],\n      skipSteps = DEFAULT_SKIPPED_STEPS,\n      verifyBindings = true,\n      skipBindings = [],\n      allowNoControllers = false,\n      routes = true,\n    } = options;\n\n    for (const step of skipSteps) {\n      if (!ServerBootSteps.isValid(step)) {\n        fail(\n          `Unknown boot step in skipSteps: '${String(step)}' | Expected one of: ${[...ServerBootSteps.SCHEME_SET].join(', ')}`,\n        );\n      }\n    }\n\n    let target: Application;\n    if (typeof application === 'function') {\n      const built = await application();\n      target = built;\n    } else {\n      target = application;\n    }\n\n    if (\n      bootedApplications.has(target) ||\n      Object.keys(target['registeredBindings'] ?? {}).length > 0\n    ) {\n      fail(\n        `This application instance was already booted | A failed or finished boot leaves registrations behind, so build a new instance (pass a factory) for each call`,\n      );\n    }\n    bootedApplications.add(target);\n\n    for (const name of WRAPPED_METHODS) {\n      if (typeof target[name] !== 'function') {\n        fail(\n          `The kernel method '${name}' is missing on this application | The helper cannot keep a boot offline without it, so it refuses to boot`,\n        );\n      }\n    }\n\n    const skippedSteps = new Set<string>(skipSteps);\n    const patches: IPatch[] = [];\n    let sweepsSeen = 0;\n    // The components whose `configure()` is running, innermost last: when the boot rejects, the last one is where it failed.\n    const configuringComponents: string[] = [];\n\n    const neutralise = async (entry: {\n      namespace: string;\n      binding: Binding<AnyType>;\n    }): Promise<void> => {\n      const { namespace, binding } = entry;\n      const isDataSource = namespace === BindingNamespaces.DATASOURCE;\n      const isComponent = namespace === BindingNamespaces.COMPONENT;\n      if (!isDataSource && !isComponent) {\n        return;\n      }\n\n      const instance = target.get<AnyType>({ key: binding.key, isOptional: false });\n      if (typeof instance?.configure !== 'function') {\n        return;\n      }\n\n      const shouldRun = isDataSource\n        ? matchesTarget({ targets: keepDataSources, binding, instance })\n        : !matchesTarget({ targets: skipComponents, binding, instance });\n      if (shouldRun) {\n        return;\n      }\n\n      patches.push(patchProperty({ object: instance, name: 'configure', value: async () => {} }));\n    };\n\n    const originalRegisterDynamicBindings = target['registerDynamicBindings'] as unknown as (\n      opts: IDynamicBindingsOptions,\n    ) => Promise<void>;\n    const originalGetBootSequence = target['getBootSequence'] as unknown as () => Array<{\n      name: string;\n    }>;\n\n    const wrappedRegister = async (sweepOptions: IDynamicBindingsOptions): Promise<void> => {\n      sweepsSeen += 1;\n      const userBefore = sweepOptions.onBeforeConfigure;\n      const userAfter = sweepOptions.onAfterConfigure;\n\n      return originalRegisterDynamicBindings.call(target, {\n        ...sweepOptions,\n        onBeforeConfigure: async ({ binding }) => {\n          await neutralise({ namespace: sweepOptions.namespace, binding });\n          if (sweepOptions.namespace === BindingNamespaces.COMPONENT) {\n            const instance = target.get<AnyType>({ key: binding.key, isOptional: true });\n            configuringComponents.push(String(instance?.constructor?.name ?? binding.key));\n          }\n          await userBefore?.({ binding });\n        },\n        onAfterConfigure: async ({ binding, instance }) => {\n          if (sweepOptions.namespace === BindingNamespaces.COMPONENT) {\n            configuringComponents.pop();\n          }\n          await userAfter?.({ binding, instance });\n        },\n      });\n    };\n\n    patches.push(\n      patchProperty({ object: target, name: 'registerDynamicBindings', value: wrappedRegister }),\n    );\n    patches.push(\n      patchProperty({\n        object: target,\n        name: 'getBootSequence',\n        value: () =>\n          originalGetBootSequence.call(target).filter((step) => !skippedSteps.has(step.name)),\n      }),\n    );\n\n    if ((target['registerDynamicBindings'] as unknown) !== wrappedRegister) {\n      patches.forEach((patch) => patch.restore());\n      fail(\n        `The wrap of 'registerDynamicBindings' did not take effect | Refusing to boot against real infrastructure`,\n      );\n    }\n\n    const configs = target['configs'];\n    const originalBootChecks = configs.bootChecks;\n    const originalBinding = originalBootChecks?.binding;\n    configs.bootChecks = {\n      ...originalBootChecks,\n      binding: {\n        allowManual: originalBinding?.allowManual ?? true,\n        allowOverride: originalBinding?.allowOverride ?? true,\n        doVerify: false,\n      },\n    };\n\n    try {\n      if (!target.isBound({ key: CoreBindings.APPLICATION_INSTANCE })) {\n        target.init();\n      }\n\n      await target.initialize();\n\n      const sweepsExpected = [\n        ServerBootSteps.REGISTER_DATA_SOURCES,\n        ServerBootSteps.REGISTER_COMPONENTS,\n        ServerBootSteps.REGISTER_CONTRIBUTED_DATA_SOURCES,\n      ].some((step) => !skippedSteps.has(step));\n      if (sweepsExpected && sweepsSeen === 0) {\n        fail(\n          `The boot never went through 'registerDynamicBindings' | The wrap did not take effect, so datasources may have been configured`,\n        );\n      }\n\n      if (verifyBindings) {\n        BindingVerifier.assertResolve({\n          container: target,\n          namespaces: [BindingNamespaces.SERVICE, BindingNamespaces.REPOSITORY],\n          skip: skipBindings,\n          scope: 'verifyBindings',\n        });\n      }\n\n      if (\n        !allowNoControllers &&\n        target.findByTag({ tag: BindingNamespaces.CONTROLLER }).length === 0\n      ) {\n        fail(\n          `The application registered no controller | A boot that registers nothing proves nothing: check the artifact index (for example the AutoArtifacts plugin under 'bun test'), or pass { allowNoControllers: true }`,\n        );\n      }\n\n      if (routes) {\n        assertNoDuplicateRoutes({ application: target });\n      }\n\n      return target;\n    } catch (error) {\n      const failing = configuringComponents.at(-1);\n      if (failing) {\n        target.logger\n          .for('ApplicationBootAssertion.assert')\n          .warn(\n            `The boot failed inside component ${failing} | If it needs infrastructure, skipComponents: ['${failing}'] skips it, and skipBindings lists the services that depend on it`,\n          );\n      }\n\n      throw error;\n    } finally {\n      for (const patch of patches.reverse()) {\n        patch.restore();\n      }\n\n      if (originalBootChecks === undefined) {\n        delete configs.bootChecks;\n      } else {\n        configs.bootChecks = originalBootChecks;\n      }\n    }\n  }\n}\n"]}

package/dist/esm/utilities/drizzle-result.utility.d.ts

@@ -1,9 +1,7 @@
-/** Rows affected by a write executed without RETURNING. */
-export declare const readAffectedRowCount: (opts: {
-    result: unknown;
-}) => number;
-/** Rows returned by `connector.execute(...)`. */
-export declare const readResultRows: <TRow>(opts: {
-    result: unknown;
-}) => TRow[];
+export declare class DrizzleResultUtility {
+    /** Rows returned by `connector.execute(...)`. */
+    static readResultRows<TRow>(opts: {
+        result: unknown;
+    }): TRow[];
+}
 //# sourceMappingURL=drizzle-result.utility.d.ts.map

package/dist/esm/utilities/drizzle-result.utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drizzle-result.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/drizzle-result.utility.ts"],"names":[],"mappings":"AAEA,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,GAAI,MAAM;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,KAAG,MAiChE,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,cAAc,GAAI,IAAI,EAAE,MAAM;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,KAAG,IAAI,EA4BpE,CAAC"}
+{"version":3,"file":"drizzle-result.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/drizzle-result.utility.ts"],"names":[],"mappings":"AAEA,qBAAa,oBAAoB;IAC/B,iDAAiD;IACjD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,EAAE;CA6B/D"}

package/dist/esm/utilities/drizzle-result.utility.js

@@ -1,54 +1,28 @@
 import { getError } from '@venizia/ignis-helpers/core';
-/** Rows affected by a write executed without RETURNING. */
-export const readAffectedRowCount = (opts) => {
-    const { result } = opts;
-    // Drizzle resolves some statements to nothing at all; the callers already treated that as zero.
-    if (result === null || result === undefined) {
-        return 0;
-    }
-    if (typeof result !== 'object') {
-        throw getError({
-            message: `[readAffectedRowCount] Unrecognized driver result | expected pg.QueryResult or postgres-js RowList | got: ${typeof result}`,
-        });
-    }
-    const { rowCount, count } = result;
-    // node-postgres. `rowCount` is null for statements that affect no rows by definition (e.g. DDL).
-    if (typeof rowCount === 'number') {
-        return rowCount;
-    }
-    if (rowCount === null) {
-        return 0;
-    }
-    // postgres-js.
-    if (typeof count === 'number') {
-        return count;
-    }
-    throw getError({
-        message: `[readAffectedRowCount] Unrecognized driver result | expected 'rowCount' (node-postgres) or 'count' (postgres-js) | got keys: ${Object.keys(result).join(', ')}`,
-    });
-};
-/** Rows returned by `connector.execute(...)`. */
-export const readResultRows = (opts) => {
-    const { result } = opts;
-    if (result === null || result === undefined) {
-        return [];
-    }
-    // postgres-js: the result IS the row list.
-    if (Array.isArray(result)) {
-        return result;
-    }
-    if (typeof result !== 'object') {
+export class DrizzleResultUtility {
+    /** Rows returned by `connector.execute(...)`. */
+    static readResultRows(opts) {
+        const { result } = opts;
+        if (result === null || result === undefined) {
+            return [];
+        }
+        // postgres-js: the result IS the row list.
+        if (Array.isArray(result)) {
+            return result;
+        }
+        if (typeof result !== 'object') {
+            throw getError({
+                message: `[DrizzleResultUtility.readResultRows] Unrecognized driver result | expected pg.QueryResult or postgres-js RowList | got: ${typeof result}`,
+            });
+        }
+        // node-postgres: pg.QueryResult.
+        const { rows } = result;
+        if (Array.isArray(rows)) {
+            return rows;
+        }
         throw getError({
-            message: `[readResultRows] Unrecognized driver result | expected pg.QueryResult or postgres-js RowList | got: ${typeof result}`,
+            message: `[DrizzleResultUtility.readResultRows] Unrecognized driver result | expected an array (postgres-js) or a 'rows' array (node-postgres) | got keys: ${Object.keys(result).join(', ')}`,
         });
     }
-    // node-postgres: pg.QueryResult.
-    const { rows } = result;
-    if (Array.isArray(rows)) {
-        return rows;
-    }
-    throw getError({
-        message: `[readResultRows] Unrecognized driver result | expected an array (postgres-js) or a 'rows' array (node-postgres) | got keys: ${Object.keys(result).join(', ')}`,
-    });
-};
+}
 //# sourceMappingURL=drizzle-result.utility.js.map