every (non-hidden) field of a snapshot rendered as an addition

apply a jsondiffpatch delta to a deep clone of the current state

Build the displayable change history for one entity from its raw audit docs.

A jsondiffpatch update-delta only encodes what changed (e.g. items added to an array by index), not the full prior value — so per-field before/after cannot be read from a single delta. Instead the full document state is replayed: starting from the create/baseline snapshot and applying each update delta in chronological order, the before/after of every field (including multi-value arrays) is the difference between consecutive full states.

events newest-first

chronological: by server timestamp, then by revision generation

the (non-hidden) fields whose full value differs between two states

the full document snapshot carried by a baseline (raw doc) or create ([doc]) record

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 (addDefaultNoteDetailsConfig, addDefaultTodoViews) before calling this, so the migrations above can see those default-added view configs too.

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

Create a form validator that checks a single field's value against the permission rule conditions restricting it, so that users see a normal field error instead of only a technical rejection when saving.

The rules are evaluated in the given priority order (as returned by ability.rulesFor): the first rule whose condition matches the value decides, mirroring CASL's own precedence.

Returns null if the field's value cannot be the reason for a denied save. Inverted ("cannot") rules with conditions on several fields and conditions on properties without a form control (e.g. "created.by") are not covered here and remain handled by the save-time permission check.

Human-readable summary of a single permission condition fragment (the value of one key in a CASL rule's conditions object).

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.

Remove the "last sync" marker of every database, so that no previous sync is assumed to have happened on this device.

This accesses the real localStorage directly rather than the injectable LOCAL_STORAGE_TOKEN, because it also runs before Angular exists. Callers that need this mockable should wrap it in an instance method first.

Run pending reset cleanup before Angular bootstraps. Called from main.ts so that IndexedDB databases are deleted while no PouchDB connections are open (eliminating race conditions).

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

Recursively collect every query string value from a report definition tree.

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.

Whether running this report offers a date-range (start & end date) input, derived from the date placeholders used in its queries so it stays in sync with the actual report definition:

• "sql": the query uses the $startDate / $endDate placeholders.
• "reporting"/"exporting": the in-browser query uses positional ? placeholders (date args).

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.

An in-memory stand-in for localStorage, to be provided for LOCAL_STORAGE_TOKEN in tests.

Prefer this over vi.spyOn(Storage.prototype, ...): Storage.prototype lives in the worker process rather than the module registry, so Vitest's isolate does not undo such a stub. An unrestored one leaks into every later spec file and silently makes unrelated tests read a fake localStorage.

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/

Enrich events with structured extra data from custom Error properties (e.g. DatabaseException's entityId, status, reason).

Group events of our own wrapper error classes (see CAUSE_GROUPED_ERROR_TYPES) by their error chain instead of by stack trace, so that one problem shows up as one issue.

exception.values is ordered innermost-first: values[0] is the deepest cause, the originally thrown error is last. Both ends matter - the thrown error says which operation failed, the root cause says why (e.g. a config load failing because the device is offline is a different problem from the same load failing because the user is unauthorized).

The route remains available as the transaction tag, so a failure can still be filtered by where it happened without splitting it into separate issues.

Count occurrences of an event and check whether it exceeded the session cap.

The key is deliberately coarse: error class + normalized message of the root cause (values[0] is the deepest cause in the chain; the originally thrown, outermost error is last), without any stack information. Consequences:

• Same-message errors from different code paths share one budget, and all wrappers of a cascading failure are capped via their common root cause. This is a flood guard, not a grouping mechanism - see fingerprintSentryEvent for how issues are separated.
• Errors that interpolate data (e.g. entity IDs) into their message still share one budget, because the key is normalized the same way as the grouping fingerprint.

Whether the event is a network-layer fetch failure that occurred while the device was offline. In an offline-first app this is a normal state without diagnostic value (server outages still surface through online users).

Mask volatile details (ids, urls, numbers) so that different occurrences of the same problem produce the same string.

Sentry beforeSend hook: drops network failures of offline devices and excessive repeats of an identical event, and enriches the remaining events with structured extra data and a stable grouping fingerprint.

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.

Escape all special regex characters so the given text can be used as a literal search string inside a regular expression.

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).

Flatten a nested tree into rows (pre-order), carrying the depth as level.

Insert node as the first child of the row at parentIndex.

The deepest level a row directly below above may have (0 if there is no row above).

Move the subtree rooted at previousIndex to currentIndex (as reported by a cdkDropList, which only moves the dragged row itself — its descendants follow it here) and re-nest it by levelDelta levels, within what the rows it comes to rest between allow.

Clamp levels so the flat list always describes a valid tree: the first row is at level 0, every other row is at most one level deeper than the row above it — and only deeper if that row can have children at all — and no row is deeper than maxLevel.

Reconstruct the nested tree from flat rows: each row owns the following rows of greater level.

Remove the row at index together with its whole subtree.

Number of rows forming the subtree rooted at index (the row itself plus its descendants).

Replace the node of the row at index, keeping its position and nesting.

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.

The deferred install prompt, if the browser has offered one already.

Start listening for the browser's beforeinstallprompt event and defer it, so that the app can offer an install button at any later point.

Must be called before any async operation during bootstrap, because the browser fires the event early and does not replay it for later listeners.

Discard the deferred prompt and the listener's promise, and remove the beforeinstallprompt listener from window. Only needed in tests, to undo the module-level state of a previous case.

Resolves once/if the app can be installed directly. undefined if registerPWAInstallListener has not run.

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.