@aiao/rxdb-adapter-pglite 0.0.5 → 0.0.7

package/dist/table/create_tables_sql.d.ts

@@ -0,0 +1,31 @@
+import { EntityType } from '../../packages/rxdb/src/index.ts';
+import { RxDBAdapterPGlite } from '../RxDBAdapterPGlite.js';
+/**
+ * 生成多张表的创建 SQL
+ *
+ * 为指定的实体类型生成完整的表结构创建 SQL,包括:
+ * 1. CREATE TABLE 语句
+ * 2. 外键约束
+ * 3. 触发器(仅对 log !== false 的实体)
+ * 4. 初始数据 INSERT 语句(可选)
+ *
+ * @param adapter - PGlite 适配器实例
+ * @param EntityTypes - 实体类型数组
+ * @param entities - 可选的初始数据实体数组
+ * @returns 完整的 SQL 语句字符串
+ *
+ * @example
+ * ```typescript
+ * // 创建表结构
+ * const sql = create_tables_sql(adapter, [User, Todo]);
+ * await adapter.query(sql);
+ *
+ * // 创建表并插入初始数据
+ * const user = new User();
+ * user.name = 'Admin';
+ * const sqlWithData = create_tables_sql(adapter, [User], [user]);
+ * ```
+ */
+export declare function create_tables_sql<T extends EntityType>(adapter: RxDBAdapterPGlite, EntityTypes: T[], entities?: InstanceType<T>[]): string;
+export default create_tables_sql;
+//# sourceMappingURL=create_tables_sql.d.ts.map

package/dist/table/create_tables_sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_tables_sql.d.ts","sourceRoot":"","sources":["../../src/table/create_tables_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,UAAU,EAAqB,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAKjE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,UAAU,EACpD,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,CAAC,EAAE,EAChB,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GAC3B,MAAM,CAwCR;AAED,eAAe,iBAAiB,CAAC"}

package/dist/table/notify_function_sql.d.ts

@@ -0,0 +1,46 @@
+/**
+ * T009-T010: PostgreSQL NOTIFY 触发器函数生成
+ *
+ * 为表创建触发器，在 INSERT/UPDATE/DELETE 时通过 NOTIFY 发送变更事件
+ */
+/**
+ * 生成 NOTIFY 触发器函数 SQL
+ *
+ * 创建一个通用的 trigger function，可以在多个表上复用
+ * 触发器会：
+ * 1. 收集当前事务中的所有变更
+ * 2. 批量发送 NOTIFY 消息（包含 operation 和 id 数组）
+ * 3. 使用 JSON 格式传递 payload
+ *
+ * @returns SQL 语句，创建 notify_change() 函数
+ */
+export declare function generateNotifyFunctionSQL(): string;
+/**
+ * 为指定表创建 NOTIFY 触发器
+ *
+ * 触发器会在 INSERT, UPDATE, DELETE 后触发
+ * AFTER 触发器确保变更已提交
+ *
+ * @param tableName - 表名（例如 "public$RxDBChange"）
+ * @returns SQL 语句，创建触发器（包含表存在性检查）
+ */
+export declare function generateNotifyTriggerSQL(tableName: string): string;
+/**
+ * 移除表的 NOTIFY 触发器
+ *
+ * @param tableName - 表名
+ * @returns SQL 语句，删除触发器
+ */
+export declare function removeNotifyTriggerSQL(tableName: string): string;
+/**
+ * 生成完整的 NOTIFY 基础设施 SQL
+ *
+ * 包括：
+ * 1. 创建 notify_change() 函数
+ * 2. 为监控表创建触发器
+ *
+ * @param watchTables - 需要监控的表名数组
+ * @returns 完整的 SQL 语句
+ */
+export declare function generateNotifyInfrastructureSQL(watchTables?: string[]): string;
+//# sourceMappingURL=notify_function_sql.d.ts.map

package/dist/table/notify_function_sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify_function_sql.d.ts","sourceRoot":"","sources":["../../src/table/notify_function_sql.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAuClD;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAwBlE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,GAAE,MAAM,EAAuE,GACzF,MAAM,CAYR"}

package/dist/table/remove_trigger_sql.d.ts

@@ -0,0 +1,41 @@
+import { EntityMetadata } from '../../packages/rxdb/src/index.ts';
+import { RxDBAdapterPGlite } from '../RxDBAdapterPGlite.js';
+/**
+ * 生成删除单个实体触发器的 SQL
+ *
+ * 为指定实体生成删除触发器和触发器函数的 SQL 语句
+ *
+ * @param entityMetadata - 实体元数据
+ * @returns 删除触发器的 SQL 语句(包含 DROP TRIGGER 和 DROP FUNCTION)
+ *
+ * @example
+ * ```typescript
+ * const metadata = getEntityMetadata(Todo);
+ * const sql = remove_trigger_sql(metadata);
+ * // 返回:
+ * // DROP TRIGGER IF EXISTS "Todo_change_trigger" ON "public"."Todo"
+ * // ---STATEMENT_SEPARATOR---
+ * // DROP FUNCTION IF EXISTS "public"."Todo_change_trigger_fn"() CASCADE
+ * ```
+ */
+export declare function remove_trigger_sql(entityMetadata: EntityMetadata): string;
+/**
+ * 生成删除所有实体触发器的 SQL
+ *
+ * 遍历所有启用日志的实体(log !== false)，生成删除触发器的 SQL
+ *
+ * @param adapter - PGlite 适配器实例
+ * @returns 删除所有触发器的 SQL 语句(每个实体的语句用 ---STATEMENT_SEPARATOR--- 分隔)
+ *
+ * @example
+ * ```typescript
+ * const sql = remove_all_triggers_sql(adapter);
+ * const statements = sql.split('---STATEMENT_SEPARATOR---');
+ * for (const statement of statements) {
+ *   await adapter.query(statement);
+ * }
+ * ```
+ */
+export declare function remove_all_triggers_sql(adapter: RxDBAdapterPGlite): string;
+export default remove_all_triggers_sql;
+//# sourceMappingURL=remove_trigger_sql.d.ts.map

package/dist/table/remove_trigger_sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove_trigger_sql.d.ts","sourceRoot":"","sources":["../../src/table/remove_trigger_sql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,CAkBzE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAe1E;AAED,eAAe,uBAAuB,CAAC"}

package/dist/table/trigger_sql.d.ts

@@ -0,0 +1,37 @@
+import { EntityMetadata } from '../../packages/rxdb/src/index.ts';
+/**
+ * 触发器选项
+ */
+interface TriggerOptions {
+    /** 分支 ID (默认 'main') */
+    branchId?: string;
+    /** 事务 ID (可选，用于事务内的变更追踪) */
+    transactionId?: string;
+}
+/**
+ * 生成 PostgreSQL 触发器 SQL
+ *
+ * 为实体表生成 INSERT/UPDATE/DELETE 触发器,自动记录所有数据变更到 RxDBChange 表
+ * PostgreSQL 触发器需要先创建触发器函数,然后创建触发器本身
+ *
+ * 注意：由于 PostgreSQL 事务限制（pending trigger events），
+ * 我们无法通过修改列默认值来动态设置 transactionId，
+ * 必须在触发器中硬编码，并在每次切换时重建触发器（与 SQLite 方案一致）
+ *
+ * @param entityMetadata - 实体元数据
+ * @param options - 触发器选项
+ * @returns 完整的触发器 SQL 语句
+ *
+ * @example
+ * ```typescript
+ * const sql = generate_trigger_sql(todoMetadata);
+ * await adapter.exec(sql);
+ *
+ * // 在事务中使用
+ * const sqlWithTx = generate_trigger_sql(todoMetadata, { transactionId: 'tx-123' });
+ * await adapter.exec(sqlWithTx);
+ * ```
+ */
+export declare function generate_trigger_sql(entityMetadata: EntityMetadata, options?: TriggerOptions): string;
+export default generate_trigger_sql;
+//# sourceMappingURL=trigger_sql.d.ts.map

package/dist/table/trigger_sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger_sql.d.ts","sourceRoot":"","sources":["../../src/table/trigger_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiC,MAAM,YAAY,CAAC;AAG3E;;GAEG;AACH,UAAU,cAAc;IACtB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,cAAc,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAiHzG;AAED,eAAe,oBAAoB,CAAC"}

package/dist/transaction_pglite_result.d.ts

@@ -0,0 +1,102 @@
+import { EntityType } from '../packages/rxdb/src/index.ts';
+import { RxDBAdapterPGlite } from './RxDBAdapterPGlite.js';
+/**
+ * PGlite 执行结果（从 execute_helper 返回）
+ */
+export interface PGliteExecuteResult<T = any> {
+    rows: T[];
+    rowsAffected: number;
+    elapsed: number;
+}
+/**
+ * 从 PGlite 查询结果创建或重用实体
+ *
+ * 这是处理 SELECT/INSERT RETURNING/UPDATE RETURNING 结果的统一入口。
+ *
+ * ## 行为
+ *
+ * 1. **新实体**：如果 ID 在缓存中不存在，创建新实体并标记为 `local=true, modified=false`
+ * 2. **已存在实体**：返回缓存中的同一实例（引用相等）
+ * 3. **forcedUpdate=true**：强制更新已存在实体的所有字段
+ * 4. **forcedUpdate=false**（默认）：不更新已存在实体
+ *
+ * ## 使用场景
+ *
+ * - **INSERT RETURNING**: 总是创建新实体
+ * - **SELECT**: 查询结果，可能包含新旧实体
+ * - **UPDATE RETURNING**: 需要 `forcedUpdate=true` 更新实体状态
+ *
+ * @param adapter - PGlite 适配器实例
+ * @param EntityType - 实体类型
+ * @param result - execute_helper 返回的结果
+ * @param forcedUpdate - 是否强制更新已存在的实体
+ * @returns 实体数组（新创建或重用的）
+ *
+ * @example
+ * ```typescript
+ * // SELECT 查询：重用缓存实体
+ * const result = await execute_query(client, 'SELECT * FROM todos WHERE completed = $1', [false]);
+ * const todos = transaction_pglite_result(adapter, Todo, result);
+ *
+ * // INSERT RETURNING：创建新实体
+ * const insertResult = await execute_query(
+ *   client,
+ *   'INSERT INTO todos (id, title) VALUES ($1, $2) RETURNING *',
+ *   ['new-id', 'New Todo']
+ * );
+ * const newTodo = transaction_pglite_result(adapter, Todo, insertResult)[0];
+ *
+ * // UPDATE RETURNING：强制更新实体
+ * const updateResult = await execute_query(
+ *   client,
+ *   'UPDATE todos SET completed = true WHERE id = $1 RETURNING *',
+ *   ['todo-id']
+ * );
+ * transaction_pglite_result(adapter, Todo, updateResult, true);
+ * ```
+ */
+export declare const transaction_pglite_result: <T extends EntityType>(adapter: RxDBAdapterPGlite, EntityType: T, result: PGliteExecuteResult, forcedUpdate?: boolean) => InstanceType<T>[];
+/**
+ * 更新已存在的实体（仅更新，不创建新实体）
+ *
+ * 用于 UPDATE RETURNING 场景：只更新已在内存中的实体，不创建新实体。
+ *
+ * ## 与 transaction_pglite_result(forcedUpdate=true) 的区别
+ *
+ * - `transaction_pglite_result(forcedUpdate=true)`: 更新 **或** 创建
+ * - `update_entity_from_pglite_result`: **只更新**，忽略不存在的实体
+ *
+ * @param adapter - PGlite 适配器实例
+ * @param EntityType - 实体类型
+ * @param result - execute_helper 返回的结果
+ *
+ * @example
+ * ```typescript
+ * // 仅更新内存中的实体，忽略不存在的 ID
+ * const result = await execute_query(
+ *   client,
+ *   'UPDATE todos SET completed = true WHERE id = ANY($1) RETURNING *',
+ *   [todoIds]
+ * );
+ * update_entity_from_pglite_result(adapter, Todo, result);
+ * ```
+ */
+export declare const update_entity_from_pglite_result: <T extends EntityType>(adapter: RxDBAdapterPGlite, EntityType: T, result: PGliteExecuteResult) => void;
+/**
+ * 将实体标记为已删除（从缓存中移除）
+ *
+ * 用于 DELETE 操作后清理内存状态。实体不会被销毁，但会被标记为 `removed=true, local=false`。
+ *
+ * @param adapter - PGlite 适配器实例
+ * @param EntityType - 实体类型
+ * @param ids - 要删除的实体 ID 数组
+ *
+ * @example
+ * ```typescript
+ * // 删除后清理缓存
+ * await execute_query(client, 'DELETE FROM todos WHERE id = ANY($1)', [todoIds]);
+ * remove_entity_ids_from_cache(adapter, Todo, todoIds);
+ * ```
+ */
+export declare const remove_entity_ids_from_cache: <T extends EntityType>(adapter: RxDBAdapterPGlite, EntityType: T, ids: any[]) => void;
+//# sourceMappingURL=transaction_pglite_result.d.ts.map

package/dist/transaction_pglite_result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction_pglite_result.d.ts","sourceRoot":"","sources":["../src/transaction_pglite_result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAsC,MAAM,YAAY,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,GAAG;IAC1C,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,UAAU,EAC5D,SAAS,iBAAiB,EAC1B,YAAY,CAAC,EACb,QAAQ,mBAAmB,EAC3B,eAAc,OAAe,KAC5B,YAAY,CAAC,CAAC,CAAC,EAkDjB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,gCAAgC,GAAI,CAAC,SAAS,UAAU,EACnE,SAAS,iBAAiB,EAC1B,YAAY,CAAC,EACb,QAAQ,mBAAmB,KAC1B,IAuBF,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,4BAA4B,GAAI,CAAC,SAAS,UAAU,EAC/D,SAAS,iBAAiB,EAC1B,YAAY,CAAC,EACb,KAAK,GAAG,EAAE,KACT,IAUF,CAAC"}

package/dist/version/create_branch.d.ts

@@ -0,0 +1,24 @@
+import { RxDBBranch } from '../../packages/rxdb/src/index.ts';
+import { RxDBAdapterPGlite } from '../RxDBAdapterPGlite.js';
+/**
+ * 创建分支
+ *
+ * 从当前分支或指定变更点创建新分支
+ *
+ * @param adapter - PGlite 适配器实例
+ * @param branchId - 新分支 ID
+ * @param fromChangeId - 可选，从指定变更点创建分支
+ * @returns 创建的分支实体
+ *
+ * @example
+ * ```typescript
+ * // 从当前分支创建新分支
+ * const branch = await rxdb_adapter_create_branch(adapter, 'feature-01');
+ *
+ * // 从指定变更点创建分支
+ * const branch = await rxdb_adapter_create_branch(adapter, 'feature-02', 42);
+ * ```
+ */
+declare const _default: (adapter: RxDBAdapterPGlite, branchId: string, fromChangeId?: number) => Promise<InstanceType<typeof RxDBBranch>>;
+export default _default;
+//# sourceMappingURL=create_branch.d.ts.map

package/dist/version/create_branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_branch.d.ts","sourceRoot":"","sources":["../../src/version/create_branch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;yBAED,SAAS,iBAAiB,EAC1B,UAAU,MAAM,EAChB,eAAe,MAAM,KACpB,OAAO,CAAC,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;AAJ3C,wBA4EE"}

package/dist/version/switch_transaction_id.d.ts

@@ -0,0 +1,18 @@
+import { UUID } from '../../packages/rxdb/src/index.ts';
+import { RxDBAdapterPGlite } from '../RxDBAdapterPGlite.js';
+/**
+ * 切换事务 ID
+ *
+ * 生成 SQL 语句来重新创建所有实体表的触发器，注入新的事务 ID
+ *
+ * 注意：虽然理论上 PostgreSQL 可以通过修改 RxDBChange 表的列默认值来实现，
+ * 但由于事务中的触发器事件会导致 "cannot ALTER TABLE because it has pending trigger events" 错误，
+ * 因此我们必须采用与 SQLite 相同的方案：动态重建触发器
+ *
+ * @param adapter - PGlite 适配器实例
+ * @param branchId - 分支 ID
+ * @param transactionId - 事务 ID（可选，不传则清空）
+ * @returns SQL 语句数组（因为在事务中 query() 方法不支持多条语句）
+ */
+export default function rxdb_adapter_switch_transaction_id(adapter: RxDBAdapterPGlite, branchId: string, transactionId?: UUID): string[];
+//# sourceMappingURL=switch_transaction_id.d.ts.map

package/dist/version/switch_transaction_id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch_transaction_id.d.ts","sourceRoot":"","sources":["../../src/version/switch_transaction_id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,IAAI,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGjE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,OAAO,UAAU,kCAAkC,CACxD,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,IAAI,GACnB,MAAM,EAAE,CAiBV"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiao/rxdb-adapter-pglite",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -25,12 +25,14 @@
     ]
   },
   "dependencies": {
+    "@electric-sql/pglite": "^0.3.14",
+    "object-hash": "^3.0.0",
     "rxjs": "^7.8.2",
-    "@electric-sql/pglite": "^0.3.9",
-    "@aiao/rxdb": "0.0.5",
-    "@aiao/utils": "0.0.5"
+    "type-fest": "^5.3.1",
+    "@aiao/rxdb": "0.0.7",
+    "@aiao/utils": "0.0.7"
   },
   "devDependencies": {
-    "@aiao/rxdb-test": "0.0.5"
+    "@aiao/rxdb-test": "0.0.7"
   }
 }

package/dist/generate_table_create_sql.d.ts

@@ -1,5 +0,0 @@
-import { EntityMetadata } from '@aiao/rxdb';
-import { RxDBAdapterPGlite } from './RxDBAdapterPGlite.js';
-declare const _default: (adapter: RxDBAdapterPGlite, metadata: EntityMetadata) => string;
-export default _default;
-//# sourceMappingURL=generate_table_create_sql.d.ts.map

package/dist/generate_table_create_sql.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"generate_table_create_sql.d.ts","sourceRoot":"","sources":["../src/generate_table_create_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAgB,MAAM,YAAY,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;yBAqE3C,SAAS,iBAAiB,EAAE,UAAU,cAAc;AAApE,wBAKE"}