@bsb/tests 0.0.1

package/lib/trace.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 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 { DTrace, Observable } from "@bsb/base";
+/**
+ * @hidden
+ */
+export declare function createFakeDTrace(trace?: string, span?: string): DTrace;
+/**
+ * Create a test Observable with minimal setup for testing
+ * @param trace - Optional trace ID (default: 'test-trace')
+ * @param span - Optional span ID (default: 'test-span')
+ * @param pluginName - Optional plugin name (default: 'test-plugin')
+ * @returns Observable for testing
+ * @hidden
+ */
+export declare function createTestObservable(trace?: string, span?: string, pluginName?: string): Observable;

package/lib/trace.js

@@ -0,0 +1,85 @@
+"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/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFakeDTrace = createFakeDTrace;
+exports.createTestObservable = createTestObservable;
+const base_1 = require("@bsb/base");
+/**
+ * @hidden
+ */
+function createFakeDTrace(trace, span) {
+    return {
+        t: trace ?? '',
+        s: span ?? '',
+    };
+}
+/**
+ * Create a test Observable with minimal setup for testing
+ * @param trace - Optional trace ID (default: 'test-trace')
+ * @param span - Optional span ID (default: 'test-span')
+ * @param pluginName - Optional plugin name (default: 'test-plugin')
+ * @returns Observable for testing
+ * @hidden
+ */
+function createTestObservable(trace, span, pluginName = 'test-plugin') {
+    const dTrace = createFakeDTrace(trace ?? 'test-trace', span ?? 'test-span');
+    // Create minimal resource context
+    const resource = {
+        'service.name': pluginName,
+        'service.version': '1.0.0-test',
+        'service.instance.id': 'test-instance',
+        'deployment.environment': 'test',
+    };
+    // Create stub unified backend - will be replaced by mocks in tests
+    const backend = {
+        // Logging methods
+        debug: () => { },
+        info: () => { },
+        warn: () => { },
+        error: () => { },
+        // Metrics methods
+        createCounter: () => ({ increment: () => { } }),
+        createGauge: () => ({ set: () => { }, increment: () => { }, decrement: () => { } }),
+        createHistogram: () => ({ record: () => { } }),
+        createTimer: () => ({ stop: () => 0 }),
+        createTrace: (name, attrs) => ({
+            id: 'test-trace-id',
+            trace: createFakeDTrace('test-trace', 'test-span'),
+            error: () => { },
+            end: () => { }
+        }),
+        createSpan: (parentTrace, name, attrs) => ({
+            id: 'child-span-' + name,
+            trace: createFakeDTrace(parentTrace.t, 'child-span-' + name), // Preserve parent trace ID
+            error: () => { },
+            end: () => { }
+        }),
+    };
+    return new base_1.PluginObservable(dTrace, resource, backend, {});
+}
+//# sourceMappingURL=trace.js.map

package/lib/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;AAOH,4CAKC;AAUD,oDA+CC;AAnED,oCAAqG;AAErG;;GAEG;AACH,SAAgB,gBAAgB,CAAC,KAAc,EAAE,IAAa;IAC5D,OAAO;QACL,CAAC,EAAE,KAAK,IAAI,EAAE;QACd,CAAC,EAAE,IAAI,IAAI,EAAE;KACd,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,oBAAoB,CAClC,KAAc,EACd,IAAa,EACb,aAAqB,aAAa;IAElC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,IAAI,YAAY,EAAE,IAAI,IAAI,WAAW,CAAC,CAAC;IAE5E,kCAAkC;IAClC,MAAM,QAAQ,GAAoB;QAChC,cAAc,EAAE,UAAU;QAC1B,iBAAiB,EAAE,YAAY;QAC/B,qBAAqB,EAAE,eAAe;QACtC,wBAAwB,EAAE,MAAM;KACjC,CAAC;IAEF,mEAAmE;IACnE,MAAM,OAAO,GAAsB;QACjC,kBAAkB;QAClB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;QACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;QACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;QACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;QACf,kBAAkB;QAClB,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;QAC9C,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;QAChF,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;QAC7C,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;QACtC,WAAW,EAAE,CAAC,IAAY,EAAE,KAAW,EAAE,EAAE,CAAC,CAAC;YAC3C,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,gBAAgB,CAAC,YAAY,EAAE,WAAW,CAAC;YAClD,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;YACf,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;SACd,CAAC;QACF,UAAU,EAAE,CAAC,WAAmB,EAAE,IAAY,EAAE,KAAW,EAAE,EAAE,CAAC,CAAC;YAC/D,EAAE,EAAE,aAAa,GAAG,IAAI;YACxB,KAAK,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC,EAAE,2BAA2B;YACzF,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;YACf,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;SACd,CAAC;KACI,CAAC;IAET,OAAO,IAAI,uBAAgB,CACzB,MAAM,EACN,QAAQ,EACR,OAAO,EACP,EAAE,CACH,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@bsb/tests",
+  "version": "0.0.1",
+  "description": "Shared test suites for BSB Node.js core and plugins",
+  "license": "(AGPL-3.0-only OR Commercial)",
+  "author": {
+    "name": "BetterCorp (PTY) Ltd",
+    "email": "ninja@bettercorp.dev",
+    "url": "https://bettercorp.dev/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BetterCorp/better-service-base.git",
+    "directory": "tests/nodejs"
+  },
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "bin/**/*",
+    "lib/**/*",
+    "README.md",
+    "docs/**/*"
+  ],
+  "scripts": {
+    "clean": "rimraf lib",
+    "build": "tsc -p tsconfig.json",
+    "test": "mocha --config .mocharc.cjs",
+    "cli": "node ./bin/bsb-tests.cjs"
+  },
+  "dependencies": {
+    "@bsb/base": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/mocha": "^10.0.6",
+    "@types/node": "^25.0.0",
+    "mocha": "^12.0.0-beta-9.6",
+    "rimraf": "^6.1.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=23.0.0",
+    "npm": ">=11.0.0"
+  },
+  "bin": {
+    "bsb-tests": "bin/bsb-tests.cjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}