@squide/env-vars 1.4.8 → 1.4.10

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @squide/env-vars
 
+## 1.4.10
+
+### Patch Changes
+
+- [#352](https://github.com/workleap/wl-squide/pull/352) [`7bd7af5`](https://github.com/workleap/wl-squide/commit/7bd7af5a757912309704b9e93bf8ecf1388e6787) Thanks [@patricklafrance](https://github.com/patricklafrance)! - Bump dependency versions.
+
+- Updated dependencies [[`7bd7af5`](https://github.com/workleap/wl-squide/commit/7bd7af5a757912309704b9e93bf8ecf1388e6787)]:
+  - @squide/core@6.1.7
+
+## 1.4.9
+
+### Patch Changes
+
+- [#347](https://github.com/workleap/wl-squide/pull/347) [`6354489`](https://github.com/workleap/wl-squide/commit/6354489117e9826291da71f977daae55a5c5484a) Thanks [@patricklafrance](https://github.com/patricklafrance)! - Bumped package versions.
+
+- Updated dependencies [[`6354489`](https://github.com/workleap/wl-squide/commit/6354489117e9826291da71f977daae55a5c5484a)]:
+  - @squide/core@6.1.6
+
 ## 1.4.8
 
 ### Patch Changes

package/dist/EnvironmentVariablesPlugin.d.ts

@@ -1,5 +1,5 @@
 import { Plugin, type Runtime } from "@squide/core";
-import { type EnvironmentVariableKey, type EnvironmentVariables, type EnvironmentVariableValue } from "./EnvironmentVariablesRegistry.ts";
+import { type EnvironmentVariableKey, type EnvironmentVariables } from "./EnvironmentVariablesRegistry.ts";
 export declare const EnvironmentVariablesPluginName = "env-vars-plugin";
 export interface EnvironmentVariablesPluginOptions {
     variables?: Partial<EnvironmentVariables>;
@@ -7,9 +7,9 @@ export interface EnvironmentVariablesPluginOptions {
 export declare class EnvironmentVariablesPlugin extends Plugin {
     #private;
     constructor(runtime: Runtime, options?: EnvironmentVariablesPluginOptions);
-    registerVariable(key: EnvironmentVariableKey, value: EnvironmentVariableValue): void;
+    registerVariable<T extends EnvironmentVariableKey>(key: T, value: EnvironmentVariables[T]): void;
     registerVariables(variables: Partial<EnvironmentVariables>): void;
-    getVariable(key: EnvironmentVariableKey): never;
+    getVariable<T extends EnvironmentVariableKey>(key: T): EnvironmentVariables[T];
     getVariables(): EnvironmentVariables;
 }
 export declare function getEnvironmentVariablesPlugin(runtime: Runtime): EnvironmentVariablesPlugin;

package/dist/EnvironmentVariablesPlugin.js

@@ -1,4 +1,4 @@
-import { Plugin, isNil } from "@squide/core";
+import { Plugin } from "@squide/core";
 import { EnvironmentVariablesRegistry } from "./EnvironmentVariablesRegistry.js";
 
 ;// CONCATENATED MODULE: external "@squide/core"
@@ -34,9 +34,11 @@ class EnvironmentVariablesPlugin extends Plugin {
     }
 }
 function getEnvironmentVariablesPlugin(runtime) {
-    const plugin = runtime.getPlugin(EnvironmentVariablesPluginName);
-    if (isNil(plugin)) {
-        throw new Error("[squide] The getEnvironmentVariablesPlugin function is called but no EnvironmentVariablesPlugin instance has been registered with the runtime.");
+    const plugin = runtime.getPlugin(EnvironmentVariablesPluginName, {
+        throwOnNotFound: false
+    });
+    if (!plugin) {
+        throw new Error("[squide] The getEnvironmentVariablesPlugin function is called but no EnvironmentVariablesPlugin instance has been registered with the runtime. Did you provide a EnvironmentVariablesPlugin instance to the runtime instance?");
     }
     return plugin;
 }

package/dist/EnvironmentVariablesPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"EnvironmentVariablesPlugin.js","sources":["../src/EnvironmentVariablesPlugin.ts"],"sourcesContent":["import { isNil, Plugin, type Runtime } from \"@squide/core\";\nimport { EnvironmentVariablesRegistry, type EnvironmentVariableKey, type EnvironmentVariables, type EnvironmentVariableValue } from \"./EnvironmentVariablesRegistry.ts\";\n\nexport const EnvironmentVariablesPluginName = \"env-vars-plugin\";\n\nexport interface EnvironmentVariablesPluginOptions {\n    variables?: Partial<EnvironmentVariables>;\n}\n\nexport class EnvironmentVariablesPlugin extends Plugin {\n    readonly #environmentVariablesRegistry = new EnvironmentVariablesRegistry();\n\n    constructor(runtime: Runtime, options: EnvironmentVariablesPluginOptions = {}) {\n        super(EnvironmentVariablesPluginName, runtime);\n\n        const {\n            variables\n        } = options;\n\n        if (variables) {\n            this.#environmentVariablesRegistry.addVariables(variables);\n        }\n    }\n\n    registerVariable(key: EnvironmentVariableKey, value: EnvironmentVariableValue) {\n        this.#environmentVariablesRegistry.add(key, value);\n\n        this._runtime.logger.debug(`[squide] An environment variable for key \"${key}\" has been registered with the value \"${value}\".`);\n    }\n\n    registerVariables(variables: Partial<EnvironmentVariables>) {\n        this.#environmentVariablesRegistry.addVariables(variables);\n\n        this._runtime.logger\n            .withText(\"[squide] The following environment variables has been registered:\")\n            .withObject(variables)\n            .debug();\n    }\n\n    getVariable(key: EnvironmentVariableKey) {\n        return this.#environmentVariablesRegistry.getVariable(key);\n    }\n\n    getVariables() {\n        return this.#environmentVariablesRegistry.getVariables();\n    }\n}\n\nexport function getEnvironmentVariablesPlugin(runtime: Runtime) {\n    const plugin = runtime.getPlugin(EnvironmentVariablesPluginName);\n\n    if (isNil(plugin)) {\n        throw new Error(\"[squide] The getEnvironmentVariablesPlugin function is called but no EnvironmentVariablesPlugin instance has been registered with the runtime.\");\n    }\n\n    return plugin as EnvironmentVariablesPlugin;\n}\n"],"names":["isNil","Plugin","EnvironmentVariablesRegistry","EnvironmentVariablesPluginName","EnvironmentVariablesPlugin","runtime","options","variables","key","value","getEnvironmentVariablesPlugin","plugin","Error"],"mappings":";;;;;;;;AAA2D;AAC6G;AAEjK,MAAMG,iCAAiC,kBAAkB;AAMzD,MAAMC,mCAAmCH,MAAMA;IACzC,6BAA6B,GAAG,IAAIC,4BAA4BA,GAAG;IAE5E,YAAYG,OAAgB,EAAEC,UAA6C,CAAC,CAAC,CAAE;QAC3E,KAAK,CAACH,gCAAgCE;QAEtC,MAAM,EACFE,SAAS,EACZ,GAAGD;QAEJ,IAAIC,WAAW;YACX,IAAI,CAAC,6BAA6B,CAAC,YAAY,CAACA;QACpD;IACJ;IAEA,iBAAiBC,GAA2B,EAAEC,KAA+B,EAAE;QAC3E,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAACD,KAAKC;QAE5C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,0CAA0C,EAAED,IAAI,sCAAsC,EAAEC,MAAM,EAAE,CAAC;IACjI;IAEA,kBAAkBF,SAAwC,EAAE;QACxD,IAAI,CAAC,6BAA6B,CAAC,YAAY,CAACA;QAEhD,IAAI,CAAC,QAAQ,CAAC,MAAM,CACf,QAAQ,CAAC,qEACT,UAAU,CAACA,WACX,KAAK;IACd;IAEA,YAAYC,GAA2B,EAAE;QACrC,OAAO,IAAI,CAAC,6BAA6B,CAAC,WAAW,CAACA;IAC1D;IAEA,eAAe;QACX,OAAO,IAAI,CAAC,6BAA6B,CAAC,YAAY;IAC1D;AACJ;AAEO,SAASE,8BAA8BL,OAAgB;IAC1D,MAAMM,SAASN,QAAQ,SAAS,CAACF;IAEjC,IAAIH,KAAKA,CAACW,SAAS;QACf,MAAM,IAAIC,MAAM;IACpB;IAEA,OAAOD;AACX"}
+{"version":3,"file":"EnvironmentVariablesPlugin.js","sources":["../src/EnvironmentVariablesPlugin.ts"],"sourcesContent":["import { Plugin, type Runtime } from \"@squide/core\";\nimport { EnvironmentVariablesRegistry, type EnvironmentVariableKey, type EnvironmentVariables } from \"./EnvironmentVariablesRegistry.ts\";\n\nexport const EnvironmentVariablesPluginName = \"env-vars-plugin\";\n\nexport interface EnvironmentVariablesPluginOptions {\n    variables?: Partial<EnvironmentVariables>;\n}\n\nexport class EnvironmentVariablesPlugin extends Plugin {\n    readonly #environmentVariablesRegistry = new EnvironmentVariablesRegistry();\n\n    constructor(runtime: Runtime, options: EnvironmentVariablesPluginOptions = {}) {\n        super(EnvironmentVariablesPluginName, runtime);\n\n        const {\n            variables\n        } = options;\n\n        if (variables) {\n            this.#environmentVariablesRegistry.addVariables(variables);\n        }\n    }\n\n    registerVariable<T extends EnvironmentVariableKey>(key: T, value: EnvironmentVariables[T]) {\n        this.#environmentVariablesRegistry.add(key, value);\n\n        this._runtime.logger.debug(`[squide] An environment variable for key \"${key}\" has been registered with the value \"${value}\".`);\n    }\n\n    registerVariables(variables: Partial<EnvironmentVariables>) {\n        this.#environmentVariablesRegistry.addVariables(variables);\n\n        this._runtime.logger\n            .withText(\"[squide] The following environment variables has been registered:\")\n            .withObject(variables)\n            .debug();\n    }\n\n    getVariable<T extends EnvironmentVariableKey>(key: T) {\n        return this.#environmentVariablesRegistry.getVariable(key);\n    }\n\n    getVariables() {\n        return this.#environmentVariablesRegistry.getVariables();\n    }\n}\n\nexport function getEnvironmentVariablesPlugin(runtime: Runtime) {\n    const plugin = runtime.getPlugin(EnvironmentVariablesPluginName, {\n        throwOnNotFound: false\n    }) as EnvironmentVariablesPlugin;\n\n    if (!plugin) {\n        throw new Error(\"[squide] The getEnvironmentVariablesPlugin function is called but no EnvironmentVariablesPlugin instance has been registered with the runtime. Did you provide a EnvironmentVariablesPlugin instance to the runtime instance?\");\n    }\n\n    return plugin;\n}\n"],"names":["Plugin","EnvironmentVariablesRegistry","EnvironmentVariablesPluginName","EnvironmentVariablesPlugin","runtime","options","variables","key","value","getEnvironmentVariablesPlugin","plugin","Error"],"mappings":";;;;;;;;AAAoD;AACqF;AAElI,MAAME,iCAAiC,kBAAkB;AAMzD,MAAMC,mCAAmCH,MAAMA;IACzC,6BAA6B,GAAG,IAAIC,4BAA4BA,GAAG;IAE5E,YAAYG,OAAgB,EAAEC,UAA6C,CAAC,CAAC,CAAE;QAC3E,KAAK,CAACH,gCAAgCE;QAEtC,MAAM,EACFE,SAAS,EACZ,GAAGD;QAEJ,IAAIC,WAAW;YACX,IAAI,CAAC,6BAA6B,CAAC,YAAY,CAACA;QACpD;IACJ;IAEA,iBAAmDC,GAAM,EAAEC,KAA8B,EAAE;QACvF,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAACD,KAAKC;QAE5C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,0CAA0C,EAAED,IAAI,sCAAsC,EAAEC,MAAM,EAAE,CAAC;IACjI;IAEA,kBAAkBF,SAAwC,EAAE;QACxD,IAAI,CAAC,6BAA6B,CAAC,YAAY,CAACA;QAEhD,IAAI,CAAC,QAAQ,CAAC,MAAM,CACf,QAAQ,CAAC,qEACT,UAAU,CAACA,WACX,KAAK;IACd;IAEA,YAA8CC,GAAM,EAAE;QAClD,OAAO,IAAI,CAAC,6BAA6B,CAAC,WAAW,CAACA;IAC1D;IAEA,eAAe;QACX,OAAO,IAAI,CAAC,6BAA6B,CAAC,YAAY;IAC1D;AACJ;AAEO,SAASE,8BAA8BL,OAAgB;IAC1D,MAAMM,SAASN,QAAQ,SAAS,CAACF,gCAAgC;QAC7D,iBAAiB;IACrB;IAEA,IAAI,CAACQ,QAAQ;QACT,MAAM,IAAIC,MAAM;IACpB;IAEA,OAAOD;AACX"}

package/dist/EnvironmentVariablesRegistry.d.ts

@@ -1,11 +1,11 @@
 export interface EnvironmentVariables {
 }
 export type EnvironmentVariableKey = keyof EnvironmentVariables;
-export type EnvironmentVariableValue = EnvironmentVariables[keyof EnvironmentVariables];
+export declare function typedEntries<T extends object>(obj: T): Array<[keyof T, T[keyof T]]>;
 export declare class EnvironmentVariablesRegistry {
     #private;
-    add(key: EnvironmentVariableKey, value: EnvironmentVariableValue): void;
+    add<T extends EnvironmentVariableKey>(key: T, value: EnvironmentVariables[T]): void;
     addVariables(variables: Partial<EnvironmentVariables>): void;
-    getVariable(key: EnvironmentVariableKey): never;
+    getVariable<T extends EnvironmentVariableKey>(key: T): EnvironmentVariables[T];
     getVariables(): EnvironmentVariables;
 }

package/dist/EnvironmentVariablesRegistry.js

@@ -4,6 +4,9 @@ import memoize, { memoizeClear } from "memoize";
 
 ;// CONCATENATED MODULE: ./src/EnvironmentVariablesRegistry.ts
 
+function typedEntries(obj) {
+    return Object.entries(obj);
+}
 class EnvironmentVariablesRegistry {
     #variables = new Map();
     // Since the "getVariables" function is transforming the variables from a Map to an Object, the result of
@@ -23,8 +26,10 @@ class EnvironmentVariablesRegistry {
     addVariables(variables) {
         // Do not clear the "getVariables" memoize result if there are no variables.
         if (Object.keys(variables).length > 0) {
-            for (const [key, value] of Object.entries(variables)){
-                this.add(key, value);
+            for (const [key, value] of typedEntries(variables)){
+                if (value) {
+                    this.add(key, value);
+                }
             }
             memoizeClear(this.#memoizedGetVariables);
         }
@@ -41,6 +46,6 @@ class EnvironmentVariablesRegistry {
     }
 }
 
-export { EnvironmentVariablesRegistry };
+export { EnvironmentVariablesRegistry, typedEntries };
 
 //# sourceMappingURL=EnvironmentVariablesRegistry.js.map

package/dist/EnvironmentVariablesRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"EnvironmentVariablesRegistry.js","sources":["../src/EnvironmentVariablesRegistry.ts"],"sourcesContent":["import memoize, { memoizeClear } from \"memoize\";\n\n// The \"EnvironmentVariables\" interface is expected to be extended by modules adding their own environment variables to the runtime.\n// This magic is called module augmentation: https://www.typescriptlang.org/docs/handbook/declaration-merging.html#module-augmentation.\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface EnvironmentVariables {}\n\nexport type EnvironmentVariableKey = keyof EnvironmentVariables;\nexport type EnvironmentVariableValue = EnvironmentVariables[keyof EnvironmentVariables];\n\nexport class EnvironmentVariablesRegistry {\n    readonly #variables = new Map<EnvironmentVariableKey, EnvironmentVariableValue>();\n\n    // Since the \"getVariables\" function is transforming the variables from a Map to an Object, the result of\n    // the transformation is memoized to ensure the returned Object is immutable and can be use in React closures.\n    readonly #memoizedGetVariables = memoize(() => Object.fromEntries(this.#variables) as unknown as EnvironmentVariables);\n\n    add(key: EnvironmentVariableKey, value: EnvironmentVariableValue) {\n        if (this.#variables.has(key)) {\n            const existingValue = this.#variables.get(key);\n\n            if (existingValue !== value) {\n                throw new Error(`[squide] An environment variable with the key \"${key}\" already exist and the new value differs from the existing one. Existing value: \"${existingValue}\" - New Value: \"${value}\"`);\n            }\n        } else {\n            this.#variables.set(key, value);\n\n            memoizeClear(this.#memoizedGetVariables);\n        }\n    }\n\n    addVariables(variables: Partial<EnvironmentVariables>) {\n        // Do not clear the \"getVariables\" memoize result if there are no variables.\n        if (Object.keys(variables).length > 0) {\n            for (const [key, value] of Object.entries(variables)) {\n                this.add(key as EnvironmentVariableKey, value as EnvironmentVariableValue);\n            }\n\n            memoizeClear(this.#memoizedGetVariables);\n        }\n    }\n\n    getVariable(key: EnvironmentVariableKey) {\n        const value = this.#variables.get(key);\n\n        if (!value) {\n            throw new Error(`[squide] No environment variable has been registered for the key \"${key}\".`);\n        }\n\n        return value;\n    }\n\n    getVariables() {\n        return this.#memoizedGetVariables();\n    }\n}\n"],"names":["memoize","memoizeClear","EnvironmentVariablesRegistry","Map","Object","key","value","existingValue","Error","variables"],"mappings":";;;;;AAAgD;AAUzC,MAAME;IACA,UAAU,GAAG,IAAIC,MAAwD;IAElF,yGAAyG;IACzG,8GAA8G;IACrG,qBAAqB,GAAGH,OAAOA,CAAC,IAAMI,OAAO,WAAW,CAAC,IAAI,CAAC,UAAU,GAAsC;IAEvH,IAAIC,GAA2B,EAAEC,KAA+B,EAAE;QAC9D,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAACD,MAAM;YAC1B,MAAME,gBAAgB,IAAI,CAAC,UAAU,CAAC,GAAG,CAACF;YAE1C,IAAIE,kBAAkBD,OAAO;gBACzB,MAAM,IAAIE,MAAM,CAAC,+CAA+C,EAAEH,IAAI,kFAAkF,EAAEE,cAAc,gBAAgB,EAAED,MAAM,CAAC,CAAC;YACtM;QACJ,OAAO;YACH,IAAI,CAAC,UAAU,CAAC,GAAG,CAACD,KAAKC;YAEzBL,YAAYA,CAAC,IAAI,CAAC,qBAAqB;QAC3C;IACJ;IAEA,aAAaQ,SAAwC,EAAE;QACnD,4EAA4E;QAC5E,IAAIL,OAAO,IAAI,CAACK,WAAW,MAAM,GAAG,GAAG;YACnC,KAAK,MAAM,CAACJ,KAAKC,MAAM,IAAIF,OAAO,OAAO,CAACK,WAAY;gBAClD,IAAI,CAAC,GAAG,CAACJ,KAA+BC;YAC5C;YAEAL,YAAYA,CAAC,IAAI,CAAC,qBAAqB;QAC3C;IACJ;IAEA,YAAYI,GAA2B,EAAE;QACrC,MAAMC,QAAQ,IAAI,CAAC,UAAU,CAAC,GAAG,CAACD;QAElC,IAAI,CAACC,OAAO;YACR,MAAM,IAAIE,MAAM,CAAC,kEAAkE,EAAEH,IAAI,EAAE,CAAC;QAChG;QAEA,OAAOC;IACX;IAEA,eAAe;QACX,OAAO,IAAI,CAAC,qBAAqB;IACrC;AACJ"}
+{"version":3,"file":"EnvironmentVariablesRegistry.js","sources":["../src/EnvironmentVariablesRegistry.ts"],"sourcesContent":["import memoize, { memoizeClear } from \"memoize\";\n\n// The \"EnvironmentVariables\" interface is expected to be extended by the consumer application.\n// This magic is called module augmentation: https://www.typescriptlang.org/docs/handbook/declaration-merging.html#module-augmentation.\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface EnvironmentVariables {}\n\nexport type EnvironmentVariableKey = keyof EnvironmentVariables;\n\nexport function typedEntries<T extends object>(obj: T) {\n    return Object.entries(obj) as Array<[keyof T, T[keyof T]]>;\n}\n\nexport class EnvironmentVariablesRegistry {\n    readonly #variables = new Map<EnvironmentVariableKey, unknown>();\n\n    // Since the \"getVariables\" function is transforming the variables from a Map to an Object, the result of\n    // the transformation is memoized to ensure the returned Object is immutable and can be use in React closures.\n    readonly #memoizedGetVariables = memoize(() => Object.fromEntries(this.#variables) as unknown as EnvironmentVariables);\n\n    add<T extends EnvironmentVariableKey>(key: T, value: EnvironmentVariables[T]) {\n        if (this.#variables.has(key)) {\n            const existingValue = this.#variables.get(key);\n\n            if (existingValue !== value) {\n                throw new Error(`[squide] An environment variable with the key \"${key}\" already exist and the new value differs from the existing one. Existing value: \"${existingValue}\" - New Value: \"${value}\"`);\n            }\n        } else {\n            this.#variables.set(key, value);\n\n            memoizeClear(this.#memoizedGetVariables);\n        }\n    }\n\n    addVariables(variables: Partial<EnvironmentVariables>) {\n        // Do not clear the \"getVariables\" memoize result if there are no variables.\n        if (Object.keys(variables).length > 0) {\n            for (const [key, value] of typedEntries(variables)) {\n                if (value) {\n                    this.add(key, value);\n                }\n            }\n\n            memoizeClear(this.#memoizedGetVariables);\n        }\n    }\n\n    getVariable<T extends EnvironmentVariableKey>(key: T) {\n        const value = this.#variables.get(key);\n\n        if (!value) {\n            throw new Error(`[squide] No environment variable has been registered for the key \"${key}\".`);\n        }\n\n        return value as EnvironmentVariables[T];\n    }\n\n    getVariables() {\n        return this.#memoizedGetVariables();\n    }\n}\n"],"names":["memoize","memoizeClear","typedEntries","obj","Object","EnvironmentVariablesRegistry","Map","key","value","existingValue","Error","variables"],"mappings":";;;;;AAAgD;AASzC,SAASE,aAA+BC,GAAM;IACjD,OAAOC,OAAO,OAAO,CAACD;AAC1B;AAEO,MAAME;IACA,UAAU,GAAG,IAAIC,MAAuC;IAEjE,yGAAyG;IACzG,8GAA8G;IACrG,qBAAqB,GAAGN,OAAOA,CAAC,IAAMI,OAAO,WAAW,CAAC,IAAI,CAAC,UAAU,GAAsC;IAEvH,IAAsCG,GAAM,EAAEC,KAA8B,EAAE;QAC1E,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAACD,MAAM;YAC1B,MAAME,gBAAgB,IAAI,CAAC,UAAU,CAAC,GAAG,CAACF;YAE1C,IAAIE,kBAAkBD,OAAO;gBACzB,MAAM,IAAIE,MAAM,CAAC,+CAA+C,EAAEH,IAAI,kFAAkF,EAAEE,cAAc,gBAAgB,EAAED,MAAM,CAAC,CAAC;YACtM;QACJ,OAAO;YACH,IAAI,CAAC,UAAU,CAAC,GAAG,CAACD,KAAKC;YAEzBP,YAAYA,CAAC,IAAI,CAAC,qBAAqB;QAC3C;IACJ;IAEA,aAAaU,SAAwC,EAAE;QACnD,4EAA4E;QAC5E,IAAIP,OAAO,IAAI,CAACO,WAAW,MAAM,GAAG,GAAG;YACnC,KAAK,MAAM,CAACJ,KAAKC,MAAM,IAAIN,aAAaS,WAAY;gBAChD,IAAIH,OAAO;oBACP,IAAI,CAAC,GAAG,CAACD,KAAKC;gBAClB;YACJ;YAEAP,YAAYA,CAAC,IAAI,CAAC,qBAAqB;QAC3C;IACJ;IAEA,YAA8CM,GAAM,EAAE;QAClD,MAAMC,QAAQ,IAAI,CAAC,UAAU,CAAC,GAAG,CAACD;QAElC,IAAI,CAACC,OAAO;YACR,MAAM,IAAIE,MAAM,CAAC,kEAAkE,EAAEH,IAAI,EAAE,CAAC;QAChG;QAEA,OAAOC;IACX;IAEA,eAAe;QACX,OAAO,IAAI,CAAC,qBAAqB;IACrC;AACJ"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { EnvironmentVariablesPlugin, EnvironmentVariablesPluginName, getEnvironmentVariablesPlugin, type EnvironmentVariablesPluginOptions } from "./EnvironmentVariablesPlugin.ts";
-export type { EnvironmentVariableKey, EnvironmentVariableValue, EnvironmentVariables } from "./EnvironmentVariablesRegistry.ts";
+export type { EnvironmentVariableKey, EnvironmentVariables } from "./EnvironmentVariablesRegistry.ts";
 export { useEnvironmentVariable, useEnvironmentVariables } from "./useEnvironmentVariable.ts";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["export { EnvironmentVariablesPlugin, EnvironmentVariablesPluginName, getEnvironmentVariablesPlugin, type EnvironmentVariablesPluginOptions } from \"./EnvironmentVariablesPlugin.ts\";\nexport type { EnvironmentVariableKey, EnvironmentVariableValue, EnvironmentVariables } from \"./EnvironmentVariablesRegistry.ts\";\nexport { useEnvironmentVariable, useEnvironmentVariables } from \"./useEnvironmentVariable.ts\";\n\n"],"names":["EnvironmentVariablesPlugin","EnvironmentVariablesPluginName","getEnvironmentVariablesPlugin","useEnvironmentVariable","useEnvironmentVariables"],"mappings":";;;;;;;;AAAoL;AAEtF"}
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["export { EnvironmentVariablesPlugin, EnvironmentVariablesPluginName, getEnvironmentVariablesPlugin, type EnvironmentVariablesPluginOptions } from \"./EnvironmentVariablesPlugin.ts\";\nexport type { EnvironmentVariableKey, EnvironmentVariables } from \"./EnvironmentVariablesRegistry.ts\";\nexport { useEnvironmentVariable, useEnvironmentVariables } from \"./useEnvironmentVariable.ts\";\n\n"],"names":["EnvironmentVariablesPlugin","EnvironmentVariablesPluginName","getEnvironmentVariablesPlugin","useEnvironmentVariable","useEnvironmentVariables"],"mappings":";;;;;;;;AAAoL;AAEtF"}

package/dist/useEnvironmentVariable.d.ts

@@ -1,3 +1,3 @@
 import type { EnvironmentVariableKey } from "./EnvironmentVariablesRegistry.ts";
-export declare function useEnvironmentVariable(key: EnvironmentVariableKey): never;
+export declare function useEnvironmentVariable<T extends EnvironmentVariableKey>(key: T): import("./EnvironmentVariablesRegistry.ts").EnvironmentVariables[T];
 export declare function useEnvironmentVariables(): import("./EnvironmentVariablesRegistry.ts").EnvironmentVariables;

package/dist/useEnvironmentVariable.js.map

@@ -1 +1 @@
-{"version":3,"file":"useEnvironmentVariable.js","sources":["../src/useEnvironmentVariable.ts"],"sourcesContent":["import { useRuntime } from \"@squide/core\";\nimport { getEnvironmentVariablesPlugin } from \"./EnvironmentVariablesPlugin.ts\";\nimport type { EnvironmentVariableKey } from \"./EnvironmentVariablesRegistry.ts\";\n\nexport function useEnvironmentVariable(key: EnvironmentVariableKey) {\n    const runtime = useRuntime();\n    const plugin = getEnvironmentVariablesPlugin(runtime);\n\n    return plugin.getVariable(key);\n}\n\nexport function useEnvironmentVariables() {\n    const runtime = useRuntime();\n    const plugin = getEnvironmentVariablesPlugin(runtime);\n\n    return plugin.getVariables();\n}\n"],"names":["useRuntime","getEnvironmentVariablesPlugin","useEnvironmentVariable","key","runtime","plugin","useEnvironmentVariables"],"mappings":";;;;;;;;AAA0C;AACsC;AAGzE,SAASE,uBAAuBC,GAA2B;IAC9D,MAAMC,UAAUJ,UAAUA;IAC1B,MAAMK,SAASJ,6BAA6BA,CAACG;IAE7C,OAAOC,OAAO,WAAW,CAACF;AAC9B;AAEO,SAASG;IACZ,MAAMF,UAAUJ,UAAUA;IAC1B,MAAMK,SAASJ,6BAA6BA,CAACG;IAE7C,OAAOC,OAAO,YAAY;AAC9B"}
+{"version":3,"file":"useEnvironmentVariable.js","sources":["../src/useEnvironmentVariable.ts"],"sourcesContent":["import { useRuntime } from \"@squide/core\";\nimport { getEnvironmentVariablesPlugin } from \"./EnvironmentVariablesPlugin.ts\";\nimport type { EnvironmentVariableKey } from \"./EnvironmentVariablesRegistry.ts\";\n\nexport function useEnvironmentVariable<T extends EnvironmentVariableKey>(key: T) {\n    const runtime = useRuntime();\n    const plugin = getEnvironmentVariablesPlugin(runtime);\n\n    return plugin.getVariable(key);\n}\n\nexport function useEnvironmentVariables() {\n    const runtime = useRuntime();\n    const plugin = getEnvironmentVariablesPlugin(runtime);\n\n    return plugin.getVariables();\n}\n"],"names":["useRuntime","getEnvironmentVariablesPlugin","useEnvironmentVariable","key","runtime","plugin","useEnvironmentVariables"],"mappings":";;;;;;;;AAA0C;AACsC;AAGzE,SAASE,uBAAyDC,GAAM;IAC3E,MAAMC,UAAUJ,UAAUA;IAC1B,MAAMK,SAASJ,6BAA6BA,CAACG;IAE7C,OAAOC,OAAO,WAAW,CAACF;AAC9B;AAEO,SAASG;IACZ,MAAMF,UAAUJ,UAAUA;IAC1B,MAAMK,SAASJ,6BAA6BA,CAACG;IAE7C,OAAOC,OAAO,YAAY;AAC9B"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@squide/env-vars",
   "author": "Workleap",
-  "version": "1.4.8",
+  "version": "1.4.10",
   "description": "Add support for environment variables to @squide application shell.",
   "license": "Apache-2.0",
   "repository": {
@@ -32,23 +32,23 @@
   "dependencies": {
     "@workleap/logging": "^1.3.2",
     "memoize": "^10.2.0",
-    "@squide/core": "6.1.5"
+    "@squide/core": "6.1.7"
   },
   "devDependencies": {
     "@eslint/js": "9.39.1",
-    "@rsbuild/core": "1.6.7",
-    "@rslib/core": "0.18.0",
-    "@types/react": "19.2.6",
-    "@typescript-eslint/parser": "8.47.0",
-    "@vitejs/plugin-react": "5.1.1",
-    "@workleap/eslint-configs": "1.1.5",
+    "@rsbuild/core": "1.6.14",
+    "@rslib/core": "0.18.4",
+    "@types/react": "19.2.7",
+    "@typescript-eslint/parser": "8.49.0",
+    "@vitejs/plugin-react": "5.1.2",
+    "@workleap/eslint-configs": "1.1.6",
     "@workleap/rslib-configs": "1.1.3",
     "@workleap/typescript-configs": "3.0.7",
     "eslint": "9.39.1",
-    "happy-dom": "20.0.10",
+    "happy-dom": "20.0.11",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.47.0",
-    "vitest": "4.0.10"
+    "typescript-eslint": "8.49.0",
+    "vitest": "4.0.15"
   },
   "sideEffects": false,
   "scripts": {

package/src/EnvironmentVariablesPlugin.ts

@@ -1,5 +1,5 @@
-import { isNil, Plugin, type Runtime } from "@squide/core";
-import { EnvironmentVariablesRegistry, type EnvironmentVariableKey, type EnvironmentVariables, type EnvironmentVariableValue } from "./EnvironmentVariablesRegistry.ts";
+import { Plugin, type Runtime } from "@squide/core";
+import { EnvironmentVariablesRegistry, type EnvironmentVariableKey, type EnvironmentVariables } from "./EnvironmentVariablesRegistry.ts";
 
 export const EnvironmentVariablesPluginName = "env-vars-plugin";
 
@@ -22,7 +22,7 @@ export class EnvironmentVariablesPlugin extends Plugin {
         }
     }
 
-    registerVariable(key: EnvironmentVariableKey, value: EnvironmentVariableValue) {
+    registerVariable<T extends EnvironmentVariableKey>(key: T, value: EnvironmentVariables[T]) {
         this.#environmentVariablesRegistry.add(key, value);
 
         this._runtime.logger.debug(`[squide] An environment variable for key "${key}" has been registered with the value "${value}".`);
@@ -37,7 +37,7 @@ export class EnvironmentVariablesPlugin extends Plugin {
             .debug();
     }
 
-    getVariable(key: EnvironmentVariableKey) {
+    getVariable<T extends EnvironmentVariableKey>(key: T) {
         return this.#environmentVariablesRegistry.getVariable(key);
     }
 
@@ -47,11 +47,13 @@ export class EnvironmentVariablesPlugin extends Plugin {
 }
 
 export function getEnvironmentVariablesPlugin(runtime: Runtime) {
-    const plugin = runtime.getPlugin(EnvironmentVariablesPluginName);
+    const plugin = runtime.getPlugin(EnvironmentVariablesPluginName, {
+        throwOnNotFound: false
+    }) as EnvironmentVariablesPlugin;
 
-    if (isNil(plugin)) {
-        throw new Error("[squide] The getEnvironmentVariablesPlugin function is called but no EnvironmentVariablesPlugin instance has been registered with the runtime.");
+    if (!plugin) {
+        throw new Error("[squide] The getEnvironmentVariablesPlugin function is called but no EnvironmentVariablesPlugin instance has been registered with the runtime. Did you provide a EnvironmentVariablesPlugin instance to the runtime instance?");
     }
 
-    return plugin as EnvironmentVariablesPlugin;
+    return plugin;
 }

package/src/EnvironmentVariablesRegistry.ts

@@ -1,21 +1,24 @@
 import memoize, { memoizeClear } from "memoize";
 
-// The "EnvironmentVariables" interface is expected to be extended by modules adding their own environment variables to the runtime.
+// The "EnvironmentVariables" interface is expected to be extended by the consumer application.
 // This magic is called module augmentation: https://www.typescriptlang.org/docs/handbook/declaration-merging.html#module-augmentation.
 // eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export interface EnvironmentVariables {}
 
 export type EnvironmentVariableKey = keyof EnvironmentVariables;
-export type EnvironmentVariableValue = EnvironmentVariables[keyof EnvironmentVariables];
+
+export function typedEntries<T extends object>(obj: T) {
+    return Object.entries(obj) as Array<[keyof T, T[keyof T]]>;
+}
 
 export class EnvironmentVariablesRegistry {
-    readonly #variables = new Map<EnvironmentVariableKey, EnvironmentVariableValue>();
+    readonly #variables = new Map<EnvironmentVariableKey, unknown>();
 
     // Since the "getVariables" function is transforming the variables from a Map to an Object, the result of
     // the transformation is memoized to ensure the returned Object is immutable and can be use in React closures.
     readonly #memoizedGetVariables = memoize(() => Object.fromEntries(this.#variables) as unknown as EnvironmentVariables);
 
-    add(key: EnvironmentVariableKey, value: EnvironmentVariableValue) {
+    add<T extends EnvironmentVariableKey>(key: T, value: EnvironmentVariables[T]) {
         if (this.#variables.has(key)) {
             const existingValue = this.#variables.get(key);
 
@@ -32,22 +35,24 @@ export class EnvironmentVariablesRegistry {
     addVariables(variables: Partial<EnvironmentVariables>) {
         // Do not clear the "getVariables" memoize result if there are no variables.
         if (Object.keys(variables).length > 0) {
-            for (const [key, value] of Object.entries(variables)) {
-                this.add(key as EnvironmentVariableKey, value as EnvironmentVariableValue);
+            for (const [key, value] of typedEntries(variables)) {
+                if (value) {
+                    this.add(key, value);
+                }
             }
 
             memoizeClear(this.#memoizedGetVariables);
         }
     }
 
-    getVariable(key: EnvironmentVariableKey) {
+    getVariable<T extends EnvironmentVariableKey>(key: T) {
         const value = this.#variables.get(key);
 
         if (!value) {
             throw new Error(`[squide] No environment variable has been registered for the key "${key}".`);
         }
 
-        return value;
+        return value as EnvironmentVariables[T];
     }
 
     getVariables() {

package/src/index.ts

@@ -1,4 +1,4 @@
 export { EnvironmentVariablesPlugin, EnvironmentVariablesPluginName, getEnvironmentVariablesPlugin, type EnvironmentVariablesPluginOptions } from "./EnvironmentVariablesPlugin.ts";
-export type { EnvironmentVariableKey, EnvironmentVariableValue, EnvironmentVariables } from "./EnvironmentVariablesRegistry.ts";
+export type { EnvironmentVariableKey, EnvironmentVariables } from "./EnvironmentVariablesRegistry.ts";
 export { useEnvironmentVariable, useEnvironmentVariables } from "./useEnvironmentVariable.ts";
 

package/src/useEnvironmentVariable.ts

@@ -2,7 +2,7 @@ import { useRuntime } from "@squide/core";
 import { getEnvironmentVariablesPlugin } from "./EnvironmentVariablesPlugin.ts";
 import type { EnvironmentVariableKey } from "./EnvironmentVariablesRegistry.ts";
 
-export function useEnvironmentVariable(key: EnvironmentVariableKey) {
+export function useEnvironmentVariable<T extends EnvironmentVariableKey>(key: T) {
     const runtime = useRuntime();
     const plugin = getEnvironmentVariablesPlugin(runtime);