fhir_reference validator

Faithful summary of lib/validators.ts. Validators are pure functions and run identically in the worker, the Workbench, and the MCP server.

function validFhirRef(value) {
  return /^[A-Z][A-Za-z]+\/[A-Za-z0-9-]+$/.test(value)
    ? OK
    : fail('fhir_ref_invalid', 'expected ResourceType/id')
}

Validators attach to a field on a custom template. The cascade runs them after mapping but before commit; failures surface in the per-row validation report.

fields:
  - column: subject
    type: string
    validators:
      - type: fhir_reference

• Relative form only. `https://server/fhir/Patient/123` fails — strip the base in transform.
• Underscores and dots in the id are rejected — FHIR allows them, but we do not. Open an issue if your server needs them.
• No resource-type allow-list. `MyCustomThing/1` passes the shape check.

No template in the default catalogue ships with fhir_reference preconfigured. Use it on a custom template via the YAML snippet above, or via the template editor.

Validators add no AI cost — they are pure functions. Every map bills a small flat per-map fee from your prepaid token wallet ($10 minimum, shared across our suite); only columns that reach the metered LLM layer, plus any-to-any convert and reshape, bill real AI tokens. See pricing →

Back to the documentation index or browse the template catalogue.