@squide/firefly 13.3.1 → 14.0.0

package/CHANGELOG.md

@@ -1,5 +1,63 @@
 # @squide/firefly
 
+## 14.0.0
+
+### Major Changes
+
+- [#311](https://github.com/workleap/wl-squide/pull/311) [`cc52e8b`](https://github.com/workleap/wl-squide/commit/cc52e8bfbe9d3d215f51d12755743f17c0c69772) Thanks [@patricklafrance](https://github.com/patricklafrance)! - Deferred registration functions now receives a runtime instance as the first argument. This new scope runtime instance should used whenever runtime access is required within a deferred registration function scope.
+
+  Before:
+
+  The `runtime` argument of the registration function is used to register the navigation item.
+
+  ```ts !#1,2,4
+  export const register: ModuleRegisterFunction<
+    FireflyRuntime,
+    unknown,
+    DeferredRegistrationData
+  > = (runtime) => {
+    return ({ featureFlags }, operation) => {
+      if (featureFlags.featureA) {
+        runtime.registerNavigationItem({
+          $id: "feature-a",
+          $label: operation === "register" ? "Feature A" : "Feature A updated",
+          to: "/feature-a",
+        });
+      }
+    };
+  };
+  ```
+
+  After:
+
+  The `deferredRuntime` argument of the **deferred** registration function is used to register the navigation item.
+
+  ```ts !#2,4
+  export const register: ModuleRegisterFunction<
+    FireflyRuntime,
+    unknown,
+    DeferredRegistrationData
+  > = (runtime) => {
+    return (deferredRuntime, { featureFlags }, operation) => {
+      if (featureFlags.featureA) {
+        deferredRuntime.registerNavigationItem({
+          $id: "feature-a",
+          $label: operation === "register" ? "Feature A" : "Feature A updated",
+          to: "/feature-a",
+        });
+      }
+    };
+  };
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`cc52e8b`](https://github.com/workleap/wl-squide/commit/cc52e8bfbe9d3d215f51d12755743f17c0c69772)]:
+  - @squide/module-federation@7.0.0
+  - @squide/react-router@8.0.0
+  - @squide/core@6.0.0
+  - @squide/msw@4.0.0
+
 ## 13.3.1
 
 ### Patch Changes

package/dist/AppRouterReducer.js

@@ -160,13 +160,10 @@ function useModuleRegistrationStatusDispatcher(areModulesRegisteredValue, areMod
             dispatch({
                 type: "modules-registered"
             });
-            logger.withText("[squide]").withText("Modules are registered", {
+            logger.withText("[squide] Modules are registered.", {
                 style: {
-                    color: "white",
-                    backgroundColor: "green"
+                    color: "green"
                 }
-            }).withText(".", {
-                leadingSpace: false
             }).information();
             return true;
         }
@@ -180,13 +177,10 @@ function useModuleRegistrationStatusDispatcher(areModulesRegisteredValue, areMod
             dispatch({
                 type: "modules-ready"
             });
-            logger.withText("[squide]").withText("Modules are ready", {
+            logger.withText("[squide] Modules are ready.", {
                 style: {
-                    color: "white",
-                    backgroundColor: "green"
+                    color: "green"
                 }
-            }).withText(".", {
-                leadingSpace: false
             }).information();
             return true;
         }
@@ -224,13 +218,10 @@ function useMswStatusDispatcher(isMswReadyValue, dispatch) {
             dispatch({
                 type: "msw-ready"
             });
-            logger.withText("[squide]").withText("MSW is ready", {
+            logger.withText("[squide] MSW is ready.", {
                 style: {
-                    color: "white",
-                    backgroundColor: "green"
+                    color: "green"
                 }
-            }).withText(".", {
-                leadingSpace: false
             }).information();
             return true;
         }

package/dist/AppRouterReducer.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppRouterReducer.js","sources":["webpack://@squide/firefly/./src/AppRouterReducer.ts"],"sourcesContent":["import { addLocalModuleRegistrationStatusChangedListener, getLocalModuleRegistrationStatus, removeLocalModuleRegistrationStatusChangedListener, useEventBus, useLogger, useRuntime } from \"@squide/core\";\nimport { addRemoteModuleRegistrationStatusChangedListener, areModulesReady, areModulesRegistered, getRemoteModuleRegistrationStatus, removeRemoteModuleRegistrationStatusChangedListener } from \"@squide/module-federation\";\nimport { addMswStateChangedListener, isMswReady, removeMswStateChangedListener } from \"@squide/msw\";\nimport { useCallback, useEffect, useMemo, useReducer, type Dispatch } from \"react\";\nimport type { FireflyRuntime } from \"./FireflyRuntime.tsx\";\nimport { useAppRouterStore } from \"./useAppRouterStore.ts\";\nimport { useExecuteOnce } from \"./useExecuteOnce.ts\";\nimport { isBootstrapping } from \"./useIsBootstrapping.ts\";\n\nexport type ActiveRouteVisiblity = \"unknown\" | \"public\" | \"protected\";\n\nexport interface AppRouterWaitState {\n    waitForMsw: boolean;\n    waitForPublicData: boolean;\n    waitForProtectedData: boolean;\n}\n\nexport interface AppRouterState extends AppRouterWaitState {\n    areModulesRegistered: boolean;\n    areModulesReady: boolean;\n    isMswReady: boolean;\n    isPublicDataReady: boolean;\n    isProtectedDataReady: boolean;\n    publicDataUpdatedAt?: number;\n    protectedDataUpdatedAt?: number;\n    deferredRegistrationsUpdatedAt?: number;\n    activeRouteVisibility: ActiveRouteVisiblity;\n    isUnauthorized: boolean;\n}\n\nexport type AppRouterActionType =\n| \"modules-registered\"\n| \"modules-ready\"\n| \"msw-ready\"\n| \"public-data-ready\"\n| \"protected-data-ready\"\n| \"public-data-updated\"\n| \"protected-data-updated\"\n| \"deferred-registrations-updated\"\n| \"active-route-is-public\"\n| \"active-route-is-protected\"\n| \"is-unauthorized\";\n\n// The followings event const are a concatenation of \"squide-\" with AppRouterActionType.\n// They are dispatched by the useEnhancedReducerDispatch hook.\nexport const ModulesRegisteredEvent = \"squide-modules-registered\";\nexport const ModulesReadyEvent = \"squide-modules-ready\";\nexport const MswReadyEvent = \"squide-msw-ready\";\nexport const ActiveRouteIsPublicEvent = \"squide-active-route-is-public\";\nexport const ActiveRouteIsProtectedEvent = \"squide-active-route-is-protected\";\nexport const PublicDataReadyEvent = \"squide-public-data-ready\";\nexport const ProtectedDataReadyEvent = \"squide-protected-data-ready\";\nexport const PublicDataUpdatedEvent = \"squide-public-data-updated\";\nexport const ProtectedDataUpdatedEvent = \"squide-protected-data-updated\";\nexport const DeferredRegistrationsUpdatedEvent = \"squide-deferred-registrations-updated\";\nexport const ApplicationBoostrappedEvent = \"squide-app-boostrapped\";\n\nexport interface AppRouterAction {\n    type: AppRouterActionType;\n    payload?: unknown;\n}\n\nexport type AppRouterDispatch = Dispatch<AppRouterAction>;\n\nfunction reducer(state: AppRouterState, action: AppRouterAction) {\n    let newState = state;\n\n    switch (action.type) {\n        case \"modules-registered\": {\n            newState = {\n                ...newState,\n                areModulesRegistered: true\n            };\n\n            break;\n        }\n        case \"modules-ready\": {\n            newState = {\n                ...newState,\n                areModulesReady: true,\n                // Will be set even if the app is not using deferred registrations.\n                deferredRegistrationsUpdatedAt: Date.now()\n            };\n\n            break;\n        }\n        case \"msw-ready\": {\n            newState = {\n                ...newState,\n                isMswReady: true\n            };\n\n            break;\n        }\n        case \"public-data-ready\": {\n            newState = {\n                ...newState,\n                isPublicDataReady: true,\n                publicDataUpdatedAt: Date.now()\n            };\n\n            break;\n        }\n        case \"protected-data-ready\": {\n            newState = {\n                ...newState,\n                isProtectedDataReady: true,\n                protectedDataUpdatedAt: Date.now()\n            };\n\n            break;\n        }\n        case \"public-data-updated\": {\n            newState = {\n                ...newState,\n                publicDataUpdatedAt: Date.now()\n            };\n\n            break;\n        }\n        case \"protected-data-updated\": {\n            newState = {\n                ...newState,\n                protectedDataUpdatedAt: Date.now()\n            };\n\n            break;\n        }\n        case \"deferred-registrations-updated\": {\n            newState = {\n                ...newState,\n                deferredRegistrationsUpdatedAt: Date.now()\n            };\n\n            break;\n        }\n        case \"active-route-is-public\": {\n            newState = {\n                ...newState,\n                activeRouteVisibility: \"public\"\n            };\n\n            break;\n        }\n        case \"active-route-is-protected\": {\n            newState = {\n                ...newState,\n                activeRouteVisibility: \"protected\"\n            };\n\n            break;\n        }\n        case \"is-unauthorized\": {\n            newState = {\n                ...newState,\n                isUnauthorized: true\n            };\n\n            break;\n        }\n        default: {\n            throw new Error(`[squide] The AppRouter component state reducer doesn't support action type \"${action.type}\".`);\n        }\n    }\n\n    return newState;\n}\n\nexport function getAreModulesRegistered() {\n    const localModuleStatus = getLocalModuleRegistrationStatus();\n    const remoteModuleStatus = getRemoteModuleRegistrationStatus();\n\n    return areModulesRegistered(localModuleStatus, remoteModuleStatus);\n}\n\nexport function getAreModulesReady() {\n    const localModuleStatus = getLocalModuleRegistrationStatus();\n    const remoteModuleStatus = getRemoteModuleRegistrationStatus();\n\n    return areModulesReady(localModuleStatus, remoteModuleStatus);\n}\n\nexport function useModuleRegistrationStatusDispatcher(areModulesRegisteredValue: boolean, areModulesReadyValue: boolean, dispatch: AppRouterDispatch) {\n    const logger = useLogger();\n\n    const dispatchModulesRegistered = useExecuteOnce(useCallback(() => {\n        if (getAreModulesRegistered()) {\n            dispatch({ type: \"modules-registered\" });\n\n            logger\n                .withText(\"[squide]\")\n                .withText(\"Modules are registered\", {\n                    style: {\n                        color: \"white\",\n                        backgroundColor: \"green\"\n                    }\n                })\n                .withText(\".\", {\n                    leadingSpace: false\n                })\n                .information();\n\n            return true;\n        }\n\n        return false;\n    }, [dispatch, logger]));\n\n    const dispatchModulesReady = useExecuteOnce(useCallback(() => {\n        if (getAreModulesReady()) {\n            dispatch({ type: \"modules-ready\" });\n\n            logger\n                .withText(\"[squide]\")\n                .withText(\"Modules are ready\", {\n                    style: {\n                        color: \"white\",\n                        backgroundColor: \"green\"\n                    }\n                })\n                .withText(\".\", {\n                    leadingSpace: false\n                })\n                .information();\n\n            return true;\n        }\n\n        return false;\n    }, [dispatch, logger]));\n\n    return useEffect(() => {\n        if (!areModulesRegisteredValue) {\n            addLocalModuleRegistrationStatusChangedListener(dispatchModulesRegistered);\n            addRemoteModuleRegistrationStatusChangedListener(dispatchModulesRegistered);\n        }\n\n        if (!areModulesReadyValue) {\n            addLocalModuleRegistrationStatusChangedListener(dispatchModulesReady);\n            addRemoteModuleRegistrationStatusChangedListener(dispatchModulesReady);\n        }\n\n        return () => {\n            removeLocalModuleRegistrationStatusChangedListener(dispatchModulesRegistered);\n            removeRemoteModuleRegistrationStatusChangedListener(dispatchModulesRegistered);\n\n            removeLocalModuleRegistrationStatusChangedListener(dispatchModulesReady);\n            removeRemoteModuleRegistrationStatusChangedListener(dispatchModulesReady);\n        };\n    }, [areModulesRegisteredValue, areModulesReadyValue, dispatchModulesRegistered, dispatchModulesReady]);\n}\n\nexport function useMswStatusDispatcher(isMswReadyValue: boolean, dispatch: AppRouterDispatch) {\n    const logger = useLogger();\n\n    const dispatchMswReady = useExecuteOnce(useCallback(() => {\n        if (isMswReady()) {\n            dispatch({ type: \"msw-ready\" });\n\n            logger\n                .withText(\"[squide]\")\n                .withText(\"MSW is ready\", {\n                    style: {\n                        color: \"white\",\n                        backgroundColor: \"green\"\n                    }\n                })\n                .withText(\".\", {\n                    leadingSpace: false\n                })\n                .information();\n\n            return true;\n        }\n\n        return false;\n    }, [dispatch, logger]));\n\n    useEffect(() => {\n        if (!isMswReadyValue) {\n            addMswStateChangedListener(dispatchMswReady);\n        }\n\n        return () => {\n            removeMswStateChangedListener(dispatchMswReady);\n        };\n    }, [isMswReadyValue, dispatchMswReady]);\n}\n\nfunction useBootstrappingCompletedDispatcher(waitState: AppRouterWaitState, state: AppRouterState) {\n    const eventBus = useEventBus();\n\n    const areModulesRegisteredValue = state.areModulesRegistered;\n    const isBoostrapping = isBootstrapping(state);\n\n    useExecuteOnce(useCallback(() => {\n        if (areModulesRegisteredValue && !isBoostrapping) {\n            eventBus.dispatch(ApplicationBoostrappedEvent, waitState);\n\n            return true;\n        }\n\n        return false;\n    }, [areModulesRegisteredValue, isBoostrapping, waitState, eventBus]), true);\n}\n\nlet dispatchProxyFactory: ((reactDispatch: AppRouterDispatch) => AppRouterDispatch) | undefined;\n\n// This function should only be used by tests.\nexport function __setAppReducerDispatchProxyFactory(factory: (reactDispatch: AppRouterDispatch) => AppRouterDispatch) {\n    dispatchProxyFactory = factory;\n}\n\n// This function should only be used by tests.\nexport function __clearAppReducerDispatchProxy() {\n    dispatchProxyFactory = undefined;\n}\n\nfunction useReducerDispatchProxy(reactDispatch: AppRouterDispatch) {\n    return useMemo(() => {\n        return dispatchProxyFactory ? dispatchProxyFactory(reactDispatch) : reactDispatch;\n    }, [reactDispatch]);\n}\n\nfunction useEnhancedReducerDispatch(waitState: AppRouterWaitState, reducerDispatch: AppRouterDispatch) {\n    const logger = useLogger();\n    const appRouterStore = useAppRouterStore();\n    const eventBus = useEventBus();\n\n    return useCallback((action: AppRouterAction) => {\n        logger\n            .withText(\"[squide] The following action has been dispatched to the AppRouter reducer:\")\n            .withObject(action)\n            .debug();\n\n        appRouterStore.dispatch({ ...action, payload: waitState });\n        eventBus.dispatch(`squide-${action.type}`, waitState);\n\n        reducerDispatch(action);\n    }, [waitState, reducerDispatch, logger, appRouterStore, eventBus]);\n}\n\nexport function useAppRouterReducer(waitForPublicData: boolean, waitForProtectedData: boolean): [AppRouterState, AppRouterDispatch] {\n    const runtime = useRuntime() as FireflyRuntime;\n    const eventBus = useEventBus();\n    const appRouterStore = useAppRouterStore();\n\n    const isMswEnabled = runtime.isMswEnabled;\n\n    const areModulesInitiallyRegistered = getAreModulesRegistered();\n    const areModulesInitiallyReady = getAreModulesReady();\n    const isMswInitiallyReady = isMswReady();\n\n    const waitState = useMemo(() => ({\n        waitForMsw: isMswEnabled,\n        waitForPublicData,\n        waitForProtectedData\n    }), [isMswEnabled, waitForPublicData, waitForProtectedData]);\n\n    const initialState = useMemo(() => ({\n        waitForMsw: waitState.waitForMsw,\n        waitForPublicData: waitState.waitForPublicData,\n        waitForProtectedData: waitState.waitForProtectedData,\n        // When the modules registration functions are awaited, the event listeners are registered after the modules are registered.\n        areModulesRegistered: areModulesInitiallyRegistered,\n        areModulesReady: areModulesInitiallyReady,\n        isMswReady: isMswInitiallyReady,\n        isPublicDataReady: false,\n        isProtectedDataReady: false,\n        activeRouteVisibility: \"unknown\",\n        isUnauthorized: false\n    } satisfies AppRouterState), [waitState, areModulesInitiallyRegistered, areModulesInitiallyReady, isMswInitiallyReady]);\n\n    // When modules are initially registered, the reducer action will never be dispatched, therefore the event would not be dispatched as well.\n    // To ensure the bootstrapping events sequencing, the event is manually dispatched when the modules are initially registered.\n    useExecuteOnce(useCallback(() => {\n        if (areModulesInitiallyRegistered) {\n            appRouterStore.dispatch({ type: \"modules-registered\", payload: waitState });\n            eventBus.dispatch(ModulesRegisteredEvent, waitState);\n        }\n\n        return true;\n    }, [areModulesInitiallyRegistered, appRouterStore, eventBus, waitState]), true);\n\n    // When modules are initially registered, the reducer action will never be dispatched, therefore the event would not be dispatched as well.\n    // To ensure the bootstrapping events sequencing, the event is manually dispatched when the modules are initially registered.\n    useExecuteOnce(useCallback(() => {\n        if (areModulesInitiallyReady) {\n            appRouterStore.dispatch({ type: \"modules-ready\", payload: waitState });\n            eventBus.dispatch(ModulesReadyEvent, waitState);\n        }\n\n        return true;\n    }, [areModulesInitiallyReady, appRouterStore, eventBus, waitState]), true);\n\n    // When modules are initially registered, the reducer action will never be dispatched, therefore the event would not be dispatched as well.\n    // To ensure the bootstrapping events sequencing, the event is manually dispatched when the modules are initially registered.\n    useExecuteOnce(useCallback(() => {\n        if (isMswInitiallyReady) {\n            appRouterStore.dispatch({ type: \"msw-ready\", payload: waitState });\n            eventBus.dispatch(MswReadyEvent, waitState);\n        }\n\n        return true;\n    }, [isMswInitiallyReady, appRouterStore, eventBus, waitState]), true);\n\n    const [state, reactDispatch] = useReducer(reducer, initialState);\n\n    const {\n        areModulesRegistered: areModulesRegisteredValue,\n        areModulesReady: areModulesReadyValue,\n        isMswReady: isMswReadyValue\n    } = state;\n\n    // The dispatch proxy is strictly an utility allowing tests to mock the useReducer dispatch function. It's easier\n    // than mocking the import from React.\n    const dispatchProxy = useReducerDispatchProxy(reactDispatch);\n    const dispatch = useEnhancedReducerDispatch(waitState, dispatchProxy);\n\n    useModuleRegistrationStatusDispatcher(areModulesRegisteredValue, areModulesReadyValue, dispatch);\n    useMswStatusDispatcher(isMswReadyValue, dispatch);\n    useBootstrappingCompletedDispatcher(waitState, state);\n\n    return [state, dispatch];\n}\n"],"names":["addLocalModuleRegistrationStatusChangedListener","getLocalModuleRegistrationStatus","removeLocalModuleRegistrationStatusChangedListener","useEventBus","useLogger","useRuntime","addRemoteModuleRegistrationStatusChangedListener","areModulesReady","areModulesRegistered","getRemoteModuleRegistrationStatus","removeRemoteModuleRegistrationStatusChangedListener","addMswStateChangedListener","isMswReady","removeMswStateChangedListener","useCallback","useEffect","useMemo","useReducer","useAppRouterStore","useExecuteOnce","isBootstrapping","ModulesRegisteredEvent","ModulesReadyEvent","MswReadyEvent","ActiveRouteIsPublicEvent","ActiveRouteIsProtectedEvent","PublicDataReadyEvent","ProtectedDataReadyEvent","PublicDataUpdatedEvent","ProtectedDataUpdatedEvent","DeferredRegistrationsUpdatedEvent","ApplicationBoostrappedEvent","reducer","state","action","newState","Date","Error","getAreModulesRegistered","localModuleStatus","remoteModuleStatus","getAreModulesReady","useModuleRegistrationStatusDispatcher","areModulesRegisteredValue","areModulesReadyValue","dispatch","logger","dispatchModulesRegistered","dispatchModulesReady","useMswStatusDispatcher","isMswReadyValue","dispatchMswReady","useBootstrappingCompletedDispatcher","waitState","eventBus","isBoostrapping","dispatchProxyFactory","__setAppReducerDispatchProxyFactory","factory","__clearAppReducerDispatchProxy","undefined","useReducerDispatchProxy","reactDispatch","useEnhancedReducerDispatch","reducerDispatch","appRouterStore","useAppRouterReducer","waitForPublicData","waitForProtectedData","runtime","isMswEnabled","areModulesInitiallyRegistered","areModulesInitiallyReady","isMswInitiallyReady","initialState","dispatchProxy"],"mappings":"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"}
+{"version":3,"file":"AppRouterReducer.js","sources":["webpack://@squide/firefly/./src/AppRouterReducer.ts"],"sourcesContent":["import { addLocalModuleRegistrationStatusChangedListener, getLocalModuleRegistrationStatus, removeLocalModuleRegistrationStatusChangedListener, useEventBus, useLogger, useRuntime } from \"@squide/core\";\nimport { addRemoteModuleRegistrationStatusChangedListener, areModulesReady, areModulesRegistered, getRemoteModuleRegistrationStatus, removeRemoteModuleRegistrationStatusChangedListener } from \"@squide/module-federation\";\nimport { addMswStateChangedListener, isMswReady, removeMswStateChangedListener } from \"@squide/msw\";\nimport { useCallback, useEffect, useMemo, useReducer, type Dispatch } from \"react\";\nimport type { FireflyRuntime } from \"./FireflyRuntime.tsx\";\nimport { useAppRouterStore } from \"./useAppRouterStore.ts\";\nimport { useExecuteOnce } from \"./useExecuteOnce.ts\";\nimport { isBootstrapping } from \"./useIsBootstrapping.ts\";\n\nexport type ActiveRouteVisiblity = \"unknown\" | \"public\" | \"protected\";\n\nexport interface AppRouterWaitState {\n    waitForMsw: boolean;\n    waitForPublicData: boolean;\n    waitForProtectedData: boolean;\n}\n\nexport interface AppRouterState extends AppRouterWaitState {\n    areModulesRegistered: boolean;\n    areModulesReady: boolean;\n    isMswReady: boolean;\n    isPublicDataReady: boolean;\n    isProtectedDataReady: boolean;\n    publicDataUpdatedAt?: number;\n    protectedDataUpdatedAt?: number;\n    deferredRegistrationsUpdatedAt?: number;\n    activeRouteVisibility: ActiveRouteVisiblity;\n    isUnauthorized: boolean;\n}\n\nexport type AppRouterActionType =\n| \"modules-registered\"\n| \"modules-ready\"\n| \"msw-ready\"\n| \"public-data-ready\"\n| \"protected-data-ready\"\n| \"public-data-updated\"\n| \"protected-data-updated\"\n| \"deferred-registrations-updated\"\n| \"active-route-is-public\"\n| \"active-route-is-protected\"\n| \"is-unauthorized\";\n\n// The followings event const are a concatenation of \"squide-\" with AppRouterActionType.\n// They are dispatched by the useEnhancedReducerDispatch hook.\nexport const ModulesRegisteredEvent = \"squide-modules-registered\";\nexport const ModulesReadyEvent = \"squide-modules-ready\";\nexport const MswReadyEvent = \"squide-msw-ready\";\nexport const ActiveRouteIsPublicEvent = \"squide-active-route-is-public\";\nexport const ActiveRouteIsProtectedEvent = \"squide-active-route-is-protected\";\nexport const PublicDataReadyEvent = \"squide-public-data-ready\";\nexport const ProtectedDataReadyEvent = \"squide-protected-data-ready\";\nexport const PublicDataUpdatedEvent = \"squide-public-data-updated\";\nexport const ProtectedDataUpdatedEvent = \"squide-protected-data-updated\";\nexport const DeferredRegistrationsUpdatedEvent = \"squide-deferred-registrations-updated\";\nexport const ApplicationBoostrappedEvent = \"squide-app-boostrapped\";\n\nexport interface AppRouterAction {\n    type: AppRouterActionType;\n    payload?: unknown;\n}\n\nexport type AppRouterDispatch = Dispatch<AppRouterAction>;\n\nfunction reducer(state: AppRouterState, action: AppRouterAction) {\n    let newState = state;\n\n    switch (action.type) {\n        case \"modules-registered\": {\n            newState = {\n                ...newState,\n                areModulesRegistered: true\n            };\n\n            break;\n        }\n        case \"modules-ready\": {\n            newState = {\n                ...newState,\n                areModulesReady: true,\n                // Will be set even if the app is not using deferred registrations.\n                deferredRegistrationsUpdatedAt: Date.now()\n            };\n\n            break;\n        }\n        case \"msw-ready\": {\n            newState = {\n                ...newState,\n                isMswReady: true\n            };\n\n            break;\n        }\n        case \"public-data-ready\": {\n            newState = {\n                ...newState,\n                isPublicDataReady: true,\n                publicDataUpdatedAt: Date.now()\n            };\n\n            break;\n        }\n        case \"protected-data-ready\": {\n            newState = {\n                ...newState,\n                isProtectedDataReady: true,\n                protectedDataUpdatedAt: Date.now()\n            };\n\n            break;\n        }\n        case \"public-data-updated\": {\n            newState = {\n                ...newState,\n                publicDataUpdatedAt: Date.now()\n            };\n\n            break;\n        }\n        case \"protected-data-updated\": {\n            newState = {\n                ...newState,\n                protectedDataUpdatedAt: Date.now()\n            };\n\n            break;\n        }\n        case \"deferred-registrations-updated\": {\n            newState = {\n                ...newState,\n                deferredRegistrationsUpdatedAt: Date.now()\n            };\n\n            break;\n        }\n        case \"active-route-is-public\": {\n            newState = {\n                ...newState,\n                activeRouteVisibility: \"public\"\n            };\n\n            break;\n        }\n        case \"active-route-is-protected\": {\n            newState = {\n                ...newState,\n                activeRouteVisibility: \"protected\"\n            };\n\n            break;\n        }\n        case \"is-unauthorized\": {\n            newState = {\n                ...newState,\n                isUnauthorized: true\n            };\n\n            break;\n        }\n        default: {\n            throw new Error(`[squide] The AppRouter component state reducer doesn't support action type \"${action.type}\".`);\n        }\n    }\n\n    return newState;\n}\n\nexport function getAreModulesRegistered() {\n    const localModuleStatus = getLocalModuleRegistrationStatus();\n    const remoteModuleStatus = getRemoteModuleRegistrationStatus();\n\n    return areModulesRegistered(localModuleStatus, remoteModuleStatus);\n}\n\nexport function getAreModulesReady() {\n    const localModuleStatus = getLocalModuleRegistrationStatus();\n    const remoteModuleStatus = getRemoteModuleRegistrationStatus();\n\n    return areModulesReady(localModuleStatus, remoteModuleStatus);\n}\n\nexport function useModuleRegistrationStatusDispatcher(areModulesRegisteredValue: boolean, areModulesReadyValue: boolean, dispatch: AppRouterDispatch) {\n    const logger = useLogger();\n\n    const dispatchModulesRegistered = useExecuteOnce(useCallback(() => {\n        if (getAreModulesRegistered()) {\n            dispatch({ type: \"modules-registered\" });\n\n            logger\n                .withText(\"[squide] Modules are registered.\", {\n                    style: {\n                        color: \"green\"\n                    }\n                })\n                .information();\n\n            return true;\n        }\n\n        return false;\n    }, [dispatch, logger]));\n\n    const dispatchModulesReady = useExecuteOnce(useCallback(() => {\n        if (getAreModulesReady()) {\n            dispatch({ type: \"modules-ready\" });\n\n            logger\n                .withText(\"[squide] Modules are ready.\", {\n                    style: {\n                        color: \"green\"\n                    }\n                })\n                .information();\n\n            return true;\n        }\n\n        return false;\n    }, [dispatch, logger]));\n\n    return useEffect(() => {\n        if (!areModulesRegisteredValue) {\n            addLocalModuleRegistrationStatusChangedListener(dispatchModulesRegistered);\n            addRemoteModuleRegistrationStatusChangedListener(dispatchModulesRegistered);\n        }\n\n        if (!areModulesReadyValue) {\n            addLocalModuleRegistrationStatusChangedListener(dispatchModulesReady);\n            addRemoteModuleRegistrationStatusChangedListener(dispatchModulesReady);\n        }\n\n        return () => {\n            removeLocalModuleRegistrationStatusChangedListener(dispatchModulesRegistered);\n            removeRemoteModuleRegistrationStatusChangedListener(dispatchModulesRegistered);\n\n            removeLocalModuleRegistrationStatusChangedListener(dispatchModulesReady);\n            removeRemoteModuleRegistrationStatusChangedListener(dispatchModulesReady);\n        };\n    }, [areModulesRegisteredValue, areModulesReadyValue, dispatchModulesRegistered, dispatchModulesReady]);\n}\n\nexport function useMswStatusDispatcher(isMswReadyValue: boolean, dispatch: AppRouterDispatch) {\n    const logger = useLogger();\n\n    const dispatchMswReady = useExecuteOnce(useCallback(() => {\n        if (isMswReady()) {\n            dispatch({ type: \"msw-ready\" });\n\n            logger\n                .withText(\"[squide] MSW is ready.\", {\n                    style: {\n                        color: \"green\"\n                    }\n                })\n                .information();\n\n            return true;\n        }\n\n        return false;\n    }, [dispatch, logger]));\n\n    useEffect(() => {\n        if (!isMswReadyValue) {\n            addMswStateChangedListener(dispatchMswReady);\n        }\n\n        return () => {\n            removeMswStateChangedListener(dispatchMswReady);\n        };\n    }, [isMswReadyValue, dispatchMswReady]);\n}\n\nfunction useBootstrappingCompletedDispatcher(waitState: AppRouterWaitState, state: AppRouterState) {\n    const eventBus = useEventBus();\n\n    const areModulesRegisteredValue = state.areModulesRegistered;\n    const isBoostrapping = isBootstrapping(state);\n\n    useExecuteOnce(useCallback(() => {\n        if (areModulesRegisteredValue && !isBoostrapping) {\n            eventBus.dispatch(ApplicationBoostrappedEvent, waitState);\n\n            return true;\n        }\n\n        return false;\n    }, [areModulesRegisteredValue, isBoostrapping, waitState, eventBus]), true);\n}\n\nlet dispatchProxyFactory: ((reactDispatch: AppRouterDispatch) => AppRouterDispatch) | undefined;\n\n// This function should only be used by tests.\nexport function __setAppReducerDispatchProxyFactory(factory: (reactDispatch: AppRouterDispatch) => AppRouterDispatch) {\n    dispatchProxyFactory = factory;\n}\n\n// This function should only be used by tests.\nexport function __clearAppReducerDispatchProxy() {\n    dispatchProxyFactory = undefined;\n}\n\nfunction useReducerDispatchProxy(reactDispatch: AppRouterDispatch) {\n    return useMemo(() => {\n        return dispatchProxyFactory ? dispatchProxyFactory(reactDispatch) : reactDispatch;\n    }, [reactDispatch]);\n}\n\nfunction useEnhancedReducerDispatch(waitState: AppRouterWaitState, reducerDispatch: AppRouterDispatch) {\n    const logger = useLogger();\n    const appRouterStore = useAppRouterStore();\n    const eventBus = useEventBus();\n\n    return useCallback((action: AppRouterAction) => {\n        logger\n            .withText(\"[squide] The following action has been dispatched to the AppRouter reducer:\")\n            .withObject(action)\n            .debug();\n\n        appRouterStore.dispatch({ ...action, payload: waitState });\n        eventBus.dispatch(`squide-${action.type}`, waitState);\n\n        reducerDispatch(action);\n    }, [waitState, reducerDispatch, logger, appRouterStore, eventBus]);\n}\n\nexport function useAppRouterReducer(waitForPublicData: boolean, waitForProtectedData: boolean): [AppRouterState, AppRouterDispatch] {\n    const runtime = useRuntime() as FireflyRuntime;\n    const eventBus = useEventBus();\n    const appRouterStore = useAppRouterStore();\n\n    const isMswEnabled = runtime.isMswEnabled;\n\n    const areModulesInitiallyRegistered = getAreModulesRegistered();\n    const areModulesInitiallyReady = getAreModulesReady();\n    const isMswInitiallyReady = isMswReady();\n\n    const waitState = useMemo(() => ({\n        waitForMsw: isMswEnabled,\n        waitForPublicData,\n        waitForProtectedData\n    }), [isMswEnabled, waitForPublicData, waitForProtectedData]);\n\n    const initialState = useMemo(() => ({\n        waitForMsw: waitState.waitForMsw,\n        waitForPublicData: waitState.waitForPublicData,\n        waitForProtectedData: waitState.waitForProtectedData,\n        // When the modules registration functions are awaited, the event listeners are registered after the modules are registered.\n        areModulesRegistered: areModulesInitiallyRegistered,\n        areModulesReady: areModulesInitiallyReady,\n        isMswReady: isMswInitiallyReady,\n        isPublicDataReady: false,\n        isProtectedDataReady: false,\n        activeRouteVisibility: \"unknown\",\n        isUnauthorized: false\n    } satisfies AppRouterState), [waitState, areModulesInitiallyRegistered, areModulesInitiallyReady, isMswInitiallyReady]);\n\n    // When modules are initially registered, the reducer action will never be dispatched, therefore the event would not be dispatched as well.\n    // To ensure the bootstrapping events sequencing, the event is manually dispatched when the modules are initially registered.\n    useExecuteOnce(useCallback(() => {\n        if (areModulesInitiallyRegistered) {\n            appRouterStore.dispatch({ type: \"modules-registered\", payload: waitState });\n            eventBus.dispatch(ModulesRegisteredEvent, waitState);\n        }\n\n        return true;\n    }, [areModulesInitiallyRegistered, appRouterStore, eventBus, waitState]), true);\n\n    // When modules are initially registered, the reducer action will never be dispatched, therefore the event would not be dispatched as well.\n    // To ensure the bootstrapping events sequencing, the event is manually dispatched when the modules are initially registered.\n    useExecuteOnce(useCallback(() => {\n        if (areModulesInitiallyReady) {\n            appRouterStore.dispatch({ type: \"modules-ready\", payload: waitState });\n            eventBus.dispatch(ModulesReadyEvent, waitState);\n        }\n\n        return true;\n    }, [areModulesInitiallyReady, appRouterStore, eventBus, waitState]), true);\n\n    // When modules are initially registered, the reducer action will never be dispatched, therefore the event would not be dispatched as well.\n    // To ensure the bootstrapping events sequencing, the event is manually dispatched when the modules are initially registered.\n    useExecuteOnce(useCallback(() => {\n        if (isMswInitiallyReady) {\n            appRouterStore.dispatch({ type: \"msw-ready\", payload: waitState });\n            eventBus.dispatch(MswReadyEvent, waitState);\n        }\n\n        return true;\n    }, [isMswInitiallyReady, appRouterStore, eventBus, waitState]), true);\n\n    const [state, reactDispatch] = useReducer(reducer, initialState);\n\n    const {\n        areModulesRegistered: areModulesRegisteredValue,\n        areModulesReady: areModulesReadyValue,\n        isMswReady: isMswReadyValue\n    } = state;\n\n    // The dispatch proxy is strictly an utility allowing tests to mock the useReducer dispatch function. It's easier\n    // than mocking the import from React.\n    const dispatchProxy = useReducerDispatchProxy(reactDispatch);\n    const dispatch = useEnhancedReducerDispatch(waitState, dispatchProxy);\n\n    useModuleRegistrationStatusDispatcher(areModulesRegisteredValue, areModulesReadyValue, dispatch);\n    useMswStatusDispatcher(isMswReadyValue, dispatch);\n    useBootstrappingCompletedDispatcher(waitState, state);\n\n    return [state, dispatch];\n}\n"],"names":["addLocalModuleRegistrationStatusChangedListener","getLocalModuleRegistrationStatus","removeLocalModuleRegistrationStatusChangedListener","useEventBus","useLogger","useRuntime","addRemoteModuleRegistrationStatusChangedListener","areModulesReady","areModulesRegistered","getRemoteModuleRegistrationStatus","removeRemoteModuleRegistrationStatusChangedListener","addMswStateChangedListener","isMswReady","removeMswStateChangedListener","useCallback","useEffect","useMemo","useReducer","useAppRouterStore","useExecuteOnce","isBootstrapping","ModulesRegisteredEvent","ModulesReadyEvent","MswReadyEvent","ActiveRouteIsPublicEvent","ActiveRouteIsProtectedEvent","PublicDataReadyEvent","ProtectedDataReadyEvent","PublicDataUpdatedEvent","ProtectedDataUpdatedEvent","DeferredRegistrationsUpdatedEvent","ApplicationBoostrappedEvent","reducer","state","action","newState","Date","Error","getAreModulesRegistered","localModuleStatus","remoteModuleStatus","getAreModulesReady","useModuleRegistrationStatusDispatcher","areModulesRegisteredValue","areModulesReadyValue","dispatch","logger","dispatchModulesRegistered","dispatchModulesReady","useMswStatusDispatcher","isMswReadyValue","dispatchMswReady","useBootstrappingCompletedDispatcher","waitState","eventBus","isBoostrapping","dispatchProxyFactory","__setAppReducerDispatchProxyFactory","factory","__clearAppReducerDispatchProxy","undefined","useReducerDispatchProxy","reactDispatch","useEnhancedReducerDispatch","reducerDispatch","appRouterStore","useAppRouterReducer","waitForPublicData","waitForProtectedData","runtime","isMswEnabled","areModulesInitiallyRegistered","areModulesInitiallyReady","isMswInitiallyReady","initialState","dispatchProxy"],"mappings":"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"}

package/dist/AppRouterStore.d.ts

@@ -1,13 +1,13 @@
-import type { RootLogger } from "@workleap/logging";
+import type { Logger } from "@workleap/logging";
 import type { AppRouterAction, AppRouterState } from "./AppRouterReducer.ts";
 export type AppRouterStoreState = Omit<AppRouterState, "waitForMsw" | "waitForPublicData" | "waitForProtectedData">;
 export type AppRouterStoreListenerFunction = (store: AppRouterStore, unsuscribe: () => void) => void;
 export declare class AppRouterStore {
     #private;
-    constructor(initialialState: AppRouterStoreState, logger: RootLogger);
+    constructor(initialialState: AppRouterStoreState, logger: Logger);
     subscribe(listener: AppRouterStoreListenerFunction): () => void;
     unsuscribe(listener: AppRouterStoreListenerFunction): void;
     dispatch(action: AppRouterAction): void;
     get state(): AppRouterStoreState;
 }
-export declare function createAppRouterStore(logger: RootLogger): AppRouterStore;
+export declare function createAppRouterStore(logger: Logger): AppRouterStore;

package/dist/AppRouterStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppRouterStore.js","sources":["webpack://@squide/firefly/./src/AppRouterStore.ts"],"sourcesContent":["// This file is a low cost port of the AppRouterReducer to a non-React store. It allows, non-React parts of the library to get\n// access to the state and ease the integration with third-party libraries such as the Platform Widgets.\n// Eventually, AppRouterReducer should be deprecated in favor of this new AppRouterStore.\n\nimport type { RootLogger } from \"@workleap/logging\";\nimport type { AppRouterAction, AppRouterState } from \"./AppRouterReducer.ts\";\n\nexport type AppRouterStoreState = Omit<AppRouterState, \"waitForMsw\" | \"waitForPublicData\" | \"waitForProtectedData\">;\n\nexport type AppRouterStoreListenerFunction = (store: AppRouterStore, unsuscribe: () => void) => void;\n\nexport class AppRouterStore {\n    #state: AppRouterStoreState;\n\n    readonly #listeners = new Set<AppRouterStoreListenerFunction>();\n    readonly #logger: RootLogger;\n\n    constructor(initialialState: AppRouterStoreState, logger: RootLogger) {\n        this.#state = initialialState;\n        this.#logger = logger;\n    }\n\n    subscribe(listener: AppRouterStoreListenerFunction) {\n        this.#listeners.add(listener);\n\n        return () => {\n            this.unsuscribe(listener);\n        };\n    }\n\n    unsuscribe(listener: AppRouterStoreListenerFunction) {\n        this.#listeners.delete(listener);\n    }\n\n    dispatch(action: AppRouterAction) {\n        const newState = this.#reducer({ ...this.#state }, action);\n\n        this.#logger\n            .withText(\"[squide] The AppRouterStore state has been updated to:\")\n            .withObject(newState)\n            .debug();\n\n        this.#state = newState;\n\n        // Creating a copy of the listeners in case some are removed during the looping.\n        // To be honest, it might not be necessary, I simply don't know.\n        new Set(this.#listeners).forEach(x => {\n            x(this, () => {\n                this.unsuscribe(x);\n            });\n        });\n    }\n\n    #reducer(state: AppRouterStoreState, action: AppRouterAction) {\n        let newState = state;\n\n        switch (action.type) {\n            case \"modules-registered\": {\n                newState = {\n                    ...newState,\n                    areModulesRegistered: true\n                };\n\n                break;\n            }\n            case \"modules-ready\": {\n                newState = {\n                    ...newState,\n                    areModulesReady: true,\n                    // Will be set even if the app is not using deferred registrations.\n                    deferredRegistrationsUpdatedAt: Date.now()\n                };\n\n                break;\n            }\n            case \"msw-ready\": {\n                newState = {\n                    ...newState,\n                    isMswReady: true\n                };\n\n                break;\n            }\n            case \"public-data-ready\": {\n                newState = {\n                    ...newState,\n                    isPublicDataReady: true,\n                    publicDataUpdatedAt: Date.now()\n                };\n\n                break;\n            }\n            case \"protected-data-ready\": {\n                newState = {\n                    ...newState,\n                    isProtectedDataReady: true,\n                    protectedDataUpdatedAt: Date.now()\n                };\n\n                break;\n            }\n            case \"public-data-updated\": {\n                newState = {\n                    ...newState,\n                    publicDataUpdatedAt: Date.now()\n                };\n\n                break;\n            }\n            case \"protected-data-updated\": {\n                newState = {\n                    ...newState,\n                    protectedDataUpdatedAt: Date.now()\n                };\n\n                break;\n            }\n            case \"deferred-registrations-updated\": {\n                newState = {\n                    ...newState,\n                    deferredRegistrationsUpdatedAt: Date.now()\n                };\n\n                break;\n            }\n            case \"active-route-is-public\": {\n                newState = {\n                    ...newState,\n                    activeRouteVisibility: \"public\"\n                };\n\n                break;\n            }\n            case \"active-route-is-protected\": {\n                newState = {\n                    ...newState,\n                    activeRouteVisibility: \"protected\"\n                };\n\n                break;\n            }\n            case \"is-unauthorized\": {\n                newState = {\n                    ...newState,\n                    isUnauthorized: true\n                };\n\n                break;\n            }\n            default: {\n                throw new Error(`[squide] The AppRouterStore state reducer doesn't support action type \"${action.type}\".`);\n            }\n        }\n\n        return newState;\n    }\n\n    get state() {\n        return this.#state;\n    }\n}\n\nexport function createAppRouterStore(logger: RootLogger) {\n    const initialState: AppRouterStoreState = {\n        areModulesRegistered: false,\n        areModulesReady: false,\n        isMswReady: false,\n        isPublicDataReady: false,\n        isProtectedDataReady: false,\n        activeRouteVisibility: \"unknown\",\n        isUnauthorized: false\n    };\n\n    return new AppRouterStore(initialState, logger);\n}\n"],"names":["AppRouterStore","Set","initialialState","logger","listener","action","newState","x","state","Date","Error","createAppRouterStore","initialState"],"mappings":"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"}
+{"version":3,"file":"AppRouterStore.js","sources":["webpack://@squide/firefly/./src/AppRouterStore.ts"],"sourcesContent":["// This file is a low cost port of the AppRouterReducer to a non-React store. It allows, non-React parts of the library to get\n// access to the state and ease the integration with third-party libraries such as the Platform Widgets.\n// Eventually, AppRouterReducer should be deprecated in favor of this new AppRouterStore.\n\nimport type { Logger } from \"@workleap/logging\";\nimport type { AppRouterAction, AppRouterState } from \"./AppRouterReducer.ts\";\n\nexport type AppRouterStoreState = Omit<AppRouterState, \"waitForMsw\" | \"waitForPublicData\" | \"waitForProtectedData\">;\n\nexport type AppRouterStoreListenerFunction = (store: AppRouterStore, unsuscribe: () => void) => void;\n\nexport class AppRouterStore {\n    #state: AppRouterStoreState;\n\n    readonly #listeners = new Set<AppRouterStoreListenerFunction>();\n    readonly #logger: Logger;\n\n    constructor(initialialState: AppRouterStoreState, logger: Logger) {\n        this.#state = initialialState;\n        this.#logger = logger;\n    }\n\n    subscribe(listener: AppRouterStoreListenerFunction) {\n        this.#listeners.add(listener);\n\n        return () => {\n            this.unsuscribe(listener);\n        };\n    }\n\n    unsuscribe(listener: AppRouterStoreListenerFunction) {\n        this.#listeners.delete(listener);\n    }\n\n    dispatch(action: AppRouterAction) {\n        const newState = this.#reducer({ ...this.#state }, action);\n\n        this.#logger\n            .withText(\"[squide] The AppRouterStore state has been updated to:\")\n            .withObject(newState)\n            .debug();\n\n        this.#state = newState;\n\n        // Creating a copy of the listeners in case some are removed during the looping.\n        // To be honest, it might not be necessary, I simply don't know.\n        new Set(this.#listeners).forEach(x => {\n            x(this, () => {\n                this.unsuscribe(x);\n            });\n        });\n    }\n\n    #reducer(state: AppRouterStoreState, action: AppRouterAction) {\n        let newState = state;\n\n        switch (action.type) {\n            case \"modules-registered\": {\n                newState = {\n                    ...newState,\n                    areModulesRegistered: true\n                };\n\n                break;\n            }\n            case \"modules-ready\": {\n                newState = {\n                    ...newState,\n                    areModulesReady: true,\n                    // Will be set even if the app is not using deferred registrations.\n                    deferredRegistrationsUpdatedAt: Date.now()\n                };\n\n                break;\n            }\n            case \"msw-ready\": {\n                newState = {\n                    ...newState,\n                    isMswReady: true\n                };\n\n                break;\n            }\n            case \"public-data-ready\": {\n                newState = {\n                    ...newState,\n                    isPublicDataReady: true,\n                    publicDataUpdatedAt: Date.now()\n                };\n\n                break;\n            }\n            case \"protected-data-ready\": {\n                newState = {\n                    ...newState,\n                    isProtectedDataReady: true,\n                    protectedDataUpdatedAt: Date.now()\n                };\n\n                break;\n            }\n            case \"public-data-updated\": {\n                newState = {\n                    ...newState,\n                    publicDataUpdatedAt: Date.now()\n                };\n\n                break;\n            }\n            case \"protected-data-updated\": {\n                newState = {\n                    ...newState,\n                    protectedDataUpdatedAt: Date.now()\n                };\n\n                break;\n            }\n            case \"deferred-registrations-updated\": {\n                newState = {\n                    ...newState,\n                    deferredRegistrationsUpdatedAt: Date.now()\n                };\n\n                break;\n            }\n            case \"active-route-is-public\": {\n                newState = {\n                    ...newState,\n                    activeRouteVisibility: \"public\"\n                };\n\n                break;\n            }\n            case \"active-route-is-protected\": {\n                newState = {\n                    ...newState,\n                    activeRouteVisibility: \"protected\"\n                };\n\n                break;\n            }\n            case \"is-unauthorized\": {\n                newState = {\n                    ...newState,\n                    isUnauthorized: true\n                };\n\n                break;\n            }\n            default: {\n                throw new Error(`[squide] The AppRouterStore state reducer doesn't support action type \"${action.type}\".`);\n            }\n        }\n\n        return newState;\n    }\n\n    get state() {\n        return this.#state;\n    }\n}\n\nexport function createAppRouterStore(logger: Logger) {\n    const initialState: AppRouterStoreState = {\n        areModulesRegistered: false,\n        areModulesReady: false,\n        isMswReady: false,\n        isPublicDataReady: false,\n        isProtectedDataReady: false,\n        activeRouteVisibility: \"unknown\",\n        isUnauthorized: false\n    };\n\n    return new AppRouterStore(initialState, logger);\n}\n"],"names":["AppRouterStore","Set","initialialState","logger","listener","action","newState","x","state","Date","Error","createAppRouterStore","initialState"],"mappings":"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"}

package/dist/FireflyRuntime.d.ts

@@ -1,16 +1,33 @@
-import type { RegisterRouteOptions, RuntimeOptions } from "@squide/core";
-import { ReactRouterRuntime, type Route } from "@squide/react-router";
+import type { RegisterRouteOptions, RuntimeMethodOptions, RuntimeOptions } from "@squide/core";
+import { type IReactRouterRuntime, ReactRouterRuntime, ReactRouterRuntimeScope, type Route } from "@squide/react-router";
+import type { Logger } from "@workleap/logging";
 import type { RequestHandler } from "msw";
 import { type AppRouterStore } from "./AppRouterStore.ts";
 export interface FireflyRuntimeOptions extends RuntimeOptions {
     useMsw?: boolean;
 }
-export declare class FireflyRuntime extends ReactRouterRuntime {
-    #private;
+export interface RegisterRequestHandlersOptions extends RuntimeMethodOptions {
+}
+export interface IFireflyRuntime extends IReactRouterRuntime {
+    registerRequestHandlers: (handlers: RequestHandler[]) => void;
+    get requestHandlers(): RequestHandler[];
+    get appRouterStore(): AppRouterStore;
+    get isMswEnabled(): boolean;
+}
+export declare class FireflyRuntime extends ReactRouterRuntime implements IFireflyRuntime {
+    protected _appRouterStore: AppRouterStore;
+    protected _useMsw: boolean;
     constructor({ plugins, useMsw, ...options }?: FireflyRuntimeOptions);
-    registerRequestHandlers(handlers: RequestHandler[]): void;
+    registerRequestHandlers(handlers: RequestHandler[], options?: RegisterRequestHandlersOptions): void;
     get requestHandlers(): RequestHandler[];
     registerRoute(route: Route, options?: RegisterRouteOptions): void;
     get appRouterStore(): AppRouterStore;
     get isMswEnabled(): boolean;
+    startScope(logger: Logger): FireflyRuntime;
+}
+export declare class FireflyRuntimeScope<TRuntime extends FireflyRuntime = FireflyRuntime> extends ReactRouterRuntimeScope<TRuntime> implements IFireflyRuntime {
+    registerRequestHandlers(handlers: RequestHandler[], options?: RegisterRequestHandlersOptions): void;
+    get requestHandlers(): RequestHandler[];
+    get appRouterStore(): AppRouterStore;
+    get isMswEnabled(): boolean;
 }

package/dist/FireflyRuntime.js

@@ -1,5 +1,5 @@
 import { MswPlugin, MswPluginName } from "@squide/msw";
-import { ReactRouterRuntime } from "@squide/react-router";
+import { ReactRouterRuntime, ReactRouterRuntimeScope } from "@squide/react-router";
 import { getAreModulesRegistered } from "./AppRouterReducer.js";
 import { createAppRouterStore } from "./AppRouterStore.js";
 
@@ -17,8 +17,8 @@ import { createAppRouterStore } from "./AppRouterStore.js";
 
 
 class FireflyRuntime extends ReactRouterRuntime {
-    #appRouterStore;
-    #useMsw;
+    _appRouterStore;
+    _useMsw;
     constructor({ plugins, useMsw, ...options } = {}){
         if (useMsw) {
             super({
@@ -28,17 +28,18 @@ class FireflyRuntime extends ReactRouterRuntime {
                 ],
                 ...options
             });
-            this.#useMsw = true;
+            this._useMsw = true;
         } else {
             super({
                 plugins,
                 ...options
             });
-            this.#useMsw = false;
+            this._useMsw = false;
         }
-        this.#appRouterStore = createAppRouterStore(this._logger);
+        this._appRouterStore = createAppRouterStore(this._logger);
     }
-    registerRequestHandlers(handlers) {
+    registerRequestHandlers(handlers, options = {}) {
+        const logger = this._getLogger(options);
         const mswPlugin = this.getPlugin(MswPluginName);
         if (!mswPlugin) {
             throw new Error("[squide] Cannot register the provided MSW request handlers because the runtime hasn't been initialized with MSW. Did you instanciate the FireflyRuntime with the \"useMsw\" option?");
@@ -46,7 +47,9 @@ class FireflyRuntime extends ReactRouterRuntime {
         if (getAreModulesRegistered()) {
             throw new Error("[squide] Cannot register an MSW request handlers once the modules are registered. Are you trying to register an MSW request handler in a deferred registration function? Only navigation items can be registered in a deferred registration function.");
         }
-        mswPlugin.registerRequestHandlers(handlers);
+        mswPlugin.registerRequestHandlers(handlers, {
+            logger
+        });
     }
     // Must define a return type otherwise we get an "error TS2742: The inferred type of 'requestHandlers' cannot be named" error.
     get requestHandlers() {
@@ -63,13 +66,33 @@ class FireflyRuntime extends ReactRouterRuntime {
         super.registerRoute(route, options);
     }
     get appRouterStore() {
-        return this.#appRouterStore;
+        return this._appRouterStore;
     }
     get isMswEnabled() {
-        return this.#useMsw;
+        return this._useMsw;
+    }
+    startScope(logger) {
+        return new FireflyRuntimeScope(this, logger);
+    }
+}
+class FireflyRuntimeScope extends ReactRouterRuntimeScope {
+    registerRequestHandlers(handlers, options = {}) {
+        this._runtime.registerRequestHandlers(handlers, {
+            ...options,
+            logger: this._getLogger(options)
+        });
+    }
+    get requestHandlers() {
+        return this._runtime.requestHandlers;
+    }
+    get appRouterStore() {
+        return this._runtime.appRouterStore;
+    }
+    get isMswEnabled() {
+        return this._runtime.isMswEnabled;
     }
 }
 
-export { FireflyRuntime };
+export { FireflyRuntime, FireflyRuntimeScope };
 
 //# sourceMappingURL=FireflyRuntime.js.map

package/dist/FireflyRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"FireflyRuntime.js","sources":["webpack://@squide/firefly/./src/FireflyRuntime.tsx"],"sourcesContent":["import type { RegisterRouteOptions, RuntimeOptions } from \"@squide/core\";\nimport { MswPlugin, MswPluginName } from \"@squide/msw\";\nimport { ReactRouterRuntime, type Route } from \"@squide/react-router\";\nimport type { RequestHandler } from \"msw\";\nimport { getAreModulesRegistered } from \"./AppRouterReducer.ts\";\nimport { type AppRouterStore, createAppRouterStore } from \"./AppRouterStore.ts\";\n\nexport interface FireflyRuntimeOptions extends RuntimeOptions {\n    useMsw?: boolean;\n}\n\nexport class FireflyRuntime extends ReactRouterRuntime {\n    readonly #appRouterStore: AppRouterStore;\n    readonly #useMsw: boolean;\n\n    constructor({ plugins, useMsw, ...options }: FireflyRuntimeOptions = {}) {\n        if (useMsw) {\n            super({\n                plugins: [\n                    ...(plugins ?? []),\n                    runtime => new MswPlugin(runtime)\n                ],\n                ...options\n            });\n\n            this.#useMsw = true;\n        } else {\n            super({\n                plugins,\n                ...options\n            });\n\n            this.#useMsw = false;\n        }\n\n        this.#appRouterStore = createAppRouterStore(this._logger);\n    }\n\n    registerRequestHandlers(handlers: RequestHandler[]) {\n        const mswPlugin = this.getPlugin(MswPluginName) as MswPlugin;\n\n        if (!mswPlugin) {\n            throw new Error(\"[squide] Cannot register the provided MSW request handlers because the runtime hasn't been initialized with MSW. Did you instanciate the FireflyRuntime with the \\\"useMsw\\\" option?\");\n        }\n\n        if (getAreModulesRegistered()) {\n            throw new Error(\"[squide] Cannot register an MSW request handlers once the modules are registered. Are you trying to register an MSW request handler in a deferred registration function? Only navigation items can be registered in a deferred registration function.\");\n        }\n\n        mswPlugin.registerRequestHandlers(handlers);\n    }\n\n    // Must define a return type otherwise we get an \"error TS2742: The inferred type of 'requestHandlers' cannot be named\" error.\n    get requestHandlers(): RequestHandler[] {\n        const mswPlugin = this.getPlugin(MswPluginName) as MswPlugin;\n\n        if (!mswPlugin) {\n            throw new Error(\"[squide] Cannot retrieve MSW request handlers because the runtime hasn't been initialized with MSW. Did you instanciate the FireflyRuntime with the \\\"useMsw\\\" option?\");\n        }\n\n        return mswPlugin.requestHandlers;\n    }\n\n    registerRoute(route: Route, options: RegisterRouteOptions = {}) {\n        if (getAreModulesRegistered()) {\n            throw new Error(\"[squide] Cannot register a route once the modules are registered. Are you trying to register a route in a deferred registration function? Only navigation items can be registered in a deferred registration function.\");\n        }\n\n        super.registerRoute(route, options);\n    }\n\n    get appRouterStore() {\n        return this.#appRouterStore;\n    }\n\n    get isMswEnabled() {\n        return this.#useMsw;\n    }\n}\n"],"names":["MswPlugin","MswPluginName","ReactRouterRuntime","getAreModulesRegistered","createAppRouterStore","FireflyRuntime","plugins","useMsw","options","runtime","handlers","mswPlugin","Error","route"],"mappings":";;;;;;;;;;;;;;AACuD;AACe;AAEN;AACgB;AAMzE,MAAMK,uBAAuBH,kBAAkBA;IACzC,eAAe,CAAiB;IAChC,OAAO,CAAU;IAE1B,YAAY,EAAEI,OAAO,EAAEC,MAAM,EAAE,GAAGC,SAAgC,GAAG,CAAC,CAAC,CAAE;QACrE,IAAID,QAAQ;YACR,KAAK,CAAC;gBACF,SAAS;uBACDD,WAAW,EAAE;oBACjBG,CAAAA,UAAW,IAAIT,SAASA,CAACS;iBAC5B;gBACD,GAAGD,OAAO;YACd;YAEA,IAAI,CAAC,OAAO,GAAG;QACnB,OAAO;YACH,KAAK,CAAC;gBACFF;gBACA,GAAGE,OAAO;YACd;YAEA,IAAI,CAAC,OAAO,GAAG;QACnB;QAEA,IAAI,CAAC,eAAe,GAAGJ,oBAAoBA,CAAC,IAAI,CAAC,OAAO;IAC5D;IAEA,wBAAwBM,QAA0B,EAAE;QAChD,MAAMC,YAAY,IAAI,CAAC,SAAS,CAACV,aAAaA;QAE9C,IAAI,CAACU,WAAW;YACZ,MAAM,IAAIC,MAAM;QACpB;QAEA,IAAIT,uBAAuBA,IAAI;YAC3B,MAAM,IAAIS,MAAM;QACpB;QAEAD,UAAU,uBAAuB,CAACD;IACtC;IAEA,8HAA8H;IAC9H,IAAI,kBAAoC;QACpC,MAAMC,YAAY,IAAI,CAAC,SAAS,CAACV,aAAaA;QAE9C,IAAI,CAACU,WAAW;YACZ,MAAM,IAAIC,MAAM;QACpB;QAEA,OAAOD,UAAU,eAAe;IACpC;IAEA,cAAcE,KAAY,EAAEL,UAAgC,CAAC,CAAC,EAAE;QAC5D,IAAIL,uBAAuBA,IAAI;YAC3B,MAAM,IAAIS,MAAM;QACpB;QAEA,KAAK,CAAC,cAAcC,OAAOL;IAC/B;IAEA,IAAI,iBAAiB;QACjB,OAAO,IAAI,CAAC,eAAe;IAC/B;IAEA,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,OAAO;IACvB;AACJ"}
+{"version":3,"file":"FireflyRuntime.js","sources":["webpack://@squide/firefly/./src/FireflyRuntime.tsx"],"sourcesContent":["import type { RegisterRouteOptions, RuntimeMethodOptions, RuntimeOptions } from \"@squide/core\";\nimport { MswPlugin, MswPluginName } from \"@squide/msw\";\nimport { type IReactRouterRuntime, ReactRouterRuntime, ReactRouterRuntimeScope, type Route } from \"@squide/react-router\";\nimport type { Logger } from \"@workleap/logging\";\nimport type { RequestHandler } from \"msw\";\nimport { getAreModulesRegistered } from \"./AppRouterReducer.ts\";\nimport { type AppRouterStore, createAppRouterStore } from \"./AppRouterStore.ts\";\n\nexport interface FireflyRuntimeOptions extends RuntimeOptions {\n    useMsw?: boolean;\n}\n\nexport interface RegisterRequestHandlersOptions extends RuntimeMethodOptions {}\n\nexport interface IFireflyRuntime extends IReactRouterRuntime {\n    registerRequestHandlers: (handlers: RequestHandler[]) => void;\n    get requestHandlers(): RequestHandler[];\n    get appRouterStore(): AppRouterStore;\n    get isMswEnabled(): boolean;\n}\n\nexport class FireflyRuntime extends ReactRouterRuntime implements IFireflyRuntime {\n    protected _appRouterStore: AppRouterStore;\n    protected _useMsw: boolean;\n\n    constructor({ plugins, useMsw, ...options }: FireflyRuntimeOptions = {}) {\n        if (useMsw) {\n            super({\n                plugins: [\n                    ...(plugins ?? []),\n                    runtime => new MswPlugin(runtime)\n                ],\n                ...options\n            });\n\n            this._useMsw = true;\n        } else {\n            super({\n                plugins,\n                ...options\n            });\n\n            this._useMsw = false;\n        }\n\n        this._appRouterStore = createAppRouterStore(this._logger);\n    }\n\n    registerRequestHandlers(handlers: RequestHandler[], options: RegisterRequestHandlersOptions = {}) {\n        const logger = this._getLogger(options);\n        const mswPlugin = this.getPlugin(MswPluginName) as MswPlugin;\n\n        if (!mswPlugin) {\n            throw new Error(\"[squide] Cannot register the provided MSW request handlers because the runtime hasn't been initialized with MSW. Did you instanciate the FireflyRuntime with the \\\"useMsw\\\" option?\");\n        }\n\n        if (getAreModulesRegistered()) {\n            throw new Error(\"[squide] Cannot register an MSW request handlers once the modules are registered. Are you trying to register an MSW request handler in a deferred registration function? Only navigation items can be registered in a deferred registration function.\");\n        }\n\n        mswPlugin.registerRequestHandlers(handlers, {\n            logger\n        });\n    }\n\n    // Must define a return type otherwise we get an \"error TS2742: The inferred type of 'requestHandlers' cannot be named\" error.\n    get requestHandlers(): RequestHandler[] {\n        const mswPlugin = this.getPlugin(MswPluginName) as MswPlugin;\n\n        if (!mswPlugin) {\n            throw new Error(\"[squide] Cannot retrieve MSW request handlers because the runtime hasn't been initialized with MSW. Did you instanciate the FireflyRuntime with the \\\"useMsw\\\" option?\");\n        }\n\n        return mswPlugin.requestHandlers;\n    }\n\n    registerRoute(route: Route, options: RegisterRouteOptions = {}) {\n        if (getAreModulesRegistered()) {\n            throw new Error(\"[squide] Cannot register a route once the modules are registered. Are you trying to register a route in a deferred registration function? Only navigation items can be registered in a deferred registration function.\");\n        }\n\n        super.registerRoute(route, options);\n    }\n\n    get appRouterStore() {\n        return this._appRouterStore;\n    }\n\n    get isMswEnabled() {\n        return this._useMsw;\n    }\n\n    startScope(logger: Logger): FireflyRuntime {\n        return (new FireflyRuntimeScope(this, logger) as unknown) as FireflyRuntime;\n    }\n}\n\nexport class FireflyRuntimeScope<TRuntime extends FireflyRuntime = FireflyRuntime> extends ReactRouterRuntimeScope<TRuntime> implements IFireflyRuntime {\n    registerRequestHandlers(handlers: RequestHandler[], options: RegisterRequestHandlersOptions = {}) {\n        this._runtime.registerRequestHandlers(handlers, {\n            ...options,\n            logger: this._getLogger(options)\n        });\n    }\n\n    get requestHandlers(): RequestHandler[] {\n        return this._runtime.requestHandlers;\n    }\n\n    get appRouterStore() {\n        return this._runtime.appRouterStore;\n    }\n\n    get isMswEnabled() {\n        return this._runtime.isMswEnabled;\n    }\n}\n"],"names":["MswPlugin","MswPluginName","ReactRouterRuntime","ReactRouterRuntimeScope","getAreModulesRegistered","createAppRouterStore","FireflyRuntime","plugins","useMsw","options","runtime","handlers","logger","mswPlugin","Error","route","FireflyRuntimeScope"],"mappings":";;;;;;;;;;;;;;AACuD;AACkE;AAGzD;AACgB;AAezE,MAAMM,uBAAuBJ,kBAAkBA;IACxC,gBAAgC;IAChC,QAAiB;IAE3B,YAAY,EAAEK,OAAO,EAAEC,MAAM,EAAE,GAAGC,SAAgC,GAAG,CAAC,CAAC,CAAE;QACrE,IAAID,QAAQ;YACR,KAAK,CAAC;gBACF,SAAS;uBACDD,WAAW,EAAE;oBACjBG,CAAAA,UAAW,IAAIV,SAASA,CAACU;iBAC5B;gBACD,GAAGD,OAAO;YACd;YAEA,IAAI,CAAC,OAAO,GAAG;QACnB,OAAO;YACH,KAAK,CAAC;gBACFF;gBACA,GAAGE,OAAO;YACd;YAEA,IAAI,CAAC,OAAO,GAAG;QACnB;QAEA,IAAI,CAAC,eAAe,GAAGJ,oBAAoBA,CAAC,IAAI,CAAC,OAAO;IAC5D;IAEA,wBAAwBM,QAA0B,EAAEF,UAA0C,CAAC,CAAC,EAAE;QAC9F,MAAMG,SAAS,IAAI,CAAC,UAAU,CAACH;QAC/B,MAAMI,YAAY,IAAI,CAAC,SAAS,CAACZ,aAAaA;QAE9C,IAAI,CAACY,WAAW;YACZ,MAAM,IAAIC,MAAM;QACpB;QAEA,IAAIV,uBAAuBA,IAAI;YAC3B,MAAM,IAAIU,MAAM;QACpB;QAEAD,UAAU,uBAAuB,CAACF,UAAU;YACxCC;QACJ;IACJ;IAEA,8HAA8H;IAC9H,IAAI,kBAAoC;QACpC,MAAMC,YAAY,IAAI,CAAC,SAAS,CAACZ,aAAaA;QAE9C,IAAI,CAACY,WAAW;YACZ,MAAM,IAAIC,MAAM;QACpB;QAEA,OAAOD,UAAU,eAAe;IACpC;IAEA,cAAcE,KAAY,EAAEN,UAAgC,CAAC,CAAC,EAAE;QAC5D,IAAIL,uBAAuBA,IAAI;YAC3B,MAAM,IAAIU,MAAM;QACpB;QAEA,KAAK,CAAC,cAAcC,OAAON;IAC/B;IAEA,IAAI,iBAAiB;QACjB,OAAO,IAAI,CAAC,eAAe;IAC/B;IAEA,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,OAAO;IACvB;IAEA,WAAWG,MAAc,EAAkB;QACvC,OAAQ,IAAII,oBAAoB,IAAI,EAAEJ;IAC1C;AACJ;AAEO,MAAMI,4BAA8Eb,uBAAuBA;IAC9G,wBAAwBQ,QAA0B,EAAEF,UAA0C,CAAC,CAAC,EAAE;QAC9F,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAACE,UAAU;YAC5C,GAAGF,OAAO;YACV,QAAQ,IAAI,CAAC,UAAU,CAACA;QAC5B;IACJ;IAEA,IAAI,kBAAoC;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe;IACxC;IAEA,IAAI,iBAAiB;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc;IACvC;IAEA,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY;IACrC;AACJ"}

package/dist/honeycomb/activeSpan.d.ts

@@ -1,5 +1,5 @@
 import type { Span } from "@opentelemetry/api";
-import type { RootLogger } from "@workleap/logging";
+import type { Logger } from "@workleap/logging";
 export type ActiveSpanId = string;
 export interface ActiveSpan {
     id: ActiveSpanId;
@@ -9,4 +9,4 @@ export interface ActiveSpan {
 export declare function registerActiveSpanStack(): void;
 export declare function setActiveSpan(name: string, span: Span): ActiveSpan;
 export declare function popActiveSpan(span: ActiveSpan): void;
-export declare function createOverrideFetchRequestSpanWithActiveSpanContext(logger: RootLogger): (span: Span, request: Request | RequestInit) => true | undefined;
+export declare function createOverrideFetchRequestSpanWithActiveSpanContext(logger: Logger): (span: Span, request: Request | RequestInit) => true | undefined;

package/dist/honeycomb/activeSpan.js.map

@@ -1 +1 @@
-{"version":3,"file":"honeycomb/activeSpan.js","sources":["webpack://@squide/firefly/./src/honeycomb/activeSpan.ts"],"sourcesContent":["import type { Span } from \"@opentelemetry/api\";\nimport { isPlainObject } from \"@squide/core\";\nimport type { RootLogger } from \"@workleap/logging\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport { createTraceContextId } from \"./createTraceContextId.ts\";\n\nexport type ActiveSpanId = string;\n\nexport interface ActiveSpan {\n    id: ActiveSpanId;\n    name: string;\n    instance: Span;\n}\n\n// Using a stack because we want a Last In First Out implementation for this.\n// https://github.com/open-telemetry/opentelemetry-js/issues/5084\n// https://github.com/open-telemetry/opentelemetry-js/issues/3558#issuecomment-1760680244\nclass ActiveSpanStack {\n    readonly #stack: ActiveSpan[] = [];\n\n    push(span: ActiveSpan) {\n        this.#stack.push(span);\n    }\n\n    pop(span: ActiveSpan) {\n        const head = this.#stack.pop();\n\n        if (!head) {\n            throw new Error(\"[squide] Unexpected pop, the active Honeycomb span stack is empty.\");\n        }\n\n        if (head.id !== span.id) {\n            throw new Error(`[squide] The active Honeycomb span is not the expected span. Expected to pop span with name and id \"${span.name} / ${span.id}\" but found \"${head.name} / ${head.id}\". Did you forget to end an active span?`);\n        }\n\n        return head;\n    }\n\n    peek() {\n        if (this.#stack.length === 0) {\n            return undefined;\n        }\n\n        return this.#stack[this.#stack.length - 1];\n    }\n}\n\nconst GlobalActiveSpanStackVariableName = \"__SQUIDE_HONEYCOMB_ACTIVE_SPAN_STACK__\";\n\nexport function registerActiveSpanStack() {\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore\n    if (globalThis[GlobalActiveSpanStackVariableName]) {\n        throw new Error(`[squide] An ActiveSpanStack instance has already been registered to globalThis.${GlobalActiveSpanStackVariableName}. Did you register the Honeycomb instrumentation twice?`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore\n    globalThis[GlobalActiveSpanStackVariableName] = new ActiveSpanStack();\n}\n\nfunction getActiveSpanStack() {\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore\n    return globalThis[GlobalActiveSpanStackVariableName] as ActiveSpanStack;\n}\n\nfunction getActiveSpan() {\n    const stack = getActiveSpanStack();\n\n    if (stack) {\n        return stack.peek();\n    }\n}\n\nexport function setActiveSpan(name: string, span: Span) {\n    const activeSpan: ActiveSpan = {\n        id: uuidv4(),\n        name: name,\n        instance: span\n    };\n\n    const stack = getActiveSpanStack();\n\n    if (stack) {\n        stack.push(activeSpan);\n    }\n\n    return activeSpan;\n}\n\nexport function popActiveSpan(span: ActiveSpan) {\n    const stack = getActiveSpanStack();\n\n    if (stack) {\n        stack.pop(span);\n    }\n}\n\nexport function createOverrideFetchRequestSpanWithActiveSpanContext(logger: RootLogger) {\n    return (span: Span, request: Request | RequestInit) => {\n        const activeSpan = getActiveSpan();\n\n        if (activeSpan) {\n            const activeSpanContext = activeSpan.instance.spanContext();\n            const requestSpanContext = span.spanContext();\n\n            if (activeSpanContext) {\n                logger\n                    .withText(\"[squide] Found a Honeycomb active context to apply to the following fetch request:\")\n                    .withLineChange()\n                    .withText(\"Request span context:\")\n                    .withObject(requestSpanContext)\n                    .withLineChange()\n                    .withText(\"Active span context:\")\n                    .withObject(activeSpanContext)\n                    .withLineChange()\n                    .withText(\"Request:\")\n                    .withObject(request)\n                    .debug();\n\n                span.setAttribute(\"trace.trace_id\", activeSpanContext.traceId);\n                span.setAttribute(\"trace.parent_id\", activeSpanContext.spanId);\n\n                const traceParent = createTraceContextId(activeSpanContext.traceId, requestSpanContext.spanId, requestSpanContext.traceFlags);\n\n                if (request instanceof Request) {\n                    request.headers.set(\"traceparent\", traceParent);\n                } else if (isPlainObject(request.headers)) {\n                    request.headers[\"traceparent\"] = traceParent;\n                }\n\n                // Indicates to not propagate the requests to the subsequent hooks.\n                return true;\n            }\n        }\n    };\n}\n"],"names":["isPlainObject","v4","uuidv4","createTraceContextId","ActiveSpanStack","span","head","Error","undefined","GlobalActiveSpanStackVariableName","registerActiveSpanStack","globalThis","getActiveSpanStack","getActiveSpan","stack","setActiveSpan","name","activeSpan","popActiveSpan","createOverrideFetchRequestSpanWithActiveSpanContext","logger","request","activeSpanContext","requestSpanContext","traceParent","Request"],"mappings":";;;;;;;;;;;AAC6C;AAET;AAC6B;AAUjE,6EAA6E;AAC7E,iEAAiE;AACjE,yFAAyF;AACzF,MAAMI;IACO,MAAM,GAAiB,EAAE,CAAC;IAEnC,KAAKC,IAAgB,EAAE;QACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAACA;IACrB;IAEA,IAAIA,IAAgB,EAAE;QAClB,MAAMC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG;QAE5B,IAAI,CAACA,MAAM;YACP,MAAM,IAAIC,MAAM;QACpB;QAEA,IAAID,KAAK,EAAE,KAAKD,KAAK,EAAE,EAAE;YACrB,MAAM,IAAIE,MAAM,CAAC,oGAAoG,EAAEF,KAAK,IAAI,CAAC,GAAG,EAAEA,KAAK,EAAE,CAAC,aAAa,EAAEC,KAAK,IAAI,CAAC,GAAG,EAAEA,KAAK,EAAE,CAAC,wCAAwC,CAAC;QACjO;QAEA,OAAOA;IACX;IAEA,OAAO;QACH,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,GAAG;YAC1B,OAAOE;QACX;QAEA,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE;IAC9C;AACJ;AAEA,MAAMC,oCAAoC;AAEnC,SAASC;IACZ,6DAA6D;IAC7D,aAAa;IACb,IAAIC,UAAU,CAACF,kCAAkC,EAAE;QAC/C,MAAM,IAAIF,MAAM,CAAC,+EAA+E,EAAEE,kCAAkC,uDAAuD,CAAC;IAChM;IAEA,6DAA6D;IAC7D,aAAa;IACbE,UAAU,CAACF,kCAAkC,GAAG,IAAIL;AACxD;AAEA,SAASQ;IACL,6DAA6D;IAC7D,aAAa;IACb,OAAOD,UAAU,CAACF,kCAAkC;AACxD;AAEA,SAASI;IACL,MAAMC,QAAQF;IAEd,IAAIE,OAAO;QACP,OAAOA,MAAM,IAAI;IACrB;AACJ;AAEO,SAASC,cAAcC,IAAY,EAAEX,IAAU;IAClD,MAAMY,aAAyB;QAC3B,IAAIf,EAAMA;QACV,MAAMc;QACN,UAAUX;IACd;IAEA,MAAMS,QAAQF;IAEd,IAAIE,OAAO;QACPA,MAAM,IAAI,CAACG;IACf;IAEA,OAAOA;AACX;AAEO,SAASC,cAAcb,IAAgB;IAC1C,MAAMS,QAAQF;IAEd,IAAIE,OAAO;QACPA,MAAM,GAAG,CAACT;IACd;AACJ;AAEO,SAASc,oDAAoDC,MAAkB;IAClF,OAAO,CAACf,MAAYgB;QAChB,MAAMJ,aAAaJ;QAEnB,IAAII,YAAY;YACZ,MAAMK,oBAAoBL,WAAW,QAAQ,CAAC,WAAW;YACzD,MAAMM,qBAAqBlB,KAAK,WAAW;YAE3C,IAAIiB,mBAAmB;gBACnBF,OACK,QAAQ,CAAC,sFACT,cAAc,GACd,QAAQ,CAAC,yBACT,UAAU,CAACG,oBACX,cAAc,GACd,QAAQ,CAAC,wBACT,UAAU,CAACD,mBACX,cAAc,GACd,QAAQ,CAAC,YACT,UAAU,CAACD,SACX,KAAK;gBAEVhB,KAAK,YAAY,CAAC,kBAAkBiB,kBAAkB,OAAO;gBAC7DjB,KAAK,YAAY,CAAC,mBAAmBiB,kBAAkB,MAAM;gBAE7D,MAAME,cAAcrB,oBAAoBA,CAACmB,kBAAkB,OAAO,EAAEC,mBAAmB,MAAM,EAAEA,mBAAmB,UAAU;gBAE5H,IAAIF,mBAAmBI,SAAS;oBAC5BJ,QAAQ,OAAO,CAAC,GAAG,CAAC,eAAeG;gBACvC,OAAO,IAAIxB,aAAaA,CAACqB,QAAQ,OAAO,GAAG;oBACvCA,QAAQ,OAAO,CAAC,cAAc,GAAGG;gBACrC;gBAEA,mEAAmE;gBACnE,OAAO;YACX;QACJ;IACJ;AACJ"}
+{"version":3,"file":"honeycomb/activeSpan.js","sources":["webpack://@squide/firefly/./src/honeycomb/activeSpan.ts"],"sourcesContent":["import type { Span } from \"@opentelemetry/api\";\nimport { isPlainObject } from \"@squide/core\";\nimport type { Logger } from \"@workleap/logging\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport { createTraceContextId } from \"./createTraceContextId.ts\";\n\nexport type ActiveSpanId = string;\n\nexport interface ActiveSpan {\n    id: ActiveSpanId;\n    name: string;\n    instance: Span;\n}\n\n// Using a stack because we want a Last In First Out implementation for this.\n// https://github.com/open-telemetry/opentelemetry-js/issues/5084\n// https://github.com/open-telemetry/opentelemetry-js/issues/3558#issuecomment-1760680244\nclass ActiveSpanStack {\n    readonly #stack: ActiveSpan[] = [];\n\n    push(span: ActiveSpan) {\n        this.#stack.push(span);\n    }\n\n    pop(span: ActiveSpan) {\n        const head = this.#stack.pop();\n\n        if (!head) {\n            throw new Error(\"[squide] Unexpected pop, the active Honeycomb span stack is empty.\");\n        }\n\n        if (head.id !== span.id) {\n            throw new Error(`[squide] The active Honeycomb span is not the expected span. Expected to pop span with name and id \"${span.name} / ${span.id}\" but found \"${head.name} / ${head.id}\". Did you forget to end an active span?`);\n        }\n\n        return head;\n    }\n\n    peek() {\n        if (this.#stack.length === 0) {\n            return undefined;\n        }\n\n        return this.#stack[this.#stack.length - 1];\n    }\n}\n\nconst GlobalActiveSpanStackVariableName = \"__SQUIDE_HONEYCOMB_ACTIVE_SPAN_STACK__\";\n\nexport function registerActiveSpanStack() {\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore\n    if (globalThis[GlobalActiveSpanStackVariableName]) {\n        throw new Error(`[squide] An ActiveSpanStack instance has already been registered to globalThis.${GlobalActiveSpanStackVariableName}. Did you register the Honeycomb instrumentation twice?`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore\n    globalThis[GlobalActiveSpanStackVariableName] = new ActiveSpanStack();\n}\n\nfunction getActiveSpanStack() {\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore\n    return globalThis[GlobalActiveSpanStackVariableName] as ActiveSpanStack;\n}\n\nfunction getActiveSpan() {\n    const stack = getActiveSpanStack();\n\n    if (stack) {\n        return stack.peek();\n    }\n}\n\nexport function setActiveSpan(name: string, span: Span) {\n    const activeSpan: ActiveSpan = {\n        id: uuidv4(),\n        name: name,\n        instance: span\n    };\n\n    const stack = getActiveSpanStack();\n\n    if (stack) {\n        stack.push(activeSpan);\n    }\n\n    return activeSpan;\n}\n\nexport function popActiveSpan(span: ActiveSpan) {\n    const stack = getActiveSpanStack();\n\n    if (stack) {\n        stack.pop(span);\n    }\n}\n\nexport function createOverrideFetchRequestSpanWithActiveSpanContext(logger: Logger) {\n    return (span: Span, request: Request | RequestInit) => {\n        const activeSpan = getActiveSpan();\n\n        if (activeSpan) {\n            const activeSpanContext = activeSpan.instance.spanContext();\n            const requestSpanContext = span.spanContext();\n\n            if (activeSpanContext) {\n                logger\n                    .withText(\"[squide] Found a Honeycomb active context to apply to the following fetch request:\")\n                    .withLineChange()\n                    .withText(\"Request span context:\")\n                    .withObject(requestSpanContext)\n                    .withLineChange()\n                    .withText(\"Active span context:\")\n                    .withObject(activeSpanContext)\n                    .withLineChange()\n                    .withText(\"Request:\")\n                    .withObject(request)\n                    .debug();\n\n                span.setAttribute(\"trace.trace_id\", activeSpanContext.traceId);\n                span.setAttribute(\"trace.parent_id\", activeSpanContext.spanId);\n\n                const traceParent = createTraceContextId(activeSpanContext.traceId, requestSpanContext.spanId, requestSpanContext.traceFlags);\n\n                if (request instanceof Request) {\n                    request.headers.set(\"traceparent\", traceParent);\n                } else if (isPlainObject(request.headers)) {\n                    request.headers[\"traceparent\"] = traceParent;\n                }\n\n                // Indicates to not propagate the requests to the subsequent hooks.\n                return true;\n            }\n        }\n    };\n}\n"],"names":["isPlainObject","v4","uuidv4","createTraceContextId","ActiveSpanStack","span","head","Error","undefined","GlobalActiveSpanStackVariableName","registerActiveSpanStack","globalThis","getActiveSpanStack","getActiveSpan","stack","setActiveSpan","name","activeSpan","popActiveSpan","createOverrideFetchRequestSpanWithActiveSpanContext","logger","request","activeSpanContext","requestSpanContext","traceParent","Request"],"mappings":";;;;;;;;;;;AAC6C;AAET;AAC6B;AAUjE,6EAA6E;AAC7E,iEAAiE;AACjE,yFAAyF;AACzF,MAAMI;IACO,MAAM,GAAiB,EAAE,CAAC;IAEnC,KAAKC,IAAgB,EAAE;QACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAACA;IACrB;IAEA,IAAIA,IAAgB,EAAE;QAClB,MAAMC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG;QAE5B,IAAI,CAACA,MAAM;YACP,MAAM,IAAIC,MAAM;QACpB;QAEA,IAAID,KAAK,EAAE,KAAKD,KAAK,EAAE,EAAE;YACrB,MAAM,IAAIE,MAAM,CAAC,oGAAoG,EAAEF,KAAK,IAAI,CAAC,GAAG,EAAEA,KAAK,EAAE,CAAC,aAAa,EAAEC,KAAK,IAAI,CAAC,GAAG,EAAEA,KAAK,EAAE,CAAC,wCAAwC,CAAC;QACjO;QAEA,OAAOA;IACX;IAEA,OAAO;QACH,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,GAAG;YAC1B,OAAOE;QACX;QAEA,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE;IAC9C;AACJ;AAEA,MAAMC,oCAAoC;AAEnC,SAASC;IACZ,6DAA6D;IAC7D,aAAa;IACb,IAAIC,UAAU,CAACF,kCAAkC,EAAE;QAC/C,MAAM,IAAIF,MAAM,CAAC,+EAA+E,EAAEE,kCAAkC,uDAAuD,CAAC;IAChM;IAEA,6DAA6D;IAC7D,aAAa;IACbE,UAAU,CAACF,kCAAkC,GAAG,IAAIL;AACxD;AAEA,SAASQ;IACL,6DAA6D;IAC7D,aAAa;IACb,OAAOD,UAAU,CAACF,kCAAkC;AACxD;AAEA,SAASI;IACL,MAAMC,QAAQF;IAEd,IAAIE,OAAO;QACP,OAAOA,MAAM,IAAI;IACrB;AACJ;AAEO,SAASC,cAAcC,IAAY,EAAEX,IAAU;IAClD,MAAMY,aAAyB;QAC3B,IAAIf,EAAMA;QACV,MAAMc;QACN,UAAUX;IACd;IAEA,MAAMS,QAAQF;IAEd,IAAIE,OAAO;QACPA,MAAM,IAAI,CAACG;IACf;IAEA,OAAOA;AACX;AAEO,SAASC,cAAcb,IAAgB;IAC1C,MAAMS,QAAQF;IAEd,IAAIE,OAAO;QACPA,MAAM,GAAG,CAACT;IACd;AACJ;AAEO,SAASc,oDAAoDC,MAAc;IAC9E,OAAO,CAACf,MAAYgB;QAChB,MAAMJ,aAAaJ;QAEnB,IAAII,YAAY;YACZ,MAAMK,oBAAoBL,WAAW,QAAQ,CAAC,WAAW;YACzD,MAAMM,qBAAqBlB,KAAK,WAAW;YAE3C,IAAIiB,mBAAmB;gBACnBF,OACK,QAAQ,CAAC,sFACT,cAAc,GACd,QAAQ,CAAC,yBACT,UAAU,CAACG,oBACX,cAAc,GACd,QAAQ,CAAC,wBACT,UAAU,CAACD,mBACX,cAAc,GACd,QAAQ,CAAC,YACT,UAAU,CAACD,SACX,KAAK;gBAEVhB,KAAK,YAAY,CAAC,kBAAkBiB,kBAAkB,OAAO;gBAC7DjB,KAAK,YAAY,CAAC,mBAAmBiB,kBAAkB,MAAM;gBAE7D,MAAME,cAAcrB,oBAAoBA,CAACmB,kBAAkB,OAAO,EAAEC,mBAAmB,MAAM,EAAEA,mBAAmB,UAAU;gBAE5H,IAAIF,mBAAmBI,SAAS;oBAC5BJ,QAAQ,OAAO,CAAC,GAAG,CAAC,eAAeG;gBACvC,OAAO,IAAIxB,aAAaA,CAACqB,QAAQ,OAAO,GAAG;oBACvCA,QAAQ,OAAO,CAAC,cAAc,GAAGG;gBACrC;gBAEA,mEAAmE;gBACnE,OAAO;YACX;QACJ;IACJ;AACJ"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@squide/firefly",
   "author": "Workleap",
-  "version": "13.3.1",
+  "version": "14.0.0",
   "description": "Helpers to facilitate the creation of an application with the Squide firefly technology stack.",
   "license": "Apache-2.0",
   "repository": {
@@ -29,34 +29,34 @@
   ],
   "peerDependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "@tanstack/react-query": "^5.83.0",
-    "msw": "^2.10.4",
+    "@tanstack/react-query": "^5.87.1",
+    "msw": "^2.11.1",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
-    "react-router": "^7.7.0"
+    "react-router": "^7.8.2"
   },
   "dependencies": {
-    "@workleap/logging": "^1.2.5",
-    "uuid": "^11.1.0",
-    "@squide/core": "5.7.0",
-    "@squide/module-federation": "6.5.0",
-    "@squide/react-router": "7.3.0",
-    "@squide/msw": "3.5.0"
+    "@workleap/logging": "^1.3.0",
+    "uuid": "^12.0.0",
+    "@squide/core": "6.0.0",
+    "@squide/module-federation": "7.0.0",
+    "@squide/msw": "4.0.0",
+    "@squide/react-router": "8.0.0"
   },
   "devDependencies": {
-    "@rsbuild/core": "1.4.7",
-    "@rslib/core": "0.10.6",
+    "@rsbuild/core": "1.5.4",
+    "@rslib/core": "0.12.4",
     "@testing-library/react": "16.3.0",
-    "@types/react": "19.1.8",
-    "@types/react-dom": "19.1.6",
-    "@typescript-eslint/parser": "8.37.0",
-    "@vitejs/plugin-react": "4.6.0",
+    "@types/react": "19.1.12",
+    "@types/react-dom": "19.1.9",
+    "@typescript-eslint/parser": "8.42.0",
+    "@vitejs/plugin-react": "5.0.2",
     "@workleap/eslint-plugin": "3.5.0",
     "@workleap/rslib-configs": "1.1.0",
     "@workleap/typescript-configs": "3.0.4",
     "eslint": "8.57.0",
     "happy-dom": "18.0.1",
-    "typescript": "5.8.3",
+    "typescript": "5.9.2",
     "vitest": "3.2.4"
   },
   "sideEffects": false,

package/src/AppRouterReducer.ts

@@ -188,16 +188,11 @@ export function useModuleRegistrationStatusDispatcher(areModulesRegisteredValue:
             dispatch({ type: "modules-registered" });
 
             logger
-                .withText("[squide]")
-                .withText("Modules are registered", {
+                .withText("[squide] Modules are registered.", {
                     style: {
-                        color: "white",
-                        backgroundColor: "green"
+                        color: "green"
                     }
                 })
-                .withText(".", {
-                    leadingSpace: false
-                })
                 .information();
 
             return true;
@@ -211,16 +206,11 @@ export function useModuleRegistrationStatusDispatcher(areModulesRegisteredValue:
             dispatch({ type: "modules-ready" });
 
             logger
-                .withText("[squide]")
-                .withText("Modules are ready", {
+                .withText("[squide] Modules are ready.", {
                     style: {
-                        color: "white",
-                        backgroundColor: "green"
+                        color: "green"
                     }
                 })
-                .withText(".", {
-                    leadingSpace: false
-                })
                 .information();
 
             return true;
@@ -258,16 +248,11 @@ export function useMswStatusDispatcher(isMswReadyValue: boolean, dispatch: AppRo
             dispatch({ type: "msw-ready" });
 
             logger
-                .withText("[squide]")
-                .withText("MSW is ready", {
+                .withText("[squide] MSW is ready.", {
                     style: {
-                        color: "white",
-                        backgroundColor: "green"
+                        color: "green"
                     }
                 })
-                .withText(".", {
-                    leadingSpace: false
-                })
                 .information();
 
             return true;

package/src/AppRouterStore.ts

@@ -2,7 +2,7 @@
 // access to the state and ease the integration with third-party libraries such as the Platform Widgets.
 // Eventually, AppRouterReducer should be deprecated in favor of this new AppRouterStore.
 
-import type { RootLogger } from "@workleap/logging";
+import type { Logger } from "@workleap/logging";
 import type { AppRouterAction, AppRouterState } from "./AppRouterReducer.ts";
 
 export type AppRouterStoreState = Omit<AppRouterState, "waitForMsw" | "waitForPublicData" | "waitForProtectedData">;
@@ -13,9 +13,9 @@ export class AppRouterStore {
     #state: AppRouterStoreState;
 
     readonly #listeners = new Set<AppRouterStoreListenerFunction>();
-    readonly #logger: RootLogger;
+    readonly #logger: Logger;
 
-    constructor(initialialState: AppRouterStoreState, logger: RootLogger) {
+    constructor(initialialState: AppRouterStoreState, logger: Logger) {
         this.#state = initialialState;
         this.#logger = logger;
     }
@@ -160,7 +160,7 @@ export class AppRouterStore {
     }
 }
 
-export function createAppRouterStore(logger: RootLogger) {
+export function createAppRouterStore(logger: Logger) {
     const initialState: AppRouterStoreState = {
         areModulesRegistered: false,
         areModulesReady: false,

package/src/FireflyRuntime.tsx

@@ -1,6 +1,7 @@
-import type { RegisterRouteOptions, RuntimeOptions } from "@squide/core";
+import type { RegisterRouteOptions, RuntimeMethodOptions, RuntimeOptions } from "@squide/core";
 import { MswPlugin, MswPluginName } from "@squide/msw";
-import { ReactRouterRuntime, type Route } from "@squide/react-router";
+import { type IReactRouterRuntime, ReactRouterRuntime, ReactRouterRuntimeScope, type Route } from "@squide/react-router";
+import type { Logger } from "@workleap/logging";
 import type { RequestHandler } from "msw";
 import { getAreModulesRegistered } from "./AppRouterReducer.ts";
 import { type AppRouterStore, createAppRouterStore } from "./AppRouterStore.ts";
@@ -9,9 +10,18 @@ export interface FireflyRuntimeOptions extends RuntimeOptions {
     useMsw?: boolean;
 }
 
-export class FireflyRuntime extends ReactRouterRuntime {
-    readonly #appRouterStore: AppRouterStore;
-    readonly #useMsw: boolean;
+export interface RegisterRequestHandlersOptions extends RuntimeMethodOptions {}
+
+export interface IFireflyRuntime extends IReactRouterRuntime {
+    registerRequestHandlers: (handlers: RequestHandler[]) => void;
+    get requestHandlers(): RequestHandler[];
+    get appRouterStore(): AppRouterStore;
+    get isMswEnabled(): boolean;
+}
+
+export class FireflyRuntime extends ReactRouterRuntime implements IFireflyRuntime {
+    protected _appRouterStore: AppRouterStore;
+    protected _useMsw: boolean;
 
     constructor({ plugins, useMsw, ...options }: FireflyRuntimeOptions = {}) {
         if (useMsw) {
@@ -23,20 +33,21 @@ export class FireflyRuntime extends ReactRouterRuntime {
                 ...options
             });
 
-            this.#useMsw = true;
+            this._useMsw = true;
         } else {
             super({
                 plugins,
                 ...options
             });
 
-            this.#useMsw = false;
+            this._useMsw = false;
         }
 
-        this.#appRouterStore = createAppRouterStore(this._logger);
+        this._appRouterStore = createAppRouterStore(this._logger);
     }
 
-    registerRequestHandlers(handlers: RequestHandler[]) {
+    registerRequestHandlers(handlers: RequestHandler[], options: RegisterRequestHandlersOptions = {}) {
+        const logger = this._getLogger(options);
         const mswPlugin = this.getPlugin(MswPluginName) as MswPlugin;
 
         if (!mswPlugin) {
@@ -47,7 +58,9 @@ export class FireflyRuntime extends ReactRouterRuntime {
             throw new Error("[squide] Cannot register an MSW request handlers once the modules are registered. Are you trying to register an MSW request handler in a deferred registration function? Only navigation items can be registered in a deferred registration function.");
         }
 
-        mswPlugin.registerRequestHandlers(handlers);
+        mswPlugin.registerRequestHandlers(handlers, {
+            logger
+        });
     }
 
     // Must define a return type otherwise we get an "error TS2742: The inferred type of 'requestHandlers' cannot be named" error.
@@ -70,10 +83,35 @@ export class FireflyRuntime extends ReactRouterRuntime {
     }
 
     get appRouterStore() {
-        return this.#appRouterStore;
+        return this._appRouterStore;
+    }
+
+    get isMswEnabled() {
+        return this._useMsw;
+    }
+
+    startScope(logger: Logger): FireflyRuntime {
+        return (new FireflyRuntimeScope(this, logger) as unknown) as FireflyRuntime;
+    }
+}
+
+export class FireflyRuntimeScope<TRuntime extends FireflyRuntime = FireflyRuntime> extends ReactRouterRuntimeScope<TRuntime> implements IFireflyRuntime {
+    registerRequestHandlers(handlers: RequestHandler[], options: RegisterRequestHandlersOptions = {}) {
+        this._runtime.registerRequestHandlers(handlers, {
+            ...options,
+            logger: this._getLogger(options)
+        });
+    }
+
+    get requestHandlers(): RequestHandler[] {
+        return this._runtime.requestHandlers;
+    }
+
+    get appRouterStore() {
+        return this._runtime.appRouterStore;
     }
 
     get isMswEnabled() {
-        return this.#useMsw;
+        return this._runtime.isMswEnabled;
     }
 }

package/src/honeycomb/activeSpan.ts

@@ -1,6 +1,6 @@
 import type { Span } from "@opentelemetry/api";
 import { isPlainObject } from "@squide/core";
-import type { RootLogger } from "@workleap/logging";
+import type { Logger } from "@workleap/logging";
 import { v4 as uuidv4 } from "uuid";
 import { createTraceContextId } from "./createTraceContextId.ts";
 
@@ -97,7 +97,7 @@ export function popActiveSpan(span: ActiveSpan) {
     }
 }
 
-export function createOverrideFetchRequestSpanWithActiveSpanContext(logger: RootLogger) {
+export function createOverrideFetchRequestSpanWithActiveSpanContext(logger: Logger) {
     return (span: Span, request: Request | RequestInit) => {
         const activeSpan = getActiveSpan();