@superutils/rx 0.1.6 → 0.1.8

package/dist/index.cjs

@@ -44,6 +44,7 @@ __export(index_exports, {
   isObservable: () => import_rxjs.isObservable,
   isSubjectLike: () => isSubjectLike2,
   isSubscriptionLike: () => isSubscriptionLike,
+  objToMap: () => import_core7.objToMap,
   skip: () => import_rxjs.skip,
   unsubscribeAll: () => unsubscribeAll
 });
@@ -203,100 +204,36 @@ var OnErrorType = /* @__PURE__ */ ((OnErrorType2) => {
 // src/data-storage/DataStorage.ts
 var forceUpdateCache$ = new import_rxjs.Subject();
 var _DataStorage = class _DataStorage {
-  /**
-   * A wrapper for reading and writing to LocalStorage (browser) or JSON files (NodeJS),
-   * providing a Map-like interface with advanced features like search, filtering, and sorting.
-   *
-   * #### Notes:
-   * - **Performance**: `DataStorage` is optimized for small to medium datasets.
-   *   - For datasets > 1MB, consider increasing the `delay` option to reduce write frequency.
-   *   - It is **NOT** recommended for datasets larger than 3MB due to synchronous serialization costs.
-   * - **RxJS Integration**: Built on RxJS for reactive data handling, though no prior RxJS knowledge is required.
-   * - **Storage Behavior**:
-   *   - If `name` is omitted, the instance operates in-memory only and data is not persisted to storage.
-   *   - If `cacheDisabled` is `true`, data is not kept in memory; every read/write operation accesses the underlying
-   * storage directly.
-   *
-   * @example
-   * #### Browser Usage
-   * ```javascript
-   * import { DataStorage } from '@superutils/rx'
-   * import fetch from '@superutils/fetch'
-   *
-   * const storage = new DataStorage('products')
-   * const { products } = await fetch('[DUMMYJSON-DOT-COM]/products')
-   * // save all items to storage
-   * storage.setAll(
-   *   new Map(products.map(p => [p.id, p])), // convert to Map
-   * )
-   *
-   * // print product with id `1`
-   * console.log(storage.get(1))
-   *
-   * // search for items
-   * const searchResult = storage.search({
-   *   query: { availabilityStatus: 'low' }
-   * })
-   * console.log(searchResult)
-   * ```
-   * @example
-   * #### NodeJS Usage
-   * ```javascript
-   * import { DataStorage } from '@superutils/rx'
-   * import fetch from '@superutils/fetch'
-   * import { LocalStorage } from 'node-localstorage'
-   *
-   * // Add localStorage alternative for NodeJS that reads and writes to JSON files.
-   * // This is not necessary for browsers.
-   * globalThis.localStorage = new LocalStorage('./data', 1e7)
-   *
-   * const storage = new DataStorage('products')
-   * const { products } = await fetch('[DUMMYJSON-DOT-COM]/products')
-   * // save all items to storage
-   * storage.setAll(
-   *   new Map(products.map(p => [p.id, p])), // convert to Map
-   * )
-   *
-   * // print product with id `1`
-   * console.log(storage.get(1))
-   *
-   * // search for items
-   * const searchResult = storage.search({
-   *   query: { availabilityStatus: 'low' }
-   * })
-   * console.log(searchResult)
-   * ```
-   *
-   * @example
-   * #### Advanced: `onChange` and RxJS subject
-   *
-   * Internally, `DataStorage` uses RxJS subject which is exposed as `subject` property.
-   * You can use this to subscribe to changes and do additional operations such as logging or sanitization etc.
-   *
-   * Alternatively, you can also set the `onChange` callback which is triggered whenever the subject changes and
-   * does not require maintaining a subscription or knowledge of RxJS subject.
-   *
-   * ```javascript
-   * import { DataStorage } from '@superutils/rx'
-   *
-   * const storage = new DataStorage('my-data')
-   * const sub = storage.subject.subscribe(data => {
-   *   // Write to the database whenever data changes
-   *   console.log('Saving to database...', data)
-   * })
-   * // unsubscribe from subject
-   * setTimeout(()=> sub.unsbuscribe(), 1000)
-   *
-   * // add an entry to storage
-   * storage.set('bob', { age: 99, id: 'bob', name: 'Bob' })
-   * ```
-   */
   constructor(name, options) {
     this.initialized = false;
     this.subscriptions = {
       subject: void 0,
       forceUpdateCache: void 0
     };
+    this.clear = () => this.setAll(/* @__PURE__ */ new Map(), true);
+    this.delete = (keys) => {
+      if (!(0, import_core6.isArr)(keys)) keys = [keys];
+      const data = this.getAll();
+      for (const k of keys) data.delete(k);
+      this.setAll(data, true);
+      return this;
+    };
+    this.filter = (...args) => (0, import_core6.filter)(this.getAll(), ...args);
+    this.find = (predicateOrOptions) => (0, import_core6.find)(this.getAll(), predicateOrOptions);
+    this.get = (key) => this.getAll().get(key);
+    this.getAll = (forceRead = false) => {
+      var _a, _b;
+      const wasInitialized = this.initialized;
+      if (!wasInitialized) this.init();
+      const readFromStorage = this.cacheDisabled || this.name && forceRead;
+      if (readFromStorage) {
+        const data = this.read();
+        const shouldTrigger = forceRead || !wasInitialized && !!data.size;
+        shouldTrigger && this.subject.next(data);
+        return data;
+      }
+      return (_b = (_a = this.subject) == null ? void 0 : _a.value) != null ? _b : /* @__PURE__ */ new Map();
+    };
     this.handleForceUpdateCacheChange = (name) => {
       const isTarget = !this.name ? false : (0, import_core6.isArr)(name) ? name.includes(this.name) : (0, import_core6.isStr)(name) ? name === this.name : name === true;
       if (!isTarget) return;
@@ -313,6 +250,107 @@ var _DataStorage = class _DataStorage {
         this.triggerOnError("onChange" /* onChange */)
       );
     };
+    this.has = (key) => this.getAll().has(key);
+    this.init = (initialValue) => {
+      var _a;
+      if (this.initialized) return false;
+      this.initialized = true;
+      let isEmpty = true;
+      if (!!(initialValue == null ? void 0 : initialValue.size) || !this.cacheDisabled) {
+        const dataStr = this.name ? (_a = this.storage) == null ? void 0 : _a.getItem(this.name) : null;
+        const existingValue = this.read(dataStr);
+        if ((0, import_core6.isDefined)(dataStr)) initialValue = existingValue;
+        isEmpty = this.cacheDisabled || existingValue.size === 0;
+      }
+      (initialValue == null ? void 0 : initialValue.size) && this.subject.next(initialValue);
+      unsubscribeAll_default(this.subscriptions);
+      if (!this.cacheDisabled) {
+        this.subscriptions.forceUpdateCache = forceUpdateCache$.subscribe(
+          this.handleForceUpdateCacheChange
+        );
+      }
+      this.subscriptions.subject = this.subject.pipe((0, import_rxjs.skip)(this.cacheDisabled || isEmpty ? 0 : 1)).subscribe(
+        !this.cacheDisabled && this.delay > 0 ? (0, import_core6.deferred)(this.handleSubjectChange, this.delay, {
+          thisArg: this,
+          ...this.delayOptions
+        }) : this.handleSubjectChange
+      );
+      return true;
+    };
+    this.keys = () => (0, import_core6.getKeys)(this.getAll());
+    this.map = (callback) => this.toArray().map(
+      ([key, value], index, entries) => callback(value, key, entries, index)
+    );
+    this.read = (dataStr = this.name ? ((_a) => (_a = this.storage) == null ? void 0 : _a.getItem(this.name))() : null) => {
+      var _a2;
+      if (!this.name) {
+        return (_a2 = this.subject.value) != null ? _a2 : /* @__PURE__ */ new Map();
+      }
+      const data = (0, import_core6.fallbackIfFails)(
+        (() => {
+          var _a3;
+          return (_a3 = this.parse) == null ? void 0 : _a3.call(this, dataStr);
+        }),
+        [],
+        this.triggerOnError("parse" /* parse */)
+      );
+      if ((0, import_core6.isMap)(data)) return data;
+      if (!(0, import_core6.isStr)(dataStr)) return /* @__PURE__ */ new Map();
+      return new Map(
+        (0, import_core6.fallbackIfFails)(
+          () => JSON.parse(dataStr),
+          [],
+          this.triggerOnError("parse-json" /* parse_json */)
+        )
+      );
+    };
+    this.search = (...args) => (0, import_core6.search)(this.getAll(), ...args);
+    this.set = (key, value) => this.setAll(/* @__PURE__ */ new Map([[key, value]]), false);
+    this.setAll = (data, replace = false) => {
+      if (!(0, import_core6.isMap)(data)) return this;
+      data = replace ? data : (0, import_core6.mapJoin)(this.getAll(), data);
+      this.subject.next(new Map(data));
+      return this;
+    };
+    this.sort = (...args) => {
+      var _a;
+      const result = (0, import_core6.sort)(
+        this.getAll(),
+        args[0],
+        args[1]
+      );
+      ((_a = args[1]) == null ? void 0 : _a.save) && this.setAll(result, true);
+      return result;
+    };
+    this.toArray = () => (0, import_core6.getEntries)(this.getAll());
+    this.toJSON = (replacer, spacing = this.spaces, data = this.getAll()) => {
+      const str = (0, import_core6.fallbackIfFails)(
+        (() => {
+          var _a;
+          return (_a = this.stringify) == null ? void 0 : _a.call(this, data);
+        }),
+        [],
+        this.triggerOnError("stringify" /* stringify */)
+      );
+      if ((0, import_core6.isStr)(str)) return str;
+      return (0, import_core6.fallbackIfFails)(
+        () => JSON.stringify(
+          Array.from(data),
+          replacer,
+          spacing
+        ),
+        [],
+        this.triggerOnError("stringify-json" /* stringify_json */, "")
+      );
+    };
+    this.toObject = (data = this.getAll()) => {
+      const obj = {};
+      if (!(0, import_core6.isMap)(data)) return obj;
+      for (const [key, value] of data)
+        obj[key] = value;
+      return obj;
+    };
+    this.toString = (data = this.getAll()) => this.toJSON(void 0, void 0, data);
     this.triggerOnError = (type, returnValue = void 0) => (err) => {
       var _a;
       (0, import_core6.fallbackIfFails)(
@@ -322,6 +360,21 @@ var _DataStorage = class _DataStorage {
       );
       return returnValue;
     };
+    this.unsubscribe = () => unsubscribeAll_default(this.subscriptions);
+    this.values = () => (0, import_core6.getValues)(this.getAll());
+    this.write = (data) => {
+      var _a;
+      try {
+        !this.initialized && this.init();
+        const finalData = data != null ? data : (_a = this.subject) == null ? void 0 : _a.value;
+        if (!this.name || !this.storage || !(0, import_core6.isMap)(finalData)) return false;
+        this.storage.setItem(this.name, this.toString(finalData));
+        return true;
+      } catch (err) {
+        this.triggerOnError("write" /* write */)(err);
+        return false;
+      }
+    };
     const {
       cacheDisabled = false,
       delay,
@@ -358,168 +411,6 @@ var _DataStorage = class _DataStorage {
   get size() {
     return this.getAll().size;
   }
-  clear() {
-    this.setAll(/* @__PURE__ */ new Map(), true);
-    return this;
-  }
-  delete(keys) {
-    if (!(0, import_core6.isArr)(keys)) keys = [keys];
-    const data = this.getAll();
-    for (const k of keys) data.delete(k);
-    this.setAll(data, true);
-    return this;
-  }
-  find(predicateOrOptions) {
-    return (0, import_core6.find)(
-      this.getAll(),
-      predicateOrOptions
-    );
-  }
-  filter(...args) {
-    return (0, import_core6.filter)(this.getAll(), ...args);
-  }
-  get(key) {
-    return this.getAll().get(key);
-  }
-  getAll(forceRead = false) {
-    var _a, _b;
-    const wasInitialized = this.initialized;
-    if (!wasInitialized) this.init();
-    const readFromStorage = this.cacheDisabled || this.name && forceRead;
-    if (readFromStorage) {
-      const data = this.read();
-      const shouldTrigger = forceRead || !wasInitialized && !!data.size;
-      shouldTrigger && this.subject.next(data);
-      return data;
-    }
-    return (_b = (_a = this.subject) == null ? void 0 : _a.value) != null ? _b : /* @__PURE__ */ new Map();
-  }
-  has(key) {
-    return this.getAll().has(key);
-  }
-  init(initialValue) {
-    if (this.initialized) return false;
-    this.initialized = true;
-    let isEmpty = true;
-    if (!!(initialValue == null ? void 0 : initialValue.size) || !this.cacheDisabled) {
-      const existingValue = this.read();
-      if (existingValue.size) initialValue = existingValue;
-      isEmpty = this.cacheDisabled || existingValue.size === 0;
-    }
-    (initialValue == null ? void 0 : initialValue.size) && this.subject.next(initialValue);
-    unsubscribeAll_default(this.subscriptions);
-    if (!this.cacheDisabled) {
-      this.subscriptions.forceUpdateCache = forceUpdateCache$.subscribe(
-        this.handleForceUpdateCacheChange
-      );
-    }
-    this.subscriptions.subject = this.subject.pipe((0, import_rxjs.skip)(this.cacheDisabled || isEmpty ? 0 : 1)).subscribe(
-      !this.cacheDisabled && this.delay > 0 ? (0, import_core6.deferred)(this.handleSubjectChange, this.delay, {
-        thisArg: this,
-        ...this.delayOptions
-      }) : this.handleSubjectChange
-    );
-    return true;
-  }
-  keys() {
-    return (0, import_core6.getKeys)(this.getAll());
-  }
-  map(callback) {
-    return this.toArray().map(
-      ([key, value], index, data) => callback(value, key, data, index)
-    );
-  }
-  read() {
-    var _a, _b, _c;
-    const dataStr = (_b = (_a = this.storage) == null ? void 0 : _a.getItem(this.name)) != null ? _b : "";
-    const parse = (_c = this.parse) == null ? void 0 : _c.bind(this);
-    const data = (0, import_core6.fallbackIfFails)(
-      parse,
-      [dataStr],
-      this.triggerOnError("parse" /* parse */)
-    );
-    if ((0, import_core6.isMap)(data)) return data;
-    return new Map(
-      (0, import_core6.fallbackIfFails)(
-        () => JSON.parse(dataStr),
-        [],
-        this.triggerOnError("parse-json" /* parse_json */)
-      )
-    );
-  }
-  search(options) {
-    return (0, import_core6.search)(this.getAll(), options);
-  }
-  set(key, value) {
-    this.setAll(/* @__PURE__ */ new Map([[key, value]]), false);
-    return this;
-  }
-  setAll(data = /* @__PURE__ */ new Map(), replace = false) {
-    if (!(0, import_core6.isMap)(data)) return this;
-    data = replace ? data : (0, import_core6.mapJoin)(this.getAll(), data);
-    this.subject.next(new Map(data));
-    return this;
-  }
-  sort(...args) {
-    var _a;
-    const result = (0, import_core6.sort)(
-      this.getAll(),
-      args[0],
-      args[1]
-    );
-    ((_a = args[1]) == null ? void 0 : _a.save) && this.setAll(result, true);
-    return result;
-  }
-  toArray() {
-    return (0, import_core6.getEntries)(this.getAll());
-  }
-  toJSON(...[replacer, spacing = this.spaces, data = this.getAll()]) {
-    var _a;
-    const stringify = (_a = this.stringify) == null ? void 0 : _a.bind(this);
-    const str = (0, import_core6.fallbackIfFails)(
-      stringify,
-      [data],
-      this.triggerOnError("stringify" /* stringify */)
-    );
-    if ((0, import_core6.isStr)(str)) return str;
-    return (0, import_core6.fallbackIfFails)(
-      () => JSON.stringify(
-        Array.from(data),
-        replacer,
-        spacing
-      ),
-      [],
-      this.triggerOnError("stringify-json" /* stringify_json */, "")
-    );
-  }
-  toObject(data = ((_a) => (_a = this == null ? void 0 : this.getAll) == null ? void 0 : _a.call(this))()) {
-    const obj = {};
-    data = !(0, import_core6.isMap)(data) ? /* @__PURE__ */ new Map() : data;
-    for (const [key, value] of data)
-      obj[key] = value;
-    return obj;
-  }
-  toString(data) {
-    return this.toJSON(void 0, void 0, data);
-  }
-  unsubscribe() {
-    return unsubscribeAll_default(this.subscriptions);
-  }
-  values() {
-    return (0, import_core6.getValues)(this.getAll());
-  }
-  write(data) {
-    try {
-      !this.initialized && this.init();
-      data != null ? data : data = this.subject.value;
-      if (!this.name || !this.storage || !(0, import_core6.isMap)(data)) return false;
-      this.storage.setItem(this.name, this.toString(data));
-      return true;
-    } catch (err) {
-      this.triggerOnError("write" /* write */)(err);
-      return false;
-    }
-  }
 };
 /**
  * Creates a {@link DataStorage} instance initialized from a plain object.
@@ -568,35 +459,30 @@ var _DataStorage = class _DataStorage {
  * ```
  */
 _DataStorage.fromObject = (name, options) => new _DataStorage(name, {
-  parse: (str) => (0, import_core6.objToMap)(JSON.parse(str || "{}")),
-  stringify: (data) => JSON.stringify(_DataStorage.prototype.toObject(data)),
+  parse: (str) => (0, import_core6.objToMap)(JSON.parse(str != null ? str : "{}")),
+  stringify: function(data) {
+    return JSON.stringify(this.toObject(data));
+  },
   ...options,
   initialValue: !(0, import_core6.isObj)(options == null ? void 0 : options.initialValue, true) ? options == null ? void 0 : options.initialValue : (0, import_core6.objToMap)(options.initialValue)
 });
 /**
  * Trigger forced update of cached data from storage.
  *
- * @param name determines which storage instances to be updated.
+ * @param name determines which cache-enabled storage instances to be updated.
  * - name (`string` | `string[]`): update all instances with a specific name(s)
  * - global (`true`): update all instances globally
  *
- * @example
- * ```javascript
- * import { DataStorage } from '@superutils/rx'
- *
- * // Update all DataStorage instances with specific name(s)
- * const name = 'products'
- * DataStorage.forceUpdateCache([name])
- *
- * // Update every single instance of DataStorage that uses storage (has a "name")
- * DataStorage.forceUpdateCache(true)
- * ```
+ * See {@link forceUpdateCache$} for more details.
  */
 _DataStorage.forceUpdateCache = (name) => {
   forceUpdateCache$.next(name);
 };
 var DataStorage = _DataStorage;
 
+// src/data-storage/index.ts
+var import_core7 = require("@superutils/core");
+
 // src/IntervalSubject.ts
 var IntervalSubject = class extends import_rxjs.BehaviorSubject {
   constructor(autoStart, _delay = 1e3, initialValue = 0, incrementBy = 1) {
@@ -641,7 +527,7 @@ var IntervalSubject = class extends import_rxjs.BehaviorSubject {
 };
 
 // src/IntervalRunner.ts
-var import_core7 = require("@superutils/core");
+var import_core8 = require("@superutils/core");
 var IntervalRunner = class {
   constructor(taskFn, taskArgs, intervalMs, sequential = true, preExecute = true) {
     this.taskFn = taskFn;
@@ -668,7 +554,7 @@ var IntervalRunner = class {
       } catch (_err) {
         err = _err;
       }
-      (0, import_core7.fallbackIfFails)(
+      (0, import_core8.fallbackIfFails)(
         this.onResult,
         [err != null ? err : null, result, this.runCount, once],
         void 0
@@ -720,7 +606,7 @@ var IntervalRunner = class {
         delayMs = Math.max((_a = newDelayMs != null ? newDelayMs : delayMs) != null ? _a : 0, this.minIntervalMs);
         this.clearInterval();
         const preExec = this.lastResult === void 0 && this.preExecute;
-        preExec && this.executeTask().catch(import_core7.noop);
+        preExec && this.executeTask().catch(import_core8.noop);
         this.idInterval = !this.sequential ? setInterval(this.executeTask, delayMs) : !preExec ? setTimeout(this.executeTask, delayMs) : void 0;
       });
       return true;
@@ -757,6 +643,7 @@ var IntervalRunner = class {
   isObservable,
   isSubjectLike,
   isSubscriptionLike,
+  objToMap,
   skip,
   unsubscribeAll
 });