@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,159 +0,0 @@
1
- import { PerspectiveProxy } from "../perspectives/PerspectiveProxy";
2
- import { relationToAdderName, relationToRemoverName, relationToSetterName, propertyNameToSetterName } from "./util";
3
-
4
- /**
5
- * Represents a subject in the perspective.
6
- * A subject is an entity that has properties and relations.
7
- */
8
- export class Subject {
9
- #baseExpression: string;
10
- #subjectClassName: string;
11
- #perspective: PerspectiveProxy
12
-
13
- /**
14
- * Constructs a new subject.
15
- * @param perspective - The perspective that the subject belongs to.
16
- * @param baseExpression - The base expression of the subject.
17
- * @param subjectClassName - The class name of the subject.
18
- */
19
- constructor(perspective: PerspectiveProxy, baseExpression: string, subjectClassName: string) {
20
- this.#baseExpression = baseExpression
21
- this.#subjectClassName = subjectClassName
22
- this.#perspective = perspective
23
- }
24
-
25
- /**
26
- * Gets the base expression of the subject.
27
- */
28
- get baseExpression() {
29
- return this.#baseExpression
30
- }
31
-
32
- /**
33
- * Initializes the subject by validating it and defining its properties and relations dynamically.
34
- *
35
- * NOTE: This method should be called before using the subject. All the properties and relations of the subject defined are not type-checked.
36
- */
37
- async init() {
38
- // Check if the subject is a valid instance of the subject class
39
- let isInstance = await this.#perspective.isSubjectInstance(this.#baseExpression, this.#subjectClassName)
40
- if(!isInstance) {
41
- throw `Not a valid subject instance of ${this.#subjectClassName} for ${this.#baseExpression}`
42
- }
43
-
44
- // Define properties and relations dynamically
45
- let results = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), property(C, Property)`)
46
- let properties = results.map(result => result.Property)
47
-
48
- for(let p of properties) {
49
- const resolveExpressionURI = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), property_resolve(C, "${p}")`)
50
- Object.defineProperty(this, p, {
51
- configurable: true,
52
- get: async () => {
53
- // Use SPARQL for data queries
54
- try {
55
- return await this.#perspective.getPropertyValueViaSparql(this.#baseExpression, this.#subjectClassName, p);
56
- } catch (err) {
57
- console.warn(`Failed to get property ${p} via SPARQL:`, err);
58
- return undefined;
59
- }
60
- }
61
- })
62
- }
63
-
64
- // Define setters
65
- const setters = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), property_setter(C, Property, Setter)`)
66
-
67
- for(let setter of (setters ? setters : [])) {
68
- if(setter) {
69
- const property = setter.Property
70
- const actions = eval(setter.Setter)
71
- const resolveLanguageResults = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), property_resolve_language(C, "${property}", Language)`)
72
- let resolveLanguage
73
- if(resolveLanguageResults && resolveLanguageResults.length > 0) {
74
- resolveLanguage = resolveLanguageResults[0].Language
75
- }
76
- this[propertyNameToSetterName(property)] = async (value: any) => {
77
- if(resolveLanguage) {
78
- value = await this.#perspective.createExpression(value, resolveLanguage)
79
- }
80
- await this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value}])
81
- }
82
- }
83
- }
84
-
85
- // Define relations
86
- let results2 = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), collection(C, Collection)`)
87
- if(!results2) results2 = []
88
- let relations = results2.map(result => result.Collection)
89
-
90
- for(let c of relations) {
91
- Object.defineProperty(this, c, {
92
- configurable: true,
93
- get: async () => {
94
- // Use SPARQL for data queries
95
- try {
96
- return await this.#perspective.getRelationValuesViaSparql(this.#baseExpression, this.#subjectClassName, c);
97
- } catch (err) {
98
- console.warn(`Failed to get relation ${c} via SPARQL:`, err);
99
- return [];
100
- }
101
- }
102
- })
103
- }
104
-
105
- // Define relation adders
106
- let adders = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), collection_adder(C, Collection, Adder)`)
107
- if(!adders) adders = []
108
-
109
- for(let adder of adders) {
110
- if(adder) {
111
- const relation = adder.Collection
112
- const actions = eval(adder.Adder)
113
- this[relationToAdderName(relation)] = async (value: any) => {
114
- if (Array.isArray(value)) {
115
- await Promise.all(value.map(v => this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value: v}])))
116
- } else {
117
- await this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value}])
118
- }
119
- }
120
- }
121
- }
122
-
123
- // Define relation removers
124
- let removers = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), collection_remover(C, Collection, Remover)`)
125
- if(!removers) removers = []
126
-
127
- for(let remover of removers) {
128
- if(remover) {
129
- const relation = remover.Collection
130
- const actions = eval(remover.Remover)
131
- this[relationToRemoverName(relation)] = async (value: any) => {
132
- if (Array.isArray(value)) {
133
- await Promise.all(value.map(v => this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value: v}])))
134
- } else {
135
- await this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value}])
136
- }
137
- }
138
- }
139
- }
140
-
141
- // Define relation setters
142
- let relationSetters = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), collection_setter(C, Collection, Setter)`)
143
- if(!relationSetters) relationSetters = []
144
-
145
- for(let relationSetter of relationSetters) {
146
- if(relationSetter) {
147
- const relation = relationSetter.Collection
148
- const actions = eval(relationSetter.Setter)
149
- this[relationToSetterName(relation)] = async (value: any) => {
150
- if (Array.isArray(value)) {
151
- await this.#perspective.executeAction(actions, this.#baseExpression, value.map(v => ({name: "value", value: v})))
152
- } else {
153
- await this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value}])
154
- }
155
- }
156
- }
157
- }
158
- }
159
- }
@@ -1,205 +0,0 @@
1
- /**
2
- * Batch hydration for SPARQL batch query results.
3
- *
4
- * Takes the flat rows returned by `buildBatchSPARQLQuery()` (each tagged
5
- * with ?depth, ?parentBase, ?relationName) and reconstructs a tree of
6
- * model instances.
7
- *
8
- * @module
9
- */
10
-
11
- import { hydrateFromLinks, evaluateCustomGettersForInstance } from "./hydration";
12
- import { getRelationsMetadata } from "./decorators";
13
- import type { IncludeMap, ModelMetadata } from "./types";
14
-
15
- /**
16
- * A row returned by the batch SPARQL query.
17
- */
18
- interface BatchRow {
19
- depth: string;
20
- parentBase: string;
21
- relationName: string;
22
- source: string;
23
- predicate: string;
24
- target: string;
25
- author: string;
26
- timestamp: string;
27
- }
28
-
29
- /**
30
- * Grouped link data for one instance (same shape as SPARQL grouped result).
31
- */
32
- interface GroupedInstance {
33
- source_uri: string;
34
- parentBase: string;
35
- relationName: string;
36
- links: Array<{ predicate: string; target: string; author: string; timestamp: string }>;
37
- }
38
-
39
- /**
40
- * Group batch rows by (depth, source) → array of links, preserving parentBase/relationName.
41
- */
42
- function groupBatchRows(rows: BatchRow[]): Map<number, GroupedInstance[]> {
43
- const byDepth = new Map<number, Map<string, GroupedInstance>>();
44
-
45
- for (const row of rows) {
46
- const depth = parseInt(row.depth, 10);
47
- if (!byDepth.has(depth)) byDepth.set(depth, new Map());
48
- const depthMap = byDepth.get(depth)!;
49
-
50
- const key = row.source;
51
- if (!depthMap.has(key)) {
52
- depthMap.set(key, {
53
- source_uri: key,
54
- parentBase: row.parentBase,
55
- relationName: row.relationName,
56
- links: [],
57
- });
58
- }
59
- depthMap.get(key)!.links.push({
60
- predicate: row.predicate,
61
- target: row.target,
62
- author: row.author,
63
- timestamp: row.timestamp,
64
- });
65
- }
66
-
67
- const result = new Map<number, GroupedInstance[]>();
68
- for (const [depth, map] of byDepth) {
69
- result.set(depth, Array.from(map.values()));
70
- }
71
- return result;
72
- }
73
-
74
- /**
75
- * Hydrate batch SPARQL results into a tree of model instances.
76
- *
77
- * @param rows - Flat rows from the batch SPARQL query
78
- * @param rootClass - The root model class (extends Ad4mModel)
79
- * @param includeMap - The include specification from the query
80
- * @param perspective - The PerspectiveProxy for creating instances
81
- * @returns Array of hydrated root instances with relations populated
82
- */
83
- export async function hydrateBatchResult<T>(
84
- rows: BatchRow[],
85
- rootClass: any,
86
- includeMap: IncludeMap,
87
- perspective: any,
88
- ): Promise<T[]> {
89
- if (!rows || rows.length === 0) return [];
90
-
91
- const grouped = groupBatchRows(rows);
92
-
93
- // Hydrate root instances (depth 0)
94
- const rootInstances = grouped.get(0) || [];
95
- const metadata: ModelMetadata = rootClass.getModelMetadata();
96
- const instances: T[] = [];
97
- const instanceMap = new Map<string, T>();
98
-
99
- for (const group of rootInstances) {
100
- const instance = new rootClass(perspective, group.source_uri) as any;
101
- await hydrateFromLinks(instance, group.links, metadata, perspective);
102
- await evaluateCustomGettersForInstance(instance, perspective, metadata);
103
- instances.push(instance);
104
- instanceMap.set(group.source_uri, instance);
105
- }
106
-
107
- // Hydrate each depth level and wire to parents
108
- const relMeta = getRelationsMetadata(rootClass);
109
- const maxDepth = Math.max(...Array.from(grouped.keys()), 0);
110
-
111
- // Build a map of depth → (class, relMetadata, parentInstanceMap)
112
- // For depth 1, parents are root instances; for deeper depths, we need
113
- // the instances from the previous level.
114
- const depthInstanceMaps = new Map<number, Map<string, any>>();
115
- depthInstanceMaps.set(0, instanceMap);
116
-
117
- // Build depth→class mapping from include tree
118
- const depthClassMap = new Map<number, { targetClass: any; includeMap?: IncludeMap }>();
119
- buildDepthClassMap(rootClass, includeMap, 0, { value: 1 }, depthClassMap);
120
-
121
- for (let depth = 1; depth <= maxDepth; depth++) {
122
- const depthGroups = grouped.get(depth) || [];
123
- if (depthGroups.length === 0) continue;
124
-
125
- const depthInfo = depthClassMap.get(depth);
126
- if (!depthInfo) continue;
127
-
128
- const TargetClass = depthInfo.targetClass;
129
- const targetMetadata: ModelMetadata = TargetClass.getModelMetadata
130
- ? TargetClass.getModelMetadata()
131
- : { className: "Unknown", properties: {}, relations: {} };
132
-
133
- const currentDepthInstances = new Map<string, any>();
134
-
135
- // Group by parentBase to wire children to parents
136
- for (const group of depthGroups) {
137
- const instance = new TargetClass(perspective, group.source_uri) as any;
138
- await hydrateFromLinks(instance, group.links, targetMetadata, perspective);
139
- await evaluateCustomGettersForInstance(instance, perspective, targetMetadata);
140
- currentDepthInstances.set(group.source_uri, instance);
141
-
142
- // Wire to parent
143
- // Find the parent depth's instance map
144
- // The parentBase should exist in one of the prior depth maps
145
- for (let pd = depth - 1; pd >= 0; pd--) {
146
- const parentMap = depthInstanceMaps.get(pd);
147
- if (parentMap && parentMap.has(group.parentBase)) {
148
- const parent = parentMap.get(group.parentBase)!;
149
- const relName = group.relationName;
150
-
151
- // Determine relation metadata to know if it's an array or single
152
- const parentRelMeta = getRelationsMetadata(pd === 0 ? rootClass : (depthClassMap.get(pd)?.targetClass || rootClass));
153
- const rel = parentRelMeta[relName];
154
-
155
- if (rel) {
156
- if (rel.kind === 'hasMany' || rel.kind === 'belongsToMany') {
157
- if (!Array.isArray(parent[relName])) {
158
- parent[relName] = [];
159
- }
160
- parent[relName].push(instance);
161
- } else {
162
- parent[relName] = instance;
163
- }
164
- }
165
- break;
166
- }
167
- }
168
- }
169
-
170
- depthInstanceMaps.set(depth, currentDepthInstances);
171
- }
172
-
173
- return instances;
174
- }
175
-
176
- /**
177
- * Build a mapping from depth number to target class info.
178
- */
179
- function buildDepthClassMap(
180
- parentClass: any,
181
- includeMap: IncludeMap,
182
- _parentDepth: number,
183
- nextDepth: { value: number },
184
- result: Map<number, { targetClass: any; includeMap?: IncludeMap }>,
185
- ): void {
186
- const relMeta = getRelationsMetadata(parentClass);
187
-
188
- for (const [relName, includeValue] of Object.entries(includeMap)) {
189
- const meta = relMeta[relName];
190
- if (!meta || !meta.target) continue;
191
-
192
- const TargetClass = meta.target();
193
- const depth = nextDepth.value++;
194
-
195
- const nestedInclude = typeof includeValue === 'object' && includeValue !== null
196
- ? (includeValue as any).include
197
- : undefined;
198
-
199
- result.set(depth, { targetClass: TargetClass, includeMap: nestedInclude });
200
-
201
- if (nestedInclude) {
202
- buildDepthClassMap(TargetClass, nestedInclude, depth, nextDepth, result);
203
- }
204
- }
205
- }