@multiplatform.one/frappe 6.0.0

package/dist/jsx/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/jsx/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/jsx/sync/realtime.native.js

@@ -0,0 +1,340 @@
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var realtime_exports = {};
+__export(realtime_exports, {
+  RealtimeHandler: () => RealtimeHandler
+});
+module.exports = __toCommonJS(realtime_exports);
+var import_types = require("./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: import_types.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: import_types.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: import_types.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: import_types.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, import_types.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, import_types.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;
+}();
+//# sourceMappingURL=realtime.native.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["__defProp","Object","defineProperty","__getOwnPropDesc","getOwnPropertyDescriptor","__getOwnPropNames","getOwnPropertyNames","__hasOwnProp","prototype","hasOwnProperty","__export","target","all","name","get","enumerable","__copyProps","to","from","except","desc","key","call","__toCommonJS","mod","value","realtime_exports","RealtimeHandler","module","exports","import_types","require","_class_call_check","instance","Constructor","TypeError","_defineProperties","props","i","length","descriptor","configurable","writable","_create_class","protoProps","staticProps","_define_property","obj","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","RealtimeEventType","DocChanged","onDocChanged","DocDeleted","onDocDeleted","PermEpochBump","onResetCache","onConnected","onDisconnected","attemptConnection","reconnectTimer","clearTimeout","Connected","onBackfillAll","console","debug","scheduleReconnection"],"sources":["../../../src/sync/realtime.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}