fhir-persistence 0.6.0 → 0.7.0

package/dist/cjs/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/esm/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.
  */