@cratis/chronicle 6.59.0 → 6.60.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 (359) 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/Projections.d.ts.map +1 -1
  27. package/dist/projections/Projections.js +3 -30
  28. package/dist/projections/Projections.js.map +1 -1
  29. package/dist/projections/for_Graphs/given/a_discovered_graph.d.ts +29 -0
  30. package/dist/projections/for_Graphs/given/a_discovered_graph.d.ts.map +1 -0
  31. package/dist/projections/for_Graphs/given/a_discovered_graph.js +19 -0
  32. package/dist/projections/for_Graphs/given/a_discovered_graph.js.map +1 -0
  33. package/dist/projections/for_Graphs/given/a_fake_connection.d.ts +24 -0
  34. package/dist/projections/for_Graphs/given/a_fake_connection.d.ts.map +1 -0
  35. package/dist/projections/for_Graphs/given/a_fake_connection.js +17 -0
  36. package/dist/projections/for_Graphs/given/a_fake_connection.js.map +1 -0
  37. package/dist/projections/for_Graphs/given/organization.d.ts +43 -0
  38. package/dist/projections/for_Graphs/given/organization.d.ts.map +1 -0
  39. package/dist/projections/for_Graphs/given/organization.js +84 -0
  40. package/dist/projections/for_Graphs/given/organization.js.map +1 -0
  41. package/dist/projections/graphs/EdgeCanHaveOnlyOneIdentifyingKey.d.ts +11 -0
  42. package/dist/projections/graphs/EdgeCanHaveOnlyOneIdentifyingKey.d.ts.map +1 -0
  43. package/dist/projections/graphs/EdgeCanHaveOnlyOneIdentifyingKey.js +16 -0
  44. package/dist/projections/graphs/EdgeCanHaveOnlyOneIdentifyingKey.js.map +1 -0
  45. package/dist/projections/graphs/EdgeMustHaveOneSourceAndOneTarget.d.ts +11 -0
  46. package/dist/projections/graphs/EdgeMustHaveOneSourceAndOneTarget.d.ts.map +1 -0
  47. package/dist/projections/graphs/EdgeMustHaveOneSourceAndOneTarget.js +16 -0
  48. package/dist/projections/graphs/EdgeMustHaveOneSourceAndOneTarget.js.map +1 -0
  49. package/dist/projections/graphs/GraphDeclaredMoreThanOnce.d.ts +11 -0
  50. package/dist/projections/graphs/GraphDeclaredMoreThanOnce.d.ts.map +1 -0
  51. package/dist/projections/graphs/GraphDeclaredMoreThanOnce.js +16 -0
  52. package/dist/projections/graphs/GraphDeclaredMoreThanOnce.js.map +1 -0
  53. package/dist/projections/graphs/GraphDefinitionBuilder.d.ts +24 -0
  54. package/dist/projections/graphs/GraphDefinitionBuilder.d.ts.map +1 -0
  55. package/dist/projections/graphs/GraphDefinitionBuilder.js +145 -0
  56. package/dist/projections/graphs/GraphDefinitionBuilder.js.map +1 -0
  57. package/dist/projections/graphs/GraphEdgeBuilder.d.ts +41 -0
  58. package/dist/projections/graphs/GraphEdgeBuilder.d.ts.map +1 -0
  59. package/dist/projections/graphs/GraphEdgeBuilder.js +94 -0
  60. package/dist/projections/graphs/GraphEdgeBuilder.js.map +1 -0
  61. package/dist/projections/graphs/GraphEdgeFromBuilder.d.ts +25 -0
  62. package/dist/projections/graphs/GraphEdgeFromBuilder.d.ts.map +1 -0
  63. package/dist/projections/graphs/GraphEdgeFromBuilder.js +37 -0
  64. package/dist/projections/graphs/GraphEdgeFromBuilder.js.map +1 -0
  65. package/dist/projections/graphs/GraphEdgeFromModel.d.ts +16 -0
  66. package/dist/projections/graphs/GraphEdgeFromModel.d.ts.map +1 -0
  67. package/dist/projections/graphs/GraphEdgeFromModel.js +4 -0
  68. package/dist/projections/graphs/GraphEdgeFromModel.js.map +1 -0
  69. package/dist/projections/graphs/GraphEdgeModel.d.ts +24 -0
  70. package/dist/projections/graphs/GraphEdgeModel.d.ts.map +1 -0
  71. package/dist/projections/graphs/GraphEdgeModel.js +4 -0
  72. package/dist/projections/graphs/GraphEdgeModel.js.map +1 -0
  73. package/dist/projections/graphs/GraphEdgeRemovedWithBuilder.d.ts +21 -0
  74. package/dist/projections/graphs/GraphEdgeRemovedWithBuilder.d.ts.map +1 -0
  75. package/dist/projections/graphs/GraphEdgeRemovedWithBuilder.js +31 -0
  76. package/dist/projections/graphs/GraphEdgeRemovedWithBuilder.js.map +1 -0
  77. package/dist/projections/graphs/GraphEdgeRemovedWithModel.d.ts +14 -0
  78. package/dist/projections/graphs/GraphEdgeRemovedWithModel.d.ts.map +1 -0
  79. package/dist/projections/graphs/GraphEdgeRemovedWithModel.js +4 -0
  80. package/dist/projections/graphs/GraphEdgeRemovedWithModel.js.map +1 -0
  81. package/dist/projections/graphs/GraphElementCannotBeReadModel.d.ts +11 -0
  82. package/dist/projections/graphs/GraphElementCannotBeReadModel.d.ts.map +1 -0
  83. package/dist/projections/graphs/GraphElementCannotBeReadModel.js +16 -0
  84. package/dist/projections/graphs/GraphElementCannotBeReadModel.js.map +1 -0
  85. package/dist/projections/graphs/GraphHasDuplicateElement.d.ts +13 -0
  86. package/dist/projections/graphs/GraphHasDuplicateElement.d.ts.map +1 -0
  87. package/dist/projections/graphs/GraphHasDuplicateElement.js +18 -0
  88. package/dist/projections/graphs/GraphHasDuplicateElement.js.map +1 -0
  89. package/dist/projections/graphs/GraphKeyPropertyNotFound.d.ts +12 -0
  90. package/dist/projections/graphs/GraphKeyPropertyNotFound.d.ts.map +1 -0
  91. package/dist/projections/graphs/GraphKeyPropertyNotFound.js +17 -0
  92. package/dist/projections/graphs/GraphKeyPropertyNotFound.js.map +1 -0
  93. package/dist/projections/graphs/GraphMappingBuilder.d.ts +32 -0
  94. package/dist/projections/graphs/GraphMappingBuilder.d.ts.map +1 -0
  95. package/dist/projections/graphs/GraphMappingBuilder.js +48 -0
  96. package/dist/projections/graphs/GraphMappingBuilder.js.map +1 -0
  97. package/dist/projections/graphs/GraphMemberMappings.d.ts +8 -0
  98. package/dist/projections/graphs/GraphMemberMappings.d.ts.map +1 -0
  99. package/dist/projections/graphs/GraphMemberMappings.js +54 -0
  100. package/dist/projections/graphs/GraphMemberMappings.js.map +1 -0
  101. package/dist/projections/graphs/GraphModel.d.ts +15 -0
  102. package/dist/projections/graphs/GraphModel.d.ts.map +1 -0
  103. package/dist/projections/graphs/GraphModel.js +4 -0
  104. package/dist/projections/graphs/GraphModel.js.map +1 -0
  105. package/dist/projections/graphs/GraphNameRequired.d.ts +11 -0
  106. package/dist/projections/graphs/GraphNameRequired.d.ts.map +1 -0
  107. package/dist/projections/graphs/GraphNameRequired.js +16 -0
  108. package/dist/projections/graphs/GraphNameRequired.js.map +1 -0
  109. package/dist/projections/graphs/GraphNodeBuilder.d.ts +34 -0
  110. package/dist/projections/graphs/GraphNodeBuilder.d.ts.map +1 -0
  111. package/dist/projections/graphs/GraphNodeBuilder.js +66 -0
  112. package/dist/projections/graphs/GraphNodeBuilder.js.map +1 -0
  113. package/dist/projections/graphs/GraphNodeFromBuilder.d.ts +21 -0
  114. package/dist/projections/graphs/GraphNodeFromBuilder.d.ts.map +1 -0
  115. package/dist/projections/graphs/GraphNodeFromBuilder.js +30 -0
  116. package/dist/projections/graphs/GraphNodeFromBuilder.js.map +1 -0
  117. package/dist/projections/graphs/GraphNodeFromModel.d.ts +14 -0
  118. package/dist/projections/graphs/GraphNodeFromModel.d.ts.map +1 -0
  119. package/dist/projections/graphs/GraphNodeFromModel.js +4 -0
  120. package/dist/projections/graphs/GraphNodeFromModel.js.map +1 -0
  121. package/dist/projections/graphs/GraphNodeModel.d.ts +18 -0
  122. package/dist/projections/graphs/GraphNodeModel.d.ts.map +1 -0
  123. package/dist/projections/graphs/GraphNodeModel.js +4 -0
  124. package/dist/projections/graphs/GraphNodeModel.js.map +1 -0
  125. package/dist/projections/graphs/GraphNodeRemovedWithBuilder.d.ts +17 -0
  126. package/dist/projections/graphs/GraphNodeRemovedWithBuilder.d.ts.map +1 -0
  127. package/dist/projections/graphs/GraphNodeRemovedWithBuilder.js +24 -0
  128. package/dist/projections/graphs/GraphNodeRemovedWithBuilder.js.map +1 -0
  129. package/dist/projections/graphs/GraphNodeRemovedWithModel.d.ts +12 -0
  130. package/dist/projections/graphs/GraphNodeRemovedWithModel.d.ts.map +1 -0
  131. package/dist/projections/graphs/GraphNodeRemovedWithModel.js +4 -0
  132. package/dist/projections/graphs/GraphNodeRemovedWithModel.js.map +1 -0
  133. package/dist/projections/graphs/GraphProjectionBuilder.d.ts +25 -0
  134. package/dist/projections/graphs/GraphProjectionBuilder.d.ts.map +1 -0
  135. package/dist/projections/graphs/GraphProjectionBuilder.js +36 -0
  136. package/dist/projections/graphs/GraphProjectionBuilder.js.map +1 -0
  137. package/dist/projections/graphs/GraphRegistration.d.ts +14 -0
  138. package/dist/projections/graphs/GraphRegistration.d.ts.map +1 -0
  139. package/dist/projections/graphs/GraphRegistration.js +4 -0
  140. package/dist/projections/graphs/GraphRegistration.js.map +1 -0
  141. package/dist/projections/graphs/GraphSchemaWriter.d.ts +28 -0
  142. package/dist/projections/graphs/GraphSchemaWriter.d.ts.map +1 -0
  143. package/dist/projections/graphs/GraphSchemaWriter.js +76 -0
  144. package/dist/projections/graphs/GraphSchemaWriter.js.map +1 -0
  145. package/dist/projections/graphs/Graphs.d.ts +39 -0
  146. package/dist/projections/graphs/Graphs.d.ts.map +1 -0
  147. package/dist/projections/graphs/Graphs.js +144 -0
  148. package/dist/projections/graphs/Graphs.js.map +1 -0
  149. package/dist/projections/graphs/IGraphEdgeBuilder.d.ts +37 -0
  150. package/dist/projections/graphs/IGraphEdgeBuilder.d.ts.map +1 -0
  151. package/dist/projections/graphs/IGraphEdgeBuilder.js +4 -0
  152. package/dist/projections/graphs/IGraphEdgeBuilder.js.map +1 -0
  153. package/dist/projections/graphs/IGraphEdgeFromBuilder.d.ts +29 -0
  154. package/dist/projections/graphs/IGraphEdgeFromBuilder.d.ts.map +1 -0
  155. package/dist/projections/graphs/IGraphEdgeFromBuilder.js +4 -0
  156. package/dist/projections/graphs/IGraphEdgeFromBuilder.js.map +1 -0
  157. package/dist/projections/graphs/IGraphEdgeRemovedWithBuilder.d.ts +27 -0
  158. package/dist/projections/graphs/IGraphEdgeRemovedWithBuilder.d.ts.map +1 -0
  159. package/dist/projections/graphs/IGraphEdgeRemovedWithBuilder.js +4 -0
  160. package/dist/projections/graphs/IGraphEdgeRemovedWithBuilder.js.map +1 -0
  161. package/dist/projections/graphs/IGraphMappingBuilder.d.ts +49 -0
  162. package/dist/projections/graphs/IGraphMappingBuilder.d.ts.map +1 -0
  163. package/dist/projections/graphs/IGraphMappingBuilder.js +4 -0
  164. package/dist/projections/graphs/IGraphMappingBuilder.js.map +1 -0
  165. package/dist/projections/graphs/IGraphNodeBuilder.d.ts +32 -0
  166. package/dist/projections/graphs/IGraphNodeBuilder.d.ts.map +1 -0
  167. package/dist/projections/graphs/IGraphNodeBuilder.js +4 -0
  168. package/dist/projections/graphs/IGraphNodeBuilder.js.map +1 -0
  169. package/dist/projections/graphs/IGraphNodeFromBuilder.d.ts +21 -0
  170. package/dist/projections/graphs/IGraphNodeFromBuilder.d.ts.map +1 -0
  171. package/dist/projections/graphs/IGraphNodeFromBuilder.js +4 -0
  172. package/dist/projections/graphs/IGraphNodeFromBuilder.js.map +1 -0
  173. package/dist/projections/graphs/IGraphNodeRemovedWithBuilder.d.ts +19 -0
  174. package/dist/projections/graphs/IGraphNodeRemovedWithBuilder.d.ts.map +1 -0
  175. package/dist/projections/graphs/IGraphNodeRemovedWithBuilder.js +4 -0
  176. package/dist/projections/graphs/IGraphNodeRemovedWithBuilder.js.map +1 -0
  177. package/dist/projections/graphs/IGraphProjection.d.ts +13 -0
  178. package/dist/projections/graphs/IGraphProjection.d.ts.map +1 -0
  179. package/dist/projections/graphs/IGraphProjection.js +4 -0
  180. package/dist/projections/graphs/IGraphProjection.js.map +1 -0
  181. package/dist/projections/graphs/IGraphProjectionBuilder.d.ts +26 -0
  182. package/dist/projections/graphs/IGraphProjectionBuilder.d.ts.map +1 -0
  183. package/dist/projections/graphs/IGraphProjectionBuilder.js +4 -0
  184. package/dist/projections/graphs/IGraphProjectionBuilder.js.map +1 -0
  185. package/dist/projections/graphs/IGraphs.d.ts +27 -0
  186. package/dist/projections/graphs/IGraphs.d.ts.map +1 -0
  187. package/dist/projections/graphs/IGraphs.js +4 -0
  188. package/dist/projections/graphs/IGraphs.js.map +1 -0
  189. package/dist/projections/graphs/ModelBoundGraphReader.d.ts +30 -0
  190. package/dist/projections/graphs/ModelBoundGraphReader.d.ts.map +1 -0
  191. package/dist/projections/graphs/ModelBoundGraphReader.js +112 -0
  192. package/dist/projections/graphs/ModelBoundGraphReader.js.map +1 -0
  193. package/dist/projections/graphs/NestedObjectInGraph.d.ts +12 -0
  194. package/dist/projections/graphs/NestedObjectInGraph.d.ts.map +1 -0
  195. package/dist/projections/graphs/NestedObjectInGraph.js +17 -0
  196. package/dist/projections/graphs/NestedObjectInGraph.js.map +1 -0
  197. package/dist/projections/graphs/NodeMustHaveExactlyOneKey.d.ts +12 -0
  198. package/dist/projections/graphs/NodeMustHaveExactlyOneKey.d.ts.map +1 -0
  199. package/dist/projections/graphs/NodeMustHaveExactlyOneKey.js +17 -0
  200. package/dist/projections/graphs/NodeMustHaveExactlyOneKey.js.map +1 -0
  201. package/dist/projections/graphs/UnknownGraphEventProperty.d.ts +13 -0
  202. package/dist/projections/graphs/UnknownGraphEventProperty.d.ts.map +1 -0
  203. package/dist/projections/graphs/UnknownGraphEventProperty.js +18 -0
  204. package/dist/projections/graphs/UnknownGraphEventProperty.js.map +1 -0
  205. package/dist/projections/graphs/UnknownGraphNode.d.ts +12 -0
  206. package/dist/projections/graphs/UnknownGraphNode.d.ts.map +1 -0
  207. package/dist/projections/graphs/UnknownGraphNode.js +17 -0
  208. package/dist/projections/graphs/UnknownGraphNode.js.map +1 -0
  209. package/dist/projections/graphs/edge.d.ts +23 -0
  210. package/dist/projections/graphs/edge.d.ts.map +1 -0
  211. package/dist/projections/graphs/edge.js +29 -0
  212. package/dist/projections/graphs/edge.js.map +1 -0
  213. package/dist/projections/graphs/edgeFrom.d.ts +31 -0
  214. package/dist/projections/graphs/edgeFrom.d.ts.map +1 -0
  215. package/dist/projections/graphs/edgeFrom.js +26 -0
  216. package/dist/projections/graphs/edgeFrom.js.map +1 -0
  217. package/dist/projections/graphs/edgeRemovedWith.d.ts +22 -0
  218. package/dist/projections/graphs/edgeRemovedWith.d.ts.map +1 -0
  219. package/dist/projections/graphs/edgeRemovedWith.js +25 -0
  220. package/dist/projections/graphs/edgeRemovedWith.js.map +1 -0
  221. package/dist/projections/graphs/edgeSource.d.ts +22 -0
  222. package/dist/projections/graphs/edgeSource.d.ts.map +1 -0
  223. package/dist/projections/graphs/edgeSource.js +30 -0
  224. package/dist/projections/graphs/edgeSource.js.map +1 -0
  225. package/dist/projections/graphs/edgeTarget.d.ts +22 -0
  226. package/dist/projections/graphs/edgeTarget.d.ts.map +1 -0
  227. package/dist/projections/graphs/edgeTarget.js +30 -0
  228. package/dist/projections/graphs/edgeTarget.js.map +1 -0
  229. package/dist/projections/graphs/graph.d.ts +16 -0
  230. package/dist/projections/graphs/graph.d.ts.map +1 -0
  231. package/dist/projections/graphs/graph.js +24 -0
  232. package/dist/projections/graphs/graph.js.map +1 -0
  233. package/dist/projections/graphs/graphKey.d.ts +16 -0
  234. package/dist/projections/graphs/graphKey.d.ts.map +1 -0
  235. package/dist/projections/graphs/graphKey.js +28 -0
  236. package/dist/projections/graphs/graphKey.js.map +1 -0
  237. package/dist/projections/graphs/graphProjection.d.ts +21 -0
  238. package/dist/projections/graphs/graphProjection.d.ts.map +1 -0
  239. package/dist/projections/graphs/graphProjection.js +28 -0
  240. package/dist/projections/graphs/graphProjection.js.map +1 -0
  241. package/dist/projections/graphs/index.d.ts +48 -0
  242. package/dist/projections/graphs/index.d.ts.map +1 -0
  243. package/dist/projections/graphs/index.js +27 -0
  244. package/dist/projections/graphs/index.js.map +1 -0
  245. package/dist/projections/graphs/isGraphElement.d.ts +7 -0
  246. package/dist/projections/graphs/isGraphElement.d.ts.map +1 -0
  247. package/dist/projections/graphs/isGraphElement.js +13 -0
  248. package/dist/projections/graphs/isGraphElement.js.map +1 -0
  249. package/dist/projections/graphs/node.d.ts +22 -0
  250. package/dist/projections/graphs/node.d.ts.map +1 -0
  251. package/dist/projections/graphs/node.js +29 -0
  252. package/dist/projections/graphs/node.js.map +1 -0
  253. package/dist/projections/graphs/nodeFrom.d.ts +31 -0
  254. package/dist/projections/graphs/nodeFrom.d.ts.map +1 -0
  255. package/dist/projections/graphs/nodeFrom.js +26 -0
  256. package/dist/projections/graphs/nodeFrom.js.map +1 -0
  257. package/dist/projections/graphs/nodeRemovedWith.d.ts +28 -0
  258. package/dist/projections/graphs/nodeRemovedWith.d.ts.map +1 -0
  259. package/dist/projections/graphs/nodeRemovedWith.js +25 -0
  260. package/dist/projections/graphs/nodeRemovedWith.js.map +1 -0
  261. package/dist/projections/graphs/propertyPathOf.d.ts +8 -0
  262. package/dist/projections/graphs/propertyPathOf.d.ts.map +1 -0
  263. package/dist/projections/graphs/propertyPathOf.js +14 -0
  264. package/dist/projections/graphs/propertyPathOf.js.map +1 -0
  265. package/dist/projections/index.d.ts +1 -0
  266. package/dist/projections/index.d.ts.map +1 -1
  267. package/dist/projections/index.js +1 -0
  268. package/dist/projections/index.js.map +1 -1
  269. package/dist/projections/registerProjectionWithRetry.d.ts +15 -0
  270. package/dist/projections/registerProjectionWithRetry.d.ts.map +1 -0
  271. package/dist/projections/registerProjectionWithRetry.js +44 -0
  272. package/dist/projections/registerProjectionWithRetry.js.map +1 -0
  273. package/dist/readModels/rootReadModelTypes.d.ts.map +1 -1
  274. package/dist/readModels/rootReadModelTypes.js +3 -1
  275. package/dist/readModels/rootReadModelTypes.js.map +1 -1
  276. package/dist/sinks/WellKnownSinks.d.ts +4 -0
  277. package/dist/sinks/WellKnownSinks.d.ts.map +1 -1
  278. package/dist/sinks/WellKnownSinks.js +5 -1
  279. package/dist/sinks/WellKnownSinks.js.map +1 -1
  280. package/dist/tsconfig.tsbuildinfo +1 -1
  281. package/dist/types/DecoratorType.d.ts +5 -1
  282. package/dist/types/DecoratorType.d.ts.map +1 -1
  283. package/dist/types/DecoratorType.js +4 -0
  284. package/dist/types/DecoratorType.js.map +1 -1
  285. package/for_ChronicleOptions/when_configuring_the_graph_sink/with_graph_sink_type.spec.ts +22 -0
  286. package/package.json +3 -3
  287. package/projections/Projections.ts +4 -29
  288. package/projections/for_Graphs/given/a_discovered_graph.ts +21 -0
  289. package/projections/for_Graphs/given/a_fake_connection.ts +19 -0
  290. package/projections/for_Graphs/given/organization.ts +96 -0
  291. package/projections/for_Graphs/when_building_a_fluent_graph.spec.ts +112 -0
  292. package/projections/for_Graphs/when_building_a_model_bound_graph.spec.ts +91 -0
  293. package/projections/for_Graphs/when_declaring_an_edge_with_an_identity.spec.ts +137 -0
  294. package/projections/for_Graphs/when_declaring_an_invalid_graph.spec.ts +199 -0
  295. package/projections/for_Graphs/when_declaring_with_standard_decorators.standard.spec.ts +92 -0
  296. package/projections/for_Graphs/when_discovering_graph_elements.spec.ts +32 -0
  297. package/projections/for_Graphs/when_mapping_properties.spec.ts +159 -0
  298. package/projections/for_Graphs/when_registering_graphs.spec.ts +56 -0
  299. package/projections/graphs/EdgeCanHaveOnlyOneIdentifyingKey.ts +16 -0
  300. package/projections/graphs/EdgeMustHaveOneSourceAndOneTarget.ts +16 -0
  301. package/projections/graphs/GraphDeclaredMoreThanOnce.ts +16 -0
  302. package/projections/graphs/GraphDefinitionBuilder.ts +166 -0
  303. package/projections/graphs/GraphEdgeBuilder.ts +107 -0
  304. package/projections/graphs/GraphEdgeFromBuilder.ts +47 -0
  305. package/projections/graphs/GraphEdgeFromModel.ts +22 -0
  306. package/projections/graphs/GraphEdgeModel.ts +34 -0
  307. package/projections/graphs/GraphEdgeRemovedWithBuilder.ts +39 -0
  308. package/projections/graphs/GraphEdgeRemovedWithModel.ts +19 -0
  309. package/projections/graphs/GraphElementCannotBeReadModel.ts +16 -0
  310. package/projections/graphs/GraphHasDuplicateElement.ts +18 -0
  311. package/projections/graphs/GraphKeyPropertyNotFound.ts +17 -0
  312. package/projections/graphs/GraphMappingBuilder.ts +65 -0
  313. package/projections/graphs/GraphMemberMappings.ts +57 -0
  314. package/projections/graphs/GraphModel.ts +20 -0
  315. package/projections/graphs/GraphNameRequired.ts +16 -0
  316. package/projections/graphs/GraphNodeBuilder.ts +76 -0
  317. package/projections/graphs/GraphNodeFromBuilder.ts +38 -0
  318. package/projections/graphs/GraphNodeFromModel.ts +19 -0
  319. package/projections/graphs/GraphNodeModel.ts +25 -0
  320. package/projections/graphs/GraphNodeRemovedWithBuilder.ts +30 -0
  321. package/projections/graphs/GraphNodeRemovedWithModel.ts +16 -0
  322. package/projections/graphs/GraphProjectionBuilder.ts +52 -0
  323. package/projections/graphs/GraphRegistration.ts +19 -0
  324. package/projections/graphs/GraphSchemaWriter.ts +80 -0
  325. package/projections/graphs/Graphs.ts +165 -0
  326. package/projections/graphs/IGraphEdgeBuilder.ts +43 -0
  327. package/projections/graphs/IGraphEdgeFromBuilder.ts +34 -0
  328. package/projections/graphs/IGraphEdgeRemovedWithBuilder.ts +32 -0
  329. package/projections/graphs/IGraphMappingBuilder.ts +57 -0
  330. package/projections/graphs/IGraphNodeBuilder.ts +37 -0
  331. package/projections/graphs/IGraphNodeFromBuilder.ts +25 -0
  332. package/projections/graphs/IGraphNodeRemovedWithBuilder.ts +23 -0
  333. package/projections/graphs/IGraphProjection.ts +16 -0
  334. package/projections/graphs/IGraphProjectionBuilder.ts +34 -0
  335. package/projections/graphs/IGraphs.ts +33 -0
  336. package/projections/graphs/ModelBoundGraphReader.ts +119 -0
  337. package/projections/graphs/NestedObjectInGraph.ts +17 -0
  338. package/projections/graphs/NodeMustHaveExactlyOneKey.ts +17 -0
  339. package/projections/graphs/UnknownGraphEventProperty.ts +18 -0
  340. package/projections/graphs/UnknownGraphNode.ts +17 -0
  341. package/projections/graphs/edge.ts +40 -0
  342. package/projections/graphs/edgeFrom.ts +48 -0
  343. package/projections/graphs/edgeRemovedWith.ts +36 -0
  344. package/projections/graphs/edgeSource.ts +39 -0
  345. package/projections/graphs/edgeTarget.ts +39 -0
  346. package/projections/graphs/graph.ts +28 -0
  347. package/projections/graphs/graphKey.ts +31 -0
  348. package/projections/graphs/graphProjection.ts +39 -0
  349. package/projections/graphs/index.ts +50 -0
  350. package/projections/graphs/isGraphElement.ts +14 -0
  351. package/projections/graphs/node.ts +40 -0
  352. package/projections/graphs/nodeFrom.ts +48 -0
  353. package/projections/graphs/nodeRemovedWith.ts +44 -0
  354. package/projections/graphs/propertyPathOf.ts +15 -0
  355. package/projections/index.ts +1 -0
  356. package/projections/registerProjectionWithRetry.ts +53 -0
  357. package/readModels/rootReadModelTypes.ts +3 -1
  358. package/sinks/WellKnownSinks.ts +7 -1
  359. package/types/DecoratorType.ts +7 -1
@@ -0,0 +1,166 @@
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
+ };
100
+ }
101
+
102
+ for (const removal of node.removedWith) {
103
+ result.RemovedWith[this.eventTypeOf(removal.eventType)] = { Key: removal.key ?? eventSourceId, Detach: removal.detach };
104
+ }
105
+
106
+ return result;
107
+ }
108
+
109
+ private edge(edge: GraphEdgeModel): GraphEdgeProjectionDefinition {
110
+ const properties = Object.keys(this._schemaWriter.propertiesOf(edge.type, edge.excludedProperties));
111
+ const result: GraphEdgeProjectionDefinition = { From: {}, RemovedWith: {} };
112
+ for (const from of edge.from) {
113
+ result.From[this.eventTypeOf(from.eventType)] = {
114
+ SourceKey: from.sourceKey ?? eventSourceId,
115
+ TargetKey: from.targetKey ?? eventSourceId,
116
+ Identity: this.identity(edge, from.eventType, from.identity),
117
+ Properties: this.properties(from.eventType, properties.filter(name => name !== edge.identifyingProperty), from.properties)
118
+ };
119
+ }
120
+
121
+ for (const removal of edge.removedWith) {
122
+ result.RemovedWith[this.eventTypeOf(removal.eventType)] = {
123
+ SourceKey: removal.sourceKey ?? eventSourceId,
124
+ TargetKey: removal.targetKey ?? eventSourceId,
125
+ Identity: this.identity(edge, removal.eventType, removal.identity)
126
+ };
127
+ }
128
+
129
+ return result;
130
+ }
131
+
132
+ // The kernel keys the event mappings of a graph by the string form of the event type: id+generation.
133
+ private eventTypeOf(eventType: Function): string {
134
+ const contract = toContractEventType(eventType);
135
+ return `${contract.Id}+${contract.Generation}`;
136
+ }
137
+
138
+ private identity(edge: GraphEdgeModel, eventType: Function, identity: string | undefined): string {
139
+ if (edge.identifyingProperty === undefined) return '';
140
+ const resolved = identity ?? this.eventPropertyNamed(eventType, edge.identifyingProperty);
141
+ if (resolved === undefined) throw new UnknownGraphEventProperty(edge.type, eventType, edge.identifyingProperty);
142
+ return resolved;
143
+ }
144
+
145
+ private properties(eventType: Function, candidates: readonly string[], explicit: Readonly<Record<string, string>>): Record<string, string> {
146
+ const result: Record<string, string> = {};
147
+ for (const name of candidates) {
148
+ const expression = explicit[name] ?? this.eventPropertyNamed(eventType, name);
149
+ if (expression !== undefined) result[name] = expression;
150
+ }
151
+
152
+ for (const [name, expression] of Object.entries(explicit)) {
153
+ if (!Object.hasOwn(result, name)) result[name] = expression;
154
+ }
155
+
156
+ return result;
157
+ }
158
+
159
+ // A graph property is mapped from the event property of the same name, unless that one is an object.
160
+ private eventPropertyNamed(eventType: Function, graphPropertyName: string): string | undefined {
161
+ const schema = getEventTypeJsonSchemaFor(eventType).properties ?? {};
162
+ if (!TypeIntrospector.getMembers(eventType).has(graphPropertyName) && !Object.hasOwn(schema, graphPropertyName)) return undefined;
163
+ const property: JsonSchema | undefined = schema[graphPropertyName];
164
+ return property !== undefined && (property.type === 'object' || property.items?.type === 'object') ? undefined : graphPropertyName;
165
+ }
166
+ }
@@ -0,0 +1,107 @@
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 { Constructor, PropertyAccessor } from '@cratis/fundamentals';
5
+ import { TypeIntrospector } from '../../types/index.js';
6
+ import { EdgeCanHaveOnlyOneIdentifyingKey } from './EdgeCanHaveOnlyOneIdentifyingKey.js';
7
+ import { EdgeMustHaveOneSourceAndOneTarget } from './EdgeMustHaveOneSourceAndOneTarget.js';
8
+ import { getEdgeMetadata } from './edge.js';
9
+ import { getEdgeSourceMetadata } from './edgeSource.js';
10
+ import { getEdgeTargetMetadata } from './edgeTarget.js';
11
+ import { GraphEdgeFromBuilder } from './GraphEdgeFromBuilder.js';
12
+ import type { GraphEdgeFromModel } from './GraphEdgeFromModel.js';
13
+ import type { GraphEdgeModel } from './GraphEdgeModel.js';
14
+ import { GraphEdgeRemovedWithBuilder } from './GraphEdgeRemovedWithBuilder.js';
15
+ import type { GraphEdgeRemovedWithModel } from './GraphEdgeRemovedWithModel.js';
16
+ import { isGraphKey } from './graphKey.js';
17
+ import type { IGraphEdgeBuilder } from './IGraphEdgeBuilder.js';
18
+ import type { IGraphEdgeFromBuilder } from './IGraphEdgeFromBuilder.js';
19
+ import type { IGraphEdgeRemovedWithBuilder } from './IGraphEdgeRemovedWithBuilder.js';
20
+ import { propertyPathOf } from './propertyPathOf.js';
21
+
22
+ /**
23
+ * Implements {@link IGraphEdgeBuilder}.
24
+ * @template TEdge - The type of edge.
25
+ */
26
+ export class GraphEdgeBuilder<TEdge> implements IGraphEdgeBuilder<TEdge> {
27
+ private readonly _from: GraphEdgeFromModel[] = [];
28
+ private readonly _removedWith: GraphEdgeRemovedWithModel[] = [];
29
+ private _type?: string;
30
+ private _identifyingProperty?: string;
31
+
32
+ /**
33
+ * Creates a new {@link GraphEdgeBuilder}.
34
+ * @param _edge - The type of the edge.
35
+ * @param _source - The type of the node the edge starts at.
36
+ * @param _target - The type of the node the edge ends at.
37
+ */
38
+ constructor(
39
+ private readonly _edge: Constructor<TEdge>,
40
+ private readonly _source: Function,
41
+ private readonly _target: Function
42
+ ) {}
43
+
44
+ /** @inheritdoc */
45
+ named(type: string): IGraphEdgeBuilder<TEdge> {
46
+ this._type = type;
47
+ return this;
48
+ }
49
+
50
+ /** @inheritdoc */
51
+ identifiedBy(identityAccessor: PropertyAccessor<TEdge>): IGraphEdgeBuilder<TEdge> {
52
+ this._identifyingProperty = propertyPathOf(identityAccessor);
53
+ return this;
54
+ }
55
+
56
+ /** @inheritdoc */
57
+ from<TEvent>(eventType: Constructor<TEvent>, configure: (builder: IGraphEdgeFromBuilder<TEdge, TEvent>) => void): IGraphEdgeBuilder<TEdge> {
58
+ const builder = new GraphEdgeFromBuilder<TEdge, TEvent>();
59
+ configure(builder);
60
+ this._from.push({
61
+ eventType,
62
+ sourceKey: builder.sourceKey,
63
+ targetKey: builder.targetKey,
64
+ identity: builder.identity,
65
+ properties: builder.properties
66
+ });
67
+ return this;
68
+ }
69
+
70
+ /** @inheritdoc */
71
+ removedWith<TEvent>(eventType: Constructor<TEvent>, configure: (builder: IGraphEdgeRemovedWithBuilder<TEvent>) => void): IGraphEdgeBuilder<TEdge> {
72
+ const builder = new GraphEdgeRemovedWithBuilder<TEvent>();
73
+ configure(builder);
74
+ this._removedWith.push({ eventType, sourceKey: builder.sourceKey, targetKey: builder.targetKey, identity: builder.identity });
75
+ return this;
76
+ }
77
+
78
+ /**
79
+ * Builds the {@link GraphEdgeModel}.
80
+ * @returns The model.
81
+ * @throws {EdgeMustHaveOneSourceAndOneTarget} When the end nodes are not types.
82
+ * @throws {EdgeCanHaveOnlyOneIdentifyingKey} When the type has more than one member with the graphKey decorator.
83
+ */
84
+ build(): GraphEdgeModel {
85
+ if (typeof this._source !== 'function' || typeof this._target !== 'function') {
86
+ throw new EdgeMustHaveOneSourceAndOneTarget(this._edge);
87
+ }
88
+
89
+ const members = TypeIntrospector.getTrackedProperties(this._edge);
90
+ const keys = members.filter(member => isGraphKey(this._edge.prototype, member));
91
+ if (keys.length > 1) throw new EdgeCanHaveOnlyOneIdentifyingKey(this._edge);
92
+
93
+ return {
94
+ type: this._edge,
95
+ edgeType: this._type ?? getEdgeMetadata(this._edge)?.type ?? this._edge.name,
96
+ sourceNode: this._source,
97
+ targetNode: this._target,
98
+ identifyingProperty: this._identifyingProperty ?? keys[0],
99
+ // The members that hold the keys of the end nodes are not properties of the edge.
100
+ excludedProperties: members.filter(member =>
101
+ getEdgeSourceMetadata(this._edge.prototype, member) !== undefined ||
102
+ getEdgeTargetMetadata(this._edge.prototype, member) !== undefined),
103
+ from: this._from,
104
+ removedWith: this._removedWith
105
+ };
106
+ }
107
+ }
@@ -0,0 +1,47 @@
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 { PropertyAccessor } from '@cratis/fundamentals';
5
+ import { GraphMappingBuilder } from './GraphMappingBuilder.js';
6
+ import type { IGraphEdgeFromBuilder } from './IGraphEdgeFromBuilder.js';
7
+ import { propertyPathOf } from './propertyPathOf.js';
8
+
9
+ /**
10
+ * Implements {@link IGraphEdgeFromBuilder}.
11
+ * @template TEdge - The type of edge.
12
+ * @template TEvent - The type of event.
13
+ */
14
+ export class GraphEdgeFromBuilder<TEdge, TEvent> extends GraphMappingBuilder<TEdge, TEvent, IGraphEdgeFromBuilder<TEdge, TEvent>>
15
+ implements IGraphEdgeFromBuilder<TEdge, TEvent> {
16
+ /** The expression for the key of the source node, or undefined for the event source id. */
17
+ sourceKey?: string;
18
+
19
+ /** The expression for the key of the target node, or undefined for the event source id. */
20
+ targetKey?: string;
21
+
22
+ /** The expression for the identity of the edge. */
23
+ identity?: string;
24
+
25
+ /** @inheritdoc */
26
+ protected get self(): IGraphEdgeFromBuilder<TEdge, TEvent> {
27
+ return this;
28
+ }
29
+
30
+ /** @inheritdoc */
31
+ usingSourceKey(keyAccessor: PropertyAccessor<TEvent>): IGraphEdgeFromBuilder<TEdge, TEvent> {
32
+ this.sourceKey = propertyPathOf(keyAccessor);
33
+ return this;
34
+ }
35
+
36
+ /** @inheritdoc */
37
+ usingTargetKey(keyAccessor: PropertyAccessor<TEvent>): IGraphEdgeFromBuilder<TEdge, TEvent> {
38
+ this.targetKey = propertyPathOf(keyAccessor);
39
+ return this;
40
+ }
41
+
42
+ /** @inheritdoc */
43
+ usingIdentity(identityAccessor: PropertyAccessor<TEvent>): IGraphEdgeFromBuilder<TEdge, TEvent> {
44
+ this.identity = propertyPathOf(identityAccessor);
45
+ return this;
46
+ }
47
+ }
@@ -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
+ /**
5
+ * Represents how an event creates or updates an edge.
6
+ */
7
+ export interface GraphEdgeFromModel {
8
+ /** The event type. */
9
+ readonly eventType: Function;
10
+
11
+ /** The expression for the key of the source node, or undefined for the event source id. */
12
+ readonly sourceKey?: string;
13
+
14
+ /** The expression for the key of the target node, or undefined for the event source id. */
15
+ readonly targetKey?: string;
16
+
17
+ /** The expression for the identity of the edge, for an edge type with an identifying property. */
18
+ readonly identity?: string;
19
+
20
+ /** The property mapping expressions by edge property name. */
21
+ readonly properties: Readonly<Record<string, string>>;
22
+ }
@@ -0,0 +1,34 @@
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 { GraphEdgeFromModel } from './GraphEdgeFromModel.js';
5
+ import type { GraphEdgeRemovedWithModel } from './GraphEdgeRemovedWithModel.js';
6
+
7
+ /**
8
+ * Represents an edge type with what it is projected from.
9
+ */
10
+ export interface GraphEdgeModel {
11
+ /** The type of the edge. */
12
+ readonly type: Function;
13
+
14
+ /** The edge type name, for example MEMBER_OF. */
15
+ readonly edgeType: string;
16
+
17
+ /** The type of the node the edge starts at. */
18
+ readonly sourceNode: Function;
19
+
20
+ /** The type of the node the edge ends at. */
21
+ readonly targetNode: Function;
22
+
23
+ /** The name of the identifying property, if any. */
24
+ readonly identifyingProperty?: string;
25
+
26
+ /** The names of the members that are not properties of the edge: the ones holding the keys of the end nodes. */
27
+ readonly excludedProperties: readonly string[];
28
+
29
+ /** The mappings that create or update edges. */
30
+ readonly from: readonly GraphEdgeFromModel[];
31
+
32
+ /** The mappings that delete edges. */
33
+ readonly removedWith: readonly GraphEdgeRemovedWithModel[];
34
+ }
@@ -0,0 +1,39 @@
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 { PropertyAccessor } from '@cratis/fundamentals';
5
+ import type { IGraphEdgeRemovedWithBuilder } from './IGraphEdgeRemovedWithBuilder.js';
6
+ import { propertyPathOf } from './propertyPathOf.js';
7
+
8
+ /**
9
+ * Implements {@link IGraphEdgeRemovedWithBuilder}.
10
+ * @template TEvent - The type of event.
11
+ */
12
+ export class GraphEdgeRemovedWithBuilder<TEvent> implements IGraphEdgeRemovedWithBuilder<TEvent> {
13
+ /** The expression for the key of the source node, or undefined for the event source id. */
14
+ sourceKey?: string;
15
+
16
+ /** The expression for the key of the target node, or undefined for the event source id. */
17
+ targetKey?: string;
18
+
19
+ /** The expression for the identity of the edge. */
20
+ identity?: string;
21
+
22
+ /** @inheritdoc */
23
+ usingSourceKey(keyAccessor: PropertyAccessor<TEvent>): IGraphEdgeRemovedWithBuilder<TEvent> {
24
+ this.sourceKey = propertyPathOf(keyAccessor);
25
+ return this;
26
+ }
27
+
28
+ /** @inheritdoc */
29
+ usingTargetKey(keyAccessor: PropertyAccessor<TEvent>): IGraphEdgeRemovedWithBuilder<TEvent> {
30
+ this.targetKey = propertyPathOf(keyAccessor);
31
+ return this;
32
+ }
33
+
34
+ /** @inheritdoc */
35
+ usingIdentity(identityAccessor: PropertyAccessor<TEvent>): IGraphEdgeRemovedWithBuilder<TEvent> {
36
+ this.identity = propertyPathOf(identityAccessor);
37
+ return this;
38
+ }
39
+ }
@@ -0,0 +1,19 @@
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
+ * Represents how an event deletes an edge.
6
+ */
7
+ export interface GraphEdgeRemovedWithModel {
8
+ /** The event type. */
9
+ readonly eventType: Function;
10
+
11
+ /** The expression for the key of the source node, or undefined for the event source id. */
12
+ readonly sourceKey?: string;
13
+
14
+ /** The expression for the key of the target node, or undefined for the event source id. */
15
+ readonly targetKey?: string;
16
+
17
+ /** The expression for the identity of the edge, for an edge type with an identifying property. */
18
+ readonly identity?: string;
19
+ }
@@ -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 a node or an edge is also declared as a read model with the fromEvent decorator.
6
+ */
7
+ export class GraphElementCannotBeReadModel extends Error {
8
+ /**
9
+ * Creates a new {@link GraphElementCannotBeReadModel}.
10
+ * @param type - The type.
11
+ */
12
+ constructor(type: Function) {
13
+ super(`The type '${type.name}' is a node or an edge in a graph and cannot also be a read model.`);
14
+ this.name = 'GraphElementCannotBeReadModel';
15
+ }
16
+ }
@@ -0,0 +1,18 @@
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 a graph has two nodes with the same label or two edges of the same type.
6
+ */
7
+ export class GraphHasDuplicateElement extends Error {
8
+ /**
9
+ * Creates a new {@link GraphHasDuplicateElement}.
10
+ * @param graph - The name of the graph.
11
+ * @param kind - Either node or edge.
12
+ * @param name - The label or type.
13
+ */
14
+ constructor(graph: string, kind: string, name: string) {
15
+ super(`The graph '${graph}' declares the ${kind} '${name}' more than once.`);
16
+ this.name = 'GraphHasDuplicateElement';
17
+ }
18
+ }
@@ -0,0 +1,17 @@
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 the key of a node or the identity of an edge is not a property of its type.
6
+ */
7
+ export class GraphKeyPropertyNotFound extends Error {
8
+ /**
9
+ * Creates a new {@link GraphKeyPropertyNotFound}.
10
+ * @param type - The node or edge type.
11
+ * @param property - The name of the key property.
12
+ */
13
+ constructor(type: Function, property: string) {
14
+ super(`The key '${property}' of '${type.name}' is not a property of the type. Declare it with an initializer or with the field decorator so its type can be resolved.`);
15
+ this.name = 'GraphKeyPropertyNotFound';
16
+ }
17
+ }
@@ -0,0 +1,65 @@
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 { PropertyAccessor } from '@cratis/fundamentals';
5
+ import { AddBuilder } from '../declarative/AddBuilder.js';
6
+ import type { IAddBuilder } from '../declarative/IAddBuilder.js';
7
+ import type { ISetBuilder } from '../declarative/ISetBuilder.js';
8
+ import type { ISubtractBuilder } from '../declarative/ISubtractBuilder.js';
9
+ import { SetBuilder } from '../declarative/SetBuilder.js';
10
+ import { SubtractBuilder } from '../declarative/SubtractBuilder.js';
11
+ import type { IGraphMappingBuilder } from './IGraphMappingBuilder.js';
12
+ import { propertyPathOf } from './propertyPathOf.js';
13
+
14
+ /**
15
+ * Implements the property mappings shared by nodes and edges, recording them as expressions by property name.
16
+ * @template TElement - The type of the node or edge.
17
+ * @template TEvent - The type of event.
18
+ * @template TSelf - The type of the builder, for continuation.
19
+ */
20
+ export abstract class GraphMappingBuilder<TElement, TEvent, TSelf> implements IGraphMappingBuilder<TElement, TEvent, TSelf> {
21
+ /** The property mapping expressions by property name. */
22
+ readonly properties: Record<string, string> = {};
23
+
24
+ /** Gets the builder to return for continuation. */
25
+ protected abstract get self(): TSelf;
26
+
27
+ /** @inheritdoc */
28
+ set(propertyAccessor: PropertyAccessor<TElement>): ISetBuilder<TEvent, TSelf> {
29
+ return new SetBuilder<TEvent, TSelf>(propertyPathOf(propertyAccessor), this.record, this.self);
30
+ }
31
+
32
+ /** @inheritdoc */
33
+ add(propertyAccessor: PropertyAccessor<TElement>): IAddBuilder<TEvent, TSelf> {
34
+ return new AddBuilder<TEvent, TSelf>(propertyPathOf(propertyAccessor), this.record, this.self);
35
+ }
36
+
37
+ /** @inheritdoc */
38
+ subtract(propertyAccessor: PropertyAccessor<TElement>): ISubtractBuilder<TEvent, TSelf> {
39
+ return new SubtractBuilder<TEvent, TSelf>(propertyPathOf(propertyAccessor), this.record, this.self);
40
+ }
41
+
42
+ /** @inheritdoc */
43
+ increment(propertyAccessor: PropertyAccessor<TElement>): TSelf {
44
+ return this.constant(propertyAccessor, '$increment');
45
+ }
46
+
47
+ /** @inheritdoc */
48
+ decrement(propertyAccessor: PropertyAccessor<TElement>): TSelf {
49
+ return this.constant(propertyAccessor, '$decrement');
50
+ }
51
+
52
+ /** @inheritdoc */
53
+ count(propertyAccessor: PropertyAccessor<TElement>): TSelf {
54
+ return this.constant(propertyAccessor, '$count');
55
+ }
56
+
57
+ private readonly record = (property: string, expression: string): void => {
58
+ this.properties[property] = expression;
59
+ };
60
+
61
+ private constant(propertyAccessor: PropertyAccessor<TElement>, expression: string): TSelf {
62
+ this.record(propertyPathOf(propertyAccessor), expression);
63
+ return this.self;
64
+ }
65
+ }
@@ -0,0 +1,57 @@
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 { constantValueExpression } from '../constantValueExpression.js';
5
+ import { eventContextPropertyExpression } from '../eventContextPropertyExpression.js';
6
+ import { getAddFromMetadata } from '../modelBound/addFrom.js';
7
+ import { getCountMetadata } from '../modelBound/count.js';
8
+ import { getDecrementMetadata } from '../modelBound/decrement.js';
9
+ import { getIncrementMetadata } from '../modelBound/increment.js';
10
+ import { getSetFromMetadata } from '../modelBound/setFrom.js';
11
+ import { getSetFromContextMetadata } from '../modelBound/setFromContext.js';
12
+ import { getSetValueMetadata } from '../modelBound/setValue.js';
13
+ import { getSubtractFromMetadata } from '../modelBound/subtractFrom.js';
14
+
15
+ /**
16
+ * Reads the property mappings the model-bound decorators on the members of a node or an edge declare per event type.
17
+ * @param prototype - The class prototype of the node or edge.
18
+ * @param properties - The names of the members to read.
19
+ * @returns For each event type, the property name to expression.
20
+ */
21
+ export function readGraphMemberMappings(prototype: object, properties: Iterable<string>): Map<Function, Record<string, string>> {
22
+ const result = new Map<Function, Record<string, string>>();
23
+ const record = (eventType: Function, property: string, expression: string) => {
24
+ const mappings = result.get(eventType) ?? {};
25
+ mappings[property] = expression;
26
+ result.set(eventType, mappings);
27
+ };
28
+
29
+ for (const property of properties) {
30
+ for (const mapping of getSetFromMetadata(prototype, property)) {
31
+ record(mapping.eventType, property, mapping.eventPropertyName ?? property);
32
+ }
33
+ for (const mapping of getSetFromContextMetadata(prototype, property)) {
34
+ record(mapping.eventType, property, eventContextPropertyExpression(mapping.contextPropertyName ?? property));
35
+ }
36
+ for (const mapping of getSetValueMetadata(prototype, property)) {
37
+ record(mapping.eventType, property, constantValueExpression(mapping.value));
38
+ }
39
+ for (const mapping of getAddFromMetadata(prototype, property)) {
40
+ record(mapping.eventType, property, `$add(${mapping.eventPropertyName ?? property})`);
41
+ }
42
+ for (const mapping of getSubtractFromMetadata(prototype, property)) {
43
+ record(mapping.eventType, property, `$subtract(${mapping.eventPropertyName ?? property})`);
44
+ }
45
+ for (const mapping of getIncrementMetadata(prototype, property)) {
46
+ record(mapping.eventType, property, '$increment');
47
+ }
48
+ for (const mapping of getDecrementMetadata(prototype, property)) {
49
+ record(mapping.eventType, property, '$decrement');
50
+ }
51
+ for (const mapping of getCountMetadata(prototype, property)) {
52
+ record(mapping.eventType, property, '$count');
53
+ }
54
+ }
55
+
56
+ return result;
57
+ }
@@ -0,0 +1,20 @@
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 { GraphEdgeModel } from './GraphEdgeModel.js';
5
+ import type { GraphNodeModel } from './GraphNodeModel.js';
6
+
7
+ /**
8
+ * Represents a graph as declared by the decorators or by the fluent builder, before it is turned into the
9
+ * definitions that are registered. Both forms produce this model, which is what makes them produce identical definitions.
10
+ */
11
+ export interface GraphModel {
12
+ /** The name of the graph. */
13
+ readonly name: string;
14
+
15
+ /** The nodes. */
16
+ readonly nodes: readonly GraphNodeModel[];
17
+
18
+ /** The edges. */
19
+ readonly edges: readonly GraphEdgeModel[];
20
+ }
@@ -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 a model-bound node or edge does not say which graph it belongs to.
6
+ */
7
+ export class GraphNameRequired extends Error {
8
+ /**
9
+ * Creates a new {@link GraphNameRequired}.
10
+ * @param type - The node or edge type.
11
+ */
12
+ constructor(type: Function) {
13
+ super(`The type '${type.name}' is a node or an edge but does not name its graph. Put the graph decorator on it, for example @graph('Organization').`);
14
+ this.name = 'GraphNameRequired';
15
+ }
16
+ }