roboto-js 1.6.18 → 1.7.0

package/dist/cjs/rbt_object.cjs

@@ -6,6 +6,10 @@ Object.defineProperty(exports, "__esModule", {
 exports["default"] = void 0;
 var _lodash = _interopRequireDefault(require("lodash"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
 function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator["return"] && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, "catch": function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
@@ -43,15 +47,27 @@ var RbtObject = exports["default"] = /*#__PURE__*/function () {
     } else {
       this._data = record.dataJson ? this._deepUnpackJson(record.dataJson) : {};
     }
-    if (options.websocketClient && this.id) {
+    if (options.websocketClient && this.id && options.enableRealtime) {
       this._realtime = true;
       this._ws = options.websocketClient;
       this._subscribeToRealtime(this._ws);
+    } else if (options.websocketClient && this.id) {
+      // Store websocket client for potential later use, but don't auto-subscribe
+      this._ws = options.websocketClient;
+    }
+
+    // If enableRealtime is requested but no websocketClient provided, try to initialize lazily
+    if (options.enableRealtime && this.id && !this._realtime) {
+      this._initRealtime();
     }
     this._eventHandlers = {
       change: [],
       save: []
     };
+
+    // Debounce properties for WebSocket broadcasting
+    this._broadcastDebounceTimer = null;
+    this._pendingBroadcasts = new Map(); // path -> value
   }
   _createClass(RbtObject, [{
     key: "get",
@@ -117,16 +133,34 @@ var RbtObject = exports["default"] = /*#__PURE__*/function () {
         if (!_lodash["default"].isEqual(currentValue, mergedValue)) {
           _lodash["default"].set(this._data, path, mergedValue); // Set the merged value at the deep path
           this._addChange(path);
+          // Trigger local change events for any registered handlers
+          this._trigger('change', {
+            path: path,
+            value: mergedValue,
+            options: options
+          });
         }
       } else {
         // If value is undefined and not merging, delete the key
         if (value === undefined) {
           _lodash["default"].unset(this._data, path);
           this._addChange(path);
+          // Trigger local change events for any registered handlers
+          this._trigger('change', {
+            path: path,
+            value: undefined,
+            options: options
+          });
         } else if (!_lodash["default"].isEqual(currentValue, value)) {
           _lodash["default"].set(this._data, path, value); // Set the value directly at the deep path
           this._addChange(path);
           this._broadcastChange(path, value);
+          // Trigger local change events for any registered handlers
+          this._trigger('change', {
+            path: path,
+            value: value,
+            options: options
+          });
         }
       }
     }
@@ -156,6 +190,12 @@ var RbtObject = exports["default"] = /*#__PURE__*/function () {
           if (!_lodash["default"].isEqual(currentValue, mergedValue)) {
             _lodash["default"].set(_this2._data, path, mergedValue);
             _this2._addChange(path);
+            // Trigger change event for this path
+            _this2._trigger('change', {
+              path: path,
+              value: mergedValue,
+              options: options
+            });
           }
         } else if (!_lodash["default"].isEqual(currentValue, newValue)) {
           _lodash["default"].setWith(_this2._data, path, newValue, function (nsValue, key, nsObject, nsPath) {
@@ -165,6 +205,12 @@ var RbtObject = exports["default"] = /*#__PURE__*/function () {
             return nsValue;
           });
           _this2._addChange(path);
+          // Trigger change event for this path
+          _this2._trigger('change', {
+            path: path,
+            value: newValue,
+            options: options
+          });
         }
       });
     }
@@ -451,13 +497,18 @@ var RbtObject = exports["default"] = /*#__PURE__*/function () {
   }, {
     key: "_initRealtime",
     value: function _initRealtime() {
-      var _this$_axios;
       if (this._realtime || !this._axios) return;
 
-      // Lazily pull WebSocket from parent API (injected via axios instance)
-      var api = (_this$_axios = this._axios) === null || _this$_axios === void 0 ? void 0 : _this$_axios.__rbtApiInstance;
-      if (!api || typeof api.getWebSocketClient !== 'function') return;
-      var ws = api.getWebSocketClient();
+      // Use stored websocket client if available
+      var ws = this._ws;
+
+      // Otherwise, lazily pull WebSocket from parent API (injected via axios instance)
+      if (!ws) {
+        var _this$_axios;
+        var api = (_this$_axios = this._axios) === null || _this$_axios === void 0 ? void 0 : _this$_axios.__rbtApiInstance;
+        if (!api || typeof api.getWebSocketClient !== 'function') return;
+        ws = api.getWebSocketClient();
+      }
       if (!ws || this._realtime) return;
       this._ws = ws;
       this._realtime = true;
@@ -466,7 +517,13 @@ var RbtObject = exports["default"] = /*#__PURE__*/function () {
   }, {
     key: "_subscribeToRealtime",
     value: function _subscribeToRealtime(ws) {
-      var _this3 = this;
+      var _this$_axios2,
+        _this3 = this;
+      // Track subscription for reconnection
+      var api = (_this$_axios2 = this._axios) === null || _this$_axios2 === void 0 ? void 0 : _this$_axios2.__rbtApiInstance;
+      if (api && typeof api._trackSubscription === 'function') {
+        api._trackSubscription(this.id);
+      }
       if (ws.readyState === 1) {
         ws.send(JSON.stringify({
           type: 'subscribe',
@@ -481,31 +538,58 @@ var RbtObject = exports["default"] = /*#__PURE__*/function () {
         });
       }
       ws.addEventListener('message', function (event) {
-        var msg = JSON.parse(event.data);
-        if (msg.objectId !== _this3.id) return;
-        if (msg.type === 'update') {
-          _lodash["default"].set(_this3._data, msg.delta.path, msg.delta.value);
-          _this3._trigger('change', msg.delta);
-        } else if (msg.type === 'save') {
-          _this3._trigger('save', msg.revision || {});
+        try {
+          var msg = JSON.parse(event.data);
+          if (msg.objectId !== _this3.id) return;
+          if (msg.type === 'update') {
+            if (msg.delta && msg.delta.path !== undefined) {
+              _lodash["default"].set(_this3._data, msg.delta.path, msg.delta.value);
+
+              // Add metadata to indicate if this is state sync vs live update
+              var changeData = _objectSpread(_objectSpread({}, msg.delta), {}, {
+                isStateSync: msg.isStateSync || false,
+                source: msg.isStateSync ? 'state-sync' : 'realtime',
+                userId: msg.userId || msg.delta.userId || null
+              });
+              _this3._trigger('change', changeData);
+              if (msg.isStateSync) {
+                console.log('[RbtObject] Applied state sync:', msg.delta.path, '=', msg.delta.value);
+              }
+            } else {
+              console.warn('[RbtObject] Received update message without valid delta:', msg);
+            }
+          } else if (msg.type === 'save') {
+            _this3._trigger('save', msg.revision || {});
+          }
+        } catch (error) {
+          console.error('[RbtObject] Error processing WebSocket message:', error, event.data);
         }
       });
     }
+
+    // General change handler for both local and remote changes
   }, {
-    key: "onRealtimeChange",
-    value: function onRealtimeChange(cb) {
+    key: "onChange",
+    value: function onChange(cb) {
       this._eventHandlers.change.push(cb);
-      this._initRealtime(); // lazy connect
+      // Auto-initialize realtime if this object has WebSocket capability
+      if (this._ws && !this._realtime) {
+        this._initRealtime();
+      }
     }
+
+    // General save handler for both local and remote saves
   }, {
-    key: "onRealtimeSave",
-    value: function onRealtimeSave(cb) {
+    key: "onSave",
+    value: function onSave(cb) {
       this._eventHandlers.save.push(cb);
-      this._initRealtime(); // lazy connect
+      // Note: Does not initialize realtime connection
     }
   }, {
     key: "_trigger",
     value: function _trigger(type, data) {
+      var _this$_eventHandlers$;
+      console.log('[AgentProviderSync] _trigger called:', type, 'handlers:', (_this$_eventHandlers$ = this._eventHandlers[type]) === null || _this$_eventHandlers$ === void 0 ? void 0 : _this$_eventHandlers$.length, 'data:', data);
       var _iterator = _createForOfIteratorHelper(this._eventHandlers[type] || []),
         _step;
       try {
@@ -522,16 +606,69 @@ var RbtObject = exports["default"] = /*#__PURE__*/function () {
   }, {
     key: "_broadcastChange",
     value: function _broadcastChange(path, value) {
-      if (this._realtime && this._ws && this._ws.readyState === 1) {
-        this._ws.send(JSON.stringify({
-          type: 'update',
-          objectId: this.id,
-          delta: {
-            path: path,
-            value: value
-          }
-        }));
+      var _this4 = this;
+      if (!this._realtime || !this._ws || this._ws.readyState !== 1) {
+        return;
+      }
+
+      // Store the pending broadcast
+      this._pendingBroadcasts.set(path, value);
+
+      // Clear existing timer if any
+      if (this._broadcastDebounceTimer) {
+        clearTimeout(this._broadcastDebounceTimer);
+      }
+
+      // Set new debounced timer
+      this._broadcastDebounceTimer = setTimeout(function () {
+        _this4._flushPendingBroadcasts();
+      }, 300);
+    }
+  }, {
+    key: "_flushPendingBroadcasts",
+    value: function _flushPendingBroadcasts() {
+      if (!this._realtime || !this._ws || this._ws.readyState !== 1) {
+        this._pendingBroadcasts.clear();
+        return;
+      }
+
+      // Send all pending broadcasts
+      var _iterator2 = _createForOfIteratorHelper(this._pendingBroadcasts),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var _step2$value = _slicedToArray(_step2.value, 2),
+            path = _step2$value[0],
+            value = _step2$value[1];
+          this._ws.send(JSON.stringify({
+            type: 'update',
+            objectId: this.id,
+            delta: {
+              path: path,
+              value: value
+            }
+          }));
+        }
+
+        // Clear pending broadcasts and timer
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+      this._pendingBroadcasts.clear();
+      this._broadcastDebounceTimer = null;
+    }
+
+    // Cleanup method to clear any pending debounced broadcasts
+  }, {
+    key: "_cleanup",
+    value: function _cleanup() {
+      if (this._broadcastDebounceTimer) {
+        clearTimeout(this._broadcastDebounceTimer);
+        this._broadcastDebounceTimer = null;
       }
+      this._pendingBroadcasts.clear();
     }
   }]);
   return RbtObject;

package/dist/esm/index.js

@@ -182,6 +182,14 @@ export default class Roboto {
     return this.api.query(type, params);
   }
 
+  // WebSocket methods
+  getWebSocketClient() {
+    return this.api.getWebSocketClient();
+  }
+  closeWebSocket() {
+    return this.api.closeWebSocket();
+  }
+
   //
   //
   //