@h-ai/reldb 0.1.0-alpha.68 → 0.1.0-alpha.70

package/README.en.md

@@ -588,7 +588,7 @@ Common error codes:
 | `HaiReldbError.TIMEOUT`              | `hai:reldb:009` | MySQL acquisition deadline exceeded |
 | `HaiReldbError.POOL_EXHAUSTED`       | `hai:reldb:011` | MySQL acquisition queue is full     |
 
-Custom SQL methods in `BaseReldbCrudRepository` subclasses must check `await this.ensureReady()`. Construction starts table creation; service init must await candidate readiness before publication. PostgreSQL concurrent first `CREATE TABLE IF NOT EXISTS` retries the same DDL once only for `23505/pg_type_typname_nsp_index` catalog contention; other errors remain failures.
+Custom SQL methods in `BaseReldbCrudRepository` subclasses must check `await this.ensureReady()`. Construction starts table creation; service init must await candidate readiness before publication. PostgreSQL retries a single autocommit `CREATE TABLE/INDEX IF NOT EXISTS` once only for `23505/pg_class_relname_nsp_index` catalog contention (also `pg_type_typname_nsp_index` for tables), or a table row-type race reported as `42710` with server routine `heap_create_with_catalog` / `TypeCreate`, consistently through DDL and SQL entry points. A failed retry remains an error. Transactions, business uniqueness errors and other failures are not retried. Initial connection probing attempts temporary DNS `EAI_AGAIN` failures at most three times, with 250/500 ms delays; business SQL is never replayed.
 
 ## Production shared state
 

package/README.ja.md

@@ -588,7 +588,7 @@ if (!result.success) {
 | `HaiReldbError.TIMEOUT`              | `hai:reldb:009` | MySQL 接続取得の期限超過   |
 | `HaiReldbError.POOL_EXHAUSTED`       | `hai:reldb:011` | MySQL 接続待機キューが満杯 |
 
-`BaseReldbCrudRepository` の派生クラスで独自 SQL を実行する前に `await this.ensureReady()` を確認します。構築時に建表を開始するだけなので、サービス init は候補の準備完了後に公開します。PostgreSQL の並行初回 `CREATE TABLE IF NOT EXISTS` は `23505/pg_type_typname_nsp_index` の競合だけ同じ DDL を一度再実行し、他のエラーは失敗のままです。
+`BaseReldbCrudRepository` の派生クラスで独自 SQL を実行する前に `await this.ensureReady()` を確認します。構築時に建表を開始するだけなので、サービス init は候補の準備完了後に公開します。PostgreSQL の自動コミットによる単一の `CREATE TABLE/INDEX IF NOT EXISTS` は、`23505/pg_class_relname_nsp_index`（建表は `pg_type_typname_nsp_index` も対象）の競合、または建表時にサーバー routine が `heap_create_with_catalog` / `TypeCreate` である `42710` の行型競合に限り、DDL/SQL の両入口で一度だけ再実行します。再試行も失敗した場合はエラーを返します。トランザクション、業務の一意制約、その他の失敗は再試行しません。初期接続確認の一時 DNS エラー `EAI_AGAIN` は 250/500 ms 間隔で最大三回試行し、業務 SQL は再送しません。
 
 ## 本番の共有状態
 

package/README.md

@@ -588,7 +588,7 @@ if (!result.success) {
 | `HaiReldbError.TIMEOUT`              | `hai:reldb:009` | MySQL 连接获取超过截止期限 |
 | `HaiReldbError.POOL_EXHAUSTED`       | `hai:reldb:011` | MySQL 连接等待队列已满     |
 
-派生 `BaseReldbCrudRepository` 的自定义 SQL 方法先检查 `await this.ensureReady()`；构造函数启动自动建表不等于仓库就绪，服务 init 必须等待候选仓库的就绪入口再发布。PostgreSQL 并发首次 `CREATE TABLE IF NOT EXISTS` 的 `23505/pg_type_typname_nsp_index` 目录冲突仅重执行相同 DDL 一次，其他错误继续失败。
+派生 `BaseReldbCrudRepository` 的自定义 SQL 方法先检查 `await this.ensureReady()`；构造函数启动自动建表不等于仓库就绪，服务 init 必须等待候选仓库的就绪入口再发布。PostgreSQL 自动提交的单条 `CREATE TABLE/INDEX IF NOT EXISTS` 仅对 `23505/pg_class_relname_nsp_index`（建表还包括 `pg_type_typname_nsp_index`）目录竞争，或建表时 `42710` 且服务端 routine 为 `heap_create_with_catalog` / `TypeCreate` 的行类型竞争重执行一次；重试仍失败则保留错误，DDL 与 SQL 入口一致；事务、业务唯一约束及其他错误不自动重试。初始化连接探测仅对临时 DNS 错误 `EAI_AGAIN` 最多尝试三次，间隔 250/500 ms；不重放业务 SQL。
 
 ## 生产共享状态
 

package/dist/index.js

@@ -5,8 +5,8 @@ import process from 'process';
 import { createRequire } from 'module';
 import { isIP } from 'net';
 import { performance as performance$1 } from 'perf_hooks';
-import { existsSync } from 'fs';
 import { setTimeout as setTimeout$1 } from 'timers/promises';
+import { existsSync } from 'fs';
 import { Worker } from 'worker_threads';
 
 // messages/en-US.json
@@ -2436,18 +2436,23 @@ function createPostgresProvider() {
     const result = await queryFn(convertPlaceholders(sql), params);
     return result.rows;
   }
+  async function executeStatement(sql, params) {
+    try {
+      return await pool.query(sql, params);
+    } catch (error) {
+      const kind = /^\s*CREATE\s+(TABLE|(?:UNIQUE\s+)?INDEX)\s+IF\s+NOT\s+EXISTS\s+/i.exec(sql)?.[1]?.toUpperCase();
+      const single = !sql.trim().replace(/;$/, "").includes(";");
+      const catalogConflict = typeof error === "object" && error !== null && "code" in error && (error.code === "23505" && "schema" in error && error.schema === "pg_catalog" && "constraint" in error && (error.constraint === "pg_class_relname_nsp_index" || kind === "TABLE" && error.constraint === "pg_type_typname_nsp_index") || kind === "TABLE" && error.code === "42710" && "routine" in error && (error.routine === "heap_create_with_catalog" || error.routine === "TypeCreate"));
+      if (!kind || !single || !catalogConflict)
+        throw error;
+      return pool.query(sql, params);
+    }
+  }
   const rawDdl = {
     async createTable(name, columns, ifNotExists = true) {
       const quotedTable = quoteIdentifier(name);
       const sql = buildDefaultCreateTableSql(pgBuildColumnSql, quotedTable, columns, ifNotExists);
-      try {
-        await pool.query(sql);
-      } catch (error) {
-        if (!ifNotExists || typeof error !== "object" || error === null || !("code" in error) || error.code !== "23505" || !("constraint" in error) || error.constraint !== "pg_type_typname_nsp_index") {
-          throw error;
-        }
-        await pool.query(sql);
-      }
+      await executeStatement(sql);
       return ok(void 0);
     },
     async dropTable(name, ifExists) {
@@ -2470,7 +2475,7 @@ function createPostgresProvider() {
     },
     async createIndex(table, index, def) {
       const sql = buildDefaultCreateIndexSql(quoteIdentifier, quoteIdentifier(table), quoteIdentifier(index), def);
-      await pool.query(sql);
+      await executeStatement(sql);
       return ok(void 0);
     },
     async dropIndex(index, ifExists = true) {
@@ -2479,7 +2484,7 @@ function createPostgresProvider() {
       return ok(void 0);
     },
     async raw(sql) {
-      await pool.query(sql);
+      await executeStatement(sql);
       return ok(void 0);
     }
   };
@@ -2493,7 +2498,7 @@ function createPostgresProvider() {
       return ok(rows[0] ?? null);
     },
     async execute(sql, params) {
-      const result = await pool.query(convertPlaceholders(sql), params);
+      const result = await executeStatement(convertPlaceholders(sql), params);
       return ok({ changes: result.rowCount ?? 0 });
     },
     async batch(statements) {
@@ -2627,7 +2632,16 @@ function createPostgresProvider() {
             name: error instanceof Error ? "Error" : "UnknownError"
           });
         });
-        await pool.query("SELECT 1");
+        for (let attempt = 0; ; attempt++) {
+          try {
+            await pool.query("SELECT 1");
+            break;
+          } catch (error) {
+            if (attempt >= 2 || typeof error !== "object" || error === null || !("code" in error) || error.code !== "EAI_AGAIN")
+              throw error;
+            await setTimeout$1(250 * (attempt + 1));
+          }
+        }
         ready = true;
         currentConfig2 = config;
         logger3.info("Connected to PostgreSQL", { host: config.host, port: config.port, database: config.database });