@supalive/core 1.8.1 → 1.10.0

package/dist/mysql-CDenA4XE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql-CDenA4XE.d.ts","names":[],"sources":["../src/db/mysql.ts"],"mappings":";;;;;;;;;KAwCY,gBAAA,GAAmB,WAAW;EAAK,cAAc;AAAA;AAAA,cAEhD,aAAA,YAAyB,QAAA;cAElC,MAAA,EAAQ,MAAA,EACR,MAAA,EAAQ,gBAAA,EACR,IAAA,GAAM,IAAA;EAAA,QAaA,MAAA;EACD,MAAA,EAAQ,WAAA;EAAA,UACL,cAAA;EAAA,QACF,IAAA;EAAA,SACC,MAAA,EAAQ,MAAA;EAAA,SACR,UAAA,EAAY,UAAA;EAMd,WAAA,EAAa,GAAA,SAAY,GAAA;EAAA,UAGtB,QAAA,EAAU,GAAA;EAwII;;;;;;EAhIlB,wBAAA,CAAyB,KAAA,WAAgB,OAAA,CAAQ,GAAA;EA0M5B;;;;;;EAlL3B,cAAA,CAAe,KAAA,WAAgB,GAAA;EA+Me;;;;;;;;;;;;;;;EAvLxC,oBAAA,CAAqB,IAAA;IACzB,KAAA,GAAQ,UAAA;IACR,QAAA;IACA,MAAA;EAAA,IACE,OAAA;EAgsBW;;;;;EAtpBf,qBAAA,CAAsB,KAAA;EAnIZ;;;EAkJV,WAAA,CACE,WAAA,EAAa,GAAA,SAAY,GAAA,mBACzB,QAAA,EAAU,GAAA;EAlJJ;;EAAA,QA0JM,cAAA;EASR,cAAA,IAAkB,OAAA;EAYxB,uBAAA,CAAwB,SAAA;EAWlB,gBAAA,CAAiB,EAAA,GAAK,GAAA,EAAK,eAAA,KAAoB,OAAA,SAAgB,OAAA;EAqC/D,KAAA,UAAe,GAAA,UAAa,MAAA,eAAyB,OAAA,CAAQ,aAAA,CAAc,CAAA;EAc3E,SAAA,IAAa,OAAA,CAAQ,YAAA;EAKrB,oBAAA,IAAwB,OAAA,CAAQ,UAAA;EAOhC,0BAAA,IAA8B,OAAA;EAK9B,6BAAA,CAA8B,QAAA,WAAmB,OAAA;EAOjD,uBAAA,IAA2B,OAAA;EAK3B,0BAAA,CAA2B,EAAA,WAAa,OAAA;EAOxC,gBAAA,IAAoB,OAAA;EAuBpB,wBAAA,CAAyB,QAAA,EAAU,UAAA,IAAc,OAAA,EAAS,SAAA,KAAc,OAAA;EA6DxE,mBAAA,CACJ,OAAA,EAAS,SAAA,IACT,QAAA,EAAU,UAAA,IACV,QAAA,EAAU,iBAAA,GACT,OAAA,CAAQ,eAAA;EAAA,QAmBG,uBAAA;EAAA,QAyBA,uBAAA;EAAA,QA2CA,wBAAA;EAAA,QAiCA,uBAAA;EAAA,QA4BA,sBAAA;EAlcC;;;;;;;EAAA,QA4eP,wCAAA;EAgDF,YAAA,CACJ,OAAA,UACA,OAAA,EAAS,eAAA,EACT,QAAA,WACC,OAAA;IAAU,OAAA;EAAA;EAAA,QAqCC,gBAAA;EAAA,QAyDA,4BAAA;EAwCR,qBAAA,CAAsB,EAAA,WAAa,OAAA;EAQnC,iBAAA,IAAqB,OAAA;EAQrB,sBAAA,CAAuB,OAAA,UAAiB,KAAA,UAAe,QAAA,EAAU,UAAA,KAAe,OAAA,CAAQ,cAAA;EAmBxF,oBAAA,CAAqB,OAAA,UAAiB,SAAA,UAAmB,QAAA,EAAU,UAAA,KAAe,OAAA,CAAQ,cAAA;EAmB1F,KAAA,IAAS,OAAA;AAAA"}

package/dist/mysql-CfYZLs5V.d.ts

@@ -0,0 +1,109 @@
+import { $r as WriteEntry, Gn as DbType, Hn as CoreInitLockCtx, Jn as PreparedQueries, Kn as LazyCommitTsParam, Qn as CacheLayer, Un as Database, Wn as DbQueryResult, Xn as SqlBuilder, Xr as ReadEntry, Zn as TxDatabase, qn as PooledClient, yr as CommitLogEntry } from "./index-CDG1kbFO.js";
+import { Pool, PoolOptions } from "mysql2/promise";
+import { Logger } from "pino";
+
+//#region src/db/mysql.d.ts
+/**
+ * mysql2's PoolOptions does not have a per-statement timeout field; we
+ * carry our own. Set 0 to disable.
+ */
+type MySqlPoolOptions = PoolOptions & {
+  queryTimeoutMs?: number;
+};
+declare class MySqlDatabase implements Database {
+  constructor(logger: Logger, config: MySqlPoolOptions, pool?: Pool | undefined);
+  private logger;
+  config: PoolOptions;
+  protected queryTimeoutMs: number;
+  private pool;
+  readonly dbType: DbType;
+  readonly sqlBuilder: SqlBuilder;
+  columnTypes: Map<string, Map<string, string>>;
+  protected sqlCache: Map<string, string>;
+  /**
+   * Fetches actual column types from MySQL for `table` and returns a
+   * map of DB column name → MySQL type string (as produced by `COLUMN_TYPE`,
+   * e.g. `bigint`, `integer`, `varchar(32)`, `text`, `json`).
+   * No caching here — see {@link getColumnTypes} for the cached path.
+   */
+  loadColumnTypesFromMySql(table: string): Promise<Map<string, string>>;
+  /**
+   * Synchronous column-type lookup. The apply path calls this on every
+   * batched write, so it can't await — populate the cache via
+   * {@link bootstrapColumnTypes} at server start. Throws if `table` is
+   * missing (programmer error / bootstrap skipped).
+   */
+  getColumnTypes(table: string): Map<string, string> | null;
+  /**
+   * Eagerly load column types into the in-memory cache. With a Redis
+   * client supplied, attempts the cache key first and falls through to
+   * MySQL on miss (writing the result back to Redis). This is the
+   * "one server queries MySQL, the rest read from Redis" pattern for cold
+   * starts in a multi-instance deploy. Without Redis, always queries MySQL.
+   *
+   * Pass `tables` to limit the load to a specific list; otherwise every
+   * user table in the connected database is loaded.
+   *
+   * The Redis cache key should encode whatever invalidates types in your
+   * environment (typically a schema version / deploy version). The
+   * subscriber in supalive-server.ts is expected to publish a reload
+   * signal after migrations and invoke {@link invalidateColumnTypes}.
+   */
+  bootstrapColumnTypes(opts: {
+    redis?: CacheLayer;
+    cacheKey: string;
+    tables?: string[];
+  }): Promise<void>;
+  /**
+     * Invalidate cached types (and dependent SQL) for `table`, or the entire
+     * cache if `table` is omitted. The Redis-pubsub reload signal in
+     * supalive-server.ts is expected to call this on schema changes.
+     */
+  invalidateColumnTypes(table?: string): void;
+  /** Replace this instance's caches with shared references from a parent.
+   *  Used by getTransactionClient so types loaded once at startup are
+   *  visible inside transactions. */
+  adoptCaches(columnTypes: Map<string, Map<string, string>>, sqlCache: Map<string, string>): void;
+  /** Enumerate the user-defined tables in the connected database for mysql — used
+   * by bootstrapColumnTypes() when no explicit list is provided. */
+  private listUserTables;
+  getCoreVersion(): Promise<bigint>;
+  coreMigrationStatements(toVersion: bigint): string[];
+  withCoreInitLock(fn: (ctx: CoreInitLockCtx) => Promise<void>): Promise<void>;
+  query<T = any>(sql: string, params?: unknown[]): Promise<DbQueryResult<T>>;
+  getClient(): Promise<PooledClient>;
+  getTransactionClient(): Promise<TxDatabase>;
+  getLatestSnapshotTimestamp(): Promise<bigint>;
+  updateLatestSnapshotTimestamp(commitTs: bigint): Promise<void>;
+  getMinSnapshotTimestamp(): Promise<bigint>;
+  updateMinSnapshotTimestamp(ts: bigint): Promise<void>;
+  getNextTimestamp(): Promise<bigint>;
+  attachPrevDataToWriteSet(writeSet: WriteEntry[], readSet: ReadEntry[]): Promise<void>;
+  prepareCommitWrites(readSet: ReadEntry[], writeSet: WriteEntry[], commitTs: LazyCommitTsParam): Promise<PreparedQueries>;
+  private mysqlPrepareBatchWrites;
+  private mysqlPrepareInsertBatch;
+  private mysqlPrepareUpdateSingle;
+  private mysqlPrepareDeleteBatch;
+  private mysqlPrepareCommitLogs;
+  /**
+   * Point-only OCC check. For each genuine point read, compare the row's
+   * current commit_ts against the value captured at read time. A `null`
+   * expectedCommitTs means "row didn't exist when we read"; any row found
+   * now is a conflict. Reads whose row is being written in this same txn
+   * are skipped — the CAS UPDATE/DELETE already validated those.
+   */
+  private mysqlPrepareValidatePointReadsByCommitTs;
+  commitWrites(beginTs: bigint, queries: PreparedQueries, commitTs: bigint): Promise<{
+    success: boolean;
+  }>;
+  private mysqlApplyWrites;
+  private validatePointReadsByCommitTs;
+  pruneCommitLogsBefore(ts: bigint): Promise<bigint>;
+  getMinCommitLogTs(): Promise<bigint | null>;
+  getCommitLogsBetweenTs(beginTs: bigint, endTs: bigint, tableIds: Uint8Array[]): Promise<CommitLogEntry[]>;
+  getCommitLogsSinceTs(sinceTs: bigint, excludeTs: bigint, tableIds: Uint8Array[]): Promise<CommitLogEntry[]>;
+  close(): Promise<void>;
+}
+//#endregion
+export { MySqlDatabase as t };
+//# sourceMappingURL=mysql-CfYZLs5V.d.ts.map

package/dist/mysql-CfYZLs5V.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql-CfYZLs5V.d.ts","names":[],"sources":["../src/db/mysql.ts"],"mappings":";;;;;;;;;KAwCY,gBAAA,GAAmB,WAAW;EAAK,cAAc;AAAA;AAAA,cAEhD,aAAA,YAAyB,QAAA;cAElC,MAAA,EAAQ,MAAA,EACR,MAAA,EAAQ,gBAAA,EACR,IAAA,GAAM,IAAA;EAAA,QAaA,MAAA;EACD,MAAA,EAAQ,WAAA;EAAA,UACL,cAAA;EAAA,QACF,IAAA;EAAA,SACC,MAAA,EAAQ,MAAA;EAAA,SACR,UAAA,EAAY,UAAA;EAMd,WAAA,EAAa,GAAA,SAAY,GAAA;EAAA,UAGtB,QAAA,EAAU,GAAA;EAwII;;;;;;EAhIlB,wBAAA,CAAyB,KAAA,WAAgB,OAAA,CAAQ,GAAA;EA0M5B;;;;;;EAlL3B,cAAA,CAAe,KAAA,WAAgB,GAAA;EA+Me;;;;;;;;;;;;;;;EAvLxC,oBAAA,CAAqB,IAAA;IACzB,KAAA,GAAQ,UAAA;IACR,QAAA;IACA,MAAA;EAAA,IACE,OAAA;EAgsBW;;;;;EAtpBf,qBAAA,CAAsB,KAAA;EAnIZ;;;EAkJV,WAAA,CACE,WAAA,EAAa,GAAA,SAAY,GAAA,mBACzB,QAAA,EAAU,GAAA;EAlJJ;;EAAA,QA0JM,cAAA;EASR,cAAA,IAAkB,OAAA;EAYxB,uBAAA,CAAwB,SAAA;EAWlB,gBAAA,CAAiB,EAAA,GAAK,GAAA,EAAK,eAAA,KAAoB,OAAA,SAAgB,OAAA;EAqC/D,KAAA,UAAe,GAAA,UAAa,MAAA,eAAyB,OAAA,CAAQ,aAAA,CAAc,CAAA;EAc3E,SAAA,IAAa,OAAA,CAAQ,YAAA;EAKrB,oBAAA,IAAwB,OAAA,CAAQ,UAAA;EAOhC,0BAAA,IAA8B,OAAA;EAK9B,6BAAA,CAA8B,QAAA,WAAmB,OAAA;EAOjD,uBAAA,IAA2B,OAAA;EAK3B,0BAAA,CAA2B,EAAA,WAAa,OAAA;EAOxC,gBAAA,IAAoB,OAAA;EAuBpB,wBAAA,CAAyB,QAAA,EAAU,UAAA,IAAc,OAAA,EAAS,SAAA,KAAc,OAAA;EA6DxE,mBAAA,CACJ,OAAA,EAAS,SAAA,IACT,QAAA,EAAU,UAAA,IACV,QAAA,EAAU,iBAAA,GACT,OAAA,CAAQ,eAAA;EAAA,QAmBG,uBAAA;EAAA,QAyBA,uBAAA;EAAA,QA2CA,wBAAA;EAAA,QAiCA,uBAAA;EAAA,QA4BA,sBAAA;EAlcC;;;;;;;EAAA,QA4eP,wCAAA;EAgDF,YAAA,CACJ,OAAA,UACA,OAAA,EAAS,eAAA,EACT,QAAA,WACC,OAAA;IAAU,OAAA;EAAA;EAAA,QAqCC,gBAAA;EAAA,QAyDA,4BAAA;EAwCR,qBAAA,CAAsB,EAAA,WAAa,OAAA;EAQnC,iBAAA,IAAqB,OAAA;EAQrB,sBAAA,CAAuB,OAAA,UAAiB,KAAA,UAAe,QAAA,EAAU,UAAA,KAAe,OAAA,CAAQ,cAAA;EAmBxF,oBAAA,CAAqB,OAAA,UAAiB,SAAA,UAAmB,QAAA,EAAU,UAAA,KAAe,OAAA,CAAQ,cAAA;EAmB1F,KAAA,IAAS,OAAA;AAAA"}

package/dist/mysql-DAfFK5v1.d.ts

@@ -0,0 +1,109 @@
+import { $r as WriteEntry, Gn as DbType, Hn as CoreInitLockCtx, Jn as PreparedQueries, Kn as LazyCommitTsParam, Qn as CacheLayer, Un as Database, Wn as DbQueryResult, Xn as SqlBuilder, Xr as ReadEntry, Zn as TxDatabase, qn as PooledClient, yr as CommitLogEntry } from "./index-WMhtVzJA.js";
+import { Pool, PoolOptions } from "mysql2/promise";
+import { Logger } from "pino";
+
+//#region src/db/mysql.d.ts
+/**
+ * mysql2's PoolOptions does not have a per-statement timeout field; we
+ * carry our own. Set 0 to disable.
+ */
+type MySqlPoolOptions = PoolOptions & {
+  queryTimeoutMs?: number;
+};
+declare class MySqlDatabase implements Database {
+  constructor(logger: Logger, config: MySqlPoolOptions, pool?: Pool | undefined);
+  private logger;
+  config: PoolOptions;
+  protected queryTimeoutMs: number;
+  private pool;
+  readonly dbType: DbType;
+  readonly sqlBuilder: SqlBuilder;
+  columnTypes: Map<string, Map<string, string>>;
+  protected sqlCache: Map<string, string>;
+  /**
+   * Fetches actual column types from MySQL for `table` and returns a
+   * map of DB column name → MySQL type string (as produced by `COLUMN_TYPE`,
+   * e.g. `bigint`, `integer`, `varchar(32)`, `text`, `json`).
+   * No caching here — see {@link getColumnTypes} for the cached path.
+   */
+  loadColumnTypesFromMySql(table: string): Promise<Map<string, string>>;
+  /**
+   * Synchronous column-type lookup. The apply path calls this on every
+   * batched write, so it can't await — populate the cache via
+   * {@link bootstrapColumnTypes} at server start. Throws if `table` is
+   * missing (programmer error / bootstrap skipped).
+   */
+  getColumnTypes(table: string): Map<string, string> | null;
+  /**
+   * Eagerly load column types into the in-memory cache. With a Redis
+   * client supplied, attempts the cache key first and falls through to
+   * MySQL on miss (writing the result back to Redis). This is the
+   * "one server queries MySQL, the rest read from Redis" pattern for cold
+   * starts in a multi-instance deploy. Without Redis, always queries MySQL.
+   *
+   * Pass `tables` to limit the load to a specific list; otherwise every
+   * user table in the connected database is loaded.
+   *
+   * The Redis cache key should encode whatever invalidates types in your
+   * environment (typically a schema version / deploy version). The
+   * subscriber in supalive-server.ts is expected to publish a reload
+   * signal after migrations and invoke {@link invalidateColumnTypes}.
+   */
+  bootstrapColumnTypes(opts: {
+    redis?: CacheLayer;
+    cacheKey: string;
+    tables?: string[];
+  }): Promise<void>;
+  /**
+     * Invalidate cached types (and dependent SQL) for `table`, or the entire
+     * cache if `table` is omitted. The Redis-pubsub reload signal in
+     * supalive-server.ts is expected to call this on schema changes.
+     */
+  invalidateColumnTypes(table?: string): void;
+  /** Replace this instance's caches with shared references from a parent.
+   *  Used by getTransactionClient so types loaded once at startup are
+   *  visible inside transactions. */
+  adoptCaches(columnTypes: Map<string, Map<string, string>>, sqlCache: Map<string, string>): void;
+  /** Enumerate the user-defined tables in the connected database for mysql — used
+   * by bootstrapColumnTypes() when no explicit list is provided. */
+  private listUserTables;
+  getCoreVersion(): Promise<bigint>;
+  coreMigrationStatements(toVersion: bigint): string[];
+  withCoreInitLock(fn: (ctx: CoreInitLockCtx) => Promise<void>): Promise<void>;
+  query<T = any>(sql: string, params?: unknown[]): Promise<DbQueryResult<T>>;
+  getClient(): Promise<PooledClient>;
+  getTransactionClient(): Promise<TxDatabase>;
+  getLatestSnapshotTimestamp(): Promise<bigint>;
+  updateLatestSnapshotTimestamp(commitTs: bigint): Promise<void>;
+  getMinSnapshotTimestamp(): Promise<bigint>;
+  updateMinSnapshotTimestamp(ts: bigint): Promise<void>;
+  getNextTimestamp(): Promise<bigint>;
+  attachPrevDataToWriteSet(writeSet: WriteEntry[], readSet: ReadEntry[]): Promise<void>;
+  prepareCommitWrites(readSet: ReadEntry[], writeSet: WriteEntry[], commitTs: LazyCommitTsParam): Promise<PreparedQueries>;
+  private mysqlPrepareBatchWrites;
+  private mysqlPrepareInsertBatch;
+  private mysqlPrepareUpdateSingle;
+  private mysqlPrepareDeleteBatch;
+  private mysqlPrepareCommitLogs;
+  /**
+   * Point-only OCC check. For each genuine point read, compare the row's
+   * current commit_ts against the value captured at read time. A `null`
+   * expectedCommitTs means "row didn't exist when we read"; any row found
+   * now is a conflict. Reads whose row is being written in this same txn
+   * are skipped — the CAS UPDATE/DELETE already validated those.
+   */
+  private mysqlPrepareValidatePointReadsByCommitTs;
+  commitWrites(beginTs: bigint, queries: PreparedQueries, commitTs: bigint): Promise<{
+    success: boolean;
+  }>;
+  private mysqlApplyWrites;
+  private validatePointReadsByCommitTs;
+  pruneCommitLogsBefore(ts: bigint): Promise<bigint>;
+  getMinCommitLogTs(): Promise<bigint | null>;
+  getCommitLogsBetweenTs(beginTs: bigint, endTs: bigint, tableIds: Uint8Array[]): Promise<CommitLogEntry[]>;
+  getCommitLogsSinceTs(sinceTs: bigint, excludeTs: bigint, tableIds: Uint8Array[]): Promise<CommitLogEntry[]>;
+  close(): Promise<void>;
+}
+//#endregion
+export { MySqlDatabase as t };
+//# sourceMappingURL=mysql-DAfFK5v1.d.ts.map

package/dist/mysql-DAfFK5v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql-DAfFK5v1.d.ts","names":[],"sources":["../src/db/mysql.ts"],"mappings":";;;;;;;;;KAwCY,gBAAA,GAAmB,WAAW;EAAK,cAAc;AAAA;AAAA,cAEhD,aAAA,YAAyB,QAAA;cAElC,MAAA,EAAQ,MAAA,EACR,MAAA,EAAQ,gBAAA,EACR,IAAA,GAAM,IAAA;EAAA,QAaA,MAAA;EACD,MAAA,EAAQ,WAAA;EAAA,UACL,cAAA;EAAA,QACF,IAAA;EAAA,SACC,MAAA,EAAQ,MAAA;EAAA,SACR,UAAA,EAAY,UAAA;EAMd,WAAA,EAAa,GAAA,SAAY,GAAA;EAAA,UAGtB,QAAA,EAAU,GAAA;EAwII;;;;;;EAhIlB,wBAAA,CAAyB,KAAA,WAAgB,OAAA,CAAQ,GAAA;EA0M5B;;;;;;EAlL3B,cAAA,CAAe,KAAA,WAAgB,GAAA;EA+Me;;;;;;;;;;;;;;;EAvLxC,oBAAA,CAAqB,IAAA;IACzB,KAAA,GAAQ,UAAA;IACR,QAAA;IACA,MAAA;EAAA,IACE,OAAA;EAgsBW;;;;;EAtpBf,qBAAA,CAAsB,KAAA;EAnIZ;;;EAkJV,WAAA,CACE,WAAA,EAAa,GAAA,SAAY,GAAA,mBACzB,QAAA,EAAU,GAAA;EAlJJ;;EAAA,QA0JM,cAAA;EASR,cAAA,IAAkB,OAAA;EAYxB,uBAAA,CAAwB,SAAA;EAWlB,gBAAA,CAAiB,EAAA,GAAK,GAAA,EAAK,eAAA,KAAoB,OAAA,SAAgB,OAAA;EAqC/D,KAAA,UAAe,GAAA,UAAa,MAAA,eAAyB,OAAA,CAAQ,aAAA,CAAc,CAAA;EAc3E,SAAA,IAAa,OAAA,CAAQ,YAAA;EAKrB,oBAAA,IAAwB,OAAA,CAAQ,UAAA;EAOhC,0BAAA,IAA8B,OAAA;EAK9B,6BAAA,CAA8B,QAAA,WAAmB,OAAA;EAOjD,uBAAA,IAA2B,OAAA;EAK3B,0BAAA,CAA2B,EAAA,WAAa,OAAA;EAOxC,gBAAA,IAAoB,OAAA;EAuBpB,wBAAA,CAAyB,QAAA,EAAU,UAAA,IAAc,OAAA,EAAS,SAAA,KAAc,OAAA;EA6DxE,mBAAA,CACJ,OAAA,EAAS,SAAA,IACT,QAAA,EAAU,UAAA,IACV,QAAA,EAAU,iBAAA,GACT,OAAA,CAAQ,eAAA;EAAA,QAmBG,uBAAA;EAAA,QAyBA,uBAAA;EAAA,QA2CA,wBAAA;EAAA,QAiCA,uBAAA;EAAA,QA4BA,sBAAA;EAlcC;;;;;;;EAAA,QA4eP,wCAAA;EAgDF,YAAA,CACJ,OAAA,UACA,OAAA,EAAS,eAAA,EACT,QAAA,WACC,OAAA;IAAU,OAAA;EAAA;EAAA,QAqCC,gBAAA;EAAA,QAyDA,4BAAA;EAwCR,qBAAA,CAAsB,EAAA,WAAa,OAAA;EAQnC,iBAAA,IAAqB,OAAA;EAQrB,sBAAA,CAAuB,OAAA,UAAiB,KAAA,UAAe,QAAA,EAAU,UAAA,KAAe,OAAA,CAAQ,cAAA;EAmBxF,oBAAA,CAAqB,OAAA,UAAiB,SAAA,UAAmB,QAAA,EAAU,UAAA,KAAe,OAAA,CAAQ,cAAA;EAmB1F,KAAA,IAAS,OAAA;AAAA"}

package/dist/mysql-DjjyCiO4.d.ts

@@ -0,0 +1,109 @@
+import { Bn as CoreInitLockCtx, Gn as PooledClient, Hn as DbQueryResult, Jn as SqlBuilder, Jr as ReadEntry, Kn as PreparedQueries, Un as DbType, Vn as Database, Wn as LazyCommitTsParam, Xn as CacheLayer, Yn as TxDatabase, Zr as WriteEntry, _r as CommitLogEntry } from "./index-tDcHLwJu.js";
+import { Pool, PoolOptions } from "mysql2/promise";
+import { Logger } from "pino";
+
+//#region src/db/mysql.d.ts
+/**
+ * mysql2's PoolOptions does not have a per-statement timeout field; we
+ * carry our own. Set 0 to disable.
+ */
+type MySqlPoolOptions = PoolOptions & {
+  queryTimeoutMs?: number;
+};
+declare class MySqlDatabase implements Database {
+  constructor(logger: Logger, config: MySqlPoolOptions, pool?: Pool | undefined);
+  private logger;
+  config: PoolOptions;
+  protected queryTimeoutMs: number;
+  private pool;
+  readonly dbType: DbType;
+  readonly sqlBuilder: SqlBuilder;
+  columnTypes: Map<string, Map<string, string>>;
+  protected sqlCache: Map<string, string>;
+  /**
+   * Fetches actual column types from MySQL for `table` and returns a
+   * map of DB column name → MySQL type string (as produced by `COLUMN_TYPE`,
+   * e.g. `bigint`, `integer`, `varchar(32)`, `text`, `json`).
+   * No caching here — see {@link getColumnTypes} for the cached path.
+   */
+  loadColumnTypesFromMySql(table: string): Promise<Map<string, string>>;
+  /**
+   * Synchronous column-type lookup. The apply path calls this on every
+   * batched write, so it can't await — populate the cache via
+   * {@link bootstrapColumnTypes} at server start. Throws if `table` is
+   * missing (programmer error / bootstrap skipped).
+   */
+  getColumnTypes(table: string): Map<string, string> | null;
+  /**
+   * Eagerly load column types into the in-memory cache. With a Redis
+   * client supplied, attempts the cache key first and falls through to
+   * MySQL on miss (writing the result back to Redis). This is the
+   * "one server queries MySQL, the rest read from Redis" pattern for cold
+   * starts in a multi-instance deploy. Without Redis, always queries MySQL.
+   *
+   * Pass `tables` to limit the load to a specific list; otherwise every
+   * user table in the connected database is loaded.
+   *
+   * The Redis cache key should encode whatever invalidates types in your
+   * environment (typically a schema version / deploy version). The
+   * subscriber in supalive-server.ts is expected to publish a reload
+   * signal after migrations and invoke {@link invalidateColumnTypes}.
+   */
+  bootstrapColumnTypes(opts: {
+    redis?: CacheLayer;
+    cacheKey: string;
+    tables?: string[];
+  }): Promise<void>;
+  /**
+     * Invalidate cached types (and dependent SQL) for `table`, or the entire
+     * cache if `table` is omitted. The Redis-pubsub reload signal in
+     * supalive-server.ts is expected to call this on schema changes.
+     */
+  invalidateColumnTypes(table?: string): void;
+  /** Replace this instance's caches with shared references from a parent.
+   *  Used by getTransactionClient so types loaded once at startup are
+   *  visible inside transactions. */
+  adoptCaches(columnTypes: Map<string, Map<string, string>>, sqlCache: Map<string, string>): void;
+  /** Enumerate the user-defined tables in the connected database for mysql — used
+   * by bootstrapColumnTypes() when no explicit list is provided. */
+  private listUserTables;
+  getCoreVersion(): Promise<bigint>;
+  coreMigrationStatements(toVersion: bigint): string[];
+  withCoreInitLock(fn: (ctx: CoreInitLockCtx) => Promise<void>): Promise<void>;
+  query<T = any>(sql: string, params?: unknown[]): Promise<DbQueryResult<T>>;
+  getClient(): Promise<PooledClient>;
+  getTransactionClient(): Promise<TxDatabase>;
+  getLatestSnapshotTimestamp(): Promise<bigint>;
+  updateLatestSnapshotTimestamp(commitTs: bigint): Promise<void>;
+  getMinSnapshotTimestamp(): Promise<bigint>;
+  updateMinSnapshotTimestamp(ts: bigint): Promise<void>;
+  getNextTimestamp(): Promise<bigint>;
+  attachPrevDataToWriteSet(writeSet: WriteEntry[], readSet: ReadEntry[]): Promise<void>;
+  prepareCommitWrites(readSet: ReadEntry[], writeSet: WriteEntry[], commitTs: LazyCommitTsParam): Promise<PreparedQueries>;
+  private mysqlPrepareBatchWrites;
+  private mysqlPrepareInsertBatch;
+  private mysqlPrepareUpdateSingle;
+  private mysqlPrepareDeleteBatch;
+  private mysqlPrepareCommitLogs;
+  /**
+   * Point-only OCC check. For each genuine point read, compare the row's
+   * current commit_ts against the value captured at read time. A `null`
+   * expectedCommitTs means "row didn't exist when we read"; any row found
+   * now is a conflict. Reads whose row is being written in this same txn
+   * are skipped — the CAS UPDATE/DELETE already validated those.
+   */
+  private mysqlPrepareValidatePointReadsByCommitTs;
+  commitWrites(beginTs: bigint, queries: PreparedQueries, commitTs: bigint): Promise<{
+    success: boolean;
+  }>;
+  private mysqlApplyWrites;
+  private validatePointReadsByCommitTs;
+  pruneCommitLogsBefore(ts: bigint): Promise<bigint>;
+  getMinCommitLogTs(): Promise<bigint | null>;
+  getCommitLogsBetweenTs(beginTs: bigint, endTs: bigint, tableIds: Uint8Array[]): Promise<CommitLogEntry[]>;
+  getCommitLogsSinceTs(sinceTs: bigint, excludeTs: bigint, tableIds: Uint8Array[]): Promise<CommitLogEntry[]>;
+  close(): Promise<void>;
+}
+//#endregion
+export { MySqlDatabase as t };
+//# sourceMappingURL=mysql-DjjyCiO4.d.ts.map

package/dist/mysql-DjjyCiO4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql-DjjyCiO4.d.ts","names":[],"sources":["../src/db/mysql.ts"],"mappings":";;;;;;;;;KAwCY,gBAAA,GAAmB,WAAW;EAAK,cAAc;AAAA;AAAA,cAEhD,aAAA,YAAyB,QAAA;cAElC,MAAA,EAAQ,MAAA,EACR,MAAA,EAAQ,gBAAA,EACR,IAAA,GAAM,IAAA;EAAA,QAaA,MAAA;EACD,MAAA,EAAQ,WAAA;EAAA,UACL,cAAA;EAAA,QACF,IAAA;EAAA,SACC,MAAA,EAAQ,MAAA;EAAA,SACR,UAAA,EAAY,UAAA;EAMd,WAAA,EAAa,GAAA,SAAY,GAAA;EAAA,UAGtB,QAAA,EAAU,GAAA;EAwII;;;;;;EAhIlB,wBAAA,CAAyB,KAAA,WAAgB,OAAA,CAAQ,GAAA;EA0M5B;;;;;;EAlL3B,cAAA,CAAe,KAAA,WAAgB,GAAA;EA+Me;;;;;;;;;;;;;;;EAvLxC,oBAAA,CAAqB,IAAA;IACzB,KAAA,GAAQ,UAAA;IACR,QAAA;IACA,MAAA;EAAA,IACE,OAAA;EAgsBW;;;;;EAtpBf,qBAAA,CAAsB,KAAA;EAnIZ;;;EAkJV,WAAA,CACE,WAAA,EAAa,GAAA,SAAY,GAAA,mBACzB,QAAA,EAAU,GAAA;EAlJJ;;EAAA,QA0JM,cAAA;EASR,cAAA,IAAkB,OAAA;EAYxB,uBAAA,CAAwB,SAAA;EAWlB,gBAAA,CAAiB,EAAA,GAAK,GAAA,EAAK,eAAA,KAAoB,OAAA,SAAgB,OAAA;EAqC/D,KAAA,UAAe,GAAA,UAAa,MAAA,eAAyB,OAAA,CAAQ,aAAA,CAAc,CAAA;EAc3E,SAAA,IAAa,OAAA,CAAQ,YAAA;EAKrB,oBAAA,IAAwB,OAAA,CAAQ,UAAA;EAOhC,0BAAA,IAA8B,OAAA;EAK9B,6BAAA,CAA8B,QAAA,WAAmB,OAAA;EAOjD,uBAAA,IAA2B,OAAA;EAK3B,0BAAA,CAA2B,EAAA,WAAa,OAAA;EAOxC,gBAAA,IAAoB,OAAA;EAuBpB,wBAAA,CAAyB,QAAA,EAAU,UAAA,IAAc,OAAA,EAAS,SAAA,KAAc,OAAA;EA6DxE,mBAAA,CACJ,OAAA,EAAS,SAAA,IACT,QAAA,EAAU,UAAA,IACV,QAAA,EAAU,iBAAA,GACT,OAAA,CAAQ,eAAA;EAAA,QAmBG,uBAAA;EAAA,QAyBA,uBAAA;EAAA,QA2CA,wBAAA;EAAA,QAiCA,uBAAA;EAAA,QA4BA,sBAAA;EAlcC;;;;;;;EAAA,QA4eP,wCAAA;EAgDF,YAAA,CACJ,OAAA,UACA,OAAA,EAAS,eAAA,EACT,QAAA,WACC,OAAA;IAAU,OAAA;EAAA;EAAA,QAqCC,gBAAA;EAAA,QAyDA,4BAAA;EAwCR,qBAAA,CAAsB,EAAA,WAAa,OAAA;EAQnC,iBAAA,IAAqB,OAAA;EAQrB,sBAAA,CAAuB,OAAA,UAAiB,KAAA,UAAe,QAAA,EAAU,UAAA,KAAe,OAAA,CAAQ,cAAA;EAmBxF,oBAAA,CAAqB,OAAA,UAAiB,SAAA,UAAmB,QAAA,EAAU,UAAA,KAAe,OAAA,CAAQ,cAAA;EAmB1F,KAAA,IAAS,OAAA;AAAA"}

package/dist/postgres-BKGLPrKt.d.ts

@@ -0,0 +1,113 @@
+import { $r as WriteEntry, Gn as DbType, Hn as CoreInitLockCtx, Jn as PreparedQueries, Kn as LazyCommitTsParam, Qn as CacheLayer, Un as Database, Wn as DbQueryResult, Xn as SqlBuilder, Xr as ReadEntry, Zn as TxDatabase, qn as PooledClient, yr as CommitLogEntry } from "./index-BQRlJY_1.js";
+import { Pool, PoolConfig } from "pg";
+import { Logger } from "pino";
+
+//#region src/db/postgres.d.ts
+declare class PgDatabase implements Database {
+  constructor(logger: Logger, config: PoolConfig, pool?: Pool | undefined);
+  private logger;
+  config: PoolConfig;
+  private pool;
+  readonly sqlBuilder: SqlBuilder;
+  readonly dbType: DbType;
+  columnTypes: Map<string, Map<string, string>>;
+  protected sqlCache: Map<string, string>;
+  /**
+   * Fetches actual column types from Postgres for `table` and returns a
+   * map of DB column name → PG type string (as produced by `format_type`,
+   * e.g. `bigint`, `integer`, `character varying(32)`, `text[]`, `jsonb`).
+   * No caching here — see {@link getColumnTypes} for the cached path.
+   */
+  loadColumnTypesFromPg(table: string): Promise<Map<string, string>>;
+  /**
+   * Synchronous column-type lookup. The apply path calls this on every
+   * batched write, so it can't await — populate the cache via
+   * {@link bootstrapColumnTypes} at server start. Throws if `table` is
+   * missing (programmer error / bootstrap skipped).
+   */
+  getColumnTypes(table: string): Map<string, string> | null;
+  /**
+   * Eagerly load column types into the in-memory cache. With a Redis
+   * client supplied, attempts the cache key first and falls through to
+   * Postgres on miss (writing the result back to Redis). This is the
+   * "one server queries PG, the rest read from Redis" pattern for cold
+   * starts in a multi-instance deploy. Without Redis, always queries PG.
+   *
+   * Pass `tables` to limit the load to a specific list; otherwise every
+   * user table in the connected database is loaded.
+   *
+   * The Redis cache key should encode whatever invalidates types in your
+   * environment (typically a schema version / deploy version). The
+   * subscriber in supalive-server.ts is expected to publish a reload
+   * signal after migrations and invoke {@link invalidateColumnTypes}.
+   */
+  bootstrapColumnTypes(opts: {
+    redis?: CacheLayer;
+    cacheKey: string;
+    tables?: string[];
+  }): Promise<void>;
+  /**
+   * Invalidate cached types (and dependent SQL) for `table`, or the entire
+   * cache if `table` is omitted. The Redis-pubsub reload signal in
+   * supalive-server.ts is expected to call this on schema changes.
+   */
+  private invalidateColumnTypes;
+  /** Enumerate the user-defined tables in the connected database — used
+   * by bootstrapColumnTypes() when no explicit list is provided. */
+  private listUserTables;
+  getCoreVersion(): Promise<bigint>;
+  coreMigrationStatements(toVersion: bigint): string[];
+  withCoreInitLock(fn: (ctx: CoreInitLockCtx) => Promise<void>): Promise<void>;
+  query<T = any>(sql: string, params?: unknown[]): Promise<DbQueryResult<T>>;
+  getClient(): Promise<PooledClient>;
+  getTransactionClient(): Promise<TxDatabase>;
+  /** Internal: replace this instance's caches with shared references from
+   * a parent. Used by PgDatabase.getTransactionClient. */
+  adoptCaches(columnTypes: Map<string, Map<string, string>>, sqlCache: Map<string, string>): void;
+  getLatestSnapshotTimestamp(): Promise<bigint>;
+  updateLatestSnapshotTimestamp(commitTs: bigint): Promise<void>;
+  getMinSnapshotTimestamp(): Promise<bigint>;
+  updateMinSnapshotTimestamp(ts: bigint): Promise<void>;
+  getNextTimestamp(): Promise<bigint>;
+  attachPrevDataToWriteSet(writeSet: WriteEntry[], readSet: ReadEntry[]): Promise<void>;
+  prepareCommitWrites(readSet: ReadEntry[], writeSet: WriteEntry[], commitTs: LazyCommitTsParam): Promise<PreparedQueries>;
+  private pgPrepareBatchWrites;
+  private pgPrepareInsertSingle;
+  private pgPrepareInsertBatch;
+  private pgPrepareUpdateSingle;
+  private pgPrepareUpdateBatch;
+  private pgPrepareDeleteSingle;
+  private pgPrepareDeleteBatch;
+  private buildOrGetInsertSql;
+  private buildOrGetUpdateSql;
+  private buildOrGetDeleteSql;
+  private pgPrepareCommitLogs;
+  /**
+   * Point-only OCC check. For each genuine point read, compare the row's
+   * current commit_ts against the value captured at read time. A `null`
+   * expectedCommitTs means "row didn't exist when we read"; any row found
+   * now is a conflict. Reads whose row is being written in this same txn
+   * are skipped — the CAS UPDATE/DELETE already validated those.
+   */
+  private pgPrepareValidatePointReadsByCommitTs;
+  commitWrites(beginTs: bigint, queries: PreparedQueries, commitTs: bigint): Promise<{
+    success: boolean;
+  }>;
+  private pgApplyWrites;
+  /**
+   * Point-only OCC check. For each genuine point read, compare the row's
+   * current commit_ts against the value captured at read time. A `null`
+   * expectedCommitTs means "row didn't exist when we read"; any row found
+   * now is a conflict. Reads whose row is being written in this same txn
+   * are skipped — the CAS UPDATE/DELETE already validated those.
+   */
+  private validatePointReadsByCommitTs;
+  pruneCommitLogsBefore(ts: bigint): Promise<bigint>;
+  getMinCommitLogTs(): Promise<bigint | null>;
+  getCommitLogsBetweenTs(beginTs: bigint, endTs: bigint, tableIds: Uint8Array[]): Promise<CommitLogEntry[]>;
+  getCommitLogsSinceTs(sinceTs: bigint, excludeTs: bigint, tableIds: Uint8Array[]): Promise<CommitLogEntry[]>;
+  close(): Promise<void>;
+}
+//#endregion
+export { PgDatabase as t };
+//# sourceMappingURL=postgres-BKGLPrKt.d.ts.map

package/dist/postgres-BKGLPrKt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-BKGLPrKt.d.ts","names":[],"sources":["../src/db/postgres.ts"],"mappings":";;;;;cAiBa,UAAA,YAAsB,QAAA;cAE/B,MAAA,EAAQ,MAAA,EACR,MAAA,EAAQ,UAAA,EACR,IAAA,GAAM,IAAA;EAAA,QAWA,MAAA;EACD,MAAA,EAAQ,UAAA;EAAA,QACP,IAAA;EAAA,SACC,UAAA,EAAY,UAAA;EAAA,SACZ,MAAA,EAAQ,MAAA;EAMV,WAAA,EAAa,GAAA,SAAY,GAAA;EAAA,UAGtB,QAAA,EAAU,GAAA;EAHY;;;;;;EAW1B,qBAAA,CAAsB,KAAA,WAAgB,OAAA,CAAQ,GAAA;EAoDhD;;;;;;EA5BJ,cAAA,CAAe,KAAA,WAAgB,GAAA;EAyJ4B;;;;;;;;;;;;;;;EAjIrD,oBAAA,CAAqB,IAAA;IACzB,KAAA,GAAQ,UAAA;IACR,QAAA;IACA,MAAA;EAAA,IACE,OAAA;EAyRD;;;;;EAAA,QA/OK,qBAAA;EA23BsF;;EAAA,QA72BhF,cAAA;EAUR,cAAA,IAAkB,OAAA;EAWxB,uBAAA,CAAwB,SAAA;EAUlB,gBAAA,CAAiB,EAAA,GAAK,GAAA,EAAK,eAAA,KAAoB,OAAA,SAAgB,OAAA;EAsC/D,KAAA,UAAe,GAAA,UAAa,MAAA,eAAyB,OAAA,CAAQ,aAAA,CAAc,CAAA;EAe3E,SAAA,IAAa,OAAA,CAAQ,YAAA;EAIrB,oBAAA,IAAwB,OAAA,CAAQ,UAAA;EAxOL;;EAoPjC,WAAA,CACE,WAAA,EAAa,GAAA,SAAY,GAAA,mBACzB,QAAA,EAAU,GAAA;EAMN,0BAAA,IAA8B,OAAA;EAK9B,6BAAA,CAA8B,QAAA,WAAmB,OAAA;EAOjD,uBAAA,IAA2B,OAAA;EAO3B,0BAAA,CAA2B,EAAA,WAAa,OAAA;EAOxC,gBAAA,IAAoB,OAAA;EAuBpB,wBAAA,CAAyB,QAAA,EAAU,UAAA,IAAc,OAAA,EAAS,SAAA,KAAc,OAAA;EAgExE,mBAAA,CACJ,OAAA,EAAS,SAAA,IACT,QAAA,EAAU,UAAA,IACV,QAAA,EAAU,iBAAA,GACT,OAAA,CAAQ,eAAA;EAAA,QAoBG,oBAAA;EAAA,QA2BN,qBAAA;EAAA,QAkBM,oBAAA;EAAA,QA+DN,qBAAA;EAAA,QAwBM,oBAAA;EAAA,QAsEN,qBAAA;EAAA,QAgBM,oBAAA;EAAA,QAiDN,mBAAA;EAAA,QAqBA,mBAAA;EAAA,QA4BA,mBAAA;EAAA,QAcM,mBAAA;EA3qBR;;;;;;;EAAA,QAytBE,qCAAA;EAkDF,YAAA,CACJ,OAAA,UACA,OAAA,EAAS,eAAA,EACT,QAAA,WACC,OAAA;IAAU,OAAA;EAAA;EAAA,QAqCC,aAAA;EApwBa;;;;;;;EAAA,QA+2Bb,4BAAA;EA0CR,qBAAA,CAAsB,EAAA,WAAa,OAAA;EAQnC,iBAAA,IAAqB,OAAA;EAQrB,sBAAA,CAAuB,OAAA,UAAiB,KAAA,UAAe,QAAA,EAAU,UAAA,KAAe,OAAA,CAAQ,cAAA;EAmBxF,oBAAA,CAAqB,OAAA,UAAiB,SAAA,UAAmB,QAAA,EAAU,UAAA,KAAe,OAAA,CAAQ,cAAA;EAmB1F,KAAA,IAAS,OAAA;AAAA"}

package/dist/postgres-CKBWXyY8.d.ts

@@ -0,0 +1,113 @@
+import { $r as WriteEntry, Gn as DbType, Hn as CoreInitLockCtx, Jn as PreparedQueries, Kn as LazyCommitTsParam, Qn as CacheLayer, Un as Database, Wn as DbQueryResult, Xn as SqlBuilder, Xr as ReadEntry, Zn as TxDatabase, qn as PooledClient, yr as CommitLogEntry } from "./index-D8O39FoZ.js";
+import { Pool, PoolConfig } from "pg";
+import { Logger } from "pino";
+
+//#region src/db/postgres.d.ts
+declare class PgDatabase implements Database {
+  constructor(logger: Logger, config: PoolConfig, pool?: Pool | undefined);
+  private logger;
+  config: PoolConfig;
+  private pool;
+  readonly sqlBuilder: SqlBuilder;
+  readonly dbType: DbType;
+  columnTypes: Map<string, Map<string, string>>;
+  protected sqlCache: Map<string, string>;
+  /**
+   * Fetches actual column types from Postgres for `table` and returns a
+   * map of DB column name → PG type string (as produced by `format_type`,
+   * e.g. `bigint`, `integer`, `character varying(32)`, `text[]`, `jsonb`).
+   * No caching here — see {@link getColumnTypes} for the cached path.
+   */
+  loadColumnTypesFromPg(table: string): Promise<Map<string, string>>;
+  /**
+   * Synchronous column-type lookup. The apply path calls this on every
+   * batched write, so it can't await — populate the cache via
+   * {@link bootstrapColumnTypes} at server start. Throws if `table` is
+   * missing (programmer error / bootstrap skipped).
+   */
+  getColumnTypes(table: string): Map<string, string> | null;
+  /**
+   * Eagerly load column types into the in-memory cache. With a Redis
+   * client supplied, attempts the cache key first and falls through to
+   * Postgres on miss (writing the result back to Redis). This is the
+   * "one server queries PG, the rest read from Redis" pattern for cold
+   * starts in a multi-instance deploy. Without Redis, always queries PG.
+   *
+   * Pass `tables` to limit the load to a specific list; otherwise every
+   * user table in the connected database is loaded.
+   *
+   * The Redis cache key should encode whatever invalidates types in your
+   * environment (typically a schema version / deploy version). The
+   * subscriber in supalive-server.ts is expected to publish a reload
+   * signal after migrations and invoke {@link invalidateColumnTypes}.
+   */
+  bootstrapColumnTypes(opts: {
+    redis?: CacheLayer;
+    cacheKey: string;
+    tables?: string[];
+  }): Promise<void>;
+  /**
+   * Invalidate cached types (and dependent SQL) for `table`, or the entire
+   * cache if `table` is omitted. The Redis-pubsub reload signal in
+   * supalive-server.ts is expected to call this on schema changes.
+   */
+  private invalidateColumnTypes;
+  /** Enumerate the user-defined tables in the connected database — used
+   * by bootstrapColumnTypes() when no explicit list is provided. */
+  private listUserTables;
+  getCoreVersion(): Promise<bigint>;
+  coreMigrationStatements(toVersion: bigint): string[];
+  withCoreInitLock(fn: (ctx: CoreInitLockCtx) => Promise<void>): Promise<void>;
+  query<T = any>(sql: string, params?: unknown[]): Promise<DbQueryResult<T>>;
+  getClient(): Promise<PooledClient>;
+  getTransactionClient(): Promise<TxDatabase>;
+  /** Internal: replace this instance's caches with shared references from
+   * a parent. Used by PgDatabase.getTransactionClient. */
+  adoptCaches(columnTypes: Map<string, Map<string, string>>, sqlCache: Map<string, string>): void;
+  getLatestSnapshotTimestamp(): Promise<bigint>;
+  updateLatestSnapshotTimestamp(commitTs: bigint): Promise<void>;
+  getMinSnapshotTimestamp(): Promise<bigint>;
+  updateMinSnapshotTimestamp(ts: bigint): Promise<void>;
+  getNextTimestamp(): Promise<bigint>;
+  attachPrevDataToWriteSet(writeSet: WriteEntry[], readSet: ReadEntry[]): Promise<void>;
+  prepareCommitWrites(readSet: ReadEntry[], writeSet: WriteEntry[], commitTs: LazyCommitTsParam): Promise<PreparedQueries>;
+  private pgPrepareBatchWrites;
+  private pgPrepareInsertSingle;
+  private pgPrepareInsertBatch;
+  private pgPrepareUpdateSingle;
+  private pgPrepareUpdateBatch;
+  private pgPrepareDeleteSingle;
+  private pgPrepareDeleteBatch;
+  private buildOrGetInsertSql;
+  private buildOrGetUpdateSql;
+  private buildOrGetDeleteSql;
+  private pgPrepareCommitLogs;
+  /**
+   * Point-only OCC check. For each genuine point read, compare the row's
+   * current commit_ts against the value captured at read time. A `null`
+   * expectedCommitTs means "row didn't exist when we read"; any row found
+   * now is a conflict. Reads whose row is being written in this same txn
+   * are skipped — the CAS UPDATE/DELETE already validated those.
+   */
+  private pgPrepareValidatePointReadsByCommitTs;
+  commitWrites(beginTs: bigint, queries: PreparedQueries, commitTs: bigint): Promise<{
+    success: boolean;
+  }>;
+  private pgApplyWrites;
+  /**
+   * Point-only OCC check. For each genuine point read, compare the row's
+   * current commit_ts against the value captured at read time. A `null`
+   * expectedCommitTs means "row didn't exist when we read"; any row found
+   * now is a conflict. Reads whose row is being written in this same txn
+   * are skipped — the CAS UPDATE/DELETE already validated those.
+   */
+  private validatePointReadsByCommitTs;
+  pruneCommitLogsBefore(ts: bigint): Promise<bigint>;
+  getMinCommitLogTs(): Promise<bigint | null>;
+  getCommitLogsBetweenTs(beginTs: bigint, endTs: bigint, tableIds: Uint8Array[]): Promise<CommitLogEntry[]>;
+  getCommitLogsSinceTs(sinceTs: bigint, excludeTs: bigint, tableIds: Uint8Array[]): Promise<CommitLogEntry[]>;
+  close(): Promise<void>;
+}
+//#endregion
+export { PgDatabase as t };
+//# sourceMappingURL=postgres-CKBWXyY8.d.ts.map

package/dist/postgres-CKBWXyY8.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-CKBWXyY8.d.ts","names":[],"sources":["../src/db/postgres.ts"],"mappings":";;;;;cAiBa,UAAA,YAAsB,QAAA;cAE/B,MAAA,EAAQ,MAAA,EACR,MAAA,EAAQ,UAAA,EACR,IAAA,GAAM,IAAA;EAAA,QAWA,MAAA;EACD,MAAA,EAAQ,UAAA;EAAA,QACP,IAAA;EAAA,SACC,UAAA,EAAY,UAAA;EAAA,SACZ,MAAA,EAAQ,MAAA;EAMV,WAAA,EAAa,GAAA,SAAY,GAAA;EAAA,UAGtB,QAAA,EAAU,GAAA;EAHY;;;;;;EAW1B,qBAAA,CAAsB,KAAA,WAAgB,OAAA,CAAQ,GAAA;EAoDhD;;;;;;EA5BJ,cAAA,CAAe,KAAA,WAAgB,GAAA;EAyJ4B;;;;;;;;;;;;;;;EAjIrD,oBAAA,CAAqB,IAAA;IACzB,KAAA,GAAQ,UAAA;IACR,QAAA;IACA,MAAA;EAAA,IACE,OAAA;EAyRD;;;;;EAAA,QA/OK,qBAAA;EA23BsF;;EAAA,QA72BhF,cAAA;EAUR,cAAA,IAAkB,OAAA;EAWxB,uBAAA,CAAwB,SAAA;EAUlB,gBAAA,CAAiB,EAAA,GAAK,GAAA,EAAK,eAAA,KAAoB,OAAA,SAAgB,OAAA;EAsC/D,KAAA,UAAe,GAAA,UAAa,MAAA,eAAyB,OAAA,CAAQ,aAAA,CAAc,CAAA;EAe3E,SAAA,IAAa,OAAA,CAAQ,YAAA;EAIrB,oBAAA,IAAwB,OAAA,CAAQ,UAAA;EAxOL;;EAoPjC,WAAA,CACE,WAAA,EAAa,GAAA,SAAY,GAAA,mBACzB,QAAA,EAAU,GAAA;EAMN,0BAAA,IAA8B,OAAA;EAK9B,6BAAA,CAA8B,QAAA,WAAmB,OAAA;EAOjD,uBAAA,IAA2B,OAAA;EAO3B,0BAAA,CAA2B,EAAA,WAAa,OAAA;EAOxC,gBAAA,IAAoB,OAAA;EAuBpB,wBAAA,CAAyB,QAAA,EAAU,UAAA,IAAc,OAAA,EAAS,SAAA,KAAc,OAAA;EAgExE,mBAAA,CACJ,OAAA,EAAS,SAAA,IACT,QAAA,EAAU,UAAA,IACV,QAAA,EAAU,iBAAA,GACT,OAAA,CAAQ,eAAA;EAAA,QAoBG,oBAAA;EAAA,QA2BN,qBAAA;EAAA,QAkBM,oBAAA;EAAA,QA+DN,qBAAA;EAAA,QAwBM,oBAAA;EAAA,QAsEN,qBAAA;EAAA,QAgBM,oBAAA;EAAA,QAiDN,mBAAA;EAAA,QAqBA,mBAAA;EAAA,QA4BA,mBAAA;EAAA,QAcM,mBAAA;EA3qBR;;;;;;;EAAA,QAytBE,qCAAA;EAkDF,YAAA,CACJ,OAAA,UACA,OAAA,EAAS,eAAA,EACT,QAAA,WACC,OAAA;IAAU,OAAA;EAAA;EAAA,QAqCC,aAAA;EApwBa;;;;;;;EAAA,QA+2Bb,4BAAA;EA0CR,qBAAA,CAAsB,EAAA,WAAa,OAAA;EAQnC,iBAAA,IAAqB,OAAA;EAQrB,sBAAA,CAAuB,OAAA,UAAiB,KAAA,UAAe,QAAA,EAAU,UAAA,KAAe,OAAA,CAAQ,cAAA;EAmBxF,oBAAA,CAAqB,OAAA,UAAiB,SAAA,UAAmB,QAAA,EAAU,UAAA,KAAe,OAAA,CAAQ,cAAA;EAmB1F,KAAA,IAAS,OAAA;AAAA"}