holosphere 2.0.0-alpha0 → 2.0.0-alpha10

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 (418) hide show
  1. package/CHANGELOG.md +473 -0
  2. package/FEATURES.md +431 -0
  3. package/LICENSE +29 -42
  4. package/LICENSE-AGPL.md +180 -0
  5. package/README.md +97 -16
  6. package/dist/2019-D2OG2idw.js +6680 -0
  7. package/dist/2019-D2OG2idw.js.map +1 -0
  8. package/dist/2019-EION3wKo.cjs +8 -0
  9. package/dist/2019-EION3wKo.cjs.map +1 -0
  10. package/dist/_commonjsHelpers-C37NGDzP.cjs +2 -0
  11. package/dist/_commonjsHelpers-C37NGDzP.cjs.map +1 -0
  12. package/dist/_commonjsHelpers-CUmg6egw.js +7 -0
  13. package/dist/_commonjsHelpers-CUmg6egw.js.map +1 -0
  14. package/dist/browser-BSniCNqO.js +3058 -0
  15. package/dist/browser-BSniCNqO.js.map +1 -0
  16. package/dist/browser-Cq59Ij19.cjs +2 -0
  17. package/dist/browser-Cq59Ij19.cjs.map +1 -0
  18. package/dist/cdn/holosphere.min.js +55 -0
  19. package/dist/cdn/holosphere.min.js.map +1 -0
  20. package/dist/cjs/holosphere.cjs +2 -0
  21. package/dist/cjs/holosphere.cjs.map +1 -0
  22. package/dist/esm/holosphere.js +53 -0
  23. package/dist/esm/holosphere.js.map +1 -0
  24. package/dist/index-DDGt_V9o.cjs +12 -0
  25. package/dist/index-DDGt_V9o.cjs.map +1 -0
  26. package/dist/index-DJXftyvB.js +39841 -0
  27. package/dist/index-DJXftyvB.js.map +1 -0
  28. package/dist/index-DMbdcMtK.cjs +18 -0
  29. package/dist/index-DMbdcMtK.cjs.map +1 -0
  30. package/dist/index-DeZ1xz_s.js +15104 -0
  31. package/dist/index-DeZ1xz_s.js.map +1 -0
  32. package/dist/indexeddb-storage-BFt6hMeF.js +176 -0
  33. package/dist/indexeddb-storage-BFt6hMeF.js.map +1 -0
  34. package/dist/indexeddb-storage-BK5tv4Sh.cjs +2 -0
  35. package/dist/indexeddb-storage-BK5tv4Sh.cjs.map +1 -0
  36. package/dist/memory-storage-C9HuoL2E.js +91 -0
  37. package/dist/memory-storage-C9HuoL2E.js.map +1 -0
  38. package/dist/memory-storage-Dao7jfYG.cjs +2 -0
  39. package/dist/memory-storage-Dao7jfYG.cjs.map +1 -0
  40. package/dist/secp256k1-BbKzbLtD.cjs +12 -0
  41. package/dist/secp256k1-BbKzbLtD.cjs.map +1 -0
  42. package/dist/secp256k1-CreY7Pcl.js +1890 -0
  43. package/dist/secp256k1-CreY7Pcl.js.map +1 -0
  44. package/docs/CONTRACTS.md +797 -0
  45. package/docs/FOSDEM_PROPOSAL.md +388 -0
  46. package/docs/LOCALFIRST.md +266 -0
  47. package/docs/api/ai_aggregation.js.html +333 -0
  48. package/docs/api/ai_breakdown.js.html +524 -0
  49. package/docs/api/ai_classifier.js.html +231 -0
  50. package/docs/api/ai_council.js.html +246 -0
  51. package/docs/api/ai_embeddings.js.html +304 -0
  52. package/docs/api/ai_federation-ai.js.html +338 -0
  53. package/docs/api/ai_h3-ai.js.html +970 -0
  54. package/docs/api/ai_index.js.html +124 -0
  55. package/docs/api/ai_json-ops.js.html +241 -0
  56. package/docs/api/ai_llm-service.js.html +239 -0
  57. package/docs/api/ai_nl-query.js.html +236 -0
  58. package/docs/api/ai_relationships.js.html +367 -0
  59. package/docs/api/ai_schema-extractor.js.html +235 -0
  60. package/docs/api/ai_spatial.js.html +307 -0
  61. package/docs/api/ai_tts.js.html +214 -0
  62. package/docs/api/content_social-protocols.js.html +180 -0
  63. package/docs/api/core_holosphere.js.html +757 -0
  64. package/docs/api/crypto_nostr-utils.js.html +306 -0
  65. package/docs/api/crypto_secp256k1.js.html +267 -0
  66. package/docs/api/data/search.json +1 -0
  67. package/docs/api/federation_discovery.js.html +337 -0
  68. package/docs/api/federation_handshake.js.html +478 -0
  69. package/docs/api/federation_hologram.js.html +1053 -0
  70. package/docs/api/federation_registry.js.html +389 -0
  71. package/docs/api/fonts/Inconsolata-Regular.ttf +0 -0
  72. package/docs/api/fonts/OpenSans-Regular.ttf +0 -0
  73. package/docs/api/fonts/WorkSans-Bold.ttf +0 -0
  74. package/docs/api/global.html +3 -0
  75. package/docs/api/hierarchical_upcast.js.html +128 -0
  76. package/docs/api/index.html +265 -0
  77. package/docs/api/index.js.html +1868 -0
  78. package/docs/api/lib_ai-methods.js.html +660 -0
  79. package/docs/api/lib_contract-methods.js.html +445 -0
  80. package/docs/api/lib_errors.js.html +56 -0
  81. package/docs/api/lib_federation-methods.js.html +348 -0
  82. package/docs/api/lib_index.js.html +33 -0
  83. package/docs/api/module-ai.html +5 -0
  84. package/docs/api/module-ai_aggregation-SmartAggregation.html +6 -0
  85. package/docs/api/module-ai_aggregation.SmartAggregation.html +3 -0
  86. package/docs/api/module-ai_aggregation.html +3 -0
  87. package/docs/api/module-ai_breakdown-TaskBreakdown.html +5 -0
  88. package/docs/api/module-ai_breakdown.TaskBreakdown.html +3 -0
  89. package/docs/api/module-ai_breakdown.html +3 -0
  90. package/docs/api/module-ai_classifier-Classifier.html +6 -0
  91. package/docs/api/module-ai_classifier.Classifier.html +3 -0
  92. package/docs/api/module-ai_classifier.html +3 -0
  93. package/docs/api/module-ai_council-Council.html +6 -0
  94. package/docs/api/module-ai_council.Council.html +3 -0
  95. package/docs/api/module-ai_council.html +3 -0
  96. package/docs/api/module-ai_embeddings-Embeddings.html +5 -0
  97. package/docs/api/module-ai_embeddings.Embeddings.html +3 -0
  98. package/docs/api/module-ai_embeddings.html +3 -0
  99. package/docs/api/module-ai_federation-ai-FederationAdvisor.html +6 -0
  100. package/docs/api/module-ai_federation-ai.FederationAdvisor.html +3 -0
  101. package/docs/api/module-ai_federation-ai.html +3 -0
  102. package/docs/api/module-ai_h3-ai-H3AI.html +6 -0
  103. package/docs/api/module-ai_h3-ai.H3AI.html +3 -0
  104. package/docs/api/module-ai_h3-ai.html +3 -0
  105. package/docs/api/module-ai_json-ops-JSONOps.html +5 -0
  106. package/docs/api/module-ai_json-ops.JSONOps.html +3 -0
  107. package/docs/api/module-ai_json-ops.html +3 -0
  108. package/docs/api/module-ai_llm-service-LLMService.html +5 -0
  109. package/docs/api/module-ai_llm-service.LLMService.html +3 -0
  110. package/docs/api/module-ai_llm-service.html +3 -0
  111. package/docs/api/module-ai_nl-query-NLQuery.html +5 -0
  112. package/docs/api/module-ai_nl-query.NLQuery.html +3 -0
  113. package/docs/api/module-ai_nl-query.html +3 -0
  114. package/docs/api/module-ai_relationships-RelationshipDiscovery.html +6 -0
  115. package/docs/api/module-ai_relationships.RelationshipDiscovery.html +3 -0
  116. package/docs/api/module-ai_relationships.html +3 -0
  117. package/docs/api/module-ai_schema-extractor-SchemaExtractor.html +5 -0
  118. package/docs/api/module-ai_schema-extractor.SchemaExtractor.html +3 -0
  119. package/docs/api/module-ai_schema-extractor.html +3 -0
  120. package/docs/api/module-ai_spatial-SpatialAnalysis.html +6 -0
  121. package/docs/api/module-ai_spatial.SpatialAnalysis.html +3 -0
  122. package/docs/api/module-ai_spatial.html +3 -0
  123. package/docs/api/module-ai_tts-TTS.html +5 -0
  124. package/docs/api/module-ai_tts.TTS.html +3 -0
  125. package/docs/api/module-ai_tts.html +3 -0
  126. package/docs/api/module-content_social-protocols.html +3 -0
  127. package/docs/api/module-core_holosphere-HoloSphere.html +6 -0
  128. package/docs/api/module-core_holosphere.HoloSphere.html +3 -0
  129. package/docs/api/module-core_holosphere.html +3 -0
  130. package/docs/api/module-crypto_nostr-utils.html +3 -0
  131. package/docs/api/module-crypto_secp256k1.html +3 -0
  132. package/docs/api/module-federation_hologram.html +3 -0
  133. package/docs/api/module-hierarchical_upcast.html +3 -0
  134. package/docs/api/module-holosphere-HoloSphereBase.html +3 -0
  135. package/docs/api/module-holosphere.html +3 -0
  136. package/docs/api/module-lib_ai-methods.html +3 -0
  137. package/docs/api/module-lib_contract-methods.html +3 -0
  138. package/docs/api/module-lib_errors-AuthorizationError.html +3 -0
  139. package/docs/api/module-lib_errors-ValidationError.html +3 -0
  140. package/docs/api/module-lib_errors.AuthorizationError.html +3 -0
  141. package/docs/api/module-lib_errors.ValidationError.html +3 -0
  142. package/docs/api/module-lib_errors.html +3 -0
  143. package/docs/api/module-lib_federation-methods.html +3 -0
  144. package/docs/api/module-lib_index.html +3 -0
  145. package/docs/api/module-schema_validator-ValidationError.html +3 -0
  146. package/docs/api/module-schema_validator.ValidationError.html +3 -0
  147. package/docs/api/module-schema_validator.html +3 -0
  148. package/docs/api/module-spatial_h3-operations.html +4 -0
  149. package/docs/api/module-storage_backend-factory.BackendFactory.html +3 -0
  150. package/docs/api/module-storage_backend-factory.html +3 -0
  151. package/docs/api/module-storage_backend-interface-StorageBackend.html +3 -0
  152. package/docs/api/module-storage_backend-interface.StorageBackend.html +3 -0
  153. package/docs/api/module-storage_backend-interface.html +3 -0
  154. package/docs/api/module-storage_backends_activitypub-backend-ActivityPubBackend.html +7 -0
  155. package/docs/api/module-storage_backends_activitypub-backend.ActivityPubBackend.html +3 -0
  156. package/docs/api/module-storage_backends_activitypub-backend.html +3 -0
  157. package/docs/api/module-storage_backends_activitypub_server-ActivityPubServer.html +8 -0
  158. package/docs/api/module-storage_backends_activitypub_server.ActivityPubServer.html +3 -0
  159. package/docs/api/module-storage_backends_activitypub_server.html +3 -0
  160. package/docs/api/module-storage_backends_gundb-backend-GunDBBackend.html +7 -0
  161. package/docs/api/module-storage_backends_gundb-backend.GunDBBackend.html +3 -0
  162. package/docs/api/module-storage_backends_gundb-backend.html +3 -0
  163. package/docs/api/module-storage_backends_nostr-backend-NostrBackend.html +8 -0
  164. package/docs/api/module-storage_backends_nostr-backend.NostrBackend.html +3 -0
  165. package/docs/api/module-storage_backends_nostr-backend.html +3 -0
  166. package/docs/api/module-storage_filesystem-storage-FileSystemStorage.html +5 -0
  167. package/docs/api/module-storage_filesystem-storage-browser-FileSystemStorage.html +3 -0
  168. package/docs/api/module-storage_filesystem-storage-browser.FileSystemStorage.html +3 -0
  169. package/docs/api/module-storage_filesystem-storage-browser.html +3 -0
  170. package/docs/api/module-storage_filesystem-storage.FileSystemStorage.html +3 -0
  171. package/docs/api/module-storage_filesystem-storage.html +3 -0
  172. package/docs/api/module-storage_global-tables.html +3 -0
  173. package/docs/api/module-storage_gun-async.html +3 -0
  174. package/docs/api/module-storage_gun-auth-GunAuth.html +5 -0
  175. package/docs/api/module-storage_gun-auth.GunAuth.html +3 -0
  176. package/docs/api/module-storage_gun-auth.html +3 -0
  177. package/docs/api/module-storage_gun-federation.html +3 -0
  178. package/docs/api/module-storage_gun-references-GunReferenceHandler.html +5 -0
  179. package/docs/api/module-storage_gun-references.GunReferenceHandler.html +3 -0
  180. package/docs/api/module-storage_gun-references.html +3 -0
  181. package/docs/api/module-storage_gun-schema-GunSchemaValidator.html +5 -0
  182. package/docs/api/module-storage_gun-schema.GunSchemaValidator.html +3 -0
  183. package/docs/api/module-storage_gun-schema.html +3 -0
  184. package/docs/api/module-storage_gun-wrapper.html +11 -0
  185. package/docs/api/module-storage_indexeddb-storage-IndexedDBStorage.html +5 -0
  186. package/docs/api/module-storage_indexeddb-storage.IndexedDBStorage.html +3 -0
  187. package/docs/api/module-storage_indexeddb-storage.html +3 -0
  188. package/docs/api/module-storage_key-storage-simple.html +3 -0
  189. package/docs/api/module-storage_key-storage.html +4 -0
  190. package/docs/api/module-storage_memory-storage-MemoryStorage.html +5 -0
  191. package/docs/api/module-storage_memory-storage.MemoryStorage.html +3 -0
  192. package/docs/api/module-storage_memory-storage.html +3 -0
  193. package/docs/api/module-storage_migration-MigrationTool.html +6 -0
  194. package/docs/api/module-storage_migration.MigrationTool.html +3 -0
  195. package/docs/api/module-storage_migration.html +3 -0
  196. package/docs/api/module-storage_nostr-async.html +18 -0
  197. package/docs/api/module-storage_nostr-client-LRUCache.html +3 -0
  198. package/docs/api/module-storage_nostr-client-NostrClient.html +7 -0
  199. package/docs/api/module-storage_nostr-client.NostrClient.html +15 -0
  200. package/docs/api/module-storage_nostr-client.html +6 -0
  201. package/docs/api/module-storage_nostr-wrapper.html +3 -0
  202. package/docs/api/module-storage_outbox-queue-OutboxQueue.html +4 -0
  203. package/docs/api/module-storage_outbox-queue.OutboxQueue.html +3 -0
  204. package/docs/api/module-storage_outbox-queue.html +3 -0
  205. package/docs/api/module-storage_persistent-storage-PersistentStorage.html +3 -0
  206. package/docs/api/module-storage_persistent-storage.html +4 -0
  207. package/docs/api/module-storage_sync-service-SyncService.html +5 -0
  208. package/docs/api/module-storage_sync-service.SyncService.html +3 -0
  209. package/docs/api/module-storage_sync-service.html +3 -0
  210. package/docs/api/module-storage_unified-storage.html +3 -0
  211. package/docs/api/module-subscriptions_manager.SubscriptionRegistry.html +3 -0
  212. package/docs/api/module-subscriptions_manager.html +3 -0
  213. package/docs/api/schema_validator.js.html +113 -0
  214. package/docs/api/scripts/core.js +726 -0
  215. package/docs/api/scripts/core.min.js +23 -0
  216. package/docs/api/scripts/resize.js +90 -0
  217. package/docs/api/scripts/search.js +265 -0
  218. package/docs/api/scripts/search.min.js +6 -0
  219. package/docs/api/scripts/third-party/Apache-License-2.0.txt +202 -0
  220. package/docs/api/scripts/third-party/fuse.js +9 -0
  221. package/docs/api/scripts/third-party/hljs-line-num-original.js +369 -0
  222. package/docs/api/scripts/third-party/hljs-line-num.js +1 -0
  223. package/docs/api/scripts/third-party/hljs-original.js +5171 -0
  224. package/docs/api/scripts/third-party/hljs.js +1 -0
  225. package/docs/api/scripts/third-party/popper.js +5 -0
  226. package/docs/api/scripts/third-party/tippy.js +1 -0
  227. package/docs/api/scripts/third-party/tocbot.js +672 -0
  228. package/docs/api/scripts/third-party/tocbot.min.js +1 -0
  229. package/docs/api/spatial_h3-operations.js.html +129 -0
  230. package/docs/api/storage_backend-factory.js.html +133 -0
  231. package/docs/api/storage_backend-interface.js.html +164 -0
  232. package/docs/api/storage_backends_activitypub-backend.js.html +298 -0
  233. package/docs/api/storage_backends_activitypub_server.js.html +678 -0
  234. package/docs/api/storage_backends_gundb-backend.js.html +878 -0
  235. package/docs/api/storage_backends_nostr-backend.js.html +254 -0
  236. package/docs/api/storage_filesystem-storage-browser.js.html +83 -0
  237. package/docs/api/storage_filesystem-storage.js.html +207 -0
  238. package/docs/api/storage_global-tables.js.html +116 -0
  239. package/docs/api/storage_gun-async.js.html +344 -0
  240. package/docs/api/storage_gun-auth.js.html +376 -0
  241. package/docs/api/storage_gun-federation.js.html +788 -0
  242. package/docs/api/storage_gun-references.js.html +212 -0
  243. package/docs/api/storage_gun-schema.js.html +309 -0
  244. package/docs/api/storage_gun-wrapper.js.html +645 -0
  245. package/docs/api/storage_indexeddb-storage.js.html +224 -0
  246. package/docs/api/storage_key-storage-simple.js.html +102 -0
  247. package/docs/api/storage_key-storage.js.html +171 -0
  248. package/docs/api/storage_memory-storage.js.html +128 -0
  249. package/docs/api/storage_migration.js.html +354 -0
  250. package/docs/api/storage_nostr-async.js.html +1076 -0
  251. package/docs/api/storage_nostr-client.js.html +1598 -0
  252. package/docs/api/storage_nostr-wrapper.js.html +218 -0
  253. package/docs/api/storage_outbox-queue.js.html +248 -0
  254. package/docs/api/storage_persistent-storage.js.html +160 -0
  255. package/docs/api/storage_sync-service.js.html +201 -0
  256. package/docs/api/storage_unified-storage.js.html +157 -0
  257. package/docs/api/styles/clean-jsdoc-theme-base.css +1159 -0
  258. package/docs/api/styles/clean-jsdoc-theme-dark.css +412 -0
  259. package/docs/api/styles/clean-jsdoc-theme-light.css +482 -0
  260. package/docs/api/styles/clean-jsdoc-theme-scrollbar.css +30 -0
  261. package/docs/api/styles/clean-jsdoc-theme-without-scrollbar.min.css +1 -0
  262. package/docs/api/styles/clean-jsdoc-theme.min.css +1 -0
  263. package/docs/api/subscriptions_manager.js.html +162 -0
  264. package/docs/contracts/api-interface.md +793 -0
  265. package/docs/data-model.md +476 -0
  266. package/docs/gun-async-usage.md +338 -0
  267. package/docs/plan.md +349 -0
  268. package/docs/quickstart.md +674 -0
  269. package/docs/research.md +362 -0
  270. package/docs/spec.md +244 -0
  271. package/docs/storage-backends.md +326 -0
  272. package/docs/tasks.md +947 -0
  273. package/examples/demo.html +47 -0
  274. package/examples/holosphere-widget.js +1242 -0
  275. package/examples/widget-demo.html +274 -0
  276. package/examples/widget.html +703 -0
  277. package/jsdoc.json +26 -0
  278. package/package.json +25 -7
  279. package/src/ai/aggregation.js +13 -2
  280. package/src/ai/breakdown.js +12 -2
  281. package/src/ai/classifier.js +14 -3
  282. package/src/ai/council.js +22 -7
  283. package/src/ai/embeddings.js +37 -15
  284. package/src/ai/federation-ai.js +13 -2
  285. package/src/ai/h3-ai.js +14 -2
  286. package/src/ai/index.js +16 -7
  287. package/src/ai/json-ops.js +18 -5
  288. package/src/ai/llm-service.js +62 -31
  289. package/src/ai/nl-query.js +12 -2
  290. package/src/ai/relationships.js +13 -2
  291. package/src/ai/schema-extractor.js +24 -10
  292. package/src/ai/spatial.js +13 -2
  293. package/src/ai/tts.js +25 -8
  294. package/src/cdn-entry.js +22 -0
  295. package/src/content/social-protocols.js +34 -25
  296. package/src/contracts/abis/Appreciative.json +1280 -0
  297. package/src/contracts/abis/AppreciativeFactory.json +101 -0
  298. package/src/contracts/abis/Bundle.json +1438 -0
  299. package/src/contracts/abis/BundleFactory.json +106 -0
  300. package/src/contracts/abis/Holon.json +881 -0
  301. package/src/contracts/abis/Holons.json +330 -0
  302. package/src/contracts/abis/Managed.json +1262 -0
  303. package/src/contracts/abis/ManagedFactory.json +149 -0
  304. package/src/contracts/abis/Membrane.json +261 -0
  305. package/src/contracts/abis/Splitter.json +1624 -0
  306. package/src/contracts/abis/SplitterFactory.json +220 -0
  307. package/src/contracts/abis/TestToken.json +321 -0
  308. package/src/contracts/abis/Zoned.json +1461 -0
  309. package/src/contracts/abis/ZonedFactory.json +154 -0
  310. package/src/contracts/chain-manager.js +403 -0
  311. package/src/contracts/deployer.js +500 -0
  312. package/src/contracts/event-listener.js +539 -0
  313. package/src/contracts/holon-contracts.js +359 -0
  314. package/src/contracts/index.js +82 -0
  315. package/src/contracts/networks.js +229 -0
  316. package/src/contracts/operations.js +687 -0
  317. package/src/contracts/queries.js +638 -0
  318. package/src/core/holosphere.js +487 -6
  319. package/src/crypto/nostr-utils.js +303 -0
  320. package/src/crypto/secp256k1.js +7 -2
  321. package/src/federation/handshake.js +475 -0
  322. package/src/federation/hologram.js +117 -3
  323. package/src/hierarchical/upcast.js +40 -25
  324. package/src/index.js +1501 -1909
  325. package/src/lib/ai-methods.js +657 -0
  326. package/src/lib/contract-methods.js +442 -0
  327. package/src/lib/errors.js +53 -0
  328. package/src/lib/federation-methods.js +345 -0
  329. package/src/lib/index.js +30 -0
  330. package/src/schema/validator.js +22 -3
  331. package/src/spatial/h3-operations.js +19 -3
  332. package/src/storage/backend-factory.js +7 -2
  333. package/src/storage/backend-interface.js +21 -2
  334. package/src/storage/backends/activitypub/server.js +25 -3
  335. package/src/storage/backends/activitypub-backend.js +25 -2
  336. package/src/storage/backends/gundb-backend.js +692 -50
  337. package/src/storage/backends/nostr-backend.js +116 -1
  338. package/src/storage/filesystem-storage-browser.js +42 -2
  339. package/src/storage/filesystem-storage.js +72 -5
  340. package/src/storage/global-tables.js +35 -3
  341. package/src/storage/gun-async.js +75 -15
  342. package/src/storage/gun-auth.js +373 -0
  343. package/src/storage/gun-federation.js +785 -0
  344. package/src/storage/gun-references.js +209 -0
  345. package/src/storage/gun-schema.js +306 -0
  346. package/src/storage/gun-wrapper.js +475 -54
  347. package/src/storage/indexeddb-storage.js +112 -13
  348. package/src/storage/key-storage-simple.js +32 -9
  349. package/src/storage/key-storage.js +45 -13
  350. package/src/storage/memory-storage.js +68 -2
  351. package/src/storage/migration.js +20 -7
  352. package/src/storage/nostr-async.js +412 -122
  353. package/src/storage/nostr-client.js +749 -76
  354. package/src/storage/nostr-wrapper.js +6 -2
  355. package/src/storage/outbox-queue.js +55 -18
  356. package/src/storage/persistent-storage.js +62 -14
  357. package/src/storage/sync-service.js +51 -17
  358. package/src/storage/unified-storage.js +154 -0
  359. package/src/subscriptions/manager.js +34 -17
  360. package/types/index.d.ts +133 -0
  361. package/vite.config.cdn.js +60 -0
  362. package/tests/unit/ai/aggregation.test.js +0 -295
  363. package/tests/unit/ai/breakdown.test.js +0 -446
  364. package/tests/unit/ai/classifier.test.js +0 -294
  365. package/tests/unit/ai/council.test.js +0 -262
  366. package/tests/unit/ai/embeddings.test.js +0 -384
  367. package/tests/unit/ai/federation-ai.test.js +0 -344
  368. package/tests/unit/ai/h3-ai.test.js +0 -458
  369. package/tests/unit/ai/index.test.js +0 -304
  370. package/tests/unit/ai/json-ops.test.js +0 -307
  371. package/tests/unit/ai/llm-service.test.js +0 -390
  372. package/tests/unit/ai/nl-query.test.js +0 -383
  373. package/tests/unit/ai/relationships.test.js +0 -311
  374. package/tests/unit/ai/schema-extractor.test.js +0 -384
  375. package/tests/unit/ai/spatial.test.js +0 -279
  376. package/tests/unit/ai/tts.test.js +0 -279
  377. package/tests/unit/content.test.js +0 -332
  378. package/tests/unit/contract/core.test.js +0 -88
  379. package/tests/unit/contract/crypto.test.js +0 -198
  380. package/tests/unit/contract/data.test.js +0 -223
  381. package/tests/unit/contract/federation.test.js +0 -181
  382. package/tests/unit/contract/hierarchical.test.js +0 -113
  383. package/tests/unit/contract/schema.test.js +0 -114
  384. package/tests/unit/contract/social.test.js +0 -217
  385. package/tests/unit/contract/spatial.test.js +0 -110
  386. package/tests/unit/contract/subscriptions.test.js +0 -128
  387. package/tests/unit/contract/utils.test.js +0 -159
  388. package/tests/unit/core.test.js +0 -152
  389. package/tests/unit/crypto.test.js +0 -328
  390. package/tests/unit/federation.test.js +0 -234
  391. package/tests/unit/gun-async.test.js +0 -252
  392. package/tests/unit/hierarchical.test.js +0 -399
  393. package/tests/unit/integration/scenario-01-geographic-storage.test.js +0 -74
  394. package/tests/unit/integration/scenario-02-federation.test.js +0 -76
  395. package/tests/unit/integration/scenario-03-subscriptions.test.js +0 -102
  396. package/tests/unit/integration/scenario-04-validation.test.js +0 -129
  397. package/tests/unit/integration/scenario-05-hierarchy.test.js +0 -125
  398. package/tests/unit/integration/scenario-06-social.test.js +0 -135
  399. package/tests/unit/integration/scenario-07-persistence.test.js +0 -130
  400. package/tests/unit/integration/scenario-08-authorization.test.js +0 -161
  401. package/tests/unit/integration/scenario-09-cross-dimensional.test.js +0 -139
  402. package/tests/unit/integration/scenario-10-cross-holosphere-capabilities.test.js +0 -357
  403. package/tests/unit/integration/scenario-11-cross-holosphere-federation.test.js +0 -410
  404. package/tests/unit/integration/scenario-12-capability-federated-read.test.js +0 -719
  405. package/tests/unit/performance/benchmark.test.js +0 -85
  406. package/tests/unit/schema.test.js +0 -213
  407. package/tests/unit/spatial.test.js +0 -158
  408. package/tests/unit/storage.test.js +0 -195
  409. package/tests/unit/subscriptions.test.js +0 -328
  410. package/tests/unit/test-data-permanence-debug.js +0 -197
  411. package/tests/unit/test-data-permanence.js +0 -340
  412. package/tests/unit/test-key-persistence-fixed.js +0 -148
  413. package/tests/unit/test-key-persistence.js +0 -172
  414. package/tests/unit/test-relay-permanence.js +0 -376
  415. package/tests/unit/test-second-node.js +0 -95
  416. package/tests/unit/test-simple-write.js +0 -89
  417. /package/{cleanup-test-data.js → scripts/cleanup-test-data.js} +0 -0
  418. /package/{test-ai-real-api.js → scripts/test-ai-real-api.js} +0 -0
@@ -1,390 +0,0 @@
1
- import { describe, it, expect, beforeEach, vi } from 'vitest';
2
- import { LLMService } from '../../../src/ai/llm-service.js';
3
-
4
- // Mock OpenAI
5
- vi.mock('openai', () => ({
6
- default: vi.fn().mockImplementation(() => ({
7
- chat: {
8
- completions: {
9
- create: vi.fn()
10
- }
11
- }
12
- }))
13
- }));
14
-
15
- describe('Unit: LLMService', () => {
16
- let llm;
17
- let mockOpenAI;
18
-
19
- beforeEach(() => {
20
- vi.clearAllMocks();
21
- llm = new LLMService('test-api-key');
22
- mockOpenAI = llm.openai;
23
- });
24
-
25
- describe('Constructor', () => {
26
- it('should throw error if API key is not provided', () => {
27
- expect(() => new LLMService()).toThrow('OpenAI API key is required');
28
- expect(() => new LLMService('')).toThrow('OpenAI API key is required');
29
- expect(() => new LLMService(null)).toThrow('OpenAI API key is required');
30
- });
31
-
32
- it('should initialize with default options', () => {
33
- const service = new LLMService('test-key');
34
- expect(service.model).toBe('gpt-4o-mini');
35
- expect(service.maxTokens).toBe(2000);
36
- expect(service.temperature).toBe(0.7);
37
- });
38
-
39
- it('should accept custom options', () => {
40
- const service = new LLMService('test-key', {
41
- model: 'gpt-4',
42
- maxTokens: 1000,
43
- temperature: 0.5
44
- });
45
- expect(service.model).toBe('gpt-4');
46
- expect(service.maxTokens).toBe(1000);
47
- expect(service.temperature).toBe(0.5);
48
- });
49
- });
50
-
51
- describe('sendMessage', () => {
52
- it('should send message with system and user prompts', async () => {
53
- mockOpenAI.chat.completions.create.mockResolvedValue({
54
- choices: [{ message: { content: 'Test response' } }]
55
- });
56
-
57
- const result = await llm.sendMessage('You are helpful', 'Hello');
58
-
59
- expect(mockOpenAI.chat.completions.create).toHaveBeenCalledWith({
60
- model: 'gpt-4o-mini',
61
- messages: [
62
- { role: 'system', content: 'You are helpful' },
63
- { role: 'user', content: 'Hello' }
64
- ],
65
- max_tokens: 2000,
66
- temperature: 0.7
67
- });
68
- expect(result).toBe('Test response');
69
- });
70
-
71
- it('should allow option overrides', async () => {
72
- mockOpenAI.chat.completions.create.mockResolvedValue({
73
- choices: [{ message: { content: 'Response' } }]
74
- });
75
-
76
- await llm.sendMessage('System', 'User', {
77
- model: 'gpt-4',
78
- maxTokens: 500,
79
- temperature: 0.3
80
- });
81
-
82
- expect(mockOpenAI.chat.completions.create).toHaveBeenCalledWith(
83
- expect.objectContaining({
84
- model: 'gpt-4',
85
- max_tokens: 500,
86
- temperature: 0.3
87
- })
88
- );
89
- });
90
-
91
- it('should handle empty response', async () => {
92
- mockOpenAI.chat.completions.create.mockResolvedValue({
93
- choices: [{ message: { content: null } }]
94
- });
95
-
96
- const result = await llm.sendMessage('System', 'User');
97
- expect(result).toBe('');
98
- });
99
-
100
- it('should throw error on API failure', async () => {
101
- mockOpenAI.chat.completions.create.mockRejectedValue(new Error('API Error'));
102
-
103
- await expect(llm.sendMessage('System', 'User'))
104
- .rejects.toThrow('LLM request failed: API Error');
105
- });
106
-
107
- it('should trim whitespace from response', async () => {
108
- mockOpenAI.chat.completions.create.mockResolvedValue({
109
- choices: [{ message: { content: ' Response with spaces ' } }]
110
- });
111
-
112
- const result = await llm.sendMessage('System', 'User');
113
- expect(result).toBe('Response with spaces');
114
- });
115
- });
116
-
117
- describe('chat', () => {
118
- it('should send conversation messages', async () => {
119
- mockOpenAI.chat.completions.create.mockResolvedValue({
120
- choices: [{ message: { content: 'Chat response' } }]
121
- });
122
-
123
- const messages = [
124
- { role: 'system', content: 'You are helpful' },
125
- { role: 'user', content: 'Hello' },
126
- { role: 'assistant', content: 'Hi there!' },
127
- { role: 'user', content: 'How are you?' }
128
- ];
129
-
130
- const result = await llm.chat(messages);
131
-
132
- expect(mockOpenAI.chat.completions.create).toHaveBeenCalledWith(
133
- expect.objectContaining({ messages })
134
- );
135
- expect(result).toBe('Chat response');
136
- });
137
-
138
- it('should throw error on chat failure', async () => {
139
- mockOpenAI.chat.completions.create.mockRejectedValue(new Error('Chat failed'));
140
-
141
- await expect(llm.chat([]))
142
- .rejects.toThrow('LLM chat failed: Chat failed');
143
- });
144
- });
145
-
146
- describe('summarize', () => {
147
- it('should summarize text', async () => {
148
- mockOpenAI.chat.completions.create.mockResolvedValue({
149
- choices: [{ message: { content: 'Summary of text' } }]
150
- });
151
-
152
- const result = await llm.summarize('Long text to summarize');
153
-
154
- expect(mockOpenAI.chat.completions.create).toHaveBeenCalledWith(
155
- expect.objectContaining({
156
- temperature: 0.5
157
- })
158
- );
159
- expect(result).toBe('Summary of text');
160
- });
161
-
162
- it('should include maxLength in prompt when specified', async () => {
163
- mockOpenAI.chat.completions.create.mockResolvedValue({
164
- choices: [{ message: { content: 'Short summary' } }]
165
- });
166
-
167
- await llm.summarize('Text', { maxLength: 50 });
168
-
169
- const call = mockOpenAI.chat.completions.create.mock.calls[0][0];
170
- expect(call.messages[0].content).toContain('50 words');
171
- });
172
-
173
- it('should include style in prompt when specified', async () => {
174
- mockOpenAI.chat.completions.create.mockResolvedValue({
175
- choices: [{ message: { content: 'Bullet summary' } }]
176
- });
177
-
178
- await llm.summarize('Text', { style: 'bullet points' });
179
-
180
- const call = mockOpenAI.chat.completions.create.mock.calls[0][0];
181
- expect(call.messages[0].content).toContain('bullet points');
182
- });
183
- });
184
-
185
- describe('analyze', () => {
186
- it('should analyze text from specified perspective', async () => {
187
- mockOpenAI.chat.completions.create.mockResolvedValue({
188
- choices: [{ message: { content: 'Sentiment analysis result' } }]
189
- });
190
-
191
- const result = await llm.analyze('Happy text', 'sentiment');
192
-
193
- const call = mockOpenAI.chat.completions.create.mock.calls[0][0];
194
- expect(call.messages[0].content).toContain('sentiment');
195
- expect(call.temperature).toBe(0.3);
196
- expect(result).toBe('Sentiment analysis result');
197
- });
198
- });
199
-
200
- describe('extractKeywords', () => {
201
- it('should extract keywords as JSON array', async () => {
202
- mockOpenAI.chat.completions.create.mockResolvedValue({
203
- choices: [{ message: { content: '["keyword1", "keyword2", "keyword3"]' } }]
204
- });
205
-
206
- const result = await llm.extractKeywords('Some text about keywords');
207
-
208
- expect(result).toEqual(['keyword1', 'keyword2', 'keyword3']);
209
- });
210
-
211
- it('should handle non-JSON response by extracting array', async () => {
212
- mockOpenAI.chat.completions.create.mockResolvedValue({
213
- choices: [{ message: { content: 'Here are keywords: ["a", "b"]' } }]
214
- });
215
-
216
- const result = await llm.extractKeywords('Text');
217
- expect(result).toEqual(['a', 'b']);
218
- });
219
-
220
- it('should fall back to comma splitting if JSON fails', async () => {
221
- mockOpenAI.chat.completions.create.mockResolvedValue({
222
- choices: [{ message: { content: 'keyword1, keyword2, keyword3' } }]
223
- });
224
-
225
- const result = await llm.extractKeywords('Text');
226
- expect(result).toEqual(['keyword1', 'keyword2', 'keyword3']);
227
- });
228
-
229
- it('should respect maxKeywords parameter', async () => {
230
- mockOpenAI.chat.completions.create.mockResolvedValue({
231
- choices: [{ message: { content: '["a", "b", "c"]' } }]
232
- });
233
-
234
- await llm.extractKeywords('Text', 5);
235
-
236
- const call = mockOpenAI.chat.completions.create.mock.calls[0][0];
237
- expect(call.messages[0].content).toContain('5');
238
- });
239
- });
240
-
241
- describe('categorize', () => {
242
- it('should categorize text into one of the categories', async () => {
243
- mockOpenAI.chat.completions.create.mockResolvedValue({
244
- choices: [{ message: { content: '{"category": "sports", "confidence": 0.9, "reasoning": "Text is about sports"}' } }]
245
- });
246
-
247
- const result = await llm.categorize('Football game', ['sports', 'politics', 'tech']);
248
-
249
- expect(result).toEqual({
250
- category: 'sports',
251
- confidence: 0.9,
252
- reasoning: 'Text is about sports'
253
- });
254
- });
255
-
256
- it('should handle non-JSON response', async () => {
257
- mockOpenAI.chat.completions.create.mockResolvedValue({
258
- choices: [{ message: { content: 'The category is {"category": "tech", "confidence": 0.8, "reasoning": "about tech"}' } }]
259
- });
260
-
261
- const result = await llm.categorize('AI text', ['tech']);
262
- expect(result.category).toBe('tech');
263
- });
264
-
265
- it('should fall back to first category on parse failure', async () => {
266
- mockOpenAI.chat.completions.create.mockResolvedValue({
267
- choices: [{ message: { content: 'Unable to parse' } }]
268
- });
269
-
270
- const result = await llm.categorize('Text', ['first', 'second']);
271
- expect(result.category).toBe('first');
272
- expect(result.confidence).toBe(0.5);
273
- });
274
- });
275
-
276
- describe('translate', () => {
277
- it('should translate text to target language', async () => {
278
- mockOpenAI.chat.completions.create.mockResolvedValue({
279
- choices: [{ message: { content: 'Bonjour le monde' } }]
280
- });
281
-
282
- const result = await llm.translate('Hello world', 'French');
283
-
284
- const call = mockOpenAI.chat.completions.create.mock.calls[0][0];
285
- expect(call.messages[0].content).toContain('French');
286
- expect(result).toBe('Bonjour le monde');
287
- });
288
- });
289
-
290
- describe('generateQuestions', () => {
291
- it('should generate questions as JSON array', async () => {
292
- mockOpenAI.chat.completions.create.mockResolvedValue({
293
- choices: [{ message: { content: '["Question 1?", "Question 2?"]' } }]
294
- });
295
-
296
- const result = await llm.generateQuestions('Some content');
297
- expect(result).toEqual(['Question 1?', 'Question 2?']);
298
- });
299
-
300
- it('should handle non-JSON by extracting array', async () => {
301
- mockOpenAI.chat.completions.create.mockResolvedValue({
302
- choices: [{ message: { content: 'Questions: ["Q1?", "Q2?"]' } }]
303
- });
304
-
305
- const result = await llm.generateQuestions('Content');
306
- expect(result).toEqual(['Q1?', 'Q2?']);
307
- });
308
-
309
- it('should fall back to line splitting for questions', async () => {
310
- mockOpenAI.chat.completions.create.mockResolvedValue({
311
- choices: [{ message: { content: 'What is this?\nWhy does it matter?' } }]
312
- });
313
-
314
- const result = await llm.generateQuestions('Content');
315
- expect(result).toContain('What is this?');
316
- expect(result).toContain('Why does it matter?');
317
- });
318
-
319
- it('should respect count parameter', async () => {
320
- mockOpenAI.chat.completions.create.mockResolvedValue({
321
- choices: [{ message: { content: '["Q1?", "Q2?", "Q3?"]' } }]
322
- });
323
-
324
- await llm.generateQuestions('Content', 3);
325
-
326
- const call = mockOpenAI.chat.completions.create.mock.calls[0][0];
327
- expect(call.messages[0].content).toContain('3');
328
- });
329
- });
330
-
331
- describe('getJSON', () => {
332
- it('should return parsed JSON from response', async () => {
333
- mockOpenAI.chat.completions.create.mockResolvedValue({
334
- choices: [{ message: { content: '{"key": "value", "number": 42}' } }]
335
- });
336
-
337
- const result = await llm.getJSON('System prompt', 'User message');
338
- expect(result).toEqual({ key: 'value', number: 42 });
339
- });
340
-
341
- it('should extract JSON from non-pure JSON response', async () => {
342
- mockOpenAI.chat.completions.create.mockResolvedValue({
343
- choices: [{ message: { content: 'Here is the result: {"data": [1, 2, 3]}' } }]
344
- });
345
-
346
- const result = await llm.getJSON('System', 'User');
347
- expect(result).toEqual({ data: [1, 2, 3] });
348
- });
349
-
350
- it('should extract JSON array from response', async () => {
351
- mockOpenAI.chat.completions.create.mockResolvedValue({
352
- choices: [{ message: { content: 'Result: [1, 2, 3]' } }]
353
- });
354
-
355
- const result = await llm.getJSON('System', 'User');
356
- expect(result).toEqual([1, 2, 3]);
357
- });
358
-
359
- it('should throw error on invalid JSON', async () => {
360
- mockOpenAI.chat.completions.create.mockResolvedValue({
361
- choices: [{ message: { content: 'Not valid JSON at all' } }]
362
- });
363
-
364
- await expect(llm.getJSON('System', 'User'))
365
- .rejects.toThrow('Failed to parse JSON response');
366
- });
367
-
368
- it('should use low temperature by default', async () => {
369
- mockOpenAI.chat.completions.create.mockResolvedValue({
370
- choices: [{ message: { content: '{}' } }]
371
- });
372
-
373
- await llm.getJSON('System', 'User');
374
-
375
- const call = mockOpenAI.chat.completions.create.mock.calls[0][0];
376
- expect(call.temperature).toBe(0.2);
377
- });
378
-
379
- it('should append JSON instruction to system prompt', async () => {
380
- mockOpenAI.chat.completions.create.mockResolvedValue({
381
- choices: [{ message: { content: '{}' } }]
382
- });
383
-
384
- await llm.getJSON('Original prompt', 'User');
385
-
386
- const call = mockOpenAI.chat.completions.create.mock.calls[0][0];
387
- expect(call.messages[0].content).toContain('Return ONLY valid JSON');
388
- });
389
- });
390
- });