@coasys/ad4m 0.12.1-dev → 0.13.0-postmessage-ws-proxy.3

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 (393) hide show
  1. package/README.md +2 -25
  2. package/jest-setup.ts +1 -1
  3. package/lib/index.cjs +8677 -15318
  4. package/lib/index.js +14507 -21223
  5. package/lib/src/Ad4mClient.d.ts +9 -3
  6. package/lib/src/Ad4mClient.js +40 -13
  7. package/lib/src/Literal.js +6 -5
  8. package/lib/src/agent/Agent.js +26 -272
  9. package/lib/src/agent/AgentClient.d.ts +33 -21
  10. package/lib/src/agent/AgentClient.js +180 -374
  11. package/lib/src/agent/AgentStatus.js +2 -37
  12. package/lib/src/ai/AIClient.d.ts +12 -4
  13. package/lib/src/ai/AIClient.js +81 -285
  14. package/lib/src/ai/AITypes.d.ts +55 -0
  15. package/lib/src/ai/AITypes.js +18 -0
  16. package/lib/src/ai/Tasks.js +10 -133
  17. package/lib/src/apiClient.d.ts +53 -0
  18. package/lib/src/apiClient.js +234 -0
  19. package/lib/src/cache/PersistentCache.d.ts +40 -0
  20. package/lib/src/cache/PersistentCache.js +139 -0
  21. package/lib/src/expression/Expression.d.ts +1 -1
  22. package/lib/src/expression/Expression.js +13 -122
  23. package/lib/src/expression/ExpressionClient.d.ts +11 -3
  24. package/lib/src/expression/ExpressionClient.js +120 -75
  25. package/lib/src/expression/ExpressionRef.js +4 -27
  26. package/lib/src/generated/api/AIModelLoadingStatus.d.ts +7 -0
  27. package/lib/src/generated/api/AIModelLoadingStatus.js +2 -0
  28. package/lib/src/generated/api/AddLinkExpressionRequest.d.ts +6 -0
  29. package/lib/src/generated/api/AddLinkExpressionRequest.js +1 -0
  30. package/lib/src/generated/api/AddLinkRequest.d.ts +6 -0
  31. package/lib/src/generated/api/AddLinkRequest.js +1 -0
  32. package/lib/src/generated/api/AddLinksBulkRequest.d.ts +6 -0
  33. package/lib/src/generated/api/AddLinksBulkRequest.js +1 -0
  34. package/lib/src/generated/api/AddSdnaRequest.d.ts +6 -0
  35. package/lib/src/generated/api/AddSdnaRequest.js +2 -0
  36. package/lib/src/generated/api/ApplyTemplateRequest.d.ts +4 -0
  37. package/lib/src/generated/api/ApplyTemplateRequest.js +2 -0
  38. package/lib/src/generated/api/AuthInfoInput.d.ts +10 -0
  39. package/lib/src/generated/api/AuthInfoInput.js +1 -0
  40. package/lib/src/generated/api/CapabilityInput.d.ts +5 -0
  41. package/lib/src/generated/api/CapabilityInput.js +1 -0
  42. package/lib/src/generated/api/CommitBatchRequest.d.ts +3 -0
  43. package/lib/src/generated/api/CommitBatchRequest.js +2 -0
  44. package/lib/src/generated/api/ComputeLogEntry.d.ts +9 -0
  45. package/lib/src/generated/api/ComputeLogEntry.js +2 -0
  46. package/lib/src/generated/api/CreateExpressionRequest.d.ts +4 -0
  47. package/lib/src/generated/api/CreateExpressionRequest.js +2 -0
  48. package/lib/src/generated/api/CreatePerspectiveRequest.d.ts +3 -0
  49. package/lib/src/generated/api/CreatePerspectiveRequest.js +2 -0
  50. package/lib/src/generated/api/CreateSubjectRequest.d.ts +6 -0
  51. package/lib/src/generated/api/CreateSubjectRequest.js +2 -0
  52. package/lib/src/generated/api/EmbedRequest.d.ts +4 -0
  53. package/lib/src/generated/api/EmbedRequest.js +2 -0
  54. package/lib/src/generated/api/EntanglementProofInput.d.ts +6 -0
  55. package/lib/src/generated/api/EntanglementProofInput.js +2 -0
  56. package/lib/src/generated/api/ExecuteCommandsRequest.d.ts +4 -0
  57. package/lib/src/generated/api/ExecuteCommandsRequest.js +2 -0
  58. package/lib/src/generated/api/ExportRequest.d.ts +5 -0
  59. package/lib/src/generated/api/ExportRequest.js +2 -0
  60. package/lib/src/generated/api/ExpressionManyRequest.d.ts +3 -0
  61. package/lib/src/generated/api/ExpressionManyRequest.js +2 -0
  62. package/lib/src/generated/api/ExpressionProof.d.ts +4 -0
  63. package/lib/src/generated/api/ExpressionProof.js +2 -0
  64. package/lib/src/generated/api/ExpressionProofInput.d.ts +6 -0
  65. package/lib/src/generated/api/ExpressionProofInput.js +2 -0
  66. package/lib/src/generated/api/FriendSendMessageRequest.d.ts +3 -0
  67. package/lib/src/generated/api/FriendSendMessageRequest.js +2 -0
  68. package/lib/src/generated/api/FriendsListRequest.d.ts +3 -0
  69. package/lib/src/generated/api/FriendsListRequest.js +2 -0
  70. package/lib/src/generated/api/GenerateAgentRequest.d.ts +3 -0
  71. package/lib/src/generated/api/GenerateAgentRequest.js +2 -0
  72. package/lib/src/generated/api/GenerateJwtRequest.d.ts +4 -0
  73. package/lib/src/generated/api/GenerateJwtRequest.js +2 -0
  74. package/lib/src/generated/api/GetSubjectDataRequest.d.ts +4 -0
  75. package/lib/src/generated/api/GetSubjectDataRequest.js +2 -0
  76. package/lib/src/generated/api/ImportAgentRequest.d.ts +6 -0
  77. package/lib/src/generated/api/ImportAgentRequest.js +2 -0
  78. package/lib/src/generated/api/ImportRequest.d.ts +4 -0
  79. package/lib/src/generated/api/ImportRequest.js +2 -0
  80. package/lib/src/generated/api/JoinNeighbourhoodRequest.d.ts +3 -0
  81. package/lib/src/generated/api/JoinNeighbourhoodRequest.js +2 -0
  82. package/lib/src/generated/api/LanguageMetaInput.d.ts +6 -0
  83. package/lib/src/generated/api/LanguageMetaInput.js +2 -0
  84. package/lib/src/generated/api/Link.d.ts +5 -0
  85. package/lib/src/generated/api/Link.js +2 -0
  86. package/lib/src/generated/api/LinkExpression.d.ts +10 -0
  87. package/lib/src/generated/api/LinkExpression.js +1 -0
  88. package/lib/src/generated/api/LinkExpressionInput.d.ts +10 -0
  89. package/lib/src/generated/api/LinkExpressionInput.js +1 -0
  90. package/lib/src/generated/api/LinkInput.d.ts +5 -0
  91. package/lib/src/generated/api/LinkInput.js +2 -0
  92. package/lib/src/generated/api/LinkLanguageTemplatesRequest.d.ts +3 -0
  93. package/lib/src/generated/api/LinkLanguageTemplatesRequest.js +2 -0
  94. package/lib/src/generated/api/LinkMutations.d.ts +6 -0
  95. package/lib/src/generated/api/LinkMutations.js +1 -0
  96. package/lib/src/generated/api/LinkStatus.d.ts +1 -0
  97. package/lib/src/generated/api/LinkStatus.js +2 -0
  98. package/lib/src/generated/api/LockAgentRequest.d.ts +3 -0
  99. package/lib/src/generated/api/LockAgentRequest.js +2 -0
  100. package/lib/src/generated/api/ModelType.d.ts +1 -0
  101. package/lib/src/generated/api/ModelType.js +2 -0
  102. package/lib/src/generated/api/NotificationInput.d.ts +10 -0
  103. package/lib/src/generated/api/NotificationInput.js +2 -0
  104. package/lib/src/generated/api/OpenLinkRequest.d.ts +3 -0
  105. package/lib/src/generated/api/OpenLinkRequest.js +2 -0
  106. package/lib/src/generated/api/PermitCapabilityRequest.d.ts +3 -0
  107. package/lib/src/generated/api/PermitCapabilityRequest.js +2 -0
  108. package/lib/src/generated/api/PerspectiveInput.d.ts +4 -0
  109. package/lib/src/generated/api/PerspectiveInput.js +1 -0
  110. package/lib/src/generated/api/PromptRequest.d.ts +4 -0
  111. package/lib/src/generated/api/PromptRequest.js +2 -0
  112. package/lib/src/generated/api/PublishLanguageRequest.d.ts +5 -0
  113. package/lib/src/generated/api/PublishLanguageRequest.js +1 -0
  114. package/lib/src/generated/api/PublishNeighbourhoodRequest.d.ts +6 -0
  115. package/lib/src/generated/api/PublishNeighbourhoodRequest.js +1 -0
  116. package/lib/src/generated/api/QueryRequest.d.ts +7 -0
  117. package/lib/src/generated/api/QueryRequest.js +2 -0
  118. package/lib/src/generated/api/RemoveLinkRequest.d.ts +5 -0
  119. package/lib/src/generated/api/RemoveLinkRequest.js +1 -0
  120. package/lib/src/generated/api/RemoveLinksBulkRequest.d.ts +5 -0
  121. package/lib/src/generated/api/RemoveLinksBulkRequest.js +1 -0
  122. package/lib/src/generated/api/ResourceInput.d.ts +4 -0
  123. package/lib/src/generated/api/ResourceInput.js +2 -0
  124. package/lib/src/generated/api/SetDefaultModelRequest.d.ts +4 -0
  125. package/lib/src/generated/api/SetDefaultModelRequest.js +1 -0
  126. package/lib/src/generated/api/SetFreeHostingEnabledRequest.d.ts +3 -0
  127. package/lib/src/generated/api/SetFreeHostingEnabledRequest.js +2 -0
  128. package/lib/src/generated/api/SetMultiUserRequest.d.ts +3 -0
  129. package/lib/src/generated/api/SetMultiUserRequest.js +2 -0
  130. package/lib/src/generated/api/SetStatusRequest.d.ts +3 -0
  131. package/lib/src/generated/api/SetStatusRequest.js +2 -0
  132. package/lib/src/generated/api/SignMessageRequest.d.ts +3 -0
  133. package/lib/src/generated/api/SignMessageRequest.js +2 -0
  134. package/lib/src/generated/api/TrustedAgentsRequest.d.ts +3 -0
  135. package/lib/src/generated/api/TrustedAgentsRequest.js +2 -0
  136. package/lib/src/generated/api/UnlockAgentRequest.d.ts +4 -0
  137. package/lib/src/generated/api/UnlockAgentRequest.js +2 -0
  138. package/lib/src/generated/api/UpdateLinkRequest.d.ts +7 -0
  139. package/lib/src/generated/api/UpdateLinkRequest.js +1 -0
  140. package/lib/src/generated/api/UpdatePerspectiveRequest.d.ts +3 -0
  141. package/lib/src/generated/api/UpdatePerspectiveRequest.js +2 -0
  142. package/lib/src/generated/api/UserStatistics.d.ts +9 -0
  143. package/lib/src/generated/api/UserStatistics.js +2 -0
  144. package/lib/src/generated/api/VerificationRequestResult.d.ts +6 -0
  145. package/lib/src/generated/api/VerificationRequestResult.js +2 -0
  146. package/lib/src/generated/api/VerifySignatureRequest.d.ts +5 -0
  147. package/lib/src/generated/api/VerifySignatureRequest.js +2 -0
  148. package/lib/src/generated/api/WriteSettingsRequest.d.ts +3 -0
  149. package/lib/src/generated/api/WriteSettingsRequest.js +2 -0
  150. package/lib/src/generated/api/index.d.ts +42 -0
  151. package/lib/src/generated/api/index.js +7 -0
  152. package/lib/src/index.d.ts +8 -2
  153. package/lib/src/index.js +8 -2
  154. package/lib/src/jestSetup.d.ts +0 -1
  155. package/lib/src/jestSetup.js +1 -1
  156. package/lib/src/language/Icon.js +2 -21
  157. package/lib/src/language/Language.d.ts +26 -176
  158. package/lib/src/language/Language.js +32 -72
  159. package/lib/src/language/LanguageClient.d.ts +2 -2
  160. package/lib/src/language/LanguageClient.js +15 -105
  161. package/lib/src/language/LanguageHandle.js +2 -41
  162. package/lib/src/language/LanguageMeta.js +4 -75
  163. package/lib/src/language/LanguageRef.js +2 -25
  164. package/lib/src/links/Links.js +14 -111
  165. package/lib/src/model/Ad4mModel.d.ts +143 -63
  166. package/lib/src/model/Ad4mModel.js +583 -425
  167. package/lib/src/model/Ad4mModel.test.js +1434 -688
  168. package/lib/src/model/ModelQueryBuilder.d.ts +61 -45
  169. package/lib/src/model/ModelQueryBuilder.js +315 -157
  170. package/lib/src/model/Subject.js +6 -6
  171. package/lib/src/model/decorators.d.ts +36 -8
  172. package/lib/src/model/decorators.js +41 -14
  173. package/lib/src/model/hydration-batch.d.ts +34 -0
  174. package/lib/src/model/hydration-batch.js +147 -0
  175. package/lib/src/model/hydration-batching.test.d.ts +7 -0
  176. package/lib/src/model/hydration-batching.test.js +456 -0
  177. package/lib/src/model/hydration.d.ts +3 -92
  178. package/lib/src/model/hydration.js +3 -691
  179. package/lib/src/model/index.d.ts +3 -4
  180. package/lib/src/model/index.js +3 -4
  181. package/lib/src/model/json-schema.js +2 -2
  182. package/lib/src/model/model-manifest.d.ts +41 -0
  183. package/lib/src/model/model-manifest.js +11 -0
  184. package/lib/src/model/query-cache.d.ts +30 -0
  185. package/lib/src/model/query-cache.js +66 -0
  186. package/lib/src/model/query-cache.test.d.ts +1 -0
  187. package/lib/src/model/query-cache.test.js +43 -0
  188. package/lib/src/model/query-common.d.ts +1 -1
  189. package/lib/src/model/query-common.js +1 -1
  190. package/lib/src/model/query-sparql-batch.d.ts +17 -0
  191. package/lib/src/model/query-sparql-batch.js +260 -0
  192. package/lib/src/model/query-sparql.d.ts +51 -0
  193. package/lib/src/model/query-sparql.js +466 -0
  194. package/lib/src/model/query-sparql.test.d.ts +1 -0
  195. package/lib/src/model/query-sparql.test.js +312 -0
  196. package/lib/src/model/{surreal-utils.d.ts → query-utils.d.ts} +13 -9
  197. package/lib/src/model/query-utils.js +189 -0
  198. package/lib/src/model/relation-filtering.test.js +15 -15
  199. package/lib/src/model/sdna.js +1 -1
  200. package/lib/src/model/shacl-gen.js +154 -57
  201. package/lib/src/model/subscription-delta.test.d.ts +24 -0
  202. package/lib/src/model/subscription-delta.test.js +180 -0
  203. package/lib/src/model/subscription-pool.d.ts +39 -0
  204. package/lib/src/model/subscription-pool.js +165 -0
  205. package/lib/src/model/types.d.ts +195 -5
  206. package/lib/src/model/types.js +5 -2
  207. package/lib/src/neighbourhood/Neighbourhood.js +4 -32
  208. package/lib/src/neighbourhood/NeighbourhoodClient.d.ts +3 -3
  209. package/lib/src/neighbourhood/NeighbourhoodClient.js +40 -203
  210. package/lib/src/perspectives/LinkQuery.js +2 -42
  211. package/lib/src/perspectives/Perspective.d.ts +1 -1
  212. package/lib/src/perspectives/Perspective.js +10 -52
  213. package/lib/src/perspectives/PerspectiveClient.d.ts +22 -32
  214. package/lib/src/perspectives/PerspectiveClient.js +188 -454
  215. package/lib/src/perspectives/PerspectiveClient.test.d.ts +1 -0
  216. package/lib/src/perspectives/PerspectiveClient.test.js +224 -0
  217. package/lib/src/perspectives/PerspectiveDiff.js +4 -31
  218. package/lib/src/perspectives/PerspectiveHandle.js +3 -43
  219. package/lib/src/perspectives/PerspectiveProxy.d.ts +157 -78
  220. package/lib/src/perspectives/PerspectiveProxy.js +475 -389
  221. package/lib/src/perspectives/PerspectiveResolver.d.ts +0 -1
  222. package/lib/src/perspectives/PerspectiveResolver.js +0 -11
  223. package/lib/src/perspectives/SparqlBindings.d.ts +47 -0
  224. package/lib/src/perspectives/SparqlBindings.js +65 -0
  225. package/lib/src/perspectives/WakerSubscriptionManager.d.ts +3 -3
  226. package/lib/src/perspectives/WakerSubscriptionManager.js +12 -12
  227. package/lib/src/runtime/RuntimeClient.d.ts +8 -6
  228. package/lib/src/runtime/RuntimeClient.js +97 -454
  229. package/lib/src/runtime/RuntimeResolver.d.ts +14 -0
  230. package/lib/src/runtime/RuntimeResolver.js +84 -0
  231. package/lib/src/runtime/RuntimeTypes.d.ts +101 -0
  232. package/lib/src/runtime/RuntimeTypes.js +45 -0
  233. package/lib/src/schema.gql +14 -1
  234. package/lib/src/shacl/SHACLFlow.d.ts +1 -1
  235. package/lib/src/shacl/SHACLFlow.js +9 -9
  236. package/lib/src/shacl/SHACLShape.d.ts +26 -1
  237. package/lib/src/shacl/SHACLShape.js +140 -38
  238. package/lib/src/shacl/SHACLShape.test.js +82 -0
  239. package/lib/src/typeDefs.js +3 -615
  240. package/lib/src/utils.d.ts +6 -6
  241. package/lib/src/utils.js +6 -6
  242. package/package.json +9 -24
  243. package/rollup.config.js +0 -7
  244. package/src/Ad4mClient.test.ts +1192 -1288
  245. package/src/Ad4mClient.ts +46 -15
  246. package/src/Literal.test.ts +10 -5
  247. package/src/Literal.ts +6 -5
  248. package/src/agent/Agent.ts +0 -99
  249. package/src/agent/AgentClient.ts +238 -467
  250. package/src/agent/AgentStatus.ts +0 -12
  251. package/src/ai/AIClient.ts +96 -296
  252. package/src/ai/AITypes.ts +66 -0
  253. package/src/ai/Tasks.ts +0 -52
  254. package/src/apiClient.ts +287 -0
  255. package/src/cache/PersistentCache.ts +145 -0
  256. package/src/cache/cache.test.ts +713 -0
  257. package/src/expression/Expression.ts +3 -43
  258. package/src/expression/ExpressionClient.ts +148 -77
  259. package/src/expression/ExpressionRef.ts +2 -8
  260. package/src/generated/api/AIModelLoadingStatus.ts +3 -0
  261. package/src/generated/api/AddLinkExpressionRequest.ts +4 -0
  262. package/src/generated/api/AddLinkRequest.ts +4 -0
  263. package/src/generated/api/AddLinksBulkRequest.ts +4 -0
  264. package/src/generated/api/AddSdnaRequest.ts +3 -0
  265. package/src/generated/api/ApplyTemplateRequest.ts +3 -0
  266. package/src/generated/api/AuthInfoInput.ts +4 -0
  267. package/src/generated/api/CapabilityInput.ts +4 -0
  268. package/src/generated/api/CommitBatchRequest.ts +3 -0
  269. package/src/generated/api/ComputeLogEntry.ts +3 -0
  270. package/src/generated/api/CreateExpressionRequest.ts +3 -0
  271. package/src/generated/api/CreatePerspectiveRequest.ts +3 -0
  272. package/src/generated/api/CreateSubjectRequest.ts +3 -0
  273. package/src/generated/api/EmbedRequest.ts +3 -0
  274. package/src/generated/api/EntanglementProofInput.ts +3 -0
  275. package/src/generated/api/ExecuteCommandsRequest.ts +3 -0
  276. package/src/generated/api/ExportRequest.ts +3 -0
  277. package/src/generated/api/ExpressionManyRequest.ts +3 -0
  278. package/src/generated/api/ExpressionProof.ts +3 -0
  279. package/src/generated/api/ExpressionProofInput.ts +3 -0
  280. package/src/generated/api/FriendSendMessageRequest.ts +3 -0
  281. package/src/generated/api/FriendsListRequest.ts +3 -0
  282. package/src/generated/api/GenerateAgentRequest.ts +3 -0
  283. package/src/generated/api/GenerateJwtRequest.ts +3 -0
  284. package/src/generated/api/GetSubjectDataRequest.ts +3 -0
  285. package/src/generated/api/ImportAgentRequest.ts +3 -0
  286. package/src/generated/api/ImportRequest.ts +3 -0
  287. package/src/generated/api/JoinNeighbourhoodRequest.ts +3 -0
  288. package/src/generated/api/LanguageMetaInput.ts +3 -0
  289. package/src/generated/api/Link.ts +3 -0
  290. package/src/generated/api/LinkExpression.ts +6 -0
  291. package/src/generated/api/LinkExpressionInput.ts +6 -0
  292. package/src/generated/api/LinkInput.ts +3 -0
  293. package/src/generated/api/LinkLanguageTemplatesRequest.ts +3 -0
  294. package/src/generated/api/LinkMutations.ts +5 -0
  295. package/src/generated/api/LinkStatus.ts +3 -0
  296. package/src/generated/api/LockAgentRequest.ts +3 -0
  297. package/src/generated/api/ModelType.ts +3 -0
  298. package/src/generated/api/NotificationInput.ts +3 -0
  299. package/src/generated/api/OpenLinkRequest.ts +3 -0
  300. package/src/generated/api/PermitCapabilityRequest.ts +3 -0
  301. package/src/generated/api/PerspectiveInput.ts +4 -0
  302. package/src/generated/api/PromptRequest.ts +3 -0
  303. package/src/generated/api/PublishLanguageRequest.ts +4 -0
  304. package/src/generated/api/PublishNeighbourhoodRequest.ts +4 -0
  305. package/src/generated/api/QueryRequest.ts +6 -0
  306. package/src/generated/api/RemoveLinkRequest.ts +4 -0
  307. package/src/generated/api/RemoveLinksBulkRequest.ts +4 -0
  308. package/src/generated/api/ResourceInput.ts +3 -0
  309. package/src/generated/api/SetDefaultModelRequest.ts +4 -0
  310. package/src/generated/api/SetFreeHostingEnabledRequest.ts +3 -0
  311. package/src/generated/api/SetMultiUserRequest.ts +3 -0
  312. package/src/generated/api/SetStatusRequest.ts +3 -0
  313. package/src/generated/api/SignMessageRequest.ts +3 -0
  314. package/src/generated/api/TrustedAgentsRequest.ts +3 -0
  315. package/src/generated/api/UnlockAgentRequest.ts +3 -0
  316. package/src/generated/api/UpdateLinkRequest.ts +5 -0
  317. package/src/generated/api/UpdatePerspectiveRequest.ts +3 -0
  318. package/src/generated/api/UserStatistics.ts +3 -0
  319. package/src/generated/api/VerificationRequestResult.ts +3 -0
  320. package/src/generated/api/VerifySignatureRequest.ts +3 -0
  321. package/src/generated/api/WriteSettingsRequest.ts +3 -0
  322. package/src/generated/api/index.ts +49 -0
  323. package/src/index.ts +8 -2
  324. package/src/jestSetup.ts +1 -1
  325. package/src/language/Icon.ts +0 -4
  326. package/src/language/Language.ts +51 -248
  327. package/src/language/LanguageClient.ts +21 -132
  328. package/src/language/LanguageHandle.ts +0 -14
  329. package/src/language/LanguageMeta.ts +0 -29
  330. package/src/language/LanguageRef.ts +0 -7
  331. package/src/links/Links.ts +0 -37
  332. package/src/model/Ad4mModel.test.ts +1664 -792
  333. package/src/model/Ad4mModel.ts +664 -499
  334. package/src/model/ModelQueryBuilder.ts +362 -183
  335. package/src/model/decorators.ts +71 -22
  336. package/src/model/hydration.ts +3 -772
  337. package/src/model/index.ts +3 -4
  338. package/src/model/json-schema.ts +2 -2
  339. package/src/model/query-cache.test.ts +54 -0
  340. package/src/model/query-cache.ts +79 -0
  341. package/src/model/query-common.ts +1 -1
  342. package/src/model/query-sparql.test.ts +376 -0
  343. package/src/model/query-sparql.ts +504 -0
  344. package/src/model/query-utils.ts +209 -0
  345. package/src/model/relation-filtering.test.ts +60 -53
  346. package/src/model/sdna.ts +1 -1
  347. package/src/model/shacl-gen.ts +163 -64
  348. package/src/model/shacl-roundtrip.test.ts +197 -0
  349. package/src/model/types-typed-query.test.ts +360 -0
  350. package/src/model/types.ts +256 -5
  351. package/src/neighbourhood/Neighbourhood.ts +0 -9
  352. package/src/neighbourhood/NeighbourhoodClient.ts +42 -207
  353. package/src/neighbourhood/NeighbourhoodProxy.test.ts +34 -36
  354. package/src/perspectives/LinkQuery.ts +0 -15
  355. package/src/perspectives/Perspective.ts +1 -12
  356. package/src/perspectives/PerspectiveClient.test.ts +262 -0
  357. package/src/perspectives/PerspectiveClient.ts +252 -468
  358. package/src/perspectives/PerspectiveDiff.ts +0 -8
  359. package/src/perspectives/PerspectiveHandle.ts +1 -12
  360. package/src/perspectives/PerspectiveProxy.test.ts +125 -0
  361. package/src/perspectives/PerspectiveProxy.ts +522 -434
  362. package/src/perspectives/SparqlBindings.ts +79 -0
  363. package/src/perspectives/WakerSubscriptionManager.ts +13 -13
  364. package/src/runtime/RuntimeClient.ts +118 -461
  365. package/src/runtime/RuntimeTypes.ts +144 -0
  366. package/src/shacl/SHACLFlow.ts +9 -9
  367. package/src/shacl/SHACLShape.test.ts +204 -0
  368. package/src/shacl/SHACLShape.ts +191 -39
  369. package/src/typeDefs.ts +3 -5
  370. package/src/utils.ts +6 -6
  371. package/tsconfig.json +3 -7
  372. package/lib/src/model/query-surreal.d.ts +0 -44
  373. package/lib/src/model/query-surreal.js +0 -249
  374. package/lib/src/model/surreal-utils.js +0 -128
  375. package/shims/reflect-metadata.ts +0 -0
  376. package/shims/type-graphql.ts +0 -75
  377. package/src/PubSub.ts +0 -17
  378. package/src/agent/AgentResolver.ts +0 -263
  379. package/src/ai/AIResolver.ts +0 -372
  380. package/src/buildSchema.ts +0 -43
  381. package/src/expression/ExpressionResolver.ts +0 -64
  382. package/src/language/LanguageContext.ts +0 -37
  383. package/src/language/LanguageResolver.ts +0 -98
  384. package/src/model/Subject.ts +0 -159
  385. package/src/model/prolog-facts.ts +0 -145
  386. package/src/model/query-prolog.ts +0 -148
  387. package/src/model/query-surreal.ts +0 -280
  388. package/src/model/surreal-utils.ts +0 -147
  389. package/src/neighbourhood/NeighbourhoodResolver.ts +0 -100
  390. package/src/perspectives/PerspectiveResolver.ts +0 -372
  391. package/src/runtime/RuntimeResolver.ts +0 -691
  392. package/src/unwrapApolloResult.ts +0 -16
  393. package/tsconfig-browser.json +0 -82
@@ -1,85 +1,14 @@
1
- var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
- var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
- if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
- else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
- return c > 3 && r && Object.defineProperty(target, key, r), r;
6
- };
7
- var __metadata = (this && this.__metadata) || function (k, v) {
8
- if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
- };
10
- import { Field, InputType, ObjectType } from "type-graphql";
11
1
  import { ExpressionGeneric } from "../expression/Expression";
12
- let LanguageMeta = class LanguageMeta {
13
- };
14
- __decorate([
15
- Field(),
16
- __metadata("design:type", String)
17
- ], LanguageMeta.prototype, "name", void 0);
18
- __decorate([
19
- Field(),
20
- __metadata("design:type", String)
21
- ], LanguageMeta.prototype, "address", void 0);
22
- __decorate([
23
- Field({ nullable: true }),
24
- __metadata("design:type", String)
25
- ], LanguageMeta.prototype, "description", void 0);
26
- __decorate([
27
- Field(),
28
- __metadata("design:type", String)
29
- ], LanguageMeta.prototype, "author", void 0);
30
- __decorate([
31
- Field({ nullable: true }),
32
- __metadata("design:type", Boolean)
33
- ], LanguageMeta.prototype, "templated", void 0);
34
- __decorate([
35
- Field({ nullable: true }),
36
- __metadata("design:type", String)
37
- ], LanguageMeta.prototype, "templateSourceLanguageAddress", void 0);
38
- __decorate([
39
- Field({ nullable: true }),
40
- __metadata("design:type", String)
41
- ], LanguageMeta.prototype, "templateAppliedParams", void 0);
42
- __decorate([
43
- Field(type => [String], { nullable: true }),
44
- __metadata("design:type", Array)
45
- ], LanguageMeta.prototype, "possibleTemplateParams", void 0);
46
- __decorate([
47
- Field({ nullable: true }),
48
- __metadata("design:type", String)
49
- ], LanguageMeta.prototype, "sourceCodeLink", void 0);
50
- LanguageMeta = __decorate([
51
- ObjectType()
52
- ], LanguageMeta);
53
- export { LanguageMeta };
54
- let LanguageMetaInput = class LanguageMetaInput {
2
+ export class LanguageMeta {
3
+ }
4
+ export class LanguageMetaInput {
55
5
  constructor(name, description) {
56
6
  this.name = name;
57
7
  this.description = description;
58
8
  if (!this.description)
59
9
  this.description = "";
60
10
  }
61
- };
62
- __decorate([
63
- Field(),
64
- __metadata("design:type", String)
65
- ], LanguageMetaInput.prototype, "name", void 0);
66
- __decorate([
67
- Field(),
68
- __metadata("design:type", String)
69
- ], LanguageMetaInput.prototype, "description", void 0);
70
- __decorate([
71
- Field(type => [String], { nullable: true }),
72
- __metadata("design:type", Array)
73
- ], LanguageMetaInput.prototype, "possibleTemplateParams", void 0);
74
- __decorate([
75
- Field({ nullable: true }),
76
- __metadata("design:type", String)
77
- ], LanguageMetaInput.prototype, "sourceCodeLink", void 0);
78
- LanguageMetaInput = __decorate([
79
- InputType(),
80
- __metadata("design:paramtypes", [String, String])
81
- ], LanguageMetaInput);
82
- export { LanguageMetaInput };
11
+ }
83
12
  export class LanguageMetaInternal {
84
13
  }
85
14
  export class LanguageExpression extends ExpressionGeneric(LanguageMetaInternal) {
@@ -1,30 +1,7 @@
1
- var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
- var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
- if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
- else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
- return c > 3 && r && Object.defineProperty(target, key, r), r;
6
- };
7
- var __metadata = (this && this.__metadata) || function (k, v) {
8
- if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
- };
10
- import { Field, ObjectType } from "type-graphql";
11
1
  // Unique Language ID with option type
12
- let LanguageRef = class LanguageRef {
2
+ export class LanguageRef {
13
3
  constructor(address, name) {
14
4
  this.address = address;
15
5
  this.name = name;
16
6
  }
17
- };
18
- __decorate([
19
- Field(),
20
- __metadata("design:type", String)
21
- ], LanguageRef.prototype, "address", void 0);
22
- __decorate([
23
- Field(),
24
- __metadata("design:type", String)
25
- ], LanguageRef.prototype, "name", void 0);
26
- LanguageRef = __decorate([
27
- ObjectType(),
28
- __metadata("design:paramtypes", [String, String])
29
- ], LanguageRef);
30
- export { LanguageRef };
7
+ }
@@ -1,90 +1,22 @@
1
- var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
- var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
- if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
- else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
- return c > 3 && r && Object.defineProperty(target, key, r), r;
6
- };
7
- var __metadata = (this && this.__metadata) || function (k, v) {
8
- if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
- };
10
- import { Field, InputType, ObjectType } from "type-graphql";
11
1
  import { ExpressionGeneric, ExpressionGenericInput } from '../expression/Expression';
12
- let Link = class Link {
2
+ export class Link {
13
3
  constructor(obj) {
14
4
  this.source = obj.source ? obj.source : '';
15
5
  this.target = obj.target ? obj.target : '';
16
6
  this.predicate = obj.predicate ? obj.predicate : '';
17
7
  }
18
- };
19
- __decorate([
20
- Field(),
21
- __metadata("design:type", String)
22
- ], Link.prototype, "source", void 0);
23
- __decorate([
24
- Field(),
25
- __metadata("design:type", String)
26
- ], Link.prototype, "target", void 0);
27
- __decorate([
28
- Field({ nullable: true }),
29
- __metadata("design:type", String)
30
- ], Link.prototype, "predicate", void 0);
31
- Link = __decorate([
32
- ObjectType(),
33
- __metadata("design:paramtypes", [Object])
34
- ], Link);
35
- export { Link };
36
- let LinkMutations = class LinkMutations {
37
- };
38
- __decorate([
39
- Field(type => [LinkInput]),
40
- __metadata("design:type", Array)
41
- ], LinkMutations.prototype, "additions", void 0);
42
- __decorate([
43
- Field(type => [LinkExpressionInput]),
44
- __metadata("design:type", Array)
45
- ], LinkMutations.prototype, "removals", void 0);
46
- LinkMutations = __decorate([
47
- InputType()
48
- ], LinkMutations);
49
- export { LinkMutations };
50
- let LinkExpressionMutations = class LinkExpressionMutations {
8
+ }
9
+ export class LinkMutations {
10
+ }
11
+ export class LinkExpressionMutations {
51
12
  constructor(additions, removals) {
52
13
  this.additions = additions;
53
14
  this.removals = removals;
54
15
  }
55
- };
56
- __decorate([
57
- Field(type => [LinkExpression]),
58
- __metadata("design:type", Array)
59
- ], LinkExpressionMutations.prototype, "additions", void 0);
60
- __decorate([
61
- Field(type => [LinkExpression]),
62
- __metadata("design:type", Array)
63
- ], LinkExpressionMutations.prototype, "removals", void 0);
64
- LinkExpressionMutations = __decorate([
65
- ObjectType(),
66
- __metadata("design:paramtypes", [Array, Array])
67
- ], LinkExpressionMutations);
68
- export { LinkExpressionMutations };
69
- let LinkInput = class LinkInput {
70
- };
71
- __decorate([
72
- Field(),
73
- __metadata("design:type", String)
74
- ], LinkInput.prototype, "source", void 0);
75
- __decorate([
76
- Field(),
77
- __metadata("design:type", String)
78
- ], LinkInput.prototype, "target", void 0);
79
- __decorate([
80
- Field({ nullable: true }),
81
- __metadata("design:type", String)
82
- ], LinkInput.prototype, "predicate", void 0);
83
- LinkInput = __decorate([
84
- InputType()
85
- ], LinkInput);
86
- export { LinkInput };
87
- let LinkExpression = class LinkExpression extends ExpressionGeneric(Link) {
16
+ }
17
+ export class LinkInput {
18
+ }
19
+ export class LinkExpression extends ExpressionGeneric(Link) {
88
20
  hash() {
89
21
  const mash = JSON.stringify(this.data, Object.keys(this.data).sort()) +
90
22
  JSON.stringify(this.author) + this.timestamp;
@@ -96,26 +28,10 @@ let LinkExpression = class LinkExpression extends ExpressionGeneric(Link) {
96
28
  }
97
29
  return hash;
98
30
  }
99
- };
100
- __decorate([
101
- Field({ nullable: true, defaultValue: 'shared' }),
102
- __metadata("design:type", String)
103
- ], LinkExpression.prototype, "status", void 0);
104
- LinkExpression = __decorate([
105
- ObjectType()
106
- ], LinkExpression);
107
- export { LinkExpression };
31
+ }
108
32
  ;
109
- let LinkExpressionInput = class LinkExpressionInput extends ExpressionGenericInput(LinkInput) {
110
- };
111
- __decorate([
112
- Field({ nullable: true, defaultValue: 'shared' }),
113
- __metadata("design:type", String)
114
- ], LinkExpressionInput.prototype, "status", void 0);
115
- LinkExpressionInput = __decorate([
116
- InputType()
117
- ], LinkExpressionInput);
118
- export { LinkExpressionInput };
33
+ export class LinkExpressionInput extends ExpressionGenericInput(LinkInput) {
34
+ }
119
35
  ;
120
36
  export function linkEqual(l1, l2) {
121
37
  return l1.author == l2.author &&
@@ -127,22 +43,9 @@ export function linkEqual(l1, l2) {
127
43
  export function isLink(l) {
128
44
  return l && l.source && l.target;
129
45
  }
130
- let LinkExpressionUpdated = class LinkExpressionUpdated {
46
+ export class LinkExpressionUpdated {
131
47
  constructor(oldLink, newLink) {
132
48
  this.oldLink = oldLink;
133
49
  this.newLink = newLink;
134
50
  }
135
- };
136
- __decorate([
137
- Field(type => LinkExpression),
138
- __metadata("design:type", LinkExpression)
139
- ], LinkExpressionUpdated.prototype, "oldLink", void 0);
140
- __decorate([
141
- Field(type => LinkExpression),
142
- __metadata("design:type", LinkExpression)
143
- ], LinkExpressionUpdated.prototype, "newLink", void 0);
144
- LinkExpressionUpdated = __decorate([
145
- ObjectType(),
146
- __metadata("design:paramtypes", [LinkExpression, LinkExpression])
147
- ], LinkExpressionUpdated);
148
- export { LinkExpressionUpdated };
51
+ }
@@ -1,7 +1,8 @@
1
1
  import { PerspectiveProxy } from "../perspectives/PerspectiveProxy";
2
+ import type { SHACLShape } from "../shacl/SHACLShape";
2
3
  import type { JSONSchema, JSONSchemaToModelOptions } from "./json-schema";
3
4
  import { ModelQueryBuilder } from "./ModelQueryBuilder";
4
- import type { ParentScope, IncludeMap, Query, GetOptions, AllInstancesResult, ResultsWithTotalCount, PaginationResult, ModelMetadata, ValueTuple } from "./types";
5
+ import type { ParentScope, IncludeMap, Query, GetOptions, ResultsWithTotalCount, PaginationResult, ModelMetadata, TypedQuery, IncludeExtras, IncludeOf } from "./types";
5
6
  /**
6
7
  * Base class for defining data models in AD4M.
7
8
  *
@@ -105,6 +106,11 @@ export declare class Ad4mModel {
105
106
  author: string;
106
107
  createdAt: any;
107
108
  updatedAt: any;
109
+ /**
110
+ * Backwards compatibility alias for createdAt.
111
+ * @deprecated Use createdAt instead. This will be removed in a future version.
112
+ */
113
+ get timestamp(): any;
108
114
  private static classNamesByClass;
109
115
  /**
110
116
  * Generates the SDNA (Subject DNA) Prolog rules for this model class.
@@ -126,11 +132,6 @@ export declare class Ad4mModel {
126
132
  name: string;
127
133
  };
128
134
  static getClassName(perspective: PerspectiveProxy): Promise<string>;
129
- /**
130
- * Backwards compatibility alias for createdAt.
131
- * @deprecated Use createdAt instead. This will be removed in a future version.
132
- */
133
- get timestamp(): any;
134
135
  /**
135
136
  * Extracts metadata from decorators for query building.
136
137
  *
@@ -184,7 +185,7 @@ export declare class Ad4mModel {
184
185
  * const recipe = new Recipe(perspective);
185
186
  *
186
187
  * // Create with specific base expression
187
- * const recipe = new Recipe(perspective, "literal://...");
188
+ * const recipe = new Recipe(perspective, "literal:...");
188
189
  * ```
189
190
  */
190
191
  constructor(perspective: PerspectiveProxy, baseExpression?: string);
@@ -192,10 +193,6 @@ export declare class Ad4mModel {
192
193
  * The unique identifier (expression URI) of this model instance.
193
194
  */
194
195
  get id(): string;
195
- /**
196
- * @deprecated Use `.id` instead. Will be removed in a future version.
197
- */
198
- get baseExpression(): string;
199
196
  /**
200
197
  * Protected getter for the perspective.
201
198
  * Allows subclasses to access the perspective while keeping it private from external code.
@@ -221,11 +218,6 @@ export declare class Ad4mModel {
221
218
  * @private
222
219
  */
223
220
  private generateRelationAction;
224
- /**
225
- * Assigns decoded Prolog property values to an instance.
226
- * Delegates to the standalone function in hydration.ts.
227
- */
228
- static assignValuesToInstance(perspective: PerspectiveProxy, instance: Ad4mModel, values: ValueTuple[]): Promise<void>;
229
221
  /**
230
222
  * @param includedRelations Controls which relation fields are recorded
231
223
  * in the snapshot for dirty-tracking:
@@ -237,7 +229,8 @@ export declare class Ad4mModel {
237
229
  * • `null` / empty object — skip ALL relations (used by bare
238
230
  * subscriptions that don't eagerly load relations).
239
231
  */
240
- private takeSnapshot;
232
+ /** @internal */
233
+ protected takeSnapshot(includedRelations?: Record<string, any> | null): void;
241
234
  /**
242
235
  * Returns `true` if any tracked property or relation has changed
243
236
  * since the last hydration (or since `takeSnapshot()` was last called).
@@ -268,15 +261,14 @@ export declare class Ad4mModel {
268
261
  */
269
262
  changedFields(): string[];
270
263
  private getData;
271
- static queryToProlog(perspective: PerspectiveProxy, query: Query, modelClassName?: string | null): Promise<string>;
272
264
  /**
273
- * Generates a SurrealQL query from a Query object.
265
+ * Generates a SPARQL query from a Query object.
274
266
  *
275
267
  * @description
276
- * This method translates high-level query parameters into a SurrealQL query string
277
- * that can be executed against the SurrealDB backend. Unlike Prolog queries which
278
- * operate on SDNA-aware predicates, SurrealQL queries operate directly on raw links
279
- * stored in SurrealDB.
268
+ * This method translates high-level query parameters into a SPARQL query string
269
+ * that can be executed against the SPARQL backend. Unlike Prolog queries which
270
+ * operate on SDNA-aware predicates, SPARQL queries operate directly on raw links
271
+ * stored in SPARQL.
280
272
  *
281
273
  * The generated query uses a CTE (Common Table Expression) pattern:
282
274
  * 1. First, identify candidate base expressions by filtering links based on where conditions
@@ -284,7 +276,7 @@ export declare class Ad4mModel {
284
276
  * 3. Finally, apply ordering, pagination (LIMIT/START) at the SQL level
285
277
  *
286
278
  * Key architectural notes:
287
- * - SurrealDB stores only raw links (source, predicate, target, author, timestamp)
279
+ * - SPARQL stores only raw links (source, predicate, target, author, timestamp)
288
280
  * - No SDNA knowledge at the database level
289
281
  * - Properties are resolved via subqueries that look for links with specific predicates
290
282
  * - Relations are similar but return multiple values instead of one
@@ -292,11 +284,11 @@ export declare class Ad4mModel {
292
284
  *
293
285
  * @param perspective - The perspective to query (used for metadata extraction)
294
286
  * @param query - Query parameters (where, order, limit, offset, properties, relations)
295
- * @returns Complete SurrealQL query string ready for execution
287
+ * @returns Complete SPARQL query string ready for execution
296
288
  *
297
289
  * @example
298
290
  * ```typescript
299
- * const query = Recipe.queryToSurrealQL(perspective, {
291
+ * const query = Recipe.queryToSPARQL(perspective, {
300
292
  * where: { name: "Pasta", rating: { gt: 4 } },
301
293
  * order: { timestamp: "DESC" },
302
294
  * limit: 10
@@ -305,33 +297,61 @@ export declare class Ad4mModel {
305
297
  * // FROM link WHERE ... GROUP BY source ORDER BY timestamp DESC LIMIT 10
306
298
  * ```
307
299
  */
308
- static queryToSurrealQL(perspective: PerspectiveProxy, query: Query): Promise<string>;
309
- static instancesFromPrologResult<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query: Query, result: AllInstancesResult): Promise<ResultsWithTotalCount<T>>;
300
+ static queryToSPARQL(perspective: PerspectiveProxy, query: Query): Promise<string>;
310
301
  /**
311
- * Converts SurrealDB query results to Ad4mModel instances.
302
+ * Build the JSON parameters needed for a model query/subscription endpoint.
303
+ * Returns the className and queryJson that the Rust executor expects.
304
+ * Shape resolution happens server-side from the perspective's SHACL triples.
305
+ * @internal
306
+ */
307
+ static prepareModelQueryParams(query?: Query, classNameOverride?: string | null): {
308
+ className: string;
309
+ queryJson: string;
310
+ metadata: ModelMetadata;
311
+ };
312
+ /**
313
+ * Parse raw model query/subscription result JSON into typed model instances.
314
+ * Used by ModelQueryBuilder to convert subscription updates without circular imports.
315
+ * @internal
316
+ */
317
+ static parseModelResult<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, raw: any, include?: IncludeMap, properties?: string[]): T[];
318
+ /**
319
+ * Resolve non-literal (file-language) properties on an array of already-constructed
320
+ * model instances. Handles two cases:
312
321
  *
313
- * @param perspective - The perspective context
314
- * @param query - The query parameters used
315
- * @param result - Array of result objects from SurrealDB
316
- * @returns Promise resolving to results with total count
322
+ * 1. The Rust executor returned a raw URI string → fetch via `getExpression` then apply transform.
323
+ * 2. The Rust executor already resolved the expression and returned a `FileData` object
324
+ * (happens when the perspective backend eagerly fetches file content) → apply transform
325
+ * (or `defaultFileDecode` if no transform is registered on the class, e.g. for SHACL-
326
+ * synthesised model classes).
317
327
  *
328
+ * Extracted as a public static so `ModelQueryBuilder.subscribe()` can reuse it without
329
+ * duplicating logic or introducing a circular dependency.
318
330
  * @internal
319
331
  */
320
- static instancesFromSurrealResult<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query: Query, result: any[]): Promise<ResultsWithTotalCount<T>>;
332
+ static resolveNonLiteralProps<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, instances: T[]): Promise<void>;
333
+ /**
334
+ * Execute a model query via the executor-side endpoint.
335
+ *
336
+ * This replaces the old SPARQL-build → hydrate → JS-filter → JS-sort → JS-paginate pipeline
337
+ * with a single RPC to the executor that handles everything in Rust.
338
+ *
339
+ * @internal
340
+ */
341
+ private static executeModelQuery;
321
342
  /**
322
343
  * Gets all instances of the model in the perspective that match the query params.
323
344
  *
324
345
  * @param perspective - The perspective to search in
325
346
  * @param query - Optional query parameters to filter results
326
- * @param useSurrealDB - Whether to use SurrealDB (default: true, 10-100x faster) or Prolog (legacy)
347
+ * @param _engine - **Deprecated.** Accepted for backward compatibility but ignored.
348
+ * All queries now use the Rust SPARQL pipeline.
327
349
  * @returns Array of matching models
328
350
  *
329
351
  * @example
330
352
  * ```typescript
331
- * // Get all recipes (uses SurrealDB by default)
332
353
  * const allRecipes = await Recipe.findAll(perspective);
333
354
  *
334
- * // Get recipes with specific criteria (uses SurrealDB)
335
355
  * const recipes = await Recipe.findAll(perspective, {
336
356
  * where: {
337
357
  * name: "Pasta",
@@ -340,12 +360,9 @@ export declare class Ad4mModel {
340
360
  * order: { createdAt: "DESC" },
341
361
  * limit: 10
342
362
  * });
343
- *
344
- * // Explicitly use Prolog (legacy, for backward compatibility)
345
- * const recipesProlog = await Recipe.findAll(perspective, {}, false);
346
363
  * ```
347
364
  */
348
- static findAll<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query, useSurrealDB?: boolean): Promise<T[]>;
365
+ static findAll<T extends Ad4mModel, Q extends TypedQuery<T> = {}>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Q): Promise<(T & IncludeExtras<T, IncludeOf<Q>>)[]>;
349
366
  /**
350
367
  * Finds the first instance matching the query, or `null` if none exists.
351
368
  *
@@ -353,7 +370,7 @@ export declare class Ad4mModel {
353
370
  *
354
371
  * @param perspective - The perspective to search in
355
372
  * @param query - Optional query parameters to filter results
356
- * @param useSurrealDB - Whether to use SurrealDB (default: true) or Prolog (legacy)
373
+ * @param _engine - **Deprecated.** Accepted for backward compatibility but ignored.
357
374
  * @returns The first matching instance, or `null`
358
375
  *
359
376
  * @example
@@ -366,13 +383,13 @@ export declare class Ad4mModel {
366
383
  * }
367
384
  * ```
368
385
  */
369
- static findOne<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query, useSurrealDB?: boolean): Promise<T | null>;
386
+ static findOne<T extends Ad4mModel, Q extends TypedQuery<T> = {}>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Q): Promise<(T & IncludeExtras<T, IncludeOf<Q>>) | null>;
370
387
  /**
371
388
  * Gets all instances with count of total matches without offset & limit applied.
372
389
  *
373
390
  * @param perspective - The perspective to search in
374
391
  * @param query - Optional query parameters to filter results
375
- * @param useSurrealDB - Whether to use SurrealDB (default: true, 10-100x faster) or Prolog (legacy)
392
+ * @param _engine - **Deprecated.** Accepted for backward compatibility but ignored.
376
393
  * @returns Object containing results array and total count
377
394
  *
378
395
  * @example
@@ -382,12 +399,9 @@ export declare class Ad4mModel {
382
399
  * limit: 10
383
400
  * });
384
401
  * console.log(`Showing 10 of ${totalCount} dessert recipes`);
385
- *
386
- * // Use Prolog explicitly (legacy)
387
- * const { results, totalCount } = await Recipe.findAllAndCount(perspective, {}, false);
388
402
  * ```
389
403
  */
390
- static findAllAndCount<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query, useSurrealDB?: boolean): Promise<ResultsWithTotalCount<T>>;
404
+ static findAllAndCount<T extends Ad4mModel, Q extends TypedQuery<T> = {}>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Q): Promise<ResultsWithTotalCount<T & IncludeExtras<T, IncludeOf<Q>>>>;
391
405
  /**
392
406
  * Helper function for pagination with explicit page size and number.
393
407
  *
@@ -395,7 +409,6 @@ export declare class Ad4mModel {
395
409
  * @param pageSize - Number of items per page
396
410
  * @param pageNumber - Which page to retrieve (1-based)
397
411
  * @param query - Optional additional query parameters
398
- * @param useSurrealDB - Whether to use SurrealDB (default: true, 10-100x faster) or Prolog (legacy)
399
412
  * @returns Paginated results with metadata
400
413
  *
401
414
  * @example
@@ -404,29 +417,23 @@ export declare class Ad4mModel {
404
417
  * where: { category: "Main Course" }
405
418
  * });
406
419
  * console.log(`Page ${page.pageNumber} of recipes, ${page.results.length} items`);
407
- *
408
- * // Use Prolog explicitly (legacy)
409
- * const pageProlog = await Recipe.paginate(perspective, 10, 1, {}, false);
410
420
  * ```
411
421
  */
412
- static paginate<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, pageSize: number, pageNumber: number, query?: Query, useSurrealDB?: boolean): Promise<PaginationResult<T>>;
413
- static countQueryToProlog(perspective: PerspectiveProxy, query?: Query, modelClassName?: string | null): Promise<string>;
422
+ static paginate<T extends Ad4mModel, Q extends TypedQuery<T> = {}>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, pageSize: number, pageNumber: number, query?: Q): Promise<PaginationResult<T & IncludeExtras<T, IncludeOf<Q>>>>;
414
423
  /**
415
- * Generates a SurrealQL COUNT query for the model.
424
+ * Generates a SPARQL COUNT query for the model.
416
425
  *
417
426
  * @param perspective - The perspective context
418
427
  * @param query - Query parameters to filter the count
419
- * @returns SurrealQL COUNT query string
428
+ * @returns SPARQL COUNT query string
420
429
  *
421
430
  * @private
422
431
  */
423
- static countQueryToSurrealQL(perspective: PerspectiveProxy, query: Query): Promise<string>;
424
432
  /**
425
433
  * Gets a count of all matching instances.
426
434
  *
427
435
  * @param perspective - The perspective to search in
428
436
  * @param query - Optional query parameters to filter results
429
- * @param useSurrealDB - Whether to use SurrealDB (default: true, 10-100x faster) or Prolog (legacy)
430
437
  * @returns Total count of matching entities
431
438
  *
432
439
  * @example
@@ -435,12 +442,9 @@ export declare class Ad4mModel {
435
442
  * const activeRecipes = await Recipe.count(perspective, {
436
443
  * where: { status: "active" }
437
444
  * });
438
- *
439
- * // Use Prolog explicitly (legacy)
440
- * const countProlog = await Recipe.count(perspective, {}, false);
441
445
  * ```
442
446
  */
443
- static count(perspective: PerspectiveProxy, query?: Query, useSurrealDB?: boolean): any;
447
+ static count<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: TypedQuery<T>): Promise<number>;
444
448
  private setProperty;
445
449
  /** Resolve a relation argument to a plain string ID. Accepts either a raw
446
450
  * string ID or an Ad4mModel instance (in which case `.id` is used). */
@@ -477,6 +481,30 @@ export declare class Ad4mModel {
477
481
  save(batchId?: string): Promise<void>;
478
482
  private cleanCopy;
479
483
  private innerUpdate;
484
+ /**
485
+ * Evaluate SPARQL getters for a batch of instances on demand.
486
+ *
487
+ * Since deepQuery defaults to true, property getters are evaluated
488
+ * automatically during collection queries. Use this method when
489
+ * deepQuery was explicitly set to false and you want to lazily
490
+ * resolve getter-backed properties for a subset of instances.
491
+ *
492
+ * @param instances - Array of model instances to evaluate getters on
493
+ * @param perspective - The perspective to query against
494
+ * @param propertyNames - Optional list of getter-backed property names to evaluate.
495
+ * If omitted, all getters are evaluated.
496
+ *
497
+ * @example
498
+ * ```typescript
499
+ * const messages = await Message.query(perspective).deepQuery(false).limit(30).get();
500
+ * // messages[i].replyingTo is undefined (getter skipped)
501
+ *
502
+ * // Evaluate getters for the visible subset
503
+ * await Message.evaluateGetters(messages.slice(0, 10), perspective, ['replyingTo']);
504
+ * // messages[0..9].replyingTo is now populated
505
+ * ```
506
+ */
507
+ static evaluateGetters<T extends Ad4mModel>(instances: T[], perspective: PerspectiveProxy, propertyNames?: string[]): Promise<void>;
480
508
  /**
481
509
  * Gets the model instance with all properties and relations populated.
482
510
  *
@@ -618,6 +646,20 @@ export declare class Ad4mModel {
618
646
  * ```
619
647
  */
620
648
  static register(this: typeof Ad4mModel, perspective: PerspectiveProxy): Promise<void>;
649
+ /**
650
+ * Batch-registers multiple model classes on a perspective in a single RPC call.
651
+ * This is significantly faster than calling `register()` on each model individually
652
+ * because it eliminates N-1 round-trips and mutex acquisitions.
653
+ *
654
+ * @param perspective - The perspective to register the models on
655
+ * @param models - Array of Ad4mModel subclasses to register
656
+ *
657
+ * @example
658
+ * ```typescript
659
+ * await Ad4mModel.registerAll(perspective, [Community, Channel, Message, Task]);
660
+ * ```
661
+ */
662
+ static registerAll(perspective: PerspectiveProxy, models: (typeof Ad4mModel)[]): Promise<void>;
621
663
  /**
622
664
  * Executes a set of model operations inside a single batch (transaction).
623
665
  *
@@ -671,7 +713,7 @@ export declare class Ad4mModel {
671
713
  * });
672
714
  * ```
673
715
  */
674
- static query<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query): ModelQueryBuilder<T>;
716
+ static query<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: TypedQuery<T>): ModelQueryBuilder<T>;
675
717
  /**
676
718
  * Creates an Ad4mModel class from a JSON Schema definition.
677
719
  *
@@ -724,4 +766,42 @@ export declare class Ad4mModel {
724
766
  * @throws Error when namespace cannot be inferred
725
767
  */
726
768
  static fromJSONSchema(schema: JSONSchema, options: JSONSchemaToModelOptions): typeof Ad4mModel;
769
+ /**
770
+ * Creates a fully functional Ad4mModel subclass from a SHACL shape.
771
+ *
772
+ * Unlike `fromJSONSchema()`, no predicate inference is required —
773
+ * `SHACLShape` already contains the exact predicate URI in `path` for
774
+ * every property. The method reads each property's `path`, `maxCount`,
775
+ * `writable`, and `resolveLanguage` directly and writes them to the
776
+ * WeakMap metadata registries.
777
+ *
778
+ * Properties with `hasValue` (flag / type-discrimination markers) are
779
+ * registered as hidden flag entries so that the SPARQL query builder emits
780
+ * the fixed triple `?source <predicate> <value>` needed for type discrimination.
781
+ * Properties without a `name` field are skipped.
782
+ *
783
+ * **Backward-compat:** Old Flux SHACL shapes (created before `sh:hasValue`
784
+ * was persisted on property shapes) carry the flag value only in
785
+ * `shape.constructor_actions` as the `target` of an `addLink` action.
786
+ * This method recovers those values so that old perspectives are queried
787
+ * with the correct type-discriminator triple.
788
+ *
789
+ * @param shape - SHACL node shape (as returned by `PerspectiveProxy.getAllShacl()`)
790
+ * @param name - Class name to assign (e.g. "Channel")
791
+ * @returns Generated Ad4mModel subclass, ready for querying
792
+ */
793
+ /**
794
+ * Synthesise an `Ad4mModel` subclass from a SHACL shape.
795
+ *
796
+ * @param shape - The SHACL shape to synthesise from.
797
+ * @param name - The model name (e.g. "Channel").
798
+ * @param classResolver - Optional thunk factory. When provided, any collection
799
+ * property that carries a `sh:class` URI will have its `target` wired up lazily:
800
+ * `target: () => classResolver(localName)`. Because `target` is only called at
801
+ * query time (inside `enrichShapeForIncludes` / `jsonToModelInstance`), the
802
+ * resolver just needs to return the correct class by the time a query runs —
803
+ * making it safe to pass a closure over a registry object that is still being
804
+ * populated (e.g. the `result` record inside `getModelClasses`).
805
+ */
806
+ static fromSHACL(shape: SHACLShape, name: string, classResolver?: (localName: string) => typeof Ad4mModel | undefined): typeof Ad4mModel;
727
807
  }