fhir-persistence 0.1.0

package/dist/lib/db/sqlite-dialect.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SQLiteDialect — SQLite-Specific SQL Generation
+ *
+ * Implements SqlDialect for SQLite syntax differences:
+ * - `?` placeholders (not `$1`)
+ * - JSON arrays instead of native TEXT[]
+ * - TEXT instead of TIMESTAMPTZ
+ * - INTEGER instead of BOOLEAN
+ * - json_each() for array contains checks
+ *
+ * v2 upgrade: New file. v1 hardcoded PostgreSQL syntax.
+ *
+ * @module fhir-persistence/db
+ */
+import type { SqlDialect } from './dialect.js';
+export declare class SQLiteDialect implements SqlDialect {
+    readonly name: "sqlite";
+    placeholder(_index: number): string;
+    textArrayContains(column: string, paramCount: number, _paramStartIndex: number): {
+        sql: string;
+        values: unknown[];
+    };
+    like(column: string, _paramIndex: number): string;
+    limitOffset(_paramStartIndex: number): {
+        sql: string;
+    };
+    arrayLiteral(values: string[]): string;
+    timestampType(): string;
+    booleanType(): string;
+    textArrayType(): string;
+    upsertSuffix(conflictColumn: string, updateColumns: string[]): string;
+    autoIncrementPK(): string;
+}
+//# sourceMappingURL=sqlite-dialect.d.ts.map

package/dist/lib/db/sqlite-dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-dialect.d.ts","sourceRoot":"","sources":["../../../src/db/sqlite-dialect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,qBAAa,aAAc,YAAW,UAAU;IAC9C,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAElC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAInC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG;QAC/E,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,OAAO,EAAE,CAAC;KACnB;IAQD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAIjD,WAAW,CAAC,gBAAgB,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAItD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM;IAItC,aAAa,IAAI,MAAM;IAIvB,WAAW,IAAI,MAAM;IAIrB,aAAa,IAAI,MAAM;IAIvB,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM;IAKrE,eAAe,IAAI,MAAM;CAG1B"}

package/dist/lib/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * `fhir-persistence` — Embedded FHIR R4 Persistence Layer
+ *
+ * Provides CRUD, search, indexing, schema migration, and terminology
+ * for FHIR R4 resources over SQLite (sql.js / better-sqlite3) and PostgreSQL.
+ *
+ * @packageDocumentation
+ */
+export type { SqlColumnType, ColumnSchema, IndexSchema, ConstraintSchema, MainTableSchema, HistoryTableSchema, ReferencesTableSchema, ResourceTableSet, SchemaDefinition, } from './schema/index.js';
+export { StructureDefinitionRegistry } from './registry/index.js';
+export type { CanonicalProfile } from './registry/index.js';
+export { SearchParameterRegistry } from './registry/index.js';
+export type { SearchParamType, SearchStrategy, SearchColumnType, SearchParameterImpl, SearchParameterResource, SearchParameterBundle, } from './registry/index.js';
+export { buildResourceTableSet, buildAllResourceTableSets, buildSchemaDefinition, } from './schema/table-schema-builder.js';
+export { generateCreateMainTable, generateCreateHistoryTable, generateCreateReferencesTable, generateCreateIndex, generateResourceDDL, generateSchemaDDL, generateSchemaDDLString, } from './schema/ddl-generator.js';
+export type { FhirResource, FhirMeta, PersistedResource, ResourceRepository, CreateResourceOptions, UpdateResourceOptions, HistoryOptions, HistoryEntry, SearchOptions, SearchResult, HistoryBundle, HistoryBundleEntry, BuildHistoryBundleOptions, OperationContext, } from './repo/index.js';
+export { SCHEMA_VERSION, DELETED_SCHEMA_VERSION, PLATFORM_RESOURCE_TYPES, PROTECTED_RESOURCE_TYPES, PROJECT_ADMIN_RESOURCE_TYPES, } from './repo/index.js';
+export { RepositoryError, ResourceNotFoundError, ResourceGoneError, ResourceVersionConflictError, } from './repo/index.js';
+export { buildHistoryBundle } from './repo/index.js';
+export type { SearchColumnValues } from './repo/index.js';
+export { buildSearchColumns, buildResourceRowWithSearch, hashToken, extractPropertyPath, getNestedValues, } from './repo/index.js';
+export type { SearchPrefix, SearchModifier, ParsedSearchParam, SortRule, SearchRequest, WhereFragment, SearchSQL, CountSQL, SearchBundle, SearchBundleEntry, BuildSearchBundleOptions, PaginationContext, } from './search/index.js';
+export { SEARCH_PREFIXES, PREFIX_TYPES, DEFAULT_SEARCH_COUNT, MAX_SEARCH_COUNT, parseSearchRequest, parseParamKey, splitSearchValues, extractPrefix, parseSortParam, prefixToOperator, buildSearchBundle, buildSelfLink, buildNextLink, hasNextPage, buildPaginationContext, executeSearchV2 as executeSearch, mapRowsToResourcesV2 as mapRowsToResources, } from './search/index.js';
+export type { StorageAdapter, TransactionContext } from './db/adapter.js';
+export { SQLiteAdapter } from './db/sqlite-adapter.js';
+export { BetterSqlite3Adapter } from './db/better-sqlite3-adapter.js';
+export type { BetterSqlite3Options } from './db/better-sqlite3-adapter.js';
+export { FhirStore } from './store/fhir-store.js';
+export { FhirPersistence } from './store/fhir-persistence.js';
+export type { FhirPersistenceOptions } from './store/fhir-persistence.js';
+export { IndexingPipeline } from './repo/indexing-pipeline.js';
+export type { IndexResult, IndexingPipelineOptions } from './repo/indexing-pipeline.js';
+export { LookupTableWriter } from './repo/lookup-table-writer.js';
+export type { ReferenceRowV2 } from './repo/reference-indexer.js';
+export { extractReferencesV2 } from './repo/reference-indexer.js';
+export type { LookupTableRow } from './repo/row-indexer.js';
+export { buildLookupTableRows } from './repo/row-indexer.js';
+export { buildInsertMainSQLv2, buildUpdateMainSQLv2, buildInsertHistorySQLv2, buildSelectByIdSQLv2, buildSelectVersionSQLv2, buildDeleteReferencesSQLv2, buildInsertReferencesSQLv2, buildInstanceHistorySQLv2, buildTypeHistorySQLv2, } from './repo/sql-builder.js';
+export type { SchemaDelta, DeltaKind } from './migration/schema-diff.js';
+export { compareSchemas } from './migration/schema-diff.js';
+export type { GeneratedMigration } from './migration/migration-generator.js';
+export { generateMigration } from './migration/migration-generator.js';
+export { PackageRegistryRepo } from './registry/package-registry-repo.js';
+export { IGPersistenceManager } from './migration/ig-persistence-manager.js';
+export { ReindexScheduler } from './migration/reindex-scheduler.js';
+export { MigrationRunnerV2 } from './migrations/index.js';
+export type { MigrationV2, MigrationResultV2 } from './migrations/index.js';
+export { TerminologyCodeRepo } from './terminology/terminology-code-repo.js';
+export { ValueSetRepo } from './terminology/valueset-repo.js';
+export { PLATFORM_SEARCH_PARAMETERS, PLATFORM_PACKAGE_NAME, PLATFORM_PACKAGE_VERSION } from './platform/platform-ig-definitions.js';
+export { buildPlatformTableSets, initializePlatformIG } from './platform/platform-ig-loader.js';
+export { buildWhereFragmentV2, buildWhereClauseV2 } from './search/where-builder.js';
+export { buildSearchSQLv2, buildCountSQLv2, buildTwoPhaseSearchSQLv2 } from './search/search-sql-builder.js';
+export type { TwoPhaseSearchSQL } from './search/search-sql-builder.js';
+export type { SearchPlan, SearchPlannerOptions } from './search/search-planner.js';
+export { planSearch } from './search/search-planner.js';
+export { ResourceCacheV2 } from './cache/resource-cache.js';
+export { SearchLogger } from './observability/search-logger.js';
+export { reindexResourceTypeV2, reindexAllV2 } from './cli/reindex.js';
+export { FhirSystem } from './startup/fhir-system.js';
+export type { FhirSystemOptions, FhirSystemReady } from './startup/fhir-system.js';
+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';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/lib/migration/ig-persistence-manager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * IG Persistence Manager — v2
+ *
+ * Orchestrates the initialization flow when an IG package is loaded:
+ * 1. Check PackageRegistry for existing installation (checksum compare)
+ * 2. Three-way branch: new / upgrade / consistent
+ * 3. For new/upgrade: SchemaDiff → MigrationGenerator → MigrationRunnerV2
+ * 4. Schedule reindex jobs for SP expression changes
+ *
+ * @module fhir-persistence/migration
+ */
+import type { StorageAdapter } from '../db/adapter.js';
+import type { ResourceTableSet } from '../schema/table-schema.js';
+import type { DDLDialect } from '../schema/ddl-generator.js';
+export interface IGPackageInput {
+    /** 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;
+    /** The new schema table sets generated from this package. */
+    tableSets: ResourceTableSet[];
+}
+export type IGInitAction = 'new' | 'upgrade' | 'consistent';
+export interface IGInitResult {
+    /** What action was taken. */
+    action: IGInitAction;
+    /** Package name. */
+    packageName: string;
+    /** Package version. */
+    packageVersion: string;
+    /** Number of DDL statements applied (0 for 'consistent'). */
+    ddlCount: number;
+    /** Number of reindex jobs scheduled. */
+    reindexCount: number;
+    /** Error message if any step failed. */
+    error?: string;
+}
+export declare class IGPersistenceManager {
+    private readonly dialect;
+    private readonly packageRepo;
+    private readonly migrationRunner;
+    private readonly reindexScheduler;
+    constructor(adapter: StorageAdapter, dialect?: DDLDialect);
+    /**
+     * Initialize an IG package — the main entry point.
+     *
+     * Three-way branch based on checksum comparison:
+     * - **new**: Fresh install → apply full schema DDL
+     * - **upgrade**: Checksum changed → diff + apply migration
+     * - **consistent**: Checksum matches → no-op
+     */
+    initialize(input: IGPackageInput): Promise<IGInitResult>;
+}
+//# sourceMappingURL=ig-persistence-manager.d.ts.map

package/dist/lib/migration/ig-persistence-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ig-persistence-manager.d.ts","sourceRoot":"","sources":["../../../src/migration/ig-persistence-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAW7D,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,SAAS,GAAG,YAAY,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,oBAAoB;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoB;IACpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;gBAExC,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE,UAAqB;IAOnE;;;;;;;OAOG;IACG,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;CAuF/D"}

package/dist/lib/migration/migration-generator.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Migration Generator — v2
+ *
+ * Generates SQL DDL statements from SchemaDelta[].
+ * Dialect-aware: produces SQLite or PostgreSQL DDL.
+ *
+ * Key design decisions:
+ * - ADD_TABLE delegates to existing DDLGenerator (generateResourceDDL)
+ * - ADD_COLUMN → ALTER TABLE ADD COLUMN
+ * - DROP_COLUMN → ALTER TABLE DROP COLUMN (PG only; SQLite ignores)
+ * - ADD_INDEX → CREATE INDEX IF NOT EXISTS
+ * - DROP_INDEX → DROP INDEX IF EXISTS
+ * - REINDEX → no DDL (metadata only, handled by ReindexScheduler)
+ * - ALTER_COLUMN → not supported in SQLite (logged as warning)
+ *
+ * @module fhir-persistence/migration
+ */
+import type { SchemaDelta } from './schema-diff.js';
+import type { DDLDialect } from '../schema/ddl-generator.js';
+export interface GeneratedMigration {
+    /** SQL statements to apply (up). */
+    up: string[];
+    /** SQL statements to revert (down). Best-effort; some are irreversible. */
+    down: string[];
+    /** Deltas that require reindex (no DDL, just scheduling). */
+    reindexDeltas: SchemaDelta[];
+    /** Human-readable description of changes. */
+    description: string;
+}
+/**
+ * Generate SQL DDL from a list of schema deltas.
+ *
+ * @param deltas - Schema changes to apply.
+ * @param dialect - Target SQL dialect.
+ * @returns Generated migration with up/down SQL and reindex info.
+ */
+export declare function generateMigration(deltas: SchemaDelta[], dialect: DDLDialect): GeneratedMigration;
+//# sourceMappingURL=migration-generator.d.ts.map

package/dist/lib/migration/migration-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-generator.d.ts","sourceRoot":"","sources":["../../../src/migration/migration-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAU7D,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,2EAA2E;IAC3E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,6DAA6D;IAC7D,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EAAE,EACrB,OAAO,EAAE,UAAU,GAClB,kBAAkB,CAsHpB"}

package/dist/lib/migration/reindex-scheduler.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Reindex Scheduler — v2
+ *
+ * Schedules and tracks asynchronous reindex jobs when a SearchParameter
+ * expression changes (detected by SchemaDiff as REINDEX deltas).
+ *
+ * Design decisions:
+ * - Jobs stored in `_reindex_jobs` table (auto-created)
+ * - Keyset pagination: processes resources by lastUpdated > cursor
+ * - Jobs are independent per (resourceType, searchParamCode)
+ * - Status tracking: pending / running / completed / failed
+ *
+ * @module fhir-persistence/migration
+ */
+import type { StorageAdapter } from '../db/adapter.js';
+import type { SchemaDelta } from './schema-diff.js';
+export type ReindexJobStatus = 'pending' | 'running' | 'completed' | 'failed';
+export interface ReindexJob {
+    /** Auto-assigned job ID. */
+    id: number;
+    /** Resource type to reindex (e.g., "Patient"). */
+    resourceType: string;
+    /** Search parameter code that changed (e.g., "birthdate"). */
+    searchParamCode: string;
+    /** New FHIRPath expression. */
+    expression: string;
+    /** Current job status. */
+    status: ReindexJobStatus;
+    /** Cursor for keyset pagination (lastUpdated of last processed resource). */
+    cursor: string | null;
+    /** Number of resources processed so far. */
+    processedCount: number;
+    /** When the job was created. */
+    createdAt: string;
+    /** When the job was last updated. */
+    updatedAt: string;
+}
+export declare class ReindexScheduler {
+    private readonly adapter;
+    constructor(adapter: StorageAdapter);
+    /**
+     * Ensure the reindex jobs table exists.
+     */
+    ensureTable(): Promise<void>;
+    /**
+     * Schedule reindex jobs from REINDEX deltas.
+     *
+     * @param deltas - REINDEX deltas from SchemaDiff (filtered by caller).
+     * @returns Number of jobs scheduled.
+     */
+    schedule(deltas: SchemaDelta[]): Promise<number>;
+    /**
+     * Get all pending reindex jobs.
+     */
+    getPendingJobs(): Promise<ReindexJob[]>;
+    /**
+     * Get a specific job by ID.
+     */
+    getJob(id: number): Promise<ReindexJob | undefined>;
+    /**
+     * Get all jobs (any status).
+     */
+    getAllJobs(): Promise<ReindexJob[]>;
+    /**
+     * Update job status and cursor.
+     */
+    updateJob(id: number, update: {
+        status?: ReindexJobStatus;
+        cursor?: string;
+        processedCount?: number;
+    }): Promise<void>;
+    /**
+     * Get status summary of all jobs.
+     */
+    getStatus(): Promise<{
+        pending: number;
+        running: number;
+        completed: number;
+        failed: number;
+    }>;
+}
+//# sourceMappingURL=reindex-scheduler.d.ts.map

package/dist/lib/migration/reindex-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reindex-scheduler.d.ts","sourceRoot":"","sources":["../../../src/migration/reindex-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9E,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB;AA0BD,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBtD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAO7C;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAQzD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAOzC;;OAEG;IACG,SAAS,CACb,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9E,OAAO,CAAC,IAAI,CAAC;IA0BhB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAcpG"}

package/dist/lib/migration/schema-diff.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Schema Diff — v2
+ *
+ * Compares old vs new ResourceTableSet[] to produce SchemaDelta[].
+ * Used by IGPersistenceManager to detect what changed when an IG
+ * package is upgraded.
+ *
+ * Key design decisions:
+ * - Compares by column name + type (not by position)
+ * - Compares indexes by name
+ * - Detects SP expression changes for reindex scheduling
+ * - Works from in-memory schema objects (no DB introspection)
+ *
+ * @module fhir-persistence/migration
+ */
+import type { ResourceTableSet, ColumnSchema, IndexSchema, SearchParamMeta } from '../schema/table-schema.js';
+export type DeltaKind = 'ADD_TABLE' | 'DROP_TABLE' | 'ADD_COLUMN' | 'DROP_COLUMN' | 'ALTER_COLUMN' | 'ADD_INDEX' | 'DROP_INDEX' | 'REINDEX';
+export interface SchemaDelta {
+    /** The type of schema change. */
+    kind: DeltaKind;
+    /** The resource type affected (e.g., "Patient"). */
+    resourceType: string;
+    /** The table name affected (e.g., "Patient", "Patient_History"). */
+    tableName: string;
+    /** Column details (for ADD_COLUMN, DROP_COLUMN, ALTER_COLUMN). */
+    column?: ColumnSchema;
+    /** Previous column details (for ALTER_COLUMN). */
+    oldColumn?: ColumnSchema;
+    /** Index details (for ADD_INDEX, DROP_INDEX). */
+    index?: IndexSchema;
+    /** Search parameter details (for REINDEX). */
+    searchParam?: SearchParamMeta;
+    /** The full ResourceTableSet (for ADD_TABLE). */
+    tableSet?: ResourceTableSet;
+}
+/**
+ * Compare two sets of ResourceTableSets and produce a list of deltas.
+ *
+ * @param oldSets - The previously installed schema (from PackageRegistry).
+ * @param newSets - The newly generated schema (from current IG).
+ * @returns Array of SchemaDelta describing all changes.
+ */
+export declare function compareSchemas(oldSets: ResourceTableSet[], newSets: ResourceTableSet[]): SchemaDelta[];
+//# sourceMappingURL=schema-diff.d.ts.map

package/dist/lib/migration/schema-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-diff.d.ts","sourceRoot":"","sources":["../../../src/migration/schema-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,eAAe,EAChB,MAAM,2BAA2B,CAAC;AAMnC,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,cAAc,GACd,WAAW,GACX,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,kDAAkD;IAClD,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,iDAAiD;IACjD,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,OAAO,EAAE,gBAAgB,EAAE,GAC1B,WAAW,EAAE,CAuDf"}

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

@@ -0,0 +1,8 @@
+/**
+ * Schema Migration Module (v2)
+ *
+ * @module fhir-persistence/migrations
+ */
+export { MigrationRunnerV2 } from './migration-runner.js';
+export type { MigrationV2, MigrationRecordV2, MigrationResultV2, MigrationStatusV2, } from './migration-runner.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC"}

package/dist/lib/migrations/migration-runner.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Schema Migration Runner (v2)
+ *
+ * Manages incremental database schema migrations with version tracking
+ * using StorageAdapter (SQLite / PostgreSQL).
+ *
+ * Features:
+ * - Automatic `_migrations` tracking table creation
+ * - Sequential up/down migration execution
+ * - Idempotent: skips already-applied migrations
+ * - Transaction-per-migration for safety
+ * - IG migrations (forward-only, auto-versioned)
+ * - Status reporting (current version, pending migrations)
+ *
+ * @module fhir-persistence/migrations
+ */
+import type { StorageAdapter } from '../db/adapter.js';
+import type { GeneratedMigration } from '../migration/migration-generator.js';
+/**
+ * v2 migration types — adds `type` field for IG vs file distinction.
+ */
+export interface MigrationV2 {
+    /** Unique version number. Must be positive integer. */
+    version: number;
+    /** Human-readable description. */
+    description: string;
+    /** SQL statements to apply this migration. */
+    up: string[];
+    /** SQL statements to revert this migration. Empty for IG migrations (forward-only). */
+    down: string[];
+    /** Migration source type: 'ig' for IG-driven, 'file' for manual file-based. */
+    type: 'ig' | 'file';
+}
+export interface MigrationRecordV2 {
+    version: number;
+    description: string;
+    type: string;
+    applied_at: string;
+}
+export interface MigrationResultV2 {
+    action: 'up' | 'down' | 'none';
+    applied: number[];
+    currentVersion: number;
+    errors: Array<{
+        version: number;
+        error: string;
+    }>;
+}
+export interface MigrationStatusV2 {
+    currentVersion: number;
+    appliedVersions: number[];
+    availableVersions: number[];
+    pendingVersions: number[];
+}
+/**
+ * v2: Manages schema migrations using StorageAdapter (SQLite / PG).
+ *
+ * Key differences from v1:
+ * - Uses `StorageAdapter` instead of `DatabaseClient`
+ * - `?` placeholders instead of `$1`
+ * - Supports `type` field: 'ig' | 'file'
+ * - IG migrations are forward-only (no down/revert)
+ * - Tracking table uses `datetime('now')` for SQLite
+ */
+export declare class MigrationRunnerV2 {
+    private readonly adapter;
+    private readonly migrations;
+    constructor(adapter: StorageAdapter, migrations?: MigrationV2[]);
+    /**
+     * Ensure the tracking table exists.
+     */
+    ensureTrackingTable(): Promise<void>;
+    /**
+     * Apply all pending migrations (or up to a target version).
+     */
+    up(targetVersion?: number): Promise<MigrationResultV2>;
+    /**
+     * Revert migrations down to a target version.
+     * IG migrations (type='ig') cannot be reverted — they are skipped.
+     */
+    down(targetVersion?: number): Promise<MigrationResultV2>;
+    /**
+     * Get the current migration status.
+     */
+    status(): Promise<MigrationStatusV2>;
+    /**
+     * Get all applied migration records.
+     */
+    getRecords(): Promise<MigrationRecordV2[]>;
+    /**
+     * Apply an IG-generated migration directly.
+     *
+     * Assigns the next available version number automatically.
+     * This is the primary entry point for IGPersistenceManager.
+     */
+    applyIGMigration(generated: GeneratedMigration): Promise<MigrationResultV2>;
+    private getAppliedVersions;
+    private applyMigration;
+    private revertMigration;
+    private maxApplied;
+}
+//# sourceMappingURL=migration-runner.d.ts.map

package/dist/lib/migrations/migration-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-runner.d.ts","sourceRoot":"","sources":["../../../src/migrations/migration-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,uFAAuF;IACvF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+EAA+E;IAC/E,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAaD;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;gBAE/B,OAAO,EAAE,cAAc,EAAE,UAAU,GAAE,WAAW,EAAO;IASnE;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1C;;OAEG;IACG,EAAE,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0C5D;;;OAGG;IACG,IAAI,CAAC,aAAa,GAAE,MAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0CjE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAe1C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAOhD;;;;;OAKG;IACG,gBAAgB,CAAC,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAsCnE,kBAAkB;YAOlB,cAAc;YAYd,eAAe;IAY7B,OAAO,CAAC,UAAU;CAInB"}

package/dist/lib/observability/search-logger.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Search Logger — Execution Time Observability
+ *
+ * Wraps search operations with timing and result counting.
+ * Provides slow query detection, recent log buffer, and stats.
+ *
+ * @module fhir-persistence/observability
+ */
+export interface SearchLogEntry {
+    /** Resource type being searched. */
+    resourceType: string;
+    /** Number of search parameters used. */
+    paramCount: number;
+    /** Number of results returned. */
+    resultCount: number;
+    /** Execution duration in milliseconds. */
+    durationMs: number;
+    /** ISO 8601 timestamp. */
+    timestamp: string;
+    /** Whether this was flagged as slow. */
+    slow: boolean;
+}
+export interface SearchLoggerConfig {
+    /** Whether logging is enabled. Default: true. */
+    enabled?: boolean;
+    /** Slow query threshold in milliseconds. Default: 1000. */
+    slowThresholdMs?: number;
+    /** Maximum number of log entries to retain. Default: 100. */
+    maxEntries?: number;
+    /** Custom log handler. Called for every search log entry. */
+    onLog?: (entry: SearchLogEntry) => void;
+}
+export interface SearchStats {
+    /** Total number of logged searches. */
+    totalSearches: number;
+    /** Average duration in ms. */
+    avgDurationMs: number;
+    /** Maximum duration in ms. */
+    maxDurationMs: number;
+    /** Minimum duration in ms. */
+    minDurationMs: number;
+    /** Number of slow queries. */
+    slowCount: number;
+}
+export declare class SearchLogger {
+    private readonly entries;
+    private readonly enabled;
+    private readonly slowThresholdMs;
+    private readonly maxEntries;
+    private readonly onLog?;
+    constructor(config?: SearchLoggerConfig);
+    /**
+     * Log a completed search operation.
+     */
+    log(resourceType: string, paramCount: number, resultCount: number, durationMs: number): void;
+    /**
+     * Get the most recent N log entries.
+     */
+    getRecentLogs(count?: number): SearchLogEntry[];
+    /**
+     * Get entries flagged as slow queries.
+     */
+    getSlowQueries(): SearchLogEntry[];
+    /**
+     * Get aggregate statistics.
+     */
+    getStats(): SearchStats;
+    /**
+     * Clear all log entries.
+     */
+    clearLogs(): void;
+    get isEnabled(): boolean;
+}
+//# sourceMappingURL=search-logger.d.ts.map

package/dist/lib/observability/search-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-logger.d.ts","sourceRoot":"","sources":["../../../src/observability/search-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAkC;gBAE7C,MAAM,CAAC,EAAE,kBAAkB;IAOvC;;OAEG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAwB5F;;OAEG;IACH,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE;IAK/C;;OAEG;IACH,cAAc,IAAI,cAAc,EAAE;IAIlC;;OAEG;IACH,QAAQ,IAAI,WAAW;IAiBvB;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF"}

package/dist/lib/platform/platform-ig-definitions.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Platform IG Definitions — medxai.core
+ *
+ * In-memory StructureDefinition (as CanonicalProfile) and SearchParameter
+ * definitions for MedXAI platform resources: User, Bot, Project, Agent,
+ * ClientApplication.
+ *
+ * These replace the v1 hardcoded PLATFORM_RESOURCE_TYPES approach.
+ * Tables are now generated through the IG pipeline (Stage 5).
+ *
+ * @module fhir-persistence/platform
+ */
+import type { SearchParameterResource } from '../registry/search-parameter-registry.js';
+export declare const PLATFORM_PACKAGE_NAME = "medxai.core";
+export declare const PLATFORM_PACKAGE_VERSION = "1.0.0";
+/**
+ * Minimal CanonicalProfile shape matching @medxai/fhir-core.
+ * We define our own to avoid hard dependency on @medxai/fhir-core at this layer.
+ */
+export interface PlatformProfile {
+    url: string;
+    name: string;
+    kind: 'resource' | 'complex-type' | 'primitive-type' | 'logical';
+    type: string;
+    abstract: boolean;
+    elements: Map<string, unknown>;
+}
+export declare const PLATFORM_PROFILES: PlatformProfile[];
+/**
+ * Get all platform profiles.
+ */
+export declare function getPlatformProfiles(): PlatformProfile[];
+/**
+ * Get all platform resource type names.
+ */
+export declare function getPlatformResourceTypes(): string[];
+export declare const PLATFORM_SEARCH_PARAMETERS: SearchParameterResource[];
+/**
+ * Get all platform search parameters.
+ */
+export declare function getPlatformSearchParameters(): SearchParameterResource[];
+/**
+ * Get search parameters for a specific platform resource type.
+ */
+export declare function getSearchParametersForType(resourceType: string): SearchParameterResource[];
+/**
+ * Generate a deterministic checksum for the platform IG package.
+ * Based on sorted JSON of profiles + search parameters.
+ */
+export declare function getPackageChecksum(): string;
+//# sourceMappingURL=platform-ig-definitions.d.ts.map

package/dist/lib/platform/platform-ig-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-ig-definitions.d.ts","sourceRoot":"","sources":["../../../src/platform/platform-ig-definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAMxF,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AACnD,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAMhD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,gBAAgB,GAAG,SAAS,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAmBD,eAAO,MAAM,iBAAiB,EAAE,eAAe,EAM9C,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,eAAe,EAAE,CAEvD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAEnD;AAyBD,eAAO,MAAM,0BAA0B,EAAE,uBAAuB,EA0B/D,CAAC;AAEF;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,uBAAuB,EAAE,CAEvE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,uBAAuB,EAAE,CAE1F;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAgB3C"}

package/dist/lib/platform/platform-ig-loader.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Platform IG Loader — medxai.core
+ *
+ * Loads platform resource definitions, builds ResourceTableSets,
+ * and feeds them into the IGPersistenceManager pipeline for
+ * automatic table creation and migration.
+ *
+ * @module fhir-persistence/platform
+ */
+import type { StorageAdapter } from '../db/adapter.js';
+import type { ResourceTableSet } from '../schema/table-schema.js';
+import type { IGInitResult } from '../migration/ig-persistence-manager.js';
+/**
+ * Build ResourceTableSets for all platform resource types.
+ *
+ * Uses StructureDefinitionRegistry + SearchParameterRegistry
+ * populated with platform definitions to generate the table schemas.
+ */
+export declare function buildPlatformTableSets(): ResourceTableSet[];
+/**
+ * Initialize the platform IG — create or upgrade platform resource tables.
+ *
+ * This is the main entry point for bootstrapping platform tables on startup.
+ * Uses IGPersistenceManager for checksum-based change detection.
+ *
+ * @param adapter - StorageAdapter (SQLite or PostgreSQL).
+ * @returns IGInitResult with action taken (new/upgrade/consistent).
+ */
+export declare function initializePlatformIG(adapter: StorageAdapter): Promise<IGInitResult>;
+//# sourceMappingURL=platform-ig-loader.d.ts.map

package/dist/lib/platform/platform-ig-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-ig-loader.d.ts","sourceRoot":"","sources":["../../../src/platform/platform-ig-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAKlE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAa3E;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,EAAE,CAyB3D;AAMD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAWzF"}