@coasys/ad4m 0.13.0-test-2 → 0.13.0-test-4

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 (347) hide show
  1. package/README.md +2 -25
  2. package/jest-setup.ts +1 -1
  3. package/lib/index.cjs +2805 -10556
  4. package/lib/index.js +2513 -10322
  5. package/lib/src/Ad4mClient.d.ts +7 -3
  6. package/lib/src/Ad4mClient.js +29 -13
  7. package/lib/src/agent/Agent.js +26 -272
  8. package/lib/src/agent/AgentClient.d.ts +10 -21
  9. package/lib/src/agent/AgentClient.js +75 -427
  10. package/lib/src/agent/AgentStatus.js +2 -37
  11. package/lib/src/ai/AIClient.d.ts +12 -4
  12. package/lib/src/ai/AIClient.js +81 -285
  13. package/lib/src/ai/AITypes.d.ts +55 -0
  14. package/lib/src/ai/AITypes.js +18 -0
  15. package/lib/src/ai/Tasks.js +10 -133
  16. package/lib/src/apiClient.d.ts +52 -0
  17. package/lib/src/apiClient.js +231 -0
  18. package/lib/src/expression/Expression.d.ts +1 -1
  19. package/lib/src/expression/Expression.js +13 -122
  20. package/lib/src/expression/ExpressionClient.d.ts +3 -3
  21. package/lib/src/expression/ExpressionClient.js +13 -76
  22. package/lib/src/expression/ExpressionRef.js +2 -25
  23. package/lib/src/generated/api/AIModelLoadingStatus.d.ts +7 -0
  24. package/lib/src/generated/api/AIModelLoadingStatus.js +2 -0
  25. package/lib/src/generated/api/AddLinkExpressionRequest.d.ts +6 -0
  26. package/lib/src/generated/api/AddLinkExpressionRequest.js +1 -0
  27. package/lib/src/generated/api/AddLinkRequest.d.ts +6 -0
  28. package/lib/src/generated/api/AddLinkRequest.js +1 -0
  29. package/lib/src/generated/api/AddLinksBulkRequest.d.ts +6 -0
  30. package/lib/src/generated/api/AddLinksBulkRequest.js +1 -0
  31. package/lib/src/generated/api/AddSdnaRequest.d.ts +6 -0
  32. package/lib/src/generated/api/AddSdnaRequest.js +2 -0
  33. package/lib/src/generated/api/ApplyTemplateRequest.d.ts +4 -0
  34. package/lib/src/generated/api/ApplyTemplateRequest.js +2 -0
  35. package/lib/src/generated/api/AuthInfoInput.d.ts +10 -0
  36. package/lib/src/generated/api/AuthInfoInput.js +1 -0
  37. package/lib/src/generated/api/CapabilityInput.d.ts +5 -0
  38. package/lib/src/generated/api/CapabilityInput.js +1 -0
  39. package/lib/src/generated/api/CommitBatchRequest.d.ts +3 -0
  40. package/lib/src/generated/api/CommitBatchRequest.js +2 -0
  41. package/lib/src/generated/api/ComputeLogEntry.d.ts +9 -0
  42. package/lib/src/generated/api/ComputeLogEntry.js +2 -0
  43. package/lib/src/generated/api/CreateExpressionRequest.d.ts +4 -0
  44. package/lib/src/generated/api/CreateExpressionRequest.js +2 -0
  45. package/lib/src/generated/api/CreatePerspectiveRequest.d.ts +3 -0
  46. package/lib/src/generated/api/CreatePerspectiveRequest.js +2 -0
  47. package/lib/src/generated/api/CreateSubjectRequest.d.ts +6 -0
  48. package/lib/src/generated/api/CreateSubjectRequest.js +2 -0
  49. package/lib/src/generated/api/EmbedRequest.d.ts +4 -0
  50. package/lib/src/generated/api/EmbedRequest.js +2 -0
  51. package/lib/src/generated/api/EntanglementProofInput.d.ts +6 -0
  52. package/lib/src/generated/api/EntanglementProofInput.js +2 -0
  53. package/lib/src/generated/api/ExecuteCommandsRequest.d.ts +4 -0
  54. package/lib/src/generated/api/ExecuteCommandsRequest.js +2 -0
  55. package/lib/src/generated/api/ExportRequest.d.ts +5 -0
  56. package/lib/src/generated/api/ExportRequest.js +2 -0
  57. package/lib/src/generated/api/ExpressionManyRequest.d.ts +3 -0
  58. package/lib/src/generated/api/ExpressionManyRequest.js +2 -0
  59. package/lib/src/generated/api/ExpressionProof.d.ts +4 -0
  60. package/lib/src/generated/api/ExpressionProof.js +2 -0
  61. package/lib/src/generated/api/ExpressionProofInput.d.ts +6 -0
  62. package/lib/src/generated/api/ExpressionProofInput.js +2 -0
  63. package/lib/src/generated/api/FriendSendMessageRequest.d.ts +3 -0
  64. package/lib/src/generated/api/FriendSendMessageRequest.js +2 -0
  65. package/lib/src/generated/api/FriendsListRequest.d.ts +3 -0
  66. package/lib/src/generated/api/FriendsListRequest.js +2 -0
  67. package/lib/src/generated/api/GenerateAgentRequest.d.ts +3 -0
  68. package/lib/src/generated/api/GenerateAgentRequest.js +2 -0
  69. package/lib/src/generated/api/GenerateJwtRequest.d.ts +4 -0
  70. package/lib/src/generated/api/GenerateJwtRequest.js +2 -0
  71. package/lib/src/generated/api/GetSubjectDataRequest.d.ts +4 -0
  72. package/lib/src/generated/api/GetSubjectDataRequest.js +2 -0
  73. package/lib/src/generated/api/ImportAgentRequest.d.ts +6 -0
  74. package/lib/src/generated/api/ImportAgentRequest.js +2 -0
  75. package/lib/src/generated/api/ImportRequest.d.ts +4 -0
  76. package/lib/src/generated/api/ImportRequest.js +2 -0
  77. package/lib/src/generated/api/JoinNeighbourhoodRequest.d.ts +3 -0
  78. package/lib/src/generated/api/JoinNeighbourhoodRequest.js +2 -0
  79. package/lib/src/generated/api/LanguageMetaInput.d.ts +6 -0
  80. package/lib/src/generated/api/LanguageMetaInput.js +2 -0
  81. package/lib/src/generated/api/Link.d.ts +5 -0
  82. package/lib/src/generated/api/Link.js +2 -0
  83. package/lib/src/generated/api/LinkExpression.d.ts +10 -0
  84. package/lib/src/generated/api/LinkExpression.js +1 -0
  85. package/lib/src/generated/api/LinkExpressionInput.d.ts +10 -0
  86. package/lib/src/generated/api/LinkExpressionInput.js +1 -0
  87. package/lib/src/generated/api/LinkInput.d.ts +5 -0
  88. package/lib/src/generated/api/LinkInput.js +2 -0
  89. package/lib/src/generated/api/LinkLanguageTemplatesRequest.d.ts +3 -0
  90. package/lib/src/generated/api/LinkLanguageTemplatesRequest.js +2 -0
  91. package/lib/src/generated/api/LinkMutations.d.ts +6 -0
  92. package/lib/src/generated/api/LinkMutations.js +1 -0
  93. package/lib/src/generated/api/LinkStatus.d.ts +1 -0
  94. package/lib/src/generated/api/LinkStatus.js +2 -0
  95. package/lib/src/generated/api/LockAgentRequest.d.ts +3 -0
  96. package/lib/src/generated/api/LockAgentRequest.js +2 -0
  97. package/lib/src/generated/api/ModelType.d.ts +1 -0
  98. package/lib/src/generated/api/ModelType.js +2 -0
  99. package/lib/src/generated/api/NotificationInput.d.ts +10 -0
  100. package/lib/src/generated/api/NotificationInput.js +2 -0
  101. package/lib/src/generated/api/OpenLinkRequest.d.ts +3 -0
  102. package/lib/src/generated/api/OpenLinkRequest.js +2 -0
  103. package/lib/src/generated/api/PermitCapabilityRequest.d.ts +3 -0
  104. package/lib/src/generated/api/PermitCapabilityRequest.js +2 -0
  105. package/lib/src/generated/api/PerspectiveInput.d.ts +4 -0
  106. package/lib/src/generated/api/PerspectiveInput.js +1 -0
  107. package/lib/src/generated/api/PromptRequest.d.ts +4 -0
  108. package/lib/src/generated/api/PromptRequest.js +2 -0
  109. package/lib/src/generated/api/PublishLanguageRequest.d.ts +5 -0
  110. package/lib/src/generated/api/PublishLanguageRequest.js +1 -0
  111. package/lib/src/generated/api/PublishNeighbourhoodRequest.d.ts +6 -0
  112. package/lib/src/generated/api/PublishNeighbourhoodRequest.js +1 -0
  113. package/lib/src/generated/api/QueryRequest.d.ts +7 -0
  114. package/lib/src/generated/api/QueryRequest.js +2 -0
  115. package/lib/src/generated/api/RemoveLinkRequest.d.ts +5 -0
  116. package/lib/src/generated/api/RemoveLinkRequest.js +1 -0
  117. package/lib/src/generated/api/RemoveLinksBulkRequest.d.ts +5 -0
  118. package/lib/src/generated/api/RemoveLinksBulkRequest.js +1 -0
  119. package/lib/src/generated/api/ResourceInput.d.ts +4 -0
  120. package/lib/src/generated/api/ResourceInput.js +2 -0
  121. package/lib/src/generated/api/SetDefaultModelRequest.d.ts +4 -0
  122. package/lib/src/generated/api/SetDefaultModelRequest.js +1 -0
  123. package/lib/src/generated/api/SetFreeHostingEnabledRequest.d.ts +3 -0
  124. package/lib/src/generated/api/SetFreeHostingEnabledRequest.js +2 -0
  125. package/lib/src/generated/api/SetMultiUserRequest.d.ts +3 -0
  126. package/lib/src/generated/api/SetMultiUserRequest.js +2 -0
  127. package/lib/src/generated/api/SetStatusRequest.d.ts +3 -0
  128. package/lib/src/generated/api/SetStatusRequest.js +2 -0
  129. package/lib/src/generated/api/SignMessageRequest.d.ts +3 -0
  130. package/lib/src/generated/api/SignMessageRequest.js +2 -0
  131. package/lib/src/generated/api/TrustedAgentsRequest.d.ts +3 -0
  132. package/lib/src/generated/api/TrustedAgentsRequest.js +2 -0
  133. package/lib/src/generated/api/UnlockAgentRequest.d.ts +4 -0
  134. package/lib/src/generated/api/UnlockAgentRequest.js +2 -0
  135. package/lib/src/generated/api/UpdateLinkRequest.d.ts +7 -0
  136. package/lib/src/generated/api/UpdateLinkRequest.js +1 -0
  137. package/lib/src/generated/api/UpdatePerspectiveRequest.d.ts +3 -0
  138. package/lib/src/generated/api/UpdatePerspectiveRequest.js +2 -0
  139. package/lib/src/generated/api/UserStatistics.d.ts +9 -0
  140. package/lib/src/generated/api/UserStatistics.js +2 -0
  141. package/lib/src/generated/api/VerificationRequestResult.d.ts +6 -0
  142. package/lib/src/generated/api/VerificationRequestResult.js +2 -0
  143. package/lib/src/generated/api/VerifySignatureRequest.d.ts +5 -0
  144. package/lib/src/generated/api/VerifySignatureRequest.js +2 -0
  145. package/lib/src/generated/api/WriteSettingsRequest.d.ts +3 -0
  146. package/lib/src/generated/api/WriteSettingsRequest.js +2 -0
  147. package/lib/src/generated/api/index.d.ts +42 -0
  148. package/lib/src/generated/api/index.js +7 -0
  149. package/lib/src/index.d.ts +6 -2
  150. package/lib/src/index.js +6 -2
  151. package/lib/src/jestSetup.d.ts +0 -1
  152. package/lib/src/jestSetup.js +1 -1
  153. package/lib/src/language/Icon.js +2 -21
  154. package/lib/src/language/Language.d.ts +26 -214
  155. package/lib/src/language/Language.js +32 -72
  156. package/lib/src/language/LanguageClient.d.ts +2 -2
  157. package/lib/src/language/LanguageClient.js +15 -105
  158. package/lib/src/language/LanguageHandle.js +2 -41
  159. package/lib/src/language/LanguageMeta.js +4 -75
  160. package/lib/src/language/LanguageRef.js +2 -25
  161. package/lib/src/links/Links.js +14 -111
  162. package/lib/src/model/Ad4mModel.d.ts +81 -38
  163. package/lib/src/model/Ad4mModel.js +651 -408
  164. package/lib/src/model/Ad4mModel.test.js +488 -750
  165. package/lib/src/model/ModelQueryBuilder.d.ts +28 -21
  166. package/lib/src/model/ModelQueryBuilder.js +160 -195
  167. package/lib/src/model/decorators.d.ts +22 -0
  168. package/lib/src/model/decorators.js +7 -0
  169. package/lib/src/model/hydration-batching.test.d.ts +7 -0
  170. package/lib/src/model/hydration-batching.test.js +456 -0
  171. package/lib/src/model/hydration.d.ts +8 -60
  172. package/lib/src/model/hydration.js +41 -541
  173. package/lib/src/model/index.d.ts +0 -4
  174. package/lib/src/model/index.js +0 -4
  175. package/lib/src/model/model-manifest.d.ts +41 -0
  176. package/lib/src/model/model-manifest.js +11 -0
  177. package/lib/src/model/query-sparql.d.ts +36 -22
  178. package/lib/src/model/query-sparql.js +188 -53
  179. package/lib/src/model/query-sparql.test.d.ts +1 -0
  180. package/lib/src/model/query-sparql.test.js +312 -0
  181. package/lib/src/model/query-utils.js +4 -0
  182. package/lib/src/model/shacl-gen.js +4 -0
  183. package/lib/src/model/subscription-delta.test.d.ts +24 -0
  184. package/lib/src/model/subscription-delta.test.js +180 -0
  185. package/lib/src/model/subscription-pool.js +48 -2
  186. package/lib/src/model/types.d.ts +58 -1
  187. package/lib/src/model/types.js +4 -1
  188. package/lib/src/neighbourhood/Neighbourhood.js +4 -32
  189. package/lib/src/neighbourhood/NeighbourhoodClient.d.ts +3 -3
  190. package/lib/src/neighbourhood/NeighbourhoodClient.js +40 -203
  191. package/lib/src/perspectives/LinkQuery.js +2 -42
  192. package/lib/src/perspectives/Perspective.d.ts +1 -1
  193. package/lib/src/perspectives/Perspective.js +10 -52
  194. package/lib/src/perspectives/PerspectiveClient.d.ts +12 -15
  195. package/lib/src/perspectives/PerspectiveClient.js +168 -400
  196. package/lib/src/perspectives/PerspectiveClient.test.d.ts +1 -0
  197. package/lib/src/perspectives/PerspectiveClient.test.js +224 -0
  198. package/lib/src/perspectives/PerspectiveDiff.js +4 -31
  199. package/lib/src/perspectives/PerspectiveHandle.js +3 -43
  200. package/lib/src/perspectives/PerspectiveProxy.d.ts +95 -71
  201. package/lib/src/perspectives/PerspectiveProxy.js +288 -310
  202. package/lib/src/runtime/RuntimeClient.d.ts +6 -6
  203. package/lib/src/runtime/RuntimeClient.js +93 -467
  204. package/lib/src/runtime/RuntimeTypes.d.ts +101 -0
  205. package/lib/src/runtime/RuntimeTypes.js +45 -0
  206. package/lib/src/shacl/SHACLShape.d.ts +7 -0
  207. package/lib/src/shacl/SHACLShape.js +19 -0
  208. package/lib/src/shacl/SHACLShape.test.js +82 -0
  209. package/lib/src/typeDefs.js +3 -628
  210. package/package.json +9 -24
  211. package/rollup.config.js +0 -7
  212. package/src/Ad4mClient.test.ts +1182 -1288
  213. package/src/Ad4mClient.ts +30 -15
  214. package/src/agent/Agent.ts +0 -99
  215. package/src/agent/AgentClient.ts +112 -526
  216. package/src/agent/AgentStatus.ts +0 -12
  217. package/src/ai/AIClient.ts +96 -296
  218. package/src/ai/AITypes.ts +66 -0
  219. package/src/ai/Tasks.ts +0 -52
  220. package/src/apiClient.ts +283 -0
  221. package/src/expression/Expression.ts +3 -43
  222. package/src/expression/ExpressionClient.ts +14 -77
  223. package/src/expression/ExpressionRef.ts +0 -6
  224. package/src/generated/api/AIModelLoadingStatus.ts +3 -0
  225. package/src/generated/api/AddLinkExpressionRequest.ts +4 -0
  226. package/src/generated/api/AddLinkRequest.ts +4 -0
  227. package/src/generated/api/AddLinksBulkRequest.ts +4 -0
  228. package/src/generated/api/AddSdnaRequest.ts +3 -0
  229. package/src/generated/api/ApplyTemplateRequest.ts +3 -0
  230. package/src/generated/api/AuthInfoInput.ts +4 -0
  231. package/src/generated/api/CapabilityInput.ts +4 -0
  232. package/src/generated/api/CommitBatchRequest.ts +3 -0
  233. package/src/generated/api/ComputeLogEntry.ts +3 -0
  234. package/src/generated/api/CreateExpressionRequest.ts +3 -0
  235. package/src/generated/api/CreatePerspectiveRequest.ts +3 -0
  236. package/src/generated/api/CreateSubjectRequest.ts +3 -0
  237. package/src/generated/api/EmbedRequest.ts +3 -0
  238. package/src/generated/api/EntanglementProofInput.ts +3 -0
  239. package/src/generated/api/ExecuteCommandsRequest.ts +3 -0
  240. package/src/generated/api/ExportRequest.ts +3 -0
  241. package/src/generated/api/ExpressionManyRequest.ts +3 -0
  242. package/src/generated/api/ExpressionProof.ts +3 -0
  243. package/src/generated/api/ExpressionProofInput.ts +3 -0
  244. package/src/generated/api/FriendSendMessageRequest.ts +3 -0
  245. package/src/generated/api/FriendsListRequest.ts +3 -0
  246. package/src/generated/api/GenerateAgentRequest.ts +3 -0
  247. package/src/generated/api/GenerateJwtRequest.ts +3 -0
  248. package/src/generated/api/GetSubjectDataRequest.ts +3 -0
  249. package/src/generated/api/ImportAgentRequest.ts +3 -0
  250. package/src/generated/api/ImportRequest.ts +3 -0
  251. package/src/generated/api/JoinNeighbourhoodRequest.ts +3 -0
  252. package/src/generated/api/LanguageMetaInput.ts +3 -0
  253. package/src/generated/api/Link.ts +3 -0
  254. package/src/generated/api/LinkExpression.ts +6 -0
  255. package/src/generated/api/LinkExpressionInput.ts +6 -0
  256. package/src/generated/api/LinkInput.ts +3 -0
  257. package/src/generated/api/LinkLanguageTemplatesRequest.ts +3 -0
  258. package/src/generated/api/LinkMutations.ts +5 -0
  259. package/src/generated/api/LinkStatus.ts +3 -0
  260. package/src/generated/api/LockAgentRequest.ts +3 -0
  261. package/src/generated/api/ModelType.ts +3 -0
  262. package/src/generated/api/NotificationInput.ts +3 -0
  263. package/src/generated/api/OpenLinkRequest.ts +3 -0
  264. package/src/generated/api/PermitCapabilityRequest.ts +3 -0
  265. package/src/generated/api/PerspectiveInput.ts +4 -0
  266. package/src/generated/api/PromptRequest.ts +3 -0
  267. package/src/generated/api/PublishLanguageRequest.ts +4 -0
  268. package/src/generated/api/PublishNeighbourhoodRequest.ts +4 -0
  269. package/src/generated/api/QueryRequest.ts +6 -0
  270. package/src/generated/api/RemoveLinkRequest.ts +4 -0
  271. package/src/generated/api/RemoveLinksBulkRequest.ts +4 -0
  272. package/src/generated/api/ResourceInput.ts +3 -0
  273. package/src/generated/api/SetDefaultModelRequest.ts +4 -0
  274. package/src/generated/api/SetFreeHostingEnabledRequest.ts +3 -0
  275. package/src/generated/api/SetMultiUserRequest.ts +3 -0
  276. package/src/generated/api/SetStatusRequest.ts +3 -0
  277. package/src/generated/api/SignMessageRequest.ts +3 -0
  278. package/src/generated/api/TrustedAgentsRequest.ts +3 -0
  279. package/src/generated/api/UnlockAgentRequest.ts +3 -0
  280. package/src/generated/api/UpdateLinkRequest.ts +5 -0
  281. package/src/generated/api/UpdatePerspectiveRequest.ts +3 -0
  282. package/src/generated/api/UserStatistics.ts +3 -0
  283. package/src/generated/api/VerificationRequestResult.ts +3 -0
  284. package/src/generated/api/VerifySignatureRequest.ts +3 -0
  285. package/src/generated/api/WriteSettingsRequest.ts +3 -0
  286. package/src/generated/api/index.ts +49 -0
  287. package/src/index.ts +6 -2
  288. package/src/jestSetup.ts +1 -1
  289. package/src/language/Icon.ts +0 -4
  290. package/src/language/Language.ts +50 -292
  291. package/src/language/LanguageClient.ts +21 -132
  292. package/src/language/LanguageHandle.ts +0 -14
  293. package/src/language/LanguageMeta.ts +0 -29
  294. package/src/language/LanguageRef.ts +0 -7
  295. package/src/links/Links.ts +0 -37
  296. package/src/model/Ad4mModel.test.ts +827 -808
  297. package/src/model/Ad4mModel.ts +676 -457
  298. package/src/model/ModelQueryBuilder.ts +199 -217
  299. package/src/model/decorators.ts +29 -0
  300. package/src/model/hydration.ts +17 -572
  301. package/src/model/index.ts +0 -4
  302. package/src/model/query-sparql.test.ts +360 -0
  303. package/src/model/query-sparql.ts +203 -56
  304. package/src/model/query-utils.ts +4 -0
  305. package/src/model/shacl-gen.ts +5 -0
  306. package/src/model/types.ts +62 -1
  307. package/src/neighbourhood/Neighbourhood.ts +0 -9
  308. package/src/neighbourhood/NeighbourhoodClient.ts +42 -207
  309. package/src/neighbourhood/NeighbourhoodProxy.test.ts +34 -36
  310. package/src/perspectives/LinkQuery.ts +0 -15
  311. package/src/perspectives/Perspective.ts +1 -12
  312. package/src/perspectives/PerspectiveClient.test.ts +262 -0
  313. package/src/perspectives/PerspectiveClient.ts +227 -412
  314. package/src/perspectives/PerspectiveDiff.ts +0 -8
  315. package/src/perspectives/PerspectiveHandle.ts +1 -12
  316. package/src/perspectives/PerspectiveProxy.test.ts +41 -0
  317. package/src/perspectives/PerspectiveProxy.ts +325 -348
  318. package/src/runtime/RuntimeClient.ts +112 -474
  319. package/src/runtime/RuntimeTypes.ts +144 -0
  320. package/src/shacl/SHACLShape.test.ts +94 -0
  321. package/src/shacl/SHACLShape.ts +27 -0
  322. package/src/typeDefs.ts +3 -5
  323. package/tsconfig.json +3 -7
  324. package/lib/src/model/query-surreal.d.ts +0 -44
  325. package/lib/src/model/query-surreal.js +0 -249
  326. package/lib/src/model/surreal-utils.d.ts +0 -42
  327. package/lib/src/model/surreal-utils.js +0 -128
  328. package/shims/reflect-metadata.ts +0 -0
  329. package/shims/type-graphql.ts +0 -75
  330. package/src/PubSub.ts +0 -17
  331. package/src/agent/AgentResolver.ts +0 -263
  332. package/src/ai/AIResolver.ts +0 -372
  333. package/src/buildSchema.ts +0 -43
  334. package/src/expression/ExpressionResolver.ts +0 -64
  335. package/src/language/LanguageContext.ts +0 -37
  336. package/src/language/LanguageResolver.ts +0 -98
  337. package/src/model/Subject.ts +0 -159
  338. package/src/model/hydration-batch.ts +0 -205
  339. package/src/model/prolog-facts.ts +0 -145
  340. package/src/model/query-prolog.ts +0 -148
  341. package/src/model/query-sparql-batch.ts +0 -301
  342. package/src/model/subscription-pool.ts +0 -163
  343. package/src/neighbourhood/NeighbourhoodResolver.ts +0 -100
  344. package/src/perspectives/PerspectiveResolver.ts +0 -364
  345. package/src/runtime/RuntimeResolver.ts +0 -749
  346. package/src/unwrapApolloResult.ts +0 -16
  347. package/tsconfig-browser.json +0 -82
@@ -1,301 +0,0 @@
1
- /**
2
- * Batch SPARQL query builder for Ad4mModel eager-loading (includes).
3
- *
4
- * Uses direct triple + named graph storage model.
5
- * Each AD4M link is stored as: <source> <predicate> <target> in a named graph
6
- * with metadata in the default graph keyed by graph IRI.
7
- *
8
- * @module
9
- */
10
-
11
- import { resolveParentPredicate } from "./query-common";
12
- import { getRelationsMetadata } from "./decorators";
13
- import type { RelationMetadataEntry } from "./decorators";
14
- import { formatSPARQLValue } from "./query-sparql";
15
- import { Literal } from "../Literal";
16
- import type { Query, IncludeMap, ModelMetadata, PropertyMetadata } from "./types";
17
-
18
- // ──────────────────────────────────────────────────────────
19
- // Helpers
20
- // ──────────────────────────────────────────────────────────
21
-
22
- function iri(value: string): string {
23
- return `<${value}>`;
24
- }
25
-
26
- /**
27
- * Check if a string value looks like a URI (has a scheme).
28
- */
29
- function looksLikeUri(value: string): boolean {
30
- return /^[a-zA-Z][a-zA-Z0-9+\-._]*:/.test(value);
31
- }
32
-
33
- /**
34
- * Convert a JS value to its literal: IRI form.
35
- */
36
- function valueToLiteralIri(value: any): string {
37
- if (typeof value === 'string') {
38
- if (looksLikeUri(value)) return value;
39
- return Literal.from(value).toUrl();
40
- }
41
- if (typeof value === 'number') return Literal.from(value).toUrl();
42
- if (typeof value === 'boolean') return Literal.from(value).toUrl();
43
- return Literal.from(String(value)).toUrl();
44
- }
45
-
46
- /**
47
- * Determine if a property stores values as literal: IRIs.
48
- */
49
- function isLiteralStoredProperty(propMeta: PropertyMetadata): boolean {
50
- if (propMeta.flag) return false;
51
- if (propMeta.resolveLanguage && propMeta.resolveLanguage !== "literal") return false;
52
- return true;
53
- }
54
-
55
- interface DepthBranch {
56
- depth: number;
57
- relationName: string;
58
- parentDepth: number;
59
- parentPredicate: string;
60
- targetClass: any;
61
- targetMetadata: ModelMetadata;
62
- includeMap?: IncludeMap;
63
- direction: 'forward' | 'reverse';
64
- }
65
-
66
- function buildConformanceJoins(metadata: ModelMetadata, sourceVar: string, prefix: string): { joins: string[]; filters: string[] } {
67
- const joins: string[] = [];
68
- const filters: string[] = [];
69
- let hasConformance = false;
70
-
71
- for (const [, propMeta] of Object.entries(metadata.properties)) {
72
- if (propMeta.required) {
73
- if (propMeta.getter) continue;
74
- hasConformance = true;
75
- if (propMeta.flag && propMeta.initial) {
76
- joins.push(`
77
- ${sourceVar} ${iri(propMeta.predicate)} ${iri(propMeta.initial)} .`);
78
- } else {
79
- joins.push(`
80
- ${sourceVar} ${iri(propMeta.predicate)} ?${prefix}_cfTarget_${propMeta.name} .`);
81
- }
82
- }
83
- }
84
-
85
- if (!hasConformance) {
86
- for (const [, propMeta] of Object.entries(metadata.properties)) {
87
- if (propMeta.initial) {
88
- if (propMeta.flag) {
89
- joins.push(`
90
- ${sourceVar} ${iri(propMeta.predicate)} ${iri(propMeta.initial)} .`);
91
- } else {
92
- joins.push(`
93
- ${sourceVar} ${iri(propMeta.predicate)} ?${prefix}_cfInitAny_${propMeta.name} .`);
94
- }
95
- break;
96
- }
97
- }
98
- }
99
-
100
- return { joins, filters };
101
- }
102
-
103
- function flattenIncludeTree(
104
- parentDepth: number,
105
- parentClass: any,
106
- includeMap: IncludeMap,
107
- nextDepth: { value: number },
108
- ): DepthBranch[] {
109
- const branches: DepthBranch[] = [];
110
- const relMeta = getRelationsMetadata(parentClass);
111
-
112
- for (const [relName, includeValue] of Object.entries(includeMap)) {
113
- const meta: RelationMetadataEntry | undefined = relMeta[relName];
114
- if (!meta || !meta.target) continue;
115
-
116
- const TargetClass = meta.target();
117
- const targetMetadata: ModelMetadata = (TargetClass as any).getModelMetadata
118
- ? (TargetClass as any).getModelMetadata()
119
- : { className: "Unknown", properties: {}, relations: {} };
120
-
121
- const depth = nextDepth.value++;
122
- const direction = meta.kind === 'belongsToOne' || meta.kind === 'belongsToMany'
123
- ? 'reverse' : 'forward';
124
-
125
- const nestedInclude = typeof includeValue === 'object' && includeValue !== null
126
- ? (includeValue as any).include
127
- : undefined;
128
-
129
- branches.push({
130
- depth,
131
- relationName: relName,
132
- parentDepth,
133
- parentPredicate: meta.predicate,
134
- targetClass: TargetClass,
135
- targetMetadata,
136
- includeMap: nestedInclude,
137
- direction,
138
- });
139
-
140
- if (nestedInclude) {
141
- branches.push(...flattenIncludeTree(depth, TargetClass, nestedInclude, nextDepth));
142
- }
143
- }
144
-
145
- return branches;
146
- }
147
-
148
- // ──────────────────────────────────────────────────────────
149
- // Main entry point
150
- // ──────────────────────────────────────────────────────────
151
-
152
- /**
153
- * Build a single SPARQL query that fetches root instances plus all
154
- * included relations in one query using UNION branches.
155
- *
156
- * Uses direct triple patterns in named graphs with metadata in default graph.
157
- */
158
- export function buildBatchSPARQLQuery(
159
- rootMetadata: ModelMetadata,
160
- query: Query,
161
- rootModelClass: any,
162
- ): string {
163
- const includeMap = query.include;
164
- if (!includeMap || Object.keys(includeMap).length === 0) {
165
- throw new Error("buildBatchSPARQLQuery requires query.include to be non-empty");
166
- }
167
-
168
- const nextDepth = { value: 1 };
169
- const branches = flattenIncludeTree(0, rootModelClass, includeMap, nextDepth);
170
-
171
- // Root conformance
172
- const rootConformance = buildConformanceJoins(rootMetadata, "?source", "root");
173
- const rootJoins = [...rootConformance.joins];
174
- const rootFilters = [...rootConformance.filters];
175
-
176
- if (query.parent) {
177
- const parentPredicate = resolveParentPredicate(query.parent, rootModelClass);
178
- rootJoins.push(`
179
- ${iri(query.parent.id)} ${iri(parentPredicate)} ?source .`);
180
- }
181
-
182
- if (query.where) {
183
- for (const [propertyName, condition] of Object.entries(query.where)) {
184
- if (propertyName === "base" || propertyName === "id") {
185
- if (Array.isArray(condition)) {
186
- const formatted = (condition as any[]).map(v => iri(v)).join(", ");
187
- rootFilters.push(`?source IN (${formatted})`);
188
- } else if (typeof condition === "string") {
189
- rootFilters.push(`?source = ${iri(condition)}`);
190
- }
191
- continue;
192
- }
193
- if (propertyName === "author" || propertyName === "timestamp") continue;
194
-
195
- const propMeta = rootMetadata.properties[propertyName];
196
- if (!propMeta) continue;
197
-
198
- const useParseLiteral = isLiteralStoredProperty(propMeta);
199
-
200
- if (typeof condition === "string" || typeof condition === "number" || typeof condition === "boolean") {
201
- if (useParseLiteral) {
202
- // For literal-stored properties, just add a join for conformance — filtering is done in JS
203
- rootJoins.push(`
204
- ?source ${iri(propMeta.predicate)} ?root_wTarget_eq_${propertyName} .`);
205
- } else {
206
- rootJoins.push(`
207
- ?source ${iri(propMeta.predicate)} ${iri(String(condition))} .`);
208
- }
209
- } else if (Array.isArray(condition)) {
210
- if (useParseLiteral) {
211
- // For literal-stored properties, just add a join for conformance — filtering is done in JS
212
- rootJoins.push(`
213
- ?source ${iri(propMeta.predicate)} ?root_wTarget_${propertyName} .`);
214
- } else {
215
- const formatted = (condition as any[]).map(v => iri(v)).join(", ");
216
- rootJoins.push(`
217
- ?source ${iri(propMeta.predicate)} ?root_wTarget_${propertyName} .`);
218
- rootFilters.push(`?root_wTarget_${propertyName} IN (${formatted})`);
219
- }
220
- }
221
- }
222
- }
223
-
224
- const rootJoinClause = rootJoins.join("\n");
225
- const rootFilterClause = rootFilters.length > 0
226
- ? `FILTER(\n ${rootFilters.join(" &&\n ")}\n )`
227
- : "";
228
-
229
- const unionBranches: string[] = [];
230
-
231
- // Depth 0: root — direct triple pattern with named graph
232
- unionBranches.push(`
233
- {
234
- ${rootJoinClause}
235
- GRAPH ?linkGraph { ?source ?predicate ?target . }
236
- FILTER(isIRI(?source) && isIRI(?predicate))
237
- ?linkGraph <ad4m://ontology/author> ?author .
238
- ?linkGraph <ad4m://ontology/timestamp> ?timestamp .
239
- ${rootFilterClause}
240
- BIND("0" AS ?depth)
241
- BIND("" AS ?parentBase)
242
- BIND("" AS ?relationName)
243
- }
244
- `);
245
-
246
- // Depth N: include branches
247
- for (const branch of branches) {
248
- const childConformance = buildConformanceJoins(branch.targetMetadata, "?source", `d${branch.depth}`);
249
- const childJoinClause = childConformance.joins.join("\n");
250
- const childFilterClause = childConformance.filters.length > 0
251
- ? `FILTER(\n ${childConformance.filters.join(" &&\n ")}\n )`
252
- : "";
253
-
254
- const parentJoinClause = branch.parentDepth === 0 ? rootJoinClause.replace(/\?source/g, '?parentBase') : '';
255
- const parentFilterClause = branch.parentDepth === 0 ? rootFilterClause.replace(/\?source/g, '?parentBase') : '';
256
-
257
- if (branch.direction === 'forward') {
258
- // Forward: parent --predicate--> child (source)
259
- unionBranches.push(`
260
- {
261
- # Depth ${branch.depth}: ${branch.relationName} (forward)
262
- ?parentBase ${iri(branch.parentPredicate)} ?source .
263
- ${childJoinClause}
264
- GRAPH ?linkGraph { ?source ?predicate ?target . }
265
- FILTER(isIRI(?source) && isIRI(?predicate))
266
- ?linkGraph <ad4m://ontology/author> ?author .
267
- ?linkGraph <ad4m://ontology/timestamp> ?timestamp .
268
- ${childFilterClause}
269
- ${parentJoinClause}
270
- ${parentFilterClause}
271
- BIND("${branch.depth}" AS ?depth)
272
- BIND("${branch.relationName}" AS ?relationName)
273
- }
274
- `);
275
- } else {
276
- // Reverse: child (source) --predicate--> parent
277
- unionBranches.push(`
278
- {
279
- # Depth ${branch.depth}: ${branch.relationName} (reverse)
280
- ?source ${iri(branch.parentPredicate)} ?parentBase .
281
- ${childJoinClause}
282
- GRAPH ?linkGraph { ?source ?predicate ?target . }
283
- FILTER(isIRI(?source) && isIRI(?predicate))
284
- ?linkGraph <ad4m://ontology/author> ?author .
285
- ?linkGraph <ad4m://ontology/timestamp> ?timestamp .
286
- ${childFilterClause}
287
- ${parentJoinClause}
288
- ${parentFilterClause}
289
- BIND("${branch.depth}" AS ?depth)
290
- BIND("${branch.relationName}" AS ?relationName)
291
- }
292
- `);
293
- }
294
- }
295
-
296
- return `
297
- SELECT ?depth ?parentBase ?relationName ?source ?predicate ?target ?author ?timestamp WHERE {
298
- ${unionBranches.join("\n UNION\n")}
299
- }
300
- `.trim();
301
- }
@@ -1,163 +0,0 @@
1
- /**
2
- * Subscription Pool — deduplicates identical SPARQL subscriptions.
3
- *
4
- * When multiple UI components subscribe to the same SPARQL query on the same
5
- * perspective, the pool shares a single `subscribeQuery()` call and distributes
6
- * results to all registered callbacks. Hydration happens once per result set,
7
- * then is shared across all subscribers.
8
- *
9
- * Key: `perspectiveUUID + sparqlQuery`
10
- */
11
-
12
- import type { PerspectiveProxy } from "../perspectives/PerspectiveProxy";
13
-
14
- type HydrateCallback = (rawResult: any) => Promise<any>;
15
- type ResultCallback = (hydratedResult: any) => void;
16
-
17
- interface PoolEntry {
18
- /** The underlying subscription from perspective.subscribeQuery() */
19
- subscription: any;
20
- /** All registered callbacks */
21
- callbacks: Set<{ onResult: ResultCallback; hydrate: HydrateCallback }>;
22
- /** Latest raw result (for new subscribers joining late) */
23
- latestRaw: any;
24
- /** Latest hydrated result */
25
- latestHydrated: any;
26
- /** Whether hydration is in flight */
27
- hydrating: boolean;
28
- /** Reference count for disposal */
29
- refCount: number;
30
- }
31
-
32
- const pool = new Map<string, PoolEntry>();
33
-
34
- function makeKey(perspectiveUUID: string, sparqlQuery: string): string {
35
- return `${perspectiveUUID}::${sparqlQuery}`;
36
- }
37
-
38
- export interface PooledSubscription {
39
- /** The initial (hydrated) result */
40
- initialResult: any;
41
- /** Unsubscribe this particular callback from the pool */
42
- dispose: () => void;
43
- }
44
-
45
- /**
46
- * Subscribe to a SPARQL query, sharing the underlying subscription
47
- * with any other subscribers using the same perspective + query.
48
- *
49
- * @param perspective - The perspective proxy
50
- * @param sparqlQuery - The SPARQL query text
51
- * @param hydrate - Async function that takes raw SPARQL results and returns hydrated results
52
- * @param onResult - Callback for subsequent result updates (hydrated)
53
- * @returns PooledSubscription with initial result and dispose function
54
- */
55
- export async function pooledSubscribe(
56
- perspective: PerspectiveProxy,
57
- sparqlQuery: string,
58
- hydrate: HydrateCallback,
59
- onResult: ResultCallback,
60
- ): Promise<PooledSubscription> {
61
- const uuid = (perspective as any).uuid || (perspective as any).handle?.uuid || '';
62
- const key = makeKey(uuid, sparqlQuery);
63
-
64
- const entry = pool.get(key);
65
- const subscriber = { onResult, hydrate };
66
-
67
- if (entry) {
68
- // Join existing subscription
69
- entry.callbacks.add(subscriber);
70
- entry.refCount++;
71
-
72
- // Hydrate latest result for this new subscriber
73
- let initialResult: any;
74
- if (entry.latestHydrated !== undefined) {
75
- initialResult = entry.latestHydrated;
76
- } else if (entry.latestRaw !== undefined) {
77
- initialResult = await hydrate(entry.latestRaw);
78
- }
79
-
80
- return {
81
- initialResult,
82
- dispose: () => disposeSubscriber(key, subscriber),
83
- };
84
- }
85
-
86
- // Create new subscription
87
- const subscription = await perspective.subscribeQuery(sparqlQuery);
88
-
89
- const newEntry: PoolEntry = {
90
- subscription,
91
- callbacks: new Set([subscriber]),
92
- latestRaw: subscription.result,
93
- latestHydrated: undefined,
94
- hydrating: false,
95
- refCount: 1,
96
- };
97
-
98
- pool.set(key, newEntry);
99
-
100
- // Set up shared result handler
101
- subscription.onResult(async (rawResult: any) => {
102
- newEntry.latestRaw = rawResult;
103
- newEntry.hydrating = true;
104
- try {
105
- // Hydrate ONCE using the first subscriber's hydrate function
106
- const firstSub = newEntry.callbacks.values().next().value;
107
- if (firstSub) {
108
- const hydrated = await firstSub.hydrate(rawResult);
109
- newEntry.latestHydrated = hydrated;
110
- // Distribute to all callbacks
111
- for (const cb of newEntry.callbacks) {
112
- try { cb.onResult(hydrated); } catch (e) { /* subscriber error */ }
113
- }
114
- }
115
- } finally {
116
- newEntry.hydrating = false;
117
- }
118
- });
119
-
120
- // Hydrate initial result
121
- const initialResult = await hydrate(subscription.result);
122
- newEntry.latestHydrated = initialResult;
123
-
124
- return {
125
- initialResult,
126
- dispose: () => disposeSubscriber(key, subscriber),
127
- };
128
- }
129
-
130
- function disposeSubscriber(key: string, subscriber: { onResult: ResultCallback; hydrate: HydrateCallback }): void {
131
- const entry = pool.get(key);
132
- if (!entry) return;
133
-
134
- entry.callbacks.delete(subscriber);
135
- entry.refCount--;
136
-
137
- if (entry.refCount <= 0) {
138
- // Last subscriber — tear down the underlying subscription
139
- if (entry.subscription?.dispose) {
140
- entry.subscription.dispose();
141
- }
142
- pool.delete(key);
143
- }
144
- }
145
-
146
- /**
147
- * Clear the entire pool (for testing).
148
- */
149
- export function clearSubscriptionPool(): void {
150
- for (const entry of pool.values()) {
151
- if (entry.subscription?.dispose) {
152
- entry.subscription.dispose();
153
- }
154
- }
155
- pool.clear();
156
- }
157
-
158
- /**
159
- * Get the current pool size (for testing).
160
- */
161
- export function subscriptionPoolSize(): number {
162
- return pool.size;
163
- }
@@ -1,100 +0,0 @@
1
- import { Arg, Mutation, Query, Resolver, Subscription, PubSub } from "type-graphql";
2
- import { PerspectiveHandle, PerspectiveState } from "../perspectives/PerspectiveHandle";
3
- import { Perspective, PerspectiveExpression, PerspectiveInput, PerspectiveUnsignedInput } from "../perspectives/Perspective";
4
- import { DID } from "../DID";
5
- import { TEST_AGENT_DID } from "../agent/AgentResolver";
6
- import { OnlineAgent } from "../language/Language";
7
- import { testLink } from "../perspectives/PerspectiveResolver";
8
- import { NEIGHBOURHOOD_SIGNAL_RECEIVED_TOPIC, PERSPECTIVE_UPDATED_TOPIC } from "../PubSub";
9
-
10
- const testPerspectiveExpression = new PerspectiveExpression()
11
- testPerspectiveExpression.author = TEST_AGENT_DID
12
- testPerspectiveExpression.timestamp = new Date().toISOString()
13
- testPerspectiveExpression.data = new Perspective([testLink])
14
- testPerspectiveExpression.proof = {
15
- signature: '',
16
- key: '',
17
- valid: true
18
- }
19
-
20
- /**
21
- * Resolver classes are used here to define the GraphQL schema
22
- * (through the type-graphql annotations)
23
- * and are spawned in the client tests in Ad4mClient.test.ts.
24
- * For the latter, they return test fixtures.
25
- */
26
- @Resolver()
27
- export default class NeighbourhoodResolver {
28
- @Mutation(returns => String)
29
- neighbourhoodPublishFromPerspective(
30
- @Arg('perspectiveUUID') perspectiveUUID: string,
31
- @Arg('linkLanguage') linkLanguage: string,
32
- @Arg('meta') meta: PerspectiveInput
33
- ): string {
34
- return "neighbourhood://neighbourhoodAddress"
35
- }
36
-
37
- @Mutation(returns => PerspectiveHandle)
38
- neighbourhoodJoinFromUrl(@Arg('url') url: string, @PubSub() pubSub: any): PerspectiveHandle {
39
- const perspective = new PerspectiveHandle
40
- perspective.name = "test-perspective"
41
- perspective.sharedUrl = url
42
- perspective.uuid = "234234234"
43
- perspective.state = PerspectiveState.Synced
44
- pubSub.publish(PERSPECTIVE_UPDATED_TOPIC, { perspective});
45
- return perspective
46
- }
47
-
48
- @Query(returns => [String])
49
- neighbourhoodOtherAgents(@Arg('perspectiveUUID') perspectiveUUID: string): DID[] {
50
- return ['did:test:other']
51
- }
52
-
53
- @Query()
54
- neighbourhoodHasTelepresenceAdapter(@Arg('perspectiveUUID') perspectiveUUID: string): boolean {
55
- return true
56
- }
57
-
58
- @Query(returns => [OnlineAgent])
59
- neighbourhoodOnlineAgents(@Arg('perspectiveUUID') perspectiveUUID: string): OnlineAgent[] {
60
- const onlineAgent = new OnlineAgent()
61
- onlineAgent.did = 'did:test:online'
62
- onlineAgent.status = testPerspectiveExpression
63
- return [onlineAgent]
64
- }
65
-
66
- @Mutation()
67
- neighbourhoodSetOnlineStatus(@Arg('perspectiveUUID') perspectiveUUID: string, @Arg('status') status: PerspectiveInput): boolean {
68
- return true
69
- }
70
-
71
- @Mutation()
72
- neighbourhoodSetOnlineStatusU(@Arg('perspectiveUUID') perspectiveUUID: string, @Arg('status') status: PerspectiveUnsignedInput): boolean {
73
- return true
74
- }
75
-
76
- @Mutation()
77
- neighbourhoodSendSignal(@Arg('perspectiveUUID') perspectiveUUID: string, @Arg('remoteAgentDid') recipient: DID, @Arg('payload') signal: PerspectiveInput): boolean {
78
- return true
79
- }
80
-
81
- @Mutation()
82
- neighbourhoodSendSignalU(@Arg('perspectiveUUID') perspectiveUUID: string, @Arg('remoteAgentDid') recipient: DID, @Arg('payload') signal: PerspectiveUnsignedInput): boolean {
83
- return true
84
- }
85
-
86
- @Mutation()
87
- neighbourhoodSendBroadcast(@Arg('perspectiveUUID') perspectiveUUID: string, @Arg('payload') signal: PerspectiveInput, @Arg('loopback', { nullable: true }) loopback?: boolean): boolean {
88
- return true
89
- }
90
-
91
- @Mutation()
92
- neighbourhoodSendBroadcastU(@Arg('perspectiveUUID') perspectiveUUID: string, @Arg('payload') signal: PerspectiveUnsignedInput, @Arg('loopback', { nullable: true }) loopback?: boolean): boolean {
93
- return true
94
- }
95
-
96
- @Subscription({topics: NEIGHBOURHOOD_SIGNAL_RECEIVED_TOPIC, nullable: true})
97
- neighbourhoodSignal(@Arg('perspectiveUUID') pID: string): PerspectiveExpression {
98
- return testPerspectiveExpression
99
- }
100
- }