@vida-global/core 2.4.1 → 2.4.2

package/lib/appDependencies/index.js

@@ -12,6 +12,7 @@ class AppDependencies {
     setDependency(name, dependency) {
         this.#dependencies[name] = dependency;
         this.#defineAccessor(name);
+        this.#defineSingletonAccessor(name);
     }
 
 
@@ -26,6 +27,17 @@ class AppDependencies {
     }
 
 
+    #defineSingletonAccessor(name) {
+        if (Object.getOwnPropertyDescriptor(this, name)) return;
+        if (name in this) return;
+
+        Object.defineProperty(this, name, {
+            configurable: false,
+            get: () => this.get(name)
+        });
+    }
+
+
     // Registering after `installOn` still defines the accessor, so wiring order does not matter.
     // An existing property is left alone: a controller that defines the name itself wins.
     #defineAccessor(name) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vida-global/core",
-    "version": "2.4.1",
+    "version": "2.4.2",
     "description": "Core libraries for supporting Vida development",
     "author": "",
     "license": "ISC",

package/test/appDependencies/appDependencies.test.js

@@ -46,6 +46,44 @@ describe('AppDependencies', () => {
     });
 
 
+    describe('singleton accessors', () => {
+        it ('exposes a registered name as a property on the singleton', () => {
+            const helper = { name: 'helper' };
+
+            AppDependencies.setDependency('singletonHelper', helper);
+
+            expect(AppDependencies.singletonHelper).toBe(helper);
+        });
+
+
+        it ('reads through, so a later replacement is picked up', () => {
+            AppDependencies.setDependency('replacedHelper', 'first');
+
+            AppDependencies.setDependency('replacedHelper', 'second');
+
+            expect(AppDependencies.replacedHelper).toBe('second');
+        });
+
+
+        it ('reads null after a reset', () => {
+            AppDependencies.setDependency('resetHelper', 'something');
+
+            AppDependencies.reset();
+
+            expect(AppDependencies.resetHelper).toBeNull();
+        });
+
+
+        // `get`, `reset`, and friends must survive a hostile dependency name.
+        it ('does not overwrite the singleton API', () => {
+            AppDependencies.setDependency('get', 'not a function');
+
+            expect(typeof AppDependencies.get).toBe('function');
+            expect(AppDependencies.get('get')).toBe('not a function');
+        });
+    });
+
+
     describe('#installOn', () => {
         it ('exposes what was registered before the install as a getter', () => {
             AppDependencies.setDependency('myHelper', 'early');