@coasys/ad4m 0.12.1-dev → 0.13.0-postmessage-ws-proxy.0

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 (388) hide show
  1. package/README.md +2 -25
  2. package/jest-setup.ts +1 -1
  3. package/lib/index.cjs +5097 -11841
  4. package/lib/index.js +5289 -12104
  5. package/lib/src/Ad4mClient.d.ts +9 -3
  6. package/lib/src/Ad4mClient.js +40 -13
  7. package/lib/src/Literal.js +6 -5
  8. package/lib/src/agent/Agent.js +26 -272
  9. package/lib/src/agent/AgentClient.d.ts +33 -21
  10. package/lib/src/agent/AgentClient.js +180 -374
  11. package/lib/src/agent/AgentStatus.js +2 -37
  12. package/lib/src/ai/AIClient.d.ts +12 -4
  13. package/lib/src/ai/AIClient.js +81 -285
  14. package/lib/src/ai/AITypes.d.ts +55 -0
  15. package/lib/src/ai/AITypes.js +18 -0
  16. package/lib/src/ai/Tasks.js +10 -133
  17. package/lib/src/apiClient.d.ts +53 -0
  18. package/lib/src/apiClient.js +234 -0
  19. package/lib/src/cache/PersistentCache.d.ts +40 -0
  20. package/lib/src/cache/PersistentCache.js +139 -0
  21. package/lib/src/expression/Expression.d.ts +1 -1
  22. package/lib/src/expression/Expression.js +13 -122
  23. package/lib/src/expression/ExpressionClient.d.ts +11 -3
  24. package/lib/src/expression/ExpressionClient.js +120 -75
  25. package/lib/src/expression/ExpressionRef.js +4 -27
  26. package/lib/src/generated/api/AIModelLoadingStatus.d.ts +7 -0
  27. package/lib/src/generated/api/AIModelLoadingStatus.js +2 -0
  28. package/lib/src/generated/api/AddLinkExpressionRequest.d.ts +6 -0
  29. package/lib/src/generated/api/AddLinkExpressionRequest.js +1 -0
  30. package/lib/src/generated/api/AddLinkRequest.d.ts +6 -0
  31. package/lib/src/generated/api/AddLinkRequest.js +1 -0
  32. package/lib/src/generated/api/AddLinksBulkRequest.d.ts +6 -0
  33. package/lib/src/generated/api/AddLinksBulkRequest.js +1 -0
  34. package/lib/src/generated/api/AddSdnaRequest.d.ts +6 -0
  35. package/lib/src/generated/api/AddSdnaRequest.js +2 -0
  36. package/lib/src/generated/api/ApplyTemplateRequest.d.ts +4 -0
  37. package/lib/src/generated/api/ApplyTemplateRequest.js +2 -0
  38. package/lib/src/generated/api/AuthInfoInput.d.ts +10 -0
  39. package/lib/src/generated/api/AuthInfoInput.js +1 -0
  40. package/lib/src/generated/api/CapabilityInput.d.ts +5 -0
  41. package/lib/src/generated/api/CapabilityInput.js +1 -0
  42. package/lib/src/generated/api/CommitBatchRequest.d.ts +3 -0
  43. package/lib/src/generated/api/CommitBatchRequest.js +2 -0
  44. package/lib/src/generated/api/ComputeLogEntry.d.ts +9 -0
  45. package/lib/src/generated/api/ComputeLogEntry.js +2 -0
  46. package/lib/src/generated/api/CreateExpressionRequest.d.ts +4 -0
  47. package/lib/src/generated/api/CreateExpressionRequest.js +2 -0
  48. package/lib/src/generated/api/CreatePerspectiveRequest.d.ts +3 -0
  49. package/lib/src/generated/api/CreatePerspectiveRequest.js +2 -0
  50. package/lib/src/generated/api/CreateSubjectRequest.d.ts +6 -0
  51. package/lib/src/generated/api/CreateSubjectRequest.js +2 -0
  52. package/lib/src/generated/api/EmbedRequest.d.ts +4 -0
  53. package/lib/src/generated/api/EmbedRequest.js +2 -0
  54. package/lib/src/generated/api/EntanglementProofInput.d.ts +6 -0
  55. package/lib/src/generated/api/EntanglementProofInput.js +2 -0
  56. package/lib/src/generated/api/ExecuteCommandsRequest.d.ts +4 -0
  57. package/lib/src/generated/api/ExecuteCommandsRequest.js +2 -0
  58. package/lib/src/generated/api/ExportRequest.d.ts +5 -0
  59. package/lib/src/generated/api/ExportRequest.js +2 -0
  60. package/lib/src/generated/api/ExpressionManyRequest.d.ts +3 -0
  61. package/lib/src/generated/api/ExpressionManyRequest.js +2 -0
  62. package/lib/src/generated/api/ExpressionProof.d.ts +4 -0
  63. package/lib/src/generated/api/ExpressionProof.js +2 -0
  64. package/lib/src/generated/api/ExpressionProofInput.d.ts +6 -0
  65. package/lib/src/generated/api/ExpressionProofInput.js +2 -0
  66. package/lib/src/generated/api/FriendSendMessageRequest.d.ts +3 -0
  67. package/lib/src/generated/api/FriendSendMessageRequest.js +2 -0
  68. package/lib/src/generated/api/FriendsListRequest.d.ts +3 -0
  69. package/lib/src/generated/api/FriendsListRequest.js +2 -0
  70. package/lib/src/generated/api/GenerateAgentRequest.d.ts +3 -0
  71. package/lib/src/generated/api/GenerateAgentRequest.js +2 -0
  72. package/lib/src/generated/api/GenerateJwtRequest.d.ts +4 -0
  73. package/lib/src/generated/api/GenerateJwtRequest.js +2 -0
  74. package/lib/src/generated/api/GetSubjectDataRequest.d.ts +4 -0
  75. package/lib/src/generated/api/GetSubjectDataRequest.js +2 -0
  76. package/lib/src/generated/api/ImportAgentRequest.d.ts +6 -0
  77. package/lib/src/generated/api/ImportAgentRequest.js +2 -0
  78. package/lib/src/generated/api/ImportRequest.d.ts +4 -0
  79. package/lib/src/generated/api/ImportRequest.js +2 -0
  80. package/lib/src/generated/api/JoinNeighbourhoodRequest.d.ts +3 -0
  81. package/lib/src/generated/api/JoinNeighbourhoodRequest.js +2 -0
  82. package/lib/src/generated/api/LanguageMetaInput.d.ts +6 -0
  83. package/lib/src/generated/api/LanguageMetaInput.js +2 -0
  84. package/lib/src/generated/api/Link.d.ts +5 -0
  85. package/lib/src/generated/api/Link.js +2 -0
  86. package/lib/src/generated/api/LinkExpression.d.ts +10 -0
  87. package/lib/src/generated/api/LinkExpression.js +1 -0
  88. package/lib/src/generated/api/LinkExpressionInput.d.ts +10 -0
  89. package/lib/src/generated/api/LinkExpressionInput.js +1 -0
  90. package/lib/src/generated/api/LinkInput.d.ts +5 -0
  91. package/lib/src/generated/api/LinkInput.js +2 -0
  92. package/lib/src/generated/api/LinkLanguageTemplatesRequest.d.ts +3 -0
  93. package/lib/src/generated/api/LinkLanguageTemplatesRequest.js +2 -0
  94. package/lib/src/generated/api/LinkMutations.d.ts +6 -0
  95. package/lib/src/generated/api/LinkMutations.js +1 -0
  96. package/lib/src/generated/api/LinkStatus.d.ts +1 -0
  97. package/lib/src/generated/api/LinkStatus.js +2 -0
  98. package/lib/src/generated/api/LockAgentRequest.d.ts +3 -0
  99. package/lib/src/generated/api/LockAgentRequest.js +2 -0
  100. package/lib/src/generated/api/ModelType.d.ts +1 -0
  101. package/lib/src/generated/api/ModelType.js +2 -0
  102. package/lib/src/generated/api/NotificationInput.d.ts +10 -0
  103. package/lib/src/generated/api/NotificationInput.js +2 -0
  104. package/lib/src/generated/api/OpenLinkRequest.d.ts +3 -0
  105. package/lib/src/generated/api/OpenLinkRequest.js +2 -0
  106. package/lib/src/generated/api/PermitCapabilityRequest.d.ts +3 -0
  107. package/lib/src/generated/api/PermitCapabilityRequest.js +2 -0
  108. package/lib/src/generated/api/PerspectiveInput.d.ts +4 -0
  109. package/lib/src/generated/api/PerspectiveInput.js +1 -0
  110. package/lib/src/generated/api/PromptRequest.d.ts +4 -0
  111. package/lib/src/generated/api/PromptRequest.js +2 -0
  112. package/lib/src/generated/api/PublishLanguageRequest.d.ts +5 -0
  113. package/lib/src/generated/api/PublishLanguageRequest.js +1 -0
  114. package/lib/src/generated/api/PublishNeighbourhoodRequest.d.ts +6 -0
  115. package/lib/src/generated/api/PublishNeighbourhoodRequest.js +1 -0
  116. package/lib/src/generated/api/QueryRequest.d.ts +7 -0
  117. package/lib/src/generated/api/QueryRequest.js +2 -0
  118. package/lib/src/generated/api/RemoveLinkRequest.d.ts +5 -0
  119. package/lib/src/generated/api/RemoveLinkRequest.js +1 -0
  120. package/lib/src/generated/api/RemoveLinksBulkRequest.d.ts +5 -0
  121. package/lib/src/generated/api/RemoveLinksBulkRequest.js +1 -0
  122. package/lib/src/generated/api/ResourceInput.d.ts +4 -0
  123. package/lib/src/generated/api/ResourceInput.js +2 -0
  124. package/lib/src/generated/api/SetDefaultModelRequest.d.ts +4 -0
  125. package/lib/src/generated/api/SetDefaultModelRequest.js +1 -0
  126. package/lib/src/generated/api/SetFreeHostingEnabledRequest.d.ts +3 -0
  127. package/lib/src/generated/api/SetFreeHostingEnabledRequest.js +2 -0
  128. package/lib/src/generated/api/SetMultiUserRequest.d.ts +3 -0
  129. package/lib/src/generated/api/SetMultiUserRequest.js +2 -0
  130. package/lib/src/generated/api/SetStatusRequest.d.ts +3 -0
  131. package/lib/src/generated/api/SetStatusRequest.js +2 -0
  132. package/lib/src/generated/api/SignMessageRequest.d.ts +3 -0
  133. package/lib/src/generated/api/SignMessageRequest.js +2 -0
  134. package/lib/src/generated/api/TrustedAgentsRequest.d.ts +3 -0
  135. package/lib/src/generated/api/TrustedAgentsRequest.js +2 -0
  136. package/lib/src/generated/api/UnlockAgentRequest.d.ts +4 -0
  137. package/lib/src/generated/api/UnlockAgentRequest.js +2 -0
  138. package/lib/src/generated/api/UpdateLinkRequest.d.ts +7 -0
  139. package/lib/src/generated/api/UpdateLinkRequest.js +1 -0
  140. package/lib/src/generated/api/UpdatePerspectiveRequest.d.ts +3 -0
  141. package/lib/src/generated/api/UpdatePerspectiveRequest.js +2 -0
  142. package/lib/src/generated/api/UserStatistics.d.ts +9 -0
  143. package/lib/src/generated/api/UserStatistics.js +2 -0
  144. package/lib/src/generated/api/VerificationRequestResult.d.ts +6 -0
  145. package/lib/src/generated/api/VerificationRequestResult.js +2 -0
  146. package/lib/src/generated/api/VerifySignatureRequest.d.ts +5 -0
  147. package/lib/src/generated/api/VerifySignatureRequest.js +2 -0
  148. package/lib/src/generated/api/WriteSettingsRequest.d.ts +3 -0
  149. package/lib/src/generated/api/WriteSettingsRequest.js +2 -0
  150. package/lib/src/generated/api/index.d.ts +42 -0
  151. package/lib/src/generated/api/index.js +7 -0
  152. package/lib/src/index.d.ts +7 -2
  153. package/lib/src/index.js +7 -2
  154. package/lib/src/jestSetup.d.ts +0 -1
  155. package/lib/src/jestSetup.js +1 -1
  156. package/lib/src/language/Icon.js +2 -21
  157. package/lib/src/language/Language.d.ts +26 -176
  158. package/lib/src/language/Language.js +32 -72
  159. package/lib/src/language/LanguageClient.d.ts +2 -2
  160. package/lib/src/language/LanguageClient.js +15 -105
  161. package/lib/src/language/LanguageHandle.js +2 -41
  162. package/lib/src/language/LanguageMeta.js +4 -75
  163. package/lib/src/language/LanguageRef.js +2 -25
  164. package/lib/src/links/Links.js +14 -111
  165. package/lib/src/model/Ad4mModel.d.ts +150 -62
  166. package/lib/src/model/Ad4mModel.js +689 -417
  167. package/lib/src/model/Ad4mModel.test.js +1434 -688
  168. package/lib/src/model/ModelQueryBuilder.d.ts +59 -38
  169. package/lib/src/model/ModelQueryBuilder.js +317 -153
  170. package/lib/src/model/Subject.js +6 -6
  171. package/lib/src/model/decorators.d.ts +36 -8
  172. package/lib/src/model/decorators.js +41 -14
  173. package/lib/src/model/hydration-batch.d.ts +34 -0
  174. package/lib/src/model/hydration-batch.js +147 -0
  175. package/lib/src/model/hydration-batching.test.d.ts +7 -0
  176. package/lib/src/model/hydration-batching.test.js +456 -0
  177. package/lib/src/model/hydration.d.ts +3 -92
  178. package/lib/src/model/hydration.js +3 -691
  179. package/lib/src/model/index.d.ts +3 -4
  180. package/lib/src/model/index.js +3 -4
  181. package/lib/src/model/json-schema.js +2 -2
  182. package/lib/src/model/model-manifest.d.ts +41 -0
  183. package/lib/src/model/model-manifest.js +11 -0
  184. package/lib/src/model/query-cache.d.ts +30 -0
  185. package/lib/src/model/query-cache.js +66 -0
  186. package/lib/src/model/query-cache.test.d.ts +1 -0
  187. package/lib/src/model/query-cache.test.js +43 -0
  188. package/lib/src/model/query-common.d.ts +1 -1
  189. package/lib/src/model/query-common.js +1 -1
  190. package/lib/src/model/query-sparql-batch.d.ts +17 -0
  191. package/lib/src/model/query-sparql-batch.js +260 -0
  192. package/lib/src/model/query-sparql.d.ts +51 -0
  193. package/lib/src/model/query-sparql.js +466 -0
  194. package/lib/src/model/query-sparql.test.d.ts +1 -0
  195. package/lib/src/model/query-sparql.test.js +312 -0
  196. package/lib/src/model/{surreal-utils.d.ts → query-utils.d.ts} +13 -9
  197. package/lib/src/model/query-utils.js +189 -0
  198. package/lib/src/model/relation-filtering.test.js +15 -15
  199. package/lib/src/model/sdna.js +1 -1
  200. package/lib/src/model/shacl-gen.js +46 -18
  201. package/lib/src/model/subscription-delta.test.d.ts +24 -0
  202. package/lib/src/model/subscription-delta.test.js +180 -0
  203. package/lib/src/model/subscription-pool.d.ts +39 -0
  204. package/lib/src/model/subscription-pool.js +165 -0
  205. package/lib/src/model/types.d.ts +60 -5
  206. package/lib/src/model/types.js +5 -2
  207. package/lib/src/neighbourhood/Neighbourhood.js +4 -32
  208. package/lib/src/neighbourhood/NeighbourhoodClient.d.ts +3 -3
  209. package/lib/src/neighbourhood/NeighbourhoodClient.js +40 -203
  210. package/lib/src/perspectives/LinkQuery.js +2 -42
  211. package/lib/src/perspectives/Perspective.d.ts +1 -1
  212. package/lib/src/perspectives/Perspective.js +10 -52
  213. package/lib/src/perspectives/PerspectiveClient.d.ts +22 -32
  214. package/lib/src/perspectives/PerspectiveClient.js +189 -454
  215. package/lib/src/perspectives/PerspectiveClient.test.d.ts +1 -0
  216. package/lib/src/perspectives/PerspectiveClient.test.js +224 -0
  217. package/lib/src/perspectives/PerspectiveDiff.js +4 -31
  218. package/lib/src/perspectives/PerspectiveHandle.js +3 -43
  219. package/lib/src/perspectives/PerspectiveProxy.d.ts +156 -78
  220. package/lib/src/perspectives/PerspectiveProxy.js +474 -389
  221. package/lib/src/perspectives/PerspectiveResolver.d.ts +0 -1
  222. package/lib/src/perspectives/PerspectiveResolver.js +0 -11
  223. package/lib/src/perspectives/WakerSubscriptionManager.d.ts +3 -3
  224. package/lib/src/perspectives/WakerSubscriptionManager.js +12 -12
  225. package/lib/src/runtime/RuntimeClient.d.ts +8 -6
  226. package/lib/src/runtime/RuntimeClient.js +97 -454
  227. package/lib/src/runtime/RuntimeResolver.d.ts +14 -0
  228. package/lib/src/runtime/RuntimeResolver.js +84 -0
  229. package/lib/src/runtime/RuntimeTypes.d.ts +101 -0
  230. package/lib/src/runtime/RuntimeTypes.js +45 -0
  231. package/lib/src/schema.gql +14 -1
  232. package/lib/src/shacl/SHACLFlow.d.ts +1 -1
  233. package/lib/src/shacl/SHACLFlow.js +9 -9
  234. package/lib/src/shacl/SHACLShape.d.ts +8 -1
  235. package/lib/src/shacl/SHACLShape.js +57 -38
  236. package/lib/src/shacl/SHACLShape.test.js +82 -0
  237. package/lib/src/typeDefs.js +3 -615
  238. package/lib/src/utils.d.ts +6 -6
  239. package/lib/src/utils.js +6 -6
  240. package/package.json +6 -18
  241. package/rollup.config.js +0 -7
  242. package/src/Ad4mClient.test.ts +1192 -1288
  243. package/src/Ad4mClient.ts +46 -15
  244. package/src/Literal.test.ts +10 -5
  245. package/src/Literal.ts +6 -5
  246. package/src/agent/Agent.ts +0 -99
  247. package/src/agent/AgentClient.ts +238 -467
  248. package/src/agent/AgentStatus.ts +0 -12
  249. package/src/ai/AIClient.ts +96 -296
  250. package/src/ai/AITypes.ts +66 -0
  251. package/src/ai/Tasks.ts +0 -52
  252. package/src/apiClient.ts +287 -0
  253. package/src/cache/PersistentCache.ts +145 -0
  254. package/src/cache/cache.test.ts +713 -0
  255. package/src/expression/Expression.ts +3 -43
  256. package/src/expression/ExpressionClient.ts +148 -77
  257. package/src/expression/ExpressionRef.ts +2 -8
  258. package/src/generated/api/AIModelLoadingStatus.ts +3 -0
  259. package/src/generated/api/AddLinkExpressionRequest.ts +4 -0
  260. package/src/generated/api/AddLinkRequest.ts +4 -0
  261. package/src/generated/api/AddLinksBulkRequest.ts +4 -0
  262. package/src/generated/api/AddSdnaRequest.ts +3 -0
  263. package/src/generated/api/ApplyTemplateRequest.ts +3 -0
  264. package/src/generated/api/AuthInfoInput.ts +4 -0
  265. package/src/generated/api/CapabilityInput.ts +4 -0
  266. package/src/generated/api/CommitBatchRequest.ts +3 -0
  267. package/src/generated/api/ComputeLogEntry.ts +3 -0
  268. package/src/generated/api/CreateExpressionRequest.ts +3 -0
  269. package/src/generated/api/CreatePerspectiveRequest.ts +3 -0
  270. package/src/generated/api/CreateSubjectRequest.ts +3 -0
  271. package/src/generated/api/EmbedRequest.ts +3 -0
  272. package/src/generated/api/EntanglementProofInput.ts +3 -0
  273. package/src/generated/api/ExecuteCommandsRequest.ts +3 -0
  274. package/src/generated/api/ExportRequest.ts +3 -0
  275. package/src/generated/api/ExpressionManyRequest.ts +3 -0
  276. package/src/generated/api/ExpressionProof.ts +3 -0
  277. package/src/generated/api/ExpressionProofInput.ts +3 -0
  278. package/src/generated/api/FriendSendMessageRequest.ts +3 -0
  279. package/src/generated/api/FriendsListRequest.ts +3 -0
  280. package/src/generated/api/GenerateAgentRequest.ts +3 -0
  281. package/src/generated/api/GenerateJwtRequest.ts +3 -0
  282. package/src/generated/api/GetSubjectDataRequest.ts +3 -0
  283. package/src/generated/api/ImportAgentRequest.ts +3 -0
  284. package/src/generated/api/ImportRequest.ts +3 -0
  285. package/src/generated/api/JoinNeighbourhoodRequest.ts +3 -0
  286. package/src/generated/api/LanguageMetaInput.ts +3 -0
  287. package/src/generated/api/Link.ts +3 -0
  288. package/src/generated/api/LinkExpression.ts +6 -0
  289. package/src/generated/api/LinkExpressionInput.ts +6 -0
  290. package/src/generated/api/LinkInput.ts +3 -0
  291. package/src/generated/api/LinkLanguageTemplatesRequest.ts +3 -0
  292. package/src/generated/api/LinkMutations.ts +5 -0
  293. package/src/generated/api/LinkStatus.ts +3 -0
  294. package/src/generated/api/LockAgentRequest.ts +3 -0
  295. package/src/generated/api/ModelType.ts +3 -0
  296. package/src/generated/api/NotificationInput.ts +3 -0
  297. package/src/generated/api/OpenLinkRequest.ts +3 -0
  298. package/src/generated/api/PermitCapabilityRequest.ts +3 -0
  299. package/src/generated/api/PerspectiveInput.ts +4 -0
  300. package/src/generated/api/PromptRequest.ts +3 -0
  301. package/src/generated/api/PublishLanguageRequest.ts +4 -0
  302. package/src/generated/api/PublishNeighbourhoodRequest.ts +4 -0
  303. package/src/generated/api/QueryRequest.ts +6 -0
  304. package/src/generated/api/RemoveLinkRequest.ts +4 -0
  305. package/src/generated/api/RemoveLinksBulkRequest.ts +4 -0
  306. package/src/generated/api/ResourceInput.ts +3 -0
  307. package/src/generated/api/SetDefaultModelRequest.ts +4 -0
  308. package/src/generated/api/SetFreeHostingEnabledRequest.ts +3 -0
  309. package/src/generated/api/SetMultiUserRequest.ts +3 -0
  310. package/src/generated/api/SetStatusRequest.ts +3 -0
  311. package/src/generated/api/SignMessageRequest.ts +3 -0
  312. package/src/generated/api/TrustedAgentsRequest.ts +3 -0
  313. package/src/generated/api/UnlockAgentRequest.ts +3 -0
  314. package/src/generated/api/UpdateLinkRequest.ts +5 -0
  315. package/src/generated/api/UpdatePerspectiveRequest.ts +3 -0
  316. package/src/generated/api/UserStatistics.ts +3 -0
  317. package/src/generated/api/VerificationRequestResult.ts +3 -0
  318. package/src/generated/api/VerifySignatureRequest.ts +3 -0
  319. package/src/generated/api/WriteSettingsRequest.ts +3 -0
  320. package/src/generated/api/index.ts +49 -0
  321. package/src/index.ts +7 -2
  322. package/src/jestSetup.ts +1 -1
  323. package/src/language/Icon.ts +0 -4
  324. package/src/language/Language.ts +51 -248
  325. package/src/language/LanguageClient.ts +21 -132
  326. package/src/language/LanguageHandle.ts +0 -14
  327. package/src/language/LanguageMeta.ts +0 -29
  328. package/src/language/LanguageRef.ts +0 -7
  329. package/src/links/Links.ts +0 -37
  330. package/src/model/Ad4mModel.test.ts +1690 -777
  331. package/src/model/Ad4mModel.ts +749 -477
  332. package/src/model/ModelQueryBuilder.ts +356 -171
  333. package/src/model/decorators.ts +71 -22
  334. package/src/model/hydration.ts +3 -772
  335. package/src/model/index.ts +3 -4
  336. package/src/model/json-schema.ts +2 -2
  337. package/src/model/query-cache.test.ts +54 -0
  338. package/src/model/query-cache.ts +79 -0
  339. package/src/model/query-common.ts +1 -1
  340. package/src/model/query-sparql.test.ts +376 -0
  341. package/src/model/query-sparql.ts +504 -0
  342. package/src/model/query-utils.ts +209 -0
  343. package/src/model/relation-filtering.test.ts +15 -15
  344. package/src/model/sdna.ts +1 -1
  345. package/src/model/shacl-gen.ts +47 -17
  346. package/src/model/types.ts +65 -5
  347. package/src/neighbourhood/Neighbourhood.ts +0 -9
  348. package/src/neighbourhood/NeighbourhoodClient.ts +42 -207
  349. package/src/neighbourhood/NeighbourhoodProxy.test.ts +34 -36
  350. package/src/perspectives/LinkQuery.ts +0 -15
  351. package/src/perspectives/Perspective.ts +1 -12
  352. package/src/perspectives/PerspectiveClient.test.ts +262 -0
  353. package/src/perspectives/PerspectiveClient.ts +254 -468
  354. package/src/perspectives/PerspectiveDiff.ts +0 -8
  355. package/src/perspectives/PerspectiveHandle.ts +1 -12
  356. package/src/perspectives/PerspectiveProxy.test.ts +125 -0
  357. package/src/perspectives/PerspectiveProxy.ts +522 -434
  358. package/src/perspectives/WakerSubscriptionManager.ts +13 -13
  359. package/src/runtime/RuntimeClient.ts +118 -461
  360. package/src/runtime/RuntimeTypes.ts +144 -0
  361. package/src/shacl/SHACLFlow.ts +9 -9
  362. package/src/shacl/SHACLShape.test.ts +94 -0
  363. package/src/shacl/SHACLShape.ts +66 -39
  364. package/src/typeDefs.ts +3 -5
  365. package/src/utils.ts +6 -6
  366. package/tsconfig.json +3 -7
  367. package/lib/src/model/query-surreal.d.ts +0 -44
  368. package/lib/src/model/query-surreal.js +0 -249
  369. package/lib/src/model/surreal-utils.js +0 -128
  370. package/shims/reflect-metadata.ts +0 -0
  371. package/shims/type-graphql.ts +0 -75
  372. package/src/PubSub.ts +0 -17
  373. package/src/agent/AgentResolver.ts +0 -263
  374. package/src/ai/AIResolver.ts +0 -372
  375. package/src/buildSchema.ts +0 -43
  376. package/src/expression/ExpressionResolver.ts +0 -64
  377. package/src/language/LanguageContext.ts +0 -37
  378. package/src/language/LanguageResolver.ts +0 -98
  379. package/src/model/Subject.ts +0 -159
  380. package/src/model/prolog-facts.ts +0 -145
  381. package/src/model/query-prolog.ts +0 -148
  382. package/src/model/query-surreal.ts +0 -280
  383. package/src/model/surreal-utils.ts +0 -147
  384. package/src/neighbourhood/NeighbourhoodResolver.ts +0 -100
  385. package/src/perspectives/PerspectiveResolver.ts +0 -372
  386. package/src/runtime/RuntimeResolver.ts +0 -691
  387. package/src/unwrapApolloResult.ts +0 -16
  388. package/tsconfig-browser.json +0 -82
@@ -0,0 +1,287 @@
1
+ /** Shape of event data pushed via WebSocket. Callers can narrow via generics. */
2
+ export interface WsEvent {
3
+ type: string
4
+ [key: string]: unknown
5
+ }
6
+
7
+ /** Error thrown by ApiClient when an RPC call fails. */
8
+ export class RpcError extends Error {
9
+ /** Error code (maps to HTTP status semantics: 400, 401, 403, 404, 500). */
10
+ readonly status: number
11
+ /** Raw error message from server. */
12
+ readonly body: string
13
+
14
+ constructor(status: number, body: string) {
15
+ super(`RPC error ${status}: ${body}`)
16
+ this.name = "RpcError"
17
+ this.status = status
18
+ this.body = body
19
+ }
20
+ }
21
+
22
+ /** Default RPC call timeout in milliseconds (30 seconds). */
23
+ const DEFAULT_TIMEOUT_MS = 30_000
24
+
25
+ /** Maximum reconnect delay in ms. */
26
+ const MAX_RECONNECT_DELAY_MS = 30_000
27
+
28
+ /** Initial reconnect delay in ms. */
29
+ const INITIAL_RECONNECT_DELAY_MS = 500
30
+
31
+ /** Counter for generating unique request IDs. */
32
+ let _idCounter = 0
33
+ function nextId(): string {
34
+ return String(++_idCounter)
35
+ }
36
+
37
+ interface PendingCall {
38
+ resolve: (value: unknown) => void
39
+ reject: (reason: unknown) => void
40
+ timer: ReturnType<typeof setTimeout>
41
+ }
42
+
43
+ export class ApiClient {
44
+ private baseUrl: string
45
+ private token?: string
46
+ private readonly _webSocketImpl?: new (url: string) => WebSocket
47
+
48
+ constructor(baseUrl: string, token?: string, webSocketImpl?: new (url: string) => WebSocket) {
49
+ this.baseUrl = baseUrl
50
+ this.token = token
51
+ this._webSocketImpl = webSocketImpl
52
+ }
53
+
54
+ getBaseUrl(): string { return this.baseUrl }
55
+ getToken(): string | undefined { return this.token }
56
+
57
+ setToken(token: string) {
58
+ this.token = token
59
+ }
60
+
61
+ // ── WebSocket RPC core ──────────────────────────────────────────────────
62
+
63
+ private _ws: WebSocket | null = null
64
+ private _wsCallbacks = new Set<(data: unknown) => void>()
65
+ private _pendingCalls = new Map<string, PendingCall>()
66
+ private _wsReady: Promise<void> | null = null
67
+ private _wsReadyResolve: (() => void) | null = null
68
+ private _wsReconnectTimer: ReturnType<typeof setTimeout> | null = null
69
+ private _wsReconnectDelay = INITIAL_RECONNECT_DELAY_MS
70
+ private _wsClosed = false
71
+ private _wsPingTimer: ReturnType<typeof setInterval> | null = null
72
+
73
+ private _getWsUrl(): string {
74
+ const wsBase = this.baseUrl
75
+ .replace(/^http:\/\//, 'ws://')
76
+ .replace(/^https:\/\//, 'wss://')
77
+ const tokenParam = this.token ? `token=${encodeURIComponent(this.token)}` : ''
78
+ const path = '/api/v1/ws'
79
+ return tokenParam ? `${wsBase}${path}?${tokenParam}` : `${wsBase}${path}`
80
+ }
81
+
82
+ private _ensureWs(): void {
83
+ if (this._ws && (this._ws.readyState === 1 /* OPEN */ || this._ws.readyState === 0 /* CONNECTING */)) {
84
+ return
85
+ }
86
+ // Prevent duplicate connections from concurrent callers
87
+ if (this._wsReady) return
88
+
89
+ this._wsClosed = false
90
+
91
+ this._wsReady = new Promise<void>((resolve) => {
92
+ this._wsReadyResolve = resolve
93
+ })
94
+
95
+ const url = this._getWsUrl()
96
+ const WsImpl = this._webSocketImpl ?? WebSocket
97
+ const ws = new WsImpl(url)
98
+ this._ws = ws
99
+
100
+ ws.onopen = () => {
101
+ this._wsReconnectDelay = INITIAL_RECONNECT_DELAY_MS
102
+ if (this._wsReadyResolve) {
103
+ this._wsReadyResolve()
104
+ this._wsReadyResolve = null
105
+ }
106
+ this._startPing()
107
+ }
108
+
109
+ ws.onmessage = (event) => {
110
+ let parsed: Record<string, unknown>
111
+ try { parsed = JSON.parse(event.data) } catch (e) {
112
+ console.error('Error parsing WebSocket data:', e)
113
+ return
114
+ }
115
+
116
+ // Ignore pong messages
117
+ if (parsed.type === 'pong') return
118
+
119
+ // Check if this is a response to a pending RPC call (has an id field)
120
+ const id = parsed.id as string | undefined
121
+ if (id && this._pendingCalls.has(id)) {
122
+ const pending = this._pendingCalls.get(id)!
123
+ this._pendingCalls.delete(id)
124
+ clearTimeout(pending.timer)
125
+
126
+ if (parsed.error) {
127
+ const err = parsed.error as { code?: number; message?: string }
128
+ pending.reject(new RpcError(err.code ?? 500, err.message ?? 'Unknown error'))
129
+ } else {
130
+ pending.resolve(parsed.result)
131
+ }
132
+ return
133
+ }
134
+
135
+ // Server-push event (no id, or id not in pending) → route to subscribers
136
+ for (const cb of this._wsCallbacks) cb(parsed)
137
+ }
138
+
139
+ ws.onerror = (e) => {
140
+ console.error('WebSocket error:', e)
141
+ }
142
+
143
+ ws.onclose = () => {
144
+ this._stopPing()
145
+ this._ws = null
146
+ // Reset the readiness promise so future calls reconnect
147
+ this._wsReady = null
148
+
149
+ // Reject all pending calls
150
+ const hadPendingCalls = this._pendingCalls.size > 0
151
+ for (const [id, pending] of this._pendingCalls) {
152
+ clearTimeout(pending.timer)
153
+ pending.reject(new RpcError(503, 'WebSocket connection closed'))
154
+ }
155
+ this._pendingCalls.clear()
156
+
157
+ if (!this._wsClosed && (this._wsCallbacks.size > 0 || hadPendingCalls)) {
158
+ this._scheduleReconnect()
159
+ }
160
+ }
161
+ }
162
+
163
+ private _startPing(): void {
164
+ this._stopPing()
165
+ this._wsPingTimer = setInterval(() => {
166
+ if (this._ws && this._ws.readyState === 1 /* OPEN */) {
167
+ this._ws.send(JSON.stringify({ type: 'ping' }))
168
+ }
169
+ }, 30_000)
170
+ }
171
+
172
+ private _stopPing(): void {
173
+ if (this._wsPingTimer) {
174
+ clearInterval(this._wsPingTimer)
175
+ this._wsPingTimer = null
176
+ }
177
+ }
178
+
179
+ private _scheduleReconnect(): void {
180
+ if (this._wsReconnectTimer) return
181
+ const delay = this._wsReconnectDelay
182
+ this._wsReconnectDelay = Math.min(this._wsReconnectDelay * 2, MAX_RECONNECT_DELAY_MS)
183
+ this._wsReconnectTimer = setTimeout(() => {
184
+ this._wsReconnectTimer = null
185
+ if (!this._wsClosed) {
186
+ this._ensureWs()
187
+ }
188
+ }, delay)
189
+ }
190
+
191
+ /** Ensure WS is connected and ready. Lazy — connects on first use. */
192
+ private async _ready(): Promise<void> {
193
+ this._ensureWs()
194
+ if (this._wsReady) await this._wsReady
195
+ }
196
+
197
+ // ── RPC call method ─────────────────────────────────────────────────────
198
+
199
+ /**
200
+ * Send an RPC call over the WebSocket connection.
201
+ * @param type - The operation type (e.g. 'agent.get', 'perspective.all')
202
+ * @param params - Optional parameters to include in the message
203
+ * @returns Promise that resolves with the result from the server
204
+ */
205
+ async call<T>(type: string, params?: Record<string, unknown>): Promise<T> {
206
+ await this._ready()
207
+
208
+ const id = nextId()
209
+ // Put params under a "params" key to avoid collision with
210
+ // protocol fields "id" and "type" (e.g. params might contain
211
+ // { id: modelId } or { type: "db" }).
212
+ const message: Record<string, unknown> = { id, type, params: params || {} }
213
+
214
+ return new Promise<T>((resolve, reject) => {
215
+ const timer = setTimeout(() => {
216
+ this._pendingCalls.delete(id)
217
+ reject(new RpcError(408, `RPC call '${type}' timed out after ${DEFAULT_TIMEOUT_MS}ms`))
218
+ }, DEFAULT_TIMEOUT_MS)
219
+
220
+ this._pendingCalls.set(id, {
221
+ resolve: resolve as (value: unknown) => void,
222
+ reject,
223
+ timer,
224
+ })
225
+
226
+ if (this._ws && this._ws.readyState === 1 /* OPEN */) {
227
+ this._ws.send(JSON.stringify(message))
228
+ } else {
229
+ this._pendingCalls.delete(id)
230
+ clearTimeout(timer)
231
+ reject(new RpcError(503, 'WebSocket not connected'))
232
+ }
233
+ })
234
+ }
235
+
236
+ // ── Event subscriptions (same interface as before) ──────────────────────
237
+
238
+ subscribe<T = WsEvent>(callback: (data: T) => void): () => void {
239
+ this._wsCallbacks.add(callback as (data: unknown) => void)
240
+ this._ensureWs()
241
+
242
+ return () => {
243
+ this._wsCallbacks.delete(callback as (data: unknown) => void)
244
+ if (this._wsCallbacks.size === 0 && this._pendingCalls.size === 0) {
245
+ this._closeWs()
246
+ }
247
+ }
248
+ }
249
+
250
+ /** Wait until the WebSocket connection is established. */
251
+ async waitForSubscription(): Promise<void> {
252
+ await this._ready()
253
+ }
254
+
255
+ // ── Explicit connection ─────────────────────────────────────────────────
256
+
257
+ /** Explicitly connect the WebSocket (optional — connection is lazy). */
258
+ connect(): void {
259
+ this._ensureWs()
260
+ }
261
+
262
+ private _closeWs(): void {
263
+ this._stopPing()
264
+ if (this._wsReconnectTimer) {
265
+ clearTimeout(this._wsReconnectTimer)
266
+ this._wsReconnectTimer = null
267
+ }
268
+ if (this._ws) {
269
+ this._wsClosed = true
270
+ this._ws.close()
271
+ this._ws = null
272
+ this._wsReady = null
273
+ }
274
+ }
275
+
276
+ /** Close all open WebSocket connections and reject pending calls. */
277
+ closeAll(): void {
278
+ // Reject pending calls
279
+ for (const [id, pending] of this._pendingCalls) {
280
+ clearTimeout(pending.timer)
281
+ pending.reject(new RpcError(503, 'Client closed'))
282
+ }
283
+ this._pendingCalls.clear()
284
+ this._closeWs()
285
+ this._wsCallbacks.clear()
286
+ }
287
+ }
@@ -0,0 +1,145 @@
1
+ /**
2
+ * PersistentCache — two-tier persistent key-value cache abstraction.
3
+ *
4
+ * Provides an IndexedDB-backed implementation for browsers and a no-op
5
+ * NullCache fallback for Node.js / environments without IndexedDB.
6
+ *
7
+ * Design goals:
8
+ * - Lazy open: IDB connection is deferred until first access
9
+ * - Fire-and-forget writes: put() resolves immediately (best-effort persistence)
10
+ * - Graceful degradation: all IDB errors resolve (never reject), so callers
11
+ * never need try/catch around cache operations
12
+ * - Tree-shakeable: import only what you need
13
+ */
14
+
15
+ // ── Interface ────────────────────────────────────────────────────────
16
+
17
+ export interface PersistentCache<T = unknown> {
18
+ get(key: string): Promise<T | undefined>;
19
+ put(key: string, value: T): Promise<void>;
20
+ delete(key: string): Promise<void>;
21
+ clear(): Promise<void>;
22
+ }
23
+
24
+ // ── IndexedDB Implementation ─────────────────────────────────────────
25
+
26
+ export class IDBCache<T = unknown> implements PersistentCache<T> {
27
+ #dbName: string;
28
+ #storeName: string;
29
+ #dbPromise: Promise<IDBDatabase> | null = null;
30
+ #version = 1;
31
+
32
+ constructor(dbName: string, storeName: string) {
33
+ this.#dbName = dbName;
34
+ this.#storeName = storeName;
35
+ }
36
+
37
+ #open(): Promise<IDBDatabase> {
38
+ if (!this.#dbPromise) {
39
+ this.#dbPromise = new Promise<IDBDatabase>((resolve, reject) => {
40
+ const storeName = this.#storeName;
41
+ const req = indexedDB.open(this.#dbName, this.#version);
42
+ req.onupgradeneeded = () => {
43
+ const db = req.result;
44
+ if (!db.objectStoreNames.contains(storeName)) {
45
+ db.createObjectStore(storeName);
46
+ }
47
+ };
48
+ req.onsuccess = () => resolve(req.result);
49
+ req.onerror = () => reject(req.error);
50
+ });
51
+ }
52
+ return this.#dbPromise;
53
+ }
54
+
55
+ async get(key: string): Promise<T | undefined> {
56
+ try {
57
+ const db = await this.#open();
58
+ return new Promise<T | undefined>((resolve) => {
59
+ const tx = db.transaction(this.#storeName, 'readonly');
60
+ const store = tx.objectStore(this.#storeName);
61
+ const req = store.get(key);
62
+ req.onsuccess = () => resolve(req.result ?? undefined);
63
+ req.onerror = () => resolve(undefined);
64
+ });
65
+ } catch {
66
+ return undefined;
67
+ }
68
+ }
69
+
70
+ async put(key: string, value: T): Promise<void> {
71
+ try {
72
+ const db = await this.#open();
73
+ return new Promise<void>((resolve) => {
74
+ const tx = db.transaction(this.#storeName, 'readwrite');
75
+ const store = tx.objectStore(this.#storeName);
76
+ store.put(value, key);
77
+ tx.oncomplete = () => resolve();
78
+ tx.onerror = () => resolve(); // fire-and-forget
79
+ });
80
+ } catch {
81
+ // degrade gracefully
82
+ }
83
+ }
84
+
85
+ async delete(key: string): Promise<void> {
86
+ try {
87
+ const db = await this.#open();
88
+ return new Promise<void>((resolve) => {
89
+ const tx = db.transaction(this.#storeName, 'readwrite');
90
+ const store = tx.objectStore(this.#storeName);
91
+ store.delete(key);
92
+ tx.oncomplete = () => resolve();
93
+ tx.onerror = () => resolve();
94
+ });
95
+ } catch {
96
+ // degrade gracefully
97
+ }
98
+ }
99
+
100
+ async clear(): Promise<void> {
101
+ try {
102
+ const db = await this.#open();
103
+ return new Promise<void>((resolve) => {
104
+ const tx = db.transaction(this.#storeName, 'readwrite');
105
+ const store = tx.objectStore(this.#storeName);
106
+ store.clear();
107
+ tx.oncomplete = () => resolve();
108
+ tx.onerror = () => resolve();
109
+ });
110
+ } catch {
111
+ // degrade gracefully
112
+ }
113
+ }
114
+ }
115
+
116
+ // ── NullCache (no-op fallback for Node.js) ───────────────────────────
117
+
118
+ export class NullCache<T = unknown> implements PersistentCache<T> {
119
+ async get(_key: string): Promise<T | undefined> { return undefined; }
120
+ async put(_key: string, _value: T): Promise<void> {}
121
+ async delete(_key: string): Promise<void> {}
122
+ async clear(): Promise<void> {}
123
+ }
124
+
125
+ // ── Factory ──────────────────────────────────────────────────────────
126
+
127
+ /**
128
+ * Create a PersistentCache backed by IndexedDB (browser) or NullCache (Node.js).
129
+ *
130
+ * @param dbName - IndexedDB database name
131
+ * @param storeName - IndexedDB object store name
132
+ */
133
+ export function createPersistentCache<T = unknown>(
134
+ dbName: string,
135
+ storeName: string,
136
+ ): PersistentCache<T> {
137
+ try {
138
+ if (typeof indexedDB !== 'undefined') {
139
+ return new IDBCache<T>(dbName, storeName);
140
+ }
141
+ } catch {
142
+ // indexedDB access threw (e.g. in a worker with restricted globals)
143
+ }
144
+ return new NullCache<T>();
145
+ }