astro-tokenkit 1.0.22 → 1.0.24

package/README.md

@@ -143,11 +143,12 @@ const specializedClient = createClient({
 
 Astro TokenKit automatically monitors user inactivity and closes the session across all open tabs. This feature uses `BroadcastChannel` to synchronize activity and logout events.
 
-**Important:** When using the Astro integration, the `onIdle` function cannot be passed in `astro.config.mjs` because it is not serializable. Instead, listen for the `tk:idle` event on the client.
+**Important:** When using the Astro integration, the `onIdle` function cannot be passed in `astro.config.mjs` because it is not serializable. Instead, you can pass the name of a global function as a string, or listen for the `tk:idle` event on the client.
 
 | Property | Type | Description |
 | :--- | :--- | :--- |
 | `timeout` | `number` | **Required.** Inactivity timeout in seconds. |
+| `onIdle` | `Function \| string` | Optional callback when idle timeout is reached. Can be a function or the name of a global function (string). |
 | `autoLogout`| `boolean` | Whether to automatically trigger logout by calling the configured logout endpoint (default: `true`). |
 | `reload` | `boolean` | Whether to reload the page after automatic logout (default: `true`). |
 | `activeTabOnly` | `boolean` | Whether to track activity only on the active tab to save CPU/memory (default: `true`). |
@@ -181,6 +182,25 @@ tokenKit({
 </script>
 ```
 
+#### Overriding Auto-Logout Behavior
+
+By default, TokenKit automatically calls your logout endpoint and reloads the page. You can override this behavior by providing an `onIdle` callback (function or string) in your configuration.
+
+```javascript
+// astro.config.mjs
+export default defineConfig({
+  integrations: [
+    tokenKit({
+      idle: {
+        timeout: 60 * 15,
+        // Disables default logout/reload and runs this instead
+        onIdle: 'myCustomLogout'
+      }
+    })
+  ]
+});
+```
+
 ### Login Options
 
 | Property | Type | Description |

package/dist/client/idle-manager.js

@@ -13,11 +13,24 @@ export class IdleManager {
         this.lastActivity = 0;
         this.config = config;
         this.timeout = config.timeout;
-        this.onIdle = config.onIdle || (() => { });
         this.activeTabOnly = (_a = config.activeTabOnly) !== null && _a !== void 0 ? _a : true;
         this.expiredTimeKey = '_tk_idle_expires';
         this.eventHandler = this.reportActivity.bind(this);
         this.isIdle = false;
+        const onIdleProp = config.onIdle;
+        if (typeof onIdleProp === 'function') {
+            this.onIdle = onIdleProp;
+        }
+        else if (typeof onIdleProp === 'string') {
+            this.onIdle = () => {
+                if (typeof window !== 'undefined' && typeof window[onIdleProp] === 'function') {
+                    window[onIdleProp]();
+                }
+            };
+        }
+        else {
+            this.onIdle = () => { };
+        }
         if (typeof window === 'undefined')
             return;
         try {

package/dist/client/tk-client.js

@@ -3,9 +3,9 @@ if (typeof window !== 'undefined') {
     const config = typeof __TOKENKIT_CONFIG__ !== 'undefined' ? __TOKENKIT_CONFIG__ : {};
     // Initialize Idle Monitoring if configured
     if (config.idle && config.idle.timeout > 0) {
-        new IdleManager(Object.assign(Object.assign({}, config.idle), { onIdle: () => {
+        new IdleManager(Object.assign(Object.assign({}, config.idle), { onIdle: config.idle.onIdle || (() => {
                 var _a;
-                // Note: IdleManager dispatches 'tk:idle' automatically
+                // Default implementation: auto logout and reload
                 if (config.idle.autoLogout !== false && ((_a = config.auth) === null || _a === void 0 ? void 0 : _a.logout)) {
                     const logoutURL = config.auth.logout.startsWith('http')
                         ? config.auth.logout
@@ -19,6 +19,6 @@ if (typeof window !== 'undefined') {
                         }
                     });
                 }
-            } }));
+            }) }));
     }
 }

package/dist/index.cjs

@@ -1392,7 +1392,11 @@ function createClient(config) {
  * ```
  */
 function tokenKit(config) {
+    var _a;
     setConfig(config);
+    if (((_a = config.idle) === null || _a === void 0 ? void 0 : _a.onIdle) && typeof config.idle.onIdle === 'function') {
+        logger.warn('[TokenKit] Passing a function to "idle.onIdle" in astro.config.mjs is not supported because it is not serializable. Use a string name of a global function or window.addEventListener("tk:idle", ...) instead.');
+    }
     // Create a serializable version of the config for the runtime
     const serializableConfig = JSON.parse(JSON.stringify(config, (key, value) => {
         if (typeof value === 'function')