@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
@@ -8,10 +8,7 @@
8
8
  export * from "./types";
9
9
  export * from "./Ad4mModel";
10
10
  export * from "./decorators";
11
- export * from "./Subject";
12
11
  export * from "./query-common";
13
- export * from "./query-prolog";
14
- export * from "./prolog-facts";
15
12
  export * from "./json-schema";
16
13
  export * from "./query-utils";
17
14
  export * from "./query-sparql";
@@ -20,4 +17,3 @@ export * from "./ModelQueryBuilder";
20
17
  export * from "./sdna";
21
18
  export * from "./shacl-gen";
22
19
  export * from "./query-cache";
23
- export * from "./subscription-pool";
@@ -8,10 +8,7 @@
8
8
  export * from "./types";
9
9
  export * from "./Ad4mModel";
10
10
  export * from "./decorators";
11
- export * from "./Subject";
12
11
  export * from "./query-common";
13
- export * from "./query-prolog";
14
- export * from "./prolog-facts";
15
12
  export * from "./json-schema";
16
13
  export * from "./query-utils";
17
14
  export * from "./query-sparql";
@@ -20,4 +17,3 @@ export * from "./ModelQueryBuilder";
20
17
  export * from "./sdna";
21
18
  export * from "./shacl-gen";
22
19
  export * from "./query-cache";
23
- export * from "./subscription-pool";
@@ -0,0 +1,41 @@
1
+ /**
2
+ * Types for the perspective model manifest — a human-readable, AI-friendly summary
3
+ * of all Ad4mModel-compatible classes defined in a perspective's SHACL shapes.
4
+ *
5
+ * Used by `PerspectiveProxy.getModelManifest()` and consumed by WE's AI context
6
+ * injection (`formatManifestForPrompt`) to describe external perspective models
7
+ * to the schema-generation AI.
8
+ *
9
+ * @module
10
+ */
11
+ /** Normalised description of a single property on a model class. */
12
+ export interface ModelManifestProperty {
13
+ /** Property name as declared in the SHACL shape (e.g. "name", "body", "participants"). */
14
+ name: string;
15
+ /** The exact RDF predicate URI (e.g. "flux://has_name"). */
16
+ predicate: string;
17
+ /** Normalised scalar type; inferred from xsd:/sh: datatype + nodeKind. */
18
+ type: 'string' | 'number' | 'boolean' | 'uri';
19
+ /** `true` when maxCount is absent or > 1 (i.e. returned as an array). */
20
+ isCollection: boolean;
21
+ /** `true` when minCount >= 1. */
22
+ required: boolean;
23
+ writable: boolean;
24
+ /** AD4M language used to resolve the value (e.g. "literal"). */
25
+ resolveLanguage?: string;
26
+ /**
27
+ * Local name of the related model class when this is a typed relation property.
28
+ * Derived from `SHACLPropertyShape.class` by stripping the URI prefix.
29
+ * E.g. `flux://Message` → `"Message"`.
30
+ */
31
+ relatedModel?: string;
32
+ }
33
+ /** Normalised description of a single model class stored in a perspective. */
34
+ export interface ModelManifestEntry {
35
+ /** Class name — usable directly as the `model` field in a `$query` token. */
36
+ name: string;
37
+ /** The SHACL `targetClass` URI (e.g. "flux://Channel"). */
38
+ targetClass: string;
39
+ /** All data properties (flag/hasValue properties are excluded). */
40
+ properties: ModelManifestProperty[];
41
+ }
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Types for the perspective model manifest — a human-readable, AI-friendly summary
3
+ * of all Ad4mModel-compatible classes defined in a perspective's SHACL shapes.
4
+ *
5
+ * Used by `PerspectiveProxy.getModelManifest()` and consumed by WE's AI context
6
+ * injection (`formatManifestForPrompt`) to describe external perspective models
7
+ * to the schema-generation AI.
8
+ *
9
+ * @module
10
+ */
11
+ export {};
@@ -1,8 +1,10 @@
1
1
  /**
2
2
  * SPARQL query building utilities for Ad4mModel.
3
3
  *
4
- * Uses the direct triple + named graph storage model where each AD4M link
5
- * is stored in a named graph (keyed by link hash) with metadata in the default graph.
4
+ * Uses the RDF 1.2 reifier storage model where each AD4M link is stored as:
5
+ * 1. Direct triple: <source> <predicate> <target> . (default graph)
6
+ * 2. Reifier: <link:HASH> <http://www.w3.org/1999/02/22-rdf-syntax-ns#reifies> <<( source predicate target )>> .
7
+ * 3. Metadata: <link:HASH> ad4m://ontology/* "value" . (default graph)
6
8
  *
7
9
  * All AD4M URIs (source, predicate, target) become RDF IRIs.
8
10
  *
@@ -57,68 +59,3 @@ export declare function buildSPARQLOrderLimitOffset(_metadata: ModelMetadata, qu
57
59
  * @internal — used by buildSPARQLQuery when SPARQL-level pagination is safe.
58
60
  */
59
61
  export declare function buildPaginationSubquery(joinPatterns: string[], filterExpressions: string[], metadata: ModelMetadata, query: Query): string;
60
- /**
61
- * Build a SPARQL COUNT query that returns the total number of matching
62
- * instances WITHOUT hydrating them. Uses the same WHERE clause as
63
- * buildSPARQLQuery but wraps it in SELECT (COUNT(DISTINCT ?source) AS ?count).
64
- *
65
- * LIMIT/OFFSET from the query are stripped internally — this always counts
66
- * the full result set.
67
- */
68
- export declare function buildSPARQLCountQuery(metadata: ModelMetadata, allRelationsMetadata: Record<string, RelationMetadataEntry>, query: Query, modelClass: any): string;
69
- /**
70
- * Build a SPARQL query to fetch all links for a single instance.
71
- */
72
- export declare function buildSPARQLGetDataQuery(baseExpression: string): string;
73
- /**
74
- * Group flat SPARQL link rows into the same shape that SPARQL returned:
75
- * `{ source_uri: string, links: Array<{predicate, target, author, timestamp}> }`
76
- */
77
- export declare function groupSPARQLResults(rows: Array<{
78
- source: string;
79
- predicate: string;
80
- target: string;
81
- author: string;
82
- timestamp: string;
83
- }>): Array<{
84
- source_uri: string;
85
- links: Array<{
86
- predicate: string;
87
- target: string;
88
- author: string;
89
- timestamp: string;
90
- }>;
91
- }>;
92
- /**
93
- * Parse a SPARQL COUNT result row into a number.
94
- * Handles `row.count?.value` (RDF binding), `row.count` (direct number/string),
95
- * NaN results, and empty/malformed results.
96
- *
97
- * @returns The parsed count, or `null` if the result cannot be interpreted.
98
- */
99
- export declare function parseSparqlCount(result: any[]): number | null;
100
- /**
101
- * Build a SPARQL query that counts child instances grouped by parent IRI.
102
- *
103
- * Used by the projection Path A (`count: true`) in `hydrateRelations` to get
104
- * per-parent counts in a single round-trip with zero instance hydration.
105
- *
106
- * Includes the full named graph block so that `?author` and `?timestamp` are
107
- * bound and available for SPARQL FILTER expressions (unlike the intentionally
108
- * minimal `buildSPARQLCountQuery` which omits them for speed).
109
- *
110
- * @param metadata - Model metadata for the **child** (target) class
111
- * @param allRelationsMetadata - Relations metadata for the child class
112
- * @param relationPredicate - The predicate linking `?parent` → `?source` (child)
113
- * @param parentIds - IRI strings of all parent instances to count for
114
- * @param where - Optional filter applied to child instances
115
- */
116
- export declare function buildSPARQLGroupedCountQuery(metadata: ModelMetadata, allRelationsMetadata: Record<string, RelationMetadataEntry>, relationPredicate: string, parentIds: string[], where?: import('./types').Where): string;
117
- /**
118
- * Parse the result of `buildSPARQLGroupedCountQuery` into a map from parent IRI
119
- * to count. Missing parents (zero matches) are absent from the map — callers
120
- * should use `map.get(id) ?? 0`.
121
- *
122
- * @returns Map from parentId string → count number
123
- */
124
- export declare function parseSparqlGroupedCount(result: any[]): Map<string, number>;
@@ -1,8 +1,10 @@
1
1
  /**
2
2
  * SPARQL query building utilities for Ad4mModel.
3
3
  *
4
- * Uses the direct triple + named graph storage model where each AD4M link
5
- * is stored in a named graph (keyed by link hash) with metadata in the default graph.
4
+ * Uses the RDF 1.2 reifier storage model where each AD4M link is stored as:
5
+ * 1. Direct triple: <source> <predicate> <target> . (default graph)
6
+ * 2. Reifier: <link:HASH> <http://www.w3.org/1999/02/22-rdf-syntax-ns#reifies> <<( source predicate target )>> .
7
+ * 3. Metadata: <link:HASH> ad4m://ontology/* "value" . (default graph)
6
8
  *
7
9
  * All AD4M URIs (source, predicate, target) become RDF IRIs.
8
10
  *
@@ -29,12 +31,7 @@ export function hasJsOnlyWhereFilters(metadata, allRelationsMetadata, where) {
29
31
  for (const [propertyName, condition] of Object.entries(where)) {
30
32
  if (propertyName === "base" || propertyName === "id")
31
33
  continue;
32
- // author/timestamp: return true so that count() falls back to the full hydration
33
- // path (which uses buildSPARQLQuery — which DOES bind ?author/?timestamp via the
34
- // named graph block). buildSPARQLCountQuery intentionally omits the named graph,
35
- // so emitting an ?author FILTER there would produce unbound-variable SPARQL.
36
- // buildSPARQLWhereFilters still pushes these into FILTER when called from
37
- // buildSPARQLQuery / buildSPARQLGroupedCountQuery, which both include the named graph.
34
+ // author/timestamp filters are handled in JS
38
35
  if (propertyName === "author" || propertyName === "timestamp")
39
36
  return true;
40
37
  const propMeta = metadata.properties[propertyName];
@@ -232,7 +229,7 @@ export function buildSPARQLQuery(metadata, allRelationsMetadata, query, modelCla
232
229
  joinPatterns.push(...userJoins);
233
230
  filterExpressions.push(...userFilters);
234
231
  // Main triple pattern — fetches all links for matched sources
235
- // The direct triple in named graph: GRAPH ?linkGraph { ?source ?predicate ?target }
232
+ // Direct triple in default graph + RDF 1.2 reifier for link metadata
236
233
  // FILTER(isIRI(?source)) excludes non-IRI subjects
237
234
  const joinClause = joinPatterns.join("\n");
238
235
  const filterClause = filterExpressions.length > 0
@@ -241,13 +238,8 @@ export function buildSPARQLQuery(metadata, allRelationsMetadata, query, modelCla
241
238
  // Determine if SPARQL-level pagination is safe.
242
239
  // When JS-only where filters exist, we must NOT limit at the SPARQL level
243
240
  // because the database would cap candidates before JS filters run.
244
- // Without an explicit ORDER BY, SPARQL OFFSET/LIMIT produces non-deterministic
245
- // ordering across different query plans and index traversals. Fall back to
246
- // JS-level slicing in that case to preserve the grouping order from the full
247
- // result set.
248
241
  const canPaginateInSPARQL = !hasJsOnlyWhereFilters(metadata, allRelationsMetadata, query.where)
249
- && (query.limit !== undefined || query.offset !== undefined)
250
- && query.order !== undefined && Object.keys(query.order).length > 0;
242
+ && (query.limit !== undefined || query.offset !== undefined);
251
243
  // Build a pagination subquery that constrains ?source to only the page
252
244
  // of interest. This avoids fetching all links for all matching instances.
253
245
  const paginationSubquery = canPaginateInSPARQL
@@ -257,22 +249,26 @@ export function buildSPARQLQuery(metadata, allRelationsMetadata, query, modelCla
257
249
  // Use the pagination subquery to constrain ?source, then fetch all links
258
250
  // for those sources only.
259
251
  return `
252
+
260
253
  SELECT ?source ?predicate ?target ?author ?timestamp WHERE {
261
254
  ${paginationSubquery}${joinClause}
262
- GRAPH ?linkGraph { ?source ?predicate ?target . }
255
+ ?source ?predicate ?target .
256
+ ?_reifier <http://www.w3.org/1999/02/22-rdf-syntax-ns#reifies> <<( ?source ?predicate ?target )>> .
263
257
  FILTER(isIRI(?source) && isIRI(?predicate))
264
- ?linkGraph <ad4m://ontology/author> ?author .
265
- ?linkGraph <ad4m://ontology/timestamp> ?timestamp .
258
+ ?_reifier <ad4m://ontology/author> ?author .
259
+ ?_reifier <ad4m://ontology/timestamp> ?timestamp .
266
260
  ${filterClause}
267
261
  }
268
262
  `.trim();
269
263
  }
270
264
  return `
265
+
271
266
  SELECT ?source ?predicate ?target ?author ?timestamp WHERE {${joinClause}
272
- GRAPH ?linkGraph { ?source ?predicate ?target . }
267
+ ?source ?predicate ?target .
268
+ ?_reifier <http://www.w3.org/1999/02/22-rdf-syntax-ns#reifies> <<( ?source ?predicate ?target )>> .
273
269
  FILTER(isIRI(?source) && isIRI(?predicate))
274
- ?linkGraph <ad4m://ontology/author> ?author .
275
- ?linkGraph <ad4m://ontology/timestamp> ?timestamp .
270
+ ?_reifier <ad4m://ontology/author> ?author .
271
+ ?_reifier <ad4m://ontology/timestamp> ?timestamp .
276
272
  ${filterClause}
277
273
  }
278
274
  ${buildSPARQLOrderLimitOffset(metadata, query)}
@@ -305,15 +301,10 @@ export function buildPaginationSubquery(joinPatterns, filterExpressions, metadat
305
301
  const innerFilter = filterExpressions.length > 0
306
302
  ? `FILTER(\n ${filterExpressions.join(' &&\n ')}\n )`
307
303
  : '';
308
- // Build ORDER BY clause from query.order.
309
- // When ORDER BY references non-grouped variables we must use SAMPLE()
310
- // aggregates so the query is valid SPARQL 1.1.
304
+ // Build ORDER BY clause from query.order
311
305
  let orderByClause = '';
312
306
  const orderJoinPatterns = [];
313
- const sampleProjections = []; // e.g. (SAMPLE(?cfTarget_title) AS ?pg_sort_0)
314
- const needsGroupBy = query.order && Object.keys(query.order).length > 0;
315
307
  if (query.order) {
316
- let sortIdx = 0;
317
308
  const orderTerms = Object.entries(query.order).map(([prop, dir]) => {
318
309
  const sparqlVar = mapPropertyToSPARQLVar(prop, metadata);
319
310
  // Check if this order property's variable is already bound by existing
@@ -325,137 +316,23 @@ export function buildPaginationSubquery(joinPatterns, filterExpressions, metadat
325
316
  orderJoinPatterns.push(`\n OPTIONAL { ?source <${propMeta.predicate}> ${sparqlVar} . }`);
326
317
  }
327
318
  }
328
- // Use SAMPLE() aggregate so ORDER BY is valid with GROUP BY ?source.
329
- const sortAlias = `?pg_sort_${sortIdx++}`;
330
- sampleProjections.push(`(SAMPLE(${sparqlVar}) AS ${sortAlias})`);
331
- return dir === 'DESC' ? `DESC(${sortAlias})` : `ASC(${sortAlias})`;
319
+ return dir === 'DESC' ? `DESC(${sparqlVar})` : `ASC(${sparqlVar})`;
332
320
  });
333
321
  if (orderTerms.length > 0) {
334
322
  orderByClause = `ORDER BY ${orderTerms.join(' ')}`;
335
323
  }
336
324
  }
325
+ // No default ordering — when no explicit order is specified, results come in
326
+ // natural (insertion) order.
327
+ const tsSelect = '';
328
+ const tsPattern = '';
337
329
  const limitClause = query.limit !== undefined ? `LIMIT ${query.limit}` : '';
338
330
  const offsetClause = query.offset !== undefined && query.offset > 0 ? `OFFSET ${query.offset}` : '';
339
- // When there's no ORDER BY, DISTINCT alone handles deduplication — no GROUP BY needed.
340
- // When there IS ORDER BY, use GROUP BY ?source with SAMPLE() aggregates for the sort keys.
341
- const sampleSelect = sampleProjections.length > 0 ? ' ' + sampleProjections.join(' ') : '';
342
- const groupByClause = needsGroupBy ? 'GROUP BY ?source' : '';
343
331
  return `
344
- { SELECT DISTINCT ?source${sampleSelect} WHERE {${innerJoin}${orderJoinPatterns.join('')}
332
+ { SELECT DISTINCT ?source${tsSelect} WHERE {${innerJoin}${orderJoinPatterns.join('')}${tsPattern}
345
333
  FILTER(isIRI(?source))
346
334
  ${innerFilter}
347
- } ${groupByClause} ${orderByClause} ${limitClause} ${offsetClause} }\n`;
348
- }
349
- /**
350
- * Build a SPARQL COUNT query that returns the total number of matching
351
- * instances WITHOUT hydrating them. Uses the same WHERE clause as
352
- * buildSPARQLQuery but wraps it in SELECT (COUNT(DISTINCT ?source) AS ?count).
353
- *
354
- * LIMIT/OFFSET from the query are stripped internally — this always counts
355
- * the full result set.
356
- */
357
- export function buildSPARQLCountQuery(metadata, allRelationsMetadata, query, modelClass) {
358
- // Build the same join/filter patterns as buildSPARQLQuery
359
- const joinPatterns = [];
360
- const filterExpressions = [];
361
- if (query.parent) {
362
- const parentPredicate = resolveParentPredicate(query.parent, modelClass);
363
- joinPatterns.push(`\n ${iri(query.parent.id)} ${iri(parentPredicate)} ?source .`);
364
- }
365
- let hasConformance = false;
366
- for (const [, propMeta] of Object.entries(metadata.properties)) {
367
- if (propMeta.required) {
368
- if (propMeta.getter)
369
- continue;
370
- hasConformance = true;
371
- if (propMeta.flag && propMeta.initial) {
372
- joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ${iri(propMeta.initial)} .`);
373
- }
374
- else {
375
- joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ?cfTarget_${propMeta.name} .`);
376
- }
377
- }
378
- }
379
- if (!hasConformance) {
380
- for (const [, propMeta] of Object.entries(metadata.properties)) {
381
- if (propMeta.initial) {
382
- hasConformance = true;
383
- if (propMeta.flag) {
384
- joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ${iri(propMeta.initial)} .`);
385
- }
386
- else {
387
- joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ?cfInitTarget_${propMeta.name} .`);
388
- }
389
- break;
390
- }
391
- }
392
- }
393
- if (!hasConformance && joinPatterns.length === 0) {
394
- const knownPredicates = [];
395
- for (const [, propMeta] of Object.entries(metadata.properties)) {
396
- if (propMeta.predicate)
397
- knownPredicates.push(iri(propMeta.predicate));
398
- }
399
- if (metadata.relations) {
400
- for (const [, relMeta] of Object.entries(metadata.relations)) {
401
- if (relMeta.predicate)
402
- knownPredicates.push(iri(relMeta.predicate));
403
- }
404
- }
405
- if (knownPredicates.length > 0) {
406
- joinPatterns.push(`\n { SELECT DISTINCT ?source WHERE { ?source ?cf_structPred ?cf_structTarget . FILTER(?cf_structPred IN (${knownPredicates.join(", ")})) } }`);
407
- }
408
- }
409
- const { joins: userJoins, filters: userFilters } = buildSPARQLWhereFilters(metadata, allRelationsMetadata, query.where);
410
- joinPatterns.push(...userJoins);
411
- filterExpressions.push(...userFilters);
412
- const joinClause = joinPatterns.join('\n');
413
- const filterClause = filterExpressions.length > 0
414
- ? `FILTER(\n ${filterExpressions.join(' &&\n ')}\n )`
415
- : '';
416
- return `
417
- SELECT (COUNT(DISTINCT ?source) AS ?count) WHERE {${joinClause}
418
- FILTER(isIRI(?source))
419
- ${filterClause}
420
- }
421
- `.trim();
422
- }
423
- /**
424
- * Build a SPARQL query to fetch all links for a single instance.
425
- */
426
- export function buildSPARQLGetDataQuery(baseExpression) {
427
- return `
428
- SELECT ?source ?predicate ?target ?author ?timestamp WHERE {
429
- GRAPH ?linkGraph { ${iri(baseExpression)} ?predicate ?target . }
430
- FILTER(isIRI(?predicate))
431
- BIND(${iri(baseExpression)} AS ?source)
432
- ?linkGraph <ad4m://ontology/author> ?author .
433
- ?linkGraph <ad4m://ontology/timestamp> ?timestamp .
434
- }
435
- `.trim();
436
- }
437
- /**
438
- * Group flat SPARQL link rows into the same shape that SPARQL returned:
439
- * `{ source_uri: string, links: Array<{predicate, target, author, timestamp}> }`
440
- */
441
- export function groupSPARQLResults(rows) {
442
- const grouped = new Map();
443
- for (const row of rows) {
444
- const key = row.source;
445
- if (!grouped.has(key)) {
446
- grouped.set(key, []);
447
- }
448
- grouped.get(key).push({
449
- predicate: row.predicate,
450
- target: row.target,
451
- author: row.author,
452
- timestamp: row.timestamp,
453
- });
454
- }
455
- return Array.from(grouped.entries()).map(([source_uri, links]) => ({
456
- source_uri,
457
- links,
458
- }));
335
+ } GROUP BY ?source ${orderByClause} ${limitClause} ${offsetClause} }\n`;
459
336
  }
460
337
  /**
461
338
  * Build SPARQL FILTER expressions from user `where` conditions.
@@ -490,53 +367,7 @@ function buildSPARQLWhereFilters(metadata, _allRelationsMetadata, where) {
490
367
  }
491
368
  continue;
492
369
  }
493
- if (propertyName === "author") {
494
- // ?author is bound by the named graph block in buildSPARQLQuery /
495
- // buildSPARQLGroupedCountQuery — push equality/IN filters into SPARQL.
496
- if (Array.isArray(condition)) {
497
- const formatted = condition.map(v => formatSPARQLValue(String(v))).join(', ');
498
- filters.push(`STR(?author) IN (${formatted})`);
499
- }
500
- else if (typeof condition === 'object' && condition !== null) {
501
- const ops = condition;
502
- if (ops.not !== undefined) {
503
- if (Array.isArray(ops.not)) {
504
- const formatted = ops.not.map((v) => formatSPARQLValue(String(v))).join(', ');
505
- filters.push(`!(STR(?author) IN (${formatted}))`);
506
- }
507
- else {
508
- filters.push(`STR(?author) != ${formatSPARQLValue(String(ops.not))}`);
509
- }
510
- }
511
- // Other operators (gt/lt/etc.) fall through to JS post-filter
512
- }
513
- else {
514
- filters.push(`STR(?author) = ${formatSPARQLValue(String(condition))}`);
515
- }
516
- continue;
517
- }
518
- if (propertyName === "timestamp") {
519
- // ?timestamp is bound by the named graph block — push numeric comparisons.
520
- if (typeof condition === 'object' && condition !== null && !Array.isArray(condition)) {
521
- const ops = condition;
522
- if (ops.gt !== undefined)
523
- filters.push(`?timestamp > ${Number(ops.gt)}`);
524
- if (ops.gte !== undefined)
525
- filters.push(`?timestamp >= ${Number(ops.gte)}`);
526
- if (ops.lt !== undefined)
527
- filters.push(`?timestamp < ${Number(ops.lt)}`);
528
- if (ops.lte !== undefined)
529
- filters.push(`?timestamp <= ${Number(ops.lte)}`);
530
- if (ops.between !== undefined && Array.isArray(ops.between)) {
531
- filters.push(`?timestamp >= ${Number(ops.between[0])} && ?timestamp <= ${Number(ops.between[1])}`);
532
- }
533
- if (ops.not !== undefined) {
534
- filters.push(`?timestamp != ${Number(ops.not)}`);
535
- }
536
- }
537
- else if (typeof condition === 'number' || (typeof condition === 'string' && !isNaN(Number(condition)))) {
538
- filters.push(`?timestamp = ${Number(condition)}`);
539
- }
370
+ if (propertyName === "author" || propertyName === "timestamp") {
540
371
  continue;
541
372
  }
542
373
  const propMeta = metadata.properties[propertyName];
@@ -638,130 +469,3 @@ function buildSPARQLWhereFilters(metadata, _allRelationsMetadata, where) {
638
469
  }
639
470
  return { joins, filters };
640
471
  }
641
- /**
642
- * Parse a SPARQL COUNT result row into a number.
643
- * Handles `row.count?.value` (RDF binding), `row.count` (direct number/string),
644
- * NaN results, and empty/malformed results.
645
- *
646
- * @returns The parsed count, or `null` if the result cannot be interpreted.
647
- */
648
- export function parseSparqlCount(result) {
649
- if (!Array.isArray(result) || result.length === 0)
650
- return null;
651
- const row = result[0];
652
- const val = row.count?.value ?? row.count;
653
- if (val === undefined || val === null)
654
- return null;
655
- const parsed = typeof val === 'number' ? val : parseInt(String(val), 10);
656
- return isNaN(parsed) ? null : parsed;
657
- }
658
- /**
659
- * Build a SPARQL query that counts child instances grouped by parent IRI.
660
- *
661
- * Used by the projection Path A (`count: true`) in `hydrateRelations` to get
662
- * per-parent counts in a single round-trip with zero instance hydration.
663
- *
664
- * Includes the full named graph block so that `?author` and `?timestamp` are
665
- * bound and available for SPARQL FILTER expressions (unlike the intentionally
666
- * minimal `buildSPARQLCountQuery` which omits them for speed).
667
- *
668
- * @param metadata - Model metadata for the **child** (target) class
669
- * @param allRelationsMetadata - Relations metadata for the child class
670
- * @param relationPredicate - The predicate linking `?parent` → `?source` (child)
671
- * @param parentIds - IRI strings of all parent instances to count for
672
- * @param where - Optional filter applied to child instances
673
- */
674
- export function buildSPARQLGroupedCountQuery(metadata, allRelationsMetadata, relationPredicate, parentIds, where) {
675
- const joinPatterns = [];
676
- const filterExpressions = [];
677
- // Parent → child join and IN filter
678
- joinPatterns.push(`\n ?parent ${iri(relationPredicate)} ?source .`);
679
- const parentIris = parentIds.map(id => iri(id)).join(', ');
680
- filterExpressions.push(`?parent IN (${parentIris})`);
681
- // Conformance patterns (mirrors buildSPARQLCountQuery logic)
682
- let hasConformance = false;
683
- for (const [, propMeta] of Object.entries(metadata.properties)) {
684
- if (propMeta.required) {
685
- if (propMeta.getter)
686
- continue;
687
- hasConformance = true;
688
- if (propMeta.flag && propMeta.initial) {
689
- joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ${iri(propMeta.initial)} .`);
690
- }
691
- else {
692
- joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ?cfTarget_${propMeta.name} .`);
693
- }
694
- }
695
- }
696
- if (!hasConformance) {
697
- for (const [, propMeta] of Object.entries(metadata.properties)) {
698
- if (propMeta.initial) {
699
- hasConformance = true;
700
- if (propMeta.flag) {
701
- joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ${iri(propMeta.initial)} .`);
702
- }
703
- else {
704
- joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ?cfInitTarget_${propMeta.name} .`);
705
- }
706
- break;
707
- }
708
- }
709
- }
710
- if (!hasConformance && joinPatterns.length <= 1) {
711
- // Only the parent join so far — add open-world structural matching
712
- const knownPredicates = [];
713
- for (const [, propMeta] of Object.entries(metadata.properties)) {
714
- if (propMeta.predicate)
715
- knownPredicates.push(iri(propMeta.predicate));
716
- }
717
- if (metadata.relations) {
718
- for (const [, relMeta] of Object.entries(metadata.relations)) {
719
- if (relMeta.predicate)
720
- knownPredicates.push(iri(relMeta.predicate));
721
- }
722
- }
723
- if (knownPredicates.length > 0) {
724
- joinPatterns.push(`\n { SELECT DISTINCT ?source WHERE { ?source ?cf_structPred ?cf_structTarget . FILTER(?cf_structPred IN (${knownPredicates.join(', ')})) } }`);
725
- }
726
- }
727
- // User where-clause filters (including author/timestamp after the SPARQL push)
728
- const { joins: userJoins, filters: userFilters } = buildSPARQLWhereFilters(metadata, allRelationsMetadata, where);
729
- joinPatterns.push(...userJoins);
730
- filterExpressions.push(...userFilters);
731
- const joinClause = joinPatterns.join('\n');
732
- const filterClause = filterExpressions.length > 0
733
- ? `FILTER(\n ${filterExpressions.join(' &&\n ')}\n )`
734
- : '';
735
- return `
736
- SELECT ?parent (COUNT(DISTINCT ?source) AS ?count) WHERE {${joinClause}
737
- GRAPH ?linkGraph { ?source ?predicate ?target . }
738
- FILTER(isIRI(?source) && isIRI(?predicate))
739
- ?linkGraph <ad4m://ontology/author> ?author .
740
- ?linkGraph <ad4m://ontology/timestamp> ?timestamp .
741
- ${filterClause}
742
- }
743
- GROUP BY ?parent
744
- `.trim();
745
- }
746
- /**
747
- * Parse the result of `buildSPARQLGroupedCountQuery` into a map from parent IRI
748
- * to count. Missing parents (zero matches) are absent from the map — callers
749
- * should use `map.get(id) ?? 0`.
750
- *
751
- * @returns Map from parentId string → count number
752
- */
753
- export function parseSparqlGroupedCount(result) {
754
- const out = new Map();
755
- if (!Array.isArray(result))
756
- return out;
757
- for (const row of result) {
758
- const parentVal = row.parent?.value ?? row.parent;
759
- const countVal = row.count?.value ?? row.count;
760
- if (!parentVal || countVal === undefined || countVal === null)
761
- continue;
762
- const parsed = typeof countVal === 'number' ? countVal : parseInt(String(countVal), 10);
763
- if (!isNaN(parsed))
764
- out.set(String(parentVal), parsed);
765
- }
766
- return out;
767
- }