@coasys/ad4m 0.12.1-dev → 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 +5097 -11841
  4. package/lib/index.js +5289 -12104
  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 +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 +8 -6
  226. package/lib/src/runtime/RuntimeClient.js +97 -454
  227. package/lib/src/runtime/RuntimeResolver.d.ts +14 -0
  228. package/lib/src/runtime/RuntimeResolver.js +84 -0
  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 +14 -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 -615
  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 -467
  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 +118 -461
  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 -691
  387. package/src/unwrapApolloResult.ts +0 -16
  388. package/tsconfig-browser.json +0 -82
@@ -28,7 +28,6 @@ export class ModelQueryBuilder {
28
28
  constructor(perspective, ctor, query) {
29
29
  this.queryParams = {};
30
30
  this.modelClassName = null;
31
- this.useSurrealDBFlag = true;
32
31
  this.perspective = perspective;
33
32
  this.ctor = ctor;
34
33
  if (query)
@@ -39,7 +38,7 @@ export class ModelQueryBuilder {
39
38
  *
40
39
  * This method:
41
40
  * 1. Stops the keepalive signals to the subscription
42
- * 2. Unsubscribes from GraphQL subscription updates
41
+ * 2. Unsubscribes from subscription updates
43
42
  * 3. Notifies the backend to clean up subscription resources
44
43
  * 4. Clears the subscription reference
45
44
  *
@@ -201,6 +200,28 @@ export class ModelQueryBuilder {
201
200
  this.queryParams.properties = properties;
202
201
  return this;
203
202
  }
203
+ /**
204
+ * Controls whether SPARQL property getters are evaluated during hydration.
205
+ *
206
+ * By default, collection queries evaluate property getters (deepQuery=true).
207
+ * Call `.deepQuery(false)` to skip getter evaluation for performance.
208
+ *
209
+ * @param enabled - Whether to evaluate property getters (default: true)
210
+ * @returns The query builder for chaining
211
+ *
212
+ * @example
213
+ * ```typescript
214
+ * const messages = await Message.query(perspective)
215
+ * .parent(channel)
216
+ * .deepQuery(false) // skip property getters for performance
217
+ * .limit(30)
218
+ * .get();
219
+ * ```
220
+ */
221
+ deepQuery(enabled = true) {
222
+ this.queryParams.deepQuery = enabled;
223
+ return this;
224
+ }
204
225
  /**
205
226
  * Specifies which relations to eager-load (hydrate into model instances).
206
227
  *
@@ -236,32 +257,10 @@ export class ModelQueryBuilder {
236
257
  return this;
237
258
  }
238
259
  /**
239
- * Enables or disables SurrealDB query path.
240
- *
241
- * @param enabled - Whether to use SurrealDB (default: true, 10-100x faster) or Prolog (legacy)
242
- * @returns The query builder for chaining
243
- *
244
- * @example
245
- * ```typescript
246
- * // Use SurrealDB (default)
247
- * const recipes = await Recipe.query(perspective)
248
- * .where({ category: "Dessert" })
249
- * .useSurrealDB(true)
250
- * .get();
251
- *
252
- * // Use Prolog (legacy)
253
- * const recipesProlog = await Recipe.query(perspective)
254
- * .where({ category: "Dessert" })
255
- * .useSurrealDB(false)
256
- * .get();
257
- * ```
258
- *
259
- * @remarks
260
- * Note: Subscriptions (subscribe(), countSubscribe(), paginateSubscribe()) default to SurrealDB live queries
261
- * if useSurrealDB(true) is set (default).
260
+ * Sets the query engine to use.
261
+ * @deprecated Prolog engine has been removed. All queries use SPARQL/Rust.
262
262
  */
263
- useSurrealDB(enabled = true) {
264
- this.useSurrealDBFlag = enabled;
263
+ engine(_eng) {
265
264
  return this;
266
265
  }
267
266
  /**
@@ -277,17 +276,19 @@ export class ModelQueryBuilder {
277
276
  * ```
278
277
  */
279
278
  async get() {
280
- let results;
281
- if (this.useSurrealDBFlag) {
282
- const surrealQuery = await this.ctor.queryToSurrealQL(this.perspective, this.queryParams);
283
- const result = await this.perspective.querySurrealDB(surrealQuery);
284
- ({ results } = await this.ctor.instancesFromSurrealResult(this.perspective, this.queryParams, result));
285
- }
286
- else {
287
- const query = await this.ctor.queryToProlog(this.perspective, this.queryParams, this.modelClassName);
288
- const result = await this.perspective.infer(query);
289
- ({ results } = await this.ctor.instancesFromPrologResult(this.perspective, this.queryParams, result));
290
- }
279
+ return await this.executeSparqlQuery();
280
+ }
281
+ /**
282
+ * Executes the query once using SPARQL and returns the results.
283
+ */
284
+ async getSparql() {
285
+ return this.executeSparqlQuery();
286
+ }
287
+ /**
288
+ * Shared query execution logic — routes through the executor-side modelQuery endpoint.
289
+ */
290
+ async executeSparqlQuery() {
291
+ const { results } = await this.ctor.executeModelQuery(this.perspective, this.queryParams, this.modelClassName);
291
292
  return results;
292
293
  }
293
294
  /**
@@ -305,15 +306,17 @@ export class ModelQueryBuilder {
305
306
  * ```
306
307
  */
307
308
  async first() {
309
+ const savedLimit = this.queryParams.limit;
308
310
  this.queryParams.limit = 1;
309
311
  const results = await this.get();
312
+ this.queryParams.limit = savedLimit;
310
313
  return results[0] ?? null;
311
314
  }
312
315
  /**
313
316
  * Subscribes to the query and receives updates when results change.
314
317
  *
315
318
  * This method:
316
- * 1. Creates and initializes a SurrealDB live query subscription (default)
319
+ * 1. Creates and initializes a SPARQL live query subscription (default)
317
320
  * 2. Sets up the callback to process future updates
318
321
  * 3. Returns the initial results immediately
319
322
  *
@@ -336,41 +339,119 @@ export class ModelQueryBuilder {
336
339
  * builder.dispose();
337
340
  * ```
338
341
  *
339
- * @remarks
340
- * By default, this uses SurrealDB live queries for real-time updates.
341
- * Prolog subscriptions remain available via `.useSurrealDB(false)`.
342
342
  */
343
343
  async subscribe(callback) {
344
344
  // Clean up any existing subscription
345
345
  this.dispose();
346
346
  const ctor = this.ctor;
347
- if (this.useSurrealDBFlag) {
348
- const surrealQuery = await ctor.queryToSurrealQL(this.perspective, this.queryParams);
349
- this.currentSubscription = await this.perspective.subscribeSurrealDB(surrealQuery);
350
- const processResults = async (result) => {
351
- const { results } = await ctor.instancesFromSurrealResult(this.perspective, this.queryParams, result);
352
- callback(results);
353
- };
354
- this.currentSubscription.onResult(processResults);
355
- // Process initial result
356
- const { results } = await ctor.instancesFromSurrealResult(this.perspective, this.queryParams, this.currentSubscription.result);
357
- // Also invoke callback with initial results so subscribers see them
358
- callback(results);
359
- return results;
360
- }
361
- else {
362
- const query = await ctor.queryToProlog(this.perspective, this.queryParams, this.modelClassName);
363
- this.currentSubscription = await this.perspective.subscribeInfer(query);
364
- const processResults = async (result) => {
365
- const { results } = await ctor.instancesFromPrologResult(this.perspective, this.queryParams, result);
366
- callback(results);
367
- };
368
- this.currentSubscription.onResult(processResults);
369
- const { results } = await ctor.instancesFromPrologResult(this.perspective, this.queryParams, this.currentSubscription.result);
370
- // Also invoke callback with initial results so subscribers see them
371
- callback(results);
372
- return results;
347
+ // Build the model query params (className, queryJson, shapeJson)
348
+ const { className, queryJson, shapeJson } = ctor.prepareModelQueryParams(this.queryParams, this.modelClassName);
349
+ // Register model subscription via Rust — this builds trigger SPARQL internally,
350
+ // registers the subscription, and runs the initial query in one call.
351
+ const { subscriptionId, result: initialModelResult } = await this.perspective.modelSubscribe(className, queryJson, shapeJson);
352
+ // Convert JSON instances to model class instances
353
+ const parseResults = (raw) => {
354
+ return ctor.parseModelResult(this.perspective, raw, this.queryParams.include, this.queryParams.properties);
355
+ };
356
+ // Resolve non-literal (file-language) properties — handles both raw URI strings
357
+ // and already-resolved FileData objects returned by the Rust executor.
358
+ const resolveAndReturn = async (instances) => {
359
+ await ctor.resolveNonLiteralProps(this.perspective, instances);
360
+ return instances;
361
+ };
362
+ // Parse initial results (with non-literal resolution)
363
+ const initialResults = await resolveAndReturn(parseResults(initialModelResult));
364
+ // Track last emitted result fingerprint to suppress duplicate callbacks
365
+ let lastResultFingerprint = null;
366
+ const buildFingerprint = (results) => {
367
+ if (results.length === 0)
368
+ return '0:';
369
+ return JSON.stringify(results, (_, v) => typeof v === 'function' ? undefined : v);
370
+ };
371
+ lastResultFingerprint = buildFingerprint(initialResults);
372
+ // Listen for subscription updates via the same GraphQL subscription channel.
373
+ // When Rust re-runs the model query and finds changed results, it pushes them.
374
+ const unsubscribe = this.perspective.client.subscribeToQueryUpdates(subscriptionId, (rawResult) => {
375
+ try {
376
+ const parsed = parseResults(rawResult);
377
+ console.debug(`[ModelQueryBuilder.subscribe] Update received for ${subscriptionId}: ${parsed.length} instances`);
378
+ resolveAndReturn(parsed).then((results) => {
379
+ const fp = buildFingerprint(results);
380
+ if (fp === lastResultFingerprint) {
381
+ console.debug(`[ModelQueryBuilder.subscribe] Fingerprint unchanged, skipping callback`);
382
+ return;
383
+ }
384
+ console.debug(`[ModelQueryBuilder.subscribe] Fingerprint changed, calling callback with ${results.length} results`);
385
+ lastResultFingerprint = fp;
386
+ callback(results);
387
+ }).catch((e) => {
388
+ console.error('Model subscription update resolve error:', e);
389
+ });
390
+ }
391
+ catch (e) {
392
+ console.error('Model subscription update parse error:', e);
393
+ }
394
+ });
395
+ // Set up keepalive with recovery — uses setTimeout loop so we can
396
+ // break out and resubscribe when the server evicts the subscription.
397
+ let disposed = false;
398
+ let keepaliveTimer;
399
+ let resubscribeAttempts = 0;
400
+ const MAX_RESUBSCRIBE_ATTEMPTS = 5;
401
+ const keepaliveLoop = async () => {
402
+ if (disposed)
403
+ return;
404
+ try {
405
+ await this.perspective.client.keepAliveQuery(this.perspective.uuid, subscriptionId);
406
+ resubscribeAttempts = 0; // Reset on success
407
+ }
408
+ catch (e) {
409
+ console.warn(`Model subscription keepalive failed for ${subscriptionId}:`, e);
410
+ if (!disposed && resubscribeAttempts < MAX_RESUBSCRIBE_ATTEMPTS) {
411
+ resubscribeAttempts++;
412
+ const backoffMs = Math.min(1000 * Math.pow(2, resubscribeAttempts), 60000);
413
+ console.warn(`Resubscribing (attempt ${resubscribeAttempts}/${MAX_RESUBSCRIBE_ATTEMPTS}, backoff ${backoffMs}ms)...`);
414
+ await new Promise(r => setTimeout(r, backoffMs));
415
+ try {
416
+ unsubscribe();
417
+ await this.subscribe(callback);
418
+ }
419
+ catch (resubErr) {
420
+ console.error('Model subscription resubscribe failed:', resubErr);
421
+ }
422
+ }
423
+ else if (resubscribeAttempts >= MAX_RESUBSCRIBE_ATTEMPTS) {
424
+ console.error(`Model subscription ${subscriptionId}: max resubscribe attempts reached, giving up.`);
425
+ }
426
+ return; // new subscription owns its own keepalive loop
427
+ }
428
+ if (!disposed) {
429
+ keepaliveTimer = setTimeout(keepaliveLoop, 30000);
430
+ }
431
+ };
432
+ keepaliveTimer = setTimeout(keepaliveLoop, 30000);
433
+ // Store dispose function
434
+ this.currentSubscription = {
435
+ dispose: () => {
436
+ disposed = true;
437
+ if (keepaliveTimer)
438
+ clearTimeout(keepaliveTimer);
439
+ unsubscribe();
440
+ this.perspective.client.disposeQuerySubscription(this.perspective.uuid, subscriptionId).catch(() => { });
441
+ },
442
+ };
443
+ // Take snapshots for dirty tracking
444
+ for (const inst of initialResults) {
445
+ inst.takeSnapshot?.(this.queryParams.include);
373
446
  }
447
+ return initialResults;
448
+ }
449
+ /**
450
+ * Subscribes to the query and receives updates using SPARQL.
451
+ * @deprecated Use subscribe() instead — now routes through Rust model subscription.
452
+ */
453
+ async subscribeSparql(callback) {
454
+ return this.subscribe(callback);
374
455
  }
375
456
  /**
376
457
  * Gets the total count of matching entities.
@@ -385,26 +466,21 @@ export class ModelQueryBuilder {
385
466
  * ```
386
467
  */
387
468
  async count() {
388
- if (this.useSurrealDBFlag) {
389
- const surrealQuery = await this.ctor.queryToSurrealQL(this.perspective, this.queryParams);
390
- const result = await this.perspective.querySurrealDB(surrealQuery);
391
- // Use instancesFromSurrealResult to apply JS-level filtering for advanced where conditions
392
- // (e.g., gt, gte, lt, lte, between, contains on properties and author/timestamp)
393
- // This ensures count() returns the same number as get().length
394
- const { totalCount } = await this.ctor.instancesFromSurrealResult(this.perspective, this.queryParams, result);
395
- return totalCount;
396
- }
397
- else {
398
- const query = await this.ctor.countQueryToProlog(this.perspective, this.queryParams, this.modelClassName);
399
- const result = await this.perspective.infer(query);
400
- return result?.[0]?.TotalCount || 0;
401
- }
469
+ const { totalCount } = await this.ctor.executeModelQuery(this.perspective, { ...this.queryParams, limit: 0 }, this.modelClassName);
470
+ return totalCount;
471
+ }
472
+ /**
473
+ * Gets the total count of matching entities using SPARQL.
474
+ * Delegates to count().
475
+ */
476
+ async countSparql() {
477
+ return await this.count();
402
478
  }
403
479
  /**
404
480
  * Subscribes to count updates for matching entities.
405
481
  *
406
482
  * This method:
407
- * 1. Creates and initializes a SurrealDB live query subscription for the count (default)
483
+ * 1. Creates and initializes a SPARQL live query subscription for the count (default)
408
484
  * 2. Sets up the callback to process future count updates
409
485
  * 3. Returns the initial count immediately
410
486
  *
@@ -427,37 +503,79 @@ export class ModelQueryBuilder {
427
503
  * builder.dispose();
428
504
  * ```
429
505
  *
430
- * @remarks
431
- * By default, this uses SurrealDB live queries for real-time updates.
432
- * Prolog subscriptions remain available via `.useSurrealDB(false)`.
433
506
  */
434
507
  async countSubscribe(callback) {
435
508
  // Clean up any existing subscription
436
509
  this.dispose();
437
- if (this.useSurrealDBFlag) {
438
- const surrealQuery = await this.ctor.queryToSurrealQL(this.perspective, this.queryParams);
439
- this.currentSubscription = await this.perspective.subscribeSurrealDB(surrealQuery);
440
- const processResults = async (result) => {
441
- const { totalCount } = await this.ctor.instancesFromSurrealResult(this.perspective, this.queryParams, result);
442
- callback(totalCount);
443
- };
444
- this.currentSubscription.onResult(processResults);
445
- const { totalCount } = await this.ctor.instancesFromSurrealResult(this.perspective, this.queryParams, this.currentSubscription.result);
446
- callback(totalCount);
447
- return totalCount;
448
- }
449
- else {
450
- const query = await this.ctor.countQueryToProlog(this.perspective, this.queryParams, this.modelClassName);
451
- this.currentSubscription = await this.perspective.subscribeInfer(query);
452
- const processResults = async (result) => {
453
- const newCount = result?.[0]?.TotalCount || 0;
454
- callback(newCount);
455
- };
456
- this.currentSubscription.onResult(processResults);
457
- const initialCount = this.currentSubscription.result?.[0]?.TotalCount || 0;
458
- callback(initialCount);
459
- return initialCount;
460
- }
510
+ const countParams = { ...this.queryParams, limit: 0 };
511
+ const { className, queryJson, shapeJson } = this.ctor.prepareModelQueryParams(countParams, this.modelClassName);
512
+ const { subscriptionId, result: initialModelResult } = await this.perspective.modelSubscribe(className, queryJson, shapeJson);
513
+ const parseCount = (raw) => {
514
+ const data = typeof raw === 'string' ? JSON.parse(raw) : raw;
515
+ return data.totalCount ?? 0;
516
+ };
517
+ const initialCount = parseCount(initialModelResult);
518
+ const unsubscribe = this.perspective.client.subscribeToQueryUpdates(subscriptionId, (rawResult) => {
519
+ try {
520
+ callback(parseCount(rawResult));
521
+ }
522
+ catch (e) {
523
+ console.error('Count subscription update parse error:', e);
524
+ }
525
+ });
526
+ let disposed = false;
527
+ let keepaliveTimer;
528
+ let resubscribeAttempts = 0;
529
+ const MAX_RESUBSCRIBE_ATTEMPTS = 5;
530
+ const keepaliveLoop = async () => {
531
+ if (disposed)
532
+ return;
533
+ try {
534
+ await this.perspective.client.keepAliveQuery(this.perspective.uuid, subscriptionId);
535
+ resubscribeAttempts = 0;
536
+ }
537
+ catch (e) {
538
+ console.warn(`Count subscription keepalive failed for ${subscriptionId}:`, e);
539
+ if (!disposed && resubscribeAttempts < MAX_RESUBSCRIBE_ATTEMPTS) {
540
+ resubscribeAttempts++;
541
+ const backoffMs = Math.min(1000 * Math.pow(2, resubscribeAttempts), 60000);
542
+ console.warn(`Count resubscribing (attempt ${resubscribeAttempts}/${MAX_RESUBSCRIBE_ATTEMPTS}, backoff ${backoffMs}ms)...`);
543
+ await new Promise(r => setTimeout(r, backoffMs));
544
+ try {
545
+ unsubscribe();
546
+ await this.countSubscribe(callback);
547
+ }
548
+ catch (resubErr) {
549
+ console.error('Count subscription resubscribe failed:', resubErr);
550
+ }
551
+ }
552
+ else if (resubscribeAttempts >= MAX_RESUBSCRIBE_ATTEMPTS) {
553
+ console.error(`Count subscription ${subscriptionId}: max resubscribe attempts reached, giving up.`);
554
+ }
555
+ return;
556
+ }
557
+ if (!disposed) {
558
+ keepaliveTimer = setTimeout(keepaliveLoop, 30000);
559
+ }
560
+ };
561
+ keepaliveTimer = setTimeout(keepaliveLoop, 30000);
562
+ this.currentSubscription = {
563
+ dispose: () => {
564
+ disposed = true;
565
+ if (keepaliveTimer)
566
+ clearTimeout(keepaliveTimer);
567
+ unsubscribe();
568
+ this.perspective.client.disposeQuerySubscription(this.perspective.uuid, subscriptionId).catch(() => { });
569
+ },
570
+ };
571
+ return initialCount;
572
+ }
573
+ /**
574
+ * Subscribes to count updates using SPARQL.
575
+ * @deprecated Use countSubscribe() instead — now routes through Rust model subscription.
576
+ */
577
+ async countSubscribeSparql(callback) {
578
+ return this.countSubscribe(callback);
461
579
  }
462
580
  /**
463
581
  * Gets a page of results with pagination metadata.
@@ -476,24 +594,21 @@ export class ModelQueryBuilder {
476
594
  */
477
595
  async paginate(pageSize, pageNumber) {
478
596
  const paginationQuery = { ...(this.queryParams || {}), limit: pageSize, offset: pageSize * (pageNumber - 1), count: true };
479
- if (this.useSurrealDBFlag) {
480
- const surrealQuery = await this.ctor.queryToSurrealQL(this.perspective, paginationQuery);
481
- const result = await this.perspective.querySurrealDB(surrealQuery);
482
- const { results, totalCount } = (await this.ctor.instancesFromSurrealResult(this.perspective, paginationQuery, result));
483
- return { results, totalCount, pageSize, pageNumber };
484
- }
485
- else {
486
- const prologQuery = await this.ctor.queryToProlog(this.perspective, paginationQuery, this.modelClassName);
487
- const result = await this.perspective.infer(prologQuery);
488
- const { results, totalCount } = (await this.ctor.instancesFromPrologResult(this.perspective, paginationQuery, result));
489
- return { results, totalCount, pageSize, pageNumber };
490
- }
597
+ const { results, totalCount } = await this.ctor.executeModelQuery(this.perspective, paginationQuery, this.modelClassName);
598
+ return { results, totalCount, pageSize, pageNumber };
599
+ }
600
+ /**
601
+ * Gets a page of results using SPARQL.
602
+ * Delegates to paginate().
603
+ */
604
+ async paginateSparql(pageSize, pageNumber) {
605
+ return await this.paginate(pageSize, pageNumber);
491
606
  }
492
607
  /**
493
608
  * Subscribes to paginated results updates.
494
609
  *
495
610
  * This method:
496
- * 1. Creates and initializes a SurrealDB live query subscription for the paginated results (default)
611
+ * 1. Creates and initializes a SPARQL live query subscription for the paginated results (default)
497
612
  * 2. Sets up the callback to process future page updates
498
613
  * 3. Returns the initial page immediately
499
614
  *
@@ -518,39 +633,88 @@ export class ModelQueryBuilder {
518
633
  * builder.dispose();
519
634
  * ```
520
635
  *
521
- * @remarks
522
- * By default, this uses SurrealDB live queries for real-time updates.
523
- * Prolog subscriptions remain available via `.useSurrealDB(false)`.
524
636
  */
525
637
  async paginateSubscribe(pageSize, pageNumber, callback) {
526
638
  // Clean up any existing subscription
527
639
  this.dispose();
528
- const paginationQuery = { ...(this.queryParams || {}), limit: pageSize, offset: pageSize * (pageNumber - 1), count: true };
529
- if (this.useSurrealDBFlag) {
530
- const surrealQuery = await this.ctor.queryToSurrealQL(this.perspective, paginationQuery);
531
- this.currentSubscription = await this.perspective.subscribeSurrealDB(surrealQuery);
532
- const processResults = async (result) => {
533
- const { results, totalCount } = (await this.ctor.instancesFromSurrealResult(this.perspective, paginationQuery, result));
534
- callback({ results, totalCount, pageSize, pageNumber });
535
- };
536
- this.currentSubscription.onResult(processResults);
537
- const { results, totalCount } = (await this.ctor.instancesFromSurrealResult(this.perspective, paginationQuery, this.currentSubscription.result));
538
- const initialPage = { results, totalCount, pageSize, pageNumber };
539
- callback(initialPage);
540
- return initialPage;
541
- }
542
- else {
543
- const prologQuery = await this.ctor.queryToProlog(this.perspective, paginationQuery, this.modelClassName);
544
- this.currentSubscription = await this.perspective.subscribeInfer(prologQuery);
545
- const processResults = async (r) => {
546
- const { results, totalCount } = (await this.ctor.instancesFromPrologResult(this.perspective, this.queryParams, r));
547
- callback({ results, totalCount, pageSize, pageNumber });
548
- };
549
- this.currentSubscription.onResult(processResults);
550
- const { results, totalCount } = (await this.ctor.instancesFromPrologResult(this.perspective, paginationQuery, this.currentSubscription.result));
551
- const initialPrologPage = { results, totalCount, pageSize, pageNumber };
552
- callback(initialPrologPage);
553
- return initialPrologPage;
554
- }
640
+ const ctor = this.ctor;
641
+ // Subscribe to the full result set (no limit/offset) so the subscription
642
+ // detects changes anywhere in the dataset. Rust builds trigger SPARQL
643
+ // from the shape predicates.
644
+ const subscriptionParams = { ...(this.queryParams || {}) };
645
+ delete subscriptionParams.limit;
646
+ delete subscriptionParams.offset;
647
+ const { className, queryJson, shapeJson } = ctor.prepareModelQueryParams(subscriptionParams, this.modelClassName);
648
+ const { subscriptionId } = await this.perspective.modelSubscribe(className, queryJson, shapeJson);
649
+ // Build the paginated query for Rust endpoint (count: true fetches both results and totalCount in one call)
650
+ const paginatedQuery = {
651
+ ...(this.queryParams || {}),
652
+ limit: pageSize,
653
+ offset: pageSize * (pageNumber - 1),
654
+ count: true,
655
+ };
656
+ const processResults = async () => {
657
+ const { results, totalCount } = await ctor.executeModelQuery(this.perspective, paginatedQuery, this.modelClassName);
658
+ callback({ results, totalCount, pageSize, pageNumber });
659
+ };
660
+ const unsubscribe = this.perspective.client.subscribeToQueryUpdates(subscriptionId, (rawResult) => {
661
+ console.debug(`[ModelQueryBuilder.paginateSubscribe] Update received for ${subscriptionId}, re-fetching paginated data...`);
662
+ processResults().catch(e => console.error('Paginate subscription error:', e));
663
+ });
664
+ let disposed = false;
665
+ let keepaliveTimer;
666
+ let resubscribeAttempts = 0;
667
+ const MAX_RESUBSCRIBE_ATTEMPTS = 5;
668
+ const keepaliveLoop = async () => {
669
+ if (disposed)
670
+ return;
671
+ try {
672
+ await this.perspective.client.keepAliveQuery(this.perspective.uuid, subscriptionId);
673
+ resubscribeAttempts = 0;
674
+ }
675
+ catch (e) {
676
+ console.warn(`Paginate subscription keepalive failed for ${subscriptionId}:`, e);
677
+ if (!disposed && resubscribeAttempts < MAX_RESUBSCRIBE_ATTEMPTS) {
678
+ resubscribeAttempts++;
679
+ const backoffMs = Math.min(1000 * Math.pow(2, resubscribeAttempts), 60000);
680
+ console.warn(`Paginate resubscribing (attempt ${resubscribeAttempts}/${MAX_RESUBSCRIBE_ATTEMPTS}, backoff ${backoffMs}ms)...`);
681
+ await new Promise(r => setTimeout(r, backoffMs));
682
+ try {
683
+ unsubscribe();
684
+ await this.paginateSubscribe(pageSize, pageNumber, callback);
685
+ }
686
+ catch (resubErr) {
687
+ console.error('Paginate subscription resubscribe failed:', resubErr);
688
+ }
689
+ }
690
+ else if (resubscribeAttempts >= MAX_RESUBSCRIBE_ATTEMPTS) {
691
+ console.error(`Paginate subscription ${subscriptionId}: max resubscribe attempts reached, giving up.`);
692
+ }
693
+ return;
694
+ }
695
+ if (!disposed) {
696
+ keepaliveTimer = setTimeout(keepaliveLoop, 30000);
697
+ }
698
+ };
699
+ keepaliveTimer = setTimeout(keepaliveLoop, 30000);
700
+ this.currentSubscription = {
701
+ dispose: () => {
702
+ disposed = true;
703
+ if (keepaliveTimer)
704
+ clearTimeout(keepaliveTimer);
705
+ unsubscribe();
706
+ this.perspective.client.disposeQuerySubscription(this.perspective.uuid, subscriptionId).catch(() => { });
707
+ },
708
+ };
709
+ // Initial fetch (single call with count: true)
710
+ const { results, totalCount } = await ctor.executeModelQuery(this.perspective, paginatedQuery, this.modelClassName);
711
+ return { results, totalCount, pageSize, pageNumber };
712
+ }
713
+ /**
714
+ * Subscribes to paginated results updates using SPARQL.
715
+ * Delegates to paginateSubscribe().
716
+ */
717
+ async paginateSubscribeSparql(pageSize, pageNumber, callback) {
718
+ return await this.paginateSubscribe(pageSize, pageNumber, callback);
555
719
  }
556
720
  }
@@ -55,12 +55,12 @@ export class Subject {
55
55
  Object.defineProperty(this, p, {
56
56
  configurable: true,
57
57
  get: async () => {
58
- // Use SurrealDB for data queries
58
+ // Use SPARQL for data queries
59
59
  try {
60
- return await __classPrivateFieldGet(this, _Subject_perspective, "f").getPropertyValueViaSurreal(__classPrivateFieldGet(this, _Subject_baseExpression, "f"), __classPrivateFieldGet(this, _Subject_subjectClassName, "f"), p);
60
+ return await __classPrivateFieldGet(this, _Subject_perspective, "f").getPropertyValueViaSparql(__classPrivateFieldGet(this, _Subject_baseExpression, "f"), __classPrivateFieldGet(this, _Subject_subjectClassName, "f"), p);
61
61
  }
62
62
  catch (err) {
63
- console.warn(`Failed to get property ${p} via SurrealDB:`, err);
63
+ console.warn(`Failed to get property ${p} via SPARQL:`, err);
64
64
  return undefined;
65
65
  }
66
66
  }
@@ -94,12 +94,12 @@ export class Subject {
94
94
  Object.defineProperty(this, c, {
95
95
  configurable: true,
96
96
  get: async () => {
97
- // Use SurrealDB for data queries
97
+ // Use SPARQL for data queries
98
98
  try {
99
- return await __classPrivateFieldGet(this, _Subject_perspective, "f").getRelationValuesViaSurreal(__classPrivateFieldGet(this, _Subject_baseExpression, "f"), __classPrivateFieldGet(this, _Subject_subjectClassName, "f"), c);
99
+ return await __classPrivateFieldGet(this, _Subject_perspective, "f").getRelationValuesViaSparql(__classPrivateFieldGet(this, _Subject_baseExpression, "f"), __classPrivateFieldGet(this, _Subject_subjectClassName, "f"), c);
100
100
  }
101
101
  catch (err) {
102
- console.warn(`Failed to get relation ${c} via SurrealDB:`, err);
102
+ console.warn(`Failed to get relation ${c} via SPARQL:`, err);
103
103
  return [];
104
104
  }
105
105
  }