--- title: "Auth Store" slug: "auth-store" updated: 2025-12-08T15:46:26Z published: 2025-12-08T15:46:26Z canonical: "docs.xgen.ai/auth-store" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.xgen.ai/llms.txt > Use this file to discover all available pages before exploring further. # Auth Store The SDK keeps track of the authenticated token and auth model for you via the `xg.authStore` instance. ##### LocalCookieAuthStore (default) The default LocalCookieAuthStore uses the browser's `document.cookie` storage if available, otherwise - will fallback to runtime/memory (aka. on page refresh or service restart you'll have to authenticate again). Default cookie names - `xgen_token` - token value and expiration date - `xgen_user`- user value and expiration date - `xgen_session` - session value and expiration date ### Custom auth store In some situations it could be easier to create your own custom auth store. For this you can extend `BaseAuthStore` and pass the new custom instance as constructor argument to the client: ```javascript import XGenClient, { BaseAuthStore } from '@xgenai/sdk-core'; class CustomAuthStore extends BaseAuthStore {   save({tokenRecord, userRecord, sessionRecord}) {     super.save({tokenRecord, userRecord, sessionRecord});     // your custom business logic...   } } const xg = new XGenClient({    // ...other params    authStore: new CustomAuthStore() }); ``` ### Common auth store fields and methods The default `xg.authStore` extends `BaseAuthStore` and has the following public members that you can use: ```javascript BaseAuthStore {    // base fields    token:       TokenRecord|null // the access_token and expiration    user:        UserRecord|null  // the userId, userType, expiration, and alternateUserId (if applicable)    sessionId:   SessionRecord|null // the session id and expiration    isExpired:   boolean // checks if the record is expired    // main methods    clear()             // "logout" the authenticated record    save({tokenRecord, userRecord, sessionRecord}) // update the store with the new auth data    // cookie parse and serialize helpers    loadFromCookie(cookieHeader)    exportToCookie(options = {})    // overidable properties methods via constructor   keyPrefix: string    tokenSuffix: string    userSuffix: string    sessionSuffix: string    generateUserId(): string // custom userId generation    addAlternateuserId(): string // custom alternate userId generation    getUserExpiration(): number // custom function to generate a user expiration date - Defaults to 395 days from now    getSessionExpiration(): number // custom function to generate a session expiration date - Defaults to 30 minutes from now } ``` To "logout" the authenticated record you can call `xg.authStore.clear()`. To manually cancel pending requests, you could use `xg.cancelAll()` or `xg.cancel(requestKey)`. #### Custom Cookie names ```javascript import XGenClient, { LocalCookieAuthStore } from '@xgenai/sdk-core'; const authStore = new LocalCookieAuthStore({ generateUserId: () => 'custom_user_id', addAlternateUserId: () => 'custom_alternate_user_id', getUserExpiration: () => Date.now() + 1000 * 60 * 60 * 24 * 20, // 20 days from now getSessionExpiration: () => Date.now() + 1000 * 60 * 60, // 1 hour from now }); ``` Now the cookie keys stored in the browser will be. - `custom_my-token-key` - Stores authentication token and expiration date - `custom_my-user-key` - Contains user information and expiration date - `custom_my-session-key` - Maintains session data and expiration date