@okyrychenko-dev/react-action-guard 0.6.1 → 0.7.0

package/README.md

@@ -36,8 +36,8 @@ pnpm add @okyrychenko-dev/react-action-guard zustand
 
 This package requires the following peer dependencies:
 
-- [React](https://react.dev/) ^17.0.0 || ^18.0.0 || ^19.0.0
-- [Zustand](https://zustand-demo.pmnd.rs/) ^4.5.7 || ^5.0.0 - State management library
+- [React](https://react.dev/) ^18.0.0 || ^19.0.0
+- [Zustand](https://zustand-demo.pmnd.rs/) ^5.0.0 - State management library
 
 ## Quick Start
 

package/dist/index.cjs

@@ -24,16 +24,18 @@ function normalizeScopeToArray(scope) {
 }
 
 // src/store/uiBlockingStore.actions.ts
-var normalizePriority = (priority, fallback = DEFAULT_PRIORITY) => {
+function normalizePriority(priority, fallback = DEFAULT_PRIORITY) {
   return priority !== void 0 ? Math.max(0, priority) : fallback;
-};
-var createMiddlewareContext = (action, blockerId, config, prevState) => ({
-  action,
-  blockerId,
-  config,
-  timestamp: Date.now(),
-  ...prevState && { prevState }
-});
+}
+function createMiddlewareContext(action, blockerId, config, prevState) {
+  return {
+    action,
+    blockerId,
+    config,
+    timestamp: Date.now(),
+    ...prevState && { prevState }
+  };
+}
 var createUIBlockingActions = (set, get) => ({
   // State
   activeBlockers: /* @__PURE__ */ new Map(),
@@ -65,14 +67,14 @@ var createUIBlockingActions = (set, get) => ({
   // Actions
   /**
    * Adds a new blocker or overwrites an existing one.
-   * 
+   *
    * If a blocker with the same ID already exists, it will be replaced and any
    * existing timeout will be cleared. The blocker is active immediately after
    * being added. Triggers middleware with 'add' action.
-   * 
+   *
    * @param id - Unique identifier for the blocker. Must be unique within the store.
    * @param config - Blocker configuration. All fields are optional with defaults applied.
-   * 
+   *
    * @example
    * Basic usage
    * ```ts
@@ -82,7 +84,7 @@ var createUIBlockingActions = (set, get) => ({
    *   priority: 70
    * });
    * ```
-   * 
+   *
    * @example
    * With timeout
    * ```ts
@@ -93,7 +95,7 @@ var createUIBlockingActions = (set, get) => ({
    *   onTimeout: (id) => console.warn(`${id} timed out`)
    * });
    * ```
-   * 
+   *
    * @see {@link removeBlocker} to remove a blocker
    * @see {@link updateBlocker} to update an existing blocker
    */
@@ -144,13 +146,13 @@ var createUIBlockingActions = (set, get) => ({
   },
   /**
    * Updates an existing blocker or creates it if it doesn't exist.
-   * 
+   *
    * Merges the provided configuration with existing blocker data. If the timeout
    * is changed, the timeout timer is restarted. Triggers middleware with 'update' action.
-   * 
+   *
    * @param id - Identifier of the blocker to update
    * @param config - Partial configuration to merge with existing blocker data
-   * 
+   *
    * @example
    * Update blocker reason
    * ```ts
@@ -158,7 +160,7 @@ var createUIBlockingActions = (set, get) => ({
    *   reason: 'Saving additional data...'
    * });
    * ```
-   * 
+   *
    * @example
    * Extend timeout
    * ```ts
@@ -166,7 +168,7 @@ var createUIBlockingActions = (set, get) => ({
    *   timeout: 60000 // Extend to 60 seconds
    * });
    * ```
-   * 
+   *
    * @see {@link addBlocker} to create a new blocker
    */
   updateBlocker: (id, config = {}) => {
@@ -242,12 +244,12 @@ var createUIBlockingActions = (set, get) => ({
   },
   /**
    * Removes a blocker from the store.
-   * 
+   *
    * Clears any associated timeout and triggers middleware with 'remove' action.
    * Safe to call even if the blocker doesn't exist (no-op in that case).
-   * 
+   *
    * @param id - Identifier of the blocker to remove
-   * 
+   *
    * @example
    * ```ts
    * // Add and remove a blocker
@@ -255,7 +257,7 @@ var createUIBlockingActions = (set, get) => ({
    * // ... later
    * store.getState().removeBlocker('temp');
    * ```
-   * 
+   *
    * @see {@link addBlocker} to add a blocker
    * @see {@link clearAllBlockers} to remove all blockers at once
    */
@@ -275,28 +277,28 @@ var createUIBlockingActions = (set, get) => ({
   },
   /**
    * Checks if one or more scopes are currently blocked.
-   * 
+   *
    * Returns true if ANY blocker affects the specified scope(s). Global scope
    * blockers will cause this to return true for any scope check.
-   * 
+   *
    * @param scope - Scope(s) to check. Defaults to "global" if not specified.
    *                Can be a single scope string or array of scopes.
    * @returns true if any of the specified scopes are currently blocked
-   * 
+   *
    * @example
    * Single scope check
    * ```ts
    * const isFormBlocked = store.getState().isBlocked('form');
    * console.log(isFormBlocked); // true or false
    * ```
-   * 
+   *
    * @example
    * Multiple scopes check
    * ```ts
    * const isBlocked = store.getState().isBlocked(['form', 'navigation']);
    * // Returns true if either 'form' OR 'navigation' has active blockers
    * ```
-   * 
+   *
    * @see {@link getBlockingInfo} for detailed blocker information
    */
   isBlocked: (scope = DEFAULT_SCOPE) => {
@@ -315,14 +317,14 @@ var createUIBlockingActions = (set, get) => ({
   },
   /**
    * Gets detailed information about all blockers affecting a specific scope.
-   * 
+   *
    * Returns an array of blocker objects sorted by priority (highest first).
    * Includes global blockers and scope-specific blockers. Each blocker object
    * contains id, reason, priority, scope, timestamp, and timeout information.
-   * 
+   *
    * @param scope - Scope to get blocking information for
    * @returns Array of {@link BlockerInfo} objects, sorted by priority descending
-   * 
+   *
    * @example
    * Display blocker details
    * ```ts
@@ -332,7 +334,7 @@ var createUIBlockingActions = (set, get) => ({
    *   console.log(`Priority: ${blocker.priority}`);
    * });
    * ```
-   * 
+   *
    * @example
    * Get highest priority blocker
    * ```ts
@@ -342,7 +344,7 @@ var createUIBlockingActions = (set, get) => ({
    *   console.log(`Top blocker: ${topBlocker.reason}`);
    * }
    * ```
-   * 
+   *
    * @see {@link isBlocked} for a simple boolean check
    * @see {@link BlockerInfo} for the structure of returned objects
    */
@@ -359,16 +361,16 @@ var createUIBlockingActions = (set, get) => ({
   },
   /**
    * Removes all active blockers from the store.
-   * 
+   *
    * Clears all timeouts and triggers middleware with 'clear' action.
    * Useful for resetting the blocking state.
-   * 
+   *
    * @example
    * ```ts
    * // Clear all blockers on logout
    * store.getState().clearAllBlockers();
    * ```
-   * 
+   *
    * @see {@link clearBlockersForScope} to clear blockers for a specific scope
    */
   clearAllBlockers: () => {
@@ -391,26 +393,26 @@ var createUIBlockingActions = (set, get) => ({
   },
   /**
    * Removes all blockers that affect a specific scope.
-   * 
+   *
    * Clears timeouts for removed blockers and triggers middleware with
    * 'clear_scope' action. Global scope blockers are NOT cleared by this method.
-   * 
+   *
    * @param scope - Scope to clear blockers for
-   * 
+   *
    * @example
    * Clear form blockers
    * ```ts
    * // Clear all blockers affecting 'form' scope
    * store.getState().clearBlockersForScope('form');
    * ```
-   * 
+   *
    * @example
    * Clear on navigation
    * ```ts
    * // Clear navigation blockers when user navigates away
    * store.getState().clearBlockersForScope('navigation');
    * ```
-   * 
+   *
    * @see {@link clearAllBlockers} to clear all blockers
    */
   clearBlockersForScope: (scope) => {
@@ -498,7 +500,7 @@ function useResolvedStoreWithSelector(selector) {
 }
 
 // src/hooks/useAsyncAction/useAsyncAction.ts
-var useAsyncAction = (actionId, scope, options) => {
+function useAsyncAction(actionId, scope, options) {
   const { addBlocker, removeBlocker } = useResolvedStoreWithSelector((state) => ({
     addBlocker: state.addBlocker,
     removeBlocker: state.removeBlocker
@@ -524,8 +526,8 @@ var useAsyncAction = (actionId, scope, options) => {
     [actionId, scope, options?.timeout, options?.onTimeout, addBlocker, removeBlocker]
   );
   return executeWithBlocking;
-};
-var useBlocker = (blockerId, config, isActive = true) => {
+}
+function useBlocker(blockerId, config, isActive = true) {
   const { addBlocker, removeBlocker } = useResolvedStoreWithSelector((state) => ({
     addBlocker: state.addBlocker,
     removeBlocker: state.removeBlocker
@@ -539,7 +541,7 @@ var useBlocker = (blockerId, config, isActive = true) => {
       removeBlocker(blockerId);
     };
   }, [blockerId, isActive, addBlocker, removeBlocker]);
-};
+}
 
 // src/hooks/useBlocker/useBlocker.utils.ts
 function createBlockerConfig(config) {
@@ -549,13 +551,13 @@ function createBlockerConfig(config) {
     priority: config.priority
   };
 }
-var useBlockingInfo = (scope = DEFAULT_SCOPE) => {
+function useBlockingInfo(scope = DEFAULT_SCOPE) {
   const store = useResolvedStore();
   const activeBlockers = zustand.useStore(store, (state) => state.activeBlockers);
   return react.useMemo(() => {
     return store.getState().getBlockingInfo(scope);
   }, [activeBlockers, scope, store]);
-};
+}
 function useConfigRef(config) {
   const configRef = react.useRef(config);
   react.useEffect(() => {
@@ -565,7 +567,7 @@ function useConfigRef(config) {
 }
 
 // src/hooks/useConditionalBlocker/useConditionalBlocker.ts
-var useConditionalBlocker = (blockerId, config) => {
+function useConditionalBlocker(blockerId, config) {
   const { addBlocker, removeBlocker } = useResolvedStoreWithSelector((state) => ({
     addBlocker: state.addBlocker,
     removeBlocker: state.removeBlocker
@@ -601,8 +603,8 @@ var useConditionalBlocker = (blockerId, config) => {
       }
     };
   }, [checkCondition, blockerId, removeBlocker]);
-};
-var useConfirmableBlocker = (blockerId, config) => {
+}
+function useConfirmableBlocker(blockerId, config) {
   const [isDialogOpen, setIsDialogOpen] = react.useState(false);
   const [isExecuting, setIsExecuting] = react.useState(false);
   useBlocker(
@@ -645,12 +647,12 @@ var useConfirmableBlocker = (blockerId, config) => {
     onConfirm,
     onCancel
   };
-};
+}
 
 // src/hooks/useIsBlocked/useIsBlocked.ts
-var useIsBlocked = (scope) => {
+function useIsBlocked(scope) {
   return useResolvedStoreWithSelector((state) => state.isBlocked(scope));
-};
+}
 
 // src/hooks/useScheduledBlocker/useScheduledBlocker.utils.ts
 var MAX_TIMEOUT_MS = 2147483647;
@@ -690,7 +692,7 @@ function isScheduleInPast(startTime, endTime, now) {
 }
 
 // src/hooks/useScheduledBlocker/useScheduledBlocker.ts
-var useScheduledBlocker = (blockerId, config) => {
+function useScheduledBlocker(blockerId, config) {
   const { addBlocker, removeBlocker } = useResolvedStoreWithSelector((state) => ({
     addBlocker: state.addBlocker,
     removeBlocker: state.removeBlocker
@@ -756,13 +758,13 @@ var useScheduledBlocker = (blockerId, config) => {
       removeBlocker(blockerId);
     };
   }, [blockerId, addBlocker, removeBlocker, cleanup]);
-};
+}
 
 // src/middleware/analyticsMiddleware.utils.ts
-var capitalizeFirst = (str) => {
+function capitalizeFirst(str) {
   return str.charAt(0).toUpperCase() + str.slice(1);
-};
-var buildEventData = (context) => {
+}
+function buildEventData(context) {
   const eventData = {
     blocker_id: context.blockerId
   };
@@ -777,33 +779,33 @@ var buildEventData = (context) => {
     eventData.priority = priority;
   }
   return eventData;
-};
-var trackGoogleAnalytics = (action, eventData) => {
+}
+function trackGoogleAnalytics(action, eventData) {
   if (window.gtag) {
     window.gtag("event", `ui_blocking_${action}`, eventData);
   }
-};
-var trackMixpanel = (action, eventData) => {
+}
+function trackMixpanel(action, eventData) {
   if (window.mixpanel) {
     const eventName = `UI Blocking ${action.split("_").map(capitalizeFirst).join(" ")}`;
     window.mixpanel.track(eventName, eventData);
   }
-};
-var trackAmplitude = (action, eventData) => {
+}
+function trackAmplitude(action, eventData) {
   if (window.amplitude) {
     const eventName = `UI Blocking ${action.split("_").map(capitalizeFirst).join(" ")}`;
     window.amplitude.track(eventName, eventData);
   }
-};
-var trackCustom = (trackFn, action, eventData) => {
+}
+function trackCustom(trackFn, action, eventData) {
   try {
     trackFn(`ui_blocking_${action}`, eventData);
   } catch {
   }
-};
+}
 
 // src/middleware/analyticsMiddleware.ts
-var trackEvent = (config, context, eventData) => {
+function trackEvent(config, context, eventData) {
   if ("provider" in config) {
     switch (config.provider) {
       case "ga":
@@ -820,13 +822,13 @@ var trackEvent = (config, context, eventData) => {
   if ("track" in config) {
     trackCustom(config.track, context.action, eventData);
   }
-};
-var createAnalyticsMiddleware = (config) => {
+}
+function createAnalyticsMiddleware(config) {
   return (context) => {
     const eventData = buildEventData(context);
     trackEvent(config, context, eventData);
   };
-};
+}
 
 // src/middleware/configureMiddleware.ts
 function configureMiddleware(middlewares) {
@@ -838,7 +840,7 @@ function configureMiddleware(middlewares) {
 }
 
 // src/middleware/loggerMiddleware.utils.ts
-var getActionEmoji = (action) => {
+function getActionEmoji(action) {
   switch (action) {
     case "add":
       return "\u2795";
@@ -855,8 +857,8 @@ var getActionEmoji = (action) => {
     default:
       return "\u2753";
   }
-};
-var extractConfigDetails = (config) => {
+}
+function extractConfigDetails(config) {
   if (!config) {
     return {};
   }
@@ -869,8 +871,8 @@ var extractConfigDetails = (config) => {
     details.priority = priority;
   }
   return details;
-};
-var formatLogData = (context) => {
+}
+function formatLogData(context) {
   const configDetails = extractConfigDetails(context.config);
   const logData = {};
   if (context.scope !== void 0) {
@@ -889,26 +891,26 @@ var formatLogData = (context) => {
     return configDetails;
   }
   return Object.keys(logData).length === 1 && logData.config ? configDetails : logData;
-};
+}
 
 // src/middleware/loggerMiddleware.ts
 var LOG_PREFIX = "[UIBlocking]";
-var loggerMiddleware = (context) => {
+function loggerMiddleware(context) {
   const emoji = getActionEmoji(context.action);
   const logData = formatLogData(context);
   console.log(LOG_PREFIX, emoji, context.blockerId, logData);
-};
+}
 
 // src/middleware/performanceMiddleware.utils.ts
-var handleAddAction = (blockerId, timestamp, blockStartTimes) => {
+function handleAddAction(blockerId, timestamp, blockStartTimes) {
   blockStartTimes.set(blockerId, timestamp);
-};
+}
 
 // src/middleware/performanceMiddleware.ts
 var DEFAULT_SLOW_BLOCK_THRESHOLD = 3e3;
 var ACTION_ADD = "add";
 var ACTION_REMOVE = "remove";
-var handleRemoveAction = (context, blockStartTimes, slowBlockThreshold, onSlowBlock) => {
+function handleRemoveAction(context, blockStartTimes, slowBlockThreshold, onSlowBlock) {
   const startTime = blockStartTimes.get(context.blockerId);
   if (startTime === void 0) {
     return;
@@ -921,8 +923,8 @@ var handleRemoveAction = (context, blockStartTimes, slowBlockThreshold, onSlowBl
     );
     onSlowBlock?.(context.blockerId, duration);
   }
-};
-var createPerformanceMiddleware = (config = {}) => {
+}
+function createPerformanceMiddleware(config = {}) {
   const { slowBlockThreshold = DEFAULT_SLOW_BLOCK_THRESHOLD, onSlowBlock } = config;
   const blockStartTimes = /* @__PURE__ */ new Map();
   return (context) => {
@@ -932,7 +934,7 @@ var createPerformanceMiddleware = (config = {}) => {
       handleRemoveAction(context, blockStartTimes, slowBlockThreshold, onSlowBlock);
     }
   };
-};
+}
 
 // src/createTypedHooks.ts
 function createTypedHooks() {