@payloadcms/ui 4.0.0-internal.a7ca468 → 4.0.0-internal.af6aad0

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":"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","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/FormErrorHandler/index.d.ts

@@ -13,8 +13,12 @@ export type NonFieldError = {
  *
  * Multiple handlers can be chained by composing providers; the first one to
  * return `true` wins.
+ *
+ * `retry` re-submits the form that produced the error, allowing the user to
+ * retry after resolving the underlying issue (e.g. deleting documents to free
+ * up quota).
  */
-export type FormErrorHandler = (err: NonFieldError) => boolean;
+export type FormErrorHandler = (err: NonFieldError, retry: () => void) => boolean;
 export declare const FormErrorHandlerContext: import("react").Context<FormErrorHandler>;
 export declare const useFormErrorHandler: () => FormErrorHandler | undefined;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/FormErrorHandler/index.tsx"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAA;AAE9D,eAAO,MAAM,uBAAuB,2CAAyD,CAAA;AAE7F,eAAO,MAAM,mBAAmB,QAAO,gBAAgB,GAAG,SAAyC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/FormErrorHandler/index.tsx"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,OAAO,CAAA;AAEjF,eAAO,MAAM,uBAAuB,2CAAyD,CAAA;AAE7F,eAAO,MAAM,mBAAmB,QAAO,gBAAgB,GAAG,SAAyC,CAAA"}

package/dist/providers/FormErrorHandler/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["createContext","use","FormErrorHandlerContext","undefined","useFormErrorHandler"],"sources":["../../../src/providers/FormErrorHandler/index.tsx"],"sourcesContent":["'use client'\nimport { createContext, use } from 'react'\n\nexport type NonFieldError = {\n  data?: unknown\n  message: string\n}\n\n/**\n * A callback that a plugin can provide to intercept non-field form errors before\n * Payload shows its default error toast. Return `true` to claim the error (the\n * default toast is suppressed). Return `false` to let Payload handle it normally.\n *\n * Set via `<FormErrorHandlerContext value={handler}>` inside an\n * `admin.components.providers` entry. The Form reads this automatically — no\n * changes to collection config or the edit view are required.\n *\n * Multiple handlers can be chained by composing providers; the first one to\n * return `true` wins.\n */\nexport type FormErrorHandler = (err: NonFieldError) => boolean\n\nexport const FormErrorHandlerContext = createContext<FormErrorHandler | undefined>(undefined)\n\nexport const useFormErrorHandler = (): FormErrorHandler | undefined => use(FormErrorHandlerContext)\n"],"mappings":"AAAA;;AACA,SAASA,aAAa,EAAEC,GAAG,QAAQ;AAqBnC,OAAO,MAAMC,uBAAA,gBAA0BF,aAAA,CAA4CG,SAAA;AAEnF,OAAO,MAAMC,mBAAA,GAAsBA,CAAA,KAAoCH,GAAA,CAAIC,uBAAA","ignoreList":[]}
+{"version":3,"file":"index.js","names":["createContext","use","FormErrorHandlerContext","undefined","useFormErrorHandler"],"sources":["../../../src/providers/FormErrorHandler/index.tsx"],"sourcesContent":["'use client'\nimport { createContext, use } from 'react'\n\nexport type NonFieldError = {\n  data?: unknown\n  message: string\n}\n\n/**\n * A callback that a plugin can provide to intercept non-field form errors before\n * Payload shows its default error toast. Return `true` to claim the error (the\n * default toast is suppressed). Return `false` to let Payload handle it normally.\n *\n * Set via `<FormErrorHandlerContext value={handler}>` inside an\n * `admin.components.providers` entry. The Form reads this automatically — no\n * changes to collection config or the edit view are required.\n *\n * Multiple handlers can be chained by composing providers; the first one to\n * return `true` wins.\n *\n * `retry` re-submits the form that produced the error, allowing the user to\n * retry after resolving the underlying issue (e.g. deleting documents to free\n * up quota).\n */\nexport type FormErrorHandler = (err: NonFieldError, retry: () => void) => boolean\n\nexport const FormErrorHandlerContext = createContext<FormErrorHandler | undefined>(undefined)\n\nexport const useFormErrorHandler = (): FormErrorHandler | undefined => use(FormErrorHandlerContext)\n"],"mappings":"AAAA;;AACA,SAASA,aAAa,EAAEC,GAAG,QAAQ;AAyBnC,OAAO,MAAMC,uBAAA,gBAA0BF,aAAA,CAA4CG,SAAA;AAEnF,OAAO,MAAMC,mBAAA,GAAsBA,CAAA,KAAoCH,GAAA,CAAIC,uBAAA","ignoreList":[]}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/Hierarchy/index.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAoD,MAAM,OAAO,CAAA;AAExE,OAAO,KAAK,EAEV,qBAAqB,EAGrB,sBAAsB,EAEvB,MAAM,YAAY,CAAA;AASnB,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAmZ9D,CAAA;AAED,eAAO,MAAM,YAAY,QAAO,qBAM/B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/Hierarchy/index.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAoD,MAAM,OAAO,CAAA;AAExE,OAAO,KAAK,EAEV,qBAAqB,EAGrB,sBAAsB,EAEvB,MAAM,YAAY,CAAA;AASnB,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAkb9D,CAAA;AAED,eAAO,MAAM,YAAY,QAAO,qBAM/B,CAAA"}

package/dist/providers/Hierarchy/index.js

@@ -105,13 +105,27 @@ export const HierarchyProvider = ({
         } else {
           const existingDocIds = new Set(existingEntry.docs.map(doc_0 => doc_0.id));
           const newDocs = treeData.docs.filter(doc_1 => !existingDocIds.has(doc_1.id));
+          // Reconcile loadedCount/totalDocs against the deduped merge rather than
+          // blindly overwriting: a shallower fetch (e.g. fewer pages walked) must not
+          // regress loadedCount below what's already accumulated in docs, or downstream
+          // page-number math in Tree will refetch and duplicate an already-shown page.
+          const mergedLoadedParents = {
+            ...existingEntry.loadedParents
+          };
+          for (const [parentKey, meta] of Object.entries(treeData.loadedParents)) {
+            const existingMeta = existingEntry.loadedParents[parentKey];
+            const loadedCount = Math.max(existingMeta?.loadedCount ?? 0, meta.loadedCount ?? 0);
+            const totalDocs = Math.max(existingMeta?.totalDocs ?? 0, meta.totalDocs ?? 0);
+            mergedLoadedParents[parentKey] = {
+              hasMore: loadedCount < totalDocs,
+              loadedCount,
+              totalDocs
+            };
+          }
           newCache.set(slug, {
             baseFilter: existingEntry.baseFilter,
             docs: [...existingEntry.docs, ...newDocs],
-            loadedParents: {
-              ...existingEntry.loadedParents,
-              ...treeData.loadedParents
-            }
+            loadedParents: mergedLoadedParents
           });
         }
         return newCache;
@@ -160,29 +174,42 @@ export const HierarchyProvider = ({
       return newMap_1;
     });
   }, [savePreferencesDebounced]);
+  const collapseAllForCollection = useCallback(slug_2 => {
+    setExpandedNodesByCollection(prev_3 => {
+      // Always produce a new Map, even when the collection's set is already empty. The tree
+      // may still be rendering server-provided nodes that only this state change can clear.
+      const newMap_2 = new Map(prev_3);
+      const newExpanded_0 = new Set();
+      newMap_2.set(slug_2, newExpanded_0);
+      savePreferencesDebounced(slug_2, {
+        expanded: newExpanded_0
+      });
+      return newMap_2;
+    });
+  }, [savePreferencesDebounced]);
   const toggleNode = useCallback(id_0 => {
     if (!collectionSlug) {
       return;
     }
     toggleNodeForCollection(collectionSlug, id_0);
   }, [collectionSlug, toggleNodeForCollection]);
-  const getExpandedNodesForCollection = useCallback(slug_2 => {
-    return expandedNodesByCollection.get(slug_2) || new Set();
+  const getExpandedNodesForCollection = useCallback(slug_3 => {
+    return expandedNodesByCollection.get(slug_3) || new Set();
   }, [expandedNodesByCollection]);
-  const getTreeDataForCollection = useCallback(slug_3 => {
-    return treeCache.get(slug_3) || null;
+  const getTreeDataForCollection = useCallback(slug_4 => {
+    return treeCache.get(slug_4) || null;
   }, [treeCache]);
   const setSelectedFilters = useCallback(filters => {
     if (!collectionSlug) {
       return;
     }
-    setSelectedFiltersByCollection(prev_3 => {
-      const newMap_2 = new Map(prev_3);
-      newMap_2.set(collectionSlug, filters);
+    setSelectedFiltersByCollection(prev_4 => {
+      const newMap_3 = new Map(prev_4);
+      newMap_3.set(collectionSlug, filters);
       savePreferencesDebounced(collectionSlug, {
         filters
       });
-      return newMap_2;
+      return newMap_3;
     });
   }, [collectionSlug, savePreferencesDebounced]);
   const selectParent = useCallback(id_1 => {
@@ -205,8 +232,8 @@ export const HierarchyProvider = ({
     if (!cache_0) {
       return;
     }
-    const parentKey = parentId_0 === null ? 'root' : String(parentId_0);
-    const parentMeta = cache_0.loadedParents[parentKey];
+    const parentKey_0 = parentId_0 === null ? 'root' : String(parentId_0);
+    const parentMeta = cache_0.loadedParents[parentKey_0];
     if (!parentMeta || !parentMeta.hasMore) {
       return;
     }
@@ -257,8 +284,8 @@ export const HierarchyProvider = ({
       }
       const data_1 = await response.json();
       const newDocs_0 = data_1.docs || [];
-      setTreeCache(prev_4 => {
-        const newCache_0 = new Map(prev_4);
+      setTreeCache(prev_5 => {
+        const newCache_0 = new Map(prev_5);
         const existingEntry_0 = newCache_0.get(collectionSlug);
         if (existingEntry_0) {
           const existingDocIds_0 = new Set(existingEntry_0.docs.map(doc_3 => doc_3.id));
@@ -267,8 +294,9 @@ export const HierarchyProvider = ({
             docs: [...existingEntry_0.docs, ...uniqueNewDocs],
             loadedParents: {
               ...existingEntry_0.loadedParents,
-              [parentKey]: {
+              [parentKey_0]: {
                 hasMore: data_1.hasNextPage || false,
+                loadedCount: currentChildren.length + uniqueNewDocs.length,
                 totalDocs: data_1.totalDocs || 0
               }
             }
@@ -297,15 +325,15 @@ export const HierarchyProvider = ({
     setIsLoadingMore(false);
     setLoadingNodeId(null);
   }, []);
-  const refreshTree = useCallback(slug_4 => {
-    setTreeCache(prev_5 => {
-      const next = new Map(prev_5);
-      next.delete(slug_4);
+  const refreshTree = useCallback(slug_5 => {
+    setTreeCache(prev_6 => {
+      const next = new Map(prev_6);
+      next.delete(slug_5);
       return next;
     });
-    setTreeRefreshKeys(prev_6 => {
-      const next_0 = new Map(prev_6);
-      next_0.set(slug_4, (next_0.get(slug_4) ?? 0) + 1);
+    setTreeRefreshKeys(prev_7 => {
+      const next_0 = new Map(prev_7);
+      next_0.set(slug_5, (next_0.get(slug_5) ?? 0) + 1);
       return next_0;
     });
   }, []);
@@ -314,6 +342,7 @@ export const HierarchyProvider = ({
   const value = {
     allowedCollections,
     baseFilter,
+    collapseAllForCollection,
     collectionSlug,
     expandedNodes,
     getExpandedNodesForCollection,