@common-stack/client-core 8.4.1-alpha.0 → 8.6.1-alpha.0

package/lib/connector/ScopedContainer.d.ts

@@ -1,14 +1,12 @@
 import { Container, interfaces } from 'inversify';
 export type RegisterScopedDependenciesAction = (container: Container) => void;
 export declare class ScopedContainer {
-    private static _dependencyRegistrations;
-    private static _globalContainer;
-    private static readonly _containerInstances;
     /**
      * Options object to use when creating a new container for a
      * scope ID.
      */
-    static scopedContainerOptions: interfaces.ContainerOptions;
+    static get scopedContainerOptions(): interfaces.ContainerOptions;
+    static set scopedContainerOptions(value: interfaces.ContainerOptions);
     /**
      * A function to register global dependencies.
      * This creates a global container instance, which enables truly

package/lib/connector/ScopedContainer.js

@@ -1,14 +1,54 @@
 import {Container}from'inversify';/* eslint-disable no-underscore-dangle */
 const DEFAULT_SCOPE_ID = '__default__';
+/**
+ * Shared state backed by globalThis.
+ *
+ * Bundlers like Vite can create separate module instances when the same class is imported
+ * via both a barrel export (`@common-stack/client-core`) and a deep path
+ * (`@common-stack/client-core/lib/connector/ScopedContainer.js`). Each module copy gets
+ * its own static class properties, so `registerGlobalDependencies()` writes to one
+ * instance while `ScopedContainer.for()` reads from another — causing
+ * "No matching bindings found for serviceIdentifier: Symbol(Logger)" errors.
+ *
+ * To protect against this, all mutable state is stored on globalThis so every copy
+ * of ScopedContainer (regardless of how many module instances the bundler creates)
+ * shares the same containers, registrations, and global parent.
+ *
+ * IMPORTANT: Always import ScopedContainer from the barrel '@common-stack/client-core',
+ * never from '@common-stack/client-core/lib/connector/ScopedContainer.js'.
+ * See: https://vitejs.dev/guide/dep-pre-bundling#monorepos-and-linked-dependencies
+ */
+const globalRef = (typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : global);
+const GLOBAL_KEY = '__SCOPED_CONTAINER_STATE__';
+// Initialize shared state once; all subsequent module loads reuse it.
+if (!globalRef[GLOBAL_KEY]) {
+    globalRef[GLOBAL_KEY] = {
+        dependencyRegistrations: [],
+        globalContainer: null,
+        containerInstances: {},
+        scopedContainerOptions: undefined,
+    };
+}
+else {
+    console.warn('[ScopedContainer] ⚠️  Duplicate ScopedContainer module detected! ' +
+        'This usually means ScopedContainer is imported via both a barrel export and a deep path. ' +
+        "Always import from '@common-stack/client-core', never from " +
+        "'@common-stack/client-core/lib/connector/ScopedContainer.js'. " +
+        'State is shared via globalThis so the app will still work, but please fix the import.');
+}
+// Convenience accessor — all static methods read/write through this.
+const sharedState = globalRef[GLOBAL_KEY];
 class ScopedContainer {
-    static _dependencyRegistrations = [];
-    static _globalContainer;
-    static _containerInstances = {};
     /**
      * Options object to use when creating a new container for a
      * scope ID.
      */
-    static scopedContainerOptions;
+    static get scopedContainerOptions() {
+        return sharedState.scopedContainerOptions;
+    }
+    static set scopedContainerOptions(value) {
+        sharedState.scopedContainerOptions = value;
+    }
     /**
      * A function to register global dependencies.
      * This creates a global container instance, which enables truly
@@ -24,13 +64,13 @@ class ScopedContainer {
      * })();
      */
     static registerGlobalDependencies(fn) {
-        if (!this._globalContainer) {
-            this._globalContainer = new Container(this.scopedContainerOptions);
-            fn(this._globalContainer);
-        }
-        else {
-            throw new Error('Global dependencies have already been registered');
+        if (!sharedState.globalContainer) {
+            sharedState.globalContainer = new Container(sharedState.scopedContainerOptions);
+            fn(sharedState.globalContainer);
         }
+        // Note: If global container already exists, we silently skip.
+        // This prevents hydration mismatches when the client re-executes
+        // module code that calls registerGlobalDependencies during SSR/hydration.
     }
     /**
      * Returns a @see Container that is unique to the specified scope.
@@ -41,10 +81,10 @@ class ScopedContainer {
      * @returns A @see Container that is unique to the specified scope.
      */
     static for(scopeId = DEFAULT_SCOPE_ID) {
-        let container = this._containerInstances[scopeId];
+        let container = sharedState.containerInstances[scopeId];
         if (!container) {
             container = this.makeNewContainer();
-            this._containerInstances[scopeId] = container;
+            sharedState.containerInstances[scopeId] = container;
         }
         return container;
     }
@@ -54,7 +94,7 @@ class ScopedContainer {
      * @returns True if a container exists for the specified scope, false otherwise.
      */
     static isExist(scopeId = DEFAULT_SCOPE_ID) {
-        return !!this._containerInstances[scopeId];
+        return !!sharedState.containerInstances[scopeId];
     }
     /**
      * Unbinds the @see Container (i.e. container.unbindAll()) and removes
@@ -62,17 +102,17 @@ class ScopedContainer {
      * @param scopeId
      */
     static remove(scopeId = DEFAULT_SCOPE_ID) {
-        const container = this._containerInstances[scopeId];
+        const container = sharedState.containerInstances[scopeId];
         if (!container)
             return;
         container.unbindAll();
-        delete this._containerInstances[scopeId];
+        delete sharedState.containerInstances[scopeId];
     }
     /**
      * Runs the @method remove method on all instances.
      */
     static removeAll() {
-        Object.keys(this._containerInstances).forEach((key) => this.remove(key));
+        Object.keys(sharedState.containerInstances).forEach((key) => this.remove(key));
     }
     /**
      * Registers dependencies that should be tied to a scope,
@@ -93,20 +133,20 @@ class ScopedContainer {
      * })();
      */
     static registerScopedDependencies(fn) {
-        this._dependencyRegistrations.push(fn);
+        sharedState.dependencyRegistrations.push(fn);
         return this;
     }
     static makeNewContainer() {
-        const container = this.ensureGlobalContainer().createChild(this.scopedContainerOptions);
-        this._dependencyRegistrations.forEach((action) => action(container));
+        const container = this.ensureGlobalContainer().createChild(sharedState.scopedContainerOptions);
+        sharedState.dependencyRegistrations.forEach((action) => action(container));
         return container;
     }
     static ensureGlobalContainer() {
-        if (!this._globalContainer) {
-            const container = new Container(this.scopedContainerOptions);
-            this._globalContainer = container;
-            this._dependencyRegistrations.forEach((action) => action(container));
+        if (!sharedState.globalContainer) {
+            const container = new Container(sharedState.scopedContainerOptions);
+            sharedState.globalContainer = container;
+            sharedState.dependencyRegistrations.forEach((action) => action(container));
         }
-        return this._globalContainer;
+        return sharedState.globalContainer;
     }
 }export{ScopedContainer};//# sourceMappingURL=ScopedContainer.js.map

package/lib/connector/ScopedContainer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScopedContainer.js","sources":["../../src/connector/ScopedContainer.ts"],"sourcesContent":[null],"names":[],"mappings":"kCAAA;AAGA,MAAM,gBAAgB,GAAG,aAAa,CAAC;MAQ1B,eAAe,CAAA;AAChB,IAAA,OAAO,wBAAwB,GAAuC,EAAE,CAAC;IAEzE,OAAO,gBAAgB,CAAY;AAEnC,IAAA,OAAgB,mBAAmB,GAAyB,EAAE,CAAC;AAEvE;;;AAGG;IACH,OAAO,sBAAsB,CAA8B;AAE3D;;;;;;;;;;;;;AAaG;IACH,OAAO,0BAA0B,CAAC,EAAoC,EAAA;AAClE,QAAA,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YACxB,IAAI,CAAC,gBAAgB,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;AACnE,YAAA,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;SAC7B;aAAM;AACH,YAAA,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;SACvE;KACJ;AAED;;;;;;;AAOG;AACH,IAAA,OAAO,GAAG,CAAC,OAAO,GAAG,gBAAgB,EAAA;QACjC,IAAI,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS,EAAE;AACZ,YAAA,SAAS,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;AACpC,YAAA,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;SACjD;AACD,QAAA,OAAO,SAAS,CAAC;KACpB;AAED;;;;AAIG;AACH,IAAA,OAAO,OAAO,CAAC,OAAO,GAAG,gBAAgB,EAAA;QACrC,OAAO,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;KAC9C;AAED;;;;AAIG;AACH,IAAA,OAAO,MAAM,CAAC,OAAO,GAAG,gBAAgB,EAAA;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACpD,QAAA,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,SAAS,CAAC,SAAS,EAAE,CAAC;AACtB,QAAA,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;KAC5C;AAED;;AAEG;AACH,IAAA,OAAO,SAAS,GAAA;QACZ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;KAC5E;AAED;;;;;;;;;;;;;;;;;AAiBG;IACH,OAAO,0BAA0B,CAAC,EAAoC,EAAA;AAClE,QAAA,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACvC,QAAA,OAAO,IAAI,CAAC;KACf;AAEO,IAAA,OAAO,gBAAgB,GAAA;AAC3B,QAAA,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;AACxF,QAAA,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AACrE,QAAA,OAAO,SAAS,CAAC;KACpB;AAEO,IAAA,OAAO,qBAAqB,GAAA;AAChC,QAAA,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YACxB,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;AAC7D,YAAA,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;AAClC,YAAA,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;SACxE;QACD,OAAO,IAAI,CAAC,gBAAgB,CAAC;KAChC;"}
+{"version":3,"file":"ScopedContainer.js","sources":["../../src/connector/ScopedContainer.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/lib/helpers/attachDeprecatedLogger.d.ts

@@ -0,0 +1,27 @@
+import type { CdmLogger } from '@cdm-logger/core';
+import type { Container } from 'inversify';
+/**
+ * Attaches a **non-enumerable, lazy** `logger` getter to the given context object.
+ *
+ * Why non-enumerable?
+ * - `JSON.stringify()` skips non-enumerable properties → no serialization into HTML
+ * - Spread / `Object.keys()` won't copy it → no accidental inclusion in hydration payload
+ * - React won't see it when diffing props → no hydration mismatch
+ *
+ * The getter resolves the logger from the Inversify container on first access,
+ * prints a one-time deprecation warning, and returns the logger instance.
+ *
+ * @example
+ * ```ts
+ * const context = { container, apolloClient };
+ * attachDeprecatedLogger(context, container);
+ * // Old code still works:
+ * context.logger.info('hello'); // ⚠️ prints deprecation warning once
+ * ```
+ *
+ * @param target   – The context object to augment (mutated in place).
+ * @param container – The Inversify container that has `ClientTypes.Logger` bound.
+ */
+export declare function attachDeprecatedLogger<T extends object>(target: T, container: Container): T & {
+    logger?: CdmLogger.ILogger;
+};

package/lib/helpers/attachDeprecatedLogger.js

@@ -0,0 +1,48 @@
+import {ClientTypes}from'@common-stack/core';let _warnedOnce = false;
+/**
+ * Attaches a **non-enumerable, lazy** `logger` getter to the given context object.
+ *
+ * Why non-enumerable?
+ * - `JSON.stringify()` skips non-enumerable properties → no serialization into HTML
+ * - Spread / `Object.keys()` won't copy it → no accidental inclusion in hydration payload
+ * - React won't see it when diffing props → no hydration mismatch
+ *
+ * The getter resolves the logger from the Inversify container on first access,
+ * prints a one-time deprecation warning, and returns the logger instance.
+ *
+ * @example
+ * ```ts
+ * const context = { container, apolloClient };
+ * attachDeprecatedLogger(context, container);
+ * // Old code still works:
+ * context.logger.info('hello'); // ⚠️ prints deprecation warning once
+ * ```
+ *
+ * @param target   – The context object to augment (mutated in place).
+ * @param container – The Inversify container that has `ClientTypes.Logger` bound.
+ */
+function attachDeprecatedLogger(target, container) {
+    let cachedLogger;
+    Object.defineProperty(target, 'logger', {
+        configurable: true,
+        enumerable: false, // ← invisible to JSON.stringify / Object.keys / spread
+        get() {
+            if (!_warnedOnce) {
+                _warnedOnce = true;
+                // eslint-disable-next-line no-console
+                console.warn('[DEPRECATED] Accessing "logger" from context/clientService is deprecated and will be ' +
+                    'removed in a future release. Use container.get(ClientTypes.Logger) instead.');
+            }
+            if (!cachedLogger) {
+                try {
+                    cachedLogger = container.get(ClientTypes.Logger);
+                }
+                catch {
+                    // Logger not yet bound – return undefined
+                }
+            }
+            return cachedLogger;
+        },
+    });
+    return target;
+}export{attachDeprecatedLogger};//# sourceMappingURL=attachDeprecatedLogger.js.map

package/lib/helpers/attachDeprecatedLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachDeprecatedLogger.js","sources":["../../src/helpers/attachDeprecatedLogger.ts"],"sourcesContent":[null],"names":[],"mappings":"6CAIA,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;AAqBG;AACa,SAAA,sBAAsB,CAClC,MAAS,EACT,SAAoB,EAAA;AAEpB,IAAA,IAAI,YAA2C,CAAC;AAEhD,IAAA,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE;AACpC,QAAA,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,KAAK;QACjB,GAAG,GAAA;YACC,IAAI,CAAC,WAAW,EAAE;gBACd,WAAW,GAAG,IAAI,CAAC;;gBAEnB,OAAO,CAAC,IAAI,CACR,uFAAuF;AACnF,oBAAA,6EAA6E,CACpF,CAAC;aACL;YACD,IAAI,CAAC,YAAY,EAAE;AACf,gBAAA,IAAI;oBACA,YAAY,GAAG,SAAS,CAAC,GAAG,CAAoB,WAAW,CAAC,MAAM,CAAC,CAAC;iBACvE;AAAC,gBAAA,MAAM;;iBAEP;aACJ;AACD,YAAA,OAAO,YAAY,CAAC;SACvB;AACJ,KAAA,CAAC,CAAC;AAEH,IAAA,OAAO,MAA4C,CAAC;AACxD"}

package/lib/helpers/index.d.ts

@@ -1 +1,2 @@
 export * from './apollo-client-test-helper';
+export * from './attachDeprecatedLogger';

package/lib/index.js

@@ -1 +1 @@
-export{logger}from'./logger/logger.js';export{AbstractFeature,featureCatalog}from'./connector/AbstractConnector.js';export{ScopedContainer}from'./connector/ScopedContainer.js';export{REDUX_PERSIST_KEY}from'./constants/constants.js';export{apolloClientHelper}from'./helpers/apollo-client-test-helper.js';export{StateMachineRegistry,stateMachineRegistry}from'./xstate/StateMachineRegistry.js';export{ClientTypes,ElectronTypes}from'@common-stack/core';//# sourceMappingURL=index.js.map
+export{logger}from'./logger/logger.js';export{AbstractFeature,featureCatalog}from'./connector/AbstractConnector.js';export{ScopedContainer}from'./connector/ScopedContainer.js';export{REDUX_PERSIST_KEY}from'./constants/constants.js';export{apolloClientHelper}from'./helpers/apollo-client-test-helper.js';export{attachDeprecatedLogger}from'./helpers/attachDeprecatedLogger.js';export{StateMachineRegistry,stateMachineRegistry}from'./xstate/StateMachineRegistry.js';export{ClientTypes,ElectronTypes}from'@common-stack/core';//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@common-stack/client-core",
-    "version": "8.4.1-alpha.0",
+    "version": "8.6.1-alpha.0",
     "description": "common core for higher packages to depend on",
     "license": "UNLICENSED",
     "author": "CDMBase LLC",
@@ -34,7 +34,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "gitHead": "ac86412a3e65f14ccbf8b3a6e46f9b82ed7299da",
+    "gitHead": "1e6e8a053e94e4f5c54d7364d73395127f8b843a",
     "typescript": {
         "definition": "lib/index.d.ts"
     }