@arsedizioni/ars-utils 21.2.208 → 21.2.220

package/fesm2022/arsedizioni-ars-utils-ui.oauth.mjs

@@ -22,11 +22,11 @@ var LoginOAuthType;
 })(LoginOAuthType || (LoginOAuthType = {}));
 
 class ArsUIOAuthModule {
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: ArsUIOAuthModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
-    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.9", ngImport: i0, type: ArsUIOAuthModule }); }
-    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: ArsUIOAuthModule }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: ArsUIOAuthModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.10", ngImport: i0, type: ArsUIOAuthModule }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: ArsUIOAuthModule }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: ArsUIOAuthModule, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: ArsUIOAuthModule, decorators: [{
             type: NgModule
         }] });
 
@@ -66,17 +66,21 @@ class LoginOAuthComponent {
         this.msaLService = inject(MsalService);
         this.dialogService = inject(DialogService);
         this.ngZone = inject(NgZone);
+        /** Emitted when OAuth authentication succeeds. */
         this.success = output();
+        /** Whether to show the introductory info panel. */
         this.showInfo = input(true, ...(ngDevMode ? [{ debugName: "showInfo" }] : /* istanbul ignore next */ []));
+        /** Application name displayed in the info panel. */
         this.applicationName = input(...(ngDevMode ? [undefined, { debugName: "applicationName" }] : /* istanbul ignore next */ []));
+        /** Whether to trigger `initialize()` automatically on mount. */
         this.autoInitialize = input(false, ...(ngDevMode ? [{ debugName: "autoInitialize" }] : /* istanbul ignore next */ []));
+        /** Whether the Microsoft login button is shown. */
         this.allowMicrosoft = input(true, ...(ngDevMode ? [{ debugName: "allowMicrosoft" }] : /* istanbul ignore next */ []));
+        /** Whether the Google login button is shown. */
         this.allowGoogle = input(true, ...(ngDevMode ? [{ debugName: "allowGoogle" }] : /* istanbul ignore next */ []));
         this.oauthReady = signal(false, ...(ngDevMode ? [{ debugName: "oauthReady" }] : /* istanbul ignore next */ []));
         this.oauthMicrosoftReady = signal(false, ...(ngDevMode ? [{ debugName: "oauthMicrosoftReady" }] : /* istanbul ignore next */ []));
         this.oauthGoogleReady = signal(false, ...(ngDevMode ? [{ debugName: "oauthGoogleReady" }] : /* istanbul ignore next */ []));
-    }
-    ngOnInit() {
         if (this.autoInitialize()) {
             this.initialize();
         }
@@ -91,8 +95,9 @@ class LoginOAuthComponent {
         });
     }
     /**
-     * Initialize open authentication
-     * Must be a public method
+     * Initialize OAuth providers (Microsoft MSAL and Google GSI).
+     * Safe to call multiple times — already-initialized providers are skipped.
+     * Must be public so the host component can trigger it manually when `autoInitialize` is false.
      */
     initialize() {
         if (this.oauthMicrosoftReady() && this.oauthGoogleReady()) {
@@ -134,8 +139,8 @@ class LoginOAuthComponent {
         }
     }
     /**
-    * Perform login using MSAL
-    */
+     * Trigger a Microsoft (MSAL) login popup and acquire an access token on success.
+     */
     loginMSAL() {
         // Clear any in-progress interaction flag that may have been left by a previous incomplete popup
         sessionStorage.removeItem('msal.interaction.status');
@@ -170,14 +175,14 @@ class LoginOAuthComponent {
         });
     }
     /**
-  * Perform login using Google
-  */
+     * Trigger the hidden Google GSI button to open the Google sign-in flow.
+     */
     loginGoogle() {
         // Use wrapper click to prevent Illegal invocation exception
         googleButtonWrapper.click();
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: LoginOAuthComponent, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.9", type: LoginOAuthComponent, isStandalone: true, selector: "login-oauth", inputs: { showInfo: { classPropertyName: "showInfo", publicName: "showInfo", isSignal: true, isRequired: false, transformFunction: null }, applicationName: { classPropertyName: "applicationName", publicName: "applicationName", isSignal: true, isRequired: false, transformFunction: null }, autoInitialize: { classPropertyName: "autoInitialize", publicName: "autoInitialize", isSignal: true, isRequired: false, transformFunction: null }, allowMicrosoft: { classPropertyName: "allowMicrosoft", publicName: "allowMicrosoft", isSignal: true, isRequired: false, transformFunction: null }, allowGoogle: { classPropertyName: "allowGoogle", publicName: "allowGoogle", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { success: "success" }, providers: [
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: LoginOAuthComponent, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.10", type: LoginOAuthComponent, isStandalone: true, selector: "login-oauth", inputs: { showInfo: { classPropertyName: "showInfo", publicName: "showInfo", isSignal: true, isRequired: false, transformFunction: null }, applicationName: { classPropertyName: "applicationName", publicName: "applicationName", isSignal: true, isRequired: false, transformFunction: null }, autoInitialize: { classPropertyName: "autoInitialize", publicName: "autoInitialize", isSignal: true, isRequired: false, transformFunction: null }, allowMicrosoft: { classPropertyName: "allowMicrosoft", publicName: "allowMicrosoft", isSignal: true, isRequired: false, transformFunction: null }, allowGoogle: { classPropertyName: "allowGoogle", publicName: "allowGoogle", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { success: "success" }, providers: [
             {
                 provide: MSAL_INSTANCE,
                 deps: [EnvironmentService],
@@ -194,9 +199,9 @@ class LoginOAuthComponent {
             },
             MsalService,
             MsalBroadcastService
-        ], ngImport: i0, template: "<div class=\"login-oauth\">\r\n  @if(showInfo()) {\r\n  <div class=\"message\">\r\n    <p>Questa sezione consente di accedere al servizio utilizzando un provider OAuth2.</p>\r\n    @if(applicationName()) {\r\n    <p>La email utilizzata deve essere collegata ad un utente valido di {{applicationName()}} e dei servizi ad esso\r\n      connessi.</p>\r\n    }\r\n  </div>\r\n  }\r\n  @if (allowMicrosoft()) {\r\n  <div class=\"button\">\r\n    <button mat-flat-button  (click)=\"loginMSAL()\" [attr.aria-label]=\"'Effettua accesso'\"\r\n      [disabled]=\"!oauthMicrosoftReady()\" style=\"width: 100%;\">\r\n      Accedi con Microsoft</button>\r\n  </div>\r\n  }\r\n  @if (allowGoogle()) {\r\n  <div class=\"button\">\r\n    <button mat-flat-button  (click)=\"loginGoogle()\" style=\"width: 100%;\"\r\n      [attr.aria-label]=\"'Effettua accesso'\" [disabled]=\"!oauthGoogleReady()\">\r\n      Accedi con Google</button>\r\n  </div>\r\n  }\r\n</div>", styles: [".login-oauth{text-align:center}.login-oauth .button{padding:10px 0;width:100%}.login-oauth .message{padding:0 0 10px!important;font-size:small}\n"], dependencies: [{ kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i1.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
+        ], ngImport: i0, template: "<div class=\"login-oauth\">\r\n  @if(showInfo()) {\r\n  <div class=\"message\">\r\n    <p>Questa sezione consente di accedere al servizio utilizzando un provider OAuth2.</p>\r\n    @if(applicationName()) {\r\n    <p>La email utilizzata deve essere collegata ad un utente valido di {{applicationName()}} e dei servizi ad esso\r\n      connessi.</p>\r\n    }\r\n  </div>\r\n  }\r\n  @if (allowMicrosoft()) {\r\n  <div class=\"button\">\r\n    <button mat-flat-button  (click)=\"loginMSAL()\" aria-label=\"Effettua accesso\"\r\n      [disabled]=\"!oauthMicrosoftReady()\" style=\"width: 100%;\">\r\n      Accedi con Microsoft</button>\r\n  </div>\r\n  }\r\n  @if (allowGoogle()) {\r\n  <div class=\"button\">\r\n    <button mat-flat-button  (click)=\"loginGoogle()\" style=\"width: 100%;\"\r\n      aria-label=\"Effettua accesso\" [disabled]=\"!oauthGoogleReady()\">\r\n      Accedi con Google</button>\r\n  </div>\r\n  }\r\n</div>\r\n", styles: [".login-oauth{text-align:center}.login-oauth .button{padding:10px 0;width:100%}.login-oauth .message{padding:0 0 10px!important;font-size:small}\n"], dependencies: [{ kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i1.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: LoginOAuthComponent, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: LoginOAuthComponent, decorators: [{
             type: Component,
             args: [{ selector: 'login-oauth', standalone: true, changeDetection: ChangeDetectionStrategy.OnPush, providers: [
                         {
@@ -217,8 +222,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
                         MsalBroadcastService
                     ], imports: [
                         MatButtonModule
-                    ], template: "<div class=\"login-oauth\">\r\n  @if(showInfo()) {\r\n  <div class=\"message\">\r\n    <p>Questa sezione consente di accedere al servizio utilizzando un provider OAuth2.</p>\r\n    @if(applicationName()) {\r\n    <p>La email utilizzata deve essere collegata ad un utente valido di {{applicationName()}} e dei servizi ad esso\r\n      connessi.</p>\r\n    }\r\n  </div>\r\n  }\r\n  @if (allowMicrosoft()) {\r\n  <div class=\"button\">\r\n    <button mat-flat-button  (click)=\"loginMSAL()\" [attr.aria-label]=\"'Effettua accesso'\"\r\n      [disabled]=\"!oauthMicrosoftReady()\" style=\"width: 100%;\">\r\n      Accedi con Microsoft</button>\r\n  </div>\r\n  }\r\n  @if (allowGoogle()) {\r\n  <div class=\"button\">\r\n    <button mat-flat-button  (click)=\"loginGoogle()\" style=\"width: 100%;\"\r\n      [attr.aria-label]=\"'Effettua accesso'\" [disabled]=\"!oauthGoogleReady()\">\r\n      Accedi con Google</button>\r\n  </div>\r\n  }\r\n</div>", styles: [".login-oauth{text-align:center}.login-oauth .button{padding:10px 0;width:100%}.login-oauth .message{padding:0 0 10px!important;font-size:small}\n"] }]
-        }], propDecorators: { success: [{ type: i0.Output, args: ["success"] }], showInfo: [{ type: i0.Input, args: [{ isSignal: true, alias: "showInfo", required: false }] }], applicationName: [{ type: i0.Input, args: [{ isSignal: true, alias: "applicationName", required: false }] }], autoInitialize: [{ type: i0.Input, args: [{ isSignal: true, alias: "autoInitialize", required: false }] }], allowMicrosoft: [{ type: i0.Input, args: [{ isSignal: true, alias: "allowMicrosoft", required: false }] }], allowGoogle: [{ type: i0.Input, args: [{ isSignal: true, alias: "allowGoogle", required: false }] }] } });
+                    ], template: "<div class=\"login-oauth\">\r\n  @if(showInfo()) {\r\n  <div class=\"message\">\r\n    <p>Questa sezione consente di accedere al servizio utilizzando un provider OAuth2.</p>\r\n    @if(applicationName()) {\r\n    <p>La email utilizzata deve essere collegata ad un utente valido di {{applicationName()}} e dei servizi ad esso\r\n      connessi.</p>\r\n    }\r\n  </div>\r\n  }\r\n  @if (allowMicrosoft()) {\r\n  <div class=\"button\">\r\n    <button mat-flat-button  (click)=\"loginMSAL()\" aria-label=\"Effettua accesso\"\r\n      [disabled]=\"!oauthMicrosoftReady()\" style=\"width: 100%;\">\r\n      Accedi con Microsoft</button>\r\n  </div>\r\n  }\r\n  @if (allowGoogle()) {\r\n  <div class=\"button\">\r\n    <button mat-flat-button  (click)=\"loginGoogle()\" style=\"width: 100%;\"\r\n      aria-label=\"Effettua accesso\" [disabled]=\"!oauthGoogleReady()\">\r\n      Accedi con Google</button>\r\n  </div>\r\n  }\r\n</div>\r\n", styles: [".login-oauth{text-align:center}.login-oauth .button{padding:10px 0;width:100%}.login-oauth .message{padding:0 0 10px!important;font-size:small}\n"] }]
+        }], ctorParameters: () => [], propDecorators: { success: [{ type: i0.Output, args: ["success"] }], showInfo: [{ type: i0.Input, args: [{ isSignal: true, alias: "showInfo", required: false }] }], applicationName: [{ type: i0.Input, args: [{ isSignal: true, alias: "applicationName", required: false }] }], autoInitialize: [{ type: i0.Input, args: [{ isSignal: true, alias: "autoInitialize", required: false }] }], allowMicrosoft: [{ type: i0.Input, args: [{ isSignal: true, alias: "allowMicrosoft", required: false }] }], allowGoogle: [{ type: i0.Input, args: [{ isSignal: true, alias: "allowGoogle", required: false }] }] } });
 const createFakeGoogleWrapper = () => {
     const googleLoginWrapper = document.createElement("div");
     // Or you can simple hide it in CSS rule for custom-google-button
@@ -245,20 +250,19 @@ var googleButtonWrapper;
 
 class LoginOAuthOkMSComponent {
     constructor() {
-        this.message = input("Accesso in corso...", ...(ngDevMode ? [{ debugName: "message" }] : /* istanbul ignore next */ []));
-    }
-    ngOnInit() {
+        /** Message displayed while the popup is completing authentication. */
+        this.message = input('Accesso in corso...', ...(ngDevMode ? [{ debugName: "message" }] : /* istanbul ignore next */ []));
         // MSAL v5 popup flow: parse the auth response from the URL and send
         // it back to the opener window via BroadcastChannel, then close the popup.
         broadcastResponseToMainFrame();
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: LoginOAuthOkMSComponent, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.9", type: LoginOAuthOkMSComponent, isStandalone: true, selector: "app-login-oauth-ok-ms", inputs: { message: { classPropertyName: "message", publicName: "message", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: "<div fxLayout=\"column\" fxLayoutAlign=\"center center\" fxFill>\r\n  <div class=\"login-auto fade-in\">\r\n    <div class=\"message\">\r\n      Autenticazione in corso...\r\n    </div>\r\n    <mat-progress-bar mode=\"indeterminate\" color=\"primary\"></mat-progress-bar>\r\n  </div>\r\n</div>\r\n", styles: [".login-auto{padding:20px 0}.login-auto .message{font-size:large;font-weight:700;color:var(--ars-color-primary);max-width:300px;text-align:center;width:100%;padding:40px 0}\n"], dependencies: [{ kind: "ngmodule", type: FlexModule }, { kind: "directive", type: i1$1.DefaultLayoutDirective, selector: "  [fxLayout], [fxLayout.xs], [fxLayout.sm], [fxLayout.md],  [fxLayout.lg], [fxLayout.xl], [fxLayout.lt-sm], [fxLayout.lt-md],  [fxLayout.lt-lg], [fxLayout.lt-xl], [fxLayout.gt-xs], [fxLayout.gt-sm],  [fxLayout.gt-md], [fxLayout.gt-lg]", inputs: ["fxLayout", "fxLayout.xs", "fxLayout.sm", "fxLayout.md", "fxLayout.lg", "fxLayout.xl", "fxLayout.lt-sm", "fxLayout.lt-md", "fxLayout.lt-lg", "fxLayout.lt-xl", "fxLayout.gt-xs", "fxLayout.gt-sm", "fxLayout.gt-md", "fxLayout.gt-lg"] }, { kind: "directive", type: i1$1.DefaultLayoutAlignDirective, selector: "  [fxLayoutAlign], [fxLayoutAlign.xs], [fxLayoutAlign.sm], [fxLayoutAlign.md],  [fxLayoutAlign.lg], [fxLayoutAlign.xl], [fxLayoutAlign.lt-sm], [fxLayoutAlign.lt-md],  [fxLayoutAlign.lt-lg], [fxLayoutAlign.lt-xl], [fxLayoutAlign.gt-xs], [fxLayoutAlign.gt-sm],  [fxLayoutAlign.gt-md], [fxLayoutAlign.gt-lg]", inputs: ["fxLayoutAlign", "fxLayoutAlign.xs", "fxLayoutAlign.sm", "fxLayoutAlign.md", "fxLayoutAlign.lg", "fxLayoutAlign.xl", "fxLayoutAlign.lt-sm", "fxLayoutAlign.lt-md", "fxLayoutAlign.lt-lg", "fxLayoutAlign.lt-xl", "fxLayoutAlign.gt-xs", "fxLayoutAlign.gt-sm", "fxLayoutAlign.gt-md", "fxLayoutAlign.gt-lg"] }, { kind: "directive", type: i1$1.FlexFillDirective, selector: "[fxFill], [fxFlexFill]" }, { kind: "ngmodule", type: MatProgressBarModule }, { kind: "component", type: i2.MatProgressBar, selector: "mat-progress-bar", inputs: ["color", "value", "bufferValue", "mode"], outputs: ["animationEnd"], exportAs: ["matProgressBar"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: LoginOAuthOkMSComponent, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.10", type: LoginOAuthOkMSComponent, isStandalone: true, selector: "app-login-oauth-ok-ms", inputs: { message: { classPropertyName: "message", publicName: "message", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: "<div fxLayout=\"column\" fxLayoutAlign=\"center center\" fxFill>\r\n  <div class=\"login-auto fade-in\">\r\n    <div class=\"message\">\r\n      Autenticazione in corso...\r\n    </div>\r\n    <mat-progress-bar mode=\"indeterminate\" color=\"primary\"></mat-progress-bar>\r\n  </div>\r\n</div>\r\n", styles: [".login-auto{padding:20px 0}.login-auto .message{font-size:large;font-weight:700;color:var(--ars-color-primary);max-width:300px;text-align:center;width:100%;padding:40px 0}\n"], dependencies: [{ kind: "ngmodule", type: FlexModule }, { kind: "directive", type: i1$1.DefaultLayoutDirective, selector: "  [fxLayout], [fxLayout.xs], [fxLayout.sm], [fxLayout.md],  [fxLayout.lg], [fxLayout.xl], [fxLayout.lt-sm], [fxLayout.lt-md],  [fxLayout.lt-lg], [fxLayout.lt-xl], [fxLayout.gt-xs], [fxLayout.gt-sm],  [fxLayout.gt-md], [fxLayout.gt-lg]", inputs: ["fxLayout", "fxLayout.xs", "fxLayout.sm", "fxLayout.md", "fxLayout.lg", "fxLayout.xl", "fxLayout.lt-sm", "fxLayout.lt-md", "fxLayout.lt-lg", "fxLayout.lt-xl", "fxLayout.gt-xs", "fxLayout.gt-sm", "fxLayout.gt-md", "fxLayout.gt-lg"] }, { kind: "directive", type: i1$1.DefaultLayoutAlignDirective, selector: "  [fxLayoutAlign], [fxLayoutAlign.xs], [fxLayoutAlign.sm], [fxLayoutAlign.md],  [fxLayoutAlign.lg], [fxLayoutAlign.xl], [fxLayoutAlign.lt-sm], [fxLayoutAlign.lt-md],  [fxLayoutAlign.lt-lg], [fxLayoutAlign.lt-xl], [fxLayoutAlign.gt-xs], [fxLayoutAlign.gt-sm],  [fxLayoutAlign.gt-md], [fxLayoutAlign.gt-lg]", inputs: ["fxLayoutAlign", "fxLayoutAlign.xs", "fxLayoutAlign.sm", "fxLayoutAlign.md", "fxLayoutAlign.lg", "fxLayoutAlign.xl", "fxLayoutAlign.lt-sm", "fxLayoutAlign.lt-md", "fxLayoutAlign.lt-lg", "fxLayoutAlign.lt-xl", "fxLayoutAlign.gt-xs", "fxLayoutAlign.gt-sm", "fxLayoutAlign.gt-md", "fxLayoutAlign.gt-lg"] }, { kind: "directive", type: i1$1.FlexFillDirective, selector: "[fxFill], [fxFlexFill]" }, { kind: "ngmodule", type: MatProgressBarModule }, { kind: "component", type: i2.MatProgressBar, selector: "mat-progress-bar", inputs: ["color", "value", "bufferValue", "mode"], outputs: ["animationEnd"], exportAs: ["matProgressBar"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: LoginOAuthOkMSComponent, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: LoginOAuthOkMSComponent, decorators: [{
             type: Component,
             args: [{ selector: 'app-login-oauth-ok-ms', changeDetection: ChangeDetectionStrategy.OnPush, imports: [FlexModule, MatProgressBarModule], template: "<div fxLayout=\"column\" fxLayoutAlign=\"center center\" fxFill>\r\n  <div class=\"login-auto fade-in\">\r\n    <div class=\"message\">\r\n      Autenticazione in corso...\r\n    </div>\r\n    <mat-progress-bar mode=\"indeterminate\" color=\"primary\"></mat-progress-bar>\r\n  </div>\r\n</div>\r\n", styles: [".login-auto{padding:20px 0}.login-auto .message{font-size:large;font-weight:700;color:var(--ars-color-primary);max-width:300px;text-align:center;width:100%;padding:40px 0}\n"] }]
-        }], propDecorators: { message: [{ type: i0.Input, args: [{ isSignal: true, alias: "message", required: false }] }] } });
+        }], ctorParameters: () => [], propDecorators: { message: [{ type: i0.Input, args: [{ isSignal: true, alias: "message", required: false }] }] } });
 
 /*
  * Public API Surface of ars-utils

package/fesm2022/arsedizioni-ars-utils-ui.oauth.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"arsedizioni-ars-utils-ui.oauth.mjs","sources":["../../../projects/ars-utils/ui.oauth/ui/definitions.ts","../../../projects/ars-utils/ui.oauth/ui/ui.module.ts","../../../projects/ars-utils/ui.oauth/ui/components/login/login-oauth.component.ts","../../../projects/ars-utils/ui.oauth/ui/components/login/login-oauth.component.html","../../../projects/ars-utils/ui.oauth/ui/components/login-ok/ms/login-oauth-ok-ms.component.ts","../../../projects/ars-utils/ui.oauth/ui/components/login-ok/ms/login-oauth-ok-ms.component.html","../../../projects/ars-utils/ui.oauth/public_api.ts","../../../projects/ars-utils/ui.oauth/arsedizioni-ars-utils-ui.oauth.ts"],"sourcesContent":["export enum LoginOAuthType {\r\n  None = 0,\r\n  Microsoft = 1,\r\n  Google = 2\r\n}\r\n\r\nexport interface LoginOAuthResult {\r\n  type: number,\r\n  token: string\r\n}","import { NgModule } from \"@angular/core\";\r\n\r\n\r\n@NgModule()\r\nexport class ArsUIOAuthModule { }\r\n\r\nexport * from \"./definitions\";\r\n\r\n\r\n","import { ChangeDetectionStrategy, Component, DestroyRef, NgZone, OnInit, inject, input, output, signal } from '@angular/core';\r\nimport { takeUntilDestroyed } from '@angular/core/rxjs-interop';\r\nimport { MatButtonModule } from '@angular/material/button';\r\nimport { EnvironmentService } from '@arsedizioni/ars-utils/core';\r\nimport { DialogService } from '@arsedizioni/ars-utils/ui';\r\nimport { MSAL_GUARD_CONFIG, MSAL_INSTANCE, MSAL_INTERCEPTOR_CONFIG, MsalBroadcastService, MsalGuardConfiguration, MsalInterceptorConfiguration, MsalService } from '@azure/msal-angular';\r\nimport { AuthenticationResult, BrowserCacheLocation, EventMessage, EventType, IPublicClientApplication, InteractionType, PublicClientApplication } from '@azure/msal-browser';\r\nimport { filter } from 'rxjs';\r\nimport { LoginOAuthResult } from '../../definitions';\r\n\r\nexport function MSALInstanceFactory(environment: EnvironmentService): IPublicClientApplication {\r\n  return new PublicClientApplication({\r\n    auth: {\r\n      clientId: \"6b2c080f-6ab0-4511-a9df-0bce69db5833\",\r\n      authority: \"https://login.microsoftonline.com/common\",\r\n      redirectUri: environment.appLoginRedirectUri,\r\n    },\r\n    cache: {\r\n      cacheLocation: BrowserCacheLocation.LocalStorage\r\n    }\r\n  });\r\n}\r\n\r\nexport function MSALInterceptorConfigFactory(environment: EnvironmentService): MsalInterceptorConfiguration {\r\n\r\n  return {\r\n    interactionType: InteractionType.Popup,\r\n    protectedResourceMap: new Map([\r\n      [environment.appServiceLoginUri, [\"api://6b2c080f-6ab0-4511-a9df-0bce69db5833/AngularSPAAuthScope\"]],\r\n      [\"https://graph.microsoft.com/v2.0/me\", [\"user.read\"]],\r\n    ])\r\n  };\r\n}\r\n\r\nexport function MSALGuardConfigFactory(): MsalGuardConfiguration {\r\n  return {\r\n    interactionType: InteractionType.Popup,\r\n    authRequest: {\r\n      scopes: [\"user.read\"]\r\n    }\r\n  };\r\n}\r\n\r\n@Component({\r\n  selector: 'login-oauth',\r\n  templateUrl: './login-oauth.component.html',\r\n  styleUrls: ['./login-oauth.component.scss'],\r\n  standalone: true,\r\n  changeDetection: ChangeDetectionStrategy.OnPush,\r\n  providers: [\r\n    {\r\n      provide: MSAL_INSTANCE,\r\n      deps: [EnvironmentService],\r\n      useFactory: MSALInstanceFactory\r\n    },\r\n    {\r\n      provide: MSAL_GUARD_CONFIG,\r\n      useFactory: MSALGuardConfigFactory\r\n    },\r\n    {\r\n      provide: MSAL_INTERCEPTOR_CONFIG,\r\n      deps: [EnvironmentService],\r\n      useFactory: MSALInterceptorConfigFactory\r\n    },\r\n    MsalService,\r\n    MsalBroadcastService],\r\n  imports: [\r\n    MatButtonModule\r\n  ]\r\n})\r\nexport class LoginOAuthComponent implements OnInit {\r\n  private readonly destroyRef = inject(DestroyRef);\r\n  private msalBroadcastService = inject(MsalBroadcastService);\r\n  private msaLService = inject(MsalService);\r\n  private dialogService = inject(DialogService);\r\n  private ngZone = inject(NgZone);\r\n  readonly success = output<LoginOAuthResult>();\r\n  readonly showInfo = input<boolean>(true);\r\n  readonly applicationName = input<string>();\r\n  readonly autoInitialize = input<boolean>(false);\r\n  readonly allowMicrosoft = input<boolean>(true);\r\n  readonly allowGoogle = input<boolean>(true);\r\n  protected oauthReady = signal<boolean>(false);\r\n  protected oauthMicrosoftReady = signal<boolean>(false);\r\n  protected oauthGoogleReady = signal<boolean>(false);\r\n\r\n\r\n  ngOnInit() {\r\n    if (this.autoInitialize()) {\r\n      this.initialize();\r\n    }\r\n    this.msalBroadcastService.msalSubject$\r\n      .pipe(\r\n        filter((msg: EventMessage) =>\r\n          msg.eventType === EventType.LOGOUT_FAILURE ||\r\n          msg.eventType === EventType.ACQUIRE_TOKEN_FAILURE),\r\n        takeUntilDestroyed(this.destroyRef),\r\n      )\r\n      .subscribe((r: EventMessage) => {\r\n        if (r?.payload) {\r\n          const error = r.payload as any;\r\n          this.dialogService.error(error?.message ?? 'Errore di autenticazione Microsoft');\r\n        }\r\n      });\r\n\r\n  }\r\n\r\n  /**\r\n   * Initialize open authentication  \r\n   * Must be a public method \r\n   */\r\n  initialize() {\r\n    if (this.oauthMicrosoftReady() && this.oauthGoogleReady()) {\r\n      return; // Both already loaded\r\n    }\r\n    this.oauthReady.set(true);\r\n\r\n    // Load MS stack only if not already initialized\r\n    if (!this.oauthMicrosoftReady()) {\r\n      this.msaLService.initialize()\r\n        .pipe(takeUntilDestroyed(this.destroyRef))\r\n        .subscribe(() => {\r\n          this.oauthMicrosoftReady.set(true);\r\n        });\r\n    }\r\n\r\n    // Load Google script only if not already initialized\r\n    if (!this.oauthGoogleReady()) {\r\n      const DSLScript = document.createElement('script');\r\n      DSLScript.src = 'https://accounts.google.com/gsi/client';\r\n      DSLScript.type = 'text/javascript';\r\n      document.body.appendChild(DSLScript);\r\n      document.body.removeChild(DSLScript);\r\n\r\n      // @ts-ignore\r\n      window.onGoogleLibraryLoad = () => {\r\n        // initialize google account\r\n        // @ts-ignore\r\n        google.accounts.id.initialize({\r\n          client_id: '71204983077-ag31h3bgt2udcbfr9nn84r9rni2k3snp.apps.googleusercontent.com',\r\n          cancel_on_tap_outside: true,\r\n          auto_select: false,\r\n          callback: (r: any) => {\r\n            this.ngZone.run(() => {\r\n              this.success.emit({ type: 2, token: r.credential });\r\n            });\r\n          }\r\n        });\r\n\r\n        googleButtonWrapper = createFakeGoogleWrapper();\r\n\r\n        this.oauthGoogleReady.set(true);\r\n      };\r\n    }\r\n  }\r\n\r\n  /**\r\n  * Perform login using MSAL\r\n  */\r\n  protected loginMSAL() {\r\n    // Clear any in-progress interaction flag that may have been left by a previous incomplete popup\r\n    sessionStorage.removeItem('msal.interaction.status');\r\n\r\n    this.msaLService.loginPopup()\r\n      .pipe(takeUntilDestroyed(this.destroyRef))\r\n      .subscribe({\r\n        next: (r: AuthenticationResult) => {\r\n          try {\r\n            this.msaLService.instance.setActiveAccount(r.account);\r\n            this.msaLService.acquireTokenSilent({\r\n              scopes: [\r\n                \"api://6b2c080f-6ab0-4511-a9df-0bce69db5833/AngularSPAAuthScope\"\r\n              ],\r\n              account: r.account\r\n            }).subscribe({\r\n              next: (tokenResult: AuthenticationResult) => {\r\n                console.log(\"Token acquired!\");\r\n                this.success.emit({ type: 1, token: tokenResult.accessToken });\r\n              },\r\n              error: (error: any) => {\r\n                this.dialogService.error(error.message);\r\n              }\r\n            });\r\n          } catch (error: any) {\r\n            this.dialogService.error(error.message);\r\n          }\r\n        },\r\n        error: (error: any) => {\r\n          this.dialogService.error(error.message);\r\n        }\r\n      });\r\n  }\r\n\r\n  /**\r\n* Perform login using Google\r\n*/\r\n  protected loginGoogle() {\r\n    // Use wrapper click to prevent Illegal invocation exception\r\n    googleButtonWrapper.click();\r\n  }\r\n}\r\n\r\nconst createFakeGoogleWrapper = () => {\r\n  const googleLoginWrapper = document.createElement(\"div\");\r\n  // Or you can simple hide it in CSS rule for custom-google-button\r\n  googleLoginWrapper.style.display = \"none\";\r\n  googleLoginWrapper.classList.add(\"custom-google-button\");\r\n\r\n  // Add the wrapper to body\r\n  document.body.appendChild(googleLoginWrapper);\r\n\r\n  // Use GSI javascript api to render the button inside our wrapper\r\n  // You can ignore the properties because this button will not appear\r\n  // @ts-ignore\r\n  window.google.accounts.id.renderButton(googleLoginWrapper, {\r\n    type: \"icon\",\r\n    width: \"200\",\r\n  });\r\n\r\n  const googleLoginWrapperButton =\r\n    googleLoginWrapper.querySelector(\"div[role=button]\");\r\n\r\n  return {\r\n    click: () => {\r\n      // @ts-ignore\r\n      googleLoginWrapperButton.click();\r\n    },\r\n  };\r\n};\r\nvar googleButtonWrapper: any;\r\n\r\n","<div class=\"login-oauth\">\r\n  @if(showInfo()) {\r\n  <div class=\"message\">\r\n    <p>Questa sezione consente di accedere al servizio utilizzando un provider OAuth2.</p>\r\n    @if(applicationName()) {\r\n    <p>La email utilizzata deve essere collegata ad un utente valido di {{applicationName()}} e dei servizi ad esso\r\n      connessi.</p>\r\n    }\r\n  </div>\r\n  }\r\n  @if (allowMicrosoft()) {\r\n  <div class=\"button\">\r\n    <button mat-flat-button  (click)=\"loginMSAL()\" [attr.aria-label]=\"'Effettua accesso'\"\r\n      [disabled]=\"!oauthMicrosoftReady()\" style=\"width: 100%;\">\r\n      Accedi con Microsoft</button>\r\n  </div>\r\n  }\r\n  @if (allowGoogle()) {\r\n  <div class=\"button\">\r\n    <button mat-flat-button  (click)=\"loginGoogle()\" style=\"width: 100%;\"\r\n      [attr.aria-label]=\"'Effettua accesso'\" [disabled]=\"!oauthGoogleReady()\">\r\n      Accedi con Google</button>\r\n  </div>\r\n  }\r\n</div>","import { ChangeDetectionStrategy, Component, OnInit, input } from '@angular/core';\r\nimport { broadcastResponseToMainFrame } from '@azure/msal-browser/redirect-bridge';\r\nimport { FlexModule } from '@ngbracket/ngx-layout/flex';\r\nimport { MatProgressBarModule } from '@angular/material/progress-bar';\r\n\r\n\r\n@Component({\r\n    selector: 'app-login-oauth-ok-ms',\r\n    styleUrls: ['./login-oauth-ok-ms.component.scss'],\r\n    templateUrl: './login-oauth-ok-ms.component.html',\r\n    changeDetection: ChangeDetectionStrategy.OnPush,\r\n    imports: [FlexModule, MatProgressBarModule]\r\n})\r\nexport class LoginOAuthOkMSComponent implements OnInit {\r\n\r\n    readonly message = input<string>(\"Accesso in corso...\");\r\n\r\n    ngOnInit() {\r\n        // MSAL v5 popup flow: parse the auth response from the URL and send\r\n        // it back to the opener window via BroadcastChannel, then close the popup.\r\n        broadcastResponseToMainFrame();\r\n    }\r\n}\r\n","<div fxLayout=\"column\" fxLayoutAlign=\"center center\" fxFill>\r\n  <div class=\"login-auto fade-in\">\r\n    <div class=\"message\">\r\n      Autenticazione in corso...\r\n    </div>\r\n    <mat-progress-bar mode=\"indeterminate\" color=\"primary\"></mat-progress-bar>\r\n  </div>\r\n</div>\r\n","/*\r\n * Public API Surface of ars-utils\r\n */\r\nexport * from './ui/ui.module';\r\nexport * from './ui/components/login/login-oauth.component';\r\nexport * from './ui/components/login-ok/ms/login-oauth-ok-ms.component';\r\n\r\n\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public_api';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"arsedizioni-ars-utils-ui.oauth.mjs","sources":["../../../projects/ars-utils/ui.oauth/ui/definitions.ts","../../../projects/ars-utils/ui.oauth/ui/ui.module.ts","../../../projects/ars-utils/ui.oauth/ui/components/login/login-oauth.component.ts","../../../projects/ars-utils/ui.oauth/ui/components/login/login-oauth.component.html","../../../projects/ars-utils/ui.oauth/ui/components/login-ok/ms/login-oauth-ok-ms.component.ts","../../../projects/ars-utils/ui.oauth/ui/components/login-ok/ms/login-oauth-ok-ms.component.html","../../../projects/ars-utils/ui.oauth/public_api.ts","../../../projects/ars-utils/ui.oauth/arsedizioni-ars-utils-ui.oauth.ts"],"sourcesContent":["export enum LoginOAuthType {\r\n  None = 0,\r\n  Microsoft = 1,\r\n  Google = 2\r\n}\r\n\r\nexport interface LoginOAuthResult {\r\n  type: number,\r\n  token: string\r\n}","import { NgModule } from \"@angular/core\";\r\n\r\n\r\n@NgModule()\r\nexport class ArsUIOAuthModule { }\r\n\r\nexport * from \"./definitions\";\r\n\r\n\r\n","import { ChangeDetectionStrategy, Component, DestroyRef, NgZone, inject, input, output, signal } from '@angular/core';\r\nimport { takeUntilDestroyed } from '@angular/core/rxjs-interop';\r\nimport { MatButtonModule } from '@angular/material/button';\r\nimport { EnvironmentService } from '@arsedizioni/ars-utils/core';\r\nimport { DialogService } from '@arsedizioni/ars-utils/ui';\r\nimport { MSAL_GUARD_CONFIG, MSAL_INSTANCE, MSAL_INTERCEPTOR_CONFIG, MsalBroadcastService, MsalGuardConfiguration, MsalInterceptorConfiguration, MsalService } from '@azure/msal-angular';\r\nimport { AuthenticationResult, BrowserCacheLocation, EventMessage, EventType, IPublicClientApplication, InteractionType, PublicClientApplication } from '@azure/msal-browser';\r\nimport { filter } from 'rxjs';\r\nimport { LoginOAuthResult } from '../../definitions';\r\n\r\nexport function MSALInstanceFactory(environment: EnvironmentService): IPublicClientApplication {\r\n  return new PublicClientApplication({\r\n    auth: {\r\n      clientId: \"6b2c080f-6ab0-4511-a9df-0bce69db5833\",\r\n      authority: \"https://login.microsoftonline.com/common\",\r\n      redirectUri: environment.appLoginRedirectUri,\r\n    },\r\n    cache: {\r\n      cacheLocation: BrowserCacheLocation.LocalStorage\r\n    }\r\n  });\r\n}\r\n\r\nexport function MSALInterceptorConfigFactory(environment: EnvironmentService): MsalInterceptorConfiguration {\r\n\r\n  return {\r\n    interactionType: InteractionType.Popup,\r\n    protectedResourceMap: new Map([\r\n      [environment.appServiceLoginUri, [\"api://6b2c080f-6ab0-4511-a9df-0bce69db5833/AngularSPAAuthScope\"]],\r\n      [\"https://graph.microsoft.com/v2.0/me\", [\"user.read\"]],\r\n    ])\r\n  };\r\n}\r\n\r\nexport function MSALGuardConfigFactory(): MsalGuardConfiguration {\r\n  return {\r\n    interactionType: InteractionType.Popup,\r\n    authRequest: {\r\n      scopes: [\"user.read\"]\r\n    }\r\n  };\r\n}\r\n\r\n@Component({\r\n  selector: 'login-oauth',\r\n  templateUrl: './login-oauth.component.html',\r\n  styleUrls: ['./login-oauth.component.scss'],\r\n  standalone: true,\r\n  changeDetection: ChangeDetectionStrategy.OnPush,\r\n  providers: [\r\n    {\r\n      provide: MSAL_INSTANCE,\r\n      deps: [EnvironmentService],\r\n      useFactory: MSALInstanceFactory\r\n    },\r\n    {\r\n      provide: MSAL_GUARD_CONFIG,\r\n      useFactory: MSALGuardConfigFactory\r\n    },\r\n    {\r\n      provide: MSAL_INTERCEPTOR_CONFIG,\r\n      deps: [EnvironmentService],\r\n      useFactory: MSALInterceptorConfigFactory\r\n    },\r\n    MsalService,\r\n    MsalBroadcastService],\r\n  imports: [\r\n    MatButtonModule\r\n  ]\r\n})\r\nexport class LoginOAuthComponent {\r\n  private readonly destroyRef = inject(DestroyRef);\r\n  private readonly msalBroadcastService = inject(MsalBroadcastService);\r\n  private readonly msaLService = inject(MsalService);\r\n  private readonly dialogService = inject(DialogService);\r\n  private readonly ngZone = inject(NgZone);\r\n  /** Emitted when OAuth authentication succeeds. */\r\n  readonly success = output<LoginOAuthResult>();\r\n  /** Whether to show the introductory info panel. */\r\n  readonly showInfo = input<boolean>(true);\r\n  /** Application name displayed in the info panel. */\r\n  readonly applicationName = input<string>();\r\n  /** Whether to trigger `initialize()` automatically on mount. */\r\n  readonly autoInitialize = input<boolean>(false);\r\n  /** Whether the Microsoft login button is shown. */\r\n  readonly allowMicrosoft = input<boolean>(true);\r\n  /** Whether the Google login button is shown. */\r\n  readonly allowGoogle = input<boolean>(true);\r\n  protected readonly oauthReady = signal<boolean>(false);\r\n  protected readonly oauthMicrosoftReady = signal<boolean>(false);\r\n  protected readonly oauthGoogleReady = signal<boolean>(false);\r\n\r\n  constructor() {\r\n    if (this.autoInitialize()) {\r\n      this.initialize();\r\n    }\r\n    this.msalBroadcastService.msalSubject$\r\n      .pipe(\r\n        filter((msg: EventMessage) =>\r\n          msg.eventType === EventType.LOGOUT_FAILURE ||\r\n          msg.eventType === EventType.ACQUIRE_TOKEN_FAILURE),\r\n        takeUntilDestroyed(this.destroyRef),\r\n      )\r\n      .subscribe((r: EventMessage) => {\r\n        if (r?.payload) {\r\n          const error = r.payload as any;\r\n          this.dialogService.error(error?.message ?? 'Errore di autenticazione Microsoft');\r\n        }\r\n      });\r\n  }\r\n\r\n  /**\r\n   * Initialize OAuth providers (Microsoft MSAL and Google GSI).\r\n   * Safe to call multiple times — already-initialized providers are skipped.\r\n   * Must be public so the host component can trigger it manually when `autoInitialize` is false.\r\n   */\r\n  initialize() {\r\n    if (this.oauthMicrosoftReady() && this.oauthGoogleReady()) {\r\n      return; // Both already loaded\r\n    }\r\n    this.oauthReady.set(true);\r\n\r\n    // Load MS stack only if not already initialized\r\n    if (!this.oauthMicrosoftReady()) {\r\n      this.msaLService.initialize()\r\n        .pipe(takeUntilDestroyed(this.destroyRef))\r\n        .subscribe(() => {\r\n          this.oauthMicrosoftReady.set(true);\r\n        });\r\n    }\r\n\r\n    // Load Google script only if not already initialized\r\n    if (!this.oauthGoogleReady()) {\r\n      const DSLScript = document.createElement('script');\r\n      DSLScript.src = 'https://accounts.google.com/gsi/client';\r\n      DSLScript.type = 'text/javascript';\r\n      document.body.appendChild(DSLScript);\r\n      document.body.removeChild(DSLScript);\r\n\r\n      // @ts-ignore\r\n      window.onGoogleLibraryLoad = () => {\r\n        // initialize google account\r\n        // @ts-ignore\r\n        google.accounts.id.initialize({\r\n          client_id: '71204983077-ag31h3bgt2udcbfr9nn84r9rni2k3snp.apps.googleusercontent.com',\r\n          cancel_on_tap_outside: true,\r\n          auto_select: false,\r\n          callback: (r: any) => {\r\n            this.ngZone.run(() => {\r\n              this.success.emit({ type: 2, token: r.credential });\r\n            });\r\n          }\r\n        });\r\n\r\n        googleButtonWrapper = createFakeGoogleWrapper();\r\n\r\n        this.oauthGoogleReady.set(true);\r\n      };\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Trigger a Microsoft (MSAL) login popup and acquire an access token on success.\r\n   */\r\n  protected loginMSAL() {\r\n    // Clear any in-progress interaction flag that may have been left by a previous incomplete popup\r\n    sessionStorage.removeItem('msal.interaction.status');\r\n\r\n    this.msaLService.loginPopup()\r\n      .pipe(takeUntilDestroyed(this.destroyRef))\r\n      .subscribe({\r\n        next: (r: AuthenticationResult) => {\r\n          try {\r\n            this.msaLService.instance.setActiveAccount(r.account);\r\n            this.msaLService.acquireTokenSilent({\r\n              scopes: [\r\n                \"api://6b2c080f-6ab0-4511-a9df-0bce69db5833/AngularSPAAuthScope\"\r\n              ],\r\n              account: r.account\r\n            }).subscribe({\r\n              next: (tokenResult: AuthenticationResult) => {\r\n                console.log(\"Token acquired!\");\r\n                this.success.emit({ type: 1, token: tokenResult.accessToken });\r\n              },\r\n              error: (error: any) => {\r\n                this.dialogService.error(error.message);\r\n              }\r\n            });\r\n          } catch (error: any) {\r\n            this.dialogService.error(error.message);\r\n          }\r\n        },\r\n        error: (error: any) => {\r\n          this.dialogService.error(error.message);\r\n        }\r\n      });\r\n  }\r\n\r\n  /**\r\n   * Trigger the hidden Google GSI button to open the Google sign-in flow.\r\n   */\r\n  protected loginGoogle() {\r\n    // Use wrapper click to prevent Illegal invocation exception\r\n    googleButtonWrapper.click();\r\n  }\r\n}\r\n\r\nconst createFakeGoogleWrapper = () => {\r\n  const googleLoginWrapper = document.createElement(\"div\");\r\n  // Or you can simple hide it in CSS rule for custom-google-button\r\n  googleLoginWrapper.style.display = \"none\";\r\n  googleLoginWrapper.classList.add(\"custom-google-button\");\r\n\r\n  // Add the wrapper to body\r\n  document.body.appendChild(googleLoginWrapper);\r\n\r\n  // Use GSI javascript api to render the button inside our wrapper\r\n  // You can ignore the properties because this button will not appear\r\n  // @ts-ignore\r\n  window.google.accounts.id.renderButton(googleLoginWrapper, {\r\n    type: \"icon\",\r\n    width: \"200\",\r\n  });\r\n\r\n  const googleLoginWrapperButton =\r\n    googleLoginWrapper.querySelector(\"div[role=button]\");\r\n\r\n  return {\r\n    click: () => {\r\n      // @ts-ignore\r\n      googleLoginWrapperButton.click();\r\n    },\r\n  };\r\n};\r\nvar googleButtonWrapper: any;\r\n\r\n","<div class=\"login-oauth\">\r\n  @if(showInfo()) {\r\n  <div class=\"message\">\r\n    <p>Questa sezione consente di accedere al servizio utilizzando un provider OAuth2.</p>\r\n    @if(applicationName()) {\r\n    <p>La email utilizzata deve essere collegata ad un utente valido di {{applicationName()}} e dei servizi ad esso\r\n      connessi.</p>\r\n    }\r\n  </div>\r\n  }\r\n  @if (allowMicrosoft()) {\r\n  <div class=\"button\">\r\n    <button mat-flat-button  (click)=\"loginMSAL()\" aria-label=\"Effettua accesso\"\r\n      [disabled]=\"!oauthMicrosoftReady()\" style=\"width: 100%;\">\r\n      Accedi con Microsoft</button>\r\n  </div>\r\n  }\r\n  @if (allowGoogle()) {\r\n  <div class=\"button\">\r\n    <button mat-flat-button  (click)=\"loginGoogle()\" style=\"width: 100%;\"\r\n      aria-label=\"Effettua accesso\" [disabled]=\"!oauthGoogleReady()\">\r\n      Accedi con Google</button>\r\n  </div>\r\n  }\r\n</div>\r\n","import { ChangeDetectionStrategy, Component, input } from '@angular/core';\r\nimport { broadcastResponseToMainFrame } from '@azure/msal-browser/redirect-bridge';\r\nimport { FlexModule } from '@ngbracket/ngx-layout/flex';\r\nimport { MatProgressBarModule } from '@angular/material/progress-bar';\r\n\r\n\r\n@Component({\r\n    selector: 'app-login-oauth-ok-ms',\r\n    styleUrls: ['./login-oauth-ok-ms.component.scss'],\r\n    templateUrl: './login-oauth-ok-ms.component.html',\r\n    changeDetection: ChangeDetectionStrategy.OnPush,\r\n    imports: [FlexModule, MatProgressBarModule]\r\n})\r\nexport class LoginOAuthOkMSComponent {\r\n\r\n    /** Message displayed while the popup is completing authentication. */\r\n    readonly message = input<string>('Accesso in corso...');\r\n\r\n    constructor() {\r\n        // MSAL v5 popup flow: parse the auth response from the URL and send\r\n        // it back to the opener window via BroadcastChannel, then close the popup.\r\n        broadcastResponseToMainFrame();\r\n    }\r\n}\r\n","<div fxLayout=\"column\" fxLayoutAlign=\"center center\" fxFill>\r\n  <div class=\"login-auto fade-in\">\r\n    <div class=\"message\">\r\n      Autenticazione in corso...\r\n    </div>\r\n    <mat-progress-bar mode=\"indeterminate\" color=\"primary\"></mat-progress-bar>\r\n  </div>\r\n</div>\r\n","/*\r\n * Public API Surface of ars-utils\r\n */\r\nexport * from './ui/ui.module';\r\nexport * from './ui/components/login/login-oauth.component';\r\nexport * from './ui/components/login-ok/ms/login-oauth-ok-ms.component';\r\n\r\n\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public_api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arsedizioni/ars-utils",
-  "version": "21.2.208",
+  "version": "21.2.220",
   "author": {
     "email": "software@arsedizioni.it",
     "name": "Fabio Buscaroli, Alberto Doria"

package/types/arsedizioni-ars-utils-clipper.common.d.ts

@@ -168,15 +168,15 @@ declare class ClipperChannelSettings {
     sectors: ClipperChannelSettingsItem<string>[];
     regions: ClipperChannelSettingsItem<string>[];
     /**
-     * Check at least one of sector values is contained in sectors list
-     * @param values : the admitted values
-     * @returns true if at least one value has been found
+     * Returns `true` when the channel is active and at least one of the given sector codes
+     * matches a sector assigned to this channel.
+     * @param values - Array of sector code strings to test against.
      */
     hasAnyOfSectors(values: string[]): boolean;
     /**
-     * Check at least one of region values is contained in regions list
-     * @param values : the admitted values
-     * @returns true if at least one value has been found
+     * Returns `true` when the channel is active and at least one of the given region codes
+     * matches a region assigned to this channel.
+     * @param values - Array of region code strings to test against.
      */
     hasAnyOfRegions(values: string[]): boolean;
 }
@@ -663,24 +663,25 @@ declare class ClipperDashboard {
     unreadItems: Signal<[ClipperModule, number][]>;
     unreadItemsByModel: Signal<[ClipperModel, number][]>;
     /**
-     * Update unread items
-     * @param module : the module
-     * @param model : the optional model
-     * @param increment : the increment (can be negative)
+     * Increments (or decrements) the unread item counter for the given module or model.
+     * Triggers a signal update so computed values and templates react to the change.
+     * @param module    - The `ClipperModule` whose counter should be adjusted.
+     * @param model     - Optional `ClipperModel` for sub-module granularity.
+     * @param increment - Amount to add (use a negative value to decrement).
      */
     updateUnreadItems(module: ClipperModule, model: ClipperModel | undefined, increment: number): void;
-    /***
-     * Get the module unread items
-     * @param module: the module
-     * @param model : the optional model
-     * @returns the module unread items
+    /**
+     * Returns the unread-item count for the given module, or for a specific model within it.
+     * @param module - The `ClipperModule` to query.
+     * @param model  - Optional `ClipperModel` for sub-module granularity.
+     * @returns Number of unread items, or `0` when none are found.
      */
     getUnreadItems(module: ClipperModule, model?: ClipperModel): number;
     /**
-     * Return total unread items
-     * @returns : the total unread items
+     * Returns the sum of unread items across all tracked modules.
+     * @returns Total unread-item count.
      */
-    gatTotalUnreadItems(): number;
+    getTotalUnreadItems(): number;
 }
 interface ClipperDayItem {
     day: string;
@@ -987,95 +988,120 @@ interface ClipperArchiveFilesDeleteParams {
 }
 declare class ClipperUtils {
     /**
-     * Check if a model is readable
-     * @param model : the model to check
-     * @returns : true if the model is readable
+     * Returns `true` when the given model corresponds to a readable document type
+     * (i.e., can be opened in the document viewer).
+     * @param model - The `ClipperModel` to test.
      */
     static isClipperModelReadable(model: ClipperModel): boolean;
     /**
-     * Return the Clipper module from a document
-     * @param item: the documenti item
-     * @returns the module id
+     * Returns the `ClipperModule` that owns the given document, derived from its model type.
+     * @param item - The document info object to inspect.
+     * @returns The matching `ClipperModule`, or `undefined` when the model has no direct module mapping.
      */
     static getClipperModuleFromModel(item: ClipperDocumentInfo): ClipperModule | undefined;
     /**
-     * Return the Clipper group name
-     * @param value: the group value
-     * @returns the group name
+     * Returns the display name for the given `ClipperModuleGroup`.
+     * @param value - The module group enum value to look up.
+     * @returns The group display name, or an empty string when not found.
      */
     static getClipperModuleGroupName(value: ClipperModuleGroup): string;
     /**
-     * Return the list of modules of a group
-     * @param value: the module name
-     * @returns the list of modules
+     * Returns the list of `ClipperModule` items belonging to the given module group.
+     * @param value - The module group to filter by.
+     * @returns Array of matching `NameValueItem` entries.
      */
     static getClipperModuleGroupItems(value: ClipperModuleGroup): NameValueItem<ClipperModule>[];
     /**
-     * Check modules against current selected in filter
-     * @param modules : the modules to check for
-     * @param mode : thc check mode: 1) exactly all elements 2) all elements 3) any of the elements specified
-     * @returns true if the check is successfull
+     * Tests a set of modules against the currently selected modules in the search filter.
+     * @param modules        - The modules to test.
+     * @param currentModules - The currently selected modules to check against.
+     * @param mode           - Matching strategy:
+     *   `1` = all and only the specified modules (exact set),
+     *   `2` = all specified modules must be present,
+     *   `3` = at least one specified module must be present.
+     * @returns `true` when the condition defined by `mode` is satisfied.
      */
     private static checkModules;
     /**
-     * Return the list of available sort options for a list of modules
-     * @param modules : the modules list
-     * @returns the list of availbale sort options
+     * Returns the sort options available for the given module selection.
+     * Includes the relevance option only when the query contains free text.
+     * @param modules - Currently selected modules (used to determine which date axes are available).
+     * @param params  - Current search params (checked for free-text content).
+     * @returns Array of applicable `NameValueItem<ClipperSort>` sort options.
      */
     static getClipperAvailableSortOptions(modules?: NameValueItem<ClipperModule>[], params?: ClipperSearchParams): NameValueItem<ClipperSort>[];
 }
 declare class ClipperSearchUtils {
     /**
-     * Clear the search params object
-     * @param params : the search params to clear
+     * Resets all filter fields of a `ClipperSearchParams` instance to their default (empty) values.
+     * @param params - The search-params object to clear.
      */
     static clear(params: ClipperSearchParams): void;
     /**
-     * Get hte model list related to a list of modules
-     * @param modules: the modules to check
-     * @returns the list fo models
+     * Returns the list of `ClipperModel` values that correspond to the given modules.
+     * @param modules - The selected modules to map to their underlying data models.
+     * @returns Array of `ClipperModel` values matching the provided modules.
      */
     static getModulesModels(modules?: NameValueItem<ClipperModule>[]): ClipperModel[];
     /**
-     * Check if current filter is a text based search
-     * @param params : the search params to check
-     * @returns true if is a text based search
+     * Returns `true` when the search params contain a non-empty free-text query.
+     * @param params - The search params to inspect.
      */
     static isTextQuery(params: ClipperSearchParams): boolean;
     /**
-     * Try to add a query
-     * @param q : the new query
-     * @param queries : the new query
-            */
+     * Wraps `q` in quotes (if not already quoted) and appends it to `queries`.
+     * @param q       - A single search term to process.
+     * @param queries - The accumulated query string to append to.
+     * @returns The updated `queries` string.
+     */
     private static concatTextQuery;
     /**
-     * Normalize text query
-     * @param text : the text query to normalize
-     * @returns : the text normalized or undefined
+     * Normalises a comma-separated search string by wrapping each term in quotes.
+     * @param text - The raw search input to normalise.
+     * @returns The normalised query string, or `undefined` when `text` is empty.
      */
     static normalizeTextQuery(text: string): string | undefined;
     /**
-     * Normalize text query 2: adds quotes at the beginning and end of the text
-     * only if there are no quoted elements, no '+', and no ' -' (space followed by minus)
-     * @param text : the text to normalize
-     * @returns : the normalized text
+     * Wraps the entire query in double quotes when it contains no boolean operators
+     * (`"`, `+`, or ` -`), making it an exact-phrase search.
+     * @param text - The query string to normalise.
+     * @returns The normalised query string.
      */
     static normalizeTextQuery2(text: string): string;
     /**
-     * Return a rank number from a char value (A, B, C)
-     * @param value : the char value
-     * @returns the rank number (A = 0.71, B = 0.61, C = 0.51)
+     * Maps a letter rank (`A`, `B`, or any other) to a numeric relevance threshold.
+     * @param value - The single-character rank string.
+     * @returns `0.751` for `'A'`, `0.71` for `'B'`, `0.51` for anything else.
      */
     static getRankFromChar(value: string): number;
 }
 
 declare const PropertiesColors: NameValueItem<string>[];
 
+/**
+ * HTTP interceptor that attaches Clipper authentication headers to every request
+ * targeting the Clipper service, and broadcasts user-friendly error messages
+ * when the server returns an error response.
+ */
 declare class ClipperAuthInterceptor implements HttpInterceptor {
-    private clipperService;
-    private broadcastService;
+    private readonly clipperService;
+    private readonly broadcastService;
     private lastErrorTime;
-    intercept(request: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>>;
+    /**
+     * Intercepts every outgoing HTTP request.
+     * When the request targets the Clipper service URI, attaches credentials and
+     * a client-ID header, then pipes the response through an error handler.
+     * @param request - The outgoing HTTP request.
+     * @param next    - The next handler in the interceptor chain.
+     * @returns An observable of the HTTP event stream.
+     */
+    intercept(request: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>>;
+    /**
+     * Processes an HTTP error, broadcasting a user-friendly message when appropriate.
+     * Errors are debounced: only one message is sent per `ERROR_DEBOUNCE_MS` window.
+     * @param error - The raw error value thrown by the HTTP layer.
+     */
+    private handleError;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperAuthInterceptor, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ClipperAuthInterceptor>;
 }

package/types/arsedizioni-ars-utils-clipper.ui.d.ts

@@ -1133,7 +1133,7 @@ declare class ClipperDocumentMenuComponent {
     /** Internal counter incremented on each external selection-model change to drive signal re-evaluation. */
     private readonly selectionChangeTick;
     readonly useSelections: _angular_core.InputSignal<boolean>;
-    readonly selectionSource: _angular_core.InputSignal<"selection" | "bag" | "none">;
+    readonly selectionSource: _angular_core.InputSignal<"none" | "selection" | "bag">;
     /**
      * Computed signal that returns the current effective document selection.
      * Re-evaluates when any input signal or the underlying selection model changes.

package/types/arsedizioni-ars-utils-core.d.ts

@@ -400,7 +400,7 @@ declare class SystemUtils {
      * @param locale    : the locale to use (default is IT)
      * @returns         : the formatted string
      */
-    static formatDate(value?: Date | string, fmt?: DateFormat | string, locale?: Locale): string | undefined;
+    static formatDate(value?: Date | string, fmt?: DateFormat | string, locale?: Locale): string;
     /**
      * Return an italian local date
      * @param value  : the date