@asenajs/asena 0.7.1 → 0.8.0

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

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

@@ -5,6 +5,13 @@ import type { MockComponentOptions, MockedComponent } from './types';
  * This is the main API for testing Asena components. It discovers all @Inject decorated
  * fields, generates mock objects for them, and injects them into a new instance.
  *
+ * What each field receives depends on how it was injected:
+ * - `@Inject(UserService)` - a mock shaped like the class: every method becomes a bun mock
+ * - `@Inject(ulak('/chat'))` and other expression injections - the expression is evaluated
+ *   against a deep mock, so any call chain works and every call stays assertable
+ * - `@Inject('UserService')` - a plain `{}`, because a string carries no class reference.
+ *   Pass `overrides` for those fields.
+ *
  * @template T - Type of the component being mocked
  * @param ComponentClass - Component class to instantiate and mock
  * @param options - Optional configuration for mocking behavior
@@ -52,6 +59,24 @@ import type { MockComponentOptions, MockedComponent } from './types';
  *   }
  * });
  * ```
+ *
+ * @example
+ * ```typescript
+ * // Expression-based injections (e.g. the ulak() helper) work automatically:
+ * // the expression is evaluated against a deep mock, so the field behaves
+ * // like a real namespace and every method call is assertable
+ * const { instance, mocks } = mockComponent(ChatService);
+ *
+ * await instance.sendAnnouncement('hello');
+ *
+ * expect(mocks.chat.broadcast).toHaveBeenCalledWith({ type: 'announcement', text: 'hello' });
+ *
+ * // A field present in overrides is used as-is - its expression is skipped
+ * const stub = createTestUlakStub('/chat');
+ * const { instance: withStub } = mockComponent(ChatService, {
+ *   overrides: { chat: stub },
+ * });
+ * ```
  */
 export declare function mockComponent<T extends object>(ComponentClass: new (...args: any[]) => T, options?: MockComponentOptions): MockedComponent<T>;
 /**

package/dist/lib/test/mockComponent.js

@@ -1,11 +1,19 @@
 import { discoverInjectedFields } from './metadata/discovery';
 import { createMockFromClass } from './factory/mockFactory';
+import { createDeepMock } from './factory/deepMock';
 /**
  * Creates a test instance of a component with all @Inject dependencies automatically mocked
  *
  * This is the main API for testing Asena components. It discovers all @Inject decorated
  * fields, generates mock objects for them, and injects them into a new instance.
  *
+ * What each field receives depends on how it was injected:
+ * - `@Inject(UserService)` - a mock shaped like the class: every method becomes a bun mock
+ * - `@Inject(ulak('/chat'))` and other expression injections - the expression is evaluated
+ *   against a deep mock, so any call chain works and every call stays assertable
+ * - `@Inject('UserService')` - a plain `{}`, because a string carries no class reference.
+ *   Pass `overrides` for those fields.
+ *
  * @template T - Type of the component being mocked
  * @param ComponentClass - Component class to instantiate and mock
  * @param options - Optional configuration for mocking behavior
@@ -53,6 +61,24 @@ import { createMockFromClass } from './factory/mockFactory';
  *   }
  * });
  * ```
+ *
+ * @example
+ * ```typescript
+ * // Expression-based injections (e.g. the ulak() helper) work automatically:
+ * // the expression is evaluated against a deep mock, so the field behaves
+ * // like a real namespace and every method call is assertable
+ * const { instance, mocks } = mockComponent(ChatService);
+ *
+ * await instance.sendAnnouncement('hello');
+ *
+ * expect(mocks.chat.broadcast).toHaveBeenCalledWith({ type: 'announcement', text: 'hello' });
+ *
+ * // A field present in overrides is used as-is - its expression is skipped
+ * const stub = createTestUlakStub('/chat');
+ * const { instance: withStub } = mockComponent(ChatService, {
+ *   overrides: { chat: stub },
+ * });
+ * ```
  */
 export function mockComponent(ComponentClass, options = {}) {
     if (!ComponentClass || typeof ComponentClass !== 'function') {
@@ -65,16 +91,23 @@ export function mockComponent(ComponentClass, options = {}) {
         : allInjectedFields;
     const mocks = {};
     for (const field of fieldsToMock) {
-        const { fieldName, expression } = field;
+        const { fieldName, expression, serviceClass } = field;
         let mockValue;
-        if (options.overrides?.[fieldName]) {
+        if (options.overrides && Object.hasOwn(options.overrides, fieldName)) {
+            // Overrides are the FINAL field value: the expression is intentionally
+            // skipped and falsy values (0, '', null) are respected
             mockValue = options.overrides[fieldName];
         }
-        else {
-            mockValue = createMockFromClass(undefined);
+        else if (expression) {
+            // Expression fields (e.g. @Inject(ulak('/chat'))) receive a deep mock
+            // so any call chain the expression performs works without a running app
+            mockValue = expression(createDeepMock());
         }
-        if (expression) {
-            mockValue = expression(mockValue);
+        else {
+            // Class injections (@Inject(UserService)) get a mock shaped like the real class:
+            // every method becomes a bun mock. String injections (@Inject('UserService'))
+            // carry no class reference, so they degrade to {} and need an explicit override
+            mockValue = createMockFromClass(serviceClass);
         }
         instance[fieldName] = mockValue;
         mocks[fieldName] = mockValue;

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

@@ -1 +1 @@
-{"version":3,"file":"mockComponent.js","sourceRoot":"","sources":["../../../lib/test/mockComponent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,MAAM,UAAU,aAAa,CAC3B,cAAyC,EACzC,UAAgC,EAAE;IAElC,IAAI,CAAC,cAAc,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,4DAA4D,OAAO,cAAc,EAAE,CAAC,CAAC;IACvG,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IACtC,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAE3D,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU;QACrC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACnF,CAAC,CAAC,iBAAiB,CAAC;IAEtB,MAAM,KAAK,GAAwB,EAAE,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;QAExC,IAAI,SAAc,CAAC;QAEnB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,SAAS,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;QAEA,QAAgB,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;QACzC,KAAK,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAE/C,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAQ,CAAC;QACzD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,cAAyC,EACzC,UAAgC,EAAE;IAElC,MAAM,MAAM,GAAG,aAAa,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAEtD,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"mockComponent.js","sourceRoot":"","sources":["../../../lib/test/mockComponent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,MAAM,UAAU,aAAa,CAC3B,cAAyC,EACzC,UAAgC,EAAE;IAElC,IAAI,CAAC,cAAc,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,4DAA4D,OAAO,cAAc,EAAE,CAAC,CAAC;IACvG,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IACtC,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAE3D,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU;QACrC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACnF,CAAC,CAAC,iBAAiB,CAAC;IAEtB,MAAM,KAAK,GAAwB,EAAE,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;QAEtD,IAAI,SAAc,CAAC;QAEnB,IAAI,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;YACrE,uEAAuE;YACvE,uDAAuD;YACvD,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,UAAU,EAAE,CAAC;YACtB,sEAAsE;YACtE,wEAAwE;YACxE,SAAS,GAAG,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,iFAAiF;YACjF,8EAA8E;YAC9E,gFAAgF;YAChF,SAAS,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;QAChD,CAAC;QAEA,QAAgB,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;QACzC,KAAK,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAE/C,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAQ,CAAC;QACzD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,cAAyC,EACzC,UAAgC,EAAE;IAElC,MAAM,MAAM,GAAG,aAAa,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAEtD,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -17,6 +17,11 @@ export interface MockComponentOptions {
     /**
      * Provide custom mocks instead of auto-generated ones (optional)
      *
+     * An override is the FINAL value injected into the field. For expression-based
+     * injections (e.g. @Inject(ulak('/chat'))) the expression is skipped entirely
+     * when the field is overridden. Presence is checked with Object.hasOwn, so
+     * falsy values (0, '', null, undefined) are injected as-is rather than ignored.
+     *
      * @example
      * ```typescript
      * mockComponent(AuthService, {
@@ -75,6 +80,14 @@ export interface FieldMetadata {
      * Service name (from @Inject decorator)
      */
     serviceName: string;
+    /**
+     * Class reference the field was injected with.
+     *
+     * Only present for class-based injections (`@Inject(UserService)`). String-based
+     * injections (`@Inject('UserService')`) carry no class reference, so this is
+     * undefined and auto-mocking degrades to an empty object.
+     */
+    serviceClass?: any;
     /**
      * Optional expression function for transformation
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asenajs/asena",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "author": "LibirSoft",
   "repository": {
     "type": "git",
@@ -12,15 +12,15 @@
     "reflect-metadata": "^0.2.2"
   },
   "devDependencies": {
-    "@changesets/cli": "^2.30.0",
+    "@changesets/cli": "^2.31.1",
     "@types/bun": "latest",
-    "@typescript-eslint/eslint-plugin": "^8.58.1",
-    "@typescript-eslint/parser": "^8.58.1",
-    "eslint": "^9.39.4",
+    "@typescript-eslint/eslint-plugin": "^8.65.0",
+    "@typescript-eslint/parser": "^8.65.0",
+    "eslint": "^9.39.5",
     "eslint-config-prettier": "^9.1.2",
-    "prettier": "^3.8.2",
+    "prettier": "^3.9.6",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.58.1"
+    "typescript-eslint": "^8.65.0"
   },
   "exports": {
     ".": {
@@ -83,6 +83,10 @@
       "import": "./dist/lib/server/messaging/index.js",
       "types": "./dist/lib/server/messaging/index.d.ts"
     },
+    "./microservice": {
+      "import": "./dist/lib/server/microservice/index.js",
+      "types": "./dist/lib/server/microservice/index.d.ts"
+    },
     "./event": {
       "import": "./dist/lib/server/event/index.js",
       "types": "./dist/lib/server/event/index.d.ts"