@bsb/tests 0.0.1

package/lib/runner/plugin-custom.js

@@ -0,0 +1,119 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const pluginId = process.env.BSB_TEST_PLUGIN_ID;
+const pluginRoot = process.env.BSB_TEST_PLUGIN_ROOT;
+const pluginName = process.env.BSB_TEST_PLUGIN_NAME || pluginId || "unknown-plugin";
+const pluginConfigRaw = process.env.BSB_TEST_PLUGIN_CONFIG || "null";
+if (!pluginId || !pluginRoot) {
+    throw new Error("BSB_TEST_PLUGIN_ID and BSB_TEST_PLUGIN_ROOT are required");
+}
+const config = JSON.parse(pluginConfigRaw);
+const testsRoot = path_1.default.resolve(process.cwd(), "tests", pluginId);
+if (!fs_1.default.existsSync(testsRoot)) {
+    describe(`custom: ${pluginName}`, () => {
+        it("no custom tests found", () => { });
+    });
+}
+else {
+    const isTestFile = (file) => {
+        const base = path_1.default.basename(file);
+        if (base.startsWith("_"))
+            return false;
+        return base.endsWith(".ts") || base.endsWith(".js") || base.endsWith(".cjs") || base.endsWith(".mjs");
+    };
+    const findTests = (dir) => {
+        const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
+        const results = [];
+        for (const entry of entries) {
+            const full = path_1.default.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                results.push(...findTests(full));
+                continue;
+            }
+            if (entry.isFile() && isTestFile(entry.name)) {
+                results.push(full);
+            }
+        }
+        return results;
+    };
+    const findHook = (dir, name) => {
+        const exts = [".ts", ".js", ".cjs", ".mjs"];
+        for (const ext of exts) {
+            const candidate = path_1.default.join(dir, `${name}${ext}`);
+            if (fs_1.default.existsSync(candidate))
+                return candidate;
+        }
+        return null;
+    };
+    const loadTestFn = (file) => {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const mod = require(file);
+        return mod.default || mod.test || mod.run || mod;
+    };
+    const tests = findTests(testsRoot);
+    const grouped = {};
+    for (const testFile of tests) {
+        const rel = path_1.default.relative(testsRoot, testFile);
+        const dir = path_1.default.dirname(rel);
+        const group = dir === "." ? "default" : dir;
+        if (!grouped[group])
+            grouped[group] = [];
+        grouped[group].push(testFile);
+    }
+    describe(`custom: ${pluginName}`, () => {
+        for (const group of Object.keys(grouped)) {
+            const groupDir = group === "default" ? testsRoot : path_1.default.join(testsRoot, group);
+            const beforeHook = findHook(groupDir, "_before");
+            const afterHook = findHook(groupDir, "_after");
+            let sharedData = undefined;
+            describe(group, () => {
+                before(async () => {
+                    if (beforeHook) {
+                        const hookFn = loadTestFn(beforeHook);
+                        const maybe = await hookFn({
+                            pluginId,
+                            pluginName,
+                            pluginRoot,
+                            config,
+                            group,
+                        });
+                        if (maybe !== undefined) {
+                            sharedData = maybe;
+                        }
+                    }
+                });
+                after(async () => {
+                    if (afterHook) {
+                        const hookFn = loadTestFn(afterHook);
+                        await hookFn({
+                            pluginId,
+                            pluginName,
+                            pluginRoot,
+                            config,
+                            group,
+                        }, sharedData);
+                    }
+                });
+                for (const testFile of grouped[group]) {
+                    const testName = path_1.default.basename(testFile).replace(/\.(ts|js|cjs|mjs)$/i, "");
+                    it(testName, async () => {
+                        const testFn = loadTestFn(testFile);
+                        await testFn({
+                            pluginId,
+                            pluginName,
+                            pluginRoot,
+                            config,
+                            group,
+                        }, sharedData);
+                    });
+                }
+            });
+        }
+    });
+}
+//# sourceMappingURL=plugin-custom.js.map

package/lib/runner/plugin-custom.js.map

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

package/lib/runner/plugin-events.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/runner/plugin-events.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const trace_1 = require("../trace");
+const mocks_1 = require("../mocks");
+const broadcast_1 = require("../sb/plugins/events/broadcast");
+const emit_1 = require("../sb/plugins/events/emit");
+const emitAndReturn_1 = require("../sb/plugins/events/emitAndReturn");
+const emitStreamAndReceiveStream_1 = require("../sb/plugins/events/emitStreamAndReceiveStream");
+const pluginModule = process.env.BSB_TEST_PLUGIN_MODULE;
+const pluginName = process.env.BSB_TEST_PLUGIN_NAME || "unknown-plugin";
+const pluginConfigRaw = process.env.BSB_TEST_PLUGIN_CONFIG || "null";
+if (!pluginModule) {
+    throw new Error("BSB_TEST_PLUGIN_MODULE is required");
+}
+const resolvedModule = path_1.default.resolve(pluginModule);
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const mod = require(resolvedModule);
+const PluginCtor = mod.Plugin || mod.default || mod;
+const config = JSON.parse(pluginConfigRaw);
+describe(`events: ${pluginName}`, () => {
+    const gen = async () => {
+        const refP = new PluginCtor(await (0, mocks_1.getEventsConstructorConfig)(config));
+        if (refP.init) {
+            await refP.init((0, trace_1.createTestObservable)());
+        }
+        return refP;
+    };
+    (0, broadcast_1.broadcast)(gen, 30);
+    (0, emit_1.emit)(gen, 30);
+    (0, emitAndReturn_1.emitAndReturn)(gen, 30);
+    (0, emitStreamAndReceiveStream_1.emitStreamAndReceiveStream)(gen, 500);
+});
+//# sourceMappingURL=plugin-events.js.map

package/lib/runner/plugin-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-events.js","sourceRoot":"","sources":["../../src/runner/plugin-events.ts"],"names":[],"mappings":";;;;;AAAA,gDAAwB;AACxB,oCAAgD;AAChD,oCAAsD;AACtD,8DAA2D;AAC3D,oDAAiD;AACjD,sEAAmE;AACnE,gGAA6F;AAE7F,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;AACxD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,gBAAgB,CAAC;AACxE,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,MAAM,CAAC;AAErE,IAAI,CAAC,YAAY,EAAE,CAAC;IAClB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,cAAc,GAAG,cAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAClD,8DAA8D;AAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AACpC,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;AAEpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;AAE3C,QAAQ,CAAC,WAAW,UAAU,EAAE,EAAE,GAAG,EAAE;IACrC,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE;QACrB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,IAAA,kCAA0B,EAAC,MAAM,CAAC,CAAC,CAAC;QACtE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,IAAI,CAAC,IAAA,4BAAoB,GAAE,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,IAAA,qBAAS,EAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnB,IAAA,WAAI,EAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACd,IAAA,6BAAa,EAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACvB,IAAA,uDAA0B,EAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC"}

package/lib/runner/plugin-observable.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/runner/plugin-observable.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const index_1 = require("../sb/plugins/observable/index");
+const pluginModule = process.env.BSB_TEST_PLUGIN_MODULE;
+const pluginName = process.env.BSB_TEST_PLUGIN_NAME || "unknown-plugin";
+const pluginConfigRaw = process.env.BSB_TEST_PLUGIN_CONFIG || "null";
+if (!pluginModule) {
+    throw new Error("BSB_TEST_PLUGIN_MODULE is required");
+}
+const resolvedModule = path_1.default.resolve(pluginModule);
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const mod = require(resolvedModule);
+const PluginCtor = mod.Plugin || mod.default || mod;
+const config = JSON.parse(pluginConfigRaw);
+describe(`observable: ${pluginName}`, () => {
+    (0, index_1.RunObservablePluginTests)(PluginCtor, config);
+});
+//# sourceMappingURL=plugin-observable.js.map

package/lib/runner/plugin-observable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-observable.js","sourceRoot":"","sources":["../../src/runner/plugin-observable.ts"],"names":[],"mappings":";;;;;AAAA,gDAAwB;AACxB,0DAA0E;AAE1E,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;AACxD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,gBAAgB,CAAC;AACxE,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,MAAM,CAAC;AAErE,IAAI,CAAC,YAAY,EAAE,CAAC;IAClB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,cAAc,GAAG,cAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAClD,8DAA8D;AAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AACpC,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;AAEpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;AAE3C,QAAQ,CAAC,eAAe,UAAU,EAAE,EAAE,GAAG,EAAE;IACzC,IAAA,gCAAwB,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC"}

package/lib/runner/setup.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/runner/setup.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const module_1 = __importDefault(require("module"));
+const localBaseEntry = process.env.BSB_TEST_LOCAL_BASE_ENTRY;
+if (localBaseEntry) {
+    const resolved = path_1.default.resolve(localBaseEntry);
+    const originalResolve = module_1.default._resolveFilename;
+    module_1.default._resolveFilename = function (request, parent, isMain, options) {
+        if (request === "@bsb/base") {
+            return resolved;
+        }
+        return originalResolve.call(this, request, parent, isMain, options);
+    };
+}
+//# sourceMappingURL=setup.js.map

package/lib/runner/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/runner/setup.ts"],"names":[],"mappings":";;;;;AAAA,gDAAwB;AACxB,oDAA4B;AAE5B,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;AAE7D,IAAI,cAAc,EAAE,CAAC;IACnB,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9C,MAAM,eAAe,GAAI,gBAAc,CAAC,gBAK7B,CAAC;IAEX,gBAAc,CAAC,gBAAgB,GAAG,UACjC,OAAe,EACf,MAA8B,EAC9B,MAAe,EACf,OAAa;QAEb,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC,CAAC;AACJ,CAAC"}

package/lib/sb/plugins/events/broadcast.d.ts

@@ -0,0 +1,30 @@
+/**
+ * BSB (Better-Service-Base) is an event-bus based microservice framework.
+ * Copyright (C) 2016 - 2025 BetterCorp (PTY) Ltd
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alternatively, you may obtain a commercial license for this program.
+ * The commercial license allows you to use the Program in a closed-source manner,
+ * including the right to create derivative works that are not subject to the terms
+ * of the AGPL.
+ *
+ * To obtain a commercial license, please contact the copyright holders at
+ * https://www.bettercorp.dev. The terms and conditions of the commercial license
+ * will be provided upon request.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { BSBEvents } from "@bsb/base";
+export declare function broadcast(genNewPlugin: {
+    (): Promise<BSBEvents>;
+}, maxTimeoutToExpectAResponse: number): void;

package/lib/sb/plugins/events/broadcast.js

@@ -0,0 +1,390 @@
+"use strict";
+/**
+ * BSB (Better-Service-Base) is an event-bus based microservice framework.
+ * Copyright (C) 2016 - 2025 BetterCorp (PTY) Ltd
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alternatively, you may obtain a commercial license for this program.
+ * The commercial license allows you to use the Program in a closed-source manner,
+ * including the right to create derivative works that are not subject to the terms
+ * of the AGPL.
+ *
+ * To obtain a commercial license, please contact the copyright holders at
+ * https://www.bettercorp.dev. The terms and conditions of the commercial license
+ * will be provided upon request.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.broadcast = broadcast;
+const assert = __importStar(require("assert"));
+const crypto_1 = require("crypto");
+const base_1 = require("@bsb/base");
+const trace_1 = require("../../../trace");
+const randomName = () => (0, crypto_1.randomUUID)();
+function broadcast(genNewPlugin, maxTimeoutToExpectAResponse) {
+    let emitter;
+    beforeEach(async () => {
+        emitter = await genNewPlugin();
+    });
+    afterEach(function () {
+        (0, base_1.SmartFunctionCallSync)(emitter, emitter.dispose);
+    });
+    describe("EmitBroadcast", async function () {
+        this.timeout(maxTimeoutToExpectAResponse + 100);
+        describe("emitBroadcast", async () => {
+            const emitData = true;
+            it("all plugins should receive the event", async () => {
+                const thisPlugin = randomName();
+                const thisEvent = randomName();
+                const obs = (0, trace_1.createTestObservable)();
+                let receiveCounter = 0;
+                setTimeout(() => {
+                    if (receiveCounter === 2) {
+                        return assert.ok(receiveCounter);
+                    }
+                    if (receiveCounter === 0) {
+                        return assert.fail("Event not received");
+                    }
+                    assert.fail("Received " + receiveCounter + " events");
+                }, maxTimeoutToExpectAResponse);
+                await emitter.onBroadcast(obs, thisPlugin, thisEvent, async (receivedObs, args) => {
+                    assert.strictEqual(receivedObs.traceId, obs.traceId);
+                    receiveCounter++;
+                });
+                await emitter.onBroadcast(obs, thisPlugin, thisEvent, async (receivedObs, args) => {
+                    assert.strictEqual(receivedObs.traceId, obs.traceId);
+                    receiveCounter++;
+                });
+                await emitter.emitBroadcast(obs, thisPlugin, thisEvent, [emitData]);
+                await new Promise(resolve => setTimeout(resolve, 10));
+            });
+            it("diff plugin names should not receive same event", async () => {
+                const thisPlugin = randomName();
+                const thisPlugin2 = randomName();
+                const thisEvent = randomName();
+                const obs = (0, trace_1.createTestObservable)();
+                let receiveCounter = 0;
+                setTimeout(() => {
+                    if (receiveCounter === 2) {
+                        return assert.ok(receiveCounter);
+                    }
+                    if (receiveCounter === 0) {
+                        return assert.fail("Event not received");
+                    }
+                    assert.fail("Received " + receiveCounter + " events");
+                }, maxTimeoutToExpectAResponse);
+                await emitter.onBroadcast(obs, thisPlugin, thisEvent, async () => {
+                    assert.fail("Received on diff plugin name");
+                });
+                await emitter.onBroadcast(obs, thisPlugin2, thisEvent, async (receivedObs, args) => {
+                    assert.strictEqual(receivedObs.traceId, obs.traceId);
+                    receiveCounter++;
+                });
+                await emitter.onBroadcast(obs, thisPlugin2, thisEvent, async (receivedObs, args) => {
+                    assert.strictEqual(receivedObs.traceId, obs.traceId);
+                    receiveCounter++;
+                });
+                await emitter.emitBroadcast(obs, thisPlugin2, thisEvent, [emitData]);
+                await new Promise(resolve => setTimeout(resolve, 10));
+            });
+            it("should be able to emit to events with plugin name defined", async () => {
+                const thisPlugin = randomName();
+                const thisEvent = randomName();
+                const obs = (0, trace_1.createTestObservable)();
+                const emitTimeout = setTimeout(() => {
+                    assert.fail("Event not received");
+                }, maxTimeoutToExpectAResponse);
+                await emitter.onBroadcast(obs, thisPlugin, thisEvent, async (receivedObs, data) => {
+                    clearTimeout(emitTimeout);
+                    assert.strictEqual(receivedObs.traceId, obs.traceId);
+                    assert.ok(data[0]);
+                });
+                await emitter.emitBroadcast(obs, thisPlugin, thisEvent, [emitData]);
+                await new Promise(resolve => setTimeout(resolve, 10));
+            });
+            it("should be able to emit to events with self", async () => {
+                const thisCaller = randomName();
+                const thisEvent = randomName();
+                const obs = (0, trace_1.createTestObservable)();
+                const emitTimeout = setTimeout(() => {
+                    assert.fail("Event not received");
+                }, maxTimeoutToExpectAResponse);
+                await emitter.onBroadcast(obs, thisCaller, thisEvent, async (receivedObs, data) => {
+                    clearTimeout(emitTimeout);
+                    assert.strictEqual(receivedObs.traceId, obs.traceId);
+                    assert.ok(data[0]);
+                });
+                await emitter.emitBroadcast(obs, thisCaller, thisEvent, [emitData]);
+                await new Promise(resolve => setTimeout(resolve, 10));
+            });
+            it("should be able to emit to events with self multi-args", async () => {
+                const thisCaller = randomName();
+                const thisEvent = randomName();
+                const obs = (0, trace_1.createTestObservable)();
+                const emitTimeout = setTimeout(() => {
+                    assert.fail("Event not received");
+                }, maxTimeoutToExpectAResponse);
+                await emitter.onBroadcast(obs, thisCaller, thisEvent, async (receivedObs, data) => {
+                    clearTimeout(emitTimeout);
+                    assert.strictEqual(receivedObs.traceId, obs.traceId);
+                    assert.deepEqual(data[0], 0);
+                    assert.deepEqual(data[1], 1);
+                    assert.deepEqual(data[2], 2);
+                    assert.deepEqual(data[3], 3);
+                });
+                await emitter.emitBroadcast(obs, thisCaller, thisEvent, [0, 1, 2, 3]);
+                await new Promise(resolve => setTimeout(resolve, 10));
+            });
+            it("should not be able to emit to other events with plugin name defined", async () => {
+                const thisPlugin = randomName();
+                const thisEvent = randomName();
+                const thisEvent2 = randomName();
+                const obs = (0, trace_1.createTestObservable)();
+                const emitTimeout = setTimeout(() => {
+                    assert.ok(true);
+                }, maxTimeoutToExpectAResponse);
+                await emitter.onBroadcast(obs, thisPlugin, thisEvent, async () => {
+                    clearTimeout(emitTimeout);
+                    assert.fail("Event received");
+                });
+                await emitter.emitBroadcast(obs, thisPlugin, thisEvent2, [emitData]);
+                await new Promise(resolve => setTimeout(resolve, 10));
+            });
+            it("should not be able to emit to other events with self", async () => {
+                const thisCaller = randomName();
+                const thisEvent = randomName();
+                const thisEvent2 = randomName();
+                const obs = (0, trace_1.createTestObservable)();
+                const emitTimeout = setTimeout(() => {
+                    assert.ok(true);
+                }, maxTimeoutToExpectAResponse);
+                await emitter.onBroadcast(obs, thisCaller, thisEvent, async () => {
+                    clearTimeout(emitTimeout);
+                    assert.fail("Event received");
+                });
+                await emitter.emitBroadcast(obs, thisCaller, thisEvent2, [emitData]);
+                await new Promise(resolve => setTimeout(resolve, 10));
+            });
+        });
+        describe("onBroadcast", async () => {
+            const emitData = "ABCD";
+            it("should be able to emit to events with plugin name defined", async () => {
+                const thisPlugin = randomName();
+                const thisEvent = randomName();
+                const obs = (0, trace_1.createTestObservable)();
+                const emitTimeout = setTimeout(() => {
+                    assert.fail("Event not received");
+                }, maxTimeoutToExpectAResponse);
+                await emitter.onBroadcast(obs, thisPlugin, thisEvent, async (receivedObs, data) => {
+                    clearTimeout(emitTimeout);
+                    assert.strictEqual(receivedObs.traceId, obs.traceId);
+                    assert.deepEqual(data[0], emitData);
+                });
+                await emitter.emitBroadcast(obs, thisPlugin, thisEvent, [emitData]);
+                await new Promise(resolve => setTimeout(resolve, 10));
+            });
+            it("should be able to emit to events with self", async () => {
+                const thisCaller = randomName();
+                const thisEvent = randomName();
+                const obs = (0, trace_1.createTestObservable)();
+                const emitTimeout = setTimeout(() => {
+                    assert.fail("Event not received");
+                }, maxTimeoutToExpectAResponse);
+                await emitter.onBroadcast(obs, thisCaller, thisEvent, async (receivedObs, data) => {
+                    clearTimeout(emitTimeout);
+                    assert.strictEqual(receivedObs.traceId, obs.traceId);
+                    assert.deepEqual(data[0], emitData);
+                });
+                await emitter.emitBroadcast(obs, thisCaller, thisEvent, [emitData]);
+                await new Promise(resolve => setTimeout(resolve, 10));
+            });
+            it("should not be able to emit to other events with plugin name defined", async () => {
+                const thisPlugin = randomName();
+                const thisEvent = randomName();
+                const thisEvent2 = randomName();
+                const obs = (0, trace_1.createTestObservable)();
+                const emitTimeout = setTimeout(() => {
+                    assert.ok(true);
+                }, maxTimeoutToExpectAResponse);
+                await emitter.onBroadcast(obs, thisPlugin, thisEvent, async () => {
+                    clearTimeout(emitTimeout);
+                    assert.fail("Event received");
+                });
+                await emitter.emitBroadcast(obs, thisPlugin, thisEvent2, [emitData]);
+                await new Promise(resolve => setTimeout(resolve, 10));
+            });
+            it("should not be able to emit to other events with self", async () => {
+                const thisCaller = randomName();
+                const thisEvent = randomName();
+                const thisEvent2 = randomName();
+                const obs = (0, trace_1.createTestObservable)();
+                const emitTimeout = setTimeout(() => {
+                    assert.ok(true);
+                }, maxTimeoutToExpectAResponse);
+                await emitter.onBroadcast(obs, thisCaller, thisEvent, async () => {
+                    clearTimeout(emitTimeout);
+                    assert.fail("Event received");
+                });
+                await emitter.emitBroadcast(obs, thisCaller, thisEvent2, [emitData]);
+                await new Promise(resolve => setTimeout(resolve, 10));
+            });
+        });
+        const typesToTest = [
+            {
+                name: "Null",
+                data: null,
+            },
+            {
+                name: "Boolean true",
+                data: true,
+            },
+            {
+                name: "Boolean false",
+                data: false,
+            },
+            {
+                name: "String",
+                data: "HELLO WO4lD",
+            },
+            {
+                name: "Min Number",
+                data: Number.MIN_SAFE_INTEGER,
+            },
+            {
+                name: "Max Number",
+                data: Number.MAX_SAFE_INTEGER,
+            },
+            {
+                name: "Array",
+                data: [
+                    0,
+                    "Hello",
+                    true,
+                ],
+            },
+            {
+                name: "Object",
+                data: {
+                    name: "Sarah",
+                    surname: "Blond",
+                    age: 24,
+                    meta: {
+                        location: [
+                            -12212,
+                            55336,
+                        ],
+                    },
+                },
+            },
+        ];
+        for (const typeToTest of typesToTest) {
+            describe(`emitBroadcast ${typeToTest.name}`, async () => {
+                it("should be able to emit to events with plugin name defined", async () => {
+                    const thisPlugin = randomName();
+                    const thisEvent = randomName();
+                    const obs = (0, trace_1.createTestObservable)();
+                    const emitTimeout = setTimeout(() => {
+                        assert.fail("Event not received");
+                    }, maxTimeoutToExpectAResponse);
+                    await emitter.onBroadcast(obs, thisPlugin, thisEvent, async (receivedObs, data) => {
+                        clearTimeout(emitTimeout);
+                        assert.strictEqual(receivedObs.traceId, obs.traceId);
+                        assert.deepEqual(data[0], typeToTest.data);
+                    });
+                    await emitter.emitBroadcast(obs, thisPlugin, thisEvent, [typeToTest.data]);
+                    await new Promise(resolve => setTimeout(resolve, 10));
+                });
+                it("should be able to emit to events with self", async () => {
+                    const thisCaller = randomName();
+                    const thisEvent = randomName();
+                    const obs = (0, trace_1.createTestObservable)();
+                    const emitTimeout = setTimeout(() => {
+                        assert.fail("Event not received");
+                    }, maxTimeoutToExpectAResponse);
+                    await emitter.onBroadcast(obs, thisCaller, thisEvent, async (receivedObs, data) => {
+                        clearTimeout(emitTimeout);
+                        assert.strictEqual(receivedObs.traceId, obs.traceId);
+                        assert.deepEqual(data[0], typeToTest.data);
+                    });
+                    await emitter.emitBroadcast(obs, thisCaller, thisEvent, [typeToTest.data]);
+                    await new Promise(resolve => setTimeout(resolve, 10));
+                });
+                it("should not be able to emit to other events with plugin name defined", async () => {
+                    const thisPlugin = randomName();
+                    const thisEvent = randomName();
+                    const thisEvent2 = randomName();
+                    const obs = (0, trace_1.createTestObservable)();
+                    const emitTimeout = setTimeout(() => {
+                        assert.ok(true);
+                    }, maxTimeoutToExpectAResponse);
+                    await emitter.onBroadcast(obs, thisPlugin, thisEvent, async () => {
+                        clearTimeout(emitTimeout);
+                        assert.fail("Event received");
+                    });
+                    await emitter.emitBroadcast(obs, thisPlugin, thisEvent2, [typeToTest.data]);
+                    await new Promise(resolve => setTimeout(resolve, 10));
+                });
+                it("should not be able to emit to other events with self", async () => {
+                    const thisCaller = randomName();
+                    const thisEvent = randomName();
+                    const thisEvent2 = randomName();
+                    const obs = (0, trace_1.createTestObservable)();
+                    const emitTimeout = setTimeout(() => {
+                        assert.ok(true);
+                    }, maxTimeoutToExpectAResponse);
+                    await emitter.onBroadcast(obs, thisCaller, thisEvent, async () => {
+                        clearTimeout(emitTimeout);
+                        assert.fail("Event received");
+                    });
+                    await emitter.emitBroadcast(obs, thisCaller, thisEvent2, [typeToTest.data]);
+                    await new Promise(resolve => setTimeout(resolve, 10));
+                });
+            });
+        }
+    });
+}
+//# sourceMappingURL=broadcast.js.map