@dr.pogodin/js-utils 0.1.0 → 0.1.1

package/README.md

@@ -45,7 +45,13 @@ and used in the same way):
 - [YEAR_MS](https://dr.pogodin.studio/docs/react-utils/docs/api/utils/time#year_ms)
   — One year expressed in milliseconds.
 
+### Types
+- `ObjectKey` — **string** | **number** | **symbol** —
+  The most generic valid type of an object key in TypeScript.
+
 ### Functions
+- `assertEmptyObject()` — Asserts given object is empty,
+  both compile- and run-time.
 - [timer()] — Creates a [Barrier] which resolves after the specified timeout.
 - [withRetries()] — Attempts a given action multiple times until its succeeds.
 
@@ -53,8 +59,9 @@ and used in the same way):
 - [Barrier] — A [Promise] with **resolve()** and **reject()** exposed as
   instance methods.
 
-- `Cached` — Implements a cache of (a)synchronously retrieved items with
-  timestamp-based expiration. _To be documented_.
+- [Cached](https://dr.pogodin.studio/docs/react-utils/docs/api/classes/Cached)
+  — A cache of (a)synchronously retrieved items with timestamp-based
+  expiration.
 
 - [Emitter](https://dr.pogodin.studio/docs/react-utils/docs/api/classes/Emitter)
   — Simple listeneable data emitter.

package/build/common/Cached.js

@@ -16,17 +16,17 @@ function getTimestamp(e) {
   return Array.isArray(e) ? e[1] : e.timestamp;
 }
 class Cached {
-  data = {};
-  oldestTimestamp = Number.MAX_SAFE_INTEGER;
+  pData = {};
+  pOldestTimestamp = Number.MAX_SAFE_INTEGER;
 
   /** For test use only. */
-  get _data() {
-    return this.data;
+  get data() {
+    return this.pData;
   }
 
   /** For test use only. */
-  get _oldestTimestamp() {
-    return this.oldestTimestamp;
+  get oldestTimestamp() {
+    return this.pOldestTimestamp;
   }
   constructor(maxage, getter) {
     this.maxage = maxage;
@@ -36,44 +36,56 @@ class Cached {
   /** Removes stale items from the cache, and updates .oldestTimestamp. */
   cleanCache() {
     const deadline = Date.now() - this.maxage;
-    this.oldestTimestamp = Number.MAX_SAFE_INTEGER;
-    for (const [key, entry] of Object.entries(this.data)) {
+    this.pOldestTimestamp = Number.MAX_SAFE_INTEGER;
+    for (const [key, entry] of Object.entries(this.pData)) {
       const timestamp = getTimestamp(entry);
-      if (timestamp < deadline) delete this.data[key];else if (timestamp < this.oldestTimestamp) {
-        this.oldestTimestamp = timestamp;
+      if (timestamp < deadline) delete this.pData[key];else if (timestamp < this.pOldestTimestamp) {
+        this.pOldestTimestamp = timestamp;
       }
     }
   }
 
+  /**
+   * Adds entry to the cache.
+   * NOTE: It assumes entry's timestamp is the current moment (for the cache
+   * cleaning purposes; if it is not, but it is a past timestamp, nothing bad
+   * will happen, just some cleaning operation will be skipped).
+   */
+  setEntry(id, entry) {
+    this.pData[id] = entry;
+    const timestamp = getTimestamp(entry);
+    if (timestamp < this.pOldestTimestamp) this.pOldestTimestamp = timestamp;else if (this.pOldestTimestamp < timestamp - this.maxage) this.cleanCache();
+  }
+
   /** Adds `datum` to the cache, and removes stale items from the cache. */
   set(id, datum) {
-    const now = Date.now();
-    if (this.oldestTimestamp < now - this.maxage) this.cleanCache();
-    if (now < this.oldestTimestamp) this.oldestTimestamp = now;
-    const res = [datum, now];
-    this.data[id] = res;
+    const res = [datum, Date.now()];
+    this.setEntry(id, res);
     return res;
   }
 
-  /** Retrieves envelope of the specified datum, either read from the cache,
-   *  or retrieved using the getter provided at construction time. */
-  getEntry(id) {
+  /**
+   * Retrieves envelope of the specified datum, either read from the cache,
+   * or retrieved using the getter provided at construction time.
+   */
+  getEntry(id, forceRefresh) {
     const now = Date.now();
-    let cached = this.data[id];
-    if (cached && getTimestamp(cached) >= now - this.maxage) return cached;
+    if (!forceRefresh) {
+      const cached = this.pData[id];
+      if (cached && getTimestamp(cached) >= now - this.maxage) return cached;
+    }
     const itemOrPromise = this.getter(id);
     if (!(itemOrPromise instanceof Promise)) {
       return this.set(id, itemOrPromise);
     }
-    cached = addTimestamp(itemOrPromise.then(item => this.set(id, item)), now);
-    if (now < this.oldestTimestamp) this.oldestTimestamp = now;
-    this.data[id] = cached;
-    return cached;
+    const promise = addTimestamp(itemOrPromise.then(item => this.set(id, item)), now);
+    this.setEntry(id, promise);
+    return promise;
   }
 
   /** Gets item. */
-  get(id) {
-    const entry = this.getEntry(id);
+  get(id, forceRefresh) {
+    const entry = this.getEntry(id, forceRefresh);
     return Array.isArray(entry) ? entry[0] : entry.then(e => e[0]);
   }
 }

package/build/common/Cached.js.map

@@ -1 +1 @@
-{"version":3,"file":"Cached.js","names":["addTimestamp","promise","timestamp","res","getTimestamp","e","Array","isArray","Cached","data","oldestTimestamp","Number","MAX_SAFE_INTEGER","_data","_oldestTimestamp","constructor","maxage","getter","cleanCache","deadline","Date","now","key","entry","Object","entries","set","id","datum","getEntry","cached","itemOrPromise","Promise","then","item","get","exports"],"sources":["../../src/Cached.ts"],"sourcesContent":["type CachedT<T> = [T, number];\ntype TimestampedPromise<T> = Promise<T> & { timestamp: number };\ntype EntryT<T> = CachedT<T> | TimestampedPromise<CachedT<T>>;\n\n/** Adds timestamp to the promise. */\nfunction addTimestamp<T>(\n  promise: Promise<T>,\n  timestamp: number,\n): TimestampedPromise<T> {\n  const res = promise as TimestampedPromise<T>;\n  res.timestamp = timestamp;\n  return res;\n}\n\n/** Gets entry timestamp. */\nfunction getTimestamp<T>(e: EntryT<T>): number {\n  return Array.isArray(e) ? e[1] : e.timestamp;\n}\n\nexport class Cached<T> {\n  private data: Record<string, EntryT<T>> = {};\n  private oldestTimestamp = Number.MAX_SAFE_INTEGER;\n\n  /** For test use only. */\n  get _data(): Readonly<Record<string, EntryT<T>>> {\n    return this.data;\n  }\n\n  /** For test use only. */\n  get _oldestTimestamp(): number {\n    return this.oldestTimestamp;\n  }\n\n  constructor(\n    public readonly maxage: number,\n    private getter: (id: string) => T | Promise<T>,\n  ) {}\n\n  /** Removes stale items from the cache, and updates .oldestTimestamp. */\n  private cleanCache() {\n    const deadline = Date.now() - this.maxage;\n    this.oldestTimestamp = Number.MAX_SAFE_INTEGER;\n    for (const [key, entry] of Object.entries(this.data)) {\n      const timestamp = getTimestamp(entry);\n      if (timestamp < deadline) delete this.data[key];\n      else if (timestamp < this.oldestTimestamp) {\n        this.oldestTimestamp = timestamp;\n      }\n    }\n  }\n\n  /** Adds `datum` to the cache, and removes stale items from the cache. */\n  private set(id: string, datum: T): CachedT<T> {\n    const now = Date.now();\n    if (this.oldestTimestamp < now - this.maxage) this.cleanCache();\n    if (now < this.oldestTimestamp) this.oldestTimestamp = now;\n    const res: CachedT<T> = [datum, now];\n    this.data[id] = res;\n    return res;\n  }\n\n  /** Retrieves envelope of the specified datum, either read from the cache,\n   *  or retrieved using the getter provided at construction time. */\n  private getEntry(id: string): EntryT<T> {\n    const now = Date.now();\n\n    let cached = this.data[id];\n    if (cached && getTimestamp(cached) >= now - this.maxage) return cached;\n\n    const itemOrPromise = this.getter(id);\n    if (!(itemOrPromise instanceof Promise)) {\n      return this.set(id, itemOrPromise);\n    }\n\n    cached = addTimestamp(\n      itemOrPromise.then((item) => this.set(id, item)),\n      now,\n    );\n    if (now < this.oldestTimestamp) this.oldestTimestamp = now;\n    this.data[id] = cached;\n    return cached;\n  }\n\n  /** Gets item. */\n  get(id: string): T | Promise<T> {\n    const entry = this.getEntry(id);\n    return Array.isArray(entry) ? entry[0] : entry.then((e) => e[0]);\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Cached.js","names":["addTimestamp","promise","timestamp","res","getTimestamp","e","Array","isArray","Cached","pData","pOldestTimestamp","Number","MAX_SAFE_INTEGER","data","oldestTimestamp","constructor","maxage","getter","cleanCache","deadline","Date","now","key","entry","Object","entries","setEntry","id","set","datum","getEntry","forceRefresh","cached","itemOrPromise","Promise","then","item","get","exports"],"sources":["../../src/Cached.ts"],"sourcesContent":["type CachedT<T> = [T, number];\ntype TimestampedPromise<T> = Promise<T> & { timestamp: number };\ntype EntryT<T> = CachedT<T> | TimestampedPromise<CachedT<T>>;\n\n/** Adds timestamp to the promise. */\nfunction addTimestamp<T>(\n  promise: Promise<T>,\n  timestamp: number,\n): TimestampedPromise<T> {\n  const res = promise as TimestampedPromise<T>;\n  res.timestamp = timestamp;\n  return res;\n}\n\n/** Gets entry timestamp. */\nfunction getTimestamp<T>(e: EntryT<T>): number {\n  return Array.isArray(e) ? e[1] : e.timestamp;\n}\n\nexport class Cached<T> {\n  private pData: Record<string, EntryT<T>> = {};\n  private pOldestTimestamp = Number.MAX_SAFE_INTEGER;\n\n  /** For test use only. */\n  get data(): Readonly<Record<string, EntryT<T>>> {\n    return this.pData;\n  }\n\n  /** For test use only. */\n  get oldestTimestamp(): number {\n    return this.pOldestTimestamp;\n  }\n\n  constructor(\n    public readonly maxage: number,\n    private getter: (id: string) => T | Promise<T>,\n  ) {}\n\n  /** Removes stale items from the cache, and updates .oldestTimestamp. */\n  private cleanCache() {\n    const deadline = Date.now() - this.maxage;\n    this.pOldestTimestamp = Number.MAX_SAFE_INTEGER;\n    for (const [key, entry] of Object.entries(this.pData)) {\n      const timestamp = getTimestamp(entry);\n      if (timestamp < deadline) delete this.pData[key];\n      else if (timestamp < this.pOldestTimestamp) {\n        this.pOldestTimestamp = timestamp;\n      }\n    }\n  }\n\n  /**\n   * Adds entry to the cache.\n   * NOTE: It assumes entry's timestamp is the current moment (for the cache\n   * cleaning purposes; if it is not, but it is a past timestamp, nothing bad\n   * will happen, just some cleaning operation will be skipped).\n   */\n  private setEntry(id: string, entry: EntryT<T>) {\n    this.pData[id] = entry;\n    const timestamp = getTimestamp(entry);\n    if (timestamp < this.pOldestTimestamp) this.pOldestTimestamp = timestamp;\n    else if (this.pOldestTimestamp < timestamp - this.maxage) this.cleanCache();\n  }\n\n  /** Adds `datum` to the cache, and removes stale items from the cache. */\n  private set(id: string, datum: T): CachedT<T> {\n    const res: CachedT<T> = [datum, Date.now()];\n    this.setEntry(id, res);\n    return res;\n  }\n\n  /**\n   * Retrieves envelope of the specified datum, either read from the cache,\n   * or retrieved using the getter provided at construction time.\n   */\n  private getEntry(id: string, forceRefresh?: boolean): EntryT<T> {\n    const now = Date.now();\n\n    if (!forceRefresh) {\n      const cached = this.pData[id];\n      if (cached && getTimestamp(cached) >= now - this.maxage) return cached;\n    }\n\n    const itemOrPromise = this.getter(id);\n    if (!(itemOrPromise instanceof Promise)) {\n      return this.set(id, itemOrPromise);\n    }\n\n    const promise = addTimestamp(\n      itemOrPromise.then((item) => this.set(id, item)),\n      now,\n    );\n\n    this.setEntry(id, promise);\n\n    return promise;\n  }\n\n  /** Gets item. */\n  get(id: string, forceRefresh?: boolean): T | Promise<T> {\n    const entry = this.getEntry(id, forceRefresh);\n    return Array.isArray(entry) ? entry[0] : entry.then((e) => e[0]);\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/common/index.js

@@ -65,5 +65,17 @@ Object.keys(_time).forEach(function (key) {
     }
   });
 });
+var _types = require("./types");
+Object.keys(_types).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _types[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _types[key];
+    }
+  });
+});
 var _withRetries = _interopRequireDefault(require("./withRetries"));
 //# sourceMappingURL=index.js.map

package/build/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["_Barrier","_interopRequireDefault","require","_Cached","Object","keys","forEach","key","prototype","hasOwnProperty","call","_exportNames","exports","defineProperty","enumerable","get","_Emitter","_Semaphore","_time","_withRetries"],"sources":["../../src/index.ts"],"sourcesContent":["export { default as Barrier } from './Barrier';\nexport * from './Cached';\nexport * from './Emitter';\nexport { default as Semaphore } from './Semaphore';\nexport * from './time';\nexport { default as withRetries } from './withRetries';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,QAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAF,OAAA,EAAAG,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAJ,OAAA,CAAAI,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAZ,OAAA,CAAAI,GAAA;IAAA;EAAA;AAAA;AACA,IAAAS,QAAA,GAAAd,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAW,QAAA,EAAAV,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAS,QAAA,CAAAT,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,QAAA,CAAAT,GAAA;IAAA;EAAA;AAAA;AACA,IAAAU,UAAA,GAAAhB,sBAAA,CAAAC,OAAA;AACA,IAAAgB,KAAA,GAAAhB,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAa,KAAA,EAAAZ,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAW,KAAA,CAAAX,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAG,KAAA,CAAAX,GAAA;IAAA;EAAA;AAAA;AACA,IAAAY,YAAA,GAAAlB,sBAAA,CAAAC,OAAA","ignoreList":[]}
+{"version":3,"file":"index.js","names":["_Barrier","_interopRequireDefault","require","_Cached","Object","keys","forEach","key","prototype","hasOwnProperty","call","_exportNames","exports","defineProperty","enumerable","get","_Emitter","_Semaphore","_time","_types","_withRetries"],"sources":["../../src/index.ts"],"sourcesContent":["export { default as Barrier } from './Barrier';\nexport * from './Cached';\nexport * from './Emitter';\nexport { default as Semaphore } from './Semaphore';\nexport * from './time';\nexport * from './types';\nexport { default as withRetries } from './withRetries';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,QAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAF,OAAA,EAAAG,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAJ,OAAA,CAAAI,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAZ,OAAA,CAAAI,GAAA;IAAA;EAAA;AAAA;AACA,IAAAS,QAAA,GAAAd,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAW,QAAA,EAAAV,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAS,QAAA,CAAAT,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,QAAA,CAAAT,GAAA;IAAA;EAAA;AAAA;AACA,IAAAU,UAAA,GAAAhB,sBAAA,CAAAC,OAAA;AACA,IAAAgB,KAAA,GAAAhB,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAa,KAAA,EAAAZ,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAW,KAAA,CAAAX,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAG,KAAA,CAAAX,GAAA;IAAA;EAAA;AAAA;AACA,IAAAY,MAAA,GAAAjB,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAc,MAAA,EAAAb,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAY,MAAA,CAAAZ,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAI,MAAA,CAAAZ,GAAA;IAAA;EAAA;AAAA;AACA,IAAAa,YAAA,GAAAnB,sBAAA,CAAAC,OAAA","ignoreList":[]}

package/build/common/types.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.assertEmptyObject = assertEmptyObject;
+// Misc TypeScript-specific utilities.
+
+/** The most permissive object key type. */
+
+/** Asserts given object is empty, both compile- and run-time. */
+function assertEmptyObject(object) {
+  if (Object.keys(object).length) throw Error('The object is not empty');
+}
+//# sourceMappingURL=types.js.map

package/build/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":["assertEmptyObject","object","Object","keys","length","Error"],"sources":["../../src/types.ts"],"sourcesContent":["// Misc TypeScript-specific utilities.\n\n/** The most permissive object key type. */\nexport type ObjectKey = string | number | symbol;\n\n/** Asserts given object is empty, both compile- and run-time. */\nexport function assertEmptyObject(object: Record<ObjectKey, never>): void {\n  if (Object.keys(object).length) throw Error('The object is not empty');\n}\n"],"mappings":";;;;;;AAAA;;AAEA;;AAGA;AACO,SAASA,iBAAiBA,CAACC,MAAgC,EAAQ;EACxE,IAAIC,MAAM,CAACC,IAAI,CAACF,MAAM,CAAC,CAACG,MAAM,EAAE,MAAMC,KAAK,CAAC,yBAAyB,CAAC;AACxE","ignoreList":[]}

package/build/module/Cached.js

@@ -10,17 +10,17 @@ function getTimestamp(e) {
   return Array.isArray(e) ? e[1] : e.timestamp;
 }
 export class Cached {
-  data = {};
-  oldestTimestamp = Number.MAX_SAFE_INTEGER;
+  pData = {};
+  pOldestTimestamp = Number.MAX_SAFE_INTEGER;
 
   /** For test use only. */
-  get _data() {
-    return this.data;
+  get data() {
+    return this.pData;
   }
 
   /** For test use only. */
-  get _oldestTimestamp() {
-    return this.oldestTimestamp;
+  get oldestTimestamp() {
+    return this.pOldestTimestamp;
   }
   constructor(maxage, getter) {
     this.maxage = maxage;
@@ -30,44 +30,56 @@ export class Cached {
   /** Removes stale items from the cache, and updates .oldestTimestamp. */
   cleanCache() {
     const deadline = Date.now() - this.maxage;
-    this.oldestTimestamp = Number.MAX_SAFE_INTEGER;
-    for (const [key, entry] of Object.entries(this.data)) {
+    this.pOldestTimestamp = Number.MAX_SAFE_INTEGER;
+    for (const [key, entry] of Object.entries(this.pData)) {
       const timestamp = getTimestamp(entry);
-      if (timestamp < deadline) delete this.data[key];else if (timestamp < this.oldestTimestamp) {
-        this.oldestTimestamp = timestamp;
+      if (timestamp < deadline) delete this.pData[key];else if (timestamp < this.pOldestTimestamp) {
+        this.pOldestTimestamp = timestamp;
       }
     }
   }
 
+  /**
+   * Adds entry to the cache.
+   * NOTE: It assumes entry's timestamp is the current moment (for the cache
+   * cleaning purposes; if it is not, but it is a past timestamp, nothing bad
+   * will happen, just some cleaning operation will be skipped).
+   */
+  setEntry(id, entry) {
+    this.pData[id] = entry;
+    const timestamp = getTimestamp(entry);
+    if (timestamp < this.pOldestTimestamp) this.pOldestTimestamp = timestamp;else if (this.pOldestTimestamp < timestamp - this.maxage) this.cleanCache();
+  }
+
   /** Adds `datum` to the cache, and removes stale items from the cache. */
   set(id, datum) {
-    const now = Date.now();
-    if (this.oldestTimestamp < now - this.maxage) this.cleanCache();
-    if (now < this.oldestTimestamp) this.oldestTimestamp = now;
-    const res = [datum, now];
-    this.data[id] = res;
+    const res = [datum, Date.now()];
+    this.setEntry(id, res);
     return res;
   }
 
-  /** Retrieves envelope of the specified datum, either read from the cache,
-   *  or retrieved using the getter provided at construction time. */
-  getEntry(id) {
+  /**
+   * Retrieves envelope of the specified datum, either read from the cache,
+   * or retrieved using the getter provided at construction time.
+   */
+  getEntry(id, forceRefresh) {
     const now = Date.now();
-    let cached = this.data[id];
-    if (cached && getTimestamp(cached) >= now - this.maxage) return cached;
+    if (!forceRefresh) {
+      const cached = this.pData[id];
+      if (cached && getTimestamp(cached) >= now - this.maxage) return cached;
+    }
     const itemOrPromise = this.getter(id);
     if (!(itemOrPromise instanceof Promise)) {
       return this.set(id, itemOrPromise);
     }
-    cached = addTimestamp(itemOrPromise.then(item => this.set(id, item)), now);
-    if (now < this.oldestTimestamp) this.oldestTimestamp = now;
-    this.data[id] = cached;
-    return cached;
+    const promise = addTimestamp(itemOrPromise.then(item => this.set(id, item)), now);
+    this.setEntry(id, promise);
+    return promise;
   }
 
   /** Gets item. */
-  get(id) {
-    const entry = this.getEntry(id);
+  get(id, forceRefresh) {
+    const entry = this.getEntry(id, forceRefresh);
     return Array.isArray(entry) ? entry[0] : entry.then(e => e[0]);
   }
 }

package/build/module/Cached.js.map

@@ -1 +1 @@
-{"version":3,"file":"Cached.js","names":["addTimestamp","promise","timestamp","res","getTimestamp","e","Array","isArray","Cached","data","oldestTimestamp","Number","MAX_SAFE_INTEGER","_data","_oldestTimestamp","constructor","maxage","getter","cleanCache","deadline","Date","now","key","entry","Object","entries","set","id","datum","getEntry","cached","itemOrPromise","Promise","then","item","get"],"sources":["../../src/Cached.ts"],"sourcesContent":["type CachedT<T> = [T, number];\ntype TimestampedPromise<T> = Promise<T> & { timestamp: number };\ntype EntryT<T> = CachedT<T> | TimestampedPromise<CachedT<T>>;\n\n/** Adds timestamp to the promise. */\nfunction addTimestamp<T>(\n  promise: Promise<T>,\n  timestamp: number,\n): TimestampedPromise<T> {\n  const res = promise as TimestampedPromise<T>;\n  res.timestamp = timestamp;\n  return res;\n}\n\n/** Gets entry timestamp. */\nfunction getTimestamp<T>(e: EntryT<T>): number {\n  return Array.isArray(e) ? e[1] : e.timestamp;\n}\n\nexport class Cached<T> {\n  private data: Record<string, EntryT<T>> = {};\n  private oldestTimestamp = Number.MAX_SAFE_INTEGER;\n\n  /** For test use only. */\n  get _data(): Readonly<Record<string, EntryT<T>>> {\n    return this.data;\n  }\n\n  /** For test use only. */\n  get _oldestTimestamp(): number {\n    return this.oldestTimestamp;\n  }\n\n  constructor(\n    public readonly maxage: number,\n    private getter: (id: string) => T | Promise<T>,\n  ) {}\n\n  /** Removes stale items from the cache, and updates .oldestTimestamp. */\n  private cleanCache() {\n    const deadline = Date.now() - this.maxage;\n    this.oldestTimestamp = Number.MAX_SAFE_INTEGER;\n    for (const [key, entry] of Object.entries(this.data)) {\n      const timestamp = getTimestamp(entry);\n      if (timestamp < deadline) delete this.data[key];\n      else if (timestamp < this.oldestTimestamp) {\n        this.oldestTimestamp = timestamp;\n      }\n    }\n  }\n\n  /** Adds `datum` to the cache, and removes stale items from the cache. */\n  private set(id: string, datum: T): CachedT<T> {\n    const now = Date.now();\n    if (this.oldestTimestamp < now - this.maxage) this.cleanCache();\n    if (now < this.oldestTimestamp) this.oldestTimestamp = now;\n    const res: CachedT<T> = [datum, now];\n    this.data[id] = res;\n    return res;\n  }\n\n  /** Retrieves envelope of the specified datum, either read from the cache,\n   *  or retrieved using the getter provided at construction time. */\n  private getEntry(id: string): EntryT<T> {\n    const now = Date.now();\n\n    let cached = this.data[id];\n    if (cached && getTimestamp(cached) >= now - this.maxage) return cached;\n\n    const itemOrPromise = this.getter(id);\n    if (!(itemOrPromise instanceof Promise)) {\n      return this.set(id, itemOrPromise);\n    }\n\n    cached = addTimestamp(\n      itemOrPromise.then((item) => this.set(id, item)),\n      now,\n    );\n    if (now < this.oldestTimestamp) this.oldestTimestamp = now;\n    this.data[id] = cached;\n    return cached;\n  }\n\n  /** Gets item. */\n  get(id: string): T | Promise<T> {\n    const entry = this.getEntry(id);\n    return Array.isArray(entry) ? entry[0] : entry.then((e) => e[0]);\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Cached.js","names":["addTimestamp","promise","timestamp","res","getTimestamp","e","Array","isArray","Cached","pData","pOldestTimestamp","Number","MAX_SAFE_INTEGER","data","oldestTimestamp","constructor","maxage","getter","cleanCache","deadline","Date","now","key","entry","Object","entries","setEntry","id","set","datum","getEntry","forceRefresh","cached","itemOrPromise","Promise","then","item","get"],"sources":["../../src/Cached.ts"],"sourcesContent":["type CachedT<T> = [T, number];\ntype TimestampedPromise<T> = Promise<T> & { timestamp: number };\ntype EntryT<T> = CachedT<T> | TimestampedPromise<CachedT<T>>;\n\n/** Adds timestamp to the promise. */\nfunction addTimestamp<T>(\n  promise: Promise<T>,\n  timestamp: number,\n): TimestampedPromise<T> {\n  const res = promise as TimestampedPromise<T>;\n  res.timestamp = timestamp;\n  return res;\n}\n\n/** Gets entry timestamp. */\nfunction getTimestamp<T>(e: EntryT<T>): number {\n  return Array.isArray(e) ? e[1] : e.timestamp;\n}\n\nexport class Cached<T> {\n  private pData: Record<string, EntryT<T>> = {};\n  private pOldestTimestamp = Number.MAX_SAFE_INTEGER;\n\n  /** For test use only. */\n  get data(): Readonly<Record<string, EntryT<T>>> {\n    return this.pData;\n  }\n\n  /** For test use only. */\n  get oldestTimestamp(): number {\n    return this.pOldestTimestamp;\n  }\n\n  constructor(\n    public readonly maxage: number,\n    private getter: (id: string) => T | Promise<T>,\n  ) {}\n\n  /** Removes stale items from the cache, and updates .oldestTimestamp. */\n  private cleanCache() {\n    const deadline = Date.now() - this.maxage;\n    this.pOldestTimestamp = Number.MAX_SAFE_INTEGER;\n    for (const [key, entry] of Object.entries(this.pData)) {\n      const timestamp = getTimestamp(entry);\n      if (timestamp < deadline) delete this.pData[key];\n      else if (timestamp < this.pOldestTimestamp) {\n        this.pOldestTimestamp = timestamp;\n      }\n    }\n  }\n\n  /**\n   * Adds entry to the cache.\n   * NOTE: It assumes entry's timestamp is the current moment (for the cache\n   * cleaning purposes; if it is not, but it is a past timestamp, nothing bad\n   * will happen, just some cleaning operation will be skipped).\n   */\n  private setEntry(id: string, entry: EntryT<T>) {\n    this.pData[id] = entry;\n    const timestamp = getTimestamp(entry);\n    if (timestamp < this.pOldestTimestamp) this.pOldestTimestamp = timestamp;\n    else if (this.pOldestTimestamp < timestamp - this.maxage) this.cleanCache();\n  }\n\n  /** Adds `datum` to the cache, and removes stale items from the cache. */\n  private set(id: string, datum: T): CachedT<T> {\n    const res: CachedT<T> = [datum, Date.now()];\n    this.setEntry(id, res);\n    return res;\n  }\n\n  /**\n   * Retrieves envelope of the specified datum, either read from the cache,\n   * or retrieved using the getter provided at construction time.\n   */\n  private getEntry(id: string, forceRefresh?: boolean): EntryT<T> {\n    const now = Date.now();\n\n    if (!forceRefresh) {\n      const cached = this.pData[id];\n      if (cached && getTimestamp(cached) >= now - this.maxage) return cached;\n    }\n\n    const itemOrPromise = this.getter(id);\n    if (!(itemOrPromise instanceof Promise)) {\n      return this.set(id, itemOrPromise);\n    }\n\n    const promise = addTimestamp(\n      itemOrPromise.then((item) => this.set(id, item)),\n      now,\n    );\n\n    this.setEntry(id, promise);\n\n    return promise;\n  }\n\n  /** Gets item. */\n  get(id: string, forceRefresh?: boolean): T | Promise<T> {\n    const entry = this.getEntry(id, forceRefresh);\n    return Array.isArray(entry) ? entry[0] : entry.then((e) => e[0]);\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/module/index.js

@@ -3,5 +3,6 @@ export * from './Cached';
 export * from './Emitter';
 export { default as Semaphore } from './Semaphore';
 export * from './time';
+export * from './types';
 export { default as withRetries } from './withRetries';
 //# sourceMappingURL=index.js.map

package/build/module/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["default","Barrier","Semaphore","withRetries"],"sources":["../../src/index.ts"],"sourcesContent":["export { default as Barrier } from './Barrier';\nexport * from './Cached';\nexport * from './Emitter';\nexport { default as Semaphore } from './Semaphore';\nexport * from './time';\nexport { default as withRetries } from './withRetries';\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,OAAO,QAAQ,WAAW;AAC9C,cAAc,UAAU;AACxB,cAAc,WAAW;AACzB,SAASD,OAAO,IAAIE,SAAS,QAAQ,aAAa;AAClD,cAAc,QAAQ;AACtB,SAASF,OAAO,IAAIG,WAAW,QAAQ,eAAe","ignoreList":[]}
+{"version":3,"file":"index.js","names":["default","Barrier","Semaphore","withRetries"],"sources":["../../src/index.ts"],"sourcesContent":["export { default as Barrier } from './Barrier';\nexport * from './Cached';\nexport * from './Emitter';\nexport { default as Semaphore } from './Semaphore';\nexport * from './time';\nexport * from './types';\nexport { default as withRetries } from './withRetries';\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,OAAO,QAAQ,WAAW;AAC9C,cAAc,UAAU;AACxB,cAAc,WAAW;AACzB,SAASD,OAAO,IAAIE,SAAS,QAAQ,aAAa;AAClD,cAAc,QAAQ;AACtB,cAAc,SAAS;AACvB,SAASF,OAAO,IAAIG,WAAW,QAAQ,eAAe","ignoreList":[]}

package/build/module/types.js

@@ -0,0 +1,9 @@
+// Misc TypeScript-specific utilities.
+
+/** The most permissive object key type. */
+
+/** Asserts given object is empty, both compile- and run-time. */
+export function assertEmptyObject(object) {
+  if (Object.keys(object).length) throw Error('The object is not empty');
+}
+//# sourceMappingURL=types.js.map

package/build/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":["assertEmptyObject","object","Object","keys","length","Error"],"sources":["../../src/types.ts"],"sourcesContent":["// Misc TypeScript-specific utilities.\n\n/** The most permissive object key type. */\nexport type ObjectKey = string | number | symbol;\n\n/** Asserts given object is empty, both compile- and run-time. */\nexport function assertEmptyObject(object: Record<ObjectKey, never>): void {\n  if (Object.keys(object).length) throw Error('The object is not empty');\n}\n"],"mappings":"AAAA;;AAEA;;AAGA;AACA,OAAO,SAASA,iBAAiBA,CAACC,MAAgC,EAAQ;EACxE,IAAIC,MAAM,CAACC,IAAI,CAACF,MAAM,CAAC,CAACG,MAAM,EAAE,MAAMC,KAAK,CAAC,yBAAyB,CAAC;AACxE","ignoreList":[]}

package/build/types/Cached.d.ts

@@ -6,21 +6,30 @@ type EntryT<T> = CachedT<T> | TimestampedPromise<CachedT<T>>;
 export declare class Cached<T> {
     readonly maxage: number;
     private getter;
-    private data;
-    private oldestTimestamp;
+    private pData;
+    private pOldestTimestamp;
     /** For test use only. */
-    get _data(): Readonly<Record<string, EntryT<T>>>;
+    get data(): Readonly<Record<string, EntryT<T>>>;
     /** For test use only. */
-    get _oldestTimestamp(): number;
+    get oldestTimestamp(): number;
     constructor(maxage: number, getter: (id: string) => T | Promise<T>);
     /** Removes stale items from the cache, and updates .oldestTimestamp. */
     private cleanCache;
+    /**
+     * Adds entry to the cache.
+     * NOTE: It assumes entry's timestamp is the current moment (for the cache
+     * cleaning purposes; if it is not, but it is a past timestamp, nothing bad
+     * will happen, just some cleaning operation will be skipped).
+     */
+    private setEntry;
     /** Adds `datum` to the cache, and removes stale items from the cache. */
     private set;
-    /** Retrieves envelope of the specified datum, either read from the cache,
-     *  or retrieved using the getter provided at construction time. */
+    /**
+     * Retrieves envelope of the specified datum, either read from the cache,
+     * or retrieved using the getter provided at construction time.
+     */
     private getEntry;
     /** Gets item. */
-    get(id: string): T | Promise<T>;
+    get(id: string, forceRefresh?: boolean): T | Promise<T>;
 }
 export {};

package/build/types/index.d.ts

@@ -3,4 +3,5 @@ export * from './Cached';
 export * from './Emitter';
 export { default as Semaphore } from './Semaphore';
 export * from './time';
+export * from './types';
 export { default as withRetries } from './withRetries';

package/build/types/types.d.ts

@@ -0,0 +1,4 @@
+/** The most permissive object key type. */
+export type ObjectKey = string | number | symbol;
+/** Asserts given object is empty, both compile- and run-time. */
+export declare function assertEmptyObject(object: Record<ObjectKey, never>): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dr.pogodin/js-utils",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Collection of JavaScript (TypeScript) utilities.",
   "main": "./build/module/index.js",
   "module": "./build/module/index.js",
@@ -43,11 +43,11 @@
     "@babel/plugin-transform-runtime": "^7.28.0",
     "@babel/preset-env": "^7.28.0",
     "@babel/preset-typescript": "^7.27.1",
-    "@dr.pogodin/eslint-configs": "^0.0.8",
+    "@dr.pogodin/eslint-configs": "^0.0.9",
     "@tsconfig/recommended": "^1.0.10",
     "@types/jest": "^30.0.0",
-    "babel-jest": "^30.0.4",
-    "jest": "^30.0.4",
+    "babel-jest": "^30.0.5",
+    "jest": "^30.0.5",
     "mockdate": "^3.0.5",
     "rimraf": "^6.0.1",
     "tstyche": "^4.3.0",