@payloadcms/ui 4.0.0-internal.543da65 → 4.0.0-internal.567a487

package/dist/providers/Auth/useAuthSessionTimers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAuthSessionTimers.js","names":["useCallback","useEffect","useMemo","useRef","createSessionActivityTracker","registerSessionActivityListeners","getAuthSessionTiming","maxTimeoutMs","useAuthSessionTimers","isAuthenticated","onActivity","onActivityRefresh","onExpire","onReminder","activityListenerCleanupRef","undefined","activityCheckpointTimeoutRef","forceLogOutTimeoutRef","hasActiveSessionRef","lastSessionActivityAtRef","scheduledRefreshTimeoutRef","reminderTimeoutRef","sessionTimingRef","tokenExpirationMsRef","callbacksRef","scheduleRefresh","forceRefresh","current","sessionTiming","Date","now","refreshStartsAt","clearTimeout","setTimeout","activityTracker","_source","occurredAt","isFirstActivity","recordActivity","source","isActivityWindowOpen","activityTrackingStartsAt","reminderStartsAt","record","addActivityListeners","markActivity","window","removeActivityListeners","cleanup","resetSessionLifecycle","reset","clear","setExpiration","expirationMs","Number","isFinite","scheduleReminder","reminderStartsInMs","Math","max","expiresAt","min","scheduleActivityCheckpoint","refreshStartsInMs","checkpointAt","lastActivityAt","hasRecentActivity","scheduleExpiration","expiresInMs","getCurrentExpirationMs"],"sources":["../../../src/providers/Auth/useAuthSessionTimers.ts"],"sourcesContent":["'use client'\nimport { useCallback, useEffect, useMemo, useRef } from 'react'\n\nimport type { SessionActivitySource } from './sessionActivity.js'\nimport type { AuthSessionTiming } from './sessionTiming.js'\n\nimport {\n  createSessionActivityTracker,\n  registerSessionActivityListeners,\n} from './sessionActivity.js'\nimport { getAuthSessionTiming } from './sessionTiming.js'\n\nconst maxTimeoutMs = 2_147_483_647 // ~24.8 days\n\nexport type AuthSessionTimers = {\n  clear: () => void\n  getCurrentExpirationMs: () => number | undefined\n  /** Records activity only while the activity tracking window is open. */\n  recordActivity: (source: SessionActivitySource) => boolean\n  scheduleRefresh: (forceRefresh?: boolean) => void\n  setExpiration: (expirationMs: number) => AuthSessionTiming | undefined\n}\n\nexport type UseAuthSessionTimersArgs = {\n  isAuthenticated: boolean\n  onActivity: () => void\n  onActivityRefresh: () => void\n  onExpire: (expirationMs: number) => void\n  onReminder: () => void\n}\n\n/**\n * Manages activity-aware refresh, expiration reminders, and logout timing for the current session.\n *\n * Activity inside the refresh window schedules a refresh. Earlier activity is remembered until the\n * refresh-window checkpoint so the session can still be extended without requiring another\n * activity event.\n */\nexport function useAuthSessionTimers({\n  isAuthenticated,\n  onActivity,\n  onActivityRefresh,\n  onExpire,\n  onReminder,\n}: UseAuthSessionTimersArgs): AuthSessionTimers {\n  const activityListenerCleanupRef = useRef<(() => void) | undefined>(undefined)\n  const activityCheckpointTimeoutRef = useRef<ReturnType<typeof setTimeout>>(null)\n  const forceLogOutTimeoutRef = useRef<ReturnType<typeof setTimeout>>(null)\n  const hasActiveSessionRef = useRef(isAuthenticated)\n  const lastSessionActivityAtRef = useRef<number>(undefined)\n  const scheduledRefreshTimeoutRef = useRef<ReturnType<typeof setTimeout>>(null)\n  const reminderTimeoutRef = useRef<ReturnType<typeof setTimeout>>(null)\n  const sessionTimingRef = useRef<AuthSessionTiming>(undefined)\n  const tokenExpirationMsRef = useRef<number>(undefined)\n  const callbacksRef = useRef({ onActivity, onActivityRefresh, onExpire, onReminder })\n\n  const scheduleRefresh = useCallback((forceRefresh?: boolean) => {\n    if (!hasActiveSessionRef.current) {\n      return\n    }\n\n    const sessionTiming = sessionTimingRef.current\n\n    if (forceRefresh || (sessionTiming && Date.now() >= sessionTiming.refreshStartsAt)) {\n      clearTimeout(scheduledRefreshTimeoutRef.current)\n      scheduledRefreshTimeoutRef.current = setTimeout(() => {\n        callbacksRef.current.onActivityRefresh()\n      }, 1000)\n    }\n  }, [])\n\n  const activityTracker = useMemo(\n    () =>\n      createSessionActivityTracker({\n        onActivity: (_source, occurredAt) => {\n          const isFirstActivity = lastSessionActivityAtRef.current === undefined\n\n          lastSessionActivityAtRef.current = occurredAt\n\n          if (isFirstActivity) {\n            callbacksRef.current.onActivity()\n          }\n\n          scheduleRefresh()\n        },\n      }),\n    [scheduleRefresh],\n  )\n\n  const recordActivity = useCallback(\n    (source: SessionActivitySource): boolean => {\n      const occurredAt = Date.now()\n      const sessionTiming = sessionTimingRef.current\n      const isActivityWindowOpen =\n        sessionTiming &&\n        occurredAt >= sessionTiming.activityTrackingStartsAt &&\n        occurredAt < sessionTiming.reminderStartsAt\n\n      if (!activityListenerCleanupRef.current || !isActivityWindowOpen) {\n        return false\n      }\n\n      return activityTracker.record(source)\n    },\n    [activityTracker],\n  )\n\n  const addActivityListeners = useCallback(() => {\n    if (activityListenerCleanupRef.current) {\n      return\n    }\n\n    activityListenerCleanupRef.current = registerSessionActivityListeners({\n      markActivity: recordActivity,\n      window,\n    })\n  }, [recordActivity])\n\n  const removeActivityListeners = useCallback(() => {\n    const cleanup = activityListenerCleanupRef.current\n\n    if (!cleanup) {\n      return\n    }\n\n    activityListenerCleanupRef.current = undefined\n    cleanup()\n  }, [])\n\n  const resetSessionLifecycle = useCallback(() => {\n    clearTimeout(activityCheckpointTimeoutRef.current)\n    clearTimeout(forceLogOutTimeoutRef.current)\n    clearTimeout(reminderTimeoutRef.current)\n    clearTimeout(scheduledRefreshTimeoutRef.current)\n    removeActivityListeners()\n    activityTracker.reset()\n    lastSessionActivityAtRef.current = undefined\n  }, [activityTracker, removeActivityListeners])\n\n  const clear = useCallback(() => {\n    resetSessionLifecycle()\n    hasActiveSessionRef.current = false\n    sessionTimingRef.current = undefined\n    tokenExpirationMsRef.current = undefined\n  }, [resetSessionLifecycle])\n\n  const setExpiration = useCallback(\n    (expirationMs: number) => {\n      if (!Number.isFinite(expirationMs)) {\n        return\n      }\n\n      resetSessionLifecycle()\n      tokenExpirationMsRef.current = expirationMs\n\n      const sessionTiming = getAuthSessionTiming({ expirationMs })\n\n      sessionTimingRef.current = sessionTiming\n\n      const scheduleReminder = () => {\n        if (tokenExpirationMsRef.current !== expirationMs) {\n          return\n        }\n\n        const reminderStartsInMs = Math.max(sessionTiming.reminderStartsAt - Date.now(), 0)\n\n        reminderTimeoutRef.current = setTimeout(\n          () => {\n            if (tokenExpirationMsRef.current !== expirationMs) {\n              return\n            }\n\n            if (Date.now() < sessionTiming.reminderStartsAt) {\n              scheduleReminder()\n              return\n            }\n\n            clearTimeout(scheduledRefreshTimeoutRef.current)\n            removeActivityListeners()\n\n            if (Date.now() < sessionTiming.expiresAt) {\n              callbacksRef.current.onReminder()\n            }\n          },\n          Math.min(reminderStartsInMs, maxTimeoutMs),\n        )\n      }\n\n      const scheduleActivityCheckpoint = () => {\n        if (tokenExpirationMsRef.current !== expirationMs) {\n          return\n        }\n\n        const refreshStartsInMs = Math.max(sessionTiming.refreshStartsAt - Date.now(), 0)\n\n        activityCheckpointTimeoutRef.current = setTimeout(\n          () => {\n            if (tokenExpirationMsRef.current !== expirationMs) {\n              return\n            }\n\n            const checkpointAt = Date.now()\n\n            if (checkpointAt < sessionTiming.refreshStartsAt) {\n              scheduleActivityCheckpoint()\n              return\n            }\n\n            const lastActivityAt = lastSessionActivityAtRef.current\n            const hasRecentActivity =\n              lastActivityAt !== undefined &&\n              checkpointAt < sessionTiming.reminderStartsAt &&\n              lastActivityAt >= sessionTiming.activityTrackingStartsAt\n\n            if (hasRecentActivity) {\n              scheduleRefresh(true)\n            }\n          },\n          Math.min(refreshStartsInMs, maxTimeoutMs),\n        )\n      }\n\n      const scheduleExpiration = () => {\n        if (tokenExpirationMsRef.current !== expirationMs) {\n          return\n        }\n\n        const expiresInMs = Math.max(sessionTiming.expiresAt - Date.now(), 0)\n\n        forceLogOutTimeoutRef.current = setTimeout(\n          () => {\n            if (tokenExpirationMsRef.current === expirationMs) {\n              if (Date.now() < sessionTiming.expiresAt) {\n                scheduleExpiration()\n                return\n              }\n\n              hasActiveSessionRef.current = false\n              removeActivityListeners()\n              callbacksRef.current.onExpire(expirationMs)\n            }\n          },\n          Math.min(expiresInMs, maxTimeoutMs),\n        )\n      }\n\n      hasActiveSessionRef.current = expirationMs > Date.now()\n\n      if (hasActiveSessionRef.current) {\n        addActivityListeners()\n        scheduleReminder()\n        scheduleActivityCheckpoint()\n      }\n\n      scheduleExpiration()\n\n      return sessionTiming\n    },\n    [addActivityListeners, removeActivityListeners, resetSessionLifecycle, scheduleRefresh],\n  )\n\n  const getCurrentExpirationMs = useCallback(() => tokenExpirationMsRef.current, [])\n\n  useEffect(() => {\n    callbacksRef.current = { onActivity, onActivityRefresh, onExpire, onReminder }\n  }, [onActivity, onActivityRefresh, onExpire, onReminder])\n\n  useEffect(() => {\n    hasActiveSessionRef.current = isAuthenticated\n\n    if (!isAuthenticated) {\n      removeActivityListeners()\n    }\n  }, [isAuthenticated, removeActivityListeners])\n\n  useEffect(() => {\n    return clear\n  }, [clear])\n\n  return useMemo(\n    () => ({\n      clear,\n      getCurrentExpirationMs,\n      recordActivity,\n      scheduleRefresh,\n      setExpiration,\n    }),\n    [clear, getCurrentExpirationMs, recordActivity, scheduleRefresh, setExpiration],\n  )\n}\n"],"mappings":"AAAA;;AACA,SAASA,WAAW,EAAEC,SAAS,EAAEC,OAAO,EAAEC,MAAM,QAAQ;AAKxD,SACEC,4BAA4B,EAC5BC,gCAAgC,QAC3B;AACP,SAASC,oBAAoB,QAAQ;AAErC,MAAMC,YAAA,GAAe,cAAc;AAAA;AAmBnC;;;;;;;AAOA,OAAO,SAASC,qBAAqB;EACnCC,eAAe;EACfC,UAAU;EACVC,iBAAiB;EACjBC,QAAQ;EACRC;AAAU,CACe;EACzB,MAAMC,0BAAA,GAA6BX,MAAA,CAAiCY,SAAA;EACpE,MAAMC,4BAAA,GAA+Bb,MAAA,CAAsC;EAC3E,MAAMc,qBAAA,GAAwBd,MAAA,CAAsC;EACpE,MAAMe,mBAAA,GAAsBf,MAAA,CAAOM,eAAA;EACnC,MAAMU,wBAAA,GAA2BhB,MAAA,CAAeY,SAAA;EAChD,MAAMK,0BAAA,GAA6BjB,MAAA,CAAsC;EACzE,MAAMkB,kBAAA,GAAqBlB,MAAA,CAAsC;EACjE,MAAMmB,gBAAA,GAAmBnB,MAAA,CAA0BY,SAAA;EACnD,MAAMQ,oBAAA,GAAuBpB,MAAA,CAAeY,SAAA;EAC5C,MAAMS,YAAA,GAAerB,MAAA,CAAO;IAAEO,UAAA;IAAYC,iBAAA;IAAmBC,QAAA;IAAUC;EAAW;EAElF,MAAMY,eAAA,GAAkBzB,WAAA,CAAa0B,YAAA;IACnC,IAAI,CAACR,mBAAA,CAAoBS,OAAO,EAAE;MAChC;IACF;IAEA,MAAMC,aAAA,GAAgBN,gBAAA,CAAiBK,OAAO;IAE9C,IAAID,YAAA,IAAiBE,aAAA,IAAiBC,IAAA,CAAKC,GAAG,MAAMF,aAAA,CAAcG,eAAe,EAAG;MAClFC,YAAA,CAAaZ,0BAAA,CAA2BO,OAAO;MAC/CP,0BAAA,CAA2BO,OAAO,GAAGM,UAAA,CAAW;QAC9CT,YAAA,CAAaG,OAAO,CAAChB,iBAAiB;MACxC,GAAG;IACL;EACF,GAAG,EAAE;EAEL,MAAMuB,eAAA,GAAkBhC,OAAA,CACtB,MACEE,4BAAA,CAA6B;IAC3BM,UAAA,EAAYA,CAACyB,OAAA,EAASC,UAAA;MACpB,MAAMC,eAAA,GAAkBlB,wBAAA,CAAyBQ,OAAO,KAAKZ,SAAA;MAE7DI,wBAAA,CAAyBQ,OAAO,GAAGS,UAAA;MAEnC,IAAIC,eAAA,EAAiB;QACnBb,YAAA,CAAaG,OAAO,CAACjB,UAAU;MACjC;MAEAe,eAAA;IACF;EACF,IACF,CAACA,eAAA,CAAgB;EAGnB,MAAMa,cAAA,GAAiBtC,WAAA,CACpBuC,MAAA;IACC,MAAMH,YAAA,GAAaP,IAAA,CAAKC,GAAG;IAC3B,MAAMF,eAAA,GAAgBN,gBAAA,CAAiBK,OAAO;IAC9C,MAAMa,oBAAA,GACJZ,eAAA,IACAQ,YAAA,IAAcR,eAAA,CAAca,wBAAwB,IACpDL,YAAA,GAAaR,eAAA,CAAcc,gBAAgB;IAE7C,IAAI,CAAC5B,0BAAA,CAA2Ba,OAAO,IAAI,CAACa,oBAAA,EAAsB;MAChE,OAAO;IACT;IAEA,OAAON,eAAA,CAAgBS,MAAM,CAACJ,MAAA;EAChC,GACA,CAACL,eAAA,CAAgB;EAGnB,MAAMU,oBAAA,GAAuB5C,WAAA,CAAY;IACvC,IAAIc,0BAAA,CAA2Ba,OAAO,EAAE;MACtC;IACF;IAEAb,0BAAA,CAA2Ba,OAAO,GAAGtB,gCAAA,CAAiC;MACpEwC,YAAA,EAAcP,cAAA;MACdQ;IACF;EACF,GAAG,CAACR,cAAA,CAAe;EAEnB,MAAMS,uBAAA,GAA0B/C,WAAA,CAAY;IAC1C,MAAMgD,OAAA,GAAUlC,0BAAA,CAA2Ba,OAAO;IAElD,IAAI,CAACqB,OAAA,EAAS;MACZ;IACF;IAEAlC,0BAAA,CAA2Ba,OAAO,GAAGZ,SAAA;IACrCiC,OAAA;EACF,GAAG,EAAE;EAEL,MAAMC,qBAAA,GAAwBjD,WAAA,CAAY;IACxCgC,YAAA,CAAahB,4BAAA,CAA6BW,OAAO;IACjDK,YAAA,CAAaf,qBAAA,CAAsBU,OAAO;IAC1CK,YAAA,CAAaX,kBAAA,CAAmBM,OAAO;IACvCK,YAAA,CAAaZ,0BAAA,CAA2BO,OAAO;IAC/CoB,uBAAA;IACAb,eAAA,CAAgBgB,KAAK;IACrB/B,wBAAA,CAAyBQ,OAAO,GAAGZ,SAAA;EACrC,GAAG,CAACmB,eAAA,EAAiBa,uBAAA,CAAwB;EAE7C,MAAMI,KAAA,GAAQnD,WAAA,CAAY;IACxBiD,qBAAA;IACA/B,mBAAA,CAAoBS,OAAO,GAAG;IAC9BL,gBAAA,CAAiBK,OAAO,GAAGZ,SAAA;IAC3BQ,oBAAA,CAAqBI,OAAO,GAAGZ,SAAA;EACjC,GAAG,CAACkC,qBAAA,CAAsB;EAE1B,MAAMG,aAAA,GAAgBpD,WAAA,CACnBqD,YAAA;IACC,IAAI,CAACC,MAAA,CAAOC,QAAQ,CAACF,YAAA,GAAe;MAClC;IACF;IAEAJ,qBAAA;IACA1B,oBAAA,CAAqBI,OAAO,GAAG0B,YAAA;IAE/B,MAAMzB,eAAA,GAAgBtB,oBAAA,CAAqB;MAAE+C;IAAa;IAE1D/B,gBAAA,CAAiBK,OAAO,GAAGC,eAAA;IAE3B,MAAM4B,gBAAA,GAAmBA,CAAA;MACvB,IAAIjC,oBAAA,CAAqBI,OAAO,KAAK0B,YAAA,EAAc;QACjD;MACF;MAEA,MAAMI,kBAAA,GAAqBC,IAAA,CAAKC,GAAG,CAAC/B,eAAA,CAAcc,gBAAgB,GAAGb,IAAA,CAAKC,GAAG,IAAI;MAEjFT,kBAAA,CAAmBM,OAAO,GAAGM,UAAA,CAC3B;QACE,IAAIV,oBAAA,CAAqBI,OAAO,KAAK0B,YAAA,EAAc;UACjD;QACF;QAEA,IAAIxB,IAAA,CAAKC,GAAG,KAAKF,eAAA,CAAcc,gBAAgB,EAAE;UAC/Cc,gBAAA;UACA;QACF;QAEAxB,YAAA,CAAaZ,0BAAA,CAA2BO,OAAO;QAC/CoB,uBAAA;QAEA,IAAIlB,IAAA,CAAKC,GAAG,KAAKF,eAAA,CAAcgC,SAAS,EAAE;UACxCpC,YAAA,CAAaG,OAAO,CAACd,UAAU;QACjC;MACF,GACA6C,IAAA,CAAKG,GAAG,CAACJ,kBAAA,EAAoBlD,YAAA;IAEjC;IAEA,MAAMuD,0BAAA,GAA6BA,CAAA;MACjC,IAAIvC,oBAAA,CAAqBI,OAAO,KAAK0B,YAAA,EAAc;QACjD;MACF;MAEA,MAAMU,iBAAA,GAAoBL,IAAA,CAAKC,GAAG,CAAC/B,eAAA,CAAcG,eAAe,GAAGF,IAAA,CAAKC,GAAG,IAAI;MAE/Ed,4BAAA,CAA6BW,OAAO,GAAGM,UAAA,CACrC;QACE,IAAIV,oBAAA,CAAqBI,OAAO,KAAK0B,YAAA,EAAc;UACjD;QACF;QAEA,MAAMW,YAAA,GAAenC,IAAA,CAAKC,GAAG;QAE7B,IAAIkC,YAAA,GAAepC,eAAA,CAAcG,eAAe,EAAE;UAChD+B,0BAAA;UACA;QACF;QAEA,MAAMG,cAAA,GAAiB9C,wBAAA,CAAyBQ,OAAO;QACvD,MAAMuC,iBAAA,GACJD,cAAA,KAAmBlD,SAAA,IACnBiD,YAAA,GAAepC,eAAA,CAAcc,gBAAgB,IAC7CuB,cAAA,IAAkBrC,eAAA,CAAca,wBAAwB;QAE1D,IAAIyB,iBAAA,EAAmB;UACrBzC,eAAA,CAAgB;QAClB;MACF,GACAiC,IAAA,CAAKG,GAAG,CAACE,iBAAA,EAAmBxD,YAAA;IAEhC;IAEA,MAAM4D,kBAAA,GAAqBA,CAAA;MACzB,IAAI5C,oBAAA,CAAqBI,OAAO,KAAK0B,YAAA,EAAc;QACjD;MACF;MAEA,MAAMe,WAAA,GAAcV,IAAA,CAAKC,GAAG,CAAC/B,eAAA,CAAcgC,SAAS,GAAG/B,IAAA,CAAKC,GAAG,IAAI;MAEnEb,qBAAA,CAAsBU,OAAO,GAAGM,UAAA,CAC9B;QACE,IAAIV,oBAAA,CAAqBI,OAAO,KAAK0B,YAAA,EAAc;UACjD,IAAIxB,IAAA,CAAKC,GAAG,KAAKF,eAAA,CAAcgC,SAAS,EAAE;YACxCO,kBAAA;YACA;UACF;UAEAjD,mBAAA,CAAoBS,OAAO,GAAG;UAC9BoB,uBAAA;UACAvB,YAAA,CAAaG,OAAO,CAACf,QAAQ,CAACyC,YAAA;QAChC;MACF,GACAK,IAAA,CAAKG,GAAG,CAACO,WAAA,EAAa7D,YAAA;IAE1B;IAEAW,mBAAA,CAAoBS,OAAO,GAAG0B,YAAA,GAAexB,IAAA,CAAKC,GAAG;IAErD,IAAIZ,mBAAA,CAAoBS,OAAO,EAAE;MAC/BiB,oBAAA;MACAY,gBAAA;MACAM,0BAAA;IACF;IAEAK,kBAAA;IAEA,OAAOvC,eAAA;EACT,GACA,CAACgB,oBAAA,EAAsBG,uBAAA,EAAyBE,qBAAA,EAAuBxB,eAAA,CAAgB;EAGzF,MAAM4C,sBAAA,GAAyBrE,WAAA,CAAY,MAAMuB,oBAAA,CAAqBI,OAAO,EAAE,EAAE;EAEjF1B,SAAA,CAAU;IACRuB,YAAA,CAAaG,OAAO,GAAG;MAAEjB,UAAA;MAAYC,iBAAA;MAAmBC,QAAA;MAAUC;IAAW;EAC/E,GAAG,CAACH,UAAA,EAAYC,iBAAA,EAAmBC,QAAA,EAAUC,UAAA,CAAW;EAExDZ,SAAA,CAAU;IACRiB,mBAAA,CAAoBS,OAAO,GAAGlB,eAAA;IAE9B,IAAI,CAACA,eAAA,EAAiB;MACpBsC,uBAAA;IACF;EACF,GAAG,CAACtC,eAAA,EAAiBsC,uBAAA,CAAwB;EAE7C9C,SAAA,CAAU;IACR,OAAOkD,KAAA;EACT,GAAG,CAACA,KAAA,CAAM;EAEV,OAAOjD,OAAA,CACL,OAAO;IACLiD,KAAA;IACAkB,sBAAA;IACA/B,cAAA;IACAb,eAAA;IACA2B;EACF,IACA,CAACD,KAAA,EAAOkB,sBAAA,EAAwB/B,cAAA,EAAgBb,eAAA,EAAiB2B,aAAA,CAAc;AAEnF","ignoreList":[]}

package/dist/providers/Auth/useAuthSessionTimers.spec.js

@@ -0,0 +1,311 @@
+// @vitest-environment jsdom
+import React, { act } from 'react';
+import { createRoot } from 'react-dom/client';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { getAuthSessionTiming } from './sessionTiming.js';
+import { useAuthSessionTimers } from './useAuthSessionTimers.js';
+const timerCleanups = [];
+beforeEach(() => {
+  vi.useFakeTimers();
+  vi.setSystemTime(new Date('2026-01-01T00:00:00.000Z'));
+});
+afterEach(() => {
+  for (const cleanup of timerCleanups.splice(0)) {
+    cleanup();
+  }
+  vi.useRealTimers();
+});
+describe('useAuthSessionTimers', () => {
+  it('should scale session timing for tokens shorter than two minutes', () => {
+    const nowMs = Date.now();
+    const expirationMs = nowMs + 30_000;
+    expect(getAuthSessionTiming({
+      expirationMs,
+      nowMs
+    })).toEqual({
+      activityTrackingStartsAt: nowMs,
+      expiresAt: expirationMs,
+      refreshStartsAt: nowMs,
+      reminderStartsAt: nowMs + 15_000
+    });
+  });
+  it('should return the lifecycle timing when setting an expiration', () => {
+    const timers = renderAuthSessionTimers();
+    const expirationMs = Date.now() + 300_000;
+    expect(timers.setExpiration(expirationMs)).toEqual({
+      activityTrackingStartsAt: expirationMs - 240_000,
+      expiresAt: expirationMs,
+      refreshStartsAt: expirationMs - 120_000,
+      reminderStartsAt: expirationMs - 60_000
+    });
+  });
+  it('should refresh at the checkpoint when activity occurred in the tracking window', () => {
+    const onActivity = vi.fn();
+    const onActivityRefresh = vi.fn();
+    const timers = renderAuthSessionTimers({
+      onActivity,
+      onActivityRefresh
+    });
+    timers.setExpiration(Date.now() + 300_000);
+    act(() => {
+      vi.advanceTimersByTime(120_000);
+      window.dispatchEvent(new MouseEvent('mousemove'));
+      vi.advanceTimersByTime(1_000);
+      window.dispatchEvent(new KeyboardEvent('keydown'));
+      vi.advanceTimersByTime(59_000);
+      vi.advanceTimersByTime(1_000);
+    });
+    expect(onActivity).toHaveBeenCalledOnce();
+    expect(onActivityRefresh).toHaveBeenCalledTimes(1);
+  });
+  it('should ignore activity once the expiration reminder opens', () => {
+    const onActivityRefresh = vi.fn();
+    const timers = renderAuthSessionTimers({
+      onActivityRefresh
+    });
+    const sessionStartedAt = Date.now();
+    timers.setExpiration(sessionStartedAt + 300_000);
+    act(() => {
+      vi.advanceTimersByTime(60_000);
+    });
+    vi.setSystemTime(sessionStartedAt + 240_000);
+    expect(timers.recordActivity('route')).toBe(false);
+    expect(onActivityRefresh).not.toHaveBeenCalled();
+  });
+  it('should clear timers and listeners on logout', () => {
+    const onActivityRefresh = vi.fn();
+    const onExpire = vi.fn();
+    const timers = renderAuthSessionTimers({
+      onActivityRefresh,
+      onExpire
+    });
+    timers.setExpiration(Date.now() + 300_000);
+    timers.clear();
+    act(() => {
+      window.dispatchEvent(new MouseEvent('mousemove'));
+      vi.advanceTimersByTime(300_000);
+    });
+    expect(onActivityRefresh).not.toHaveBeenCalled();
+    expect(onExpire).not.toHaveBeenCalled();
+  });
+  it('should schedule the reminder and expiration from the current expiration', () => {
+    const onExpire = vi.fn();
+    const onReminder = vi.fn();
+    const timers = renderAuthSessionTimers({
+      onExpire,
+      onReminder
+    });
+    const expirationMs = Date.now() + 300_000;
+    timers.setExpiration(expirationMs);
+    act(() => {
+      vi.advanceTimersByTime(240_000);
+    });
+    expect(onReminder).toHaveBeenCalledTimes(1);
+    expect(onExpire).not.toHaveBeenCalled();
+    act(() => {
+      vi.advanceTimersByTime(60_000);
+    });
+    expect(onExpire).toHaveBeenCalledWith(expirationMs);
+  });
+  it('should respect expirations beyond the maximum browser timeout', () => {
+    const onExpire = vi.fn();
+    const timers = renderAuthSessionTimers({
+      onExpire
+    });
+    const thirtyDaysMs = 2_592_000_000;
+    const maximumBrowserTimeoutMs = 2_147_483_647;
+    const expirationMs = Date.now() + thirtyDaysMs;
+    timers.setExpiration(expirationMs);
+    act(() => {
+      vi.advanceTimersByTime(maximumBrowserTimeoutMs);
+    });
+    expect(onExpire).not.toHaveBeenCalled();
+    act(() => {
+      vi.advanceTimersByTime(thirtyDaysMs - maximumBrowserTimeoutMs - 1);
+    });
+    expect(onExpire).not.toHaveBeenCalled();
+    act(() => {
+      vi.advanceTimersByTime(1);
+    });
+    expect(onExpire).toHaveBeenCalledOnce();
+    expect(onExpire).toHaveBeenCalledWith(expirationMs);
+  });
+  it('should schedule expiration when the token expires exactly now', () => {
+    const onActivityRefresh = vi.fn();
+    const onExpire = vi.fn();
+    const onReminder = vi.fn();
+    const timers = renderAuthSessionTimers({
+      isAuthenticated: false,
+      onActivityRefresh,
+      onExpire,
+      onReminder
+    });
+    const expirationMs = Date.now();
+    timers.setExpiration(expirationMs);
+    expect(onExpire).not.toHaveBeenCalled();
+    act(() => {
+      vi.advanceTimersByTime(0);
+    });
+    expect(onExpire).toHaveBeenCalledOnce();
+    expect(onExpire).toHaveBeenCalledWith(expirationMs);
+    expect(onActivityRefresh).not.toHaveBeenCalled();
+    expect(onReminder).not.toHaveBeenCalled();
+  });
+  it('should schedule expiration when the token is already past', () => {
+    const onActivityRefresh = vi.fn();
+    const onExpire = vi.fn();
+    const onReminder = vi.fn();
+    const timers = renderAuthSessionTimers({
+      isAuthenticated: false,
+      onActivityRefresh,
+      onExpire,
+      onReminder
+    });
+    const expirationMs = Date.now() - 1;
+    timers.setExpiration(expirationMs);
+    act(() => {
+      vi.advanceTimersByTime(0);
+    });
+    expect(onExpire).toHaveBeenCalledOnce();
+    expect(onExpire).toHaveBeenCalledWith(expirationMs);
+    expect(onActivityRefresh).not.toHaveBeenCalled();
+    expect(onReminder).not.toHaveBeenCalled();
+  });
+  it('should reject a non-finite expiration without activating the session', () => {
+    const onActivityRefresh = vi.fn();
+    const onExpire = vi.fn();
+    const timers = renderAuthSessionTimers({
+      isAuthenticated: false,
+      onActivityRefresh,
+      onExpire
+    });
+    timers.setExpiration(Number.NaN);
+    timers.scheduleRefresh(true);
+    act(() => {
+      vi.advanceTimersByTime(1_000);
+    });
+    expect(timers.getCurrentExpirationMs()).toBeUndefined();
+    expect(onActivityRefresh).not.toHaveBeenCalled();
+    expect(onExpire).not.toHaveBeenCalled();
+  });
+  it('should synchronously activate on apply and deactivate on clear', () => {
+    const onActivityRefresh = vi.fn();
+    const timers = renderAuthSessionTimers({
+      isAuthenticated: false,
+      onActivityRefresh
+    });
+    timers.clear();
+    timers.setExpiration(Date.now() + 300_000);
+    timers.scheduleRefresh(true);
+    act(() => {
+      vi.advanceTimersByTime(1_000);
+    });
+    expect(onActivityRefresh).toHaveBeenCalledOnce();
+    timers.clear();
+    timers.scheduleRefresh(true);
+    act(() => {
+      vi.advanceTimersByTime(1_000);
+    });
+    expect(onActivityRefresh).toHaveBeenCalledOnce();
+  });
+  it('should reset tracked activity when replacing the expiration', () => {
+    const onActivity = vi.fn();
+    const onActivityRefresh = vi.fn();
+    const timers = renderAuthSessionTimers({
+      onActivity,
+      onActivityRefresh
+    });
+    const expirationMs = Date.now() + 300_000;
+    timers.setExpiration(expirationMs);
+    act(() => {
+      vi.advanceTimersByTime(60_000);
+    });
+    expect(timers.recordActivity('route')).toBe(true);
+    expect(onActivity).toHaveBeenCalledOnce();
+    timers.setExpiration(expirationMs);
+    expect(timers.recordActivity('route')).toBe(true);
+    expect(onActivity).toHaveBeenCalledTimes(2);
+    act(() => {
+      vi.advanceTimersByTime(120_000);
+      vi.advanceTimersByTime(1_000);
+    });
+    expect(onActivityRefresh).toHaveBeenCalledOnce();
+  });
+  it('should keep its controller and activity throttle across rerenders', () => {
+    const onActivityRefresh = vi.fn();
+    const timers = renderAuthSessionTimers({
+      onActivityRefresh
+    });
+    const initialController = timers.getController();
+    timers.setExpiration(Date.now() + 300_000);
+    act(() => {
+      vi.advanceTimersByTime(238_000);
+      window.dispatchEvent(new MouseEvent('mousemove'));
+    });
+    timers.rerender();
+    expect(timers.getController()).toBe(initialController);
+    act(() => {
+      vi.advanceTimersByTime(1);
+      window.dispatchEvent(new MouseEvent('mousemove'));
+      vi.advanceTimersByTime(999);
+    });
+    expect(onActivityRefresh).toHaveBeenCalledTimes(1);
+  });
+  it('should synchronously replace the current expiration', () => {
+    const timers = renderAuthSessionTimers();
+    const firstExpirationMs = Date.now() + 300_000;
+    const replacementExpirationMs = Date.now() + 600_000;
+    timers.setExpiration(firstExpirationMs);
+    timers.setExpiration(replacementExpirationMs);
+    expect(timers.getCurrentExpirationMs()).toBe(replacementExpirationMs);
+  });
+});
+function renderAuthSessionTimers({
+  isAuthenticated = true,
+  onActivity = vi.fn(),
+  onActivityRefresh = vi.fn(),
+  onExpire = vi.fn(),
+  onReminder = vi.fn()
+} = {}) {
+  let controller;
+  const container = document.createElement('div');
+  const root = createRoot(container);
+  function SessionTimers() {
+    controller = useAuthSessionTimers({
+      isAuthenticated,
+      onActivity,
+      onActivityRefresh,
+      onExpire,
+      onReminder
+    });
+    return null;
+  }
+  act(() => {
+    root.render(React.createElement(SessionTimers));
+  });
+  timerCleanups.push(() => {
+    act(() => {
+      root.unmount();
+    });
+  });
+  const getController = () => {
+    if (!controller) {
+      throw new Error('Expected auth session timers.');
+    }
+    return controller;
+  };
+  return {
+    clear: () => getController().clear(),
+    getController,
+    getCurrentExpirationMs: () => getController().getCurrentExpirationMs(),
+    rerender: () => {
+      act(() => {
+        root.render(React.createElement(SessionTimers));
+      });
+    },
+    recordActivity: source => getController().recordActivity(source),
+    scheduleRefresh: forceRefresh => getController().scheduleRefresh(forceRefresh),
+    setExpiration: expirationMs => getController().setExpiration(expirationMs)
+  };
+}
+//# sourceMappingURL=useAuthSessionTimers.spec.js.map

package/dist/providers/Auth/useAuthSessionTimers.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAuthSessionTimers.spec.js","names":["React","act","createRoot","afterEach","beforeEach","describe","expect","it","vi","getAuthSessionTiming","useAuthSessionTimers","timerCleanups","useFakeTimers","setSystemTime","Date","cleanup","splice","useRealTimers","nowMs","now","expirationMs","toEqual","activityTrackingStartsAt","expiresAt","refreshStartsAt","reminderStartsAt","timers","renderAuthSessionTimers","setExpiration","onActivity","fn","onActivityRefresh","advanceTimersByTime","window","dispatchEvent","MouseEvent","KeyboardEvent","toHaveBeenCalledOnce","toHaveBeenCalledTimes","sessionStartedAt","recordActivity","toBe","not","toHaveBeenCalled","onExpire","clear","onReminder","toHaveBeenCalledWith","thirtyDaysMs","maximumBrowserTimeoutMs","isAuthenticated","Number","NaN","scheduleRefresh","getCurrentExpirationMs","toBeUndefined","initialController","getController","rerender","firstExpirationMs","replacementExpirationMs","controller","container","document","createElement","root","SessionTimers","render","push","unmount","Error","source","forceRefresh"],"sources":["../../../src/providers/Auth/useAuthSessionTimers.spec.ts"],"sourcesContent":["// @vitest-environment jsdom\nimport React, { act } from 'react'\nimport { createRoot } from 'react-dom/client'\nimport { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'\n\nimport type { AuthSessionTimers } from './useAuthSessionTimers.js'\n\nimport { getAuthSessionTiming } from './sessionTiming.js'\nimport { useAuthSessionTimers } from './useAuthSessionTimers.js'\n\nconst timerCleanups: Array<() => void> = []\n\nbeforeEach(() => {\n  vi.useFakeTimers()\n  vi.setSystemTime(new Date('2026-01-01T00:00:00.000Z'))\n})\n\nafterEach(() => {\n  for (const cleanup of timerCleanups.splice(0)) {\n    cleanup()\n  }\n\n  vi.useRealTimers()\n})\n\ndescribe('useAuthSessionTimers', () => {\n  it('should scale session timing for tokens shorter than two minutes', () => {\n    const nowMs = Date.now()\n    const expirationMs = nowMs + 30_000\n\n    expect(getAuthSessionTiming({ expirationMs, nowMs })).toEqual({\n      activityTrackingStartsAt: nowMs,\n      expiresAt: expirationMs,\n      refreshStartsAt: nowMs,\n      reminderStartsAt: nowMs + 15_000,\n    })\n  })\n\n  it('should return the lifecycle timing when setting an expiration', () => {\n    const timers = renderAuthSessionTimers()\n    const expirationMs = Date.now() + 300_000\n\n    expect(timers.setExpiration(expirationMs)).toEqual({\n      activityTrackingStartsAt: expirationMs - 240_000,\n      expiresAt: expirationMs,\n      refreshStartsAt: expirationMs - 120_000,\n      reminderStartsAt: expirationMs - 60_000,\n    })\n  })\n\n  it('should refresh at the checkpoint when activity occurred in the tracking window', () => {\n    const onActivity = vi.fn()\n    const onActivityRefresh = vi.fn()\n    const timers = renderAuthSessionTimers({ onActivity, onActivityRefresh })\n\n    timers.setExpiration(Date.now() + 300_000)\n    act(() => {\n      vi.advanceTimersByTime(120_000)\n      window.dispatchEvent(new MouseEvent('mousemove'))\n      vi.advanceTimersByTime(1_000)\n      window.dispatchEvent(new KeyboardEvent('keydown'))\n      vi.advanceTimersByTime(59_000)\n      vi.advanceTimersByTime(1_000)\n    })\n\n    expect(onActivity).toHaveBeenCalledOnce()\n    expect(onActivityRefresh).toHaveBeenCalledTimes(1)\n  })\n\n  it('should ignore activity once the expiration reminder opens', () => {\n    const onActivityRefresh = vi.fn()\n    const timers = renderAuthSessionTimers({ onActivityRefresh })\n    const sessionStartedAt = Date.now()\n\n    timers.setExpiration(sessionStartedAt + 300_000)\n    act(() => {\n      vi.advanceTimersByTime(60_000)\n    })\n    vi.setSystemTime(sessionStartedAt + 240_000)\n\n    expect(timers.recordActivity('route')).toBe(false)\n    expect(onActivityRefresh).not.toHaveBeenCalled()\n  })\n\n  it('should clear timers and listeners on logout', () => {\n    const onActivityRefresh = vi.fn()\n    const onExpire = vi.fn()\n    const timers = renderAuthSessionTimers({ onActivityRefresh, onExpire })\n\n    timers.setExpiration(Date.now() + 300_000)\n    timers.clear()\n    act(() => {\n      window.dispatchEvent(new MouseEvent('mousemove'))\n      vi.advanceTimersByTime(300_000)\n    })\n\n    expect(onActivityRefresh).not.toHaveBeenCalled()\n    expect(onExpire).not.toHaveBeenCalled()\n  })\n\n  it('should schedule the reminder and expiration from the current expiration', () => {\n    const onExpire = vi.fn()\n    const onReminder = vi.fn()\n    const timers = renderAuthSessionTimers({ onExpire, onReminder })\n    const expirationMs = Date.now() + 300_000\n\n    timers.setExpiration(expirationMs)\n    act(() => {\n      vi.advanceTimersByTime(240_000)\n    })\n\n    expect(onReminder).toHaveBeenCalledTimes(1)\n    expect(onExpire).not.toHaveBeenCalled()\n\n    act(() => {\n      vi.advanceTimersByTime(60_000)\n    })\n\n    expect(onExpire).toHaveBeenCalledWith(expirationMs)\n  })\n\n  it('should respect expirations beyond the maximum browser timeout', () => {\n    const onExpire = vi.fn()\n    const timers = renderAuthSessionTimers({ onExpire })\n    const thirtyDaysMs = 2_592_000_000\n    const maximumBrowserTimeoutMs = 2_147_483_647\n    const expirationMs = Date.now() + thirtyDaysMs\n\n    timers.setExpiration(expirationMs)\n\n    act(() => {\n      vi.advanceTimersByTime(maximumBrowserTimeoutMs)\n    })\n\n    expect(onExpire).not.toHaveBeenCalled()\n\n    act(() => {\n      vi.advanceTimersByTime(thirtyDaysMs - maximumBrowserTimeoutMs - 1)\n    })\n\n    expect(onExpire).not.toHaveBeenCalled()\n\n    act(() => {\n      vi.advanceTimersByTime(1)\n    })\n\n    expect(onExpire).toHaveBeenCalledOnce()\n    expect(onExpire).toHaveBeenCalledWith(expirationMs)\n  })\n\n  it('should schedule expiration when the token expires exactly now', () => {\n    const onActivityRefresh = vi.fn()\n    const onExpire = vi.fn()\n    const onReminder = vi.fn()\n    const timers = renderAuthSessionTimers({\n      isAuthenticated: false,\n      onActivityRefresh,\n      onExpire,\n      onReminder,\n    })\n    const expirationMs = Date.now()\n\n    timers.setExpiration(expirationMs)\n\n    expect(onExpire).not.toHaveBeenCalled()\n\n    act(() => {\n      vi.advanceTimersByTime(0)\n    })\n\n    expect(onExpire).toHaveBeenCalledOnce()\n    expect(onExpire).toHaveBeenCalledWith(expirationMs)\n    expect(onActivityRefresh).not.toHaveBeenCalled()\n    expect(onReminder).not.toHaveBeenCalled()\n  })\n\n  it('should schedule expiration when the token is already past', () => {\n    const onActivityRefresh = vi.fn()\n    const onExpire = vi.fn()\n    const onReminder = vi.fn()\n    const timers = renderAuthSessionTimers({\n      isAuthenticated: false,\n      onActivityRefresh,\n      onExpire,\n      onReminder,\n    })\n    const expirationMs = Date.now() - 1\n\n    timers.setExpiration(expirationMs)\n\n    act(() => {\n      vi.advanceTimersByTime(0)\n    })\n\n    expect(onExpire).toHaveBeenCalledOnce()\n    expect(onExpire).toHaveBeenCalledWith(expirationMs)\n    expect(onActivityRefresh).not.toHaveBeenCalled()\n    expect(onReminder).not.toHaveBeenCalled()\n  })\n\n  it('should reject a non-finite expiration without activating the session', () => {\n    const onActivityRefresh = vi.fn()\n    const onExpire = vi.fn()\n    const timers = renderAuthSessionTimers({\n      isAuthenticated: false,\n      onActivityRefresh,\n      onExpire,\n    })\n\n    timers.setExpiration(Number.NaN)\n    timers.scheduleRefresh(true)\n    act(() => {\n      vi.advanceTimersByTime(1_000)\n    })\n\n    expect(timers.getCurrentExpirationMs()).toBeUndefined()\n    expect(onActivityRefresh).not.toHaveBeenCalled()\n    expect(onExpire).not.toHaveBeenCalled()\n  })\n\n  it('should synchronously activate on apply and deactivate on clear', () => {\n    const onActivityRefresh = vi.fn()\n    const timers = renderAuthSessionTimers({ isAuthenticated: false, onActivityRefresh })\n\n    timers.clear()\n    timers.setExpiration(Date.now() + 300_000)\n    timers.scheduleRefresh(true)\n    act(() => {\n      vi.advanceTimersByTime(1_000)\n    })\n\n    expect(onActivityRefresh).toHaveBeenCalledOnce()\n\n    timers.clear()\n    timers.scheduleRefresh(true)\n    act(() => {\n      vi.advanceTimersByTime(1_000)\n    })\n\n    expect(onActivityRefresh).toHaveBeenCalledOnce()\n  })\n\n  it('should reset tracked activity when replacing the expiration', () => {\n    const onActivity = vi.fn()\n    const onActivityRefresh = vi.fn()\n    const timers = renderAuthSessionTimers({ onActivity, onActivityRefresh })\n    const expirationMs = Date.now() + 300_000\n\n    timers.setExpiration(expirationMs)\n    act(() => {\n      vi.advanceTimersByTime(60_000)\n    })\n    expect(timers.recordActivity('route')).toBe(true)\n    expect(onActivity).toHaveBeenCalledOnce()\n\n    timers.setExpiration(expirationMs)\n\n    expect(timers.recordActivity('route')).toBe(true)\n    expect(onActivity).toHaveBeenCalledTimes(2)\n\n    act(() => {\n      vi.advanceTimersByTime(120_000)\n      vi.advanceTimersByTime(1_000)\n    })\n\n    expect(onActivityRefresh).toHaveBeenCalledOnce()\n  })\n\n  it('should keep its controller and activity throttle across rerenders', () => {\n    const onActivityRefresh = vi.fn()\n    const timers = renderAuthSessionTimers({ onActivityRefresh })\n    const initialController = timers.getController()\n\n    timers.setExpiration(Date.now() + 300_000)\n    act(() => {\n      vi.advanceTimersByTime(238_000)\n      window.dispatchEvent(new MouseEvent('mousemove'))\n    })\n    timers.rerender()\n\n    expect(timers.getController()).toBe(initialController)\n\n    act(() => {\n      vi.advanceTimersByTime(1)\n      window.dispatchEvent(new MouseEvent('mousemove'))\n      vi.advanceTimersByTime(999)\n    })\n\n    expect(onActivityRefresh).toHaveBeenCalledTimes(1)\n  })\n\n  it('should synchronously replace the current expiration', () => {\n    const timers = renderAuthSessionTimers()\n    const firstExpirationMs = Date.now() + 300_000\n    const replacementExpirationMs = Date.now() + 600_000\n\n    timers.setExpiration(firstExpirationMs)\n    timers.setExpiration(replacementExpirationMs)\n\n    expect(timers.getCurrentExpirationMs()).toBe(replacementExpirationMs)\n  })\n})\n\nfunction renderAuthSessionTimers({\n  isAuthenticated = true,\n  onActivity = vi.fn(),\n  onActivityRefresh = vi.fn(),\n  onExpire = vi.fn(),\n  onReminder = vi.fn(),\n}: {\n  isAuthenticated?: boolean\n  onActivity?: () => void\n  onActivityRefresh?: () => void\n  onExpire?: (expirationMs: number) => void\n  onReminder?: () => void\n} = {}): RenderedAuthSessionTimers {\n  let controller: AuthSessionTimers | undefined\n  const container = document.createElement('div')\n  const root = createRoot(container)\n\n  function SessionTimers() {\n    controller = useAuthSessionTimers({\n      isAuthenticated,\n      onActivity,\n      onActivityRefresh,\n      onExpire,\n      onReminder,\n    })\n\n    return null\n  }\n\n  act(() => {\n    root.render(React.createElement(SessionTimers))\n  })\n\n  timerCleanups.push(() => {\n    act(() => {\n      root.unmount()\n    })\n  })\n\n  const getController = (): AuthSessionTimers => {\n    if (!controller) {\n      throw new Error('Expected auth session timers.')\n    }\n\n    return controller\n  }\n\n  return {\n    clear: () => getController().clear(),\n    getController,\n    getCurrentExpirationMs: () => getController().getCurrentExpirationMs(),\n    rerender: () => {\n      act(() => {\n        root.render(React.createElement(SessionTimers))\n      })\n    },\n    recordActivity: (source) => getController().recordActivity(source),\n    scheduleRefresh: (forceRefresh) => getController().scheduleRefresh(forceRefresh),\n    setExpiration: (expirationMs) => getController().setExpiration(expirationMs),\n  }\n}\n\ntype RenderedAuthSessionTimers = AuthSessionTimers & {\n  getController: () => AuthSessionTimers\n  recordActivity: (source: 'focus' | 'keydown' | 'mousemove' | 'route') => boolean\n  rerender: () => void\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/providers/Branch/index.d.ts

@@ -0,0 +1,68 @@
+import React from 'react';
+export type BranchOption = {
+    /** Absent for `main`, which is a sentinel rather than a document. */
+    id?: number | string;
+    /**
+     * Merged with nothing pending since — still a usable workspace, but worth
+     * distinguishing from a branch with work on it.
+     */
+    isMerged?: boolean;
+    /** A merge is queued for this branch — worth knowing before switching onto it. */
+    isScheduled?: boolean;
+    name: string;
+    slug: string;
+};
+export type BranchContext = {
+    /** Slug of the branch every read on this request resolved through. */
+    activeBranch: string;
+    /** Branches the user can read, excluding `main`. */
+    branches: BranchOption[];
+    /** Whether branching is enabled for this Payload instance. */
+    isEnabled: boolean;
+    /**
+     * Switches the active branch: stores the choice in the user's preferences and
+     * re-renders the current view against it.
+     */
+    setBranch: (slug: string, options?: {
+        refresh?: boolean;
+    }) => void;
+};
+export type BranchProviderProps = {
+    /** Branch resolved for the request that rendered this page. */
+    activeBranch: string;
+    branches: BranchOption[];
+    children: React.ReactNode;
+    /**
+     * Set when the request resolved to a branch the user can no longer see, so
+     * the stored preference pointing at it can be cleared.
+     */
+    staleBranch?: null | string;
+};
+/**
+ * Holds the active branch for the admin UI.
+ *
+ * The selection lives in the user's `admin` preference and nowhere else, so it
+ * follows them between browsers and machines. The server resolves it during
+ * request initialization, which is why switching is a preference write followed
+ * by a refresh rather than any client-side state that has to be kept in sync.
+ */
+export declare const BranchProvider: React.FC<BranchProviderProps>;
+export declare const useBranch: () => BranchContext;
+/**
+ * The value to pass as the `branch` argument on an API call, or `undefined`
+ * when the call should run against production.
+ *
+ * `main` is returned as `undefined` on purpose: passing no branch already means
+ * `main` everywhere in Payload, so omitting it keeps ordinary requests free of
+ * a parameter that changes nothing.
+ */
+export declare const useBranchParam: () => string | undefined;
+/**
+ * Whether to render the branch switcher at all.
+ *
+ * Shown whenever branching is enabled, even with no branches yet: the switcher
+ * hosts the "new branch" action, so hiding it until a branch exists would leave
+ * a project with no way to create its first one.
+ */
+export declare const useShowBranchSelector: () => boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/Branch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/Branch/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAA+D,MAAM,OAAO,CAAA;AAQnF,MAAM,MAAM,YAAY,GAAG;IACzB,qEAAqE;IACrE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,kFAAkF;IAClF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAA;CACnE,CAAA;AASD,MAAM,MAAM,mBAAmB,GAAG;IAChC,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CAC5B,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA4FxD,CAAA;AAED,eAAO,MAAM,SAAS,QAAO,aAA6B,CAAA;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,QAAO,MAAM,GAAG,SAI1C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,QAAO,OAIxC,CAAA"}

package/dist/providers/Branch/index.js

@@ -0,0 +1,193 @@
+'use client';
+
+import { c as _c } from "react/compiler-runtime";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { branchesCollectionSlug, MAIN_BRANCH, PREFERENCE_KEYS } from 'payload/shared';
+import React, { createContext, use, useCallback, useEffect, useState } from 'react';
+import { useConfig } from '../Config/index.js';
+import { useDocumentEvents } from '../DocumentEvents/index.js';
+import { usePreferences } from '../Preferences/index.js';
+import { useRouter } from '../RouterAdapter/index.js';
+import { useRouteTransition } from '../RouteTransition/index.js';
+const Context = /*#__PURE__*/createContext({
+  activeBranch: MAIN_BRANCH,
+  branches: [],
+  isEnabled: false,
+  setBranch: () => null
+});
+/**
+ * Holds the active branch for the admin UI.
+ *
+ * The selection lives in the user's `admin` preference and nowhere else, so it
+ * follows them between browsers and machines. The server resolves it during
+ * request initialization, which is why switching is a preference write followed
+ * by a refresh rather than any client-side state that has to be kept in sync.
+ */
+export const BranchProvider = t0 => {
+  const $ = _c(22);
+  const {
+    activeBranch: activeBranchFromServer,
+    branches,
+    children,
+    staleBranch
+  } = t0;
+  const {
+    config: t1
+  } = useConfig();
+  const {
+    branching
+  } = t1;
+  const {
+    setPreference
+  } = usePreferences();
+  const router = useRouter();
+  const {
+    startRouteTransition
+  } = useRouteTransition();
+  const isEnabled = Boolean(branching?.enabled);
+  const [activeBranch, setActiveBranchState] = useState(activeBranchFromServer);
+  let t2;
+  let t3;
+  if ($[0] !== activeBranchFromServer) {
+    t2 = () => {
+      setActiveBranchState(activeBranchFromServer);
+    };
+    t3 = [activeBranchFromServer];
+    $[0] = activeBranchFromServer;
+    $[1] = t2;
+    $[2] = t3;
+  } else {
+    t2 = $[1];
+    t3 = $[2];
+  }
+  useEffect(t2, t3);
+  let t4;
+  if ($[3] !== activeBranch || $[4] !== router || $[5] !== setPreference || $[6] !== startRouteTransition) {
+    t4 = (slug, t5) => {
+      const {
+        refresh: t6
+      } = t5 === undefined ? {} : t5;
+      const refresh = t6 === undefined ? true : t6;
+      if (slug === activeBranch) {
+        return;
+      }
+      setActiveBranchState(slug);
+      (async () => {
+        await setPreference(PREFERENCE_KEYS.ADMIN, {
+          branch: slug
+        }, true);
+        if (refresh) {
+          startRouteTransition(() => {
+            router.refresh();
+          });
+        }
+      })();
+    };
+    $[3] = activeBranch;
+    $[4] = router;
+    $[5] = setPreference;
+    $[6] = startRouteTransition;
+    $[7] = t4;
+  } else {
+    t4 = $[7];
+  }
+  const setBranch = t4;
+  const {
+    mostRecentUpdate
+  } = useDocumentEvents();
+  let t5;
+  let t6;
+  if ($[8] !== mostRecentUpdate || $[9] !== setBranch) {
+    t5 = () => {
+      if (mostRecentUpdate?.entitySlug !== branchesCollectionSlug || mostRecentUpdate.operation !== "create") {
+        return;
+      }
+      const createdSlug = mostRecentUpdate.doc?.slug;
+      if (createdSlug) {
+        setBranch(createdSlug, {
+          refresh: false
+        });
+      }
+    };
+    t6 = [mostRecentUpdate, setBranch];
+    $[8] = mostRecentUpdate;
+    $[9] = setBranch;
+    $[10] = t5;
+    $[11] = t6;
+  } else {
+    t5 = $[10];
+    t6 = $[11];
+  }
+  useEffect(t5, t6);
+  let t7;
+  let t8;
+  if ($[12] !== setPreference || $[13] !== staleBranch) {
+    t7 = () => {
+      if (staleBranch) {
+        setPreference(PREFERENCE_KEYS.ADMIN, {
+          branch: MAIN_BRANCH
+        }, true);
+      }
+    };
+    t8 = [setPreference, staleBranch];
+    $[12] = setPreference;
+    $[13] = staleBranch;
+    $[14] = t7;
+    $[15] = t8;
+  } else {
+    t7 = $[14];
+    t8 = $[15];
+  }
+  useEffect(t7, t8);
+  let t9;
+  if ($[16] !== activeBranch || $[17] !== branches || $[18] !== children || $[19] !== isEnabled || $[20] !== setBranch) {
+    t9 = _jsx(Context, {
+      value: {
+        activeBranch,
+        branches,
+        isEnabled,
+        setBranch
+      },
+      children
+    });
+    $[16] = activeBranch;
+    $[17] = branches;
+    $[18] = children;
+    $[19] = isEnabled;
+    $[20] = setBranch;
+    $[21] = t9;
+  } else {
+    t9 = $[21];
+  }
+  return t9;
+};
+export const useBranch = () => use(Context);
+/**
+ * The value to pass as the `branch` argument on an API call, or `undefined`
+ * when the call should run against production.
+ *
+ * `main` is returned as `undefined` on purpose: passing no branch already means
+ * `main` everywhere in Payload, so omitting it keeps ordinary requests free of
+ * a parameter that changes nothing.
+ */
+export const useBranchParam = () => {
+  const {
+    activeBranch,
+    isEnabled
+  } = useBranch();
+  return isEnabled && activeBranch !== MAIN_BRANCH ? activeBranch : undefined;
+};
+/**
+ * Whether to render the branch switcher at all.
+ *
+ * Shown whenever branching is enabled, even with no branches yet: the switcher
+ * hosts the "new branch" action, so hiding it until a branch exists would leave
+ * a project with no way to create its first one.
+ */
+export const useShowBranchSelector = () => {
+  const {
+    isEnabled
+  } = useBranch();
+  return isEnabled;
+};
+//# sourceMappingURL=index.js.map