@dloizides/utils 1.11.0 → 1.11.1

package/CHANGELOG.md

@@ -11,6 +11,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Fixed
+
+- `reloadPage` no longer treats a click event as its ports, so wiring it straight to a button's `onPress` reloads the page instead of throwing `reload is not a function` (FINREG-FORMS-CRASH-1 "FinReg text inputs crash after the ui-forms upgrade", AC-2).
+
 ### Added
 
 - `fireAndForget(promise)` (EXTRACT-TS-I18N-1 "Fold duplicated i18n and utils into @dloizides/i18n and @dloizides/utils"): starts a promise and swallows its rejection; replaces local copies in agora-web and ichnos-web.

package/dist/index.d.mts

@@ -177,7 +177,7 @@ declare function attemptChunkRecovery(ports?: ChunkRecoveryPorts): boolean;
  * anyway, so clearing it only tidies storage, while a live one is left alone.
  */
 declare function clearChunkRecoveryFlag(ports?: ChunkRecoveryPorts): void;
-/** Manually reload the page (the Reload action). */
+/** Manually reload the page (the Reload action); an argument without `reload`, such as a click event, is ignored. */
 declare function reloadPage(ports?: ChunkRecoveryPorts): void;
 
 declare const index$5_fireAndForget: typeof fireAndForget;

package/dist/index.d.ts

@@ -177,7 +177,7 @@ declare function attemptChunkRecovery(ports?: ChunkRecoveryPorts): boolean;
  * anyway, so clearing it only tidies storage, while a live one is left alone.
  */
 declare function clearChunkRecoveryFlag(ports?: ChunkRecoveryPorts): void;
-/** Manually reload the page (the Reload action). */
+/** Manually reload the page (the Reload action); an argument without `reload`, such as a click event, is ignored. */
 declare function reloadPage(ports?: ChunkRecoveryPorts): void;
 
 declare const index$5_fireAndForget: typeof fireAndForget;

package/dist/index.js

@@ -352,8 +352,9 @@ function clearChunkRecoveryFlag(ports = defaultPorts()) {
   }
   ports.clearAttempt();
 }
-function reloadPage(ports = defaultPorts()) {
-  ports.reload();
+function reloadPage(ports) {
+  const target = typeof ports?.reload === "function" ? ports : defaultPorts();
+  target.reload();
 }
 
 // src/guards/index.ts

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/async/fireAndForget.ts","../src/async/singleFlight.ts","../src/error/getErrorMessage.ts","../src/format/formatDate.ts","../src/csv/toCsv.ts","../src/sanitize/sanitize.ts","../src/navigation/redirect.ts","../src/chunkRecovery/chunkRecovery.ts","../src/guards/index.ts","../src/assertions/index.ts","../src/async/index.ts","../src/error/index.ts","../src/format/index.ts","../src/csv/index.ts","../src/navigation/index.ts","../src/chunkRecovery/index.ts","../src/sanitize/index.ts","../src/json/checkedJson.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","/** Starts a promise without awaiting it and swallows its rejection. */\nexport function fireAndForget(promise: Promise<unknown>): void {\n  promise.catch(() => undefined);\n}\n","/** Wraps an async action so a second call while the first runs does nothing: one Enter or tap, one request. */\nexport function singleFlight<T>(action: (input: T) => Promise<void>): (input: T) => void {\n  let running = false;\n  return (input: T): void => {\n    if (running) {return;}\n    running = true;\n    action(input)\n      .catch(() => undefined)\n      .finally(() => {\n        running = false;\n      });\n  };\n}\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 * RFC 4180 CSV serialization — the pure, DOM-free core of \"export the rows on screen to CSV\".\n *\n * The escaping is the whole risk surface: a comma, a quote or a newline inside a value (a\n * counterparty name, an address) is exactly what turns one row into two columns or two rows in a\n * spreadsheet. So the serializer lives here as a pure, total function a unit test can hammer, split\n * from any browser download shell (which is a side-effecting, app-owned concern).\n *\n * Promoted from finreg-web's `utils/exportCsv.ts` (ZY-25) — the escaping logic is universal across\n * the fleet; the DOM `<a download>` shell that consumes it stays in the app until a 2nd consumer.\n */\nimport { isValueDefined } from '../guards/isValueDefined';\n\n/** One column of a CSV export: a (caller-localized) header and how to read the cell from a row. */\nexport interface CsvColumn<T> {\n  /** The column header — already localized by the caller. */\n  header: string;\n  /** Reads the cell value from a row. `null`/`undefined` become an empty cell. */\n  value: (row: T) => string | number | null | undefined;\n}\n\n/** RFC 4180: a field must be quoted when it contains a quote, a comma, or a line break. */\nconst NEEDS_QUOTING = /[\"',\\r\\n]/;\n\n// A more permissive test than strictly required (it also quotes apostrophes), so a value like\n// O'Brien is never split by a spreadsheet that treats a leading quote specially — harmless, and it\n// keeps the rule to one regex.\nconst QUOTE = '\"';\nconst ESCAPED_QUOTE = '\"\"';\n/** Every embedded quote, so each is doubled per RFC 4180 (ES2020-safe; no `replaceAll`). */\nconst EVERY_QUOTE = /\"/g;\n\n/** RFC 4180 uses CRLF between records; Excel and Sheets both require it. */\nconst ROW_SEPARATOR = '\\r\\n';\nconst FIELD_SEPARATOR = ',';\n\n/** Quote and escape a single field per RFC 4180. `null`/`undefined` → an empty field. */\nfunction escapeField(raw: string | number | null | undefined): string {\n  const text = isValueDefined(raw) ? String(raw) : '';\n  if (!NEEDS_QUOTING.test(text)) {\n    return text;\n  }\n  return `${QUOTE}${text.replace(EVERY_QUOTE, ESCAPED_QUOTE)}${QUOTE}`;\n}\n\n/**\n * Serialize rows to an RFC 4180 CSV string — a header row followed by one row per item.\n *\n * Pure and total: an empty `rows` yields the header line alone, which opens as an empty-but-labelled\n * spreadsheet rather than a zero-byte file the operator cannot tell apart from a failure.\n */\nexport function toCsv<T>(rows: readonly T[], columns: ReadonlyArray<CsvColumn<T>>): string {\n  const headerLine = columns.map((column) => escapeField(column.header)).join(FIELD_SEPARATOR);\n\n  const dataLines = rows.map((row) =>\n    columns.map((column) => escapeField(column.value(row))).join(FIELD_SEPARATOR),\n  );\n\n  return [headerLine, ...dataLines].join(ROW_SEPARATOR);\n}\n","/**\n * Text sanitization utilities for preventing XSS and ensuring safe display.\n * These utilities sanitize user-provided text before rendering.\n */\n\n/**\n * HTML entities that should be escaped to prevent XSS attacks.\n */\nconst HTML_ENTITIES: Record<string, string> = {\n  '&': '&amp;',\n  '<': '&lt;',\n  '>': '&gt;',\n  '\"': '&quot;',\n  \"'\": '&#x27;',\n  '/': '&#x2F;',\n  '`': '&#x60;',\n  '=': '&#x3D;',\n};\n\n/**\n * Regular expression matching characters that need escaping.\n */\nconst HTML_ESCAPE_REGEX = /[&<>\"'`=/]/g;\n\n/**\n * Unicode code point ranges for dangerous characters.\n * These are control characters and zero-width characters that can be\n * used in homograph attacks or to hide malicious content.\n */\n\n/** C0 control characters range start (NULL) */\nconst C0_CONTROL_START = 0x0000;\n/** C0 control characters range end (Unit Separator) */\nconst C0_CONTROL_END = 0x001f;\n/** C1 control characters range start (DEL and beyond) */\nconst C1_CONTROL_START = 0x007f;\n/** C1 control characters range end */\nconst C1_CONTROL_END = 0x009f;\n/** Zero-width characters range start (Zero Width Space) */\nconst ZERO_WIDTH_START = 0x200b;\n/** Zero-width characters range end (Right-to-Left Mark) */\nconst ZERO_WIDTH_END = 0x200f;\n/** Format characters range start (Line Separator) */\nconst FORMAT_CHARS_START = 0x2028;\n/** Format characters range end (Narrow No-Break Space) */\nconst FORMAT_CHARS_END = 0x202f;\n/** Byte Order Mark code point */\nconst BYTE_ORDER_MARK = 0xfeff;\n\n/**\n * Maximum reasonable length for notification messages.\n */\nconst MAX_NOTIFICATION_LENGTH = 500;\n\n/**\n * Length of ellipsis suffix (\"...\") used when truncating text.\n */\nconst ELLIPSIS_LENGTH = 3;\n\n/**\n * Escapes HTML special characters in a string to prevent XSS attacks.\n * Use this when displaying user-provided content in the UI.\n *\n * @param text - The text to sanitize\n * @returns The sanitized text with HTML entities escaped\n *\n * @example\n * sanitizeHtml('<script>alert(\"xss\")</script>')\n * // Returns: '&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;'\n */\nexport function sanitizeHtml(text: string): string {\n  if (text.length === 0) {return '';}\n  return text.replace(HTML_ESCAPE_REGEX, (char) => HTML_ENTITIES[char] ?? char);\n}\n\n/**\n * Control characters and zero-width characters that should be removed.\n * These can be used in homograph attacks or to hide malicious content.\n */\nfunction isDangerousCharCode(code: number): boolean {\n  const isC0Control = code >= C0_CONTROL_START && code <= C0_CONTROL_END;\n  const isC1Control = code >= C1_CONTROL_START && code <= C1_CONTROL_END;\n  const isZeroWidth = code >= ZERO_WIDTH_START && code <= ZERO_WIDTH_END;\n  const isFormatChar = code >= FORMAT_CHARS_START && code <= FORMAT_CHARS_END;\n  const isBom = code === BYTE_ORDER_MARK;\n  return isC0Control || isC1Control || isZeroWidth || isFormatChar || isBom;\n}\n\n/**\n * Removes control characters and zero-width characters from text.\n * These characters can be used to create misleading text or hide content.\n *\n * @param text - The text to sanitize\n * @returns The text with dangerous characters removed\n */\nexport function removeControlCharacters(text: string): string {\n  if (text.length === 0) {return '';}\n  let out = '';\n  for (let i = 0; i < text.length; i++) {\n    const code = text.charCodeAt(i);\n    if (!isDangerousCharCode(code)) {out += text[i];}\n  }\n  return out;\n}\n\n/**\n * Sanitizes a notification message for safe display.\n * This function:\n * 1. Removes control/zero-width characters\n * 2. Trims whitespace\n * 3. Truncates to a reasonable length\n * 4. Escapes HTML entities (for web platform)\n *\n * Note: React Native's Text component already escapes HTML by default,\n * but this provides defense-in-depth and handles the web platform.\n *\n * @param message - The notification message to sanitize\n * @param maxLength - Maximum length (default: 500)\n * @returns The sanitized message\n *\n * @example\n * sanitizeNotificationMessage('  Hello <b>World</b>  ')\n * // Returns: 'Hello &lt;b&gt;World&lt;/b&gt;'\n */\nexport function sanitizeNotificationMessage(\n  message: string,\n  maxLength: number = MAX_NOTIFICATION_LENGTH\n): string {\n  if (message.length === 0) {return '';}\n\n  // Remove dangerous characters first\n  let sanitized = removeControlCharacters(message);\n\n  // Trim whitespace\n  sanitized = sanitized.trim();\n\n  // Truncate if too long\n  if (sanitized.length > maxLength) \n    {sanitized = `${sanitized.substring(0, maxLength - ELLIPSIS_LENGTH)}...`;}\n  \n\n  // Escape HTML entities\n  sanitized = sanitizeHtml(sanitized);\n\n  return sanitized;\n}\n\n/**\n * Sanitizes text for safe display, without HTML escaping.\n * Use this for React Native components where HTML escaping isn't needed\n * but control character removal and length limits are still important.\n *\n * @param text - The text to sanitize\n * @param maxLength - Maximum length (optional)\n * @returns The sanitized text\n */\nexport function sanitizeText(text: string, maxLength?: number): string {\n  if (text.length === 0) {return '';}\n\n  let sanitized = removeControlCharacters(text);\n  sanitized = sanitized.trim();\n\n  const hasValidMaxLength = typeof maxLength === 'number' && maxLength > 0;\n  const exceedsMaxLength = hasValidMaxLength && sanitized.length > maxLength;\n  if (exceedsMaxLength) \n    {sanitized = `${sanitized.substring(0, maxLength - ELLIPSIS_LENGTH)}...`;}\n  \n\n  return sanitized;\n}\n\n/**\n * Validates and sanitizes a URL to prevent javascript: and data: protocol attacks.\n *\n * @param url - The URL to validate\n * @returns The sanitized URL or empty string if invalid\n */\nexport function sanitizeUrl(url: string): string {\n  if (url.length === 0) {return '';}\n\n  const trimmedLower = url.trim().toLowerCase();\n  const protocol = trimmedLower.split(':')[0];\n\n  // Block dangerous protocols\n  const isDangerousProtocol = protocol === 'javascript' || protocol === 'data' || protocol === 'vbscript';\n  if (isDangerousProtocol) \n    {return '';}\n  \n\n  return url.trim();\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","/**\n * Detection + one-shot auto-recovery for stale-chunk load failures.\n *\n * WHY (UX Move 3, would have masked P0-01): after a deploy, the browser may hold\n * a stale `index.html` that references hashed JS chunks which now 404 — surfacing\n * as a `ChunkLoadError` / \"failed to fetch dynamically imported module\". A single\n * guarded `location.reload()` re-fetches the fresh entry + chunks and the app\n * recovers with no user-visible error. The sessionStorage one-shot flag prevents\n * a reload LOOP if the reload does not fix it (then the boundary shows a manual\n * Reload action instead).\n *\n * Pure + port-injectable: detection is a pure predicate; the storage + reload\n * side effects are ports (default to `window`) so unit tests run deterministically\n * in jsdom without a real navigation.\n *\n * Promoted from the byte-identical `src/utils/chunkLoadRecovery.ts` triplets in\n * kefi-web, erevna-web and katalogos-web (extract-on-2nd-use; this was the 3rd).\n * The original file's own header predicted this move. Pairs with\n * `<AppErrorBoundary>` from `@dloizides/ui-feedback`, which consumes these as its\n * `retryable` / `onMount` / `recover` injections.\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` (see `navigation/redirect.ts`, which\n * makes the same call). Declaring the few properties used here keeps every other\n * util in the package from reaching for browser globals absent on the server.\n */\ninterface ChunkRecoveryStorage {\n  getItem: (key: string) => string | null;\n  setItem: (key: string, value: string) => void;\n  removeItem: (key: string) => void;\n}\n\ninterface BrowserWindow {\n  sessionStorage: ChunkRecoveryStorage;\n  location: { reload: () => void };\n}\n\ndeclare const window: BrowserWindow | undefined;\n\n/**\n * sessionStorage key holding the epoch-ms timestamp of the last auto-reload attempt.\n *\n * A TIMESTAMP, not the old boolean `ui.chunkReload.attempted`. The boolean was released\n * by the consumer on a clean mount, and a lazy route makes the mount clean: the root\n * boundary commits (a Suspense fallback renders), `componentDidMount` releases the guard,\n * and only THEN does the dynamic import reject with a 404 chunk. Recovery re-armed itself\n * on every pass, so the reload loop the guard exists to bound ran unbounded.\n */\nconst CHUNK_RELOAD_AT = 'ui.chunkReload.attemptedAt';\n\n/**\n * How long one recorded attempt keeps blocking a second automatic reload.\n *\n * WHY A WINDOW RATHER THAN A COUNTER: attempt-counting bounds the loop too, but a counter\n * has to be reset by somebody, and the only place a consumer can put that reset is a clean\n * mount — the exact release that caused this defect. A window expires by itself, so there is\n * no release call to fire at the wrong moment. One minute is far longer than a reload-plus-boot\n * cycle (single-digit seconds, which is what the loop runs at) and far shorter than the gap to\n * a genuinely later, unrelated rollout, which is still allowed to auto-recover once.\n */\nconst RECOVERY_COOLDOWN_MS = 60_000;\n\n/** Messages/names emitted by webpack/metro/vite/Safari for a stale-chunk failure. */\nconst CHUNK_ERROR_PATTERNS: readonly RegExp[] = [\n  /ChunkLoadError/i,\n  /Loading chunk [\\w-]+ failed/i,\n  /Loading CSS chunk/i,\n  /Failed to fetch dynamically imported module/i,\n  /error loading dynamically imported module/i,\n  /Importing a module script failed/i,\n  /is not a valid JavaScript MIME type/i,\n];\n\n/** Injectable side-effect ports; default to the real `window`. */\nexport interface ChunkRecoveryPorts {\n  /** Epoch-ms of the last recorded attempt, or `null` when none is stored. */\n  readAttemptAt: () => number | null;\n  recordAttemptAt: (at: number) => void;\n  clearAttempt: () => void;\n  reload: () => void;\n  now: () => number;\n}\n\n/** True when `error` looks like a stale-chunk / failed-dynamic-import failure. */\nexport function isChunkLoadError(error: unknown): boolean {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n  if (error.name === 'ChunkLoadError') {\n    return true;\n  }\n  const haystack = `${error.name} ${error.message}`;\n  return CHUNK_ERROR_PATTERNS.some((pattern) => pattern.test(haystack));\n}\n\nfunction resolveStorage(): ChunkRecoveryStorage | undefined {\n  if (typeof window === 'undefined') {\n    return undefined;\n  }\n  try {\n    return window.sessionStorage;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction defaultPorts(): ChunkRecoveryPorts {\n  const storage = resolveStorage();\n  const hasWindow = typeof window !== 'undefined';\n  return {\n    readAttemptAt: (): number | null => {\n      const raw = storage?.getItem(CHUNK_RELOAD_AT);\n      if (raw === null || raw === undefined || raw === '') {\n        return null;\n      }\n      const parsed = Number(raw);\n      return Number.isFinite(parsed) ? parsed : null;\n    },\n    recordAttemptAt: (at: number): void => {\n      storage?.setItem(CHUNK_RELOAD_AT, String(at));\n    },\n    clearAttempt: (): void => {\n      storage?.removeItem(CHUNK_RELOAD_AT);\n    },\n    now: (): number => Date.now(),\n    reload: (): void => {\n      if (hasWindow) {\n        window.location.reload();\n      }\n    },\n  };\n}\n\n/** True when a recorded attempt is still inside the cooldown window. */\nfunction isWithinCooldown(attemptedAt: number | null, now: number): boolean {\n  return attemptedAt !== null && now - attemptedAt < RECOVERY_COOLDOWN_MS;\n}\n\n/**\n * Attempt a guarded reload to recover from a stale-chunk error.\n * Returns `true` when a reload was triggered, `false` while the cooldown from the previous\n * attempt is still running (the caller then shows a manual Reload action, never a loop).\n *\n * `recordAttemptAt` and `reload` stay synchronous and adjacent so the record survives the\n * navigation that follows.\n */\nexport function attemptChunkRecovery(ports: ChunkRecoveryPorts = defaultPorts()): boolean {\n  const now = ports.now();\n  if (isWithinCooldown(ports.readAttemptAt(), now)) {\n    return false;\n  }\n  ports.recordAttemptAt(now);\n  ports.reload();\n  return true;\n}\n\n/**\n * Release the guard after a clean load — but ONLY once the cooldown has expired.\n *\n * Consumers call this from the root boundary's clean-mount hook, and on a lazy route that\n * mount happens BEFORE the chunk rejects. Refusing to clear a live record is what makes the\n * bound hold no matter when the consumer calls this: an expired record permits recovery\n * anyway, so clearing it only tidies storage, while a live one is left alone.\n */\nexport function clearChunkRecoveryFlag(ports: ChunkRecoveryPorts = defaultPorts()): void {\n  if (isWithinCooldown(ports.readAttemptAt(), ports.now())) {\n    return;\n  }\n  ports.clearAttempt();\n}\n\n/** Manually reload the page (the Reload action). */\nexport function reloadPage(ports: ChunkRecoveryPorts = defaultPorts()): void {\n  ports.reload();\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 { fireAndForget } from './fireAndForget';\nexport { singleFlight } from './singleFlight';\n","export { getErrorMessage } from './getErrorMessage';\n","export { formatDate } from './formatDate';\n","export { toCsv } from './toCsv';\nexport type { CsvColumn } from './toCsv';\n","export { setRedirectHandler, redirectTo, resetRedirectHandler } from './redirect';\n","export {\n  isChunkLoadError,\n  attemptChunkRecovery,\n  clearChunkRecoveryFlag,\n  reloadPage,\n} from './chunkRecovery';\nexport type { ChunkRecoveryPorts } from './chunkRecovery';\n","export {\n  sanitizeHtml,\n  removeControlCharacters,\n  sanitizeNotificationMessage,\n  sanitizeText,\n  sanitizeUrl,\n} from './sanitize';\n","import { isValueDefined } from '../guards/isValueDefined';\n\n/** Parses JSON and checks its shape; anything else gives null. */\nexport function parseChecked<T>(text: string | null, isShape: (value: unknown) => value is T): T | null {\n  if (!isValueDefined(text)) {return null;}\n  try {\n    const value: unknown = JSON.parse(text);\n    return isShape(value) ? value : null;\n  } catch {\n    return null;\n  }\n}\n\n/** Whether a value is an object holding these string fields. */\nexport function hasStringFields(value: unknown, fields: readonly string[]): boolean {\n  if (typeof value !== 'object' || !isValueDefined(value)) {return false;}\n  return fields.every((field) => typeof Reflect.get(value, field) === 'string');\n}\n\n/** Whether an object's field holds an array. */\nexport function hasArrayField(value: unknown, field: string): boolean {\n  return typeof value === 'object' && isValueDefined(value) && Array.isArray(Reflect.get(value, field));\n}\n\n/** Turns data into two-space JSON text ending in a newline. */\nexport function toFileJson(value: unknown): string {\n  return `${JSON.stringify(value, null, 2)}\\n`;\n}\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/async/fireAndForget.ts","../src/async/singleFlight.ts","../src/error/getErrorMessage.ts","../src/format/formatDate.ts","../src/csv/toCsv.ts","../src/sanitize/sanitize.ts","../src/navigation/redirect.ts","../src/chunkRecovery/chunkRecovery.ts","../src/guards/index.ts","../src/assertions/index.ts","../src/async/index.ts","../src/error/index.ts","../src/format/index.ts","../src/csv/index.ts","../src/navigation/index.ts","../src/chunkRecovery/index.ts","../src/sanitize/index.ts","../src/json/checkedJson.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;;;ACtBO,SAAS,cAAc,OAAA,EAAiC;AAC7D,EAAA,OAAA,CAAQ,KAAA,CAAM,MAAM,MAAS,CAAA;AAC/B;;;ACFO,SAAS,aAAgB,MAAA,EAAyD;AACvF,EAAA,IAAI,OAAA,GAAU,KAAA;AACd,EAAA,OAAO,CAAC,KAAA,KAAmB;AACzB,IAAA,IAAI,OAAA,EAAS;AAAC,MAAA;AAAA,IAAO;AACrB,IAAA,OAAA,GAAU,IAAA;AACV,IAAA,MAAA,CAAO,KAAK,CAAA,CACT,KAAA,CAAM,MAAM,MAAS,CAAA,CACrB,QAAQ,MAAM;AACb,MAAA,OAAA,GAAU,KAAA;AAAA,IACZ,CAAC,CAAA;AAAA,EACL,CAAA;AACF;;;ACNA,SAAS,mBAAmB,KAAA,EAA2C;AACrE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,cAAA,CAAe,KAAK,KAAK,SAAA,IAAa,KAAA;AAC5E;AASO,SAAS,eAAA,CAAgB,KAAA,EAAgB,QAAA,GAAW,eAAA,EAAyB;AAClF,EAAA,IAAI,iBAAiB,KAAA,EAAO;AAAC,IAAA,OAAO,KAAA,CAAM,OAAA;AAAA,EAAQ;AAClD,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAAC,IAAA,OAAO,KAAA;AAAA,EAAM;AAC7C,EAAA,IAAI,kBAAA,CAAmB,KAAK,CAAA,EAAG;AAC7B,IAAA,MAAM,UAAU,KAAA,CAAM,OAAA;AACtB,IAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,CAAQ,SAAS,CAAA,EAAG;AAAC,MAAA,OAAO,OAAA;AAAA,IAAQ;AAAA,EACzE;AACA,EAAA,OAAO,QAAA;AACT;;;ACjBO,SAAS,UAAA,CACd,IAAA,EACA,MAAA,EACA,OAAA,EACQ;AACR,EAAA,IAAI,IAAA,KAAS,IAAA,IAAQ,IAAA,KAAS,MAAA,EAAW;AAAC,IAAA,OAAO,EAAA;AAAA,EAAG;AAEpD,EAAA,MAAM,cAAA,GAAiB,MAAA,KAAW,EAAA,GAAK,MAAA,GAAS,IAAA;AAEhD,EAAA,IAAI;AACF,IAAA,OAAO,IAAI,IAAA,CAAK,cAAA,CAAe,gBAAgB,OAAO,CAAA,CAAE,OAAO,IAAI,CAAA;AAAA,EACrE,CAAA,CAAA,MAAQ;AAEN,IAAA,OAAO,KAAK,WAAA,EAAY,CAAE,MAAM,GAAG,CAAA,CAAE,CAAC,CAAA,IAAK,EAAA;AAAA,EAC7C;AACF;;;ACDA,IAAM,aAAA,GAAgB,WAAA;AAKtB,IAAM,KAAA,GAAQ,GAAA;AACd,IAAM,aAAA,GAAgB,IAAA;AAEtB,IAAM,WAAA,GAAc,IAAA;AAGpB,IAAM,aAAA,GAAgB,MAAA;AACtB,IAAM,eAAA,GAAkB,GAAA;AAGxB,SAAS,YAAY,GAAA,EAAiD;AACpE,EAAA,MAAM,OAAO,cAAA,CAAe,GAAG,CAAA,GAAI,MAAA,CAAO,GAAG,CAAA,GAAI,EAAA;AACjD,EAAA,IAAI,CAAC,aAAA,CAAc,IAAA,CAAK,IAAI,CAAA,EAAG;AAC7B,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,CAAA,EAAG,KAAK,CAAA,EAAG,IAAA,CAAK,QAAQ,WAAA,EAAa,aAAa,CAAC,CAAA,EAAG,KAAK,CAAA,CAAA;AACpE;AAQO,SAAS,KAAA,CAAS,MAAoB,OAAA,EAA8C;AACzF,EAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,GAAA,CAAI,CAAC,MAAA,KAAW,WAAA,CAAY,MAAA,CAAO,MAAM,CAAC,CAAA,CAAE,IAAA,CAAK,eAAe,CAAA;AAE3F,EAAA,MAAM,YAAY,IAAA,CAAK,GAAA;AAAA,IAAI,CAAC,GAAA,KAC1B,OAAA,CAAQ,GAAA,CAAI,CAAC,MAAA,KAAW,WAAA,CAAY,MAAA,CAAO,KAAA,CAAM,GAAG,CAAC,CAAC,CAAA,CAAE,KAAK,eAAe;AAAA,GAC9E;AAEA,EAAA,OAAO,CAAC,UAAA,EAAY,GAAG,SAAS,CAAA,CAAE,KAAK,aAAa,CAAA;AACtD;;;ACnDA,IAAM,aAAA,GAAwC;AAAA,EAC5C,GAAA,EAAK,OAAA;AAAA,EACL,GAAA,EAAK,MAAA;AAAA,EACL,GAAA,EAAK,MAAA;AAAA,EACL,GAAA,EAAK,QAAA;AAAA,EACL,GAAA,EAAK,QAAA;AAAA,EACL,GAAA,EAAK,QAAA;AAAA,EACL,GAAA,EAAK,QAAA;AAAA,EACL,GAAA,EAAK;AACP,CAAA;AAKA,IAAM,iBAAA,GAAoB,aAAA;AAS1B,IAAM,gBAAA,GAAmB,CAAA;AAEzB,IAAM,cAAA,GAAiB,EAAA;AAEvB,IAAM,gBAAA,GAAmB,GAAA;AAEzB,IAAM,cAAA,GAAiB,GAAA;AAEvB,IAAM,gBAAA,GAAmB,IAAA;AAEzB,IAAM,cAAA,GAAiB,IAAA;AAEvB,IAAM,kBAAA,GAAqB,IAAA;AAE3B,IAAM,gBAAA,GAAmB,IAAA;AAEzB,IAAM,eAAA,GAAkB,KAAA;AAKxB,IAAM,uBAAA,GAA0B,GAAA;AAKhC,IAAM,eAAA,GAAkB,CAAA;AAajB,SAAS,aAAa,IAAA,EAAsB;AACjD,EAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AAAC,IAAA,OAAO,EAAA;AAAA,EAAG;AAClC,EAAA,OAAO,IAAA,CAAK,QAAQ,iBAAA,EAAmB,CAAC,SAAS,aAAA,CAAc,IAAI,KAAK,IAAI,CAAA;AAC9E;AAMA,SAAS,oBAAoB,IAAA,EAAuB;AAClD,EAAA,MAAM,WAAA,GAAc,IAAA,IAAQ,gBAAA,IAAoB,IAAA,IAAQ,cAAA;AACxD,EAAA,MAAM,WAAA,GAAc,IAAA,IAAQ,gBAAA,IAAoB,IAAA,IAAQ,cAAA;AACxD,EAAA,MAAM,WAAA,GAAc,IAAA,IAAQ,gBAAA,IAAoB,IAAA,IAAQ,cAAA;AACxD,EAAA,MAAM,YAAA,GAAe,IAAA,IAAQ,kBAAA,IAAsB,IAAA,IAAQ,gBAAA;AAC3D,EAAA,MAAM,QAAQ,IAAA,KAAS,eAAA;AACvB,EAAA,OAAO,WAAA,IAAe,WAAA,IAAe,WAAA,IAAe,YAAA,IAAgB,KAAA;AACtE;AASO,SAAS,wBAAwB,IAAA,EAAsB;AAC5D,EAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AAAC,IAAA,OAAO,EAAA;AAAA,EAAG;AAClC,EAAA,IAAI,GAAA,GAAM,EAAA;AACV,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,IAAA,CAAK,QAAQ,CAAA,EAAA,EAAK;AACpC,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,UAAA,CAAW,CAAC,CAAA;AAC9B,IAAA,IAAI,CAAC,mBAAA,CAAoB,IAAI,CAAA,EAAG;AAAC,MAAA,GAAA,IAAO,KAAK,CAAC,CAAA;AAAA,IAAE;AAAA,EAClD;AACA,EAAA,OAAO,GAAA;AACT;AAqBO,SAAS,2BAAA,CACd,OAAA,EACA,SAAA,GAAoB,uBAAA,EACZ;AACR,EAAA,IAAI,OAAA,CAAQ,WAAW,CAAA,EAAG;AAAC,IAAA,OAAO,EAAA;AAAA,EAAG;AAGrC,EAAA,IAAI,SAAA,GAAY,wBAAwB,OAAO,CAAA;AAG/C,EAAA,SAAA,GAAY,UAAU,IAAA,EAAK;AAG3B,EAAA,IAAI,SAAA,CAAU,SAAS,SAAA,EACrB;AAAC,IAAA,SAAA,GAAY,GAAG,SAAA,CAAU,SAAA,CAAU,CAAA,EAAG,SAAA,GAAY,eAAe,CAAC,CAAA,GAAA,CAAA;AAAA,EAAM;AAI3E,EAAA,SAAA,GAAY,aAAa,SAAS,CAAA;AAElC,EAAA,OAAO,SAAA;AACT;AAWO,SAAS,YAAA,CAAa,MAAc,SAAA,EAA4B;AACrE,EAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AAAC,IAAA,OAAO,EAAA;AAAA,EAAG;AAElC,EAAA,IAAI,SAAA,GAAY,wBAAwB,IAAI,CAAA;AAC5C,EAAA,SAAA,GAAY,UAAU,IAAA,EAAK;AAE3B,EAAA,MAAM,iBAAA,GAAoB,OAAO,SAAA,KAAc,QAAA,IAAY,SAAA,GAAY,CAAA;AACvE,EAAA,MAAM,gBAAA,GAAmB,iBAAA,IAAqB,SAAA,CAAU,MAAA,GAAS,SAAA;AACjE,EAAA,IAAI,gBAAA,EACF;AAAC,IAAA,SAAA,GAAY,GAAG,SAAA,CAAU,SAAA,CAAU,CAAA,EAAG,SAAA,GAAY,eAAe,CAAC,CAAA,GAAA,CAAA;AAAA,EAAM;AAG3E,EAAA,OAAO,SAAA;AACT;AAQO,SAAS,YAAY,GAAA,EAAqB;AAC/C,EAAA,IAAI,GAAA,CAAI,WAAW,CAAA,EAAG;AAAC,IAAA,OAAO,EAAA;AAAA,EAAG;AAEjC,EAAA,MAAM,YAAA,GAAe,GAAA,CAAI,IAAA,EAAK,CAAE,WAAA,EAAY;AAC5C,EAAA,MAAM,QAAA,GAAW,YAAA,CAAa,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA;AAG1C,EAAA,MAAM,mBAAA,GAAsB,QAAA,KAAa,YAAA,IAAgB,QAAA,KAAa,UAAU,QAAA,KAAa,UAAA;AAC7F,EAAA,IAAI,mBAAA,EACF;AAAC,IAAA,OAAO,EAAA;AAAA,EAAG;AAGb,EAAA,OAAO,IAAI,IAAA,EAAK;AAClB;;;ACnJA,IAAM,yBAAA,GAA4B,GAAA;AAElC,IAAI,eAAA,GAAmD,IAAA;AACvD,IAAM,kBAA4B,EAAC;AAOnC,SAAS,oBAAoB,IAAA,EAAsB;AACjD,EAAA,MAAM,UAAA,GAAa,IAAA,CAAK,OAAA,CAAQ,cAAA,EAAgB,EAAE,CAAA;AAClD,EAAA,OAAO,UAAA,KAAe,KAAK,GAAA,GAAM,UAAA;AACnC;AAGA,SAAS,kBAAA,GAAoC;AAC3C,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AAAC,IAAA,OAAO,IAAA;AAAA,EAAK;AAChD,EAAA,OAAO,CAAA,EAAG,MAAA,CAAO,QAAA,CAAS,QAAQ,CAAA,EAAG,MAAA,CAAO,QAAA,CAAS,MAAM,CAAA,EAAG,MAAA,CAAO,QAAA,CAAS,IAAI,CAAA,CAAA;AACpF;AAGA,SAAS,0BAAA,CAA2B,QAAgB,UAAA,EAA0B;AAC5E,EAAA,UAAA,CAAW,MAAM;AACf,IAAA,IAAI;AACF,MAAA,MAAM,QAAQ,kBAAA,EAAmB;AACjC,MAAA,IAAI,KAAA,KAAU,MAAA,IAAU,OAAO,MAAA,KAAW,WAAA,EAAa;AAAC,QAAA,MAAA,CAAO,QAAA,CAAS,QAAQ,UAAU,CAAA;AAAA,MAAE;AAAA,IAC9F,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF,GAAG,yBAAyB,CAAA;AAC9B;AAGA,SAAS,oBAAoB,UAAA,EAA6B;AACxD,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AAAC,IAAA,OAAO,KAAA;AAAA,EAAM;AACjD,EAAA,IAAI;AACF,IAAA,MAAA,CAAO,QAAA,CAAS,QAAQ,UAAU,CAAA;AAClC,IAAA,OAAO,IAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;AAMO,SAAS,mBAAmB,CAAA,EAAiC;AAClE,EAAA,eAAA,GAAkB,CAAA;AAClB,EAAA,OAAO,eAAA,CAAgB,SAAS,CAAA,EAAG;AACjC,IAAA,MAAM,CAAA,GAAI,gBAAgB,KAAA,EAAM;AAChC,IAAA,IAAI;AACF,MAAA,IAAI,OAAO,CAAA,KAAM,QAAA,IAAY,CAAA,CAAE,SAAS,CAAA,EAAG;AAAC,QAAA,CAAA,CAAE,mBAAA,CAAoB,CAAC,CAAC,CAAA;AAAA,MAAE;AAAA,IACxE,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AACF;AAMO,SAAS,WAAW,IAAA,EAAoB;AAC7C,EAAA,MAAM,UAAA,GAAa,oBAAoB,IAAI,CAAA;AAC3C,EAAA,IAAI,eAAA,EAAiB;AACnB,IAAA,MAAM,SAAS,kBAAA,EAAmB;AAClC,IAAA,IAAI;AACF,MAAA,eAAA,CAAgB,UAAU,CAAA;AAC1B,MAAA,IAAI,OAAO,WAAW,QAAA,EAAU;AAAC,QAAA,0BAAA,CAA2B,QAAQ,UAAU,CAAA;AAAA,MAAE;AAChF,MAAA;AAAA,IACF,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AACA,EAAA,IAAI,mBAAA,CAAoB,UAAU,CAAA,EAAG;AAAC,IAAA;AAAA,EAAO;AAC7C,EAAA,eAAA,CAAgB,KAAK,UAAU,CAAA;AACjC;AAMO,SAAS,oBAAA,GAA6B;AAC3C,EAAA,eAAA,GAAkB,IAAA;AAClB,EAAA,eAAA,CAAgB,MAAA,GAAS,CAAA;AAC3B;;;AC9EA,IAAM,eAAA,GAAkB,4BAAA;AAYxB,IAAM,oBAAA,GAAuB,GAAA;AAG7B,IAAM,oBAAA,GAA0C;AAAA,EAC9C,iBAAA;AAAA,EACA,8BAAA;AAAA,EACA,oBAAA;AAAA,EACA,8CAAA;AAAA,EACA,4CAAA;AAAA,EACA,mCAAA;AAAA,EACA;AACF,CAAA;AAaO,SAAS,iBAAiB,KAAA,EAAyB;AACxD,EAAA,IAAI,EAAE,iBAAiB,KAAA,CAAA,EAAQ;AAC7B,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,IAAI,KAAA,CAAM,SAAS,gBAAA,EAAkB;AACnC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,WAAW,CAAA,EAAG,KAAA,CAAM,IAAI,CAAA,CAAA,EAAI,MAAM,OAAO,CAAA,CAAA;AAC/C,EAAA,OAAO,qBAAqB,IAAA,CAAK,CAAC,YAAY,OAAA,CAAQ,IAAA,CAAK,QAAQ,CAAC,CAAA;AACtE;AAEA,SAAS,cAAA,GAAmD;AAC1D,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,IAAI;AACF,IAAA,OAAO,MAAA,CAAO,cAAA;AAAA,EAChB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,MAAA;AAAA,EACT;AACF;AAEA,SAAS,YAAA,GAAmC;AAC1C,EAAA,MAAM,UAAU,cAAA,EAAe;AAC/B,EAAA,MAAM,SAAA,GAAY,OAAO,MAAA,KAAW,WAAA;AACpC,EAAA,OAAO;AAAA,IACL,eAAe,MAAqB;AAClC,MAAA,MAAM,GAAA,GAAM,OAAA,EAAS,OAAA,CAAQ,eAAe,CAAA;AAC5C,MAAA,IAAI,GAAA,KAAQ,IAAA,IAAQ,GAAA,KAAQ,MAAA,IAAa,QAAQ,EAAA,EAAI;AACnD,QAAA,OAAO,IAAA;AAAA,MACT;AACA,MAAA,MAAM,MAAA,GAAS,OAAO,GAAG,CAAA;AACzB,MAAA,OAAO,MAAA,CAAO,QAAA,CAAS,MAAM,CAAA,GAAI,MAAA,GAAS,IAAA;AAAA,IAC5C,CAAA;AAAA,IACA,eAAA,EAAiB,CAAC,EAAA,KAAqB;AACrC,MAAA,OAAA,EAAS,OAAA,CAAQ,eAAA,EAAiB,MAAA,CAAO,EAAE,CAAC,CAAA;AAAA,IAC9C,CAAA;AAAA,IACA,cAAc,MAAY;AACxB,MAAA,OAAA,EAAS,WAAW,eAAe,CAAA;AAAA,IACrC,CAAA;AAAA,IACA,GAAA,EAAK,MAAc,IAAA,CAAK,GAAA,EAAI;AAAA,IAC5B,QAAQ,MAAY;AAClB,MAAA,IAAI,SAAA,EAAW;AACb,QAAA,MAAA,CAAO,SAAS,MAAA,EAAO;AAAA,MACzB;AAAA,IACF;AAAA,GACF;AACF;AAGA,SAAS,gBAAA,CAAiB,aAA4B,GAAA,EAAsB;AAC1E,EAAA,OAAO,WAAA,KAAgB,IAAA,IAAQ,GAAA,GAAM,WAAA,GAAc,oBAAA;AACrD;AAUO,SAAS,oBAAA,CAAqB,KAAA,GAA4B,YAAA,EAAa,EAAY;AACxF,EAAA,MAAM,GAAA,GAAM,MAAM,GAAA,EAAI;AACtB,EAAA,IAAI,gBAAA,CAAiB,KAAA,CAAM,aAAA,EAAc,EAAG,GAAG,CAAA,EAAG;AAChD,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,KAAA,CAAM,gBAAgB,GAAG,CAAA;AACzB,EAAA,KAAA,CAAM,MAAA,EAAO;AACb,EAAA,OAAO,IAAA;AACT;AAUO,SAAS,sBAAA,CAAuB,KAAA,GAA4B,YAAA,EAAa,EAAS;AACvF,EAAA,IAAI,iBAAiB,KAAA,CAAM,aAAA,IAAiB,KAAA,CAAM,GAAA,EAAK,CAAA,EAAG;AACxD,IAAA;AAAA,EACF;AACA,EAAA,KAAA,CAAM,YAAA,EAAa;AACrB;AAGO,SAAS,WAAW,KAAA,EAAkC;AAC3D,EAAA,MAAM,SAAS,OAAO,KAAA,EAAO,MAAA,KAAW,UAAA,GAAa,QAAQ,YAAA,EAAa;AAC1E,EAAA,MAAA,CAAO,MAAA,EAAO;AAChB;;;ACnLA,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;;;ACAA,IAAA,aAAA,GAAA;AAAA,QAAA,CAAA,aAAA,EAAA;AAAA,EAAA,aAAA,EAAA,MAAA,aAAA;AAAA,EAAA,YAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACAA,IAAA,aAAA,GAAA;AAAA,QAAA,CAAA,aAAA,EAAA;AAAA,EAAA,eAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACAA,IAAA,cAAA,GAAA;AAAA,QAAA,CAAA,cAAA,EAAA;AAAA,EAAA,UAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACAA,IAAA,WAAA,GAAA;AAAA,QAAA,CAAA,WAAA,EAAA;AAAA,EAAA,KAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACAA,IAAA,kBAAA,GAAA;AAAA,QAAA,CAAA,kBAAA,EAAA;AAAA,EAAA,UAAA,EAAA,MAAA,UAAA;AAAA,EAAA,oBAAA,EAAA,MAAA,oBAAA;AAAA,EAAA,kBAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACAA,IAAA,qBAAA,GAAA;AAAA,QAAA,CAAA,qBAAA,EAAA;AAAA,EAAA,oBAAA,EAAA,MAAA,oBAAA;AAAA,EAAA,sBAAA,EAAA,MAAA,sBAAA;AAAA,EAAA,gBAAA,EAAA,MAAA,gBAAA;AAAA,EAAA,UAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACAA,IAAA,gBAAA,GAAA;AAAA,QAAA,CAAA,gBAAA,EAAA;AAAA,EAAA,uBAAA,EAAA,MAAA,uBAAA;AAAA,EAAA,YAAA,EAAA,MAAA,YAAA;AAAA,EAAA,2BAAA,EAAA,MAAA,2BAAA;AAAA,EAAA,YAAA,EAAA,MAAA,YAAA;AAAA,EAAA,WAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACGO,SAAS,YAAA,CAAgB,MAAqB,OAAA,EAAmD;AACtG,EAAA,IAAI,CAAC,cAAA,CAAe,IAAI,CAAA,EAAG;AAAC,IAAA,OAAO,IAAA;AAAA,EAAK;AACxC,EAAA,IAAI;AACF,IAAA,MAAM,KAAA,GAAiB,IAAA,CAAK,KAAA,CAAM,IAAI,CAAA;AACtC,IAAA,OAAO,OAAA,CAAQ,KAAK,CAAA,GAAI,KAAA,GAAQ,IAAA;AAAA,EAClC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAGO,SAAS,eAAA,CAAgB,OAAgB,MAAA,EAAoC;AAClF,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,CAAC,cAAA,CAAe,KAAK,CAAA,EAAG;AAAC,IAAA,OAAO,KAAA;AAAA,EAAM;AACvE,EAAA,OAAO,MAAA,CAAO,KAAA,CAAM,CAAC,KAAA,KAAU,OAAO,QAAQ,GAAA,CAAI,KAAA,EAAO,KAAK,CAAA,KAAM,QAAQ,CAAA;AAC9E;AAGO,SAAS,aAAA,CAAc,OAAgB,KAAA,EAAwB;AACpE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,cAAA,CAAe,KAAK,CAAA,IAAK,KAAA,CAAM,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,KAAA,EAAO,KAAK,CAAC,CAAA;AACtG;AAGO,SAAS,WAAW,KAAA,EAAwB;AACjD,EAAA,OAAO,GAAG,IAAA,CAAK,SAAA,CAAU,KAAA,EAAO,IAAA,EAAM,CAAC,CAAC;AAAA,CAAA;AAC1C","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","/** Starts a promise without awaiting it and swallows its rejection. */\nexport function fireAndForget(promise: Promise<unknown>): void {\n  promise.catch(() => undefined);\n}\n","/** Wraps an async action so a second call while the first runs does nothing: one Enter or tap, one request. */\nexport function singleFlight<T>(action: (input: T) => Promise<void>): (input: T) => void {\n  let running = false;\n  return (input: T): void => {\n    if (running) {return;}\n    running = true;\n    action(input)\n      .catch(() => undefined)\n      .finally(() => {\n        running = false;\n      });\n  };\n}\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 * RFC 4180 CSV serialization — the pure, DOM-free core of \"export the rows on screen to CSV\".\n *\n * The escaping is the whole risk surface: a comma, a quote or a newline inside a value (a\n * counterparty name, an address) is exactly what turns one row into two columns or two rows in a\n * spreadsheet. So the serializer lives here as a pure, total function a unit test can hammer, split\n * from any browser download shell (which is a side-effecting, app-owned concern).\n *\n * Promoted from finreg-web's `utils/exportCsv.ts` (ZY-25) — the escaping logic is universal across\n * the fleet; the DOM `<a download>` shell that consumes it stays in the app until a 2nd consumer.\n */\nimport { isValueDefined } from '../guards/isValueDefined';\n\n/** One column of a CSV export: a (caller-localized) header and how to read the cell from a row. */\nexport interface CsvColumn<T> {\n  /** The column header — already localized by the caller. */\n  header: string;\n  /** Reads the cell value from a row. `null`/`undefined` become an empty cell. */\n  value: (row: T) => string | number | null | undefined;\n}\n\n/** RFC 4180: a field must be quoted when it contains a quote, a comma, or a line break. */\nconst NEEDS_QUOTING = /[\"',\\r\\n]/;\n\n// A more permissive test than strictly required (it also quotes apostrophes), so a value like\n// O'Brien is never split by a spreadsheet that treats a leading quote specially — harmless, and it\n// keeps the rule to one regex.\nconst QUOTE = '\"';\nconst ESCAPED_QUOTE = '\"\"';\n/** Every embedded quote, so each is doubled per RFC 4180 (ES2020-safe; no `replaceAll`). */\nconst EVERY_QUOTE = /\"/g;\n\n/** RFC 4180 uses CRLF between records; Excel and Sheets both require it. */\nconst ROW_SEPARATOR = '\\r\\n';\nconst FIELD_SEPARATOR = ',';\n\n/** Quote and escape a single field per RFC 4180. `null`/`undefined` → an empty field. */\nfunction escapeField(raw: string | number | null | undefined): string {\n  const text = isValueDefined(raw) ? String(raw) : '';\n  if (!NEEDS_QUOTING.test(text)) {\n    return text;\n  }\n  return `${QUOTE}${text.replace(EVERY_QUOTE, ESCAPED_QUOTE)}${QUOTE}`;\n}\n\n/**\n * Serialize rows to an RFC 4180 CSV string — a header row followed by one row per item.\n *\n * Pure and total: an empty `rows` yields the header line alone, which opens as an empty-but-labelled\n * spreadsheet rather than a zero-byte file the operator cannot tell apart from a failure.\n */\nexport function toCsv<T>(rows: readonly T[], columns: ReadonlyArray<CsvColumn<T>>): string {\n  const headerLine = columns.map((column) => escapeField(column.header)).join(FIELD_SEPARATOR);\n\n  const dataLines = rows.map((row) =>\n    columns.map((column) => escapeField(column.value(row))).join(FIELD_SEPARATOR),\n  );\n\n  return [headerLine, ...dataLines].join(ROW_SEPARATOR);\n}\n","/**\n * Text sanitization utilities for preventing XSS and ensuring safe display.\n * These utilities sanitize user-provided text before rendering.\n */\n\n/**\n * HTML entities that should be escaped to prevent XSS attacks.\n */\nconst HTML_ENTITIES: Record<string, string> = {\n  '&': '&amp;',\n  '<': '&lt;',\n  '>': '&gt;',\n  '\"': '&quot;',\n  \"'\": '&#x27;',\n  '/': '&#x2F;',\n  '`': '&#x60;',\n  '=': '&#x3D;',\n};\n\n/**\n * Regular expression matching characters that need escaping.\n */\nconst HTML_ESCAPE_REGEX = /[&<>\"'`=/]/g;\n\n/**\n * Unicode code point ranges for dangerous characters.\n * These are control characters and zero-width characters that can be\n * used in homograph attacks or to hide malicious content.\n */\n\n/** C0 control characters range start (NULL) */\nconst C0_CONTROL_START = 0x0000;\n/** C0 control characters range end (Unit Separator) */\nconst C0_CONTROL_END = 0x001f;\n/** C1 control characters range start (DEL and beyond) */\nconst C1_CONTROL_START = 0x007f;\n/** C1 control characters range end */\nconst C1_CONTROL_END = 0x009f;\n/** Zero-width characters range start (Zero Width Space) */\nconst ZERO_WIDTH_START = 0x200b;\n/** Zero-width characters range end (Right-to-Left Mark) */\nconst ZERO_WIDTH_END = 0x200f;\n/** Format characters range start (Line Separator) */\nconst FORMAT_CHARS_START = 0x2028;\n/** Format characters range end (Narrow No-Break Space) */\nconst FORMAT_CHARS_END = 0x202f;\n/** Byte Order Mark code point */\nconst BYTE_ORDER_MARK = 0xfeff;\n\n/**\n * Maximum reasonable length for notification messages.\n */\nconst MAX_NOTIFICATION_LENGTH = 500;\n\n/**\n * Length of ellipsis suffix (\"...\") used when truncating text.\n */\nconst ELLIPSIS_LENGTH = 3;\n\n/**\n * Escapes HTML special characters in a string to prevent XSS attacks.\n * Use this when displaying user-provided content in the UI.\n *\n * @param text - The text to sanitize\n * @returns The sanitized text with HTML entities escaped\n *\n * @example\n * sanitizeHtml('<script>alert(\"xss\")</script>')\n * // Returns: '&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;'\n */\nexport function sanitizeHtml(text: string): string {\n  if (text.length === 0) {return '';}\n  return text.replace(HTML_ESCAPE_REGEX, (char) => HTML_ENTITIES[char] ?? char);\n}\n\n/**\n * Control characters and zero-width characters that should be removed.\n * These can be used in homograph attacks or to hide malicious content.\n */\nfunction isDangerousCharCode(code: number): boolean {\n  const isC0Control = code >= C0_CONTROL_START && code <= C0_CONTROL_END;\n  const isC1Control = code >= C1_CONTROL_START && code <= C1_CONTROL_END;\n  const isZeroWidth = code >= ZERO_WIDTH_START && code <= ZERO_WIDTH_END;\n  const isFormatChar = code >= FORMAT_CHARS_START && code <= FORMAT_CHARS_END;\n  const isBom = code === BYTE_ORDER_MARK;\n  return isC0Control || isC1Control || isZeroWidth || isFormatChar || isBom;\n}\n\n/**\n * Removes control characters and zero-width characters from text.\n * These characters can be used to create misleading text or hide content.\n *\n * @param text - The text to sanitize\n * @returns The text with dangerous characters removed\n */\nexport function removeControlCharacters(text: string): string {\n  if (text.length === 0) {return '';}\n  let out = '';\n  for (let i = 0; i < text.length; i++) {\n    const code = text.charCodeAt(i);\n    if (!isDangerousCharCode(code)) {out += text[i];}\n  }\n  return out;\n}\n\n/**\n * Sanitizes a notification message for safe display.\n * This function:\n * 1. Removes control/zero-width characters\n * 2. Trims whitespace\n * 3. Truncates to a reasonable length\n * 4. Escapes HTML entities (for web platform)\n *\n * Note: React Native's Text component already escapes HTML by default,\n * but this provides defense-in-depth and handles the web platform.\n *\n * @param message - The notification message to sanitize\n * @param maxLength - Maximum length (default: 500)\n * @returns The sanitized message\n *\n * @example\n * sanitizeNotificationMessage('  Hello <b>World</b>  ')\n * // Returns: 'Hello &lt;b&gt;World&lt;/b&gt;'\n */\nexport function sanitizeNotificationMessage(\n  message: string,\n  maxLength: number = MAX_NOTIFICATION_LENGTH\n): string {\n  if (message.length === 0) {return '';}\n\n  // Remove dangerous characters first\n  let sanitized = removeControlCharacters(message);\n\n  // Trim whitespace\n  sanitized = sanitized.trim();\n\n  // Truncate if too long\n  if (sanitized.length > maxLength) \n    {sanitized = `${sanitized.substring(0, maxLength - ELLIPSIS_LENGTH)}...`;}\n  \n\n  // Escape HTML entities\n  sanitized = sanitizeHtml(sanitized);\n\n  return sanitized;\n}\n\n/**\n * Sanitizes text for safe display, without HTML escaping.\n * Use this for React Native components where HTML escaping isn't needed\n * but control character removal and length limits are still important.\n *\n * @param text - The text to sanitize\n * @param maxLength - Maximum length (optional)\n * @returns The sanitized text\n */\nexport function sanitizeText(text: string, maxLength?: number): string {\n  if (text.length === 0) {return '';}\n\n  let sanitized = removeControlCharacters(text);\n  sanitized = sanitized.trim();\n\n  const hasValidMaxLength = typeof maxLength === 'number' && maxLength > 0;\n  const exceedsMaxLength = hasValidMaxLength && sanitized.length > maxLength;\n  if (exceedsMaxLength) \n    {sanitized = `${sanitized.substring(0, maxLength - ELLIPSIS_LENGTH)}...`;}\n  \n\n  return sanitized;\n}\n\n/**\n * Validates and sanitizes a URL to prevent javascript: and data: protocol attacks.\n *\n * @param url - The URL to validate\n * @returns The sanitized URL or empty string if invalid\n */\nexport function sanitizeUrl(url: string): string {\n  if (url.length === 0) {return '';}\n\n  const trimmedLower = url.trim().toLowerCase();\n  const protocol = trimmedLower.split(':')[0];\n\n  // Block dangerous protocols\n  const isDangerousProtocol = protocol === 'javascript' || protocol === 'data' || protocol === 'vbscript';\n  if (isDangerousProtocol) \n    {return '';}\n  \n\n  return url.trim();\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","/**\n * Detection + one-shot auto-recovery for stale-chunk load failures.\n *\n * WHY (UX Move 3, would have masked P0-01): after a deploy, the browser may hold\n * a stale `index.html` that references hashed JS chunks which now 404 — surfacing\n * as a `ChunkLoadError` / \"failed to fetch dynamically imported module\". A single\n * guarded `location.reload()` re-fetches the fresh entry + chunks and the app\n * recovers with no user-visible error. The sessionStorage one-shot flag prevents\n * a reload LOOP if the reload does not fix it (then the boundary shows a manual\n * Reload action instead).\n *\n * Pure + port-injectable: detection is a pure predicate; the storage + reload\n * side effects are ports (default to `window`) so unit tests run deterministically\n * in jsdom without a real navigation.\n *\n * Promoted from the byte-identical `src/utils/chunkLoadRecovery.ts` triplets in\n * kefi-web, erevna-web and katalogos-web (extract-on-2nd-use; this was the 3rd).\n * The original file's own header predicted this move. Pairs with\n * `<AppErrorBoundary>` from `@dloizides/ui-feedback`, which consumes these as its\n * `retryable` / `onMount` / `recover` injections.\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` (see `navigation/redirect.ts`, which\n * makes the same call). Declaring the few properties used here keeps every other\n * util in the package from reaching for browser globals absent on the server.\n */\ninterface ChunkRecoveryStorage {\n  getItem: (key: string) => string | null;\n  setItem: (key: string, value: string) => void;\n  removeItem: (key: string) => void;\n}\n\ninterface BrowserWindow {\n  sessionStorage: ChunkRecoveryStorage;\n  location: { reload: () => void };\n}\n\ndeclare const window: BrowserWindow | undefined;\n\n/**\n * sessionStorage key holding the epoch-ms timestamp of the last auto-reload attempt.\n *\n * A TIMESTAMP, not the old boolean `ui.chunkReload.attempted`. The boolean was released\n * by the consumer on a clean mount, and a lazy route makes the mount clean: the root\n * boundary commits (a Suspense fallback renders), `componentDidMount` releases the guard,\n * and only THEN does the dynamic import reject with a 404 chunk. Recovery re-armed itself\n * on every pass, so the reload loop the guard exists to bound ran unbounded.\n */\nconst CHUNK_RELOAD_AT = 'ui.chunkReload.attemptedAt';\n\n/**\n * How long one recorded attempt keeps blocking a second automatic reload.\n *\n * WHY A WINDOW RATHER THAN A COUNTER: attempt-counting bounds the loop too, but a counter\n * has to be reset by somebody, and the only place a consumer can put that reset is a clean\n * mount — the exact release that caused this defect. A window expires by itself, so there is\n * no release call to fire at the wrong moment. One minute is far longer than a reload-plus-boot\n * cycle (single-digit seconds, which is what the loop runs at) and far shorter than the gap to\n * a genuinely later, unrelated rollout, which is still allowed to auto-recover once.\n */\nconst RECOVERY_COOLDOWN_MS = 60_000;\n\n/** Messages/names emitted by webpack/metro/vite/Safari for a stale-chunk failure. */\nconst CHUNK_ERROR_PATTERNS: readonly RegExp[] = [\n  /ChunkLoadError/i,\n  /Loading chunk [\\w-]+ failed/i,\n  /Loading CSS chunk/i,\n  /Failed to fetch dynamically imported module/i,\n  /error loading dynamically imported module/i,\n  /Importing a module script failed/i,\n  /is not a valid JavaScript MIME type/i,\n];\n\n/** Injectable side-effect ports; default to the real `window`. */\nexport interface ChunkRecoveryPorts {\n  /** Epoch-ms of the last recorded attempt, or `null` when none is stored. */\n  readAttemptAt: () => number | null;\n  recordAttemptAt: (at: number) => void;\n  clearAttempt: () => void;\n  reload: () => void;\n  now: () => number;\n}\n\n/** True when `error` looks like a stale-chunk / failed-dynamic-import failure. */\nexport function isChunkLoadError(error: unknown): boolean {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n  if (error.name === 'ChunkLoadError') {\n    return true;\n  }\n  const haystack = `${error.name} ${error.message}`;\n  return CHUNK_ERROR_PATTERNS.some((pattern) => pattern.test(haystack));\n}\n\nfunction resolveStorage(): ChunkRecoveryStorage | undefined {\n  if (typeof window === 'undefined') {\n    return undefined;\n  }\n  try {\n    return window.sessionStorage;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction defaultPorts(): ChunkRecoveryPorts {\n  const storage = resolveStorage();\n  const hasWindow = typeof window !== 'undefined';\n  return {\n    readAttemptAt: (): number | null => {\n      const raw = storage?.getItem(CHUNK_RELOAD_AT);\n      if (raw === null || raw === undefined || raw === '') {\n        return null;\n      }\n      const parsed = Number(raw);\n      return Number.isFinite(parsed) ? parsed : null;\n    },\n    recordAttemptAt: (at: number): void => {\n      storage?.setItem(CHUNK_RELOAD_AT, String(at));\n    },\n    clearAttempt: (): void => {\n      storage?.removeItem(CHUNK_RELOAD_AT);\n    },\n    now: (): number => Date.now(),\n    reload: (): void => {\n      if (hasWindow) {\n        window.location.reload();\n      }\n    },\n  };\n}\n\n/** True when a recorded attempt is still inside the cooldown window. */\nfunction isWithinCooldown(attemptedAt: number | null, now: number): boolean {\n  return attemptedAt !== null && now - attemptedAt < RECOVERY_COOLDOWN_MS;\n}\n\n/**\n * Attempt a guarded reload to recover from a stale-chunk error.\n * Returns `true` when a reload was triggered, `false` while the cooldown from the previous\n * attempt is still running (the caller then shows a manual Reload action, never a loop).\n *\n * `recordAttemptAt` and `reload` stay synchronous and adjacent so the record survives the\n * navigation that follows.\n */\nexport function attemptChunkRecovery(ports: ChunkRecoveryPorts = defaultPorts()): boolean {\n  const now = ports.now();\n  if (isWithinCooldown(ports.readAttemptAt(), now)) {\n    return false;\n  }\n  ports.recordAttemptAt(now);\n  ports.reload();\n  return true;\n}\n\n/**\n * Release the guard after a clean load — but ONLY once the cooldown has expired.\n *\n * Consumers call this from the root boundary's clean-mount hook, and on a lazy route that\n * mount happens BEFORE the chunk rejects. Refusing to clear a live record is what makes the\n * bound hold no matter when the consumer calls this: an expired record permits recovery\n * anyway, so clearing it only tidies storage, while a live one is left alone.\n */\nexport function clearChunkRecoveryFlag(ports: ChunkRecoveryPorts = defaultPorts()): void {\n  if (isWithinCooldown(ports.readAttemptAt(), ports.now())) {\n    return;\n  }\n  ports.clearAttempt();\n}\n\n/** Manually reload the page (the Reload action); an argument without `reload`, such as a click event, is ignored. */\nexport function reloadPage(ports?: ChunkRecoveryPorts): void {\n  const target = typeof ports?.reload === 'function' ? ports : defaultPorts();\n  target.reload();\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 { fireAndForget } from './fireAndForget';\nexport { singleFlight } from './singleFlight';\n","export { getErrorMessage } from './getErrorMessage';\n","export { formatDate } from './formatDate';\n","export { toCsv } from './toCsv';\nexport type { CsvColumn } from './toCsv';\n","export { setRedirectHandler, redirectTo, resetRedirectHandler } from './redirect';\n","export {\n  isChunkLoadError,\n  attemptChunkRecovery,\n  clearChunkRecoveryFlag,\n  reloadPage,\n} from './chunkRecovery';\nexport type { ChunkRecoveryPorts } from './chunkRecovery';\n","export {\n  sanitizeHtml,\n  removeControlCharacters,\n  sanitizeNotificationMessage,\n  sanitizeText,\n  sanitizeUrl,\n} from './sanitize';\n","import { isValueDefined } from '../guards/isValueDefined';\n\n/** Parses JSON and checks its shape; anything else gives null. */\nexport function parseChecked<T>(text: string | null, isShape: (value: unknown) => value is T): T | null {\n  if (!isValueDefined(text)) {return null;}\n  try {\n    const value: unknown = JSON.parse(text);\n    return isShape(value) ? value : null;\n  } catch {\n    return null;\n  }\n}\n\n/** Whether a value is an object holding these string fields. */\nexport function hasStringFields(value: unknown, fields: readonly string[]): boolean {\n  if (typeof value !== 'object' || !isValueDefined(value)) {return false;}\n  return fields.every((field) => typeof Reflect.get(value, field) === 'string');\n}\n\n/** Whether an object's field holds an array. */\nexport function hasArrayField(value: unknown, field: string): boolean {\n  return typeof value === 'object' && isValueDefined(value) && Array.isArray(Reflect.get(value, field));\n}\n\n/** Turns data into two-space JSON text ending in a newline. */\nexport function toFileJson(value: unknown): string {\n  return `${JSON.stringify(value, null, 2)}\\n`;\n}\n"]}

package/dist/index.mjs

@@ -350,8 +350,9 @@ function clearChunkRecoveryFlag(ports = defaultPorts()) {
   }
   ports.clearAttempt();
 }
-function reloadPage(ports = defaultPorts()) {
-  ports.reload();
+function reloadPage(ports) {
+  const target = typeof ports?.reload === "function" ? ports : defaultPorts();
+  target.reload();
 }
 
 // src/guards/index.ts

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/async/fireAndForget.ts","../src/async/singleFlight.ts","../src/error/getErrorMessage.ts","../src/format/formatDate.ts","../src/csv/toCsv.ts","../src/sanitize/sanitize.ts","../src/navigation/redirect.ts","../src/chunkRecovery/chunkRecovery.ts","../src/guards/index.ts","../src/assertions/index.ts","../src/async/index.ts","../src/error/index.ts","../src/format/index.ts","../src/csv/index.ts","../src/navigation/index.ts","../src/chunkRecovery/index.ts","../src/sanitize/index.ts","../src/json/checkedJson.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;;;ACtBO,SAAS,cAAc,OAAA,EAAiC;AAC7D,EAAA,OAAA,CAAQ,KAAA,CAAM,MAAM,MAAS,CAAA;AAC/B;;;ACFO,SAAS,aAAgB,MAAA,EAAyD;AACvF,EAAA,IAAI,OAAA,GAAU,KAAA;AACd,EAAA,OAAO,CAAC,KAAA,KAAmB;AACzB,IAAA,IAAI,OAAA,EAAS;AAAC,MAAA;AAAA,IAAO;AACrB,IAAA,OAAA,GAAU,IAAA;AACV,IAAA,MAAA,CAAO,KAAK,CAAA,CACT,KAAA,CAAM,MAAM,MAAS,CAAA,CACrB,QAAQ,MAAM;AACb,MAAA,OAAA,GAAU,KAAA;AAAA,IACZ,CAAC,CAAA;AAAA,EACL,CAAA;AACF;;;ACNA,SAAS,mBAAmB,KAAA,EAA2C;AACrE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,cAAA,CAAe,KAAK,KAAK,SAAA,IAAa,KAAA;AAC5E;AASO,SAAS,eAAA,CAAgB,KAAA,EAAgB,QAAA,GAAW,eAAA,EAAyB;AAClF,EAAA,IAAI,iBAAiB,KAAA,EAAO;AAAC,IAAA,OAAO,KAAA,CAAM,OAAA;AAAA,EAAQ;AAClD,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAAC,IAAA,OAAO,KAAA;AAAA,EAAM;AAC7C,EAAA,IAAI,kBAAA,CAAmB,KAAK,CAAA,EAAG;AAC7B,IAAA,MAAM,UAAU,KAAA,CAAM,OAAA;AACtB,IAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,CAAQ,SAAS,CAAA,EAAG;AAAC,MAAA,OAAO,OAAA;AAAA,IAAQ;AAAA,EACzE;AACA,EAAA,OAAO,QAAA;AACT;;;ACjBO,SAAS,UAAA,CACd,IAAA,EACA,MAAA,EACA,OAAA,EACQ;AACR,EAAA,IAAI,IAAA,KAAS,IAAA,IAAQ,IAAA,KAAS,MAAA,EAAW;AAAC,IAAA,OAAO,EAAA;AAAA,EAAG;AAEpD,EAAA,MAAM,cAAA,GAAiB,MAAA,KAAW,EAAA,GAAK,MAAA,GAAS,IAAA;AAEhD,EAAA,IAAI;AACF,IAAA,OAAO,IAAI,IAAA,CAAK,cAAA,CAAe,gBAAgB,OAAO,CAAA,CAAE,OAAO,IAAI,CAAA;AAAA,EACrE,CAAA,CAAA,MAAQ;AAEN,IAAA,OAAO,KAAK,WAAA,EAAY,CAAE,MAAM,GAAG,CAAA,CAAE,CAAC,CAAA,IAAK,EAAA;AAAA,EAC7C;AACF;;;ACDA,IAAM,aAAA,GAAgB,WAAA;AAKtB,IAAM,KAAA,GAAQ,GAAA;AACd,IAAM,aAAA,GAAgB,IAAA;AAEtB,IAAM,WAAA,GAAc,IAAA;AAGpB,IAAM,aAAA,GAAgB,MAAA;AACtB,IAAM,eAAA,GAAkB,GAAA;AAGxB,SAAS,YAAY,GAAA,EAAiD;AACpE,EAAA,MAAM,OAAO,cAAA,CAAe,GAAG,CAAA,GAAI,MAAA,CAAO,GAAG,CAAA,GAAI,EAAA;AACjD,EAAA,IAAI,CAAC,aAAA,CAAc,IAAA,CAAK,IAAI,CAAA,EAAG;AAC7B,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,CAAA,EAAG,KAAK,CAAA,EAAG,IAAA,CAAK,QAAQ,WAAA,EAAa,aAAa,CAAC,CAAA,EAAG,KAAK,CAAA,CAAA;AACpE;AAQO,SAAS,KAAA,CAAS,MAAoB,OAAA,EAA8C;AACzF,EAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,GAAA,CAAI,CAAC,MAAA,KAAW,WAAA,CAAY,MAAA,CAAO,MAAM,CAAC,CAAA,CAAE,IAAA,CAAK,eAAe,CAAA;AAE3F,EAAA,MAAM,YAAY,IAAA,CAAK,GAAA;AAAA,IAAI,CAAC,GAAA,KAC1B,OAAA,CAAQ,GAAA,CAAI,CAAC,MAAA,KAAW,WAAA,CAAY,MAAA,CAAO,KAAA,CAAM,GAAG,CAAC,CAAC,CAAA,CAAE,KAAK,eAAe;AAAA,GAC9E;AAEA,EAAA,OAAO,CAAC,UAAA,EAAY,GAAG,SAAS,CAAA,CAAE,KAAK,aAAa,CAAA;AACtD;;;ACnDA,IAAM,aAAA,GAAwC;AAAA,EAC5C,GAAA,EAAK,OAAA;AAAA,EACL,GAAA,EAAK,MAAA;AAAA,EACL,GAAA,EAAK,MAAA;AAAA,EACL,GAAA,EAAK,QAAA;AAAA,EACL,GAAA,EAAK,QAAA;AAAA,EACL,GAAA,EAAK,QAAA;AAAA,EACL,GAAA,EAAK,QAAA;AAAA,EACL,GAAA,EAAK;AACP,CAAA;AAKA,IAAM,iBAAA,GAAoB,aAAA;AAS1B,IAAM,gBAAA,GAAmB,CAAA;AAEzB,IAAM,cAAA,GAAiB,EAAA;AAEvB,IAAM,gBAAA,GAAmB,GAAA;AAEzB,IAAM,cAAA,GAAiB,GAAA;AAEvB,IAAM,gBAAA,GAAmB,IAAA;AAEzB,IAAM,cAAA,GAAiB,IAAA;AAEvB,IAAM,kBAAA,GAAqB,IAAA;AAE3B,IAAM,gBAAA,GAAmB,IAAA;AAEzB,IAAM,eAAA,GAAkB,KAAA;AAKxB,IAAM,uBAAA,GAA0B,GAAA;AAKhC,IAAM,eAAA,GAAkB,CAAA;AAajB,SAAS,aAAa,IAAA,EAAsB;AACjD,EAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AAAC,IAAA,OAAO,EAAA;AAAA,EAAG;AAClC,EAAA,OAAO,IAAA,CAAK,QAAQ,iBAAA,EAAmB,CAAC,SAAS,aAAA,CAAc,IAAI,KAAK,IAAI,CAAA;AAC9E;AAMA,SAAS,oBAAoB,IAAA,EAAuB;AAClD,EAAA,MAAM,WAAA,GAAc,IAAA,IAAQ,gBAAA,IAAoB,IAAA,IAAQ,cAAA;AACxD,EAAA,MAAM,WAAA,GAAc,IAAA,IAAQ,gBAAA,IAAoB,IAAA,IAAQ,cAAA;AACxD,EAAA,MAAM,WAAA,GAAc,IAAA,IAAQ,gBAAA,IAAoB,IAAA,IAAQ,cAAA;AACxD,EAAA,MAAM,YAAA,GAAe,IAAA,IAAQ,kBAAA,IAAsB,IAAA,IAAQ,gBAAA;AAC3D,EAAA,MAAM,QAAQ,IAAA,KAAS,eAAA;AACvB,EAAA,OAAO,WAAA,IAAe,WAAA,IAAe,WAAA,IAAe,YAAA,IAAgB,KAAA;AACtE;AASO,SAAS,wBAAwB,IAAA,EAAsB;AAC5D,EAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AAAC,IAAA,OAAO,EAAA;AAAA,EAAG;AAClC,EAAA,IAAI,GAAA,GAAM,EAAA;AACV,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,IAAA,CAAK,QAAQ,CAAA,EAAA,EAAK;AACpC,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,UAAA,CAAW,CAAC,CAAA;AAC9B,IAAA,IAAI,CAAC,mBAAA,CAAoB,IAAI,CAAA,EAAG;AAAC,MAAA,GAAA,IAAO,KAAK,CAAC,CAAA;AAAA,IAAE;AAAA,EAClD;AACA,EAAA,OAAO,GAAA;AACT;AAqBO,SAAS,2BAAA,CACd,OAAA,EACA,SAAA,GAAoB,uBAAA,EACZ;AACR,EAAA,IAAI,OAAA,CAAQ,WAAW,CAAA,EAAG;AAAC,IAAA,OAAO,EAAA;AAAA,EAAG;AAGrC,EAAA,IAAI,SAAA,GAAY,wBAAwB,OAAO,CAAA;AAG/C,EAAA,SAAA,GAAY,UAAU,IAAA,EAAK;AAG3B,EAAA,IAAI,SAAA,CAAU,SAAS,SAAA,EACrB;AAAC,IAAA,SAAA,GAAY,GAAG,SAAA,CAAU,SAAA,CAAU,CAAA,EAAG,SAAA,GAAY,eAAe,CAAC,CAAA,GAAA,CAAA;AAAA,EAAM;AAI3E,EAAA,SAAA,GAAY,aAAa,SAAS,CAAA;AAElC,EAAA,OAAO,SAAA;AACT;AAWO,SAAS,YAAA,CAAa,MAAc,SAAA,EAA4B;AACrE,EAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AAAC,IAAA,OAAO,EAAA;AAAA,EAAG;AAElC,EAAA,IAAI,SAAA,GAAY,wBAAwB,IAAI,CAAA;AAC5C,EAAA,SAAA,GAAY,UAAU,IAAA,EAAK;AAE3B,EAAA,MAAM,iBAAA,GAAoB,OAAO,SAAA,KAAc,QAAA,IAAY,SAAA,GAAY,CAAA;AACvE,EAAA,MAAM,gBAAA,GAAmB,iBAAA,IAAqB,SAAA,CAAU,MAAA,GAAS,SAAA;AACjE,EAAA,IAAI,gBAAA,EACF;AAAC,IAAA,SAAA,GAAY,GAAG,SAAA,CAAU,SAAA,CAAU,CAAA,EAAG,SAAA,GAAY,eAAe,CAAC,CAAA,GAAA,CAAA;AAAA,EAAM;AAG3E,EAAA,OAAO,SAAA;AACT;AAQO,SAAS,YAAY,GAAA,EAAqB;AAC/C,EAAA,IAAI,GAAA,CAAI,WAAW,CAAA,EAAG;AAAC,IAAA,OAAO,EAAA;AAAA,EAAG;AAEjC,EAAA,MAAM,YAAA,GAAe,GAAA,CAAI,IAAA,EAAK,CAAE,WAAA,EAAY;AAC5C,EAAA,MAAM,QAAA,GAAW,YAAA,CAAa,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA;AAG1C,EAAA,MAAM,mBAAA,GAAsB,QAAA,KAAa,YAAA,IAAgB,QAAA,KAAa,UAAU,QAAA,KAAa,UAAA;AAC7F,EAAA,IAAI,mBAAA,EACF;AAAC,IAAA,OAAO,EAAA;AAAA,EAAG;AAGb,EAAA,OAAO,IAAI,IAAA,EAAK;AAClB;;;ACnJA,IAAM,yBAAA,GAA4B,GAAA;AAElC,IAAI,eAAA,GAAmD,IAAA;AACvD,IAAM,kBAA4B,EAAC;AAOnC,SAAS,oBAAoB,IAAA,EAAsB;AACjD,EAAA,MAAM,UAAA,GAAa,IAAA,CAAK,OAAA,CAAQ,cAAA,EAAgB,EAAE,CAAA;AAClD,EAAA,OAAO,UAAA,KAAe,KAAK,GAAA,GAAM,UAAA;AACnC;AAGA,SAAS,kBAAA,GAAoC;AAC3C,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AAAC,IAAA,OAAO,IAAA;AAAA,EAAK;AAChD,EAAA,OAAO,CAAA,EAAG,MAAA,CAAO,QAAA,CAAS,QAAQ,CAAA,EAAG,MAAA,CAAO,QAAA,CAAS,MAAM,CAAA,EAAG,MAAA,CAAO,QAAA,CAAS,IAAI,CAAA,CAAA;AACpF;AAGA,SAAS,0BAAA,CAA2B,QAAgB,UAAA,EAA0B;AAC5E,EAAA,UAAA,CAAW,MAAM;AACf,IAAA,IAAI;AACF,MAAA,MAAM,QAAQ,kBAAA,EAAmB;AACjC,MAAA,IAAI,KAAA,KAAU,MAAA,IAAU,OAAO,MAAA,KAAW,WAAA,EAAa;AAAC,QAAA,MAAA,CAAO,QAAA,CAAS,QAAQ,UAAU,CAAA;AAAA,MAAE;AAAA,IAC9F,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF,GAAG,yBAAyB,CAAA;AAC9B;AAGA,SAAS,oBAAoB,UAAA,EAA6B;AACxD,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AAAC,IAAA,OAAO,KAAA;AAAA,EAAM;AACjD,EAAA,IAAI;AACF,IAAA,MAAA,CAAO,QAAA,CAAS,QAAQ,UAAU,CAAA;AAClC,IAAA,OAAO,IAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;AAMO,SAAS,mBAAmB,CAAA,EAAiC;AAClE,EAAA,eAAA,GAAkB,CAAA;AAClB,EAAA,OAAO,eAAA,CAAgB,SAAS,CAAA,EAAG;AACjC,IAAA,MAAM,CAAA,GAAI,gBAAgB,KAAA,EAAM;AAChC,IAAA,IAAI;AACF,MAAA,IAAI,OAAO,CAAA,KAAM,QAAA,IAAY,CAAA,CAAE,SAAS,CAAA,EAAG;AAAC,QAAA,CAAA,CAAE,mBAAA,CAAoB,CAAC,CAAC,CAAA;AAAA,MAAE;AAAA,IACxE,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AACF;AAMO,SAAS,WAAW,IAAA,EAAoB;AAC7C,EAAA,MAAM,UAAA,GAAa,oBAAoB,IAAI,CAAA;AAC3C,EAAA,IAAI,eAAA,EAAiB;AACnB,IAAA,MAAM,SAAS,kBAAA,EAAmB;AAClC,IAAA,IAAI;AACF,MAAA,eAAA,CAAgB,UAAU,CAAA;AAC1B,MAAA,IAAI,OAAO,WAAW,QAAA,EAAU;AAAC,QAAA,0BAAA,CAA2B,QAAQ,UAAU,CAAA;AAAA,MAAE;AAChF,MAAA;AAAA,IACF,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AACA,EAAA,IAAI,mBAAA,CAAoB,UAAU,CAAA,EAAG;AAAC,IAAA;AAAA,EAAO;AAC7C,EAAA,eAAA,CAAgB,KAAK,UAAU,CAAA;AACjC;AAMO,SAAS,oBAAA,GAA6B;AAC3C,EAAA,eAAA,GAAkB,IAAA;AAClB,EAAA,eAAA,CAAgB,MAAA,GAAS,CAAA;AAC3B;;;AC9EA,IAAM,eAAA,GAAkB,4BAAA;AAYxB,IAAM,oBAAA,GAAuB,GAAA;AAG7B,IAAM,oBAAA,GAA0C;AAAA,EAC9C,iBAAA;AAAA,EACA,8BAAA;AAAA,EACA,oBAAA;AAAA,EACA,8CAAA;AAAA,EACA,4CAAA;AAAA,EACA,mCAAA;AAAA,EACA;AACF,CAAA;AAaO,SAAS,iBAAiB,KAAA,EAAyB;AACxD,EAAA,IAAI,EAAE,iBAAiB,KAAA,CAAA,EAAQ;AAC7B,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,IAAI,KAAA,CAAM,SAAS,gBAAA,EAAkB;AACnC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,WAAW,CAAA,EAAG,KAAA,CAAM,IAAI,CAAA,CAAA,EAAI,MAAM,OAAO,CAAA,CAAA;AAC/C,EAAA,OAAO,qBAAqB,IAAA,CAAK,CAAC,YAAY,OAAA,CAAQ,IAAA,CAAK,QAAQ,CAAC,CAAA;AACtE;AAEA,SAAS,cAAA,GAAmD;AAC1D,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,IAAI;AACF,IAAA,OAAO,MAAA,CAAO,cAAA;AAAA,EAChB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,MAAA;AAAA,EACT;AACF;AAEA,SAAS,YAAA,GAAmC;AAC1C,EAAA,MAAM,UAAU,cAAA,EAAe;AAC/B,EAAA,MAAM,SAAA,GAAY,OAAO,MAAA,KAAW,WAAA;AACpC,EAAA,OAAO;AAAA,IACL,eAAe,MAAqB;AAClC,MAAA,MAAM,GAAA,GAAM,OAAA,EAAS,OAAA,CAAQ,eAAe,CAAA;AAC5C,MAAA,IAAI,GAAA,KAAQ,IAAA,IAAQ,GAAA,KAAQ,MAAA,IAAa,QAAQ,EAAA,EAAI;AACnD,QAAA,OAAO,IAAA;AAAA,MACT;AACA,MAAA,MAAM,MAAA,GAAS,OAAO,GAAG,CAAA;AACzB,MAAA,OAAO,MAAA,CAAO,QAAA,CAAS,MAAM,CAAA,GAAI,MAAA,GAAS,IAAA;AAAA,IAC5C,CAAA;AAAA,IACA,eAAA,EAAiB,CAAC,EAAA,KAAqB;AACrC,MAAA,OAAA,EAAS,OAAA,CAAQ,eAAA,EAAiB,MAAA,CAAO,EAAE,CAAC,CAAA;AAAA,IAC9C,CAAA;AAAA,IACA,cAAc,MAAY;AACxB,MAAA,OAAA,EAAS,WAAW,eAAe,CAAA;AAAA,IACrC,CAAA;AAAA,IACA,GAAA,EAAK,MAAc,IAAA,CAAK,GAAA,EAAI;AAAA,IAC5B,QAAQ,MAAY;AAClB,MAAA,IAAI,SAAA,EAAW;AACb,QAAA,MAAA,CAAO,SAAS,MAAA,EAAO;AAAA,MACzB;AAAA,IACF;AAAA,GACF;AACF;AAGA,SAAS,gBAAA,CAAiB,aAA4B,GAAA,EAAsB;AAC1E,EAAA,OAAO,WAAA,KAAgB,IAAA,IAAQ,GAAA,GAAM,WAAA,GAAc,oBAAA;AACrD;AAUO,SAAS,oBAAA,CAAqB,KAAA,GAA4B,YAAA,EAAa,EAAY;AACxF,EAAA,MAAM,GAAA,GAAM,MAAM,GAAA,EAAI;AACtB,EAAA,IAAI,gBAAA,CAAiB,KAAA,CAAM,aAAA,EAAc,EAAG,GAAG,CAAA,EAAG;AAChD,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,KAAA,CAAM,gBAAgB,GAAG,CAAA;AACzB,EAAA,KAAA,CAAM,MAAA,EAAO;AACb,EAAA,OAAO,IAAA;AACT;AAUO,SAAS,sBAAA,CAAuB,KAAA,GAA4B,YAAA,EAAa,EAAS;AACvF,EAAA,IAAI,iBAAiB,KAAA,CAAM,aAAA,IAAiB,KAAA,CAAM,GAAA,EAAK,CAAA,EAAG;AACxD,IAAA;AAAA,EACF;AACA,EAAA,KAAA,CAAM,YAAA,EAAa;AACrB;AAGO,SAAS,UAAA,CAAW,KAAA,GAA4B,YAAA,EAAa,EAAS;AAC3E,EAAA,KAAA,CAAM,MAAA,EAAO;AACf;;;AClLA,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;;;ACAA,IAAA,aAAA,GAAA;AAAA,QAAA,CAAA,aAAA,EAAA;AAAA,EAAA,aAAA,EAAA,MAAA,aAAA;AAAA,EAAA,YAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACAA,IAAA,aAAA,GAAA;AAAA,QAAA,CAAA,aAAA,EAAA;AAAA,EAAA,eAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACAA,IAAA,cAAA,GAAA;AAAA,QAAA,CAAA,cAAA,EAAA;AAAA,EAAA,UAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACAA,IAAA,WAAA,GAAA;AAAA,QAAA,CAAA,WAAA,EAAA;AAAA,EAAA,KAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACAA,IAAA,kBAAA,GAAA;AAAA,QAAA,CAAA,kBAAA,EAAA;AAAA,EAAA,UAAA,EAAA,MAAA,UAAA;AAAA,EAAA,oBAAA,EAAA,MAAA,oBAAA;AAAA,EAAA,kBAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACAA,IAAA,qBAAA,GAAA;AAAA,QAAA,CAAA,qBAAA,EAAA;AAAA,EAAA,oBAAA,EAAA,MAAA,oBAAA;AAAA,EAAA,sBAAA,EAAA,MAAA,sBAAA;AAAA,EAAA,gBAAA,EAAA,MAAA,gBAAA;AAAA,EAAA,UAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACAA,IAAA,gBAAA,GAAA;AAAA,QAAA,CAAA,gBAAA,EAAA;AAAA,EAAA,uBAAA,EAAA,MAAA,uBAAA;AAAA,EAAA,YAAA,EAAA,MAAA,YAAA;AAAA,EAAA,2BAAA,EAAA,MAAA,2BAAA;AAAA,EAAA,YAAA,EAAA,MAAA,YAAA;AAAA,EAAA,WAAA,EAAA,MAAA;AAAA,CAAA,CAAA;;;ACGO,SAAS,YAAA,CAAgB,MAAqB,OAAA,EAAmD;AACtG,EAAA,IAAI,CAAC,cAAA,CAAe,IAAI,CAAA,EAAG;AAAC,IAAA,OAAO,IAAA;AAAA,EAAK;AACxC,EAAA,IAAI;AACF,IAAA,MAAM,KAAA,GAAiB,IAAA,CAAK,KAAA,CAAM,IAAI,CAAA;AACtC,IAAA,OAAO,OAAA,CAAQ,KAAK,CAAA,GAAI,KAAA,GAAQ,IAAA;AAAA,EAClC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAGO,SAAS,eAAA,CAAgB,OAAgB,MAAA,EAAoC;AAClF,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,CAAC,cAAA,CAAe,KAAK,CAAA,EAAG;AAAC,IAAA,OAAO,KAAA;AAAA,EAAM;AACvE,EAAA,OAAO,MAAA,CAAO,KAAA,CAAM,CAAC,KAAA,KAAU,OAAO,QAAQ,GAAA,CAAI,KAAA,EAAO,KAAK,CAAA,KAAM,QAAQ,CAAA;AAC9E;AAGO,SAAS,aAAA,CAAc,OAAgB,KAAA,EAAwB;AACpE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,cAAA,CAAe,KAAK,CAAA,IAAK,KAAA,CAAM,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,KAAA,EAAO,KAAK,CAAC,CAAA;AACtG;AAGO,SAAS,WAAW,KAAA,EAAwB;AACjD,EAAA,OAAO,GAAG,IAAA,CAAK,SAAA,CAAU,KAAA,EAAO,IAAA,EAAM,CAAC,CAAC;AAAA,CAAA;AAC1C","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","/** Starts a promise without awaiting it and swallows its rejection. */\nexport function fireAndForget(promise: Promise<unknown>): void {\n  promise.catch(() => undefined);\n}\n","/** Wraps an async action so a second call while the first runs does nothing: one Enter or tap, one request. */\nexport function singleFlight<T>(action: (input: T) => Promise<void>): (input: T) => void {\n  let running = false;\n  return (input: T): void => {\n    if (running) {return;}\n    running = true;\n    action(input)\n      .catch(() => undefined)\n      .finally(() => {\n        running = false;\n      });\n  };\n}\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 * RFC 4180 CSV serialization — the pure, DOM-free core of \"export the rows on screen to CSV\".\n *\n * The escaping is the whole risk surface: a comma, a quote or a newline inside a value (a\n * counterparty name, an address) is exactly what turns one row into two columns or two rows in a\n * spreadsheet. So the serializer lives here as a pure, total function a unit test can hammer, split\n * from any browser download shell (which is a side-effecting, app-owned concern).\n *\n * Promoted from finreg-web's `utils/exportCsv.ts` (ZY-25) — the escaping logic is universal across\n * the fleet; the DOM `<a download>` shell that consumes it stays in the app until a 2nd consumer.\n */\nimport { isValueDefined } from '../guards/isValueDefined';\n\n/** One column of a CSV export: a (caller-localized) header and how to read the cell from a row. */\nexport interface CsvColumn<T> {\n  /** The column header — already localized by the caller. */\n  header: string;\n  /** Reads the cell value from a row. `null`/`undefined` become an empty cell. */\n  value: (row: T) => string | number | null | undefined;\n}\n\n/** RFC 4180: a field must be quoted when it contains a quote, a comma, or a line break. */\nconst NEEDS_QUOTING = /[\"',\\r\\n]/;\n\n// A more permissive test than strictly required (it also quotes apostrophes), so a value like\n// O'Brien is never split by a spreadsheet that treats a leading quote specially — harmless, and it\n// keeps the rule to one regex.\nconst QUOTE = '\"';\nconst ESCAPED_QUOTE = '\"\"';\n/** Every embedded quote, so each is doubled per RFC 4180 (ES2020-safe; no `replaceAll`). */\nconst EVERY_QUOTE = /\"/g;\n\n/** RFC 4180 uses CRLF between records; Excel and Sheets both require it. */\nconst ROW_SEPARATOR = '\\r\\n';\nconst FIELD_SEPARATOR = ',';\n\n/** Quote and escape a single field per RFC 4180. `null`/`undefined` → an empty field. */\nfunction escapeField(raw: string | number | null | undefined): string {\n  const text = isValueDefined(raw) ? String(raw) : '';\n  if (!NEEDS_QUOTING.test(text)) {\n    return text;\n  }\n  return `${QUOTE}${text.replace(EVERY_QUOTE, ESCAPED_QUOTE)}${QUOTE}`;\n}\n\n/**\n * Serialize rows to an RFC 4180 CSV string — a header row followed by one row per item.\n *\n * Pure and total: an empty `rows` yields the header line alone, which opens as an empty-but-labelled\n * spreadsheet rather than a zero-byte file the operator cannot tell apart from a failure.\n */\nexport function toCsv<T>(rows: readonly T[], columns: ReadonlyArray<CsvColumn<T>>): string {\n  const headerLine = columns.map((column) => escapeField(column.header)).join(FIELD_SEPARATOR);\n\n  const dataLines = rows.map((row) =>\n    columns.map((column) => escapeField(column.value(row))).join(FIELD_SEPARATOR),\n  );\n\n  return [headerLine, ...dataLines].join(ROW_SEPARATOR);\n}\n","/**\n * Text sanitization utilities for preventing XSS and ensuring safe display.\n * These utilities sanitize user-provided text before rendering.\n */\n\n/**\n * HTML entities that should be escaped to prevent XSS attacks.\n */\nconst HTML_ENTITIES: Record<string, string> = {\n  '&': '&amp;',\n  '<': '&lt;',\n  '>': '&gt;',\n  '\"': '&quot;',\n  \"'\": '&#x27;',\n  '/': '&#x2F;',\n  '`': '&#x60;',\n  '=': '&#x3D;',\n};\n\n/**\n * Regular expression matching characters that need escaping.\n */\nconst HTML_ESCAPE_REGEX = /[&<>\"'`=/]/g;\n\n/**\n * Unicode code point ranges for dangerous characters.\n * These are control characters and zero-width characters that can be\n * used in homograph attacks or to hide malicious content.\n */\n\n/** C0 control characters range start (NULL) */\nconst C0_CONTROL_START = 0x0000;\n/** C0 control characters range end (Unit Separator) */\nconst C0_CONTROL_END = 0x001f;\n/** C1 control characters range start (DEL and beyond) */\nconst C1_CONTROL_START = 0x007f;\n/** C1 control characters range end */\nconst C1_CONTROL_END = 0x009f;\n/** Zero-width characters range start (Zero Width Space) */\nconst ZERO_WIDTH_START = 0x200b;\n/** Zero-width characters range end (Right-to-Left Mark) */\nconst ZERO_WIDTH_END = 0x200f;\n/** Format characters range start (Line Separator) */\nconst FORMAT_CHARS_START = 0x2028;\n/** Format characters range end (Narrow No-Break Space) */\nconst FORMAT_CHARS_END = 0x202f;\n/** Byte Order Mark code point */\nconst BYTE_ORDER_MARK = 0xfeff;\n\n/**\n * Maximum reasonable length for notification messages.\n */\nconst MAX_NOTIFICATION_LENGTH = 500;\n\n/**\n * Length of ellipsis suffix (\"...\") used when truncating text.\n */\nconst ELLIPSIS_LENGTH = 3;\n\n/**\n * Escapes HTML special characters in a string to prevent XSS attacks.\n * Use this when displaying user-provided content in the UI.\n *\n * @param text - The text to sanitize\n * @returns The sanitized text with HTML entities escaped\n *\n * @example\n * sanitizeHtml('<script>alert(\"xss\")</script>')\n * // Returns: '&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;'\n */\nexport function sanitizeHtml(text: string): string {\n  if (text.length === 0) {return '';}\n  return text.replace(HTML_ESCAPE_REGEX, (char) => HTML_ENTITIES[char] ?? char);\n}\n\n/**\n * Control characters and zero-width characters that should be removed.\n * These can be used in homograph attacks or to hide malicious content.\n */\nfunction isDangerousCharCode(code: number): boolean {\n  const isC0Control = code >= C0_CONTROL_START && code <= C0_CONTROL_END;\n  const isC1Control = code >= C1_CONTROL_START && code <= C1_CONTROL_END;\n  const isZeroWidth = code >= ZERO_WIDTH_START && code <= ZERO_WIDTH_END;\n  const isFormatChar = code >= FORMAT_CHARS_START && code <= FORMAT_CHARS_END;\n  const isBom = code === BYTE_ORDER_MARK;\n  return isC0Control || isC1Control || isZeroWidth || isFormatChar || isBom;\n}\n\n/**\n * Removes control characters and zero-width characters from text.\n * These characters can be used to create misleading text or hide content.\n *\n * @param text - The text to sanitize\n * @returns The text with dangerous characters removed\n */\nexport function removeControlCharacters(text: string): string {\n  if (text.length === 0) {return '';}\n  let out = '';\n  for (let i = 0; i < text.length; i++) {\n    const code = text.charCodeAt(i);\n    if (!isDangerousCharCode(code)) {out += text[i];}\n  }\n  return out;\n}\n\n/**\n * Sanitizes a notification message for safe display.\n * This function:\n * 1. Removes control/zero-width characters\n * 2. Trims whitespace\n * 3. Truncates to a reasonable length\n * 4. Escapes HTML entities (for web platform)\n *\n * Note: React Native's Text component already escapes HTML by default,\n * but this provides defense-in-depth and handles the web platform.\n *\n * @param message - The notification message to sanitize\n * @param maxLength - Maximum length (default: 500)\n * @returns The sanitized message\n *\n * @example\n * sanitizeNotificationMessage('  Hello <b>World</b>  ')\n * // Returns: 'Hello &lt;b&gt;World&lt;/b&gt;'\n */\nexport function sanitizeNotificationMessage(\n  message: string,\n  maxLength: number = MAX_NOTIFICATION_LENGTH\n): string {\n  if (message.length === 0) {return '';}\n\n  // Remove dangerous characters first\n  let sanitized = removeControlCharacters(message);\n\n  // Trim whitespace\n  sanitized = sanitized.trim();\n\n  // Truncate if too long\n  if (sanitized.length > maxLength) \n    {sanitized = `${sanitized.substring(0, maxLength - ELLIPSIS_LENGTH)}...`;}\n  \n\n  // Escape HTML entities\n  sanitized = sanitizeHtml(sanitized);\n\n  return sanitized;\n}\n\n/**\n * Sanitizes text for safe display, without HTML escaping.\n * Use this for React Native components where HTML escaping isn't needed\n * but control character removal and length limits are still important.\n *\n * @param text - The text to sanitize\n * @param maxLength - Maximum length (optional)\n * @returns The sanitized text\n */\nexport function sanitizeText(text: string, maxLength?: number): string {\n  if (text.length === 0) {return '';}\n\n  let sanitized = removeControlCharacters(text);\n  sanitized = sanitized.trim();\n\n  const hasValidMaxLength = typeof maxLength === 'number' && maxLength > 0;\n  const exceedsMaxLength = hasValidMaxLength && sanitized.length > maxLength;\n  if (exceedsMaxLength) \n    {sanitized = `${sanitized.substring(0, maxLength - ELLIPSIS_LENGTH)}...`;}\n  \n\n  return sanitized;\n}\n\n/**\n * Validates and sanitizes a URL to prevent javascript: and data: protocol attacks.\n *\n * @param url - The URL to validate\n * @returns The sanitized URL or empty string if invalid\n */\nexport function sanitizeUrl(url: string): string {\n  if (url.length === 0) {return '';}\n\n  const trimmedLower = url.trim().toLowerCase();\n  const protocol = trimmedLower.split(':')[0];\n\n  // Block dangerous protocols\n  const isDangerousProtocol = protocol === 'javascript' || protocol === 'data' || protocol === 'vbscript';\n  if (isDangerousProtocol) \n    {return '';}\n  \n\n  return url.trim();\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","/**\n * Detection + one-shot auto-recovery for stale-chunk load failures.\n *\n * WHY (UX Move 3, would have masked P0-01): after a deploy, the browser may hold\n * a stale `index.html` that references hashed JS chunks which now 404 — surfacing\n * as a `ChunkLoadError` / \"failed to fetch dynamically imported module\". A single\n * guarded `location.reload()` re-fetches the fresh entry + chunks and the app\n * recovers with no user-visible error. The sessionStorage one-shot flag prevents\n * a reload LOOP if the reload does not fix it (then the boundary shows a manual\n * Reload action instead).\n *\n * Pure + port-injectable: detection is a pure predicate; the storage + reload\n * side effects are ports (default to `window`) so unit tests run deterministically\n * in jsdom without a real navigation.\n *\n * Promoted from the byte-identical `src/utils/chunkLoadRecovery.ts` triplets in\n * kefi-web, erevna-web and katalogos-web (extract-on-2nd-use; this was the 3rd).\n * The original file's own header predicted this move. Pairs with\n * `<AppErrorBoundary>` from `@dloizides/ui-feedback`, which consumes these as its\n * `retryable` / `onMount` / `recover` injections.\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` (see `navigation/redirect.ts`, which\n * makes the same call). Declaring the few properties used here keeps every other\n * util in the package from reaching for browser globals absent on the server.\n */\ninterface ChunkRecoveryStorage {\n  getItem: (key: string) => string | null;\n  setItem: (key: string, value: string) => void;\n  removeItem: (key: string) => void;\n}\n\ninterface BrowserWindow {\n  sessionStorage: ChunkRecoveryStorage;\n  location: { reload: () => void };\n}\n\ndeclare const window: BrowserWindow | undefined;\n\n/**\n * sessionStorage key holding the epoch-ms timestamp of the last auto-reload attempt.\n *\n * A TIMESTAMP, not the old boolean `ui.chunkReload.attempted`. The boolean was released\n * by the consumer on a clean mount, and a lazy route makes the mount clean: the root\n * boundary commits (a Suspense fallback renders), `componentDidMount` releases the guard,\n * and only THEN does the dynamic import reject with a 404 chunk. Recovery re-armed itself\n * on every pass, so the reload loop the guard exists to bound ran unbounded.\n */\nconst CHUNK_RELOAD_AT = 'ui.chunkReload.attemptedAt';\n\n/**\n * How long one recorded attempt keeps blocking a second automatic reload.\n *\n * WHY A WINDOW RATHER THAN A COUNTER: attempt-counting bounds the loop too, but a counter\n * has to be reset by somebody, and the only place a consumer can put that reset is a clean\n * mount — the exact release that caused this defect. A window expires by itself, so there is\n * no release call to fire at the wrong moment. One minute is far longer than a reload-plus-boot\n * cycle (single-digit seconds, which is what the loop runs at) and far shorter than the gap to\n * a genuinely later, unrelated rollout, which is still allowed to auto-recover once.\n */\nconst RECOVERY_COOLDOWN_MS = 60_000;\n\n/** Messages/names emitted by webpack/metro/vite/Safari for a stale-chunk failure. */\nconst CHUNK_ERROR_PATTERNS: readonly RegExp[] = [\n  /ChunkLoadError/i,\n  /Loading chunk [\\w-]+ failed/i,\n  /Loading CSS chunk/i,\n  /Failed to fetch dynamically imported module/i,\n  /error loading dynamically imported module/i,\n  /Importing a module script failed/i,\n  /is not a valid JavaScript MIME type/i,\n];\n\n/** Injectable side-effect ports; default to the real `window`. */\nexport interface ChunkRecoveryPorts {\n  /** Epoch-ms of the last recorded attempt, or `null` when none is stored. */\n  readAttemptAt: () => number | null;\n  recordAttemptAt: (at: number) => void;\n  clearAttempt: () => void;\n  reload: () => void;\n  now: () => number;\n}\n\n/** True when `error` looks like a stale-chunk / failed-dynamic-import failure. */\nexport function isChunkLoadError(error: unknown): boolean {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n  if (error.name === 'ChunkLoadError') {\n    return true;\n  }\n  const haystack = `${error.name} ${error.message}`;\n  return CHUNK_ERROR_PATTERNS.some((pattern) => pattern.test(haystack));\n}\n\nfunction resolveStorage(): ChunkRecoveryStorage | undefined {\n  if (typeof window === 'undefined') {\n    return undefined;\n  }\n  try {\n    return window.sessionStorage;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction defaultPorts(): ChunkRecoveryPorts {\n  const storage = resolveStorage();\n  const hasWindow = typeof window !== 'undefined';\n  return {\n    readAttemptAt: (): number | null => {\n      const raw = storage?.getItem(CHUNK_RELOAD_AT);\n      if (raw === null || raw === undefined || raw === '') {\n        return null;\n      }\n      const parsed = Number(raw);\n      return Number.isFinite(parsed) ? parsed : null;\n    },\n    recordAttemptAt: (at: number): void => {\n      storage?.setItem(CHUNK_RELOAD_AT, String(at));\n    },\n    clearAttempt: (): void => {\n      storage?.removeItem(CHUNK_RELOAD_AT);\n    },\n    now: (): number => Date.now(),\n    reload: (): void => {\n      if (hasWindow) {\n        window.location.reload();\n      }\n    },\n  };\n}\n\n/** True when a recorded attempt is still inside the cooldown window. */\nfunction isWithinCooldown(attemptedAt: number | null, now: number): boolean {\n  return attemptedAt !== null && now - attemptedAt < RECOVERY_COOLDOWN_MS;\n}\n\n/**\n * Attempt a guarded reload to recover from a stale-chunk error.\n * Returns `true` when a reload was triggered, `false` while the cooldown from the previous\n * attempt is still running (the caller then shows a manual Reload action, never a loop).\n *\n * `recordAttemptAt` and `reload` stay synchronous and adjacent so the record survives the\n * navigation that follows.\n */\nexport function attemptChunkRecovery(ports: ChunkRecoveryPorts = defaultPorts()): boolean {\n  const now = ports.now();\n  if (isWithinCooldown(ports.readAttemptAt(), now)) {\n    return false;\n  }\n  ports.recordAttemptAt(now);\n  ports.reload();\n  return true;\n}\n\n/**\n * Release the guard after a clean load — but ONLY once the cooldown has expired.\n *\n * Consumers call this from the root boundary's clean-mount hook, and on a lazy route that\n * mount happens BEFORE the chunk rejects. Refusing to clear a live record is what makes the\n * bound hold no matter when the consumer calls this: an expired record permits recovery\n * anyway, so clearing it only tidies storage, while a live one is left alone.\n */\nexport function clearChunkRecoveryFlag(ports: ChunkRecoveryPorts = defaultPorts()): void {\n  if (isWithinCooldown(ports.readAttemptAt(), ports.now())) {\n    return;\n  }\n  ports.clearAttempt();\n}\n\n/** Manually reload the page (the Reload action). */\nexport function reloadPage(ports: ChunkRecoveryPorts = defaultPorts()): void {\n  ports.reload();\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 { fireAndForget } from './fireAndForget';\nexport { singleFlight } from './singleFlight';\n","export { getErrorMessage } from './getErrorMessage';\n","export { formatDate } from './formatDate';\n","export { toCsv } from './toCsv';\nexport type { CsvColumn } from './toCsv';\n","export { setRedirectHandler, redirectTo, resetRedirectHandler } from './redirect';\n","export {\n  isChunkLoadError,\n  attemptChunkRecovery,\n  clearChunkRecoveryFlag,\n  reloadPage,\n} from './chunkRecovery';\nexport type { ChunkRecoveryPorts } from './chunkRecovery';\n","export {\n  sanitizeHtml,\n  removeControlCharacters,\n  sanitizeNotificationMessage,\n  sanitizeText,\n  sanitizeUrl,\n} from './sanitize';\n","import { isValueDefined } from '../guards/isValueDefined';\n\n/** Parses JSON and checks its shape; anything else gives null. */\nexport function parseChecked<T>(text: string | null, isShape: (value: unknown) => value is T): T | null {\n  if (!isValueDefined(text)) {return null;}\n  try {\n    const value: unknown = JSON.parse(text);\n    return isShape(value) ? value : null;\n  } catch {\n    return null;\n  }\n}\n\n/** Whether a value is an object holding these string fields. */\nexport function hasStringFields(value: unknown, fields: readonly string[]): boolean {\n  if (typeof value !== 'object' || !isValueDefined(value)) {return false;}\n  return fields.every((field) => typeof Reflect.get(value, field) === 'string');\n}\n\n/** Whether an object's field holds an array. */\nexport function hasArrayField(value: unknown, field: string): boolean {\n  return typeof value === 'object' && isValueDefined(value) && Array.isArray(Reflect.get(value, field));\n}\n\n/** Turns data into two-space JSON text ending in a newline. */\nexport function toFileJson(value: unknown): string {\n  return `${JSON.stringify(value, null, 2)}\\n`;\n}\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/async/fireAndForget.ts","../src/async/singleFlight.ts","../src/error/getErrorMessage.ts","../src/format/formatDate.ts","../src/csv/toCsv.ts","../src/sanitize/sanitize.ts","../src/navigation/redirect.ts","../src/chunkRecovery/chunkRecovery.ts","../src/guards/index.ts","../src/assertions/index.ts","../src/async/index.ts","../src/error/index.ts","../src/format/index.ts","../src/csv/index.ts","../src/navigation/index.ts","../src/chunkRecovery/index.ts","../src/sanitize/index.ts","../src/json/checkedJson.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","/** Starts a promise without awaiting it and swallows its rejection. */\nexport function fireAndForget(promise: Promise<unknown>): void {\n  promise.catch(() => undefined);\n}\n","/** Wraps an async action so a second call while the first runs does nothing: one Enter or tap, one request. */\nexport function singleFlight<T>(action: (input: T) => Promise<void>): (input: T) => void {\n  let running = false;\n  return (input: T): void => {\n    if (running) {return;}\n    running = true;\n    action(input)\n      .catch(() => undefined)\n      .finally(() => {\n        running = false;\n      });\n  };\n}\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 * RFC 4180 CSV serialization — the pure, DOM-free core of \"export the rows on screen to CSV\".\n *\n * The escaping is the whole risk surface: a comma, a quote or a newline inside a value (a\n * counterparty name, an address) is exactly what turns one row into two columns or two rows in a\n * spreadsheet. So the serializer lives here as a pure, total function a unit test can hammer, split\n * from any browser download shell (which is a side-effecting, app-owned concern).\n *\n * Promoted from finreg-web's `utils/exportCsv.ts` (ZY-25) — the escaping logic is universal across\n * the fleet; the DOM `<a download>` shell that consumes it stays in the app until a 2nd consumer.\n */\nimport { isValueDefined } from '../guards/isValueDefined';\n\n/** One column of a CSV export: a (caller-localized) header and how to read the cell from a row. */\nexport interface CsvColumn<T> {\n  /** The column header — already localized by the caller. */\n  header: string;\n  /** Reads the cell value from a row. `null`/`undefined` become an empty cell. */\n  value: (row: T) => string | number | null | undefined;\n}\n\n/** RFC 4180: a field must be quoted when it contains a quote, a comma, or a line break. */\nconst NEEDS_QUOTING = /[\"',\\r\\n]/;\n\n// A more permissive test than strictly required (it also quotes apostrophes), so a value like\n// O'Brien is never split by a spreadsheet that treats a leading quote specially — harmless, and it\n// keeps the rule to one regex.\nconst QUOTE = '\"';\nconst ESCAPED_QUOTE = '\"\"';\n/** Every embedded quote, so each is doubled per RFC 4180 (ES2020-safe; no `replaceAll`). */\nconst EVERY_QUOTE = /\"/g;\n\n/** RFC 4180 uses CRLF between records; Excel and Sheets both require it. */\nconst ROW_SEPARATOR = '\\r\\n';\nconst FIELD_SEPARATOR = ',';\n\n/** Quote and escape a single field per RFC 4180. `null`/`undefined` → an empty field. */\nfunction escapeField(raw: string | number | null | undefined): string {\n  const text = isValueDefined(raw) ? String(raw) : '';\n  if (!NEEDS_QUOTING.test(text)) {\n    return text;\n  }\n  return `${QUOTE}${text.replace(EVERY_QUOTE, ESCAPED_QUOTE)}${QUOTE}`;\n}\n\n/**\n * Serialize rows to an RFC 4180 CSV string — a header row followed by one row per item.\n *\n * Pure and total: an empty `rows` yields the header line alone, which opens as an empty-but-labelled\n * spreadsheet rather than a zero-byte file the operator cannot tell apart from a failure.\n */\nexport function toCsv<T>(rows: readonly T[], columns: ReadonlyArray<CsvColumn<T>>): string {\n  const headerLine = columns.map((column) => escapeField(column.header)).join(FIELD_SEPARATOR);\n\n  const dataLines = rows.map((row) =>\n    columns.map((column) => escapeField(column.value(row))).join(FIELD_SEPARATOR),\n  );\n\n  return [headerLine, ...dataLines].join(ROW_SEPARATOR);\n}\n","/**\n * Text sanitization utilities for preventing XSS and ensuring safe display.\n * These utilities sanitize user-provided text before rendering.\n */\n\n/**\n * HTML entities that should be escaped to prevent XSS attacks.\n */\nconst HTML_ENTITIES: Record<string, string> = {\n  '&': '&amp;',\n  '<': '&lt;',\n  '>': '&gt;',\n  '\"': '&quot;',\n  \"'\": '&#x27;',\n  '/': '&#x2F;',\n  '`': '&#x60;',\n  '=': '&#x3D;',\n};\n\n/**\n * Regular expression matching characters that need escaping.\n */\nconst HTML_ESCAPE_REGEX = /[&<>\"'`=/]/g;\n\n/**\n * Unicode code point ranges for dangerous characters.\n * These are control characters and zero-width characters that can be\n * used in homograph attacks or to hide malicious content.\n */\n\n/** C0 control characters range start (NULL) */\nconst C0_CONTROL_START = 0x0000;\n/** C0 control characters range end (Unit Separator) */\nconst C0_CONTROL_END = 0x001f;\n/** C1 control characters range start (DEL and beyond) */\nconst C1_CONTROL_START = 0x007f;\n/** C1 control characters range end */\nconst C1_CONTROL_END = 0x009f;\n/** Zero-width characters range start (Zero Width Space) */\nconst ZERO_WIDTH_START = 0x200b;\n/** Zero-width characters range end (Right-to-Left Mark) */\nconst ZERO_WIDTH_END = 0x200f;\n/** Format characters range start (Line Separator) */\nconst FORMAT_CHARS_START = 0x2028;\n/** Format characters range end (Narrow No-Break Space) */\nconst FORMAT_CHARS_END = 0x202f;\n/** Byte Order Mark code point */\nconst BYTE_ORDER_MARK = 0xfeff;\n\n/**\n * Maximum reasonable length for notification messages.\n */\nconst MAX_NOTIFICATION_LENGTH = 500;\n\n/**\n * Length of ellipsis suffix (\"...\") used when truncating text.\n */\nconst ELLIPSIS_LENGTH = 3;\n\n/**\n * Escapes HTML special characters in a string to prevent XSS attacks.\n * Use this when displaying user-provided content in the UI.\n *\n * @param text - The text to sanitize\n * @returns The sanitized text with HTML entities escaped\n *\n * @example\n * sanitizeHtml('<script>alert(\"xss\")</script>')\n * // Returns: '&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;'\n */\nexport function sanitizeHtml(text: string): string {\n  if (text.length === 0) {return '';}\n  return text.replace(HTML_ESCAPE_REGEX, (char) => HTML_ENTITIES[char] ?? char);\n}\n\n/**\n * Control characters and zero-width characters that should be removed.\n * These can be used in homograph attacks or to hide malicious content.\n */\nfunction isDangerousCharCode(code: number): boolean {\n  const isC0Control = code >= C0_CONTROL_START && code <= C0_CONTROL_END;\n  const isC1Control = code >= C1_CONTROL_START && code <= C1_CONTROL_END;\n  const isZeroWidth = code >= ZERO_WIDTH_START && code <= ZERO_WIDTH_END;\n  const isFormatChar = code >= FORMAT_CHARS_START && code <= FORMAT_CHARS_END;\n  const isBom = code === BYTE_ORDER_MARK;\n  return isC0Control || isC1Control || isZeroWidth || isFormatChar || isBom;\n}\n\n/**\n * Removes control characters and zero-width characters from text.\n * These characters can be used to create misleading text or hide content.\n *\n * @param text - The text to sanitize\n * @returns The text with dangerous characters removed\n */\nexport function removeControlCharacters(text: string): string {\n  if (text.length === 0) {return '';}\n  let out = '';\n  for (let i = 0; i < text.length; i++) {\n    const code = text.charCodeAt(i);\n    if (!isDangerousCharCode(code)) {out += text[i];}\n  }\n  return out;\n}\n\n/**\n * Sanitizes a notification message for safe display.\n * This function:\n * 1. Removes control/zero-width characters\n * 2. Trims whitespace\n * 3. Truncates to a reasonable length\n * 4. Escapes HTML entities (for web platform)\n *\n * Note: React Native's Text component already escapes HTML by default,\n * but this provides defense-in-depth and handles the web platform.\n *\n * @param message - The notification message to sanitize\n * @param maxLength - Maximum length (default: 500)\n * @returns The sanitized message\n *\n * @example\n * sanitizeNotificationMessage('  Hello <b>World</b>  ')\n * // Returns: 'Hello &lt;b&gt;World&lt;/b&gt;'\n */\nexport function sanitizeNotificationMessage(\n  message: string,\n  maxLength: number = MAX_NOTIFICATION_LENGTH\n): string {\n  if (message.length === 0) {return '';}\n\n  // Remove dangerous characters first\n  let sanitized = removeControlCharacters(message);\n\n  // Trim whitespace\n  sanitized = sanitized.trim();\n\n  // Truncate if too long\n  if (sanitized.length > maxLength) \n    {sanitized = `${sanitized.substring(0, maxLength - ELLIPSIS_LENGTH)}...`;}\n  \n\n  // Escape HTML entities\n  sanitized = sanitizeHtml(sanitized);\n\n  return sanitized;\n}\n\n/**\n * Sanitizes text for safe display, without HTML escaping.\n * Use this for React Native components where HTML escaping isn't needed\n * but control character removal and length limits are still important.\n *\n * @param text - The text to sanitize\n * @param maxLength - Maximum length (optional)\n * @returns The sanitized text\n */\nexport function sanitizeText(text: string, maxLength?: number): string {\n  if (text.length === 0) {return '';}\n\n  let sanitized = removeControlCharacters(text);\n  sanitized = sanitized.trim();\n\n  const hasValidMaxLength = typeof maxLength === 'number' && maxLength > 0;\n  const exceedsMaxLength = hasValidMaxLength && sanitized.length > maxLength;\n  if (exceedsMaxLength) \n    {sanitized = `${sanitized.substring(0, maxLength - ELLIPSIS_LENGTH)}...`;}\n  \n\n  return sanitized;\n}\n\n/**\n * Validates and sanitizes a URL to prevent javascript: and data: protocol attacks.\n *\n * @param url - The URL to validate\n * @returns The sanitized URL or empty string if invalid\n */\nexport function sanitizeUrl(url: string): string {\n  if (url.length === 0) {return '';}\n\n  const trimmedLower = url.trim().toLowerCase();\n  const protocol = trimmedLower.split(':')[0];\n\n  // Block dangerous protocols\n  const isDangerousProtocol = protocol === 'javascript' || protocol === 'data' || protocol === 'vbscript';\n  if (isDangerousProtocol) \n    {return '';}\n  \n\n  return url.trim();\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","/**\n * Detection + one-shot auto-recovery for stale-chunk load failures.\n *\n * WHY (UX Move 3, would have masked P0-01): after a deploy, the browser may hold\n * a stale `index.html` that references hashed JS chunks which now 404 — surfacing\n * as a `ChunkLoadError` / \"failed to fetch dynamically imported module\". A single\n * guarded `location.reload()` re-fetches the fresh entry + chunks and the app\n * recovers with no user-visible error. The sessionStorage one-shot flag prevents\n * a reload LOOP if the reload does not fix it (then the boundary shows a manual\n * Reload action instead).\n *\n * Pure + port-injectable: detection is a pure predicate; the storage + reload\n * side effects are ports (default to `window`) so unit tests run deterministically\n * in jsdom without a real navigation.\n *\n * Promoted from the byte-identical `src/utils/chunkLoadRecovery.ts` triplets in\n * kefi-web, erevna-web and katalogos-web (extract-on-2nd-use; this was the 3rd).\n * The original file's own header predicted this move. Pairs with\n * `<AppErrorBoundary>` from `@dloizides/ui-feedback`, which consumes these as its\n * `retryable` / `onMount` / `recover` injections.\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` (see `navigation/redirect.ts`, which\n * makes the same call). Declaring the few properties used here keeps every other\n * util in the package from reaching for browser globals absent on the server.\n */\ninterface ChunkRecoveryStorage {\n  getItem: (key: string) => string | null;\n  setItem: (key: string, value: string) => void;\n  removeItem: (key: string) => void;\n}\n\ninterface BrowserWindow {\n  sessionStorage: ChunkRecoveryStorage;\n  location: { reload: () => void };\n}\n\ndeclare const window: BrowserWindow | undefined;\n\n/**\n * sessionStorage key holding the epoch-ms timestamp of the last auto-reload attempt.\n *\n * A TIMESTAMP, not the old boolean `ui.chunkReload.attempted`. The boolean was released\n * by the consumer on a clean mount, and a lazy route makes the mount clean: the root\n * boundary commits (a Suspense fallback renders), `componentDidMount` releases the guard,\n * and only THEN does the dynamic import reject with a 404 chunk. Recovery re-armed itself\n * on every pass, so the reload loop the guard exists to bound ran unbounded.\n */\nconst CHUNK_RELOAD_AT = 'ui.chunkReload.attemptedAt';\n\n/**\n * How long one recorded attempt keeps blocking a second automatic reload.\n *\n * WHY A WINDOW RATHER THAN A COUNTER: attempt-counting bounds the loop too, but a counter\n * has to be reset by somebody, and the only place a consumer can put that reset is a clean\n * mount — the exact release that caused this defect. A window expires by itself, so there is\n * no release call to fire at the wrong moment. One minute is far longer than a reload-plus-boot\n * cycle (single-digit seconds, which is what the loop runs at) and far shorter than the gap to\n * a genuinely later, unrelated rollout, which is still allowed to auto-recover once.\n */\nconst RECOVERY_COOLDOWN_MS = 60_000;\n\n/** Messages/names emitted by webpack/metro/vite/Safari for a stale-chunk failure. */\nconst CHUNK_ERROR_PATTERNS: readonly RegExp[] = [\n  /ChunkLoadError/i,\n  /Loading chunk [\\w-]+ failed/i,\n  /Loading CSS chunk/i,\n  /Failed to fetch dynamically imported module/i,\n  /error loading dynamically imported module/i,\n  /Importing a module script failed/i,\n  /is not a valid JavaScript MIME type/i,\n];\n\n/** Injectable side-effect ports; default to the real `window`. */\nexport interface ChunkRecoveryPorts {\n  /** Epoch-ms of the last recorded attempt, or `null` when none is stored. */\n  readAttemptAt: () => number | null;\n  recordAttemptAt: (at: number) => void;\n  clearAttempt: () => void;\n  reload: () => void;\n  now: () => number;\n}\n\n/** True when `error` looks like a stale-chunk / failed-dynamic-import failure. */\nexport function isChunkLoadError(error: unknown): boolean {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n  if (error.name === 'ChunkLoadError') {\n    return true;\n  }\n  const haystack = `${error.name} ${error.message}`;\n  return CHUNK_ERROR_PATTERNS.some((pattern) => pattern.test(haystack));\n}\n\nfunction resolveStorage(): ChunkRecoveryStorage | undefined {\n  if (typeof window === 'undefined') {\n    return undefined;\n  }\n  try {\n    return window.sessionStorage;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction defaultPorts(): ChunkRecoveryPorts {\n  const storage = resolveStorage();\n  const hasWindow = typeof window !== 'undefined';\n  return {\n    readAttemptAt: (): number | null => {\n      const raw = storage?.getItem(CHUNK_RELOAD_AT);\n      if (raw === null || raw === undefined || raw === '') {\n        return null;\n      }\n      const parsed = Number(raw);\n      return Number.isFinite(parsed) ? parsed : null;\n    },\n    recordAttemptAt: (at: number): void => {\n      storage?.setItem(CHUNK_RELOAD_AT, String(at));\n    },\n    clearAttempt: (): void => {\n      storage?.removeItem(CHUNK_RELOAD_AT);\n    },\n    now: (): number => Date.now(),\n    reload: (): void => {\n      if (hasWindow) {\n        window.location.reload();\n      }\n    },\n  };\n}\n\n/** True when a recorded attempt is still inside the cooldown window. */\nfunction isWithinCooldown(attemptedAt: number | null, now: number): boolean {\n  return attemptedAt !== null && now - attemptedAt < RECOVERY_COOLDOWN_MS;\n}\n\n/**\n * Attempt a guarded reload to recover from a stale-chunk error.\n * Returns `true` when a reload was triggered, `false` while the cooldown from the previous\n * attempt is still running (the caller then shows a manual Reload action, never a loop).\n *\n * `recordAttemptAt` and `reload` stay synchronous and adjacent so the record survives the\n * navigation that follows.\n */\nexport function attemptChunkRecovery(ports: ChunkRecoveryPorts = defaultPorts()): boolean {\n  const now = ports.now();\n  if (isWithinCooldown(ports.readAttemptAt(), now)) {\n    return false;\n  }\n  ports.recordAttemptAt(now);\n  ports.reload();\n  return true;\n}\n\n/**\n * Release the guard after a clean load — but ONLY once the cooldown has expired.\n *\n * Consumers call this from the root boundary's clean-mount hook, and on a lazy route that\n * mount happens BEFORE the chunk rejects. Refusing to clear a live record is what makes the\n * bound hold no matter when the consumer calls this: an expired record permits recovery\n * anyway, so clearing it only tidies storage, while a live one is left alone.\n */\nexport function clearChunkRecoveryFlag(ports: ChunkRecoveryPorts = defaultPorts()): void {\n  if (isWithinCooldown(ports.readAttemptAt(), ports.now())) {\n    return;\n  }\n  ports.clearAttempt();\n}\n\n/** Manually reload the page (the Reload action); an argument without `reload`, such as a click event, is ignored. */\nexport function reloadPage(ports?: ChunkRecoveryPorts): void {\n  const target = typeof ports?.reload === 'function' ? ports : defaultPorts();\n  target.reload();\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 { fireAndForget } from './fireAndForget';\nexport { singleFlight } from './singleFlight';\n","export { getErrorMessage } from './getErrorMessage';\n","export { formatDate } from './formatDate';\n","export { toCsv } from './toCsv';\nexport type { CsvColumn } from './toCsv';\n","export { setRedirectHandler, redirectTo, resetRedirectHandler } from './redirect';\n","export {\n  isChunkLoadError,\n  attemptChunkRecovery,\n  clearChunkRecoveryFlag,\n  reloadPage,\n} from './chunkRecovery';\nexport type { ChunkRecoveryPorts } from './chunkRecovery';\n","export {\n  sanitizeHtml,\n  removeControlCharacters,\n  sanitizeNotificationMessage,\n  sanitizeText,\n  sanitizeUrl,\n} from './sanitize';\n","import { isValueDefined } from '../guards/isValueDefined';\n\n/** Parses JSON and checks its shape; anything else gives null. */\nexport function parseChecked<T>(text: string | null, isShape: (value: unknown) => value is T): T | null {\n  if (!isValueDefined(text)) {return null;}\n  try {\n    const value: unknown = JSON.parse(text);\n    return isShape(value) ? value : null;\n  } catch {\n    return null;\n  }\n}\n\n/** Whether a value is an object holding these string fields. */\nexport function hasStringFields(value: unknown, fields: readonly string[]): boolean {\n  if (typeof value !== 'object' || !isValueDefined(value)) {return false;}\n  return fields.every((field) => typeof Reflect.get(value, field) === 'string');\n}\n\n/** Whether an object's field holds an array. */\nexport function hasArrayField(value: unknown, field: string): boolean {\n  return typeof value === 'object' && isValueDefined(value) && Array.isArray(Reflect.get(value, field));\n}\n\n/** Turns data into two-space JSON text ending in a newline. */\nexport function toFileJson(value: unknown): string {\n  return `${JSON.stringify(value, null, 2)}\\n`;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dloizides/utils",
-  "version": "1.11.0",
+  "version": "1.11.1",
   "description": "Type-safe utility functions for TypeScript projects",
   "keywords": [
     "typescript",