@choksheak/ts-utils 0.3.4 → 0.3.5

package/README.md

@@ -1,8 +1,14 @@
 # @choksheak/ts-utils
 
-This package is a random bunch of Typescript utilities that I have needed in almost every project that I have worked in. Hence making an easy way to share this code and also for my own personal and professional use. Feel free to use it in your own projects without any restrictions.
-
-The code supports full tree-shaking. Therefore your code will only grow in size by whatever you use. Any code that you are not using will not contribute to your code size.
+This package is a time-tested collection of Typescript utilities that I have
+personally needed in almost every project that I have worked in. Making this an
+open source, public npm package allows me to share this code freely with others
+as well as using it for my own personal and professional projects. Feel free to
+use it in your own projects without any restrictions.
+
+The code supports full tree-shaking. Therefore your code will only grow in size
+by whatever you use. Any code that you are not using will not contribute to
+your code size.
 
 Source code: https://github.com/choksheak/ts-utils
 

package/asNumber.cjs

@@ -23,15 +23,15 @@ __export(asNumber_exports, {
   asNumber: () => asNumber
 });
 module.exports = __toCommonJS(asNumber_exports);
-function asNumber(u) {
+function asNumber(u, defaultValue = 0) {
   if (typeof u === "number") {
-    return isFinite(u) ? u : 0;
+    return isFinite(u) ? u : defaultValue;
   }
   u = Number(u);
   if (typeof u === "number" && isFinite(u)) {
     return u;
   }
-  return 0;
+  return defaultValue;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/asNumber.d.mts

@@ -1,6 +1,6 @@
 /**
  * Coerce `u` into a number if possible, otherwise just return 0.
  */
-declare function asNumber(u: unknown): number;
+declare function asNumber(u: unknown, defaultValue?: number): number;
 
 export { asNumber };

package/asNumber.d.ts

@@ -1,6 +1,6 @@
 /**
  * Coerce `u` into a number if possible, otherwise just return 0.
  */
-declare function asNumber(u: unknown): number;
+declare function asNumber(u: unknown, defaultValue?: number): number;
 
 export { asNumber };

package/asNumber.min.cjs

@@ -1,2 +1,2 @@
-"use strict";var t=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var o=Object.prototype.hasOwnProperty;var p=(e,n)=>{for(var i in n)t(e,i,{get:n[i],enumerable:!0})},s=(e,n,i,b)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of m(n))!o.call(e,r)&&r!==i&&t(e,r,{get:()=>n[r],enumerable:!(b=f(n,r))||b.enumerable});return e};var u=e=>s(t({},"__esModule",{value:!0}),e);var F={};p(F,{asNumber:()=>y});module.exports=u(F);function y(e){return typeof e=="number"?isFinite(e)?e:0:(e=Number(e),typeof e=="number"&&isFinite(e)?e:0)}0&&(module.exports={asNumber});
+"use strict";var t=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var o=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var p=(n,r)=>{for(var i in r)t(n,i,{get:r[i],enumerable:!0})},s=(n,r,i,b)=>{if(r&&typeof r=="object"||typeof r=="function")for(let e of o(r))!f.call(n,e)&&e!==i&&t(n,e,{get:()=>r[e],enumerable:!(b=m(r,e))||b.enumerable});return n};var y=n=>s(t({},"__esModule",{value:!0}),n);var N={};p(N,{asNumber:()=>F});module.exports=y(N);function F(n,r=0){return typeof n=="number"?isFinite(n)?n:r:(n=Number(n),typeof n=="number"&&isFinite(n)?n:r)}0&&(module.exports={asNumber});
 //# sourceMappingURL=asNumber.min.cjs.map

package/asNumber.min.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/asNumber.ts"],"sourcesContent":["/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : 0;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return 0 for everything else. This is usually ok if want to just ignore\n  // all other noise.\n  return 0;\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,cAAAE,IAAA,eAAAC,EAAAH,GAGO,SAASE,EAASE,EAAoB,CAE3C,OAAI,OAAOA,GAAM,SACR,SAASA,CAAC,EAAIA,EAAI,GAI3BA,EAAI,OAAOA,CAAC,EAGR,OAAOA,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKF,EACT","names":["asNumber_exports","__export","asNumber","__toCommonJS","u"]}
+{"version":3,"sources":["../src/asNumber.ts"],"sourcesContent":["/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown, defaultValue = 0): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : defaultValue;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return `defaultValue` for everything else. This is usually ok if want to\n  // just ignore all other noise.\n  return defaultValue;\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,cAAAE,IAAA,eAAAC,EAAAH,GAGO,SAASE,EAASE,EAAYC,EAAe,EAAW,CAE7D,OAAI,OAAOD,GAAM,SACR,SAASA,CAAC,EAAIA,EAAIC,GAI3BD,EAAI,OAAOA,CAAC,EAGR,OAAOA,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKFC,EACT","names":["asNumber_exports","__export","asNumber","__toCommonJS","u","defaultValue"]}

package/asNumber.min.mjs

@@ -1,2 +1,2 @@
-function n(e){return typeof e=="number"?isFinite(e)?e:0:(e=Number(e),typeof e=="number"&&isFinite(e)?e:0)}export{n as asNumber};
+function e(n,r=0){return typeof n=="number"?isFinite(n)?n:r:(n=Number(n),typeof n=="number"&&isFinite(n)?n:r)}export{e as asNumber};
 //# sourceMappingURL=asNumber.min.mjs.map

package/asNumber.min.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/asNumber.ts"],"sourcesContent":["/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : 0;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return 0 for everything else. This is usually ok if want to just ignore\n  // all other noise.\n  return 0;\n}\n"],"mappings":"AAGO,SAASA,EAASC,EAAoB,CAE3C,OAAI,OAAOA,GAAM,SACR,SAASA,CAAC,EAAIA,EAAI,GAI3BA,EAAI,OAAOA,CAAC,EAGR,OAAOA,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKF,EACT","names":["asNumber","u"]}
+{"version":3,"sources":["../src/asNumber.ts"],"sourcesContent":["/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown, defaultValue = 0): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : defaultValue;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return `defaultValue` for everything else. This is usually ok if want to\n  // just ignore all other noise.\n  return defaultValue;\n}\n"],"mappings":"AAGO,SAASA,EAASC,EAAYC,EAAe,EAAW,CAE7D,OAAI,OAAOD,GAAM,SACR,SAASA,CAAC,EAAIA,EAAIC,GAI3BD,EAAI,OAAOA,CAAC,EAGR,OAAOA,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKFC,EACT","names":["asNumber","u","defaultValue"]}

package/asNumber.mjs

@@ -1,13 +1,13 @@
 // src/asNumber.ts
-function asNumber(u) {
+function asNumber(u, defaultValue = 0) {
   if (typeof u === "number") {
-    return isFinite(u) ? u : 0;
+    return isFinite(u) ? u : defaultValue;
   }
   u = Number(u);
   if (typeof u === "number" && isFinite(u)) {
     return u;
   }
-  return 0;
+  return defaultValue;
 }
 export {
   asNumber

package/kvStore.cjs

@@ -20,10 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/kvStore.ts
 var kvStore_exports = {};
 __export(kvStore_exports, {
-  KvStore: () => KvStore,
   KvStoreConfig: () => KvStoreConfig,
-  KvStoreItem: () => KvStoreItem,
   configureKvStore: () => configureKvStore,
+  createKvStore: () => createKvStore,
   kvStore: () => kvStore,
   kvStoreItem: () => kvStoreItem
 });
@@ -85,33 +84,20 @@ function withOnError(request, reject) {
   };
   return request;
 }
-var KvStore = class {
-  constructor(dbName, options) {
-    this.dbName = dbName;
-    this.dbVersion = options?.dbVersion ?? KvStoreConfig.dbVersion;
-    this.storeName = options?.storeName ?? KvStoreConfig.storeName;
-    this.defaultExpiryMs = options?.defaultExpiryMs ? durationOrMsToMs(options.defaultExpiryMs) : KvStoreConfig.expiryMs;
-    this.gcIntervalMs = options?.gcIntervalMs ? durationOrMsToMs(options.gcIntervalMs) : KvStoreConfig.gcIntervalMs;
-    this.gcMsStorageKey = `__kvStore:lastGcMs:${dbName}:v${this.dbVersion}:${this.storeName}`;
-  }
-  /** We'll init the DB only on first use. */
-  db;
-  /** Local storage key name for the last GC completed timestamp. */
-  gcMsStorageKey;
-  dbVersion;
-  storeName;
-  defaultExpiryMs;
-  gcIntervalMs;
-  async getOrCreateDb() {
-    if (!this.db) {
-      this.db = await new Promise((resolve, reject) => {
-        const request = withOnError(
-          globalThis.indexedDB.open(this.dbName, this.dbVersion),
-          reject
-        );
+function createKvStore(dbName, options) {
+  let db;
+  const dbVersion = options?.dbVersion ?? KvStoreConfig.dbVersion;
+  const storeName = options?.storeName ?? KvStoreConfig.storeName;
+  const defaultExpiryMs = options?.defaultExpiryMs ? durationOrMsToMs(options.defaultExpiryMs) : KvStoreConfig.expiryMs;
+  const gcIntervalMs = options?.gcIntervalMs ? durationOrMsToMs(options.gcIntervalMs) : KvStoreConfig.gcIntervalMs;
+  const gcMsStorageKey = `__kvStore:lastGcMs:${dbName}:v${dbVersion}:${storeName}`;
+  async function getOrCreateDb() {
+    if (!db) {
+      db = await new Promise((resolve, reject) => {
+        const request = withOnError(indexedDB.open(dbName, dbVersion), reject);
         request.onupgradeneeded = (event) => {
-          const db = event.target.result;
-          const objectStore = db.createObjectStore(this.storeName, {
+          const db2 = event.target.result;
+          const objectStore = db2.createObjectStore(storeName, {
             keyPath: "key"
           });
           objectStore.createIndex("key", "key", {
@@ -119,248 +105,253 @@ var KvStore = class {
           });
         };
         request.onsuccess = (event) => {
-          const db = event.target.result;
-          resolve(db);
+          const db2 = event.target.result;
+          resolve(db2);
         };
       });
     }
-    return this.db;
+    return db;
   }
-  async transact(mode, callback) {
-    const db = await this.getOrCreateDb();
+  async function transact(mode, callback) {
+    const db2 = await getOrCreateDb();
     return await new Promise((resolve, reject) => {
-      const transaction = withOnError(
-        db.transaction(this.storeName, mode),
-        reject
-      );
+      const transaction = withOnError(db2.transaction(storeName, mode), reject);
       transaction.onabort = (event) => {
         reject(event);
       };
-      const objectStore = transaction.objectStore(this.storeName);
+      const objectStore = transaction.objectStore(storeName);
       callback(objectStore, resolve, reject);
     });
   }
-  /** Set a value in the store. */
-  async set(key, value, expiryDeltaMs = this.defaultExpiryMs) {
-    const nowMs = Date.now();
-    const obj = {
-      key,
-      value,
-      storedMs: nowMs,
-      expiryMs: nowMs + durationOrMsToMs(expiryDeltaMs)
-    };
-    return await this.transact(
-      "readwrite",
-      (objectStore, resolve, reject) => {
-        const request = withOnError(objectStore.put(obj), reject);
+  const obj = {
+    /** Input name for the DB. */
+    dbName,
+    /** Input version for the DB. */
+    dbVersion,
+    /** Input name for the DB store. */
+    storeName,
+    /** Default expiry to use if not specified in set(). */
+    defaultExpiryMs,
+    /** Time interval for when GC's occur. */
+    gcIntervalMs,
+    /** Local storage key name for the last GC completed timestamp. */
+    gcMsStorageKey,
+    /** Set a value in the store. */
+    async set(key, value, expiryDeltaMs) {
+      const nowMs = Date.now();
+      const stored = {
+        key,
+        value,
+        storedMs: nowMs,
+        expiryMs: nowMs + durationOrMsToMs(expiryDeltaMs ?? defaultExpiryMs)
+      };
+      return await transact("readwrite", (objectStore, resolve, reject) => {
+        const request = withOnError(objectStore.put(stored), reject);
         request.onsuccess = () => {
           resolve(value);
-          this.gc();
-        };
-      }
-    );
-  }
-  /** Delete one or multiple keys. */
-  async delete(key) {
-    return await this.transact(
-      "readwrite",
-      (objectStore, resolve, reject) => {
-        objectStore.transaction.oncomplete = () => {
-          resolve();
+          obj.gc();
         };
-        if (typeof key === "string") {
-          withOnError(objectStore.delete(key), reject);
-        } else {
-          for (const k of key) {
-            withOnError(objectStore.delete(k), reject);
+      });
+    },
+    /** Delete one or multiple keys. */
+    async delete(key) {
+      return await transact(
+        "readwrite",
+        (objectStore, resolve, reject) => {
+          objectStore.transaction.oncomplete = () => {
+            resolve();
+          };
+          if (typeof key === "string") {
+            withOnError(objectStore.delete(key), reject);
+          } else {
+            for (const k of key) {
+              withOnError(objectStore.delete(k), reject);
+            }
           }
         }
+      );
+    },
+    /** Mainly used to get the expiration timestamp of an object. */
+    async getStoredObject(key) {
+      const stored = await transact(
+        "readonly",
+        (objectStore, resolve, reject) => {
+          const request = withOnError(objectStore.get(key), reject);
+          request.onsuccess = () => {
+            resolve(request.result);
+          };
+        }
+      );
+      if (!stored) {
+        return void 0;
       }
-    );
-  }
-  /** Mainly used to get the expiration timestamp of an object. */
-  async getStoredObject(key) {
-    const stored = await this.transact(
-      "readonly",
-      (objectStore, resolve, reject) => {
-        const request = withOnError(objectStore.get(key), reject);
-        request.onsuccess = () => {
-          resolve(request.result);
-        };
-      }
-    );
-    if (!stored) {
-      return void 0;
-    }
-    try {
-      const obj = validateStoredObject(stored);
-      if (!obj) {
-        await this.delete(key);
-        this.gc();
+      try {
+        const valid = validateStoredObject(stored);
+        if (!valid) {
+          await obj.delete(key);
+          obj.gc();
+          return void 0;
+        }
+        return valid;
+      } catch (e) {
+        console.error(`Invalid kv value: ${key}=${JSON.stringify(stored)}:`, e);
+        await obj.delete(key);
+        obj.gc();
         return void 0;
       }
-      return obj;
-    } catch (e) {
-      console.error(`Invalid kv value: ${key}=${JSON.stringify(stored)}:`, e);
-      await this.delete(key);
-      this.gc();
-      return void 0;
-    }
-  }
-  /** Get a value by key, or undefined if it does not exist. */
-  async get(key) {
-    const obj = await this.getStoredObject(key);
-    return obj?.value;
-  }
-  /** Generic way to iterate through all entries. */
-  async forEach(callback) {
-    await this.transact("readonly", (objectStore, resolve, reject) => {
-      const request = withOnError(objectStore.openCursor(), reject);
-      request.onsuccess = async (event) => {
-        const cursor = event.target.result;
-        if (cursor) {
-          if (cursor.key) {
-            const obj = validateStoredObject(cursor.value);
-            if (obj !== void 0) {
-              await callback(
-                String(cursor.key),
-                obj.value,
-                obj.expiryMs,
-                obj.storedMs
-              );
+    },
+    /** Get a value by key, or undefined if it does not exist. */
+    async get(key) {
+      const stored = await obj.getStoredObject(key);
+      return stored?.value;
+    },
+    /** Generic way to iterate through all entries. */
+    async forEach(callback) {
+      await transact("readonly", (objectStore, resolve, reject) => {
+        const request = withOnError(objectStore.openCursor(), reject);
+        request.onsuccess = async (event) => {
+          const cursor = event.target.result;
+          if (cursor) {
+            if (cursor.key) {
+              const valid = validateStoredObject(cursor.value);
+              if (valid !== void 0) {
+                await callback(
+                  String(cursor.key),
+                  valid.value,
+                  valid.expiryMs,
+                  valid.storedMs
+                );
+              }
             }
+            cursor.continue();
+          } else {
+            resolve();
           }
-          cursor.continue();
-        } else {
+        };
+      });
+    },
+    /**
+     * Returns the number of items in the store. Note that getting the size
+     * requires iterating through the entire store because the items could expire
+     * at any time, and hence the size is a dynamic number.
+     */
+    async size() {
+      let count = 0;
+      await obj.forEach(() => {
+        count++;
+      });
+      return count;
+    },
+    /** Remove all items from the store. */
+    async clear() {
+      await transact("readwrite", (objectStore, resolve, reject) => {
+        const request = withOnError(objectStore.clear(), reject);
+        request.onsuccess = () => {
           resolve();
+        };
+      });
+    },
+    /**
+     * Returns all items as map of key to value, mainly used for debugging dumps.
+     * The type T is applied to all values, even though they might not be of type
+     * T (in the case when you store different data types in the same store).
+     */
+    async asMap() {
+      const map = /* @__PURE__ */ new Map();
+      await obj.forEach((key, value, expiryMs, storedMs) => {
+        map.set(key, { value, expiryMs, storedMs });
+      });
+      return map;
+    },
+    /** Returns the ms timestamp for the last GC (garbage collection). */
+    getLastGcMs() {
+      const lastGcMsStr = localStorage.getItem(gcMsStorageKey);
+      if (!lastGcMsStr) return 0;
+      const ms = Number(lastGcMsStr);
+      return isNaN(ms) ? 0 : ms;
+    },
+    /** Set the ms timestamp for the last GC (garbage collection). */
+    setLastGcMs(ms) {
+      localStorage.setItem(gcMsStorageKey, String(ms));
+    },
+    /** Perform garbage-collection if due, else do nothing. */
+    async gc() {
+      const lastGcMs = obj.getLastGcMs();
+      if (!lastGcMs) {
+        obj.setLastGcMs(Date.now());
+        return;
+      }
+      if (Date.now() < lastGcMs + gcIntervalMs) {
+        return;
+      }
+      await obj.gcNow();
+    },
+    /**
+     * Perform garbage collection immediately without checking whether we are
+     * due for the next GC or not.
+     */
+    async gcNow() {
+      console.log(`Starting kvStore GC on ${dbName} v${dbVersion}...`);
+      obj.setLastGcMs(Date.now());
+      const keysToDelete = [];
+      await obj.forEach(
+        async (key, value, expiryMs) => {
+          if (value === void 0 || Date.now() >= expiryMs) {
+            keysToDelete.push(key);
+          }
         }
-      };
-    });
-  }
-  /**
-   * Returns the number of items in the store. Note that getting the size
-   * requires iterating through the entire store because the items could expire
-   * at any time, and hence the size is a dynamic number.
-   */
-  async size() {
-    let count = 0;
-    await this.forEach(() => {
-      count++;
-    });
-    return count;
-  }
-  /** Remove all items from the store. */
-  async clear() {
-    await this.transact("readwrite", (objectStore, resolve, reject) => {
-      const request = withOnError(objectStore.clear(), reject);
-      request.onsuccess = () => {
-        resolve();
-      };
-    });
-  }
-  /**
-   * Returns all items as map of key to value, mainly used for debugging dumps.
-   * The type T is applied to all values, even though they might not be of type
-   * T (in the case when you store different data types in the same store).
-   */
-  async asMap() {
-    const map = /* @__PURE__ */ new Map();
-    await this.forEach((key, value, expiryMs, storedMs) => {
-      map.set(key, { value, expiryMs, storedMs });
-    });
-    return map;
-  }
-  /** Returns the ms timestamp for the last GC (garbage collection). */
-  get lastGcMs() {
-    const lastGcMsStr = globalThis.localStorage.getItem(this.gcMsStorageKey);
-    if (!lastGcMsStr) return 0;
-    const ms = Number(lastGcMsStr);
-    return isNaN(ms) ? 0 : ms;
-  }
-  /** Set the ms timestamp for the last GC (garbage collection). */
-  set lastGcMs(ms) {
-    globalThis.localStorage.setItem(this.gcMsStorageKey, String(ms));
-  }
-  /** Perform garbage-collection if due, else do nothing. */
-  async gc() {
-    const lastGcMs = this.lastGcMs;
-    if (!lastGcMs) {
-      this.lastGcMs = Date.now();
-      return;
-    }
-    if (Date.now() < lastGcMs + this.gcIntervalMs) {
-      return;
-    }
-    await this.gcNow();
-  }
-  /**
-   * Perform garbage collection immediately without checking whether we are
-   * due for the next GC or not.
-   */
-  async gcNow() {
-    console.log(`Starting kvStore GC on ${this.dbName} v${this.dbVersion}...`);
-    this.lastGcMs = Date.now();
-    const keysToDelete = [];
-    await this.forEach(
-      async (key, value, expiryMs) => {
-        if (value === void 0 || Date.now() >= expiryMs) {
-          keysToDelete.push(key);
-        }
+      );
+      if (keysToDelete.length) {
+        await obj.delete(keysToDelete);
       }
-    );
-    if (keysToDelete.length) {
-      await this.delete(keysToDelete);
+      console.log(
+        `Finished kvStore GC on ${dbName} v${dbVersion} - deleted ${keysToDelete.length} keys`
+      );
+      obj.setLastGcMs(Date.now());
+    },
+    /** Returns `this` casted into a StorageAdapter<T>. */
+    asStorageAdapter() {
+      return obj;
     }
-    console.log(
-      `Finished kvStore GC on ${this.dbName} v${this.dbVersion} - deleted ${keysToDelete.length} keys`
-    );
-    this.lastGcMs = Date.now();
-  }
-  /** Returns `this` casted into a StorageAdapter<T>. */
-  asStorageAdapter() {
-    return this;
-  }
-};
-var kvStore = new KvStore(KvStoreConfig.dbName);
-var KvStoreItem = class {
-  constructor(key, defaultExpiryMs = KvStoreConfig.expiryMs, store = kvStore) {
-    this.key = key;
-    this.store = store;
-    this.defaultExpiryMs = defaultExpiryMs && durationOrMsToMs(defaultExpiryMs);
-  }
-  defaultExpiryMs;
-  /** Set a value in the store. */
-  async set(value, expiryDeltaMs = this.defaultExpiryMs) {
-    await this.store.set(this.key, value, expiryDeltaMs);
-  }
-  /**
-   * Example usage:
-   *
-   *   const { value, storedMs, expiryMs, storedMs } =
-   *     await myKvItem.getStoredObject();
-   */
-  async getStoredObject() {
-    return await this.store.getStoredObject(this.key);
-  }
-  /** Get a value by key, or undefined if it does not exist. */
-  async get() {
-    return await this.store.get(this.key);
-  }
-  /** Delete this key from the store. */
-  async delete() {
-    await this.store.delete(this.key);
-  }
-};
+  };
+  return obj;
+}
+var kvStore = createKvStore(KvStoreConfig.dbName);
 function kvStoreItem(key, expiryMs, store = kvStore) {
-  expiryMs = expiryMs && durationOrMsToMs(expiryMs);
-  return new KvStoreItem(key, expiryMs, store);
+  const defaultExpiryMs = expiryMs && durationOrMsToMs(expiryMs);
+  const obj = {
+    key,
+    defaultExpiryMs,
+    store,
+    /** Set a value in the store. */
+    async set(value, expiryDeltaMs) {
+      await store.set(key, value, expiryDeltaMs ?? defaultExpiryMs);
+    },
+    /**
+     * Example usage:
+     *
+     *   const { value, storedMs, expiryMs, storedMs } =
+     *     await myKvItem.getStoredObject();
+     */
+    async getStoredObject() {
+      return await store.getStoredObject(key);
+    },
+    /** Get a value by key, or undefined if it does not exist. */
+    async get() {
+      return await store.get(key);
+    },
+    /** Delete this key from the store. */
+    async delete() {
+      await store.delete(key);
+    }
+  };
+  return obj;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  KvStore,
   KvStoreConfig,
-  KvStoreItem,
   configureKvStore,
+  createKvStore,
   kvStore,
   kvStoreItem
 });