@dloizides/utils 1.0.2 → 1.2.0

package/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2026-07-18
+
+### Added
+
+- `setRedirectHandler(handler)` / `redirectTo(path)` / `resetRedirectHandler()` — a
+  framework-agnostic redirect escape hatch for non-React callers (axios 401 interceptors,
+  auth providers) that need to navigate without a router hook. Falls back through
+  registered handler → `window.location.replace` → a queue drained when the router mounts,
+  and forces a hard navigation if the router silently failed to change the URL.
+  Promoted from the byte-identical `lib/navigation.ts` twins in erevna-web and
+  katalogos-web (de-fork wave W1.1). Also exported as the `navigation` namespace.
+
+### Fixed
+
+- The promoted watchdog guarded its `window` access with `try`/`catch` only; it now checks
+  `typeof window !== 'undefined'` explicitly, so a non-browser host cannot reach a
+  `ReferenceError` path at all. Surfaced by porting the code into a package whose tsconfig
+  has no `DOM` lib.
+
+## [1.1.0] - 2026-06-15
+
+### Added
+
+- `getErrorMessage(value, fallback?)` — extract a human-readable message from any error shape
+  (Error / string / `{message}`). Consolidates the duplicated app-side `errorMessage` helper.
+- `formatDate(date, locale, options?)` — locale-aware date formatting (pure; caller supplies the
+  locale, e.g. from i18n). Backs the apps' `FD` helper. (Capability Wave C1, batch 6.)
+
 ## [1.0.0] - 2024-01-27
 
 ### Added

package/dist/index.d.mts

@@ -1,2 +1,78 @@
 export { i as guards, a as isEmptyArray, b as isEmptyString, c as isNotEmptyArray, d as isNotEmptyString, e as isNullOrUndefined, f as isValueDefined } from './index-Dge_3DNw.mjs';
 export { a as assertDefined, i as assertions } from './index-DmagV9KM.mjs';
+
+/**
+ * Extracts a human-readable error message from various error shapes
+ * (Error, string, or an object with a `message` property).
+ *
+ * @param value - The error value.
+ * @param fallback - Returned when no message can be extracted (default: 'Unknown error').
+ */
+declare function getErrorMessage(value: unknown, fallback?: string): string;
+
+/**
+ * Locale-aware date formatting (pure — the caller supplies the locale, e.g. from i18n).
+ * Returns '' for null/undefined; falls back to the ISO date if Intl formatting throws.
+ *
+ * @example formatDate(new Date(), 'en')                              // "6/15/2024"
+ * @example formatDate(new Date(), 'en', { year: 'numeric', month: 'long' }) // "June 2024"
+ * @example formatDate(null, 'en')                                    // ""
+ */
+declare function formatDate(date: Date | null | undefined, locale: string, options?: Intl.DateTimeFormatOptions): string;
+
+/**
+ * Framework-agnostic redirect escape hatch.
+ *
+ * WHY THIS EXISTS: non-React code (an axios 401 interceptor, an auth provider's
+ * token-refresh failure path) needs to navigate, but has no access to a router
+ * hook. The app registers its router's push/replace once via `setRedirectHandler`;
+ * everything else calls `redirectTo` and does not care which router is mounted.
+ *
+ * Three layers of fallback, in order:
+ *  1. the registered handler (the app's router),
+ *  2. `window.location.replace` if no handler is registered yet,
+ *  3. a queue, drained on the next `setRedirectHandler` call — so a redirect fired
+ *     before the router mounts is not silently dropped.
+ *
+ * Layer 1 additionally schedules a watchdog: some routers accept a `push` for a
+ * route they cannot resolve and leave the URL untouched, which strands the user on
+ * the page they were supposed to leave. If the location has not changed after
+ * `NAVIGATION_CHECK_DELAY_MS`, a hard `window.location.replace` is forced.
+ *
+ * Promoted from the byte-identical `lib/navigation.ts` twins in erevna-web and
+ * katalogos-web. Pure DOM + timers — no React, no router, no framework import.
+ */
+/**
+ * Register the app's router navigate function and drain any redirects that were
+ * queued before it mounted. Call once, from the root layout.
+ */
+declare function setRedirectHandler(h: (path: string) => void): void;
+/**
+ * Navigate to `path` from anywhere, including outside React.
+ * Safe to call before the router mounts — the redirect is queued and replayed.
+ */
+declare function redirectTo(path: string): void;
+/**
+ * Clear the registered handler and any queued redirects.
+ * Exists for tests — module state otherwise leaks between cases.
+ */
+declare function resetRedirectHandler(): void;
+
+declare const index$2_getErrorMessage: typeof getErrorMessage;
+declare namespace index$2 {
+  export { index$2_getErrorMessage as getErrorMessage };
+}
+
+declare const index$1_formatDate: typeof formatDate;
+declare namespace index$1 {
+  export { index$1_formatDate as formatDate };
+}
+
+declare const index_redirectTo: typeof redirectTo;
+declare const index_resetRedirectHandler: typeof resetRedirectHandler;
+declare const index_setRedirectHandler: typeof setRedirectHandler;
+declare namespace index {
+  export { index_redirectTo as redirectTo, index_resetRedirectHandler as resetRedirectHandler, index_setRedirectHandler as setRedirectHandler };
+}
+
+export { index$2 as error, index$1 as format, formatDate, getErrorMessage, index as navigation, redirectTo, resetRedirectHandler, setRedirectHandler };

package/dist/index.d.ts

@@ -1,2 +1,78 @@
 export { i as guards, a as isEmptyArray, b as isEmptyString, c as isNotEmptyArray, d as isNotEmptyString, e as isNullOrUndefined, f as isValueDefined } from './index-Dge_3DNw.js';
 export { a as assertDefined, i as assertions } from './index-DmagV9KM.js';
+
+/**
+ * Extracts a human-readable error message from various error shapes
+ * (Error, string, or an object with a `message` property).
+ *
+ * @param value - The error value.
+ * @param fallback - Returned when no message can be extracted (default: 'Unknown error').
+ */
+declare function getErrorMessage(value: unknown, fallback?: string): string;
+
+/**
+ * Locale-aware date formatting (pure — the caller supplies the locale, e.g. from i18n).
+ * Returns '' for null/undefined; falls back to the ISO date if Intl formatting throws.
+ *
+ * @example formatDate(new Date(), 'en')                              // "6/15/2024"
+ * @example formatDate(new Date(), 'en', { year: 'numeric', month: 'long' }) // "June 2024"
+ * @example formatDate(null, 'en')                                    // ""
+ */
+declare function formatDate(date: Date | null | undefined, locale: string, options?: Intl.DateTimeFormatOptions): string;
+
+/**
+ * Framework-agnostic redirect escape hatch.
+ *
+ * WHY THIS EXISTS: non-React code (an axios 401 interceptor, an auth provider's
+ * token-refresh failure path) needs to navigate, but has no access to a router
+ * hook. The app registers its router's push/replace once via `setRedirectHandler`;
+ * everything else calls `redirectTo` and does not care which router is mounted.
+ *
+ * Three layers of fallback, in order:
+ *  1. the registered handler (the app's router),
+ *  2. `window.location.replace` if no handler is registered yet,
+ *  3. a queue, drained on the next `setRedirectHandler` call — so a redirect fired
+ *     before the router mounts is not silently dropped.
+ *
+ * Layer 1 additionally schedules a watchdog: some routers accept a `push` for a
+ * route they cannot resolve and leave the URL untouched, which strands the user on
+ * the page they were supposed to leave. If the location has not changed after
+ * `NAVIGATION_CHECK_DELAY_MS`, a hard `window.location.replace` is forced.
+ *
+ * Promoted from the byte-identical `lib/navigation.ts` twins in erevna-web and
+ * katalogos-web. Pure DOM + timers — no React, no router, no framework import.
+ */
+/**
+ * Register the app's router navigate function and drain any redirects that were
+ * queued before it mounted. Call once, from the root layout.
+ */
+declare function setRedirectHandler(h: (path: string) => void): void;
+/**
+ * Navigate to `path` from anywhere, including outside React.
+ * Safe to call before the router mounts — the redirect is queued and replayed.
+ */
+declare function redirectTo(path: string): void;
+/**
+ * Clear the registered handler and any queued redirects.
+ * Exists for tests — module state otherwise leaks between cases.
+ */
+declare function resetRedirectHandler(): void;
+
+declare const index$2_getErrorMessage: typeof getErrorMessage;
+declare namespace index$2 {
+  export { index$2_getErrorMessage as getErrorMessage };
+}
+
+declare const index$1_formatDate: typeof formatDate;
+declare namespace index$1 {
+  export { index$1_formatDate as formatDate };
+}
+
+declare const index_redirectTo: typeof redirectTo;
+declare const index_resetRedirectHandler: typeof resetRedirectHandler;
+declare const index_setRedirectHandler: typeof setRedirectHandler;
+declare namespace index {
+  export { index_redirectTo as redirectTo, index_resetRedirectHandler as resetRedirectHandler, index_setRedirectHandler as setRedirectHandler };
+}
+
+export { index$2 as error, index$1 as format, formatDate, getErrorMessage, index as navigation, redirectTo, resetRedirectHandler, setRedirectHandler };

package/dist/index.js

@@ -43,6 +43,110 @@ function assertDefined(value, message) {
   }
 }
 
+// src/error/getErrorMessage.ts
+function isErrorWithMessage(value) {
+  return typeof value === "object" && isValueDefined(value) && "message" in value;
+}
+function getErrorMessage(value, fallback = "Unknown error") {
+  if (value instanceof Error) {
+    return value.message;
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  if (isErrorWithMessage(value)) {
+    const message = value.message;
+    if (typeof message === "string" && message.length > 0) {
+      return message;
+    }
+  }
+  return fallback;
+}
+
+// src/format/formatDate.ts
+function formatDate(date, locale, options) {
+  if (date === null || date === void 0) {
+    return "";
+  }
+  const resolvedLocale = locale !== "" ? locale : "en";
+  try {
+    return new Intl.DateTimeFormat(resolvedLocale, options).format(date);
+  } catch {
+    return date.toISOString().split("T")[0] ?? "";
+  }
+}
+
+// src/navigation/redirect.ts
+var NAVIGATION_CHECK_DELAY_MS = 150;
+var redirectHandler = null;
+var queuedRedirects = [];
+function normalizeRouterPath(path) {
+  const normalized = path.replace(/\/\([^/]+\)/g, "");
+  return normalized === "" ? "/" : normalized;
+}
+function getCurrentLocation() {
+  if (typeof window === "undefined") {
+    return null;
+  }
+  return `${window.location.pathname}${window.location.search}${window.location.hash}`;
+}
+function scheduleFallbackNavigation(before, normalized) {
+  setTimeout(() => {
+    try {
+      const after = getCurrentLocation();
+      if (after === before && typeof window !== "undefined") {
+        window.location.replace(normalized);
+      }
+    } catch {
+    }
+  }, NAVIGATION_CHECK_DELAY_MS);
+}
+function tryWindowNavigation(normalized) {
+  if (typeof window === "undefined") {
+    return false;
+  }
+  try {
+    window.location.replace(normalized);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function setRedirectHandler(h) {
+  redirectHandler = h;
+  while (queuedRedirects.length > 0) {
+    const p = queuedRedirects.shift();
+    try {
+      if (typeof p === "string" && p.length > 0) {
+        h(normalizeRouterPath(p));
+      }
+    } catch {
+    }
+  }
+}
+function redirectTo(path) {
+  const normalized = normalizeRouterPath(path);
+  if (redirectHandler) {
+    const before = getCurrentLocation();
+    try {
+      redirectHandler(normalized);
+      if (typeof before === "string") {
+        scheduleFallbackNavigation(before, normalized);
+      }
+      return;
+    } catch {
+    }
+  }
+  if (tryWindowNavigation(normalized)) {
+    return;
+  }
+  queuedRedirects.push(normalized);
+}
+function resetRedirectHandler() {
+  redirectHandler = null;
+  queuedRedirects.length = 0;
+}
+
 // src/guards/index.ts
 var guards_exports = {};
 __export(guards_exports, {
@@ -60,8 +164,32 @@ __export(assertions_exports, {
   assertDefined: () => assertDefined
 });
 
+// src/error/index.ts
+var error_exports = {};
+__export(error_exports, {
+  getErrorMessage: () => getErrorMessage
+});
+
+// src/format/index.ts
+var format_exports = {};
+__export(format_exports, {
+  formatDate: () => formatDate
+});
+
+// src/navigation/index.ts
+var navigation_exports = {};
+__export(navigation_exports, {
+  redirectTo: () => redirectTo,
+  resetRedirectHandler: () => resetRedirectHandler,
+  setRedirectHandler: () => setRedirectHandler
+});
+
 exports.assertDefined = assertDefined;
 exports.assertions = assertions_exports;
+exports.error = error_exports;
+exports.format = format_exports;
+exports.formatDate = formatDate;
+exports.getErrorMessage = getErrorMessage;
 exports.guards = guards_exports;
 exports.isEmptyArray = isEmptyArray;
 exports.isEmptyString = isEmptyString;
@@ -69,5 +197,9 @@ exports.isNotEmptyArray = isNotEmptyArray;
 exports.isNotEmptyString = isNotEmptyString;
 exports.isNullOrUndefined = isNullOrUndefined;
 exports.isValueDefined = isValueDefined;
+exports.navigation = navigation_exports;
+exports.redirectTo = redirectTo;
+exports.resetRedirectHandler = resetRedirectHandler;
+exports.setRedirectHandler = setRedirectHandler;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/guards/isValueDefined.ts","../src/guards/isNotEmptyArray.ts","../src/guards/isNotEmptyString.ts","../src/guards/isNullOrUndefined.ts","../src/guards/isEmptyArray.ts","../src/guards/isEmptyString.ts","../src/assertions/assertDefined.ts","../src/guards/index.ts","../src/assertions/index.ts"],"names":[],"mappings":";;;;;;;;;AAeO,SAAS,eAAkB,KAAA,EAAyC;AACzE,EAAA,OAAO,KAAA,KAAU,UAAa,KAAA,KAAU,IAAA;AAC1C;;;ACFO,SAAS,gBACd,KAAA,EACqD;AACrD,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,IAAK,MAAM,MAAA,GAAS,CAAA;AAChD;;;ACLO,SAAS,iBAAiB,KAAA,EAAmD;AAClF,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,CAAM,IAAA,GAAO,MAAA,GAAS,CAAA;AAC5D;;;ACDO,SAAS,kBAAkB,KAAA,EAA2C;AAC3E,EAAA,OAAO,KAAA,KAAU,UAAa,KAAA,KAAU,IAAA;AAC1C;;;ACHO,SAAS,aACd,KAAA,EACgD;AAChD,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,IAAK,MAAM,MAAA,KAAW,CAAA;AAClD;;;ACHO,SAAS,cAAc,KAAA,EAA2C;AACvE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,CAAM,IAAA,GAAO,MAAA,KAAW,CAAA;AAC9D;;;ACDO,SAAS,aAAA,CACd,OACA,OAAA,EACoB;AACpB,EAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,EAAM;AACzC,IAAA,MAAM,IAAI,KAAA,CAAM,OAAA,IAAW,uBAAuB,CAAA;AAAA,EACpD;AACF;;;ACvBA,IAAA,cAAA,GAAA;AAAA,QAAA,CAAA,cAAA,EAAA;AAAA,EAAA,YAAA,EAAA,MAAA,YAAA;AAAA,EAAA,aAAA,EAAA,MAAA,aAAA;AAAA,EAAA,eAAA,EAAA,MAAA,eAAA;AAAA,EAAA,gBAAA,EAAA,MAAA,gBAAA;AAAA,EAAA,iBAAA,EAAA,MAAA,iBAAA;AAAA,EAAA,cAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACAA,IAAA,kBAAA,GAAA;AAAA,QAAA,CAAA,kBAAA,EAAA;AAAA,EAAA,aAAA,EAAA,MAAA;AAAA,CAAA,CAAA","file":"index.js","sourcesContent":["/**\r\n * Type guard that checks if a value is neither null nor undefined.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is defined (not null and not undefined)\r\n *\r\n * @example\r\n * ```typescript\r\n * const value: string | null | undefined = getValue();\r\n * if (isValueDefined(value)) {\r\n *   // value is narrowed to string\r\n *   console.log(value.length);\r\n * }\r\n * ```\r\n */\r\nexport function isValueDefined<T>(value: T | null | undefined): value is T {\r\n  return value !== undefined && value !== null;\r\n}\r\n","/**\r\n * Type guard that checks if a value is a non-empty array.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is an array with at least one element\r\n *\r\n * @example\r\n * ```typescript\r\n * const items: string[] | undefined = getItems();\r\n * if (isNotEmptyArray(items)) {\r\n *   // items is narrowed to string[] with at least one element\r\n *   console.log(items[0]); // Safe to access\r\n * }\r\n * ```\r\n */\r\nexport function isNotEmptyArray<T>(\r\n  value: readonly T[] | null | undefined\r\n): value is readonly T[] & { readonly length: number } {\r\n  return Array.isArray(value) && value.length > 0;\r\n}\r\n","/**\r\n * Checks if a value is a non-empty string (after trimming whitespace).\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is a string with non-whitespace content\r\n *\r\n * @example\r\n * ```typescript\r\n * isNotEmptyString('hello');     // true\r\n * isNotEmptyString('  ');        // false\r\n * isNotEmptyString('');          // false\r\n * isNotEmptyString(undefined);   // false\r\n * ```\r\n */\r\nexport function isNotEmptyString(value: string | null | undefined): value is string {\r\n  return typeof value === 'string' && value.trim().length > 0;\r\n}\r\n","/**\r\n * Type guard that checks if a value is null or undefined.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is null or undefined\r\n *\r\n * @example\r\n * ```typescript\r\n * const value: string | null | undefined = getValue();\r\n * if (isNullOrUndefined(value)) {\r\n *   // value is narrowed to null | undefined\r\n *   console.log('Value is not set');\r\n * }\r\n * ```\r\n */\r\nexport function isNullOrUndefined(value: unknown): value is null | undefined {\r\n  return value === undefined || value === null;\r\n}\r\n","/**\r\n * Type guard that checks if a value is an empty array.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is an array with zero elements\r\n *\r\n * @example\r\n * ```typescript\r\n * const items: string[] = getItems();\r\n * if (isEmptyArray(items)) {\r\n *   console.log('No items found');\r\n * }\r\n * ```\r\n */\r\nexport function isEmptyArray<T>(\r\n  value: readonly T[] | null | undefined\r\n): value is readonly T[] & { readonly length: 0 } {\r\n  return Array.isArray(value) && value.length === 0;\r\n}\r\n","/**\r\n * Checks if a value is an empty string or contains only whitespace.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is an empty string or whitespace-only\r\n *\r\n * @example\r\n * ```typescript\r\n * isEmptyString('');          // true\r\n * isEmptyString('  ');        // true\r\n * isEmptyString('hello');     // false\r\n * isEmptyString(undefined);   // false (not a string)\r\n * isEmptyString(null);        // false (not a string)\r\n * ```\r\n */\r\nexport function isEmptyString(value: string | null | undefined): boolean {\r\n  return typeof value === 'string' && value.trim().length === 0;\r\n}\r\n","/**\r\n * Asserts that a value is defined (not null or undefined).\r\n * Throws an error if the value is null or undefined.\r\n *\r\n * @param value - The value to assert\r\n * @param message - Optional error message\r\n * @throws Error if value is null or undefined\r\n *\r\n * @example\r\n * ```typescript\r\n * const user = getUser(); // User | null\r\n * assertDefined(user, 'User must exist');\r\n * // user is now narrowed to User\r\n * console.log(user.name);\r\n * ```\r\n */\r\nexport function assertDefined<T>(\r\n  value: T | null | undefined,\r\n  message?: string\r\n): asserts value is T {\r\n  if (value === undefined || value === null) {\r\n    throw new Error(message ?? 'Value must be defined');\r\n  }\r\n}\r\n","export { isValueDefined } from './isValueDefined';\r\nexport { isNotEmptyArray } from './isNotEmptyArray';\r\nexport { isNotEmptyString } from './isNotEmptyString';\r\nexport { isNullOrUndefined } from './isNullOrUndefined';\r\nexport { isEmptyArray } from './isEmptyArray';\r\nexport { isEmptyString } from './isEmptyString';\r\n","export { assertDefined } from './assertDefined';\r\n"]}
+{"version":3,"sources":["../src/guards/isValueDefined.ts","../src/guards/isNotEmptyArray.ts","../src/guards/isNotEmptyString.ts","../src/guards/isNullOrUndefined.ts","../src/guards/isEmptyArray.ts","../src/guards/isEmptyString.ts","../src/assertions/assertDefined.ts","../src/error/getErrorMessage.ts","../src/format/formatDate.ts","../src/navigation/redirect.ts","../src/guards/index.ts","../src/assertions/index.ts","../src/error/index.ts","../src/format/index.ts","../src/navigation/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * Type guard that checks if a value is neither null nor undefined.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is defined (not null and not undefined)\r\n *\r\n * @example\r\n * ```typescript\r\n * const value: string | null | undefined = getValue();\r\n * if (isValueDefined(value)) {\r\n *   // value is narrowed to string\r\n *   console.log(value.length);\r\n * }\r\n * ```\r\n */\r\nexport function isValueDefined<T>(value: T | null | undefined): value is T {\r\n  return value !== undefined && value !== null;\r\n}\r\n","/**\r\n * Type guard that checks if a value is a non-empty array.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is an array with at least one element\r\n *\r\n * @example\r\n * ```typescript\r\n * const items: string[] | undefined = getItems();\r\n * if (isNotEmptyArray(items)) {\r\n *   // items is narrowed to string[] with at least one element\r\n *   console.log(items[0]); // Safe to access\r\n * }\r\n * ```\r\n */\r\nexport function isNotEmptyArray<T>(\r\n  value: readonly T[] | null | undefined\r\n): value is readonly T[] & { readonly length: number } {\r\n  return Array.isArray(value) && value.length > 0;\r\n}\r\n","/**\r\n * Checks if a value is a non-empty string (after trimming whitespace).\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is a string with non-whitespace content\r\n *\r\n * @example\r\n * ```typescript\r\n * isNotEmptyString('hello');     // true\r\n * isNotEmptyString('  ');        // false\r\n * isNotEmptyString('');          // false\r\n * isNotEmptyString(undefined);   // false\r\n * ```\r\n */\r\nexport function isNotEmptyString(value: string | null | undefined): value is string {\r\n  return typeof value === 'string' && value.trim().length > 0;\r\n}\r\n","/**\r\n * Type guard that checks if a value is null or undefined.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is null or undefined\r\n *\r\n * @example\r\n * ```typescript\r\n * const value: string | null | undefined = getValue();\r\n * if (isNullOrUndefined(value)) {\r\n *   // value is narrowed to null | undefined\r\n *   console.log('Value is not set');\r\n * }\r\n * ```\r\n */\r\nexport function isNullOrUndefined(value: unknown): value is null | undefined {\r\n  return value === undefined || value === null;\r\n}\r\n","/**\r\n * Type guard that checks if a value is an empty array.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is an array with zero elements\r\n *\r\n * @example\r\n * ```typescript\r\n * const items: string[] = getItems();\r\n * if (isEmptyArray(items)) {\r\n *   console.log('No items found');\r\n * }\r\n * ```\r\n */\r\nexport function isEmptyArray<T>(\r\n  value: readonly T[] | null | undefined\r\n): value is readonly T[] & { readonly length: 0 } {\r\n  return Array.isArray(value) && value.length === 0;\r\n}\r\n","/**\r\n * Checks if a value is an empty string or contains only whitespace.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is an empty string or whitespace-only\r\n *\r\n * @example\r\n * ```typescript\r\n * isEmptyString('');          // true\r\n * isEmptyString('  ');        // true\r\n * isEmptyString('hello');     // false\r\n * isEmptyString(undefined);   // false (not a string)\r\n * isEmptyString(null);        // false (not a string)\r\n * ```\r\n */\r\nexport function isEmptyString(value: string | null | undefined): boolean {\r\n  return typeof value === 'string' && value.trim().length === 0;\r\n}\r\n","/**\r\n * Asserts that a value is defined (not null or undefined).\r\n * Throws an error if the value is null or undefined.\r\n *\r\n * @param value - The value to assert\r\n * @param message - Optional error message\r\n * @throws Error if value is null or undefined\r\n *\r\n * @example\r\n * ```typescript\r\n * const user = getUser(); // User | null\r\n * assertDefined(user, 'User must exist');\r\n * // user is now narrowed to User\r\n * console.log(user.name);\r\n * ```\r\n */\r\nexport function assertDefined<T>(\r\n  value: T | null | undefined,\r\n  message?: string\r\n): asserts value is T {\r\n  if (value === undefined || value === null) {\r\n    throw new Error(message ?? 'Value must be defined');\r\n  }\r\n}\r\n","import { isValueDefined } from '../guards/isValueDefined';\n\ninterface ErrorWithMessage {\n  message?: unknown;\n}\n\nfunction isErrorWithMessage(value: unknown): value is ErrorWithMessage {\n  return typeof value === 'object' && isValueDefined(value) && 'message' in value;\n}\n\n/**\n * Extracts a human-readable error message from various error shapes\n * (Error, string, or an object with a `message` property).\n *\n * @param value - The error value.\n * @param fallback - Returned when no message can be extracted (default: 'Unknown error').\n */\nexport function getErrorMessage(value: unknown, fallback = 'Unknown error'): string {\n  if (value instanceof Error) {return value.message;}\n  if (typeof value === 'string') {return value;}\n  if (isErrorWithMessage(value)) {\n    const message = value.message;\n    if (typeof message === 'string' && message.length > 0) {return message;}\n  }\n  return fallback;\n}\n","/**\n * Locale-aware date formatting (pure — the caller supplies the locale, e.g. from i18n).\n * Returns '' for null/undefined; falls back to the ISO date if Intl formatting throws.\n *\n * @example formatDate(new Date(), 'en')                              // \"6/15/2024\"\n * @example formatDate(new Date(), 'en', { year: 'numeric', month: 'long' }) // \"June 2024\"\n * @example formatDate(null, 'en')                                    // \"\"\n */\nexport function formatDate(\n  date: Date | null | undefined,\n  locale: string,\n  options?: Intl.DateTimeFormatOptions,\n): string {\n  if (date === null || date === undefined) {return '';}\n\n  const resolvedLocale = locale !== '' ? locale : 'en';\n\n  try {\n    return new Intl.DateTimeFormat(resolvedLocale, options).format(date);\n  } catch {\n    // Fallback to ISO date if formatting fails (invalid locale/options).\n    return date.toISOString().split('T')[0] ?? '';\n  }\n}\n","/**\n * Framework-agnostic redirect escape hatch.\n *\n * WHY THIS EXISTS: non-React code (an axios 401 interceptor, an auth provider's\n * token-refresh failure path) needs to navigate, but has no access to a router\n * hook. The app registers its router's push/replace once via `setRedirectHandler`;\n * everything else calls `redirectTo` and does not care which router is mounted.\n *\n * Three layers of fallback, in order:\n *  1. the registered handler (the app's router),\n *  2. `window.location.replace` if no handler is registered yet,\n *  3. a queue, drained on the next `setRedirectHandler` call — so a redirect fired\n *     before the router mounts is not silently dropped.\n *\n * Layer 1 additionally schedules a watchdog: some routers accept a `push` for a\n * route they cannot resolve and leave the URL untouched, which strands the user on\n * the page they were supposed to leave. If the location has not changed after\n * `NAVIGATION_CHECK_DELAY_MS`, a hard `window.location.replace` is forced.\n *\n * Promoted from the byte-identical `lib/navigation.ts` twins in erevna-web and\n * katalogos-web. Pure DOM + timers — no React, no router, no framework import.\n */\n\n/**\n * The slice of `window` this module touches, declared structurally.\n *\n * WHY NOT `lib: [\"DOM\"]`: `@dloizides/utils` ships to Node consumers too, and its\n * tsconfig deliberately lists only `ES2020`. Adding DOM globally would let every\n * other util in the package reach for browser globals that are absent at runtime\n * on the server. Declaring the ~4 properties used here keeps that door shut.\n */\ninterface BrowserWindow {\n  location: {\n    pathname: string;\n    search: string;\n    hash: string;\n    replace: (url: string) => void;\n  };\n}\n\ndeclare const window: BrowserWindow | undefined;\n\n/** Delay in ms before checking whether the registered handler actually navigated. */\nconst NAVIGATION_CHECK_DELAY_MS = 150;\n\nlet redirectHandler: ((path: string) => void) | null = null;\nconst queuedRedirects: string[] = [];\n\n/**\n * Strips Expo-Router group segments — `/(protected)/settings` → `/settings`.\n * Group folders are a routing-config device and never appear in a real URL, so a\n * raw group path handed to `window.location` would 404.\n */\nfunction normalizeRouterPath(path: string): string {\n  const normalized = path.replace(/\\/\\([^/]+\\)/g, '');\n  return normalized === '' ? '/' : normalized;\n}\n\n/** Current location as path+search+hash, or null outside a browser (SSR/native). */\nfunction getCurrentLocation(): string | null {\n  if (typeof window === 'undefined') {return null;}\n  return `${window.location.pathname}${window.location.search}${window.location.hash}`;\n}\n\n/** Force a hard navigation if the registered handler left the location unchanged. */\nfunction scheduleFallbackNavigation(before: string, normalized: string): void {\n  setTimeout(() => {\n    try {\n      const after = getCurrentLocation();\n      if (after === before && typeof window !== 'undefined') {window.location.replace(normalized);}\n    } catch {\n      /* ignore — window may have gone away (unmount/teardown) */\n    }\n  }, NAVIGATION_CHECK_DELAY_MS);\n}\n\n/** Attempt a hard browser navigation. Returns false outside a browser or on throw. */\nfunction tryWindowNavigation(normalized: string): boolean {\n  if (typeof window === 'undefined') {return false;}\n  try {\n    window.location.replace(normalized);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Register the app's router navigate function and drain any redirects that were\n * queued before it mounted. Call once, from the root layout.\n */\nexport function setRedirectHandler(h: (path: string) => void): void {\n  redirectHandler = h;\n  while (queuedRedirects.length > 0) {\n    const p = queuedRedirects.shift();\n    try {\n      if (typeof p === 'string' && p.length > 0) {h(normalizeRouterPath(p));}\n    } catch {\n      /* swallow; the handler may still not be ready */\n    }\n  }\n}\n\n/**\n * Navigate to `path` from anywhere, including outside React.\n * Safe to call before the router mounts — the redirect is queued and replayed.\n */\nexport function redirectTo(path: string): void {\n  const normalized = normalizeRouterPath(path);\n  if (redirectHandler) {\n    const before = getCurrentLocation();\n    try {\n      redirectHandler(normalized);\n      if (typeof before === 'string') {scheduleFallbackNavigation(before, normalized);}\n      return;\n    } catch {\n      /* fall through to a hard navigation */\n    }\n  }\n  if (tryWindowNavigation(normalized)) {return;}\n  queuedRedirects.push(normalized);\n}\n\n/**\n * Clear the registered handler and any queued redirects.\n * Exists for tests — module state otherwise leaks between cases.\n */\nexport function resetRedirectHandler(): void {\n  redirectHandler = null;\n  queuedRedirects.length = 0;\n}\n","export { isValueDefined } from './isValueDefined';\r\nexport { isNotEmptyArray } from './isNotEmptyArray';\r\nexport { isNotEmptyString } from './isNotEmptyString';\r\nexport { isNullOrUndefined } from './isNullOrUndefined';\r\nexport { isEmptyArray } from './isEmptyArray';\r\nexport { isEmptyString } from './isEmptyString';\r\n","export { assertDefined } from './assertDefined';\r\n","export { getErrorMessage } from './getErrorMessage';\n","export { formatDate } from './formatDate';\n","export { setRedirectHandler, redirectTo, resetRedirectHandler } from './redirect';\n"]}

package/dist/index.mjs

@@ -41,6 +41,110 @@ function assertDefined(value, message) {
   }
 }
 
+// src/error/getErrorMessage.ts
+function isErrorWithMessage(value) {
+  return typeof value === "object" && isValueDefined(value) && "message" in value;
+}
+function getErrorMessage(value, fallback = "Unknown error") {
+  if (value instanceof Error) {
+    return value.message;
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  if (isErrorWithMessage(value)) {
+    const message = value.message;
+    if (typeof message === "string" && message.length > 0) {
+      return message;
+    }
+  }
+  return fallback;
+}
+
+// src/format/formatDate.ts
+function formatDate(date, locale, options) {
+  if (date === null || date === void 0) {
+    return "";
+  }
+  const resolvedLocale = locale !== "" ? locale : "en";
+  try {
+    return new Intl.DateTimeFormat(resolvedLocale, options).format(date);
+  } catch {
+    return date.toISOString().split("T")[0] ?? "";
+  }
+}
+
+// src/navigation/redirect.ts
+var NAVIGATION_CHECK_DELAY_MS = 150;
+var redirectHandler = null;
+var queuedRedirects = [];
+function normalizeRouterPath(path) {
+  const normalized = path.replace(/\/\([^/]+\)/g, "");
+  return normalized === "" ? "/" : normalized;
+}
+function getCurrentLocation() {
+  if (typeof window === "undefined") {
+    return null;
+  }
+  return `${window.location.pathname}${window.location.search}${window.location.hash}`;
+}
+function scheduleFallbackNavigation(before, normalized) {
+  setTimeout(() => {
+    try {
+      const after = getCurrentLocation();
+      if (after === before && typeof window !== "undefined") {
+        window.location.replace(normalized);
+      }
+    } catch {
+    }
+  }, NAVIGATION_CHECK_DELAY_MS);
+}
+function tryWindowNavigation(normalized) {
+  if (typeof window === "undefined") {
+    return false;
+  }
+  try {
+    window.location.replace(normalized);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function setRedirectHandler(h) {
+  redirectHandler = h;
+  while (queuedRedirects.length > 0) {
+    const p = queuedRedirects.shift();
+    try {
+      if (typeof p === "string" && p.length > 0) {
+        h(normalizeRouterPath(p));
+      }
+    } catch {
+    }
+  }
+}
+function redirectTo(path) {
+  const normalized = normalizeRouterPath(path);
+  if (redirectHandler) {
+    const before = getCurrentLocation();
+    try {
+      redirectHandler(normalized);
+      if (typeof before === "string") {
+        scheduleFallbackNavigation(before, normalized);
+      }
+      return;
+    } catch {
+    }
+  }
+  if (tryWindowNavigation(normalized)) {
+    return;
+  }
+  queuedRedirects.push(normalized);
+}
+function resetRedirectHandler() {
+  redirectHandler = null;
+  queuedRedirects.length = 0;
+}
+
 // src/guards/index.ts
 var guards_exports = {};
 __export(guards_exports, {
@@ -58,6 +162,26 @@ __export(assertions_exports, {
   assertDefined: () => assertDefined
 });
 
-export { assertDefined, assertions_exports as assertions, guards_exports as guards, isEmptyArray, isEmptyString, isNotEmptyArray, isNotEmptyString, isNullOrUndefined, isValueDefined };
+// src/error/index.ts
+var error_exports = {};
+__export(error_exports, {
+  getErrorMessage: () => getErrorMessage
+});
+
+// src/format/index.ts
+var format_exports = {};
+__export(format_exports, {
+  formatDate: () => formatDate
+});
+
+// src/navigation/index.ts
+var navigation_exports = {};
+__export(navigation_exports, {
+  redirectTo: () => redirectTo,
+  resetRedirectHandler: () => resetRedirectHandler,
+  setRedirectHandler: () => setRedirectHandler
+});
+
+export { assertDefined, assertions_exports as assertions, error_exports as error, format_exports as format, formatDate, getErrorMessage, guards_exports as guards, isEmptyArray, isEmptyString, isNotEmptyArray, isNotEmptyString, isNullOrUndefined, isValueDefined, navigation_exports as navigation, redirectTo, resetRedirectHandler, setRedirectHandler };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/guards/isValueDefined.ts","../src/guards/isNotEmptyArray.ts","../src/guards/isNotEmptyString.ts","../src/guards/isNullOrUndefined.ts","../src/guards/isEmptyArray.ts","../src/guards/isEmptyString.ts","../src/assertions/assertDefined.ts","../src/guards/index.ts","../src/assertions/index.ts"],"names":[],"mappings":";;;;;;;AAeO,SAAS,eAAkB,KAAA,EAAyC;AACzE,EAAA,OAAO,KAAA,KAAU,UAAa,KAAA,KAAU,IAAA;AAC1C;;;ACFO,SAAS,gBACd,KAAA,EACqD;AACrD,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,IAAK,MAAM,MAAA,GAAS,CAAA;AAChD;;;ACLO,SAAS,iBAAiB,KAAA,EAAmD;AAClF,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,CAAM,IAAA,GAAO,MAAA,GAAS,CAAA;AAC5D;;;ACDO,SAAS,kBAAkB,KAAA,EAA2C;AAC3E,EAAA,OAAO,KAAA,KAAU,UAAa,KAAA,KAAU,IAAA;AAC1C;;;ACHO,SAAS,aACd,KAAA,EACgD;AAChD,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,IAAK,MAAM,MAAA,KAAW,CAAA;AAClD;;;ACHO,SAAS,cAAc,KAAA,EAA2C;AACvE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,CAAM,IAAA,GAAO,MAAA,KAAW,CAAA;AAC9D;;;ACDO,SAAS,aAAA,CACd,OACA,OAAA,EACoB;AACpB,EAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,EAAM;AACzC,IAAA,MAAM,IAAI,KAAA,CAAM,OAAA,IAAW,uBAAuB,CAAA;AAAA,EACpD;AACF;;;ACvBA,IAAA,cAAA,GAAA;AAAA,QAAA,CAAA,cAAA,EAAA;AAAA,EAAA,YAAA,EAAA,MAAA,YAAA;AAAA,EAAA,aAAA,EAAA,MAAA,aAAA;AAAA,EAAA,eAAA,EAAA,MAAA,eAAA;AAAA,EAAA,gBAAA,EAAA,MAAA,gBAAA;AAAA,EAAA,iBAAA,EAAA,MAAA,iBAAA;AAAA,EAAA,cAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACAA,IAAA,kBAAA,GAAA;AAAA,QAAA,CAAA,kBAAA,EAAA;AAAA,EAAA,aAAA,EAAA,MAAA;AAAA,CAAA,CAAA","file":"index.mjs","sourcesContent":["/**\r\n * Type guard that checks if a value is neither null nor undefined.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is defined (not null and not undefined)\r\n *\r\n * @example\r\n * ```typescript\r\n * const value: string | null | undefined = getValue();\r\n * if (isValueDefined(value)) {\r\n *   // value is narrowed to string\r\n *   console.log(value.length);\r\n * }\r\n * ```\r\n */\r\nexport function isValueDefined<T>(value: T | null | undefined): value is T {\r\n  return value !== undefined && value !== null;\r\n}\r\n","/**\r\n * Type guard that checks if a value is a non-empty array.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is an array with at least one element\r\n *\r\n * @example\r\n * ```typescript\r\n * const items: string[] | undefined = getItems();\r\n * if (isNotEmptyArray(items)) {\r\n *   // items is narrowed to string[] with at least one element\r\n *   console.log(items[0]); // Safe to access\r\n * }\r\n * ```\r\n */\r\nexport function isNotEmptyArray<T>(\r\n  value: readonly T[] | null | undefined\r\n): value is readonly T[] & { readonly length: number } {\r\n  return Array.isArray(value) && value.length > 0;\r\n}\r\n","/**\r\n * Checks if a value is a non-empty string (after trimming whitespace).\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is a string with non-whitespace content\r\n *\r\n * @example\r\n * ```typescript\r\n * isNotEmptyString('hello');     // true\r\n * isNotEmptyString('  ');        // false\r\n * isNotEmptyString('');          // false\r\n * isNotEmptyString(undefined);   // false\r\n * ```\r\n */\r\nexport function isNotEmptyString(value: string | null | undefined): value is string {\r\n  return typeof value === 'string' && value.trim().length > 0;\r\n}\r\n","/**\r\n * Type guard that checks if a value is null or undefined.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is null or undefined\r\n *\r\n * @example\r\n * ```typescript\r\n * const value: string | null | undefined = getValue();\r\n * if (isNullOrUndefined(value)) {\r\n *   // value is narrowed to null | undefined\r\n *   console.log('Value is not set');\r\n * }\r\n * ```\r\n */\r\nexport function isNullOrUndefined(value: unknown): value is null | undefined {\r\n  return value === undefined || value === null;\r\n}\r\n","/**\r\n * Type guard that checks if a value is an empty array.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is an array with zero elements\r\n *\r\n * @example\r\n * ```typescript\r\n * const items: string[] = getItems();\r\n * if (isEmptyArray(items)) {\r\n *   console.log('No items found');\r\n * }\r\n * ```\r\n */\r\nexport function isEmptyArray<T>(\r\n  value: readonly T[] | null | undefined\r\n): value is readonly T[] & { readonly length: 0 } {\r\n  return Array.isArray(value) && value.length === 0;\r\n}\r\n","/**\r\n * Checks if a value is an empty string or contains only whitespace.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is an empty string or whitespace-only\r\n *\r\n * @example\r\n * ```typescript\r\n * isEmptyString('');          // true\r\n * isEmptyString('  ');        // true\r\n * isEmptyString('hello');     // false\r\n * isEmptyString(undefined);   // false (not a string)\r\n * isEmptyString(null);        // false (not a string)\r\n * ```\r\n */\r\nexport function isEmptyString(value: string | null | undefined): boolean {\r\n  return typeof value === 'string' && value.trim().length === 0;\r\n}\r\n","/**\r\n * Asserts that a value is defined (not null or undefined).\r\n * Throws an error if the value is null or undefined.\r\n *\r\n * @param value - The value to assert\r\n * @param message - Optional error message\r\n * @throws Error if value is null or undefined\r\n *\r\n * @example\r\n * ```typescript\r\n * const user = getUser(); // User | null\r\n * assertDefined(user, 'User must exist');\r\n * // user is now narrowed to User\r\n * console.log(user.name);\r\n * ```\r\n */\r\nexport function assertDefined<T>(\r\n  value: T | null | undefined,\r\n  message?: string\r\n): asserts value is T {\r\n  if (value === undefined || value === null) {\r\n    throw new Error(message ?? 'Value must be defined');\r\n  }\r\n}\r\n","export { isValueDefined } from './isValueDefined';\r\nexport { isNotEmptyArray } from './isNotEmptyArray';\r\nexport { isNotEmptyString } from './isNotEmptyString';\r\nexport { isNullOrUndefined } from './isNullOrUndefined';\r\nexport { isEmptyArray } from './isEmptyArray';\r\nexport { isEmptyString } from './isEmptyString';\r\n","export { assertDefined } from './assertDefined';\r\n"]}
+{"version":3,"sources":["../src/guards/isValueDefined.ts","../src/guards/isNotEmptyArray.ts","../src/guards/isNotEmptyString.ts","../src/guards/isNullOrUndefined.ts","../src/guards/isEmptyArray.ts","../src/guards/isEmptyString.ts","../src/assertions/assertDefined.ts","../src/error/getErrorMessage.ts","../src/format/formatDate.ts","../src/navigation/redirect.ts","../src/guards/index.ts","../src/assertions/index.ts","../src/error/index.ts","../src/format/index.ts","../src/navigation/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\r\n * Type guard that checks if a value is neither null nor undefined.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is defined (not null and not undefined)\r\n *\r\n * @example\r\n * ```typescript\r\n * const value: string | null | undefined = getValue();\r\n * if (isValueDefined(value)) {\r\n *   // value is narrowed to string\r\n *   console.log(value.length);\r\n * }\r\n * ```\r\n */\r\nexport function isValueDefined<T>(value: T | null | undefined): value is T {\r\n  return value !== undefined && value !== null;\r\n}\r\n","/**\r\n * Type guard that checks if a value is a non-empty array.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is an array with at least one element\r\n *\r\n * @example\r\n * ```typescript\r\n * const items: string[] | undefined = getItems();\r\n * if (isNotEmptyArray(items)) {\r\n *   // items is narrowed to string[] with at least one element\r\n *   console.log(items[0]); // Safe to access\r\n * }\r\n * ```\r\n */\r\nexport function isNotEmptyArray<T>(\r\n  value: readonly T[] | null | undefined\r\n): value is readonly T[] & { readonly length: number } {\r\n  return Array.isArray(value) && value.length > 0;\r\n}\r\n","/**\r\n * Checks if a value is a non-empty string (after trimming whitespace).\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is a string with non-whitespace content\r\n *\r\n * @example\r\n * ```typescript\r\n * isNotEmptyString('hello');     // true\r\n * isNotEmptyString('  ');        // false\r\n * isNotEmptyString('');          // false\r\n * isNotEmptyString(undefined);   // false\r\n * ```\r\n */\r\nexport function isNotEmptyString(value: string | null | undefined): value is string {\r\n  return typeof value === 'string' && value.trim().length > 0;\r\n}\r\n","/**\r\n * Type guard that checks if a value is null or undefined.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is null or undefined\r\n *\r\n * @example\r\n * ```typescript\r\n * const value: string | null | undefined = getValue();\r\n * if (isNullOrUndefined(value)) {\r\n *   // value is narrowed to null | undefined\r\n *   console.log('Value is not set');\r\n * }\r\n * ```\r\n */\r\nexport function isNullOrUndefined(value: unknown): value is null | undefined {\r\n  return value === undefined || value === null;\r\n}\r\n","/**\r\n * Type guard that checks if a value is an empty array.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is an array with zero elements\r\n *\r\n * @example\r\n * ```typescript\r\n * const items: string[] = getItems();\r\n * if (isEmptyArray(items)) {\r\n *   console.log('No items found');\r\n * }\r\n * ```\r\n */\r\nexport function isEmptyArray<T>(\r\n  value: readonly T[] | null | undefined\r\n): value is readonly T[] & { readonly length: 0 } {\r\n  return Array.isArray(value) && value.length === 0;\r\n}\r\n","/**\r\n * Checks if a value is an empty string or contains only whitespace.\r\n *\r\n * @param value - The value to check\r\n * @returns True if the value is an empty string or whitespace-only\r\n *\r\n * @example\r\n * ```typescript\r\n * isEmptyString('');          // true\r\n * isEmptyString('  ');        // true\r\n * isEmptyString('hello');     // false\r\n * isEmptyString(undefined);   // false (not a string)\r\n * isEmptyString(null);        // false (not a string)\r\n * ```\r\n */\r\nexport function isEmptyString(value: string | null | undefined): boolean {\r\n  return typeof value === 'string' && value.trim().length === 0;\r\n}\r\n","/**\r\n * Asserts that a value is defined (not null or undefined).\r\n * Throws an error if the value is null or undefined.\r\n *\r\n * @param value - The value to assert\r\n * @param message - Optional error message\r\n * @throws Error if value is null or undefined\r\n *\r\n * @example\r\n * ```typescript\r\n * const user = getUser(); // User | null\r\n * assertDefined(user, 'User must exist');\r\n * // user is now narrowed to User\r\n * console.log(user.name);\r\n * ```\r\n */\r\nexport function assertDefined<T>(\r\n  value: T | null | undefined,\r\n  message?: string\r\n): asserts value is T {\r\n  if (value === undefined || value === null) {\r\n    throw new Error(message ?? 'Value must be defined');\r\n  }\r\n}\r\n","import { isValueDefined } from '../guards/isValueDefined';\n\ninterface ErrorWithMessage {\n  message?: unknown;\n}\n\nfunction isErrorWithMessage(value: unknown): value is ErrorWithMessage {\n  return typeof value === 'object' && isValueDefined(value) && 'message' in value;\n}\n\n/**\n * Extracts a human-readable error message from various error shapes\n * (Error, string, or an object with a `message` property).\n *\n * @param value - The error value.\n * @param fallback - Returned when no message can be extracted (default: 'Unknown error').\n */\nexport function getErrorMessage(value: unknown, fallback = 'Unknown error'): string {\n  if (value instanceof Error) {return value.message;}\n  if (typeof value === 'string') {return value;}\n  if (isErrorWithMessage(value)) {\n    const message = value.message;\n    if (typeof message === 'string' && message.length > 0) {return message;}\n  }\n  return fallback;\n}\n","/**\n * Locale-aware date formatting (pure — the caller supplies the locale, e.g. from i18n).\n * Returns '' for null/undefined; falls back to the ISO date if Intl formatting throws.\n *\n * @example formatDate(new Date(), 'en')                              // \"6/15/2024\"\n * @example formatDate(new Date(), 'en', { year: 'numeric', month: 'long' }) // \"June 2024\"\n * @example formatDate(null, 'en')                                    // \"\"\n */\nexport function formatDate(\n  date: Date | null | undefined,\n  locale: string,\n  options?: Intl.DateTimeFormatOptions,\n): string {\n  if (date === null || date === undefined) {return '';}\n\n  const resolvedLocale = locale !== '' ? locale : 'en';\n\n  try {\n    return new Intl.DateTimeFormat(resolvedLocale, options).format(date);\n  } catch {\n    // Fallback to ISO date if formatting fails (invalid locale/options).\n    return date.toISOString().split('T')[0] ?? '';\n  }\n}\n","/**\n * Framework-agnostic redirect escape hatch.\n *\n * WHY THIS EXISTS: non-React code (an axios 401 interceptor, an auth provider's\n * token-refresh failure path) needs to navigate, but has no access to a router\n * hook. The app registers its router's push/replace once via `setRedirectHandler`;\n * everything else calls `redirectTo` and does not care which router is mounted.\n *\n * Three layers of fallback, in order:\n *  1. the registered handler (the app's router),\n *  2. `window.location.replace` if no handler is registered yet,\n *  3. a queue, drained on the next `setRedirectHandler` call — so a redirect fired\n *     before the router mounts is not silently dropped.\n *\n * Layer 1 additionally schedules a watchdog: some routers accept a `push` for a\n * route they cannot resolve and leave the URL untouched, which strands the user on\n * the page they were supposed to leave. If the location has not changed after\n * `NAVIGATION_CHECK_DELAY_MS`, a hard `window.location.replace` is forced.\n *\n * Promoted from the byte-identical `lib/navigation.ts` twins in erevna-web and\n * katalogos-web. Pure DOM + timers — no React, no router, no framework import.\n */\n\n/**\n * The slice of `window` this module touches, declared structurally.\n *\n * WHY NOT `lib: [\"DOM\"]`: `@dloizides/utils` ships to Node consumers too, and its\n * tsconfig deliberately lists only `ES2020`. Adding DOM globally would let every\n * other util in the package reach for browser globals that are absent at runtime\n * on the server. Declaring the ~4 properties used here keeps that door shut.\n */\ninterface BrowserWindow {\n  location: {\n    pathname: string;\n    search: string;\n    hash: string;\n    replace: (url: string) => void;\n  };\n}\n\ndeclare const window: BrowserWindow | undefined;\n\n/** Delay in ms before checking whether the registered handler actually navigated. */\nconst NAVIGATION_CHECK_DELAY_MS = 150;\n\nlet redirectHandler: ((path: string) => void) | null = null;\nconst queuedRedirects: string[] = [];\n\n/**\n * Strips Expo-Router group segments — `/(protected)/settings` → `/settings`.\n * Group folders are a routing-config device and never appear in a real URL, so a\n * raw group path handed to `window.location` would 404.\n */\nfunction normalizeRouterPath(path: string): string {\n  const normalized = path.replace(/\\/\\([^/]+\\)/g, '');\n  return normalized === '' ? '/' : normalized;\n}\n\n/** Current location as path+search+hash, or null outside a browser (SSR/native). */\nfunction getCurrentLocation(): string | null {\n  if (typeof window === 'undefined') {return null;}\n  return `${window.location.pathname}${window.location.search}${window.location.hash}`;\n}\n\n/** Force a hard navigation if the registered handler left the location unchanged. */\nfunction scheduleFallbackNavigation(before: string, normalized: string): void {\n  setTimeout(() => {\n    try {\n      const after = getCurrentLocation();\n      if (after === before && typeof window !== 'undefined') {window.location.replace(normalized);}\n    } catch {\n      /* ignore — window may have gone away (unmount/teardown) */\n    }\n  }, NAVIGATION_CHECK_DELAY_MS);\n}\n\n/** Attempt a hard browser navigation. Returns false outside a browser or on throw. */\nfunction tryWindowNavigation(normalized: string): boolean {\n  if (typeof window === 'undefined') {return false;}\n  try {\n    window.location.replace(normalized);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Register the app's router navigate function and drain any redirects that were\n * queued before it mounted. Call once, from the root layout.\n */\nexport function setRedirectHandler(h: (path: string) => void): void {\n  redirectHandler = h;\n  while (queuedRedirects.length > 0) {\n    const p = queuedRedirects.shift();\n    try {\n      if (typeof p === 'string' && p.length > 0) {h(normalizeRouterPath(p));}\n    } catch {\n      /* swallow; the handler may still not be ready */\n    }\n  }\n}\n\n/**\n * Navigate to `path` from anywhere, including outside React.\n * Safe to call before the router mounts — the redirect is queued and replayed.\n */\nexport function redirectTo(path: string): void {\n  const normalized = normalizeRouterPath(path);\n  if (redirectHandler) {\n    const before = getCurrentLocation();\n    try {\n      redirectHandler(normalized);\n      if (typeof before === 'string') {scheduleFallbackNavigation(before, normalized);}\n      return;\n    } catch {\n      /* fall through to a hard navigation */\n    }\n  }\n  if (tryWindowNavigation(normalized)) {return;}\n  queuedRedirects.push(normalized);\n}\n\n/**\n * Clear the registered handler and any queued redirects.\n * Exists for tests — module state otherwise leaks between cases.\n */\nexport function resetRedirectHandler(): void {\n  redirectHandler = null;\n  queuedRedirects.length = 0;\n}\n","export { isValueDefined } from './isValueDefined';\r\nexport { isNotEmptyArray } from './isNotEmptyArray';\r\nexport { isNotEmptyString } from './isNotEmptyString';\r\nexport { isNullOrUndefined } from './isNullOrUndefined';\r\nexport { isEmptyArray } from './isEmptyArray';\r\nexport { isEmptyString } from './isEmptyString';\r\n","export { assertDefined } from './assertDefined';\r\n","export { getErrorMessage } from './getErrorMessage';\n","export { formatDate } from './formatDate';\n","export { setRedirectHandler, redirectTo, resetRedirectHandler } from './redirect';\n"]}

package/package.json

@@ -1,114 +1,118 @@
-{
-  "name": "@dloizides/utils",
-  "version": "1.0.2",
-  "description": "Type-safe utility functions for TypeScript projects",
-  "keywords": [
-    "typescript",
-    "utilities",
-    "type-guards",
-    "validation"
-  ],
-  "author": "dloizides",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/openmindednewby/utils.git"
-  },
-  "homepage": "https://github.com/openmindednewby/utils#readme",
-  "bugs": {
-    "url": "https://github.com/openmindednewby/utils/issues"
-  },
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "require": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "import": {
-        "types": "./dist/index.d.mts",
-        "default": "./dist/index.mjs"
-      }
-    },
-    "./guards": {
-      "require": {
-        "types": "./dist/guards/index.d.ts",
-        "default": "./dist/guards/index.js"
-      },
-      "import": {
-        "types": "./dist/guards/index.d.mts",
-        "default": "./dist/guards/index.mjs"
-      }
-    },
-    "./assertions": {
-      "require": {
-        "types": "./dist/assertions/index.d.ts",
-        "default": "./dist/assertions/index.js"
-      },
-      "import": {
-        "types": "./dist/assertions/index.d.mts",
-        "default": "./dist/assertions/index.mjs"
-      }
-    }
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "CHANGELOG.md"
-  ],
-  "sideEffects": false,
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "scripts": {
-    "build": "tsup",
-    "build:watch": "tsup --watch",
-    "build:analyze": "tsup && size-limit",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
-    "lint": "eslint src --ext .ts",
-    "lint:fix": "eslint src --ext .ts --fix",
-    "typecheck": "tsc --noEmit",
-    "clean": "rimraf dist",
-    "security:audit": "npm audit --audit-level=high",
-    "deps:outdated": "npm outdated || exit 0",
-    "deps:unused": "npx depcheck --ignores \"@types/jest,@types/node,rimraf,size-limit,@size-limit/preset-small-lib\"",
-    "deps:licenses": "npx license-checker --onlyAllow \"MIT;Apache-2.0;ISC;BSD-2-Clause;BSD-3-Clause;0BSD;Unlicense;CC0-1.0\"",
-    "deps:health": "npm run deps:outdated && npm run deps:unused",
-    "prepublishOnly": "npm run clean && npm run build && npm run test",
-    "version": "npm run build",
-    "postversion": "git push && git push --tags"
-  },
-  "devDependencies": {
-    "@size-limit/preset-small-lib": "^12.0.0",
-    "@types/jest": "^29.5.0",
-    "@types/node": "^20.19.32",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
-    "eslint": "^8.57.0",
-    "eslint-plugin-sonarjs": "^3.0.6",
-    "jest": "^29.7.0",
-    "rimraf": "^5.0.0",
-    "size-limit": "^12.0.0",
-    "ts-jest": "^29.1.0",
-    "tsup": "^8.0.0",
-    "typescript": "^5.4.0"
-  },
-  "size-limit": [
-    {
-      "path": "dist/index.js",
-      "limit": "3 KB"
-    },
-    {
-      "path": "dist/guards/index.js",
-      "limit": "2 KB"
-    },
-    {
-      "path": "dist/assertions/index.js",
-      "limit": "1 KB"
-    }
-  ]
-}
+{
+  "name": "@dloizides/utils",
+  "version": "1.2.0",
+  "description": "Type-safe utility functions for TypeScript projects",
+  "keywords": [
+    "typescript",
+    "utilities",
+    "type-guards",
+    "validation"
+  ],
+  "author": "dloizides",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openmindednewby/utils.git"
+  },
+  "homepage": "https://github.com/openmindednewby/utils#readme",
+  "bugs": {
+    "url": "https://github.com/openmindednewby/utils/issues"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    },
+    "./guards": {
+      "require": {
+        "types": "./dist/guards/index.d.ts",
+        "default": "./dist/guards/index.js"
+      },
+      "import": {
+        "types": "./dist/guards/index.d.mts",
+        "default": "./dist/guards/index.mjs"
+      }
+    },
+    "./assertions": {
+      "require": {
+        "types": "./dist/assertions/index.d.ts",
+        "default": "./dist/assertions/index.js"
+      },
+      "import": {
+        "types": "./dist/assertions/index.d.mts",
+        "default": "./dist/assertions/index.mjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsup",
+    "build:watch": "tsup --watch",
+    "build:analyze": "tsup && size-limit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "security:audit": "npm audit --audit-level=high",
+    "deps:outdated": "npm outdated || exit 0",
+    "deps:unused": "npx depcheck --ignores \"@types/jest,@types/node,rimraf,size-limit,@size-limit/preset-small-lib\"",
+    "deps:licenses": "npx license-checker --onlyAllow \"MIT;Apache-2.0;ISC;BSD-2-Clause;BSD-3-Clause;0BSD;Unlicense;CC0-1.0\"",
+    "deps:health": "npm run deps:outdated && npm run deps:unused",
+    "prepublishOnly": "npm run clean && npm run build && npm run test",
+    "postversion": "git push && git push --tags"
+  },
+  "overrides": {
+    "eslint-plugin-sonarjs": {
+      "minimatch": "10.2.4"
+    }
+  },
+  "devDependencies": {
+    "@size-limit/preset-small-lib": "^12.0.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.19.32",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "eslint-plugin-sonarjs": "^3.0.6",
+    "jest": "^29.7.0",
+    "rimraf": "^5.0.0",
+    "size-limit": "^12.0.0",
+    "ts-jest": "^29.1.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "size-limit": [
+    {
+      "path": "dist/index.js",
+      "limit": "3 KB"
+    },
+    {
+      "path": "dist/guards/index.js",
+      "limit": "2 KB"
+    },
+    {
+      "path": "dist/assertions/index.js",
+      "limit": "1 KB"
+    }
+  ]
+}