@venizia/ignis 0.4.2 → 0.4.4

package/dist/esm/connectors/typesense/index.js

@@ -0,0 +1,3 @@
+/** Alias barrel - the connectors moved to `@venizia/ignis-connectors`. Kept so `@venizia/ignis/typesense` keeps resolving for published consumers. */
+export * from '@venizia/ignis-connectors/typesense';
+//# sourceMappingURL=index.js.map

package/dist/esm/connectors/typesense/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/connectors/typesense/index.ts"],"names":[],"mappings":"AAAA,sJAAsJ;AACtJ,cAAc,qCAAqC,CAAC","sourcesContent":["/** Alias barrel - the connectors moved to `@venizia/ignis-connectors`. Kept so `@venizia/ignis/typesense` keeps resolving for published consumers. */\nexport * from '@venizia/ignis-connectors/typesense';\n"]}

package/dist/esm/helpers/base-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-helper.d.ts","sourceRoot":"","sources":["../../../src/helpers/base-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/esm/helpers/base-helper.js

@@ -0,0 +1,2 @@
+export { BaseHelper } from '@venizia/ignis-helpers';
+//# sourceMappingURL=base-helper.js.map

package/dist/esm/helpers/base-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-helper.js","sourceRoot":"","sources":["../../../src/helpers/base-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC","sourcesContent":["export { BaseHelper } from '@venizia/ignis-helpers';\n"]}

package/dist/esm/helpers/index.d.ts

@@ -0,0 +1,5 @@
+export type * from '@venizia/ignis-helpers';
+export * from '@venizia/ignis-kernel';
+export { ErrorSchema } from '@venizia/ignis-kernel';
+export * from './base-helper.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/helpers/index.ts"],"names":[],"mappings":"AAEA,mBAAmB,wBAAwB,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,cAAc,eAAe,CAAC"}

package/dist/esm/helpers/index.js

@@ -0,0 +1,4 @@
+export * from '@venizia/ignis-kernel';
+export { ErrorSchema } from '@venizia/ignis-kernel';
+export * from './base-helper.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/index.ts"],"names":[],"mappings":"AAGA,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,cAAc,eAAe,CAAC","sourcesContent":["// `inversion/**` moved to the kernel, which owns `ErrorSchema` - re-exported explicitly so the two\n// `export *`/`export type *` below resolve the name to a value rather than a type.\nexport type * from '@venizia/ignis-helpers';\nexport * from '@venizia/ignis-kernel';\nexport { ErrorSchema } from '@venizia/ignis-kernel';\n\nexport * from './base-helper';\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,18 @@
+import 'reflect-metadata';
+export * from '@venizia/ignis-kernel';
+export * from './base/index.js';
+export * from './common/index.js';
+export * from './components/index.js';
+export * from './connectors/index.js';
+export * from './helpers/index.js';
+export * from './utilities/index.js';
+/**
+ * `IApplicationConfigs` from THIS package is the server flavour - the kernel's shape plus `host` and
+ * `port`. An application built on `@venizia/ignis` always has a socket, so it should see both.
+ *
+ * Explicit, and here in the entry module rather than in a barrel: a name exported by two different
+ * `export *` lines is ambiguous and TypeScript then exports NEITHER, silently. An explicit export
+ * beats every star export, so this line is what makes the widened shape win.
+ */
+export type { IServerApplicationConfigs as IApplicationConfigs } from './base/applications/common/types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,cAAc,uBAAuB,CAAC;AAEtC,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAE5B;;;;;;;GAOG;AACH,YAAY,EAAE,yBAAyB,IAAI,mBAAmB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,9 @@
+import 'reflect-metadata';
+export * from '@venizia/ignis-kernel';
+export * from './base/index.js';
+export * from './common/index.js';
+export * from './components/index.js';
+export * from './connectors/index.js';
+export * from './helpers/index.js';
+export * from './utilities/index.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,cAAc,uBAAuB,CAAC;AAEtC,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC","sourcesContent":["import 'reflect-metadata';\n\nexport * from '@venizia/ignis-kernel';\n\nexport * from './base';\nexport * from './common';\nexport * from './components';\nexport * from './connectors';\nexport * from './helpers';\nexport * from './utilities';\n\n/**\n * `IApplicationConfigs` from THIS package is the server flavour - the kernel's shape plus `host` and\n * `port`. An application built on `@venizia/ignis` always has a socket, so it should see both.\n *\n * Explicit, and here in the entry module rather than in a barrel: a name exported by two different\n * `export *` lines is ambiguous and TypeScript then exports NEITHER, silently. An explicit export\n * beats every star export, so this line is what makes the widened shape win.\n */\nexport type { IServerApplicationConfigs as IApplicationConfigs } from './base/applications/common/types';\n"]}

package/dist/esm/package.json

@@ -0,0 +1,4 @@
+{
+  "type": "module",
+  "sideEffects": false
+}

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

@@ -0,0 +1,54 @@
+import type { BaseApplication } from '../base/applications/index.js';
+import { type TServerBootStep } from '../base/applications/index.js';
+import type { AnyType, TClass } from '@venizia/ignis-helpers/common';
+/** A class (matched against the instance's constructor) or a string (matched against the binding key or the class name). */
+export type TBootProbeTarget = TClass<AnyType> | string;
+export interface IAssertApplicationBootsOptions {
+    /**
+     * Datasources whose real `configure()` runs. Every other datasource is bound and resolved but not
+     * configured, so no connection is made. Close a kept one with `await application.stop()`.
+     */
+    keepDataSources?: TBootProbeTarget[];
+    /**
+     * Components whose `configure()` (and so their `binding()`) is skipped, for the few that need
+     * infrastructure. Components run by default. What a skipped component would have registered is
+     * not registered.
+     */
+    skipComponents?: TBootProbeTarget[];
+    /**
+     * Boot steps that do not run. Default: `hydrateSecrets` and `wireSecretRotatables`, so a remote
+     * secrets provider is never contacted. A value REPLACES the default; an unknown name rejects
+     * before anything boots.
+     */
+    skipSteps?: TServerBootStep[];
+    /**
+     * Default `true`: after boot, resolves every service and repository with the shared core of
+     * `@venizia/ignis-inversion`, so an injection nobody references at boot still fails. An explicit value
+     * wins over the application's own `bootChecks`, whose boot step is off for the run.
+     */
+    verifyBindings?: boolean;
+    /**
+     * Services or repositories the verification leaves unresolved, for one whose constructor needs
+     * infrastructure. A class (exact), a class name or a binding key. A name that matches nothing rejects.
+     */
+    skipBindings?: TBootProbeTarget[];
+    /** Default `false`: an application that registered no controller proves nothing, for example when the artifact index was empty. */
+    allowNoControllers?: boolean;
+    /** Default `true`: this helper's own check that no method and path is mounted twice. IGNIS boot does not detect that. */
+    routes?: boolean;
+}
+/**
+ * Proves an IGNIS application boots, without real infrastructure: it runs the application's own boot
+ * sequence (`init()` then `initialize()`) and never calls `start()`, so no socket is opened and no
+ * post-start hook runs.
+ *
+ * Datasources are bound and resolved but not configured, unless named in `keepDataSources`; the
+ * secrets steps are skipped; every other step and every component runs as in a real boot. When the
+ * boot fails, the rejection is the original error. The application stays booted and is returned;
+ * a failed boot leaves a half-booted instance, so build a new one rather than reuse it.
+ *
+ * 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>;
+//# sourceMappingURL=assert-application-boots.d.ts.map

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

@@ -0,0 +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;AAqHD;;;;;;;;;;;;GAYG;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,CA4KrB,CAAC"}

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

@@ -0,0 +1,205 @@
+import { ServerBootSteps } from '../base/applications/index.js';
+import { getError } from '@venizia/ignis-helpers/core';
+import { assertBindingsResolve } 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'];
+const DEFAULT_SKIPPED_STEPS = [
+    ServerBootSteps.HYDRATE_SECRETS,
+    ServerBootSteps.WIRE_SECRET_ROTATABLES,
+];
+/** Methods a route entry may carry that are middleware, not a mounted handler. */
+const NON_ROUTE_METHOD = 'ALL';
+const bootedApplications = new WeakSet();
+const matchesTarget = (opts) => {
+    const { targets, binding, instance } = opts;
+    const className = instance?.constructor?.name;
+    return targets.some((target) => typeof target === 'string'
+        ? target === binding.key || target === className
+        : instance?.constructor === target);
+};
+const fail = (message) => {
+    throw getError({ message: `[assertApplicationBoots] ${message}` });
+};
+/** Replaces `object[name]` and returns the way back, even when `name` was inherited. */
+const patchProperty = (opts) => {
+    const { object, name, value } = opts;
+    const descriptor = Object.getOwnPropertyDescriptor(object, name);
+    Object.defineProperty(object, name, { value, configurable: true, writable: true });
+    return {
+        restore: () => {
+            if (descriptor) {
+                Object.defineProperty(object, name, descriptor);
+                return;
+            }
+            delete object[name];
+        },
+    };
+};
+const normalizePath = (path) => {
+    const withParams = path.replace(/:[A-Za-z0-9_]+/g, ':param').replace(/\/{2,}/g, '/');
+    return withParams.length > 1 ? withParams.replace(/\/$/, '') : withParams;
+};
+/** The helper's own check: IGNIS mounts a method and path twice without complaint, and the first one wins. */
+const assertNoDuplicateRoutes = (opts) => {
+    const { application } = opts;
+    const mounted = new Map();
+    for (const binding of application.findByTag({
+        tag: BindingNamespaces.CONTROLLER,
+    })) {
+        const target = binding.getBindingMeta({ type: BindingValueTypes.CLASS });
+        const metadata = target
+            ? MetadataRegistry.getInstance().getControllerMetadata({ target })
+            : undefined;
+        if (!metadata?.path || metadata.transport === ControllerTransports.GRPC) {
+            continue;
+        }
+        const instance = application.get({
+            key: binding.key,
+            isOptional: true,
+        });
+        for (const route of instance?.getRouter().routes ?? []) {
+            if (route.method === NON_ROUTE_METHOD) {
+                continue;
+            }
+            const signature = `${route.method} ${normalizePath(`${metadata.path}/${route.path}`)}`;
+            mounted.set(signature, [...(mounted.get(signature) ?? []), binding.key]);
+        }
+    }
+    const duplicates = [...mounted.entries()].filter(([, keys]) => keys.length > 1);
+    if (duplicates.length === 0) {
+        return;
+    }
+    const lines = duplicates.map(([signature, keys]) => `${signature} | controllers: ${keys.join(', ')}`);
+    fail(`${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`);
+};
+/**
+ * Proves an IGNIS application boots, without real infrastructure: it runs the application's own boot
+ * sequence (`init()` then `initialize()`) and never calls `start()`, so no socket is opened and no
+ * post-start hook runs.
+ *
+ * Datasources are bound and resolved but not configured, unless named in `keepDataSources`; the
+ * secrets steps are skipped; every other step and every component runs as in a real boot. When the
+ * boot fails, the rejection is the original error. The application stays booted and is returned;
+ * a failed boot leaves a half-booted instance, so build a new one rather than reuse it.
+ *
+ * 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(', ')}`);
+        }
+    }
+    const target = typeof application === 'function' ? await application() : 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`);
+        }
+    }
+    const skippedSteps = new Set(skipSteps);
+    const patches = [];
+    let sweepsSeen = 0;
+    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;
+        }
+        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 (opts) => {
+        sweepsSeen += 1;
+        const userBefore = opts.onBeforeConfigure;
+        return originalRegisterDynamicBindings.call(target, {
+            ...opts,
+            onBeforeConfigure: async ({ binding }) => {
+                await neutralise({ namespace: opts.namespace, binding });
+                await userBefore?.({ binding });
+            },
+        });
+    };
+    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`);
+        }
+        if (verifyBindings) {
+            assertBindingsResolve({
+                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;
+    }
+    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

@@ -0,0 +1 @@
+{"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 { 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  const mounted = new Map<string, string[]>();\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    for (const route of instance?.getRouter().routes ?? []) {\n      if (route.method === NON_ROUTE_METHOD) {\n        continue;\n      }\n\n      const signature = `${route.method} ${normalizePath(`${metadata.path}/${route.path}`)}`;\n      mounted.set(signature, [...(mounted.get(signature) ?? []), binding.key]);\n    }\n  }\n\n  const duplicates = [...mounted.entries()].filter(([, keys]) => keys.length > 1);\n  if (duplicates.length === 0) {\n    return;\n  }\n\n  const lines = duplicates.map(\n    ([signature, keys]) => `${signature} | controllers: ${keys.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 real infrastructure: it runs the application's own boot\n * sequence (`init()` then `initialize()`) and never calls `start()`, so no socket is opened and no\n * 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. 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  const target = typeof application === 'function' ? await application() : application;\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\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\n    return originalRegisterDynamicBindings.call(target, {\n      ...opts,\n      onBeforeConfigure: async ({ binding }) => {\n        await neutralise({ namespace: opts.namespace, binding });\n        await userBefore?.({ binding });\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  } 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"]}

package/dist/esm/testing/index.d.ts

@@ -0,0 +1,4 @@
+/** Test-only entry (`@venizia/ignis/testing`): re-exports `@venizia/ignis-connectors/testing` and the application boot helper, and is never re-exported from the root barrel. */
+export * from '@venizia/ignis-connectors/testing';
+export * from './assert-application-boots.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,iLAAiL;AACjL,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC"}

package/dist/esm/testing/index.js

@@ -0,0 +1,4 @@
+/** Test-only entry (`@venizia/ignis/testing`): re-exports `@venizia/ignis-connectors/testing` and the application boot helper, and is never re-exported from the root barrel. */
+export * from '@venizia/ignis-connectors/testing';
+export * from './assert-application-boots.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,iLAAiL;AACjL,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC","sourcesContent":["/** Test-only entry (`@venizia/ignis/testing`): re-exports `@venizia/ignis-connectors/testing` and the application boot helper, and is never re-exported from the root barrel. */\nexport * from '@venizia/ignis-connectors/testing';\nexport * from './assert-application-boots';\n"]}

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

@@ -0,0 +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"}

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

@@ -0,0 +1,54 @@
+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') {
+        throw getError({
+            message: `[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 an array (postgres-js) or a 'rows' array (node-postgres) | got keys: ${Object.keys(result).join(', ')}`,
+    });
+};
+//# sourceMappingURL=drizzle-result.utility.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-result.utility.js","sourceRoot":"","sources":["../../../src/utilities/drizzle-result.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAyB,EAAU,EAAE;IACxE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAExB,gGAAgG;IAChG,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,6GAA6G,OAAO,MAAM,EAAE;SACtI,CAAC,CAAC;IACL,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAiD,CAAC;IAE9E,iGAAiG;IACjG,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,eAAe;IACf,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,CAAC;QACb,OAAO,EAAE,gIAAgI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KAC1K,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,iDAAiD;AACjD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAO,IAAyB,EAAU,EAAE;IACxE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAExB,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,2CAA2C;IAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAgB,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,uGAAuG,OAAO,MAAM,EAAE;SAChI,CAAC,CAAC;IACL,CAAC;IAED,iCAAiC;IACjC,MAAM,EAAE,IAAI,EAAE,GAAG,MAA4B,CAAC;IAE9C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAc,CAAC;IACxB,CAAC;IAED,MAAM,QAAQ,CAAC;QACb,OAAO,EAAE,+HAA+H,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KACzK,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { getError } from '@venizia/ignis-helpers/core';\n\n/** Rows affected by a write executed without RETURNING. */\nexport const readAffectedRowCount = (opts: { result: unknown }): number => {\n  const { result } = opts;\n\n  // Drizzle resolves some statements to nothing at all; the callers already treated that as zero.\n  if (result === null || result === undefined) {\n    return 0;\n  }\n\n  if (typeof result !== 'object') {\n    throw getError({\n      message: `[readAffectedRowCount] Unrecognized driver result | expected pg.QueryResult or postgres-js RowList | got: ${typeof result}`,\n    });\n  }\n\n  const { rowCount, count } = result as { rowCount?: unknown; count?: unknown };\n\n  // node-postgres. `rowCount` is null for statements that affect no rows by definition (e.g. DDL).\n  if (typeof rowCount === 'number') {\n    return rowCount;\n  }\n\n  if (rowCount === null) {\n    return 0;\n  }\n\n  // postgres-js.\n  if (typeof count === 'number') {\n    return count;\n  }\n\n  throw getError({\n    message: `[readAffectedRowCount] Unrecognized driver result | expected 'rowCount' (node-postgres) or 'count' (postgres-js) | got keys: ${Object.keys(result).join(', ')}`,\n  });\n};\n\n/** Rows returned by `connector.execute(...)`. */\nexport const readResultRows = <TRow>(opts: { result: unknown }): TRow[] => {\n  const { result } = opts;\n\n  if (result === null || result === undefined) {\n    return [];\n  }\n\n  // postgres-js: the result IS the row list.\n  if (Array.isArray(result)) {\n    return result as TRow[];\n  }\n\n  if (typeof result !== 'object') {\n    throw getError({\n      message: `[readResultRows] Unrecognized driver result | expected pg.QueryResult or postgres-js RowList | got: ${typeof result}`,\n    });\n  }\n\n  // node-postgres: pg.QueryResult.\n  const { rows } = result as { rows?: unknown };\n\n  if (Array.isArray(rows)) {\n    return rows as TRow[];\n  }\n\n  throw getError({\n    message: `[readResultRows] Unrecognized driver result | expected an array (postgres-js) or a 'rows' array (node-postgres) | got keys: ${Object.keys(result).join(', ')}`,\n  });\n};\n"]}

package/dist/esm/utilities/index.d.ts

@@ -0,0 +1,3 @@
+export * from '@venizia/ignis-kernel';
+export * from './drizzle-result.utility.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/utilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,0BAA0B,CAAC"}

package/dist/esm/utilities/index.js

@@ -0,0 +1,4 @@
+// `error.utility.ts`, `jsx.utility.ts` and `schema.utility.ts` moved to the kernel.
+export * from '@venizia/ignis-kernel';
+export * from './drizzle-result.utility.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/utilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,cAAc,uBAAuB,CAAC;AAEtC,cAAc,0BAA0B,CAAC","sourcesContent":["// `error.utility.ts`, `jsx.utility.ts` and `schema.utility.ts` moved to the kernel.\nexport * from '@venizia/ignis-kernel';\n\nexport * from './drizzle-result.utility';\n"]}

package/dist/esm/utilities/network.utility.d.ts

@@ -0,0 +1,9 @@
+import type { Context } from 'hono';
+export declare class NetworkUtility {
+    private static readonly logger;
+    /** Latches the warning: an absent conninfo peer fails identically for every later request. */
+    private static hasReportedUnavailable;
+    /** Reads the incoming IP from Bun's connection info (`hono/bun`). */
+    static getIncomingIp(context: Context): string | null;
+}
+//# sourceMappingURL=network.utility.d.ts.map

package/dist/esm/utilities/network.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/network.utility.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACxE,8FAA8F;IAC9F,OAAO,CAAC,MAAM,CAAC,sBAAsB,CAAS;IAE9C,qEAAqE;IACrE,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;CAiBtD"}

package/dist/esm/utilities/network.utility.js

@@ -0,0 +1,22 @@
+import { ApplicationLogger, ErrorPrettier } from '@venizia/ignis-helpers';
+import { getConnInfo } from 'hono/bun';
+export class NetworkUtility {
+    static { this.logger = ApplicationLogger.get('getIncomingIp'); }
+    /** Latches the warning: an absent conninfo peer fails identically for every later request. */
+    static { this.hasReportedUnavailable = false; }
+    /** Reads the incoming IP from Bun's connection info (`hono/bun`). */
+    static getIncomingIp(context) {
+        try {
+            return getConnInfo(context)?.remote?.address ?? null;
+        }
+        catch (error) {
+            if (NetworkUtility.hasReportedUnavailable) {
+                return null;
+            }
+            NetworkUtility.hasReportedUnavailable = true;
+            NetworkUtility.logger.warn('[getIncomingIp] Connection info unavailable - reporting null for every request | %s', ErrorPrettier.format({ error }));
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=network.utility.js.map

package/dist/esm/utilities/network.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.utility.js","sourceRoot":"","sources":["../../../src/utilities/network.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,OAAO,cAAc;aACD,WAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACxE,8FAA8F;aAC/E,2BAAsB,GAAG,KAAK,CAAC;IAE9C,qEAAqE;IACrE,MAAM,CAAC,aAAa,CAAC,OAAgB;QACnC,IAAI,CAAC;YACH,OAAO,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,cAAc,CAAC,sBAAsB,EAAE,CAAC;gBAC1C,OAAO,IAAI,CAAC;YACd,CAAC;YAED,cAAc,CAAC,sBAAsB,GAAG,IAAI,CAAC;YAC7C,cAAc,CAAC,MAAM,CAAC,IAAI,CACxB,qFAAqF,EACrF,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAChC,CAAC;YAEF,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC","sourcesContent":["import { ApplicationLogger, ErrorPrettier } from '@venizia/ignis-helpers';\nimport type { Context } from 'hono';\nimport { getConnInfo } from 'hono/bun';\n\nexport class NetworkUtility {\n  private static readonly logger = ApplicationLogger.get('getIncomingIp');\n  /** Latches the warning: an absent conninfo peer fails identically for every later request. */\n  private static hasReportedUnavailable = false;\n\n  /** Reads the incoming IP from Bun's connection info (`hono/bun`). */\n  static getIncomingIp(context: Context): string | null {\n    try {\n      return getConnInfo(context)?.remote?.address ?? null;\n    } catch (error) {\n      if (NetworkUtility.hasReportedUnavailable) {\n        return null;\n      }\n\n      NetworkUtility.hasReportedUnavailable = true;\n      NetworkUtility.logger.warn(\n        '[getIncomingIp] Connection info unavailable - reporting null for every request | %s',\n        ErrorPrettier.format({ error }),\n      );\n\n      return null;\n    }\n  }\n}\n"]}

package/dist/presets/app/files/src/boot.test.ts

@@ -0,0 +1,16 @@
+// Boot test: runs the application's own boot (every binding, every controller injection) without a
+// port, a database or a network. A datasource added later is skipped unless you name it in `keepDataSources`.
+import { describe, expect, test } from 'bun:test';
+import { assertApplicationBoots } from '@venizia/ignis/testing';
+import { application } from '#src/application';
+
+describe('{{app}} boot', () => {
+  test('boots and mounts its routes', async () => {
+    const booted = await assertApplicationBoots(application);
+
+    // The root router has no base path yet: `start()` mounts it under `/api`.
+    const response = await booted.getRootRouter().request('/hello');
+
+    expect(response.status).toBe(200);
+  });
+});

package/dist/presets/app/preset.json

@@ -14,9 +14,9 @@
   "dependencies": {
     "@hono/zod-openapi": "^1.6.3",
     "@scalar/hono-api-reference": "^0.12.13",
-    "@venizia/ignis": "0.4.2",
-    "@venizia/ignis-boot": "0.4.2",
-    "@venizia/ignis-helpers": "0.4.2",
+    "@venizia/ignis": "0.4.4",
+    "@venizia/ignis-boot": "0.4.4",
+    "@venizia/ignis-helpers": "0.4.4",
     "hono": "^4.13.13",
     "winston": "^3.19.0",
     "winston-daily-rotate-file": "^5.0.0",
@@ -24,7 +24,7 @@
   },
   "devDependencies": {
     "@types/bun": "^1.4.3",
-    "@venizia/dev-configs": "0.4.2",
+    "@venizia/dev-configs": "0.4.4",
     "eslint": "^10.13.0",
     "oxlint": "1.89.0",
     "oxlint-tsgolint": "7.0.2004",

package/dist/presets/lib/preset.json

@@ -4,15 +4,15 @@
   "dependencies": {},
   "devDependencies": {
     "@types/bun": "^1.4.3",
-    "@venizia/dev-configs": "0.4.2",
-    "@venizia/ignis": "0.4.2",
+    "@venizia/dev-configs": "0.4.4",
+    "@venizia/ignis": "0.4.4",
     "eslint": "^10.13.0",
     "oxlint": "1.89.0",
     "oxlint-tsgolint": "7.0.2004",
     "typescript": "^6.0.3"
   },
   "peerDependencies": {
-    "@venizia/ignis": "0.4.2"
+    "@venizia/ignis": "0.4.4"
   },
   "scripts": {
     "typecheck": "bun check",