@multiplatform.one/frappe 6.0.0

package/dist/esm/sync/realtime.mjs

@@ -0,0 +1,189 @@
+import { RealtimeEventType, RehydrationReason } from "./types.mjs";
+class RealtimeHandler {
+  constructor(db, realtime, normalizedCache, subscriptionManager, rehydrationManager, options = {}) {
+    this.db = db;
+    this.realtime = realtime;
+    this.normalizedCache = normalizedCache;
+    this.subscriptionManager = subscriptionManager;
+    this.rehydrationManager = rehydrationManager;
+    this.options = options;
+    this.connectionConfig = {
+      reconnectBaseDelay: options.connectionConfig?.reconnectBaseDelay ?? 1e3,
+      reconnectMaxDelay: options.connectionConfig?.reconnectMaxDelay ?? 3e4,
+      reconnectJitter: options.connectionConfig?.reconnectJitter ?? 0.25,
+      exponentialBackoff: options.connectionConfig?.exponentialBackoff ?? true
+    };
+    this.setupRealtimeHandlers();
+    this.setupConnectionManagement();
+  }
+  db;
+  realtime;
+  normalizedCache;
+  subscriptionManager;
+  rehydrationManager;
+  options;
+  reconnectAttempts = 0;
+  reconnectTimer;
+  hasConnected = false;
+  connectionConfig;
+  /**
+   * Sets up realtime event handlers for document changes.
+   */
+  setupRealtimeHandlers() {
+    if (!this.realtime) return;
+    this.realtime?.on("doc_changed", async payload => {
+      if (this.options.onRealtimeEvent) this.options.onRealtimeEvent({
+        type: RealtimeEventType.DocChanged,
+        payload
+      });
+      return this.onDocChanged(payload);
+    });
+    this.realtime?.on("doc_deleted", async payload => {
+      if (this.options.onRealtimeEvent) this.options.onRealtimeEvent({
+        type: RealtimeEventType.DocDeleted,
+        payload
+      });
+      return this.onDocDeleted(payload);
+    });
+    this.realtime?.on("perm_epoch_bump", () => {
+      if (this.options.onRealtimeEvent) this.options.onRealtimeEvent({
+        type: RealtimeEventType.PermEpochBump
+      });
+      if (this.options.onResetCache) {
+        this.options.onResetCache();
+      }
+    });
+    this.realtime?.on("connected", () => {
+      this.onConnected();
+    });
+    this.realtime?.on("disconnect", () => {
+      this.onDisconnected();
+    });
+  }
+  /**
+   * Sets up connection management with exponential backoff and jitter.
+   */
+  setupConnectionManagement() {
+    if (!this.realtime) return;
+    this.attemptConnection();
+  }
+  /**
+   * Handles successful connection.
+   */
+  onConnected() {
+    this.hasConnected = true;
+    this.reconnectAttempts = 0;
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = void 0;
+    }
+    if (this.options.onRealtimeEvent) {
+      this.options.onRealtimeEvent({
+        type: RealtimeEventType.Connected
+      });
+    }
+    if (this.options.onBackfillAll) {
+      this.options.onBackfillAll();
+    }
+    console.debug("[RealtimeHandler] Connected to realtime server");
+  }
+  /**
+   * Handles disconnection with automatic reconnection.
+   */
+  onDisconnected() {
+    console.debug("[RealtimeHandler] Disconnected from realtime server");
+    if (this.hasConnected) {
+      this.scheduleReconnection();
+    }
+  }
+  /**
+   * Attempts to connect to the realtime server.
+   */
+  attemptConnection() {
+    if (!this.realtime) return;
+  }
+  /**
+   * Schedules a reconnection attempt with exponential backoff and jitter.
+   */
+  scheduleReconnection() {
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+    }
+    const delay = this.calculateReconnectDelay();
+    console.debug(`[RealtimeHandler] Scheduling reconnection attempt ${this.reconnectAttempts + 1} in ${delay}ms`);
+    this.reconnectTimer = setTimeout(() => {
+      this.reconnectAttempts++;
+      this.attemptConnection();
+    }, delay);
+  }
+  /**
+   * Calculates the reconnection delay with exponential backoff and jitter.
+   */
+  calculateReconnectDelay() {
+    let delay = this.connectionConfig.reconnectBaseDelay;
+    if (this.connectionConfig.exponentialBackoff) {
+      delay = Math.min(this.connectionConfig.reconnectBaseDelay * 2 ** this.reconnectAttempts, this.connectionConfig.reconnectMaxDelay);
+    }
+    const jitterRange = delay * this.connectionConfig.reconnectJitter;
+    const jitter = (Math.random() * 2 - 1) * jitterRange;
+    delay = Math.round(delay + jitter);
+    return Math.max(this.connectionConfig.reconnectBaseDelay, Math.min(delay, this.connectionConfig.reconnectMaxDelay));
+  }
+  /**
+   * Realtime handler: authoritative document changed.
+   * Fetches document via REST with current user context to respect permissions,
+   * updates cache, and reconciles subscription membership.
+   */
+  async onDocChanged(payload) {
+    try {
+      const document = await this.db.getDoc(payload.doctype, payload.name);
+      this.normalizedCache.upsert(document);
+      const subscriptionsNeedingRehydration = this.subscriptionManager.updateSubscriptionMembership(document);
+      for (const subscription of subscriptionsNeedingRehydration) {
+        this.rehydrationManager?.scheduleRehydration(subscription, RehydrationReason.RemoteCreate);
+      }
+    } catch (err) {
+      console.warn(`Failed to fetch document ${payload?.doctype}/${payload?.name} during realtime update:`, err);
+    }
+  }
+  /**
+   * Realtime handler: evicts document from cache and subscriptions.
+   */
+  async onDocDeleted(payload) {
+    try {
+      this.normalizedCache.remove({
+        doctype: payload.doctype,
+        name: payload.name
+      });
+      const affectedSubscriptions = this.subscriptionManager.removeFromAllSubscriptions(payload.doctype, payload.name);
+      for (const subscription of affectedSubscriptions) {
+        this.rehydrationManager?.scheduleRehydration(subscription, RehydrationReason.Delete);
+      }
+    } catch (err) {
+      console.warn(`Failed to process doc_deleted for ${payload?.doctype}/${payload?.name}:`, err);
+    }
+  }
+  /**
+   * Checks if realtime is healthy for echo suppression decisions.
+   */
+  isRealtimeHealthy() {
+    return this.realtime?.isHealthy() ?? false;
+  }
+  getIsConnected() {
+    return this.hasConnected;
+  }
+  /**
+   * Disposes of resources and clears timers.
+   */
+  dispose() {
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = void 0;
+    }
+    if (this.realtime) {
+      this.realtime?.disconnect();
+    }
+  }
+}
+export { RealtimeHandler };
+//# sourceMappingURL=realtime.mjs.map

package/dist/esm/sync/realtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["RealtimeEventType","RehydrationReason","RealtimeHandler","constructor","db","realtime","normalizedCache","subscriptionManager","rehydrationManager","options","connectionConfig","reconnectBaseDelay","reconnectMaxDelay","reconnectJitter","exponentialBackoff","setupRealtimeHandlers","setupConnectionManagement","reconnectAttempts","reconnectTimer","hasConnected","on","payload","onRealtimeEvent","type","DocChanged","onDocChanged","DocDeleted","onDocDeleted","PermEpochBump","onResetCache","onConnected","onDisconnected","attemptConnection","clearTimeout","Connected","onBackfillAll","console","debug","scheduleReconnection","delay","calculateReconnectDelay","setTimeout","Math","min","jitterRange","jitter","random","round","max","document","getDoc","doctype","name","upsert","subscriptionsNeedingRehydration","updateSubscriptionMembership","subscription","scheduleRehydration","RemoteCreate","err","warn","remove","affectedSubscriptions","removeFromAllSubscriptions","Delete","isRealtimeHealthy","isHealthy","getIsConnected","dispose","disconnect"],"sources":["../../../src/sync/realtime.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/sync/realtime.native.js

@@ -0,0 +1,312 @@
+import { RealtimeEventType, RehydrationReason } from "./types.native.js";
+function _class_call_check(instance, Constructor) {
+  if (!(instance instanceof Constructor)) {
+    throw new TypeError("Cannot call a class as a function");
+  }
+}
+function _defineProperties(target, props) {
+  for (var i = 0; i < props.length; i++) {
+    var descriptor = props[i];
+    descriptor.enumerable = descriptor.enumerable || false;
+    descriptor.configurable = true;
+    if ("value" in descriptor) descriptor.writable = true;
+    Object.defineProperty(target, descriptor.key, descriptor);
+  }
+}
+function _create_class(Constructor, protoProps, staticProps) {
+  if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+  if (staticProps) _defineProperties(Constructor, staticProps);
+  return Constructor;
+}
+function _define_property(obj, key, value) {
+  if (key in obj) {
+    Object.defineProperty(obj, key, {
+      value,
+      enumerable: true,
+      configurable: true,
+      writable: true
+    });
+  } else {
+    obj[key] = value;
+  }
+  return obj;
+}
+var RealtimeHandler = /* @__PURE__ */function () {
+  "use strict";
+
+  function RealtimeHandler2(db, realtime, normalizedCache, subscriptionManager, rehydrationManager) {
+    var options = arguments.length > 5 && arguments[5] !== void 0 ? arguments[5] : {};
+    _class_call_check(this, RealtimeHandler2);
+    var _ref, _ref1, _ref2, _ref3;
+    var _options_connectionConfig, _options_connectionConfig1, _options_connectionConfig2, _options_connectionConfig3;
+    _define_property(this, "db", void 0);
+    _define_property(this, "realtime", void 0);
+    _define_property(this, "normalizedCache", void 0);
+    _define_property(this, "subscriptionManager", void 0);
+    _define_property(this, "rehydrationManager", void 0);
+    _define_property(this, "options", void 0);
+    _define_property(this, "reconnectAttempts", void 0);
+    _define_property(this, "reconnectTimer", void 0);
+    _define_property(this, "hasConnected", void 0);
+    _define_property(this, "connectionConfig", void 0);
+    this.db = db;
+    this.realtime = realtime;
+    this.normalizedCache = normalizedCache;
+    this.subscriptionManager = subscriptionManager;
+    this.rehydrationManager = rehydrationManager;
+    this.options = options;
+    this.reconnectAttempts = 0;
+    this.hasConnected = false;
+    this.connectionConfig = {
+      reconnectBaseDelay: (_ref = (_options_connectionConfig = options.connectionConfig) === null || _options_connectionConfig === void 0 ? void 0 : _options_connectionConfig.reconnectBaseDelay) !== null && _ref !== void 0 ? _ref : 1e3,
+      reconnectMaxDelay: (_ref1 = (_options_connectionConfig1 = options.connectionConfig) === null || _options_connectionConfig1 === void 0 ? void 0 : _options_connectionConfig1.reconnectMaxDelay) !== null && _ref1 !== void 0 ? _ref1 : 3e4,
+      reconnectJitter: (_ref2 = (_options_connectionConfig2 = options.connectionConfig) === null || _options_connectionConfig2 === void 0 ? void 0 : _options_connectionConfig2.reconnectJitter) !== null && _ref2 !== void 0 ? _ref2 : 0.25,
+      exponentialBackoff: (_ref3 = (_options_connectionConfig3 = options.connectionConfig) === null || _options_connectionConfig3 === void 0 ? void 0 : _options_connectionConfig3.exponentialBackoff) !== null && _ref3 !== void 0 ? _ref3 : true
+    };
+    this.setupRealtimeHandlers();
+    this.setupConnectionManagement();
+  }
+  _create_class(RealtimeHandler2, [{
+    key: "setupRealtimeHandlers",
+    value: (
+    /**
+    * Sets up realtime event handlers for document changes.
+    */
+    function setupRealtimeHandlers() {
+      var _this = this;
+      var _this_realtime, _this_realtime1, _this_realtime2, _this_realtime3, _this_realtime4;
+      if (!this.realtime) return;
+      (_this_realtime = this.realtime) === null || _this_realtime === void 0 ? void 0 : _this_realtime.on("doc_changed", async function (payload) {
+        if (_this.options.onRealtimeEvent) _this.options.onRealtimeEvent({
+          type: RealtimeEventType.DocChanged,
+          payload
+        });
+        return _this.onDocChanged(payload);
+      });
+      (_this_realtime1 = this.realtime) === null || _this_realtime1 === void 0 ? void 0 : _this_realtime1.on("doc_deleted", async function (payload) {
+        if (_this.options.onRealtimeEvent) _this.options.onRealtimeEvent({
+          type: RealtimeEventType.DocDeleted,
+          payload
+        });
+        return _this.onDocDeleted(payload);
+      });
+      (_this_realtime2 = this.realtime) === null || _this_realtime2 === void 0 ? void 0 : _this_realtime2.on("perm_epoch_bump", function () {
+        if (_this.options.onRealtimeEvent) _this.options.onRealtimeEvent({
+          type: RealtimeEventType.PermEpochBump
+        });
+        if (_this.options.onResetCache) {
+          _this.options.onResetCache();
+        }
+      });
+      (_this_realtime3 = this.realtime) === null || _this_realtime3 === void 0 ? void 0 : _this_realtime3.on("connected", function () {
+        _this.onConnected();
+      });
+      (_this_realtime4 = this.realtime) === null || _this_realtime4 === void 0 ? void 0 : _this_realtime4.on("disconnect", function () {
+        _this.onDisconnected();
+      });
+    })
+  }, {
+    key: "setupConnectionManagement",
+    value: (
+    /**
+    * Sets up connection management with exponential backoff and jitter.
+    */
+    function setupConnectionManagement() {
+      if (!this.realtime) return;
+      this.attemptConnection();
+    })
+  }, {
+    key: "onConnected",
+    value: (
+    /**
+    * Handles successful connection.
+    */
+    function onConnected() {
+      this.hasConnected = true;
+      this.reconnectAttempts = 0;
+      if (this.reconnectTimer) {
+        clearTimeout(this.reconnectTimer);
+        this.reconnectTimer = void 0;
+      }
+      if (this.options.onRealtimeEvent) {
+        this.options.onRealtimeEvent({
+          type: RealtimeEventType.Connected
+        });
+      }
+      if (this.options.onBackfillAll) {
+        this.options.onBackfillAll();
+      }
+      console.debug("[RealtimeHandler] Connected to realtime server");
+    })
+  }, {
+    key: "onDisconnected",
+    value: (
+    /**
+    * Handles disconnection with automatic reconnection.
+    */
+    function onDisconnected() {
+      console.debug("[RealtimeHandler] Disconnected from realtime server");
+      if (this.hasConnected) {
+        this.scheduleReconnection();
+      }
+    })
+  }, {
+    key: "attemptConnection",
+    value: (
+    /**
+    * Attempts to connect to the realtime server.
+    */
+    function attemptConnection() {
+      if (!this.realtime) return;
+    })
+  }, {
+    key: "scheduleReconnection",
+    value:
+    // RealtimeModule handles reconnection internally via its reconnection config.
+    // Handlers are already attached in the constructor via setupRealtimeHandlers().
+    /**
+    * Schedules a reconnection attempt with exponential backoff and jitter.
+    */
+    function scheduleReconnection() {
+      var _this = this;
+      if (this.reconnectTimer) {
+        clearTimeout(this.reconnectTimer);
+      }
+      var delay = this.calculateReconnectDelay();
+      console.debug(`[RealtimeHandler] Scheduling reconnection attempt ${this.reconnectAttempts + 1} in ${delay}ms`);
+      this.reconnectTimer = setTimeout(function () {
+        _this.reconnectAttempts++;
+        _this.attemptConnection();
+      }, delay);
+    }
+  }, {
+    key: "calculateReconnectDelay",
+    value: (
+    /**
+    * Calculates the reconnection delay with exponential backoff and jitter.
+    */
+    function calculateReconnectDelay() {
+      var delay = this.connectionConfig.reconnectBaseDelay;
+      if (this.connectionConfig.exponentialBackoff) {
+        delay = Math.min(this.connectionConfig.reconnectBaseDelay * Math.pow(2, this.reconnectAttempts), this.connectionConfig.reconnectMaxDelay);
+      }
+      var jitterRange = delay * this.connectionConfig.reconnectJitter;
+      var jitter = (Math.random() * 2 - 1) * jitterRange;
+      delay = Math.round(delay + jitter);
+      return Math.max(this.connectionConfig.reconnectBaseDelay, Math.min(delay, this.connectionConfig.reconnectMaxDelay));
+    })
+  }, {
+    key: "onDocChanged",
+    value: (
+    /**
+    * Realtime handler: authoritative document changed.
+    * Fetches document via REST with current user context to respect permissions,
+    * updates cache, and reconciles subscription membership.
+    */
+    async function onDocChanged(payload) {
+      try {
+        var document = await this.db.getDoc(payload.doctype, payload.name);
+        this.normalizedCache.upsert(document);
+        var subscriptionsNeedingRehydration = this.subscriptionManager.updateSubscriptionMembership(document);
+        var _iteratorNormalCompletion = true,
+          _didIteratorError = false,
+          _iteratorError = void 0;
+        try {
+          for (var _iterator = subscriptionsNeedingRehydration[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+            var subscription = _step.value;
+            var _this_rehydrationManager;
+            (_this_rehydrationManager = this.rehydrationManager) === null || _this_rehydrationManager === void 0 ? void 0 : _this_rehydrationManager.scheduleRehydration(subscription, RehydrationReason.RemoteCreate);
+          }
+        } catch (err) {
+          _didIteratorError = true;
+          _iteratorError = err;
+        } finally {
+          try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+              _iterator.return();
+            }
+          } finally {
+            if (_didIteratorError) {
+              throw _iteratorError;
+            }
+          }
+        }
+      } catch (err) {
+        console.warn(`Failed to fetch document ${payload === null || payload === void 0 ? void 0 : payload.doctype}/${payload === null || payload === void 0 ? void 0 : payload.name} during realtime update:`, err);
+      }
+    })
+  }, {
+    key: "onDocDeleted",
+    value: (
+    /**
+    * Realtime handler: evicts document from cache and subscriptions.
+    */
+    async function onDocDeleted(payload) {
+      try {
+        this.normalizedCache.remove({
+          doctype: payload.doctype,
+          name: payload.name
+        });
+        var affectedSubscriptions = this.subscriptionManager.removeFromAllSubscriptions(payload.doctype, payload.name);
+        var _iteratorNormalCompletion = true,
+          _didIteratorError = false,
+          _iteratorError = void 0;
+        try {
+          for (var _iterator = affectedSubscriptions[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+            var subscription = _step.value;
+            var _this_rehydrationManager;
+            (_this_rehydrationManager = this.rehydrationManager) === null || _this_rehydrationManager === void 0 ? void 0 : _this_rehydrationManager.scheduleRehydration(subscription, RehydrationReason.Delete);
+          }
+        } catch (err) {
+          _didIteratorError = true;
+          _iteratorError = err;
+        } finally {
+          try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+              _iterator.return();
+            }
+          } finally {
+            if (_didIteratorError) {
+              throw _iteratorError;
+            }
+          }
+        }
+      } catch (err) {
+        console.warn(`Failed to process doc_deleted for ${payload === null || payload === void 0 ? void 0 : payload.doctype}/${payload === null || payload === void 0 ? void 0 : payload.name}:`, err);
+      }
+    })
+  }, {
+    /**
+    * Checks if realtime is healthy for echo suppression decisions.
+    */
+    key: "isRealtimeHealthy",
+    value: function isRealtimeHealthy() {
+      var _ref;
+      var _this_realtime;
+      return (_ref = (_this_realtime = this.realtime) === null || _this_realtime === void 0 ? void 0 : _this_realtime.isHealthy()) !== null && _ref !== void 0 ? _ref : false;
+    }
+  }, {
+    key: "getIsConnected",
+    value: function getIsConnected() {
+      return this.hasConnected;
+    }
+  }, {
+    /**
+    * Disposes of resources and clears timers.
+    */
+    key: "dispose",
+    value: function dispose() {
+      if (this.reconnectTimer) {
+        clearTimeout(this.reconnectTimer);
+        this.reconnectTimer = void 0;
+      }
+      if (this.realtime) {
+        var _this_realtime;
+        (_this_realtime = this.realtime) === null || _this_realtime === void 0 ? void 0 : _this_realtime.disconnect();
+      }
+    }
+  }]);
+  return RealtimeHandler2;
+}();
+export { RealtimeHandler };
+//# sourceMappingURL=realtime.native.js.map

package/dist/esm/sync/realtime.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["RealtimeEventType","RehydrationReason","_class_call_check","instance","Constructor","TypeError","_defineProperties","target","props","i","length","descriptor","enumerable","configurable","writable","Object","defineProperty","key","_create_class","protoProps","staticProps","prototype","_define_property","obj","value","RealtimeHandler","RealtimeHandler2","db","realtime","normalizedCache","subscriptionManager","rehydrationManager","options","arguments","_ref","_ref1","_ref2","_ref3","_options_connectionConfig","_options_connectionConfig1","_options_connectionConfig2","_options_connectionConfig3","reconnectAttempts","hasConnected","connectionConfig","reconnectBaseDelay","reconnectMaxDelay","reconnectJitter","exponentialBackoff","setupRealtimeHandlers","setupConnectionManagement","_this","_this_realtime","_this_realtime1","_this_realtime2","_this_realtime3","_this_realtime4","on","payload","onRealtimeEvent","type","DocChanged","onDocChanged","DocDeleted","onDocDeleted","PermEpochBump","onResetCache","onConnected","onDisconnected","attemptConnection","reconnectTimer","clearTimeout","Connected","onBackfillAll","console","debug","scheduleReconnection","delay","calculateReconnectDelay","setTimeout"],"sources":["../../../src/sync/realtime.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}