@h-ai/reldb 0.1.0-alpha9 → 1.0.0-beta.2

package/dist/providers/sqlite/reldb-sqlite-worker.mjs

@@ -0,0 +1,143 @@
+/**
+ * @h-ai/reldb — SQLite worker 线程脚本
+ *
+ * 纯 JavaScript，供 worker_threads 直接加载（源码与打包运行位置均可）。
+ * 持有唯一 better-sqlite3 连接，按 FIFO 串行处理主线程消息，把同步查询的阻塞移出主线程事件循环。
+ *
+ * 消息协议：
+ *   主线程 → worker: { id, op: 'all'|'get'|'run'|'exec'|'batch'|'close', sql?, params?, statements? }
+ *   worker → 主线程: { id, ok, result } | { id, ok:false, error:{ message } } | { type:'ready'|'init-error' }
+ */
+
+import { createRequire } from 'node:module'
+import { setTimeout as delay } from 'node:timers/promises'
+import { parentPort, workerData } from 'node:worker_threads'
+
+const require = createRequire(import.meta.url)
+
+if (!parentPort) {
+  throw new Error('reldb sqlite worker must run inside a worker thread')
+}
+
+/** 归一化错误为可结构化克隆的对象。 */
+function serializeError(error) {
+  return { message: error instanceof Error ? error.message : String(error) }
+}
+
+/** 打开当前线程拥有的数据库连接；WAL 在初始化阶段单独配置。 */
+function openDatabase() {
+  const Database = require('better-sqlite3')
+  const database = new Database(workerData.database, { readonly: workerData.readonly ?? false })
+  return database
+}
+
+let db = null
+
+async function initialize() {
+  try {
+    db = openDatabase()
+    // 先保存连接，再执行可能失败的 pragma；初始化失败仍能由 close/线程终止释放。
+    if (workerData.walMode !== false) {
+      // 与同步引擎一致：WAL 锁升级可直接返回 BUSY，原生等待与退避共用 5 秒预算。
+      const deadline = performance.now() + 5000
+      let contention
+      try {
+        for (;;) {
+          if (contention && performance.now() >= deadline)
+            throw contention
+          db.pragma(`busy_timeout = ${Math.max(1, Math.ceil(deadline - performance.now()))}`)
+          try {
+            db.pragma('journal_mode = WAL')
+            break
+          }
+          catch (error) {
+            if (!error || typeof error !== 'object' || !('code' in error)
+              || typeof error.code !== 'string' || !/^SQLITE_BUSY(?:_|$)/.test(error.code)
+              || performance.now() >= deadline) {
+              throw error
+            }
+            contention = error
+            await delay(Math.min(25, Math.max(1, deadline - performance.now())))
+          }
+        }
+      }
+      finally {
+        db.pragma('busy_timeout = 5000')
+      }
+    }
+    parentPort.postMessage({ type: 'ready' })
+  }
+  catch (error) {
+    parentPort.postMessage({ type: 'init-error', error: serializeError(error) })
+  }
+
+  parentPort.on('message', (msg) => {
+    const { id, op, sql, params, statements } = msg
+
+    if (op === 'close') {
+      try {
+        db?.close()
+      }
+      catch {
+        // 忽略关闭异常，仍需回执并退出。
+      }
+      db = null
+      parentPort.postMessage({ id, ok: true, result: undefined })
+      parentPort.close()
+      return
+    }
+
+    try {
+      if (!db)
+        throw new Error('sqlite worker database is not open')
+
+      let result
+      switch (op) {
+        case 'all': {
+          const stmt = db.prepare(sql)
+          result = params ? stmt.all(...params) : stmt.all()
+          break
+        }
+        case 'get': {
+          const stmt = db.prepare(sql)
+          result = (params ? stmt.get(...params) : stmt.get()) ?? null
+          break
+        }
+        case 'run': {
+          const stmt = db.prepare(sql)
+          const runResult = params ? stmt.run(...params) : stmt.run()
+          result = { changes: runResult.changes, lastInsertRowid: runResult.lastInsertRowid }
+          break
+        }
+        case 'exec': {
+          db.exec(sql)
+          result = undefined
+          break
+        }
+        case 'batch': {
+          const database = db
+          const tx = database.transaction((items) => {
+            for (const item of items) {
+              const stmt = database.prepare(item.sql)
+              if (item.params)
+                stmt.run(...item.params)
+              else stmt.run()
+            }
+          })
+          tx(statements)
+          result = undefined
+          break
+        }
+        default:
+          throw new Error(`unknown sqlite worker op: ${op}`)
+      }
+
+      parentPort.postMessage({ id, ok: true, result })
+    }
+    catch (error) {
+      parentPort.postMessage({ id, ok: false, error: serializeError(error) })
+    }
+  })
+}
+
+void initialize()

package/dist/schemas.d.ts

@@ -0,0 +1,490 @@
+import { z } from 'zod';
+
+/**
+ * @h-ai/reldb — 数据库配置 Schema
+ *
+ * 本文件定义数据库模块的配置结构，使用 Zod 进行运行时校验。
+ * @module reldb-config
+ */
+
+/**
+ * 数据库类型枚举
+ *
+ * 支持的数据库类型：
+ * - `sqlite` - SQLite 嵌入式数据库（使用 better-sqlite3）
+ * - `postgresql` - PostgreSQL 数据库（使用 pg）
+ * - `mysql` - MySQL 数据库（使用 mysql2）
+ * @example
+ * ```ts
+ * import { ReldbTypeSchema } from '@h-ai/reldb/schemas'
+ *
+ * const value = ReldbTypeSchema.parse('postgresql')
+ * void value
+ * ```
+ */
+declare const ReldbTypeSchema: z.ZodEnum<{
+    sqlite: "sqlite";
+    postgresql: "postgresql";
+    mysql: "mysql";
+}>;
+/**
+ * 数据库类型
+ * @example
+ * ```ts
+ * import type { DbType } from '@h-ai/reldb/schemas'
+ *
+ * const value: DbType = 'postgresql'
+ * void value
+ * ```
+ */
+type DbType = z.infer<typeof ReldbTypeSchema>;
+/**
+ * ReldbOperationLogConfigSchema 的数据约束与操作契约。
+ * @example
+ * ```ts
+ * import { ReldbOperationLogConfigSchema } from '@h-ai/reldb/schemas'
+ *
+ * const value = ReldbOperationLogConfigSchema.parse({ read: false, write: true, maxLength: 100, level: 'debug' })
+ * void value
+ * ```
+ */
+declare const ReldbOperationLogConfigSchema: z.ZodObject<{
+    read: z.ZodDefault<z.ZodBoolean>;
+    write: z.ZodDefault<z.ZodBoolean>;
+    maxLength: z.ZodDefault<z.ZodNumber>;
+    level: z.ZodDefault<z.ZodEnum<{
+        info: "info";
+        debug: "debug";
+        trace: "trace";
+    }>>;
+}, z.core.$strip>;
+/**
+ * ReldbOperationLogConfig 的数据约束与操作契约。
+ * @example
+ * ```ts
+ * import { ReldbOperationLogConfigSchema, type ReldbOperationLogConfig } from '@h-ai/reldb/schemas'
+ *
+ * const value: ReldbOperationLogConfig = ReldbOperationLogConfigSchema.parse({ read: false, write: true, maxLength: 100, level: 'debug' })
+ * void value
+ * ```
+ */
+type ReldbOperationLogConfig = z.infer<typeof ReldbOperationLogConfigSchema>;
+/**
+ * PostgreSQL 连接池配置 Schema
+ *
+ * min 是已建立连接的保留下限，不主动预建连接。
+ * MySQL 使用独立的 MysqlPoolConfigSchema；SQLite 不使用连接池。
+ * @example
+ * ```ts
+ * import { PoolConfigSchema } from '@h-ai/reldb/schemas'
+ *
+ * const value = PoolConfigSchema.parse({ max: 10, acquireTimeout: 5000 })
+ * void value
+ * ```
+ */
+declare const PoolConfigSchema: z.ZodObject<{
+    min: z.ZodDefault<z.ZodNumber>;
+    max: z.ZodDefault<z.ZodNumber>;
+    idleTimeout: z.ZodDefault<z.ZodNumber>;
+    acquireTimeout: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * PostgreSQL 连接池配置类型。
+ * @example
+ * ```ts
+ * import { PoolConfigSchema, type PoolConfig } from '@h-ai/reldb/schemas'
+ *
+ * const value: PoolConfig = PoolConfigSchema.parse({ max: 10, acquireTimeout: 5000 })
+ * void value
+ * ```
+ */
+type PoolConfig = z.infer<typeof PoolConfigSchema>;
+/**
+ * MySQL 连接池配置：有界 FIFO 等待，拒绝没有可靠驱动语义的 min/idleTimeout。
+ *
+ * acquireTimeout 覆盖排队和建立连接，不是 SQL 执行时限。驱动建连也使用此值作为 connectTimeout。
+ * 空闲连接由 mysql2/服务端管理；本模块不承诺最小保留数或可配置的空闲回收期限。
+ * @example
+ * ```ts
+ * import { MysqlPoolConfigSchema } from '@h-ai/reldb/schemas'
+ *
+ * const value = MysqlPoolConfigSchema.parse({ max: 10, acquireTimeout: 5000, queueLimit: 100 })
+ * void value
+ * ```
+ */
+declare const MysqlPoolConfigSchema: z.ZodObject<{
+    max: z.ZodDefault<z.ZodNumber>;
+    acquireTimeout: z.ZodDefault<z.ZodNumber>;
+    queueLimit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+/**
+ * MySQL 解析后的连接池配置。
+ * @example
+ * ```ts
+ * import { MysqlPoolConfigSchema, type MysqlPoolConfig } from '@h-ai/reldb/schemas'
+ *
+ * const value: MysqlPoolConfig = MysqlPoolConfigSchema.parse({ max: 10, acquireTimeout: 5000, queueLimit: 100 })
+ * void value
+ * ```
+ */
+type MysqlPoolConfig = z.infer<typeof MysqlPoolConfigSchema>;
+/**
+ * PostgreSQL SSL 配置 Schema
+ *
+ * 支持多种配置方式：
+ * - `true/false` - 简单开关
+ * - `'require'/'prefer'/'allow'/'disable'` - SSL 模式
+ * - 自定义对象 - 详细 SSL 配置
+ * @example
+ * ```ts
+ * import { SslConfigSchema } from '@h-ai/reldb/schemas'
+ *
+ * const value = SslConfigSchema.parse({ rejectUnauthorized: true })
+ * void value
+ * ```
+ */
+declare const SslConfigSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    require: "require";
+    prefer: "prefer";
+    allow: "allow";
+    disable: "disable";
+}>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+/**
+ * PostgreSQL SSL 配置类型
+ * @example
+ * ```ts
+ * import { SslConfigSchema, type SslConfig } from '@h-ai/reldb/schemas'
+ *
+ * const value: SslConfig = SslConfigSchema.parse({ rejectUnauthorized: true })
+ * void value
+ * ```
+ */
+type SslConfig = z.infer<typeof SslConfigSchema>;
+/**
+ * MySQL TLS 配置；空对象默认校验证书链和 DNS 主机身份，只接收明确支持的 PEM 字段。
+ *
+ * cert/key 必须成对。verifyIdentity 在当前驱动仅支持 DNS 主机，不能宣称验证 IP 身份。
+ * 显式关闭验证会记录风险日志；本模块不提供任意 TLS 参数或回调透传。
+ * @example
+ * ```ts
+ * import { MysqlSslConfigSchema } from '@h-ai/reldb/schemas'
+ *
+ * const value = MysqlSslConfigSchema.parse({ rejectUnauthorized: true, verifyIdentity: true })
+ * void value
+ * ```
+ */
+declare const MysqlSslConfigSchema: z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
+    rejectUnauthorized: z.ZodDefault<z.ZodBoolean>;
+    verifyIdentity: z.ZodDefault<z.ZodBoolean>;
+    ca: z.ZodOptional<z.ZodString>;
+    cert: z.ZodOptional<z.ZodString>;
+    key: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>]>;
+/**
+ * SQLite 特定选项 Schema
+ * @example
+ * ```ts
+ * import { SqliteOptionsSchema } from '@h-ai/reldb/schemas'
+ *
+ * const value = SqliteOptionsSchema.parse({ walMode: true, executor: 'worker' })
+ * void value
+ * ```
+ */
+declare const SqliteOptionsSchema: z.ZodObject<{
+    walMode: z.ZodDefault<z.ZodBoolean>;
+    readonly: z.ZodDefault<z.ZodBoolean>;
+    executor: z.ZodDefault<z.ZodEnum<{
+        sync: "sync";
+        worker: "worker";
+    }>>;
+    workerConnectTimeoutMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * MySQL 特定选项 Schema
+ * @example
+ * ```ts
+ * import { MysqlOptionsSchema } from '@h-ai/reldb/schemas'
+ *
+ * const value = MysqlOptionsSchema.parse({ charset: 'utf8mb4' })
+ * void value
+ * ```
+ */
+declare const MysqlOptionsSchema: z.ZodObject<{
+    charset: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * SQLite 配置 Schema
+ * @example
+ * ```ts
+ * import { SqliteConfigSchema } from '@h-ai/reldb/schemas'
+ *
+ * const value = SqliteConfigSchema.parse({ type: 'sqlite', database: './data/app.db' })
+ * void value
+ * ```
+ */
+declare const SqliteConfigSchema: z.ZodObject<{
+    operationLog: z.ZodOptional<z.ZodObject<{
+        read: z.ZodDefault<z.ZodBoolean>;
+        write: z.ZodDefault<z.ZodBoolean>;
+        maxLength: z.ZodDefault<z.ZodNumber>;
+        level: z.ZodDefault<z.ZodEnum<{
+            info: "info";
+            debug: "debug";
+            trace: "trace";
+        }>>;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"sqlite">;
+    database: z.ZodString;
+    sqlite: z.ZodOptional<z.ZodObject<{
+        walMode: z.ZodDefault<z.ZodBoolean>;
+        readonly: z.ZodDefault<z.ZodBoolean>;
+        executor: z.ZodDefault<z.ZodEnum<{
+            sync: "sync";
+            worker: "worker";
+        }>>;
+        workerConnectTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * PostgreSQL 配置 Schema
+ * @example
+ * ```ts
+ * import { PostgresqlConfigSchema } from '@h-ai/reldb/schemas'
+ *
+ * const value = PostgresqlConfigSchema.parse({ type: 'postgresql', database: 'app', host: 'db', pool: { max: 10 } })
+ * void value
+ * ```
+ */
+declare const PostgresqlConfigSchema: z.ZodObject<{
+    url: z.ZodOptional<z.ZodString>;
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodOptional<z.ZodNumber>;
+    database: z.ZodString;
+    user: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+    ssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        require: "require";
+        prefer: "prefer";
+        allow: "allow";
+        disable: "disable";
+    }>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+    pool: z.ZodOptional<z.ZodObject<{
+        min: z.ZodDefault<z.ZodNumber>;
+        max: z.ZodDefault<z.ZodNumber>;
+        idleTimeout: z.ZodDefault<z.ZodNumber>;
+        acquireTimeout: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    operationLog: z.ZodOptional<z.ZodObject<{
+        read: z.ZodDefault<z.ZodBoolean>;
+        write: z.ZodDefault<z.ZodBoolean>;
+        maxLength: z.ZodDefault<z.ZodNumber>;
+        level: z.ZodDefault<z.ZodEnum<{
+            info: "info";
+            debug: "debug";
+            trace: "trace";
+        }>>;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"postgresql">;
+}, z.core.$strip>;
+/**
+ * MySQL 配置 Schema
+ * @example
+ * ```ts
+ * import { MysqlConfigSchema } from '@h-ai/reldb/schemas'
+ *
+ * const value = MysqlConfigSchema.parse({ type: 'mysql', database: 'app', host: 'db', pool: { max: 10, queueLimit: 100 } })
+ * void value
+ * ```
+ */
+declare const MysqlConfigSchema: z.ZodObject<{
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodOptional<z.ZodNumber>;
+    user: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+    operationLog: z.ZodOptional<z.ZodObject<{
+        read: z.ZodDefault<z.ZodBoolean>;
+        write: z.ZodDefault<z.ZodBoolean>;
+        maxLength: z.ZodDefault<z.ZodNumber>;
+        level: z.ZodDefault<z.ZodEnum<{
+            info: "info";
+            debug: "debug";
+            trace: "trace";
+        }>>;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"mysql">;
+    url: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodLiteral<"">, z.ZodTransform<undefined, "">>, z.ZodURL]>>;
+    database: z.ZodOptional<z.ZodString>;
+    ssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
+        rejectUnauthorized: z.ZodDefault<z.ZodBoolean>;
+        verifyIdentity: z.ZodDefault<z.ZodBoolean>;
+        ca: z.ZodOptional<z.ZodString>;
+        cert: z.ZodOptional<z.ZodString>;
+        key: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>;
+    pool: z.ZodOptional<z.ZodObject<{
+        max: z.ZodDefault<z.ZodNumber>;
+        acquireTimeout: z.ZodDefault<z.ZodNumber>;
+        queueLimit: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    mysql: z.ZodOptional<z.ZodObject<{
+        charset: z.ZodDefault<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+/**
+ * 统一数据库配置 Schema（判别联合体）
+ *
+ * 根据 `type` 字段区分不同数据库类型的配置。
+ * @example
+ * ```ts
+ * import { ReldbConfigSchema } from '@h-ai/reldb/schemas'
+ *
+ * const value = ReldbConfigSchema.parse({ type: 'postgresql', database: 'app', host: 'db' })
+ * void value
+ * ```
+ */
+declare const ReldbConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    operationLog: z.ZodOptional<z.ZodObject<{
+        read: z.ZodDefault<z.ZodBoolean>;
+        write: z.ZodDefault<z.ZodBoolean>;
+        maxLength: z.ZodDefault<z.ZodNumber>;
+        level: z.ZodDefault<z.ZodEnum<{
+            info: "info";
+            debug: "debug";
+            trace: "trace";
+        }>>;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"sqlite">;
+    database: z.ZodString;
+    sqlite: z.ZodOptional<z.ZodObject<{
+        walMode: z.ZodDefault<z.ZodBoolean>;
+        readonly: z.ZodDefault<z.ZodBoolean>;
+        executor: z.ZodDefault<z.ZodEnum<{
+            sync: "sync";
+            worker: "worker";
+        }>>;
+        workerConnectTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    url: z.ZodOptional<z.ZodString>;
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodOptional<z.ZodNumber>;
+    database: z.ZodString;
+    user: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+    ssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        require: "require";
+        prefer: "prefer";
+        allow: "allow";
+        disable: "disable";
+    }>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+    pool: z.ZodOptional<z.ZodObject<{
+        min: z.ZodDefault<z.ZodNumber>;
+        max: z.ZodDefault<z.ZodNumber>;
+        idleTimeout: z.ZodDefault<z.ZodNumber>;
+        acquireTimeout: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    operationLog: z.ZodOptional<z.ZodObject<{
+        read: z.ZodDefault<z.ZodBoolean>;
+        write: z.ZodDefault<z.ZodBoolean>;
+        maxLength: z.ZodDefault<z.ZodNumber>;
+        level: z.ZodDefault<z.ZodEnum<{
+            info: "info";
+            debug: "debug";
+            trace: "trace";
+        }>>;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"postgresql">;
+}, z.core.$strip>, z.ZodObject<{
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodOptional<z.ZodNumber>;
+    user: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+    operationLog: z.ZodOptional<z.ZodObject<{
+        read: z.ZodDefault<z.ZodBoolean>;
+        write: z.ZodDefault<z.ZodBoolean>;
+        maxLength: z.ZodDefault<z.ZodNumber>;
+        level: z.ZodDefault<z.ZodEnum<{
+            info: "info";
+            debug: "debug";
+            trace: "trace";
+        }>>;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"mysql">;
+    url: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodLiteral<"">, z.ZodTransform<undefined, "">>, z.ZodURL]>>;
+    database: z.ZodOptional<z.ZodString>;
+    ssl: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
+        rejectUnauthorized: z.ZodDefault<z.ZodBoolean>;
+        verifyIdentity: z.ZodDefault<z.ZodBoolean>;
+        ca: z.ZodOptional<z.ZodString>;
+        cert: z.ZodOptional<z.ZodString>;
+        key: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>;
+    pool: z.ZodOptional<z.ZodObject<{
+        max: z.ZodDefault<z.ZodNumber>;
+        acquireTimeout: z.ZodDefault<z.ZodNumber>;
+        queueLimit: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    mysql: z.ZodOptional<z.ZodObject<{
+        charset: z.ZodDefault<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strip>], "type">;
+/**
+ * 数据库配置类型（判别联合体）
+ * @example
+ * ```ts
+ * import { ReldbConfigSchema, type ReldbConfig } from '@h-ai/reldb/schemas'
+ *
+ * const value: ReldbConfig = ReldbConfigSchema.parse({ type: 'postgresql', database: 'app', host: 'db' })
+ * void value
+ * ```
+ */
+type ReldbConfig = z.infer<typeof ReldbConfigSchema>;
+/**
+ * SQLite 配置类型
+ * @example
+ * ```ts
+ * import { SqliteConfigSchema, type SqliteConfig } from '@h-ai/reldb/schemas'
+ *
+ * const value: SqliteConfig = SqliteConfigSchema.parse({ type: 'sqlite', database: './data/app.db' })
+ * void value
+ * ```
+ */
+type SqliteConfig = z.infer<typeof SqliteConfigSchema>;
+/**
+ * PostgreSQL 配置类型
+ * @example
+ * ```ts
+ * import { PostgresqlConfigSchema, type PostgresqlConfig } from '@h-ai/reldb/schemas'
+ *
+ * const value: PostgresqlConfig = PostgresqlConfigSchema.parse({ type: 'postgresql', database: 'app', host: 'db', pool: { max: 10 } })
+ * void value
+ * ```
+ */
+type PostgresqlConfig = z.infer<typeof PostgresqlConfigSchema>;
+/**
+ * MySQL 配置类型
+ * @example
+ * ```ts
+ * import { MysqlConfigSchema, type MysqlConfig } from '@h-ai/reldb/schemas'
+ *
+ * const value: MysqlConfig = MysqlConfigSchema.parse({ type: 'mysql', database: 'app', host: 'db', pool: { max: 10, queueLimit: 100 } })
+ * void value
+ * ```
+ */
+type MysqlConfig = z.infer<typeof MysqlConfigSchema>;
+/**
+ * 数据库配置输入类型（用于 init 等入口）
+ *
+ * 说明：Zod 的 default 会让输入端字段可省略，但输出端字段为必填。
+ * 因此对外 API（如 reldb.init）更适合接收 ReldbConfigInput。
+ * @example
+ * ```ts
+ * import type { ReldbConfigInput } from '@h-ai/reldb/schemas'
+ *
+ * const value: ReldbConfigInput = { type: 'postgresql', host: 'db', database: 'app' }
+ * void value
+ * ```
+ */
+type ReldbConfigInput = z.input<typeof ReldbConfigSchema>;
+
+export { type DbType, type MysqlConfig, MysqlConfigSchema, MysqlOptionsSchema, type MysqlPoolConfig, MysqlPoolConfigSchema, MysqlSslConfigSchema, type PoolConfig, PoolConfigSchema, type PostgresqlConfig, PostgresqlConfigSchema, type ReldbConfig, type ReldbConfigInput, ReldbConfigSchema, type ReldbOperationLogConfig, ReldbOperationLogConfigSchema, ReldbTypeSchema, type SqliteConfig, SqliteConfigSchema, SqliteOptionsSchema, type SslConfig, SslConfigSchema };

package/dist/schemas.js

@@ -0,0 +1,3 @@
+export { MysqlConfigSchema, MysqlOptionsSchema, MysqlPoolConfigSchema, MysqlSslConfigSchema, PoolConfigSchema, PostgresqlConfigSchema, ReldbConfigSchema, ReldbOperationLogConfigSchema, ReldbTypeSchema, SqliteConfigSchema, SqliteOptionsSchema, SslConfigSchema } from './chunk-SDS2ZT3V.js';
+//# sourceMappingURL=schemas.js.map
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"schemas.js"}