@eventuras/fides-auth-store 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Losol AS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# @eventuras/fides-auth-store
+
+Framework-agnostic authentication **state** for [`@eventuras/fides-auth`](../fides-auth),
+built on [XState Store](https://stately.ai/docs/xstate-store).
+
+It holds who is logged in, admin status, and error state, plus the logic to keep
+that state in sync — with no dependency on any UI framework or server runtime.
+The application supplies a `checkAuthStatus` callback; the store never reads
+cookies or talks to a server itself, so it can be driven from Next.js, React
+Router, or plain JavaScript alike.
+
+React bindings (hooks) are layered on top of this package separately.
+
+## Install
+
+```bash
+pnpm add @eventuras/fides-auth-store
+```
+
+## Usage
+
+```ts
+import {
+  configureAuthLogger,
+  createAuthStore,
+  initializeAuth,
+  startSessionMonitor,
+} from '@eventuras/fides-auth-store';
+
+// Wire fides-auth's internal logging to @eventuras/logger (once, at startup).
+configureAuthLogger();
+
+export const authStore = createAuthStore({
+  checkAuthStatus: getAuthStatus, // () => Promise<AuthStatus>
+  config: { adminRole: 'Admin', loggerNamespace: 'myapp:auth' },
+});
+
+// Populate the store from the current auth status.
+await initializeAuth(authStore, getAuthStatus);
+
+// Poll for session changes; returns a cleanup function.
+const stop = startSessionMonitor(authStore, getAuthStatus, {
+  interval: 30_000,
+  onSessionExpired: () => console.warn('Session expired'),
+});
+```
+
+## API
+
+- `createAuthStore(options)` — create the store.
+- `initializeAuth(store, checkAuthStatus)` — set initial state from a status check.
+- `checkAuth(store, checkAuthStatus)` — re-check and update state.
+- `startSessionMonitor(store, checkAuthStatus, config)` — poll on an interval; returns a cleanup function.
+- `configureAuthLogger()` — route `@eventuras/fides-auth` logging through `@eventuras/logger`.
+- Types: `AuthStoreContext`, `AuthStoreConfig`, `SessionMonitorConfig`, `SessionUser`, `AuthStatus`.

package/dist/configure-logger.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Configures fides-auth to use @eventuras/logger for all internal logging.
+ *
+ * Call this once at application startup, before creating the auth store.
+ *
+ * @example
+ * ```typescript
+ * import { configureAuthLogger, createAuthStore } from '@eventuras/fides-auth-store';
+ *
+ * configureAuthLogger();
+ * const authStore = createAuthStore({ checkAuthStatus });
+ * ```
+ */
+export declare function configureAuthLogger(): void;
+//# sourceMappingURL=configure-logger.d.ts.map

package/dist/configure-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure-logger.d.ts","sourceRoot":"","sources":["../src/configure-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C"}

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Framework-agnostic authentication state store.
+ *
+ * Built on XState Store, this package holds authentication *state* (who is logged
+ * in, admin status, errors) and the logic to keep it in sync — with no dependency
+ * on any UI framework or server runtime. The app supplies a `checkAuthStatus`
+ * callback; the store does not read cookies or talk to a server itself, so it can
+ * be driven from Next.js, React Router, or plain JavaScript alike.
+ *
+ * React bindings (hooks) live in a separate package layered on top of this one.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   configureAuthLogger,
+ *   createAuthStore,
+ *   initializeAuth,
+ *   startSessionMonitor,
+ * } from '@eventuras/fides-auth-store';
+ *
+ * configureAuthLogger();
+ *
+ * export const authStore = createAuthStore({
+ *   checkAuthStatus: getAuthStatus,
+ *   config: { adminRole: 'Admin', loggerNamespace: 'myapp:auth' },
+ * });
+ *
+ * await initializeAuth(authStore, getAuthStatus);
+ *
+ * const stop = startSessionMonitor(authStore, getAuthStatus, {
+ *   interval: 30_000,
+ *   onSessionExpired: () => console.warn('Session expired'),
+ * });
+ * ```
+ */
+export { createAuthStore, initializeAuth, checkAuth, type AuthStoreContext, type AuthStoreConfig, } from './store';
+export { startSessionMonitor, type SessionMonitorConfig, } from './session-monitor';
+export { configureAuthLogger } from './configure-logger';
+export type { SessionUser, AuthStatus } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EACL,eAAe,EACf,cAAc,EACd,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,327 @@
+import { createStore } from "@xstate/store";
+import { Logger } from "@eventuras/logger";
+import { configureLogger } from "@eventuras/fides-auth/logger";
+//#region src/store.ts
+/**
+* Default configuration values
+*/
+var DEFAULT_CONFIG$1 = {
+	adminRole: "Admin",
+	loggerNamespace: "fides:auth-store"
+};
+/**
+* Creates an authentication store with XState Store
+*
+* @param options - Configuration for the auth store
+* @returns Configured XState store
+*
+* @example
+* ```typescript
+* const authStore = createAuthStore({
+*   checkAuthStatus: async () => getAuthStatus(),
+*   config: {
+*     adminRole: 'Admin',
+*     loggerNamespace: 'myapp:auth',
+*   }
+* });
+* ```
+*/
+function createAuthStore(options) {
+	const config = {
+		...DEFAULT_CONFIG$1,
+		...options.config
+	};
+	const logger = Logger.create({
+		namespace: config.loggerNamespace,
+		context: { component: "AuthStore" }
+	});
+	return createStore({
+		context: {
+			user: null,
+			isAdmin: false,
+			isAuthenticated: false,
+			error: null,
+			lastChecked: null,
+			isInitializing: true
+		},
+		on: {
+			/**
+			* Initialize authentication - check current status
+			*/
+			initialize: () => ({
+				user: null,
+				isAdmin: false,
+				isAuthenticated: false,
+				error: null,
+				lastChecked: null,
+				isInitializing: true
+			}),
+			/**
+			* Authentication check succeeded
+			*/
+			authSuccess: (_context, event) => {
+				logger.info({ user: event.user.roles }, "User authenticated");
+				return {
+					user: event.user,
+					isAdmin: event.user.roles?.includes(config.adminRole) ?? false,
+					isAuthenticated: true,
+					error: null,
+					lastChecked: /* @__PURE__ */ new Date(),
+					isInitializing: false
+				};
+			},
+			/**
+			* Authentication check failed - not authenticated
+			*/
+			authFailed: (_context, event = {}) => {
+				logger.info("User not authenticated");
+				return {
+					user: null,
+					isAdmin: false,
+					isAuthenticated: false,
+					error: event.error || null,
+					lastChecked: /* @__PURE__ */ new Date(),
+					isInitializing: false
+				};
+			},
+			/**
+			* Session expired
+			*/
+			sessionExpired: () => {
+				logger.warn("Session expired");
+				return {
+					user: null,
+					isAdmin: false,
+					isAuthenticated: false,
+					error: "Session expired",
+					lastChecked: /* @__PURE__ */ new Date(),
+					isInitializing: false
+				};
+			},
+			/**
+			* User logged out
+			*/
+			logout: () => {
+				logger.info("User logged out");
+				return {
+					user: null,
+					isAdmin: false,
+					isAuthenticated: false,
+					error: null,
+					lastChecked: /* @__PURE__ */ new Date(),
+					isInitializing: false
+				};
+			},
+			/**
+			* Login success
+			*/
+			loginSuccess: (_context, event) => {
+				logger.info({ user: event.user.email }, "Login successful");
+				return {
+					user: event.user,
+					isAdmin: event.user.roles?.includes(config.adminRole) ?? false,
+					isAuthenticated: true,
+					error: null,
+					lastChecked: /* @__PURE__ */ new Date(),
+					isInitializing: false
+				};
+			},
+			/**
+			* Update last checked timestamp
+			*/
+			updateLastChecked: (context) => ({
+				...context,
+				lastChecked: /* @__PURE__ */ new Date()
+			}),
+			/**
+			* Set error
+			*/
+			setError: (context, event) => ({
+				...context,
+				error: event.error
+			}),
+			/**
+			* Clear error
+			*/
+			clearError: (context) => ({
+				...context,
+				error: null
+			})
+		}
+	});
+}
+/**
+* Helper function to initialize auth by checking status
+*/
+async function initializeAuth(store, checkAuthStatus) {
+	const logger = Logger.create({
+		namespace: "fides:auth-store",
+		context: { component: "initializeAuth" }
+	});
+	logger.debug("Initializing authentication");
+	store.send({ type: "initialize" });
+	try {
+		const result = await checkAuthStatus();
+		logger.debug({ authenticated: result.authenticated }, "Auth status checked");
+		if (result.authenticated && result.user) store.send({
+			type: "authSuccess",
+			user: result.user
+		});
+		else store.send({ type: "authFailed" });
+	} catch (error) {
+		logger.debug({ error }, "Auth check returned no session");
+		store.send({ type: "authFailed" });
+	}
+}
+/**
+* Helper function to check auth status and update store
+*/
+async function checkAuth(store, checkAuthStatus) {
+	const logger = Logger.create({
+		namespace: "fides:auth-store",
+		context: { component: "checkAuth" }
+	});
+	logger.debug("Checking authentication status");
+	try {
+		const result = await checkAuthStatus();
+		logger.debug({ authenticated: result.authenticated }, "Auth status checked");
+		if (result.authenticated && result.user) store.send({
+			type: "authSuccess",
+			user: result.user
+		});
+		else store.send({ type: "authFailed" });
+		store.send({ type: "updateLastChecked" });
+	} catch (error) {
+		const err = error;
+		if (err?.code === "OAUTH_RESPONSE_BODY_ERROR" && err?.error === "invalid_grant") {
+			logger.info("Session ended - refresh token expired or invalid");
+			store.send({ type: "sessionExpired" });
+		} else {
+			const errorDetails = { message: error instanceof Error ? error.message : "Unknown error" };
+			if (error && typeof error === "object") {
+				const oauthError = error;
+				if (oauthError.code) errorDetails.code = oauthError.code;
+				if (oauthError.error) errorDetails.error = oauthError.error;
+				if (oauthError.error_description) errorDetails.error_description = oauthError.error_description;
+				if (oauthError.status) errorDetails.status = oauthError.status;
+			}
+			logger.error(errorDetails, "Auth check error");
+			store.send({
+				type: "authFailed",
+				error: error instanceof Error ? error.message : "Unknown error"
+			});
+		}
+	}
+}
+//#endregion
+//#region src/session-monitor.ts
+var DEFAULT_CONFIG = {
+	interval: 3e4,
+	loggerNamespace: "fides:session-monitor"
+};
+/**
+* Creates a session monitor that polls auth status at regular intervals
+*
+* This is designed to be used with React's useEffect for cleanup.
+*
+* @param store - The auth store to update
+* @param checkAuthStatus - Function to check authentication status
+* @param config - Optional configuration
+* @returns Cleanup function to stop monitoring
+*
+* @example
+* ```typescript
+* useEffect(() => {
+*   const cleanup = startSessionMonitor(authStore, checkAuthStatus, {
+*     interval: 30_000,
+*     onSessionExpired: () => {
+*       toast.warn('Your session has expired');
+*     }
+*   });
+*
+*   return cleanup;
+* }, []);
+* ```
+*/
+function startSessionMonitor(store, checkAuthStatus, config = {}) {
+	const finalConfig = {
+		...DEFAULT_CONFIG,
+		...config
+	};
+	const logger = Logger.create({
+		namespace: finalConfig.loggerNamespace,
+		context: { component: "SessionMonitor" }
+	});
+	logger.debug({ interval: finalConfig.interval }, "Starting session monitor");
+	let isActive = true;
+	let timeoutId = null;
+	const poll = async () => {
+		if (!isActive) return;
+		try {
+			const result = await checkAuthStatus();
+			logger.debug({ authenticated: result.authenticated }, "Session monitor check");
+			if (!result.authenticated) {
+				logger.info("Session monitor detected unauthenticated state - session ended");
+				store.send({ type: "sessionExpired" });
+				if (finalConfig.onSessionExpired) finalConfig.onSessionExpired();
+				return;
+			}
+			if (result.user) store.send({
+				type: "authSuccess",
+				user: result.user
+			});
+		} catch (error) {
+			const err = error;
+			if (err?.code === "OAUTH_RESPONSE_BODY_ERROR" && err?.error === "invalid_grant") {
+				logger.info("Session monitor detected expired refresh token - user session ended");
+				store.send({ type: "sessionExpired" });
+				if (finalConfig.onSessionExpired) finalConfig.onSessionExpired();
+				return;
+			}
+			const errorDetails = { message: error instanceof Error ? error.message : "Unknown error" };
+			if (error && typeof error === "object") {
+				const oauthError = error;
+				if (oauthError.code) errorDetails.code = oauthError.code;
+				if (oauthError.error) errorDetails.error = oauthError.error;
+				if (oauthError.error_description) errorDetails.error_description = oauthError.error_description;
+				if (oauthError.status) errorDetails.status = oauthError.status;
+			}
+			logger.error(errorDetails, "Session monitor error");
+			if (finalConfig.onError && error instanceof Error) finalConfig.onError(error);
+		}
+		if (isActive) timeoutId = setTimeout(poll, finalConfig.interval);
+	};
+	timeoutId = setTimeout(poll, finalConfig.interval);
+	return () => {
+		logger.debug("Stopping session monitor");
+		isActive = false;
+		if (timeoutId) {
+			clearTimeout(timeoutId);
+			timeoutId = null;
+		}
+	};
+}
+//#endregion
+//#region src/configure-logger.ts
+/**
+* Configures fides-auth to use @eventuras/logger for all internal logging.
+*
+* Call this once at application startup, before creating the auth store.
+*
+* @example
+* ```typescript
+* import { configureAuthLogger, createAuthStore } from '@eventuras/fides-auth-store';
+*
+* configureAuthLogger();
+* const authStore = createAuthStore({ checkAuthStatus });
+* ```
+*/
+function configureAuthLogger() {
+	configureLogger({ create(options) {
+		return Logger.create(options);
+	} });
+}
+//#endregion
+export { checkAuth, configureAuthLogger, createAuthStore, initializeAuth, startSessionMonitor };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/store.ts","../src/session-monitor.ts","../src/configure-logger.ts"],"sourcesContent":["import { createStore } from '@xstate/store';\nimport { Logger } from '@eventuras/logger';\nimport type { SessionUser, AuthStatus } from './types';\n\n/**\n * Authentication store context\n */\nexport type AuthStoreContext = {\n  user: SessionUser | null;\n  isAdmin: boolean;\n  isAuthenticated: boolean;\n  error: string | null;\n  lastChecked: Date | null;\n  isInitializing: boolean;\n};\n\n/**\n * Configuration for the auth store\n */\nexport type AuthStoreConfig = {\n  /**\n   * Function to check current authentication status\n   */\n  checkAuthStatus: () => Promise<AuthStatus>;\n\n  /**\n   * Optional configuration\n   */\n  config?: {\n    /**\n     * Role name that indicates admin access\n     * @default 'Admin'\n     */\n    adminRole?: string;\n\n    /**\n     * Namespace for logger\n     * @default 'fides-auth-next:store'\n     */\n    loggerNamespace?: string;\n  };\n};\n\n/**\n * Default configuration values\n */\nconst DEFAULT_CONFIG = {\n  adminRole: 'Admin',\n  loggerNamespace: 'fides:auth-store',\n};\n\n/**\n * Creates an authentication store with XState Store\n *\n * @param options - Configuration for the auth store\n * @returns Configured XState store\n *\n * @example\n * ```typescript\n * const authStore = createAuthStore({\n *   checkAuthStatus: async () => getAuthStatus(),\n *   config: {\n *     adminRole: 'Admin',\n *     loggerNamespace: 'myapp:auth',\n *   }\n * });\n * ```\n */\nexport function createAuthStore(options: AuthStoreConfig) {\n  const config = { ...DEFAULT_CONFIG, ...options.config };\n  const logger = Logger.create({\n    namespace: config.loggerNamespace,\n    context: { component: 'AuthStore' },\n  });\n\n  /**\n   * Initial context values\n   */\n  const initialContext: AuthStoreContext = {\n    user: null,\n    isAdmin: false,\n    isAuthenticated: false,\n    error: null,\n    lastChecked: null,\n    isInitializing: true,\n  };\n\n  /**\n   * Create the store with events\n   */\n  const store = createStore(\n    {\n      context: initialContext,\n      on: {\n        /**\n         * Initialize authentication - check current status\n         */\n        initialize: () => ({\n          user: null,\n          isAdmin: false,\n          isAuthenticated: false,\n          error: null,\n          lastChecked: null,\n          isInitializing: true,\n        }),\n\n        /**\n         * Authentication check succeeded\n         */\n        authSuccess: (_context: AuthStoreContext, event: { user: SessionUser; }) => {\n          logger.info({ user: event.user.roles }, 'User authenticated');\n          return {\n            user: event.user,\n            isAdmin: event.user.roles?.includes(config.adminRole) ?? false,\n            isAuthenticated: true,\n            error: null,\n            lastChecked: new Date(),\n            isInitializing: false,\n          };\n        },\n\n        /**\n         * Authentication check failed - not authenticated\n         */\n        authFailed: (_context: AuthStoreContext, event: { error?: string; } = {}) => {\n          logger.info('User not authenticated');\n          return {\n            user: null,\n            isAdmin: false,\n            isAuthenticated: false,\n            error: event.error || null,\n            lastChecked: new Date(),\n            isInitializing: false,\n          };\n        },\n\n        /**\n         * Session expired\n         */\n        sessionExpired: () => {\n          logger.warn('Session expired');\n          return {\n            user: null,\n            isAdmin: false,\n            isAuthenticated: false,\n            error: 'Session expired',\n            lastChecked: new Date(),\n            isInitializing: false,\n          };\n        },\n\n        /**\n         * User logged out\n         */\n        logout: () => {\n          logger.info('User logged out');\n          return {\n            user: null,\n            isAdmin: false,\n            isAuthenticated: false,\n            error: null,\n            lastChecked: new Date(),\n            isInitializing: false,\n          };\n        },\n\n        /**\n         * Login success\n         */\n        loginSuccess: (_context: AuthStoreContext, event: { user: SessionUser; }) => {\n          logger.info({ user: event.user.email }, 'Login successful');\n          return {\n            user: event.user,\n            isAdmin: event.user.roles?.includes(config.adminRole) ?? false,\n            isAuthenticated: true,\n            error: null,\n            lastChecked: new Date(),\n            isInitializing: false,\n          };\n        },\n\n        /**\n         * Update last checked timestamp\n         */\n        updateLastChecked: (context: AuthStoreContext) => ({\n          ...context,\n          lastChecked: new Date(),\n        }),\n\n        /**\n         * Set error\n         */\n        setError: (context: AuthStoreContext, event: { error: string; }) => ({\n          ...context,\n          error: event.error,\n        }),\n\n        /**\n         * Clear error\n         */\n        clearError: (context: AuthStoreContext) => ({\n          ...context,\n          error: null,\n        }),\n      },\n    }\n  );\n\n  return store;\n}\n\n/**\n * Helper function to initialize auth by checking status\n */\nexport async function initializeAuth(\n  store: ReturnType<typeof createAuthStore>,\n  checkAuthStatus: () => Promise<AuthStatus>\n) {\n  const logger = Logger.create({\n    namespace: 'fides:auth-store',\n    context: { component: 'initializeAuth' },\n  });\n\n  logger.debug('Initializing authentication');\n  store.send({ type: 'initialize' });\n\n  try {\n    const result = await checkAuthStatus();\n    logger.debug({ authenticated: result.authenticated }, 'Auth status checked');\n\n    if (result.authenticated && result.user) {\n      store.send({ type: 'authSuccess', user: result.user });\n    } else {\n      store.send({ type: 'authFailed' });\n    }\n  } catch (error) {\n    logger.debug({ error }, 'Auth check returned no session');\n    store.send({ type: 'authFailed' });\n  }\n}\n\n/**\n * Helper function to check auth status and update store\n */\nexport async function checkAuth(\n  store: ReturnType<typeof createAuthStore>,\n  checkAuthStatus: () => Promise<AuthStatus>\n) {\n  const logger = Logger.create({\n    namespace: 'fides:auth-store',\n    context: { component: 'checkAuth' },\n  });\n\n  logger.debug('Checking authentication status');\n\n  try {\n    const result = await checkAuthStatus();\n    logger.debug({ authenticated: result.authenticated }, 'Auth status checked');\n\n    if (result.authenticated && result.user) {\n      store.send({ type: 'authSuccess', user: result.user });\n    } else {\n      store.send({ type: 'authFailed' });\n    }\n\n    store.send({ type: 'updateLastChecked' });\n  } catch (error) {\n    // Check if this is an expected invalid_grant error (expired refresh token)\n    const err = error as { code?: string; error?: string; error_description?: string; };\n    const isInvalidGrant =\n      err?.code === 'OAUTH_RESPONSE_BODY_ERROR' && err?.error === 'invalid_grant';\n\n    if (isInvalidGrant) {\n      // This is expected during logout or session expiry - log at info level\n      logger.info('Session ended - refresh token expired or invalid');\n      store.send({ type: 'sessionExpired' });\n    } else {\n      // Unexpected error during auth check - log with details\n      const errorDetails: Record<string, unknown> = {\n        message: error instanceof Error ? error.message : 'Unknown error',\n      };\n\n      // Extract OAuth error details if present\n      if (error && typeof error === 'object') {\n        const oauthError = error as any;\n        if (oauthError.code) errorDetails.code = oauthError.code;\n        if (oauthError.error) errorDetails.error = oauthError.error;\n        if (oauthError.error_description)\n          errorDetails.error_description = oauthError.error_description;\n        if (oauthError.status) errorDetails.status = oauthError.status;\n      }\n\n      logger.error(errorDetails, 'Auth check error');\n      store.send({\n        type: 'authFailed',\n        error: error instanceof Error ? error.message : 'Unknown error',\n      });\n    }\n  }\n}\n","import { Logger } from '@eventuras/logger';\nimport type { createAuthStore } from './store';\nimport type { AuthStatus } from './types';\n\n/**\n * Configuration for session monitoring\n */\nexport type SessionMonitorConfig = {\n  /**\n   * Interval in milliseconds for session monitoring polling\n   * @default 30000 (30 seconds)\n   */\n  interval?: number;\n\n  /**\n   * Namespace for logger\n   * @default 'fides:session-monitor'\n   */\n  loggerNamespace?: string;\n\n  /**\n   * Callback when session expires\n   */\n  onSessionExpired?: () => void;\n\n  /**\n   * Callback when session check fails\n   */\n  onError?: (error: Error) => void;\n};\n\nconst DEFAULT_CONFIG = {\n  interval: 30_000, // 30 seconds\n  loggerNamespace: 'fides:session-monitor',\n};\n\n/**\n * Creates a session monitor that polls auth status at regular intervals\n *\n * This is designed to be used with React's useEffect for cleanup.\n *\n * @param store - The auth store to update\n * @param checkAuthStatus - Function to check authentication status\n * @param config - Optional configuration\n * @returns Cleanup function to stop monitoring\n *\n * @example\n * ```typescript\n * useEffect(() => {\n *   const cleanup = startSessionMonitor(authStore, checkAuthStatus, {\n *     interval: 30_000,\n *     onSessionExpired: () => {\n *       toast.warn('Your session has expired');\n *     }\n *   });\n *\n *   return cleanup;\n * }, []);\n * ```\n */\nexport function startSessionMonitor(\n  store: ReturnType<typeof createAuthStore>,\n  checkAuthStatus: () => Promise<AuthStatus>,\n  config: SessionMonitorConfig = {}\n): () => void {\n  const finalConfig = { ...DEFAULT_CONFIG, ...config };\n  const logger = Logger.create({\n    namespace: finalConfig.loggerNamespace,\n    context: { component: 'SessionMonitor' },\n  });\n\n  logger.debug({ interval: finalConfig.interval }, 'Starting session monitor');\n\n  let isActive = true;\n  // Portable timer handle: `number` in the browser, `NodeJS.Timeout` under Node —\n  // this package is framework-agnostic and runs in both.\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n\n  const poll = async (): Promise<void> => {\n    if (!isActive) return;\n\n    try {\n      const result = await checkAuthStatus();\n      logger.debug({ authenticated: result.authenticated }, 'Session monitor check');\n\n      if (!result.authenticated) {\n        // User is no longer authenticated - session ended\n        logger.info('Session monitor detected unauthenticated state - session ended');\n        store.send({ type: 'sessionExpired' });\n\n        if (finalConfig.onSessionExpired) {\n          finalConfig.onSessionExpired();\n        }\n\n        // Stop monitoring after session expires\n        return;\n      }\n\n      if (result.user) {\n        store.send({ type: 'authSuccess', user: result.user });\n      }\n    } catch (error) {\n      // Check if this is an expected invalid_grant error (expired refresh token)\n      const err = error as { code?: string; error?: string; error_description?: string; };\n      const isInvalidGrant =\n        err?.code === 'OAUTH_RESPONSE_BODY_ERROR' && err?.error === 'invalid_grant';\n\n      if (isInvalidGrant) {\n        // This is expected during logout or session expiry - log at info level\n        logger.info('Session monitor detected expired refresh token - user session ended');\n        store.send({ type: 'sessionExpired' });\n\n        if (finalConfig.onSessionExpired) {\n          finalConfig.onSessionExpired();\n        }\n\n        // Stop monitoring after session expires\n        return;\n      }\n\n      // Unexpected error during auth check - log with details\n      const errorDetails: Record<string, unknown> = {\n        message: error instanceof Error ? error.message : 'Unknown error',\n      };\n\n      // Extract OAuth error details if present\n      if (error && typeof error === 'object') {\n        const oauthError = error as any;\n        if (oauthError.code) errorDetails.code = oauthError.code;\n        if (oauthError.error) errorDetails.error = oauthError.error;\n        if (oauthError.error_description)\n          errorDetails.error_description = oauthError.error_description;\n        if (oauthError.status) errorDetails.status = oauthError.status;\n      }\n\n      logger.error(errorDetails, 'Session monitor error');\n\n      if (finalConfig.onError && error instanceof Error) {\n        finalConfig.onError(error);\n      }\n    }\n\n    // Schedule next poll if still active\n    if (isActive) {\n      timeoutId = setTimeout(poll, finalConfig.interval);\n    }\n  };\n\n  // Start first poll\n  timeoutId = setTimeout(poll, finalConfig.interval);\n\n  // Return cleanup function\n  return () => {\n    logger.debug('Stopping session monitor');\n    isActive = false;\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n  };\n}\n","/**\n * Configures fides-auth to use @eventuras/logger for all internal logging.\n *\n * Call this once at application startup, before creating the auth store.\n *\n * @example\n * ```typescript\n * import { configureAuthLogger, createAuthStore } from '@eventuras/fides-auth-store';\n *\n * configureAuthLogger();\n * const authStore = createAuthStore({ checkAuthStatus });\n * ```\n */\n\nimport { configureLogger } from '@eventuras/fides-auth/logger';\nimport { Logger } from '@eventuras/logger';\n\nexport function configureAuthLogger(): void {\n  configureLogger({\n    create(options) {\n      return Logger.create(options);\n    },\n  });\n}\n"],"mappings":"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"}

package/dist/session-monitor.d.ts

@@ -0,0 +1,51 @@
+import { createAuthStore } from './store';
+import { AuthStatus } from './types';
+/**
+ * Configuration for session monitoring
+ */
+export type SessionMonitorConfig = {
+    /**
+     * Interval in milliseconds for session monitoring polling
+     * @default 30000 (30 seconds)
+     */
+    interval?: number;
+    /**
+     * Namespace for logger
+     * @default 'fides:session-monitor'
+     */
+    loggerNamespace?: string;
+    /**
+     * Callback when session expires
+     */
+    onSessionExpired?: () => void;
+    /**
+     * Callback when session check fails
+     */
+    onError?: (error: Error) => void;
+};
+/**
+ * Creates a session monitor that polls auth status at regular intervals
+ *
+ * This is designed to be used with React's useEffect for cleanup.
+ *
+ * @param store - The auth store to update
+ * @param checkAuthStatus - Function to check authentication status
+ * @param config - Optional configuration
+ * @returns Cleanup function to stop monitoring
+ *
+ * @example
+ * ```typescript
+ * useEffect(() => {
+ *   const cleanup = startSessionMonitor(authStore, checkAuthStatus, {
+ *     interval: 30_000,
+ *     onSessionExpired: () => {
+ *       toast.warn('Your session has expired');
+ *     }
+ *   });
+ *
+ *   return cleanup;
+ * }, []);
+ * ```
+ */
+export declare function startSessionMonitor(store: ReturnType<typeof createAuthStore>, checkAuthStatus: () => Promise<AuthStatus>, config?: SessionMonitorConfig): () => void;
+//# sourceMappingURL=session-monitor.d.ts.map

package/dist/session-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-monitor.d.ts","sourceRoot":"","sources":["../src/session-monitor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAE9B;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC,CAAC;AAOF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,EACzC,eAAe,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,EAC1C,MAAM,GAAE,oBAAyB,GAChC,MAAM,IAAI,CAgGZ"}

package/dist/store.d.ts

@@ -0,0 +1,81 @@
+import { SessionUser, AuthStatus } from './types';
+/**
+ * Authentication store context
+ */
+export type AuthStoreContext = {
+    user: SessionUser | null;
+    isAdmin: boolean;
+    isAuthenticated: boolean;
+    error: string | null;
+    lastChecked: Date | null;
+    isInitializing: boolean;
+};
+/**
+ * Configuration for the auth store
+ */
+export type AuthStoreConfig = {
+    /**
+     * Function to check current authentication status
+     */
+    checkAuthStatus: () => Promise<AuthStatus>;
+    /**
+     * Optional configuration
+     */
+    config?: {
+        /**
+         * Role name that indicates admin access
+         * @default 'Admin'
+         */
+        adminRole?: string;
+        /**
+         * Namespace for logger
+         * @default 'fides-auth-next:store'
+         */
+        loggerNamespace?: string;
+    };
+};
+/**
+ * Creates an authentication store with XState Store
+ *
+ * @param options - Configuration for the auth store
+ * @returns Configured XState store
+ *
+ * @example
+ * ```typescript
+ * const authStore = createAuthStore({
+ *   checkAuthStatus: async () => getAuthStatus(),
+ *   config: {
+ *     adminRole: 'Admin',
+ *     loggerNamespace: 'myapp:auth',
+ *   }
+ * });
+ * ```
+ */
+export declare function createAuthStore(options: AuthStoreConfig): import('@xstate/store').Store<AuthStoreContext, {
+    initialize: unknown;
+    authSuccess: {
+        user: SessionUser;
+    };
+    authFailed: {
+        error?: string;
+    } | undefined;
+    sessionExpired: unknown;
+    logout: unknown;
+    loginSuccess: {
+        user: SessionUser;
+    };
+    updateLastChecked: unknown;
+    setError: {
+        error: string;
+    };
+    clearError: unknown;
+}, never>;
+/**
+ * Helper function to initialize auth by checking status
+ */
+export declare function initializeAuth(store: ReturnType<typeof createAuthStore>, checkAuthStatus: () => Promise<AuthStatus>): Promise<void>;
+/**
+ * Helper function to check auth status and update store
+ */
+export declare function checkAuth(store: ReturnType<typeof createAuthStore>, checkAuthStatus: () => Promise<AuthStatus>): Promise<void>;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,eAAe,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAE3C;;OAEG;IACH,MAAM,CAAC,EAAE;QACP;;;WAGG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB;;;WAGG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH,CAAC;AAUF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe;;;cAyCS,WAAW;;;gBAeV,MAAM;;;;;cA6CN,WAAW;;;;eAuBf,MAAM;;;UAiBnE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,EACzC,eAAe,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,iBAuB3C;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,EACzC,eAAe,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,iBAqD3C"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@eventuras/fides-auth-store",
+  "version": "0.1.0",
+  "description": "Framework-agnostic authentication state store (XState Store) for @eventuras/fides-auth",
+  "keywords": [
+    "authentication",
+    "oauth",
+    "oidc",
+    "session",
+    "state-management",
+    "xstate",
+    "store"
+  ],
+  "homepage": "https://github.com/losol/fides-auth/tree/main/packages/fides-auth-store#readme",
+  "bugs": {
+    "url": "https://github.com/losol/fides-auth/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/losol/fides-auth.git",
+    "directory": "packages/fides-auth-store"
+  },
+  "license": "MIT",
+  "author": "losol <losol@users.noreply.github.com>",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "@eventuras/logger": "^0.8.1",
+    "@xstate/store": "^4.0.0",
+    "@eventuras/fides-auth": "0.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.0",
+    "vite": "^8.0.8",
+    "vitest": "^4.1.4",
+    "@eventuras/typescript-config": "1.0.0",
+    "@eventuras/vite-config": "0.2.2"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}