@aiao/rxdb-devtools 0.0.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Aiao Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+# rxdb-devtools

package/dist/buffer.d.ts

@@ -0,0 +1,24 @@
+import { SerializedEvent } from './types.js';
+/**
+ * 事件缓冲区类
+ * FIFO 策略：当缓冲区满时，移除最旧的事件
+ */
+export declare class EventBuffer {
+    #private;
+    /** 当前缓冲区大小 */
+    get length(): number;
+    /** 最大缓冲区大小 */
+    get maxSize(): number;
+    /** 缓冲区是否为空 */
+    get isEmpty(): boolean;
+    /** 缓冲区是否已满 */
+    get isFull(): boolean;
+    constructor(maxSize?: number);
+    /** 添加事件到缓冲区 */
+    push(event: SerializedEvent): void;
+    /** 清空并返回所有缓冲的事件 */
+    flush(): SerializedEvent[];
+    /** 清空缓冲区 */
+    clear(): void;
+}
+//# sourceMappingURL=buffer.d.ts.map

package/dist/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../src/buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKlD;;;GAGG;AACH,qBAAa,WAAW;;IAItB,cAAc;IACd,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,cAAc;IACd,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,cAAc;IACd,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,cAAc;IACd,IAAI,MAAM,IAAI,OAAO,CAEpB;gBAEW,OAAO,SAAmB;IAItC,eAAe;IACf,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAOlC,mBAAmB;IACnB,KAAK,IAAI,eAAe,EAAE;IAM1B,YAAY;IACZ,KAAK,IAAI,IAAI;CAGd"}

package/dist/connector.d.ts

@@ -0,0 +1,74 @@
+/**
+ * DevTools 连接器
+ * 负责与 Chrome DevTools Extension 建立通信
+ */
+/** RxDB 事件类型 */
+interface RxDBEventData {
+    type: string;
+    [key: string]: unknown;
+}
+/** 实体元数据接口 */
+interface EntityMeta {
+    name: string;
+    namespace?: string;
+    version?: number;
+}
+/** 实体类型 */
+type EntityType = new (...args: unknown[]) => unknown;
+/** 获取实体元数据的函数类型 */
+type GetEntityMetadataFn = (entity: EntityType) => EntityMeta | undefined;
+/** RxDB 实例接口（避免直接依赖 @aiao/rxdb） */
+interface RxDBInstance {
+    addEventListener(type: string, listener: (event: RxDBEventData) => void): void;
+    removeEventListener(type: string, listener: (event: RxDBEventData) => void): void;
+    version?: string;
+    config?: {
+        dbName?: string;
+        entities?: EntityType[];
+    };
+    entityManager?: {
+        getRepository(entity: EntityType): {
+            findAll(options: {
+                where: {
+                    combinator: string;
+                    rules: unknown[];
+                };
+                orderBy: {
+                    field: string;
+                    sort: string;
+                }[];
+                limit?: number;
+            }): {
+                subscribe(callback: (data: unknown[]) => void): {
+                    unsubscribe(): void;
+                };
+            };
+        };
+    };
+}
+/** DevTools 配置选项 */
+export interface DevToolsOptions {
+    maxBufferSize?: number;
+    enabled?: boolean;
+}
+/**
+ * DevTools 连接器类
+ */
+export declare class DevToolsConnector {
+    #private;
+    /** 连接状态 */
+    get connected(): boolean;
+    /** 是否启用 */
+    get enabled(): boolean;
+    constructor(options?: DevToolsOptions);
+    /** 初始化连接 */
+    init(rxdb: RxDBInstance | any, getEntityMetadata?: GetEntityMetadataFn): void;
+    /** 断开连接 */
+    disconnect(): void;
+}
+/** 获取或创建全局连接器 */
+export declare function getDevToolsConnector(options?: DevToolsOptions): DevToolsConnector;
+/** 重置全局连接器（用于测试） */
+export declare function resetDevToolsConnector(): void;
+export {};
+//# sourceMappingURL=connector.d.ts.map

package/dist/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,gBAAgB;AAChB,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,cAAc;AACd,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,WAAW;AACX,KAAK,UAAU,GAAG,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAEtD,mBAAmB;AACnB,KAAK,mBAAmB,GAAG,CAAC,MAAM,EAAE,UAAU,KAAK,UAAU,GAAG,SAAS,CAAC;AAE1E,mCAAmC;AACnC,UAAU,YAAY;IACpB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/E,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAAC;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;KACzB,CAAC;IACF,aAAa,CAAC,EAAE;QACd,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG;YACjC,OAAO,CAAC,OAAO,EAAE;gBACf,KAAK,EAAE;oBAAE,UAAU,EAAE,MAAM,CAAC;oBAAC,KAAK,EAAE,OAAO,EAAE,CAAA;iBAAE,CAAC;gBAChD,OAAO,EAAE;oBAAE,KAAK,EAAE,MAAM,CAAC;oBAAC,IAAI,EAAE,MAAM,CAAA;iBAAE,EAAE,CAAC;gBAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;aAChB,GAAG;gBAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG;oBAAE,WAAW,IAAI,IAAI,CAAA;iBAAE,CAAA;aAAE,CAAC;SACjF,CAAC;KACH,CAAC;CACH;AAED,oBAAoB;AACpB,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAiCD;;GAEG;AACH,qBAAa,iBAAiB;;IAU5B,WAAW;IACX,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,WAAW;IACX,IAAI,OAAO,IAAI,OAAO,CAErB;gBAEW,OAAO,GAAE,eAAoB;IAMzC,YAAY;IACZ,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,GAAG,EAAE,iBAAiB,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAW7E,WAAW;IACX,UAAU,IAAI,IAAI;CA+VnB;AAKD,iBAAiB;AACjB,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,iBAAiB,CAKjF;AAED,oBAAoB;AACpB,wBAAgB,sBAAsB,IAAI,IAAI,CAK7C"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { DevToolsConnector, getDevToolsConnector, resetDevToolsConnector } from './connector.js';
+export type { DevToolsOptions } from './connector.js';
+export { RXDB_DEVTOOLS_MESSAGE, createMessage, isDevToolsMessage, type AnyDevToolsMessage, type ClearMessage, type DevToolsMessage, type DisconnectMessage, type EventMessage, type HandshakeAckMessage, type HandshakeMessage, type MessageDirection, type MessageType, type PingMessage, type PongMessage, type SerializedEvent } from './types.js';
+export { EventBuffer } from './buffer.js';
+export { SequenceGenerator } from './sequence.js';
+export { deserialize, serialize } from './serializer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACjG,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,429 @@
+class E {
+  #e = [];
+  #s;
+  /** 当前缓冲区大小 */
+  get length() {
+    return this.#e.length;
+  }
+  /** 最大缓冲区大小 */
+  get maxSize() {
+    return this.#s;
+  }
+  /** 缓冲区是否为空 */
+  get isEmpty() {
+    return this.#e.length === 0;
+  }
+  /** 缓冲区是否已满 */
+  get isFull() {
+    return this.#e.length >= this.#s;
+  }
+  constructor(e = 100) {
+    this.#s = e;
+  }
+  /** 添加事件到缓冲区 */
+  push(e) {
+    this.#e.length >= this.#s && this.#e.shift(), this.#e.push(e);
+  }
+  /** 清空并返回所有缓冲的事件 */
+  flush() {
+    const e = [...this.#e];
+    return this.#e = [], e;
+  }
+  /** 清空缓冲区 */
+  clear() {
+    this.#e = [];
+  }
+}
+class T {
+  #e = 0;
+  /** 获取当前序列号（不递增） */
+  get current() {
+    return this.#e;
+  }
+  /** 获取下一个序列号 */
+  next() {
+    return ++this.#e;
+  }
+  /** 重置序列号 */
+  reset() {
+    this.#e = 0;
+  }
+}
+let p = 0;
+function y() {
+  return `evt_${Date.now()}_${++p}`;
+}
+function f(n, e = /* @__PURE__ */ new WeakSet()) {
+  if (n == null) return n;
+  const t = typeof n;
+  if (t === "string" || t === "number" || t === "boolean")
+    return n;
+  if (!(t === "function" || t === "symbol")) {
+    if (n instanceof Date)
+      return n.toISOString();
+    if (Array.isArray(n))
+      return n.map((s) => f(s, e)).filter((s) => s !== void 0);
+    if (t === "object") {
+      if (e.has(n))
+        return "[Circular]";
+      e.add(n);
+      const s = {};
+      for (const r of Object.keys(n)) {
+        if (typeof r == "symbol") continue;
+        const o = n[r], c = f(o, e);
+        c !== void 0 && (s[r] = c);
+      }
+      return s;
+    }
+  }
+}
+function v(n, e) {
+  const t = n, { type: s, ...r } = t;
+  return {
+    id: y(),
+    eventType: s,
+    timestamp: Date.now(),
+    sequence: e,
+    data: f(r)
+  };
+}
+function _(n) {
+  return {
+    id: n.id,
+    eventType: n.eventType,
+    timestamp: n.timestamp,
+    sequence: n.sequence,
+    data: n.data
+  };
+}
+const d = "@aiao/rxdb-devtools";
+function N(n) {
+  return typeof n != "object" || n === null ? !1 : n.source === d;
+}
+function i(n, e, t, s) {
+  return {
+    source: d,
+    direction: e,
+    type: n,
+    payload: t,
+    timestamp: Date.now(),
+    sequence: s
+  };
+}
+const g = {
+  maxBufferSize: 100,
+  enabled: !0
+}, m = [
+  // 'ENTITY_LOCAL_NEW',
+  "ENTITY_LOCAL_CREATE",
+  "ENTITY_LOCAL_UPDATE",
+  "ENTITY_LOCAL_REMOVE",
+  "ENTITY_REMOTE_CREATE",
+  "ENTITY_REMOTE_UPDATE",
+  "ENTITY_REMOTE_REMOVE",
+  // 'TRANSACTION_BEGIN',
+  // 'TRANSACTION_COMMIT',
+  // 'TRANSACTION_ROLLBACK',
+  "SWITCH_BRANCH_BEGIN",
+  "SWITCH_BRANCH_COMMIT",
+  "SWITCH_BRANCH_ROLLBACK",
+  "SYNC_BEGIN",
+  "SYNC_COMPLETE",
+  "SYNC_ERROR",
+  "CONFLICT_DETECTED",
+  "CONFLICT_PENDING",
+  "REPOSITORY_SYNC_BEGIN",
+  "REPOSITORY_SYNC_COMPLETE",
+  "REPOSITORY_SYNC_ERROR"
+];
+class C {
+  #e;
+  #s = !1;
+  #c;
+  #t;
+  #r = /* @__PURE__ */ new Set();
+  #l = /* @__PURE__ */ new Map();
+  #o = null;
+  #a = null;
+  #h = /* @__PURE__ */ new Map();
+  /** 连接状态 */
+  get connected() {
+    return this.#s;
+  }
+  /** 是否启用 */
+  get enabled() {
+    return this.#e.enabled;
+  }
+  constructor(e = {}) {
+    this.#e = { ...g, ...e }, this.#c = new E(this.#e.maxBufferSize), this.#t = new T();
+  }
+  /** 初始化连接 */
+  init(e, t) {
+    !this.#e.enabled || typeof window > "u" || this.#r.has(e) || (this.#d(), this.#u(), this.#r.add(e), t && (this.#a = t), this.#m(e));
+  }
+  /** 断开连接 */
+  disconnect() {
+    if (!(typeof window > "u")) {
+      this.#n(i("DISCONNECT", "page-to-devtools", null, this.#t.next())), this.#o && (window.removeEventListener("message", this.#o), this.#o = null);
+      for (const e of this.#r)
+        this.#C(e);
+      this.#r.clear(), this.#s = !1, this.#c.clear(), this.#t.reset();
+    }
+  }
+  /** 设置消息监听器 */
+  #d() {
+    this.#o = (e) => {
+      if (e.source !== window || !N(e.data)) return;
+      const t = e.data;
+      t.direction === "devtools-to-page" && this.#E(t);
+    }, window.addEventListener("message", this.#o);
+  }
+  /** 处理来自 DevTools 的消息 */
+  #E(e) {
+    switch (e.type) {
+      case "HANDSHAKE_ACK":
+        this.#T();
+        break;
+      case "PING":
+        this.#u();
+        break;
+      case "CLEAR":
+        break;
+      case "DISCONNECT":
+        this.#s = !1;
+        break;
+      case "INSPECT_DB":
+        this.#p();
+        break;
+      case "QUERY_ENTITY":
+        this.#y(e.payload);
+        break;
+      case "GET_BRANCHES":
+        this.#i();
+        break;
+      case "SWITCH_BRANCH":
+        this.#v(e.payload);
+        break;
+      case "CREATE_BRANCH":
+        this.#N(e.payload);
+        break;
+    }
+  }
+  /** 发送握手消息 */
+  #u() {
+    this.#n(i("HANDSHAKE", "page-to-devtools", null, this.#t.next()));
+  }
+  /** 握手确认处理 */
+  #T() {
+    this.#s = !0, this.#g();
+  }
+  /** 处理数据库检查请求 */
+  #p() {
+    const e = Array.from(this.#r)[0];
+    if (!e || !this.#a) {
+      this.#n(i("DB_INFO", "page-to-devtools", null, this.#t.next()));
+      return;
+    }
+    const t = [];
+    if (e.config?.entities)
+      for (const r of e.config.entities) {
+        const o = this.#a(r);
+        o?.name && t.push({
+          name: o.name,
+          namespace: o.namespace || "public",
+          entityType: r
+        });
+      }
+    const s = {
+      version: e.version || "unknown",
+      dbName: e.config?.dbName || "unknown",
+      entities: t.map((r) => ({ name: r.name, namespace: r.namespace }))
+    };
+    this.#h = new Map(t.map((r) => [r.name, r.entityType])), this.#n(i("DB_INFO", "page-to-devtools", s, this.#t.next()));
+  }
+  /** 处理实体查询请求 */
+  #y(e) {
+    const t = Array.from(this.#r)[0];
+    if (!t?.entityManager) {
+      this.#n(
+        i(
+          "ENTITY_DATA",
+          "page-to-devtools",
+          { entityName: e.entityName, error: "RxDB 未初始化", data: [] },
+          this.#t.next()
+        )
+      );
+      return;
+    }
+    const s = this.#h.get(e.entityName);
+    if (!s) {
+      this.#n(
+        i(
+          "ENTITY_DATA",
+          "page-to-devtools",
+          { entityName: e.entityName, error: `实体 ${e.entityName} 不存在`, data: [] },
+          this.#t.next()
+        )
+      );
+      return;
+    }
+    try {
+      const c = t.entityManager.getRepository(s).findAll({
+        where: { combinator: "and", rules: [] },
+        orderBy: [{ field: "id", sort: "desc" }],
+        limit: e.limit || 1e3
+      }).subscribe((l) => {
+        c.unsubscribe();
+        const u = l.map((a) => {
+          try {
+            return a && typeof a == "object" && "toJSON" in a ? JSON.parse(JSON.stringify(a.toJSON())) : JSON.parse(JSON.stringify(a));
+          } catch {
+            return { id: a?.id, _error: "Cannot serialize" };
+          }
+        });
+        this.#n(
+          i(
+            "ENTITY_DATA",
+            "page-to-devtools",
+            { entityName: e.entityName, error: null, data: u },
+            this.#t.next()
+          )
+        );
+      });
+    } catch (r) {
+      console.error("[RxDB DevTools Connector] Query error:", r), this.#n(
+        i(
+          "ENTITY_DATA",
+          "page-to-devtools",
+          { entityName: e.entityName, error: r.message, data: [] },
+          this.#t.next()
+        )
+      );
+    }
+  }
+  /** 处理获取分支列表请求 */
+  #i() {
+    const e = Array.from(this.#r)[0];
+    if (!e?.entityManager) {
+      this.#n(i("BRANCHES", "page-to-devtools", [], this.#t.next()));
+      return;
+    }
+    let t = this.#h.get("RxDBBranch");
+    if (!t && e.config?.entities && this.#a) {
+      for (const s of e.config.entities)
+        if (this.#a(s)?.name === "RxDBBranch") {
+          t = s, this.#h.set("RxDBBranch", s);
+          break;
+        }
+    }
+    if (!t) {
+      this.#n(i("BRANCHES", "page-to-devtools", [], this.#t.next()));
+      return;
+    }
+    try {
+      const o = e.entityManager.getRepository(t).findAll({
+        where: { combinator: "and", rules: [] },
+        orderBy: [{ field: "id", sort: "desc" }]
+      }).subscribe((c) => {
+        o.unsubscribe();
+        const l = c.map((u) => {
+          const a = u;
+          return { id: a.id || "", activated: a.activated || !1 };
+        });
+        this.#n(i("BRANCHES", "page-to-devtools", l, this.#t.next()));
+      });
+    } catch (s) {
+      console.error("[RxDB DevTools Connector] Get branches error:", s), this.#n(i("BRANCHES", "page-to-devtools", [], this.#t.next()));
+    }
+  }
+  /** 处理切换分支请求 */
+  #v(e) {
+    const t = Array.from(this.#r)[0];
+    if (!t?.versionManager) {
+      console.error("[RxDB DevTools Connector] versionManager not available"), this.#i();
+      return;
+    }
+    t.versionManager.switchBranch(e).then(() => {
+      this.#i();
+    }).catch((s) => {
+      console.error("[RxDB DevTools Connector] Switch branch error:", s), this.#i();
+    });
+  }
+  /** 处理创建分支请求 */
+  #N(e) {
+    const t = Array.from(this.#r)[0];
+    if (!t?.versionManager) {
+      console.error("[RxDB DevTools Connector] versionManager not available"), this.#i();
+      return;
+    }
+    t.versionManager.createBranch(e).then(() => {
+      this.#i();
+    }).catch((s) => {
+      console.error("[RxDB DevTools Connector] Create branch error:", s), this.#i();
+    });
+  }
+  /** 刷新缓冲区 */
+  #g() {
+    const e = this.#c.flush();
+    for (const t of e)
+      this.#f(t);
+  }
+  /** 订阅 RxDB 事件 */
+  #m(e) {
+    const t = /* @__PURE__ */ new Map();
+    for (const s of m) {
+      const r = (o) => {
+        this.#_(o);
+      };
+      e.addEventListener(s, r), t.set(s, r);
+    }
+    this.#l.set(e, t);
+  }
+  /** 取消订阅 RxDB 事件 */
+  #C(e) {
+    const t = this.#l.get(e);
+    if (t) {
+      for (const [s, r] of t)
+        e.removeEventListener(s, r);
+      this.#l.delete(e);
+    }
+  }
+  /** 处理 RxDB 事件 */
+  #_(e) {
+    const t = v(e, this.#t.next());
+    this.#s ? this.#f(t) : this.#c.push(t), e.type === "SWITCH_BRANCH_COMMIT" && this.#i();
+  }
+  /** 发送事件到 DevTools */
+  #f(e) {
+    const t = i("EVENT", "page-to-devtools", e, e.sequence);
+    this.#n(t);
+  }
+  /** 发送消息到 window */
+  #n(e) {
+    if (!(typeof window > "u"))
+      try {
+        window.postMessage(e, "*");
+      } catch (t) {
+        console.warn(`[${d}] Failed to post message:`, t);
+      }
+  }
+}
+let h = null;
+function b(n) {
+  return h || (h = new C(n)), h;
+}
+function A() {
+  h && (h.disconnect(), h = null);
+}
+export {
+  C as DevToolsConnector,
+  E as EventBuffer,
+  d as RXDB_DEVTOOLS_MESSAGE,
+  T as SequenceGenerator,
+  i as createMessage,
+  _ as deserialize,
+  b as getDevToolsConnector,
+  N as isDevToolsMessage,
+  A as resetDevToolsConnector,
+  v as serialize
+};

package/dist/sequence.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 序列号生成器
+ * 生成单调递增的序列号，用于事件排序
+ */
+/**
+ * 序列号生成器类
+ */
+export declare class SequenceGenerator {
+    #private;
+    /** 获取当前序列号（不递增） */
+    get current(): number;
+    /** 获取下一个序列号 */
+    next(): number;
+    /** 重置序列号 */
+    reset(): void;
+}
+//# sourceMappingURL=sequence.d.ts.map

package/dist/sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../src/sequence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,qBAAa,iBAAiB;;IAG5B,mBAAmB;IACnB,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,eAAe;IACf,IAAI,IAAI,MAAM;IAId,YAAY;IACZ,KAAK,IAAI,IAAI;CAGd"}

package/dist/serializer.d.ts

@@ -0,0 +1,14 @@
+import { SerializedEvent } from './types.js';
+/**
+ * 序列化 RxDB 事件
+ */
+export declare function serialize(event: {
+    type: string;
+}, sequence: number): SerializedEvent;
+/**
+ * 反序列化事件（主要用于类型转换）
+ */
+export declare function deserialize(data: SerializedEvent): SerializedEvent;
+/** 重置事件 ID 计数器（用于测试） */
+export declare function resetEventIdCounter(): void;
+//# sourceMappingURL=serializer.d.ts.map

package/dist/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA8DlD;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAWpF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,CAQlE;AAED,wBAAwB;AACxB,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * RxDB DevTools 消息协议类型定义
+ */
+/** 消息来源标识符 */
+export declare const RXDB_DEVTOOLS_MESSAGE: "@aiao/rxdb-devtools";
+/** 消息方向 */
+export type MessageDirection = 'page-to-devtools' | 'devtools-to-page';
+/** 消息类型 */
+export type MessageType = 'HANDSHAKE' | 'HANDSHAKE_ACK' | 'EVENT' | 'DISCONNECT' | 'CLEAR' | 'PING' | 'PONG' | 'INSPECT_DB' | 'DB_INFO' | 'QUERY_ENTITY' | 'ENTITY_DATA' | 'GET_BRANCHES' | 'BRANCHES' | 'SWITCH_BRANCH' | 'CREATE_BRANCH';
+/** 基础消息结构 */
+export interface DevToolsMessage<T = unknown> {
+    source: typeof RXDB_DEVTOOLS_MESSAGE;
+    direction: MessageDirection;
+    type: MessageType;
+    payload: T;
+    timestamp: number;
+    sequence: number;
+}
+/** 握手消息 */
+export interface HandshakeMessage extends DevToolsMessage<null> {
+    type: 'HANDSHAKE';
+    direction: 'page-to-devtools';
+}
+/** 握手确认消息 */
+export interface HandshakeAckMessage extends DevToolsMessage<null> {
+    type: 'HANDSHAKE_ACK';
+    direction: 'devtools-to-page';
+}
+/** 序列化后的事件 */
+export interface SerializedEvent {
+    id: string;
+    eventType: string;
+    timestamp: number;
+    sequence: number;
+    data: Record<string, unknown>;
+}
+/** 事件消息 */
+export interface EventMessage extends DevToolsMessage<SerializedEvent> {
+    type: 'EVENT';
+    direction: 'page-to-devtools';
+}
+/** 断开连接消息 */
+export interface DisconnectMessage extends DevToolsMessage<null> {
+    type: 'DISCONNECT';
+}
+/** 清除事件消息 */
+export interface ClearMessage extends DevToolsMessage<null> {
+    type: 'CLEAR';
+    direction: 'devtools-to-page';
+}
+/** Ping 消息 */
+export interface PingMessage extends DevToolsMessage<null> {
+    type: 'PING';
+}
+/** Pong 消息 */
+export interface PongMessage extends DevToolsMessage<null> {
+    type: 'PONG';
+}
+/** 所有消息类型联合 */
+export type AnyDevToolsMessage = HandshakeMessage | HandshakeAckMessage | EventMessage | DisconnectMessage | ClearMessage | PingMessage | PongMessage | DevToolsMessage<unknown>;
+/** 类型守卫：检查是否为 DevTools 消息 */
+export declare function isDevToolsMessage(data: unknown): data is AnyDevToolsMessage;
+/** 创建消息的工厂函数 */
+export declare function createMessage<T>(type: MessageType, direction: MessageDirection, payload: T, sequence: number): DevToolsMessage<T>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc;AACd,eAAO,MAAM,qBAAqB,EAAG,qBAA8B,CAAC;AAEpE,WAAW;AACX,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAEvE,WAAW;AACX,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,eAAe,GACf,OAAO,GACP,YAAY,GACZ,OAAO,GACP,MAAM,GACN,MAAM,GACN,YAAY,GACZ,SAAS,GACT,cAAc,GACd,aAAa,GACb,cAAc,GACd,UAAU,GACV,eAAe,GACf,eAAe,CAAC;AAEpB,aAAa;AACb,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,MAAM,EAAE,OAAO,qBAAqB,CAAC;IACrC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,WAAW;AACX,MAAM,WAAW,gBAAiB,SAAQ,eAAe,CAAC,IAAI,CAAC;IAC7D,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,aAAa;AACb,MAAM,WAAW,mBAAoB,SAAQ,eAAe,CAAC,IAAI,CAAC;IAChE,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,cAAc;AACd,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,WAAW;AACX,MAAM,WAAW,YAAa,SAAQ,eAAe,CAAC,eAAe,CAAC;IACpE,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,aAAa;AACb,MAAM,WAAW,iBAAkB,SAAQ,eAAe,CAAC,IAAI,CAAC;IAC9D,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,aAAa;AACb,MAAM,WAAW,YAAa,SAAQ,eAAe,CAAC,IAAI,CAAC;IACzD,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,cAAc;AACd,MAAM,WAAW,WAAY,SAAQ,eAAe,CAAC,IAAI,CAAC;IACxD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,cAAc;AACd,MAAM,WAAW,WAAY,SAAQ,eAAe,CAAC,IAAI,CAAC;IACxD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAe;AACf,MAAM,MAAM,kBAAkB,GAC1B,gBAAgB,GAChB,mBAAmB,GACnB,YAAY,GACZ,iBAAiB,GACjB,YAAY,GACZ,WAAW,GACX,WAAW,GACX,eAAe,CAAC,OAAO,CAAC,CAAC;AAE7B,6BAA6B;AAC7B,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,kBAAkB,CAI3E;AAED,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,CAAC,EAC7B,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,MAAM,GACf,eAAe,CAAC,CAAC,CAAC,CASpB"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@aiao/rxdb-devtools",
+  "version": "0.0.8",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@aiao/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "nx": {
+    "name": "rxdb-devtools",
+    "tags": [
+      "js-lib"
+    ]
+  },
+  "dependencies": {}
+}