@h-ai/reldb 1.0.0-beta.2 → 1.0.0-beta.20

package/dist/index.js

@@ -1,5 +1,5 @@
-import { ReldbConfigSchema, MysqlPoolConfigSchema } from './chunk-SDS2ZT3V.js';
-export { MysqlConfigSchema, MysqlOptionsSchema, MysqlPoolConfigSchema, MysqlSslConfigSchema, PoolConfigSchema, PostgresqlConfigSchema, ReldbConfigSchema, ReldbOperationLogConfigSchema, ReldbTypeSchema, SqliteConfigSchema, SqliteOptionsSchema, SslConfigSchema } from './chunk-SDS2ZT3V.js';
+import { ReldbConfigSchema, MysqlPoolConfigSchema } from './chunk-7OE27ZH3.js';
+export { MysqlConfigSchema, MysqlOptionsSchema, MysqlPoolConfigSchema, MysqlSslConfigSchema, PoolConfigSchema, PostgresqlConfigSchema, ReldbConfigSchema, ReldbOperationLogConfigSchema, ReldbTypeSchema, SqliteConfigSchema, SqliteOptionsSchema, SslConfigSchema } from './chunk-7OE27ZH3.js';
 import { core, ok, err, HaiCommonError } from '@h-ai/core';
 import process from 'process';
 import { createRequire } from 'module';
@@ -253,7 +253,10 @@ var BaseReldbCrudRepository = class {
    * @returns 表结构定义
    */
   buildReldbTableDef(fields) {
-    const entries = fields.map((field) => [field.columnName, this.normalizeReldbColumnDef(field.def)]);
+    const entries = fields.map((field) => [
+      field.columnName,
+      this.normalizeReldbColumnDef(field.def)
+    ]);
     return Object.fromEntries(entries);
   }
   /**
@@ -599,7 +602,10 @@ var BaseReldbCrudRepository = class {
     } else {
       sql = `INSERT INTO ${this.table} (${insertColumns.join(", ")}) VALUES (${placeholders}) ON CONFLICT(${this.idColumn}) DO UPDATE SET ${updateSet}`;
     }
-    return this.sql(tx).execute(sql, [...insertValues, ...updateValues]);
+    return this.sql(tx).execute(sql, [
+      ...insertValues,
+      ...updateValues
+    ]);
   }
   /**
    * 根据主键查找单条记录
@@ -879,13 +885,19 @@ function createSqliteJsonOps() {
     set(column, path, value) {
       return {
         sql: `json_set(${column}, ?, json(?))`,
-        params: [path, JSON.stringify(value)]
+        params: [
+          path,
+          JSON.stringify(value)
+        ]
       };
     },
     insert(column, path, value) {
       return {
         sql: `json_insert(${column}, ?, json(?))`,
-        params: [path, JSON.stringify(value)]
+        params: [
+          path,
+          JSON.stringify(value)
+        ]
       };
     },
     remove(column, path) {
@@ -897,7 +909,9 @@ function createSqliteJsonOps() {
     merge(column, patch) {
       return {
         sql: `json_patch(${column}, ?)`,
-        params: [JSON.stringify(patch)]
+        params: [
+          JSON.stringify(patch)
+        ]
       };
     }
   };
@@ -907,14 +921,25 @@ function buildPostgresMergePatch(column, patch) {
   if (!normalized || typeof normalized !== "object" || Array.isArray(normalized))
     throw new TypeError(reldbM("reldb_jsonPatchObjectRequired"));
   const steps = [];
-  const pending = Object.entries(normalized).reverse().map(([key, value]) => ({ path: [key], value }));
+  const pending = Object.entries(normalized).reverse().map(([key, value]) => ({
+    path: [key],
+    value
+  }));
   while (pending.length > 0) {
     const entry = pending.pop();
     const object = entry.value !== null && typeof entry.value === "object" && !Array.isArray(entry.value);
-    steps.push({ path: entry.path, value: object ? {} : entry.value, object });
+    steps.push({
+      path: entry.path,
+      value: object ? {} : entry.value,
+      object
+    });
     if (object) {
-      for (const [key, value] of Object.entries(entry.value).reverse())
-        pending.push({ path: [...entry.path, key], value });
+      for (const [key, value] of Object.entries(entry.value).reverse()) {
+        pending.push({
+          path: [...entry.path, key],
+          value
+        });
+      }
     }
   }
   return {
@@ -939,7 +964,9 @@ function buildPostgresMergePatch(column, patch) {
         FROM merged JOIN patch_steps ON patch_steps.step = merged.step + 1
       )
       SELECT document FROM merged ORDER BY step DESC LIMIT 1)`,
-    params: [JSON.stringify(steps)]
+    params: [
+      JSON.stringify(steps)
+    ]
   };
 }
 function createPostgresJsonOps() {
@@ -955,14 +982,20 @@ function createPostgresJsonOps() {
       const segments = parseJsonPath(path);
       return {
         sql: `jsonb_set(${column}, ?::text[], ?::jsonb)`,
-        params: [segments, JSON.stringify(value)]
+        params: [
+          segments,
+          JSON.stringify(value)
+        ]
       };
     },
     insert(column, path, value) {
       const segments = parseJsonPath(path);
       return {
         sql: `jsonb_insert(${column}, ?::text[], ?::jsonb)`,
-        params: [segments, JSON.stringify(value)]
+        params: [
+          segments,
+          JSON.stringify(value)
+        ]
       };
     },
     remove(column, path) {
@@ -988,13 +1021,19 @@ function createMysqlJsonOps() {
     set(column, path, value) {
       return {
         sql: `JSON_SET(${column}, ?, CAST(? AS JSON))`,
-        params: [path, JSON.stringify(value)]
+        params: [
+          path,
+          JSON.stringify(value)
+        ]
       };
     },
     insert(column, path, value) {
       return {
         sql: `JSON_INSERT(${column}, ?, CAST(? AS JSON))`,
-        params: [path, JSON.stringify(value)]
+        params: [
+          path,
+          JSON.stringify(value)
+        ]
       };
     },
     remove(column, path) {
@@ -1006,7 +1045,9 @@ function createMysqlJsonOps() {
     merge(column, patch) {
       return {
         sql: `JSON_MERGE_PATCH(${column}, CAST(? AS JSON))`,
-        params: [JSON.stringify(patch)]
+        params: [
+          JSON.stringify(patch)
+        ]
       };
     }
   };
@@ -1088,7 +1129,9 @@ function validateIdentifier(name) {
   if (VALID_IDENTIFIER_RE.test(name)) {
     return ok(name);
   }
-  return err(HaiReldbError.CONFIG_ERROR, reldbM("reldb_invalidIdentifier", { params: { name } }));
+  return err(HaiReldbError.CONFIG_ERROR, reldbM("reldb_invalidIdentifier", {
+    params: { name }
+  }));
 }
 function validateIdentifiers(names) {
   for (const name of names) {
@@ -1331,7 +1374,11 @@ function createCrud(ops, config) {
         return findResult;
       }
       if (findResult.data === null) {
-        return err(HaiReldbError.RECORD_NOT_FOUND, reldbM("reldb_crudRecordNotFound", { params: { id: String(id) } }));
+        return err(HaiReldbError.RECORD_NOT_FOUND, reldbM("reldb_crudRecordNotFound", {
+          params: {
+            id: String(id)
+          }
+        }));
       }
       return ok(findResult.data);
     },
@@ -1404,7 +1451,10 @@ function createCrud(ops, config) {
       }
       const setClause = filtered.map((column) => `${column} = ?`).join(", ");
       const sql = `UPDATE ${table} SET ${setClause} WHERE ${idColumn} = ?`;
-      const params = [...filtered.map((column) => data[column]), id];
+      const params = [
+        ...filtered.map((column) => data[column]),
+        id
+      ];
       return resolveOps(tx).execute(sql, params);
     },
     /**
@@ -1517,12 +1567,11 @@ function createTxHandle(baseDmlOps, callbacks) {
       const check = ensureActive();
       if (!check.success)
         return check;
+      active = false;
       try {
         await callbacks.commit();
-        active = false;
         return ok(void 0);
       } catch (error) {
-        active = false;
         return err(HaiReldbError.TRANSACTION_FAILED, callbacks.errorMessage(String(error)), error);
       } finally {
         callbacks.release();
@@ -1532,12 +1581,11 @@ function createTxHandle(baseDmlOps, callbacks) {
       const check = ensureActive();
       if (!check.success)
         return check;
+      active = false;
       try {
         await callbacks.rollback();
-        active = false;
         return ok(void 0);
       } catch (error) {
-        active = false;
         return err(HaiReldbError.TRANSACTION_FAILED, callbacks.errorMessage(String(error)), error);
       } finally {
         callbacks.release();
@@ -1559,7 +1607,11 @@ function createTxWrap(beginTx) {
       return ok(result);
     } catch (error) {
       await txResult.data.rollback();
-      return err(HaiReldbError.TRANSACTION_FAILED, reldbM("reldb_txFailed", { params: { error: String(error) } }), error);
+      return err(HaiReldbError.TRANSACTION_FAILED, reldbM("reldb_txFailed", {
+        params: {
+          error: String(error)
+        }
+      }), error);
     }
   };
 }
@@ -1599,8 +1651,14 @@ async function wrapOp(ctx, fn, errorDef, errorLabel, errorMeta) {
     let definition = original ?? errorDef;
     const traceId = core.context.get().traceId ?? core.context.get().requestId ?? original?.traceId ?? core.id.uuid();
     const fields = error && typeof error === "object" ? error : {};
-    if (definition.code === HaiReldbError.QUERY_FAILED.code && (["23505", "ER_DUP_ENTRY", "SQLITE_CONSTRAINT_UNIQUE", "SQLITE_CONSTRAINT_PRIMARYKEY"].includes(String(fields.code)) || fields.errno === 1062))
+    if (definition.code === HaiReldbError.QUERY_FAILED.code && ([
+      "23505",
+      "ER_DUP_ENTRY",
+      "SQLITE_CONSTRAINT_UNIQUE",
+      "SQLITE_CONSTRAINT_PRIMARYKEY"
+    ].includes(String(fields.code)) || fields.errno === 1062)) {
       definition = HaiReldbError.DUPLICATE_ENTRY;
+    }
     const secrets = /* @__PURE__ */ new Set();
     const seen = /* @__PURE__ */ new WeakSet();
     const collect = (value) => {
@@ -1614,17 +1672,44 @@ async function wrapOp(ctx, fn, errorDef, errorLabel, errorMeta) {
       }
     };
     collect(errorMeta?.params);
-    const payloads = [errorMeta, ...Array.isArray(errorMeta?.statements) ? errorMeta.statements : []];
+    const payloads = [
+      errorMeta,
+      ...Array.isArray(errorMeta?.statements) ? errorMeta.statements : []
+    ];
     for (const payload of payloads) {
       collect(payload?.params);
       for (const match of (typeof payload?.sql === "string" ? payload.sql : "").matchAll(/'((?:''|[^'])*)'/g))
         secrets.add(match[1].replaceAll("''", "'"));
     }
     const diagnostic = {};
-    for (const key2 of ["name", "message", "stack", "code", "errno", "sqlState", "detail", "hint", "constraint", "schema", "routine", "severity", "table", "column"]) {
+    for (const key2 of [
+      "name",
+      "message",
+      "stack",
+      "code",
+      "errno",
+      "sqlState",
+      "detail",
+      "hint",
+      "constraint",
+      "schema",
+      "routine",
+      "severity",
+      "table",
+      "column"
+    ]) {
       const value = error instanceof Error && key2 === "message" ? error.message : error instanceof Error && key2 === "stack" ? error.stack : fields[key2];
       if (typeof value === "string") {
-        if (["code", "sqlState", "schema", "routine", "severity", "constraint", "table", "column"].includes(key2)) {
+        if ([
+          "code",
+          "sqlState",
+          "schema",
+          "routine",
+          "severity",
+          "constraint",
+          "table",
+          "column"
+        ].includes(key2)) {
           diagnostic[key2] = core.sanitize.sanitizeText(value);
         } else {
           const frames = key2 === "stack" ? value.search(/^\s+at\s/m) : -1;
@@ -1637,9 +1722,21 @@ async function wrapOp(ctx, fn, errorDef, errorLabel, errorMeta) {
     }
     if (!Object.keys(diagnostic).length)
       diagnostic.message = core.sanitize.sanitizeText(String(error), [...secrets]);
-    ctx.logger.error(errorLabel, { ...summarizeOperationPayload(errorMeta), table: errorMeta?.tableName, column: errorMeta?.columnName, errorCode: definition.code, traceId, error: diagnostic });
+    ctx.logger.error(errorLabel, {
+      ...summarizeOperationPayload(errorMeta),
+      table: errorMeta?.tableName,
+      column: errorMeta?.columnName,
+      errorCode: definition.code,
+      traceId,
+      error: diagnostic
+    });
     const key = definition.code === HaiReldbError.DDL_FAILED.code ? "reldb_ddlFailed" : definition.code === HaiReldbError.TRANSACTION_FAILED.code ? "reldb_txFailed" : "reldb_queryFailed";
-    return err({ ...definition, traceId, message: definition.code === HaiReldbError.DUPLICATE_ENTRY.code ? reldbM("reldb_duplicateEntry") : original ? core.sanitize.sanitizeText(original.message, [...secrets]) : reldbM(key), cause: diagnostic });
+    return err({
+      ...definition,
+      traceId,
+      message: definition.code === HaiReldbError.DUPLICATE_ENTRY.code ? reldbM("reldb_duplicateEntry") : original ? core.sanitize.sanitizeText(original.message, [...secrets]) : reldbM(key),
+      cause: diagnostic
+    });
   };
   try {
     const result = await fn();
@@ -1783,14 +1880,20 @@ async function queryPageAsync(queryRows, options) {
   const countRows = await queryRows(countSql, options.params);
   const total = countRows.length > 0 ? parseCount(countRows[0]) : 0;
   const dataSql = `${options.sql} LIMIT ? OFFSET ?`;
-  const dataParams = [...options.params ?? [], pagination2.limit, pagination2.offset];
+  const dataParams = [
+    ...options.params ?? [],
+    pagination2.limit,
+    pagination2.offset
+  ];
   const rows = await queryRows(dataSql, dataParams);
   return buildPaginatedResult(rows, total, pagination2);
 }
 
 // src/providers/reldb-ddl-builder.ts
 function buildColumnSqlBase(name, def, options) {
-  const parts = [options.quoteId(name)];
+  const parts = [
+    options.quoteId(name)
+  ];
   parts.push(options.mapType(def));
   if (options.inlinePrimaryKey && def.primaryKey) {
     parts.push("PRIMARY KEY");
@@ -1934,10 +2037,18 @@ function createMysqlProvider() {
             }));
           }, (error) => {
             releaseSlot();
-            finish(err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_mysqlConnectionFailed", { params: { error: String(error) } }), error));
+            finish(err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_mysqlConnectionFailed", {
+              params: {
+                error: String(error)
+              }
+            }), error));
           }).catch((error) => {
             ready = false;
-            finish(err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_mysqlConnectionFailed", { params: { error: reldbM("reldb_mysqlPoolReleaseFailed") } }), error));
+            finish(err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_mysqlConnectionFailed", {
+              params: {
+                error: reldbM("reldb_mysqlPoolReleaseFailed")
+              }
+            }), error));
             logger2.warn("MySQL connection release failed; pool requires cleanup");
           });
         }
@@ -1986,7 +2097,11 @@ function createMysqlProvider() {
         poolConfig = null;
         return ok(void 0);
       } catch (error) {
-        return err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_mysqlConnectionFailed", { params: { error: String(error) } }), error);
+        return err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_mysqlConnectionFailed", {
+          params: {
+            error: String(error)
+          }
+        }), error);
       }
     })().finally(() => {
       closing = null;
@@ -2002,7 +2117,9 @@ function createMysqlProvider() {
     return `\`${name}\``;
   }
   function mysqlTxErrorMessage(detail) {
-    return reldbM("reldb_mysqlTxFailed", { params: { error: detail } });
+    return reldbM("reldb_mysqlTxFailed", {
+      params: { error: detail }
+    });
   }
   async function findIndexTableName(indexName) {
     return withConnection(async (connection) => {
@@ -2129,7 +2246,9 @@ function createMysqlProvider() {
       if (!tableResult.data) {
         if (ifExists)
           return ok(void 0);
-        return err(HaiReldbError.DDL_FAILED, reldbM("reldb_ddlFailed", { params: { error: `index not found: ${index}` } }));
+        return err(HaiReldbError.DDL_FAILED, reldbM("reldb_ddlFailed", {
+          params: { error: `index not found: ${index}` }
+        }));
       }
       return executeDdl(`DROP INDEX ${mysqlQuoteId(index)} ON ${mysqlQuoteId(tableResult.data)}`);
     },
@@ -2168,7 +2287,11 @@ function createMysqlProvider() {
         } catch (error) {
           await connection.rollback().catch(() => {
           });
-          return err(HaiReldbError.QUERY_FAILED, reldbM("reldb_batchFailed", { params: { error: String(error) } }), error);
+          return err(HaiReldbError.QUERY_FAILED, reldbM("reldb_batchFailed", {
+            params: {
+              error: String(error)
+            }
+          }), error);
         }
       });
     },
@@ -2233,7 +2356,10 @@ function createMysqlProvider() {
       return err(HaiReldbError.TRANSACTION_FAILED, mysqlTxErrorMessage(String(error)), error);
     }
     const txDmlOps = createMysqlTxDmlOps(connection);
-    const guardedTxDmlOps = createBaseDmlOps({ ...ctx, isConnected: () => connection !== null }, txDmlOps);
+    const guardedTxDmlOps = createBaseDmlOps({
+      ...ctx,
+      isConnected: () => connection !== null
+    }, txDmlOps);
     return ok(createTxHandle(guardedTxDmlOps, {
       commit: async () => {
         await connection.commit();
@@ -2275,7 +2401,13 @@ function createMysqlProvider() {
         poolConfig = config.pool ?? MysqlPoolConfigSchema.parse({});
         pool = mysql.createPool({
           // mysql2 会用非空的分字段覆盖 URI；URL 模式不能传 schema 默认 host 或冲突字段。
-          ...config.url ? { uri: config.url } : { host: config.host, port: config.port, database: config.database, user: config.user, password: config.password },
+          ...config.url ? { uri: config.url } : {
+            host: config.host,
+            port: config.port,
+            database: config.database,
+            user: config.user,
+            password: config.password
+          },
           ssl: config.ssl,
           connectionLimit: poolConfig.max,
           // 排队由本 Provider 管理，超时项可直接移除；驱动绝不保留取消后的等待者。
@@ -2286,12 +2418,21 @@ function createMysqlProvider() {
         await pool.query("SELECT 1");
         ready = true;
         currentConfig2 = config;
-        logger2.info("Connected to MySQL", config.url ? { target: core.sanitize.sanitizeUrl(config.url) } : { host: config.host, port: config.port, database: config.database });
+        logger2.info("Connected to MySQL", config.url ? {
+          target: core.sanitize.sanitizeUrl(config.url)
+        } : { host: config.host, port: config.port, database: config.database });
         return ok(void 0);
       } catch (error) {
         const cleanup = await closeResource();
-        const result = err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_mysqlConnectionFailed", { params: { error: String(error) } }), error);
-        return cleanup.success || result.success ? result : err({ ...result.error, ext: { cleanupPending: true, cleanupError: cleanup.error } });
+        const result = err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_mysqlConnectionFailed", {
+          params: {
+            error: String(error)
+          }
+        }), error);
+        return cleanup.success || result.success ? result : err({
+          ...result.error,
+          ext: { cleanupPending: true, cleanupError: cleanup.error }
+        });
       }
     },
     close: closeResource,
@@ -2339,7 +2480,11 @@ function createPostgresProvider() {
         pool = null;
         return ok(void 0);
       } catch (error) {
-        return err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_postgresConnectionFailed", { params: { error: String(error) } }), error);
+        return err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_postgresConnectionFailed", {
+          params: {
+            error: String(error)
+          }
+        }), error);
       }
     })().finally(() => {
       closing = null;
@@ -2442,7 +2587,9 @@ function createPostgresProvider() {
     return out;
   }
   function pgTxErrorMessage(detail) {
-    return reldbM("reldb_postgresTxFailed", { params: { error: detail } });
+    return reldbM("reldb_postgresTxFailed", {
+      params: { error: detail }
+    });
   }
   function mapPgType(def) {
     switch (def.type) {
@@ -2565,7 +2712,11 @@ function createPostgresProvider() {
           await client.query("ROLLBACK").catch(() => {
           });
         }
-        return err(HaiReldbError.QUERY_FAILED, reldbM("reldb_batchFailed", { params: { error: String(error) } }), error);
+        return err(HaiReldbError.QUERY_FAILED, reldbM("reldb_batchFailed", {
+          params: {
+            error: String(error)
+          }
+        }), error);
       } finally {
         if (client) {
           client.release();
@@ -2631,7 +2782,10 @@ function createPostgresProvider() {
       return err(HaiReldbError.TRANSACTION_FAILED, pgTxErrorMessage(String(error)), error);
     }
     const txDmlOps = createPgTxDmlOps(client);
-    const guardedTxDmlOps = createBaseDmlOps({ ...ctx, isConnected: () => client !== null }, txDmlOps);
+    const guardedTxDmlOps = createBaseDmlOps({
+      ...ctx,
+      isConnected: () => client !== null
+    }, txDmlOps);
     return ok(createTxHandle(guardedTxDmlOps, {
       commit: async () => {
         await client.query("COMMIT");
@@ -2697,8 +2851,15 @@ function createPostgresProvider() {
         return ok(void 0);
       } catch (error) {
         const cleanup = await closeResource();
-        const result = err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_postgresConnectionFailed", { params: { error: String(error) } }), error);
-        return cleanup.success || result.success ? result : err({ ...result.error, ext: { cleanupPending: true, cleanupError: cleanup.error } });
+        const result = err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_postgresConnectionFailed", {
+          params: {
+            error: String(error)
+          }
+        }), error);
+        return cleanup.success || result.success ? result : err({
+          ...result.error,
+          ext: { cleanupPending: true, cleanupError: cleanup.error }
+        });
       }
     },
     close: closeResource,
@@ -2931,7 +3092,11 @@ function createSqliteProvider() {
         engine = null;
         return ok(void 0);
       } catch (error) {
-        return err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_sqliteConnectionFailed", { params: { error: String(error) } }), error);
+        return err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_sqliteConnectionFailed", {
+          params: {
+            error: String(error)
+          }
+        }), error);
       }
     })().finally(() => {
       closing = null;
@@ -3001,7 +3166,9 @@ function createSqliteProvider() {
     });
   }
   function sqliteTxErrorMessage(detail) {
-    return reldbM("reldb_sqliteTxFailed", { params: { error: detail } });
+    return reldbM("reldb_sqliteTxFailed", {
+      params: { error: detail }
+    });
   }
   const rawDdl = {
     async createTable(name, columns, ifNotExists = true) {
@@ -3062,7 +3229,11 @@ function createSqliteProvider() {
         await engine.batch(statements);
         return ok(void 0);
       } catch (error) {
-        return err(HaiReldbError.QUERY_FAILED, reldbM("reldb_sqliteBatchFailed", { params: { error: String(error) } }), error);
+        return err(HaiReldbError.QUERY_FAILED, reldbM("reldb_sqliteBatchFailed", {
+          params: {
+            error: String(error)
+          }
+        }), error);
       } finally {
         releaseTxLock();
       }
@@ -3118,7 +3289,10 @@ function createSqliteProvider() {
       return err(HaiReldbError.TRANSACTION_FAILED, sqliteTxErrorMessage(String(error)), error);
     }
     const txDmlOps = createSqliteTxDmlOps(txEngine);
-    const guardedTxDmlOps = createBaseDmlOps({ ...ctx, isConnected: () => txEngine.isOpen() }, txDmlOps);
+    const guardedTxDmlOps = createBaseDmlOps({
+      ...ctx,
+      isConnected: () => txEngine.isOpen()
+    }, txDmlOps);
     return ok(createTxHandle(guardedTxDmlOps, {
       commit: async () => {
         await txEngine.exec("COMMIT");
@@ -3163,8 +3337,15 @@ function createSqliteProvider() {
         return ok(void 0);
       } catch (error) {
         const cleanup = await closeResource();
-        const result = err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_sqliteConnectionFailed", { params: { error: String(error) } }), error);
-        return cleanup.success || result.success ? result : err({ ...result.error, ext: { cleanupPending: true, cleanupError: cleanup.error } });
+        const result = err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_sqliteConnectionFailed", {
+          params: {
+            error: String(error)
+          }
+        }), error);
+        return cleanup.success || result.success ? result : err({
+          ...result.error,
+          ext: { cleanupPending: true, cleanupError: cleanup.error }
+        });
       }
     },
     close: closeResource,
@@ -3175,6 +3356,113 @@ function createSqliteProvider() {
     tx: createBaseTxManager(ctx, beginTx)
   };
 }
+async function schemaColumns(db, table, sql = db.sql) {
+  if (!/^[a-z][a-z0-9_]{0,62}$/.test(table))
+    return err(HaiCommonError.VALIDATION_ERROR, core.i18n.coreM("core_errorValidation"));
+  const type = db.config?.type;
+  const found = type === "sqlite" ? await sql.query(`PRAGMA table_info(${table})`) : await sql.query(`SELECT column_name AS name FROM information_schema.columns WHERE table_schema=${type === "mysql" ? "DATABASE()" : "current_schema()"} AND table_name=?`, [table]);
+  return found.success ? ok(found.data.map((row) => row.name)) : found;
+}
+async function migrateSchema(db, module, steps, options = {}) {
+  if (!db.isInitialized || !/^[a-z][a-z0-9-]{0,62}$/.test(module) || steps.some((step, index) => step.version !== index + 1))
+    return err(HaiCommonError.VALIDATION_ERROR, core.i18n.coreM("core_errorValidation"));
+  const table = "hai_schema_migrations";
+  const targetVersion = steps.length;
+  const failed = (cause) => err({
+    ...HaiCommonError.INIT_FAILED,
+    message: core.i18n.coreM("core_runtimeStartFailed", {
+      params: { module }
+    }),
+    ext: { module, phase: "migration" },
+    cause
+  });
+  async function inspect(sql) {
+    const columns = await schemaColumns(db, table, sql);
+    if (!columns.success)
+      return failed(columns.error);
+    const row = columns.data.length ? await sql.get(`SELECT version FROM ${table} WHERE module=?`, [module]) : ok(null);
+    if (!row.success)
+      return failed(row.error);
+    const currentVersion = Number(row.data?.version ?? 0);
+    if (currentVersion > targetVersion)
+      return failed();
+    const changes = [];
+    for (const step of steps) {
+      const needed = await step.needed(sql);
+      if (!needed.success)
+        return failed(needed.error);
+      if (needed.data)
+        changes.push(step.name);
+    }
+    return ok({
+      module,
+      currentVersion,
+      targetVersion,
+      changes,
+      requiresExclusiveAccess: changes.length > 0
+    });
+  }
+  if (options.dryRun)
+    return inspect(db.sql);
+  const created = await db.sql.execute(`CREATE TABLE IF NOT EXISTS ${table} (module VARCHAR(64) PRIMARY KEY, version INTEGER NOT NULL)`);
+  if (!created.success)
+    return failed(created.error);
+  const seeded = await db.sql.execute(db.config?.type === "mysql" ? `INSERT IGNORE INTO ${table}(module,version) VALUES (?,0)` : `INSERT INTO ${table}(module,version) VALUES (?,0) ON CONFLICT(module) DO NOTHING`, [module]);
+  if (!seeded.success)
+    return failed(seeded.error);
+  const started = await db.tx.begin();
+  if (!started.success)
+    return failed(started.error);
+  const tx = started.data;
+  let mysqlLock = false;
+  let committed = false;
+  try {
+    if (db.config?.type === "mysql") {
+      const lock = await tx.get("SELECT GET_LOCK(?,30) AS acquired", [`hai-schema:${module}`]);
+      if (!lock.success || Number(lock.data?.acquired) !== 1) {
+        return failed(lock.success ? new Error("Migration lock unavailable") : lock.error);
+      }
+      mysqlLock = true;
+    }
+    const locked = await tx.execute(`UPDATE ${table} SET version=version WHERE module=?`, [module]);
+    if (!locked.success)
+      return failed(locked.error);
+    const plan = await inspect(tx);
+    if (!plan.success)
+      return plan;
+    for (const step of steps) {
+      const needed = await step.needed(tx);
+      if (!needed.success)
+        return failed(needed.error);
+      if (needed.data) {
+        const applied = await step.apply(tx);
+        if (!applied.success)
+          return failed(applied.error);
+        const remaining = await step.needed(tx);
+        if (!remaining.success || remaining.data) {
+          return failed(remaining.success ? new Error("Migration step did not converge") : remaining.error);
+        }
+      }
+    }
+    const recorded = await tx.execute(`UPDATE ${table} SET version=? WHERE module=?`, [targetVersion, module]);
+    if (!recorded.success)
+      return failed(recorded.error);
+    if (mysqlLock) {
+      await tx.get("SELECT RELEASE_LOCK(?)", [`hai-schema:${module}`]);
+      mysqlLock = false;
+    }
+    const result = await tx.commit();
+    committed = result.success;
+    return result.success ? plan : failed(result.error);
+  } catch (error) {
+    return failed(error);
+  } finally {
+    if (mysqlLock)
+      await tx.get("SELECT RELEASE_LOCK(?)", [`hai-schema:${module}`]);
+    if (!committed)
+      await tx.rollback();
+  }
+}
 
 // src/reldb-main.ts
 var logger5 = core.logger.child({ module: "reldb", scope: "main" });
@@ -3196,15 +3484,26 @@ async function closeOwnedProvider() {
     return ok(void 0);
   try {
     const result = await pendingProvider.close();
-    if (!result.success)
-      return err({ ...result.error, ext: { ...result.error.ext, cleanupPending: true } });
+    if (!result.success) {
+      return err({
+        ...result.error,
+        ext: { ...result.error.ext, cleanupPending: true }
+      });
+    }
     pendingProvider = null;
     return ok(void 0);
   } catch (error) {
     logger5.error("Provider cleanup failed; retaining resource for retry", { error });
-    return err({ ...HaiReldbError.CONNECTION_FAILED, message: reldbM("reldb_closeFailed", {
-      params: { error: error instanceof Error ? error.message : String(error) }
-    }), cause: error, ext: { cleanupPending: true } });
+    return err({
+      ...HaiReldbError.CONNECTION_FAILED,
+      message: reldbM("reldb_closeFailed", {
+        params: {
+          error: error instanceof Error ? error.message : String(error)
+        }
+      }),
+      cause: error,
+      ext: { cleanupPending: true }
+    });
   }
 }
 async function failInitialization(result) {
@@ -3215,9 +3514,15 @@ async function failInitialization(result) {
     const ext = { ...result.error.ext };
     delete ext.cleanupPending;
     delete ext.cleanupError;
-    return err({ ...result.error, ext: Object.keys(ext).length > 0 ? ext : void 0 });
+    return err({
+      ...result.error,
+      ext: Object.keys(ext).length > 0 ? ext : void 0
+    });
   }
-  return err({ ...result.error, ext: { ...result.error.ext, cleanupPending: true, cleanupError: cleanup.error } });
+  return err({
+    ...result.error,
+    ext: { ...result.error.ext, cleanupPending: true, cleanupError: cleanup.error }
+  });
 }
 function createProvider(config) {
   switch (config.type) {
@@ -3259,7 +3564,9 @@ var reldb = {
   async init(config) {
     if (initInProgress || closingPromise) {
       logger5.warn("RelDB module init is already in progress, skipping concurrent call");
-      return err(HaiReldbError.CONFIG_ERROR, reldbM("reldb_configError", { params: { error: "init already in progress" } }));
+      return err(HaiReldbError.CONFIG_ERROR, reldbM("reldb_configError", {
+        params: { error: "init already in progress" }
+      }));
     }
     initInProgress = true;
     let resolveInit;
@@ -3274,7 +3581,9 @@ var reldb = {
       const parseResult = ReldbConfigSchema.safeParse(config);
       if (!parseResult.success) {
         logger5.error("RelDB config validation failed", { error: parseResult.error.message });
-        return err(HaiReldbError.CONFIG_ERROR, reldbM("reldb_configError", { params: { error: parseResult.error.message } }), parseResult.error);
+        return err(HaiReldbError.CONFIG_ERROR, reldbM("reldb_configError", {
+          params: { error: parseResult.error.message }
+        }), parseResult.error);
       }
       const parsed = parseResult.data;
       if (core.module.requiresSharedState(process.env) && parsed.type === "sqlite")
@@ -3298,7 +3607,11 @@ var reldb = {
         return ok(void 0);
       } catch (error) {
         logger5.error("RelDB module initialization failed", { error });
-        return await failInitialization(err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_initFailed", { params: { error: error instanceof Error ? error.message : String(error) } }), error));
+        return await failInitialization(err(HaiReldbError.CONNECTION_FAILED, reldbM("reldb_initFailed", {
+          params: {
+            error: error instanceof Error ? error.message : String(error)
+          }
+        }), error));
       }
     } finally {
       initInProgress = false;
@@ -3335,6 +3648,18 @@ var reldb = {
   get tx() {
     return currentProvider?.tx ?? notInitializedTx;
   },
+  /** 迁移操作绑定当前实例，调用方只提供模块自己的步骤。 */
+  migrateSchema(module, steps, options) {
+    if (!currentProvider)
+      return Promise.resolve(notInitialized.result());
+    return migrateSchema(reldb, module, steps, options);
+  },
+  /** 列检查复用当前连接或显式传入的事务。 */
+  schemaColumns(table, sql) {
+    if (!currentProvider)
+      return Promise.resolve(notInitialized.result());
+    return schemaColumns(reldb, table, sql);
+  },
   /** 获取当前脱敏后的配置快照（未初始化时为 null） */
   get config() {
     if (!currentConfig)
@@ -3412,99 +3737,7 @@ var reldb = {
     return await closingPromise;
   }
 };
-async function schemaColumns(db, table, sql = db.sql) {
-  if (!/^[a-z][a-z0-9_]{0,62}$/.test(table))
-    return err(HaiCommonError.VALIDATION_ERROR, core.i18n.coreM("core_errorValidation"));
-  const type = db.config?.type;
-  const found = type === "sqlite" ? await sql.query(`PRAGMA table_info(${table})`) : await sql.query(`SELECT column_name AS name FROM information_schema.columns WHERE table_schema=${type === "mysql" ? "DATABASE()" : "current_schema()"} AND table_name=?`, [table]);
-  return found.success ? ok(found.data.map((row) => row.name)) : found;
-}
-async function migrateSchema(db, module, steps, options = {}) {
-  if (!db.isInitialized || !/^[a-z][a-z0-9-]{0,62}$/.test(module) || steps.some((step, index) => step.version !== index + 1))
-    return err(HaiCommonError.VALIDATION_ERROR, core.i18n.coreM("core_errorValidation"));
-  const table = "hai_schema_migrations";
-  const targetVersion = steps.length;
-  const failed = (cause) => err({ ...HaiCommonError.INIT_FAILED, message: core.i18n.coreM("core_runtimeStartFailed", { params: { module } }), ext: { module, phase: "migration" }, cause });
-  async function inspect(sql) {
-    const columns = await schemaColumns(db, table, sql);
-    if (!columns.success)
-      return failed(columns.error);
-    const row = columns.data.length ? await sql.get(`SELECT version FROM ${table} WHERE module=?`, [module]) : ok(null);
-    if (!row.success)
-      return failed(row.error);
-    const currentVersion = Number(row.data?.version ?? 0);
-    if (currentVersion > targetVersion)
-      return failed();
-    const changes = [];
-    for (const step of steps) {
-      const needed = await step.needed(sql);
-      if (!needed.success)
-        return failed(needed.error);
-      if (needed.data)
-        changes.push(step.name);
-    }
-    return ok({ module, currentVersion, targetVersion, changes, requiresExclusiveAccess: changes.length > 0 });
-  }
-  if (options.dryRun)
-    return inspect(db.sql);
-  const created = await db.sql.execute(`CREATE TABLE IF NOT EXISTS ${table} (module VARCHAR(64) PRIMARY KEY, version INTEGER NOT NULL)`);
-  if (!created.success)
-    return failed(created.error);
-  const seeded = await db.sql.execute(db.config?.type === "mysql" ? `INSERT IGNORE INTO ${table}(module,version) VALUES (?,0)` : `INSERT INTO ${table}(module,version) VALUES (?,0) ON CONFLICT(module) DO NOTHING`, [module]);
-  if (!seeded.success)
-    return failed(seeded.error);
-  const started = await db.tx.begin();
-  if (!started.success)
-    return failed(started.error);
-  const tx = started.data;
-  let mysqlLock = false;
-  let committed = false;
-  try {
-    if (db.config?.type === "mysql") {
-      const lock = await tx.get("SELECT GET_LOCK(?,30) AS acquired", [`hai-schema:${module}`]);
-      if (!lock.success || Number(lock.data?.acquired) !== 1)
-        return failed(lock.success ? new Error("Migration lock unavailable") : lock.error);
-      mysqlLock = true;
-    }
-    const locked = await tx.execute(`UPDATE ${table} SET version=version WHERE module=?`, [module]);
-    if (!locked.success)
-      return failed(locked.error);
-    const plan = await inspect(tx);
-    if (!plan.success)
-      return plan;
-    for (const step of steps) {
-      const needed = await step.needed(tx);
-      if (!needed.success)
-        return failed(needed.error);
-      if (needed.data) {
-        const applied = await step.apply(tx);
-        if (!applied.success)
-          return failed(applied.error);
-        const remaining = await step.needed(tx);
-        if (!remaining.success || remaining.data)
-          return failed(remaining.success ? new Error("Migration step did not converge") : remaining.error);
-      }
-    }
-    const recorded = await tx.execute(`UPDATE ${table} SET version=? WHERE module=?`, [targetVersion, module]);
-    if (!recorded.success)
-      return failed(recorded.error);
-    if (mysqlLock) {
-      await tx.get("SELECT RELEASE_LOCK(?)", [`hai-schema:${module}`]);
-      mysqlLock = false;
-    }
-    const result = await tx.commit();
-    committed = result.success;
-    return result.success ? plan : failed(result.error);
-  } catch (error) {
-    return failed(error);
-  } finally {
-    if (mysqlLock)
-      await tx.get("SELECT RELEASE_LOCK(?)", [`hai-schema:${module}`]);
-    if (!committed)
-      await tx.rollback();
-  }
-}
 
-export { BaseReldbCrudRepository, HaiReldbError, createJsonOps, escapeSqlString, migrateSchema, parseJsonPath, quoteIdentifier, reldb, schemaColumns, validateIdentifier, validateIdentifiers };
+export { BaseReldbCrudRepository, HaiReldbError, createJsonOps, escapeSqlString, parseJsonPath, quoteIdentifier, reldb, validateIdentifier, validateIdentifiers };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map