@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
@@ -161,7 +161,7 @@ export interface SHACLPropertyShape {
161
161
  /** AD4M-specific: Remover action for collection properties */
162
162
  remover?: AD4MAction[];
163
163
 
164
- /** AD4M-specific: Pre-computed SurrealQL getter expression for reading this relation/property.
164
+ /** AD4M-specific: Pre-computed SPARQL getter expression for reading this relation/property.
165
165
  * For relations with a target model, this encodes conformance filtering
166
166
  * so that Rust/MCP can execute the exact same query as the JS runtime. */
167
167
  getter?: string;
@@ -174,6 +174,34 @@ 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 }>;
182
+
183
+ /** AD4M-specific: kind of relation this property describes.
184
+ * Drives direction (forward/reverse), scalar-vs-collection rendering,
185
+ * and default max-count. */
186
+ relationKind?: 'hasMany' | 'hasOne' | 'belongsToOne' | 'belongsToMany';
187
+
188
+ /** AD4M-specific: target class name (local-name) for a relation property.
189
+ * Complements `class` (the SHACL node-shape URI) by providing the bare
190
+ * model class name used by the executor to look up the target shape
191
+ * through the perspective's shape cache. */
192
+ targetClassName?: string;
193
+
194
+ /** AD4M-specific: post-getter where-clause filter for a relation property. */
195
+ whereFilter?: any;
196
+
197
+ /** AD4M-specific: predicate-IRI lookup map for `whereFilter` keys
198
+ * (property name → predicate URI on the target class). */
199
+ wherePredicates?: Record<string, string>;
200
+
201
+ /** AD4M-specific: whether conformance/type filtering is enabled for this
202
+ * relation. `false` opts out of DB-level type filtering while keeping
203
+ * hydration via `include`. */
204
+ filter?: boolean;
177
205
  }
178
206
 
179
207
  /**
@@ -363,7 +391,7 @@ export class SHACLShape {
363
391
  links.push({
364
392
  source: this.nodeShapeUri,
365
393
  predicate: "ad4m://constructor",
366
- target: `literal://string:${JSON.stringify(this.constructor_actions)}`
394
+ target: `literal:string:${JSON.stringify(this.constructor_actions)}`
367
395
  });
368
396
  }
369
397
 
@@ -372,7 +400,7 @@ export class SHACLShape {
372
400
  links.push({
373
401
  source: this.nodeShapeUri,
374
402
  predicate: "ad4m://destructor",
375
- target: `literal://string:${JSON.stringify(this.destructor_actions)}`
403
+ target: `literal:string:${JSON.stringify(this.destructor_actions)}`
376
404
  });
377
405
  }
378
406
 
@@ -428,7 +456,7 @@ export class SHACLShape {
428
456
  links.push({
429
457
  source: propShapeId,
430
458
  predicate: "sh://minCount",
431
- target: `literal://${prop.minCount}^^xsd:integer`
459
+ target: `literal:${prop.minCount}^^xsd:integer`
432
460
  });
433
461
  }
434
462
 
@@ -436,7 +464,7 @@ export class SHACLShape {
436
464
  links.push({
437
465
  source: propShapeId,
438
466
  predicate: "sh://maxCount",
439
- target: `literal://${prop.maxCount}^^xsd:integer`
467
+ target: `literal:${prop.maxCount}^^xsd:integer`
440
468
  });
441
469
  }
442
470
 
@@ -444,7 +472,7 @@ export class SHACLShape {
444
472
  links.push({
445
473
  source: propShapeId,
446
474
  predicate: "sh://pattern",
447
- target: `literal://${prop.pattern}`
475
+ target: `literal:${prop.pattern}`
448
476
  });
449
477
  }
450
478
 
@@ -452,7 +480,7 @@ export class SHACLShape {
452
480
  links.push({
453
481
  source: propShapeId,
454
482
  predicate: "sh://minInclusive",
455
- target: `literal://${prop.minInclusive}`
483
+ target: `literal:${prop.minInclusive}`
456
484
  });
457
485
  }
458
486
 
@@ -460,7 +488,7 @@ export class SHACLShape {
460
488
  links.push({
461
489
  source: propShapeId,
462
490
  predicate: "sh://maxInclusive",
463
- target: `literal://${prop.maxInclusive}`
491
+ target: `literal:${prop.maxInclusive}`
464
492
  });
465
493
  }
466
494
 
@@ -468,7 +496,7 @@ export class SHACLShape {
468
496
  links.push({
469
497
  source: propShapeId,
470
498
  predicate: "sh://hasValue",
471
- target: `literal://${prop.hasValue}`
499
+ target: `literal:${prop.hasValue}`
472
500
  });
473
501
  }
474
502
 
@@ -477,7 +505,7 @@ export class SHACLShape {
477
505
  links.push({
478
506
  source: propShapeId,
479
507
  predicate: "ad4m://local",
480
- target: `literal://${prop.local}`
508
+ target: `literal:${prop.local}`
481
509
  });
482
510
  }
483
511
 
@@ -485,7 +513,7 @@ export class SHACLShape {
485
513
  links.push({
486
514
  source: propShapeId,
487
515
  predicate: "ad4m://writable",
488
- target: `literal://${prop.writable}`
516
+ target: `literal:${prop.writable}`
489
517
  });
490
518
  }
491
519
 
@@ -493,7 +521,7 @@ export class SHACLShape {
493
521
  links.push({
494
522
  source: propShapeId,
495
523
  predicate: "ad4m://resolveLanguage",
496
- target: `literal://string:${prop.resolveLanguage}`
524
+ target: `literal:string:${prop.resolveLanguage}`
497
525
  });
498
526
  }
499
527
 
@@ -502,7 +530,7 @@ export class SHACLShape {
502
530
  links.push({
503
531
  source: propShapeId,
504
532
  predicate: "ad4m://setter",
505
- target: `literal://string:${JSON.stringify(prop.setter)}`
533
+ target: `literal:string:${JSON.stringify(prop.setter)}`
506
534
  });
507
535
  }
508
536
 
@@ -510,7 +538,7 @@ export class SHACLShape {
510
538
  links.push({
511
539
  source: propShapeId,
512
540
  predicate: "ad4m://adder",
513
- target: `literal://string:${JSON.stringify(prop.adder)}`
541
+ target: `literal:string:${JSON.stringify(prop.adder)}`
514
542
  });
515
543
  }
516
544
 
@@ -518,7 +546,7 @@ export class SHACLShape {
518
546
  links.push({
519
547
  source: propShapeId,
520
548
  predicate: "ad4m://remover",
521
- target: `literal://string:${JSON.stringify(prop.remover)}`
549
+ target: `literal:string:${JSON.stringify(prop.remover)}`
522
550
  });
523
551
  }
524
552
 
@@ -526,7 +554,7 @@ export class SHACLShape {
526
554
  links.push({
527
555
  source: propShapeId,
528
556
  predicate: "ad4m://getter",
529
- target: `literal://string:${prop.getter}`
557
+ target: `literal:string:${prop.getter}`
530
558
  });
531
559
  }
532
560
 
@@ -534,7 +562,7 @@ export class SHACLShape {
534
562
  links.push({
535
563
  source: propShapeId,
536
564
  predicate: "ad4m://conformanceConditions",
537
- target: `literal://string:${JSON.stringify(prop.conformanceConditions)}`
565
+ target: `literal:string:${JSON.stringify(prop.conformanceConditions)}`
538
566
  });
539
567
  }
540
568
 
@@ -545,6 +573,54 @@ export class SHACLShape {
545
573
  target: prop.class
546
574
  });
547
575
  }
576
+
577
+ if (prop.in && prop.in.length > 0) {
578
+ links.push({
579
+ source: propShapeId,
580
+ predicate: "sh://in",
581
+ target: `literal:string:${JSON.stringify(prop.in)}`
582
+ });
583
+ }
584
+
585
+ if (prop.relationKind) {
586
+ links.push({
587
+ source: propShapeId,
588
+ predicate: "ad4m://relationKind",
589
+ target: `literal:string:${prop.relationKind}`
590
+ });
591
+ }
592
+
593
+ if (prop.targetClassName) {
594
+ links.push({
595
+ source: propShapeId,
596
+ predicate: "ad4m://targetClassName",
597
+ target: `literal:string:${prop.targetClassName}`
598
+ });
599
+ }
600
+
601
+ if (prop.whereFilter !== undefined && prop.whereFilter !== null) {
602
+ links.push({
603
+ source: propShapeId,
604
+ predicate: "ad4m://whereFilter",
605
+ target: `literal:string:${JSON.stringify(prop.whereFilter)}`
606
+ });
607
+ }
608
+
609
+ if (prop.wherePredicates && Object.keys(prop.wherePredicates).length > 0) {
610
+ links.push({
611
+ source: propShapeId,
612
+ predicate: "ad4m://wherePredicates",
613
+ target: `literal:string:${JSON.stringify(prop.wherePredicates)}`
614
+ });
615
+ }
616
+
617
+ if (prop.filter !== undefined) {
618
+ links.push({
619
+ source: propShapeId,
620
+ predicate: "ad4m://filter",
621
+ target: `literal:${prop.filter}`
622
+ });
623
+ }
548
624
  }
549
625
 
550
626
  return links;
@@ -567,7 +643,7 @@ export class SHACLShape {
567
643
  );
568
644
  if (constructorLink) {
569
645
  try {
570
- const jsonStr = constructorLink.target.replace('literal://string:', '');
646
+ const jsonStr = constructorLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
571
647
  shape.constructor_actions = JSON.parse(jsonStr);
572
648
  } catch (e) {
573
649
  // Ignore parse errors
@@ -580,7 +656,7 @@ export class SHACLShape {
580
656
  );
581
657
  if (destructorLink) {
582
658
  try {
583
- const jsonStr = destructorLink.target.replace('literal://string:', '');
659
+ const jsonStr = destructorLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
584
660
  shape.destructor_actions = JSON.parse(jsonStr);
585
661
  } catch (e) {
586
662
  // Ignore parse errors
@@ -634,8 +710,8 @@ export class SHACLShape {
634
710
  l.source === propShapeId && l.predicate === "sh://minCount"
635
711
  );
636
712
  if (minCountLink) {
637
- // Handle both formats: literal://5^^xsd:integer and literal://number:5
638
- let val = minCountLink.target.replace('literal://', '').replace(/\^\^.*$/, '');
713
+ // Handle both formats: literal:5^^xsd:integer and literal:number:5
714
+ let val = minCountLink.target.replace(/^literal:\/\/|^literal:/, '').replace(/\^\^.*$/, '');
639
715
  if (val.startsWith('number:')) val = val.substring(7);
640
716
  prop.minCount = parseInt(val);
641
717
  }
@@ -644,8 +720,8 @@ export class SHACLShape {
644
720
  l.source === propShapeId && l.predicate === "sh://maxCount"
645
721
  );
646
722
  if (maxCountLink) {
647
- // Handle both formats: literal://5^^xsd:integer and literal://number:5
648
- let val = maxCountLink.target.replace('literal://', '').replace(/\^\^.*$/, '');
723
+ // Handle both formats: literal:5^^xsd:integer and literal:number:5
724
+ let val = maxCountLink.target.replace(/^literal:\/\/|^literal:/, '').replace(/\^\^.*$/, '');
649
725
  if (val.startsWith('number:')) val = val.substring(7);
650
726
  prop.maxCount = parseInt(val);
651
727
  }
@@ -654,15 +730,15 @@ export class SHACLShape {
654
730
  l.source === propShapeId && l.predicate === "sh://pattern"
655
731
  );
656
732
  if (patternLink) {
657
- prop.pattern = patternLink.target.replace('literal://', '');
733
+ prop.pattern = patternLink.target.replace(/^literal:\/\/|^literal:/, '');
658
734
  }
659
735
 
660
736
  const minInclusiveLink = links.find(l =>
661
737
  l.source === propShapeId && l.predicate === "sh://minInclusive"
662
738
  );
663
739
  if (minInclusiveLink) {
664
- // Handle both formats: literal://5 and literal://number:5
665
- let val = minInclusiveLink.target.replace('literal://', '');
740
+ // Handle both formats: literal:5 and literal:number:5
741
+ let val = minInclusiveLink.target.replace(/^literal:\/\/|^literal:/, '');
666
742
  if (val.startsWith('number:')) val = val.substring(7);
667
743
  prop.minInclusive = parseFloat(val);
668
744
  }
@@ -671,8 +747,8 @@ export class SHACLShape {
671
747
  l.source === propShapeId && l.predicate === "sh://maxInclusive"
672
748
  );
673
749
  if (maxInclusiveLink) {
674
- // Handle both formats: literal://5 and literal://number:5
675
- let val = maxInclusiveLink.target.replace('literal://', '');
750
+ // Handle both formats: literal:5 and literal:number:5
751
+ let val = maxInclusiveLink.target.replace(/^literal:\/\/|^literal:/, '');
676
752
  if (val.startsWith('number:')) val = val.substring(7);
677
753
  prop.maxInclusive = parseFloat(val);
678
754
  }
@@ -681,7 +757,7 @@ export class SHACLShape {
681
757
  l.source === propShapeId && l.predicate === "sh://hasValue"
682
758
  );
683
759
  if (hasValueLink) {
684
- prop.hasValue = hasValueLink.target.replace('literal://', '');
760
+ prop.hasValue = hasValueLink.target.replace(/^literal:\/\/|^literal:/, '');
685
761
  }
686
762
 
687
763
  // AD4M-specific
@@ -689,8 +765,8 @@ export class SHACLShape {
689
765
  l.source === propShapeId && l.predicate === "ad4m://local"
690
766
  );
691
767
  if (localLink) {
692
- // Handle both formats: literal://true and literal://boolean:true
693
- let val = localLink.target.replace('literal://', '');
768
+ // Handle both formats: literal:true and literal:boolean:true
769
+ let val = localLink.target.replace(/^literal:\/\/|^literal:/, '');
694
770
  if (val.startsWith('boolean:')) val = val.substring(8);
695
771
  prop.local = val === 'true';
696
772
  }
@@ -699,8 +775,8 @@ export class SHACLShape {
699
775
  l.source === propShapeId && l.predicate === "ad4m://writable"
700
776
  );
701
777
  if (writableLink) {
702
- // Handle both formats: literal://true and literal://boolean:true
703
- let val = writableLink.target.replace('literal://', '');
778
+ // Handle both formats: literal:true and literal:boolean:true
779
+ let val = writableLink.target.replace(/^literal:\/\/|^literal:/, '');
704
780
  if (val.startsWith('boolean:')) val = val.substring(8);
705
781
  prop.writable = val === 'true';
706
782
  }
@@ -709,7 +785,7 @@ export class SHACLShape {
709
785
  l.source === propShapeId && l.predicate === "ad4m://resolveLanguage"
710
786
  );
711
787
  if (resolveLangLink) {
712
- prop.resolveLanguage = resolveLangLink.target.replace('literal://string:', '');
788
+ prop.resolveLanguage = resolveLangLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
713
789
  }
714
790
 
715
791
  // Parse action arrays
@@ -718,7 +794,7 @@ export class SHACLShape {
718
794
  );
719
795
  if (setterLink) {
720
796
  try {
721
- const jsonStr = setterLink.target.replace('literal://string:', '');
797
+ const jsonStr = setterLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
722
798
  prop.setter = JSON.parse(jsonStr);
723
799
  } catch (e) {
724
800
  // Ignore parse errors
@@ -730,7 +806,7 @@ export class SHACLShape {
730
806
  );
731
807
  if (adderLink) {
732
808
  try {
733
- const jsonStr = adderLink.target.replace('literal://string:', '');
809
+ const jsonStr = adderLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
734
810
  prop.adder = JSON.parse(jsonStr);
735
811
  } catch (e) {
736
812
  // Ignore parse errors
@@ -742,7 +818,7 @@ export class SHACLShape {
742
818
  );
743
819
  if (removerLink) {
744
820
  try {
745
- const jsonStr = removerLink.target.replace('literal://string:', '');
821
+ const jsonStr = removerLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
746
822
  prop.remover = JSON.parse(jsonStr);
747
823
  } catch (e) {
748
824
  // Ignore parse errors
@@ -753,7 +829,7 @@ export class SHACLShape {
753
829
  l.source === propShapeId && l.predicate === "ad4m://getter"
754
830
  );
755
831
  if (getterLink) {
756
- prop.getter = getterLink.target.replace('literal://string:', '');
832
+ prop.getter = getterLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
757
833
  }
758
834
 
759
835
  const conditionsLink = links.find(l =>
@@ -761,7 +837,7 @@ export class SHACLShape {
761
837
  );
762
838
  if (conditionsLink) {
763
839
  try {
764
- const jsonStr = conditionsLink.target.replace('literal://string:', '');
840
+ const jsonStr = conditionsLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
765
841
  prop.conformanceConditions = JSON.parse(jsonStr);
766
842
  } catch (e) {
767
843
  // Ignore parse errors
@@ -775,6 +851,70 @@ export class SHACLShape {
775
851
  prop.class = classLink.target;
776
852
  }
777
853
 
854
+ const inLink = links.find(l =>
855
+ l.source === propShapeId && l.predicate === "sh://in"
856
+ );
857
+ if (inLink) {
858
+ try {
859
+ const jsonStr = inLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
860
+ prop.in = JSON.parse(jsonStr);
861
+ } catch (e) {
862
+ // Ignore parse errors
863
+ }
864
+ }
865
+
866
+ const relationKindLink = links.find(l =>
867
+ l.source === propShapeId && l.predicate === "ad4m://relationKind"
868
+ );
869
+ if (relationKindLink) {
870
+ const val = relationKindLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
871
+ if (val === 'hasMany' || val === 'hasOne' || val === 'belongsToOne' || val === 'belongsToMany') {
872
+ prop.relationKind = val;
873
+ }
874
+ }
875
+
876
+ const targetClassNameLink = links.find(l =>
877
+ l.source === propShapeId && l.predicate === "ad4m://targetClassName"
878
+ );
879
+ if (targetClassNameLink) {
880
+ prop.targetClassName = targetClassNameLink.target.replace(
881
+ /^literal:\/\/string:|^literal:string:/, ''
882
+ );
883
+ }
884
+
885
+ const whereFilterLink = links.find(l =>
886
+ l.source === propShapeId && l.predicate === "ad4m://whereFilter"
887
+ );
888
+ if (whereFilterLink) {
889
+ try {
890
+ const jsonStr = whereFilterLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
891
+ prop.whereFilter = JSON.parse(jsonStr);
892
+ } catch (e) {
893
+ // Ignore parse errors
894
+ }
895
+ }
896
+
897
+ const wherePredicatesLink = links.find(l =>
898
+ l.source === propShapeId && l.predicate === "ad4m://wherePredicates"
899
+ );
900
+ if (wherePredicatesLink) {
901
+ try {
902
+ const jsonStr = wherePredicatesLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
903
+ prop.wherePredicates = JSON.parse(jsonStr);
904
+ } catch (e) {
905
+ // Ignore parse errors
906
+ }
907
+ }
908
+
909
+ const filterLink = links.find(l =>
910
+ l.source === propShapeId && l.predicate === "ad4m://filter"
911
+ );
912
+ if (filterLink) {
913
+ let val = filterLink.target.replace(/^literal:\/\/|^literal:/, '');
914
+ if (val.startsWith('boolean:')) val = val.substring(8);
915
+ prop.filter = val === 'true';
916
+ }
917
+
778
918
  shape.addProperty(prop);
779
919
  }
780
920
 
@@ -812,6 +952,12 @@ export class SHACLShape {
812
952
  getter: p.getter,
813
953
  conformance_conditions: p.conformanceConditions,
814
954
  class: p.class,
955
+ in: p.in,
956
+ relation_kind: p.relationKind,
957
+ target_class_name: p.targetClassName,
958
+ where_filter: p.whereFilter,
959
+ where_predicates: p.wherePredicates,
960
+ filter: p.filter,
815
961
  })),
816
962
  constructor_actions: this.constructor_actions,
817
963
  destructor_actions: this.destructor_actions,
@@ -847,6 +993,12 @@ export class SHACLShape {
847
993
  getter: p.getter,
848
994
  conformanceConditions: p.conformance_conditions,
849
995
  class: p.class,
996
+ in: p.in,
997
+ relationKind: p.relation_kind,
998
+ targetClassName: p.target_class_name,
999
+ whereFilter: p.where_filter,
1000
+ wherePredicates: p.where_predicates,
1001
+ filter: p.filter,
850
1002
  });
851
1003
  }
852
1004
 
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/src/utils.ts CHANGED
@@ -25,28 +25,28 @@ export function capSentence(cap) {
25
25
  }
26
26
 
27
27
  /**
28
- * Escapes a string value for safe use in SurrealQL queries.
28
+ * Escapes a string value for safe use in query strings.
29
29
  *
30
30
  * @description
31
31
  * Prevents SQL injection by properly escaping special characters in string values
32
- * that will be interpolated into SurrealQL queries. This handles the most common
32
+ * that will be interpolated into query strings. This handles the most common
33
33
  * special characters that could break SQL queries or enable injection attacks.
34
34
  *
35
35
  * Single quotes, backslashes, and other special characters are escaped using
36
- * backslash notation, which is the standard escaping mechanism for SurrealQL.
36
+ * backslash notation, which is the standard escaping mechanism for query.
37
37
  *
38
38
  * @param value - The string value to escape
39
- * @returns The escaped string safe for SurrealQL interpolation (without surrounding quotes)
39
+ * @returns The escaped string safe for query interpolation (without surrounding quotes)
40
40
  *
41
41
  * @example
42
42
  * ```typescript
43
43
  * const userInput = "user's input with 'quotes'";
44
- * const escaped = escapeSurrealString(userInput);
44
+ * const escaped = escapeQueryString(userInput);
45
45
  * const query = `SELECT * FROM link WHERE uri = '${escaped}'`;
46
46
  * // Results in: SELECT * FROM link WHERE uri = 'user\'s input with \'quotes\''
47
47
  * ```
48
48
  */
49
- export function escapeSurrealString(value: string): string {
49
+ export function escapeQueryString(value: string): string {
50
50
  return value
51
51
  .replace(/\\/g, '\\\\') // Backslash -> \\
52
52
  .replace(/'/g, "\\'") // Single quote -> \'
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;