@c9up/ream 0.1.3

package/dist/container/Container.d.ts

@@ -0,0 +1,60 @@
+/**
+ * IoC Container — AdonisJS Fold-compatible dependency injection.
+ *
+ * - make(Class) auto-constructs any class with @inject(), no explicit binding needed
+ * - call(instance, 'method') for method-level injection
+ * - singleton() / bind() for explicit factory bindings
+ * - swap() / restore() for testing
+ *
+ * @implements FR11, FR12, FR14, FR16
+ */
+import 'reflect-metadata';
+import type { ServiceFactory, ServiceToken } from './types.js';
+export declare class Container {
+    #private;
+    /** Register a singleton binding (factory called once, cached). */
+    singleton<_T>(token: ServiceToken, factory: ServiceFactory): void;
+    /** Register a transient binding (new instance per resolve). */
+    bind<_T>(token: ServiceToken, factory: ServiceFactory): void;
+    /** Bind an existing value directly. */
+    bindValue<T>(token: ServiceToken, value: T): void;
+    /**
+     * Replace a binding's factory for testing (AdonisJS-compatible swap).
+     * Snapshots the existing singleton (if any) so `restore()` re-seats the
+     * original instance instead of re-invoking the underlying factory.
+     */
+    swap(token: ServiceToken, factory: ServiceFactory): void;
+    /**
+     * Replace a binding with a literal value for testing. The value is wrapped
+     * as a factory internally, so each `resolve()` call returns it unchanged.
+     * Pair with `restore()` to undo without losing the original singleton's
+     * identity.
+     */
+    override<T>(token: ServiceToken, value: T): void;
+    /** Restore a specific swap, or all swaps if no token given. */
+    restore(token?: ServiceToken): void;
+    /**
+     * Resolve/construct a class or binding.
+     * Like AdonisJS `container.make()`:
+     * 1. Check swaps (test overrides)
+     * 2. Check cached singletons
+     * 3. Check explicit bindings (singleton/bind)
+     * 4. Auto-construct if class has @inject() or @Service()
+     * 5. Auto-construct any class (plain `new Class()`) as fallback
+     */
+    make<T>(token: ServiceToken): T;
+    /** Alias for make() — backward compatible. */
+    resolve<T>(token: ServiceToken): T;
+    /**
+     * Call a method on an instance with dependency injection.
+     * Like AdonisJS `container.call()`.
+     * Resolves method parameters from reflect-metadata and @inject().
+     */
+    call<T, K extends string & keyof T>(instance: T, method: K, runtimeValues?: unknown[]): Promise<unknown>;
+    /** Check if a token is registered or resolvable. */
+    has(token: ServiceToken): boolean;
+    get size(): number;
+    /** Auto-register all @Service() decorated classes from the global registry. */
+    autoRegister(): void;
+}
+//# sourceMappingURL=Container.d.ts.map

package/dist/container/Container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../src/container/Container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,kBAAkB,CAAA;AAKzB,OAAO,KAAK,EAAW,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AASvE,qBAAa,SAAS;;IAgBpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAKjE,+DAA+D;IAC/D,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAK5D,uCAAuC;IACvC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAQjD;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IASxD;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAIhD,+DAA+D;IAC/D,OAAO,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI;IAqBnC;;;;;;;;OAQG;IACH,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,CAAC;IAI/B,8CAA8C;IAC9C,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,CAAC;IAqBlC;;;;OAIG;IACG,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,EACtC,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,CAAC,EACT,aAAa,CAAC,EAAE,OAAO,EAAE,GACxB,OAAO,CAAC,OAAO,CAAC;IA6BnB,oDAAoD;IACpD,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAUjC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,+EAA+E;IAC/E,YAAY,IAAI,IAAI;CAuJrB"}

package/dist/container/Container.js

@@ -0,0 +1,329 @@
+/**
+ * IoC Container — AdonisJS Fold-compatible dependency injection.
+ *
+ * - make(Class) auto-constructs any class with @inject(), no explicit binding needed
+ * - call(instance, 'method') for method-level injection
+ * - singleton() / bind() for explicit factory bindings
+ * - swap() / restore() for testing
+ *
+ * @implements FR11, FR12, FR14, FR16
+ */
+import 'reflect-metadata';
+import { createLazyProxy, getLazyParams } from '../decorators/Lazy.js';
+import { getInjectTokens, getServiceMetadata, getServiceRegistry } from '../decorators/Service.js';
+import { didYouMean } from '../errors/FuzzyMatcher.js';
+import { ReamError } from '../errors/ReamError.js';
+/**
+ * Symbol descriptions that would collide with object-prototype keys if used
+ * as raw map keys. We reject them on registration so tokens cannot be used
+ * as a prototype-pollution vector.
+ */
+const RESERVED_TOKEN_NAMES = new Set(['__proto__', 'constructor', 'prototype']);
+export class Container {
+    #bindings = new Map();
+    #singletons = new Map();
+    #overrides = new Map();
+    /**
+     * Snapshot of singletons taken when `swap`/`override` shadows a previously
+     * resolved instance. `restore()` re-seats them without re-invoking the
+     * original factory, so callers that captured the live reference keep
+     * pointing at the same object after the test ends.
+     */
+    #singletonBackup = new Map();
+    #resolutionStack = [];
+    #resolutionSet = new Set();
+    // ─── Explicit bindings ────────────────────────────────────
+    /** Register a singleton binding (factory called once, cached). */
+    singleton(token, factory) {
+        const key = this.#tokenToKey(token);
+        this.#bindings.set(key, { token, factory, scope: 'singleton', dependencies: [] });
+    }
+    /** Register a transient binding (new instance per resolve). */
+    bind(token, factory) {
+        const key = this.#tokenToKey(token);
+        this.#bindings.set(key, { token, factory, scope: 'transient', dependencies: [] });
+    }
+    /** Bind an existing value directly. */
+    bindValue(token, value) {
+        const key = this.#tokenToKey(token);
+        this.#singletons.set(key, value);
+        this.#bindings.set(key, { token, factory: () => value, scope: 'singleton', dependencies: [] });
+    }
+    // ─── Testing ──────────────────────────────────────────────
+    /**
+     * Replace a binding's factory for testing (AdonisJS-compatible swap).
+     * Snapshots the existing singleton (if any) so `restore()` re-seats the
+     * original instance instead of re-invoking the underlying factory.
+     */
+    swap(token, factory) {
+        const key = this.#tokenToKey(token);
+        if (!this.#overrides.has(key) && this.#singletons.has(key)) {
+            this.#singletonBackup.set(key, this.#singletons.get(key));
+        }
+        this.#overrides.set(key, factory);
+        this.#singletons.delete(key);
+    }
+    /**
+     * Replace a binding with a literal value for testing. The value is wrapped
+     * as a factory internally, so each `resolve()` call returns it unchanged.
+     * Pair with `restore()` to undo without losing the original singleton's
+     * identity.
+     */
+    override(token, value) {
+        this.swap(token, () => value);
+    }
+    /** Restore a specific swap, or all swaps if no token given. */
+    restore(token) {
+        if (token) {
+            this.#restoreOne(this.#tokenToKey(token));
+            return;
+        }
+        for (const key of [...this.#overrides.keys()]) {
+            this.#restoreOne(key);
+        }
+    }
+    #restoreOne(key) {
+        this.#overrides.delete(key);
+        this.#singletons.delete(key);
+        if (this.#singletonBackup.has(key)) {
+            this.#singletons.set(key, this.#singletonBackup.get(key));
+            this.#singletonBackup.delete(key);
+        }
+    }
+    // ─── Resolution ───────────────────────────────────────────
+    /**
+     * Resolve/construct a class or binding.
+     * Like AdonisJS `container.make()`:
+     * 1. Check swaps (test overrides)
+     * 2. Check cached singletons
+     * 3. Check explicit bindings (singleton/bind)
+     * 4. Auto-construct if class has @inject() or @Service()
+     * 5. Auto-construct any class (plain `new Class()`) as fallback
+     */
+    make(token) {
+        return this.resolve(token);
+    }
+    /** Alias for make() — backward compatible. */
+    resolve(token) {
+        const key = this.#tokenToKey(token);
+        if (this.#resolutionSet.has(key)) {
+            const cycle = [...this.#resolutionStack, key].join(' → ');
+            throw new ReamError('CIRCULAR_DEPENDENCY', `Circular dependency detected: ${cycle}`, {
+                hint: 'Use @Lazy() on one of the constructor parameters to break the cycle.',
+                context: { chain: cycle },
+            });
+        }
+        this.#resolutionStack.push(key);
+        this.#resolutionSet.add(key);
+        try {
+            return this.#resolveInner(key, token);
+        }
+        finally {
+            this.#resolutionStack.pop();
+            this.#resolutionSet.delete(key);
+        }
+    }
+    /**
+     * Call a method on an instance with dependency injection.
+     * Like AdonisJS `container.call()`.
+     * Resolves method parameters from reflect-metadata and @inject().
+     */
+    async call(instance, method, runtimeValues) {
+        // `Object.getPrototypeOf` is typed `any` in lib.dom, so the assignment
+        // narrows it back to a typed constructor without a cast expression.
+        const target = Object.getPrototypeOf(instance).constructor;
+        const paramTypes = Reflect.getMetadata('design:paramtypes', target.prototype, method) ?? [];
+        const args = paramTypes.map((type, index) => {
+            // Runtime values take precedence
+            if (runtimeValues && index < runtimeValues.length) {
+                return runtimeValues[index];
+            }
+            // Auto-resolve class dependencies — type is a constructor function here
+            if (isClassConstructor(type)) {
+                return this.resolve(type);
+            }
+            return undefined;
+        });
+        const member = instance[method];
+        if (!isCallable(member)) {
+            throw new Error(`Container.call: '${method}' is not a callable method`);
+        }
+        return member.apply(instance, args);
+    }
+    // ─── Introspection ────────────────────────────────────────
+    /** Check if a token is registered or resolvable. */
+    has(token) {
+        const key = this.#tokenToKey(token);
+        return (this.#bindings.has(key) ||
+            this.#overrides.has(key) ||
+            this.#singletons.has(key) ||
+            (typeof token === 'function' && getServiceMetadata(token) !== undefined));
+    }
+    get size() {
+        return this.#bindings.size;
+    }
+    /** Auto-register all @Service() decorated classes from the global registry. */
+    autoRegister() {
+        for (const [target, metadata] of getServiceRegistry()) {
+            const key = metadata.as ?? target.name;
+            if (!this.#bindings.has(key)) {
+                const targetClass = target;
+                this.#bindings.set(key, {
+                    token: metadata.as ?? target,
+                    factory: () => this.#autoConstruct(targetClass),
+                    scope: metadata.scope,
+                    dependencies: [],
+                });
+            }
+        }
+    }
+    // ─── Internal resolution ──────────────────────────────────
+    #resolveInner(key, token) {
+        // 1. Check swaps (test overrides)
+        if (this.#overrides.has(key)) {
+            // biome-ignore lint/suspicious/noExplicitAny: IoC container factory returns unknown; caller brands via T
+            return this.#overrides.get(key)?.();
+        }
+        // 2. Check cached singletons
+        if (this.#singletons.has(key)) {
+            // biome-ignore lint/suspicious/noExplicitAny: IoC singleton stored as unknown; caller brands via T
+            return this.#singletons.get(key);
+        }
+        // 3. Check explicit bindings
+        const binding = this.#bindings.get(key);
+        if (binding) {
+            const instance = binding.factory ? binding.factory() : undefined;
+            if (binding.scope === 'singleton') {
+                this.#singletons.set(key, instance);
+            }
+            // biome-ignore lint/suspicious/noExplicitAny: IoC binding factory returns unknown; caller brands via T
+            return instance;
+        }
+        // 4. Auto-construct if it's a class
+        if (typeof token === 'function') {
+            // biome-ignore lint/suspicious/noExplicitAny: IoC auto-construct returns unknown; caller brands via T
+            return this.#autoConstruct(token);
+        }
+        // 5. Not found
+        const allKeys = [...this.#bindings.keys(), ...this.#overrides.keys()];
+        const suggestion = didYouMean(key, allKeys);
+        throw new ReamError('CONTAINER_NOT_FOUND', `No binding found for '${key}'.${suggestion ? ` ${suggestion}` : ''}`, {
+            hint: 'Register it with container.singleton() or decorate with @inject().',
+        });
+    }
+    /**
+     * Auto-construct a class by reading its dependency hints.
+     *
+     * Resolution order (like AdonisJS Fold):
+     * 1. static containerInjections._constructor.dependencies — explicit deps array
+     * 2. Reflect.getMetadata('design:paramtypes') — decorator metadata (requires SWC/tsc)
+     * 3. No params → plain `new Class()`
+     */
+    #autoConstruct(target) {
+        const metadata = getServiceMetadata(target);
+        const scope = metadata?.scope ?? 'transient';
+        const key = metadata?.as ?? target.name;
+        if (scope === 'singleton' && this.#singletons.has(key)) {
+            return this.#singletons.get(key);
+        }
+        // 1. Check static containerInjections (AdonisJS Fold-compatible, works
+        // without emitDecoratorMetadata). The `in` operator narrows the optional
+        // field to `unknown`, then `readContainerInjectionDeps` validates the
+        // shape at runtime — no type-level cast required.
+        const explicitDeps = readContainerInjectionDeps(target);
+        // 2. Fallback to reflect-metadata
+        const paramTypes = explicitDeps ?? Reflect.getMetadata('design:paramtypes', target) ?? [];
+        if (paramTypes.length === 0) {
+            const instance = new target();
+            if (scope === 'singleton')
+                this.#singletons.set(key, instance);
+            return instance;
+        }
+        const injectTokens = getInjectTokens(target);
+        const lazyIndices = getLazyParams(target);
+        const deps = paramTypes.map((type, index) => {
+            const namedToken = injectTokens.get(index);
+            // After the typeof check, type is a constructor function and valid as ServiceToken
+            const depToken = namedToken ??
+                // biome-ignore lint/suspicious/noExplicitAny: reflect-metadata returns unknown; constructor functions are valid ServiceTokens
+                (typeof type === 'function' && type !== Object ? type : undefined);
+            if (!depToken)
+                return undefined;
+            if (lazyIndices.includes(index)) {
+                // biome-ignore lint/suspicious/noExplicitAny: lazy proxy target must be object; IoC resolution returns unknown
+                return createLazyProxy(() => this.resolve(depToken));
+            }
+            return this.resolve(depToken);
+        });
+        const instance = new target(...deps);
+        if (scope === 'singleton')
+            this.#singletons.set(key, instance);
+        return instance;
+    }
+    #tokenToKey(token) {
+        if (typeof token === 'string') {
+            this.#assertNotReserved(token, 'string');
+            return token;
+        }
+        if (typeof token === 'symbol') {
+            // Reject unique `Symbol(x)` — two `Symbol("foo")` calls create distinct
+            // symbols, so an override registered with one would be invisible to a
+            // resolver holding the other. Force callers onto `Symbol.for(x)` which
+            // is the global registry and round-trips across modules.
+            if (Symbol.keyFor(token) === undefined) {
+                throw new ReamError('CONTAINER_INVALID_TOKEN', `Unique Symbol() tokens are not supported — use Symbol.for("${token.description ?? 'name'}") so different modules see the same symbol.`);
+            }
+            const desc = token.description;
+            if (desc === undefined) {
+                throw new ReamError('CONTAINER_INVALID_TOKEN', 'Symbol tokens must have a description.');
+            }
+            this.#assertNotReserved(desc, 'symbol description');
+            return `Symbol(${desc})`;
+        }
+        return token.name;
+    }
+    #assertNotReserved(name, kind) {
+        if (RESERVED_TOKEN_NAMES.has(name)) {
+            throw new ReamError('CONTAINER_RESERVED_TOKEN', `Reserved container token name '${name}'.`, {
+                hint: `'${name}' would collide with an Object.prototype key. Pick a different ${kind}.`,
+            });
+        }
+    }
+}
+// `design:paramtypes` returns `unknown[]` per our annotation; we narrow each
+// entry before treating it as a class token. `Object` slips through because
+// emitDecoratorMetadata uses it for `any`/`unknown` parameters.
+function isClassConstructor(value) {
+    return typeof value === 'function' && value !== Object;
+}
+function isCallable(value) {
+    return typeof value === 'function';
+}
+/**
+ * Read `static containerInjections._constructor.dependencies` from a class,
+ * AdonisJS Fold-style, when the static is present. The static is undeclared
+ * on the constructor signature, so we walk the shape with `in`-narrowing
+ * (TS 4.9+) plus a per-element `isServiceToken` guard — no casts.
+ */
+function readContainerInjectionDeps(target) {
+    if (!('containerInjections' in target))
+        return undefined;
+    const injections = target.containerInjections;
+    if (typeof injections !== 'object' || injections === null)
+        return undefined;
+    if (!('_constructor' in injections))
+        return undefined;
+    const ctor = injections._constructor;
+    if (typeof ctor !== 'object' || ctor === null)
+        return undefined;
+    if (!('dependencies' in ctor))
+        return undefined;
+    const deps = ctor.dependencies;
+    if (!Array.isArray(deps))
+        return undefined;
+    return deps.every(isServiceToken) ? deps : undefined;
+}
+function isServiceToken(value) {
+    return typeof value === 'string' || typeof value === 'symbol' || typeof value === 'function';
+}
+//# sourceMappingURL=Container.js.map

package/dist/container/Container.js.map

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

package/dist/container/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Container types and interfaces.
+ * @implements FR11, FR14, FR16
+ */
+/** Service scope determines instance lifecycle. */
+export type ServiceScope = 'singleton' | 'transient' | 'request';
+/** Service metadata stored by @Service() decorator. */
+export interface ServiceMetadata {
+    scope: ServiceScope;
+    /** If set, binds as this named interface instead of the class itself. */
+    as?: string;
+}
+/** Token used to resolve a service — class constructor, string name, or registered symbol. */
+export type ServiceToken = (new (...args: any[]) => unknown) | string | symbol;
+/** Factory function for creating service instances. */
+export type ServiceFactory = () => unknown;
+/** Binding entry in the container. */
+export interface Binding {
+    token: ServiceToken;
+    factory?: ServiceFactory;
+    instance?: unknown;
+    scope: ServiceScope;
+    dependencies: ServiceToken[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/container/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/container/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAA;AAEhE,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,YAAY,CAAA;IACnB,yEAAyE;IACzE,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED,8FAA8F;AAE9F,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,CAAA;AAE9E,uDAAuD;AACvD,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAA;AAE1C,sCAAsC;AACtC,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,YAAY,CAAA;IACnB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,YAAY,CAAA;IACnB,YAAY,EAAE,YAAY,EAAE,CAAA;CAC7B"}

package/dist/container/types.js

@@ -0,0 +1,6 @@
+/**
+ * Container types and interfaces.
+ * @implements FR11, FR14, FR16
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/container/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/container/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/decorators/Lazy.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @Lazy() decorator — deferred injection to break circular dependencies.
+ *
+ * @implements FR15
+ */
+import 'reflect-metadata';
+/**
+ * @Lazy() — marks a constructor parameter for deferred resolution.
+ * The dependency is resolved on first property access, not at construction.
+ */
+export declare function Lazy(): ParameterDecorator;
+/** Get lazy parameter indices for a constructor. */
+export declare function getLazyParams(target: object): number[];
+/**
+ * Create a lazy proxy that defers resolution until first access.
+ * Traps get, set, has, ownKeys, getOwnPropertyDescriptor for full compatibility.
+ */
+export declare function createLazyProxy<T extends object>(resolver: () => T): T;
+//# sourceMappingURL=Lazy.d.ts.map

package/dist/decorators/Lazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Lazy.d.ts","sourceRoot":"","sources":["../../src/decorators/Lazy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,kBAAkB,CAAA;AAIzB;;;GAGG;AACH,wBAAgB,IAAI,IAAI,kBAAkB,CAMzC;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAEtD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAyBtE"}

package/dist/decorators/Lazy.js

@@ -0,0 +1,53 @@
+/**
+ * @Lazy() decorator — deferred injection to break circular dependencies.
+ *
+ * @implements FR15
+ */
+import 'reflect-metadata';
+const LAZY_KEY = Symbol.for('ream:lazy');
+/**
+ * @Lazy() — marks a constructor parameter for deferred resolution.
+ * The dependency is resolved on first property access, not at construction.
+ */
+export function Lazy() {
+    return (target, propertyKey, parameterIndex) => {
+        const existing = Reflect.getOwnMetadata(LAZY_KEY, target, propertyKey ?? '') ?? [];
+        existing.push(parameterIndex);
+        Reflect.defineMetadata(LAZY_KEY, existing, target, propertyKey ?? '');
+    };
+}
+/** Get lazy parameter indices for a constructor. */
+export function getLazyParams(target) {
+    return Reflect.getOwnMetadata(LAZY_KEY, target, '') ?? [];
+}
+/**
+ * Create a lazy proxy that defers resolution until first access.
+ * Traps get, set, has, ownKeys, getOwnPropertyDescriptor for full compatibility.
+ */
+export function createLazyProxy(resolver) {
+    let instance;
+    const ensure = () => {
+        if (!instance)
+            instance = resolver();
+        return instance;
+    };
+    // biome-ignore lint/suspicious/noExplicitAny: Proxy target must be an object literal; T is branded at call site
+    return new Proxy({}, {
+        get(_target, prop, receiver) {
+            return Reflect.get(ensure(), prop, receiver);
+        },
+        set(_target, prop, value, receiver) {
+            return Reflect.set(ensure(), prop, value, receiver);
+        },
+        has(_target, prop) {
+            return Reflect.has(ensure(), prop);
+        },
+        ownKeys() {
+            return Reflect.ownKeys(ensure());
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            return Object.getOwnPropertyDescriptor(ensure(), prop);
+        },
+    });
+}
+//# sourceMappingURL=Lazy.js.map

package/dist/decorators/Lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Lazy.js","sourceRoot":"","sources":["../../src/decorators/Lazy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,kBAAkB,CAAA;AAEzB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;AAExC;;;GAGG;AACH,MAAM,UAAU,IAAI;IAClB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE;QAC7C,MAAM,QAAQ,GAAa,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,IAAI,EAAE,CAAC,IAAI,EAAE,CAAA;QAC5F,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAC7B,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,IAAI,EAAE,CAAC,CAAA;IACvE,CAAC,CAAA;AACH,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,EAAE,CAAA;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAmB,QAAiB;IACjE,IAAI,QAAuB,CAAA;IAC3B,MAAM,MAAM,GAAG,GAAM,EAAE;QACrB,IAAI,CAAC,QAAQ;YAAE,QAAQ,GAAG,QAAQ,EAAE,CAAA;QACpC,OAAO,QAAQ,CAAA;IACjB,CAAC,CAAA;IAED,gHAAgH;IAChH,OAAO,IAAI,KAAK,CAAC,EAAc,EAAE;QAC/B,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ;YACzB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;QAC9C,CAAC;QACD,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ;YAChC,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;QACrD,CAAC;QACD,GAAG,CAAC,OAAO,EAAE,IAAI;YACf,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAA;QACpC,CAAC;QACD,OAAO;YACL,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;QAClC,CAAC;QACD,wBAAwB,CAAC,OAAO,EAAE,IAAI;YACpC,OAAO,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAA;QACxD,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/decorators/Service.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @Service() and @Inject() decorators for IoC container integration.
+ *
+ * @implements FR11, FR12, FR14
+ */
+import 'reflect-metadata';
+import type { ServiceMetadata, ServiceScope } from '../container/types.js';
+declare const SERVICE_METADATA_KEY: unique symbol;
+declare const INJECT_METADATA_KEY: unique symbol;
+/** Constructor type — accepts unknown args, returns unknown instance. */
+type AnyConstructor = new (...args: unknown[]) => unknown;
+export declare function getServiceRegistry(): ReadonlyMap<AnyConstructor, ServiceMetadata>;
+/** Clear the service registry (for test isolation and hot-reload). */
+export declare function clearServiceRegistry(): void;
+export declare function getServiceMetadata(target: AnyConstructor): ServiceMetadata | undefined;
+/**
+ * @Service() decorator.
+ * Registers the class in the IoC container for auto-resolution.
+ */
+export declare function Service(options?: {
+    scope?: ServiceScope;
+    as?: string;
+}): ClassDecorator;
+/**
+ * @Inject() decorator — marks a constructor parameter for named injection.
+ *
+ * @implements FR16
+ */
+export declare function Inject(token: string): ParameterDecorator;
+/**
+ * Get named injection tokens for a class constructor.
+ */
+export declare function getInjectTokens(target: AnyConstructor): Map<number, string>;
+/**
+ * @inject() class decorator — marks a controller (or service) for transient IoC resolution.
+ *
+ * Equivalent to @Service({ scope: 'transient' }). Use on controllers so the container
+ * auto-resolves constructor dependencies per-request.
+ *
+ * Usage:
+ *   @inject()
+ *   export default class UsersController {
+ *     constructor(private userService: UserService) {}
+ *   }
+ */
+export declare function inject(): ClassDecorator;
+export { INJECT_METADATA_KEY, SERVICE_METADATA_KEY };
+//# sourceMappingURL=Service.d.ts.map

package/dist/decorators/Service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Service.d.ts","sourceRoot":"","sources":["../../src/decorators/Service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAE1E,QAAA,MAAM,oBAAoB,eAAyB,CAAA;AACnD,QAAA,MAAM,mBAAmB,eAAwB,CAAA;AAEjD,yEAAyE;AACzE,KAAK,cAAc,GAAG,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;AAKzD,wBAAgB,kBAAkB,IAAI,WAAW,CAAC,cAAc,EAAE,eAAe,CAAC,CAEjF;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,GAAG,SAAS,CAEtF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,YAAY,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,cAAc,CAU3F;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAOxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,IAAI,cAAc,CAEvC;AAED,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,CAAA"}

package/dist/decorators/Service.js

@@ -0,0 +1,70 @@
+/**
+ * @Service() and @Inject() decorators for IoC container integration.
+ *
+ * @implements FR11, FR12, FR14
+ */
+import 'reflect-metadata';
+const SERVICE_METADATA_KEY = Symbol('ream:service');
+const INJECT_METADATA_KEY = Symbol('ream:inject');
+/** Registry of all decorated services. */
+const serviceRegistry = new Map();
+export function getServiceRegistry() {
+    return serviceRegistry;
+}
+/** Clear the service registry (for test isolation and hot-reload). */
+export function clearServiceRegistry() {
+    serviceRegistry.clear();
+}
+export function getServiceMetadata(target) {
+    return serviceRegistry.get(target);
+}
+/**
+ * @Service() decorator.
+ * Registers the class in the IoC container for auto-resolution.
+ */
+export function Service(options = {}) {
+    return (target) => {
+        const metadata = {
+            scope: options.scope ?? 'singleton',
+            as: options.as,
+        };
+        // biome-ignore lint/suspicious/noExplicitAny: ClassDecorator target is Function; registry requires AnyConstructor which is a subtype
+        serviceRegistry.set(target, metadata);
+        Reflect.defineMetadata(SERVICE_METADATA_KEY, metadata, target);
+    };
+}
+/**
+ * @Inject() decorator — marks a constructor parameter for named injection.
+ *
+ * @implements FR16
+ */
+export function Inject(token) {
+    return (target, _propertyKey, parameterIndex) => {
+        const existingTokens = Reflect.getOwnMetadata(INJECT_METADATA_KEY, target) ?? new Map();
+        existingTokens.set(parameterIndex, token);
+        Reflect.defineMetadata(INJECT_METADATA_KEY, existingTokens, target);
+    };
+}
+/**
+ * Get named injection tokens for a class constructor.
+ */
+export function getInjectTokens(target) {
+    return Reflect.getOwnMetadata(INJECT_METADATA_KEY, target) ?? new Map();
+}
+/**
+ * @inject() class decorator — marks a controller (or service) for transient IoC resolution.
+ *
+ * Equivalent to @Service({ scope: 'transient' }). Use on controllers so the container
+ * auto-resolves constructor dependencies per-request.
+ *
+ * Usage:
+ *   @inject()
+ *   export default class UsersController {
+ *     constructor(private userService: UserService) {}
+ *   }
+ */
+export function inject() {
+    return Service({ scope: 'transient' });
+}
+export { INJECT_METADATA_KEY, SERVICE_METADATA_KEY };
+//# sourceMappingURL=Service.js.map