@reykjavik/webtools 0.3.13 → 0.3.15

package/CHANGELOG.md

@@ -4,20 +4,23 @@
 
 - ... <!-- Add new lines here. -->
 
-## 0.3.13
+## 0.3.15
 
-_2026-03-17_
+_2026-03-18_
 
 - `@reykjavik/webtools/alertsStore`:
-  - feat: Add "message-only" shorthand signature to alerter dispatcher methods
+  - feat: Support `defaultDuration` object w durations for each alert `level`
+  - feat: Bump the default `defaultDuration` to `'MEDIUM'` (more reasonable)
 
-## 0.3.12
+## 0.3.12 – 0.3.14
 
 _2026-03-17_
 
 - `@reykjavik/webtools/alertsStore`:
-  - feat: Make alert `type` property disabled by default, enabled via config
   - feat: Add `AlerterConfig.title?:boolean` to enable optional alert `title`s
+  - feat: Add "message-only" shorthand signature to alerter dispatcher methods
+  - feat: Make alert `type` property disabled by default, enabled via config
+    (never used in the wild, yet)
 
 ## 0.3.7 – 0.3.11
 

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.
      *
@@ -206,7 +209,9 @@ export declare const createAlerterStore: <Level extends string = (typeof default
  *
  * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#createalerterstore
  */
-export type InferAlerterPayload<F extends Record<string, (...args: Array<any>) => void>> = F extends Record<string, (payload: infer P) => void> ? P : never;
+export type InferAlerterPayload<F extends Record<string, (...args: Array<any>) => void>> = F extends Record<string, (payload: infer P) => void> ? Extract<P, {
+    message: unknown;
+}> : never;
 /**
  * Utility type for inferring the alert info object shape received by the
  * callbacks of a specific alerter `subscribe` function.

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,7 +72,7 @@ const defaultDurations = {
     XLONG: 32000,
     INDEFINITE: 0,
 };
-const defaultDefaultDuration = 'SHORT';
+const DEFAULT_DEFAULT_DURATION = 'MEDIUM';
 const storeKeys = {};
 /**
  * Factory function that creates an alerter store singleton with optional
@@ -81,8 +81,9 @@ 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;
+    const STORE_KEY = cfg.key || DEFAULT_KEY;
     if (storeKeys[STORE_KEY]) {
         throw new Error(`An alerter store with key "${STORE_KEY}" already exists.`);
     }
@@ -90,9 +91,14 @@ const createAlerterStore = (cfg = {}) => {
     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 +183,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,

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.
      *
@@ -206,7 +209,9 @@ export declare const createAlerterStore: <Level extends string = (typeof default
  *
  * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#createalerterstore
  */
-export type InferAlerterPayload<F extends Record<string, (...args: Array<any>) => void>> = F extends Record<string, (payload: infer P) => void> ? P : never;
+export type InferAlerterPayload<F extends Record<string, (...args: Array<any>) => void>> = F extends Record<string, (payload: infer P) => void> ? Extract<P, {
+    message: unknown;
+}> : never;
 /**
  * Utility type for inferring the alert info object shape received by the
  * callbacks of a specific alerter `subscribe` function.

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,7 +36,7 @@ const defaultDurations = {
     XLONG: 32000,
     INDEFINITE: 0,
 };
-const defaultDefaultDuration = 'SHORT';
+const DEFAULT_DEFAULT_DURATION = 'MEDIUM';
 const storeKeys = {};
 /**
  * Factory function that creates an alerter store singleton with optional
@@ -45,8 +45,9 @@ 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;
+    const STORE_KEY = cfg.key || DEFAULT_KEY;
     if (storeKeys[STORE_KEY]) {
         throw new Error(`An alerter store with key "${STORE_KEY}" already exists.`);
     }
@@ -54,9 +55,14 @@ export const createAlerterStore = (cfg = {}) => {
     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 +147,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,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@reykjavik/webtools",
-	"version": "0.3.13",
+	"version": "0.3.15",
 	"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",