browser/libs/auth/src/angular/login/login-component.service.ts

import { UrlTree } from "@angular/router";

import { MasterPasswordPolicyOptions } from "@bitwarden/common/admin-console/models/domain/master-password-policy-options";
import { Policy } from "@bitwarden/common/admin-console/models/domain/policy";

export interface PasswordPolicies {
  policies: Policy[];
  isPolicyAndAutoEnrollEnabled: boolean;
  enforcedPasswordPolicyOptions: MasterPasswordPolicyOptions;
}

/**
 * The `LoginComponentService` allows the single libs/auth `LoginComponent` to
 * delegate all client-specific functionality to client-specific service
 * implementations of `LoginComponentService`.
 *
 * The `LoginComponentService` should not be confused with the
 * `LoginStrategyService`, which is used to determine the login strategy and
 * performs the core login logic.
 */
export abstract class LoginComponentService {
  /**
   * Gets the organization policies if there is an organization invite.
   * - Used by: Web
   */
  getOrgPolicies: () => Promise<PasswordPolicies | null>;

  /**
   * Sets the previous URL to keep track of in memory.
   * - Used by: Web
   */
  setPreviousUrl: (route: UrlTree) => void | null;

  /**
   * Gets the status of the `showPasswordless` feature flag.
   * - Used by: Web, Browser
   */
  getShowPasswordlessFlag: () => boolean;

  /**
   * Launches the SSO flow in a new browser window.
   * - Used by: Browser, Desktop
   */
  launchSsoBrowserWindow: (email: string, clientId: "browser" | "desktop") => Promise<void>;
}