@donotdev/firebase 0.0.1

package/dist/client/sdk.d.ts

@@ -0,0 +1,968 @@
+import * as firebaseAuth from 'firebase/auth';
+import { GoogleAuthProvider, GithubAuthProvider, FacebookAuthProvider, TwitterAuthProvider, EmailAuthProvider, PhoneAuthProvider } from 'firebase/auth';
+import type { FirebaseApp } from 'firebase/app';
+import type { User, UserCredential, AuthProvider, OAuthProvider, RecaptchaVerifier, Unsubscribe, ActionCodeSettings, AuthCredential, MultiFactorResolver, MultiFactorUser, AdditionalUserInfo, Persistence } from 'firebase/auth';
+export type { User as FirebaseUser, UserInfo, OAuthCredential, AuthCredential, } from 'firebase/auth';
+export { GoogleAuthProvider, GithubAuthProvider, FacebookAuthProvider, TwitterAuthProvider, OAuthProvider, EmailAuthProvider, } from 'firebase/auth';
+/**
+ * Firebase SDK Singleton Wrapper
+ *
+ * Manages Firebase initialization and provides type-safe wrappers around
+ * all Firebase Auth methods. Handles auth instance management internally
+ * so consumers never need to pass or manage the auth instance.
+ *
+ * **Key Responsibilities:**
+ * - Initialize Firebase app and auth once
+ * - Store auth instance for internal reuse
+ * - Handle emulator connections in development
+ * - Provide clean, typed interface to Firebase Auth
+ * - Isolate Firebase API changes from business logic
+ *
+ * **NOT Responsible For:**
+ * - Error conversion (handled by FirebaseAuth)
+ * - Business logic (handled by FirebaseAuth)
+ * - State management (handled by AuthService)
+ *
+ * @class FirebaseSDK
+ * @example
+ * ```typescript
+ * const sdk = getFirebaseSDK();
+ * await sdk.initialize();
+ * const result = await sdk.signInWithPopup(provider);
+ * ```
+ */
+declare class FirebaseSDK {
+    /** Tracks initialization state */
+    private initialized;
+    /** Firebase app instance */
+    private app;
+    /** Firebase auth instance - managed internally */
+    private auth;
+    /** Firebase App Check instance - auto-enabled if RECAPTCHA_SITE_KEY is set */
+    private appCheck;
+    /** Tracks if auth emulator has been connected (can only connect once) */
+    private authEmulatorConnected;
+    /**
+     * Initialize Firebase app and auth
+     *
+     * Must be called before any other methods. Safe to call multiple times
+     * as initialization only happens once. Loads configuration from environment
+     * variables and connects to emulator if in development mode.
+     *
+     * @returns Promise that resolves when initialization is complete
+     * @throws Error if Firebase initialization fails
+     *
+     * @example
+     * ```typescript
+     * const sdk = getFirebaseSDK();
+     * await sdk.initialize();
+     * ```
+     */
+    initialize(): Promise<void>;
+    /**
+     * Ensure auth instance is initialized before use
+     *
+     * Internal method called by all public methods to guarantee auth
+     * instance is available. Throws descriptive error if called before
+     * initialization.
+     *
+     * @returns The initialized auth instance
+     * @throws Error if auth not initialized
+     * @private
+     */
+    private ensureInitialized;
+    /**
+     * Initialize App Check if reCAPTCHA site key is configured
+     * Auto-enables abuse protection for all Firebase resources
+     *
+     * Lazy initialization - only called when App Check is actually needed
+     * This defers reCaptcha script loading until Firebase operations require it
+     */
+    private initializeAppCheck;
+    /** Tracks App Check initialization promise to prevent race conditions */
+    private appCheckInitPromise;
+    /**
+     * Ensure App Check is initialized (lazy initialization)
+     * Called before Firebase operations that benefit from App Check protection
+     * Uses promise caching to prevent duplicate initialization
+     */
+    private ensureAppCheckInitialized;
+    /**
+     * Check if App Check is enabled
+     */
+    isAppCheckEnabled(): boolean;
+    /**
+     * Get Firebase app instance
+     *
+     * Ensures Firebase is initialized and returns the app instance.
+     * Safe to call from any consumer - handles initialization order automatically.
+     *
+     * @returns Promise resolving to Firebase app instance
+     * @throws Error if initialization fails
+     *
+     * @example
+     * ```typescript
+     * const sdk = getFirebaseSDK();
+     * const app = await sdk.getApp();
+     * const functions = getFunctions(app, 'europe-west1');
+     * ```
+     */
+    getApp(): Promise<FirebaseApp>;
+    /**
+     * Subscribe to authentication state changes
+     *
+     * Registers a callback that fires when auth state changes (sign in,
+     * sign out, token refresh, etc.). Returns unsubscribe function.
+     *
+     * @param nextOrObserver - Callback function receiving user or null
+     * @returns Unsubscribe function to stop listening
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = sdk.onAuthStateChanged((user) => {
+     *   if (user) {
+     *     console.log('Signed in:', user.uid);
+     *   } else {
+     *     console.log('Signed out');
+     *   }
+     * });
+     * // Later: unsubscribe();
+     * ```
+     */
+    onAuthStateChanged(nextOrObserver: (user: User | null) => void): Unsubscribe;
+    /**
+     * Register callback before authentication state changes
+     *
+     * Similar to onAuthStateChanged but fires before state change completes.
+     * Useful for performing actions before user data is available.
+     *
+     * @param nextOrObserver - Callback function receiving user or null
+     * @returns Unsubscribe function to stop listening
+     */
+    beforeAuthStateChanged(nextOrObserver: (user: User | null) => void): Unsubscribe;
+    /**
+     * Get current authenticated user
+     *
+     * Synchronously returns current user or null if signed out.
+     * Does not wait for auth state to initialize.
+     *
+     * @returns Current user or null if not authenticated
+     *
+     * @example
+     * ```typescript
+     * const user = sdk.getCurrentUser();
+     * if (user) {
+     *   console.log('Current user:', user.email);
+     * }
+     * ```
+     */
+    getCurrentUser(): User | null;
+    /**
+     * Get result of a redirect-based sign-in operation
+     *
+     * Call this after user returns from OAuth redirect. Returns null if
+     * no redirect operation was performed or if called before redirect completes.
+     *
+     * **React StrictMode Safe:**
+     * Uses module-level cache to prevent double-execution from consuming the result.
+     * Firebase's getRedirectResult() is destructive (one-time read), so we cache
+     * it at module scope to survive component re-mounts.
+     *
+     * @returns Promise resolving to user credential or null
+     * @throws Error if redirect operation failed
+     *
+     * @example
+     * ```typescript
+     * // After OAuth redirect returns user to your app
+     * const result = await sdk.getRedirectResult();
+     * if (result?.user) {
+     *   console.log('Signed in via redirect:', result.user.email);
+     * }
+     * ```
+     */
+    getRedirectResult(): Promise<UserCredential | null>;
+    /**
+     * Sign in using redirect flow
+     *
+     * Redirects user to provider's sign-in page. User leaves your app and
+     * returns after authentication. Use getRedirectResult() to get result.
+     *
+     * @param provider - Authentication provider instance
+     * @returns Promise resolving when redirect is initiated
+     *
+     * @example
+     * ```typescript
+     * const provider = sdk.createGoogleProvider();
+     * await sdk.signInWithRedirect(provider);
+     * // User redirects to Google, then returns to your app
+     * ```
+     */
+    signInWithRedirect(provider: AuthProvider): Promise<void>;
+    /**
+     * Sign in using popup flow
+     *
+     * Opens provider sign-in in popup window. User stays on your app while
+     * authenticating in popup. Returns result when popup closes.
+     *
+     * @param provider - Authentication provider instance
+     * @returns Promise resolving to user credential
+     * @throws Error if popup blocked or authentication fails
+     *
+     * @example
+     * ```typescript
+     * const provider = sdk.createGoogleProvider();
+     * const result = await sdk.signInWithPopup(provider);
+     * console.log('Signed in:', result.user.email);
+     * ```
+     */
+    signInWithPopup(provider: AuthProvider): Promise<UserCredential>;
+    /**
+     * Sign in with email and password
+     *
+     * Authenticates user with email/password credentials.
+     *
+     * @param email - User's email address
+     * @param password - User's password
+     * @returns Promise resolving to user credential
+     * @throws Error if credentials are invalid
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.signInWithEmailAndPassword(
+     *   'user@example.com',
+     *   'password123'
+     * );
+     * ```
+     */
+    signInWithEmailAndPassword(email: string, password: string): Promise<UserCredential>;
+    /**
+     * Create new user account with email and password
+     *
+     * Creates new user account and signs in automatically.
+     *
+     * @param email - New user's email address
+     * @param password - New user's password
+     * @returns Promise resolving to user credential
+     * @throws Error if account creation fails
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.createUserWithEmailAndPassword(
+     *   'newuser@example.com',
+     *   'password123'
+     * );
+     * ```
+     */
+    createUserWithEmailAndPassword(email: string, password: string): Promise<UserCredential>;
+    /**
+     * Send password reset email
+     *
+     * Sends email with link to reset password to specified email address.
+     *
+     * @param email - Email address to send reset link to
+     * @param actionCodeSettings - Optional settings for reset link
+     * @returns Promise resolving when email is sent
+     *
+     * @example
+     * ```typescript
+     * await sdk.sendPasswordResetEmail('user@example.com');
+     * ```
+     */
+    sendPasswordResetEmail(email: string, actionCodeSettings?: ActionCodeSettings): Promise<void>;
+    /**
+     * Confirm password reset with code
+     *
+     * Completes password reset flow using code from reset email.
+     *
+     * @param code - Reset code from email
+     * @param newPassword - New password to set
+     * @returns Promise resolving when password is reset
+     *
+     * @example
+     * ```typescript
+     * await sdk.confirmPasswordReset('code-from-email', 'newpassword');
+     * ```
+     */
+    confirmPasswordReset(code: string, newPassword: string): Promise<void>;
+    /**
+     * Verify password reset code
+     *
+     * Checks if password reset code is valid and returns associated email.
+     *
+     * @param code - Reset code from email
+     * @returns Promise resolving to email associated with code
+     *
+     * @example
+     * ```typescript
+     * const email = await sdk.verifyPasswordResetCode('code-from-email');
+     * console.log('Resetting password for:', email);
+     * ```
+     */
+    verifyPasswordResetCode(code: string): Promise<string>;
+    /**
+     * Sign in with email link
+     *
+     * Completes email link sign-in flow. Call this with email link from email.
+     *
+     * @param email - User's email address
+     * @param emailLink - Optional email link URL (defaults to current URL)
+     * @returns Promise resolving to user credential
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.signInWithEmailLink(
+     *   'user@example.com',
+     *   window.location.href
+     * );
+     * ```
+     */
+    signInWithEmailLink(email: string, emailLink?: string): Promise<UserCredential>;
+    /**
+     * Send sign-in link to email
+     *
+     * Sends email with link that signs user in when clicked.
+     *
+     * @param email - Email address to send link to
+     * @param actionCodeSettings - Settings for sign-in link
+     * @returns Promise resolving when email is sent
+     *
+     * @example
+     * ```typescript
+     * await sdk.sendSignInLinkToEmail('user@example.com', {
+     *   url: 'https://yourapp.com/finishSignIn',
+     *   handleCodeInApp: true
+     * });
+     * ```
+     */
+    sendSignInLinkToEmail(email: string, actionCodeSettings: ActionCodeSettings): Promise<void>;
+    /**
+     * Check if string is valid email sign-in link
+     *
+     * Validates whether a URL is a valid email sign-in link.
+     *
+     * @param emailLink - URL to validate
+     * @returns True if valid email sign-in link
+     *
+     * @example
+     * ```typescript
+     * if (sdk.isSignInWithEmailLink(window.location.href)) {
+     *   // Complete sign-in
+     * }
+     * ```
+     */
+    isSignInWithEmailLink(emailLink: string): boolean;
+    /**
+     * Sign in with custom token
+     *
+     * Signs in using custom token generated by your backend.
+     *
+     * @param token - Custom auth token
+     * @returns Promise resolving to user credential
+     *
+     * @example
+     * ```typescript
+     * const token = await getCustomTokenFromBackend();
+     * const result = await sdk.signInWithCustomToken(token);
+     * ```
+     */
+    signInWithCustomToken(token: string): Promise<UserCredential>;
+    /**
+     * Sign in anonymously
+     *
+     * Creates temporary anonymous user account.
+     *
+     * @returns Promise resolving to user credential
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.signInAnonymously();
+     * console.log('Anonymous user:', result.user.uid);
+     * ```
+     */
+    signInAnonymously(): Promise<UserCredential>;
+    /**
+     * Sign in with credential object
+     *
+     * Signs in using pre-built auth credential.
+     *
+     * @param credential - Auth credential object
+     * @returns Promise resolving to user credential
+     *
+     * @example
+     * ```typescript
+     * const credential = GoogleAuthProvider.credential(idToken);
+     * const result = await sdk.signInWithCredential(credential);
+     * ```
+     */
+    signInWithCredential(credential: AuthCredential): Promise<UserCredential>;
+    /**
+     * Sign in with phone number
+     *
+     * Initiates phone number sign-in flow with reCAPTCHA verification.
+     *
+     * @param phoneNumber - Phone number in E.164 format
+     * @param appVerifier - reCAPTCHA verifier instance
+     * @returns Promise resolving to confirmation result
+     *
+     * @example
+     * ```typescript
+     * const verifier = sdk.createRecaptchaVerifier('recaptcha-container');
+     * const result = await sdk.signInWithPhoneNumber('+1234567890', verifier);
+     * const code = prompt('Enter verification code:');
+     * await result.confirm(code);
+     * ```
+     */
+    signInWithPhoneNumber(phoneNumber: string, appVerifier: RecaptchaVerifier): Promise<firebaseAuth.ConfirmationResult>;
+    /**
+     * Sign out current user
+     *
+     * Signs out currently authenticated user.
+     *
+     * @returns Promise resolving when sign out completes
+     *
+     * @example
+     * ```typescript
+     * await sdk.signOut();
+     * console.log('User signed out');
+     * ```
+     */
+    signOut(): Promise<void>;
+    /**
+     * Send email verification to user
+     *
+     * Sends verification email to user's email address.
+     *
+     * @param user - User to send verification to
+     * @param actionCodeSettings - Optional settings for verification link
+     * @returns Promise resolving when email is sent
+     *
+     * @example
+     * ```typescript
+     * const user = sdk.getCurrentUser();
+     * await sdk.sendEmailVerification(user);
+     * ```
+     */
+    sendEmailVerification(user: User, actionCodeSettings?: ActionCodeSettings): Promise<void>;
+    /**
+     * Update user's password
+     *
+     * Changes password for currently signed-in user.
+     *
+     * @param user - User to update password for
+     * @param newPassword - New password
+     * @returns Promise resolving when password is updated
+     *
+     * @example
+     * ```typescript
+     * const user = sdk.getCurrentUser();
+     * await sdk.updatePassword(user, 'newpassword');
+     * ```
+     */
+    updatePassword(user: User, newPassword: string): Promise<void>;
+    /**
+     * Update user's email address
+     *
+     * Changes email address for currently signed-in user.
+     *
+     * @param user - User to update email for
+     * @param newEmail - New email address
+     * @returns Promise resolving when email is updated
+     */
+    updateEmail(user: User, newEmail: string): Promise<void>;
+    /**
+     * Update user's profile information
+     *
+     * Updates display name and/or photo URL.
+     *
+     * @param user - User to update profile for
+     * @param profile - Profile updates (displayName and/or photoURL)
+     * @returns Promise resolving when profile is updated
+     *
+     * @example
+     * ```typescript
+     * const user = sdk.getCurrentUser();
+     * await sdk.updateProfile(user, {
+     *   displayName: 'John Doe',
+     *   photoURL: 'https://example.com/photo.jpg'
+     * });
+     * ```
+     */
+    updateProfile(user: User, profile: {
+        displayName?: string | null;
+        photoURL?: string | null;
+    }): Promise<void>;
+    /**
+     * Reload user data from server
+     *
+     * Refreshes user's profile data and custom claims.
+     *
+     * @param user - User to reload
+     * @returns Promise resolving when reload completes
+     */
+    reload(user: User): Promise<void>;
+    /**
+     * Delete user account
+     *
+     * Permanently deletes user account. Cannot be undone.
+     *
+     * @param user - User to delete
+     * @returns Promise resolving when account is deleted
+     */
+    deleteUser(user: User): Promise<void>;
+    /**
+     * Get user's ID token
+     *
+     * Gets current ID token, optionally forcing refresh.
+     *
+     * @param user - User to get token for
+     * @param forceRefresh - Force token refresh even if not expired
+     * @returns Promise resolving to ID token string
+     *
+     * @example
+     * ```typescript
+     * const user = sdk.getCurrentUser();
+     * const token = await sdk.getIdToken(user, true);
+     * ```
+     */
+    getIdToken(user: User, forceRefresh?: boolean): Promise<string>;
+    /**
+     * Get user's ID token with claims
+     *
+     * Gets ID token result including custom claims.
+     *
+     * @param user - User to get token result for
+     * @param forceRefresh - Force token refresh
+     * @returns Promise resolving to token result with claims
+     *
+     * @example
+     * ```typescript
+     * const user = sdk.getCurrentUser();
+     * const result = await sdk.getIdTokenResult(user);
+     * console.log('Custom claims:', result.claims);
+     * ```
+     */
+    getIdTokenResult(user: User, forceRefresh?: boolean): Promise<firebaseAuth.IdTokenResult>;
+    /**
+     * Link credential to existing account
+     *
+     * Links additional auth provider to current user's account.
+     *
+     * @param user - User to link credential to
+     * @param credential - Credential to link
+     * @returns Promise resolving to updated user credential
+     *
+     * @example
+     * ```typescript
+     * const credential = GoogleAuthProvider.credential(idToken);
+     * await sdk.linkWithCredential(currentUser, credential);
+     * ```
+     */
+    linkWithCredential(user: User, credential: AuthCredential): Promise<UserCredential>;
+    /**
+     * Link provider using popup
+     *
+     * Links additional provider to account using popup flow.
+     *
+     * @param user - User to link provider to
+     * @param provider - Provider to link
+     * @returns Promise resolving to updated user credential
+     */
+    linkWithPopup(user: User, provider: AuthProvider): Promise<UserCredential>;
+    /**
+     * Link provider using redirect
+     *
+     * Links additional provider to account using redirect flow.
+     *
+     * @param user - User to link provider to
+     * @param provider - Provider to link
+     * @returns Promise resolving when redirect is initiated
+     */
+    linkWithRedirect(user: User, provider: AuthProvider): Promise<void>;
+    /**
+     * Link phone number to account
+     *
+     * Links phone number authentication to existing account.
+     *
+     * @param user - User to link phone to
+     * @param phoneNumber - Phone number in E.164 format
+     * @param appVerifier - reCAPTCHA verifier
+     * @returns Promise resolving to confirmation result
+     */
+    linkWithPhoneNumber(user: User, phoneNumber: string, appVerifier: RecaptchaVerifier): Promise<firebaseAuth.ConfirmationResult>;
+    /**
+     * Unlink provider from account
+     *
+     * Removes linked provider from user's account.
+     *
+     * @param user - User to unlink provider from
+     * @param providerId - Provider ID to unlink
+     * @returns Promise resolving to updated user
+     */
+    unlink(user: User, providerId: string): Promise<User>;
+    /**
+     * Fetch sign-in methods for email
+     *
+     * Gets list of sign-in methods available for given email address.
+     *
+     * @param email - Email address to check
+     * @returns Promise resolving to array of provider IDs
+     *
+     * @example
+     * ```typescript
+     * const methods = await sdk.fetchSignInMethodsForEmail('user@example.com');
+     * console.log('Available methods:', methods); // ['google.com', 'password']
+     * ```
+     */
+    fetchSignInMethodsForEmail(email: string): Promise<string[]>;
+    /**
+     * Re-authenticate with credential
+     *
+     * Re-authenticates user before sensitive operations.
+     *
+     * @param user - User to re-authenticate
+     * @param credential - Credential to re-authenticate with
+     * @returns Promise resolving to user credential
+     */
+    reauthenticateWithCredential(user: User, credential: AuthCredential): Promise<UserCredential>;
+    /**
+     * Re-authenticate using popup
+     *
+     * Re-authenticates user using popup flow.
+     *
+     * @param user - User to re-authenticate
+     * @param provider - Provider to use
+     * @returns Promise resolving to user credential
+     */
+    reauthenticateWithPopup(user: User, provider: AuthProvider): Promise<UserCredential>;
+    /**
+     * Re-authenticate using redirect
+     *
+     * Re-authenticates user using redirect flow.
+     *
+     * @param user - User to re-authenticate
+     * @param provider - Provider to use
+     * @returns Promise resolving when redirect is initiated
+     */
+    reauthenticateWithRedirect(user: User, provider: AuthProvider): Promise<void>;
+    /**
+     * Create Google auth provider
+     *
+     * @returns New Google provider instance
+     *
+     * @example
+     * ```typescript
+     * const provider = sdk.createGoogleProvider();
+     * provider.addScope('https://www.googleapis.com/auth/drive.readonly');
+     * ```
+     */
+    createGoogleProvider(): GoogleAuthProvider;
+    /**
+     * Create GitHub auth provider
+     *
+     * @returns New GitHub provider instance
+     */
+    createGithubProvider(): GithubAuthProvider;
+    /**
+     * Create Facebook auth provider
+     *
+     * @returns New Facebook provider instance
+     */
+    createFacebookProvider(): FacebookAuthProvider;
+    /**
+     * Create Twitter auth provider
+     *
+     * @returns New Twitter provider instance
+     */
+    createTwitterProvider(): TwitterAuthProvider;
+    /**
+     * Create Microsoft auth provider
+     *
+     * @returns New Microsoft OAuth provider instance
+     */
+    createMicrosoftProvider(): OAuthProvider;
+    /**
+     * Create Apple auth provider
+     *
+     * @returns New Apple OAuth provider instance
+     */
+    createAppleProvider(): OAuthProvider;
+    /**
+     * Create generic OAuth provider
+     *
+     * Creates provider for any OAuth-compatible service.
+     *
+     * @param providerId - Provider ID (e.g., 'discord.com')
+     * @returns New OAuth provider instance
+     *
+     * @example
+     * ```typescript
+     * const provider = sdk.createOAuthProvider('discord.com');
+     * provider.addScope('identify');
+     * ```
+     */
+    createOAuthProvider(providerId: string): OAuthProvider;
+    /**
+     * Create phone auth provider
+     *
+     * @returns New phone auth provider instance
+     */
+    createPhoneAuthProvider(): PhoneAuthProvider;
+    /**
+     * Create email auth provider
+     *
+     * @returns New email auth provider instance
+     */
+    createEmailAuthProvider(): typeof EmailAuthProvider;
+    /**
+     * Create reCAPTCHA verifier
+     *
+     * Creates verifier for phone authentication.
+     *
+     * @param container - Container element ID or element reference
+     * @param parameters - Optional reCAPTCHA parameters
+     * @returns New reCAPTCHA verifier instance
+     *
+     * @example
+     * ```typescript
+     * const verifier = sdk.createRecaptchaVerifier('recaptcha-container', {
+     *   size: 'invisible'
+     * });
+     * ```
+     */
+    createRecaptchaVerifier(container: string | HTMLElement, parameters?: firebaseAuth.RecaptchaParameters): RecaptchaVerifier;
+    /**
+     * Get multi-factor interface for user
+     *
+     * @param user - User to get multi-factor for
+     * @returns Multi-factor user interface
+     */
+    multiFactor(user: User): MultiFactorUser;
+    /**
+     * Get multi-factor resolver from error
+     *
+     * Creates resolver for handling multi-factor authentication errors.
+     *
+     * @param error - Multi-factor error from sign-in attempt
+     * @returns Multi-factor resolver instance
+     */
+    getMultiFactorResolver(error: firebaseAuth.MultiFactorError): MultiFactorResolver;
+    /**
+     * Get additional user info from credential
+     *
+     * Extracts additional user information from sign-in result.
+     *
+     * @param result - User credential from sign-in
+     * @returns Additional user info or null
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.signInWithPopup(provider);
+     * const info = sdk.getAdditionalUserInfo(result);
+     * if (info?.isNewUser) {
+     *   console.log('Welcome new user!');
+     * }
+     * ```
+     */
+    getAdditionalUserInfo(result: UserCredential): AdditionalUserInfo | null;
+    /**
+     * Set authentication state persistence
+     *
+     * Controls how auth state persists between sessions.
+     *
+     * @param persistence - Persistence type (local, session, or none)
+     * @returns Promise resolving when persistence is set
+     *
+     * @example
+     * ```typescript
+     * // Persist until browser closes
+     * await sdk.setPersistence(firebaseAuth.browserSessionPersistence);
+     * ```
+     */
+    setPersistence(persistence: Persistence): Promise<void>;
+    /**
+     * Set auth language to device default
+     *
+     * Sets Firebase Auth UI language to user's device language.
+     */
+    useDeviceLanguage(): void;
+    /**
+     * Check action code validity
+     *
+     * Validates action code from email (password reset, email verification, etc.).
+     *
+     * @param code - Action code from email
+     * @returns Promise resolving to action code info
+     */
+    checkActionCode(code: string): Promise<firebaseAuth.ActionCodeInfo>;
+    /**
+     * Apply action code
+     *
+     * Applies action code from email (email verification, password reset, etc.).
+     *
+     * @param code - Action code from email
+     * @returns Promise resolving when code is applied
+     */
+    applyActionCode(code: string): Promise<void>;
+    /**
+     * Sign in with Google using popup
+     *
+     * @returns Promise resolving to user credential
+     */
+    signInWithGoogle(): Promise<UserCredential>;
+    /**
+     * Sign in with Google using redirect
+     *
+     * @returns Promise resolving when redirect is initiated
+     */
+    signInWithGoogleRedirect(): Promise<void>;
+    /**
+     * Sign in with GitHub using popup
+     *
+     * @returns Promise resolving to user credential
+     */
+    signInWithGitHub(): Promise<UserCredential>;
+    /**
+     * Sign in with GitHub using redirect
+     *
+     * @returns Promise resolving when redirect is initiated
+     */
+    signInWithGitHubRedirect(): Promise<void>;
+    /**
+     * Sign in with Facebook using popup
+     *
+     * @returns Promise resolving to user credential
+     */
+    signInWithFacebook(): Promise<UserCredential>;
+    /**
+     * Sign in with Facebook using redirect
+     *
+     * @returns Promise resolving when redirect is initiated
+     */
+    signInWithFacebookRedirect(): Promise<void>;
+    /**
+     * Sign in with Twitter using popup
+     *
+     * @returns Promise resolving to user credential
+     */
+    signInWithTwitter(): Promise<UserCredential>;
+    /**
+     * Sign in with Twitter using redirect
+     *
+     * @returns Promise resolving when redirect is initiated
+     */
+    signInWithTwitterRedirect(): Promise<void>;
+    /**
+     * Sign in with Microsoft using popup
+     *
+     * @returns Promise resolving to user credential
+     */
+    signInWithMicrosoft(): Promise<UserCredential>;
+    /**
+     * Sign in with Microsoft using redirect
+     *
+     * @returns Promise resolving when redirect is initiated
+     */
+    signInWithMicrosoftRedirect(): Promise<void>;
+    /**
+     * Sign in with Apple using popup
+     *
+     * @returns Promise resolving to user credential
+     */
+    signInWithApple(): Promise<UserCredential>;
+    /**
+     * Sign in with Apple using redirect
+     *
+     * @returns Promise resolving when redirect is initiated
+     */
+    signInWithAppleRedirect(): Promise<void>;
+    /**
+     * Sign in with Google credential (for Google One Tap)
+     *
+     * @param credential - Google ID token
+     * @returns Promise resolving to user credential
+     */
+    signInWithGoogleCredential(credential: string): Promise<UserCredential>;
+    /**
+     * Sign in with email and password (high-level)
+     *
+     * @param email - User's email address
+     * @param password - User's password
+     * @returns Promise resolving to user credential
+     */
+    signInWithEmail(email: string, password: string): Promise<UserCredential>;
+    /**
+     * Create user with email and password (high-level)
+     *
+     * @param email - User's email address
+     * @param password - User's password
+     * @returns Promise resolving to user credential
+     */
+    createUserWithEmail(email: string, password: string): Promise<UserCredential>;
+    /**
+     * Link Google account to current user
+     *
+     * @param user - Current user
+     * @returns Promise resolving to updated user credential
+     */
+    linkWithGoogle(user: User): Promise<UserCredential>;
+    /**
+     * Link GitHub account to current user
+     *
+     * @param user - Current user
+     * @returns Promise resolving to updated user credential
+     */
+    linkWithGitHub(user: User): Promise<UserCredential>;
+    /**
+     * Link Facebook account to current user
+     *
+     * @param user - Current user
+     * @returns Promise resolving to updated user credential
+     */
+    linkWithFacebook(user: User): Promise<UserCredential>;
+    /**
+     * Link Twitter account to current user
+     *
+     * @param user - Current user
+     * @returns Promise resolving to updated user credential
+     */
+    linkWithTwitter(user: User): Promise<UserCredential>;
+    /**
+     * Link Microsoft account to current user
+     *
+     * @param user - Current user
+     * @returns Promise resolving to updated user credential
+     */
+    linkWithMicrosoft(user: User): Promise<UserCredential>;
+    /**
+     * Link Apple account to current user
+     *
+     * @param user - Current user
+     * @returns Promise resolving to updated user credential
+     */
+    linkWithApple(user: User): Promise<UserCredential>;
+    /**
+     * Reset SDK state (HMR support)
+     *
+     * Called during hot module replacement to reset singleton state.
+     * Internal method for development only.
+     *
+     * @internal
+     */
+    reset(): void;
+}
+/**
+ * Get singleton instance of Firebase SDK wrapper
+ *
+ * Always returns same instance. Safe to call multiple times.
+ *
+ * @returns Singleton FirebaseSDK instance
+ *
+ * @example
+ * ```typescript
+ * const sdk = getFirebaseSDK();
+ * await sdk.initialize();
+ * const user = sdk.getCurrentUser();
+ * ```
+ */
+export declare const getFirebaseSDK: () => FirebaseSDK;
+//# sourceMappingURL=sdk.d.ts.map