@memberjunction/ng-dashboards 6.2.0-edge.2 → 6.2.0-edge.4

package/dist/WorkQueue/work-queue-agent-context.js

@@ -0,0 +1,119 @@
+/**
+ * @fileoverview Pure helpers for the Work Queue dashboard: tab ids, attention ordering, age formatting, the
+ * tolerant subscription resolver the agent tools use, and the agent-context shaping. No Angular imports, so
+ * every function here is unit-tested in isolation (see __tests__/work-queue-agent-context.test.ts).
+ *
+ * 🔒 SAFETY: the agent surface is read-only and navigational. Replay and discard are mutations that must be
+ * confirmed by the user in the UI; the tools registered by the dashboard never execute them.
+ */
+import { UUIDsEqual } from '@memberjunction/global';
+export const WORK_QUEUE_TABS = ['overview', 'dead-letters', 'partitions', 'bindings'];
+export const WORK_QUEUE_TAB_LABELS = {
+    overview: 'Overview',
+    'dead-letters': 'Dead Letters',
+    partitions: 'Partitions',
+    bindings: 'Bindings',
+};
+/** The partition conditions WorkQueue.ListPartitions accepts (03 §5.2). */
+export const WORK_QUEUE_PARTITION_CONDITIONS = ['Blocked', 'InFlight', 'Idle'];
+/** Upper bound on any list published in the agent context; a companion count reports the true total. */
+export const WORK_QUEUE_CONTEXT_LIST_CAP = 25;
+export function IsValidWorkQueueTab(value) {
+    return typeof value === 'string' && WORK_QUEUE_TABS.includes(value);
+}
+export function IsValidPartitionCondition(value) {
+    return typeof value === 'string' && WORK_QUEUE_PARTITION_CONDITIONS.includes(value);
+}
+/** A subscription needs an operator when it holds dead letters or a blocked Ordered key. */
+export function NeedsAttention(snapshot) {
+    return (snapshot.DeadLettered ?? 0) > 0 || (snapshot.BlockedKeys ?? 0) > 0;
+}
+/** Attention first, then by name; returns a new array. */
+export function SortByAttention(items) {
+    return [...items].sort((a, b) => {
+        const attention = Number(NeedsAttention(b)) - Number(NeedsAttention(a));
+        return attention !== 0 ? attention : a.Name.localeCompare(b.Name);
+    });
+}
+/** '—' for null, then s / m / h m / d h at the coarsest useful unit. */
+export function FormatAge(seconds) {
+    if (seconds === null || seconds === undefined || !Number.isFinite(seconds) || seconds < 0) {
+        return '—';
+    }
+    const s = Math.floor(seconds);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m`;
+    const h = Math.floor(m / 60);
+    if (h < 24)
+        return `${h}h ${m % 60}m`;
+    const d = Math.floor(h / 24);
+    return `${d}d ${h % 24}h`;
+}
+/**
+ * Resolves an agent-supplied id or name tolerantly: exact id, then exact name (case-insensitive), then a unique
+ * case-insensitive substring of the name. Several substring matches are reported as Ambiguous, never guessed.
+ */
+export function ResolveSubscription(candidates, query) {
+    const needle = query.trim();
+    if (needle === '') {
+        return { Kind: 'NotFound' };
+    }
+    const byId = candidates.find((c) => UUIDsEqual(c.ID, needle));
+    if (byId)
+        return { Kind: 'Match', Item: byId };
+    const lower = needle.toLowerCase();
+    const byName = candidates.find((c) => c.Name.toLowerCase() === lower);
+    if (byName)
+        return { Kind: 'Match', Item: byName };
+    const partial = candidates.filter((c) => c.Name.toLowerCase().includes(lower));
+    if (partial.length === 1)
+        return { Kind: 'Match', Item: partial[0] };
+    return partial.length > 1 ? { Kind: 'Ambiguous', Matches: partial } : { Kind: 'NotFound' };
+}
+/**
+ * Shapes the dashboard state for NavigationService.SetAgentContext. Counts come only from loaded stats: before the
+ * first stats read the aggregate fields are null rather than fabricated zeros.
+ */
+export function BuildWorkQueueAgentContext(input) {
+    const attention = SortByAttention(input.Subscriptions).filter(NeedsAttention);
+    const totals = input.StatsLoaded
+        ? input.Subscriptions.reduce((acc, s) => ({
+            Pending: acc.Pending + (s.Pending ?? 0),
+            InFlight: acc.InFlight + (s.InFlight ?? 0),
+            DeadLettered: acc.DeadLettered + (s.DeadLettered ?? 0),
+            BlockedKeys: acc.BlockedKeys + (s.BlockedKeys ?? 0),
+        }), { Pending: 0, InFlight: 0, DeadLettered: 0, BlockedKeys: 0 })
+        : null;
+    const context = {
+        Surface: 'WorkQueue',
+        ActiveTab: input.ActiveTab,
+        ActiveTabLabel: IsValidWorkQueueTab(input.ActiveTab) ? WORK_QUEUE_TAB_LABELS[input.ActiveTab] : input.ActiveTab,
+        SubscriptionCount: input.Subscriptions.length,
+        Subscriptions: input.Subscriptions.slice(0, WORK_QUEUE_CONTEXT_LIST_CAP).map((s) => `${s.Name} (${s.Topic} / ${s.PartitionMode}, ${s.Status})`),
+        StatsLoaded: input.StatsLoaded,
+        Totals: totals,
+        SubscriptionsNeedingAttentionCount: attention.length,
+        SubscriptionsNeedingAttention: attention.slice(0, WORK_QUEUE_CONTEXT_LIST_CAP).map((s) => ({
+            Name: s.Name, DeadLettered: s.DeadLettered, BlockedKeys: s.BlockedKeys, OldestPendingAgeSeconds: s.OldestPendingAgeSeconds,
+        })),
+        StatsFailures: input.StatsFailures.slice(0, WORK_QUEUE_CONTEXT_LIST_CAP),
+        SelectedSubscription: input.SelectedSubscription,
+        LastRefreshedAt: input.LastRefreshedAt,
+    };
+    if (input.ActiveTab === 'dead-letters') {
+        context['DeadLetterCount'] = input.DeadLetterCount;
+        context['SelectedDeadLetterCount'] = input.SelectedDeadLetterCount;
+    }
+    if (input.ActiveTab === 'partitions') {
+        context['PartitionCondition'] = input.PartitionCondition;
+    }
+    if (input.ActiveTab === 'bindings') {
+        context['BindingErrorCount'] = input.BindingErrorCount;
+        context['BindingWarningCount'] = input.BindingWarningCount;
+    }
+    return context;
+}
+//# sourceMappingURL=work-queue-agent-context.js.map

package/dist/WorkQueue/work-queue-agent-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-queue-agent-context.js","sourceRoot":"","sources":["../../src/WorkQueue/work-queue-agent-context.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Pure helpers for the Work Queue dashboard: tab ids, attention ordering, age formatting, the\n * tolerant subscription resolver the agent tools use, and the agent-context shaping. No Angular imports, so\n * every function here is unit-tested in isolation (see __tests__/work-queue-agent-context.test.ts).\n *\n * 🔒 SAFETY: the agent surface is read-only and navigational. Replay and discard are mutations that must be\n * confirmed by the user in the UI; the tools registered by the dashboard never execute them.\n */\nimport { UUIDsEqual } from '@memberjunction/global';\n\nexport const WORK_QUEUE_TABS = ['overview', 'dead-letters', 'partitions', 'bindings'] as const;\nexport type WorkQueueTab = (typeof WORK_QUEUE_TABS)[number];\n\nexport const WORK_QUEUE_TAB_LABELS: Record<WorkQueueTab, string> = {\n    overview: 'Overview',\n    'dead-letters': 'Dead Letters',\n    partitions: 'Partitions',\n    bindings: 'Bindings',\n};\n\n/** The partition conditions WorkQueue.ListPartitions accepts (03 §5.2). */\nexport const WORK_QUEUE_PARTITION_CONDITIONS = ['Blocked', 'InFlight', 'Idle'] as const;\nexport type WorkQueuePartitionCondition = (typeof WORK_QUEUE_PARTITION_CONDITIONS)[number];\n\n/** Upper bound on any list published in the agent context; a companion count reports the true total. */\nexport const WORK_QUEUE_CONTEXT_LIST_CAP = 25;\n\nexport function IsValidWorkQueueTab(value: unknown): value is WorkQueueTab {\n    return typeof value === 'string' && (WORK_QUEUE_TABS as readonly string[]).includes(value);\n}\n\nexport function IsValidPartitionCondition(value: unknown): value is WorkQueuePartitionCondition {\n    return typeof value === 'string' && (WORK_QUEUE_PARTITION_CONDITIONS as readonly string[]).includes(value);\n}\n\n/** One subscription as the dashboard reports it to the agent: topology plus the last stats read (null until loaded). */\nexport interface WorkQueueSubscriptionSnapshot {\n    ID: string;\n    Name: string;\n    Topic: string;\n    Transport: string;\n    PartitionMode: string;\n    Status: string;\n    Pending: number | null;\n    InFlight: number | null;\n    DeadLettered: number | null;\n    BlockedKeys: number | null;\n    OldestPendingAgeSeconds: number | null;\n}\n\n/** A subscription needs an operator when it holds dead letters or a blocked Ordered key. */\nexport function NeedsAttention(snapshot: Pick<WorkQueueSubscriptionSnapshot, 'DeadLettered' | 'BlockedKeys'>): boolean {\n    return (snapshot.DeadLettered ?? 0) > 0 || (snapshot.BlockedKeys ?? 0) > 0;\n}\n\n/** Attention first, then by name; returns a new array. */\nexport function SortByAttention<T extends Pick<WorkQueueSubscriptionSnapshot, 'DeadLettered' | 'BlockedKeys' | 'Name'>>(items: readonly T[]): T[] {\n    return [...items].sort((a, b) => {\n        const attention = Number(NeedsAttention(b)) - Number(NeedsAttention(a));\n        return attention !== 0 ? attention : a.Name.localeCompare(b.Name);\n    });\n}\n\n/** '—' for null, then s / m / h m / d h at the coarsest useful unit. */\nexport function FormatAge(seconds: number | null | undefined): string {\n    if (seconds === null || seconds === undefined || !Number.isFinite(seconds) || seconds < 0) {\n        return '—';\n    }\n    const s = Math.floor(seconds);\n    if (s < 60) return `${s}s`;\n    const m = Math.floor(s / 60);\n    if (m < 60) return `${m}m`;\n    const h = Math.floor(m / 60);\n    if (h < 24) return `${h}h ${m % 60}m`;\n    const d = Math.floor(h / 24);\n    return `${d}d ${h % 24}h`;\n}\n\nexport interface SubscriptionCandidate {\n    ID: string;\n    Name: string;\n}\n\nexport type SubscriptionResolution<T extends SubscriptionCandidate> =\n    | { Kind: 'Match'; Item: T }\n    | { Kind: 'Ambiguous'; Matches: T[] }\n    | { Kind: 'NotFound' };\n\n/**\n * Resolves an agent-supplied id or name tolerantly: exact id, then exact name (case-insensitive), then a unique\n * case-insensitive substring of the name. Several substring matches are reported as Ambiguous, never guessed.\n */\nexport function ResolveSubscription<T extends SubscriptionCandidate>(candidates: readonly T[], query: string): SubscriptionResolution<T> {\n    const needle = query.trim();\n    if (needle === '') {\n        return { Kind: 'NotFound' };\n    }\n    const byId = candidates.find((c) => UUIDsEqual(c.ID, needle));\n    if (byId) return { Kind: 'Match', Item: byId };\n    const lower = needle.toLowerCase();\n    const byName = candidates.find((c) => c.Name.toLowerCase() === lower);\n    if (byName) return { Kind: 'Match', Item: byName };\n    const partial = candidates.filter((c) => c.Name.toLowerCase().includes(lower));\n    if (partial.length === 1) return { Kind: 'Match', Item: partial[0] };\n    return partial.length > 1 ? { Kind: 'Ambiguous', Matches: partial } : { Kind: 'NotFound' };\n}\n\nexport interface WorkQueueAgentContextInput {\n    ActiveTab: string;\n    Subscriptions: WorkQueueSubscriptionSnapshot[];\n    StatsFailures: string[];\n    StatsLoaded: boolean;\n    SelectedSubscription: string | null;\n    PartitionCondition: WorkQueuePartitionCondition | null;\n    DeadLetterCount: number | null;\n    SelectedDeadLetterCount: number;\n    BindingErrorCount: number | null;\n    BindingWarningCount: number | null;\n    LastRefreshedAt: string | null;\n}\n\n/**\n * Shapes the dashboard state for NavigationService.SetAgentContext. Counts come only from loaded stats: before the\n * first stats read the aggregate fields are null rather than fabricated zeros.\n */\nexport function BuildWorkQueueAgentContext(input: WorkQueueAgentContextInput): Record<string, unknown> {\n    const attention = SortByAttention(input.Subscriptions).filter(NeedsAttention);\n    const totals = input.StatsLoaded\n        ? input.Subscriptions.reduce(\n            (acc, s) => ({\n                Pending: acc.Pending + (s.Pending ?? 0),\n                InFlight: acc.InFlight + (s.InFlight ?? 0),\n                DeadLettered: acc.DeadLettered + (s.DeadLettered ?? 0),\n                BlockedKeys: acc.BlockedKeys + (s.BlockedKeys ?? 0),\n            }),\n            { Pending: 0, InFlight: 0, DeadLettered: 0, BlockedKeys: 0 },\n        )\n        : null;\n    const context: Record<string, unknown> = {\n        Surface: 'WorkQueue',\n        ActiveTab: input.ActiveTab,\n        ActiveTabLabel: IsValidWorkQueueTab(input.ActiveTab) ? WORK_QUEUE_TAB_LABELS[input.ActiveTab] : input.ActiveTab,\n        SubscriptionCount: input.Subscriptions.length,\n        Subscriptions: input.Subscriptions.slice(0, WORK_QUEUE_CONTEXT_LIST_CAP).map((s) => `${s.Name} (${s.Topic} / ${s.PartitionMode}, ${s.Status})`),\n        StatsLoaded: input.StatsLoaded,\n        Totals: totals,\n        SubscriptionsNeedingAttentionCount: attention.length,\n        SubscriptionsNeedingAttention: attention.slice(0, WORK_QUEUE_CONTEXT_LIST_CAP).map((s) => ({\n            Name: s.Name, DeadLettered: s.DeadLettered, BlockedKeys: s.BlockedKeys, OldestPendingAgeSeconds: s.OldestPendingAgeSeconds,\n        })),\n        StatsFailures: input.StatsFailures.slice(0, WORK_QUEUE_CONTEXT_LIST_CAP),\n        SelectedSubscription: input.SelectedSubscription,\n        LastRefreshedAt: input.LastRefreshedAt,\n    };\n    if (input.ActiveTab === 'dead-letters') {\n        context['DeadLetterCount'] = input.DeadLetterCount;\n        context['SelectedDeadLetterCount'] = input.SelectedDeadLetterCount;\n    }\n    if (input.ActiveTab === 'partitions') {\n        context['PartitionCondition'] = input.PartitionCondition;\n    }\n    if (input.ActiveTab === 'bindings') {\n        context['BindingErrorCount'] = input.BindingErrorCount;\n        context['BindingWarningCount'] = input.BindingWarningCount;\n    }\n    return context;\n}\n"]}

package/dist/WorkQueue/work-queue-dashboard.component.d.ts

@@ -0,0 +1,94 @@
+import { AfterViewInit, ChangeDetectorRef, OnDestroy } from '@angular/core';
+import { BaseDashboard } from '@memberjunction/ng-shared';
+import { ResourceData } from '@memberjunction/core-entities';
+import { TabConfig } from '@memberjunction/ng-ui-components';
+import { WorkQueueOperatorService } from './services/work-queue-operator.service';
+import { WorkQueuePartitionCondition, WorkQueueTab } from './work-queue-agent-context';
+import type { WorkQueueOverviewRow, WorkQueueRecordOpenRequest, WorkQueueSubscriptionOption, WorkQueueTransportOption } from './work-queue-types';
+import * as i0 from "@angular/core";
+/**
+ * Work Queue operator dashboard (spec 09b): topology + live stats, dead-letter triage, Ordered partition state and
+ * binding validation, on top of the seven WorkQueue.* remote operations. The dashboard owns the topology load
+ * (WorkQueueEngineBase) and the stats read; each tab owns its own operation calls through WorkQueueOperatorService.
+ *
+ * 🔒 SAFETY BOUNDARY: the agent tools registered here are read-only and navigational. Replay and discard are
+ * mutations that require the operator's explicit confirmation in the UI and are never exposed as tools.
+ */
+export declare class WorkQueueDashboardComponent extends BaseDashboard implements AfterViewInit, OnDestroy {
+    private readonly cdr;
+    private readonly operator;
+    IsLoading: boolean;
+    LoadError: string | null;
+    ActiveTab: WorkQueueTab;
+    SelectedSubscription: string | null;
+    PartitionCondition: WorkQueuePartitionCondition | null;
+    Rows: WorkQueueOverviewRow[];
+    SubscriptionOptions: WorkQueueSubscriptionOption[];
+    TransportOptions: WorkQueueTransportOption[];
+    StatsFailures: string[];
+    StatsLoaded: boolean;
+    LastRefreshedAt: Date | null;
+    /** Update on MJ: Work Queue Subscriptions gates replay/discard (spec 09b §permissions). */
+    CanOperate: boolean;
+    DeadLetterCount: number | null;
+    SelectedDeadLetterCount: number;
+    BlockedPartitionCount: number | null;
+    BindingErrorCount: number | null;
+    BindingWarningCount: number | null;
+    private isVisible;
+    private autoRefreshHandle;
+    private readonly stateChangeSubject;
+    private lastRegisteredToolTab;
+    constructor(cdr: ChangeDetectorRef, operator: WorkQueueOperatorService);
+    GetResourceDisplayName(_data: ResourceData): Promise<string>;
+    GetResourceIconClass(_data: ResourceData): Promise<string>;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    SetVisible(visible: boolean): void;
+    protected initDashboard(): void;
+    protected loadData(): Promise<void>;
+    protected OnQueryParamsChanged(params: Record<string, string>, _source: 'popstate' | 'deeplink'): void;
+    get Tabs(): TabConfig[];
+    get TotalPending(): number;
+    get TotalInFlight(): number;
+    get TotalDeadLettered(): number;
+    get TotalBlockedKeys(): number;
+    OnTabChange(tabId: string): void;
+    OnSubscriptionChange(name: string | null): void;
+    OnConditionChange(condition: WorkQueuePartitionCondition | null): void;
+    /** Overview row click: jump to the dead letters of that subscription. */
+    OnOverviewSubscriptionSelected(name: string): void;
+    OnOpenRecord(request: WorkQueueRecordOpenRequest): void;
+    OnDeadLettersLoaded(event: {
+        Count: number;
+        Selected: number;
+    }): void;
+    OnPartitionsLoaded(event: {
+        Count: number;
+        Blocked: number;
+    }): void;
+    OnBindingsLoaded(event: {
+        Errors: number;
+        Warnings: number;
+    }): void;
+    /** A tab reports that replay/discard changed queue state: re-read stats so badges and totals catch up. */
+    OnQueueChanged(): void;
+    private buildTopology;
+    private refreshStats;
+    private startAutoRefresh;
+    private stopAutoRefresh;
+    private resolveCanOperate;
+    private applyQueryParams;
+    private applyUserState;
+    private emitStateChange;
+    private get subscriptionSnapshots();
+    private publishAgentContext;
+    private syncAgentToolsForTab;
+    private buildCommonTools;
+    private buildFilterPartitionsTool;
+    private selectSubscriptionTool;
+    private resolveSubscriptionParam;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WorkQueueDashboardComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<WorkQueueDashboardComponent, "mj-work-queue-dashboard", never, {}, {}, never, never, false, never>;
+}
+//# sourceMappingURL=work-queue-dashboard.component.d.ts.map

package/dist/WorkQueue/work-queue-dashboard.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-queue-dashboard.component.d.ts","sourceRoot":"","sources":["../../src/WorkQueue/work-queue-dashboard.component.ts"],"names":[],"mappings":"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"}