@coasys/ad4m 0.13.0-test-3 → 0.13.0-test-5

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 (337) hide show
  1. package/README.md +2 -25
  2. package/jest-setup.ts +1 -1
  3. package/lib/index.cjs +6717 -15519
  4. package/lib/index.js +4811 -13662
  5. package/lib/src/Ad4mClient.d.ts +7 -3
  6. package/lib/src/Ad4mClient.js +39 -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 -1
  150. package/lib/src/index.js +6 -1
  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 +1 -1
  155. package/lib/src/language/Language.js +10 -76
  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 +76 -44
  163. package/lib/src/model/Ad4mModel.js +635 -479
  164. package/lib/src/model/Ad4mModel.test.js +371 -815
  165. package/lib/src/model/ModelQueryBuilder.d.ts +15 -27
  166. package/lib/src/model/ModelQueryBuilder.js +163 -224
  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.d.ts +3 -93
  170. package/lib/src/model/hydration.js +3 -970
  171. package/lib/src/model/index.d.ts +0 -4
  172. package/lib/src/model/index.js +0 -4
  173. package/lib/src/model/model-manifest.d.ts +41 -0
  174. package/lib/src/model/model-manifest.js +11 -0
  175. package/lib/src/model/query-sparql.d.ts +4 -67
  176. package/lib/src/model/query-sparql.js +26 -322
  177. package/lib/src/model/query-sparql.test.js +35 -218
  178. package/lib/src/model/query-utils.d.ts +1 -0
  179. package/lib/src/model/query-utils.js +46 -1
  180. package/lib/src/model/shacl-gen.js +4 -0
  181. package/lib/src/model/types.d.ts +51 -43
  182. package/lib/src/model/types.js +4 -1
  183. package/lib/src/neighbourhood/Neighbourhood.js +4 -32
  184. package/lib/src/neighbourhood/NeighbourhoodClient.d.ts +3 -3
  185. package/lib/src/neighbourhood/NeighbourhoodClient.js +40 -203
  186. package/lib/src/perspectives/LinkQuery.js +2 -42
  187. package/lib/src/perspectives/Perspective.d.ts +1 -1
  188. package/lib/src/perspectives/Perspective.js +10 -52
  189. package/lib/src/perspectives/PerspectiveClient.d.ts +13 -17
  190. package/lib/src/perspectives/PerspectiveClient.js +179 -429
  191. package/lib/src/perspectives/PerspectiveClient.test.js +55 -0
  192. package/lib/src/perspectives/PerspectiveDiff.js +4 -31
  193. package/lib/src/perspectives/PerspectiveHandle.js +3 -43
  194. package/lib/src/perspectives/PerspectiveProxy.d.ts +106 -71
  195. package/lib/src/perspectives/PerspectiveProxy.js +289 -310
  196. package/lib/src/runtime/RuntimeClient.d.ts +6 -6
  197. package/lib/src/runtime/RuntimeClient.js +93 -467
  198. package/lib/src/runtime/RuntimeTypes.d.ts +101 -0
  199. package/lib/src/runtime/RuntimeTypes.js +45 -0
  200. package/lib/src/shacl/SHACLShape.d.ts +7 -0
  201. package/lib/src/shacl/SHACLShape.js +19 -0
  202. package/lib/src/shacl/SHACLShape.test.js +82 -0
  203. package/lib/src/typeDefs.js +3 -628
  204. package/package.json +6 -18
  205. package/rollup.config.js +0 -7
  206. package/src/Ad4mClient.test.ts +1179 -1340
  207. package/src/Ad4mClient.ts +40 -15
  208. package/src/agent/Agent.ts +0 -99
  209. package/src/agent/AgentClient.ts +112 -526
  210. package/src/agent/AgentStatus.ts +0 -12
  211. package/src/ai/AIClient.ts +96 -296
  212. package/src/ai/AITypes.ts +66 -0
  213. package/src/ai/Tasks.ts +0 -52
  214. package/src/apiClient.ts +283 -0
  215. package/src/expression/Expression.ts +3 -43
  216. package/src/expression/ExpressionClient.ts +14 -77
  217. package/src/expression/ExpressionRef.ts +0 -6
  218. package/src/generated/api/AIModelLoadingStatus.ts +3 -0
  219. package/src/generated/api/AddLinkExpressionRequest.ts +4 -0
  220. package/src/generated/api/AddLinkRequest.ts +4 -0
  221. package/src/generated/api/AddLinksBulkRequest.ts +4 -0
  222. package/src/generated/api/AddSdnaRequest.ts +3 -0
  223. package/src/generated/api/ApplyTemplateRequest.ts +3 -0
  224. package/src/generated/api/AuthInfoInput.ts +4 -0
  225. package/src/generated/api/CapabilityInput.ts +4 -0
  226. package/src/generated/api/CommitBatchRequest.ts +3 -0
  227. package/src/generated/api/ComputeLogEntry.ts +3 -0
  228. package/src/generated/api/CreateExpressionRequest.ts +3 -0
  229. package/src/generated/api/CreatePerspectiveRequest.ts +3 -0
  230. package/src/generated/api/CreateSubjectRequest.ts +3 -0
  231. package/src/generated/api/EmbedRequest.ts +3 -0
  232. package/src/generated/api/EntanglementProofInput.ts +3 -0
  233. package/src/generated/api/ExecuteCommandsRequest.ts +3 -0
  234. package/src/generated/api/ExportRequest.ts +3 -0
  235. package/src/generated/api/ExpressionManyRequest.ts +3 -0
  236. package/src/generated/api/ExpressionProof.ts +3 -0
  237. package/src/generated/api/ExpressionProofInput.ts +3 -0
  238. package/src/generated/api/FriendSendMessageRequest.ts +3 -0
  239. package/src/generated/api/FriendsListRequest.ts +3 -0
  240. package/src/generated/api/GenerateAgentRequest.ts +3 -0
  241. package/src/generated/api/GenerateJwtRequest.ts +3 -0
  242. package/src/generated/api/GetSubjectDataRequest.ts +3 -0
  243. package/src/generated/api/ImportAgentRequest.ts +3 -0
  244. package/src/generated/api/ImportRequest.ts +3 -0
  245. package/src/generated/api/JoinNeighbourhoodRequest.ts +3 -0
  246. package/src/generated/api/LanguageMetaInput.ts +3 -0
  247. package/src/generated/api/Link.ts +3 -0
  248. package/src/generated/api/LinkExpression.ts +6 -0
  249. package/src/generated/api/LinkExpressionInput.ts +6 -0
  250. package/src/generated/api/LinkInput.ts +3 -0
  251. package/src/generated/api/LinkLanguageTemplatesRequest.ts +3 -0
  252. package/src/generated/api/LinkMutations.ts +5 -0
  253. package/src/generated/api/LinkStatus.ts +3 -0
  254. package/src/generated/api/LockAgentRequest.ts +3 -0
  255. package/src/generated/api/ModelType.ts +3 -0
  256. package/src/generated/api/NotificationInput.ts +3 -0
  257. package/src/generated/api/OpenLinkRequest.ts +3 -0
  258. package/src/generated/api/PermitCapabilityRequest.ts +3 -0
  259. package/src/generated/api/PerspectiveInput.ts +4 -0
  260. package/src/generated/api/PromptRequest.ts +3 -0
  261. package/src/generated/api/PublishLanguageRequest.ts +4 -0
  262. package/src/generated/api/PublishNeighbourhoodRequest.ts +4 -0
  263. package/src/generated/api/QueryRequest.ts +6 -0
  264. package/src/generated/api/RemoveLinkRequest.ts +4 -0
  265. package/src/generated/api/RemoveLinksBulkRequest.ts +4 -0
  266. package/src/generated/api/ResourceInput.ts +3 -0
  267. package/src/generated/api/SetDefaultModelRequest.ts +4 -0
  268. package/src/generated/api/SetFreeHostingEnabledRequest.ts +3 -0
  269. package/src/generated/api/SetMultiUserRequest.ts +3 -0
  270. package/src/generated/api/SetStatusRequest.ts +3 -0
  271. package/src/generated/api/SignMessageRequest.ts +3 -0
  272. package/src/generated/api/TrustedAgentsRequest.ts +3 -0
  273. package/src/generated/api/UnlockAgentRequest.ts +3 -0
  274. package/src/generated/api/UpdateLinkRequest.ts +5 -0
  275. package/src/generated/api/UpdatePerspectiveRequest.ts +3 -0
  276. package/src/generated/api/UserStatistics.ts +3 -0
  277. package/src/generated/api/VerificationRequestResult.ts +3 -0
  278. package/src/generated/api/VerifySignatureRequest.ts +3 -0
  279. package/src/generated/api/WriteSettingsRequest.ts +3 -0
  280. package/src/generated/api/index.ts +49 -0
  281. package/src/index.ts +6 -1
  282. package/src/jestSetup.ts +1 -1
  283. package/src/language/Icon.ts +0 -4
  284. package/src/language/Language.ts +2 -23
  285. package/src/language/LanguageClient.ts +21 -132
  286. package/src/language/LanguageHandle.ts +0 -14
  287. package/src/language/LanguageMeta.ts +0 -29
  288. package/src/language/LanguageRef.ts +0 -7
  289. package/src/links/Links.ts +0 -37
  290. package/src/model/Ad4mModel.test.ts +766 -1173
  291. package/src/model/Ad4mModel.ts +664 -529
  292. package/src/model/ModelQueryBuilder.ts +203 -251
  293. package/src/model/decorators.ts +29 -0
  294. package/src/model/hydration.ts +3 -1037
  295. package/src/model/index.ts +0 -4
  296. package/src/model/query-sparql.test.ts +34 -242
  297. package/src/model/query-sparql.ts +27 -337
  298. package/src/model/query-utils.ts +47 -2
  299. package/src/model/shacl-gen.ts +5 -0
  300. package/src/model/types.ts +55 -44
  301. package/src/neighbourhood/Neighbourhood.ts +0 -9
  302. package/src/neighbourhood/NeighbourhoodClient.ts +42 -207
  303. package/src/neighbourhood/NeighbourhoodProxy.test.ts +34 -36
  304. package/src/perspectives/LinkQuery.ts +0 -15
  305. package/src/perspectives/Perspective.ts +1 -12
  306. package/src/perspectives/PerspectiveClient.test.ts +206 -148
  307. package/src/perspectives/PerspectiveClient.ts +247 -442
  308. package/src/perspectives/PerspectiveDiff.ts +0 -8
  309. package/src/perspectives/PerspectiveHandle.ts +1 -12
  310. package/src/perspectives/PerspectiveProxy.test.ts +41 -0
  311. package/src/perspectives/PerspectiveProxy.ts +331 -348
  312. package/src/runtime/RuntimeClient.ts +112 -474
  313. package/src/runtime/RuntimeTypes.ts +144 -0
  314. package/src/shacl/SHACLShape.test.ts +94 -0
  315. package/src/shacl/SHACLShape.ts +27 -0
  316. package/src/typeDefs.ts +3 -5
  317. package/tsconfig.json +3 -7
  318. package/shims/reflect-metadata.ts +0 -0
  319. package/shims/type-graphql.ts +0 -75
  320. package/src/PubSub.ts +0 -17
  321. package/src/agent/AgentResolver.ts +0 -263
  322. package/src/ai/AIResolver.ts +0 -372
  323. package/src/buildSchema.ts +0 -43
  324. package/src/expression/ExpressionResolver.ts +0 -64
  325. package/src/language/LanguageResolver.ts +0 -98
  326. package/src/model/Subject.ts +0 -159
  327. package/src/model/hydration-batch.ts +0 -205
  328. package/src/model/hydration-batching.test.ts +0 -563
  329. package/src/model/prolog-facts.ts +0 -145
  330. package/src/model/query-prolog.ts +0 -148
  331. package/src/model/query-sparql-batch.ts +0 -301
  332. package/src/model/subscription-delta.test.ts +0 -207
  333. package/src/model/subscription-pool.ts +0 -211
  334. package/src/neighbourhood/NeighbourhoodResolver.ts +0 -100
  335. package/src/perspectives/PerspectiveResolver.ts +0 -364
  336. package/src/runtime/RuntimeResolver.ts +0 -749
  337. package/src/unwrapApolloResult.ts +0 -16
@@ -1,204 +1,262 @@
1
- import { ApolloClient, InMemoryCache, gql } from "@apollo/client/core"
2
1
  import { PerspectiveClient } from "./PerspectiveClient"
3
2
  import { PerspectiveHandle, PerspectiveState } from "./PerspectiveHandle"
3
+ import { RpcError } from "../apiClient"
4
+ import { LinkQuery } from "./LinkQuery"
4
5
 
5
6
  /**
6
- * Focused unit tests for PerspectiveClient proxy cache behaviour.
7
- * Uses a mock Apollo client to isolate cache logic from network.
7
+ * Unit tests for PerspectiveClient RPC operations.
8
+ * Uses a mock ApiClient to isolate from real WebSocket connections.
8
9
  */
9
10
 
10
- // Minimal mock Apollo client that returns controllable results
11
- function createMockApolloClient(overrides: {
12
- query?: (opts: any) => any,
13
- mutate?: (opts: any) => any,
14
- subscribe?: (opts: any) => any,
15
- } = {}) {
11
+ // Mock ApiClient so we can control call/subscribe behavior
12
+ const mockCall = jest.fn()
13
+ const mockSubscribe = jest.fn().mockReturnValue(() => {})
14
+
15
+ jest.mock('../apiClient', () => {
16
16
  return {
17
- query: overrides.query || jest.fn().mockResolvedValue({ data: {} }),
18
- mutate: overrides.mutate || jest.fn().mockResolvedValue({ data: {} }),
19
- subscribe: overrides.subscribe || jest.fn().mockReturnValue({
20
- subscribe: jest.fn()
21
- }),
22
- } as unknown as ApolloClient<any>
23
- }
17
+ ApiClient: jest.fn().mockImplementation(() => ({
18
+ call: mockCall,
19
+ subscribe: mockSubscribe,
20
+ waitForSubscription: jest.fn().mockResolvedValue(undefined),
21
+ })),
22
+ RpcError: class RpcError extends Error {
23
+ readonly status: number
24
+ readonly body: string
25
+ constructor(status: number, body: string) {
26
+ super(`RPC error ${status}: ${body}`)
27
+ this.name = "RpcError"
28
+ this.status = status
29
+ this.body = body
30
+ }
31
+ },
32
+ }
33
+ })
24
34
 
25
35
  function makeHandle(uuid: string, name: string, state = PerspectiveState.Private): PerspectiveHandle {
26
36
  const h = new PerspectiveHandle(uuid, name, state)
27
37
  return h
28
38
  }
29
39
 
30
- describe('PerspectiveClient proxy cache', () => {
31
- it('byUUID returns the same proxy reference on cache hit', async () => {
40
+ describe('PerspectiveClient RPC operations', () => {
41
+ beforeEach(() => {
42
+ mockCall.mockReset()
43
+ mockSubscribe.mockReset().mockReturnValue(() => {})
44
+ })
45
+
46
+ it('byUUID returns a PerspectiveProxy for a valid UUID', async () => {
32
47
  const handle = makeHandle('uuid-1', 'Test')
33
- const mockClient = createMockApolloClient({
34
- query: jest.fn().mockResolvedValue({
35
- data: { perspective: handle }
36
- }),
37
- })
38
- const client = new PerspectiveClient(mockClient, false)
48
+ mockCall.mockResolvedValue(handle)
39
49
 
40
- const p1 = await client.byUUID('uuid-1')
41
- const p2 = await client.byUUID('uuid-1')
42
- expect(p1).toBe(p2)
43
- // Only one query should have been made (second is cache hit)
44
- expect(mockClient.query).toHaveBeenCalledTimes(1)
50
+ const client = new PerspectiveClient('http://localhost:12000', 'token', false)
51
+ const proxy = await client.byUUID('uuid-1')
52
+
53
+ expect(proxy).not.toBeNull()
54
+ expect(proxy!.uuid).toBe('uuid-1')
55
+ expect(proxy!.name).toBe('Test')
56
+ expect(mockCall).toHaveBeenCalledWith('perspective.get', { uuid: 'uuid-1' })
45
57
  })
46
58
 
47
- it('byUUID returns null for non-existent perspectives', async () => {
48
- const mockClient = createMockApolloClient({
49
- query: jest.fn().mockResolvedValue({
50
- data: { perspective: null }
51
- }),
52
- })
53
- const client = new PerspectiveClient(mockClient, false)
54
- const p = await client.byUUID('non-existent')
55
- expect(p).toBeNull()
59
+ it('byUUID returns null when server returns null', async () => {
60
+ mockCall.mockResolvedValue(null)
61
+
62
+ const client = new PerspectiveClient('http://localhost:12000', 'token', false)
63
+ const proxy = await client.byUUID('non-existent')
64
+
65
+ expect(proxy).toBeNull()
56
66
  })
57
67
 
58
- it('all() populates cache so subsequent byUUID is a hit', async () => {
68
+ it('byUUID returns null on 404 RpcError', async () => {
69
+ mockCall.mockRejectedValue(new RpcError(404, 'Not found'))
70
+
71
+ const client = new PerspectiveClient('http://localhost:12000', 'token', false)
72
+ const proxy = await client.byUUID('missing')
73
+
74
+ expect(proxy).toBeNull()
75
+ })
76
+
77
+ it('byUUID rethrows non-404 errors', async () => {
78
+ mockCall.mockRejectedValue(new RpcError(500, 'Internal error'))
79
+
80
+ const client = new PerspectiveClient('http://localhost:12000', 'token', false)
81
+
82
+ await expect(client.byUUID('error-uuid')).rejects.toThrow('RPC error 500')
83
+ })
84
+
85
+ it('all() returns array of PerspectiveProxy instances', async () => {
59
86
  const handles = [
60
87
  makeHandle('uuid-a', 'A'),
61
88
  makeHandle('uuid-b', 'B'),
62
89
  ]
63
- const queryFn = jest.fn()
64
- .mockResolvedValueOnce({ data: { perspectives: handles } })
65
- const mockClient = createMockApolloClient({ query: queryFn })
66
- const client = new PerspectiveClient(mockClient, false)
90
+ mockCall.mockResolvedValue(handles)
67
91
 
92
+ const client = new PerspectiveClient('http://localhost:12000', 'token', false)
68
93
  const all = await client.all()
69
- expect(all.length).toBe(2)
70
94
 
71
- // byUUID should be a cache hit — no additional query
72
- const pa = await client.byUUID('uuid-a')
73
- expect(pa).toBe(all[0])
74
- expect(queryFn).toHaveBeenCalledTimes(1) // only the all() query
95
+ expect(all.length).toBe(2)
96
+ expect(all[0].uuid).toBe('uuid-a')
97
+ expect(all[0].name).toBe('A')
98
+ expect(all[1].uuid).toBe('uuid-b')
99
+ expect(all[1].name).toBe('B')
100
+ expect(mockCall).toHaveBeenCalledWith('perspective.all')
75
101
  })
76
102
 
77
- it('add() populates cache', async () => {
103
+ it('add() creates a perspective and returns a proxy', async () => {
78
104
  const handle = makeHandle('uuid-new', 'New')
79
- const mockClient = createMockApolloClient({
80
- mutate: jest.fn().mockResolvedValue({
81
- data: { perspectiveAdd: handle }
82
- }),
83
- })
84
- const client = new PerspectiveClient(mockClient, false)
105
+ mockCall.mockResolvedValue(handle)
85
106
 
86
- const added = await client.add('New')
87
- expect(added.uuid).toBe('uuid-new')
107
+ const client = new PerspectiveClient('http://localhost:12000', 'token', false)
108
+ const proxy = await client.add('New')
88
109
 
89
- // byUUID should hit cache
90
- const fetched = await client.byUUID('uuid-new')
91
- expect(fetched).toBe(added)
110
+ expect(proxy.uuid).toBe('uuid-new')
111
+ expect(proxy.name).toBe('New')
112
+ expect(mockCall).toHaveBeenCalledWith('perspective.create', { name: 'New' })
92
113
  })
93
114
 
94
- it('update() evicts and recreates cached proxy', async () => {
95
- const originalHandle = makeHandle('uuid-u', 'Original')
115
+ it('update() updates a perspective and returns a new proxy', async () => {
96
116
  const updatedHandle = makeHandle('uuid-u', 'Updated')
97
- const queryFn = jest.fn().mockResolvedValue({
98
- data: { perspective: originalHandle }
99
- })
100
- const mutateFn = jest.fn().mockResolvedValue({
101
- data: { perspectiveUpdate: updatedHandle }
102
- })
103
- const mockClient = createMockApolloClient({
104
- query: queryFn,
105
- mutate: mutateFn,
106
- })
107
- const client = new PerspectiveClient(mockClient, false)
117
+ mockCall.mockResolvedValue(updatedHandle)
108
118
 
109
- const original = await client.byUUID('uuid-u')
110
- expect(original.name).toBe('Original')
119
+ const client = new PerspectiveClient('http://localhost:12000', 'token', false)
120
+ const proxy = await client.update('uuid-u', 'Updated')
111
121
 
112
- const updated = await client.update('uuid-u', 'Updated')
113
- expect(updated).not.toBe(original) // new reference after eviction
114
- expect(updated.name).toBe('Updated')
115
- expect(original.name).toBe('Original') // old reference retains stale data
122
+ expect(proxy.uuid).toBe('uuid-u')
123
+ expect(proxy.name).toBe('Updated')
124
+ expect(mockCall).toHaveBeenCalledWith('perspective.update', { uuid: 'uuid-u', name: 'Updated' })
116
125
  })
117
126
 
118
- it('remove() evicts from cache', async () => {
119
- const handle = makeHandle('uuid-r', 'ToRemove')
120
- const queryFn = jest.fn().mockResolvedValue({
121
- data: { perspective: handle }
122
- })
123
- const mutateFn = jest.fn().mockResolvedValue({
124
- data: { perspectiveRemove: true }
125
- })
126
- const mockClient = createMockApolloClient({
127
- query: queryFn,
128
- mutate: mutateFn,
129
- })
130
- const client = new PerspectiveClient(mockClient, false)
127
+ it('remove() calls perspective.remove and returns result', async () => {
128
+ mockCall.mockResolvedValue(true)
131
129
 
132
- const p = await client.byUUID('uuid-r')
133
- expect(p).toBeTruthy()
134
- expect(queryFn).toHaveBeenCalledTimes(1)
130
+ const client = new PerspectiveClient('http://localhost:12000', 'token', false)
131
+ const result = await client.remove('uuid-r')
135
132
 
136
- await client.remove('uuid-r')
133
+ expect(result).toEqual({ perspectiveRemove: true })
134
+ expect(mockCall).toHaveBeenCalledWith('perspective.remove', { uuid: 'uuid-r' })
135
+ })
137
136
 
138
- // byUUID should miss cache and query again
139
- const handle2 = makeHandle('uuid-r', 'Recreated')
140
- queryFn.mockResolvedValueOnce({ data: { perspective: handle2 } })
137
+ it('constructor subscribes to events when subscribe=true', () => {
138
+ new PerspectiveClient('http://localhost:12000', 'token', true)
141
139
 
142
- const p2 = await client.byUUID('uuid-r')
143
- expect(p2).not.toBe(p)
144
- expect(p2.name).toBe('Recreated')
145
- expect(queryFn).toHaveBeenCalledTimes(2)
140
+ // Should have subscribed 3 times (added, updated, removed)
141
+ expect(mockSubscribe).toHaveBeenCalledTimes(3)
146
142
  })
147
143
 
148
- it('getOrCreateProxy does not re-register listeners on cache hit', async () => {
149
- // Verify that getting the same proxy twice does not create duplicate subscriptions
150
- const handle = makeHandle('uuid-dup', 'NoDuplicates')
151
- const subscribeCalls: string[] = []
152
- const subscribeFn = jest.fn().mockImplementation((opts) => {
153
- // Track subscription query names
154
- const queryStr = opts.query?.loc?.source?.body || ''
155
- subscribeCalls.push(queryStr)
156
- return {
157
- subscribe: jest.fn()
158
- }
159
- })
160
- const queryFn = jest.fn()
161
- .mockResolvedValueOnce({ data: { perspectives: [handle] } })
162
- const mockClient = createMockApolloClient({
163
- query: queryFn,
164
- subscribe: subscribeFn,
165
- })
144
+ it('constructor does not subscribe when subscribe=false', () => {
145
+ new PerspectiveClient('http://localhost:12000', 'token', false)
166
146
 
167
- const client = new PerspectiveClient(mockClient, false)
168
- const all = await client.all()
169
- const firstProxy = all[0]
147
+ expect(mockSubscribe).not.toHaveBeenCalled()
148
+ })
170
149
 
171
- // Record how many subscribe calls happened from PerspectiveProxy constructor
172
- const callsAfterFirst = subscribeFn.mock.calls.length
150
+ it('addPerspectiveAddedListener dispatches events to callbacks', () => {
151
+ const subscriberCallbacks: ((data: any) => void)[] = []
152
+ mockSubscribe.mockImplementation((cb: any) => {
153
+ subscriberCallbacks.push(cb)
154
+ return () => {}
155
+ })
156
+
157
+ const client = new PerspectiveClient('http://localhost:12000', 'token', true)
158
+ const received: PerspectiveHandle[] = []
159
+ client.addPerspectiveAddedListener((h) => { received.push(h); return null })
173
160
 
174
- // Get same proxy again via all() — should be cache hit, no new constructor call
175
- queryFn.mockResolvedValueOnce({ data: { perspectives: [handle] } })
176
- const all2 = await client.all()
177
- const secondProxy = all2[0]
161
+ // Simulate server push event to all subscribers (like real WS dispatch)
162
+ const handle = makeHandle('uuid-event', 'EventPerspective')
163
+ subscriberCallbacks.forEach(cb => cb({ type: 'perspective-added', perspective: handle }))
178
164
 
179
- expect(secondProxy).toBe(firstProxy)
180
- // No additional subscribe calls should have been made
181
- expect(subscribeFn.mock.calls.length).toBe(callsAfterFirst)
165
+ expect(received.length).toBe(1)
166
+ expect(received[0].uuid).toBe('uuid-event')
182
167
  })
183
168
 
184
- it('all() updates existing cached proxies with fresh data', async () => {
185
- const handle1 = makeHandle('uuid-f', 'OldName')
186
- const handle2 = makeHandle('uuid-f', 'FreshName')
169
+ it('addLink calls perspective.addLink with correct params', async () => {
170
+ const linkExpr = { author: 'did:test', timestamp: '2026-01-01', data: { source: 'a', target: 'b', predicate: 'c' }, proof: {} }
171
+ mockCall.mockResolvedValue(linkExpr)
172
+
173
+ const client = new PerspectiveClient('http://localhost:12000', 'token', false)
174
+ const result = await client.addLink('uuid-l', { source: 'a', target: 'b', predicate: 'c' })
187
175
 
188
- const queryFn = jest.fn()
189
- .mockResolvedValueOnce({ data: { perspective: handle1 } })
190
- .mockResolvedValueOnce({ data: { perspectives: [handle2] } })
191
- const mockClient = createMockApolloClient({ query: queryFn })
192
- const client = new PerspectiveClient(mockClient, false)
176
+ expect(result).toEqual(linkExpr)
177
+ expect(mockCall).toHaveBeenCalledWith('perspective.addLink', {
178
+ uuid: 'uuid-l',
179
+ link: { source: 'a', target: 'b', predicate: 'c' },
180
+ status: 'shared',
181
+ batchId: undefined,
182
+ })
183
+ })
193
184
 
194
- const original = await client.byUUID('uuid-f')
195
- expect(original.name).toBe('OldName')
185
+ it('queryLinks sends query parameters correctly', async () => {
186
+ mockCall.mockResolvedValue([])
196
187
 
197
- const all = await client.all()
198
- const refreshed = all.find(p => p.uuid === 'uuid-f')
188
+ const client = new PerspectiveClient('http://localhost:12000', 'token', false)
189
+ await client.queryLinks('uuid-q', new LinkQuery({ source: 'src', predicate: 'pred', target: 'tgt' }))
199
190
 
200
- expect(refreshed).toBe(original) // same reference
201
- expect(refreshed.name).toBe('FreshName') // updated in-place
202
- expect(original.name).toBe('FreshName') // original ref also updated
191
+ expect(mockCall).toHaveBeenCalledWith('perspective.queryLinks', expect.objectContaining({
192
+ uuid: 'uuid-q',
193
+ source: 'src',
194
+ predicate: 'pred',
195
+ target: 'tgt',
196
+ }))
203
197
  })
204
198
  })
199
+
200
+ /**
201
+ * Unit tests for PerspectiveProxy utility functions.
202
+ */
203
+
204
+ describe('PerspectiveProxy getClassShape sh:in URI-decoding', () => {
205
+ // This tests the sh:in parsing logic in getClassShape() which was fixed
206
+ // to URI-decode values from the Rust executor's SPARQL results
207
+
208
+ function parseShInValue(raw: string): Array<{ value: string; label?: string }> | undefined {
209
+ // Reproduce the exact parsing logic from PerspectiveProxy.getClassShape()
210
+ try {
211
+ if (raw.startsWith('literal:string:')) {
212
+ raw = decodeURIComponent(raw.substring('literal:string:'.length));
213
+ }
214
+ return JSON.parse(raw);
215
+ } catch { return undefined; }
216
+ }
217
+
218
+ it('parses plain JSON sh:in values', () => {
219
+ const result = parseShInValue('[{"value":"a"},{"value":"b","label":"B"}]');
220
+ expect(result).toEqual([
221
+ { value: 'a' },
222
+ { value: 'b', label: 'B' },
223
+ ]);
224
+ });
225
+
226
+ it('strips literal:string: prefix and parses', () => {
227
+ const result = parseShInValue('literal:string:[{"value":"x"},{"value":"y"}]');
228
+ expect(result).toEqual([
229
+ { value: 'x' },
230
+ { value: 'y' },
231
+ ]);
232
+ });
233
+
234
+ it('URI-decodes encoded sh:in values from Rust executor', () => {
235
+ // Rust executor may URI-encode the JSON when returning SPARQL results
236
+ const encoded = 'literal:string:' + encodeURIComponent('[{"value":"hello world"},{"value":"a&b"}]');
237
+ const result = parseShInValue(encoded);
238
+ expect(result).toEqual([
239
+ { value: 'hello world' },
240
+ { value: 'a&b' },
241
+ ]);
242
+ });
243
+
244
+ it('handles double-encoded brackets and quotes', () => {
245
+ const encoded = 'literal:string:%5B%7B%22value%22%3A%22active%22%7D%2C%7B%22value%22%3A%22inactive%22%7D%5D';
246
+ const result = parseShInValue(encoded);
247
+ expect(result).toEqual([
248
+ { value: 'active' },
249
+ { value: 'inactive' },
250
+ ]);
251
+ });
252
+
253
+ it('returns undefined for malformed JSON', () => {
254
+ const result = parseShInValue('literal:string:not-json');
255
+ expect(result).toBeUndefined();
256
+ });
257
+
258
+ it('handles already-decoded values without prefix', () => {
259
+ const result = parseShInValue('[{"value":"test"}]');
260
+ expect(result).toEqual([{ value: 'test' }]);
261
+ });
262
+ })