@reykjavik/webtools 0.3.15 → 0.3.16

package/CHANGELOG.md

@@ -4,6 +4,14 @@
 
 - ... <!-- Add new lines here. -->
 
+## 0.3.16
+
+_2026-03-18_
+
+- `@reykjavik/webtools/alertsStore`:
+  - feat: console.warn instead of throwing when recreating an extisting store
+    — return old store instead of creating a new one.
+
 ## 0.3.15
 
 _2026-03-18_

package/alertsStore/index.d.ts

@@ -114,16 +114,6 @@ export type AlerterConfig<Level extends string = (typeof defaultAlertLevels)[num
  * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#createalerterstore
  */
 export declare const createAlerterStore: <Level extends string = (typeof defaultAlertLevels)[number], Type extends string = string, Flag extends string = string, Title extends boolean = false, Duration extends string = keyof typeof defaultDurations>(cfg?: AlerterConfig<Level, Type, Flag, Title, Duration>) => {
-    /**
-     * Singleton object with methods for showing alerts of different levels.
-     * Pass a payload object to the method of the level you want to dispatch,
-     * and the alert will be added to the store.
-     *
-     * Use `subscribeToAlerts` elsewhere in the app to subscribe to alert
-     * notifications and display them.
-     *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#createalerterstore
-     */
     alerter: Record<Level, (payload: AlertMessage | ({
         /**
          * A simple string containing the alert message.
@@ -167,18 +157,6 @@ export declare const createAlerterStore: <Level extends string = (typeof default
          */
         type?: Type;
     }))) => void>;
-    /**
-     * Subscribes to alert events. The provided callback will be called whenever a
-     * alert is added or cleared.
-     *
-     * The callback is called immediately upon subscription if there are already
-     * active alerts.
-     *
-     * Returns an unsubscribe function that can be called to stop receiving alert
-     * events.
-     *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#createalerterstore
-     */
     subscribe: (callback: (notifications: Array<{
         level: Level;
         message: AlertMessage;

package/alertsStore/index.js

@@ -73,7 +73,7 @@ const defaultDurations = {
     INDEFINITE: 0,
 };
 const DEFAULT_DEFAULT_DURATION = 'MEDIUM';
-const storeKeys = {};
+const storeStore = {};
 /**
  * Factory function that creates an alerter store singleton with optional
  * configuration for the genarated alerts.
@@ -84,10 +84,13 @@ const storeKeys = {};
 // eslint-disable-next-line complexity
 const createAlerterStore = (cfg = {}) => {
     const STORE_KEY = cfg.key || DEFAULT_KEY;
-    if (storeKeys[STORE_KEY]) {
-        throw new Error(`An alerter store with key "${STORE_KEY}" already exists.`);
+    if (storeStore[STORE_KEY]) {
+        process.env.NODE_ENV !== 'production' &&
+            console.warn(`An alerter store with key "${STORE_KEY}" already exists.\n` +
+                `Returning the existing store, which may have been configured differently.\n` +
+                `Make sure to use unique keys if you want multiple independent stores.`);
+        return storeStore[STORE_KEY];
     }
-    storeKeys[STORE_KEY] = true;
     const storgae = cfg.storage || (typeof sessionStorage !== 'undefined' ? sessionStorage : undefined);
     const alertLevels = cfg.levels || defaultAlertLevels;
     const durations = cfg.durations || defaultDurations;
@@ -304,7 +307,7 @@ const createAlerterStore = (cfg = {}) => {
             // Save the (possibly) cleaned up alerts back to the storage, because why not. :-D
             _saveAlertsToStorage();
         })();
-    return {
+    return (storeStore[STORE_KEY] = {
         /**
          * Singleton object with methods for showing alerts of different levels.
          * Pass a payload object to the method of the level you want to dispatch,
@@ -329,6 +332,6 @@ const createAlerterStore = (cfg = {}) => {
          * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#createalerterstore
          */
         subscribe,
-    };
+    });
 };
 exports.createAlerterStore = createAlerterStore;

package/esm/alertsStore/index.d.ts

@@ -114,16 +114,6 @@ export type AlerterConfig<Level extends string = (typeof defaultAlertLevels)[num
  * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#createalerterstore
  */
 export declare const createAlerterStore: <Level extends string = (typeof defaultAlertLevels)[number], Type extends string = string, Flag extends string = string, Title extends boolean = false, Duration extends string = keyof typeof defaultDurations>(cfg?: AlerterConfig<Level, Type, Flag, Title, Duration>) => {
-    /**
-     * Singleton object with methods for showing alerts of different levels.
-     * Pass a payload object to the method of the level you want to dispatch,
-     * and the alert will be added to the store.
-     *
-     * Use `subscribeToAlerts` elsewhere in the app to subscribe to alert
-     * notifications and display them.
-     *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#createalerterstore
-     */
     alerter: Record<Level, (payload: AlertMessage | ({
         /**
          * A simple string containing the alert message.
@@ -167,18 +157,6 @@ export declare const createAlerterStore: <Level extends string = (typeof default
          */
         type?: Type;
     }))) => void>;
-    /**
-     * Subscribes to alert events. The provided callback will be called whenever a
-     * alert is added or cleared.
-     *
-     * The callback is called immediately upon subscription if there are already
-     * active alerts.
-     *
-     * Returns an unsubscribe function that can be called to stop receiving alert
-     * events.
-     *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#createalerterstore
-     */
     subscribe: (callback: (notifications: Array<{
         level: Level;
         message: AlertMessage;

package/esm/alertsStore/index.js

@@ -37,7 +37,7 @@ const defaultDurations = {
     INDEFINITE: 0,
 };
 const DEFAULT_DEFAULT_DURATION = 'MEDIUM';
-const storeKeys = {};
+const storeStore = {};
 /**
  * Factory function that creates an alerter store singleton with optional
  * configuration for the genarated alerts.
@@ -48,10 +48,13 @@ const storeKeys = {};
 // eslint-disable-next-line complexity
 export const createAlerterStore = (cfg = {}) => {
     const STORE_KEY = cfg.key || DEFAULT_KEY;
-    if (storeKeys[STORE_KEY]) {
-        throw new Error(`An alerter store with key "${STORE_KEY}" already exists.`);
+    if (storeStore[STORE_KEY]) {
+        process.env.NODE_ENV !== 'production' &&
+            console.warn(`An alerter store with key "${STORE_KEY}" already exists.\n` +
+                `Returning the existing store, which may have been configured differently.\n` +
+                `Make sure to use unique keys if you want multiple independent stores.`);
+        return storeStore[STORE_KEY];
     }
-    storeKeys[STORE_KEY] = true;
     const storgae = cfg.storage || (typeof sessionStorage !== 'undefined' ? sessionStorage : undefined);
     const alertLevels = cfg.levels || defaultAlertLevels;
     const durations = cfg.durations || defaultDurations;
@@ -268,7 +271,7 @@ export const createAlerterStore = (cfg = {}) => {
             // Save the (possibly) cleaned up alerts back to the storage, because why not. :-D
             _saveAlertsToStorage();
         })();
-    return {
+    return (storeStore[STORE_KEY] = {
         /**
          * Singleton object with methods for showing alerts of different levels.
          * Pass a payload object to the method of the level you want to dispatch,
@@ -293,5 +296,5 @@ export const createAlerterStore = (cfg = {}) => {
          * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#createalerterstore
          */
         subscribe,
-    };
+    });
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@reykjavik/webtools",
-	"version": "0.3.15",
+	"version": "0.3.16",
 	"description": "Misc. JS/TS helpers used by Reykjavík City's web dev teams.",
 	"main": "index.js",
 	"repository": "ssh://git@github.com:reykjavikcity/webtools.git",