win-portal-auth-sdk-react 1.0.0

package/README.md

@@ -0,0 +1,49 @@
+# win-portal-auth-sdk-react
+
+React bindings for Win Portal Auth SDK — session management with Socket.IO. Headless (no UI); your app implements dialogs.
+
+## Install
+
+```bash
+pnpm add win-portal-auth-sdk-react
+```
+
+Peer dependencies: `react`, `react-dom`, `socket.io-client` (optional).
+
+## Usage
+
+Wrap your app (or protected layout) with `SessionProvider`, then use `useSession()` to drive your own dialogs.
+
+```tsx
+import { SessionProvider, useSession } from 'win-portal-auth-sdk-react';
+
+<SessionProvider
+  token={token}
+  wsUrl="https://portal.example.com"
+  userId={currentUser?.id}
+  tokenStorageKey="my-app-auth-token"
+  onTokenRefresh={async () => {
+    const res = await authService.refreshToken();
+    return res.data.token;
+  }}
+  onSessionEnd={() => { window.location.href = '/login'; }}
+>
+  <App />
+  <SessionDialogs />
+</SessionProvider>
+
+function SessionDialogs() {
+  const { sessionState, remainingSeconds, continueSession } = useSession();
+  if (sessionState === 'expiring') return <YourWarningDialog onContinue={continueSession} seconds={remainingSeconds} />;
+  if (sessionState === 'expired' || sessionState === 'revoked') return <YourExpiredDialog />;
+  return null;
+}
+```
+
+## API
+
+- **SessionProvider** — props: `token`, `wsUrl`, `userId?`, `tokenStorageKey?`, `onTokenRefresh?`, `onSessionEnd?`
+- **useSession()** — returns `isConnected`, `sessionState`, `remainingSeconds`, `expiringData`, `expiredData`, `revokedData`, `continueSession`, `sendHeartbeat`
+- **useSessionEvents(options)** — lower-level hook (token, wsUrl, callbacks) when you don’t use the provider
+
+See [app-integration guide](../auth-sdk/docs/guides/app-integration.md) in auth-sdk for full integration details.

package/dist/index.d.mts

@@ -0,0 +1,98 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+/**
+ * Session state machine: idle (no token/not connected) -> active -> expiring -> expired | revoked
+ */
+type SessionState = 'idle' | 'active' | 'expiring' | 'expired' | 'revoked';
+interface SessionProviderProps {
+    children: ReactNode;
+    /** JWT token (required to connect; null = no connection) */
+    token: string | null;
+    /** WebSocket / API base URL for Socket.IO (e.g. https://portal.example.com) */
+    wsUrl: string;
+    /** Current user ID (for filtering session_revoked events) */
+    userId?: string | null;
+    /** localStorage key for token (for cross-tab sync via storage event) */
+    tokenStorageKey?: string;
+    /** Callback to refresh token - return new token string */
+    onTokenRefresh?: () => Promise<string>;
+    /** Called when session is definitely gone (expired or revoked) */
+    onSessionEnd?: () => void;
+}
+interface SessionContextValue {
+    isConnected: boolean;
+    sessionState: SessionState;
+    remainingSeconds: number | null;
+    expiringData: {
+        remaining_seconds: number;
+        reason: string;
+    } | null;
+    expiredData: {
+        session_id: string;
+        reason: string;
+    } | null;
+    revokedData: {
+        session_id: string;
+        reason: string;
+        revoked_by?: string;
+        user_id?: string;
+    } | null;
+    /** Send heartbeat + refresh token (for "continue" button) */
+    continueSession: () => Promise<void>;
+    /** Force send heartbeat only */
+    sendHeartbeat: () => void;
+}
+/** Options for useSessionEvents (lower-level hook) */
+interface UseSessionEventsOptions {
+    token: string | null;
+    wsUrl: string;
+    onSessionExpiring?: (data: {
+        remaining_seconds: number;
+        reason: string;
+    }) => void;
+    onSessionExpired?: (data: {
+        session_id: string;
+        reason: string;
+    }) => void;
+    onSessionRevoked?: (data: {
+        session_id: string;
+        reason: string;
+        revoked_by?: string;
+        user_id?: string;
+    }) => void;
+    onHeartbeatAck?: (data: {
+        remaining_seconds: number;
+    }) => void;
+    /** localStorage key for token (cross-tab sync) */
+    tokenStorageKey?: string;
+}
+
+declare function SessionProvider({ children, token, wsUrl, userId, tokenStorageKey, onTokenRefresh, onSessionEnd, }: SessionProviderProps): react_jsx_runtime.JSX.Element;
+
+declare const SessionContext: react.Context<SessionContextValue | null>;
+
+/**
+ * Consume session state and actions from SessionProvider.
+ *
+ * Must be used within a SessionProvider.
+ */
+declare function useSession(): SessionContextValue;
+
+/**
+ * Lower-level hook that wraps SessionSocket from auth-sdk.
+ *
+ * - Creates SessionSocket and connects when token + wsUrl are set
+ * - Registers DOM activity listeners that call notifyActivity() (activity flag pattern)
+ * - Listens for storage events to sync token across tabs (updateToken)
+ * - Returns isConnected and sendHeartbeat (forceHeartbeat)
+ *
+ * Use SessionProvider + useSession for the recommended high-level API.
+ */
+declare function useSessionEvents(options: UseSessionEventsOptions): {
+    isConnected: boolean;
+    sendHeartbeat: () => void;
+};
+
+export { SessionContext, type SessionContextValue, SessionProvider, type SessionProviderProps, type SessionState, type UseSessionEventsOptions, useSession, useSessionEvents };

package/dist/index.d.ts

@@ -0,0 +1,98 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+/**
+ * Session state machine: idle (no token/not connected) -> active -> expiring -> expired | revoked
+ */
+type SessionState = 'idle' | 'active' | 'expiring' | 'expired' | 'revoked';
+interface SessionProviderProps {
+    children: ReactNode;
+    /** JWT token (required to connect; null = no connection) */
+    token: string | null;
+    /** WebSocket / API base URL for Socket.IO (e.g. https://portal.example.com) */
+    wsUrl: string;
+    /** Current user ID (for filtering session_revoked events) */
+    userId?: string | null;
+    /** localStorage key for token (for cross-tab sync via storage event) */
+    tokenStorageKey?: string;
+    /** Callback to refresh token - return new token string */
+    onTokenRefresh?: () => Promise<string>;
+    /** Called when session is definitely gone (expired or revoked) */
+    onSessionEnd?: () => void;
+}
+interface SessionContextValue {
+    isConnected: boolean;
+    sessionState: SessionState;
+    remainingSeconds: number | null;
+    expiringData: {
+        remaining_seconds: number;
+        reason: string;
+    } | null;
+    expiredData: {
+        session_id: string;
+        reason: string;
+    } | null;
+    revokedData: {
+        session_id: string;
+        reason: string;
+        revoked_by?: string;
+        user_id?: string;
+    } | null;
+    /** Send heartbeat + refresh token (for "continue" button) */
+    continueSession: () => Promise<void>;
+    /** Force send heartbeat only */
+    sendHeartbeat: () => void;
+}
+/** Options for useSessionEvents (lower-level hook) */
+interface UseSessionEventsOptions {
+    token: string | null;
+    wsUrl: string;
+    onSessionExpiring?: (data: {
+        remaining_seconds: number;
+        reason: string;
+    }) => void;
+    onSessionExpired?: (data: {
+        session_id: string;
+        reason: string;
+    }) => void;
+    onSessionRevoked?: (data: {
+        session_id: string;
+        reason: string;
+        revoked_by?: string;
+        user_id?: string;
+    }) => void;
+    onHeartbeatAck?: (data: {
+        remaining_seconds: number;
+    }) => void;
+    /** localStorage key for token (cross-tab sync) */
+    tokenStorageKey?: string;
+}
+
+declare function SessionProvider({ children, token, wsUrl, userId, tokenStorageKey, onTokenRefresh, onSessionEnd, }: SessionProviderProps): react_jsx_runtime.JSX.Element;
+
+declare const SessionContext: react.Context<SessionContextValue | null>;
+
+/**
+ * Consume session state and actions from SessionProvider.
+ *
+ * Must be used within a SessionProvider.
+ */
+declare function useSession(): SessionContextValue;
+
+/**
+ * Lower-level hook that wraps SessionSocket from auth-sdk.
+ *
+ * - Creates SessionSocket and connects when token + wsUrl are set
+ * - Registers DOM activity listeners that call notifyActivity() (activity flag pattern)
+ * - Listens for storage events to sync token across tabs (updateToken)
+ * - Returns isConnected and sendHeartbeat (forceHeartbeat)
+ *
+ * Use SessionProvider + useSession for the recommended high-level API.
+ */
+declare function useSessionEvents(options: UseSessionEventsOptions): {
+    isConnected: boolean;
+    sendHeartbeat: () => void;
+};
+
+export { SessionContext, type SessionContextValue, SessionProvider, type SessionProviderProps, type SessionState, type UseSessionEventsOptions, useSession, useSessionEvents };

package/dist/index.js

@@ -0,0 +1,237 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SessionContext: () => SessionContext,
+  SessionProvider: () => SessionProvider,
+  useSession: () => useSession,
+  useSessionEvents: () => useSessionEvents
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/SessionProvider.tsx
+var import_react3 = require("react");
+var import_win_portal_auth_sdk = require("win-portal-auth-sdk");
+
+// src/SessionContext.ts
+var import_react = require("react");
+var SessionContext = (0, import_react.createContext)(null);
+
+// src/useSessionEvents.ts
+var import_react2 = require("react");
+var import_client = require("win-portal-auth-sdk/client");
+var ACTIVITY_EVENTS = ["mousemove", "keydown", "touchstart", "scroll", "click"];
+function useSessionEvents(options) {
+  const {
+    token,
+    wsUrl,
+    onSessionExpiring,
+    onSessionExpired,
+    onSessionRevoked,
+    onHeartbeatAck,
+    tokenStorageKey
+  } = options;
+  const [isConnected, setIsConnected] = (0, import_react2.useState)(false);
+  const socketRef = (0, import_react2.useRef)(null);
+  const optionsRef = (0, import_react2.useRef)(options);
+  optionsRef.current = options;
+  const baseURL = wsUrl.replace(/\/$/, "");
+  (0, import_react2.useEffect)(() => {
+    if (!token || !baseURL) {
+      return;
+    }
+    const opts = optionsRef.current;
+    const socket = new import_client.SessionSocket({
+      baseURL,
+      token,
+      namespace: "/app-sessions",
+      onSessionExpired: (data) => opts.onSessionExpired?.(data),
+      onSessionRevoked: (data) => opts.onSessionRevoked?.(data),
+      onSessionExpiring: (data) => opts.onSessionExpiring?.(data),
+      onConnectionChange: (connected) => setIsConnected(connected),
+      onHeartbeatAck: (data) => opts.onHeartbeatAck?.(data),
+      autoReconnect: true,
+      transports: ["websocket"]
+    });
+    socketRef.current = socket;
+    socket.connect().catch(() => {
+      setIsConnected(false);
+    });
+    return () => {
+      socket.disconnect();
+      socketRef.current = null;
+      setIsConnected(false);
+    };
+  }, [baseURL, token]);
+  (0, import_react2.useEffect)(() => {
+    if (!token || !socketRef.current) return;
+    socketRef.current.updateToken(token);
+  }, [token]);
+  (0, import_react2.useEffect)(() => {
+    if (!isConnected) return;
+    const socket = socketRef.current;
+    if (!socket) return;
+    const markActivity = () => socket.notifyActivity();
+    ACTIVITY_EVENTS.forEach((event) => {
+      window.addEventListener(event, markActivity, { passive: true });
+    });
+    return () => {
+      ACTIVITY_EVENTS.forEach((event) => {
+        window.removeEventListener(event, markActivity);
+      });
+    };
+  }, [isConnected]);
+  (0, import_react2.useEffect)(() => {
+    if (!isConnected || !tokenStorageKey) return;
+    const handleStorage = (e) => {
+      if (e.key === tokenStorageKey && e.newValue) {
+        socketRef.current?.updateToken(e.newValue);
+      }
+    };
+    window.addEventListener("storage", handleStorage);
+    return () => window.removeEventListener("storage", handleStorage);
+  }, [isConnected, tokenStorageKey]);
+  const sendHeartbeat = (0, import_react2.useCallback)(() => {
+    socketRef.current?.forceHeartbeat();
+  }, []);
+  return { isConnected, sendHeartbeat };
+}
+
+// src/SessionProvider.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function getSessionIdFromToken(token) {
+  if (!token) return null;
+  const payload = (0, import_win_portal_auth_sdk.decodeJwt)(token);
+  return payload?.sub ?? null;
+}
+function SessionProvider({
+  children,
+  token,
+  wsUrl,
+  userId = null,
+  tokenStorageKey,
+  onTokenRefresh,
+  onSessionEnd
+}) {
+  const [sessionState, setSessionState] = (0, import_react3.useState)(token && wsUrl ? "active" : "idle");
+  const [remainingSeconds, setRemainingSeconds] = (0, import_react3.useState)(null);
+  const [expiringData, setExpiringData] = (0, import_react3.useState)(null);
+  const [expiredData, setExpiredData] = (0, import_react3.useState)(null);
+  const [revokedData, setRevokedData] = (0, import_react3.useState)(null);
+  const onSessionEndRef = (0, import_react3.useRef)(onSessionEnd);
+  onSessionEndRef.current = onSessionEnd;
+  const onTokenRefreshRef = (0, import_react3.useRef)(onTokenRefresh);
+  onTokenRefreshRef.current = onTokenRefresh;
+  const userIdRef = (0, import_react3.useRef)(userId);
+  userIdRef.current = userId;
+  const handleSessionExpiring = (0, import_react3.useCallback)((data) => {
+    setExpiringData(data);
+    setRemainingSeconds(data.remaining_seconds);
+    setSessionState("expiring");
+  }, []);
+  const handleSessionExpired = (0, import_react3.useCallback)((data) => {
+    setExpiredData(data);
+    setSessionState("expired");
+    setExpiringData(null);
+    setRemainingSeconds(null);
+    onSessionEndRef.current?.();
+  }, []);
+  const handleSessionRevoked = (0, import_react3.useCallback)(
+    (data) => {
+      const currentUserId = userIdRef.current;
+      const currentSessionId = getSessionIdFromToken(token);
+      if (currentUserId != null && data.user_id != null && data.user_id !== currentUserId) {
+        return;
+      }
+      if (currentSessionId != null && data.session_id !== currentSessionId) {
+        return;
+      }
+      setRevokedData(data);
+      setSessionState("revoked");
+      setExpiringData(null);
+      setExpiredData(null);
+      setRemainingSeconds(null);
+      onSessionEndRef.current?.();
+    },
+    [token]
+  );
+  const { isConnected, sendHeartbeat } = useSessionEvents({
+    token,
+    wsUrl,
+    onSessionExpiring: handleSessionExpiring,
+    onSessionExpired: handleSessionExpired,
+    onSessionRevoked: handleSessionRevoked,
+    tokenStorageKey
+  });
+  (0, import_react3.useEffect)(() => {
+    if (isConnected && sessionState === "idle") {
+      setSessionState("active");
+    }
+  }, [isConnected, sessionState]);
+  const continueSession = (0, import_react3.useCallback)(async () => {
+    sendHeartbeat();
+    const refresh = onTokenRefreshRef.current;
+    if (refresh) {
+      try {
+        await refresh();
+        setSessionState("active");
+        setExpiringData(null);
+        setRemainingSeconds(null);
+      } catch {
+        setSessionState("expired");
+        onSessionEndRef.current?.();
+      }
+    } else {
+      setSessionState("active");
+      setExpiringData(null);
+      setRemainingSeconds(null);
+    }
+  }, [sendHeartbeat]);
+  const value = {
+    isConnected,
+    sessionState,
+    remainingSeconds,
+    expiringData,
+    expiredData,
+    revokedData,
+    continueSession,
+    sendHeartbeat
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SessionContext.Provider, { value, children });
+}
+
+// src/useSession.ts
+var import_react4 = require("react");
+function useSession() {
+  const context = (0, import_react4.useContext)(SessionContext);
+  if (context == null) {
+    throw new Error("useSession must be used within a SessionProvider");
+  }
+  return context;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SessionContext,
+  SessionProvider,
+  useSession,
+  useSessionEvents
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/SessionProvider.tsx","../src/SessionContext.ts","../src/useSessionEvents.ts","../src/useSession.ts"],"sourcesContent":["export { SessionProvider } from './SessionProvider';\nexport { SessionContext } from './SessionContext';\nexport { useSession } from './useSession';\nexport { useSessionEvents } from './useSessionEvents';\nexport type {\n  SessionState,\n  SessionProviderProps,\n  SessionContextValue,\n  UseSessionEventsOptions,\n} from './types';\n","'use client';\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport { decodeJwt } from 'win-portal-auth-sdk';\nimport { SessionContext } from './SessionContext';\nimport { useSessionEvents } from './useSessionEvents';\nimport type { SessionContextValue, SessionProviderProps, SessionState } from './types';\n\nfunction getSessionIdFromToken(token: string | null): string | null {\n  if (!token) return null;\n  const payload = decodeJwt(token);\n  return payload?.sub ?? null;\n}\n\nexport function SessionProvider({\n  children,\n  token,\n  wsUrl,\n  userId = null,\n  tokenStorageKey,\n  onTokenRefresh,\n  onSessionEnd,\n}: SessionProviderProps) {\n  const [sessionState, setSessionState] = useState<SessionState>(token && wsUrl ? 'active' : 'idle');\n  const [remainingSeconds, setRemainingSeconds] = useState<number | null>(null);\n  const [expiringData, setExpiringData] = useState<{\n    remaining_seconds: number;\n    reason: string;\n  } | null>(null);\n  const [expiredData, setExpiredData] = useState<{ session_id: string; reason: string } | null>(null);\n  const [revokedData, setRevokedData] = useState<{\n    session_id: string;\n    reason: string;\n    revoked_by?: string;\n    user_id?: string;\n  } | null>(null);\n\n  const onSessionEndRef = useRef(onSessionEnd);\n  onSessionEndRef.current = onSessionEnd;\n  const onTokenRefreshRef = useRef(onTokenRefresh);\n  onTokenRefreshRef.current = onTokenRefresh;\n  const userIdRef = useRef(userId);\n  userIdRef.current = userId;\n\n  const handleSessionExpiring = useCallback((data: { remaining_seconds: number; reason: string }) => {\n    setExpiringData(data);\n    setRemainingSeconds(data.remaining_seconds);\n    setSessionState('expiring');\n  }, []);\n\n  const handleSessionExpired = useCallback((data: { session_id: string; reason: string }) => {\n    setExpiredData(data);\n    setSessionState('expired');\n    setExpiringData(null);\n    setRemainingSeconds(null);\n    onSessionEndRef.current?.();\n  }, []);\n\n  const handleSessionRevoked = useCallback(\n    (data: { session_id: string; reason: string; revoked_by?: string; user_id?: string }) => {\n      const currentUserId = userIdRef.current;\n      const currentSessionId = getSessionIdFromToken(token);\n\n      if (currentUserId != null && data.user_id != null && data.user_id !== currentUserId) {\n        return;\n      }\n      if (currentSessionId != null && data.session_id !== currentSessionId) {\n        return;\n      }\n\n      setRevokedData(data);\n      setSessionState('revoked');\n      setExpiringData(null);\n      setExpiredData(null);\n      setRemainingSeconds(null);\n      onSessionEndRef.current?.();\n    },\n    [token]\n  );\n\n  const { isConnected, sendHeartbeat } = useSessionEvents({\n    token,\n    wsUrl,\n    onSessionExpiring: handleSessionExpiring,\n    onSessionExpired: handleSessionExpired,\n    onSessionRevoked: handleSessionRevoked,\n    tokenStorageKey,\n  });\n\n  // When connection is established and we were idle, move to active\n  useEffect(() => {\n    if (isConnected && sessionState === 'idle') {\n      setSessionState('active');\n    }\n  }, [isConnected, sessionState]);\n\n  const continueSession = useCallback(async () => {\n    sendHeartbeat();\n    const refresh = onTokenRefreshRef.current;\n    if (refresh) {\n      try {\n        await refresh();\n        setSessionState('active');\n        setExpiringData(null);\n        setRemainingSeconds(null);\n      } catch {\n        setSessionState('expired');\n        onSessionEndRef.current?.();\n      }\n    } else {\n      setSessionState('active');\n      setExpiringData(null);\n      setRemainingSeconds(null);\n    }\n  }, [sendHeartbeat]);\n\n  const value: SessionContextValue = {\n    isConnected,\n    sessionState,\n    remainingSeconds,\n    expiringData,\n    expiredData,\n    revokedData,\n    continueSession,\n    sendHeartbeat,\n  };\n\n  return <SessionContext.Provider value={value}>{children}</SessionContext.Provider>;\n}\n","import { createContext } from 'react';\nimport type { SessionContextValue } from './types';\n\nexport const SessionContext = createContext<SessionContextValue | null>(null);\n","'use client';\n\nimport { useEffect, useCallback, useRef, useState } from 'react';\nimport { SessionSocket } from 'win-portal-auth-sdk/client';\nimport type { UseSessionEventsOptions } from './types';\n\nconst ACTIVITY_EVENTS = ['mousemove', 'keydown', 'touchstart', 'scroll', 'click'] as const;\n\n/**\n * Lower-level hook that wraps SessionSocket from auth-sdk.\n *\n * - Creates SessionSocket and connects when token + wsUrl are set\n * - Registers DOM activity listeners that call notifyActivity() (activity flag pattern)\n * - Listens for storage events to sync token across tabs (updateToken)\n * - Returns isConnected and sendHeartbeat (forceHeartbeat)\n *\n * Use SessionProvider + useSession for the recommended high-level API.\n */\nexport function useSessionEvents(options: UseSessionEventsOptions) {\n  const {\n    token,\n    wsUrl,\n    onSessionExpiring,\n    onSessionExpired,\n    onSessionRevoked,\n    onHeartbeatAck,\n    tokenStorageKey,\n  } = options;\n\n  const [isConnected, setIsConnected] = useState(false);\n  const socketRef = useRef<SessionSocket | null>(null);\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n\n  const baseURL = wsUrl.replace(/\\/$/, '');\n\n  // Create SessionSocket and connect when token + wsUrl available\n  useEffect(() => {\n    if (!token || !baseURL) {\n      return;\n    }\n\n    const opts = optionsRef.current;\n    const socket = new SessionSocket({\n      baseURL,\n      token,\n      namespace: '/app-sessions',\n      onSessionExpired: (data) => opts.onSessionExpired?.(data),\n      onSessionRevoked: (data) => opts.onSessionRevoked?.(data),\n      onSessionExpiring: (data) => opts.onSessionExpiring?.(data),\n      onConnectionChange: (connected) => setIsConnected(connected),\n      onHeartbeatAck: (data) => opts.onHeartbeatAck?.(data),\n      autoReconnect: true,\n      transports: ['websocket'],\n    });\n\n    socketRef.current = socket;\n    socket.connect().catch(() => {\n      setIsConnected(false);\n    });\n\n    return () => {\n      socket.disconnect();\n      socketRef.current = null;\n      setIsConnected(false);\n    };\n  }, [baseURL, token]);\n\n  // When token changes (e.g. refresh), update socket auth for next reconnection\n  useEffect(() => {\n    if (!token || !socketRef.current) return;\n    socketRef.current.updateToken(token);\n  }, [token]);\n\n  // DOM activity listeners: call notifyActivity() (ultra cheap flag)\n  useEffect(() => {\n    if (!isConnected) return;\n    const socket = socketRef.current;\n    if (!socket) return;\n\n    const markActivity = () => socket.notifyActivity();\n    ACTIVITY_EVENTS.forEach((event) => {\n      window.addEventListener(event, markActivity, { passive: true });\n    });\n    return () => {\n      ACTIVITY_EVENTS.forEach((event) => {\n        window.removeEventListener(event, markActivity);\n      });\n    };\n  }, [isConnected]);\n\n  // Storage event: sync token across tabs\n  useEffect(() => {\n    if (!isConnected || !tokenStorageKey) return;\n\n    const handleStorage = (e: StorageEvent) => {\n      if (e.key === tokenStorageKey && e.newValue) {\n        socketRef.current?.updateToken(e.newValue);\n      }\n    };\n    window.addEventListener('storage', handleStorage);\n    return () => window.removeEventListener('storage', handleStorage);\n  }, [isConnected, tokenStorageKey]);\n\n  const sendHeartbeat = useCallback(() => {\n    socketRef.current?.forceHeartbeat();\n  }, []);\n\n  return { isConnected, sendHeartbeat };\n}\n","'use client';\n\nimport { useContext } from 'react';\nimport { SessionContext } from './SessionContext';\nimport type { SessionContextValue } from './types';\n\n/**\n * Consume session state and actions from SessionProvider.\n *\n * Must be used within a SessionProvider.\n */\nexport function useSession(): SessionContextValue {\n  const context = useContext(SessionContext);\n  if (context == null) {\n    throw new Error('useSession must be used within a SessionProvider');\n  }\n  return context;\n}\n"],"mappings":"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","names":["import_react","import_react","import_react"]}

package/dist/index.mjs

@@ -0,0 +1,207 @@
+// src/SessionProvider.tsx
+import { useCallback as useCallback2, useEffect as useEffect2, useRef as useRef2, useState as useState2 } from "react";
+import { decodeJwt } from "win-portal-auth-sdk";
+
+// src/SessionContext.ts
+import { createContext } from "react";
+var SessionContext = createContext(null);
+
+// src/useSessionEvents.ts
+import { useEffect, useCallback, useRef, useState } from "react";
+import { SessionSocket } from "win-portal-auth-sdk/client";
+var ACTIVITY_EVENTS = ["mousemove", "keydown", "touchstart", "scroll", "click"];
+function useSessionEvents(options) {
+  const {
+    token,
+    wsUrl,
+    onSessionExpiring,
+    onSessionExpired,
+    onSessionRevoked,
+    onHeartbeatAck,
+    tokenStorageKey
+  } = options;
+  const [isConnected, setIsConnected] = useState(false);
+  const socketRef = useRef(null);
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  const baseURL = wsUrl.replace(/\/$/, "");
+  useEffect(() => {
+    if (!token || !baseURL) {
+      return;
+    }
+    const opts = optionsRef.current;
+    const socket = new SessionSocket({
+      baseURL,
+      token,
+      namespace: "/app-sessions",
+      onSessionExpired: (data) => opts.onSessionExpired?.(data),
+      onSessionRevoked: (data) => opts.onSessionRevoked?.(data),
+      onSessionExpiring: (data) => opts.onSessionExpiring?.(data),
+      onConnectionChange: (connected) => setIsConnected(connected),
+      onHeartbeatAck: (data) => opts.onHeartbeatAck?.(data),
+      autoReconnect: true,
+      transports: ["websocket"]
+    });
+    socketRef.current = socket;
+    socket.connect().catch(() => {
+      setIsConnected(false);
+    });
+    return () => {
+      socket.disconnect();
+      socketRef.current = null;
+      setIsConnected(false);
+    };
+  }, [baseURL, token]);
+  useEffect(() => {
+    if (!token || !socketRef.current) return;
+    socketRef.current.updateToken(token);
+  }, [token]);
+  useEffect(() => {
+    if (!isConnected) return;
+    const socket = socketRef.current;
+    if (!socket) return;
+    const markActivity = () => socket.notifyActivity();
+    ACTIVITY_EVENTS.forEach((event) => {
+      window.addEventListener(event, markActivity, { passive: true });
+    });
+    return () => {
+      ACTIVITY_EVENTS.forEach((event) => {
+        window.removeEventListener(event, markActivity);
+      });
+    };
+  }, [isConnected]);
+  useEffect(() => {
+    if (!isConnected || !tokenStorageKey) return;
+    const handleStorage = (e) => {
+      if (e.key === tokenStorageKey && e.newValue) {
+        socketRef.current?.updateToken(e.newValue);
+      }
+    };
+    window.addEventListener("storage", handleStorage);
+    return () => window.removeEventListener("storage", handleStorage);
+  }, [isConnected, tokenStorageKey]);
+  const sendHeartbeat = useCallback(() => {
+    socketRef.current?.forceHeartbeat();
+  }, []);
+  return { isConnected, sendHeartbeat };
+}
+
+// src/SessionProvider.tsx
+import { jsx } from "react/jsx-runtime";
+function getSessionIdFromToken(token) {
+  if (!token) return null;
+  const payload = decodeJwt(token);
+  return payload?.sub ?? null;
+}
+function SessionProvider({
+  children,
+  token,
+  wsUrl,
+  userId = null,
+  tokenStorageKey,
+  onTokenRefresh,
+  onSessionEnd
+}) {
+  const [sessionState, setSessionState] = useState2(token && wsUrl ? "active" : "idle");
+  const [remainingSeconds, setRemainingSeconds] = useState2(null);
+  const [expiringData, setExpiringData] = useState2(null);
+  const [expiredData, setExpiredData] = useState2(null);
+  const [revokedData, setRevokedData] = useState2(null);
+  const onSessionEndRef = useRef2(onSessionEnd);
+  onSessionEndRef.current = onSessionEnd;
+  const onTokenRefreshRef = useRef2(onTokenRefresh);
+  onTokenRefreshRef.current = onTokenRefresh;
+  const userIdRef = useRef2(userId);
+  userIdRef.current = userId;
+  const handleSessionExpiring = useCallback2((data) => {
+    setExpiringData(data);
+    setRemainingSeconds(data.remaining_seconds);
+    setSessionState("expiring");
+  }, []);
+  const handleSessionExpired = useCallback2((data) => {
+    setExpiredData(data);
+    setSessionState("expired");
+    setExpiringData(null);
+    setRemainingSeconds(null);
+    onSessionEndRef.current?.();
+  }, []);
+  const handleSessionRevoked = useCallback2(
+    (data) => {
+      const currentUserId = userIdRef.current;
+      const currentSessionId = getSessionIdFromToken(token);
+      if (currentUserId != null && data.user_id != null && data.user_id !== currentUserId) {
+        return;
+      }
+      if (currentSessionId != null && data.session_id !== currentSessionId) {
+        return;
+      }
+      setRevokedData(data);
+      setSessionState("revoked");
+      setExpiringData(null);
+      setExpiredData(null);
+      setRemainingSeconds(null);
+      onSessionEndRef.current?.();
+    },
+    [token]
+  );
+  const { isConnected, sendHeartbeat } = useSessionEvents({
+    token,
+    wsUrl,
+    onSessionExpiring: handleSessionExpiring,
+    onSessionExpired: handleSessionExpired,
+    onSessionRevoked: handleSessionRevoked,
+    tokenStorageKey
+  });
+  useEffect2(() => {
+    if (isConnected && sessionState === "idle") {
+      setSessionState("active");
+    }
+  }, [isConnected, sessionState]);
+  const continueSession = useCallback2(async () => {
+    sendHeartbeat();
+    const refresh = onTokenRefreshRef.current;
+    if (refresh) {
+      try {
+        await refresh();
+        setSessionState("active");
+        setExpiringData(null);
+        setRemainingSeconds(null);
+      } catch {
+        setSessionState("expired");
+        onSessionEndRef.current?.();
+      }
+    } else {
+      setSessionState("active");
+      setExpiringData(null);
+      setRemainingSeconds(null);
+    }
+  }, [sendHeartbeat]);
+  const value = {
+    isConnected,
+    sessionState,
+    remainingSeconds,
+    expiringData,
+    expiredData,
+    revokedData,
+    continueSession,
+    sendHeartbeat
+  };
+  return /* @__PURE__ */ jsx(SessionContext.Provider, { value, children });
+}
+
+// src/useSession.ts
+import { useContext } from "react";
+function useSession() {
+  const context = useContext(SessionContext);
+  if (context == null) {
+    throw new Error("useSession must be used within a SessionProvider");
+  }
+  return context;
+}
+export {
+  SessionContext,
+  SessionProvider,
+  useSession,
+  useSessionEvents
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/SessionProvider.tsx","../src/SessionContext.ts","../src/useSessionEvents.ts","../src/useSession.ts"],"sourcesContent":["'use client';\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport { decodeJwt } from 'win-portal-auth-sdk';\nimport { SessionContext } from './SessionContext';\nimport { useSessionEvents } from './useSessionEvents';\nimport type { SessionContextValue, SessionProviderProps, SessionState } from './types';\n\nfunction getSessionIdFromToken(token: string | null): string | null {\n  if (!token) return null;\n  const payload = decodeJwt(token);\n  return payload?.sub ?? null;\n}\n\nexport function SessionProvider({\n  children,\n  token,\n  wsUrl,\n  userId = null,\n  tokenStorageKey,\n  onTokenRefresh,\n  onSessionEnd,\n}: SessionProviderProps) {\n  const [sessionState, setSessionState] = useState<SessionState>(token && wsUrl ? 'active' : 'idle');\n  const [remainingSeconds, setRemainingSeconds] = useState<number | null>(null);\n  const [expiringData, setExpiringData] = useState<{\n    remaining_seconds: number;\n    reason: string;\n  } | null>(null);\n  const [expiredData, setExpiredData] = useState<{ session_id: string; reason: string } | null>(null);\n  const [revokedData, setRevokedData] = useState<{\n    session_id: string;\n    reason: string;\n    revoked_by?: string;\n    user_id?: string;\n  } | null>(null);\n\n  const onSessionEndRef = useRef(onSessionEnd);\n  onSessionEndRef.current = onSessionEnd;\n  const onTokenRefreshRef = useRef(onTokenRefresh);\n  onTokenRefreshRef.current = onTokenRefresh;\n  const userIdRef = useRef(userId);\n  userIdRef.current = userId;\n\n  const handleSessionExpiring = useCallback((data: { remaining_seconds: number; reason: string }) => {\n    setExpiringData(data);\n    setRemainingSeconds(data.remaining_seconds);\n    setSessionState('expiring');\n  }, []);\n\n  const handleSessionExpired = useCallback((data: { session_id: string; reason: string }) => {\n    setExpiredData(data);\n    setSessionState('expired');\n    setExpiringData(null);\n    setRemainingSeconds(null);\n    onSessionEndRef.current?.();\n  }, []);\n\n  const handleSessionRevoked = useCallback(\n    (data: { session_id: string; reason: string; revoked_by?: string; user_id?: string }) => {\n      const currentUserId = userIdRef.current;\n      const currentSessionId = getSessionIdFromToken(token);\n\n      if (currentUserId != null && data.user_id != null && data.user_id !== currentUserId) {\n        return;\n      }\n      if (currentSessionId != null && data.session_id !== currentSessionId) {\n        return;\n      }\n\n      setRevokedData(data);\n      setSessionState('revoked');\n      setExpiringData(null);\n      setExpiredData(null);\n      setRemainingSeconds(null);\n      onSessionEndRef.current?.();\n    },\n    [token]\n  );\n\n  const { isConnected, sendHeartbeat } = useSessionEvents({\n    token,\n    wsUrl,\n    onSessionExpiring: handleSessionExpiring,\n    onSessionExpired: handleSessionExpired,\n    onSessionRevoked: handleSessionRevoked,\n    tokenStorageKey,\n  });\n\n  // When connection is established and we were idle, move to active\n  useEffect(() => {\n    if (isConnected && sessionState === 'idle') {\n      setSessionState('active');\n    }\n  }, [isConnected, sessionState]);\n\n  const continueSession = useCallback(async () => {\n    sendHeartbeat();\n    const refresh = onTokenRefreshRef.current;\n    if (refresh) {\n      try {\n        await refresh();\n        setSessionState('active');\n        setExpiringData(null);\n        setRemainingSeconds(null);\n      } catch {\n        setSessionState('expired');\n        onSessionEndRef.current?.();\n      }\n    } else {\n      setSessionState('active');\n      setExpiringData(null);\n      setRemainingSeconds(null);\n    }\n  }, [sendHeartbeat]);\n\n  const value: SessionContextValue = {\n    isConnected,\n    sessionState,\n    remainingSeconds,\n    expiringData,\n    expiredData,\n    revokedData,\n    continueSession,\n    sendHeartbeat,\n  };\n\n  return <SessionContext.Provider value={value}>{children}</SessionContext.Provider>;\n}\n","import { createContext } from 'react';\nimport type { SessionContextValue } from './types';\n\nexport const SessionContext = createContext<SessionContextValue | null>(null);\n","'use client';\n\nimport { useEffect, useCallback, useRef, useState } from 'react';\nimport { SessionSocket } from 'win-portal-auth-sdk/client';\nimport type { UseSessionEventsOptions } from './types';\n\nconst ACTIVITY_EVENTS = ['mousemove', 'keydown', 'touchstart', 'scroll', 'click'] as const;\n\n/**\n * Lower-level hook that wraps SessionSocket from auth-sdk.\n *\n * - Creates SessionSocket and connects when token + wsUrl are set\n * - Registers DOM activity listeners that call notifyActivity() (activity flag pattern)\n * - Listens for storage events to sync token across tabs (updateToken)\n * - Returns isConnected and sendHeartbeat (forceHeartbeat)\n *\n * Use SessionProvider + useSession for the recommended high-level API.\n */\nexport function useSessionEvents(options: UseSessionEventsOptions) {\n  const {\n    token,\n    wsUrl,\n    onSessionExpiring,\n    onSessionExpired,\n    onSessionRevoked,\n    onHeartbeatAck,\n    tokenStorageKey,\n  } = options;\n\n  const [isConnected, setIsConnected] = useState(false);\n  const socketRef = useRef<SessionSocket | null>(null);\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n\n  const baseURL = wsUrl.replace(/\\/$/, '');\n\n  // Create SessionSocket and connect when token + wsUrl available\n  useEffect(() => {\n    if (!token || !baseURL) {\n      return;\n    }\n\n    const opts = optionsRef.current;\n    const socket = new SessionSocket({\n      baseURL,\n      token,\n      namespace: '/app-sessions',\n      onSessionExpired: (data) => opts.onSessionExpired?.(data),\n      onSessionRevoked: (data) => opts.onSessionRevoked?.(data),\n      onSessionExpiring: (data) => opts.onSessionExpiring?.(data),\n      onConnectionChange: (connected) => setIsConnected(connected),\n      onHeartbeatAck: (data) => opts.onHeartbeatAck?.(data),\n      autoReconnect: true,\n      transports: ['websocket'],\n    });\n\n    socketRef.current = socket;\n    socket.connect().catch(() => {\n      setIsConnected(false);\n    });\n\n    return () => {\n      socket.disconnect();\n      socketRef.current = null;\n      setIsConnected(false);\n    };\n  }, [baseURL, token]);\n\n  // When token changes (e.g. refresh), update socket auth for next reconnection\n  useEffect(() => {\n    if (!token || !socketRef.current) return;\n    socketRef.current.updateToken(token);\n  }, [token]);\n\n  // DOM activity listeners: call notifyActivity() (ultra cheap flag)\n  useEffect(() => {\n    if (!isConnected) return;\n    const socket = socketRef.current;\n    if (!socket) return;\n\n    const markActivity = () => socket.notifyActivity();\n    ACTIVITY_EVENTS.forEach((event) => {\n      window.addEventListener(event, markActivity, { passive: true });\n    });\n    return () => {\n      ACTIVITY_EVENTS.forEach((event) => {\n        window.removeEventListener(event, markActivity);\n      });\n    };\n  }, [isConnected]);\n\n  // Storage event: sync token across tabs\n  useEffect(() => {\n    if (!isConnected || !tokenStorageKey) return;\n\n    const handleStorage = (e: StorageEvent) => {\n      if (e.key === tokenStorageKey && e.newValue) {\n        socketRef.current?.updateToken(e.newValue);\n      }\n    };\n    window.addEventListener('storage', handleStorage);\n    return () => window.removeEventListener('storage', handleStorage);\n  }, [isConnected, tokenStorageKey]);\n\n  const sendHeartbeat = useCallback(() => {\n    socketRef.current?.forceHeartbeat();\n  }, []);\n\n  return { isConnected, sendHeartbeat };\n}\n","'use client';\n\nimport { useContext } from 'react';\nimport { SessionContext } from './SessionContext';\nimport type { SessionContextValue } from './types';\n\n/**\n * Consume session state and actions from SessionProvider.\n *\n * Must be used within a SessionProvider.\n */\nexport function useSession(): SessionContextValue {\n  const context = useContext(SessionContext);\n  if (context == null) {\n    throw new Error('useSession must be used within a SessionProvider');\n  }\n  return context;\n}\n"],"mappings":"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","names":["useCallback","useEffect","useRef","useState","useState","useRef","useCallback","useEffect"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "win-portal-auth-sdk-react",
+  "version": "1.0.0",
+  "description": "React bindings for Win Portal Auth SDK - session management with Socket.IO",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "socket.io-client": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "socket.io-client": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "win-portal-auth-sdk": "1.6.18"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "socket.io-client": "^4.7.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "keywords": [
+    "auth",
+    "session",
+    "react",
+    "socket.io",
+    "win-portal"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist"
+  }
+}