fhir-persistence 0.6.0 → 0.7.0

package/dist/index.d.ts

@@ -331,6 +331,14 @@ declare interface BundleLink {
     url: string;
 }
 
+export declare interface CachedExpansion {
+    valuesetUrl: string;
+    version: string;
+    expandedAt: string;
+    codeCount: number;
+    expansionJson: string;
+}
+
 /**
  * StructureDefinition Registry
  *
@@ -425,6 +433,34 @@ export declare interface ColumnSchema {
  */
 export declare function compareSchemas(oldSets: ResourceTableSet[], newSets: ResourceTableSet[]): SchemaDelta[];
 
+export declare interface ConceptHierarchyEntry {
+    id: string;
+    codeSystemUrl: string;
+    codeSystemVersion?: string;
+    code: string;
+    display?: string;
+    parentCode?: string;
+    level: number;
+}
+
+export declare class ConceptHierarchyRepo {
+    private readonly adapter;
+    private readonly dialect;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect);
+    ensureTable(): Promise<void>;
+    /** Batch insert hierarchical concept entries. */
+    batchInsert(entries: ConceptHierarchyEntry[]): Promise<number>;
+    /** Get all concepts for a CodeSystem (tree order by level). */
+    getTree(codeSystemUrl: string): Promise<ConceptHierarchyEntry[]>;
+    /** Get direct children of a concept. */
+    getChildren(codeSystemUrl: string, parentCode: string): Promise<ConceptHierarchyEntry[]>;
+    /** Lookup a single concept by code. */
+    lookup(codeSystemUrl: string, code: string): Promise<ConceptHierarchyEntry | undefined>;
+    /** Remove all concepts for a CodeSystem. */
+    removeByCodeSystem(codeSystemUrl: string): Promise<void>;
+    private mapRow;
+}
+
 /**
  * Definition of a PostgreSQL table constraint.
  */
@@ -538,6 +574,36 @@ export declare const DELETED_SCHEMA_VERSION = -1;
 
 export declare type DeltaKind = 'ADD_TABLE' | 'DROP_TABLE' | 'ADD_COLUMN' | 'DROP_COLUMN' | 'ALTER_COLUMN' | 'ADD_INDEX' | 'DROP_INDEX' | 'REINDEX';
 
+export declare interface ElementIndexEntry {
+    id: string;
+    structureId: string;
+    path: string;
+    min?: number;
+    max?: string;
+    typeCodes?: string[];
+    isSlice?: boolean;
+    sliceName?: string;
+    isExtension?: boolean;
+    bindingValueSet?: string;
+    mustSupport?: boolean;
+}
+
+export declare class ElementIndexRepo {
+    private readonly adapter;
+    private readonly dialect;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect);
+    ensureTable(): Promise<void>;
+    /** Batch insert element index entries for a StructureDefinition. */
+    batchInsert(structureId: string, elements: Omit<ElementIndexEntry, 'structureId'>[]): Promise<number>;
+    /** Get all elements for a StructureDefinition. */
+    getByStructureId(structureId: string): Promise<ElementIndexEntry[]>;
+    /** Search elements by path pattern (LIKE). */
+    searchByPath(pathPattern: string): Promise<ElementIndexEntry[]>;
+    /** Remove all element indexes for a StructureDefinition. */
+    removeByStructureId(structureId: string): Promise<void>;
+    private mapRow;
+}
+
 /**
  * Eviction policy for the cache.
  *
@@ -560,6 +626,21 @@ export declare function executeSearch(adapter: StorageAdapter, request: SearchRe
     dialect?: SqlDialect;
 }): Promise<SearchResult_2>;
 
+export declare class ExpansionCacheRepo {
+    private readonly adapter;
+    private readonly dialect;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect);
+    ensureTable(): Promise<void>;
+    /** Write or update an expansion cache entry. */
+    upsert(url: string, version: string, expansionJson: string, codeCount: number): Promise<void>;
+    /** Get a cached expansion by URL and version. */
+    get(url: string, version: string): Promise<CachedExpansion | undefined>;
+    /** Invalidate a specific expansion cache entry. */
+    invalidate(url: string, version: string): Promise<void>;
+    /** Clear all expansion caches. */
+    clear(): Promise<void>;
+}
+
 /**
  * A reference extracted from a FHIR resource.
  */
@@ -607,6 +688,14 @@ export declare function extractPropertyPath(expression: string, resourceType: st
  */
 export declare function extractReferencesV2(resource: FhirResource, impls: SearchParameterImpl[]): ReferenceRowV2[];
 
+/** A minimal FHIR Bundle shape for IG import. */
+declare interface FhirBundle {
+    resourceType: 'Bundle';
+    entry?: Array<{
+        resource?: Record<string, unknown>;
+    }>;
+}
+
 /**
  * Bridges a fhir-definition DefinitionRegistry into our DefinitionProvider.
  *
@@ -1055,6 +1144,57 @@ export declare interface HistoryTableSchema {
     indexes: IndexSchema[];
 }
 
+export declare interface IGImportOptions {
+    /** Extract element index rows from a StructureDefinition (from fhir-runtime). */
+    extractElementIndex?: (sd: Record<string, unknown>) => Omit<ElementIndexEntry, 'structureId'>[];
+    /** Extract SD dependencies (from fhir-runtime). */
+    extractDependencies?: (sd: Record<string, unknown>) => string[];
+    /** Flatten concept hierarchy from a CodeSystem (from fhir-runtime). */
+    flattenConcepts?: (cs: Record<string, unknown>) => ConceptHierarchyEntry[];
+}
+
+export declare class IGImportOrchestrator {
+    private readonly resourceMapRepo;
+    private readonly sdIndexRepo;
+    private readonly elementIndexRepo;
+    private readonly expansionCacheRepo;
+    private readonly conceptRepo;
+    private readonly spIndexRepo;
+    private readonly opts;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect, options?: IGImportOptions);
+    /** Ensure all conformance tables exist. */
+    ensureAllTables(): Promise<void>;
+    /** Execute a complete IG import from a FHIR Bundle. */
+    importIG(igId: string, bundle: FhirBundle): Promise<IGImportResult>;
+    /** Get individual repos for direct access. */
+    get repos(): {
+        resourceMap: IGResourceMapRepo;
+        sdIndex: SDIndexRepo;
+        elementIndex: ElementIndexRepo;
+        expansionCache: ExpansionCacheRepo;
+        conceptHierarchy: ConceptHierarchyRepo;
+        searchParamIndex: SearchParamIndexRepo;
+    };
+}
+
+export declare interface IGImportResult {
+    igId: string;
+    resourceCount: number;
+    sdIndexCount: number;
+    elementIndexCount: number;
+    conceptCount: number;
+    spIndexCount: number;
+    errors: string[];
+}
+
+export declare interface IGIndex {
+    profiles: IGResourceMapEntry[];
+    extensions: IGResourceMapEntry[];
+    valueSets: IGResourceMapEntry[];
+    codeSystems: IGResourceMapEntry[];
+    searchParameters: IGResourceMapEntry[];
+}
+
 declare type IGInitAction = 'new' | 'upgrade' | 'consistent';
 
 declare interface IGInitResult {
@@ -1100,6 +1240,30 @@ export declare class IGPersistenceManager {
     initialize(input: IGPackageInput): Promise<IGInitResult>;
 }
 
+export declare interface IGResourceMapEntry {
+    igId: string;
+    resourceType: string;
+    resourceId: string;
+    resourceUrl?: string;
+    resourceName?: string;
+    baseType?: string;
+}
+
+export declare class IGResourceMapRepo {
+    private readonly adapter;
+    private readonly dialect;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect);
+    ensureTable(): Promise<void>;
+    /** Batch insert resource map entries for an IG. */
+    batchInsert(igId: string, entries: Omit<IGResourceMapEntry, 'igId'>[]): Promise<number>;
+    /** Get grouped IG index. */
+    getIGIndex(igId: string): Promise<IGIndex>;
+    /** Get resources of a specific type within an IG. */
+    getByType(igId: string, resourceType: string): Promise<IGResourceMapEntry[]>;
+    /** Remove all resource mappings for an IG. */
+    removeIG(igId: string): Promise<void>;
+}
+
 /**
  * A parsed `_include` or `_revinclude` target.
  *
@@ -2288,6 +2452,32 @@ declare interface SchemaVersionRecord {
     appliedAt: string;
 }
 
+export declare interface SDIndexEntry {
+    id: string;
+    url?: string;
+    version?: string;
+    type?: string;
+    kind?: string;
+    baseDefinition?: string;
+    derivation?: string;
+    snapshotHash?: string;
+}
+
+export declare class SDIndexRepo {
+    private readonly adapter;
+    private readonly dialect;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect);
+    ensureTable(): Promise<void>;
+    upsert(entry: SDIndexEntry): Promise<void>;
+    batchUpsert(entries: SDIndexEntry[]): Promise<number>;
+    getById(id: string): Promise<SDIndexEntry | undefined>;
+    getByUrl(url: string): Promise<SDIndexEntry[]>;
+    getByType(type: string): Promise<SDIndexEntry[]>;
+    getByBaseDefinition(baseUrl: string): Promise<SDIndexEntry[]>;
+    remove(id: string): Promise<void>;
+    private mapRow;
+}
+
 /**
  * All valid search prefixes.
  */
@@ -2563,6 +2753,30 @@ export declare interface SearchParameterResource {
     target?: string[];
 }
 
+export declare interface SearchParamIndexEntry {
+    id: string;
+    igId: string;
+    url?: string;
+    code: string;
+    type: string;
+    base: string[];
+    expression?: string;
+}
+
+export declare class SearchParamIndexRepo {
+    private readonly adapter;
+    private readonly dialect;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect);
+    ensureTable(): Promise<void>;
+    upsert(entry: SearchParamIndexEntry): Promise<void>;
+    batchUpsert(entries: SearchParamIndexEntry[]): Promise<number>;
+    getByIG(igId: string): Promise<SearchParamIndexEntry[]>;
+    getByCode(code: string): Promise<SearchParamIndexEntry[]>;
+    remove(id: string): Promise<void>;
+    removeByIG(igId: string): Promise<void>;
+    private mapRow;
+}
+
 /**
  * Metadata for a search parameter, preserved for SchemaDiff.
  */

package/dist/lib/conformance/concept-hierarchy-repo.d.ts

@@ -0,0 +1,38 @@
+/**
+ * CodeSystem Concept Hierarchy Repository (P5)
+ *
+ * Manages the `code_system_concept` table for hierarchical concept
+ * storage. Supports parent-child relationships, tree queries,
+ * and CodeSystem-level cleanup.
+ *
+ * @module fhir-persistence/conformance
+ */
+import type { StorageAdapter } from '../db/adapter.js';
+import type { DDLDialect } from '../schema/ddl-generator.js';
+export interface ConceptHierarchyEntry {
+    id: string;
+    codeSystemUrl: string;
+    codeSystemVersion?: string;
+    code: string;
+    display?: string;
+    parentCode?: string;
+    level: number;
+}
+export declare class ConceptHierarchyRepo {
+    private readonly adapter;
+    private readonly dialect;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect);
+    ensureTable(): Promise<void>;
+    /** Batch insert hierarchical concept entries. */
+    batchInsert(entries: ConceptHierarchyEntry[]): Promise<number>;
+    /** Get all concepts for a CodeSystem (tree order by level). */
+    getTree(codeSystemUrl: string): Promise<ConceptHierarchyEntry[]>;
+    /** Get direct children of a concept. */
+    getChildren(codeSystemUrl: string, parentCode: string): Promise<ConceptHierarchyEntry[]>;
+    /** Lookup a single concept by code. */
+    lookup(codeSystemUrl: string, code: string): Promise<ConceptHierarchyEntry | undefined>;
+    /** Remove all concepts for a CodeSystem. */
+    removeByCodeSystem(codeSystemUrl: string): Promise<void>;
+    private mapRow;
+}
+//# sourceMappingURL=concept-hierarchy-repo.d.ts.map

package/dist/lib/conformance/concept-hierarchy-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept-hierarchy-repo.d.ts","sourceRoot":"","sources":["../../../src/conformance/concept-hierarchy-repo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAM7D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AA4BD,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,UAAqB;IAG3C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAOlC,iDAAiD;IAC3C,WAAW,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBpE,+DAA+D;IACzD,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAStE,wCAAwC;IAClC,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAS9F,uCAAuC;IACjC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAS7F,4CAA4C;IACtC,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D,OAAO,CAAC,MAAM;CAWf"}

package/dist/lib/conformance/element-index-repo.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Element Index Repository (P3)
+ *
+ * Manages the `structure_element_index` table for fast element-level
+ * queries across StructureDefinitions. Supports batch insertion,
+ * path-based search, and SD-level cleanup.
+ *
+ * @module fhir-persistence/conformance
+ */
+import type { StorageAdapter } from '../db/adapter.js';
+import type { DDLDialect } from '../schema/ddl-generator.js';
+export interface ElementIndexEntry {
+    id: string;
+    structureId: string;
+    path: string;
+    min?: number;
+    max?: string;
+    typeCodes?: string[];
+    isSlice?: boolean;
+    sliceName?: string;
+    isExtension?: boolean;
+    bindingValueSet?: string;
+    mustSupport?: boolean;
+}
+export declare class ElementIndexRepo {
+    private readonly adapter;
+    private readonly dialect;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect);
+    ensureTable(): Promise<void>;
+    /** Batch insert element index entries for a StructureDefinition. */
+    batchInsert(structureId: string, elements: Omit<ElementIndexEntry, 'structureId'>[]): Promise<number>;
+    /** Get all elements for a StructureDefinition. */
+    getByStructureId(structureId: string): Promise<ElementIndexEntry[]>;
+    /** Search elements by path pattern (LIKE). */
+    searchByPath(pathPattern: string): Promise<ElementIndexEntry[]>;
+    /** Remove all element indexes for a StructureDefinition. */
+    removeByStructureId(structureId: string): Promise<void>;
+    private mapRow;
+}
+//# sourceMappingURL=element-index-repo.d.ts.map

package/dist/lib/conformance/element-index-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-index-repo.d.ts","sourceRoot":"","sources":["../../../src/conformance/element-index-repo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAM7D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAmDD,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,UAAqB;IAG3C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAOlC,oEAAoE;IAC9D,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAuB3G,kDAAkD;IAC5C,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IASzE,8CAA8C;IACxC,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IASrE,4DAA4D;IACtD,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7D,OAAO,CAAC,MAAM;CAkBf"}

package/dist/lib/conformance/expansion-cache-repo.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ValueSet Expansion Cache Repository (P4)
+ *
+ * Manages the `value_set_expansion` table for caching ValueSet expansion
+ * results. Supports upsert, lookup, invalidation, and bulk clear.
+ *
+ * @module fhir-persistence/conformance
+ */
+import type { StorageAdapter } from '../db/adapter.js';
+import type { DDLDialect } from '../schema/ddl-generator.js';
+export interface CachedExpansion {
+    valuesetUrl: string;
+    version: string;
+    expandedAt: string;
+    codeCount: number;
+    expansionJson: string;
+}
+export declare class ExpansionCacheRepo {
+    private readonly adapter;
+    private readonly dialect;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect);
+    ensureTable(): Promise<void>;
+    /** Write or update an expansion cache entry. */
+    upsert(url: string, version: string, expansionJson: string, codeCount: number): Promise<void>;
+    /** Get a cached expansion by URL and version. */
+    get(url: string, version: string): Promise<CachedExpansion | undefined>;
+    /** Invalidate a specific expansion cache entry. */
+    invalidate(url: string, version: string): Promise<void>;
+    /** Clear all expansion caches. */
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=expansion-cache-repo.d.ts.map

package/dist/lib/conformance/expansion-cache-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expansion-cache-repo.d.ts","sourceRoot":"","sources":["../../../src/conformance/expansion-cache-repo.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAM7D,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AA6BD,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,UAAqB;IAG3C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC,gDAAgD;IAC1C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnG,iDAAiD;IAC3C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAmB7E,mDAAmD;IAC7C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7D,kCAAkC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/lib/conformance/ig-import-orchestrator.d.ts

@@ -0,0 +1,69 @@
+/**
+ * IG Import Orchestrator (B2)
+ *
+ * Coordinates all conformance repositories to execute a complete
+ * IG import pipeline. Accepts optional fhir-runtime extraction
+ * functions for element indexing, SD dependency extraction, and
+ * concept hierarchy flattening.
+ *
+ * @module fhir-persistence/conformance
+ */
+import type { StorageAdapter } from '../db/adapter.js';
+import type { DDLDialect } from '../schema/ddl-generator.js';
+import { IGResourceMapRepo } from './ig-resource-map-repo.js';
+import { SDIndexRepo } from './sd-index-repo.js';
+import { ElementIndexRepo } from './element-index-repo.js';
+import type { ElementIndexEntry } from './element-index-repo.js';
+import { ExpansionCacheRepo } from './expansion-cache-repo.js';
+import { ConceptHierarchyRepo } from './concept-hierarchy-repo.js';
+import type { ConceptHierarchyEntry } from './concept-hierarchy-repo.js';
+import { SearchParamIndexRepo } from './search-param-index-repo.js';
+/** A minimal FHIR Bundle shape for IG import. */
+interface FhirBundle {
+    resourceType: 'Bundle';
+    entry?: Array<{
+        resource?: Record<string, unknown>;
+    }>;
+}
+export interface IGImportOptions {
+    /** Extract element index rows from a StructureDefinition (from fhir-runtime). */
+    extractElementIndex?: (sd: Record<string, unknown>) => Omit<ElementIndexEntry, 'structureId'>[];
+    /** Extract SD dependencies (from fhir-runtime). */
+    extractDependencies?: (sd: Record<string, unknown>) => string[];
+    /** Flatten concept hierarchy from a CodeSystem (from fhir-runtime). */
+    flattenConcepts?: (cs: Record<string, unknown>) => ConceptHierarchyEntry[];
+}
+export interface IGImportResult {
+    igId: string;
+    resourceCount: number;
+    sdIndexCount: number;
+    elementIndexCount: number;
+    conceptCount: number;
+    spIndexCount: number;
+    errors: string[];
+}
+export declare class IGImportOrchestrator {
+    private readonly resourceMapRepo;
+    private readonly sdIndexRepo;
+    private readonly elementIndexRepo;
+    private readonly expansionCacheRepo;
+    private readonly conceptRepo;
+    private readonly spIndexRepo;
+    private readonly opts;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect, options?: IGImportOptions);
+    /** Ensure all conformance tables exist. */
+    ensureAllTables(): Promise<void>;
+    /** Execute a complete IG import from a FHIR Bundle. */
+    importIG(igId: string, bundle: FhirBundle): Promise<IGImportResult>;
+    /** Get individual repos for direct access. */
+    get repos(): {
+        resourceMap: IGResourceMapRepo;
+        sdIndex: SDIndexRepo;
+        elementIndex: ElementIndexRepo;
+        expansionCache: ExpansionCacheRepo;
+        conceptHierarchy: ConceptHierarchyRepo;
+        searchParamIndex: SearchParamIndexRepo;
+    };
+}
+export {};
+//# sourceMappingURL=ig-import-orchestrator.d.ts.map

package/dist/lib/conformance/ig-import-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ig-import-orchestrator.d.ts","sourceRoot":"","sources":["../../../src/conformance/ig-import-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAOpE,iDAAiD;AACjD,UAAU,UAAU;IAClB,YAAY,EAAE,QAAQ,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,EAAE,CAAC;IAChG,mDAAmD;IACnD,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;IAChE,uEAAuE;IACvE,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,qBAAqB,EAAE,CAAC;CAC5E;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoB;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;gBAGrC,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,UAAqB,EAC9B,OAAO,CAAC,EAAE,eAAe;IAW3B,2CAA2C;IACrC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAStC,uDAAuD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC;IAkHzE,8CAA8C;IAC9C,IAAI,KAAK;;;;;;;MASR;CACF"}

package/dist/lib/conformance/ig-resource-map-repo.d.ts

@@ -0,0 +1,41 @@
+/**
+ * IG Resource Map Repository (P1)
+ *
+ * Manages the `ig_resource_map` table which tracks which FHIR resources
+ * belong to which Implementation Guide. Supports batch insertion,
+ * grouped queries, and IG-level cleanup.
+ *
+ * @module fhir-persistence/conformance
+ */
+import type { StorageAdapter } from '../db/adapter.js';
+import type { DDLDialect } from '../schema/ddl-generator.js';
+export interface IGResourceMapEntry {
+    igId: string;
+    resourceType: string;
+    resourceId: string;
+    resourceUrl?: string;
+    resourceName?: string;
+    baseType?: string;
+}
+export interface IGIndex {
+    profiles: IGResourceMapEntry[];
+    extensions: IGResourceMapEntry[];
+    valueSets: IGResourceMapEntry[];
+    codeSystems: IGResourceMapEntry[];
+    searchParameters: IGResourceMapEntry[];
+}
+export declare class IGResourceMapRepo {
+    private readonly adapter;
+    private readonly dialect;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect);
+    ensureTable(): Promise<void>;
+    /** Batch insert resource map entries for an IG. */
+    batchInsert(igId: string, entries: Omit<IGResourceMapEntry, 'igId'>[]): Promise<number>;
+    /** Get grouped IG index. */
+    getIGIndex(igId: string): Promise<IGIndex>;
+    /** Get resources of a specific type within an IG. */
+    getByType(igId: string, resourceType: string): Promise<IGResourceMapEntry[]>;
+    /** Remove all resource mappings for an IG. */
+    removeIG(igId: string): Promise<void>;
+}
+//# sourceMappingURL=ig-resource-map-repo.d.ts.map

package/dist/lib/conformance/ig-resource-map-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ig-resource-map-repo.d.ts","sourceRoot":"","sources":["../../../src/conformance/ig-resource-map-repo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAM7D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,gBAAgB,EAAE,kBAAkB,EAAE,CAAC;CACxC;AA2BD,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,UAAqB;IAG3C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,mDAAmD;IAC7C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB7F,4BAA4B;IACtB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiDhD,qDAAqD;IAC/C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAmBlF,8CAA8C;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI5C"}

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

@@ -0,0 +1,29 @@
+/**
+ * Conformance Module — Barrel Export
+ *
+ * Provides IG-related conformance resource storage:
+ * - IG → Resource mapping (P1)
+ * - StructureDefinition index (P2)
+ * - Element index (P3)
+ * - ValueSet expansion cache (P4)
+ * - CodeSystem concept hierarchy (P5)
+ * - SearchParameter index (B1)
+ * - IG import orchestrator (B2)
+ *
+ * @module fhir-persistence/conformance
+ */
+export { IGResourceMapRepo } from './ig-resource-map-repo.js';
+export type { IGResourceMapEntry, IGIndex } from './ig-resource-map-repo.js';
+export { SDIndexRepo } from './sd-index-repo.js';
+export type { SDIndexEntry } from './sd-index-repo.js';
+export { ElementIndexRepo } from './element-index-repo.js';
+export type { ElementIndexEntry } from './element-index-repo.js';
+export { ExpansionCacheRepo } from './expansion-cache-repo.js';
+export type { CachedExpansion } from './expansion-cache-repo.js';
+export { ConceptHierarchyRepo } from './concept-hierarchy-repo.js';
+export type { ConceptHierarchyEntry } from './concept-hierarchy-repo.js';
+export { SearchParamIndexRepo } from './search-param-index-repo.js';
+export type { SearchParamIndexEntry } from './search-param-index-repo.js';
+export { IGImportOrchestrator } from './ig-import-orchestrator.js';
+export type { IGImportOptions, IGImportResult } from './ig-import-orchestrator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/conformance/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAG7E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAGzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAG1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/lib/conformance/sd-index-repo.d.ts

@@ -0,0 +1,35 @@
+/**
+ * StructureDefinition Index Repository (P2)
+ *
+ * Manages the `structure_definition_index` table for fast SD queries
+ * by type, kind, base definition, etc.
+ *
+ * @module fhir-persistence/conformance
+ */
+import type { StorageAdapter } from '../db/adapter.js';
+import type { DDLDialect } from '../schema/ddl-generator.js';
+export interface SDIndexEntry {
+    id: string;
+    url?: string;
+    version?: string;
+    type?: string;
+    kind?: string;
+    baseDefinition?: string;
+    derivation?: string;
+    snapshotHash?: string;
+}
+export declare class SDIndexRepo {
+    private readonly adapter;
+    private readonly dialect;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect);
+    ensureTable(): Promise<void>;
+    upsert(entry: SDIndexEntry): Promise<void>;
+    batchUpsert(entries: SDIndexEntry[]): Promise<number>;
+    getById(id: string): Promise<SDIndexEntry | undefined>;
+    getByUrl(url: string): Promise<SDIndexEntry[]>;
+    getByType(type: string): Promise<SDIndexEntry[]>;
+    getByBaseDefinition(baseUrl: string): Promise<SDIndexEntry[]>;
+    remove(id: string): Promise<void>;
+    private mapRow;
+}
+//# sourceMappingURL=sd-index-repo.d.ts.map

package/dist/lib/conformance/sd-index-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-index-repo.d.ts","sourceRoot":"","sources":["../../../src/conformance/sd-index-repo.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAM7D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA6BD,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,UAAqB;IAG3C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1C,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IASrD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAatD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAa9C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAahD,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAa7D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC,OAAO,CAAC,MAAM;CAgBf"}

package/dist/lib/conformance/search-param-index-repo.d.ts

@@ -0,0 +1,33 @@
+/**
+ * SearchParameter Index Repository (B1)
+ *
+ * Manages the `search_parameter_index` table for tracking which
+ * SearchParameters are defined within an IG.
+ *
+ * @module fhir-persistence/conformance
+ */
+import type { StorageAdapter } from '../db/adapter.js';
+import type { DDLDialect } from '../schema/ddl-generator.js';
+export interface SearchParamIndexEntry {
+    id: string;
+    igId: string;
+    url?: string;
+    code: string;
+    type: string;
+    base: string[];
+    expression?: string;
+}
+export declare class SearchParamIndexRepo {
+    private readonly adapter;
+    private readonly dialect;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect);
+    ensureTable(): Promise<void>;
+    upsert(entry: SearchParamIndexEntry): Promise<void>;
+    batchUpsert(entries: SearchParamIndexEntry[]): Promise<number>;
+    getByIG(igId: string): Promise<SearchParamIndexEntry[]>;
+    getByCode(code: string): Promise<SearchParamIndexEntry[]>;
+    remove(id: string): Promise<void>;
+    removeByIG(igId: string): Promise<void>;
+    private mapRow;
+}
+//# sourceMappingURL=search-param-index-repo.d.ts.map

package/dist/lib/conformance/search-param-index-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-param-index-repo.d.ts","sourceRoot":"","sources":["../../../src/conformance/search-param-index-repo.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAM7D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA8BD,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,UAAqB;IAG3C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnD,WAAW,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAS9D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IASvD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IASzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7C,OAAO,CAAC,MAAM;CAcf"}

package/dist/lib/index.d.ts

@@ -65,4 +65,12 @@ export type { FhirSystemOptions, FhirSystemReady } from './startup/fhir-system.j
 export { FhirDefinitionBridge } from './providers/fhir-definition-provider.js';
 export { FhirRuntimeProvider, createFhirRuntimeProvider } from './providers/fhir-runtime-provider.js';
 export type { FhirRuntimeProviderOptions } from './providers/fhir-runtime-provider.js';
+export { IGResourceMapRepo } from './conformance/ig-resource-map-repo.js';
+export { SDIndexRepo } from './conformance/sd-index-repo.js';
+export { ElementIndexRepo } from './conformance/element-index-repo.js';
+export { ExpansionCacheRepo } from './conformance/expansion-cache-repo.js';
+export { ConceptHierarchyRepo } from './conformance/concept-hierarchy-repo.js';
+export { SearchParamIndexRepo } from './conformance/search-param-index-repo.js';
+export { IGImportOrchestrator } from './conformance/ig-import-orchestrator.js';
+export type { IGResourceMapEntry, IGIndex, SDIndexEntry, ElementIndexEntry, CachedExpansion, ConceptHierarchyEntry, SearchParamIndexEntry, IGImportOptions, IGImportResult, } from './conformance/index.js';
 //# sourceMappingURL=index.d.ts.map