fhir-persistence 0.1.0

package/dist/lib/cache/resource-cache.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Resource Cache — In-Memory LRU
+ *
+ * Provides an in-memory LRU cache for `readResource` results.
+ * Invalidated on update and delete operations.
+ *
+ * Disabled by default. Enable via configuration.
+ *
+ * @module fhir-persistence/cache
+ */
+import type { PersistedResource } from '../repo/types.js';
+/**
+ * Configuration for the resource cache.
+ */
+export interface ResourceCacheConfig {
+    /** Maximum number of entries. Default: 1000. */
+    maxSize?: number;
+    /** Time-to-live in milliseconds. Default: 60000 (60s). */
+    ttlMs?: number;
+    /** Whether the cache is enabled. Default: false. */
+    enabled?: boolean;
+}
+/**
+ * Simple LRU cache for FHIR resources.
+ *
+ * Uses a Map (insertion-ordered) for O(1) get/set/delete.
+ * Evicts the oldest entry when maxSize is reached.
+ */
+export declare class ResourceCache {
+    private readonly cache;
+    private readonly maxSize;
+    private readonly ttlMs;
+    private readonly enabled;
+    private _hits;
+    private _misses;
+    constructor(config?: ResourceCacheConfig);
+    /**
+     * Build cache key from resourceType and id.
+     */
+    private key;
+    /**
+     * Get a resource from the cache.
+     * Returns undefined on miss or expiry.
+     */
+    get(resourceType: string, id: string): PersistedResource | undefined;
+    /**
+     * Put a resource into the cache.
+     */
+    set(resourceType: string, id: string, resource: PersistedResource): void;
+    /**
+     * Invalidate a cache entry (on update or delete).
+     */
+    invalidate(resourceType: string, id: string): void;
+    /**
+     * Clear all cache entries.
+     */
+    clear(): void;
+    /**
+     * Current cache size.
+     */
+    get size(): number;
+    /**
+     * Cache statistics.
+     */
+    get stats(): {
+        hits: number;
+        misses: number;
+        size: number;
+        hitRate: number;
+    };
+    get isEnabled(): boolean;
+}
+/**
+ * Eviction policy for the cache.
+ *
+ * - `lru` — Least Recently Used: evict the entry that was accessed longest ago.
+ * - `fifo` — First In First Out: evict the entry that was inserted first.
+ * - `ttl-only` — No size-based eviction; entries only expire via TTL.
+ */
+export type EvictionPolicy = 'lru' | 'fifo' | 'ttl-only';
+/**
+ * v2 configuration for the resource cache.
+ */
+export interface ResourceCacheV2Config {
+    /** Maximum number of entries. Default: 1000. Ignored for ttl-only policy. */
+    maxSize?: number;
+    /** Time-to-live in milliseconds. Default: 60000 (60s). */
+    ttlMs?: number;
+    /** Whether the cache is enabled. Default: false. */
+    enabled?: boolean;
+    /** Eviction policy. Default: 'lru'. */
+    evictionPolicy?: EvictionPolicy;
+}
+/**
+ * v2 Resource Cache with configurable eviction policy.
+ *
+ * Upgrades v1 with:
+ * - Eviction policy: lru / fifo / ttl-only
+ * - stats.reset() to zero counters
+ * - sweep() to proactively remove expired entries
+ */
+export declare class ResourceCacheV2 {
+    private readonly cache;
+    private readonly maxSize;
+    private readonly ttlMs;
+    private readonly enabled;
+    private readonly evictionPolicy;
+    private _hits;
+    private _misses;
+    private _evictions;
+    constructor(config?: ResourceCacheV2Config);
+    private key;
+    get(resourceType: string, id: string): PersistedResource | undefined;
+    set(resourceType: string, id: string, resource: PersistedResource): void;
+    invalidate(resourceType: string, id: string): void;
+    clear(): void;
+    /**
+     * Proactively remove all expired entries.
+     * @returns Number of entries swept.
+     */
+    sweep(): number;
+    get size(): number;
+    get stats(): {
+        hits: number;
+        misses: number;
+        size: number;
+        hitRate: number;
+        evictions: number;
+    };
+    /**
+     * Reset stats counters without clearing cache entries.
+     */
+    resetStats(): void;
+    get isEnabled(): boolean;
+    get policy(): EvictionPolicy;
+}
+//# sourceMappingURL=resource-cache.d.ts.map

package/dist/lib/cache/resource-cache.d.ts.map

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

package/dist/lib/cli/reindex.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Reindex CLI — v2
+ *
+ * Re-populates search columns and references for existing resources
+ * using StorageAdapter (not DatabaseClient). Replaces v1 repo/reindex.ts
+ * for v2 codepaths.
+ *
+ * Usage:
+ *   npx tsx src/cli/reindex.ts --resource Patient
+ *   npx tsx src/cli/reindex.ts --all
+ *
+ * @module fhir-persistence/cli
+ */
+import type { StorageAdapter } from '../db/adapter.js';
+export type ReindexProgressCallbackV2 = (info: {
+    resourceType: string;
+    processed: number;
+    total: number;
+}) => void;
+export interface ReindexResultV2 {
+    totalProcessed: number;
+    totalUpdated: number;
+    totalErrors: number;
+    byType: Record<string, {
+        processed: number;
+        updated: number;
+        errors: number;
+    }>;
+}
+/**
+ * Re-index all resources of a given type using StorageAdapter.
+ *
+ * Reads all non-deleted resources in batches via keyset pagination,
+ * parses content JSON, and can be extended with custom row-update logic.
+ *
+ * @param adapter - StorageAdapter (SQLite or PostgreSQL).
+ * @param resourceType - The FHIR resource type to re-index.
+ * @param onProgress - Optional progress callback.
+ * @returns Per-type reindex result.
+ */
+export declare function reindexResourceTypeV2(adapter: StorageAdapter, resourceType: string, onProgress?: ReindexProgressCallbackV2): Promise<{
+    processed: number;
+    updated: number;
+    errors: number;
+}>;
+/**
+ * Re-index all resource types using StorageAdapter.
+ *
+ * @param adapter - StorageAdapter.
+ * @param resourceTypes - List of resource types to re-index.
+ * @param onProgress - Optional progress callback.
+ * @returns Complete re-index result.
+ */
+export declare function reindexAllV2(adapter: StorageAdapter, resourceTypes: string[], onProgress?: ReindexProgressCallbackV2): Promise<ReindexResultV2>;
+//# sourceMappingURL=reindex.d.ts.map

package/dist/lib/cli/reindex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reindex.d.ts","sourceRoot":"","sources":["../../../src/cli/reindex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMvD,MAAM,MAAM,yBAAyB,GAAG,CAAC,IAAI,EAAE;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,KAAK,IAAI,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChF;AAQD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,yBAAyB,GACrC,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA6CjE;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,MAAM,EAAE,EACvB,UAAU,CAAC,EAAE,yBAAyB,GACrC,OAAO,CAAC,eAAe,CAAC,CAsB1B"}

package/dist/lib/db/adapter.d.ts

@@ -0,0 +1,79 @@
+/**
+ * StorageAdapter — Database Abstraction Interface
+ *
+ * Provides a unified interface for database operations across
+ * SQLite and PostgreSQL. All business logic interacts with
+ * the database exclusively through this interface.
+ *
+ * v2 upgrade: Replaces direct `pg.Pool` usage in v1's `DatabaseClient`.
+ * The existing `DatabaseClient` is preserved for backward compatibility.
+ *
+ * @module fhir-persistence/db
+ */
+/**
+ * A prepared (precompiled) SQL statement for high-frequency operations.
+ *
+ * Prepared statements avoid repeated SQL parsing overhead.
+ * The caller is responsible for calling `finalize()` when done.
+ */
+export interface PreparedStatement<T = Record<string, unknown>> {
+    /** Execute as a read query, returning all matching rows. */
+    query(params?: unknown[]): T[];
+    /** Execute as a write operation, returning change count. */
+    execute(params?: unknown[]): {
+        changes: number;
+        lastInsertRowid?: number | bigint;
+    };
+    /** Release the prepared statement resources. */
+    finalize(): void;
+}
+/**
+ * A restricted adapter interface available inside a transaction callback.
+ *
+ * All operations within a transaction use this context to ensure
+ * they execute on the same database connection/transaction.
+ */
+export interface TransactionContext {
+    /** Execute a write operation within the transaction. */
+    execute(sql: string, params?: unknown[]): {
+        changes: number;
+    };
+    /** Execute a read query within the transaction. */
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): T[];
+    /** Execute a read query returning the first row or undefined. */
+    queryOne<T = Record<string, unknown>>(sql: string, params?: unknown[]): T | undefined;
+}
+/**
+ * Unified database access interface for SQLite and PostgreSQL.
+ *
+ * All methods are async to support both synchronous (SQLite via sql.js)
+ * and asynchronous (PostgreSQL via pg) database drivers.
+ *
+ * ## Transaction Semantics
+ * - SQLite: `BEGIN IMMEDIATE ... COMMIT / ROLLBACK`
+ * - PostgreSQL: `BEGIN ... COMMIT / ROLLBACK` with `SELECT FOR UPDATE`
+ */
+export interface StorageAdapter {
+    /** Execute a write operation (INSERT / UPDATE / DELETE / DDL). */
+    execute(sql: string, params?: unknown[]): Promise<{
+        changes: number;
+    }>;
+    /** Execute a read query, returning all matching rows. */
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
+    /** Execute a read query, returning the first row or undefined. */
+    queryOne<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T | undefined>;
+    /** Stream rows for large result sets (avoids full memory load). */
+    queryStream<T = Record<string, unknown>>(sql: string, params?: unknown[]): AsyncIterable<T>;
+    /** Prepare a SQL statement for repeated execution. */
+    prepare<T = Record<string, unknown>>(sql: string): PreparedStatement<T>;
+    /**
+     * Execute a function within a single database transaction.
+     *
+     * - On success (fn returns normally): COMMIT
+     * - On failure (fn throws): ROLLBACK and re-throw
+     */
+    transaction<R>(fn: (tx: TransactionContext) => R | Promise<R>): Promise<R>;
+    /** Close the database connection and release resources. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/lib/db/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/db/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,4DAA4D;IAC5D,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;IAE/B,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAEpF,gDAAgD;IAChD,QAAQ,IAAI,IAAI,CAAC;CAClB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAE9D,mDAAmD;IACnD,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;IAEzE,iEAAiE;IACjE,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC;CACvF;AAMD;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEvE,yDAAyD;IACzD,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAElF,kEAAkE;IAClE,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAE/F,mEAAmE;IACnE,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,aAAa,CAAC,CAAC,CAAC,CAAC;IAEpB,sDAAsD;IACtD,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAExE;;;;;OAKG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,kBAAkB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE3E,2DAA2D;IAC3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/lib/db/better-sqlite3-adapter.d.ts

@@ -0,0 +1,65 @@
+/**
+ * BetterSqlite3Adapter — Native SQLite Implementation of StorageAdapter
+ *
+ * Uses `better-sqlite3` for production-grade, synchronous SQLite access
+ * with native C++ bindings. Significantly faster than sql.js (WebAssembly)
+ * for most workloads, especially writes and transactions.
+ *
+ * ## Advantages over sql.js:
+ * - Native C++ bindings — ~3-10× faster than WebAssembly
+ * - True WAL mode with file-based databases
+ * - Real prepared statement caching
+ * - Synchronous API (no async overhead for each operation)
+ * - Lower memory overhead
+ *
+ * ## Trade-offs:
+ * - Requires native compilation (node-gyp, prebuild)
+ * - Not available in browser environments
+ * - Not available in some serverless environments
+ *
+ * @module fhir-persistence/db
+ */
+import type { Database as BetterSqlite3Database } from 'better-sqlite3';
+import type { StorageAdapter, PreparedStatement, TransactionContext } from './adapter.js';
+export interface BetterSqlite3Options {
+    /** Database file path, or ':memory:' for in-memory database. */
+    path?: string;
+    /** Enable WAL journal mode (default: true). */
+    wal?: boolean;
+    /** Enable foreign key constraints (default: true). */
+    foreignKeys?: boolean;
+    /** Busy timeout in milliseconds (default: 5000). */
+    busyTimeout?: number;
+    /** Additional PRAGMA statements to execute on init. */
+    pragmas?: Record<string, string | number | boolean>;
+}
+export declare class BetterSqlite3Adapter implements StorageAdapter {
+    private db;
+    private closed;
+    constructor(options?: BetterSqlite3Options);
+    private ensureOpen;
+    execute(sql: string, params?: unknown[]): Promise<{
+        changes: number;
+    }>;
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
+    queryOne<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T | undefined>;
+    queryStream<T = Record<string, unknown>>(sql: string, params?: unknown[]): AsyncIterable<T>;
+    prepare<T = Record<string, unknown>>(sql: string): PreparedStatement<T>;
+    transaction<R>(fn: (tx: TransactionContext) => R | Promise<R>): Promise<R>;
+    close(): Promise<void>;
+    /**
+     * Get the underlying better-sqlite3 Database instance.
+     * Use with caution — bypasses the adapter abstraction.
+     */
+    getRawDatabase(): BetterSqlite3Database;
+    /**
+     * Execute a PRAGMA and return the result.
+     */
+    pragma(statement: string): unknown;
+    /**
+     * Checkpoint WAL file to main database file.
+     * Useful before backup or when shutting down.
+     */
+    checkpoint(mode?: 'PASSIVE' | 'FULL' | 'RESTART' | 'TRUNCATE'): void;
+}
+//# sourceMappingURL=better-sqlite3-adapter.d.ts.map

package/dist/lib/db/better-sqlite3-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"better-sqlite3-adapter.d.ts","sourceRoot":"","sources":["../../../src/db/better-sqlite3-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAM1F,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACrD;AAED,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,EAAE,CAAwB;IAClC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,oBAAyB;IA4B9C,OAAO,CAAC,UAAU;IAWZ,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAM1E,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAKrF,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAKjG,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,aAAa,CAAC,CAAC,CAAC;IAQtG,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC;IAsBjE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,kBAAkB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA6B1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B;;;OAGG;IACH,cAAc,IAAI,qBAAqB;IAIvC;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlC;;;OAGG;IACH,UAAU,CAAC,IAAI,GAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAsB,GAAG,IAAI;CAGhF"}

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

@@ -0,0 +1,87 @@
+/**
+ * SqlDialect — Database-Specific SQL Generation Strategy
+ *
+ * Encapsulates syntax differences between SQLite and PostgreSQL.
+ * Injected into query builders (WhereBuilder, SearchSQLBuilder)
+ * so business logic remains dialect-agnostic.
+ *
+ * v2 upgrade: New file. v1 hardcoded PostgreSQL syntax everywhere.
+ *
+ * @module fhir-persistence/db
+ */
+/**
+ * Strategy object for generating database-specific SQL fragments.
+ *
+ * Each adapter implementation provides a matching dialect instance.
+ */
+export interface SqlDialect {
+    /** Dialect identifier for branching where needed. */
+    readonly name: 'sqlite' | 'postgres';
+    /**
+     * Positional parameter placeholder.
+     * - SQLite: always `?` (index ignored)
+     * - PostgreSQL: `$1`, `$2`, ... (1-based index)
+     */
+    placeholder(index: number): string;
+    /**
+     * Generate a TEXT[] array-contains check.
+     *
+     * Checks if any element of a TEXT[] column matches any of the given values.
+     * - SQLite:      `EXISTS (SELECT 1 FROM json_each("col") WHERE value IN (?,?))`
+     * - PostgreSQL:  `"col" && ARRAY[$1,$2]::text[]`
+     */
+    textArrayContains(column: string, paramCount: number, paramStartIndex: number): {
+        sql: string;
+        values: unknown[];
+    };
+    /**
+     * LIKE expression for string prefix / contains search.
+     * - SQLite:      `"col" LIKE ? ESCAPE '\'`
+     * - PostgreSQL:  `"col" LIKE $1`
+     */
+    like(column: string, paramIndex: number): string;
+    /**
+     * LIMIT / OFFSET clause.
+     * - SQLite:      `LIMIT ? OFFSET ?`
+     * - PostgreSQL:  `LIMIT $1 OFFSET $2`
+     */
+    limitOffset(paramStartIndex: number): {
+        sql: string;
+    };
+    /**
+     * TEXT[] array literal for INSERT/UPDATE values.
+     * - SQLite:      JSON array string, e.g. `'["system|code","|code"]'`
+     * - PostgreSQL:  `ARRAY['system|code','|code']::text[]`
+     */
+    arrayLiteral(values: string[]): string;
+    /**
+     * Timestamp column type.
+     * - SQLite:      `TEXT` (ISO 8601 strings)
+     * - PostgreSQL:  `TIMESTAMPTZ`
+     */
+    timestampType(): string;
+    /**
+     * Boolean column type.
+     * - SQLite:      `INTEGER` (0/1)
+     * - PostgreSQL:  `BOOLEAN`
+     */
+    booleanType(): string;
+    /**
+     * Array column type for TEXT arrays.
+     * - SQLite:      `TEXT` (JSON serialized)
+     * - PostgreSQL:  `TEXT[]` (native)
+     */
+    textArrayType(): string;
+    /**
+     * UPSERT suffix for ON CONFLICT handling.
+     * Both dialects support `ON CONFLICT ... DO UPDATE SET ...`
+     */
+    upsertSuffix(conflictColumn: string, updateColumns: string[]): string;
+    /**
+     * Auto-increment primary key type.
+     * - SQLite:      `INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT`
+     * - PostgreSQL:  `SERIAL PRIMARY KEY` or `INTEGER GENERATED ALWAYS AS IDENTITY`
+     */
+    autoIncrementPK(): string;
+}
+//# sourceMappingURL=dialect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.d.ts","sourceRoot":"","sources":["../../../src/db/dialect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAErC;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnC;;;;;;OAMG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG;QAC9E,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,OAAO,EAAE,CAAC;KACnB,CAAC;IAEF;;;;OAIG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjD;;;;OAIG;IACH,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAEtD;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEvC;;;;OAIG;IACH,aAAa,IAAI,MAAM,CAAC;IAExB;;;;OAIG;IACH,WAAW,IAAI,MAAM,CAAC;IAEtB;;;;OAIG;IACH,aAAa,IAAI,MAAM,CAAC;IAExB;;;OAGG;IACH,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEtE;;;;OAIG;IACH,eAAe,IAAI,MAAM,CAAC;CAC3B"}

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

@@ -0,0 +1,18 @@
+/**
+ * Database module — Public API
+ *
+ * v1 exports: DatabaseClient (PostgreSQL-only)
+ * v2 exports: StorageAdapter / SqlDialect / SQLiteAdapter / SQLiteDialect
+ *
+ * @module fhir-persistence/db
+ */
+export type { StorageAdapter, PreparedStatement, TransactionContext } from './adapter.js';
+export type { SqlDialect } from './dialect.js';
+export { SQLiteAdapter } from './sqlite-adapter.js';
+export { SQLiteDialect } from './sqlite-dialect.js';
+export { BetterSqlite3Adapter } from './better-sqlite3-adapter.js';
+export type { BetterSqlite3Options } from './better-sqlite3-adapter.js';
+export { PostgresAdapter, rewritePlaceholders } from './postgres-adapter.js';
+export type { PgPoolLike, PgClientLike, AsyncTransactionContext } from './postgres-adapter.js';
+export { PostgresDialect } from './postgres-dialect.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/db/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC1F,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGxE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/lib/db/postgres-adapter.d.ts

@@ -0,0 +1,84 @@
+/**
+ * PostgresAdapter — PostgreSQL Implementation of StorageAdapter
+ *
+ * Implements StorageAdapter using a pool-like interface injected at
+ * construction time. Does NOT import `pg` directly — accepts any
+ * object satisfying `PgPoolLike` (duck typing for pg.Pool).
+ *
+ * Key features:
+ * - Automatic `?` → `$1, $2, ...` placeholder rewriting
+ * - Transaction via pool client + BEGIN/COMMIT/ROLLBACK
+ * - queryStream via cursor-like row iteration
+ * - Serialization failure retry (40001) with exponential backoff
+ *
+ * @module fhir-persistence/db
+ */
+import type { StorageAdapter, PreparedStatement, TransactionContext } from './adapter.js';
+/**
+ * Minimal interface that pg.Pool satisfies.
+ * Allows PostgresAdapter to work without importing `pg`.
+ */
+export interface PgPoolLike {
+    query(text: string, values?: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+        rowCount: number | null;
+    }>;
+    connect(): Promise<PgClientLike>;
+    end(): Promise<void>;
+}
+/**
+ * Minimal interface that pg.PoolClient satisfies.
+ */
+export interface PgClientLike {
+    query(text: string, values?: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+        rowCount: number | null;
+    }>;
+    release(): void;
+}
+/**
+ * Rewrite `?` placeholders to PostgreSQL `$1, $2, ...` positional params.
+ *
+ * Handles:
+ * - Skips `?` inside single-quoted string literals
+ * - Sequential numbering starting from $1
+ *
+ * @param sql - SQL with `?` placeholders.
+ * @returns SQL with `$N` placeholders.
+ */
+export declare function rewritePlaceholders(sql: string): string;
+export declare class PostgresAdapter implements StorageAdapter {
+    private readonly pool;
+    private closed;
+    constructor(pool: PgPoolLike);
+    execute(sql: string, params?: unknown[]): Promise<{
+        changes: number;
+    }>;
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
+    queryOne<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T | undefined>;
+    queryStream<T = Record<string, unknown>>(sql: string, params?: unknown[]): AsyncIterable<T>;
+    prepare<T = Record<string, unknown>>(_sql: string): PreparedStatement<T>;
+    transaction<R>(fn: (tx: TransactionContext) => R | Promise<R>): Promise<R>;
+    /**
+     * Async-native transaction for PostgreSQL.
+     *
+     * Unlike the StorageAdapter.transaction() which has synchronous
+     * TransactionContext methods (designed for SQLite), this method
+     * provides async transaction operations matching PG's async nature.
+     */
+    transactionAsync<R>(fn: (tx: AsyncTransactionContext) => Promise<R>): Promise<R>;
+    close(): Promise<void>;
+    private ensureNotClosed;
+}
+/**
+ * Async transaction context for PostgreSQL.
+ * All methods are async (unlike StorageAdapter's sync TransactionContext).
+ */
+export interface AsyncTransactionContext {
+    execute(sql: string, params?: unknown[]): Promise<{
+        changes: number;
+    }>;
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
+    queryOne<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T | undefined>;
+}
+//# sourceMappingURL=postgres-adapter.d.ts.map

package/dist/lib/db/postgres-adapter.d.ts.map

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

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

@@ -0,0 +1,36 @@
+/**
+ * PostgresDialect — PostgreSQL-Specific SQL Generation
+ *
+ * Implements SqlDialect for PostgreSQL syntax:
+ * - `$1, $2, ...` positional placeholders
+ * - Native TEXT[] arrays with `&& ARRAY[...]::text[]`
+ * - TIMESTAMPTZ for timestamps
+ * - BOOLEAN for booleans
+ * - GIN indexes for array contains
+ * - GENERATED ALWAYS AS IDENTITY for auto-increment
+ *
+ * v2 upgrade: New file. v1 hardcoded PG syntax in business logic.
+ * Now encapsulated in this dialect object.
+ *
+ * @module fhir-persistence/db
+ */
+import type { SqlDialect } from './dialect.js';
+export declare class PostgresDialect implements SqlDialect {
+    readonly name: "postgres";
+    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=postgres-dialect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-dialect.d.ts","sourceRoot":"","sources":["../../../src/db/postgres-dialect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,qBAAa,eAAgB,YAAW,UAAU;IAChD,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAEpC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIlC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG;QAC9E,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,OAAO,EAAE,CAAC;KACnB;IAWD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAIhD,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAIrD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM;IAQtC,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/db/sqlite-adapter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * SQLiteAdapter — SQLite Implementation of StorageAdapter
+ *
+ * Uses `sql.js` (WebAssembly-based SQLite) for cross-platform
+ * compatibility without native C++ compilation requirements.
+ *
+ * v2 upgrade: New file. v1 had no SQLite support.
+ *
+ * ## WAL Mode
+ * sql.js runs in-memory by default. For file-based databases,
+ * WAL mode and foreign keys are enabled on construction.
+ *
+ * @module fhir-persistence/db
+ */
+import type { StorageAdapter, PreparedStatement, TransactionContext } from './adapter.js';
+export declare class SQLiteAdapter implements StorageAdapter {
+    private readonly data?;
+    private db;
+    private initPromise;
+    /**
+     * @param path - Database file path, or ':memory:' for in-memory database.
+     * @param data - Optional Uint8Array of an existing database file to load.
+     */
+    constructor(_path?: string, data?: Uint8Array | undefined);
+    private initialize;
+    private getDb;
+    execute(sql: string, params?: unknown[]): Promise<{
+        changes: number;
+    }>;
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
+    queryOne<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T | undefined>;
+    queryStream<T = Record<string, unknown>>(sql: string, params?: unknown[]): AsyncIterable<T>;
+    prepare<T = Record<string, unknown>>(sql: string): PreparedStatement<T>;
+    transaction<R>(fn: (tx: TransactionContext) => R | Promise<R>): Promise<R>;
+    close(): Promise<void>;
+    /**
+     * Export the database as a Uint8Array (for file persistence).
+     */
+    export(): Promise<Uint8Array>;
+}
+//# sourceMappingURL=sqlite-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-adapter.d.ts","sourceRoot":"","sources":["../../../src/db/sqlite-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAsB1F,qBAAa,aAAc,YAAW,cAAc;IAUhD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IATxB,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,WAAW,CAAgB;IAEnC;;;OAGG;gBAED,KAAK,GAAE,MAAmB,EACT,IAAI,CAAC,EAAE,UAAU,YAAA;YAKtB,UAAU;YASV,KAAK;IAQb,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ1E,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAarF,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAajG,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,aAAa,CAAC,CAAC,CAAC;IActG,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC;IAmCjE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,kBAAkB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA6C1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC;CAIpC"}