npm - holosphere - Versions diffs - 2.0.0-alpha7 → 2.0.0-alpha9 - Mend

holosphere 2.0.0-alpha7 → 2.0.0-alpha9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (327) hide show

package/CHANGELOG.md +446 -0
package/FEATURES.md +431 -0
package/LICENSE +29 -166
package/LICENSE-AGPL.md +180 -0
package/dist/cdn/holosphere.min.js +55 -0
package/dist/cdn/holosphere.min.js.map +1 -0
package/dist/cjs/holosphere.cjs +1 -1
package/dist/esm/holosphere.js +1 -1
package/dist/{index-C-IlLYlk.cjs → index-DDGt_V9o.cjs} +2 -2
package/dist/{index-C-IlLYlk.cjs.map → index-DDGt_V9o.cjs.map} +1 -1
package/dist/{index-d6f4RJBM.js → index-DJXftyvB.js} +2253 -387
package/dist/index-DJXftyvB.js.map +1 -0
package/dist/index-DMbdcMtK.cjs +18 -0
package/dist/index-DMbdcMtK.cjs.map +1 -0
package/dist/{index-jmTHEbR2.js → index-DeZ1xz_s.js} +2 -2
package/dist/{index-jmTHEbR2.js.map → index-DeZ1xz_s.js.map} +1 -1
package/dist/{indexeddb-storage-D8kOl0oK.js → indexeddb-storage-BFt6hMeF.js} +48 -4
package/dist/indexeddb-storage-BFt6hMeF.js.map +1 -0
package/dist/{indexeddb-storage-a8GipaDr.cjs → indexeddb-storage-BK5tv4Sh.cjs} +2 -2
package/dist/indexeddb-storage-BK5tv4Sh.cjs.map +1 -0
package/dist/{memory-storage-DBQK622V.js → memory-storage-C9HuoL2E.js} +44 -4
package/dist/memory-storage-C9HuoL2E.js.map +1 -0
package/dist/{memory-storage-gfRovk2O.cjs → memory-storage-Dao7jfYG.cjs} +2 -2
package/dist/memory-storage-Dao7jfYG.cjs.map +1 -0
package/dist/{secp256k1-BCAPF45D.cjs → secp256k1-BbKzbLtD.cjs} +2 -2
package/dist/{secp256k1-BCAPF45D.cjs.map → secp256k1-BbKzbLtD.cjs.map} +1 -1
package/dist/{secp256k1-DYm_CMqW.js → secp256k1-CreY7Pcl.js} +2 -2
package/dist/{secp256k1-DYm_CMqW.js.map → secp256k1-CreY7Pcl.js.map} +1 -1
package/docs/api/ai_aggregation.js.html +333 -0
package/docs/api/ai_breakdown.js.html +524 -0
package/docs/api/ai_classifier.js.html +231 -0
package/docs/api/ai_council.js.html +246 -0
package/docs/api/ai_embeddings.js.html +304 -0
package/docs/api/ai_federation-ai.js.html +338 -0
package/docs/api/ai_h3-ai.js.html +970 -0
package/docs/api/ai_index.js.html +124 -0
package/docs/api/ai_json-ops.js.html +241 -0
package/docs/api/ai_llm-service.js.html +239 -0
package/docs/api/ai_nl-query.js.html +236 -0
package/docs/api/ai_relationships.js.html +367 -0
package/docs/api/ai_schema-extractor.js.html +235 -0
package/docs/api/ai_spatial.js.html +307 -0
package/docs/api/ai_tts.js.html +214 -0
package/docs/api/content_social-protocols.js.html +180 -0
package/docs/api/core_holosphere.js.html +757 -0
package/docs/api/crypto_nostr-utils.js.html +306 -0
package/docs/api/crypto_secp256k1.js.html +267 -0
package/docs/api/data/search.json +1 -0
package/docs/api/federation_discovery.js.html +337 -0
package/docs/api/federation_handshake.js.html +478 -0
package/docs/api/federation_hologram.js.html +1053 -0
package/docs/api/federation_registry.js.html +389 -0
package/docs/api/fonts/Inconsolata-Regular.ttf +0 -0
package/docs/api/fonts/OpenSans-Regular.ttf +0 -0
package/docs/api/fonts/WorkSans-Bold.ttf +0 -0
package/docs/api/global.html +3 -0
package/docs/api/hierarchical_upcast.js.html +128 -0
package/docs/api/index.html +265 -0
package/docs/api/index.js.html +1868 -0
package/docs/api/lib_ai-methods.js.html +660 -0
package/docs/api/lib_contract-methods.js.html +445 -0
package/docs/api/lib_errors.js.html +56 -0
package/docs/api/lib_federation-methods.js.html +348 -0
package/docs/api/lib_index.js.html +33 -0
package/docs/api/module-ai.html +5 -0
package/docs/api/module-ai_aggregation-SmartAggregation.html +6 -0
package/docs/api/module-ai_aggregation.SmartAggregation.html +3 -0
package/docs/api/module-ai_aggregation.html +3 -0
package/docs/api/module-ai_breakdown-TaskBreakdown.html +5 -0
package/docs/api/module-ai_breakdown.TaskBreakdown.html +3 -0
package/docs/api/module-ai_breakdown.html +3 -0
package/docs/api/module-ai_classifier-Classifier.html +6 -0
package/docs/api/module-ai_classifier.Classifier.html +3 -0
package/docs/api/module-ai_classifier.html +3 -0
package/docs/api/module-ai_council-Council.html +6 -0
package/docs/api/module-ai_council.Council.html +3 -0
package/docs/api/module-ai_council.html +3 -0
package/docs/api/module-ai_embeddings-Embeddings.html +5 -0
package/docs/api/module-ai_embeddings.Embeddings.html +3 -0
package/docs/api/module-ai_embeddings.html +3 -0
package/docs/api/module-ai_federation-ai-FederationAdvisor.html +6 -0
package/docs/api/module-ai_federation-ai.FederationAdvisor.html +3 -0
package/docs/api/module-ai_federation-ai.html +3 -0
package/docs/api/module-ai_h3-ai-H3AI.html +6 -0
package/docs/api/module-ai_h3-ai.H3AI.html +3 -0
package/docs/api/module-ai_h3-ai.html +3 -0
package/docs/api/module-ai_json-ops-JSONOps.html +5 -0
package/docs/api/module-ai_json-ops.JSONOps.html +3 -0
package/docs/api/module-ai_json-ops.html +3 -0
package/docs/api/module-ai_llm-service-LLMService.html +5 -0
package/docs/api/module-ai_llm-service.LLMService.html +3 -0
package/docs/api/module-ai_llm-service.html +3 -0
package/docs/api/module-ai_nl-query-NLQuery.html +5 -0
package/docs/api/module-ai_nl-query.NLQuery.html +3 -0
package/docs/api/module-ai_nl-query.html +3 -0
package/docs/api/module-ai_relationships-RelationshipDiscovery.html +6 -0
package/docs/api/module-ai_relationships.RelationshipDiscovery.html +3 -0
package/docs/api/module-ai_relationships.html +3 -0
package/docs/api/module-ai_schema-extractor-SchemaExtractor.html +5 -0
package/docs/api/module-ai_schema-extractor.SchemaExtractor.html +3 -0
package/docs/api/module-ai_schema-extractor.html +3 -0
package/docs/api/module-ai_spatial-SpatialAnalysis.html +6 -0
package/docs/api/module-ai_spatial.SpatialAnalysis.html +3 -0
package/docs/api/module-ai_spatial.html +3 -0
package/docs/api/module-ai_tts-TTS.html +5 -0
package/docs/api/module-ai_tts.TTS.html +3 -0
package/docs/api/module-ai_tts.html +3 -0
package/docs/api/module-content_social-protocols.html +3 -0
package/docs/api/module-core_holosphere-HoloSphere.html +6 -0
package/docs/api/module-core_holosphere.HoloSphere.html +3 -0
package/docs/api/module-core_holosphere.html +3 -0
package/docs/api/module-crypto_nostr-utils.html +3 -0
package/docs/api/module-crypto_secp256k1.html +3 -0
package/docs/api/module-federation_hologram.html +3 -0
package/docs/api/module-hierarchical_upcast.html +3 -0
package/docs/api/module-holosphere-HoloSphereBase.html +3 -0
package/docs/api/module-holosphere.html +3 -0
package/docs/api/module-lib_ai-methods.html +3 -0
package/docs/api/module-lib_contract-methods.html +3 -0
package/docs/api/module-lib_errors-AuthorizationError.html +3 -0
package/docs/api/module-lib_errors-ValidationError.html +3 -0
package/docs/api/module-lib_errors.AuthorizationError.html +3 -0
package/docs/api/module-lib_errors.ValidationError.html +3 -0
package/docs/api/module-lib_errors.html +3 -0
package/docs/api/module-lib_federation-methods.html +3 -0
package/docs/api/module-lib_index.html +3 -0
package/docs/api/module-schema_validator-ValidationError.html +3 -0
package/docs/api/module-schema_validator.ValidationError.html +3 -0
package/docs/api/module-schema_validator.html +3 -0
package/docs/api/module-spatial_h3-operations.html +4 -0
package/docs/api/module-storage_backend-factory.BackendFactory.html +3 -0
package/docs/api/module-storage_backend-factory.html +3 -0
package/docs/api/module-storage_backend-interface-StorageBackend.html +3 -0
package/docs/api/module-storage_backend-interface.StorageBackend.html +3 -0
package/docs/api/module-storage_backend-interface.html +3 -0
package/docs/api/module-storage_backends_activitypub-backend-ActivityPubBackend.html +7 -0
package/docs/api/module-storage_backends_activitypub-backend.ActivityPubBackend.html +3 -0
package/docs/api/module-storage_backends_activitypub-backend.html +3 -0
package/docs/api/module-storage_backends_activitypub_server-ActivityPubServer.html +8 -0
package/docs/api/module-storage_backends_activitypub_server.ActivityPubServer.html +3 -0
package/docs/api/module-storage_backends_activitypub_server.html +3 -0
package/docs/api/module-storage_backends_gundb-backend-GunDBBackend.html +7 -0
package/docs/api/module-storage_backends_gundb-backend.GunDBBackend.html +3 -0
package/docs/api/module-storage_backends_gundb-backend.html +3 -0
package/docs/api/module-storage_backends_nostr-backend-NostrBackend.html +8 -0
package/docs/api/module-storage_backends_nostr-backend.NostrBackend.html +3 -0
package/docs/api/module-storage_backends_nostr-backend.html +3 -0
package/docs/api/module-storage_filesystem-storage-FileSystemStorage.html +5 -0
package/docs/api/module-storage_filesystem-storage-browser-FileSystemStorage.html +3 -0
package/docs/api/module-storage_filesystem-storage-browser.FileSystemStorage.html +3 -0
package/docs/api/module-storage_filesystem-storage-browser.html +3 -0
package/docs/api/module-storage_filesystem-storage.FileSystemStorage.html +3 -0
package/docs/api/module-storage_filesystem-storage.html +3 -0
package/docs/api/module-storage_global-tables.html +3 -0
package/docs/api/module-storage_gun-async.html +3 -0
package/docs/api/module-storage_gun-auth-GunAuth.html +5 -0
package/docs/api/module-storage_gun-auth.GunAuth.html +3 -0
package/docs/api/module-storage_gun-auth.html +3 -0
package/docs/api/module-storage_gun-federation.html +3 -0
package/docs/api/module-storage_gun-references-GunReferenceHandler.html +5 -0
package/docs/api/module-storage_gun-references.GunReferenceHandler.html +3 -0
package/docs/api/module-storage_gun-references.html +3 -0
package/docs/api/module-storage_gun-schema-GunSchemaValidator.html +5 -0
package/docs/api/module-storage_gun-schema.GunSchemaValidator.html +3 -0
package/docs/api/module-storage_gun-schema.html +3 -0
package/docs/api/module-storage_gun-wrapper.html +11 -0
package/docs/api/module-storage_indexeddb-storage-IndexedDBStorage.html +5 -0
package/docs/api/module-storage_indexeddb-storage.IndexedDBStorage.html +3 -0
package/docs/api/module-storage_indexeddb-storage.html +3 -0
package/docs/api/module-storage_key-storage-simple.html +3 -0
package/docs/api/module-storage_key-storage.html +4 -0
package/docs/api/module-storage_memory-storage-MemoryStorage.html +5 -0
package/docs/api/module-storage_memory-storage.MemoryStorage.html +3 -0
package/docs/api/module-storage_memory-storage.html +3 -0
package/docs/api/module-storage_migration-MigrationTool.html +6 -0
package/docs/api/module-storage_migration.MigrationTool.html +3 -0
package/docs/api/module-storage_migration.html +3 -0
package/docs/api/module-storage_nostr-async.html +18 -0
package/docs/api/module-storage_nostr-client-LRUCache.html +3 -0
package/docs/api/module-storage_nostr-client-NostrClient.html +7 -0
package/docs/api/module-storage_nostr-client.NostrClient.html +15 -0
package/docs/api/module-storage_nostr-client.html +6 -0
package/docs/api/module-storage_nostr-wrapper.html +3 -0
package/docs/api/module-storage_outbox-queue-OutboxQueue.html +4 -0
package/docs/api/module-storage_outbox-queue.OutboxQueue.html +3 -0
package/docs/api/module-storage_outbox-queue.html +3 -0
package/docs/api/module-storage_persistent-storage-PersistentStorage.html +3 -0
package/docs/api/module-storage_persistent-storage.html +4 -0
package/docs/api/module-storage_sync-service-SyncService.html +5 -0
package/docs/api/module-storage_sync-service.SyncService.html +3 -0
package/docs/api/module-storage_sync-service.html +3 -0
package/docs/api/module-storage_unified-storage.html +3 -0
package/docs/api/module-subscriptions_manager.SubscriptionRegistry.html +3 -0
package/docs/api/module-subscriptions_manager.html +3 -0
package/docs/api/schema_validator.js.html +113 -0
package/docs/api/scripts/core.js +726 -0
package/docs/api/scripts/core.min.js +23 -0
package/docs/api/scripts/resize.js +90 -0
package/docs/api/scripts/search.js +265 -0
package/docs/api/scripts/search.min.js +6 -0
package/docs/api/scripts/third-party/Apache-License-2.0.txt +202 -0
package/docs/api/scripts/third-party/fuse.js +9 -0
package/docs/api/scripts/third-party/hljs-line-num-original.js +369 -0
package/docs/api/scripts/third-party/hljs-line-num.js +1 -0
package/docs/api/scripts/third-party/hljs-original.js +5171 -0
package/docs/api/scripts/third-party/hljs.js +1 -0
package/docs/api/scripts/third-party/popper.js +5 -0
package/docs/api/scripts/third-party/tippy.js +1 -0
package/docs/api/scripts/third-party/tocbot.js +672 -0
package/docs/api/scripts/third-party/tocbot.min.js +1 -0
package/docs/api/spatial_h3-operations.js.html +129 -0
package/docs/api/storage_backend-factory.js.html +133 -0
package/docs/api/storage_backend-interface.js.html +164 -0
package/docs/api/storage_backends_activitypub-backend.js.html +298 -0
package/docs/api/storage_backends_activitypub_server.js.html +678 -0
package/docs/api/storage_backends_gundb-backend.js.html +878 -0
package/docs/api/storage_backends_nostr-backend.js.html +254 -0
package/docs/api/storage_filesystem-storage-browser.js.html +83 -0
package/docs/api/storage_filesystem-storage.js.html +207 -0
package/docs/api/storage_global-tables.js.html +116 -0
package/docs/api/storage_gun-async.js.html +344 -0
package/docs/api/storage_gun-auth.js.html +376 -0
package/docs/api/storage_gun-federation.js.html +788 -0
package/docs/api/storage_gun-references.js.html +212 -0
package/docs/api/storage_gun-schema.js.html +309 -0
package/docs/api/storage_gun-wrapper.js.html +645 -0
package/docs/api/storage_indexeddb-storage.js.html +224 -0
package/docs/api/storage_key-storage-simple.js.html +102 -0
package/docs/api/storage_key-storage.js.html +171 -0
package/docs/api/storage_memory-storage.js.html +128 -0
package/docs/api/storage_migration.js.html +354 -0
package/docs/api/storage_nostr-async.js.html +1076 -0
package/docs/api/storage_nostr-client.js.html +1598 -0
package/docs/api/storage_nostr-wrapper.js.html +218 -0
package/docs/api/storage_outbox-queue.js.html +248 -0
package/docs/api/storage_persistent-storage.js.html +160 -0
package/docs/api/storage_sync-service.js.html +201 -0
package/docs/api/storage_unified-storage.js.html +157 -0
package/docs/api/styles/clean-jsdoc-theme-base.css +1159 -0
package/docs/api/styles/clean-jsdoc-theme-dark.css +412 -0
package/docs/api/styles/clean-jsdoc-theme-light.css +482 -0
package/docs/api/styles/clean-jsdoc-theme-scrollbar.css +30 -0
package/docs/api/styles/clean-jsdoc-theme-without-scrollbar.min.css +1 -0
package/docs/api/styles/clean-jsdoc-theme.min.css +1 -0
package/docs/api/subscriptions_manager.js.html +162 -0
package/examples/holosphere-widget.js +1242 -0
package/examples/widget-demo.html +274 -0
package/examples/widget.html +703 -0
package/jsdoc.json +26 -0
package/package.json +16 -3
package/src/ai/aggregation.js +13 -2
package/src/ai/breakdown.js +12 -2
package/src/ai/classifier.js +14 -3
package/src/ai/council.js +22 -7
package/src/ai/embeddings.js +37 -15
package/src/ai/federation-ai.js +13 -2
package/src/ai/h3-ai.js +14 -2
package/src/ai/index.js +16 -7
package/src/ai/json-ops.js +18 -5
package/src/ai/llm-service.js +62 -31
package/src/ai/nl-query.js +12 -2
package/src/ai/relationships.js +13 -2
package/src/ai/schema-extractor.js +24 -10
package/src/ai/spatial.js +13 -2
package/src/ai/tts.js +25 -8
package/src/cdn-entry.js +22 -0
package/src/content/social-protocols.js +34 -25
package/src/contracts/chain-manager.js +68 -40
package/src/contracts/deployer.js +70 -42
package/src/contracts/event-listener.js +61 -29
package/src/contracts/holon-contracts.js +46 -31
package/src/contracts/index.js +5 -6
package/src/contracts/networks.js +19 -14
package/src/contracts/operations.js +58 -41
package/src/contracts/queries.js +70 -21
package/src/core/holosphere.js +37 -8
package/src/crypto/nostr-utils.js +105 -65
package/src/crypto/secp256k1.js +7 -2
package/src/federation/handshake.js +23 -11
package/src/federation/hologram.js +9 -1
package/src/hierarchical/upcast.js +34 -20
package/src/index.js +671 -7
package/src/lib/ai-methods.js +352 -3
package/src/lib/contract-methods.js +152 -3
package/src/lib/errors.js +31 -1
package/src/lib/federation-methods.js +110 -3
package/src/lib/index.js +9 -5
package/src/schema/validator.js +22 -3
package/src/spatial/h3-operations.js +17 -1
package/src/storage/backend-factory.js +7 -2
package/src/storage/backend-interface.js +21 -2
package/src/storage/backends/activitypub/server.js +25 -3
package/src/storage/backends/activitypub-backend.js +25 -2
package/src/storage/backends/gundb-backend.js +322 -11
package/src/storage/backends/nostr-backend.js +116 -1
package/src/storage/filesystem-storage-browser.js +42 -2
package/src/storage/filesystem-storage.js +72 -5
package/src/storage/global-tables.js +7 -2
package/src/storage/gun-async.js +20 -11
package/src/storage/gun-auth.js +15 -4
package/src/storage/gun-federation.js +14 -5
package/src/storage/gun-references.js +16 -5
package/src/storage/gun-schema.js +25 -10
package/src/storage/gun-wrapper.js +160 -49
package/src/storage/indexeddb-storage.js +65 -4
package/src/storage/key-storage-simple.js +32 -9
package/src/storage/key-storage.js +45 -13
package/src/storage/memory-storage.js +65 -4
package/src/storage/migration.js +20 -7
package/src/storage/nostr-async.js +195 -90
package/src/storage/nostr-client.js +173 -49
package/src/storage/nostr-wrapper.js +6 -2
package/src/storage/outbox-queue.js +55 -18
package/src/storage/persistent-storage.js +56 -13
package/src/storage/sync-service.js +51 -17
package/src/storage/unified-storage.js +38 -3
package/src/subscriptions/manager.js +33 -16
package/vite.config.cdn.js +60 -0
package/dist/index-Bvwyvd0T.cjs +0 -5
package/dist/index-Bvwyvd0T.cjs.map +0 -1
package/dist/index-d6f4RJBM.js.map +0 -1
package/dist/indexeddb-storage-D8kOl0oK.js.map +0 -1
package/dist/indexeddb-storage-a8GipaDr.cjs.map +0 -1
package/dist/memory-storage-DBQK622V.js.map +0 -1
package/dist/memory-storage-gfRovk2O.cjs.map +0 -1
/package/{cleanup-test-data.js → scripts/cleanup-test-data.js} +0 -0
/package/{test-ai-real-api.js → scripts/test-ai-real-api.js} +0 -0

package/docs/api/storage_nostr-client.js.html ADDED Viewed

@@ -0,0 +1,1598 @@
+<!DOCTYPE html><html lang="en" style="font-size:16px"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Source: storage/nostr-client.js</title><!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]--><script src="scripts/third-party/hljs.js" defer="defer"></script><script src="scripts/third-party/hljs-line-num.js" defer="defer"></script><script src="scripts/third-party/popper.js" defer="defer"></script><script src="scripts/third-party/tippy.js" defer="defer"></script><script src="scripts/third-party/tocbot.min.js"></script><script>var baseURL="/",locationPathname="";baseURL=(locationPathname=document.location.pathname).substr(0,locationPathname.lastIndexOf("/")+1)</script><link rel="stylesheet" href="styles/clean-jsdoc-theme.min.css"><svg aria-hidden="true" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="display:none"><defs><symbol id="copy-icon" viewbox="0 0 488.3 488.3"><g><path d="M314.25,85.4h-227c-21.3,0-38.6,17.3-38.6,38.6v325.7c0,21.3,17.3,38.6,38.6,38.6h227c21.3,0,38.6-17.3,38.6-38.6V124    C352.75,102.7,335.45,85.4,314.25,85.4z M325.75,449.6c0,6.4-5.2,11.6-11.6,11.6h-227c-6.4,0-11.6-5.2-11.6-11.6V124    c0-6.4,5.2-11.6,11.6-11.6h227c6.4,0,11.6,5.2,11.6,11.6V449.6z"/><path d="M401.05,0h-227c-21.3,0-38.6,17.3-38.6,38.6c0,7.5,6,13.5,13.5,13.5s13.5-6,13.5-13.5c0-6.4,5.2-11.6,11.6-11.6h227    c6.4,0,11.6,5.2,11.6,11.6v325.7c0,6.4-5.2,11.6-11.6,11.6c-7.5,0-13.5,6-13.5,13.5s6,13.5,13.5,13.5c21.3,0,38.6-17.3,38.6-38.6    V38.6C439.65,17.3,422.35,0,401.05,0z"/></g></symbol><symbol id="search-icon" viewBox="0 0 512 512"><g><g><path d="M225.474,0C101.151,0,0,101.151,0,225.474c0,124.33,101.151,225.474,225.474,225.474    c124.33,0,225.474-101.144,225.474-225.474C450.948,101.151,349.804,0,225.474,0z M225.474,409.323    c-101.373,0-183.848-82.475-183.848-183.848S124.101,41.626,225.474,41.626s183.848,82.475,183.848,183.848    S326.847,409.323,225.474,409.323z"/></g></g><g><g><path d="M505.902,476.472L386.574,357.144c-8.131-8.131-21.299-8.131-29.43,0c-8.131,8.124-8.131,21.306,0,29.43l119.328,119.328    c4.065,4.065,9.387,6.098,14.715,6.098c5.321,0,10.649-2.033,14.715-6.098C514.033,497.778,514.033,484.596,505.902,476.472z"/></g></g></symbol><symbol id="font-size-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11.246 15H4.754l-2 5H.6L7 4h2l6.4 16h-2.154l-2-5zm-.8-2L8 6.885 5.554 13h4.892zM21 12.535V12h2v8h-2v-.535a4 4 0 1 1 0-6.93zM19 18a2 2 0 1 0 0-4 2 2 0 0 0 0 4z"/></symbol><symbol id="add-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11 11V5h2v6h6v2h-6v6h-2v-6H5v-2z"/></symbol><symbol id="minus-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M5 11h14v2H5z"/></symbol><symbol id="dark-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M10 7a7 7 0 0 0 12 4.9v.1c0 5.523-4.477 10-10 10S2 17.523 2 12 6.477 2 12 2h.1A6.979 6.979 0 0 0 10 7zm-6 5a8 8 0 0 0 15.062 3.762A9 9 0 0 1 8.238 4.938 7.999 7.999 0 0 0 4 12z"/></symbol><symbol id="light-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 18a6 6 0 1 1 0-12 6 6 0 0 1 0 12zm0-2a4 4 0 1 0 0-8 4 4 0 0 0 0 8zM11 1h2v3h-2V1zm0 19h2v3h-2v-3zM3.515 4.929l1.414-1.414L7.05 5.636 5.636 7.05 3.515 4.93zM16.95 18.364l1.414-1.414 2.121 2.121-1.414 1.414-2.121-2.121zm2.121-14.85l1.414 1.415-2.121 2.121-1.414-1.414 2.121-2.121zM5.636 16.95l1.414 1.414-2.121 2.121-1.414-1.414 2.121-2.121zM23 11v2h-3v-2h3zM4 11v2H1v-2h3z"/></symbol><symbol id="reset-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M18.537 19.567A9.961 9.961 0 0 1 12 22C6.477 22 2 17.523 2 12S6.477 2 12 2s10 4.477 10 10c0 2.136-.67 4.116-1.81 5.74L17 12h3a8 8 0 1 0-2.46 5.772l.997 1.795z"/></symbol><symbol id="down-icon" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M12.7803 6.21967C13.0732 6.51256 13.0732 6.98744 12.7803 7.28033L8.53033 11.5303C8.23744 11.8232 7.76256 11.8232 7.46967 11.5303L3.21967 7.28033C2.92678 6.98744 2.92678 6.51256 3.21967 6.21967C3.51256 5.92678 3.98744 5.92678 4.28033 6.21967L8 9.93934L11.7197 6.21967C12.0126 5.92678 12.4874 5.92678 12.7803 6.21967Z"></path></symbol><symbol id="codepen-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M16.5 13.202L13 15.535v3.596L19.197 15 16.5 13.202zM14.697 12L12 10.202 9.303 12 12 13.798 14.697 12zM20 10.869L18.303 12 20 13.131V10.87zM19.197 9L13 4.869v3.596l3.5 2.333L19.197 9zM7.5 10.798L11 8.465V4.869L4.803 9 7.5 10.798zM4.803 15L11 19.131v-3.596l-3.5-2.333L4.803 15zM4 13.131L5.697 12 4 10.869v2.262zM2 9a1 1 0 0 1 .445-.832l9-6a1 1 0 0 1 1.11 0l9 6A1 1 0 0 1 22 9v6a1 1 0 0 1-.445.832l-9 6a1 1 0 0 1-1.11 0l-9-6A1 1 0 0 1 2 15V9z"/></symbol><symbol id="close-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 10.586l4.95-4.95 1.414 1.414-4.95 4.95 4.95 4.95-1.414 1.414-4.95-4.95-4.95 4.95-1.414-1.414 4.95-4.95-4.95-4.95L7.05 5.636z"/></symbol><symbol id="menu-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M3 4h18v2H3V4zm0 7h18v2H3v-2zm0 7h18v2H3v-2z"/></symbol></defs></svg></head><body data-theme="dark"><div class="sidebar-container"><div class="sidebar" id="sidebar"><div class="sidebar-items-container"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-modules"><div>Modules</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-ai.html">ai</a></div><div class="sidebar-section-children"><a href="module-ai_aggregation.html">ai/aggregation</a></div><div class="sidebar-section-children"><a href="module-ai_breakdown.html">ai/breakdown</a></div><div class="sidebar-section-children"><a href="module-ai_classifier.html">ai/classifier</a></div><div class="sidebar-section-children"><a href="module-ai_council.html">ai/council</a></div><div class="sidebar-section-children"><a href="module-ai_embeddings.html">ai/embeddings</a></div><div class="sidebar-section-children"><a href="module-ai_federation-ai.html">ai/federation-ai</a></div><div class="sidebar-section-children"><a href="module-ai_h3-ai.html">ai/h3-ai</a></div><div class="sidebar-section-children"><a href="module-ai_json-ops.html">ai/json-ops</a></div><div class="sidebar-section-children"><a href="module-ai_llm-service.html">ai/llm-service</a></div><div class="sidebar-section-children"><a href="module-ai_nl-query.html">ai/nl-query</a></div><div class="sidebar-section-children"><a href="module-ai_relationships.html">ai/relationships</a></div><div class="sidebar-section-children"><a href="module-ai_schema-extractor.html">ai/schema-extractor</a></div><div class="sidebar-section-children"><a href="module-ai_spatial.html">ai/spatial</a></div><div class="sidebar-section-children"><a href="module-ai_tts.html">ai/tts</a></div><div class="sidebar-section-children"><a href="module-content_social-protocols.html">content/social-protocols</a></div><div class="sidebar-section-children"><a href="module-core_holosphere.html">core/holosphere</a></div><div class="sidebar-section-children"><a href="module-crypto_nostr-utils.html">crypto/nostr-utils</a></div><div class="sidebar-section-children"><a href="module-crypto_secp256k1.html">crypto/secp256k1</a></div><div class="sidebar-section-children"><a href="module-federation_hologram.html">federation/hologram</a></div><div class="sidebar-section-children"><a href="module-hierarchical_upcast.html">hierarchical/upcast</a></div><div class="sidebar-section-children"><a href="module-holosphere.html">holosphere</a></div><div class="sidebar-section-children"><a href="module-lib_ai-methods.html">lib/ai-methods</a></div><div class="sidebar-section-children"><a href="module-lib_contract-methods.html">lib/contract-methods</a></div><div class="sidebar-section-children"><a href="module-lib_errors.html">lib/errors</a></div><div class="sidebar-section-children"><a href="module-lib_federation-methods.html">lib/federation-methods</a></div><div class="sidebar-section-children"><a href="module-lib_index.html">lib/index</a></div><div class="sidebar-section-children"><a href="module-schema_validator.html">schema/validator</a></div><div class="sidebar-section-children"><a href="module-spatial_h3-operations.html">spatial/h3-operations</a></div><div class="sidebar-section-children"><a href="module-storage_backend-factory.html">storage/backend-factory</a></div><div class="sidebar-section-children"><a href="module-storage_backend-interface.html">storage/backend-interface</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub-backend.html">storage/backends/activitypub-backend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub_server.html">storage/backends/activitypub/server</a></div><div class="sidebar-section-children"><a href="module-storage_backends_gundb-backend.html">storage/backends/gundb-backend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_nostr-backend.html">storage/backends/nostr-backend</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage.html">storage/filesystem-storage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-browser.html">storage/filesystem-storage-browser</a></div><div class="sidebar-section-children"><a href="module-storage_global-tables.html">storage/global-tables</a></div><div class="sidebar-section-children"><a href="module-storage_gun-async.html">storage/gun-async</a></div><div class="sidebar-section-children"><a href="module-storage_gun-auth.html">storage/gun-auth</a></div><div class="sidebar-section-children"><a href="module-storage_gun-federation.html">storage/gun-federation</a></div><div class="sidebar-section-children"><a href="module-storage_gun-references.html">storage/gun-references</a></div><div class="sidebar-section-children"><a href="module-storage_gun-schema.html">storage/gun-schema</a></div><div class="sidebar-section-children"><a href="module-storage_gun-wrapper.html">storage/gun-wrapper</a></div><div class="sidebar-section-children"><a href="module-storage_indexeddb-storage.html">storage/indexeddb-storage</a></div><div class="sidebar-section-children"><a href="module-storage_key-storage.html">storage/key-storage</a></div><div class="sidebar-section-children"><a href="module-storage_key-storage-simple.html">storage/key-storage-simple</a></div><div class="sidebar-section-children"><a href="module-storage_memory-storage.html">storage/memory-storage</a></div><div class="sidebar-section-children"><a href="module-storage_migration.html">storage/migration</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-async.html">storage/nostr-async</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client.html">storage/nostr-client</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-wrapper.html">storage/nostr-wrapper</a></div><div class="sidebar-section-children"><a href="module-storage_outbox-queue.html">storage/outbox-queue</a></div><div class="sidebar-section-children"><a href="module-storage_persistent-storage.html">storage/persistent-storage</a></div><div class="sidebar-section-children"><a href="module-storage_sync-service.html">storage/sync-service</a></div><div class="sidebar-section-children"><a href="module-storage_unified-storage.html">storage/unified-storage</a></div><div class="sidebar-section-children"><a href="module-subscriptions_manager.html">subscriptions/manager</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-classes"><div>Classes</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-ai_aggregation.SmartAggregation.html">SmartAggregation</a></div><div class="sidebar-section-children"><a href="module-ai_aggregation-SmartAggregation.html">SmartAggregation</a></div><div class="sidebar-section-children"><a href="module-ai_breakdown.TaskBreakdown.html">TaskBreakdown</a></div><div class="sidebar-section-children"><a href="module-ai_breakdown-TaskBreakdown.html">TaskBreakdown</a></div><div class="sidebar-section-children"><a href="module-ai_classifier.Classifier.html">Classifier</a></div><div class="sidebar-section-children"><a href="module-ai_classifier-Classifier.html">Classifier</a></div><div class="sidebar-section-children"><a href="module-ai_council.Council.html">Council</a></div><div class="sidebar-section-children"><a href="module-ai_council-Council.html">Council</a></div><div class="sidebar-section-children"><a href="module-ai_embeddings.Embeddings.html">Embeddings</a></div><div class="sidebar-section-children"><a href="module-ai_embeddings-Embeddings.html">Embeddings</a></div><div class="sidebar-section-children"><a href="module-ai_federation-ai.FederationAdvisor.html">FederationAdvisor</a></div><div class="sidebar-section-children"><a href="module-ai_federation-ai-FederationAdvisor.html">FederationAdvisor</a></div><div class="sidebar-section-children"><a href="module-ai_h3-ai.H3AI.html">H3AI</a></div><div class="sidebar-section-children"><a href="module-ai_h3-ai-H3AI.html">H3AI</a></div><div class="sidebar-section-children"><a href="module-ai_json-ops.JSONOps.html">JSONOps</a></div><div class="sidebar-section-children"><a href="module-ai_json-ops-JSONOps.html">JSONOps</a></div><div class="sidebar-section-children"><a href="module-ai_llm-service.LLMService.html">LLMService</a></div><div class="sidebar-section-children"><a href="module-ai_llm-service-LLMService.html">LLMService</a></div><div class="sidebar-section-children"><a href="module-ai_nl-query.NLQuery.html">NLQuery</a></div><div class="sidebar-section-children"><a href="module-ai_nl-query-NLQuery.html">NLQuery</a></div><div class="sidebar-section-children"><a href="module-ai_relationships.RelationshipDiscovery.html">RelationshipDiscovery</a></div><div class="sidebar-section-children"><a href="module-ai_relationships-RelationshipDiscovery.html">RelationshipDiscovery</a></div><div class="sidebar-section-children"><a href="module-ai_schema-extractor.SchemaExtractor.html">SchemaExtractor</a></div><div class="sidebar-section-children"><a href="module-ai_schema-extractor-SchemaExtractor.html">SchemaExtractor</a></div><div class="sidebar-section-children"><a href="module-ai_spatial.SpatialAnalysis.html">SpatialAnalysis</a></div><div class="sidebar-section-children"><a href="module-ai_spatial-SpatialAnalysis.html">SpatialAnalysis</a></div><div class="sidebar-section-children"><a href="module-ai_tts.TTS.html">TTS</a></div><div class="sidebar-section-children"><a href="module-ai_tts-TTS.html">TTS</a></div><div class="sidebar-section-children"><a href="module-core_holosphere.HoloSphere.html">HoloSphere</a></div><div class="sidebar-section-children"><a href="module-core_holosphere-HoloSphere.html">HoloSphere</a></div><div class="sidebar-section-children"><a href="module-holosphere-HoloSphereBase.html">HoloSphereBase</a></div><div class="sidebar-section-children"><a href="module-holosphere-HoloSphereBase.html">HoloSphereBase</a></div><div class="sidebar-section-children"><a href="module-lib_errors.AuthorizationError.html">AuthorizationError</a></div><div class="sidebar-section-children"><a href="module-lib_errors.ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-lib_errors-AuthorizationError.html">AuthorizationError</a></div><div class="sidebar-section-children"><a href="module-lib_errors-ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-schema_validator.ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-schema_validator-ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-storage_backend-factory.BackendFactory.html">BackendFactory</a></div><div class="sidebar-section-children"><a href="module-storage_backend-interface.StorageBackend.html">StorageBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backend-interface-StorageBackend.html">StorageBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub-backend.ActivityPubBackend.html">ActivityPubBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub-backend-ActivityPubBackend.html">ActivityPubBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub_server.ActivityPubServer.html">ActivityPubServer</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub_server-ActivityPubServer.html">ActivityPubServer</a></div><div class="sidebar-section-children"><a href="module-storage_backends_gundb-backend.GunDBBackend.html">GunDBBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_gundb-backend-GunDBBackend.html">GunDBBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_nostr-backend.NostrBackend.html">NostrBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_nostr-backend-NostrBackend.html">NostrBackend</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-browser.FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-browser-FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage.FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_gun-auth.GunAuth.html">GunAuth</a></div><div class="sidebar-section-children"><a href="module-storage_gun-auth-GunAuth.html">GunAuth</a></div><div class="sidebar-section-children"><a href="module-storage_gun-references.GunReferenceHandler.html">GunReferenceHandler</a></div><div class="sidebar-section-children"><a href="module-storage_gun-references-GunReferenceHandler.html">GunReferenceHandler</a></div><div class="sidebar-section-children"><a href="module-storage_gun-schema.GunSchemaValidator.html">GunSchemaValidator</a></div><div class="sidebar-section-children"><a href="module-storage_gun-schema-GunSchemaValidator.html">GunSchemaValidator</a></div><div class="sidebar-section-children"><a href="module-storage_indexeddb-storage.IndexedDBStorage.html">IndexedDBStorage</a></div><div class="sidebar-section-children"><a href="module-storage_indexeddb-storage-IndexedDBStorage.html">IndexedDBStorage</a></div><div class="sidebar-section-children"><a href="module-storage_memory-storage.MemoryStorage.html">MemoryStorage</a></div><div class="sidebar-section-children"><a href="module-storage_memory-storage-MemoryStorage.html">MemoryStorage</a></div><div class="sidebar-section-children"><a href="module-storage_migration.MigrationTool.html">MigrationTool</a></div><div class="sidebar-section-children"><a href="module-storage_migration-MigrationTool.html">MigrationTool</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client.NostrClient.html">NostrClient</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client-LRUCache.html">LRUCache</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client-NostrClient.html">NostrClient</a></div><div class="sidebar-section-children"><a href="module-storage_outbox-queue.OutboxQueue.html">OutboxQueue</a></div><div class="sidebar-section-children"><a href="module-storage_outbox-queue-OutboxQueue.html">OutboxQueue</a></div><div class="sidebar-section-children"><a href="module-storage_persistent-storage-PersistentStorage.html">PersistentStorage</a></div><div class="sidebar-section-children"><a href="module-storage_sync-service.SyncService.html">SyncService</a></div><div class="sidebar-section-children"><a href="module-storage_sync-service-SyncService.html">SyncService</a></div><div class="sidebar-section-children"><a href="module-subscriptions_manager.SubscriptionRegistry.html">SubscriptionRegistry</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-global"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#FederationRequestPayload">FederationRequestPayload</a></div><div class="sidebar-section-children"><a href="global.html#FederationResponsePayload">FederationResponsePayload</a></div><div class="sidebar-section-children"><a href="global.html#acceptFederationRequest">acceptFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#acceptFederationRequest">acceptFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#addFederatedPartner">addFederatedPartner</a></div><div class="sidebar-section-children"><a href="global.html#cleanupExpiredCapabilities">cleanupExpiredCapabilities</a></div><div class="sidebar-section-children"><a href="global.html#createFederationRequest">createFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#createFederationResponse">createFederationResponse</a></div><div class="sidebar-section-children"><a href="global.html#declineFederationRequest">declineFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#getCapabilityForAuthor">getCapabilityForAuthor</a></div><div class="sidebar-section-children"><a href="global.html#getFederatedAuthors">getFederatedAuthors</a></div><div class="sidebar-section-children"><a href="global.html#getFederatedAuthorsForScope">getFederatedAuthorsForScope</a></div><div class="sidebar-section-children"><a href="global.html#getFederatedPartner">getFederatedPartner</a></div><div class="sidebar-section-children"><a href="global.html#getFederationRegistry">getFederationRegistry</a></div><div class="sidebar-section-children"><a href="global.html#getPendingFederationRequests">getPendingFederationRequests</a></div><div class="sidebar-section-children"><a href="global.html#initiateFederationHandshake">initiateFederationHandshake</a></div><div class="sidebar-section-children"><a href="global.html#isFederationRequest">isFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#isFederationResponse">isFederationResponse</a></div><div class="sidebar-section-children"><a href="global.html#rejectFederationRequest">rejectFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#removeFederatedPartner">removeFederatedPartner</a></div><div class="sidebar-section-children"><a href="global.html#revokeOutboundCapability">revokeOutboundCapability</a></div><div class="sidebar-section-children"><a href="global.html#saveFederationRegistry">saveFederationRegistry</a></div><div class="sidebar-section-children"><a href="global.html#sendFederationRequest">sendFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#sendFederationRequest">sendFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#sendFederationResponse">sendFederationResponse</a></div><div class="sidebar-section-children"><a href="global.html#storeInboundCapability">storeInboundCapability</a></div><div class="sidebar-section-children"><a href="global.html#storeOutboundCapability">storeOutboundCapability</a></div><div class="sidebar-section-children"><a href="global.html#subscribeFederationAcceptances">subscribeFederationAcceptances</a></div><div class="sidebar-section-children"><a href="global.html#subscribeFederationDeclines">subscribeFederationDeclines</a></div><div class="sidebar-section-children"><a href="global.html#subscribeFederationRequests">subscribeFederationRequests</a></div><div class="sidebar-section-children"><a href="global.html#subscribeToFederationDMs">subscribeToFederationDMs</a></div><div class="sidebar-section-children"><a href="global.html#updateDiscoverySettings">updateDiscoverySettings</a></div></div></div></div></div><div class="navbar-container" id="VuAckcnZhf"><nav class="navbar"><div class="navbar-left-items"></div><div class="navbar-right-items"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#light-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div><nav></nav></nav></div><div class="toc-container"><div class="toc-content"><span class="bold">On this page</span><div id="eed4d2a0bfd64539bb9df78095dec881"></div></div></div><div class="body-wrapper"><div class="main-content"><div class="main-wrapper"><section id="source-page" class="source-page"><header><h1 id="title" class="has-anchor">storage_nostr-client.js</h1></header><article><pre class="prettyprint source lang-js"><code>/**
+ * @fileoverview Nostr Client - SimplePool wrapper for relay management.
+ *
+ * Provides connection pooling, relay management, event caching, persistent storage,
+ * outbox queue for guaranteed delivery, and background sync services.
+ *
+ * @module storage/nostr-client
+ */
+import { SimplePool, finalizeEvent, getPublicKey } from 'nostr-tools';
+import { OutboxQueue } from './outbox-queue.js';
+import { SyncService } from './sync-service.js';
+/**
+ * Global pool singleton - reuse connections across NostrClient instances.
+ * @private
+ */
+let globalPool = null;
+/**
+ * Set of relays used by the global pool.
+ * @private
+ */
+let globalPoolRelays = new Set();
+/**
+ * Get or create global SimplePool singleton.
+ * This ensures WebSocket connections are reused across all operations.
+ *
+ * @private
+ * @param {Object} [config={}] - Pool configuration
+ * @param {boolean} [config.enableReconnect=true] - Enable auto-reconnect
+ * @param {boolean} [config.enablePing=true] - Enable ping/pong
+ * @returns {SimplePool} The global SimplePool instance
+ */
+function getGlobalPool(config = {}) {
+  if (!globalPool) {
+    globalPool = new SimplePool({
+      enableReconnect: config.enableReconnect !== false,
+      enablePing: config.enablePing !== false,
+    });
+  }
+  return globalPool;
+}
+/**
+ * Global pending queries map for deduplication.
+ * Key: JSON-stringified filter, Value: { promise, timestamp }
+ * @private
+ */
+const pendingQueries = new Map();
+/**
+ * Pending query timeout (5 seconds).
+ * @private
+ * @constant {number}
+ */
+const PENDING_QUERY_TIMEOUT = 5000;
+/**
+ * Global active subscriptions map for subscription deduplication.
+ * Key: JSON-stringified filter, Value: { subscription, callbacks: Set, refCount }
+ * @private
+ */
+const activeSubscriptions = new Map();
+/**
+ * Throttle background refreshes to avoid flooding the relay.
+ * Key: path, Value: timestamp of last refresh
+ * @private
+ */
+const backgroundRefreshThrottle = new Map();
+/**
+ * Background refresh interval (30 seconds).
+ * @private
+ * @constant {number}
+ */
+const BACKGROUND_REFRESH_INTERVAL = 30000;
+/**
+ * Write debouncing for rapid updates to the same path.
+ * Key: d-tag path, Value: { event, timer, resolve, reject }
+ * @private
+ */
+const pendingWrites = new Map();
+/**
+ * Write debounce window (500ms).
+ * @private
+ * @constant {number}
+ */
+const WRITE_DEBOUNCE_MS = 500;
+/**
+ * Long-lived subscription manager - keeps ONE subscription per author for real-time updates.
+ * Key: pubkey, Value: { subscription, lastEventTime, initialized }
+ * @private
+ */
+const authorSubscriptions = new Map();
+/**
+ * Author subscription initialization timeout (5 seconds).
+ * @private
+ * @constant {number}
+ */
+const AUTHOR_SUB_INIT_TIMEOUT = 5000;
+/**
+ * Simple LRU Cache implementation.
+ * Automatically evicts least recently used entries when max size is reached.
+ *
+ * @private
+ * @class LRUCache
+ */
+class LRUCache {
+  /**
+   * Create a new LRU cache.
+   *
+   * @param {number} [maxSize=500] - Maximum number of entries
+   */
+  constructor(maxSize = 500) {
+    this.maxSize = maxSize;
+    this.cache = new Map();
+  }
+  /**
+   * Get an entry from the cache.
+   *
+   * @param {string} key - Cache key
+   * @returns {*} Cached value or undefined
+   */
+  get(key) {
+    if (!this.cache.has(key)) return undefined;
+    // Move to end (most recently used)
+    const value = this.cache.get(key);
+    this.cache.delete(key);
+    this.cache.set(key, value);
+    return value;
+  }
+  set(key, value) {
+    // If key exists, delete it first to update position
+    if (this.cache.has(key)) {
+      this.cache.delete(key);
+    }
+    this.cache.set(key, value);
+    // Evict oldest entries if over capacity
+    while (this.cache.size > this.maxSize) {
+      const oldestKey = this.cache.keys().next().value;
+      this.cache.delete(oldestKey);
+    }
+  }
+  has(key) {
+    return this.cache.has(key);
+  }
+  delete(key) {
+    return this.cache.delete(key);
+  }
+  clear() {
+    this.cache.clear();
+  }
+  get size() {
+    return this.cache.size;
+  }
+  keys() {
+    return this.cache.keys();
+  }
+  values() {
+    return this.cache.values();
+  }
+  entries() {
+    return this.cache.entries();
+  }
+  forEach(callback) {
+    this.cache.forEach(callback);
+  }
+}
+// Lazy-load WebSocket polyfill for Node.js environment
+let webSocketPolyfillPromise = null;
+function ensureWebSocket() {
+  if (typeof globalThis.WebSocket !== 'undefined') {
+    return Promise.resolve();
+  }
+  if (!webSocketPolyfillPromise) {
+    webSocketPolyfillPromise = (async () => {
+      try {
+        const { default: WebSocket } = await import('ws');
+        globalThis.WebSocket = WebSocket;
+      } catch (e) {
+        // WebSocket polyfill not available, will use mock pool
+      }
+    })();
+  }
+  return webSocketPolyfillPromise;
+}
+import { createPersistentStorage } from './persistent-storage.js';
+/**
+ * NostrClient - Manages connections to Nostr relays.
+ *
+ * Provides event publishing, querying, subscription management, persistent caching,
+ * and guaranteed delivery via outbox queue.
+ *
+ * @class NostrClient
+ * @example
+ * const client = new NostrClient({
+ *   relays: ['wss://relay.example.com'],
+ *   appName: 'myapp',
+ *   persistence: true
+ * });
+ */
+export class NostrClient {
+  /**
+   * Create a new NostrClient.
+   *
+   * @param {Object} [config={}] - Configuration options
+   * @param {string[]} [config.relays=[]] - Array of relay URLs
+   * @param {string} [config.privateKey] - Private key for signing (hex format)
+   * @param {boolean} [config.enableReconnect=true] - Auto-reconnect on disconnect
+   * @param {boolean} [config.enablePing=true] - Auto-ping relays
+   * @param {string} [config.appName] - Application name for storage namespace
+   * @param {boolean} [config.persistence=true] - Enable persistent storage
+   * @param {number} [config.cacheSize=500] - Maximum cache size
+   * @param {number} [config.persistBatchMs=100] - Batch persist writes within this window
+   * @param {boolean} [config.backgroundSync=true] - Enable background sync service
+   * @param {string} [config.dataDir] - Data directory for persistent storage
+   * @throws {Error} If relays is not an array
+   */
+  constructor(config = {}) {
+    if (config.relays &amp;&amp; !Array.isArray(config.relays)) {
+      throw new Error('Relays must be an array');
+    }
+    this.relays = config.relays || [];
+    // Generate or use provided private key
+    // IMPORTANT: If you want keys to persist across restarts, you MUST provide
+    // a privateKey in config. Otherwise, a new key is generated each time.
+    this.privateKey = config.privateKey || this._generatePrivateKey();
+    this.publicKey = getPublicKey(this.privateKey);
+    this.config = config;
+    this._subscriptions = new Map();
+    this._eventCache = new LRUCache(config.cacheSize || 500); // LRU cache for recent events
+    this._cacheIndex = new Map(); // Reverse index: kind -> Set of cache keys affected by that kind
+    this.persistentStorage = null;
+    // Batched persistent writes for better I/O performance
+    this._persistQueue = new Map(); // path -> event
+    this._persistTimer = null;
+    this._persistBatchMs = config.persistBatchMs || 100; // Batch writes within 100ms window
+    // Initialize pool and storage asynchronously
+    this._initReady = this._initialize();
+  }
+  /**
+   * Initialize WebSocket polyfill and pool.
+   *
+   * @private
+   * @returns {Promise&lt;void>}
+   */
+  async _initialize() {
+    // Ensure WebSocket is available before initializing pool
+    await ensureWebSocket();
+    // Initialize SimplePool with options (only if relays exist)
+    if (this.relays.length > 0) {
+      // Use global pool singleton to reuse WebSocket connections
+      this.pool = getGlobalPool(this.config);
+      // Track relays used by this client
+      this.relays.forEach(r => globalPoolRelays.add(r));
+    } else {
+      // Mock pool for testing - returns mock promise that resolves immediately
+      this.pool = {
+        publish: (relays, event) => [Promise.resolve()],
+        querySync: (relays, filter, options) => Promise.resolve([]),
+        subscribeMany: (relays, filters, opts) => ({ close: () => {} }),
+        close: (relays) => {},
+      };
+    }
+    // Initialize persistent storage
+    await this._initPersistentStorage();
+    // Start long-lived subscription for real-time cache updates
+    if (this.relays.length > 0) {
+      this._initLongLivedSubscription();
+    }
+  }
+  /**
+   * Initialize a long-lived subscription to keep cache fresh
+   * This replaces polling with a single persistent subscription
+   * @private
+   */
+  _initLongLivedSubscription() {
+    const subKey = this.publicKey;
+    // Check if subscription already exists for this author
+    if (authorSubscriptions.has(subKey)) {
+      return;
+    }
+    const subInfo = {
+      subscription: null,
+      initialized: false,
+      initPromise: null,
+      initResolve: null,
+    };
+    // Create promise for initial load completion
+    subInfo.initPromise = new Promise(resolve => {
+      subInfo.initResolve = resolve;
+    });
+    authorSubscriptions.set(subKey, subInfo);
+    // Subscribe to ALL events for this author (kind 30000)
+    // This single subscription replaces all the polling queries
+    const filter = {
+      kinds: [30000],
+      authors: [this.publicKey],
+    };
+    const sub = this.pool.subscribeMany(
+      this.relays,
+      [filter],
+      {
+        onevent: (event) => {
+          // Verify author (relay may not respect filter)
+          if (event.pubkey !== this.publicKey) {
+            return;
+          }
+          // Cache the event - this keeps our local cache in sync
+          this._cacheEvent(event);
+        },
+        oneose: () => {
+          // End of stored events - initial load complete
+          if (!subInfo.initialized) {
+            subInfo.initialized = true;
+            subInfo.initResolve();
+          }
+        },
+      }
+    );
+    subInfo.subscription = sub;
+    // Set timeout for initial load in case EOSE never arrives
+    setTimeout(() => {
+      if (!subInfo.initialized) {
+        subInfo.initialized = true;
+        subInfo.initResolve();
+      }
+    }, AUTHOR_SUB_INIT_TIMEOUT);
+  }
+  /**
+   * Wait for long-lived subscription to complete initial load
+   * @private
+   */
+  async _waitForSubscriptionInit() {
+    const subInfo = authorSubscriptions.get(this.publicKey);
+    if (subInfo &amp;&amp; subInfo.initPromise) {
+      await subInfo.initPromise;
+    }
+  }
+  /**
+   * Initialize persistent storage
+   * @private
+   */
+  async _initPersistentStorage() {
+    // Only enable persistence if explicitly requested or radisk is true
+    if (this.config.persistence !== false &amp;&amp; (this.config.radisk || this.config.appName)) {
+      try {
+        const namespace = this.config.appName || 'holosphere_default';
+        this.persistentStorage = await createPersistentStorage(namespace, {
+          dataDir: this.config.dataDir
+        });
+        // Load cached events from persistent storage
+        await this._loadFromPersistentStorage();
+        // Initialize outbox queue for guaranteed delivery
+        this.outboxQueue = new OutboxQueue(this.persistentStorage, {
+          maxRetries: this.config.maxRetries || 5,
+          baseDelay: this.config.retryBaseDelay || 1000,
+          maxDelay: this.config.retryMaxDelay || 60000,
+          failedTTL: this.config.failedTTL || 24 * 60 * 60 * 1000, // 24 hours
+        });
+        // Start background sync service
+        if (this.config.backgroundSync !== false) {
+          this.syncService = new SyncService(this, {
+            interval: this.config.syncInterval || 10000, // 10 seconds
+            autoStart: true,
+          });
+        }
+      } catch (error) {
+        console.warn('Failed to initialize persistent storage:', error);
+        // Continue without persistence
+      }
+    }
+  }
+  /**
+   * Load events from persistent storage into cache
+   * @private
+   */
+  async _loadFromPersistentStorage() {
+    if (!this.persistentStorage) return;
+    try {
+      // Load all events (excluding outbox queue entries)
+      const events = await this.persistentStorage.getAll('');
+      for (const event of events) {
+        // Skip outbox queue entries
+        if (event &amp;&amp; event.id &amp;&amp; !event.status) {
+          // Add to cache
+          this._cacheEventSync(event);
+        }
+      }
+    } catch (error) {
+      console.warn('Failed to load from persistent storage:', error);
+    }
+  }
+  /**
+   * Get a single event from persistent storage by path (d-tag)
+   * @param {string} path - The d-tag path to look up
+   * @returns {Promise&lt;Object|null>} The event or null if not found
+   */
+  async persistentGet(path) {
+    await this._initReady;
+    if (!this.persistentStorage) return null;
+    try {
+      const event = await this.persistentStorage.get(path);
+      return event || null;
+    } catch (error) {
+      console.warn('[nostr] Persistent storage read failed:', error);
+      return null;
+    }
+  }
+  /**
+   * Get all events from persistent storage matching a prefix
+   * @param {string} prefix - The path prefix to match
+   * @returns {Promise&lt;Array>} Array of events
+   */
+  async persistentGetAll(prefix) {
+    await this._initReady;
+    if (!this.persistentStorage) return [];
+    try {
+      const events = await this.persistentStorage.getAll(prefix);
+      // Filter out outbox queue entries and null values
+      return events.filter(e => e &amp;&amp; e.id &amp;&amp; !e.status);
+    } catch (error) {
+      console.warn('[nostr] Persistent storage read failed:', error);
+      return [];
+    }
+  }
+  /**
+   * Generate random private key
+   * @private
+   */
+  _generatePrivateKey() {
+    const bytes = new Uint8Array(32);
+    if (typeof window !== 'undefined' &amp;&amp; window.crypto) {
+      window.crypto.getRandomValues(bytes);
+    } else {
+      // Node.js - use dynamic import
+      try {
+        // Use crypto.randomFillSync if available
+        const crypto = globalThis.crypto || global.crypto;
+        if (crypto &amp;&amp; crypto.getRandomValues) {
+          crypto.getRandomValues(bytes);
+        } else {
+          // Fallback to Math.random (less secure, but works in testing)
+          for (let i = 0; i &lt; 32; i++) {
+            bytes[i] = Math.floor(Math.random() * 256);
+          }
+        }
+      } catch (e) {
+        // Fallback to Math.random
+        for (let i = 0; i &lt; 32; i++) {
+          bytes[i] = Math.floor(Math.random() * 256);
+        }
+      }
+    }
+    return Array.from(bytes)
+      .map(b => b.toString(16).padStart(2, '0'))
+      .join('');
+  }
+  /**
+   * Publish event to relays.
+   *
+   * Supports debouncing for replaceable events (kind 30000-39999) to avoid rapid updates.
+   *
+   * @param {Object} event - Unsigned event object
+   * @param {Object} [options={}] - Publish options
+   * @param {boolean} [options.waitForRelays=false] - Wait for relay confirmation
+   * @param {boolean} [options.debounce=true] - Debounce rapid writes to same d-tag
+   * @returns {Promise&lt;Object>} Signed event with relay publish results
+   * @example
+   * const result = await client.publish({
+   *   kind: 30000,
+   *   tags: [['d', 'mypath']],
+   *   content: JSON.stringify({ name: 'Test' })
+   * });
+   */
+  async publish(event, options = {}) {
+    // Ensure initialization is complete
+    await this._initReady;
+    const waitForRelays = options.waitForRelays || false;
+    // For replaceable events, check if we should debounce
+    const isReplaceable = event.kind >= 30000 &amp;&amp; event.kind &lt; 40000;
+    const shouldDebounce = isReplaceable &amp;&amp; options.debounce !== false &amp;&amp; !waitForRelays;
+    if (shouldDebounce) {
+      const dTag = event.tags?.find(t => t[0] === 'd');
+      if (dTag &amp;&amp; dTag[1]) {
+        return this._debouncedPublish(event, dTag[1], options);
+      }
+    }
+    return this._doPublish(event, options);
+  }
+  /**
+   * Debounced publish - coalesces rapid writes to the same d-tag
+   * @private
+   */
+  _debouncedPublish(event, dTagPath, options) {
+    return new Promise((resolve, reject) => {
+      const existing = pendingWrites.get(dTagPath);
+      if (existing) {
+        // Cancel previous pending write and use the new one
+        clearTimeout(existing.timer);
+        // Resolve the previous promise with the new event (it will be superseded)
+        existing.resolve({
+          event: null,
+          results: [],
+          debounced: true,
+          supersededBy: event,
+        });
+      }
+      // Set up debounced write
+      const timer = setTimeout(async () => {
+        pendingWrites.delete(dTagPath);
+        try {
+          const result = await this._doPublish(event, options);
+          resolve(result);
+        } catch (err) {
+          reject(err);
+        }
+      }, WRITE_DEBOUNCE_MS);
+      pendingWrites.set(dTagPath, { event, timer, resolve, reject });
+      // Cache immediately for local-first reads (even before relay publish)
+      const signedEvent = finalizeEvent(event, this.privateKey);
+      this._cacheEvent(signedEvent);
+    });
+  }
+  /**
+   * Internal publish implementation
+   * @private
+   */
+  async _doPublish(event, options = {}) {
+    const waitForRelays = options.waitForRelays || false;
+    // Check if event is already signed (has id and sig)
+    // If so, use it as-is; otherwise sign it
+    const signedEvent = (event.id &amp;&amp; event.sig)
+      ? event
+      : finalizeEvent(event, this.privateKey);
+    // 1. Cache the event locally first (this makes reads instant)
+    await this._cacheEvent(signedEvent);
+    // 2. Enqueue for guaranteed delivery (if outbox queue available)
+    if (this.outboxQueue) {
+      await this.outboxQueue.enqueue(signedEvent, this.relays);
+    }
+    // 3. Publish to relays
+    if (waitForRelays) {
+      // Wait for relay confirmation if explicitly requested
+      const deliveryResult = await this._attemptDelivery(signedEvent, this.relays);
+      return {
+        event: signedEvent,
+        results: deliveryResult.results,
+        queued: !!this.outboxQueue,
+      };
+    } else {
+      // Fire and forget - publish in background, return immediately
+      this._attemptDelivery(signedEvent, this.relays).catch(() => {
+        // Silent - event is cached locally and queued for retry
+      });
+      // Return immediately (data is in local cache and queued for delivery)
+      return {
+        event: signedEvent,
+        results: [],
+        queued: !!this.outboxQueue,
+      };
+    }
+  }
+  /**
+   * Attempt to deliver event to relays
+   * Updates outbox queue with delivery status
+   * @param {Object} event - Signed event to deliver
+   * @param {string[]} relays - Target relay URLs
+   * @returns {Promise&lt;Object>} Delivery result with successful/failed relays
+   */
+  async _attemptDelivery(event, relays) {
+    const results = await Promise.allSettled(
+      this.pool.publish(relays, event)
+    );
+    const successful = [];
+    const failed = [];
+    const formattedResults = [];
+    results.forEach((r, i) => {
+      formattedResults.push({
+        relay: relays[i],
+        status: r.status,
+        value: r.value,
+        reason: r.reason,
+      });
+      if (r.status === 'fulfilled') {
+        successful.push(relays[i]);
+      } else {
+        failed.push(relays[i]);
+      }
+    });
+    // Update outbox queue with delivery status
+    if (this.outboxQueue) {
+      await this.outboxQueue.markSent(event.id, successful);
+    }
+    // Log failures only at debug level (common during network issues)
+    if (failed.length > 0 &amp;&amp; successful.length === 0) {
+      // Only warn if ALL relays failed (likely a real issue)
+      const reasons = results
+        .filter(r => r.status === 'rejected')
+        .map(f => f.reason?.message || f.reason || 'unknown')
+        .join(', ');
+      // Use debug level for timeout issues (very common)
+      if (reasons.includes('timed out')) {
+        // Silent - event is queued for retry anyway
+      } else {
+        console.warn(`[nostr] All relays failed for ${event.id.slice(0, 8)}: ${reasons}`);
+      }
+    }
+    return { successful, failed, results: formattedResults };
+  }
+  /**
+   * Query events from relays.
+   *
+   * Uses long-lived subscription for cache updates - avoids polling.
+   *
+   * @param {Object} filter - Nostr filter object
+   * @param {Object} [options={}] - Query options
+   * @param {number} [options.timeout=30000] - Query timeout in ms (set to 0 for no timeout)
+   * @param {boolean} [options.localFirst=true] - Return local cache immediately, refresh in background
+   * @param {boolean} [options.forceRelay=false] - Force relay query even if subscription cache is available
+   * @returns {Promise&lt;Array>} Array of events
+   * @example
+   * const events = await client.query({
+   *   kinds: [30000],
+   *   authors: [client.publicKey],
+   *   '#d': ['mypath']
+   * });
+   */
+  async query(filter, options = {}) {
+    // Ensure initialization is complete
+    await this._initReady;
+    const timeout = options.timeout !== undefined ? options.timeout : 30000;
+    const localFirst = options.localFirst !== false; // Default to true for speed
+    const forceRelay = options.forceRelay === true;
+    // If no relays, query from cache only
+    if (this.relays.length === 0) {
+      const matchingEvents = this._getMatchingCachedEvents(filter);
+      return matchingEvents;
+    }
+    // Check if this query can be served from the long-lived subscription cache
+    // The subscription keeps ALL events for this author in cache, updated in real-time
+    const subInfo = authorSubscriptions.get(this.publicKey);
+    const isOwnDataQuery = filter.authors &amp;&amp;
+                           filter.authors.length === 1 &amp;&amp;
+                           filter.authors[0] === this.publicKey;
+    // If we have an initialized subscription for our own data, use cache
+    if (!forceRelay &amp;&amp; isOwnDataQuery &amp;&amp; subInfo &amp;&amp; subInfo.initialized) {
+      // Return matching events from cache - no relay query needed!
+      const matchingEvents = this._getMatchingCachedEvents(filter);
+      return matchingEvents;
+    }
+    // For first query before subscription initializes, wait briefly
+    if (isOwnDataQuery &amp;&amp; subInfo &amp;&amp; !subInfo.initialized) {
+      // Wait for subscription to initialize (up to timeout)
+      await Promise.race([
+        subInfo.initPromise,
+        new Promise(resolve => setTimeout(resolve, Math.min(timeout, AUTHOR_SUB_INIT_TIMEOUT)))
+      ]);
+      // Now try cache again
+      if (subInfo.initialized) {
+        const matchingEvents = this._getMatchingCachedEvents(filter);
+        return matchingEvents;
+      }
+    }
+    // Check d-tag cache first for single-item queries (most common case)
+    // This ensures recently written data is returned immediately
+    if (filter['#d'] &amp;&amp; filter['#d'].length === 1 &amp;&amp; filter.kinds &amp;&amp; filter.kinds.length === 1) {
+      const dTagKey = `d:${filter.kinds[0]}:${filter['#d'][0]}`;
+      const dTagCached = this._eventCache.get(dTagKey);
+      if (dTagCached &amp;&amp; Date.now() - dTagCached.timestamp &lt; 5000) {
+        return dTagCached.events;
+      }
+    }
+    const cacheKey = JSON.stringify(filter);
+    const cached = this._eventCache.get(cacheKey);
+    // Return fresh cache immediately
+    if (cached &amp;&amp; Date.now() - cached.timestamp &lt; 5000) {
+      return cached.events;
+    }
+    // If we have stale cache and localFirst is enabled, return it immediately
+    // and refresh in background
+    if (localFirst &amp;&amp; cached) {
+      // Refresh cache in background
+      this._refreshCacheInBackground(filter, cacheKey, timeout);
+      return cached.events;
+    }
+    // No cache available or localFirst disabled - must query relays
+    return this._queryRelaysAndCache(filter, cacheKey, timeout);
+  }
+  /**
+   * Query relays and update cache
+   * Uses global pending queries map to deduplicate identical concurrent queries
+   * @private
+   */
+  async _queryRelaysAndCache(filter, cacheKey, timeout) {
+    // Check if there's already a pending query for this exact filter
+    const pending = pendingQueries.get(cacheKey);
+    if (pending &amp;&amp; Date.now() - pending.timestamp &lt; PENDING_QUERY_TIMEOUT) {
+      // Reuse the pending query promise instead of creating a new one
+      return pending.promise;
+    }
+    // Create the query promise
+    const queryPromise = (async () => {
+      try {
+        let events = await this.pool.querySync(this.relays, filter, { timeout });
+        // CRITICAL: Filter out events from other authors (relay may not respect filter)
+        if (filter.authors &amp;&amp; filter.authors.length > 0) {
+          events = events.filter(event => filter.authors.includes(event.pubkey));
+        }
+        // Cache results
+        this._eventCache.set(cacheKey, {
+          events,
+          timestamp: Date.now(),
+        });
+        // Update reverse index for fast invalidation
+        this._indexCacheEntry(cacheKey, filter);
+        return events;
+      } finally {
+        // Clean up pending query after completion
+        pendingQueries.delete(cacheKey);
+      }
+    })();
+    // Store the pending query
+    pendingQueries.set(cacheKey, {
+      promise: queryPromise,
+      timestamp: Date.now(),
+    });
+    return queryPromise;
+  }
+  /**
+   * Limit cache size (called after cache operations)
+   * Note: LRU cache handles this automatically, kept for API compatibility
+   * @private
+   */
+  _limitCacheSize() {
+    // LRU cache handles size limiting automatically
+  }
+  /**
+   * Add cache entry to reverse index for fast invalidation
+   * @private
+   */
+  _indexCacheEntry(cacheKey, filter) {
+    // Index by kinds for fast lookup during invalidation
+    if (filter.kinds) {
+      for (const kind of filter.kinds) {
+        if (!this._cacheIndex.has(kind)) {
+          this._cacheIndex.set(kind, new Set());
+        }
+        this._cacheIndex.get(kind).add(cacheKey);
+      }
+    }
+  }
+  /**
+   * Remove cache entry from reverse index
+   * @private
+   */
+  _unindexCacheEntry(cacheKey) {
+    // Try to parse the filter from the cache key to remove from index
+    if (!cacheKey.startsWith('{')) return;
+    try {
+      const filter = JSON.parse(cacheKey);
+      if (filter.kinds) {
+        for (const kind of filter.kinds) {
+          const indexSet = this._cacheIndex.get(kind);
+          if (indexSet) {
+            indexSet.delete(cacheKey);
+            if (indexSet.size === 0) {
+              this._cacheIndex.delete(kind);
+            }
+          }
+        }
+      }
+    } catch {
+      // Not a valid filter key, skip
+    }
+  }
+  /**
+   * Refresh cache in background (fire and forget)
+   * @private
+   */
+  _refreshCacheInBackground(filter, cacheKey, timeout) {
+    this._queryRelaysAndCache(filter, cacheKey, timeout).catch(err => {
+      // Silently ignore background refresh errors - we have stale cache as fallback
+      console.debug('[nostr] Background cache refresh failed:', err.message);
+    });
+  }
+  /**
+   * Refresh a single path from relays in the background
+   * Used for persistent-first reads to update local data
+   * @param {string} path - The d-tag path to refresh
+   * @param {number} kind - Event kind (default: 30000)
+   * @param {Object} options - Query options
+   */
+  refreshPathInBackground(path, kind = 30000, options = {}) {
+    this._doBackgroundPathRefresh(path, kind, options).catch(err => {
+      console.debug('[nostr] Background path refresh failed:', err.message);
+    });
+  }
+  /**
+   * Internal method to refresh a path from relays
+   * Throttled to avoid flooding the relay with repeated requests
+   * @private
+   */
+  async _doBackgroundPathRefresh(path, kind, options) {
+    if (this.relays.length === 0) return;
+    // Throttle: Skip if we've refreshed this path recently
+    const lastRefresh = backgroundRefreshThrottle.get(path);
+    if (lastRefresh &amp;&amp; Date.now() - lastRefresh &lt; BACKGROUND_REFRESH_INTERVAL) {
+      return; // Skip - recently refreshed
+    }
+    // Mark as refreshed
+    backgroundRefreshThrottle.set(path, Date.now());
+    // Clean up old throttle entries periodically (keep map from growing)
+    if (backgroundRefreshThrottle.size > 1000) {
+      const cutoff = Date.now() - BACKGROUND_REFRESH_INTERVAL;
+      for (const [key, timestamp] of backgroundRefreshThrottle) {
+        if (timestamp &lt; cutoff) {
+          backgroundRefreshThrottle.delete(key);
+        }
+      }
+    }
+    const filter = {
+      kinds: [kind],
+      authors: options.authors || [this.publicKey],
+      '#d': [path],
+      limit: 1,
+    };
+    const cacheKey = JSON.stringify(filter);
+    // Use our query deduplication by calling query() instead of pool.querySync() directly
+    const timeout = options.timeout || 30000;
+    const events = await this._queryRelaysAndCache(filter, cacheKey, timeout);
+    // Filter by author (relays may not respect filter)
+    const authorFiltered = events.filter(e =>
+      (options.authors || [this.publicKey]).includes(e.pubkey)
+    );
+    if (authorFiltered.length > 0) {
+      // Update cache and persistent storage
+      await this._cacheEvent(authorFiltered[0]);
+    }
+  }
+  /**
+   * Refresh all paths with a prefix from relays in the background
+   * Used for persistent-first collection reads
+   * @param {string} prefix - The d-tag prefix to refresh
+   * @param {number} kind - Event kind (default: 30000)
+   * @param {Object} options - Query options
+   */
+  refreshPrefixInBackground(prefix, kind = 30000, options = {}) {
+    this._doBackgroundPrefixRefresh(prefix, kind, options).catch(err => {
+      console.debug('[nostr] Background prefix refresh failed:', err.message);
+    });
+  }
+  /**
+   * Internal method to refresh a prefix from relays
+   * Throttled to avoid flooding the relay with repeated requests
+   * @private
+   */
+  async _doBackgroundPrefixRefresh(prefix, kind, options) {
+    if (this.relays.length === 0) return;
+    // Throttle: Skip if we've refreshed this prefix recently
+    const throttleKey = `prefix:${prefix}`;
+    const lastRefresh = backgroundRefreshThrottle.get(throttleKey);
+    if (lastRefresh &amp;&amp; Date.now() - lastRefresh &lt; BACKGROUND_REFRESH_INTERVAL) {
+      return; // Skip - recently refreshed
+    }
+    // Mark as refreshed
+    backgroundRefreshThrottle.set(throttleKey, Date.now());
+    // Query with wildcard-ish filter (relays handle d-tag prefix matching)
+    const filter = {
+      kinds: [kind],
+      authors: options.authors || [this.publicKey],
+      limit: options.limit || 1000,
+    };
+    const cacheKey = JSON.stringify(filter);
+    // Use our query deduplication
+    const timeout = options.timeout || 30000;
+    let events = await this._queryRelaysAndCache(filter, cacheKey, timeout);
+    // Filter by author (already done by _queryRelaysAndCache, but double-check)
+    events = events.filter(e =>
+      (options.authors || [this.publicKey]).includes(e.pubkey)
+    );
+    // Filter by d-tag prefix (client-side since relays don't support prefix matching)
+    events = events.filter(e => {
+      const dTag = e.tags.find(t => t[0] === 'd');
+      return dTag &amp;&amp; dTag[1] &amp;&amp; dTag[1].startsWith(prefix);
+    });
+    // Update cache and persistent storage for each event
+    for (const event of events) {
+      await this._cacheEvent(event);
+    }
+  }
+  /**
+   * Hybrid query: Check local cache first, then query relays for missing data
+   * Merges local and relay results, preferring newer events
+   * @param {Object} filter - Nostr filter object
+   * @param {Object} options - Query options
+   * @param {number} options.timeout - Query timeout in ms (default: 30000)
+   * @returns {Promise&lt;Array>} Array of events (merged from local + relay)
+   */
+  async queryHybrid(filter, options = {}) {
+    // Ensure initialization is complete
+    await this._initReady;
+    const timeout = options.timeout !== undefined ? options.timeout : 30000;
+    // Step 1: Get events from local cache
+    const localEvents = this._getMatchingCachedEvents(filter);
+    // If no relays configured, return local only
+    if (this.relays.length === 0) {
+      return localEvents;
+    }
+    // Step 2: Query relays
+    let relayEvents = [];
+    try {
+      relayEvents = await this.pool.querySync(this.relays, filter, { timeout });
+      // Filter out events from other authors
+      if (filter.authors &amp;&amp; filter.authors.length > 0) {
+        relayEvents = relayEvents.filter(event => filter.authors.includes(event.pubkey));
+      }
+    } catch (error) {
+      console.warn('Relay query failed, using local cache only:', error.message);
+    }
+    // Step 3: Merge results (prefer newer events for replaceable events)
+    const merged = new Map();
+    // Add local events first
+    for (const event of localEvents) {
+      const key = this._getEventKey(event);
+      merged.set(key, event);
+    }
+    // Add or update with relay events (relay events are authoritative)
+    for (const event of relayEvents) {
+      const key = this._getEventKey(event);
+      const existing = merged.get(key);
+      // For replaceable events, prefer newer
+      if (event.kind >= 30000 &amp;&amp; event.kind &lt; 40000 &amp;&amp; existing) {
+        if (event.created_at >= existing.created_at) {
+          merged.set(key, event);
+        }
+      } else {
+        // For non-replaceable or if no existing, just add
+        merged.set(key, event);
+      }
+    }
+    const result = Array.from(merged.values());
+    // Cache the merged results
+    const cacheKey = JSON.stringify(filter);
+    this._eventCache.set(cacheKey, {
+      events: result,
+      timestamp: Date.now(),
+    });
+    return result;
+  }
+  /**
+   * Get unique key for event (for merging)
+   * @private
+   */
+  _getEventKey(event) {
+    // For replaceable events with d-tag, use kind:dtag
+    if (event.kind >= 30000 &amp;&amp; event.kind &lt; 40000) {
+      const dTag = event.tags.find(t => t[0] === 'd');
+      if (dTag &amp;&amp; dTag[1]) {
+        return `${event.kind}:${dTag[1]}`;
+      }
+    }
+    // Otherwise use event id
+    return event.id;
+  }
+  /**
+   * Subscribe to events.
+   *
+   * Uses subscription deduplication to avoid creating multiple identical subscriptions.
+   *
+   * @param {Object} filter - Nostr filter object
+   * @param {Function} onEvent - Callback for each event
+   * @param {Object} [options={}] - Subscription options
+   * @param {Function} [options.onEOSE] - Callback when End Of Stored Events is received
+   * @returns {Promise&lt;Object>} Subscription object with unsubscribe method and id
+   * @example
+   * const sub = await client.subscribe(
+   *   { kinds: [30000], authors: [client.publicKey] },
+   *   (event) => console.log('Event:', event)
+   * );
+   * // Later: sub.unsubscribe();
+   */
+  async subscribe(filter, onEvent, options = {}) {
+    // Ensure initialization is complete
+    await this._initReady;
+    const subId = `sub-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+    const filterKey = JSON.stringify(filter);
+    // If no relays, check cache for matching events and trigger callbacks
+    if (this.relays.length === 0) {
+      // Trigger with cached events that match the filter
+      const matchingEvents = this._getMatchingCachedEvents(filter);
+      // Create a mock subscription that watches for new cache entries
+      const mockSub = {
+        filter,
+        onEvent,
+        active: true
+      };
+      this._subscriptions.set(subId, mockSub);
+      // Trigger callbacks asynchronously to mimic real subscription behavior
+      // Check active flag to avoid triggering if unsubscribed immediately
+      setTimeout(() => {
+        if (mockSub.active) {
+          matchingEvents.forEach(event => onEvent(event));
+          if (options.onEOSE) options.onEOSE();
+        }
+      }, 10);
+      return {
+        id: subId,
+        unsubscribe: () => {
+          mockSub.active = false;
+          this._subscriptions.delete(subId);
+          // Clear the subscription's onEvent to prevent any further calls
+          mockSub.onEvent = () => {};
+          // Note: active flag is checked before triggering callbacks
+        },
+      };
+    }
+    // Check if we already have an active subscription for this filter
+    const existing = activeSubscriptions.get(filterKey);
+    if (existing) {
+      // Add callback to existing subscription
+      existing.callbacks.add(onEvent);
+      existing.refCount++;
+      // Return wrapper that removes this specific callback on unsubscribe
+      return {
+        id: subId,
+        unsubscribe: () => {
+          existing.callbacks.delete(onEvent);
+          existing.refCount--;
+          // Only close actual subscription when no more callbacks
+          if (existing.refCount === 0) {
+            if (existing.subscription &amp;&amp; existing.subscription.close) {
+              existing.subscription.close();
+            }
+            activeSubscriptions.delete(filterKey);
+          }
+          this._subscriptions.delete(subId);
+        },
+      };
+    }
+    // Create new subscription with shared callback dispatcher
+    const callbacks = new Set([onEvent]);
+    const subscriptionInfo = {
+      callbacks,
+      refCount: 1,
+      subscription: null,
+    };
+    // Store before creating subscription to handle race conditions
+    activeSubscriptions.set(filterKey, subscriptionInfo);
+    const sub = this.pool.subscribeMany(
+      this.relays,
+      [filter],
+      {
+        onevent: (event) => {
+          // CRITICAL: Filter out events from other authors immediately
+          // Many relays don't respect the authors filter, so we must do it client-side
+          if (filter.authors &amp;&amp; filter.authors.length > 0) {
+            if (!filter.authors.includes(event.pubkey)) {
+              // Silently reject events from other authors
+              return;
+            }
+          }
+          this._cacheEvent(event);
+          // Dispatch to ALL registered callbacks for this subscription
+          const subInfo = activeSubscriptions.get(filterKey);
+          if (subInfo) {
+            for (const cb of subInfo.callbacks) {
+              try {
+                cb(event);
+              } catch (err) {
+                console.warn('[nostr] Subscription callback error:', err.message);
+              }
+            }
+          }
+        },
+        oneose: () => {
+          if (options.onEOSE) options.onEOSE();
+        },
+      }
+    );
+    // Store the actual subscription object
+    subscriptionInfo.subscription = sub;
+    this._subscriptions.set(subId, sub);
+    return {
+      id: subId,
+      unsubscribe: () => {
+        callbacks.delete(onEvent);
+        subscriptionInfo.refCount--;
+        // Only close actual subscription when no more callbacks
+        if (subscriptionInfo.refCount === 0) {
+          if (sub.close) sub.close();
+          activeSubscriptions.delete(filterKey);
+        }
+        this._subscriptions.delete(subId);
+      },
+    };
+  }
+  /**
+   * Cache event in memory (synchronous version for loading)
+   * @private
+   */
+  _cacheEventSync(event) {
+    const key = event.id;
+    this._eventCache.set(key, {
+      events: [event],
+      timestamp: Date.now(),
+    });
+    // For replaceable events (kind 30000-39999), also cache by d-tag
+    if (event.kind >= 30000 &amp;&amp; event.kind &lt; 40000) {
+      const dTag = event.tags.find(t => t[0] === 'd');
+      if (dTag &amp;&amp; dTag[1]) {
+        const dTagKey = `d:${event.kind}:${dTag[1]}`;
+        const existing = this._eventCache.get(dTagKey);
+        // Replace if newer, or if same timestamp but different event ID (for events in same second)
+        const shouldReplace = !existing || !existing.events[0] ||
+                             event.created_at > existing.events[0].created_at ||
+                             (event.created_at === existing.events[0].created_at &amp;&amp; event.id !== existing.events[0].id);
+        if (shouldReplace) {
+          this._eventCache.set(dTagKey, {
+            events: [event],
+            timestamp: Date.now(),
+          });
+          // Remove old event from cache if it exists
+          if (existing &amp;&amp; existing.events[0]) {
+            this._eventCache.delete(existing.events[0].id);
+          }
+          // Invalidate any query caches that might contain stale data for this d-tag
+          // Query caches are JSON-stringified filters, so we look for any that match this event
+          this._invalidateQueryCachesForEvent(event);
+        }
+      }
+    }
+  }
+  /**
+   * Invalidate query caches that might be affected by a new event
+   * Uses reverse index for O(1) lookup instead of O(n) scan
+   * @private
+   */
+  _invalidateQueryCachesForEvent(event) {
+    // Use reverse index for fast lookup - only check caches that could match this event's kind
+    const indexedKeys = this._cacheIndex.get(event.kind);
+    if (!indexedKeys || indexedKeys.size === 0) {
+      return; // No cached queries for this kind
+    }
+    const keysToDelete = [];
+    // Only iterate over cache entries that match the event's kind
+    for (const cacheKey of indexedKeys) {
+      const cached = this._eventCache.get(cacheKey);
+      if (!cached) {
+        // Cache entry was evicted, clean up index
+        indexedKeys.delete(cacheKey);
+        continue;
+      }
+      try {
+        const filter = JSON.parse(cacheKey);
+        // Check if this event would match the filter
+        if (this._eventMatchesFilter(event, filter)) {
+          keysToDelete.push(cacheKey);
+        }
+      } catch {
+        // Not a valid JSON key, clean up index
+        indexedKeys.delete(cacheKey);
+      }
+    }
+    for (const key of keysToDelete) {
+      this._eventCache.delete(key);
+      this._unindexCacheEntry(key);
+    }
+  }
+  /**
+   * Cache event in memory and persist (batched)
+   * @private
+   */
+  async _cacheEvent(event) {
+    // Cache in memory (synchronous - immediate for local-first reads)
+    this._cacheEventSync(event);
+    // Queue for batched persistence (async - batches writes for I/O efficiency)
+    if (this.persistentStorage) {
+      // For replaceable events, use d-tag as key
+      let storageKey = event.id;
+      if (event.kind >= 30000 &amp;&amp; event.kind &lt; 40000) {
+        const dTag = event.tags.find(t => t[0] === 'd');
+        if (dTag &amp;&amp; dTag[1]) {
+          storageKey = dTag[1]; // Use d-tag as key for replaceable events
+        }
+      }
+      // Queue for batched write (overwrites previous if same key)
+      this._persistQueue.set(storageKey, event);
+      // Schedule batch flush if not already scheduled
+      if (!this._persistTimer) {
+        this._persistTimer = setTimeout(() => this._flushPersistQueue(), this._persistBatchMs);
+      }
+    }
+    // Trigger any active subscriptions that match this event
+    if (this.relays.length === 0) {
+      for (const sub of this._subscriptions.values()) {
+        if (sub.active &amp;&amp; this._eventMatchesFilter(event, sub.filter)) {
+          // Trigger callback asynchronously, but check active status again
+          setTimeout(() => {
+            if (sub.active) {
+              sub.onEvent(event);
+            }
+          }, 10);
+        }
+      }
+    }
+  }
+  /**
+   * Flush batched persistent writes
+   * @private
+   */
+  async _flushPersistQueue() {
+    this._persistTimer = null;
+    if (!this.persistentStorage || this._persistQueue.size === 0) {
+      return;
+    }
+    // Take snapshot of current queue and clear it
+    const toWrite = Array.from(this._persistQueue.entries());
+    this._persistQueue.clear();
+    // Write all queued events
+    const writePromises = toWrite.map(async ([key, event]) => {
+      try {
+        await this.persistentStorage.put(key, event);
+      } catch (error) {
+        console.warn(`Failed to persist event ${key}:`, error.message);
+      }
+    });
+    // Wait for all writes to complete
+    await Promise.all(writePromises);
+  }
+  /**
+   * Get cached events matching a filter
+   * @private
+   */
+  _getMatchingCachedEvents(filter) {
+    const matchingEvents = [];
+    const seenDTags = new Map(); // For deduplicating replaceable events
+    for (const cached of this._eventCache.values()) {
+      for (const event of (cached.events || [])) {
+        if (this._eventMatchesFilter(event, filter)) {
+          // For replaceable events (kind 30000-39999), keep only the newest
+          if (event.kind >= 30000 &amp;&amp; event.kind &lt; 40000) {
+            const dTag = event.tags.find(t => t[0] === 'd');
+            if (dTag &amp;&amp; dTag[1]) {
+              const dTagKey = `${event.kind}:${dTag[1]}`;
+              const existing = seenDTags.get(dTagKey);
+              // Replace if newer, or if same timestamp with _deleted flag (tombstones)
+              const shouldReplace = !existing ||
+                                   event.created_at > existing.created_at ||
+                                   (event.created_at === existing.created_at &amp;&amp;
+                                    JSON.parse(event.content)?._deleted &amp;&amp;
+                                    !JSON.parse(existing.content)?._deleted);
+              if (shouldReplace) {
+                // Remove old event if exists
+                if (existing) {
+                  const idx = matchingEvents.indexOf(existing);
+                  if (idx > -1) matchingEvents.splice(idx, 1);
+                }
+                seenDTags.set(dTagKey, event);
+                matchingEvents.push(event);
+              }
+              continue;
+            }
+          }
+          // Regular events or replaceable events without d-tag
+          matchingEvents.push(event);
+        }
+      }
+    }
+    return matchingEvents;
+  }
+  /**
+   * Check if event matches filter
+   * @private
+   */
+  _eventMatchesFilter(event, filter) {
+    // Check kinds
+    if (filter.kinds &amp;&amp; !filter.kinds.includes(event.kind)) {
+      return false;
+    }
+    // Check IDs
+    if (filter.ids &amp;&amp; !filter.ids.includes(event.id)) {
+      return false;
+    }
+    // Check authors
+    if (filter.authors &amp;&amp; !filter.authors.includes(event.pubkey)) {
+      return false;
+    }
+    // Check #d tag (for replaceable events)
+    if (filter['#d']) {
+      const dTag = event.tags.find(t => t[0] === 'd');
+      if (!dTag || !filter['#d'].includes(dTag[1])) {
+        return false;
+      }
+    }
+    // Check since/until
+    if (filter.since &amp;&amp; event.created_at &lt; filter.since) {
+      return false;
+    }
+    if (filter.until &amp;&amp; event.created_at > filter.until) {
+      return false;
+    }
+    return true;
+  }
+  /**
+   * Get single event by ID
+   * @param {string} eventId - Event ID (hex)
+   * @returns {Promise&lt;Object|null>} Event or null
+   */
+  async getEvent(eventId) {
+    const events = await this.query({ ids: [eventId] });
+    return events.length > 0 ? events[0] : null;
+  }
+  /**
+   * Clear the event cache (or specific entries matching a pattern)
+   * @param {string} [pattern] - Optional d-tag pattern to match (clears all if not provided)
+   */
+  clearCache(pattern = null) {
+    if (!pattern) {
+      this._eventCache.clear();
+      return;
+    }
+    // Clear entries matching the pattern
+    for (const key of this._eventCache.keys()) {
+      if (key.includes(pattern)) {
+        this._eventCache.delete(key);
+      }
+    }
+  }
+  /**
+   * Close all connections and subscriptions.
+   *
+   * @param {Object} [options={}] - Close options
+   * @param {boolean} [options.flush=true] - Flush pending writes before closing
+   * @returns {Promise&lt;void>}
+   */
+  async close(options = {}) {
+    const shouldFlush = options.flush !== false;
+    // Flush pending persistent writes before closing
+    if (shouldFlush &amp;&amp; this._persistTimer) {
+      clearTimeout(this._persistTimer);
+      await this._flushPersistQueue();
+    }
+    // Stop background sync service
+    if (this.syncService) {
+      this.syncService.stop();
+    }
+    // Close long-lived author subscription
+    const authorSub = authorSubscriptions.get(this.publicKey);
+    if (authorSub &amp;&amp; authorSub.subscription) {
+      if (authorSub.subscription.close) {
+        authorSub.subscription.close();
+      }
+      authorSubscriptions.delete(this.publicKey);
+    }
+    // Close all subscriptions
+    for (const sub of this._subscriptions.values()) {
+      if (sub.close) {
+        sub.close();
+      } else if (sub.active !== undefined) {
+        // Mock subscription
+        sub.active = false;
+      }
+    }
+    this._subscriptions.clear();
+    // Close pool
+    this.pool.close(this.relays);
+    // Clear cache and index
+    this._eventCache.clear();
+    this._cacheIndex.clear();
+  }
+  /**
+   * Get relay status
+   * @returns {Array} Relay connection statuses
+   */
+  getRelayStatus() {
+    return this.relays.map(relay => ({
+      url: relay,
+      connected: true, // SimplePool manages this internally
+    }));
+  }
+}
+/**
+ * Create NostrClient instance.
+ *
+ * @param {Object} config - Configuration options
+ * @returns {NostrClient} Client instance
+ * @example
+ * const client = createClient({
+ *   relays: ['wss://relay.example.com'],
+ *   appName: 'myapp'
+ * });
+ */
+export function createClient(config) {
+  return new NostrClient(config);
+}
+</code></pre></article></section></div></div></div><div class="search-container" id="PkfLWpAbet" style="display:none"><div class="wrapper" id="iCxFxjkHbP"><button class="icon-button search-close-button" id="VjLlGakifb" aria-label="close search"><svg><use xlink:href="#close-icon"></use></svg></button><div class="search-box-c"><svg><use xlink:href="#search-icon"></use></svg> <input type="text" id="vpcKVYIppa" class="search-input" placeholder="Search..." autofocus></div><div class="search-result-c" id="fWwVHRuDuN"><span class="search-result-c-text">Type anything to view search result</span></div></div></div><div class="mobile-menu-icon-container"><button class="icon-button" id="mobile-menu" data-isopen="false" aria-label="menu"><svg><use xlink:href="#menu-icon"></use></svg></button></div><div id="mobile-sidebar" class="mobile-sidebar-container"><div class="mobile-sidebar-wrapper"><div class="mobile-nav-links"></div><div class="mobile-sidebar-items-c"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-modules"><div>Modules</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-ai.html">ai</a></div><div class="sidebar-section-children"><a href="module-ai_aggregation.html">ai/aggregation</a></div><div class="sidebar-section-children"><a href="module-ai_breakdown.html">ai/breakdown</a></div><div class="sidebar-section-children"><a href="module-ai_classifier.html">ai/classifier</a></div><div class="sidebar-section-children"><a href="module-ai_council.html">ai/council</a></div><div class="sidebar-section-children"><a href="module-ai_embeddings.html">ai/embeddings</a></div><div class="sidebar-section-children"><a href="module-ai_federation-ai.html">ai/federation-ai</a></div><div class="sidebar-section-children"><a href="module-ai_h3-ai.html">ai/h3-ai</a></div><div class="sidebar-section-children"><a href="module-ai_json-ops.html">ai/json-ops</a></div><div class="sidebar-section-children"><a href="module-ai_llm-service.html">ai/llm-service</a></div><div class="sidebar-section-children"><a href="module-ai_nl-query.html">ai/nl-query</a></div><div class="sidebar-section-children"><a href="module-ai_relationships.html">ai/relationships</a></div><div class="sidebar-section-children"><a href="module-ai_schema-extractor.html">ai/schema-extractor</a></div><div class="sidebar-section-children"><a href="module-ai_spatial.html">ai/spatial</a></div><div class="sidebar-section-children"><a href="module-ai_tts.html">ai/tts</a></div><div class="sidebar-section-children"><a href="module-content_social-protocols.html">content/social-protocols</a></div><div class="sidebar-section-children"><a href="module-core_holosphere.html">core/holosphere</a></div><div class="sidebar-section-children"><a href="module-crypto_nostr-utils.html">crypto/nostr-utils</a></div><div class="sidebar-section-children"><a href="module-crypto_secp256k1.html">crypto/secp256k1</a></div><div class="sidebar-section-children"><a href="module-federation_hologram.html">federation/hologram</a></div><div class="sidebar-section-children"><a href="module-hierarchical_upcast.html">hierarchical/upcast</a></div><div class="sidebar-section-children"><a href="module-holosphere.html">holosphere</a></div><div class="sidebar-section-children"><a href="module-lib_ai-methods.html">lib/ai-methods</a></div><div class="sidebar-section-children"><a href="module-lib_contract-methods.html">lib/contract-methods</a></div><div class="sidebar-section-children"><a href="module-lib_errors.html">lib/errors</a></div><div class="sidebar-section-children"><a href="module-lib_federation-methods.html">lib/federation-methods</a></div><div class="sidebar-section-children"><a href="module-lib_index.html">lib/index</a></div><div class="sidebar-section-children"><a href="module-schema_validator.html">schema/validator</a></div><div class="sidebar-section-children"><a href="module-spatial_h3-operations.html">spatial/h3-operations</a></div><div class="sidebar-section-children"><a href="module-storage_backend-factory.html">storage/backend-factory</a></div><div class="sidebar-section-children"><a href="module-storage_backend-interface.html">storage/backend-interface</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub-backend.html">storage/backends/activitypub-backend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub_server.html">storage/backends/activitypub/server</a></div><div class="sidebar-section-children"><a href="module-storage_backends_gundb-backend.html">storage/backends/gundb-backend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_nostr-backend.html">storage/backends/nostr-backend</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage.html">storage/filesystem-storage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-browser.html">storage/filesystem-storage-browser</a></div><div class="sidebar-section-children"><a href="module-storage_global-tables.html">storage/global-tables</a></div><div class="sidebar-section-children"><a href="module-storage_gun-async.html">storage/gun-async</a></div><div class="sidebar-section-children"><a href="module-storage_gun-auth.html">storage/gun-auth</a></div><div class="sidebar-section-children"><a href="module-storage_gun-federation.html">storage/gun-federation</a></div><div class="sidebar-section-children"><a href="module-storage_gun-references.html">storage/gun-references</a></div><div class="sidebar-section-children"><a href="module-storage_gun-schema.html">storage/gun-schema</a></div><div class="sidebar-section-children"><a href="module-storage_gun-wrapper.html">storage/gun-wrapper</a></div><div class="sidebar-section-children"><a href="module-storage_indexeddb-storage.html">storage/indexeddb-storage</a></div><div class="sidebar-section-children"><a href="module-storage_key-storage.html">storage/key-storage</a></div><div class="sidebar-section-children"><a href="module-storage_key-storage-simple.html">storage/key-storage-simple</a></div><div class="sidebar-section-children"><a href="module-storage_memory-storage.html">storage/memory-storage</a></div><div class="sidebar-section-children"><a href="module-storage_migration.html">storage/migration</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-async.html">storage/nostr-async</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client.html">storage/nostr-client</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-wrapper.html">storage/nostr-wrapper</a></div><div class="sidebar-section-children"><a href="module-storage_outbox-queue.html">storage/outbox-queue</a></div><div class="sidebar-section-children"><a href="module-storage_persistent-storage.html">storage/persistent-storage</a></div><div class="sidebar-section-children"><a href="module-storage_sync-service.html">storage/sync-service</a></div><div class="sidebar-section-children"><a href="module-storage_unified-storage.html">storage/unified-storage</a></div><div class="sidebar-section-children"><a href="module-subscriptions_manager.html">subscriptions/manager</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-classes"><div>Classes</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-ai_aggregation.SmartAggregation.html">SmartAggregation</a></div><div class="sidebar-section-children"><a href="module-ai_aggregation-SmartAggregation.html">SmartAggregation</a></div><div class="sidebar-section-children"><a href="module-ai_breakdown.TaskBreakdown.html">TaskBreakdown</a></div><div class="sidebar-section-children"><a href="module-ai_breakdown-TaskBreakdown.html">TaskBreakdown</a></div><div class="sidebar-section-children"><a href="module-ai_classifier.Classifier.html">Classifier</a></div><div class="sidebar-section-children"><a href="module-ai_classifier-Classifier.html">Classifier</a></div><div class="sidebar-section-children"><a href="module-ai_council.Council.html">Council</a></div><div class="sidebar-section-children"><a href="module-ai_council-Council.html">Council</a></div><div class="sidebar-section-children"><a href="module-ai_embeddings.Embeddings.html">Embeddings</a></div><div class="sidebar-section-children"><a href="module-ai_embeddings-Embeddings.html">Embeddings</a></div><div class="sidebar-section-children"><a href="module-ai_federation-ai.FederationAdvisor.html">FederationAdvisor</a></div><div class="sidebar-section-children"><a href="module-ai_federation-ai-FederationAdvisor.html">FederationAdvisor</a></div><div class="sidebar-section-children"><a href="module-ai_h3-ai.H3AI.html">H3AI</a></div><div class="sidebar-section-children"><a href="module-ai_h3-ai-H3AI.html">H3AI</a></div><div class="sidebar-section-children"><a href="module-ai_json-ops.JSONOps.html">JSONOps</a></div><div class="sidebar-section-children"><a href="module-ai_json-ops-JSONOps.html">JSONOps</a></div><div class="sidebar-section-children"><a href="module-ai_llm-service.LLMService.html">LLMService</a></div><div class="sidebar-section-children"><a href="module-ai_llm-service-LLMService.html">LLMService</a></div><div class="sidebar-section-children"><a href="module-ai_nl-query.NLQuery.html">NLQuery</a></div><div class="sidebar-section-children"><a href="module-ai_nl-query-NLQuery.html">NLQuery</a></div><div class="sidebar-section-children"><a href="module-ai_relationships.RelationshipDiscovery.html">RelationshipDiscovery</a></div><div class="sidebar-section-children"><a href="module-ai_relationships-RelationshipDiscovery.html">RelationshipDiscovery</a></div><div class="sidebar-section-children"><a href="module-ai_schema-extractor.SchemaExtractor.html">SchemaExtractor</a></div><div class="sidebar-section-children"><a href="module-ai_schema-extractor-SchemaExtractor.html">SchemaExtractor</a></div><div class="sidebar-section-children"><a href="module-ai_spatial.SpatialAnalysis.html">SpatialAnalysis</a></div><div class="sidebar-section-children"><a href="module-ai_spatial-SpatialAnalysis.html">SpatialAnalysis</a></div><div class="sidebar-section-children"><a href="module-ai_tts.TTS.html">TTS</a></div><div class="sidebar-section-children"><a href="module-ai_tts-TTS.html">TTS</a></div><div class="sidebar-section-children"><a href="module-core_holosphere.HoloSphere.html">HoloSphere</a></div><div class="sidebar-section-children"><a href="module-core_holosphere-HoloSphere.html">HoloSphere</a></div><div class="sidebar-section-children"><a href="module-holosphere-HoloSphereBase.html">HoloSphereBase</a></div><div class="sidebar-section-children"><a href="module-holosphere-HoloSphereBase.html">HoloSphereBase</a></div><div class="sidebar-section-children"><a href="module-lib_errors.AuthorizationError.html">AuthorizationError</a></div><div class="sidebar-section-children"><a href="module-lib_errors.ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-lib_errors-AuthorizationError.html">AuthorizationError</a></div><div class="sidebar-section-children"><a href="module-lib_errors-ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-schema_validator.ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-schema_validator-ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-storage_backend-factory.BackendFactory.html">BackendFactory</a></div><div class="sidebar-section-children"><a href="module-storage_backend-interface.StorageBackend.html">StorageBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backend-interface-StorageBackend.html">StorageBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub-backend.ActivityPubBackend.html">ActivityPubBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub-backend-ActivityPubBackend.html">ActivityPubBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub_server.ActivityPubServer.html">ActivityPubServer</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub_server-ActivityPubServer.html">ActivityPubServer</a></div><div class="sidebar-section-children"><a href="module-storage_backends_gundb-backend.GunDBBackend.html">GunDBBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_gundb-backend-GunDBBackend.html">GunDBBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_nostr-backend.NostrBackend.html">NostrBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_nostr-backend-NostrBackend.html">NostrBackend</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-browser.FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-browser-FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage.FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_gun-auth.GunAuth.html">GunAuth</a></div><div class="sidebar-section-children"><a href="module-storage_gun-auth-GunAuth.html">GunAuth</a></div><div class="sidebar-section-children"><a href="module-storage_gun-references.GunReferenceHandler.html">GunReferenceHandler</a></div><div class="sidebar-section-children"><a href="module-storage_gun-references-GunReferenceHandler.html">GunReferenceHandler</a></div><div class="sidebar-section-children"><a href="module-storage_gun-schema.GunSchemaValidator.html">GunSchemaValidator</a></div><div class="sidebar-section-children"><a href="module-storage_gun-schema-GunSchemaValidator.html">GunSchemaValidator</a></div><div class="sidebar-section-children"><a href="module-storage_indexeddb-storage.IndexedDBStorage.html">IndexedDBStorage</a></div><div class="sidebar-section-children"><a href="module-storage_indexeddb-storage-IndexedDBStorage.html">IndexedDBStorage</a></div><div class="sidebar-section-children"><a href="module-storage_memory-storage.MemoryStorage.html">MemoryStorage</a></div><div class="sidebar-section-children"><a href="module-storage_memory-storage-MemoryStorage.html">MemoryStorage</a></div><div class="sidebar-section-children"><a href="module-storage_migration.MigrationTool.html">MigrationTool</a></div><div class="sidebar-section-children"><a href="module-storage_migration-MigrationTool.html">MigrationTool</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client.NostrClient.html">NostrClient</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client-LRUCache.html">LRUCache</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client-NostrClient.html">NostrClient</a></div><div class="sidebar-section-children"><a href="module-storage_outbox-queue.OutboxQueue.html">OutboxQueue</a></div><div class="sidebar-section-children"><a href="module-storage_outbox-queue-OutboxQueue.html">OutboxQueue</a></div><div class="sidebar-section-children"><a href="module-storage_persistent-storage-PersistentStorage.html">PersistentStorage</a></div><div class="sidebar-section-children"><a href="module-storage_sync-service.SyncService.html">SyncService</a></div><div class="sidebar-section-children"><a href="module-storage_sync-service-SyncService.html">SyncService</a></div><div class="sidebar-section-children"><a href="module-subscriptions_manager.SubscriptionRegistry.html">SubscriptionRegistry</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-global"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#FederationRequestPayload">FederationRequestPayload</a></div><div class="sidebar-section-children"><a href="global.html#FederationResponsePayload">FederationResponsePayload</a></div><div class="sidebar-section-children"><a href="global.html#acceptFederationRequest">acceptFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#acceptFederationRequest">acceptFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#addFederatedPartner">addFederatedPartner</a></div><div class="sidebar-section-children"><a href="global.html#cleanupExpiredCapabilities">cleanupExpiredCapabilities</a></div><div class="sidebar-section-children"><a href="global.html#createFederationRequest">createFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#createFederationResponse">createFederationResponse</a></div><div class="sidebar-section-children"><a href="global.html#declineFederationRequest">declineFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#getCapabilityForAuthor">getCapabilityForAuthor</a></div><div class="sidebar-section-children"><a href="global.html#getFederatedAuthors">getFederatedAuthors</a></div><div class="sidebar-section-children"><a href="global.html#getFederatedAuthorsForScope">getFederatedAuthorsForScope</a></div><div class="sidebar-section-children"><a href="global.html#getFederatedPartner">getFederatedPartner</a></div><div class="sidebar-section-children"><a href="global.html#getFederationRegistry">getFederationRegistry</a></div><div class="sidebar-section-children"><a href="global.html#getPendingFederationRequests">getPendingFederationRequests</a></div><div class="sidebar-section-children"><a href="global.html#initiateFederationHandshake">initiateFederationHandshake</a></div><div class="sidebar-section-children"><a href="global.html#isFederationRequest">isFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#isFederationResponse">isFederationResponse</a></div><div class="sidebar-section-children"><a href="global.html#rejectFederationRequest">rejectFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#removeFederatedPartner">removeFederatedPartner</a></div><div class="sidebar-section-children"><a href="global.html#revokeOutboundCapability">revokeOutboundCapability</a></div><div class="sidebar-section-children"><a href="global.html#saveFederationRegistry">saveFederationRegistry</a></div><div class="sidebar-section-children"><a href="global.html#sendFederationRequest">sendFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#sendFederationRequest">sendFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#sendFederationResponse">sendFederationResponse</a></div><div class="sidebar-section-children"><a href="global.html#storeInboundCapability">storeInboundCapability</a></div><div class="sidebar-section-children"><a href="global.html#storeOutboundCapability">storeOutboundCapability</a></div><div class="sidebar-section-children"><a href="global.html#subscribeFederationAcceptances">subscribeFederationAcceptances</a></div><div class="sidebar-section-children"><a href="global.html#subscribeFederationDeclines">subscribeFederationDeclines</a></div><div class="sidebar-section-children"><a href="global.html#subscribeFederationRequests">subscribeFederationRequests</a></div><div class="sidebar-section-children"><a href="global.html#subscribeToFederationDMs">subscribeToFederationDMs</a></div><div class="sidebar-section-children"><a href="global.html#updateDiscoverySettings">updateDiscoverySettings</a></div></div></div><div class="mobile-navbar-actions"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#light-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div></div></div><script type="text/javascript" src="scripts/core.min.js"></script><script src="scripts/search.min.js" defer="defer"></script><script src="scripts/third-party/fuse.js" defer="defer"></script><script type="text/javascript">var tocbotInstance=tocbot.init({tocSelector:"#eed4d2a0bfd64539bb9df78095dec881",contentSelector:".main-content",headingSelector:"h1, h2, h3",hasInnerContainers:!0,scrollContainer:".main-content",headingsOffset:130,onClick:bringLinkToView})</script></body></html>