@onecx/accelerator 5.52.10 → 5.53.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onecx/accelerator",
-  "version": "5.52.10",
+  "version": "5.53.1",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -8,7 +8,8 @@
   },
   "peerDependencies": {
     "tslib": "^2.6.3",
-    "rxjs": "^7.8.1"
+    "rxjs": "^7.8.1",
+    "@nx/module-federation": "20.4.0"
   },
   "type": "commonjs",
   "main": "./src/index.js",

package/src/index.d.ts

@@ -7,3 +7,5 @@ export * from './lib/utils/date.utils';
 export * from './lib/utils/is-test.utils';
 export * from './lib/utils/normalize-locales.utils';
 export * from './lib/utils/get-normalized-browser-locales.utils';
+export * from './lib/utils/ensure-property.utils';
+export * from './lib/utils/get-onecx-shared-recommendations';

package/src/index.js

@@ -10,4 +10,6 @@ tslib_1.__exportStar(require("./lib/utils/date.utils"), exports);
 tslib_1.__exportStar(require("./lib/utils/is-test.utils"), exports);
 tslib_1.__exportStar(require("./lib/utils/normalize-locales.utils"), exports);
 tslib_1.__exportStar(require("./lib/utils/get-normalized-browser-locales.utils"), exports);
+tslib_1.__exportStar(require("./lib/utils/ensure-property.utils"), exports);
+tslib_1.__exportStar(require("./lib/utils/get-onecx-shared-recommendations"), exports);
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/accelerator/src/index.ts"],"names":[],"mappings":";;;AAAA,4DAAiC;AACjC,mFAAwD;AACxD,qEAA0C;AAC1C,sEAA2C;AAC3C,iEAAsC;AACtC,iEAAsC;AACtC,oEAAyC;AACzC,8EAAmD;AACnD,2FAAgE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/accelerator/src/index.ts"],"names":[],"mappings":";;;AAAA,4DAAiC;AACjC,mFAAwD;AACxD,qEAA0C;AAC1C,sEAA2C;AAC3C,iEAAsC;AACtC,iEAAsC;AACtC,oEAAyC;AACzC,8EAAmD;AACnD,2FAAgE;AAChE,4EAAiD;AACjD,uFAA4D"}

package/src/lib/utils/ensure-property.utils.d.ts

@@ -0,0 +1,89 @@
+type PathKeys<T, Depth extends number = 5> = [Depth] extends [never] ? never : T extends object ? {
+    [K in keyof T]-?: K extends string | number ? T[K] extends object | undefined ? `${K}` | `${K}.${PathKeys<NonNullable<T[K]>, Prev[Depth]>}` : `${K}` : never;
+}[keyof T] : never;
+type Prev = [never, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15];
+type PathToTuple<S extends string> = S extends `${infer First}.${infer Rest}` ? [First, ...PathToTuple<Rest>] : [S];
+type ValidPaths<T> = PathKeys<T> extends infer P ? P extends string ? PathToTuple<P> : never : never;
+type SetPathTuple<T, Path extends ReadonlyArray<string | number>, Value> = Path extends readonly [infer Key, ...infer Rest] ? Key extends string | number ? Rest extends ReadonlyArray<string | number> ? Rest['length'] extends 0 ? T & {
+    [K in Key]: Value;
+} : {
+    [K in keyof T | Key]-?: K extends Key ? K extends keyof T ? SetPathTuple<NonNullable<T[K]>, Rest, Value> : SetPathTuple<object, Rest, Value> : K extends keyof T ? T[K] : never;
+} : never : never : never;
+/**
+ * Ensures that a property exists at the specified path within an object.
+ * Creates intermediate objects as needed and sets the final property to the initial value
+ * only if the property is currently null or undefined.
+ *
+ * This function is useful for safely initializing deeply nested properties without worrying
+ * about intermediate objects being missing. It will not overwrite existing values - only
+ * null or undefined values are replaced.
+ *
+ * **Returns the typed object** - you should use the return value to access the properties
+ * with full type safety.
+ *
+ * Supports property names with special characters that can only be accessed via bracket notation.
+ *
+ * @template T - The object type
+ * @template Path - The path as a tuple of keys
+ * @template Value - The type of the value to set
+ * @param obj - The object to modify
+ * @param path - An array representing the path to the property (e.g., ['user', 'profile', 'name'])
+ * @param initialValue - The value to set if the property is currently null or undefined
+ * @returns The same object with updated type information including the new property
+ *
+ * @example
+ * // Recommended: Use the return value for full type safety
+ * const g = ensureProperty(globalThis, ['myApp', 'config', 'debug'], false);
+ * if (g.myApp.config.debug) {
+ *   console.log('Debug mode enabled');
+ * }
+ *
+ * @example
+ * // For regular property names (no special chars), both ways work:
+ * // 1. Using return value (recommended for consistency)
+ * let config = {};
+ * config = ensureProperty(config, ['database', 'host'], 'localhost');
+ * console.log(config.database.host); // TypeScript knows about this
+ *
+ * // 2. Without using return value (works for non-special chars)
+ * const settings = {};
+ * ensureProperty(settings, ['server', 'port'], 3000);
+ * console.log(settings.server.port); // Also works, but less type-safe
+ *
+ * @example
+ * // For globalThis with regular names, you can declare it globally:
+ * declare global {
+ *   var myApp: { config: { debug: boolean } };
+ * }
+ * ensureProperty(globalThis, ['myApp', 'config', 'debug'], false);
+ * if (globalThis.myApp.config.debug) { // Works without using return value
+ *   console.log('Debug enabled');
+ * }
+ *
+ * @example
+ * // For special characters, MUST use return value:
+ * const g = ensureProperty(globalThis, ['@onecx/accelerator', 'version'], '1.0.0');
+ * console.log(g['@onecx/accelerator'].version); // TypeScript knows this exists
+ * // globalThis['@onecx/accelerator'].version won't work without the return value
+ *
+ * @example
+ * // Won't overwrite existing values
+ * let obj = { name: 'John' };
+ * obj = ensureProperty(obj, ['name'], 'Jane');
+ * console.log(obj.name); // Still 'John'
+ *
+ * @example
+ * // Replaces null values
+ * let obj = { name: null };
+ * obj = ensureProperty(obj, ['name'], 'Default');
+ * console.log(obj.name); // Now 'Default'
+ *
+ * @example
+ * // Nested paths with special characters
+ * const g = ensureProperty(globalThis, ['@myapp/config', 'feature-flags', 'enabled'], true);
+ * console.log(g['@myapp/config']['feature-flags'].enabled);
+ */
+export declare function ensureProperty<const Path extends ReadonlyArray<string | number>, Value>(obj: typeof globalThis, path: Path, initialValue: Value): typeof globalThis & SetPathTuple<typeof globalThis, Path, Value>;
+export declare function ensureProperty<T extends object, const Path extends ValidPaths<T>, Value>(obj: T, path: Path, initialValue: Value): T & SetPathTuple<T, Path, Value>;
+export declare function ensureProperty<T extends object, const Path extends ReadonlyArray<string | number>, Value>(obj: T, path: Path, initialValue: Value): T & SetPathTuple<T, Path, Value>;
+export {};

package/src/lib/utils/ensure-property.utils.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureProperty = ensureProperty;
+function ensureProperty(obj, path, initialValue) {
+    let current = obj;
+    for (let i = 0; i < path.length - 1; i++) {
+        const key = path[i];
+        if (current[key] == null || typeof current[key] !== 'object') {
+            current[key] = {};
+        }
+        current = current[key];
+    }
+    const lastKey = path.at(-1);
+    if (lastKey === undefined) {
+        return obj;
+    }
+    current[lastKey] ??= initialValue;
+    return obj;
+}
+//# sourceMappingURL=ensure-property.utils.js.map

package/src/lib/utils/ensure-property.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-property.utils.js","sourceRoot":"","sources":["../../../../../../libs/accelerator/src/lib/utils/ensure-property.utils.ts"],"names":[],"mappings":";;AAmJA,wCAqBC;AArBD,SAAgB,cAAc,CAC1B,GAAM,EACN,IAAU,EACV,YAAmB;IAEnB,IAAI,OAAO,GAAQ,GAAG,CAAC;IAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACtB,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,GAAuC,CAAC;IACnD,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,KAAK,YAAY,CAAC;IAClC,OAAO,GAAuC,CAAC;AACnD,CAAC"}

package/src/lib/utils/get-onecx-shared-recommendations.d.ts

@@ -0,0 +1,2 @@
+import { SharedLibraryConfig } from '@nx/module-federation';
+export declare function getOneCXSharedRecommendations(libraryName: string, sharedConfig: SharedLibraryConfig): false | SharedLibraryConfig;

package/src/lib/utils/get-onecx-shared-recommendations.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOneCXSharedRecommendations = getOneCXSharedRecommendations;
+const sharedLibraryPatterns = [/^@angular.*$/, /^@onecx.*$/, /^rxjs.*$/, /^primeng.*$/, /^@ngx-translate.*$/];
+function getOneCXSharedRecommendations(libraryName, sharedConfig) {
+    if (!sharedLibraryPatterns.some((pattern) => pattern.test(libraryName))) {
+        return false;
+    }
+    sharedConfig.singleton = false;
+    sharedConfig.strictVersion = false;
+    sharedConfig.eager = false;
+    return sharedConfig;
+}
+//# sourceMappingURL=get-onecx-shared-recommendations.js.map

package/src/lib/utils/get-onecx-shared-recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-onecx-shared-recommendations.js","sourceRoot":"","sources":["../../../../../../libs/accelerator/src/lib/utils/get-onecx-shared-recommendations.ts"],"names":[],"mappings":";;AAIA,sEAWC;AAbD,MAAM,qBAAqB,GAAa,CAAC,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAAA;AAEvH,SAAgB,6BAA6B,CAC3C,WAAmB,EACnB,YAAiC;IAEjC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO,KAAK,CAAA;IACd,CAAC;IACD,YAAY,CAAC,SAAS,GAAG,KAAK,CAAA;IAC9B,YAAY,CAAC,aAAa,GAAG,KAAK,CAAA;IAClC,YAAY,CAAC,KAAK,GAAG,KAAK,CAAA;IAC1B,OAAO,YAAY,CAAA;AACrB,CAAC"}