@shipfox/client-onboarding 5.0.0

package/src/workspace-setup-route.ts

@@ -0,0 +1,157 @@
+import {
+  isModelProviderOnboardingDismissed,
+  modelProviderConfigsQueryOptions,
+} from '@shipfox/client-agent';
+import {
+  type IntegrationConnection,
+  sourceConnectionsQueryOptions,
+} from '@shipfox/client-integrations';
+import {projectExistenceQueryOptions} from '@shipfox/client-projects';
+import {WorkspaceSetupLoadError, type WorkspaceSetupState} from '@shipfox/client-shell/runtime';
+import type {QueryClient} from '@tanstack/react-query';
+import {redirect} from '@tanstack/react-router';
+
+const TRAILING_SLASHES_RE = /\/+$/u;
+
+export interface WorkspaceSetupRouteOptions {
+  queryClient: QueryClient;
+  workspaceId: string;
+  pathname: string;
+}
+
+export async function loadWorkspaceSetupRoute({
+  queryClient,
+  workspaceId,
+  pathname,
+}: WorkspaceSetupRouteOptions): Promise<WorkspaceSetupState> {
+  const projects = await fetchWorkspaceProjectExistence(queryClient, workspaceId);
+  const normalizedPathname = normalizePath(pathname);
+
+  if (projects.projects.length > 0) {
+    if (isIntegrationsIndexPath(normalizedPathname, workspaceId)) {
+      throw redirect({
+        to: '/workspaces/$wid/settings/integrations',
+        params: {wid: workspaceId},
+        replace: true,
+      });
+    }
+
+    return {hideProjectNavigation: false};
+  }
+
+  const sourceConnections = await fetchWorkspaceSourceConnections(queryClient, workspaceId);
+  const hasSourceConnection = sourceConnections.length > 0;
+
+  if (!hasSourceConnection) {
+    if (isIntegrationSetupPath(normalizedPathname, workspaceId)) {
+      return {hideProjectNavigation: true};
+    }
+
+    throw redirect({
+      to: '/workspaces/$wid/integrations',
+      params: {wid: workspaceId},
+      replace: true,
+    });
+  }
+
+  if (isAgentSettingsPath(normalizedPathname, workspaceId)) {
+    return {hideProjectNavigation: true};
+  }
+
+  const providerHandled = await hasHandledModelProviderOnboarding(queryClient, workspaceId);
+  if (!providerHandled) {
+    if (isModelProviderOnboardingPath(normalizedPathname, workspaceId)) {
+      return {hideProjectNavigation: true};
+    }
+
+    throw redirect({
+      to: '/workspaces/$wid/model-provider',
+      params: {wid: workspaceId},
+      replace: true,
+    });
+  }
+
+  if (isProjectCreationPath(normalizedPathname, workspaceId)) {
+    return {hideProjectNavigation: true};
+  }
+
+  throw redirect({
+    to: '/workspaces/$wid/projects/new',
+    params: {wid: workspaceId},
+    replace: true,
+  });
+}
+
+async function fetchWorkspaceProjectExistence(queryClient: QueryClient, workspaceId: string) {
+  const options = projectExistenceQueryOptions(workspaceId);
+
+  try {
+    return await queryClient.fetchQuery(options);
+  } catch (error) {
+    const cached = queryClient.getQueryData<{projects: unknown[]}>(options.queryKey);
+    if (cached !== undefined) return cached;
+    throw new WorkspaceSetupLoadError(error);
+  }
+}
+
+async function fetchWorkspaceSourceConnections(queryClient: QueryClient, workspaceId: string) {
+  const options = sourceConnectionsQueryOptions(workspaceId);
+
+  try {
+    return await queryClient.fetchQuery(options);
+  } catch (error) {
+    const cached = queryClient.getQueryData<IntegrationConnection[]>(options.queryKey);
+    if (cached !== undefined) return cached;
+    throw new WorkspaceSetupLoadError(error);
+  }
+}
+
+async function hasHandledModelProviderOnboarding(
+  queryClient: QueryClient,
+  workspaceId: string,
+): Promise<boolean> {
+  if (isModelProviderOnboardingDismissed(workspaceId)) return true;
+
+  const options = modelProviderConfigsQueryOptions(workspaceId);
+  try {
+    const configs = await queryClient.fetchQuery(options);
+    return configs.configs.length > 0;
+  } catch {
+    const cached = queryClient.getQueryData<{configs: unknown[]}>(options.queryKey);
+    return cached?.configs.length !== 0;
+  }
+}
+
+function normalizePath(pathname: string) {
+  if (pathname === '/') return pathname;
+  return pathname.replace(TRAILING_SLASHES_RE, '');
+}
+
+function workspacePath(workspaceId: string, suffix: string) {
+  return `/workspaces/${workspaceId}${suffix}`;
+}
+
+function isIntegrationsIndexPath(pathname: string, workspaceId: string) {
+  return pathname === workspacePath(workspaceId, '/integrations');
+}
+
+function isIntegrationSetupPath(pathname: string, workspaceId: string) {
+  const basePath = workspacePath(workspaceId, '/integrations');
+  return (
+    pathname === basePath ||
+    pathname.startsWith(`${basePath}/`) ||
+    pathname === workspacePath(workspaceId, '/settings/integrations')
+  );
+}
+
+function isProjectCreationPath(pathname: string, workspaceId: string) {
+  return pathname === workspacePath(workspaceId, '/projects/new');
+}
+
+function isModelProviderOnboardingPath(pathname: string, workspaceId: string) {
+  return pathname === workspacePath(workspaceId, '/model-provider');
+}
+
+function isAgentSettingsPath(pathname: string, workspaceId: string) {
+  return pathname === workspacePath(workspaceId, '/settings/agents');
+}

package/test/setup.ts

@@ -0,0 +1,3 @@
+import {installClientDomTestEnv} from '@shipfox/client-test-setup';
+
+installClientDomTestEnv();

package/tsconfig.build.json

@@ -0,0 +1,10 @@
+{
+  "extends": "@shipfox/ts-config/react",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist",
+    "customConditions": ["workspace-source"]
+  },
+  "include": ["src"],
+  "exclude": ["**/*.test.tsx", "**/*.test.ts"]
+}