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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (393) hide show
  1. package/README.md +2 -25
  2. package/jest-setup.ts +1 -1
  3. package/lib/index.cjs +8677 -15318
  4. package/lib/index.js +14507 -21223
  5. package/lib/src/Ad4mClient.d.ts +9 -3
  6. package/lib/src/Ad4mClient.js +40 -13
  7. package/lib/src/Literal.js +6 -5
  8. package/lib/src/agent/Agent.js +26 -272
  9. package/lib/src/agent/AgentClient.d.ts +33 -21
  10. package/lib/src/agent/AgentClient.js +180 -374
  11. package/lib/src/agent/AgentStatus.js +2 -37
  12. package/lib/src/ai/AIClient.d.ts +12 -4
  13. package/lib/src/ai/AIClient.js +81 -285
  14. package/lib/src/ai/AITypes.d.ts +55 -0
  15. package/lib/src/ai/AITypes.js +18 -0
  16. package/lib/src/ai/Tasks.js +10 -133
  17. package/lib/src/apiClient.d.ts +53 -0
  18. package/lib/src/apiClient.js +234 -0
  19. package/lib/src/cache/PersistentCache.d.ts +40 -0
  20. package/lib/src/cache/PersistentCache.js +139 -0
  21. package/lib/src/expression/Expression.d.ts +1 -1
  22. package/lib/src/expression/Expression.js +13 -122
  23. package/lib/src/expression/ExpressionClient.d.ts +11 -3
  24. package/lib/src/expression/ExpressionClient.js +120 -75
  25. package/lib/src/expression/ExpressionRef.js +4 -27
  26. package/lib/src/generated/api/AIModelLoadingStatus.d.ts +7 -0
  27. package/lib/src/generated/api/AIModelLoadingStatus.js +2 -0
  28. package/lib/src/generated/api/AddLinkExpressionRequest.d.ts +6 -0
  29. package/lib/src/generated/api/AddLinkExpressionRequest.js +1 -0
  30. package/lib/src/generated/api/AddLinkRequest.d.ts +6 -0
  31. package/lib/src/generated/api/AddLinkRequest.js +1 -0
  32. package/lib/src/generated/api/AddLinksBulkRequest.d.ts +6 -0
  33. package/lib/src/generated/api/AddLinksBulkRequest.js +1 -0
  34. package/lib/src/generated/api/AddSdnaRequest.d.ts +6 -0
  35. package/lib/src/generated/api/AddSdnaRequest.js +2 -0
  36. package/lib/src/generated/api/ApplyTemplateRequest.d.ts +4 -0
  37. package/lib/src/generated/api/ApplyTemplateRequest.js +2 -0
  38. package/lib/src/generated/api/AuthInfoInput.d.ts +10 -0
  39. package/lib/src/generated/api/AuthInfoInput.js +1 -0
  40. package/lib/src/generated/api/CapabilityInput.d.ts +5 -0
  41. package/lib/src/generated/api/CapabilityInput.js +1 -0
  42. package/lib/src/generated/api/CommitBatchRequest.d.ts +3 -0
  43. package/lib/src/generated/api/CommitBatchRequest.js +2 -0
  44. package/lib/src/generated/api/ComputeLogEntry.d.ts +9 -0
  45. package/lib/src/generated/api/ComputeLogEntry.js +2 -0
  46. package/lib/src/generated/api/CreateExpressionRequest.d.ts +4 -0
  47. package/lib/src/generated/api/CreateExpressionRequest.js +2 -0
  48. package/lib/src/generated/api/CreatePerspectiveRequest.d.ts +3 -0
  49. package/lib/src/generated/api/CreatePerspectiveRequest.js +2 -0
  50. package/lib/src/generated/api/CreateSubjectRequest.d.ts +6 -0
  51. package/lib/src/generated/api/CreateSubjectRequest.js +2 -0
  52. package/lib/src/generated/api/EmbedRequest.d.ts +4 -0
  53. package/lib/src/generated/api/EmbedRequest.js +2 -0
  54. package/lib/src/generated/api/EntanglementProofInput.d.ts +6 -0
  55. package/lib/src/generated/api/EntanglementProofInput.js +2 -0
  56. package/lib/src/generated/api/ExecuteCommandsRequest.d.ts +4 -0
  57. package/lib/src/generated/api/ExecuteCommandsRequest.js +2 -0
  58. package/lib/src/generated/api/ExportRequest.d.ts +5 -0
  59. package/lib/src/generated/api/ExportRequest.js +2 -0
  60. package/lib/src/generated/api/ExpressionManyRequest.d.ts +3 -0
  61. package/lib/src/generated/api/ExpressionManyRequest.js +2 -0
  62. package/lib/src/generated/api/ExpressionProof.d.ts +4 -0
  63. package/lib/src/generated/api/ExpressionProof.js +2 -0
  64. package/lib/src/generated/api/ExpressionProofInput.d.ts +6 -0
  65. package/lib/src/generated/api/ExpressionProofInput.js +2 -0
  66. package/lib/src/generated/api/FriendSendMessageRequest.d.ts +3 -0
  67. package/lib/src/generated/api/FriendSendMessageRequest.js +2 -0
  68. package/lib/src/generated/api/FriendsListRequest.d.ts +3 -0
  69. package/lib/src/generated/api/FriendsListRequest.js +2 -0
  70. package/lib/src/generated/api/GenerateAgentRequest.d.ts +3 -0
  71. package/lib/src/generated/api/GenerateAgentRequest.js +2 -0
  72. package/lib/src/generated/api/GenerateJwtRequest.d.ts +4 -0
  73. package/lib/src/generated/api/GenerateJwtRequest.js +2 -0
  74. package/lib/src/generated/api/GetSubjectDataRequest.d.ts +4 -0
  75. package/lib/src/generated/api/GetSubjectDataRequest.js +2 -0
  76. package/lib/src/generated/api/ImportAgentRequest.d.ts +6 -0
  77. package/lib/src/generated/api/ImportAgentRequest.js +2 -0
  78. package/lib/src/generated/api/ImportRequest.d.ts +4 -0
  79. package/lib/src/generated/api/ImportRequest.js +2 -0
  80. package/lib/src/generated/api/JoinNeighbourhoodRequest.d.ts +3 -0
  81. package/lib/src/generated/api/JoinNeighbourhoodRequest.js +2 -0
  82. package/lib/src/generated/api/LanguageMetaInput.d.ts +6 -0
  83. package/lib/src/generated/api/LanguageMetaInput.js +2 -0
  84. package/lib/src/generated/api/Link.d.ts +5 -0
  85. package/lib/src/generated/api/Link.js +2 -0
  86. package/lib/src/generated/api/LinkExpression.d.ts +10 -0
  87. package/lib/src/generated/api/LinkExpression.js +1 -0
  88. package/lib/src/generated/api/LinkExpressionInput.d.ts +10 -0
  89. package/lib/src/generated/api/LinkExpressionInput.js +1 -0
  90. package/lib/src/generated/api/LinkInput.d.ts +5 -0
  91. package/lib/src/generated/api/LinkInput.js +2 -0
  92. package/lib/src/generated/api/LinkLanguageTemplatesRequest.d.ts +3 -0
  93. package/lib/src/generated/api/LinkLanguageTemplatesRequest.js +2 -0
  94. package/lib/src/generated/api/LinkMutations.d.ts +6 -0
  95. package/lib/src/generated/api/LinkMutations.js +1 -0
  96. package/lib/src/generated/api/LinkStatus.d.ts +1 -0
  97. package/lib/src/generated/api/LinkStatus.js +2 -0
  98. package/lib/src/generated/api/LockAgentRequest.d.ts +3 -0
  99. package/lib/src/generated/api/LockAgentRequest.js +2 -0
  100. package/lib/src/generated/api/ModelType.d.ts +1 -0
  101. package/lib/src/generated/api/ModelType.js +2 -0
  102. package/lib/src/generated/api/NotificationInput.d.ts +10 -0
  103. package/lib/src/generated/api/NotificationInput.js +2 -0
  104. package/lib/src/generated/api/OpenLinkRequest.d.ts +3 -0
  105. package/lib/src/generated/api/OpenLinkRequest.js +2 -0
  106. package/lib/src/generated/api/PermitCapabilityRequest.d.ts +3 -0
  107. package/lib/src/generated/api/PermitCapabilityRequest.js +2 -0
  108. package/lib/src/generated/api/PerspectiveInput.d.ts +4 -0
  109. package/lib/src/generated/api/PerspectiveInput.js +1 -0
  110. package/lib/src/generated/api/PromptRequest.d.ts +4 -0
  111. package/lib/src/generated/api/PromptRequest.js +2 -0
  112. package/lib/src/generated/api/PublishLanguageRequest.d.ts +5 -0
  113. package/lib/src/generated/api/PublishLanguageRequest.js +1 -0
  114. package/lib/src/generated/api/PublishNeighbourhoodRequest.d.ts +6 -0
  115. package/lib/src/generated/api/PublishNeighbourhoodRequest.js +1 -0
  116. package/lib/src/generated/api/QueryRequest.d.ts +7 -0
  117. package/lib/src/generated/api/QueryRequest.js +2 -0
  118. package/lib/src/generated/api/RemoveLinkRequest.d.ts +5 -0
  119. package/lib/src/generated/api/RemoveLinkRequest.js +1 -0
  120. package/lib/src/generated/api/RemoveLinksBulkRequest.d.ts +5 -0
  121. package/lib/src/generated/api/RemoveLinksBulkRequest.js +1 -0
  122. package/lib/src/generated/api/ResourceInput.d.ts +4 -0
  123. package/lib/src/generated/api/ResourceInput.js +2 -0
  124. package/lib/src/generated/api/SetDefaultModelRequest.d.ts +4 -0
  125. package/lib/src/generated/api/SetDefaultModelRequest.js +1 -0
  126. package/lib/src/generated/api/SetFreeHostingEnabledRequest.d.ts +3 -0
  127. package/lib/src/generated/api/SetFreeHostingEnabledRequest.js +2 -0
  128. package/lib/src/generated/api/SetMultiUserRequest.d.ts +3 -0
  129. package/lib/src/generated/api/SetMultiUserRequest.js +2 -0
  130. package/lib/src/generated/api/SetStatusRequest.d.ts +3 -0
  131. package/lib/src/generated/api/SetStatusRequest.js +2 -0
  132. package/lib/src/generated/api/SignMessageRequest.d.ts +3 -0
  133. package/lib/src/generated/api/SignMessageRequest.js +2 -0
  134. package/lib/src/generated/api/TrustedAgentsRequest.d.ts +3 -0
  135. package/lib/src/generated/api/TrustedAgentsRequest.js +2 -0
  136. package/lib/src/generated/api/UnlockAgentRequest.d.ts +4 -0
  137. package/lib/src/generated/api/UnlockAgentRequest.js +2 -0
  138. package/lib/src/generated/api/UpdateLinkRequest.d.ts +7 -0
  139. package/lib/src/generated/api/UpdateLinkRequest.js +1 -0
  140. package/lib/src/generated/api/UpdatePerspectiveRequest.d.ts +3 -0
  141. package/lib/src/generated/api/UpdatePerspectiveRequest.js +2 -0
  142. package/lib/src/generated/api/UserStatistics.d.ts +9 -0
  143. package/lib/src/generated/api/UserStatistics.js +2 -0
  144. package/lib/src/generated/api/VerificationRequestResult.d.ts +6 -0
  145. package/lib/src/generated/api/VerificationRequestResult.js +2 -0
  146. package/lib/src/generated/api/VerifySignatureRequest.d.ts +5 -0
  147. package/lib/src/generated/api/VerifySignatureRequest.js +2 -0
  148. package/lib/src/generated/api/WriteSettingsRequest.d.ts +3 -0
  149. package/lib/src/generated/api/WriteSettingsRequest.js +2 -0
  150. package/lib/src/generated/api/index.d.ts +42 -0
  151. package/lib/src/generated/api/index.js +7 -0
  152. package/lib/src/index.d.ts +8 -2
  153. package/lib/src/index.js +8 -2
  154. package/lib/src/jestSetup.d.ts +0 -1
  155. package/lib/src/jestSetup.js +1 -1
  156. package/lib/src/language/Icon.js +2 -21
  157. package/lib/src/language/Language.d.ts +26 -176
  158. package/lib/src/language/Language.js +32 -72
  159. package/lib/src/language/LanguageClient.d.ts +2 -2
  160. package/lib/src/language/LanguageClient.js +15 -105
  161. package/lib/src/language/LanguageHandle.js +2 -41
  162. package/lib/src/language/LanguageMeta.js +4 -75
  163. package/lib/src/language/LanguageRef.js +2 -25
  164. package/lib/src/links/Links.js +14 -111
  165. package/lib/src/model/Ad4mModel.d.ts +143 -63
  166. package/lib/src/model/Ad4mModel.js +583 -425
  167. package/lib/src/model/Ad4mModel.test.js +1434 -688
  168. package/lib/src/model/ModelQueryBuilder.d.ts +61 -45
  169. package/lib/src/model/ModelQueryBuilder.js +315 -157
  170. package/lib/src/model/Subject.js +6 -6
  171. package/lib/src/model/decorators.d.ts +36 -8
  172. package/lib/src/model/decorators.js +41 -14
  173. package/lib/src/model/hydration-batch.d.ts +34 -0
  174. package/lib/src/model/hydration-batch.js +147 -0
  175. package/lib/src/model/hydration-batching.test.d.ts +7 -0
  176. package/lib/src/model/hydration-batching.test.js +456 -0
  177. package/lib/src/model/hydration.d.ts +3 -92
  178. package/lib/src/model/hydration.js +3 -691
  179. package/lib/src/model/index.d.ts +3 -4
  180. package/lib/src/model/index.js +3 -4
  181. package/lib/src/model/json-schema.js +2 -2
  182. package/lib/src/model/model-manifest.d.ts +41 -0
  183. package/lib/src/model/model-manifest.js +11 -0
  184. package/lib/src/model/query-cache.d.ts +30 -0
  185. package/lib/src/model/query-cache.js +66 -0
  186. package/lib/src/model/query-cache.test.d.ts +1 -0
  187. package/lib/src/model/query-cache.test.js +43 -0
  188. package/lib/src/model/query-common.d.ts +1 -1
  189. package/lib/src/model/query-common.js +1 -1
  190. package/lib/src/model/query-sparql-batch.d.ts +17 -0
  191. package/lib/src/model/query-sparql-batch.js +260 -0
  192. package/lib/src/model/query-sparql.d.ts +51 -0
  193. package/lib/src/model/query-sparql.js +466 -0
  194. package/lib/src/model/query-sparql.test.d.ts +1 -0
  195. package/lib/src/model/query-sparql.test.js +312 -0
  196. package/lib/src/model/{surreal-utils.d.ts → query-utils.d.ts} +13 -9
  197. package/lib/src/model/query-utils.js +189 -0
  198. package/lib/src/model/relation-filtering.test.js +15 -15
  199. package/lib/src/model/sdna.js +1 -1
  200. package/lib/src/model/shacl-gen.js +154 -57
  201. package/lib/src/model/subscription-delta.test.d.ts +24 -0
  202. package/lib/src/model/subscription-delta.test.js +180 -0
  203. package/lib/src/model/subscription-pool.d.ts +39 -0
  204. package/lib/src/model/subscription-pool.js +165 -0
  205. package/lib/src/model/types.d.ts +195 -5
  206. package/lib/src/model/types.js +5 -2
  207. package/lib/src/neighbourhood/Neighbourhood.js +4 -32
  208. package/lib/src/neighbourhood/NeighbourhoodClient.d.ts +3 -3
  209. package/lib/src/neighbourhood/NeighbourhoodClient.js +40 -203
  210. package/lib/src/perspectives/LinkQuery.js +2 -42
  211. package/lib/src/perspectives/Perspective.d.ts +1 -1
  212. package/lib/src/perspectives/Perspective.js +10 -52
  213. package/lib/src/perspectives/PerspectiveClient.d.ts +22 -32
  214. package/lib/src/perspectives/PerspectiveClient.js +188 -454
  215. package/lib/src/perspectives/PerspectiveClient.test.d.ts +1 -0
  216. package/lib/src/perspectives/PerspectiveClient.test.js +224 -0
  217. package/lib/src/perspectives/PerspectiveDiff.js +4 -31
  218. package/lib/src/perspectives/PerspectiveHandle.js +3 -43
  219. package/lib/src/perspectives/PerspectiveProxy.d.ts +157 -78
  220. package/lib/src/perspectives/PerspectiveProxy.js +475 -389
  221. package/lib/src/perspectives/PerspectiveResolver.d.ts +0 -1
  222. package/lib/src/perspectives/PerspectiveResolver.js +0 -11
  223. package/lib/src/perspectives/SparqlBindings.d.ts +47 -0
  224. package/lib/src/perspectives/SparqlBindings.js +65 -0
  225. package/lib/src/perspectives/WakerSubscriptionManager.d.ts +3 -3
  226. package/lib/src/perspectives/WakerSubscriptionManager.js +12 -12
  227. package/lib/src/runtime/RuntimeClient.d.ts +8 -6
  228. package/lib/src/runtime/RuntimeClient.js +97 -454
  229. package/lib/src/runtime/RuntimeResolver.d.ts +14 -0
  230. package/lib/src/runtime/RuntimeResolver.js +84 -0
  231. package/lib/src/runtime/RuntimeTypes.d.ts +101 -0
  232. package/lib/src/runtime/RuntimeTypes.js +45 -0
  233. package/lib/src/schema.gql +14 -1
  234. package/lib/src/shacl/SHACLFlow.d.ts +1 -1
  235. package/lib/src/shacl/SHACLFlow.js +9 -9
  236. package/lib/src/shacl/SHACLShape.d.ts +26 -1
  237. package/lib/src/shacl/SHACLShape.js +140 -38
  238. package/lib/src/shacl/SHACLShape.test.js +82 -0
  239. package/lib/src/typeDefs.js +3 -615
  240. package/lib/src/utils.d.ts +6 -6
  241. package/lib/src/utils.js +6 -6
  242. package/package.json +9 -24
  243. package/rollup.config.js +0 -7
  244. package/src/Ad4mClient.test.ts +1192 -1288
  245. package/src/Ad4mClient.ts +46 -15
  246. package/src/Literal.test.ts +10 -5
  247. package/src/Literal.ts +6 -5
  248. package/src/agent/Agent.ts +0 -99
  249. package/src/agent/AgentClient.ts +238 -467
  250. package/src/agent/AgentStatus.ts +0 -12
  251. package/src/ai/AIClient.ts +96 -296
  252. package/src/ai/AITypes.ts +66 -0
  253. package/src/ai/Tasks.ts +0 -52
  254. package/src/apiClient.ts +287 -0
  255. package/src/cache/PersistentCache.ts +145 -0
  256. package/src/cache/cache.test.ts +713 -0
  257. package/src/expression/Expression.ts +3 -43
  258. package/src/expression/ExpressionClient.ts +148 -77
  259. package/src/expression/ExpressionRef.ts +2 -8
  260. package/src/generated/api/AIModelLoadingStatus.ts +3 -0
  261. package/src/generated/api/AddLinkExpressionRequest.ts +4 -0
  262. package/src/generated/api/AddLinkRequest.ts +4 -0
  263. package/src/generated/api/AddLinksBulkRequest.ts +4 -0
  264. package/src/generated/api/AddSdnaRequest.ts +3 -0
  265. package/src/generated/api/ApplyTemplateRequest.ts +3 -0
  266. package/src/generated/api/AuthInfoInput.ts +4 -0
  267. package/src/generated/api/CapabilityInput.ts +4 -0
  268. package/src/generated/api/CommitBatchRequest.ts +3 -0
  269. package/src/generated/api/ComputeLogEntry.ts +3 -0
  270. package/src/generated/api/CreateExpressionRequest.ts +3 -0
  271. package/src/generated/api/CreatePerspectiveRequest.ts +3 -0
  272. package/src/generated/api/CreateSubjectRequest.ts +3 -0
  273. package/src/generated/api/EmbedRequest.ts +3 -0
  274. package/src/generated/api/EntanglementProofInput.ts +3 -0
  275. package/src/generated/api/ExecuteCommandsRequest.ts +3 -0
  276. package/src/generated/api/ExportRequest.ts +3 -0
  277. package/src/generated/api/ExpressionManyRequest.ts +3 -0
  278. package/src/generated/api/ExpressionProof.ts +3 -0
  279. package/src/generated/api/ExpressionProofInput.ts +3 -0
  280. package/src/generated/api/FriendSendMessageRequest.ts +3 -0
  281. package/src/generated/api/FriendsListRequest.ts +3 -0
  282. package/src/generated/api/GenerateAgentRequest.ts +3 -0
  283. package/src/generated/api/GenerateJwtRequest.ts +3 -0
  284. package/src/generated/api/GetSubjectDataRequest.ts +3 -0
  285. package/src/generated/api/ImportAgentRequest.ts +3 -0
  286. package/src/generated/api/ImportRequest.ts +3 -0
  287. package/src/generated/api/JoinNeighbourhoodRequest.ts +3 -0
  288. package/src/generated/api/LanguageMetaInput.ts +3 -0
  289. package/src/generated/api/Link.ts +3 -0
  290. package/src/generated/api/LinkExpression.ts +6 -0
  291. package/src/generated/api/LinkExpressionInput.ts +6 -0
  292. package/src/generated/api/LinkInput.ts +3 -0
  293. package/src/generated/api/LinkLanguageTemplatesRequest.ts +3 -0
  294. package/src/generated/api/LinkMutations.ts +5 -0
  295. package/src/generated/api/LinkStatus.ts +3 -0
  296. package/src/generated/api/LockAgentRequest.ts +3 -0
  297. package/src/generated/api/ModelType.ts +3 -0
  298. package/src/generated/api/NotificationInput.ts +3 -0
  299. package/src/generated/api/OpenLinkRequest.ts +3 -0
  300. package/src/generated/api/PermitCapabilityRequest.ts +3 -0
  301. package/src/generated/api/PerspectiveInput.ts +4 -0
  302. package/src/generated/api/PromptRequest.ts +3 -0
  303. package/src/generated/api/PublishLanguageRequest.ts +4 -0
  304. package/src/generated/api/PublishNeighbourhoodRequest.ts +4 -0
  305. package/src/generated/api/QueryRequest.ts +6 -0
  306. package/src/generated/api/RemoveLinkRequest.ts +4 -0
  307. package/src/generated/api/RemoveLinksBulkRequest.ts +4 -0
  308. package/src/generated/api/ResourceInput.ts +3 -0
  309. package/src/generated/api/SetDefaultModelRequest.ts +4 -0
  310. package/src/generated/api/SetFreeHostingEnabledRequest.ts +3 -0
  311. package/src/generated/api/SetMultiUserRequest.ts +3 -0
  312. package/src/generated/api/SetStatusRequest.ts +3 -0
  313. package/src/generated/api/SignMessageRequest.ts +3 -0
  314. package/src/generated/api/TrustedAgentsRequest.ts +3 -0
  315. package/src/generated/api/UnlockAgentRequest.ts +3 -0
  316. package/src/generated/api/UpdateLinkRequest.ts +5 -0
  317. package/src/generated/api/UpdatePerspectiveRequest.ts +3 -0
  318. package/src/generated/api/UserStatistics.ts +3 -0
  319. package/src/generated/api/VerificationRequestResult.ts +3 -0
  320. package/src/generated/api/VerifySignatureRequest.ts +3 -0
  321. package/src/generated/api/WriteSettingsRequest.ts +3 -0
  322. package/src/generated/api/index.ts +49 -0
  323. package/src/index.ts +8 -2
  324. package/src/jestSetup.ts +1 -1
  325. package/src/language/Icon.ts +0 -4
  326. package/src/language/Language.ts +51 -248
  327. package/src/language/LanguageClient.ts +21 -132
  328. package/src/language/LanguageHandle.ts +0 -14
  329. package/src/language/LanguageMeta.ts +0 -29
  330. package/src/language/LanguageRef.ts +0 -7
  331. package/src/links/Links.ts +0 -37
  332. package/src/model/Ad4mModel.test.ts +1664 -792
  333. package/src/model/Ad4mModel.ts +664 -499
  334. package/src/model/ModelQueryBuilder.ts +362 -183
  335. package/src/model/decorators.ts +71 -22
  336. package/src/model/hydration.ts +3 -772
  337. package/src/model/index.ts +3 -4
  338. package/src/model/json-schema.ts +2 -2
  339. package/src/model/query-cache.test.ts +54 -0
  340. package/src/model/query-cache.ts +79 -0
  341. package/src/model/query-common.ts +1 -1
  342. package/src/model/query-sparql.test.ts +376 -0
  343. package/src/model/query-sparql.ts +504 -0
  344. package/src/model/query-utils.ts +209 -0
  345. package/src/model/relation-filtering.test.ts +60 -53
  346. package/src/model/sdna.ts +1 -1
  347. package/src/model/shacl-gen.ts +163 -64
  348. package/src/model/shacl-roundtrip.test.ts +197 -0
  349. package/src/model/types-typed-query.test.ts +360 -0
  350. package/src/model/types.ts +256 -5
  351. package/src/neighbourhood/Neighbourhood.ts +0 -9
  352. package/src/neighbourhood/NeighbourhoodClient.ts +42 -207
  353. package/src/neighbourhood/NeighbourhoodProxy.test.ts +34 -36
  354. package/src/perspectives/LinkQuery.ts +0 -15
  355. package/src/perspectives/Perspective.ts +1 -12
  356. package/src/perspectives/PerspectiveClient.test.ts +262 -0
  357. package/src/perspectives/PerspectiveClient.ts +252 -468
  358. package/src/perspectives/PerspectiveDiff.ts +0 -8
  359. package/src/perspectives/PerspectiveHandle.ts +1 -12
  360. package/src/perspectives/PerspectiveProxy.test.ts +125 -0
  361. package/src/perspectives/PerspectiveProxy.ts +522 -434
  362. package/src/perspectives/SparqlBindings.ts +79 -0
  363. package/src/perspectives/WakerSubscriptionManager.ts +13 -13
  364. package/src/runtime/RuntimeClient.ts +118 -461
  365. package/src/runtime/RuntimeTypes.ts +144 -0
  366. package/src/shacl/SHACLFlow.ts +9 -9
  367. package/src/shacl/SHACLShape.test.ts +204 -0
  368. package/src/shacl/SHACLShape.ts +191 -39
  369. package/src/typeDefs.ts +3 -5
  370. package/src/utils.ts +6 -6
  371. package/tsconfig.json +3 -7
  372. package/lib/src/model/query-surreal.d.ts +0 -44
  373. package/lib/src/model/query-surreal.js +0 -249
  374. package/lib/src/model/surreal-utils.js +0 -128
  375. package/shims/reflect-metadata.ts +0 -0
  376. package/shims/type-graphql.ts +0 -75
  377. package/src/PubSub.ts +0 -17
  378. package/src/agent/AgentResolver.ts +0 -263
  379. package/src/ai/AIResolver.ts +0 -372
  380. package/src/buildSchema.ts +0 -43
  381. package/src/expression/ExpressionResolver.ts +0 -64
  382. package/src/language/LanguageContext.ts +0 -37
  383. package/src/language/LanguageResolver.ts +0 -98
  384. package/src/model/Subject.ts +0 -159
  385. package/src/model/prolog-facts.ts +0 -145
  386. package/src/model/query-prolog.ts +0 -148
  387. package/src/model/query-surreal.ts +0 -280
  388. package/src/model/surreal-utils.ts +0 -147
  389. package/src/neighbourhood/NeighbourhoodResolver.ts +0 -100
  390. package/src/perspectives/PerspectiveResolver.ts +0 -372
  391. package/src/runtime/RuntimeResolver.ts +0 -691
  392. package/src/unwrapApolloResult.ts +0 -16
  393. package/tsconfig-browser.json +0 -82
@@ -1,64 +0,0 @@
1
- import { Arg, Mutation, Query, Resolver } from "type-graphql";
2
- import { LanguageRef } from "../language/LanguageRef";
3
- import { ExpressionProof, ExpressionRendered } from "./Expression";
4
- import { InteractionCall, InteractionMeta } from "../language/Language"
5
-
6
-
7
- const e = new ExpressionRendered()
8
- e.author = 'did:ad4m:test'
9
- e.timestamp = Date.now().toString()
10
- e.proof = new ExpressionProof('', '')
11
- e.data = JSON.stringify({ type: 'test expression', content: 'test'})
12
- e.language = new LanguageRef('test-language-address')
13
- const testExpression = e
14
- @Resolver()
15
- export default class ExpressionResolver {
16
- @Query(returns => ExpressionRendered, {nullable: true})
17
- expression(@Arg('url') url: string): ExpressionRendered {
18
- if(url === 'neighbourhood://Qm123') {
19
- return testExpression
20
- } else {
21
- return null
22
- }
23
- }
24
-
25
- @Query(returns => [ExpressionRendered], {nullable: "items"})
26
- expressionMany(@Arg('urls', type => [String]) urls: string[]): (ExpressionRendered | null)[] {
27
- return [testExpression, null]
28
- }
29
-
30
- @Query(returns => String, {nullable: true})
31
- expressionRaw(@Arg('url') url: string): string {
32
- if(url === 'neighbourhood://Qm123') {
33
- return JSON.stringify(testExpression)
34
- } else {
35
- return null
36
- }
37
- }
38
-
39
- @Mutation(returns => String)
40
- expressionCreate(
41
- @Arg('content') content: string,
42
- @Arg('languageAddress') languageAddress: string
43
- ): string {
44
- return "Qm1234"
45
- }
46
-
47
- @Query(returns => [InteractionMeta])
48
- expressionInteractions(@Arg('url') url: string): InteractionMeta[] {
49
- const interaction = {
50
- label: "Add a comment",
51
- name: "add_comment",
52
- parameters: [{name: 'comment', type: 'string'}]
53
- } as InteractionMeta
54
- return [interaction]
55
- }
56
-
57
- @Mutation(returns => String, {nullable: true})
58
- expressionInteract(
59
- @Arg('url') url: string,
60
- @Arg('interactionCall') interactionCall: InteractionCall
61
- ): string|null {
62
- return "test result"
63
- }
64
- }
@@ -1,37 +0,0 @@
1
- import type { AppSignalCb } from '@holochain/client'
2
- import { Expression } from "../expression/Expression";
3
-
4
- export interface AgentService {
5
- readonly did: string
6
- createSignedExpression(data: any): Expression
7
- }
8
-
9
- export interface SignaturesService {
10
- verify(expr: Expression): boolean
11
- }
12
-
13
- export interface LanguageContext {
14
- agent: AgentService;
15
- signatures: SignaturesService;
16
- storageDirectory: string;
17
- customSettings: object;
18
- Holochain: HolochainLanguageDelegate | undefined;
19
- ad4mSignal: Ad4mSignalCB;
20
- }
21
-
22
- export class Dna {
23
- file: Buffer
24
- nick: string
25
- zomeCalls: [string, string][]
26
- }
27
-
28
- export interface HolochainLanguageDelegate {
29
- /** Installs/registers a given DNA in the ad4m-executor */
30
- registerDNAs(dnas: Dna[], holochainSignalCallback?: AppSignalCb): Promise<void>;
31
- /** Makes a single call to a given holochain DNA. Underlying implementation puts these calls into a sync fifo queue */
32
- call(dnaNick: string, zomeName: string, fnName: string, params: object|string): Promise<any>;
33
- /** Makes all supplied calls in parallel to the provided holochain dna... Should only be called on read operations to avoid source chain async mutation errors */
34
- callAsync(calls: {dnaNick: string, zomeName: string, fnName: string, params: object|string}[], timeoutMs?: number): Promise<any[]>;
35
- }
36
-
37
- export type Ad4mSignalCB = (signal: any) => void
@@ -1,98 +0,0 @@
1
-
2
- import { Arg, Mutation, Query, Resolver } from "type-graphql";
3
- import { Icon } from "./Icon";
4
- import { LanguageHandle } from "./LanguageHandle";
5
- import { LanguageMeta, LanguageMetaInput } from "./LanguageMeta"
6
- import { LanguageRef } from "./LanguageRef";
7
-
8
- /**
9
- * Resolver classes are used here to define the GraphQL schema
10
- * (through the type-graphql annotations)
11
- * and are spawned in the client tests in Ad4mClient.test.ts.
12
- * For the latter, they return test fixtures.
13
- */
14
- @Resolver()
15
- export default class LanguageResolver {
16
- @Query(returns => LanguageHandle, {nullable: true})
17
- language(@Arg('address') address: string): LanguageHandle {
18
- let language = new LanguageHandle()
19
- language.address = address
20
- language.name = 'test-language'
21
- language.settings = JSON.stringify({testSetting: 'test'})
22
- language.icon = new Icon('test-code')
23
- language.settingsIcon = new Icon('test-code')
24
- language.constructorIcon = new Icon('test-code')
25
- return language
26
- }
27
-
28
-
29
- @Query(returns => [LanguageHandle])
30
- languages(@Arg('filter', {nullable: true}) filter: string): LanguageHandle[] {
31
- let language = new LanguageHandle()
32
- language.address = 'test-address'
33
- language.name = 'test-links-language'
34
-
35
- if(!filter || filter === 'linksAdapter')
36
- return [language]
37
- else
38
- return []
39
- }
40
-
41
- @Mutation(returns => Boolean)
42
- languageWriteSettings(
43
- @Arg('languageAddress') languageAddress: string,
44
- @Arg('settings') settings: string
45
- ): Boolean {
46
- return true
47
- }
48
-
49
- @Mutation()
50
- languageApplyTemplateAndPublish(
51
- @Arg('sourceLanguageHash') sourceLanguageHash: string,
52
- @Arg('templateData') templateData: string,
53
- ): LanguageRef {
54
- return new LanguageRef('test-address', `${sourceLanguageHash}-clone`)
55
- }
56
-
57
- @Mutation()
58
- languagePublish(
59
- @Arg('languagePath') languagePath: string,
60
- @Arg('languageMeta') languageMeta: LanguageMetaInput,
61
- ): LanguageMeta {
62
- let meta = new LanguageMeta()
63
- meta.name = languageMeta.name
64
- meta.address = "Qm12345"
65
- meta.description = languageMeta.description
66
- meta.author = "did:test:me"
67
- meta.templated = true
68
- meta.templateSourceLanguageAddress = "Qm12345"
69
- meta.templateAppliedParams = JSON.stringify({uuid: 'asdfsdaf', name: 'test template'})
70
- meta.possibleTemplateParams = languageMeta.possibleTemplateParams
71
- meta.sourceCodeLink = languageMeta.sourceCodeLink
72
- return meta
73
- }
74
-
75
- @Query()
76
- languageMeta(@Arg('address') address: string): LanguageMeta {
77
- let meta = new LanguageMeta()
78
- meta.name = "test-language"
79
- meta.address = address
80
- meta.description = "Language meta for testing"
81
- meta.author = "did:test:me"
82
- meta.templated = true
83
- meta.templateSourceLanguageAddress = "Qm12345"
84
- meta.templateAppliedParams = JSON.stringify({uuid: 'asdfsdaf', name: 'test template'})
85
- meta.possibleTemplateParams = ['uuid', 'name']
86
- meta.sourceCodeLink = "https://github.com/perspect3vism/ad4m"
87
- return meta
88
- }
89
-
90
- @Query()
91
- languageSource(@Arg('address') address: string): string {
92
- return "var test = 'language source code'"
93
- }
94
-
95
- @Mutation()
96
- languageRemove(@Arg('address') address: string): Boolean { return true }
97
- }
98
-
@@ -1,159 +0,0 @@
1
- import { PerspectiveProxy } from "../perspectives/PerspectiveProxy";
2
- import { relationToAdderName, relationToRemoverName, relationToSetterName, propertyNameToSetterName } from "./util";
3
-
4
- /**
5
- * Represents a subject in the perspective.
6
- * A subject is an entity that has properties and relations.
7
- */
8
- export class Subject {
9
- #baseExpression: string;
10
- #subjectClassName: string;
11
- #perspective: PerspectiveProxy
12
-
13
- /**
14
- * Constructs a new subject.
15
- * @param perspective - The perspective that the subject belongs to.
16
- * @param baseExpression - The base expression of the subject.
17
- * @param subjectClassName - The class name of the subject.
18
- */
19
- constructor(perspective: PerspectiveProxy, baseExpression: string, subjectClassName: string) {
20
- this.#baseExpression = baseExpression
21
- this.#subjectClassName = subjectClassName
22
- this.#perspective = perspective
23
- }
24
-
25
- /**
26
- * Gets the base expression of the subject.
27
- */
28
- get baseExpression() {
29
- return this.#baseExpression
30
- }
31
-
32
- /**
33
- * Initializes the subject by validating it and defining its properties and relations dynamically.
34
- *
35
- * NOTE: This method should be called before using the subject. All the properties and relations of the subject defined are not type-checked.
36
- */
37
- async init() {
38
- // Check if the subject is a valid instance of the subject class
39
- let isInstance = await this.#perspective.isSubjectInstance(this.#baseExpression, this.#subjectClassName)
40
- if(!isInstance) {
41
- throw `Not a valid subject instance of ${this.#subjectClassName} for ${this.#baseExpression}`
42
- }
43
-
44
- // Define properties and relations dynamically
45
- let results = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), property(C, Property)`)
46
- let properties = results.map(result => result.Property)
47
-
48
- for(let p of properties) {
49
- const resolveExpressionURI = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), property_resolve(C, "${p}")`)
50
- Object.defineProperty(this, p, {
51
- configurable: true,
52
- get: async () => {
53
- // Use SurrealDB for data queries
54
- try {
55
- return await this.#perspective.getPropertyValueViaSurreal(this.#baseExpression, this.#subjectClassName, p);
56
- } catch (err) {
57
- console.warn(`Failed to get property ${p} via SurrealDB:`, err);
58
- return undefined;
59
- }
60
- }
61
- })
62
- }
63
-
64
- // Define setters
65
- const setters = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), property_setter(C, Property, Setter)`)
66
-
67
- for(let setter of (setters ? setters : [])) {
68
- if(setter) {
69
- const property = setter.Property
70
- const actions = eval(setter.Setter)
71
- const resolveLanguageResults = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), property_resolve_language(C, "${property}", Language)`)
72
- let resolveLanguage
73
- if(resolveLanguageResults && resolveLanguageResults.length > 0) {
74
- resolveLanguage = resolveLanguageResults[0].Language
75
- }
76
- this[propertyNameToSetterName(property)] = async (value: any) => {
77
- if(resolveLanguage) {
78
- value = await this.#perspective.createExpression(value, resolveLanguage)
79
- }
80
- await this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value}])
81
- }
82
- }
83
- }
84
-
85
- // Define relations
86
- let results2 = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), collection(C, Collection)`)
87
- if(!results2) results2 = []
88
- let relations = results2.map(result => result.Collection)
89
-
90
- for(let c of relations) {
91
- Object.defineProperty(this, c, {
92
- configurable: true,
93
- get: async () => {
94
- // Use SurrealDB for data queries
95
- try {
96
- return await this.#perspective.getRelationValuesViaSurreal(this.#baseExpression, this.#subjectClassName, c);
97
- } catch (err) {
98
- console.warn(`Failed to get relation ${c} via SurrealDB:`, err);
99
- return [];
100
- }
101
- }
102
- })
103
- }
104
-
105
- // Define relation adders
106
- let adders = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), collection_adder(C, Collection, Adder)`)
107
- if(!adders) adders = []
108
-
109
- for(let adder of adders) {
110
- if(adder) {
111
- const relation = adder.Collection
112
- const actions = eval(adder.Adder)
113
- this[relationToAdderName(relation)] = async (value: any) => {
114
- if (Array.isArray(value)) {
115
- await Promise.all(value.map(v => this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value: v}])))
116
- } else {
117
- await this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value}])
118
- }
119
- }
120
- }
121
- }
122
-
123
- // Define relation removers
124
- let removers = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), collection_remover(C, Collection, Remover)`)
125
- if(!removers) removers = []
126
-
127
- for(let remover of removers) {
128
- if(remover) {
129
- const relation = remover.Collection
130
- const actions = eval(remover.Remover)
131
- this[relationToRemoverName(relation)] = async (value: any) => {
132
- if (Array.isArray(value)) {
133
- await Promise.all(value.map(v => this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value: v}])))
134
- } else {
135
- await this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value}])
136
- }
137
- }
138
- }
139
- }
140
-
141
- // Define relation setters
142
- let relationSetters = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), collection_setter(C, Collection, Setter)`)
143
- if(!relationSetters) relationSetters = []
144
-
145
- for(let relationSetter of relationSetters) {
146
- if(relationSetter) {
147
- const relation = relationSetter.Collection
148
- const actions = eval(relationSetter.Setter)
149
- this[relationToSetterName(relation)] = async (value: any) => {
150
- if (Array.isArray(value)) {
151
- await this.#perspective.executeAction(actions, this.#baseExpression, value.map(v => ({name: "value", value: v})))
152
- } else {
153
- await this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value}])
154
- }
155
- }
156
- }
157
- }
158
- }
159
- }
@@ -1,145 +0,0 @@
1
- /**
2
- * Standalone Prolog fact generator for Ad4mModel classes.
3
- *
4
- * Converts decorator metadata into Prolog clauses that can be prepended to
5
- * `perspective.infer()` calls, enabling custom Prolog rules to reference
6
- * model instances and their fields.
7
- */
8
-
9
- import type { ModelMetadata, PropertyMetadata, RelationMetadata } from "./types";
10
- import type { Ad4mModel } from "./Ad4mModel";
11
-
12
- // ── Helpers ──────────────────────────────────────────────────────────────────
13
-
14
- /**
15
- * Convert a camelCase or PascalCase identifier to snake_case.
16
- * Examples: "TestPost" -> "test_post", "createdAt" -> "created_at"
17
- */
18
- function toSnakeCase(str: string): string {
19
- return str
20
- .replace(/([A-Z])/g, "_$1")
21
- .toLowerCase()
22
- .replace(/^_/, "");
23
- }
24
-
25
- function buildInstanceClause(predicateName: string, metadata: ModelMetadata): string | null {
26
- const props = metadata.properties;
27
- // Collect flags first — these are the strongest recognizers
28
- const flags = Object.values(props).filter((p) => p.flag && p.predicate && p.initial);
29
- if (flags.length > 0) {
30
- const conditions = flags
31
- .map((p) => `triple(X, '${p.predicate}', '${p.initial}')`)
32
- .join(",\n ");
33
- return `${predicateName}(X) :-\n ${conditions}.`;
34
- }
35
- // Fallback: required non-flag properties
36
- const required = Object.values(props).filter((p) => p.required && p.predicate && !p.flag);
37
- if (required.length > 0) {
38
- const conditions = required
39
- .map((p) => `triple(X, '${p.predicate}', _)`)
40
- .join(",\n ");
41
- return `${predicateName}(X) :-\n ${conditions}.`;
42
- }
43
- // Open-world structural fallback: match nodes that have at least one of the
44
- // model's declared property predicates. Uses disjunction (;) so any single
45
- // predicate is enough.
46
- const allPredicates = Object.values(props)
47
- .filter((p) => p.predicate)
48
- .map((p) => p.predicate!);
49
- if (metadata.relations) {
50
- for (const rel of Object.values(metadata.relations)) {
51
- if (rel.predicate) allPredicates.push(rel.predicate);
52
- }
53
- }
54
- if (allPredicates.length > 0) {
55
- const disjunction = allPredicates
56
- .map((pred) => `triple(X, '${pred}', _)`)
57
- .join(" ;\n ");
58
- return `${predicateName}(X) :-\n (${disjunction}).`;
59
- }
60
- return null;
61
- }
62
-
63
- function buildPropertyClause(modelPredicateName: string, prop: PropertyMetadata): string | null {
64
- if (prop.flag) return null;
65
- if (!prop.predicate) return null;
66
- const clauseName = `${modelPredicateName}_${toSnakeCase(prop.name)}`;
67
- return `${clauseName}(X, Value) :- triple(X, '${prop.predicate}', Value).`;
68
- }
69
-
70
- function buildRelationClause(modelPredicateName: string, relation: RelationMetadata): string | null {
71
- if (!relation.predicate) return null;
72
- const clauseName = `${modelPredicateName}_${toSnakeCase(relation.name)}`;
73
- if (relation.direction === "reverse") {
74
- return `${clauseName}(X, Values) :- findall(V, triple(V, '${relation.predicate}', X), Values).`;
75
- }
76
- return `${clauseName}(X, Values) :- findall(V, triple(X, '${relation.predicate}', V), Values).`;
77
- }
78
-
79
- // ── Public API ───────────────────────────────────────────────────────────────
80
-
81
- /**
82
- * Generate Prolog predicate facts from a model class's decorator metadata.
83
- *
84
- * Given a model class decorated with `@Model` (and its `@Flag`, `@Property`,
85
- * `@HasMany`, `@BelongsToMany` decorators), this function emits a string of
86
- * Prolog clauses that can be prepended to any `perspective.infer()` call.
87
- *
88
- * The generated predicates are:
89
- * - **Instance recognizer** — `modelName(X)` — matches instances of the model
90
- * - **Property getters** — `modelName_propName(X, Value)` — one per property
91
- * - **Relation getters** — `modelName_relName(X, Values)` — one per relation
92
- *
93
- * @example
94
- * ```typescript
95
- * import { generatePrologFacts } from '@coasys/ad4m';
96
- *
97
- * const facts = generatePrologFacts(Poll);
98
- * const result = await perspective.infer(\`
99
- * \${facts}
100
- * recent_popular_poll(X) :-
101
- * poll(X),
102
- * poll_vote_count(X, N), N > 10.
103
- * \`);
104
- * ```
105
- *
106
- * @param ModelClass - A class decorated with `@Model` that extends `Ad4mModel`
107
- * @returns A multi-line Prolog string ready for use with `perspective.infer()`
108
- */
109
- export function generatePrologFacts(ModelClass: typeof Ad4mModel): string {
110
- const metadata = ModelClass.getModelMetadata();
111
- const predicateName = toSnakeCase(metadata.className);
112
- const lines: string[] = [];
113
-
114
- lines.push(`% ${metadata.className} — generated Prolog facts`);
115
-
116
- // Instance recognizer
117
- const instanceClause = buildInstanceClause(predicateName, metadata);
118
- if (instanceClause) {
119
- lines.push("");
120
- lines.push(`% Instance recognizer`);
121
- lines.push(instanceClause);
122
- }
123
-
124
- // Property getters
125
- const propClauses = Object.values(metadata.properties)
126
- .map((p) => buildPropertyClause(predicateName, p))
127
- .filter((c): c is string => c !== null);
128
- if (propClauses.length > 0) {
129
- lines.push("");
130
- lines.push(`% Field getters`);
131
- lines.push(...propClauses);
132
- }
133
-
134
- // Relation getters
135
- const relClauses = Object.values(metadata.relations)
136
- .map((c) => buildRelationClause(predicateName, c))
137
- .filter((c): c is string => c !== null);
138
- if (relClauses.length > 0) {
139
- lines.push("");
140
- lines.push(`% Relation getters`);
141
- lines.push(...relClauses);
142
- }
143
-
144
- return lines.join("\n");
145
- }
@@ -1,148 +0,0 @@
1
- /**
2
- * Prolog query building helpers for the Ad4mModel query pipeline.
3
- *
4
- * These pure functions translate the Ad4mModel `Query` DSL into Prolog clause
5
- * fragments that are assembled by `Ad4mModel.queryToProlog()`.
6
- */
7
-
8
- import type { Where, WhereCondition, Order, ParentScope } from "./types";
9
- import { capitalize } from "./util";
10
-
11
- // ── Query clause builders ────────────────────────────────────────────────────
12
-
13
- export function buildParentQuery(
14
- parent: ParentScope | undefined,
15
- resolvedPredicate?: string,
16
- ): string {
17
- if (!parent || !resolvedPredicate) return '';
18
- return `triple("${parent.id}", "${resolvedPredicate}", Base)`;
19
- }
20
-
21
- export function buildAuthorAndTimestampQuery(): string {
22
- // Gets the author and timestamp of a Ad4mModel instance (based on the first link mentioning the base)
23
- return `
24
- findall(
25
- [T, A],
26
- link(Base, _, _, T, A),
27
- AllLinks
28
- ),
29
- sort(AllLinks, SortedLinks),
30
- SortedLinks = [[Timestamp, Author]|_]
31
- `;
32
- }
33
-
34
- export function buildPropertiesQuery(properties?: string[]): string {
35
- // Gets the name, value, and resolve boolean for all (or some) properties on a Ad4mModel instance
36
- // Resolves literals (if property_resolve/2 is true) to their value - either the data field if it is
37
- // an Expression in JSON literal, or the direct literal value if it is a simple literal
38
- // If no properties are provided, all are included
39
- return `
40
- findall([PropertyName, PropertyValue, Resolve], (
41
- % Constrain to specified properties if provided
42
- ${properties ? `member(PropertyName, [${properties.map((name) => `"${name}"`).join(", ")}]),` : ""}
43
- resolve_property(SubjectClass, Base, PropertyName, PropertyValue, Resolve)
44
- ), Properties)
45
- `;
46
- }
47
-
48
- export function buildWhereQuery(where: Where = {}): string {
49
- // Constrains the query to instances that match the provided where conditions
50
- // 'id' maps to the Prolog 'Base' variable (the base expression of the instance).
51
-
52
- function formatValue(value) {
53
- // Wrap strings in quotes
54
- return typeof value === "string" ? `"${value}"` : value;
55
- }
56
-
57
- return (Object.entries(where) as [string, WhereCondition][])
58
- .map(([key, value]) => {
59
- const isSpecial = ["id", "author", "timestamp"].includes(key);
60
- const getter = `resolve_property(SubjectClass, Base, "${key}", Value${key}, _)`;
61
- // For 'id' the Prolog variable is always 'Base'
62
- const field = key === "id" ? "Base" : capitalize(key);
63
-
64
- // Handle direct array values (for IN conditions)
65
- if (Array.isArray(value)) {
66
- const formattedValues = value.map((v) => formatValue(v)).join(", ");
67
- if (isSpecial) return `member(${field}, [${formattedValues}])`;
68
- else return `${getter}, member(Value${key}, [${formattedValues}])`;
69
- }
70
-
71
- // Handle operation object
72
- if (typeof value === "object" && value !== null) {
73
- const { not, between, lt, lte, gt, gte } = value;
74
-
75
- // Handle NOT operation
76
- if (not !== undefined) {
77
- if (Array.isArray(not)) {
78
- // NOT IN array
79
- const formattedValues = not.map((v) => formatValue(v)).join(", ");
80
- if (isSpecial) return `\\+ member(${field}, [${formattedValues}])`;
81
- else return `${getter}, \\+ member(Value${key}, [${formattedValues}])`;
82
- } else {
83
- // NOT EQUAL
84
- if (isSpecial) return `${field} \\= ${formatValue(not)}`;
85
- else return `${getter}, Value${key} \\= ${formatValue(not)}`;
86
- }
87
- }
88
-
89
- // Handle BETWEEN
90
- if (between !== undefined && Array.isArray(between) && between.length === 2) {
91
- if (isSpecial) return `${field} >= ${between[0]}, ${field} =< ${between[1]}`;
92
- else return `${getter}, Value${key} >= ${between[0]}, Value${key} =< ${between[1]}`;
93
- }
94
-
95
- // Handle lt, lte, gt, & gte operations
96
- const operators = [
97
- { value: lt, symbol: "<" }, // LESS THAN
98
- { value: lte, symbol: "=<" }, // LESS THAN OR EQUAL TO
99
- { value: gt, symbol: ">" }, // GREATER THAN
100
- { value: gte, symbol: ">=" }, // GREATER THAN OR EQUAL TO
101
- ];
102
-
103
- for (const { value, symbol } of operators) {
104
- if (value !== undefined)
105
- return isSpecial ? `${field} ${symbol} ${value}` : `${getter}, Value${key} ${symbol} ${value}`;
106
- }
107
- }
108
-
109
- // Default to direct equality
110
- if (isSpecial) return `${field} = ${formatValue(value)}`;
111
- else return `${getter}, Value${key} = ${formatValue(value)}`;
112
- })
113
- .join(", ");
114
- }
115
-
116
- export function buildCountQuery(count?: boolean): string {
117
- return count ? "length(UnsortedInstances, TotalCount)" : "";
118
- }
119
-
120
- export function buildOrderQuery(order?: Order): string {
121
- if (!order) return "SortedInstances = UnsortedInstances";
122
- const entries = Object.entries(order);
123
- if (entries.length === 1) {
124
- const [propertyName, direction] = entries[0];
125
- return `sort_instances(UnsortedInstances, "${propertyName}", "${direction}", SortedInstances)`;
126
- }
127
- // Multi-field sort: sort from least-significant to most-significant key
128
- // so that the final (primary) sort preserves secondary-key ordering for equal values.
129
- // The merge_sort implementation is stable (equal elements keep original order).
130
- const clauses: string[] = [];
131
- for (let i = entries.length - 1; i >= 0; i--) {
132
- const [propertyName, direction] = entries[i];
133
- const inputVar = i === entries.length - 1 ? "UnsortedInstances" : `MultiSortIntermediate${i + 1}`;
134
- const outputVar = i === 0 ? "SortedInstances" : `MultiSortIntermediate${i}`;
135
- clauses.push(`sort_instances(${inputVar}, "${propertyName}", "${direction}", ${outputVar})`);
136
- }
137
- return clauses.join(",\n ");
138
- }
139
-
140
- export function buildOffsetQuery(offset?: number): string {
141
- if (!offset || offset < 0) return "InstancesWithOffset = SortedInstances";
142
- return `skipN(SortedInstances, ${offset}, InstancesWithOffset)`;
143
- }
144
-
145
- export function buildLimitQuery(limit?: number): string {
146
- if (!limit || limit < 0) return "AllInstances = InstancesWithOffset";
147
- return `takeN(InstancesWithOffset, ${limit}, AllInstances)`;
148
- }