@aiao/rxdb-adapter-pglite 0.0.5 → 0.0.7

package/dist/PGliteClient.d.ts

@@ -1,6 +1,13 @@
+import { EventDispatcher } from '../packages/utils/src/index.ts';
 import { DescribeQueryResult, QueryOptions, Results, Transaction } from '@electric-sql/pglite';
-interface PGliteClientOptions {
-    store?: 'memory' | 'idb';
+import { PGliteChangeEvent, PGliteChangeType, PGliteClientOptions } from './pglite.interface.js';
+/**
+ * PGlite 客户端事件映射
+ */
+export interface PGliteClientEvents {
+    [PGliteChangeType.INSERT]: PGliteChangeEvent;
+    [PGliteChangeType.UPDATE]: PGliteChangeEvent;
+    [PGliteChangeType.DELETE]: PGliteChangeEvent;
 }
 export interface IPGliteClient {
     init(dbName: string, options: PGliteClientOptions): Promise<void>;
@@ -56,7 +63,7 @@ export interface IPGliteClient {
     disconnect(): Promise<void>;
     version(): Promise<string>;
 }
-export declare class PGliteClient implements IPGliteClient {
+export declare class PGliteClient extends EventDispatcher<PGliteClientEvents> implements IPGliteClient {
     #private;
     init(dbName: string, options: PGliteClientOptions): Promise<void>;
     sql<T>(sqlStrings: TemplateStringsArray, ...params: any[]): Promise<Results<T>>;
@@ -68,5 +75,4 @@ export declare class PGliteClient implements IPGliteClient {
     disconnect(): Promise<void>;
     version(): Promise<string>;
 }
-export {};
 //# sourceMappingURL=PGliteClient.d.ts.map

package/dist/PGliteClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PGliteClient.d.ts","sourceRoot":"","sources":["../src/PGliteClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAU,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGvG,UAAU,mBAAmB;IAC3B,KAAK,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE;;;;;;OAMG;IACH,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACrF;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnF;;;;OAIG;IACH,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEtE;;;;;;OAMG;IACH,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAElD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED,qBAAa,YAAa,YAAW,aAAa;;IAG1C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB;IAQvD,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAI/E,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAIpE,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAIpF,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIlF,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrE,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO;CAId"}
+{"version":3,"file":"PGliteClient.d.ts","sourceRoot":"","sources":["../src/PGliteClient.ts"],"names":[],"mappings":"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"}

package/dist/RxDBAdapterPGlite.d.ts

@@ -1,36 +1,191 @@
-import { EntityType, IRepository, IRxDBAdapter, RestoreEntityOptions, RxDB, RxDBAdapterLocalBase, TransactionFun } from '@aiao/rxdb';
-import { Observable } from 'rxjs';
-import { ADAPTER_NAME, PGliteOptions } from './pglite.interface.js';
+import { EntityType, IRepository, IRxDBAdapter, RestoreEntityOptions, RxDBMutationsMap, SwitchBranchOptions, SwitchVersionActions, RxDB, RxDBAdapterLocalBase, RxDBBranch, RxDBChange, TransactionFun } from '../packages/rxdb/src/index.ts';
+import { Results } from '@electric-sql/pglite';
+import { ADAPTER_NAME, PGliteClientOptions, PgliteTableColumn } from './pglite.interface.js';
+import { PGliteRepository } from './repository/PGliteRepository.js';
+/**
+ * RxDB PGlite 适配器
+ *
+ * 基于 PGlite（WebAssembly PostgreSQL）的本地存储适配器
+ * 提供完整的关系型数据库功能，包括：
+ * - 实体持久化和查询
+ * - 事务管理
+ * - 分支管理（用于多版本数据管理）
+ * - 变更历史追踪
+ */
 export declare class RxDBAdapterPGlite extends RxDBAdapterLocalBase implements IRxDBAdapter {
     #private;
     private readonly options;
+    /** 适配器名称 */
+    name: string;
     /**
-     * 数据库版本
+     * 构造函数
+     *
+     * @param rxdb - RxDB 实例
+     * @param options - PGlite 客户端配置选项
+     */
+    constructor(rxdb: RxDB, options: PGliteClientOptions);
+    mutations<T extends EntityType>(mutations: RxDBMutationsMap<T>): Promise<InstanceType<T>[]>;
+    mergeChanges(actions: SwitchVersionActions, localChanges?: Omit<RxDBChange, 'id'>[], disableTriggers?: boolean): Promise<void>;
+    getRxDBChangeSequence(): Promise<number>;
+    setRxDBChangeSequence(sequence: number): Promise<void>;
+    /**
+     * 批量删除实体
+     *
+     * @param entities - 要删除的实体数组
+     * @returns 已删除的实体数组
+     */
+    removeMany<T extends EntityType>(entities: InstanceType<T>[]): Promise<InstanceType<T>[]>;
+    /**
+     * 批量保存实体
+     *
+     * 将实体持久化到数据库：
+     * 1. 按实体类型分组（避免混合不同表的数据）
+     * 2. 为每个类型生成批量插入 SQL（使用 UPSERT）
+     * 3. 在事务中执行（如果尚未在事务中）
+     * 4. 更新实体状态标记
+     *
+     * @param entities - 要保存的实体数组
+     * @returns 已保存的实体数组
      */
-    version$: Observable<string>;
-    name: string;
-    constructor(rxdb: RxDB, options: PGliteOptions);
     saveMany<T extends EntityType>(entities: InstanceType<T>[]): Promise<InstanceType<T>[]>;
-    connect(): Observable<IRxDBAdapter>;
+    /**
+     * 连接到数据库
+     *
+     * @returns 适配器实例
+     */
+    connect(): Promise<IRxDBAdapter>;
+    /**
+     * 断开数据库连接
+     *
+     * 清理资源并发送销毁信号
+     */
     disconnect(): Promise<void>;
-    createBranch(branchId: string, fromChangeId?: number): Promise<void>;
-    switchBranch(branchId: string): Promise<void>;
-    restoreEntity<T extends EntityType>(entity: InstanceType<T>, options: RestoreEntityOptions): Promise<InstanceType<T>>;
     /**
-     * 获取版本
+     * 创建分支
+     *
+     * 分支用于管理数据的不同版本，类似 Git 分支：
+     * 1. 验证分支 ID 不存在
+     * 2. 确定源分支（从当前活跃分支或指定变更点）
+     * 3. 创建新分支记录
+     *
+     * @param branchId - 新分支 ID
+     * @param fromChangeId - 从指定变更 ID 创建分支（可选，默认从当前分支的最新状态）
+     * @throws {RxdbAdapterPGliteError} 分支 ID 已存在或源分支未找到
+     */
+    createBranch(branchId: string, fromChangeId?: number): Promise<InstanceType<typeof RxDBBranch>>;
+    switchBranch(_options: SwitchBranchOptions): Promise<void>;
+    /**
+     * 恢复实体到指定状态
+     *
+     * 从变更历史中恢复实体到指定的版本
+     *
+     * @param _entity - 要恢复的实体
+     * @param _options - 恢复选项
+     * @returns 恢复后的实体
+     * @throws {RxdbAdapterPGliteError} 此功能尚未实现
+     */
+    restoreEntity<T extends EntityType>(_entity: InstanceType<T>, _options: RestoreEntityOptions): Promise<InstanceType<T>>;
+    /**
+     * 获取 PostgreSQL 版本
+     *
+     * @returns PostgreSQL 版本字符串
      */
     version(): Promise<string>;
-    getRepository<T extends EntityType, RT extends IRepository<T>>(EntityType: EntityType): RT;
-    createTables<T extends EntityType>(entities: T[]): Promise<boolean>;
-    isTableExisted(EntityType: EntityType): Promise<boolean>;
+    /**
+     * 获取实体类型的仓库实例
+     *
+     * 根据实体元数据中的仓库类型创建相应的仓库实例：
+     * - Repository: 通用仓库
+     * - TreeRepository: 树形仓库（用于层级数据）
+     *
+     * 仓库实例会被缓存，避免重复创建
+     *
+     * @param entity - 实体类型
+     * @returns 仓库实例
+     * @throws {RxdbAdapterPGliteError} 不支持的仓库类型
+     */
+    getRepository<T extends EntityType, RT = IRepository<T>>(entity: T): RT;
+    /**
+     * 创建数据库表
+     *
+     * 分三阶段创建表结构：
+     * 1. 创建表和列（不含外键约束）
+     * 2. 添加外键约束
+     * 3. 创建触发器（用于变更追踪）
+     *
+     * 这样可以避免因表创建顺序导致的外键约束失败
+     *
+     * @param EntityTypes - 实体类型数组
+     * @param entities - 初始化数据（可选）
+     * @returns 是否成功创建
+     */
+    createTables<T extends EntityType>(EntityTypes: T[], entities?: InstanceType<T>[]): Promise<boolean>;
     /**
      * 判断表是否存在
-     * @param EntityType
+     *
+     * @param EntityType - 实体类型
+     * @returns 表是否存在
+     */
+    isTableExisted(EntityType: EntityType): Promise<boolean>;
+    /**
+     * 获取表的列信息
+     *
+     * @param EntityType - 实体类型
+     * @returns 列信息数组
+     */
+    getTableColumns<T extends EntityType>(EntityType: T): Promise<PgliteTableColumn[]>;
+    /**
+     * 获取本地分支仓库
+     *
+     * @returns 分支仓库实例
+     */
+    localRxDBBranch(): PGliteRepository<typeof RxDBBranch>;
+    /**
+     * 获取本地变更仓库
+     *
+     * @returns 变更仓库实例
+     */
+    localRxDBChange(): PGliteRepository<typeof RxDBChange>;
+    /**
+     * 执行事务
+     *
+     * 事务管理策略：
+     * - 使用手动 BEGIN/COMMIT/ROLLBACK 控制事务边界
+     * - 使用 SET CONSTRAINTS ALL DEFERRED 延迟外键约束检查到提交时
+     * - 动态重建触发器以注入 transactionId（与 SQLite 方案一致）
+     * - PostgreSQL 不允许在有 pending trigger events 时修改表结构，
+     *   因此无法使用列默认值方案，必须重建触发器
+     *
+     * @param transactionFun - 事务函数
+     * @param transactionLog - 是否启用事务日志（默认 true）
+     * @returns 事务函数的返回值
+     * @throws {RxdbAdapterPGliteError} 事务执行失败
+     */
+    transaction<T extends TransactionFun>(transactionFun: T, transactionLog?: boolean): Promise<Awaited<ReturnType<T>>>;
+    /**
+     * 执行 SQL 查询
+     *
+     * 查询执行策略：
+     * - 在事务中：直接在事务上下文中执行
+     * - 非事务中：加入队列按顺序执行，避免并发冲突
+     *
+     * @param sql - SQL 语句
+     * @param bindings - 参数绑定
+     * @returns 查询结果
+     */
+    query(sql: string, bindings?: any[]): Promise<Results<any>>;
+    /**
+     * 内部查询方法 (Public Alias)
+     * 供核心同步逻辑使用，绕过队列直接查询
      */
-    isTableExisted$<T extends EntityType>(EntityType: T): Observable<boolean>;
-    transaction(fun: TransactionFun): Promise<any>;
+    internalQuery(sql: string, params?: any[]): Promise<Results<any>>;
 }
-declare module '@aiao/rxdb' {
+/**
+ * 扩展 RxDBAdapters 接口
+ *
+ * 将 PGlite 适配器注册到 RxDB 适配器类型系统中
+ */
+declare module '../packages/rxdb/src/index.ts' {
     interface RxDBAdapters {
         [ADAPTER_NAME]: RxDBAdapterPGlite;
     }

package/dist/RxDBAdapterPGlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RxDBAdapterPGlite.d.ts","sourceRoot":"","sources":["../src/RxDBAdapterPGlite.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,IAAI,EACJ,oBAAoB,EACpB,cAAc,EAEf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAqD,MAAM,MAAM,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAIpE,qBAAa,iBAAkB,SAAQ,oBAAqB,YAAW,YAAY;;IAkB/E,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZ1B;;OAEG;IACH,QAAQ,qBAGN;IAEF,IAAI,EAAE,MAAM,CAAgB;gBAG1B,IAAI,EAAE,IAAI,EACO,OAAO,EAAE,aAAa;IAKzC,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAIhF,OAAO;IAId,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAG3B,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAGpE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,aAAa,CAAC,CAAC,SAAS,UAAU,EAChC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAG3B;;OAEG;IACI,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAIjC,aAAa,CAAC,CAAC,SAAS,UAAU,EAAE,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,GAAG,EAAE;IAI1F,YAAY,CAAC,CAAC,SAAS,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAa7D,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D;;;OAGG;IACI,eAAe,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC;IAWhF,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC;CAU/C;AAED,OAAO,QAAQ,YAAY,CAAC;IAC1B,UAAU,YAAY;QACpB,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC;KACnC;CACF"}
+{"version":3,"file":"RxDBAdapterPGlite.d.ts","sourceRoot":"","sources":["../src/RxDBAdapterPGlite.ts"],"names":[],"mappings":"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"}

package/dist/entity/delete_sql.d.ts

@@ -0,0 +1,13 @@
+import { EntityMetadata, EntityType } from '../../packages/rxdb/src/index.ts';
+/**
+ * Generate SQL for deleting a single entity
+ * @param metadata - Entity metadata
+ * @param entity - Entity instance to delete
+ * @returns SQL query and parameters for PostgreSQL
+ */
+declare const _default: <T extends EntityType>(metadata: EntityMetadata, entity: InstanceType<T>) => {
+    sql: string;
+    params: any[];
+};
+export default _default;
+//# sourceMappingURL=delete_sql.d.ts.map

package/dist/entity/delete_sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete_sql.d.ts","sourceRoot":"","sources":["../../src/entity/delete_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxD;;;;;GAKG;yBACa,CAAC,SAAS,UAAU,EAAE,UAAU,cAAc,EAAE,QAAQ,YAAY,CAAC,CAAC,CAAC;;;;AAAvF,wBAOE"}

package/dist/entity/deletes_sql.d.ts

@@ -0,0 +1,11 @@
+import { EntityMetadata, EntityType } from '../../packages/rxdb/src/index.ts';
+/**
+ * Generate SQL for deleting multiple entities
+ * Returns inline SQL for batch operations (no parameters)
+ * @param metadata - Entity metadata
+ * @param entities - Array of entity instances to delete
+ * @returns SQL query string
+ */
+declare const _default: <T extends EntityType>(metadata: EntityMetadata, entities: InstanceType<T>[]) => string;
+export default _default;
+//# sourceMappingURL=deletes_sql.d.ts.map

package/dist/entity/deletes_sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deletes_sql.d.ts","sourceRoot":"","sources":["../../src/entity/deletes_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxD;;;;;;GAMG;yBACa,CAAC,SAAS,UAAU,EAAE,UAAU,cAAc,EAAE,UAAU,YAAY,CAAC,CAAC,CAAC,EAAE;AAA3F,wBAIE"}

package/dist/entity/insert_sql.d.ts

@@ -0,0 +1,14 @@
+import { EntityMetadata, EntityType, IMutationContext } from '../../packages/rxdb/src/index.ts';
+/**
+ * Generate SQL for inserting a single entity
+ * @param metadata - Entity metadata
+ * @param entity - Entity instance to insert
+ * @param context - Optional mutation context for tracking user, etc.
+ * @returns SQL query and parameters for PostgreSQL
+ */
+declare const _default: <T extends EntityType>(metadata: EntityMetadata, entity: InstanceType<T>, context?: IMutationContext) => {
+    sql: string;
+    params: any[];
+};
+export default _default;
+//# sourceMappingURL=insert_sql.d.ts.map

package/dist/entity/insert_sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert_sql.d.ts","sourceRoot":"","sources":["../../src/entity/insert_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAW,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnF;;;;;;GAMG;yBACa,CAAC,SAAS,UAAU,EAClC,UAAU,cAAc,EACxB,QAAQ,YAAY,CAAC,CAAC,CAAC,EACvB,UAAU,gBAAgB;;;;AAH5B,wBA4CE"}

package/dist/entity/inserts_sql.d.ts

@@ -0,0 +1,12 @@
+import { EntityMetadata, EntityType, IQueryContext } from '../../packages/rxdb/src/index.ts';
+/**
+ * Generate SQL for inserting multiple entities in a single statement
+ * Returns inline SQL for batch operations (no parameters)
+ * @param metadata - Entity metadata
+ * @param entities - Array of entity instances to insert
+ * @param context - Optional query context for tracking user, etc.
+ * @returns SQL query string
+ */
+declare const _default: <T extends EntityType>(metadata: EntityMetadata, entities: InstanceType<T>[], context?: IQueryContext) => string;
+export default _default;
+//# sourceMappingURL=inserts_sql.d.ts.map

package/dist/entity/inserts_sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inserts_sql.d.ts","sourceRoot":"","sources":["../../src/entity/inserts_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAW,aAAa,EAAE,MAAM,YAAY,CAAC;AAQhF;;;;;;;GAOG;yBACa,CAAC,SAAS,UAAU,EAClC,UAAU,cAAc,EACxB,UAAU,YAAY,CAAC,CAAC,CAAC,EAAE,EAC3B,UAAU,aAAa;AAHzB,wBA8BE"}

package/dist/entity/update_sql.d.ts

@@ -0,0 +1,15 @@
+import { EntityMetadata, EntityType, IMutationContext } from '../../packages/rxdb/src/index.ts';
+/**
+ * Generate SQL for updating entity(ies)
+ * @param metadata - Entity metadata
+ * @param entityOrEntities - Single entity or array of entities to update
+ * @param patch - Partial entity data to update
+ * @param context - Optional mutation context
+ * @returns SQL query and parameters for PostgreSQL
+ */
+declare const generate_entity_update_sql: <T extends EntityType>(metadata: EntityMetadata, entityOrEntities: InstanceType<T> | InstanceType<T>[], patch: Partial<InstanceType<T>>, context?: IMutationContext) => {
+    sql: string;
+    params: unknown[];
+};
+export default generate_entity_update_sql;
+//# sourceMappingURL=update_sql.d.ts.map

package/dist/entity/update_sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update_sql.d.ts","sourceRoot":"","sources":["../../src/entity/update_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAW,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnF;;;;;;;GAOG;AACH,QAAA,MAAM,0BAA0B,GAAI,CAAC,SAAS,UAAU,EACtD,UAAU,cAAc,EACxB,kBAAkB,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,EACrD,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAC/B,UAAU,gBAAgB;;;CAkD3B,CAAC;AAEF,eAAe,0BAA0B,CAAC"}

package/dist/execute_helper.d.ts

@@ -0,0 +1,70 @@
+import { IPGliteClient } from './PGliteClient.js';
+/**
+ * SQL 执行结果
+ *
+ * 包含查询结果、受影响行数和执行时间
+ */
+export interface ExecuteResult<T = any> {
+    /** 查询结果行 */
+    rows: T[];
+    /** 受影响的行数 */
+    rowsAffected: number;
+    /** 执行耗时（毫秒） */
+    elapsed: number;
+}
+/**
+ * 统一的 SQL 执行辅助函数
+ *
+ * 提供以下功能：
+ * 1. **性能监控**：使用 `performance.now()` 精确测量查询执行时间
+ * 2. **错误转换**：捕获 PGlite 错误并转换为 `RxdbAdapterPGliteError`
+ * 3. **统一接口**：返回标准化的结果格式
+ *
+ * ## 使用示例
+ *
+ * ### 基础查询
+ * ```typescript
+ * const result = await execute_helper(client, 'SELECT * FROM users');
+ * console.log(result.rows);        // 查询结果
+ * console.log(result.rowsAffected); // 受影响行数
+ * console.log(result.elapsed);      // 执行时间（ms）
+ * ```
+ *
+ * ### 参数化查询
+ * ```typescript
+ * const result = await execute_helper(
+ *   client,
+ *   'SELECT * FROM users WHERE id = $1',
+ *   ['user-id']
+ * );
+ * ```
+ *
+ * ### 错误处理
+ * ```typescript
+ * try {
+ *   await execute_helper(client, 'INVALID SQL');
+ * } catch (error) {
+ *   if (error instanceof RxdbAdapterPGliteError) {
+ *     console.log(error.code);          // INVALID_SQL
+ *     console.log(error.originalError);  // 原始 PGlite 错误
+ *   }
+ * }
+ * ```
+ *
+ * ## 性能考虑
+ *
+ * - `performance.now()` 提供微秒级精度，开销极小
+ * - 错误转换只在异常路径触发，对正常查询无影响
+ * - 结果对象创建开销可忽略（< 0.1ms）
+ *
+ * @param client - PGlite 客户端实例
+ * @param sql - SQL 语句
+ * @param params - 可选的查询参数（使用 $1, $2 等占位符）
+ * @returns 包含 rows, rowsAffected, elapsed 的执行结果
+ * @throws {RxdbAdapterPGliteError} SQL 执行失败时抛出
+ *
+ * @see {@link IPGliteClient}
+ * @see {@link RxdbAdapterPGliteError}
+ */
+export declare function execute_helper<T = any>(client: IPGliteClient, sql: string, params?: any[]): Promise<ExecuteResult<T>>;
+//# sourceMappingURL=execute_helper.d.ts.map

package/dist/execute_helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute_helper.d.ts","sourceRoot":"","sources":["../src/execute_helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,GAAG;IACpC,YAAY;IACZ,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,aAAa;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAiBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,GAAG,EAC1C,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,GAAG,EAAE,GACb,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CA4B3B"}

package/dist/handle_rxdb_change.d.ts

@@ -0,0 +1,26 @@
+import { EntityType } from '../packages/rxdb/src/index.ts';
+import { PGliteChangeEvent } from './pglite.interface.js';
+import { RxDBAdapterPGlite } from './RxDBAdapterPGlite.js';
+/**
+ * 处理 PGlite 数据库变更事件
+ *
+ * 工作流程：
+ * 1. 解析表名获取 EntityType
+ * 2. 通过 `repository.findByRowIds()` 查询受影响的实体
+ * 3. 特殊处理 RxDBChange 表：
+ *    - 转换 patch/inversePatch 字段
+ *    - 触发被变更实体的事件
+ *    - 触发 RxDBChange 自身的 INSERT 事件
+ * 4. 普通表：直接触发实体事件
+ *
+ * @param adapter - PGlite 适配器实例
+ * @param event - PGlite NOTIFY 变更事件
+ *
+ * @remarks
+ * 此函数异步执行，错误会被捕获并记录到控制台。
+ *
+ * @see {@link PGliteChangeEvent}
+ * @see {@link RxDBChange}
+ */
+export declare const handle_rxdb_change: <T extends EntityType = any>(adapter: RxDBAdapterPGlite, event: PGliteChangeEvent) => void;
+//# sourceMappingURL=handle_rxdb_change.d.ts.map

package/dist/handle_rxdb_change.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle_rxdb_change.d.ts","sourceRoot":"","sources":["../src/handle_rxdb_change.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAIL,UAAU,EAMX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAoB,MAAM,uBAAuB,CAAC;AAG5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAoG3D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,UAAU,GAAG,GAAG,EAC3D,SAAS,iBAAiB,EAC1B,OAAO,iBAAiB,SA6GzB,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,11 @@
+export * from './pglite.interface.js';
+export * from './pglite.utils.js';
 export { RxdbAdapterPGliteError } from './pglite.utils.js';
+export * from './PGliteClient.js';
 export * from './RxDBAdapterPGlite.js';
+export * from './sql_dialect.js';
+export { create_tables_sql } from './table/create_tables_sql.js';
+export * from './table/notify_function_sql.js';
+export { remove_all_triggers_sql, remove_trigger_sql } from './table/remove_trigger_sql.js';
+export { generate_trigger_sql } from './table/trigger_sql.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}