@choksheak/ts-utils 0.3.0 → 0.3.1

package/arrayBuffer.d.ts

@@ -1,8 +1,10 @@
 /**
  * Encode an input ArrayBuffer into a hex string.
  */
-export declare function arrayBufferToHex(buffer: ArrayBuffer): string;
+declare function arrayBufferToHex(buffer: ArrayBuffer): string;
 /**
  * Encode an input ArrayBuffer into a base64 string.
  */
-export declare function arrayBufferToBase64(buffer: ArrayBuffer): string;
+declare function arrayBufferToBase64(buffer: ArrayBuffer): string;
+
+export { arrayBufferToBase64, arrayBufferToHex };

package/assert.d.ts

@@ -2,4 +2,6 @@
  * Type asserts that `t` is truthy. Throws an error with `errorMessage` if
  * `t` is falsy.
  */
-export declare function assert<T>(t: T | null | undefined | "" | 0 | -0 | 0n | false | typeof NaN, errorMessage?: string): asserts t is T;
+declare function assert<T>(t: T | null | undefined | "" | 0 | -0 | 0n | false | typeof NaN, errorMessage?: string): asserts t is T;
+
+export { assert };

package/average.d.ts

@@ -2,4 +2,6 @@
  * Average all the numbers together in the given array. Treats null, undefined
  * and NaN as zero.
  */
-export declare function average(numbers: (number | null | undefined)[]): number;
+declare function average(numbers: (number | null | undefined)[]): number;
+
+export { average };

package/base64Url.d.ts

@@ -1,8 +1,10 @@
 /**
  * Convert a base64 string to a base64url string.
  */
-export declare function base64ToBase64URL(base64: string): string;
+declare function base64ToBase64URL(base64: string): string;
 /**
  * Convert a base64url string to a base64 string.
  */
-export declare function base64UrlToBase64(base64Url: string): string;
+declare function base64UrlToBase64(base64Url: string): string;
+
+export { base64ToBase64URL, base64UrlToBase64 };

package/dateTimeStr.d.ts

@@ -1,38 +1,38 @@
-export type AnyDateTime = number | Date | string;
+type AnyDateTime = number | Date | string;
 /**
  * Convert a number (epoch seconds or milliseconds), string (parseable
  * date/time or epoch seconds or milliseconds), or Date object (no conversion)
  * into a Date object.
  */
-export declare function toDate(ts: AnyDateTime): Date;
+declare function toDate(ts: AnyDateTime): Date;
 /**
  * Returns a date in yyyy-MM format. E.g. '2000-01'.
  *
  * @param dt Specify a date object or default to the current date.
  * @param separator Defaults to '-'.
  */
-export declare function yyyyMm(dt?: Date, separator?: string): string;
+declare function yyyyMm(dt?: Date, separator?: string): string;
 /**
  * Returns a date in yyyy-MM-dd format. E.g. '2000-01-02'.
  *
  * @param dt Specify a date object or default to the current date.
  * @param separator Defaults to '-'.
  */
-export declare function yyyyMmDd(dt?: Date, separator?: string): string;
+declare function yyyyMmDd(dt?: Date, separator?: string): string;
 /**
  * Returns a date in hh:mm format. E.g. '01:02'.
  *
  * @param dt Specify a date object or default to the current date/time.
  * @param separator Defaults to ':'.
  */
-export declare function hhMm(dt?: Date, separator?: string): string;
+declare function hhMm(dt?: Date, separator?: string): string;
 /**
  * Returns a date in hh:mm:ss format. E.g. '01:02:03'.
  *
  * @param dt Specify a date object or default to the current date/time.
  * @param separator Defaults to ':'.
  */
-export declare function hhMmSs(dt?: Date, separator?: string): string;
+declare function hhMmSs(dt?: Date, separator?: string): string;
 /**
  * Returns a date in hh:mm:ss.SSS format. E.g. '01:02:03.004'.
  *
@@ -40,44 +40,46 @@ export declare function hhMmSs(dt?: Date, separator?: string): string;
  * @param timeSeparator Separator for hh/mm/ss. Defaults to ':'.
  * @param msSeparator Separator before SSS. Defaults to '.'.
  */
-export declare function hhMmSsMs(dt?: Date, timeSeparator?: string, msSeparator?: string): string;
+declare function hhMmSsMs(dt?: Date, timeSeparator?: string, msSeparator?: string): string;
 /**
  * Returns the timezone string for the given date. E.g. '+8', '-3.5'.
  * Returns 'Z' for UTC.
  *
  * @param dt Specify a date object or default to the current date/time.
  */
-export declare function tzShort(dt?: Date): string;
+declare function tzShort(dt?: Date): string;
 /**
  * Returns the long month name, zero-indexed. E.g. 0 for 'January'.
  *
  * @param month Zero-indexed month.
  * @param locales Specify the locale, e.g. 'en-US', new Intl.Locale("en-US").
  */
-export declare function getLongMonthNameZeroIndexed(month: number, locales?: Intl.LocalesArgument): string;
+declare function getLongMonthNameZeroIndexed(month: number, locales?: Intl.LocalesArgument): string;
 /**
  * Returns the long month name, one-indexed. E.g. 1 for 'January'.
  *
  * @param month One-indexed month.
  * @param locales Specify the locale, e.g. 'en-US', new Intl.Locale("en-US").
  */
-export declare function getLongMonthNameOneIndexed(month: number, locales?: Intl.LocalesArgument): string;
+declare function getLongMonthNameOneIndexed(month: number, locales?: Intl.LocalesArgument): string;
 /**
  * Returns the short month name, zero-indexed. E.g. 0 for 'Jan'.
  *
  * @param month Zero-indexed month.
  * @param locales Specify the locale, e.g. 'en-US', new Intl.Locale("en-US").
  */
-export declare function getShortMonthNameZeroIndexed(month: number, locales?: Intl.LocalesArgument): string;
+declare function getShortMonthNameZeroIndexed(month: number, locales?: Intl.LocalesArgument): string;
 /**
  * Returns the short month name, one-indexed. E.g. 1 for 'Jan'.
  *
  * @param month One-indexed month.
  * @param locales Specify the locale, e.g. 'en-US', new Intl.Locale("en-US").
  */
-export declare function getShortMonthNameOneIndexed(month: number, locales?: Intl.LocalesArgument): string;
+declare function getShortMonthNameOneIndexed(month: number, locales?: Intl.LocalesArgument): string;
 /**
  * Returns a human-readable string date/time like '2025-01-01 22:31:16Z'.
  * Excludes the milliseconds assuming it is not necessary for display.
  */
-export declare function getDisplayDateTime(ts: AnyDateTime): string;
+declare function getDisplayDateTime(ts: AnyDateTime): string;
+
+export { type AnyDateTime, getDisplayDateTime, getLongMonthNameOneIndexed, getLongMonthNameZeroIndexed, getShortMonthNameOneIndexed, getShortMonthNameZeroIndexed, hhMm, hhMmSs, hhMmSsMs, toDate, tzShort, yyyyMm, yyyyMmDd };

package/duration.d.ts

@@ -6,7 +6,7 @@
  * from this file. Weeks have fixed durations, but are excluded because we
  * use days as the max duration supported.
  */
-export type Duration = {
+type Duration = {
     days?: number;
     hours?: number;
     minutes?: number;
@@ -16,11 +16,11 @@ export type Duration = {
 /**
  * One of: days, hours, minutes, seconds, milliseconds
  */
-export type DurationType = keyof Duration;
+type DurationType = keyof Duration;
 /**
  * Order in which the duration type appears in the duration string.
  */
-export declare const DURATION_TYPE_SEQUENCE: DurationType[];
+declare const DURATION_TYPE_SEQUENCE: DurationType[];
 /**
  * Follows the same format as Intl.DurationFormat.prototype.format().
  *
@@ -29,16 +29,16 @@ export declare const DURATION_TYPE_SEQUENCE: DurationType[];
  *       7 milliseconds, 8 microseconds, 9 nanoseconds
  * Narrow: 1y 2mo 3w 3d 4h 5m 6s 7ms 8μs 9ns
  */
-export type DurationStyle = "short" | "long" | "narrow";
-export type DurationSuffixMap = {
+type DurationStyle = "short" | "long" | "narrow";
+type DurationSuffixMap = {
     short: string;
     shorts: string;
     long: string;
     longs: string;
     narrow: string;
 };
-export type DurationSuffixType = keyof DurationSuffixMap;
-export declare const DURATION_STYLE_SUFFIX_MAP: Record<DurationType, DurationSuffixMap>;
+type DurationSuffixType = keyof DurationSuffixMap;
+declare const DURATION_STYLE_SUFFIX_MAP: Record<DurationType, DurationSuffixMap>;
 /**
  * Convert a milliseconds duration into a Duration object. If the given ms is
  * zero, then return an object with a single field of zero with duration type
@@ -46,31 +46,33 @@ export declare const DURATION_STYLE_SUFFIX_MAP: Record<DurationType, DurationSuf
  *
  * @param durationTypeForZero Defaults to 'milliseconds'
  */
-export declare function msToDuration(ms: number, durationTypeForZero?: DurationType): Duration;
+declare function msToDuration(ms: number, durationTypeForZero?: DurationType): Duration;
 /**
  * Returns the number of milliseconds for the given duration.
  */
-export declare function durationToMs(duration: Duration): number;
+declare function durationToMs(duration: Duration): number;
 /**
  * Convenience function to return a duration given an ms or Duration.
  */
-export declare function durationOrMsToMs(duration: number | Duration): number;
+declare function durationOrMsToMs(duration: number | Duration): number;
 /**
  * Format a given Duration object into a string. If the object has no fields,
  * then returns an empty string.
  *
  * @param style Defaults to 'short'
  */
-export declare function formatDuration(duration: Duration, style?: DurationStyle): string;
+declare function formatDuration(duration: Duration, style?: DurationStyle): string;
 /**
  * Convert a millisecond duration into a human-readable duration string.
  *
  * @param options.durationTypeForZero - Defaults to 'milliseconds'
  * @param options.style - Defaults to 'short'
  */
-export declare function readableDuration(ms: number, options?: {
+declare function readableDuration(ms: number, options?: {
     durationTypeForZero?: DurationType;
     style?: DurationStyle;
 }): string;
 /** A shortened duration string useful for logging timings. */
-export declare function elapsed(ms: number): string;
+declare function elapsed(ms: number): string;
+
+export { DURATION_STYLE_SUFFIX_MAP, DURATION_TYPE_SEQUENCE, type Duration, type DurationStyle, type DurationSuffixMap, type DurationSuffixType, type DurationType, durationOrMsToMs, durationToMs, elapsed, formatDuration, msToDuration, readableDuration };

package/isEmpty.d.ts

@@ -1,4 +1,6 @@
 /**
  * Returns true if `t` is empty.
  */
-export declare function isEmpty(t: unknown): boolean;
+declare function isEmpty(t: unknown): boolean;
+
+export { isEmpty };

package/iterators.cjs

@@ -0,0 +1,34 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/iterators.ts
+var iterators_exports = {};
+__export(iterators_exports, {
+  concatIterators: () => concatIterators
+});
+module.exports = __toCommonJS(iterators_exports);
+function* concatIterators(...iterators) {
+  for (const iterator of iterators) {
+    yield* iterator;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  concatIterators
+});

package/iterators.d.mts

@@ -0,0 +1,4 @@
+/** Memory-efficient way to concat two or more iterators. */
+declare function concatIterators<T>(...iterators: Generator<T>[]): Generator<T, void, any>;
+
+export { concatIterators };

package/iterators.d.ts

@@ -0,0 +1,4 @@
+/** Memory-efficient way to concat two or more iterators. */
+declare function concatIterators<T>(...iterators: Generator<T>[]): Generator<T, void, any>;
+
+export { concatIterators };

package/iterators.min.cjs

@@ -0,0 +1,2 @@
+"use strict";var n=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var i=Object.prototype.hasOwnProperty;var s=(t,o)=>{for(var e in o)n(t,e,{get:o[e],enumerable:!0})},T=(t,o,e,a)=>{if(o&&typeof o=="object"||typeof o=="function")for(let r of f(o))!i.call(t,r)&&r!==e&&n(t,r,{get:()=>o[r],enumerable:!(a=c(o,r))||a.enumerable});return t};var d=t=>T(n({},"__esModule",{value:!0}),t);var p={};s(p,{concatIterators:()=>l});module.exports=d(p);function*l(...t){for(let o of t)yield*o}0&&(module.exports={concatIterators});
+//# sourceMappingURL=iterators.min.cjs.map

package/iterators.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/iterators.ts"],"sourcesContent":["/** Memory-efficient way to concat two or more iterators. */\nexport function* concatIterators<T>(...iterators: Generator<T>[]) {\n  for (const iterator of iterators) {\n    yield* iterator;\n  }\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,qBAAAE,IAAA,eAAAC,EAAAH,GACO,SAAUE,KAAsBE,EAA2B,CAChE,QAAWC,KAAYD,EACrB,MAAOC,CAEX","names":["iterators_exports","__export","concatIterators","__toCommonJS","iterators","iterator"]}

package/iterators.min.mjs

@@ -0,0 +1,2 @@
+function*r(...o){for(let t of o)yield*t}export{r as concatIterators};
+//# sourceMappingURL=iterators.min.mjs.map

package/iterators.min.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/iterators.ts"],"sourcesContent":["/** Memory-efficient way to concat two or more iterators. */\nexport function* concatIterators<T>(...iterators: Generator<T>[]) {\n  for (const iterator of iterators) {\n    yield* iterator;\n  }\n}\n"],"mappings":"AACO,SAAUA,KAAsBC,EAA2B,CAChE,QAAWC,KAAYD,EACrB,MAAOC,CAEX","names":["concatIterators","iterators","iterator"]}

package/iterators.mjs

@@ -0,0 +1,9 @@
+// src/iterators.ts
+function* concatIterators(...iterators) {
+  for (const iterator of iterators) {
+    yield* iterator;
+  }
+}
+export {
+  concatIterators
+};

package/kvStore.cjs

@@ -20,11 +20,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/kvStore.ts
 var kvStore_exports = {};
 __export(kvStore_exports, {
-  DEFAULT_EXPIRY_DELTA_MS: () => DEFAULT_EXPIRY_DELTA_MS,
-  GC_INTERVAL_MS: () => GC_INTERVAL_MS,
-  KVStore: () => KVStore,
-  KVStoreField: () => KVStoreField,
-  MILLIS_PER_DAY: () => MILLIS_PER_DAY,
+  KvStore: () => KvStore,
+  KvStoreConfig: () => KvStoreConfig,
+  KvStoreItem: () => KvStoreItem,
+  configureKvStore: () => configureKvStore,
   kvStore: () => kvStore,
   kvStoreItem: () => kvStoreItem
 });
@@ -50,14 +49,32 @@ function durationOrMsToMs(duration) {
 }
 
 // src/kvStore.ts
-var DEFAULT_DB_NAME = "KVStore";
-var DEFAULT_DB_VERSION = 1;
-var STORE_NAME = "kvStore";
-var MILLIS_PER_DAY = 864e5;
-var DEFAULT_EXPIRY_DELTA_MS = MILLIS_PER_DAY * 30;
-var GC_INTERVAL_MS = MILLIS_PER_DAY;
+var KvStoreConfig = {
+  /**
+   * Name of the DB in the indexed DB.
+   * Updating the DB name will cause all old entries to be gone.
+   */
+  dbName: "KVStore",
+  /**
+   * Version of the DB schema. Most likely you will never want to change this.
+   * Updating the version will cause all old entries to be gone.
+   */
+  dbVersion: 1,
+  /**
+   * Name of the store within the indexed DB. Each DB can have multiple stores.
+   * In practice, it doesn't matter what you name this to be.
+   */
+  storeName: "kvStore",
+  /** 30 days in ms. */
+  expiryMs: MS_PER_DAY * 30,
+  /** Do GC once per day. */
+  gcIntervalMs: MS_PER_DAY
+};
+function configureKvStore(config) {
+  Object.assign(KvStoreConfig, config);
+}
 function validateStoredObject(obj) {
-  if (!obj || typeof obj !== "object" || !("key" in obj) || typeof obj.key !== "string" || !("value" in obj) || !("storedMs" in obj) || typeof obj.storedMs !== "number" || obj.value === void 0 || !("expiryMs" in obj) || typeof obj.expiryMs !== "number" || Date.now() >= obj.expiryMs) {
+  if (!obj || typeof obj !== "object" || typeof obj.key !== "string" || obj.value === void 0 || typeof obj.storedMs !== "number" || typeof obj.expiryMs !== "number" || Date.now() >= obj.expiryMs) {
     return void 0;
   }
   return obj;
@@ -68,32 +85,23 @@ function withOnError(request, reject) {
   };
   return request;
 }
-var KVStoreField = class {
-  constructor(store, key) {
-    this.store = store;
-    this.key = key;
-  }
-  get() {
-    return this.store.get(this.key);
-  }
-  set(t) {
-    return this.store.set(this.key, t);
-  }
-  delete() {
-    return this.store.delete(this.key);
-  }
-};
-var KVStore = class {
-  constructor(dbName, dbVersion, defaultExpiryDeltaMs) {
+var KvStore = class {
+  constructor(dbName, options) {
     this.dbName = dbName;
-    this.dbVersion = dbVersion;
-    this.defaultExpiryDeltaMs = defaultExpiryDeltaMs;
-    this.gcMsStorageKey = `__kvStore:lastGcMs:${dbName}:v${dbVersion}:${STORE_NAME}`;
+    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.
+  /** We'll init the DB only on first use. */
   db;
-  // Local storage key name for the last GC completed timestamp.
+  /** 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) => {
@@ -103,7 +111,7 @@ var KVStore = class {
         );
         request.onupgradeneeded = (event) => {
           const db = event.target.result;
-          const objectStore = db.createObjectStore(STORE_NAME, {
+          const objectStore = db.createObjectStore(this.storeName, {
             keyPath: "key"
           });
           objectStore.createIndex("key", "key", {
@@ -121,15 +129,19 @@ var KVStore = class {
   async transact(mode, callback) {
     const db = await this.getOrCreateDb();
     return await new Promise((resolve, reject) => {
-      const transaction = withOnError(db.transaction(STORE_NAME, mode), reject);
+      const transaction = withOnError(
+        db.transaction(this.storeName, mode),
+        reject
+      );
       transaction.onabort = (event) => {
         reject(event);
       };
-      const objectStore = transaction.objectStore(STORE_NAME);
+      const objectStore = transaction.objectStore(this.storeName);
       callback(objectStore, resolve, reject);
     });
   }
-  async set(key, value, expiryDeltaMs = this.defaultExpiryDeltaMs) {
+  /** Set a value in the store. */
+  async set(key, value, expiryDeltaMs = this.defaultExpiryMs) {
     const nowMs = Date.now();
     const obj = {
       key,
@@ -166,6 +178,7 @@ var KVStore = class {
       }
     );
   }
+  /** Mainly used to get the expiration timestamp of an object. */
   async getStoredObject(key) {
     const stored = await this.transact(
       "readonly",
@@ -194,10 +207,12 @@ var KVStore = class {
       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);
@@ -206,10 +221,13 @@ var KVStore = class {
         if (cursor) {
           if (cursor.key) {
             const obj = validateStoredObject(cursor.value);
-            if (obj) {
-              await callback(String(cursor.key), obj.value, obj.expiryMs);
-            } else {
-              await callback(String(cursor.key), void 0, 0);
+            if (obj !== void 0) {
+              await callback(
+                String(cursor.key),
+                obj.value,
+                obj.expiryMs,
+                obj.storedMs
+              );
             }
           }
           cursor.continue();
@@ -219,7 +237,11 @@ var KVStore = class {
       };
     });
   }
-  /** Cannot be a getter because this needs to be async. */
+  /**
+   * 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(() => {
@@ -227,6 +249,7 @@ var KVStore = class {
     });
     return count;
   }
+  /** Remove all items from the store. */
   async clear() {
     const keys = [];
     await this.forEach((key) => {
@@ -234,36 +257,45 @@ var KVStore = class {
     });
     await this.delete(keys);
   }
-  /** Mainly for debugging dumps. */
+  /**
+   * 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) => {
-      map.set(key, { value, expiryMs });
+    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. */
+  /** 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 + GC_INTERVAL_MS) {
+    if (Date.now() < lastGcMs + this.gcIntervalMs) {
       return;
     }
     await this.gcNow();
   }
-  /** Perform garbage-collection immediately without checking. */
+  /**
+   * 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();
@@ -283,51 +315,51 @@ var KVStore = class {
     );
     this.lastGcMs = Date.now();
   }
-  /** Get an independent store item with a locked key and value type. */
-  field(key) {
-    return new KVStoreField(this, key);
+  /** Returns `this` casted into a StorageAdapter<T>. */
+  asStorageAdapter() {
+    return this;
   }
 };
-var kvStore = new KVStore(
-  DEFAULT_DB_NAME,
-  DEFAULT_DB_VERSION,
-  DEFAULT_EXPIRY_DELTA_MS
-);
+var kvStore = new KvStore(KvStoreConfig.dbName);
 var KvStoreItem = class {
-  constructor(key, defaultExpiryDeltaMs, store = kvStore) {
+  constructor(key, defaultExpiryMs = KvStoreConfig.expiryMs, store = kvStore) {
     this.key = key;
-    this.defaultExpiryDeltaMs = defaultExpiryDeltaMs;
     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 } = await myKvItem.getStoredObject();
+   *   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);
   }
-  async set(value, expiryDeltaMs = this.defaultExpiryDeltaMs) {
-    await this.store.set(this.key, value, expiryDeltaMs);
-  }
+  /** Delete this key from the store. */
   async delete() {
     await this.store.delete(this.key);
   }
 };
-function kvStoreItem(key, defaultExpiration) {
-  const defaultExpiryDeltaMs = durationOrMsToMs(defaultExpiration);
-  return new KvStoreItem(key, defaultExpiryDeltaMs);
+function kvStoreItem(key, expiryMs, store = kvStore) {
+  expiryMs = expiryMs && durationOrMsToMs(expiryMs);
+  return new KvStoreItem(key, expiryMs, store);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  DEFAULT_EXPIRY_DELTA_MS,
-  GC_INTERVAL_MS,
-  KVStore,
-  KVStoreField,
-  MILLIS_PER_DAY,
+  KvStore,
+  KvStoreConfig,
+  KvStoreItem,
+  configureKvStore,
   kvStore,
   kvStoreItem
 });