ioc-manifest 0.3.0

package/dist/runtime/iocResolutionError.js

@@ -0,0 +1,266 @@
+import { AwilixResolutionError } from "awilix";
+const registrationKeyOf = (frame) => frame.registrationKey ?? frame.contractName;
+/**
+ * Merges an ancestor IoC stack with frames already on an error so parents appear once at the front.
+ */
+export const mergeFrameSequences = (ancestorPrefix, existing) => {
+    if (ancestorPrefix.length === 0) {
+        return [...existing];
+    }
+    let matchCount = 0;
+    const maxSharedPrefix = Math.min(ancestorPrefix.length, existing.length);
+    while (matchCount < maxSharedPrefix &&
+        registrationKeyOf(ancestorPrefix[matchCount]) ===
+            registrationKeyOf(existing[matchCount])) {
+        matchCount += 1;
+    }
+    if (matchCount === ancestorPrefix.length) {
+        return [...existing];
+    }
+    return [...ancestorPrefix, ...existing.slice(matchCount)];
+};
+const stackFrameToResolutionFrame = (frame) => ({
+    contractName: frame.contractName,
+    implementationName: frame.implementationName,
+    modulePath: frame.modulePath,
+    registrationKey: frame.registrationKey,
+});
+const frameFromRegistrationKey = (key, keyIndex) => {
+    const meta = keyIndex.metaByRegistrationKey.get(key);
+    if (meta !== undefined) {
+        return {
+            contractName: meta.contractName,
+            implementationName: meta.implementationName,
+            modulePath: meta.modulePath,
+            registrationKey: key,
+        };
+    }
+    const contract = keyIndex.contractByAccessKey.get(key);
+    if (contract !== undefined) {
+        return {
+            contractName: contract,
+            registrationKey: key,
+        };
+    }
+    return { contractName: key, registrationKey: key };
+};
+const parseAwilixResolutionPath = (message) => {
+    const match = message.match(/Resolution path:\s*(.+?)(?:\r?\n|$)/);
+    if (match === null || match[1] === undefined) {
+        return undefined;
+    }
+    const parts = match[1]
+        .split("->")
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0);
+    return parts.length > 0 ? parts : undefined;
+};
+const classifyAwilixResolutionError = (message) => {
+    if (message.includes("Cyclic dependencies detected")) {
+        return "cyclic";
+    }
+    if (message.includes("has a shorter lifetime than its ancestor")) {
+        return "lifetime";
+    }
+    return "missing";
+};
+const describeFrameLine = (frame, keyIndex) => {
+    const key = frame.registrationKey;
+    if (key !== undefined) {
+        const meta = keyIndex.metaByRegistrationKey.get(key);
+        if (meta !== undefined) {
+            const fileSuffix = meta.modulePath.length > 0 ? ` [${meta.modulePath}]` : "";
+            return `${meta.contractName} (${meta.implementationName})${fileSuffix}`;
+        }
+        const contract = keyIndex.contractByAccessKey.get(key);
+        if (contract !== undefined) {
+            return `${contract} (contract default slot ${JSON.stringify(key)})`;
+        }
+        return key;
+    }
+    const fileSuffix = frame.modulePath !== undefined && frame.modulePath.length > 0
+        ? ` [${frame.modulePath}]`
+        : "";
+    const implementationSuffix = frame.implementationName !== undefined &&
+        frame.implementationName.length > 0
+        ? ` (${frame.implementationName})`
+        : "";
+    return `${frame.contractName}${implementationSuffix}${fileSuffix}`;
+};
+const formatHeadline = (frames, keyIndex) => {
+    const first = frames[0];
+    if (first === undefined) {
+        return "Container resolution failed.";
+    }
+    const key = first.registrationKey;
+    if (key !== undefined) {
+        const meta = keyIndex.metaByRegistrationKey.get(key);
+        if (meta !== undefined) {
+            return `Cannot build ${meta.contractName} using implementation ${meta.implementationName}.`;
+        }
+        const contract = keyIndex.contractByAccessKey.get(key);
+        if (contract !== undefined) {
+            return `Cannot resolve ${contract} (contract default slot ${JSON.stringify(key)}).`;
+        }
+    }
+    if (first.implementationName !== undefined &&
+        first.implementationName.length > 0) {
+        return `Cannot build ${first.contractName} using implementation ${first.implementationName}.`;
+    }
+    return `Cannot build ${first.contractName}.`;
+};
+const formatChainWithUniformLeaf = (frames, keyIndex, leafText) => {
+    if (frames.length === 0) {
+        return `Resolution chain:\n    ${leafText}\n`;
+    }
+    if (frames.length === 1) {
+        return `Resolution chain:\n    ${describeFrameLine(frames[0], keyIndex)} ${leafText}\n`;
+    }
+    let out = "Resolution chain:\n";
+    for (let i = 0; i < frames.length - 1; i += 1) {
+        const pad = "  ".repeat(i + 1);
+        const connector = i === 0 ? "" : "-> ";
+        out += `${pad}${connector}${describeFrameLine(frames[i], keyIndex)}\n`;
+    }
+    const last = frames[frames.length - 1];
+    const lastPad = "  ".repeat(frames.length);
+    out += `${lastPad}-> ${describeFrameLine(last, keyIndex)} ${leafText}\n`;
+    return out;
+};
+const formatResolutionChainBlock = (err, keyIndex) => {
+    const frames = err.frames;
+    if (frames.length === 0) {
+        if (err.failureType === "threw") {
+            const detail = err.throwDetail ?? err.cause?.message ?? "unknown error";
+            return `Resolution chain:\n    ✖ factory threw while building: ${detail}\n`;
+        }
+        return `Resolution chain:\n    ✖ ${err.awilixDetail ?? "resolution failed"}\n`;
+    }
+    if (err.failureType === "missing") {
+        if (frames.length === 1) {
+            return `Resolution chain:\n    ${describeFrameLine(frames[0], keyIndex)} ✖ no registered implementation\n`;
+        }
+        let out = "Resolution chain:\n";
+        for (let i = 0; i < frames.length - 1; i += 1) {
+            const pad = "  ".repeat(i + 1);
+            const connector = i === 0 ? "" : "-> ";
+            out += `${pad}${connector}${describeFrameLine(frames[i], keyIndex)}\n`;
+        }
+        const last = frames[frames.length - 1];
+        const lastPad = "  ".repeat(frames.length);
+        out += `${lastPad}-> ${describeFrameLine(last, keyIndex)} ✖ no registered implementation\n`;
+        return out;
+    }
+    if (err.failureType === "cyclic") {
+        return formatChainWithUniformLeaf(frames, keyIndex, "✖ cyclic dependency detected");
+    }
+    if (err.failureType === "lifetime") {
+        return formatChainWithUniformLeaf(frames, keyIndex, "✖ dependency lifetime is shorter than an ancestor (strict mode)");
+    }
+    const detail = err.throwDetail ?? err.cause?.message ?? "unknown error";
+    let out = "Resolution chain:\n";
+    for (let i = 0; i < frames.length; i += 1) {
+        const pad = "  ".repeat(i + 1);
+        const connector = i === 0 ? "" : "-> ";
+        out += `${pad}${connector}${describeFrameLine(frames[i], keyIndex)}\n`;
+    }
+    const leafPad = "  ".repeat(frames.length + 1);
+    out += `${leafPad}✖ factory threw while building: ${detail}\n`;
+    return out;
+};
+/**
+ * Builds the final user-facing message from structured data (single formatting site).
+ */
+export const formatIocResolutionErrorMessage = (err, keyIndex) => {
+    const headline = formatHeadline(err.frames, keyIndex);
+    const chain = formatResolutionChainBlock(err, keyIndex);
+    return `[ioc] ${headline}\n\n${chain}`.trimEnd();
+};
+export class IocResolutionError extends Error {
+    frames;
+    failureType;
+    cause;
+    /** Set when failureType === "threw" (plain message, not another IocResolutionError string). */
+    throwDetail;
+    /** Awilix diagnostic when failureType is cyclic or lifetime. */
+    awilixDetail;
+    constructor(init) {
+        super(init.message ?? "");
+        this.name = "IocResolutionError";
+        this.frames = [...init.frames];
+        this.failureType = init.failureType;
+        this.cause = init.cause;
+        this.throwDetail = init.throwDetail;
+        this.awilixDetail = init.awilixDetail;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export const isIocResolutionError = (value) => value instanceof IocResolutionError;
+const createFromAwilix = (cause, keyIndex, stackSnapshot) => {
+    const path = parseAwilixResolutionPath(cause.message);
+    const kind = classifyAwilixResolutionError(cause.message);
+    const failureType = kind === "cyclic" ? "cyclic" : kind === "lifetime" ? "lifetime" : "missing";
+    const pathFrames = path !== undefined
+        ? path.map((key) => frameFromRegistrationKey(key, keyIndex))
+        : undefined;
+    const stackFrames = stackSnapshot.map(stackFrameToResolutionFrame);
+    const frames = pathFrames !== undefined && pathFrames.length > 0
+        ? mergeFrameSequences(stackFrames, pathFrames)
+        : stackFrames;
+    return new IocResolutionError({
+        frames,
+        failureType,
+        cause,
+        awilixDetail: cause.message.trim(),
+    });
+};
+const createFromFactoryThrow = (cause, stackSnapshot) => {
+    const frames = stackSnapshot.map(stackFrameToResolutionFrame);
+    const original = cause instanceof Error
+        ? cause
+        : new Error(typeof cause === "string" ? cause : String(cause));
+    const throwDetail = original.message.length > 0 ? original.message : String(cause);
+    return new IocResolutionError({
+        frames,
+        failureType: "threw",
+        cause: cause instanceof Error ? cause : original,
+        throwDetail,
+    });
+};
+/**
+ * Normalizes any thrown value into an {@link IocResolutionError} without formatting nested IoC errors as strings.
+ */
+export const createIocResolutionError = (cause, keyIndex, stackSnapshot) => {
+    if (cause instanceof IocResolutionError) {
+        return cause;
+    }
+    if (cause instanceof AwilixResolutionError) {
+        return createFromAwilix(cause, keyIndex, stackSnapshot);
+    }
+    return createFromFactoryThrow(cause, stackSnapshot);
+};
+/**
+ * Merges the current IoC stack into an existing resolution error and refreshes {@link Error.message} once.
+ */
+export const mergeAncestorStackIntoResolutionError = (err, ancestorStack) => {
+    const ancestors = ancestorStack.map(stackFrameToResolutionFrame);
+    err.frames = mergeFrameSequences(ancestors, err.frames);
+};
+export const applyIocResolutionErrorMessage = (err, keyIndex) => {
+    err.message = formatIocResolutionErrorMessage(err, keyIndex);
+};
+/**
+ * Single entry from factory/collection/group boundaries: structured propagation, no nested string wrapping.
+ */
+export const propagateIocResolutionFailure = (params) => {
+    const { cause, keyIndex, stackSnapshot } = params;
+    if (isIocResolutionError(cause)) {
+        mergeAncestorStackIntoResolutionError(cause, stackSnapshot);
+        applyIocResolutionErrorMessage(cause, keyIndex);
+        throw cause;
+    }
+    const err = createIocResolutionError(cause, keyIndex, stackSnapshot);
+    applyIocResolutionErrorMessage(err, keyIndex);
+    throw err;
+};
+//# sourceMappingURL=iocResolutionError.js.map

package/dist/runtime/iocResolutionError.js.map

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

package/dist/runtime/iocResolutionStack.d.ts

@@ -0,0 +1,21 @@
+import type { ModuleFactoryManifestMetadata } from "../core/manifest.js";
+/**
+ * Lightweight resolution stack used while factories, multi-implementation collections, and
+ * group resolvers run. Frames are pushed before invoking user code and popped in `finally`
+ * so `snapshotIocResolutionStack` captures the path leading to failures.
+ *
+ * Note: this is a module-level array (not true async context isolation). It is safe under
+ * Node’s single-threaded event loop as long as resolution does not `await` between push
+ * and pop; avoid yielding inside factory bodies if you rely on stack accuracy.
+ */
+export type IocResolutionFrame = {
+    contractName: string;
+    implementationName: string;
+    registrationKey: string;
+    modulePath?: string;
+};
+export declare const pushIocResolutionFrame: (frame: IocResolutionFrame) => void;
+export declare const popIocResolutionFrame: () => void;
+export declare const snapshotIocResolutionStack: () => readonly IocResolutionFrame[];
+export declare const frameFromManifestMeta: (meta: ModuleFactoryManifestMetadata) => IocResolutionFrame;
+//# sourceMappingURL=iocResolutionStack.d.ts.map

package/dist/runtime/iocResolutionStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iocResolutionStack.d.ts","sourceRoot":"","sources":["../../src/runtime/iocResolutionStack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAEzE;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAIF,eAAO,MAAM,sBAAsB,GAAI,OAAO,kBAAkB,KAAG,IAElE,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAAO,IAExC,CAAC;AAEF,eAAO,MAAM,0BAA0B,QAAO,SAAS,kBAAkB,EAExE,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,MAAM,6BAA6B,KAClC,kBAKD,CAAC"}

package/dist/runtime/iocResolutionStack.js

@@ -0,0 +1,17 @@
+const stack = [];
+export const pushIocResolutionFrame = (frame) => {
+    stack.push(frame);
+};
+export const popIocResolutionFrame = () => {
+    stack.pop();
+};
+export const snapshotIocResolutionStack = () => [
+    ...stack,
+];
+export const frameFromManifestMeta = (meta) => ({
+    contractName: meta.contractName,
+    implementationName: meta.implementationName,
+    registrationKey: meta.registrationKey,
+    modulePath: meta.modulePath,
+});
+//# sourceMappingURL=iocResolutionStack.js.map

package/dist/runtime/iocResolutionStack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iocResolutionStack.js","sourceRoot":"","sources":["../../src/runtime/iocResolutionStack.ts"],"names":[],"mappings":"AAkBA,MAAM,KAAK,GAAyB,EAAE,CAAC;AAEvC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAyB,EAAQ,EAAE;IACxE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAS,EAAE;IAC9C,KAAK,CAAC,GAAG,EAAE,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAkC,EAAE,CAAC;IAC7E,GAAG,KAAK;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,IAAmC,EACf,EAAE,CAAC,CAAC;IACxB,YAAY,EAAE,IAAI,CAAC,YAAY;IAC/B,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;IAC3C,eAAe,EAAE,IAAI,CAAC,eAAe;IACrC,UAAU,EAAE,IAAI,CAAC,UAAU;CAC5B,CAAC,CAAC"}

package/dist/runtime/iocRuntimeErrors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview User-facing error message builders for predictable runtime failures (missing
+ * exports, misaligned manifest imports, ambiguous defaults). Prefer these over ad hoc strings
+ * so the CLI and library stay consistent.
+ */
+export type MissingDefaultContext = {
+    contractName: string;
+    implementationNames: string[];
+    registrationKeys: string[];
+};
+export declare const formatMissingDefaultImplementationMessage: (ctx: MissingDefaultContext) => string;
+export type MissingContractImplementationContext = {
+    contractName: string;
+    requestedBy?: string;
+};
+export declare const formatMissingContractImplementationMessage: (ctx: MissingContractImplementationContext) => string;
+export type MissingFactoryExportContext = {
+    modulePath: string;
+    exportName: string;
+    contractName: string;
+    registrationKey: string;
+};
+export declare const formatMissingFactoryExportMessage: (ctx: MissingFactoryExportContext) => string;
+export type MissingModuleImportContext = {
+    moduleIndex: number;
+    modulePath: string;
+};
+export declare const formatMissingModuleImportMessage: (ctx: MissingModuleImportContext) => string;
+export type MissingDependencyContext = {
+    implementationLabel: string;
+    modulePath: string;
+    missingContractName: string;
+};
+export declare const formatMissingDependencyMessage: (ctx: MissingDependencyContext) => string;
+//# sourceMappingURL=iocRuntimeErrors.d.ts.map

package/dist/runtime/iocRuntimeErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iocRuntimeErrors.d.ts","sourceRoot":"","sources":["../../src/runtime/iocRuntimeErrors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,yCAAyC,GACpD,KAAK,qBAAqB,KACzB,MAUF,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,0CAA0C,GACrD,KAAK,oCAAoC,KACxC,MAMF,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAC5C,KAAK,2BAA2B,KAC/B,MAIU,CAAC;AAEd,MAAM,MAAM,0BAA0B,GAAG;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,gCAAgC,GAC3C,KAAK,0BAA0B,KAC9B,MACsM,CAAC;AAE1M,MAAM,MAAM,wBAAwB,GAAG;IACrC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,8BAA8B,GAAI,KAAK,wBAAwB,KAAG,MAIlE,CAAC"}

package/dist/runtime/iocRuntimeErrors.js

@@ -0,0 +1,27 @@
+export const formatMissingDefaultImplementationMessage = (ctx) => {
+    const implList = ctx.implementationNames
+        .map((n) => JSON.stringify(n))
+        .join(", ");
+    const keys = ctx.registrationKeys.map((k) => JSON.stringify(k)).join(", ");
+    return [
+        `[ioc] Multiple implementations for contract ${JSON.stringify(ctx.contractName)} (${implList}) but no default is selected for the contract slot.`,
+        `Mark exactly one implementation with default: true (resolver or ioc.config), register exactly one implementation under the camel-cased contract key, or reduce to a single implementation.`,
+        `Implementation registration keys: ${keys}.`,
+    ].join(" ");
+};
+export const formatMissingContractImplementationMessage = (ctx) => {
+    const who = ctx.requestedBy !== undefined && ctx.requestedBy.length > 0
+        ? `Requested as ${JSON.stringify(ctx.requestedBy)}. `
+        : "";
+    return `${who}No implementation is registered for contract ${JSON.stringify(ctx.contractName)}. Add a discoverable factory that returns that contract (or fix ioc.config / discovery globs), then re-run manifest generation.`;
+};
+export const formatMissingFactoryExportMessage = (ctx) => [
+    `[ioc] Module ${JSON.stringify(ctx.modulePath)} has no callable factory export ${JSON.stringify(ctx.exportName)} for contract ${JSON.stringify(ctx.contractName)} (registration ${JSON.stringify(ctx.registrationKey)}).`,
+    `Ensure the export exists at runtime, matches the manifest exportName, and is a function. Re-run manifest generation if the module path or export changed.`,
+].join(" ");
+export const formatMissingModuleImportMessage = (ctx) => `[ioc] iocModuleImports[${ctx.moduleIndex}] is missing for source ${JSON.stringify(ctx.modulePath)}. The import array must align with moduleIndex values in the manifest (re-run manifest generation).`;
+export const formatMissingDependencyMessage = (ctx) => [
+    `[ioc] While building ${ctx.implementationLabel} (${JSON.stringify(ctx.modulePath)}), dependency ${JSON.stringify(ctx.missingContractName)} could not be satisfied.`,
+    `Register an implementation for ${JSON.stringify(ctx.missingContractName)} in the manifest, or fix the factory's dependency/cradle usage.`,
+].join(" ");
+//# sourceMappingURL=iocRuntimeErrors.js.map

package/dist/runtime/iocRuntimeErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iocRuntimeErrors.js","sourceRoot":"","sources":["../../src/runtime/iocRuntimeErrors.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,yCAAyC,GAAG,CACvD,GAA0B,EAClB,EAAE;IACV,MAAM,QAAQ,GAAG,GAAG,CAAC,mBAAmB;SACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;SAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,IAAI,GAAG,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO;QACL,+CAA+C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,QAAQ,qDAAqD;QACjJ,4LAA4L;QAC5L,qCAAqC,IAAI,GAAG;KAC7C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC,CAAC;AAOF,MAAM,CAAC,MAAM,0CAA0C,GAAG,CACxD,GAAyC,EACjC,EAAE;IACV,MAAM,GAAG,GACP,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QACzD,CAAC,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI;QACrD,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,GAAG,GAAG,gDAAgD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,iIAAiI,CAAC;AACjO,CAAC,CAAC;AASF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC/C,GAAgC,EACxB,EAAE,CACV;IACE,gBAAgB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,mCAAmC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI;IACzN,2JAA2J;CAC5J,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAOd,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,GAA+B,EACvB,EAAE,CACV,0BAA0B,GAAG,CAAC,WAAW,2BAA2B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,qGAAqG,CAAC;AAQ1M,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,GAA6B,EAAU,EAAE,CACtF;IACE,wBAAwB,GAAG,CAAC,mBAAmB,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,mBAAmB,CAAC,0BAA0B;IACpK,kCAAkC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,mBAAmB,CAAC,iEAAiE;CAC3I,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/runtime/registrationKeyIndex.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Fast lookups from Awilix keys back to manifest metadata and contract default slots.
+ * Built once per `registerIocFromManifest` call to enrich resolution errors.
+ */
+import type { IocContractManifest, ModuleFactoryManifestMetadata } from "../core/manifest.js";
+export type RegistrationKeyIndex = {
+    readonly metaByRegistrationKey: ReadonlyMap<string, ModuleFactoryManifestMetadata>;
+    /** Contract name for each cradle default-slot key (convention or `$contract.accessKey`). */
+    readonly contractByAccessKey: ReadonlyMap<string, string>;
+};
+export declare const buildRegistrationKeyIndex: (manifestByContract: IocContractManifest) => RegistrationKeyIndex;
+//# sourceMappingURL=registrationKeyIndex.d.ts.map

package/dist/runtime/registrationKeyIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registrationKeyIndex.d.ts","sourceRoot":"","sources":["../../src/runtime/registrationKeyIndex.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC9B,MAAM,qBAAqB,CAAC;AAG7B,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,qBAAqB,EAAE,WAAW,CACzC,MAAM,EACN,6BAA6B,CAC9B,CAAC;IACF,4FAA4F;IAC5F,QAAQ,CAAC,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3D,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,oBAAoB,mBAAmB,KACtC,oBAoBF,CAAC"}

package/dist/runtime/registrationKeyIndex.js

@@ -0,0 +1,19 @@
+import { contractNameToDefaultRegistrationKey } from "../generator/naming.js";
+export const buildRegistrationKeyIndex = (manifestByContract) => {
+    const metaByRegistrationKey = new Map();
+    const contractByAccessKey = new Map();
+    for (const contractName of Object.keys(manifestByContract)) {
+        const impls = manifestByContract[contractName];
+        const list = Object.values(impls);
+        const explicit = list.find((m) => m.accessKey !== undefined)?.accessKey;
+        const slotKey = explicit ?? contractNameToDefaultRegistrationKey(contractName);
+        contractByAccessKey.set(slotKey, contractName);
+    }
+    for (const impls of Object.values(manifestByContract)) {
+        for (const meta of Object.values(impls)) {
+            metaByRegistrationKey.set(meta.registrationKey, meta);
+        }
+    }
+    return { metaByRegistrationKey, contractByAccessKey };
+};
+//# sourceMappingURL=registrationKeyIndex.js.map

package/dist/runtime/registrationKeyIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registrationKeyIndex.js","sourceRoot":"","sources":["../../src/runtime/registrationKeyIndex.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,oCAAoC,EAAE,MAAM,wBAAwB,CAAC;AAW9E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,kBAAuC,EACjB,EAAE;IACxB,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAyC,CAAC;IAC/E,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEtD,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,kBAAkB,CAAC,YAAY,CAAE,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,EAAE,SAAS,CAAC;QACxE,MAAM,OAAO,GACX,QAAQ,IAAI,oCAAoC,CAAC,YAAY,CAAC,CAAC;QACjE,mBAAmB,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACtD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,CAAC;AACxD,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "ioc-manifest",
+  "version": "0.3.0",
+  "description": "Build-time factory discovery and codegen: generates a typed Awilix (PROXY) registration manifest from TypeScript sources with ioc.config as the single policy surface.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reharik/ioc-manifest.git"
+  },
+  "bugs": {
+    "url": "https://github.com/reharik/ioc-manifest/issues"
+  },
+  "homepage": "https://github.com/reharik/ioc-manifest#readme",
+  "keywords": [
+    "awilix",
+    "dependency-injection",
+    "ioc",
+    "typescript",
+    "codegen",
+    "manifest",
+    "proxy",
+    "container",
+    "di"
+  ],
+  "type": "module",
+  "files": [
+    "bin",
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "ioc": "./bin/ioc.cjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "clean:dist": "rm -rf dist",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "npm run clean:dist && tsc -p tsconfig.json",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build && npm pack --dry-run",
+    "publish:dry-run": "npm run build && npm pack --dry-run",
+    "test": "node --import tsx --test src/cli/parseIocCli.test.ts src/config/loadIocConfig.test.ts src/config/parseDiscoveryScanDirs.test.ts src/core/defaultImplementationSelection.test.ts src/core/resolveRegistrationKey.test.ts src/groups/baseTypeAssignability.test.ts src/groups/resolveGroupPlan.test.ts src/groups/resolveGroupPlan.integration.test.ts src/generator/iocProgramContext.test.ts src/generator/manifestOptions.test.ts src/generator/manifestPaths.test.ts src/generator/resolveRegistrationPlan.test.ts src/generator/resolveDiscoveryRootLifetime.test.ts src/generator/contractTypeImport.integration.test.ts src/generator/contractTypeSourceFile.test.ts src/generator/discoverFactories/discoveryStrategies.integration.test.ts src/generator/discoverFactories/inferFactoryDependencyContracts.test.ts src/generator/generatedTypes.integration.test.ts src/generator/writeManifest.test.ts src/inspection/formatReports.test.ts src/inspection/reports.test.ts src/runtime/bootstrap.test.ts src/runtime/bootstrap.integration.test.ts src/runtime/iocResolutionError.test.ts",
+    "gen:manifest": "tsx src/generator/gen-manifest.ts",
+    "pack:dev": "npm run build && npm pack --silent"
+  },
+  "dependencies": {
+    "awilix": "^12.0.5",
+    "fast-glob": "^3.3.3",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2"
+  }
+}