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

package/dist/shared/dashboard-recents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-recents.js","sourceRoot":"","sources":["../../src/shared/dashboard-recents.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview The user's recently opened dashboards, for the Library (its order and Recently\n * opened).\n *\n * The list comes from a query of the user's MJ: User Record Logs for the MJ: Dashboards entity, so it\n * lists every dashboard the user opened, not only the dashboards among the latest records of any\n * entity. Record logs are not cached, so the list is read again each time it can have changed.\n *\n * Opening a dashboard saves a record log (RecentAccessService.LogAccess). The service then reloads its\n * recent items and emits RecentItems, after the log is saved. ObserveRecentDashboardIds reads the list\n * again each time its trigger emits, so a caller that passes RecentItems shows the new open.\n */\nimport { LogError, RunView } from '@memberjunction/core';\nimport type { IMetadataProvider } from '@memberjunction/core';\nimport { EscapeSQLString, UUIDsEqual } from '@memberjunction/global';\nimport { from, Observable } from 'rxjs';\nimport { switchMap } from 'rxjs/operators';\n\n/** The entity whose record logs are dashboard opens. */\nexport const DASHBOARDS_ENTITY_NAME = 'MJ: Dashboards';\n\nconst USER_RECORD_LOGS_ENTITY_NAME = 'MJ: User Record Logs';\n\n/** A record log, as far as dashboard recents need it. A simple RunView row can carry `LatestAt` as text. */\nexport interface DashboardRecordLog {\n  RecordID: string;\n  LatestAt: Date | string;\n}\n\n/**\n * The record ids of `logs`, most recently opened first, each id once (compared with UUIDsEqual,\n * keeping the newest), at most `maxItems` of them. Logs without a record id are skipped.\n */\nexport function OrderRecentDashboardIds(logs: ReadonlyArray<DashboardRecordLog>, maxItems: number = Number.POSITIVE_INFINITY): string[] {\n  const newestFirst = [...logs].sort((a, b) => timeOf(b.LatestAt) - timeOf(a.LatestAt));\n  const ids: string[] = [];\n  for (const log of newestFirst) {\n    if (ids.length >= maxItems) {\n      break;\n    }\n    if (log.RecordID && !ids.some(id => UUIDsEqual(id, log.RecordID))) {\n      ids.push(log.RecordID);\n    }\n  }\n  return ids;\n}\n\n/**\n * Loads the ids of the dashboards the current user of `provider` opened, most recent first, at most\n * `maxItems` (all of them when omitted), with one query of the user's MJ: User Record Logs for the\n * MJ: Dashboards entity. Returns an empty list when the metadata has no MJ: Dashboards entity, there\n * is no current user, or the query fails or throws (for example when the user cannot read the record\n * logs, or the server cannot be reached). A failed or thrown read is logged; it never rejects.\n */\nexport async function LoadRecentDashboardIds(provider: IMetadataProvider, maxItems?: number): Promise<string[]> {\n  const dashboardsEntity = provider.EntityByName(DASHBOARDS_ENTITY_NAME);\n  const user = provider.CurrentUser;\n  if (!dashboardsEntity || !user) {\n    return [];\n  }\n  try {\n    const result = await RunView.FromMetadataProvider(provider).RunView<DashboardRecordLog>({\n      EntityName: USER_RECORD_LOGS_ENTITY_NAME,\n      ExtraFilter: `UserID='${EscapeSQLString(user.ID)}' AND EntityID='${EscapeSQLString(dashboardsEntity.ID)}'`,\n      OrderBy: 'LatestAt DESC',\n      Fields: ['RecordID', 'LatestAt'],\n      ResultType: 'simple',\n    });\n    if (!result.Success) {\n      LogError(`Recently opened dashboards could not be read: ${result.ErrorMessage}`);\n      return [];\n    }\n    return OrderRecentDashboardIds(result.Results, maxItems);\n  } catch (error) {\n    LogError(`Recently opened dashboards could not be read: ${error instanceof Error ? error.message : String(error)}`);\n    return [];\n  }\n}\n\n/**\n * Emits the ids of the dashboards the current user opened (see {@link LoadRecentDashboardIds}) each\n * time `trigger` emits, read again each time. A read that a newer emission overtakes is dropped.\n * With the default `load`, a read that fails or throws gives an empty list, so the stream keeps running.\n *\n * @param provider The provider whose metadata and current user the read uses.\n * @param trigger Emits when the list can have changed, for example RecentAccessService.RecentItems,\n *   which emits after a dashboard open is logged.\n * @param load Reads the ids. The default is {@link LoadRecentDashboardIds}.\n */\nexport function ObserveRecentDashboardIds(\n  provider: IMetadataProvider,\n  trigger: Observable<unknown>,\n  load: (provider: IMetadataProvider) => Promise<string[]> = LoadRecentDashboardIds\n): Observable<string[]> {\n  return trigger.pipe(switchMap(() => from(load(provider))));\n}\n\n/** Milliseconds since the epoch, or 0 for a missing or invalid date. */\nfunction timeOf(value: Date | string): number {\n  const time = new Date(value).getTime();\n  return Number.isNaN(time) ? 0 : time;\n}\n"]}

package/dist/shared/dashboards-app-install.d.ts

@@ -0,0 +1,59 @@
+import type { UserApplicationAccessStatus } from '@memberjunction/core-entities';
+/**
+ * UserInfoEngine setting that records the one-time automatic install of the Dashboards app.
+ * The value is 'true' when set.
+ */
+export declare const DASHBOARDS_APP_AUTO_INSTALL_SETTING_KEY = "Dashboards.AppAutoInstalled";
+/**
+ * How long one install step (the install, or the marker save) may take. A step that takes longer
+ * counts as failed, so the install queue moves on and its callers are not held.
+ */
+export declare const DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS = 5000;
+/** What the install paths know about the Dashboards app and the current user. */
+export interface DashboardsAppInstallState {
+    /** An Active application named Dashboards exists in metadata. */
+    AppExists: boolean;
+    /** The user's access to the app: role authorization, then the UserApplication row. Ignored when AppExists is false. */
+    Access: UserApplicationAccessStatus;
+    /** The one-time automatic install is recorded for the user. */
+    AutoInstallRecorded: boolean;
+}
+/** The operations the install paths call. `dashboards-app.helpers.ts` builds them from ApplicationManager and UserInfoEngine. */
+export interface DashboardsAppInstallOperations {
+    /** The current state, or null when the user's app data cannot be read. */
+    ReadState(): DashboardsAppInstallState | null;
+    /** Installs or re-enables the app for the user and refreshes the user's app list. Resolves true on success. */
+    Install(): Promise<boolean>;
+    /** Saves the one-time automatic-install marker. Resolves true on success. */
+    RecordAutoInstall(): Promise<boolean>;
+}
+/** What a Home load does about the Dashboards app. */
+export type DashboardsAppAutoInstallAction = 'install' | 'skip';
+/** What a user click that goes to the Dashboards app does before it navigates. */
+export type DashboardsAppExplicitInstallAction = 'open' | 'install' | 'unavailable';
+/**
+ * The automatic path installs only for a user with no UserApplication row for the app and no
+ * recorded install. An inactive row means the user removed the app, so it is left alone.
+ */
+export declare function DecideDashboardsAppAutoInstall(state: DashboardsAppInstallState): DashboardsAppAutoInstallAction;
+/**
+ * The explicit path ignores the marker: a missing or removed app is installed, an active one
+ * opens, and a missing or unauthorized app is unavailable.
+ */
+export declare function DecideDashboardsAppExplicitInstall(state: DashboardsAppInstallState): DashboardsAppExplicitInstallAction;
+/**
+ * Automatic path (Home load). Installs the app when {@link DecideDashboardsAppAutoInstall} says so,
+ * then records the marker. The marker is written only after a successful install, so a failed or
+ * timed-out install is retried on the next load. Each step waits at most
+ * {@link DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS}.
+ * @returns true when this call installed the app.
+ */
+export declare function RunDashboardsAppAutoInstall(operations: DashboardsAppInstallOperations): Promise<boolean>;
+/**
+ * Explicit path (a user click that goes to the app). Installs the app when it is missing or
+ * removed, and records the marker if it is not set yet. Each step waits at most
+ * {@link DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS}.
+ * @returns true when the user has the app active afterwards, so the caller can navigate.
+ */
+export declare function RunDashboardsAppExplicitInstall(operations: DashboardsAppInstallOperations): Promise<boolean>;
+//# sourceMappingURL=dashboards-app-install.d.ts.map

package/dist/shared/dashboards-app-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboards-app-install.d.ts","sourceRoot":"","sources":["../../src/shared/dashboards-app-install.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAEjF;;;GAGG;AACH,eAAO,MAAM,uCAAuC,gCAAgC,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,sCAAsC,OAAO,CAAC;AAE3D,iFAAiF;AACjF,MAAM,WAAW,yBAAyB;IACxC,iEAAiE;IACjE,SAAS,EAAE,OAAO,CAAC;IACnB,uHAAuH;IACvH,MAAM,EAAE,2BAA2B,CAAC;IACpC,+DAA+D;IAC/D,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,iIAAiI;AACjI,MAAM,WAAW,8BAA8B;IAC7C,0EAA0E;IAC1E,SAAS,IAAI,yBAAyB,GAAG,IAAI,CAAC;IAC9C,+GAA+G;IAC/G,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,6EAA6E;IAC7E,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACvC;AAED,sDAAsD;AACtD,MAAM,MAAM,8BAA8B,GAAG,SAAS,GAAG,MAAM,CAAC;AAEhE,kFAAkF;AAClF,MAAM,MAAM,kCAAkC,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC;AAEpF;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,yBAAyB,GAAG,8BAA8B,CAG/G;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,yBAAyB,GAAG,kCAAkC,CAKvH;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,8BAA8B,GAAG,OAAO,CAAC,OAAO,CAAC,CAYxG;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,8BAA8B,GAAG,OAAO,CAAC,OAAO,CAAC,CAkB5G"}

package/dist/shared/dashboards-app-install.js

@@ -0,0 +1,97 @@
+import { LogError } from '@memberjunction/core';
+/**
+ * UserInfoEngine setting that records the one-time automatic install of the Dashboards app.
+ * The value is 'true' when set.
+ */
+export const DASHBOARDS_APP_AUTO_INSTALL_SETTING_KEY = 'Dashboards.AppAutoInstalled';
+/**
+ * How long one install step (the install, or the marker save) may take. A step that takes longer
+ * counts as failed, so the install queue moves on and its callers are not held.
+ */
+export const DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS = 5000;
+/**
+ * The automatic path installs only for a user with no UserApplication row for the app and no
+ * recorded install. An inactive row means the user removed the app, so it is left alone.
+ */
+export function DecideDashboardsAppAutoInstall(state) {
+    const install = state.AppExists && state.Access === 'not_installed' && !state.AutoInstallRecorded;
+    return install ? 'install' : 'skip';
+}
+/**
+ * The explicit path ignores the marker: a missing or removed app is installed, an active one
+ * opens, and a missing or unauthorized app is unavailable.
+ */
+export function DecideDashboardsAppExplicitInstall(state) {
+    if (!state.AppExists || state.Access === 'not_authorized') {
+        return 'unavailable';
+    }
+    return state.Access === 'installed_active' ? 'open' : 'install';
+}
+/**
+ * Automatic path (Home load). Installs the app when {@link DecideDashboardsAppAutoInstall} says so,
+ * then records the marker. The marker is written only after a successful install, so a failed or
+ * timed-out install is retried on the next load. Each step waits at most
+ * {@link DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS}.
+ * @returns true when this call installed the app.
+ */
+export function RunDashboardsAppAutoInstall(operations) {
+    return runOneAtATime(async () => {
+        const state = operations.ReadState();
+        if (!state || DecideDashboardsAppAutoInstall(state) === 'skip') {
+            return false;
+        }
+        if (!(await withStepTimeout(operations.Install(), 'the install'))) {
+            return false;
+        }
+        await withStepTimeout(operations.RecordAutoInstall(), 'the marker save');
+        return true;
+    });
+}
+/**
+ * Explicit path (a user click that goes to the app). Installs the app when it is missing or
+ * removed, and records the marker if it is not set yet. Each step waits at most
+ * {@link DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS}.
+ * @returns true when the user has the app active afterwards, so the caller can navigate.
+ */
+export function RunDashboardsAppExplicitInstall(operations) {
+    return runOneAtATime(async () => {
+        const state = operations.ReadState();
+        if (!state) {
+            return false;
+        }
+        const action = DecideDashboardsAppExplicitInstall(state);
+        if (action !== 'install') {
+            return action === 'open';
+        }
+        if (!(await withStepTimeout(operations.Install(), 'the install'))) {
+            return false;
+        }
+        if (!state.AutoInstallRecorded) {
+            await withStepTimeout(operations.RecordAutoInstall(), 'the marker save');
+        }
+        return true;
+    });
+}
+/**
+ * Resolves with the step's result, or with false when the step does not settle within
+ * {@link DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS}. A timed-out step is logged and keeps running in
+ * the background, but nothing waits for it. The timer is cleared when the step settles first.
+ */
+function withStepTimeout(step, stepName) {
+    let timer;
+    const timedOut = new Promise((resolve) => {
+        timer = setTimeout(() => {
+            LogError(`Dashboards app install: ${stepName} did not finish within ${DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS} ms, so it counts as failed`);
+            resolve(false);
+        }, DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS);
+    });
+    return Promise.race([step, timedOut]).finally(() => clearTimeout(timer));
+}
+let installQueue = Promise.resolve();
+/** Runs install work one call at a time, so each call reads the state the previous call left. */
+function runOneAtATime(work) {
+    const run = installQueue.then(work);
+    installQueue = run.catch(() => undefined);
+    return run;
+}
+//# sourceMappingURL=dashboards-app-install.js.map

package/dist/shared/dashboards-app-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboards-app-install.js","sourceRoot":"","sources":["../../src/shared/dashboards-app-install.ts"],"names":[],"mappings":"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","sourcesContent":["import { LogError } from '@memberjunction/core';\nimport type { UserApplicationAccessStatus } from '@memberjunction/core-entities';\n\n/**\n * UserInfoEngine setting that records the one-time automatic install of the Dashboards app.\n * The value is 'true' when set.\n */\nexport const DASHBOARDS_APP_AUTO_INSTALL_SETTING_KEY = 'Dashboards.AppAutoInstalled';\n\n/**\n * How long one install step (the install, or the marker save) may take. A step that takes longer\n * counts as failed, so the install queue moves on and its callers are not held.\n */\nexport const DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS = 5000;\n\n/** What the install paths know about the Dashboards app and the current user. */\nexport interface DashboardsAppInstallState {\n  /** An Active application named Dashboards exists in metadata. */\n  AppExists: boolean;\n  /** The user's access to the app: role authorization, then the UserApplication row. Ignored when AppExists is false. */\n  Access: UserApplicationAccessStatus;\n  /** The one-time automatic install is recorded for the user. */\n  AutoInstallRecorded: boolean;\n}\n\n/** The operations the install paths call. `dashboards-app.helpers.ts` builds them from ApplicationManager and UserInfoEngine. */\nexport interface DashboardsAppInstallOperations {\n  /** The current state, or null when the user's app data cannot be read. */\n  ReadState(): DashboardsAppInstallState | null;\n  /** Installs or re-enables the app for the user and refreshes the user's app list. Resolves true on success. */\n  Install(): Promise<boolean>;\n  /** Saves the one-time automatic-install marker. Resolves true on success. */\n  RecordAutoInstall(): Promise<boolean>;\n}\n\n/** What a Home load does about the Dashboards app. */\nexport type DashboardsAppAutoInstallAction = 'install' | 'skip';\n\n/** What a user click that goes to the Dashboards app does before it navigates. */\nexport type DashboardsAppExplicitInstallAction = 'open' | 'install' | 'unavailable';\n\n/**\n * The automatic path installs only for a user with no UserApplication row for the app and no\n * recorded install. An inactive row means the user removed the app, so it is left alone.\n */\nexport function DecideDashboardsAppAutoInstall(state: DashboardsAppInstallState): DashboardsAppAutoInstallAction {\n  const install = state.AppExists && state.Access === 'not_installed' && !state.AutoInstallRecorded;\n  return install ? 'install' : 'skip';\n}\n\n/**\n * The explicit path ignores the marker: a missing or removed app is installed, an active one\n * opens, and a missing or unauthorized app is unavailable.\n */\nexport function DecideDashboardsAppExplicitInstall(state: DashboardsAppInstallState): DashboardsAppExplicitInstallAction {\n  if (!state.AppExists || state.Access === 'not_authorized') {\n    return 'unavailable';\n  }\n  return state.Access === 'installed_active' ? 'open' : 'install';\n}\n\n/**\n * Automatic path (Home load). Installs the app when {@link DecideDashboardsAppAutoInstall} says so,\n * then records the marker. The marker is written only after a successful install, so a failed or\n * timed-out install is retried on the next load. Each step waits at most\n * {@link DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS}.\n * @returns true when this call installed the app.\n */\nexport function RunDashboardsAppAutoInstall(operations: DashboardsAppInstallOperations): Promise<boolean> {\n  return runOneAtATime(async () => {\n    const state = operations.ReadState();\n    if (!state || DecideDashboardsAppAutoInstall(state) === 'skip') {\n      return false;\n    }\n    if (!(await withStepTimeout(operations.Install(), 'the install'))) {\n      return false;\n    }\n    await withStepTimeout(operations.RecordAutoInstall(), 'the marker save');\n    return true;\n  });\n}\n\n/**\n * Explicit path (a user click that goes to the app). Installs the app when it is missing or\n * removed, and records the marker if it is not set yet. Each step waits at most\n * {@link DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS}.\n * @returns true when the user has the app active afterwards, so the caller can navigate.\n */\nexport function RunDashboardsAppExplicitInstall(operations: DashboardsAppInstallOperations): Promise<boolean> {\n  return runOneAtATime(async () => {\n    const state = operations.ReadState();\n    if (!state) {\n      return false;\n    }\n    const action = DecideDashboardsAppExplicitInstall(state);\n    if (action !== 'install') {\n      return action === 'open';\n    }\n    if (!(await withStepTimeout(operations.Install(), 'the install'))) {\n      return false;\n    }\n    if (!state.AutoInstallRecorded) {\n      await withStepTimeout(operations.RecordAutoInstall(), 'the marker save');\n    }\n    return true;\n  });\n}\n\n/**\n * Resolves with the step's result, or with false when the step does not settle within\n * {@link DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS}. A timed-out step is logged and keeps running in\n * the background, but nothing waits for it. The timer is cleared when the step settles first.\n */\nfunction withStepTimeout(step: Promise<boolean>, stepName: string): Promise<boolean> {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const timedOut = new Promise<boolean>((resolve) => {\n    timer = setTimeout(() => {\n      LogError(`Dashboards app install: ${stepName} did not finish within ${DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS} ms, so it counts as failed`);\n      resolve(false);\n    }, DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS);\n  });\n  return Promise.race([step, timedOut]).finally(() => clearTimeout(timer));\n}\n\nlet installQueue: Promise<unknown> = Promise.resolve();\n\n/** Runs install work one call at a time, so each call reads the state the previous call left. */\nfunction runOneAtATime<T>(work: () => Promise<T>): Promise<T> {\n  const run = installQueue.then(work);\n  installQueue = run.catch(() => undefined);\n  return run;\n}\n"]}

package/dist/shared/dashboards-app.helpers.d.ts

@@ -0,0 +1,42 @@
+import type { IMetadataProvider } from '@memberjunction/core';
+import type { MJDashboardEntity } from '@memberjunction/core-entities';
+import type { ApplicationManager, BaseApplication } from '@memberjunction/ng-base-application';
+import type { DashboardNavigationOptions } from '@memberjunction/ng-shared';
+export declare const DASHBOARDS_APP_NAME = "Dashboards";
+/** Label of the Dashboards app's Library nav item. */
+export declare const DASHBOARDS_LIBRARY_NAV_ITEM = "Library";
+/** The Dashboards application, if the user has it enabled. */
+export declare function FindDashboardsApp(appManager: ApplicationManager): BaseApplication | undefined;
+/**
+ * The NavigationService.OpenDashboard options for a dashboard opened from a page of the Dashboards
+ * app: a tab of the Dashboards app. Like any open, the dashboard replaces the current preview tab,
+ * so Back returns to the page, and a Shift-click opens a separate tab. When the user does not have
+ * the app, no application is named and the tab opens in NavigationService's default application.
+ * `openInEditMode` asks the tab to enter edit mode (a new dashboard, or a card's Edit action).
+ * `openInNewTab` forces a separate tab, for a click the dashboard browser reports as one
+ * (`DashboardOpenEvent.OpenInNewTab`: Shift, Ctrl or Cmd).
+ */
+export declare function DashboardsAppOpenOptions(appManager: ApplicationManager, openInEditMode?: boolean, openInNewTab?: boolean): DashboardNavigationOptions;
+/** The longest name MJ: Dashboards stores: the MaxLength of its Name field, or DASHBOARD_NAME_MAX_LENGTH when the metadata gives none. */
+export declare function DashboardNameMaxLength(md: IMetadataProvider): number;
+/**
+ * Creates and saves an empty Config dashboard with the trimmed `name`, owned by the current user, in
+ * `categoryId` when one is given. Returns null for a blank name or a failed save.
+ */
+export declare function CreateBlankDashboard(md: IMetadataProvider, name: string, categoryId?: string | null): Promise<MJDashboardEntity | null>;
+/**
+ * Automatic install path, for Home load. Installs the Dashboards app for a user who has no
+ * UserApplication row for it, at most once per user (tracked by a UserInfoEngine setting), so a
+ * user who removes the app keeps it removed. Never rejects.
+ * @returns true when this call installed the app.
+ */
+export declare function AutoInstallDashboardsApp(appManager: ApplicationManager): Promise<boolean>;
+/**
+ * Explicit install path, for a user click that goes to the Dashboards app (for example Open
+ * Dashboards on the Data Explorer banner). Installs the app when it is missing or removed. Never rejects.
+ * @returns the app to pass to `NavigationService.SwitchToApp`, or undefined when no Active
+ * Dashboards app exists, the user is not authorized for it, or the install failed or did not
+ * finish within DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS.
+ */
+export declare function EnsureDashboardsApp(appManager: ApplicationManager): Promise<BaseApplication | undefined>;
+//# sourceMappingURL=dashboards-app.helpers.d.ts.map

package/dist/shared/dashboards-app.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboards-app.helpers.d.ts","sourceRoot":"","sources":["../../src/shared/dashboards-app.helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC/F,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAU5E,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAEhD,sDAAsD;AACtD,eAAO,MAAM,2BAA2B,YAAY,CAAC;AAErD,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,kBAAkB,GAAG,eAAe,GAAG,SAAS,CAE7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,kBAAkB,EAAE,cAAc,UAAQ,EAAE,YAAY,UAAQ,GAAG,0BAA0B,CAOjJ;AAKD,0IAA0I;AAC1I,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,iBAAiB,GAAG,MAAM,CAGpE;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAwB7I;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ/F;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAgB9G"}

package/dist/shared/dashboards-app.helpers.js

@@ -0,0 +1,143 @@
+import { LogError } from '@memberjunction/core';
+import { UserInfoEngine } from '@memberjunction/core-entities';
+import { CreateDefaultDashboardConfig, DASHBOARD_NAME_MAX_LENGTH } from '@memberjunction/ng-dashboard-viewer';
+import { DASHBOARDS_APP_AUTO_INSTALL_SETTING_KEY, RunDashboardsAppAutoInstall, RunDashboardsAppExplicitInstall, } from './dashboards-app-install';
+export const DASHBOARDS_APP_NAME = 'Dashboards';
+/** Label of the Dashboards app's Library nav item. */
+export const DASHBOARDS_LIBRARY_NAV_ITEM = 'Library';
+/** The Dashboards application, if the user has it enabled. */
+export function FindDashboardsApp(appManager) {
+    return appManager.GetAllApps().find((a) => a.Name === DASHBOARDS_APP_NAME);
+}
+/**
+ * The NavigationService.OpenDashboard options for a dashboard opened from a page of the Dashboards
+ * app: a tab of the Dashboards app. Like any open, the dashboard replaces the current preview tab,
+ * so Back returns to the page, and a Shift-click opens a separate tab. When the user does not have
+ * the app, no application is named and the tab opens in NavigationService's default application.
+ * `openInEditMode` asks the tab to enter edit mode (a new dashboard, or a card's Edit action).
+ * `openInNewTab` forces a separate tab, for a click the dashboard browser reports as one
+ * (`DashboardOpenEvent.OpenInNewTab`: Shift, Ctrl or Cmd).
+ */
+export function DashboardsAppOpenOptions(appManager, openInEditMode = false, openInNewTab = false) {
+    const app = FindDashboardsApp(appManager);
+    return {
+        ...(app ? { applicationId: app.ID } : {}),
+        ...(openInEditMode ? { openInEditMode: true } : {}),
+        ...(openInNewTab ? { forceNewTab: true } : {}),
+    };
+}
+/** The entity of dashboard records. */
+const DASHBOARDS_ENTITY = 'MJ: Dashboards';
+/** The longest name MJ: Dashboards stores: the MaxLength of its Name field, or DASHBOARD_NAME_MAX_LENGTH when the metadata gives none. */
+export function DashboardNameMaxLength(md) {
+    const maxLength = md.EntityByName(DASHBOARDS_ENTITY)?.FieldByName('Name')?.MaxLength ?? 0;
+    return maxLength > 0 ? maxLength : DASHBOARD_NAME_MAX_LENGTH;
+}
+/**
+ * Creates and saves an empty Config dashboard with the trimmed `name`, owned by the current user, in
+ * `categoryId` when one is given. Returns null for a blank name or a failed save.
+ */
+export async function CreateBlankDashboard(md, name, categoryId) {
+    const trimmed = name.trim();
+    if (!trimmed) {
+        LogError('CreateBlankDashboard: the dashboard needs a name');
+        return null;
+    }
+    try {
+        const dashboard = await md.GetEntityObject(DASHBOARDS_ENTITY, md.CurrentUser);
+        dashboard.Name = trimmed;
+        dashboard.Description = '';
+        dashboard.UserID = md.CurrentUser.ID;
+        dashboard.UIConfigDetails = JSON.stringify(CreateDefaultDashboardConfig());
+        if (categoryId) {
+            dashboard.CategoryID = categoryId;
+        }
+        if (await dashboard.Save()) {
+            return dashboard;
+        }
+        LogError(`CreateBlankDashboard: ${dashboard.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        return null;
+    }
+    catch (error) {
+        LogError(`CreateBlankDashboard: ${errorMessage(error)}`);
+        return null;
+    }
+}
+/**
+ * Automatic install path, for Home load. Installs the Dashboards app for a user who has no
+ * UserApplication row for it, at most once per user (tracked by a UserInfoEngine setting), so a
+ * user who removes the app keeps it removed. Never rejects.
+ * @returns true when this call installed the app.
+ */
+export async function AutoInstallDashboardsApp(appManager) {
+    try {
+        await appManager.WhenReady();
+        return await RunDashboardsAppAutoInstall(buildInstallOperations(appManager));
+    }
+    catch (error) {
+        LogError(`AutoInstallDashboardsApp: ${errorMessage(error)}`);
+        return false;
+    }
+}
+/**
+ * Explicit install path, for a user click that goes to the Dashboards app (for example Open
+ * Dashboards on the Data Explorer banner). Installs the app when it is missing or removed. Never rejects.
+ * @returns the app to pass to `NavigationService.SwitchToApp`, or undefined when no Active
+ * Dashboards app exists, the user is not authorized for it, or the install failed or did not
+ * finish within DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS.
+ */
+export async function EnsureDashboardsApp(appManager) {
+    try {
+        await appManager.WhenReady();
+        if (!(await RunDashboardsAppExplicitInstall(buildInstallOperations(appManager)))) {
+            return undefined;
+        }
+        const app = FindDashboardsApp(appManager);
+        if (app) {
+            return app;
+        }
+        await appManager.ReloadUserApplications();
+        return FindDashboardsApp(appManager);
+    }
+    catch (error) {
+        LogError(`EnsureDashboardsApp: ${errorMessage(error)}`);
+        return undefined;
+    }
+}
+/** Install operations over ApplicationManager and UserInfoEngine.Instance, the engine ApplicationManager reads and installs through. */
+function buildInstallOperations(appManager) {
+    const engine = UserInfoEngine.Instance;
+    return {
+        ReadState: () => readInstallState(appManager, engine),
+        Install: () => installForUser(appManager),
+        RecordAutoInstall: () => engine.SetSetting(DASHBOARDS_APP_AUTO_INSTALL_SETTING_KEY, 'true'),
+    };
+}
+function readInstallState(appManager, engine) {
+    if (engine.IsPermissionConstrained) {
+        return null;
+    }
+    const app = findSystemDashboardsApp(appManager);
+    return {
+        AppExists: app != null,
+        Access: app ? engine.CheckUserApplicationAccess(app.ID) : 'not_installed',
+        AutoInstallRecorded: engine.GetSetting(DASHBOARDS_APP_AUTO_INSTALL_SETTING_KEY) === 'true',
+    };
+}
+/** Installs or re-enables the app, then rebuilds the user's app list so navigation can find it. */
+async function installForUser(appManager) {
+    const app = findSystemDashboardsApp(appManager);
+    if (!app || !(await appManager.InstallAppForUser(app.ID))) {
+        return false;
+    }
+    await appManager.ReloadUserApplications();
+    return true;
+}
+/** The Dashboards app among all Active applications, whether or not the user has it. */
+function findSystemDashboardsApp(appManager) {
+    return appManager.GetAllSystemApps().find((a) => a.Name === DASHBOARDS_APP_NAME);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=dashboards-app.helpers.js.map

package/dist/shared/dashboards-app.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboards-app.helpers.js","sourceRoot":"","sources":["../../src/shared/dashboards-app.helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import { LogError } from '@memberjunction/core';\nimport type { IMetadataProvider } from '@memberjunction/core';\nimport { UserInfoEngine } from '@memberjunction/core-entities';\nimport type { MJDashboardEntity } from '@memberjunction/core-entities';\nimport type { ApplicationManager, BaseApplication } from '@memberjunction/ng-base-application';\nimport type { DashboardNavigationOptions } from '@memberjunction/ng-shared';\nimport { CreateDefaultDashboardConfig, DASHBOARD_NAME_MAX_LENGTH } from '@memberjunction/ng-dashboard-viewer';\nimport {\n  DASHBOARDS_APP_AUTO_INSTALL_SETTING_KEY,\n  DashboardsAppInstallOperations,\n  DashboardsAppInstallState,\n  RunDashboardsAppAutoInstall,\n  RunDashboardsAppExplicitInstall,\n} from './dashboards-app-install';\n\nexport const DASHBOARDS_APP_NAME = 'Dashboards';\n\n/** Label of the Dashboards app's Library nav item. */\nexport const DASHBOARDS_LIBRARY_NAV_ITEM = 'Library';\n\n/** The Dashboards application, if the user has it enabled. */\nexport function FindDashboardsApp(appManager: ApplicationManager): BaseApplication | undefined {\n  return appManager.GetAllApps().find((a) => a.Name === DASHBOARDS_APP_NAME);\n}\n\n/**\n * The NavigationService.OpenDashboard options for a dashboard opened from a page of the Dashboards\n * app: a tab of the Dashboards app. Like any open, the dashboard replaces the current preview tab,\n * so Back returns to the page, and a Shift-click opens a separate tab. When the user does not have\n * the app, no application is named and the tab opens in NavigationService's default application.\n * `openInEditMode` asks the tab to enter edit mode (a new dashboard, or a card's Edit action).\n * `openInNewTab` forces a separate tab, for a click the dashboard browser reports as one\n * (`DashboardOpenEvent.OpenInNewTab`: Shift, Ctrl or Cmd).\n */\nexport function DashboardsAppOpenOptions(appManager: ApplicationManager, openInEditMode = false, openInNewTab = false): DashboardNavigationOptions {\n  const app = FindDashboardsApp(appManager);\n  return {\n    ...(app ? { applicationId: app.ID } : {}),\n    ...(openInEditMode ? { openInEditMode: true } : {}),\n    ...(openInNewTab ? { forceNewTab: true } : {}),\n  };\n}\n\n/** The entity of dashboard records. */\nconst DASHBOARDS_ENTITY = 'MJ: Dashboards';\n\n/** The longest name MJ: Dashboards stores: the MaxLength of its Name field, or DASHBOARD_NAME_MAX_LENGTH when the metadata gives none. */\nexport function DashboardNameMaxLength(md: IMetadataProvider): number {\n  const maxLength = md.EntityByName(DASHBOARDS_ENTITY)?.FieldByName('Name')?.MaxLength ?? 0;\n  return maxLength > 0 ? maxLength : DASHBOARD_NAME_MAX_LENGTH;\n}\n\n/**\n * Creates and saves an empty Config dashboard with the trimmed `name`, owned by the current user, in\n * `categoryId` when one is given. Returns null for a blank name or a failed save.\n */\nexport async function CreateBlankDashboard(md: IMetadataProvider, name: string, categoryId?: string | null): Promise<MJDashboardEntity | null> {\n  const trimmed = name.trim();\n  if (!trimmed) {\n    LogError('CreateBlankDashboard: the dashboard needs a name');\n    return null;\n  }\n  try {\n    const dashboard = await md.GetEntityObject<MJDashboardEntity>(DASHBOARDS_ENTITY, md.CurrentUser);\n    dashboard.Name = trimmed;\n    dashboard.Description = '';\n    dashboard.UserID = md.CurrentUser.ID;\n    dashboard.UIConfigDetails = JSON.stringify(CreateDefaultDashboardConfig());\n    if (categoryId) {\n      dashboard.CategoryID = categoryId;\n    }\n    if (await dashboard.Save()) {\n      return dashboard;\n    }\n    LogError(`CreateBlankDashboard: ${dashboard.LatestResult?.CompleteMessage ?? 'unknown error'}`);\n    return null;\n  } catch (error) {\n    LogError(`CreateBlankDashboard: ${errorMessage(error)}`);\n    return null;\n  }\n}\n\n/**\n * Automatic install path, for Home load. Installs the Dashboards app for a user who has no\n * UserApplication row for it, at most once per user (tracked by a UserInfoEngine setting), so a\n * user who removes the app keeps it removed. Never rejects.\n * @returns true when this call installed the app.\n */\nexport async function AutoInstallDashboardsApp(appManager: ApplicationManager): Promise<boolean> {\n  try {\n    await appManager.WhenReady();\n    return await RunDashboardsAppAutoInstall(buildInstallOperations(appManager));\n  } catch (error) {\n    LogError(`AutoInstallDashboardsApp: ${errorMessage(error)}`);\n    return false;\n  }\n}\n\n/**\n * Explicit install path, for a user click that goes to the Dashboards app (for example Open\n * Dashboards on the Data Explorer banner). Installs the app when it is missing or removed. Never rejects.\n * @returns the app to pass to `NavigationService.SwitchToApp`, or undefined when no Active\n * Dashboards app exists, the user is not authorized for it, or the install failed or did not\n * finish within DASHBOARDS_APP_INSTALL_STEP_TIMEOUT_MS.\n */\nexport async function EnsureDashboardsApp(appManager: ApplicationManager): Promise<BaseApplication | undefined> {\n  try {\n    await appManager.WhenReady();\n    if (!(await RunDashboardsAppExplicitInstall(buildInstallOperations(appManager)))) {\n      return undefined;\n    }\n    const app = FindDashboardsApp(appManager);\n    if (app) {\n      return app;\n    }\n    await appManager.ReloadUserApplications();\n    return FindDashboardsApp(appManager);\n  } catch (error) {\n    LogError(`EnsureDashboardsApp: ${errorMessage(error)}`);\n    return undefined;\n  }\n}\n\n/** Install operations over ApplicationManager and UserInfoEngine.Instance, the engine ApplicationManager reads and installs through. */\nfunction buildInstallOperations(appManager: ApplicationManager): DashboardsAppInstallOperations {\n  const engine = UserInfoEngine.Instance;\n  return {\n    ReadState: () => readInstallState(appManager, engine),\n    Install: () => installForUser(appManager),\n    RecordAutoInstall: () => engine.SetSetting(DASHBOARDS_APP_AUTO_INSTALL_SETTING_KEY, 'true'),\n  };\n}\n\nfunction readInstallState(appManager: ApplicationManager, engine: UserInfoEngine): DashboardsAppInstallState | null {\n  if (engine.IsPermissionConstrained) {\n    return null;\n  }\n  const app = findSystemDashboardsApp(appManager);\n  return {\n    AppExists: app != null,\n    Access: app ? engine.CheckUserApplicationAccess(app.ID) : 'not_installed',\n    AutoInstallRecorded: engine.GetSetting(DASHBOARDS_APP_AUTO_INSTALL_SETTING_KEY) === 'true',\n  };\n}\n\n/** Installs or re-enables the app, then rebuilds the user's app list so navigation can find it. */\nasync function installForUser(appManager: ApplicationManager): Promise<boolean> {\n  const app = findSystemDashboardsApp(appManager);\n  if (!app || !(await appManager.InstallAppForUser(app.ID))) {\n    return false;\n  }\n  await appManager.ReloadUserApplications();\n  return true;\n}\n\n/** The Dashboards app among all Active applications, whether or not the user has it. */\nfunction findSystemDashboardsApp(appManager: ApplicationManager): BaseApplication | undefined {\n  return appManager.GetAllSystemApps().find((a) => a.Name === DASHBOARDS_APP_NAME);\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/ng-dashboards",
-  "version": "6.2.0-edge.3",
+  "version": "6.2.0-edge.4",
   "description": "MemberJunction Dashboards",
   "main": "./dist/public-api.js",
   "typings": "./dist/public-api.d.ts",
@@ -95,9 +95,10 @@
   "devDependencies": {
     "@angular/compiler": "21.2.22",
     "@angular/compiler-cli": "21.2.22",
+    "@fortawesome/fontawesome-free": "6.7.2",
     "@types/d3": "^7.4.0",
     "sass": "^1.97.3",
-    "@memberjunction/ng-test-utils": "6.2.0-edge.3"
+    "@memberjunction/ng-test-utils": "6.2.0-edge.4"
   },
   "peerDependencies": {
     "@angular/animations": "^21.2.22",
@@ -114,72 +115,72 @@
     "@codemirror/merge": "^6.11.2",
     "@codemirror/state": "^6.5.4",
     "@codemirror/view": "^6.39.12",
-    "@memberjunction/actions-base": "6.2.0-edge.3",
-    "@memberjunction/ai-core-plus": "6.2.0-edge.3",
-    "@memberjunction/ai-engine-base": "6.2.0-edge.3",
-    "@memberjunction/api-keys-base": "6.2.0-edge.3",
-    "@memberjunction/core": "6.2.0-edge.3",
-    "@memberjunction/core-entities": "6.2.0-edge.3",
-    "@memberjunction/credentials": "6.2.0-edge.3",
-    "@memberjunction/export-engine": "6.2.0-edge.3",
-    "@memberjunction/global": "6.2.0-edge.3",
-    "@memberjunction/graphql-dataprovider": "6.2.0-edge.3",
-    "@memberjunction/integration-engine-base": "6.2.0-edge.3",
-    "@memberjunction/interactive-component-types": "6.2.0-edge.3",
-    "@memberjunction/lists-base": "6.2.0-edge.3",
-    "@memberjunction/ng-action-gallery": "6.2.0-edge.3",
-    "@memberjunction/ng-actions": "6.2.0-edge.3",
-    "@memberjunction/ng-agent-requests": "6.2.0-edge.3",
-    "@memberjunction/ng-agents": "6.2.0-edge.3",
-    "@memberjunction/ng-rubrics": "6.2.0-edge.3",
-    "@memberjunction/rubrics-base": "6.2.0-edge.3",
-    "@memberjunction/ng-ai-test-harness": "6.2.0-edge.3",
-    "@memberjunction/ng-archive-manager": "6.2.0-edge.3",
-    "@memberjunction/ng-artifacts": "6.2.0-edge.3",
-    "@memberjunction/ng-base-application": "6.2.0-edge.3",
-    "@memberjunction/ng-base-forms": "6.2.0-edge.3",
-    "@memberjunction/ng-base-types": "6.2.0-edge.3",
-    "@memberjunction/ng-clustering": "6.2.0-edge.3",
-    "@memberjunction/ng-code-editor": "6.2.0-edge.3",
-    "@memberjunction/ng-composer": "6.2.0-edge.3",
-    "@memberjunction/ng-container-directives": "6.2.0-edge.3",
-    "@memberjunction/ng-conversations": "6.2.0-edge.3",
-    "@memberjunction/ng-core-entity-forms": "6.2.0-edge.3",
-    "@memberjunction/ng-credentials": "6.2.0-edge.3",
-    "@memberjunction/ng-dashboard-viewer": "6.2.0-edge.3",
-    "@memberjunction/ng-entity-relationship-diagram": "6.2.0-edge.3",
-    "@memberjunction/ng-entity-viewer": "6.2.0-edge.3",
-    "@memberjunction/ng-explorer-settings": "6.2.0-edge.3",
-    "@memberjunction/ng-export-service": "6.2.0-edge.3",
-    "@memberjunction/ng-filter-builder": "6.2.0-edge.3",
-    "@memberjunction/ng-list-management": "6.2.0-edge.3",
-    "@memberjunction/ng-map-view": "6.2.0-edge.3",
-    "@memberjunction/ng-markdown": "6.2.0-edge.3",
-    "@memberjunction/ng-media-player": "6.2.0-edge.3",
-    "@memberjunction/ng-notifications": "6.2.0-edge.3",
-    "@memberjunction/ng-query-viewer": "6.2.0-edge.3",
-    "@memberjunction/ng-react": "6.2.0-edge.3",
-    "@memberjunction/ng-record-process-studio": "6.2.0-edge.3",
-    "@memberjunction/ng-resource-permissions": "6.2.0-edge.3",
-    "@memberjunction/ng-scheduling": "6.2.0-edge.3",
-    "@memberjunction/ng-search": "6.2.0-edge.3",
-    "@memberjunction/ng-shared": "6.2.0-edge.3",
-    "@memberjunction/ng-shared-generic": "6.2.0-edge.3",
-    "@memberjunction/ng-task-graph-editor": "6.2.0-edge.3",
-    "@memberjunction/ng-tabstrip": "6.2.0-edge.3",
-    "@memberjunction/ng-testing": "6.2.0-edge.3",
-    "@memberjunction/ng-trees": "6.2.0-edge.3",
-    "@memberjunction/ng-ui-components": "6.2.0-edge.3",
-    "@memberjunction/ng-user-routines": "6.2.0-edge.3",
-    "@memberjunction/ng-versions": "6.2.0-edge.3",
-    "@memberjunction/ng-word-cloud": "6.2.0-edge.3",
-    "@memberjunction/predictive-studio-core": "6.2.0-edge.3",
-    "@memberjunction/tag-engine-base": "6.2.0-edge.3",
-    "@memberjunction/templates-base-types": "6.2.0-edge.3",
-    "@memberjunction/testing-engine-base": "6.2.0-edge.3",
-    "@memberjunction/theme-engine": "6.2.0-edge.3",
-    "@memberjunction/work-queue-base": "6.2.0-edge.3",
-    "@memberjunction/work-queue-core": "6.2.0-edge.3",
+    "@memberjunction/actions-base": "6.2.0-edge.4",
+    "@memberjunction/ai-core-plus": "6.2.0-edge.4",
+    "@memberjunction/ai-engine-base": "6.2.0-edge.4",
+    "@memberjunction/api-keys-base": "6.2.0-edge.4",
+    "@memberjunction/core": "6.2.0-edge.4",
+    "@memberjunction/core-entities": "6.2.0-edge.4",
+    "@memberjunction/credentials": "6.2.0-edge.4",
+    "@memberjunction/export-engine": "6.2.0-edge.4",
+    "@memberjunction/global": "6.2.0-edge.4",
+    "@memberjunction/graphql-dataprovider": "6.2.0-edge.4",
+    "@memberjunction/integration-engine-base": "6.2.0-edge.4",
+    "@memberjunction/interactive-component-types": "6.2.0-edge.4",
+    "@memberjunction/lists-base": "6.2.0-edge.4",
+    "@memberjunction/ng-action-gallery": "6.2.0-edge.4",
+    "@memberjunction/ng-actions": "6.2.0-edge.4",
+    "@memberjunction/ng-agent-requests": "6.2.0-edge.4",
+    "@memberjunction/ng-agents": "6.2.0-edge.4",
+    "@memberjunction/ng-rubrics": "6.2.0-edge.4",
+    "@memberjunction/rubrics-base": "6.2.0-edge.4",
+    "@memberjunction/ng-ai-test-harness": "6.2.0-edge.4",
+    "@memberjunction/ng-archive-manager": "6.2.0-edge.4",
+    "@memberjunction/ng-artifacts": "6.2.0-edge.4",
+    "@memberjunction/ng-base-application": "6.2.0-edge.4",
+    "@memberjunction/ng-base-forms": "6.2.0-edge.4",
+    "@memberjunction/ng-base-types": "6.2.0-edge.4",
+    "@memberjunction/ng-clustering": "6.2.0-edge.4",
+    "@memberjunction/ng-code-editor": "6.2.0-edge.4",
+    "@memberjunction/ng-composer": "6.2.0-edge.4",
+    "@memberjunction/ng-container-directives": "6.2.0-edge.4",
+    "@memberjunction/ng-conversations": "6.2.0-edge.4",
+    "@memberjunction/ng-core-entity-forms": "6.2.0-edge.4",
+    "@memberjunction/ng-credentials": "6.2.0-edge.4",
+    "@memberjunction/ng-dashboard-viewer": "6.2.0-edge.4",
+    "@memberjunction/ng-entity-relationship-diagram": "6.2.0-edge.4",
+    "@memberjunction/ng-entity-viewer": "6.2.0-edge.4",
+    "@memberjunction/ng-explorer-settings": "6.2.0-edge.4",
+    "@memberjunction/ng-export-service": "6.2.0-edge.4",
+    "@memberjunction/ng-filter-builder": "6.2.0-edge.4",
+    "@memberjunction/ng-list-management": "6.2.0-edge.4",
+    "@memberjunction/ng-map-view": "6.2.0-edge.4",
+    "@memberjunction/ng-markdown": "6.2.0-edge.4",
+    "@memberjunction/ng-media-player": "6.2.0-edge.4",
+    "@memberjunction/ng-notifications": "6.2.0-edge.4",
+    "@memberjunction/ng-query-viewer": "6.2.0-edge.4",
+    "@memberjunction/ng-react": "6.2.0-edge.4",
+    "@memberjunction/ng-record-process-studio": "6.2.0-edge.4",
+    "@memberjunction/ng-resource-permissions": "6.2.0-edge.4",
+    "@memberjunction/ng-scheduling": "6.2.0-edge.4",
+    "@memberjunction/ng-search": "6.2.0-edge.4",
+    "@memberjunction/ng-shared": "6.2.0-edge.4",
+    "@memberjunction/ng-shared-generic": "6.2.0-edge.4",
+    "@memberjunction/ng-task-graph-editor": "6.2.0-edge.4",
+    "@memberjunction/ng-tabstrip": "6.2.0-edge.4",
+    "@memberjunction/ng-testing": "6.2.0-edge.4",
+    "@memberjunction/ng-trees": "6.2.0-edge.4",
+    "@memberjunction/ng-ui-components": "6.2.0-edge.4",
+    "@memberjunction/ng-user-routines": "6.2.0-edge.4",
+    "@memberjunction/ng-versions": "6.2.0-edge.4",
+    "@memberjunction/ng-word-cloud": "6.2.0-edge.4",
+    "@memberjunction/predictive-studio-core": "6.2.0-edge.4",
+    "@memberjunction/tag-engine-base": "6.2.0-edge.4",
+    "@memberjunction/templates-base-types": "6.2.0-edge.4",
+    "@memberjunction/testing-engine-base": "6.2.0-edge.4",
+    "@memberjunction/theme-engine": "6.2.0-edge.4",
+    "@memberjunction/work-queue-base": "6.2.0-edge.4",
+    "@memberjunction/work-queue-core": "6.2.0-edge.4",
     "ag-grid-angular": "^35.0.1",
     "ag-grid-community": "^35.0.1",
     "angular-split": "^20.0.0",