@hmcts/opal-frontend-common 0.0.87 → 0.0.89

package/fesm2022/{hmcts-opal-frontend-common-internal-server-error.component-BiZRHHHQ.mjs → hmcts-opal-frontend-common-internal-server-error.component-Cj-ueGWj.mjs}

@@ -1,16 +1,18 @@
 import * as i0 from '@angular/core';
 import { inject, computed, ChangeDetectionStrategy, Component } from '@angular/core';
 import { Location } from '@angular/common';
-import { Router } from '@angular/router';
+import { ActivatedRoute, Router } from '@angular/router';
 
 class InternalServerErrorComponent {
+    activatedRoute = inject(ActivatedRoute);
     router = inject(Router);
     location = inject(Location);
     operationIdDisplay = computed(() => {
+        const queryParamOperationId = this.activatedRoute.snapshot.queryParamMap.get('operationId');
         const navigationState = this.router.currentNavigation()?.extras?.state;
         const persistedState = this.location.getState();
-        const operationId = navigationState?.operationId ?? persistedState?.operationId;
-        return operationId && operationId.trim().length > 0 ? operationId : 'Unavailable';
+        const operationId = [queryParamOperationId, navigationState?.operationId, persistedState?.operationId].find((id) => id?.trim());
+        return operationId?.trim() ?? 'Unavailable';
     }, ...(ngDevMode ? [{ debugName: "operationIdDisplay" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: InternalServerErrorComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
     static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.17", type: InternalServerErrorComponent, isStandalone: true, selector: "opal-lib-internal-server-error", ngImport: i0, template: "<div class=\"govuk-grid-column-two-thirds\">\n  <h1 class=\"govuk-heading-l\">Sorry, there is a problem with the service</h1>\n  <p class=\"govuk-body\" data-testid=\"error-code\">Error code: {{ operationIdDisplay() }}.</p>\n</div>\n", changeDetection: i0.ChangeDetectionStrategy.OnPush });
@@ -21,4 +23,4 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
         }] });
 
 export { InternalServerErrorComponent };
-//# sourceMappingURL=hmcts-opal-frontend-common-internal-server-error.component-BiZRHHHQ.mjs.map
+//# sourceMappingURL=hmcts-opal-frontend-common-internal-server-error.component-Cj-ueGWj.mjs.map

package/fesm2022/{hmcts-opal-frontend-common-pages-internal-server-error.component-BiZRHHHQ.mjs → hmcts-opal-frontend-common-pages-internal-server-error.component-Cj-ueGWj.mjs}

@@ -1,16 +1,18 @@
 import * as i0 from '@angular/core';
 import { inject, computed, ChangeDetectionStrategy, Component } from '@angular/core';
 import { Location } from '@angular/common';
-import { Router } from '@angular/router';
+import { ActivatedRoute, Router } from '@angular/router';
 
 class InternalServerErrorComponent {
+    activatedRoute = inject(ActivatedRoute);
     router = inject(Router);
     location = inject(Location);
     operationIdDisplay = computed(() => {
+        const queryParamOperationId = this.activatedRoute.snapshot.queryParamMap.get('operationId');
         const navigationState = this.router.currentNavigation()?.extras?.state;
         const persistedState = this.location.getState();
-        const operationId = navigationState?.operationId ?? persistedState?.operationId;
-        return operationId && operationId.trim().length > 0 ? operationId : 'Unavailable';
+        const operationId = [queryParamOperationId, navigationState?.operationId, persistedState?.operationId].find((id) => id?.trim());
+        return operationId?.trim() ?? 'Unavailable';
     }, ...(ngDevMode ? [{ debugName: "operationIdDisplay" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: InternalServerErrorComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
     static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.17", type: InternalServerErrorComponent, isStandalone: true, selector: "opal-lib-internal-server-error", ngImport: i0, template: "<div class=\"govuk-grid-column-two-thirds\">\n  <h1 class=\"govuk-heading-l\">Sorry, there is a problem with the service</h1>\n  <p class=\"govuk-body\" data-testid=\"error-code\">Error code: {{ operationIdDisplay() }}.</p>\n</div>\n", changeDetection: i0.ChangeDetectionStrategy.OnPush });
@@ -21,4 +23,4 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
         }] });
 
 export { InternalServerErrorComponent };
-//# sourceMappingURL=hmcts-opal-frontend-common-pages-internal-server-error.component-BiZRHHHQ.mjs.map
+//# sourceMappingURL=hmcts-opal-frontend-common-pages-internal-server-error.component-Cj-ueGWj.mjs.map

package/fesm2022/hmcts-opal-frontend-common-pages.mjs

@@ -27,7 +27,7 @@ const routing = [
     },
     {
         path: PAGES_ROUTING_PATHS.children.internalServerError,
-        loadComponent: () => import('./hmcts-opal-frontend-common-pages-internal-server-error.component-BiZRHHHQ.mjs').then((c) => c.InternalServerErrorComponent),
+        loadComponent: () => import('./hmcts-opal-frontend-common-pages-internal-server-error.component-Cj-ueGWj.mjs').then((c) => c.InternalServerErrorComponent),
         data: { title: PAGES_ROUTING_TITLES.children.internalServerError },
         resolve: { title: TitleResolver },
     },

package/fesm2022/hmcts-opal-frontend-common-services-history-transformation-service.mjs

@@ -321,9 +321,205 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
                 }]
         }] });
 
+const HISTORY_MAPPING_DATE_SERVICE = new DateService();
+const HISTORY_MAPPING_DEFAULT_FIELD_PATH_SEPARATOR = '.';
+const HISTORY_MAPPING_DEFAULT_NUMBER_OPTIONS = {
+    fieldPathSeparator: null,
+    numberSanitisePattern: null,
+};
+/**
+ * Checks whether a value can be mapped as a raw history item.
+ *
+ * @param value - The value to check.
+ * @returns True when the value is an object record.
+ */
+function isHistoryMappingItem(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * Finds the first supported history item collection and filters it to mappable object items.
+ *
+ * @param source - The source object containing a history item collection.
+ * @param keys - Candidate history item collection keys in priority order.
+ * @returns The matched collection entry, or null when no array is present.
+ */
+function getHistoryMappingItemsEntry(source, keys) {
+    for (const key of keys) {
+        const historyItems = source[key];
+        if (Array.isArray(historyItems)) {
+            return {
+                key,
+                items: historyItems.filter(isHistoryMappingItem),
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Maps the first supported history item collection into consumer-owned row objects.
+ *
+ * @param source - The source object containing a history item collection.
+ * @param keys - Candidate history item collection keys in priority order.
+ * @param mapItemToRow - Row mapper owned by the consuming flow.
+ * @returns Mapped rows.
+ */
+function getHistoryMappingRows(source, keys, mapItemToRow) {
+    return (getHistoryMappingItemsEntry(source, keys)?.items ?? []).map((item, index) => mapItemToRow(item, index));
+}
+/**
+ * Gets a value from a history item using a field path.
+ *
+ * @param source - The source history item.
+ * @param path - The field path.
+ * @param fieldPathSeparator - The path segment separator.
+ * @returns The matched field value.
+ */
+function getHistoryMappingValue(source, path, fieldPathSeparator = HISTORY_MAPPING_DEFAULT_FIELD_PATH_SEPARATOR) {
+    return path.split(fieldPathSeparator).reduce((current, key) => {
+        if (typeof current !== 'object' || current === null) {
+            return undefined;
+        }
+        return current[key];
+    }, source);
+}
+/**
+ * Gets the first present string or number from the supplied history item paths.
+ *
+ * @param item - The source history item.
+ * @param paths - The field paths to inspect.
+ * @param fieldPathSeparator - The path segment separator.
+ * @returns The first present string value.
+ */
+function getHistoryMappingString(item, paths, fieldPathSeparator = HISTORY_MAPPING_DEFAULT_FIELD_PATH_SEPARATOR) {
+    for (const path of paths) {
+        const value = getHistoryMappingValue(item, path, fieldPathSeparator);
+        if (typeof value === 'string' && value.trim()) {
+            return value;
+        }
+        if (typeof value === 'number') {
+            return String(value);
+        }
+    }
+    return null;
+}
+/**
+ * Gets the first finite number from the supplied history item paths.
+ *
+ * @param item - The source history item.
+ * @param paths - The field paths to inspect.
+ * @param options - Number mapping options.
+ * @returns The first finite number value.
+ */
+function getHistoryMappingNumber(item, paths, options = HISTORY_MAPPING_DEFAULT_NUMBER_OPTIONS) {
+    const fieldPathSeparator = options.fieldPathSeparator ?? HISTORY_MAPPING_DEFAULT_FIELD_PATH_SEPARATOR;
+    for (const path of paths) {
+        const value = getHistoryMappingValue(item, path, fieldPathSeparator);
+        if (typeof value === 'number' && Number.isFinite(value)) {
+            return value;
+        }
+        if (typeof value === 'string') {
+            const sanitisedValue = options.numberSanitisePattern ? value.replace(options.numberSanitisePattern, '') : value;
+            const trimmedValue = sanitisedValue.trim();
+            if (!trimmedValue) {
+                continue;
+            }
+            const parsed = Number(trimmedValue);
+            if (Number.isFinite(parsed)) {
+                return parsed;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Parses supported history date values to sortable UTC timestamps.
+ *
+ * @param value - The raw date value.
+ * @param dateFormat - The configured input date format.
+ * @returns The UTC timestamp in milliseconds, or null when parsing fails.
+ */
+function parseHistoryDateTimestamp(value, dateFormat) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value !== 'string' || !value.trim()) {
+        return null;
+    }
+    const trimmedValue = value.trim();
+    const parsedFormattedDate = HISTORY_MAPPING_DATE_SERVICE.getFromFormat(trimmedValue, dateFormat.input);
+    if (HISTORY_MAPPING_DATE_SERVICE.isValidDate(parsedFormattedDate)) {
+        return Date.UTC(parsedFormattedDate.year, parsedFormattedDate.month - 1, parsedFormattedDate.day);
+    }
+    const isoDate = HISTORY_MAPPING_DATE_SERVICE.getFromIso(trimmedValue);
+    if (!HISTORY_MAPPING_DATE_SERVICE.isValidDate(isoDate)) {
+        return null;
+    }
+    return trimmedValue.length === 10 ? Date.UTC(isoDate.year, isoDate.month - 1, isoDate.day) : isoDate.toMillis();
+}
+/**
+ * Gets the first parseable date timestamp from the supplied history item paths.
+ *
+ * @param item - The source history item.
+ * @param paths - The field paths to inspect.
+ * @param dateFormat - The configured input date format.
+ * @param fieldPathSeparator - The path segment separator.
+ * @returns The first parseable UTC timestamp in milliseconds.
+ */
+function getHistoryMappingDateTimestamp(item, paths, dateFormat, fieldPathSeparator = HISTORY_MAPPING_DEFAULT_FIELD_PATH_SEPARATOR) {
+    for (const path of paths) {
+        const timestamp = parseHistoryDateTimestamp(getHistoryMappingValue(item, path, fieldPathSeparator), dateFormat);
+        if (timestamp !== null) {
+            return timestamp;
+        }
+    }
+    return null;
+}
+/**
+ * Gets the rendered prefix for a history details fragment.
+ *
+ * @param fragment - The details fragment.
+ * @param index - The fragment index in its part.
+ * @param options - Prefix display options.
+ * @returns The rendered prefix.
+ */
+function getHistoryMappingFragmentPrefix(fragment, index, options) {
+    if (fragment.hyphen) {
+        return options.hyphenPrefix;
+    }
+    return index > 0 ? options.fragmentSpacePrefix : (options.fragmentEmptyPrefix ?? '');
+}
+/**
+ * Converts transformed history details into plain text for table sorting.
+ *
+ * @param details - The transformed details model.
+ * @param options - Details text display options.
+ * @returns Details text.
+ */
+function getHistoryMappingDetailsText(details, options) {
+    return [getHistoryMappingPartsText(details.line1, options), getHistoryMappingPartsText(details.line2 ?? [], options)]
+        .filter(Boolean)
+        .join(options.detailsLineSeparator);
+}
+/**
+ * Converts transformed history details parts into plain text for table sorting.
+ *
+ * @param parts - The transformed details parts.
+ * @param options - Details text display options.
+ * @returns Details parts text.
+ */
+function getHistoryMappingPartsText(parts, options) {
+    return parts
+        .map((part) => part.fragments
+        .map((fragment, index) => `${getHistoryMappingFragmentPrefix(fragment, index, options)}${fragment.text}`)
+        .join(options.fragmentJoiner ?? '')
+        .trim())
+        .filter(Boolean)
+        .join(options.partSeparator);
+}
+
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { HISTORY_DETAILS_PATTERNS, HistoryTransformationService, createHistoryDetails, createHistoryDetailsPart, createHistoryFragment, createHistoryLabelValuePart, createHistoryLink, createHistoryTextPart, formatHistoryDate, formatHistoryMoney, getHistoryAliasPaths, getHistoryString, getHistoryValue, getHistoryValueByPath, isHistoryEmptyValue, isHistoryPresentString, isHistoryRecord, normaliseHistoryKey, normaliseHistoryTransactionType, toHistorySnakeCase, transformHistoryDetails, transformHistoryFallbackDetails, transformHistoryItems };
+export { HISTORY_DETAILS_PATTERNS, HistoryTransformationService, createHistoryDetails, createHistoryDetailsPart, createHistoryFragment, createHistoryLabelValuePart, createHistoryLink, createHistoryTextPart, formatHistoryDate, formatHistoryMoney, getHistoryAliasPaths, getHistoryMappingDateTimestamp, getHistoryMappingDetailsText, getHistoryMappingFragmentPrefix, getHistoryMappingItemsEntry, getHistoryMappingNumber, getHistoryMappingPartsText, getHistoryMappingRows, getHistoryMappingString, getHistoryMappingValue, getHistoryString, getHistoryValue, getHistoryValueByPath, isHistoryEmptyValue, isHistoryMappingItem, isHistoryPresentString, isHistoryRecord, normaliseHistoryKey, normaliseHistoryTransactionType, parseHistoryDateTimestamp, toHistorySnakeCase, transformHistoryDetails, transformHistoryFallbackDetails, transformHistoryItems };
 //# sourceMappingURL=hmcts-opal-frontend-common-services-history-transformation-service.mjs.map

package/fesm2022/hmcts-opal-frontend-common.mjs

@@ -54,7 +54,7 @@ const routing = [
     },
     {
         path: PAGES_ROUTING_PATHS.children.internalServerError,
-        loadComponent: () => import('./hmcts-opal-frontend-common-internal-server-error.component-BiZRHHHQ.mjs').then((c) => c.InternalServerErrorComponent),
+        loadComponent: () => import('./hmcts-opal-frontend-common-internal-server-error.component-Cj-ueGWj.mjs').then((c) => c.InternalServerErrorComponent),
         data: { title: PAGES_ROUTING_TITLES.children.internalServerError },
         resolve: { title: TitleResolver },
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmcts/opal-frontend-common",
-  "version": "0.0.87",
+  "version": "0.0.89",
   "license": "MIT",
   "repository": {
     "type": "git",

package/types/hmcts-opal-frontend-common-services-date-service.d.ts

@@ -71,7 +71,7 @@ declare class DateService {
      * @param format - The format string to apply to the DateTime value.
      * @returns The formatted string representation of the DateTime value.
      */
-    toFormat(value: DateTime<true> | DateTime<false>, format: string): string;
+    toFormat(value: DateTime, format: string): string;
     /**
      * Converts a given Date object to a formatted string based on the specified format.
      *

package/types/hmcts-opal-frontend-common-services-history-transformation-service.d.ts

@@ -77,6 +77,123 @@ interface IHistoryFragmentOptions {
     link?: IHistoryDetailsLink | null;
 }
 
+interface IHistoryMappingFragmentPrefixOptions {
+    fragmentEmptyPrefix: string | null;
+    fragmentSpacePrefix: string;
+    hyphenPrefix: string;
+}
+
+interface IHistoryMappingDetailsTextOptions extends IHistoryMappingFragmentPrefixOptions {
+    detailsLineSeparator: string;
+    fragmentJoiner: string | null;
+    partSeparator: string;
+}
+
+interface IHistoryMappingItemsEntry {
+    key: string;
+    items: THistoryDetailsRawItem[];
+}
+
+interface IHistoryMappingNumberOptions {
+    fieldPathSeparator: string | null;
+    numberSanitisePattern: RegExp | null;
+}
+
+/**
+ * Checks whether a value can be mapped as a raw history item.
+ *
+ * @param value - The value to check.
+ * @returns True when the value is an object record.
+ */
+declare function isHistoryMappingItem(value: unknown): value is THistoryDetailsRawItem;
+/**
+ * Finds the first supported history item collection and filters it to mappable object items.
+ *
+ * @param source - The source object containing a history item collection.
+ * @param keys - Candidate history item collection keys in priority order.
+ * @returns The matched collection entry, or null when no array is present.
+ */
+declare function getHistoryMappingItemsEntry(source: Record<string, unknown>, keys: readonly string[]): IHistoryMappingItemsEntry | null;
+/**
+ * Maps the first supported history item collection into consumer-owned row objects.
+ *
+ * @param source - The source object containing a history item collection.
+ * @param keys - Candidate history item collection keys in priority order.
+ * @param mapItemToRow - Row mapper owned by the consuming flow.
+ * @returns Mapped rows.
+ */
+declare function getHistoryMappingRows<TRow>(source: Record<string, unknown>, keys: readonly string[], mapItemToRow: (item: THistoryDetailsRawItem, index: number) => TRow): TRow[];
+/**
+ * Gets a value from a history item using a field path.
+ *
+ * @param source - The source history item.
+ * @param path - The field path.
+ * @param fieldPathSeparator - The path segment separator.
+ * @returns The matched field value.
+ */
+declare function getHistoryMappingValue(source: THistoryDetailsRawItem, path: string, fieldPathSeparator?: string): unknown;
+/**
+ * Gets the first present string or number from the supplied history item paths.
+ *
+ * @param item - The source history item.
+ * @param paths - The field paths to inspect.
+ * @param fieldPathSeparator - The path segment separator.
+ * @returns The first present string value.
+ */
+declare function getHistoryMappingString(item: THistoryDetailsRawItem, paths: readonly string[], fieldPathSeparator?: string): string | null;
+/**
+ * Gets the first finite number from the supplied history item paths.
+ *
+ * @param item - The source history item.
+ * @param paths - The field paths to inspect.
+ * @param options - Number mapping options.
+ * @returns The first finite number value.
+ */
+declare function getHistoryMappingNumber(item: THistoryDetailsRawItem, paths: readonly string[], options?: IHistoryMappingNumberOptions): number | null;
+/**
+ * Parses supported history date values to sortable UTC timestamps.
+ *
+ * @param value - The raw date value.
+ * @param dateFormat - The configured input date format.
+ * @returns The UTC timestamp in milliseconds, or null when parsing fails.
+ */
+declare function parseHistoryDateTimestamp(value: unknown, dateFormat: IHistoryDetailsDateFormat): number | null;
+/**
+ * Gets the first parseable date timestamp from the supplied history item paths.
+ *
+ * @param item - The source history item.
+ * @param paths - The field paths to inspect.
+ * @param dateFormat - The configured input date format.
+ * @param fieldPathSeparator - The path segment separator.
+ * @returns The first parseable UTC timestamp in milliseconds.
+ */
+declare function getHistoryMappingDateTimestamp(item: THistoryDetailsRawItem, paths: readonly string[], dateFormat: IHistoryDetailsDateFormat, fieldPathSeparator?: string): number | null;
+/**
+ * Gets the rendered prefix for a history details fragment.
+ *
+ * @param fragment - The details fragment.
+ * @param index - The fragment index in its part.
+ * @param options - Prefix display options.
+ * @returns The rendered prefix.
+ */
+declare function getHistoryMappingFragmentPrefix(fragment: Pick<IHistoryDetailsFragment, 'hyphen'>, index: number, options: IHistoryMappingFragmentPrefixOptions): string;
+/**
+ * Converts transformed history details into plain text for table sorting.
+ *
+ * @param details - The transformed details model.
+ * @param options - Details text display options.
+ * @returns Details text.
+ */
+declare function getHistoryMappingDetailsText(details: IHistoryDetails, options: IHistoryMappingDetailsTextOptions): string;
+/**
+ * Converts transformed history details parts into plain text for table sorting.
+ *
+ * @param parts - The transformed details parts.
+ * @param options - Details text display options.
+ * @returns Details parts text.
+ */
+declare function getHistoryMappingPartsText(parts: IHistoryDetailsPart[], options: IHistoryMappingDetailsTextOptions): string;
+
 /**
  * Transforms a raw history item into the configured structured details model.
  *
@@ -246,5 +363,5 @@ declare function formatHistoryDate(value: string | null, dateFormat: IHistoryDet
  */
 declare function formatHistoryMoney(value: unknown, currencyPrefix: string, emptyValues: readonly unknown[]): string | null;
 
-export { HISTORY_DETAILS_PATTERNS, HistoryTransformationService, createHistoryDetails, createHistoryDetailsPart, createHistoryFragment, createHistoryLabelValuePart, createHistoryLink, createHistoryTextPart, formatHistoryDate, formatHistoryMoney, getHistoryAliasPaths, getHistoryString, getHistoryValue, getHistoryValueByPath, isHistoryEmptyValue, isHistoryPresentString, isHistoryRecord, normaliseHistoryKey, normaliseHistoryTransactionType, toHistorySnakeCase, transformHistoryDetails, transformHistoryFallbackDetails, transformHistoryItems };
-export type { IHistoryDetails, IHistoryDetailsDateFormat, IHistoryDetailsFragment, IHistoryDetailsLink, IHistoryDetailsPart, IHistoryFragmentOptions, IHistoryTransformationConfig, THistoryDetailsRawItem, THistoryDetailsTransformer, THistoryDetailsTransformerConfig };
+export { HISTORY_DETAILS_PATTERNS, HistoryTransformationService, createHistoryDetails, createHistoryDetailsPart, createHistoryFragment, createHistoryLabelValuePart, createHistoryLink, createHistoryTextPart, formatHistoryDate, formatHistoryMoney, getHistoryAliasPaths, getHistoryMappingDateTimestamp, getHistoryMappingDetailsText, getHistoryMappingFragmentPrefix, getHistoryMappingItemsEntry, getHistoryMappingNumber, getHistoryMappingPartsText, getHistoryMappingRows, getHistoryMappingString, getHistoryMappingValue, getHistoryString, getHistoryValue, getHistoryValueByPath, isHistoryEmptyValue, isHistoryMappingItem, isHistoryPresentString, isHistoryRecord, normaliseHistoryKey, normaliseHistoryTransactionType, parseHistoryDateTimestamp, toHistorySnakeCase, transformHistoryDetails, transformHistoryFallbackDetails, transformHistoryItems };
+export type { IHistoryDetails, IHistoryDetailsDateFormat, IHistoryDetailsFragment, IHistoryDetailsLink, IHistoryDetailsPart, IHistoryFragmentOptions, IHistoryMappingDetailsTextOptions, IHistoryMappingFragmentPrefixOptions, IHistoryMappingItemsEntry, IHistoryMappingNumberOptions, IHistoryTransformationConfig, THistoryDetailsRawItem, THistoryDetailsTransformer, THistoryDetailsTransformerConfig };