roboto-js 1.8.4 → 1.8.5

package/dist/rbt_object.js

@@ -0,0 +1,1110 @@
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _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(r) { if (Array.isArray(r)) return r; }
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, 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 o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import _ from 'lodash';
+var RbtObject = /*#__PURE__*/function () {
+  function RbtObject(record, axiosInstance) {
+    var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+    _classCallCheck(this, RbtObject);
+    this._axios = axiosInstance;
+    this._internalData = record;
+    this.isRbtObject = true;
+    this.id = record.id;
+    this.id_revision = record.id_revision;
+    this.rpcMeta = record.rpcMeta || {
+      changes: [],
+      isNew: options.isNew || record.revision == 0 || false
+    };
+    if (record.data) {
+      this._data = this._deepUnpackJson(record.data);
+    } else {
+      this._data = record.dataJson ? this._deepUnpackJson(record.dataJson) : {};
+    }
+    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
+  }
+  return _createClass(RbtObject, [{
+    key: "get",
+    value: function get(path) {
+      return _.get(this._data, path);
+    }
+  }, {
+    key: "getData",
+    value: function getData() {
+      var _this = this;
+      var keys = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;
+      // Check if keys are provided
+      if (keys && Array.isArray(keys)) {
+        // Return an object with only the specified keys
+        return keys.reduce(function (result, key) {
+          // Use lodash.get to handle deep key paths
+          var value = _.get(_this._data, key);
+          // If the value exists, add it to the result object using the key path as the property name
+          if (value !== undefined) {
+            // Create nested structure based on the key path
+            _.set(result, key, value);
+          }
+          return result;
+        }, {});
+      } else {
+        // Return a shallow copy of the full data if no keys are provided
+        return _objectSpread({}, this._data);
+      }
+    }
+  }, {
+    key: "_addChange",
+    value: function _addChange(path) {
+      // Ensure no duplicate paths
+      if (!this.rpcMeta.changes.includes(path)) {
+        this.rpcMeta.changes.push(path);
+      }
+    }
+  }, {
+    key: "set",
+    value: function set(path, value) {
+      var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+      var currentValue = _.get(this._data, path); // Fetch current value at deep path
+
+      if (options.merge) {
+        var mergedValue = _.mergeWith({}, currentValue, value, function (objValue, srcValue) {
+          if (srcValue === undefined) {
+            return undefined; // Indicate to delete when merging
+          }
+          if (_.isArray(objValue)) {
+            return srcValue; // Customize merging behavior for arrays
+          }
+          // Handle null, 0, and "" explicitly
+          if (srcValue === null || srcValue === 0 || srcValue === "") {
+            return srcValue;
+          }
+        });
+        // Process merged object to remove any keys set explicitly to undefined
+        Object.keys(mergedValue).forEach(function (key) {
+          if (mergedValue[key] === undefined) {
+            _.unset(mergedValue, key);
+          }
+        });
+        if (!_.isEqual(currentValue, mergedValue)) {
+          _.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) {
+          _.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 (!_.isEqual(currentValue, value)) {
+          _.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
+          });
+        }
+      }
+    }
+  }, {
+    key: "setData",
+    value: function setData(newData) {
+      var _this2 = this;
+      var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+      if (_typeof(newData) !== 'object' || newData === null) {
+        throw new Error('setData expects an object');
+      }
+      var _options$merge = options.merge,
+        merge = _options$merge === void 0 ? false : _options$merge;
+      Object.keys(newData).forEach(function (path) {
+        var currentValue = _.get(_this2._data, path);
+        var newValue = newData[path];
+        if (merge && _.isObject(currentValue) && _.isObject(newValue)) {
+          var mergedValue = _.mergeWith({}, currentValue, newValue, function (objValue, srcValue) {
+            if (_.isArray(srcValue)) {
+              return _toConsumableArray(srcValue); // Customize merging behavior for arrays
+            }
+            // Handle null, 0, and "" explicitly
+            if (srcValue === null || srcValue === 0 || srcValue === "") {
+              return srcValue;
+            }
+          });
+          if (!_.isEqual(currentValue, mergedValue)) {
+            _.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 (!_.isEqual(currentValue, newValue)) {
+          _.setWith(_this2._data, path, newValue, function (nsValue, key, nsObject, nsPath) {
+            if (key === nsPath.split('.').pop() && !_.has(nsObject, key)) {
+              return nsObject[key] = {}; // Create any missing parts of the path as plain objects
+            }
+            return nsValue;
+          });
+          _this2._addChange(path);
+          // Trigger change event for this path
+          _this2._trigger('change', {
+            path: path,
+            value: newValue,
+            options: options
+          });
+        }
+      });
+    }
+
+    //
+    // For Arrays
+    //
+  }, {
+    key: "setAppend",
+    value: function () {
+      var _setAppend = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(key, value) {
+        var options,
+          existingValue,
+          valuesToAdd,
+          mergedValues,
+          _args = arguments;
+        return _regenerator().w(function (_context) {
+          while (1) switch (_context.n) {
+            case 0:
+              options = _args.length > 2 && _args[2] !== undefined ? _args[2] : {};
+              existingValue = this.get(key) || []; // Get the existing value or default to an empty array
+              if (!Array.isArray(existingValue)) {
+                existingValue = []; // Ensure existingValue is an array if not already
+              }
+              valuesToAdd = Array.isArray(value) ? value : [value]; // Convert value to an array if it's not one
+              // Combine existingValue and valuesToAdd, filtering out duplicates
+              mergedValues = Array.from(new Set([].concat(_toConsumableArray(existingValue), _toConsumableArray(valuesToAdd))));
+              this.set(key, mergedValues, options); // Set the updated array back to the user data
+            case 1:
+              return _context.a(2);
+          }
+        }, _callee, this);
+      }));
+      function setAppend(_x, _x2) {
+        return _setAppend.apply(this, arguments);
+      }
+      return setAppend;
+    }()
+  }, {
+    key: "setRemove",
+    value: function () {
+      var _setRemove = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(key, value) {
+        var options,
+          existingValue,
+          valuesToRemove,
+          filteredValues,
+          _args2 = arguments;
+        return _regenerator().w(function (_context2) {
+          while (1) switch (_context2.n) {
+            case 0:
+              options = _args2.length > 2 && _args2[2] !== undefined ? _args2[2] : {};
+              existingValue = this.get(key) || []; // Get the existing value or default to an empty array
+              if (Array.isArray(existingValue)) {
+                _context2.n = 1;
+                break;
+              }
+              return _context2.a(2);
+            case 1:
+              valuesToRemove = Array.isArray(value) ? value : [value]; // Convert value to an array if it's not one
+              // Filter out the values to remove from the existing value array
+              filteredValues = existingValue.filter(function (item) {
+                return !valuesToRemove.includes(item);
+              });
+              this.set(key, filteredValues); // Set the updated array back to the user data
+            case 2:
+              return _context2.a(2);
+          }
+        }, _callee2, this);
+      }));
+      function setRemove(_x3, _x4) {
+        return _setRemove.apply(this, arguments);
+      }
+      return setRemove;
+    }()
+  }, {
+    key: "getMetaData",
+    value: function getMetaData() {
+      var meta = {
+        timeCreated: this._internalData.timeCreated,
+        timeModified: this._internalData.timeModified,
+        timeDeleted: this._internalData.timeDeleted,
+        revision: this._internalData.revision
+      };
+      return meta;
+    }
+  }, {
+    key: "toRecord",
+    value: function toRecord() {
+      return _objectSpread(_objectSpread({}, this._internalData), {}, {
+        dataJson: JSON.stringify(this._data),
+        rpcMeta: this.rpcMeta
+      });
+    }
+  }, {
+    key: "toDeltaRecord",
+    value: function toDeltaRecord() {
+      var changes = this.rpcMeta.changes;
+
+      // Initialize deltaData as an empty object
+      var sourceData = this._data;
+      var deltaData = {};
+
+      // Populate deltaData only with keys specified in changes
+      changes.forEach(function (path) {
+        // default value explicitly set to undefined
+        var value = _.get(sourceData, path, undefined);
+        // Use _.set to ensure nested keys are correctly assigned
+        _.set(deltaData, path, value);
+      });
+
+      // mark as delta
+      this.rpcMeta.delta = true;
+      var clonedData = _.cloneDeep(this._internalData);
+      clonedData.data = deltaData;
+      return _objectSpread(_objectSpread({}, clonedData), {}, {
+        dataJson: JSON.stringify(deltaData),
+        rpcMeta: this.rpcMeta
+      });
+    }
+  }, {
+    key: "clone",
+    value: function clone() {
+      // Create a deep copy of the current object's data
+      var clonedData = _.cloneDeep(this._internalData);
+
+      // Reset unique identifiers to ensure a new ID is generated upon saving
+      delete clonedData.id;
+      delete clonedData.id_revision;
+      delete clonedData.rpcMeta;
+      if (clonedData.data) {
+        delete clonedData.data.id;
+        delete clonedData.data.id_revision;
+      }
+
+      // Create a new instance of RbtObject with the cloned data
+      var clonedObject = new RbtObject(clonedData, this._axios, {
+        isNew: true
+      });
+      return clonedObject;
+    }
+  }, {
+    key: "save",
+    value: function () {
+      var _save = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3() {
+        var _response$data, _response$data2, record, response, _e$response, _t;
+        return _regenerator().w(function (_context3) {
+          while (1) switch (_context3.p = _context3.n) {
+            case 0:
+              if (this._internalData.type) {
+                _context3.n = 1;
+                break;
+              }
+              throw new Error('Cannot save object without type');
+            case 1:
+              _context3.p = 1;
+              if (this.rpcMeta.isNew) {
+                record = this.toRecord();
+              } else {
+                record = this.toDeltaRecord();
+              }
+              _context3.n = 2;
+              return this._axios.post('/object_service/saveObject', [record]);
+            case 2:
+              response = _context3.v;
+              if (!(response.data.ok === false)) {
+                _context3.n = 3;
+                break;
+              }
+              throw new Error(response.data.message);
+            case 3:
+              if (!(((_response$data = response.data) === null || _response$data === void 0 ? void 0 : _response$data.result) == 'NO_CHANGES')) {
+                _context3.n = 4;
+                break;
+              }
+              this.rpcMeta.isNew = false;
+              return _context3.a(2, this);
+            case 4:
+              if ((_response$data2 = response.data) !== null && _response$data2 !== void 0 && _response$data2.newData) {
+                // apply new incoming data
+                this.setData(response.newData);
+              }
+              this.id = response.data.id;
+              this.id_revision = response.data.id_revision;
+              this.type = response.data.type;
+              this.rpcMeta.isNew = false;
+              return _context3.a(2, this);
+            case 5:
+              _context3.p = 5;
+              _t = _context3.v;
+              console.log('RbtObject.save.error:', _t === null || _t === void 0 || (_e$response = _t.response) === null || _e$response === void 0 ? void 0 : _e$response.data);
+              this._error = _t;
+              //console.log(e.response.data);
+              throw _t;
+            case 6:
+              return _context3.a(2);
+          }
+        }, _callee3, this, [[1, 5]]);
+      }));
+      function save() {
+        return _save.apply(this, arguments);
+      }
+      return save;
+    }()
+    /**
+     * Grants access to this object for specific users and/or user groups.
+     * Updates the IAC (Identity and Access Control) permissions.
+     * 
+     * @param {Object} options - Access grant options
+     * @param {string[]} [options.userIds=[]] - Array of user IDs to grant read access
+     * @param {string[]} [options.groupIds=[]] - Array of user group IDs to grant read access
+     * @param {boolean} [options.write=false] - If true, grants write access instead of read access
+     * @param {boolean} [options.replace=false] - If true, replaces existing grants; if false, merges with existing
+     * @param {boolean} [options.save=true] - If true, automatically saves the object after updating permissions
+     * @returns {Promise<RbtObject>} - Returns this object (saved if options.save is true)
+     * 
+     * @example
+     * // Grant read access to specific users
+     * await myObject.grantAccess({ 
+     *   userIds: ['user123', 'user456'] 
+     * });
+     * 
+     * @example
+     * // Grant read access to user groups
+     * await myObject.grantAccess({ 
+     *   groupIds: ['grpRngAccount', 'grpAdmins'] 
+     * });
+     * 
+     * @example
+     * // Grant write access to users and groups
+     * await myObject.grantAccess({ 
+     *   userIds: ['user123'],
+     *   groupIds: ['grpAdmins'],
+     *   write: true 
+     * });
+     * 
+     * @example
+     * // Replace existing permissions instead of merging
+     * await myObject.grantAccess({ 
+     *   userIds: ['user123'],
+     *   replace: true 
+     * });
+     * 
+     * @example
+     * // Update permissions without auto-saving
+     * await myObject.grantAccess({ 
+     *   userIds: ['user123'],
+     *   save: false 
+     * });
+     * // ... make other changes ...
+     * await myObject.save();
+     */
+  }, {
+    key: "grantAccess",
+    value: (function () {
+      var _grantAccess = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4() {
+        var options,
+          _options$userIds,
+          userIds,
+          _options$groupIds,
+          groupIds,
+          _options$write,
+          write,
+          _options$replace,
+          replace,
+          _options$save,
+          save,
+          iac,
+          grantType,
+          existingUsers,
+          mergedUsers,
+          existingGroups,
+          mergedGroups,
+          _args4 = arguments;
+        return _regenerator().w(function (_context4) {
+          while (1) switch (_context4.n) {
+            case 0:
+              options = _args4.length > 0 && _args4[0] !== undefined ? _args4[0] : {};
+              _options$userIds = options.userIds, userIds = _options$userIds === void 0 ? [] : _options$userIds, _options$groupIds = options.groupIds, groupIds = _options$groupIds === void 0 ? [] : _options$groupIds, _options$write = options.write, write = _options$write === void 0 ? false : _options$write, _options$replace = options.replace, replace = _options$replace === void 0 ? false : _options$replace, _options$save = options.save, save = _options$save === void 0 ? true : _options$save; // Validate inputs
+              if (Array.isArray(userIds)) {
+                _context4.n = 1;
+                break;
+              }
+              throw new Error('userIds must be an array');
+            case 1:
+              if (Array.isArray(groupIds)) {
+                _context4.n = 2;
+                break;
+              }
+              throw new Error('groupIds must be an array');
+            case 2:
+              // Get current IAC settings
+              iac = this.get('iac') || {}; // Determine which grant type to update (read or write)
+              grantType = write ? 'writeGrants' : 'readGrants'; // Initialize grants if they don't exist
+              if (!iac[grantType]) {
+                iac[grantType] = {};
+              }
+
+              // Handle users
+              if (userIds.length > 0) {
+                if (replace) {
+                  // Replace existing users
+                  iac[grantType].users = _toConsumableArray(userIds);
+                } else {
+                  // Merge with existing users (avoiding duplicates)
+                  existingUsers = iac[grantType].users || [];
+                  mergedUsers = _toConsumableArray(new Set([].concat(_toConsumableArray(existingUsers), _toConsumableArray(userIds))));
+                  iac[grantType].users = mergedUsers;
+                }
+              }
+
+              // Handle user groups
+              if (groupIds.length > 0) {
+                if (replace) {
+                  // Replace existing groups
+                  iac[grantType].userGroups = _toConsumableArray(groupIds);
+                } else {
+                  // Merge with existing groups (avoiding duplicates)
+                  existingGroups = iac[grantType].userGroups || [];
+                  mergedGroups = _toConsumableArray(new Set([].concat(_toConsumableArray(existingGroups), _toConsumableArray(groupIds))));
+                  iac[grantType].userGroups = mergedGroups;
+                }
+              }
+
+              // Update the object
+              this.set('iac', iac);
+
+              // Save if requested
+              if (!save) {
+                _context4.n = 4;
+                break;
+              }
+              _context4.n = 3;
+              return this.save();
+            case 3:
+              return _context4.a(2, _context4.v);
+            case 4:
+              return _context4.a(2, this);
+          }
+        }, _callee4, this);
+      }));
+      function grantAccess() {
+        return _grantAccess.apply(this, arguments);
+      }
+      return grantAccess;
+    }()
+    /**
+     * Publishes this object to make it publicly accessible (or unpublishes it).
+     * Adds or removes 'public_user' from the IAC read permissions.
+     * 
+     * @param {Object} options - Publishing options
+     * @param {boolean} [options.publish=true] - If true, publishes the object; if false, unpublishes it
+     * @param {boolean} [options.save=true] - If true, automatically saves the object after updating permissions
+     * @returns {Promise<RbtObject>} - Returns this object (saved if options.save is true)
+     * 
+     * @example
+     * // Publish an object (make it public)
+     * await myObject.publishObject();
+     * 
+     * @example
+     * // Unpublish an object (make it private)
+     * await myObject.publishObject({ publish: false });
+     * 
+     * @example
+     * // Publish without auto-saving
+     * await myObject.publishObject({ save: false });
+     * // ... make other changes ...
+     * await myObject.save();
+     */
+    )
+  }, {
+    key: "publishObject",
+    value: (function () {
+      var _publishObject = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5() {
+        var options,
+          _options$publish,
+          publish,
+          _options$save2,
+          save,
+          currentIac,
+          iac,
+          _args5 = arguments;
+        return _regenerator().w(function (_context5) {
+          while (1) switch (_context5.n) {
+            case 0:
+              options = _args5.length > 0 && _args5[0] !== undefined ? _args5[0] : {};
+              _options$publish = options.publish, publish = _options$publish === void 0 ? true : _options$publish, _options$save2 = options.save, save = _options$save2 === void 0 ? true : _options$save2; // Get current IAC settings and create a deep clone to ensure change detection
+              currentIac = this.get('iac') || {};
+              iac = _.cloneDeep(currentIac); // Initialize readGrants if it doesn't exist
+              if (!iac.readGrants) {
+                iac.readGrants = {};
+              }
+
+              // Initialize users array if it doesn't exist
+              if (!Array.isArray(iac.readGrants.users)) {
+                iac.readGrants.users = [];
+              }
+              if (publish) {
+                // Add public_user if not already present
+                if (!iac.readGrants.users.includes('public_user')) {
+                  iac.readGrants.users.push('public_user');
+                }
+              } else {
+                // Remove public_user
+                iac.readGrants.users = iac.readGrants.users.filter(function (userId) {
+                  return userId !== 'public_user';
+                });
+              }
+
+              // Update the object with the cloned and modified IAC
+              this.set('iac', iac);
+
+              // Save if requested
+              if (!save) {
+                _context5.n = 2;
+                break;
+              }
+              _context5.n = 1;
+              return this.save();
+            case 1:
+              return _context5.a(2, _context5.v);
+            case 2:
+              return _context5.a(2, this);
+          }
+        }, _callee5, this);
+      }));
+      function publishObject() {
+        return _publishObject.apply(this, arguments);
+      }
+      return publishObject;
+    }()
+    /**
+     * Unpublishes this object to remove public access.
+     * Removes 'public_user' from the IAC read permissions.
+     * This is an alias for publishObject({ publish: false }) for better code clarity.
+     * 
+     * @param {Object} options - Unpublishing options
+     * @param {boolean} [options.save=true] - If true, automatically saves the object after updating permissions
+     * @returns {Promise<RbtObject>} - Returns this object (saved if options.save is true)
+     * 
+     * @example
+     * // Unpublish an object (remove public access)
+     * await myObject.unpublishObject();
+     * 
+     * @example
+     * // Unpublish without auto-saving
+     * await myObject.unpublishObject({ save: false });
+     * // ... make other changes ...
+     * await myObject.save();
+     */
+    )
+  }, {
+    key: "unpublishObject",
+    value: (function () {
+      var _unpublishObject = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6() {
+        var options,
+          _args6 = arguments;
+        return _regenerator().w(function (_context6) {
+          while (1) switch (_context6.n) {
+            case 0:
+              options = _args6.length > 0 && _args6[0] !== undefined ? _args6[0] : {};
+              _context6.n = 1;
+              return this.publishObject({
+                publish: false,
+                save: options.save !== undefined ? options.save : true
+              });
+            case 1:
+              return _context6.a(2, _context6.v);
+          }
+        }, _callee6, this);
+      }));
+      function unpublishObject() {
+        return _unpublishObject.apply(this, arguments);
+      }
+      return unpublishObject;
+    }()
+    /**
+     * Revokes access from specific users and/or user groups.
+     * 
+     * @param {Object} options - Access revocation options
+     * @param {string[]} [options.userIds=[]] - Array of user IDs to remove from read or write access
+     * @param {string[]} [options.groupIds=[]] - Array of group IDs to remove from read or write access
+     * @param {boolean} [options.write=false] - If true, removes write access; if false, removes read access
+     * @param {boolean} [options.save=true] - If true, automatically saves the object after updating permissions
+     * @returns {Promise<RbtObject>} - Returns this object (saved if options.save is true)
+     * 
+     * @example
+     * // Revoke read access from specific users
+     * await myObject.revokeAccess({ 
+     *   userIds: ['user_123', 'user_456'] 
+     * });
+     * 
+     * @example
+     * // Revoke write access from specific groups
+     * await myObject.revokeAccess({ 
+     *   groupIds: ['grpEditors'],
+     *   write: true 
+     * });
+     * 
+     * @example
+     * // Revoke access from users and groups
+     * await myObject.revokeAccess({ 
+     *   userIds: ['user_123'],
+     *   groupIds: ['grpViewers']
+     * });
+     * 
+     * @example
+     * // Revoke without auto-saving
+     * await myObject.revokeAccess({ 
+     *   userIds: ['user_123'],
+     *   save: false 
+     * });
+     */
+    )
+  }, {
+    key: "revokeAccess",
+    value: (function () {
+      var _revokeAccess = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee7() {
+        var options,
+          _options$userIds2,
+          userIds,
+          _options$groupIds2,
+          groupIds,
+          _options$write2,
+          write,
+          _options$save3,
+          save,
+          iac,
+          grantType,
+          _args7 = arguments;
+        return _regenerator().w(function (_context7) {
+          while (1) switch (_context7.n) {
+            case 0:
+              options = _args7.length > 0 && _args7[0] !== undefined ? _args7[0] : {};
+              _options$userIds2 = options.userIds, userIds = _options$userIds2 === void 0 ? [] : _options$userIds2, _options$groupIds2 = options.groupIds, groupIds = _options$groupIds2 === void 0 ? [] : _options$groupIds2, _options$write2 = options.write, write = _options$write2 === void 0 ? false : _options$write2, _options$save3 = options.save, save = _options$save3 === void 0 ? true : _options$save3; // Validate inputs
+              if (Array.isArray(userIds)) {
+                _context7.n = 1;
+                break;
+              }
+              throw new Error('userIds must be an array');
+            case 1:
+              if (Array.isArray(groupIds)) {
+                _context7.n = 2;
+                break;
+              }
+              throw new Error('groupIds must be an array');
+            case 2:
+              // Get current IAC settings
+              iac = this.get('iac') || {}; // Determine which grant type to update (read or write)
+              grantType = write ? 'writeGrants' : 'readGrants'; // Initialize grants if they don't exist
+              if (!iac[grantType]) {
+                iac[grantType] = {};
+              }
+
+              // Remove specified users
+              if (userIds.length > 0 && Array.isArray(iac[grantType].users)) {
+                iac[grantType].users = iac[grantType].users.filter(function (userId) {
+                  return !userIds.includes(userId);
+                });
+              }
+
+              // Remove specified groups
+              if (groupIds.length > 0 && Array.isArray(iac[grantType].userGroups)) {
+                iac[grantType].userGroups = iac[grantType].userGroups.filter(function (groupId) {
+                  return !groupIds.includes(groupId);
+                });
+              }
+
+              // Update the object
+              this.set('iac', iac);
+
+              // Save if requested
+              if (!save) {
+                _context7.n = 4;
+                break;
+              }
+              _context7.n = 3;
+              return this.save();
+            case 3:
+              return _context7.a(2, _context7.v);
+            case 4:
+              return _context7.a(2, this);
+          }
+        }, _callee7, this);
+      }));
+      function revokeAccess() {
+        return _revokeAccess.apply(this, arguments);
+      }
+      return revokeAccess;
+    }()
+    /**
+     * Checks if this object is currently published (publicly accessible).
+     * 
+     * @returns {boolean} - True if 'public_user' is in the read grants, false otherwise
+     * 
+     * @example
+     * if (myObject.isPublished()) {
+     *   console.log('Object is public');
+     * }
+     */
+    )
+  }, {
+    key: "isPublished",
+    value: function isPublished() {
+      var iac = this.get('iac');
+      if (!iac || !iac.readGrants || !Array.isArray(iac.readGrants.users)) {
+        return false;
+      }
+      return iac.readGrants.users.includes('public_user');
+    }
+
+    /**
+     * Gets the current sharing permissions for this object.
+     * 
+     * @returns {Object} - Object containing read and write grants
+     * @returns {Object} returns.readGrants - Read access grants
+     * @returns {string[]} returns.readGrants.users - Array of user IDs with read access
+     * @returns {string[]} returns.readGrants.userGroups - Array of group IDs with read access
+     * @returns {string[]} returns.readGrants.organizations - Array of organization IDs with read access
+     * @returns {Object} returns.writeGrants - Write access grants
+     * @returns {string[]} returns.writeGrants.users - Array of user IDs with write access
+     * @returns {string[]} returns.writeGrants.userGroups - Array of group IDs with write access
+     * @returns {string[]} returns.writeGrants.organizations - Array of organization IDs with write access
+     * 
+     * @example
+     * const permissions = myObject.getSharing();
+     * console.log('Read users:', permissions.readGrants.users);
+     * console.log('Read groups:', permissions.readGrants.userGroups);
+     */
+  }, {
+    key: "getSharing",
+    value: function getSharing() {
+      var _iac$readGrants, _iac$readGrants2, _iac$readGrants3, _iac$readGrants4, _iac$writeGrants, _iac$writeGrants2, _iac$writeGrants3, _iac$writeGrants4;
+      var iac = this.get('iac') || {};
+      return {
+        readGrants: {
+          users: ((_iac$readGrants = iac.readGrants) === null || _iac$readGrants === void 0 ? void 0 : _iac$readGrants.users) || [],
+          userGroups: ((_iac$readGrants2 = iac.readGrants) === null || _iac$readGrants2 === void 0 ? void 0 : _iac$readGrants2.userGroups) || [],
+          organizations: ((_iac$readGrants3 = iac.readGrants) === null || _iac$readGrants3 === void 0 ? void 0 : _iac$readGrants3.organizations) || [],
+          userSegments: ((_iac$readGrants4 = iac.readGrants) === null || _iac$readGrants4 === void 0 ? void 0 : _iac$readGrants4.userSegments) || []
+        },
+        writeGrants: {
+          users: ((_iac$writeGrants = iac.writeGrants) === null || _iac$writeGrants === void 0 ? void 0 : _iac$writeGrants.users) || [],
+          userGroups: ((_iac$writeGrants2 = iac.writeGrants) === null || _iac$writeGrants2 === void 0 ? void 0 : _iac$writeGrants2.userGroups) || [],
+          organizations: ((_iac$writeGrants3 = iac.writeGrants) === null || _iac$writeGrants3 === void 0 ? void 0 : _iac$writeGrants3.organizations) || [],
+          userSegments: ((_iac$writeGrants4 = iac.writeGrants) === null || _iac$writeGrants4 === void 0 ? void 0 : _iac$writeGrants4.userSegments) || []
+        }
+      };
+    }
+  }, {
+    key: "delete",
+    value: function () {
+      var _delete2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee8() {
+        var record, response, _t2;
+        return _regenerator().w(function (_context8) {
+          while (1) switch (_context8.p = _context8.n) {
+            case 0:
+              if (this._internalData.type) {
+                _context8.n = 1;
+                break;
+              }
+              throw new Error('Cannot delete object without type');
+            case 1:
+              _context8.p = 1;
+              record = this.toRecord();
+              _context8.n = 2;
+              return this._axios.post('/object_service/deleteObject', {
+                id: record.id,
+                type: record.type
+              });
+            case 2:
+              response = _context8.v;
+              if (!(response.data.ok === false)) {
+                _context8.n = 3;
+                break;
+              }
+              throw new Error(response.data.message);
+            case 3:
+              this._internalData = response.data;
+              return _context8.a(2, this);
+            case 4:
+              _context8.p = 4;
+              _t2 = _context8.v;
+              console.log('RbtObject.delete.error:');
+              console.log(_t2.response.data);
+              throw _t2;
+            case 5:
+              return _context8.a(2);
+          }
+        }, _callee8, this, [[1, 4]]);
+      }));
+      function _delete() {
+        return _delete2.apply(this, arguments);
+      }
+      return _delete;
+    }()
+  }, {
+    key: "_deepUnpackJson",
+    value: function _deepUnpackJson(value) {
+      if (typeof value === 'string') {
+        try {
+          // Only parse as JSON if it's not a large number
+          // https://chatgpt.com/c/6745902c-edf4-800c-ab52-31bf27dde2bd
+          // 
+          if (!/^\d{16,}$/.test(value)) {
+            var parsed = JSON.parse(value);
+            // Recursively parse if the result is a string, object, or array
+            return this._deepUnpackJson(parsed);
+          }
+        } catch (e) {
+          return value; // Return the original string if parsing fails
+        }
+      } else if (value !== null && _typeof(value) === 'object') {
+        // If it's an object (including arrays), recursively parse each value
+        for (var key in value) {
+          value[key] = this._deepUnpackJson(value[key]);
+        }
+      }
+      return value;
+    }
+
+    //
+    // Realtime WebSocket 
+    //
+    //
+  }, {
+    key: "_initRealtime",
+    value: function _initRealtime() {
+      if (this._realtime || !this._axios) return;
+
+      // 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;
+      this._subscribeToRealtime(ws);
+    }
+  }, {
+    key: "_subscribeToRealtime",
+    value: function _subscribeToRealtime(ws) {
+      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',
+          objectId: this.id
+        }));
+      } else {
+        ws.addEventListener('open', function () {
+          ws.send(JSON.stringify({
+            type: 'subscribe',
+            objectId: _this3.id
+          }));
+        });
+      }
+      ws.addEventListener('message', function (event) {
+        try {
+          var msg = JSON.parse(event.data);
+          if (msg.objectId !== _this3.id) return;
+          if (msg.type === 'update') {
+            if (msg.delta && msg.delta.path !== undefined) {
+              _.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: "onChange",
+    value: function onChange(cb) {
+      this._eventHandlers.change.push(cb);
+      // 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: "onSave",
+    value: function onSave(cb) {
+      this._eventHandlers.save.push(cb);
+      // 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 {
+        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) {
+      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();
+    }
+  }]);
+}();
+export { RbtObject as default };