@aiao/rxdb-adapter-pglite 0.0.6 → 0.0.7

package/dist/pglite.interface.d.ts

@@ -3,6 +3,43 @@ import { PGliteOptions } from '@electric-sql/pglite';
  * PGlite 适配器名称常量
  */
 export declare const ADAPTER_NAME: "pglite";
+/**
+ * PGlite 变更事件类型枚举
+ * 对应 PostgreSQL 的 TG_OP (trigger operation)
+ */
+export declare enum PGliteChangeType {
+    INSERT = "INSERT",
+    UPDATE = "UPDATE",
+    DELETE = "DELETE"
+}
+/**
+ * PGlite 通知 payload 结构
+ * 从 NOTIFY 消息中解析的数据
+ */
+export interface PGliteNotifyPayload {
+    /** 操作类型 */
+    operation: PGliteChangeType;
+    /** 表名 */
+    table: string;
+    /** 受影响的行 ID 数组 */
+    ids: Array<string | number>;
+}
+/**
+ * PGlite 变更事件
+ * 触发器通过 NOTIFY 发送的数据库变更事件
+ */
+export interface PGliteChangeEvent {
+    /** 事件类型 */
+    type: PGliteChangeType;
+    /** 数据库名称 */
+    dbName: string;
+    /** 表名称 */
+    tableName: string;
+    /** 受影响的行 ID 列表 */
+    rowIds: Array<string | number>;
+    /** 记录时间 */
+    recordAt: Date;
+}
 /**
  * PGlite 客户端配置选项
  * 扩展自 PGlite 原生配置

package/dist/pglite.interface.d.ts.map

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

package/dist/pglite.utils.d.ts

@@ -1,46 +1,80 @@
 import { EntityMetadata, EntityPropertyMetadata, EntityRelationMetadata } from '../packages/rxdb/src/index.ts';
+/**
+ * PGlite 适配器错误类
+ *
+ * 扩展标准 Error，添加错误码和原始错误引用
+ */
 export declare class RxdbAdapterPGliteError extends Error {
-    constructor(message: string);
+    /**
+     * 错误代码（例如：DUPLICATE_ENTITY, INVALID_SQL）
+     */
+    readonly code?: string;
+    /**
+     * 原始错误对象（如果是从其他错误转换而来）
+     */
+    readonly originalError?: Error;
+    constructor(message: string, code?: string, originalError?: Error);
 }
 export declare const getTableName: (entityName: string, namespace?: string) => string;
 export declare const getTableNameByMetadata: (metadata: EntityMetadata) => string;
 type PGliteDataType = 'uuid' | 'varchar' | 'jsonb' | 'numeric' | 'integer' | 'boolean' | 'timestamptz';
 /**
- * rxdb 的类型 转 PGlite 类型
+ * 将 RxDB 属性类型转换为 PGlite 数据类型
  */
 export declare const rxDBColumnTypeToPGliteType: (property: EntityPropertyMetadata) => PGliteDataType;
 /**
- * 获取属性的 index 操作符
- *http://www.postgres.cn/docs/current/indexes-opclass.html
+ * 获取属性的索引操作符
+ * http://www.postgres.cn/docs/current/indexes-opclass.html
  */
 export declare const rxDBColumnTypeToPGliteTypeIndexName: (property: EntityPropertyMetadata) => string;
+/**
+ * 获取表列索引名称
+ */
 export declare const getTableColumnIndexName: (metadata: EntityMetadata, property: EntityPropertyMetadata | EntityRelationMetadata) => string;
 /**
- * Transform JavaScript value to PostgreSQL-compatible value
+ * 将 JavaScript 值转换为 PostgreSQL 兼容的值
  */
 export declare const transformValueJsToPGlite: (value: any, property: EntityPropertyMetadata) => any;
 /**
- * Transform entity values to SQL-compatible format
+ * 将实体值转换为 SQL 兼容格式
  */
 export declare const transformEntityValueToSql: (metadata: EntityMetadata, entity: any) => any;
 /**
- * Normalize entity data for creation (filter writable fields)
+ * 规范化创建实体的字段（过滤可写字段）
  */
 export declare const normalizeCreateEntity: (metadata: EntityMetadata, entity: any) => any;
 /**
- * Normalize entity data, filtering out readonly fields
+ * 规范化实体数据，过滤掉只读字段
  */
 export declare const normalizeEntity: (metadata: EntityMetadata, entity: any) => any;
 export declare const getSqlValue: (value: any) => string;
 /**
- * Replace PostgreSQL parameter placeholders ($1, $2, etc.) with actual values
- * Used for batch operations where parameterized queries cannot be used
+ * 将 PostgreSQL 参数占位符（$1、$2 等）替换为实际值
+ * 用于批量操作中无法使用参数化查询的情况
  */
 export declare const getSqlWithParams: (sql: string, params?: any[]) => string;
 /**
- * Get entity object data from PGlite result row
- * PGlite returns rows as objects, so this is mainly for type conversion
+ * 从 PGlite 结果行获取实体对象数据
+ * PGlite 返回行作为对象，主要用于类型转换
  */
 export declare const getEntityObjectFromResult: (metadata: EntityMetadata, row: any) => any;
+/**
+ * 将 PGlite 存储的值转换为 JS 类型
+ * PostgreSQL 的 JSONB 字段已经是对象，不需要 JSON.parse
+ *
+ * @param value - 数据库值
+ * @param property - 属性元数据
+ * @returns 转换后的 JS 值
+ */
+export declare const transformValuePGliteToJs: (value: any, property: EntityPropertyMetadata) => any;
+/**
+ * 将实体对象中的所有值从 PGlite 格式转换为 JS 类型
+ * 主要用于 RxDBChange 表的 patch/inversePatch 字段
+ *
+ * @param metadata - 实体元数据
+ * @param entity - 实体对象
+ * @returns 转换后的实体对象
+ */
+export declare const transformEntityValuePGliteToJs: (metadata: EntityMetadata, entity: Record<string, any>) => Record<string, any>;
 export {};
 //# sourceMappingURL=pglite.utils.d.ts.map

package/dist/pglite.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pglite.utils.d.ts","sourceRoot":"","sources":["../src/pglite.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,sBAAsB,EAAgB,MAAM,YAAY,CAAC;AAG1G,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAK5B;AAED,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,EAAE,YAAW,MAAiB,WAAqC,CAAC;AAEnH,eAAO,MAAM,sBAAsB,GAAI,UAAU,cAAc,WAAoD,CAAC;AAGpH,KAAK,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;AAEvG;;GAEG;AACH,eAAO,MAAM,0BAA0B,GAAI,UAAU,sBAAsB,KAAG,cAkB7E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mCAAmC,GAAI,UAAU,sBAAsB,KAAG,MAgBtF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,UAAU,cAAc,EACxB,UAAU,sBAAsB,GAAG,sBAAsB,WACO,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,GAAG,EAAE,UAAU,sBAAsB,KAAG,GAyBvF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAU,cAAc,EAAE,QAAQ,GAAG,QAmB9E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,cAAc,EAAE,QAAQ,GAAG,QAC0B,CAAC;AAEtG;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,cAAc,EAAE,QAAQ,GAAG,QACS,CAAC;AAW/E,eAAO,MAAM,WAAW,GAAI,OAAO,GAAG,KAAG,MA0BxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,EAAE,SAAQ,GAAG,EAAO,KAAG,MAWlE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAU,cAAc,EAAE,KAAK,GAAG,KAAG,GAwB9E,CAAC"}
+{"version":3,"file":"pglite.utils.d.ts","sourceRoot":"","sources":["../src/pglite.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,sBAAsB,EAAgB,MAAM,YAAY,CAAC;AAG1G;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C;;OAEG;IACH,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK;CAOlE;AAED,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,EAAE,YAAW,MAAiB,WAAqC,CAAC;AAEnH,eAAO,MAAM,sBAAsB,GAAI,UAAU,cAAc,WAAoD,CAAC;AAGpH,KAAK,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;AAEvG;;GAEG;AACH,eAAO,MAAM,0BAA0B,GAAI,UAAU,sBAAsB,KAAG,cAkB7E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mCAAmC,GAAI,UAAU,sBAAsB,KAAG,MAgBtF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,cAAc,EACxB,UAAU,sBAAsB,GAAG,sBAAsB,WACO,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,GAAG,EAAE,UAAU,sBAAsB,KAAG,GAyBvF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAU,cAAc,EAAE,QAAQ,GAAG,QAmB9E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,cAAc,EAAE,QAAQ,GAAG,QAC0B,CAAC;AAEtG;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,cAAc,EAAE,QAAQ,GAAG,QACS,CAAC;AAW/E,eAAO,MAAM,WAAW,GAAI,OAAO,GAAG,KAAG,MA0BxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,EAAE,SAAQ,GAAG,EAAO,KAAG,MAWlE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAU,cAAc,EAAE,KAAK,GAAG,KAAG,GAwB9E,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,GAAG,EAAE,UAAU,sBAAsB,KAAG,GAmBvF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,GAAI,UAAU,cAAc,EAAE,QAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,wBASnG,CAAC"}

package/dist/query/find_by_row_ids_sql.d.ts

@@ -0,0 +1,15 @@
+import { EntityMetadata } from '../../packages/rxdb/src/index.ts';
+export interface GenerateSqlResult {
+    sql: string;
+    params?: any[];
+}
+/**
+ * 生成 findByRowIds 查询 SQL
+ *
+ * @param metadata - 实体元数据
+ * @param rowIds - 行 ID 数组
+ * @returns SQL 查询和参数
+ */
+declare const _default: (metadata: EntityMetadata, rowIds: Array<string | number>) => GenerateSqlResult;
+export default _default;
+//# sourceMappingURL=find_by_row_ids_sql.d.ts.map

package/dist/query/find_by_row_ids_sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find_by_row_ids_sql.d.ts","sourceRoot":"","sources":["../../src/query/find_by_row_ids_sql.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;CAChB;AAED;;;;;;GAMG;yBACa,UAAU,cAAc,EAAE,QAAQ,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAAG,iBAAiB;AAA5F,wBAYE"}

package/dist/query/join_sql.d.ts

@@ -16,28 +16,33 @@ export interface JoinContext {
     relationAliasMap: Map<string, string>;
 }
 /**
- * Get or create a stable relation alias
+ * 获取或创建稳定的关系别名
  */
 export declare const get_or_create_relation_alias: (context: JoinContext, relationKey: string) => string;
 /**
- * Try resolve relation path to a sequence of relation pairs
+ * 尝试将关系路径解析为一系列关系配对（RelationPair）
  */
 export declare const try_resolve_relation_path: (adapter: RxDBAdapterPGlite, entityMetadata: EntityMetadata, parts: string[], cut: number) => {
     metaWalker?: EntityMetadata;
     relPairs: RelationPair[];
 };
 /**
- * Try process JSON keyValue on a relation chain (orders.meta.xxx)
+ * 尝试在关系链上处理 JSON keyValue 字段（例如 orders.meta.xxx）
+ *
+ * @remarks
+ * **已知限制**：当前实现假定点号仅用于表示嵌套路径。
+ * 如果 keyValue 对象内部的键本身包含点（如 "version.major"），此方法将无法正确处理。
+ * 详见 SQLite 适配器中 `_try_process_top_level_flatmap` 的文档说明。
  */
 export declare const try_process_relation_flatmap: (adapter: RxDBAdapterPGlite, context: JoinContext, entityMetadata: EntityMetadata, strValue: string, parts: string[]) => boolean;
 /**
- * Process relation joins for a chain
+ * 处理一条关系链上的所有 JOIN
  */
 export declare const process_relation_joins: (adapter: RxDBAdapterPGlite, context: JoinContext, relations: RelationPair[], joinTableName: string) => void;
 export declare const get_relation_key: (relations: RelationPair[], joinTableName: string, relation: EntityRelationMetadata) => string;
 export declare const format_table_alias: (alias: string) => string;
 /**
- * Build JOIN SQL and field alias map from a rule group
+ * 根据规则组构建 JOIN SQL 以及字段别名映射表
  */
 export declare const build_rule_group_join_pg: (adapter: RxDBAdapterPGlite, entityMetadata: EntityMetadata, ruleGroup: any) => {
     joinSQL: string;

package/dist/query/join_sql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"join_sql.d.ts","sourceRoot":"","sources":["../../src/query/join_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,sBAAsB,EAIvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,eAAO,MAAM,gBAAgB,EAAG,GAAY,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,GAAG,CAAC,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;IAC5C,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAOD;;GAEG;AACH,eAAO,MAAM,4BAA4B,GAAI,SAAS,WAAW,EAAE,aAAa,MAAM,KAAG,MAMxF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAS,iBAAiB,EAC1B,gBAAgB,cAAc,EAC9B,OAAO,MAAM,EAAE,EACf,KAAK,MAAM,KACV;IAAE,UAAU,CAAC,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAazD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B,GACvC,SAAS,iBAAiB,EAC1B,SAAS,WAAW,EACpB,gBAAgB,cAAc,EAC9B,UAAU,MAAM,EAChB,OAAO,MAAM,EAAE,KACd,OA0BF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,iBAAiB,EAC1B,SAAS,WAAW,EACpB,WAAW,YAAY,EAAE,EACzB,eAAe,MAAM,KACpB,IA4BF,CAAC;AAoEF,eAAO,MAAM,gBAAgB,GAC3B,WAAW,YAAY,EAAE,EACzB,eAAe,MAAM,EACrB,UAAU,sBAAsB,KAC/B,MAAwF,CAAC;AAE5F,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,MAA6D,CAAC;AAEjH;;GAEG;AACH,eAAO,MAAM,wBAAwB,GACnC,SAAS,iBAAiB,EAC1B,gBAAgB,cAAc,EAC9B,WAAW,GAAG;;;CAyBf,CAAC"}
+{"version":3,"file":"join_sql.d.ts","sourceRoot":"","sources":["../../src/query/join_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,sBAAsB,EAIvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,eAAO,MAAM,gBAAgB,EAAG,GAAY,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,GAAG,CAAC,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;IAC5C,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAOD;;GAEG;AACH,eAAO,MAAM,4BAA4B,GAAI,SAAS,WAAW,EAAE,aAAa,MAAM,KAAG,MAMxF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAS,iBAAiB,EAC1B,gBAAgB,cAAc,EAC9B,OAAO,MAAM,EAAE,EACf,KAAK,MAAM,KACV;IAAE,UAAU,CAAC,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAazD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,GACvC,SAAS,iBAAiB,EAC1B,SAAS,WAAW,EACpB,gBAAgB,cAAc,EAC9B,UAAU,MAAM,EAChB,OAAO,MAAM,EAAE,KACd,OA0BF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,iBAAiB,EAC1B,SAAS,WAAW,EACpB,WAAW,YAAY,EAAE,EACzB,eAAe,MAAM,KACpB,IA4BF,CAAC;AAwEF,eAAO,MAAM,gBAAgB,GAC3B,WAAW,YAAY,EAAE,EACzB,eAAe,MAAM,EACrB,UAAU,sBAAsB,KAC/B,MAAwF,CAAC;AAE5F,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,MAA6D,CAAC;AAEjH;;GAEG;AACH,eAAO,MAAM,wBAAwB,GACnC,SAAS,iBAAiB,EAC1B,gBAAgB,cAAc,EAC9B,WAAW,GAAG;;;CAyBf,CAAC"}

package/dist/query/query_sql.d.ts

@@ -5,15 +5,15 @@ export interface GenerateSqlResult {
     params: any[];
 }
 /**
- * Build WHERE clause from RuleGroup with PostgreSQL parameters
+ * 基于 RuleGroup 递归构建 WHERE 语句
  */
 export declare const buildRuleGroupPG: <RG extends RuleGroup<any, any, any>>(ruleGroup: RG, params: any[], fieldAliasMap?: Map<string, string>, entityMetadata?: EntityMetadata) => string;
 /**
- * Generate find SQL
+ * 生成查找（SELECT）SQL（支持 where / join / order / limit / offset）
  */
 export declare const generate_find_sql: (adapter: RxDBAdapterPGlite, metadata: EntityMetadata, options: FindOptions | FindAllOptions) => GenerateSqlResult;
 /**
- * Generate count SQL
+ * 生成计数（COUNT）SQL
  */
 export declare const generate_count_sql: (adapter: RxDBAdapterPGlite, metadata: EntityMetadata, options: CountOptions) => GenerateSqlResult;
 //# sourceMappingURL=query_sql.d.ts.map

package/dist/query/query_sql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query_sql.d.ts","sourceRoot":"","sources":["../../src/query/query_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,WAAW,EAGX,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAY5D,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,GAAG,EAAE,CAAC;CACf;AA+KD;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,EAAE,SAAS,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAClE,WAAW,EAAE,EACb,QAAQ,GAAG,EAAE,EACb,gBAAe,GAAG,CAAC,MAAM,EAAE,MAAM,CAAa,EAC9C,iBAAiB,cAAc,KAC9B,MAcF,CAAC;AAkDF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,iBAAiB,EAC1B,UAAU,cAAc,EACxB,SAAS,WAAW,GAAG,cAAc,KACpC,iBAyBF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,iBAAiB,EAC1B,UAAU,cAAc,EACxB,SAAS,YAAY,KACpB,iBAoBF,CAAC"}
+{"version":3,"file":"query_sql.d.ts","sourceRoot":"","sources":["../../src/query/query_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,WAAW,EAGX,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAY5D,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,GAAG,EAAE,CAAC;CACf;AA2LD;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,EAAE,SAAS,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAClE,WAAW,EAAE,EACb,QAAQ,GAAG,EAAE,EACb,gBAAe,GAAG,CAAC,MAAM,EAAE,MAAM,CAAa,EAC9C,iBAAiB,cAAc,KAC9B,MAcF,CAAC;AAkDF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,iBAAiB,EAC1B,UAAU,cAAc,EACxB,SAAS,WAAW,GAAG,cAAc,KACpC,iBAyBF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,iBAAiB,EAC1B,UAAU,cAAc,EACxB,SAAS,YAAY,KACpB,iBAoBF,CAAC"}

package/dist/repository/PGliteRepository.d.ts

@@ -1,6 +1,8 @@
-import { CountOptions, EntityType, FindAllOptions, FindOptions, IRepository } from '../../packages/rxdb/src/index.ts';
+import { CountOptions, EntityStaticType, EntityType, FindAllOptions, FindOptions, IRepository } from '../../packages/rxdb/src/index.ts';
 import { PGliteRepositoryBase } from './PGliteRepositoryBase.js';
 export declare class PGliteRepository<T extends EntityType> extends PGliteRepositoryBase<T> implements IRepository<T> {
+    get(id: EntityStaticType<T, 'idType'>): Promise<InstanceType<T>>;
+    findOne(options: EntityStaticType<T, 'findOneOptions'>): Promise<InstanceType<T> | undefined>;
     find(options: FindOptions): Promise<InstanceType<T>[]>;
     findAll(options: FindAllOptions): Promise<InstanceType<T>[]>;
     count(options: CountOptions): Promise<number>;

package/dist/repository/PGliteRepository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PGliteRepository.d.ts","sourceRoot":"","sources":["../../src/repository/PGliteRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAKhG,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,qBAAa,gBAAgB,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,oBAAoB,CAAC,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,CAAC;IACrG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAMtD,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAM5D,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAM7C,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAOzD,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAO1F,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAKhE"}
+{"version":3,"file":"PGliteRepository.d.ts","sourceRoot":"","sources":["../../src/repository/PGliteRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAMlH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,qBAAa,gBAAgB,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,oBAAoB,CAAC,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,CAAC;IACrG,GAAG,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAYhE,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,EAAE,gBAAgB,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAK7F,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAMtD,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAM5D,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAM7C,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAOzD,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAO1F,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAKhE"}

package/dist/repository/PGliteRepositoryBase.d.ts

@@ -5,6 +5,14 @@ export declare class PGliteRepositoryBase<T extends EntityType> extends Reposito
     protected adapter: RxDBAdapterPGlite;
     readonly metadata: EntityMetadata;
     constructor(adapter: RxDBAdapterPGlite, EntityType: T);
+    /**
+     * 通过行 ID 列表查询实体
+     * 用于 handle_rxdb_change 中根据 NOTIFY 事件的 rowIds 查询实体
+     *
+     * @param rowIds - 行 ID 数组（string | number）
+     * @returns 实体数组
+     */
+    findByRowIds(rowIds: Array<string | number>): Promise<InstanceType<T>[]>;
     protected addQueryCache(result: Results<any>, forcedUpdate?: boolean): InstanceType<T>[];
 }
 //# sourceMappingURL=PGliteRepositoryBase.d.ts.map

package/dist/repository/PGliteRepositoryBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PGliteRepositoryBase.d.ts","sourceRoot":"","sources":["../../src/repository/PGliteRepositoryBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAsC,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5G,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,qBAAa,oBAAoB,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAI7E,SAAS,CAAC,OAAO,EAAE,iBAAiB;IAHtC,SAAgB,QAAQ,EAAG,cAAc,CAAC;gBAG9B,OAAO,EAAE,iBAAiB,EACpC,UAAU,EAAE,CAAC;IAMf,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,YAAY,UAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE;CAiBvF"}
+{"version":3,"file":"PGliteRepositoryBase.d.ts","sourceRoot":"","sources":["../../src/repository/PGliteRepositoryBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAsC,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5G,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,qBAAa,oBAAoB,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAI7E,SAAS,CAAC,OAAO,EAAE,iBAAiB;IAHtC,SAAgB,QAAQ,EAAG,cAAc,CAAC;gBAG9B,OAAO,EAAE,iBAAiB,EACpC,UAAU,EAAE,CAAC;IAMf;;;;;;OAMG;IACG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAO9E,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,YAAY,UAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE;CAiBvF"}

package/dist/rxdb_adapter_mutations.d.ts

@@ -0,0 +1,72 @@
+import { EntityType, IMutationContext, RxDBMutationsMap } from '../packages/rxdb/src/index.ts';
+import { RxDBAdapterPGlite } from './RxDBAdapterPGlite.js';
+/**
+ * 批量修改实体（创建/更新/删除）
+ *
+ * 这个函数从 `RxDBAdapterPGlite.mutations()` 提取出来，提供独立的批量操作实现。
+ *
+ * ## 优化策略
+ *
+ * ### 1. 按 Patch 键分组（T034）
+ * 对于更新操作，按实体的 `patch` 字段键进行哈希分组。相同字段修改的实体会被分到同一组，
+ * 可以用一条 SQL 语句批量更新，减少数据库往返次数。
+ *
+ * **示例：**
+ * ```typescript
+ * // 3 个用户，2 个只修改 name，1 个只修改 email
+ * user1.name = 'Updated 1';  // patch: { name }
+ * user2.name = 'Updated 2';  // patch: { name } - 与 user1 同组
+ * user3.email = 'new@example.com';  // patch: { email } - 独立一组
+ *
+ * // 结果：生成 2 条 UPDATE 语句而不是 3 条
+ * // UPDATE users SET name = ... WHERE id IN ('user1-id', 'user2-id')
+ * // UPDATE users SET email = ... WHERE id = 'user3-id'
+ * ```
+ *
+ * ### 2. 参数化查询
+ * 使用 PostgreSQL 的参数化查询（`$1`, `$2`等），避免 SQL 注入风险，提升安全性。
+ *
+ * ### 3. 批量查询结果
+ * INSERT/UPDATE 后，使用 `WHERE id IN (...)` 批量查询更新后的数据，减少数据库往返。
+ *
+ * ## 事务保证
+ *
+ * **重要**：调用者必须在事务中执行此函数。通常通过以下方式调用：
+ * ```typescript
+ * await adapter.transaction(() => rxdb_adapter_mutations(adapter, mutations));
+ * ```
+ *
+ * ## 性能目标
+ *
+ * - 100 个实体批量插入：< 100ms (p95)
+ * - 100 个实体批量更新：< 100ms (p95)
+ * - 1000 个实体批量插入：< 200ms (p95)
+ * - 1000 个实体批量更新：< 200ms (p95)
+ *
+ * @param adapter - PGlite 适配器实例
+ * @param mutations - 批量修改映射，包含 create/update/remove 三种操作
+ * @param context - 可选的修改上下文（例如 `userId`，用于设置 `createdBy`/`updatedBy`）
+ * @returns 所有操作涉及的实体数组
+ *
+ * @example
+ * ```typescript
+ * // 创建 + 更新 + 删除混合操作
+ * const newUser = new User({ name: 'New User' });
+ * existingUser.name = 'Updated Name';
+ *
+ * const result = await adapter.transaction(() =>
+ *   rxdb_adapter_mutations(adapter, {
+ *     create: new Map([[User, new Set([newUser])]]),
+ *     update: new Map([[User, new Set([existingUser])]]),
+ *     remove: new Map([[User, new Set([deletedUser])]])
+ *   }, { userId: 'admin-id' })
+ * );
+ *
+ * console.log(result.length);  // 3 (newUser, existingUser, deletedUser)
+ * ```
+ *
+ * @see {@link RxDBAdapterPGlite.mutations}
+ */
+declare const _default: <T extends EntityType = any>(adapter: RxDBAdapterPGlite, mutations: RxDBMutationsMap<T>, context?: IMutationContext) => Promise<InstanceType<T>[]>;
+export default _default;
+//# sourceMappingURL=rxdb_adapter_mutations.d.ts.map

package/dist/rxdb_adapter_mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rxdb_adapter_mutations.d.ts","sourceRoot":"","sources":["../src/rxdb_adapter_mutations.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAsC,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAQhH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;yBACmB,CAAC,SAAS,UAAU,GAAG,GAAG,EAC9C,SAAS,iBAAiB,EAC1B,WAAW,gBAAgB,CAAC,CAAC,CAAC,EAC9B,UAAU,gBAAgB,KACzB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;AAJ7B,wBAmHE"}

package/dist/sql_dialect.d.ts

@@ -0,0 +1,77 @@
+/**
+ * SQL 方言抽象
+ * 处理不同数据库之间的 SQL 语法差异
+ *
+ * T006-T007: PostgreSQL 方言实现
+ */
+/**
+ * SQL 方言接口
+ * 定义数据库特定的 SQL 语法转换方法
+ */
+export interface ISqlDialect {
+    /**
+     * 获取自增主键的 RETURNING 子句
+     * @returns RETURNING 子句字符串
+     */
+    getReturningClause(): string;
+    /**
+     * 获取参数占位符
+     * @param index - 参数索引（从 1 开始）
+     * @returns 占位符字符串
+     */
+    getParameterPlaceholder(index: number): string;
+    /**
+     * 转义标识符（表名、列名等）
+     * @param identifier - 标识符
+     * @returns 转义后的标识符
+     */
+    escapeIdentifier(identifier: string): string;
+    /**
+     * 获取 JSON 提取操作符
+     * @returns JSON 提取操作符
+     */
+    getJsonExtractOperator(): string;
+    /**
+     * 获取字符串连接操作符
+     * @returns 字符串连接操作符
+     */
+    getConcatOperator(): string;
+}
+/**
+ * PostgreSQL 方言实现
+ *
+ * 关键差异：
+ * - 参数占位符：$1, $2, $3（而不是 SQLite 的 ?）
+ * - RETURNING 子句：支持返回插入/更新的行
+ * - 标识符转义：双引号
+ * - JSON 操作符：->> 和 ->
+ * - 字符串连接：||
+ */
+export declare class PostgreSQLDialect implements ISqlDialect {
+    getReturningClause(): string;
+    getParameterPlaceholder(index: number): string;
+    escapeIdentifier(identifier: string): string;
+    getJsonExtractOperator(): string;
+    getConcatOperator(): string;
+    /**
+     * 生成批量插入 SQL（带 RETURNING）
+     * @param tableName - 表名
+     * @param columns - 列名数组
+     * @param rowCount - 行数
+     * @returns SQL 语句
+     */
+    generateBatchInsert(tableName: string, columns: string[], rowCount: number): string;
+    /**
+     * 生成批量更新 SQL（使用 UPDATE ... FROM 模式）
+     * @param tableName - 表名
+     * @param pkColumn - 主键列名
+     * @param updateColumns - 更新列名数组
+     * @returns SQL 模板
+     */
+    generateBatchUpdate(tableName: string, pkColumn: string, updateColumns: string[]): string;
+}
+/**
+ * 默认导出 PostgreSQL 方言实例
+ */
+export declare const pgDialect: PostgreSQLDialect;
+//# sourceMappingURL=sql_dialect.d.ts.map

package/dist/sql_dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql_dialect.d.ts","sourceRoot":"","sources":["../src/sql_dialect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,kBAAkB,IAAI,MAAM,CAAC;IAE7B;;;;OAIG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAE/C;;;;OAIG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAE7C;;;OAGG;IACH,sBAAsB,IAAI,MAAM,CAAC;IAEjC;;;OAGG;IACH,iBAAiB,IAAI,MAAM,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,kBAAkB,IAAI,MAAM;IAI5B,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI9C,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAM5C,sBAAsB,IAAI,MAAM;IAKhC,iBAAiB,IAAI,MAAM;IAI3B;;;;;;OAMG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAenF;;;;;;OAMG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM;CAY1F;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,mBAA0B,CAAC"}

package/dist/table/{create_sql.d.ts → create_table_sql.d.ts}

@@ -2,4 +2,4 @@ import { EntityMetadata } from '../../packages/rxdb/src/index.ts';
 import { RxDBAdapterPGlite } from '../RxDBAdapterPGlite.js';
 declare const _default: (adapter: RxDBAdapterPGlite, metadata: EntityMetadata) => string;
 export default _default;
-//# sourceMappingURL=create_sql.d.ts.map
+//# sourceMappingURL=create_table_sql.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create_table_sql.d.ts","sourceRoot":"","sources":["../../src/table/create_table_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA6E,MAAM,YAAY,CAAC;AAEvH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;yBAgM5C,SAAS,iBAAiB,EAAE,UAAU,cAAc;AAApE,wBAME"}

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

@@ -7,8 +7,6 @@ interface TriggerOptions {
     branchId?: string;
     /** 事务 ID (可选，用于事务内的变更追踪) */
     transactionId?: string;
-    /** 父变更 ID (用于分支管理) */
-    parentId?: number;
 }
 /**
  * 生成 PostgreSQL 触发器 SQL

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

@@ -1 +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;IACvB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,cAAc,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAoHzG;AAED,eAAe,oBAAoB,CAAC"}
+{"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"}