@opensourcekd/ng-common-libs 2.0.4 → 2.0.5

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

@@ -88,20 +88,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 +144,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
@@ -588,6 +629,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 +673,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