@daiso-tech/core 0.26.1 → 0.28.0

package/dist/event-bus/implementations/test-utilities/event-bus-adapter.test-suite.js

@@ -5,150 +5,59 @@ import { describe, } from "vitest";
 import { BaseEvent } from "../../../event-bus/contracts/_module-exports.js";
 import {} from "../../../utilities/_module-exports.js";
 import { TimeSpan } from "../../../utilities/_module-exports.js";
-import { delay } from "../../../async/_module-exports.js";
+import { LazyPromise } from "../../../async/_module-exports.js";
 import { Serde } from "../../../serde/implementations/derivables/_module-exports.js";
 import { NoOpSerdeAdapter } from "../../../serde/implementations/adapters/_module-exports.js";
 /**
  * The <i>eventBusAdapterTestSuite</i> function simplifies the process of testing your custom implementation of <i>{@link IEventBusAdapter}</i> with vitest.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/test-utilities"```
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/test-utilities"```
  * @group Test utilities
- * @example
- * ```ts
- * import { describe, test, beforeEach, expect, afterEach } from "vitest";
- * import type { StartedRedisContainer } from "@testcontainers/redis";
- * import { RedisContainer } from "@testcontainers/redis";
- * import Redis from "ioredis";
- * import { RedisPubSubEventBusAdapter } from "@daiso-tech/core/event-bus/adapters";
- * import { Serde } from "@daiso-tech/core/serde/implementations/derivables";
- * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/implementations/adapters";
- * import { eventBusAdapterTestSuite } from "@daiso-tech/core/event-bus/implementations/test-utilities";
- *
- * const TIMEOUT = TimeSpan.fromMinutes(2);
- * describe("class: RedisPubSubEventBusAdapter", () => {
- *   let dispatcherClient: Redis;
- *   let listenerClient: Redis;
- *   let startedContainer: StartedRedisContainer;
- *   const serde = new Serde(new SuperJsonSerdeAdapter());
- *
- *   beforeEach(async () => {
- *     startedContainer = await new RedisContainer().start();
- *     dispatcherClient = new Redis(startedContainer.getConnectionUrl());
- *     listenerClient = new Redis(startedContainer.getConnectionUrl());
- *   }, TIMEOUT.toMilliseconds());
- *
- *   afterEach(async () => {
- *     await dispatcherClient.quit();
- *     await listenerClient.quit();
- *     await startedContainer.stop();
- *   }, TIMEOUT.toMilliseconds());
- *
- *   eventBusAdapterTestSuite({
- *     createAdapter: () =>
- *       new RedisPubSubEventBusAdapter({
- *         dispatcherClient,
- *         listenerClient,
- *         serde,
- *         rootGroup: "@global"
- *       }),
- *     serde,
- *     test,
- *     beforeEach,
- *     expect,
- *     describe,
- *   });
- * });
- * ```
  */
 export function eventBusAdapterTestSuite(settings) {
     const { expect, test, createAdapter, beforeEach, serde = new Serde(new NoOpSerdeAdapter()), } = settings;
-    let eventBusAdapterA;
-    let eventBusAdapterB;
+    let adapter;
     beforeEach(async () => {
-        eventBusAdapterA = await createAdapter();
-        eventBusAdapterB = eventBusAdapterA.withGroup("b");
+        adapter = await createAdapter();
     });
     const TTL = TimeSpan.fromMilliseconds(50);
     class TestEvent extends BaseEvent {
     }
     serde.registerEvent(TestEvent);
-    describe("Api tests:", () => {
-        describe("method: addListener, removeListener, dispatch", () => {
-            test("Should be null when listener added and event is not triggered", async () => {
-                let result = null;
-                await eventBusAdapterA.addListener(TestEvent.name, (event) => {
-                    result = event;
-                });
-                expect(result).toBeNull();
-            });
-            test("Should be TestEvent when listener added and event is triggered", async () => {
-                let result = null;
-                await eventBusAdapterA.addListener(TestEvent.name, (event) => {
-                    result = event;
-                });
-                const event = new TestEvent({
-                    type: BaseEvent.name,
-                });
-                await eventBusAdapterA.dispatch(TestEvent.name, event);
-                await delay(TTL);
-                expect(result).toEqual(event);
-                expect(result).toBeInstanceOf(TestEvent);
-            });
-            test("Should be null when listener removed and event is triggered", async () => {
-                let result = null;
-                const listener = (event) => {
-                    result = event;
-                };
-                await eventBusAdapterA.addListener(TestEvent.name, listener);
-                await eventBusAdapterA.removeListener(TestEvent.name, listener);
-                const event = new TestEvent({
-                    type: BaseEvent.name,
-                });
-                await eventBusAdapterA.dispatch(TestEvent.name, event);
-                await delay(TTL);
-                expect(result).toBeNull();
+    describe("method: addListener, removeListener, dispatch", () => {
+        test("Should be null when listener added and event is not triggered", async () => {
+            let result = null;
+            await adapter.addListener(TestEvent.name, (event) => {
+                result = event;
             });
+            expect(result).toBeNull();
         });
-    });
-    describe("Group tests:", () => {
-        test("method: addListener / dispatch", async () => {
-            const event = new TestEvent({
-                type: "type",
-            });
-            let result_a = null;
-            await eventBusAdapterA.addListener(TestEvent.name, (event) => {
-                result_a = event;
+        test("Should be TestEvent when listener added and event is triggered", async () => {
+            let result = null;
+            await adapter.addListener(TestEvent.name, (event) => {
+                result = event;
             });
-            let result_b = null;
-            await eventBusAdapterB.addListener(TestEvent.name, (event) => {
-                result_b = event;
+            const event = new TestEvent({
+                type: BaseEvent.name,
             });
-            await eventBusAdapterA.dispatch(TestEvent.name, event);
-            await delay(TTL);
-            expect(result_a).toEqual(event);
-            expect(result_a).toBeInstanceOf(TestEvent);
-            expect(result_b).toBeNull();
+            await adapter.dispatch(TestEvent.name, event);
+            await LazyPromise.delay(TTL);
+            expect(result).toEqual(event);
+            expect(result).toBeInstanceOf(TestEvent);
         });
-        test("method: removeListener / addListener / dispatch", async () => {
+        test("Should be null when listener removed and event is triggered", async () => {
+            let result = null;
+            const listener = (event) => {
+                result = event;
+            };
+            await adapter.addListener(TestEvent.name, listener);
+            await adapter.removeListener(TestEvent.name, listener);
             const event = new TestEvent({
-                type: "type",
-            });
-            let result_a = null;
-            await eventBusAdapterA.addListener(TestEvent.name, (event) => {
-                result_a = event;
+                type: BaseEvent.name,
             });
-            let result_b = null;
-            const listenerB = (event) => {
-                result_b = event;
-            };
-            await eventBusAdapterB.addListener(TestEvent.name, listenerB);
-            await eventBusAdapterB.removeListener(TestEvent.name, listenerB);
-            await eventBusAdapterA.dispatch(TestEvent.name, event);
-            await eventBusAdapterB.dispatch(TestEvent.name, event);
-            await delay(TTL);
-            expect(result_a).toEqual(event);
-            expect(result_a).toBeInstanceOf(TestEvent);
-            expect(result_b).toBeNull();
+            await adapter.dispatch(TestEvent.name, event);
+            await LazyPromise.delay(TTL);
+            expect(result).toBeNull();
         });
     });
 }

package/dist/event-bus/implementations/test-utilities/event-bus-adapter.test-suite.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-bus-adapter.test-suite.js","sourceRoot":"","sources":["../../../../src/event-bus/implementations/test-utilities/event-bus-adapter.test-suite.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"event-bus-adapter.test-suite.js","sourceRoot":"","sources":["../../../../src/event-bus/implementations/test-utilities/event-bus-adapter.test-suite.ts"],"names":[],"mappings":"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"}

package/dist/event-bus/implementations/test-utilities/event-bus.test-suite.d.ts

@@ -7,7 +7,7 @@ import { type Promisable } from "../../../utilities/_module-exports.js";
 import type { IFlexibleSerde } from "../../../serde/contracts/_module-exports.js";
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/test-utilities"```
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/test-utilities"```
  * @group Test utilities
  */
 export type EventBusTestSuiteSettings = {
@@ -21,55 +21,7 @@ export type EventBusTestSuiteSettings = {
 /**
  * The <i>eventBusTestSuite</i> function simplifies the process of testing your custom implementation of <i>{@link IEventBus}</i> with vitest.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/test-utilities"```
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/test-utilities"```
  * @group Test utilities
- * @example
- * ```ts
- * import { describe, test, beforeEach, expect, afterEach } from "vitest";
- * import type { StartedRedisContainer } from "@testcontainers/redis";
- * import { RedisContainer } from "@testcontainers/redis";
- * import Redis from "ioredis";
- * import { RedisPubSubEventBusAdapter } from "@daiso-tech/core/event-bus/adapters";
- * import { Serde } from "@daiso-tech/core/serde/implementations/derivables";
- * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/implementations/adapters";
- * import { eventBusTestSuite } from "@daiso-tech/core/event-bus/implementations/test-utilities";
- *
- * const TIMEOUT = TimeSpan.fromMinutes(2);
- * describe("class: EventBus", () => {
- *   let dispatcherClient: Redis;
- *   let listenerClient: Redis;
- *   let startedContainer: StartedRedisContainer;
- *   const serde = new Serde(new SuperJsonSerdeAdapter());
- *
- *   beforeEach(async () => {
- *     startedContainer = await new RedisContainer().start();
- *     dispatcherClient = new Redis(startedContainer.getConnectionUrl());
- *     listenerClient = new Redis(startedContainer.getConnectionUrl());
- *   }, TIMEOUT.toMilliseconds());
- *
- *   afterEach(async () => {
- *     await dispatcherClient.quit();
- *     await listenerClient.quit();
- *     await startedContainer.stop();
- *   }, TIMEOUT.toMilliseconds());
- *
- *   eventBusTestSuite({
- *     createEventBus: () =>
- *       new EventBus(
- *         new RedisPubSubEventBusAdapter({
- *           dispatcherClient,
- *           listenerClient,
- *           serde,
- *           rootGroup: "@global"
- *         })
- *       ),
- *     serde,
- *     test,
- *     beforeEach,
- *     expect,
- *     describe,
- *   });
- * });
- * ```
  */
 export declare function eventBusTestSuite(settings: EventBusTestSuiteSettings): void;

package/dist/event-bus/implementations/test-utilities/event-bus.test-suite.js

@@ -5,62 +5,14 @@ import {} from "vitest";
 import { BaseEvent, } from "../../../event-bus/contracts/_module-exports.js";
 import {} from "../../../utilities/_module-exports.js";
 import { TimeSpan } from "../../../utilities/_module-exports.js";
-import { delay } from "../../../async/_module-exports.js";
+import { LazyPromise } from "../../../async/_module-exports.js";
 import { Serde } from "../../../serde/implementations/derivables/_module-exports.js";
 import { NoOpSerdeAdapter } from "../../../serde/implementations/adapters/_module-exports.js";
 /**
  * The <i>eventBusTestSuite</i> function simplifies the process of testing your custom implementation of <i>{@link IEventBus}</i> with vitest.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/event-bus/implementations/test-utilities"```
+ * IMPORT_PATH: ```"@daiso-tech/core/event-bus/test-utilities"```
  * @group Test utilities
- * @example
- * ```ts
- * import { describe, test, beforeEach, expect, afterEach } from "vitest";
- * import type { StartedRedisContainer } from "@testcontainers/redis";
- * import { RedisContainer } from "@testcontainers/redis";
- * import Redis from "ioredis";
- * import { RedisPubSubEventBusAdapter } from "@daiso-tech/core/event-bus/adapters";
- * import { Serde } from "@daiso-tech/core/serde/implementations/derivables";
- * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/implementations/adapters";
- * import { eventBusTestSuite } from "@daiso-tech/core/event-bus/implementations/test-utilities";
- *
- * const TIMEOUT = TimeSpan.fromMinutes(2);
- * describe("class: EventBus", () => {
- *   let dispatcherClient: Redis;
- *   let listenerClient: Redis;
- *   let startedContainer: StartedRedisContainer;
- *   const serde = new Serde(new SuperJsonSerdeAdapter());
- *
- *   beforeEach(async () => {
- *     startedContainer = await new RedisContainer().start();
- *     dispatcherClient = new Redis(startedContainer.getConnectionUrl());
- *     listenerClient = new Redis(startedContainer.getConnectionUrl());
- *   }, TIMEOUT.toMilliseconds());
- *
- *   afterEach(async () => {
- *     await dispatcherClient.quit();
- *     await listenerClient.quit();
- *     await startedContainer.stop();
- *   }, TIMEOUT.toMilliseconds());
- *
- *   eventBusTestSuite({
- *     createEventBus: () =>
- *       new EventBus(
- *         new RedisPubSubEventBusAdapter({
- *           dispatcherClient,
- *           listenerClient,
- *           serde,
- *           rootGroup: "@global"
- *         })
- *       ),
- *     serde,
- *     test,
- *     beforeEach,
- *     expect,
- *     describe,
- *   });
- * });
- * ```
  */
 export function eventBusTestSuite(settings) {
     const { expect, serde = new Serde(new NoOpSerdeAdapter()), test, describe, createEventBus, beforeEach, } = settings;
@@ -127,7 +79,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.result).toEqual(event);
                     expect(listener.result).toBeInstanceOf(AddEvent);
                     await eventBusA.removeListener(AddEvent, listener);
@@ -146,7 +98,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.result).toEqual(event);
                     expect(listener.result).toBeInstanceOf(AddEvent);
                     await eventBusA.removeListener(AddEvent, listener);
@@ -162,7 +114,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(result).toEqual(event);
                     expect(result).toBeInstanceOf(AddEvent);
                     await eventBusA.removeListener(AddEvent, listener);
@@ -183,7 +135,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.result).toBeNull();
                 });
                 test("Class instance listener", async () => {
@@ -201,7 +153,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.result).toBeNull();
                 });
                 test("Function listener", async () => {
@@ -216,7 +168,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(result).toBeNull();
                 });
             });
@@ -301,7 +253,7 @@ export function eventBusTestSuite(settings) {
                         d: 2,
                     });
                     await eventBusA.dispatchMany([addEvent, subEvent]);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.resultA).toEqual(addEvent);
                     expect(listener.resultA).toBeInstanceOf(AddEvent);
                     expect(listener.resultB).toEqual(subEvent);
@@ -332,7 +284,7 @@ export function eventBusTestSuite(settings) {
                         d: 2,
                     });
                     await eventBusA.dispatchMany([addEvent, subEvent]);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.resultA).toEqual(addEvent);
                     expect(listener.resultA).toBeInstanceOf(AddEvent);
                     expect(listener.resultB).toEqual(subEvent);
@@ -360,7 +312,7 @@ export function eventBusTestSuite(settings) {
                         d: 2,
                     });
                     await eventBusA.dispatchMany([addEvent, subEvent]);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(resultA).toEqual(addEvent);
                     expect(resultA).toBeInstanceOf(AddEvent);
                     expect(resultB).toEqual(subEvent);
@@ -393,7 +345,7 @@ export function eventBusTestSuite(settings) {
                         d: 2,
                     });
                     await eventBusA.dispatchMany([addEvent, subEvent]);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.resultA).toBeNull();
                     expect(listener.resultB).toBeNull();
                 });
@@ -422,7 +374,7 @@ export function eventBusTestSuite(settings) {
                         d: 2,
                     });
                     await eventBusA.dispatchMany([addEvent, subEvent]);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.resultA).toBeNull();
                     expect(listener.resultB).toBeNull();
                 });
@@ -448,7 +400,7 @@ export function eventBusTestSuite(settings) {
                         d: 2,
                     });
                     await eventBusA.dispatchMany([addEvent, subEvent]);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(resultA).toBeNull();
                     expect(resultB).toBeNull();
                 });
@@ -503,7 +455,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.result).toEqual(event);
                     expect(listener.result).toBeInstanceOf(AddEvent);
                     await unsubscribe();
@@ -522,7 +474,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.result).toEqual(event);
                     expect(listener.result).toBeInstanceOf(AddEvent);
                     await unsubscribe();
@@ -538,7 +490,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(result).toEqual(event);
                     expect(result).toBeInstanceOf(AddEvent);
                     await unsubscribe();
@@ -559,7 +511,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.result).toBeNull();
                 });
                 test("Class instance listener", async () => {
@@ -577,7 +529,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.result).toBeNull();
                 });
                 test("Function listener", async () => {
@@ -592,7 +544,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(result).toBeNull();
                 });
             });
@@ -677,7 +629,7 @@ export function eventBusTestSuite(settings) {
                         d: 2,
                     });
                     await eventBusA.dispatchMany([addEvent, subEvent]);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.resultA).toEqual(addEvent);
                     expect(listener.resultA).toBeInstanceOf(AddEvent);
                     expect(listener.resultB).toEqual(subEvent);
@@ -708,7 +660,7 @@ export function eventBusTestSuite(settings) {
                         d: 2,
                     });
                     await eventBusA.dispatchMany([addEvent, subEvent]);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.resultA).toEqual(addEvent);
                     expect(listener.resultA).toBeInstanceOf(AddEvent);
                     expect(listener.resultB).toEqual(subEvent);
@@ -736,7 +688,7 @@ export function eventBusTestSuite(settings) {
                         d: 2,
                     });
                     await eventBusA.dispatchMany([addEvent, subEvent]);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(resultA).toEqual(addEvent);
                     expect(resultA).toBeInstanceOf(AddEvent);
                     expect(resultB).toEqual(subEvent);
@@ -769,7 +721,7 @@ export function eventBusTestSuite(settings) {
                         d: 2,
                     });
                     await eventBusA.dispatchMany([addEvent, subEvent]);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.resultA).toBeNull();
                     expect(listener.resultB).toBeNull();
                 });
@@ -798,7 +750,7 @@ export function eventBusTestSuite(settings) {
                         d: 2,
                     });
                     await eventBusA.dispatchMany([addEvent, subEvent]);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.resultA).toBeNull();
                     expect(listener.resultB).toBeNull();
                 });
@@ -824,7 +776,7 @@ export function eventBusTestSuite(settings) {
                         d: 2,
                     });
                     await eventBusA.dispatchMany([addEvent, subEvent]);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(resultA).toBeNull();
                     expect(resultB).toBeNull();
                 });
@@ -876,7 +828,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.result).toEqual(event);
                     expect(listener.result).toBeInstanceOf(AddEvent);
                 });
@@ -894,7 +846,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.result).toEqual(event);
                     expect(listener.result).toBeInstanceOf(AddEvent);
                 });
@@ -909,7 +861,7 @@ export function eventBusTestSuite(settings) {
                         b: 2,
                     });
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(result).toEqual(event);
                     expect(result).toBeInstanceOf(AddEvent);
                 });
@@ -929,7 +881,7 @@ export function eventBusTestSuite(settings) {
                     });
                     await eventBusA.dispatch(event);
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.i).toBe(1);
                 });
                 test("Class instance listener", async () => {
@@ -947,7 +899,7 @@ export function eventBusTestSuite(settings) {
                     });
                     await eventBusA.dispatch(event);
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(listener.i).toBe(1);
                 });
                 test("Function listener", async () => {
@@ -962,7 +914,7 @@ export function eventBusTestSuite(settings) {
                     });
                     await eventBusA.dispatch(event);
                     await eventBusA.dispatch(event);
-                    await delay(TTL);
+                    await LazyPromise.delay(TTL);
                     expect(i).toBe(1);
                 });
             });
@@ -987,7 +939,7 @@ export function eventBusTestSuite(settings) {
                     b: 2,
                 });
                 await eventBusA.dispatch(event);
-                await delay(TTL);
+                await LazyPromise.delay(TTL);
                 expect(result).toEqual(event);
                 expect(result).toBeInstanceOf(AddEvent);
             });
@@ -1008,7 +960,7 @@ export function eventBusTestSuite(settings) {
                 b: 2,
             });
             await eventBusA.dispatch(event);
-            await delay(TTL);
+            await LazyPromise.delay(TTL);
             expect(result_a).toEqual(event);
             expect(result_a).toBeInstanceOf(AddEvent);
             expect(result_b).toBeNull();
@@ -1027,7 +979,7 @@ export function eventBusTestSuite(settings) {
                 b: 2,
             });
             await eventBusA.dispatch(event);
-            await delay(TTL);
+            await LazyPromise.delay(TTL);
             expect(result_a).toEqual(event);
             expect(result_a).toBeInstanceOf(AddEvent);
             expect(result_b).toBeNull();
@@ -1049,7 +1001,7 @@ export function eventBusTestSuite(settings) {
             });
             await eventBusA.dispatch(event);
             await eventBusB.dispatch(event);
-            await delay(TTL);
+            await LazyPromise.delay(TTL);
             expect(result_a).toEqual(event);
             expect(result_a).toBeInstanceOf(AddEvent);
             expect(result_b).toBeNull();
@@ -1071,7 +1023,7 @@ export function eventBusTestSuite(settings) {
             });
             await eventBusA.dispatch(event);
             await eventBusB.dispatch(event);
-            await delay(TTL);
+            await LazyPromise.delay(TTL);
             expect(result_a).toEqual(event);
             expect(result_a).toBeInstanceOf(AddEvent);
             expect(result_b).toBeNull();
@@ -1093,7 +1045,7 @@ export function eventBusTestSuite(settings) {
             });
             await eventBusA.dispatch(event);
             await eventBusB.dispatch(event);
-            await delay(TTL);
+            await LazyPromise.delay(TTL);
             expect(result_a).toEqual(event);
             expect(result_a).toBeInstanceOf(AddEvent);
             expect(result_b).toBeNull();
@@ -1115,7 +1067,7 @@ export function eventBusTestSuite(settings) {
             });
             await eventBusA.dispatch(event);
             await eventBusB.dispatch(event);
-            await delay(TTL);
+            await LazyPromise.delay(TTL);
             expect(result_a).toEqual(event);
             expect(result_a).toBeInstanceOf(AddEvent);
             expect(result_b).toBeNull();
@@ -1134,7 +1086,7 @@ export function eventBusTestSuite(settings) {
                 b: 2,
             });
             await eventBusA.dispatch(event);
-            await delay(TTL);
+            await LazyPromise.delay(TTL);
             expect(result_a).toEqual(event);
             expect(result_a).toBeInstanceOf(AddEvent);
             expect(result_b).toBeNull();
@@ -1153,7 +1105,7 @@ export function eventBusTestSuite(settings) {
                 b: 2,
             });
             await eventBusA.dispatch(event);
-            await delay(TTL);
+            await LazyPromise.delay(TTL);
             expect(result_a).toEqual(event);
             expect(result_a).toBeInstanceOf(AddEvent);
             expect(result_b).toBeNull();