@squide/firefly 16.0.0 → 16.0.2

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @squide/firefly
 
+## 16.0.2
+
+### Patch Changes
+
+- [#345](https://github.com/workleap/wl-squide/pull/345) [`d05a890`](https://github.com/workleap/wl-squide/commit/d05a890517a1a9d9a0b4946690b36c14ea07aa49) Thanks [@patricklafrance](https://github.com/patricklafrance)! - Added a `strictMode` prop to the `AppRouter` component.
+
+## 16.0.1
+
+### Patch Changes
+
+- [#342](https://github.com/workleap/wl-squide/pull/342) [`3be4070`](https://github.com/workleap/wl-squide/commit/3be4070d2d647804903b5cc01113e20d5d71cb11) Thanks [@patricklafrance](https://github.com/patricklafrance)! - Minor fine tuning following v16 release.
+
+- Updated dependencies [[`3be4070`](https://github.com/workleap/wl-squide/commit/3be4070d2d647804903b5cc01113e20d5d71cb11)]:
+  - @squide/env-vars@1.4.8
+  - @squide/core@6.1.5
+  - @squide/msw@4.0.6
+  - @squide/react-router@8.1.5
+
 ## 16.0.0
 
 ### Major Changes

package/dist/AppRouter.d.ts

@@ -15,6 +15,7 @@ export declare function useCanRenderRouter({ areModulesRegistered, areModulesRea
 export interface AppRouterProps {
     waitForPublicData?: boolean;
     waitForProtectedData?: boolean;
+    strictMode?: boolean;
     children: RenderRouterProviderFunction;
 }
 export declare function AppRouter(props: AppRouterProps): import("react/jsx-runtime").JSX.Element;

package/dist/AppRouter.js

@@ -37,7 +37,7 @@ function useCanRenderRouter({ areModulesRegistered, areModulesReady: areModulesR
     // depends on the protected data.
     areModulesRegistered || areModulesReadyValue);
 }
-function useRenderRouterProvider(state, renderRouterProvider) {
+function useRenderRouterProvider(state, renderRouterProvider, strictMode) {
     const routes = useRoutes();
     // The value is computed outside of the router provider memo to prevent
     // rendering a new router provider everytime the app router state change.
@@ -45,7 +45,9 @@ function useRenderRouterProvider(state, renderRouterProvider) {
     return useMemo(()=>{
         if (canRenderRouter) {
             return renderRouterProvider({
-                rootRoute: /*#__PURE__*/ jsx(RootRoute, {}),
+                rootRoute: /*#__PURE__*/ jsx(RootRoute, {
+                    strictMode: strictMode
+                }),
                 registeredRoutes: routes,
                 routerProviderProps: {}
             });
@@ -54,21 +56,24 @@ function useRenderRouterProvider(state, renderRouterProvider) {
     }, [
         canRenderRouter,
         routes,
-        renderRouterProvider
+        renderRouterProvider,
+        strictMode
     ]);
 }
 function AppRouter(props) {
-    const { waitForPublicData = false, waitForProtectedData = false, children: renderRouterProvider } = props;
+    const { waitForPublicData = false, waitForProtectedData = false, strictMode = true, children: renderRouterProvider } = props;
     const [state, dispatch] = useAppRouterReducer(waitForPublicData, waitForProtectedData);
     const logger = useLogger();
-    useStrictRegistrationMode();
+    useStrictRegistrationMode({
+        isEnabled: strictMode
+    });
     useEffect(()=>{
         logger.withText("[squide] AppRouter state updated:").withObject(state).debug();
     }, [
         state,
         logger
     ]);
-    const routerProvider = useRenderRouterProvider(state, renderRouterProvider);
+    const routerProvider = useRenderRouterProvider(state, renderRouterProvider, strictMode);
     return /*#__PURE__*/ jsx(AppRouterDispatcherContext.Provider, {
         value: dispatch,
         children: /*#__PURE__*/ jsx(AppRouterStateContext.Provider, {

package/dist/AppRouter.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppRouter.js","sources":["../src/AppRouter.tsx"],"sourcesContent":["import { useLogger } from \"@squide/core\";\nimport { useRoutes, type Route } from \"@squide/react-router\";\nimport { useEffect, useMemo, type ReactElement } from \"react\";\nimport type { RouterProviderProps } from \"react-router/dom\";\nimport { AppRouterDispatcherContext, AppRouterStateContext } from \"./AppRouterContext.ts\";\nimport { useAppRouterReducer, type AppRouterState } from \"./AppRouterReducer.ts\";\nimport { RootRoute } from \"./RootRoute.tsx\";\nimport { useStrictRegistrationMode } from \"./useStrictRegistrationMode.ts\";\n\nexport interface AppRouterRenderFunctionArgs {\n    routes: Route[];\n}\n\nexport interface RenderRouterProviderFunctionArgs {\n    rootRoute: ReactElement;\n    registeredRoutes: Route[];\n    routerProviderProps: Omit<RouterProviderProps, \"router\">;\n}\n\nexport type RenderRouterProviderFunction = (args: RenderRouterProviderFunctionArgs) => ReactElement;\n\nexport function useCanRenderRouter({ areModulesRegistered, areModulesReady: areModulesReadyValue }: AppRouterState) {\n    return (\n        // Wait until the modules has been registered, but do not wait for the deferred registrations to be registered has they will probably\n        // depends on the protected data.\n        (areModulesRegistered || areModulesReadyValue)\n    );\n}\n\nfunction useRenderRouterProvider(state: AppRouterState, renderRouterProvider: RenderRouterProviderFunction) {\n    const routes = useRoutes();\n\n    // The value is computed outside of the router provider memo to prevent\n    // rendering a new router provider everytime the app router state change.\n    const canRenderRouter = useCanRenderRouter(state);\n\n    return useMemo(() => {\n        if (canRenderRouter) {\n            return renderRouterProvider({\n                rootRoute: <RootRoute />,\n                registeredRoutes: routes,\n                routerProviderProps: {}\n            });\n        }\n\n        return null;\n    }, [canRenderRouter, routes, renderRouterProvider]);\n}\n\nexport interface AppRouterProps {\n    waitForPublicData?: boolean;\n    waitForProtectedData?: boolean;\n    children: RenderRouterProviderFunction;\n}\n\nexport function AppRouter(props: AppRouterProps) {\n    const {\n        waitForPublicData = false,\n        waitForProtectedData = false,\n        children: renderRouterProvider\n    } = props;\n    const [state, dispatch] = useAppRouterReducer(waitForPublicData, waitForProtectedData);\n\n    const logger = useLogger();\n\n    useStrictRegistrationMode();\n\n    useEffect(() => {\n        logger\n            .withText(\"[squide] AppRouter state updated:\")\n            .withObject(state)\n            .debug();\n    }, [state, logger]);\n\n    const routerProvider = useRenderRouterProvider(state, renderRouterProvider);\n\n    return (\n        <AppRouterDispatcherContext.Provider value={dispatch}>\n            <AppRouterStateContext.Provider value={state}>\n                {routerProvider}\n            </AppRouterStateContext.Provider>\n        </AppRouterDispatcherContext.Provider>\n    );\n}\n"],"names":["useLogger","useRoutes","useEffect","useMemo","AppRouterDispatcherContext","AppRouterStateContext","useAppRouterReducer","RootRoute","useStrictRegistrationMode","useCanRenderRouter","areModulesRegistered","areModulesReadyValue","useRenderRouterProvider","state","renderRouterProvider","routes","canRenderRouter","AppRouter","props","waitForPublicData","waitForProtectedData","dispatch","logger","routerProvider"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAAyC;AACoB;AACC;AAE4B;AACT;AACrC;AAC+B;AAcpE,SAASS,mBAAmB,EAAEC,oBAAoB,EAAE,iBAAiBC,oBAAoB,EAAkB;IAC9G,OACI,qIAAqI;IACrI,iCAAiC;IAChCD,wBAAwBC;AAEjC;AAEA,SAASC,wBAAwBC,KAAqB,EAAEC,oBAAkD;IACtG,MAAMC,SAASd,SAASA;IAExB,uEAAuE;IACvE,yEAAyE;IACzE,MAAMe,kBAAkBP,mBAAmBI;IAE3C,OAAOV,OAAOA,CAAC;QACX,IAAIa,iBAAiB;YACjB,OAAOF,qBAAqB;gBACxB,yBAAW,IAACP,SAASA;gBACrB,kBAAkBQ;gBAClB,qBAAqB,CAAC;YAC1B;QACJ;QAEA,OAAO;IACX,GAAG;QAACC;QAAiBD;QAAQD;KAAqB;AACtD;AAQO,SAASG,UAAUC,KAAqB;IAC3C,MAAM,EACFC,oBAAoB,KAAK,EACzBC,uBAAuB,KAAK,EAC5B,UAAUN,oBAAoB,EACjC,GAAGI;IACJ,MAAM,CAACL,OAAOQ,SAAS,GAAGf,mBAAmBA,CAACa,mBAAmBC;IAEjE,MAAME,SAAStB,SAASA;IAExBQ,yBAAyBA;IAEzBN,SAASA,CAAC;QACNoB,OACK,QAAQ,CAAC,qCACT,UAAU,CAACT,OACX,KAAK;IACd,GAAG;QAACA;QAAOS;KAAO;IAElB,MAAMC,iBAAiBX,wBAAwBC,OAAOC;IAEtD,qBACI,IAACV,mCAAmC;QAAC,OAAOiB;kBACxC,kBAAChB,8BAA8B;YAAC,OAAOQ;sBAClCU;;;AAIjB"}
+{"version":3,"file":"AppRouter.js","sources":["../src/AppRouter.tsx"],"sourcesContent":["import { useLogger } from \"@squide/core\";\nimport { useRoutes, type Route } from \"@squide/react-router\";\nimport { useEffect, useMemo, type ReactElement } from \"react\";\nimport type { RouterProviderProps } from \"react-router/dom\";\nimport { AppRouterDispatcherContext, AppRouterStateContext } from \"./AppRouterContext.ts\";\nimport { useAppRouterReducer, type AppRouterState } from \"./AppRouterReducer.ts\";\nimport { RootRoute } from \"./RootRoute.tsx\";\nimport { useStrictRegistrationMode } from \"./useStrictRegistrationMode.ts\";\n\nexport interface AppRouterRenderFunctionArgs {\n    routes: Route[];\n}\n\nexport interface RenderRouterProviderFunctionArgs {\n    rootRoute: ReactElement;\n    registeredRoutes: Route[];\n    routerProviderProps: Omit<RouterProviderProps, \"router\">;\n}\n\nexport type RenderRouterProviderFunction = (args: RenderRouterProviderFunctionArgs) => ReactElement;\n\nexport function useCanRenderRouter({ areModulesRegistered, areModulesReady: areModulesReadyValue }: AppRouterState) {\n    return (\n        // Wait until the modules has been registered, but do not wait for the deferred registrations to be registered has they will probably\n        // depends on the protected data.\n        (areModulesRegistered || areModulesReadyValue)\n    );\n}\n\nfunction useRenderRouterProvider(state: AppRouterState, renderRouterProvider: RenderRouterProviderFunction, strictMode: boolean) {\n    const routes = useRoutes();\n\n    // The value is computed outside of the router provider memo to prevent\n    // rendering a new router provider everytime the app router state change.\n    const canRenderRouter = useCanRenderRouter(state);\n\n    return useMemo(() => {\n        if (canRenderRouter) {\n            return renderRouterProvider({\n                rootRoute: <RootRoute strictMode={strictMode} />,\n                registeredRoutes: routes,\n                routerProviderProps: {}\n            });\n        }\n\n        return null;\n    }, [canRenderRouter, routes, renderRouterProvider, strictMode]);\n}\n\nexport interface AppRouterProps {\n    waitForPublicData?: boolean;\n    waitForProtectedData?: boolean;\n    strictMode?: boolean;\n    children: RenderRouterProviderFunction;\n}\n\nexport function AppRouter(props: AppRouterProps) {\n    const {\n        waitForPublicData = false,\n        waitForProtectedData = false,\n        strictMode = true,\n        children: renderRouterProvider\n    } = props;\n    const [state, dispatch] = useAppRouterReducer(waitForPublicData, waitForProtectedData);\n\n    const logger = useLogger();\n\n    useStrictRegistrationMode({\n        isEnabled: strictMode\n    });\n\n    useEffect(() => {\n        logger\n            .withText(\"[squide] AppRouter state updated:\")\n            .withObject(state)\n            .debug();\n    }, [state, logger]);\n\n    const routerProvider = useRenderRouterProvider(state, renderRouterProvider, strictMode);\n\n    return (\n        <AppRouterDispatcherContext.Provider value={dispatch}>\n            <AppRouterStateContext.Provider value={state}>\n                {routerProvider}\n            </AppRouterStateContext.Provider>\n        </AppRouterDispatcherContext.Provider>\n    );\n}\n"],"names":["useLogger","useRoutes","useEffect","useMemo","AppRouterDispatcherContext","AppRouterStateContext","useAppRouterReducer","RootRoute","useStrictRegistrationMode","useCanRenderRouter","areModulesRegistered","areModulesReadyValue","useRenderRouterProvider","state","renderRouterProvider","strictMode","routes","canRenderRouter","AppRouter","props","waitForPublicData","waitForProtectedData","dispatch","logger","routerProvider"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAAyC;AACoB;AACC;AAE4B;AACT;AACrC;AAC+B;AAcpE,SAASS,mBAAmB,EAAEC,oBAAoB,EAAE,iBAAiBC,oBAAoB,EAAkB;IAC9G,OACI,qIAAqI;IACrI,iCAAiC;IAChCD,wBAAwBC;AAEjC;AAEA,SAASC,wBAAwBC,KAAqB,EAAEC,oBAAkD,EAAEC,UAAmB;IAC3H,MAAMC,SAASf,SAASA;IAExB,uEAAuE;IACvE,yEAAyE;IACzE,MAAMgB,kBAAkBR,mBAAmBI;IAE3C,OAAOV,OAAOA,CAAC;QACX,IAAIc,iBAAiB;YACjB,OAAOH,qBAAqB;gBACxB,yBAAW,IAACP,SAASA;oBAAC,YAAYQ;;gBAClC,kBAAkBC;gBAClB,qBAAqB,CAAC;YAC1B;QACJ;QAEA,OAAO;IACX,GAAG;QAACC;QAAiBD;QAAQF;QAAsBC;KAAW;AAClE;AASO,SAASG,UAAUC,KAAqB;IAC3C,MAAM,EACFC,oBAAoB,KAAK,EACzBC,uBAAuB,KAAK,EAC5BN,aAAa,IAAI,EACjB,UAAUD,oBAAoB,EACjC,GAAGK;IACJ,MAAM,CAACN,OAAOS,SAAS,GAAGhB,mBAAmBA,CAACc,mBAAmBC;IAEjE,MAAME,SAASvB,SAASA;IAExBQ,yBAAyBA,CAAC;QACtB,WAAWO;IACf;IAEAb,SAASA,CAAC;QACNqB,OACK,QAAQ,CAAC,qCACT,UAAU,CAACV,OACX,KAAK;IACd,GAAG;QAACA;QAAOU;KAAO;IAElB,MAAMC,iBAAiBZ,wBAAwBC,OAAOC,sBAAsBC;IAE5E,qBACI,IAACX,mCAAmC;QAAC,OAAOkB;kBACxC,kBAACjB,8BAA8B;YAAC,OAAOQ;sBAClCW;;;AAIjB"}

package/dist/FireflyRuntime.d.ts

@@ -1,4 +1,5 @@
 import type { RegisterRouteOptions, RuntimeMethodOptions, RuntimeOptions } from "@squide/core";
+import { EnvironmentVariableKey, EnvironmentVariables, EnvironmentVariableValue } from "@squide/env-vars";
 import { MswState } from "@squide/msw";
 import { type IReactRouterRuntime, ReactRouterRuntime, ReactRouterRuntimeScope, type Route } from "@squide/react-router";
 import type { HoneycombInstrumentationPartialClient } from "@workleap-telemetry/core";
@@ -14,20 +15,28 @@ export interface IFireflyRuntime extends IReactRouterRuntime {
     getMswState(): MswState;
     registerRequestHandlers: (handlers: RequestHandler[]) => void;
     get requestHandlers(): RequestHandler[];
-    get appRouterStore(): AppRouterStore;
     get isMswEnabled(): boolean;
+    registerEnvironmentVariable(key: EnvironmentVariableKey, value: EnvironmentVariableValue): void;
+    registerEnvironmentVariables(variables: Partial<EnvironmentVariables>): void;
+    getEnvironmentVariable(key: EnvironmentVariableKey): EnvironmentVariableValue;
+    getEnvironmentVariables(): EnvironmentVariables;
+    get appRouterStore(): AppRouterStore;
     get honeycombInstrumentationClient(): HoneycombInstrumentationPartialClient | undefined;
 }
 export declare class FireflyRuntime<TRuntime extends FireflyRuntime = any> extends ReactRouterRuntime<TRuntime> implements IFireflyRuntime {
     protected _appRouterStore: AppRouterStore;
     protected _honeycombInstrumentationClient: HoneycombInstrumentationPartialClient | undefined;
-    constructor({ honeycombInstrumentationClient, ...options }?: FireflyRuntimeOptions);
+    constructor(options?: FireflyRuntimeOptions);
+    registerRoute(route: Route, options?: RegisterRouteOptions): void;
     getMswState(): MswState;
     registerRequestHandlers(handlers: RequestHandler[], options?: RegisterRequestHandlersOptions): void;
     get requestHandlers(): RequestHandler[];
-    registerRoute(route: Route, options?: RegisterRouteOptions): void;
-    get appRouterStore(): AppRouterStore;
     get isMswEnabled(): boolean;
+    getEnvironmentVariable(key: EnvironmentVariableKey): never;
+    getEnvironmentVariables(): EnvironmentVariables;
+    registerEnvironmentVariable(key: EnvironmentVariableKey, value: EnvironmentVariableValue): void;
+    registerEnvironmentVariables(variables: Partial<EnvironmentVariables>): void;
+    get appRouterStore(): AppRouterStore;
     get honeycombInstrumentationClient(): HoneycombInstrumentationPartialClient | undefined;
     startScope(logger: Logger): TRuntime;
 }
@@ -35,7 +44,11 @@ export declare class FireflyRuntimeScope<TRuntime extends FireflyRuntime = Firef
     getMswState(): MswState;
     registerRequestHandlers(handlers: RequestHandler[], options?: RegisterRequestHandlersOptions): void;
     get requestHandlers(): RequestHandler[];
-    get appRouterStore(): AppRouterStore;
     get isMswEnabled(): boolean;
+    getEnvironmentVariables(): EnvironmentVariables;
+    getEnvironmentVariable(key: EnvironmentVariableKey): never;
+    registerEnvironmentVariable(key: EnvironmentVariableKey, value: EnvironmentVariableValue): void;
+    registerEnvironmentVariables(variables: Partial<EnvironmentVariables>): void;
+    get appRouterStore(): AppRouterStore;
     get honeycombInstrumentationClient(): HoneycombInstrumentationPartialClient;
 }

package/dist/FireflyRuntime.js

@@ -1,7 +1,10 @@
-import { MswPluginName } from "@squide/msw";
+import { getEnvironmentVariablesPlugin } from "@squide/env-vars";
+import { MswPluginName, getMswPlugin } from "@squide/msw";
 import { ReactRouterRuntime, ReactRouterRuntimeScope } from "@squide/react-router";
 import { createAppRouterStore } from "./AppRouterStore.js";
 
+;// CONCATENATED MODULE: external "@squide/env-vars"
+
 ;// CONCATENATED MODULE: external "@squide/msw"
 
 ;// CONCATENATED MODULE: external "@squide/react-router"
@@ -12,55 +15,64 @@ import { createAppRouterStore } from "./AppRouterStore.js";
 
 
 
+
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 class FireflyRuntime extends ReactRouterRuntime {
     _appRouterStore;
     _honeycombInstrumentationClient;
-    constructor({ honeycombInstrumentationClient, ...options } = {}){
+    constructor(options = {}){
+        const { honeycombInstrumentationClient } = options;
         super(options);
         this._appRouterStore = createAppRouterStore(this._logger);
         this._honeycombInstrumentationClient = honeycombInstrumentationClient;
     }
-    getMswState() {
-        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?");
+    registerRoute(route, options = {}) {
+        if (this.moduleManager.getAreModulesRegistered()) {
+            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.");
         }
-        return mswPlugin.mswState;
+        super.registerRoute(route, options);
+    }
+    getMswState() {
+        const plugin = getMswPlugin(this);
+        return plugin.mswState;
     }
     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?");
-        }
+        const plugin = getMswPlugin(this);
         if (this.moduleManager.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, {
+        plugin.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() {
-        const mswPlugin = this.getPlugin(MswPluginName);
-        if (!mswPlugin) {
-            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?");
-        }
-        return mswPlugin.requestHandlers;
+        const plugin = getMswPlugin(this);
+        return plugin.requestHandlers;
     }
-    registerRoute(route, options = {}) {
-        if (this.moduleManager.getAreModulesRegistered()) {
-            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.");
-        }
-        super.registerRoute(route, options);
+    get isMswEnabled() {
+        return this._plugins.some((x)=>x.name === MswPluginName);
+    }
+    getEnvironmentVariable(key) {
+        const plugin = getEnvironmentVariablesPlugin(this);
+        return plugin.getVariable(key);
+    }
+    getEnvironmentVariables() {
+        const plugin = getEnvironmentVariablesPlugin(this);
+        return plugin.getVariables();
+    }
+    registerEnvironmentVariable(key, value) {
+        const plugin = getEnvironmentVariablesPlugin(this);
+        return plugin.registerVariable(key, value);
+    }
+    registerEnvironmentVariables(variables) {
+        const plugin = getEnvironmentVariablesPlugin(this);
+        return plugin.registerVariables(variables);
     }
     get appRouterStore() {
         return this._appRouterStore;
     }
-    get isMswEnabled() {
-        return this._plugins.some((x)=>x.name === MswPluginName);
-    }
     get honeycombInstrumentationClient() {
         return this._honeycombInstrumentationClient;
     }
@@ -82,12 +94,24 @@ class FireflyRuntimeScope extends ReactRouterRuntimeScope {
     get requestHandlers() {
         return this._runtime.requestHandlers;
     }
-    get appRouterStore() {
-        throw new Error("[squide] Cannot retrieve the app router store from a runtime scope instance.");
-    }
     get isMswEnabled() {
         return this._runtime.isMswEnabled;
     }
+    getEnvironmentVariables() {
+        return this._runtime.getEnvironmentVariables();
+    }
+    getEnvironmentVariable(key) {
+        return this._runtime.getEnvironmentVariable(key);
+    }
+    registerEnvironmentVariable(key, value) {
+        this._runtime.registerEnvironmentVariable(key, value);
+    }
+    registerEnvironmentVariables(variables) {
+        this._runtime.registerEnvironmentVariables(variables);
+    }
+    get appRouterStore() {
+        throw new Error("[squide] Cannot retrieve the app router store from a runtime scope instance.");
+    }
     get honeycombInstrumentationClient() {
         throw new Error("[squide] Cannot retrieve the Honeycomb instrumentation client from a runtime scope instance.");
     }

package/dist/FireflyRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"FireflyRuntime.js","sources":["../src/FireflyRuntime.tsx"],"sourcesContent":["import type { RegisterRouteOptions, RuntimeMethodOptions, RuntimeOptions } from \"@squide/core\";\nimport { MswPlugin, MswPluginName, MswState } from \"@squide/msw\";\nimport { type IReactRouterRuntime, ReactRouterRuntime, ReactRouterRuntimeScope, type Route } from \"@squide/react-router\";\nimport type { HoneycombInstrumentationPartialClient } from \"@workleap-telemetry/core\";\nimport type { Logger } from \"@workleap/logging\";\nimport type { RequestHandler } from \"msw\";\nimport { type AppRouterStore, createAppRouterStore } from \"./AppRouterStore.ts\";\n\nexport interface FireflyRuntimeOptions<TRuntime extends FireflyRuntime = FireflyRuntime> extends RuntimeOptions<TRuntime> {\n    honeycombInstrumentationClient?: HoneycombInstrumentationPartialClient;\n}\n\nexport interface RegisterRequestHandlersOptions extends RuntimeMethodOptions {}\n\nexport interface IFireflyRuntime extends IReactRouterRuntime {\n    getMswState(): MswState;\n    registerRequestHandlers: (handlers: RequestHandler[]) => void;\n    get requestHandlers(): RequestHandler[];\n    get appRouterStore(): AppRouterStore;\n    get isMswEnabled(): boolean;\n    get honeycombInstrumentationClient(): HoneycombInstrumentationPartialClient | undefined;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport class FireflyRuntime<TRuntime extends FireflyRuntime = any> extends ReactRouterRuntime<TRuntime> implements IFireflyRuntime {\n    protected _appRouterStore: AppRouterStore;\n    protected _honeycombInstrumentationClient: HoneycombInstrumentationPartialClient | undefined;\n\n    constructor({ honeycombInstrumentationClient, ...options }: FireflyRuntimeOptions = {}) {\n        super(options);\n\n        this._appRouterStore = createAppRouterStore(this._logger);\n        this._honeycombInstrumentationClient = honeycombInstrumentationClient;\n    }\n\n    getMswState() {\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        return mswPlugin.mswState;\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 (this.moduleManager.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 (this.moduleManager.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._plugins.some(x => x.name === MswPluginName);\n    }\n\n    get honeycombInstrumentationClient() {\n        return this._honeycombInstrumentationClient;\n    }\n\n    startScope(logger: Logger): TRuntime {\n        return (new FireflyRuntimeScope(this, logger) as unknown) as TRuntime;\n    }\n}\n\nexport class FireflyRuntimeScope<TRuntime extends FireflyRuntime = FireflyRuntime> extends ReactRouterRuntimeScope<TRuntime> implements IFireflyRuntime {\n    getMswState() {\n        return this._runtime.getMswState();\n    }\n\n    registerRequestHandlers(handlers: RequestHandler[], options: RegisterRequestHandlersOptions = {}) {\n        this._runtime.registerRequestHandlers(handlers, {\n            ...options,\n            logger: this._getLogger(options)\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        return this._runtime.requestHandlers;\n    }\n\n    get appRouterStore(): AppRouterStore {\n        throw new Error(\"[squide] Cannot retrieve the app router store from a runtime scope instance.\");\n    }\n\n    get isMswEnabled() {\n        return this._runtime.isMswEnabled;\n    }\n\n    get honeycombInstrumentationClient(): HoneycombInstrumentationPartialClient {\n        throw new Error(\"[squide] Cannot retrieve the Honeycomb instrumentation client from a runtime scope instance.\");\n    }\n}\n"],"names":["MswPluginName","ReactRouterRuntime","ReactRouterRuntimeScope","createAppRouterStore","FireflyRuntime","honeycombInstrumentationClient","options","mswPlugin","Error","handlers","logger","route","x","FireflyRuntimeScope"],"mappings":";;;;;;;;;;;AACiE;AACwD;AAIzC;AAiBhF,8DAA8D;AACvD,MAAMI,uBAA8DH,kBAAkBA;IAC/E,gBAAgC;IAChC,gCAAmF;IAE7F,YAAY,EAAEI,8BAA8B,EAAE,GAAGC,SAAgC,GAAG,CAAC,CAAC,CAAE;QACpF,KAAK,CAACA;QAEN,IAAI,CAAC,eAAe,GAAGH,oBAAoBA,CAAC,IAAI,CAAC,OAAO;QACxD,IAAI,CAAC,+BAA+B,GAAGE;IAC3C;IAEA,cAAc;QACV,MAAME,YAAY,IAAI,CAAC,SAAS,CAACP,aAAaA;QAE9C,IAAI,CAACO,WAAW;YACZ,MAAM,IAAIC,MAAM;QACpB;QAEA,OAAOD,UAAU,QAAQ;IAC7B;IAEA,wBAAwBE,QAA0B,EAAEH,UAA0C,CAAC,CAAC,EAAE;QAC9F,MAAMI,SAAS,IAAI,CAAC,UAAU,CAACJ;QAC/B,MAAMC,YAAY,IAAI,CAAC,SAAS,CAACP,aAAaA;QAE9C,IAAI,CAACO,WAAW;YACZ,MAAM,IAAIC,MAAM;QACpB;QAEA,IAAI,IAAI,CAAC,aAAa,CAAC,uBAAuB,IAAI;YAC9C,MAAM,IAAIA,MAAM;QACpB;QAEAD,UAAU,uBAAuB,CAACE,UAAU;YACxCC;QACJ;IACJ;IAEA,8HAA8H;IAC9H,IAAI,kBAAoC;QACpC,MAAMH,YAAY,IAAI,CAAC,SAAS,CAACP,aAAaA;QAE9C,IAAI,CAACO,WAAW;YACZ,MAAM,IAAIC,MAAM;QACpB;QAEA,OAAOD,UAAU,eAAe;IACpC;IAEA,cAAcI,KAAY,EAAEL,UAAgC,CAAC,CAAC,EAAE;QAC5D,IAAI,IAAI,CAAC,aAAa,CAAC,uBAAuB,IAAI;YAC9C,MAAM,IAAIE,MAAM;QACpB;QAEA,KAAK,CAAC,cAAcG,OAAOL;IAC/B;IAEA,IAAI,iBAAiB;QACjB,OAAO,IAAI,CAAC,eAAe;IAC/B;IAEA,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAACM,CAAAA,IAAKA,EAAE,IAAI,KAAKZ,aAAaA;IAC3D;IAEA,IAAI,iCAAiC;QACjC,OAAO,IAAI,CAAC,+BAA+B;IAC/C;IAEA,WAAWU,MAAc,EAAY;QACjC,OAAQ,IAAIG,oBAAoB,IAAI,EAAEH;IAC1C;AACJ;AAEO,MAAMG,4BAA8EX,uBAAuBA;IAC9G,cAAc;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW;IACpC;IAEA,wBAAwBO,QAA0B,EAAEH,UAA0C,CAAC,CAAC,EAAE;QAC9F,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAACG,UAAU;YAC5C,GAAGH,OAAO;YACV,QAAQ,IAAI,CAAC,UAAU,CAACA;QAC5B;IACJ;IAEA,8HAA8H;IAC9H,IAAI,kBAAoC;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe;IACxC;IAEA,IAAI,iBAAiC;QACjC,MAAM,IAAIE,MAAM;IACpB;IAEA,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY;IACrC;IAEA,IAAI,iCAAwE;QACxE,MAAM,IAAIA,MAAM;IACpB;AACJ"}
+{"version":3,"file":"FireflyRuntime.js","sources":["../src/FireflyRuntime.tsx"],"sourcesContent":["import type { RegisterRouteOptions, RuntimeMethodOptions, RuntimeOptions } from \"@squide/core\";\nimport { EnvironmentVariableKey, EnvironmentVariables, EnvironmentVariableValue, getEnvironmentVariablesPlugin } from \"@squide/env-vars\";\nimport { getMswPlugin, MswPluginName, MswState } from \"@squide/msw\";\nimport { type IReactRouterRuntime, ReactRouterRuntime, ReactRouterRuntimeScope, type Route } from \"@squide/react-router\";\nimport type { HoneycombInstrumentationPartialClient } from \"@workleap-telemetry/core\";\nimport type { Logger } from \"@workleap/logging\";\nimport type { RequestHandler } from \"msw\";\nimport { type AppRouterStore, createAppRouterStore } from \"./AppRouterStore.ts\";\n\nexport interface FireflyRuntimeOptions<TRuntime extends FireflyRuntime = FireflyRuntime> extends RuntimeOptions<TRuntime> {\n    honeycombInstrumentationClient?: HoneycombInstrumentationPartialClient;\n}\n\nexport interface RegisterRequestHandlersOptions extends RuntimeMethodOptions {}\n\nexport interface IFireflyRuntime extends IReactRouterRuntime {\n    getMswState(): MswState;\n    registerRequestHandlers: (handlers: RequestHandler[]) => void;\n    get requestHandlers(): RequestHandler[];\n    get isMswEnabled(): boolean;\n    registerEnvironmentVariable(key: EnvironmentVariableKey, value: EnvironmentVariableValue): void;\n    registerEnvironmentVariables(variables: Partial<EnvironmentVariables>): void;\n    getEnvironmentVariable(key: EnvironmentVariableKey): EnvironmentVariableValue;\n    getEnvironmentVariables(): EnvironmentVariables;\n    get appRouterStore(): AppRouterStore;\n    get honeycombInstrumentationClient(): HoneycombInstrumentationPartialClient | undefined;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport class FireflyRuntime<TRuntime extends FireflyRuntime = any> extends ReactRouterRuntime<TRuntime> implements IFireflyRuntime {\n    protected _appRouterStore: AppRouterStore;\n    protected _honeycombInstrumentationClient: HoneycombInstrumentationPartialClient | undefined;\n\n    constructor(options: FireflyRuntimeOptions = {}) {\n        const {\n            honeycombInstrumentationClient\n        } = options;\n\n        super(options);\n\n        this._appRouterStore = createAppRouterStore(this._logger);\n        this._honeycombInstrumentationClient = honeycombInstrumentationClient;\n    }\n\n    registerRoute(route: Route, options: RegisterRouteOptions = {}) {\n        if (this.moduleManager.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    getMswState() {\n        const plugin = getMswPlugin(this);\n\n        return plugin.mswState;\n    }\n\n    registerRequestHandlers(handlers: RequestHandler[], options: RegisterRequestHandlersOptions = {}) {\n        const logger = this._getLogger(options);\n        const plugin = getMswPlugin(this);\n\n        if (this.moduleManager.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        plugin.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 plugin = getMswPlugin(this);\n\n        return plugin.requestHandlers;\n    }\n\n    get isMswEnabled() {\n        return this._plugins.some(x => x.name === MswPluginName);\n    }\n\n    getEnvironmentVariable(key: EnvironmentVariableKey) {\n        const plugin = getEnvironmentVariablesPlugin(this);\n\n        return plugin.getVariable(key);\n    }\n\n    getEnvironmentVariables() {\n        const plugin = getEnvironmentVariablesPlugin(this);\n\n        return plugin.getVariables();\n    }\n\n    registerEnvironmentVariable(key: EnvironmentVariableKey, value: EnvironmentVariableValue) {\n        const plugin = getEnvironmentVariablesPlugin(this);\n\n        return plugin.registerVariable(key, value);\n    }\n\n    registerEnvironmentVariables(variables: Partial<EnvironmentVariables>) {\n        const plugin = getEnvironmentVariablesPlugin(this);\n\n        return plugin.registerVariables(variables);\n    }\n\n    get appRouterStore() {\n        return this._appRouterStore;\n    }\n\n    get honeycombInstrumentationClient() {\n        return this._honeycombInstrumentationClient;\n    }\n\n    startScope(logger: Logger): TRuntime {\n        return (new FireflyRuntimeScope(this, logger) as unknown) as TRuntime;\n    }\n}\n\nexport class FireflyRuntimeScope<TRuntime extends FireflyRuntime = FireflyRuntime> extends ReactRouterRuntimeScope<TRuntime> implements IFireflyRuntime {\n    getMswState() {\n        return this._runtime.getMswState();\n    }\n\n    registerRequestHandlers(handlers: RequestHandler[], options: RegisterRequestHandlersOptions = {}) {\n        this._runtime.registerRequestHandlers(handlers, {\n            ...options,\n            logger: this._getLogger(options)\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        return this._runtime.requestHandlers;\n    }\n\n    get isMswEnabled() {\n        return this._runtime.isMswEnabled;\n    }\n\n    getEnvironmentVariables() {\n        return this._runtime.getEnvironmentVariables();\n    }\n\n    getEnvironmentVariable(key: EnvironmentVariableKey) {\n        return this._runtime.getEnvironmentVariable(key);\n    }\n\n    registerEnvironmentVariable(key: EnvironmentVariableKey, value: EnvironmentVariableValue) {\n        this._runtime.registerEnvironmentVariable(key, value);\n    }\n\n    registerEnvironmentVariables(variables: Partial<EnvironmentVariables>) {\n        this._runtime.registerEnvironmentVariables(variables);\n    }\n\n    get appRouterStore(): AppRouterStore {\n        throw new Error(\"[squide] Cannot retrieve the app router store from a runtime scope instance.\");\n    }\n\n    get honeycombInstrumentationClient(): HoneycombInstrumentationPartialClient {\n        throw new Error(\"[squide] Cannot retrieve the Honeycomb instrumentation client from a runtime scope instance.\");\n    }\n}\n"],"names":["getEnvironmentVariablesPlugin","getMswPlugin","MswPluginName","ReactRouterRuntime","ReactRouterRuntimeScope","createAppRouterStore","FireflyRuntime","options","honeycombInstrumentationClient","route","Error","plugin","handlers","logger","x","key","value","variables","FireflyRuntimeScope"],"mappings":";;;;;;;;;;;;;;AACyI;AACrE;AACqD;AAIzC;AAqBhF,8DAA8D;AACvD,MAAMM,uBAA8DH,kBAAkBA;IAC/E,gBAAgC;IAChC,gCAAmF;IAE7F,YAAYI,UAAiC,CAAC,CAAC,CAAE;QAC7C,MAAM,EACFC,8BAA8B,EACjC,GAAGD;QAEJ,KAAK,CAACA;QAEN,IAAI,CAAC,eAAe,GAAGF,oBAAoBA,CAAC,IAAI,CAAC,OAAO;QACxD,IAAI,CAAC,+BAA+B,GAAGG;IAC3C;IAEA,cAAcC,KAAY,EAAEF,UAAgC,CAAC,CAAC,EAAE;QAC5D,IAAI,IAAI,CAAC,aAAa,CAAC,uBAAuB,IAAI;YAC9C,MAAM,IAAIG,MAAM;QACpB;QAEA,KAAK,CAAC,cAAcD,OAAOF;IAC/B;IAEA,cAAc;QACV,MAAMI,SAASV,YAAYA,CAAC,IAAI;QAEhC,OAAOU,OAAO,QAAQ;IAC1B;IAEA,wBAAwBC,QAA0B,EAAEL,UAA0C,CAAC,CAAC,EAAE;QAC9F,MAAMM,SAAS,IAAI,CAAC,UAAU,CAACN;QAC/B,MAAMI,SAASV,YAAYA,CAAC,IAAI;QAEhC,IAAI,IAAI,CAAC,aAAa,CAAC,uBAAuB,IAAI;YAC9C,MAAM,IAAIS,MAAM;QACpB;QAEAC,OAAO,uBAAuB,CAACC,UAAU;YACrCC;QACJ;IACJ;IAEA,8HAA8H;IAC9H,IAAI,kBAAoC;QACpC,MAAMF,SAASV,YAAYA,CAAC,IAAI;QAEhC,OAAOU,OAAO,eAAe;IACjC;IAEA,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAACG,CAAAA,IAAKA,EAAE,IAAI,KAAKZ,aAAaA;IAC3D;IAEA,uBAAuBa,GAA2B,EAAE;QAChD,MAAMJ,SAASX,6BAA6BA,CAAC,IAAI;QAEjD,OAAOW,OAAO,WAAW,CAACI;IAC9B;IAEA,0BAA0B;QACtB,MAAMJ,SAASX,6BAA6BA,CAAC,IAAI;QAEjD,OAAOW,OAAO,YAAY;IAC9B;IAEA,4BAA4BI,GAA2B,EAAEC,KAA+B,EAAE;QACtF,MAAML,SAASX,6BAA6BA,CAAC,IAAI;QAEjD,OAAOW,OAAO,gBAAgB,CAACI,KAAKC;IACxC;IAEA,6BAA6BC,SAAwC,EAAE;QACnE,MAAMN,SAASX,6BAA6BA,CAAC,IAAI;QAEjD,OAAOW,OAAO,iBAAiB,CAACM;IACpC;IAEA,IAAI,iBAAiB;QACjB,OAAO,IAAI,CAAC,eAAe;IAC/B;IAEA,IAAI,iCAAiC;QACjC,OAAO,IAAI,CAAC,+BAA+B;IAC/C;IAEA,WAAWJ,MAAc,EAAY;QACjC,OAAQ,IAAIK,oBAAoB,IAAI,EAAEL;IAC1C;AACJ;AAEO,MAAMK,4BAA8Ed,uBAAuBA;IAC9G,cAAc;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW;IACpC;IAEA,wBAAwBQ,QAA0B,EAAEL,UAA0C,CAAC,CAAC,EAAE;QAC9F,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAACK,UAAU;YAC5C,GAAGL,OAAO;YACV,QAAQ,IAAI,CAAC,UAAU,CAACA;QAC5B;IACJ;IAEA,8HAA8H;IAC9H,IAAI,kBAAoC;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe;IACxC;IAEA,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY;IACrC;IAEA,0BAA0B;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,uBAAuB;IAChD;IAEA,uBAAuBQ,GAA2B,EAAE;QAChD,OAAO,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAACA;IAChD;IAEA,4BAA4BA,GAA2B,EAAEC,KAA+B,EAAE;QACtF,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAACD,KAAKC;IACnD;IAEA,6BAA6BC,SAAwC,EAAE;QACnE,IAAI,CAAC,QAAQ,CAAC,4BAA4B,CAACA;IAC/C;IAEA,IAAI,iBAAiC;QACjC,MAAM,IAAIP,MAAM;IACpB;IAEA,IAAI,iCAAwE;QACxE,MAAM,IAAIA,MAAM;IACpB;AACJ"}

package/dist/RootRoute.d.ts

@@ -1 +1,4 @@
-export declare function RootRoute(): import("react/jsx-runtime").JSX.Element;
+export interface RootRouteProps {
+    strictMode?: boolean;
+}
+export declare function RootRoute(props: RootRouteProps): import("react/jsx-runtime").JSX.Element;

package/dist/RootRoute.js

@@ -20,9 +20,12 @@ import { useIsActiveRouteProtected } from "./useIsActiveRouteProtected.js";
 
 
 
-function RootRoute() {
+function RootRoute(props) {
+    const { strictMode = true } = props;
     const state = useAppRouterState();
-    const isActiveRouteProtected = useIsActiveRouteProtected(state.areModulesReady);
+    const isActiveRouteProtected = useIsActiveRouteProtected(state.areModulesReady, {
+        throwWhenThereIsNoMatch: strictMode
+    });
     const dispatch = useAppRouterDispatcher();
     useEffect(()=>{
         // Dispatching the active route visibility must be done in a route because React Router's useLocation

package/dist/RootRoute.js.map

@@ -1 +1 @@
-{"version":3,"file":"RootRoute.js","sources":["../src/RootRoute.tsx"],"sourcesContent":["import { useEffect } from \"react\";\nimport { Outlet } from \"react-router\";\nimport { useAppRouterDispatcher, useAppRouterState } from \"./AppRouterContext.ts\";\nimport { useIsActiveRouteProtected } from \"./useIsActiveRouteProtected.ts\";\n\nexport function RootRoute() {\n    const state = useAppRouterState();\n    const isActiveRouteProtected = useIsActiveRouteProtected(state.areModulesReady);\n\n    const dispatch = useAppRouterDispatcher();\n\n    useEffect(() => {\n        // Dispatching the active route visibility must be done in a route because React Router's useLocation\n        // hook throws if it's not called from a child of the router component.\n        if (isActiveRouteProtected) {\n            dispatch({ type: \"active-route-is-protected\" });\n        } else {\n            dispatch({ type: \"active-route-is-public\" });\n        }\n    }, [isActiveRouteProtected, dispatch]);\n\n    return (\n        <Outlet />\n    );\n}\n"],"names":["useEffect","Outlet","useAppRouterDispatcher","useAppRouterState","useIsActiveRouteProtected","RootRoute","state","isActiveRouteProtected","dispatch"],"mappings":";;;;;;;;;;;;;;;;;;AAAkC;AACI;AAC4C;AACP;AAEpE,SAASK;IACZ,MAAMC,QAAQH,iBAAiBA;IAC/B,MAAMI,yBAAyBH,yBAAyBA,CAACE,MAAM,eAAe;IAE9E,MAAME,WAAWN,sBAAsBA;IAEvCF,SAASA,CAAC;QACN,qGAAqG;QACrG,uEAAuE;QACvE,IAAIO,wBAAwB;YACxBC,SAAS;gBAAE,MAAM;YAA4B;QACjD,OAAO;YACHA,SAAS;gBAAE,MAAM;YAAyB;QAC9C;IACJ,GAAG;QAACD;QAAwBC;KAAS;IAErC,qBACI,IAACP,MAAMA;AAEf"}
+{"version":3,"file":"RootRoute.js","sources":["../src/RootRoute.tsx"],"sourcesContent":["import { useEffect } from \"react\";\nimport { Outlet } from \"react-router\";\nimport { useAppRouterDispatcher, useAppRouterState } from \"./AppRouterContext.ts\";\nimport { useIsActiveRouteProtected } from \"./useIsActiveRouteProtected.ts\";\n\nexport interface RootRouteProps {\n    strictMode?: boolean;\n}\n\nexport function RootRoute(props: RootRouteProps) {\n    const {\n        strictMode = true\n    } = props;\n\n    const state = useAppRouterState();\n\n    const isActiveRouteProtected = useIsActiveRouteProtected(state.areModulesReady, {\n        throwWhenThereIsNoMatch: strictMode\n    });\n\n    const dispatch = useAppRouterDispatcher();\n\n    useEffect(() => {\n        // Dispatching the active route visibility must be done in a route because React Router's useLocation\n        // hook throws if it's not called from a child of the router component.\n        if (isActiveRouteProtected) {\n            dispatch({ type: \"active-route-is-protected\" });\n        } else {\n            dispatch({ type: \"active-route-is-public\" });\n        }\n    }, [isActiveRouteProtected, dispatch]);\n\n    return (\n        <Outlet />\n    );\n}\n"],"names":["useEffect","Outlet","useAppRouterDispatcher","useAppRouterState","useIsActiveRouteProtected","RootRoute","props","strictMode","state","isActiveRouteProtected","dispatch"],"mappings":";;;;;;;;;;;;;;;;;;AAAkC;AACI;AAC4C;AACP;AAMpE,SAASK,UAAUC,KAAqB;IAC3C,MAAM,EACFC,aAAa,IAAI,EACpB,GAAGD;IAEJ,MAAME,QAAQL,iBAAiBA;IAE/B,MAAMM,yBAAyBL,yBAAyBA,CAACI,MAAM,eAAe,EAAE;QAC5E,yBAAyBD;IAC7B;IAEA,MAAMG,WAAWR,sBAAsBA;IAEvCF,SAASA,CAAC;QACN,qGAAqG;QACrG,uEAAuE;QACvE,IAAIS,wBAAwB;YACxBC,SAAS;gBAAE,MAAM;YAA4B;QACjD,OAAO;YACHA,SAAS;gBAAE,MAAM;YAAyB;QAC9C;IACJ,GAAG;QAACD;QAAwBC;KAAS;IAErC,qBACI,IAACT,MAAMA;AAEf"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from "@squide/core";
-export * from "@squide/msw";
+export { EnvironmentVariablesPlugin, EnvironmentVariablesPluginName, getEnvironmentVariablesPlugin, useEnvironmentVariable, useEnvironmentVariables, type EnvironmentVariableKey, type EnvironmentVariables, type EnvironmentVariablesPluginOptions, type EnvironmentVariableValue } from "@squide/env-vars";
+export { getMswPlugin, MswPlugin, MswPluginName, MswState, type MswPluginOptions, type MswPluginRegisterRequestHandlersOptions, type MswReadyListener, type MswStateOptions } from "@squide/msw";
 export * from "@squide/react-router";
 export type { FireflyPlugin } from "./FireflyPlugin.ts";
 export * from "./FireflyProvider.tsx";

package/dist/index.js

@@ -1,6 +1,7 @@
+import { EnvironmentVariablesPlugin, EnvironmentVariablesPluginName, getEnvironmentVariablesPlugin, useEnvironmentVariable, useEnvironmentVariables } from "@squide/env-vars";
+import { MswPlugin, MswPluginName, MswState, getMswPlugin } from "@squide/msw";
 import { ActiveRouteIsProtectedEvent, ActiveRouteIsPublicEvent, ApplicationBoostrappedEvent, DeferredRegistrationsUpdatedEvent, ModulesReadyEvent, ModulesRegisteredEvent, MswReadyEvent, ProtectedDataReadyEvent, ProtectedDataUpdatedEvent, PublicDataReadyEvent, PublicDataUpdatedEvent } from "./AppRouterReducer.js";
 export * from "@squide/core";
-export * from "@squide/msw";
 export * from "@squide/react-router";
 export * from "./FireflyProvider.js";
 export * from "./FireflyRuntime.js";
@@ -24,6 +25,10 @@ export * from "./useStrictRegistrationMode.js";
 export * from "./useUpdateDeferredRegistrations.js";
 export * from "./initializeFirefly.js";
 
+;// CONCATENATED MODULE: external "@squide/env-vars"
+
+;// CONCATENATED MODULE: external "@squide/msw"
+
 ;// CONCATENATED MODULE: external "./AppRouterReducer.js"
 
 ;// CONCATENATED MODULE: ./src/index.ts
@@ -53,6 +58,7 @@ export * from "./initializeFirefly.js";
 
 
 
-export { ActiveRouteIsProtectedEvent, ActiveRouteIsPublicEvent, ApplicationBoostrappedEvent, DeferredRegistrationsUpdatedEvent, ModulesReadyEvent, ModulesRegisteredEvent, MswReadyEvent, ProtectedDataReadyEvent, ProtectedDataUpdatedEvent, PublicDataReadyEvent, PublicDataUpdatedEvent };
+
+export { ActiveRouteIsProtectedEvent, ActiveRouteIsPublicEvent, ApplicationBoostrappedEvent, DeferredRegistrationsUpdatedEvent, EnvironmentVariablesPlugin, EnvironmentVariablesPluginName, ModulesReadyEvent, ModulesRegisteredEvent, MswPlugin, MswPluginName, MswReadyEvent, MswState, ProtectedDataReadyEvent, ProtectedDataUpdatedEvent, PublicDataReadyEvent, PublicDataUpdatedEvent, getEnvironmentVariablesPlugin, getMswPlugin, useEnvironmentVariable, useEnvironmentVariables };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["export * from \"@squide/core\";\nexport * from \"@squide/msw\";\nexport * from \"@squide/react-router\";\n\nexport type { FireflyPlugin } from \"./FireflyPlugin.ts\";\nexport * from \"./FireflyProvider.tsx\";\nexport * from \"./FireflyRuntime.tsx\";\n\nexport * from \"./AppRouter.tsx\";\nexport {\n    ActiveRouteIsProtectedEvent,\n    ActiveRouteIsPublicEvent,\n    ApplicationBoostrappedEvent,\n    DeferredRegistrationsUpdatedEvent,\n    ModulesReadyEvent,\n    ModulesRegisteredEvent,\n    MswReadyEvent,\n    ProtectedDataReadyEvent,\n    ProtectedDataUpdatedEvent,\n    PublicDataReadyEvent,\n    PublicDataUpdatedEvent\n} from \"./AppRouterReducer.ts\";\n\nexport * from \"./AppRouterStore.ts\";\nexport * from \"./GlobalDataQueriesError.ts\";\nexport * from \"./useCanFetchProtectedData.ts\";\nexport * from \"./useCanFetchPublicData.ts\";\nexport * from \"./useCanRegisterDeferredRegistrations.ts\";\nexport * from \"./useCanUpdateDeferredRegistrations.ts\";\nexport * from \"./useDeferredRegistrations.ts\";\nexport * from \"./useIsActiveRouteProtected.ts\";\nexport * from \"./useIsBootstrapping.ts\";\nexport * from \"./useNavigationItems.ts\";\nexport * from \"./useProtectedDataHandler.ts\";\nexport * from \"./useProtectedDataQueries.ts\";\nexport * from \"./usePublicDataHandler.ts\";\nexport * from \"./usePublicDataQueries.ts\";\nexport * from \"./useRegisterDeferredRegistrations.ts\";\nexport * from \"./useStrictRegistrationMode.ts\";\nexport * from \"./useUpdateDeferredRegistrations.ts\";\n\nexport * from \"./initializeFirefly.ts\";\n\n"],"names":["ActiveRouteIsProtectedEvent","ActiveRouteIsPublicEvent","ApplicationBoostrappedEvent","DeferredRegistrationsUpdatedEvent","ModulesReadyEvent","ModulesRegisteredEvent","MswReadyEvent","ProtectedDataReadyEvent","ProtectedDataUpdatedEvent","PublicDataReadyEvent","PublicDataUpdatedEvent"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAA6B;AACD;AACS;AAGC;AACD;AAEL;AAaD;AAEK;AACQ;AACE;AACH;AACc;AACF;AACT;AACC;AACP;AACA;AACK;AACA;AACH;AACA;AACY;AACP;AACK;AAEb"}
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["export * from \"@squide/core\";\nexport {\n    EnvironmentVariablesPlugin,\n    EnvironmentVariablesPluginName,\n    getEnvironmentVariablesPlugin,\n    useEnvironmentVariable,\n    useEnvironmentVariables,\n    type EnvironmentVariableKey,\n    type EnvironmentVariables,\n    type EnvironmentVariablesPluginOptions,\n    type EnvironmentVariableValue\n} from \"@squide/env-vars\";\nexport {\n    getMswPlugin,\n    MswPlugin,\n    MswPluginName,\n    MswState,\n    type MswPluginOptions,\n    type MswPluginRegisterRequestHandlersOptions,\n    type MswReadyListener,\n    type MswStateOptions\n} from \"@squide/msw\";\nexport * from \"@squide/react-router\";\n\nexport type { FireflyPlugin } from \"./FireflyPlugin.ts\";\nexport * from \"./FireflyProvider.tsx\";\nexport * from \"./FireflyRuntime.tsx\";\n\nexport * from \"./AppRouter.tsx\";\nexport {\n    ActiveRouteIsProtectedEvent,\n    ActiveRouteIsPublicEvent,\n    ApplicationBoostrappedEvent,\n    DeferredRegistrationsUpdatedEvent,\n    ModulesReadyEvent,\n    ModulesRegisteredEvent,\n    MswReadyEvent,\n    ProtectedDataReadyEvent,\n    ProtectedDataUpdatedEvent,\n    PublicDataReadyEvent,\n    PublicDataUpdatedEvent\n} from \"./AppRouterReducer.ts\";\n\nexport * from \"./AppRouterStore.ts\";\nexport * from \"./GlobalDataQueriesError.ts\";\nexport * from \"./useCanFetchProtectedData.ts\";\nexport * from \"./useCanFetchPublicData.ts\";\nexport * from \"./useCanRegisterDeferredRegistrations.ts\";\nexport * from \"./useCanUpdateDeferredRegistrations.ts\";\nexport * from \"./useDeferredRegistrations.ts\";\nexport * from \"./useIsActiveRouteProtected.ts\";\nexport * from \"./useIsBootstrapping.ts\";\nexport * from \"./useNavigationItems.ts\";\nexport * from \"./useProtectedDataHandler.ts\";\nexport * from \"./useProtectedDataQueries.ts\";\nexport * from \"./usePublicDataHandler.ts\";\nexport * from \"./usePublicDataQueries.ts\";\nexport * from \"./useRegisterDeferredRegistrations.ts\";\nexport * from \"./useStrictRegistrationMode.ts\";\nexport * from \"./useUpdateDeferredRegistrations.ts\";\n\nexport * from \"./initializeFirefly.ts\";\n\n"],"names":["EnvironmentVariablesPlugin","EnvironmentVariablesPluginName","getEnvironmentVariablesPlugin","useEnvironmentVariable","useEnvironmentVariables","getMswPlugin","MswPlugin","MswPluginName","MswState","ActiveRouteIsProtectedEvent","ActiveRouteIsPublicEvent","ApplicationBoostrappedEvent","DeferredRegistrationsUpdatedEvent","ModulesReadyEvent","ModulesRegisteredEvent","MswReadyEvent","ProtectedDataReadyEvent","ProtectedDataUpdatedEvent","PublicDataReadyEvent","PublicDataUpdatedEvent"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAA6B;AAWH;AAUL;AACgB;AAGC;AACD;AAEL;AAaD;AAEK;AACQ;AACE;AACH;AACc;AACF;AACT;AACC;AACP;AACA;AACK;AACA;AACH;AACA;AACY;AACP;AACK;AAEb"}

package/dist/initializeFirefly.d.ts

@@ -1,4 +1,5 @@
 import { ModuleDefinition, type ModuleRegisterFunction, type RegisterModulesOptions } from "@squide/core";
+import { EnvironmentVariables } from "@squide/env-vars";
 import type { HoneycombInstrumentationPartialClient } from "@workleap-telemetry/core";
 import { FireflyRuntime, type FireflyRuntimeOptions } from "./FireflyRuntime.tsx";
 export declare const ApplicationBootstrappingStartedEvent = "squide-app-bootstrapping-started";
@@ -8,6 +9,7 @@ export interface InitializeFireflyOptions<TRuntime extends FireflyRuntime, TCont
     localModules?: ModuleRegisterFunction<TRuntime, TContext, TData>[];
     moduleDefinitions?: ModuleDefinition<TRuntime, TContext, TData>[];
     useMsw?: boolean;
+    environmentVariables?: Partial<EnvironmentVariables>;
     honeycombInstrumentationClient?: HoneycombInstrumentationPartialClient;
     startMsw?: StartMswFunction<FireflyRuntime>;
     onError?: OnInitializationErrorFunction;

package/dist/initializeFirefly.js

@@ -1,10 +1,13 @@
 import { isFunction, toLocalModuleDefinitions } from "@squide/core";
+import { EnvironmentVariablesPlugin } from "@squide/env-vars";
 import { MswPlugin } from "@squide/msw";
 import { FireflyRuntime } from "./FireflyRuntime.js";
 import { initializeHoneycomb } from "./honeycomb/initializeHoneycomb.js";
 
 ;// CONCATENATED MODULE: external "@squide/core"
 
+;// CONCATENATED MODULE: external "@squide/env-vars"
+
 ;// CONCATENATED MODULE: external "@squide/msw"
 
 ;// CONCATENATED MODULE: external "./FireflyRuntime.js"
@@ -16,6 +19,7 @@ import { initializeHoneycomb } from "./honeycomb/initializeHoneycomb.js";
 
 
 
+
 const ApplicationBootstrappingStartedEvent = "squide-app-bootstrapping-started";
 function bootstrap(runtime, modulesDefinitions, options = {}) {
     const { startMsw, onError, context } = options;
@@ -48,7 +52,7 @@ function __resetHasExecutedGuard() {
     hasExecuted = false;
 }
 function initializeFirefly(options = {}) {
-    const { mode, localModules = [], moduleDefinitions = [], useMsw, plugins = [], honeycombInstrumentationClient, loggers, onError } = options;
+    const { mode, localModules = [], moduleDefinitions = [], useMsw, plugins = [], environmentVariables, honeycombInstrumentationClient, loggers, onError } = options;
     if (hasExecuted) {
         throw new Error("[squide] A squide application can only be initialized once. Did you call the \"initializeSquide\" function twice?");
     }
@@ -60,7 +64,12 @@ function initializeFirefly(options = {}) {
         mode,
         honeycombInstrumentationClient,
         loggers,
-        plugins
+        plugins: [
+            (x)=>new EnvironmentVariablesPlugin(x, {
+                    variables: environmentVariables
+                }),
+            ...plugins
+        ]
     });
     initializeHoneycomb(runtime).catch((error)=>{
         if (onError) {

package/dist/initializeFirefly.js.map

@@ -1 +1 @@
-{"version":3,"file":"initializeFirefly.js","sources":["../src/initializeFirefly.ts"],"sourcesContent":["import { isFunction, ModuleDefinition, toLocalModuleDefinitions, type ModuleRegisterFunction, type RegisterModulesOptions } from \"@squide/core\";\nimport { MswPlugin } from \"@squide/msw\";\nimport type { HoneycombInstrumentationPartialClient } from \"@workleap-telemetry/core\";\nimport { FireflyRuntime, type FireflyRuntimeOptions } from \"./FireflyRuntime.tsx\";\nimport { initializeHoneycomb } from \"./honeycomb/initializeHoneycomb.ts\";\n\nexport const ApplicationBootstrappingStartedEvent = \"squide-app-bootstrapping-started\";\n\nexport type OnInitializationErrorFunction = (error: unknown) => void;\n\nexport type StartMswFunction<TRuntime = FireflyRuntime> = (runtime: TRuntime) => Promise<void>;\n\nexport interface InitializeFireflyOptions<TRuntime extends FireflyRuntime, TContext = unknown, TData = unknown> extends RegisterModulesOptions<TContext>, FireflyRuntimeOptions {\n    localModules?: ModuleRegisterFunction<TRuntime, TContext, TData>[];\n    moduleDefinitions?: ModuleDefinition<TRuntime, TContext, TData>[];\n    useMsw?: boolean;\n    honeycombInstrumentationClient?: HoneycombInstrumentationPartialClient;\n    startMsw?: StartMswFunction<FireflyRuntime>;\n    onError?: OnInitializationErrorFunction;\n}\n\nexport function bootstrap<TRuntime extends FireflyRuntime = FireflyRuntime, TContext = unknown, TData = unknown>(\n    runtime: TRuntime,\n    modulesDefinitions: ModuleDefinition<TRuntime, TContext, TData>[],\n    options: Omit<InitializeFireflyOptions<TRuntime, TContext, TData>, \"localModules\" | \"moduleDefinitions\"> = {}\n) {\n    const {\n        startMsw,\n        onError,\n        context\n    } = options;\n\n    runtime.eventBus.dispatch(ApplicationBootstrappingStartedEvent);\n\n    runtime.moduleManager.registerModules(modulesDefinitions, { context })\n        .then(results => {\n            if (runtime.isMswEnabled) {\n                if (!isFunction(startMsw)) {\n                    throw new Error(\"[squide] When MSW is enabled, the \\\"startMsw\\\" function must be provided.\");\n                }\n\n                startMsw(runtime)\n                    .then(() => {\n                        if (runtime.isMswEnabled) {\n                            runtime.getMswState().setAsReady();\n                        }\n                    })\n                    .catch((error: unknown) => {\n                        runtime.logger\n                            .withText(\"[squide] An error occured while starting MSW.\")\n                            .withError(error as Error)\n                            .error();\n                    });\n            }\n\n            if (onError) {\n                results.forEach(error => {\n                    onError(error);\n                });\n            }\n        });\n}\n\nlet hasExecuted = false;\n\n// Should only be used by tests.\nexport function __resetHasExecutedGuard() {\n    hasExecuted = false;\n}\n\nexport function initializeFirefly<TContext = unknown, TData = unknown>(options: InitializeFireflyOptions<FireflyRuntime, TContext, TData> = {}) {\n    const {\n        mode,\n        localModules = [],\n        moduleDefinitions = [],\n        useMsw,\n        plugins = [],\n        honeycombInstrumentationClient,\n        loggers,\n        onError\n    } = options;\n\n    if (hasExecuted) {\n        throw new Error(\"[squide] A squide application can only be initialized once. Did you call the \\\"initializeSquide\\\" function twice?\");\n    }\n\n    hasExecuted = true;\n\n    if (useMsw) {\n        plugins.push(x => new MswPlugin(x));\n    }\n\n    const runtime = new FireflyRuntime({\n        mode,\n        honeycombInstrumentationClient,\n        loggers,\n        plugins\n    });\n\n    initializeHoneycomb(runtime)\n        .catch((error: unknown) => {\n            if (onError) {\n                onError(error);\n            }\n        })\n        .finally(() => {\n            bootstrap(\n                runtime,\n                [...moduleDefinitions, ...toLocalModuleDefinitions(localModules)],\n                options\n            );\n        });\n\n    return runtime;\n}\n"],"names":["isFunction","toLocalModuleDefinitions","MswPlugin","FireflyRuntime","initializeHoneycomb","ApplicationBootstrappingStartedEvent","bootstrap","runtime","modulesDefinitions","options","startMsw","onError","context","results","Error","error","hasExecuted","__resetHasExecutedGuard","initializeFirefly","mode","localModules","moduleDefinitions","useMsw","plugins","honeycombInstrumentationClient","loggers","x"],"mappings":";;;;;;;;;;;;;;AAAgJ;AACxG;AAE0C;AACT;AAElE,MAAMK,uCAAuC,mCAAmC;AAehF,SAASC,UACZC,OAAiB,EACjBC,kBAAiE,EACjEC,UAA2G,CAAC,CAAC;IAE7G,MAAM,EACFC,QAAQ,EACRC,OAAO,EACPC,OAAO,EACV,GAAGH;IAEJF,QAAQ,QAAQ,CAAC,QAAQ,CAACF;IAE1BE,QAAQ,aAAa,CAAC,eAAe,CAACC,oBAAoB;QAAEI;IAAQ,GAC/D,IAAI,CAACC,CAAAA;QACF,IAAIN,QAAQ,YAAY,EAAE;YACtB,IAAI,CAACP,UAAUA,CAACU,WAAW;gBACvB,MAAM,IAAII,MAAM;YACpB;YAEAJ,SAASH,SACJ,IAAI,CAAC;gBACF,IAAIA,QAAQ,YAAY,EAAE;oBACtBA,QAAQ,WAAW,GAAG,UAAU;gBACpC;YACJ,GACC,KAAK,CAAC,CAACQ;gBACJR,QAAQ,MAAM,CACT,QAAQ,CAAC,iDACT,SAAS,CAACQ,OACV,KAAK;YACd;QACR;QAEA,IAAIJ,SAAS;YACTE,QAAQ,OAAO,CAACE,CAAAA;gBACZJ,QAAQI;YACZ;QACJ;IACJ;AACR;AAEA,IAAIC,cAAc;AAElB,gCAAgC;AACzB,SAASC;IACZD,cAAc;AAClB;AAEO,SAASE,kBAAuDT,UAAqE,CAAC,CAAC;IAC1I,MAAM,EACFU,IAAI,EACJC,eAAe,EAAE,EACjBC,oBAAoB,EAAE,EACtBC,MAAM,EACNC,UAAU,EAAE,EACZC,8BAA8B,EAC9BC,OAAO,EACPd,OAAO,EACV,GAAGF;IAEJ,IAAIO,aAAa;QACb,MAAM,IAAIF,MAAM;IACpB;IAEAE,cAAc;IAEd,IAAIM,QAAQ;QACRC,QAAQ,IAAI,CAACG,CAAAA,IAAK,IAAIxB,SAASA,CAACwB;IACpC;IAEA,MAAMnB,UAAU,IAAIJ,cAAcA,CAAC;QAC/BgB;QACAK;QACAC;QACAF;IACJ;IAEAnB,mBAAmBA,CAACG,SACf,KAAK,CAAC,CAACQ;QACJ,IAAIJ,SAAS;YACTA,QAAQI;QACZ;IACJ,GACC,OAAO,CAAC;QACLT,UACIC,SACA;eAAIc;eAAsBpB,wBAAwBA,CAACmB;SAAc,EACjEX;IAER;IAEJ,OAAOF;AACX"}
+{"version":3,"file":"initializeFirefly.js","sources":["../src/initializeFirefly.ts"],"sourcesContent":["import { isFunction, ModuleDefinition, toLocalModuleDefinitions, type ModuleRegisterFunction, type RegisterModulesOptions } from \"@squide/core\";\nimport { EnvironmentVariables, EnvironmentVariablesPlugin } from \"@squide/env-vars\";\nimport { MswPlugin } from \"@squide/msw\";\nimport type { HoneycombInstrumentationPartialClient } from \"@workleap-telemetry/core\";\nimport { FireflyRuntime, type FireflyRuntimeOptions } from \"./FireflyRuntime.tsx\";\nimport { initializeHoneycomb } from \"./honeycomb/initializeHoneycomb.ts\";\n\nexport const ApplicationBootstrappingStartedEvent = \"squide-app-bootstrapping-started\";\n\nexport type OnInitializationErrorFunction = (error: unknown) => void;\n\nexport type StartMswFunction<TRuntime = FireflyRuntime> = (runtime: TRuntime) => Promise<void>;\n\nexport interface InitializeFireflyOptions<TRuntime extends FireflyRuntime, TContext = unknown, TData = unknown> extends RegisterModulesOptions<TContext>, FireflyRuntimeOptions {\n    localModules?: ModuleRegisterFunction<TRuntime, TContext, TData>[];\n    moduleDefinitions?: ModuleDefinition<TRuntime, TContext, TData>[];\n    useMsw?: boolean;\n    environmentVariables?: Partial<EnvironmentVariables>;\n    honeycombInstrumentationClient?: HoneycombInstrumentationPartialClient;\n    startMsw?: StartMswFunction<FireflyRuntime>;\n    onError?: OnInitializationErrorFunction;\n}\n\nexport function bootstrap<TRuntime extends FireflyRuntime = FireflyRuntime, TContext = unknown, TData = unknown>(\n    runtime: TRuntime,\n    modulesDefinitions: ModuleDefinition<TRuntime, TContext, TData>[],\n    options: Omit<InitializeFireflyOptions<TRuntime, TContext, TData>, \"localModules\" | \"moduleDefinitions\"> = {}\n) {\n    const {\n        startMsw,\n        onError,\n        context\n    } = options;\n\n    runtime.eventBus.dispatch(ApplicationBootstrappingStartedEvent);\n\n    runtime.moduleManager.registerModules(modulesDefinitions, { context })\n        .then(results => {\n            if (runtime.isMswEnabled) {\n                if (!isFunction(startMsw)) {\n                    throw new Error(\"[squide] When MSW is enabled, the \\\"startMsw\\\" function must be provided.\");\n                }\n\n                startMsw(runtime)\n                    .then(() => {\n                        if (runtime.isMswEnabled) {\n                            runtime.getMswState().setAsReady();\n                        }\n                    })\n                    .catch((error: unknown) => {\n                        runtime.logger\n                            .withText(\"[squide] An error occured while starting MSW.\")\n                            .withError(error as Error)\n                            .error();\n                    });\n            }\n\n            if (onError) {\n                results.forEach(error => {\n                    onError(error);\n                });\n            }\n        });\n}\n\nlet hasExecuted = false;\n\n// Should only be used by tests.\nexport function __resetHasExecutedGuard() {\n    hasExecuted = false;\n}\n\nexport function initializeFirefly<TContext = unknown, TData = unknown>(options: InitializeFireflyOptions<FireflyRuntime, TContext, TData> = {}) {\n    const {\n        mode,\n        localModules = [],\n        moduleDefinitions = [],\n        useMsw,\n        plugins = [],\n        environmentVariables,\n        honeycombInstrumentationClient,\n        loggers,\n        onError\n    } = options;\n\n    if (hasExecuted) {\n        throw new Error(\"[squide] A squide application can only be initialized once. Did you call the \\\"initializeSquide\\\" function twice?\");\n    }\n\n    hasExecuted = true;\n\n    if (useMsw) {\n        plugins.push(x => new MswPlugin(x));\n    }\n\n    const runtime = new FireflyRuntime({\n        mode,\n        honeycombInstrumentationClient,\n        loggers,\n        plugins: [\n            x => new EnvironmentVariablesPlugin(x, {\n                variables: environmentVariables\n            }),\n            ...plugins\n        ]\n    });\n\n    initializeHoneycomb(runtime)\n        .catch((error: unknown) => {\n            if (onError) {\n                onError(error);\n            }\n        })\n        .finally(() => {\n            bootstrap(\n                runtime,\n                [...moduleDefinitions, ...toLocalModuleDefinitions(localModules)],\n                options\n            );\n        });\n\n    return runtime;\n}\n"],"names":["isFunction","toLocalModuleDefinitions","EnvironmentVariablesPlugin","MswPlugin","FireflyRuntime","initializeHoneycomb","ApplicationBootstrappingStartedEvent","bootstrap","runtime","modulesDefinitions","options","startMsw","onError","context","results","Error","error","hasExecuted","__resetHasExecutedGuard","initializeFirefly","mode","localModules","moduleDefinitions","useMsw","plugins","environmentVariables","honeycombInstrumentationClient","loggers","x"],"mappings":";;;;;;;;;;;;;;;;;AAAgJ;AAC5D;AAC5C;AAE0C;AACT;AAElE,MAAMM,uCAAuC,mCAAmC;AAgBhF,SAASC,UACZC,OAAiB,EACjBC,kBAAiE,EACjEC,UAA2G,CAAC,CAAC;IAE7G,MAAM,EACFC,QAAQ,EACRC,OAAO,EACPC,OAAO,EACV,GAAGH;IAEJF,QAAQ,QAAQ,CAAC,QAAQ,CAACF;IAE1BE,QAAQ,aAAa,CAAC,eAAe,CAACC,oBAAoB;QAAEI;IAAQ,GAC/D,IAAI,CAACC,CAAAA;QACF,IAAIN,QAAQ,YAAY,EAAE;YACtB,IAAI,CAACR,UAAUA,CAACW,WAAW;gBACvB,MAAM,IAAII,MAAM;YACpB;YAEAJ,SAASH,SACJ,IAAI,CAAC;gBACF,IAAIA,QAAQ,YAAY,EAAE;oBACtBA,QAAQ,WAAW,GAAG,UAAU;gBACpC;YACJ,GACC,KAAK,CAAC,CAACQ;gBACJR,QAAQ,MAAM,CACT,QAAQ,CAAC,iDACT,SAAS,CAACQ,OACV,KAAK;YACd;QACR;QAEA,IAAIJ,SAAS;YACTE,QAAQ,OAAO,CAACE,CAAAA;gBACZJ,QAAQI;YACZ;QACJ;IACJ;AACR;AAEA,IAAIC,cAAc;AAElB,gCAAgC;AACzB,SAASC;IACZD,cAAc;AAClB;AAEO,SAASE,kBAAuDT,UAAqE,CAAC,CAAC;IAC1I,MAAM,EACFU,IAAI,EACJC,eAAe,EAAE,EACjBC,oBAAoB,EAAE,EACtBC,MAAM,EACNC,UAAU,EAAE,EACZC,oBAAoB,EACpBC,8BAA8B,EAC9BC,OAAO,EACPf,OAAO,EACV,GAAGF;IAEJ,IAAIO,aAAa;QACb,MAAM,IAAIF,MAAM;IACpB;IAEAE,cAAc;IAEd,IAAIM,QAAQ;QACRC,QAAQ,IAAI,CAACI,CAAAA,IAAK,IAAIzB,SAASA,CAACyB;IACpC;IAEA,MAAMpB,UAAU,IAAIJ,cAAcA,CAAC;QAC/BgB;QACAM;QACAC;QACA,SAAS;YACLC,CAAAA,IAAK,IAAI1B,0BAA0BA,CAAC0B,GAAG;oBACnC,WAAWH;gBACf;eACGD;SACN;IACL;IAEAnB,mBAAmBA,CAACG,SACf,KAAK,CAAC,CAACQ;QACJ,IAAIJ,SAAS;YACTA,QAAQI;QACZ;IACJ,GACC,OAAO,CAAC;QACLT,UACIC,SACA;eAAIc;eAAsBrB,wBAAwBA,CAACoB;SAAc,EACjEX;IAER;IAEJ,OAAOF;AACX"}

package/dist/useIsActiveRouteProtected.d.ts

@@ -1 +1,4 @@
-export declare function useIsActiveRouteProtected(areModulesReady: boolean): boolean;
+export interface UseIsActiveRouteProtectedOptions {
+    throwWhenThereIsNoMatch?: boolean;
+}
+export declare function useIsActiveRouteProtected(areModulesReady: boolean, options?: UseIsActiveRouteProtectedOptions): boolean;

package/dist/useIsActiveRouteProtected.js

@@ -8,12 +8,13 @@ import { useLocation } from "react-router";
 ;// CONCATENATED MODULE: ./src/useIsActiveRouteProtected.ts
 
 
-function useIsActiveRouteProtected(areModulesReady) {
+function useIsActiveRouteProtected(areModulesReady, options = {}) {
+    const { throwWhenThereIsNoMatch = true } = options;
     // Using this hook instead of window.location to retrieve the current location because it triggers a re-render everytime the browser location change.
     const location = useLocation();
     // Only throw when there's no match if the modules are ready, otherwise it's expected that no route will be found since they are not all registered yet.
     const activeRoute = useRouteMatch(location, {
-        throwWhenThereIsNoMatch: areModulesReady
+        throwWhenThereIsNoMatch: throwWhenThereIsNoMatch && areModulesReady
     });
     return useIsRouteProtected(activeRoute);
 }

package/dist/useIsActiveRouteProtected.js.map

@@ -1 +1 @@
-{"version":3,"file":"useIsActiveRouteProtected.js","sources":["../src/useIsActiveRouteProtected.ts"],"sourcesContent":["import { useIsRouteProtected, useRouteMatch } from \"@squide/react-router\";\nimport { useLocation } from \"react-router\";\n\nexport function useIsActiveRouteProtected(areModulesReady: boolean) {\n    // Using this hook instead of window.location to retrieve the current location because it triggers a re-render everytime the browser location change.\n    const location = useLocation();\n\n    // Only throw when there's no match if the modules are ready, otherwise it's expected that no route will be found since they are not all registered yet.\n    const activeRoute = useRouteMatch(location, { throwWhenThereIsNoMatch: areModulesReady });\n\n    return useIsRouteProtected(activeRoute);\n}\n"],"names":["useIsRouteProtected","useRouteMatch","useLocation","useIsActiveRouteProtected","areModulesReady","location","activeRoute"],"mappings":";;;;;;;;AAA0E;AAC/B;AAEpC,SAASG,0BAA0BC,eAAwB;IAC9D,qJAAqJ;IACrJ,MAAMC,WAAWH,WAAWA;IAE5B,wJAAwJ;IACxJ,MAAMI,cAAcL,aAAaA,CAACI,UAAU;QAAE,yBAAyBD;IAAgB;IAEvF,OAAOJ,mBAAmBA,CAACM;AAC/B"}
+{"version":3,"file":"useIsActiveRouteProtected.js","sources":["../src/useIsActiveRouteProtected.ts"],"sourcesContent":["import { useIsRouteProtected, useRouteMatch } from \"@squide/react-router\";\nimport { useLocation } from \"react-router\";\n\nexport interface UseIsActiveRouteProtectedOptions {\n    throwWhenThereIsNoMatch?: boolean;\n}\n\nexport function useIsActiveRouteProtected(areModulesReady: boolean, options: UseIsActiveRouteProtectedOptions = {}) {\n    const {\n        throwWhenThereIsNoMatch = true\n    } = options;\n\n    // Using this hook instead of window.location to retrieve the current location because it triggers a re-render everytime the browser location change.\n    const location = useLocation();\n\n    // Only throw when there's no match if the modules are ready, otherwise it's expected that no route will be found since they are not all registered yet.\n    const activeRoute = useRouteMatch(location, { throwWhenThereIsNoMatch: throwWhenThereIsNoMatch && areModulesReady });\n\n    return useIsRouteProtected(activeRoute);\n}\n"],"names":["useIsRouteProtected","useRouteMatch","useLocation","useIsActiveRouteProtected","areModulesReady","options","throwWhenThereIsNoMatch","location","activeRoute"],"mappings":";;;;;;;;AAA0E;AAC/B;AAMpC,SAASG,0BAA0BC,eAAwB,EAAEC,UAA4C,CAAC,CAAC;IAC9G,MAAM,EACFC,0BAA0B,IAAI,EACjC,GAAGD;IAEJ,qJAAqJ;IACrJ,MAAME,WAAWL,WAAWA;IAE5B,wJAAwJ;IACxJ,MAAMM,cAAcP,aAAaA,CAACM,UAAU;QAAE,yBAAyBD,2BAA2BF;IAAgB;IAElH,OAAOJ,mBAAmBA,CAACQ;AAC/B"}

package/dist/useStrictRegistrationMode.d.ts

@@ -1 +1,4 @@
-export declare function useStrictRegistrationMode(): void;
+export interface UseStrictRegistrationModeOptions {
+    isEnabled?: boolean;
+}
+export declare function useStrictRegistrationMode(options?: UseStrictRegistrationModeOptions): void;

package/dist/useStrictRegistrationMode.js

@@ -14,17 +14,19 @@ function subscribeToModulesReady(runtime) {
         return ()=>runtime.moduleManager.removeModulesReadyListener(callback);
     };
 }
-function useStrictRegistrationMode() {
+function useStrictRegistrationMode(options = {}) {
+    const { isEnabled = true } = options;
     const runtime = useRuntime();
     // This listener is only executed if the modules are ready.
     const areModulesReady = useSyncExternalStore(subscribeToModulesReady(runtime), ()=>runtime.moduleManager.getAreModulesReady());
     useEffect(()=>{
-        if (areModulesReady) {
+        if (areModulesReady && isEnabled) {
             runtime._validateRegistrations();
         }
     }, [
         runtime,
-        areModulesReady
+        areModulesReady,
+        isEnabled
     ]);
 }
 

package/dist/useStrictRegistrationMode.js.map

@@ -1 +1 @@
-{"version":3,"file":"useStrictRegistrationMode.js","sources":["../src/useStrictRegistrationMode.ts"],"sourcesContent":["import { Runtime, useRuntime } from \"@squide/core\";\nimport { useEffect, useSyncExternalStore } from \"react\";\n\nfunction subscribeToModulesReady(runtime: Runtime) {\n    return (callback: () => void) => {\n        runtime.moduleManager.registerModulesReadyListener(callback);\n\n        return () => runtime.moduleManager.removeModulesReadyListener(callback);\n    };\n}\n\nexport function useStrictRegistrationMode() {\n    const runtime = useRuntime();\n\n    // This listener is only executed if the modules are ready.\n    const areModulesReady = useSyncExternalStore(subscribeToModulesReady(runtime), () => runtime.moduleManager.getAreModulesReady());\n\n    useEffect(() => {\n        if (areModulesReady) {\n            runtime._validateRegistrations();\n        }\n    }, [runtime, areModulesReady]);\n}\n"],"names":["useRuntime","useEffect","useSyncExternalStore","subscribeToModulesReady","runtime","callback","useStrictRegistrationMode","areModulesReady"],"mappings":";;;;;;;;AAAmD;AACK;AAExD,SAASG,wBAAwBC,OAAgB;IAC7C,OAAO,CAACC;QACJD,QAAQ,aAAa,CAAC,4BAA4B,CAACC;QAEnD,OAAO,IAAMD,QAAQ,aAAa,CAAC,0BAA0B,CAACC;IAClE;AACJ;AAEO,SAASC;IACZ,MAAMF,UAAUJ,UAAUA;IAE1B,2DAA2D;IAC3D,MAAMO,kBAAkBL,oBAAoBA,CAACC,wBAAwBC,UAAU,IAAMA,QAAQ,aAAa,CAAC,kBAAkB;IAE7HH,SAASA,CAAC;QACN,IAAIM,iBAAiB;YACjBH,QAAQ,sBAAsB;QAClC;IACJ,GAAG;QAACA;QAASG;KAAgB;AACjC"}
+{"version":3,"file":"useStrictRegistrationMode.js","sources":["../src/useStrictRegistrationMode.ts"],"sourcesContent":["import { Runtime, useRuntime } from \"@squide/core\";\nimport { useEffect, useSyncExternalStore } from \"react\";\n\nfunction subscribeToModulesReady(runtime: Runtime) {\n    return (callback: () => void) => {\n        runtime.moduleManager.registerModulesReadyListener(callback);\n\n        return () => runtime.moduleManager.removeModulesReadyListener(callback);\n    };\n}\n\nexport interface UseStrictRegistrationModeOptions {\n    isEnabled?: boolean;\n}\n\nexport function useStrictRegistrationMode(options: UseStrictRegistrationModeOptions = {}) {\n    const {\n        isEnabled = true\n    } = options;\n\n    const runtime = useRuntime();\n\n    // This listener is only executed if the modules are ready.\n    const areModulesReady = useSyncExternalStore(subscribeToModulesReady(runtime), () => runtime.moduleManager.getAreModulesReady());\n\n    useEffect(() => {\n        if (areModulesReady && isEnabled) {\n            runtime._validateRegistrations();\n        }\n    }, [runtime, areModulesReady, isEnabled]);\n}\n"],"names":["useRuntime","useEffect","useSyncExternalStore","subscribeToModulesReady","runtime","callback","useStrictRegistrationMode","options","isEnabled","areModulesReady"],"mappings":";;;;;;;;AAAmD;AACK;AAExD,SAASG,wBAAwBC,OAAgB;IAC7C,OAAO,CAACC;QACJD,QAAQ,aAAa,CAAC,4BAA4B,CAACC;QAEnD,OAAO,IAAMD,QAAQ,aAAa,CAAC,0BAA0B,CAACC;IAClE;AACJ;AAMO,SAASC,0BAA0BC,UAA4C,CAAC,CAAC;IACpF,MAAM,EACFC,YAAY,IAAI,EACnB,GAAGD;IAEJ,MAAMH,UAAUJ,UAAUA;IAE1B,2DAA2D;IAC3D,MAAMS,kBAAkBP,oBAAoBA,CAACC,wBAAwBC,UAAU,IAAMA,QAAQ,aAAa,CAAC,kBAAkB;IAE7HH,SAASA,CAAC;QACN,IAAIQ,mBAAmBD,WAAW;YAC9BJ,QAAQ,sBAAsB;QAClC;IACJ,GAAG;QAACA;QAASK;QAAiBD;KAAU;AAC5C"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@squide/firefly",
   "author": "Workleap",
-  "version": "16.0.0",
-  "description": "Helpers to facilitate the creation of an application with the Squide firefly technology stack.",
+  "version": "16.0.2",
+  "description": "Squide bundle for the firefly technology stack.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -39,13 +39,19 @@
     "react-dom": "^18.0.0 || ^19.0.0",
     "react-router": "^7.9.6"
   },
+  "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "@workleap-telemetry/core": "^1.0.4",
     "@workleap/logging": "^1.3.2",
     "uuid": "^13.0.0",
-    "@squide/core": "6.1.4",
-    "@squide/msw": "4.0.5",
-    "@squide/react-router": "8.1.4"
+    "@squide/core": "6.1.5",
+    "@squide/env-vars": "1.4.8",
+    "@squide/msw": "4.0.6",
+    "@squide/react-router": "8.1.5"
   },
   "devDependencies": {
     "@eslint/js": "9.39.1",

package/src/AppRouter.tsx

@@ -27,7 +27,7 @@ export function useCanRenderRouter({ areModulesRegistered, areModulesReady: areM
     );
 }
 
-function useRenderRouterProvider(state: AppRouterState, renderRouterProvider: RenderRouterProviderFunction) {
+function useRenderRouterProvider(state: AppRouterState, renderRouterProvider: RenderRouterProviderFunction, strictMode: boolean) {
     const routes = useRoutes();
 
     // The value is computed outside of the router provider memo to prevent
@@ -37,19 +37,20 @@ function useRenderRouterProvider(state: AppRouterState, renderRouterProvider: Re
     return useMemo(() => {
         if (canRenderRouter) {
             return renderRouterProvider({
-                rootRoute: <RootRoute />,
+                rootRoute: <RootRoute strictMode={strictMode} />,
                 registeredRoutes: routes,
                 routerProviderProps: {}
             });
         }
 
         return null;
-    }, [canRenderRouter, routes, renderRouterProvider]);
+    }, [canRenderRouter, routes, renderRouterProvider, strictMode]);
 }
 
 export interface AppRouterProps {
     waitForPublicData?: boolean;
     waitForProtectedData?: boolean;
+    strictMode?: boolean;
     children: RenderRouterProviderFunction;
 }
 
@@ -57,13 +58,16 @@ export function AppRouter(props: AppRouterProps) {
     const {
         waitForPublicData = false,
         waitForProtectedData = false,
+        strictMode = true,
         children: renderRouterProvider
     } = props;
     const [state, dispatch] = useAppRouterReducer(waitForPublicData, waitForProtectedData);
 
     const logger = useLogger();
 
-    useStrictRegistrationMode();
+    useStrictRegistrationMode({
+        isEnabled: strictMode
+    });
 
     useEffect(() => {
         logger
@@ -72,7 +76,7 @@ export function AppRouter(props: AppRouterProps) {
             .debug();
     }, [state, logger]);
 
-    const routerProvider = useRenderRouterProvider(state, renderRouterProvider);
+    const routerProvider = useRenderRouterProvider(state, renderRouterProvider, strictMode);
 
     return (
         <AppRouterDispatcherContext.Provider value={dispatch}>

package/src/FireflyRuntime.tsx

@@ -1,5 +1,6 @@
 import type { RegisterRouteOptions, RuntimeMethodOptions, RuntimeOptions } from "@squide/core";
-import { MswPlugin, MswPluginName, MswState } from "@squide/msw";
+import { EnvironmentVariableKey, EnvironmentVariables, EnvironmentVariableValue, getEnvironmentVariablesPlugin } from "@squide/env-vars";
+import { getMswPlugin, MswPluginName, MswState } from "@squide/msw";
 import { type IReactRouterRuntime, ReactRouterRuntime, ReactRouterRuntimeScope, type Route } from "@squide/react-router";
 import type { HoneycombInstrumentationPartialClient } from "@workleap-telemetry/core";
 import type { Logger } from "@workleap/logging";
@@ -16,8 +17,12 @@ export interface IFireflyRuntime extends IReactRouterRuntime {
     getMswState(): MswState;
     registerRequestHandlers: (handlers: RequestHandler[]) => void;
     get requestHandlers(): RequestHandler[];
-    get appRouterStore(): AppRouterStore;
     get isMswEnabled(): boolean;
+    registerEnvironmentVariable(key: EnvironmentVariableKey, value: EnvironmentVariableValue): void;
+    registerEnvironmentVariables(variables: Partial<EnvironmentVariables>): void;
+    getEnvironmentVariable(key: EnvironmentVariableKey): EnvironmentVariableValue;
+    getEnvironmentVariables(): EnvironmentVariables;
+    get appRouterStore(): AppRouterStore;
     get honeycombInstrumentationClient(): HoneycombInstrumentationPartialClient | undefined;
 }
 
@@ -26,65 +31,81 @@ export class FireflyRuntime<TRuntime extends FireflyRuntime = any> extends React
     protected _appRouterStore: AppRouterStore;
     protected _honeycombInstrumentationClient: HoneycombInstrumentationPartialClient | undefined;
 
-    constructor({ honeycombInstrumentationClient, ...options }: FireflyRuntimeOptions = {}) {
+    constructor(options: FireflyRuntimeOptions = {}) {
+        const {
+            honeycombInstrumentationClient
+        } = options;
+
         super(options);
 
         this._appRouterStore = createAppRouterStore(this._logger);
         this._honeycombInstrumentationClient = honeycombInstrumentationClient;
     }
 
-    getMswState() {
-        const mswPlugin = this.getPlugin(MswPluginName) as MswPlugin;
-
-        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?");
+    registerRoute(route: Route, options: RegisterRouteOptions = {}) {
+        if (this.moduleManager.getAreModulesRegistered()) {
+            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.");
         }
 
-        return mswPlugin.mswState;
+        super.registerRoute(route, options);
+    }
+
+    getMswState() {
+        const plugin = getMswPlugin(this);
+
+        return plugin.mswState;
     }
 
     registerRequestHandlers(handlers: RequestHandler[], options: RegisterRequestHandlersOptions = {}) {
         const logger = this._getLogger(options);
-        const mswPlugin = this.getPlugin(MswPluginName) as MswPlugin;
-
-        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?");
-        }
+        const plugin = getMswPlugin(this);
 
         if (this.moduleManager.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, {
+        plugin.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(): RequestHandler[] {
-        const mswPlugin = this.getPlugin(MswPluginName) as MswPlugin;
+        const plugin = getMswPlugin(this);
 
-        if (!mswPlugin) {
-            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?");
-        }
+        return plugin.requestHandlers;
+    }
 
-        return mswPlugin.requestHandlers;
+    get isMswEnabled() {
+        return this._plugins.some(x => x.name === MswPluginName);
     }
 
-    registerRoute(route: Route, options: RegisterRouteOptions = {}) {
-        if (this.moduleManager.getAreModulesRegistered()) {
-            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.");
-        }
+    getEnvironmentVariable(key: EnvironmentVariableKey) {
+        const plugin = getEnvironmentVariablesPlugin(this);
 
-        super.registerRoute(route, options);
+        return plugin.getVariable(key);
     }
 
-    get appRouterStore() {
-        return this._appRouterStore;
+    getEnvironmentVariables() {
+        const plugin = getEnvironmentVariablesPlugin(this);
+
+        return plugin.getVariables();
     }
 
-    get isMswEnabled() {
-        return this._plugins.some(x => x.name === MswPluginName);
+    registerEnvironmentVariable(key: EnvironmentVariableKey, value: EnvironmentVariableValue) {
+        const plugin = getEnvironmentVariablesPlugin(this);
+
+        return plugin.registerVariable(key, value);
+    }
+
+    registerEnvironmentVariables(variables: Partial<EnvironmentVariables>) {
+        const plugin = getEnvironmentVariablesPlugin(this);
+
+        return plugin.registerVariables(variables);
+    }
+
+    get appRouterStore() {
+        return this._appRouterStore;
     }
 
     get honeycombInstrumentationClient() {
@@ -113,14 +134,30 @@ export class FireflyRuntimeScope<TRuntime extends FireflyRuntime = FireflyRuntim
         return this._runtime.requestHandlers;
     }
 
-    get appRouterStore(): AppRouterStore {
-        throw new Error("[squide] Cannot retrieve the app router store from a runtime scope instance.");
-    }
-
     get isMswEnabled() {
         return this._runtime.isMswEnabled;
     }
 
+    getEnvironmentVariables() {
+        return this._runtime.getEnvironmentVariables();
+    }
+
+    getEnvironmentVariable(key: EnvironmentVariableKey) {
+        return this._runtime.getEnvironmentVariable(key);
+    }
+
+    registerEnvironmentVariable(key: EnvironmentVariableKey, value: EnvironmentVariableValue) {
+        this._runtime.registerEnvironmentVariable(key, value);
+    }
+
+    registerEnvironmentVariables(variables: Partial<EnvironmentVariables>) {
+        this._runtime.registerEnvironmentVariables(variables);
+    }
+
+    get appRouterStore(): AppRouterStore {
+        throw new Error("[squide] Cannot retrieve the app router store from a runtime scope instance.");
+    }
+
     get honeycombInstrumentationClient(): HoneycombInstrumentationPartialClient {
         throw new Error("[squide] Cannot retrieve the Honeycomb instrumentation client from a runtime scope instance.");
     }

package/src/RootRoute.tsx

@@ -3,9 +3,20 @@ import { Outlet } from "react-router";
 import { useAppRouterDispatcher, useAppRouterState } from "./AppRouterContext.ts";
 import { useIsActiveRouteProtected } from "./useIsActiveRouteProtected.ts";
 
-export function RootRoute() {
+export interface RootRouteProps {
+    strictMode?: boolean;
+}
+
+export function RootRoute(props: RootRouteProps) {
+    const {
+        strictMode = true
+    } = props;
+
     const state = useAppRouterState();
-    const isActiveRouteProtected = useIsActiveRouteProtected(state.areModulesReady);
+
+    const isActiveRouteProtected = useIsActiveRouteProtected(state.areModulesReady, {
+        throwWhenThereIsNoMatch: strictMode
+    });
 
     const dispatch = useAppRouterDispatcher();
 

package/src/index.ts

@@ -1,5 +1,25 @@
 export * from "@squide/core";
-export * from "@squide/msw";
+export {
+    EnvironmentVariablesPlugin,
+    EnvironmentVariablesPluginName,
+    getEnvironmentVariablesPlugin,
+    useEnvironmentVariable,
+    useEnvironmentVariables,
+    type EnvironmentVariableKey,
+    type EnvironmentVariables,
+    type EnvironmentVariablesPluginOptions,
+    type EnvironmentVariableValue
+} from "@squide/env-vars";
+export {
+    getMswPlugin,
+    MswPlugin,
+    MswPluginName,
+    MswState,
+    type MswPluginOptions,
+    type MswPluginRegisterRequestHandlersOptions,
+    type MswReadyListener,
+    type MswStateOptions
+} from "@squide/msw";
 export * from "@squide/react-router";
 
 export type { FireflyPlugin } from "./FireflyPlugin.ts";

package/src/initializeFirefly.ts

@@ -1,4 +1,5 @@
 import { isFunction, ModuleDefinition, toLocalModuleDefinitions, type ModuleRegisterFunction, type RegisterModulesOptions } from "@squide/core";
+import { EnvironmentVariables, EnvironmentVariablesPlugin } from "@squide/env-vars";
 import { MswPlugin } from "@squide/msw";
 import type { HoneycombInstrumentationPartialClient } from "@workleap-telemetry/core";
 import { FireflyRuntime, type FireflyRuntimeOptions } from "./FireflyRuntime.tsx";
@@ -14,6 +15,7 @@ export interface InitializeFireflyOptions<TRuntime extends FireflyRuntime, TCont
     localModules?: ModuleRegisterFunction<TRuntime, TContext, TData>[];
     moduleDefinitions?: ModuleDefinition<TRuntime, TContext, TData>[];
     useMsw?: boolean;
+    environmentVariables?: Partial<EnvironmentVariables>;
     honeycombInstrumentationClient?: HoneycombInstrumentationPartialClient;
     startMsw?: StartMswFunction<FireflyRuntime>;
     onError?: OnInitializationErrorFunction;
@@ -75,6 +77,7 @@ export function initializeFirefly<TContext = unknown, TData = unknown>(options:
         moduleDefinitions = [],
         useMsw,
         plugins = [],
+        environmentVariables,
         honeycombInstrumentationClient,
         loggers,
         onError
@@ -94,7 +97,12 @@ export function initializeFirefly<TContext = unknown, TData = unknown>(options:
         mode,
         honeycombInstrumentationClient,
         loggers,
-        plugins
+        plugins: [
+            x => new EnvironmentVariablesPlugin(x, {
+                variables: environmentVariables
+            }),
+            ...plugins
+        ]
     });
 
     initializeHoneycomb(runtime)

package/src/useIsActiveRouteProtected.ts

@@ -1,12 +1,20 @@
 import { useIsRouteProtected, useRouteMatch } from "@squide/react-router";
 import { useLocation } from "react-router";
 
-export function useIsActiveRouteProtected(areModulesReady: boolean) {
+export interface UseIsActiveRouteProtectedOptions {
+    throwWhenThereIsNoMatch?: boolean;
+}
+
+export function useIsActiveRouteProtected(areModulesReady: boolean, options: UseIsActiveRouteProtectedOptions = {}) {
+    const {
+        throwWhenThereIsNoMatch = true
+    } = options;
+
     // Using this hook instead of window.location to retrieve the current location because it triggers a re-render everytime the browser location change.
     const location = useLocation();
 
     // Only throw when there's no match if the modules are ready, otherwise it's expected that no route will be found since they are not all registered yet.
-    const activeRoute = useRouteMatch(location, { throwWhenThereIsNoMatch: areModulesReady });
+    const activeRoute = useRouteMatch(location, { throwWhenThereIsNoMatch: throwWhenThereIsNoMatch && areModulesReady });
 
     return useIsRouteProtected(activeRoute);
 }

package/src/useStrictRegistrationMode.ts

@@ -9,15 +9,23 @@ function subscribeToModulesReady(runtime: Runtime) {
     };
 }
 
-export function useStrictRegistrationMode() {
+export interface UseStrictRegistrationModeOptions {
+    isEnabled?: boolean;
+}
+
+export function useStrictRegistrationMode(options: UseStrictRegistrationModeOptions = {}) {
+    const {
+        isEnabled = true
+    } = options;
+
     const runtime = useRuntime();
 
     // This listener is only executed if the modules are ready.
     const areModulesReady = useSyncExternalStore(subscribeToModulesReady(runtime), () => runtime.moduleManager.getAreModulesReady());
 
     useEffect(() => {
-        if (areModulesReady) {
+        if (areModulesReady && isEnabled) {
             runtime._validateRegistrations();
         }
-    }, [runtime, areModulesReady]);
+    }, [runtime, areModulesReady, isEnabled]);
 }