idb-repo 1.0.0

package/README.md

@@ -0,0 +1,270 @@
+# idb-repo
+
+Edge KV Storage.
+
+## Overview
+
+This SDK provides a small, dependency-free abstraction over IndexedDB for building fast, reliable key-value stores in browser and edge-like environments. It focuses on predictable behavior, minimal surface area, and performance characteristics suitable for long-lived client applications.
+
+The goal is not to hide IndexedDB, but to make it practical: sane defaults, explicit structure, and a repository pattern that enforces consistency without adding unnecessary complexity.
+
+## Design Principles
+SOLID PRINCIPLES w/
+- **Zero dependencies** — no runtime bloat, no transitive risk
+
+
+## What This Is
+- A thin repository abstraction over IndexedDB
+- A predictable KV interface with typed boundaries
+- A foundation for local-first and offline-capable systems
+
+## What This Is Not
+
+- An ORM
+- A sync engine
+- A framework replacement
+- A polyfill for non-browser runtimes
+
+## Use Cases
+
+- Edge-adjacent web apps (Workers + WebViews)
+- Local-first applications
+- Durable client caches
+- Structured persistence for complex frontends
+- Performance-sensitive UI state storage
+
+## Installation
+
+```bash
+npm install idb-repo
+```
+
+## Usage
+
+### Basic Setup
+
+```typescript
+import { createIndexedDbKV } from "idb-repo";
+
+// Create a KV store instance
+const kv = createIndexedDbKV({
+  dbName: "my-app",      // IndexedDB database name (default: "kv")
+  storeName: "cache",    // Object store name (default: "kv")
+  version: 1,            // Schema version for migrations
+  cacheEntries: 2048     // In-memory LRU cache size (default: 2048)
+});
+```
+
+### Core Operations
+
+#### Put (Store Data)
+
+```typescript
+// Store a string
+await kv.put("key1", "value");
+
+// Store JSON
+await kv.put("user:123", { id: 123, name: "Alice" });
+
+// Store with metadata and expiration
+await kv.put("session:abc", { token: "xyz" }, {
+  metadata: { userId: "123" },
+  expirationTtl: 3600  // expires in 1 hour
+});
+
+// Store ArrayBuffer/binary data
+const buffer = new TextEncoder().encode("binary data");
+await kv.put("binary-key", buffer);
+
+// Store File or Blob objects
+const file = document.querySelector("input[type=file]")!.files![0];
+await kv.put("files/myfile", file);
+```
+
+#### Get (Retrieve Data)
+
+```typescript
+// Get raw value (type determined by stored type)
+const value = await kv.get("key1");
+
+// Get with metadata
+const { value, metadata } = await kv.getWithMetadata("session:abc");
+
+// Helper functions for typed retrieval
+const text = await kvGetText(kv, "key1");
+const json = await kvGetJson(kv, "user:123");
+const buffer = await kvGetArrayBuffer(kv, "binary-key");
+const stream = await kvGetStream(kv, "large-file");
+
+// Get with custom cache TTL (bypasses storage expiration)
+const cached = await kvGetJson(kv, "user:123", 300); // 5 min cache
+```
+
+#### Delete
+
+```typescript
+// Delete a key
+await kv.delete("key1");
+```
+
+#### List (Enumerate Keys)
+
+```typescript
+// List all keys
+const result = await kv.list();
+// { keys: ["key1", "user:123", ...], cursor: "..." }
+
+// List with pagination
+const page = await kv.list({
+  limit: 10,
+  cursor: "previous-cursor"
+});
+
+// List with key prefix filter
+const userKeys = await kv.list({
+  prefix: "user:",
+  limit: 50
+});
+```
+
+#### Close
+
+```typescript
+// Clean up resources
+await kv.close();
+```
+
+### Advanced Usage
+
+#### Metadata and Type Hints
+
+```typescript
+// Store data with custom metadata
+await kv.put("document:42", documentData, {
+  metadata: {
+    userId: "user:123",
+    createdAt: new Date().toISOString(),
+    contentType: "application/json"
+  },
+  expirationTtl: 86400 // 24 hours
+});
+
+// Retrieve and use metadata
+const { value, metadata } = await kv.getWithMetadata("document:42");
+if (metadata?.userId === "user:123") {
+  // Process owned document
+}
+```
+
+#### Performance Patterns
+
+```typescript
+// Batch operations use getAll() internally for ~3-5x better throughput
+const result = await kv.list({ limit: 1000 });
+
+// In-memory LRU cache speeds up repeated reads
+// First read: ~5-10ms (IndexedDB)
+// Subsequent reads of same key: ~0.1ms (memory)
+for (let i = 0; i < 100; i++) {
+  const user = await kvGetJson(kv, "user:123"); // Cache hit after first call
+}
+
+// Readonly transactions for lists are faster than readwrite
+// Expired records are lazily deleted on read (not on list)
+```
+
+#### Storing Files
+
+```typescript
+// Store a File object (from file input)
+const fileInput = document.querySelector("input[type=file]") as HTMLInputElement;
+const file = fileInput.files![0];
+await kv.put(`uploads/${file.name}`, file);
+
+// Store a Blob
+const blob = new Blob(["Hello, world!"], { type: "text/plain" });
+await kv.put("greeting.txt", blob);
+
+// Store binary ArrayBuffer
+const uint8Array = new Uint8Array([1, 2, 3, 4, 5]);
+await kv.put("binary-data", uint8Array);
+
+// Store a ReadableStream (useful for large files or streaming uploads)
+const stream = response.body; // from fetch()
+await kv.put("large-file", stream);
+
+// Retrieve files
+const file = await kv.get("uploads/myfile.pdf") as ArrayBuffer;
+const fileBlob = await kvGetArrayBuffer(kv, "uploads/myfile.pdf");
+
+// Stream large files efficiently
+const largeFile = await kvGetStream(kv, "large-file");
+await largeFile.pipeTo(writableStream);
+
+// List all stored files with metadata
+const result = await kv.list({ prefix: "uploads/" });
+for (const file of result.keys) {
+  console.log(`${file.name} - uploaded at ${file.metadata?.uploadedAt}`);
+}
+```
+
+#### Building Local-First Features
+
+```typescript
+// Store user preferences
+await kv.put("settings:display", {
+  theme: "dark",
+  fontSize: 14,
+  sidebarCollapsed: true
+});
+
+// Cache API responses
+await kv.put("posts:feed", postsData, {
+  expirationTtl: 300, // 5 minute cache
+  metadata: { fetchedAt: Date.now() }
+});
+
+// Store offline queue
+await kv.put(`pending:create:${uuid()}`, actionPayload, {
+  metadata: { type: "create", priority: 1 }
+});
+
+// Enumerate pending actions
+const { keys } = await kv.list({ prefix: "pending:" });
+for (const key of keys) {
+  const action = await kvGetJson(kv, key);
+  await syncAction(action);
+}
+```
+
+## API Reference
+
+### `IndexedDbKV` Class
+
+- **`constructor(opts?)`** — Create a new KV store instance
+  - `dbName` (string): IndexedDB database name
+  - `storeName` (string): Object store name
+  - `version` (number): Schema version
+  - `cacheEntries` (number): LRU cache size
+
+- **`get(key, options?)`** → Promise — Retrieve a value
+- **`getWithMetadata(key, options?)`** → Promise — Retrieve value and metadata
+- **`put(key, value, options?)`** → Promise — Store a value
+- **`delete(key)`** → Promise — Delete a key
+- **`list(options?)`** → Promise — Enumerate keys with pagination
+- **`close()`** → Promise — Close database connection
+
+### Helper Functions
+
+- **`kvGetText(kv, key, cacheTtl?)`** — Get value as string
+- **`kvGetJson(kv, key, cacheTtl?)`** — Get value as JSON
+- **`kvGetArrayBuffer(kv, key, cacheTtl?)`** — Get value as ArrayBuffer
+- **`kvGetStream(kv, key, cacheTtl?)`** — Get value as ReadableStream
+
+## Status
+
+This project is intentionally small and opinionated. APIs are stable where exposed, but evolution is expected as real-world constraints surface.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * IndexedDB KV Storage - A performant KV storage implementation using IndexedDB
+ *
+ * @example
+ * ```ts
+ * import { createIndexedDbKV } from '@indexeddb-kv/storage';
+ *
+ * const kv = await createIndexedDbKV({ dbName: 'my-app' });
+ * await kv.put('key', 'value');
+ * const value = await kv.get('key');
+ * ```
+ */
+export { IndexedDbKV, createIndexedDbKV, kvGetText, kvGetJson, kvGetArrayBuffer, kvGetStream, } from "./src/lib";
+export type { KVGetOptions, KVPutOptions, KVListOptions, KVListKey, KVListResult, KVNamespace, } from "./src/types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACH,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,WAAW,GACd,MAAM,WAAW,CAAC;AAGnB,YAAY,EACR,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,SAAS,EACT,YAAY,EACZ,WAAW,GACd,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+class S{cfg;dbPromise=null;constructor(G){this.cfg=G}get db(){if(!this.dbPromise)this.dbPromise=this.open();return this.dbPromise}async close(){if(!this.dbPromise)return;try{(await this.dbPromise).close()}finally{this.dbPromise=null}}open(){let{dbName:G,version:X,storeName:Q}=this.cfg;return new Promise((Z,Y)=>{let _=indexedDB.open(G,X);_.onupgradeneeded=()=>{let P=_.result;if(!P.objectStoreNames.contains(Q)){let $=P.createObjectStore(Q,{keyPath:"key"});$.createIndex("key","key",{unique:!0}),$.createIndex("expiresAt","expiresAt",{unique:!1})}else{let $=_.transaction.objectStore(Q);if(!$.indexNames.contains("expiresAt"))$.createIndex("expiresAt","expiresAt",{unique:!1});if(!$.indexNames.contains("key"))$.createIndex("key","key",{unique:!0})}},_.onsuccess=()=>{let P=_.result;P.onversionchange=()=>{try{P.close()}catch{}},Z(P)},_.onerror=()=>Y(_.error??new Error("Failed to open IndexedDB")),_.onblocked=()=>{Y(new Error("IndexedDB open blocked (another context has the DB open during upgrade)"))}})}}function K(G){return Math.floor(G/1000)}function R(G){return Math.floor(G*1000)}function J(){return Date.now()}class V{max;map=new Map;constructor(G){this.max=Math.max(0,G|0)}get(G){let X=this.map.get(G);if(!X)return null;if(X.expiresAt<=J())return this.map.delete(G),null;return{value:X.value,meta:X.meta}}set(G,X,Q,Z){if(this.max<=0)return;let Y=J()+Math.max(0,Z)*1000;this.map.set(G,{expiresAt:Y,value:X,meta:Q});while(this.map.size>this.max){let _=this.map.keys().next().value;if(_===void 0)break;this.map.delete(_)}}delete(G){this.map.delete(G)}clear(){this.map.clear()}}function q(G){let X=JSON.stringify(G);return btoa(unescape(encodeURIComponent(X))).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/g,"")}function f(G){try{let X=G.replace(/-/g,"+").replace(/_/g,"/")+"===".slice((G.length+3)%4),Q=decodeURIComponent(escape(atob(X))),Z=JSON.parse(Q);if(!Z||Z.v!==1||typeof Z.prefix!=="string")return null;if(Z.after!==null&&typeof Z.after!=="string")return null;return Z}catch{return null}}function j(G){return!!G&&typeof G==="object"&&"buffer"in G&&G.buffer instanceof ArrayBuffer}function B(G){if(typeof G!=="string"||G.length===0)throw new TypeError("KV key must be a non-empty string")}function n(G){if(typeof G==="string")return{encoding:"text",stored:G};if(G instanceof Blob)return{encoding:"binary",stored:G};if(G instanceof ArrayBuffer)return{encoding:"binary",stored:new Blob([G])};if(j(G))return{encoding:"binary",stored:new Blob([G.buffer.slice(0)])};if(G instanceof ReadableStream)return null;return{encoding:"clone",stored:structuredClone(G)}}async function w(G){let X=n(G);if(X!==null)return X;return{encoding:"binary",stored:await c(G)}}async function c(G){let X=G.getReader(),Q=[];try{while(!0){let{value:Z,done:Y}=await X.read();if(Y)break;if(Z)Q.push(Z)}}finally{try{X.releaseLock()}catch{}}return new Blob(Q)}function m(G,X){let Q=X??"text";if(G.encoding==="text"){let Y=G.value;if(Q==="text")return Y;if(Q==="json")return JSON.parse(Y);if(Q==="arrayBuffer")return new TextEncoder().encode(Y).buffer;return new Blob([Y]).stream()}if(G.encoding==="json"){let Y=G.value;if(Q==="json")return JSON.parse(Y);if(Q==="text")return Y;if(Q==="arrayBuffer")return new TextEncoder().encode(Y).buffer;return new Blob([Y]).stream()}if(G.encoding==="clone"){let Y=G.value;if(Q==="json")return Y;let _=JSON.stringify(Y);if(_===void 0)throw new TypeError("Stored value cannot be represented as JSON text");if(Q==="text")return _;if(Q==="arrayBuffer")return new TextEncoder().encode(_).buffer;return new Blob([_]).stream()}let Z=G.value;if(Q==="stream")return Z.stream();if(Q==="arrayBuffer")return Z;if(Q==="json")return Z;return Z}async function T(G){return await G.text()}async function h(G){return await G.arrayBuffer()}async function x(G){let X=await G.text();return JSON.parse(X)}function N(G){return new Promise((X,Q)=>{G.onsuccess=()=>X(G.result),G.onerror=()=>Q(G.error??new Error("IndexedDB request failed"))})}function M(G){return new Promise((X,Q)=>{G.oncomplete=()=>X(),G.onabort=()=>Q(G.error??new Error("IndexedDB transaction aborted")),G.onerror=()=>Q(G.error??new Error("IndexedDB transaction failed"))})}function b(G){if(!G)return null;if(typeof G.expirationTtl==="number"){let X=Math.max(0,G.expirationTtl)*1000;return J()+X}if(typeof G.expiration==="number")return R(G.expiration);return null}function v(G){return G.expiresAt!==null&&G.expiresAt<=J()}class D{conn;storeName;cache;constructor(G){let X=G?.dbName??"kv";this.storeName=G?.storeName??"kv";let Q=G?.version??1;this.conn=new S({dbName:X,storeName:this.storeName,version:Q}),this.cache=new V(G?.cacheEntries??2048)}invalidateCache(G){this.cache.delete(`${G}::text`),this.cache.delete(`${G}::json`),this.cache.delete(`${G}::arrayBuffer`),this.cache.delete(`${G}::stream`)}async get(G,X){let{value:Q}=await this.getWithMetadata(G,X);return Q}async getWithMetadata(G,X){B(G);let Q=X?.type??"text",Z=X?.cacheTtl??0,Y=Z>0?`${G}::${Q}`:null;if(Y){let F=this.cache.get(Y);if(F)return{value:F.value,metadata:F.meta}}let $=(await this.conn.db).transaction(this.storeName,"readonly").objectStore(this.storeName),W=await N($.get(G));if(!W)return{value:null,metadata:null};if(v(W))return this.delete(G),{value:null,metadata:null};let H=m(W,Q);if(W.encoding==="binary"){let F=H;if(Q==="stream")H=F.stream()??null;else if(Q==="arrayBuffer")H=await h(F);else if(Q==="json")H=await x(F);else H=await T(F)}let O=W.metadata??null;if(Y)this.cache.set(Y,H,O,Z);return{value:H,metadata:O}}async put(G,X,Q){B(G);let{encoding:Z,stored:Y}=await w(X),_=b(Q),$=(await this.conn.db).transaction(this.storeName,"readwrite"),W=$.objectStore(this.storeName),H=J(),O={key:G,value:Y,encoding:Z,expiresAt:_,metadata:Q?.metadata??null,createdAt:H,updatedAt:H};W.put(O),this.invalidateCache(G),await M($)}async delete(G){B(G);let Q=(await this.conn.db).transaction(this.storeName,"readwrite");Q.objectStore(this.storeName).delete(G),this.invalidateCache(G),await M(Q)}async list(G){let X=G?.prefix??"",Q=Math.min(Math.max(1,G?.limit??1000),1e4),Z=G?.cursor??null,Y=null;if(Z){let L=f(Z);if(L&&L.prefix===X)Y=L.after}let $=(await this.conn.db).transaction(this.storeName,"readonly").objectStore(this.storeName),W=X,H=X+"￿",O=IDBKeyRange.bound(W,H,!1,!1),F=await N($.getAll(O)),U=[],g=!0,A=null,i=J(),C=Y!==null?F.findIndex((L)=>L.key>Y):0,E=C<0?F.length:C;for(let L=E;L<F.length&&U.length<Q;L++){let z=F[L];if(!z)continue;if(z.expiresAt&&z.expiresAt<=i)continue;let I={name:z.key};if(z.expiresAt)I.expiration=K(z.expiresAt);if(z.metadata)I.metadata=z.metadata;U.push(I),A=z.key}if(U.length>=Q&&E+U.length<F.length)g=!1;if(!g&&A!==null){let L=q({v:1,prefix:X,after:A});return{keys:U,list_complete:!1,cursor:L}}return{keys:U,list_complete:!0}}async close(){await this.conn.close(),this.cache.clear()}}function k(G){return new D(G)}async function u(G,X,Q){return await G.get(X,{type:"text",cacheTtl:Q})}async function p(G,X,Q){return await G.get(X,{type:"json",cacheTtl:Q})}async function y(G,X,Q){return await G.get(X,{type:"arrayBuffer",cacheTtl:Q})}async function d(G,X,Q){return await G.get(X,{type:"stream",cacheTtl:Q})}export{u as kvGetText,d as kvGetStream,p as kvGetJson,y as kvGetArrayBuffer,k as createIndexedDbKV,D as IndexedDbKV};

package/dist/src/connection.d.ts

@@ -0,0 +1,36 @@
+/**
+ * IndexedDB connection management
+ */
+/**
+ * Configuration for opening an IndexedDB database
+ */
+type OpenConfig = {
+    dbName: string;
+    storeName: string;
+    version: number;
+};
+/**
+ * Manages lifecycle of an IndexedDB connection
+ * - Lazy initialization (opens on first access)
+ * - Version change handling
+ * - Automatic schema creation/migration
+ */
+export declare class IndexedDbConnection {
+    private cfg;
+    private dbPromise;
+    constructor(cfg: OpenConfig);
+    /**
+     * Get or open the database
+     */
+    get db(): Promise<IDBDatabase>;
+    /**
+     * Close the database connection
+     */
+    close(): Promise<void>;
+    /**
+     * Open the database with automatic schema creation/migration
+     */
+    private open;
+}
+export {};
+//# sourceMappingURL=connection.d.ts.map

package/dist/src/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/connection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,KAAK,UAAU,GAAG;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,SAAS,CAAqC;gBAE1C,GAAG,EAAE,UAAU;IAI3B;;OAEG;IACH,IAAI,EAAE,IAAI,OAAO,CAAC,WAAW,CAAC,CAG7B;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;OAEG;IACH,OAAO,CAAC,IAAI;CA0Cf"}

package/dist/src/internal/cache.d.ts

@@ -0,0 +1,38 @@
+/**
+ * TinyLRU: Small, best-effort, TTL-based in-memory cache for KV reads
+ * - Keeps decoded values per (key, type)
+ * - Eviction: simple Map insertion order (best-effort)
+ * - TTL: automatic expiration on access
+ */
+/**
+ * Small, best-effort, TTL-based in-memory cache for reads
+ * Preserves "no recency refresh" optimization: doesn't refresh cache entry on hit
+ * to avoid 2 Map operations per cache hit. LRU eviction is best-effort anyway,
+ * and TTL makes staleness acceptable.
+ */
+export declare class TinyLRU {
+    private max;
+    private map;
+    constructor(maxEntries: number);
+    /**
+     * Get a value from cache
+     * @returns Cached value and metadata, or null if not found or expired
+     */
+    get(k: string): {
+        value: any;
+        meta: any;
+    } | null;
+    /**
+     * Set a value in cache with TTL
+     */
+    set(k: string, value: any, meta: any, ttlSeconds: number): void;
+    /**
+     * Delete a specific key from cache
+     */
+    delete(k: string): void;
+    /**
+     * Clear all entries from cache
+     */
+    clear(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/src/internal/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/internal/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;GAKG;AACH,qBAAa,OAAO;IAChB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,GAAG,CAAmE;gBAElE,UAAU,EAAE,MAAM;IAI9B;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,GAAG,IAAI;IAYhD;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAY/D;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGhB"}

package/dist/src/internal/cursor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Cursor encoding/decoding for list pagination
+ */
+/**
+ * Internal structure for list pagination cursor
+ */
+export type InternalListCursor = {
+    v: 1;
+    prefix: string;
+    after: string | null;
+};
+/**
+ * Encode a cursor to a base64url string
+ */
+export declare function encodeCursor(c: InternalListCursor): string;
+/**
+ * Decode a cursor from a base64url string
+ * @returns Decoded cursor or null if invalid
+ */
+export declare function decodeCursor(cursor: string): InternalListCursor | null;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/src/internal/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/internal/cursor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,CAAC,EAAE,CAAC,CAAC;IACL,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAK1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAWtE"}

package/dist/src/internal/idb-utils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * IndexedDB promise wrappers and utilities
+ */
+/**
+ * Convert an IDBRequest to a Promise
+ */
+export declare function promisifyRequest<T>(req: IDBRequest<T>): Promise<T>;
+/**
+ * Wait for an IDBTransaction to complete
+ */
+export declare function waitTx(tx: IDBTransaction): Promise<void>;
+//# sourceMappingURL=idb-utils.d.ts.map

package/dist/src/internal/idb-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb-utils.d.ts","sourceRoot":"","sources":["../../../src/internal/idb-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAKlE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxD"}

package/dist/src/internal/ttl.d.ts

@@ -0,0 +1,14 @@
+/**
+ * TTL utilities for KV storage
+ */
+import type { KVPutOptions, StoredRecord } from "../types";
+/**
+ * Compute expiration timestamp in milliseconds from KV put options
+ * @returns Expiration time in ms since epoch, or null if no expiration set
+ */
+export declare function computeExpiresAtMs(options?: KVPutOptions): number | null;
+/**
+ * Check if a stored record has expired
+ */
+export declare function isExpired(rec: StoredRecord): boolean;
+//# sourceMappingURL=ttl.d.ts.map

package/dist/src/internal/ttl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.d.ts","sourceRoot":"","sources":["../../../src/internal/ttl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG3D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAUxE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAEpD"}

package/dist/src/internal/validation.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Type guards and validation utilities for KV storage
+ */
+/**
+ * Type guard to check if a value is an ArrayBufferView (TypedArray, DataView, etc.)
+ */
+export declare function isArrayBufferView(v: unknown): v is ArrayBufferView;
+/**
+ * Validate and assert that a key is a non-empty string
+ * @throws {TypeError} if key is invalid
+ */
+export declare function assertKey(key: string): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/internal/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/internal/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,eAAe,CAElE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI3C"}

package/dist/src/internal/value-codec.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Value encoding/decoding for KV storage
+ * Handles multiple formats: text, json, structured clone, and binary
+ */
+import type { KVGetType, KVValue, StoredEncoding, StoredRecord } from "../types";
+/**
+ * Sync path for encoding values - optimized for common cases like strings
+ * @returns Encoded value or null if async handling required (ReadableStream)
+ */
+export declare function normalizePutValueSync(value: KVValue): {
+    encoding: StoredEncoding;
+    stored: unknown;
+} | null;
+/**
+ * Async wrapper for encoding values
+ * Handles all value types including ReadableStream
+ */
+export declare function normalizePutValue(value: KVValue): Promise<{
+    encoding: StoredEncoding;
+    stored: unknown;
+}>;
+/**
+ * Decode a stored record to the requested type
+ * Returns decoded value or Blob sentinel for binary data requiring async conversion
+ */
+export declare function decodeValue(rec: StoredRecord, type: KVGetType | undefined): string | ArrayBuffer | ReadableStream<Uint8Array> | unknown;
+/**
+ * Convert Blob to text
+ */
+export declare function blobToText(blob: Blob): Promise<string>;
+/**
+ * Convert Blob to ArrayBuffer
+ */
+export declare function blobToArrayBuffer(blob: Blob): Promise<ArrayBuffer>;
+/**
+ * Convert Blob to JSON (parse as UTF-8 text then JSON)
+ */
+export declare function blobToJson(blob: Blob): Promise<unknown>;
+//# sourceMappingURL=value-codec.d.ts.map

package/dist/src/internal/value-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-codec.d.ts","sourceRoot":"","sources":["../../../src/internal/value-codec.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGjF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAgB1G;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAQ9G;AAwBD;;;GAGG;AACH,wBAAgB,WAAW,CACvB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,SAAS,GAAG,SAAS,GAC5B,MAAM,GAAG,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAmD7D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAExE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAG7D"}

package/dist/src/kv.d.ts

@@ -0,0 +1,34 @@
+/**
+ * IndexedDbKV: High-performance KV over IndexedDB
+ */
+import type { KVGetOptions, KVListOptions, KVListResult, KVNamespace, KVPutOptions, KVValue } from "./types";
+/**
+ * High-performance KV implementation over IndexedDB
+ */
+export declare class IndexedDbKV implements KVNamespace {
+    private conn;
+    private storeName;
+    private cache;
+    constructor(opts?: {
+        dbName?: string;
+        storeName?: string;
+        version?: number;
+        cacheEntries?: number;
+    });
+    private invalidateCache;
+    get(key: string, options?: KVGetOptions): Promise<string | ArrayBuffer | ReadableStream<Uint8Array> | unknown | null>;
+    getWithMetadata<T = unknown>(key: string, options?: KVGetOptions): Promise<{
+        value: string | ArrayBuffer | ReadableStream<Uint8Array> | unknown | null;
+        metadata: T | null;
+    }>;
+    put(key: string, value: KVValue, options?: KVPutOptions): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(options?: KVListOptions): Promise<KVListResult>;
+    close(): Promise<void>;
+}
+export declare function createIndexedDbKV(opts?: ConstructorParameters<typeof IndexedDbKV>[0]): KVNamespace;
+export declare function kvGetText(kv: KVNamespace, key: string, cacheTtl?: number): Promise<string | null>;
+export declare function kvGetJson<T>(kv: KVNamespace, key: string, cacheTtl?: number): Promise<T | null>;
+export declare function kvGetArrayBuffer(kv: KVNamespace, key: string, cacheTtl?: number): Promise<ArrayBuffer | null>;
+export declare function kvGetStream(kv: KVNamespace, key: string, cacheTtl?: number): Promise<ReadableStream<Uint8Array> | null>;
+//# sourceMappingURL=kv.d.ts.map

package/dist/src/kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../../src/kv.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAa,WAAW,EAAE,YAAY,EAAE,OAAO,EAAgB,MAAM,SAAS,CAAC;AAUtI;;GAEG;AACH,qBAAa,WAAY,YAAW,WAAW;IAC3C,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAU;gBAEX,IAAI,CAAC,EAAE;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB;IAQD,OAAO,CAAC,eAAe;IAOjB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;IAKrH,eAAe,CAAC,CAAC,GAAG,OAAO,EAC7B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,YAAY,GACvB,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IA8CvG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BvE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlC,IAAI,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAyDpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAElG;AAED,wBAAsB,SAAS,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEvG;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAErG;AAED,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAEnH;AAED,wBAAsB,WAAW,CAC7B,EAAE,EAAE,WAAW,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAE5C"}

package/dist/src/lib-wrapper.d.ts

@@ -0,0 +1,25 @@
+import type { KVNamespace } from "./types";
+import { IndexedDbKV } from "./lib";
+type KVMethodName = 'get' | 'getWithMetadata' | 'put' | 'delete' | 'list';
+type WrappedKV = KVNamespace & {
+    readonly __original?: IndexedDbKV;
+};
+type WrapperOptions = {
+    log?: boolean | ((method: KVMethodName, ...args: any[]) => void);
+    time?: boolean;
+    prefix?: string;
+    validateKeys?: boolean;
+    retry?: {
+        attempts: number;
+        delayMs?: number;
+    };
+    onError?: (method: KVMethodName, error: unknown) => void;
+    metrics?: (method: KVMethodName, durationMs: number, success: boolean) => void;
+};
+/**
+ * Higher-order function that wraps an existing KVNamespace instance
+ * and adds configurable cross-cutting behavior.
+ */
+export declare function withKVFeatures(base: KVNamespace, opts?: WrapperOptions): WrappedKV;
+export {};
+//# sourceMappingURL=lib-wrapper.d.ts.map

package/dist/src/lib-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib-wrapper.d.ts","sourceRoot":"","sources":["../../src/lib-wrapper.ts"],"names":[],"mappings":"AAyDA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAC,WAAW,EAAC,MAAM,OAAO,CAAC;AAElC,KAAK,YAAY,GACX,KAAK,GACL,iBAAiB,GACjB,KAAK,GACL,QAAQ,GACR,MAAM,CAAC;AAEb,KAAK,SAAS,GAAG,WAAW,GAAG;IAE3B,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC;CACrC,CAAC;AAEF,KAAK,cAAc,GAAG;IAClB,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC;IACjE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACzD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CAClF,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAC1B,IAAI,EAAE,WAAW,EACjB,IAAI,GAAE,cAAmB,GAC1B,SAAS,CAoGX"}

package/dist/src/lib.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Public API facade for IndexedDB KV storage
+ * Re-exports main classes and functions for backward compatibility
+ */
+export { IndexedDbKV, createIndexedDbKV, kvGetText, kvGetJson, kvGetArrayBuffer, kvGetStream, } from "./kv";
+//# sourceMappingURL=lib.d.ts.map

package/dist/src/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/lib.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,WAAW,GACd,MAAM,MAAM,CAAC"}

package/dist/src/time-utils.d.ts

@@ -0,0 +1,4 @@
+export declare function toEpochSeconds(msEpoch: number): number;
+export declare function fromEpochSeconds(sec: number): number;
+export declare function nowMs(): number;
+//# sourceMappingURL=time-utils.d.ts.map

package/dist/src/time-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-utils.d.ts","sourceRoot":"","sources":["../../src/time-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAGD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,KAAK,IAAI,MAAM,CAE9B"}

package/dist/src/types.d.ts

@@ -0,0 +1,57 @@
+export type KVGetType = "text" | "json" | "arrayBuffer" | "stream";
+export type KVValue = string | ArrayBuffer | ArrayBufferView | Blob | ReadableStream<Uint8Array> | unknown;
+export interface KVGetOptions {
+    type?: KVGetType;
+    cacheTtl?: number;
+}
+export interface KVPutOptions {
+    expiration?: number;
+    expirationTtl?: number;
+    metadata?: unknown;
+}
+export interface KVListOptions {
+    prefix?: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface KVListKey {
+    name: string;
+    expiration?: number;
+    metadata?: unknown;
+}
+export interface KVListResult {
+    keys: KVListKey[];
+    list_complete: boolean;
+    cursor?: string;
+}
+export interface KVNamespace {
+    get(key: string, options?: KVGetOptions): Promise<string | ArrayBuffer | ReadableStream<Uint8Array> | unknown | null>;
+    getWithMetadata<T = unknown>(key: string, options?: KVGetOptions): Promise<{
+        value: string | ArrayBuffer | ReadableStream<Uint8Array> | unknown | null;
+        metadata: T | null;
+    }>;
+    put(key: string, value: KVValue, options?: KVPutOptions): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(options?: KVListOptions): Promise<KVListResult>;
+}
+export type StoredEncoding = "text" | "json" | "clone" | "binary";
+export type StoredRecord = {
+    key: string;
+    value: unknown;
+    encoding: StoredEncoding;
+    expiresAt: number | null;
+    metadata: unknown | null;
+    createdAt: number;
+    updatedAt: number;
+};
+export type InternalListCursor = {
+    v: 1;
+    prefix: string;
+    after: string | null;
+};
+export type OpenConfig = {
+    dbName: string;
+    storeName: string;
+    version: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAC;AACnE,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC;AAG3G,MAAM,WAAW,YAAY;IACzB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IACtH,eAAe,CAAC,CAAC,GAAG,OAAO,EACvB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,YAAY,GACvB,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAE9G,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACxD;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAElE,MAAM,MAAM,YAAY,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IAMZ,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;IAEzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAEzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,CAAC,EAAE,CAAC,CAAC;IAEL,MAAM,EAAE,MAAM,CAAC;IAEf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/dist/src/web-container.d.ts

@@ -0,0 +1,25 @@
+export type WebContainerOptions = {
+    headless?: boolean;
+};
+export declare class WebContainer {
+    private browser;
+    private page;
+    /** Becomes true once WebKit is launched and the page is initialized. */
+    ready: boolean;
+    /** Thin IndexedDB KV facade (string keys, JSON-serializable values). */
+    indexedDB: {
+        get<T = unknown>(store: string, key: string): Promise<T | undefined>;
+        set<T = unknown>(store: string, key: string, value: T): Promise<void>;
+        del(store: string, key: string): Promise<void>;
+    };
+    private constructor();
+    static create(opts?: WebContainerOptions): Promise<WebContainer>;
+    private init;
+    close(): Promise<void>;
+}
+declare global {
+    var reqToPromise: (req: IDBRequest) => Promise<any>;
+    var txDone: (tx: IDBTransaction) => Promise<any>;
+    var openDB: (name: string, version: number, stores: string[]) => Promise<IDBDatabase>;
+}
+//# sourceMappingURL=web-container.d.ts.map

package/dist/src/web-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-container.d.ts","sourceRoot":"","sources":["../../src/web-container.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CAKtB,CAAC;AAEF,qBAAa,YAAY;IACrB,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,IAAI,CAAQ;IAEpB,wEAAwE;IACjE,KAAK,UAAS;IAErB,wEAAwE;IACjE,SAAS,EAAG;QACf,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;QACrE,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACtE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAClD,CAAC;IAEF,OAAO;WAEM,MAAM,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC;YAM5D,IAAI;IA4GZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAY/B;AAGD,OAAO,CAAC,MAAM,CAAC;IAEX,IAAI,YAAY,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpD,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE,cAAc,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAEjD,IAAI,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CACzF"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "idb-repo",
+  "version": "1.0.0",
+  "description": "A high-performance IndexedDB-based key-value storage implementation with caching, TTL support, and full TypeScript support",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun build ./index.ts --target browser --outdir ./dist --minify && tsc --emitDeclarationOnly -p tsconfig.build.json"
+  },
+  "keywords": [
+    "indexeddb",
+    "kv-storage",
+    "storage",
+    "cache",
+    "typescript",
+    "browser",
+    "performance"
+  ],
+  "author": "github.com/geoffsee",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/geoffsee/idb-kv.git"
+  },
+  "bugs": {
+    "url": "https://github.com/geoffsee/idb-kv/issues"
+  },
+  "homepage": "https://github.com/geoffsee/idb-kv#readme",
+  "devDependencies": {
+    "@types/bun": "latest",
+    "idb-keyval": "^6.2.2",
+    "playwright": "^1.58.2"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}