@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,144 @@
1
+ import { PerspectiveExpression } from "../perspectives/Perspective";
2
+ import { ExceptionType } from "../Exception";
3
+
4
+ export class SentMessage {
5
+ recipient: string;
6
+ message: PerspectiveExpression;
7
+ }
8
+
9
+ export class RuntimeInfo {
10
+ ad4mExecutorVersion: string;
11
+ isInitialized: Boolean;
12
+ isUnlocked: Boolean;
13
+ }
14
+
15
+ export class ExceptionInfo {
16
+ title: string;
17
+ message: string;
18
+ type: ExceptionType;
19
+ addon?: string;
20
+ }
21
+
22
+ export class NotificationInput {
23
+ description: string;
24
+ appName: string;
25
+ appUrl: string;
26
+ appIconPath: string;
27
+
28
+ // This is a query which will be executed on every perspective change.
29
+ // All matched unbound variables will be part of the triggerMatch, i.e.
30
+ // the content that will be sent to the launcher via event push
31
+ // and to the webhook.
32
+ trigger: string;
33
+
34
+ // List Perspectives this Notification is active on.
35
+ perspectiveIds: string[];
36
+
37
+ // URL to which the notification matches will be sent via POST
38
+ webhookUrl: string;
39
+
40
+ // Authentication bearer token to be sent via POST to the webhookUrl.
41
+ webhookAuth: string;
42
+ }
43
+
44
+ export class Notification {
45
+ id: string;
46
+ granted: boolean;
47
+ description: string;
48
+ appName: string;
49
+ appUrl: string;
50
+ appIconPath: string;
51
+ trigger: string;
52
+ perspectiveIds: string[];
53
+ webhookUrl: string;
54
+ webhookAuth: string;
55
+ }
56
+
57
+ export class TriggeredNotification {
58
+ notification: Notification;
59
+ perspectiveId: string;
60
+ triggerMatch: string;
61
+ }
62
+
63
+ export class ImportStats {
64
+ total: number;
65
+ imported: number;
66
+ failed: number;
67
+ omitted: number;
68
+ errors: string[];
69
+ }
70
+
71
+ export class ImportResult {
72
+ perspectives: ImportStats;
73
+ links: ImportStats;
74
+ expressions: ImportStats;
75
+ perspectiveDiffs: ImportStats;
76
+ notifications: ImportStats;
77
+ models: ImportStats;
78
+ defaultModels: ImportStats;
79
+ tasks: ImportStats;
80
+ friends: ImportStats;
81
+ trustedAgents: ImportStats;
82
+ knownLinkLanguages: ImportStats;
83
+ }
84
+
85
+ export class UserStatistics {
86
+ email: string;
87
+ did: string;
88
+ lastSeen?: string;
89
+ perspectiveCount: number;
90
+ remainingCredits: string;
91
+ freeAccess: boolean;
92
+ hotWalletAddress?: string;
93
+ }
94
+
95
+ export class VerificationRequestResult {
96
+ success: boolean;
97
+ message: string;
98
+ requiresPassword: boolean;
99
+ isExistingUser: boolean;
100
+ }
101
+
102
+ export class HostingUserInfo {
103
+ email: string;
104
+ remainingCredits: string;
105
+ hotWalletAddress?: string;
106
+ freeAccess: boolean;
107
+
108
+ constructor(email: string, remainingCredits: string, hotWalletAddress?: string, freeAccess: boolean = false) {
109
+ this.email = email;
110
+ this.remainingCredits = remainingCredits;
111
+ this.hotWalletAddress = hotWalletAddress;
112
+ this.freeAccess = freeAccess;
113
+ }
114
+ }
115
+
116
+ export class PaymentRequestResult {
117
+ success: boolean;
118
+ message: string;
119
+
120
+ constructor(success: boolean, message: string) {
121
+ this.success = success;
122
+ this.message = message;
123
+ }
124
+ }
125
+
126
+ export class ComputeLogEntry {
127
+ id: number;
128
+ userEmail: string;
129
+ timestamp: string;
130
+ operation: string;
131
+ summary?: string;
132
+ cost: number;
133
+ creditsAfter: number;
134
+
135
+ constructor(id: number, userEmail: string, timestamp: string, operation: string, cost: number, creditsAfter: number, summary?: string) {
136
+ this.id = id;
137
+ this.userEmail = userEmail;
138
+ this.timestamp = timestamp;
139
+ this.operation = operation;
140
+ this.cost = cost;
141
+ this.creditsAfter = creditsAfter;
142
+ this.summary = summary;
143
+ }
144
+ }
@@ -186,7 +186,7 @@ export class SHACLFlow {
186
186
 
187
187
  /**
188
188
  * Serialize the flow to AD4M links
189
- * These links can be stored in a perspective and queried via SurrealDB
189
+ * These links can be stored in a perspective and queried via SPARQL
190
190
  *
191
191
  * @returns Array of Link objects representing the flow
192
192
  */
@@ -219,7 +219,7 @@ export class SHACLFlow {
219
219
  links.push({
220
220
  source: flowUri,
221
221
  predicate: "ad4m://flowable",
222
- target: `literal://string:${encodeURIComponent(JSON.stringify(this.flowable))}`
222
+ target: `literal:string:${encodeURIComponent(JSON.stringify(this.flowable))}`
223
223
  });
224
224
  }
225
225
 
@@ -228,7 +228,7 @@ export class SHACLFlow {
228
228
  links.push({
229
229
  source: flowUri,
230
230
  predicate: "ad4m://startAction",
231
- target: `literal://string:${encodeURIComponent(JSON.stringify(this.startAction))}`
231
+ target: `literal:string:${encodeURIComponent(JSON.stringify(this.startAction))}`
232
232
  });
233
233
  }
234
234
 
@@ -268,7 +268,7 @@ export class SHACLFlow {
268
268
  links.push({
269
269
  source: stateUri,
270
270
  predicate: "ad4m://stateCheck",
271
- target: `literal://string:${encodeURIComponent(JSON.stringify(state.stateCheck))}`
271
+ target: `literal:string:${encodeURIComponent(JSON.stringify(state.stateCheck))}`
272
272
  });
273
273
  }
274
274
 
@@ -317,7 +317,7 @@ export class SHACLFlow {
317
317
  links.push({
318
318
  source: transitionUri,
319
319
  predicate: "ad4m://transitionActions",
320
- target: `literal://string:${encodeURIComponent(JSON.stringify(transition.actions))}`
320
+ target: `literal:string:${encodeURIComponent(JSON.stringify(transition.actions))}`
321
321
  });
322
322
  }
323
323
 
@@ -359,7 +359,7 @@ export class SHACLFlow {
359
359
  flow.flowable = "any";
360
360
  } else {
361
361
  try {
362
- const jsonStr = flowableLink.target.replace('literal://string:', '');
362
+ const jsonStr = flowableLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
363
363
  flow.flowable = JSON.parse(decodeURIComponent(jsonStr));
364
364
  } catch {
365
365
  flow.flowable = "any";
@@ -373,7 +373,7 @@ export class SHACLFlow {
373
373
  );
374
374
  if (startActionLink) {
375
375
  try {
376
- const jsonStr = startActionLink.target.replace('literal://string:', '');
376
+ const jsonStr = startActionLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
377
377
  flow.startAction = JSON.parse(decodeURIComponent(jsonStr));
378
378
  } catch {
379
379
  // Ignore parse errors
@@ -413,7 +413,7 @@ export class SHACLFlow {
413
413
  let stateCheck: LinkPattern = { predicate: "", target: "" };
414
414
  if (checkLink) {
415
415
  try {
416
- const jsonStr = checkLink.target.replace('literal://string:', '');
416
+ const jsonStr = checkLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
417
417
  stateCheck = JSON.parse(decodeURIComponent(jsonStr));
418
418
  } catch {
419
419
  // Ignore parse errors
@@ -458,7 +458,7 @@ export class SHACLFlow {
458
458
  let actions: AD4MAction[] = [];
459
459
  if (actionsLink) {
460
460
  try {
461
- const jsonStr = actionsLink.target.replace('literal://string:', '');
461
+ const jsonStr = actionsLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
462
462
  actions = JSON.parse(decodeURIComponent(jsonStr));
463
463
  } catch {
464
464
  // Ignore parse errors
@@ -397,4 +397,208 @@ describe('SHACLShape', () => {
397
397
  expect(prop.remover).toEqual(original.properties[0].remover);
398
398
  });
399
399
  });
400
+
401
+ describe('sh:in round-trip', () => {
402
+ it('preserves sh:in enum values through toLinks() → fromLinks()', () => {
403
+ const original = new SHACLShape('test://Model');
404
+ original.addProperty({
405
+ name: 'status',
406
+ path: 'test://status',
407
+ datatype: 'xsd:string',
408
+ in: [
409
+ { value: 'active', label: 'Active' },
410
+ { value: 'inactive', label: 'Inactive' },
411
+ { value: 'archived' },
412
+ ],
413
+ });
414
+
415
+ const links = original.toLinks();
416
+
417
+ // Verify sh:in link was created
418
+ const inLink = links.find(l => l.predicate === 'sh://in');
419
+ expect(inLink).toBeDefined();
420
+ expect(inLink!.target).toContain('literal:string:');
421
+
422
+ // Reconstruct and verify
423
+ const reconstructed = SHACLShape.fromLinks(links, 'test://ModelShape');
424
+ expect(reconstructed.properties[0].in).toBeDefined();
425
+ expect(reconstructed.properties[0].in).toEqual([
426
+ { value: 'active', label: 'Active' },
427
+ { value: 'inactive', label: 'Inactive' },
428
+ { value: 'archived' },
429
+ ]);
430
+ });
431
+
432
+ it('handles sh:in with special characters in values', () => {
433
+ const original = new SHACLShape('test://Model');
434
+ original.addProperty({
435
+ name: 'category',
436
+ path: 'test://category',
437
+ in: [
438
+ { value: 'food & drink', label: 'Food & Drink' },
439
+ { value: 'arts/crafts' },
440
+ ],
441
+ });
442
+
443
+ const links = original.toLinks();
444
+ const reconstructed = SHACLShape.fromLinks(links, 'test://ModelShape');
445
+ expect(reconstructed.properties[0].in).toEqual(original.properties[0].in);
446
+ });
447
+
448
+ it('handles sh:in with empty array (no link created)', () => {
449
+ const original = new SHACLShape('test://Model');
450
+ original.addProperty({
451
+ name: 'field',
452
+ path: 'test://field',
453
+ in: [],
454
+ });
455
+
456
+ const links = original.toLinks();
457
+ const inLink = links.find(l => l.predicate === 'sh://in');
458
+ expect(inLink).toBeUndefined();
459
+ });
460
+
461
+ it('handles sh:in with literal://string: prefix variant', () => {
462
+ // fromLinks should handle both `literal:string:` and `literal://string:` prefixes
463
+ const links = [
464
+ { source: 'test://ModelShape', predicate: 'sh://targetClass', target: 'test://Model' },
465
+ { source: 'test://ModelShape', predicate: 'sh://property', target: 'test://Model.status' },
466
+ { source: 'test://Model.status', predicate: 'sh://path', target: 'test://status' },
467
+ { source: 'test://Model.status', predicate: 'sh://in', target: 'literal://string:[{"value":"a"},{"value":"b"}]' },
468
+ ];
469
+
470
+ const reconstructed = SHACLShape.fromLinks(links, 'test://ModelShape');
471
+ expect(reconstructed.properties[0].in).toEqual([
472
+ { value: 'a' },
473
+ { value: 'b' },
474
+ ]);
475
+ });
476
+
477
+ it('preserves sh:in through toJSON() → fromJSON()', () => {
478
+ const original = new SHACLShape('test://Model');
479
+ original.addProperty({
480
+ name: 'priority',
481
+ path: 'test://priority',
482
+ in: [
483
+ { value: 'high', label: 'High' },
484
+ { value: 'medium', label: 'Medium' },
485
+ { value: 'low', label: 'Low' },
486
+ ],
487
+ });
488
+
489
+ const json = original.toJSON();
490
+ const reconstructed = SHACLShape.fromJSON(json);
491
+ expect(reconstructed.properties[0].in).toEqual(original.properties[0].in);
492
+ });
493
+ });
494
+
495
+ describe('runtime metadata predicates (SHACL as source of truth)', () => {
496
+ it('emits and parses relationKind', () => {
497
+ const shape = new SHACLShape('ns://Recipe');
498
+ shape.addProperty({
499
+ name: 'ingredients',
500
+ path: 'ns://has_ingredient',
501
+ relationKind: 'hasMany',
502
+ });
503
+ const links = shape.toLinks();
504
+ const kindLink = links.find(l => l.predicate === 'ad4m://relationKind');
505
+ expect(kindLink?.target).toBe('literal:string:hasMany');
506
+
507
+ const round = SHACLShape.fromLinks(links, shape.nodeShapeUri);
508
+ expect(round.properties[0].relationKind).toBe('hasMany');
509
+ });
510
+
511
+ it('emits and parses targetClassName', () => {
512
+ const shape = new SHACLShape('ns://Recipe');
513
+ shape.addProperty({
514
+ name: 'ingredients',
515
+ path: 'ns://has_ingredient',
516
+ targetClassName: 'Ingredient',
517
+ });
518
+ const links = shape.toLinks();
519
+ const link = links.find(l => l.predicate === 'ad4m://targetClassName');
520
+ expect(link?.target).toBe('literal:string:Ingredient');
521
+
522
+ const round = SHACLShape.fromLinks(links, shape.nodeShapeUri);
523
+ expect(round.properties[0].targetClassName).toBe('Ingredient');
524
+ });
525
+
526
+ it('emits and parses whereFilter as a JSON literal', () => {
527
+ const shape = new SHACLShape('ns://Board');
528
+ shape.addProperty({
529
+ name: 'tasks',
530
+ path: 'ns://has_task',
531
+ whereFilter: { status: 'active' },
532
+ });
533
+ const links = shape.toLinks();
534
+ const link = links.find(l => l.predicate === 'ad4m://whereFilter');
535
+ expect(link?.target).toContain('"status"');
536
+
537
+ const round = SHACLShape.fromLinks(links, shape.nodeShapeUri);
538
+ expect(round.properties[0].whereFilter).toEqual({ status: 'active' });
539
+ });
540
+
541
+ it('emits and parses wherePredicates', () => {
542
+ const shape = new SHACLShape('ns://Board');
543
+ shape.addProperty({
544
+ name: 'tasks',
545
+ path: 'ns://has_task',
546
+ wherePredicates: { status: 'ns://status' },
547
+ });
548
+ const links = shape.toLinks();
549
+ const link = links.find(l => l.predicate === 'ad4m://wherePredicates');
550
+ expect(link).toBeDefined();
551
+
552
+ const round = SHACLShape.fromLinks(links, shape.nodeShapeUri);
553
+ expect(round.properties[0].wherePredicates).toEqual({ status: 'ns://status' });
554
+ });
555
+
556
+ it('omits wherePredicates link for empty maps', () => {
557
+ const shape = new SHACLShape('ns://Board');
558
+ shape.addProperty({
559
+ name: 'tasks',
560
+ path: 'ns://has_task',
561
+ wherePredicates: {},
562
+ });
563
+ const links = shape.toLinks();
564
+ const link = links.find(l => l.predicate === 'ad4m://wherePredicates');
565
+ expect(link).toBeUndefined();
566
+ });
567
+
568
+ it('emits and parses filter=false as a literal boolean', () => {
569
+ const shape = new SHACLShape('ns://Doc');
570
+ shape.addProperty({
571
+ name: 'tags',
572
+ path: 'ns://tag',
573
+ filter: false,
574
+ });
575
+ const links = shape.toLinks();
576
+ const link = links.find(l => l.predicate === 'ad4m://filter');
577
+ expect(link?.target).toBe('literal:false');
578
+
579
+ const round = SHACLShape.fromLinks(links, shape.nodeShapeUri);
580
+ expect(round.properties[0].filter).toBe(false);
581
+ });
582
+
583
+ it('round-trips all runtime metadata through toJSON() and fromJSON()', () => {
584
+ const original = new SHACLShape('ns://Board');
585
+ original.addProperty({
586
+ name: 'tasks',
587
+ path: 'ns://has_task',
588
+ relationKind: 'hasMany',
589
+ targetClassName: 'Task',
590
+ whereFilter: { status: 'active' },
591
+ wherePredicates: { status: 'ns://status' },
592
+ filter: false,
593
+ });
594
+ const json = original.toJSON();
595
+ const reconstructed = SHACLShape.fromJSON(json);
596
+ const prop = reconstructed.properties[0];
597
+ expect(prop.relationKind).toBe('hasMany');
598
+ expect(prop.targetClassName).toBe('Task');
599
+ expect(prop.whereFilter).toEqual({ status: 'active' });
600
+ expect(prop.wherePredicates).toEqual({ status: 'ns://status' });
601
+ expect(prop.filter).toBe(false);
602
+ });
603
+ });
400
604
  });