@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
@@ -90,6 +90,16 @@ export declare class PaymentRequestResult {
90
90
  message: string;
91
91
  constructor(success: boolean, message: string);
92
92
  }
93
+ export declare class ComputeLogEntry {
94
+ id: number;
95
+ userEmail: string;
96
+ timestamp: string;
97
+ operation: string;
98
+ summary?: string;
99
+ cost: number;
100
+ creditsAfter: number;
101
+ constructor(id: number, userEmail: string, timestamp: string, operation: string, cost: number, creditsAfter: number, summary?: string);
102
+ }
93
103
  /**
94
104
  * Resolver classes are used here to define the GraphQL schema
95
105
  * (through the type-graphql annotations)
@@ -133,6 +143,8 @@ export default class RuntimeResolver {
133
143
  runtimeImportPerspective(filePath: string): boolean;
134
144
  runtimeMultiUserEnabled(): boolean;
135
145
  runtimeSetMultiUserEnabled(enabled: boolean): boolean;
146
+ runtimeFreeHostingEnabled(): boolean;
147
+ runtimeSetFreeHostingEnabled(enabled: boolean): boolean;
136
148
  runtimeListUsers(): UserStatistics[];
137
149
  runtimeRequestLoginVerification(email: string, appInfo?: AuthInfoInput): VerificationRequestResult;
138
150
  runtimeVerifyEmailCode(email: string, code: string, verificationType: string): string;
@@ -145,6 +157,7 @@ export default class RuntimeResolver {
145
157
  runtimeEmailTestClearCodes(): boolean;
146
158
  runtimeEmailTestSetExpiry(email: string, verificationType: string, expiresAt: number): boolean;
147
159
  runtimeHostingUserInfo(): HostingUserInfo;
160
+ runtimeComputeLog(since?: string, limit?: number, userEmail?: string): ComputeLogEntry[];
148
161
  runtimeSetHotWalletAddress(address: string): boolean;
149
162
  runtimeRequestPayment(amountHOT: string): PaymentRequestResult;
150
163
  runtimeSetUserCredits(email: string, amount: number): boolean;
@@ -155,5 +168,6 @@ export default class RuntimeResolver {
155
168
  runtimeHotWalletBalance(): string;
156
169
  runtimeHotWalletHistory(page?: number, perPage?: number): string;
157
170
  runtimeHotAgentPubkey(): string;
171
+ runtimeUnytAgentKey(): string;
158
172
  runtimeUnytVersionInfo(): string;
159
173
  }
@@ -375,6 +375,50 @@ PaymentRequestResult = __decorate([
375
375
  __metadata("design:paramtypes", [Boolean, String])
376
376
  ], PaymentRequestResult);
377
377
  export { PaymentRequestResult };
378
+ let ComputeLogEntry = class ComputeLogEntry {
379
+ constructor(id, userEmail, timestamp, operation, cost, creditsAfter, summary) {
380
+ this.id = id;
381
+ this.userEmail = userEmail;
382
+ this.timestamp = timestamp;
383
+ this.operation = operation;
384
+ this.cost = cost;
385
+ this.creditsAfter = creditsAfter;
386
+ this.summary = summary;
387
+ }
388
+ };
389
+ __decorate([
390
+ Field(),
391
+ __metadata("design:type", Number)
392
+ ], ComputeLogEntry.prototype, "id", void 0);
393
+ __decorate([
394
+ Field(),
395
+ __metadata("design:type", String)
396
+ ], ComputeLogEntry.prototype, "userEmail", void 0);
397
+ __decorate([
398
+ Field(),
399
+ __metadata("design:type", String)
400
+ ], ComputeLogEntry.prototype, "timestamp", void 0);
401
+ __decorate([
402
+ Field(),
403
+ __metadata("design:type", String)
404
+ ], ComputeLogEntry.prototype, "operation", void 0);
405
+ __decorate([
406
+ Field({ nullable: true }),
407
+ __metadata("design:type", String)
408
+ ], ComputeLogEntry.prototype, "summary", void 0);
409
+ __decorate([
410
+ Field(),
411
+ __metadata("design:type", Number)
412
+ ], ComputeLogEntry.prototype, "cost", void 0);
413
+ __decorate([
414
+ Field(),
415
+ __metadata("design:type", Number)
416
+ ], ComputeLogEntry.prototype, "creditsAfter", void 0);
417
+ ComputeLogEntry = __decorate([
418
+ ObjectType(),
419
+ __metadata("design:paramtypes", [Number, String, String, String, Number, Number, String])
420
+ ], ComputeLogEntry);
421
+ export { ComputeLogEntry };
378
422
  /**
379
423
  * Resolver classes are used here to define the GraphQL schema
380
424
  * (through the type-graphql annotations)
@@ -530,6 +574,12 @@ let RuntimeResolver = class RuntimeResolver {
530
574
  runtimeSetMultiUserEnabled(enabled) {
531
575
  return enabled;
532
576
  }
577
+ runtimeFreeHostingEnabled() {
578
+ return true;
579
+ }
580
+ runtimeSetFreeHostingEnabled(enabled) {
581
+ return enabled;
582
+ }
533
583
  runtimeListUsers() {
534
584
  return [{
535
585
  email: "test@example.com",
@@ -589,6 +639,9 @@ let RuntimeResolver = class RuntimeResolver {
589
639
  runtimeHostingUserInfo() {
590
640
  return new HostingUserInfo("test@example.com", "100000000", null, false);
591
641
  }
642
+ runtimeComputeLog(since, limit, userEmail) {
643
+ return [];
644
+ }
592
645
  runtimeSetHotWalletAddress(address) {
593
646
  return true;
594
647
  }
@@ -619,6 +672,9 @@ let RuntimeResolver = class RuntimeResolver {
619
672
  runtimeHotAgentPubkey() {
620
673
  return "";
621
674
  }
675
+ runtimeUnytAgentKey() {
676
+ return "";
677
+ }
622
678
  runtimeUnytVersionInfo() {
623
679
  return "";
624
680
  }
@@ -868,6 +924,19 @@ __decorate([
868
924
  __metadata("design:paramtypes", [Boolean]),
869
925
  __metadata("design:returntype", Boolean)
870
926
  ], RuntimeResolver.prototype, "runtimeSetMultiUserEnabled", null);
927
+ __decorate([
928
+ Query(returns => Boolean),
929
+ __metadata("design:type", Function),
930
+ __metadata("design:paramtypes", []),
931
+ __metadata("design:returntype", Boolean)
932
+ ], RuntimeResolver.prototype, "runtimeFreeHostingEnabled", null);
933
+ __decorate([
934
+ Mutation(returns => Boolean),
935
+ __param(0, Arg("enabled")),
936
+ __metadata("design:type", Function),
937
+ __metadata("design:paramtypes", [Boolean]),
938
+ __metadata("design:returntype", Boolean)
939
+ ], RuntimeResolver.prototype, "runtimeSetFreeHostingEnabled", null);
871
940
  __decorate([
872
941
  Query(returns => [UserStatistics]),
873
942
  __metadata("design:type", Function),
@@ -955,6 +1024,15 @@ __decorate([
955
1024
  __metadata("design:paramtypes", []),
956
1025
  __metadata("design:returntype", HostingUserInfo)
957
1026
  ], RuntimeResolver.prototype, "runtimeHostingUserInfo", null);
1027
+ __decorate([
1028
+ Query(returns => [ComputeLogEntry]),
1029
+ __param(0, Arg("since", { nullable: true })),
1030
+ __param(1, Arg("limit", { nullable: true })),
1031
+ __param(2, Arg("userEmail", { nullable: true })),
1032
+ __metadata("design:type", Function),
1033
+ __metadata("design:paramtypes", [String, Number, String]),
1034
+ __metadata("design:returntype", Array)
1035
+ ], RuntimeResolver.prototype, "runtimeComputeLog", null);
958
1036
  __decorate([
959
1037
  Mutation(returns => Boolean),
960
1038
  __param(0, Arg("address")),
@@ -1026,6 +1104,12 @@ __decorate([
1026
1104
  __metadata("design:paramtypes", []),
1027
1105
  __metadata("design:returntype", String)
1028
1106
  ], RuntimeResolver.prototype, "runtimeHotAgentPubkey", null);
1107
+ __decorate([
1108
+ Query(returns => String),
1109
+ __metadata("design:type", Function),
1110
+ __metadata("design:paramtypes", []),
1111
+ __metadata("design:returntype", String)
1112
+ ], RuntimeResolver.prototype, "runtimeUnytAgentKey", null);
1029
1113
  __decorate([
1030
1114
  Query(returns => String),
1031
1115
  __metadata("design:type", Function),
@@ -0,0 +1,101 @@
1
+ import { PerspectiveExpression } from "../perspectives/Perspective";
2
+ import { ExceptionType } from "../Exception";
3
+ export declare class SentMessage {
4
+ recipient: string;
5
+ message: PerspectiveExpression;
6
+ }
7
+ export declare class RuntimeInfo {
8
+ ad4mExecutorVersion: string;
9
+ isInitialized: Boolean;
10
+ isUnlocked: Boolean;
11
+ }
12
+ export declare class ExceptionInfo {
13
+ title: string;
14
+ message: string;
15
+ type: ExceptionType;
16
+ addon?: string;
17
+ }
18
+ export declare class NotificationInput {
19
+ description: string;
20
+ appName: string;
21
+ appUrl: string;
22
+ appIconPath: string;
23
+ trigger: string;
24
+ perspectiveIds: string[];
25
+ webhookUrl: string;
26
+ webhookAuth: string;
27
+ }
28
+ export declare class Notification {
29
+ id: string;
30
+ granted: boolean;
31
+ description: string;
32
+ appName: string;
33
+ appUrl: string;
34
+ appIconPath: string;
35
+ trigger: string;
36
+ perspectiveIds: string[];
37
+ webhookUrl: string;
38
+ webhookAuth: string;
39
+ }
40
+ export declare class TriggeredNotification {
41
+ notification: Notification;
42
+ perspectiveId: string;
43
+ triggerMatch: string;
44
+ }
45
+ export declare class ImportStats {
46
+ total: number;
47
+ imported: number;
48
+ failed: number;
49
+ omitted: number;
50
+ errors: string[];
51
+ }
52
+ export declare class ImportResult {
53
+ perspectives: ImportStats;
54
+ links: ImportStats;
55
+ expressions: ImportStats;
56
+ perspectiveDiffs: ImportStats;
57
+ notifications: ImportStats;
58
+ models: ImportStats;
59
+ defaultModels: ImportStats;
60
+ tasks: ImportStats;
61
+ friends: ImportStats;
62
+ trustedAgents: ImportStats;
63
+ knownLinkLanguages: ImportStats;
64
+ }
65
+ export declare class UserStatistics {
66
+ email: string;
67
+ did: string;
68
+ lastSeen?: string;
69
+ perspectiveCount: number;
70
+ remainingCredits: string;
71
+ freeAccess: boolean;
72
+ hotWalletAddress?: string;
73
+ }
74
+ export declare class VerificationRequestResult {
75
+ success: boolean;
76
+ message: string;
77
+ requiresPassword: boolean;
78
+ isExistingUser: boolean;
79
+ }
80
+ export declare class HostingUserInfo {
81
+ email: string;
82
+ remainingCredits: string;
83
+ hotWalletAddress?: string;
84
+ freeAccess: boolean;
85
+ constructor(email: string, remainingCredits: string, hotWalletAddress?: string, freeAccess?: boolean);
86
+ }
87
+ export declare class PaymentRequestResult {
88
+ success: boolean;
89
+ message: string;
90
+ constructor(success: boolean, message: string);
91
+ }
92
+ export declare class ComputeLogEntry {
93
+ id: number;
94
+ userEmail: string;
95
+ timestamp: string;
96
+ operation: string;
97
+ summary?: string;
98
+ cost: number;
99
+ creditsAfter: number;
100
+ constructor(id: number, userEmail: string, timestamp: string, operation: string, cost: number, creditsAfter: number, summary?: string);
101
+ }
@@ -0,0 +1,45 @@
1
+ export class SentMessage {
2
+ }
3
+ export class RuntimeInfo {
4
+ }
5
+ export class ExceptionInfo {
6
+ }
7
+ export class NotificationInput {
8
+ }
9
+ export class Notification {
10
+ }
11
+ export class TriggeredNotification {
12
+ }
13
+ export class ImportStats {
14
+ }
15
+ export class ImportResult {
16
+ }
17
+ export class UserStatistics {
18
+ }
19
+ export class VerificationRequestResult {
20
+ }
21
+ export class HostingUserInfo {
22
+ constructor(email, remainingCredits, hotWalletAddress, freeAccess = false) {
23
+ this.email = email;
24
+ this.remainingCredits = remainingCredits;
25
+ this.hotWalletAddress = hotWalletAddress;
26
+ this.freeAccess = freeAccess;
27
+ }
28
+ }
29
+ export class PaymentRequestResult {
30
+ constructor(success, message) {
31
+ this.success = success;
32
+ this.message = message;
33
+ }
34
+ }
35
+ export class ComputeLogEntry {
36
+ constructor(id, userEmail, timestamp, operation, cost, creditsAfter, summary) {
37
+ this.id = id;
38
+ this.userEmail = userEmail;
39
+ this.timestamp = timestamp;
40
+ this.operation = operation;
41
+ this.cost = cost;
42
+ this.creditsAfter = creditsAfter;
43
+ this.summary = summary;
44
+ }
45
+ }
@@ -93,6 +93,16 @@ input CapabilityInput {
93
93
  with: ResourceInput!
94
94
  }
95
95
 
96
+ type ComputeLogEntry {
97
+ cost: Float!
98
+ creditsAfter: Float!
99
+ id: Float!
100
+ operation: String!
101
+ summary: String
102
+ timestamp: String!
103
+ userEmail: String!
104
+ }
105
+
96
106
  # The javascript `Date` as string. Type represents date and time as the ISO Date string.
97
107
  scalar DateTime
98
108
 
@@ -390,6 +400,7 @@ type Mutation {
390
400
  runtimeRequestPayment(amountHOT: String!): PaymentRequestResult!
391
401
  runtimeRestartHolochain: Boolean!
392
402
  runtimeSendHot(amount: String!, recipient: String!): PaymentRequestResult!
403
+ runtimeSetFreeHostingEnabled(enabled: Boolean!): Boolean!
393
404
  runtimeSetHotWalletAddress(address: String!): Boolean!
394
405
  runtimeSetMultiUserEnabled(enabled: Boolean!): Boolean!
395
406
  runtimeSetStatus(status: PerspectiveInput!): Boolean!
@@ -501,9 +512,10 @@ type Query {
501
512
  perspective(uuid: String!): PerspectiveHandle
502
513
  perspectiveQueryLinks(query: LinkQuery!, uuid: String!): [LinkExpression!]
503
514
  perspectiveQueryProlog(query: String!, uuid: String!): String!
504
- perspectiveQuerySurrealDB(query: String!, uuid: String!): String!
505
515
  perspectiveSnapshot(uuid: String!): Perspective
506
516
  perspectives: [PerspectiveHandle!]!
517
+ runtimeComputeLog(limit: Float, since: String, userEmail: String): [ComputeLogEntry!]!
518
+ runtimeFreeHostingEnabled: Boolean!
507
519
  runtimeFriendStatus(did: String!): PerspectiveExpression
508
520
  runtimeFriends: [String!]!
509
521
  runtimeGetNetworkMetrics: String!
@@ -519,6 +531,7 @@ type Query {
519
531
  runtimeMessageOutbox(filter: String): [SentMessage!]!
520
532
  runtimeMultiUserEnabled: Boolean!
521
533
  runtimeNotifications: [Notification!]!
534
+ runtimeUnytAgentKey: String!
522
535
  runtimeUnytVersionInfo: String!
523
536
  runtimeVerifyStringSignedByDid(data: String!, did: String!, didSigningKeyId: String!, signedData: String!): Boolean!
524
537
  }
@@ -147,7 +147,7 @@ export declare class SHACLFlow {
147
147
  transitionUri(fromState: string, toState: string): string;
148
148
  /**
149
149
  * Serialize the flow to AD4M links
150
- * These links can be stored in a perspective and queried via SurrealDB
150
+ * These links can be stored in a perspective and queried via SPARQL
151
151
  *
152
152
  * @returns Array of Link objects representing the flow
153
153
  */
@@ -114,7 +114,7 @@ export class SHACLFlow {
114
114
  }
115
115
  /**
116
116
  * Serialize the flow to AD4M links
117
- * These links can be stored in a perspective and queried via SurrealDB
117
+ * These links can be stored in a perspective and queried via SPARQL
118
118
  *
119
119
  * @returns Array of Link objects representing the flow
120
120
  */
@@ -145,7 +145,7 @@ export class SHACLFlow {
145
145
  links.push({
146
146
  source: flowUri,
147
147
  predicate: "ad4m://flowable",
148
- target: `literal://string:${encodeURIComponent(JSON.stringify(this.flowable))}`
148
+ target: `literal:string:${encodeURIComponent(JSON.stringify(this.flowable))}`
149
149
  });
150
150
  }
151
151
  // Start action
@@ -153,7 +153,7 @@ export class SHACLFlow {
153
153
  links.push({
154
154
  source: flowUri,
155
155
  predicate: "ad4m://startAction",
156
- target: `literal://string:${encodeURIComponent(JSON.stringify(this.startAction))}`
156
+ target: `literal:string:${encodeURIComponent(JSON.stringify(this.startAction))}`
157
157
  });
158
158
  }
159
159
  // States
@@ -187,7 +187,7 @@ export class SHACLFlow {
187
187
  links.push({
188
188
  source: stateUri,
189
189
  predicate: "ad4m://stateCheck",
190
- target: `literal://string:${encodeURIComponent(JSON.stringify(state.stateCheck))}`
190
+ target: `literal:string:${encodeURIComponent(JSON.stringify(state.stateCheck))}`
191
191
  });
192
192
  }
193
193
  // Transitions
@@ -229,7 +229,7 @@ export class SHACLFlow {
229
229
  links.push({
230
230
  source: transitionUri,
231
231
  predicate: "ad4m://transitionActions",
232
- target: `literal://string:${encodeURIComponent(JSON.stringify(transition.actions))}`
232
+ target: `literal:string:${encodeURIComponent(JSON.stringify(transition.actions))}`
233
233
  });
234
234
  }
235
235
  return links;
@@ -261,7 +261,7 @@ export class SHACLFlow {
261
261
  }
262
262
  else {
263
263
  try {
264
- const jsonStr = flowableLink.target.replace('literal://string:', '');
264
+ const jsonStr = flowableLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
265
265
  flow.flowable = JSON.parse(decodeURIComponent(jsonStr));
266
266
  }
267
267
  catch {
@@ -273,7 +273,7 @@ export class SHACLFlow {
273
273
  const startActionLink = links.find(l => l.source === flowUri && l.predicate === "ad4m://startAction");
274
274
  if (startActionLink) {
275
275
  try {
276
- const jsonStr = startActionLink.target.replace('literal://string:', '');
276
+ const jsonStr = startActionLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
277
277
  flow.startAction = JSON.parse(decodeURIComponent(jsonStr));
278
278
  }
279
279
  catch {
@@ -299,7 +299,7 @@ export class SHACLFlow {
299
299
  let stateCheck = { predicate: "", target: "" };
300
300
  if (checkLink) {
301
301
  try {
302
- const jsonStr = checkLink.target.replace('literal://string:', '');
302
+ const jsonStr = checkLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
303
303
  stateCheck = JSON.parse(decodeURIComponent(jsonStr));
304
304
  }
305
305
  catch {
@@ -328,7 +328,7 @@ export class SHACLFlow {
328
328
  let actions = [];
329
329
  if (actionsLink) {
330
330
  try {
331
- const jsonStr = actionsLink.target.replace('literal://string:', '');
331
+ const jsonStr = actionsLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
332
332
  actions = JSON.parse(decodeURIComponent(jsonStr));
333
333
  }
334
334
  catch {
@@ -58,7 +58,7 @@ export interface SHACLPropertyShape {
58
58
  adder?: AD4MAction[];
59
59
  /** AD4M-specific: Remover action for collection properties */
60
60
  remover?: AD4MAction[];
61
- /** AD4M-specific: Pre-computed SurrealQL getter expression for reading this relation/property.
61
+ /** AD4M-specific: Pre-computed SPARQL getter expression for reading this relation/property.
62
62
  * For relations with a target model, this encodes conformance filtering
63
63
  * so that Rust/MCP can execute the exact same query as the JS runtime. */
64
64
  getter?: string;
@@ -69,6 +69,31 @@ export interface SHACLPropertyShape {
69
69
  * Set automatically when a relation has a `target` model. Enables typed construction
70
70
  * on the Rust/MCP side by referencing the full target shape. */
71
71
  class?: string;
72
+ /** sh:in — allowed values for this property (enum constraint).
73
+ * Each entry has a `value` (the RDF term) and an optional `label` (human-readable name).
74
+ * Standard SHACL `sh:in` only defines values; labels are an AD4M extension. */
75
+ in?: Array<{
76
+ value: string;
77
+ label?: string;
78
+ }>;
79
+ /** AD4M-specific: kind of relation this property describes.
80
+ * Drives direction (forward/reverse), scalar-vs-collection rendering,
81
+ * and default max-count. */
82
+ relationKind?: 'hasMany' | 'hasOne' | 'belongsToOne' | 'belongsToMany';
83
+ /** AD4M-specific: target class name (local-name) for a relation property.
84
+ * Complements `class` (the SHACL node-shape URI) by providing the bare
85
+ * model class name used by the executor to look up the target shape
86
+ * through the perspective's shape cache. */
87
+ targetClassName?: string;
88
+ /** AD4M-specific: post-getter where-clause filter for a relation property. */
89
+ whereFilter?: any;
90
+ /** AD4M-specific: predicate-IRI lookup map for `whereFilter` keys
91
+ * (property name → predicate URI on the target class). */
92
+ wherePredicates?: Record<string, string>;
93
+ /** AD4M-specific: whether conformance/type filtering is enabled for this
94
+ * relation. `false` opts out of DB-level type filtering while keeping
95
+ * hydration via `include`. */
96
+ filter?: boolean;
72
97
  }
73
98
  /**
74
99
  * SHACL Node Shape