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

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 (393) hide show
  1. package/README.md +2 -25
  2. package/jest-setup.ts +1 -1
  3. package/lib/index.cjs +8677 -15318
  4. package/lib/index.js +14507 -21223
  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 +8 -2
  153. package/lib/src/index.js +8 -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 +143 -63
  166. package/lib/src/model/Ad4mModel.js +583 -425
  167. package/lib/src/model/Ad4mModel.test.js +1434 -688
  168. package/lib/src/model/ModelQueryBuilder.d.ts +61 -45
  169. package/lib/src/model/ModelQueryBuilder.js +315 -157
  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 +154 -57
  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 +195 -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 +188 -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 +157 -78
  220. package/lib/src/perspectives/PerspectiveProxy.js +475 -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/SparqlBindings.d.ts +47 -0
  224. package/lib/src/perspectives/SparqlBindings.js +65 -0
  225. package/lib/src/perspectives/WakerSubscriptionManager.d.ts +3 -3
  226. package/lib/src/perspectives/WakerSubscriptionManager.js +12 -12
  227. package/lib/src/runtime/RuntimeClient.d.ts +8 -6
  228. package/lib/src/runtime/RuntimeClient.js +97 -454
  229. package/lib/src/runtime/RuntimeResolver.d.ts +14 -0
  230. package/lib/src/runtime/RuntimeResolver.js +84 -0
  231. package/lib/src/runtime/RuntimeTypes.d.ts +101 -0
  232. package/lib/src/runtime/RuntimeTypes.js +45 -0
  233. package/lib/src/schema.gql +14 -1
  234. package/lib/src/shacl/SHACLFlow.d.ts +1 -1
  235. package/lib/src/shacl/SHACLFlow.js +9 -9
  236. package/lib/src/shacl/SHACLShape.d.ts +26 -1
  237. package/lib/src/shacl/SHACLShape.js +140 -38
  238. package/lib/src/shacl/SHACLShape.test.js +82 -0
  239. package/lib/src/typeDefs.js +3 -615
  240. package/lib/src/utils.d.ts +6 -6
  241. package/lib/src/utils.js +6 -6
  242. package/package.json +9 -24
  243. package/rollup.config.js +0 -7
  244. package/src/Ad4mClient.test.ts +1192 -1288
  245. package/src/Ad4mClient.ts +46 -15
  246. package/src/Literal.test.ts +10 -5
  247. package/src/Literal.ts +6 -5
  248. package/src/agent/Agent.ts +0 -99
  249. package/src/agent/AgentClient.ts +238 -467
  250. package/src/agent/AgentStatus.ts +0 -12
  251. package/src/ai/AIClient.ts +96 -296
  252. package/src/ai/AITypes.ts +66 -0
  253. package/src/ai/Tasks.ts +0 -52
  254. package/src/apiClient.ts +287 -0
  255. package/src/cache/PersistentCache.ts +145 -0
  256. package/src/cache/cache.test.ts +713 -0
  257. package/src/expression/Expression.ts +3 -43
  258. package/src/expression/ExpressionClient.ts +148 -77
  259. package/src/expression/ExpressionRef.ts +2 -8
  260. package/src/generated/api/AIModelLoadingStatus.ts +3 -0
  261. package/src/generated/api/AddLinkExpressionRequest.ts +4 -0
  262. package/src/generated/api/AddLinkRequest.ts +4 -0
  263. package/src/generated/api/AddLinksBulkRequest.ts +4 -0
  264. package/src/generated/api/AddSdnaRequest.ts +3 -0
  265. package/src/generated/api/ApplyTemplateRequest.ts +3 -0
  266. package/src/generated/api/AuthInfoInput.ts +4 -0
  267. package/src/generated/api/CapabilityInput.ts +4 -0
  268. package/src/generated/api/CommitBatchRequest.ts +3 -0
  269. package/src/generated/api/ComputeLogEntry.ts +3 -0
  270. package/src/generated/api/CreateExpressionRequest.ts +3 -0
  271. package/src/generated/api/CreatePerspectiveRequest.ts +3 -0
  272. package/src/generated/api/CreateSubjectRequest.ts +3 -0
  273. package/src/generated/api/EmbedRequest.ts +3 -0
  274. package/src/generated/api/EntanglementProofInput.ts +3 -0
  275. package/src/generated/api/ExecuteCommandsRequest.ts +3 -0
  276. package/src/generated/api/ExportRequest.ts +3 -0
  277. package/src/generated/api/ExpressionManyRequest.ts +3 -0
  278. package/src/generated/api/ExpressionProof.ts +3 -0
  279. package/src/generated/api/ExpressionProofInput.ts +3 -0
  280. package/src/generated/api/FriendSendMessageRequest.ts +3 -0
  281. package/src/generated/api/FriendsListRequest.ts +3 -0
  282. package/src/generated/api/GenerateAgentRequest.ts +3 -0
  283. package/src/generated/api/GenerateJwtRequest.ts +3 -0
  284. package/src/generated/api/GetSubjectDataRequest.ts +3 -0
  285. package/src/generated/api/ImportAgentRequest.ts +3 -0
  286. package/src/generated/api/ImportRequest.ts +3 -0
  287. package/src/generated/api/JoinNeighbourhoodRequest.ts +3 -0
  288. package/src/generated/api/LanguageMetaInput.ts +3 -0
  289. package/src/generated/api/Link.ts +3 -0
  290. package/src/generated/api/LinkExpression.ts +6 -0
  291. package/src/generated/api/LinkExpressionInput.ts +6 -0
  292. package/src/generated/api/LinkInput.ts +3 -0
  293. package/src/generated/api/LinkLanguageTemplatesRequest.ts +3 -0
  294. package/src/generated/api/LinkMutations.ts +5 -0
  295. package/src/generated/api/LinkStatus.ts +3 -0
  296. package/src/generated/api/LockAgentRequest.ts +3 -0
  297. package/src/generated/api/ModelType.ts +3 -0
  298. package/src/generated/api/NotificationInput.ts +3 -0
  299. package/src/generated/api/OpenLinkRequest.ts +3 -0
  300. package/src/generated/api/PermitCapabilityRequest.ts +3 -0
  301. package/src/generated/api/PerspectiveInput.ts +4 -0
  302. package/src/generated/api/PromptRequest.ts +3 -0
  303. package/src/generated/api/PublishLanguageRequest.ts +4 -0
  304. package/src/generated/api/PublishNeighbourhoodRequest.ts +4 -0
  305. package/src/generated/api/QueryRequest.ts +6 -0
  306. package/src/generated/api/RemoveLinkRequest.ts +4 -0
  307. package/src/generated/api/RemoveLinksBulkRequest.ts +4 -0
  308. package/src/generated/api/ResourceInput.ts +3 -0
  309. package/src/generated/api/SetDefaultModelRequest.ts +4 -0
  310. package/src/generated/api/SetFreeHostingEnabledRequest.ts +3 -0
  311. package/src/generated/api/SetMultiUserRequest.ts +3 -0
  312. package/src/generated/api/SetStatusRequest.ts +3 -0
  313. package/src/generated/api/SignMessageRequest.ts +3 -0
  314. package/src/generated/api/TrustedAgentsRequest.ts +3 -0
  315. package/src/generated/api/UnlockAgentRequest.ts +3 -0
  316. package/src/generated/api/UpdateLinkRequest.ts +5 -0
  317. package/src/generated/api/UpdatePerspectiveRequest.ts +3 -0
  318. package/src/generated/api/UserStatistics.ts +3 -0
  319. package/src/generated/api/VerificationRequestResult.ts +3 -0
  320. package/src/generated/api/VerifySignatureRequest.ts +3 -0
  321. package/src/generated/api/WriteSettingsRequest.ts +3 -0
  322. package/src/generated/api/index.ts +49 -0
  323. package/src/index.ts +8 -2
  324. package/src/jestSetup.ts +1 -1
  325. package/src/language/Icon.ts +0 -4
  326. package/src/language/Language.ts +51 -248
  327. package/src/language/LanguageClient.ts +21 -132
  328. package/src/language/LanguageHandle.ts +0 -14
  329. package/src/language/LanguageMeta.ts +0 -29
  330. package/src/language/LanguageRef.ts +0 -7
  331. package/src/links/Links.ts +0 -37
  332. package/src/model/Ad4mModel.test.ts +1664 -792
  333. package/src/model/Ad4mModel.ts +664 -499
  334. package/src/model/ModelQueryBuilder.ts +362 -183
  335. package/src/model/decorators.ts +71 -22
  336. package/src/model/hydration.ts +3 -772
  337. package/src/model/index.ts +3 -4
  338. package/src/model/json-schema.ts +2 -2
  339. package/src/model/query-cache.test.ts +54 -0
  340. package/src/model/query-cache.ts +79 -0
  341. package/src/model/query-common.ts +1 -1
  342. package/src/model/query-sparql.test.ts +376 -0
  343. package/src/model/query-sparql.ts +504 -0
  344. package/src/model/query-utils.ts +209 -0
  345. package/src/model/relation-filtering.test.ts +60 -53
  346. package/src/model/sdna.ts +1 -1
  347. package/src/model/shacl-gen.ts +163 -64
  348. package/src/model/shacl-roundtrip.test.ts +197 -0
  349. package/src/model/types-typed-query.test.ts +360 -0
  350. package/src/model/types.ts +256 -5
  351. package/src/neighbourhood/Neighbourhood.ts +0 -9
  352. package/src/neighbourhood/NeighbourhoodClient.ts +42 -207
  353. package/src/neighbourhood/NeighbourhoodProxy.test.ts +34 -36
  354. package/src/perspectives/LinkQuery.ts +0 -15
  355. package/src/perspectives/Perspective.ts +1 -12
  356. package/src/perspectives/PerspectiveClient.test.ts +262 -0
  357. package/src/perspectives/PerspectiveClient.ts +252 -468
  358. package/src/perspectives/PerspectiveDiff.ts +0 -8
  359. package/src/perspectives/PerspectiveHandle.ts +1 -12
  360. package/src/perspectives/PerspectiveProxy.test.ts +125 -0
  361. package/src/perspectives/PerspectiveProxy.ts +522 -434
  362. package/src/perspectives/SparqlBindings.ts +79 -0
  363. package/src/perspectives/WakerSubscriptionManager.ts +13 -13
  364. package/src/runtime/RuntimeClient.ts +118 -461
  365. package/src/runtime/RuntimeTypes.ts +144 -0
  366. package/src/shacl/SHACLFlow.ts +9 -9
  367. package/src/shacl/SHACLShape.test.ts +204 -0
  368. package/src/shacl/SHACLShape.ts +191 -39
  369. package/src/typeDefs.ts +3 -5
  370. package/src/utils.ts +6 -6
  371. package/tsconfig.json +3 -7
  372. package/lib/src/model/query-surreal.d.ts +0 -44
  373. package/lib/src/model/query-surreal.js +0 -249
  374. package/lib/src/model/surreal-utils.js +0 -128
  375. package/shims/reflect-metadata.ts +0 -0
  376. package/shims/type-graphql.ts +0 -75
  377. package/src/PubSub.ts +0 -17
  378. package/src/agent/AgentResolver.ts +0 -263
  379. package/src/ai/AIResolver.ts +0 -372
  380. package/src/buildSchema.ts +0 -43
  381. package/src/expression/ExpressionResolver.ts +0 -64
  382. package/src/language/LanguageContext.ts +0 -37
  383. package/src/language/LanguageResolver.ts +0 -98
  384. package/src/model/Subject.ts +0 -159
  385. package/src/model/prolog-facts.ts +0 -145
  386. package/src/model/query-prolog.ts +0 -148
  387. package/src/model/query-surreal.ts +0 -280
  388. package/src/model/surreal-utils.ts +0 -147
  389. package/src/neighbourhood/NeighbourhoodResolver.ts +0 -100
  390. package/src/perspectives/PerspectiveResolver.ts +0 -372
  391. package/src/runtime/RuntimeResolver.ts +0 -691
  392. package/src/unwrapApolloResult.ts +0 -16
  393. 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
+ }