Decorator (Annotation @DatabaseField()) to mark a property of an Entity that should be persisted in the database.

also see

Returns the schema map of this entity (not the superclass). Creates and assigns a new one if it doesn't exist yet.

Comparing two values for equality that might be different than just object equality

Group an array by the given property.

an array where the first entry is the value of this group and the second all entries that have this value.

Read the contents of a Blob into an ArrayBuffer. Use this for binary formats (e.g. xlsx) where reading as text would corrupt the payload.

This is a simple shorthand function to create factories for services. The use case is, when multiple services extend the same class and one of these services will be provided.

Apply all config migrations to a plain JSON document. Returns the migrated document as a plain object (no Angular entity re-hydration). Used by the admin CLI; ConfigService wraps this and also applies defaultConfigs.

If the user previously opted into online-only mode, override session_type early so that database instances are created with the correct type from the start.

This MUST run before Angular bootstraps, because DatabaseFactoryService reads environment.session_type the first time a database is lazily accessed (during Angular DI startup, before LoginComponent even exists). If we waited until LoginComponent ran, the wrong DB class would already have been instantiated.

The flow is:

1. User toggles checkbox on login page → LoginComponent writes localStorage
2. Keycloak login triggers a full page reload (redirectUri: location.href)
3. On reload, this function runs and applies the preference to environment
4. Angular DI starts → correct DB class (RemotePouchDatabase) is created

See also: LoginComponent.applyOnlineOnlyMode() and ONLINE_ONLY_KEY.

Force online-only mode when bootstrapping a public-form route, so the database factory creates a RemotePouchDatabase from the first lazy access rather than a SyncedPouchDatabase that would never be initialized.

Load basic config values from assets/keycloak.json into environment

Overwrite environment settings with the settings from the config.json if present. If no file is found, the environment settings are kept.

Load Push Notifications config for Firebase. Please add assets/firebase-config.json with your own Firebase config

Load Keycloak server URL from assets/keycloak.json into environment

Applies a contiguous shift-selection update over a row index range.

Detects whether the click originated from a checkbox input.

Detects whether the click target is inside an element marked as .clickable.

Determines whether row-click handling should be skipped for this interaction.

Adds or removes a single record from the selected records collection.

Computes the next selection state for a row mousedown, including shift-range behavior.

Applies sorting rules to columns: disables sorting for entity references, untyped columns, and arrays (unless the datatype provides custom sort logic).

Infers a stable default sort from visible sortable columns. Date-like columns default to descending order.

Resolve the source field for virtual DisplayAge columns.

These columns display an age from another field, e.g. age reads record.dateOfBirth.age, so datatype sorting cannot use the column value directly. The legacy age and age_<field> conventions remain supported for existing configs.

Update the given entity by applying the text entered by a user to the most likely appropriate entity field, inferred from the toString representation.

Updates a list of entities given an updated version of the entity. This updated version can either be a new entity (that should be inserted into the list), or an existing entity that should be updated or deleted. The given array will not be mutated but will be returned when the given new entity or type is illegal

An array of the given entities with the update applied

Convert wrap a value in an array if it is not already an array.

Build export column resolvers for all fields in a schema.

Iterates the schema, looks up each field's datatype, and collects the columns the datatype contributes via getExportColumns.

Create a MatchingSideConfig object and fill it with columns from comparison array if necessary

Validator to ensure a field becomes readonly after it has been saved once.

Wraps Vitest lifecycle and test callbacks in Angular's ProxyZone when it is available.

Angular test utilities such as waitForAsync() and fakeAsync() still rely on Zone context even when the test runner is Vitest. This patch keeps those helpers working without rewriting every existing spec immediately.

Helper function to remove custom schema fields from Entity that have been created using getDefaultInheritedForm().

Helper function to add some custom schema fields to Entity for testing. Use in combination with a call to cleanUpTemporarySchemaFields() in afterEach.

Close the mat-menu of the given menu trigger and stop propagation of the event to avoid closing parent menus as well.

Compare dates at day precision

Handles special cases like ConfigurableEnum objects and Dates. Used for filter evaluation and conditional color matching.

This utility is kept separate to avoid circular dependencies between Entity and FilterService.

-1 if a < b, 0 if a === b, 1 if a > b

Custom sort implementation for a MatTableDataSource<TableRow>

the sorted table rows

Compute new-format database names (using Keycloak UUID + dash separator). Used after migration to the "indexeddb" adapter.

Compute legacy-format database names (username for app, underscore for notifications). Used with the old "idb" adapter before migration.

Converts an Angular DatePipe format string to the equivalent Moment.js format string. Angular uses lowercase tokens (dd, yyyy), Moment.js uses uppercase (DD, YYYY). Exported for testing only.

Set the global date format at runtime based on configuration. This is called by SiteSettingsService during initialization.

Creates an age range validator (min or max age).

Validator for maximum age.

Validator for minimum age.

Creates a custom colored marker icon using Leaflet's DivIcon. This approach ensures accurate color representation for all colors, overcoming the limitations of the hue-rotate filter which cannot properly handle achromatic colors or accurately represent all RGB values.

Based on: https://stackoverflow.com/a/40870439/1473411

Leaflet DivIcon with the specified color

Calculate distance between two points Source ://henry-rossiter.medium.com/calculating-distance-between-geographic-coordinates-with-javascript-5f3097b61898https

Get all properties of an entity that represent a geographic location

Calculate the minimum distance (km) between an entity's location fields and a list of comparison coordinates. Returns null if no distance can be computed.

Creates a date range validator (min or max).

Validator for maximum date.

Validator for minimum date.

Normalizes a date to just the date portion (no time).

Parses a value to a Date object. Handles Date objects, date strings (YYYY-MM-DD), timestamps, and special value "$now".

"Simulate" a custom entity type that saves all fields without transformations through a mocked EntitySchema.

This is a utility function to help demo data creation because the dynamically migrated config is not ready at the time of demo data generation yet.

Decorator (Annotation @DatabaseEntity()) to set the string ENTITY_TYPE to an Entity Type. The entity should also be added to the databaseEntities array of the surrounding module.

also see

Add more human-readable descriptions to Sentry breadcrumbs for debugging.

see https://docs.sentry.io/platforms/javascript/enriching-events/breadcrumbs/

Sentry beforeSend hook that enriches events with structured extra data from custom Error properties (e.g. DatabaseException's entityId, status, reason).

Detect IndexedDB/PouchDB corruption symptoms commonly observed when the app is used in multiple tabs with concurrent writes.

We intentionally match on transaction was aborted because this is the reliable signal present on the actual error object propagated to app code after IndexedDB global-failure cases. The unknown_error label is too generic and may appear for unrelated failures.

Assert that two arrays contain the same items, regardless of order, while still supporting asymmetric matchers such as expect.objectContaining(...).

Extract a group ID from a group value (string, object, etc.)

Get a human-readable string from the given value as a label.

Returns true when leftVersion is newer than rightVersion.

The comparison is based on numeric segments to avoid lexicographic issues, e.g. 9.0.0 < 10.0.0.

Normalize participant sources into plain participant IDs.

Supports both configured participants field shapes used in attendance:

• string[] with direct entity IDs (datatype entity)
• attendance-like entries containing a participant ID (datatype attendance)

Load translation files and apply them to angular localize system.

Return the fields of entity that contain the given refId. If there is no such referenced ID, the array will be empty.

From a field's additional embedded schema, return the entries whose dataType is "entity" (i.e. inner entity-reference properties).

Returns an empty array when the field has no embedded schema.

Check whether a single value (a plain ID string or an embedded object) references the given entity ID.

When a field schema is provided and its additional defines an embedded schema, only the inner properties declared as entity references (dataType: "entity") are inspected. Without schema info the function falls back to checking all object values (backward-compatible).

Set all older notes to be "resolved" in order to keep the list of notes needing follow-up limited in the demo.

Create a simplified id string from the given text. This generates a camelCase string, removing special characters.

Get the default value configs filtered for the given mode.

Default configuration for Note Details.

Build the canonical runtime path for config-driven entity routes.

Resolve the effective route path for a view config at runtime. Entity views are always placed under CONFIG_ENTITY_ROUTE_PREFIX.

Convert a view:* config id into a plain route path.

Heuristic to identify config views that represent entity navigation. Includes views with an explicit entityType config and detail views (path ending with /:id).

Normalize a route path for internal comparisons. Removes a single leading slash and keeps nested segments unchanged.

Shared helper for import warnings related to inherited fields.

It centralizes detection of source-reference fields used by inherited-field defaults so mapping dialogs and import summary can show consistent hints without duplicating schema-scanning logic.

An enhanced sortingDataAccessor function that can be set for a MatTableDataSource in order to support sorting by ConfigurableEnum columns and other Entity specific values.

Transform a whole object into a readable format. This also transforms date objects to YYYY-MM-DD format.

True when an item has no destination link and also no nested sub-items.

True when an item is in manual mode (no entity type) and no link has been set.

Extends an array of configurable enum values with an ordinal value so that the ordinal value of each enum value matches the position of the element in the array.

Note that this should be used 'early' in the pipeline, i.e. when the ConfigurableEnumConfig is just created. It is technically not incorrect to use this function on any array that contains configurable enum values, but it doesn't make sense to apply this function to 'scrambled' arrays, i.e. arrays where the ordering of values is not the natural order of these values.

Check whether the given session type has a remote server connection. This is true for both "synced" (local+remote) and "online" (remote-only) modes.

Check whether an error represents a transient network/connectivity failure.

Matches common browser fetch errors, timeout errors, and HTTP 5xx gateway errors. Callers can layer additional domain-specific checks on top.

Generic validator to ensure a property value is unique within a collection. Can be configured to validate different properties (id, label, etc.) with optional normalization.

An async validator function

Whether a report's results should be rendered as a hierarchical group/count table (sql-v2-table) rather than a flat tabular table (object-table).

Derived purely from the canonical config structure (no version flag): a report is hierarchical when its reportDefinition contains a group (groupTitle) or more than one top-level item; otherwise it is tabular. Legacy v1 configs (normalized to a single ungrouped query) resolve to tabular.

Check whether an error is a retryable network/connectivity error, including keycloak-specific transient failures.

Unwraps exceljs's rich cell value shapes (e.g. hyperlinks expose text, formulas expose result) into a primitive suitable for the import flow.

Normalizes the additional config of an entity reference column mapping. Accepts legacy string format or new object format.

Normalizes a value for comparison, converting it to a standardized string format. Ensures both numbers and strings are treated consistently.

The normalized value as a string.

Normalize a query key used in export column configs. Strips a leading dot if present so callers can compare logical field keys.

Parses and returns the payload of a JWT into a JSON object. For me info see ://jwt.iohttps.

creates a pattern validator that also carries a predefined message

Extend any class method to measure the duration it takes to finish and log it to the console.

Retry a request on server error (status code 5xx). Use this in pipe(retryOnServerError(2)).

Retries are done with exponential backoff delays that are randomized (in case there are many parallel requests to be spread out).

Creates a resource that retains its previous value when reloading.

This function is similar to resource except while reloading. When isLoading() is true, value() holds the previously loaded value instead of undefined or defaultValue.

Wraps a function to ensure only one async operation runs at a time.

If called while the first async operation is still pending, returns the same promise. Once the operation completes (success or failure), subsequent calls will start a new operation.

Helper function for modern Angular components that extend CustomFormControlDirective.

Pass the fixture parameter for components that use signal input() for formFieldConfig, as direct property assignment does not work with signal inputs.

Split a raw value into an array of individual values. Supports JSON arrays and separator-delimited strings.

Array of individual string values

Map a result entry from getDaysSinceLastNoteOfEachEntity to the EntityWithRecentNoteInfo interface

Shared entity subclass test cases for model classes extending Entity.

Waits until the state of a source observable is equal to the given state, then emit that state. All other states are discarded.
After the state has changed to the desired state, subsequent states are let through. if this desire is not intended, use the filter function