monkey-front-core 22.0.0 → 22.2.1

package/README.md

@@ -1,24 +1,21 @@
-# MonkeyStyleGuideV2
+# monkey-front-core
 
-This library was generated with [Angular CLI](https://github.com/angular/angular-cli) version 17.3.0.
+Shared Angular core library for Monkey Exchange front-end applications.
 
-## Code scaffolding
+> **Internal use only.** This package is published to npm for distribution across Monkey Exchange projects. It is not intended for public or third-party use, and no support or API stability is offered outside those projects.
 
-Run `ng generate component component-name --project monkey-front-core` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module --project monkey-front-core`.
-> Note: Don't forget to add `--project monkey-front-core` or else it will be added to the default project in your `angular.json` file. 
+## What it provides
 
-## Build
+Cross-cutting building blocks reused by Monkey front-end apps:
 
-Run `ng build monkey-front-core` to build the project. The build artifacts will be stored in the `dist/` directory.
+- **Services** — configuration, locale, feature toggles, Datadog, caching, scheduling, validation, session handling
+- **State** — NgRx store setup, actions, selectors and effects
+- **HTTP** — interceptors and base resolvers
+- **Routing** — guards and route discovery helpers
+- **Storage** — cookie and token storage
+- **Angular primitives** — directives, pipes, decorators, injectors, form validators
+- **Types** — shared interfaces, enums and models
 
-## Publishing
+## License
 
-After building your library with `ng build monkey-front-core`, go to the dist folder `cd dist/monkey-front-core` and run `npm publish`.
-
-## Running unit tests
-
-Run `ng test monkey-front-core` to execute the unit tests via [Karma](https://karma-runner.github.io).
-
-## Further help
-
-To get more help on the Angular CLI use `ng help` or go check out the [Angular CLI Overview and Command Reference](https://angular.io/cli) page.
+MIT © Monkey Exchange

package/fesm2022/monkey-front-core.mjs

@@ -5,7 +5,7 @@ import { inject, InjectionToken, Injectable, LOCALE_ID, DestroyRef, DOCUMENT, In
 import * as i2 from '@angular/router';
 import { Router, NavigationStart } from '@angular/router';
 import queryString from 'query-string';
-import { BehaviorSubject, of, map, firstValueFrom, merge, fromEvent, interval, ReplaySubject, Subject, tap, catchError, throwError, finalize, switchMap, take, filter, Subscription, from, debounceTime } from 'rxjs';
+import { BehaviorSubject, of, map, firstValueFrom, combineLatest, distinctUntilChanged, filter, merge, fromEvent, interval, ReplaySubject, Subject, tap, catchError, throwError, finalize, switchMap, take, Subscription, from, debounceTime } from 'rxjs';
 import * as i1 from 'ngx-cookie-service';
 import * as i1$1 from '@ngrx/store';
 import { createAction, props, INIT, createReducer, on, createFeatureSelector, createSelector, provideStore, provideState } from '@ngrx/store';
@@ -25,11 +25,6 @@ import { DomSanitizer } from '@angular/platform-browser';
 import { NgModel, TouchedChangeEvent, ValueChangeEvent, StatusChangeEvent } from '@angular/forms';
 import { map as map$1, catchError as catchError$1, finalize as finalize$1 } from 'rxjs/operators';
 
-/** ************************
- * Copyright Monkey Exchange. All Rights Reserved
- * This style guide was developed by Monkey Exchange Team
- * MIT Licence
- ************************* */
 function injectTokenWithWarning(token, name) {
     const value = inject(token, { optional: true });
     if (!value) {
@@ -88,6 +83,20 @@ const MECX_REFRESH_TOKEN_STRATEGY = new InjectionToken('MECX_REFRESH_TOKEN_STRAT
 const MECX_REDIRECT_LOGIN_WELCOMEBACK_STRATEGY = new InjectionToken('MECX_REDIRECT_LOGIN_WELCOMEBACK_STRATEGY');
 const MECX_I18N_PATH = new InjectionToken('MECX_I18N_PATH');
 const MECX_I18N_ALIAS = new InjectionToken('MECX_I18N_ALIAS');
+/**
+ * The native federation instance resolved by `initFederation` in the shell `main.ts`.
+ * Used by `MonkeyEcxFederationService` to register and load the remotes of `federationSettings`.
+ *
+ * ### Example
+ * ```
+ *  // main.ts
+ *  initFederation({}).then((federation) => import('./bootstrap').then((m) => m.bootstrap(federation)));
+ *
+ *  // bootstrap.ts
+ *  providers: [...appConfig.providers, provideMonkeyEcxFederation(federation)]
+ * ```
+ */
+const MECX_FEDERATION = new InjectionToken('MECX_FEDERATION');
 
 /** ************************
  * Copyright Monkey Exchange. All Rights Reserved
@@ -1308,19 +1317,7 @@ class MonkeyEcxConfigsService {
         this._styleGuide$.next(data);
     }
     federationSettings(key) {
-        try {
-            const { value } = this._bootstrap$;
-            if (value) {
-                const { federationSettings } = value;
-                if (key in federationSettings || {}) {
-                    return federationSettings[key];
-                }
-            }
-        }
-        catch (e) {
-            // not to do
-        }
-        return null;
+        return this._bootstrap$.value?.federationSettings?.[key] ?? null;
     }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.7", ngImport: i0, type: MonkeyEcxConfigsService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.1.7", ngImport: i0, type: MonkeyEcxConfigsService, providedIn: 'root' }); }
@@ -2016,6 +2013,141 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.7", ngImpor
                 }]
         }] });
 
+/** ************************
+ * Copyright Monkey Exchange. All Rights Reserved
+ * This style guide was developed by Monkey Exchange Team
+ * MIT Licence
+ ************************* */
+const DEFAULT_REMOTE_ENTRY = 'remoteEntry.json';
+const DEFAULT_EXPOSED_MODULE = './Routes';
+class MonkeyEcxFederationService {
+    constructor() {
+        this._configsService = inject(MonkeyEcxConfigsService);
+        this._errorService = inject(MonkeyEcxErrorService);
+        this._federation = injectTokenWithWarning(MECX_FEDERATION, 'MECX_FEDERATION');
+        this._remotes$ = new BehaviorSubject({});
+        this._initialized$ = new BehaviorSubject(false);
+        this._loading = new Map();
+        this._errorApplied = false;
+    }
+    get remotes$() {
+        return this._remotes$.asObservable();
+    }
+    get allLoaded$() {
+        return this.watchHoldSplash(['loaded']);
+    }
+    get allSettled$() {
+        return this.watchHoldSplash(['loaded', 'error']);
+    }
+    watchHoldSplash(statuses) {
+        return combineLatest([this._initialized$, this._remotes$]).pipe(map(([initialized, remotes]) => {
+            return this.isHoldSplashIn(initialized, remotes, statuses);
+        }), distinctUntilChanged());
+    }
+    isHoldSplashIn(initialized, remotes, statuses) {
+        if (!initialized)
+            return false;
+        return Object.values(remotes)
+            .filter(({ setting }) => {
+            return setting.holdSplash;
+        })
+            .every(({ status }) => {
+            return statuses.includes(status);
+        });
+    }
+    updateRemote(name, data) {
+        const remotes = this._remotes$.value;
+        this._remotes$.next({
+            ...remotes,
+            [name]: { ...remotes[name], ...data }
+        });
+    }
+    async handleLoad(name) {
+        const setting = this._configsService.federationSettings(name);
+        if (!setting) {
+            throw new Error(`MECXFederation -> Remote "${name}" not found in federationSettings`);
+        }
+        this.updateRemote(name, { name, setting, status: 'loading', error: undefined });
+        try {
+            if (!this._federation) {
+                throw new Error(`MECXFederation -> Remote "${name}" could not be loaded`);
+            }
+            const { host, remoteEntry = DEFAULT_REMOTE_ENTRY, exposedModule = DEFAULT_EXPOSED_MODULE } = setting;
+            const url = `${host.replace(/\/+$/, '')}/${remoteEntry.replace(/^\/+/, '')}`;
+            this._federation = await this._federation.initRemoteEntry(url, name);
+            const module = await this._federation.loadRemoteModule(name, exposedModule);
+            this.updateRemote(name, { status: 'loaded', module });
+            return module;
+        }
+        catch (e) {
+            console.error(`MECXFederation -> Remote "${name}" failed to load: `, e);
+            this.updateRemote(name, { status: 'error', error: e });
+            throw e;
+        }
+    }
+    handleStartupError(name, setting, e) {
+        if (!setting.holdSplash || this._errorApplied)
+            return;
+        this._errorApplied = true;
+        this._errorService.apply(`Remote "${name}" | ${setting.host} | ${e?.message || e}`);
+    }
+    apply() {
+        const federationSettings = this._configsService.bootstrap?.federationSettings || {};
+        const current = this._remotes$.value;
+        const remotes = Object.entries(federationSettings).reduce((acc, [name, setting]) => {
+            acc[name] = current[name] || { name, setting, status: 'idle' };
+            return acc;
+        }, {});
+        this._remotes$.next(remotes);
+        this._initialized$.next(true);
+        Object.entries(federationSettings)
+            .filter(([, setting]) => {
+            return setting.preload || setting.holdSplash;
+        })
+            .forEach(([name, setting]) => {
+            this.load(name).catch((e) => {
+                this.handleStartupError(name, setting, e);
+            });
+        });
+    }
+    skip() {
+        this._initialized$.next(true);
+    }
+    load(name) {
+        let promise = this._loading.get(name);
+        if (!promise) {
+            promise = this.handleLoad(name).catch((e) => {
+                this._loading.delete(name);
+                throw e;
+            });
+            this._loading.set(name, promise);
+        }
+        return promise;
+    }
+    async loadRoutes(name) {
+        const module = await this.load(name);
+        return module.routes;
+    }
+    status(name) {
+        return this._remotes$.value[name] || null;
+    }
+    isAllLoaded() {
+        return this.isHoldSplashIn(this._initialized$.value, this._remotes$.value, ['loaded']);
+    }
+    isAllSettled() {
+        return this.isHoldSplashIn(this._initialized$.value, this._remotes$.value, ['loaded', 'error']);
+    }
+    async whenAllSettled() {
+        await firstValueFrom(this.allSettled$.pipe(filter(Boolean)));
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.7", ngImport: i0, type: MonkeyEcxFederationService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.1.7", ngImport: i0, type: MonkeyEcxFederationService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.7", ngImport: i0, type: MonkeyEcxFederationService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
 /** ************************
  * Copyright Monkey Exchange. All Rights Reserved
  * This style guide was developed by Monkey Exchange Team
@@ -3075,6 +3207,7 @@ class MonkeyEcxInitService {
         this._maintenanceService = inject(MonkeyEcxMaintenanceService);
         this._localeService = inject(MonkeyEcxLocaleService);
         this._connectionService = inject(MonkeyEcxConnectionService);
+        this._federationService = inject(MonkeyEcxFederationService);
         this._bootstrapService = injectTokenWithWarning(MECX_BOOTSTRAP_SERVICE, 'MECX_BOOTSTRAP_SERVICE');
         // not to do
     }
@@ -3107,9 +3240,11 @@ class MonkeyEcxInitService {
     async handleSettings(response, code) {
         this._updateService.apply();
         if (response.maintenance.closed) {
+            this._federationService.skip();
             this._maintenanceService.apply();
         }
         else {
+            this._federationService.apply();
             await this.handleWhiteLabel(code);
             await this._featureToggleService.apply();
             await this.handleStyleGuide(code);
@@ -3121,6 +3256,7 @@ class MonkeyEcxInitService {
     async performValidation(response, code) {
         this._configsService.bootstrap = response;
         if (!code) {
+            this._federationService.skip();
             this._errorService.apply();
             return;
         }
@@ -3142,6 +3278,7 @@ class MonkeyEcxInitService {
         }
         catch (e) {
             console.error('🤯 MECXInit -> Monkey app initialization failed: ', e);
+            this._federationService.skip();
             this._errorService.apply(e);
         }
     }
@@ -5646,7 +5783,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.7", ngImpor
  * MIT Licence
  ************************* */
 
-function provideDomainServiceWorker(workerUrl, scope = '/') {
+function provideMonkeyEcxFederation(federation) {
+    return [{ provide: MECX_FEDERATION, useValue: federation }];
+}
+
+function provideMonkeyEcxDomainServiceWorker(workerUrl, scope = '/') {
     return provideServiceWorker(workerUrl, {
         enabled: true,
         scope,
@@ -5881,5 +6022,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.7", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { CACHE_LOCALE_EXPIRATION_MS, CountryMasks, LService, Link, MECX_ALPHA, MECX_BETA, MECX_BOOTSTRAP_SERVICE, MECX_CORE_I18N_WRAPPER, MECX_COUNTRY, MECX_DATE_FORMAT, MECX_I18N_ALIAS, MECX_I18N_PATH, MECX_REDIRECT_LOGIN_WELCOMEBACK_STRATEGY, MECX_REFRESH_TOKEN_STRATEGY, MECX_REQUEST_ID, MECX_TIMEZONEOFFSET, MonkeyEcxAuthGuard, MonkeyEcxAuthGuardByRole, MonkeyEcxAuthGuardCompany, MonkeyEcxAuthGuardLogin, MonkeyEcxBaseResolver, MonkeyEcxBlobSecurePipe, MonkeyEcxCommonsActions, MonkeyEcxCommonsSelectors, MonkeyEcxCommonsStoreService, MonkeyEcxConfigsService, MonkeyEcxCookieStorageService, MonkeyEcxCoreModule, MonkeyEcxCoreService, MonkeyEcxCurrencyCodePipe, MonkeyEcxDatadogService, MonkeyEcxDiscoveryParamsService, MonkeyEcxDisplayFirstNamePipe, MonkeyEcxDisplayInitialsPipe, MonkeyEcxErrorMessageDirective, MonkeyEcxFeatureByProgramDirective, MonkeyEcxFeatureDirective, MonkeyEcxFeatureToggleService, MonkeyEcxFileCacheService, MonkeyEcxFormValidationService, MonkeyEcxFormatAddressPipe, MonkeyEcxFormatBeaufityJSONPipe, MonkeyEcxFormatCurrencyPipe, MonkeyEcxFormatDatePipe, MonkeyEcxFormatDocumentPipe, MonkeyEcxFormatDocumentTypePipe, MonkeyEcxFormatNumberPipe, MonkeyEcxFormatPhonePipe, MonkeyEcxFormatSizePipe, MonkeyEcxFormatTaxPipe, MonkeyEcxFormatValue, MonkeyEcxFormatZipCodePipe, MonkeyEcxI18nResolver, MonkeyEcxLinksModel, MonkeyEcxLoadingDirective, MonkeyEcxLocaleService, MonkeyEcxLoggedHandleService, MonkeyEcxLogs, MonkeyEcxModel, MonkeyEcxPipesModule, MonkeyEcxScheduleService, MonkeyEcxSecurityDirective, MonkeyEcxService, MonkeyEcxTextTruncatePipe, MonkeyEcxTokenStorageService, MonkeyEcxTruncateQtdPipe, MonkeyEcxUtils, MonkeyValidators, comboValidator, containsNumber, dateRangeValidator, dateStartEndValidator, dateValidator, differentFromZero, documentValidator, documentValidatorByType, emailValidator, injectTokenWithWarning, minYearsValidator, monkeyEcxHttpConfigInterceptor, passwordConfirmValidator, provideDomainServiceWorker, registerValidator, requiredWithTrimValidator, index as storage, index$1 as store, trueValidator, urlValidator, validateFullName, valueGreaterThanZero, zipCodeValidator };
+export { CACHE_LOCALE_EXPIRATION_MS, CountryMasks, LService, Link, MECX_ALPHA, MECX_BETA, MECX_BOOTSTRAP_SERVICE, MECX_CORE_I18N_WRAPPER, MECX_COUNTRY, MECX_DATE_FORMAT, MECX_FEDERATION, MECX_I18N_ALIAS, MECX_I18N_PATH, MECX_REDIRECT_LOGIN_WELCOMEBACK_STRATEGY, MECX_REFRESH_TOKEN_STRATEGY, MECX_REQUEST_ID, MECX_TIMEZONEOFFSET, MonkeyEcxAuthGuard, MonkeyEcxAuthGuardByRole, MonkeyEcxAuthGuardCompany, MonkeyEcxAuthGuardLogin, MonkeyEcxBaseResolver, MonkeyEcxBlobSecurePipe, MonkeyEcxCommonsActions, MonkeyEcxCommonsSelectors, MonkeyEcxCommonsStoreService, MonkeyEcxConfigsService, MonkeyEcxCookieStorageService, MonkeyEcxCoreModule, MonkeyEcxCoreService, MonkeyEcxCurrencyCodePipe, MonkeyEcxDatadogService, MonkeyEcxDiscoveryParamsService, MonkeyEcxDisplayFirstNamePipe, MonkeyEcxDisplayInitialsPipe, MonkeyEcxErrorMessageDirective, MonkeyEcxFeatureByProgramDirective, MonkeyEcxFeatureDirective, MonkeyEcxFeatureToggleService, MonkeyEcxFederationService, MonkeyEcxFileCacheService, MonkeyEcxFormValidationService, MonkeyEcxFormatAddressPipe, MonkeyEcxFormatBeaufityJSONPipe, MonkeyEcxFormatCurrencyPipe, MonkeyEcxFormatDatePipe, MonkeyEcxFormatDocumentPipe, MonkeyEcxFormatDocumentTypePipe, MonkeyEcxFormatNumberPipe, MonkeyEcxFormatPhonePipe, MonkeyEcxFormatSizePipe, MonkeyEcxFormatTaxPipe, MonkeyEcxFormatValue, MonkeyEcxFormatZipCodePipe, MonkeyEcxI18nResolver, MonkeyEcxLinksModel, MonkeyEcxLoadingDirective, MonkeyEcxLocaleService, MonkeyEcxLoggedHandleService, MonkeyEcxLogs, MonkeyEcxModel, MonkeyEcxPipesModule, MonkeyEcxScheduleService, MonkeyEcxSecurityDirective, MonkeyEcxService, MonkeyEcxTextTruncatePipe, MonkeyEcxTokenStorageService, MonkeyEcxTruncateQtdPipe, MonkeyEcxUtils, MonkeyValidators, comboValidator, containsNumber, dateRangeValidator, dateStartEndValidator, dateValidator, differentFromZero, documentValidator, documentValidatorByType, emailValidator, injectTokenWithWarning, minYearsValidator, monkeyEcxHttpConfigInterceptor, passwordConfirmValidator, provideMonkeyEcxDomainServiceWorker, provideMonkeyEcxFederation, registerValidator, requiredWithTrimValidator, index as storage, index$1 as store, trueValidator, urlValidator, validateFullName, valueGreaterThanZero, zipCodeValidator };
 //# sourceMappingURL=monkey-front-core.mjs.map