@cratis/chronicle 6.59.0 → 6.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (525) hide show
  1. package/ChronicleClient.ts +1 -1
  2. package/ChronicleOptions.ts +11 -0
  3. package/EventStore.ts +9 -1
  4. package/IEventStore.ts +7 -0
  5. package/README.md +1 -1
  6. package/artifacts/DefaultClientArtifactsProvider.ts +13 -1
  7. package/artifacts/IClientArtifactsProvider.ts +6 -0
  8. package/dist/ChronicleClient.js +1 -1
  9. package/dist/ChronicleClient.js.map +1 -1
  10. package/dist/ChronicleOptions.d.ts +7 -0
  11. package/dist/ChronicleOptions.d.ts.map +1 -1
  12. package/dist/ChronicleOptions.js +8 -0
  13. package/dist/ChronicleOptions.js.map +1 -1
  14. package/dist/EventStore.d.ts +3 -1
  15. package/dist/EventStore.d.ts.map +1 -1
  16. package/dist/EventStore.js +7 -1
  17. package/dist/EventStore.js.map +1 -1
  18. package/dist/IEventStore.d.ts +6 -0
  19. package/dist/IEventStore.d.ts.map +1 -1
  20. package/dist/artifacts/DefaultClientArtifactsProvider.d.ts +4 -0
  21. package/dist/artifacts/DefaultClientArtifactsProvider.d.ts.map +1 -1
  22. package/dist/artifacts/DefaultClientArtifactsProvider.js +11 -1
  23. package/dist/artifacts/DefaultClientArtifactsProvider.js.map +1 -1
  24. package/dist/artifacts/IClientArtifactsProvider.d.ts +4 -0
  25. package/dist/artifacts/IClientArtifactsProvider.d.ts.map +1 -1
  26. package/dist/projections/ChildrenOrderingNotSupportedByContracts.d.ts +15 -0
  27. package/dist/projections/ChildrenOrderingNotSupportedByContracts.d.ts.map +1 -0
  28. package/dist/projections/ChildrenOrderingNotSupportedByContracts.js +22 -0
  29. package/dist/projections/ChildrenOrderingNotSupportedByContracts.js.map +1 -0
  30. package/dist/projections/InvalidCausedByProperty.d.ts +10 -0
  31. package/dist/projections/InvalidCausedByProperty.d.ts.map +1 -0
  32. package/dist/projections/InvalidCausedByProperty.js +16 -0
  33. package/dist/projections/InvalidCausedByProperty.js.map +1 -0
  34. package/dist/projections/Projections.d.ts.map +1 -1
  35. package/dist/projections/Projections.js +7 -30
  36. package/dist/projections/Projections.js.map +1 -1
  37. package/dist/projections/causedBy.d.ts +15 -0
  38. package/dist/projections/causedBy.d.ts.map +1 -0
  39. package/dist/projections/causedBy.js +24 -0
  40. package/dist/projections/causedBy.js.map +1 -0
  41. package/dist/projections/childrenOrdering.d.ts +38 -0
  42. package/dist/projections/childrenOrdering.d.ts.map +1 -0
  43. package/dist/projections/childrenOrdering.js +37 -0
  44. package/dist/projections/childrenOrdering.js.map +1 -0
  45. package/dist/projections/childrenOrderingSupport.d.ts +14 -0
  46. package/dist/projections/childrenOrderingSupport.d.ts.map +1 -0
  47. package/dist/projections/childrenOrderingSupport.js +37 -0
  48. package/dist/projections/childrenOrderingSupport.js.map +1 -0
  49. package/dist/projections/declarative/AllSetBuilder.d.ts +3 -0
  50. package/dist/projections/declarative/AllSetBuilder.d.ts.map +1 -1
  51. package/dist/projections/declarative/AllSetBuilder.js +6 -0
  52. package/dist/projections/declarative/AllSetBuilder.js.map +1 -1
  53. package/dist/projections/declarative/ChildrenBuilder.d.ts +9 -0
  54. package/dist/projections/declarative/ChildrenBuilder.d.ts.map +1 -1
  55. package/dist/projections/declarative/ChildrenBuilder.js +29 -1
  56. package/dist/projections/declarative/ChildrenBuilder.js.map +1 -1
  57. package/dist/projections/declarative/ChildrenOrderingAlreadyDefined.d.ts +6 -0
  58. package/dist/projections/declarative/ChildrenOrderingAlreadyDefined.d.ts.map +1 -0
  59. package/dist/projections/declarative/ChildrenOrderingAlreadyDefined.js +11 -0
  60. package/dist/projections/declarative/ChildrenOrderingAlreadyDefined.js.map +1 -0
  61. package/dist/projections/declarative/DictionaryKey.d.ts +48 -0
  62. package/dist/projections/declarative/DictionaryKey.d.ts.map +1 -0
  63. package/dist/projections/declarative/DictionaryKey.js +82 -0
  64. package/dist/projections/declarative/DictionaryKey.js.map +1 -0
  65. package/dist/projections/declarative/FromAllBuilder.d.ts +2 -0
  66. package/dist/projections/declarative/FromAllBuilder.d.ts.map +1 -1
  67. package/dist/projections/declarative/FromAllBuilder.js +5 -0
  68. package/dist/projections/declarative/FromAllBuilder.js.map +1 -1
  69. package/dist/projections/declarative/FromBuilder.d.ts +18 -6
  70. package/dist/projections/declarative/FromBuilder.d.ts.map +1 -1
  71. package/dist/projections/declarative/FromBuilder.js +34 -31
  72. package/dist/projections/declarative/FromBuilder.js.map +1 -1
  73. package/dist/projections/declarative/FromEveryBuilder.d.ts +2 -0
  74. package/dist/projections/declarative/FromEveryBuilder.d.ts.map +1 -1
  75. package/dist/projections/declarative/FromEveryBuilder.js +7 -0
  76. package/dist/projections/declarative/FromEveryBuilder.js.map +1 -1
  77. package/dist/projections/declarative/IAllSetBuilder.d.ts +7 -0
  78. package/dist/projections/declarative/IAllSetBuilder.d.ts.map +1 -1
  79. package/dist/projections/declarative/IChildrenBuilder.d.ts +19 -0
  80. package/dist/projections/declarative/IChildrenBuilder.d.ts.map +1 -1
  81. package/dist/projections/declarative/IFromAllBuilder.d.ts +6 -0
  82. package/dist/projections/declarative/IFromAllBuilder.d.ts.map +1 -1
  83. package/dist/projections/declarative/IFromEveryBuilder.d.ts +6 -0
  84. package/dist/projections/declarative/IFromEveryBuilder.d.ts.map +1 -1
  85. package/dist/projections/declarative/IReadModelPropertiesBuilder.d.ts +37 -6
  86. package/dist/projections/declarative/IReadModelPropertiesBuilder.d.ts.map +1 -1
  87. package/dist/projections/declarative/ISetBuilder.d.ts +7 -0
  88. package/dist/projections/declarative/ISetBuilder.d.ts.map +1 -1
  89. package/dist/projections/declarative/InvalidDictionaryKey.d.ts +10 -0
  90. package/dist/projections/declarative/InvalidDictionaryKey.d.ts.map +1 -0
  91. package/dist/projections/declarative/InvalidDictionaryKey.js +16 -0
  92. package/dist/projections/declarative/InvalidDictionaryKey.js.map +1 -0
  93. package/dist/projections/declarative/JoinBuilder.d.ts +18 -6
  94. package/dist/projections/declarative/JoinBuilder.d.ts.map +1 -1
  95. package/dist/projections/declarative/JoinBuilder.js +34 -31
  96. package/dist/projections/declarative/JoinBuilder.js.map +1 -1
  97. package/dist/projections/declarative/ProjectionBuilderCore.d.ts +2 -0
  98. package/dist/projections/declarative/ProjectionBuilderCore.d.ts.map +1 -1
  99. package/dist/projections/declarative/ProjectionBuilderCore.js.map +1 -1
  100. package/dist/projections/declarative/SetBuilder.d.ts +3 -0
  101. package/dist/projections/declarative/SetBuilder.d.ts.map +1 -1
  102. package/dist/projections/declarative/SetBuilder.js +6 -0
  103. package/dist/projections/declarative/SetBuilder.js.map +1 -1
  104. package/dist/projections/declarative/index.d.ts +4 -0
  105. package/dist/projections/declarative/index.d.ts.map +1 -1
  106. package/dist/projections/declarative/index.js +3 -0
  107. package/dist/projections/declarative/index.js.map +1 -1
  108. package/dist/projections/for_Graphs/given/a_discovered_graph.d.ts +29 -0
  109. package/dist/projections/for_Graphs/given/a_discovered_graph.d.ts.map +1 -0
  110. package/dist/projections/for_Graphs/given/a_discovered_graph.js +19 -0
  111. package/dist/projections/for_Graphs/given/a_discovered_graph.js.map +1 -0
  112. package/dist/projections/for_Graphs/given/a_fake_connection.d.ts +24 -0
  113. package/dist/projections/for_Graphs/given/a_fake_connection.d.ts.map +1 -0
  114. package/dist/projections/for_Graphs/given/a_fake_connection.js +17 -0
  115. package/dist/projections/for_Graphs/given/a_fake_connection.js.map +1 -0
  116. package/dist/projections/for_Graphs/given/organization.d.ts +43 -0
  117. package/dist/projections/for_Graphs/given/organization.d.ts.map +1 -0
  118. package/dist/projections/for_Graphs/given/organization.js +84 -0
  119. package/dist/projections/for_Graphs/given/organization.js.map +1 -0
  120. package/dist/projections/graphs/EdgeCanHaveOnlyOneIdentifyingKey.d.ts +11 -0
  121. package/dist/projections/graphs/EdgeCanHaveOnlyOneIdentifyingKey.d.ts.map +1 -0
  122. package/dist/projections/graphs/EdgeCanHaveOnlyOneIdentifyingKey.js +16 -0
  123. package/dist/projections/graphs/EdgeCanHaveOnlyOneIdentifyingKey.js.map +1 -0
  124. package/dist/projections/graphs/EdgeMustHaveOneSourceAndOneTarget.d.ts +11 -0
  125. package/dist/projections/graphs/EdgeMustHaveOneSourceAndOneTarget.d.ts.map +1 -0
  126. package/dist/projections/graphs/EdgeMustHaveOneSourceAndOneTarget.js +16 -0
  127. package/dist/projections/graphs/EdgeMustHaveOneSourceAndOneTarget.js.map +1 -0
  128. package/dist/projections/graphs/GraphDeclaredMoreThanOnce.d.ts +11 -0
  129. package/dist/projections/graphs/GraphDeclaredMoreThanOnce.d.ts.map +1 -0
  130. package/dist/projections/graphs/GraphDeclaredMoreThanOnce.js +16 -0
  131. package/dist/projections/graphs/GraphDeclaredMoreThanOnce.js.map +1 -0
  132. package/dist/projections/graphs/GraphDefinitionBuilder.d.ts +24 -0
  133. package/dist/projections/graphs/GraphDefinitionBuilder.d.ts.map +1 -0
  134. package/dist/projections/graphs/GraphDefinitionBuilder.js +148 -0
  135. package/dist/projections/graphs/GraphDefinitionBuilder.js.map +1 -0
  136. package/dist/projections/graphs/GraphEdgeBuilder.d.ts +41 -0
  137. package/dist/projections/graphs/GraphEdgeBuilder.d.ts.map +1 -0
  138. package/dist/projections/graphs/GraphEdgeBuilder.js +94 -0
  139. package/dist/projections/graphs/GraphEdgeBuilder.js.map +1 -0
  140. package/dist/projections/graphs/GraphEdgeFromBuilder.d.ts +25 -0
  141. package/dist/projections/graphs/GraphEdgeFromBuilder.d.ts.map +1 -0
  142. package/dist/projections/graphs/GraphEdgeFromBuilder.js +37 -0
  143. package/dist/projections/graphs/GraphEdgeFromBuilder.js.map +1 -0
  144. package/dist/projections/graphs/GraphEdgeFromModel.d.ts +16 -0
  145. package/dist/projections/graphs/GraphEdgeFromModel.d.ts.map +1 -0
  146. package/dist/projections/graphs/GraphEdgeFromModel.js +4 -0
  147. package/dist/projections/graphs/GraphEdgeFromModel.js.map +1 -0
  148. package/dist/projections/graphs/GraphEdgeModel.d.ts +24 -0
  149. package/dist/projections/graphs/GraphEdgeModel.d.ts.map +1 -0
  150. package/dist/projections/graphs/GraphEdgeModel.js +4 -0
  151. package/dist/projections/graphs/GraphEdgeModel.js.map +1 -0
  152. package/dist/projections/graphs/GraphEdgeRemovedWithBuilder.d.ts +21 -0
  153. package/dist/projections/graphs/GraphEdgeRemovedWithBuilder.d.ts.map +1 -0
  154. package/dist/projections/graphs/GraphEdgeRemovedWithBuilder.js +31 -0
  155. package/dist/projections/graphs/GraphEdgeRemovedWithBuilder.js.map +1 -0
  156. package/dist/projections/graphs/GraphEdgeRemovedWithModel.d.ts +14 -0
  157. package/dist/projections/graphs/GraphEdgeRemovedWithModel.d.ts.map +1 -0
  158. package/dist/projections/graphs/GraphEdgeRemovedWithModel.js +4 -0
  159. package/dist/projections/graphs/GraphEdgeRemovedWithModel.js.map +1 -0
  160. package/dist/projections/graphs/GraphElementCannotBeReadModel.d.ts +11 -0
  161. package/dist/projections/graphs/GraphElementCannotBeReadModel.d.ts.map +1 -0
  162. package/dist/projections/graphs/GraphElementCannotBeReadModel.js +16 -0
  163. package/dist/projections/graphs/GraphElementCannotBeReadModel.js.map +1 -0
  164. package/dist/projections/graphs/GraphHasDuplicateElement.d.ts +13 -0
  165. package/dist/projections/graphs/GraphHasDuplicateElement.d.ts.map +1 -0
  166. package/dist/projections/graphs/GraphHasDuplicateElement.js +18 -0
  167. package/dist/projections/graphs/GraphHasDuplicateElement.js.map +1 -0
  168. package/dist/projections/graphs/GraphKeyPropertyNotFound.d.ts +12 -0
  169. package/dist/projections/graphs/GraphKeyPropertyNotFound.d.ts.map +1 -0
  170. package/dist/projections/graphs/GraphKeyPropertyNotFound.js +17 -0
  171. package/dist/projections/graphs/GraphKeyPropertyNotFound.js.map +1 -0
  172. package/dist/projections/graphs/GraphMappingBuilder.d.ts +32 -0
  173. package/dist/projections/graphs/GraphMappingBuilder.d.ts.map +1 -0
  174. package/dist/projections/graphs/GraphMappingBuilder.js +48 -0
  175. package/dist/projections/graphs/GraphMappingBuilder.js.map +1 -0
  176. package/dist/projections/graphs/GraphMemberMappings.d.ts +9 -0
  177. package/dist/projections/graphs/GraphMemberMappings.d.ts.map +1 -0
  178. package/dist/projections/graphs/GraphMemberMappings.js +59 -0
  179. package/dist/projections/graphs/GraphMemberMappings.js.map +1 -0
  180. package/dist/projections/graphs/GraphModel.d.ts +15 -0
  181. package/dist/projections/graphs/GraphModel.d.ts.map +1 -0
  182. package/dist/projections/graphs/GraphModel.js +4 -0
  183. package/dist/projections/graphs/GraphModel.js.map +1 -0
  184. package/dist/projections/graphs/GraphNameRequired.d.ts +11 -0
  185. package/dist/projections/graphs/GraphNameRequired.d.ts.map +1 -0
  186. package/dist/projections/graphs/GraphNameRequired.js +16 -0
  187. package/dist/projections/graphs/GraphNameRequired.js.map +1 -0
  188. package/dist/projections/graphs/GraphNodeBuilder.d.ts +34 -0
  189. package/dist/projections/graphs/GraphNodeBuilder.d.ts.map +1 -0
  190. package/dist/projections/graphs/GraphNodeBuilder.js +66 -0
  191. package/dist/projections/graphs/GraphNodeBuilder.js.map +1 -0
  192. package/dist/projections/graphs/GraphNodeFromBuilder.d.ts +21 -0
  193. package/dist/projections/graphs/GraphNodeFromBuilder.d.ts.map +1 -0
  194. package/dist/projections/graphs/GraphNodeFromBuilder.js +30 -0
  195. package/dist/projections/graphs/GraphNodeFromBuilder.js.map +1 -0
  196. package/dist/projections/graphs/GraphNodeFromModel.d.ts +14 -0
  197. package/dist/projections/graphs/GraphNodeFromModel.d.ts.map +1 -0
  198. package/dist/projections/graphs/GraphNodeFromModel.js +4 -0
  199. package/dist/projections/graphs/GraphNodeFromModel.js.map +1 -0
  200. package/dist/projections/graphs/GraphNodeModel.d.ts +18 -0
  201. package/dist/projections/graphs/GraphNodeModel.d.ts.map +1 -0
  202. package/dist/projections/graphs/GraphNodeModel.js +4 -0
  203. package/dist/projections/graphs/GraphNodeModel.js.map +1 -0
  204. package/dist/projections/graphs/GraphNodeRemovedWithBuilder.d.ts +17 -0
  205. package/dist/projections/graphs/GraphNodeRemovedWithBuilder.d.ts.map +1 -0
  206. package/dist/projections/graphs/GraphNodeRemovedWithBuilder.js +24 -0
  207. package/dist/projections/graphs/GraphNodeRemovedWithBuilder.js.map +1 -0
  208. package/dist/projections/graphs/GraphNodeRemovedWithModel.d.ts +12 -0
  209. package/dist/projections/graphs/GraphNodeRemovedWithModel.d.ts.map +1 -0
  210. package/dist/projections/graphs/GraphNodeRemovedWithModel.js +4 -0
  211. package/dist/projections/graphs/GraphNodeRemovedWithModel.js.map +1 -0
  212. package/dist/projections/graphs/GraphProjectionBuilder.d.ts +25 -0
  213. package/dist/projections/graphs/GraphProjectionBuilder.d.ts.map +1 -0
  214. package/dist/projections/graphs/GraphProjectionBuilder.js +36 -0
  215. package/dist/projections/graphs/GraphProjectionBuilder.js.map +1 -0
  216. package/dist/projections/graphs/GraphRegistration.d.ts +14 -0
  217. package/dist/projections/graphs/GraphRegistration.d.ts.map +1 -0
  218. package/dist/projections/graphs/GraphRegistration.js +4 -0
  219. package/dist/projections/graphs/GraphRegistration.js.map +1 -0
  220. package/dist/projections/graphs/GraphSchemaWriter.d.ts +28 -0
  221. package/dist/projections/graphs/GraphSchemaWriter.d.ts.map +1 -0
  222. package/dist/projections/graphs/GraphSchemaWriter.js +76 -0
  223. package/dist/projections/graphs/GraphSchemaWriter.js.map +1 -0
  224. package/dist/projections/graphs/Graphs.d.ts +39 -0
  225. package/dist/projections/graphs/Graphs.d.ts.map +1 -0
  226. package/dist/projections/graphs/Graphs.js +144 -0
  227. package/dist/projections/graphs/Graphs.js.map +1 -0
  228. package/dist/projections/graphs/IGraphEdgeBuilder.d.ts +37 -0
  229. package/dist/projections/graphs/IGraphEdgeBuilder.d.ts.map +1 -0
  230. package/dist/projections/graphs/IGraphEdgeBuilder.js +4 -0
  231. package/dist/projections/graphs/IGraphEdgeBuilder.js.map +1 -0
  232. package/dist/projections/graphs/IGraphEdgeFromBuilder.d.ts +29 -0
  233. package/dist/projections/graphs/IGraphEdgeFromBuilder.d.ts.map +1 -0
  234. package/dist/projections/graphs/IGraphEdgeFromBuilder.js +4 -0
  235. package/dist/projections/graphs/IGraphEdgeFromBuilder.js.map +1 -0
  236. package/dist/projections/graphs/IGraphEdgeRemovedWithBuilder.d.ts +27 -0
  237. package/dist/projections/graphs/IGraphEdgeRemovedWithBuilder.d.ts.map +1 -0
  238. package/dist/projections/graphs/IGraphEdgeRemovedWithBuilder.js +4 -0
  239. package/dist/projections/graphs/IGraphEdgeRemovedWithBuilder.js.map +1 -0
  240. package/dist/projections/graphs/IGraphMappingBuilder.d.ts +49 -0
  241. package/dist/projections/graphs/IGraphMappingBuilder.d.ts.map +1 -0
  242. package/dist/projections/graphs/IGraphMappingBuilder.js +4 -0
  243. package/dist/projections/graphs/IGraphMappingBuilder.js.map +1 -0
  244. package/dist/projections/graphs/IGraphNodeBuilder.d.ts +32 -0
  245. package/dist/projections/graphs/IGraphNodeBuilder.d.ts.map +1 -0
  246. package/dist/projections/graphs/IGraphNodeBuilder.js +4 -0
  247. package/dist/projections/graphs/IGraphNodeBuilder.js.map +1 -0
  248. package/dist/projections/graphs/IGraphNodeFromBuilder.d.ts +21 -0
  249. package/dist/projections/graphs/IGraphNodeFromBuilder.d.ts.map +1 -0
  250. package/dist/projections/graphs/IGraphNodeFromBuilder.js +4 -0
  251. package/dist/projections/graphs/IGraphNodeFromBuilder.js.map +1 -0
  252. package/dist/projections/graphs/IGraphNodeRemovedWithBuilder.d.ts +19 -0
  253. package/dist/projections/graphs/IGraphNodeRemovedWithBuilder.d.ts.map +1 -0
  254. package/dist/projections/graphs/IGraphNodeRemovedWithBuilder.js +4 -0
  255. package/dist/projections/graphs/IGraphNodeRemovedWithBuilder.js.map +1 -0
  256. package/dist/projections/graphs/IGraphProjection.d.ts +13 -0
  257. package/dist/projections/graphs/IGraphProjection.d.ts.map +1 -0
  258. package/dist/projections/graphs/IGraphProjection.js +4 -0
  259. package/dist/projections/graphs/IGraphProjection.js.map +1 -0
  260. package/dist/projections/graphs/IGraphProjectionBuilder.d.ts +26 -0
  261. package/dist/projections/graphs/IGraphProjectionBuilder.d.ts.map +1 -0
  262. package/dist/projections/graphs/IGraphProjectionBuilder.js +4 -0
  263. package/dist/projections/graphs/IGraphProjectionBuilder.js.map +1 -0
  264. package/dist/projections/graphs/IGraphs.d.ts +27 -0
  265. package/dist/projections/graphs/IGraphs.d.ts.map +1 -0
  266. package/dist/projections/graphs/IGraphs.js +4 -0
  267. package/dist/projections/graphs/IGraphs.js.map +1 -0
  268. package/dist/projections/graphs/ModelBoundGraphReader.d.ts +30 -0
  269. package/dist/projections/graphs/ModelBoundGraphReader.d.ts.map +1 -0
  270. package/dist/projections/graphs/ModelBoundGraphReader.js +112 -0
  271. package/dist/projections/graphs/ModelBoundGraphReader.js.map +1 -0
  272. package/dist/projections/graphs/NestedObjectInGraph.d.ts +12 -0
  273. package/dist/projections/graphs/NestedObjectInGraph.d.ts.map +1 -0
  274. package/dist/projections/graphs/NestedObjectInGraph.js +17 -0
  275. package/dist/projections/graphs/NestedObjectInGraph.js.map +1 -0
  276. package/dist/projections/graphs/NodeMustHaveExactlyOneKey.d.ts +12 -0
  277. package/dist/projections/graphs/NodeMustHaveExactlyOneKey.d.ts.map +1 -0
  278. package/dist/projections/graphs/NodeMustHaveExactlyOneKey.js +17 -0
  279. package/dist/projections/graphs/NodeMustHaveExactlyOneKey.js.map +1 -0
  280. package/dist/projections/graphs/SetOnceNotSupportedInGraph.d.ts +13 -0
  281. package/dist/projections/graphs/SetOnceNotSupportedInGraph.d.ts.map +1 -0
  282. package/dist/projections/graphs/SetOnceNotSupportedInGraph.js +18 -0
  283. package/dist/projections/graphs/SetOnceNotSupportedInGraph.js.map +1 -0
  284. package/dist/projections/graphs/UnknownGraphEventProperty.d.ts +13 -0
  285. package/dist/projections/graphs/UnknownGraphEventProperty.d.ts.map +1 -0
  286. package/dist/projections/graphs/UnknownGraphEventProperty.js +18 -0
  287. package/dist/projections/graphs/UnknownGraphEventProperty.js.map +1 -0
  288. package/dist/projections/graphs/UnknownGraphNode.d.ts +12 -0
  289. package/dist/projections/graphs/UnknownGraphNode.d.ts.map +1 -0
  290. package/dist/projections/graphs/UnknownGraphNode.js +17 -0
  291. package/dist/projections/graphs/UnknownGraphNode.js.map +1 -0
  292. package/dist/projections/graphs/edge.d.ts +23 -0
  293. package/dist/projections/graphs/edge.d.ts.map +1 -0
  294. package/dist/projections/graphs/edge.js +29 -0
  295. package/dist/projections/graphs/edge.js.map +1 -0
  296. package/dist/projections/graphs/edgeFrom.d.ts +31 -0
  297. package/dist/projections/graphs/edgeFrom.d.ts.map +1 -0
  298. package/dist/projections/graphs/edgeFrom.js +26 -0
  299. package/dist/projections/graphs/edgeFrom.js.map +1 -0
  300. package/dist/projections/graphs/edgeRemovedWith.d.ts +22 -0
  301. package/dist/projections/graphs/edgeRemovedWith.d.ts.map +1 -0
  302. package/dist/projections/graphs/edgeRemovedWith.js +25 -0
  303. package/dist/projections/graphs/edgeRemovedWith.js.map +1 -0
  304. package/dist/projections/graphs/edgeSource.d.ts +22 -0
  305. package/dist/projections/graphs/edgeSource.d.ts.map +1 -0
  306. package/dist/projections/graphs/edgeSource.js +30 -0
  307. package/dist/projections/graphs/edgeSource.js.map +1 -0
  308. package/dist/projections/graphs/edgeTarget.d.ts +22 -0
  309. package/dist/projections/graphs/edgeTarget.d.ts.map +1 -0
  310. package/dist/projections/graphs/edgeTarget.js +30 -0
  311. package/dist/projections/graphs/edgeTarget.js.map +1 -0
  312. package/dist/projections/graphs/graph.d.ts +16 -0
  313. package/dist/projections/graphs/graph.d.ts.map +1 -0
  314. package/dist/projections/graphs/graph.js +24 -0
  315. package/dist/projections/graphs/graph.js.map +1 -0
  316. package/dist/projections/graphs/graphKey.d.ts +16 -0
  317. package/dist/projections/graphs/graphKey.d.ts.map +1 -0
  318. package/dist/projections/graphs/graphKey.js +28 -0
  319. package/dist/projections/graphs/graphKey.js.map +1 -0
  320. package/dist/projections/graphs/graphProjection.d.ts +21 -0
  321. package/dist/projections/graphs/graphProjection.d.ts.map +1 -0
  322. package/dist/projections/graphs/graphProjection.js +28 -0
  323. package/dist/projections/graphs/graphProjection.js.map +1 -0
  324. package/dist/projections/graphs/index.d.ts +49 -0
  325. package/dist/projections/graphs/index.d.ts.map +1 -0
  326. package/dist/projections/graphs/index.js +28 -0
  327. package/dist/projections/graphs/index.js.map +1 -0
  328. package/dist/projections/graphs/isGraphElement.d.ts +7 -0
  329. package/dist/projections/graphs/isGraphElement.d.ts.map +1 -0
  330. package/dist/projections/graphs/isGraphElement.js +13 -0
  331. package/dist/projections/graphs/isGraphElement.js.map +1 -0
  332. package/dist/projections/graphs/node.d.ts +22 -0
  333. package/dist/projections/graphs/node.d.ts.map +1 -0
  334. package/dist/projections/graphs/node.js +29 -0
  335. package/dist/projections/graphs/node.js.map +1 -0
  336. package/dist/projections/graphs/nodeFrom.d.ts +31 -0
  337. package/dist/projections/graphs/nodeFrom.d.ts.map +1 -0
  338. package/dist/projections/graphs/nodeFrom.js +26 -0
  339. package/dist/projections/graphs/nodeFrom.js.map +1 -0
  340. package/dist/projections/graphs/nodeRemovedWith.d.ts +28 -0
  341. package/dist/projections/graphs/nodeRemovedWith.d.ts.map +1 -0
  342. package/dist/projections/graphs/nodeRemovedWith.js +25 -0
  343. package/dist/projections/graphs/nodeRemovedWith.js.map +1 -0
  344. package/dist/projections/graphs/propertyPathOf.d.ts +8 -0
  345. package/dist/projections/graphs/propertyPathOf.d.ts.map +1 -0
  346. package/dist/projections/graphs/propertyPathOf.js +14 -0
  347. package/dist/projections/graphs/propertyPathOf.js.map +1 -0
  348. package/dist/projections/index.d.ts +6 -0
  349. package/dist/projections/index.d.ts.map +1 -1
  350. package/dist/projections/index.js +4 -0
  351. package/dist/projections/index.js.map +1 -1
  352. package/dist/projections/modelBound/ConflictingChildrenOrdering.d.ts +10 -0
  353. package/dist/projections/modelBound/ConflictingChildrenOrdering.d.ts.map +1 -0
  354. package/dist/projections/modelBound/ConflictingChildrenOrdering.js +16 -0
  355. package/dist/projections/modelBound/ConflictingChildrenOrdering.js.map +1 -0
  356. package/dist/projections/modelBound/childrenAndNestedBuilder.d.ts +2 -0
  357. package/dist/projections/modelBound/childrenAndNestedBuilder.d.ts.map +1 -1
  358. package/dist/projections/modelBound/childrenAndNestedBuilder.js +9 -5
  359. package/dist/projections/modelBound/childrenAndNestedBuilder.js.map +1 -1
  360. package/dist/projections/modelBound/childrenFrom.d.ts +39 -1
  361. package/dist/projections/modelBound/childrenFrom.d.ts.map +1 -1
  362. package/dist/projections/modelBound/childrenFrom.js +30 -1
  363. package/dist/projections/modelBound/childrenFrom.js.map +1 -1
  364. package/dist/projections/modelBound/index.d.ts +3 -2
  365. package/dist/projections/modelBound/index.d.ts.map +1 -1
  366. package/dist/projections/modelBound/index.js +1 -0
  367. package/dist/projections/modelBound/index.js.map +1 -1
  368. package/dist/projections/modelBound/setFrom.d.ts +26 -0
  369. package/dist/projections/modelBound/setFrom.d.ts.map +1 -1
  370. package/dist/projections/modelBound/setFrom.js +15 -8
  371. package/dist/projections/modelBound/setFrom.js.map +1 -1
  372. package/dist/projections/modelBound/setFromContext.d.ts +23 -1
  373. package/dist/projections/modelBound/setFromContext.d.ts.map +1 -1
  374. package/dist/projections/modelBound/setFromContext.js +20 -2
  375. package/dist/projections/modelBound/setFromContext.js.map +1 -1
  376. package/dist/projections/propertyExpressions.d.ts +9 -0
  377. package/dist/projections/propertyExpressions.d.ts.map +1 -0
  378. package/dist/projections/propertyExpressions.js +13 -0
  379. package/dist/projections/propertyExpressions.js.map +1 -0
  380. package/dist/projections/registerProjectionWithRetry.d.ts +15 -0
  381. package/dist/projections/registerProjectionWithRetry.d.ts.map +1 -0
  382. package/dist/projections/registerProjectionWithRetry.js +44 -0
  383. package/dist/projections/registerProjectionWithRetry.js.map +1 -0
  384. package/dist/readModels/rootReadModelTypes.d.ts.map +1 -1
  385. package/dist/readModels/rootReadModelTypes.js +3 -1
  386. package/dist/readModels/rootReadModelTypes.js.map +1 -1
  387. package/dist/reducers/Reducers.d.ts.map +1 -1
  388. package/dist/reducers/Reducers.js +2 -1
  389. package/dist/reducers/Reducers.js.map +1 -1
  390. package/dist/sinks/WellKnownSinks.d.ts +4 -0
  391. package/dist/sinks/WellKnownSinks.d.ts.map +1 -1
  392. package/dist/sinks/WellKnownSinks.js +5 -1
  393. package/dist/sinks/WellKnownSinks.js.map +1 -1
  394. package/dist/testing/projections/ProjectionCapabilities.d.ts.map +1 -1
  395. package/dist/testing/projections/ProjectionCapabilities.js +2 -0
  396. package/dist/testing/projections/ProjectionCapabilities.js.map +1 -1
  397. package/dist/testing/projections/ProjectionChildrenCapabilities.d.ts.map +1 -1
  398. package/dist/testing/projections/ProjectionChildrenCapabilities.js +2 -0
  399. package/dist/testing/projections/ProjectionChildrenCapabilities.js.map +1 -1
  400. package/dist/tsconfig.tsbuildinfo +1 -1
  401. package/dist/types/DecoratorType.d.ts +5 -1
  402. package/dist/types/DecoratorType.d.ts.map +1 -1
  403. package/dist/types/DecoratorType.js +4 -0
  404. package/dist/types/DecoratorType.js.map +1 -1
  405. package/for_ChronicleOptions/when_configuring_the_graph_sink/with_graph_sink_type.spec.ts +22 -0
  406. package/package.json +3 -3
  407. package/projections/ChildrenOrderingNotSupportedByContracts.ts +18 -0
  408. package/projections/InvalidCausedByProperty.ts +14 -0
  409. package/projections/Projections.ts +8 -29
  410. package/projections/causedBy.ts +30 -0
  411. package/projections/childrenOrdering.ts +53 -0
  412. package/projections/childrenOrderingSupport.ts +40 -0
  413. package/projections/declarative/AllSetBuilder.ts +7 -0
  414. package/projections/declarative/ChildrenBuilder.ts +34 -1
  415. package/projections/declarative/ChildrenOrderingAlreadyDefined.ts +11 -0
  416. package/projections/declarative/DictionaryKey.ts +88 -0
  417. package/projections/declarative/FromAllBuilder.ts +10 -0
  418. package/projections/declarative/FromBuilder.ts +42 -32
  419. package/projections/declarative/FromEveryBuilder.ts +12 -0
  420. package/projections/declarative/IAllSetBuilder.ts +8 -0
  421. package/projections/declarative/IChildrenBuilder.ts +22 -0
  422. package/projections/declarative/IFromAllBuilder.ts +7 -0
  423. package/projections/declarative/IFromEveryBuilder.ts +7 -0
  424. package/projections/declarative/IReadModelPropertiesBuilder.ts +39 -6
  425. package/projections/declarative/ISetBuilder.ts +8 -0
  426. package/projections/declarative/InvalidDictionaryKey.ts +14 -0
  427. package/projections/declarative/JoinBuilder.ts +41 -32
  428. package/projections/declarative/ProjectionBuilderCore.ts +2 -0
  429. package/projections/declarative/SetBuilder.ts +7 -0
  430. package/projections/declarative/for_ChildrenBuilder/when_ordering_children.spec.ts +52 -0
  431. package/projections/declarative/for_FromAllBuilder/when_setting_once.spec.ts +29 -0
  432. package/projections/declarative/for_FromBuilder/when_setting_once.spec.ts +39 -0
  433. package/projections/declarative/for_FromBuilder/when_targeting_dictionary_entries.spec.ts +99 -0
  434. package/projections/declarative/for_JoinBuilder/when_setting_once_and_targeting_dictionary_entries.spec.ts +36 -0
  435. package/projections/declarative/for_SetBuilder/when_setting_to_the_causing_identity.spec.ts +37 -0
  436. package/projections/declarative/index.ts +4 -0
  437. package/projections/for_Graphs/given/a_discovered_graph.ts +21 -0
  438. package/projections/for_Graphs/given/a_fake_connection.ts +19 -0
  439. package/projections/for_Graphs/given/organization.ts +96 -0
  440. package/projections/for_Graphs/when_building_a_fluent_graph.spec.ts +112 -0
  441. package/projections/for_Graphs/when_building_a_model_bound_graph.spec.ts +92 -0
  442. package/projections/for_Graphs/when_declaring_an_edge_with_an_identity.spec.ts +137 -0
  443. package/projections/for_Graphs/when_declaring_an_invalid_graph.spec.ts +227 -0
  444. package/projections/for_Graphs/when_declaring_with_standard_decorators.standard.spec.ts +92 -0
  445. package/projections/for_Graphs/when_discovering_graph_elements.spec.ts +32 -0
  446. package/projections/for_Graphs/when_mapping_properties.spec.ts +159 -0
  447. package/projections/for_Graphs/when_registering_graphs.spec.ts +56 -0
  448. package/projections/for_Projections/when_registering_ordered_children.spec.ts +66 -0
  449. package/projections/for_childrenOrderingSupport/when_detecting_support_in_the_pinned_contracts.spec.ts +22 -0
  450. package/projections/for_childrenOrderingSupport/when_ensuring_children_ordering_is_supported.spec.ts +35 -0
  451. package/projections/graphs/EdgeCanHaveOnlyOneIdentifyingKey.ts +16 -0
  452. package/projections/graphs/EdgeMustHaveOneSourceAndOneTarget.ts +16 -0
  453. package/projections/graphs/GraphDeclaredMoreThanOnce.ts +16 -0
  454. package/projections/graphs/GraphDefinitionBuilder.ts +169 -0
  455. package/projections/graphs/GraphEdgeBuilder.ts +107 -0
  456. package/projections/graphs/GraphEdgeFromBuilder.ts +47 -0
  457. package/projections/graphs/GraphEdgeFromModel.ts +22 -0
  458. package/projections/graphs/GraphEdgeModel.ts +34 -0
  459. package/projections/graphs/GraphEdgeRemovedWithBuilder.ts +39 -0
  460. package/projections/graphs/GraphEdgeRemovedWithModel.ts +19 -0
  461. package/projections/graphs/GraphElementCannotBeReadModel.ts +16 -0
  462. package/projections/graphs/GraphHasDuplicateElement.ts +18 -0
  463. package/projections/graphs/GraphKeyPropertyNotFound.ts +17 -0
  464. package/projections/graphs/GraphMappingBuilder.ts +65 -0
  465. package/projections/graphs/GraphMemberMappings.ts +60 -0
  466. package/projections/graphs/GraphModel.ts +20 -0
  467. package/projections/graphs/GraphNameRequired.ts +16 -0
  468. package/projections/graphs/GraphNodeBuilder.ts +76 -0
  469. package/projections/graphs/GraphNodeFromBuilder.ts +38 -0
  470. package/projections/graphs/GraphNodeFromModel.ts +19 -0
  471. package/projections/graphs/GraphNodeModel.ts +25 -0
  472. package/projections/graphs/GraphNodeRemovedWithBuilder.ts +30 -0
  473. package/projections/graphs/GraphNodeRemovedWithModel.ts +16 -0
  474. package/projections/graphs/GraphProjectionBuilder.ts +52 -0
  475. package/projections/graphs/GraphRegistration.ts +19 -0
  476. package/projections/graphs/GraphSchemaWriter.ts +80 -0
  477. package/projections/graphs/Graphs.ts +165 -0
  478. package/projections/graphs/IGraphEdgeBuilder.ts +43 -0
  479. package/projections/graphs/IGraphEdgeFromBuilder.ts +34 -0
  480. package/projections/graphs/IGraphEdgeRemovedWithBuilder.ts +32 -0
  481. package/projections/graphs/IGraphMappingBuilder.ts +57 -0
  482. package/projections/graphs/IGraphNodeBuilder.ts +37 -0
  483. package/projections/graphs/IGraphNodeFromBuilder.ts +25 -0
  484. package/projections/graphs/IGraphNodeRemovedWithBuilder.ts +23 -0
  485. package/projections/graphs/IGraphProjection.ts +16 -0
  486. package/projections/graphs/IGraphProjectionBuilder.ts +34 -0
  487. package/projections/graphs/IGraphs.ts +33 -0
  488. package/projections/graphs/ModelBoundGraphReader.ts +119 -0
  489. package/projections/graphs/NestedObjectInGraph.ts +17 -0
  490. package/projections/graphs/NodeMustHaveExactlyOneKey.ts +17 -0
  491. package/projections/graphs/SetOnceNotSupportedInGraph.ts +18 -0
  492. package/projections/graphs/UnknownGraphEventProperty.ts +18 -0
  493. package/projections/graphs/UnknownGraphNode.ts +17 -0
  494. package/projections/graphs/edge.ts +40 -0
  495. package/projections/graphs/edgeFrom.ts +48 -0
  496. package/projections/graphs/edgeRemovedWith.ts +36 -0
  497. package/projections/graphs/edgeSource.ts +39 -0
  498. package/projections/graphs/edgeTarget.ts +39 -0
  499. package/projections/graphs/graph.ts +28 -0
  500. package/projections/graphs/graphKey.ts +31 -0
  501. package/projections/graphs/graphProjection.ts +39 -0
  502. package/projections/graphs/index.ts +51 -0
  503. package/projections/graphs/isGraphElement.ts +14 -0
  504. package/projections/graphs/node.ts +40 -0
  505. package/projections/graphs/nodeFrom.ts +48 -0
  506. package/projections/graphs/nodeRemovedWith.ts +44 -0
  507. package/projections/graphs/propertyPathOf.ts +15 -0
  508. package/projections/index.ts +6 -0
  509. package/projections/modelBound/ConflictingChildrenOrdering.ts +14 -0
  510. package/projections/modelBound/childrenAndNestedBuilder.ts +11 -5
  511. package/projections/modelBound/childrenFrom.ts +62 -2
  512. package/projections/modelBound/for_childrenFrom/when_ordering_children.spec.ts +91 -0
  513. package/projections/modelBound/for_setFrom/when_setting_once.spec.ts +52 -0
  514. package/projections/modelBound/index.ts +3 -2
  515. package/projections/modelBound/setFrom.ts +37 -2
  516. package/projections/modelBound/setFromContext.ts +38 -3
  517. package/projections/propertyExpressions.ts +14 -0
  518. package/projections/registerProjectionWithRetry.ts +53 -0
  519. package/readModels/rootReadModelTypes.ts +3 -1
  520. package/reducers/Reducers.ts +2 -1
  521. package/sinks/WellKnownSinks.ts +7 -1
  522. package/testing/projections/ProjectionCapabilities.ts +1 -0
  523. package/testing/projections/ProjectionChildrenCapabilities.ts +1 -0
  524. package/testing/projections/for_ProjectionCapabilities/when_rejecting_set_once_dictionary_entries_and_ordered_children.spec.ts +52 -0
  525. package/types/DecoratorType.ts +7 -1
@@ -0,0 +1,32 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import 'reflect-metadata';
5
+ import { chai, describe, it } from 'vitest';
6
+ import { DefaultClientArtifactsProvider } from '../../artifacts/DefaultClientArtifactsProvider.js';
7
+ import { rootReadModelTypes } from '../../readModels/rootReadModelTypes.js';
8
+ import { TypeDiscoverer } from '../../types/index.js';
9
+ import { isGraphElement } from '../graphs/isGraphElement.js';
10
+ import { discoverGraphs } from './given/a_discovered_graph.js';
11
+ import { Group, MemberOf, Person } from './given/organization.js';
12
+
13
+ chai.should();
14
+
15
+ describe('when discovering the artifacts of an application with a graph', () => {
16
+ const provider = new DefaultClientArtifactsProvider(TypeDiscoverer.default);
17
+
18
+ it('should find the nodes and edges', () => {
19
+ provider.graphElements.should.include.members([Person, Group, MemberOf]);
20
+ });
21
+ it('should recognize them as graph elements', () => {
22
+ [Person, Group, MemberOf].every(isGraphElement).should.be.true;
23
+ });
24
+ it('should not treat them as read models, even though they map properties like read models do', () => {
25
+ provider.readModels.should.not.include.members([MemberOf]);
26
+ rootReadModelTypes(provider).should.not.include.members([Person, Group, MemberOf]);
27
+ });
28
+ it('should build the graph from what it finds', async () => {
29
+ const result = await discoverGraphs(provider.graphElements);
30
+ result.graphs.registrations.map(_ => _.graphName).should.include('Organization');
31
+ });
32
+ });
@@ -0,0 +1,159 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import 'reflect-metadata';
5
+ import { beforeAll, chai, describe, it } from 'vitest';
6
+ import type { GraphNodeProjectionDefinition } from '@cratis/chronicle.contracts';
7
+ import { eventType } from '../../events/eventTypeDecorator.js';
8
+ import { addFrom } from '../modelBound/addFrom.js';
9
+ import { count } from '../modelBound/count.js';
10
+ import { decrement } from '../modelBound/decrement.js';
11
+ import { increment } from '../modelBound/increment.js';
12
+ import { setFrom } from '../modelBound/setFrom.js';
13
+ import { setFromContext } from '../modelBound/setFromContext.js';
14
+ import { setValue } from '../modelBound/setValue.js';
15
+ import { subtractFrom } from '../modelBound/subtractFrom.js';
16
+ import { graph } from '../graphs/graph.js';
17
+ import { graphKey } from '../graphs/graphKey.js';
18
+ import { graphProjection } from '../graphs/graphProjection.js';
19
+ import type { IGraphProjection } from '../graphs/IGraphProjection.js';
20
+ import type { IGraphProjectionBuilder } from '../graphs/IGraphProjectionBuilder.js';
21
+ import { node } from '../graphs/node.js';
22
+ import { nodeFrom } from '../graphs/nodeFrom.js';
23
+ import { discoverGraphs } from './given/a_discovered_graph.js';
24
+
25
+ chai.should();
26
+
27
+ class TeamFormed { teamId = ''; title = ''; }
28
+ eventType()(TeamFormed);
29
+ class MemberJoined { teamId = ''; points = 0; }
30
+ eventType()(MemberJoined);
31
+ class MemberLeft { teamId = ''; points = 0; }
32
+ eventType()(MemberLeft);
33
+ class TeamRenamed { teamId = ''; newTitle = ''; }
34
+ eventType()(TeamRenamed);
35
+ class TeamArchived { teamId = ''; }
36
+ eventType()(TeamArchived);
37
+
38
+ class Team {
39
+ teamId = '';
40
+ title = '';
41
+ memberCount = 0;
42
+ totalPoints = 0;
43
+ archived = false;
44
+ renamedAt = '';
45
+ visits = 0;
46
+ status = '';
47
+ }
48
+ graph('Teams')(Team);
49
+ node()(Team);
50
+ graphKey()(Team.prototype, 'teamId');
51
+ nodeFrom(TeamFormed, { key: 'teamId' })(Team);
52
+ nodeFrom(MemberJoined, { key: 'teamId' })(Team);
53
+ nodeFrom(MemberLeft, { key: 'teamId' })(Team);
54
+ increment(MemberJoined)(Team.prototype, 'memberCount');
55
+ decrement(MemberLeft)(Team.prototype, 'memberCount');
56
+ addFrom(MemberJoined, 'points')(Team.prototype, 'totalPoints');
57
+ subtractFrom(MemberLeft, 'points')(Team.prototype, 'totalPoints');
58
+ count(MemberJoined)(Team.prototype, 'visits');
59
+ setFromContext(TeamRenamed, 'occurred')(Team.prototype, 'renamedAt');
60
+ setFrom(TeamRenamed, 'newTitle')(Team.prototype, 'title');
61
+ setValue(TeamArchived, true)(Team.prototype, 'archived');
62
+ setValue(TeamArchived, 'archived')(Team.prototype, 'status');
63
+
64
+ describe('when mapping the properties of a node with decorators', () => {
65
+ let nodeDefinition: GraphNodeProjectionDefinition;
66
+
67
+ beforeAll(async () => {
68
+ const result = await discoverGraphs([Team]);
69
+ result.graphs.failures.size.should.equal(0);
70
+ nodeDefinition = result.graphs.registrations[0].projection.Graph!.Nodes.Team;
71
+ });
72
+
73
+ it('should map a property by name from the event that has a property of that name', () => {
74
+ nodeDefinition.From['TeamFormed+1'].Properties.should.deep.equal({ title: 'title' });
75
+ });
76
+ it('should add, increment and count', () => {
77
+ nodeDefinition.From['MemberJoined+1'].Properties.should.deep.equal({
78
+ memberCount: '$increment', totalPoints: '$add(points)', visits: '$count'
79
+ });
80
+ });
81
+ it('should subtract and decrement', () => {
82
+ nodeDefinition.From['MemberLeft+1'].Properties.should.deep.equal({ memberCount: '$decrement', totalPoints: '$subtract(points)' });
83
+ });
84
+ it('should map an event property of another name and the event context', () => {
85
+ nodeDefinition.From['TeamRenamed+1'].Properties.should.deep.equal({ title: 'newTitle', renamedAt: '$eventContext(Occurred)' });
86
+ });
87
+ it('should project the node from an event only a property refers to, keyed by the event source id', () => {
88
+ nodeDefinition.From['TeamRenamed+1'].Key.should.equal('$eventSourceId');
89
+ nodeDefinition.From['TeamRenamed+1'].UpdateOnly.should.be.false;
90
+ });
91
+ it('should set constant values', () => {
92
+ nodeDefinition.From['TeamArchived+1'].Properties.should.deep.equal({ archived: '$value(true)', status: '$value(archived)' });
93
+ });
94
+ });
95
+
96
+ describe('when declaring how an event projects a node', () => {
97
+ class Counter { counterId = ''; total = 0; }
98
+ graph('Counters')(Counter);
99
+ node()(Counter);
100
+ graphKey()(Counter.prototype, 'counterId');
101
+ nodeFrom(MemberJoined, { constantKey: 'all', updateOnly: true })(Counter);
102
+ count(MemberJoined)(Counter.prototype, 'total');
103
+
104
+ it('should key the node with the constant and only change a node that exists', async () => {
105
+ const result = await discoverGraphs([Counter]);
106
+ result.graphs.registrations[0].projection.Graph!.Nodes.Counter.From['MemberJoined+1'].should.deep.equal({
107
+ Key: '$value(all)', Properties: { total: '$count' }, UpdateOnly: true, ForEach: ''
108
+ });
109
+ });
110
+ });
111
+
112
+ describe('when mapping the properties of a node with the fluent builder', () => {
113
+ let nodeDefinition: GraphNodeProjectionDefinition;
114
+
115
+ beforeAll(async () => {
116
+ class TeamsGraph implements IGraphProjection {
117
+ define(builder: IGraphProjectionBuilder): void {
118
+ builder.node(Team, node => node
119
+ .from(TeamFormed, from => from.usingKey(event => event.teamId))
120
+ .from(MemberJoined, from => from
121
+ .usingKey(event => event.teamId)
122
+ .increment(team => team.memberCount)
123
+ .add(team => team.totalPoints).with(event => event.points)
124
+ .count(team => team.visits))
125
+ .from(MemberLeft, from => from
126
+ .decrement(team => team.memberCount)
127
+ .subtract(team => team.totalPoints).with(event => event.points))
128
+ .from(TeamRenamed, from => from
129
+ .set(team => team.title).to(event => event.newTitle)
130
+ .set(team => team.renamedAt).toEventContextProperty('occurred')
131
+ .set(team => team.status).toValue('renamed')
132
+ .set(team => team.archived).toValue(false)
133
+ .set(team => team.teamId).toEventSourceId()
134
+ .onlyWhenExisting()));
135
+ }
136
+ }
137
+ graphProjection('FluentTeams')(TeamsGraph);
138
+ const result = await discoverGraphs([], [TeamsGraph]);
139
+ result.graphs.failures.size.should.equal(0);
140
+ nodeDefinition = result.graphs.registrations[0].projection.Graph!.Nodes.Team;
141
+ });
142
+
143
+ it('should map by name, add, increment and count', () => {
144
+ nodeDefinition.From['MemberJoined+1'].Properties.should.deep.equal({
145
+ memberCount: '$increment', totalPoints: '$add(points)', visits: '$count'
146
+ });
147
+ });
148
+ it('should subtract and decrement', () => {
149
+ nodeDefinition.From['MemberLeft+1'].Properties.should.deep.equal({ memberCount: '$decrement', totalPoints: '$subtract(points)' });
150
+ });
151
+ it('should set from the event, the event context, a constant and the event source id', () => {
152
+ nodeDefinition.From['TeamRenamed+1'].Properties.should.deep.include({
153
+ title: 'newTitle', renamedAt: '$eventContext(Occurred)', status: '$value(renamed)', archived: '$value(false)', teamId: '$eventSourceId'
154
+ });
155
+ });
156
+ it('should only change a node that exists', () => {
157
+ nodeDefinition.From['TeamRenamed+1'].UpdateOnly.should.be.true;
158
+ });
159
+ });
@@ -0,0 +1,56 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import 'reflect-metadata';
5
+ import { ProjectionOwner } from '@cratis/chronicle.contracts';
6
+ import { beforeAll, chai, describe, it } from 'vitest';
7
+ import { discoverGraphs } from './given/a_discovered_graph.js';
8
+ import { Group, MemberOf, Person } from './given/organization.js';
9
+
10
+ chai.should();
11
+
12
+ describe('when registering a graph', () => {
13
+ let result: Awaited<ReturnType<typeof discoverGraphs>>;
14
+
15
+ beforeAll(async () => {
16
+ result = await discoverGraphs([Person, Group, MemberOf]);
17
+ await result.graphs.register();
18
+ });
19
+
20
+ it('should register the graph as a read model of the event store', () => {
21
+ result.readModelRequests.length.should.equal(1);
22
+ const request = result.readModelRequests[0];
23
+ request.EventStore.should.equal('the-store');
24
+ request.ReadModels.map(readModel => readModel.Type.Identifier).should.deep.equal(['Organization']);
25
+ });
26
+ it('should register the projection that fills the graph, with the graph definition on the wire', () => {
27
+ result.projectionRequests.length.should.equal(1);
28
+ const request = result.projectionRequests[0];
29
+ request.EventStore.should.equal('the-store');
30
+ request.Owner.should.equal(ProjectionOwner.PROJECTION_OWNER_Client);
31
+ request.Projections[0].Identifier.should.equal('Organization');
32
+ Object.keys(request.Projections[0].Graph.Nodes).should.deep.equal(['Person', 'Group']);
33
+ Object.keys(request.Projections[0].Graph.Edges).should.deep.equal(['MEMBER_OF']);
34
+ });
35
+ });
36
+
37
+ describe('when registering without graphs', () => {
38
+ it('should not call the kernel', async () => {
39
+ const result = await discoverGraphs([]);
40
+ await result.graphs.register();
41
+ result.readModelRequests.length.should.equal(0);
42
+ result.projectionRequests.length.should.equal(0);
43
+ });
44
+ });
45
+
46
+ describe('when the graph definition has to be encoded for the wire', () => {
47
+ it('should encode as a projection definition', async () => {
48
+ const { ProjectionDefinition } = await import('@cratis/chronicle.contracts');
49
+ const result = await discoverGraphs([Person, Group, MemberOf]);
50
+ const bytes = ProjectionDefinition.encode(result.graphs.registrations[0].projection).finish();
51
+ const decoded = ProjectionDefinition.decode(bytes);
52
+ decoded.Graph!.Nodes.Person.From['PersonRegistered+1'].Key.should.equal('personId');
53
+ decoded.Graph!.Edges.MEMBER_OF.From['MemberAdded+1'].Properties.since.should.equal('$eventContext(Occurred)');
54
+ decoded.Graph!.Nodes.Person.RemovedWith['PersonRemoved+1'].Detach.should.be.true;
55
+ });
56
+ });
@@ -0,0 +1,66 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import 'reflect-metadata';
5
+ import { field } from '@cratis/fundamentals';
6
+ import { beforeEach, chai, describe, it, vi } from 'vitest';
7
+ import type { IClientArtifactsProvider } from '../../artifacts/index.js';
8
+ import type { ChronicleConnection } from '../../connection/index.js';
9
+ import { eventType } from '../../events/eventTypeDecorator.js';
10
+ import { ChildrenOrderingNotSupportedByContracts } from '../ChildrenOrderingNotSupportedByContracts.js';
11
+ import { contractsSupportChildrenOrdering } from '../childrenOrderingSupport.js';
12
+ import { childrenFrom } from '../modelBound/childrenFrom.js';
13
+ import { Projections } from '../Projections.js';
14
+
15
+ chai.should();
16
+
17
+ class OrderLineAdded {
18
+ lineId = '';
19
+ }
20
+ eventType()(OrderLineAdded);
21
+
22
+ class OrderLine {
23
+ lineId = '';
24
+ }
25
+ field(String)(OrderLine.prototype, 'lineId');
26
+
27
+ class OrderWithOrderedLines {
28
+ id = '';
29
+ lines: OrderLine[] = [];
30
+ }
31
+ field(String)(OrderWithOrderedLines.prototype, 'id');
32
+ childrenFrom(OrderLineAdded, { childType: OrderLine, key: 'lineId', prepend: true })(OrderWithOrderedLines.prototype, 'lines');
33
+
34
+ const supported = contractsSupportChildrenOrdering();
35
+
36
+ describe('when registering a projection with ordered children', () => {
37
+ let register: ReturnType<typeof vi.fn>;
38
+ let registration: Promise<void>;
39
+
40
+ beforeEach(() => {
41
+ register = vi.fn().mockResolvedValue(undefined);
42
+ const connection = {
43
+ readModels: { registerMany: vi.fn().mockResolvedValue(undefined) },
44
+ projections: { register }
45
+ } as unknown as ChronicleConnection;
46
+ const artifacts: IClientArtifactsProvider = {
47
+ readModels: [OrderWithOrderedLines] as unknown as IClientArtifactsProvider['readModels'],
48
+ projections: [], eventTypes: [], globalForHandlers: [], reducers: [], reactors: [],
49
+ seeders: [], constraints: [], webhooks: [], eventTypeMigrations: []
50
+ };
51
+ registration = new Projections('store', 'namespace', connection, artifacts, 'sink').register();
52
+ registration.catch(() => undefined);
53
+ });
54
+
55
+ it.runIf(!supported)('should fail registration until the contracts carry the ordering', async () => {
56
+ const error = await registration.then(() => undefined, (reason: unknown) => reason);
57
+ (error as Error).should.be.instanceOf(ChildrenOrderingNotSupportedByContracts);
58
+ register.mock.calls.length.should.equal(0);
59
+ });
60
+
61
+ it.runIf(supported)('should send the ordering to the kernel', async () => {
62
+ await registration;
63
+ const request = register.mock.calls[0][0] as { Projections: Array<{ Children: Record<string, { Ordering?: { Placement: number } }> }> };
64
+ request.Projections[0].Children.lines.Ordering!.Placement.should.equal(1);
65
+ });
66
+ });
@@ -0,0 +1,22 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import { readFileSync } from 'node:fs';
5
+ import { chai, describe, it } from 'vitest';
6
+ import { contractsSupportChildrenOrdering } from '../childrenOrderingSupport.js';
7
+
8
+ chai.should();
9
+
10
+ // The contracts version this expectation was verified against. Bumping the contracts fails the first spec on purpose:
11
+ // re-check children ordering support for the new version, then update both the version and the expectation together.
12
+ const verifiedContractsVersion = '19.150.0';
13
+ const supportedInVerifiedVersion = true;
14
+
15
+ const pinnedContractsVersion = (JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8')) as {
16
+ dependencies: Record<string, string>;
17
+ }).dependencies['@cratis/chronicle.contracts'];
18
+
19
+ describe('when detecting children ordering support in the pinned contracts', () => {
20
+ it('should be verified against the pinned contracts version', () => pinnedContractsVersion.should.equal(verifiedContractsVersion));
21
+ it('should match the verified support', () => contractsSupportChildrenOrdering().should.equal(supportedInVerifiedVersion));
22
+ });
@@ -0,0 +1,35 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import type { ProjectionDefinition } from '@cratis/chronicle.contracts';
5
+ import { chai, describe, it } from 'vitest';
6
+ import { ChildrenOrderingNotSupportedByContracts } from '../ChildrenOrderingNotSupportedByContracts.js';
7
+ import { prependOrdering } from '../childrenOrdering.js';
8
+ import { ensureChildrenOrderingIsSupported } from '../childrenOrderingSupport.js';
9
+
10
+ chai.should();
11
+
12
+ const definitionWith = (children: Record<string, unknown>, nested: Record<string, unknown> = {}) =>
13
+ ({ Identifier: 'orders', Children: children, Nested: nested }) as unknown as ProjectionDefinition;
14
+
15
+ describe('when the contracts cannot carry children ordering', () => {
16
+ it('should accept a projection without ordered children', () =>
17
+ (() => ensureChildrenOrderingIsSupported(definitionWith({ lines: { Children: {}, Nested: {} } }), false)).should.not.throw());
18
+
19
+ it('should reject ordered children with the projection and path', () =>
20
+ (() => ensureChildrenOrderingIsSupported(definitionWith({ lines: { Ordering: prependOrdering() } }), false))
21
+ .should.throw(ChildrenOrderingNotSupportedByContracts, "Projection 'orders' orders the children at 'Children.lines'"));
22
+
23
+ it('should reject ordered children inside a nested object', () =>
24
+ (() => ensureChildrenOrderingIsSupported(definitionWith({}, { summary: { Children: { lines: { Ordering: prependOrdering() } } } }), false))
25
+ .should.throw(ChildrenOrderingNotSupportedByContracts, "'Nested.summary.Children.lines'"));
26
+
27
+ it('should reject ordered grandchildren', () =>
28
+ (() => ensureChildrenOrderingIsSupported(definitionWith({ lines: { Children: { notes: { Ordering: prependOrdering() } } } }), false))
29
+ .should.throw(ChildrenOrderingNotSupportedByContracts, "'Children.lines.Children.notes'"));
30
+ });
31
+
32
+ describe('when the contracts carry children ordering', () => {
33
+ it('should accept ordered children', () =>
34
+ (() => ensureChildrenOrderingIsSupported(definitionWith({ lines: { Ordering: prependOrdering() } }), true)).should.not.throw());
35
+ });
@@ -0,0 +1,16 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ /**
5
+ * Error thrown when an edge type has more than one identifying key.
6
+ */
7
+ export class EdgeCanHaveOnlyOneIdentifyingKey extends Error {
8
+ /**
9
+ * Creates a new {@link EdgeCanHaveOnlyOneIdentifyingKey}.
10
+ * @param type - The edge type.
11
+ */
12
+ constructor(type: Function) {
13
+ super(`The edge type '${type.name}' can have at most one member with the graphKey decorator, the one that identifies the edge.`);
14
+ this.name = 'EdgeCanHaveOnlyOneIdentifyingKey';
15
+ }
16
+ }
@@ -0,0 +1,16 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ /**
5
+ * Error thrown when an edge type does not name its end nodes.
6
+ */
7
+ export class EdgeMustHaveOneSourceAndOneTarget extends Error {
8
+ /**
9
+ * Creates a new {@link EdgeMustHaveOneSourceAndOneTarget}.
10
+ * @param type - The edge type.
11
+ */
12
+ constructor(type: Function) {
13
+ super(`The edge type '${type.name}' must have exactly one member with the edgeSource decorator and exactly one with the edgeTarget decorator.`);
14
+ this.name = 'EdgeMustHaveOneSourceAndOneTarget';
15
+ }
16
+ }
@@ -0,0 +1,16 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ /**
5
+ * Error thrown when two declarations produce a graph with the same name.
6
+ */
7
+ export class GraphDeclaredMoreThanOnce extends Error {
8
+ /**
9
+ * Creates a new {@link GraphDeclaredMoreThanOnce}.
10
+ * @param graph - The name of the graph.
11
+ */
12
+ constructor(graph: string) {
13
+ super(`The graph '${graph}' is declared by more than one graph projection. A graph is the read model of exactly one projection.`);
14
+ this.name = 'GraphDeclaredMoreThanOnce';
15
+ }
16
+ }
@@ -0,0 +1,169 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import { AutoMap, EventGenerationDelivery, ReadModelObserverType } from '@cratis/chronicle.contracts';
5
+ import type {
6
+ GraphEdgeProjectionDefinition,
7
+ GraphNodeProjectionDefinition,
8
+ ProjectionDefinition
9
+ } from '@cratis/chronicle.contracts';
10
+ import { EventSequenceId } from '../../eventSequences/EventSequenceId.js';
11
+ import { getEventTypeJsonSchemaFor } from '../../events/eventTypeDecorator.js';
12
+ import { buildReadModelDefinition } from '../../readModels/buildReadModelDefinition.js';
13
+ import type { JsonSchema } from '../../schemas/index.js';
14
+ import { TypeIntrospector } from '../../types/index.js';
15
+ import { toContractEventType } from '../modelBound/childrenAndNestedBuilder.js';
16
+ import type { GraphEdgeModel } from './GraphEdgeModel.js';
17
+ import { GraphHasDuplicateElement } from './GraphHasDuplicateElement.js';
18
+ import type { GraphModel } from './GraphModel.js';
19
+ import type { GraphNodeModel } from './GraphNodeModel.js';
20
+ import type { GraphRegistration } from './GraphRegistration.js';
21
+ import { GraphSchemaWriter } from './GraphSchemaWriter.js';
22
+ import { UnknownGraphEventProperty } from './UnknownGraphEventProperty.js';
23
+
24
+ const eventSourceId = '$eventSourceId';
25
+
26
+ /**
27
+ * Turns a {@link GraphModel} into the definitions that are registered with the kernel. The shape follows the
28
+ * .NET client's GraphDefinitionBuilder, so the same graph declared with either client registers the same definition.
29
+ */
30
+ export class GraphDefinitionBuilder {
31
+ private readonly _schemaWriter = new GraphSchemaWriter();
32
+
33
+ /**
34
+ * Builds the registration of a graph.
35
+ * @param model - The {@link GraphModel}.
36
+ * @param projectionId - The identifier of the projection that fills the graph.
37
+ * @param sinkTypeId - The identifier of the sink type that stores the graph.
38
+ * @returns The {@link GraphRegistration}.
39
+ */
40
+ build(model: GraphModel, projectionId: string, sinkTypeId: string): GraphRegistration {
41
+ const nodes: Record<string, GraphNodeProjectionDefinition> = {};
42
+ for (const node of model.nodes) {
43
+ if (Object.hasOwn(nodes, node.label)) throw new GraphHasDuplicateElement(model.name, 'node', node.label);
44
+ nodes[node.label] = this.node(node);
45
+ }
46
+
47
+ const edges: Record<string, GraphEdgeProjectionDefinition> = {};
48
+ for (const edge of model.edges) {
49
+ if (Object.hasOwn(edges, edge.edgeType)) throw new GraphHasDuplicateElement(model.name, 'edge', edge.edgeType);
50
+ edges[edge.edgeType] = this.edge(edge);
51
+ }
52
+
53
+ const projection: ProjectionDefinition = {
54
+ EventSequenceId: EventSequenceId.eventLog.value,
55
+ Identifier: projectionId,
56
+ ReadModel: model.name,
57
+ IsActive: true,
58
+ IsRewindable: true,
59
+ InitialModelState: '{}',
60
+ From: [],
61
+ Join: [],
62
+ Children: {},
63
+ FromEvery: [],
64
+ All: { Properties: {}, IncludeChildren: false, AutoMap: AutoMap.Inherit, Key: '' },
65
+ FromEventProperty: undefined,
66
+ RemovedWith: [],
67
+ RemovedWithJoin: [],
68
+ LastUpdated: undefined,
69
+ Tags: [],
70
+ AutoMap: AutoMap.Inherit,
71
+ Nested: {},
72
+ SubscribesToAllEvents: false,
73
+ NoAutoMapProperties: [],
74
+ GenerationDelivery: EventGenerationDelivery.Compatibility,
75
+ Graph: { Nodes: nodes, Edges: edges }
76
+ };
77
+
78
+ return {
79
+ graphName: model.name,
80
+ readModel: buildReadModelDefinition({
81
+ identifier: model.name,
82
+ schema: this._schemaWriter.write(model),
83
+ sinkTypeId,
84
+ observerType: ReadModelObserverType.Projection,
85
+ observerIdentifier: projectionId
86
+ }),
87
+ projection
88
+ };
89
+ }
90
+
91
+ private node(node: GraphNodeModel): GraphNodeProjectionDefinition {
92
+ const properties = Object.keys(this._schemaWriter.propertiesOf(node.type, []));
93
+ const result: GraphNodeProjectionDefinition = { From: {}, RemovedWith: {} };
94
+ for (const from of node.from) {
95
+ result.From[this.eventTypeOf(from.eventType)] = {
96
+ Key: from.key ?? eventSourceId,
97
+ Properties: this.properties(from.eventType, properties.filter(name => name !== node.keyProperty), from.properties),
98
+ UpdateOnly: from.updateOnly,
99
+ ForEach: ''
100
+ };
101
+ }
102
+
103
+ for (const removal of node.removedWith) {
104
+ result.RemovedWith[this.eventTypeOf(removal.eventType)] = { Key: removal.key ?? eventSourceId, Detach: removal.detach, ForEach: '' };
105
+ }
106
+
107
+ return result;
108
+ }
109
+
110
+ private edge(edge: GraphEdgeModel): GraphEdgeProjectionDefinition {
111
+ const properties = Object.keys(this._schemaWriter.propertiesOf(edge.type, edge.excludedProperties));
112
+ const result: GraphEdgeProjectionDefinition = { From: {}, RemovedWith: {} };
113
+ for (const from of edge.from) {
114
+ result.From[this.eventTypeOf(from.eventType)] = {
115
+ SourceKey: from.sourceKey ?? eventSourceId,
116
+ TargetKey: from.targetKey ?? eventSourceId,
117
+ Identity: this.identity(edge, from.eventType, from.identity),
118
+ Properties: this.properties(from.eventType, properties.filter(name => name !== edge.identifyingProperty), from.properties),
119
+ ForEach: ''
120
+ };
121
+ }
122
+
123
+ for (const removal of edge.removedWith) {
124
+ result.RemovedWith[this.eventTypeOf(removal.eventType)] = {
125
+ SourceKey: removal.sourceKey ?? eventSourceId,
126
+ TargetKey: removal.targetKey ?? eventSourceId,
127
+ Identity: this.identity(edge, removal.eventType, removal.identity),
128
+ ForEach: ''
129
+ };
130
+ }
131
+
132
+ return result;
133
+ }
134
+
135
+ // The kernel keys the event mappings of a graph by the string form of the event type: id+generation.
136
+ private eventTypeOf(eventType: Function): string {
137
+ const contract = toContractEventType(eventType);
138
+ return `${contract.Id}+${contract.Generation}`;
139
+ }
140
+
141
+ private identity(edge: GraphEdgeModel, eventType: Function, identity: string | undefined): string {
142
+ if (edge.identifyingProperty === undefined) return '';
143
+ const resolved = identity ?? this.eventPropertyNamed(eventType, edge.identifyingProperty);
144
+ if (resolved === undefined) throw new UnknownGraphEventProperty(edge.type, eventType, edge.identifyingProperty);
145
+ return resolved;
146
+ }
147
+
148
+ private properties(eventType: Function, candidates: readonly string[], explicit: Readonly<Record<string, string>>): Record<string, string> {
149
+ const result: Record<string, string> = {};
150
+ for (const name of candidates) {
151
+ const expression = explicit[name] ?? this.eventPropertyNamed(eventType, name);
152
+ if (expression !== undefined) result[name] = expression;
153
+ }
154
+
155
+ for (const [name, expression] of Object.entries(explicit)) {
156
+ if (!Object.hasOwn(result, name)) result[name] = expression;
157
+ }
158
+
159
+ return result;
160
+ }
161
+
162
+ // A graph property is mapped from the event property of the same name, unless that one is an object.
163
+ private eventPropertyNamed(eventType: Function, graphPropertyName: string): string | undefined {
164
+ const schema = getEventTypeJsonSchemaFor(eventType).properties ?? {};
165
+ if (!TypeIntrospector.getMembers(eventType).has(graphPropertyName) && !Object.hasOwn(schema, graphPropertyName)) return undefined;
166
+ const property: JsonSchema | undefined = schema[graphPropertyName];
167
+ return property !== undefined && (property.type === 'object' || property.items?.type === 'object') ? undefined : graphPropertyName;
168
+ }
169
+ }