@aiao/rxdb 0.0.1 → 0.0.2

package/RxDBError.d.ts

@@ -2,12 +2,4 @@
  * RxDB 基础错误类型
  */
 export declare class RxDBError extends Error {
-    messageTemplate: string;
-    data: {
-        [name: string]: string | number;
-    };
-    constructor(messageTemplate: string, data?: {
-        [name: string]: string | number;
-    });
-    toString(): string;
 }

package/entity/@TreeEntity.d.ts

@@ -1,28 +1,4 @@
 import { EntityMetadataOptions } from './entity-metadata-options.interface';
-/**
- * 树形结构类型
- *
- * 目前仅支持邻接表模型，未来可能支持其他模型：
- * - 'closure-table': 闭包表模型
- * - 'nested-set': 嵌套集模型
- * - 'materialized-path': 物化路径模型
- *
- * 参考资料：
- * - https://www.slideshare.net/slideshow/models-for-hierarchical-data/4179181
- * - https://schinckel.net/2014/09/13/long-live-adjacency-lists/
- */
-type TreeType = 'adjacency-list';
-/**
- * 树形实体元数据选项接口
- * 扩展基本实体元数据，添加树形结构特定配置
- */
-interface TreeEntityMetadataOptions extends EntityMetadataOptions {
-    /**
-     * 树形结构类型
-     * 指定使用哪种树形结构模型
-     */
-    treeType: TreeType;
-}
 /**
  * 树形实体装饰器
  * 用于将类标记为树形结构实体，并处理树形特定的元数据
@@ -46,5 +22,4 @@ interface TreeEntityMetadataOptions extends EntityMetadataOptions {
  * }
  * ```
  */
-export declare const TreeEntity: (metadataOptions: TreeEntityMetadataOptions) => <T extends import('./entity.interface').EntityType | import('./entity.interface').AbstractEntityType>(target: T) => T extends import('./entity.interface').EntityType ? new (initData?: Partial<InstanceType<T>> | undefined) => InstanceType<T> : abstract new (initData?: Partial<InstanceType<T>> | undefined) => InstanceType<T>;
-export {};
+export declare const TreeEntity: (metadataOptions: EntityMetadataOptions) => <T extends import('./entity.interface').EntityType | import('./entity.interface').AbstractEntityType>(target: T) => T extends import('./entity.interface').EntityType ? new (initData?: Partial<InstanceType<T>> | undefined) => InstanceType<T> : abstract new (initData?: Partial<InstanceType<T>> | undefined) => InstanceType<T>;

package/entity/entity-metadata-options.interface.d.ts

@@ -310,8 +310,14 @@ export interface EntityMetadataOptions {
      * 名称
      */
     name: Capitalize<string>;
+    /**
+     * 显示名称
+     * @example "用户", "订单项"
+     */
+    displayName?: string;
     /**
      * 自定义 repository
+     * @default "Repository"
      */
     repository?: 'Repository' | 'TreeRepository' | string;
     /**
@@ -326,11 +332,6 @@ export interface EntityMetadataOptions {
      * 实体同步配置
      */
     sync?: SyncOptions;
-    /**
-     * 显示名称
-     * @example "用户", "订单项"
-     */
-    displayName?: string;
     /**
      * 是否为抽象实体
      * 抽象类是不能被实例化的
@@ -359,6 +360,29 @@ export interface EntityMetadataOptions {
      * 自己定义的索引，不包括继承的
      */
     indexes?: EntityIndexMetadataOptions[];
+    /**
+     * 功能特性
+     */
+    features?: EntityMetadataFeatures;
+}
+type TreeType = 'adjacency-list';
+/**
+ * EntityMetadata 扩展特性
+ */
+export interface EntityMetadataFeatures {
+    /**
+     * 树形结构类型
+     *
+     * 目前仅支持邻接表模型，未来可能支持其他模型：
+     * - 'closure-table': 闭包表模型
+     * - 'nested-set': 嵌套集模型
+     * - 'materialized-path': 物化路径模型
+     *
+     * 参考资料：
+     * - https://www.slideshare.net/slideshow/models-for-hierarchical-data/4179181
+     * - https://schinckel.net/2014/09/13/long-live-adjacency-lists/
+     */
+    treeType?: TreeType;
 }
 /**
  * 同步适配器选项接口

package/index.js

@@ -1,13 +1,7 @@
-import { stringTemplate as oe, isFunction as ce, startCase as le, get as de, isEqual as G, isSymbol as he, omitBy as pe, deepFreeze as ue, isPromise as fe } from "@aiao/utils";
-import { v7 as Ee } from "uuid";
-import { BehaviorSubject as w, filter as P, distinctUntilChanged as I, switchMap as f, shareReplay as v, map as D, tap as b, firstValueFrom as S, of as j, defer as q } from "rxjs";
-class A extends Error {
-  constructor(e, t = {}) {
-    super(oe(e, t)), this.messageTemplate = e, this.data = t;
-  }
-  toString() {
-    return JSON.stringify(this);
-  }
+import { isFunction as oe, startCase as ce, get as le, isEqual as J, isSymbol as de, omitBy as he, deepFreeze as pe, isPromise as ue } from "@aiao/utils";
+import { v7 as fe } from "uuid";
+import { BehaviorSubject as N, filter as Y, distinctUntilChanged as I, switchMap as f, shareReplay as A, map as D, tap as b, firstValueFrom as S, of as j, defer as q } from "rxjs";
+class v extends Error {
 }
 class T {
   constructor(e) {
@@ -19,78 +13,78 @@ class U extends T {
     super(e), this.error = t;
   }
 }
-const ye = "ENTITY_NEW";
-class me extends T {
-  type = ye;
+const Ee = "ENTITY_NEW";
+class ye extends T {
+  type = Ee;
 }
-const V = "ENTITY_CREATE", _e = `${V}_SUCCESS`, ge = `${V}_ERROR`;
-class be extends T {
+const V = "ENTITY_CREATE", me = `${V}_SUCCESS`, _e = `${V}_ERROR`;
+class ge extends T {
   type = V;
 }
-class Te extends T {
-  type = _e;
+class be extends T {
+  type = me;
 }
 class ve extends U {
-  type = ge;
+  type = _e;
 }
-const K = "ENTITY_UPDATE", Ae = `${K}_SUCCESS`, Oe = `${K}_ERROR`;
-class Re extends T {
+const K = "ENTITY_UPDATE", Te = `${K}_SUCCESS`, Ae = `${K}_ERROR`;
+class Oe extends T {
   type = K;
 }
-class Ne extends T {
-  type = Ae;
+class Re extends T {
+  type = Te;
 }
 class we extends U {
-  type = Oe;
+  type = Ae;
 }
-const W = "ENTITY_REMOVE", xe = `${W}_SUCCESS`, Me = `${W}_ERROR`;
-class Se extends T {
+const W = "ENTITY_REMOVE", Ne = `${W}_SUCCESS`, xe = `${W}_ERROR`;
+class Me extends T {
   type = W;
 }
-class Ce extends T {
-  type = xe;
+class Se extends T {
+  type = Ne;
 }
-class Ie extends U {
-  type = Me;
+class Ce extends U {
+  type = xe;
 }
-const De = "ENTITY_PATCH";
-class Be extends T {
+const Ie = "ENTITY_PATCH";
+class De extends T {
   constructor(e, t, s, n, i, a) {
     super(e), this.patch = t, this.inversePatch = s, this.recordAt = n, this.timeStamp = i, this.updatedBy = a;
   }
-  type = De;
+  type = Ie;
 }
 const F = "TRANSACTION_BEGIN", z = "TRANSACTION_COMMIT", H = "TRANSACTION_ROLLBACK";
-class gt {
+class mt {
   type = F;
 }
-class bt {
+class _t {
   type = z;
 }
-class Tt {
+class gt {
   type = H;
 }
-const ee = "DATABASE_DELETE", $e = "DATABASE_INSERT", Ye = "DATABASE_UPDATE";
-class J {
+const ee = "DATABASE_DELETE", Be = "DATABASE_INSERT", $e = "DATABASE_UPDATE";
+class G {
   constructor(e, t) {
     this.EntityType = e, this.data = t;
   }
 }
-class vt extends J {
+class bt extends G {
   type = ee;
 }
-class At extends J {
-  type = $e;
+class vt extends G {
+  type = Be;
 }
-class Ot extends J {
-  type = Ye;
+class Tt extends G {
+  type = $e;
 }
-const te = Symbol("ɵProxy"), L = Symbol("ɵMetadata"), se = Symbol("ɵStatus"), B = Symbol("ɵStatusCheck"), ne = Symbol("ɵEntityManager"), re = Symbol("ɵEntityDeleteCheck"), x = Symbol("ɵUpdateBy"), Pe = "SYSTEM", je = "USER", Le = (r, e) => e.sync.local?.adapter === r, ke = (r) => [F, z, H].includes(r.type), O = (r) => r[L] || r.constructor[L], m = (r) => r[se], Rt = (r, e, t, s) => {
+const te = Symbol("ɵProxy"), L = Symbol("ɵMetadata"), se = Symbol("ɵStatus"), B = Symbol("ɵStatusCheck"), ne = Symbol("ɵEntityManager"), re = Symbol("ɵEntityDeleteCheck"), x = Symbol("ɵUpdateBy"), Pe = "SYSTEM", Ye = "USER", je = (r, e) => e.sync.local?.adapter === r, Le = (r) => [F, z, H].includes(r.type), O = (r) => r[L] || r.constructor[L], m = (r) => r[se], At = (r, e, t, s) => {
   let n = s > 1 ? void 0 : s ? Object.getOwnPropertyDescriptor(e, t) : e;
   for (let i = r.length - 1, a; i >= 0; i--)
     (a = r[i]) && (n = a(n) || n);
   return n;
-}, Ue = () => Ee(), Ve = [
+}, ke = () => fe(), Ue = [
   "id",
   "createdAt",
   "updatedAt",
@@ -98,7 +92,7 @@ const te = Symbol("ɵProxy"), L = Symbol("ɵMetadata"), se = Symbol("ɵStatus"),
   "createdBy",
   "updatedBy",
   "removedBy"
-], Ke = ["rev"], Nt = (r) => !!(Ve.includes(r) || Ke.includes(r) || r.startsWith("_")), u = (r, e, t) => Object.defineProperty(r, e, {
+], Ve = ["rev"], Ot = (r) => !!(Ue.includes(r) || Ve.includes(r) || r.startsWith("_")), u = (r, e, t) => Object.defineProperty(r, e, {
   value: t,
   enumerable: !1,
   configurable: !1,
@@ -108,7 +102,7 @@ const te = Symbol("ɵProxy"), L = Symbol("ɵMetadata"), se = Symbol("ɵStatus"),
   enumerable: !1,
   configurable: !1,
   writable: !0
-}), N = (r, e, t) => {
+}), w = (r, e, t) => {
   let s;
   const n = {
     get: () => (s = t(), n.get = () => s, s),
@@ -116,20 +110,20 @@ const te = Symbol("ɵProxy"), L = Symbol("ɵMetadata"), se = Symbol("ɵStatus"),
     configurable: !1
   };
   return Object.defineProperty(r, e, n);
-}, We = (r, e) => {
+}, Ke = (r, e) => {
   const t = {};
   let s = !1;
   r.defaultValueProperties.forEach((n) => {
-    e[n.name] === void 0 && (s = !0, ce(n.default) ? t[n.name] = n.default() : t[n.name] = n.default);
+    e[n.name] === void 0 && (s = !0, oe(n.default) ? t[n.name] = n.default() : t[n.name] = n.default);
   }), s && Object.assign(e, t);
-}, Fe = (r, e, t) => {
+}, We = (r, e, t) => {
   const { propertyMap: s, foreignKeyNames: n } = O(e);
   Object.keys(t).forEach((i) => {
     s.has(i) ? r.propertyMap.get(i)?.readonly !== !0 && (e[i] = t[i]) : n.includes(i) && (e[i] = t[i]);
   });
 };
-var E = /* @__PURE__ */ ((r) => (r.uuid = "uuid", r.string = "string", r.number = "number", r.integer = "integer", r.boolean = "boolean", r.date = "date", r.json = "json", r))(E || {}), p = /* @__PURE__ */ ((r) => (r.ONE_TO_ONE = "1:1", r.ONE_TO_MANY = "1:m", r.MANY_TO_ONE = "m:1", r.MANY_TO_MANY = "m:n", r))(p || {}), ze = /* @__PURE__ */ ((r) => (r.Full = "full", r.Filter = "filter", r.None = "None", r))(ze || {});
-const He = (r, e) => {
+var E = /* @__PURE__ */ ((r) => (r.uuid = "uuid", r.string = "string", r.number = "number", r.integer = "integer", r.boolean = "boolean", r.date = "date", r.json = "json", r))(E || {}), p = /* @__PURE__ */ ((r) => (r.ONE_TO_ONE = "1:1", r.ONE_TO_MANY = "1:m", r.MANY_TO_ONE = "m:1", r.MANY_TO_MANY = "m:n", r))(p || {}), Fe = /* @__PURE__ */ ((r) => (r.Full = "full", r.Filter = "filter", r.None = "None", r))(Fe || {});
+const ze = (r, e) => {
   const t = [];
   t.push(r);
   const s = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map(), a = { ...r };
@@ -141,7 +135,7 @@ const He = (r, e) => {
     l.shift(), a.extends = l;
   } else
     a.extends = r.extends || [];
-  return a.displayName || (a.displayName = le(a.name).replace(" ", "")), a.relations.forEach((o) => {
+  return a.displayName || (a.displayName = ce(a.name).replace(" ", "")), a.relations.forEach((o) => {
     o.mappedNamespace = o.mappedNamespace || "public";
   }), t.reverse().forEach((o) => {
     o.properties?.forEach((c) => {
@@ -153,26 +147,26 @@ const He = (r, e) => {
       } else
         n.set(c.name, c);
     }), o.indexes?.forEach((c) => i.set(c.name, c));
-  }), u(a, "propertyMap", s), u(a, "relationMap", n), u(a, "indexMap", i), N(
+  }), u(a, "propertyMap", s), u(a, "relationMap", n), u(a, "indexMap", i), w(
     a,
     "defaultValueProperties",
     () => Array.from(s.values()).filter((o) => o.default !== void 0)
-  ), N(
+  ), w(
     a,
     "foreignKeyRelations",
     () => Array.from(a.relationMap.values()).filter(
       (o) => o.kind === p.MANY_TO_ONE || o.kind === p.ONE_TO_ONE
     )
-  ), N(a, "foreignKeyRelationMap", () => {
+  ), w(a, "foreignKeyRelationMap", () => {
     const o = /* @__PURE__ */ new Map();
     return a.foreignKeyRelations.forEach((c) => o.set(c.name, c)), o;
-  }), N(a, "foreignKeyNames", () => a.foreignKeyRelations.map((o) => `${o.name}Id`)), u(
+  }), w(a, "foreignKeyNames", () => a.foreignKeyRelations.map((o) => `${o.name}Id`)), u(
     a,
     "isForeignKey",
     (o) => o && o.endsWith("Id") && a.foreignKeyNames.includes(o)
   ), a;
 }, R = (r) => (e) => {
-  const t = He(r, e);
+  const t = ze(r, e);
   if (u(e, L, t), r.abstract) return e;
   const s = e;
   return class extends s {
@@ -190,13 +184,23 @@ const He = (r, e) => {
     constructor(n) {
       super(n);
       const i = this[ne];
-      if (!i) throw new A("need init rxdb");
-      return We(t, this), n && Fe(t, this, n), i[te](this);
+      if (!i) throw new v("need init rxdb");
+      return Ke(t, this), n && We(t, this, n), i[te](this);
     }
   };
-}, wt = (r) => R({ ...r, repository: r.repository || "TreeRepository" });
-var Je = Object.getOwnPropertyDescriptor, Ge = (r, e, t, s) => {
-  for (var n = s > 1 ? void 0 : s ? Je(e, t) : e, i = r.length - 1, a; i >= 0; i--)
+}, Rt = (r) => {
+  const e = r.features || {};
+  return R({
+    ...r,
+    features: {
+      ...e,
+      treeType: e.treeType || "adjacency-list"
+    },
+    repository: r.repository || "TreeRepository"
+  });
+};
+var He = Object.getOwnPropertyDescriptor, Ge = (r, e, t, s) => {
+  for (var n = s > 1 ? void 0 : s ? He(e, t) : e, i = r.length - 1, a; i >= 0; i--)
     (a = r[i]) && (n = a(n) || n);
   return n;
 };
@@ -261,7 +265,7 @@ $ = Ge([
         // 唯一索引
         readonly: !0,
         // 创建后不可修改
-        default: () => Ue()
+        default: () => ke()
         // 默认生成UUID
       },
       {
@@ -303,14 +307,14 @@ $ = Ge([
     ]
   })
 ], $);
-var qe = Object.getOwnPropertyDescriptor, Qe = (r, e, t, s) => {
-  for (var n = s > 1 ? void 0 : s ? qe(e, t) : e, i = r.length - 1, a; i >= 0; i--)
+var Je = Object.getOwnPropertyDescriptor, qe = (r, e, t, s) => {
+  for (var n = s > 1 ? void 0 : s ? Je(e, t) : e, i = r.length - 1, a; i >= 0; i--)
     (a = r[i]) && (n = a(n) || n);
   return n;
 };
 let X = class extends $ {
 };
-X = Qe([
+X = qe([
   R({
     name: "TreeAdjacencyListEntityBase",
     abstract: !0,
@@ -339,7 +343,7 @@ X = Qe([
     ]
   })
 ], X);
-const Xe = (r) => !!r.combinator, Ze = (r, e) => {
+const Qe = (r) => !!r.combinator, Xe = (r, e) => {
   const t = e[r.field], { operator: s, value: n } = r;
   switch (s) {
     case "in":
@@ -363,9 +367,9 @@ const Xe = (r) => !!r.combinator, Ze = (r, e) => {
     case "notEndWith":
       return `${t}`.endsWith(`${n}`) === !1;
     case "=":
-      return G(n, t);
+      return J(n, t);
     case "!=":
-      return G(n, t) === !1;
+      return J(n, t) === !1;
     case ">":
       return t > n;
     case ">=":
@@ -375,16 +379,16 @@ const Xe = (r) => !!r.combinator, Ze = (r, e) => {
     case "<=":
       return t <= n;
     default:
-      throw new Error("Unknown operator: " + s);
+      throw new v(`Unknown operator: ${s}`);
   }
 }, k = (r, e) => {
-  if (Xe(r)) {
+  if (Qe(r)) {
     const { combinator: t, rules: s } = r;
     return t === "and" ? s.every((n) => k(n, e)) : s.some((n) => k(n, e));
   } else
-    return Ze(r, e);
-}, xt = (r, e) => k(e, r), et = (r, e, t) => {
-  const { field: s, order: n } = t, i = de(e, s);
+    return Xe(r, e);
+}, wt = (r, e) => k(e, r), Ze = (r, e, t) => {
+  const { field: s, order: n } = t, i = le(e, s);
   if (n === "asc") {
     if (r.some((c) => i < Reflect.get(c, s))) return !0;
     if (r.every((c) => i > Reflect.get(c, s))) return !1;
@@ -392,10 +396,10 @@ const Xe = (r) => !!r.combinator, Ze = (r, e) => {
     if (r.some((c) => i > Reflect.get(c, s))) return !0;
     if (r.every((c) => i < Reflect.get(c, s))) return !1;
   }
-}, Mt = (r, e, t) => {
+}, Nt = (r, e, t) => {
   if (t.length === 0) return !1;
   for (let s = 0; s < t.length; s++) {
-    const n = t[s], i = et(r, e, n);
+    const n = t[s], i = Ze(r, e, n);
     if (i === void 0) {
       if (s < t.length - 1) {
         const { field: a } = n, o = Reflect.get(e, a);
@@ -405,8 +409,8 @@ const Xe = (r) => !!r.combinator, Ze = (r, e) => {
       return i;
   }
 };
-var tt = /* @__PURE__ */ ((r) => (r.Synced = "Synced", r.Syncing = "Syncing", r.Never = "Never", r))(tt || {});
-class St {
+var et = /* @__PURE__ */ ((r) => (r.Synced = "Synced", r.Syncing = "Syncing", r.Never = "Never", r))(et || {});
+class xt {
   constructor(e, t) {
     this.rxdb = e, this.EntityClass = t;
   }
@@ -451,36 +455,36 @@ class ae {
   /**
    * 本地适配器
    */
-  localAdapterSub = new w("");
+  localAdapterSub = new N("");
   localAdapter$ = this.localAdapterSub.asObservable().pipe(
-    P(Boolean),
+    Y(Boolean),
     I(),
     f((e) => this.rxdb.getAdapter(e)),
-    v(1)
+    A(1)
   );
   /**
    * 本地仓库
    */
   local$ = this.localAdapter$.pipe(
     D((e) => e.getRepository(this.EntityType)),
-    v(1)
+    A(1)
   );
   /**
    * 远程适配器
    */
-  remoteAdapterSub = new w("");
+  remoteAdapterSub = new N("");
   remoteAdapter$ = this.remoteAdapterSub.asObservable().pipe(
-    P(Boolean),
+    Y(Boolean),
     I(),
     f((e) => this.rxdb.getAdapter(e)),
-    v(1)
+    A(1)
   );
   /**
    * 远程仓库
    */
   remote$ = this.remoteAdapter$.pipe(
     D((e) => e.getRepository(this.EntityType)),
-    v(1)
+    A(1)
   );
   /**
    * 同步配置
@@ -612,7 +616,7 @@ class ae {
   _setLocalEntityStatus = (e) => m(e).local = !0;
   _setLocalEntitiesStatus = (e) => e.forEach(this._setLocalEntityStatus);
 }
-class st extends ae {
+class tt extends ae {
   /**
    * 查询子孙
    */
@@ -644,7 +648,7 @@ class st extends ae {
     return this.local$.pipe(f((n) => n.countAncestors(e, t, s)));
   }
 }
-const nt = (r) => {
+const st = (r) => {
   const e = m(r), t = r;
   let s = [];
   const n = () => {
@@ -668,17 +672,17 @@ const nt = (r) => {
      */
     set: (o, c, l, d) => {
       if (o[c] === l) return !0;
-      if (he(c) === !1) {
-        const h = o[x] || je;
+      if (de(c) === !1) {
+        const h = o[x] || Ye;
         s.push({ updatedBy: h, prop: c, value: l, oldValue: o[c] }), e[B] = !0, e.modified = !0, clearTimeout(i), i = setTimeout(() => n(), 0);
       }
       return Reflect.set(o, c, l, d);
     }
   };
   return new Proxy(r, a);
-}, rt = (r, e, t) => {
+}, nt = (r, e, t) => {
   const s = t.rxdb.schema.getEntityType(r.mappedEntity, r.mappedNamespace);
-  if (!s) throw new Error(`mapped entity not found: ${r.mappedEntity}`);
+  if (!s) throw new v(`mapped entity not found: ${r.mappedEntity}`);
   const n = r.name + "Id", i = r.name + "$";
   let a;
   switch (r.kind) {
@@ -690,9 +694,9 @@ const nt = (r) => {
     case p.MANY_TO_ONE:
     case p.ONE_TO_ONE:
       a = function() {
-        const o = this, c = m(o), l = new w(o[n]), d = l.asObservable().pipe(
+        const o = this, c = m(o), l = new N(o[n]), d = l.asObservable().pipe(
           f((h) => h ? t.getRepository(s).get(h) : j(null)),
-          v(1)
+          A(1)
         );
         return u(d, "set", (h) => {
           h || d.remove(), Reflect.get(o, n) != h.id && (c.addRelationEntity(r, h), l.next(h.id), Reflect.set(o, n, h.id));
@@ -747,7 +751,7 @@ const nt = (r) => {
     case p.MANY_TO_MANY:
       a = function() {
         const o = this, c = m(o), l = r.name + "Id";
-        if (!r.junctionEntityType) throw new A("junction entity not found");
+        if (!r.junctionEntityType) throw new v("junction entity not found");
         const d = t.getRepository(r.junctionEntityType).findAll({
           combinator: "and",
           rules: [
@@ -796,13 +800,8 @@ const nt = (r) => {
     enumerable: !1,
     configurable: !1
   });
-}, at = Object.freeze({
-  [p.ONE_TO_MANY]: 2,
-  [p.MANY_TO_ONE]: 1,
-  [p.ONE_TO_ONE]: -1,
-  [p.MANY_TO_MANY]: 1
-});
-class it {
+};
+class rt {
   /**
    * 创建实体状态实例
    *
@@ -839,7 +838,7 @@ class it {
    * 实体变更记录的可观察对象
    * 用于发布实体变更通知
    */
-  #t = new w([]);
+  #t = new N([]);
   /**
    * 实体状态快照数组
    * 用于存储实体在不同时间点的完整状态
@@ -964,7 +963,7 @@ class it {
    */
   addEntityPatch(e, t, s, n = Date.now()) {
     const i = performance.now(), a = { patch: e, inversePatch: t, recordAt: n, timeStamp: i, updatedBy: s };
-    this._patches.length === 0 && this.#s.push(Object.freeze(structuredClone(this.origin))), N(a, "snapshot", () => {
+    this._patches.length === 0 && this.#s.push(Object.freeze(structuredClone(this.origin))), w(a, "snapshot", () => {
       const c = this._patches.findIndex((h) => h === a), l = this.#s[c];
       if (l) return l;
       let d;
@@ -974,7 +973,7 @@ class it {
       }
       return d;
     }), this._patches.push(a), this.#t.next(this._patches);
-    const o = new Be(this.proxyTarget, e, t, n, i, s);
+    const o = new De(this.proxyTarget, e, t, n, i, s);
     this.rxdb.dispatchEvent(o);
   }
   /**
@@ -984,15 +983,12 @@ class it {
    * @returns 需要保存的实体数组
    */
   getNeedSaveRelationEntities() {
-    const e = /* @__PURE__ */ new Map([[this.proxyTarget, 0]]), t = /* @__PURE__ */ new Set([this.proxyTarget]);
+    const e = /* @__PURE__ */ new Set([this.proxyTarget]);
     return this.#e.forEach(
-      (s, n) => s.forEach((i) => {
-        m(i).modified === !0 && (t.add(i), e.set(i, at[n]));
+      (t) => t.forEach((s) => {
+        m(s).modified === !0 && e.add(s);
       })
-    ), Array.from(t).sort((s, n) => {
-      const i = e.get(s) || 0, a = e.get(n) || 0;
-      return i - a;
-    });
+    ), Array.from(e);
   }
   /**
    * 添加关系实体
@@ -1050,7 +1046,7 @@ class it {
     return t ? this.#e.get(e) : (t = /* @__PURE__ */ new Set(), this.#e.set(e, t), t);
   }
 }
-class ot {
+class at {
   /**
    * 创建实体管理器实例
    *
@@ -1074,11 +1070,11 @@ class ot {
         );
       }), Object.keys(Z).forEach(
         (n) => u(t.prototype, n, Z[n](this, t))
-      ), s.relationMap.forEach((n) => rt(n, t, this));
+      ), s.relationMap.forEach((n) => nt(n, t, this));
     }), u(this, te, (t) => {
       const s = this.#i(t, { local: !1, remote: !1, modified: !0 });
       this.addEntityCache(s);
-      const n = new me(s);
+      const n = new ye(s);
       return this.rxdb.dispatchEvent(n), s;
     }), u(this, re, (t) => {
       const { EntityType: s, data: n } = t;
@@ -1208,12 +1204,12 @@ class ot {
    */
   async remove(e) {
     const t = e.constructor;
-    this.rxdb.dispatchEvent(new Se(e));
+    this.rxdb.dispatchEvent(new Me(e));
     try {
       const s = await this.#n(t).remove(e);
-      return this.rxdb.dispatchEvent(new Ce(s)), s;
+      return this.rxdb.dispatchEvent(new Se(s)), s;
     } catch (s) {
-      throw this.rxdb.dispatchEvent(new Ie(e, s)), s;
+      throw this.rxdb.dispatchEvent(new Ce(e, s)), s;
     }
   }
   /**
@@ -1227,10 +1223,10 @@ class ot {
    */
   async create(e) {
     const t = e.constructor;
-    this.rxdb.dispatchEvent(new be(e));
+    this.rxdb.dispatchEvent(new ge(e));
     try {
       const s = await this.#n(t).create(e);
-      return this.rxdb.dispatchEvent(new Te(s)), s;
+      return this.rxdb.dispatchEvent(new be(s)), s;
     } catch (s) {
       throw this.rxdb.dispatchEvent(new ve(e, s)), s;
     }
@@ -1247,11 +1243,11 @@ class ot {
   async update(e) {
     const t = e.constructor, s = m(e);
     if (s.modified) {
-      const n = pe(s.target, (i, a) => i === s.origin[a]);
-      this.rxdb.dispatchEvent(new Re(e));
+      const n = he(s.target, (i, a) => i === s.origin[a]);
+      this.rxdb.dispatchEvent(new Oe(e));
       try {
         const i = await this.#n(t).update(e, n);
-        return this.rxdb.dispatchEvent(new Ne(i)), i;
+        return this.rxdb.dispatchEvent(new Re(i)), i;
       } catch (i) {
         throw this.rxdb.dispatchEvent(new we(e, i)), i;
       }
@@ -1288,10 +1284,10 @@ class ot {
           s = new ae(this.rxdb, e);
           break;
         case "TreeRepository":
-          s = new st(this.rxdb, e);
+          s = new tt(this.rxdb, e);
           break;
         default:
-          throw new A("repository must be 'Repository' or 'TreeRepository'");
+          throw new v("repository must be 'Repository' or 'TreeRepository'");
       }
       return this.#e.set(e, s), s;
     }
@@ -1330,9 +1326,9 @@ class ot {
    */
   #i(e, t) {
     Q(e, x, "");
-    const s = new it(this.rxdb, { target: e, ...t });
+    const s = new rt(this.rxdb, { target: e, ...t });
     Q(e, se, s);
-    const n = nt(e);
+    const n = st(e);
     return u(s, "proxyTarget", n), n;
   }
 }
@@ -1343,7 +1339,7 @@ const Z = {
   remove: (r) => function() {
     return r.remove(this);
   }
-}, ct = (r) => {
+}, it = (r) => {
   const [{ metadata: e, relation: t }, { metadata: s, relation: n }] = r, i = Array.from(/* @__PURE__ */ new Set([e.namespace, s.namespace])).sort().join("_") || void 0;
   return {
     name: Array.from(/* @__PURE__ */ new Set([e.name, s.name])).sort().join("_"),
@@ -1364,12 +1360,12 @@ const Z = {
     ]
   };
 };
-var lt = Object.getOwnPropertyDescriptor, dt = (r, e, t, s) => {
-  for (var n = s > 1 ? void 0 : s ? lt(e, t) : e, i = r.length - 1, a; i >= 0; i--)
+var ot = Object.getOwnPropertyDescriptor, ct = (r, e, t, s) => {
+  for (var n = s > 1 ? void 0 : s ? ot(e, t) : e, i = r.length - 1, a; i >= 0; i--)
     (a = r[i]) && (n = a(n) || n);
   return n;
 };
-let Y = class {
+let P = class {
   id;
   namespace;
   entity;
@@ -1379,7 +1375,7 @@ let Y = class {
   patch;
   changedAt;
 };
-Y = dt([
+P = ct([
   R({
     name: "RxDBChange",
     log: !1,
@@ -1431,9 +1427,9 @@ Y = dt([
       }
     ]
   })
-], Y);
-var ht = Object.getOwnPropertyDescriptor, pt = (r, e, t, s) => {
-  for (var n = s > 1 ? void 0 : s ? ht(e, t) : e, i = r.length - 1, a; i >= 0; i--)
+], P);
+var lt = Object.getOwnPropertyDescriptor, dt = (r, e, t, s) => {
+  for (var n = s > 1 ? void 0 : s ? lt(e, t) : e, i = r.length - 1, a; i >= 0; i--)
     (a = r[i]) && (n = a(n) || n);
   return n;
 };
@@ -1442,7 +1438,7 @@ let M = class {
   name;
   executedAt;
 };
-M = pt([
+M = dt([
   R({
     name: "RxDBMigration",
     log: !1,
@@ -1466,17 +1462,17 @@ M = pt([
     ]
   })
 ], M);
-var ut = Object.getOwnPropertyDescriptor, ft = (r, e, t, s) => {
-  for (var n = s > 1 ? void 0 : s ? ut(e, t) : e, i = r.length - 1, a; i >= 0; i--)
+var ht = Object.getOwnPropertyDescriptor, pt = (r, e, t, s) => {
+  for (var n = s > 1 ? void 0 : s ? ht(e, t) : e, i = r.length - 1, a; i >= 0; i--)
     (a = r[i]) && (n = a(n) || n);
   return n;
 };
 const C = (r, e) => e + ":" + r;
-class Et {
+class ut {
   constructor(e) {
     this.rxdb = e;
     const { entities: t } = this.rxdb.options;
-    [Y, M, ...t].forEach((s) => {
+    [P, M, ...t].forEach((s) => {
       const n = O(s), { name: i, namespace: a } = n, o = C(i, a);
       this.#e.set(o, n), this.#t.set(o, s);
     }), this.#e.forEach((s) => {
@@ -1484,12 +1480,12 @@ class Et {
       n.forEach((i) => {
         if (i.kind === p.MANY_TO_MANY) {
           const a = this.findMappedRelation(s, i);
-          if (!a) throw new A("mapped relation not found");
-          const o = ct([{ metadata: s, relation: i }, a]), c = C(o.name, o.namespace);
+          if (!a) throw new v("mapped relation not found");
+          const o = it([{ metadata: s, relation: i }, a]), c = C(o.name, o.namespace);
           if (this.#e.has(c) === !1) {
             let l = class extends $ {
             };
-            l = ft([
+            l = pt([
               R(o)
             ], l);
             const d = O(l);
@@ -1541,15 +1537,15 @@ class Et {
    * @param field 查询条件的字段
    */
   getFieldRelations(e, t) {
-    if (t.includes(".") === !1) throw new A(`field '${t}' 必须是关属性查询`, { field: t });
+    if (t.includes(".") === !1) throw new v(`field '${t}' 必须是关属性查询`);
     const s = [], n = t.split("."), i = n.length - 1;
     let a = e, o, c = !1, l = "";
     return n.length === 2 && n[1] == "id" && (c = a.foreignKeyRelationMap.has(n[0]), l = n[0] + "Id"), n.forEach((d, h) => {
       if (h === i) {
-        if (a.propertyMap.has(d) === !1) throw new A(`property '${d}' not found`, { prop: d });
+        if (a.propertyMap.has(d) === !1) throw new v(`property '${d}' not found`);
         o = a.propertyMap.get(d);
       } else {
-        if (a.relationMap.has(d) === !1) throw new A(`relation '${d}' not found`, { prop: d });
+        if (a.relationMap.has(d) === !1) throw new v(`relation '${d}' not found`);
         const y = a.relationMap.get(d);
         s.push({ relation: y, metadata: a }), a = this.getEntityMetadata(y.mappedEntity, y.mappedNamespace);
       }
@@ -1575,7 +1571,7 @@ class Et {
     return this.#t.get(s);
   }
 }
-class Ct {
+class Mt {
   // 插件
   #e = /* @__PURE__ */ new WeakSet();
   // events
@@ -1585,8 +1581,8 @@ class Ct {
   // 适配器
   #r = /* @__PURE__ */ new Map();
   #a = /* @__PURE__ */ new Map();
-  #i = new w(0);
-  #l = this.#i.asObservable().pipe(I(), v(1));
+  #i = new N(0);
+  #l = this.#i.asObservable().pipe(I(), A(1));
   // 上下文
   #c = {};
   /**
@@ -1615,7 +1611,7 @@ class Ct {
         },
         e
       )
-    ), this.schema = new Et(this), this.em = new ot(this), this.context = { ...this.options.context }, this.addEventListener(F, () => {
+    ), this.schema = new ut(this), this.em = new at(this), this.context = { ...this.options.context }, this.addEventListener(F, () => {
       this.#n = !0;
     }), this.addEventListener(z, () => {
       this.#n = !1, this.#s.forEach((s) => this.dispatchEvent(s)), this.#s = [];
@@ -1623,7 +1619,7 @@ class Ct {
       this.#n = !1, this.#s = [];
     });
     const t = this.em;
-    this.addEventListener(ee, (s) => t[re](s)), ue(this.options);
+    this.addEventListener(ee, (s) => t[re](s)), pe(this.options);
   }
   /**
    * 注册适配器
@@ -1637,12 +1633,12 @@ class Ct {
   getAdapter(e) {
     return this.#a.has(e) ? this.#a.get(e) : this.#l.pipe(
       D(() => this.#r.get(e)),
-      P(Boolean),
+      Y(Boolean),
       I(),
       f((t) => {
         if (!this.#a.has(e)) {
           const s = t(this);
-          fe(s) ? this.#a.set(e, q(() => s).pipe(v(1))) : this.#a.set(e, j(s).pipe(v(1)));
+          ue(s) ? this.#a.set(e, q(() => s).pipe(A(1))) : this.#a.set(e, j(s).pipe(A(1)));
         }
         return this.#a.get(e);
       })
@@ -1667,9 +1663,9 @@ class Ct {
   connect(e) {
     return this.getAdapter(e).pipe(
       f((t) => t.connect()),
-      f((t) => Le(e, this.options) ? q(async () => {
+      f((t) => je(e, this.options) ? q(async () => {
         if (!await t.isTableExisted(M)) {
-          await t.createTable(M), await t.createTable(Y);
+          await t.createTable(M), await t.createTable(P);
           for (let n = 0; n < this.options.entities.length; n++) {
             const i = this.options.entities[n];
             try {
@@ -1689,7 +1685,7 @@ class Ct {
     this.#o(e).delete(t);
   }
   dispatchEvent(e) {
-    this.#n && ke(e) === !1 ? this.#s.push(e) : this.#o(e.type).forEach((t) => t.call(this, e));
+    this.#n && Le(e) === !1 ? this.#s.push(e) : this.#o(e.type).forEach((t) => t.call(this, e));
   }
   #o(e) {
     if (this.#t.has(e))
@@ -1705,79 +1701,79 @@ class ie {
     this.rxdb = e;
   }
 }
-class It extends ie {
+class St extends ie {
 }
-class Dt extends ie {
+class Ct extends ie {
 }
-class Bt {
+class It {
   constructor(e) {
     this.rxdb = e;
   }
 }
 export {
   ee as DATABASE_DELETE,
-  $e as DATABASE_INSERT,
-  Ye as DATABASE_UPDATE,
-  ge as ENTITY_CREATE_ERROR_EVENT,
+  Be as DATABASE_INSERT,
+  $e as DATABASE_UPDATE,
+  _e as ENTITY_CREATE_ERROR_EVENT,
   V as ENTITY_CREATE_EVENT,
-  _e as ENTITY_CREATE_SUCCESS_EVENT,
-  ye as ENTITY_NEW_EVENT,
-  De as ENTITY_PATCH_EVENT,
-  Me as ENTITY_REMOVE_ERROR_EVENT,
+  me as ENTITY_CREATE_SUCCESS_EVENT,
+  Ee as ENTITY_NEW_EVENT,
+  Ie as ENTITY_PATCH_EVENT,
+  xe as ENTITY_REMOVE_ERROR_EVENT,
   W as ENTITY_REMOVE_EVENT,
-  xe as ENTITY_REMOVE_SUCCESS_EVENT,
-  Oe as ENTITY_UPDATE_ERROR_EVENT,
+  Ne as ENTITY_REMOVE_SUCCESS_EVENT,
+  Ae as ENTITY_UPDATE_ERROR_EVENT,
   K as ENTITY_UPDATE_EVENT,
-  Ae as ENTITY_UPDATE_SUCCESS_EVENT,
+  Te as ENTITY_UPDATE_SUCCESS_EVENT,
   R as Entity,
   $ as EntityBase,
   ve as EntityCreateErrorEvent,
-  be as EntityCreateEvent,
-  Te as EntityCreateSuccessEvent,
-  me as EntityNewEvent,
-  Be as EntityPatchEvent,
-  Ie as EntityRemoveErrorEvent,
-  Se as EntityRemoveEvent,
-  Ce as EntityRemoveSuccessEvent,
+  ge as EntityCreateEvent,
+  be as EntityCreateSuccessEvent,
+  ye as EntityNewEvent,
+  De as EntityPatchEvent,
+  Ce as EntityRemoveErrorEvent,
+  Me as EntityRemoveEvent,
+  Se as EntityRemoveSuccessEvent,
   we as EntityUpdateErrorEvent,
-  Re as EntityUpdateEvent,
-  Ne as EntityUpdateSuccessEvent,
+  Oe as EntityUpdateEvent,
+  Re as EntityUpdateSuccessEvent,
   E as PropertyType,
   p as RelationKind,
-  St as RepositoryBase,
-  Ct as RxDB,
+  xt as RepositoryBase,
+  Mt as RxDB,
   ie as RxDBAdapterBase,
-  vt as RxDBAdapterDeleteChangeEvent,
-  At as RxDBAdapterInsertChangeEvent,
-  It as RxDBAdapterLocalBase,
-  Dt as RxDBAdapterRemoteBase,
-  Ot as RxDBAdapterUpdateChangeEvent,
-  Y as RxDBChange,
-  A as RxDBError,
+  bt as RxDBAdapterDeleteChangeEvent,
+  vt as RxDBAdapterInsertChangeEvent,
+  St as RxDBAdapterLocalBase,
+  Ct as RxDBAdapterRemoteBase,
+  Tt as RxDBAdapterUpdateChangeEvent,
+  P as RxDBChange,
+  v as RxDBError,
   M as RxDBMigration,
-  Bt as RxDBPluginBase,
-  tt as SyncStatus,
-  ze as SyncType,
+  It as RxDBPluginBase,
+  et as SyncStatus,
+  Fe as SyncType,
   F as TRANSACTION_BEGIN,
   z as TRANSACTION_COMMIT,
   H as TRANSACTION_ROLLBACK,
-  gt as TransactionBeginEvent,
-  bt as TransactionCommitEvent,
-  Tt as TransactionRollbackEvent,
+  mt as TransactionBeginEvent,
+  _t as TransactionCommitEvent,
+  gt as TransactionRollbackEvent,
   X as TreeAdjacencyListEntityBase,
-  wt as TreeEntity,
-  Rt as __decorateClass,
-  We as fillDefaultValue,
-  Fe as fillInitValue,
+  Rt as TreeEntity,
+  At as __decorateClass,
+  Ke as fillDefaultValue,
+  We as fillInitValue,
   O as getEntityMetadata,
   m as getEntityStatus,
-  Mt as isEntityEffectOrderBy,
-  Nt as isEntityInternalName,
-  xt as isEntityMatchRuleGroup,
-  Xe as isRuleGroup,
+  Nt as isEntityEffectOrderBy,
+  Ot as isEntityInternalName,
+  wt as isEntityMatchRuleGroup,
+  Qe as isRuleGroup,
   u as setSafeObjectKey,
-  N as setSafeObjectKeyLazyInitOnce,
+  w as setSafeObjectKeyLazyInitOnce,
   Q as setSafeObjectWritableKey,
-  He as transitionMetadata,
-  Ue as uuid
+  ze as transitionMetadata,
+  ke as uuid
 };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@aiao/rxdb",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "type": "module",
   "main": "./index.js",
   "dependencies": {
     "uuid": "^11.1.0",
     "type-fest": "^4.41.0",
-    "@aiao/utils": "0.0.1",
+    "@aiao/utils": "0.0.2",
     "rxjs": "~7.8.0"
   },
   ".": {

package/rxdb-utils.d.ts

@@ -15,6 +15,6 @@ export declare const getEntityStatus: <T extends EntityType>(target: InstanceTyp
  */
 export declare const __decorateClass: (decorators: any, target: any, key: any, kind: number) => any;
 /**
- * 生成 uuid
+ * 生成 uuid v7
  */
 export declare const uuid: () => UUID;

package/rxdb.interface.d.ts

@@ -1,7 +1,7 @@
 import { SyncOptions } from './entity/entity-metadata-options.interface';
 import { EntityType } from './entity/entity.interface';
 /**
- * 升级脚步
+ * 升级脚本
  */
 export interface MigrationType {
     up(): Promise<void>;
@@ -11,6 +11,9 @@ export interface MigrationType {
  * RxDB 环境上下文
  */
 export interface RxDBContext {
+    /**
+     * 用户 ID
+     */
     userId?: string;
 }
 /**

package/rxdb.private.d.ts

@@ -23,9 +23,21 @@ export declare const STATUS_CHECK: unique symbol;
  * 实体管理器
  */
 export declare const ENTITY_MANAGER: unique symbol;
+/**
+ * 实体删除检查
+ */
 export declare const ɵEntityDeleteCheck: unique symbol;
+/**
+ * 更新者
+ */
 export declare const UPDATED_BY: unique symbol;
+/**
+ * 更新来自系统
+ */
 export declare const UPDATED_BY_SYSTEM: string;
+/**
+ * 更新来自用户
+ */
 export declare const UPDATED_BY_USER: string;
 export type UpdatedBy = typeof UPDATED_BY_SYSTEM | typeof UPDATED_BY_USER | UUID | null;
 /**
@@ -44,7 +56,20 @@ export declare const isDatabaseEvent: (event: RxDBEvent) => boolean;
  * 实体管理内部方法
  */
 export type EntityManagerPrivate = {
+    /**
+     * 设置实体代理创建函数
+     * 用于创建新的实体代理对象，并初始化其状态
+     *
+     * @param entity - 要代理的实体
+     * @returns 代理后的实体实例
+     */
     [ɵProxy]: (entity: any) => any;
+    /**
+     * 设置实体删除检查函数
+     * 用于处理数据库适配器的删除事件，更新实体状态
+     *
+     * @param event - 删除事件
+     */
     [ɵEntityDeleteCheck]: (event: RxDBEvent) => void;
 } & EntityManager;
 /**