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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (347) hide show
  1. package/README.md +2 -25
  2. package/jest-setup.ts +1 -1
  3. package/lib/index.cjs +2805 -10556
  4. package/lib/index.js +2513 -10322
  5. package/lib/src/Ad4mClient.d.ts +7 -3
  6. package/lib/src/Ad4mClient.js +29 -13
  7. package/lib/src/agent/Agent.js +26 -272
  8. package/lib/src/agent/AgentClient.d.ts +10 -21
  9. package/lib/src/agent/AgentClient.js +75 -427
  10. package/lib/src/agent/AgentStatus.js +2 -37
  11. package/lib/src/ai/AIClient.d.ts +12 -4
  12. package/lib/src/ai/AIClient.js +81 -285
  13. package/lib/src/ai/AITypes.d.ts +55 -0
  14. package/lib/src/ai/AITypes.js +18 -0
  15. package/lib/src/ai/Tasks.js +10 -133
  16. package/lib/src/apiClient.d.ts +52 -0
  17. package/lib/src/apiClient.js +231 -0
  18. package/lib/src/expression/Expression.d.ts +1 -1
  19. package/lib/src/expression/Expression.js +13 -122
  20. package/lib/src/expression/ExpressionClient.d.ts +3 -3
  21. package/lib/src/expression/ExpressionClient.js +13 -76
  22. package/lib/src/expression/ExpressionRef.js +2 -25
  23. package/lib/src/generated/api/AIModelLoadingStatus.d.ts +7 -0
  24. package/lib/src/generated/api/AIModelLoadingStatus.js +2 -0
  25. package/lib/src/generated/api/AddLinkExpressionRequest.d.ts +6 -0
  26. package/lib/src/generated/api/AddLinkExpressionRequest.js +1 -0
  27. package/lib/src/generated/api/AddLinkRequest.d.ts +6 -0
  28. package/lib/src/generated/api/AddLinkRequest.js +1 -0
  29. package/lib/src/generated/api/AddLinksBulkRequest.d.ts +6 -0
  30. package/lib/src/generated/api/AddLinksBulkRequest.js +1 -0
  31. package/lib/src/generated/api/AddSdnaRequest.d.ts +6 -0
  32. package/lib/src/generated/api/AddSdnaRequest.js +2 -0
  33. package/lib/src/generated/api/ApplyTemplateRequest.d.ts +4 -0
  34. package/lib/src/generated/api/ApplyTemplateRequest.js +2 -0
  35. package/lib/src/generated/api/AuthInfoInput.d.ts +10 -0
  36. package/lib/src/generated/api/AuthInfoInput.js +1 -0
  37. package/lib/src/generated/api/CapabilityInput.d.ts +5 -0
  38. package/lib/src/generated/api/CapabilityInput.js +1 -0
  39. package/lib/src/generated/api/CommitBatchRequest.d.ts +3 -0
  40. package/lib/src/generated/api/CommitBatchRequest.js +2 -0
  41. package/lib/src/generated/api/ComputeLogEntry.d.ts +9 -0
  42. package/lib/src/generated/api/ComputeLogEntry.js +2 -0
  43. package/lib/src/generated/api/CreateExpressionRequest.d.ts +4 -0
  44. package/lib/src/generated/api/CreateExpressionRequest.js +2 -0
  45. package/lib/src/generated/api/CreatePerspectiveRequest.d.ts +3 -0
  46. package/lib/src/generated/api/CreatePerspectiveRequest.js +2 -0
  47. package/lib/src/generated/api/CreateSubjectRequest.d.ts +6 -0
  48. package/lib/src/generated/api/CreateSubjectRequest.js +2 -0
  49. package/lib/src/generated/api/EmbedRequest.d.ts +4 -0
  50. package/lib/src/generated/api/EmbedRequest.js +2 -0
  51. package/lib/src/generated/api/EntanglementProofInput.d.ts +6 -0
  52. package/lib/src/generated/api/EntanglementProofInput.js +2 -0
  53. package/lib/src/generated/api/ExecuteCommandsRequest.d.ts +4 -0
  54. package/lib/src/generated/api/ExecuteCommandsRequest.js +2 -0
  55. package/lib/src/generated/api/ExportRequest.d.ts +5 -0
  56. package/lib/src/generated/api/ExportRequest.js +2 -0
  57. package/lib/src/generated/api/ExpressionManyRequest.d.ts +3 -0
  58. package/lib/src/generated/api/ExpressionManyRequest.js +2 -0
  59. package/lib/src/generated/api/ExpressionProof.d.ts +4 -0
  60. package/lib/src/generated/api/ExpressionProof.js +2 -0
  61. package/lib/src/generated/api/ExpressionProofInput.d.ts +6 -0
  62. package/lib/src/generated/api/ExpressionProofInput.js +2 -0
  63. package/lib/src/generated/api/FriendSendMessageRequest.d.ts +3 -0
  64. package/lib/src/generated/api/FriendSendMessageRequest.js +2 -0
  65. package/lib/src/generated/api/FriendsListRequest.d.ts +3 -0
  66. package/lib/src/generated/api/FriendsListRequest.js +2 -0
  67. package/lib/src/generated/api/GenerateAgentRequest.d.ts +3 -0
  68. package/lib/src/generated/api/GenerateAgentRequest.js +2 -0
  69. package/lib/src/generated/api/GenerateJwtRequest.d.ts +4 -0
  70. package/lib/src/generated/api/GenerateJwtRequest.js +2 -0
  71. package/lib/src/generated/api/GetSubjectDataRequest.d.ts +4 -0
  72. package/lib/src/generated/api/GetSubjectDataRequest.js +2 -0
  73. package/lib/src/generated/api/ImportAgentRequest.d.ts +6 -0
  74. package/lib/src/generated/api/ImportAgentRequest.js +2 -0
  75. package/lib/src/generated/api/ImportRequest.d.ts +4 -0
  76. package/lib/src/generated/api/ImportRequest.js +2 -0
  77. package/lib/src/generated/api/JoinNeighbourhoodRequest.d.ts +3 -0
  78. package/lib/src/generated/api/JoinNeighbourhoodRequest.js +2 -0
  79. package/lib/src/generated/api/LanguageMetaInput.d.ts +6 -0
  80. package/lib/src/generated/api/LanguageMetaInput.js +2 -0
  81. package/lib/src/generated/api/Link.d.ts +5 -0
  82. package/lib/src/generated/api/Link.js +2 -0
  83. package/lib/src/generated/api/LinkExpression.d.ts +10 -0
  84. package/lib/src/generated/api/LinkExpression.js +1 -0
  85. package/lib/src/generated/api/LinkExpressionInput.d.ts +10 -0
  86. package/lib/src/generated/api/LinkExpressionInput.js +1 -0
  87. package/lib/src/generated/api/LinkInput.d.ts +5 -0
  88. package/lib/src/generated/api/LinkInput.js +2 -0
  89. package/lib/src/generated/api/LinkLanguageTemplatesRequest.d.ts +3 -0
  90. package/lib/src/generated/api/LinkLanguageTemplatesRequest.js +2 -0
  91. package/lib/src/generated/api/LinkMutations.d.ts +6 -0
  92. package/lib/src/generated/api/LinkMutations.js +1 -0
  93. package/lib/src/generated/api/LinkStatus.d.ts +1 -0
  94. package/lib/src/generated/api/LinkStatus.js +2 -0
  95. package/lib/src/generated/api/LockAgentRequest.d.ts +3 -0
  96. package/lib/src/generated/api/LockAgentRequest.js +2 -0
  97. package/lib/src/generated/api/ModelType.d.ts +1 -0
  98. package/lib/src/generated/api/ModelType.js +2 -0
  99. package/lib/src/generated/api/NotificationInput.d.ts +10 -0
  100. package/lib/src/generated/api/NotificationInput.js +2 -0
  101. package/lib/src/generated/api/OpenLinkRequest.d.ts +3 -0
  102. package/lib/src/generated/api/OpenLinkRequest.js +2 -0
  103. package/lib/src/generated/api/PermitCapabilityRequest.d.ts +3 -0
  104. package/lib/src/generated/api/PermitCapabilityRequest.js +2 -0
  105. package/lib/src/generated/api/PerspectiveInput.d.ts +4 -0
  106. package/lib/src/generated/api/PerspectiveInput.js +1 -0
  107. package/lib/src/generated/api/PromptRequest.d.ts +4 -0
  108. package/lib/src/generated/api/PromptRequest.js +2 -0
  109. package/lib/src/generated/api/PublishLanguageRequest.d.ts +5 -0
  110. package/lib/src/generated/api/PublishLanguageRequest.js +1 -0
  111. package/lib/src/generated/api/PublishNeighbourhoodRequest.d.ts +6 -0
  112. package/lib/src/generated/api/PublishNeighbourhoodRequest.js +1 -0
  113. package/lib/src/generated/api/QueryRequest.d.ts +7 -0
  114. package/lib/src/generated/api/QueryRequest.js +2 -0
  115. package/lib/src/generated/api/RemoveLinkRequest.d.ts +5 -0
  116. package/lib/src/generated/api/RemoveLinkRequest.js +1 -0
  117. package/lib/src/generated/api/RemoveLinksBulkRequest.d.ts +5 -0
  118. package/lib/src/generated/api/RemoveLinksBulkRequest.js +1 -0
  119. package/lib/src/generated/api/ResourceInput.d.ts +4 -0
  120. package/lib/src/generated/api/ResourceInput.js +2 -0
  121. package/lib/src/generated/api/SetDefaultModelRequest.d.ts +4 -0
  122. package/lib/src/generated/api/SetDefaultModelRequest.js +1 -0
  123. package/lib/src/generated/api/SetFreeHostingEnabledRequest.d.ts +3 -0
  124. package/lib/src/generated/api/SetFreeHostingEnabledRequest.js +2 -0
  125. package/lib/src/generated/api/SetMultiUserRequest.d.ts +3 -0
  126. package/lib/src/generated/api/SetMultiUserRequest.js +2 -0
  127. package/lib/src/generated/api/SetStatusRequest.d.ts +3 -0
  128. package/lib/src/generated/api/SetStatusRequest.js +2 -0
  129. package/lib/src/generated/api/SignMessageRequest.d.ts +3 -0
  130. package/lib/src/generated/api/SignMessageRequest.js +2 -0
  131. package/lib/src/generated/api/TrustedAgentsRequest.d.ts +3 -0
  132. package/lib/src/generated/api/TrustedAgentsRequest.js +2 -0
  133. package/lib/src/generated/api/UnlockAgentRequest.d.ts +4 -0
  134. package/lib/src/generated/api/UnlockAgentRequest.js +2 -0
  135. package/lib/src/generated/api/UpdateLinkRequest.d.ts +7 -0
  136. package/lib/src/generated/api/UpdateLinkRequest.js +1 -0
  137. package/lib/src/generated/api/UpdatePerspectiveRequest.d.ts +3 -0
  138. package/lib/src/generated/api/UpdatePerspectiveRequest.js +2 -0
  139. package/lib/src/generated/api/UserStatistics.d.ts +9 -0
  140. package/lib/src/generated/api/UserStatistics.js +2 -0
  141. package/lib/src/generated/api/VerificationRequestResult.d.ts +6 -0
  142. package/lib/src/generated/api/VerificationRequestResult.js +2 -0
  143. package/lib/src/generated/api/VerifySignatureRequest.d.ts +5 -0
  144. package/lib/src/generated/api/VerifySignatureRequest.js +2 -0
  145. package/lib/src/generated/api/WriteSettingsRequest.d.ts +3 -0
  146. package/lib/src/generated/api/WriteSettingsRequest.js +2 -0
  147. package/lib/src/generated/api/index.d.ts +42 -0
  148. package/lib/src/generated/api/index.js +7 -0
  149. package/lib/src/index.d.ts +6 -2
  150. package/lib/src/index.js +6 -2
  151. package/lib/src/jestSetup.d.ts +0 -1
  152. package/lib/src/jestSetup.js +1 -1
  153. package/lib/src/language/Icon.js +2 -21
  154. package/lib/src/language/Language.d.ts +26 -214
  155. package/lib/src/language/Language.js +32 -72
  156. package/lib/src/language/LanguageClient.d.ts +2 -2
  157. package/lib/src/language/LanguageClient.js +15 -105
  158. package/lib/src/language/LanguageHandle.js +2 -41
  159. package/lib/src/language/LanguageMeta.js +4 -75
  160. package/lib/src/language/LanguageRef.js +2 -25
  161. package/lib/src/links/Links.js +14 -111
  162. package/lib/src/model/Ad4mModel.d.ts +81 -38
  163. package/lib/src/model/Ad4mModel.js +651 -408
  164. package/lib/src/model/Ad4mModel.test.js +488 -750
  165. package/lib/src/model/ModelQueryBuilder.d.ts +28 -21
  166. package/lib/src/model/ModelQueryBuilder.js +160 -195
  167. package/lib/src/model/decorators.d.ts +22 -0
  168. package/lib/src/model/decorators.js +7 -0
  169. package/lib/src/model/hydration-batching.test.d.ts +7 -0
  170. package/lib/src/model/hydration-batching.test.js +456 -0
  171. package/lib/src/model/hydration.d.ts +8 -60
  172. package/lib/src/model/hydration.js +41 -541
  173. package/lib/src/model/index.d.ts +0 -4
  174. package/lib/src/model/index.js +0 -4
  175. package/lib/src/model/model-manifest.d.ts +41 -0
  176. package/lib/src/model/model-manifest.js +11 -0
  177. package/lib/src/model/query-sparql.d.ts +36 -22
  178. package/lib/src/model/query-sparql.js +188 -53
  179. package/lib/src/model/query-sparql.test.d.ts +1 -0
  180. package/lib/src/model/query-sparql.test.js +312 -0
  181. package/lib/src/model/query-utils.js +4 -0
  182. package/lib/src/model/shacl-gen.js +4 -0
  183. package/lib/src/model/subscription-delta.test.d.ts +24 -0
  184. package/lib/src/model/subscription-delta.test.js +180 -0
  185. package/lib/src/model/subscription-pool.js +48 -2
  186. package/lib/src/model/types.d.ts +58 -1
  187. package/lib/src/model/types.js +4 -1
  188. package/lib/src/neighbourhood/Neighbourhood.js +4 -32
  189. package/lib/src/neighbourhood/NeighbourhoodClient.d.ts +3 -3
  190. package/lib/src/neighbourhood/NeighbourhoodClient.js +40 -203
  191. package/lib/src/perspectives/LinkQuery.js +2 -42
  192. package/lib/src/perspectives/Perspective.d.ts +1 -1
  193. package/lib/src/perspectives/Perspective.js +10 -52
  194. package/lib/src/perspectives/PerspectiveClient.d.ts +12 -15
  195. package/lib/src/perspectives/PerspectiveClient.js +168 -400
  196. package/lib/src/perspectives/PerspectiveClient.test.d.ts +1 -0
  197. package/lib/src/perspectives/PerspectiveClient.test.js +224 -0
  198. package/lib/src/perspectives/PerspectiveDiff.js +4 -31
  199. package/lib/src/perspectives/PerspectiveHandle.js +3 -43
  200. package/lib/src/perspectives/PerspectiveProxy.d.ts +95 -71
  201. package/lib/src/perspectives/PerspectiveProxy.js +288 -310
  202. package/lib/src/runtime/RuntimeClient.d.ts +6 -6
  203. package/lib/src/runtime/RuntimeClient.js +93 -467
  204. package/lib/src/runtime/RuntimeTypes.d.ts +101 -0
  205. package/lib/src/runtime/RuntimeTypes.js +45 -0
  206. package/lib/src/shacl/SHACLShape.d.ts +7 -0
  207. package/lib/src/shacl/SHACLShape.js +19 -0
  208. package/lib/src/shacl/SHACLShape.test.js +82 -0
  209. package/lib/src/typeDefs.js +3 -628
  210. package/package.json +9 -24
  211. package/rollup.config.js +0 -7
  212. package/src/Ad4mClient.test.ts +1182 -1288
  213. package/src/Ad4mClient.ts +30 -15
  214. package/src/agent/Agent.ts +0 -99
  215. package/src/agent/AgentClient.ts +112 -526
  216. package/src/agent/AgentStatus.ts +0 -12
  217. package/src/ai/AIClient.ts +96 -296
  218. package/src/ai/AITypes.ts +66 -0
  219. package/src/ai/Tasks.ts +0 -52
  220. package/src/apiClient.ts +283 -0
  221. package/src/expression/Expression.ts +3 -43
  222. package/src/expression/ExpressionClient.ts +14 -77
  223. package/src/expression/ExpressionRef.ts +0 -6
  224. package/src/generated/api/AIModelLoadingStatus.ts +3 -0
  225. package/src/generated/api/AddLinkExpressionRequest.ts +4 -0
  226. package/src/generated/api/AddLinkRequest.ts +4 -0
  227. package/src/generated/api/AddLinksBulkRequest.ts +4 -0
  228. package/src/generated/api/AddSdnaRequest.ts +3 -0
  229. package/src/generated/api/ApplyTemplateRequest.ts +3 -0
  230. package/src/generated/api/AuthInfoInput.ts +4 -0
  231. package/src/generated/api/CapabilityInput.ts +4 -0
  232. package/src/generated/api/CommitBatchRequest.ts +3 -0
  233. package/src/generated/api/ComputeLogEntry.ts +3 -0
  234. package/src/generated/api/CreateExpressionRequest.ts +3 -0
  235. package/src/generated/api/CreatePerspectiveRequest.ts +3 -0
  236. package/src/generated/api/CreateSubjectRequest.ts +3 -0
  237. package/src/generated/api/EmbedRequest.ts +3 -0
  238. package/src/generated/api/EntanglementProofInput.ts +3 -0
  239. package/src/generated/api/ExecuteCommandsRequest.ts +3 -0
  240. package/src/generated/api/ExportRequest.ts +3 -0
  241. package/src/generated/api/ExpressionManyRequest.ts +3 -0
  242. package/src/generated/api/ExpressionProof.ts +3 -0
  243. package/src/generated/api/ExpressionProofInput.ts +3 -0
  244. package/src/generated/api/FriendSendMessageRequest.ts +3 -0
  245. package/src/generated/api/FriendsListRequest.ts +3 -0
  246. package/src/generated/api/GenerateAgentRequest.ts +3 -0
  247. package/src/generated/api/GenerateJwtRequest.ts +3 -0
  248. package/src/generated/api/GetSubjectDataRequest.ts +3 -0
  249. package/src/generated/api/ImportAgentRequest.ts +3 -0
  250. package/src/generated/api/ImportRequest.ts +3 -0
  251. package/src/generated/api/JoinNeighbourhoodRequest.ts +3 -0
  252. package/src/generated/api/LanguageMetaInput.ts +3 -0
  253. package/src/generated/api/Link.ts +3 -0
  254. package/src/generated/api/LinkExpression.ts +6 -0
  255. package/src/generated/api/LinkExpressionInput.ts +6 -0
  256. package/src/generated/api/LinkInput.ts +3 -0
  257. package/src/generated/api/LinkLanguageTemplatesRequest.ts +3 -0
  258. package/src/generated/api/LinkMutations.ts +5 -0
  259. package/src/generated/api/LinkStatus.ts +3 -0
  260. package/src/generated/api/LockAgentRequest.ts +3 -0
  261. package/src/generated/api/ModelType.ts +3 -0
  262. package/src/generated/api/NotificationInput.ts +3 -0
  263. package/src/generated/api/OpenLinkRequest.ts +3 -0
  264. package/src/generated/api/PermitCapabilityRequest.ts +3 -0
  265. package/src/generated/api/PerspectiveInput.ts +4 -0
  266. package/src/generated/api/PromptRequest.ts +3 -0
  267. package/src/generated/api/PublishLanguageRequest.ts +4 -0
  268. package/src/generated/api/PublishNeighbourhoodRequest.ts +4 -0
  269. package/src/generated/api/QueryRequest.ts +6 -0
  270. package/src/generated/api/RemoveLinkRequest.ts +4 -0
  271. package/src/generated/api/RemoveLinksBulkRequest.ts +4 -0
  272. package/src/generated/api/ResourceInput.ts +3 -0
  273. package/src/generated/api/SetDefaultModelRequest.ts +4 -0
  274. package/src/generated/api/SetFreeHostingEnabledRequest.ts +3 -0
  275. package/src/generated/api/SetMultiUserRequest.ts +3 -0
  276. package/src/generated/api/SetStatusRequest.ts +3 -0
  277. package/src/generated/api/SignMessageRequest.ts +3 -0
  278. package/src/generated/api/TrustedAgentsRequest.ts +3 -0
  279. package/src/generated/api/UnlockAgentRequest.ts +3 -0
  280. package/src/generated/api/UpdateLinkRequest.ts +5 -0
  281. package/src/generated/api/UpdatePerspectiveRequest.ts +3 -0
  282. package/src/generated/api/UserStatistics.ts +3 -0
  283. package/src/generated/api/VerificationRequestResult.ts +3 -0
  284. package/src/generated/api/VerifySignatureRequest.ts +3 -0
  285. package/src/generated/api/WriteSettingsRequest.ts +3 -0
  286. package/src/generated/api/index.ts +49 -0
  287. package/src/index.ts +6 -2
  288. package/src/jestSetup.ts +1 -1
  289. package/src/language/Icon.ts +0 -4
  290. package/src/language/Language.ts +50 -292
  291. package/src/language/LanguageClient.ts +21 -132
  292. package/src/language/LanguageHandle.ts +0 -14
  293. package/src/language/LanguageMeta.ts +0 -29
  294. package/src/language/LanguageRef.ts +0 -7
  295. package/src/links/Links.ts +0 -37
  296. package/src/model/Ad4mModel.test.ts +827 -808
  297. package/src/model/Ad4mModel.ts +676 -457
  298. package/src/model/ModelQueryBuilder.ts +199 -217
  299. package/src/model/decorators.ts +29 -0
  300. package/src/model/hydration.ts +17 -572
  301. package/src/model/index.ts +0 -4
  302. package/src/model/query-sparql.test.ts +360 -0
  303. package/src/model/query-sparql.ts +203 -56
  304. package/src/model/query-utils.ts +4 -0
  305. package/src/model/shacl-gen.ts +5 -0
  306. package/src/model/types.ts +62 -1
  307. package/src/neighbourhood/Neighbourhood.ts +0 -9
  308. package/src/neighbourhood/NeighbourhoodClient.ts +42 -207
  309. package/src/neighbourhood/NeighbourhoodProxy.test.ts +34 -36
  310. package/src/perspectives/LinkQuery.ts +0 -15
  311. package/src/perspectives/Perspective.ts +1 -12
  312. package/src/perspectives/PerspectiveClient.test.ts +262 -0
  313. package/src/perspectives/PerspectiveClient.ts +227 -412
  314. package/src/perspectives/PerspectiveDiff.ts +0 -8
  315. package/src/perspectives/PerspectiveHandle.ts +1 -12
  316. package/src/perspectives/PerspectiveProxy.test.ts +41 -0
  317. package/src/perspectives/PerspectiveProxy.ts +325 -348
  318. package/src/runtime/RuntimeClient.ts +112 -474
  319. package/src/runtime/RuntimeTypes.ts +144 -0
  320. package/src/shacl/SHACLShape.test.ts +94 -0
  321. package/src/shacl/SHACLShape.ts +27 -0
  322. package/src/typeDefs.ts +3 -5
  323. package/tsconfig.json +3 -7
  324. package/lib/src/model/query-surreal.d.ts +0 -44
  325. package/lib/src/model/query-surreal.js +0 -249
  326. package/lib/src/model/surreal-utils.d.ts +0 -42
  327. package/lib/src/model/surreal-utils.js +0 -128
  328. package/shims/reflect-metadata.ts +0 -0
  329. package/shims/type-graphql.ts +0 -75
  330. package/src/PubSub.ts +0 -17
  331. package/src/agent/AgentResolver.ts +0 -263
  332. package/src/ai/AIResolver.ts +0 -372
  333. package/src/buildSchema.ts +0 -43
  334. package/src/expression/ExpressionResolver.ts +0 -64
  335. package/src/language/LanguageContext.ts +0 -37
  336. package/src/language/LanguageResolver.ts +0 -98
  337. package/src/model/Subject.ts +0 -159
  338. package/src/model/hydration-batch.ts +0 -205
  339. package/src/model/prolog-facts.ts +0 -145
  340. package/src/model/query-prolog.ts +0 -148
  341. package/src/model/query-sparql-batch.ts +0 -301
  342. package/src/model/subscription-pool.ts +0 -163
  343. package/src/neighbourhood/NeighbourhoodResolver.ts +0 -100
  344. package/src/perspectives/PerspectiveResolver.ts +0 -364
  345. package/src/runtime/RuntimeResolver.ts +0 -749
  346. package/src/unwrapApolloResult.ts +0 -16
  347. package/tsconfig-browser.json +0 -82
@@ -1,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
  *
@@ -14,6 +16,60 @@ import { resolveParentPredicate } from "./query-common";
14
16
  import type { RelationMetadataEntry } from "./decorators";
15
17
  import type { Where, Query, ModelMetadata, PropertyMetadata } from "./types";
16
18
 
19
+ /**
20
+ * Check whether a `where` clause contains filters that cannot be pushed down
21
+ * to SPARQL and must be evaluated in JS after hydration.
22
+ *
23
+ * JS-only filters include:
24
+ * - Literal-stored properties (equality, comparison, contains, etc.)
25
+ * - Reverse relations (belongsToOne / belongsToMany)
26
+ * - author / timestamp filters (skipped by buildSPARQLWhereFilters)
27
+ *
28
+ * When JS-only filters exist, SPARQL-level LIMIT/OFFSET must NOT be applied
29
+ * because the database would cap the candidate set before JS filters run,
30
+ * potentially discarding matches beyond the LIMIT.
31
+ */
32
+ export function hasJsOnlyWhereFilters(
33
+ metadata: ModelMetadata,
34
+ allRelationsMetadata: Record<string, RelationMetadataEntry>,
35
+ where?: Where,
36
+ ): boolean {
37
+ if (!where) return false;
38
+
39
+ for (const [propertyName, condition] of Object.entries(where)) {
40
+ if (propertyName === "base" || propertyName === "id") continue;
41
+
42
+ // author/timestamp filters are handled in JS
43
+ if (propertyName === "author" || propertyName === "timestamp") return true;
44
+
45
+ const propMeta = metadata.properties[propertyName];
46
+ if (!propMeta) continue;
47
+
48
+ // Reverse relations are JS-only
49
+ const relMeta = allRelationsMetadata[propertyName];
50
+ if (relMeta && (relMeta.kind === 'belongsToOne' || relMeta.kind === 'belongsToMany')) {
51
+ return true;
52
+ }
53
+
54
+ // Literal-stored properties: equality/IN/NOT can be pushed to SPARQL via
55
+ // <ad4m://fn/parse_literal>(), but comparison operators (gt/lt/gte/lte/between/contains)
56
+ // must remain JS-only because parse_literal returns strings.
57
+ if (isLiteralStoredProperty(propMeta)) {
58
+ if (typeof condition === 'object' && condition !== null && !Array.isArray(condition)) {
59
+ const ops = condition as any;
60
+ const hasCompOps = ops.gt !== undefined || ops.gte !== undefined ||
61
+ ops.lt !== undefined || ops.lte !== undefined ||
62
+ ops.between !== undefined || ops.contains !== undefined;
63
+ if (hasCompOps) return true;
64
+ // NOT with simple value can be pushed to SPARQL — not JS-only
65
+ }
66
+ // Simple equality and IN filters can be pushed to SPARQL — not JS-only
67
+ }
68
+ }
69
+
70
+ return false;
71
+ }
72
+
17
73
  /**
18
74
  * Check if a string value looks like a URI (has a scheme).
19
75
  */
@@ -85,6 +141,31 @@ function iri(value: string): string {
85
141
  return `<${value}>`;
86
142
  }
87
143
 
144
+ /**
145
+ * Map a user-facing property name to the SPARQL variable alias used in the query.
146
+ *
147
+ * Properties appear in the query as:
148
+ * - Required properties: `?cfTarget_${name}`
149
+ * - Where-clause joins: `?wTarget_${name}`
150
+ * - Initial-value fallback: `?cfInitTarget_${name}`
151
+ *
152
+ * For ORDER BY, we prefer the conformance variable (always present for required props),
153
+ * then the where-target variable.
154
+ */
155
+ function mapPropertyToSPARQLVar(propertyName: string, metadata: ModelMetadata): string {
156
+ const propMeta = metadata.properties[propertyName];
157
+ if (propMeta) {
158
+ if (propMeta.required && !propMeta.getter && !(propMeta.flag && propMeta.initial)) {
159
+ return `?cfTarget_${propertyName}`;
160
+ }
161
+ if (propMeta.initial && !propMeta.flag) {
162
+ return `?cfInitTarget_${propertyName}`;
163
+ }
164
+ }
165
+ // Fallback: where-clause variable or raw name
166
+ return `?wTarget_${propertyName}`;
167
+ }
168
+
88
169
  /**
89
170
  * Build a SPARQL query that returns all links belonging to instances of
90
171
  * the given model class, optionally filtered by `where` conditions.
@@ -170,19 +251,50 @@ export function buildSPARQLQuery(
170
251
  filterExpressions.push(...userFilters);
171
252
 
172
253
  // Main triple pattern — fetches all links for matched sources
173
- // The direct triple in named graph: GRAPH ?linkGraph { ?source ?predicate ?target }
254
+ // Direct triple in default graph + RDF 1.2 reifier for link metadata
174
255
  // FILTER(isIRI(?source)) excludes non-IRI subjects
175
256
  const joinClause = joinPatterns.join("\n");
176
257
  const filterClause = filterExpressions.length > 0
177
258
  ? `FILTER(\n ${filterExpressions.join(" &&\n ")}\n )`
178
259
  : "";
179
260
 
261
+ // Determine if SPARQL-level pagination is safe.
262
+ // When JS-only where filters exist, we must NOT limit at the SPARQL level
263
+ // because the database would cap candidates before JS filters run.
264
+ const canPaginateInSPARQL = !hasJsOnlyWhereFilters(metadata, allRelationsMetadata, query.where)
265
+ && (query.limit !== undefined || query.offset !== undefined);
266
+
267
+ // Build a pagination subquery that constrains ?source to only the page
268
+ // of interest. This avoids fetching all links for all matching instances.
269
+ const paginationSubquery = canPaginateInSPARQL
270
+ ? buildPaginationSubquery(joinPatterns, filterExpressions, metadata, query)
271
+ : '';
272
+
273
+ if (paginationSubquery) {
274
+ // Use the pagination subquery to constrain ?source, then fetch all links
275
+ // for those sources only.
276
+ return `
277
+
278
+ SELECT ?source ?predicate ?target ?author ?timestamp WHERE {
279
+ ${paginationSubquery}${joinClause}
280
+ ?source ?predicate ?target .
281
+ ?_reifier <http://www.w3.org/1999/02/22-rdf-syntax-ns#reifies> <<( ?source ?predicate ?target )>> .
282
+ FILTER(isIRI(?source) && isIRI(?predicate))
283
+ ?_reifier <ad4m://ontology/author> ?author .
284
+ ?_reifier <ad4m://ontology/timestamp> ?timestamp .
285
+ ${filterClause}
286
+ }
287
+ `.trim();
288
+ }
289
+
180
290
  return `
291
+
181
292
  SELECT ?source ?predicate ?target ?author ?timestamp WHERE {${joinClause}
182
- GRAPH ?linkGraph { ?source ?predicate ?target . }
293
+ ?source ?predicate ?target .
294
+ ?_reifier <http://www.w3.org/1999/02/22-rdf-syntax-ns#reifies> <<( ?source ?predicate ?target )>> .
183
295
  FILTER(isIRI(?source) && isIRI(?predicate))
184
- ?linkGraph <ad4m://ontology/author> ?author .
185
- ?linkGraph <ad4m://ontology/timestamp> ?timestamp .
296
+ ?_reifier <ad4m://ontology/author> ?author .
297
+ ?_reifier <ad4m://ontology/timestamp> ?timestamp .
186
298
  ${filterClause}
187
299
  }
188
300
  ${buildSPARQLOrderLimitOffset(metadata, query)}
@@ -191,52 +303,73 @@ export function buildSPARQLQuery(
191
303
 
192
304
  /**
193
305
  * Build ORDER BY / LIMIT / OFFSET clauses for the SPARQL query.
306
+ *
307
+ * NOTE: The outer SELECT returns multiple rows per instance (one per link),
308
+ * so LIMIT/OFFSET at the outer level would cut off links mid-instance.
309
+ * This function is kept for backward compatibility and always returns "".
310
+ * SPARQL-level pagination is handled via a subquery in buildSPARQLQuery
311
+ * using buildPaginationSubquery().
194
312
  */
195
- function buildSPARQLOrderLimitOffset(_metadata: ModelMetadata, _query: Query): string {
313
+ export function buildSPARQLOrderLimitOffset(_metadata: ModelMetadata, query: Query): string {
196
314
  return "";
197
315
  }
198
316
 
199
317
  /**
200
- * Build a SPARQL query to fetch all links for a single instance.
318
+ * Build an inner subquery that selects DISTINCT ?source URIs with
319
+ * ORDER BY, LIMIT, and OFFSET applied at the instance level.
320
+ *
321
+ * Because the outer SELECT returns multiple rows per instance (one per link),
322
+ * we cannot apply LIMIT/OFFSET there. Instead this subquery constrains
323
+ * ?source to only the instances on the requested page.
324
+ *
325
+ * @internal — used by buildSPARQLQuery when SPARQL-level pagination is safe.
201
326
  */
202
- export function buildSPARQLGetDataQuery(baseExpression: string): string {
203
- return `
204
- SELECT ?source ?predicate ?target ?author ?timestamp WHERE {
205
- GRAPH ?linkGraph { ${iri(baseExpression)} ?predicate ?target . }
206
- FILTER(isIRI(?predicate))
207
- BIND(${iri(baseExpression)} AS ?source)
208
- ?linkGraph <ad4m://ontology/author> ?author .
209
- ?linkGraph <ad4m://ontology/timestamp> ?timestamp .
210
- }
211
- `.trim();
212
- }
327
+ export function buildPaginationSubquery(
328
+ joinPatterns: string[],
329
+ filterExpressions: string[],
330
+ metadata: ModelMetadata,
331
+ query: Query,
332
+ ): string {
333
+ const innerJoin = joinPatterns.join('\n');
334
+ const innerFilter = filterExpressions.length > 0
335
+ ? `FILTER(\n ${filterExpressions.join(' &&\n ')}\n )`
336
+ : '';
213
337
 
214
- /**
215
- * Group flat SPARQL link rows into the same shape that SPARQL returned:
216
- * `{ source_uri: string, links: Array<{predicate, target, author, timestamp}> }`
217
- */
218
- export function groupSPARQLResults(
219
- rows: Array<{ source: string; predicate: string; target: string; author: string; timestamp: string }>
220
- ): Array<{ source_uri: string; links: Array<{ predicate: string; target: string; author: string; timestamp: string }> }> {
221
- const grouped = new Map<string, { predicate: string; target: string; author: string; timestamp: string }[]>();
222
-
223
- for (const row of rows) {
224
- const key = row.source;
225
- if (!grouped.has(key)) {
226
- grouped.set(key, []);
227
- }
228
- grouped.get(key)!.push({
229
- predicate: row.predicate,
230
- target: row.target,
231
- author: row.author,
232
- timestamp: row.timestamp,
338
+ // Build ORDER BY clause from query.order
339
+ let orderByClause = '';
340
+ const orderJoinPatterns: string[] = [];
341
+ if (query.order) {
342
+ const orderTerms = Object.entries(query.order).map(([prop, dir]) => {
343
+ const sparqlVar = mapPropertyToSPARQLVar(prop, metadata);
344
+ // Check if this order property's variable is already bound by existing
345
+ // join patterns. If not, add an OPTIONAL join so ORDER BY is deterministic.
346
+ const varAlreadyBound = innerJoin.includes(sparqlVar);
347
+ if (!varAlreadyBound) {
348
+ const propMeta = metadata.properties[prop];
349
+ if (propMeta && propMeta.predicate && !propMeta.getter) {
350
+ orderJoinPatterns.push(`\n OPTIONAL { ?source <${propMeta.predicate}> ${sparqlVar} . }`);
351
+ }
352
+ }
353
+ return dir === 'DESC' ? `DESC(${sparqlVar})` : `ASC(${sparqlVar})`;
233
354
  });
355
+ if (orderTerms.length > 0) {
356
+ orderByClause = `ORDER BY ${orderTerms.join(' ')}`;
357
+ }
234
358
  }
235
359
 
236
- return Array.from(grouped.entries()).map(([source_uri, links]) => ({
237
- source_uri,
238
- links,
239
- }));
360
+ // No default ordering — when no explicit order is specified, results come in
361
+ // natural (insertion) order.
362
+ const tsSelect = '';
363
+ const tsPattern = '';
364
+
365
+ const limitClause = query.limit !== undefined ? `LIMIT ${query.limit}` : '';
366
+ const offsetClause = query.offset !== undefined && query.offset > 0 ? `OFFSET ${query.offset}` : '';
367
+
368
+ return `
369
+ { SELECT DISTINCT ?source${tsSelect} WHERE {${innerJoin}${orderJoinPatterns.join('')}${tsPattern}
370
+ FILTER(isIRI(?source))
371
+ ${innerFilter}
372
+ } GROUP BY ?source ${orderByClause} ${limitClause} ${offsetClause} }\n`;
240
373
  }
241
374
 
242
375
  /**
@@ -293,32 +426,46 @@ function buildSPARQLWhereFilters(
293
426
  // Determine if this property stores values as literal: IRIs
294
427
  const useParseLiteral = isLiteralStoredProperty(propMeta);
295
428
 
296
- // For literal-stored properties, skip SPARQL-level FILTER expressions entirely.
297
- // The parse_literal custom function is unreliable across oxigraph versions and
298
- // environments. All property-level where filtering is done in JS post-filter
299
- // (instancesFromQueryResult) after hydration resolves values to JS primitives.
300
- // We only add a JOIN pattern to ensure the property exists (conformance check).
429
+ // For literal-stored properties, push equality/IN/NOT filters to SPARQL using
430
+ // <ad4m://fn/parse_literal>() which extracts the raw value from literal: IRIs.
431
+ // The correct SPARQL syntax is <ad4m://fn/parse_literal>(?var) — NOT fn::parse_literal
432
+ // (which was SurrealDB syntax that Oxigraph rejects at parse time).
433
+ // Comparison operators (gt/lt/gte/lte/between/contains) remain JS-only because
434
+ // parse_literal returns strings and numeric/date comparisons would be unreliable.
435
+ // JS post-filter in instancesFromQueryResult remains as a safety net for all cases.
301
436
  if (useParseLiteral) {
302
- // Just ensure the property exists — no value filtering in SPARQL
303
437
  if (typeof condition === "object" && condition !== null && !Array.isArray(condition)) {
304
438
  const ops = condition as any;
305
439
  const hasCompOps = ops.gt !== undefined || ops.gte !== undefined ||
306
440
  ops.lt !== undefined || ops.lte !== undefined ||
307
- ops.between !== undefined || ops.contains !== undefined ||
308
- ops.not !== undefined;
441
+ ops.between !== undefined || ops.contains !== undefined;
309
442
  if (hasCompOps) {
443
+ // Comparison operators: join only, filter in JS
310
444
  joins.push(`
311
445
  ?source ${iri(propMeta.predicate)} ?wTarget_cmp_${propertyName} .`);
312
446
  }
313
- // NOT filters: no SPARQL-level filtering — handled in JS
447
+ if (ops.not !== undefined) {
448
+ // NOT filter: push down to SPARQL
449
+ joins.push(`
450
+ ?source ${iri(propMeta.predicate)} ?wTarget_${propertyName} .`);
451
+ if (Array.isArray(ops.not)) {
452
+ const formatted = (ops.not as any[]).map((v: any) => formatSPARQLValue(v)).join(", ");
453
+ filters.push(`STR(<ad4m://fn/parse_literal>(?wTarget_${propertyName})) NOT IN (${formatted})`);
454
+ } else {
455
+ filters.push(`STR(<ad4m://fn/parse_literal>(?wTarget_${propertyName})) != ${formatSPARQLValue(ops.not)}`);
456
+ }
457
+ }
458
+ } else if (Array.isArray(condition)) {
459
+ // IN filter: push down to SPARQL
460
+ joins.push(`
461
+ ?source ${iri(propMeta.predicate)} ?wTarget_${propertyName} .`);
462
+ const formatted = (condition as any[]).map((v: any) => formatSPARQLValue(v)).join(", ");
463
+ filters.push(`STR(<ad4m://fn/parse_literal>(?wTarget_${propertyName})) IN (${formatted})`);
314
464
  } else {
315
- // Simple equality or IN — add join for conformance.
316
- // NOTE: push-down FILTER with fn::parse_literal was attempted but removed because
317
- // Oxigraph's query parser rejects the fn:: custom function syntax at parse time
318
- // (custom functions are only available at execution time). All literal property
319
- // filtering is done in JS post-filter after hydration resolves values.
465
+ // Simple equality: push down to SPARQL
320
466
  joins.push(`
321
467
  ?source ${iri(propMeta.predicate)} ?wTarget_${propertyName} .`);
468
+ filters.push(`STR(<ad4m://fn/parse_literal>(?wTarget_${propertyName})) = ${formatSPARQLValue(condition)}`);
322
469
  }
323
470
  } else if (Array.isArray(condition)) {
324
471
  const formatted = (condition as any[]).map(v => iri(v)).join(", ");
@@ -84,10 +84,14 @@ export function buildWhereCondition(
84
84
  if (ops.not !== undefined) {
85
85
  if (Array.isArray(ops.not)) {
86
86
  const formattedValues = ops.not.map((v: any) => formatValue(v)).join(', ');
87
+ // FILTER NOT EXISTS here is scoped to a specific predicate, not a global scan,
88
+ // so O(N²) behavior is bounded by the number of values for this property.
87
89
  parts.push(
88
90
  `FILTER NOT EXISTS { ?target <${escapedPredicate}> ?_nval . FILTER(?_nval IN (${formattedValues})) }`,
89
91
  );
90
92
  } else {
93
+ // FILTER NOT EXISTS here is scoped to a specific predicate, not a global scan,
94
+ // so O(N²) behavior is bounded by the number of values for this property.
91
95
  parts.push(
92
96
  `FILTER NOT EXISTS { ?target <${escapedPredicate}> ${formatValue(ops.not)} }`,
93
97
  );
@@ -128,6 +128,11 @@ export function buildSHACL(
128
128
  propShape.hasValue = propMeta.initial;
129
129
  }
130
130
 
131
+ // sh:in — allowed values (enum constraint)
132
+ if (propMeta.options && propMeta.options.length > 0) {
133
+ propShape.in = propMeta.options;
134
+ }
135
+
131
136
  // AD4M-specific metadata
132
137
  if (propMeta.local !== undefined) {
133
138
  propShape.local = propMeta.local;
@@ -61,7 +61,51 @@ export type ParentScope =
61
61
  * ```
62
62
  */
63
63
  export interface IncludeMap {
64
- [relation: string]: boolean | RelationSubQuery;
64
+ [relation: string]: boolean | RelationSubQuery | IncludeProjection;
65
+ }
66
+
67
+ /**
68
+ * A lightweight projection that computes a scalar or list value from a relation
69
+ * without fully hydrating the linked instances.
70
+ *
71
+ * Keys in `IncludeMap` that begin with `$` are treated as projections.
72
+ * Results are attached directly to each queried instance under the same key.
73
+ *
74
+ * @example
75
+ * ```typescript
76
+ * // Attach a like-count to each post
77
+ * const posts = await Post.findAll(perspective, {
78
+ * include: {
79
+ * $likeCount: { from: 'likes', count: true },
80
+ * $myLike: { from: 'likes', limit: 1 },
81
+ * }
82
+ * });
83
+ * posts[0].$likeCount // number
84
+ * posts[0].$myLike // string ID or null
85
+ * ```
86
+ */
87
+ export interface IncludeProjection {
88
+ /** The relation name on the parent model to project over. */
89
+ from: string;
90
+ /** When true, attaches an integer count instead of a list. */
91
+ count?: true;
92
+ /**
93
+ * Serialised target class shape. Set automatically by `executeModelQuery`
94
+ * when a `where` clause is present and the target class is resolvable.
95
+ * @internal
96
+ */
97
+ targetShape?: ModelMetadata;
98
+ /** Post-hydration where clause applied to the target instances. */
99
+ where?: Where;
100
+ /** Limit results (when 1, the attached value is unwrapped to a scalar). */
101
+ limit?: number;
102
+ /** Order results before applying limit. */
103
+ order?: Order;
104
+ }
105
+
106
+ /** Type guard for IncludeProjection objects. */
107
+ export function isIncludeProjection(val: unknown): val is IncludeProjection {
108
+ return typeof val === 'object' && val !== null && 'from' in val;
65
109
  }
66
110
 
67
111
  export type Query = {
@@ -69,11 +113,28 @@ export type Query = {
69
113
  parent?: ParentScope;
70
114
  properties?: string[];
71
115
  include?: IncludeMap;
116
+ /**
117
+ * When true, eager-loads every declared forward relation on the model.
118
+ * Equivalent to listing all relation field names in `include: {}` explicitly.
119
+ * Useful for tree-walking and manifest-style inspections.
120
+ * Individual relations can still be overridden via `include` (explicit entries take precedence).
121
+ */
122
+ includeAll?: boolean;
72
123
  where?: Where;
73
124
  order?: Order;
74
125
  offset?: number;
75
126
  limit?: number;
76
127
  count?: boolean;
128
+ /**
129
+ * When true, SPARQL property getters (@Property with `getter`) ARE evaluated
130
+ * during collection hydration. By default, collection queries skip getter
131
+ * evaluation for performance — getters run only on single-instance get().
132
+ *
133
+ * Use this when you need getter-backed properties (e.g. `replyingTo`,
134
+ * `isPopular`) in a list query. For most list/feed UIs, leave this off
135
+ * and use `Ad4mModel.evaluateGetters()` on visible items only.
136
+ */
137
+ deepQuery?: boolean;
77
138
  };
78
139
 
79
140
  /**
@@ -1,15 +1,8 @@
1
- import { Field, ObjectType } from "type-graphql";
2
1
  import { ExpressionGeneric } from "../expression/Expression";
3
2
  import { LanguageRef } from "../language/LanguageRef";
4
3
  import { Perspective } from "../perspectives/Perspective";
5
-
6
-
7
- @ObjectType()
8
4
  export class Neighbourhood {
9
- @Field()
10
5
  linkLanguage: string
11
-
12
- @Field()
13
6
  meta: Perspective
14
7
 
15
8
  constructor(linkLanguage: string, meta: Perspective) {
@@ -17,6 +10,4 @@ export class Neighbourhood {
17
10
  this.meta = meta;
18
11
  }
19
12
  }
20
-
21
- @ObjectType()
22
13
  export class NeighbourhoodExpression extends ExpressionGeneric(Neighbourhood) {};