fhir-runtime 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -182,6 +182,64 @@ export declare function buildCanonicalProfile(sd: StructureDefinition): Canonica
  */
 export declare function buildInvariants(constraints: readonly ElementDefinitionConstraint[] | undefined): Invariant[];
 
+/**
+ * Build a FHIR OperationOutcome from a {@link ValidationResult}.
+ *
+ * Maps each {@link ValidationIssue} to an OperationOutcome.issue entry
+ * with appropriate severity, issue type code, details, and expression.
+ *
+ * If the validation result has no issues, returns an OperationOutcome
+ * with a single informational issue indicating success.
+ *
+ * @param result - The validation result to convert.
+ * @returns A FHIR R4 OperationOutcome resource.
+ *
+ * @example
+ * ```typescript
+ * const result = validator.validate(patient, patientProfile);
+ * const outcome = buildOperationOutcome(result);
+ * // outcome.resourceType === 'OperationOutcome'
+ * // outcome.issue.length >= 1
+ * ```
+ */
+export declare function buildOperationOutcome(result: ValidationResult): OperationOutcome;
+
+/**
+ * Build a FHIR OperationOutcome from a {@link ParseResult}.
+ *
+ * Maps each {@link ParseIssue} to an OperationOutcome.issue entry.
+ * If the parse result is successful with no issues, returns an
+ * OperationOutcome with a single informational success message.
+ *
+ * @param result - The parse result to convert.
+ * @returns A FHIR R4 OperationOutcome resource.
+ *
+ * @example
+ * ```typescript
+ * const result = parseFhirJson(jsonString);
+ * const outcome = buildOperationOutcomeFromParse(result);
+ * ```
+ */
+export declare function buildOperationOutcomeFromParse(result: ParseResult<unknown>): OperationOutcome;
+
+/**
+ * Build a FHIR OperationOutcome from a {@link SnapshotResult}.
+ *
+ * Maps each {@link SnapshotIssue} to an OperationOutcome.issue entry.
+ * If the snapshot result is successful with no issues, returns an
+ * OperationOutcome with a single informational success message.
+ *
+ * @param result - The snapshot result to convert.
+ * @returns A FHIR R4 OperationOutcome resource.
+ *
+ * @example
+ * ```typescript
+ * const result = await generator.generate(sd);
+ * const outcome = buildOperationOutcomeFromSnapshot(result);
+ * ```
+ */
+export declare function buildOperationOutcomeFromSnapshot(result: SnapshotResult): OperationOutcome;
+
 /**
  * Convert ElementDefinitionSlicing to SlicingDefinition.
  *
@@ -1441,6 +1499,20 @@ export declare function evalFhirPathString(expression: string | FhirPathAtom, in
  */
 export declare function evalFhirPathTyped(expression: string | FhirPathAtom, input: TypedValue[], variables?: Record<string, TypedValue>): TypedValue[];
 
+/**
+ * Parameters for expanding a ValueSet.
+ */
+export declare interface ExpandValueSetParams {
+    /** The ValueSet URL to expand. */
+    readonly url: string;
+    /** Optional text filter to narrow the expansion. */
+    readonly filter?: string;
+    /** Optional offset for pagination. */
+    readonly offset?: number;
+    /** Optional count limit for pagination. */
+    readonly count?: number;
+}
+
 /**
  * An Extension: additional information that is not part of the basic
  * definition of the resource.
@@ -2406,6 +2478,28 @@ export declare interface FhirContext {
                              retryCount?: number;
                          }
 
+                         /**
+                          * Parameters for looking up a code in a CodeSystem.
+                          */
+                         export declare interface LookupCodeParams {
+                             /** The CodeSystem URL. */
+                             readonly system: string;
+                             /** The code to look up. */
+                             readonly code: string;
+                         }
+
+                         /**
+                          * Result of a code lookup operation.
+                          */
+                         export declare interface LookupCodeResult {
+                             /** Whether the code was found in the CodeSystem. */
+                             readonly found: boolean;
+                             /** The display string for the code (if found). */
+                             readonly display?: string;
+                             /** The definition of the code (if found). */
+                             readonly definition?: string;
+                         }
+
                          /**
                           * Generate the default slicing definition for extension elements.
                           *
@@ -2591,6 +2685,118 @@ export declare interface FhirContext {
                           */
                          export declare type NarrativeStatus = 'generated' | 'extensions' | 'additional' | 'empty';
 
+                         /**
+                          * A no-operation reference resolver that assumes all references exist.
+                          *
+                          * Use this as a default resolver when no resource store is available.
+                          * All references are assumed to exist, but no actual resources are returned.
+                          *
+                          * @example
+                          * ```typescript
+                          * const resolver = new NoOpReferenceResolver();
+                          * const exists = await resolver.exists('Patient/123');
+                          * console.log(exists); // true
+                          *
+                          * const resource = await resolver.resolve('Patient/123');
+                          * console.log(resource); // undefined
+                          * ```
+                          */
+                         export declare class NoOpReferenceResolver implements ReferenceResolver {
+                             /**
+                              * Always returns `undefined`.
+                              *
+                              * No actual reference resolution is performed.
+                              */
+                             resolve(_reference: string): Promise<Resource | undefined>;
+                             /**
+                              * Always returns `true`.
+                              *
+                              * Assumes all reference targets exist without checking.
+                              */
+                             exists(_reference: string): Promise<boolean>;
+                         }
+
+                         /**
+                          * A no-operation terminology provider that accepts all codes.
+                          *
+                          * Use this as a default provider when no terminology server is available.
+                          * All codes are considered valid, no ValueSet expansions are returned,
+                          * and code lookups always report "not found".
+                          *
+                          * @example
+                          * ```typescript
+                          * const provider = new NoOpTerminologyProvider();
+                          * const result = await provider.validateCode({ system: 'http://loinc.org', code: '12345-6' });
+                          * console.log(result.result); // true
+                          * ```
+                          */
+                         export declare class NoOpTerminologyProvider implements TerminologyProvider {
+                             /**
+                              * Always returns `{ result: true }`.
+                              *
+                              * No actual code validation is performed.
+                              */
+                             validateCode(_params: ValidateCodeParams): Promise<ValidateCodeResult>;
+                             /**
+                              * Always returns an empty expansion `{ contains: [] }`.
+                              *
+                              * No actual ValueSet expansion is performed.
+                              */
+                             expandValueSet(_params: ExpandValueSetParams): Promise<ValueSetExpansion>;
+                             /**
+                              * Always returns `{ found: false }`.
+                              *
+                              * No actual code lookup is performed.
+                              */
+                             lookupCode(_params: LookupCodeParams): Promise<LookupCodeResult>;
+                         }
+
+                         /**
+                          * FHIR OperationOutcome resource.
+                          *
+                          * Represents the outcome of an operation, containing a list of issues
+                          * (errors, warnings, information) encountered during processing.
+                          *
+                          * @see https://hl7.org/fhir/R4/operationoutcome.html
+                          */
+                         export declare interface OperationOutcome {
+                             /** Fixed value: `'OperationOutcome'`. */
+                             readonly resourceType: 'OperationOutcome';
+                             /** The list of issues. */
+                             readonly issue: readonly OperationOutcomeIssue[];
+                         }
+
+                         /**
+                          * A single issue within an OperationOutcome.
+                          *
+                          * @see https://hl7.org/fhir/R4/operationoutcome-definitions.html#OperationOutcome.issue
+                          */
+                         export declare interface OperationOutcomeIssue {
+                             /** Severity of the issue. */
+                             readonly severity: 'fatal' | 'error' | 'warning' | 'information';
+                             /**
+                              * Issue type code.
+                              * @see https://hl7.org/fhir/R4/valueset-issue-type.html
+                              */
+                             readonly code: OperationOutcomeIssueType;
+                             /** Additional diagnostic information. */
+                             readonly diagnostics?: string;
+                             /** Additional details about the issue. */
+                             readonly details?: {
+                                 readonly text?: string;
+                             };
+                             /** FHIRPath expression(s) pointing to the problematic element(s). */
+                             readonly expression?: readonly string[];
+                         }
+
+                         /**
+                          * FHIR OperationOutcome issue type codes.
+                          *
+                          * Subset of codes from https://hl7.org/fhir/R4/valueset-issue-type.html
+                          * relevant to structural validation, parsing, and snapshot generation.
+                          */
+                         export declare type OperationOutcomeIssueType = 'invalid' | 'structure' | 'required' | 'value' | 'invariant' | 'processing' | 'not-supported' | 'not-found' | 'business-rule' | 'informational';
+
                          /**
                           * Get the parent path (everything before the last `.`).
                           *
@@ -2951,6 +3157,39 @@ export declare interface FhirContext {
                              display?: FhirString;
                          }
 
+                         /**
+                          * Abstract interface for resolving FHIR References.
+                          *
+                          * Implementations may resolve references against a local store,
+                          * a remote FHIR server, or a bundle's contained resources.
+                          *
+                          * The runtime provides {@link NoOpReferenceResolver} as a default
+                          * implementation.
+                          *
+                          * @example
+                          * ```typescript
+                          * const resolver: ReferenceResolver = new NoOpReferenceResolver();
+                          * const exists = await resolver.exists('Patient/123');
+                          * console.log(exists); // true (NoOp always returns true)
+                          * ```
+                          */
+                         export declare interface ReferenceResolver {
+                             /**
+                              * Resolve a FHIR reference to its target resource.
+                              *
+                              * @param reference - The reference string (e.g., `'Patient/123'`).
+                              * @returns The resolved resource, or `undefined` if not found.
+                              */
+                             resolve(reference: string): Promise<Resource | undefined>;
+                             /**
+                              * Check whether a FHIR reference target exists.
+                              *
+                              * @param reference - The reference string (e.g., `'Patient/123'`).
+                              * @returns `true` if the referenced resource exists.
+                              */
+                             exists(reference: string): Promise<boolean>;
+                         }
+
                          /**
                           * Whether all resource references need to be version-specific.
                           * @see https://hl7.org/fhir/R4/valueset-reference-version-rules.html
@@ -3812,6 +4051,46 @@ export declare interface FhirContext {
                                        */
                                       export declare function tailSegment(path: string): string;
 
+                                      /**
+                                       * Abstract interface for terminology operations.
+                                       *
+                                       * Implementations may connect to a remote FHIR terminology server,
+                                       * an in-memory CodeSystem/ValueSet registry, or any other source.
+                                       *
+                                       * The runtime provides {@link NoOpTerminologyProvider} as a default
+                                       * implementation that accepts all codes without validation.
+                                       *
+                                       * @example
+                                       * ```typescript
+                                       * const provider: TerminologyProvider = new NoOpTerminologyProvider();
+                                       * const result = await provider.validateCode({ system: 'http://loinc.org', code: '12345-6' });
+                                       * console.log(result.result); // true (NoOp always passes)
+                                       * ```
+                                       */
+                                      export declare interface TerminologyProvider {
+                                          /**
+                                           * Validate a code against a CodeSystem or ValueSet.
+                                           *
+                                           * @param params - Validation parameters (system, code, optional valueSetUrl).
+                                           * @returns Validation result indicating whether the code is valid.
+                                           */
+                                          validateCode(params: ValidateCodeParams): Promise<ValidateCodeResult>;
+                                          /**
+                                           * Expand a ValueSet to enumerate its contained codes.
+                                           *
+                                           * @param params - Expansion parameters (url, optional filter/pagination).
+                                           * @returns The expanded ValueSet contents.
+                                           */
+                                          expandValueSet(params: ExpandValueSetParams): Promise<ValueSetExpansion>;
+                                          /**
+                                           * Look up a code in a CodeSystem to retrieve its display and definition.
+                                           *
+                                           * @param params - Lookup parameters (system, code).
+                                           * @returns Lookup result with display and definition (if found).
+                                           */
+                                          lookupCode(params: LookupCodeParams): Promise<LookupCodeResult>;
+                                      }
+
                                       /**
                                        * Cursor-based scope for base-driven traversal.
                                        *
@@ -3945,6 +4224,32 @@ export declare interface FhirContext {
                                           value?: unknown;
                                       }
 
+                                      /**
+                                       * Parameters for validating a code against a CodeSystem or ValueSet.
+                                       */
+                                      export declare interface ValidateCodeParams {
+                                          /** The CodeSystem URL (e.g., `'http://loinc.org'`). */
+                                          readonly system: string;
+                                          /** The code to validate. */
+                                          readonly code: string;
+                                          /** Optional ValueSet URL to validate the code against. */
+                                          readonly valueSetUrl?: string;
+                                          /** Optional display string to validate. */
+                                          readonly display?: string;
+                                      }
+
+                                      /**
+                                       * Result of a code validation operation.
+                                       */
+                                      export declare interface ValidateCodeResult {
+                                          /** Whether the code is valid in the given system/ValueSet. */
+                                          readonly result: boolean;
+                                          /** Optional message explaining the validation outcome. */
+                                          readonly message?: string;
+                                          /** The preferred display for the code (if known). */
+                                          readonly display?: string;
+                                      }
+
                                       /**
                                        * Validate that snapshot elements are in correct order.
                                        *
@@ -4161,6 +4466,26 @@ export declare interface FhirContext {
                                            * @default false
                                            */
                                           readonly skipInvariants?: boolean;
+                                          /**
+                                           * Optional terminology provider for binding validation.
+                                           *
+                                           * When provided, the validator will invoke the provider to check
+                                           * coded values against their declared bindings. When absent,
+                                           * binding validation is skipped (with a warning for required bindings).
+                                           *
+                                           * @default undefined
+                                           */
+                                          readonly terminologyProvider?: TerminologyProvider;
+                                          /**
+                                           * Optional reference resolver for reference existence checks.
+                                           *
+                                           * When provided, the validator may use it for additional reference
+                                           * validation beyond structural checks. When absent, reference
+                                           * existence is not verified.
+                                           *
+                                           * @default undefined
+                                           */
+                                          readonly referenceResolver?: ReferenceResolver;
                                       }
 
                                       /**
@@ -4221,4 +4546,26 @@ export declare interface FhirContext {
                                           constructor(message: string, options?: ErrorOptions);
                                       }
 
+                                      /**
+                                       * Result of a ValueSet expansion operation.
+                                       */
+                                      export declare interface ValueSetExpansion {
+                                          /** Total number of concepts in the expansion (before pagination). */
+                                          readonly total?: number;
+                                          /** The expanded concepts. */
+                                          readonly contains: readonly ValueSetExpansionContains[];
+                                      }
+
+                                      /**
+                                       * A single concept in a ValueSet expansion.
+                                       */
+                                      export declare interface ValueSetExpansionContains {
+                                          /** The CodeSystem URL this concept belongs to. */
+                                          readonly system: string;
+                                          /** The code value. */
+                                          readonly code: string;
+                                          /** Optional human-readable display for the code. */
+                                          readonly display?: string;
+                                      }
+
                                       export { }

package/dist/lib/index.d.ts

@@ -21,4 +21,6 @@ export { SnapshotGenerator, buildCanonicalProfile, buildCanonicalElement, buildT
 export type { ValidationOptions, ValidationResult, ValidationIssue, ValidationIssueCode, } from './validator/index.js';
 export { StructureValidator, createValidationIssue, resolveValidationOptions, hasValidationErrors, extractValues, ProfileNotFoundError, ValidationFailedError, } from './validator/index.js';
 export { evalFhirPath, evalFhirPathBoolean, evalFhirPathTyped, evalFhirPathString, } from './fhirpath/index.js';
+export type { TerminologyProvider, ValidateCodeParams, ValidateCodeResult, ExpandValueSetParams, ValueSetExpansion, ValueSetExpansionContains, LookupCodeParams, LookupCodeResult, ReferenceResolver, OperationOutcome, OperationOutcomeIssue, OperationOutcomeIssueType, } from './provider/index.js';
+export { NoOpTerminologyProvider, NoOpReferenceResolver, buildOperationOutcome, buildOperationOutcomeFromParse, buildOperationOutcomeFromSnapshot, } from './provider/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/provider/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * fhir-provider — Barrel Exports
+ *
+ * Re-exports all public types, interfaces, and implementations from
+ * the FHIR provider module.
+ *
+ * Public surface:
+ * - Types: TerminologyProvider, ReferenceResolver, OperationOutcome, etc.
+ * - NoOp implementations: NoOpTerminologyProvider, NoOpReferenceResolver
+ * - Builders: buildOperationOutcome, buildOperationOutcomeFromParse, buildOperationOutcomeFromSnapshot
+ *
+ * @module fhir-provider
+ */
+export type { TerminologyProvider, ValidateCodeParams, ValidateCodeResult, ExpandValueSetParams, ValueSetExpansion, ValueSetExpansionContains, LookupCodeParams, LookupCodeResult, ReferenceResolver, OperationOutcome, OperationOutcomeIssue, OperationOutcomeIssueType, } from './types.js';
+export { NoOpTerminologyProvider } from './noop-terminology-provider.js';
+export { NoOpReferenceResolver } from './noop-reference-resolver.js';
+export { buildOperationOutcome, buildOperationOutcomeFromParse, buildOperationOutcomeFromSnapshot, } from './operation-outcome-builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/provider/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAGrE,OAAO,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,iCAAiC,GAClC,MAAM,gCAAgC,CAAC"}

package/dist/lib/provider/noop-reference-resolver.d.ts

@@ -0,0 +1,47 @@
+/**
+ * fhir-provider — NoOp Reference Resolver
+ *
+ * Default implementation of {@link ReferenceResolver} that treats all
+ * references as existing without performing any actual resolution.
+ * This allows the runtime to function standalone without a FHIR server
+ * or resource store.
+ *
+ * Behavior:
+ * - `resolve()` → always returns `undefined` (no resource available)
+ * - `exists()` → always returns `true` (assume reference target exists)
+ *
+ * @module fhir-provider
+ */
+import type { Resource } from '../model/index.js';
+import type { ReferenceResolver } from './types.js';
+/**
+ * A no-operation reference resolver that assumes all references exist.
+ *
+ * Use this as a default resolver when no resource store is available.
+ * All references are assumed to exist, but no actual resources are returned.
+ *
+ * @example
+ * ```typescript
+ * const resolver = new NoOpReferenceResolver();
+ * const exists = await resolver.exists('Patient/123');
+ * console.log(exists); // true
+ *
+ * const resource = await resolver.resolve('Patient/123');
+ * console.log(resource); // undefined
+ * ```
+ */
+export declare class NoOpReferenceResolver implements ReferenceResolver {
+    /**
+     * Always returns `undefined`.
+     *
+     * No actual reference resolution is performed.
+     */
+    resolve(_reference: string): Promise<Resource | undefined>;
+    /**
+     * Always returns `true`.
+     *
+     * Assumes all reference targets exist without checking.
+     */
+    exists(_reference: string): Promise<boolean>;
+}
+//# sourceMappingURL=noop-reference-resolver.d.ts.map

package/dist/lib/provider/noop-reference-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-reference-resolver.d.ts","sourceRoot":"","sources":["../../../src/provider/noop-reference-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,qBAAsB,YAAW,iBAAiB;IAC7D;;;;OAIG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAIhE;;;;OAIG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGnD"}

package/dist/lib/provider/noop-terminology-provider.d.ts

@@ -0,0 +1,50 @@
+/**
+ * fhir-provider — NoOp Terminology Provider
+ *
+ * Default implementation of {@link TerminologyProvider} that accepts all
+ * codes without performing any actual terminology validation. This allows
+ * the runtime to function standalone without a terminology server.
+ *
+ * Behavior:
+ * - `validateCode()` → always returns `{ result: true }`
+ * - `expandValueSet()` → always returns empty expansion `{ contains: [] }`
+ * - `lookupCode()` → always returns `{ found: false }`
+ *
+ * @module fhir-provider
+ */
+import type { TerminologyProvider, ValidateCodeParams, ValidateCodeResult, ExpandValueSetParams, ValueSetExpansion, LookupCodeParams, LookupCodeResult } from './types.js';
+/**
+ * A no-operation terminology provider that accepts all codes.
+ *
+ * Use this as a default provider when no terminology server is available.
+ * All codes are considered valid, no ValueSet expansions are returned,
+ * and code lookups always report "not found".
+ *
+ * @example
+ * ```typescript
+ * const provider = new NoOpTerminologyProvider();
+ * const result = await provider.validateCode({ system: 'http://loinc.org', code: '12345-6' });
+ * console.log(result.result); // true
+ * ```
+ */
+export declare class NoOpTerminologyProvider implements TerminologyProvider {
+    /**
+     * Always returns `{ result: true }`.
+     *
+     * No actual code validation is performed.
+     */
+    validateCode(_params: ValidateCodeParams): Promise<ValidateCodeResult>;
+    /**
+     * Always returns an empty expansion `{ contains: [] }`.
+     *
+     * No actual ValueSet expansion is performed.
+     */
+    expandValueSet(_params: ExpandValueSetParams): Promise<ValueSetExpansion>;
+    /**
+     * Always returns `{ found: false }`.
+     *
+     * No actual code lookup is performed.
+     */
+    lookupCode(_params: LookupCodeParams): Promise<LookupCodeResult>;
+}
+//# sourceMappingURL=noop-terminology-provider.d.ts.map

package/dist/lib/provider/noop-terminology-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-terminology-provider.d.ts","sourceRoot":"","sources":["../../../src/provider/noop-terminology-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;GAaG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI5E;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI/E;;;;OAIG;IACG,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAGvE"}

package/dist/lib/provider/operation-outcome-builder.d.ts

@@ -0,0 +1,71 @@
+/**
+ * fhir-provider — OperationOutcome Builder
+ *
+ * Converts internal result types ({@link ValidationResult}, {@link ParseResult},
+ * {@link SnapshotResult}) into standard FHIR R4 OperationOutcome resources.
+ *
+ * This is essential for fhir-server integration, where REST API responses
+ * must include OperationOutcome resources to communicate processing results.
+ *
+ * @module fhir-provider
+ */
+import type { ValidationResult } from '../validator/types.js';
+import type { ParseResult } from '../parser/parse-error.js';
+import type { SnapshotResult } from '../profile/types.js';
+import type { OperationOutcome } from './types.js';
+/**
+ * Build a FHIR OperationOutcome from a {@link ValidationResult}.
+ *
+ * Maps each {@link ValidationIssue} to an OperationOutcome.issue entry
+ * with appropriate severity, issue type code, details, and expression.
+ *
+ * If the validation result has no issues, returns an OperationOutcome
+ * with a single informational issue indicating success.
+ *
+ * @param result - The validation result to convert.
+ * @returns A FHIR R4 OperationOutcome resource.
+ *
+ * @example
+ * ```typescript
+ * const result = validator.validate(patient, patientProfile);
+ * const outcome = buildOperationOutcome(result);
+ * // outcome.resourceType === 'OperationOutcome'
+ * // outcome.issue.length >= 1
+ * ```
+ */
+export declare function buildOperationOutcome(result: ValidationResult): OperationOutcome;
+/**
+ * Build a FHIR OperationOutcome from a {@link ParseResult}.
+ *
+ * Maps each {@link ParseIssue} to an OperationOutcome.issue entry.
+ * If the parse result is successful with no issues, returns an
+ * OperationOutcome with a single informational success message.
+ *
+ * @param result - The parse result to convert.
+ * @returns A FHIR R4 OperationOutcome resource.
+ *
+ * @example
+ * ```typescript
+ * const result = parseFhirJson(jsonString);
+ * const outcome = buildOperationOutcomeFromParse(result);
+ * ```
+ */
+export declare function buildOperationOutcomeFromParse(result: ParseResult<unknown>): OperationOutcome;
+/**
+ * Build a FHIR OperationOutcome from a {@link SnapshotResult}.
+ *
+ * Maps each {@link SnapshotIssue} to an OperationOutcome.issue entry.
+ * If the snapshot result is successful with no issues, returns an
+ * OperationOutcome with a single informational success message.
+ *
+ * @param result - The snapshot result to convert.
+ * @returns A FHIR R4 OperationOutcome resource.
+ *
+ * @example
+ * ```typescript
+ * const result = await generator.generate(sd);
+ * const outcome = buildOperationOutcomeFromSnapshot(result);
+ * ```
+ */
+export declare function buildOperationOutcomeFromSnapshot(result: SnapshotResult): OperationOutcome;
+//# sourceMappingURL=operation-outcome-builder.d.ts.map

package/dist/lib/provider/operation-outcome-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-outcome-builder.d.ts","sourceRoot":"","sources":["../../../src/provider/operation-outcome-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAwC,MAAM,uBAAuB,CAAC;AACpG,OAAO,KAAK,EAAE,WAAW,EAA8B,MAAM,0BAA0B,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAoC,MAAM,qBAAqB,CAAC;AAC5F,OAAO,KAAK,EAAE,gBAAgB,EAAoD,MAAM,YAAY,CAAC;AA8CrG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAkBhF;AAkCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAkB7F;AAoCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAkB1F"}