@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
@@ -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,15 +1,31 @@
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
  *
9
11
  * @module
10
12
  */
11
13
  import type { RelationMetadataEntry } from "./decorators";
12
- import type { Query, ModelMetadata } from "./types";
14
+ import type { Where, Query, ModelMetadata } from "./types";
15
+ /**
16
+ * Check whether a `where` clause contains filters that cannot be pushed down
17
+ * to SPARQL and must be evaluated in JS after hydration.
18
+ *
19
+ * JS-only filters include:
20
+ * - Literal-stored properties (equality, comparison, contains, etc.)
21
+ * - Reverse relations (belongsToOne / belongsToMany)
22
+ * - author / timestamp filters (skipped by buildSPARQLWhereFilters)
23
+ *
24
+ * When JS-only filters exist, SPARQL-level LIMIT/OFFSET must NOT be applied
25
+ * because the database would cap the candidate set before JS filters run,
26
+ * potentially discarding matches beyond the LIMIT.
27
+ */
28
+ export declare function hasJsOnlyWhereFilters(metadata: ModelMetadata, allRelationsMetadata: Record<string, RelationMetadataEntry>, where?: Where): boolean;
13
29
  /**
14
30
  * Format a value as a SPARQL string literal (double-quoted).
15
31
  */
@@ -23,25 +39,23 @@ export declare function formatSPARQLValue(value: any): string;
23
39
  */
24
40
  export declare function buildSPARQLQuery(metadata: ModelMetadata, allRelationsMetadata: Record<string, RelationMetadataEntry>, query: Query, modelClass: any): string;
25
41
  /**
26
- * Build a SPARQL query to fetch all links for a single instance.
42
+ * Build ORDER BY / LIMIT / OFFSET clauses for the SPARQL query.
43
+ *
44
+ * NOTE: The outer SELECT returns multiple rows per instance (one per link),
45
+ * so LIMIT/OFFSET at the outer level would cut off links mid-instance.
46
+ * This function is kept for backward compatibility and always returns "".
47
+ * SPARQL-level pagination is handled via a subquery in buildSPARQLQuery
48
+ * using buildPaginationSubquery().
27
49
  */
28
- export declare function buildSPARQLGetDataQuery(baseExpression: string): string;
50
+ export declare function buildSPARQLOrderLimitOffset(_metadata: ModelMetadata, query: Query): string;
29
51
  /**
30
- * Group flat SPARQL link rows into the same shape that SPARQL returned:
31
- * `{ source_uri: string, links: Array<{predicate, target, author, timestamp}> }`
52
+ * Build an inner subquery that selects DISTINCT ?source URIs with
53
+ * ORDER BY, LIMIT, and OFFSET applied at the instance level.
54
+ *
55
+ * Because the outer SELECT returns multiple rows per instance (one per link),
56
+ * we cannot apply LIMIT/OFFSET there. Instead this subquery constrains
57
+ * ?source to only the instances on the requested page.
58
+ *
59
+ * @internal — used by buildSPARQLQuery when SPARQL-level pagination is safe.
32
60
  */
33
- export declare function groupSPARQLResults(rows: Array<{
34
- source: string;
35
- predicate: string;
36
- target: string;
37
- author: string;
38
- timestamp: string;
39
- }>): Array<{
40
- source_uri: string;
41
- links: Array<{
42
- predicate: string;
43
- target: string;
44
- author: string;
45
- timestamp: string;
46
- }>;
47
- }>;
61
+ export declare function buildPaginationSubquery(joinPatterns: string[], filterExpressions: string[], metadata: ModelMetadata, query: Query): string;
@@ -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
  *
@@ -10,6 +12,54 @@
10
12
  */
11
13
  import { Literal } from "../Literal";
12
14
  import { resolveParentPredicate } from "./query-common";
15
+ /**
16
+ * Check whether a `where` clause contains filters that cannot be pushed down
17
+ * to SPARQL and must be evaluated in JS after hydration.
18
+ *
19
+ * JS-only filters include:
20
+ * - Literal-stored properties (equality, comparison, contains, etc.)
21
+ * - Reverse relations (belongsToOne / belongsToMany)
22
+ * - author / timestamp filters (skipped by buildSPARQLWhereFilters)
23
+ *
24
+ * When JS-only filters exist, SPARQL-level LIMIT/OFFSET must NOT be applied
25
+ * because the database would cap the candidate set before JS filters run,
26
+ * potentially discarding matches beyond the LIMIT.
27
+ */
28
+ export function hasJsOnlyWhereFilters(metadata, allRelationsMetadata, where) {
29
+ if (!where)
30
+ return false;
31
+ for (const [propertyName, condition] of Object.entries(where)) {
32
+ if (propertyName === "base" || propertyName === "id")
33
+ continue;
34
+ // author/timestamp filters are handled in JS
35
+ if (propertyName === "author" || propertyName === "timestamp")
36
+ return true;
37
+ const propMeta = metadata.properties[propertyName];
38
+ if (!propMeta)
39
+ continue;
40
+ // Reverse relations are JS-only
41
+ const relMeta = allRelationsMetadata[propertyName];
42
+ if (relMeta && (relMeta.kind === 'belongsToOne' || relMeta.kind === 'belongsToMany')) {
43
+ return true;
44
+ }
45
+ // Literal-stored properties: equality/IN/NOT can be pushed to SPARQL via
46
+ // <ad4m://fn/parse_literal>(), but comparison operators (gt/lt/gte/lte/between/contains)
47
+ // must remain JS-only because parse_literal returns strings.
48
+ if (isLiteralStoredProperty(propMeta)) {
49
+ if (typeof condition === 'object' && condition !== null && !Array.isArray(condition)) {
50
+ const ops = condition;
51
+ const hasCompOps = ops.gt !== undefined || ops.gte !== undefined ||
52
+ ops.lt !== undefined || ops.lte !== undefined ||
53
+ ops.between !== undefined || ops.contains !== undefined;
54
+ if (hasCompOps)
55
+ return true;
56
+ // NOT with simple value can be pushed to SPARQL — not JS-only
57
+ }
58
+ // Simple equality and IN filters can be pushed to SPARQL — not JS-only
59
+ }
60
+ }
61
+ return false;
62
+ }
13
63
  /**
14
64
  * Check if a string value looks like a URI (has a scheme).
15
65
  */
@@ -78,6 +128,30 @@ export function formatSPARQLValue(value) {
78
128
  function iri(value) {
79
129
  return `<${value}>`;
80
130
  }
131
+ /**
132
+ * Map a user-facing property name to the SPARQL variable alias used in the query.
133
+ *
134
+ * Properties appear in the query as:
135
+ * - Required properties: `?cfTarget_${name}`
136
+ * - Where-clause joins: `?wTarget_${name}`
137
+ * - Initial-value fallback: `?cfInitTarget_${name}`
138
+ *
139
+ * For ORDER BY, we prefer the conformance variable (always present for required props),
140
+ * then the where-target variable.
141
+ */
142
+ function mapPropertyToSPARQLVar(propertyName, metadata) {
143
+ const propMeta = metadata.properties[propertyName];
144
+ if (propMeta) {
145
+ if (propMeta.required && !propMeta.getter && !(propMeta.flag && propMeta.initial)) {
146
+ return `?cfTarget_${propertyName}`;
147
+ }
148
+ if (propMeta.initial && !propMeta.flag) {
149
+ return `?cfInitTarget_${propertyName}`;
150
+ }
151
+ }
152
+ // Fallback: where-clause variable or raw name
153
+ return `?wTarget_${propertyName}`;
154
+ }
81
155
  /**
82
156
  * Build a SPARQL query that returns all links belonging to instances of
83
157
  * the given model class, optionally filtered by `where` conditions.
@@ -155,18 +229,46 @@ export function buildSPARQLQuery(metadata, allRelationsMetadata, query, modelCla
155
229
  joinPatterns.push(...userJoins);
156
230
  filterExpressions.push(...userFilters);
157
231
  // Main triple pattern — fetches all links for matched sources
158
- // The direct triple in named graph: GRAPH ?linkGraph { ?source ?predicate ?target }
232
+ // Direct triple in default graph + RDF 1.2 reifier for link metadata
159
233
  // FILTER(isIRI(?source)) excludes non-IRI subjects
160
234
  const joinClause = joinPatterns.join("\n");
161
235
  const filterClause = filterExpressions.length > 0
162
236
  ? `FILTER(\n ${filterExpressions.join(" &&\n ")}\n )`
163
237
  : "";
238
+ // Determine if SPARQL-level pagination is safe.
239
+ // When JS-only where filters exist, we must NOT limit at the SPARQL level
240
+ // because the database would cap candidates before JS filters run.
241
+ const canPaginateInSPARQL = !hasJsOnlyWhereFilters(metadata, allRelationsMetadata, query.where)
242
+ && (query.limit !== undefined || query.offset !== undefined);
243
+ // Build a pagination subquery that constrains ?source to only the page
244
+ // of interest. This avoids fetching all links for all matching instances.
245
+ const paginationSubquery = canPaginateInSPARQL
246
+ ? buildPaginationSubquery(joinPatterns, filterExpressions, metadata, query)
247
+ : '';
248
+ if (paginationSubquery) {
249
+ // Use the pagination subquery to constrain ?source, then fetch all links
250
+ // for those sources only.
251
+ return `
252
+
253
+ SELECT ?source ?predicate ?target ?author ?timestamp WHERE {
254
+ ${paginationSubquery}${joinClause}
255
+ ?source ?predicate ?target .
256
+ ?_reifier <http://www.w3.org/1999/02/22-rdf-syntax-ns#reifies> <<( ?source ?predicate ?target )>> .
257
+ FILTER(isIRI(?source) && isIRI(?predicate))
258
+ ?_reifier <ad4m://ontology/author> ?author .
259
+ ?_reifier <ad4m://ontology/timestamp> ?timestamp .
260
+ ${filterClause}
261
+ }
262
+ `.trim();
263
+ }
164
264
  return `
265
+
165
266
  SELECT ?source ?predicate ?target ?author ?timestamp WHERE {${joinClause}
166
- 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 )>> .
167
269
  FILTER(isIRI(?source) && isIRI(?predicate))
168
- ?linkGraph <ad4m://ontology/author> ?author .
169
- ?linkGraph <ad4m://ontology/timestamp> ?timestamp .
270
+ ?_reifier <ad4m://ontology/author> ?author .
271
+ ?_reifier <ad4m://ontology/timestamp> ?timestamp .
170
272
  ${filterClause}
171
273
  }
172
274
  ${buildSPARQLOrderLimitOffset(metadata, query)}
@@ -174,46 +276,63 @@ export function buildSPARQLQuery(metadata, allRelationsMetadata, query, modelCla
174
276
  }
175
277
  /**
176
278
  * Build ORDER BY / LIMIT / OFFSET clauses for the SPARQL query.
279
+ *
280
+ * NOTE: The outer SELECT returns multiple rows per instance (one per link),
281
+ * so LIMIT/OFFSET at the outer level would cut off links mid-instance.
282
+ * This function is kept for backward compatibility and always returns "".
283
+ * SPARQL-level pagination is handled via a subquery in buildSPARQLQuery
284
+ * using buildPaginationSubquery().
177
285
  */
178
- function buildSPARQLOrderLimitOffset(_metadata, _query) {
286
+ export function buildSPARQLOrderLimitOffset(_metadata, query) {
179
287
  return "";
180
288
  }
181
289
  /**
182
- * Build a SPARQL query to fetch all links for a single instance.
183
- */
184
- export function buildSPARQLGetDataQuery(baseExpression) {
185
- return `
186
- SELECT ?source ?predicate ?target ?author ?timestamp WHERE {
187
- GRAPH ?linkGraph { ${iri(baseExpression)} ?predicate ?target . }
188
- FILTER(isIRI(?predicate))
189
- BIND(${iri(baseExpression)} AS ?source)
190
- ?linkGraph <ad4m://ontology/author> ?author .
191
- ?linkGraph <ad4m://ontology/timestamp> ?timestamp .
192
- }
193
- `.trim();
194
- }
195
- /**
196
- * Group flat SPARQL link rows into the same shape that SPARQL returned:
197
- * `{ source_uri: string, links: Array<{predicate, target, author, timestamp}> }`
290
+ * Build an inner subquery that selects DISTINCT ?source URIs with
291
+ * ORDER BY, LIMIT, and OFFSET applied at the instance level.
292
+ *
293
+ * Because the outer SELECT returns multiple rows per instance (one per link),
294
+ * we cannot apply LIMIT/OFFSET there. Instead this subquery constrains
295
+ * ?source to only the instances on the requested page.
296
+ *
297
+ * @internal — used by buildSPARQLQuery when SPARQL-level pagination is safe.
198
298
  */
199
- export function groupSPARQLResults(rows) {
200
- const grouped = new Map();
201
- for (const row of rows) {
202
- const key = row.source;
203
- if (!grouped.has(key)) {
204
- grouped.set(key, []);
205
- }
206
- grouped.get(key).push({
207
- predicate: row.predicate,
208
- target: row.target,
209
- author: row.author,
210
- timestamp: row.timestamp,
299
+ export function buildPaginationSubquery(joinPatterns, filterExpressions, metadata, query) {
300
+ const innerJoin = joinPatterns.join('\n');
301
+ const innerFilter = filterExpressions.length > 0
302
+ ? `FILTER(\n ${filterExpressions.join(' &&\n ')}\n )`
303
+ : '';
304
+ // Build ORDER BY clause from query.order
305
+ let orderByClause = '';
306
+ const orderJoinPatterns = [];
307
+ if (query.order) {
308
+ const orderTerms = Object.entries(query.order).map(([prop, dir]) => {
309
+ const sparqlVar = mapPropertyToSPARQLVar(prop, metadata);
310
+ // Check if this order property's variable is already bound by existing
311
+ // join patterns. If not, add an OPTIONAL join so ORDER BY is deterministic.
312
+ const varAlreadyBound = innerJoin.includes(sparqlVar);
313
+ if (!varAlreadyBound) {
314
+ const propMeta = metadata.properties[prop];
315
+ if (propMeta && propMeta.predicate && !propMeta.getter) {
316
+ orderJoinPatterns.push(`\n OPTIONAL { ?source <${propMeta.predicate}> ${sparqlVar} . }`);
317
+ }
318
+ }
319
+ return dir === 'DESC' ? `DESC(${sparqlVar})` : `ASC(${sparqlVar})`;
211
320
  });
321
+ if (orderTerms.length > 0) {
322
+ orderByClause = `ORDER BY ${orderTerms.join(' ')}`;
323
+ }
212
324
  }
213
- return Array.from(grouped.entries()).map(([source_uri, links]) => ({
214
- source_uri,
215
- links,
216
- }));
325
+ // No default ordering — when no explicit order is specified, results come in
326
+ // natural (insertion) order.
327
+ const tsSelect = '';
328
+ const tsPattern = '';
329
+ const limitClause = query.limit !== undefined ? `LIMIT ${query.limit}` : '';
330
+ const offsetClause = query.offset !== undefined && query.offset > 0 ? `OFFSET ${query.offset}` : '';
331
+ return `
332
+ { SELECT DISTINCT ?source${tsSelect} WHERE {${innerJoin}${orderJoinPatterns.join('')}${tsPattern}
333
+ FILTER(isIRI(?source))
334
+ ${innerFilter}
335
+ } GROUP BY ?source ${orderByClause} ${limitClause} ${offsetClause} }\n`;
217
336
  }
218
337
  /**
219
338
  * Build SPARQL FILTER expressions from user `where` conditions.
@@ -263,33 +382,49 @@ function buildSPARQLWhereFilters(metadata, _allRelationsMetadata, where) {
263
382
  }
264
383
  // Determine if this property stores values as literal: IRIs
265
384
  const useParseLiteral = isLiteralStoredProperty(propMeta);
266
- // For literal-stored properties, skip SPARQL-level FILTER expressions entirely.
267
- // The parse_literal custom function is unreliable across oxigraph versions and
268
- // environments. All property-level where filtering is done in JS post-filter
269
- // (instancesFromQueryResult) after hydration resolves values to JS primitives.
270
- // We only add a JOIN pattern to ensure the property exists (conformance check).
385
+ // For literal-stored properties, push equality/IN/NOT filters to SPARQL using
386
+ // <ad4m://fn/parse_literal>() which extracts the raw value from literal: IRIs.
387
+ // The correct SPARQL syntax is <ad4m://fn/parse_literal>(?var) — NOT fn::parse_literal
388
+ // (which was SurrealDB syntax that Oxigraph rejects at parse time).
389
+ // Comparison operators (gt/lt/gte/lte/between/contains) remain JS-only because
390
+ // parse_literal returns strings and numeric/date comparisons would be unreliable.
391
+ // JS post-filter in instancesFromQueryResult remains as a safety net for all cases.
271
392
  if (useParseLiteral) {
272
- // Just ensure the property exists — no value filtering in SPARQL
273
393
  if (typeof condition === "object" && condition !== null && !Array.isArray(condition)) {
274
394
  const ops = condition;
275
395
  const hasCompOps = ops.gt !== undefined || ops.gte !== undefined ||
276
396
  ops.lt !== undefined || ops.lte !== undefined ||
277
- ops.between !== undefined || ops.contains !== undefined ||
278
- ops.not !== undefined;
397
+ ops.between !== undefined || ops.contains !== undefined;
279
398
  if (hasCompOps) {
399
+ // Comparison operators: join only, filter in JS
280
400
  joins.push(`
281
401
  ?source ${iri(propMeta.predicate)} ?wTarget_cmp_${propertyName} .`);
282
402
  }
283
- // NOT filters: no SPARQL-level filtering — handled in JS
403
+ if (ops.not !== undefined) {
404
+ // NOT filter: push down to SPARQL
405
+ joins.push(`
406
+ ?source ${iri(propMeta.predicate)} ?wTarget_${propertyName} .`);
407
+ if (Array.isArray(ops.not)) {
408
+ const formatted = ops.not.map((v) => formatSPARQLValue(v)).join(", ");
409
+ filters.push(`STR(<ad4m://fn/parse_literal>(?wTarget_${propertyName})) NOT IN (${formatted})`);
410
+ }
411
+ else {
412
+ filters.push(`STR(<ad4m://fn/parse_literal>(?wTarget_${propertyName})) != ${formatSPARQLValue(ops.not)}`);
413
+ }
414
+ }
415
+ }
416
+ else if (Array.isArray(condition)) {
417
+ // IN filter: push down to SPARQL
418
+ joins.push(`
419
+ ?source ${iri(propMeta.predicate)} ?wTarget_${propertyName} .`);
420
+ const formatted = condition.map((v) => formatSPARQLValue(v)).join(", ");
421
+ filters.push(`STR(<ad4m://fn/parse_literal>(?wTarget_${propertyName})) IN (${formatted})`);
284
422
  }
285
423
  else {
286
- // Simple equality or IN — add join for conformance.
287
- // NOTE: push-down FILTER with fn::parse_literal was attempted but removed because
288
- // Oxigraph's query parser rejects the fn:: custom function syntax at parse time
289
- // (custom functions are only available at execution time). All literal property
290
- // filtering is done in JS post-filter after hydration resolves values.
424
+ // Simple equality: push down to SPARQL
291
425
  joins.push(`
292
426
  ?source ${iri(propMeta.predicate)} ?wTarget_${propertyName} .`);
427
+ filters.push(`STR(<ad4m://fn/parse_literal>(?wTarget_${propertyName})) = ${formatSPARQLValue(condition)}`);
293
428
  }
294
429
  }
295
430
  else if (Array.isArray(condition)) {
@@ -0,0 +1 @@
1
+ export {};