appShell.ts

/** Packaged desktop shell (Electron `app://`, local `file://` previews). */
export function isDesktopAppShell(): boolean {
  if (typeof window === "undefined" || !window.location?.href) return false;
  try {
    const { protocol } = new URL(window.location.href);
    return protocol !== "http:" && protocol !== "https:";
  } catch {
    return false;
  }
}

/** Browser-style welcome OAuth (web tab or desktop shell with fetch). */
export function hasWelcomeBrowserAuthContext(): boolean {
  return typeof globalThis !== "undefined" && typeof globalThis.fetch === "function";
}

export type DesktopSwapCoffeeFetchResult =
  | { ok: true; status: number; body: string }
  | { ok: false; error: string };

export type DesktopOAuthBridge = {
  openOAuthUrl: (
    authUrl: string,
    apiOrigin: string,
  ) => Promise<{
    ok: boolean;
    error?: string | null;
    sessionToken?: string | null;
  }>;
  fetchSwapCoffee?: (
    url: string,
    init?: {
      method?: string;
      headers?: Record<string, string>;
      body?: string;
      timeoutMs?: number;
    },
  ) => Promise<DesktopSwapCoffeeFetchResult>;
  /** Set by windows/preload.cjs in the Electron shell. */
  isElectronShell?: boolean;
};

declare global {
  interface Window {
    __HSP_DESKTOP__?: DesktopOAuthBridge;
  }
}

export function getDesktopOAuthBridge(): DesktopOAuthBridge | null {
  if (typeof window === "undefined") return null;
  const bridge = window.__HSP_DESKTOP__;
  return bridge && typeof bridge.openOAuthUrl === "function" ? bridge : null;
}

/** Packaged Windows/Electron app (not a normal browser tab). */
export function isElectronDesktopShell(): boolean {
  if (typeof window === "undefined") return false;
  if (window.__HSP_DESKTOP__?.isElectronShell === true) return true;
  return isDesktopAppShell();
}