holosphere 2.0.0-alpha11 → 2.0.0-alpha13

package/dist/indexeddb-storage-CZK5A7XH.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-V8EHMYEY.cjs");class t extends e.PersistentStorage{constructor(){super(),this.db=null,this.dbName="",this.storeName="events"}async init(e){this.dbName=`holosphere_${e}`;try{await this._openDatabase()}catch(t){if("VersionError"!==t.name)throw t;console.warn(`[IndexedDBStorage] Version conflict detected for ${this.dbName}, recreating database...`),await this._deleteDatabase(),await this._openDatabase()}}async _openDatabase(){return new Promise((e,t)=>{const r=indexedDB.open(this.dbName,1);r.onerror=()=>t(r.error),r.onsuccess=()=>{this.db=r.result,e(void 0)},r.onupgradeneeded=e=>{const t=e.target.result;if(!t.objectStoreNames.contains(this.storeName)){t.createObjectStore(this.storeName,{keyPath:"key"}).createIndex("key","key",{unique:!1})}}})}async _deleteDatabase(){return new Promise((e,t)=>{const r=indexedDB.deleteDatabase(this.dbName);r.onsuccess=()=>e(void 0),r.onerror=()=>t(r.error),r.onblocked=()=>{console.warn(`[IndexedDBStorage] Database deletion blocked for ${this.dbName}`),e(void 0)}})}async put(e,t){return new Promise((r,s)=>{if(!this.db)return void s(new Error("Database not initialized"));const o=this.db.transaction([this.storeName],"readwrite").objectStore(this.storeName).put({key:e,event:t,timestamp:Date.now()});o.onsuccess=()=>r(void 0),o.onerror=()=>s(o.error)})}async get(e){return new Promise((t,r)=>{if(!this.db)return void r(new Error("Database not initialized"));const s=this.db.transaction([this.storeName],"readonly").objectStore(this.storeName).get(e);s.onsuccess=()=>{const e=s.result;t(e?e.event:null)},s.onerror=()=>r(s.error)})}async getAll(e){return new Promise((t,r)=>{if(!this.db)return void r(new Error("Database not initialized"));const s=this.db.transaction([this.storeName],"readonly").objectStore(this.storeName),o=[];let n;if(e){const t=IDBKeyRange.bound(e,e+"￿",!1,!1);n=s.openCursor(t)}else n=s.openCursor();n.onsuccess=e=>{const r=e.target.result;r?(o.push(r.value.event),r.continue()):t(o)},n.onerror=()=>r(n.error)})}async delete(e){return new Promise((t,r)=>{if(!this.db)return void r(new Error("Database not initialized"));const s=this.db.transaction([this.storeName],"readwrite").objectStore(this.storeName).delete(e);s.onsuccess=()=>t(void 0),s.onerror=()=>r(s.error)})}async clear(){return new Promise((e,t)=>{if(!this.db)return void t(new Error("Database not initialized"));const r=this.db.transaction([this.storeName],"readwrite").objectStore(this.storeName).clear();r.onsuccess=()=>e(void 0),r.onerror=()=>t(r.error)})}async close(){this.db&&(this.db.close(),this.db=null)}}exports.IndexedDBStorage=t;
+//# sourceMappingURL=indexeddb-storage-CZK5A7XH.cjs.map

package/dist/indexeddb-storage-CZK5A7XH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb-storage-CZK5A7XH.cjs","sources":["../src/storage/indexeddb-storage.js"],"sourcesContent":["/**\n * @fileoverview IndexedDB storage adapter for browsers.\n *\n * Provides persistent storage with good performance using browser IndexedDB.\n * Uses B-tree indexes for efficient prefix queries.\n *\n * @module storage/indexeddb-storage\n */\n\nimport { PersistentStorage } from './persistent-storage.js';\n\n/**\n * IndexedDB storage adapter for browsers.\n *\n * Provides high-performance persistent storage using IndexedDB with efficient prefix queries.\n *\n * @class IndexedDBStorage\n * @extends PersistentStorage\n * @example\n * const storage = new IndexedDBStorage();\n * await storage.init('myapp');\n * await storage.put('key1', { id: 'event1', content: 'test' });\n */\nexport class IndexedDBStorage extends PersistentStorage {\n  /**\n   * Create a new IndexedDBStorage instance.\n   */\n  constructor() {\n    super();\n    /** @type {IDBDatabase|null} */\n    this.db = null;\n    /** @type {string} */\n    this.dbName = '';\n    /** @type {string} */\n    this.storeName = 'events';\n  }\n\n  /**\n   * Initialize storage with namespace.\n   *\n   * Creates or opens the IndexedDB database and object store.\n   * Handles version conflicts by deleting and recreating the database if needed.\n   *\n   * @param {string} namespace - Storage namespace\n   * @returns {Promise<void>}\n   */\n  async init(namespace) {\n    this.dbName = `holosphere_${namespace}`;\n\n    try {\n      await this._openDatabase();\n    } catch (error) {\n      // Handle version conflict by deleting and recreating the database\n      if (error.name === 'VersionError') {\n        console.warn(`[IndexedDBStorage] Version conflict detected for ${this.dbName}, recreating database...`);\n        await this._deleteDatabase();\n        await this._openDatabase();\n      } else {\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Open the IndexedDB database.\n   *\n   * @returns {Promise<void>}\n   * @private\n   */\n  async _openDatabase() {\n    return new Promise((resolve, reject) => {\n      const request = indexedDB.open(this.dbName, 1);\n\n      request.onerror = () => reject(request.error);\n      request.onsuccess = () => {\n        this.db = request.result;\n        resolve(undefined);\n      };\n\n      request.onupgradeneeded = (event) => {\n        const target = /** @type {IDBOpenDBRequest} */ (event.target);\n        const db = target.result;\n\n        // Create object store if it doesn't exist\n        if (!db.objectStoreNames.contains(this.storeName)) {\n          const objectStore = db.createObjectStore(this.storeName, { keyPath: 'key' });\n          // Create index for prefix queries\n          objectStore.createIndex('key', 'key', { unique: false });\n        }\n      };\n    });\n  }\n\n  /**\n   * Delete the IndexedDB database.\n   *\n   * @returns {Promise<void>}\n   * @private\n   */\n  async _deleteDatabase() {\n    return new Promise((resolve, reject) => {\n      const request = indexedDB.deleteDatabase(this.dbName);\n      request.onsuccess = () => resolve(undefined);\n      request.onerror = () => reject(request.error);\n      request.onblocked = () => {\n        console.warn(`[IndexedDBStorage] Database deletion blocked for ${this.dbName}`);\n        // Still resolve - the next open attempt will handle it\n        resolve(undefined);\n      };\n    });\n  }\n\n  /**\n   * Store an event.\n   *\n   * @param {string} key - Storage key\n   * @param {Object} event - Event data\n   * @returns {Promise<void>}\n   */\n  async put(key, event) {\n    return new Promise((resolve, reject) => {\n      if (!this.db) {\n        reject(new Error('Database not initialized'));\n        return;\n      }\n      const transaction = this.db.transaction([this.storeName], 'readwrite');\n      const objectStore = transaction.objectStore(this.storeName);\n\n      const request = objectStore.put({ key, event, timestamp: Date.now() });\n\n      request.onsuccess = () => resolve(undefined);\n      request.onerror = () => reject(request.error);\n    });\n  }\n\n  /**\n   * Retrieve an event.\n   *\n   * @param {string} key - Storage key\n   * @returns {Promise<Object|null>} Event data or null\n   */\n  async get(key) {\n    return new Promise((resolve, reject) => {\n      if (!this.db) {\n        reject(new Error('Database not initialized'));\n        return;\n      }\n      const transaction = this.db.transaction([this.storeName], 'readonly');\n      const objectStore = transaction.objectStore(this.storeName);\n\n      const request = objectStore.get(key);\n\n      request.onsuccess = () => {\n        const result = request.result;\n        resolve(result ? result.event : null);\n      };\n      request.onerror = () => reject(request.error);\n    });\n  }\n\n  /**\n   * Retrieve all events matching a prefix.\n   *\n   * Uses IDBKeyRange for efficient B-tree index queries.\n   *\n   * @param {string} prefix - Key prefix to match\n   * @returns {Promise<any[]>} Array of matching events\n   */\n  async getAll(prefix) {\n    return new Promise((resolve, reject) => {\n      if (!this.db) {\n        reject(new Error('Database not initialized'));\n        return;\n      }\n      const transaction = this.db.transaction([this.storeName], 'readonly');\n      const objectStore = transaction.objectStore(this.storeName);\n\n      /** @type {any[]} */\n      const results = [];\n\n      // Use IDBKeyRange for efficient prefix query instead of full table scan\n      // This creates a range from \"prefix\" to \"prefix\\uffff\" (highest unicode char)\n      // which efficiently uses the B-tree index\n      let request;\n      if (prefix) {\n        const range = IDBKeyRange.bound(prefix, prefix + '\\uffff', false, false);\n        request = objectStore.openCursor(range);\n      } else {\n        // No prefix = get all\n        request = objectStore.openCursor();\n      }\n\n      request.onsuccess = (event) => {\n        const target = /** @type {IDBRequest} */ (event.target);\n        const cursor = target.result;\n        if (cursor) {\n          results.push(cursor.value.event);\n          cursor.continue();\n        } else {\n          resolve(results);\n        }\n      };\n\n      request.onerror = () => reject(request.error);\n    });\n  }\n\n  /**\n   * Delete an event.\n   *\n   * @param {string} key - Storage key\n   * @returns {Promise<void>}\n   */\n  async delete(key) {\n    return new Promise((resolve, reject) => {\n      if (!this.db) {\n        reject(new Error('Database not initialized'));\n        return;\n      }\n      const transaction = this.db.transaction([this.storeName], 'readwrite');\n      const objectStore = transaction.objectStore(this.storeName);\n\n      const request = objectStore.delete(key);\n\n      request.onsuccess = () => resolve(undefined);\n      request.onerror = () => reject(request.error);\n    });\n  }\n\n  /**\n   * Clear all stored events.\n   *\n   * @returns {Promise<void>}\n   */\n  async clear() {\n    return new Promise((resolve, reject) => {\n      if (!this.db) {\n        reject(new Error('Database not initialized'));\n        return;\n      }\n      const transaction = this.db.transaction([this.storeName], 'readwrite');\n      const objectStore = transaction.objectStore(this.storeName);\n\n      const request = objectStore.clear();\n\n      request.onsuccess = () => resolve(undefined);\n      request.onerror = () => reject(request.error);\n    });\n  }\n\n  /**\n   * Close the database connection.\n   *\n   * @returns {Promise<void>}\n   */\n  async close() {\n    if (this.db) {\n      this.db.close();\n      this.db = null;\n    }\n  }\n}\n"],"names":["IndexedDBStorage","PersistentStorage","constructor","super","this","db","dbName","storeName","init","namespace","_openDatabase","error","name","console","warn","_deleteDatabase","Promise","resolve","reject","request","indexedDB","open","onerror","onsuccess","result","onupgradeneeded","event","objectStoreNames","contains","createObjectStore","keyPath","createIndex","unique","deleteDatabase","onblocked","put","key","Error","transaction","objectStore","timestamp","Date","now","get","getAll","prefix","results","range","IDBKeyRange","bound","openCursor","cursor","push","value","continue","delete","clear","close"],"mappings":"wHAuBO,MAAMA,UAAyBC,EAAAA,kBAIpC,WAAAC,GACEC,QAEAC,KAAKC,GAAK,KAEVD,KAAKE,OAAS,GAEdF,KAAKG,UAAY,QACnB,CAWA,UAAMC,CAAKC,GACTL,KAAKE,OAAS,cAAcG,IAE5B,UACQL,KAAKM,eACb,OAASC,GAEP,GAAmB,iBAAfA,EAAMC,KAKR,MAAMD,EAJNE,QAAQC,KAAK,oDAAoDV,KAAKE,wCAChEF,KAAKW,wBACLX,KAAKM,eAIf,CACF,CAQA,mBAAMA,GACJ,OAAO,IAAIM,QAAQ,CAACC,EAASC,KAC3B,MAAMC,EAAUC,UAAUC,KAAKjB,KAAKE,OAAQ,GAE5Ca,EAAQG,QAAU,IAAMJ,EAAOC,EAAQR,OACvCQ,EAAQI,UAAY,KAClBnB,KAAKC,GAAKc,EAAQK,OAClBP,OAAQ,IAGVE,EAAQM,gBAAmBC,IACzB,MACMrB,EAD0CqB,EAAM,OACpCF,OAGlB,IAAKnB,EAAGsB,iBAAiBC,SAASxB,KAAKG,WAAY,CAC7BF,EAAGwB,kBAAkBzB,KAAKG,UAAW,CAAEuB,QAAS,QAExDC,YAAY,MAAO,MAAO,CAAEC,QAAQ,GAClD,IAGN,CAQA,qBAAMjB,GACJ,OAAO,IAAIC,QAAQ,CAACC,EAASC,KAC3B,MAAMC,EAAUC,UAAUa,eAAe7B,KAAKE,QAC9Ca,EAAQI,UAAY,IAAMN,OAAQ,GAClCE,EAAQG,QAAU,IAAMJ,EAAOC,EAAQR,OACvCQ,EAAQe,UAAY,KAClBrB,QAAQC,KAAK,oDAAoDV,KAAKE,UAEtEW,OAAQ,KAGd,CASA,SAAMkB,CAAIC,EAAKV,GACb,OAAO,IAAIV,QAAQ,CAACC,EAASC,KAC3B,IAAKd,KAAKC,GAER,YADAa,EAAO,IAAImB,MAAM,6BAGnB,MAGMlB,EAHcf,KAAKC,GAAGiC,YAAY,CAAClC,KAAKG,WAAY,aAC1BgC,YAAYnC,KAAKG,WAErB4B,IAAI,CAAEC,MAAKV,QAAOc,UAAWC,KAAKC,QAE9DvB,EAAQI,UAAY,IAAMN,OAAQ,GAClCE,EAAQG,QAAU,IAAMJ,EAAOC,EAAQR,QAE3C,CAQA,SAAMgC,CAAIP,GACR,OAAO,IAAIpB,QAAQ,CAACC,EAASC,KAC3B,IAAKd,KAAKC,GAER,YADAa,EAAO,IAAImB,MAAM,6BAGnB,MAGMlB,EAHcf,KAAKC,GAAGiC,YAAY,CAAClC,KAAKG,WAAY,YAC1BgC,YAAYnC,KAAKG,WAErBoC,IAAIP,GAEhCjB,EAAQI,UAAY,KAClB,MAAMC,EAASL,EAAQK,OACvBP,EAAQO,EAASA,EAAOE,MAAQ,OAElCP,EAAQG,QAAU,IAAMJ,EAAOC,EAAQR,QAE3C,CAUA,YAAMiC,CAAOC,GACX,OAAO,IAAI7B,QAAQ,CAACC,EAASC,KAC3B,IAAKd,KAAKC,GAER,YADAa,EAAO,IAAImB,MAAM,6BAGnB,MACME,EADcnC,KAAKC,GAAGiC,YAAY,CAAClC,KAAKG,WAAY,YAC1BgC,YAAYnC,KAAKG,WAG3CuC,EAAU,GAKhB,IAAI3B,EACJ,GAAI0B,EAAQ,CACV,MAAME,EAAQC,YAAYC,MAAMJ,EAAQA,EAAS,KAAU,GAAO,GAClE1B,EAAUoB,EAAYW,WAAWH,EACnC,MAEE5B,EAAUoB,EAAYW,aAGxB/B,EAAQI,UAAaG,IACnB,MACMyB,EADoCzB,EAAM,OAC1BF,OAClB2B,GACFL,EAAQM,KAAKD,EAAOE,MAAM3B,OAC1ByB,EAAOG,YAEPrC,EAAQ6B,IAIZ3B,EAAQG,QAAU,IAAMJ,EAAOC,EAAQR,QAE3C,CAQA,YAAM,CAAOyB,GACX,OAAO,IAAIpB,QAAQ,CAACC,EAASC,KAC3B,IAAKd,KAAKC,GAER,YADAa,EAAO,IAAImB,MAAM,6BAGnB,MAGMlB,EAHcf,KAAKC,GAAGiC,YAAY,CAAClC,KAAKG,WAAY,aAC1BgC,YAAYnC,KAAKG,WAErBgD,OAAOnB,GAEnCjB,EAAQI,UAAY,IAAMN,OAAQ,GAClCE,EAAQG,QAAU,IAAMJ,EAAOC,EAAQR,QAE3C,CAOA,WAAM6C,GACJ,OAAO,IAAIxC,QAAQ,CAACC,EAASC,KAC3B,IAAKd,KAAKC,GAER,YADAa,EAAO,IAAImB,MAAM,6BAGnB,MAGMlB,EAHcf,KAAKC,GAAGiC,YAAY,CAAClC,KAAKG,WAAY,aAC1BgC,YAAYnC,KAAKG,WAErBiD,QAE5BrC,EAAQI,UAAY,IAAMN,OAAQ,GAClCE,EAAQG,QAAU,IAAMJ,EAAOC,EAAQR,QAE3C,CAOA,WAAM8C,GACArD,KAAKC,KACPD,KAAKC,GAAGoD,QACRrD,KAAKC,GAAK,KAEd"}

package/dist/{indexeddb-storage-5eiUNsHC.js → indexeddb-storage-bpA01pAU.js}

@@ -1,4 +1,4 @@
-import { aZ as PersistentStorage } from "./index-D-jZhliX.js";
+import { aV as PersistentStorage } from "./index-BN_uoxQK.js";
 class IndexedDBStorage extends PersistentStorage {
   /**
    * Create a new IndexedDBStorage instance.
@@ -13,12 +13,32 @@ class IndexedDBStorage extends PersistentStorage {
    * Initialize storage with namespace.
    *
    * Creates or opens the IndexedDB database and object store.
+   * Handles version conflicts by deleting and recreating the database if needed.
    *
    * @param {string} namespace - Storage namespace
    * @returns {Promise<void>}
    */
   async init(namespace) {
     this.dbName = `holosphere_${namespace}`;
+    try {
+      await this._openDatabase();
+    } catch (error) {
+      if (error.name === "VersionError") {
+        console.warn(`[IndexedDBStorage] Version conflict detected for ${this.dbName}, recreating database...`);
+        await this._deleteDatabase();
+        await this._openDatabase();
+      } else {
+        throw error;
+      }
+    }
+  }
+  /**
+   * Open the IndexedDB database.
+   *
+   * @returns {Promise<void>}
+   * @private
+   */
+  async _openDatabase() {
     return new Promise((resolve, reject) => {
       const request = indexedDB.open(this.dbName, 1);
       request.onerror = () => reject(request.error);
@@ -39,6 +59,23 @@ class IndexedDBStorage extends PersistentStorage {
       };
     });
   }
+  /**
+   * Delete the IndexedDB database.
+   *
+   * @returns {Promise<void>}
+   * @private
+   */
+  async _deleteDatabase() {
+    return new Promise((resolve, reject) => {
+      const request = indexedDB.deleteDatabase(this.dbName);
+      request.onsuccess = () => resolve(void 0);
+      request.onerror = () => reject(request.error);
+      request.onblocked = () => {
+        console.warn(`[IndexedDBStorage] Database deletion blocked for ${this.dbName}`);
+        resolve(void 0);
+      };
+    });
+  }
   /**
    * Store an event.
    *
@@ -173,4 +210,4 @@ class IndexedDBStorage extends PersistentStorage {
 export {
   IndexedDBStorage
 };
-//# sourceMappingURL=indexeddb-storage-5eiUNsHC.js.map
+//# sourceMappingURL=indexeddb-storage-bpA01pAU.js.map

package/dist/indexeddb-storage-bpA01pAU.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb-storage-bpA01pAU.js","sources":["../src/storage/indexeddb-storage.js"],"sourcesContent":["/**\n * @fileoverview IndexedDB storage adapter for browsers.\n *\n * Provides persistent storage with good performance using browser IndexedDB.\n * Uses B-tree indexes for efficient prefix queries.\n *\n * @module storage/indexeddb-storage\n */\n\nimport { PersistentStorage } from './persistent-storage.js';\n\n/**\n * IndexedDB storage adapter for browsers.\n *\n * Provides high-performance persistent storage using IndexedDB with efficient prefix queries.\n *\n * @class IndexedDBStorage\n * @extends PersistentStorage\n * @example\n * const storage = new IndexedDBStorage();\n * await storage.init('myapp');\n * await storage.put('key1', { id: 'event1', content: 'test' });\n */\nexport class IndexedDBStorage extends PersistentStorage {\n  /**\n   * Create a new IndexedDBStorage instance.\n   */\n  constructor() {\n    super();\n    /** @type {IDBDatabase|null} */\n    this.db = null;\n    /** @type {string} */\n    this.dbName = '';\n    /** @type {string} */\n    this.storeName = 'events';\n  }\n\n  /**\n   * Initialize storage with namespace.\n   *\n   * Creates or opens the IndexedDB database and object store.\n   * Handles version conflicts by deleting and recreating the database if needed.\n   *\n   * @param {string} namespace - Storage namespace\n   * @returns {Promise<void>}\n   */\n  async init(namespace) {\n    this.dbName = `holosphere_${namespace}`;\n\n    try {\n      await this._openDatabase();\n    } catch (error) {\n      // Handle version conflict by deleting and recreating the database\n      if (error.name === 'VersionError') {\n        console.warn(`[IndexedDBStorage] Version conflict detected for ${this.dbName}, recreating database...`);\n        await this._deleteDatabase();\n        await this._openDatabase();\n      } else {\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Open the IndexedDB database.\n   *\n   * @returns {Promise<void>}\n   * @private\n   */\n  async _openDatabase() {\n    return new Promise((resolve, reject) => {\n      const request = indexedDB.open(this.dbName, 1);\n\n      request.onerror = () => reject(request.error);\n      request.onsuccess = () => {\n        this.db = request.result;\n        resolve(undefined);\n      };\n\n      request.onupgradeneeded = (event) => {\n        const target = /** @type {IDBOpenDBRequest} */ (event.target);\n        const db = target.result;\n\n        // Create object store if it doesn't exist\n        if (!db.objectStoreNames.contains(this.storeName)) {\n          const objectStore = db.createObjectStore(this.storeName, { keyPath: 'key' });\n          // Create index for prefix queries\n          objectStore.createIndex('key', 'key', { unique: false });\n        }\n      };\n    });\n  }\n\n  /**\n   * Delete the IndexedDB database.\n   *\n   * @returns {Promise<void>}\n   * @private\n   */\n  async _deleteDatabase() {\n    return new Promise((resolve, reject) => {\n      const request = indexedDB.deleteDatabase(this.dbName);\n      request.onsuccess = () => resolve(undefined);\n      request.onerror = () => reject(request.error);\n      request.onblocked = () => {\n        console.warn(`[IndexedDBStorage] Database deletion blocked for ${this.dbName}`);\n        // Still resolve - the next open attempt will handle it\n        resolve(undefined);\n      };\n    });\n  }\n\n  /**\n   * Store an event.\n   *\n   * @param {string} key - Storage key\n   * @param {Object} event - Event data\n   * @returns {Promise<void>}\n   */\n  async put(key, event) {\n    return new Promise((resolve, reject) => {\n      if (!this.db) {\n        reject(new Error('Database not initialized'));\n        return;\n      }\n      const transaction = this.db.transaction([this.storeName], 'readwrite');\n      const objectStore = transaction.objectStore(this.storeName);\n\n      const request = objectStore.put({ key, event, timestamp: Date.now() });\n\n      request.onsuccess = () => resolve(undefined);\n      request.onerror = () => reject(request.error);\n    });\n  }\n\n  /**\n   * Retrieve an event.\n   *\n   * @param {string} key - Storage key\n   * @returns {Promise<Object|null>} Event data or null\n   */\n  async get(key) {\n    return new Promise((resolve, reject) => {\n      if (!this.db) {\n        reject(new Error('Database not initialized'));\n        return;\n      }\n      const transaction = this.db.transaction([this.storeName], 'readonly');\n      const objectStore = transaction.objectStore(this.storeName);\n\n      const request = objectStore.get(key);\n\n      request.onsuccess = () => {\n        const result = request.result;\n        resolve(result ? result.event : null);\n      };\n      request.onerror = () => reject(request.error);\n    });\n  }\n\n  /**\n   * Retrieve all events matching a prefix.\n   *\n   * Uses IDBKeyRange for efficient B-tree index queries.\n   *\n   * @param {string} prefix - Key prefix to match\n   * @returns {Promise<any[]>} Array of matching events\n   */\n  async getAll(prefix) {\n    return new Promise((resolve, reject) => {\n      if (!this.db) {\n        reject(new Error('Database not initialized'));\n        return;\n      }\n      const transaction = this.db.transaction([this.storeName], 'readonly');\n      const objectStore = transaction.objectStore(this.storeName);\n\n      /** @type {any[]} */\n      const results = [];\n\n      // Use IDBKeyRange for efficient prefix query instead of full table scan\n      // This creates a range from \"prefix\" to \"prefix\\uffff\" (highest unicode char)\n      // which efficiently uses the B-tree index\n      let request;\n      if (prefix) {\n        const range = IDBKeyRange.bound(prefix, prefix + '\\uffff', false, false);\n        request = objectStore.openCursor(range);\n      } else {\n        // No prefix = get all\n        request = objectStore.openCursor();\n      }\n\n      request.onsuccess = (event) => {\n        const target = /** @type {IDBRequest} */ (event.target);\n        const cursor = target.result;\n        if (cursor) {\n          results.push(cursor.value.event);\n          cursor.continue();\n        } else {\n          resolve(results);\n        }\n      };\n\n      request.onerror = () => reject(request.error);\n    });\n  }\n\n  /**\n   * Delete an event.\n   *\n   * @param {string} key - Storage key\n   * @returns {Promise<void>}\n   */\n  async delete(key) {\n    return new Promise((resolve, reject) => {\n      if (!this.db) {\n        reject(new Error('Database not initialized'));\n        return;\n      }\n      const transaction = this.db.transaction([this.storeName], 'readwrite');\n      const objectStore = transaction.objectStore(this.storeName);\n\n      const request = objectStore.delete(key);\n\n      request.onsuccess = () => resolve(undefined);\n      request.onerror = () => reject(request.error);\n    });\n  }\n\n  /**\n   * Clear all stored events.\n   *\n   * @returns {Promise<void>}\n   */\n  async clear() {\n    return new Promise((resolve, reject) => {\n      if (!this.db) {\n        reject(new Error('Database not initialized'));\n        return;\n      }\n      const transaction = this.db.transaction([this.storeName], 'readwrite');\n      const objectStore = transaction.objectStore(this.storeName);\n\n      const request = objectStore.clear();\n\n      request.onsuccess = () => resolve(undefined);\n      request.onerror = () => reject(request.error);\n    });\n  }\n\n  /**\n   * Close the database connection.\n   *\n   * @returns {Promise<void>}\n   */\n  async close() {\n    if (this.db) {\n      this.db.close();\n      this.db = null;\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/{memory-storage-DMt36uZO.cjs → memory-storage-B1k8Jszd.cjs}

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./index-Dc6Z8Aob.cjs");class e extends t.PersistentStorage{constructor(){super(),this.data=new Map,this.namespace=null}async init(t){this.namespace=t,e._globalStore||(e._globalStore=new Map),e._globalStore.has(t)||e._globalStore.set(t,new Map),this.data=e._globalStore.get(t)}async put(t,e){this.data.set(t,JSON.parse(JSON.stringify(e)))}async get(t){const e=this.data.get(t);return e?JSON.parse(JSON.stringify(e)):null}async getAll(t){const e=[];for(const[s,a]of this.data.entries())s.startsWith(t)&&e.push(JSON.parse(JSON.stringify(a)));return e}async delete(t){this.data.delete(t)}async clear(){this.data.clear()}async close(){}}e._globalStore=null,exports.MemoryStorage=e;
-//# sourceMappingURL=memory-storage-DMt36uZO.cjs.map
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./index-V8EHMYEY.cjs");class e extends t.PersistentStorage{constructor(){super(),this.data=new Map,this.namespace=null}async init(t){this.namespace=t,e._globalStore||(e._globalStore=new Map),e._globalStore.has(t)||e._globalStore.set(t,new Map),this.data=e._globalStore.get(t)}async put(t,e){this.data.set(t,JSON.parse(JSON.stringify(e)))}async get(t){const e=this.data.get(t);return e?JSON.parse(JSON.stringify(e)):null}async getAll(t){const e=[];for(const[s,a]of this.data.entries())s.startsWith(t)&&e.push(JSON.parse(JSON.stringify(a)));return e}async delete(t){this.data.delete(t)}async clear(){this.data.clear()}async close(){}}e._globalStore=null,exports.MemoryStorage=e;
+//# sourceMappingURL=memory-storage-B1k8Jszd.cjs.map

package/dist/{memory-storage-DMt36uZO.cjs.map → memory-storage-B1k8Jszd.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"memory-storage-DMt36uZO.cjs","sources":["../src/storage/memory-storage.js"],"sourcesContent":["/**\n * @fileoverview Memory-only storage adapter (fallback, no actual persistence).\n *\n * Provides in-memory storage for testing or when persistent storage is unavailable.\n * Data is shared across instances with the same namespace but lost on process restart.\n *\n * @module storage/memory-storage\n */\n\nimport { PersistentStorage } from './persistent-storage.js';\n\n/**\n * Memory-only storage adapter.\n *\n * Stores data in memory with no persistence across restarts.\n * Uses a global store to share data across instances with same namespace.\n *\n * @class MemoryStorage\n * @extends PersistentStorage\n * @example\n * const storage = new MemoryStorage();\n * await storage.init('myapp');\n * await storage.put('key1', { id: 'event1' });\n */\nexport class MemoryStorage extends PersistentStorage {\n  /**\n   * Create a new MemoryStorage instance.\n   */\n  constructor() {\n    super();\n    this.data = new Map();\n    this.namespace = null;\n  }\n\n  /**\n   * Initialize storage with namespace.\n   *\n   * @param {string} namespace - Storage namespace\n   * @returns {Promise<void>}\n   */\n  async init(namespace) {\n    this.namespace = namespace;\n    // Check if there's existing data for this namespace\n    if (!MemoryStorage._globalStore) {\n      MemoryStorage._globalStore = new Map();\n    }\n    if (!MemoryStorage._globalStore.has(namespace)) {\n      MemoryStorage._globalStore.set(namespace, new Map());\n    }\n    this.data = MemoryStorage._globalStore.get(namespace);\n  }\n\n  /**\n   * Store an event.\n   *\n   * @param {string} key - Storage key\n   * @param {Object} event - Event data\n   * @returns {Promise<void>}\n   */\n  async put(key, event) {\n    this.data.set(key, JSON.parse(JSON.stringify(event))); // Deep clone\n  }\n\n  /**\n   * Retrieve an event.\n   *\n   * @param {string} key - Storage key\n   * @returns {Promise<Object|null>} Event data or null\n   */\n  async get(key) {\n    const data = this.data.get(key);\n    return data ? JSON.parse(JSON.stringify(data)) : null; // Deep clone\n  }\n\n  /**\n   * Retrieve all events matching a prefix.\n   *\n   * @param {string} prefix - Key prefix to match\n   * @returns {Promise<any[]>} Array of matching events\n   */\n  async getAll(prefix) {\n    /** @type {any[]} */\n    const results = [];\n    for (const [key, value] of this.data.entries()) {\n      if (key.startsWith(prefix)) {\n        results.push(JSON.parse(JSON.stringify(value)));\n      }\n    }\n    return results;\n  }\n\n  /**\n   * Delete an event.\n   *\n   * @param {string} key - Storage key\n   * @returns {Promise<void>}\n   */\n  async delete(key) {\n    this.data.delete(key);\n  }\n\n  /**\n   * Clear all stored events.\n   *\n   * @returns {Promise<void>}\n   */\n  async clear() {\n    this.data.clear();\n  }\n\n  /**\n   * Close storage (no-op for memory storage).\n   *\n   * @returns {Promise<void>}\n   */\n  async close() {\n    // Nothing to close for memory storage\n  }\n}\n\n/**\n * Global store shared across instances with same namespace.\n * @private\n */\nMemoryStorage._globalStore = null;\n"],"names":["MemoryStorage","PersistentStorage","constructor","super","this","data","Map","namespace","init","_globalStore","has","set","get","put","key","event","JSON","parse","stringify","getAll","prefix","results","value","entries","startsWith","push","delete","clear","close"],"mappings":"wHAwBO,MAAMA,UAAsBC,EAAAA,kBAIjC,WAAAC,GACEC,QACAC,KAAKC,SAAWC,IAChBF,KAAKG,UAAY,IACnB,CAQA,UAAMC,CAAKD,GACTH,KAAKG,UAAYA,EAEZP,EAAcS,eACjBT,EAAcS,iBAAmBH,KAE9BN,EAAcS,aAAaC,IAAIH,IAClCP,EAAcS,aAAaE,IAAIJ,EAAW,IAAID,KAEhDF,KAAKC,KAAOL,EAAcS,aAAaG,IAAIL,EAC7C,CASA,SAAMM,CAAIC,EAAKC,GACbX,KAAKC,KAAKM,IAAIG,EAAKE,KAAKC,MAAMD,KAAKE,UAAUH,IAC/C,CAQA,SAAMH,CAAIE,GACR,MAAMT,EAAOD,KAAKC,KAAKO,IAAIE,GAC3B,OAAOT,EAAOW,KAAKC,MAAMD,KAAKE,UAAUb,IAAS,IACnD,CAQA,YAAMc,CAAOC,GAEX,MAAMC,EAAU,GAChB,IAAA,MAAYP,EAAKQ,KAAUlB,KAAKC,KAAKkB,UAC/BT,EAAIU,WAAWJ,IACjBC,EAAQI,KAAKT,KAAKC,MAAMD,KAAKE,UAAUI,KAG3C,OAAOD,CACT,CAQA,YAAM,CAAOP,GACXV,KAAKC,KAAKqB,OAAOZ,EACnB,CAOA,WAAMa,GACJvB,KAAKC,KAAKsB,OACZ,CAOA,WAAMC,GAEN,EAOF5B,EAAcS,aAAe"}
+{"version":3,"file":"memory-storage-B1k8Jszd.cjs","sources":["../src/storage/memory-storage.js"],"sourcesContent":["/**\n * @fileoverview Memory-only storage adapter (fallback, no actual persistence).\n *\n * Provides in-memory storage for testing or when persistent storage is unavailable.\n * Data is shared across instances with the same namespace but lost on process restart.\n *\n * @module storage/memory-storage\n */\n\nimport { PersistentStorage } from './persistent-storage.js';\n\n/**\n * Memory-only storage adapter.\n *\n * Stores data in memory with no persistence across restarts.\n * Uses a global store to share data across instances with same namespace.\n *\n * @class MemoryStorage\n * @extends PersistentStorage\n * @example\n * const storage = new MemoryStorage();\n * await storage.init('myapp');\n * await storage.put('key1', { id: 'event1' });\n */\nexport class MemoryStorage extends PersistentStorage {\n  /**\n   * Create a new MemoryStorage instance.\n   */\n  constructor() {\n    super();\n    this.data = new Map();\n    this.namespace = null;\n  }\n\n  /**\n   * Initialize storage with namespace.\n   *\n   * @param {string} namespace - Storage namespace\n   * @returns {Promise<void>}\n   */\n  async init(namespace) {\n    this.namespace = namespace;\n    // Check if there's existing data for this namespace\n    if (!MemoryStorage._globalStore) {\n      MemoryStorage._globalStore = new Map();\n    }\n    if (!MemoryStorage._globalStore.has(namespace)) {\n      MemoryStorage._globalStore.set(namespace, new Map());\n    }\n    this.data = MemoryStorage._globalStore.get(namespace);\n  }\n\n  /**\n   * Store an event.\n   *\n   * @param {string} key - Storage key\n   * @param {Object} event - Event data\n   * @returns {Promise<void>}\n   */\n  async put(key, event) {\n    this.data.set(key, JSON.parse(JSON.stringify(event))); // Deep clone\n  }\n\n  /**\n   * Retrieve an event.\n   *\n   * @param {string} key - Storage key\n   * @returns {Promise<Object|null>} Event data or null\n   */\n  async get(key) {\n    const data = this.data.get(key);\n    return data ? JSON.parse(JSON.stringify(data)) : null; // Deep clone\n  }\n\n  /**\n   * Retrieve all events matching a prefix.\n   *\n   * @param {string} prefix - Key prefix to match\n   * @returns {Promise<any[]>} Array of matching events\n   */\n  async getAll(prefix) {\n    /** @type {any[]} */\n    const results = [];\n    for (const [key, value] of this.data.entries()) {\n      if (key.startsWith(prefix)) {\n        results.push(JSON.parse(JSON.stringify(value)));\n      }\n    }\n    return results;\n  }\n\n  /**\n   * Delete an event.\n   *\n   * @param {string} key - Storage key\n   * @returns {Promise<void>}\n   */\n  async delete(key) {\n    this.data.delete(key);\n  }\n\n  /**\n   * Clear all stored events.\n   *\n   * @returns {Promise<void>}\n   */\n  async clear() {\n    this.data.clear();\n  }\n\n  /**\n   * Close storage (no-op for memory storage).\n   *\n   * @returns {Promise<void>}\n   */\n  async close() {\n    // Nothing to close for memory storage\n  }\n}\n\n/**\n * Global store shared across instances with same namespace.\n * @private\n */\nMemoryStorage._globalStore = null;\n"],"names":["MemoryStorage","PersistentStorage","constructor","super","this","data","Map","namespace","init","_globalStore","has","set","get","put","key","event","JSON","parse","stringify","getAll","prefix","results","value","entries","startsWith","push","delete","clear","close"],"mappings":"wHAwBO,MAAMA,UAAsBC,EAAAA,kBAIjC,WAAAC,GACEC,QACAC,KAAKC,SAAWC,IAChBF,KAAKG,UAAY,IACnB,CAQA,UAAMC,CAAKD,GACTH,KAAKG,UAAYA,EAEZP,EAAcS,eACjBT,EAAcS,iBAAmBH,KAE9BN,EAAcS,aAAaC,IAAIH,IAClCP,EAAcS,aAAaE,IAAIJ,EAAW,IAAID,KAEhDF,KAAKC,KAAOL,EAAcS,aAAaG,IAAIL,EAC7C,CASA,SAAMM,CAAIC,EAAKC,GACbX,KAAKC,KAAKM,IAAIG,EAAKE,KAAKC,MAAMD,KAAKE,UAAUH,IAC/C,CAQA,SAAMH,CAAIE,GACR,MAAMT,EAAOD,KAAKC,KAAKO,IAAIE,GAC3B,OAAOT,EAAOW,KAAKC,MAAMD,KAAKE,UAAUb,IAAS,IACnD,CAQA,YAAMc,CAAOC,GAEX,MAAMC,EAAU,GAChB,IAAA,MAAYP,EAAKQ,KAAUlB,KAAKC,KAAKkB,UAC/BT,EAAIU,WAAWJ,IACjBC,EAAQI,KAAKT,KAAKC,MAAMD,KAAKE,UAAUI,KAG3C,OAAOD,CACT,CAQA,YAAM,CAAOP,GACXV,KAAKC,KAAKqB,OAAOZ,EACnB,CAOA,WAAMa,GACJvB,KAAKC,KAAKsB,OACZ,CAOA,WAAMC,GAEN,EAOF5B,EAAcS,aAAe"}

package/dist/{memory-storage-CI-gfmuG.js → memory-storage-BqhmytP_.js}

@@ -1,4 +1,4 @@
-import { aZ as PersistentStorage } from "./index-D-jZhliX.js";
+import { aV as PersistentStorage } from "./index-BN_uoxQK.js";
 class MemoryStorage extends PersistentStorage {
   /**
    * Create a new MemoryStorage instance.
@@ -88,4 +88,4 @@ MemoryStorage._globalStore = null;
 export {
   MemoryStorage
 };
-//# sourceMappingURL=memory-storage-CI-gfmuG.js.map
+//# sourceMappingURL=memory-storage-BqhmytP_.js.map

package/dist/{memory-storage-CI-gfmuG.js.map → memory-storage-BqhmytP_.js.map}

@@ -1 +1 @@
-{"version":3,"file":"memory-storage-CI-gfmuG.js","sources":["../src/storage/memory-storage.js"],"sourcesContent":["/**\n * @fileoverview Memory-only storage adapter (fallback, no actual persistence).\n *\n * Provides in-memory storage for testing or when persistent storage is unavailable.\n * Data is shared across instances with the same namespace but lost on process restart.\n *\n * @module storage/memory-storage\n */\n\nimport { PersistentStorage } from './persistent-storage.js';\n\n/**\n * Memory-only storage adapter.\n *\n * Stores data in memory with no persistence across restarts.\n * Uses a global store to share data across instances with same namespace.\n *\n * @class MemoryStorage\n * @extends PersistentStorage\n * @example\n * const storage = new MemoryStorage();\n * await storage.init('myapp');\n * await storage.put('key1', { id: 'event1' });\n */\nexport class MemoryStorage extends PersistentStorage {\n  /**\n   * Create a new MemoryStorage instance.\n   */\n  constructor() {\n    super();\n    this.data = new Map();\n    this.namespace = null;\n  }\n\n  /**\n   * Initialize storage with namespace.\n   *\n   * @param {string} namespace - Storage namespace\n   * @returns {Promise<void>}\n   */\n  async init(namespace) {\n    this.namespace = namespace;\n    // Check if there's existing data for this namespace\n    if (!MemoryStorage._globalStore) {\n      MemoryStorage._globalStore = new Map();\n    }\n    if (!MemoryStorage._globalStore.has(namespace)) {\n      MemoryStorage._globalStore.set(namespace, new Map());\n    }\n    this.data = MemoryStorage._globalStore.get(namespace);\n  }\n\n  /**\n   * Store an event.\n   *\n   * @param {string} key - Storage key\n   * @param {Object} event - Event data\n   * @returns {Promise<void>}\n   */\n  async put(key, event) {\n    this.data.set(key, JSON.parse(JSON.stringify(event))); // Deep clone\n  }\n\n  /**\n   * Retrieve an event.\n   *\n   * @param {string} key - Storage key\n   * @returns {Promise<Object|null>} Event data or null\n   */\n  async get(key) {\n    const data = this.data.get(key);\n    return data ? JSON.parse(JSON.stringify(data)) : null; // Deep clone\n  }\n\n  /**\n   * Retrieve all events matching a prefix.\n   *\n   * @param {string} prefix - Key prefix to match\n   * @returns {Promise<any[]>} Array of matching events\n   */\n  async getAll(prefix) {\n    /** @type {any[]} */\n    const results = [];\n    for (const [key, value] of this.data.entries()) {\n      if (key.startsWith(prefix)) {\n        results.push(JSON.parse(JSON.stringify(value)));\n      }\n    }\n    return results;\n  }\n\n  /**\n   * Delete an event.\n   *\n   * @param {string} key - Storage key\n   * @returns {Promise<void>}\n   */\n  async delete(key) {\n    this.data.delete(key);\n  }\n\n  /**\n   * Clear all stored events.\n   *\n   * @returns {Promise<void>}\n   */\n  async clear() {\n    this.data.clear();\n  }\n\n  /**\n   * Close storage (no-op for memory storage).\n   *\n   * @returns {Promise<void>}\n   */\n  async close() {\n    // Nothing to close for memory storage\n  }\n}\n\n/**\n * Global store shared across instances with same namespace.\n * @private\n */\nMemoryStorage._globalStore = null;\n"],"names":[],"mappings":";AAwBO,MAAM,sBAAsB,kBAAkB;AAAA;AAAA;AAAA;AAAA,EAInD,cAAc;AACZ,UAAK;AACL,SAAK,OAAO,oBAAI,IAAG;AACnB,SAAK,YAAY;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,KAAK,WAAW;AACpB,SAAK,YAAY;AAEjB,QAAI,CAAC,cAAc,cAAc;AAC/B,oBAAc,eAAe,oBAAI,IAAG;AAAA,IACtC;AACA,QAAI,CAAC,cAAc,aAAa,IAAI,SAAS,GAAG;AAC9C,oBAAc,aAAa,IAAI,WAAW,oBAAI,IAAG,CAAE;AAAA,IACrD;AACA,SAAK,OAAO,cAAc,aAAa,IAAI,SAAS;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,IAAI,KAAK,OAAO;AACpB,SAAK,KAAK,IAAI,KAAK,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC,CAAC;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,KAAK;AACb,UAAM,OAAO,KAAK,KAAK,IAAI,GAAG;AAC9B,WAAO,OAAO,KAAK,MAAM,KAAK,UAAU,IAAI,CAAC,IAAI;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,QAAQ;AAEnB,UAAM,UAAU,CAAA;AAChB,eAAW,CAAC,KAAK,KAAK,KAAK,KAAK,KAAK,WAAW;AAC9C,UAAI,IAAI,WAAW,MAAM,GAAG;AAC1B,gBAAQ,KAAK,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC,CAAC;AAAA,MAChD;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,KAAK;AAChB,SAAK,KAAK,OAAO,GAAG;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,QAAQ;AACZ,SAAK,KAAK,MAAK;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,QAAQ;AAAA,EAEd;AACF;AAMA,cAAc,eAAe;"}
+{"version":3,"file":"memory-storage-BqhmytP_.js","sources":["../src/storage/memory-storage.js"],"sourcesContent":["/**\n * @fileoverview Memory-only storage adapter (fallback, no actual persistence).\n *\n * Provides in-memory storage for testing or when persistent storage is unavailable.\n * Data is shared across instances with the same namespace but lost on process restart.\n *\n * @module storage/memory-storage\n */\n\nimport { PersistentStorage } from './persistent-storage.js';\n\n/**\n * Memory-only storage adapter.\n *\n * Stores data in memory with no persistence across restarts.\n * Uses a global store to share data across instances with same namespace.\n *\n * @class MemoryStorage\n * @extends PersistentStorage\n * @example\n * const storage = new MemoryStorage();\n * await storage.init('myapp');\n * await storage.put('key1', { id: 'event1' });\n */\nexport class MemoryStorage extends PersistentStorage {\n  /**\n   * Create a new MemoryStorage instance.\n   */\n  constructor() {\n    super();\n    this.data = new Map();\n    this.namespace = null;\n  }\n\n  /**\n   * Initialize storage with namespace.\n   *\n   * @param {string} namespace - Storage namespace\n   * @returns {Promise<void>}\n   */\n  async init(namespace) {\n    this.namespace = namespace;\n    // Check if there's existing data for this namespace\n    if (!MemoryStorage._globalStore) {\n      MemoryStorage._globalStore = new Map();\n    }\n    if (!MemoryStorage._globalStore.has(namespace)) {\n      MemoryStorage._globalStore.set(namespace, new Map());\n    }\n    this.data = MemoryStorage._globalStore.get(namespace);\n  }\n\n  /**\n   * Store an event.\n   *\n   * @param {string} key - Storage key\n   * @param {Object} event - Event data\n   * @returns {Promise<void>}\n   */\n  async put(key, event) {\n    this.data.set(key, JSON.parse(JSON.stringify(event))); // Deep clone\n  }\n\n  /**\n   * Retrieve an event.\n   *\n   * @param {string} key - Storage key\n   * @returns {Promise<Object|null>} Event data or null\n   */\n  async get(key) {\n    const data = this.data.get(key);\n    return data ? JSON.parse(JSON.stringify(data)) : null; // Deep clone\n  }\n\n  /**\n   * Retrieve all events matching a prefix.\n   *\n   * @param {string} prefix - Key prefix to match\n   * @returns {Promise<any[]>} Array of matching events\n   */\n  async getAll(prefix) {\n    /** @type {any[]} */\n    const results = [];\n    for (const [key, value] of this.data.entries()) {\n      if (key.startsWith(prefix)) {\n        results.push(JSON.parse(JSON.stringify(value)));\n      }\n    }\n    return results;\n  }\n\n  /**\n   * Delete an event.\n   *\n   * @param {string} key - Storage key\n   * @returns {Promise<void>}\n   */\n  async delete(key) {\n    this.data.delete(key);\n  }\n\n  /**\n   * Clear all stored events.\n   *\n   * @returns {Promise<void>}\n   */\n  async clear() {\n    this.data.clear();\n  }\n\n  /**\n   * Close storage (no-op for memory storage).\n   *\n   * @returns {Promise<void>}\n   */\n  async close() {\n    // Nothing to close for memory storage\n  }\n}\n\n/**\n * Global store shared across instances with same namespace.\n * @private\n */\nMemoryStorage._globalStore = null;\n"],"names":[],"mappings":";AAwBO,MAAM,sBAAsB,kBAAkB;AAAA;AAAA;AAAA;AAAA,EAInD,cAAc;AACZ,UAAK;AACL,SAAK,OAAO,oBAAI,IAAG;AACnB,SAAK,YAAY;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,KAAK,WAAW;AACpB,SAAK,YAAY;AAEjB,QAAI,CAAC,cAAc,cAAc;AAC/B,oBAAc,eAAe,oBAAI,IAAG;AAAA,IACtC;AACA,QAAI,CAAC,cAAc,aAAa,IAAI,SAAS,GAAG;AAC9C,oBAAc,aAAa,IAAI,WAAW,oBAAI,IAAG,CAAE;AAAA,IACrD;AACA,SAAK,OAAO,cAAc,aAAa,IAAI,SAAS;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,IAAI,KAAK,OAAO;AACpB,SAAK,KAAK,IAAI,KAAK,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC,CAAC;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,KAAK;AACb,UAAM,OAAO,KAAK,KAAK,IAAI,GAAG;AAC9B,WAAO,OAAO,KAAK,MAAM,KAAK,UAAU,IAAI,CAAC,IAAI;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,QAAQ;AAEnB,UAAM,UAAU,CAAA;AAChB,eAAW,CAAC,KAAK,KAAK,KAAK,KAAK,KAAK,WAAW;AAC9C,UAAI,IAAI,WAAW,MAAM,GAAG;AAC1B,gBAAQ,KAAK,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC,CAAC;AAAA,MAChD;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,KAAK;AAChB,SAAK,KAAK,OAAO,GAAG;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,QAAQ;AACZ,SAAK,KAAK,MAAK;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,QAAQ;AAAA,EAEd;AACF;AAMA,cAAc,eAAe;"}

package/docs/FEDERATION.md

@@ -0,0 +1,474 @@
+# HoloSphere Federation API
+
+Federation enables data sharing between holons (agents) through **holograms** - lightweight references that maintain a single source of truth while allowing data to appear in multiple places.
+
+## Quick Start
+
+```javascript
+import { HoloSphere } from 'holosphere';
+
+// Alice's instance
+const alice = new HoloSphere({
+  appName: 'myapp',
+  privateKey: alicePrivateKey,
+  relays: ['wss://relay.example.com']
+});
+await alice.ready();
+
+// Alice federates her 'tasks' lens to Bob (outbound)
+await alice.federate(
+  alice.myHolon,           // source: Alice's holon
+  bobPublicKey,            // target: Bob's holon
+  'tasks',                 // lens to share
+  { direction: 'outbound' }
+);
+
+// Bob now sees Alice's tasks as holograms in his holon
+```
+
+---
+
+## Core Concepts
+
+### Agent-Holon 1:1 Mapping
+
+Each HoloSphere instance represents a single agent. The agent's **holon ID equals their public key**.
+
+```javascript
+const hs = new HoloSphere({ privateKey: myPrivateKey });
+await hs.ready();
+
+console.log(hs.myHolon);  // Your public key (64-char hex)
+```
+
+**Ownership rules:**
+- You can only write to your own holon (`hs.myHolon`)
+- Use `asAgent` option to write as a different identity
+- Capability tokens enable cross-holon writes
+
+### Holograms
+
+A **hologram** is a reference to data that lives in another holon. It contains:
+- Pointer to the source (holon, lens, dataId)
+- Cached copy of the data
+- Capability token for access
+- Local overrides (position, pinned status, etc.)
+
+```javascript
+// Get data with hologram metadata visible
+const items = await hs.get(myHolon, 'tasks', null, { resolveHolograms: false });
+
+// Hologram structure:
+{
+  id: 'task-1',
+  hologram: true,              // Identifies as hologram
+  soul: 'app/sourceHolon/tasks/task-1',
+  target: {
+    holonId: 'sourcePublicKey',
+    lensName: 'tasks',
+    dataId: 'task-1'
+  },
+  capability: 'eyJ...',        // JWT capability token
+  // Cached data from source:
+  title: 'Complete report',
+  status: 'pending',
+  // Local overrides:
+  x: 100,
+  y: 200
+}
+```
+
+### Federation Directions
+
+| Direction | Data Flow | Use Case |
+|-----------|-----------|----------|
+| `outbound` | Source → Target | Share your data with others |
+| `inbound` | Source ← Target | Receive data from others |
+| `bidirectional` | Source ↔ Target | Two-way sync |
+
+### Capability Tokens
+
+Capabilities authorize cross-holon operations. They are:
+- **Automatically issued** during federation
+- **Embedded in holograms** for transparent access
+- **Scoped** to specific holons and lenses
+- **Time-limited** (default: 1 year for self, 24h for cross-author)
+
+---
+
+## API Reference
+
+### `myHolon` Property
+
+Returns the current agent's holon ID (public key).
+
+```javascript
+const myHolonId = hs.myHolon;
+```
+
+### `federate(source, target, lensName, options)`
+
+Establishes federation between two holons for a specific lens.
+
+**Parameters:**
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `source` | `string` or `{holonId, authorPubKey}` | Source holon |
+| `target` | `string` or `{holonId, authorPubKey}` | Target holon |
+| `lensName` | `string` | Lens to federate |
+| `options` | `object` | Federation options |
+
+**Options:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `direction` | `'inbound'` \| `'outbound'` \| `'bidirectional'` | `'outbound'` | Data flow direction |
+| `mode` | `'reference'` \| `'copy'` | `'reference'` | Create holograms or copies |
+| `propagate` | `boolean` | `true` | Propagate existing data |
+| `filter` | `function` | `null` | Filter which data to include |
+| `permissions` | `string[]` | `['read']` | Capability permissions |
+
+**Returns:** `Promise<Object>` with federation result
+
+```javascript
+// Outbound: share my tasks with partner
+await hs.federate(hs.myHolon, partnerPubKey, 'tasks', {
+  direction: 'outbound',
+  propagate: true
+});
+
+// Inbound: receive partner's events
+await hs.federate(hs.myHolon, partnerPubKey, 'events', {
+  direction: 'inbound'
+});
+
+// Bidirectional: sync notes both ways
+await hs.federate(hs.myHolon, partnerPubKey, 'notes', {
+  direction: 'bidirectional'
+});
+
+// With filter: only share high-priority items
+await hs.federate(hs.myHolon, partnerPubKey, 'tasks', {
+  direction: 'outbound',
+  filter: (item) => item.priority === 'high'
+});
+```
+
+### `get(holonId, lensName, dataId?, options?)`
+
+Retrieves data with automatic hologram resolution.
+
+**Options:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `resolveHolograms` | `boolean` | `true` | Resolve holograms to source data |
+| `capabilityToken` | `string` | auto | Capability for cross-holon access |
+
+```javascript
+// Get all tasks (holograms resolved by default)
+const tasks = await hs.get(myHolon, 'tasks');
+// Returns: [{ id: 't1', title: 'My Task' }, { id: 't2', title: 'Partner Task' }]
+
+// Get with hologram metadata visible
+const tasks = await hs.get(myHolon, 'tasks', null, { resolveHolograms: false });
+// Returns: [
+//   { id: 't1', title: 'My Task' },
+//   { id: 't2', hologram: true, target: {...}, title: 'Partner Task' }
+// ]
+
+// Get specific item
+const task = await hs.get(myHolon, 'tasks', 'task-1');
+```
+
+### `put(holonId, lensName, data, options?)`
+
+Writes data with automatic propagation and write-through.
+
+**Options:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `asAgent` | `string` | current | Private key to sign as |
+| `autoPropagate` | `boolean` | `true` | Auto-propagate to federated holons |
+| `blocking` | `boolean` | `false` | Wait for relay confirmation |
+| `validate` | `boolean` | `true` | Validate against schema |
+
+**Write-through behavior:** When updating a hologram, the write goes to the **source** holon if you have write capability.
+
+```javascript
+// Write to own holon
+await hs.put(hs.myHolon, 'tasks', { id: 't1', title: 'New Task' });
+
+// Update a hologram (writes through to source)
+await hs.put(hs.myHolon, 'tasks', { id: 'partner-task', status: 'done' });
+
+// Write as different agent
+await hs.put(partnerHolon, 'tasks', data, { asAgent: partnerPrivateKey });
+
+// Wait for relay confirmation
+await hs.put(hs.myHolon, 'tasks', data, { blocking: true });
+```
+
+### `propagate(holonId, lensName, data, options?)`
+
+Manually propagate data to all federated partners.
+
+```javascript
+// Propagate specific item to all outbound partners
+await hs.propagate(hs.myHolon, 'tasks', taskData);
+```
+
+### `unfederate(source, target, lensName)`
+
+Removes federation between two holons.
+
+```javascript
+await hs.unfederate(hs.myHolon, partnerPubKey, 'tasks');
+```
+
+---
+
+## Examples
+
+### Two Agents Sharing Tasks
+
+```javascript
+// === Alice's Code ===
+const alice = new HoloSphere({
+  appName: 'taskapp',
+  privateKey: aliceKey
+});
+await alice.ready();
+
+// Alice creates a task
+await alice.put(alice.myHolon, 'tasks', {
+  id: 'task-1',
+  title: 'Review proposal',
+  status: 'pending'
+});
+
+// Alice shares tasks with Bob
+await alice.federate(alice.myHolon, bobPubKey, 'tasks', {
+  direction: 'outbound'
+});
+
+// === Bob's Code ===
+const bob = new HoloSphere({
+  appName: 'taskapp',
+  privateKey: bobKey
+});
+await bob.ready();
+
+// Bob receives Alice's federation (inbound from his perspective)
+await bob.federate(bob.myHolon, alicePubKey, 'tasks', {
+  direction: 'inbound'
+});
+
+// Bob sees Alice's task as a hologram
+const tasks = await bob.get(bob.myHolon, 'tasks');
+console.log(tasks);
+// [{ id: 'task-1', title: 'Review proposal', status: 'pending' }]
+
+// Bob can check if it's a hologram
+const rawTasks = await bob.get(bob.myHolon, 'tasks', null, { resolveHolograms: false });
+console.log(rawTasks[0].hologram);  // true
+```
+
+### Bidirectional Sync
+
+```javascript
+// Both sides set up bidirectional federation
+await alice.federate(alice.myHolon, bobPubKey, 'notes', {
+  direction: 'bidirectional'
+});
+
+await bob.federate(bob.myHolon, alicePubKey, 'notes', {
+  direction: 'bidirectional'
+});
+
+// Now both see each other's notes
+// Alice's view: her notes + Bob's notes as holograms
+// Bob's view: his notes + Alice's notes as holograms
+```
+
+### Write-Through to Holograms
+
+```javascript
+// Bob has Alice's task as a hologram
+const tasks = await bob.get(bob.myHolon, 'tasks', null, { resolveHolograms: false });
+const aliceTask = tasks.find(t => t.hologram && t.id === 'task-1');
+
+// Bob updates the task (write-through to Alice's holon)
+await bob.put(bob.myHolon, 'tasks', {
+  id: 'task-1',
+  status: 'completed'  // This updates Alice's source
+});
+
+// Alice sees the update
+const updated = await alice.get(alice.myHolon, 'tasks', 'task-1');
+console.log(updated.status);  // 'completed'
+```
+
+### Detecting Holograms in UI
+
+```javascript
+// Get data with hologram info
+const items = await hs.get(myHolon, 'tasks', null, { resolveHolograms: false });
+
+items.forEach(item => {
+  if (item.hologram) {
+    // Show federated indicator
+    console.log(`${item.title} (from ${item.target.holonId.slice(0, 8)}...)`);
+  } else {
+    console.log(item.title);
+  }
+});
+```
+
+---
+
+## Best Practices
+
+### When to Use `blocking: true`
+
+Use blocking mode when:
+- You need to confirm data was saved before proceeding
+- Testing or debugging federation
+- Critical operations that must succeed
+
+```javascript
+// For critical writes
+await hs.put(myHolon, 'tasks', importantData, { blocking: true });
+
+// For normal writes, non-blocking is fine (faster)
+await hs.put(myHolon, 'tasks', regularData);
+```
+
+### Handling Capability Expiration
+
+Capabilities expire after their TTL (default 24h for cross-author). When a capability expires:
+
+1. Hologram reads will fail
+2. Write-through will be rejected
+3. Re-establish federation to get new capability
+
+```javascript
+try {
+  await hs.put(myHolon, 'tasks', update);
+} catch (err) {
+  if (err.message.includes('capability')) {
+    // Re-federate to refresh capability
+    await hs.federate(myHolon, partnerKey, 'tasks', { direction: 'inbound' });
+  }
+}
+```
+
+### Query Deduplication
+
+HoloSphere deduplicates queries within a 2-second window. If you need fresh data immediately after a write:
+
+```javascript
+// Write
+await hs.put(myHolon, 'tasks', { id: 't1', status: 'done' }, { blocking: true });
+
+// Wait for dedup window if querying same path
+await new Promise(r => setTimeout(r, 2100));
+
+// Now query returns fresh data
+const fresh = await hs.get(myHolon, 'tasks');
+```
+
+### Local Overrides on Holograms
+
+Store local-only properties (position, pinned status) on holograms:
+
+```javascript
+await hs.updateHologramOverrides(myHolon, 'tasks', 'task-1', {
+  x: 100,
+  y: 200,
+  pinned: true
+});
+```
+
+---
+
+## Error Handling
+
+### AuthorizationError
+
+Thrown when:
+- Writing to a holon you don't own (without capability)
+- Capability expired or invalid
+- Write-through without write permission
+
+```javascript
+try {
+  await hs.put(otherHolon, 'tasks', data);
+} catch (err) {
+  if (err.name === 'AuthorizationError') {
+    console.log('Cannot write to this holon');
+  }
+}
+```
+
+### ValidationError
+
+Thrown when data doesn't match schema.
+
+```javascript
+try {
+  await hs.put(myHolon, 'tasks', invalidData);
+} catch (err) {
+  if (err.name === 'ValidationError') {
+    console.log('Invalid data:', err.message);
+  }
+}
+```
+
+---
+
+## TypeScript Types
+
+```typescript
+interface FederateOptions {
+  direction?: 'inbound' | 'outbound' | 'bidirectional';
+  mode?: 'reference' | 'copy';
+  propagate?: boolean;
+  filter?: (item: any) => boolean;
+  permissions?: string[];
+}
+
+interface GetOptions {
+  resolveHolograms?: boolean;
+  capabilityToken?: string;
+}
+
+interface PutOptions {
+  asAgent?: string;
+  autoPropagate?: boolean;
+  blocking?: boolean;
+  validate?: boolean;
+}
+
+interface Hologram {
+  id: string;
+  hologram: true;
+  soul: string;
+  target: {
+    holonId: string;
+    lensName: string;
+    dataId: string;
+    authorPubKey?: string;
+  };
+  capability: string;
+  _meta?: {
+    sourceHolon: string;
+    sourcePubKey: string;
+    grantedAt: number;
+  };
+  // ... cached data fields
+  // ... local overrides
+}
+```