auth-vir 2.3.6 → 2.3.8

package/dist/auth-client/frontend-auth.client.d.ts

@@ -1,4 +1,4 @@
-import { createBlockingInterval, type JsonCompatibleObject, type MaybePromise, type PartialWithUndefined, type SelectFrom } from '@augment-vir/common';
+import { type createBlockingInterval, type JsonCompatibleObject, type MaybePromise, type PartialWithUndefined, type SelectFrom } from '@augment-vir/common';
 import { type AnyDuration } from 'date-vir';
 import { type EmptyObject } from 'type-fest';
 /**
@@ -26,12 +26,19 @@ export type FrontendAuthClientConfig = PartialWithUndefined<{
          *
          * If the user is not currently authorized, this should return `undefined` to prevent
          * unnecessary network traffic.
+         *
+         * This will be called any time the user interacts with the page, debounced by the adjacent
+         * `debounce` property.
          */
         performCheck: () => MaybePromise<SelectFrom<Response, {
             status: true;
         }> | undefined>;
-        /** @default {minutes: 1} */
-        interval?: AnyDuration | undefined;
+        /**
+         * Debounce for firing `performCheck`.
+         *
+         * @default {minutes: 1}
+         */
+        debounce?: AnyDuration | undefined;
     };
     overrides: PartialWithUndefined<{
         localStorage: Pick<Storage, 'setItem' | 'removeItem' | 'getItem'>;

package/dist/auth-client/frontend-auth.client.js

@@ -1,5 +1,5 @@
-import { createBlockingInterval, HttpStatus, } from '@augment-vir/common';
-import { isPageActive } from 'page-active';
+import { HttpStatus, } from '@augment-vir/common';
+import { listenToActivity } from 'detect-activity';
 import { CsrfTokenFailureReason, extractCsrfTokenHeader, getCurrentCsrfToken, storeCsrfToken, wipeCurrentCsrfToken, } from '../csrf-token.js';
 import { AuthHeaderName } from '../headers.js';
 /**
@@ -15,18 +15,18 @@ export class FrontendAuthClient {
     constructor(config = {}) {
         this.config = config;
         if (config.checkUser) {
-            this.userCheckInterval = createBlockingInterval(async () => {
-                if (!isPageActive()) {
-                    /** Do not refresh the user when the page is inactive. */
-                    return;
-                }
-                const response = await config.checkUser?.performCheck();
-                if (response) {
-                    await this.verifyResponseAuth({
-                        status: response.status,
-                    });
-                }
-            }, config.checkUser.interval || { minutes: 1 });
+            listenToActivity({
+                listener: async () => {
+                    const response = await config.checkUser?.performCheck();
+                    if (response) {
+                        await this.verifyResponseAuth({
+                            status: response.status,
+                        });
+                    }
+                },
+                debounce: config.checkUser.debounce || { minutes: 1 },
+                fireImmediately: false,
+            });
         }
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "auth-vir",
-    "version": "2.3.6",
+    "version": "2.3.8",
     "description": "Auth made easy and secure via JWT cookies, CSRF tokens, and password hashing helpers.",
     "keywords": [
         "auth",
@@ -45,10 +45,10 @@
         "@augment-vir/assert": "^31.47.0",
         "@augment-vir/common": "^31.47.0",
         "date-vir": "^8.0.0",
+        "detect-activity": "^0.0.1",
         "hash-wasm": "^4.12.0",
         "jose": "^6.1.0",
         "object-shape-tester": "^6.9.3",
-        "page-active": "^1.0.3",
         "type-fest": "^5.1.0",
         "url-vir": "^2.1.6"
     },

package/src/auth-client/frontend-auth.client.ts

@@ -1,5 +1,5 @@
 import {
-    createBlockingInterval,
+    type createBlockingInterval,
     HttpStatus,
     type JsonCompatibleObject,
     type MaybePromise,
@@ -7,7 +7,7 @@ import {
     type SelectFrom,
 } from '@augment-vir/common';
 import {type AnyDuration} from 'date-vir';
-import {isPageActive} from 'page-active';
+import {listenToActivity} from 'detect-activity';
 import {type EmptyObject} from 'type-fest';
 import {
     CsrfTokenFailureReason,
@@ -44,6 +44,9 @@ export type FrontendAuthClientConfig = PartialWithUndefined<{
          *
          * If the user is not currently authorized, this should return `undefined` to prevent
          * unnecessary network traffic.
+         *
+         * This will be called any time the user interacts with the page, debounced by the adjacent
+         * `debounce` property.
          */
         performCheck: () => MaybePromise<
             | SelectFrom<
@@ -54,8 +57,12 @@ export type FrontendAuthClientConfig = PartialWithUndefined<{
               >
             | undefined
         >;
-        /** @default {minutes: 1} */
-        interval?: AnyDuration | undefined;
+        /**
+         * Debounce for firing `performCheck`.
+         *
+         * @default {minutes: 1}
+         */
+        debounce?: AnyDuration | undefined;
     };
 
     overrides: PartialWithUndefined<{
@@ -77,12 +84,8 @@ export class FrontendAuthClient<AssumedUserParams extends JsonCompatibleObject =
 
     constructor(protected readonly config: FrontendAuthClientConfig = {}) {
         if (config.checkUser) {
-            this.userCheckInterval = createBlockingInterval(
-                async () => {
-                    if (!isPageActive()) {
-                        /** Do not refresh the user when the page is inactive. */
-                        return;
-                    }
+            listenToActivity({
+                listener: async () => {
                     const response = await config.checkUser?.performCheck();
 
                     if (response) {
@@ -91,8 +94,9 @@ export class FrontendAuthClient<AssumedUserParams extends JsonCompatibleObject =
                         });
                     }
                 },
-                config.checkUser.interval || {minutes: 1},
-            );
+                debounce: config.checkUser.debounce || {minutes: 1},
+                fireImmediately: false,
+            });
         }
     }