@aiao/rxdb-adapter-pglite 0.0.6 → 0.0.7

package/dist/PGliteClient.d.ts

@@ -1,5 +1,14 @@
+import { EventDispatcher } from '../packages/utils/src/index.ts';
 import { DescribeQueryResult, QueryOptions, Results, Transaction } from '@electric-sql/pglite';
-import { PGliteClientOptions } from './pglite.interface.js';
+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>;
     /**
@@ -54,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>>;

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;AAEvG,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;;;;;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;IAErF;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhF;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAErE;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEnF;;;;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;IAYvD,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;IAI3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,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,6 +1,7 @@
-import { EntityType, IRepository, IRxDBAdapter, RestoreEntityOptions, RxDBBranchRepository, RxDBChangeRepository, RxDB, RxDBAdapterLocalBase, TransactionFun } from '../packages/rxdb/src/index.ts';
+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 适配器
  *
@@ -23,6 +24,10 @@ export declare class RxDBAdapterPGlite extends RxDBAdapterLocalBase implements I
      * @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>;
     /**
      * 批量删除实体
      *
@@ -67,19 +72,8 @@ export declare class RxDBAdapterPGlite extends RxDBAdapterLocalBase implements I
      * @param fromChangeId - 从指定变更 ID 创建分支（可选，默认从当前分支的最新状态）
      * @throws {RxdbAdapterPGliteError} 分支 ID 已存在或源分支未找到
      */
-    createBranch(branchId: string, fromChangeId?: number): Promise<void>;
-    /**
-     * 切换分支
-     *
-     * 切换到不同的分支，使后续的变更记录到目标分支：
-     * 1. 验证当前分支和目标分支
-     * 2. 重建所有实体表的触发器（更新为新的分支 ID）
-     * 3. 更新分支激活状态
-     *
-     * @param branchId - 目标分支 ID
-     * @throws {RxdbAdapterPGliteError} 分支未找到
-     */
-    switchBranch(branchId: string): Promise<void>;
+    createBranch(branchId: string, fromChangeId?: number): Promise<InstanceType<typeof RxDBBranch>>;
+    switchBranch(_options: SwitchBranchOptions): Promise<void>;
     /**
      * 恢复实体到指定状态
      *
@@ -145,13 +139,13 @@ export declare class RxDBAdapterPGlite extends RxDBAdapterLocalBase implements I
      *
      * @returns 分支仓库实例
      */
-    localRxDBBranch(): RxDBBranchRepository;
+    localRxDBBranch(): PGliteRepository<typeof RxDBBranch>;
     /**
      * 获取本地变更仓库
      *
      * @returns 变更仓库实例
      */
-    localRxDBChange(): RxDBChangeRepository;
+    localRxDBChange(): PGliteRepository<typeof RxDBChange>;
     /**
      * 执行事务
      *
@@ -180,6 +174,11 @@ export declare class RxDBAdapterPGlite extends RxDBAdapterLocalBase implements I
      * @returns 查询结果
      */
     query(sql: string, bindings?: any[]): Promise<Results<any>>;
+    /**
+     * 内部查询方法 (Public Alias)
+     * 供核心同步逻辑使用，绕过队列直接查询
+     */
+    internalQuery(sql: string, params?: any[]): Promise<Results<any>>;
 }
 /**
  * 扩展 RxDBAdapters 接口

package/dist/RxDBAdapterPGlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RxDBAdapterPGlite.d.ts","sourceRoot":"","sources":["../src/RxDBAdapterPGlite.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RxDBAdapterPGlite.d.ts","sourceRoot":"","sources":["../src/RxDBAdapterPGlite.ts"],"names":[],"mappings":"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"}

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,4 +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;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,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"}