@asenajs/asena 0.7.0 → 0.8.0

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.0",
+  "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.57.2",
-    "@typescript-eslint/parser": "^8.57.2",
-    "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.1",
+    "prettier": "^3.9.6",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.57.2"
+    "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"