import type { BrowserImportFailureReason, BrowserImportSource } from "@t3tools/contracts";
export interface WizardTargetProfile {
readonly id: string;
readonly name: string;
}
export type WizardTarget =
| { readonly kind: "new"; readonly profileId: string }
| { readonly kind: "existing"; readonly profileId: string; readonly name: string };
export type WizardTargetSelection =
| { readonly kind: "new" }
| { readonly kind: "existing"; readonly profileId: string };
export function initialTargetSelection(
canCreateProfile: boolean,
targetProfiles: ReadonlyArray<WizardTargetProfile>,
): WizardTargetSelection {
if (canCreateProfile) return { kind: "new" };
const first = targetProfiles[0];
return first ? { kind: "existing", profileId: first.id } : { kind: "new" };
}
export function resolveWizardTarget(
selection: WizardTargetSelection,
newProfileId: string,
targetProfiles: ReadonlyArray<WizardTargetProfile>,
): WizardTarget | undefined {
if (selection.kind === "new") return { kind: "new", profileId: newProfileId };
const profile = targetProfiles.find((candidate) => candidate.id === selection.profileId);
if (profile === undefined) return undefined;
return {
kind: "existing",
profileId: selection.profileId,
name: profile.name,
};
}
export type ImportOutcome =
| {
readonly kind: "imported";
readonly imported: number;
readonly skipped: number;
readonly skippedDomains: ReadonlyArray<string>;
readonly targetName: string;
}
| {
readonly kind: "blocked";
readonly reason: BrowserImportFailureReason;
/** Shown instead of the reason's copy, such as a managed policy's refusal. */
readonly message?: string;
};
export type WizardStep =
| { readonly step: "quit" }
| {
readonly step: "fullDiskAccess";
readonly resume: "configure" | "import";
readonly checked?: boolean;
}
| { readonly step: "configure" }
| { readonly step: "checking"; readonly check: "browser" | "fullDiskAccess" }
| { readonly step: "importing" }
| {
readonly step: "done";
readonly imported: number;
readonly skipped: number;
readonly skippedDomains: ReadonlyArray<string>;
readonly targetName: string;
}
| {
readonly step: "blocked";
readonly reason: BrowserImportFailureReason;
readonly message?: string;
};
export function canCloseWizard(step: WizardStep): boolean {
return step.step !== "importing";
}
export function initialWizardStep(source: BrowserImportSource): WizardStep {
if (source.unavailable === "browserRunning") return { step: "quit" };
if (source.unavailable === "needsFullDiskAccess") {
return { step: "fullDiskAccess", resume: "configure" };
}
if (source.unavailable !== undefined) return { step: "blocked", reason: source.unavailable };
if (source.profiles.length === 0) return { step: "blocked", reason: "unknownSourceProfile" };
return { step: "configure" };
}
export function outcomeToStep(outcome: ImportOutcome): WizardStep {
if (outcome.kind === "imported") {
return {
step: "done",
imported: outcome.imported,
skipped: outcome.skipped,
skippedDomains: outcome.skippedDomains,
targetName: outcome.targetName,
};
}
if (outcome.reason === "browserRunning") return { step: "quit" };
if (outcome.reason === "needsFullDiskAccess") {
return { step: "fullDiskAccess", resume: "import", checked: true };
}
return outcome.message === undefined
? { step: "blocked", reason: outcome.reason }
: { step: "blocked", reason: outcome.reason, message: outcome.message };
}
export function refreshedSourceStep(source: BrowserImportSource | undefined): WizardStep {
if (source === undefined) return { step: "blocked", reason: "unknownSource" };
return initialWizardStep(source);
}
export function fullDiskAccessRecheckStep(source: BrowserImportSource | undefined): WizardStep {
const next = refreshedSourceStep(source);
return next.step === "fullDiskAccess" ? { ...next, checked: true } : next;
}
export function refreshedSourceProfileDirectory(
currentDirectory: string,
source: BrowserImportSource,
): string {
if (source.profiles.some((profile) => profile.directory === currentDirectory)) {
return currentDirectory;
}
return source.profiles[0]?.directory ?? "";
}
export function isRetryableReason(reason: BrowserImportFailureReason): boolean {
switch (reason) {
case "needsKeychainApproval":
case "keychainItemMissing":
case "keychainUnavailable":
case "readFailed":
case "sessionUnavailable":
case "profileNotSaved":
return true;
default:
return false;
}
}
export function formatSkippedDomains(domains: ReadonlyArray<string>): string {
if (domains.length === 0) return "";
if (domains.length === 1) return domains[0]!;
if (domains.length <= 3) return `${domains.slice(0, -1).join(", ")} and ${domains.at(-1)}`;
return `${domains.slice(0, 3).join(", ")} and ${domains.length - 3} more`;
}