@choksheak/ts-utils 0.3.3 → 0.3.5

package/kvStore.d.mts

@@ -1,5 +1,5 @@
 import { Duration } from './duration.mjs';
-import { StoredObject, FullStorageAdapter, StorageAdapter } from './storageAdapter.mjs';
+import { StoredObject, StorageAdapter } from './storageAdapter.mjs';
 
 /**
  * Indexed DB key-value store with support for auto-expirations.
@@ -50,90 +50,188 @@ type KvStoredObject<T> = StoredObject<T> & {
  * You can create multiple KvStores if you want, but most likely you will only
  * need to use the default `kvStore` instance.
  */
-declare class KvStore implements FullStorageAdapter<any> {
+declare function createKvStore(dbName: string, options?: {
+    dbVersion?: number;
+    storeName?: string;
+    defaultExpiryMs?: number | Duration;
+    gcIntervalMs?: number | Duration;
+}): {
+    /** Input name for the DB. */
     readonly dbName: string;
-    /** We'll init the DB only on first use. */
-    private db;
-    /** Local storage key name for the last GC completed timestamp. */
-    readonly gcMsStorageKey: string;
+    /** Input version for the DB. */
     readonly dbVersion: number;
+    /** Input name for the DB store. */
     readonly storeName: string;
+    /** Default expiry to use if not specified in set(). */
     readonly defaultExpiryMs: number;
+    /** Time interval for when GC's occur. */
     readonly gcIntervalMs: number;
-    constructor(dbName: string, options?: {
-        dbVersion?: number;
-        storeName?: string;
-        defaultExpiryMs?: number | Duration;
-        gcIntervalMs?: number | Duration;
-    });
-    private getOrCreateDb;
-    private transact;
+    /** Local storage key name for the last GC completed timestamp. */
+    readonly gcMsStorageKey: string;
     /** Set a value in the store. */
-    set<T>(key: string, value: T, expiryDeltaMs?: number | Duration): Promise<T>;
+    readonly set: <T>(key: string, value: T, expiryDeltaMs?: number | Duration) => Promise<T>;
     /** Delete one or multiple keys. */
-    delete(key: string | string[]): Promise<void>;
+    readonly delete: (key: string | string[]) => Promise<void>;
     /** Mainly used to get the expiration timestamp of an object. */
-    getStoredObject<T>(key: string): Promise<KvStoredObject<T> | undefined>;
+    readonly getStoredObject: <T>(key: string) => Promise<KvStoredObject<T> | undefined>;
     /** Get a value by key, or undefined if it does not exist. */
-    get<T>(key: string): Promise<T | undefined>;
+    readonly get: <T>(key: string) => Promise<T | undefined>;
     /** Generic way to iterate through all entries. */
-    forEach<T>(callback: (key: string, value: T, expiryMs: number, storedMs: number) => void | Promise<void>): Promise<void>;
+    readonly forEach: <T>(callback: (key: string, value: T, expiryMs: number, storedMs: number) => void | Promise<void>) => Promise<void>;
     /**
      * 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.
      */
-    size(): Promise<number>;
+    readonly size: () => Promise<number>;
     /** Remove all items from the store. */
-    clear(): Promise<void>;
+    readonly clear: () => Promise<void>;
     /**
      * 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).
      */
-    asMap<T>(): Promise<Map<string, StoredObject<T>>>;
+    readonly asMap: <T>() => Promise<Map<string, StoredObject<T>>>;
     /** Returns the ms timestamp for the last GC (garbage collection). */
-    get lastGcMs(): number;
+    readonly getLastGcMs: () => number;
     /** Set the ms timestamp for the last GC (garbage collection). */
-    set lastGcMs(ms: number);
+    readonly setLastGcMs: (ms: number) => void;
     /** Perform garbage-collection if due, else do nothing. */
-    gc(): Promise<void>;
+    readonly gc: () => Promise<void>;
     /**
      * Perform garbage collection immediately without checking whether we are
      * due for the next GC or not.
      */
-    gcNow(): Promise<void>;
+    readonly gcNow: () => Promise<void>;
     /** Returns `this` casted into a StorageAdapter<T>. */
-    asStorageAdapter<T>(): StorageAdapter<T>;
-}
+    readonly asStorageAdapter: <T>() => StorageAdapter<T>;
+};
+type KvStore = ReturnType<typeof createKvStore>;
 /**
  * Default KV store ready for immediate use. You can create new instances if
  * you want, but most likely you will only need one store instance.
  */
-declare const kvStore: KvStore;
-/**
- * Class to represent one key in the store with a default expiration.
- */
-declare class KvStoreItem<T> {
-    readonly key: string;
-    readonly store: KvStore;
+declare const kvStore: {
+    /** Input name for the DB. */
+    readonly dbName: string;
+    /** Input version for the DB. */
+    readonly dbVersion: number;
+    /** Input name for the DB store. */
+    readonly storeName: string;
+    /** Default expiry to use if not specified in set(). */
     readonly defaultExpiryMs: number;
-    constructor(key: string, defaultExpiryMs?: number | Duration, store?: KvStore);
+    /** Time interval for when GC's occur. */
+    readonly gcIntervalMs: number;
+    /** Local storage key name for the last GC completed timestamp. */
+    readonly gcMsStorageKey: string;
     /** Set a value in the store. */
-    set(value: T, expiryDeltaMs?: number | undefined): Promise<void>;
+    readonly set: <T>(key: string, value: T, expiryDeltaMs?: number | Duration) => Promise<T>;
+    /** Delete one or multiple keys. */
+    readonly delete: (key: string | string[]) => Promise<void>;
+    /** Mainly used to get the expiration timestamp of an object. */
+    readonly getStoredObject: <T>(key: string) => Promise<KvStoredObject<T> | undefined>;
+    /** Get a value by key, or undefined if it does not exist. */
+    readonly get: <T>(key: string) => Promise<T | undefined>;
+    /** Generic way to iterate through all entries. */
+    readonly forEach: <T>(callback: (key: string, value: T, expiryMs: number, storedMs: number) => void | Promise<void>) => Promise<void>;
+    /**
+     * 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.
+     */
+    readonly size: () => Promise<number>;
+    /** Remove all items from the store. */
+    readonly clear: () => Promise<void>;
+    /**
+     * 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).
+     */
+    readonly asMap: <T>() => Promise<Map<string, StoredObject<T>>>;
+    /** Returns the ms timestamp for the last GC (garbage collection). */
+    readonly getLastGcMs: () => number;
+    /** Set the ms timestamp for the last GC (garbage collection). */
+    readonly setLastGcMs: (ms: number) => void;
+    /** Perform garbage-collection if due, else do nothing. */
+    readonly gc: () => Promise<void>;
+    /**
+     * Perform garbage collection immediately without checking whether we are
+     * due for the next GC or not.
+     */
+    readonly gcNow: () => Promise<void>;
+    /** Returns `this` casted into a StorageAdapter<T>. */
+    readonly asStorageAdapter: <T>() => StorageAdapter<T>;
+};
+/** Create a KV store item with a key and a default expiration. */
+declare function kvStoreItem<T>(key: string, expiryMs?: number | Duration, store?: KvStore): {
+    readonly key: string;
+    readonly defaultExpiryMs: number | undefined;
+    readonly store: {
+        /** Input name for the DB. */
+        readonly dbName: string;
+        /** Input version for the DB. */
+        readonly dbVersion: number;
+        /** Input name for the DB store. */
+        readonly storeName: string;
+        /** Default expiry to use if not specified in set(). */
+        readonly defaultExpiryMs: number;
+        /** Time interval for when GC's occur. */
+        readonly gcIntervalMs: number;
+        /** Local storage key name for the last GC completed timestamp. */
+        readonly gcMsStorageKey: string;
+        /** Set a value in the store. */
+        readonly set: <T_1>(key: string, value: T_1, expiryDeltaMs?: number | Duration) => Promise<T_1>;
+        /** Delete one or multiple keys. */
+        readonly delete: (key: string | string[]) => Promise<void>;
+        /** Mainly used to get the expiration timestamp of an object. */
+        readonly getStoredObject: <T_1>(key: string) => Promise<KvStoredObject<T_1> | undefined>;
+        /** Get a value by key, or undefined if it does not exist. */
+        readonly get: <T_1>(key: string) => Promise<T_1 | undefined>;
+        /** Generic way to iterate through all entries. */
+        readonly forEach: <T_1>(callback: (key: string, value: T_1, expiryMs: number, storedMs: number) => void | Promise<void>) => Promise<void>;
+        /**
+         * 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.
+         */
+        readonly size: () => Promise<number>;
+        /** Remove all items from the store. */
+        readonly clear: () => Promise<void>;
+        /**
+         * 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).
+         */
+        readonly asMap: <T_1>() => Promise<Map<string, StoredObject<T_1>>>;
+        /** Returns the ms timestamp for the last GC (garbage collection). */
+        readonly getLastGcMs: () => number;
+        /** Set the ms timestamp for the last GC (garbage collection). */
+        readonly setLastGcMs: (ms: number) => void;
+        /** Perform garbage-collection if due, else do nothing. */
+        readonly gc: () => Promise<void>;
+        /**
+         * Perform garbage collection immediately without checking whether we are
+         * due for the next GC or not.
+         */
+        readonly gcNow: () => Promise<void>;
+        /** Returns `this` casted into a StorageAdapter<T>. */
+        readonly asStorageAdapter: <T_1>() => StorageAdapter<T_1>;
+    };
+    /** Set a value in the store. */
+    readonly set: (value: T, expiryDeltaMs?: number | undefined) => Promise<void>;
     /**
      * Example usage:
      *
      *   const { value, storedMs, expiryMs, storedMs } =
      *     await myKvItem.getStoredObject();
      */
-    getStoredObject(): Promise<KvStoredObject<T> | undefined>;
+    readonly getStoredObject: () => Promise<KvStoredObject<T> | undefined>;
     /** Get a value by key, or undefined if it does not exist. */
-    get(): Promise<T | undefined>;
+    readonly get: () => Promise<T | undefined>;
     /** Delete this key from the store. */
-    delete(): Promise<void>;
-}
-/** Create a KV store item with a key and a default expiration. */
-declare function kvStoreItem<T>(key: string, expiryMs?: number | Duration, store?: KvStore): KvStoreItem<T>;
+    readonly delete: () => Promise<void>;
+};
+/** Class to represent one key in the store with a default expiration. */
+type KvStoreItem<T> = ReturnType<typeof kvStoreItem<T>>;
 
-export { KvStore, KvStoreConfig, KvStoreItem, type KvStoredObject, configureKvStore, kvStore, kvStoreItem };
+export { type KvStore, KvStoreConfig, type KvStoreItem, type KvStoredObject, configureKvStore, createKvStore, kvStore, kvStoreItem };

package/kvStore.d.ts

@@ -1,5 +1,5 @@
 import { Duration } from './duration.js';
-import { StoredObject, FullStorageAdapter, StorageAdapter } from './storageAdapter.js';
+import { StoredObject, StorageAdapter } from './storageAdapter.js';
 
 /**
  * Indexed DB key-value store with support for auto-expirations.
@@ -50,90 +50,188 @@ type KvStoredObject<T> = StoredObject<T> & {
  * You can create multiple KvStores if you want, but most likely you will only
  * need to use the default `kvStore` instance.
  */
-declare class KvStore implements FullStorageAdapter<any> {
+declare function createKvStore(dbName: string, options?: {
+    dbVersion?: number;
+    storeName?: string;
+    defaultExpiryMs?: number | Duration;
+    gcIntervalMs?: number | Duration;
+}): {
+    /** Input name for the DB. */
     readonly dbName: string;
-    /** We'll init the DB only on first use. */
-    private db;
-    /** Local storage key name for the last GC completed timestamp. */
-    readonly gcMsStorageKey: string;
+    /** Input version for the DB. */
     readonly dbVersion: number;
+    /** Input name for the DB store. */
     readonly storeName: string;
+    /** Default expiry to use if not specified in set(). */
     readonly defaultExpiryMs: number;
+    /** Time interval for when GC's occur. */
     readonly gcIntervalMs: number;
-    constructor(dbName: string, options?: {
-        dbVersion?: number;
-        storeName?: string;
-        defaultExpiryMs?: number | Duration;
-        gcIntervalMs?: number | Duration;
-    });
-    private getOrCreateDb;
-    private transact;
+    /** Local storage key name for the last GC completed timestamp. */
+    readonly gcMsStorageKey: string;
     /** Set a value in the store. */
-    set<T>(key: string, value: T, expiryDeltaMs?: number | Duration): Promise<T>;
+    readonly set: <T>(key: string, value: T, expiryDeltaMs?: number | Duration) => Promise<T>;
     /** Delete one or multiple keys. */
-    delete(key: string | string[]): Promise<void>;
+    readonly delete: (key: string | string[]) => Promise<void>;
     /** Mainly used to get the expiration timestamp of an object. */
-    getStoredObject<T>(key: string): Promise<KvStoredObject<T> | undefined>;
+    readonly getStoredObject: <T>(key: string) => Promise<KvStoredObject<T> | undefined>;
     /** Get a value by key, or undefined if it does not exist. */
-    get<T>(key: string): Promise<T | undefined>;
+    readonly get: <T>(key: string) => Promise<T | undefined>;
     /** Generic way to iterate through all entries. */
-    forEach<T>(callback: (key: string, value: T, expiryMs: number, storedMs: number) => void | Promise<void>): Promise<void>;
+    readonly forEach: <T>(callback: (key: string, value: T, expiryMs: number, storedMs: number) => void | Promise<void>) => Promise<void>;
     /**
      * 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.
      */
-    size(): Promise<number>;
+    readonly size: () => Promise<number>;
     /** Remove all items from the store. */
-    clear(): Promise<void>;
+    readonly clear: () => Promise<void>;
     /**
      * 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).
      */
-    asMap<T>(): Promise<Map<string, StoredObject<T>>>;
+    readonly asMap: <T>() => Promise<Map<string, StoredObject<T>>>;
     /** Returns the ms timestamp for the last GC (garbage collection). */
-    get lastGcMs(): number;
+    readonly getLastGcMs: () => number;
     /** Set the ms timestamp for the last GC (garbage collection). */
-    set lastGcMs(ms: number);
+    readonly setLastGcMs: (ms: number) => void;
     /** Perform garbage-collection if due, else do nothing. */
-    gc(): Promise<void>;
+    readonly gc: () => Promise<void>;
     /**
      * Perform garbage collection immediately without checking whether we are
      * due for the next GC or not.
      */
-    gcNow(): Promise<void>;
+    readonly gcNow: () => Promise<void>;
     /** Returns `this` casted into a StorageAdapter<T>. */
-    asStorageAdapter<T>(): StorageAdapter<T>;
-}
+    readonly asStorageAdapter: <T>() => StorageAdapter<T>;
+};
+type KvStore = ReturnType<typeof createKvStore>;
 /**
  * Default KV store ready for immediate use. You can create new instances if
  * you want, but most likely you will only need one store instance.
  */
-declare const kvStore: KvStore;
-/**
- * Class to represent one key in the store with a default expiration.
- */
-declare class KvStoreItem<T> {
-    readonly key: string;
-    readonly store: KvStore;
+declare const kvStore: {
+    /** Input name for the DB. */
+    readonly dbName: string;
+    /** Input version for the DB. */
+    readonly dbVersion: number;
+    /** Input name for the DB store. */
+    readonly storeName: string;
+    /** Default expiry to use if not specified in set(). */
     readonly defaultExpiryMs: number;
-    constructor(key: string, defaultExpiryMs?: number | Duration, store?: KvStore);
+    /** Time interval for when GC's occur. */
+    readonly gcIntervalMs: number;
+    /** Local storage key name for the last GC completed timestamp. */
+    readonly gcMsStorageKey: string;
     /** Set a value in the store. */
-    set(value: T, expiryDeltaMs?: number | undefined): Promise<void>;
+    readonly set: <T>(key: string, value: T, expiryDeltaMs?: number | Duration) => Promise<T>;
+    /** Delete one or multiple keys. */
+    readonly delete: (key: string | string[]) => Promise<void>;
+    /** Mainly used to get the expiration timestamp of an object. */
+    readonly getStoredObject: <T>(key: string) => Promise<KvStoredObject<T> | undefined>;
+    /** Get a value by key, or undefined if it does not exist. */
+    readonly get: <T>(key: string) => Promise<T | undefined>;
+    /** Generic way to iterate through all entries. */
+    readonly forEach: <T>(callback: (key: string, value: T, expiryMs: number, storedMs: number) => void | Promise<void>) => Promise<void>;
+    /**
+     * 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.
+     */
+    readonly size: () => Promise<number>;
+    /** Remove all items from the store. */
+    readonly clear: () => Promise<void>;
+    /**
+     * 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).
+     */
+    readonly asMap: <T>() => Promise<Map<string, StoredObject<T>>>;
+    /** Returns the ms timestamp for the last GC (garbage collection). */
+    readonly getLastGcMs: () => number;
+    /** Set the ms timestamp for the last GC (garbage collection). */
+    readonly setLastGcMs: (ms: number) => void;
+    /** Perform garbage-collection if due, else do nothing. */
+    readonly gc: () => Promise<void>;
+    /**
+     * Perform garbage collection immediately without checking whether we are
+     * due for the next GC or not.
+     */
+    readonly gcNow: () => Promise<void>;
+    /** Returns `this` casted into a StorageAdapter<T>. */
+    readonly asStorageAdapter: <T>() => StorageAdapter<T>;
+};
+/** Create a KV store item with a key and a default expiration. */
+declare function kvStoreItem<T>(key: string, expiryMs?: number | Duration, store?: KvStore): {
+    readonly key: string;
+    readonly defaultExpiryMs: number | undefined;
+    readonly store: {
+        /** Input name for the DB. */
+        readonly dbName: string;
+        /** Input version for the DB. */
+        readonly dbVersion: number;
+        /** Input name for the DB store. */
+        readonly storeName: string;
+        /** Default expiry to use if not specified in set(). */
+        readonly defaultExpiryMs: number;
+        /** Time interval for when GC's occur. */
+        readonly gcIntervalMs: number;
+        /** Local storage key name for the last GC completed timestamp. */
+        readonly gcMsStorageKey: string;
+        /** Set a value in the store. */
+        readonly set: <T_1>(key: string, value: T_1, expiryDeltaMs?: number | Duration) => Promise<T_1>;
+        /** Delete one or multiple keys. */
+        readonly delete: (key: string | string[]) => Promise<void>;
+        /** Mainly used to get the expiration timestamp of an object. */
+        readonly getStoredObject: <T_1>(key: string) => Promise<KvStoredObject<T_1> | undefined>;
+        /** Get a value by key, or undefined if it does not exist. */
+        readonly get: <T_1>(key: string) => Promise<T_1 | undefined>;
+        /** Generic way to iterate through all entries. */
+        readonly forEach: <T_1>(callback: (key: string, value: T_1, expiryMs: number, storedMs: number) => void | Promise<void>) => Promise<void>;
+        /**
+         * 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.
+         */
+        readonly size: () => Promise<number>;
+        /** Remove all items from the store. */
+        readonly clear: () => Promise<void>;
+        /**
+         * 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).
+         */
+        readonly asMap: <T_1>() => Promise<Map<string, StoredObject<T_1>>>;
+        /** Returns the ms timestamp for the last GC (garbage collection). */
+        readonly getLastGcMs: () => number;
+        /** Set the ms timestamp for the last GC (garbage collection). */
+        readonly setLastGcMs: (ms: number) => void;
+        /** Perform garbage-collection if due, else do nothing. */
+        readonly gc: () => Promise<void>;
+        /**
+         * Perform garbage collection immediately without checking whether we are
+         * due for the next GC or not.
+         */
+        readonly gcNow: () => Promise<void>;
+        /** Returns `this` casted into a StorageAdapter<T>. */
+        readonly asStorageAdapter: <T_1>() => StorageAdapter<T_1>;
+    };
+    /** Set a value in the store. */
+    readonly set: (value: T, expiryDeltaMs?: number | undefined) => Promise<void>;
     /**
      * Example usage:
      *
      *   const { value, storedMs, expiryMs, storedMs } =
      *     await myKvItem.getStoredObject();
      */
-    getStoredObject(): Promise<KvStoredObject<T> | undefined>;
+    readonly getStoredObject: () => Promise<KvStoredObject<T> | undefined>;
     /** Get a value by key, or undefined if it does not exist. */
-    get(): Promise<T | undefined>;
+    readonly get: () => Promise<T | undefined>;
     /** Delete this key from the store. */
-    delete(): Promise<void>;
-}
-/** Create a KV store item with a key and a default expiration. */
-declare function kvStoreItem<T>(key: string, expiryMs?: number | Duration, store?: KvStore): KvStoreItem<T>;
+    readonly delete: () => Promise<void>;
+};
+/** Class to represent one key in the store with a default expiration. */
+type KvStoreItem<T> = ReturnType<typeof kvStoreItem<T>>;
 
-export { KvStore, KvStoreConfig, KvStoreItem, type KvStoredObject, configureKvStore, kvStore, kvStoreItem };
+export { type KvStore, KvStoreConfig, type KvStoreItem, type KvStoredObject, configureKvStore, createKvStore, kvStore, kvStoreItem };

package/kvStore.min.cjs

@@ -1,2 +1,2 @@
-"use strict";var f=Object.defineProperty;var S=Object.getOwnPropertyDescriptor;var M=Object.getOwnPropertyNames;var D=Object.prototype.hasOwnProperty;var T=(r,t)=>{for(var e in t)f(r,e,{get:t[e],enumerable:!0})},E=(r,t,e,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of M(t))!D.call(r,n)&&n!==e&&f(r,n,{get:()=>t[n],enumerable:!(s=S(t,n))||s.enumerable});return r};var _=r=>E(f({},"__esModule",{value:!0}),r);var R={};T(R,{KvStore:()=>b,KvStoreConfig:()=>l,KvStoreItem:()=>g,configureKvStore:()=>O,kvStore:()=>h,kvStoreItem:()=>N});module.exports=_(R);function P(r){let t=(r.days??0)*864e5,e=(r.hours??0)*36e5,s=(r.minutes??0)*6e4,n=(r.seconds??0)*1e3,o=r.milliseconds??0;return t+e+s+n+o}function d(r){return typeof r=="number"?r:P(r)}var l={dbName:"KVStore",dbVersion:1,storeName:"kvStore",expiryMs:864e5*30,gcIntervalMs:864e5};function O(r){Object.assign(l,r)}function m(r){if(!(!r||typeof r!="object"||typeof r.key!="string"||r.value===void 0||typeof r.storedMs!="number"||typeof r.expiryMs!="number"||Date.now()>=r.expiryMs))return r}function c(r,t){return r.onerror=e=>{t(e)},r}var b=class{constructor(t,e){this.dbName=t;this.dbVersion=e?.dbVersion??l.dbVersion,this.storeName=e?.storeName??l.storeName,this.defaultExpiryMs=e?.defaultExpiryMs?d(e.defaultExpiryMs):l.expiryMs,this.gcIntervalMs=e?.gcIntervalMs?d(e.gcIntervalMs):l.gcIntervalMs,this.gcMsStorageKey=`__kvStore:lastGcMs:${t}:v${this.dbVersion}:${this.storeName}`}db;gcMsStorageKey;dbVersion;storeName;defaultExpiryMs;gcIntervalMs;async getOrCreateDb(){return this.db||(this.db=await new Promise((t,e)=>{let s=c(globalThis.indexedDB.open(this.dbName,this.dbVersion),e);s.onupgradeneeded=n=>{n.target.result.createObjectStore(this.storeName,{keyPath:"key"}).createIndex("key","key",{unique:!0})},s.onsuccess=n=>{let o=n.target.result;t(o)}})),this.db}async transact(t,e){let s=await this.getOrCreateDb();return await new Promise((n,o)=>{let i=c(s.transaction(this.storeName,t),o);i.onabort=u=>{o(u)};let a=i.objectStore(this.storeName);e(a,n,o)})}async set(t,e,s=this.defaultExpiryMs){let n=Date.now(),o={key:t,value:e,storedMs:n,expiryMs:n+d(s)};return await this.transact("readwrite",(i,a,u)=>{let y=c(i.put(o),u);y.onsuccess=()=>{a(e),this.gc()}})}async delete(t){return await this.transact("readwrite",(e,s,n)=>{if(e.transaction.oncomplete=()=>{s()},typeof t=="string")c(e.delete(t),n);else for(let o of t)c(e.delete(o),n)})}async getStoredObject(t){let e=await this.transact("readonly",(s,n,o)=>{let i=c(s.get(t),o);i.onsuccess=()=>{n(i.result)}});if(e)try{let s=m(e);if(!s){await this.delete(t),this.gc();return}return s}catch(s){console.error(`Invalid kv value: ${t}=${JSON.stringify(e)}:`,s),await this.delete(t),this.gc();return}}async get(t){return(await this.getStoredObject(t))?.value}async forEach(t){await this.transact("readonly",(e,s,n)=>{let o=c(e.openCursor(),n);o.onsuccess=async i=>{let a=i.target.result;if(a){if(a.key){let u=m(a.value);u!==void 0&&await t(String(a.key),u.value,u.expiryMs,u.storedMs)}a.continue()}else s()}})}async size(){let t=0;return await this.forEach(()=>{t++}),t}async clear(){await this.transact("readwrite",(t,e,s)=>{let n=c(t.clear(),s);n.onsuccess=()=>{e()}})}async asMap(){let t=new Map;return await this.forEach((e,s,n,o)=>{t.set(e,{value:s,expiryMs:n,storedMs:o})}),t}get lastGcMs(){let t=globalThis.localStorage.getItem(this.gcMsStorageKey);if(!t)return 0;let e=Number(t);return isNaN(e)?0:e}set lastGcMs(t){globalThis.localStorage.setItem(this.gcMsStorageKey,String(t))}async gc(){let t=this.lastGcMs;if(!t){this.lastGcMs=Date.now();return}Date.now()<t+this.gcIntervalMs||await this.gcNow()}async gcNow(){console.log(`Starting kvStore GC on ${this.dbName} v${this.dbVersion}...`),this.lastGcMs=Date.now();let t=[];await this.forEach(async(e,s,n)=>{(s===void 0||Date.now()>=n)&&t.push(e)}),t.length&&await this.delete(t),console.log(`Finished kvStore GC on ${this.dbName} v${this.dbVersion} - deleted ${t.length} keys`),this.lastGcMs=Date.now()}asStorageAdapter(){return this}},h=new b(l.dbName),g=class{constructor(t,e=l.expiryMs,s=h){this.key=t;this.store=s;this.defaultExpiryMs=e&&d(e)}defaultExpiryMs;async set(t,e=this.defaultExpiryMs){await this.store.set(this.key,t,e)}async getStoredObject(){return await this.store.getStoredObject(this.key)}async get(){return await this.store.get(this.key)}async delete(){await this.store.delete(this.key)}};function N(r,t,e=h){return t=t&&d(t),new g(r,t,e)}0&&(module.exports={KvStore,KvStoreConfig,KvStoreItem,configureKvStore,kvStore,kvStoreItem});
+"use strict";var T=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var I=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var k=(e,n)=>{for(var a in n)T(e,a,{get:n[a],enumerable:!0})},K=(e,n,a,d)=>{if(n&&typeof n=="object"||typeof n=="function")for(let c of I(n))!_.call(e,c)&&c!==a&&T(e,c,{get:()=>n[c],enumerable:!(d=E(n,c))||d.enumerable});return e};var j=e=>K(T({},"__esModule",{value:!0}),e);var C={};k(C,{KvStoreConfig:()=>p,configureKvStore:()=>R,createKvStore:()=>h,kvStore:()=>x,kvStoreItem:()=>A});module.exports=j(C);function N(e){let n=(e.days??0)*864e5,a=(e.hours??0)*36e5,d=(e.minutes??0)*6e4,c=(e.seconds??0)*1e3,y=e.milliseconds??0;return n+a+d+c+y}function b(e){return typeof e=="number"?e:N(e)}var p={dbName:"KVStore",dbVersion:1,storeName:"kvStore",expiryMs:864e5*30,gcIntervalMs:864e5};function R(e){Object.assign(p,e)}function w(e){if(!(!e||typeof e!="object"||typeof e.key!="string"||e.value===void 0||typeof e.storedMs!="number"||typeof e.expiryMs!="number"||Date.now()>=e.expiryMs))return e}function m(e,n){return e.onerror=a=>{n(a)},e}function h(e,n){let a,d=n?.dbVersion??p.dbVersion,c=n?.storeName??p.storeName,y=n?.defaultExpiryMs?b(n.defaultExpiryMs):p.expiryMs,D=n?.gcIntervalMs?b(n.gcIntervalMs):p.gcIntervalMs,M=`__kvStore:lastGcMs:${e}:v${d}:${c}`;async function P(){return a||(a=await new Promise((t,r)=>{let o=m(indexedDB.open(e,d),r);o.onupgradeneeded=s=>{s.target.result.createObjectStore(c,{keyPath:"key"}).createIndex("key","key",{unique:!0})},o.onsuccess=s=>{let u=s.target.result;t(u)}})),a}async function S(t,r){let o=await P();return await new Promise((s,u)=>{let l=m(o.transaction(c,t),u);l.onabort=g=>{u(g)};let f=l.objectStore(c);r(f,s,u)})}let i={dbName:e,dbVersion:d,storeName:c,defaultExpiryMs:y,gcIntervalMs:D,gcMsStorageKey:M,async set(t,r,o){let s=Date.now(),u={key:t,value:r,storedMs:s,expiryMs:s+b(o??y)};return await S("readwrite",(l,f,g)=>{let O=m(l.put(u),g);O.onsuccess=()=>{f(r),i.gc()}})},async delete(t){return await S("readwrite",(r,o,s)=>{if(r.transaction.oncomplete=()=>{o()},typeof t=="string")m(r.delete(t),s);else for(let u of t)m(r.delete(u),s)})},async getStoredObject(t){let r=await S("readonly",(o,s,u)=>{let l=m(o.get(t),u);l.onsuccess=()=>{s(l.result)}});if(r)try{let o=w(r);if(!o){await i.delete(t),i.gc();return}return o}catch(o){console.error(`Invalid kv value: ${t}=${JSON.stringify(r)}:`,o),await i.delete(t),i.gc();return}},async get(t){return(await i.getStoredObject(t))?.value},async forEach(t){await S("readonly",(r,o,s)=>{let u=m(r.openCursor(),s);u.onsuccess=async l=>{let f=l.target.result;if(f){if(f.key){let g=w(f.value);g!==void 0&&await t(String(f.key),g.value,g.expiryMs,g.storedMs)}f.continue()}else o()}})},async size(){let t=0;return await i.forEach(()=>{t++}),t},async clear(){await S("readwrite",(t,r,o)=>{let s=m(t.clear(),o);s.onsuccess=()=>{r()}})},async asMap(){let t=new Map;return await i.forEach((r,o,s,u)=>{t.set(r,{value:o,expiryMs:s,storedMs:u})}),t},getLastGcMs(){let t=localStorage.getItem(M);if(!t)return 0;let r=Number(t);return isNaN(r)?0:r},setLastGcMs(t){localStorage.setItem(M,String(t))},async gc(){let t=i.getLastGcMs();if(!t){i.setLastGcMs(Date.now());return}Date.now()<t+D||await i.gcNow()},async gcNow(){console.log(`Starting kvStore GC on ${e} v${d}...`),i.setLastGcMs(Date.now());let t=[];await i.forEach(async(r,o,s)=>{(o===void 0||Date.now()>=s)&&t.push(r)}),t.length&&await i.delete(t),console.log(`Finished kvStore GC on ${e} v${d} - deleted ${t.length} keys`),i.setLastGcMs(Date.now())},asStorageAdapter(){return i}};return i}var x=h(p.dbName);function A(e,n,a=x){let d=n&&b(n);return{key:e,defaultExpiryMs:d,store:a,async set(y,D){await a.set(e,y,D??d)},async getStoredObject(){return await a.getStoredObject(e)},async get(){return await a.get(e)},async delete(){await a.delete(e)}}}0&&(module.exports={KvStoreConfig,configureKvStore,createKvStore,kvStore,kvStoreItem});
 //# sourceMappingURL=kvStore.min.cjs.map