dev(test): enable use of TestKernel in unit tests

src/backend/src/services/TestService.js

@@ -0,0 +1,12 @@
+const BaseService = require('./BaseService');
+
+/**
+ * TestService is a service for testing in the sense that it is a service
+ * that exists for the purpose of being testing or to be used for testing
+ * purposes. However, TestService is not a service that's meant to hold
+ * utility functions for testing.
+ */
+class TestService extends BaseService {
+}
+
+module.exports = { TestService };

src/backend/src/services/TestService.test.mts

@@ -0,0 +1,37 @@
+import { describe, expect, it } from 'vitest';
+import { TestKernel } from '../../tools/test.js';
+import { Core2Module } from '../modules/core/Core2Module.js';
+import { WebModule } from '../modules/web/WebModule.js';
+import { TestService } from './TestService.js';
+
+describe('testing with TestKernel', () => {
+    it('can load TestService within TestKernel', () => {
+        const testKernel = new TestKernel();
+        testKernel.add_module({
+            install: (context) => {
+                const services = context.get('services');
+                services.registerService('test', TestService);
+            },
+        });
+        
+        testKernel.boot();
+        
+        const svc_test = testKernel.services?.get('test');
+
+        expect(svc_test).toBeInstanceOf(TestService);
+    });
+    it('can load CoreModule within TestKernel', async () => {
+        const testKernel = new TestKernel();
+        testKernel.add_module(new Core2Module());
+        testKernel.add_module(new WebModule());
+        testKernel.boot();
+        
+        const { services } = testKernel;
+        await services.ready;
+        
+        const svc_webServer = services?.get('web-server');
+
+        expect(svc_webServer.constructor.name).toBe('WebServerService');
+    });
+});
+

src/backend/tools/test.mjs

@@ -264,4 +264,10 @@ const main = async () => {
     process.exit(total_failed ? 1 : 0);
 };
 
-main();
+if ( require.main === module ) {
+    main();
+}
+
+module.exports = {
+    TestKernel,
+};