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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (334) hide show
  1. package/README.md +2 -25
  2. package/jest-setup.ts +1 -1
  3. package/lib/index.cjs +2406 -11070
  4. package/lib/index.js +2209 -10925
  5. package/lib/src/Ad4mClient.d.ts +7 -3
  6. package/lib/src/Ad4mClient.js +29 -13
  7. package/lib/src/agent/Agent.js +26 -272
  8. package/lib/src/agent/AgentClient.d.ts +10 -21
  9. package/lib/src/agent/AgentClient.js +75 -427
  10. package/lib/src/agent/AgentStatus.js +2 -37
  11. package/lib/src/ai/AIClient.d.ts +12 -4
  12. package/lib/src/ai/AIClient.js +81 -285
  13. package/lib/src/ai/AITypes.d.ts +55 -0
  14. package/lib/src/ai/AITypes.js +18 -0
  15. package/lib/src/ai/Tasks.js +10 -133
  16. package/lib/src/apiClient.d.ts +52 -0
  17. package/lib/src/apiClient.js +231 -0
  18. package/lib/src/expression/Expression.d.ts +1 -1
  19. package/lib/src/expression/Expression.js +13 -122
  20. package/lib/src/expression/ExpressionClient.d.ts +3 -3
  21. package/lib/src/expression/ExpressionClient.js +13 -76
  22. package/lib/src/expression/ExpressionRef.js +2 -25
  23. package/lib/src/generated/api/AIModelLoadingStatus.d.ts +7 -0
  24. package/lib/src/generated/api/AIModelLoadingStatus.js +2 -0
  25. package/lib/src/generated/api/AddLinkExpressionRequest.d.ts +6 -0
  26. package/lib/src/generated/api/AddLinkExpressionRequest.js +1 -0
  27. package/lib/src/generated/api/AddLinkRequest.d.ts +6 -0
  28. package/lib/src/generated/api/AddLinkRequest.js +1 -0
  29. package/lib/src/generated/api/AddLinksBulkRequest.d.ts +6 -0
  30. package/lib/src/generated/api/AddLinksBulkRequest.js +1 -0
  31. package/lib/src/generated/api/AddSdnaRequest.d.ts +6 -0
  32. package/lib/src/generated/api/AddSdnaRequest.js +2 -0
  33. package/lib/src/generated/api/ApplyTemplateRequest.d.ts +4 -0
  34. package/lib/src/generated/api/ApplyTemplateRequest.js +2 -0
  35. package/lib/src/generated/api/AuthInfoInput.d.ts +10 -0
  36. package/lib/src/generated/api/AuthInfoInput.js +1 -0
  37. package/lib/src/generated/api/CapabilityInput.d.ts +5 -0
  38. package/lib/src/generated/api/CapabilityInput.js +1 -0
  39. package/lib/src/generated/api/CommitBatchRequest.d.ts +3 -0
  40. package/lib/src/generated/api/CommitBatchRequest.js +2 -0
  41. package/lib/src/generated/api/ComputeLogEntry.d.ts +9 -0
  42. package/lib/src/generated/api/ComputeLogEntry.js +2 -0
  43. package/lib/src/generated/api/CreateExpressionRequest.d.ts +4 -0
  44. package/lib/src/generated/api/CreateExpressionRequest.js +2 -0
  45. package/lib/src/generated/api/CreatePerspectiveRequest.d.ts +3 -0
  46. package/lib/src/generated/api/CreatePerspectiveRequest.js +2 -0
  47. package/lib/src/generated/api/CreateSubjectRequest.d.ts +6 -0
  48. package/lib/src/generated/api/CreateSubjectRequest.js +2 -0
  49. package/lib/src/generated/api/EmbedRequest.d.ts +4 -0
  50. package/lib/src/generated/api/EmbedRequest.js +2 -0
  51. package/lib/src/generated/api/EntanglementProofInput.d.ts +6 -0
  52. package/lib/src/generated/api/EntanglementProofInput.js +2 -0
  53. package/lib/src/generated/api/ExecuteCommandsRequest.d.ts +4 -0
  54. package/lib/src/generated/api/ExecuteCommandsRequest.js +2 -0
  55. package/lib/src/generated/api/ExportRequest.d.ts +5 -0
  56. package/lib/src/generated/api/ExportRequest.js +2 -0
  57. package/lib/src/generated/api/ExpressionManyRequest.d.ts +3 -0
  58. package/lib/src/generated/api/ExpressionManyRequest.js +2 -0
  59. package/lib/src/generated/api/ExpressionProof.d.ts +4 -0
  60. package/lib/src/generated/api/ExpressionProof.js +2 -0
  61. package/lib/src/generated/api/ExpressionProofInput.d.ts +6 -0
  62. package/lib/src/generated/api/ExpressionProofInput.js +2 -0
  63. package/lib/src/generated/api/FriendSendMessageRequest.d.ts +3 -0
  64. package/lib/src/generated/api/FriendSendMessageRequest.js +2 -0
  65. package/lib/src/generated/api/FriendsListRequest.d.ts +3 -0
  66. package/lib/src/generated/api/FriendsListRequest.js +2 -0
  67. package/lib/src/generated/api/GenerateAgentRequest.d.ts +3 -0
  68. package/lib/src/generated/api/GenerateAgentRequest.js +2 -0
  69. package/lib/src/generated/api/GenerateJwtRequest.d.ts +4 -0
  70. package/lib/src/generated/api/GenerateJwtRequest.js +2 -0
  71. package/lib/src/generated/api/GetSubjectDataRequest.d.ts +4 -0
  72. package/lib/src/generated/api/GetSubjectDataRequest.js +2 -0
  73. package/lib/src/generated/api/ImportAgentRequest.d.ts +6 -0
  74. package/lib/src/generated/api/ImportAgentRequest.js +2 -0
  75. package/lib/src/generated/api/ImportRequest.d.ts +4 -0
  76. package/lib/src/generated/api/ImportRequest.js +2 -0
  77. package/lib/src/generated/api/JoinNeighbourhoodRequest.d.ts +3 -0
  78. package/lib/src/generated/api/JoinNeighbourhoodRequest.js +2 -0
  79. package/lib/src/generated/api/LanguageMetaInput.d.ts +6 -0
  80. package/lib/src/generated/api/LanguageMetaInput.js +2 -0
  81. package/lib/src/generated/api/Link.d.ts +5 -0
  82. package/lib/src/generated/api/Link.js +2 -0
  83. package/lib/src/generated/api/LinkExpression.d.ts +10 -0
  84. package/lib/src/generated/api/LinkExpression.js +1 -0
  85. package/lib/src/generated/api/LinkExpressionInput.d.ts +10 -0
  86. package/lib/src/generated/api/LinkExpressionInput.js +1 -0
  87. package/lib/src/generated/api/LinkInput.d.ts +5 -0
  88. package/lib/src/generated/api/LinkInput.js +2 -0
  89. package/lib/src/generated/api/LinkLanguageTemplatesRequest.d.ts +3 -0
  90. package/lib/src/generated/api/LinkLanguageTemplatesRequest.js +2 -0
  91. package/lib/src/generated/api/LinkMutations.d.ts +6 -0
  92. package/lib/src/generated/api/LinkMutations.js +1 -0
  93. package/lib/src/generated/api/LinkStatus.d.ts +1 -0
  94. package/lib/src/generated/api/LinkStatus.js +2 -0
  95. package/lib/src/generated/api/LockAgentRequest.d.ts +3 -0
  96. package/lib/src/generated/api/LockAgentRequest.js +2 -0
  97. package/lib/src/generated/api/ModelType.d.ts +1 -0
  98. package/lib/src/generated/api/ModelType.js +2 -0
  99. package/lib/src/generated/api/NotificationInput.d.ts +10 -0
  100. package/lib/src/generated/api/NotificationInput.js +2 -0
  101. package/lib/src/generated/api/OpenLinkRequest.d.ts +3 -0
  102. package/lib/src/generated/api/OpenLinkRequest.js +2 -0
  103. package/lib/src/generated/api/PermitCapabilityRequest.d.ts +3 -0
  104. package/lib/src/generated/api/PermitCapabilityRequest.js +2 -0
  105. package/lib/src/generated/api/PerspectiveInput.d.ts +4 -0
  106. package/lib/src/generated/api/PerspectiveInput.js +1 -0
  107. package/lib/src/generated/api/PromptRequest.d.ts +4 -0
  108. package/lib/src/generated/api/PromptRequest.js +2 -0
  109. package/lib/src/generated/api/PublishLanguageRequest.d.ts +5 -0
  110. package/lib/src/generated/api/PublishLanguageRequest.js +1 -0
  111. package/lib/src/generated/api/PublishNeighbourhoodRequest.d.ts +6 -0
  112. package/lib/src/generated/api/PublishNeighbourhoodRequest.js +1 -0
  113. package/lib/src/generated/api/QueryRequest.d.ts +7 -0
  114. package/lib/src/generated/api/QueryRequest.js +2 -0
  115. package/lib/src/generated/api/RemoveLinkRequest.d.ts +5 -0
  116. package/lib/src/generated/api/RemoveLinkRequest.js +1 -0
  117. package/lib/src/generated/api/RemoveLinksBulkRequest.d.ts +5 -0
  118. package/lib/src/generated/api/RemoveLinksBulkRequest.js +1 -0
  119. package/lib/src/generated/api/ResourceInput.d.ts +4 -0
  120. package/lib/src/generated/api/ResourceInput.js +2 -0
  121. package/lib/src/generated/api/SetDefaultModelRequest.d.ts +4 -0
  122. package/lib/src/generated/api/SetDefaultModelRequest.js +1 -0
  123. package/lib/src/generated/api/SetFreeHostingEnabledRequest.d.ts +3 -0
  124. package/lib/src/generated/api/SetFreeHostingEnabledRequest.js +2 -0
  125. package/lib/src/generated/api/SetMultiUserRequest.d.ts +3 -0
  126. package/lib/src/generated/api/SetMultiUserRequest.js +2 -0
  127. package/lib/src/generated/api/SetStatusRequest.d.ts +3 -0
  128. package/lib/src/generated/api/SetStatusRequest.js +2 -0
  129. package/lib/src/generated/api/SignMessageRequest.d.ts +3 -0
  130. package/lib/src/generated/api/SignMessageRequest.js +2 -0
  131. package/lib/src/generated/api/TrustedAgentsRequest.d.ts +3 -0
  132. package/lib/src/generated/api/TrustedAgentsRequest.js +2 -0
  133. package/lib/src/generated/api/UnlockAgentRequest.d.ts +4 -0
  134. package/lib/src/generated/api/UnlockAgentRequest.js +2 -0
  135. package/lib/src/generated/api/UpdateLinkRequest.d.ts +7 -0
  136. package/lib/src/generated/api/UpdateLinkRequest.js +1 -0
  137. package/lib/src/generated/api/UpdatePerspectiveRequest.d.ts +3 -0
  138. package/lib/src/generated/api/UpdatePerspectiveRequest.js +2 -0
  139. package/lib/src/generated/api/UserStatistics.d.ts +9 -0
  140. package/lib/src/generated/api/UserStatistics.js +2 -0
  141. package/lib/src/generated/api/VerificationRequestResult.d.ts +6 -0
  142. package/lib/src/generated/api/VerificationRequestResult.js +2 -0
  143. package/lib/src/generated/api/VerifySignatureRequest.d.ts +5 -0
  144. package/lib/src/generated/api/VerifySignatureRequest.js +2 -0
  145. package/lib/src/generated/api/WriteSettingsRequest.d.ts +3 -0
  146. package/lib/src/generated/api/WriteSettingsRequest.js +2 -0
  147. package/lib/src/generated/api/index.d.ts +42 -0
  148. package/lib/src/generated/api/index.js +7 -0
  149. package/lib/src/index.d.ts +6 -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 +57 -38
  163. package/lib/src/model/Ad4mModel.js +594 -460
  164. package/lib/src/model/Ad4mModel.test.js +371 -815
  165. package/lib/src/model/ModelQueryBuilder.d.ts +9 -21
  166. package/lib/src/model/ModelQueryBuilder.js +138 -217
  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 +7 -60
  170. package/lib/src/model/hydration.js +7 -716
  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/shacl-gen.js +4 -0
  179. package/lib/src/model/types.d.ts +47 -38
  180. package/lib/src/model/types.js +4 -1
  181. package/lib/src/neighbourhood/Neighbourhood.js +4 -32
  182. package/lib/src/neighbourhood/NeighbourhoodClient.d.ts +3 -3
  183. package/lib/src/neighbourhood/NeighbourhoodClient.js +40 -203
  184. package/lib/src/perspectives/LinkQuery.js +2 -42
  185. package/lib/src/perspectives/Perspective.d.ts +1 -1
  186. package/lib/src/perspectives/Perspective.js +10 -52
  187. package/lib/src/perspectives/PerspectiveClient.d.ts +12 -17
  188. package/lib/src/perspectives/PerspectiveClient.js +169 -429
  189. package/lib/src/perspectives/PerspectiveClient.test.js +55 -0
  190. package/lib/src/perspectives/PerspectiveDiff.js +4 -31
  191. package/lib/src/perspectives/PerspectiveHandle.js +3 -43
  192. package/lib/src/perspectives/PerspectiveProxy.d.ts +92 -71
  193. package/lib/src/perspectives/PerspectiveProxy.js +273 -310
  194. package/lib/src/runtime/RuntimeClient.d.ts +6 -6
  195. package/lib/src/runtime/RuntimeClient.js +93 -467
  196. package/lib/src/runtime/RuntimeTypes.d.ts +101 -0
  197. package/lib/src/runtime/RuntimeTypes.js +45 -0
  198. package/lib/src/shacl/SHACLShape.d.ts +7 -0
  199. package/lib/src/shacl/SHACLShape.js +19 -0
  200. package/lib/src/shacl/SHACLShape.test.js +82 -0
  201. package/lib/src/typeDefs.js +3 -628
  202. package/package.json +9 -24
  203. package/rollup.config.js +0 -7
  204. package/src/Ad4mClient.test.ts +1179 -1340
  205. package/src/Ad4mClient.ts +30 -15
  206. package/src/agent/Agent.ts +0 -99
  207. package/src/agent/AgentClient.ts +112 -526
  208. package/src/agent/AgentStatus.ts +0 -12
  209. package/src/ai/AIClient.ts +96 -296
  210. package/src/ai/AITypes.ts +66 -0
  211. package/src/ai/Tasks.ts +0 -52
  212. package/src/apiClient.ts +283 -0
  213. package/src/expression/Expression.ts +3 -43
  214. package/src/expression/ExpressionClient.ts +14 -77
  215. package/src/expression/ExpressionRef.ts +0 -6
  216. package/src/generated/api/AIModelLoadingStatus.ts +3 -0
  217. package/src/generated/api/AddLinkExpressionRequest.ts +4 -0
  218. package/src/generated/api/AddLinkRequest.ts +4 -0
  219. package/src/generated/api/AddLinksBulkRequest.ts +4 -0
  220. package/src/generated/api/AddSdnaRequest.ts +3 -0
  221. package/src/generated/api/ApplyTemplateRequest.ts +3 -0
  222. package/src/generated/api/AuthInfoInput.ts +4 -0
  223. package/src/generated/api/CapabilityInput.ts +4 -0
  224. package/src/generated/api/CommitBatchRequest.ts +3 -0
  225. package/src/generated/api/ComputeLogEntry.ts +3 -0
  226. package/src/generated/api/CreateExpressionRequest.ts +3 -0
  227. package/src/generated/api/CreatePerspectiveRequest.ts +3 -0
  228. package/src/generated/api/CreateSubjectRequest.ts +3 -0
  229. package/src/generated/api/EmbedRequest.ts +3 -0
  230. package/src/generated/api/EntanglementProofInput.ts +3 -0
  231. package/src/generated/api/ExecuteCommandsRequest.ts +3 -0
  232. package/src/generated/api/ExportRequest.ts +3 -0
  233. package/src/generated/api/ExpressionManyRequest.ts +3 -0
  234. package/src/generated/api/ExpressionProof.ts +3 -0
  235. package/src/generated/api/ExpressionProofInput.ts +3 -0
  236. package/src/generated/api/FriendSendMessageRequest.ts +3 -0
  237. package/src/generated/api/FriendsListRequest.ts +3 -0
  238. package/src/generated/api/GenerateAgentRequest.ts +3 -0
  239. package/src/generated/api/GenerateJwtRequest.ts +3 -0
  240. package/src/generated/api/GetSubjectDataRequest.ts +3 -0
  241. package/src/generated/api/ImportAgentRequest.ts +3 -0
  242. package/src/generated/api/ImportRequest.ts +3 -0
  243. package/src/generated/api/JoinNeighbourhoodRequest.ts +3 -0
  244. package/src/generated/api/LanguageMetaInput.ts +3 -0
  245. package/src/generated/api/Link.ts +3 -0
  246. package/src/generated/api/LinkExpression.ts +6 -0
  247. package/src/generated/api/LinkExpressionInput.ts +6 -0
  248. package/src/generated/api/LinkInput.ts +3 -0
  249. package/src/generated/api/LinkLanguageTemplatesRequest.ts +3 -0
  250. package/src/generated/api/LinkMutations.ts +5 -0
  251. package/src/generated/api/LinkStatus.ts +3 -0
  252. package/src/generated/api/LockAgentRequest.ts +3 -0
  253. package/src/generated/api/ModelType.ts +3 -0
  254. package/src/generated/api/NotificationInput.ts +3 -0
  255. package/src/generated/api/OpenLinkRequest.ts +3 -0
  256. package/src/generated/api/PermitCapabilityRequest.ts +3 -0
  257. package/src/generated/api/PerspectiveInput.ts +4 -0
  258. package/src/generated/api/PromptRequest.ts +3 -0
  259. package/src/generated/api/PublishLanguageRequest.ts +4 -0
  260. package/src/generated/api/PublishNeighbourhoodRequest.ts +4 -0
  261. package/src/generated/api/QueryRequest.ts +6 -0
  262. package/src/generated/api/RemoveLinkRequest.ts +4 -0
  263. package/src/generated/api/RemoveLinksBulkRequest.ts +4 -0
  264. package/src/generated/api/ResourceInput.ts +3 -0
  265. package/src/generated/api/SetDefaultModelRequest.ts +4 -0
  266. package/src/generated/api/SetFreeHostingEnabledRequest.ts +3 -0
  267. package/src/generated/api/SetMultiUserRequest.ts +3 -0
  268. package/src/generated/api/SetStatusRequest.ts +3 -0
  269. package/src/generated/api/SignMessageRequest.ts +3 -0
  270. package/src/generated/api/TrustedAgentsRequest.ts +3 -0
  271. package/src/generated/api/UnlockAgentRequest.ts +3 -0
  272. package/src/generated/api/UpdateLinkRequest.ts +5 -0
  273. package/src/generated/api/UpdatePerspectiveRequest.ts +3 -0
  274. package/src/generated/api/UserStatistics.ts +3 -0
  275. package/src/generated/api/VerificationRequestResult.ts +3 -0
  276. package/src/generated/api/VerifySignatureRequest.ts +3 -0
  277. package/src/generated/api/WriteSettingsRequest.ts +3 -0
  278. package/src/generated/api/index.ts +49 -0
  279. package/src/index.ts +6 -1
  280. package/src/jestSetup.ts +1 -1
  281. package/src/language/Icon.ts +0 -4
  282. package/src/language/Language.ts +2 -23
  283. package/src/language/LanguageClient.ts +21 -132
  284. package/src/language/LanguageHandle.ts +0 -14
  285. package/src/language/LanguageMeta.ts +0 -29
  286. package/src/language/LanguageRef.ts +0 -7
  287. package/src/links/Links.ts +0 -37
  288. package/src/model/Ad4mModel.test.ts +708 -876
  289. package/src/model/Ad4mModel.ts +613 -508
  290. package/src/model/ModelQueryBuilder.ts +178 -244
  291. package/src/model/decorators.ts +29 -0
  292. package/src/model/hydration.ts +9 -766
  293. package/src/model/index.ts +0 -4
  294. package/src/model/query-sparql.test.ts +34 -242
  295. package/src/model/query-sparql.ts +27 -337
  296. package/src/model/shacl-gen.ts +5 -0
  297. package/src/model/types.ts +51 -39
  298. package/src/neighbourhood/Neighbourhood.ts +0 -9
  299. package/src/neighbourhood/NeighbourhoodClient.ts +42 -207
  300. package/src/neighbourhood/NeighbourhoodProxy.test.ts +34 -36
  301. package/src/perspectives/LinkQuery.ts +0 -15
  302. package/src/perspectives/Perspective.ts +1 -12
  303. package/src/perspectives/PerspectiveClient.test.ts +206 -148
  304. package/src/perspectives/PerspectiveClient.ts +228 -442
  305. package/src/perspectives/PerspectiveDiff.ts +0 -8
  306. package/src/perspectives/PerspectiveHandle.ts +1 -12
  307. package/src/perspectives/PerspectiveProxy.test.ts +41 -0
  308. package/src/perspectives/PerspectiveProxy.ts +307 -348
  309. package/src/runtime/RuntimeClient.ts +112 -474
  310. package/src/runtime/RuntimeTypes.ts +144 -0
  311. package/src/shacl/SHACLShape.test.ts +94 -0
  312. package/src/shacl/SHACLShape.ts +27 -0
  313. package/src/typeDefs.ts +3 -5
  314. package/tsconfig.json +3 -7
  315. package/shims/reflect-metadata.ts +0 -0
  316. package/shims/type-graphql.ts +0 -75
  317. package/src/PubSub.ts +0 -17
  318. package/src/agent/AgentResolver.ts +0 -263
  319. package/src/ai/AIResolver.ts +0 -372
  320. package/src/buildSchema.ts +0 -43
  321. package/src/expression/ExpressionResolver.ts +0 -64
  322. package/src/language/LanguageResolver.ts +0 -98
  323. package/src/model/Subject.ts +0 -159
  324. package/src/model/hydration-batch.ts +0 -205
  325. package/src/model/hydration-batching.test.ts +0 -563
  326. package/src/model/prolog-facts.ts +0 -145
  327. package/src/model/query-prolog.ts +0 -148
  328. package/src/model/query-sparql-batch.ts +0 -301
  329. package/src/model/subscription-delta.test.ts +0 -207
  330. package/src/model/subscription-pool.ts +0 -211
  331. package/src/neighbourhood/NeighbourhoodResolver.ts +0 -100
  332. package/src/perspectives/PerspectiveResolver.ts +0 -364
  333. package/src/runtime/RuntimeResolver.ts +0 -749
  334. 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
- }