@coasys/ad4m 0.12.0 → 0.13.0-postmessage-ws-proxy.0

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 (388) hide show
  1. package/README.md +2 -25
  2. package/jest-setup.ts +1 -1
  3. package/lib/index.cjs +7444 -13939
  4. package/lib/index.js +5322 -11888
  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 -373
  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 +7 -2
  153. package/lib/src/index.js +7 -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 +150 -62
  166. package/lib/src/model/Ad4mModel.js +689 -417
  167. package/lib/src/model/Ad4mModel.test.js +1434 -688
  168. package/lib/src/model/ModelQueryBuilder.d.ts +59 -38
  169. package/lib/src/model/ModelQueryBuilder.js +317 -153
  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 +46 -18
  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 +60 -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 +189 -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 +156 -78
  220. package/lib/src/perspectives/PerspectiveProxy.js +474 -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/WakerSubscriptionManager.d.ts +3 -3
  224. package/lib/src/perspectives/WakerSubscriptionManager.js +12 -12
  225. package/lib/src/runtime/RuntimeClient.d.ts +34 -6
  226. package/lib/src/runtime/RuntimeClient.js +131 -362
  227. package/lib/src/runtime/RuntimeResolver.d.ts +28 -1
  228. package/lib/src/runtime/RuntimeResolver.js +197 -4
  229. package/lib/src/runtime/RuntimeTypes.d.ts +101 -0
  230. package/lib/src/runtime/RuntimeTypes.js +45 -0
  231. package/lib/src/schema.gql +27 -1
  232. package/lib/src/shacl/SHACLFlow.d.ts +1 -1
  233. package/lib/src/shacl/SHACLFlow.js +9 -9
  234. package/lib/src/shacl/SHACLShape.d.ts +8 -1
  235. package/lib/src/shacl/SHACLShape.js +57 -38
  236. package/lib/src/shacl/SHACLShape.test.js +82 -0
  237. package/lib/src/typeDefs.js +3 -602
  238. package/lib/src/utils.d.ts +6 -6
  239. package/lib/src/utils.js +6 -6
  240. package/package.json +6 -18
  241. package/rollup.config.js +0 -7
  242. package/src/Ad4mClient.test.ts +1192 -1288
  243. package/src/Ad4mClient.ts +46 -15
  244. package/src/Literal.test.ts +10 -5
  245. package/src/Literal.ts +6 -5
  246. package/src/agent/Agent.ts +0 -99
  247. package/src/agent/AgentClient.ts +238 -465
  248. package/src/agent/AgentStatus.ts +0 -12
  249. package/src/ai/AIClient.ts +96 -296
  250. package/src/ai/AITypes.ts +66 -0
  251. package/src/ai/Tasks.ts +0 -52
  252. package/src/apiClient.ts +287 -0
  253. package/src/cache/PersistentCache.ts +145 -0
  254. package/src/cache/cache.test.ts +713 -0
  255. package/src/expression/Expression.ts +3 -43
  256. package/src/expression/ExpressionClient.ts +148 -77
  257. package/src/expression/ExpressionRef.ts +2 -8
  258. package/src/generated/api/AIModelLoadingStatus.ts +3 -0
  259. package/src/generated/api/AddLinkExpressionRequest.ts +4 -0
  260. package/src/generated/api/AddLinkRequest.ts +4 -0
  261. package/src/generated/api/AddLinksBulkRequest.ts +4 -0
  262. package/src/generated/api/AddSdnaRequest.ts +3 -0
  263. package/src/generated/api/ApplyTemplateRequest.ts +3 -0
  264. package/src/generated/api/AuthInfoInput.ts +4 -0
  265. package/src/generated/api/CapabilityInput.ts +4 -0
  266. package/src/generated/api/CommitBatchRequest.ts +3 -0
  267. package/src/generated/api/ComputeLogEntry.ts +3 -0
  268. package/src/generated/api/CreateExpressionRequest.ts +3 -0
  269. package/src/generated/api/CreatePerspectiveRequest.ts +3 -0
  270. package/src/generated/api/CreateSubjectRequest.ts +3 -0
  271. package/src/generated/api/EmbedRequest.ts +3 -0
  272. package/src/generated/api/EntanglementProofInput.ts +3 -0
  273. package/src/generated/api/ExecuteCommandsRequest.ts +3 -0
  274. package/src/generated/api/ExportRequest.ts +3 -0
  275. package/src/generated/api/ExpressionManyRequest.ts +3 -0
  276. package/src/generated/api/ExpressionProof.ts +3 -0
  277. package/src/generated/api/ExpressionProofInput.ts +3 -0
  278. package/src/generated/api/FriendSendMessageRequest.ts +3 -0
  279. package/src/generated/api/FriendsListRequest.ts +3 -0
  280. package/src/generated/api/GenerateAgentRequest.ts +3 -0
  281. package/src/generated/api/GenerateJwtRequest.ts +3 -0
  282. package/src/generated/api/GetSubjectDataRequest.ts +3 -0
  283. package/src/generated/api/ImportAgentRequest.ts +3 -0
  284. package/src/generated/api/ImportRequest.ts +3 -0
  285. package/src/generated/api/JoinNeighbourhoodRequest.ts +3 -0
  286. package/src/generated/api/LanguageMetaInput.ts +3 -0
  287. package/src/generated/api/Link.ts +3 -0
  288. package/src/generated/api/LinkExpression.ts +6 -0
  289. package/src/generated/api/LinkExpressionInput.ts +6 -0
  290. package/src/generated/api/LinkInput.ts +3 -0
  291. package/src/generated/api/LinkLanguageTemplatesRequest.ts +3 -0
  292. package/src/generated/api/LinkMutations.ts +5 -0
  293. package/src/generated/api/LinkStatus.ts +3 -0
  294. package/src/generated/api/LockAgentRequest.ts +3 -0
  295. package/src/generated/api/ModelType.ts +3 -0
  296. package/src/generated/api/NotificationInput.ts +3 -0
  297. package/src/generated/api/OpenLinkRequest.ts +3 -0
  298. package/src/generated/api/PermitCapabilityRequest.ts +3 -0
  299. package/src/generated/api/PerspectiveInput.ts +4 -0
  300. package/src/generated/api/PromptRequest.ts +3 -0
  301. package/src/generated/api/PublishLanguageRequest.ts +4 -0
  302. package/src/generated/api/PublishNeighbourhoodRequest.ts +4 -0
  303. package/src/generated/api/QueryRequest.ts +6 -0
  304. package/src/generated/api/RemoveLinkRequest.ts +4 -0
  305. package/src/generated/api/RemoveLinksBulkRequest.ts +4 -0
  306. package/src/generated/api/ResourceInput.ts +3 -0
  307. package/src/generated/api/SetDefaultModelRequest.ts +4 -0
  308. package/src/generated/api/SetFreeHostingEnabledRequest.ts +3 -0
  309. package/src/generated/api/SetMultiUserRequest.ts +3 -0
  310. package/src/generated/api/SetStatusRequest.ts +3 -0
  311. package/src/generated/api/SignMessageRequest.ts +3 -0
  312. package/src/generated/api/TrustedAgentsRequest.ts +3 -0
  313. package/src/generated/api/UnlockAgentRequest.ts +3 -0
  314. package/src/generated/api/UpdateLinkRequest.ts +5 -0
  315. package/src/generated/api/UpdatePerspectiveRequest.ts +3 -0
  316. package/src/generated/api/UserStatistics.ts +3 -0
  317. package/src/generated/api/VerificationRequestResult.ts +3 -0
  318. package/src/generated/api/VerifySignatureRequest.ts +3 -0
  319. package/src/generated/api/WriteSettingsRequest.ts +3 -0
  320. package/src/generated/api/index.ts +49 -0
  321. package/src/index.ts +7 -2
  322. package/src/jestSetup.ts +1 -1
  323. package/src/language/Icon.ts +0 -4
  324. package/src/language/Language.ts +51 -248
  325. package/src/language/LanguageClient.ts +21 -132
  326. package/src/language/LanguageHandle.ts +0 -14
  327. package/src/language/LanguageMeta.ts +0 -29
  328. package/src/language/LanguageRef.ts +0 -7
  329. package/src/links/Links.ts +0 -37
  330. package/src/model/Ad4mModel.test.ts +1690 -777
  331. package/src/model/Ad4mModel.ts +749 -477
  332. package/src/model/ModelQueryBuilder.ts +356 -171
  333. package/src/model/decorators.ts +71 -22
  334. package/src/model/hydration.ts +3 -772
  335. package/src/model/index.ts +3 -4
  336. package/src/model/json-schema.ts +2 -2
  337. package/src/model/query-cache.test.ts +54 -0
  338. package/src/model/query-cache.ts +79 -0
  339. package/src/model/query-common.ts +1 -1
  340. package/src/model/query-sparql.test.ts +376 -0
  341. package/src/model/query-sparql.ts +504 -0
  342. package/src/model/query-utils.ts +209 -0
  343. package/src/model/relation-filtering.test.ts +15 -15
  344. package/src/model/sdna.ts +1 -1
  345. package/src/model/shacl-gen.ts +47 -17
  346. package/src/model/types.ts +65 -5
  347. package/src/neighbourhood/Neighbourhood.ts +0 -9
  348. package/src/neighbourhood/NeighbourhoodClient.ts +42 -207
  349. package/src/neighbourhood/NeighbourhoodProxy.test.ts +34 -36
  350. package/src/perspectives/LinkQuery.ts +0 -15
  351. package/src/perspectives/Perspective.ts +1 -12
  352. package/src/perspectives/PerspectiveClient.test.ts +262 -0
  353. package/src/perspectives/PerspectiveClient.ts +254 -468
  354. package/src/perspectives/PerspectiveDiff.ts +0 -8
  355. package/src/perspectives/PerspectiveHandle.ts +1 -12
  356. package/src/perspectives/PerspectiveProxy.test.ts +125 -0
  357. package/src/perspectives/PerspectiveProxy.ts +522 -434
  358. package/src/perspectives/WakerSubscriptionManager.ts +13 -13
  359. package/src/runtime/RuntimeClient.ts +166 -369
  360. package/src/runtime/RuntimeTypes.ts +144 -0
  361. package/src/shacl/SHACLFlow.ts +9 -9
  362. package/src/shacl/SHACLShape.test.ts +94 -0
  363. package/src/shacl/SHACLShape.ts +66 -39
  364. package/src/typeDefs.ts +3 -5
  365. package/src/utils.ts +6 -6
  366. package/tsconfig.json +3 -7
  367. package/lib/src/model/query-surreal.d.ts +0 -44
  368. package/lib/src/model/query-surreal.js +0 -249
  369. package/lib/src/model/surreal-utils.js +0 -128
  370. package/shims/reflect-metadata.ts +0 -0
  371. package/shims/type-graphql.ts +0 -75
  372. package/src/PubSub.ts +0 -17
  373. package/src/agent/AgentResolver.ts +0 -263
  374. package/src/ai/AIResolver.ts +0 -372
  375. package/src/buildSchema.ts +0 -43
  376. package/src/expression/ExpressionResolver.ts +0 -64
  377. package/src/language/LanguageContext.ts +0 -37
  378. package/src/language/LanguageResolver.ts +0 -98
  379. package/src/model/Subject.ts +0 -159
  380. package/src/model/prolog-facts.ts +0 -145
  381. package/src/model/query-prolog.ts +0 -148
  382. package/src/model/query-surreal.ts +0 -280
  383. package/src/model/surreal-utils.ts +0 -147
  384. package/src/neighbourhood/NeighbourhoodResolver.ts +0 -100
  385. package/src/perspectives/PerspectiveResolver.ts +0 -372
  386. package/src/runtime/RuntimeResolver.ts +0 -617
  387. package/src/unwrapApolloResult.ts +0 -16
  388. package/tsconfig-browser.json +0 -82
@@ -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 } 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, queryJson, and shapeJson that the Rust executor expects.
304
+ * @internal
305
+ */
306
+ static prepareModelQueryParams(query?: Query, classNameOverride?: string | null): {
307
+ className: string;
308
+ queryJson: string;
309
+ shapeJson: 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,11 @@ 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>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query,
366
+ /** @deprecated Ignored — Prolog engine has been removed. */
367
+ _engine?: 'sparql' | 'prolog' | boolean): Promise<T[]>;
349
368
  /**
350
369
  * Finds the first instance matching the query, or `null` if none exists.
351
370
  *
@@ -353,7 +372,7 @@ export declare class Ad4mModel {
353
372
  *
354
373
  * @param perspective - The perspective to search in
355
374
  * @param query - Optional query parameters to filter results
356
- * @param useSurrealDB - Whether to use SurrealDB (default: true) or Prolog (legacy)
375
+ * @param _engine - **Deprecated.** Accepted for backward compatibility but ignored.
357
376
  * @returns The first matching instance, or `null`
358
377
  *
359
378
  * @example
@@ -366,13 +385,15 @@ export declare class Ad4mModel {
366
385
  * }
367
386
  * ```
368
387
  */
369
- static findOne<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query, useSurrealDB?: boolean): Promise<T | null>;
388
+ static findOne<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query,
389
+ /** @deprecated Ignored — Prolog engine has been removed. */
390
+ _engine?: 'sparql' | 'prolog' | boolean): Promise<T | null>;
370
391
  /**
371
392
  * Gets all instances with count of total matches without offset & limit applied.
372
393
  *
373
394
  * @param perspective - The perspective to search in
374
395
  * @param query - Optional query parameters to filter results
375
- * @param useSurrealDB - Whether to use SurrealDB (default: true, 10-100x faster) or Prolog (legacy)
396
+ * @param _engine - **Deprecated.** Accepted for backward compatibility but ignored.
376
397
  * @returns Object containing results array and total count
377
398
  *
378
399
  * @example
@@ -382,12 +403,11 @@ export declare class Ad4mModel {
382
403
  * limit: 10
383
404
  * });
384
405
  * console.log(`Showing 10 of ${totalCount} dessert recipes`);
385
- *
386
- * // Use Prolog explicitly (legacy)
387
- * const { results, totalCount } = await Recipe.findAllAndCount(perspective, {}, false);
388
406
  * ```
389
407
  */
390
- static findAllAndCount<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query, useSurrealDB?: boolean): Promise<ResultsWithTotalCount<T>>;
408
+ static findAllAndCount<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query,
409
+ /** @deprecated Ignored — Prolog engine has been removed. */
410
+ _engine?: 'sparql' | 'prolog' | boolean): Promise<ResultsWithTotalCount<T>>;
391
411
  /**
392
412
  * Helper function for pagination with explicit page size and number.
393
413
  *
@@ -395,7 +415,6 @@ export declare class Ad4mModel {
395
415
  * @param pageSize - Number of items per page
396
416
  * @param pageNumber - Which page to retrieve (1-based)
397
417
  * @param query - Optional additional query parameters
398
- * @param useSurrealDB - Whether to use SurrealDB (default: true, 10-100x faster) or Prolog (legacy)
399
418
  * @returns Paginated results with metadata
400
419
  *
401
420
  * @example
@@ -404,29 +423,25 @@ export declare class Ad4mModel {
404
423
  * where: { category: "Main Course" }
405
424
  * });
406
425
  * 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
426
  * ```
411
427
  */
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>;
428
+ static paginate<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, pageSize: number, pageNumber: number, query?: Query,
429
+ /** @deprecated Ignored — Prolog engine has been removed. */
430
+ _engine?: 'sparql' | 'prolog' | boolean): Promise<PaginationResult<T>>;
414
431
  /**
415
- * Generates a SurrealQL COUNT query for the model.
432
+ * Generates a SPARQL COUNT query for the model.
416
433
  *
417
434
  * @param perspective - The perspective context
418
435
  * @param query - Query parameters to filter the count
419
- * @returns SurrealQL COUNT query string
436
+ * @returns SPARQL COUNT query string
420
437
  *
421
438
  * @private
422
439
  */
423
- static countQueryToSurrealQL(perspective: PerspectiveProxy, query: Query): Promise<string>;
424
440
  /**
425
441
  * Gets a count of all matching instances.
426
442
  *
427
443
  * @param perspective - The perspective to search in
428
444
  * @param query - Optional query parameters to filter results
429
- * @param useSurrealDB - Whether to use SurrealDB (default: true, 10-100x faster) or Prolog (legacy)
430
445
  * @returns Total count of matching entities
431
446
  *
432
447
  * @example
@@ -435,12 +450,9 @@ export declare class Ad4mModel {
435
450
  * const activeRecipes = await Recipe.count(perspective, {
436
451
  * where: { status: "active" }
437
452
  * });
438
- *
439
- * // Use Prolog explicitly (legacy)
440
- * const countProlog = await Recipe.count(perspective, {}, false);
441
453
  * ```
442
454
  */
443
- static count(perspective: PerspectiveProxy, query?: Query, useSurrealDB?: boolean): any;
455
+ static count(perspective: PerspectiveProxy, query?: Query): Promise<number>;
444
456
  private setProperty;
445
457
  /** Resolve a relation argument to a plain string ID. Accepts either a raw
446
458
  * string ID or an Ad4mModel instance (in which case `.id` is used). */
@@ -477,6 +489,30 @@ export declare class Ad4mModel {
477
489
  save(batchId?: string): Promise<void>;
478
490
  private cleanCopy;
479
491
  private innerUpdate;
492
+ /**
493
+ * Evaluate SPARQL getters for a batch of instances on demand.
494
+ *
495
+ * Since deepQuery defaults to true, property getters are evaluated
496
+ * automatically during collection queries. Use this method when
497
+ * deepQuery was explicitly set to false and you want to lazily
498
+ * resolve getter-backed properties for a subset of instances.
499
+ *
500
+ * @param instances - Array of model instances to evaluate getters on
501
+ * @param perspective - The perspective to query against
502
+ * @param propertyNames - Optional list of getter-backed property names to evaluate.
503
+ * If omitted, all getters are evaluated.
504
+ *
505
+ * @example
506
+ * ```typescript
507
+ * const messages = await Message.query(perspective).deepQuery(false).limit(30).get();
508
+ * // messages[i].replyingTo is undefined (getter skipped)
509
+ *
510
+ * // Evaluate getters for the visible subset
511
+ * await Message.evaluateGetters(messages.slice(0, 10), perspective, ['replyingTo']);
512
+ * // messages[0..9].replyingTo is now populated
513
+ * ```
514
+ */
515
+ static evaluateGetters<T extends Ad4mModel>(instances: T[], perspective: PerspectiveProxy, propertyNames?: string[]): Promise<void>;
480
516
  /**
481
517
  * Gets the model instance with all properties and relations populated.
482
518
  *
@@ -618,6 +654,20 @@ export declare class Ad4mModel {
618
654
  * ```
619
655
  */
620
656
  static register(this: typeof Ad4mModel, perspective: PerspectiveProxy): Promise<void>;
657
+ /**
658
+ * Batch-registers multiple model classes on a perspective in a single RPC call.
659
+ * This is significantly faster than calling `register()` on each model individually
660
+ * because it eliminates N-1 round-trips and mutex acquisitions.
661
+ *
662
+ * @param perspective - The perspective to register the models on
663
+ * @param models - Array of Ad4mModel subclasses to register
664
+ *
665
+ * @example
666
+ * ```typescript
667
+ * await Ad4mModel.registerAll(perspective, [Community, Channel, Message, Task]);
668
+ * ```
669
+ */
670
+ static registerAll(perspective: PerspectiveProxy, models: (typeof Ad4mModel)[]): Promise<void>;
621
671
  /**
622
672
  * Executes a set of model operations inside a single batch (transaction).
623
673
  *
@@ -724,4 +774,42 @@ export declare class Ad4mModel {
724
774
  * @throws Error when namespace cannot be inferred
725
775
  */
726
776
  static fromJSONSchema(schema: JSONSchema, options: JSONSchemaToModelOptions): typeof Ad4mModel;
777
+ /**
778
+ * Creates a fully functional Ad4mModel subclass from a SHACL shape.
779
+ *
780
+ * Unlike `fromJSONSchema()`, no predicate inference is required —
781
+ * `SHACLShape` already contains the exact predicate URI in `path` for
782
+ * every property. The method reads each property's `path`, `maxCount`,
783
+ * `writable`, and `resolveLanguage` directly and writes them to the
784
+ * WeakMap metadata registries.
785
+ *
786
+ * Properties with `hasValue` (flag / type-discrimination markers) are
787
+ * registered as hidden flag entries so that the SPARQL query builder emits
788
+ * the fixed triple `?source <predicate> <value>` needed for type discrimination.
789
+ * Properties without a `name` field are skipped.
790
+ *
791
+ * **Backward-compat:** Old Flux SHACL shapes (created before `sh:hasValue`
792
+ * was persisted on property shapes) carry the flag value only in
793
+ * `shape.constructor_actions` as the `target` of an `addLink` action.
794
+ * This method recovers those values so that old perspectives are queried
795
+ * with the correct type-discriminator triple.
796
+ *
797
+ * @param shape - SHACL node shape (as returned by `PerspectiveProxy.getAllShacl()`)
798
+ * @param name - Class name to assign (e.g. "Channel")
799
+ * @returns Generated Ad4mModel subclass, ready for querying
800
+ */
801
+ /**
802
+ * Synthesise an `Ad4mModel` subclass from a SHACL shape.
803
+ *
804
+ * @param shape - The SHACL shape to synthesise from.
805
+ * @param name - The model name (e.g. "Channel").
806
+ * @param classResolver - Optional thunk factory. When provided, any collection
807
+ * property that carries a `sh:class` URI will have its `target` wired up lazily:
808
+ * `target: () => classResolver(localName)`. Because `target` is only called at
809
+ * query time (inside `enrichShapeForIncludes` / `jsonToModelInstance`), the
810
+ * resolver just needs to return the correct class by the time a query runs —
811
+ * making it safe to pass a closure over a registry object that is still being
812
+ * populated (e.g. the `result` record inside `getModelClasses`).
813
+ */
814
+ static fromSHACL(shape: SHACLShape, name: string, classResolver?: (localName: string) => typeof Ad4mModel | undefined): typeof Ad4mModel;
727
815
  }