Skip to content

Privacy-first password manager with built-in email aliasing. Fully encrypted and self-hostable.

3.7 KB
Raw Blame
import { useCallback } from 'react';
import { useSearchParams } from 'react-router-dom';

import { logFailure } from '@/utils/Diagnostics';
import { ServiceDetectionUtility, type ServiceInfo } from '@/utils/serviceDetection/ServiceDetectionUtility';

import { browser } from '#imports';

/**
 * Result of service detection containing name and URL.
 */
type ServiceDetectionResult = {
  /** Detected service name (e.g., "GitHub", "Google") */
  serviceName: string;
  /** Detected service URL (origin only: scheme + host + port) */
  serviceUrl: string;
  /** Alternative service name suggestions derived from the page title/domain */
  suggestedNames: string[];
};

/**
 * Hook for detecting service information from URL parameters or the active browser tab.
 *
 * Service detection sources (in priority order):
 * 1. URL parameters (serviceUrl, currentUrl) + the provided title - e.g., from the content script create flow
 * 2. Active browser tab - for dashboard/popup opened directly
 */
const useServiceDetection = (): {
  detectService: (fallbackName?: string | null) => Promise<ServiceDetectionResult>;
} => {
  const [searchParams] = useSearchParams();

  /**
   * Detect service information from URL parameters or active tab.
   *
   * @param fallbackName - Optional fallback name if detection fails (e.g., from URL param)
   * @returns Promise resolving to detected service name and URL
   */
  const detectService = useCallback(async (fallbackName?: string | null): Promise<ServiceDetectionResult> => {
    let detectedName = fallbackName || '';
    let detectedUrl = '';
    let suggestedNames: string[] = [];

    try {
      // Get URL parameters (e.g., from content script create flow)
      const serviceUrlFromUrl = searchParams.get('serviceUrl');
      const currentUrl = searchParams.get('currentUrl');

      // If URL parameters are present, use them
      if (serviceUrlFromUrl || currentUrl) {
        if (serviceUrlFromUrl) {
          detectedUrl = decodeURIComponent(serviceUrlFromUrl);
        }

        // If we have currentUrl, derive url/suggestions from it (and a name only as a fallback)
        if (currentUrl) {
          const decodedCurrentUrl = decodeURIComponent(currentUrl);
          const serviceInfo: ServiceInfo = ServiceDetectionUtility.getServiceInfoFromTab(decodedCurrentUrl);
          suggestedNames = serviceInfo.suggestedNames;

          // Only fall back to a URL-derived name when no explicit title was provided.
          if (!detectedName && serviceInfo.suggestedNames.length > 0) {
            detectedName = serviceInfo.suggestedNames[0];
          }
          if (!serviceUrlFromUrl && serviceInfo.serviceUrl) {
            detectedUrl = serviceInfo.serviceUrl;
          }
        }
      } else {
        // No URL parameters - detect from current active tab (dashboard case)
        const [activeTab] = await browser.tabs.query({ active: true, currentWindow: true });

        if (activeTab?.url) {
          const serviceInfo: ServiceInfo = ServiceDetectionUtility.getServiceInfoFromTab(
            activeTab.url,
            activeTab.title
          );
          suggestedNames = serviceInfo.suggestedNames;

          if (serviceInfo.suggestedNames.length > 0 && !detectedName) {
            detectedName = serviceInfo.suggestedNames[0];
          }
          if (serviceInfo.serviceUrl) {
            detectedUrl = serviceInfo.serviceUrl;
          }
        }
      }
    } catch (error) {
      logFailure('Error detecting service information', error);
    }

    return {
      serviceName: detectedName,
      serviceUrl: detectedUrl,
      suggestedNames,
    };
  }, [searchParams]);

  return {
    detectService,
  };
};

export default useServiceDetection;
export type { ServiceDetectionResult };