@aiao/rxdb-adapter-supabase 0.0.8 → 0.0.10

package/dist/RxDBAdapterSupabase.d.ts

@@ -1,5 +1,6 @@
-import { EntityType, IRepository, IRxDBAdapter, RemoteChange, RxDB, RxDBMutationsMap, SwitchVersionActions, RxDBAdapterRemoteBase } from '../packages/rxdb/src/index.ts';
+import { EntityType, IRepository, IRxDBAdapter, QueryCacheEntityMetadata, RemoteChange, RuleGroup, RxDB, RxDBMutationsMap, SwitchVersionActions, RxDBAdapterRemoteBase } from '../packages/rxdb/src/index.ts';
 import { SupabaseClient } from '@supabase/supabase-js';
+import { Observable } from 'rxjs';
 import { SupabaseAdapterOptions } from './supabase.interface.js';
 export declare const ADAPTER_NAME = "supabase";
 /**
@@ -49,12 +50,16 @@ export declare class RxDBAdapterSupabase extends RxDBAdapterRemoteBase implement
      * @param sinceId - 拉取此 ID 之后的变更（不包含该 ID）
      * @param limit - 最大拉取数量
      * @param repositoryFilter - 可选的实体过滤列表（用于 repository-level sync）
+     * @param filter - 可选的行级过滤条件（用于 SyncType.Filter）
      * @returns RxDBChange 记录数组，按 id ASC 排序
      *
      * @remarks
      * 使用 id 而非 createdAt 作为游标，避免同毫秒内多条记录导致的重复问题
+     *
+     * 当提供 filter 参数时，会通过 JOIN 实体表并应用过滤条件，
+     * 只返回满足条件的实体对应的变更记录。
      */
-    pullChanges(sinceId: number, limit?: number, repositoryFilter?: string[]): Promise<RemoteChange[]>;
+    pullChanges(sinceId: number, limit?: number, repositoryFilter?: string[], filter?: RuleGroup<any>): Promise<RemoteChange[]>;
     /**
      * 获取远程变更数量（轻量级，不下载数据）(T042, US2)
      *
@@ -95,6 +100,30 @@ export declare class RxDBAdapterSupabase extends RxDBAdapterRemoteBase implement
      * @param actions - 压缩后的变更操作集合
      */
     mergeChanges(actions: SwitchVersionActions): Promise<any>;
+    /**
+     * 获取实体元数据，用于新鲜度比较（QueryCache 专用）
+     *
+     * 只返回 `{ id, updatedAt }` 元数据，网络传输量比完整数据减少 90%+。
+     *
+     * @param entityName - 实体名称
+     * @param query - 查询条件
+     * @returns Observable<QueryCacheEntityMetadata[]>
+     *
+     * @example
+     * ```typescript
+     * adapter.fetchMetadata('Product', { combinator: 'and', rules: [{ field: 'status', operator: 'eq', value: 'active' }] })
+     *   .subscribe(metadata => console.log(metadata));
+     * ```
+     */
+    fetchMetadata(entityName: string, queryFilter: RuleGroup<unknown>): Observable<QueryCacheEntityMetadata[]>;
+    /**
+     * 按 ID 列表批量获取完整数据（QueryCache 专用）
+     *
+     * @param entityName - 实体名称
+     * @param ids - 需要获取的实体 ID 列表
+     * @returns Observable<T[]>
+     */
+    findByIds<T>(entityName: string, ids: string[]): Observable<T[]>;
     /** 获取带 schema 的客户端 */
     private getSchemaClient;
     /** 执行 upsert（非事务） */

package/dist/RxDBAdapterSupabase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RxDBAdapterSupabase.d.ts","sourceRoot":"","sources":["../src/RxDBAdapterSupabase.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,IAAI,EACJ,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAqB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAiC,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAIjE,eAAO,MAAM,YAAY,aAAa,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAoB,SAAQ,qBAAsB,YAAW,YAAY;;IAWlF,QAAQ,CAAC,OAAO,EAAE,sBAAsB;IAR1C,QAAQ,CAAC,IAAI,cAAgB;IAE7B,IAAI,MAAM,IAAI,cAAc,CAE3B;gBAGC,IAAI,EAAE,IAAI,EACD,OAAO,EAAE,sBAAsB;IAUpC,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IAiBhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAQhC;;OAEG;IACG,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAK7F;;OAEG;IACG,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAK/F;;;;;OAKG;IACG,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IA+B/F,aAAa,CAAC,CAAC,SAAS,UAAU,EAAE,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE;IAmB5F,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB9D;;;;;;;;;;OAUG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAa,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmC9G;;;;;;;;;;;;;;;;OAgBG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC;QACT,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IAmDF;;;;;;OAMG;IACG,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BhD;;;;;;;;;OASG;IACG,YAAY,CAAC,OAAO,EAAE,oBAAoB;IAyHhD,sBAAsB;IACtB,OAAO,CAAC,eAAe;IAIvB,qBAAqB;YACP,aAAa;IA0B3B,qBAAqB;YACP,aAAa;CAqB5B"}
+{"version":3,"file":"RxDBAdapterSupabase.d.ts","sourceRoot":"","sources":["../src/RxDBAdapterSupabase.ts"],"names":[],"mappings":"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"}

package/dist/SupabaseRepository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SupabaseRepository.d.ts","sourceRoot":"","sources":["../src/SupabaseRepository.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAqB,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGpE;;;GAGG;AACH,qBAAa,kBAAkB,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,CAAC;IAIrG,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,mBAAmB;IAHjD,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;gBAGvB,OAAO,EAAE,mBAAmB,EAC/C,UAAU,EAAE,CAAC;IAMf;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAsCnF;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,EAAE,cAAc,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IA2B1E;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAW/D;;OAEG;IACG,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;IAMhG;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAU/D,6CAA6C;IAC7C,OAAO,CAAC,uBAAuB;IAgC/B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAuBpC,qBAAqB;IACrB,OAAO,CAAC,sBAAsB;IAY9B,yBAAyB;IACzB,OAAO,CAAC,mBAAmB;IAI3B,0BAA0B;IAC1B,OAAO,CAAC,UAAU;CAGnB"}
+{"version":3,"file":"SupabaseRepository.d.ts","sourceRoot":"","sources":["../src/SupabaseRepository.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAqB,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGpE;;;GAGG;AACH,qBAAa,kBAAkB,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,CAAC;IAIrG,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,mBAAmB;IAHjD,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;gBAGvB,OAAO,EAAE,mBAAmB,EAC/C,UAAU,EAAE,CAAC;IAMf;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAsCnF;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,EAAE,cAAc,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IA2B1E;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAW/D;;OAEG;IACG,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;IAMhG;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAU/D,6CAA6C;IAC7C,OAAO,CAAC,uBAAuB;IAgC/B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAuBpC,qBAAqB;IACrB,OAAO,CAAC,sBAAsB;IAY9B,yBAAyB;IACzB,OAAO,CAAC,mBAAmB;IAI3B,0BAA0B;IAC1B,OAAO,CAAC,UAAU;CAGnB"}

package/dist/index.js

@@ -1,85 +1,54 @@
-import { EntityRemoteRemovedEvent as M, EntityRemoteUpdatedEvent as j, EntityRemoteCreatedEvent as O, getEntityMetadata as b, isRuleGroup as x, PropertyType as E, RepositoryBase as W, RxDBAdapterRemoteBase as U } from "@aiao/rxdb";
-import { createClient as K } from "@supabase/supabase-js";
+import { EntityRemoteRemovedEvent as O, EntityRemoteUpdatedEvent as W, EntityRemoteCreatedEvent as U, isRuleGroup as A, getEntityMetadata as b, PropertyType as E, RepositoryBase as K, RxDBAdapterRemoteBase as z } from "@aiao/rxdb";
+import { createClient as L } from "@supabase/supabase-js";
+import { defer as D, from as k, map as N, of as Q } from "rxjs";
 class S extends Error {
   constructor(t, e) {
     super(t), this.code = e, this.name = "SupabaseSyncError";
   }
 }
-class q extends S {
+class at extends S {
   constructor(t) {
     super(t, "CONFIG_ERROR"), this.name = "SupabaseConfigError";
   }
 }
-class tt extends S {
+class rt extends S {
   constructor(t) {
     super(t, "NETWORK_ERROR"), this.name = "SupabaseNetworkError";
   }
 }
-class g extends S {
+class m extends S {
   constructor(t) {
     super(t, "DATA_ERROR"), this.name = "SupabaseDataError";
   }
 }
-const z = {
-  INSERT: O,
-  UPDATE: j,
-  DELETE: M
+const V = {
+  INSERT: U,
+  UPDATE: W,
+  DELETE: O
 };
-function L(r, t) {
+function J(i, t) {
   if (t.table !== "RxDBChange" || t.eventType !== "INSERT") return;
   const e = t.new;
   if (!e) return;
-  const { namespace: s, entity: n, entityId: a, type: i, patch: c, clientId: o } = e, l = r.rxdb.context.clientId;
-  if (o && l && o === l || !a || !i) return;
-  const p = z[i];
-  if (!p) return;
-  const d = { id: a, ...c };
-  r.rxdb.dispatchEvent(
-    new p([
+  const { namespace: s, entity: n, entityId: a, type: r, patch: o, clientId: c } = e, d = i.rxdb.context.clientId;
+  if (c && d && c === d || !a || !r) return;
+  const u = V[r];
+  if (!u) return;
+  const l = { id: a, ...o };
+  i.rxdb.dispatchEvent(
+    new u([
       {
-        type: i,
+        type: r,
         namespace: s || "public",
         entity: n,
         id: a,
-        data: d,
+        data: l,
         recordAt: e.createdAt ? new Date(e.createdAt) : /* @__PURE__ */ new Date()
       }
     ])
   );
 }
-function D(r) {
-  const t = /* @__PURE__ */ new Map();
-  for (const e of r) {
-    const s = e.constructor;
-    t.has(s) || t.set(s, /* @__PURE__ */ new Set()), t.get(s).add(e);
-  }
-  return t;
-}
-function k(r, t) {
-  const e = [];
-  for (const [s, n] of r) {
-    const a = b(s), i = Array.from(n);
-    e.push({
-      table: a.name,
-      schema: a.namespace,
-      data: t ? i.map((c) => ({ ...c, createdBy: t, updatedBy: t })) : i
-    });
-  }
-  return e;
-}
-function Q(r) {
-  const t = [];
-  for (const [e, s] of r) {
-    const n = b(e);
-    t.push({
-      table: n.name,
-      schema: n.namespace,
-      ids: Array.from(s).map((a) => a.id)
-    });
-  }
-  return t;
-}
-const V = {
+const X = {
   "=": "eq",
   "!=": "neq",
   "<": "lt",
@@ -92,22 +61,22 @@ const V = {
   startsWith: "ilike",
   endsWith: "ilike"
 };
-function C(r) {
-  return r instanceof Date ? r.toISOString() : Array.isArray(r) ? r.map(C) : r;
+function C(i) {
+  return i instanceof Date ? i.toISOString() : Array.isArray(i) ? i.map(C) : i;
 }
-function T(r, t, e) {
-  return !t || !r.mappedEntity ? e : t.getEntityMetadata(r.mappedEntity, r.mappedNamespace ?? "") ?? e;
+function B(i, t, e) {
+  return !t || !i.mappedEntity ? e : t.getEntityMetadata(i.mappedEntity, i.mappedNamespace ?? "") ?? e;
 }
-function N(r, t) {
+function H(i, t) {
   const e = C(t);
-  switch (r) {
+  switch (i) {
     case "=":
     case "!=":
     case "<":
     case "<=":
     case ">":
     case ">=":
-      return `${V[r]}.${e}`;
+      return `${X[i]}.${e}`;
     case "in":
       if (!Array.isArray(e)) throw new Error("IN operator requires array");
       return `in.(${e.join(",")})`;
@@ -119,163 +88,192 @@ function N(r, t) {
     case "endsWith":
       return `ilike.*${e}`;
     default:
-      throw new Error(`Unsupported operator: ${r}`);
+      throw new Error(`Unsupported operator: ${i}`);
   }
 }
-function v(r, t, e) {
-  const [s, ...n] = r.split(".");
-  return n.length === 0 ? { field: r, operator: t, value: e } : {
+function F(i, t, e) {
+  const [s, ...n] = i.split(".");
+  return n.length === 0 ? { field: i, operator: t, value: e } : {
     field: s,
     operator: "exists",
-    where: { combinator: "and", rules: [v(n.join("."), t, e)] }
+    where: { combinator: "and", rules: [F(n.join("."), t, e)] }
   };
 }
-function A(r, t, e, s) {
-  if (!t?.rules?.length) return r;
+function $(i, t, e, s) {
+  if (!t?.rules?.length) return i;
   if (t.rules.length === 1) {
     const a = t.rules[0];
-    return x(a) ? A(r, a, e, s) : R(r, a, e, s);
+    return A(a) ? $(i, a, e, s) : I(i, a, e, s);
   }
   if (t.combinator === "and")
     return t.rules.reduce(
-      (a, i) => x(i) ? A(a, i, e, s) : R(a, i, e, s),
-      r
+      (a, r) => A(r) ? $(a, r, e, s) : I(a, r, e, s),
+      i
     );
   const n = t.rules.map((a) => {
-    if (x(a)) throw new Error("Nested OR conditions not supported");
-    const { field: i, operator: c, value: o } = a;
-    return `${i}.${N(c, o)}`;
+    if (A(a)) throw new Error("Nested OR conditions not supported");
+    const { field: r, operator: o, value: c } = a;
+    return `${r}.${H(o, c)}`;
   });
-  return r.or(n.join(","));
+  return i.or(n.join(","));
 }
-function R(r, t, e, s) {
-  const { field: n, operator: a, value: i } = t;
-  return typeof n == "string" && n.includes(".") ? R(r, v(n, a, i), e, s) : a === "exists" || a === "notExists" ? J(r, t, e, s) : B(r, n, a, i);
+function I(i, t, e, s) {
+  const { field: n, operator: a, value: r } = t;
+  return typeof n == "string" && n.includes(".") ? I(i, F(n, a, r), e, s) : a === "exists" || a === "notExists" ? Y(i, t, e, s) : M(i, n, a, r);
 }
-function J(r, t, e, s) {
-  const { field: n, operator: a } = t, i = t.where, c = String(n), o = e?.relationMap?.get(c);
-  if (!o)
-    throw new Error(`Relation '${c}' not found in '${e?.name || "unknown"}'`);
-  const l = o.mappedEntity;
-  if (!i?.rules?.length)
-    return a === "exists" ? r.not(l, "is", null) : r.is(l, null);
-  const p = e ? T(o, s, e) : void 0;
-  if (!p) throw new Error(`Cannot resolve metadata for '${c}'`);
-  return I(r, l, i, p, s, l);
+function Y(i, t, e, s) {
+  const { field: n, operator: a } = t, r = t.where, o = String(n), c = e?.relationMap?.get(o);
+  if (!c)
+    throw new Error(`Relation '${o}' not found in '${e?.name || "unknown"}'`);
+  const d = c.mappedEntity;
+  if (!r?.rules?.length)
+    return a === "exists" ? i.not(d, "is", null) : i.is(d, null);
+  const u = e ? B(c, s, e) : void 0;
+  if (!u) throw new Error(`Cannot resolve metadata for '${o}'`);
+  return R(i, d, r, u, s, d);
 }
-function I(r, t, e, s, n, a = "") {
-  if (!e?.rules?.length) return r;
-  let i = r;
-  for (const c of e.rules) {
-    if (x(c)) {
-      i = I(i, t, c, s, n, a);
+function R(i, t, e, s, n, a = "") {
+  if (!e?.rules?.length) return i;
+  let r = i;
+  for (const o of e.rules) {
+    if (A(o)) {
+      r = R(r, t, o, s, n, a);
       continue;
     }
-    const { field: o, operator: l, value: p } = c;
-    if (l === "exists" || l === "notExists") {
-      const f = s?.relationMap?.get(String(o));
-      if (!f) throw new Error(`Relation '${o}' not found in ${t}`);
-      const h = f.mappedEntity, u = c.where, w = T(f, n, s);
-      if (u?.rules?.length) {
-        const m = a ? `${a}.${h}` : h;
-        i = I(i, h, u, w, n, m);
+    const { field: c, operator: d, value: u } = o;
+    if (d === "exists" || d === "notExists") {
+      const p = s?.relationMap?.get(String(c));
+      if (!p) throw new Error(`Relation '${c}' not found in ${t}`);
+      const f = p.mappedEntity, h = o.where, y = B(p, n, s);
+      if (h?.rules?.length) {
+        const g = a ? `${a}.${f}` : f;
+        r = R(r, f, h, y, n, g);
       } else
-        i = l === "exists" ? i.not(h, "is", null) : i.is(h, null);
+        r = d === "exists" ? r.not(f, "is", null) : r.is(f, null);
       continue;
     }
-    const d = a ? `${a}.${o}` : `${t}.${o}`;
-    i = B(i, d, l, p);
+    const l = a ? `${a}.${c}` : `${t}.${c}`;
+    r = M(r, l, d, u);
   }
-  return i;
+  return r;
 }
-function B(r, t, e, s) {
+function M(i, t, e, s) {
   const n = C(s);
-  if (t.includes(".")) {
-    if (!r.url?.searchParams)
-      throw new Error("Cannot apply nested filter: query.url.searchParams unavailable");
-    if (e === "between") {
-      const [i, c] = n;
-      return r.url.searchParams.append(t, `gte.${i}`), r.url.searchParams.append(t, `lte.${c}`), r;
-    }
-    return r.url.searchParams.append(t, N(e, n)), r;
+  if (t.includes(".") && e === "between") {
+    const [r, o] = n;
+    return i.gte(t, r).lte(t, o);
   }
   switch (e) {
     case "=":
-      return n === null ? r.is(t, null) : r.eq(t, n);
+      return n === null ? i.is(t, null) : i.eq(t, n);
     case "!=":
-      return n === null ? r.not(t, "is", null) : r.neq(t, n);
+      return n === null ? i.not(t, "is", null) : i.neq(t, n);
     case "<":
-      return r.lt(t, n);
+      return i.lt(t, n);
     case ">":
-      return r.gt(t, n);
+      return i.gt(t, n);
     case "<=":
-      return r.lte(t, n);
+      return i.lte(t, n);
     case ">=":
-      return r.gte(t, n);
+      return i.gte(t, n);
     case "in":
-      return r.in(t, n);
+      return i.in(t, n);
     case "notIn":
-      return r.not(t, "in", `(${n.join(",")})`);
+      return i.not(t, "in", `(${n.join(",")})`);
     case "contains":
     case "includes":
-      return r.ilike(t, `%${n}%`);
+      return i.ilike(t, `%${n}%`);
     case "notContains":
-      return r.not(t, "ilike", `%${n}%`);
+      return i.not(t, "ilike", `%${n}%`);
     case "startsWith":
-      return r.ilike(t, `${n}%`);
+      return i.ilike(t, `${n}%`);
     case "notStartsWith":
-      return r.not(t, "ilike", `${n}%`);
+      return i.not(t, "ilike", `${n}%`);
     case "endsWith":
-      return r.ilike(t, `%${n}`);
+      return i.ilike(t, `%${n}`);
     case "notEndsWith":
-      return r.not(t, "ilike", `%${n}`);
+      return i.not(t, "ilike", `%${n}`);
     case "between": {
-      const [i, c] = n;
-      return r.gte(t, i).lte(t, c);
+      const [r, o] = n;
+      return i.gte(t, r).lte(t, o);
     }
     case "notBetween": {
-      const [i, c] = n;
-      return r.or(`${t}.lt.${i},${t}.gt.${c}`);
+      const [r, o] = n;
+      return i.or(`${t}.lt.${r},${t}.gt.${o}`);
     }
+    case "null":
     case "isNull":
-      return r.is(t, null);
+      return i.is(t, null);
+    case "notNull":
     case "isNotNull":
-      return r.not(t, "is", null);
+      return i.not(t, "is", null);
     default:
       throw new Error(`Unsupported operator: ${e}`);
   }
 }
-function P(r, t) {
-  if (r == null) return r;
+function T(i) {
+  const t = /* @__PURE__ */ new Map();
+  for (const e of i) {
+    const s = e.constructor;
+    t.has(s) || t.set(s, /* @__PURE__ */ new Set()), t.get(s).add(e);
+  }
+  return t;
+}
+function v(i, t) {
+  const e = [];
+  for (const [s, n] of i) {
+    const a = b(s), r = Array.from(n);
+    e.push({
+      table: a.name,
+      schema: a.namespace,
+      data: t ? r.map((o) => ({ ...o, createdBy: t, updatedBy: t })) : r
+    });
+  }
+  return e;
+}
+function Z(i) {
+  const t = [];
+  for (const [e, s] of i) {
+    const n = b(e);
+    t.push({
+      table: n.name,
+      schema: n.namespace,
+      ids: Array.from(s).map((a) => a.id)
+    });
+  }
+  return t;
+}
+function j(i, t) {
+  if (i == null) return i;
   switch (t.type) {
     case E.date:
-      return r instanceof Date ? r : new Date(r);
+      return i instanceof Date ? i : new Date(i);
     case E.keyValue:
-      if (typeof r == "object" && t.properties) {
+      if (typeof i == "object" && t.properties) {
         const e = {};
         for (const s of t.properties)
-          r[s.name] !== void 0 && (e[s.name] = P(r[s.name], s));
+          i[s.name] !== void 0 && (e[s.name] = j(i[s.name], s));
         return e;
       }
-      return r;
+      return i;
     case E.boolean:
-      return !!r;
+      return !!i;
     case E.json:
     case E.stringArray:
     case E.numberArray:
     default:
-      return r;
+      return i;
   }
 }
-function X(r, t, e) {
-  const s = new r();
+function G(i, t, e) {
+  const s = new i();
   for (const n of Object.keys(e)) {
     const a = t.propertyMap.get(n);
-    s[n] = a ? P(e[n], a) : e[n];
+    s[n] = a ? j(e[n], a) : e[n];
   }
   return s;
 }
-class F extends W {
+class P extends K {
   constructor(t, e) {
     super(t.rxdb, e), this.adapter = t, this.metadata = b(e);
   }
@@ -287,22 +285,22 @@ class F extends W {
     const e = this.extract_relation_fields(t.where);
     let s = "*";
     if (e.size > 0) {
-      const c = Array.from(e);
-      s = `*, ${c.filter(
-        (l) => !c.some((p) => p !== l && p.startsWith(l + "."))
-      ).map((l) => this.build_relation_select(l)).join(", ")}`;
+      const o = Array.from(e);
+      s = `*, ${o.filter(
+        (d) => !o.some((u) => u !== d && u.startsWith(d + "."))
+      ).map((d) => this.build_relation_select(d)).join(", ")}`;
     }
     let n = this.get_client().select(s);
-    if (n = A(n, t.where, this.metadata, this.adapter.rxdb.schemaManager), t.orderBy?.length)
-      for (const c of t.orderBy)
-        n = n.order(c.field, { ascending: c.sort === "asc" });
+    if (n = $(n, t.where, this.metadata, this.adapter.rxdb.schemaManager), t.orderBy?.length)
+      for (const o of t.orderBy)
+        n = n.order(o.field, { ascending: o.sort === "asc" });
     if (t.offset !== void 0) {
-      const c = t.offset, o = t.limit !== void 0 ? c + t.limit - 1 : Number.MAX_SAFE_INTEGER;
-      n = n.range(c, o);
+      const o = t.offset, c = t.limit !== void 0 ? o + t.limit - 1 : Number.MAX_SAFE_INTEGER;
+      n = n.range(o, c);
     } else t.limit !== void 0 && (n = n.limit(t.limit));
-    const { data: a, error: i } = await n;
-    if (i) throw new g(`Failed to find entities: ${i.message}`);
-    return (a || []).map((c) => X(this.EntityType, this.metadata, c));
+    const { data: a, error: r } = await n;
+    if (r) throw new m(`Failed to find entities: ${r.message}`);
+    return (a || []).map((o) => G(this.EntityType, this.metadata, o));
   }
   /**
    * 查询实体数量
@@ -311,14 +309,14 @@ class F extends W {
     if (t.groupBy) throw new Error("groupBy not supported yet");
     const e = this.extract_relation_fields(t.where);
     let s = "*";
-    e.size > 0 && (s = `*, ${Array.from(e).map((c) => this.build_relation_select(c)).join(", ")}`);
+    e.size > 0 && (s = `*, ${Array.from(e).map((o) => this.build_relation_select(o)).join(", ")}`);
     let n = this.get_client().select(s, { count: "exact", head: !0 });
-    n = A(n, t.where, this.metadata, this.adapter.rxdb.schemaManager);
-    const { count: a, error: i } = await n;
-    if (i) {
-      if (!i.message)
+    n = $(n, t.where, this.metadata, this.adapter.rxdb.schemaManager);
+    const { count: a, error: r } = await n;
+    if (r) {
+      if (!r.message)
         return console.warn("Supabase count returned empty error, returning 0. Options:", JSON.stringify(t)), 0;
-      throw new g(`Failed to count entities: ${i.message}`);
+      throw new m(`Failed to count entities: ${r.message}`);
     }
     return a ?? 0;
   }
@@ -329,7 +327,7 @@ class F extends W {
     const e = { ...t }, s = this.rxdb.context.userId;
     s && (e.createdBy = s);
     const { data: n, error: a } = await this.get_client().insert(e).select().single();
-    if (a) throw new g(`Failed to create entity: ${a.message}`);
+    if (a) throw new m(`Failed to create entity: ${a.message}`);
     return n;
   }
   /**
@@ -337,7 +335,7 @@ class F extends W {
    */
   async update(t, e) {
     const { data: s, error: n } = await this.get_client().update(e).eq("id", t.id).select().single();
-    if (n) throw new g(`Failed to update entity: ${n.message}`);
+    if (n) throw new m(`Failed to update entity: ${n.message}`);
     return s;
   }
   /**
@@ -347,7 +345,7 @@ class F extends W {
    */
   async remove(t) {
     const { error: e } = await this.get_client().delete().eq("id", t.id);
-    if (e) throw new g(`Failed to remove entity: ${e.message}`);
+    if (e) throw new m(`Failed to remove entity: ${e.message}`);
     return t;
   }
   // ============================================
@@ -357,18 +355,18 @@ class F extends W {
   extract_relation_fields(t) {
     const e = /* @__PURE__ */ new Set(), s = (n, a = "") => {
       if (n?.rules) {
-        for (const i of n.rules)
-          if (i.rules)
-            s(i, a);
-          else if (typeof i.field == "string" && i.field.includes(".")) {
-            const c = i.field.split(".");
-            for (let o = 1; o < c.length; o++) {
-              const l = c.slice(0, o).join(".");
-              e.add(a ? `${a}.${l}` : l);
+        for (const r of n.rules)
+          if (r.rules)
+            s(r, a);
+          else if (typeof r.field == "string" && r.field.includes(".")) {
+            const o = r.field.split(".");
+            for (let c = 1; c < o.length; c++) {
+              const d = o.slice(0, c).join(".");
+              e.add(a ? `${a}.${d}` : d);
             }
-          } else if (i.operator === "exists" || i.operator === "notExists") {
-            const c = String(i.field), o = a ? `${a}.${c}` : c;
-            this.metadata.relationMap?.has(c) && e.add(o), i.where && s(i.where, o);
+          } else if (r.operator === "exists" || r.operator === "notExists") {
+            const o = String(r.field), c = a ? `${a}.${o}` : o;
+            this.metadata.relationMap?.has(o) && e.add(c), r.where && s(r.where, c);
           }
       }
     };
@@ -383,16 +381,16 @@ class F extends W {
     if (e.length === 1) return this.build_single_relation_select(e[0]);
     const s = [];
     let n = this.metadata;
-    for (const i of e) {
-      const c = n.relationMap?.get(i);
-      if (!c) return `${i}(id)`;
-      s.push({ tableName: c.mappedEntity, kind: c.kind, sourceEntity: n.name });
-      const o = this.adapter.rxdb.schemaManager.getEntityMetadata(c.mappedEntity, c.mappedNamespace ?? "");
-      o && (n = o);
+    for (const r of e) {
+      const o = n.relationMap?.get(r);
+      if (!o) return `${r}(id)`;
+      s.push({ tableName: o.mappedEntity, kind: o.kind, sourceEntity: n.name });
+      const c = this.adapter.rxdb.schemaManager.getEntityMetadata(o.mappedEntity, o.mappedNamespace ?? "");
+      c && (n = c);
     }
     let a = this.build_relation_segment(s[s.length - 1], !0);
-    for (let i = s.length - 2; i >= 0; i--)
-      a = this.build_relation_segment(s[i], !0).replace("(*)", `(*, ${a})`);
+    for (let r = s.length - 2; r >= 0; r--)
+      a = this.build_relation_segment(s[r], !0).replace("(*)", `(*, ${a})`);
     return a;
   }
   /**
@@ -431,7 +429,7 @@ class F extends W {
     return this.adapter.client.schema(this.metadata.namespace).from(this.metadata.name);
   }
 }
-class H extends F {
+class q extends P {
   constructor(t, e) {
     super(t, e);
   }
@@ -450,9 +448,9 @@ class H extends F {
     if (a) {
       if (a.message.includes("function") || a.message.includes("Could not find"))
         return this.findDescendantsFallback(t);
-      throw new g(`Failed to find descendants: ${a.message}`);
+      throw new m(`Failed to find descendants: ${a.message}`);
     }
-    return (n || []).map((i) => this.transformRowToEntity(i));
+    return (n || []).map((r) => this.transformRowToEntity(r));
   }
   /**
    * 查询子孙节点数量
@@ -482,9 +480,9 @@ class H extends F {
     if (a) {
       if (a.message.includes("function") || a.message.includes("Could not find"))
         return this.findAncestorsFallback(t);
-      throw new g(`Failed to find ancestors: ${a.message}`);
+      throw new m(`Failed to find ancestors: ${a.message}`);
     }
-    return (n || []).map((i) => this.transformRowToEntity(i));
+    return (n || []).map((r) => this.transformRowToEntity(r));
   }
   /**
    * 查询祖先节点数量
@@ -504,28 +502,28 @@ class H extends F {
    * 优化方案：一次查询获取所有节点，在内存中构建树结构。
    */
   async findDescendantsFallback(t) {
-    const { entityId: e, level: s = 100 } = t, n = this.metadata.name, a = this.metadata.features?.tree?.hasChildren, i = [], c = /* @__PURE__ */ new Set();
-    let o = this.adapter.client.schema("public").from(n).select("*");
-    e ? o = o.eq("id", e) : o = o.is("parentId", null);
-    const { data: l, error: p } = await o;
-    if (p)
-      throw new g(`Failed to find start nodes: ${p.message}`);
-    const d = async (f, h) => {
-      for (const u of f) {
-        if (c.has(u.id) || h > s) continue;
-        c.add(u.id);
-        const w = this.transformRowToEntity(u);
+    const { entityId: e, level: s = 100 } = t, n = this.metadata.name, a = this.metadata.features?.tree?.hasChildren, r = [], o = /* @__PURE__ */ new Set();
+    let c = this.adapter.client.schema("public").from(n).select("*");
+    e ? c = c.eq("id", e) : c = c.is("parentId", null);
+    const { data: d, error: u } = await c;
+    if (u)
+      throw new m(`Failed to find start nodes: ${u.message}`);
+    const l = async (p, f) => {
+      for (const h of p) {
+        if (o.has(h.id) || f > s) continue;
+        o.add(h.id);
+        const y = this.transformRowToEntity(h);
         if (a) {
-          const { count: m } = await this.adapter.client.schema("public").from(n).select("*", { count: "exact", head: !0 }).eq("parentId", u.id);
-          w.hasChildren = (m || 0) > 0;
+          const { count: g } = await this.adapter.client.schema("public").from(n).select("*", { count: "exact", head: !0 }).eq("parentId", h.id);
+          y.hasChildren = (g || 0) > 0;
         }
-        if (i.push(w), h < s) {
-          const { data: m } = await this.adapter.client.schema("public").from(n).select("*").eq("parentId", u.id);
-          m && m.length > 0 && await d(m, h + 1);
+        if (r.push(y), f < s) {
+          const { data: g } = await this.adapter.client.schema("public").from(n).select("*").eq("parentId", h.id);
+          g && g.length > 0 && await l(g, f + 1);
         }
       }
     };
-    return await d(l || [], 0), i;
+    return await l(d || [], 0), r;
   }
   /**
    * 备用的祖先节点查询（不使用存储函数）
@@ -537,20 +535,20 @@ class H extends F {
     const { entityId: e, level: s = 100 } = t;
     if (!e)
       return [];
-    const n = this.metadata.name, a = this.metadata.features?.tree?.hasChildren, i = [];
-    let c = e, o = 0;
-    for (; c && o <= s; ) {
-      const { data: l, error: p } = await this.adapter.client.schema("public").from(n).select("*").eq("id", c);
-      if (p || !l || l.length === 0)
+    const n = this.metadata.name, a = this.metadata.features?.tree?.hasChildren, r = [];
+    let o = e, c = 0;
+    for (; o && c <= s; ) {
+      const { data: d, error: u } = await this.adapter.client.schema("public").from(n).select("*").eq("id", o);
+      if (u || !d || d.length === 0)
         break;
-      const d = l[0], f = this.transformRowToEntity(d);
+      const l = d[0], p = this.transformRowToEntity(l);
       if (a) {
-        const { count: h } = await this.adapter.client.schema("public").from(n).select("*", { count: "exact", head: !0 }).eq("parentId", d.id);
-        f.hasChildren = (h || 0) > 0;
+        const { count: f } = await this.adapter.client.schema("public").from(n).select("*", { count: "exact", head: !0 }).eq("parentId", l.id);
+        p.hasChildren = (f || 0) > 0;
       }
-      i.push(f), c = d.parentId, o++;
+      r.push(p), o = l.parentId, c++;
     }
-    return i;
+    return r;
   }
   /**
    * 将数据库行转换为实体
@@ -562,14 +560,14 @@ class H extends F {
     }), e;
   }
 }
-const Y = "supabase";
-class et extends U {
+const tt = "supabase";
+class it extends z {
   constructor(t, e) {
-    super(t), this.options = e, this.#t = e.client ?? K(e.supabaseUrl, e.supabaseKey);
+    super(t), this.options = e, this.#t = e.client ?? L(e.supabaseUrl, e.supabaseKey);
   }
   #t;
   #e = null;
-  name = Y;
+  name = tt;
   get client() {
     return this.#t;
   }
@@ -580,7 +578,7 @@ class et extends U {
     return this.#e || (this.#e = this.#t.channel("rxdb-changes").on(
       "postgres_changes",
       { event: "INSERT", schema: "public", table: "RxDBChange" },
-      (t) => L(this, t)
+      (t) => J(this, t)
     ).subscribe((t, e) => {
       e && console.error("Supabase Realtime subscription failed:", e);
     })), this;
@@ -598,13 +596,13 @@ class et extends U {
    * 批量保存实体（upsert 语义，非事务）
    */
   async saveMany(t) {
-    return t.length === 0 ? [] : this.executeUpsert(D(t));
+    return t.length === 0 ? [] : this.executeUpsert(T(t));
   }
   /**
    * 批量删除实体（非事务）
    */
   async removeMany(t) {
-    return t.length === 0 ? [] : this.executeDelete(D(t));
+    return t.length === 0 ? [] : this.executeDelete(T(t));
   }
   /**
    * 批量修改实体（事务）
@@ -613,16 +611,16 @@ class et extends U {
    * 在单个数据库事务中执行所有操作，确保原子性。
    */
   async mutations(t) {
-    const e = this.rxdb.context.userId, s = [...k(t.create, e), ...k(t.update, e)], n = Q(t.remove), { data: a, error: i } = await this.#t.rpc("rxdb_mutations", {
+    const e = this.rxdb.context.userId, s = [...v(t.create, e), ...v(t.update, e)], n = Z(t.remove), { data: a, error: r } = await this.#t.rpc("rxdb_mutations", {
       p_upserts: s,
       p_deletes: n
     });
-    if (i)
-      throw new g(`Transaction failed: ${i.message}`);
-    const c = a?.upserted ?? [];
-    for (const [, o] of t.remove)
-      c.push(...o);
-    return c;
+    if (r)
+      throw new m(`Transaction failed: ${r.message}`);
+    const o = a?.upserted ?? [];
+    for (const [, c] of t.remove)
+      o.push(...c);
+    return o;
   }
   // ============================================
   // Repository
@@ -630,7 +628,7 @@ class et extends U {
   getRepository(t) {
     if (this.repository_cache.has(t))
       return this.repository_cache.get(t);
-    const s = b(t).features?.tree ? new H(this, t) : new F(this, t);
+    const s = b(t).features?.tree ? new q(this, t) : new P(this, t);
     return this.repository_cache.set(t, s), s;
   }
   // ============================================
@@ -640,7 +638,7 @@ class et extends U {
     const e = b(t), n = await this.getSchemaClient(e.namespace).from(e.name).select("*", { count: "exact", head: !0 });
     if (n.status === 200) return !0;
     if (n.status === 204) return !1;
-    throw new g(
+    throw new m(
       `Failed to check table existence: ${n.error?.message || `status ${n.status}`}`
     );
   }
@@ -653,24 +651,34 @@ class et extends U {
    * @param sinceId - 拉取此 ID 之后的变更（不包含该 ID）
    * @param limit - 最大拉取数量
    * @param repositoryFilter - 可选的实体过滤列表（用于 repository-level sync）
+   * @param filter - 可选的行级过滤条件（用于 SyncType.Filter）
    * @returns RxDBChange 记录数组，按 id ASC 排序
    *
    * @remarks
    * 使用 id 而非 createdAt 作为游标，避免同毫秒内多条记录导致的重复问题
+   *
+   * 当提供 filter 参数时，会通过 JOIN 实体表并应用过滤条件，
+   * 只返回满足条件的实体对应的变更记录。
    */
-  async pullChanges(t, e = 1e3, s) {
-    const n = [];
-    let a = this.#t.from("RxDBChange").select("*").gt("id", t).order("id", { ascending: !0 }).limit(e);
-    s && s.length > 0 && (a = a.in("entity", s));
-    const { data: i, error: c } = await a;
-    if (c)
-      throw new g(`Failed to pull changes: ${c.message}`);
-    const o = (i ?? []).map((l) => ({
+  async pullChanges(t, e = 1e3, s, n) {
+    const a = [];
+    let r;
+    if (n && s?.length === 1) {
+      const l = s[0];
+      if (r = await this.#n(l, n), r.length === 0)
+        return [];
+    }
+    let o = this.#t.from("RxDBChange").select("*").gt("id", t).order("id", { ascending: !0 }).limit(e);
+    s && s.length > 0 && (o = o.in("entity", s)), r && (o = o.in("entityId", r));
+    const { data: c, error: d } = await o;
+    if (d)
+      throw new m(`Failed to pull changes: ${d.message}`);
+    const u = (c ?? []).map((l) => ({
       ...l,
       createdAt: new Date(l.createdAt),
       updatedAt: l.updatedAt ? new Date(l.updatedAt) : null
     }));
-    return n.push(...o), n;
+    return a.push(...u), a;
   }
   /**
    * 获取远程变更数量（轻量级，不下载数据）(T042, US2)
@@ -694,19 +702,19 @@ class et extends U {
     e && e.length > 0 && (s = s.in("entity", e));
     const { count: n, error: a } = await s;
     if (a)
-      throw new g(`Failed to get change count: ${a.message}`);
-    let i = t;
+      throw new m(`Failed to get change count: ${a.message}`);
+    let r = t;
     if (n && n > 0) {
-      let c = this.#t.from("RxDBChange").select("id").gt("id", t).order("id", { ascending: !1 }).limit(1);
-      e && e.length > 0 && (c = c.in("entity", e));
-      const { data: o, error: l } = await c;
-      if (l)
-        throw new g(`Failed to get latest changeId: ${l.message}`);
-      o && o.length > 0 && (i = o[0].id);
+      let o = this.#t.from("RxDBChange").select("id").gt("id", t).order("id", { ascending: !1 }).limit(1);
+      e && e.length > 0 && (o = o.in("entity", e));
+      const { data: c, error: d } = await o;
+      if (d)
+        throw new m(`Failed to get latest changeId: ${d.message}`);
+      c && c.length > 0 && (r = c[0].id);
     }
     return {
       count: n ?? 0,
-      latestChangeId: i
+      latestChangeId: r
     };
   }
   /**
@@ -724,17 +732,17 @@ class et extends U {
       deletes: /* @__PURE__ */ new Map()
     };
     for (const s of t) {
-      const { entityKey: n, finalType: a, finalPatch: i, inversePatch: c } = s;
+      const { entityKey: n, finalType: a, finalPatch: r, inversePatch: o } = s;
       if (a)
         switch (a) {
           case "INSERT":
-            e.inserts.set(n, { patch: i, inversePatch: c });
+            e.inserts.set(n, { patch: r, inversePatch: o });
             break;
           case "UPDATE":
-            e.updates.set(n, { patch: i, inversePatch: c });
+            e.updates.set(n, { patch: r, inversePatch: o });
             break;
           case "DELETE":
-            e.deletes.set(n, { patch: null, inversePatch: c });
+            e.deletes.set(n, { patch: null, inversePatch: o });
             break;
         }
     }
@@ -751,70 +759,119 @@ class et extends U {
    * @param actions - 压缩后的变更操作集合
    */
   async mergeChanges(t) {
-    const e = (/* @__PURE__ */ new Date()).toISOString(), s = this.rxdb.context.userId, n = [], a = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map();
-    for (const [d, { inversePatch: f }] of t.deletes) {
-      const [h, u, w] = d.split(":"), m = h ? `${h}.${u}` : u;
+    const e = (/* @__PURE__ */ new Date()).toISOString(), s = this.rxdb.context.userId, n = [], a = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map();
+    for (const [l, { inversePatch: p }] of t.deletes) {
+      const [f, h, y] = l.split(":"), g = f ? `${f}.${h}` : h;
       n.push({
-        namespace: h || "public",
-        entity: u,
-        entityId: w,
+        namespace: f || "public",
+        entity: h,
+        entityId: y,
         type: "DELETE",
         patch: null,
-        inversePatch: f,
+        inversePatch: p,
         clientId: this.rxdb.context.clientId,
         createdAt: e,
         updatedAt: e
       });
-      const y = i.get(m) ?? [];
-      y.push(w), i.set(m, y);
+      const w = r.get(g) ?? [];
+      w.push(y), r.set(g, w);
     }
-    for (const [d, { patch: f, inversePatch: h }] of t.updates) {
-      const [u, w, m] = d.split(":"), y = u ? `${u}.${w}` : w;
+    for (const [l, { patch: p, inversePatch: f }] of t.updates) {
+      const [h, y, g] = l.split(":"), w = h ? `${h}.${y}` : y;
       n.push({
-        namespace: u || "public",
-        entity: w,
-        entityId: m,
+        namespace: h || "public",
+        entity: y,
+        entityId: g,
         type: "UPDATE",
-        patch: f,
-        inversePatch: h,
+        patch: p,
+        inversePatch: f,
         clientId: this.rxdb.context.clientId,
         createdAt: e,
         updatedAt: e
       });
-      const $ = a.get(y) ?? [], _ = { id: m, ...f };
-      s && (_.updatedBy = s), $.push(_), a.set(y, $);
+      const x = a.get(w) ?? [], _ = { id: g, ...p };
+      s && (_.updatedBy = s), x.push(_), a.set(w, x);
     }
-    for (const [d, { patch: f, inversePatch: h }] of t.inserts) {
-      const [u, w, m] = d.split(":"), y = u ? `${u}.${w}` : w;
+    for (const [l, { patch: p, inversePatch: f }] of t.inserts) {
+      const [h, y, g] = l.split(":"), w = h ? `${h}.${y}` : y;
       n.push({
-        namespace: u || "public",
-        entity: w,
-        entityId: m,
+        namespace: h || "public",
+        entity: y,
+        entityId: g,
         type: "INSERT",
-        patch: f,
-        inversePatch: h,
+        patch: p,
+        inversePatch: f,
         clientId: this.rxdb.context.clientId,
         createdAt: e,
         updatedAt: e
       });
-      const $ = a.get(y) ?? [], _ = { id: m, ...f };
-      s && (_.createdBy = s, _.updatedBy = s), $.push(_), a.set(y, $);
+      const x = a.get(w) ?? [], _ = { id: g, ...p };
+      s && (_.createdBy = s, _.updatedBy = s), x.push(_), a.set(w, x);
     }
-    const c = Array.from(a.entries()).map(([d, f]) => {
-      const [h, u] = d.includes(".") ? d.split(".") : ["public", d];
-      return { table: u, schema: h, data: f };
-    }), o = Array.from(i.entries()).map(([d, f]) => {
-      const [h, u] = d.includes(".") ? d.split(".") : ["public", d];
-      return { table: u, schema: h, ids: f };
-    }), { data: l, error: p } = await this.#t.rpc("rxdb_mutations", {
-      p_upserts: c,
-      p_deletes: o,
+    const o = Array.from(a.entries()).map(([l, p]) => {
+      const [f, h] = l.includes(".") ? l.split(".") : ["public", l];
+      return { table: h, schema: f, data: p };
+    }), c = Array.from(r.entries()).map(([l, p]) => {
+      const [f, h] = l.includes(".") ? l.split(".") : ["public", l];
+      return { table: h, schema: f, ids: p };
+    }), { data: d, error: u } = await this.#t.rpc("rxdb_mutations", {
+      p_upserts: o,
+      p_deletes: c,
       p_changes: n,
       p_skip_sync: !0
     });
-    if (p)
-      throw new g(`Failed to merge changes: ${p.message}`);
-    return l?.max_change_id ?? void 0;
+    if (u)
+      throw new m(`Failed to merge changes: ${u.message}`);
+    return d?.max_change_id ?? void 0;
+  }
+  // ============================================
+  // QueryCache 方法
+  // ============================================
+  /**
+   * 获取实体元数据，用于新鲜度比较（QueryCache 专用）
+   *
+   * 只返回 `{ id, updatedAt }` 元数据，网络传输量比完整数据减少 90%+。
+   *
+   * @param entityName - 实体名称
+   * @param query - 查询条件
+   * @returns Observable<QueryCacheEntityMetadata[]>
+   *
+   * @example
+   * ```typescript
+   * adapter.fetchMetadata('Product', { combinator: 'and', rules: [{ field: 'status', operator: 'eq', value: 'active' }] })
+   *   .subscribe(metadata => console.log(metadata));
+   * ```
+   */
+  fetchMetadata(t, e) {
+    return D(() => {
+      let s = this.#t.from(t).select("id, updatedAt");
+      return s = $(s, e), k(s).pipe(
+        N(({ data: n, error: a }) => {
+          if (a)
+            throw new m(`Failed to fetch metadata: ${a.message}`);
+          return (n ?? []).map((r) => ({
+            id: r.id,
+            updatedAt: r.updatedAt
+          }));
+        })
+      );
+    });
+  }
+  /**
+   * 按 ID 列表批量获取完整数据（QueryCache 专用）
+   *
+   * @param entityName - 实体名称
+   * @param ids - 需要获取的实体 ID 列表
+   * @returns Observable<T[]>
+   */
+  findByIds(t, e) {
+    return D(() => e.length === 0 ? Q([]) : k(this.#t.from(t).select("*").in("id", e)).pipe(
+      N(({ data: s, error: n }) => {
+        if (n)
+          throw new m(`Failed to find by ids: ${n.message}`);
+        return s ?? [];
+      })
+    ));
   }
   // ============================================
   // 私有方法
@@ -827,10 +884,10 @@ class et extends U {
   async executeUpsert(t) {
     const e = [], s = this.rxdb.context.userId;
     for (const [n, a] of t) {
-      const i = b(n), c = this.getSchemaClient(i.namespace), o = Array.from(a), l = s ? o.map((f) => ({ ...f, createdBy: s, updatedBy: s })) : o, { data: p, error: d } = await c.from(i.name).upsert(l).select();
-      if (d)
-        throw new g(`Failed to upsert: ${d.message}`);
-      e.push(...p);
+      const r = b(n), o = this.getSchemaClient(r.namespace), c = Array.from(a), d = s ? c.map((p) => ({ ...p, createdBy: s, updatedBy: s })) : c, { data: u, error: l } = await o.from(r.name).upsert(d).select();
+      if (l)
+        throw new m(`Failed to upsert: ${l.message}`);
+      e.push(...u);
     }
     return e;
   }
@@ -838,21 +895,36 @@ class et extends U {
   async executeDelete(t) {
     const e = [];
     for (const [s, n] of t) {
-      const a = b(s), i = this.getSchemaClient(a.namespace), c = Array.from(n), o = c.map((p) => p.id), { error: l } = await i.from(a.name).delete().in("id", o);
-      if (l)
-        throw new g(`Failed to delete: ${l.message}`);
-      e.push(...c);
+      const a = b(s), r = this.getSchemaClient(a.namespace), o = Array.from(n), c = o.map((u) => u.id), { error: d } = await r.from(a.name).delete().in("id", c);
+      if (d)
+        throw new m(`Failed to delete: ${d.message}`);
+      e.push(...o);
     }
     return e;
   }
+  /**
+   * 获取满足 filter 条件的实体 ID 列表
+   *
+   * @param entityName - 实体表名
+   * @param filter - 过滤条件
+   * @returns 满足条件的 entityId 列表
+   */
+  async #n(t, e) {
+    let s = this.#t.from(t).select("id");
+    s = $(s, e);
+    const { data: n, error: a } = await s;
+    if (a)
+      throw new m(`Failed to query filtered entities: ${a.message}`);
+    return (n ?? []).map((r) => r.id);
+  }
 }
 export {
-  Y as ADAPTER_NAME,
-  et as RxDBAdapterSupabase,
-  q as SupabaseConfigError,
-  g as SupabaseDataError,
-  tt as SupabaseNetworkError,
-  F as SupabaseRepository,
+  tt as ADAPTER_NAME,
+  it as RxDBAdapterSupabase,
+  at as SupabaseConfigError,
+  m as SupabaseDataError,
+  rt as SupabaseNetworkError,
+  P as SupabaseRepository,
   S as SupabaseSyncError,
-  H as SupabaseTreeRepository
+  q as SupabaseTreeRepository
 };

package/dist/rule_group_builder.d.ts

@@ -1,8 +1,9 @@
 import { SchemaManager, EntityMetadata, RuleGroup } from '../packages/rxdb/src/index.ts';
+import { PostgrestFilterBuilder } from '@supabase/postgrest-js';
 /**
- * Supabase Query Builder（SDK 未导出精确类型）
+ * Supabase Query Builder
  */
-type SupabaseQueryBuilder = any;
+type SupabaseQueryBuilder = PostgrestFilterBuilder<any, any, any, any, any, any, any>;
 /**
  * 应用 RuleGroup 到 Supabase Query Builder
  */

package/dist/rule_group_builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rule_group_builder.d.ts","sourceRoot":"","sources":["../src/rule_group_builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,aAAa,EACb,KAAK,cAAc,EAGnB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,KAAK,oBAAoB,GAAG,GAAG,CAAC;AA4FhC;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,KAAK,EAAE,oBAAoB,EAC3B,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,EACvB,QAAQ,CAAC,EAAE,cAAc,EACzB,aAAa,CAAC,EAAE,aAAa,GAC5B,oBAAoB,CA6BtB"}
+{"version":3,"file":"rule_group_builder.d.ts","sourceRoot":"","sources":["../src/rule_group_builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,aAAa,EACb,KAAK,cAAc,EAGnB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAMrE;;GAEG;AACH,KAAK,oBAAoB,GAAG,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AA4FtF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,KAAK,EAAE,oBAAoB,EAC3B,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,EACvB,QAAQ,CAAC,EAAE,cAAc,EACzB,aAAa,CAAC,EAAE,aAAa,GAC5B,oBAAoB,CA6BtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiao/rxdb-adapter-supabase",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -18,6 +18,9 @@
     "dist",
     "!**/*.tsbuildinfo"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "nx": {
     "name": "rxdb-adapter-supabase",
     "tags": [
@@ -25,12 +28,14 @@
     ]
   },
   "peerDependencies": {
-    "@supabase/supabase-js": "^2.86.0",
-    "@aiao/rxdb": "0.0.8"
+    "@supabase/supabase-js": "^2.88.0",
+    "@supabase/postgrest-js": "^2.89.0",
+    "rxjs": "^7.8.2",
+    "@aiao/rxdb": "0.0.10"
   },
   "devDependencies": {
     "dotenv": "^17.2.3",
-    "@aiao/rxdb-test": "0.0.8",
-    "@aiao/rxdb-adapter-sqlite": "0.0.8"
+    "@aiao/rxdb-adapter-sqlite": "0.0.10",
+    "@aiao/rxdb-test": "0.0.10"
   }
 }