WIP feature analysis tools

apps/api/src/app/services/stripe.service.ts

@@ -295,6 +295,7 @@ export async function updateEntitlements(customerId: string, entitlements: Strip
       chromeExtension: false,
       recordSync: false,
       desktop: false,
+      analysisTools: false,
     },
   );
 

apps/jetstream-canvas/src/app/AppRoutes.tsx

@@ -36,6 +36,23 @@ const ManagePermissionsSelection = lazy(() =>
 const ManagePermissionsEditor = lazy(() =>
   import('@jetstream/feature/manage-permissions').then((module) => ({ default: module.ManagePermissionsEditor })),
 );
+const PermissionAnalysis = lazy(() =>
+  import('@jetstream/feature/manage-permissions').then((module) => ({ default: module.PermissionAnalysis })),
+);
+const PermissionAnalysisSelection = lazy(() =>
+  import('@jetstream/feature/manage-permissions').then((module) => ({ default: module.PermissionAnalysisSelection })),
+);
+const PermissionAnalysisView = lazy(() =>
+  import('@jetstream/feature/manage-permissions').then((module) => ({ default: module.PermissionAnalysisView })),
+);
+
+const DataAnalysis = lazy(() => import('@jetstream/feature/data-analysis').then((module) => ({ default: module.DataAnalysis })));
+const DataAnalysisSelection = lazy(() =>
+  import('@jetstream/feature/data-analysis').then((module) => ({ default: module.DataAnalysisSelection })),
+);
+const FieldUsageAnalysisView = lazy(() =>
+  import('@jetstream/feature/data-analysis').then((module) => ({ default: module.FieldUsageAnalysisView })),
+);
 
 const DeployMetadata = lazy(() => import('@jetstream/feature/deploy').then((module) => ({ default: module.DeployMetadata })));
 const DeployMetadataSelection = lazy(() =>
@@ -141,6 +158,8 @@ export const AppRoutes = () => {
       AutomationControlEditor.preload();
     } else if (location.pathname.includes('/permissions-manager')) {
       ManagePermissionsEditor.preload();
+    } else if (location.pathname.includes('/data-analysis')) {
+      FieldUsageAnalysisView.preload();
     } else if (location.pathname.includes('/deploy-metadata')) {
       DeployMetadataDeployment.preload();
     } else if (location.pathname.includes('/create-fields')) {
@@ -214,6 +233,30 @@ export const AppRoutes = () => {
         <Route path="editor" element={<ManagePermissionsEditor />} />
         <Route path="*" element={<Navigate to=".." />} />
       </Route>
+      <Route
+        path={APP_ROUTES.PERMISSION_ANALYSIS.ROUTE}
+        element={
+          <OrgSelectionRequired>
+            <PermissionAnalysis />
+          </OrgSelectionRequired>
+        }
+      >
+        <Route index element={<PermissionAnalysisSelection />} />
+        <Route path="analysis" element={<PermissionAnalysisView />} />
+        <Route path="*" element={<Navigate to=".." />} />
+      </Route>
+      <Route
+        path={APP_ROUTES.DATA_ANALYSIS.ROUTE}
+        element={
+          <OrgSelectionRequired>
+            <DataAnalysis />
+          </OrgSelectionRequired>
+        }
+      >
+        <Route index element={<DataAnalysisSelection />} />
+        <Route path="analysis" element={<FieldUsageAnalysisView />} />
+        <Route path="*" element={<Navigate to=".." />} />
+      </Route>
       <Route
         path={APP_ROUTES.DEPLOY_METADATA.ROUTE}
         element={

apps/jetstream-desktop-client/src/app/AppRoutes.tsx

@@ -37,6 +37,23 @@ const ManagePermissionsSelection = lazy(() =>
 const ManagePermissionsEditor = lazy(() =>
   import('@jetstream/feature/manage-permissions').then((module) => ({ default: module.ManagePermissionsEditor })),
 );
+const PermissionAnalysis = lazy(() =>
+  import('@jetstream/feature/manage-permissions').then((module) => ({ default: module.PermissionAnalysis })),
+);
+const PermissionAnalysisSelection = lazy(() =>
+  import('@jetstream/feature/manage-permissions').then((module) => ({ default: module.PermissionAnalysisSelection })),
+);
+const PermissionAnalysisView = lazy(() =>
+  import('@jetstream/feature/manage-permissions').then((module) => ({ default: module.PermissionAnalysisView })),
+);
+
+const DataAnalysis = lazy(() => import('@jetstream/feature/data-analysis').then((module) => ({ default: module.DataAnalysis })));
+const DataAnalysisSelection = lazy(() =>
+  import('@jetstream/feature/data-analysis').then((module) => ({ default: module.DataAnalysisSelection })),
+);
+const FieldUsageAnalysisView = lazy(() =>
+  import('@jetstream/feature/data-analysis').then((module) => ({ default: module.FieldUsageAnalysisView })),
+);
 
 const DeployMetadata = lazy(() => import('@jetstream/feature/deploy').then((module) => ({ default: module.DeployMetadata })));
 const DeployMetadataSelection = lazy(() =>
@@ -121,6 +138,8 @@ export const AppRoutes = () => {
       AutomationControlEditor.preload();
     } else if (location.pathname.includes('/permissions-manager')) {
       ManagePermissionsEditor.preload();
+    } else if (location.pathname.includes('/data-analysis')) {
+      FieldUsageAnalysisView.preload();
     } else if (location.pathname.includes('/deploy-metadata')) {
       DeployMetadataDeployment.preload();
     } else if (location.pathname.includes('/create-fields')) {
@@ -197,6 +216,30 @@ export const AppRoutes = () => {
         <Route path="editor" element={<ManagePermissionsEditor />} />
         <Route path="*" element={<Navigate to=".." />} />
       </Route>
+      <Route
+        path={APP_ROUTES.PERMISSION_ANALYSIS.ROUTE}
+        element={
+          <OrgSelectionRequired>
+            <PermissionAnalysis />
+          </OrgSelectionRequired>
+        }
+      >
+        <Route index element={<PermissionAnalysisSelection />} />
+        <Route path="analysis" element={<PermissionAnalysisView />} />
+        <Route path="*" element={<Navigate to=".." />} />
+      </Route>
+      <Route
+        path={APP_ROUTES.DATA_ANALYSIS.ROUTE}
+        element={
+          <OrgSelectionRequired>
+            <DataAnalysis />
+          </OrgSelectionRequired>
+        }
+      >
+        <Route index element={<DataAnalysisSelection />} />
+        <Route path="analysis" element={<FieldUsageAnalysisView />} />
+        <Route path="*" element={<Navigate to=".." />} />
+      </Route>
       <Route
         path={APP_ROUTES.DEPLOY_METADATA.ROUTE}
         element={

apps/jetstream-desktop-client/src/app/components/core/AppInitializer.tsx

@@ -7,7 +7,7 @@ import { Announcement, JetstreamEventSaveSoqlQueryFormatOptionsPayload, Salesfor
 import { fireToast } from '@jetstream/ui';
 import { fromJetstreamEvents, useAmplitude } from '@jetstream/ui-core';
 import { fromAppState } from '@jetstream/ui/app-state';
-import { initDexieDb } from '@jetstream/ui/db';
+import { initDexieDb, pruneAnalysisJobHistory } from '@jetstream/ui/db';
 import { AxiosResponse } from 'axios';
 import { useAtom, useAtomValue } from 'jotai';
 import localforage from 'localforage';
@@ -85,9 +85,11 @@ APP VERSION ${version}
     } else {
       disconnectSocket();
     }
-    initDexieDb({ recordSyncEnabled }).catch((ex) => {
-      logger.error('[DB] Error initializing db', ex);
-    });
+    initDexieDb({ recordSyncEnabled })
+      .then(() => pruneAnalysisJobHistory())
+      .catch((ex) => {
+        logger.error('[DB] Error initializing db', ex);
+      });
   }, [appInfo.serverUrl, authInfo.accessToken, authInfo.deviceId, recordSyncEnabled]);
 
   useEffect(() => {

apps/jetstream-e2e/src/tests/app/routing.spec.ts

@@ -19,6 +19,14 @@ const testCases = [
   },
   { cardTitle: 'AUTOMATION', menu: 'Automation Control', items: [{ link: 'Automation Control', path: '/automation-control' }] },
   { cardTitle: 'PERMISSIONS', menu: 'Manage Permissions', items: [{ link: 'Manage Permissions', path: '/permissions-manager' }] },
+  {
+    cardTitle: 'Analysis',
+    menu: 'Analysis Tools',
+    items: [
+      { link: 'Permission Analysis', path: '/permission-analysis' },
+      { link: 'Data Analysis', path: '/data-analysis' },
+    ],
+  },
   {
     cardTitle: 'DEPLOY',
     menu: 'Deploy Metadata',

apps/jetstream/src/app/AppRoutes.tsx

@@ -39,6 +39,23 @@ const ManagePermissionsSelection = lazy(() =>
 const ManagePermissionsEditor = lazy(() =>
   import('@jetstream/feature/manage-permissions').then((module) => ({ default: module.ManagePermissionsEditor })),
 );
+const PermissionAnalysis = lazy(() =>
+  import('@jetstream/feature/manage-permissions').then((module) => ({ default: module.PermissionAnalysis })),
+);
+const PermissionAnalysisSelection = lazy(() =>
+  import('@jetstream/feature/manage-permissions').then((module) => ({ default: module.PermissionAnalysisSelection })),
+);
+const PermissionAnalysisView = lazy(() =>
+  import('@jetstream/feature/manage-permissions').then((module) => ({ default: module.PermissionAnalysisView })),
+);
+
+const DataAnalysis = lazy(() => import('@jetstream/feature/data-analysis').then((module) => ({ default: module.DataAnalysis })));
+const DataAnalysisSelection = lazy(() =>
+  import('@jetstream/feature/data-analysis').then((module) => ({ default: module.DataAnalysisSelection })),
+);
+const FieldUsageAnalysisView = lazy(() =>
+  import('@jetstream/feature/data-analysis').then((module) => ({ default: module.FieldUsageAnalysisView })),
+);
 
 const DeployMetadata = lazy(() => import('@jetstream/feature/deploy').then((module) => ({ default: module.DeployMetadata })));
 const DeployMetadataSelection = lazy(() =>
@@ -109,6 +126,8 @@ export const AppRoutes = () => {
       AutomationControlEditor.preload();
     } else if (location.pathname.includes('/permissions-manager')) {
       ManagePermissionsEditor.preload();
+    } else if (location.pathname.includes('/permission-analysis')) {
+      PermissionAnalysisView.preload();
     } else if (location.pathname.includes('/deploy-metadata')) {
       DeployMetadataDeployment.preload();
     } else if (location.pathname.includes('/create-fields')) {
@@ -189,6 +208,30 @@ export const AppRoutes = () => {
             <Route path="editor" element={<ManagePermissionsEditor />} />
             <Route path="*" element={<Navigate to=".." />} />
           </Route>
+          <Route
+            path={APP_ROUTES.PERMISSION_ANALYSIS.ROUTE}
+            element={
+              <OrgSelectionRequired>
+                <PermissionAnalysis />
+              </OrgSelectionRequired>
+            }
+          >
+            <Route index element={<PermissionAnalysisSelection />} />
+            <Route path="analysis" element={<PermissionAnalysisView />} />
+            <Route path="*" element={<Navigate to=".." />} />
+          </Route>
+          <Route
+            path={APP_ROUTES.DATA_ANALYSIS.ROUTE}
+            element={
+              <OrgSelectionRequired>
+                <DataAnalysis />
+              </OrgSelectionRequired>
+            }
+          >
+            <Route index element={<DataAnalysisSelection />} />
+            <Route path="analysis" element={<FieldUsageAnalysisView />} />
+            <Route path="*" element={<Navigate to=".." />} />
+          </Route>
           <Route
             path={APP_ROUTES.DEPLOY_METADATA.ROUTE}
             element={

apps/jetstream/src/app/components/core/AppInitializer.tsx

@@ -7,7 +7,7 @@ import { fireToast } from '@jetstream/ui';
 import { fromJetstreamEvents, useAmplitude } from '@jetstream/ui-core';
 import { fromAppState } from '@jetstream/ui/app-state';
 import { CookieConsentBanner, useConditionalGoogleAnalytics } from '@jetstream/ui/cookie-consent-banner';
-import { initDexieDb } from '@jetstream/ui/db';
+import { initDexieDb, pruneAnalysisJobHistory } from '@jetstream/ui/db';
 import { AxiosResponse } from 'axios';
 import { useAtom, useAtomValue } from 'jotai';
 import localforage from 'localforage';
@@ -90,9 +90,11 @@ APP VERSION ${version}
     } else {
       disconnectSocket();
     }
-    initDexieDb({ recordSyncEnabled }).catch((ex) => {
-      logger.error('[DB] Error initializing db', ex);
-    });
+    initDexieDb({ recordSyncEnabled })
+      .then(() => pruneAnalysisJobHistory())
+      .catch((ex) => {
+        logger.error('[DB] Error initializing db', ex);
+      });
   }, [appInfo.serverUrl, recordSyncEnabled]);
 
   useEffect(() => {

libs/auth/acl/src/lib/acl.ts

@@ -13,7 +13,7 @@ type Actions = 'read' | 'update';
 type Subjects = 'Billing' | 'CoreFunctionality' | 'Profile' | 'Settings';
 
 type EntitlementActions = 'access';
-type EntitlementSubjects = 'GoogleDrive' | 'ChromeExtension' | 'Desktop' | 'RecordSync';
+type EntitlementSubjects = 'GoogleDrive' | 'ChromeExtension' | 'Desktop' | 'RecordSync' | 'AnalysisTools';
 
 type TeamActions = 'read' | 'update';
 type TeamSubjects = 'Team' | 'TeamMember' | { type: 'TeamMember'; role: TeamMemberRole };
@@ -132,6 +132,10 @@ function getAbilityRules({ isBrowserExtension, isDesktop, isCanvasApp, user }: G
   if (user.entitlements.recordSync || isBrowserExtension || isDesktop) {
     can('access', 'RecordSync');
   }
+  // Analysis Tools (Field Usage + Permission Analysis) are paid-only; desktop/extension/canvas are paid tiers.
+  if (user.entitlements.analysisTools || isBrowserExtension || isDesktop || isCanvasApp) {
+    can('access', 'AnalysisTools');
+  }
 
   return rules;
 }

libs/features/data-analysis/eslint.config.js

@@ -0,0 +1,17 @@
+const baseConfig = require('../../../eslint.config.js');
+
+module.exports = [
+  ...baseConfig,
+  {
+    files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
+    rules: {},
+  },
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    rules: {},
+  },
+  {
+    files: ['**/*.js', '**/*.jsx'],
+    rules: {},
+  },
+];

libs/features/data-analysis/project.json

@@ -0,0 +1,16 @@
+{
+  "name": "features-data-analysis",
+  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/features/data-analysis/src",
+  "projectType": "library",
+  "tags": ["scope:browser"],
+  "targets": {
+    "test": {
+      "executor": "@nx/vitest:test",
+      "outputs": ["{options.reportsDirectory}"],
+      "options": {
+        "reportsDirectory": "{projectRoot}/../../../coverage/libs/features/data-analysis"
+      }
+    }
+  }
+}

libs/features/data-analysis/src/DataAnalysis.tsx

@@ -0,0 +1,19 @@
+import { TITLES } from '@jetstream/shared/constants';
+import { useTitle } from '@jetstream/shared/ui-utils';
+import { AnalysisToolsPaywall } from '@jetstream/ui-core';
+import { analysisToolsAccessState } from '@jetstream/ui/app-state';
+import { useAtomValue } from 'jotai';
+import { FunctionComponent } from 'react';
+import { Outlet } from 'react-router-dom';
+
+/** Route shell for **Data analysis** (field usage). Paid-only — see {@link analysisToolsAccessState}. */
+export const DataAnalysis: FunctionComponent = () => {
+  useTitle(TITLES.DATA_ANALYSIS);
+  const { hasAnalysisToolsAccess } = useAtomValue(analysisToolsAccessState);
+  if (!hasAnalysisToolsAccess) {
+    return <AnalysisToolsPaywall featureLabel="Field Usage Analysis" />;
+  }
+  return <Outlet />;
+};
+
+export default DataAnalysis;