import { scopeProjectRef } from "@t3tools/client-runtime/environment"; import type { EnvironmentId, ScopedProjectRef } from "@t3tools/contracts"; import { deriveLogicalProjectKeyFromSettings, derivePhysicalProjectKey, deriveProjectGroupLabel, type ProjectGroupingSettings, } from "./logicalProject"; import type { Project } from "./types"; export type EnvironmentPresence = "local-only" | "remote-only" | "mixed"; export interface SidebarProjectGroupMember extends Project { physicalProjectKey: string; environmentLabel: string | null; } export interface SidebarProjectSnapshot extends Project { projectKey: string; displayName: string; groupedProjectCount: number; environmentPresence: EnvironmentPresence; // True iff every non-primary member of this group lives in a // desktopLocal env (today: the WSL backend). The sidebar uses this // to differentiate "lives on this machine but in a sandbox" from // "lives on a real remote" so the project header can pick a // container icon instead of the generic cloud icon. allRemoteMembersAreDesktopLocal: boolean; memberProjects: readonly SidebarProjectGroupMember[]; memberProjectRefs: readonly ScopedProjectRef[]; remoteEnvironmentLabels: readonly string[]; } export interface SidebarProjectPickerEntry { group: SidebarProjectSnapshot; targetProject: SidebarProjectGroupMember; isPreferred: boolean; } interface SidebarProjectGroupCandidate { readonly logicalKey: string; readonly project: Project; } function getProjectFreshnessTime(project: Project): number { const updatedAtTime = Date.parse(project.updatedAt); if (Number.isFinite(updatedAtTime)) { return updatedAtTime; } const createdAtTime = Date.parse(project.createdAt); return Number.isFinite(createdAtTime) ? createdAtTime : 0; } function shouldReplaceDuplicateMember(input: { existingMember: Project; candidateMember: Project; primaryEnvironmentId: EnvironmentId | null; }): boolean { if ( input.primaryEnvironmentId !== null && input.existingMember.environmentId !== input.primaryEnvironmentId && input.candidateMember.environmentId === input.primaryEnvironmentId ) { return true; } const existingFreshness = getProjectFreshnessTime(input.existingMember); const candidateFreshness = getProjectFreshnessTime(input.candidateMember); if (candidateFreshness !== existingFreshness) { return candidateFreshness > existingFreshness; } return input.candidateMember.id > input.existingMember.id; } function collectProjectWinnersByPhysicalKey(input: { projects: ReadonlyArray; settings: ProjectGroupingSettings; primaryEnvironmentId: EnvironmentId | null; }): Map { const winnersByPhysicalKey = new Map(); for (const project of input.projects) { const logicalKey = deriveLogicalProjectKeyFromSettings(project, input.settings); const physicalProjectKey = derivePhysicalProjectKey(project); const existing = winnersByPhysicalKey.get(physicalProjectKey); if (!existing) { winnersByPhysicalKey.set(physicalProjectKey, { logicalKey, project }); continue; } if ( shouldReplaceDuplicateMember({ existingMember: existing.project, candidateMember: project, primaryEnvironmentId: input.primaryEnvironmentId, }) ) { winnersByPhysicalKey.set(physicalProjectKey, { logicalKey, project }); } } return winnersByPhysicalKey; } export function buildPhysicalToLogicalProjectKeyMap(input: { projects: ReadonlyArray; settings: ProjectGroupingSettings; primaryEnvironmentId: EnvironmentId | null; }): Map { const mapping = new Map(); for (const [physicalProjectKey, winner] of collectProjectWinnersByPhysicalKey(input)) { mapping.set(physicalProjectKey, winner.logicalKey); } return mapping; } export function buildSidebarProjectSnapshots(input: { projects: ReadonlyArray; settings: ProjectGroupingSettings; primaryEnvironmentId: EnvironmentId | null; resolveEnvironmentLabel: (environmentId: EnvironmentId) => string | null; // Returns true when an env id maps to a desktopLocal saved-env // record (today: the WSL backend). Defaults to "false for every // env" so callers that don't care about the distinction get the // legacy behavior. isDesktopLocalEnvironment?: (environmentId: EnvironmentId) => boolean; }): SidebarProjectSnapshot[] { const winnersByPhysicalKey = collectProjectWinnersByPhysicalKey(input); const groupedMembers = new Map(); for (const { logicalKey, project } of winnersByPhysicalKey.values()) { const member: SidebarProjectGroupMember = { ...project, physicalProjectKey: derivePhysicalProjectKey(project), environmentLabel: input.resolveEnvironmentLabel(project.environmentId), }; const existingMembers = groupedMembers.get(logicalKey); if (existingMembers) { existingMembers.push(member); } else { groupedMembers.set(logicalKey, [member]); } } const projectRefsByLogicalKey = new Map(); const seenProjectRefs = new Set(); for (const project of input.projects) { const physicalProjectKey = derivePhysicalProjectKey(project); const logicalKey = winnersByPhysicalKey.get(physicalProjectKey)?.logicalKey ?? deriveLogicalProjectKeyFromSettings(project, input.settings); const projectRefKey = `${project.environmentId}:${project.id}`; if (seenProjectRefs.has(projectRefKey)) continue; seenProjectRefs.add(projectRefKey); const projectRef = scopeProjectRef(project.environmentId, project.id); const existingRefs = projectRefsByLogicalKey.get(logicalKey); if (existingRefs) { existingRefs.push(projectRef); } else { projectRefsByLogicalKey.set(logicalKey, [projectRef]); } } const result: SidebarProjectSnapshot[] = []; const seen = new Set(); for (const project of input.projects) { const logicalKey = deriveLogicalProjectKeyFromSettings(project, input.settings); if (seen.has(logicalKey)) { continue; } seen.add(logicalKey); const members = groupedMembers.get(logicalKey) ?? []; const representative = (input.primaryEnvironmentId ? members.find((member) => member.environmentId === input.primaryEnvironmentId) : null) ?? members[0]; if (!representative) { continue; } const hasLocal = input.primaryEnvironmentId !== null && members.some((member) => member.environmentId === input.primaryEnvironmentId); const hasRemote = input.primaryEnvironmentId !== null ? members.some((member) => member.environmentId !== input.primaryEnvironmentId) : false; const remoteMembers = members.filter( (member) => input.primaryEnvironmentId !== null && member.environmentId !== input.primaryEnvironmentId, ); const remoteEnvironmentLabels = remoteMembers .flatMap((member) => (member.environmentLabel ? [member.environmentLabel] : [])) .filter((label, index, labels) => labels.indexOf(label) === index); const isDesktopLocal = input.isDesktopLocalEnvironment ?? (() => false); const allRemoteMembersAreDesktopLocal = remoteMembers.length > 0 && remoteMembers.every((member) => isDesktopLocal(member.environmentId)); result.push({ ...representative, projectKey: logicalKey, displayName: members.length > 1 ? deriveProjectGroupLabel({ representative, members, }) : representative.title, groupedProjectCount: members.length, environmentPresence: hasLocal && hasRemote ? "mixed" : hasRemote ? "remote-only" : "local-only", allRemoteMembersAreDesktopLocal, memberProjects: members, memberProjectRefs: projectRefsByLogicalKey.get(logicalKey) ?? [], remoteEnvironmentLabels, }); } return result; } export function buildSidebarProjectPickerEntries(input: { groups: ReadonlyArray; preferredProjectRef: ScopedProjectRef | null; }) { const entries = input.groups.flatMap((group): SidebarProjectPickerEntry[] => { const isPreferred = input.preferredProjectRef ? group.memberProjectRefs.some( (projectRef) => projectRef.environmentId === input.preferredProjectRef?.environmentId && projectRef.projectId === input.preferredProjectRef.projectId, ) : false; const preferredProject = isPreferred ? (group.memberProjects.find( (project) => project.environmentId === input.preferredProjectRef?.environmentId && project.id === input.preferredProjectRef?.projectId, ) ?? group.memberProjects.find( (project) => project.environmentId === input.preferredProjectRef?.environmentId, )) : null; const targetProject = preferredProject ?? group.memberProjects.find( (project) => project.environmentId === group.environmentId && project.id === group.id, ) ?? group.memberProjects[0]; if (!targetProject) return []; return [{ group, targetProject, isPreferred }]; }); const preferredIndex = entries.findIndex((entry) => entry.isPreferred); if (preferredIndex <= 0) return entries; return [ entries[preferredIndex]!, ...entries.slice(0, preferredIndex), ...entries.slice(preferredIndex + 1), ]; }