@onecx/accelerator 8.3.1 → 8.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onecx/accelerator",
-  "version": "8.3.1",
+  "version": "8.4.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",

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

@@ -0,0 +1,95 @@
+import { SharedLibraryConfig } from "./get-onecx-shared-recommendations";
+/**
+ * Callbacks that can be passed to the SharedLibraryConfigOptions function to customize its behavior.
+ * @property {function} configCallback - A function that receives the package name and current shared configuration, returning a modified configuration. Must return a SharedLibraryConfig object.
+ * @property {function} packageFilterCallback - A function that takes a package name and returns a boolean. Return true to EXCLUDE the package, false to INCLUDE it, use onecxPackageFilter to use default blacklist.
+*/
+export interface SharedLibraryConfigOptions {
+    configCallback?: (packageName: string, currentConfig: SharedLibraryConfig) => SharedLibraryConfig;
+    packageFilterCallback?: (packageName: string) => boolean | undefined;
+}
+/**
+ * onecxPackageFilter is the default OneCX package filter.
+ * @param {string} packageName - The full package name to check against the default blacklist.
+ * @returns {boolean} - Returns `true` if the package is on the default blacklist, `false` otherwise.
+ */
+export declare function onecxPackageFilter(packageName: string): boolean;
+/**
+ * Generates a shared library configuration object for all dependencies (main + subpackages if needed).
+ * @param {Record<string, string>} dependencies - Map of dependency names to versions
+ * @param {boolean} shouldGenerateSubDeps - Flag indicating whether to include subpackages based on exports
+ * @param {SharedLibraryConfigOptions} options - Optional callbacks for customizing the configuration generation process. Includes:
+ *   - configCallback: A function that receives the package name and current shared configuration, returning a modified configuration.
+ *      configCallback?: (packageName: string, currentConfig: SharedLibraryConfig) => SharedLibraryConfig;
+ *   - packageFilterCallback: A function that takes a package name and returns a boolean. Return true to EXCLUDE the package, false to INCLUDE it.
+ *      packageFilterCallback?: (packageName: string) => boolean | undefined;
+ * @returns {Record<string, SharedLibraryConfig>} A map of package names to their shared library configuration
+ *
+ * @example
+ * **Recommended usage for @module-federation/enhanced:**
+ * ```js
+ * const sharedEntries = getOneCXSharedLibraryConfig(dependencies, true);
+ * const config = {
+ *   name: 'onecx-test-project-ui',
+ *   filename: 'remoteEntry.js',
+ *   shared: sharedEntries,
+ *   shareScope: 'angular_21'
+ * }
+ * ```
+ *
+ * **Recommended usage for @angular-architects/module-federation:**
+ * The share function is from @angular-architects/module-federation.
+ * ```js
+ * function customConfigCallback(packageName: string, currentConfig: SharedLibraryConfig): SharedLibraryConfig {
+ *   currentConfig[includeSecondaries]=true
+ *   currentConfig[requiredVersion]='auto'
+ *   return currentConfig
+ * }
+ *
+ * const sharedEntries = getOneCXSharedLibraryConfig(dependencies, false, { configCallback: customConfigCallback });
+ * const config = withModuleFederationPlugin({
+ *   name: 'onecx-<%= remoteModuleFileName %>-ui',
+ *   filename: 'remoteEntryOneCX.js',
+ *   exposes: {
+ *     './OneCX<%= remoteModuleName %>Module': './src/main.ts'
+ *   },
+ *   shared: share(sharedEntries),
+ * });
+ * ```
+ * \
+ * **With options (custom filter and config override) you can customize the behavior as follows:**
+ * ```js
+ * const sharedEntries = getOneCXSharedLibraryConfig(dependencies, true, {
+ *   packageFilterCallback: customPackageFilter,
+ *   configCallback: customConfigCallback,
+ * });
+ * ```
+ * \
+ * Following are some Custom Implementation:
+ * 1. Adding Custom Config or overiding default config
+ *```js
+ * function customConfigCallback(packageName: string, currentConfig: SharedLibraryConfig): SharedLibraryConfig {
+ *   currentConfig[singleton]=true
+ *   return currentConfig
+ * }
+ * ```
+ *
+ * 2. Custom Package without using onecxPckageFilter
+ * ```js
+ * function customPackageFilter(packageName: string): boolean {
+ *   if (packageName.startsWith('@internal/')) return true;
+ *   return false;
+ * }
+ * ```
+ *
+ * 3. Custom Package using onecxPckageFilter as defaut:
+ * ```js
+ * function customPackageFilter(packageName: string): boolean {
+ *   if (packageName.startsWith('@internal/')) return true;
+ *   return onecxPackageFilter(packageName);
+ * }
+ *
+ * ```
+ *
+ */
+export declare function getOneCXSharedLibraryConfig(dependencies: Record<string, string>, shouldGenerateSubDeps: boolean, options?: SharedLibraryConfigOptions): Record<string, SharedLibraryConfig>;

package/src/lib/utils/get-onecx-shared-library-config.js

@@ -0,0 +1,261 @@
+import { getOneCXSharedRecommendations } from "./get-onecx-shared-recommendations";
+/**
+ * As we have { platform: 'browser'} in accelerator's & integration-interface project.json.
+ * We use dynamic require (provided by Node.js) to read package.json of dependencies, which is not supported in browser environment.
+ * So we need to check if the environment is node before using it. So it will only return valid require function while building
+ */
+const nodeRequire = (() => {
+    try {
+        if (typeof process !== 'undefined' && process?.versions?.node) {
+            return eval('require');
+        }
+        else {
+            throw new Error('Node.js environment is required for dynamic require.');
+        }
+    }
+    catch {
+        throw new Error('Node.js environment is required for dynamic require.');
+    }
+})();
+const angularCore = '@angular/core';
+/**
+ * Blacklist of export paths to exclude when generating subpackage entries.
+ */
+const EXPORTS_BLACKLIST = ['.', './package.json'];
+/**
+ * Patterns for identifying dependencies that should be blacklisted.
+ */
+const DEFAULT_DEPENDENCY_BLACKLIST = [
+    /^@nx(\/.*)?$/,
+    /^@module-federation(\/.*)?$/,
+];
+/**
+ * For identifying full package paths that should be blacklisted.
+ */
+const DEFAULT_FULL_PACKAGE_BLACKLIST = [
+    '@angular/common/locales/global/*',
+    '@angular/common/locales/*',
+    '@angular/common/upgrade',
+    '@angular/core/schematics/*',
+    '@angular/core/event-dispatch-contract.min.js',
+    '@angular/service-worker/ngsw-worker.js',
+    '@angular/service-worker/safety-worker.js',
+    '@angular/service-worker/config/schema.json',
+    '@angular/router/upgrade',
+    '@angular/localize/tools',
+    'rxjs/internal/*',
+    'primeng/resources/',
+    'primeng/editor',
+    '@onecx/angular-accelerator/testing',
+    '@onecx/angular-accelerator/migrations.json',
+];
+/**
+ * Removes the './' prefix from a string, typically used for export paths in package.json files.
+ * @param {string} str - The string from which to remove the './' prefix.
+ * @returns {string} The string without the './' prefix.
+ */
+function removeExportPrefix(str) {
+    return str.replace('./', '');
+}
+/**
+ * onecxPackageFilter is the default OneCX package filter.
+ * @param {string} packageName - The full package name to check against the default blacklist.
+ * @returns {boolean} - Returns `true` if the package is on the default blacklist, `false` otherwise.
+ */
+export function onecxPackageFilter(packageName) {
+    if (isDependencyBlacklisted(packageName)) {
+        return true;
+    }
+    return DEFAULT_FULL_PACKAGE_BLACKLIST.includes(packageName);
+}
+/**
+ * Check whether a dependency matches any blacklist entry. Supports RegExp entries and exact string matches.
+ */
+function isDependencyBlacklisted(dependency) {
+    return DEFAULT_DEPENDENCY_BLACKLIST.some((entry) => {
+        if (entry instanceof RegExp) {
+            return entry.test(dependency);
+        }
+        return entry === dependency;
+    });
+}
+/**
+ * Resolves and reads a dependency's package.json file.
+ * Handles module resolution across npm/yarn/pnpm layouts.
+ * @param {string} dependency - Package name to resolve
+ * @returns {Object|null} Parsed package.json or null if not found
+ */
+function readDependencyPackageJson(dependency) {
+    if (!nodeRequire)
+        return null;
+    let packagePath;
+    try {
+        packagePath = nodeRequire.resolve(`${dependency}/package.json`);
+    }
+    catch {
+        return null;
+    }
+    const fs = nodeRequire('fs');
+    if (!fs.existsSync(packagePath)) {
+        return null;
+    }
+    const packageContent = fs.readFileSync(packagePath, 'utf-8');
+    return JSON.parse(packageContent);
+}
+/**
+ * Generates subpackages from a dependency's export entries. Reads the dependency's package.json to find all exported subpackages
+ * and creates fully qualified package names.
+ * @param {string} dependency - Package name
+ * @param {string} version - Package version
+ * @param {function} packageFilterCallback - Optional callback to filter out specific subpackages. Should return true to exclude a package, false to include it.
+ * @returns {Array} Array of subpackage objects with name and version
+ */
+function generateSubPackageConfig(dependency, version, packageFilterCallback) {
+    const subpackages = [];
+    const dependencyPackage = readDependencyPackageJson(dependency);
+    if (!dependencyPackage?.exports) {
+        return subpackages;
+    }
+    const exportKeys = Object.keys(dependencyPackage.exports);
+    for (const exportKey of exportKeys) {
+        if (EXPORTS_BLACKLIST.includes(exportKey))
+            continue;
+        const subpackageName = `${dependency}/${removeExportPrefix(exportKey)}`;
+        if (packageFilterCallback && packageFilterCallback(subpackageName))
+            continue;
+        subpackages.push({ name: subpackageName, requiredVersion: version });
+    }
+    return subpackages;
+}
+/**
+ * Generates all shared packages (main + subpackages) for a given dependency.
+ * Includes the main package plus all exported subpackages.
+ * @param {Object} versionMap - Map of dependency names to versions
+ * @param {string} dependency - Package name to generate packages for
+ * @param {boolean} shouldGenerateSubDeps - Flag indicating whether to include subpackages based on exports
+ * @param {function} packageFilterCallback - Optional callback to filter out specific packages. Should return true to exclude a package, false to include it.
+ * @returns {Array} Array of all packages (main + subpackages)
+ */
+function generatePackageConfig(versionMap, dependency, shouldGenerateSubDeps, packageFilterCallback = onecxPackageFilter) {
+    if (packageFilterCallback(dependency)) {
+        return [];
+    }
+    const allPackages = [];
+    const version = versionMap[dependency];
+    allPackages.push({ name: dependency, requiredVersion: version });
+    if (shouldGenerateSubDeps) {
+        const subpackages = generateSubPackageConfig(dependency, version, packageFilterCallback);
+        allPackages.push(...subpackages);
+    }
+    return allPackages;
+}
+/**
+ * Generates a shared library configuration object for all dependencies (main + subpackages if needed).
+ * @param {Record<string, string>} dependencies - Map of dependency names to versions
+ * @param {boolean} shouldGenerateSubDeps - Flag indicating whether to include subpackages based on exports
+ * @param {SharedLibraryConfigOptions} options - Optional callbacks for customizing the configuration generation process. Includes:
+ *   - configCallback: A function that receives the package name and current shared configuration, returning a modified configuration.
+ *      configCallback?: (packageName: string, currentConfig: SharedLibraryConfig) => SharedLibraryConfig;
+ *   - packageFilterCallback: A function that takes a package name and returns a boolean. Return true to EXCLUDE the package, false to INCLUDE it.
+ *      packageFilterCallback?: (packageName: string) => boolean | undefined;
+ * @returns {Record<string, SharedLibraryConfig>} A map of package names to their shared library configuration
+ *
+ * @example
+ * **Recommended usage for @module-federation/enhanced:**
+ * ```js
+ * const sharedEntries = getOneCXSharedLibraryConfig(dependencies, true);
+ * const config = {
+ *   name: 'onecx-test-project-ui',
+ *   filename: 'remoteEntry.js',
+ *   shared: sharedEntries,
+ *   shareScope: 'angular_21'
+ * }
+ * ```
+ *
+ * **Recommended usage for @angular-architects/module-federation:**
+ * The share function is from @angular-architects/module-federation.
+ * ```js
+ * function customConfigCallback(packageName: string, currentConfig: SharedLibraryConfig): SharedLibraryConfig {
+ *   currentConfig[includeSecondaries]=true
+ *   currentConfig[requiredVersion]='auto'
+ *   return currentConfig
+ * }
+ *
+ * const sharedEntries = getOneCXSharedLibraryConfig(dependencies, false, { configCallback: customConfigCallback });
+ * const config = withModuleFederationPlugin({
+ *   name: 'onecx-<%= remoteModuleFileName %>-ui',
+ *   filename: 'remoteEntryOneCX.js',
+ *   exposes: {
+ *     './OneCX<%= remoteModuleName %>Module': './src/main.ts'
+ *   },
+ *   shared: share(sharedEntries),
+ * });
+ * ```
+ * \
+ * **With options (custom filter and config override) you can customize the behavior as follows:**
+ * ```js
+ * const sharedEntries = getOneCXSharedLibraryConfig(dependencies, true, {
+ *   packageFilterCallback: customPackageFilter,
+ *   configCallback: customConfigCallback,
+ * });
+ * ```
+ * \
+ * Following are some Custom Implementation:
+ * 1. Adding Custom Config or overiding default config
+ *```js
+ * function customConfigCallback(packageName: string, currentConfig: SharedLibraryConfig): SharedLibraryConfig {
+ *   currentConfig[singleton]=true
+ *   return currentConfig
+ * }
+ * ```
+ *
+ * 2. Custom Package without using onecxPckageFilter
+ * ```js
+ * function customPackageFilter(packageName: string): boolean {
+ *   if (packageName.startsWith('@internal/')) return true;
+ *   return false;
+ * }
+ * ```
+ *
+ * 3. Custom Package using onecxPckageFilter as defaut:
+ * ```js
+ * function customPackageFilter(packageName: string): boolean {
+ *   if (packageName.startsWith('@internal/')) return true;
+ *   return onecxPackageFilter(packageName);
+ * }
+ *
+ * ```
+ *
+ */
+export function getOneCXSharedLibraryConfig(dependencies, shouldGenerateSubDeps, options) {
+    const allDependencies = Object.keys(dependencies).flatMap((dependency) => {
+        return generatePackageConfig(dependencies, dependency, shouldGenerateSubDeps, options?.packageFilterCallback);
+    });
+    const sharedEntries = allDependencies.reduce((acc, packageEntry) => {
+        const sharedLibConfig = {};
+        sharedLibConfig['requiredVersion'] = packageEntry.requiredVersion;
+        sharedLibConfig['shareScope'] = 'default';
+        const angularCoreVersion = (dependencies[angularCore] || '').split('.')[0].replace('^', '');
+        if (angularCoreVersion && parseInt(angularCoreVersion, 10) >= 21) {
+            const shareScope = ('angular_').concat(angularCoreVersion);
+            sharedLibConfig['shareScope'] = shareScope;
+        }
+        const onecxRecommendation = getOneCXSharedRecommendations(packageEntry.name, sharedLibConfig);
+        if (!onecxRecommendation) {
+            return acc;
+        }
+        // Apply configCallback if provided to current config overriding the recommendation
+        const configFromCallback = options?.configCallback ? options.configCallback(packageEntry.name, onecxRecommendation) : undefined;
+        if (configFromCallback && typeof configFromCallback === 'object') {
+            Object.assign(onecxRecommendation, configFromCallback);
+        }
+        return {
+            ...acc,
+            [packageEntry.name]: {
+                ...onecxRecommendation,
+            },
+        };
+    }, {});
+    return sharedEntries;
+}
+//# sourceMappingURL=get-onecx-shared-library-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-onecx-shared-library-config.js","sourceRoot":"","sources":["../../../../../../libs/accelerator/src/lib/utils/get-onecx-shared-library-config.ts"],"names":[],"mappings":"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"}

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

@@ -5,5 +5,14 @@ export interface SharedLibraryConfig {
     requiredVersion?: string | false;
     version?: string;
     includeSecondaries?: boolean;
+    shareScope?: string;
 }
+/**
+ * Provides recommendations for shared library configurations for specific OneCX-related libraries.
+ * If the library name matches certain patterns (e.g., Angular, OneCX, RxJS, PrimeNG, ngx-translate, ngrx), it modifies the shared configuration to set singleton, strictVersion, and eager to false.
+ * For non-matching libraries, it returns false and does not modify the configuration.
+ * @param {string} libraryName - The name of the library being shared.
+ * @param {SharedLibraryConfig} sharedConfig - The existing shared configuration for the library, which may be modified if recommendations are applied.
+ * @returns {false | SharedLibraryConfig} - Returns the modified shared configuration if recommendations are applied, or false if no recommendations are applicable.
+ */
 export declare function getOneCXSharedRecommendations(libraryName: string, sharedConfig: SharedLibraryConfig): false | SharedLibraryConfig;

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

@@ -1,3 +1,6 @@
+/**
+ * Patterns for identifying shared libraries that should have specific configuration recommendations.
+ */
 const sharedLibraryPatterns = [
     /^@angular.*$/,
     /^@onecx.*$/,
@@ -6,6 +9,14 @@ const sharedLibraryPatterns = [
     /^@ngx-translate.*$/,
     /^@ngrx.*$/,
 ];
+/**
+ * Provides recommendations for shared library configurations for specific OneCX-related libraries.
+ * If the library name matches certain patterns (e.g., Angular, OneCX, RxJS, PrimeNG, ngx-translate, ngrx), it modifies the shared configuration to set singleton, strictVersion, and eager to false.
+ * For non-matching libraries, it returns false and does not modify the configuration.
+ * @param {string} libraryName - The name of the library being shared.
+ * @param {SharedLibraryConfig} sharedConfig - The existing shared configuration for the library, which may be modified if recommendations are applied.
+ * @returns {false | SharedLibraryConfig} - Returns the modified shared configuration if recommendations are applied, or false if no recommendations are applicable.
+ */
 export function getOneCXSharedRecommendations(libraryName, sharedConfig) {
     if (!sharedLibraryPatterns.some((pattern) => pattern.test(libraryName))) {
         return false;

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

@@ -1 +1 @@
-{"version":3,"file":"get-onecx-shared-recommendations.js","sourceRoot":"","sources":["../../../../../../libs/accelerator/src/lib/utils/get-onecx-shared-recommendations.ts"],"names":[],"mappings":"AASA,MAAM,qBAAqB,GAAa;IACtC,cAAc;IACd,YAAY;IACZ,UAAU;IACV,aAAa;IACb,oBAAoB;IACpB,WAAW;CACZ,CAAA;AAED,MAAM,UAAU,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"}
+{"version":3,"file":"get-onecx-shared-recommendations.js","sourceRoot":"","sources":["../../../../../../libs/accelerator/src/lib/utils/get-onecx-shared-recommendations.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,qBAAqB,GAAa;IACtC,cAAc;IACd,YAAY;IACZ,UAAU;IACV,aAAa;IACb,oBAAoB;IACpB,WAAW;CACZ,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,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"}

package/src/version.d.ts

@@ -1,2 +1,2 @@
 export declare const LIB_NAME = "@onecx/accelerator";
-export declare const LIB_VERSION = "8.3.1";
+export declare const LIB_VERSION = "8.4.0";

package/src/version.js

@@ -1,3 +1,3 @@
 export const LIB_NAME = '@onecx/accelerator';
-export const LIB_VERSION = '8.3.1';
+export const LIB_VERSION = '8.4.0';
 //# sourceMappingURL=version.js.map