cozsweet-frontend-nextjs/src/hooks/use-pwa-install.ts

"use client";
/**
 * PWA Install 提示 hook
 *
 * 原始 Dart: `pwa_install` 包的 BeforeInstallPrompt 事件封装
 * （`lib/ui/chat/widgets/pwa_install_overlay.dart` + `pwa_install_dialog.dart`）。
 *
 * 浏览器 API：`beforeinstallprompt` 事件 → 用户触发 → 浏览器展示原生安装提示。
 *
 * 用法：
 *   const { canInstall, promptInstall } = usePwaInstall();
 *   if (canInstall) <button onClick={promptInstall}>Install</button>;
 */
import { useEffect, useState } from "react";

interface BeforeInstallPromptEvent extends Event {
  prompt(): Promise<void>;
  userChoice: Promise<{ outcome: "accepted" | "dismissed" }>;
}

export function usePwaInstall(): {
  canInstall: boolean;
  promptInstall: () => Promise<"accepted" | "dismissed" | "unavailable">;
} {
  const [deferred, setDeferred] = useState<BeforeInstallPromptEvent | null>(null);

  useEffect(() => {
    if (typeof window === "undefined") return;
    const handler = (e: Event) => {
      e.preventDefault();
      setDeferred(e as BeforeInstallPromptEvent);
    };
    window.addEventListener("beforeinstallprompt", handler);
    return () => window.removeEventListener("beforeinstallprompt", handler);
  }, []);

  return {
    canInstall: deferred !== null,
    promptInstall: async () => {
      if (!deferred) return "unavailable";
      await deferred.prompt();
      const choice = await deferred.userChoice;
      setDeferred(null);
      return choice.outcome;
    },
  };
}