@masterteam/delegations 0.0.38 → 0.0.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masterteam/delegations",
-  "version": "0.0.38",
+  "version": "0.0.39",
   "publishConfig": {
     "directory": "../../../dist/masterteam/delegations",
     "linkDirectory": false,
@@ -20,9 +20,9 @@
     "tailwindcss": "^4.2.2",
     "tailwindcss-primeui": "^0.6.1",
     "@ngxs/store": "^20.1.0",
-    "@masterteam/forms": "^0.0.81",
+    "@masterteam/components": "^0.0.179",
     "@masterteam/icons": "^0.0.15",
-    "@masterteam/components": "^0.0.179"
+    "@masterteam/forms": "^0.0.81"
   },
   "sideEffects": false,
   "exports": {

package/types/masterteam-delegations.d.ts

@@ -1,6 +1,6 @@
 import * as _masterteam_delegations from '@masterteam/delegations';
 import * as _angular_core from '@angular/core';
-import { OnInit } from '@angular/core';
+import { OnInit, InjectionToken } from '@angular/core';
 import { Popover } from 'primeng/popover';
 import * as _masterteam_components_entities from '@masterteam/components/entities';
 import { EntityUserValue } from '@masterteam/components/entities';
@@ -390,10 +390,9 @@ declare class TopbarDelegationMenu implements OnInit {
     readonly showManageLink: _angular_core.InputSignal<boolean>;
     readonly promptOnCandidates: _angular_core.InputSignal<boolean>;
     /**
-     * Suppress the *candidates* trigger (surface them elsewhere, e.g. the user
-     * dropdown via {@link DelegationMenuPanel}) while keeping candidate loading +
-     * the post-login prompt. The *active* "Acting on behalf of" pill stays visible
-     * even when headless — an active delegated session must always be obvious.
+     * Render no topbar UI at all (controller only) while keeping candidate
+     * loading + the post-login prompt. Use when the menu is surfaced elsewhere —
+     * e.g. embedded in the user-avatar dropdown via {@link DelegationMenuPanel}.
      */
     readonly headless: _angular_core.InputSignal<boolean>;
     private readonly facade;
@@ -405,7 +404,8 @@ declare class TopbarDelegationMenu implements OnInit {
     protected readonly hasCandidates: _angular_core.Signal<boolean>;
     protected readonly onBehalfOf: _angular_core.Signal<_masterteam_delegations.DelegationParty | null>;
     protected readonly executedBy: _angular_core.Signal<_masterteam_delegations.DelegationParty | null>;
-    private readonly promptShown;
+    /** Per-instance guard; the persisted `facade.prompted()` guards across refresh. */
+    private localPrompted;
     protected readonly mode: _angular_core.Signal<"active" | "candidates" | "hidden">;
     constructor();
     ngOnInit(): void;
@@ -1048,6 +1048,12 @@ declare enum DelegationSessionActionKey {
 interface DelegationSessionStateModel extends LoadingStateShape<DelegationSessionActionKey> {
     active: ActiveDelegationSession | null;
     candidates: DelegationRow[];
+    /**
+     * Whether the post-login "delegations available" prompt has already been
+     * shown for the current login. Reset on login so the prompt appears once,
+     * then never again on plain refreshes (persisted with the slice).
+     */
+    prompted: boolean;
 }
 
 /** Fetch the active delegations the current user may start (user/activedelegations). */
@@ -1072,6 +1078,12 @@ declare class SwitchDelegationSession {
     static readonly type = "[DelegationSession] Switch";
     constructor(delegation: DelegationRow);
 }
+/** Set whether the post-login candidates prompt has been shown for this login. */
+declare class MarkDelegationPrompted {
+    prompted: boolean;
+    static readonly type = "[DelegationSession] Mark Prompted";
+    constructor(prompted?: boolean);
+}
 
 declare class DelegationSessionState {
     private http;
@@ -1080,22 +1092,35 @@ declare class DelegationSessionState {
     constructor();
     static getActive(state: DelegationSessionStateModel): ActiveDelegationSession | null;
     static getCandidates(state: DelegationSessionStateModel): DelegationRow[];
+    static getPrompted(state: DelegationSessionStateModel): boolean;
     static isDelegated(state: DelegationSessionStateModel): boolean;
     static getLoadingActive(state: DelegationSessionStateModel): string[];
     static getErrors(state: DelegationSessionStateModel): Record<string, string | null | undefined>;
     loadCandidates(ctx: StateContext<DelegationSessionStateModel>): rxjs.Observable<Response<DelegationPage<DelegationRow>>>;
     start(ctx: StateContext<DelegationSessionStateModel>, { delegation }: StartDelegationSession): rxjs.Observable<Response<string>>;
     end(ctx: StateContext<DelegationSessionStateModel>, { reason }: EndDelegationSession): rxjs.Observable<never>;
+    markPrompted(ctx: StateContext<DelegationSessionStateModel>, { prompted }: MarkDelegationPrompted): rxjs.Observable<never>;
     switch(ctx: StateContext<DelegationSessionStateModel>, { delegation }: SwitchDelegationSession): rxjs.Observable<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DelegationSessionState, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<DelegationSessionState>;
 }
 
+/**
+ * When true (default), the app reloads after a delegated session starts /
+ * switches / ends so every subsequent request is re-fetched under the new
+ * delegation context (the SPA otherwise keeps the previous actor's loaded data).
+ * Consumers that drive their own refresh can provide `false` to opt out.
+ */
+declare const DELEGATION_RELOAD_ON_SESSION_CHANGE: InjectionToken<boolean>;
 declare class DelegationSessionFacade {
     private readonly store;
+    private readonly document;
+    private readonly reloadOnSessionChange;
     readonly active: _angular_core.Signal<_masterteam_delegations.ActiveDelegationSession | null>;
     readonly candidates: _angular_core.Signal<DelegationRow[]>;
     readonly isDelegated: _angular_core.Signal<boolean>;
+    /** Whether the post-login candidates prompt was already shown this login. */
+    readonly prompted: _angular_core.Signal<boolean>;
     private readonly loadingActive;
     /** Raw delegation token for the `app-delegation` header. */
     readonly token: _angular_core.Signal<string | null>;
@@ -1107,12 +1132,19 @@ declare class DelegationSessionFacade {
     readonly isStarting: _angular_core.Signal<boolean>;
     readonly isLoadingCandidates: _angular_core.Signal<boolean>;
     loadCandidates(): rxjs.Observable<void>;
+    markPrompted(prompted?: boolean): rxjs.Observable<void>;
     startSession(delegation: DelegationRow): rxjs.Observable<void>;
     switchSession(delegation: DelegationRow): rxjs.Observable<void>;
     endSession(reason?: DelegationSessionInvalidationReason): rxjs.Observable<void>;
+    /**
+     * Reload so all data refetches under the new delegation context. The session
+     * slice is persisted, so the (new/cleared) session restores after reload.
+     * Deferred a tick to let NGXS storage flush first.
+     */
+    private reloadAfterSessionChange;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DelegationSessionFacade, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<DelegationSessionFacade>;
 }
 
-export { ApproveDelegation, CancelDelegation, ClearDelegationDetail, ClearScopePreview, CreateDelegationLegacy, CreateDelegationV2, DelegationDetailDrawer, DelegationForm, DelegationMenuPanel, DelegationSessionActionKey, DelegationSessionFacade, DelegationSessionState, DelegationStatusChip, Delegations, DelegationsActionKey, DelegationsFacade, DelegationsList, DelegationsState, EndDelegationSession, GetActiveAssignedDelegations, GetAdminDelegations, GetApprovalDelegations, GetAssignedDelegations, GetDelegationDetail, GetMyDelegations, GetScopeOptions, LoadDelegationCandidates, PreviewScope, RejectDelegation, RejectDelegationDialog, ScopePicker, StartDelegationSession, StartSessionDialog, SwitchDelegationSession, TopbarDelegationMenu, UpdateDelegationLegacy, UpdateDelegationV2, appDelegationInterceptor };
+export { ApproveDelegation, CancelDelegation, ClearDelegationDetail, ClearScopePreview, CreateDelegationLegacy, CreateDelegationV2, DELEGATION_RELOAD_ON_SESSION_CHANGE, DelegationDetailDrawer, DelegationForm, DelegationMenuPanel, DelegationSessionActionKey, DelegationSessionFacade, DelegationSessionState, DelegationStatusChip, Delegations, DelegationsActionKey, DelegationsFacade, DelegationsList, DelegationsState, EndDelegationSession, GetActiveAssignedDelegations, GetAdminDelegations, GetApprovalDelegations, GetAssignedDelegations, GetDelegationDetail, GetMyDelegations, GetScopeOptions, LoadDelegationCandidates, MarkDelegationPrompted, PreviewScope, RejectDelegation, RejectDelegationDialog, ScopePicker, StartDelegationSession, StartSessionDialog, SwitchDelegationSession, TopbarDelegationMenu, UpdateDelegationLegacy, UpdateDelegationV2, appDelegationInterceptor };
 export type { ActiveDelegationSession, AdminCreateDelegationV2Request, AdminUpdateDelegationV2Request, ApproveDelegationRequest, CreateDelegationLegacyRequest, CreateDelegationV2Request, DelegationAllowedAction, DelegationAppAccessibility, DelegationApprovalInfo, DelegationApprovalStatus, DelegationCancellationInfo, DelegationDayRuleMode, DelegationDetail, DelegationDisplayValue, DelegationDto, DelegationEffectiveStatus, DelegationGrant, DelegationListQuery, DelegationPage, DelegationParty, DelegationRow, DelegationScopeAction, DelegationScopeCombinationRule, DelegationScopeDeniedItem, DelegationScopeFact, DelegationScopeHierarchyGroup, DelegationScopeHierarchyTarget, DelegationScopeLevelNode, DelegationScopeModuleNode, DelegationScopeOptions, DelegationScopePermissionGroup, DelegationScopePreview, DelegationScopePreviewRequest, DelegationScopeSelection, DelegationScopeTarget, DelegationScopeWarning, DelegationSessionInvalidationReason, DelegationSessionStateModel, DelegationSortDirection, DelegationStatusInfo, DelegationsStateModel, RejectDelegationRequest, UpdateDelegationLegacyRequest, UpdateDelegationV2Request };