@aiao/rxdb-adapter-pglite 0.0.6 → 0.0.8

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/{rxdb_adapter_switch_transaction_id.d.ts → version/switch_transaction_id.d.ts}

@@ -1,5 +1,5 @@
-import { UUID } from '../packages/rxdb/src/index.ts';
-import { RxDBAdapterPGlite } from './RxDBAdapterPGlite.js';
+import { UUID } from '../../packages/rxdb/src/index.ts';
+import { RxDBAdapterPGlite } from '../RxDBAdapterPGlite.js';
 /**
  * 切换事务 ID
  *
@@ -15,4 +15,4 @@ import { RxDBAdapterPGlite } from './RxDBAdapterPGlite.js';
  * @returns SQL 语句数组（因为在事务中 query() 方法不支持多条语句）
  */
 export default function rxdb_adapter_switch_transaction_id(adapter: RxDBAdapterPGlite, branchId: string, transactionId?: UUID): string[];
-//# sourceMappingURL=rxdb_adapter_switch_transaction_id.d.ts.map
+//# 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.6",
+  "version": "0.0.8",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -25,14 +25,14 @@
     ]
   },
   "dependencies": {
-    "rxjs": "^7.8.2",
-    "@electric-sql/pglite": "^0.3.9",
+    "@electric-sql/pglite": "^0.3.14",
     "object-hash": "^3.0.0",
-    "type-fest": "^5.1.0",
-    "@aiao/rxdb": "0.0.6",
-    "@aiao/utils": "0.0.6"
+    "rxjs": "^7.8.2",
+    "type-fest": "^5.3.1",
+    "@aiao/rxdb": "0.0.8",
+    "@aiao/utils": "0.0.8"
   },
   "devDependencies": {
-    "@aiao/rxdb-test": "0.0.6"
+    "@aiao/rxdb-test": "0.0.8"
   }
 }

package/dist/rxdb_adapter_create_branch.d.ts

@@ -1,7 +0,0 @@
-import { RxDBAdapterPGlite } from './RxDBAdapterPGlite.js';
-/**
- * 创建分支
- */
-declare const _default: (adapter: RxDBAdapterPGlite, branchId: string, fromChangeId?: number) => Promise<void>;
-export default _default;
-//# sourceMappingURL=rxdb_adapter_create_branch.d.ts.map

package/dist/rxdb_adapter_create_branch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rxdb_adapter_create_branch.d.ts","sourceRoot":"","sources":["../src/rxdb_adapter_create_branch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;GAEG;yBACmB,SAAS,iBAAiB,EAAE,UAAU,MAAM,EAAE,eAAe,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;AAAzG,wBAiEE"}

package/dist/rxdb_adapter_switch_transaction_id.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rxdb_adapter_switch_transaction_id.d.ts","sourceRoot":"","sources":["../src/rxdb_adapter_switch_transaction_id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,IAAI,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE;;;;;;;;;;;;;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/dist/table/create_sql.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create_sql.d.ts","sourceRoot":"","sources":["../../src/table/create_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA8B,MAAM,YAAY,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;yBAoK5C,SAAS,iBAAiB,EAAE,UAAU,cAAc;AAApE,wBAKE"}