Skip to content

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

5.2 KB
Raw Blame
import { logExpected } from '@/utils/Diagnostics';

import { FormDetector } from '../formDetector/FormDetector';

/**
 * Utility for detecting service name and URL information
 * Shared between content script and popup dashboard
 */
export class ServiceDetectionUtility {
  /**
   * Check if a URL points to an actual website (http/https). Browser-internal pages such as
   * new tab, settings and extension pages (chrome://, about:, edge://, moz-extension:// etc.)
   * are not websites and should not be used for service detection.
   */
  public static isWebsiteUrl(rawUrl: string): boolean {
    try {
      const url = new URL(rawUrl);
      return url.protocol === 'http:' || url.protocol === 'https:';
    } catch {
      return false;
    }
  }

  /**
   * Sanitize a raw URL down to its origin (scheme + host + port), stripping the
   * path, query string and fragment.
   */
  public static sanitizeUrl(rawUrl: string): string {
    try {
      const url = new URL(rawUrl);
      // Only include http/https URLs
      if (url.protocol !== 'http:' && url.protocol !== 'https:') {
        return '';
      }
      return url.origin;
    } catch (error) {
      logExpected('[ServiceDetection] The URL could not be parsed', error);
      return '';
    }
  }

  /**
   * Get service information from the current page
   */
  public static getServiceInfo(document: Document, location: Location): ServiceInfo {
    // Get suggested service names using FormDetector
    const suggestedNames = FormDetector.getSuggestedServiceName(document, location);

    // Get the current URL
    const currentUrl = location.href;

    // Process the URL to extract service URL (origin only)
    const serviceUrl = this.sanitizeUrl(currentUrl);

    return {
      suggestedNames,
      currentUrl,
      serviceUrl,
      domain: location.hostname.replace(/^www\./, '')
    };
  }

  /**
   * Get service information from tab data (for use in popup dashboard)
   */
  public static getServiceInfoFromTab(tabUrl: string, tabTitle?: string): ServiceInfo {
    // Skip browser-internal pages (new tab, settings, extension pages) as they are not services.
    if (!this.isWebsiteUrl(tabUrl)) {
      return {
        suggestedNames: [],
        currentUrl: '',
        serviceUrl: '',
        domain: ''
      };
    }

    try {
      const url = new URL(tabUrl);
      const location = {
        href: tabUrl,
        hostname: url.hostname,
        protocol: url.protocol,
        pathname: url.pathname,
        origin: url.origin
      } as Location;

      // Create a minimal document object for service name detection
      const mockDocument = {
        title: tabTitle || url.hostname
      } as Document;

      // Use FormDetector logic for service name detection
      const suggestedNames = FormDetector.getSuggestedServiceName(mockDocument, location);

      // Get service URL (origin only)
      const serviceUrl = this.sanitizeUrl(tabUrl);

      return {
        suggestedNames,
        currentUrl: tabUrl,
        serviceUrl,
        domain: url.hostname.replace(/^www\./, '')
      };
    } catch (error) {
      logExpected('[ServiceDetection] The tab URL could not be parsed, falling back to hostname detection', error);
      // Fallback to basic hostname detection
      const domain = tabUrl.replace(/^https?:\/\/(www\.)?/, '').split('/')[0];
      return {
        suggestedNames: [domain],
        currentUrl: tabUrl,
        serviceUrl: tabUrl,
        domain
      };
    }
  }

  /**
   * Get encoded service information suitable for URL parameters
   */
  public static getEncodedServiceInfo(document: Document, location: Location): EncodedServiceInfo {
    const serviceInfo = this.getServiceInfo(document, location);

    return {
      serviceName: serviceInfo.suggestedNames.length > 0 ? encodeURIComponent(serviceInfo.suggestedNames[0]) : '',
      serviceUrl: serviceInfo.serviceUrl ? encodeURIComponent(serviceInfo.serviceUrl) : '',
      currentUrl: encodeURIComponent(serviceInfo.currentUrl),
      domain: encodeURIComponent(serviceInfo.domain)
    };
  }

  /**
   * Get encoded service information from tab data
   */
  public static getEncodedServiceInfoFromTab(tabUrl: string, tabTitle?: string): EncodedServiceInfo {
    const serviceInfo = this.getServiceInfoFromTab(tabUrl, tabTitle);

    return {
      serviceName: serviceInfo.suggestedNames.length > 0 ? encodeURIComponent(serviceInfo.suggestedNames[0]) : '',
      serviceUrl: serviceInfo.serviceUrl ? encodeURIComponent(serviceInfo.serviceUrl) : '',
      currentUrl: encodeURIComponent(serviceInfo.currentUrl),
      domain: encodeURIComponent(serviceInfo.domain)
    };
  }
}

/**
 * Service information interface
 */
export type ServiceInfo = {
  /** Array of suggested service names */
  suggestedNames: string[];
  /** Current page URL */
  currentUrl: string;
  /** Service URL (origin only: scheme + host + port) */
  serviceUrl: string;
  /** Domain name without www prefix */
  domain: string;
}

/**
 * Encoded service information interface
 */
export type EncodedServiceInfo = {
  /** URL-encoded primary service name */
  serviceName: string;
  /** URL-encoded service URL */
  serviceUrl: string;
  /** URL-encoded current page URL */
  currentUrl: string;
  /** URL-encoded domain */
  domain: string;
}