fhir-persistence 0.1.0

package/dist/lib/providers/definition-provider.d.ts

@@ -0,0 +1,124 @@
+/**
+ * DefinitionProvider — Bridge Interface for fhir-definition
+ *
+ * Abstracts the `fhir-definition` registry so that `fhir-persistence`
+ * never imports `fhir-definition` types directly. This enables:
+ *
+ * - Testing with in-memory mocks (no IG package loading)
+ * - Swapping fhir-definition versions without touching persistence code
+ * - Structural typing compatibility (duck typing)
+ *
+ * ADR-01 §2.3: DefinitionProvider interface contract.
+ *
+ * @module fhir-persistence/providers
+ */
+/**
+ * Minimal StructureDefinition shape used by fhir-persistence.
+ * Only the fields that fhir-persistence reads are declared.
+ */
+export interface StructureDefinitionDef {
+    resourceType: 'StructureDefinition';
+    url: string;
+    name?: string;
+    type?: string;
+    kind?: string;
+    snapshot?: {
+        element?: Array<{
+            path?: string;
+            type?: Array<{
+                code?: string;
+            }>;
+            [key: string]: unknown;
+        }>;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Minimal ValueSet shape used by fhir-persistence.
+ */
+export interface ValueSetDef {
+    resourceType: 'ValueSet';
+    url: string;
+    name?: string;
+    status?: string;
+    compose?: unknown;
+    expansion?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Minimal CodeSystem shape used by fhir-persistence.
+ */
+export interface CodeSystemDef {
+    resourceType: 'CodeSystem';
+    url: string;
+    name?: string;
+    status?: string;
+    content?: string;
+    concept?: Array<{
+        code: string;
+        display?: string;
+        definition?: string;
+        concept?: unknown[];
+    }>;
+    [key: string]: unknown;
+}
+/**
+ * Minimal SearchParameter shape used by fhir-persistence.
+ */
+export interface SearchParameterDef {
+    resourceType: 'SearchParameter';
+    url?: string;
+    name?: string;
+    code: string;
+    type: 'number' | 'date' | 'string' | 'token' | 'reference' | 'composite' | 'quantity' | 'uri' | 'special';
+    base: string[];
+    expression?: string;
+    target?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Loaded package metadata.
+ */
+export interface LoadedPackageDef {
+    name: string;
+    version: string;
+    loadedAt?: string;
+    resourceCount?: number;
+}
+/**
+ * Bridge interface for fhir-definition registry.
+ *
+ * fhir-persistence depends only on this interface, never on
+ * fhir-definition internal types. Implementations may wrap
+ * `InMemoryDefinitionRegistry` or provide test-only mocks.
+ *
+ * ADR-01 §2.3 — structural typing, no `implements` required.
+ */
+export interface DefinitionProvider {
+    /**
+     * Get a StructureDefinition by canonical URL.
+     */
+    getStructureDefinition(url: string): StructureDefinitionDef | undefined;
+    /**
+     * Get a ValueSet by canonical URL.
+     */
+    getValueSet(url: string): ValueSetDef | undefined;
+    /**
+     * Get a CodeSystem by canonical URL.
+     */
+    getCodeSystem(url: string): CodeSystemDef | undefined;
+    /**
+     * Get all SearchParameters for a specific resource type.
+     */
+    getSearchParameters(resourceType: string): SearchParameterDef[];
+    /**
+     * Enumerate all known resource types.
+     * Used by SchemaEngine and ReindexCLI to iterate over all tables.
+     */
+    getAllResourceTypes(): string[];
+    /**
+     * Get metadata about loaded packages (optional).
+     */
+    getLoadedPackages?(): LoadedPackageDef[];
+}
+//# sourceMappingURL=definition-provider.d.ts.map

package/dist/lib/providers/definition-provider.d.ts.map

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

package/dist/lib/providers/fhir-definition-provider.d.ts

@@ -0,0 +1,58 @@
+/**
+ * FhirDefinitionBridge — Real fhir-definition Integration
+ *
+ * Wraps the actual `fhir-definition` package's `DefinitionRegistry`
+ * (or `InMemoryDefinitionRegistry`) into the `DefinitionProvider`
+ * interface used by `FhirSystem`.
+ *
+ * This bridges fhir-definition's concrete types into our minimal
+ * structural types, maintaining the one-way dependency principle.
+ *
+ * ADR-01 §2.3: DefinitionProvider wraps fhir-definition, never
+ * exposing fhir-definition types to the rest of fhir-persistence.
+ *
+ * @module fhir-persistence/providers
+ */
+import type { DefinitionProvider, StructureDefinitionDef, ValueSetDef, CodeSystemDef, SearchParameterDef, LoadedPackageDef } from './definition-provider.js';
+/**
+ * Structural type matching fhir-definition's DefinitionRegistry.
+ * Uses `any` for return types to bridge between fhir-definition's
+ * concrete types and our minimal structural types.
+ */
+interface FhirDefinitionRegistry {
+    getStructureDefinition(url: string): any | undefined;
+    getValueSet(url: string): any | undefined;
+    getCodeSystem(url: string): any | undefined;
+    getSearchParameters(resourceType: string): any[];
+    listStructureDefinitions(): string[];
+    getLoadedPackages?(): any[];
+    getStatistics?(): any;
+}
+/**
+ * Bridges a fhir-definition DefinitionRegistry into our DefinitionProvider.
+ *
+ * Usage:
+ * ```typescript
+ * import { loadDefinitionPackages } from 'fhir-definition';
+ *
+ * const { registry } = await loadDefinitionPackages({ ... });
+ * const provider = new FhirDefinitionBridge(registry);
+ *
+ * // Use with FhirSystem
+ * const system = new FhirSystem(adapter);
+ * await system.initialize(provider);
+ * ```
+ */
+export declare class FhirDefinitionBridge implements DefinitionProvider {
+    private readonly registry;
+    private cachedResourceTypes;
+    constructor(registry: FhirDefinitionRegistry);
+    getStructureDefinition(url: string): StructureDefinitionDef | undefined;
+    getValueSet(url: string): ValueSetDef | undefined;
+    getCodeSystem(url: string): CodeSystemDef | undefined;
+    getSearchParameters(resourceType: string): SearchParameterDef[];
+    getAllResourceTypes(): string[];
+    getLoadedPackages(): LoadedPackageDef[];
+}
+export {};
+//# sourceMappingURL=fhir-definition-provider.d.ts.map

package/dist/lib/providers/fhir-definition-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fhir-definition-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/fhir-definition-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAMlC;;;;GAIG;AACH,UAAU,sBAAsB;IAE9B,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC;IAErD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC;IAE1C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC;IAE5C,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,GAAG,EAAE,CAAC;IACjD,wBAAwB,IAAI,MAAM,EAAE,CAAC;IAErC,iBAAiB,CAAC,IAAI,GAAG,EAAE,CAAC;IAE5B,aAAa,CAAC,IAAI,GAAG,CAAC;CACvB;AAMD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,oBAAqB,YAAW,kBAAkB;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,mBAAmB,CAAyB;gBAExC,QAAQ,EAAE,sBAAsB;IAQ5C,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAMvE,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAMjD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAMrD,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAc/D,mBAAmB,IAAI,MAAM,EAAE;IAkB/B,iBAAiB,IAAI,gBAAgB,EAAE;CAUxC"}

package/dist/lib/providers/fhir-runtime-provider.d.ts

@@ -0,0 +1,75 @@
+/**
+ * FhirRuntimeProvider — Real fhir-runtime Integration
+ *
+ * Wraps the actual `fhir-runtime` package's `extractSearchValues`,
+ * `extractAllSearchValues`, and `extractReferences` functions into
+ * the `RuntimeProvider` interface used by `IndexingPipeline`.
+ *
+ * This replaces the approximate `PropertyPathRuntimeProvider` with
+ * real FHIRPath evaluation for precise search value extraction.
+ *
+ * ADR-01 §4.1b: RuntimeProvider wraps fhir-runtime, never exposing
+ * fhir-runtime types to the rest of fhir-persistence.
+ *
+ * @module fhir-persistence/providers
+ */
+import type { SearchParameterDef } from './definition-provider.js';
+import type { RuntimeProvider, ExtractedReference } from './runtime-provider.js';
+/**
+ * Options for creating a FhirRuntimeProvider.
+ *
+ * Uses `any` for function signatures to bridge between fhir-runtime's
+ * narrow union types (e.g., SearchParamType) and our structural types.
+ * The conversion is handled internally by FhirRuntimeProvider.
+ */
+export interface FhirRuntimeProviderOptions {
+    /**
+     * The `extractSearchValues` function from fhir-runtime.
+     * Signature: (resource: Resource, searchParam: SearchParameter) => SearchIndexEntry
+     */
+    extractSearchValues: (resource: any, searchParam: any) => any;
+    /**
+     * The `extractAllSearchValues` function from fhir-runtime.
+     * Signature: (resource: Resource, searchParams: SearchParameter[]) => SearchIndexEntry[]
+     */
+    extractAllSearchValues: (resource: any, searchParams: any[]) => any[];
+    /**
+     * The `extractReferences` function from fhir-runtime.
+     * Signature: (resource: Resource) => ReferenceInfo[]
+     */
+    extractReferences: (resource: any) => any[];
+}
+export declare class FhirRuntimeProvider implements RuntimeProvider {
+    private readonly opts;
+    constructor(options: FhirRuntimeProviderOptions);
+    extractSearchValues(resource: Record<string, unknown>, params: SearchParameterDef[]): Record<string, unknown[]>;
+    extractReferences(resource: Record<string, unknown>, params: SearchParameterDef[]): ExtractedReference[];
+    /**
+     * Convert our minimal SearchParameterDef to fhir-runtime's SearchParameter shape.
+     */
+    private toRuntimeSearchParameter;
+    /**
+     * Normalize fhir-runtime SearchIndexValue[] to persistence-friendly unknown[].
+     */
+    private normalizeSearchValues;
+    /**
+     * Normalize token values to "system|code" strings.
+     */
+    private normalizeTokenValues;
+}
+/**
+ * Create a FhirRuntimeProvider from the fhir-runtime package.
+ *
+ * Usage:
+ * ```typescript
+ * import { extractSearchValues, extractAllSearchValues, extractReferences } from 'fhir-runtime';
+ *
+ * const provider = createFhirRuntimeProvider({
+ *   extractSearchValues,
+ *   extractAllSearchValues,
+ *   extractReferences,
+ * });
+ * ```
+ */
+export declare function createFhirRuntimeProvider(options: FhirRuntimeProviderOptions): FhirRuntimeProvider;
+//# sourceMappingURL=fhir-runtime-provider.d.ts.map

package/dist/lib/providers/fhir-runtime-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fhir-runtime-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/fhir-runtime-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAuCjF;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IAEH,mBAAmB,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,KAAK,GAAG,CAAC;IAE9D;;;OAGG;IAEH,sBAAsB,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,CAAC;IAEtE;;;OAGG;IAEH,iBAAiB,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,GAAG,EAAE,CAAC;CAC7C;AAED,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;gBAEtC,OAAO,EAAE,0BAA0B;IAQ/C,mBAAmB,CACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,kBAAkB,EAAE,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IA8B5B,iBAAiB,CACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,kBAAkB,EAAE,GAC3B,kBAAkB,EAAE;IA6CvB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAchC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8B7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAY7B;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,mBAAmB,CAErB"}

package/dist/lib/providers/in-memory-definition-provider.d.ts

@@ -0,0 +1,72 @@
+/**
+ * InMemoryDefinitionProvider — Test/Development Implementation
+ *
+ * Stores StructureDefinitions, SearchParameters, ValueSets, and CodeSystems
+ * in memory. Useful for:
+ *
+ * - Unit tests (no IG package loading required)
+ * - Development (quick iteration without fhir-definition dependency)
+ * - Integration tests with controlled definition sets
+ *
+ * @module fhir-persistence/providers
+ */
+import type { DefinitionProvider, StructureDefinitionDef, ValueSetDef, CodeSystemDef, SearchParameterDef, LoadedPackageDef } from './definition-provider.js';
+export declare class InMemoryDefinitionProvider implements DefinitionProvider {
+    private readonly structureDefinitions;
+    private readonly valueSets;
+    private readonly codeSystems;
+    private readonly searchParams;
+    private readonly resourceTypes;
+    private readonly packages;
+    getStructureDefinition(url: string): StructureDefinitionDef | undefined;
+    getValueSet(url: string): ValueSetDef | undefined;
+    getCodeSystem(url: string): CodeSystemDef | undefined;
+    getSearchParameters(resourceType: string): SearchParameterDef[];
+    getAllResourceTypes(): string[];
+    getLoadedPackages(): LoadedPackageDef[];
+    /**
+     * Register a StructureDefinition.
+     */
+    addStructureDefinition(sd: StructureDefinitionDef): void;
+    /**
+     * Register a SearchParameter for one or more resource types.
+     */
+    addSearchParameter(sp: SearchParameterDef): void;
+    /**
+     * Register a ValueSet.
+     */
+    addValueSet(vs: ValueSetDef): void;
+    /**
+     * Register a CodeSystem.
+     */
+    addCodeSystem(cs: CodeSystemDef): void;
+    /**
+     * Register a loaded package (metadata only).
+     */
+    addPackage(pkg: LoadedPackageDef): void;
+    /**
+     * Bulk-load SearchParameters from a FHIR Bundle-like structure.
+     * Compatible with SearchParameterRegistry.indexBundle() input format.
+     */
+    indexBundle(bundle: {
+        resourceType: 'Bundle';
+        entry?: Array<{
+            resource?: SearchParameterDef;
+        }>;
+    }): void;
+    /**
+     * Clear all stored definitions.
+     */
+    clear(): void;
+    /**
+     * Get statistics about stored definitions.
+     */
+    getStatistics(): {
+        structureDefinitions: number;
+        searchParameters: number;
+        valueSets: number;
+        codeSystems: number;
+        resourceTypes: number;
+    };
+}
+//# sourceMappingURL=in-memory-definition-provider.d.ts.map

package/dist/lib/providers/in-memory-definition-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-definition-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/in-memory-definition-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAMlC,qBAAa,0BAA2B,YAAW,kBAAkB;IACnE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6C;IAClF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2C;IACxE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IAMnD,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAIvE,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIjD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIrD,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAI/D,mBAAmB,IAAI,MAAM,EAAE;IAI/B,iBAAiB,IAAI,gBAAgB,EAAE;IAQvC;;OAEG;IACH,sBAAsB,CAAC,EAAE,EAAE,sBAAsB,GAAG,IAAI;IAQxD;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI;IAYhD;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI;IAIlC;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IAIvC;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE;QAClB,YAAY,EAAE,QAAQ,CAAC;QACvB,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,QAAQ,CAAC,EAAE,kBAAkB,CAAA;SAAE,CAAC,CAAC;KAClD,GAAG,IAAI;IASR;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,aAAa,IAAI;QACf,oBAAoB,EAAE,MAAM,CAAC;QAC7B,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB;CAaF"}

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

@@ -0,0 +1,13 @@
+/**
+ * Providers — Bridge interfaces for upstream packages
+ *
+ * @module fhir-persistence/providers
+ */
+export type { DefinitionProvider, StructureDefinitionDef, ValueSetDef, CodeSystemDef, SearchParameterDef, LoadedPackageDef, } from './definition-provider.js';
+export { InMemoryDefinitionProvider } from './in-memory-definition-provider.js';
+export type { RuntimeProvider, ExtractedReference, ValidationResult, ValidationIssue, } from './runtime-provider.js';
+export { PropertyPathRuntimeProvider } from './property-path-runtime-provider.js';
+export { FhirRuntimeProvider, createFhirRuntimeProvider } from './fhir-runtime-provider.js';
+export type { FhirRuntimeProviderOptions } from './fhir-runtime-provider.js';
+export { FhirDefinitionBridge } from './fhir-definition-provider.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAGhF,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAGlF,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5F,YAAY,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAG7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/lib/providers/property-path-runtime-provider.d.ts

@@ -0,0 +1,34 @@
+/**
+ * PropertyPathRuntimeProvider — Approximate RuntimeProvider Implementation
+ *
+ * Uses `extractPropertyPath` + `getNestedValues` from row-indexer to
+ * approximate FHIRPath evaluation. This is the v1-compatible fallback
+ * when a real fhir-runtime instance is not available.
+ *
+ * Limitations (compared to real FHIRPath):
+ * - Cannot evaluate `.as(X)` polymorphic type casts correctly
+ * - Cannot evaluate `.where(resolve() is X)` predicates
+ * - Cannot evaluate complex FHIRPath functions (iif, ofType, etc.)
+ * - Reference path detection is heuristic-based
+ *
+ * @module fhir-persistence/providers
+ */
+import type { SearchParameterDef } from './definition-provider.js';
+import type { RuntimeProvider, ExtractedReference } from './runtime-provider.js';
+export declare class PropertyPathRuntimeProvider implements RuntimeProvider {
+    extractSearchValues(resource: Record<string, unknown>, params: SearchParameterDef[]): Record<string, unknown[]>;
+    extractReferences(resource: Record<string, unknown>, params: SearchParameterDef[]): ExtractedReference[];
+    /**
+     * Normalize extracted values based on the SearchParameter type.
+     */
+    private normalizeValues;
+    /**
+     * Extract a reference string from a FHIR Reference value.
+     */
+    private extractReferenceFromValue;
+    /**
+     * Extract token values as system|code strings from various FHIR structures.
+     */
+    private extractTokenValues;
+}
+//# sourceMappingURL=property-path-runtime-provider.d.ts.map

package/dist/lib/providers/property-path-runtime-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-path-runtime-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/property-path-runtime-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAOjF,qBAAa,2BAA4B,YAAW,eAAe;IAMjE,mBAAmB,CACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,kBAAkB,EAAE,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IA4B5B,iBAAiB,CACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,kBAAkB,EAAE,GAC3B,kBAAkB,EAAE;IAoCvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAwBvB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IASjC;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAmD3B"}

package/dist/lib/providers/runtime-provider.d.ts

@@ -0,0 +1,84 @@
+/**
+ * RuntimeProvider — Bridge Interface for fhir-runtime
+ *
+ * Abstracts the `fhir-runtime` capabilities so that `fhir-persistence`
+ * never imports `fhir-runtime` types directly. This enables:
+ *
+ * - Testing with property-path approximation (no FHIRPath engine)
+ * - Swapping to real fhir-runtime when available
+ * - Structural typing compatibility (duck typing)
+ *
+ * ADR-01 §4.1b: RuntimeProvider interface contract.
+ *
+ * @module fhir-persistence/providers
+ */
+import type { SearchParameterDef } from './definition-provider.js';
+/**
+ * A reference extracted from a FHIR resource.
+ */
+export interface ExtractedReference {
+    /** The SearchParameter code (e.g., 'subject', 'performer'). */
+    code: string;
+    /** The full reference string (e.g., 'Patient/123'). */
+    reference: string;
+    /** The target resource type (e.g., 'Patient'). */
+    targetType: string;
+    /** The target resource ID (e.g., '123'). */
+    targetId: string;
+}
+/**
+ * Result of resource validation.
+ */
+export interface ValidationResult {
+    valid: boolean;
+    issues: ValidationIssue[];
+}
+/**
+ * A single validation issue.
+ */
+export interface ValidationIssue {
+    severity: 'error' | 'warning' | 'information';
+    message: string;
+    path?: string;
+}
+/**
+ * Bridge interface for fhir-runtime.
+ *
+ * fhir-persistence depends only on this interface, never on
+ * fhir-runtime internal types. Implementations may wrap
+ * a real `FhirRuntimeInstance` or provide test-only approximations.
+ *
+ * ADR-01 §4.1b — structural typing, no `implements` required.
+ */
+export interface RuntimeProvider {
+    /**
+     * Extract search parameter values from a resource.
+     *
+     * Real implementation uses FHIRPath evaluation via fhir-runtime.
+     * Test implementation uses extractPropertyPath approximation.
+     *
+     * @param resource - The FHIR resource to extract values from.
+     * @param params - SearchParameter definitions to extract.
+     * @returns Map of param code → extracted values.
+     */
+    extractSearchValues(resource: Record<string, unknown>, params: SearchParameterDef[]): Record<string, unknown[]>;
+    /**
+     * Extract all outgoing references from a resource.
+     *
+     * Real implementation uses fhir-runtime's reference extractor
+     * based on StructureDefinition knowledge.
+     * Test implementation scans JSON for `.reference` fields.
+     *
+     * @param resource - The FHIR resource to scan.
+     * @param params - Reference-type SearchParameters (used for code mapping).
+     * @returns Array of extracted references with targetType/targetId.
+     */
+    extractReferences(resource: Record<string, unknown>, params: SearchParameterDef[]): ExtractedReference[];
+    /**
+     * Validate a resource against a profile (optional capability).
+     *
+     * Not all implementations support validation. Check existence before calling.
+     */
+    validate?(resource: Record<string, unknown>, profileUrl?: string): Promise<ValidationResult>;
+}
+//# sourceMappingURL=runtime-provider.d.ts.map

package/dist/lib/providers/runtime-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/runtime-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAMnE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,aAAa,CAAC;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;OASG;IACH,mBAAmB,CACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,kBAAkB,EAAE,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAE7B;;;;;;;;;;OAUG;IACH,iBAAiB,CACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,kBAAkB,EAAE,GAC3B,kBAAkB,EAAE,CAAC;IAExB;;;;OAIG;IACH,QAAQ,CAAC,CACP,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B"}

package/dist/lib/registry/element-cardinality.d.ts

@@ -0,0 +1,15 @@
+/**
+ * FHIR R4 element cardinality map — auto-generated.
+ *
+ * Contains element paths where max != "1" (i.e., the element is an array).
+ * If a path is NOT in this set, it is assumed to be scalar (max = "1").
+ *
+ * Generated from 256 StructureDefinitions, 3119 array paths.
+ * DO NOT EDIT MANUALLY — regenerate with: npx tsx scripts/generate-cardinality-map.ts
+ */
+/**
+ * Set of FHIR element paths that have max cardinality != "1".
+ * Format: "ResourceType.property" or "ResourceType.backbone.property"
+ */
+export declare const ARRAY_ELEMENT_PATHS: ReadonlySet<string>;
+//# sourceMappingURL=element-cardinality.d.ts.map

package/dist/lib/registry/element-cardinality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-cardinality.d.ts","sourceRoot":"","sources":["../../../src/registry/element-cardinality.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAgjGlD,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Registry module — barrel exports
+ *
+ * @module fhir-persistence/registry
+ */
+export { StructureDefinitionRegistry } from './structure-definition-registry.js';
+export type { CanonicalProfile } from './structure-definition-registry.js';
+export { SearchParameterRegistry } from './search-parameter-registry.js';
+export type { SearchParamType, SearchStrategy, SearchColumnType, SearchParameterImpl, SearchParameterResource, SearchParameterBundle, } from './search-parameter-registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,YAAY,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAG3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,YAAY,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,gCAAgC,CAAC"}

package/dist/lib/registry/package-registry-repo.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Package Registry Repository — v2
+ *
+ * Tracks installed FHIR IG packages (name, version, checksum) in
+ * the `_packages` table. Used by IGPersistenceManager to detect
+ * new/upgrade/consistent state via checksum comparison.
+ *
+ * Key design decisions:
+ * - Uses StorageAdapter (not DatabaseClient)
+ * - `?` placeholders for SQLite compatibility
+ * - Stores serialized ResourceTableSet[] as `schema_snapshot` for SchemaDiff
+ * - Checksum is a hash of the package content (e.g., SHA-256)
+ *
+ * @module fhir-persistence/registry
+ */
+import type { StorageAdapter } from '../db/adapter.js';
+export type PackageStatus = 'active' | 'superseded';
+export interface InstalledPackage {
+    /** Package name (e.g., "hl7.fhir.r4.core"). */
+    name: string;
+    /** Package version (e.g., "4.0.1"). */
+    version: string;
+    /** Content checksum for change detection. */
+    checksum: string;
+    /** Serialized ResourceTableSet[] JSON for SchemaDiff. */
+    schemaSnapshot: string | null;
+    /** When this package was installed/updated. */
+    installedAt: string;
+    /** Package status: active or superseded. */
+    status: PackageStatus;
+}
+export interface SchemaVersionRecord {
+    /** Auto-incrementing version number. */
+    version: number;
+    /** JSON snapshot of active package names+versions at this schema version. */
+    packageList: string;
+    /** Description of the schema change. */
+    description: string;
+    /** When this schema version was applied. */
+    appliedAt: string;
+}
+export declare class PackageRegistryRepo {
+    private readonly adapter;
+    constructor(adapter: StorageAdapter);
+    /**
+     * Ensure the packages tracking table exists.
+     */
+    ensureTable(): Promise<void>;
+    /**
+     * Get the active version of a package by name.
+     */
+    getPackage(name: string): Promise<InstalledPackage | undefined>;
+    /**
+     * Get all installed packages (all statuses).
+     */
+    getInstalledPackages(): Promise<InstalledPackage[]>;
+    /**
+     * Get only active packages.
+     */
+    getActivePackages(): Promise<InstalledPackage[]>;
+    /**
+     * Register a package version.
+     *
+     * When a new version is registered for the same package name:
+     * 1. Previous active versions are marked as 'superseded'
+     * 2. The new version is inserted as 'active'
+     * 3. A schema_version record is created with the package_list snapshot
+     */
+    registerPackage(pkg: Omit<InstalledPackage, 'installedAt' | 'status'>, description?: string): Promise<void>;
+    /**
+     * Insert or update a package record (backward-compatible).
+     *
+     * Uses INSERT OR REPLACE (SQLite UPSERT) to handle both new and upgraded packages.
+     */
+    upsertPackage(pkg: Omit<InstalledPackage, 'installedAt' | 'status'>): Promise<void>;
+    /**
+     * Remove all versions of a package.
+     */
+    removePackage(name: string): Promise<void>;
+    /**
+     * Check if a package needs update by comparing checksums.
+     *
+     * Returns:
+     * - 'new' if the package is not installed (no active version)
+     * - 'upgrade' if the checksum differs
+     * - 'consistent' if the checksum matches
+     */
+    checkStatus(name: string, checksum: string): Promise<'new' | 'upgrade' | 'consistent'>;
+    /**
+     * Ensure the schema version table exists.
+     */
+    ensureSchemaVersionTable(): Promise<void>;
+    /**
+     * Record a schema version with the current active package list.
+     */
+    recordSchemaVersion(description: string): Promise<void>;
+    /**
+     * Get all schema version records.
+     */
+    getSchemaVersions(): Promise<SchemaVersionRecord[]>;
+    /**
+     * Get the latest schema version record.
+     */
+    getLatestSchemaVersion(): Promise<SchemaVersionRecord | undefined>;
+}
+//# sourceMappingURL=package-registry-repo.d.ts.map

package/dist/lib/registry/package-registry-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-registry-repo.d.ts","sourceRoot":"","sources":["../../../src/registry/package-registry-repo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMvD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB;AAmCD,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAQrE;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAOzD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAOtD;;;;;;;OAOG;IACG,eAAe,CACnB,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,QAAQ,CAAC,EACrD,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAmBhB;;;;OAIG;IACG,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAezF;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD;;;;;;;OAOG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,GAAG,YAAY,CAAC;IAW5F;;OAEG;IACG,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/C;;OAEG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB7D;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAOzD;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;CAMzE"}