@mapnests/gateway-web-sdk 1.0.2 → 1.0.3

package/README.md

@@ -43,7 +43,7 @@ This setup covers bootstrap on app start and three API patterns:
 import React from 'react';
 import ReactDOM from 'react-dom/client';
 import { SessionManager } from 'gateway-web-sdk';
-import { API_BASE_URL, BOOTSTRAP_PATH, TOKEN_COOKIE_NAME, REFRESH_INTERVAL, TOKEN_EXPIRY, CREDENTIALS } from './config.js';
+import { API_BASE_URL, BOOTSTRAP_PATH, TOKEN_COOKIE_NAME } from './config.js';
 import App from './App';
 
 const sessionManager = SessionManager.getInstance();
@@ -51,9 +51,6 @@ try {
   sessionManager.configure({
     bootstrapUrl: `${API_BASE_URL}${BOOTSTRAP_PATH}`,
     tokenCookieName: TOKEN_COOKIE_NAME,
-    refreshInterval: (REFRESH_INTERVAL ? parseInt(REFRESH_INTERVAL) : 25) * 60 * 1000,
-    tokenExpiry: (TOKEN_EXPIRY ? parseInt(TOKEN_EXPIRY) : 30) * 60 * 1000,
-    credentials: CREDENTIALS === 'true',
   });
 } catch (error) {
   console.error('Failed to configure session manager:', error);
@@ -222,12 +219,9 @@ import App from './App';
 const sessionManager = SessionManager.getInstance();
 sessionManager.configure({
   bootstrapUrl: 'https://your-api.com/session/bootstrap',
-  refreshInterval: 25 * 60 * 1000, // 25 minutes
-  tokenExpiry: 30 * 60 * 1000,     // 30 minutes
   headers: {
     'X-Custom-Header': 'value',
   },
-  credentials: true, // Include cookies in requests
 });
 
 ReactDOM.createRoot(document.getElementById('root')).render(
@@ -252,7 +246,6 @@ export default function RootLayout({ children }) {
     const sessionManager = SessionManager.getInstance();
     sessionManager.configure({
       bootstrapUrl: '/api/session/bootstrap',
-      refreshInterval: 25 * 60 * 1000,
     });
     
     sessionManager.initialize();
@@ -277,7 +270,6 @@ function MyApp({ Component, pageProps }) {
     const sessionManager = SessionManager.getInstance();
     sessionManager.configure({
       bootstrapUrl: '/api/session/bootstrap',
-      refreshInterval: 25 * 60 * 1000,
     });
     
     sessionManager.initialize();
@@ -330,14 +322,14 @@ Configure the session manager.
 sessionManager.configure({
   bootstrapUrl: '/session/bootstrap',  // Required: Bootstrap API endpoint
   tokenCookieName: 'stoken',     // Optional: Custom token cookie name
-  refreshInterval: 25 * 60 * 1000,      // Optional: Refresh interval (ms)
-  tokenExpiry: 30 * 60 * 1000,          // Optional: Token expiry (ms)
   maxRetries: 3,                         // Optional: Max retry attempts
   headers: {},                           // Optional: Additional headers
-  credentials: true,                     // Optional: Include credentials
+  credentials: true,                     // Optional: Include credentials (default: true)
 });
 ```
 
+Note: `refreshInterval` and `tokenExpiry` are automatically set by the server's bootstrap response (`refresh_time` and `expire` fields). You don't need to configure them manually.
+
 ##### `initialize()`
 
 Initialize session by calling bootstrap API.
@@ -413,10 +405,10 @@ const api = setupAxiosInterceptor(axios.create({
 ## Client-Side Best Practices
 
 1. Single Instance: Call configure() once at app startup and reuse the singleton.
-2. Token Timing: Set refreshInterval about 5 minutes before tokenExpiry to avoid race conditions.
+2. Token Timing: The server controls refresh and expiry timing via bootstrap response.
 3. Error Handling: Handle errors and provide user feedback for limited mode.
 4. HTTPS: Use secure, production-grade origins (https) in production environments.
-5. CORS/Credentials: If cross-origin, ensure credentials are enabled in client config and server CORS.
+5. CORS/Credentials: If cross-origin, ensure credentials are enabled in server CORS (SDK defaults to credentials: true).
 6. Initialization: Initialize after configure() and before issuing business API calls.
 
 ## Troubleshooting
@@ -430,7 +422,7 @@ const api = setupAxiosInterceptor(axios.create({
 ### Automatic refresh not working
 
 - Check browser console for errors
-- Verify `refreshInterval` is set correctly
+- Verify server is sending `refresh_time` in bootstrap response
 - Ensure timer isn't being cleared prematurely
 
 ### Multiple initializations
@@ -454,7 +446,6 @@ import type { SessionConfig, SessionState, UseSessionOptions } from 'gateway-web
 
 const config: SessionConfig = {
   bootstrapUrl: '/api/session',
-  refreshInterval: 25 * 60 * 1000
 };
 
 const manager = SessionManager.getInstance();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapnests/gateway-web-sdk",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Session token management SDK with automatic refresh for React/Next.js applications",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",