@reykjavik/webtools 0.3.14 → 0.3.16

package/CHANGELOG.md

@@ -4,14 +4,23 @@
 
 - ... <!-- Add new lines here. -->
 
-## 0.3.14
+## 0.3.16
 
-_2026-03-17_
+_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_
 
 - `@reykjavik/webtools/alertsStore`:
-  - fix: Regression in `InferAlerterPayload` type
+  - feat: Support `defaultDuration` object w durations for each alert `level`
+  - feat: Bump the default `defaultDuration` to `'MEDIUM'` (more reasonable)
 
-## 0.3.12 – 0.3.13
+## 0.3.12 – 0.3.14
 
 _2026-03-17_
 

package/README.md

@@ -1129,10 +1129,12 @@ The configuration options are as follows:
   Default:
   `{ BLINK: 2_000, SHORT: 4_000, MEDIUM: 8_000, LONG: 16_000, XLONG: 32_000, INDEFINITE: 0 }`.
 
-- **`defaultDuration?: string`**  
+- **`defaultDuration?: string | Record<Level, Duration>`**  
   The duration to use for alerts if no duration is specified when
   dispatching.  
-  Default: `SHORT` if using the default durations, otherwise the default is
+  You can also pass an object with different default durations for each alert
+  level, e.g. longer defaults for "errors" than "success" alerts.  
+  Default: `MEDIUM` if using the default durations, otherwise the default is
   `0` (indefinite)
 
 - **`storage?: Pick<Storage, 'getItem' | 'setItem'>`**  

package/alertsStore/index.d.ts

@@ -85,10 +85,13 @@ export type AlerterConfig<Level extends string = (typeof defaultAlertLevels)[num
      * Default duration to use for alerts if no duration is specified when
      * dispatching.
      *
-     * Default: `SHORT` if using the default durations, otherwise the default
+     * You can also pass an object with different default durations for each
+     * alert level, e.g. longer defaults for "errors" than "success" alerts.
+     *
+     * Default: `MEDIUM` if using the default durations, otherwise the default
      * is `0` (indefinite)
      */
-    defaultDuration?: Durations extends Record<infer D, number> ? D : never;
+    defaultDuration?: (Durations extends Record<infer D, number> ? (D extends string ? D : never) : never) | Record<Level, Durations extends Record<infer D, number> ? (D extends string ? D : never) : never>;
     /**
      * Whether to allow an optional `title` property on alerts.
      *
@@ -111,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.
@@ -164,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

@@ -62,7 +62,7 @@ const messageSchema = v.union([
     ])),
 ]);
 // ---------------------------------------------------------------------------
-const defaultKey = 'app~alerts';
+const DEFAULT_KEY = 'app~alerts';
 const defaultAlertLevels = ['info', 'warning', 'success', 'error'];
 const defaultDurations = {
     BLINK: 2000,
@@ -72,8 +72,8 @@ const defaultDurations = {
     XLONG: 32000,
     INDEFINITE: 0,
 };
-const defaultDefaultDuration = 'SHORT';
-const storeKeys = {};
+const DEFAULT_DEFAULT_DURATION = 'MEDIUM';
+const storeStore = {};
 /**
  * Factory function that creates an alerter store singleton with optional
  * configuration for the genarated alerts.
@@ -81,18 +81,27 @@ const storeKeys = {};
  * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#createalerterstore
  */
 /*#__NO_SIDE_EFFECTS__*/
+// eslint-disable-next-line complexity
 const createAlerterStore = (cfg = {}) => {
-    const STORE_KEY = cfg.key || defaultKey;
-    if (storeKeys[STORE_KEY]) {
-        throw new Error(`An alerter store with key "${STORE_KEY}" already exists.`);
+    const STORE_KEY = cfg.key || DEFAULT_KEY;
+    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;
-    const DEFAULT_DURATION = cfg.durations
+    const defaultDurationsByLevel = cfg.defaultDuration && typeof cfg.defaultDuration !== 'string'
         ? cfg.defaultDuration
-        : defaultDefaultDuration;
+        : undefined;
+    const defaultDuration = !cfg.durations
+        ? DEFAULT_DEFAULT_DURATION
+        : typeof cfg.defaultDuration === 'string'
+            ? cfg.defaultDuration
+            : undefined;
     const _notificationSchema = v.object({
         level: v.picklist(alertLevels),
         title: cfg.title ? v.optional(v.string()) : v.never(),
@@ -177,7 +186,10 @@ const createAlerterStore = (cfg = {}) => {
     const buildNotification = (_payload, level) => {
         // Strip away duration and delay (not part of the notification object)
         const { duration, delay, ...payload } = _payload;
-        const durationMs = durations[(duration || DEFAULT_DURATION || '')] || 0;
+        const durationMs = durations[duration ||
+            (defaultDurationsByLevel &&
+                defaultDurationsByLevel[level]) ||
+            (defaultDuration || '')];
         return {
             ...payload,
             level,
@@ -295,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,
@@ -320,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

@@ -85,10 +85,13 @@ export type AlerterConfig<Level extends string = (typeof defaultAlertLevels)[num
      * Default duration to use for alerts if no duration is specified when
      * dispatching.
      *
-     * Default: `SHORT` if using the default durations, otherwise the default
+     * You can also pass an object with different default durations for each
+     * alert level, e.g. longer defaults for "errors" than "success" alerts.
+     *
+     * Default: `MEDIUM` if using the default durations, otherwise the default
      * is `0` (indefinite)
      */
-    defaultDuration?: Durations extends Record<infer D, number> ? D : never;
+    defaultDuration?: (Durations extends Record<infer D, number> ? (D extends string ? D : never) : never) | Record<Level, Durations extends Record<infer D, number> ? (D extends string ? D : never) : never>;
     /**
      * Whether to allow an optional `title` property on alerts.
      *
@@ -111,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.
@@ -164,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

@@ -26,7 +26,7 @@ const messageSchema = v.union([
     ])),
 ]);
 // ---------------------------------------------------------------------------
-const defaultKey = 'app~alerts';
+const DEFAULT_KEY = 'app~alerts';
 const defaultAlertLevels = ['info', 'warning', 'success', 'error'];
 const defaultDurations = {
     BLINK: 2000,
@@ -36,8 +36,8 @@ const defaultDurations = {
     XLONG: 32000,
     INDEFINITE: 0,
 };
-const defaultDefaultDuration = 'SHORT';
-const storeKeys = {};
+const DEFAULT_DEFAULT_DURATION = 'MEDIUM';
+const storeStore = {};
 /**
  * Factory function that creates an alerter store singleton with optional
  * configuration for the genarated alerts.
@@ -45,18 +45,27 @@ const storeKeys = {};
  * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#createalerterstore
  */
 /*#__NO_SIDE_EFFECTS__*/
+// eslint-disable-next-line complexity
 export const createAlerterStore = (cfg = {}) => {
-    const STORE_KEY = cfg.key || defaultKey;
-    if (storeKeys[STORE_KEY]) {
-        throw new Error(`An alerter store with key "${STORE_KEY}" already exists.`);
+    const STORE_KEY = cfg.key || DEFAULT_KEY;
+    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;
-    const DEFAULT_DURATION = cfg.durations
+    const defaultDurationsByLevel = cfg.defaultDuration && typeof cfg.defaultDuration !== 'string'
         ? cfg.defaultDuration
-        : defaultDefaultDuration;
+        : undefined;
+    const defaultDuration = !cfg.durations
+        ? DEFAULT_DEFAULT_DURATION
+        : typeof cfg.defaultDuration === 'string'
+            ? cfg.defaultDuration
+            : undefined;
     const _notificationSchema = v.object({
         level: v.picklist(alertLevels),
         title: cfg.title ? v.optional(v.string()) : v.never(),
@@ -141,7 +150,10 @@ export const createAlerterStore = (cfg = {}) => {
     const buildNotification = (_payload, level) => {
         // Strip away duration and delay (not part of the notification object)
         const { duration, delay, ...payload } = _payload;
-        const durationMs = durations[(duration || DEFAULT_DURATION || '')] || 0;
+        const durationMs = durations[duration ||
+            (defaultDurationsByLevel &&
+                defaultDurationsByLevel[level]) ||
+            (defaultDuration || '')];
         return {
             ...payload,
             level,
@@ -259,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,
@@ -284,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.14",
+	"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",