lakesync 0.1.0

package/dist/chunk-X3RO5SYJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../adapter/src/shared.ts","../../adapter/src/bigquery.ts","../../adapter/src/composite.ts","../../adapter/src/db-types.ts","../../adapter/src/mysql.ts","../../adapter/src/postgres.ts","../../adapter/src/factory.ts","../../adapter/src/fan-out.ts","../../adapter/src/lifecycle.ts","../../adapter/src/migrate.ts","../../adapter/src/minio.ts","../../adapter/src/query-fn.ts"],"sourcesContent":["import { AdapterError, type ColumnDelta, Err, Ok, type Result } from \"@lakesync/core\";\n\n/** Normalise a caught value into an Error or undefined. */\nexport function toCause(error: unknown): Error | undefined {\n\treturn error instanceof Error ? error : undefined;\n}\n\n/** Execute an async operation and wrap errors into an AdapterError Result. */\nexport async function wrapAsync<T>(\n\toperation: () => Promise<T>,\n\terrorMessage: string,\n): Promise<Result<T, AdapterError>> {\n\ttry {\n\t\tconst value = await operation();\n\t\treturn Ok(value);\n\t} catch (error) {\n\t\tif (error instanceof AdapterError) {\n\t\t\treturn Err(error);\n\t\t}\n\t\treturn Err(new AdapterError(errorMessage, toCause(error)));\n\t}\n}\n\n/**\n * Merge delta rows into final state using column-level LWW.\n * Shared by Postgres, MySQL, and BigQuery getLatestState implementations.\n * Rows must be sorted by HLC ascending.\n */\nexport function mergeLatestState(\n\trows: Array<{ columns: string | ColumnDelta[]; op: string }>,\n): Record<string, unknown> | null {\n\tif (rows.length === 0) return null;\n\n\tconst lastRow = rows[rows.length - 1]!;\n\tif (lastRow.op === \"DELETE\") return null;\n\n\tconst state: Record<string, unknown> = {};\n\n\tfor (const row of rows) {\n\t\tif (row.op === \"DELETE\") {\n\t\t\tfor (const key of Object.keys(state)) {\n\t\t\t\tdelete state[key];\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst columns: ColumnDelta[] =\n\t\t\ttypeof row.columns === \"string\" ? JSON.parse(row.columns) : row.columns;\n\n\t\tfor (const col of columns) {\n\t\t\tstate[col.column] = col.value;\n\t\t}\n\t}\n\n\treturn state;\n}\n","import { BigQuery } from \"@google-cloud/bigquery\";\nimport {\n\ttype AdapterError,\n\ttype ColumnDelta,\n\ttype HLCTimestamp,\n\tOk,\n\ttype Result,\n\ttype RowDelta,\n\ttype TableSchema,\n} from \"@lakesync/core\";\nimport type { DatabaseAdapter } from \"./db-types\";\nimport { mergeLatestState, wrapAsync } from \"./shared\";\n\n/**\n * Configuration for the BigQuery adapter.\n * Unlike SQL adapters, BigQuery is HTTP-based — no connection string needed.\n */\nexport interface BigQueryAdapterConfig {\n\t/** GCP project ID. */\n\tprojectId: string;\n\t/** BigQuery dataset name. */\n\tdataset: string;\n\t/** Path to a service account JSON key file. Falls back to ADC if omitted. */\n\tkeyFilename?: string;\n\t/** Dataset location (default: \"US\"). */\n\tlocation?: string;\n}\n\n/** Shape of a row returned from the lakesync_deltas table. */\ninterface BigQueryDeltaRow {\n\tdelta_id: string;\n\ttable: string;\n\trow_id: string;\n\tcolumns: string;\n\thlc: { value: string } | string | number;\n\tclient_id: string;\n\top: string;\n}\n\n/**\n * Convert a raw BigQuery row into a RowDelta.\n * BigQuery returns INT64 as `{ value: string }` objects to avoid precision loss.\n */\nfunction rowToRowDelta(row: BigQueryDeltaRow): RowDelta {\n\tconst columns: ColumnDelta[] =\n\t\ttypeof row.columns === \"string\" ? JSON.parse(row.columns) : row.columns;\n\n\t// BigQuery INT64 comes back as { value: \"123\" } to preserve precision\n\tconst hlcRaw = row.hlc;\n\tconst hlcString =\n\t\ttypeof hlcRaw === \"object\" && hlcRaw !== null && \"value\" in hlcRaw\n\t\t\t? hlcRaw.value\n\t\t\t: String(hlcRaw);\n\n\treturn {\n\t\tdeltaId: row.delta_id,\n\t\ttable: row.table,\n\t\trowId: row.row_id,\n\t\tcolumns,\n\t\thlc: BigInt(hlcString) as HLCTimestamp,\n\t\tclientId: row.client_id,\n\t\top: row.op as RowDelta[\"op\"],\n\t};\n}\n\n/**\n * BigQuery database adapter for LakeSync.\n *\n * Stores deltas in a `lakesync_deltas` table using standard SQL DML.\n * Idempotent inserts via MERGE statement. All public methods return\n * `Result` and never throw.\n *\n * **Note:** BigQuery DML is limited to 1,500 statements per table per day\n * on standard (non-partitioned) tables. Query latency is seconds, not\n * milliseconds — this adapter is designed for the analytics tier.\n */\nexport class BigQueryAdapter implements DatabaseAdapter {\n\t/** @internal */\n\treadonly client: BigQuery;\n\t/** @internal */\n\treadonly dataset: string;\n\t/** @internal */\n\treadonly location: string;\n\n\tconstructor(config: BigQueryAdapterConfig) {\n\t\tthis.client = new BigQuery({\n\t\t\tprojectId: config.projectId,\n\t\t\tkeyFilename: config.keyFilename,\n\t\t});\n\t\tthis.dataset = config.dataset;\n\t\tthis.location = config.location ?? \"US\";\n\t}\n\n\t/**\n\t * Insert deltas into the database in a single batch.\n\t * Idempotent via MERGE — existing deltaIds are silently skipped.\n\t */\n\tasync insertDeltas(deltas: RowDelta[]): Promise<Result<void, AdapterError>> {\n\t\tif (deltas.length === 0) {\n\t\t\treturn Ok(undefined);\n\t\t}\n\n\t\treturn wrapAsync(async () => {\n\t\t\t// Build MERGE source from UNION ALL of parameterised SELECTs\n\t\t\tconst params: Record<string, string> = {};\n\t\t\tconst selects: string[] = [];\n\n\t\t\tfor (let i = 0; i < deltas.length; i++) {\n\t\t\t\tconst d = deltas[i]!;\n\t\t\t\tparams[`did_${i}`] = d.deltaId;\n\t\t\t\tparams[`tbl_${i}`] = d.table;\n\t\t\t\tparams[`rid_${i}`] = d.rowId;\n\t\t\t\tparams[`col_${i}`] = JSON.stringify(d.columns);\n\t\t\t\tparams[`hlc_${i}`] = d.hlc.toString();\n\t\t\t\tparams[`cid_${i}`] = d.clientId;\n\t\t\t\tparams[`op_${i}`] = d.op;\n\n\t\t\t\tselects.push(\n\t\t\t\t\t`SELECT @did_${i} AS delta_id, @tbl_${i} AS \\`table\\`, @rid_${i} AS row_id, @col_${i} AS columns, CAST(@hlc_${i} AS INT64) AS hlc, @cid_${i} AS client_id, @op_${i} AS op`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tconst sql = `MERGE \\`${this.dataset}.lakesync_deltas\\` AS target\nUSING (${selects.join(\" UNION ALL \")}) AS source\nON target.delta_id = source.delta_id\nWHEN NOT MATCHED THEN INSERT (delta_id, \\`table\\`, row_id, columns, hlc, client_id, op)\nVALUES (source.delta_id, source.\\`table\\`, source.row_id, source.columns, source.hlc, source.client_id, source.op)`;\n\n\t\t\tawait this.client.query({ query: sql, params, location: this.location });\n\t\t}, \"Failed to insert deltas\");\n\t}\n\n\t/**\n\t * Query deltas with HLC greater than the given timestamp, optionally filtered by table.\n\t */\n\tasync queryDeltasSince(\n\t\thlc: HLCTimestamp,\n\t\ttables?: string[],\n\t): Promise<Result<RowDelta[], AdapterError>> {\n\t\treturn wrapAsync(async () => {\n\t\t\tlet sql: string;\n\t\t\tconst params: Record<string, string | string[]> = {\n\t\t\t\tsinceHlc: hlc.toString(),\n\t\t\t};\n\n\t\t\tif (tables && tables.length > 0) {\n\t\t\t\tsql = `SELECT delta_id, \\`table\\`, row_id, columns, hlc, client_id, op\nFROM \\`${this.dataset}.lakesync_deltas\\`\nWHERE hlc > CAST(@sinceHlc AS INT64) AND \\`table\\` IN UNNEST(@tables)\nORDER BY hlc ASC`;\n\t\t\t\tparams.tables = tables;\n\t\t\t} else {\n\t\t\t\tsql = `SELECT delta_id, \\`table\\`, row_id, columns, hlc, client_id, op\nFROM \\`${this.dataset}.lakesync_deltas\\`\nWHERE hlc > CAST(@sinceHlc AS INT64)\nORDER BY hlc ASC`;\n\t\t\t}\n\n\t\t\tconst [rows] = await this.client.query({\n\t\t\t\tquery: sql,\n\t\t\t\tparams,\n\t\t\t\tlocation: this.location,\n\t\t\t});\n\t\t\treturn (rows as BigQueryDeltaRow[]).map(rowToRowDelta);\n\t\t}, \"Failed to query deltas\");\n\t}\n\n\t/**\n\t * Get the latest merged state for a specific row using column-level LWW.\n\t * Returns null if no deltas exist for this row.\n\t */\n\tasync getLatestState(\n\t\ttable: string,\n\t\trowId: string,\n\t): Promise<Result<Record<string, unknown> | null, AdapterError>> {\n\t\treturn wrapAsync(async () => {\n\t\t\tconst sql = `SELECT columns, hlc, client_id, op\nFROM \\`${this.dataset}.lakesync_deltas\\`\nWHERE \\`table\\` = @tbl AND row_id = @rid\nORDER BY hlc ASC`;\n\n\t\t\tconst [rows] = await this.client.query({\n\t\t\t\tquery: sql,\n\t\t\t\tparams: { tbl: table, rid: rowId },\n\t\t\t\tlocation: this.location,\n\t\t\t});\n\t\t\treturn mergeLatestState(rows as BigQueryDeltaRow[]);\n\t\t}, `Failed to get latest state for ${table}:${rowId}`);\n\t}\n\n\t/**\n\t * Ensure the BigQuery dataset and lakesync_deltas table exist.\n\t * The `schema` parameter is accepted for interface compliance but the\n\t * internal table structure is fixed (deltas store column data as JSON).\n\t */\n\tasync ensureSchema(_schema: TableSchema): Promise<Result<void, AdapterError>> {\n\t\treturn wrapAsync(async () => {\n\t\t\t// Create dataset if it doesn't exist\n\t\t\tconst datasetRef = this.client.dataset(this.dataset);\n\t\t\tconst [datasetExists] = await datasetRef.exists();\n\t\t\tif (!datasetExists) {\n\t\t\t\tawait this.client.createDataset(this.dataset, {\n\t\t\t\t\tlocation: this.location,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\t// Create the deltas table\n\t\t\tawait this.client.query({\n\t\t\t\tquery: `CREATE TABLE IF NOT EXISTS \\`${this.dataset}.lakesync_deltas\\` (\n\tdelta_id STRING NOT NULL,\n\t\\`table\\` STRING NOT NULL,\n\trow_id STRING NOT NULL,\n\tcolumns JSON NOT NULL,\n\thlc INT64 NOT NULL,\n\tclient_id STRING NOT NULL,\n\top STRING NOT NULL\n)\nCLUSTER BY \\`table\\`, hlc`,\n\t\t\t\tlocation: this.location,\n\t\t\t});\n\t\t}, \"Failed to ensure schema\");\n\t}\n\n\t/**\n\t * No-op — BigQuery client is HTTP-based with no persistent connections.\n\t */\n\tasync close(): Promise<void> {\n\t\t// No-op: BigQuery uses HTTP requests, no connection pool to close\n\t}\n}\n","import {\n\ttype AdapterError,\n\ttype HLCTimestamp,\n\tOk,\n\ttype Result,\n\ttype RowDelta,\n\ttype TableSchema,\n} from \"@lakesync/core\";\n\nimport type { DatabaseAdapter } from \"./db-types\";\n\n/** A routing rule that maps specific tables to a database adapter. */\nexport interface CompositeRoute {\n\t/** Tables handled by this adapter */\n\ttables: string[];\n\t/** The adapter for these tables */\n\tadapter: DatabaseAdapter;\n}\n\n/** Configuration for CompositeAdapter routing. */\nexport interface CompositeAdapterConfig {\n\t/** Table-to-adapter routing rules */\n\troutes: CompositeRoute[];\n\t/** Fallback adapter for tables not matching any route */\n\tdefaultAdapter: DatabaseAdapter;\n}\n\n/**\n * Routes database operations to different adapters based on table name.\n * Implements DatabaseAdapter so it can be used as a drop-in replacement.\n */\nexport class CompositeAdapter implements DatabaseAdapter {\n\tprivate readonly routeMap: Map<string, DatabaseAdapter>;\n\tprivate readonly adapters: Set<DatabaseAdapter>;\n\tprivate readonly defaultAdapter: DatabaseAdapter;\n\n\tconstructor(config: CompositeAdapterConfig) {\n\t\tthis.routeMap = new Map();\n\t\tthis.adapters = new Set();\n\t\tthis.defaultAdapter = config.defaultAdapter;\n\t\tthis.adapters.add(config.defaultAdapter);\n\n\t\tfor (const route of config.routes) {\n\t\t\tthis.adapters.add(route.adapter);\n\t\t\tfor (const table of route.tables) {\n\t\t\t\tif (this.routeMap.has(table)) {\n\t\t\t\t\tthrow new Error(`Duplicate table route: \"${table}\" appears in multiple routes`);\n\t\t\t\t}\n\t\t\t\tthis.routeMap.set(table, route.adapter);\n\t\t\t}\n\t\t}\n\t}\n\n\t/** Insert deltas, routing each group to the correct adapter by table. */\n\tasync insertDeltas(deltas: RowDelta[]): Promise<Result<void, AdapterError>> {\n\t\tconst groups = new Map<DatabaseAdapter, RowDelta[]>();\n\n\t\tfor (const delta of deltas) {\n\t\t\tconst adapter = this.routeMap.get(delta.table) ?? this.defaultAdapter;\n\t\t\tlet group = groups.get(adapter);\n\t\t\tif (!group) {\n\t\t\t\tgroup = [];\n\t\t\t\tgroups.set(adapter, group);\n\t\t\t}\n\t\t\tgroup.push(delta);\n\t\t}\n\n\t\tfor (const [adapter, group] of groups) {\n\t\t\tconst result = await adapter.insertDeltas(group);\n\t\t\tif (!result.ok) {\n\t\t\t\treturn result;\n\t\t\t}\n\t\t}\n\n\t\treturn Ok(undefined);\n\t}\n\n\t/** Query deltas since a given HLC, fanning out to relevant adapters and merging results. */\n\tasync queryDeltasSince(\n\t\thlc: HLCTimestamp,\n\t\ttables?: string[],\n\t): Promise<Result<RowDelta[], AdapterError>> {\n\t\tconst adapterSet = new Set<DatabaseAdapter>();\n\t\tconst adapterTables = new Map<DatabaseAdapter, string[]>();\n\n\t\tif (tables && tables.length > 0) {\n\t\t\tfor (const table of tables) {\n\t\t\t\tconst adapter = this.routeMap.get(table) ?? this.defaultAdapter;\n\t\t\t\tadapterSet.add(adapter);\n\t\t\t\tlet existing = adapterTables.get(adapter);\n\t\t\t\tif (!existing) {\n\t\t\t\t\texisting = [];\n\t\t\t\t\tadapterTables.set(adapter, existing);\n\t\t\t\t}\n\t\t\t\texisting.push(table);\n\t\t\t}\n\t\t} else {\n\t\t\tfor (const adapter of this.adapters) {\n\t\t\t\tadapterSet.add(adapter);\n\t\t\t}\n\t\t}\n\n\t\tconst merged: RowDelta[] = [];\n\n\t\tfor (const adapter of adapterSet) {\n\t\t\tconst filterTables = adapterTables.get(adapter);\n\t\t\tconst result = await adapter.queryDeltasSince(hlc, filterTables);\n\t\t\tif (!result.ok) {\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tmerged.push(...result.value);\n\t\t}\n\n\t\tmerged.sort((a, b) => (a.hlc < b.hlc ? -1 : a.hlc > b.hlc ? 1 : 0));\n\n\t\treturn Ok(merged);\n\t}\n\n\t/** Get the latest state for a row, routing to the correct adapter. */\n\tasync getLatestState(\n\t\ttable: string,\n\t\trowId: string,\n\t): Promise<Result<Record<string, unknown> | null, AdapterError>> {\n\t\tconst adapter = this.routeMap.get(table) ?? this.defaultAdapter;\n\t\treturn adapter.getLatestState(table, rowId);\n\t}\n\n\t/** Ensure schema exists, routing to the correct adapter for the table. */\n\tasync ensureSchema(schema: TableSchema): Promise<Result<void, AdapterError>> {\n\t\tconst adapter = this.routeMap.get(schema.table) ?? this.defaultAdapter;\n\t\treturn adapter.ensureSchema(schema);\n\t}\n\n\t/** Close all unique adapters (routes + default, deduplicated). */\n\tasync close(): Promise<void> {\n\t\tfor (const adapter of this.adapters) {\n\t\t\tawait adapter.close();\n\t\t}\n\t}\n}\n","import type { AdapterError, HLCTimestamp, Result, RowDelta, TableSchema } from \"@lakesync/core\";\n\n/** Configuration for a database adapter connection. */\nexport interface DatabaseAdapterConfig {\n\t/** Connection string (e.g. postgres://user:pass@host/db) */\n\tconnectionString: string;\n}\n\n/**\n * Abstract interface for SQL database storage operations.\n * Alternative to LakeAdapter for small-data backends (Postgres, MySQL, etc).\n */\nexport interface DatabaseAdapter {\n\t/** Insert deltas into the database in a single batch. Idempotent via deltaId uniqueness. */\n\tinsertDeltas(deltas: RowDelta[]): Promise<Result<void, AdapterError>>;\n\n\t/** Query deltas with HLC greater than the given timestamp, optionally filtered by table. */\n\tqueryDeltasSince(hlc: HLCTimestamp, tables?: string[]): Promise<Result<RowDelta[], AdapterError>>;\n\n\t/** Get the latest merged state for a specific row. Returns null if the row doesn't exist. */\n\tgetLatestState(\n\t\ttable: string,\n\t\trowId: string,\n\t): Promise<Result<Record<string, unknown> | null, AdapterError>>;\n\n\t/** Ensure the database schema matches the given TableSchema. Creates/alters tables as needed. */\n\tensureSchema(schema: TableSchema): Promise<Result<void, AdapterError>>;\n\n\t/** Close the database connection and release resources. */\n\tclose(): Promise<void>;\n}\n\n/**\n * Map a LakeSync column type to a BigQuery column definition.\n */\nconst BIGQUERY_TYPE_MAP: Record<TableSchema[\"columns\"][number][\"type\"], string> = {\n\tstring: \"STRING\",\n\tnumber: \"FLOAT64\",\n\tboolean: \"BOOL\",\n\tjson: \"JSON\",\n\tnull: \"STRING\",\n};\n\nexport function lakeSyncTypeToBigQuery(type: TableSchema[\"columns\"][number][\"type\"]): string {\n\treturn BIGQUERY_TYPE_MAP[type];\n}\n\n/** Type guard to distinguish DatabaseAdapter from LakeAdapter at runtime. */\nexport function isDatabaseAdapter(adapter: unknown): adapter is DatabaseAdapter {\n\treturn (\n\t\tadapter !== null &&\n\t\ttypeof adapter === \"object\" &&\n\t\t\"insertDeltas\" in adapter &&\n\t\t\"queryDeltasSince\" in adapter &&\n\t\ttypeof (adapter as DatabaseAdapter).insertDeltas === \"function\"\n\t);\n}\n","import {\n\ttype AdapterError,\n\ttype HLCTimestamp,\n\tOk,\n\ttype Result,\n\ttype RowDelta,\n\ttype TableSchema,\n} from \"@lakesync/core\";\nimport mysql from \"mysql2/promise\";\nimport type { DatabaseAdapter, DatabaseAdapterConfig } from \"./db-types\";\nimport { mergeLatestState, wrapAsync } from \"./shared\";\n\n/**\n * Map a LakeSync column type to a MySQL column definition.\n */\nconst MYSQL_TYPE_MAP: Record<TableSchema[\"columns\"][number][\"type\"], string> = {\n\tstring: \"TEXT\",\n\tnumber: \"DOUBLE\",\n\tboolean: \"TINYINT(1)\",\n\tjson: \"JSON\",\n\tnull: \"TEXT\",\n};\n\nfunction lakeSyncTypeToMySQL(type: TableSchema[\"columns\"][number][\"type\"]): string {\n\treturn MYSQL_TYPE_MAP[type];\n}\n\n/**\n * MySQL database adapter for LakeSync.\n *\n * Stores deltas in a `lakesync_deltas` table using INSERT IGNORE for\n * idempotent writes. All public methods return `Result` and never throw.\n * Uses mysql2/promise connection pool for async operations.\n */\nexport class MySQLAdapter implements DatabaseAdapter {\n\t/** @internal */\n\treadonly pool: mysql.Pool;\n\n\tconstructor(config: DatabaseAdapterConfig) {\n\t\tthis.pool = mysql.createPool(config.connectionString);\n\t}\n\n\t/**\n\t * Insert deltas into the database in a single batch.\n\t * Uses INSERT IGNORE for idempotent writes — duplicate deltaIds are silently skipped.\n\t */\n\tasync insertDeltas(deltas: RowDelta[]): Promise<Result<void, AdapterError>> {\n\t\tif (deltas.length === 0) {\n\t\t\treturn Ok(undefined);\n\t\t}\n\n\t\treturn wrapAsync(async () => {\n\t\t\tconst sql = `INSERT IGNORE INTO lakesync_deltas (delta_id, \\`table\\`, row_id, columns, hlc, client_id, op) VALUES ${deltas.map(() => \"(?, ?, ?, ?, ?, ?, ?)\").join(\", \")}`;\n\n\t\t\tconst values: unknown[] = [];\n\t\t\tfor (const delta of deltas) {\n\t\t\t\tvalues.push(\n\t\t\t\t\tdelta.deltaId,\n\t\t\t\t\tdelta.table,\n\t\t\t\t\tdelta.rowId,\n\t\t\t\t\tJSON.stringify(delta.columns),\n\t\t\t\t\tdelta.hlc.toString(),\n\t\t\t\t\tdelta.clientId,\n\t\t\t\t\tdelta.op,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tawait this.pool.execute(sql, values);\n\t\t}, \"Failed to insert deltas\");\n\t}\n\n\t/**\n\t * Query deltas with HLC greater than the given timestamp.\n\t * Optionally filtered by table name(s).\n\t */\n\tasync queryDeltasSince(\n\t\thlc: HLCTimestamp,\n\t\ttables?: string[],\n\t): Promise<Result<RowDelta[], AdapterError>> {\n\t\treturn wrapAsync(async () => {\n\t\t\tlet sql =\n\t\t\t\t\"SELECT delta_id, `table`, row_id, columns, hlc, client_id, op FROM lakesync_deltas WHERE hlc > ?\";\n\t\t\tconst params: unknown[] = [hlc.toString()];\n\n\t\t\tif (tables && tables.length > 0) {\n\t\t\t\tsql += ` AND \\`table\\` IN (${tables.map(() => \"?\").join(\", \")})`;\n\t\t\t\tparams.push(...tables);\n\t\t\t}\n\n\t\t\tsql += \" ORDER BY hlc ASC\";\n\n\t\t\tconst [rows] = await this.pool.execute(sql, params);\n\t\t\treturn (rows as MySQLDeltaRow[]).map(rowToDelta);\n\t\t}, \"Failed to query deltas\");\n\t}\n\n\t/**\n\t * Get the latest merged state for a specific row using column-level LWW.\n\t * Returns null if no deltas exist or if the row is tombstoned by DELETE.\n\t */\n\tasync getLatestState(\n\t\ttable: string,\n\t\trowId: string,\n\t): Promise<Result<Record<string, unknown> | null, AdapterError>> {\n\t\treturn wrapAsync(async () => {\n\t\t\tconst sql =\n\t\t\t\t\"SELECT columns, hlc, client_id, op FROM lakesync_deltas WHERE `table` = ? AND row_id = ? ORDER BY hlc ASC\";\n\t\t\tconst [rows] = await this.pool.execute(sql, [table, rowId]);\n\t\t\treturn mergeLatestState(rows as MySQLDeltaRow[]);\n\t\t}, `Failed to get latest state for ${table}:${rowId}`);\n\t}\n\n\t/**\n\t * Ensure the database schema exists. Creates the lakesync_deltas table\n\t * and a user table matching the given TableSchema definition.\n\t */\n\tasync ensureSchema(schema: TableSchema): Promise<Result<void, AdapterError>> {\n\t\treturn wrapAsync(async () => {\n\t\t\t// Create the deltas table\n\t\t\tawait this.pool.execute(`\n\t\t\t\tCREATE TABLE IF NOT EXISTS lakesync_deltas (\n\t\t\t\t\tdelta_id VARCHAR(255) PRIMARY KEY,\n\t\t\t\t\t\\`table\\` VARCHAR(255) NOT NULL,\n\t\t\t\t\trow_id VARCHAR(255) NOT NULL,\n\t\t\t\t\tcolumns JSON NOT NULL,\n\t\t\t\t\thlc BIGINT NOT NULL,\n\t\t\t\t\tclient_id VARCHAR(255) NOT NULL,\n\t\t\t\t\top VARCHAR(50) NOT NULL DEFAULT 'upsert',\n\t\t\t\t\tINDEX idx_hlc (hlc),\n\t\t\t\t\tINDEX idx_table_row (\\`table\\`, row_id)\n\t\t\t\t)\n\t\t\t`);\n\n\t\t\t// Create the user-defined table\n\t\t\tconst columnDefs = schema.columns\n\t\t\t\t.map((col) => `\\`${col.name}\\` ${lakeSyncTypeToMySQL(col.type)}`)\n\t\t\t\t.join(\", \");\n\n\t\t\tawait this.pool.execute(\n\t\t\t\t`CREATE TABLE IF NOT EXISTS \\`${schema.table}\\` (row_id VARCHAR(255) PRIMARY KEY, ${columnDefs})`,\n\t\t\t);\n\t\t}, `Failed to ensure schema for table ${schema.table}`);\n\t}\n\n\t/** Close the database connection pool and release resources. */\n\tasync close(): Promise<void> {\n\t\tawait this.pool.end();\n\t}\n}\n\n/** Shape of a row returned from the lakesync_deltas table. */\ninterface MySQLDeltaRow {\n\tdelta_id: string;\n\ttable: string;\n\trow_id: string;\n\tcolumns: string;\n\thlc: string | bigint;\n\tclient_id: string;\n\top: string;\n}\n\n/**\n * Convert a raw MySQL row into a RowDelta.\n * Handles both string and bigint HLC representations.\n */\nfunction rowToDelta(row: MySQLDeltaRow): RowDelta {\n\treturn {\n\t\tdeltaId: row.delta_id,\n\t\ttable: row.table,\n\t\trowId: row.row_id,\n\t\tcolumns: typeof row.columns === \"string\" ? JSON.parse(row.columns) : row.columns,\n\t\thlc: BigInt(row.hlc) as HLCTimestamp,\n\t\tclientId: row.client_id,\n\t\top: row.op as RowDelta[\"op\"],\n\t};\n}\n","import {\n\ttype AdapterError,\n\ttype ColumnDelta,\n\ttype HLCTimestamp,\n\tOk,\n\ttype Result,\n\ttype RowDelta,\n\ttype TableSchema,\n} from \"@lakesync/core\";\nimport { Pool, type PoolConfig } from \"pg\";\nimport type { DatabaseAdapter, DatabaseAdapterConfig } from \"./db-types\";\nimport { mergeLatestState, wrapAsync } from \"./shared\";\n\n/**\n * PostgreSQL database adapter for LakeSync.\n *\n * Stores deltas in a `lakesync_deltas` table using pg Pool.\n * All public methods return `Result` and never throw.\n */\nexport class PostgresAdapter implements DatabaseAdapter {\n\t/** @internal */\n\treadonly pool: Pool;\n\n\tconstructor(config: DatabaseAdapterConfig) {\n\t\tconst poolConfig: PoolConfig = {\n\t\t\tconnectionString: config.connectionString,\n\t\t};\n\t\tthis.pool = new Pool(poolConfig);\n\t}\n\n\t/**\n\t * Insert deltas into the database in a single batch.\n\t * Idempotent via `ON CONFLICT (delta_id) DO NOTHING`.\n\t */\n\tasync insertDeltas(deltas: RowDelta[]): Promise<Result<void, AdapterError>> {\n\t\tif (deltas.length === 0) {\n\t\t\treturn Ok(undefined);\n\t\t}\n\n\t\treturn wrapAsync(async () => {\n\t\t\t// Build a multi-row INSERT with parameterised values\n\t\t\tconst values: unknown[] = [];\n\t\t\tconst rows: string[] = [];\n\n\t\t\tfor (let i = 0; i < deltas.length; i++) {\n\t\t\t\tconst d = deltas[i]!;\n\t\t\t\tconst offset = i * 7;\n\t\t\t\trows.push(\n\t\t\t\t\t`($${offset + 1}, $${offset + 2}, $${offset + 3}, $${offset + 4}, $${offset + 5}, $${offset + 6}, $${offset + 7})`,\n\t\t\t\t);\n\t\t\t\tvalues.push(\n\t\t\t\t\td.deltaId,\n\t\t\t\t\td.table,\n\t\t\t\t\td.rowId,\n\t\t\t\t\tJSON.stringify(d.columns),\n\t\t\t\t\td.hlc.toString(),\n\t\t\t\t\td.clientId,\n\t\t\t\t\td.op,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tconst sql = `INSERT INTO lakesync_deltas (delta_id, \"table\", row_id, columns, hlc, client_id, op)\nVALUES ${rows.join(\", \")}\nON CONFLICT (delta_id) DO NOTHING`;\n\n\t\t\tawait this.pool.query(sql, values);\n\t\t}, \"Failed to insert deltas\");\n\t}\n\n\t/**\n\t * Query deltas with HLC greater than the given timestamp, optionally filtered by table.\n\t */\n\tasync queryDeltasSince(\n\t\thlc: HLCTimestamp,\n\t\ttables?: string[],\n\t): Promise<Result<RowDelta[], AdapterError>> {\n\t\treturn wrapAsync(async () => {\n\t\t\tlet sql: string;\n\t\t\tlet params: unknown[];\n\n\t\t\tif (tables && tables.length > 0) {\n\t\t\t\tsql = `SELECT delta_id, \"table\", row_id, columns, hlc, client_id, op\nFROM lakesync_deltas\nWHERE hlc > $1 AND \"table\" = ANY($2)\nORDER BY hlc ASC`;\n\t\t\t\tparams = [hlc.toString(), tables];\n\t\t\t} else {\n\t\t\t\tsql = `SELECT delta_id, \"table\", row_id, columns, hlc, client_id, op\nFROM lakesync_deltas\nWHERE hlc > $1\nORDER BY hlc ASC`;\n\t\t\t\tparams = [hlc.toString()];\n\t\t\t}\n\n\t\t\tconst result = await this.pool.query(sql, params);\n\t\t\treturn result.rows.map(rowToRowDelta);\n\t\t}, \"Failed to query deltas\");\n\t}\n\n\t/**\n\t * Get the latest merged state for a specific row using column-level LWW.\n\t * Returns null if no deltas exist for this row.\n\t */\n\tasync getLatestState(\n\t\ttable: string,\n\t\trowId: string,\n\t): Promise<Result<Record<string, unknown> | null, AdapterError>> {\n\t\treturn wrapAsync(async () => {\n\t\t\tconst sql = `SELECT columns, hlc, client_id, op\nFROM lakesync_deltas\nWHERE \"table\" = $1 AND row_id = $2\nORDER BY hlc ASC`;\n\n\t\t\tconst result = await this.pool.query(sql, [table, rowId]);\n\t\t\treturn mergeLatestState(result.rows);\n\t\t}, `Failed to get latest state for ${table}:${rowId}`);\n\t}\n\n\t/**\n\t * Ensure the lakesync_deltas table and indices exist.\n\t * The `schema` parameter is accepted for interface compliance but the\n\t * internal table structure is fixed (deltas store column data as JSONB).\n\t */\n\tasync ensureSchema(_schema: TableSchema): Promise<Result<void, AdapterError>> {\n\t\treturn wrapAsync(async () => {\n\t\t\tawait this.pool.query(`\nCREATE TABLE IF NOT EXISTS lakesync_deltas (\n\tdelta_id TEXT PRIMARY KEY,\n\t\"table\" TEXT NOT NULL,\n\trow_id TEXT NOT NULL,\n\tcolumns JSONB NOT NULL,\n\thlc BIGINT NOT NULL,\n\tclient_id TEXT NOT NULL,\n\top TEXT NOT NULL DEFAULT 'INSERT'\n);\nCREATE INDEX IF NOT EXISTS idx_lakesync_deltas_hlc ON lakesync_deltas (hlc);\nCREATE INDEX IF NOT EXISTS idx_lakesync_deltas_table_row ON lakesync_deltas (\"table\", row_id);\n`);\n\t\t}, \"Failed to ensure schema\");\n\t}\n\n\t/** Close the database connection pool and release resources. */\n\tasync close(): Promise<void> {\n\t\tawait this.pool.end();\n\t}\n}\n\n/**\n * Convert a raw Postgres row into a RowDelta.\n */\nfunction rowToRowDelta(row: Record<string, unknown>): RowDelta {\n\tconst columns: ColumnDelta[] =\n\t\ttypeof row.columns === \"string\"\n\t\t\t? JSON.parse(row.columns as string)\n\t\t\t: (row.columns as ColumnDelta[]);\n\n\treturn {\n\t\tdeltaId: row.delta_id as string,\n\t\ttable: row.table as string,\n\t\trowId: row.row_id as string,\n\t\tcolumns,\n\t\thlc: BigInt(row.hlc as string) as HLCTimestamp,\n\t\tclientId: row.client_id as string,\n\t\top: row.op as RowDelta[\"op\"],\n\t};\n}\n","import { AdapterError, type ConnectorConfig, Err, Ok, type Result, toError } from \"@lakesync/core\";\nimport { BigQueryAdapter } from \"./bigquery\";\nimport type { DatabaseAdapter } from \"./db-types\";\nimport { MySQLAdapter } from \"./mysql\";\nimport { PostgresAdapter } from \"./postgres\";\n\n/**\n * Instantiate a {@link DatabaseAdapter} from a {@link ConnectorConfig}.\n *\n * Switches on `config.type` and creates the matching adapter using\n * the type-specific connection configuration. Returns an {@link AdapterError}\n * if the type-specific config is missing or the adapter constructor throws.\n *\n * @param config - Validated connector configuration.\n * @returns The instantiated adapter or an error.\n */\nexport function createDatabaseAdapter(\n\tconfig: ConnectorConfig,\n): Result<DatabaseAdapter, AdapterError> {\n\ttry {\n\t\tswitch (config.type) {\n\t\t\tcase \"postgres\": {\n\t\t\t\tif (!config.postgres) {\n\t\t\t\t\treturn Err(new AdapterError(\"Postgres connector config missing postgres field\"));\n\t\t\t\t}\n\t\t\t\treturn Ok(\n\t\t\t\t\tnew PostgresAdapter({\n\t\t\t\t\t\tconnectionString: config.postgres.connectionString,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\tcase \"mysql\": {\n\t\t\t\tif (!config.mysql) {\n\t\t\t\t\treturn Err(new AdapterError(\"MySQL connector config missing mysql field\"));\n\t\t\t\t}\n\t\t\t\treturn Ok(\n\t\t\t\t\tnew MySQLAdapter({\n\t\t\t\t\t\tconnectionString: config.mysql.connectionString,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\tcase \"bigquery\": {\n\t\t\t\tif (!config.bigquery) {\n\t\t\t\t\treturn Err(new AdapterError(\"BigQuery connector config missing bigquery field\"));\n\t\t\t\t}\n\t\t\t\treturn Ok(\n\t\t\t\t\tnew BigQueryAdapter({\n\t\t\t\t\t\tprojectId: config.bigquery.projectId,\n\t\t\t\t\t\tdataset: config.bigquery.dataset,\n\t\t\t\t\t\tkeyFilename: config.bigquery.keyFilename,\n\t\t\t\t\t\tlocation: config.bigquery.location,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\tdefault:\n\t\t\t\treturn Err(new AdapterError(`Unsupported connector type: ${config.type}`));\n\t\t}\n\t} catch (err: unknown) {\n\t\treturn Err(new AdapterError(`Failed to create adapter: ${toError(err).message}`));\n\t}\n}\n","import {\n\ttype AdapterError,\n\ttype HLCTimestamp,\n\tOk,\n\ttype Result,\n\ttype RowDelta,\n\ttype TableSchema,\n} from \"@lakesync/core\";\n\nimport type { DatabaseAdapter } from \"./db-types\";\n\n/** Configuration for the FanOutAdapter. */\nexport interface FanOutAdapterConfig {\n\t/** The primary adapter that handles all reads and authoritative writes. */\n\tprimary: DatabaseAdapter;\n\t/** Secondary adapters that receive replicated writes on a best-effort basis. */\n\tsecondaries: DatabaseAdapter[];\n}\n\n/**\n * Writes to a primary adapter synchronously and replicates to secondary\n * adapters asynchronously. Reads always go to the primary.\n *\n * Secondary failures are silently caught and never affect the return value.\n * Use case: write to Postgres (fast, operational), replicate to BigQuery (analytics).\n */\nexport class FanOutAdapter implements DatabaseAdapter {\n\tprivate readonly primary: DatabaseAdapter;\n\tprivate readonly secondaries: ReadonlyArray<DatabaseAdapter>;\n\n\tconstructor(config: FanOutAdapterConfig) {\n\t\tthis.primary = config.primary;\n\t\tthis.secondaries = config.secondaries;\n\t}\n\n\t/** Insert deltas into the primary, then replicate to secondaries (fire-and-forget). */\n\tasync insertDeltas(deltas: RowDelta[]): Promise<Result<void, AdapterError>> {\n\t\tconst result = await this.primary.insertDeltas(deltas);\n\t\tif (!result.ok) {\n\t\t\treturn result;\n\t\t}\n\n\t\tfor (const secondary of this.secondaries) {\n\t\t\tsecondary.insertDeltas(deltas).catch(() => {});\n\t\t}\n\n\t\treturn Ok(undefined);\n\t}\n\n\t/** Query deltas from the primary adapter only. */\n\tasync queryDeltasSince(\n\t\thlc: HLCTimestamp,\n\t\ttables?: string[],\n\t): Promise<Result<RowDelta[], AdapterError>> {\n\t\treturn this.primary.queryDeltasSince(hlc, tables);\n\t}\n\n\t/** Get the latest state from the primary adapter only. */\n\tasync getLatestState(\n\t\ttable: string,\n\t\trowId: string,\n\t): Promise<Result<Record<string, unknown> | null, AdapterError>> {\n\t\treturn this.primary.getLatestState(table, rowId);\n\t}\n\n\t/** Ensure schema on the primary first, then best-effort on secondaries. */\n\tasync ensureSchema(schema: TableSchema): Promise<Result<void, AdapterError>> {\n\t\tconst result = await this.primary.ensureSchema(schema);\n\t\tif (!result.ok) {\n\t\t\treturn result;\n\t\t}\n\n\t\tfor (const secondary of this.secondaries) {\n\t\t\tsecondary.ensureSchema(schema).catch(() => {});\n\t\t}\n\n\t\treturn Ok(undefined);\n\t}\n\n\t/** Close primary and all secondary adapters. */\n\tasync close(): Promise<void> {\n\t\tawait this.primary.close();\n\t\tfor (const secondary of this.secondaries) {\n\t\t\tawait secondary.close();\n\t\t}\n\t}\n}\n","import {\n\ttype AdapterError,\n\ttype HLCTimestamp,\n\tOk,\n\ttype Result,\n\ttype RowDelta,\n\ttype TableSchema,\n} from \"@lakesync/core\";\n\nimport type { DatabaseAdapter } from \"./db-types\";\n\n/** Configuration for age-based tiered storage. */\nexport interface LifecycleAdapterConfig {\n\t/** Hot tier — recent data, fast queries. */\n\thot: {\n\t\t/** The adapter storing recent deltas. */\n\t\tadapter: DatabaseAdapter;\n\t\t/** Maximum age in milliseconds before data is considered cold. */\n\t\tmaxAgeMs: number;\n\t};\n\t/** Cold tier — older data, cheap storage. */\n\tcold: {\n\t\t/** The adapter storing archived deltas. */\n\t\tadapter: DatabaseAdapter;\n\t};\n}\n\n/**\n * Routes database operations across hot and cold tiers based on delta age.\n *\n * Writes always go to the hot adapter. Reads fan out to both tiers when\n * the requested HLC is older than the configured `maxAgeMs` threshold.\n *\n * Use {@link migrateToTier} as a background job to copy aged-out deltas\n * from hot to cold.\n */\nexport class LifecycleAdapter implements DatabaseAdapter {\n\tprivate readonly hot: DatabaseAdapter;\n\tprivate readonly cold: DatabaseAdapter;\n\tprivate readonly maxAgeMs: number;\n\n\tconstructor(config: LifecycleAdapterConfig) {\n\t\tthis.hot = config.hot.adapter;\n\t\tthis.cold = config.cold.adapter;\n\t\tthis.maxAgeMs = config.hot.maxAgeMs;\n\t}\n\n\t/** Insert deltas into the hot adapter — new data is always hot. */\n\tasync insertDeltas(deltas: RowDelta[]): Promise<Result<void, AdapterError>> {\n\t\treturn this.hot.insertDeltas(deltas);\n\t}\n\n\t/**\n\t * Query deltas since the given HLC.\n\t *\n\t * If `sinceHlc` is older than `now - maxAgeMs`, queries both hot and cold\n\t * adapters and merges the results sorted by HLC. Otherwise queries hot only.\n\t */\n\tasync queryDeltasSince(\n\t\thlc: HLCTimestamp,\n\t\ttables?: string[],\n\t): Promise<Result<RowDelta[], AdapterError>> {\n\t\tconst sinceWallMs = Number(hlc >> 16n);\n\t\tconst thresholdMs = Date.now() - this.maxAgeMs;\n\n\t\tif (sinceWallMs < thresholdMs) {\n\t\t\t// Query spans into cold territory — fan out to both tiers\n\t\t\tconst [hotResult, coldResult] = await Promise.all([\n\t\t\t\tthis.hot.queryDeltasSince(hlc, tables),\n\t\t\t\tthis.cold.queryDeltasSince(hlc, tables),\n\t\t\t]);\n\n\t\t\tif (!hotResult.ok) return hotResult;\n\t\t\tif (!coldResult.ok) return coldResult;\n\n\t\t\tconst merged = [...hotResult.value, ...coldResult.value];\n\t\t\tmerged.sort((a, b) => (a.hlc < b.hlc ? -1 : a.hlc > b.hlc ? 1 : 0));\n\n\t\t\treturn Ok(merged);\n\t\t}\n\n\t\t// Recent query — hot tier only\n\t\treturn this.hot.queryDeltasSince(hlc, tables);\n\t}\n\n\t/** Get latest state — try hot first, fall back to cold if hot returns null. */\n\tasync getLatestState(\n\t\ttable: string,\n\t\trowId: string,\n\t): Promise<Result<Record<string, unknown> | null, AdapterError>> {\n\t\tconst hotResult = await this.hot.getLatestState(table, rowId);\n\t\tif (!hotResult.ok) return hotResult;\n\n\t\tif (hotResult.value !== null) {\n\t\t\treturn hotResult;\n\t\t}\n\n\t\treturn this.cold.getLatestState(table, rowId);\n\t}\n\n\t/** Ensure schema exists on both hot and cold adapters. */\n\tasync ensureSchema(schema: TableSchema): Promise<Result<void, AdapterError>> {\n\t\tconst hotResult = await this.hot.ensureSchema(schema);\n\t\tif (!hotResult.ok) return hotResult;\n\n\t\treturn this.cold.ensureSchema(schema);\n\t}\n\n\t/** Close both hot and cold adapters. */\n\tasync close(): Promise<void> {\n\t\tawait this.hot.close();\n\t\tawait this.cold.close();\n\t}\n}\n\n/**\n * Migrate aged-out deltas from the hot adapter to the cold adapter.\n *\n * Queries the hot adapter for all deltas since HLC 0, filters those with\n * wall time older than `Date.now() - maxAgeMs`, and inserts them into the\n * cold adapter. Insertion is idempotent via deltaId uniqueness.\n *\n * Does NOT delete from hot — that is a separate cleanup concern.\n *\n * @param hot - The hot-tier adapter to read old deltas from.\n * @param cold - The cold-tier adapter to write old deltas to.\n * @param maxAgeMs - Age threshold in milliseconds.\n * @returns The count of migrated deltas, or an AdapterError.\n */\nexport async function migrateToTier(\n\thot: DatabaseAdapter,\n\tcold: DatabaseAdapter,\n\tmaxAgeMs: number,\n): Promise<Result<{ migrated: number }, AdapterError>> {\n\tconst thresholdMs = Date.now() - maxAgeMs;\n\tconst thresholdHlc = (BigInt(0) << 16n) as HLCTimestamp;\n\n\tconst result = await hot.queryDeltasSince(thresholdHlc);\n\tif (!result.ok) return result;\n\n\tconst oldDeltas = result.value.filter((delta) => {\n\t\tconst wallMs = Number(delta.hlc >> 16n);\n\t\treturn wallMs < thresholdMs;\n\t});\n\n\tif (oldDeltas.length === 0) {\n\t\treturn Ok({ migrated: 0 });\n\t}\n\n\tconst insertResult = await cold.insertDeltas(oldDeltas);\n\tif (!insertResult.ok) return insertResult;\n\n\treturn Ok({ migrated: oldDeltas.length });\n}\n","import { type AdapterError, type HLCTimestamp, Ok, type Result } from \"@lakesync/core\";\n\nimport type { DatabaseAdapter } from \"./db-types\";\n\n/** Options for migrating deltas between database adapters. */\nexport interface MigrateOptions {\n\t/** Source adapter to read from */\n\tfrom: DatabaseAdapter;\n\t/** Target adapter to write to */\n\tto: DatabaseAdapter;\n\t/** Optional: only migrate specific tables */\n\ttables?: string[];\n\t/** Batch size for writing (default: 1000) */\n\tbatchSize?: number;\n\t/** Progress callback invoked after each batch write */\n\tonProgress?: (info: MigrateProgress) => void;\n}\n\n/** Progress information reported during migration. */\nexport interface MigrateProgress {\n\t/** Current batch number (1-based) */\n\tbatch: number;\n\t/** Total deltas migrated so far */\n\ttotalSoFar: number;\n}\n\n/** Result of a successful migration. */\nexport interface MigrateResult {\n\t/** Total number of deltas migrated */\n\ttotalDeltas: number;\n\t/** Number of batches processed */\n\tbatches: number;\n}\n\n/**\n * Migrate deltas from one database adapter to another.\n * Reads all matching deltas from the source, then writes them in batches to the target.\n * Idempotent via deltaId uniqueness in the target adapter.\n */\nexport async function migrateAdapter(\n\topts: MigrateOptions,\n): Promise<Result<MigrateResult, AdapterError>> {\n\tconst batchSize = opts.batchSize ?? 1000;\n\n\tconst readResult = await opts.from.queryDeltasSince(BigInt(0) as HLCTimestamp, opts.tables);\n\tif (!readResult.ok) {\n\t\treturn readResult;\n\t}\n\n\tconst deltas = readResult.value;\n\n\tif (deltas.length === 0) {\n\t\treturn Ok({ totalDeltas: 0, batches: 0 });\n\t}\n\n\tlet batchCount = 0;\n\tlet totalSoFar = 0;\n\n\tfor (let i = 0; i < deltas.length; i += batchSize) {\n\t\tconst batch = deltas.slice(i, i + batchSize);\n\t\tconst writeResult = await opts.to.insertDeltas(batch);\n\t\tif (!writeResult.ok) {\n\t\t\treturn writeResult;\n\t\t}\n\n\t\tbatchCount++;\n\t\ttotalSoFar += batch.length;\n\n\t\topts.onProgress?.({ batch: batchCount, totalSoFar });\n\t}\n\n\treturn Ok({ totalDeltas: totalSoFar, batches: batchCount });\n}\n","import {\n\tDeleteObjectCommand,\n\tDeleteObjectsCommand,\n\tGetObjectCommand,\n\tHeadObjectCommand,\n\tListObjectsV2Command,\n\tPutObjectCommand,\n\tS3Client,\n} from \"@aws-sdk/client-s3\";\nimport { AdapterError, Ok, type Result } from \"@lakesync/core\";\nimport { wrapAsync } from \"./shared\";\nimport type { AdapterConfig, LakeAdapter, ObjectInfo } from \"./types\";\n\n/**\n * MinIO/S3-compatible lake adapter.\n *\n * Wraps the AWS S3 SDK to provide a Result-based interface for\n * interacting with MinIO or any S3-compatible object store.\n * All public methods return `Result` and never throw.\n */\nexport class MinIOAdapter implements LakeAdapter {\n\tprivate readonly client: S3Client;\n\tprivate readonly bucket: string;\n\n\tconstructor(config: AdapterConfig) {\n\t\tthis.bucket = config.bucket;\n\t\tthis.client = new S3Client({\n\t\t\tendpoint: config.endpoint,\n\t\t\tregion: config.region ?? \"us-east-1\",\n\t\t\tcredentials: config.credentials,\n\t\t\tforcePathStyle: true, // Required for MinIO\n\t\t});\n\t}\n\n\t/** Store an object in the lake */\n\tasync putObject(\n\t\tpath: string,\n\t\tdata: Uint8Array,\n\t\tcontentType?: string,\n\t): Promise<Result<void, AdapterError>> {\n\t\treturn wrapAsync(async () => {\n\t\t\tawait this.client.send(\n\t\t\t\tnew PutObjectCommand({\n\t\t\t\t\tBucket: this.bucket,\n\t\t\t\t\tKey: path,\n\t\t\t\t\tBody: data,\n\t\t\t\t\tContentType: contentType,\n\t\t\t\t}),\n\t\t\t);\n\t\t}, `Failed to put object: ${path}`);\n\t}\n\n\t/** Retrieve an object from the lake */\n\tasync getObject(path: string): Promise<Result<Uint8Array, AdapterError>> {\n\t\treturn wrapAsync(async () => {\n\t\t\tconst response = await this.client.send(\n\t\t\t\tnew GetObjectCommand({\n\t\t\t\t\tBucket: this.bucket,\n\t\t\t\t\tKey: path,\n\t\t\t\t}),\n\t\t\t);\n\t\t\tconst bytes = await response.Body?.transformToByteArray();\n\t\t\tif (!bytes) {\n\t\t\t\tthrow new AdapterError(`Empty response for object: ${path}`);\n\t\t\t}\n\t\t\treturn bytes;\n\t\t}, `Failed to get object: ${path}`);\n\t}\n\n\t/** Get object metadata without retrieving the body */\n\tasync headObject(\n\t\tpath: string,\n\t): Promise<Result<{ size: number; lastModified: Date }, AdapterError>> {\n\t\treturn wrapAsync(async () => {\n\t\t\tconst response = await this.client.send(\n\t\t\t\tnew HeadObjectCommand({\n\t\t\t\t\tBucket: this.bucket,\n\t\t\t\t\tKey: path,\n\t\t\t\t}),\n\t\t\t);\n\t\t\treturn {\n\t\t\t\tsize: response.ContentLength ?? 0,\n\t\t\t\tlastModified: response.LastModified ?? new Date(0),\n\t\t\t};\n\t\t}, `Failed to head object: ${path}`);\n\t}\n\n\t/** List objects matching a given prefix */\n\tasync listObjects(prefix: string): Promise<Result<ObjectInfo[], AdapterError>> {\n\t\treturn wrapAsync(async () => {\n\t\t\tconst response = await this.client.send(\n\t\t\t\tnew ListObjectsV2Command({\n\t\t\t\t\tBucket: this.bucket,\n\t\t\t\t\tPrefix: prefix,\n\t\t\t\t}),\n\t\t\t);\n\t\t\treturn (response.Contents ?? []).map((item) => ({\n\t\t\t\tkey: item.Key ?? \"\",\n\t\t\t\tsize: item.Size ?? 0,\n\t\t\t\tlastModified: item.LastModified ?? new Date(0),\n\t\t\t}));\n\t\t}, `Failed to list objects with prefix: ${prefix}`);\n\t}\n\n\t/** Delete a single object from the lake */\n\tasync deleteObject(path: string): Promise<Result<void, AdapterError>> {\n\t\treturn wrapAsync(async () => {\n\t\t\tawait this.client.send(\n\t\t\t\tnew DeleteObjectCommand({\n\t\t\t\t\tBucket: this.bucket,\n\t\t\t\t\tKey: path,\n\t\t\t\t}),\n\t\t\t);\n\t\t}, `Failed to delete object: ${path}`);\n\t}\n\n\t/** Delete multiple objects from the lake in a single batch operation */\n\tasync deleteObjects(paths: string[]): Promise<Result<void, AdapterError>> {\n\t\tif (paths.length === 0) {\n\t\t\treturn Ok(undefined);\n\t\t}\n\n\t\treturn wrapAsync(async () => {\n\t\t\tawait this.client.send(\n\t\t\t\tnew DeleteObjectsCommand({\n\t\t\t\t\tBucket: this.bucket,\n\t\t\t\t\tDelete: {\n\t\t\t\t\t\tObjects: paths.map((key) => ({ Key: key })),\n\t\t\t\t\t\tQuiet: true,\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t);\n\t\t}, `Failed to batch delete ${paths.length} objects`);\n\t}\n}\n","import type { ConnectorConfig } from \"@lakesync/core\";\n\n/** Generic query function — abstracts any SQL database connection. */\nexport type QueryFn = (sql: string, params?: unknown[]) => Promise<Record<string, unknown>[]>;\n\n/**\n * Create a raw SQL query function from a {@link ConnectorConfig}.\n *\n * Uses dynamic imports so the database drivers (pg, mysql2) are only\n * loaded when actually needed. Returns `null` for connector types that\n * do not support the standard SQL polling model (e.g. BigQuery).\n *\n * @param config - Validated connector configuration.\n * @returns A query function or `null` if the connector type is unsupported.\n */\nexport async function createQueryFn(config: ConnectorConfig): Promise<QueryFn | null> {\n\tswitch (config.type) {\n\t\tcase \"postgres\": {\n\t\t\tif (!config.postgres) return null;\n\t\t\tconst { Pool } = await import(\"pg\");\n\t\t\tconst pool = new Pool({ connectionString: config.postgres.connectionString });\n\t\t\treturn async (sql: string, params?: unknown[]) => {\n\t\t\t\tconst result = await pool.query(sql, params);\n\t\t\t\treturn result.rows as Record<string, unknown>[];\n\t\t\t};\n\t\t}\n\t\tcase \"mysql\": {\n\t\t\tif (!config.mysql) return null;\n\t\t\tconst mysql = await import(\"mysql2/promise\");\n\t\t\tconst pool = mysql.createPool(config.mysql.connectionString);\n\t\t\treturn async (sql: string, params?: unknown[]) => {\n\t\t\t\tconst [rows] = await pool.query(sql, params);\n\t\t\t\treturn rows as Record<string, unknown>[];\n\t\t\t};\n\t\t}\n\t\tdefault:\n\t\t\treturn null;\n\t}\n}\n"],"mappings":"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","names":["rowToRowDelta","Pool","mysql"]}

package/dist/client.d.ts

@@ -0,0 +1,428 @@
+import { R as Result, S as SchemaError, L as LakeSyncError, H as HLCTimestamp } from './result-CojzlFE2.js';
+export { u as unwrapOrThrow } from './result-CojzlFE2.js';
+import { L as LocalDB, D as DbError, A as ActionQueue, a as ActionQueueEntry, S as SyncQueue, Q as QueueEntry, b as SyncTransport, C as CheckpointResponse } from './coordinator-CxckTzYW.js';
+export { c as ActionQueueEntryStatus, d as DbConfig, e as QueueEntryStatus, f as SyncCoordinator, g as SyncCoordinatorConfig, h as SyncEvents, i as SyncMode, j as SyncTracker, T as Transaction } from './coordinator-CxckTzYW.js';
+import { T as TableSchema, R as RowDelta, b as SyncPush, S as SyncPull, c as SyncResponse } from './types-V_jVu2sA.js';
+import { A as Action, i as ActionPush, j as ActionResponse, d as ActionDiscovery, l as AuthContext, a as ActionValidationError } from './types-Bs-QyOe-.js';
+import { C as ConflictResolver } from './resolver-C3Wphi6O.js';
+import './hlc-DiD8QNG3.js';
+
+/**
+ * Load a database snapshot from IndexedDB.
+ *
+ * @param dbName - The logical database name (used as key in IndexedDB)
+ * @returns The raw SQLite database bytes, or null if no snapshot exists
+ */
+declare function loadSnapshot(dbName: string): Promise<Uint8Array | null>;
+/**
+ * Save a database snapshot to IndexedDB.
+ *
+ * @param dbName - The logical database name (used as key in IndexedDB)
+ * @param data - The raw SQLite database bytes from sql.js `db.export()`
+ */
+declare function saveSnapshot(dbName: string, data: Uint8Array): Promise<void>;
+/**
+ * Delete a database snapshot from IndexedDB.
+ *
+ * @param dbName - The logical database name to remove
+ */
+declare function deleteSnapshot(dbName: string): Promise<void>;
+
+/**
+ * Registers a table schema in the local database.
+ *
+ * Creates the `_lakesync_meta` metadata table if it does not already exist,
+ * then inserts or updates the schema entry and creates the corresponding
+ * user table with columns derived from the provided TableSchema.
+ *
+ * The user table always includes a `_rowId TEXT PRIMARY KEY` column in
+ * addition to the columns specified in the schema.
+ *
+ * This operation is idempotent — calling it twice with the same schema
+ * produces no error.
+ *
+ * @param db - The LocalDB instance to register the schema in
+ * @param schema - The TableSchema describing the table and its columns
+ * @returns A Result indicating success or a DbError
+ */
+declare function registerSchema(db: LocalDB, schema: TableSchema): Promise<Result<void, DbError | SchemaError>>;
+/**
+ * Retrieves a previously registered table schema from the database.
+ *
+ * Ensures the `_lakesync_meta` table exists before querying, so this
+ * function is safe to call even on a freshly created database.
+ *
+ * @param db - The LocalDB instance to query
+ * @param table - The table name to look up
+ * @returns A Result containing the TableSchema if found, null if the
+ *          table has not been registered, or a DbError on failure
+ */
+declare function getSchema(db: LocalDB, table: string): Promise<Result<TableSchema | null, DbError>>;
+/**
+ * Migrates an existing table schema to a new version.
+ *
+ * Only additive migrations are supported — new columns can be added
+ * (they will be nullable). Removing columns or changing column types
+ * will result in a SchemaError.
+ *
+ * Both schemas must reference the same table name; mismatched table
+ * names will produce a SchemaError.
+ *
+ * On success, the `_lakesync_meta` entry is updated with the new schema
+ * and the schema version is incremented by one.
+ *
+ * @param db - The LocalDB instance to migrate
+ * @param oldSchema - The current table schema
+ * @param newSchema - The desired table schema after migration
+ * @returns A Result indicating success, or a SchemaError/DbError on failure
+ */
+declare function migrateSchema(db: LocalDB, oldSchema: TableSchema, newSchema: TableSchema): Promise<Result<void, DbError | SchemaError>>;
+
+/**
+ * IndexedDB-backed action queue implementation.
+ *
+ * HLC timestamps (branded bigints) are serialised to strings for storage,
+ * as IndexedDB's structuredClone cannot handle bigint values.
+ */
+declare class IDBActionQueue implements ActionQueue {
+    private dbPromise;
+    private counter;
+    /**
+     * Create a new IDB-backed action queue.
+     *
+     * @param dbName - Optional database name. Defaults to `'lakesync-action-queue'`.
+     */
+    constructor(dbName?: string);
+    /** Add an action to the queue. */
+    push(action: Action): Promise<Result<ActionQueueEntry, LakeSyncError>>;
+    /** Peek at pending entries (ordered by createdAt). */
+    peek(limit: number): Promise<Result<ActionQueueEntry[], LakeSyncError>>;
+    /** Mark entries as currently being sent. */
+    markSending(ids: string[]): Promise<Result<void, LakeSyncError>>;
+    /** Acknowledge successful delivery (removes entries). */
+    ack(ids: string[]): Promise<Result<void, LakeSyncError>>;
+    /** Negative acknowledge — reset to pending with incremented retryCount and exponential backoff. */
+    nack(ids: string[]): Promise<Result<void, LakeSyncError>>;
+    /** Get the number of pending + sending entries. */
+    depth(): Promise<Result<number, LakeSyncError>>;
+    /** Remove all entries. */
+    clear(): Promise<Result<void, LakeSyncError>>;
+}
+
+/**
+ * IndexedDB-backed sync queue implementation.
+ * Uses a single readwrite transaction for atomic claim operations.
+ *
+ * HLC timestamps (branded bigints) are serialised to strings for storage,
+ * as IndexedDB's structuredClone cannot handle bigint values.
+ */
+declare class IDBQueue implements SyncQueue {
+    private dbPromise;
+    private counter;
+    /**
+     * Create a new IDB-backed sync queue.
+     *
+     * @param dbName - Optional database name. Defaults to `'lakesync-queue'`.
+     *                 Useful for tests or running multiple independent queues.
+     */
+    constructor(dbName?: string);
+    /** Add a delta to the queue */
+    push(delta: RowDelta): Promise<Result<QueueEntry, LakeSyncError>>;
+    /** Peek at pending entries (ordered by createdAt) */
+    peek(limit: number): Promise<Result<QueueEntry[], LakeSyncError>>;
+    /** Mark entries as currently being sent */
+    markSending(ids: string[]): Promise<Result<void, LakeSyncError>>;
+    /** Acknowledge successful delivery (removes entries) */
+    ack(ids: string[]): Promise<Result<void, LakeSyncError>>;
+    /** Negative acknowledge — reset to pending with incremented retryCount and exponential backoff */
+    nack(ids: string[]): Promise<Result<void, LakeSyncError>>;
+    /** Get the number of pending + sending entries */
+    depth(): Promise<Result<number, LakeSyncError>>;
+    /** Remove all entries */
+    clear(): Promise<Result<void, LakeSyncError>>;
+}
+
+/**
+ * In-memory action queue implementation.
+ * Suitable for testing and server-side use.
+ */
+declare class MemoryActionQueue implements ActionQueue {
+    private entries;
+    private counter;
+    /** Add an action to the queue. */
+    push(action: Action): Promise<Result<ActionQueueEntry, LakeSyncError>>;
+    /** Peek at pending entries (ordered by createdAt), skipping entries with future retryAfter. */
+    peek(limit: number): Promise<Result<ActionQueueEntry[], LakeSyncError>>;
+    /** Mark entries as currently being sent. */
+    markSending(ids: string[]): Promise<Result<void, LakeSyncError>>;
+    /** Acknowledge successful delivery (removes entries). */
+    ack(ids: string[]): Promise<Result<void, LakeSyncError>>;
+    /** Negative acknowledge — reset to pending with incremented retryCount and exponential backoff. */
+    nack(ids: string[]): Promise<Result<void, LakeSyncError>>;
+    /** Get the number of pending + sending entries. */
+    depth(): Promise<Result<number, LakeSyncError>>;
+    /** Remove all entries. */
+    clear(): Promise<Result<void, LakeSyncError>>;
+}
+
+/**
+ * In-memory sync queue implementation.
+ * Suitable for testing and server-side use.
+ */
+declare class MemoryQueue implements SyncQueue {
+    private entries;
+    private counter;
+    /** Add a delta to the queue */
+    push(delta: RowDelta): Promise<Result<QueueEntry, LakeSyncError>>;
+    /** Peek at pending entries (ordered by createdAt), skipping entries with future retryAfter */
+    peek(limit: number): Promise<Result<QueueEntry[], LakeSyncError>>;
+    /** Mark entries as currently being sent */
+    markSending(ids: string[]): Promise<Result<void, LakeSyncError>>;
+    /** Acknowledge successful delivery (removes entries) */
+    ack(ids: string[]): Promise<Result<void, LakeSyncError>>;
+    /** Negative acknowledge — reset to pending with incremented retryCount and exponential backoff */
+    nack(ids: string[]): Promise<Result<void, LakeSyncError>>;
+    /** Get the number of pending + sending entries */
+    depth(): Promise<Result<number, LakeSyncError>>;
+    /** Remove all entries */
+    clear(): Promise<Result<void, LakeSyncError>>;
+}
+
+/**
+ * Apply remote deltas to the local SQLite database.
+ *
+ * For each remote delta:
+ * 1. Check if the same rowId has a pending local delta in the queue
+ * 2. If conflict: use the resolver to determine winner
+ *    - Remote wins: apply to SQLite, remove local from queue
+ *    - Local wins: skip remote, keep local in queue
+ * 3. If no conflict: apply remote delta directly
+ *
+ * After the batch, the `_sync_cursor` table is updated with the maximum
+ * HLC from applied deltas so that subsequent syncs can resume from the
+ * correct position.
+ *
+ * @param db - The local SQLite database
+ * @param deltas - Remote deltas to apply
+ * @param resolver - Conflict resolution strategy
+ * @param pendingQueue - The local sync queue to check for conflicts
+ * @returns The number of applied deltas, or an error
+ */
+declare function applyRemoteDeltas(db: LocalDB, deltas: RowDelta[], resolver: ConflictResolver, pendingQueue: SyncQueue): Promise<Result<number, LakeSyncError>>;
+
+/**
+ * Synchronises local table schemas with server-provided schema versions.
+ *
+ * Compares the locally stored schema version against the server's version
+ * and applies additive migrations (ALTER TABLE ... ADD COLUMN) when the
+ * client is behind.
+ */
+declare class SchemaSynchroniser {
+    private readonly db;
+    constructor(db: LocalDB);
+    /**
+     * Compare local schema version with server and apply migrations if behind.
+     *
+     * If the local version is already equal to or ahead of the server version,
+     * this is a no-op. Otherwise, the local schema is migrated to match the
+     * server schema via `migrateSchema()`, which runs ALTER TABLE ... ADD COLUMN
+     * for each new column.
+     *
+     * @param table - The table name to synchronise
+     * @param serverSchema - The server's current TableSchema
+     * @param serverVersion - The server's schema version number
+     * @returns Ok on success, or Err with a LakeSyncError on failure
+     */
+    synchronise(table: string, serverSchema: TableSchema, serverVersion: number): Promise<Result<void, LakeSyncError>>;
+    /**
+     * Retrieve the local schema version for a given table from `_lakesync_meta`.
+     *
+     * @param table - The table name to look up
+     * @returns The schema version number, or 0 if the table is not registered
+     */
+    private getLocalVersion;
+    /**
+     * Set the local schema version for a given table in `_lakesync_meta`.
+     *
+     * @param table - The table name to update
+     * @param version - The version number to set
+     * @returns Ok on success, or Err with a DbError on failure
+     */
+    private setLocalVersion;
+}
+
+/** Configuration for the HTTP sync transport */
+interface HttpTransportConfig {
+    /** Base URL of the gateway (e.g. "https://gateway.example.com") */
+    baseUrl: string;
+    /** Gateway identifier */
+    gatewayId: string;
+    /** Bearer token for authentication */
+    token: string;
+    /** Optional custom fetch implementation (useful for testing) */
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * HTTP-based sync transport for communicating with a remote gateway.
+ *
+ * Sends push requests via POST and pull requests via GET, using
+ * BigInt-safe JSON serialisation for HLC timestamps.
+ */
+declare class HttpTransport implements SyncTransport {
+    private readonly baseUrl;
+    private readonly gatewayId;
+    private readonly token;
+    private readonly _fetch;
+    constructor(config: HttpTransportConfig);
+    /**
+     * Push local deltas to the remote gateway.
+     *
+     * Sends a POST request with the push payload as BigInt-safe JSON.
+     */
+    push(msg: SyncPush): Promise<Result<{
+        serverHlc: HLCTimestamp;
+        accepted: number;
+    }, LakeSyncError>>;
+    /**
+     * Pull remote deltas from the gateway.
+     *
+     * Sends a GET request with query parameters for the pull cursor.
+     */
+    pull(msg: SyncPull): Promise<Result<SyncResponse, LakeSyncError>>;
+    /**
+     * Execute imperative actions against external systems via the gateway.
+     *
+     * Sends a POST request with the action payload as BigInt-safe JSON.
+     */
+    executeAction(msg: ActionPush): Promise<Result<ActionResponse, LakeSyncError>>;
+    /**
+     * Discover available connectors and their supported action types.
+     *
+     * Sends a GET request to the actions discovery endpoint.
+     */
+    describeActions(): Promise<Result<ActionDiscovery, LakeSyncError>>;
+    /**
+     * Download checkpoint for initial sync.
+     *
+     * Requests the streaming checkpoint format via Accept header and reads
+     * length-prefixed proto frames from the response body.
+     */
+    checkpoint(): Promise<Result<CheckpointResponse | null, LakeSyncError>>;
+}
+
+/**
+ * Gateway-like interface used by LocalTransport.
+ *
+ * Matches the shape of SyncGateway's push/pull/action methods without
+ * requiring a direct dependency on `@lakesync/gateway`.
+ */
+interface LocalGateway {
+    /** Handle an incoming push from a client */
+    handlePush(msg: SyncPush): Result<{
+        serverHlc: HLCTimestamp;
+        accepted: number;
+    }, LakeSyncError>;
+    /** Handle a pull request from a client */
+    handlePull(msg: SyncPull): Result<SyncResponse, LakeSyncError>;
+    /** Handle an action push from a client */
+    handleAction?(msg: ActionPush, context?: AuthContext): Promise<Result<ActionResponse, ActionValidationError>>;
+    /** Describe available action handlers and their supported actions. */
+    describeActions?(): ActionDiscovery;
+}
+/**
+ * In-process transport that wraps a local SyncGateway instance.
+ *
+ * Useful for testing and single-tab offline demos where the client
+ * and gateway run in the same process.
+ */
+declare class LocalTransport implements SyncTransport {
+    private readonly gateway;
+    constructor(gateway: LocalGateway);
+    /** Push local deltas to the in-process gateway */
+    push(msg: SyncPush): Promise<Result<{
+        serverHlc: HLCTimestamp;
+        accepted: number;
+    }, LakeSyncError>>;
+    /** Pull remote deltas from the in-process gateway */
+    pull(msg: SyncPull): Promise<Result<SyncResponse, LakeSyncError>>;
+    /** Local transport has no checkpoint — returns null */
+    checkpoint(): Promise<Result<CheckpointResponse | null, LakeSyncError>>;
+    /** Execute actions against the in-process gateway. */
+    executeAction(msg: ActionPush): Promise<Result<ActionResponse, LakeSyncError>>;
+    /** Discover available connectors and their supported action types. */
+    describeActions(): Promise<Result<ActionDiscovery, LakeSyncError>>;
+}
+
+/** Configuration for the WebSocket sync transport. */
+interface WebSocketTransportConfig {
+    /** WebSocket URL, e.g. "wss://gateway.example.com/sync/my-gw/ws" */
+    url: string;
+    /** Bearer token (passed as ?token= query param for browser compat). */
+    token: string;
+    /** Called when server broadcasts deltas. */
+    onBroadcast?: (deltas: RowDelta[], serverHlc: HLCTimestamp) => void;
+    /** Reconnect base delay in ms (default 1000). */
+    reconnectBaseMs?: number;
+    /** Max reconnect delay in ms (default 30000). */
+    reconnectMaxMs?: number;
+    /** HTTP transport config for checkpoint fallback. */
+    httpConfig?: HttpTransportConfig;
+}
+/**
+ * WebSocket-based sync transport for real-time delta synchronisation.
+ *
+ * Uses the binary protobuf protocol with tag-based framing:
+ * - `0x01` = SyncPush (client → server)
+ * - `0x02` = SyncPull (client → server)
+ * - `0x03` = Broadcast (server → client)
+ *
+ * Automatically reconnects on disconnect with exponential backoff.
+ * Checkpoints are delegated to an internal {@link HttpTransport} (large
+ * binary payloads are better suited to HTTP).
+ */
+declare class WebSocketTransport implements SyncTransport {
+    private readonly config;
+    private readonly reconnectBaseMs;
+    private readonly reconnectMaxMs;
+    private readonly httpTransport;
+    private ws;
+    private reconnectTimer;
+    private reconnectAttempts;
+    private _connected;
+    private intentionalClose;
+    /** Pending request/response promise (push or pull). */
+    private pending;
+    /** Broadcast callback registered by the SyncCoordinator. */
+    private broadcastCallback;
+    constructor(config: WebSocketTransportConfig);
+    /** Whether the WebSocket is currently connected. */
+    get connected(): boolean;
+    /** Whether this transport supports real-time server push. */
+    get supportsRealtime(): boolean;
+    /** Register callback for server-initiated broadcasts. */
+    onBroadcast(callback: (deltas: RowDelta[], serverHlc: HLCTimestamp) => void): void;
+    /** Open the WebSocket connection. */
+    connect(): void;
+    /** Close the WebSocket connection and stop reconnecting. */
+    disconnect(): void;
+    /**
+     * Push local deltas to the gateway via WebSocket.
+     */
+    push(msg: SyncPush): Promise<Result<{
+        serverHlc: HLCTimestamp;
+        accepted: number;
+    }, LakeSyncError>>;
+    /**
+     * Pull remote deltas from the gateway via WebSocket.
+     */
+    pull(msg: SyncPull): Promise<Result<SyncResponse, LakeSyncError>>;
+    /**
+     * Download checkpoint via HTTP (large binary payloads are better over HTTP).
+     */
+    checkpoint(): Promise<Result<CheckpointResponse | null, LakeSyncError>>;
+    private openWebSocket;
+    private scheduleReconnect;
+    private sendAndAwaitResponse;
+}
+
+export { ActionQueue, ActionQueueEntry, CheckpointResponse, DbError, HttpTransport, type HttpTransportConfig, IDBActionQueue, IDBQueue, LocalDB, type LocalGateway, LocalTransport, MemoryActionQueue, MemoryQueue, QueueEntry, SchemaSynchroniser, SyncQueue, SyncTransport, WebSocketTransport, type WebSocketTransportConfig, applyRemoteDeltas, deleteSnapshot, getSchema, loadSnapshot, migrateSchema, registerSchema, saveSnapshot };