hyb-oa/client/src/lib/onboardingGuide.ts

export const ONBOARDING_WELCOME_STORAGE_KEY = "hyb_oa_show_welcome";
export const ONBOARDING_ACTIVE_STORAGE_KEY = "hyb_oa_onboarding_active";
export const ONBOARDING_DISMISSED_STORAGE_KEY = "hyb_oa_getting_started_dismissed";

function canUseLocalStorage() {
  return typeof window !== "undefined" && typeof window.localStorage !== "undefined";
}

export function markOnboardingEntryReady() {
  if (!canUseLocalStorage()) {
    return;
  }

  window.localStorage.setItem(ONBOARDING_WELCOME_STORAGE_KEY, "1");
  window.localStorage.setItem(ONBOARDING_ACTIVE_STORAGE_KEY, "1");
  window.localStorage.removeItem(ONBOARDING_DISMISSED_STORAGE_KEY);
}

export function shouldShowWelcomeDialog() {
  return canUseLocalStorage() && window.localStorage.getItem(ONBOARDING_WELCOME_STORAGE_KEY) === "1";
}

export function clearWelcomeDialogFlag() {
  if (!canUseLocalStorage()) {
    return;
  }

  window.localStorage.removeItem(ONBOARDING_WELCOME_STORAGE_KEY);
}

export function shouldShowGettingStartedCard() {
  if (!canUseLocalStorage()) {
    return false;
  }

  return (
    window.localStorage.getItem(ONBOARDING_ACTIVE_STORAGE_KEY) === "1" &&
    window.localStorage.getItem(ONBOARDING_DISMISSED_STORAGE_KEY) !== "1"
  );
}

export function dismissGettingStartedCard() {
  if (!canUseLocalStorage()) {
    return;
  }

  window.localStorage.setItem(ONBOARDING_DISMISSED_STORAGE_KEY, "1");
}