edmaxlabs-core 2.7.3 → 2.9.4

package/dist/index.d.cts

@@ -34,6 +34,34 @@ declare class Timestamp implements TimestampData {
     toString(): string;
 }
 
+/**
+ * Credentials.ts
+ *
+ * What changed and why:
+ *
+ *  ✗  fromMap() assumed data always lived under map.data.displayInfo
+ *     → The new server response is a flat safeUser object:
+ *       { uid, email, displayName, photoUrl, provider, verified, disabled,
+ *         createdAt, lastLogin }
+ *       fromMap() now detects which shape it's dealing with and handles both,
+ *       so existing persisted sessions (old nested shape in localStorage) still
+ *       deserialise correctly without forcing every user to log in again.
+ *
+ *  ✗  DisplayInfo was built from nested data.displayInfo only
+ *     → Now also built from the flat fields (email, displayName split into
+ *       firstname/lastname, photoUrl → profile) when the nested shape is absent.
+ *
+ *  ✗  uid resolution: map.id ?? map.uid ?? map._id
+ *     → Server now always sends uid. The fallback chain is kept for backwards
+ *       compatibility with any localStorage sessions that still have _id.
+ *
+ *  ✓  toMap() unchanged — still produces the nested shape used by localStorage
+ *     and the authState snapshot listener, so session restore keeps working.
+ *
+ *  +  provider and disabled fields added — the server now returns them and
+ *     they're useful for conditional UI (e.g. show "disabled" badge, show
+ *     provider icon).
+ */
 interface DisplayInfo {
     firstname: string;
     lastname: string;
@@ -47,46 +75,94 @@ declare class Credentials {
     displayInfo: DisplayInfo;
     data: Record<string, any>;
     verified: boolean;
+    disabled: boolean;
+    provider: string;
     createdAt: Timestamp;
     updatedAt: Timestamp;
+    lastLogin: Timestamp | null;
     private constructor();
     static fromMap(map: Record<string, any>): Credentials;
     toMap(): Record<string, any>;
+    get email(): string;
+    get firstname(): string;
+    get lastname(): string;
+    get displayName(): string;
+    get photoUrl(): string;
+}
+
+declare enum HttpMethod {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    DELETE = "DELETE"
 }
 
 type Listener<T = any> = (value: T) => void;
 declare class Authentication {
     static instance: Authentication | null;
-    private eUser?;
-    private client?;
-    private app?;
+    private app;
+    private accessToken;
+    private eUser;
+    private isRefreshing;
+    private refreshQueue;
     private eventListeners;
-    private eventWaiters;
-    private unsubscribers;
     constructor();
-    private isSameCredentials;
-    private restoreSession;
     static getInstance(): Authentication;
-    emitValue<T>(key: string, value: T): void;
-    onValue<T>(key: string, callback: Listener<T>): () => void;
+    private buildProjectHeaders;
+    private buildUserHeaders;
+    /** Exposed so database/RequestHeaders.ts can read current headers */
+    getHeaders(): Record<string, string>;
+    getUserToken(): string;
+    /** Synchronous. Reads only from localStorage — no network call. */
+    private _restoreSession;
+    /**
+     * Persist the user shape and update the in-memory access token.
+     * Pass credentials=null to fully clear the session (sign out).
+     */
+    private _saveSession;
+    /**
+     * Returns the locally cached user — no network call.
+     * Returns null if nobody is signed in.
+     */
     currentUser(): Credentials | null;
-    private saveCredentials;
-    authState({ onChange, onSignOut, onDeleted, }: {
-        onChange: (user: Credentials) => void;
-        onSignOut?: () => void;
-        onDeleted?: () => void;
-    }): () => void;
-    createUserWithEmailAndPassword: ({ email, password, }: {
+    private _refreshAccessToken;
+    private _drainQueue;
+    /**
+     * Central request method — all auth HTTP calls go through here.
+     * Handles the access-token-expired → refresh → retry cycle automatically.
+     */
+    makeRequest(options: {
+        method: HttpMethod;
+        endpoint: string;
+        headers?: Record<string, string>;
+        body?: Record<string, any>;
+        file?: File;
+        isRetry?: boolean;
+        isMultipart?: boolean;
+    }): Promise<any>;
+    createUserWithEmailAndPassword: (data: {
+        firstname: string;
+        lastname?: string;
         email: string;
         password: string;
     }) => Promise<Credentials | null>;
-    signInWithEmailAndPassword: ({ email, password, }: {
+    signInWithEmailAndPassword: ({ email, password }: {
         email: string;
         password: string;
     }) => Promise<Credentials | null>;
-    deleteUser: () => Promise<void>;
-    resetPassword: () => Promise<any>;
     signOut: () => Promise<void>;
+    deleteUser: () => Promise<void>;
+    resetPassword: ({ email }: {
+        email: string;
+    }) => Promise<void>;
+    authState({ onChange, onSignOut, onDeleted, }: {
+        onChange: (user: Credentials | null) => void;
+        onSignOut?: () => void;
+        onDeleted?: () => void;
+    }): () => void;
+    private _emit;
+    onValue<T>(key: string, callback: Listener<T>): () => void;
+    dispose(): void;
 }
 
 declare class DocumentSnapshot {
@@ -381,6 +457,7 @@ declare class RealtimeBridge {
 
 declare class SyncEngine {
     private app;
+    private authentication;
     private persistence;
     private store;
     private realtimeBridge;

package/dist/index.d.ts

@@ -34,6 +34,34 @@ declare class Timestamp implements TimestampData {
     toString(): string;
 }
 
+/**
+ * Credentials.ts
+ *
+ * What changed and why:
+ *
+ *  ✗  fromMap() assumed data always lived under map.data.displayInfo
+ *     → The new server response is a flat safeUser object:
+ *       { uid, email, displayName, photoUrl, provider, verified, disabled,
+ *         createdAt, lastLogin }
+ *       fromMap() now detects which shape it's dealing with and handles both,
+ *       so existing persisted sessions (old nested shape in localStorage) still
+ *       deserialise correctly without forcing every user to log in again.
+ *
+ *  ✗  DisplayInfo was built from nested data.displayInfo only
+ *     → Now also built from the flat fields (email, displayName split into
+ *       firstname/lastname, photoUrl → profile) when the nested shape is absent.
+ *
+ *  ✗  uid resolution: map.id ?? map.uid ?? map._id
+ *     → Server now always sends uid. The fallback chain is kept for backwards
+ *       compatibility with any localStorage sessions that still have _id.
+ *
+ *  ✓  toMap() unchanged — still produces the nested shape used by localStorage
+ *     and the authState snapshot listener, so session restore keeps working.
+ *
+ *  +  provider and disabled fields added — the server now returns them and
+ *     they're useful for conditional UI (e.g. show "disabled" badge, show
+ *     provider icon).
+ */
 interface DisplayInfo {
     firstname: string;
     lastname: string;
@@ -47,46 +75,94 @@ declare class Credentials {
     displayInfo: DisplayInfo;
     data: Record<string, any>;
     verified: boolean;
+    disabled: boolean;
+    provider: string;
     createdAt: Timestamp;
     updatedAt: Timestamp;
+    lastLogin: Timestamp | null;
     private constructor();
     static fromMap(map: Record<string, any>): Credentials;
     toMap(): Record<string, any>;
+    get email(): string;
+    get firstname(): string;
+    get lastname(): string;
+    get displayName(): string;
+    get photoUrl(): string;
+}
+
+declare enum HttpMethod {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    DELETE = "DELETE"
 }
 
 type Listener<T = any> = (value: T) => void;
 declare class Authentication {
     static instance: Authentication | null;
-    private eUser?;
-    private client?;
-    private app?;
+    private app;
+    private accessToken;
+    private eUser;
+    private isRefreshing;
+    private refreshQueue;
     private eventListeners;
-    private eventWaiters;
-    private unsubscribers;
     constructor();
-    private isSameCredentials;
-    private restoreSession;
     static getInstance(): Authentication;
-    emitValue<T>(key: string, value: T): void;
-    onValue<T>(key: string, callback: Listener<T>): () => void;
+    private buildProjectHeaders;
+    private buildUserHeaders;
+    /** Exposed so database/RequestHeaders.ts can read current headers */
+    getHeaders(): Record<string, string>;
+    getUserToken(): string;
+    /** Synchronous. Reads only from localStorage — no network call. */
+    private _restoreSession;
+    /**
+     * Persist the user shape and update the in-memory access token.
+     * Pass credentials=null to fully clear the session (sign out).
+     */
+    private _saveSession;
+    /**
+     * Returns the locally cached user — no network call.
+     * Returns null if nobody is signed in.
+     */
     currentUser(): Credentials | null;
-    private saveCredentials;
-    authState({ onChange, onSignOut, onDeleted, }: {
-        onChange: (user: Credentials) => void;
-        onSignOut?: () => void;
-        onDeleted?: () => void;
-    }): () => void;
-    createUserWithEmailAndPassword: ({ email, password, }: {
+    private _refreshAccessToken;
+    private _drainQueue;
+    /**
+     * Central request method — all auth HTTP calls go through here.
+     * Handles the access-token-expired → refresh → retry cycle automatically.
+     */
+    makeRequest(options: {
+        method: HttpMethod;
+        endpoint: string;
+        headers?: Record<string, string>;
+        body?: Record<string, any>;
+        file?: File;
+        isRetry?: boolean;
+        isMultipart?: boolean;
+    }): Promise<any>;
+    createUserWithEmailAndPassword: (data: {
+        firstname: string;
+        lastname?: string;
         email: string;
         password: string;
     }) => Promise<Credentials | null>;
-    signInWithEmailAndPassword: ({ email, password, }: {
+    signInWithEmailAndPassword: ({ email, password }: {
         email: string;
         password: string;
     }) => Promise<Credentials | null>;
-    deleteUser: () => Promise<void>;
-    resetPassword: () => Promise<any>;
     signOut: () => Promise<void>;
+    deleteUser: () => Promise<void>;
+    resetPassword: ({ email }: {
+        email: string;
+    }) => Promise<void>;
+    authState({ onChange, onSignOut, onDeleted, }: {
+        onChange: (user: Credentials | null) => void;
+        onSignOut?: () => void;
+        onDeleted?: () => void;
+    }): () => void;
+    private _emit;
+    onValue<T>(key: string, callback: Listener<T>): () => void;
+    dispose(): void;
 }
 
 declare class DocumentSnapshot {
@@ -381,6 +457,7 @@ declare class RealtimeBridge {
 
 declare class SyncEngine {
     private app;
+    private authentication;
     private persistence;
     private store;
     private realtimeBridge;