@portnet/ui 6.0.0 → 6.0.1

package/dist/v2/types/datagrid.d.ts

@@ -14,31 +14,31 @@ export interface DataGridColumn<T> {
     key: string;
     /** Header content. */
     header: ReactNode;
-    align?: Alignment;
+    align?: Alignment | undefined;
     /** Right-align + tabular numerals. */
-    numeric?: boolean;
+    numeric?: boolean | undefined;
     /** Monospaced cell font + tabular numerals. */
-    mono?: boolean;
+    mono?: boolean | undefined;
     /** Default true when `onSortChange` is set; `false` opts the column out of sorting. */
-    sortable?: boolean;
+    sortable?: boolean | undefined;
     /** Default true when the grid is `resizable`; `false` opts the column out. */
-    resizable?: boolean;
+    resizable?: boolean | undefined;
     /** Default true when the grid is `reorderable`; `false` opts the column out. */
-    reorderable?: boolean;
+    reorderable?: boolean | undefined;
     /** Reveal the cell only on row hover / focus-within / coarse pointer. */
-    hoverOnly?: boolean;
+    hoverOnly?: boolean | undefined;
     /** Column may be toggled by a column-visibility UI. */
-    toggleable?: boolean;
+    toggleable?: boolean | undefined;
     /** Preferred width (px number or CSS length). */
-    width?: number | string;
+    width?: number | string | undefined;
     /** Hard max width (px number or CSS length). */
-    maxWidth?: number | string;
+    maxWidth?: number | string | undefined;
     /** Wrap long content instead of truncating with an ellipsis. */
-    wrap?: boolean;
+    wrap?: boolean | undefined;
     /** Custom cell renderer; overrides `getValue` / `row[key]`. */
-    render?: (row: T) => ReactNode;
+    render?: ((row: T) => ReactNode) | undefined;
     /** Custom value accessor used when `render` is absent (default `row[key]`). */
-    getValue?: (row: T) => unknown;
+    getValue?: ((row: T) => unknown) | undefined;
 }
 /** Pagination model for DataGrid (`page` is 1-based). */
 export interface DataGridPagination {
@@ -46,29 +46,29 @@ export interface DataGridPagination {
     pageSize: number;
     total: number;
     onPageChange: (page: number) => void;
-    onPageSizeChange?: (pageSize: number) => void;
-    pageSizes?: number[];
+    onPageSizeChange?: ((pageSize: number) => void) | undefined;
+    pageSizes?: number[] | undefined;
 }
 /** i18n labels for the DataGrid pagination bar. */
 export interface DataGridPaginationLabels {
-    loading?: ReactNode;
-    rowsPerPage?: ReactNode;
-    firstPage?: string;
-    previousPage?: string;
-    nextPage?: string;
-    lastPage?: string;
+    loading?: ReactNode | undefined;
+    rowsPerPage?: ReactNode | undefined;
+    firstPage?: string | undefined;
+    previousPage?: string | undefined;
+    nextPage?: string | undefined;
+    lastPage?: string | undefined;
     /** Accessible name for the pagination navigation landmark (WCAG landmark / 2.4.1). */
-    navLabel?: string;
+    navLabel?: string | undefined;
     /** Range summary; `fmt` is the resolved locale number formatter. */
-    rangeOf?: (from: number, to: number, total: number, fmt: (n: number) => string) => ReactNode;
+    rangeOf?: ((from: number, to: number, total: number, fmt: (n: number) => string) => ReactNode) | undefined;
 }
 /** i18n labels for DataGrid. */
 export interface DataGridLabels {
-    tableAria?: string;
-    selectAll?: string;
-    selectRow?: (id: RowId) => string;
-    actionsHeader?: string;
-    pagination?: DataGridPaginationLabels;
+    tableAria?: string | undefined;
+    selectAll?: string | undefined;
+    selectRow?: ((id: RowId) => string) | undefined;
+    actionsHeader?: string | undefined;
+    pagination?: DataGridPaginationLabels | undefined;
 }
 /** Context object passed to `renderMobileCard`. */
 export interface DataGridMobileCardContext {
@@ -78,54 +78,54 @@ export interface DataGridMobileCardContext {
 /** Options accepted by the exported `applySort` helper. */
 export interface ApplySortOptions {
     /** BCP-47 locale for collation (default "fr-FR"). */
-    locale?: string;
+    locale?: string | undefined;
 }
 /** Props for the DataGrid pattern over row type `T`. */
 export interface DataGridProps<T> {
-    rows?: T[];
+    rows?: T[] | undefined;
     columns: DataGridColumn<T>[];
-    loading?: boolean;
+    loading?: boolean | undefined;
     /** Any truthy value switches the grid to its error branch (renders `errorState`). */
     error?: unknown;
-    sort?: SortDescriptor[];
+    sort?: SortDescriptor[] | undefined;
     /**
      * Sort-state setter. DataGrid forwards this straight to SortableHeader,
      * which invokes it with an UPDATER function — so it must behave like a
      * `useState` dispatcher (accepts a value OR a `(prev) => next` updater).
      */
-    onSortChange?: Dispatch<SetStateAction<SortDescriptor[]>>;
-    selection?: Set<RowId> | RowId[];
+    onSortChange?: Dispatch<SetStateAction<SortDescriptor[]>> | undefined;
+    selection?: Set<RowId> | RowId[] | undefined;
     /** Receives the next selection as a `Set`. Presence enables the checkbox column. */
-    onSelectionChange?: (selection: Set<RowId>) => void;
-    pagination?: DataGridPagination;
-    emptyState?: ReactNode;
-    filteredEmptyState?: ReactNode;
-    errorState?: ReactNode;
+    onSelectionChange?: ((selection: Set<RowId>) => void) | undefined;
+    pagination?: DataGridPagination | undefined;
+    emptyState?: ReactNode | undefined;
+    filteredEmptyState?: ReactNode | undefined;
+    errorState?: ReactNode | undefined;
     /** Row identity (default `(row) => row.id`). */
-    getRowId?: (row: T) => RowId;
-    onRowClick?: (row: T) => void;
-    rowFlashId?: RowId;
-    activeRowId?: RowId;
+    getRowId?: ((row: T) => RowId) | undefined;
+    onRowClick?: ((row: T) => void) | undefined;
+    rowFlashId?: RowId | undefined;
+    activeRowId?: RowId | undefined;
     /** Renders the per-row actions overlay. Presence enables the actions column. */
-    rowActions?: (row: T) => ReactNode;
-    hiddenColumns?: Set<string> | string[];
+    rowActions?: ((row: T) => ReactNode) | undefined;
+    hiddenColumns?: Set<string> | string[] | undefined;
     /** Marks an empty result as filter-induced (renders `filteredEmptyState`). */
-    filtered?: boolean;
-    density?: Density;
+    filtered?: boolean | undefined;
+    density?: Density | undefined;
     /** Contextual accessible table name (WCAG 1.3.1 / Charter R-DG). */
-    ariaLabel?: string;
+    ariaLabel?: string | undefined;
     /** BCP-47 locale for number formatting (default "fr-FR"). */
-    locale?: string;
-    labels?: DataGridLabels;
-    maxBodyHeight?: number | string;
-    resizable?: boolean;
-    columnWidths?: Record<string, number>;
-    onColumnWidthsChange?: (widths: Record<string, number>) => void;
-    reorderable?: boolean;
-    columnOrder?: string[];
-    onColumnOrderChange?: (order: string[]) => void;
+    locale?: string | undefined;
+    labels?: DataGridLabels | undefined;
+    maxBodyHeight?: number | string | undefined;
+    resizable?: boolean | undefined;
+    columnWidths?: Record<string, number> | undefined;
+    onColumnWidthsChange?: ((widths: Record<string, number>) => void) | undefined;
+    reorderable?: boolean | undefined;
+    columnOrder?: string[] | undefined;
+    onColumnOrderChange?: ((order: string[]) => void) | undefined;
     /** Opt-in mobile card renderer; below `mobileBreakpoint` the grid renders cards. */
-    renderMobileCard?: (row: T, ctx: DataGridMobileCardContext) => ReactNode;
-    mobileBreakpoint?: Breakpoint;
+    renderMobileCard?: ((row: T, ctx: DataGridMobileCardContext) => ReactNode) | undefined;
+    mobileBreakpoint?: Breakpoint | undefined;
 }
 //# sourceMappingURL=datagrid.d.ts.map

package/dist/v2/types/datagrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datagrid.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/types/datagrid.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"datagrid.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/types/datagrid.ts"],"names":[],"mappings":"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"}

package/dist/v2/types/datagrid.js.map

@@ -1 +1 @@
-{"version":3,"file":"datagrid.js","names":[],"sources":["../../../src/lib/v2/types/datagrid.ts"],"sourcesContent":["/**\r\n * @portnet/ui v2 — DataGrid generic contract.\r\n *\r\n * Derived verbatim from the DataGrid / SortableHeader / _dataGridShared\r\n * PropTypes + implementation (the executable contract). MUI-independent:\r\n * component-level composition with MUI prop types happens in the component\r\n * itself (Part 2), not here.\r\n */\r\n\r\nimport type { Dispatch, ReactNode, SetStateAction } from \"react\";\r\nimport type { Alignment, Breakpoint, Density, RowId, SortDescriptor } from \"./common\";\r\n\r\n/** A DataGrid column definition over row type `T`. */\r\nexport interface DataGridColumn<T> {\r\n  /** Unique column key; also the default value accessor (`row[key]`). */\r\n  key: string;\r\n  /** Header content. */\r\n  header: ReactNode;\r\n  align?: Alignment;\r\n  /** Right-align + tabular numerals. */\r\n  numeric?: boolean;\r\n  /** Monospaced cell font + tabular numerals. */\r\n  mono?: boolean;\r\n  /** Default true when `onSortChange` is set; `false` opts the column out of sorting. */\r\n  sortable?: boolean;\r\n  /** Default true when the grid is `resizable`; `false` opts the column out. */\r\n  resizable?: boolean;\r\n  /** Default true when the grid is `reorderable`; `false` opts the column out. */\r\n  reorderable?: boolean;\r\n  /** Reveal the cell only on row hover / focus-within / coarse pointer. */\r\n  hoverOnly?: boolean;\r\n  /** Column may be toggled by a column-visibility UI. */\r\n  toggleable?: boolean;\r\n  /** Preferred width (px number or CSS length). */\r\n  width?: number | string;\r\n  /** Hard max width (px number or CSS length). */\r\n  maxWidth?: number | string;\r\n  /** Wrap long content instead of truncating with an ellipsis. */\r\n  wrap?: boolean;\r\n  /** Custom cell renderer; overrides `getValue` / `row[key]`. */\r\n  render?: (row: T) => ReactNode;\r\n  /** Custom value accessor used when `render` is absent (default `row[key]`). */\r\n  getValue?: (row: T) => unknown;\r\n}\r\n\r\n/** Pagination model for DataGrid (`page` is 1-based). */\r\nexport interface DataGridPagination {\r\n  page: number;\r\n  pageSize: number;\r\n  total: number;\r\n  onPageChange: (page: number) => void;\r\n  onPageSizeChange?: (pageSize: number) => void;\r\n  pageSizes?: number[];\r\n}\r\n\r\n/** i18n labels for the DataGrid pagination bar. */\r\nexport interface DataGridPaginationLabels {\r\n  loading?: ReactNode;\r\n  rowsPerPage?: ReactNode;\r\n  firstPage?: string;\r\n  previousPage?: string;\r\n  nextPage?: string;\r\n  lastPage?: string;\r\n  /** Accessible name for the pagination navigation landmark (WCAG landmark / 2.4.1). */\r\n  navLabel?: string;\r\n  /** Range summary; `fmt` is the resolved locale number formatter. */\r\n  rangeOf?: (from: number, to: number, total: number, fmt: (n: number) => string) => ReactNode;\r\n}\r\n\r\n/** i18n labels for DataGrid. */\r\nexport interface DataGridLabels {\r\n  tableAria?: string;\r\n  selectAll?: string;\r\n  selectRow?: (id: RowId) => string;\r\n  actionsHeader?: string;\r\n  pagination?: DataGridPaginationLabels;\r\n}\r\n\r\n/** Context object passed to `renderMobileCard`. */\r\nexport interface DataGridMobileCardContext {\r\n  isActive: boolean;\r\n  isSelected: boolean;\r\n}\r\n\r\n/** Options accepted by the exported `applySort` helper. */\r\nexport interface ApplySortOptions {\r\n  /** BCP-47 locale for collation (default \"fr-FR\"). */\r\n  locale?: string;\r\n}\r\n\r\n/** Props for the DataGrid pattern over row type `T`. */\r\nexport interface DataGridProps<T> {\r\n  rows?: T[];\r\n  columns: DataGridColumn<T>[];\r\n  loading?: boolean;\r\n  /** Any truthy value switches the grid to its error branch (renders `errorState`). */\r\n  error?: unknown;\r\n  sort?: SortDescriptor[];\r\n  /**\r\n   * Sort-state setter. DataGrid forwards this straight to SortableHeader,\r\n   * which invokes it with an UPDATER function — so it must behave like a\r\n   * `useState` dispatcher (accepts a value OR a `(prev) => next` updater).\r\n   */\r\n  onSortChange?: Dispatch<SetStateAction<SortDescriptor[]>>;\r\n  selection?: Set<RowId> | RowId[];\r\n  /** Receives the next selection as a `Set`. Presence enables the checkbox column. */\r\n  onSelectionChange?: (selection: Set<RowId>) => void;\r\n  pagination?: DataGridPagination;\r\n  emptyState?: ReactNode;\r\n  filteredEmptyState?: ReactNode;\r\n  errorState?: ReactNode;\r\n  /** Row identity (default `(row) => row.id`). */\r\n  getRowId?: (row: T) => RowId;\r\n  onRowClick?: (row: T) => void;\r\n  rowFlashId?: RowId;\r\n  activeRowId?: RowId;\r\n  /** Renders the per-row actions overlay. Presence enables the actions column. */\r\n  rowActions?: (row: T) => ReactNode;\r\n  hiddenColumns?: Set<string> | string[];\r\n  /** Marks an empty result as filter-induced (renders `filteredEmptyState`). */\r\n  filtered?: boolean;\r\n  density?: Density;\r\n  /** Contextual accessible table name (WCAG 1.3.1 / Charter R-DG). */\r\n  ariaLabel?: string;\r\n  /** BCP-47 locale for number formatting (default \"fr-FR\"). */\r\n  locale?: string;\r\n  labels?: DataGridLabels;\r\n  maxBodyHeight?: number | string;\r\n  resizable?: boolean;\r\n  columnWidths?: Record<string, number>;\r\n  onColumnWidthsChange?: (widths: Record<string, number>) => void;\r\n  reorderable?: boolean;\r\n  columnOrder?: string[];\r\n  onColumnOrderChange?: (order: string[]) => void;\r\n  /** Opt-in mobile card renderer; below `mobileBreakpoint` the grid renders cards. */\r\n  renderMobileCard?: (row: T, ctx: DataGridMobileCardContext) => ReactNode;\r\n  mobileBreakpoint?: Breakpoint;\r\n}\r\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"datagrid.js","names":[],"sources":["../../../src/lib/v2/types/datagrid.ts"],"sourcesContent":["/**\r\n * @portnet/ui v2 — DataGrid generic contract.\r\n *\r\n * Derived verbatim from the DataGrid / SortableHeader / _dataGridShared\r\n * PropTypes + implementation (the executable contract). MUI-independent:\r\n * component-level composition with MUI prop types happens in the component\r\n * itself (Part 2), not here.\r\n */\r\n\r\nimport type { Dispatch, ReactNode, SetStateAction } from \"react\";\r\nimport type { Alignment, Breakpoint, Density, RowId, SortDescriptor } from \"./common\";\r\n\r\n/** A DataGrid column definition over row type `T`. */\r\nexport interface DataGridColumn<T> {\r\n  /** Unique column key; also the default value accessor (`row[key]`). */\r\n  key: string;\r\n  /** Header content. */\r\n  header: ReactNode;\r\n  align?: Alignment | undefined;\r\n  /** Right-align + tabular numerals. */\r\n  numeric?: boolean | undefined;\r\n  /** Monospaced cell font + tabular numerals. */\r\n  mono?: boolean | undefined;\r\n  /** Default true when `onSortChange` is set; `false` opts the column out of sorting. */\r\n  sortable?: boolean | undefined;\r\n  /** Default true when the grid is `resizable`; `false` opts the column out. */\r\n  resizable?: boolean | undefined;\r\n  /** Default true when the grid is `reorderable`; `false` opts the column out. */\r\n  reorderable?: boolean | undefined;\r\n  /** Reveal the cell only on row hover / focus-within / coarse pointer. */\r\n  hoverOnly?: boolean | undefined;\r\n  /** Column may be toggled by a column-visibility UI. */\r\n  toggleable?: boolean | undefined;\r\n  /** Preferred width (px number or CSS length). */\r\n  width?: number | string | undefined;\r\n  /** Hard max width (px number or CSS length). */\r\n  maxWidth?: number | string | undefined;\r\n  /** Wrap long content instead of truncating with an ellipsis. */\r\n  wrap?: boolean | undefined;\r\n  /** Custom cell renderer; overrides `getValue` / `row[key]`. */\r\n  render?: ((row: T) => ReactNode) | undefined;\r\n  /** Custom value accessor used when `render` is absent (default `row[key]`). */\r\n  getValue?: ((row: T) => unknown) | undefined;\r\n}\r\n\r\n/** Pagination model for DataGrid (`page` is 1-based). */\r\nexport interface DataGridPagination {\r\n  page: number;\r\n  pageSize: number;\r\n  total: number;\r\n  onPageChange: (page: number) => void;\r\n  onPageSizeChange?: ((pageSize: number) => void) | undefined;\r\n  pageSizes?: number[] | undefined;\r\n}\r\n\r\n/** i18n labels for the DataGrid pagination bar. */\r\nexport interface DataGridPaginationLabels {\r\n  loading?: ReactNode | undefined;\r\n  rowsPerPage?: ReactNode | undefined;\r\n  firstPage?: string | undefined;\r\n  previousPage?: string | undefined;\r\n  nextPage?: string | undefined;\r\n  lastPage?: string | undefined;\r\n  /** Accessible name for the pagination navigation landmark (WCAG landmark / 2.4.1). */\r\n  navLabel?: string | undefined;\r\n  /** Range summary; `fmt` is the resolved locale number formatter. */\r\n  rangeOf?: ((from: number, to: number, total: number, fmt: (n: number) => string) => ReactNode) | undefined;\r\n}\r\n\r\n/** i18n labels for DataGrid. */\r\nexport interface DataGridLabels {\r\n  tableAria?: string | undefined;\r\n  selectAll?: string | undefined;\r\n  selectRow?: ((id: RowId) => string) | undefined;\r\n  actionsHeader?: string | undefined;\r\n  pagination?: DataGridPaginationLabels | undefined;\r\n}\r\n\r\n/** Context object passed to `renderMobileCard`. */\r\nexport interface DataGridMobileCardContext {\r\n  isActive: boolean;\r\n  isSelected: boolean;\r\n}\r\n\r\n/** Options accepted by the exported `applySort` helper. */\r\nexport interface ApplySortOptions {\r\n  /** BCP-47 locale for collation (default \"fr-FR\"). */\r\n  locale?: string | undefined;\r\n}\r\n\r\n/** Props for the DataGrid pattern over row type `T`. */\r\nexport interface DataGridProps<T> {\r\n  rows?: T[] | undefined;\r\n  columns: DataGridColumn<T>[];\r\n  loading?: boolean | undefined;\r\n  /** Any truthy value switches the grid to its error branch (renders `errorState`). */\r\n  error?: unknown;\r\n  sort?: SortDescriptor[] | undefined;\r\n  /**\r\n   * Sort-state setter. DataGrid forwards this straight to SortableHeader,\r\n   * which invokes it with an UPDATER function — so it must behave like a\r\n   * `useState` dispatcher (accepts a value OR a `(prev) => next` updater).\r\n   */\r\n  onSortChange?: Dispatch<SetStateAction<SortDescriptor[]>> | undefined;\r\n  selection?: Set<RowId> | RowId[] | undefined;\r\n  /** Receives the next selection as a `Set`. Presence enables the checkbox column. */\r\n  onSelectionChange?: ((selection: Set<RowId>) => void) | undefined;\r\n  pagination?: DataGridPagination | undefined;\r\n  emptyState?: ReactNode | undefined;\r\n  filteredEmptyState?: ReactNode | undefined;\r\n  errorState?: ReactNode | undefined;\r\n  /** Row identity (default `(row) => row.id`). */\r\n  getRowId?: ((row: T) => RowId) | undefined;\r\n  onRowClick?: ((row: T) => void) | undefined;\r\n  rowFlashId?: RowId | undefined;\r\n  activeRowId?: RowId | undefined;\r\n  /** Renders the per-row actions overlay. Presence enables the actions column. */\r\n  rowActions?: ((row: T) => ReactNode) | undefined;\r\n  hiddenColumns?: Set<string> | string[] | undefined;\r\n  /** Marks an empty result as filter-induced (renders `filteredEmptyState`). */\r\n  filtered?: boolean | undefined;\r\n  density?: Density | undefined;\r\n  /** Contextual accessible table name (WCAG 1.3.1 / Charter R-DG). */\r\n  ariaLabel?: string | undefined;\r\n  /** BCP-47 locale for number formatting (default \"fr-FR\"). */\r\n  locale?: string | undefined;\r\n  labels?: DataGridLabels | undefined;\r\n  maxBodyHeight?: number | string | undefined;\r\n  resizable?: boolean | undefined;\r\n  columnWidths?: Record<string, number> | undefined;\r\n  onColumnWidthsChange?: ((widths: Record<string, number>) => void) | undefined;\r\n  reorderable?: boolean | undefined;\r\n  columnOrder?: string[] | undefined;\r\n  onColumnOrderChange?: ((order: string[]) => void) | undefined;\r\n  /** Opt-in mobile card renderer; below `mobileBreakpoint` the grid renders cards. */\r\n  renderMobileCard?: ((row: T, ctx: DataGridMobileCardContext) => ReactNode) | undefined;\r\n  mobileBreakpoint?: Breakpoint | undefined;\r\n}\r\n"],"mappings":"","ignoreList":[]}

package/dist/v2/utils/apiError.d.ts

@@ -34,6 +34,10 @@
  *   getApiErrorMessage(err)                          → backend message, or the default
  *   getApiErrorMessage(err, "Échec de l'envoi.")     → custom fallback
  *   getApiErrorStatus(err)                           → 404 | undefined
+ *
+ * Envelope keys read, in order: `data.body`, `data.message`, `data.error`.
+ * Three keys because three PORTNET back-ends chose differently; see the
+ * resolution-order note on `getApiErrorMessage` before adding a fourth.
  */
 /**
  * Default user-facing fallback. French per Charter §09 (voice, vouvoiement) and
@@ -46,11 +50,41 @@ export declare const DEFAULT_API_ERROR_MESSAGE = "Une erreur est survenue. Veuil
  *
  * Resolution order, first match wins:
  *   1. the rejection itself, when it is a non-empty string;
- *   2. `error.response.data.message` — the backend's own message;
- *   3. `error.message` — **only when it is not a transport artefact** (G-07);
- *   4. `fallback`.
+ *   2. `error.response.data.body`    — the SAME envelope's third key;
+ *   3. `error.response.data.message` — the backend's own message;
+ *   4. `error.response.data.error`   — the SAME envelope's alternate key;
+ *   5. `error.message` — **only when it is not a transport artefact** (G-07);
+ *   6. `fallback`.
+ *
+ * Step 4 closes capability gap G-08. Several PORTNET back-ends populate
+ * `data.error` rather than `data.message` (addpe-fe declares BOTH on its
+ * `ApiErrorBody` and read both at seven call sites), so a helper that stopped at
+ * `data.message` skipped a real business message and fell through to the generic
+ * fallback — which made it non-substitutable for the module-local extractors it
+ * exists to replace. Strictly additive: what step 4 now catches previously
+ * reached step 5 or 6.
+ *
+ * Step 2 closes G-08bis — the same defect, a third key. `caution-ui`'s axios
+ * interceptor reads `error.response.data.body ?? error.response.data.message`,
+ * so on that back-end a helper stopping at `message` again skipped a real
+ * business message. Without step 2 the helper was non-substitutable there and
+ * the module would have had to keep its own assertion-based extractor.
+ *
+ * WHY STEP 2 SITS BEFORE `message` AND NOT AFTER `error`.
+ * `caution-ui` uses `??`, which is direct evidence that a single response can
+ * carry both keys and that `body` is the one that back-end means. Appending
+ * `body` at the end of the envelope hops would therefore have SILENTLY FLIPPED
+ * which message its users see. Placing it first preserves that precedence, and
+ * is provably a no-op for every module that does not populate `body`: `readPath`
+ * returns `undefined` and resolution falls straight through to `message`.
+ *
+ * The one case this perturbs is a back-end that populates BOTH `body` and
+ * `message` while intending `message` to win. No such module exists in the
+ * portfolio — addpe-fe's `ApiErrorBody` declares `message` and `error`, not
+ * `body` — and a module in that position should say so here rather than have the
+ * order guessed for it.
  *
- * Step 3 is filtered: `"Request failed with status code 500"`, `"Network Error"`,
+ * Step 5 is filtered: `"Request failed with status code 500"`, `"Network Error"`,
  * timeouts and errno codes are SUPPRESSED so the caller's own French copy is
  * used instead (Charter §09.3 — no raw technical detail). A message a module
  * threw deliberately still passes through. Use `getApiErrorDetail` when you want
@@ -81,10 +115,37 @@ export declare function getApiErrorDetail(error: unknown): string | undefined;
 /**
  * HTTP status carried by a rejection, when there is one.
  *
+ * Resolution order, first numeric match wins:
+ *   1. `error.response.data.status` — a BODY-level status;
+ *   2. `error.response.status`       — the transport status.
+ *
  * Returns `undefined` for a network drop, a timeout, or any non-HTTP rejection —
  * which is the signal callers use to distinguish "the server answered with an
  * error" from "there was no answer at all" (Charter R-4.3: a status-less failure
  * is a network banner, not a toast).
+ *
+ * Step 1 closes G-08ter, the status-side counterpart of the envelope-key gaps
+ * G-08 / G-08bis. Several PORTNET back-ends put the meaningful status in the
+ * BODY: caution-ui's axios interceptor reads
+ * `error.response.data.status ?? error.response.status` and routes on the
+ * result (404 -> not-found page, 500 -> server-error page, 401 -> re-login), and
+ * its RESPONSE interceptor does the same for success handling. A helper reading
+ * only the transport status was therefore not substitutable there — the module
+ * had to keep a hand-written `HttpErrorLike` interface and assert onto it, which
+ * is exactly the anti-pattern G-04 exists to end. Closing the message side
+ * (G-08bis) without the status side would have left that assertion in place for
+ * the sake of one field.
+ *
+ * Body-first ordering mirrors the module's own `??` and is provably a no-op for
+ * every back-end that does not populate `data.status`: `readPath` returns
+ * `undefined` and resolution falls through to the transport status.
+ *
+ * BOTH hops are numeric-guarded, which is a deliberate tightening over the
+ * module code being replaced. That code did `String(status)` on whatever it
+ * found, so a body carrying `status: "ERROR"` produced a `String` switch miss
+ * and fell to the default toast branch; here a non-numeric `data.status` is
+ * ignored and the real transport status is used instead. That is the more useful
+ * answer, and it keeps the return type honest — the signature promises a number.
  */
 export declare function getApiErrorStatus(error: unknown): number | undefined;
 //# sourceMappingURL=apiError.d.ts.map

package/dist/v2/utils/apiError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apiError.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/utils/apiError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,sDACU,CAAC;AA6GjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,MAAkC,GAC3C,MAAM,CAQR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGpE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGpE"}
+{"version":3,"file":"apiError.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/utils/apiError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,sDACU,CAAC;AA6GjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,MAAkC,GAC3C,MAAM,CAUR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGpE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMpE"}

package/dist/v2/utils/apiError.js

@@ -47,6 +47,10 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
  *   getApiErrorMessage(err)                          → backend message, or the default
  *   getApiErrorMessage(err, "Échec de l'envoi.")     → custom fallback
  *   getApiErrorStatus(err)                           → 404 | undefined
+ *
+ * Envelope keys read, in order: `data.body`, `data.message`, `data.error`.
+ * Three keys because three PORTNET back-ends chose differently; see the
+ * resolution-order note on `getApiErrorMessage` before adding a fourth.
  */
 
 /**
@@ -170,11 +174,41 @@ var asUserFacingMessage = function asUserFacingMessage(value) {
  *
  * Resolution order, first match wins:
  *   1. the rejection itself, when it is a non-empty string;
- *   2. `error.response.data.message` — the backend's own message;
- *   3. `error.message` — **only when it is not a transport artefact** (G-07);
- *   4. `fallback`.
+ *   2. `error.response.data.body`    — the SAME envelope's third key;
+ *   3. `error.response.data.message` — the backend's own message;
+ *   4. `error.response.data.error`   — the SAME envelope's alternate key;
+ *   5. `error.message` — **only when it is not a transport artefact** (G-07);
+ *   6. `fallback`.
+ *
+ * Step 4 closes capability gap G-08. Several PORTNET back-ends populate
+ * `data.error` rather than `data.message` (addpe-fe declares BOTH on its
+ * `ApiErrorBody` and read both at seven call sites), so a helper that stopped at
+ * `data.message` skipped a real business message and fell through to the generic
+ * fallback — which made it non-substitutable for the module-local extractors it
+ * exists to replace. Strictly additive: what step 4 now catches previously
+ * reached step 5 or 6.
+ *
+ * Step 2 closes G-08bis — the same defect, a third key. `caution-ui`'s axios
+ * interceptor reads `error.response.data.body ?? error.response.data.message`,
+ * so on that back-end a helper stopping at `message` again skipped a real
+ * business message. Without step 2 the helper was non-substitutable there and
+ * the module would have had to keep its own assertion-based extractor.
+ *
+ * WHY STEP 2 SITS BEFORE `message` AND NOT AFTER `error`.
+ * `caution-ui` uses `??`, which is direct evidence that a single response can
+ * carry both keys and that `body` is the one that back-end means. Appending
+ * `body` at the end of the envelope hops would therefore have SILENTLY FLIPPED
+ * which message its users see. Placing it first preserves that precedence, and
+ * is provably a no-op for every module that does not populate `body`: `readPath`
+ * returns `undefined` and resolution falls straight through to `message`.
+ *
+ * The one case this perturbs is a back-end that populates BOTH `body` and
+ * `message` while intending `message` to win. No such module exists in the
+ * portfolio — addpe-fe's `ApiErrorBody` declares `message` and `error`, not
+ * `body` — and a module in that position should say so here rather than have the
+ * order guessed for it.
  *
- * Step 3 is filtered: `"Request failed with status code 500"`, `"Network Error"`,
+ * Step 5 is filtered: `"Request failed with status code 500"`, `"Network Error"`,
  * timeouts and errno codes are SUPPRESSED so the caller's own French copy is
  * used instead (Charter §09.3 — no raw technical detail). A message a module
  * threw deliberately still passes through. Use `getApiErrorDetail` when you want
@@ -187,10 +221,10 @@ var asUserFacingMessage = function asUserFacingMessage(value) {
  * @param fallback Message when nothing usable is found.
  */
 function getApiErrorMessage(error) {
-  var _ref, _asNonEmptyString;
+  var _ref, _ref2, _ref3, _asNonEmptyString;
   var fallback = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : DEFAULT_API_ERROR_MESSAGE;
   if (typeof error === "string" && error.length > 0) return error;
-  return (_ref = (_asNonEmptyString = asNonEmptyString(readPath(error, ["response", "data", "message"]))) !== null && _asNonEmptyString !== void 0 ? _asNonEmptyString : asUserFacingMessage(readPath(error, ["message"]))) !== null && _ref !== void 0 ? _ref : fallback;
+  return (_ref = (_ref2 = (_ref3 = (_asNonEmptyString = asNonEmptyString(readPath(error, ["response", "data", "body"]))) !== null && _asNonEmptyString !== void 0 ? _asNonEmptyString : asNonEmptyString(readPath(error, ["response", "data", "message"]))) !== null && _ref3 !== void 0 ? _ref3 : asNonEmptyString(readPath(error, ["response", "data", "error"]))) !== null && _ref2 !== void 0 ? _ref2 : asUserFacingMessage(readPath(error, ["message"]))) !== null && _ref !== void 0 ? _ref : fallback;
 }
 
 /**
@@ -215,12 +249,41 @@ function getApiErrorDetail(error) {
 /**
  * HTTP status carried by a rejection, when there is one.
  *
+ * Resolution order, first numeric match wins:
+ *   1. `error.response.data.status` — a BODY-level status;
+ *   2. `error.response.status`       — the transport status.
+ *
  * Returns `undefined` for a network drop, a timeout, or any non-HTTP rejection —
  * which is the signal callers use to distinguish "the server answered with an
  * error" from "there was no answer at all" (Charter R-4.3: a status-less failure
  * is a network banner, not a toast).
+ *
+ * Step 1 closes G-08ter, the status-side counterpart of the envelope-key gaps
+ * G-08 / G-08bis. Several PORTNET back-ends put the meaningful status in the
+ * BODY: caution-ui's axios interceptor reads
+ * `error.response.data.status ?? error.response.status` and routes on the
+ * result (404 -> not-found page, 500 -> server-error page, 401 -> re-login), and
+ * its RESPONSE interceptor does the same for success handling. A helper reading
+ * only the transport status was therefore not substitutable there — the module
+ * had to keep a hand-written `HttpErrorLike` interface and assert onto it, which
+ * is exactly the anti-pattern G-04 exists to end. Closing the message side
+ * (G-08bis) without the status side would have left that assertion in place for
+ * the sake of one field.
+ *
+ * Body-first ordering mirrors the module's own `??` and is provably a no-op for
+ * every back-end that does not populate `data.status`: `readPath` returns
+ * `undefined` and resolution falls through to the transport status.
+ *
+ * BOTH hops are numeric-guarded, which is a deliberate tightening over the
+ * module code being replaced. That code did `String(status)` on whatever it
+ * found, so a body carrying `status: "ERROR"` produced a `String` switch miss
+ * and fell to the default toast branch; here a non-numeric `data.status` is
+ * ignored and the real transport status is used instead. That is the more useful
+ * answer, and it keeps the return type honest — the signature promises a number.
  */
 function getApiErrorStatus(error) {
+  var bodyStatus = readPath(error, ["response", "data", "status"]);
+  if (typeof bodyStatus === "number") return bodyStatus;
   var status = readPath(error, ["response", "status"]);
   return typeof status === "number" ? status : undefined;
 }

package/dist/v2/utils/apiError.js.map

@@ -1 +1 @@
-{"version":3,"file":"apiError.js","names":["DEFAULT_API_ERROR_MESSAGE","exports","readPath","source","path","current","_iterator","_createForOfIteratorHelper","_step","s","n","done","key","value","_typeof","undefined","Reflect","get","err","e","f","asNonEmptyString","length","TRANSPORT_MESSAGE_PATTERNS","isTransportMessage","some","pattern","test","trim","asUserFacingMessage","text","getApiErrorMessage","error","_ref","_asNonEmptyString","fallback","arguments","getApiErrorDetail","getApiErrorStatus","status"],"sources":["../../../src/lib/v2/utils/apiError.ts"],"sourcesContent":["/**\r\n * apiError — narrow an `unknown` rejection into something displayable.\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY (capability gap G-04)\r\n *\r\n * The Platform TypeScript Guidelines mandate `useUnknownInCatchVariables`, so\r\n * `catch (e)` binds `unknown` in EVERY saga of EVERY consuming module. The same\r\n * guidelines forbid `any` and unsafe assertions. Between those two rules sits a\r\n * narrowing helper that the library did not provide — so each module wrote its\r\n * own, and the observed outcome was that they wrote it the forbidden way:\r\n *\r\n *     (error as { response?: { data?: { message?: unknown } } }).response\r\n *\r\n * i.e. an unchecked assertion on an `unknown`, used to work around a flag the\r\n * platform imposes. Two modules audited (`procuration-portnet-fe`,\r\n * `procuration-fe`) had independently reached for exactly that construct.\r\n * A mandated strict-mode flag with no sanctioned escape hatch produces\r\n * unsanctioned ones.\r\n *\r\n * Implementation notes\r\n * --------------------\r\n * `readPath` walks nested objects using the `in` operator, which narrows without\r\n * an assertion, and `Reflect.get`, which returns the value as `unknown` rather\r\n * than widening anything to `any`. No assertion appears anywhere in this file.\r\n *\r\n * Deliberately DUCK-TYPED rather than built on `axios.isAxiosError`. Three\r\n * reasons: this library must not take a hard axios dependency for a string\r\n * helper; a plain object shaped like an axios error (a hand-rolled reject, a\r\n * test double, a non-axios transport) still resolves correctly; and the check\r\n * stays valid across axios majors.\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n *   getApiErrorMessage(err)                          → backend message, or the default\r\n *   getApiErrorMessage(err, \"Échec de l'envoi.\")     → custom fallback\r\n *   getApiErrorStatus(err)                           → 404 | undefined\r\n */\r\n\r\n/**\r\n * Default user-facing fallback. French per Charter §09 (voice, vouvoiement) and\r\n * §09.3 (no raw technical detail — never \"Erreur 422 Unprocessable Entity\").\r\n * Override per call site when a screen can say something more useful.\r\n */\r\nexport const DEFAULT_API_ERROR_MESSAGE =\r\n  \"Une erreur est survenue. Veuillez réessayer.\";\r\n\r\n/**\r\n * Walk `path` through nested non-null objects, returning the value at the end,\r\n * or `undefined` if any hop is missing. Assertion-free.\r\n */\r\nconst readPath = (source: unknown, path: readonly string[]): unknown => {\r\n  let current: unknown = source;\r\n\r\n  for (const key of path) {\r\n    if (typeof current !== \"object\" || current === null || !(key in current)) {\r\n      return undefined;\r\n    }\r\n    current = Reflect.get(current, key);\r\n  }\r\n\r\n  return current;\r\n};\r\n\r\nconst asNonEmptyString = (value: unknown): string | undefined =>\r\n  typeof value === \"string\" && value.length > 0 ? value : undefined;\r\n\r\n/**\r\n * Transport-layer phrasings that must NEVER reach a user — capability gap G-07.\r\n *\r\n * ──────────────────────────────────────────────────────────────────────\r\n * THE DEFECT THIS FIXES\r\n *\r\n * `getApiErrorMessage` resolved `error.message` BEFORE its fallback. An\r\n * `AxiosError` always has `.message`, so on any server error carrying no\r\n * `response.data.message` — a 500 with an empty body, a gateway error, a\r\n * timeout — step 3 won and the user was shown:\r\n *\r\n *     \"Request failed with status code 500\"\r\n *\r\n * English, technical, and precisely the shape Charter §09.3 names as forbidden\r\n * (\"✗ « Erreur 422 — Unprocessable Entity »\"). Worse, it made every consuming\r\n * module's carefully-written French fallback effectively UNREACHABLE — the\r\n * argument was accepted and then almost never used. Found during the\r\n * `procuration-portnet-fe` Area 10 audit, where 12 call sites pass a considered\r\n * fallback that could essentially never render.\r\n *\r\n * WHY A DENY-LIST AND NOT SIMPLY DROPPING STEP 3\r\n *\r\n * Step 3 also carries LEGITIMATE messages: any `throw new Error(\"Ce titre ne\r\n * peut pas être supprimé car il est en cours de validation.\")` in module code\r\n * arrives through exactly the same path. Removing the hop would trade a leak of\r\n * technical strings for the loss of real business messages across the whole\r\n * platform — a worse outcome. So the hop stays and only transport phrasings are\r\n * suppressed.\r\n *\r\n * The list is deliberately CONSERVATIVE: anything not recognised passes through,\r\n * on the assumption a human wrote it. A false negative shows one ugly string; a\r\n * false positive silently replaces a real business message with a generic\r\n * fallback, which is the more damaging error.\r\n *\r\n * Sourced from axios's own message construction (`settle`, `AxiosError` codes\r\n * ECONNABORTED / ETIMEDOUT / ERR_NETWORK / ERR_CANCELED) plus the Node socket\r\n * phrasing that surfaces through SSR and test doubles.\r\n * ──────────────────────────────────────────────────────────────────────\r\n */\r\nconst TRANSPORT_MESSAGE_PATTERNS: readonly RegExp[] = [\r\n  /^request failed with status code \\d+$/i,\r\n  /^network error$/i,\r\n  /^timeout of \\d+ms exceeded$/i,\r\n  /^timeout exceeded$/i,\r\n  /^request aborted$/i,\r\n  /^canceled$/i,\r\n  /^unsupported protocol/i,\r\n  /^maximum content size exceeded$/i,\r\n  /^socket hang up$/i,\r\n  /* ── errno codes and axios error codes ── CASE-SENSITIVE, DELIBERATELY ─────\r\n   *\r\n   * These two are the only patterns here NOT marked `/i`, and the asymmetry is\r\n   * load-bearing. errno constants are uppercase by universal convention\r\n   * (`ETIMEDOUT`, `ECONNREFUSED`, `ENOTFOUND`, `EPIPE`), so an uppercase-only\r\n   * match identifies them precisely. Matching case-insensitively would make\r\n   * `/^e[a-z]+$/i` swallow ordinary French words beginning with \"e\" — \"erreur\",\r\n   * \"expiré\", \"échec\" — turning a real business message into a generic fallback,\r\n   * which is the more damaging failure this list is tuned against.\r\n   *\r\n   * ⚠ An earlier version of the first pattern was `/^ec[a-z]+$/i`, which matched\r\n   * `ECONNREFUSED` (it begins \"EC\") but silently MISSED `ETIMEDOUT` (\"ET\"),\r\n   * despite the comment claiming otherwise. The unit test caught it. Do not\r\n   * narrow the prefix again: the family is \"E + uppercase word\", not \"EC...\".\r\n   *\r\n   * Residual, accepted: an all-caps single word like \"ERREUR\" is treated as an\r\n   * errno code. A module should not be throwing all-caps single-word messages at\r\n   * users, and replacing one with a proper French fallback is an improvement. */\r\n  /^E[A-Z]{3,}$/, // errno: ETIMEDOUT, ECONNREFUSED, ECONNRESET, ENOTFOUND, EPIPE\r\n  /^ERR_[A-Z_]+$/, // axios: ERR_NETWORK, ERR_CANCELED, ERR_BAD_RESPONSE\r\n];\r\n\r\n/** Is this string an axios/transport artefact rather than something for a user? */\r\nconst isTransportMessage = (value: string): boolean =>\r\n  TRANSPORT_MESSAGE_PATTERNS.some((pattern) => pattern.test(value.trim()));\r\n\r\n/**\r\n * `error.message`, but only when it is fit to show a user.\r\n *\r\n * Suppresses transport phrasings (G-07) so the caller's French fallback is\r\n * reached instead. Module-thrown `Error` messages pass through untouched.\r\n */\r\nconst asUserFacingMessage = (value: unknown): string | undefined => {\r\n  const text = asNonEmptyString(value);\r\n  if (text === undefined) return undefined;\r\n  return isTransportMessage(text) ? undefined : text;\r\n};\r\n\r\n/**\r\n * Best available human-readable message for a rejection of unknown shape.\r\n *\r\n * Resolution order, first match wins:\r\n *   1. the rejection itself, when it is a non-empty string;\r\n *   2. `error.response.data.message` — the backend's own message;\r\n *   3. `error.message` — **only when it is not a transport artefact** (G-07);\r\n *   4. `fallback`.\r\n *\r\n * Step 3 is filtered: `\"Request failed with status code 500\"`, `\"Network Error\"`,\r\n * timeouts and errno codes are SUPPRESSED so the caller's own French copy is\r\n * used instead (Charter §09.3 — no raw technical detail). A message a module\r\n * threw deliberately still passes through. Use `getApiErrorDetail` when you want\r\n * the unfiltered string for a log.\r\n *\r\n * Never throws and never returns an empty string, so it is safe to render\r\n * directly into a toast or a `Banner`.\r\n *\r\n * @param error    The caught value. `unknown` by design.\r\n * @param fallback Message when nothing usable is found.\r\n */\r\nexport function getApiErrorMessage(\r\n  error: unknown,\r\n  fallback: string = DEFAULT_API_ERROR_MESSAGE\r\n): string {\r\n  if (typeof error === \"string\" && error.length > 0) return error;\r\n\r\n  return (\r\n    asNonEmptyString(readPath(error, [\"response\", \"data\", \"message\"])) ??\r\n    asUserFacingMessage(readPath(error, [\"message\"])) ??\r\n    fallback\r\n  );\r\n}\r\n\r\n/**\r\n * Unfiltered technical detail for LOGGING — never for display.\r\n *\r\n * `getApiErrorMessage` deliberately suppresses transport phrasings (G-07), which\r\n * is right for a toast and wrong for a console or an APM breadcrumb, where\r\n * `\"Request failed with status code 502\"` is exactly what an operator needs. This\r\n * is the escape hatch: it returns the raw `error.message` when there is one,\r\n * whatever its shape.\r\n *\r\n * Pair them:\r\n *\r\n *     toast(getApiErrorMessage(err, \"Échec de l'envoi.\"), \"error\");\r\n *     console.error(\"[submit]\", getApiErrorStatus(err), getApiErrorDetail(err));\r\n */\r\nexport function getApiErrorDetail(error: unknown): string | undefined {\r\n  if (typeof error === \"string\" && error.length > 0) return error;\r\n  return asNonEmptyString(readPath(error, [\"message\"]));\r\n}\r\n\r\n/**\r\n * HTTP status carried by a rejection, when there is one.\r\n *\r\n * Returns `undefined` for a network drop, a timeout, or any non-HTTP rejection —\r\n * which is the signal callers use to distinguish \"the server answered with an\r\n * error\" from \"there was no answer at all\" (Charter R-4.3: a status-less failure\r\n * is a network banner, not a toast).\r\n */\r\nexport function getApiErrorStatus(error: unknown): number | undefined {\r\n  const status = readPath(error, [\"response\", \"status\"]);\r\n  return typeof status === \"number\" ? status : undefined;\r\n}\r\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"apiError.js","names":["DEFAULT_API_ERROR_MESSAGE","exports","readPath","source","path","current","_iterator","_createForOfIteratorHelper","_step","s","n","done","key","value","_typeof","undefined","Reflect","get","err","e","f","asNonEmptyString","length","TRANSPORT_MESSAGE_PATTERNS","isTransportMessage","some","pattern","test","trim","asUserFacingMessage","text","getApiErrorMessage","error","_ref","_ref2","_ref3","_asNonEmptyString","fallback","arguments","getApiErrorDetail","getApiErrorStatus","bodyStatus","status"],"sources":["../../../src/lib/v2/utils/apiError.ts"],"sourcesContent":["/**\r\n * apiError — narrow an `unknown` rejection into something displayable.\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY (capability gap G-04)\r\n *\r\n * The Platform TypeScript Guidelines mandate `useUnknownInCatchVariables`, so\r\n * `catch (e)` binds `unknown` in EVERY saga of EVERY consuming module. The same\r\n * guidelines forbid `any` and unsafe assertions. Between those two rules sits a\r\n * narrowing helper that the library did not provide — so each module wrote its\r\n * own, and the observed outcome was that they wrote it the forbidden way:\r\n *\r\n *     (error as { response?: { data?: { message?: unknown } } }).response\r\n *\r\n * i.e. an unchecked assertion on an `unknown`, used to work around a flag the\r\n * platform imposes. Two modules audited (`procuration-portnet-fe`,\r\n * `procuration-fe`) had independently reached for exactly that construct.\r\n * A mandated strict-mode flag with no sanctioned escape hatch produces\r\n * unsanctioned ones.\r\n *\r\n * Implementation notes\r\n * --------------------\r\n * `readPath` walks nested objects using the `in` operator, which narrows without\r\n * an assertion, and `Reflect.get`, which returns the value as `unknown` rather\r\n * than widening anything to `any`. No assertion appears anywhere in this file.\r\n *\r\n * Deliberately DUCK-TYPED rather than built on `axios.isAxiosError`. Three\r\n * reasons: this library must not take a hard axios dependency for a string\r\n * helper; a plain object shaped like an axios error (a hand-rolled reject, a\r\n * test double, a non-axios transport) still resolves correctly; and the check\r\n * stays valid across axios majors.\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n *   getApiErrorMessage(err)                          → backend message, or the default\r\n *   getApiErrorMessage(err, \"Échec de l'envoi.\")     → custom fallback\r\n *   getApiErrorStatus(err)                           → 404 | undefined\r\n *\r\n * Envelope keys read, in order: `data.body`, `data.message`, `data.error`.\r\n * Three keys because three PORTNET back-ends chose differently; see the\r\n * resolution-order note on `getApiErrorMessage` before adding a fourth.\r\n */\r\n\r\n/**\r\n * Default user-facing fallback. French per Charter §09 (voice, vouvoiement) and\r\n * §09.3 (no raw technical detail — never \"Erreur 422 Unprocessable Entity\").\r\n * Override per call site when a screen can say something more useful.\r\n */\r\nexport const DEFAULT_API_ERROR_MESSAGE =\r\n  \"Une erreur est survenue. Veuillez réessayer.\";\r\n\r\n/**\r\n * Walk `path` through nested non-null objects, returning the value at the end,\r\n * or `undefined` if any hop is missing. Assertion-free.\r\n */\r\nconst readPath = (source: unknown, path: readonly string[]): unknown => {\r\n  let current: unknown = source;\r\n\r\n  for (const key of path) {\r\n    if (typeof current !== \"object\" || current === null || !(key in current)) {\r\n      return undefined;\r\n    }\r\n    current = Reflect.get(current, key);\r\n  }\r\n\r\n  return current;\r\n};\r\n\r\nconst asNonEmptyString = (value: unknown): string | undefined =>\r\n  typeof value === \"string\" && value.length > 0 ? value : undefined;\r\n\r\n/**\r\n * Transport-layer phrasings that must NEVER reach a user — capability gap G-07.\r\n *\r\n * ──────────────────────────────────────────────────────────────────────\r\n * THE DEFECT THIS FIXES\r\n *\r\n * `getApiErrorMessage` resolved `error.message` BEFORE its fallback. An\r\n * `AxiosError` always has `.message`, so on any server error carrying no\r\n * `response.data.message` — a 500 with an empty body, a gateway error, a\r\n * timeout — step 3 won and the user was shown:\r\n *\r\n *     \"Request failed with status code 500\"\r\n *\r\n * English, technical, and precisely the shape Charter §09.3 names as forbidden\r\n * (\"✗ « Erreur 422 — Unprocessable Entity »\"). Worse, it made every consuming\r\n * module's carefully-written French fallback effectively UNREACHABLE — the\r\n * argument was accepted and then almost never used. Found during the\r\n * `procuration-portnet-fe` Area 10 audit, where 12 call sites pass a considered\r\n * fallback that could essentially never render.\r\n *\r\n * WHY A DENY-LIST AND NOT SIMPLY DROPPING STEP 3\r\n *\r\n * Step 3 also carries LEGITIMATE messages: any `throw new Error(\"Ce titre ne\r\n * peut pas être supprimé car il est en cours de validation.\")` in module code\r\n * arrives through exactly the same path. Removing the hop would trade a leak of\r\n * technical strings for the loss of real business messages across the whole\r\n * platform — a worse outcome. So the hop stays and only transport phrasings are\r\n * suppressed.\r\n *\r\n * The list is deliberately CONSERVATIVE: anything not recognised passes through,\r\n * on the assumption a human wrote it. A false negative shows one ugly string; a\r\n * false positive silently replaces a real business message with a generic\r\n * fallback, which is the more damaging error.\r\n *\r\n * Sourced from axios's own message construction (`settle`, `AxiosError` codes\r\n * ECONNABORTED / ETIMEDOUT / ERR_NETWORK / ERR_CANCELED) plus the Node socket\r\n * phrasing that surfaces through SSR and test doubles.\r\n * ──────────────────────────────────────────────────────────────────────\r\n */\r\nconst TRANSPORT_MESSAGE_PATTERNS: readonly RegExp[] = [\r\n  /^request failed with status code \\d+$/i,\r\n  /^network error$/i,\r\n  /^timeout of \\d+ms exceeded$/i,\r\n  /^timeout exceeded$/i,\r\n  /^request aborted$/i,\r\n  /^canceled$/i,\r\n  /^unsupported protocol/i,\r\n  /^maximum content size exceeded$/i,\r\n  /^socket hang up$/i,\r\n  /* ── errno codes and axios error codes ── CASE-SENSITIVE, DELIBERATELY ─────\r\n   *\r\n   * These two are the only patterns here NOT marked `/i`, and the asymmetry is\r\n   * load-bearing. errno constants are uppercase by universal convention\r\n   * (`ETIMEDOUT`, `ECONNREFUSED`, `ENOTFOUND`, `EPIPE`), so an uppercase-only\r\n   * match identifies them precisely. Matching case-insensitively would make\r\n   * `/^e[a-z]+$/i` swallow ordinary French words beginning with \"e\" — \"erreur\",\r\n   * \"expiré\", \"échec\" — turning a real business message into a generic fallback,\r\n   * which is the more damaging failure this list is tuned against.\r\n   *\r\n   * ⚠ An earlier version of the first pattern was `/^ec[a-z]+$/i`, which matched\r\n   * `ECONNREFUSED` (it begins \"EC\") but silently MISSED `ETIMEDOUT` (\"ET\"),\r\n   * despite the comment claiming otherwise. The unit test caught it. Do not\r\n   * narrow the prefix again: the family is \"E + uppercase word\", not \"EC...\".\r\n   *\r\n   * Residual, accepted: an all-caps single word like \"ERREUR\" is treated as an\r\n   * errno code. A module should not be throwing all-caps single-word messages at\r\n   * users, and replacing one with a proper French fallback is an improvement. */\r\n  /^E[A-Z]{3,}$/, // errno: ETIMEDOUT, ECONNREFUSED, ECONNRESET, ENOTFOUND, EPIPE\r\n  /^ERR_[A-Z_]+$/, // axios: ERR_NETWORK, ERR_CANCELED, ERR_BAD_RESPONSE\r\n];\r\n\r\n/** Is this string an axios/transport artefact rather than something for a user? */\r\nconst isTransportMessage = (value: string): boolean =>\r\n  TRANSPORT_MESSAGE_PATTERNS.some((pattern) => pattern.test(value.trim()));\r\n\r\n/**\r\n * `error.message`, but only when it is fit to show a user.\r\n *\r\n * Suppresses transport phrasings (G-07) so the caller's French fallback is\r\n * reached instead. Module-thrown `Error` messages pass through untouched.\r\n */\r\nconst asUserFacingMessage = (value: unknown): string | undefined => {\r\n  const text = asNonEmptyString(value);\r\n  if (text === undefined) return undefined;\r\n  return isTransportMessage(text) ? undefined : text;\r\n};\r\n\r\n/**\r\n * Best available human-readable message for a rejection of unknown shape.\r\n *\r\n * Resolution order, first match wins:\r\n *   1. the rejection itself, when it is a non-empty string;\r\n *   2. `error.response.data.body`    — the SAME envelope's third key;\r\n *   3. `error.response.data.message` — the backend's own message;\r\n *   4. `error.response.data.error`   — the SAME envelope's alternate key;\r\n *   5. `error.message` — **only when it is not a transport artefact** (G-07);\r\n *   6. `fallback`.\r\n *\r\n * Step 4 closes capability gap G-08. Several PORTNET back-ends populate\r\n * `data.error` rather than `data.message` (addpe-fe declares BOTH on its\r\n * `ApiErrorBody` and read both at seven call sites), so a helper that stopped at\r\n * `data.message` skipped a real business message and fell through to the generic\r\n * fallback — which made it non-substitutable for the module-local extractors it\r\n * exists to replace. Strictly additive: what step 4 now catches previously\r\n * reached step 5 or 6.\r\n *\r\n * Step 2 closes G-08bis — the same defect, a third key. `caution-ui`'s axios\r\n * interceptor reads `error.response.data.body ?? error.response.data.message`,\r\n * so on that back-end a helper stopping at `message` again skipped a real\r\n * business message. Without step 2 the helper was non-substitutable there and\r\n * the module would have had to keep its own assertion-based extractor.\r\n *\r\n * WHY STEP 2 SITS BEFORE `message` AND NOT AFTER `error`.\r\n * `caution-ui` uses `??`, which is direct evidence that a single response can\r\n * carry both keys and that `body` is the one that back-end means. Appending\r\n * `body` at the end of the envelope hops would therefore have SILENTLY FLIPPED\r\n * which message its users see. Placing it first preserves that precedence, and\r\n * is provably a no-op for every module that does not populate `body`: `readPath`\r\n * returns `undefined` and resolution falls straight through to `message`.\r\n *\r\n * The one case this perturbs is a back-end that populates BOTH `body` and\r\n * `message` while intending `message` to win. No such module exists in the\r\n * portfolio — addpe-fe's `ApiErrorBody` declares `message` and `error`, not\r\n * `body` — and a module in that position should say so here rather than have the\r\n * order guessed for it.\r\n *\r\n * Step 5 is filtered: `\"Request failed with status code 500\"`, `\"Network Error\"`,\r\n * timeouts and errno codes are SUPPRESSED so the caller's own French copy is\r\n * used instead (Charter §09.3 — no raw technical detail). A message a module\r\n * threw deliberately still passes through. Use `getApiErrorDetail` when you want\r\n * the unfiltered string for a log.\r\n *\r\n * Never throws and never returns an empty string, so it is safe to render\r\n * directly into a toast or a `Banner`.\r\n *\r\n * @param error    The caught value. `unknown` by design.\r\n * @param fallback Message when nothing usable is found.\r\n */\r\nexport function getApiErrorMessage(\r\n  error: unknown,\r\n  fallback: string = DEFAULT_API_ERROR_MESSAGE\r\n): string {\r\n  if (typeof error === \"string\" && error.length > 0) return error;\r\n\r\n  return (\r\n    asNonEmptyString(readPath(error, [\"response\", \"data\", \"body\"])) ??\r\n    asNonEmptyString(readPath(error, [\"response\", \"data\", \"message\"])) ??\r\n    asNonEmptyString(readPath(error, [\"response\", \"data\", \"error\"])) ??\r\n    asUserFacingMessage(readPath(error, [\"message\"])) ??\r\n    fallback\r\n  );\r\n}\r\n\r\n/**\r\n * Unfiltered technical detail for LOGGING — never for display.\r\n *\r\n * `getApiErrorMessage` deliberately suppresses transport phrasings (G-07), which\r\n * is right for a toast and wrong for a console or an APM breadcrumb, where\r\n * `\"Request failed with status code 502\"` is exactly what an operator needs. This\r\n * is the escape hatch: it returns the raw `error.message` when there is one,\r\n * whatever its shape.\r\n *\r\n * Pair them:\r\n *\r\n *     toast(getApiErrorMessage(err, \"Échec de l'envoi.\"), \"error\");\r\n *     console.error(\"[submit]\", getApiErrorStatus(err), getApiErrorDetail(err));\r\n */\r\nexport function getApiErrorDetail(error: unknown): string | undefined {\r\n  if (typeof error === \"string\" && error.length > 0) return error;\r\n  return asNonEmptyString(readPath(error, [\"message\"]));\r\n}\r\n\r\n/**\r\n * HTTP status carried by a rejection, when there is one.\r\n *\r\n * Resolution order, first numeric match wins:\r\n *   1. `error.response.data.status` — a BODY-level status;\r\n *   2. `error.response.status`       — the transport status.\r\n *\r\n * Returns `undefined` for a network drop, a timeout, or any non-HTTP rejection —\r\n * which is the signal callers use to distinguish \"the server answered with an\r\n * error\" from \"there was no answer at all\" (Charter R-4.3: a status-less failure\r\n * is a network banner, not a toast).\r\n *\r\n * Step 1 closes G-08ter, the status-side counterpart of the envelope-key gaps\r\n * G-08 / G-08bis. Several PORTNET back-ends put the meaningful status in the\r\n * BODY: caution-ui's axios interceptor reads\r\n * `error.response.data.status ?? error.response.status` and routes on the\r\n * result (404 -> not-found page, 500 -> server-error page, 401 -> re-login), and\r\n * its RESPONSE interceptor does the same for success handling. A helper reading\r\n * only the transport status was therefore not substitutable there — the module\r\n * had to keep a hand-written `HttpErrorLike` interface and assert onto it, which\r\n * is exactly the anti-pattern G-04 exists to end. Closing the message side\r\n * (G-08bis) without the status side would have left that assertion in place for\r\n * the sake of one field.\r\n *\r\n * Body-first ordering mirrors the module's own `??` and is provably a no-op for\r\n * every back-end that does not populate `data.status`: `readPath` returns\r\n * `undefined` and resolution falls through to the transport status.\r\n *\r\n * BOTH hops are numeric-guarded, which is a deliberate tightening over the\r\n * module code being replaced. That code did `String(status)` on whatever it\r\n * found, so a body carrying `status: \"ERROR\"` produced a `String` switch miss\r\n * and fell to the default toast branch; here a non-numeric `data.status` is\r\n * ignored and the real transport status is used instead. That is the more useful\r\n * answer, and it keeps the return type honest — the signature promises a number.\r\n */\r\nexport function getApiErrorStatus(error: unknown): number | undefined {\r\n  const bodyStatus = readPath(error, [\"response\", \"data\", \"status\"]);\r\n  if (typeof bodyStatus === \"number\") return bodyStatus;\r\n\r\n  const status = readPath(error, [\"response\", \"status\"]);\r\n  return typeof status === \"number\" ? status : undefined;\r\n}\r\n"],"mappings":"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","ignoreList":[]}

package/dist/v2/utils/index.d.ts

@@ -1,5 +1,6 @@
 export { cx } from "./cx";
 export { default as fmtMoney } from "./fmtMoney";
+export { mergeLabels } from "./mergeLabels";
 export { downloadBase64File, getMimeType, openBase64FileInTab, downloadBlobFile, } from "./fileDownload";
 export * as contrast from "./contrast";
 export { getApiErrorMessage, getApiErrorDetail, getApiErrorStatus, DEFAULT_API_ERROR_MESSAGE, } from "./apiError";

package/dist/v2/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAuB,MAAM,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMjD,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAavC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAuB,MAAM,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AASjD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAavC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/v2/utils/index.js

@@ -65,6 +65,12 @@ Object.defineProperty(exports, "getMimeType", {
     return _fileDownload.getMimeType;
   }
 });
+Object.defineProperty(exports, "mergeLabels", {
+  enumerable: true,
+  get: function get() {
+    return _mergeLabels.mergeLabels;
+  }
+});
 Object.defineProperty(exports, "networkStatus", {
   enumerable: true,
   get: function get() {
@@ -79,6 +85,7 @@ Object.defineProperty(exports, "openBase64FileInTab", {
 });
 var _cx = require("./cx");
 var _fmtMoney = _interopRequireDefault(require("./fmtMoney"));
+var _mergeLabels = require("./mergeLabels");
 var _fileDownload = require("./fileDownload");
 var _contrast = _interopRequireWildcard(require("./contrast"));
 exports.contrast = _contrast;

package/dist/v2/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["_cx","require","_fmtMoney","_interopRequireDefault","_fileDownload","_contrast","_interopRequireWildcard","exports","contrast","_apiError","_networkStatus","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","obj","__esModule","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set"],"sources":["../../../src/lib/v2/utils/index.ts"],"sourcesContent":["export { cx }                  from \"./cx\";\r\nexport { default as fmtMoney } from \"./fmtMoney\";\r\n\r\n// Base64 → browser download, plus the extension→MIME map it uses.\r\n// Flat named exports (not a namespace like contrast below): two\r\n// independent functions with no shared state, and downloadBase64File\r\n// is the common call site — qualifying it would only add noise.\r\nexport {\r\n  downloadBase64File,\r\n  getMimeType,\r\n  openBase64FileInTab,\r\n  downloadBlobFile,\r\n} from \"./fileDownload\";\r\n\r\n// WCAG 2.1 contrast utilities. Re-exported under a namespace at\r\n// the public barrel (v2.contrast.*) so the named API is grouped\r\n// and self-describing for callers — used to validate runtime\r\n// brand overrides against WCAG 1.4.3 and to audit dark-mode\r\n// token pairs (F29).\r\nexport * as contrast from \"./contrast\";\r\n\r\n// `unknown`-rejection narrowing. Mandated by the platform's own\r\n// `useUnknownInCatchVariables` flag, which makes `catch (e)` bind `unknown` in\r\n// every consuming saga while `any` and unsafe assertions stay forbidden — the\r\n// library previously left no sanctioned route between those two rules, and the\r\n// modules that filled the gap filled it with the forbidden construct.\r\n// Raised as capability gap G-04 (procuration-portnet-fe Area 5).\r\n//\r\n// `getApiErrorDetail` is the LOGGING counterpart added with G-07: since\r\n// `getApiErrorMessage` now suppresses axios transport phrasings so they cannot\r\n// reach a user (Charter §09.3), operators still need the unfiltered string for a\r\n// console or an APM breadcrumb. Display one, log the other.\r\nexport {\r\n  getApiErrorMessage,\r\n  getApiErrorDetail,\r\n  getApiErrorStatus,\r\n  DEFAULT_API_ERROR_MESSAGE,\r\n} from \"./apiError\";\r\n\r\n// The feed behind NetworkErrorBanner. The banner was exported without the\r\n// plumbing that decides when it shows, so every module rebuilt the same\r\n// subscribe/report/clear channel. Raised as capability gap G-03\r\n// (procuration-portnet-fe Area 5).\r\nexport { networkStatus, createNetworkStatus } from \"./networkStatus\";\r\nexport type { NetworkStatus, NetworkStatusListener } from \"./networkStatus\";\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,GAAA,GAAAC,OAAA;AACA,IAAAC,SAAA,GAAAC,sBAAA,CAAAF,OAAA;AAMA,IAAAG,aAAA,GAAAH,OAAA;AAKwB,IAAAI,SAAA,GAAAC,uBAAA,CAAAL,OAAA;AAAAM,OAAA,CAAAC,QAAA,GAAAH,SAAA;AAoBxB,IAAAI,SAAA,GAAAR,OAAA;AAWA,IAAAS,cAAA,GAAAT,OAAA;AAAqE,SAAAU,yBAAAC,WAAA,eAAAC,OAAA,kCAAAC,iBAAA,OAAAD,OAAA,QAAAE,gBAAA,OAAAF,OAAA,YAAAF,wBAAA,YAAAA,yBAAAC,WAAA,WAAAA,WAAA,GAAAG,gBAAA,GAAAD,iBAAA,KAAAF,WAAA;AAAA,SAAAN,wBAAAU,GAAA,EAAAJ,WAAA,SAAAA,WAAA,IAAAI,GAAA,IAAAA,GAAA,CAAAC,UAAA,WAAAD,GAAA,QAAAA,GAAA,aAAAE,OAAA,CAAAF,GAAA,yBAAAA,GAAA,uCAAAA,GAAA,UAAAG,KAAA,GAAAR,wBAAA,CAAAC,WAAA,OAAAO,KAAA,IAAAA,KAAA,CAAAC,GAAA,CAAAJ,GAAA,YAAAG,KAAA,CAAAE,GAAA,CAAAL,GAAA,SAAAM,MAAA,WAAAC,qBAAA,GAAAC,MAAA,CAAAC,cAAA,IAAAD,MAAA,CAAAE,wBAAA,WAAAC,GAAA,IAAAX,GAAA,QAAAW,GAAA,kBAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAd,GAAA,EAAAW,GAAA,SAAAI,IAAA,GAAAR,qBAAA,GAAAC,MAAA,CAAAE,wBAAA,CAAAV,GAAA,EAAAW,GAAA,cAAAI,IAAA,KAAAA,IAAA,CAAAV,GAAA,IAAAU,IAAA,CAAAC,GAAA,KAAAR,MAAA,CAAAC,cAAA,CAAAH,MAAA,EAAAK,GAAA,EAAAI,IAAA,YAAAT,MAAA,CAAAK,GAAA,IAAAX,GAAA,CAAAW,GAAA,SAAAL,MAAA,cAAAN,GAAA,MAAAG,KAAA,IAAAA,KAAA,CAAAa,GAAA,CAAAhB,GAAA,EAAAM,MAAA,YAAAA,MAAA;AAAA,SAAAnB,uBAAAa,GAAA,WAAAA,GAAA,IAAAA,GAAA,CAAAC,UAAA,GAAAD,GAAA,gBAAAA,GAAA","ignoreList":[]}
+{"version":3,"file":"index.js","names":["_cx","require","_fmtMoney","_interopRequireDefault","_mergeLabels","_fileDownload","_contrast","_interopRequireWildcard","exports","contrast","_apiError","_networkStatus","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","obj","__esModule","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set"],"sources":["../../../src/lib/v2/utils/index.ts"],"sourcesContent":["export { cx }                  from \"./cx\";\r\nexport { default as fmtMoney } from \"./fmtMoney\";\r\n\r\n// Undefined-safe label merge. Every localisable component used to write\r\n// `labels ? { ...DEFAULTS, ...labels } : DEFAULTS`, and a spread does NOT skip\r\n// explicit `undefined` — so an override of `undefined` DELETED the default and\r\n// the component threw `L.x is not a function` at render. Eleven components\r\n// shipped that hazard; the `?: T` declarations hid it from the compiler by\r\n// asserting the merged value could never be undefined, which was false at\r\n// runtime. Surfaced by the G-14 widening. Latent runtime defect, not cosmetics.\r\nexport { mergeLabels } from \"./mergeLabels\";\r\n\r\n// Base64 → browser download, plus the extension→MIME map it uses.\r\n// Flat named exports (not a namespace like contrast below): two\r\n// independent functions with no shared state, and downloadBase64File\r\n// is the common call site — qualifying it would only add noise.\r\nexport {\r\n  downloadBase64File,\r\n  getMimeType,\r\n  openBase64FileInTab,\r\n  downloadBlobFile,\r\n} from \"./fileDownload\";\r\n\r\n// WCAG 2.1 contrast utilities. Re-exported under a namespace at\r\n// the public barrel (v2.contrast.*) so the named API is grouped\r\n// and self-describing for callers — used to validate runtime\r\n// brand overrides against WCAG 1.4.3 and to audit dark-mode\r\n// token pairs (F29).\r\nexport * as contrast from \"./contrast\";\r\n\r\n// `unknown`-rejection narrowing. Mandated by the platform's own\r\n// `useUnknownInCatchVariables` flag, which makes `catch (e)` bind `unknown` in\r\n// every consuming saga while `any` and unsafe assertions stay forbidden — the\r\n// library previously left no sanctioned route between those two rules, and the\r\n// modules that filled the gap filled it with the forbidden construct.\r\n// Raised as capability gap G-04 (procuration-portnet-fe Area 5).\r\n//\r\n// `getApiErrorDetail` is the LOGGING counterpart added with G-07: since\r\n// `getApiErrorMessage` now suppresses axios transport phrasings so they cannot\r\n// reach a user (Charter §09.3), operators still need the unfiltered string for a\r\n// console or an APM breadcrumb. Display one, log the other.\r\nexport {\r\n  getApiErrorMessage,\r\n  getApiErrorDetail,\r\n  getApiErrorStatus,\r\n  DEFAULT_API_ERROR_MESSAGE,\r\n} from \"./apiError\";\r\n\r\n// The feed behind NetworkErrorBanner. The banner was exported without the\r\n// plumbing that decides when it shows, so every module rebuilt the same\r\n// subscribe/report/clear channel. Raised as capability gap G-03\r\n// (procuration-portnet-fe Area 5).\r\nexport { networkStatus, createNetworkStatus } from \"./networkStatus\";\r\nexport type { NetworkStatus, NetworkStatusListener } from \"./networkStatus\";\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,GAAA,GAAAC,OAAA;AACA,IAAAC,SAAA,GAAAC,sBAAA,CAAAF,OAAA;AASA,IAAAG,YAAA,GAAAH,OAAA;AAMA,IAAAI,aAAA,GAAAJ,OAAA;AAKwB,IAAAK,SAAA,GAAAC,uBAAA,CAAAN,OAAA;AAAAO,OAAA,CAAAC,QAAA,GAAAH,SAAA;AAoBxB,IAAAI,SAAA,GAAAT,OAAA;AAWA,IAAAU,cAAA,GAAAV,OAAA;AAAqE,SAAAW,yBAAAC,WAAA,eAAAC,OAAA,kCAAAC,iBAAA,OAAAD,OAAA,QAAAE,gBAAA,OAAAF,OAAA,YAAAF,wBAAA,YAAAA,yBAAAC,WAAA,WAAAA,WAAA,GAAAG,gBAAA,GAAAD,iBAAA,KAAAF,WAAA;AAAA,SAAAN,wBAAAU,GAAA,EAAAJ,WAAA,SAAAA,WAAA,IAAAI,GAAA,IAAAA,GAAA,CAAAC,UAAA,WAAAD,GAAA,QAAAA,GAAA,aAAAE,OAAA,CAAAF,GAAA,yBAAAA,GAAA,uCAAAA,GAAA,UAAAG,KAAA,GAAAR,wBAAA,CAAAC,WAAA,OAAAO,KAAA,IAAAA,KAAA,CAAAC,GAAA,CAAAJ,GAAA,YAAAG,KAAA,CAAAE,GAAA,CAAAL,GAAA,SAAAM,MAAA,WAAAC,qBAAA,GAAAC,MAAA,CAAAC,cAAA,IAAAD,MAAA,CAAAE,wBAAA,WAAAC,GAAA,IAAAX,GAAA,QAAAW,GAAA,kBAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAd,GAAA,EAAAW,GAAA,SAAAI,IAAA,GAAAR,qBAAA,GAAAC,MAAA,CAAAE,wBAAA,CAAAV,GAAA,EAAAW,GAAA,cAAAI,IAAA,KAAAA,IAAA,CAAAV,GAAA,IAAAU,IAAA,CAAAC,GAAA,KAAAR,MAAA,CAAAC,cAAA,CAAAH,MAAA,EAAAK,GAAA,EAAAI,IAAA,YAAAT,MAAA,CAAAK,GAAA,IAAAX,GAAA,CAAAW,GAAA,SAAAL,MAAA,cAAAN,GAAA,MAAAG,KAAA,IAAAA,KAAA,CAAAa,GAAA,CAAAhB,GAAA,EAAAM,MAAA,YAAAA,MAAA;AAAA,SAAApB,uBAAAc,GAAA,WAAAA,GAAA,IAAAA,GAAA,CAAAC,UAAA,GAAAD,GAAA,gBAAAA,GAAA","ignoreList":[]}