@okyrychenko-dev/react-action-guard 0.1.0 → 0.2.1

package/dist/index.js

@@ -1,4 +1,4 @@
-import { useEffect, useCallback } from 'react';
+import { useEffect, useCallback, useRef, useState } from 'react';
 import { create } from 'zustand';
 import { devtools } from 'zustand/middleware';
 
@@ -23,6 +23,33 @@ function normalizeScopeToArray(scope) {
 var createUIBlockingActions = (set, get) => ({
   // State
   activeBlockers: /* @__PURE__ */ new Map(),
+  middlewares: /* @__PURE__ */ new Map(),
+  registerMiddleware: (name, middleware) => {
+    set((state) => {
+      const newMiddlewares = new Map(state.middlewares);
+      newMiddlewares.set(name, middleware);
+      return { middlewares: newMiddlewares };
+    });
+    console.log(`[UIBlocking] Registered middleware: ${name}`);
+  },
+  unregisterMiddleware: (name) => {
+    set((state) => {
+      const newMiddlewares = new Map(state.middlewares);
+      newMiddlewares.delete(name);
+      return { middlewares: newMiddlewares };
+    });
+    console.log(`[UIBlocking] Unregistered middleware: ${name}`);
+  },
+  runMiddlewares: async (context) => {
+    const { middlewares } = get();
+    for (const [name, middleware] of middlewares) {
+      try {
+        await middleware(context);
+      } catch (error) {
+        console.error(`[UIBlocking] Middleware "${name}" error:`, error);
+      }
+    }
+  },
   // Actions
   /**
    * Add a blocker to the store
@@ -43,6 +70,16 @@ var createUIBlockingActions = (set, get) => ({
       newBlockers.set(id, storedBlocker);
       return { activeBlockers: newBlockers };
     });
+    void get().runMiddlewares({
+      action: "add",
+      blockerId: id,
+      config: {
+        scope: config.scope,
+        reason: config.reason,
+        priority: config.priority
+      },
+      timestamp: Date.now()
+    });
   },
   /**
    * Remove a blocker from the store
@@ -51,11 +88,21 @@ var createUIBlockingActions = (set, get) => ({
    *
    */
   removeBlocker: (id) => {
+    const prevBlocker = get().activeBlockers.get(id);
     set((state) => {
       const newBlockers = new Map(state.activeBlockers);
       newBlockers.delete(id);
       return { activeBlockers: newBlockers };
     });
+    if (prevBlocker) {
+      void get().runMiddlewares({
+        action: "remove",
+        blockerId: id,
+        config: prevBlocker,
+        timestamp: Date.now(),
+        prevState: prevBlocker
+      });
+    }
   },
   /**
    * Check if a scope is currently blocked
@@ -171,7 +218,315 @@ var useAsyncAction = (actionId, scope) => {
   );
   return executeWithBlocking;
 };
+function useConfigRef(config) {
+  const configRef = useRef(config);
+  useEffect(() => {
+    configRef.current = config;
+  }, [config]);
+  return configRef;
+}
+
+// src/hooks/useBlocker.utils.ts
+function createBlockerConfig(config) {
+  return {
+    scope: config.scope,
+    reason: config.reason,
+    priority: config.priority
+  };
+}
+
+// src/hooks/useConditionalBlocker.ts
+var useConditionalBlocker = (blockerId, config) => {
+  const { addBlocker, removeBlocker } = useUIBlockingStore();
+  const intervalRef = useRef(null);
+  const isBlockedRef = useRef(false);
+  const configRef = useConfigRef(config);
+  const checkCondition = useCallback(() => {
+    const currentConfig = configRef.current;
+    const shouldBlock = currentConfig.condition(currentConfig.state);
+    if (shouldBlock === isBlockedRef.current) {
+      return;
+    }
+    if (shouldBlock) {
+      addBlocker(blockerId, createBlockerConfig(currentConfig));
+      isBlockedRef.current = true;
+    } else {
+      removeBlocker(blockerId);
+      isBlockedRef.current = false;
+    }
+  }, [blockerId, addBlocker, removeBlocker, configRef]);
+  useEffect(() => {
+    checkCondition();
+    const interval = configRef.current.checkInterval ?? 1e3;
+    intervalRef.current = setInterval(checkCondition, interval);
+    return () => {
+      if (intervalRef.current) {
+        clearInterval(intervalRef.current);
+        intervalRef.current = null;
+      }
+      if (isBlockedRef.current) {
+        removeBlocker(blockerId);
+        isBlockedRef.current = false;
+      }
+    };
+  }, [checkCondition, blockerId, removeBlocker]);
+};
+var useConfirmableBlocker = (blockerId, config) => {
+  const [isDialogOpen, setIsDialogOpen] = useState(false);
+  const [isExecuting, setIsExecuting] = useState(false);
+  useBlocker(
+    blockerId,
+    {
+      ...config,
+      reason: config.reason ?? config.confirmMessage
+    },
+    isDialogOpen || isExecuting
+  );
+  const execute = useCallback(() => {
+    setIsDialogOpen(true);
+  }, []);
+  const onConfirm = useCallback(async () => {
+    setIsDialogOpen(false);
+    setIsExecuting(true);
+    try {
+      await config.onConfirm();
+    } catch (error) {
+      console.error("[UIBlocking] Confirmable action error:", error);
+      throw error;
+    } finally {
+      setIsExecuting(false);
+    }
+  }, [config]);
+  const onCancel = useCallback(() => {
+    setIsDialogOpen(false);
+    config.onCancel?.();
+  }, [config]);
+  return {
+    execute,
+    isDialogOpen,
+    isExecuting,
+    confirmConfig: {
+      title: config.confirmTitle ?? "Confirm Action",
+      message: config.confirmMessage,
+      confirmText: config.confirmButtonText ?? "Confirm",
+      cancelText: config.cancelButtonText ?? "Cancel"
+    },
+    onConfirm,
+    onCancel
+  };
+};
+var useScheduledBlocker = (blockerId, config) => {
+  const { addBlocker, removeBlocker } = useUIBlockingStore();
+  const timeoutsRef = useRef({});
+  const configRef = useConfigRef(config);
+  const cleanup = useCallback(() => {
+    if (timeoutsRef.current.start) {
+      clearTimeout(timeoutsRef.current.start);
+      timeoutsRef.current.start = void 0;
+    }
+    if (timeoutsRef.current.end) {
+      clearTimeout(timeoutsRef.current.end);
+      timeoutsRef.current.end = void 0;
+    }
+  }, []);
+  useEffect(() => {
+    const currentConfig = configRef.current;
+    const startTime = new Date(currentConfig.schedule.start).getTime();
+    const now = Date.now();
+    let endTime;
+    if (currentConfig.schedule.duration) {
+      endTime = startTime + currentConfig.schedule.duration;
+    } else if (currentConfig.schedule.end) {
+      endTime = new Date(currentConfig.schedule.end).getTime();
+    }
+    const scheduleEnd = (end) => {
+      const remainingTime = end - Date.now();
+      if (remainingTime > 0) {
+        timeoutsRef.current.end = setTimeout(() => {
+          removeBlocker(blockerId);
+          configRef.current.onScheduleEnd?.();
+        }, remainingTime);
+      }
+    };
+    if (startTime > now) {
+      timeoutsRef.current.start = setTimeout(() => {
+        const cfg = configRef.current;
+        addBlocker(blockerId, createBlockerConfig(cfg));
+        cfg.onScheduleStart?.();
+        if (endTime) {
+          scheduleEnd(endTime);
+        }
+      }, startTime - now);
+    } else if (endTime && endTime > now) {
+      addBlocker(blockerId, createBlockerConfig(currentConfig));
+      currentConfig.onScheduleStart?.();
+      scheduleEnd(endTime);
+    } else if (!endTime && startTime <= now) {
+      addBlocker(blockerId, createBlockerConfig(currentConfig));
+      currentConfig.onScheduleStart?.();
+    } else {
+      console.warn(`[UIBlocking] Schedule is in the past for blocker "${blockerId}"`);
+    }
+    return () => {
+      cleanup();
+      removeBlocker(blockerId);
+    };
+  }, [blockerId, addBlocker, removeBlocker, cleanup]);
+};
+
+// src/middleware/loggerMiddleware.utils.ts
+var getActionEmoji = (action) => {
+  switch (action) {
+    case "add":
+      return "\u2795";
+    case "remove":
+      return "\u2796";
+    case "update":
+      return "\u{1F504}";
+    case "cancel":
+      return "\u274C";
+    case "timeout":
+      return "\u23F1\uFE0F";
+    default:
+      return "\u2753";
+  }
+};
+var extractConfigDetails = (config) => {
+  if (!config) {
+    return {};
+  }
+  const { scope, reason, priority } = config;
+  const details = {
+    scope,
+    reason
+  };
+  if (priority !== void 0) {
+    details.priority = priority;
+  }
+  return details;
+};
+var formatLogData = (context) => {
+  const configDetails = extractConfigDetails(context.config);
+  if (context.prevState) {
+    return {
+      config: configDetails,
+      prevState: extractConfigDetails(context.prevState)
+    };
+  }
+  return configDetails;
+};
+
+// src/middleware/loggerMiddleware.ts
+var LOG_PREFIX = "[UIBlocking]";
+var loggerMiddleware = (context) => {
+  const emoji = getActionEmoji(context.action);
+  const logData = formatLogData(context);
+  console.log(LOG_PREFIX, emoji, context.blockerId, logData);
+};
+
+// src/middleware/analyticsMiddleware.utils.ts
+var capitalizeFirst = (str) => {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+};
+var buildEventData = (context) => {
+  const eventData = {
+    blocker_id: context.blockerId
+  };
+  const { scope, reason, priority } = context.config ?? {};
+  if (scope !== void 0) {
+    eventData.scope = Array.isArray(scope) ? scope.join(",") : scope;
+  }
+  if (reason !== void 0) {
+    eventData.reason = reason;
+  }
+  if (priority !== void 0) {
+    eventData.priority = priority;
+  }
+  return eventData;
+};
+var trackGoogleAnalytics = (action, eventData) => {
+  if (window.gtag) {
+    window.gtag("event", `ui_blocking_${action}`, eventData);
+  }
+};
+var trackMixpanel = (action, eventData) => {
+  if (window.mixpanel) {
+    const eventName = `UI Blocking ${action.split("_").map(capitalizeFirst).join(" ")}`;
+    window.mixpanel.track(eventName, eventData);
+  }
+};
+var 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) => {
+  try {
+    trackFn(`ui_blocking_${action}`, eventData);
+  } catch {
+  }
+};
+
+// src/middleware/analyticsMiddleware.ts
+var trackEvent = (config, context, eventData) => {
+  if ("provider" in config) {
+    switch (config.provider) {
+      case "ga":
+        trackGoogleAnalytics(context.action, eventData);
+        return;
+      case "mixpanel":
+        trackMixpanel(context.action, eventData);
+        return;
+      case "amplitude":
+        trackAmplitude(context.action, eventData);
+        return;
+    }
+  }
+  if ("track" in config) {
+    trackCustom(config.track, context.action, eventData);
+  }
+};
+var createAnalyticsMiddleware = (config) => {
+  return (context) => {
+    const eventData = buildEventData(context);
+    trackEvent(config, context, eventData);
+  };
+};
+
+// src/middleware/performanceMiddleware.utils.ts
+var 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) => {
+  const startTime = blockStartTimes.get(context.blockerId);
+  if (startTime === void 0) {
+    return;
+  }
+  const duration = context.timestamp - startTime;
+  blockStartTimes.delete(context.blockerId);
+  if (duration >= slowBlockThreshold) {
+    console.warn(`[UIBlocking] Slow block detected: "${context.blockerId}" took ${duration.toString()}ms`);
+    onSlowBlock?.(context.blockerId, duration);
+  }
+};
+var createPerformanceMiddleware = (config = {}) => {
+  const { slowBlockThreshold = DEFAULT_SLOW_BLOCK_THRESHOLD, onSlowBlock } = config;
+  const blockStartTimes = /* @__PURE__ */ new Map();
+  return (context) => {
+    if (context.action === ACTION_ADD) {
+      handleAddAction(context.blockerId, context.timestamp, blockStartTimes);
+    } else if (context.action === ACTION_REMOVE) {
+      handleRemoveAction(context, blockStartTimes, slowBlockThreshold, onSlowBlock);
+    }
+  };
+};
 
-export { useAsyncAction, useBlocker, useIsBlocked, useUIBlockingStore };
+export { createAnalyticsMiddleware, createPerformanceMiddleware, loggerMiddleware, useAsyncAction, useBlocker, useConditionalBlocker, useConfirmableBlocker, useIsBlocked, useScheduledBlocker, useUIBlockingStore };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/store/uiBlockingStore.constants.ts","../src/store/uiBlockingStore.utils.ts","../src/store/uiBlockingStore.actions.ts","../src/store/uiBlockingStore.config.ts","../src/store/uiBlockingStore.store.ts","../src/hooks/useBlocker.ts","../src/hooks/useIsBlocked.ts","../src/hooks/useAsyncAction.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Default values and constants for UI Blocking Store\n */\n\n/**\n * Default scope for blockers\n */\nexport const DEFAULT_SCOPE = \"global\" as const;\n\n/**\n * Default reason when none is provided\n */\nexport const DEFAULT_REASON = \"Unknown\" as const;\n\n/**\n * Default priority for blockers\n */\nexport const DEFAULT_PRIORITY = 0 as const;\n\n/**\n * Default priority for async actions\n */\nexport const ASYNC_ACTION_PRIORITY = 20 as const;\n\n/**\n * DevTools store name\n */\nexport const DEVTOOLS_NAME = \"UIBlocking\" as const;\n","/**\n * Normalize scope to array format\n *\n * @param scope - Single scope or array of scopes\n * @returns Array of scopes\n *\n * @internal\n */\nexport function normalizeScopeToArray(scope: string | ReadonlyArray<string>): Array<string> {\n  if (typeof scope === \"string\") {\n    return [scope];\n  }\n  return Array.from(scope);\n}\n","import type { StateCreator } from \"zustand\";\nimport type {\n  BlockerConfig,\n  BlockerInfo,\n  StoredBlocker,\n  UIBlockingStore,\n} from \"./uiBlockingStore.types\";\nimport { DEFAULT_SCOPE, DEFAULT_REASON, DEFAULT_PRIORITY } from \"./uiBlockingStore.constants\";\nimport { normalizeScopeToArray } from \"./uiBlockingStore.utils\";\n\n/**\n * UI Blocking Store Slice\n *\n * Implements the state and actions for UI blocking management.\n * This slice follows the Zustand slice pattern for better code organization.\n */\nexport const createUIBlockingActions: StateCreator<UIBlockingStore, [], [], UIBlockingStore> = (\n  set,\n  get\n) => ({\n  // State\n  activeBlockers: new Map(),\n\n  // Actions\n  /**\n   * Add a blocker to the store\n   *\n   * @param id - Unique blocker identifier\n   * @param config - Optional blocker configuration\n   *\n   */\n  addBlocker: (id: string, config: BlockerConfig = {}): void => {\n    set((state) => {\n      const newBlockers = new Map(state.activeBlockers);\n      const storedBlocker: StoredBlocker = {\n        scope: config.scope ?? DEFAULT_SCOPE,\n        reason: config.reason ?? DEFAULT_REASON,\n        priority: config.priority ?? DEFAULT_PRIORITY,\n        timestamp: config.timestamp ?? Date.now(),\n      };\n      newBlockers.set(id, storedBlocker);\n\n      return { activeBlockers: newBlockers };\n    });\n  },\n\n  /**\n   * Remove a blocker from the store\n   *\n   * @param id - Blocker identifier to remove\n   *\n   */\n  removeBlocker: (id: string): void => {\n    set((state) => {\n      const newBlockers = new Map(state.activeBlockers);\n      newBlockers.delete(id);\n\n      return { activeBlockers: newBlockers };\n    });\n  },\n\n  /**\n   * Check if a scope is currently blocked\n   *\n   * @param scope - Scope or array of scopes to check (default: \"global\")\n   * @returns True if any of the scopes are blocked\n   *\n   */\n  isBlocked: (scope: string | ReadonlyArray<string> = DEFAULT_SCOPE): boolean => {\n    const { activeBlockers } = get();\n    const scopes = normalizeScopeToArray(scope);\n\n    for (const [, blocker] of activeBlockers) {\n      // Global blocking blocks everything\n      if (blocker.scope === DEFAULT_SCOPE) {\n        return true;\n      }\n\n      // Check scope intersection\n      const blockerScopes = normalizeScopeToArray(blocker.scope);\n\n      if (scopes.some((s) => blockerScopes.includes(s))) {\n        return true;\n      }\n    }\n\n    return false;\n  },\n\n  /**\n   * Get detailed blocking information for a specific scope\n   *\n   * @param scope - Scope to get blocking information for\n   * @returns Array of blockers affecting the scope, sorted by priority (highest first)\n   *\n   */\n  getBlockingInfo: (scope: string): ReadonlyArray<BlockerInfo> => {\n    const { activeBlockers } = get();\n    const blockers: Array<BlockerInfo> = [];\n\n    for (const [id, blocker] of activeBlockers) {\n      const blockerScopes = normalizeScopeToArray(blocker.scope);\n\n      if (blocker.scope === DEFAULT_SCOPE || blockerScopes.includes(scope)) {\n        blockers.push({ id, ...blocker });\n      }\n    }\n\n    return blockers.sort((a, b) => b.priority - a.priority);\n  },\n\n  /**\n   * Clear all blockers from the store\n   */\n  clearAllBlockers: (): void => {\n    set({ activeBlockers: new Map() });\n  },\n\n  /**\n   * Clear all blockers for a specific scope\n   *\n   * @param scope - Scope to clear blockers for\n   *\n   */\n  clearBlockersForScope: (scope: string): void => {\n    set((state) => {\n      const newBlockers = new Map();\n\n      for (const [id, blocker] of state.activeBlockers) {\n        const blockerScopes = normalizeScopeToArray(blocker.scope);\n\n        if (!blockerScopes.includes(scope)) {\n          newBlockers.set(id, blocker);\n        }\n      }\n\n      return { activeBlockers: newBlockers };\n    });\n  },\n});\n","import type { DevtoolsOptions } from \"zustand/middleware\";\nimport { DEVTOOLS_NAME } from \"./uiBlockingStore.constants\";\n\n/**\n * DevTools configuration for UI Blocking Store\n *\n * Enables Redux DevTools integration only in development mode\n * for better debugging experience without production overhead.\n */\nexport const devtoolsConfig: DevtoolsOptions = {\n  name: DEVTOOLS_NAME,\n  enabled: process.env.NODE_ENV !== \"production\",\n};\n","import { create } from \"zustand\";\nimport { devtools } from \"zustand/middleware\";\nimport { createUIBlockingActions } from \"./uiBlockingStore.actions\";\nimport { devtoolsConfig } from \"./uiBlockingStore.config\";\nimport type { UIBlockingStore } from \"./uiBlockingStore.types\";\n\n/**\n * UI Blocking Store\n *\n * Global Zustand store for managing UI blocking state across the application.\n *\n * Features:\n * - Priority-based blocking system\n * - Scope-based blocking (global, specific areas, or multiple scopes)\n * - Automatic cleanup on unmount (when using hooks)\n * - DevTools integration for debugging\n *\n */\nexport const useUIBlockingStore = create<UIBlockingStore>()(\n  devtools(createUIBlockingActions, devtoolsConfig)\n);\n","import { useEffect } from \"react\";\nimport { useUIBlockingStore } from \"../store\";\nimport type { BlockerConfig } from \"../store\";\n\n/**\n * Hook to automatically add and remove a blocker based on component lifecycle\n *\n * Automatically adds a blocker when the component mounts (or when activated)\n * and removes it when the component unmounts (or when deactivated).\n *\n * @param blockerId - Unique identifier for the blocker\n * @param config - Blocker configuration (scope, reason, priority)\n * @param isActive - Whether the blocker is currently active (default: true)\n *\n */\nexport const useBlocker = (blockerId: string, config: BlockerConfig, isActive = true): void => {\n  const { addBlocker, removeBlocker } = useUIBlockingStore();\n\n  useEffect(() => {\n    if (!isActive || !blockerId) {\n      return;\n    }\n\n    addBlocker(blockerId, config);\n\n    return () => {\n      removeBlocker(blockerId);\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [blockerId, isActive, addBlocker, removeBlocker]);\n};\n","import { useUIBlockingStore } from \"../store\";\n\n/**\n * Hook to check if a scope is currently blocked\n *\n * Returns a boolean indicating whether the specified scope(s) are blocked.\n * Automatically re-renders when the blocking state changes.\n *\n * @param scope - Scope or array of scopes to check (default: \"global\")\n * @returns True if any of the specified scopes are blocked\n *\n */\nexport const useIsBlocked = (scope?: string | ReadonlyArray<string>): boolean => {\n  return useUIBlockingStore((state) => state.isBlocked(scope));\n};\n","import { useCallback } from \"react\";\nimport { useUIBlockingStore } from \"../store\";\nimport { ASYNC_ACTION_PRIORITY } from \"../store\";\n\n/**\n * Hook to wrap async functions with automatic blocking/unblocking\n *\n * Creates a wrapper function that automatically adds a blocker before executing\n * the async function and removes it after completion (success or failure).\n *\n * @template T - The return type of the async function\n * @param actionId - Unique identifier for the action (used in blocker ID and reason)\n * @param scope - Scope(s) to block during execution (default: \"global\")\n * @returns Function that wraps async functions with blocking behavior\n *\n */\nexport const useAsyncAction = <T = unknown>(\n  actionId: string,\n  scope?: string | ReadonlyArray<string>\n): ((asyncFn: () => Promise<T>) => Promise<T>) => {\n  const { addBlocker, removeBlocker } = useUIBlockingStore();\n\n  const executeWithBlocking = useCallback(\n    async (asyncFn: () => Promise<T>): Promise<T> => {\n      const blockerId = `${actionId}-${Date.now().toString()}`;\n\n      try {\n        addBlocker(blockerId, {\n          scope,\n          reason: `Executing ${actionId}`,\n          priority: ASYNC_ACTION_PRIORITY,\n        });\n\n        return await asyncFn();\n      } finally {\n        removeBlocker(blockerId);\n      }\n    },\n    [actionId, scope, addBlocker, removeBlocker]\n  );\n\n  return executeWithBlocking;\n};\n"]}
+{"version":3,"sources":["../src/store/uiBlockingStore.constants.ts","../src/store/uiBlockingStore.utils.ts","../src/store/uiBlockingStore.actions.ts","../src/store/uiBlockingStore.config.ts","../src/store/uiBlockingStore.store.ts","../src/hooks/useBlocker.ts","../src/hooks/useIsBlocked.ts","../src/hooks/useAsyncAction.ts","../src/hooks/useConfigRef.ts","../src/hooks/useBlocker.utils.ts","../src/hooks/useConditionalBlocker.ts","../src/hooks/useConfirmableBlocker.ts","../src/hooks/useScheduledBlocker.ts","../src/middleware/loggerMiddleware.utils.ts","../src/middleware/loggerMiddleware.ts","../src/middleware/analyticsMiddleware.utils.ts","../src/middleware/analyticsMiddleware.ts","../src/middleware/performanceMiddleware.utils.ts","../src/middleware/performanceMiddleware.ts"],"names":["useEffect","useRef","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Default values and constants for UI Blocking Store\n */\n\n/**\n * Default scope for blockers\n */\nexport const DEFAULT_SCOPE = \"global\" as const;\n\n/**\n * Default reason when none is provided\n */\nexport const DEFAULT_REASON = \"Unknown\" as const;\n\n/**\n * Default priority for blockers\n */\nexport const DEFAULT_PRIORITY = 0 as const;\n\n/**\n * Default priority for async actions\n */\nexport const ASYNC_ACTION_PRIORITY = 20 as const;\n\n/**\n * DevTools store name\n */\nexport const DEVTOOLS_NAME = \"UIBlocking\" as const;\n","/**\n * Normalize scope to array format\n *\n * @param scope - Single scope or array of scopes\n * @returns Array of scopes\n *\n * @internal\n */\nexport function normalizeScopeToArray(scope: string | ReadonlyArray<string>): Array<string> {\n  if (typeof scope === \"string\") {\n    return [scope];\n  }\n  return Array.from(scope);\n}\n","import type { StateCreator } from \"zustand\";\nimport type { BlockerConfig, BlockerInfo, StoredBlocker, UIBlockingStore } from \"./uiBlockingStore.types\";\nimport { DEFAULT_SCOPE, DEFAULT_REASON, DEFAULT_PRIORITY } from \"./uiBlockingStore.constants\";\nimport { normalizeScopeToArray } from \"./uiBlockingStore.utils\";\nimport { Middleware, MiddlewareContext } from \"../middleware\";\n\n/**\n * UI Blocking Store Slice\n *\n * Implements the state and actions for UI blocking management.\n * This slice follows the Zustand slice pattern for better code organization.\n */\nexport const createUIBlockingActions: StateCreator<UIBlockingStore, [], [], UIBlockingStore> = (set, get) => ({\n  // State\n  activeBlockers: new Map(),\n  middlewares: new Map(),\n\n  registerMiddleware: (name: string, middleware: Middleware) => {\n    set((state) => {\n      const newMiddlewares = new Map(state.middlewares);\n      newMiddlewares.set(name, middleware);\n      return { middlewares: newMiddlewares };\n    });\n    console.log(`[UIBlocking] Registered middleware: ${name}`);\n  },\n\n  unregisterMiddleware: (name: string) => {\n    set((state) => {\n      const newMiddlewares = new Map(state.middlewares);\n      newMiddlewares.delete(name);\n      return { middlewares: newMiddlewares };\n    });\n    console.log(`[UIBlocking] Unregistered middleware: ${name}`);\n  },\n\n  runMiddlewares: async (context: MiddlewareContext) => {\n    const { middlewares } = get();\n\n    for (const [name, middleware] of middlewares) {\n      try {\n        await middleware(context);\n      } catch (error) {\n        console.error(`[UIBlocking] Middleware \"${name}\" error:`, error);\n      }\n    }\n  },\n\n  // Actions\n  /**\n   * Add a blocker to the store\n   *\n   * @param id - Unique blocker identifier\n   * @param config - Optional blocker configuration\n   *\n   */\n  addBlocker: (id: string, config: BlockerConfig = {}): void => {\n    set((state) => {\n      const newBlockers = new Map(state.activeBlockers);\n      const storedBlocker: StoredBlocker = {\n        scope: config.scope ?? DEFAULT_SCOPE,\n        reason: config.reason ?? DEFAULT_REASON,\n        priority: config.priority ?? DEFAULT_PRIORITY,\n        timestamp: config.timestamp ?? Date.now(),\n      };\n      newBlockers.set(id, storedBlocker);\n\n      return { activeBlockers: newBlockers };\n    });\n\n    void get().runMiddlewares({\n      action: \"add\",\n      blockerId: id,\n      config: {\n        scope: config.scope,\n        reason: config.reason,\n        priority: config.priority,\n      },\n      timestamp: Date.now(),\n    });\n  },\n\n  /**\n   * Remove a blocker from the store\n   *\n   * @param id - Blocker identifier to remove\n   *\n   */\n  removeBlocker: (id: string): void => {\n    const prevBlocker = get().activeBlockers.get(id);\n\n    set((state) => {\n      const newBlockers = new Map(state.activeBlockers);\n      newBlockers.delete(id);\n\n      return { activeBlockers: newBlockers };\n    });\n\n    if (prevBlocker) {\n      void get().runMiddlewares({\n        action: \"remove\",\n        blockerId: id,\n        config: prevBlocker,\n        timestamp: Date.now(),\n        prevState: prevBlocker,\n      });\n    }\n  },\n\n  /**\n   * Check if a scope is currently blocked\n   *\n   * @param scope - Scope or array of scopes to check (default: \"global\")\n   * @returns True if any of the scopes are blocked\n   *\n   */\n  isBlocked: (scope: string | ReadonlyArray<string> = DEFAULT_SCOPE): boolean => {\n    const { activeBlockers } = get();\n    const scopes = normalizeScopeToArray(scope);\n\n    for (const [, blocker] of activeBlockers) {\n      // Global blocking blocks everything\n      if (blocker.scope === DEFAULT_SCOPE) {\n        return true;\n      }\n\n      // Check scope intersection\n      const blockerScopes = normalizeScopeToArray(blocker.scope);\n\n      if (scopes.some((s) => blockerScopes.includes(s))) {\n        return true;\n      }\n    }\n\n    return false;\n  },\n\n  /**\n   * Get detailed blocking information for a specific scope\n   *\n   * @param scope - Scope to get blocking information for\n   * @returns Array of blockers affecting the scope, sorted by priority (highest first)\n   *\n   */\n  getBlockingInfo: (scope: string): ReadonlyArray<BlockerInfo> => {\n    const { activeBlockers } = get();\n    const blockers: Array<BlockerInfo> = [];\n\n    for (const [id, blocker] of activeBlockers) {\n      const blockerScopes = normalizeScopeToArray(blocker.scope);\n\n      if (blocker.scope === DEFAULT_SCOPE || blockerScopes.includes(scope)) {\n        blockers.push({ id, ...blocker });\n      }\n    }\n\n    return blockers.sort((a, b) => b.priority - a.priority);\n  },\n\n  /**\n   * Clear all blockers from the store\n   */\n  clearAllBlockers: (): void => {\n    set({ activeBlockers: new Map() });\n  },\n\n  /**\n   * Clear all blockers for a specific scope\n   *\n   * @param scope - Scope to clear blockers for\n   *\n   */\n  clearBlockersForScope: (scope: string): void => {\n    set((state) => {\n      const newBlockers = new Map();\n\n      for (const [id, blocker] of state.activeBlockers) {\n        const blockerScopes = normalizeScopeToArray(blocker.scope);\n\n        if (!blockerScopes.includes(scope)) {\n          newBlockers.set(id, blocker);\n        }\n      }\n\n      return { activeBlockers: newBlockers };\n    });\n  },\n});\n","import type { DevtoolsOptions } from \"zustand/middleware\";\nimport { DEVTOOLS_NAME } from \"./uiBlockingStore.constants\";\n\n/**\n * DevTools configuration for UI Blocking Store\n *\n * Enables Redux DevTools integration only in development mode\n * for better debugging experience without production overhead.\n */\nexport const devtoolsConfig: DevtoolsOptions = {\n  name: DEVTOOLS_NAME,\n  enabled: process.env.NODE_ENV !== \"production\",\n};\n","import { create } from \"zustand\";\nimport { devtools } from \"zustand/middleware\";\nimport { createUIBlockingActions } from \"./uiBlockingStore.actions\";\nimport { devtoolsConfig } from \"./uiBlockingStore.config\";\nimport type { UIBlockingStore } from \"./uiBlockingStore.types\";\n\n/**\n * UI Blocking Store\n *\n * Global Zustand store for managing UI blocking state across the application.\n *\n * Features:\n * - Priority-based blocking system\n * - Scope-based blocking (global, specific areas, or multiple scopes)\n * - Automatic cleanup on unmount (when using hooks)\n * - DevTools integration for debugging\n *\n */\nexport const useUIBlockingStore = create<UIBlockingStore>()(\n  devtools(createUIBlockingActions, devtoolsConfig)\n);\n","import { useEffect } from \"react\";\nimport { useUIBlockingStore } from \"../store\";\nimport type { BlockerConfig } from \"../store\";\n\n/**\n * Hook to automatically add and remove a blocker based on component lifecycle\n *\n * Automatically adds a blocker when the component mounts (or when activated)\n * and removes it when the component unmounts (or when deactivated).\n *\n * @param blockerId - Unique identifier for the blocker\n * @param config - Blocker configuration (scope, reason, priority)\n * @param isActive - Whether the blocker is currently active (default: true)\n *\n */\nexport const useBlocker = (blockerId: string, config: BlockerConfig, isActive = true): void => {\n  const { addBlocker, removeBlocker } = useUIBlockingStore();\n\n  useEffect(() => {\n    if (!isActive || !blockerId) {\n      return;\n    }\n\n    addBlocker(blockerId, config);\n\n    return () => {\n      removeBlocker(blockerId);\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [blockerId, isActive, addBlocker, removeBlocker]);\n};\n","import { useUIBlockingStore } from \"../store\";\n\n/**\n * Hook to check if a scope is currently blocked\n *\n * Returns a boolean indicating whether the specified scope(s) are blocked.\n * Automatically re-renders when the blocking state changes.\n *\n * @param scope - Scope or array of scopes to check (default: \"global\")\n * @returns True if any of the specified scopes are blocked\n *\n */\nexport const useIsBlocked = (scope?: string | ReadonlyArray<string>): boolean => {\n  return useUIBlockingStore((state) => state.isBlocked(scope));\n};\n","import { useCallback } from \"react\";\nimport { useUIBlockingStore } from \"../store\";\nimport { ASYNC_ACTION_PRIORITY } from \"../store\";\n\n/**\n * Hook to wrap async functions with automatic blocking/unblocking\n *\n * Creates a wrapper function that automatically adds a blocker before executing\n * the async function and removes it after completion (success or failure).\n *\n * @template T - The return type of the async function\n * @param actionId - Unique identifier for the action (used in blocker ID and reason)\n * @param scope - Scope(s) to block during execution (default: \"global\")\n * @returns Function that wraps async functions with blocking behavior\n *\n */\nexport const useAsyncAction = <T = unknown>(\n  actionId: string,\n  scope?: string | ReadonlyArray<string>\n): ((asyncFn: () => Promise<T>) => Promise<T>) => {\n  const { addBlocker, removeBlocker } = useUIBlockingStore();\n\n  const executeWithBlocking = useCallback(\n    async (asyncFn: () => Promise<T>): Promise<T> => {\n      const blockerId = `${actionId}-${Date.now().toString()}`;\n\n      try {\n        addBlocker(blockerId, {\n          scope,\n          reason: `Executing ${actionId}`,\n          priority: ASYNC_ACTION_PRIORITY,\n        });\n\n        return await asyncFn();\n      } finally {\n        removeBlocker(blockerId);\n      }\n    },\n    [actionId, scope, addBlocker, removeBlocker]\n  );\n\n  return executeWithBlocking;\n};\n","import { useRef, useEffect, RefObject } from \"react\";\n\n/**\n * Keeps a ref updated with the latest config value.\n * Useful for accessing current config in callbacks without stale closures.\n *\n * @param config - Configuration object to track\n * @returns Mutable ref that always contains the latest config\n *\n */\nexport function useConfigRef<T>(config: T): RefObject<T> {\n  const configRef = useRef(config);\n\n  useEffect(() => {\n    configRef.current = config;\n  }, [config]);\n\n  return configRef;\n}\n","import { BlockerConfig } from \"../store\";\n\n/**\n * Creates a blocker configuration object from partial config.\n * Filters out undefined values to create a clean BlockerConfig.\n *\n * @param config - Partial blocker configuration\n * @returns Complete BlockerConfig object\n *\n */\nexport function createBlockerConfig(config: {\n  scope?: string | ReadonlyArray<string>;\n  reason?: string;\n  priority?: number;\n}): BlockerConfig {\n  return {\n    scope: config.scope,\n    reason: config.reason,\n    priority: config.priority,\n  };\n}\n","import { useRef, useEffect, useCallback } from \"react\";\nimport { useUIBlockingStore } from \"../store\";\nimport { ConditionalBlockerConfig } from \"./useConditionalBlocker.types\";\nimport { useConfigRef } from \"./useConfigRef\";\nimport { createBlockerConfig } from \"./useBlocker.utils\";\n\n/**\n * Hook for conditional blocking based on a condition function.\n *\n * Periodically checks a condition and blocks/unblocks based on the result.\n * The condition is evaluated at the specified interval (default 1000ms).\n *\n * @param blockerId - Unique identifier for this blocker\n * @param config - Configuration including condition function and check interval\n *\n */\nexport const useConditionalBlocker = <TState = unknown>(\n  blockerId: string,\n  config: ConditionalBlockerConfig<TState>\n): void => {\n  const { addBlocker, removeBlocker } = useUIBlockingStore();\n  const intervalRef = useRef<ReturnType<typeof setInterval> | null>(null);\n  const isBlockedRef = useRef(false);\n  const configRef = useConfigRef(config);\n\n  const checkCondition = useCallback(() => {\n    const currentConfig = configRef.current;\n    const shouldBlock = currentConfig.condition(currentConfig.state);\n\n    // No state change needed\n    if (shouldBlock === isBlockedRef.current) {\n      return;\n    }\n\n    if (shouldBlock) {\n      addBlocker(blockerId, createBlockerConfig(currentConfig));\n      isBlockedRef.current = true;\n    } else {\n      removeBlocker(blockerId);\n      isBlockedRef.current = false;\n    }\n  }, [blockerId, addBlocker, removeBlocker, configRef]);\n\n  useEffect(() => {\n    checkCondition();\n\n    const interval = configRef.current.checkInterval ?? 1000;\n    intervalRef.current = setInterval(checkCondition, interval);\n\n    return (): void => {\n      if (intervalRef.current) {\n        clearInterval(intervalRef.current);\n        intervalRef.current = null;\n      }\n      if (isBlockedRef.current) {\n        removeBlocker(blockerId);\n        isBlockedRef.current = false;\n      }\n    };\n    // configRef is stable and doesn't need to be in dependencies\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [checkCondition, blockerId, removeBlocker]);\n};\n","import { useState, useCallback } from \"react\";\nimport { useBlocker } from \"./useBlocker\";\nimport { ConfirmableBlockerConfig, UseConfirmableBlockerReturn } from \"./useConfirmableBlocker.types\";\n\n/**\n * Hook for creating a confirmable action with blocking UI\n *\n */\nexport const useConfirmableBlocker = (\n  blockerId: string,\n  config: ConfirmableBlockerConfig\n): UseConfirmableBlockerReturn => {\n  const [isDialogOpen, setIsDialogOpen] = useState(false);\n  const [isExecuting, setIsExecuting] = useState(false);\n\n  useBlocker(\n    blockerId,\n    {\n      ...config,\n      reason: config.reason ?? config.confirmMessage,\n    },\n    isDialogOpen || isExecuting\n  );\n\n  const execute = useCallback(() => {\n    setIsDialogOpen(true);\n  }, []);\n\n  const onConfirm = useCallback(async () => {\n    setIsDialogOpen(false);\n    setIsExecuting(true);\n\n    try {\n      await config.onConfirm();\n    } catch (error) {\n      console.error(\"[UIBlocking] Confirmable action error:\", error);\n      throw error;\n    } finally {\n      setIsExecuting(false);\n    }\n  }, [config]);\n\n  const onCancel = useCallback(() => {\n    setIsDialogOpen(false);\n    config.onCancel?.();\n  }, [config]);\n\n  return {\n    execute,\n    isDialogOpen,\n    isExecuting,\n    confirmConfig: {\n      title: config.confirmTitle ?? \"Confirm Action\",\n      message: config.confirmMessage,\n      confirmText: config.confirmButtonText ?? \"Confirm\",\n      cancelText: config.cancelButtonText ?? \"Cancel\",\n    },\n    onConfirm,\n    onCancel,\n  };\n};\n","import { useEffect, useRef, useCallback } from \"react\";\nimport { useUIBlockingStore } from \"../store\";\nimport { ScheduledBlockerConfig } from \"./useScheduledBlocker.types\";\nimport { useConfigRef } from \"./useConfigRef\";\nimport { createBlockerConfig } from \"./useBlocker.utils\";\n\n/**\n * Hook for scheduling UI blocking for a specific time period.\n *\n * Blocks UI during a scheduled maintenance window or time period.\n * Supports start/end times as Date objects, ISO strings, or timestamps.\n * If both duration and end are provided, duration takes precedence.\n *\n * @param blockerId - Unique identifier for this blocker\n * @param config - Configuration including schedule and callbacks\n *\n */\nexport const useScheduledBlocker = (blockerId: string, config: ScheduledBlockerConfig): void => {\n  const { addBlocker, removeBlocker } = useUIBlockingStore();\n  const timeoutsRef = useRef<{\n    start?: ReturnType<typeof setTimeout>;\n    end?: ReturnType<typeof setTimeout>;\n  }>({});\n  const configRef = useConfigRef(config);\n\n  const cleanup = useCallback(() => {\n    if (timeoutsRef.current.start) {\n      clearTimeout(timeoutsRef.current.start);\n      timeoutsRef.current.start = undefined;\n    }\n    if (timeoutsRef.current.end) {\n      clearTimeout(timeoutsRef.current.end);\n      timeoutsRef.current.end = undefined;\n    }\n  }, []);\n\n  useEffect(() => {\n    const currentConfig = configRef.current;\n    const startTime = new Date(currentConfig.schedule.start).getTime();\n    const now = Date.now();\n\n    let endTime: number | undefined;\n    if (currentConfig.schedule.duration) {\n      endTime = startTime + currentConfig.schedule.duration;\n    } else if (currentConfig.schedule.end) {\n      endTime = new Date(currentConfig.schedule.end).getTime();\n    }\n\n    const scheduleEnd = (end: number): void => {\n      const remainingTime = end - Date.now();\n      if (remainingTime > 0) {\n        timeoutsRef.current.end = setTimeout(() => {\n          removeBlocker(blockerId);\n          configRef.current.onScheduleEnd?.();\n        }, remainingTime);\n      }\n    };\n\n    // If start time hasn't arrived yet\n    if (startTime > now) {\n      timeoutsRef.current.start = setTimeout(() => {\n        const cfg = configRef.current;\n        addBlocker(blockerId, createBlockerConfig(cfg));\n        cfg.onScheduleStart?.();\n\n        if (endTime) {\n          scheduleEnd(endTime);\n        }\n      }, startTime - now);\n    }\n    // If already in blocking period\n    else if (endTime && endTime > now) {\n      addBlocker(blockerId, createBlockerConfig(currentConfig));\n      currentConfig.onScheduleStart?.();\n      scheduleEnd(endTime);\n    }\n    // If schedule without end/duration\n    else if (!endTime && startTime <= now) {\n      addBlocker(blockerId, createBlockerConfig(currentConfig));\n      currentConfig.onScheduleStart?.();\n    } else {\n      console.warn(`[UIBlocking] Schedule is in the past for blocker \"${blockerId}\"`);\n    }\n\n    return (): void => {\n      cleanup();\n      removeBlocker(blockerId);\n    };\n    // configRef is stable and doesn't need to be in dependencies\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [blockerId, addBlocker, removeBlocker, cleanup]);\n};\n","import { MiddlewareBlockerConfig, MiddlewareContext } from \"./middleware.types\";\n\nexport const getActionEmoji = (action: string): string => {\n  switch (action) {\n    case \"add\":\n      return \"➕\";\n    case \"remove\":\n      return \"➖\";\n    case \"update\":\n      return \"🔄\";\n    case \"cancel\":\n      return \"❌\";\n    case \"timeout\":\n      return \"⏱️\";\n    default:\n      return \"❓\";\n  }\n};\n\nconst extractConfigDetails = (config?: MiddlewareBlockerConfig): Record<string, unknown> => {\n  if (!config) {\n    return {};\n  }\n\n  const { scope, reason, priority } = config;\n\n  const details: Record<string, unknown> = {\n    scope,\n    reason,\n  };\n\n  if (priority !== undefined) {\n    details.priority = priority;\n  }\n\n  return details;\n};\n\nexport const formatLogData = (context: MiddlewareContext): Record<string, unknown> => {\n  const configDetails = extractConfigDetails(context.config);\n\n  if (context.prevState) {\n    return {\n      config: configDetails,\n      prevState: extractConfigDetails(context.prevState),\n    };\n  }\n\n  return configDetails;\n};\n","import { getActionEmoji, formatLogData } from \"./loggerMiddleware.utils\";\nimport { Middleware } from \"./middleware.types\";\n\nconst LOG_PREFIX = \"[UIBlocking]\";\n\nexport const loggerMiddleware: Middleware = (context) => {\n  const emoji = getActionEmoji(context.action);\n  const logData = formatLogData(context);\n\n  console.log(LOG_PREFIX, emoji, context.blockerId, logData);\n};\n","import { AnalyticsEventData } from \"./analyticsMiddleware.types\";\nimport { MiddlewareContext } from \"./middleware.types\";\n\nconst capitalizeFirst = (str: string): string => {\n  return str.charAt(0).toUpperCase() + str.slice(1);\n};\n\nexport const buildEventData = (context: MiddlewareContext): AnalyticsEventData => {\n  const eventData: AnalyticsEventData = {\n    blocker_id: context.blockerId,\n  };\n  const { scope, reason, priority } = context.config ?? {};\n\n  if (scope !== undefined) {\n    eventData.scope = Array.isArray(scope) ? scope.join(\",\") : scope;\n  }\n\n  if (reason !== undefined) {\n    eventData.reason = reason;\n  }\n\n  if (priority !== undefined) {\n    eventData.priority = priority;\n  }\n\n  return eventData;\n};\n\nexport const trackGoogleAnalytics = (action: string, eventData: AnalyticsEventData): void => {\n  if (window.gtag) {\n    window.gtag(\"event\", `ui_blocking_${action}`, eventData);\n  }\n};\n\nexport const trackMixpanel = (action: string, eventData: AnalyticsEventData): void => {\n  if (window.mixpanel) {\n    const eventName = `UI Blocking ${action.split(\"_\").map(capitalizeFirst).join(\" \")}`;\n\n    window.mixpanel.track(eventName, eventData);\n  }\n};\n\nexport const trackAmplitude = (action: string, eventData: AnalyticsEventData): void => {\n  if (window.amplitude) {\n    const eventName = `UI Blocking ${action.split(\"_\").map(capitalizeFirst).join(\" \")}`;\n\n    window.amplitude.track(eventName, eventData);\n  }\n};\n\nexport const trackCustom = (\n  trackFn: (event: string, data: AnalyticsEventData) => void,\n  action: string,\n  eventData: AnalyticsEventData\n): void => {\n  try {\n    trackFn(`ui_blocking_${action}`, eventData);\n  } catch {\n    // Silently ignore errors in custom tracker\n  }\n};\n","import { AnalyticsConfig, AnalyticsEventData } from \"./analyticsMiddleware.types\";\nimport {\n  buildEventData,\n  trackGoogleAnalytics,\n  trackMixpanel,\n  trackAmplitude,\n  trackCustom,\n} from \"./analyticsMiddleware.utils\";\nimport { Middleware, MiddlewareContext } from \"./middleware.types\";\n\nconst trackEvent = (config: AnalyticsConfig, context: MiddlewareContext, eventData: AnalyticsEventData): void => {\n  if (\"provider\" in config) {\n    switch (config.provider) {\n      case \"ga\":\n        trackGoogleAnalytics(context.action, eventData);\n        return;\n      case \"mixpanel\":\n        trackMixpanel(context.action, eventData);\n        return;\n      case \"amplitude\":\n        trackAmplitude(context.action, eventData);\n        return;\n    }\n  }\n\n  if (\"track\" in config) {\n    trackCustom(config.track, context.action, eventData);\n  }\n};\n\nexport const createAnalyticsMiddleware = (config: AnalyticsConfig): Middleware => {\n  return (context) => {\n    const eventData = buildEventData(context);\n\n    trackEvent(config, context, eventData);\n  };\n};\n","export const handleAddAction = (blockerId: string, timestamp: number, blockStartTimes: Map<string, number>): void => {\n  blockStartTimes.set(blockerId, timestamp);\n};\n","import { Middleware, MiddlewareContext } from \"./middleware.types\";\nimport { PerformanceConfig } from \"./performanceMiddleware.types\";\nimport { handleAddAction } from \"./performanceMiddleware.utils\";\n\nconst DEFAULT_SLOW_BLOCK_THRESHOLD = 3000;\nconst ACTION_ADD = \"add\";\nconst ACTION_REMOVE = \"remove\";\n\nconst handleRemoveAction = (\n  context: MiddlewareContext,\n  blockStartTimes: Map<string, number>,\n  slowBlockThreshold: number,\n  onSlowBlock?: (blockerId: string, duration: number) => void\n): void => {\n  const startTime = blockStartTimes.get(context.blockerId);\n\n  if (startTime === undefined) {\n    return;\n  }\n\n  const duration = context.timestamp - startTime;\n  blockStartTimes.delete(context.blockerId);\n\n  if (duration >= slowBlockThreshold) {\n    console.warn(`[UIBlocking] Slow block detected: \"${context.blockerId}\" took ${duration.toString()}ms`);\n\n    onSlowBlock?.(context.blockerId, duration);\n  }\n};\n\nexport const createPerformanceMiddleware = (config: PerformanceConfig = {}): Middleware => {\n  const { slowBlockThreshold = DEFAULT_SLOW_BLOCK_THRESHOLD, onSlowBlock } = config;\n  const blockStartTimes = new Map<string, number>();\n\n  return (context) => {\n    if (context.action === ACTION_ADD) {\n      handleAddAction(context.blockerId, context.timestamp, blockStartTimes);\n    } else if (context.action === ACTION_REMOVE) {\n      handleRemoveAction(context, blockStartTimes, slowBlockThreshold, onSlowBlock);\n    }\n  };\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okyrychenko-dev/react-action-guard",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "type": "module",
   "description": "Elegant UI blocking management for React applications with priorities, scopes, and automatic cleanup",
   "main": "./dist/index.js",
@@ -9,10 +9,11 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
     }
   },
+  "sideEffects": false,
   "files": [
     "dist",
     "README.md",
@@ -43,7 +44,7 @@
     "loading",
     "async-operations"
   ],
-  "author": "Oleksandr Kyrychenko <your@email.com>",
+  "author": "Olexii Kyrychenko alexey.kirichenko@gmail.com",
   "license": "MIT",
   "repository": {
     "type": "git",