@h-ai/reldb 0.1.0-alpha.32 → 0.1.0-alpha.34

package/README.md

@@ -303,6 +303,10 @@ class UserRepository extends BaseReldbCrudRepository<UserRow> {
 
   /** 自定义方法中使用 this.sql(tx) 自动路由到事务 */
   async insertRaw(data: { name: string, email: string }, tx?: DmlWithTxOperations) {
+    // 自定义原始写操作应先确保表已就绪（避免刚建库/建表较慢时的竞态）
+    const ready = await this.ensureReady()
+    if (!ready.success)
+      return ready
     const now = Date.now()
     return this.sql(tx).execute(
       'INSERT INTO users (name, email, created_at, updated_at) VALUES (?, ?, ?, ?)',

package/dist/index.d.ts

@@ -1310,11 +1310,15 @@ declare abstract class BaseReldbCrudRepository<TItem> implements ReldbCrudReposi
      */
     private buildUpdatePayload;
     /**
-     * 等待初始化完成
+     * 等待初始化完成（自动建表等）
+     *
+     * 内置 CRUD 方法均已在执行前调用；自定义方法若通过 `this.sql()` 直接执行原始
+     * SQL（尤其是写操作或在事务中），应先 `await this.ensureReady()` 以避免表尚未
+     * 建好时（例如刚 dropTable 后、或后端建表较慢时）产生「表不存在」的竞态失败。
      *
      * @returns 初始化结果
      */
-    private ensureReady;
+    protected ensureReady(): Promise<HaiResult<void>>;
     /**
      * 创建单条记录
      *

package/dist/index.js

@@ -490,7 +490,11 @@ var BaseReldbCrudRepository = class {
     return payload;
   }
   /**
-   * 等待初始化完成
+   * 等待初始化完成（自动建表等）
+   *
+   * 内置 CRUD 方法均已在执行前调用；自定义方法若通过 `this.sql()` 直接执行原始
+   * SQL（尤其是写操作或在事务中），应先 `await this.ensureReady()` 以避免表尚未
+   * 建好时（例如刚 dropTable 后、或后端建表较慢时）产生「表不存在」的竞态失败。
    *
    * @returns 初始化结果
    */