@opensourcekd/ng-common-libs 2.0.4 → 2.0.6

package/README.md

@@ -95,6 +95,10 @@ import {
   AuthService,
   EventBus,
   
+  // Helper Functions
+  configureAuth0,
+  createAuthService,
+  
   // Configuration
   APP_CONFIG,
   AUTH0_CONFIG,
@@ -111,6 +115,7 @@ import {
   UserData,
   EventPayload,
   Auth0Config,
+  Auth0ConfigOptions,
   StorageConfig,
   StorageKeys,
   AppState,

package/dist/index.cjs

@@ -12,6 +12,9 @@ var operators = require('rxjs/operators');
  * // Create an instance
  * const eventBus = new EventBus();
  *
+ * // Create an instance with an identifier
+ * const eventBus = new EventBus({ id: 'MFE' });
+ *
  * // Emit an event
  * eventBus.emit('user:login', { userId: '123', username: 'john' });
  *
@@ -19,10 +22,28 @@ var operators = require('rxjs/operators');
  * eventBus.on('user:login').subscribe(data => {
  *   console.log('User logged in:', data);
  * });
+ *
+ * // Get the identifier
+ * const id = eventBus.getId(); // 'MFE' or undefined
  * ```
  */
 class EventBus {
     eventSubject = new rxjs.Subject();
+    id;
+    /**
+     * Create a new EventBus instance
+     * @param options - Optional configuration with an id to identify the instance
+     */
+    constructor(options) {
+        this.id = options?.id;
+    }
+    /**
+     * Get the identifier of this EventBus instance
+     * @returns The id if provided during initialization, undefined otherwise
+     */
+    getId() {
+        return this.id;
+    }
     /**
      * Emit an event with optional data
      * @param eventType - The type/name of the event
@@ -88,20 +109,47 @@ const APP_CONFIG = {
  */
 /**
  * Auth0 client configuration
- * Override these values in your consuming application by setting them before importing AuthService
+ * Override these values in your consuming application using configureAuth0()
  *
  * Note: redirectUri defaults to window.location.origin (base URL without path).
  * Auth0 will redirect back to this URL after authentication.
  */
 const AUTH0_CONFIG = {
-    domain: '', // Set in consuming app: process.env['NX_AUTH0_DOMAIN'] || 'your-domain.auth0.com'
-    clientId: '', // Set in consuming app: process.env['NX_AUTH0_CLIENT_ID'] || 'your-client-id'
+    domain: '', // Set via configureAuth0() or process.env
+    clientId: '', // Set via configureAuth0() or process.env
     redirectUri: typeof window !== 'undefined' ? window.location.origin : '',
     logoutUri: typeof window !== 'undefined' ? window.location.origin : '',
-    audience: '', // Optional: Set in consuming app if using API authorization
+    audience: '', // Optional: Set via configureAuth0()
     scope: 'openid profile email', // Default scopes
-    connection: undefined, // Optional: Force specific connection (e.g., 'Username-Password-Authentication')
+    connection: undefined, // Optional: Force specific connection
 };
+/**
+ * Configure Auth0 settings
+ * Call this function early in your application (e.g., in app.config.ts or main.ts)
+ * to override the default Auth0 configuration values.
+ *
+ * @param config - Partial Auth0 configuration to override defaults
+ *
+ * @example
+ * ```typescript
+ * import { configureAuth0, APP_CONFIG } from '@opensourcekd/ng-common-libs';
+ *
+ * configureAuth0({
+ *   domain: APP_CONFIG.auth0Domain,
+ *   clientId: APP_CONFIG.auth0ClientId,
+ *   audience: APP_CONFIG.apiUrl,
+ * });
+ * ```
+ */
+function configureAuth0(config) {
+    // Only update properties that are explicitly provided (not undefined)
+    Object.keys(config).forEach((key) => {
+        const configKey = key;
+        if (config[configKey] !== undefined) {
+            AUTH0_CONFIG[configKey] = config[configKey];
+        }
+    });
+}
 /**
  * Storage configuration
  * Controls where sensitive data is stored
@@ -117,6 +165,20 @@ const STORAGE_KEYS = {
     ACCESS_TOKEN: 'auth0_access_token',
     USER_INFO: 'auth0_user_info',
 };
+/**
+ * Reset AUTH0_CONFIG to default values
+ * Useful for testing
+ * @internal
+ */
+function resetAuth0Config() {
+    AUTH0_CONFIG.domain = '';
+    AUTH0_CONFIG.clientId = '';
+    AUTH0_CONFIG.redirectUri = typeof window !== 'undefined' ? window.location.origin : '';
+    AUTH0_CONFIG.logoutUri = typeof window !== 'undefined' ? window.location.origin : '';
+    AUTH0_CONFIG.audience = '';
+    AUTH0_CONFIG.scope = 'openid profile email';
+    AUTH0_CONFIG.connection = undefined;
+}
 /**
  * Helper functions for storage operations
  * These work with both localStorage and sessionStorage
@@ -204,10 +266,16 @@ function removeStorageItem(key, storageType = 'sessionStorage') {
  * };
  * const authService = new AuthService(authConfig, eventBus);
  *
+ * // Or create with an identifier
+ * const authService = new AuthService(authConfig, eventBus, undefined, undefined, { id: 'MFE' });
+ *
  * // Use the service
  * await authService.login();
  * const user = authService.getUser();
  * const token = await authService.getToken();
+ *
+ * // Get the identifier
+ * const id = authService.getId(); // 'MFE' or undefined
  * ```
  */
 class AuthService {
@@ -226,12 +294,14 @@ class AuthService {
     storageConfig;
     storageKeys;
     eventBus;
+    id;
     /**
      * Create a new AuthService instance
      * @param config - Auth0 configuration
      * @param eventBus - EventBus instance for emitting auth events
      * @param storageConfig - Storage configuration (optional, defaults to sessionStorage)
      * @param storageKeys - Storage keys (optional, defaults to standard keys)
+     * @param options - Optional configuration with an id to identify the instance
      */
     constructor(config, eventBus, storageConfig = {
         TOKEN_STORAGE: 'sessionStorage',
@@ -239,16 +309,24 @@ class AuthService {
     }, storageKeys = {
         ACCESS_TOKEN: 'auth0_access_token',
         USER_INFO: 'auth0_user_info'
-    }) {
+    }, options) {
         this.config = config;
         this.eventBus = eventBus;
         this.storageConfig = storageConfig;
         this.storageKeys = storageKeys;
+        this.id = options?.id;
         this.userSubject = new rxjs.BehaviorSubject(this.getUserInfoFromStorage());
         this.user$ = this.userSubject.asObservable();
         console.log("[AuthService] AuthService instance created (Auth0 client will be initialized on first use)");
         // Lazy initialization - Auth0 client will be initialized in ensureInitialized() on first use
     }
+    /**
+     * Get the identifier of this AuthService instance
+     * @returns The id if provided during initialization, undefined otherwise
+     */
+    getId() {
+        return this.id;
+    }
     /**
      * Initialize Auth0 client
      */
@@ -588,6 +666,43 @@ class AuthService {
         console.log('[AuthService] Auth event emitted:', event.type);
     }
 }
+/**
+ * Create AuthService instance using AUTH0_CONFIG
+ * Helper function for creating AuthService with default configuration from AUTH0_CONFIG
+ *
+ * Note: Make sure to call configureAuth0() before using this helper
+ *
+ * @param eventBus - EventBus instance for auth events
+ * @returns Configured AuthService instance
+ *
+ * @example
+ * ```typescript
+ * import { createAuthService, EventBus, configureAuth0, APP_CONFIG } from '@opensourcekd/ng-common-libs';
+ *
+ * // Configure Auth0 first
+ * configureAuth0({
+ *   domain: APP_CONFIG.auth0Domain,
+ *   clientId: APP_CONFIG.auth0ClientId,
+ *   audience: APP_CONFIG.apiUrl,
+ * });
+ *
+ * // Create instances
+ * const eventBus = new EventBus();
+ * const authService = createAuthService(eventBus);
+ * ```
+ */
+function createAuthService(eventBus) {
+    const auth0Config = {
+        domain: AUTH0_CONFIG.domain,
+        clientId: AUTH0_CONFIG.clientId,
+        redirectUri: AUTH0_CONFIG.redirectUri,
+        logoutUri: AUTH0_CONFIG.logoutUri,
+        audience: AUTH0_CONFIG.audience,
+        scope: AUTH0_CONFIG.scope,
+        connection: AUTH0_CONFIG.connection,
+    };
+    return new AuthService(auth0Config, eventBus, STORAGE_CONFIG, STORAGE_KEYS);
+}
 
 exports.APP_CONFIG = APP_CONFIG;
 exports.AUTH0_CONFIG = AUTH0_CONFIG;
@@ -595,7 +710,10 @@ exports.AuthService = AuthService;
 exports.EventBus = EventBus;
 exports.STORAGE_CONFIG = STORAGE_CONFIG;
 exports.STORAGE_KEYS = STORAGE_KEYS;
+exports.configureAuth0 = configureAuth0;
+exports.createAuthService = createAuthService;
 exports.getStorageItem = getStorageItem$1;
 exports.removeStorageItem = removeStorageItem$1;
+exports.resetAuth0Config = resetAuth0Config;
 exports.setStorageItem = setStorageItem$1;
 //# sourceMappingURL=index.cjs.map