roboto-js 1.6.9 → 1.6.10

package/dist/cjs/index.cjs

@@ -39,7 +39,9 @@ var Roboto = exports["default"] = /*#__PURE__*/function () {
   function Roboto(_ref) {
     var host = _ref.host,
       accessKey = _ref.accessKey,
-      localStorageAdaptor = _ref.localStorageAdaptor;
+      localStorageAdaptor = _ref.localStorageAdaptor,
+      _ref$disableWebSocket = _ref.disableWebSocket,
+      disableWebSocket = _ref$disableWebSocket === void 0 ? false : _ref$disableWebSocket;
     var proxyReq = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : null;
     _classCallCheck(this, Roboto);
     if (Roboto.instance && !proxyReq) {
@@ -83,6 +85,11 @@ var Roboto = exports["default"] = /*#__PURE__*/function () {
     Roboto.instance = this;
   }
   _createClass(Roboto, [{
+    key: "getVersion",
+    value: function getVersion() {
+      return '1.6.9';
+    }
+  }, {
     key: "setSiteEnv",
     value: function setSiteEnv(siteEnv) {
       this.api.setSiteEnv(siteEnv);

package/dist/cjs/rbt_api.cjs

@@ -35,12 +35,14 @@ var RbtApi = exports["default"] = /*#__PURE__*/function () {
       _ref$localStorageAdap = _ref.localStorageAdaptor,
       localStorageAdaptor = _ref$localStorageAdap === void 0 ? null : _ref$localStorageAdap;
     _classCallCheck(this, RbtApi);
+    this.websocketClient = null;
     this.axios = _axios["default"].create({
       baseURL: baseUrl,
       headers: {
         'accesskey': accesskey
       }
     });
+    this.axios.__rbtApiInstance = this;
     if (localStorageAdaptor) {
       // must implement getItem, setItem interface
       this.localStorageAdaptor = localStorageAdaptor;
@@ -68,6 +70,25 @@ var RbtApi = exports["default"] = /*#__PURE__*/function () {
     this.initApiKey(apikey);
   }
   _createClass(RbtApi, [{
+    key: "getWebSocketClient",
+    value: function getWebSocketClient() {
+      if (this.websocketClient) return this.websocketClient;
+      var baseUrl = this.axios.defaults.baseURL;
+      var wsProtocol = baseUrl.startsWith('https') ? 'wss://' : 'ws://';
+      var wsUrl = baseUrl.replace(/^https?:\/\//, wsProtocol);
+      this.websocketClient = new WebSocket("".concat(wsUrl, "/realtime"));
+      this.websocketClient.onopen = function () {
+        console.log('[RbtApi] WebSocket connected.');
+      };
+      this.websocketClient.onclose = function () {
+        console.warn('[RbtApi] WebSocket closed.');
+      };
+      this.websocketClient.onerror = function (err) {
+        console.error('[RbtApi] WebSocket error:', err.message || err);
+      };
+      return this.websocketClient;
+    }
+  }, {
     key: "initAuthToken",
     value: function () {
       var _initAuthToken = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(authtoken) {
@@ -792,28 +813,27 @@ var RbtApi = exports["default"] = /*#__PURE__*/function () {
             case 0:
               dataHash = _args17.length > 1 && _args17[1] !== undefined ? _args17[1] : {};
               _context17.prev = 1;
-              debugger;
-              _context17.next = 5;
+              _context17.next = 4;
               return this.axios.post('/object_service/createObject', [type, dataHash]);
-            case 5:
+            case 4:
               response = _context17.sent;
               record = response.data;
               if (dataHash) {
                 record.data = dataHash;
               }
-              debugger;
               return _context17.abrupt("return", new _rbt_object["default"](record, this.axios, {
-                isNew: true
+                isNew: true,
+                websocketClient: this.websocketClient
               }));
-            case 12:
-              _context17.prev = 12;
+            case 10:
+              _context17.prev = 10;
               _context17.t0 = _context17["catch"](1);
               return _context17.abrupt("return", this._handleError(_context17.t0));
-            case 15:
+            case 13:
             case "end":
               return _context17.stop();
           }
-        }, _callee17, this, [[1, 12]]);
+        }, _callee17, this, [[1, 10]]);
       }));
       function create(_x12) {
         return _create.apply(this, arguments);
@@ -848,48 +868,6 @@ var RbtApi = exports["default"] = /*#__PURE__*/function () {
      *
      * Note: A default orderBy is applied if none is provided, ordering items by 'timeCreated' in descending order.
      */
-    //  async query(type, params = {}) {
-    //    try {
-    //      console.log('RBTAPI.query INIT', type, params);
-    //      params.type = type;
-    //      // Default ordering and pagination
-    //      const defaultOrderBy = { orderBy: { column: 'timeCreated', direction: 'DESC' } };
-    //      const defaultLimit = { limit: { offset: 0, results: 50 } };
-    //      
-    //      // Merge defaults with provided params
-    //      const mergedParams = { ...defaultOrderBy, ...defaultLimit, ...params };
-    //      // Check cache for an existing request
-    //      const currentTime = Date.now();
-    //      const paramsKey = JSON.stringify(mergedParams);
-    //      const cacheEntry = this.requestCache[paramsKey];
-    //      if (cacheEntry && (currentTime - cacheEntry.time) < 10000) {  // 10000 ms = 10 seconds
-    //        console.log('RBTAPI.query CACHED', type, paramsKey);
-    //        return cacheEntry.val;
-    //      }
-    //      // Create the response promise and store it in the cache
-    //      const responsePromise = this.axios.post('/object_service/queryObjects', [mergedParams]);
-    //      // Store the promise along with the current time in the cache
-    //      this.requestCache[paramsKey] = { val: responsePromise, time: currentTime };
-    //      // Await the response from the API
-    //      const response = await responsePromise;
-    //      if (response.data.ok === false) {
-    //        return this._handleError(response);
-    //      }
-    //      // Process items into RbtObject instances
-    //      if (Array.isArray(response.data.items)) {
-    //        response.data.items = response.data.items.map(record => {
-    //          return new RbtObject(record, this.axios, { isNew: true });
-    //        });
-    //      }
-    //      console.log('RBTAPI.query RESPONSE', type, paramsKey, response.data.items);
-    //      return response.data.items;
-    //    } catch (e) {
-    //      delete this.requestCache[paramsKey]; // Ensure cache cleanup on error
-    //      console.log('RBTAPI.query ERROR', paramsKey, e);
-    //      return this._handleError(e);
-    //    
-    //    }
-    //  }
     )
   }, {
     key: "query",
@@ -983,7 +961,9 @@ var RbtApi = exports["default"] = /*#__PURE__*/function () {
       if (Array.isArray(response.data.items)) {
         //console.log('RBTAPI.query RESPONSE PRE', response.data.items);
         response.data.items = response.data.items.map(function (record) {
-          return new _rbt_object["default"](record, _this3.axios);
+          return new _rbt_object["default"](record, _this3.axios, {
+            websocketClient: _this3.websocketClient
+          });
         });
       }
 

package/dist/cjs/rbt_object.cjs

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports["default"] = void 0;
 var _lodash = _interopRequireDefault(require("lodash"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+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); } }
 function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
@@ -42,6 +43,15 @@ var RbtObject = exports["default"] = /*#__PURE__*/function () {
     } else {
       this._data = record.dataJson ? this._deepUnpackJson(record.dataJson) : {};
     }
+    if (options.websocketClient && this.id) {
+      this._realtime = true;
+      this._ws = options.websocketClient;
+      this._subscribeToRealtime(this._ws);
+    }
+    this._eventHandlers = {
+      change: [],
+      save: []
+    };
   }
   _createClass(RbtObject, [{
     key: "get",
@@ -116,6 +126,7 @@ var RbtObject = exports["default"] = /*#__PURE__*/function () {
         } 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);
         }
       }
     }
@@ -229,38 +240,7 @@ var RbtObject = exports["default"] = /*#__PURE__*/function () {
         return _setRemove.apply(this, arguments);
       }
       return setRemove;
-    }() //  set(path, value, options = {}) {
-    //    const currentValue = _.get(this._data, path);
-    //
-    //    // Check if merge is required
-    //    if (options.merge) {
-    //      // Merge the value if merge option is true
-    //      const mergedValue = _.merge({}, currentValue, value);
-    //      if (!_.isEqual(currentValue, mergedValue)) {
-    //        _.set(this._data, path, mergedValue);
-    //        this._addChange(path);
-    //      }
-    //    } else {
-    //      // Set the value directly if no merge option or merge option is false
-    //      if (!_.isEqual(currentValue, value)) {
-    //        _.set(this._data, path, value);
-    //        this._addChange(path);
-    //      }
-    //    }
-    //  }
-    //
-    //  setData(newData) {
-    //    if (typeof newData !== 'object' || newData === null) {
-    //      throw new Error('setData expects an object');
-    //    }
-    //
-    //    Object.keys(newData).forEach(key => {
-    //      if (!_.isEqual(_.get(this._data, key), newData[key])) {
-    //        _.set(this._data, key, newData[key]);
-    //        this._addChange(key);
-    //      }
-    //    });
-    //  }
+    }()
   }, {
     key: "getMetaData",
     value: function getMetaData() {
@@ -459,6 +439,96 @@ var RbtObject = exports["default"] = /*#__PURE__*/function () {
       }
       return value;
     }
+
+    //
+    // Realtime WebSocket 
+    //
+    //
+  }, {
+    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();
+      if (!ws || this._realtime) return;
+      this._ws = ws;
+      this._realtime = true;
+      this._subscribeToRealtime(ws);
+    }
+  }, {
+    key: "_subscribeToRealtime",
+    value: function _subscribeToRealtime(ws) {
+      var _this3 = this;
+      if (ws.readyState === 1) {
+        ws.send(JSON.stringify({
+          type: 'subscribe',
+          objectId: this.id
+        }));
+      } else {
+        ws.addEventListener('open', function () {
+          ws.send(JSON.stringify({
+            type: 'subscribe',
+            objectId: _this3.id
+          }));
+        });
+      }
+      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 || {});
+        }
+      });
+    }
+  }, {
+    key: "onRealtimeChange",
+    value: function onRealtimeChange(cb) {
+      this._eventHandlers.change.push(cb);
+      this._initRealtime(); // lazy connect
+    }
+  }, {
+    key: "onRealtimeSave",
+    value: function onRealtimeSave(cb) {
+      this._eventHandlers.save.push(cb);
+      this._initRealtime(); // lazy connect
+    }
+  }, {
+    key: "_trigger",
+    value: function _trigger(type, data) {
+      var _iterator = _createForOfIteratorHelper(this._eventHandlers[type] || []),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var fn = _step.value;
+          fn(data);
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+    }
+  }, {
+    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
+          }
+        }));
+      }
+    }
   }]);
   return RbtObject;
 }();

package/dist/esm/index.js

@@ -6,10 +6,14 @@ export { RbtApi, RbtObject, RbtFile
 //Site
 };
 export default class Roboto {
+  getVersion() {
+    return '1.6.9';
+  }
   constructor({
     host,
     accessKey,
-    localStorageAdaptor
+    localStorageAdaptor,
+    disableWebSocket = false
   }, proxyReq = null) {
     if (Roboto.instance && !proxyReq) {
       // if on client, there can only be one instance

package/dist/esm/rbt_api.js

@@ -13,12 +13,14 @@ export default class RbtApi {
     apikey = null,
     localStorageAdaptor = null
   }) {
+    this.websocketClient = null;
     this.axios = axios.create({
       baseURL: baseUrl,
       headers: {
         'accesskey': accesskey
       }
     });
+    this.axios.__rbtApiInstance = this;
     if (localStorageAdaptor) {
       // must implement getItem, setItem interface
       this.localStorageAdaptor = localStorageAdaptor;
@@ -39,6 +41,23 @@ export default class RbtApi {
     this.initAuthToken(authtoken);
     this.initApiKey(apikey);
   }
+  getWebSocketClient() {
+    if (this.websocketClient) return this.websocketClient;
+    const baseUrl = this.axios.defaults.baseURL;
+    const wsProtocol = baseUrl.startsWith('https') ? 'wss://' : 'ws://';
+    const wsUrl = baseUrl.replace(/^https?:\/\//, wsProtocol);
+    this.websocketClient = new WebSocket(`${wsUrl}/realtime`);
+    this.websocketClient.onopen = () => {
+      console.log('[RbtApi] WebSocket connected.');
+    };
+    this.websocketClient.onclose = () => {
+      console.warn('[RbtApi] WebSocket closed.');
+    };
+    this.websocketClient.onerror = err => {
+      console.error('[RbtApi] WebSocket error:', err.message || err);
+    };
+    return this.websocketClient;
+  }
   async initAuthToken(authtoken) {
     if (!authtoken && this.localStorageAdaptor) {
       authtoken = await this.localStorageAdaptor.getItem('authtoken');
@@ -373,15 +392,14 @@ export default class RbtApi {
    */
   async create(type, dataHash = {}) {
     try {
-      debugger;
       const response = await this.axios.post('/object_service/createObject', [type, dataHash]);
       const record = response.data;
       if (dataHash) {
         record.data = dataHash;
       }
-      debugger;
       return new RbtObject(record, this.axios, {
-        isNew: true
+        isNew: true,
+        websocketClient: this.websocketClient
       });
     } catch (e) {
       return this._handleError(e);
@@ -416,61 +434,6 @@ export default class RbtApi {
    *
    * Note: A default orderBy is applied if none is provided, ordering items by 'timeCreated' in descending order.
    */
-  //  async query(type, params = {}) {
-
-  //    try {
-
-  //      console.log('RBTAPI.query INIT', type, params);
-  //      params.type = type;
-
-  //      // Default ordering and pagination
-  //      const defaultOrderBy = { orderBy: { column: 'timeCreated', direction: 'DESC' } };
-  //      const defaultLimit = { limit: { offset: 0, results: 50 } };
-  //      
-  //      // Merge defaults with provided params
-  //      const mergedParams = { ...defaultOrderBy, ...defaultLimit, ...params };
-
-  //      // Check cache for an existing request
-  //      const currentTime = Date.now();
-  //      const paramsKey = JSON.stringify(mergedParams);
-  //      const cacheEntry = this.requestCache[paramsKey];
-  //      if (cacheEntry && (currentTime - cacheEntry.time) < 10000) {  // 10000 ms = 10 seconds
-  //        console.log('RBTAPI.query CACHED', type, paramsKey);
-  //        return cacheEntry.val;
-  //      }
-
-  //      // Create the response promise and store it in the cache
-  //      const responsePromise = this.axios.post('/object_service/queryObjects', [mergedParams]);
-
-  //      // Store the promise along with the current time in the cache
-  //      this.requestCache[paramsKey] = { val: responsePromise, time: currentTime };
-
-  //      // Await the response from the API
-  //      const response = await responsePromise;
-
-  //      if (response.data.ok === false) {
-  //        return this._handleError(response);
-  //      }
-
-  //      // Process items into RbtObject instances
-  //      if (Array.isArray(response.data.items)) {
-  //        response.data.items = response.data.items.map(record => {
-  //          return new RbtObject(record, this.axios, { isNew: true });
-  //        });
-  //      }
-
-  //      console.log('RBTAPI.query RESPONSE', type, paramsKey, response.data.items);
-  //      return response.data.items;
-
-  //    } catch (e) {
-
-  //      delete this.requestCache[paramsKey]; // Ensure cache cleanup on error
-  //      console.log('RBTAPI.query ERROR', paramsKey, e);
-  //      return this._handleError(e);
-  //    
-  //    }
-
-  //  }
 
   async query(type, params = {}) {
     let paramsKey;
@@ -540,7 +503,9 @@ export default class RbtApi {
     if (Array.isArray(response.data.items)) {
       //console.log('RBTAPI.query RESPONSE PRE', response.data.items);
       response.data.items = response.data.items.map(record => {
-        return new RbtObject(record, this.axios);
+        return new RbtObject(record, this.axios, {
+          websocketClient: this.websocketClient
+        });
       });
     }
 

package/dist/esm/rbt_object.js

@@ -15,6 +15,15 @@ export default class RbtObject {
     } else {
       this._data = record.dataJson ? this._deepUnpackJson(record.dataJson) : {};
     }
+    if (options.websocketClient && this.id) {
+      this._realtime = true;
+      this._ws = options.websocketClient;
+      this._subscribeToRealtime(this._ws);
+    }
+    this._eventHandlers = {
+      change: [],
+      save: []
+    };
   }
   get(path) {
     return _.get(this._data, path);
@@ -80,6 +89,7 @@ export default class RbtObject {
       } else if (!_.isEqual(currentValue, value)) {
         _.set(this._data, path, value); // Set the value directly at the deep path
         this._addChange(path);
+        this._broadcastChange(path, value);
       }
     }
   }
@@ -145,40 +155,6 @@ export default class RbtObject {
     const filteredValues = existingValue.filter(item => !valuesToRemove.includes(item));
     this.set(key, filteredValues); // Set the updated array back to the user data
   }
-
-  //  set(path, value, options = {}) {
-  //    const currentValue = _.get(this._data, path);
-  //
-  //    // Check if merge is required
-  //    if (options.merge) {
-  //      // Merge the value if merge option is true
-  //      const mergedValue = _.merge({}, currentValue, value);
-  //      if (!_.isEqual(currentValue, mergedValue)) {
-  //        _.set(this._data, path, mergedValue);
-  //        this._addChange(path);
-  //      }
-  //    } else {
-  //      // Set the value directly if no merge option or merge option is false
-  //      if (!_.isEqual(currentValue, value)) {
-  //        _.set(this._data, path, value);
-  //        this._addChange(path);
-  //      }
-  //    }
-  //  }
-  //
-  //  setData(newData) {
-  //    if (typeof newData !== 'object' || newData === null) {
-  //      throw new Error('setData expects an object');
-  //    }
-  //
-  //    Object.keys(newData).forEach(key => {
-  //      if (!_.isEqual(_.get(this._data, key), newData[key])) {
-  //        _.set(this._data, key, newData[key]);
-  //        this._addChange(key);
-  //      }
-  //    });
-  //  }
-
   getMetaData() {
     let meta = {
       timeCreated: this._internalData.timeCreated,
@@ -313,4 +289,71 @@ export default class RbtObject {
     }
     return value;
   }
+
+  //
+  // Realtime WebSocket 
+  //
+  //
+  _initRealtime() {
+    if (this._realtime || !this._axios) return;
+
+    // Lazily pull WebSocket from parent API (injected via axios instance)
+    const api = this._axios?.__rbtApiInstance;
+    if (!api || typeof api.getWebSocketClient !== 'function') return;
+    const ws = api.getWebSocketClient();
+    if (!ws || this._realtime) return;
+    this._ws = ws;
+    this._realtime = true;
+    this._subscribeToRealtime(ws);
+  }
+  _subscribeToRealtime(ws) {
+    if (ws.readyState === 1) {
+      ws.send(JSON.stringify({
+        type: 'subscribe',
+        objectId: this.id
+      }));
+    } else {
+      ws.addEventListener('open', () => {
+        ws.send(JSON.stringify({
+          type: 'subscribe',
+          objectId: this.id
+        }));
+      });
+    }
+    ws.addEventListener('message', event => {
+      const msg = JSON.parse(event.data);
+      if (msg.objectId !== this.id) return;
+      if (msg.type === 'update') {
+        _.set(this._data, msg.delta.path, msg.delta.value);
+        this._trigger('change', msg.delta);
+      } else if (msg.type === 'save') {
+        this._trigger('save', msg.revision || {});
+      }
+    });
+  }
+  onRealtimeChange(cb) {
+    this._eventHandlers.change.push(cb);
+    this._initRealtime(); // lazy connect
+  }
+  onRealtimeSave(cb) {
+    this._eventHandlers.save.push(cb);
+    this._initRealtime(); // lazy connect
+  }
+  _trigger(type, data) {
+    for (const fn of this._eventHandlers[type] || []) {
+      fn(data);
+    }
+  }
+  _broadcastChange(path, value) {
+    if (this._realtime && this._ws && this._ws.readyState === 1) {
+      this._ws.send(JSON.stringify({
+        type: 'update',
+        objectId: this.id,
+        delta: {
+          path,
+          value
+        }
+      }));
+    }
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roboto-js",
-  "version": "1.6.9",
+  "version": "1.6.10",
   "type": "module",
   "description": "",
   "main": "dist/cjs/index.cjs",

package/src/index.js

@@ -13,7 +13,11 @@ export {
 
 export default class Roboto{
 
-  constructor({ host, accessKey, localStorageAdaptor }, proxyReq = null) {
+  getVersion(){
+    return '1.6.9';
+  }
+
+  constructor({ host, accessKey, localStorageAdaptor, disableWebSocket = false }, proxyReq = null) {
 
     if (Roboto.instance && !proxyReq) {
       // if on client, there can only be one instance

package/src/rbt_api.js

@@ -10,12 +10,15 @@ export default class RbtApi {
 
   constructor({ baseUrl, accesskey, authtoken=null, apikey=null, localStorageAdaptor=null }) {
     
+    this.websocketClient = null;
+
     this.axios = axios.create({
       baseURL: baseUrl,
       headers: {
         'accesskey': accesskey
       }
     });
+    this.axios.__rbtApiInstance = this;
 
     if(localStorageAdaptor){
       // must implement getItem, setItem interface
@@ -37,9 +40,33 @@ export default class RbtApi {
     // Use the storageAdaptor to get the authToken, if available
     this.initAuthToken(authtoken);
     this.initApiKey(apikey);
+
     
   }
 
+  getWebSocketClient() {
+    if (this.websocketClient) return this.websocketClient;
+
+    const baseUrl = this.axios.defaults.baseURL;
+    const wsProtocol = baseUrl.startsWith('https') ? 'wss://' : 'ws://';
+    const wsUrl = baseUrl.replace(/^https?:\/\//, wsProtocol);
+    this.websocketClient = new WebSocket(`${wsUrl}/realtime`);
+
+    this.websocketClient.onopen = () => {
+      console.log('[RbtApi] WebSocket connected.');
+    };
+
+    this.websocketClient.onclose = () => {
+      console.warn('[RbtApi] WebSocket closed.');
+    };
+
+    this.websocketClient.onerror = (err) => {
+      console.error('[RbtApi] WebSocket error:', err.message || err);
+    };
+
+    return this.websocketClient;
+  }
+
   async initAuthToken(authtoken) {
 
     if(!authtoken && this.localStorageAdaptor){
@@ -470,15 +497,13 @@ export default class RbtApi {
    */
   async create(type, dataHash={}) {
     try {
-      debugger;
       const response = await this.axios.post('/object_service/createObject', [type, dataHash]);
       const record = response.data;
 
       if(dataHash){
         record.data = dataHash;
       }
-      debugger;
-      return new RbtObject(record, this.axios, { isNew: true });
+      return new RbtObject(record, this.axios, { isNew: true, websocketClient: this.websocketClient });
     } catch (e) {
       return this._handleError(e);
     }
@@ -512,62 +537,6 @@ export default class RbtApi {
    *
    * Note: A default orderBy is applied if none is provided, ordering items by 'timeCreated' in descending order.
    */
-//  async query(type, params = {}) {
-
-//    try {
-
-//      console.log('RBTAPI.query INIT', type, params);
-//      params.type = type;
-
-//      // Default ordering and pagination
-//      const defaultOrderBy = { orderBy: { column: 'timeCreated', direction: 'DESC' } };
-//      const defaultLimit = { limit: { offset: 0, results: 50 } };
-//      
-//      // Merge defaults with provided params
-//      const mergedParams = { ...defaultOrderBy, ...defaultLimit, ...params };
-
-//      // Check cache for an existing request
-//      const currentTime = Date.now();
-//      const paramsKey = JSON.stringify(mergedParams);
-//      const cacheEntry = this.requestCache[paramsKey];
-//      if (cacheEntry && (currentTime - cacheEntry.time) < 10000) {  // 10000 ms = 10 seconds
-//        console.log('RBTAPI.query CACHED', type, paramsKey);
-//        return cacheEntry.val;
-//      }
-
-//      // Create the response promise and store it in the cache
-//      const responsePromise = this.axios.post('/object_service/queryObjects', [mergedParams]);
-
-//      // Store the promise along with the current time in the cache
-//      this.requestCache[paramsKey] = { val: responsePromise, time: currentTime };
-
-//      // Await the response from the API
-//      const response = await responsePromise;
-
-//      if (response.data.ok === false) {
-//        return this._handleError(response);
-//      }
-
-//      // Process items into RbtObject instances
-//      if (Array.isArray(response.data.items)) {
-//        response.data.items = response.data.items.map(record => {
-//          return new RbtObject(record, this.axios, { isNew: true });
-//        });
-//      }
-
-//      console.log('RBTAPI.query RESPONSE', type, paramsKey, response.data.items);
-//      return response.data.items;
-
-//    } catch (e) {
-
-//      delete this.requestCache[paramsKey]; // Ensure cache cleanup on error
-//      console.log('RBTAPI.query ERROR', paramsKey, e);
-//      return this._handleError(e);
-//    
-//    }
-
-//  }
-
 
   async query(type, params = {}) {
 
@@ -623,7 +592,7 @@ export default class RbtApi {
     if (Array.isArray(response.data.items)) {
       //console.log('RBTAPI.query RESPONSE PRE', response.data.items);
       response.data.items = response.data.items.map(record => {
-        return new RbtObject(record, this.axios);
+        return new RbtObject(record, this.axios, { websocketClient: this.websocketClient });
       });
     }
 

package/src/rbt_object.js

@@ -1,6 +1,6 @@
 import _ from 'lodash';
 
-export default class RbtObject {
+export default class RbtObject{
   
   constructor(record, axiosInstance, options = {}) {
     this._axios = axiosInstance;
@@ -19,6 +19,15 @@ export default class RbtObject {
       this._data = record.dataJson ? this._deepUnpackJson(record.dataJson) : {};
     }
     
+    if (options.websocketClient && this.id) {
+      this._realtime = true;
+      this._ws = options.websocketClient;
+      this._subscribeToRealtime(this._ws);
+    }
+    this._eventHandlers = {
+      change: [],
+      save: []
+    };
   }
 
   get(path) {
@@ -86,6 +95,7 @@ export default class RbtObject {
         } else if (!_.isEqual(currentValue, value)) {
             _.set(this._data, path, value);  // Set the value directly at the deep path
             this._addChange(path);
+            this._broadcastChange(path, value);
         }
     }
   }
@@ -161,41 +171,6 @@ export default class RbtObject {
   
   }
 
-
-
-//  set(path, value, options = {}) {
-//    const currentValue = _.get(this._data, path);
-//
-//    // Check if merge is required
-//    if (options.merge) {
-//      // Merge the value if merge option is true
-//      const mergedValue = _.merge({}, currentValue, value);
-//      if (!_.isEqual(currentValue, mergedValue)) {
-//        _.set(this._data, path, mergedValue);
-//        this._addChange(path);
-//      }
-//    } else {
-//      // Set the value directly if no merge option or merge option is false
-//      if (!_.isEqual(currentValue, value)) {
-//        _.set(this._data, path, value);
-//        this._addChange(path);
-//      }
-//    }
-//  }
-//
-//  setData(newData) {
-//    if (typeof newData !== 'object' || newData === null) {
-//      throw new Error('setData expects an object');
-//    }
-//
-//    Object.keys(newData).forEach(key => {
-//      if (!_.isEqual(_.get(this._data, key), newData[key])) {
-//        _.set(this._data, key, newData[key]);
-//        this._addChange(key);
-//      }
-//    });
-//  }
-
   getMetaData() {
 
     let meta = {
@@ -355,6 +330,72 @@ export default class RbtObject {
 
 
 
+  //
+  // Realtime WebSocket 
+  //
+  //
+  _initRealtime() {
+    if (this._realtime || !this._axios) return;
+
+    // Lazily pull WebSocket from parent API (injected via axios instance)
+    const api = this._axios?.__rbtApiInstance;
+    if (!api || typeof api.getWebSocketClient !== 'function') return;
+
+    const ws = api.getWebSocketClient();
+    if (!ws || this._realtime) return;
+
+    this._ws = ws;
+    this._realtime = true;
+    this._subscribeToRealtime(ws);
+  }
+
+  _subscribeToRealtime(ws) {
+      if (ws.readyState === 1) {
+        ws.send(JSON.stringify({ type: 'subscribe', objectId: this.id }));
+      } else {
+        ws.addEventListener('open', () => {
+          ws.send(JSON.stringify({ type: 'subscribe', objectId: this.id }));
+        });
+      }
+
+      ws.addEventListener('message', (event) => {
+        const msg = JSON.parse(event.data);
+        if (msg.objectId !== this.id) return;
+
+        if (msg.type === 'update') {
+          _.set(this._data, msg.delta.path, msg.delta.value);
+          this._trigger('change', msg.delta);
+        } else if (msg.type === 'save') {
+          this._trigger('save', msg.revision || {});
+        }
+      });
+    }
+
+    onRealtimeChange(cb) {
+      this._eventHandlers.change.push(cb);
+      this._initRealtime(); // lazy connect
+    }
+
+    onRealtimeSave(cb) {
+      this._eventHandlers.save.push(cb);
+      this._initRealtime(); // lazy connect
+    }
+
+    _trigger(type, data) {
+      for (const fn of this._eventHandlers[type] || []) {
+        fn(data);
+      }
+    }
+
+    _broadcastChange(path, value) {
+      if (this._realtime && this._ws && this._ws.readyState === 1) {
+        this._ws.send(JSON.stringify({
+          type: 'update',
+          objectId: this.id,
+          delta: { path, value }
+        }));
+      }
+    }
 
 
 }