@records-fhir/validation-types 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -11,6 +11,25 @@ captures changes that affect type-package consumers directly.
 
 ## [Unreleased]
 
+## [0.1.6] — 2026-07-23
+
+Released alongside `@records-fhir/validator` 0.5.0.
+
+### Surface
+
+- Added `code-inferred` to `ProfileApplicationSource` so consumers can
+  distinguish FHIR-implied Observation profile selection from explicit,
+  resource-declared, imposed-policy, and base-fallback application.
+
+## [0.1.5] — 2026-06-23
+
+Released alongside `@records-fhir/validator` 0.1.14.
+
+### Surface
+
+- Published the issue-identity helper exports, including
+  `computeValidationIssueId`, required by the validator runtime and CLI.
+
 ## [0.1.4] — 2026-05-28
 
 Released alongside `@records-fhir/validator` 0.1.10.

package/dist/fix-suggestions/catalog-core.d.ts

@@ -0,0 +1,3 @@
+import type { FixSuggestion } from './types';
+export declare const CATALOG_CORE: Record<string, FixSuggestion>;
+//# sourceMappingURL=catalog-core.d.ts.map

package/dist/fix-suggestions/catalog-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-core.d.ts","sourceRoot":"","sources":["../../src/fix-suggestions/catalog-core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAmKtD,CAAC"}

package/dist/fix-suggestions/catalog-core.js

@@ -0,0 +1,164 @@
+import { CATALOG_METADATA } from './catalog-metadata.js';
+export const CATALOG_CORE = {
+    // -------------------------------------------------------------------------
+    // Terminology
+    // -------------------------------------------------------------------------
+    'terminology-binding-required': {
+        why: 'Required bindings must use codes from the specified ValueSet for interoperability.',
+        fix: 'Replace the code with one from the required ValueSet. Check the ValueSet definition for allowed codes.',
+        example: 'Use "active" instead of "Active" for Patient.status',
+        specUrl: 'https://www.hl7.org/fhir/terminologies.html#required',
+        patch: { action: 'replace', path: '{{fieldPath}}', value: '(use a code from {{valueSet}})' },
+    },
+    'terminology-binding-extensible': {
+        why: 'Extensible bindings prefer codes from the ValueSet, but allow extensions for missing concepts.',
+        fix: 'If your concept exists in the ValueSet, use it. Otherwise, document why a custom code is needed.',
+        specUrl: 'https://www.hl7.org/fhir/terminologies.html#extensible',
+    },
+    'terminology-binding-preferred': {
+        why: 'Preferred bindings recommend using codes from the ValueSet for better interoperability.',
+        fix: 'Consider using a code from the preferred ValueSet. Custom codes are allowed but reduce consistency.',
+        specUrl: 'https://www.hl7.org/fhir/terminologies.html#preferred',
+    },
+    'terminology-binding-example': {
+        why: 'Example bindings suggest possible codes but impose no constraints.',
+        fix: 'This is informational only. Your code is valid, but check if the example codes better fit your use case.',
+    },
+    'terminology-binding-required-code': {
+        why: 'This primitive code element must use a value from the required binding.',
+        fix: 'Use one of the allowed code values. Check the element definition for the list.',
+        example: 'For status: use "active", "inactive", or "entered-in-error"',
+    },
+    'terminology-binding-extensible-code': {
+        why: 'Prefer standard codes for primitive code elements to improve interoperability.',
+        fix: 'If a standard code fits, use it. Document why a custom code is needed if not.',
+    },
+    'terminology-binding-preferred-code': {
+        why: 'Preferred codes suggest standard values for better consistency.',
+        fix: 'Consider using the preferred code if it fits. This is informational.',
+    },
+    'terminology-binding-example-code': {
+        why: 'Example codes show typical usage but are not required.',
+        fix: 'This is informational only. Your code is valid.',
+    },
+    'terminology-binding-missing': {
+        why: 'A required coded element is missing its code value.',
+        fix: 'Add the required code from the bound ValueSet.',
+    },
+    'terminology-valueset-error': {
+        why: 'Could not validate against the ValueSet (lookup failed).',
+        fix: 'Check terminology server connectivity. The code may still be valid.',
+    },
+    'terminology-code-invalid': {
+        why: 'The code is not valid for the declared code system. For UCUM quantities, the code must be a machine-readable UCUM expression, not just the display text.',
+        fix: 'Replace the code with a valid code from the declared system. If the issue contains a suggestedCode, use that value; for pH this is typically "[pH]".',
+        example: 'For system "http://unitsofmeasure.org", use code "[pH]" instead of "pH".',
+        specUrl: 'https://www.hl7.org/fhir/terminologies.html',
+        patch: { action: 'replace', path: '{{fieldPath}}', value: '{{suggestedCode}}' },
+    },
+    'terminology-display-mismatch': {
+        why: 'The code may be valid, but the display text does not match the terminology server display for that code.',
+        fix: 'Replace the display with an accepted display from the terminology server, or omit display and let consumers render the code.',
+        example: 'Keep system/code stable and update only Coding.display.',
+        specUrl: 'https://www.hl7.org/fhir/datatypes.html#Coding',
+    },
+    'terminology-coding-system-valueset': {
+        why: 'Coding.system must identify the CodeSystem that defines the code. A ValueSet URL describes an allowed set of codes and is not valid as Coding.system.',
+        fix: 'Replace Coding.system with the canonical CodeSystem URL for the selected code. Keep the ValueSet only in profile bindings or documentation.',
+        example: 'Use "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus" instead of "http://hl7.org/fhir/ValueSet/marital-status".',
+        specUrl: 'https://www.hl7.org/fhir/datatypes.html#Coding',
+        patch: { action: 'replace', path: '{{fieldPath}}', value: '(use the code system URL for this code)' },
+    },
+    // -------------------------------------------------------------------------
+    // Structural
+    // -------------------------------------------------------------------------
+    'structural-required-element-missing': {
+        why: 'Required elements (min=1) must be present for the resource to be valid.',
+        fix: 'Add the missing element with a valid value.',
+        example: 'Add Patient.name: [{ "family": "Doe", "given": ["John"] }]',
+        patch: { action: 'add', path: '{{fieldPath}}', value: '(required — see element definition for type)' },
+    },
+    'structural-cardinality-min': {
+        why: 'The element requires a minimum number of values.',
+        fix: 'Add more values to meet the minimum cardinality requirement.',
+    },
+    'structural-cardinality-max': {
+        why: 'The element has exceeded the maximum allowed values.',
+        fix: 'Remove excess values or consolidate them as appropriate.',
+    },
+    'structural-type-mismatch': {
+        why: 'The value type must match what the FHIR specification expects.',
+        fix: 'Change the value to the correct type. Check the element definition for allowed types.',
+        example: 'birthDate should be "1990-01-15" (string), not 1990 (number)',
+        patch: { action: 'replace', path: '{{fieldPath}}', value: '(change to type {{expectedType}})' },
+    },
+    'structural-invalid-json': {
+        why: 'The resource cannot be parsed as valid JSON.',
+        fix: 'Check for syntax errors: missing quotes, commas, brackets, or trailing commas.',
+    },
+    'structural-invalid-format': {
+        why: 'The primitive value does not match the FHIR format for its declared type.',
+        fix: 'Use the FHIR primitive format expected by the element, such as adding seconds and a timezone for dateTime values.',
+        example: 'Use 2026-05-15T11:59:02Z instead of 2026-05-15T11:59:02',
+    },
+    'structural-unknown-element': {
+        why: 'This element is not defined in the FHIR specification for this resource type.',
+        fix: 'Remove the unknown element, or use an extension if custom data is needed.',
+    },
+    'structural-resource-type-mismatch': {
+        why: 'The resourceType does not match the expected type for this context.',
+        fix: 'Correct the resourceType field to match the expected type.',
+    },
+    'structural-missing-resource-type': {
+        why: 'Every FHIR resource must have a resourceType field.',
+        fix: 'Add resourceType at the root: { "resourceType": "Patient", ... }',
+        patch: { action: 'add', path: 'resourceType', value: '"{{resourceType}}"' },
+    },
+    'structural-cardinality-violation': {
+        why: 'The element count violates the cardinality constraint.',
+        fix: 'Add or remove elements to meet the min/max requirements.',
+    },
+    'structural-validation-error': {
+        why: 'Structural validation failed for an unspecified reason.',
+        fix: 'Check the resource structure against the FHIR specification.',
+    },
+    'structural-empty-array': {
+        why: 'FHIR arrays must contain at least one element if present.',
+        fix: 'Remove the empty array or add at least one entry.',
+    },
+    'structural-invalid-id': {
+        why: 'Resource id must match the FHIR id pattern: [A-Za-z0-9\\-._]{1,64}.',
+        fix: 'Use only alphanumeric characters, hyphens, dots, and underscores (max 64 chars).',
+    },
+    'structural-attachment-size-mismatch': {
+        why: 'Attachment.size does not match the actual byte count of Attachment.data.',
+        fix: 'Recalculate size from the decoded base64 data length and set it correctly.',
+    },
+    'structural-bundle-fullurl-duplicate': {
+        why: 'Each Bundle entry must have a unique fullUrl for unambiguous reference resolution.',
+        fix: 'Assign a unique fullUrl to each entry (use urn:uuid for temporary IDs).',
+    },
+    'structural-bundle-fullurl-invalid': {
+        why: 'The fullUrl value is not a valid URI.',
+        fix: 'Use an absolute URL (https://...) or urn:uuid:... format.',
+    },
+    'structural-bundle-fullurl-not-absolute': {
+        why: 'Bundle entry fullUrl must be an absolute URI, not a relative path.',
+        fix: 'Prefix with the server base URL or use a urn:uuid identifier.',
+    },
+    'structural-hapi-error': {
+        why: 'The HAPI FHIR validator reported an error.',
+        fix: 'Review the error details and fix the indicated issue.',
+    },
+    'structural-invalid-uri': {
+        why: 'The URI format is invalid per RFC 3986.',
+        fix: 'Use a valid URI format with proper scheme and encoding.',
+        example: 'https://example.org/fhir or urn:uuid:...',
+    },
+    'validation-error': {
+        why: 'General validation error.',
+        fix: 'Review the error message for specific guidance.',
+    },
+    ...CATALOG_METADATA,
+};
+//# sourceMappingURL=catalog-core.js.map

package/dist/fix-suggestions/catalog-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-core.js","sourceRoot":"","sources":["../../src/fix-suggestions/catalog-core.ts"],"names":[],"mappings":"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"}

package/dist/fix-suggestions/catalog-invariants.d.ts

@@ -0,0 +1,3 @@
+import type { FixSuggestion } from './types';
+export declare const CATALOG_INVARIANTS: Record<string, FixSuggestion>;
+//# sourceMappingURL=catalog-invariants.d.ts.map

package/dist/fix-suggestions/catalog-invariants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-invariants.d.ts","sourceRoot":"","sources":["../../src/fix-suggestions/catalog-invariants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAgT5D,CAAC"}

package/dist/fix-suggestions/catalog-invariants.js

@@ -0,0 +1,299 @@
+export const CATALOG_INVARIANTS = {
+    // -------------------------------------------------------------------------
+    // Narrative
+    // -------------------------------------------------------------------------
+    'narrative-malformed-xhtml': {
+        why: 'Narrative must be valid XHTML for safe rendering.',
+        fix: 'Check for unclosed tags, proper nesting, and valid XML structure.',
+        example: '<div xmlns="http://www.w3.org/1999/xhtml"><p>Valid narrative</p></div>',
+    },
+    'narrative-forbidden-content': {
+        why: 'Scripts and interactive elements are forbidden for security.',
+        fix: 'Remove <script>, <form>, <iframe>, onclick handlers, and javascript: URLs.',
+    },
+    'narrative-invalid-root': {
+        why: 'Narrative must have a <div> root with XHTML namespace.',
+        fix: 'Wrap content in: <div xmlns="http://www.w3.org/1999/xhtml">...</div>',
+        patch: { action: 'replace', path: 'text.div', value: '"<div xmlns=\\"http://www.w3.org/1999/xhtml\\">...</div>"' },
+    },
+    // -------------------------------------------------------------------------
+    // Business Rules
+    // -------------------------------------------------------------------------
+    'business-rule-violation': {
+        why: 'A clinical or business rule defined for this resource was violated.',
+        fix: 'Review the specific rule constraint and adjust your data accordingly.',
+    },
+    'business-value-out-of-range': {
+        why: 'The value falls outside the acceptable range for this measurement.',
+        fix: 'Verify the value is correct. If intentional, add interpretation or note.',
+    },
+    'business-negative-value': {
+        why: 'This field typically should not contain negative values.',
+        fix: 'Use a positive value, or verify this is intentional for your use case.',
+    },
+    'business-rule-sp-composite': {
+        why: 'A composite SearchParameter business rule was violated.',
+        fix: 'Review the composite parameter components and ensure the resource data satisfies all parts.',
+    },
+    'business-invalid-effective-date': {
+        why: 'The effective date format is invalid or illogical.',
+        fix: 'Use valid FHIR date/dateTime format (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ).',
+    },
+    'business-future-effective-date': {
+        why: 'Clinical observations typically should not have future effective dates.',
+        fix: 'Verify the date is correct. If intentional (e.g., scheduled medication), document why.',
+    },
+    'business-final-status-no-value': {
+        why: 'Observations with final status typically require a value.',
+        fix: 'Add a value, or use dataAbsentReason if value is legitimately missing.',
+        patch: { action: 'add', path: 'Observation.valueQuantity', value: '{ "value": 0, "unit": "...", "system": "http://unitsofmeasure.org" }' },
+    },
+    'business-invalid-onset-date': {
+        why: 'The onset date format is invalid.',
+        fix: 'Use valid FHIR date format (YYYY, YYYY-MM, or YYYY-MM-DD).',
+    },
+    'business-future-onset-date': {
+        why: 'Condition onset date is in the future.',
+        fix: 'If this is expected onset, consider using a different element.',
+    },
+    'business-invalid-birth-date': {
+        why: 'The birth date format is invalid.',
+        fix: 'Use valid date format: YYYY, YYYY-MM, or YYYY-MM-DD.',
+    },
+    'business-future-birth-date': {
+        why: 'Birth date cannot be in the future.',
+        fix: 'Correct the birth date to a past or current date.',
+    },
+    'business-unreasonable-age': {
+        why: 'The calculated age seems unrealistic (e.g., >150 years).',
+        fix: 'Verify the birth date is correct.',
+    },
+    'business-end-before-start': {
+        why: 'Period.end must be after Period.start for logical consistency.',
+        fix: 'Swap the dates or correct the incorrect value.',
+    },
+    'finished-status-no-end': {
+        why: 'Encounters with a "finished" status should record an end timestamp.',
+        fix: 'Add Encounter.period.end, or set the status to in-progress if still active.',
+    },
+    'invalid-status-value': {
+        why: 'The status code is not in the allowed value set for this resource.',
+        fix: 'Pick a status from the resource\'s defined status value set.',
+    },
+    'invalid-date-format': {
+        why: 'Dates must follow the FHIR date format (YYYY, YYYY-MM, or YYYY-MM-DD).',
+        fix: 'Rewrite the value as an ISO-8601 date with no embedded time.',
+    },
+    'invalid-period-start': {
+        why: 'Period.start must be a valid FHIR dateTime.',
+        fix: 'Use an ISO-8601 dateTime like 2026-04-08T10:15:30Z.',
+    },
+    'invalid-period-end': {
+        why: 'Period.end must be a valid FHIR dateTime.',
+        fix: 'Use an ISO-8601 dateTime like 2026-04-08T10:15:30Z.',
+    },
+    // -------------------------------------------------------------------------
+    // FHIR Core Invariants (dom-*, obs-*, pat-*, ele-*, ref-*, bdl-*, con-*)
+    // -------------------------------------------------------------------------
+    'dom-6': {
+        why: 'FHIR invariant dom-6: a resource should have narrative for robust management.',
+        fix: 'Add a populated `text.div` narrative element to the resource.',
+        specUrl: 'https://www.hl7.org/fhir/domainresource.html#invs',
+    },
+    'ele-1-violation': {
+        why: 'FHIR invariant ele-1: all FHIR elements must have @value or children.',
+        fix: 'Populate the element with a value or remove it if empty.',
+    },
+    'ref-1-violation': {
+        why: 'FHIR invariant ref-1: a Reference.reference must be either a relative or absolute URL.',
+        fix: 'Use a proper reference format (ResourceType/id or absolute URL).',
+    },
+    'obs-3-violation': {
+        why: 'FHIR invariant obs-3: a ReferenceRange must have at least a low, high, or text.',
+        fix: 'Add one of Observation.referenceRange.low, .high, or .text.',
+    },
+    'obs-6-violation': {
+        why: 'FHIR invariant obs-6: dataAbsentReason SHALL only be present if Observation.value[x] is not present.',
+        fix: 'Remove dataAbsentReason when a value is present, or vice versa.',
+        patch: { action: 'remove', path: 'Observation.dataAbsentReason' },
+    },
+    'obs-7-violation': {
+        why: 'FHIR invariant obs-7: Observation.value must not be present if Observation.dataAbsentReason is present.',
+        fix: 'Remove one of value[x] or dataAbsentReason.',
+    },
+    'pat-1-violation': {
+        why: 'FHIR invariant pat-1: Patient.contact SHALL at least contain a name, a telecom, or an address.',
+        fix: 'Populate at least one of name, telecom, or address on Patient.contact.',
+    },
+    'con-3-violation': {
+        why: 'FHIR invariant con-3: Condition.clinicalStatus and verificationStatus pair must be consistent.',
+        fix: 'Ensure clinicalStatus and verificationStatus follow the allowed combinations.',
+    },
+    'con-4-violation': {
+        why: 'FHIR invariant con-4: Condition.abatement SHALL only be present if clinicalStatus is resolved, remission, or inactive.',
+        fix: 'Remove abatement or update clinicalStatus accordingly.',
+    },
+    'con-5-violation': {
+        why: 'FHIR invariant con-5: Condition.clinicalStatus SHALL NOT be present if verificationStatus is entered-in-error.',
+        fix: 'Remove clinicalStatus when verificationStatus is entered-in-error.',
+        patch: { action: 'remove', path: 'Condition.clinicalStatus' },
+    },
+    'bdl-1-violation': {
+        why: 'FHIR invariant bdl-1: total is only allowed in search and history bundles.',
+        fix: 'Remove Bundle.total or change the Bundle.type to searchset/history.',
+    },
+    'bdl-2-violation': {
+        why: 'FHIR invariant bdl-2: entry.search only when Bundle.type is searchset.',
+        fix: 'Remove entry.search or switch the bundle to type searchset.',
+    },
+    'bdl-3-violation': {
+        why: 'FHIR invariant bdl-3: entry.request mandatory for type=transaction/batch/history.',
+        fix: 'Add entry.request or switch the bundle type.',
+    },
+    'bdl-4-violation': {
+        why: 'FHIR invariant bdl-4: entry.response mandatory for type=transaction-response/batch-response/history.',
+        fix: 'Add entry.response or switch the bundle type.',
+    },
+    'ait-1-violation': {
+        why: 'FHIR invariant ait-1: AllergyIntolerance clinical status must be consistent with verification status.',
+        fix: 'Ensure clinicalStatus and verificationStatus follow the allowed combinations.',
+    },
+    'ait-2-violation': {
+        why: 'FHIR invariant ait-2: AllergyIntolerance onset date must be before or at the recorded date.',
+        fix: 'Correct the onset or recordedDate so onset does not come after recorded.',
+    },
+    'cmp-1-violation': {
+        why: 'FHIR invariant cmp-1: Composition.section entry must reference a resource.',
+        fix: 'Add a valid reference for each Composition.section.entry.',
+    },
+    'cmp-2-violation': {
+        why: 'FHIR invariant cmp-2: A section must have at least one of text, entry, or section.',
+        fix: 'Add text, entry, or subsection to the empty Composition.section.',
+    },
+    // -------------------------------------------------------------------------
+    // Bundle-specific structural issues
+    // -------------------------------------------------------------------------
+    'bundle-validation-error': {
+        why: 'Bundle structural validation failed.',
+        fix: 'Review the Bundle type, entries, and request/response elements.',
+    },
+    'bundle-cross-entry-reference-missing': {
+        why: 'A reference inside this Bundle entry points to a resource that is not included as an entry in the same Bundle. For document and message Bundles, all referenced resources must be present.',
+        fix: 'Add the missing resource as a Bundle entry, or change the reference to point at an existing entry.',
+    },
+    'bundle-cross-entry-reference-unresolved': {
+        why: 'A reference cannot be resolved within this Bundle. The target resource may exist on an external server.',
+        fix: 'If the reference should be self-contained, add the target as a Bundle entry. Otherwise this warning is informational.',
+    },
+    'bundle-duplicate-entry': {
+        why: 'The same resource (same resourceType and id) appears more than once in the Bundle.',
+        fix: 'Remove the duplicate entry or assign distinct ids.',
+    },
+    'bundle-document-first-entry': {
+        why: 'Document bundles must have Composition as the first entry.',
+        fix: 'Re-order entries so the Composition resource comes first.',
+    },
+    'bundle-document-first-entry-not-composition': {
+        why: 'The first entry in a document Bundle must be a Composition resource.',
+        fix: 'Move the Composition entry to position 0 in Bundle.entry.',
+    },
+    'bundle-message-first-entry': {
+        why: 'Message bundles must have MessageHeader as the first entry.',
+        fix: 'Re-order entries so the MessageHeader resource comes first.',
+    },
+    'bundle-message-first-entry-not-messageheader': {
+        why: 'The first entry in a message Bundle must be a MessageHeader resource.',
+        fix: 'Move the MessageHeader entry to position 0 in Bundle.entry.',
+    },
+    'bundle-entry-missing-fullurl': {
+        why: 'Bundle entries should have a fullUrl for reference resolution within the Bundle.',
+        fix: 'Add fullUrl as an absolute URL or urn:uuid to the entry.',
+    },
+    'bundle-history-missing-total': {
+        why: 'History bundles should include a `total` field.',
+        fix: 'Populate Bundle.total with the total number of matches.',
+    },
+    'bundle-searchset-missing-total': {
+        why: 'Searchset bundles should include a `total` field.',
+        fix: 'Populate Bundle.total with the total matches for the search.',
+    },
+    'bundle-searchset-entry-missing-mode': {
+        why: 'Searchset bundle entries should declare entry.search.mode (match, include, outcome).',
+        fix: 'Set entry.search.mode explicitly for each entry.',
+    },
+    // -------------------------------------------------------------------------
+    // Contained resource issues
+    // -------------------------------------------------------------------------
+    'contained-missing-id': {
+        why: 'Contained resources must have an id so they can be referenced.',
+        fix: 'Add an id to the contained resource.',
+        patch: { action: 'add', path: '{{fieldPath}}.id', value: '"contained-1"' },
+    },
+    'contained-missing-resourcetype': {
+        why: 'Contained resources must declare their resourceType.',
+        fix: 'Add resourceType to every entry in the contained array.',
+    },
+    'contained-duplicate-id': {
+        why: 'Contained resource ids must be unique within a resource.',
+        fix: 'Rename duplicate contained resource ids.',
+    },
+    'contained-nested-violation': {
+        why: 'FHIR forbids nesting contained resources inside contained resources.',
+        fix: 'Flatten the contained hierarchy so each contained resource is only one level deep.',
+    },
+    'contained-unreferenced': {
+        why: 'Every contained resource should be referenced by the parent (dom-3).',
+        fix: 'Add a reference to the contained resource via #localId or remove it.',
+    },
+    'contained-reference-type-unknown': {
+        why: 'The referenced contained resource\'s type cannot be inferred.',
+        fix: 'Fix the parent reference path or add the contained resource.',
+    },
+    // -------------------------------------------------------------------------
+    // Deep binding / terminology traversal
+    // -------------------------------------------------------------------------
+    'deep-binding-empty-code': {
+        why: 'A coded element anywhere in the resource is empty.',
+        fix: 'Populate the coding.code (and system) or remove the element.',
+    },
+    'deep-binding-no-valid-coding': {
+        why: 'A CodeableConcept has no coding that matches the required ValueSet.',
+        fix: 'Add at least one coding whose system/code is from the required ValueSet.',
+    },
+    // -------------------------------------------------------------------------
+    // Early termination (short-circuit on critical errors)
+    // -------------------------------------------------------------------------
+    'early-termination-null-resource': {
+        why: 'Validation was asked to run on a null/undefined resource.',
+        fix: 'Ensure the caller passes a valid FHIR resource object.',
+    },
+    'early-termination-empty-resource': {
+        why: 'Validation was asked to run on an empty object.',
+        fix: 'Provide a populated FHIR resource with resourceType and fields.',
+    },
+    'early-termination-not-object': {
+        why: 'FHIR resources must be JSON objects.',
+        fix: 'Parse the input to a JS object before passing it to the validator.',
+    },
+    'early-termination-missing-resourcetype': {
+        why: 'Every FHIR resource must declare resourceType.',
+        fix: 'Add resourceType at the root of the resource.',
+    },
+    'early-termination-unknown-resourcetype': {
+        why: 'The supplied resourceType is not known in this FHIR version.',
+        fix: 'Verify resourceType spelling (case-sensitive) and the FHIR version.',
+    },
+    'early-termination-missing-id': {
+        why: 'A persistent FHIR resource requires an id.',
+        fix: 'Add an id to the resource or use a POST create (server assigns id).',
+    },
+    'early-termination-missing-required': {
+        why: 'A required top-level element is missing — aborting further checks.',
+        fix: 'Populate the indicated required element and re-run validation.',
+    },
+    'early-termination-resource-too-large': {
+        why: 'The resource exceeds the configured size limit.',
+        fix: 'Split large bundles or raise the validator size limit cautiously.',
+    },
+};
+//# sourceMappingURL=catalog-invariants.js.map

package/dist/fix-suggestions/catalog-invariants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-invariants.js","sourceRoot":"","sources":["../../src/fix-suggestions/catalog-invariants.ts"],"names":[],"mappings":"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"}

package/dist/fix-suggestions/catalog-metadata.d.ts

@@ -0,0 +1,3 @@
+import type { FixSuggestion } from './types';
+export declare const CATALOG_METADATA: Record<string, FixSuggestion>;
+//# sourceMappingURL=catalog-metadata.d.ts.map

package/dist/fix-suggestions/catalog-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-metadata.d.ts","sourceRoot":"","sources":["../../src/fix-suggestions/catalog-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAgQ1D,CAAC"}