@temboplus/afloat 0.1.2 → 0.1.3

package/esm/src/features/auth/manager.js

@@ -1,80 +1,147 @@
-import { create, useStore, } from "zustand";
-import { createJSONStorage, persist } from "zustand/middleware";
+import * as dntShim from "../../../_dnt.shims.js";
 import { AuthRepository } from "./repository.js";
-import { User } from "../../models/index.js";
-const AUTH_STORE_SESSION_STORAGE_KEY = "auth-store";
+import { createClientStore, useClientUser, } from "./storage/client_store.js";
+import { ClientTokenHandler } from "./storage/client_token_handler.js";
+import { ServerStore } from "./storage/server_store.js";
+import { ServerTokenHandler } from "./storage/server_token_handler.js";
 /**
- * Singleton class responsible for user authentication and session management.
+ * Main authentication class that works in both client and server environments.
+ * Provides authentication functionality and user management.
  */
 export class AfloatAuth {
     /**
      * Private constructor to prevent direct instantiation.
+     * @param {AuthStore} store - The auth store implementation to use
+     * @param {TokenHandler} tokenHandler - The token handler implementation to use
      */
-    constructor() { }
+    constructor(store, tokenHandler) {
+        /** The auth store implementation */
+        Object.defineProperty(this, "store", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** The token handler implementation */
+        Object.defineProperty(this, "tokenHandler", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.store = store;
+        this.tokenHandler = tokenHandler;
+    }
+    /**
+     * Initializes AfloatAuth for client-side use.
+     * This should be called once at application startup in client environments.
+     * @returns {AfloatAuth} The singleton instance configured for client-side
+     */
+    static initializeClient() {
+        if (!this._instance) {
+            this._instance = new AfloatAuth(createClientStore(), ClientTokenHandler.instance);
+        }
+        return this._instance;
+    }
+    /**
+     * Creates a new instance of AfloatAuth configured for server-side use.
+     * Initializes the user by fetching necessary data using the provided token.
+     * @param {string} token - Authentication token
+     * @returns {Promise<AfloatAuth>} A new instance configured for server-side
+     * @throws {Error} If token is invalid or required data cannot be fetched
+     */
+    static async initializeServer(token) {
+        if (!token) {
+            throw new Error("Token is required for server initialization");
+        }
+        const tokenHandler = new ServerTokenHandler(token);
+        const store = new ServerStore();
+        try {
+            // Fetch and construct user data
+            const user = await tokenHandler.constructUser();
+            store.setUser(user);
+            // Create and initialize auth instance
+            return new AfloatAuth(store, tokenHandler);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to initialize server auth: ${error.message}`);
+            }
+            throw new Error("Failed to initialize server auth");
+        }
+    }
     /**
      * Gets the singleton instance of AfloatAuth.
-     * @returns {AfloatAuth} The singleton instance.
+     * @throws {Error} If AfloatAuth hasn't been initialized
+     * @returns {AfloatAuth} The singleton instance
      */
     static get instance() {
-        return this._instance || (this._instance = new this());
+        if (!this._instance) {
+            throw new Error("AfloatAuth not initialized. Call initializeClient() or initializeServer() first");
+        }
+        return this._instance;
     }
     /**
-     * Fetches the authentication repository.
+     * Gets the authentication repository instance.
      * @private
-     * @returns {AuthRepository} The repository instance for authentication-related API calls.
+     * @returns {AuthRepository} The repository for auth operations
      */
     get repo() {
         return new AuthRepository();
     }
     /**
-     * Retrieves the current user's authentication token.
-     * @returns {string | undefined} The token of the currently authenticated user.
+     * Gets the current authentication token.
+     * @returns {string | undefined} The current token or undefined if not authenticated
      */
     getUserToken() {
-        return this.currentUser?.token;
+        return this.tokenHandler.getUserToken();
     }
     /**
-     * Gets the currently logged-in user.
-     * @returns {User | undefined} The current user object, or `undefined` if no user is logged in.
+     * Gets the currently authenticated user.
+     * @returns {User | undefined} The current user or undefined if not authenticated
      */
     get currentUser() {
-        return store.getState().getUser();
+        return this.store.getUser();
     }
     /**
-     * React hook that retrieves the currently authenticated user from the global store.
-     *
-     * @returns {User | undefined} The current user object if authenticated, or `undefined` if no user is logged in.
+     * React hook for accessing the current user in client-side code.
+     * @throws {Error} If called in a server environment
+     * @returns {User | undefined} The current user or undefined if not authenticated
      */
     useCurrentUser() {
-        return useStore(store).getUser();
+        if (typeof dntShim.dntGlobalThis === "undefined") {
+            throw new Error("useCurrentUser can only be called in browser environment");
+        }
+        return useClientUser();
     }
     /**
-     * Checks if the current user has the specified permission.
-     * @param {Permission} perm - The permission to check.
-     * @returns {boolean} `true` if the user has the permission, otherwise `false`.
+     * Checks if the current user has a specific permission.
+     * @param {Permission} perm - The permission to check
+     * @returns {boolean} True if the user has the permission, false otherwise
      */
     checkPermission(perm) {
         return this.currentUser?.can(perm) ?? false;
     }
     /**
-     * Logs in a user with the provided email and password.
-     * @param {string} email - The user's email address.
-     * @param {string} password - The user's password.
-     * @returns {Promise<User>} A promise that resolves to the authenticated user.
-     * @throws Will throw an error if authentication fails.
+     * Authenticates a user with email and password.
+     * @param {string} email - The user's email
+     * @param {string} password - The user's password
+     * @returns {Promise<User>} Promise resolving to the authenticated user
+     * @throws Will throw an error if authentication fails
      */
     async logIn(email, password) {
         const user = await this.repo.logIn(email, password);
         this.clearSavedData();
-        store.getState().setUser(user);
+        this.store.setUser(user);
+        this.tokenHandler.setUserToken(user.token);
         return user;
     }
     /**
-     * Resets the user's password.
-     * @param {string} current - The current password.
-     * @param {string} updated - The new password.
-     * @returns {Promise<boolean>} A promise that resolves to `true` if the operation is successful.
-     * @throws Will throw an error if the reset fails.
+     * Updates the user's password.
+     * @param {string} current - The current password
+     * @param {string} updated - The new password
+     * @returns {Promise<boolean>} Promise resolving to true if successful
+     * @throws Will throw an error if the password update fails
      */
     async resetPassword(current, updated) {
         await this.repo.updatePassword(current, updated);
@@ -82,37 +149,17 @@ export class AfloatAuth {
         return true;
     }
     /**
-     * Logs out the current user and clears session data.
+     * Logs out the current user.
      */
     logOut() {
         this.clearSavedData();
     }
     /**
-     * Clears saved authentication data from the store and session storage.
+     * Clears all authentication data.
      * @private
      */
     clearSavedData() {
-        store.getState().refresh();
-        sessionStorage.removeItem(AUTH_STORE_SESSION_STORAGE_KEY);
+        this.store.refresh();
+        this.tokenHandler.clearToken();
     }
 }
-const initialState = { user: undefined };
-const store = create(persist((set, get) => ({
-    ...initialState,
-    getUser: () => {
-        try {
-            const jsonUser = get().user;
-            if (jsonUser)
-                return User.fromJSON(jsonUser);
-        }
-        catch (_) {
-            console.log(_);
-        }
-        return undefined;
-    },
-    setUser: (user) => set({ user: user.toJSON() }),
-    refresh: () => set(initialState),
-}), {
-    name: AUTH_STORE_SESSION_STORAGE_KEY,
-    storage: createJSONStorage(() => sessionStorage),
-}));

package/esm/src/features/auth/profile/contract.d.ts

@@ -0,0 +1,45 @@
+import { z } from "zod";
+/**
+ * Profile API contract
+ */
+export declare const profileContract: {
+    getCurrentProfile: {
+        method: "GET";
+        path: "/me";
+        headers: z.ZodObject<{
+            token: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            token: string;
+        }, {
+            token: string;
+        }>;
+        responses: {
+            200: z.ZodObject<{
+                id: z.ZodString;
+                firstName: z.ZodString;
+                lastName: z.ZodString;
+                displayName: z.ZodString;
+                phone: z.ZodString;
+                accountNo: z.ZodString;
+                email: z.ZodString;
+            }, z.UnknownKeysParam, z.ZodTypeAny, {
+                id: string;
+                firstName: string;
+                lastName: string;
+                displayName: string;
+                phone: string;
+                accountNo: string;
+                email: string;
+            }, {
+                id: string;
+                firstName: string;
+                lastName: string;
+                displayName: string;
+                phone: string;
+                accountNo: string;
+                email: string;
+            }>;
+        };
+    };
+};
+//# sourceMappingURL=contract.d.ts.map

package/esm/src/features/auth/profile/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../../../src/src/features/auth/profile/contract.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAS1B,CAAC"}

package/esm/src/features/auth/profile/contract.js

@@ -0,0 +1,16 @@
+import { initContract } from "@ts-rest/core";
+import { profileSchema } from "../../../models/index.js";
+import { z } from "zod";
+/**
+ * Profile API contract
+ */
+export const profileContract = initContract().router({
+    getCurrentProfile: {
+        method: "GET",
+        path: "/me",
+        headers: z.object({ token: z.string() }),
+        responses: {
+            200: profileSchema,
+        },
+    },
+});

package/esm/src/features/auth/profile/repository.d.ts

@@ -0,0 +1,11 @@
+import type { Profile } from "../../../models/index.js";
+import { BaseRepository } from "../../../shared/base_repository.js";
+import { profileContract } from "./contract.js";
+export declare class ProfileRepository extends BaseRepository<typeof profileContract> {
+    /**
+     * Initializes an instance of ProfileRepository.
+     */
+    constructor();
+    getCurrentProfile(token: string): Promise<Profile>;
+}
+//# sourceMappingURL=repository.d.ts.map

package/esm/src/features/auth/profile/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../../src/src/features/auth/profile/repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,OAAO,eAAe,CAAC;IAC3E;;OAEG;;IAKG,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAUzD"}

package/esm/src/features/auth/profile/repository.js

@@ -0,0 +1,21 @@
+import { BaseRepository } from "../../../shared/base_repository.js";
+import { APIError } from "../../../errors/api_error.js";
+import { profileContract } from "./contract.js";
+export class ProfileRepository extends BaseRepository {
+    /**
+     * Initializes an instance of ProfileRepository.
+     */
+    constructor() {
+        super("profile", profileContract);
+    }
+    async getCurrentProfile(token) {
+        const headers = { token };
+        const result = await this.client.getCurrentProfile({ headers });
+        if (result.status === 200)
+            return result.body;
+        throw new APIError({
+            message: "An error occurred while trying to get the current profile",
+            statusCode: 502,
+        });
+    }
+}

package/esm/src/features/auth/repository.d.ts

@@ -26,5 +26,6 @@ export declare class AuthRepository extends BaseRepository<typeof authContract>
      * @throws {APIError} If the current password is invalid or another error occurs during the update process.
      */
     updatePassword(currentPassword: string, newPassword: string): Promise<boolean>;
+    getAccessList(token: string): Promise<string[]>;
 }
 //# sourceMappingURL=repository.d.ts.map

package/esm/src/features/auth/repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../src/src/features/auth/repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAoB,MAAM,eAAe,CAAC;AAO/D;;;GAGG;AACH,qBAAa,cAAe,SAAQ,cAAc,CAAC,OAAO,YAAY,CAAC;IACrE;;OAEG;;IAKH;;;;;;OAMG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB3D;;;;;;OAMG;IACG,cAAc,CAClB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC;CAiBpB"}
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../src/src/features/auth/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI7C;;;GAGG;AACH,qBAAa,cAAe,SAAQ,cAAc,CAAC,OAAO,YAAY,CAAC;IACrE;;OAEG;;IAKH;;;;;;OAMG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB3D;;;;;;OAMG;IACG,cAAc,CAClB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC;IAkBb,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAStD"}

package/esm/src/features/auth/repository.js

@@ -1,7 +1,8 @@
 import { User } from "../../models/index.js";
 import { BaseRepository } from "../../shared/base_repository.js";
-import { authContract, identityContract } from "./contract.js";
+import { authContract } from "./contract.js";
 import { APIError } from "../../errors/api_error.js";
+import { LoginRepository } from "./identity/repository.js";
 /**
  * Class representing the AuthRepository.
  * Provides methods to handle authentication-related operations, such as login and password updates.
@@ -64,30 +65,12 @@ export class AuthRepository extends BaseRepository {
             statusCode: 502,
         });
     }
-}
-/**
- * Class representing the LoginRepository.
- * Provides methods to retrieve user identity-related information.
- */
-class LoginRepository extends BaseRepository {
-    /**
-     * Initializes an instance of LoginRepository.
-     */
-    constructor() {
-        super("login", identityContract);
-    }
-    /**
-     * Retrieves the user's login credentials.
-     * @returns A promise that resolves to the user's login credentials on success.
-     * @throws {APIError} If an error occurs while retrieving the credentials.
-     */
-    async getIdentity(token) {
-        const headers = { token };
-        const result = await this.client.getUserCredentials({ headers });
+    async getAccessList(token) {
+        const result = await this.client.access({ headers: { token: token } });
         if (result.status === 200)
             return result.body;
         throw new APIError({
-            message: "An error occurred while trying to get login credentials",
+            message: "An error occurred while trying to get access list",
             statusCode: 502,
         });
     }

package/esm/src/features/auth/storage/client_store.d.ts

@@ -0,0 +1,30 @@
+import { User } from "../../../models/user/index.js";
+import { type StoreApi, type UseBoundStore } from "zustand";
+import type { AuthStore } from "./types.js";
+/** Type definition for the store's state */
+type State = {
+    user: string | undefined;
+};
+/** Type definition for the store's actions */
+interface Actions {
+    setUser: (user: User) => void;
+    getUser: () => User | undefined;
+    refresh: () => void;
+}
+/**
+ * Creates and exports the Zustand store directly for reactive hooks
+ * @internal This should only be used by AfloatAuth
+ */
+export declare const clientStore: UseBoundStore<StoreApi<State & Actions>>;
+/**
+ * Creates a client-side authentication store using Zustand.
+ * @returns {AuthStore} An implementation of AuthStore for client-side use
+ */
+export declare const createClientStore: () => AuthStore;
+/**
+ * React hook to access the current user with reactive updates.
+ * @returns {User | undefined} The current user or undefined if not authenticated
+ */
+export declare const useClientUser: () => User | undefined;
+export {};
+//# sourceMappingURL=client_store.d.ts.map

package/esm/src/features/auth/storage/client_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client_store.d.ts","sourceRoot":"","sources":["../../../../../src/src/features/auth/storage/client_store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AACrD,OAAO,EAAU,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK5C,4CAA4C;AAC5C,KAAK,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE1C,8CAA8C;AAC9C,UAAU,OAAO;IACf,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,IAAI,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,QAAQ,CAAC,KAAK,GAAG,OAAO,CAAC,CA2BhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAO,SAMpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAO,IAAI,GAAG,SAEvC,CAAC"}

package/esm/src/features/auth/storage/client_store.js

@@ -0,0 +1,46 @@
+import { User } from "../../../models/user/index.js";
+import { create } from "zustand";
+import { createJSONStorage, persist } from "zustand/middleware";
+/** Key used for storing auth data in session storage */
+const AUTH_STORE_SESSION_STORAGE_KEY = "auth-store";
+/**
+ * Creates and exports the Zustand store directly for reactive hooks
+ * @internal This should only be used by AfloatAuth
+ */
+export const clientStore = create(persist((set, get) => ({
+    user: undefined,
+    getUser: () => {
+        try {
+            const jsonUser = get().user;
+            if (jsonUser)
+                return User.fromJSON(jsonUser);
+        }
+        catch (_) {
+            console.log(_);
+        }
+        return undefined;
+    },
+    setUser: (user) => set({ user: user.toJSON() }),
+    refresh: () => set({ user: undefined }),
+}), {
+    name: AUTH_STORE_SESSION_STORAGE_KEY,
+    storage: createJSONStorage(() => sessionStorage),
+}));
+/**
+ * Creates a client-side authentication store using Zustand.
+ * @returns {AuthStore} An implementation of AuthStore for client-side use
+ */
+export const createClientStore = () => {
+    return {
+        getUser: () => clientStore.getState().getUser(),
+        setUser: (user) => clientStore.getState().setUser(user),
+        refresh: () => clientStore.getState().refresh(),
+    };
+};
+/**
+ * React hook to access the current user with reactive updates.
+ * @returns {User | undefined} The current user or undefined if not authenticated
+ */
+export const useClientUser = () => {
+    return clientStore((state) => state.getUser());
+};

package/esm/src/features/auth/storage/client_token_handler.d.ts

@@ -0,0 +1,32 @@
+import type { TokenHandler } from "./types.js";
+/**
+ * Client-side implementation of TokenHandler.
+ * Manages tokens using sessionStorage.
+ * @implements {TokenHandler}
+ */
+export declare class ClientTokenHandler implements TokenHandler {
+    /** Singleton instance */
+    private static _instance;
+    /** Private constructor to enforce singleton pattern */
+    private constructor();
+    /**
+     * Gets the singleton instance of ClientTokenHandler.
+     * @returns {ClientTokenHandler} The singleton instance
+     */
+    static get instance(): ClientTokenHandler;
+    /**
+     * Retrieves the token from sessionStorage.
+     * @returns {string | undefined} The stored token or undefined if not present
+     */
+    getUserToken(): string | undefined;
+    /**
+     * Stores the token in sessionStorage.
+     * @param {string} token - The token to store
+     */
+    setUserToken(token: string): void;
+    /**
+     * Removes the token from sessionStorage.
+     */
+    clearToken(): void;
+}
+//# sourceMappingURL=client_token_handler.d.ts.map

package/esm/src/features/auth/storage/client_token_handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client_token_handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/features/auth/storage/client_token_handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,yBAAyB;IACzB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAqB;IAE7C,uDAAuD;IACvD,OAAO;IAEP;;;OAGG;IACH,MAAM,KAAK,QAAQ,IAAI,kBAAkB,CAExC;IAED;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/esm/src/features/auth/storage/client_token_handler.js

@@ -0,0 +1,36 @@
+/**
+ * Client-side implementation of TokenHandler.
+ * Manages tokens using sessionStorage.
+ * @implements {TokenHandler}
+ */
+export class ClientTokenHandler {
+    /** Private constructor to enforce singleton pattern */
+    constructor() { }
+    /**
+     * Gets the singleton instance of ClientTokenHandler.
+     * @returns {ClientTokenHandler} The singleton instance
+     */
+    static get instance() {
+        return this._instance || (this._instance = new this());
+    }
+    /**
+     * Retrieves the token from sessionStorage.
+     * @returns {string | undefined} The stored token or undefined if not present
+     */
+    getUserToken() {
+        return sessionStorage.getItem("auth_token") || undefined;
+    }
+    /**
+     * Stores the token in sessionStorage.
+     * @param {string} token - The token to store
+     */
+    setUserToken(token) {
+        sessionStorage.setItem("auth_token", token);
+    }
+    /**
+     * Removes the token from sessionStorage.
+     */
+    clearToken() {
+        sessionStorage.removeItem("auth_token");
+    }
+}

package/esm/src/features/auth/storage/server_store.d.ts

@@ -0,0 +1,24 @@
+import type { User } from "../../../models/user/index.js";
+import type { AuthStore } from "./types.js";
+/**
+ * Server-side implementation of AuthStore.
+ * Maintains user state in memory for the duration of a request.
+ */
+export declare class ServerStore implements AuthStore {
+    private user?;
+    /**
+     * Retrieves the current user from memory.
+     * @returns {User | undefined} The current user or undefined if not set
+     */
+    getUser(): User | undefined;
+    /**
+     * Sets the current user in memory.
+     * @param {User} user - The user to store
+     */
+    setUser(user: User): void;
+    /**
+     * Clears the stored user from memory.
+     */
+    refresh(): void;
+}
+//# sourceMappingURL=server_store.d.ts.map

package/esm/src/features/auth/storage/server_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server_store.d.ts","sourceRoot":"","sources":["../../../../../src/src/features/auth/storage/server_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;GAGG;AACH,qBAAa,WAAY,YAAW,SAAS;IAC3C,OAAO,CAAC,IAAI,CAAC,CAAO;IAEpB;;;OAGG;IACH,OAAO,IAAI,IAAI,GAAG,SAAS;IAI3B;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAIzB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/esm/src/features/auth/storage/server_store.js

@@ -0,0 +1,34 @@
+/**
+ * Server-side implementation of AuthStore.
+ * Maintains user state in memory for the duration of a request.
+ */
+export class ServerStore {
+    constructor() {
+        Object.defineProperty(this, "user", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+    }
+    /**
+     * Retrieves the current user from memory.
+     * @returns {User | undefined} The current user or undefined if not set
+     */
+    getUser() {
+        return this.user;
+    }
+    /**
+     * Sets the current user in memory.
+     * @param {User} user - The user to store
+     */
+    setUser(user) {
+        this.user = user;
+    }
+    /**
+     * Clears the stored user from memory.
+     */
+    refresh() {
+        this.user = undefined;
+    }
+}

package/esm/src/features/auth/storage/server_token_handler.d.ts

@@ -0,0 +1,35 @@
+import type { TokenHandler } from "./types.js";
+import { User } from "../../../models/index.js";
+/**
+ * Server-side implementation of TokenHandler.
+ * Manages tokens in memory for the duration of a request.
+ * @implements {TokenHandler}
+ */
+export declare class ServerTokenHandler implements TokenHandler {
+    private token?;
+    /**
+     * Creates a new instance of ServerTokenHandler.
+     * @param {string} [token] - Optional initial token value
+     */
+    constructor(token?: string | undefined);
+    /**
+     * Returns the stored token.
+     * @returns {string | undefined} The current token or undefined if not set
+     */
+    getUserToken(): string | undefined;
+    /**
+     * Stores the provided token in memory.
+     * @param {string} token - The token to store
+     */
+    setUserToken(token: string): void;
+    /**
+     * Clears the stored token from memory.
+     */
+    clearToken(): void;
+    /**
+     * Fetches and constructs the full user data
+     * @returns {Promise<User>}
+     */
+    constructUser(): Promise<User>;
+}
+//# sourceMappingURL=server_token_handler.d.ts.map

package/esm/src/features/auth/storage/server_token_handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server_token_handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/features/auth/storage/server_token_handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAKhD;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IAKzC,OAAO,CAAC,KAAK,CAAC;IAJ1B;;;OAGG;gBACiB,KAAK,CAAC,EAAE,MAAM,YAAA;IAElC;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAyBrC"}