TotpSecret class definition

Author: jamespb97

packages/auth/lib/index.d.ts

@@ -275,6 +275,52 @@ export namespace FirebaseAuthTypes {
     assertion(credential: AuthCredential): MultiFactorAssertion;
   }
 
+  /**
+   * Provider for generating a {@link TotpMultiFactorAssertion}.
+   *
+   * Stores the shared secret key and other parameters to generate time-based OTPs.
+   * Implements methods to retrieve the shared secret key and generate a QR code URL.
+   * @public
+   */
+  export declare class TotpSecret {
+    private readonly sessionInfo;
+    private readonly auth;
+    /**
+     * Shared secret key/seed used for enrolling in TOTP MFA and generating OTPs.
+     */
+    readonly secretKey: string;
+    /**
+     * Hashing algorithm used.
+     */
+    readonly hashingAlgorithm: string;
+    /**
+     * Length of the one-time passwords to be generated.
+     */
+    readonly codeLength: number;
+    /**
+     * The interval (in seconds) when the OTP codes should change.
+     */
+    readonly codeIntervalSeconds: number;
+    /**
+     * The timestamp (UTC string) by which TOTP enrollment should be completed.
+     */
+    readonly enrollmentCompletionDeadline: string;
+    private constructor();
+    /* Excluded from this release type: _fromStartTotpMfaEnrollmentResponse */
+    /* Excluded from this release type: _makeTotpVerificationInfo */
+    /**
+     * Returns a QR code URL as described in
+     * https://github.com/google/google-authenticator/wiki/Key-Uri-Format
+     * This can be displayed to the user as a QR code to be scanned into a TOTP app like Google Authenticator.
+     * If the optional parameters are unspecified, an accountName of <userEmail> and issuer of <firebaseAppName> are used.
+     *
+     * @param accountName the name of the account/app along with a user identifier.
+     * @param issuer issuer of the TOTP (likely the app name).
+     * @returns A QR code URL string.
+     */
+    generateQrCodeUrl(accountName?: string, issuer?: string): string;
+  }
+
   export interface TotpMultiFactorGenerator {
     FACTOR_ID: FactorId.TOTP;