@coasys/ad4m 0.13.0-test-2 → 0.13.0-test-4

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 (347) hide show
  1. package/README.md +2 -25
  2. package/jest-setup.ts +1 -1
  3. package/lib/index.cjs +2805 -10556
  4. package/lib/index.js +2513 -10322
  5. package/lib/src/Ad4mClient.d.ts +7 -3
  6. package/lib/src/Ad4mClient.js +29 -13
  7. package/lib/src/agent/Agent.js +26 -272
  8. package/lib/src/agent/AgentClient.d.ts +10 -21
  9. package/lib/src/agent/AgentClient.js +75 -427
  10. package/lib/src/agent/AgentStatus.js +2 -37
  11. package/lib/src/ai/AIClient.d.ts +12 -4
  12. package/lib/src/ai/AIClient.js +81 -285
  13. package/lib/src/ai/AITypes.d.ts +55 -0
  14. package/lib/src/ai/AITypes.js +18 -0
  15. package/lib/src/ai/Tasks.js +10 -133
  16. package/lib/src/apiClient.d.ts +52 -0
  17. package/lib/src/apiClient.js +231 -0
  18. package/lib/src/expression/Expression.d.ts +1 -1
  19. package/lib/src/expression/Expression.js +13 -122
  20. package/lib/src/expression/ExpressionClient.d.ts +3 -3
  21. package/lib/src/expression/ExpressionClient.js +13 -76
  22. package/lib/src/expression/ExpressionRef.js +2 -25
  23. package/lib/src/generated/api/AIModelLoadingStatus.d.ts +7 -0
  24. package/lib/src/generated/api/AIModelLoadingStatus.js +2 -0
  25. package/lib/src/generated/api/AddLinkExpressionRequest.d.ts +6 -0
  26. package/lib/src/generated/api/AddLinkExpressionRequest.js +1 -0
  27. package/lib/src/generated/api/AddLinkRequest.d.ts +6 -0
  28. package/lib/src/generated/api/AddLinkRequest.js +1 -0
  29. package/lib/src/generated/api/AddLinksBulkRequest.d.ts +6 -0
  30. package/lib/src/generated/api/AddLinksBulkRequest.js +1 -0
  31. package/lib/src/generated/api/AddSdnaRequest.d.ts +6 -0
  32. package/lib/src/generated/api/AddSdnaRequest.js +2 -0
  33. package/lib/src/generated/api/ApplyTemplateRequest.d.ts +4 -0
  34. package/lib/src/generated/api/ApplyTemplateRequest.js +2 -0
  35. package/lib/src/generated/api/AuthInfoInput.d.ts +10 -0
  36. package/lib/src/generated/api/AuthInfoInput.js +1 -0
  37. package/lib/src/generated/api/CapabilityInput.d.ts +5 -0
  38. package/lib/src/generated/api/CapabilityInput.js +1 -0
  39. package/lib/src/generated/api/CommitBatchRequest.d.ts +3 -0
  40. package/lib/src/generated/api/CommitBatchRequest.js +2 -0
  41. package/lib/src/generated/api/ComputeLogEntry.d.ts +9 -0
  42. package/lib/src/generated/api/ComputeLogEntry.js +2 -0
  43. package/lib/src/generated/api/CreateExpressionRequest.d.ts +4 -0
  44. package/lib/src/generated/api/CreateExpressionRequest.js +2 -0
  45. package/lib/src/generated/api/CreatePerspectiveRequest.d.ts +3 -0
  46. package/lib/src/generated/api/CreatePerspectiveRequest.js +2 -0
  47. package/lib/src/generated/api/CreateSubjectRequest.d.ts +6 -0
  48. package/lib/src/generated/api/CreateSubjectRequest.js +2 -0
  49. package/lib/src/generated/api/EmbedRequest.d.ts +4 -0
  50. package/lib/src/generated/api/EmbedRequest.js +2 -0
  51. package/lib/src/generated/api/EntanglementProofInput.d.ts +6 -0
  52. package/lib/src/generated/api/EntanglementProofInput.js +2 -0
  53. package/lib/src/generated/api/ExecuteCommandsRequest.d.ts +4 -0
  54. package/lib/src/generated/api/ExecuteCommandsRequest.js +2 -0
  55. package/lib/src/generated/api/ExportRequest.d.ts +5 -0
  56. package/lib/src/generated/api/ExportRequest.js +2 -0
  57. package/lib/src/generated/api/ExpressionManyRequest.d.ts +3 -0
  58. package/lib/src/generated/api/ExpressionManyRequest.js +2 -0
  59. package/lib/src/generated/api/ExpressionProof.d.ts +4 -0
  60. package/lib/src/generated/api/ExpressionProof.js +2 -0
  61. package/lib/src/generated/api/ExpressionProofInput.d.ts +6 -0
  62. package/lib/src/generated/api/ExpressionProofInput.js +2 -0
  63. package/lib/src/generated/api/FriendSendMessageRequest.d.ts +3 -0
  64. package/lib/src/generated/api/FriendSendMessageRequest.js +2 -0
  65. package/lib/src/generated/api/FriendsListRequest.d.ts +3 -0
  66. package/lib/src/generated/api/FriendsListRequest.js +2 -0
  67. package/lib/src/generated/api/GenerateAgentRequest.d.ts +3 -0
  68. package/lib/src/generated/api/GenerateAgentRequest.js +2 -0
  69. package/lib/src/generated/api/GenerateJwtRequest.d.ts +4 -0
  70. package/lib/src/generated/api/GenerateJwtRequest.js +2 -0
  71. package/lib/src/generated/api/GetSubjectDataRequest.d.ts +4 -0
  72. package/lib/src/generated/api/GetSubjectDataRequest.js +2 -0
  73. package/lib/src/generated/api/ImportAgentRequest.d.ts +6 -0
  74. package/lib/src/generated/api/ImportAgentRequest.js +2 -0
  75. package/lib/src/generated/api/ImportRequest.d.ts +4 -0
  76. package/lib/src/generated/api/ImportRequest.js +2 -0
  77. package/lib/src/generated/api/JoinNeighbourhoodRequest.d.ts +3 -0
  78. package/lib/src/generated/api/JoinNeighbourhoodRequest.js +2 -0
  79. package/lib/src/generated/api/LanguageMetaInput.d.ts +6 -0
  80. package/lib/src/generated/api/LanguageMetaInput.js +2 -0
  81. package/lib/src/generated/api/Link.d.ts +5 -0
  82. package/lib/src/generated/api/Link.js +2 -0
  83. package/lib/src/generated/api/LinkExpression.d.ts +10 -0
  84. package/lib/src/generated/api/LinkExpression.js +1 -0
  85. package/lib/src/generated/api/LinkExpressionInput.d.ts +10 -0
  86. package/lib/src/generated/api/LinkExpressionInput.js +1 -0
  87. package/lib/src/generated/api/LinkInput.d.ts +5 -0
  88. package/lib/src/generated/api/LinkInput.js +2 -0
  89. package/lib/src/generated/api/LinkLanguageTemplatesRequest.d.ts +3 -0
  90. package/lib/src/generated/api/LinkLanguageTemplatesRequest.js +2 -0
  91. package/lib/src/generated/api/LinkMutations.d.ts +6 -0
  92. package/lib/src/generated/api/LinkMutations.js +1 -0
  93. package/lib/src/generated/api/LinkStatus.d.ts +1 -0
  94. package/lib/src/generated/api/LinkStatus.js +2 -0
  95. package/lib/src/generated/api/LockAgentRequest.d.ts +3 -0
  96. package/lib/src/generated/api/LockAgentRequest.js +2 -0
  97. package/lib/src/generated/api/ModelType.d.ts +1 -0
  98. package/lib/src/generated/api/ModelType.js +2 -0
  99. package/lib/src/generated/api/NotificationInput.d.ts +10 -0
  100. package/lib/src/generated/api/NotificationInput.js +2 -0
  101. package/lib/src/generated/api/OpenLinkRequest.d.ts +3 -0
  102. package/lib/src/generated/api/OpenLinkRequest.js +2 -0
  103. package/lib/src/generated/api/PermitCapabilityRequest.d.ts +3 -0
  104. package/lib/src/generated/api/PermitCapabilityRequest.js +2 -0
  105. package/lib/src/generated/api/PerspectiveInput.d.ts +4 -0
  106. package/lib/src/generated/api/PerspectiveInput.js +1 -0
  107. package/lib/src/generated/api/PromptRequest.d.ts +4 -0
  108. package/lib/src/generated/api/PromptRequest.js +2 -0
  109. package/lib/src/generated/api/PublishLanguageRequest.d.ts +5 -0
  110. package/lib/src/generated/api/PublishLanguageRequest.js +1 -0
  111. package/lib/src/generated/api/PublishNeighbourhoodRequest.d.ts +6 -0
  112. package/lib/src/generated/api/PublishNeighbourhoodRequest.js +1 -0
  113. package/lib/src/generated/api/QueryRequest.d.ts +7 -0
  114. package/lib/src/generated/api/QueryRequest.js +2 -0
  115. package/lib/src/generated/api/RemoveLinkRequest.d.ts +5 -0
  116. package/lib/src/generated/api/RemoveLinkRequest.js +1 -0
  117. package/lib/src/generated/api/RemoveLinksBulkRequest.d.ts +5 -0
  118. package/lib/src/generated/api/RemoveLinksBulkRequest.js +1 -0
  119. package/lib/src/generated/api/ResourceInput.d.ts +4 -0
  120. package/lib/src/generated/api/ResourceInput.js +2 -0
  121. package/lib/src/generated/api/SetDefaultModelRequest.d.ts +4 -0
  122. package/lib/src/generated/api/SetDefaultModelRequest.js +1 -0
  123. package/lib/src/generated/api/SetFreeHostingEnabledRequest.d.ts +3 -0
  124. package/lib/src/generated/api/SetFreeHostingEnabledRequest.js +2 -0
  125. package/lib/src/generated/api/SetMultiUserRequest.d.ts +3 -0
  126. package/lib/src/generated/api/SetMultiUserRequest.js +2 -0
  127. package/lib/src/generated/api/SetStatusRequest.d.ts +3 -0
  128. package/lib/src/generated/api/SetStatusRequest.js +2 -0
  129. package/lib/src/generated/api/SignMessageRequest.d.ts +3 -0
  130. package/lib/src/generated/api/SignMessageRequest.js +2 -0
  131. package/lib/src/generated/api/TrustedAgentsRequest.d.ts +3 -0
  132. package/lib/src/generated/api/TrustedAgentsRequest.js +2 -0
  133. package/lib/src/generated/api/UnlockAgentRequest.d.ts +4 -0
  134. package/lib/src/generated/api/UnlockAgentRequest.js +2 -0
  135. package/lib/src/generated/api/UpdateLinkRequest.d.ts +7 -0
  136. package/lib/src/generated/api/UpdateLinkRequest.js +1 -0
  137. package/lib/src/generated/api/UpdatePerspectiveRequest.d.ts +3 -0
  138. package/lib/src/generated/api/UpdatePerspectiveRequest.js +2 -0
  139. package/lib/src/generated/api/UserStatistics.d.ts +9 -0
  140. package/lib/src/generated/api/UserStatistics.js +2 -0
  141. package/lib/src/generated/api/VerificationRequestResult.d.ts +6 -0
  142. package/lib/src/generated/api/VerificationRequestResult.js +2 -0
  143. package/lib/src/generated/api/VerifySignatureRequest.d.ts +5 -0
  144. package/lib/src/generated/api/VerifySignatureRequest.js +2 -0
  145. package/lib/src/generated/api/WriteSettingsRequest.d.ts +3 -0
  146. package/lib/src/generated/api/WriteSettingsRequest.js +2 -0
  147. package/lib/src/generated/api/index.d.ts +42 -0
  148. package/lib/src/generated/api/index.js +7 -0
  149. package/lib/src/index.d.ts +6 -2
  150. package/lib/src/index.js +6 -2
  151. package/lib/src/jestSetup.d.ts +0 -1
  152. package/lib/src/jestSetup.js +1 -1
  153. package/lib/src/language/Icon.js +2 -21
  154. package/lib/src/language/Language.d.ts +26 -214
  155. package/lib/src/language/Language.js +32 -72
  156. package/lib/src/language/LanguageClient.d.ts +2 -2
  157. package/lib/src/language/LanguageClient.js +15 -105
  158. package/lib/src/language/LanguageHandle.js +2 -41
  159. package/lib/src/language/LanguageMeta.js +4 -75
  160. package/lib/src/language/LanguageRef.js +2 -25
  161. package/lib/src/links/Links.js +14 -111
  162. package/lib/src/model/Ad4mModel.d.ts +81 -38
  163. package/lib/src/model/Ad4mModel.js +651 -408
  164. package/lib/src/model/Ad4mModel.test.js +488 -750
  165. package/lib/src/model/ModelQueryBuilder.d.ts +28 -21
  166. package/lib/src/model/ModelQueryBuilder.js +160 -195
  167. package/lib/src/model/decorators.d.ts +22 -0
  168. package/lib/src/model/decorators.js +7 -0
  169. package/lib/src/model/hydration-batching.test.d.ts +7 -0
  170. package/lib/src/model/hydration-batching.test.js +456 -0
  171. package/lib/src/model/hydration.d.ts +8 -60
  172. package/lib/src/model/hydration.js +41 -541
  173. package/lib/src/model/index.d.ts +0 -4
  174. package/lib/src/model/index.js +0 -4
  175. package/lib/src/model/model-manifest.d.ts +41 -0
  176. package/lib/src/model/model-manifest.js +11 -0
  177. package/lib/src/model/query-sparql.d.ts +36 -22
  178. package/lib/src/model/query-sparql.js +188 -53
  179. package/lib/src/model/query-sparql.test.d.ts +1 -0
  180. package/lib/src/model/query-sparql.test.js +312 -0
  181. package/lib/src/model/query-utils.js +4 -0
  182. package/lib/src/model/shacl-gen.js +4 -0
  183. package/lib/src/model/subscription-delta.test.d.ts +24 -0
  184. package/lib/src/model/subscription-delta.test.js +180 -0
  185. package/lib/src/model/subscription-pool.js +48 -2
  186. package/lib/src/model/types.d.ts +58 -1
  187. package/lib/src/model/types.js +4 -1
  188. package/lib/src/neighbourhood/Neighbourhood.js +4 -32
  189. package/lib/src/neighbourhood/NeighbourhoodClient.d.ts +3 -3
  190. package/lib/src/neighbourhood/NeighbourhoodClient.js +40 -203
  191. package/lib/src/perspectives/LinkQuery.js +2 -42
  192. package/lib/src/perspectives/Perspective.d.ts +1 -1
  193. package/lib/src/perspectives/Perspective.js +10 -52
  194. package/lib/src/perspectives/PerspectiveClient.d.ts +12 -15
  195. package/lib/src/perspectives/PerspectiveClient.js +168 -400
  196. package/lib/src/perspectives/PerspectiveClient.test.d.ts +1 -0
  197. package/lib/src/perspectives/PerspectiveClient.test.js +224 -0
  198. package/lib/src/perspectives/PerspectiveDiff.js +4 -31
  199. package/lib/src/perspectives/PerspectiveHandle.js +3 -43
  200. package/lib/src/perspectives/PerspectiveProxy.d.ts +95 -71
  201. package/lib/src/perspectives/PerspectiveProxy.js +288 -310
  202. package/lib/src/runtime/RuntimeClient.d.ts +6 -6
  203. package/lib/src/runtime/RuntimeClient.js +93 -467
  204. package/lib/src/runtime/RuntimeTypes.d.ts +101 -0
  205. package/lib/src/runtime/RuntimeTypes.js +45 -0
  206. package/lib/src/shacl/SHACLShape.d.ts +7 -0
  207. package/lib/src/shacl/SHACLShape.js +19 -0
  208. package/lib/src/shacl/SHACLShape.test.js +82 -0
  209. package/lib/src/typeDefs.js +3 -628
  210. package/package.json +9 -24
  211. package/rollup.config.js +0 -7
  212. package/src/Ad4mClient.test.ts +1182 -1288
  213. package/src/Ad4mClient.ts +30 -15
  214. package/src/agent/Agent.ts +0 -99
  215. package/src/agent/AgentClient.ts +112 -526
  216. package/src/agent/AgentStatus.ts +0 -12
  217. package/src/ai/AIClient.ts +96 -296
  218. package/src/ai/AITypes.ts +66 -0
  219. package/src/ai/Tasks.ts +0 -52
  220. package/src/apiClient.ts +283 -0
  221. package/src/expression/Expression.ts +3 -43
  222. package/src/expression/ExpressionClient.ts +14 -77
  223. package/src/expression/ExpressionRef.ts +0 -6
  224. package/src/generated/api/AIModelLoadingStatus.ts +3 -0
  225. package/src/generated/api/AddLinkExpressionRequest.ts +4 -0
  226. package/src/generated/api/AddLinkRequest.ts +4 -0
  227. package/src/generated/api/AddLinksBulkRequest.ts +4 -0
  228. package/src/generated/api/AddSdnaRequest.ts +3 -0
  229. package/src/generated/api/ApplyTemplateRequest.ts +3 -0
  230. package/src/generated/api/AuthInfoInput.ts +4 -0
  231. package/src/generated/api/CapabilityInput.ts +4 -0
  232. package/src/generated/api/CommitBatchRequest.ts +3 -0
  233. package/src/generated/api/ComputeLogEntry.ts +3 -0
  234. package/src/generated/api/CreateExpressionRequest.ts +3 -0
  235. package/src/generated/api/CreatePerspectiveRequest.ts +3 -0
  236. package/src/generated/api/CreateSubjectRequest.ts +3 -0
  237. package/src/generated/api/EmbedRequest.ts +3 -0
  238. package/src/generated/api/EntanglementProofInput.ts +3 -0
  239. package/src/generated/api/ExecuteCommandsRequest.ts +3 -0
  240. package/src/generated/api/ExportRequest.ts +3 -0
  241. package/src/generated/api/ExpressionManyRequest.ts +3 -0
  242. package/src/generated/api/ExpressionProof.ts +3 -0
  243. package/src/generated/api/ExpressionProofInput.ts +3 -0
  244. package/src/generated/api/FriendSendMessageRequest.ts +3 -0
  245. package/src/generated/api/FriendsListRequest.ts +3 -0
  246. package/src/generated/api/GenerateAgentRequest.ts +3 -0
  247. package/src/generated/api/GenerateJwtRequest.ts +3 -0
  248. package/src/generated/api/GetSubjectDataRequest.ts +3 -0
  249. package/src/generated/api/ImportAgentRequest.ts +3 -0
  250. package/src/generated/api/ImportRequest.ts +3 -0
  251. package/src/generated/api/JoinNeighbourhoodRequest.ts +3 -0
  252. package/src/generated/api/LanguageMetaInput.ts +3 -0
  253. package/src/generated/api/Link.ts +3 -0
  254. package/src/generated/api/LinkExpression.ts +6 -0
  255. package/src/generated/api/LinkExpressionInput.ts +6 -0
  256. package/src/generated/api/LinkInput.ts +3 -0
  257. package/src/generated/api/LinkLanguageTemplatesRequest.ts +3 -0
  258. package/src/generated/api/LinkMutations.ts +5 -0
  259. package/src/generated/api/LinkStatus.ts +3 -0
  260. package/src/generated/api/LockAgentRequest.ts +3 -0
  261. package/src/generated/api/ModelType.ts +3 -0
  262. package/src/generated/api/NotificationInput.ts +3 -0
  263. package/src/generated/api/OpenLinkRequest.ts +3 -0
  264. package/src/generated/api/PermitCapabilityRequest.ts +3 -0
  265. package/src/generated/api/PerspectiveInput.ts +4 -0
  266. package/src/generated/api/PromptRequest.ts +3 -0
  267. package/src/generated/api/PublishLanguageRequest.ts +4 -0
  268. package/src/generated/api/PublishNeighbourhoodRequest.ts +4 -0
  269. package/src/generated/api/QueryRequest.ts +6 -0
  270. package/src/generated/api/RemoveLinkRequest.ts +4 -0
  271. package/src/generated/api/RemoveLinksBulkRequest.ts +4 -0
  272. package/src/generated/api/ResourceInput.ts +3 -0
  273. package/src/generated/api/SetDefaultModelRequest.ts +4 -0
  274. package/src/generated/api/SetFreeHostingEnabledRequest.ts +3 -0
  275. package/src/generated/api/SetMultiUserRequest.ts +3 -0
  276. package/src/generated/api/SetStatusRequest.ts +3 -0
  277. package/src/generated/api/SignMessageRequest.ts +3 -0
  278. package/src/generated/api/TrustedAgentsRequest.ts +3 -0
  279. package/src/generated/api/UnlockAgentRequest.ts +3 -0
  280. package/src/generated/api/UpdateLinkRequest.ts +5 -0
  281. package/src/generated/api/UpdatePerspectiveRequest.ts +3 -0
  282. package/src/generated/api/UserStatistics.ts +3 -0
  283. package/src/generated/api/VerificationRequestResult.ts +3 -0
  284. package/src/generated/api/VerifySignatureRequest.ts +3 -0
  285. package/src/generated/api/WriteSettingsRequest.ts +3 -0
  286. package/src/generated/api/index.ts +49 -0
  287. package/src/index.ts +6 -2
  288. package/src/jestSetup.ts +1 -1
  289. package/src/language/Icon.ts +0 -4
  290. package/src/language/Language.ts +50 -292
  291. package/src/language/LanguageClient.ts +21 -132
  292. package/src/language/LanguageHandle.ts +0 -14
  293. package/src/language/LanguageMeta.ts +0 -29
  294. package/src/language/LanguageRef.ts +0 -7
  295. package/src/links/Links.ts +0 -37
  296. package/src/model/Ad4mModel.test.ts +827 -808
  297. package/src/model/Ad4mModel.ts +676 -457
  298. package/src/model/ModelQueryBuilder.ts +199 -217
  299. package/src/model/decorators.ts +29 -0
  300. package/src/model/hydration.ts +17 -572
  301. package/src/model/index.ts +0 -4
  302. package/src/model/query-sparql.test.ts +360 -0
  303. package/src/model/query-sparql.ts +203 -56
  304. package/src/model/query-utils.ts +4 -0
  305. package/src/model/shacl-gen.ts +5 -0
  306. package/src/model/types.ts +62 -1
  307. package/src/neighbourhood/Neighbourhood.ts +0 -9
  308. package/src/neighbourhood/NeighbourhoodClient.ts +42 -207
  309. package/src/neighbourhood/NeighbourhoodProxy.test.ts +34 -36
  310. package/src/perspectives/LinkQuery.ts +0 -15
  311. package/src/perspectives/Perspective.ts +1 -12
  312. package/src/perspectives/PerspectiveClient.test.ts +262 -0
  313. package/src/perspectives/PerspectiveClient.ts +227 -412
  314. package/src/perspectives/PerspectiveDiff.ts +0 -8
  315. package/src/perspectives/PerspectiveHandle.ts +1 -12
  316. package/src/perspectives/PerspectiveProxy.test.ts +41 -0
  317. package/src/perspectives/PerspectiveProxy.ts +325 -348
  318. package/src/runtime/RuntimeClient.ts +112 -474
  319. package/src/runtime/RuntimeTypes.ts +144 -0
  320. package/src/shacl/SHACLShape.test.ts +94 -0
  321. package/src/shacl/SHACLShape.ts +27 -0
  322. package/src/typeDefs.ts +3 -5
  323. package/tsconfig.json +3 -7
  324. package/lib/src/model/query-surreal.d.ts +0 -44
  325. package/lib/src/model/query-surreal.js +0 -249
  326. package/lib/src/model/surreal-utils.d.ts +0 -42
  327. package/lib/src/model/surreal-utils.js +0 -128
  328. package/shims/reflect-metadata.ts +0 -0
  329. package/shims/type-graphql.ts +0 -75
  330. package/src/PubSub.ts +0 -17
  331. package/src/agent/AgentResolver.ts +0 -263
  332. package/src/ai/AIResolver.ts +0 -372
  333. package/src/buildSchema.ts +0 -43
  334. package/src/expression/ExpressionResolver.ts +0 -64
  335. package/src/language/LanguageContext.ts +0 -37
  336. package/src/language/LanguageResolver.ts +0 -98
  337. package/src/model/Subject.ts +0 -159
  338. package/src/model/hydration-batch.ts +0 -205
  339. package/src/model/prolog-facts.ts +0 -145
  340. package/src/model/query-prolog.ts +0 -148
  341. package/src/model/query-sparql-batch.ts +0 -301
  342. package/src/model/subscription-pool.ts +0 -163
  343. package/src/neighbourhood/NeighbourhoodResolver.ts +0 -100
  344. package/src/perspectives/PerspectiveResolver.ts +0 -364
  345. package/src/runtime/RuntimeResolver.ts +0 -749
  346. package/src/unwrapApolloResult.ts +0 -16
  347. package/tsconfig-browser.json +0 -82
@@ -0,0 +1,144 @@
1
+ import { PerspectiveExpression } from "../perspectives/Perspective";
2
+ import { ExceptionType } from "../Exception";
3
+
4
+ export class SentMessage {
5
+ recipient: string;
6
+ message: PerspectiveExpression;
7
+ }
8
+
9
+ export class RuntimeInfo {
10
+ ad4mExecutorVersion: string;
11
+ isInitialized: Boolean;
12
+ isUnlocked: Boolean;
13
+ }
14
+
15
+ export class ExceptionInfo {
16
+ title: string;
17
+ message: string;
18
+ type: ExceptionType;
19
+ addon?: string;
20
+ }
21
+
22
+ export class NotificationInput {
23
+ description: string;
24
+ appName: string;
25
+ appUrl: string;
26
+ appIconPath: string;
27
+
28
+ // This is a query which will be executed on every perspective change.
29
+ // All matched unbound variables will be part of the triggerMatch, i.e.
30
+ // the content that will be sent to the launcher via event push
31
+ // and to the webhook.
32
+ trigger: string;
33
+
34
+ // List Perspectives this Notification is active on.
35
+ perspectiveIds: string[];
36
+
37
+ // URL to which the notification matches will be sent via POST
38
+ webhookUrl: string;
39
+
40
+ // Authentication bearer token to be sent via POST to the webhookUrl.
41
+ webhookAuth: string;
42
+ }
43
+
44
+ export class Notification {
45
+ id: string;
46
+ granted: boolean;
47
+ description: string;
48
+ appName: string;
49
+ appUrl: string;
50
+ appIconPath: string;
51
+ trigger: string;
52
+ perspectiveIds: string[];
53
+ webhookUrl: string;
54
+ webhookAuth: string;
55
+ }
56
+
57
+ export class TriggeredNotification {
58
+ notification: Notification;
59
+ perspectiveId: string;
60
+ triggerMatch: string;
61
+ }
62
+
63
+ export class ImportStats {
64
+ total: number;
65
+ imported: number;
66
+ failed: number;
67
+ omitted: number;
68
+ errors: string[];
69
+ }
70
+
71
+ export class ImportResult {
72
+ perspectives: ImportStats;
73
+ links: ImportStats;
74
+ expressions: ImportStats;
75
+ perspectiveDiffs: ImportStats;
76
+ notifications: ImportStats;
77
+ models: ImportStats;
78
+ defaultModels: ImportStats;
79
+ tasks: ImportStats;
80
+ friends: ImportStats;
81
+ trustedAgents: ImportStats;
82
+ knownLinkLanguages: ImportStats;
83
+ }
84
+
85
+ export class UserStatistics {
86
+ email: string;
87
+ did: string;
88
+ lastSeen?: string;
89
+ perspectiveCount: number;
90
+ remainingCredits: string;
91
+ freeAccess: boolean;
92
+ hotWalletAddress?: string;
93
+ }
94
+
95
+ export class VerificationRequestResult {
96
+ success: boolean;
97
+ message: string;
98
+ requiresPassword: boolean;
99
+ isExistingUser: boolean;
100
+ }
101
+
102
+ export class HostingUserInfo {
103
+ email: string;
104
+ remainingCredits: string;
105
+ hotWalletAddress?: string;
106
+ freeAccess: boolean;
107
+
108
+ constructor(email: string, remainingCredits: string, hotWalletAddress?: string, freeAccess: boolean = false) {
109
+ this.email = email;
110
+ this.remainingCredits = remainingCredits;
111
+ this.hotWalletAddress = hotWalletAddress;
112
+ this.freeAccess = freeAccess;
113
+ }
114
+ }
115
+
116
+ export class PaymentRequestResult {
117
+ success: boolean;
118
+ message: string;
119
+
120
+ constructor(success: boolean, message: string) {
121
+ this.success = success;
122
+ this.message = message;
123
+ }
124
+ }
125
+
126
+ export class ComputeLogEntry {
127
+ id: number;
128
+ userEmail: string;
129
+ timestamp: string;
130
+ operation: string;
131
+ summary?: string;
132
+ cost: number;
133
+ creditsAfter: number;
134
+
135
+ constructor(id: number, userEmail: string, timestamp: string, operation: string, cost: number, creditsAfter: number, summary?: string) {
136
+ this.id = id;
137
+ this.userEmail = userEmail;
138
+ this.timestamp = timestamp;
139
+ this.operation = operation;
140
+ this.cost = cost;
141
+ this.creditsAfter = creditsAfter;
142
+ this.summary = summary;
143
+ }
144
+ }
@@ -397,4 +397,98 @@ describe('SHACLShape', () => {
397
397
  expect(prop.remover).toEqual(original.properties[0].remover);
398
398
  });
399
399
  });
400
+
401
+ describe('sh:in round-trip', () => {
402
+ it('preserves sh:in enum values through toLinks() → fromLinks()', () => {
403
+ const original = new SHACLShape('test://Model');
404
+ original.addProperty({
405
+ name: 'status',
406
+ path: 'test://status',
407
+ datatype: 'xsd:string',
408
+ in: [
409
+ { value: 'active', label: 'Active' },
410
+ { value: 'inactive', label: 'Inactive' },
411
+ { value: 'archived' },
412
+ ],
413
+ });
414
+
415
+ const links = original.toLinks();
416
+
417
+ // Verify sh:in link was created
418
+ const inLink = links.find(l => l.predicate === 'sh://in');
419
+ expect(inLink).toBeDefined();
420
+ expect(inLink!.target).toContain('literal:string:');
421
+
422
+ // Reconstruct and verify
423
+ const reconstructed = SHACLShape.fromLinks(links, 'test://ModelShape');
424
+ expect(reconstructed.properties[0].in).toBeDefined();
425
+ expect(reconstructed.properties[0].in).toEqual([
426
+ { value: 'active', label: 'Active' },
427
+ { value: 'inactive', label: 'Inactive' },
428
+ { value: 'archived' },
429
+ ]);
430
+ });
431
+
432
+ it('handles sh:in with special characters in values', () => {
433
+ const original = new SHACLShape('test://Model');
434
+ original.addProperty({
435
+ name: 'category',
436
+ path: 'test://category',
437
+ in: [
438
+ { value: 'food & drink', label: 'Food & Drink' },
439
+ { value: 'arts/crafts' },
440
+ ],
441
+ });
442
+
443
+ const links = original.toLinks();
444
+ const reconstructed = SHACLShape.fromLinks(links, 'test://ModelShape');
445
+ expect(reconstructed.properties[0].in).toEqual(original.properties[0].in);
446
+ });
447
+
448
+ it('handles sh:in with empty array (no link created)', () => {
449
+ const original = new SHACLShape('test://Model');
450
+ original.addProperty({
451
+ name: 'field',
452
+ path: 'test://field',
453
+ in: [],
454
+ });
455
+
456
+ const links = original.toLinks();
457
+ const inLink = links.find(l => l.predicate === 'sh://in');
458
+ expect(inLink).toBeUndefined();
459
+ });
460
+
461
+ it('handles sh:in with literal://string: prefix variant', () => {
462
+ // fromLinks should handle both `literal:string:` and `literal://string:` prefixes
463
+ const links = [
464
+ { source: 'test://ModelShape', predicate: 'sh://targetClass', target: 'test://Model' },
465
+ { source: 'test://ModelShape', predicate: 'sh://property', target: 'test://Model.status' },
466
+ { source: 'test://Model.status', predicate: 'sh://path', target: 'test://status' },
467
+ { source: 'test://Model.status', predicate: 'sh://in', target: 'literal://string:[{"value":"a"},{"value":"b"}]' },
468
+ ];
469
+
470
+ const reconstructed = SHACLShape.fromLinks(links, 'test://ModelShape');
471
+ expect(reconstructed.properties[0].in).toEqual([
472
+ { value: 'a' },
473
+ { value: 'b' },
474
+ ]);
475
+ });
476
+
477
+ it('preserves sh:in through toJSON() → fromJSON()', () => {
478
+ const original = new SHACLShape('test://Model');
479
+ original.addProperty({
480
+ name: 'priority',
481
+ path: 'test://priority',
482
+ in: [
483
+ { value: 'high', label: 'High' },
484
+ { value: 'medium', label: 'Medium' },
485
+ { value: 'low', label: 'Low' },
486
+ ],
487
+ });
488
+
489
+ const json = original.toJSON();
490
+ const reconstructed = SHACLShape.fromJSON(json);
491
+ expect(reconstructed.properties[0].in).toEqual(original.properties[0].in);
492
+ });
493
+ });
400
494
  });
@@ -174,6 +174,11 @@ export interface SHACLPropertyShape {
174
174
  * Set automatically when a relation has a `target` model. Enables typed construction
175
175
  * on the Rust/MCP side by referencing the full target shape. */
176
176
  class?: string;
177
+
178
+ /** sh:in — allowed values for this property (enum constraint).
179
+ * Each entry has a `value` (the RDF term) and an optional `label` (human-readable name).
180
+ * Standard SHACL `sh:in` only defines values; labels are an AD4M extension. */
181
+ in?: Array<{ value: string; label?: string }>;
177
182
  }
178
183
 
179
184
  /**
@@ -545,6 +550,14 @@ export class SHACLShape {
545
550
  target: prop.class
546
551
  });
547
552
  }
553
+
554
+ if (prop.in && prop.in.length > 0) {
555
+ links.push({
556
+ source: propShapeId,
557
+ predicate: "sh://in",
558
+ target: `literal:string:${JSON.stringify(prop.in)}`
559
+ });
560
+ }
548
561
  }
549
562
 
550
563
  return links;
@@ -775,6 +788,18 @@ export class SHACLShape {
775
788
  prop.class = classLink.target;
776
789
  }
777
790
 
791
+ const inLink = links.find(l =>
792
+ l.source === propShapeId && l.predicate === "sh://in"
793
+ );
794
+ if (inLink) {
795
+ try {
796
+ const jsonStr = inLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
797
+ prop.in = JSON.parse(jsonStr);
798
+ } catch (e) {
799
+ // Ignore parse errors
800
+ }
801
+ }
802
+
778
803
  shape.addProperty(prop);
779
804
  }
780
805
 
@@ -812,6 +837,7 @@ export class SHACLShape {
812
837
  getter: p.getter,
813
838
  conformance_conditions: p.conformanceConditions,
814
839
  class: p.class,
840
+ in: p.in,
815
841
  })),
816
842
  constructor_actions: this.constructor_actions,
817
843
  destructor_actions: this.destructor_actions,
@@ -847,6 +873,7 @@ export class SHACLShape {
847
873
  getter: p.getter,
848
874
  conformanceConditions: p.conformance_conditions,
849
875
  class: p.class,
876
+ in: p.in,
850
877
  });
851
878
  }
852
879
 
package/src/typeDefs.ts CHANGED
@@ -1,6 +1,4 @@
1
- // This is just a placeholder for the TS version of the index file.
2
- // buildSchema over-writes lib/typeDefs.js after tsc has run.
3
- // This way lib/index.js can stay the compiled version of index.ts,
4
- // where index.ts imports this file...
1
+ // Placeholder for type definition string.
2
+ // Previously generated by buildSchema; kept for backward compatibility.
5
3
 
6
- export const typeDefsString = ""
4
+ export const typeDefsString = ""
package/tsconfig.json CHANGED
@@ -1,16 +1,12 @@
1
1
  {
2
- "include": ["./src/**/*.ts", "./src/*.ts", "./shims"],
3
- "exclude": ["./src/*.test.ts", "./src/*.test.ts"],
2
+ "include": ["./src/**/*.ts", "./src/*.ts"],
3
+ "exclude": ["./src/*.test.ts", "./src/**/*.test.ts"],
4
4
  "compilerOptions": {
5
5
  /* Visit https://aka.ms/tsconfig.json to read more about this file */
6
- // "paths": {
7
- // "type-graphql": ["./shims/type-graphql.ts"],
8
- // "reflect-metadata": ["./shims/reflect-metadata.ts"]
9
- // },
10
6
  /* Basic Options */
11
7
  // "incremental": true, /* Enable incremental compilation */
12
8
  "target": "es2020", /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019', 'es2015', or 'ESNEXT'. */
13
- "lib": ["es2020", "esnext.asynciterable"],
9
+ "lib": ["es2020", "esnext.asynciterable", "dom"],
14
10
  "module": "es2020", /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', 'es2020', or 'ESNext'. */
15
11
  // "lib": [], /* Specify library files to be included in the compilation. */
16
12
  // "allowJs": true, /* Allow javascript files to be compiled. */
@@ -1,44 +0,0 @@
1
- /**
2
- * SurrealQL query building utilities for Ad4mModel.
3
- *
4
- * Contains the graph-traversal WHERE clause builder, legacy
5
- * subquery-based clause builders, SELECT-field builders, and
6
- * the main `buildSurrealQLQuery()` function that produces a
7
- * complete SurrealQL query string from a `Query` object.
8
- *
9
- * All functions are stateless — model metadata and relation metadata
10
- * are passed in as parameters instead of accessed via `this`.
11
- *
12
- * @module
13
- */
14
- import type { RelationMetadataEntry } from "./decorators";
15
- import type { Where, Query, ModelMetadata } from "./types";
16
- /**
17
- * Builds WHERE clause filters using SurrealDB graph traversal syntax.
18
- *
19
- * Translates where conditions into `->link[WHERE ...]` / `<-link[WHERE ...]`
20
- * filters that SurrealDB can optimize via graph indexes.
21
- *
22
- * @param metadata - Model metadata from `getModelMetadata()`
23
- * @param allRelationsMetadata - Full relation metadata (needed for belongs-to
24
- * direction detection)
25
- * @param where - User-supplied where conditions
26
- * @returns Combined AND-joined condition string, or empty string
27
- */
28
- export declare function buildGraphTraversalWhereClause(metadata: ModelMetadata, allRelationsMetadata: Record<string, RelationMetadataEntry>, where?: Where): string;
29
- /**
30
- * Builds a complete SurrealQL query from a Query object and model metadata.
31
- *
32
- * This is the core implementation behind `Ad4mModel.queryToSurrealQL()`.
33
- * It produces a graph-traversal query that:
34
- * 1. Filters nodes by required predicates (conformance check)
35
- * 2. Applies user WHERE conditions
36
- * 3. Fetches all outgoing links for hydration
37
- *
38
- * @param metadata - Model metadata from `getModelMetadata()`
39
- * @param allRelationsMetadata - Full relation registry (for belongs-to detection)
40
- * @param query - Query parameters
41
- * @param modelClass - The model class (for `resolveParentPredicate`)
42
- * @returns Complete SurrealQL query string
43
- */
44
- export declare function buildSurrealQLQuery(metadata: ModelMetadata, allRelationsMetadata: Record<string, RelationMetadataEntry>, query: Query, modelClass: any): string;
@@ -1,249 +0,0 @@
1
- /**
2
- * SurrealQL query building utilities for Ad4mModel.
3
- *
4
- * Contains the graph-traversal WHERE clause builder, legacy
5
- * subquery-based clause builders, SELECT-field builders, and
6
- * the main `buildSurrealQLQuery()` function that produces a
7
- * complete SurrealQL query string from a `Query` object.
8
- *
9
- * All functions are stateless — model metadata and relation metadata
10
- * are passed in as parameters instead of accessed via `this`.
11
- *
12
- * @module
13
- */
14
- import { escapeSurrealString } from "../utils";
15
- import { formatSurrealValue } from "./surreal-utils";
16
- import { resolveParentPredicate } from "./query-common";
17
- // ─── Graph Traversal WHERE Clause ────────────────────────────────────────────
18
- /**
19
- * Builds WHERE clause filters using SurrealDB graph traversal syntax.
20
- *
21
- * Translates where conditions into `->link[WHERE ...]` / `<-link[WHERE ...]`
22
- * filters that SurrealDB can optimize via graph indexes.
23
- *
24
- * @param metadata - Model metadata from `getModelMetadata()`
25
- * @param allRelationsMetadata - Full relation metadata (needed for belongs-to
26
- * direction detection)
27
- * @param where - User-supplied where conditions
28
- * @returns Combined AND-joined condition string, or empty string
29
- */
30
- export function buildGraphTraversalWhereClause(metadata, allRelationsMetadata, where) {
31
- if (!where)
32
- return '';
33
- const conditions = [];
34
- for (const [propertyName, condition] of Object.entries(where)) {
35
- const isSpecial = ['id', 'author', 'timestamp'].includes(propertyName);
36
- if (isSpecial) {
37
- if (propertyName === 'author' || propertyName === 'timestamp') {
38
- continue; // Filtered post-query in JS
39
- }
40
- const columnName = 'uri';
41
- if (Array.isArray(condition)) {
42
- const formattedValues = condition.map(v => formatSurrealValue(v)).join(', ');
43
- conditions.push(`${columnName} IN [${formattedValues}]`);
44
- }
45
- else if (typeof condition === 'object' && condition !== null) {
46
- const ops = condition;
47
- if (ops.not !== undefined) {
48
- if (Array.isArray(ops.not)) {
49
- const formattedValues = ops.not.map(v => formatSurrealValue(v)).join(', ');
50
- conditions.push(`${columnName} NOT IN [${formattedValues}]`);
51
- }
52
- else {
53
- conditions.push(`${columnName} != ${formatSurrealValue(ops.not)}`);
54
- }
55
- }
56
- if (ops.between !== undefined && Array.isArray(ops.between) && ops.between.length === 2) {
57
- conditions.push(`${columnName} >= ${formatSurrealValue(ops.between[0])} AND ${columnName} <= ${formatSurrealValue(ops.between[1])}`);
58
- }
59
- if (ops.gt !== undefined) {
60
- conditions.push(`${columnName} > ${formatSurrealValue(ops.gt)}`);
61
- }
62
- if (ops.gte !== undefined) {
63
- conditions.push(`${columnName} >= ${formatSurrealValue(ops.gte)}`);
64
- }
65
- if (ops.lt !== undefined) {
66
- conditions.push(`${columnName} < ${formatSurrealValue(ops.lt)}`);
67
- }
68
- if (ops.lte !== undefined) {
69
- conditions.push(`${columnName} <= ${formatSurrealValue(ops.lte)}`);
70
- }
71
- if (ops.contains !== undefined) {
72
- conditions.push(`${columnName} CONTAINS ${formatSurrealValue(ops.contains)}`);
73
- }
74
- }
75
- else {
76
- conditions.push(`${columnName} = ${formatSurrealValue(condition)}`);
77
- }
78
- }
79
- else {
80
- // Regular properties — check relation metadata first for direction
81
- const relMeta = allRelationsMetadata[propertyName];
82
- const isBelongs = relMeta?.kind === 'belongsToOne' || relMeta?.kind === 'belongsToMany';
83
- if (relMeta) {
84
- const predicate = escapeSurrealString(relMeta.predicate);
85
- if (Array.isArray(condition)) {
86
- const formattedValues = condition.map(v => formatSurrealValue(v)).join(', ');
87
- if (isBelongs) {
88
- conditions.push(`count(<-link[WHERE predicate = '${predicate}' AND in.uri IN [${formattedValues}]]) > 0`);
89
- }
90
- else {
91
- conditions.push(`count(->link[WHERE predicate = '${predicate}' AND out.uri IN [${formattedValues}]]) > 0`);
92
- }
93
- }
94
- else if (typeof condition === 'object' && condition !== null) {
95
- const ops = condition;
96
- if (ops.not !== undefined) {
97
- if (Array.isArray(ops.not)) {
98
- const formattedValues = ops.not.map(v => formatSurrealValue(v)).join(', ');
99
- if (isBelongs) {
100
- conditions.push(`count(<-link[WHERE predicate = '${predicate}' AND in.uri IN [${formattedValues}]]) = 0`);
101
- }
102
- else {
103
- conditions.push(`count(->link[WHERE predicate = '${predicate}' AND out.uri IN [${formattedValues}]]) = 0`);
104
- }
105
- }
106
- else {
107
- if (isBelongs) {
108
- conditions.push(`count(<-link[WHERE predicate = '${predicate}' AND in.uri = ${formatSurrealValue(ops.not)}]) = 0`);
109
- }
110
- else {
111
- conditions.push(`count(->link[WHERE predicate = '${predicate}' AND out.uri = ${formatSurrealValue(ops.not)}]) = 0`);
112
- }
113
- }
114
- }
115
- }
116
- else {
117
- if (isBelongs) {
118
- conditions.push(`count(<-link[WHERE predicate = '${predicate}' AND in.uri = ${formatSurrealValue(condition)}]) > 0`);
119
- }
120
- else {
121
- conditions.push(`count(->link[WHERE predicate = '${predicate}' AND out.uri = ${formatSurrealValue(condition)}]) > 0`);
122
- }
123
- }
124
- continue;
125
- }
126
- const propMeta = metadata.properties[propertyName];
127
- if (!propMeta)
128
- continue;
129
- const predicate = escapeSurrealString(propMeta.predicate);
130
- const targetField = propMeta.resolveLanguage === 'literal' ? 'fn::parse_literal(out.uri)' : 'out.uri';
131
- if (Array.isArray(condition)) {
132
- const formattedValues = condition.map(v => formatSurrealValue(v)).join(', ');
133
- conditions.push(`count(->link[WHERE predicate = '${predicate}' AND ${targetField} IN [${formattedValues}]]) > 0`);
134
- }
135
- else if (typeof condition === 'object' && condition !== null) {
136
- const ops = condition;
137
- if (ops.not !== undefined) {
138
- if (Array.isArray(ops.not)) {
139
- const formattedValues = ops.not.map(v => formatSurrealValue(v)).join(', ');
140
- conditions.push(`count(->link[WHERE predicate = '${predicate}' AND ${targetField} IN [${formattedValues}]]) = 0`);
141
- }
142
- else {
143
- conditions.push(`count(->link[WHERE predicate = '${predicate}' AND ${targetField} = ${formatSurrealValue(ops.not)}]) = 0`);
144
- }
145
- }
146
- const hasComparisonOps = ops.gt !== undefined || ops.gte !== undefined ||
147
- ops.lt !== undefined || ops.lte !== undefined ||
148
- ops.between !== undefined || ops.contains !== undefined;
149
- if (hasComparisonOps) {
150
- conditions.push(`count(->link[WHERE predicate = '${predicate}']) > 0`);
151
- }
152
- }
153
- else {
154
- conditions.push(`count(->link[WHERE predicate = '${predicate}' AND ${targetField} = ${formatSurrealValue(condition)}]) > 0`);
155
- }
156
- }
157
- }
158
- return conditions.join(' AND ');
159
- }
160
- // ─── Main Query Builder ─────────────────────────────────────────────────────
161
- /**
162
- * Builds a complete SurrealQL query from a Query object and model metadata.
163
- *
164
- * This is the core implementation behind `Ad4mModel.queryToSurrealQL()`.
165
- * It produces a graph-traversal query that:
166
- * 1. Filters nodes by required predicates (conformance check)
167
- * 2. Applies user WHERE conditions
168
- * 3. Fetches all outgoing links for hydration
169
- *
170
- * @param metadata - Model metadata from `getModelMetadata()`
171
- * @param allRelationsMetadata - Full relation registry (for belongs-to detection)
172
- * @param query - Query parameters
173
- * @param modelClass - The model class (for `resolveParentPredicate`)
174
- * @returns Complete SurrealQL query string
175
- */
176
- export function buildSurrealQLQuery(metadata, allRelationsMetadata, query, modelClass) {
177
- const { where } = query;
178
- // Build graph traversal filters for required predicates
179
- const graphTraversalFilters = [];
180
- // Parent filter
181
- if (query.parent) {
182
- const parentPredicate = resolveParentPredicate(query.parent, modelClass);
183
- graphTraversalFilters.push(`count(<-link[WHERE in.uri = ${formatSurrealValue(query.parent.id)} AND predicate = '${escapeSurrealString(parentPredicate)}']) > 0`);
184
- }
185
- // Required property filters
186
- for (const [, propMeta] of Object.entries(metadata.properties)) {
187
- if (propMeta.required) {
188
- if (propMeta.getter)
189
- continue;
190
- if (propMeta.flag && propMeta.initial) {
191
- graphTraversalFilters.push(`count(->link[WHERE predicate = '${escapeSurrealString(propMeta.predicate)}' AND out.uri = '${escapeSurrealString(propMeta.initial)}']) > 0`);
192
- }
193
- else {
194
- graphTraversalFilters.push(`count(->link[WHERE predicate = '${escapeSurrealString(propMeta.predicate)}']) > 0`);
195
- }
196
- }
197
- }
198
- // Fallback: initial-value filters
199
- if (graphTraversalFilters.length === 0) {
200
- for (const [, propMeta] of Object.entries(metadata.properties)) {
201
- if (propMeta.initial) {
202
- if (propMeta.flag) {
203
- graphTraversalFilters.push(`count(->link[WHERE predicate = '${escapeSurrealString(propMeta.predicate)}' AND out.uri = '${escapeSurrealString(propMeta.initial)}']) > 0`);
204
- }
205
- else {
206
- graphTraversalFilters.push(`count(->link[WHERE predicate = '${escapeSurrealString(propMeta.predicate)}']) > 0`);
207
- }
208
- break;
209
- }
210
- }
211
- }
212
- // Fallback: open-world structural matching
213
- if (graphTraversalFilters.length === 0) {
214
- const structuralPredicates = [];
215
- for (const [, propMeta] of Object.entries(metadata.properties)) {
216
- if (propMeta.predicate) {
217
- structuralPredicates.push(`predicate = '${escapeSurrealString(propMeta.predicate)}'`);
218
- }
219
- }
220
- if (metadata.relations) {
221
- for (const [, relMeta] of Object.entries(metadata.relations)) {
222
- if (relMeta.predicate) {
223
- structuralPredicates.push(`predicate = '${escapeSurrealString(relMeta.predicate)}'`);
224
- }
225
- }
226
- }
227
- if (structuralPredicates.length > 0) {
228
- graphTraversalFilters.push(`count(->link[WHERE (${structuralPredicates.join(' OR ')})]) > 0`);
229
- }
230
- }
231
- // User WHERE clause
232
- const userWhereClause = buildGraphTraversalWhereClause(metadata, allRelationsMetadata, where);
233
- const whereConditions = [];
234
- whereConditions.push(...graphTraversalFilters);
235
- if (userWhereClause) {
236
- whereConditions.push(userWhereClause);
237
- }
238
- whereConditions.push(`count(->link) > 0`);
239
- const fullQuery = `
240
- SELECT
241
- id AS source,
242
- uri AS source_uri,
243
- ->link AS links
244
- FROM node
245
- WHERE ${whereConditions.join(' AND ')}
246
- FETCH links
247
- `.trim();
248
- return fullQuery;
249
- }
@@ -1,42 +0,0 @@
1
- /**
2
- * Shared SurrealQL compilation utilities.
3
- *
4
- * These functions are used by both the runtime query builder (`Ad4mModel`) and
5
- * the compile-time SHACL generator (`decorators.ts`).
6
- */
7
- import type { WhereCondition, Where, ModelMetadata } from "./types";
8
- /**
9
- * Format a JavaScript value for embedding in a SurrealQL expression.
10
- *
11
- * - Strings are single-quoted with backslash / quote / newline escaping
12
- * - Numbers and booleans are passed through as-is
13
- * - Arrays are recursed
14
- */
15
- export declare function formatSurrealValue(value: any): string;
16
- /**
17
- * Compile a single Where condition for a property into a SurrealQL
18
- * graph-traversal sub-expression.
19
- *
20
- * Operates on the **target node** — generates `count(->link[WHERE ...]) > 0`
21
- * style checks that can be used inside a `[WHERE ...]` filter on nodes.
22
- *
23
- * @param predicate - The predicate URI for the property
24
- * @param condition - The Where condition value
25
- * @param opts - Optional settings (e.g. `resolveLanguage`)
26
- * @returns A single SurrealQL condition string
27
- */
28
- export declare function buildWhereCondition(predicate: string, condition: WhereCondition, opts?: {
29
- resolveLanguage?: string;
30
- }): string;
31
- /**
32
- * Compile a full `Where` clause to an array of SurrealQL condition strings.
33
- *
34
- * When `metadata` is provided, property names are resolved to predicates
35
- * using the model's property metadata. When `metadata` is `null`, property
36
- * names are treated as raw predicate URIs.
37
- *
38
- * Only handles **regular properties** — special fields (`id`, `author`,
39
- * `timestamp`) and relation fields are skipped (they are only relevant at
40
- * runtime query time, not for compile-time getter generation).
41
- */
42
- export declare function compileWhereClause(where: Where, metadata: ModelMetadata | null): string[];