Skip to content

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

25.6 KB
Raw Blame
import { Gender, IdentityHelperUtils } from "@aliasvault/models/identity";

import { logFailure } from '@/utils/Diagnostics';
import { CombinedDateOptionPatterns, CombinedGenderOptionPatterns } from "@/utils/formDetector/FieldPatterns";
import { type FormFields } from "@/utils/formDetector/types/FormFields";
import { ClickValidator } from "@/utils/security/ClickValidator";
import { composedContains } from "@/utils/ShadowDom";

import type { Credential } from "@aliasvault/models/vault";
/**
 * Class to fill the fields of a form with the given credential.
 */
export class FormFiller {
  private readonly clickValidator = ClickValidator.getInstance();

  /**
   * Constructor.
   */
  public constructor(
    private readonly form: FormFields,
    private readonly triggerInputEvents: (element: HTMLInputElement | HTMLSelectElement, animate?: boolean) => void
  ) {
    /**
     * Trigger input events.
     */
    this.triggerInputEvents = (element: HTMLInputElement | HTMLSelectElement, animate = true) : void => triggerInputEvents(element, animate);
  }

  /**
   * Fill the fields of the form with the given credential.
   * @param credential The credential to fill the form with.
   */
  public async fillFields(credential: Credential): Promise<void> {
    // Perform security validation to identify safe fields
    const securityResults = await this.validateFormSecurity();

    /*
     * Fill fields sequentially to avoid race conditions and conflicts.
     * Some websites have event handlers that can interfere with parallel filling.
     * Only fill fields that passed security validation.
     */
    await this.fillBasicFields(credential, securityResults);
    await this.fillPasswordFields(credential, securityResults);

    this.fillBirthdateFields(credential);
    this.fillGenderFields(credential);
  }

  /**
   * Validate form security to prevent autofill in potential clickjacking scenarios.
   * This method checks for various attack vectors including:
   * - Page-wide opacity manipulation
   * - Form field obstruction via overlays
   * - Suspicious element positioning
   * - Multiple forms with identical fields (potential decoy attacks)
   *
   * @returns A map of field elements to their security validation result (true = safe, false = unsafe)
   */
  private async validateFormSecurity(): Promise<Map<HTMLElement, boolean>> {
    const results = new Map<HTMLElement, boolean>();

    try {
      // Skip security validation in test environments where browser APIs may not be available
      if (typeof window === 'undefined' || typeof MouseEvent === 'undefined') {
        // In test environments, mark all fields as safe
        this.getAllFormFields().forEach(field => results.set(field, true));
        return results;
      }

      // 1. Check page-wide security using ClickValidator (detects body/HTML opacity tricks)
      const dummyEvent = new MouseEvent('click', {
        bubbles: true,
        cancelable: true,
        clientX: window.innerWidth / 2,
        clientY: window.innerHeight / 2
      });
      // Note: isTrusted is read-only and set by the browser

      const pageWideSecure = await this.clickValidator.validateClick(dummyEvent);
      if (!pageWideSecure) {
        console.warn('[AliasVault Security] Page-wide attack detected - blocking all autofill');
        // Mark all fields as unsafe
        this.getAllFormFields().forEach(field => results.set(field, false));
        return results;
      }

      // 2. Check for suspicious form duplication (decoy attack)
      const hasDecoyForms = this.detectDecoyForms();
      if (hasDecoyForms) {
        console.warn('[AliasVault Security] Multiple suspicious forms detected - blocking all autofill');
        // Mark all fields as unsafe
        this.getAllFormFields().forEach(field => results.set(field, false));
        return results;
      }

      // 3. Check individual form field obstruction and positioning
      const formFields = this.getAllFormFields();
      for (const field of formFields) {
        const isFieldSecure = this.validateFieldSecurity(field);
        results.set(field, isFieldSecure);

        if (!isFieldSecure) {
          console.warn('[AliasVault Security] Field failed security check (will be skipped):', field);
        }
      }

      return results;
    } catch (error) {
      logFailure('[AliasVault Security] Form security validation error', error);
      // Fail safely - mark all fields as unsafe if validation fails
      this.getAllFormFields().forEach(field => results.set(field, false));
      return results;
    }
  }

  /**
   * Get all form fields that will be filled.
   */
  private getAllFormFields(): HTMLElement[] {
    const fields: HTMLElement[] = [];

    if (this.form.usernameField) {
      fields.push(this.form.usernameField);
    }
    if (this.form.passwordField) {
      fields.push(this.form.passwordField);
    }
    if (this.form.passwordConfirmField) {
      fields.push(this.form.passwordConfirmField);
    }
    if (this.form.emailField) {
      fields.push(this.form.emailField);
    }
    if (this.form.emailConfirmField) {
      fields.push(this.form.emailConfirmField);
    }

    return fields;
  }

  /**
   * Validate individual field security to detect obstruction attacks.
   */
  private validateFieldSecurity(field: HTMLElement): boolean {
    if (!field) {
      return true;
    }

    // Skip field validation in test environments where browser APIs may not be available
    if (typeof window === 'undefined' || typeof document === 'undefined' || !document.elementsFromPoint) {
      return true;
    }

    const rect = field.getBoundingClientRect();
    const centerX = rect.left + rect.width / 2;
    const centerY = rect.top + rect.height / 2;

    // Check if field is within viewport
    if (rect.width === 0 || rect.height === 0 ||
        centerX < 0 || centerY < 0 ||
        centerX > window.innerWidth || centerY > window.innerHeight) {
      console.warn('[AliasVault Security] Field outside viewport or zero-sized:', rect);
      return false;
    }

    // Use elementsFromPoint to check what's actually at the field center
    try {
      const elementsAtPoint = document.elementsFromPoint(centerX, centerY);

      if (elementsAtPoint.length === 0) {
        console.warn('[AliasVault Security] No elements found at field center');
        return false;
      }

      /**
       * Check if our field is in the element stack (or its parents/children)
       * @param element - The element to check.
       * @returns True when the element belongs to the field's own composed subtree or its ancestors.
       */
      const isFieldOrRelated = (element: Element): boolean =>
        element === field || composedContains(field, element) || composedContains(element, field);

      const fieldFound = elementsAtPoint.some(isFieldOrRelated);

      if (!fieldFound) {
        console.warn('[AliasVault Security] Field is obstructed by other elements');
        return false;
      }

      // Check for suspicious covering elements
      const suspiciousCovering = elementsAtPoint.slice(0, 3).some(element => {
        if (isFieldOrRelated(element)) {
          return false; // This is our field or related element
        }

        const style = getComputedStyle(element);

        // Check for nearly transparent overlays
        const opacity = parseFloat(style.opacity);
        if (opacity > 0 && opacity < 0.1) {
          console.warn('[AliasVault Security] Nearly transparent overlay detected:', element);
          return true;
        }

        // Check for high z-index elements (potential overlays)
        const zIndex = parseInt(style.zIndex) || 0;
        if (zIndex > 1000000) {
          console.warn('[AliasVault Security] Suspicious high z-index element:', element, zIndex);
          return true;
        }

        // Check for elements covering large areas (potential clickjacking overlays)
        const elementRect = element.getBoundingClientRect();
        if (elementRect.width >= window.innerWidth * 0.8 &&
            elementRect.height >= window.innerHeight * 0.8) {
          console.warn('[AliasVault Security] Large covering element detected:', element);
          return true;
        }

        return false;
      });

      return !suspiciousCovering;
    } catch (error) {
      console.warn('[AliasVault Security] Field validation error:', error);
      return false; // Fail safely
    }
  }

  /**
   * Detect potential decoy forms (multiple forms with similar fields).
   */
  private detectDecoyForms(): boolean {
    try {
      // Find all forms on the page
      const allForms = Array.from(document.querySelectorAll('form'));

      if (allForms.length <= 1) {
        return false; // Only one form, no decoy risk
      }

      let suspiciousFormCount = 0;

      for (const form of allForms) {
        const hasPasswordField = form.querySelector('input[type="password"]');
        const hasEmailField = form.querySelector('input[type="email"], input[name*="email" i], input[placeholder*="email" i]');
        const hasUsernameField = form.querySelector('input[type="text"], input[name*="user" i], input[placeholder*="user" i]');

        // Count forms with login-like patterns
        if (hasPasswordField && (hasEmailField || hasUsernameField)) {
          const formRect = form.getBoundingClientRect();
          const isVisible = formRect.width > 0 && formRect.height > 0;

          if (isVisible) {
            suspiciousFormCount++;
          }
        }
      }

      // If more than 2 visible login forms, it's suspicious
      if (suspiciousFormCount > 2) {
        console.warn('[AliasVault Security] Multiple login forms detected:', suspiciousFormCount);
        return true;
      }

      return false;
    } catch (error) {
      console.warn('[AliasVault Security] Decoy form detection error:', error);
      return false; // Don't block on detection errors
    }
  }

  /**
   * Set value on an input element, handling both regular inputs and custom elements with shadow DOM.
   * @param element The element to set the value on
   * @param value The value to set
   */
  private setElementValue(element: HTMLInputElement | HTMLSelectElement, value: string): void {
    /*
     * Check for shadow DOM first - if found, only set value on the shadow input
     * to avoid duplicate value setting which can cause conflicts.
     */
    if (element.shadowRoot) {
      const shadowInput = element.shadowRoot.querySelector('input, textarea') as HTMLInputElement;
      if (shadowInput) {
        shadowInput.value = value;
        this.triggerInputEvents(shadowInput, false);
        return;
      }
    }

    /*
     * Check for child input (non-shadow DOM) only if element is not already an input.
     * This handles custom wrapper elements.
     */
    if (element.tagName.toLowerCase() !== 'input' && element.tagName.toLowerCase() !== 'select' && element.tagName.toLowerCase() !== 'textarea') {
      const childInput = element.querySelector('input, textarea, select') as HTMLInputElement | HTMLSelectElement;
      if (childInput) {
        childInput.value = value;
        this.triggerInputEvents(childInput, false);
        return;
      }
    }

    /*
     * Default case: set value directly on the element.
     * This handles standard HTML input/select/textarea elements.
     */
    element.value = value;
  }

  /**
   * Fill the basic fields of the form.
   * @param credential The credential to fill the form with.
   * @param securityResults Security validation results for each field.
   */
  private async fillBasicFields(credential: Credential, securityResults: Map<HTMLElement, boolean>): Promise<void> {
    if (this.form.usernameField && securityResults.get(this.form.usernameField) !== false) {
      if (credential.Username) {
        await this.fillTextFieldWithTyping(this.form.usernameField, credential.Username);
      } else if (credential.Alias?.Email && !this.form.emailField) {
        /*
         * If current form has no email field AND the credential has an email
         * then we can assume the email should be used as the username.
         *
         * This applies to the usecase where the credential only has email/password
         * (no explicit username) and the login form uses a username field for the
         * email/login identifier.
         */
        await this.fillTextFieldWithTyping(this.form.usernameField, credential.Alias.Email);
      }
    }

    if (this.form.emailField && (credential.Alias?.Email !== undefined || credential.Username !== undefined) && securityResults.get(this.form.emailField) !== false) {
      if (credential.Alias?.Email) {
        await this.fillTextFieldWithTyping(this.form.emailField, credential.Alias.Email);
      } else if (credential.Username && !this.form.usernameField) {
        /*
         * If current form has no username field AND the credential has a username
         * then we can assume the username should be used as the email.
         *
         * This applies to the usecase where the AliasVault credential was imported
         * from a previous password manager that only had username/password fields
         * or where the user manually created a credential with only a username/password.
         */
        await this.fillTextFieldWithTyping(this.form.emailField, credential.Username);
      }
    }

    if (this.form.emailConfirmField && credential.Alias?.Email && securityResults.get(this.form.emailConfirmField) !== false) {
      await this.fillTextFieldWithTyping(this.form.emailConfirmField, credential.Alias.Email);
    }

    if (this.form.fullNameField && credential.Alias?.FirstName && credential.Alias?.LastName) {
      this.setElementValue(this.form.fullNameField, `${credential.Alias.FirstName} ${credential.Alias.LastName}`);
      this.triggerInputEvents(this.form.fullNameField);
    }

    if (this.form.firstNameField && credential.Alias?.FirstName) {
      this.setElementValue(this.form.firstNameField, credential.Alias.FirstName);
      this.triggerInputEvents(this.form.firstNameField);
    }

    if (this.form.lastNameField && credential.Alias?.LastName) {
      this.setElementValue(this.form.lastNameField, credential.Alias.LastName);
      this.triggerInputEvents(this.form.lastNameField);
    }
  }

  /**
   * Fill a text field with character-by-character typing to better simulate human input.
   *
   * @param field The text field to fill.
   * @param text The text to fill the field with.
   */
  private async fillTextFieldWithTyping(field: HTMLInputElement, text: string): Promise<void> {
    const actualInput = this.findActualInputElement(field, 'input, textarea');
    await this.typeTextIntoField(actualInput, text);
    this.triggerInputEvents(actualInput, true);
  }

  /**
   * Fill password fields sequentially to avoid visual conflicts.
   * First fills the main password field, then the confirm field if present.
   * @param credential The credential containing the password.
   * @param securityResults Security validation results for each field.
   */
  private async fillPasswordFields(credential: Credential, securityResults: Map<HTMLElement, boolean>): Promise<void> {
    if (!credential.Password) {
      return;
    }

    // Fill main password field first (only if it passed security check)
    if (this.form.passwordField && securityResults.get(this.form.passwordField) !== false) {
      await this.fillPasswordField(this.form.passwordField, credential.Password);
    }

    // Then fill password confirm field after main field is complete (only if it passed security check)
    if (this.form.passwordConfirmField && securityResults.get(this.form.passwordConfirmField) !== false) {
      await this.fillPasswordField(this.form.passwordConfirmField, credential.Password);
    }
  }

  /**
   * Fill the password field with the given password using character-by-character typing.
   *
   * @param field The password field to fill.
   * @param password The password to fill the field with.
   */
  private async fillPasswordField(field: HTMLInputElement, password: string): Promise<void> {
    const actualInput = this.findActualInputElement(field, 'input[type="password"], input');
    await this.typeTextIntoField(actualInput, password);
    this.triggerInputEvents(actualInput, true);
  }

  /**
   * Find the actual input element, which could be in shadow DOM or a child element.
   * This ensures we only fill one element, avoiding duplicate fills.
   *
   * @param field The field element to search within.
   * @param selector The CSS selector to use for finding inputs.
   * @returns The actual input element to fill.
   */
  private findActualInputElement(field: HTMLInputElement, selector: string): HTMLInputElement {
    // Check for shadow DOM input
    if (field.shadowRoot) {
      const shadowInput = field.shadowRoot.querySelector(selector) as HTMLInputElement;
      if (shadowInput) {
        return shadowInput;
      }
    }

    // Check for child input (non-shadow DOM) only if field is not already an input
    const tagName = field.tagName.toLowerCase();
    if (tagName !== 'input' && tagName !== 'textarea') {
      const childInput = field.querySelector(selector) as HTMLInputElement;
      if (childInput) {
        return childInput;
      }
    }

    return field;
  }

  /**
   * Type text into a field character-by-character with small delays to simulate human typing.
   * Includes protection against websites that clear/reset fields on first interaction.
   *
   * @param field The input field to type into.
   * @param text The text to type.
   */
  private async typeTextIntoField(field: HTMLInputElement, text: string): Promise<void> {
    // Clear the field first without triggering events
    field.value = '';

    // Type each character with a small delay
    for (let i = 0; i < text.length; i++) {
      const expectedValue = text.substring(0, i + 1);
      field.value += text[i];

      // Small delay between characters to simulate human typing
      await new Promise(resolve => setTimeout(resolve, Math.random() * 10 + 10));

      /*
       * Some websites have input event handlers that clear/reset the field
       * (e.g., initialization logic on first interaction, or framework reactivity).
       * After the delay (when handlers have had a chance to run), verify the value
       * and correct it if it was unexpectedly modified.
       */
      if (field.value !== expectedValue) {
        field.value = expectedValue;
      }
    }

    // Final verification: if value doesn't match, set it directly
    if (field.value !== text) {
      field.value = text;
    }
  }

  /**
   * Fill the birthdate fields of the form.
   * @param credential The credential to fill the form with.
   */
  private fillBirthdateFields(credential: Credential): void {
    // TODO: when birth date is made optional in datamodel, we can remove this mindate check here.
    if (!IdentityHelperUtils.isValidBirthDate(credential.Alias.BirthDate)) {
      return;
    }

    const birthDate = new Date(credential.Alias.BirthDate);

    if (this.form.birthdateField.single) {
      this.fillSingleBirthdateField(birthDate);
    } else {
      this.fillSeparateBirthdateFields(birthDate);
    }
  }

  /**
   * Fill the single birthdate field.
   * @param birthDate The birthdate to fill the form with.
   */
  private fillSingleBirthdateField(birthDate: Date): void {
    const day = birthDate.getDate().toString().padStart(2, '0');
    const month = (birthDate.getMonth() + 1).toString().padStart(2, '0');
    const year = birthDate.getFullYear().toString();

    const formattedDate = this.formatDateString(day, month, year);
    this.form.birthdateField.single!.value = formattedDate;
    this.triggerInputEvents(this.form.birthdateField.single!);
  }

  /**
   * Format the date string based on the format of the birthdate field.
   * @param day The day of the birthdate.
   * @param month The month of the birthdate.
   * @param year The year of the birthdate.
   * @returns The formatted date string.
   */
  private formatDateString(day: string, month: string, year: string): string {
    switch (this.form.birthdateField.format) {
      case 'dd/mm/yyyy': return `${day}/${month}/${year}`;
      case 'mm/dd/yyyy': return `${month}/${day}/${year}`;
      case 'dd-mm-yyyy': return `${day}-${month}-${year}`;
      case 'mm-dd-yyyy': return `${month}-${day}-${year}`;
      case 'yyyy-mm-dd':
      default: return `${year}-${month}-${day}`;
    }
  }

  /**
   * Fill the separate birthdate fields.
   * @param birthDate The birthdate to fill the form with.
   */
  private fillSeparateBirthdateFields(birthDate: Date): void {
    this.fillDayField(birthDate);
    this.fillMonthField(birthDate);
    this.fillYearField(birthDate);
  }

  /**
   * Fill the day field.
   * @param birthDate The birthdate to fill the form with.
   */
  private fillDayField(birthDate: Date): void {
    if (!this.form.birthdateField.day) {
      return;
    }

    const dayElement = this.form.birthdateField.day as HTMLSelectElement | HTMLInputElement;
    const dayValue = birthDate.getDate().toString().padStart(2, '0');

    if ('options' in dayElement && dayElement.options) {
      const dayOption = Array.from(dayElement.options).find(opt =>
        opt.value === dayValue ||
        opt.value === birthDate.getDate().toString() ||
        opt.text === dayValue ||
        opt.text === birthDate.getDate().toString()
      );
      if (dayOption) {
        dayElement.value = dayOption.value;
      }
    } else {
      dayElement.value = dayValue;
    }
    this.triggerInputEvents(dayElement);
  }

  /**
   * Fill the month field.
   * @param birthDate The birthdate to fill the form with.
   */
  private fillMonthField(birthDate: Date): void {
    if (!this.form.birthdateField.month) {
      return;
    }

    const monthElement = this.form.birthdateField.month as HTMLSelectElement | HTMLInputElement;
    const monthValue = (birthDate.getMonth() + 1).toString().padStart(2, '0');

    if ('options' in monthElement && monthElement.options) {
      CombinedDateOptionPatterns.months.forEach(monthNames => {
        const monthOption = Array.from(monthElement.options).find(opt =>
          opt.value === monthValue ||
          opt.value === (birthDate.getMonth() + 1).toString() ||
          opt.text === monthValue ||
          opt.text === (birthDate.getMonth() + 1).toString() ||
          opt.text.toLowerCase() === monthNames[birthDate.getMonth()].toLowerCase() ||
          opt.text.toLowerCase() === monthNames[birthDate.getMonth()].substring(0, 3).toLowerCase()
        );
        if (monthOption) {
          monthElement.value = monthOption.value;
        }
      });
    } else {
      monthElement.value = monthValue;
    }
    this.triggerInputEvents(monthElement);
  }

  /**
   * Fill the year field.
   * @param birthDate The birthdate to fill the form with.
   */
  private fillYearField(birthDate: Date): void {
    if (!this.form.birthdateField.year) {
      return;
    }

    const yearElement = this.form.birthdateField.year as HTMLSelectElement | HTMLInputElement;
    const yearValue = birthDate.getFullYear().toString();

    if ('options' in yearElement && yearElement.options) {
      const yearOption = Array.from(yearElement.options).find(opt =>
        opt.value === yearValue ||
        opt.text === yearValue
      );
      if (yearOption) {
        yearElement.value = yearOption.value;
      }
    } else {
      yearElement.value = yearValue;
    }
    this.triggerInputEvents(yearElement);
  }

  /**
   * Fill the gender fields of the form.
   * @param credential The credential to fill the form with.
   */
  private fillGenderFields(credential: Credential): void {
    switch (this.form.genderField.type) {
      case 'select':
        this.fillGenderSelect(credential.Alias.Gender as Gender | undefined);
        break;
      case 'radio':
        this.fillGenderRadio(credential.Alias.Gender as Gender | undefined);
        break;
      case 'text':
        this.fillGenderText(credential.Alias.Gender as Gender | undefined);
        break;
    }
  }

  /**
   * Fill the gender select field.
   * @param gender The gender to fill the form with.
   */
  private fillGenderSelect(gender: Gender | undefined): void {
    if (!this.form.genderField.field || !gender) {
      return;
    }

    const selectElement = this.form.genderField.field as HTMLSelectElement;
    const options = Array.from(selectElement.options);
    const genderValues = gender === Gender.Male
      ? CombinedGenderOptionPatterns.male
      : CombinedGenderOptionPatterns.female;

    const genderOption = options.find(opt =>
      genderValues.includes(opt.value.toLowerCase()) ||
      genderValues.includes(opt.text.toLowerCase())
    );

    if (genderOption) {
      selectElement.value = genderOption.value;
      this.triggerInputEvents(selectElement);
    }
  }

  /**
   * Fill the gender radio fields.
   * @param gender The gender to fill the form with.
   */
  private fillGenderRadio(gender: Gender | undefined): void {
    const radioButtons = this.form.genderField.radioButtons;
    if (!radioButtons || !gender) {
      return;
    }

    let selectedRadio: HTMLInputElement | null = null;

    if (gender === Gender.Male && radioButtons.male) {
      radioButtons.male.checked = true;
      selectedRadio = radioButtons.male;
    } else if (gender === Gender.Female && radioButtons.female) {
      radioButtons.female.checked = true;
      selectedRadio = radioButtons.female;
    } else if (gender === Gender.Other && radioButtons.other) {
      radioButtons.other.checked = true;
      selectedRadio = radioButtons.other;
    }

    if (selectedRadio) {
      this.triggerInputEvents(selectedRadio);
    }
  }

  /**
   * Fill the gender text field.
   * @param gender The gender to fill the form with.
   */
  private fillGenderText(gender: Gender | undefined): void {
    if (!this.form.genderField.field || !gender) {
      return;
    }

    const inputElement = this.form.genderField.field as HTMLInputElement;
    inputElement.value = gender;
    this.triggerInputEvents(inputElement);
  }
}