@asenajs/asena 0.7.0 → 0.8.0

package/dist/lib/test/harness/types.d.ts

@@ -0,0 +1,147 @@
+import type { AsenaAdapter } from '../../adapter';
+import type { Container } from '../../ioc';
+import type { ServerLogger } from '../../logger';
+import type { AsenaServer } from '../../server/AsenaServer';
+import type { Class } from '../../server/types';
+import type { TestHttpCall } from '../http/TestHttpCall';
+/**
+ * How the test app accepts requests.
+ *
+ * - `server` - listens on a TCP port (default). Matches production exactly.
+ * - `socket` - listens on a unix domain socket instead. Still the adapter's real routing
+ *   pipeline, but occupies no port, so parallel suites cannot collide. Requires an adapter
+ *   that honours `AsenaStartOptions.unix`.
+ */
+export type DispatchMode = 'server' | 'socket';
+/**
+ * Options for {@link createTestApp}
+ */
+export interface TestAppOptions<A extends AsenaAdapter<any, any> = AsenaAdapter<any, any>> {
+    /**
+     * The adapter instance to boot, e.g. `createHonoAdapter({ logger: silentLogger })[0]`
+     */
+    adapter: A;
+    /**
+     * Components to register. Passing this list skips filesystem scanning entirely.
+     */
+    components: Class[];
+    /**
+     * Replace registered components with test doubles, keyed by service name (`@MockBean`).
+     *
+     * Override services, not controllers: a plain object mock carries no `@Controller`
+     * metadata, so an overridden controller's routes would never be registered.
+     */
+    overrides?: Record<string, object>;
+    /**
+     * Logger for the booted server
+     *
+     * @default silentLogger
+     */
+    logger?: ServerLogger;
+    /**
+     * Port to bind. Ignored in `socket` dispatch.
+     *
+     * @default 0 - Bun picks a free ephemeral port, which removes the port race entirely
+     */
+    port?: number;
+    /**
+     * @default 'server'
+     */
+    dispatch?: DispatchMode;
+}
+/**
+ * A booted test application
+ */
+export interface TestApp {
+    /**
+     * The running server
+     */
+    readonly server: AsenaServer<any>;
+    /**
+     * The user component container
+     */
+    readonly container: Container;
+    /**
+     * The bound TCP port. `0` in `socket` dispatch, where no port is used.
+     */
+    readonly port: number;
+    /**
+     * Base URL for HTTP calls. In `socket` dispatch the host is a placeholder - routing
+     * happens over {@link socketPath}.
+     */
+    readonly baseUrl: string;
+    /**
+     * Path of the unix socket, when running in `socket` dispatch
+     */
+    readonly socketPath?: string;
+    /**
+     * Resolves a component from the container
+     *
+     * @param name - Registered service name
+     */
+    resolve<T>(name: string): Promise<T>;
+    /**
+     * Builds a WebSocket URL for the given path, correct for the active dispatch mode
+     *
+     * @param path - Route path, e.g. `/ws/chat`
+     */
+    wsUrl(path: string): string;
+    /**
+     * Starts a request with an explicit method in `init`
+     *
+     * @param path - Path relative to the app root
+     * @param init - Standard fetch init
+     */
+    request(path: string, init?: RequestInit): TestHttpCall;
+    get(path: string, init?: RequestInit): TestHttpCall;
+    post(path: string, init?: RequestInit): TestHttpCall;
+    put(path: string, init?: RequestInit): TestHttpCall;
+    patch(path: string, init?: RequestInit): TestHttpCall;
+    delete(path: string, init?: RequestInit): TestHttpCall;
+    head(path: string, init?: RequestInit): TestHttpCall;
+    options(path: string, init?: RequestInit): TestHttpCall;
+    /**
+     * Stops the server and removes the unix socket if one was created. Idempotent.
+     */
+    stop(): Promise<void>;
+    /**
+     * Enables `await using app = await createTestApp(...)`
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Options for {@link createWebTest}
+ */
+export interface WebTestOptions<A extends AsenaAdapter<any, any> = AsenaAdapter<any, any>> {
+    adapter: A;
+    /**
+     * Controller(s) under test
+     */
+    controllers: Class | Class[];
+    /**
+     * Extra components to register for real, alongside the controllers' middlewares and
+     * validators (which are always real, since the framework resolves them by name)
+     */
+    components?: Class[];
+    /**
+     * Explicit doubles, keyed by service name. These win over the generated auto-mocks.
+     */
+    overrides?: Record<string, object>;
+    logger?: ServerLogger;
+    port?: number;
+    dispatch?: DispatchMode;
+}
+/**
+ * Result of {@link createWebTest}
+ */
+export interface WebTestResult {
+    app: TestApp;
+    /**
+     * Every double in play - both auto-generated mocks and the explicit `overrides` - keyed
+     * by **service name** (not field name, unlike `mockComponent`).
+     *
+     * One shared mock per service, so two controllers injecting the same service see the
+     * same double.
+     */
+    mocks: Record<string, any>;
+}

package/dist/lib/test/harness/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/test/harness/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../lib/test/harness/types.ts"],"names":[],"mappings":""}

package/dist/lib/test/http/TestHttpCall.d.ts

@@ -0,0 +1,78 @@
+import { TestHttpResponse } from './TestHttpResponse';
+/**
+ * A pending HTTP call with a fluent assertion chain.
+ *
+ * Nothing is sent until the call is awaited. Assertions queue up in the order they were
+ * chained and run against the buffered response; the send is memoized, so awaiting the
+ * same call twice does not issue a second request.
+ *
+ * @example
+ * ```typescript
+ * await app.get('/users/1').expectStatus(200).expectJson({ id: '1', name: 'Ada' });
+ *
+ * const res = await app.post('/users', { body: JSON.stringify({ name: 'Ada' }) }).expectStatus(201);
+ * expect(res.json().id).toBeString();
+ * ```
+ */
+export declare class TestHttpCall implements PromiseLike<TestHttpResponse> {
+    private readonly assertions;
+    private pending?;
+    private readonly url;
+    private readonly init?;
+    constructor(url: string, init?: RequestInit);
+    /**
+     * Asserts the response status code
+     *
+     * @param expected - Expected status
+     * @returns this, for chaining
+     */
+    expectStatus(expected: number): this;
+    /**
+     * Asserts a response header
+     *
+     * @param name - Header name (case-insensitive)
+     * @param expected - Exact value, or a pattern to match
+     * @returns this, for chaining
+     */
+    expectHeader(name: string, expected: string | RegExp): this;
+    /**
+     * Asserts the whole JSON body deep-equals the expected value
+     *
+     * @param expected - Expected body
+     * @returns this, for chaining
+     */
+    expectJson<T>(expected: T): this;
+    /**
+     * Asserts the JSON body contains at least the given properties
+     *
+     * @param partial - Subset the body must match
+     * @returns this, for chaining
+     */
+    expectJsonContains(partial: object): this;
+    /**
+     * Asserts the raw text body
+     *
+     * @param expected - Exact body, or a pattern to match
+     * @returns this, for chaining
+     */
+    expectBody(expected: string | RegExp): this;
+    /**
+     * Escape hatch for assertions the chain does not cover
+     *
+     * @param assertion - Runs against the buffered response, may be async
+     * @returns this, for chaining
+     *
+     * @example
+     * ```typescript
+     * await app.get('/users').expect((res) => {
+     *   expect(res.json<User[]>()).toHaveLength(3);
+     * });
+     * ```
+     */
+    expect(assertion: (response: TestHttpResponse) => void | Promise<void>): this;
+    then<TResult1 = TestHttpResponse, TResult2 = never>(onfulfilled?: ((value: TestHttpResponse) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null): PromiseLike<TResult1 | TResult2>;
+    private enqueue;
+    private send;
+    private run;
+    private describeRequest;
+}

package/dist/lib/test/http/TestHttpCall.js

@@ -0,0 +1,149 @@
+import { expect } from 'bun:test';
+import { TestHttpResponse, truncate } from './TestHttpResponse';
+/**
+ * A pending HTTP call with a fluent assertion chain.
+ *
+ * Nothing is sent until the call is awaited. Assertions queue up in the order they were
+ * chained and run against the buffered response; the send is memoized, so awaiting the
+ * same call twice does not issue a second request.
+ *
+ * @example
+ * ```typescript
+ * await app.get('/users/1').expectStatus(200).expectJson({ id: '1', name: 'Ada' });
+ *
+ * const res = await app.post('/users', { body: JSON.stringify({ name: 'Ada' }) }).expectStatus(201);
+ * expect(res.json().id).toBeString();
+ * ```
+ */
+export class TestHttpCall {
+    assertions = [];
+    pending;
+    url;
+    init;
+    constructor(url, init) {
+        this.url = url;
+        this.init = init;
+    }
+    /**
+     * Asserts the response status code
+     *
+     * @param expected - Expected status
+     * @returns this, for chaining
+     */
+    expectStatus(expected) {
+        // Deliberately not `expect(status).toBe(n)`: a bare number mismatch is the least
+        // useful failure in an HTTP test. The body almost always explains why.
+        return this.enqueue((response) => {
+            if (response.status !== expected) {
+                throw new Error(`Expected status ${expected} but received ${response.status} for ${this.describeRequest()}\n` +
+                    `Body: ${truncate(response.text())}`);
+            }
+        });
+    }
+    /**
+     * Asserts a response header
+     *
+     * @param name - Header name (case-insensitive)
+     * @param expected - Exact value, or a pattern to match
+     * @returns this, for chaining
+     */
+    expectHeader(name, expected) {
+        return this.enqueue((response) => {
+            const actual = response.headers.get(name);
+            if (actual === null) {
+                const received = [];
+                response.headers.forEach((_value, key) => received.push(key));
+                throw new Error(`Expected header '${name}' to be present for ${this.describeRequest()}, but it was not sent.\n` +
+                    `Received headers: ${received.join(', ') || '<none>'}`);
+            }
+            if (expected instanceof RegExp) {
+                expect(actual).toMatch(expected);
+            }
+            else {
+                expect(actual).toBe(expected);
+            }
+        });
+    }
+    /**
+     * Asserts the whole JSON body deep-equals the expected value
+     *
+     * @param expected - Expected body
+     * @returns this, for chaining
+     */
+    expectJson(expected) {
+        return this.enqueue((response) => {
+            expect(response.json()).toEqual(expected);
+        });
+    }
+    /**
+     * Asserts the JSON body contains at least the given properties
+     *
+     * @param partial - Subset the body must match
+     * @returns this, for chaining
+     */
+    expectJsonContains(partial) {
+        return this.enqueue((response) => {
+            expect(response.json()).toMatchObject(partial);
+        });
+    }
+    /**
+     * Asserts the raw text body
+     *
+     * @param expected - Exact body, or a pattern to match
+     * @returns this, for chaining
+     */
+    expectBody(expected) {
+        return this.enqueue((response) => {
+            if (expected instanceof RegExp) {
+                expect(response.text()).toMatch(expected);
+            }
+            else {
+                expect(response.text()).toBe(expected);
+            }
+        });
+    }
+    /**
+     * Escape hatch for assertions the chain does not cover
+     *
+     * @param assertion - Runs against the buffered response, may be async
+     * @returns this, for chaining
+     *
+     * @example
+     * ```typescript
+     * await app.get('/users').expect((res) => {
+     *   expect(res.json<User[]>()).toHaveLength(3);
+     * });
+     * ```
+     */
+    expect(assertion) {
+        return this.enqueue(assertion);
+    }
+    then(onfulfilled, onrejected) {
+        return this.send().then(onfulfilled, onrejected);
+    }
+    enqueue(assertion) {
+        if (this.pending !== undefined) {
+            throw new Error('Cannot add assertions to a TestHttpCall that has already been sent. ' +
+                'Chain every expect* call before awaiting the request.');
+        }
+        this.assertions.push(assertion);
+        return this;
+    }
+    send() {
+        if (this.pending === undefined) {
+            this.pending = this.run();
+        }
+        return this.pending;
+    }
+    async run() {
+        const response = await TestHttpResponse.from(await fetch(this.url, this.init));
+        for (const assertion of this.assertions) {
+            await assertion(response);
+        }
+        return response;
+    }
+    describeRequest() {
+        return `${(this.init?.method ?? 'GET').toUpperCase()} ${this.url}`;
+    }
+}
+//# sourceMappingURL=TestHttpCall.js.map

package/dist/lib/test/http/TestHttpCall.js.map

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

package/dist/lib/test/http/TestHttpResponse.d.ts

@@ -0,0 +1,46 @@
+/**
+ * A response whose body has already been read.
+ *
+ * `Response` bodies can only be consumed once, which makes them awkward to assert against
+ * more than one way. This buffers the body at construction so `text()` and `json()` are
+ * synchronous and repeatable.
+ */
+export declare class TestHttpResponse {
+    /**
+     * The underlying fetch Response. Its body stream is already consumed.
+     */
+    readonly raw: Response;
+    private readonly body;
+    private constructor();
+    /**
+     * Buffers a fetch Response into a TestHttpResponse
+     *
+     * @param raw - Response to consume
+     * @returns The buffered response
+     */
+    static from(raw: Response): Promise<TestHttpResponse>;
+    get status(): number;
+    get headers(): Headers;
+    /**
+     * The response body as text
+     *
+     * @returns Body string
+     */
+    text(): string;
+    /**
+     * The response body parsed as JSON
+     *
+     * @returns Parsed body
+     * @throws When the body is not valid JSON - the message includes the raw body
+     */
+    json<T = any>(): T;
+}
+/**
+ * Shortens a body for error messages so a large HTML page cannot bury the failure
+ *
+ * @param value - Body text
+ * @returns Truncated text
+ *
+ * @internal
+ */
+export declare function truncate(value: string, limit?: number): string;

package/dist/lib/test/http/TestHttpResponse.js

@@ -0,0 +1,70 @@
+/**
+ * A response whose body has already been read.
+ *
+ * `Response` bodies can only be consumed once, which makes them awkward to assert against
+ * more than one way. This buffers the body at construction so `text()` and `json()` are
+ * synchronous and repeatable.
+ */
+export class TestHttpResponse {
+    /**
+     * The underlying fetch Response. Its body stream is already consumed.
+     */
+    raw;
+    body;
+    constructor(raw, body) {
+        this.raw = raw;
+        this.body = body;
+    }
+    /**
+     * Buffers a fetch Response into a TestHttpResponse
+     *
+     * @param raw - Response to consume
+     * @returns The buffered response
+     */
+    static async from(raw) {
+        return new TestHttpResponse(raw, await raw.text());
+    }
+    get status() {
+        return this.raw.status;
+    }
+    get headers() {
+        return this.raw.headers;
+    }
+    /**
+     * The response body as text
+     *
+     * @returns Body string
+     */
+    text() {
+        return this.body;
+    }
+    /**
+     * The response body parsed as JSON
+     *
+     * @returns Parsed body
+     * @throws When the body is not valid JSON - the message includes the raw body
+     */
+    json() {
+        try {
+            return JSON.parse(this.body);
+        }
+        catch {
+            throw new Error(`Expected a JSON body but parsing failed. Received: ${truncate(this.body)}`);
+        }
+    }
+}
+/**
+ * Shortens a body for error messages so a large HTML page cannot bury the failure
+ *
+ * @param value - Body text
+ * @returns Truncated text
+ *
+ * @internal
+ */
+export function truncate(value, limit = 500) {
+    if (value.length <= limit) {
+        return value.length ? value : '<empty body>';
+    }
+    return `${value.slice(0, limit)}... (${value.length} bytes total)`;
+}
+//# sourceMappingURL=TestHttpResponse.js.map

package/dist/lib/test/http/TestHttpResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestHttpResponse.js","sourceRoot":"","sources":["../../../../lib/test/http/TestHttpResponse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;OAEG;IACa,GAAG,CAAW;IAEb,IAAI,CAAS;IAE9B,YAAoB,GAAa,EAAE,IAAY;QAC7C,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAa;QACpC,OAAO,IAAI,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IACzB,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACI,IAAI;QACT,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACI,IAAI;QACT,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAM,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,sDAAsD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,KAAK,GAAG,GAAG;IACjD,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC;IAC/C,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,KAAK,CAAC,MAAM,eAAe,CAAC;AACrE,CAAC"}

package/dist/lib/test/index.d.ts

@@ -1,3 +1,12 @@
 export { mockComponent, mockComponentAsync } from './mockComponent';
 export type { MockComponentOptions, MockedComponent } from './types';
 export { createMockFromClass } from './factory/mockFactory';
+export { createDeepMock } from './factory/deepMock';
+export { createTestUlakStub, type TestUlakNameSpace } from './factory/ulakStub';
+export { discoverInjectedFields, discoverInjectedFieldsFromClass } from './metadata/discovery';
+export { createTestApp } from './harness/createTestApp';
+export { createWebTest } from './harness/createWebTest';
+export { createCapturingLogger, silentLogger, type CapturedLogEntry } from './harness/silentLogger';
+export type { DispatchMode, TestApp, TestAppOptions, WebTestOptions, WebTestResult } from './harness/types';
+export { TestHttpCall } from './http/TestHttpCall';
+export { TestHttpResponse } from './http/TestHttpResponse';

package/dist/lib/test/index.js

@@ -1,3 +1,11 @@
 export { mockComponent, mockComponentAsync } from './mockComponent';
 export { createMockFromClass } from './factory/mockFactory';
+export { createDeepMock } from './factory/deepMock';
+export { createTestUlakStub } from './factory/ulakStub';
+export { discoverInjectedFields, discoverInjectedFieldsFromClass } from './metadata/discovery';
+export { createTestApp } from './harness/createTestApp';
+export { createWebTest } from './harness/createWebTest';
+export { createCapturingLogger, silentLogger } from './harness/silentLogger';
+export { TestHttpCall } from './http/TestHttpCall';
+export { TestHttpResponse } from './http/TestHttpResponse';
 //# sourceMappingURL=index.js.map

package/dist/lib/test/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/test/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/test/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAA0B,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAyB,MAAM,wBAAwB,CAAC;AAEpG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/lib/test/metadata/discovery.d.ts

@@ -16,6 +16,27 @@ import type { FieldMetadata } from '../types';
  * ```
  */
 export declare function discoverInjectedFields(instance: any): FieldMetadata[];
+/**
+ * Discovers all fields with @Inject decorator in a component class
+ * Traverses the constructor chain to support inheritance - no instantiation required
+ *
+ * This is the class-based counterpart of {@link discoverInjectedFields}. It is what
+ * slice tests use, since they must inspect a component's dependencies before deciding
+ * whether to register it for real or replace it with a mock.
+ *
+ * @param ComponentClass - Component class to inspect
+ * @returns Array of field metadata containing field names, service names, class refs and expressions
+ *
+ * @example
+ * ```typescript
+ * const fields = discoverInjectedFieldsFromClass(AuthService);
+ * // Returns: [
+ * //   { fieldName: 'userService', serviceName: 'UserService', serviceClass: UserService },
+ * //   { fieldName: 'chat', serviceName: '__Ulak__', expression: (u) => u.namespace('/chat') }
+ * // ]
+ * ```
+ */
+export declare function discoverInjectedFieldsFromClass(ComponentClass: any): FieldMetadata[];
 /**
  * Checks if a component has any injected dependencies
  *

package/dist/lib/test/metadata/discovery.js

@@ -17,16 +17,44 @@ import { getTypedMetadata, getOwnTypedMetadata } from '../../utils';
  * ```
  */
 export function discoverInjectedFields(instance) {
+    return discoverInjectedFieldsFromClass(Object.getPrototypeOf(instance)?.constructor);
+}
+/**
+ * Discovers all fields with @Inject decorator in a component class
+ * Traverses the constructor chain to support inheritance - no instantiation required
+ *
+ * This is the class-based counterpart of {@link discoverInjectedFields}. It is what
+ * slice tests use, since they must inspect a component's dependencies before deciding
+ * whether to register it for real or replace it with a mock.
+ *
+ * @param ComponentClass - Component class to inspect
+ * @returns Array of field metadata containing field names, service names, class refs and expressions
+ *
+ * @example
+ * ```typescript
+ * const fields = discoverInjectedFieldsFromClass(AuthService);
+ * // Returns: [
+ * //   { fieldName: 'userService', serviceName: 'UserService', serviceClass: UserService },
+ * //   { fieldName: 'chat', serviceName: '__Ulak__', expression: (u) => u.namespace('/chat') }
+ * // ]
+ * ```
+ */
+export function discoverInjectedFieldsFromClass(ComponentClass) {
     const fields = [];
     const processedFields = new Set();
-    // Traverse prototype chain (similar to how Container does it)
-    let currentPrototype = Object.getPrototypeOf(instance);
-    while (currentPrototype && currentPrototype !== Object.prototype) {
-        const constructor = currentPrototype.constructor;
+    let currentClass = ComponentClass;
+    // Traverse the constructor chain (similar to how Container does it)
+    while (currentClass && currentClass !== Function.prototype) {
+        // Stop at native code - matches Container.getPrototypeChain behaviour
+        if (typeof currentClass !== 'function' || currentClass.toString().includes('[native code]')) {
+            break;
+        }
         // Get dependencies metadata for this level
-        const dependencies = getOwnTypedMetadata(ComponentConstants.DependencyKey, constructor);
+        const dependencies = getOwnTypedMetadata(ComponentConstants.DependencyKey, currentClass);
+        // Get injected class references for this level (class-based injections only)
+        const dependencyClasses = getOwnTypedMetadata(ComponentConstants.DependencyClassKey, currentClass);
         // Get expressions metadata for this level
-        const expressions = getOwnTypedMetadata(ComponentConstants.ExpressionKey, constructor);
+        const expressions = getOwnTypedMetadata(ComponentConstants.ExpressionKey, currentClass);
         if (dependencies) {
             // Process each dependency field
             for (const [fieldName, serviceName] of Object.entries(dependencies)) {
@@ -38,12 +66,13 @@ export function discoverInjectedFields(instance) {
                 fields.push({
                     fieldName,
                     serviceName,
+                    serviceClass: dependencyClasses?.[fieldName],
                     expression: expressions?.[fieldName],
                 });
             }
         }
-        // Move up the prototype chain
-        currentPrototype = Object.getPrototypeOf(currentPrototype);
+        // Move up the constructor chain
+        currentClass = Object.getPrototypeOf(currentClass);
     }
     return fields;
 }

package/dist/lib/test/metadata/discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../../lib/test/metadata/discovery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAa;IAClD,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,8DAA8D;IAC9D,IAAI,gBAAgB,GAAG,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAEvD,OAAO,gBAAgB,IAAI,gBAAgB,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QACjE,MAAM,WAAW,GAAG,gBAAgB,CAAC,WAAW,CAAC;QAEjD,2CAA2C;QAC3C,MAAM,YAAY,GAAG,mBAAmB,CAAe,kBAAkB,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QAEtG,0CAA0C;QAC1C,MAAM,WAAW,GAAG,mBAAmB,CAAc,kBAAkB,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QAEpG,IAAI,YAAY,EAAE,CAAC;YACjB,gCAAgC;YAChC,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;gBACpE,oDAAoD;gBACpD,IAAI,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;oBACnC,SAAS;gBACX,CAAC;gBAED,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAE/B,MAAM,CAAC,IAAI,CAAC;oBACV,SAAS;oBACT,WAAW;oBACX,UAAU,EAAE,WAAW,EAAE,CAAC,SAAS,CAAC;iBACrC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,gBAAgB,GAAG,MAAM,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,cAA2C;IAC3E,MAAM,YAAY,GAAG,gBAAgB,CAAe,kBAAkB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IACtG,OAAO,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,cAA2C,EAC3C,SAAiB;IAEjB,MAAM,YAAY,GAAG,gBAAgB,CAAe,kBAAkB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IACtG,OAAO,YAAY,EAAE,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,cAA2C,EAC3C,SAAiB;IAEjB,MAAM,WAAW,GAAG,gBAAgB,CAAc,kBAAkB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IACpG,OAAO,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../../lib/test/metadata/discovery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAa;IAClD,OAAO,+BAA+B,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC;AACvF,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,+BAA+B,CAAC,cAAmB;IACjE,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,IAAI,YAAY,GAAG,cAAc,CAAC;IAElC,oEAAoE;IACpE,OAAO,YAAY,IAAI,YAAY,KAAK,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC3D,sEAAsE;QACtE,IAAI,OAAO,YAAY,KAAK,UAAU,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC5F,MAAM;QACR,CAAC;QAED,2CAA2C;QAC3C,MAAM,YAAY,GAAG,mBAAmB,CAAe,kBAAkB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;QAEvG,6EAA6E;QAC7E,MAAM,iBAAiB,GAAG,mBAAmB,CAC3C,kBAAkB,CAAC,kBAAkB,EACrC,YAAY,CACb,CAAC;QAEF,0CAA0C;QAC1C,MAAM,WAAW,GAAG,mBAAmB,CAAc,kBAAkB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;QAErG,IAAI,YAAY,EAAE,CAAC;YACjB,gCAAgC;YAChC,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;gBACpE,oDAAoD;gBACpD,IAAI,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;oBACnC,SAAS;gBACX,CAAC;gBAED,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAE/B,MAAM,CAAC,IAAI,CAAC;oBACV,SAAS;oBACT,WAAW;oBACX,YAAY,EAAE,iBAAiB,EAAE,CAAC,SAAS,CAAC;oBAC5C,UAAU,EAAE,WAAW,EAAE,CAAC,SAAS,CAAC;iBACrC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,cAA2C;IAC3E,MAAM,YAAY,GAAG,gBAAgB,CAAe,kBAAkB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IACtG,OAAO,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,cAA2C,EAC3C,SAAiB;IAEjB,MAAM,YAAY,GAAG,gBAAgB,CAAe,kBAAkB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IACtG,OAAO,YAAY,EAAE,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,cAA2C,EAC3C,SAAiB;IAEjB,MAAM,WAAW,GAAG,gBAAgB,CAAc,kBAAkB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IACpG,OAAO,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}