@memberjunction/ng-shared 5.39.0 → 5.40.0

package/dist/lib/activity.service.d.ts

@@ -0,0 +1,55 @@
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+/** Lifecycle state of a tracked activity. */
+export type ActivityStatus = 'running' | 'success' | 'error';
+/** A single tracked job surfaced in the global Activity indicator. */
+export interface ActivityItem {
+    /** Stable unique id (returned by {@link ActivityService.Start}). */
+    ID: string;
+    /** Short label, e.g. "Classify pipeline". */
+    Label: string;
+    /** Optional secondary detail, e.g. "Sidecar · 18 of 30 items". */
+    Detail?: string;
+    /** Font Awesome icon class for the row. */
+    Icon?: string;
+    /** Current status. */
+    Status: ActivityStatus;
+    /** Optional 0–100 progress for a determinate bar. */
+    Progress?: number;
+    /** Epoch ms when the job started. */
+    StartedAt: number;
+    /** Epoch ms when the job finished (set on Complete). */
+    EndedAt?: number;
+}
+export declare class ActivityService {
+    private _items;
+    private readonly _subject;
+    /** Observable list of activities (most-recent first). */
+    readonly Activities$: Observable<ActivityItem[]>;
+    /** Current snapshot of all tracked activities. */
+    get Activities(): ActivityItem[];
+    /** Number of activities currently running. */
+    get RunningCount(): number;
+    /**
+     * Register a new running activity.
+     * @returns the activity id — pass it to {@link Update} / {@link Complete}.
+     */
+    Start(label: string, opts?: {
+        detail?: string;
+        icon?: string;
+        progress?: number;
+    }): string;
+    /** Patch an in-flight activity's label / detail / progress. */
+    Update(id: string, patch: Partial<Pick<ActivityItem, 'Label' | 'Detail' | 'Progress'>>): void;
+    /** Mark an activity finished (success or error). */
+    Complete(id: string, status?: 'success' | 'error', detail?: string): void;
+    /** Remove a single activity from the list. */
+    Remove(id: string): void;
+    /** Clear all finished (non-running) activities. */
+    ClearFinished(): void;
+    private emit;
+    private genId;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ActivityService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ActivityService>;
+}
+//# sourceMappingURL=activity.service.d.ts.map

package/dist/lib/activity.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.service.d.ts","sourceRoot":"","sources":["../../src/lib/activity.service.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAmB,UAAU,EAAE,MAAM,MAAM,CAAC;;AAEnD,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE7D,sEAAsE;AACtE,MAAM,WAAW,YAAY;IACzB,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBACa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IAEpE,yDAAyD;IACzD,SAAgB,WAAW,EAAE,UAAU,CAAC,YAAY,EAAE,CAAC,CAAgC;IAEvF,kDAAkD;IAClD,IAAW,UAAU,IAAI,YAAY,EAAE,CAEtC;IAED,8CAA8C;IAC9C,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED;;;OAGG;IACI,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAiBjG,+DAA+D;IACxD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC,CAAC,GAAG,IAAI;IAOpG,oDAAoD;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,GAAE,SAAS,GAAG,OAAmB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAU3F,8CAA8C;IACvC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK/B,mDAAmD;IAC5C,aAAa,IAAI,IAAI;IAK5B,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,KAAK;yCAzEJ,eAAe;6CAAf,eAAe;CA4E3B"}

package/dist/lib/activity.service.js

@@ -0,0 +1,95 @@
+/**
+ * @fileoverview Cross-surface "Activity" tracker for long-running jobs.
+ *
+ * The Knowledge Hub (and other dashboards) kick off fire-and-forget jobs from
+ * different surfaces — Run Pipeline (Classify), Run Cluster Analysis (Visualize),
+ * Vector Sync (Vectors), Run Detection (Duplicates), Run Tag Health (Tags). Once
+ * the user navigates away they lose all visibility into those jobs. This service
+ * is the single place those jobs register, so the shell can show one global
+ * "Activity" indicator + drawer that survives navigation.
+ *
+ * It is an Angular `providedIn: 'root'` singleton (same pattern as
+ * {@link NavigationService}); consumers in any package that depends on
+ * `@memberjunction/ng-shared` get the same instance.
+ */
+import { Injectable } from '@angular/core';
+import { UUIDsEqual } from '@memberjunction/global';
+import { BehaviorSubject } from 'rxjs';
+import * as i0 from "@angular/core";
+export class ActivityService {
+    _items = [];
+    _subject = new BehaviorSubject([]);
+    /** Observable list of activities (most-recent first). */
+    Activities$ = this._subject.asObservable();
+    /** Current snapshot of all tracked activities. */
+    get Activities() {
+        return this._items;
+    }
+    /** Number of activities currently running. */
+    get RunningCount() {
+        return this._items.filter(i => i.Status === 'running').length;
+    }
+    /**
+     * Register a new running activity.
+     * @returns the activity id — pass it to {@link Update} / {@link Complete}.
+     */
+    Start(label, opts) {
+        const id = this.genId();
+        const item = {
+            ID: id,
+            Label: label,
+            Detail: opts?.detail,
+            Icon: opts?.icon ?? 'fa-solid fa-gear',
+            Status: 'running',
+            Progress: opts?.progress,
+            StartedAt: Date.now(),
+        };
+        // Cap the list so a long session can't grow unbounded.
+        this._items = [item, ...this._items].slice(0, 50);
+        this.emit();
+        return id;
+    }
+    /** Patch an in-flight activity's label / detail / progress. */
+    Update(id, patch) {
+        const item = this._items.find(i => UUIDsEqual(i.ID, id));
+        if (!item)
+            return;
+        Object.assign(item, patch);
+        this.emit();
+    }
+    /** Mark an activity finished (success or error). */
+    Complete(id, status = 'success', detail) {
+        const item = this._items.find(i => UUIDsEqual(i.ID, id));
+        if (!item)
+            return;
+        item.Status = status;
+        item.EndedAt = Date.now();
+        item.Progress = status === 'success' ? 100 : item.Progress;
+        if (detail != null)
+            item.Detail = detail;
+        this.emit();
+    }
+    /** Remove a single activity from the list. */
+    Remove(id) {
+        this._items = this._items.filter(i => !UUIDsEqual(i.ID, id));
+        this.emit();
+    }
+    /** Clear all finished (non-running) activities. */
+    ClearFinished() {
+        this._items = this._items.filter(i => i.Status === 'running');
+        this.emit();
+    }
+    emit() {
+        this._subject.next([...this._items]);
+    }
+    genId() {
+        return 'act_' + Math.random().toString(36).slice(2, 10) + Date.now().toString(36);
+    }
+    static ɵfac = function ActivityService_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || ActivityService)(); };
+    static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: ActivityService, factory: ActivityService.ɵfac, providedIn: 'root' });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(ActivityService, [{
+        type: Injectable,
+        args: [{ providedIn: 'root' }]
+    }], null, null); })();
+//# sourceMappingURL=activity.service.js.map

package/dist/lib/activity.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.service.js","sourceRoot":"","sources":["../../src/lib/activity.service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Cross-surface \"Activity\" tracker for long-running jobs.\n *\n * The Knowledge Hub (and other dashboards) kick off fire-and-forget jobs from\n * different surfaces — Run Pipeline (Classify), Run Cluster Analysis (Visualize),\n * Vector Sync (Vectors), Run Detection (Duplicates), Run Tag Health (Tags). Once\n * the user navigates away they lose all visibility into those jobs. This service\n * is the single place those jobs register, so the shell can show one global\n * \"Activity\" indicator + drawer that survives navigation.\n *\n * It is an Angular `providedIn: 'root'` singleton (same pattern as\n * {@link NavigationService}); consumers in any package that depends on\n * `@memberjunction/ng-shared` get the same instance.\n */\n\nimport { Injectable } from '@angular/core';\nimport { UUIDsEqual } from '@memberjunction/global';\nimport { BehaviorSubject, Observable } from 'rxjs';\n\n/** Lifecycle state of a tracked activity. */\nexport type ActivityStatus = 'running' | 'success' | 'error';\n\n/** A single tracked job surfaced in the global Activity indicator. */\nexport interface ActivityItem {\n    /** Stable unique id (returned by {@link ActivityService.Start}). */\n    ID: string;\n    /** Short label, e.g. \"Classify pipeline\". */\n    Label: string;\n    /** Optional secondary detail, e.g. \"Sidecar · 18 of 30 items\". */\n    Detail?: string;\n    /** Font Awesome icon class for the row. */\n    Icon?: string;\n    /** Current status. */\n    Status: ActivityStatus;\n    /** Optional 0–100 progress for a determinate bar. */\n    Progress?: number;\n    /** Epoch ms when the job started. */\n    StartedAt: number;\n    /** Epoch ms when the job finished (set on Complete). */\n    EndedAt?: number;\n}\n\n@Injectable({ providedIn: 'root' })\nexport class ActivityService {\n    private _items: ActivityItem[] = [];\n    private readonly _subject = new BehaviorSubject<ActivityItem[]>([]);\n\n    /** Observable list of activities (most-recent first). */\n    public readonly Activities$: Observable<ActivityItem[]> = this._subject.asObservable();\n\n    /** Current snapshot of all tracked activities. */\n    public get Activities(): ActivityItem[] {\n        return this._items;\n    }\n\n    /** Number of activities currently running. */\n    public get RunningCount(): number {\n        return this._items.filter(i => i.Status === 'running').length;\n    }\n\n    /**\n     * Register a new running activity.\n     * @returns the activity id — pass it to {@link Update} / {@link Complete}.\n     */\n    public Start(label: string, opts?: { detail?: string; icon?: string; progress?: number }): string {\n        const id = this.genId();\n        const item: ActivityItem = {\n            ID: id,\n            Label: label,\n            Detail: opts?.detail,\n            Icon: opts?.icon ?? 'fa-solid fa-gear',\n            Status: 'running',\n            Progress: opts?.progress,\n            StartedAt: Date.now(),\n        };\n        // Cap the list so a long session can't grow unbounded.\n        this._items = [item, ...this._items].slice(0, 50);\n        this.emit();\n        return id;\n    }\n\n    /** Patch an in-flight activity's label / detail / progress. */\n    public Update(id: string, patch: Partial<Pick<ActivityItem, 'Label' | 'Detail' | 'Progress'>>): void {\n        const item = this._items.find(i => UUIDsEqual(i.ID, id));\n        if (!item) return;\n        Object.assign(item, patch);\n        this.emit();\n    }\n\n    /** Mark an activity finished (success or error). */\n    public Complete(id: string, status: 'success' | 'error' = 'success', detail?: string): void {\n        const item = this._items.find(i => UUIDsEqual(i.ID, id));\n        if (!item) return;\n        item.Status = status;\n        item.EndedAt = Date.now();\n        item.Progress = status === 'success' ? 100 : item.Progress;\n        if (detail != null) item.Detail = detail;\n        this.emit();\n    }\n\n    /** Remove a single activity from the list. */\n    public Remove(id: string): void {\n        this._items = this._items.filter(i => !UUIDsEqual(i.ID, id));\n        this.emit();\n    }\n\n    /** Clear all finished (non-running) activities. */\n    public ClearFinished(): void {\n        this._items = this._items.filter(i => i.Status === 'running');\n        this.emit();\n    }\n\n    private emit(): void {\n        this._subject.next([...this._items]);\n    }\n\n    private genId(): string {\n        return 'act_' + Math.random().toString(36).slice(2, 10) + Date.now().toString(36);\n    }\n}\n"]}

package/dist/lib/base-resource-component.d.ts

@@ -23,6 +23,14 @@ export declare abstract class BaseResourceComponent extends BaseNavigationCompon
     set Data(value: ResourceData);
     private _loadComplete;
     get LoadComplete(): boolean;
+    /**
+     * Watchdog window: if a resource component hasn't called {@link NotifyLoadComplete} within this
+     * time, we log a warning naming the offending class. The app loading screen waits on
+     * NotifyLoadComplete, so a resource that never calls it hangs the screen forever — this makes the
+     * culprit obvious in the console instead of leaving a mystery "stuck loading" state.
+     */
+    private static readonly LOAD_COMPLETE_WATCHDOG_MS;
+    private _loadCompleteWatchdog;
     private _loadStarted;
     get LoadStarted(): boolean;
     private _loadCompleteEvent;

package/dist/lib/base-resource-component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-resource-component.d.ts","sourceRoot":"","sources":["../../src/lib/base-resource-component.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-resource-component.d.ts","sourceRoot":"","sources":["../../src/lib/base-resource-component.ts"],"names":[],"mappings":"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"}

package/dist/lib/base-resource-component.js

@@ -29,6 +29,14 @@ export class BaseResourceComponent extends BaseNavigationComponent {
     get LoadComplete() {
         return this._loadComplete;
     }
+    /**
+     * Watchdog window: if a resource component hasn't called {@link NotifyLoadComplete} within this
+     * time, we log a warning naming the offending class. The app loading screen waits on
+     * NotifyLoadComplete, so a resource that never calls it hangs the screen forever — this makes the
+     * culprit obvious in the console instead of leaving a mystery "stuck loading" state.
+     */
+    static LOAD_COMPLETE_WATCHDOG_MS = 15_000;
+    _loadCompleteWatchdog = null;
     _loadStarted = false;
     get LoadStarted() {
         return this._loadStarted;
@@ -75,8 +83,22 @@ export class BaseResourceComponent extends BaseNavigationComponent {
         // emission claim the 'deeplink' source before any later popstate event.
         this.setupQueryParamSubscription();
         this.setupInitialParamDelivery();
+        // Start the NotifyLoadComplete watchdog (no-op once it fires or load completes).
+        this._loadCompleteWatchdog = setTimeout(() => {
+            if (!this._loadComplete) {
+                // eslint-disable-next-line no-console
+                console.warn(`[LoadComplete WATCHDOG] ${this.constructor.name} has NOT called NotifyLoadComplete() ` +
+                    `within ${BaseResourceComponent.LOAD_COMPLETE_WATCHDOG_MS / 1000}s. The app loading screen ` +
+                    `waits on this signal — if the screen is stuck, this resource is the likely cause. ` +
+                    `(tabId=${this.getTabId() || 'n/a'})`);
+            }
+        }, BaseResourceComponent.LOAD_COMPLETE_WATCHDOG_MS);
     }
     ngOnDestroy() {
+        if (this._loadCompleteWatchdog) {
+            clearTimeout(this._loadCompleteWatchdog);
+            this._loadCompleteWatchdog = null;
+        }
         this.destroy$.next();
         this.destroy$.complete();
     }
@@ -181,6 +203,10 @@ export class BaseResourceComponent extends BaseNavigationComponent {
     }
     NotifyLoadComplete() {
         this._loadComplete = true;
+        if (this._loadCompleteWatchdog) {
+            clearTimeout(this._loadCompleteWatchdog);
+            this._loadCompleteWatchdog = null;
+        }
         if (this._loadCompleteEvent) {
             this._loadCompleteEvent();
         }

package/dist/lib/base-resource-component.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-resource-component.js","sourceRoot":"","sources":["../../src/lib/base-resource-component.ts"],"names":[],"mappings":"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","sourcesContent":["import { Directive, OnInit, OnDestroy, Input, inject } from \"@angular/core\";\nimport { Subject } from \"rxjs\";\nimport { filter, takeUntil } from \"rxjs/operators\";\nimport { BaseEntity } from \"@memberjunction/core\";\nimport { BaseNavigationComponent } from \"./base-navigation-component\";\nimport { ResourceData } from \"@memberjunction/core-entities\";\nimport { NavigationService } from \"./navigation.service\";\n\n@Directive()\nexport abstract class BaseResourceComponent extends BaseNavigationComponent implements OnInit, OnDestroy {\n    private _data: ResourceData = new ResourceData();\n    private _suppressQueryParamSync = false;\n    /** Stable key of the most recently delivered query params, used to de-duplicate\n     *  delivery across the reactive (initial/deep-link) and popstate paths. */\n    private _lastDeliveredParamsKey: string | null = null;\n    protected destroy$ = new Subject<void>();\n    protected navigationService = inject(NavigationService);\n\n    /**\n     * Tab ID for query param notification scoping. Set by resource wrappers\n     * that render child dashboards, so the child knows which tab it belongs to.\n     * If not set, falls back to Data.Configuration.tabId.\n     */\n    @Input() ParentTabId: string | null = null;\n\n    public get Data(): ResourceData {\n        return this._data;\n    }\n    public set Data(value: ResourceData) {\n        this._data = value;\n    }\n\n    private _loadComplete: boolean = false;\n    public get LoadComplete(): boolean {\n        return this._loadComplete;\n    }\n\n    private _loadStarted: boolean = false;\n    public get LoadStarted(): boolean {\n        return this._loadStarted;\n    }\n\n\n    private _loadCompleteEvent: any = null;\n    public get LoadCompleteEvent(): any {\n        return this._loadCompleteEvent\n    }\n    public set LoadCompleteEvent(value: any) {\n        this._loadCompleteEvent = value;\n    }\n\n    private _loadStartedEvent: any = null;\n    public get LoadStartedEvent(): any {\n        return this._loadStartedEvent\n    }\n    public set LoadStartedEvent(value: any) {\n        this._loadStartedEvent = value;\n    }\n\n    private _resourceRecordSavedEvent: any = null;\n    public get ResourceRecordSavedEvent(): any {\n        return this._resourceRecordSavedEvent\n    }\n    public set ResourceRecordSavedEvent(value: any) {\n        this._resourceRecordSavedEvent = value;\n    }\n\n    private _resourceCloseRequestedEvent: (() => void) | null = null;\n    public get ResourceCloseRequestedEvent(): (() => void) | null {\n        return this._resourceCloseRequestedEvent;\n    }\n    public set ResourceCloseRequestedEvent(value: (() => void) | null) {\n        this._resourceCloseRequestedEvent = value;\n    }\n\n    private _displayNameChangedEvent: ((newName: string) => void) | null = null;\n    public get DisplayNameChangedEvent(): ((newName: string) => void) | null {\n        return this._displayNameChangedEvent;\n    }\n    public set DisplayNameChangedEvent(value: ((newName: string) => void) | null) {\n        this._displayNameChangedEvent = value;\n    }\n\n    ngOnInit(): void {\n        // Order matters: set up the popstate subscription first (a plain Subject — emits\n        // nothing on subscribe), then the reactive initial-delivery subscription (backed by\n        // a BehaviorSubject — emits the current params synchronously). This lets the initial\n        // emission claim the 'deeplink' source before any later popstate event.\n        this.setupQueryParamSubscription();\n        this.setupInitialParamDelivery();\n    }\n\n    ngOnDestroy(): void {\n        this.destroy$.next();\n        this.destroy$.complete();\n    }\n\n    /**\n     * Called by the framework when query params change from an external source\n     * (browser back/forward, deep link navigation).\n     * Override in subclasses to react to query param changes.\n     * @param params The new query params from the URL\n     * @param source 'popstate' for back/forward, 'deeplink' for external URL entry\n     */\n    protected OnQueryParamsChanged(params: Record<string, string>, source: 'popstate' | 'deeplink'): void {\n        // Default no-op — override in subclasses\n    }\n\n    /**\n     * Push query param changes to the URL. Creates a browser history entry.\n     * Safe to call during OnQueryParamsChanged — auto-suppressed to prevent loops.\n     */\n    protected UpdateQueryParams(params: Record<string, string | null>): void {\n        if (this._suppressQueryParamSync) return;\n        this.navigationService.UpdateActiveTabQueryParams(params);\n    }\n\n    /**\n     * Read current query params from tab configuration.\n     * Use in initDashboard() / ngOnInit() to get initial URL state.\n     */\n    protected GetQueryParams(): Record<string, string> {\n        return (this.Data?.Configuration?.['queryParams'] as Record<string, string>) || {};\n    }\n\n    /**\n     * Internal: subscribe to NavigationService query param notifications.\n     * Filters to only this component's tab to prevent cross-tab leakage.\n     * This is the explicit back/forward (popstate) path.\n     */\n    private setupQueryParamSubscription(): void {\n        this.navigationService.QueryParamChanged$\n            .pipe(\n                filter(event => {\n                    const myTabId = this.getTabId();\n                    return !myTabId || event.TabId === myTabId;\n                }),\n                takeUntil(this.destroy$)\n            )\n            .subscribe(event => this.deliverQueryParams(event.Params));\n    }\n\n    /**\n     * Internal: reactively deliver this tab's query params from the workspace\n     * BehaviorSubject. Because the source replays the current value on subscribe and\n     * emits future changes, this delivers initial deep-link params even when the\n     * component mounts (e.g. from workspace restoration) before the URL params have\n     * been merged into the tab configuration — closing the cold-load race that the\n     * popstate-only path could not.\n     */\n    private setupInitialParamDelivery(): void {\n        const tabId = this.getTabId();\n        if (!tabId) {\n            return; // No tab scope (e.g. embedded usage) — nothing to observe.\n        }\n        this.navigationService.ObserveTabQueryParams(tabId)\n            .pipe(takeUntil(this.destroy$))\n            .subscribe(params => this.deliverQueryParams(params));\n    }\n\n    /**\n     * Internal: funnel point for both the reactive and popstate paths. De-duplicates\n     * identical deliveries (the two paths overlap on back/forward) and labels the first\n     * meaningful delivery as a 'deeplink', subsequent ones as 'popstate'.\n     */\n    private deliverQueryParams(params: Record<string, string>): void {\n        const key = this.queryParamsKey(params);\n        if (key === this._lastDeliveredParamsKey) {\n            return; // Already delivered these exact params.\n        }\n        const isInitial = this._lastDeliveredParamsKey === null;\n        // Don't fire an initial no-op: a component entered without deep-link params has\n        // nothing to apply. Leave _lastDeliveredParamsKey null so the first real params\n        // (whenever they arrive) are still treated as the deep-link entry.\n        if (isInitial && Object.keys(params).length === 0) {\n            return;\n        }\n        this._lastDeliveredParamsKey = key;\n        const source: 'popstate' | 'deeplink' = isInitial ? 'deeplink' : 'popstate';\n        // try/finally ensures the suppression flag is always cleared, even if\n        // OnQueryParamsChanged throws.\n        this._suppressQueryParamSync = true;\n        try {\n            this.OnQueryParamsChanged(params, source);\n        } finally {\n            this._suppressQueryParamSync = false;\n        }\n    }\n\n    /** Stable, order-independent string key for a query param record. */\n    private queryParamsKey(params: Record<string, string>): string {\n        return Object.keys(params)\n            .sort()\n            .map(k => `${k}=${params[k]}`)\n            .join('&');\n    }\n\n    /**\n     * Get this component's tab ID. Checks ParentTabId input first (set by resource\n     * wrappers for child dashboards), then falls back to Data.Configuration.tabId.\n     */\n    public getTabId(): string {\n        return this.ParentTabId || this.Data?.Configuration?.['tabId'] as string || '';\n    }\n\n    protected NotifyLoadComplete() {\n        this._loadComplete = true;\n        if (this._loadCompleteEvent) {\n            this._loadCompleteEvent();\n        }\n    }\n\n    protected NotifyLoadStarted() {\n        this._loadStarted = true;\n        if (this._loadStartedEvent) {\n            this._loadStartedEvent();\n        }\n    }\n\n\n\n    /**\n     * Call this to notify the tab system that the resource's display name has changed.\n     * The tab container will update the tab title and browser title accordingly.\n     */\n    protected NotifyDisplayNameChanged(newName: string): void {\n        if (this._displayNameChangedEvent) {\n            this._displayNameChangedEvent(newName);\n        }\n    }\n\n    protected ResourceRecordSaved(resourceRecordEntity: BaseEntity) {\n        // Use ToURLSegment, NOT ToString. ResourceRecordID is consumed by\n        // EntityRecordResource.GetPrimaryKey → CompositeKey.LoadFromURLSegment, which\n        // expects URL-segment format (e.g. \"ID|<uuid>\"). ToString produces \"ID=<uuid>\",\n        // which LoadFromURLSegment treats as a raw value and double-prefixes —\n        // breaking any code path that re-reads this field after save.\n        this.Data.ResourceRecordID = resourceRecordEntity.PrimaryKey.ToURLSegment();\n        if (this._resourceRecordSavedEvent) {\n            this._resourceRecordSavedEvent(resourceRecordEntity);\n        }\n    }\n\n    /**\n     * Ask the host shell to close/dismiss this resource (typically: close the tab).\n     * Called by subclasses that hosted a form that emitted a 'dismiss' navigation\n     * event — most often, a brand-new record where the user clicked Discard. The\n     * record was never saved, the form is empty, and leaving it open serves no\n     * purpose. The tab-container listens for this and closes the workspace tab.\n     */\n    protected NotifyCloseRequested(): void {\n        if (this._resourceCloseRequestedEvent) {\n            this._resourceCloseRequestedEvent();\n        }\n    }\n\n    abstract GetResourceDisplayName(data: ResourceData): Promise<string>\n\n    abstract GetResourceIconClass(data: ResourceData): Promise<string>\n}\n"]}
+{"version":3,"file":"base-resource-component.js","sourceRoot":"","sources":["../../src/lib/base-resource-component.ts"],"names":[],"mappings":"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","sourcesContent":["import { Directive, OnInit, OnDestroy, Input, inject } from \"@angular/core\";\nimport { Subject } from \"rxjs\";\nimport { filter, takeUntil } from \"rxjs/operators\";\nimport { BaseEntity } from \"@memberjunction/core\";\nimport { BaseNavigationComponent } from \"./base-navigation-component\";\nimport { ResourceData } from \"@memberjunction/core-entities\";\nimport { NavigationService } from \"./navigation.service\";\n\n@Directive()\nexport abstract class BaseResourceComponent extends BaseNavigationComponent implements OnInit, OnDestroy {\n    private _data: ResourceData = new ResourceData();\n    private _suppressQueryParamSync = false;\n    /** Stable key of the most recently delivered query params, used to de-duplicate\n     *  delivery across the reactive (initial/deep-link) and popstate paths. */\n    private _lastDeliveredParamsKey: string | null = null;\n    protected destroy$ = new Subject<void>();\n    protected navigationService = inject(NavigationService);\n\n    /**\n     * Tab ID for query param notification scoping. Set by resource wrappers\n     * that render child dashboards, so the child knows which tab it belongs to.\n     * If not set, falls back to Data.Configuration.tabId.\n     */\n    @Input() ParentTabId: string | null = null;\n\n    public get Data(): ResourceData {\n        return this._data;\n    }\n    public set Data(value: ResourceData) {\n        this._data = value;\n    }\n\n    private _loadComplete: boolean = false;\n    public get LoadComplete(): boolean {\n        return this._loadComplete;\n    }\n\n    /**\n     * Watchdog window: if a resource component hasn't called {@link NotifyLoadComplete} within this\n     * time, we log a warning naming the offending class. The app loading screen waits on\n     * NotifyLoadComplete, so a resource that never calls it hangs the screen forever — this makes the\n     * culprit obvious in the console instead of leaving a mystery \"stuck loading\" state.\n     */\n    private static readonly LOAD_COMPLETE_WATCHDOG_MS = 15_000;\n    private _loadCompleteWatchdog: ReturnType<typeof setTimeout> | null = null;\n\n    private _loadStarted: boolean = false;\n    public get LoadStarted(): boolean {\n        return this._loadStarted;\n    }\n\n\n    private _loadCompleteEvent: any = null;\n    public get LoadCompleteEvent(): any {\n        return this._loadCompleteEvent\n    }\n    public set LoadCompleteEvent(value: any) {\n        this._loadCompleteEvent = value;\n    }\n\n    private _loadStartedEvent: any = null;\n    public get LoadStartedEvent(): any {\n        return this._loadStartedEvent\n    }\n    public set LoadStartedEvent(value: any) {\n        this._loadStartedEvent = value;\n    }\n\n    private _resourceRecordSavedEvent: any = null;\n    public get ResourceRecordSavedEvent(): any {\n        return this._resourceRecordSavedEvent\n    }\n    public set ResourceRecordSavedEvent(value: any) {\n        this._resourceRecordSavedEvent = value;\n    }\n\n    private _resourceCloseRequestedEvent: (() => void) | null = null;\n    public get ResourceCloseRequestedEvent(): (() => void) | null {\n        return this._resourceCloseRequestedEvent;\n    }\n    public set ResourceCloseRequestedEvent(value: (() => void) | null) {\n        this._resourceCloseRequestedEvent = value;\n    }\n\n    private _displayNameChangedEvent: ((newName: string) => void) | null = null;\n    public get DisplayNameChangedEvent(): ((newName: string) => void) | null {\n        return this._displayNameChangedEvent;\n    }\n    public set DisplayNameChangedEvent(value: ((newName: string) => void) | null) {\n        this._displayNameChangedEvent = value;\n    }\n\n    ngOnInit(): void {\n        // Order matters: set up the popstate subscription first (a plain Subject — emits\n        // nothing on subscribe), then the reactive initial-delivery subscription (backed by\n        // a BehaviorSubject — emits the current params synchronously). This lets the initial\n        // emission claim the 'deeplink' source before any later popstate event.\n        this.setupQueryParamSubscription();\n        this.setupInitialParamDelivery();\n\n        // Start the NotifyLoadComplete watchdog (no-op once it fires or load completes).\n        this._loadCompleteWatchdog = setTimeout(() => {\n            if (!this._loadComplete) {\n                // eslint-disable-next-line no-console\n                console.warn(\n                    `[LoadComplete WATCHDOG] ${this.constructor.name} has NOT called NotifyLoadComplete() ` +\n                    `within ${BaseResourceComponent.LOAD_COMPLETE_WATCHDOG_MS / 1000}s. The app loading screen ` +\n                    `waits on this signal — if the screen is stuck, this resource is the likely cause. ` +\n                    `(tabId=${this.getTabId() || 'n/a'})`\n                );\n            }\n        }, BaseResourceComponent.LOAD_COMPLETE_WATCHDOG_MS);\n    }\n\n    ngOnDestroy(): void {\n        if (this._loadCompleteWatchdog) {\n            clearTimeout(this._loadCompleteWatchdog);\n            this._loadCompleteWatchdog = null;\n        }\n        this.destroy$.next();\n        this.destroy$.complete();\n    }\n\n    /**\n     * Called by the framework when query params change from an external source\n     * (browser back/forward, deep link navigation).\n     * Override in subclasses to react to query param changes.\n     * @param params The new query params from the URL\n     * @param source 'popstate' for back/forward, 'deeplink' for external URL entry\n     */\n    protected OnQueryParamsChanged(params: Record<string, string>, source: 'popstate' | 'deeplink'): void {\n        // Default no-op — override in subclasses\n    }\n\n    /**\n     * Push query param changes to the URL. Creates a browser history entry.\n     * Safe to call during OnQueryParamsChanged — auto-suppressed to prevent loops.\n     */\n    protected UpdateQueryParams(params: Record<string, string | null>): void {\n        if (this._suppressQueryParamSync) return;\n        this.navigationService.UpdateActiveTabQueryParams(params);\n    }\n\n    /**\n     * Read current query params from tab configuration.\n     * Use in initDashboard() / ngOnInit() to get initial URL state.\n     */\n    protected GetQueryParams(): Record<string, string> {\n        return (this.Data?.Configuration?.['queryParams'] as Record<string, string>) || {};\n    }\n\n    /**\n     * Internal: subscribe to NavigationService query param notifications.\n     * Filters to only this component's tab to prevent cross-tab leakage.\n     * This is the explicit back/forward (popstate) path.\n     */\n    private setupQueryParamSubscription(): void {\n        this.navigationService.QueryParamChanged$\n            .pipe(\n                filter(event => {\n                    const myTabId = this.getTabId();\n                    return !myTabId || event.TabId === myTabId;\n                }),\n                takeUntil(this.destroy$)\n            )\n            .subscribe(event => this.deliverQueryParams(event.Params));\n    }\n\n    /**\n     * Internal: reactively deliver this tab's query params from the workspace\n     * BehaviorSubject. Because the source replays the current value on subscribe and\n     * emits future changes, this delivers initial deep-link params even when the\n     * component mounts (e.g. from workspace restoration) before the URL params have\n     * been merged into the tab configuration — closing the cold-load race that the\n     * popstate-only path could not.\n     */\n    private setupInitialParamDelivery(): void {\n        const tabId = this.getTabId();\n        if (!tabId) {\n            return; // No tab scope (e.g. embedded usage) — nothing to observe.\n        }\n        this.navigationService.ObserveTabQueryParams(tabId)\n            .pipe(takeUntil(this.destroy$))\n            .subscribe(params => this.deliverQueryParams(params));\n    }\n\n    /**\n     * Internal: funnel point for both the reactive and popstate paths. De-duplicates\n     * identical deliveries (the two paths overlap on back/forward) and labels the first\n     * meaningful delivery as a 'deeplink', subsequent ones as 'popstate'.\n     */\n    private deliverQueryParams(params: Record<string, string>): void {\n        const key = this.queryParamsKey(params);\n        if (key === this._lastDeliveredParamsKey) {\n            return; // Already delivered these exact params.\n        }\n        const isInitial = this._lastDeliveredParamsKey === null;\n        // Don't fire an initial no-op: a component entered without deep-link params has\n        // nothing to apply. Leave _lastDeliveredParamsKey null so the first real params\n        // (whenever they arrive) are still treated as the deep-link entry.\n        if (isInitial && Object.keys(params).length === 0) {\n            return;\n        }\n        this._lastDeliveredParamsKey = key;\n        const source: 'popstate' | 'deeplink' = isInitial ? 'deeplink' : 'popstate';\n        // try/finally ensures the suppression flag is always cleared, even if\n        // OnQueryParamsChanged throws.\n        this._suppressQueryParamSync = true;\n        try {\n            this.OnQueryParamsChanged(params, source);\n        } finally {\n            this._suppressQueryParamSync = false;\n        }\n    }\n\n    /** Stable, order-independent string key for a query param record. */\n    private queryParamsKey(params: Record<string, string>): string {\n        return Object.keys(params)\n            .sort()\n            .map(k => `${k}=${params[k]}`)\n            .join('&');\n    }\n\n    /**\n     * Get this component's tab ID. Checks ParentTabId input first (set by resource\n     * wrappers for child dashboards), then falls back to Data.Configuration.tabId.\n     */\n    public getTabId(): string {\n        return this.ParentTabId || this.Data?.Configuration?.['tabId'] as string || '';\n    }\n\n    protected NotifyLoadComplete() {\n        this._loadComplete = true;\n        if (this._loadCompleteWatchdog) {\n            clearTimeout(this._loadCompleteWatchdog);\n            this._loadCompleteWatchdog = null;\n        }\n        if (this._loadCompleteEvent) {\n            this._loadCompleteEvent();\n        }\n    }\n\n    protected NotifyLoadStarted() {\n        this._loadStarted = true;\n        if (this._loadStartedEvent) {\n            this._loadStartedEvent();\n        }\n    }\n\n\n\n    /**\n     * Call this to notify the tab system that the resource's display name has changed.\n     * The tab container will update the tab title and browser title accordingly.\n     */\n    protected NotifyDisplayNameChanged(newName: string): void {\n        if (this._displayNameChangedEvent) {\n            this._displayNameChangedEvent(newName);\n        }\n    }\n\n    protected ResourceRecordSaved(resourceRecordEntity: BaseEntity) {\n        // Use ToURLSegment, NOT ToString. ResourceRecordID is consumed by\n        // EntityRecordResource.GetPrimaryKey → CompositeKey.LoadFromURLSegment, which\n        // expects URL-segment format (e.g. \"ID|<uuid>\"). ToString produces \"ID=<uuid>\",\n        // which LoadFromURLSegment treats as a raw value and double-prefixes —\n        // breaking any code path that re-reads this field after save.\n        this.Data.ResourceRecordID = resourceRecordEntity.PrimaryKey.ToURLSegment();\n        if (this._resourceRecordSavedEvent) {\n            this._resourceRecordSavedEvent(resourceRecordEntity);\n        }\n    }\n\n    /**\n     * Ask the host shell to close/dismiss this resource (typically: close the tab).\n     * Called by subclasses that hosted a form that emitted a 'dismiss' navigation\n     * event — most often, a brand-new record where the user clicked Discard. The\n     * record was never saved, the form is empty, and leaving it open serves no\n     * purpose. The tab-container listens for this and closes the workspace tab.\n     */\n    protected NotifyCloseRequested(): void {\n        if (this._resourceCloseRequestedEvent) {\n            this._resourceCloseRequestedEvent();\n        }\n    }\n\n    abstract GetResourceDisplayName(data: ResourceData): Promise<string>\n\n    abstract GetResourceIconClass(data: ResourceData): Promise<string>\n}\n"]}

package/dist/public-api.d.ts

@@ -6,6 +6,7 @@ export * from './lib/base-resource-component';
 export * from './lib/base-navigation-component';
 export * from './lib/navigation.service';
 export * from './lib/navigation.interfaces';
+export * from './lib/activity.service';
 export * from './lib/title.service';
 export * from './lib/developer-mode.service';
 export * from './lib/home-pin.types';

package/dist/public-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAIA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,cAAc,mCAAmC,CAAC;AAClD,cAAc,UAAU,CAAC"}
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAIA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,cAAc,mCAAmC,CAAC;AAClD,cAAc,UAAU,CAAC"}

package/dist/public-api.js

@@ -9,6 +9,7 @@ export * from './lib/base-resource-component';
 export * from './lib/base-navigation-component';
 export * from './lib/navigation.service';
 export * from './lib/navigation.interfaces';
+export * from './lib/activity.service';
 export * from './lib/title.service';
 export * from './lib/developer-mode.service';
 export * from './lib/home-pin.types';

package/dist/public-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,+DAA+D;AAC/D,cAAc,mCAAmC,CAAC;AAClD,cAAc,UAAU,CAAC","sourcesContent":["/*\n * Public API Surface\n */\n\nexport * from './lib/urlPipe';\nexport * from './lib/base-dashboard';\nexport * from './lib/simpleTextFormat';\nexport * from './lib/shared.service';\nexport * from './lib/base-resource-component'\nexport * from './lib/base-navigation-component';\nexport * from './lib/navigation.service';\nexport * from './lib/navigation.interfaces';\nexport * from './lib/title.service';\nexport * from './lib/developer-mode.service';\nexport * from './lib/home-pin.types';\nexport * from './lib/home-pin.service';\nexport { SYSTEM_APP_ID } from './lib/navigation.service';\n// Re-export from ng-shared-generic for backwards compatibility\nexport * from '@memberjunction/ng-shared-generic';\nexport * from './module';"]}
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,+DAA+D;AAC/D,cAAc,mCAAmC,CAAC;AAClD,cAAc,UAAU,CAAC","sourcesContent":["/*\n * Public API Surface\n */\n\nexport * from './lib/urlPipe';\nexport * from './lib/base-dashboard';\nexport * from './lib/simpleTextFormat';\nexport * from './lib/shared.service';\nexport * from './lib/base-resource-component'\nexport * from './lib/base-navigation-component';\nexport * from './lib/navigation.service';\nexport * from './lib/navigation.interfaces';\nexport * from './lib/activity.service';\nexport * from './lib/title.service';\nexport * from './lib/developer-mode.service';\nexport * from './lib/home-pin.types';\nexport * from './lib/home-pin.service';\nexport { SYSTEM_APP_ID } from './lib/navigation.service';\n// Re-export from ng-shared-generic for backwards compatibility\nexport * from '@memberjunction/ng-shared-generic';\nexport * from './module';"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/ng-shared",
-  "version": "5.39.0",
+  "version": "5.40.0",
   "description": "MemberJunction: MJ Explorer Angular Shared Package - utility functions and other reusable elements used across other MJ Angular packages within the MJ Explorer App - do not use outside of MJ Explorer.",
   "main": "./dist/public-api.js",
   "typings": "./dist/public-api.d.ts",
@@ -29,17 +29,17 @@
   },
   "dependencies": {
     "@angular/platform-browser": "21.1.3",
-    "@memberjunction/ai-core-plus": "5.39.0",
-    "@memberjunction/ai-engine-base": "5.39.0",
-    "@memberjunction/core": "5.39.0",
-    "@memberjunction/core-entities": "5.39.0",
-    "@memberjunction/entity-communications-base": "5.39.0",
-    "@memberjunction/global": "5.39.0",
-    "@memberjunction/graphql-dataprovider": "5.39.0",
-    "@memberjunction/ng-base-application": "5.39.0",
-    "@memberjunction/ng-base-types": "5.39.0",
-    "@memberjunction/ng-notifications": "5.39.0",
-    "@memberjunction/ng-shared-generic": "5.39.0",
+    "@memberjunction/ai-core-plus": "5.40.0",
+    "@memberjunction/ai-engine-base": "5.40.0",
+    "@memberjunction/core": "5.40.0",
+    "@memberjunction/core-entities": "5.40.0",
+    "@memberjunction/entity-communications-base": "5.40.0",
+    "@memberjunction/global": "5.40.0",
+    "@memberjunction/graphql-dataprovider": "5.40.0",
+    "@memberjunction/ng-base-application": "5.40.0",
+    "@memberjunction/ng-base-types": "5.40.0",
+    "@memberjunction/ng-notifications": "5.40.0",
+    "@memberjunction/ng-shared-generic": "5.40.0",
     "html-to-image": "^1.11.11",
     "tslib": "^2.8.1"
   },