Skip to content

Voice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.

2.6 KB
Raw Blame
import { useCallback, useEffect, useRef, useState } from "react";
import type { PermissionGuideId } from "../../types/permissionGuide";
import { createPermissionGuideController, type GuidePermission } from "./permissionGuideController";

interface Options {
  enabled: boolean;
  progress: PermissionGuideId | null;
  save: (progress: PermissionGuideId | null) => void;
  dismissed: () => void;
  rows: GuidePermission[];
}

export function usePermissionGuide(options: Options): {
  start: (permission: PermissionGuideId) => Promise<void>;
  error: boolean;
} {
  const latest = useRef(options);
  latest.current = options;
  const controller = useRef<ReturnType<typeof createPermissionGuideController> | null>(null);
  const [error, setError] = useState(false);
  const eligibility = options.rows.map((row) => row.id).join(",");

  useEffect(() => {
    if (!options.enabled) return;
    const api = window.electronAPI;
    const guide = createPermissionGuideController({
      sessionId: crypto.randomUUID(),
      rows: () => latest.current.rows,
      save: (progress) => latest.current.save(progress),
      publish: async (state) => {
        try {
          return (await api.openPermissionGuide?.(state)) ?? false;
        } catch {
          return false;
        }
      },
      unavailable: () => setError(true),
      dismissed: () => latest.current.dismissed(),
      close: () => {
        void api.closePermissionGuide?.().catch(() => {});
      },
      restart: api.relaunchApp,
    });
    controller.current = guide;
    const unsubscribe = api.onPermissionGuideAction?.((action) => {
      void guide.act(action);
    });
    const refresh = (): void => {
      void guide.refresh();
    };
    // Re-checked often enough that the overlay disappears as soon as the user
    // grants the permission — dragging the app into the list enables it, and a
    // slower loop reads as the overlay ignoring what you just did.
    const timer = window.setInterval(refresh, 750);
    window.addEventListener("focus", refresh);
    if (latest.current.progress) void guide.start(undefined, latest.current.progress);
    return () => {
      controller.current = null;
      guide.dispose();
      unsubscribe?.();
      clearInterval(timer);
      window.removeEventListener("focus", refresh);
      void api.closePermissionGuide?.().catch(() => {});
    };
  }, [options.enabled]);

  useEffect(() => {
    void controller.current?.reconcile();
  }, [eligibility]);

  const start = useCallback(async (permission: PermissionGuideId): Promise<void> => {
    await controller.current?.start(permission);
  }, []);
  return { start, error };
}