fhir-persistence 0.1.0 → 0.3.0

package/dist/cjs/index.d.ts

@@ -62,7 +62,7 @@ export declare function buildAllResourceTableSets(sdRegistry: StructureDefinitio
 /**
  * v2: Build a COUNT query using ? placeholders.
  */
-export declare function buildCountSQLv2(request: SearchRequest, registry: SearchParameterRegistry): CountSQL;
+export declare function buildCountSQLv2(request: SearchRequest, registry: SearchParameterRegistry, dialect?: SqlDialect): CountSQL;
 
 /**
  * v2: DELETE all reference rows for a resource (before re-inserting on update).
@@ -244,7 +244,7 @@ export declare function buildSearchColumns(resource: FhirResource, impls: Search
  * v2: Build a complete search SQL query using ? placeholders.
  * No projectId filter. deleted = 0 (INTEGER).
  */
-export declare function buildSearchSQLv2(request: SearchRequest, registry: SearchParameterRegistry): SearchSQL;
+export declare function buildSearchSQLv2(request: SearchRequest, registry: SearchParameterRegistry, dialect?: SqlDialect): SearchSQL;
 
 /**
  * v2: SELECT by ID — no projectId, returns versionId + deleted.
@@ -288,7 +288,7 @@ export declare function buildSelfLink(ctx: PaginationContext): string;
  * @param registry - The SearchParameterRegistry.
  * @returns TwoPhaseSearchSQL with phase1 query and phase2 template.
  */
-export declare function buildTwoPhaseSearchSQLv2(request: SearchRequest, registry: SearchParameterRegistry): TwoPhaseSearchSQL;
+export declare function buildTwoPhaseSearchSQLv2(request: SearchRequest, registry: SearchParameterRegistry, dialect?: SqlDialect): TwoPhaseSearchSQL;
 
 /**
  * v2: Type-level history SELECT.
@@ -315,17 +315,16 @@ export declare function buildUpdateMainSQLv2(tableName: string, columns: Record<
 /**
  * v2: Build a complete WHERE clause from parsed search params using ? placeholders.
  */
-export declare function buildWhereClauseV2(params: ParsedSearchParam[], registry: SearchParameterRegistry, resourceType: string): WhereFragment | null;
+export declare function buildWhereClauseV2(params: ParsedSearchParam[], registry: SearchParameterRegistry, resourceType: string, dialect?: SqlDialect): WhereFragment | null;
 
 /**
- * v2: Build a WHERE clause fragment using ? placeholders (SQLite).
+ * v2: Build a WHERE clause fragment using ? placeholders.
  *
- * Dispatches to type-specific v2 builders. Key differences from v1:
- * - Uses `?` instead of `$N`
- * - Token search uses `json_each()` instead of `ARRAY[]::text[]`
- * - Array columns use `json_each()` instead of PG array operators
+ * Dispatches to type-specific v2 builders. Dialect-aware:
+ * - SQLite: json_each() for array columns
+ * - PostgreSQL: native ARRAY operators
  */
-export declare function buildWhereFragmentV2(impl: SearchParameterImpl, param: ParsedSearchParam): WhereFragment | null;
+export declare function buildWhereFragmentV2(impl: SearchParameterImpl, param: ParsedSearchParam, dialect?: SqlDialect): WhereFragment | null;
 
 declare interface BundleLink {
     relation: string;
@@ -557,7 +556,9 @@ declare type EvictionPolicy = 'lru' | 'fifo' | 'ttl-only';
  * - `deleted` is number (0/1), not boolean
  * - No `_include` / `_revinclude` in this MVP (can be added)
  */
-export declare function executeSearch(adapter: StorageAdapter, request: SearchRequest, registry: SearchParameterRegistry, options?: SearchOptions_2): Promise<SearchResult_2>;
+export declare function executeSearch(adapter: StorageAdapter, request: SearchRequest, registry: SearchParameterRegistry, options?: SearchOptions_2 & {
+    dialect?: SqlDialect;
+}): Promise<SearchResult_2>;
 
 /**
  * A reference extracted from a FHIR resource.
@@ -1656,6 +1657,30 @@ export declare interface PersistedResource extends FhirResource {
     };
 }
 
+/**
+ * Minimal interface that pg.PoolClient satisfies.
+ */
+declare interface PgClientLike {
+    query(text: string, values?: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+        rowCount: number | null;
+    }>;
+    release(): void;
+}
+
+/**
+ * Minimal interface that pg.Pool satisfies.
+ * Allows PostgresAdapter to work without importing `pg`.
+ */
+declare interface PgPoolLike {
+    query(text: string, values?: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+        rowCount: number | null;
+    }>;
+    connect(): Promise<PgClientLike>;
+    end(): Promise<void>;
+}
+
 /**
  * Plan and optimize a search request.
  *
@@ -1680,6 +1705,41 @@ export declare const PLATFORM_RESOURCE_TYPES: ReadonlySet<string>;
 
 export declare const PLATFORM_SEARCH_PARAMETERS: SearchParameterResource[];
 
+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>;
+    close(): Promise<void>;
+    private ensureNotClosed;
+}
+
+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;
+}
+
 /**
  * FHIR search parameter types that support prefixes.
  */
@@ -2745,30 +2805,110 @@ export declare function splitSearchValues(value: string): string[];
  */
 export declare type SqlColumnType = 'TEXT' | 'TEXT[]' | 'BOOLEAN' | 'INTEGER' | 'BIGINT' | 'TIMESTAMPTZ' | 'TIMESTAMPTZ[]' | 'DATE' | 'DATE[]' | 'NUMERIC' | 'DOUBLE PRECISION' | 'DOUBLE PRECISION[]' | 'REAL';
 
-export declare class SQLiteAdapter implements StorageAdapter {
-    private readonly data?;
-    private db;
-    private initPromise;
+/**
+ * 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 declare interface SqlDialect {
+    /** Dialect identifier for branching where needed. */
+    readonly name: 'sqlite' | 'postgres';
     /**
-     * @param path - Database file path, or ':memory:' for in-memory database.
-     * @param data - Optional Uint8Array of an existing database file to load.
+     * Positional parameter placeholder.
+     * - SQLite: always `?` (index ignored)
+     * - PostgreSQL: `$1`, `$2`, ... (1-based index)
      */
-    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>;
+    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;
     /**
-     * Export the database as a Uint8Array (for file persistence).
+     * Auto-increment primary key type.
+     * - SQLite:      `INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT`
+     * - PostgreSQL:  `SERIAL PRIMARY KEY` or `INTEGER GENERATED ALWAYS AS IDENTITY`
      */
-    export(): Promise<Uint8Array>;
+    autoIncrementPK(): string;
+}
+
+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;
 }
 
 /**
@@ -2977,13 +3117,13 @@ export declare class TerminologyCodeRepo {
  */
 export declare interface TransactionContext {
     /** Execute a write operation within the transaction. */
-    execute(sql: string, params?: unknown[]): {
+    execute(sql: string, params?: unknown[]): Promise<{
         changes: number;
-    };
+    }>;
     /** Execute a read query within the transaction. */
-    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): T[];
+    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[]): T | undefined;
+    queryOne<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T | undefined>;
 }
 
 /**

package/dist/esm/index.d.ts

@@ -62,7 +62,7 @@ export declare function buildAllResourceTableSets(sdRegistry: StructureDefinitio
 /**
  * v2: Build a COUNT query using ? placeholders.
  */
-export declare function buildCountSQLv2(request: SearchRequest, registry: SearchParameterRegistry): CountSQL;
+export declare function buildCountSQLv2(request: SearchRequest, registry: SearchParameterRegistry, dialect?: SqlDialect): CountSQL;
 
 /**
  * v2: DELETE all reference rows for a resource (before re-inserting on update).
@@ -244,7 +244,7 @@ export declare function buildSearchColumns(resource: FhirResource, impls: Search
  * v2: Build a complete search SQL query using ? placeholders.
  * No projectId filter. deleted = 0 (INTEGER).
  */
-export declare function buildSearchSQLv2(request: SearchRequest, registry: SearchParameterRegistry): SearchSQL;
+export declare function buildSearchSQLv2(request: SearchRequest, registry: SearchParameterRegistry, dialect?: SqlDialect): SearchSQL;
 
 /**
  * v2: SELECT by ID — no projectId, returns versionId + deleted.
@@ -288,7 +288,7 @@ export declare function buildSelfLink(ctx: PaginationContext): string;
  * @param registry - The SearchParameterRegistry.
  * @returns TwoPhaseSearchSQL with phase1 query and phase2 template.
  */
-export declare function buildTwoPhaseSearchSQLv2(request: SearchRequest, registry: SearchParameterRegistry): TwoPhaseSearchSQL;
+export declare function buildTwoPhaseSearchSQLv2(request: SearchRequest, registry: SearchParameterRegistry, dialect?: SqlDialect): TwoPhaseSearchSQL;
 
 /**
  * v2: Type-level history SELECT.
@@ -315,17 +315,16 @@ export declare function buildUpdateMainSQLv2(tableName: string, columns: Record<
 /**
  * v2: Build a complete WHERE clause from parsed search params using ? placeholders.
  */
-export declare function buildWhereClauseV2(params: ParsedSearchParam[], registry: SearchParameterRegistry, resourceType: string): WhereFragment | null;
+export declare function buildWhereClauseV2(params: ParsedSearchParam[], registry: SearchParameterRegistry, resourceType: string, dialect?: SqlDialect): WhereFragment | null;
 
 /**
- * v2: Build a WHERE clause fragment using ? placeholders (SQLite).
+ * v2: Build a WHERE clause fragment using ? placeholders.
  *
- * Dispatches to type-specific v2 builders. Key differences from v1:
- * - Uses `?` instead of `$N`
- * - Token search uses `json_each()` instead of `ARRAY[]::text[]`
- * - Array columns use `json_each()` instead of PG array operators
+ * Dispatches to type-specific v2 builders. Dialect-aware:
+ * - SQLite: json_each() for array columns
+ * - PostgreSQL: native ARRAY operators
  */
-export declare function buildWhereFragmentV2(impl: SearchParameterImpl, param: ParsedSearchParam): WhereFragment | null;
+export declare function buildWhereFragmentV2(impl: SearchParameterImpl, param: ParsedSearchParam, dialect?: SqlDialect): WhereFragment | null;
 
 declare interface BundleLink {
     relation: string;
@@ -557,7 +556,9 @@ declare type EvictionPolicy = 'lru' | 'fifo' | 'ttl-only';
  * - `deleted` is number (0/1), not boolean
  * - No `_include` / `_revinclude` in this MVP (can be added)
  */
-export declare function executeSearch(adapter: StorageAdapter, request: SearchRequest, registry: SearchParameterRegistry, options?: SearchOptions_2): Promise<SearchResult_2>;
+export declare function executeSearch(adapter: StorageAdapter, request: SearchRequest, registry: SearchParameterRegistry, options?: SearchOptions_2 & {
+    dialect?: SqlDialect;
+}): Promise<SearchResult_2>;
 
 /**
  * A reference extracted from a FHIR resource.
@@ -1656,6 +1657,30 @@ export declare interface PersistedResource extends FhirResource {
     };
 }
 
+/**
+ * Minimal interface that pg.PoolClient satisfies.
+ */
+declare interface PgClientLike {
+    query(text: string, values?: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+        rowCount: number | null;
+    }>;
+    release(): void;
+}
+
+/**
+ * Minimal interface that pg.Pool satisfies.
+ * Allows PostgresAdapter to work without importing `pg`.
+ */
+declare interface PgPoolLike {
+    query(text: string, values?: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+        rowCount: number | null;
+    }>;
+    connect(): Promise<PgClientLike>;
+    end(): Promise<void>;
+}
+
 /**
  * Plan and optimize a search request.
  *
@@ -1680,6 +1705,41 @@ export declare const PLATFORM_RESOURCE_TYPES: ReadonlySet<string>;
 
 export declare const PLATFORM_SEARCH_PARAMETERS: SearchParameterResource[];
 
+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>;
+    close(): Promise<void>;
+    private ensureNotClosed;
+}
+
+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;
+}
+
 /**
  * FHIR search parameter types that support prefixes.
  */
@@ -2745,30 +2805,110 @@ export declare function splitSearchValues(value: string): string[];
  */
 export declare type SqlColumnType = 'TEXT' | 'TEXT[]' | 'BOOLEAN' | 'INTEGER' | 'BIGINT' | 'TIMESTAMPTZ' | 'TIMESTAMPTZ[]' | 'DATE' | 'DATE[]' | 'NUMERIC' | 'DOUBLE PRECISION' | 'DOUBLE PRECISION[]' | 'REAL';
 
-export declare class SQLiteAdapter implements StorageAdapter {
-    private readonly data?;
-    private db;
-    private initPromise;
+/**
+ * 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 declare interface SqlDialect {
+    /** Dialect identifier for branching where needed. */
+    readonly name: 'sqlite' | 'postgres';
     /**
-     * @param path - Database file path, or ':memory:' for in-memory database.
-     * @param data - Optional Uint8Array of an existing database file to load.
+     * Positional parameter placeholder.
+     * - SQLite: always `?` (index ignored)
+     * - PostgreSQL: `$1`, `$2`, ... (1-based index)
      */
-    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>;
+    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;
     /**
-     * Export the database as a Uint8Array (for file persistence).
+     * Auto-increment primary key type.
+     * - SQLite:      `INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT`
+     * - PostgreSQL:  `SERIAL PRIMARY KEY` or `INTEGER GENERATED ALWAYS AS IDENTITY`
      */
-    export(): Promise<Uint8Array>;
+    autoIncrementPK(): string;
+}
+
+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;
 }
 
 /**
@@ -2977,13 +3117,13 @@ export declare class TerminologyCodeRepo {
  */
 export declare interface TransactionContext {
     /** Execute a write operation within the transaction. */
-    execute(sql: string, params?: unknown[]): {
+    execute(sql: string, params?: unknown[]): Promise<{
         changes: number;
-    };
+    }>;
     /** Execute a read query within the transaction. */
-    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): T[];
+    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[]): T | undefined;
+    queryOne<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T | undefined>;
 }
 
 /**