@venizia/ignis 0.4.3 → 0.4.5

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,56 @@
+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 a datasource connection, a socket or a secrets provider:
+ * 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. A component
+ * that opens Redis, Kafka or S3 in `binding()` therefore runs for real: name it in `skipComponents`.
+ * When the boot fails inside a component, one warning names it; the rejection is still the original error. 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;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,CAoMrB,CAAC"}

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

@@ -0,0 +1,250 @@
+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;
+    // signature -> controller key -> how many times that controller declares it
+    const mounted = new Map();
+    const record = (signature, key, declarations) => {
+        const owners = mounted.get(signature) ?? new Map();
+        owners.set(key, Math.max(owners.get(key) ?? 0, declarations));
+        mounted.set(signature, owners);
+    };
+    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,
+        });
+        // Hono's `routes` has one entry PER HANDLER (a validator, an authenticate and the handler of one route are three
+        // entries with the same method and path), so an entry is not a declaration: a controller counts once per signature.
+        for (const route of instance?.getRouter().routes ?? []) {
+            if (route.method === NON_ROUTE_METHOD) {
+                continue;
+            }
+            record(`${route.method} ${normalizePath(`${metadata.path}/${route.path}`)}`, binding.key, 1);
+        }
+        // What the router cannot show: one controller declaring a method and path twice. Decorated routes are one
+        // metadata entry per declaration, so those are counted there.
+        const declared = new Map();
+        for (const route of MetadataRegistry.getInstance()
+            .getRoutes({ target: target.prototype })
+            ?.values() ?? []) {
+            const signature = `${String(route.method).toUpperCase()} ${normalizePath(`${metadata.path}/${route.path}`)}`;
+            declared.set(signature, (declared.get(signature) ?? 0) + 1);
+        }
+        for (const [signature, declarations] of declared) {
+            record(signature, binding.key, declarations);
+        }
+    }
+    const duplicates = [...mounted.entries()].filter(([, owners]) => owners.size > 1 || [...owners.values()].some((declarations) => declarations > 1));
+    if (duplicates.length === 0) {
+        return;
+    }
+    const lines = duplicates.map(([signature, owners]) => `${signature} | controllers: ${[...owners]
+        .map(([key, declarations]) => declarations > 1 ? `${key} (declared ${declarations} times)` : key)
+        .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 a datasource connection, a socket or a secrets provider:
+ * 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. A component
+ * that opens Redis, Kafka or S3 in `binding()` therefore runs for real: name it in `skipComponents`.
+ * When the boot fails inside a component, one warning names it; the rejection is still the original error. 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;
+    // 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;
+        }
+        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;
+        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`);
+        }
+        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;
+    }
+    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();
+        }
+        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  // 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  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  // 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"]}

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"]}