@cratis/chronicle 6.62.0 → 6.64.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 (448) hide show
  1. package/ChronicleClient.ts +86 -3
  2. package/artifacts/DefaultClientArtifactsProvider.ts +5 -0
  3. package/artifacts/IClientArtifactsProvider.ts +3 -0
  4. package/connection/ConnectionLifecycle.ts +42 -1
  5. package/dist/ChronicleClient.d.ts +28 -1
  6. package/dist/ChronicleClient.d.ts.map +1 -1
  7. package/dist/ChronicleClient.js +71 -3
  8. package/dist/ChronicleClient.js.map +1 -1
  9. package/dist/artifacts/DefaultClientArtifactsProvider.d.ts +2 -0
  10. package/dist/artifacts/DefaultClientArtifactsProvider.d.ts.map +1 -1
  11. package/dist/artifacts/DefaultClientArtifactsProvider.js +4 -0
  12. package/dist/artifacts/DefaultClientArtifactsProvider.js.map +1 -1
  13. package/dist/artifacts/IClientArtifactsProvider.d.ts +2 -0
  14. package/dist/artifacts/IClientArtifactsProvider.d.ts.map +1 -1
  15. package/dist/connection/ConnectionLifecycle.d.ts +24 -0
  16. package/dist/connection/ConnectionLifecycle.d.ts.map +1 -1
  17. package/dist/connection/ConnectionLifecycle.js +40 -1
  18. package/dist/connection/ConnectionLifecycle.js.map +1 -1
  19. package/dist/observation/ObservationReconnectBackoff.d.ts +64 -0
  20. package/dist/observation/ObservationReconnectBackoff.d.ts.map +1 -0
  21. package/dist/observation/ObservationReconnectBackoff.js +75 -0
  22. package/dist/observation/ObservationReconnectBackoff.js.map +1 -0
  23. package/dist/observation/ObservationStreamOutcome.d.ts +10 -0
  24. package/dist/observation/ObservationStreamOutcome.d.ts.map +1 -0
  25. package/dist/observation/ObservationStreamOutcome.js +4 -0
  26. package/dist/observation/ObservationStreamOutcome.js.map +1 -0
  27. package/dist/observation/classifyStreamError.d.ts +25 -0
  28. package/dist/observation/classifyStreamError.d.ts.map +1 -0
  29. package/dist/observation/classifyStreamError.js +55 -0
  30. package/dist/observation/classifyStreamError.js.map +1 -0
  31. package/dist/observation/for_ObservationReconnectBackoff/given/a_backoff.d.ts +13 -0
  32. package/dist/observation/for_ObservationReconnectBackoff/given/a_backoff.d.ts.map +1 -0
  33. package/dist/observation/for_ObservationReconnectBackoff/given/a_backoff.js +25 -0
  34. package/dist/observation/for_ObservationReconnectBackoff/given/a_backoff.js.map +1 -0
  35. package/dist/observation/for_ObservationReconnectBackoff/given/a_scripted_stream.d.ts +27 -0
  36. package/dist/observation/for_ObservationReconnectBackoff/given/a_scripted_stream.d.ts.map +1 -0
  37. package/dist/observation/for_ObservationReconnectBackoff/given/a_scripted_stream.js +36 -0
  38. package/dist/observation/for_ObservationReconnectBackoff/given/a_scripted_stream.js.map +1 -0
  39. package/dist/projections/for_Graphs/given/a_discovered_graph.d.ts +2 -1
  40. package/dist/projections/for_Graphs/given/a_discovered_graph.d.ts.map +1 -1
  41. package/dist/projections/for_Graphs/given/a_discovered_graph.js +3 -2
  42. package/dist/projections/for_Graphs/given/a_discovered_graph.js.map +1 -1
  43. package/dist/projections/for_Graphs/given/a_graph_with_views.d.ts +40 -0
  44. package/dist/projections/for_Graphs/given/a_graph_with_views.d.ts.map +1 -0
  45. package/dist/projections/for_Graphs/given/a_graph_with_views.js +80 -0
  46. package/dist/projections/for_Graphs/given/a_graph_with_views.js.map +1 -0
  47. package/dist/projections/for_Graphs/given/organization.d.ts +2 -1
  48. package/dist/projections/for_Graphs/given/organization.d.ts.map +1 -1
  49. package/dist/projections/for_Graphs/given/organization.js +3 -2
  50. package/dist/projections/for_Graphs/given/organization.js.map +1 -1
  51. package/dist/projections/graphs/Graphs.d.ts +5 -0
  52. package/dist/projections/graphs/Graphs.d.ts.map +1 -1
  53. package/dist/projections/graphs/Graphs.js +43 -0
  54. package/dist/projections/graphs/Graphs.js.map +1 -1
  55. package/dist/projections/graphs/IGraphs.d.ts +9 -2
  56. package/dist/projections/graphs/IGraphs.d.ts.map +1 -1
  57. package/dist/projections/graphs/index.d.ts +1 -0
  58. package/dist/projections/graphs/index.d.ts.map +1 -1
  59. package/dist/projections/graphs/index.js +1 -0
  60. package/dist/projections/graphs/index.js.map +1 -1
  61. package/dist/projections/graphs/views/AmbiguousDirection.d.ts +16 -0
  62. package/dist/projections/graphs/views/AmbiguousDirection.d.ts.map +1 -0
  63. package/dist/projections/graphs/views/AmbiguousDirection.js +21 -0
  64. package/dist/projections/graphs/views/AmbiguousDirection.js.map +1 -0
  65. package/dist/projections/graphs/views/DuplicateViewName.d.ts +16 -0
  66. package/dist/projections/graphs/views/DuplicateViewName.d.ts.map +1 -0
  67. package/dist/projections/graphs/views/DuplicateViewName.js +21 -0
  68. package/dist/projections/graphs/views/DuplicateViewName.js.map +1 -0
  69. package/dist/projections/graphs/views/EdgeNotIncidentOnRoot.d.ts +17 -0
  70. package/dist/projections/graphs/views/EdgeNotIncidentOnRoot.d.ts.map +1 -0
  71. package/dist/projections/graphs/views/EdgeNotIncidentOnRoot.js +22 -0
  72. package/dist/projections/graphs/views/EdgeNotIncidentOnRoot.js.map +1 -0
  73. package/dist/projections/graphs/views/EdgePropertyViewNotUsedAsTarget.d.ts +14 -0
  74. package/dist/projections/graphs/views/EdgePropertyViewNotUsedAsTarget.d.ts.map +1 -0
  75. package/dist/projections/graphs/views/EdgePropertyViewNotUsedAsTarget.js +19 -0
  76. package/dist/projections/graphs/views/EdgePropertyViewNotUsedAsTarget.js.map +1 -0
  77. package/dist/projections/graphs/views/EdgePropertyViewSharedAcrossEdges.d.ts +15 -0
  78. package/dist/projections/graphs/views/EdgePropertyViewSharedAcrossEdges.d.ts.map +1 -0
  79. package/dist/projections/graphs/views/EdgePropertyViewSharedAcrossEdges.js +20 -0
  80. package/dist/projections/graphs/views/EdgePropertyViewSharedAcrossEdges.js.map +1 -0
  81. package/dist/projections/graphs/views/FollowsOptions.d.ts +16 -0
  82. package/dist/projections/graphs/views/FollowsOptions.d.ts.map +1 -0
  83. package/dist/projections/graphs/views/FollowsOptions.js +4 -0
  84. package/dist/projections/graphs/views/FollowsOptions.js.map +1 -0
  85. package/dist/projections/graphs/views/GraphEdgeDirection.d.ts +10 -0
  86. package/dist/projections/graphs/views/GraphEdgeDirection.d.ts.map +1 -0
  87. package/dist/projections/graphs/views/GraphEdgeDirection.js +13 -0
  88. package/dist/projections/graphs/views/GraphEdgeDirection.js.map +1 -0
  89. package/dist/projections/graphs/views/GraphView.d.ts +13 -0
  90. package/dist/projections/graphs/views/GraphView.d.ts.map +1 -0
  91. package/dist/projections/graphs/views/GraphView.js +4 -0
  92. package/dist/projections/graphs/views/GraphView.js.map +1 -0
  93. package/dist/projections/graphs/views/GraphViewBuildResult.d.ts +15 -0
  94. package/dist/projections/graphs/views/GraphViewBuildResult.d.ts.map +1 -0
  95. package/dist/projections/graphs/views/GraphViewBuildResult.js +4 -0
  96. package/dist/projections/graphs/views/GraphViewBuildResult.js.map +1 -0
  97. package/dist/projections/graphs/views/GraphViewCardinality.d.ts +10 -0
  98. package/dist/projections/graphs/views/GraphViewCardinality.d.ts.map +1 -0
  99. package/dist/projections/graphs/views/GraphViewCardinality.js +13 -0
  100. package/dist/projections/graphs/views/GraphViewCardinality.js.map +1 -0
  101. package/dist/projections/graphs/views/GraphViewDefinition.d.ts +15 -0
  102. package/dist/projections/graphs/views/GraphViewDefinition.d.ts.map +1 -0
  103. package/dist/projections/graphs/views/GraphViewDefinition.js +4 -0
  104. package/dist/projections/graphs/views/GraphViewDefinition.js.map +1 -0
  105. package/dist/projections/graphs/views/GraphViewDefinitionBuilder.d.ts +30 -0
  106. package/dist/projections/graphs/views/GraphViewDefinitionBuilder.d.ts.map +1 -0
  107. package/dist/projections/graphs/views/GraphViewDefinitionBuilder.js +259 -0
  108. package/dist/projections/graphs/views/GraphViewDefinitionBuilder.js.map +1 -0
  109. package/dist/projections/graphs/views/GraphViewDefinitionSerializer.d.ts +21 -0
  110. package/dist/projections/graphs/views/GraphViewDefinitionSerializer.d.ts.map +1 -0
  111. package/dist/projections/graphs/views/GraphViewDefinitionSerializer.js +77 -0
  112. package/dist/projections/graphs/views/GraphViewDefinitionSerializer.js.map +1 -0
  113. package/dist/projections/graphs/views/GraphViewEdgeReference.d.ts +6 -0
  114. package/dist/projections/graphs/views/GraphViewEdgeReference.d.ts.map +1 -0
  115. package/dist/projections/graphs/views/GraphViewEdgeReference.js +4 -0
  116. package/dist/projections/graphs/views/GraphViewEdgeReference.js.map +1 -0
  117. package/dist/projections/graphs/views/GraphViewMember.d.ts +8 -0
  118. package/dist/projections/graphs/views/GraphViewMember.d.ts.map +1 -0
  119. package/dist/projections/graphs/views/GraphViewMember.js +4 -0
  120. package/dist/projections/graphs/views/GraphViewMember.js.map +1 -0
  121. package/dist/projections/graphs/views/GraphViewMemberKind.d.ts +12 -0
  122. package/dist/projections/graphs/views/GraphViewMemberKind.d.ts.map +1 -0
  123. package/dist/projections/graphs/views/GraphViewMemberKind.js +15 -0
  124. package/dist/projections/graphs/views/GraphViewMemberKind.js.map +1 -0
  125. package/dist/projections/graphs/views/GraphViewMemberMetadata.d.ts +22 -0
  126. package/dist/projections/graphs/views/GraphViewMemberMetadata.d.ts.map +1 -0
  127. package/dist/projections/graphs/views/GraphViewMemberMetadata.js +4 -0
  128. package/dist/projections/graphs/views/GraphViewMemberMetadata.js.map +1 -0
  129. package/dist/projections/graphs/views/GraphViewPropertyMember.d.ts +13 -0
  130. package/dist/projections/graphs/views/GraphViewPropertyMember.d.ts.map +1 -0
  131. package/dist/projections/graphs/views/GraphViewPropertyMember.js +4 -0
  132. package/dist/projections/graphs/views/GraphViewPropertyMember.js.map +1 -0
  133. package/dist/projections/graphs/views/GraphViewReason.d.ts +33 -0
  134. package/dist/projections/graphs/views/GraphViewReason.d.ts.map +1 -0
  135. package/dist/projections/graphs/views/GraphViewReason.js +36 -0
  136. package/dist/projections/graphs/views/GraphViewReason.js.map +1 -0
  137. package/dist/projections/graphs/views/GraphViewRelationMember.d.ts +21 -0
  138. package/dist/projections/graphs/views/GraphViewRelationMember.d.ts.map +1 -0
  139. package/dist/projections/graphs/views/GraphViewRelationMember.js +4 -0
  140. package/dist/projections/graphs/views/GraphViewRelationMember.js.map +1 -0
  141. package/dist/projections/graphs/views/GraphViewSchema.d.ts +10 -0
  142. package/dist/projections/graphs/views/GraphViewSchema.d.ts.map +1 -0
  143. package/dist/projections/graphs/views/GraphViewSchema.js +4 -0
  144. package/dist/projections/graphs/views/GraphViewSchema.js.map +1 -0
  145. package/dist/projections/graphs/views/GraphViewSchemaEdge.d.ts +14 -0
  146. package/dist/projections/graphs/views/GraphViewSchemaEdge.d.ts.map +1 -0
  147. package/dist/projections/graphs/views/GraphViewSchemaEdge.js +4 -0
  148. package/dist/projections/graphs/views/GraphViewSchemaEdge.js.map +1 -0
  149. package/dist/projections/graphs/views/GraphViewSchemaNode.d.ts +10 -0
  150. package/dist/projections/graphs/views/GraphViewSchemaNode.d.ts.map +1 -0
  151. package/dist/projections/graphs/views/GraphViewSchemaNode.js +4 -0
  152. package/dist/projections/graphs/views/GraphViewSchemaNode.js.map +1 -0
  153. package/dist/projections/graphs/views/GraphViewSerializerOptions.d.ts +9 -0
  154. package/dist/projections/graphs/views/GraphViewSerializerOptions.d.ts.map +1 -0
  155. package/dist/projections/graphs/views/GraphViewSerializerOptions.js +4 -0
  156. package/dist/projections/graphs/views/GraphViewSerializerOptions.js.map +1 -0
  157. package/dist/projections/graphs/views/RecursiveView.d.ts +15 -0
  158. package/dist/projections/graphs/views/RecursiveView.d.ts.map +1 -0
  159. package/dist/projections/graphs/views/RecursiveView.js +20 -0
  160. package/dist/projections/graphs/views/RecursiveView.js.map +1 -0
  161. package/dist/projections/graphs/views/RelationTargetNotAView.d.ts +16 -0
  162. package/dist/projections/graphs/views/RelationTargetNotAView.d.ts.map +1 -0
  163. package/dist/projections/graphs/views/RelationTargetNotAView.js +21 -0
  164. package/dist/projections/graphs/views/RelationTargetNotAView.js.map +1 -0
  165. package/dist/projections/graphs/views/TargetLabelMismatch.d.ts +18 -0
  166. package/dist/projections/graphs/views/TargetLabelMismatch.d.ts.map +1 -0
  167. package/dist/projections/graphs/views/TargetLabelMismatch.js +23 -0
  168. package/dist/projections/graphs/views/TargetLabelMismatch.js.map +1 -0
  169. package/dist/projections/graphs/views/UnknownEdge.d.ts +16 -0
  170. package/dist/projections/graphs/views/UnknownEdge.d.ts.map +1 -0
  171. package/dist/projections/graphs/views/UnknownEdge.js +21 -0
  172. package/dist/projections/graphs/views/UnknownEdge.js.map +1 -0
  173. package/dist/projections/graphs/views/UnknownEdgeProperty.d.ts +17 -0
  174. package/dist/projections/graphs/views/UnknownEdgeProperty.d.ts.map +1 -0
  175. package/dist/projections/graphs/views/UnknownEdgeProperty.js +22 -0
  176. package/dist/projections/graphs/views/UnknownEdgeProperty.js.map +1 -0
  177. package/dist/projections/graphs/views/UnknownNodeProperty.d.ts +17 -0
  178. package/dist/projections/graphs/views/UnknownNodeProperty.d.ts.map +1 -0
  179. package/dist/projections/graphs/views/UnknownNodeProperty.js +22 -0
  180. package/dist/projections/graphs/views/UnknownNodeProperty.js.map +1 -0
  181. package/dist/projections/graphs/views/ViewIsAlsoSchema.d.ts +14 -0
  182. package/dist/projections/graphs/views/ViewIsAlsoSchema.d.ts.map +1 -0
  183. package/dist/projections/graphs/views/ViewIsAlsoSchema.js +19 -0
  184. package/dist/projections/graphs/views/ViewIsAlsoSchema.js.map +1 -0
  185. package/dist/projections/graphs/views/ViewOfMetadata.d.ts +8 -0
  186. package/dist/projections/graphs/views/ViewOfMetadata.d.ts.map +1 -0
  187. package/dist/projections/graphs/views/ViewOfMetadata.js +4 -0
  188. package/dist/projections/graphs/views/ViewOfMetadata.js.map +1 -0
  189. package/dist/projections/graphs/views/ViewOfOptions.d.ts +6 -0
  190. package/dist/projections/graphs/views/ViewOfOptions.d.ts.map +1 -0
  191. package/dist/projections/graphs/views/ViewOfOptions.js +4 -0
  192. package/dist/projections/graphs/views/ViewOfOptions.js.map +1 -0
  193. package/dist/projections/graphs/views/ViewRootNotANode.d.ts +16 -0
  194. package/dist/projections/graphs/views/ViewRootNotANode.d.ts.map +1 -0
  195. package/dist/projections/graphs/views/ViewRootNotANode.js +21 -0
  196. package/dist/projections/graphs/views/ViewRootNotANode.js.map +1 -0
  197. package/dist/projections/graphs/views/declareGraphViewMember.d.ts +17 -0
  198. package/dist/projections/graphs/views/declareGraphViewMember.d.ts.map +1 -0
  199. package/dist/projections/graphs/views/declareGraphViewMember.js +31 -0
  200. package/dist/projections/graphs/views/declareGraphViewMember.js.map +1 -0
  201. package/dist/projections/graphs/views/follows.d.ts +13 -0
  202. package/dist/projections/graphs/views/follows.d.ts.map +1 -0
  203. package/dist/projections/graphs/views/follows.js +24 -0
  204. package/dist/projections/graphs/views/follows.js.map +1 -0
  205. package/dist/projections/graphs/views/fromEdge.d.ts +10 -0
  206. package/dist/projections/graphs/views/fromEdge.d.ts.map +1 -0
  207. package/dist/projections/graphs/views/fromEdge.js +15 -0
  208. package/dist/projections/graphs/views/fromEdge.js.map +1 -0
  209. package/dist/projections/graphs/views/index.d.ts +41 -0
  210. package/dist/projections/graphs/views/index.d.ts.map +1 -0
  211. package/dist/projections/graphs/views/index.js +28 -0
  212. package/dist/projections/graphs/views/index.js.map +1 -0
  213. package/dist/projections/graphs/views/viewKey.d.ts +8 -0
  214. package/dist/projections/graphs/views/viewKey.d.ts.map +1 -0
  215. package/dist/projections/graphs/views/viewKey.js +13 -0
  216. package/dist/projections/graphs/views/viewKey.js.map +1 -0
  217. package/dist/projections/graphs/views/viewOf.d.ts +22 -0
  218. package/dist/projections/graphs/views/viewOf.d.ts.map +1 -0
  219. package/dist/projections/graphs/views/viewOf.js +41 -0
  220. package/dist/projections/graphs/views/viewOf.js.map +1 -0
  221. package/dist/projections/graphs/views/viewProperty.d.ts +9 -0
  222. package/dist/projections/graphs/views/viewProperty.d.ts.map +1 -0
  223. package/dist/projections/graphs/views/viewProperty.js +14 -0
  224. package/dist/projections/graphs/views/viewProperty.js.map +1 -0
  225. package/dist/reactors/Reactors.d.ts +15 -5
  226. package/dist/reactors/Reactors.d.ts.map +1 -1
  227. package/dist/reactors/Reactors.js +95 -18
  228. package/dist/reactors/Reactors.js.map +1 -1
  229. package/dist/reactors/for_Reactors/when_reconnecting_the_observation_stream/given/a_reactor_whose_stream_ends.d.ts +26 -0
  230. package/dist/reactors/for_Reactors/when_reconnecting_the_observation_stream/given/a_reactor_whose_stream_ends.d.ts.map +1 -0
  231. package/dist/reactors/for_Reactors/when_reconnecting_the_observation_stream/given/a_reactor_whose_stream_ends.js +64 -0
  232. package/dist/reactors/for_Reactors/when_reconnecting_the_observation_stream/given/a_reactor_whose_stream_ends.js.map +1 -0
  233. package/dist/reducers/Reducers.d.ts +11 -5
  234. package/dist/reducers/Reducers.d.ts.map +1 -1
  235. package/dist/reducers/Reducers.js +93 -19
  236. package/dist/reducers/Reducers.js.map +1 -1
  237. package/dist/reducers/for_Reducers/when_reconnecting_the_observation_stream/given/a_reducer_whose_stream_ends.d.ts +25 -0
  238. package/dist/reducers/for_Reducers/when_reconnecting_the_observation_stream/given/a_reducer_whose_stream_ends.d.ts.map +1 -0
  239. package/dist/reducers/for_Reducers/when_reconnecting_the_observation_stream/given/a_reducer_whose_stream_ends.js +70 -0
  240. package/dist/reducers/for_Reducers/when_reconnecting_the_observation_stream/given/a_reducer_whose_stream_ends.js.map +1 -0
  241. package/dist/testing/InProcessAppendMetadata.d.ts +30 -0
  242. package/dist/testing/InProcessAppendMetadata.d.ts.map +1 -0
  243. package/dist/testing/InProcessAppendMetadata.js +107 -0
  244. package/dist/testing/InProcessAppendMetadata.js.map +1 -0
  245. package/dist/testing/InProcessBatchAppend.d.ts +62 -0
  246. package/dist/testing/InProcessBatchAppend.d.ts.map +1 -0
  247. package/dist/testing/InProcessBatchAppend.js +131 -0
  248. package/dist/testing/InProcessBatchAppend.js.map +1 -0
  249. package/dist/testing/InProcessEventPayload.d.ts +23 -0
  250. package/dist/testing/InProcessEventPayload.d.ts.map +1 -0
  251. package/dist/testing/InProcessEventPayload.js +94 -0
  252. package/dist/testing/InProcessEventPayload.js.map +1 -0
  253. package/dist/testing/InProcessEventReadCriteria.d.ts +9 -0
  254. package/dist/testing/InProcessEventReadCriteria.d.ts.map +1 -0
  255. package/dist/testing/InProcessEventReadCriteria.js +4 -0
  256. package/dist/testing/InProcessEventReadCriteria.js.map +1 -0
  257. package/dist/testing/InProcessEventReadFilter.d.ts +14 -0
  258. package/dist/testing/InProcessEventReadFilter.d.ts.map +1 -0
  259. package/dist/testing/InProcessEventReadFilter.js +31 -0
  260. package/dist/testing/InProcessEventReadFilter.js.map +1 -0
  261. package/dist/testing/InProcessEventSequence.d.ts +8 -5
  262. package/dist/testing/InProcessEventSequence.d.ts.map +1 -1
  263. package/dist/testing/InProcessEventSequence.js +59 -275
  264. package/dist/testing/InProcessEventSequence.js.map +1 -1
  265. package/dist/testing/InProcessEventSequenceEnvironment.d.ts +13 -0
  266. package/dist/testing/InProcessEventSequenceEnvironment.d.ts.map +1 -0
  267. package/dist/testing/InProcessEventSequenceEnvironment.js +4 -0
  268. package/dist/testing/InProcessEventSequenceEnvironment.js.map +1 -0
  269. package/dist/testing/InProcessSingleAppend.d.ts +34 -0
  270. package/dist/testing/InProcessSingleAppend.d.ts.map +1 -0
  271. package/dist/testing/InProcessSingleAppend.js +95 -0
  272. package/dist/testing/InProcessSingleAppend.js.map +1 -0
  273. package/dist/testing/projections/ProjectionCapabilities.d.ts +0 -8
  274. package/dist/testing/projections/ProjectionCapabilities.d.ts.map +1 -1
  275. package/dist/testing/projections/ProjectionCapabilities.js +21 -312
  276. package/dist/testing/projections/ProjectionCapabilities.js.map +1 -1
  277. package/dist/testing/projections/ProjectionCapabilityReject.d.ts +3 -0
  278. package/dist/testing/projections/ProjectionCapabilityReject.d.ts.map +1 -0
  279. package/dist/testing/projections/ProjectionCapabilityReject.js +4 -0
  280. package/dist/testing/projections/ProjectionCapabilityReject.js.map +1 -0
  281. package/dist/testing/projections/ProjectionCapabilityReporter.d.ts +12 -0
  282. package/dist/testing/projections/ProjectionCapabilityReporter.d.ts.map +1 -0
  283. package/dist/testing/projections/ProjectionCapabilityReporter.js +33 -0
  284. package/dist/testing/projections/ProjectionCapabilityReporter.js.map +1 -0
  285. package/dist/testing/projections/ProjectionDefinitionCapabilities.d.ts +11 -0
  286. package/dist/testing/projections/ProjectionDefinitionCapabilities.d.ts.map +1 -0
  287. package/dist/testing/projections/ProjectionDefinitionCapabilities.js +45 -0
  288. package/dist/testing/projections/ProjectionDefinitionCapabilities.js.map +1 -0
  289. package/dist/testing/projections/ProjectionEventSchemaResolver.d.ts +13 -0
  290. package/dist/testing/projections/ProjectionEventSchemaResolver.d.ts.map +1 -0
  291. package/dist/testing/projections/ProjectionEventSchemaResolver.js +22 -0
  292. package/dist/testing/projections/ProjectionEventSchemaResolver.js.map +1 -0
  293. package/dist/testing/projections/ProjectionExpressionCapabilities.d.ts +19 -0
  294. package/dist/testing/projections/ProjectionExpressionCapabilities.d.ts.map +1 -0
  295. package/dist/testing/projections/ProjectionExpressionCapabilities.js +103 -0
  296. package/dist/testing/projections/ProjectionExpressionCapabilities.js.map +1 -0
  297. package/dist/testing/projections/ProjectionInitialValueCapabilities.d.ts +16 -0
  298. package/dist/testing/projections/ProjectionInitialValueCapabilities.d.ts.map +1 -0
  299. package/dist/testing/projections/ProjectionInitialValueCapabilities.js +72 -0
  300. package/dist/testing/projections/ProjectionInitialValueCapabilities.js.map +1 -0
  301. package/dist/testing/projections/ProjectionMappingCapabilities.d.ts +21 -0
  302. package/dist/testing/projections/ProjectionMappingCapabilities.d.ts.map +1 -0
  303. package/dist/testing/projections/ProjectionMappingCapabilities.js +86 -0
  304. package/dist/testing/projections/ProjectionMappingCapabilities.js.map +1 -0
  305. package/dist/testing/projections/ProjectionMappingValidation.d.ts +9 -0
  306. package/dist/testing/projections/ProjectionMappingValidation.d.ts.map +1 -0
  307. package/dist/testing/projections/ProjectionMappingValidation.js +4 -0
  308. package/dist/testing/projections/ProjectionMappingValidation.js.map +1 -0
  309. package/dist/testing/projections/ProjectionReadModelCapabilities.d.ts +11 -0
  310. package/dist/testing/projections/ProjectionReadModelCapabilities.d.ts.map +1 -0
  311. package/dist/testing/projections/ProjectionReadModelCapabilities.js +40 -0
  312. package/dist/testing/projections/ProjectionReadModelCapabilities.js.map +1 -0
  313. package/dist/testing/projections/ProjectionRootCapabilities.d.ts +20 -0
  314. package/dist/testing/projections/ProjectionRootCapabilities.d.ts.map +1 -0
  315. package/dist/testing/projections/ProjectionRootCapabilities.js +73 -0
  316. package/dist/testing/projections/ProjectionRootCapabilities.js.map +1 -0
  317. package/dist/testing/projections/ProjectionScalarConverter.d.ts +21 -0
  318. package/dist/testing/projections/ProjectionScalarConverter.d.ts.map +1 -0
  319. package/dist/testing/projections/ProjectionScalarConverter.js +105 -0
  320. package/dist/testing/projections/ProjectionScalarConverter.js.map +1 -0
  321. package/dist/testing/projections/ProjectionSchemaCapabilities.d.ts +26 -0
  322. package/dist/testing/projections/ProjectionSchemaCapabilities.d.ts.map +1 -0
  323. package/dist/testing/projections/ProjectionSchemaCapabilities.js +109 -0
  324. package/dist/testing/projections/ProjectionSchemaCapabilities.js.map +1 -0
  325. package/dist/testing/projections/ProjectionValueConverter.d.ts +5 -0
  326. package/dist/testing/projections/ProjectionValueConverter.d.ts.map +1 -1
  327. package/dist/testing/projections/ProjectionValueConverter.js +36 -84
  328. package/dist/testing/projections/ProjectionValueConverter.js.map +1 -1
  329. package/dist/tsconfig.tsbuildinfo +1 -1
  330. package/dist/types/DecoratorType.d.ts +3 -1
  331. package/dist/types/DecoratorType.d.ts.map +1 -1
  332. package/dist/types/DecoratorType.js +2 -0
  333. package/dist/types/DecoratorType.js.map +1 -1
  334. package/for_ChronicleClient/when_reconnecting/and_an_observation_stream_lost_its_session.spec.ts +212 -0
  335. package/observation/ObservationReconnectBackoff.ts +109 -0
  336. package/observation/ObservationStreamOutcome.ts +12 -0
  337. package/observation/classifyStreamError.ts +67 -0
  338. package/observation/for_ObservationReconnectBackoff/given/a_backoff.ts +29 -0
  339. package/observation/for_ObservationReconnectBackoff/given/a_scripted_stream.ts +52 -0
  340. package/observation/for_ObservationReconnectBackoff/when_a_stream_delivered_before_it_ended.spec.ts +23 -0
  341. package/observation/for_ObservationReconnectBackoff/when_a_stream_stayed_open_before_it_ended.spec.ts +25 -0
  342. package/observation/for_ObservationReconnectBackoff/when_jittering_the_delay.spec.ts +24 -0
  343. package/observation/for_ObservationReconnectBackoff/when_streams_keep_ending_without_working.spec.ts +24 -0
  344. package/observation/for_ObservationReconnectBackoff/when_the_base_delay_is_not_positive.spec.ts +18 -0
  345. package/observation/for_ObservationReconnectBackoff/when_the_settings_are_not_finite.spec.ts +32 -0
  346. package/observation/for_ObservationReconnectBackoff/when_using_the_defaults.spec.ts +29 -0
  347. package/observation/for_classifyStreamError/when_classifying_a_stream_error.spec.ts +36 -0
  348. package/package.json +2 -2
  349. package/projections/for_Graphs/given/a_discovered_graph.ts +3 -2
  350. package/projections/for_Graphs/given/a_graph_with_views.ts +91 -0
  351. package/projections/for_Graphs/given/organization.ts +3 -2
  352. package/projections/for_Graphs/given/organization_with_views.fixture.ts +129 -0
  353. package/projections/for_Graphs/when_building_graph_views.spec.ts +218 -0
  354. package/projections/for_Graphs/when_declaring_an_invalid_graph_view.spec.ts +229 -0
  355. package/projections/for_Graphs/when_declaring_graph_views.standard.spec.ts +49 -0
  356. package/projections/for_Graphs/when_discovering_graph_views.spec.ts +58 -0
  357. package/projections/graphs/Graphs.ts +44 -0
  358. package/projections/graphs/IGraphs.ts +10 -2
  359. package/projections/graphs/index.ts +1 -0
  360. package/projections/graphs/views/AmbiguousDirection.ts +23 -0
  361. package/projections/graphs/views/DuplicateViewName.ts +23 -0
  362. package/projections/graphs/views/EdgeNotIncidentOnRoot.ts +24 -0
  363. package/projections/graphs/views/EdgePropertyViewNotUsedAsTarget.ts +21 -0
  364. package/projections/graphs/views/EdgePropertyViewSharedAcrossEdges.ts +22 -0
  365. package/projections/graphs/views/FollowsOptions.ts +20 -0
  366. package/projections/graphs/views/GraphEdgeDirection.ts +13 -0
  367. package/projections/graphs/views/GraphView.ts +18 -0
  368. package/projections/graphs/views/GraphViewBuildResult.ts +19 -0
  369. package/projections/graphs/views/GraphViewCardinality.ts +13 -0
  370. package/projections/graphs/views/GraphViewDefinition.ts +20 -0
  371. package/projections/graphs/views/GraphViewDefinitionBuilder.ts +322 -0
  372. package/projections/graphs/views/GraphViewDefinitionSerializer.ts +90 -0
  373. package/projections/graphs/views/GraphViewEdgeReference.ts +8 -0
  374. package/projections/graphs/views/GraphViewMember.ts +11 -0
  375. package/projections/graphs/views/GraphViewMemberKind.ts +16 -0
  376. package/projections/graphs/views/GraphViewMemberMetadata.ts +31 -0
  377. package/projections/graphs/views/GraphViewPropertyMember.ts +18 -0
  378. package/projections/graphs/views/GraphViewReason.ts +47 -0
  379. package/projections/graphs/views/GraphViewRelationMember.ts +29 -0
  380. package/projections/graphs/views/GraphViewSchema.ts +14 -0
  381. package/projections/graphs/views/GraphViewSchemaEdge.ts +20 -0
  382. package/projections/graphs/views/GraphViewSchemaNode.ts +14 -0
  383. package/projections/graphs/views/GraphViewSerializerOptions.ts +11 -0
  384. package/projections/graphs/views/RecursiveView.ts +22 -0
  385. package/projections/graphs/views/RelationTargetNotAView.ts +23 -0
  386. package/projections/graphs/views/TargetLabelMismatch.ts +25 -0
  387. package/projections/graphs/views/UnknownEdge.ts +23 -0
  388. package/projections/graphs/views/UnknownEdgeProperty.ts +24 -0
  389. package/projections/graphs/views/UnknownNodeProperty.ts +24 -0
  390. package/projections/graphs/views/ViewIsAlsoSchema.ts +21 -0
  391. package/projections/graphs/views/ViewOfMetadata.ts +11 -0
  392. package/projections/graphs/views/ViewOfOptions.ts +8 -0
  393. package/projections/graphs/views/ViewRootNotANode.ts +23 -0
  394. package/projections/graphs/views/declareGraphViewMember.ts +36 -0
  395. package/projections/graphs/views/follows.ts +28 -0
  396. package/projections/graphs/views/fromEdge.ts +17 -0
  397. package/projections/graphs/views/index.ts +43 -0
  398. package/projections/graphs/views/viewKey.ts +15 -0
  399. package/projections/graphs/views/viewOf.ts +50 -0
  400. package/projections/graphs/views/viewProperty.ts +16 -0
  401. package/reactors/Reactors.ts +101 -18
  402. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_a_handler_failed_with_a_lost_session.spec.ts +32 -0
  403. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_a_replaced_stream_fails_late.spec.ts +28 -0
  404. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_a_stream_delivered_before_it_ended.spec.ts +24 -0
  405. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_a_stream_stayed_open_before_it_ended.spec.ts +23 -0
  406. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_it_is_disposed_while_waiting_to_reopen.spec.ts +27 -0
  407. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_streams_keep_ending_without_working.spec.ts +24 -0
  408. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_the_client_reconnected_after_streams_kept_ending.spec.ts +24 -0
  409. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_the_client_reconnected_while_waiting_to_reopen.spec.ts +25 -0
  410. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_the_kernel_lost_the_session.spec.ts +24 -0
  411. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/given/a_reactor_whose_stream_ends.ts +69 -0
  412. package/reducers/Reducers.ts +99 -19
  413. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_a_reducer_failed_with_a_lost_session.spec.ts +33 -0
  414. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_a_replaced_stream_fails_late.spec.ts +28 -0
  415. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_a_stream_delivered_before_it_ended.spec.ts +24 -0
  416. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_a_stream_stayed_open_before_it_ended.spec.ts +23 -0
  417. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_it_is_disposed_while_waiting_to_reopen.spec.ts +27 -0
  418. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_streams_keep_ending_without_working.spec.ts +24 -0
  419. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_the_client_reconnected_after_streams_kept_ending.spec.ts +24 -0
  420. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_the_client_reconnected_while_waiting_to_reopen.spec.ts +25 -0
  421. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_the_kernel_lost_the_session.spec.ts +24 -0
  422. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/given/a_reducer_whose_stream_ends.ts +69 -0
  423. package/testing/InProcessAppendMetadata.ts +119 -0
  424. package/testing/InProcessBatchAppend.ts +142 -0
  425. package/testing/InProcessEventPayload.ts +100 -0
  426. package/testing/InProcessEventReadCriteria.ts +11 -0
  427. package/testing/InProcessEventReadFilter.ts +37 -0
  428. package/testing/InProcessEventSequence.ts +63 -257
  429. package/testing/InProcessEventSequenceEnvironment.ts +16 -0
  430. package/testing/InProcessSingleAppend.ts +99 -0
  431. package/testing/for_InProcessEventSequence/when_preserving_validation_and_commit_order.spec.ts +95 -0
  432. package/testing/projections/ProjectionCapabilities.ts +23 -279
  433. package/testing/projections/ProjectionCapabilityReject.ts +5 -0
  434. package/testing/projections/ProjectionCapabilityReporter.ts +31 -0
  435. package/testing/projections/ProjectionDefinitionCapabilities.ts +45 -0
  436. package/testing/projections/ProjectionEventSchemaResolver.ts +23 -0
  437. package/testing/projections/ProjectionExpressionCapabilities.ts +101 -0
  438. package/testing/projections/ProjectionInitialValueCapabilities.ts +73 -0
  439. package/testing/projections/ProjectionMappingCapabilities.ts +85 -0
  440. package/testing/projections/ProjectionMappingValidation.ts +12 -0
  441. package/testing/projections/ProjectionReadModelCapabilities.ts +42 -0
  442. package/testing/projections/ProjectionRootCapabilities.ts +75 -0
  443. package/testing/projections/ProjectionScalarConverter.ts +106 -0
  444. package/testing/projections/ProjectionSchemaCapabilities.ts +112 -0
  445. package/testing/projections/ProjectionValueConverter.ts +37 -76
  446. package/testing/projections/for_ProjectionCapabilities/when_reporting_the_first_unsupported_operation.spec.ts +74 -0
  447. package/testing/projections/for_ProjectionValueConverter/when_converting_structured_and_scalar_values.spec.ts +64 -0
  448. package/types/DecoratorType.ts +4 -1
@@ -0,0 +1,23 @@
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 { GraphViewReason } from './GraphViewReason.js';
5
+
6
+ /**
7
+ * Error raised when the target of a relation is not a declared view of the graph.
8
+ */
9
+ export class RelationTargetNotAView extends Error {
10
+ /** The stable reason code of the rule that was broken. */
11
+ readonly reason = GraphViewReason.RelationTargetNotAView;
12
+
13
+ /**
14
+ * Creates a new {@link RelationTargetNotAView}.
15
+ * @param view - The view type.
16
+ * @param member - The name of the member.
17
+ * @param target - The type that is not a view of the graph.
18
+ */
19
+ constructor(view: Function, member: string, target: Function) {
20
+ super(`The member '${member}' of the view '${view.name}' yields '${target.name}', which is not a view of the graph. Declare it with viewOf and the same graph.`);
21
+ this.name = 'RelationTargetNotAView';
22
+ }
23
+ }
@@ -0,0 +1,25 @@
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 { GraphViewReason } from './GraphViewReason.js';
5
+
6
+ /**
7
+ * Error raised when the root of the target view of a relation is not the label at the far end of the edge.
8
+ */
9
+ export class TargetLabelMismatch extends Error {
10
+ /** The stable reason code of the rule that was broken. */
11
+ readonly reason = GraphViewReason.TargetLabelMismatch;
12
+
13
+ /**
14
+ * Creates a new {@link TargetLabelMismatch}.
15
+ * @param view - The view type.
16
+ * @param member - The name of the member.
17
+ * @param target - The target view type.
18
+ * @param expected - The label at the far end of the edge.
19
+ * @param actual - The label of the root of the target view.
20
+ */
21
+ constructor(view: Function, member: string, target: Function, expected: string, actual: string) {
22
+ super(`The member '${member}' of the view '${view.name}' reaches '${expected}', but the view '${target.name}' is anchored at '${actual}'.`);
23
+ this.name = 'TargetLabelMismatch';
24
+ }
25
+ }
@@ -0,0 +1,23 @@
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 { GraphViewReason } from './GraphViewReason.js';
5
+
6
+ /**
7
+ * Error raised when a relation of a view names an edge type the graph does not declare.
8
+ */
9
+ export class UnknownEdge extends Error {
10
+ /** The stable reason code of the rule that was broken. */
11
+ readonly reason = GraphViewReason.UnknownEdge;
12
+
13
+ /**
14
+ * Creates a new {@link UnknownEdge}.
15
+ * @param view - The view type.
16
+ * @param member - The name of the member.
17
+ * @param edge - The edge that is not declared.
18
+ */
19
+ constructor(view: Function, member: string, edge: string) {
20
+ super(`The member '${member}' of the view '${view.name}' follows '${edge}', which is not an edge of the graph.`);
21
+ this.name = 'UnknownEdge';
22
+ }
23
+ }
@@ -0,0 +1,24 @@
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 { GraphViewReason } from './GraphViewReason.js';
5
+
6
+ /**
7
+ * Error raised when an edge property member of a view names a property the edge does not declare.
8
+ */
9
+ export class UnknownEdgeProperty extends Error {
10
+ /** The stable reason code of the rule that was broken. */
11
+ readonly reason = GraphViewReason.UnknownEdgeProperty;
12
+
13
+ /**
14
+ * Creates a new {@link UnknownEdgeProperty}.
15
+ * @param view - The view type.
16
+ * @param member - The name of the member.
17
+ * @param edge - The edge type that is followed to reach the view.
18
+ * @param source - The name of the property that is not declared.
19
+ */
20
+ constructor(view: Function, member: string, edge: string, source: string) {
21
+ super(`The member '${member}' of the view '${view.name}' reads '${source}', which is not a property of the edge '${edge}'.`);
22
+ this.name = 'UnknownEdgeProperty';
23
+ }
24
+ }
@@ -0,0 +1,24 @@
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 { GraphViewReason } from './GraphViewReason.js';
5
+
6
+ /**
7
+ * Error raised when a property member of a view names a property the root node does not declare.
8
+ */
9
+ export class UnknownNodeProperty extends Error {
10
+ /** The stable reason code of the rule that was broken. */
11
+ readonly reason = GraphViewReason.UnknownNodeProperty;
12
+
13
+ /**
14
+ * Creates a new {@link UnknownNodeProperty}.
15
+ * @param view - The view type.
16
+ * @param member - The name of the member.
17
+ * @param node - The label of the root node.
18
+ * @param source - The name of the property that is not declared.
19
+ */
20
+ constructor(view: Function, member: string, node: string, source: string) {
21
+ super(`The member '${member}' of the view '${view.name}' reads '${source}', which is not a property of the node '${node}'.`);
22
+ this.name = 'UnknownNodeProperty';
23
+ }
24
+ }
@@ -0,0 +1,21 @@
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 { GraphViewReason } from './GraphViewReason.js';
5
+
6
+ /**
7
+ * Error raised when a view type is also a node or an edge.
8
+ */
9
+ export class ViewIsAlsoSchema extends Error {
10
+ /** The stable reason code of the rule that was broken. */
11
+ readonly reason = GraphViewReason.ViewIsAlsoSchema;
12
+
13
+ /**
14
+ * Creates a new {@link ViewIsAlsoSchema}.
15
+ * @param view - The view type.
16
+ */
17
+ constructor(view: Function) {
18
+ super(`The view '${view.name}' is also a node or an edge. A view is a read model over the graph and cannot be part of its schema.`);
19
+ this.name = 'ViewIsAlsoSchema';
20
+ }
21
+ }
@@ -0,0 +1,11 @@
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
+ /** Metadata stored by the viewOf class decorator. */
5
+ export interface ViewOfMetadata {
6
+ /** A function returning the class of the node the view is anchored at. */
7
+ readonly root: () => Function;
8
+
9
+ /** The name of the view. */
10
+ readonly name: string;
11
+ }
@@ -0,0 +1,8 @@
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
+ /** Options of the viewOf decorator. */
5
+ export interface ViewOfOptions {
6
+ /** The name of the view. View names are unique in a graph. Defaults to the name of the class. */
7
+ readonly name?: string;
8
+ }
@@ -0,0 +1,23 @@
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 { GraphViewReason } from './GraphViewReason.js';
5
+
6
+ /**
7
+ * Error raised when the root of a view is not a node declared in the graph of the view.
8
+ */
9
+ export class ViewRootNotANode extends Error {
10
+ /** The stable reason code of the rule that was broken. */
11
+ readonly reason = GraphViewReason.ViewRootNotANode;
12
+
13
+ /**
14
+ * Creates a new {@link ViewRootNotANode}.
15
+ * @param view - The view type.
16
+ * @param graph - The name of the graph.
17
+ * @param root - The type the view is anchored at.
18
+ */
19
+ constructor(view: Function, graph: string, root: Function) {
20
+ super(`The view '${view.name}' is anchored at '${root.name}', which is not a node of the graph '${graph}'.`);
21
+ this.name = 'ViewRootNotANode';
22
+ }
23
+ }
@@ -0,0 +1,36 @@
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 { TypeIntrospector } from '../../../types/index.js';
6
+ import { decorateProperty, getPropertyMetadata, type ChroniclePropertyDecorator } from '../../../types/propertyDecoratorMetadata.js';
7
+ import type { GraphViewMemberMetadata } from './GraphViewMemberMetadata.js';
8
+
9
+ const METADATA_KEY = 'chronicle:graph:view:member';
10
+
11
+ /**
12
+ * Creates a property decorator that declares a member of a graph view. Members are read in the order they are declared.
13
+ * @param metadata - What the member is.
14
+ * @returns A property decorator.
15
+ */
16
+ export function declareGraphViewMember(metadata: GraphViewMemberMetadata): ChroniclePropertyDecorator {
17
+ return decorateProperty((target: object, propertyKey: string | symbol) => {
18
+ const key = propertyKey.toString();
19
+ if (Reflect.getOwnMetadata(METADATA_KEY, target, key) !== undefined) {
20
+ throw new TypeError(`The member '${key}' of a graph view can be declared as one kind of member only.`);
21
+ }
22
+
23
+ TypeIntrospector.trackProperty((target as { constructor: Function }).constructor, key);
24
+ Reflect.defineMetadata(METADATA_KEY, metadata, target, key);
25
+ });
26
+ }
27
+
28
+ /**
29
+ * Retrieves the metadata stored by the member decorators of a graph view on a property.
30
+ * @param target - The class prototype.
31
+ * @param propertyKey - The property name.
32
+ * @returns The metadata, or undefined when the property is not a member of a view.
33
+ */
34
+ export function getGraphViewMemberMetadata(target: object, propertyKey: string): GraphViewMemberMetadata | undefined {
35
+ return getPropertyMetadata<GraphViewMemberMetadata>(METADATA_KEY, target, propertyKey);
36
+ }
@@ -0,0 +1,28 @@
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 { ChroniclePropertyDecorator } from '../../../types/propertyDecoratorMetadata.js';
5
+ import type { FollowsOptions } from './FollowsOptions.js';
6
+ import { GraphViewCardinality } from './GraphViewCardinality.js';
7
+ import type { GraphViewEdgeReference } from './GraphViewEdgeReference.js';
8
+ import { GraphViewMemberKind } from './GraphViewMemberKind.js';
9
+ import { declareGraphViewMember } from './declareGraphViewMember.js';
10
+
11
+ /**
12
+ * Property decorator that declares a member of a graph view that follows one edge type to a nested view.
13
+ * @param edge - The edge to follow: a function returning the edge class, or the edge type string.
14
+ * @param view - A function returning the class of the nested view.
15
+ * @param options - The cardinality, which is many by default, and the direction, which is derived unless the edge
16
+ * starts and ends at the same label.
17
+ * @returns A property decorator.
18
+ */
19
+ export function follows(edge: GraphViewEdgeReference, view: () => Function, options: FollowsOptions = {}): ChroniclePropertyDecorator {
20
+ return declareGraphViewMember({
21
+ kind: GraphViewMemberKind.Relation,
22
+ isKey: false,
23
+ edge,
24
+ view,
25
+ direction: options.direction,
26
+ cardinality: options.cardinality ?? GraphViewCardinality.Many
27
+ });
28
+ }
@@ -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
+ import type { ChroniclePropertyDecorator } from '../../../types/propertyDecoratorMetadata.js';
5
+ import { GraphViewMemberKind } from './GraphViewMemberKind.js';
6
+ import { declareGraphViewMember } from './declareGraphViewMember.js';
7
+
8
+ /**
9
+ * Property decorator that declares a member of a graph view that reads a property of the edge that was followed to
10
+ * reach the view. It is valid only in a view that is the target of relations of exactly one edge type.
11
+ * @param source - The name of the property of the edge. It is matched without regard to case. When missing, the
12
+ * name of the member is matched against the properties of the edge.
13
+ * @returns A property decorator.
14
+ */
15
+ export function fromEdge(source?: string): ChroniclePropertyDecorator {
16
+ return declareGraphViewMember({ kind: GraphViewMemberKind.EdgeProperty, isKey: false, source });
17
+ }
@@ -0,0 +1,43 @@
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
+ export { viewOf, getViewOfMetadata } from './viewOf.js';
5
+ export type { ViewOfOptions } from './ViewOfOptions.js';
6
+ export type { ViewOfMetadata } from './ViewOfMetadata.js';
7
+ export { viewKey } from './viewKey.js';
8
+ export { viewProperty } from './viewProperty.js';
9
+ export { fromEdge } from './fromEdge.js';
10
+ export { follows } from './follows.js';
11
+ export type { FollowsOptions } from './FollowsOptions.js';
12
+ export { getGraphViewMemberMetadata } from './declareGraphViewMember.js';
13
+ export type { GraphViewMemberMetadata } from './GraphViewMemberMetadata.js';
14
+ export type { GraphViewEdgeReference } from './GraphViewEdgeReference.js';
15
+ export { GraphViewMemberKind } from './GraphViewMemberKind.js';
16
+ export { GraphEdgeDirection } from './GraphEdgeDirection.js';
17
+ export { GraphViewCardinality } from './GraphViewCardinality.js';
18
+ export { GraphViewReason } from './GraphViewReason.js';
19
+ export type { GraphViewDefinition } from './GraphViewDefinition.js';
20
+ export type { GraphView } from './GraphView.js';
21
+ export type { GraphViewMember } from './GraphViewMember.js';
22
+ export type { GraphViewPropertyMember } from './GraphViewPropertyMember.js';
23
+ export type { GraphViewRelationMember } from './GraphViewRelationMember.js';
24
+ export type { GraphViewBuildResult } from './GraphViewBuildResult.js';
25
+ export { GraphViewDefinitionBuilder } from './GraphViewDefinitionBuilder.js';
26
+ export { GraphViewDefinitionSerializer } from './GraphViewDefinitionSerializer.js';
27
+ export { ViewRootNotANode } from './ViewRootNotANode.js';
28
+ export { ViewIsAlsoSchema } from './ViewIsAlsoSchema.js';
29
+ export { DuplicateViewName } from './DuplicateViewName.js';
30
+ export { UnknownNodeProperty } from './UnknownNodeProperty.js';
31
+ export { UnknownEdge } from './UnknownEdge.js';
32
+ export { UnknownEdgeProperty } from './UnknownEdgeProperty.js';
33
+ export { EdgeNotIncidentOnRoot } from './EdgeNotIncidentOnRoot.js';
34
+ export { AmbiguousDirection } from './AmbiguousDirection.js';
35
+ export { TargetLabelMismatch } from './TargetLabelMismatch.js';
36
+ export { RelationTargetNotAView } from './RelationTargetNotAView.js';
37
+ export { RecursiveView } from './RecursiveView.js';
38
+ export { EdgePropertyViewNotUsedAsTarget } from './EdgePropertyViewNotUsedAsTarget.js';
39
+ export { EdgePropertyViewSharedAcrossEdges } from './EdgePropertyViewSharedAcrossEdges.js';
40
+ export type { GraphViewSchema } from './GraphViewSchema.js';
41
+ export type { GraphViewSchemaNode } from './GraphViewSchemaNode.js';
42
+ export type { GraphViewSchemaEdge } from './GraphViewSchemaEdge.js';
43
+ export type { GraphViewSerializerOptions } from './GraphViewSerializerOptions.js';
@@ -0,0 +1,15 @@
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 { ChroniclePropertyDecorator } from '../../../types/propertyDecoratorMetadata.js';
5
+ import { GraphViewMemberKind } from './GraphViewMemberKind.js';
6
+ import { declareGraphViewMember } from './declareGraphViewMember.js';
7
+
8
+ /**
9
+ * Property decorator that declares the member of a graph view that holds the key of the root node. The member reads
10
+ * whatever property the node uses as its key, so the view does not repeat the name of it.
11
+ * @returns A property decorator.
12
+ */
13
+ export function viewKey(): ChroniclePropertyDecorator {
14
+ return declareGraphViewMember({ kind: GraphViewMemberKind.Property, isKey: true });
15
+ }
@@ -0,0 +1,50 @@
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 type { Constructor } from '@cratis/fundamentals';
6
+ import { DecoratorType, TypeDiscoverer } from '../../../types/index.js';
7
+ import type { ChronicleClassDecorator } from '../../../types/standardDecoratorMetadata.js';
8
+ import type { ViewOfMetadata } from './ViewOfMetadata.js';
9
+ import type { ViewOfOptions } from './ViewOfOptions.js';
10
+
11
+ const METADATA_KEY = 'chronicle:graph:view';
12
+
13
+ /**
14
+ * Class decorator that marks a class as a view over a property graph. A view is a read model that is anchored at one
15
+ * node. Its members are properties of that node (viewKey and viewProperty), relations along declared edges to other
16
+ * views (follows) and properties of the edge that was followed (fromEdge). Name the graph with the graph decorator.
17
+ * A view only declares what is read; the class is never a node or an edge.
18
+ * @param root - A function returning the class of the node the view is anchored at. It is resolved when the views
19
+ * are validated, so the classes can be declared in any order.
20
+ * @param options - The name of the view, which defaults to the name of the class.
21
+ * @returns A class decorator.
22
+ */
23
+ export function viewOf(root: () => Function, options: ViewOfOptions = {}): ChronicleClassDecorator {
24
+ return (target: object) => {
25
+ const type = target as Function;
26
+ const metadata: ViewOfMetadata = { root, name: options.name ?? type.name };
27
+ Reflect.defineMetadata(METADATA_KEY, metadata, target);
28
+
29
+ // Discovery is keyed by name. Views of different graphs may share a class name, so they must not replace each other.
30
+ const registered = TypeDiscoverer.default.getTypesByDecoratorType(DecoratorType.GraphView);
31
+ if (!registered.includes(type as Constructor)) {
32
+ let key = type.name;
33
+ let suffix = 2;
34
+ while (TypeDiscoverer.default.getTypeByDecoratorTypeAndName(DecoratorType.GraphView, key) !== undefined) {
35
+ key = `${type.name}#${suffix++}`;
36
+ }
37
+
38
+ TypeDiscoverer.default.register(DecoratorType.GraphView, type as Constructor, key);
39
+ }
40
+ };
41
+ }
42
+
43
+ /**
44
+ * Retrieves the metadata stored by the viewOf decorator.
45
+ * @param target - The class constructor.
46
+ * @returns The metadata, or undefined when the class is not a view.
47
+ */
48
+ export function getViewOfMetadata(target: Function): ViewOfMetadata | undefined {
49
+ return Reflect.getMetadata(METADATA_KEY, target) as ViewOfMetadata | undefined;
50
+ }
@@ -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
+ import type { ChroniclePropertyDecorator } from '../../../types/propertyDecoratorMetadata.js';
5
+ import { GraphViewMemberKind } from './GraphViewMemberKind.js';
6
+ import { declareGraphViewMember } from './declareGraphViewMember.js';
7
+
8
+ /**
9
+ * Property decorator that declares a member of a graph view that reads a property of the root node.
10
+ * @param source - The name of the property of the node. It is matched without regard to case. When missing, the
11
+ * name of the member is matched against the properties of the node.
12
+ * @returns A property decorator.
13
+ */
14
+ export function viewProperty(source?: string): ChroniclePropertyDecorator {
15
+ return declareGraphViewMember({ kind: GraphViewMemberKind.Property, isKey: false, source });
16
+ }
@@ -6,6 +6,7 @@ import { createLogger } from '../logging/createLogger.js';
6
6
  import { runInBackgroundContext } from '../telemetry/runInBackgroundContext.js';
7
7
  import { Constructor } from '@cratis/fundamentals';
8
8
  import { EventGenerationDelivery, ReactorMessage } from '@cratis/chronicle.contracts';
9
+ import type { EventsToObserve } from '@cratis/chronicle.contracts';
9
10
  import { IClientArtifactsProvider } from '../artifacts/index.js';
10
11
  import { ChronicleConnection } from '../connection/index.js';
11
12
  import { ConnectionLifecycle } from '../connection/ConnectionLifecycle.js';
@@ -29,6 +30,9 @@ import type { ReactorServices } from './ReactorServices.js';
29
30
  import type { IEventStore } from '../IEventStore.js';
30
31
  import type { ClientArtifactsActivator } from '../artifacts/ClientArtifactsActivator.js';
31
32
  import { refuseClientHostedObservers } from '../artifacts/refuseClientHostedObservers.js';
33
+ import { ObservationReconnectBackoff, type ObservationReconnectBackoffOptions } from '../observation/ObservationReconnectBackoff.js';
34
+ import { classifyStreamError, StreamErrorKind } from '../observation/classifyStreamError.js';
35
+ import type { ObservationStreamOutcome } from '../observation/ObservationStreamOutcome.js';
32
36
 
33
37
  /** Expression used to partition reactor observations by event source ID. */
34
38
  const EVENT_SOURCE_ID_KEY = '$eventSourceId';
@@ -96,15 +100,14 @@ class AsyncQueue<T> {
96
100
  * with the Chronicle Kernel via bidirectional gRPC streaming.
97
101
  */
98
102
  export class Reactors implements IReactors {
99
- /** How long to wait before re-establishing an observation whose stream ended. */
100
- private static readonly _reobserveDelayMs = 2000;
101
-
102
103
  private readonly _logger: ReturnType<typeof createLogger>;
103
104
  private readonly _lifecycle: ConnectionLifecycle;
104
105
  private readonly _unsubscribeDisconnected: () => void;
105
106
  private readonly _reactors = new Map<string, Constructor>();
106
107
  private readonly _queues = new Map<string, AsyncQueue<ReactorMessage>>();
107
108
  private readonly _observations = new Map<string, AbortController>();
109
+ private readonly _reconnectBackoffs = new Map<string, ObservationReconnectBackoff>();
110
+ private readonly _reobserveTimers = new Map<string, ReturnType<typeof setTimeout>>();
108
111
  private _registered = false;
109
112
  private _disposed = false;
110
113
 
@@ -116,6 +119,11 @@ export class Reactors implements IReactors {
116
119
  * @param _namespace - The namespace within the event store.
117
120
  * @param lifecycle - The connection lifecycle used to react to disconnect events.
118
121
  * @param _eventLog - The event log used to append side-effect events a reactor handler returns.
122
+ * @param _resultHandler - Optional handler for values a reactor handler returns.
123
+ * @param _eventStore - Optional event store handed to reactor handlers.
124
+ * @param _artifactActivator - Optional activator creating reactor instances.
125
+ * @param _skipKeepAlive - Whether the client runs without a keep-alive, which refuses client-hosted reactors.
126
+ * @param _reconnectBackoff - How a reactor waits before opening its observation stream again after it ended.
119
127
  */
120
128
  constructor(
121
129
  private readonly _clientArtifacts: IClientArtifactsProvider,
@@ -127,7 +135,8 @@ export class Reactors implements IReactors {
127
135
  private readonly _resultHandler?: ReactorResultHandler,
128
136
  private readonly _eventStore?: IEventStore,
129
137
  private readonly _artifactActivator?: ClientArtifactsActivator,
130
- private readonly _skipKeepAlive: boolean = false
138
+ private readonly _skipKeepAlive: boolean = false,
139
+ private readonly _reconnectBackoff: ObservationReconnectBackoffOptions = {}
131
140
  ) {
132
141
  this._logger = createLogger('@cratis/chronicle/reactors', _connection.logger);
133
142
  this._lifecycle = lifecycle;
@@ -144,6 +153,7 @@ export class Reactors implements IReactors {
144
153
  this._disposed = true;
145
154
  this._registered = false;
146
155
  this.disconnectAll();
156
+ this._reconnectBackoffs.clear();
147
157
  }
148
158
 
149
159
  /** @inheritdoc */
@@ -210,13 +220,23 @@ export class Reactors implements IReactors {
210
220
  eventTypes: ReactorEventTypeEntry[],
211
221
  validateInstance: (instance: object) => void
212
222
  ): Promise<void> {
223
+ let outcome: ObservationStreamOutcome = 'ended';
213
224
  try {
214
- await this.observeReactor(id, reactorType, eventSequenceId, eventTypes, validateInstance);
225
+ outcome = await this.observeReactor(id, reactorType, eventSequenceId, eventTypes, validateInstance);
215
226
  } catch (error) {
216
227
  this._logger.error('Reactor observation loop exited with error', { reactorId: id, error });
217
228
  }
218
229
 
219
- this.scheduleReobserve(id, reactorType, eventTypes, validateInstance);
230
+ if (outcome === 'ended') this.scheduleReobserve(id, reactorType, eventTypes, validateInstance);
231
+ }
232
+
233
+ private reconnectBackoffFor(id: string): ObservationReconnectBackoff {
234
+ let backoff = this._reconnectBackoffs.get(id);
235
+ if (!backoff) {
236
+ backoff = new ObservationReconnectBackoff(this._reconnectBackoff);
237
+ this._reconnectBackoffs.set(id, backoff);
238
+ }
239
+ return backoff;
220
240
  }
221
241
 
222
242
  /**
@@ -225,8 +245,9 @@ export class Reactors implements IReactors {
225
245
  * The stream ending without an error is not proof that all is well — the kernel
226
246
  * closes a cross-store (inbox) reactor's stream rather than tailing it forever,
227
247
  * so a reactor that does not re-subscribe there silently stops observing until
228
- * the whole client reconnects. Both endings are therefore retried, and the delay
229
- * keeps a stream that keeps ending from becoming a hot loop.
248
+ * the whole client reconnects. Both endings are therefore retried. The delay keeps
249
+ * a stream that keeps ending from becoming a hot loop, and grows with jitter while
250
+ * it does (see {@link ObservationReconnectBackoff}).
230
251
  */
231
252
  private scheduleReobserve(id: string, reactorType: Constructor, eventTypes: ReactorEventTypeEntry[], validateInstance: (instance: object) => void): void {
232
253
  // A disconnect clears the registration; the reconnect re-registers every
@@ -235,16 +256,22 @@ export class Reactors implements IReactors {
235
256
  return;
236
257
  }
237
258
 
259
+ clearTimeout(this._reobserveTimers.get(id));
260
+ const delayMs = this.reconnectBackoffFor(id).nextDelayMs();
261
+ this._logger.debug('Waiting before re-establishing reactor observation', { reactorId: id, delayMs });
238
262
  const handle = runInBackgroundContext(() => setTimeout(() => {
239
- if (!this._registered || this._disposed) {
263
+ this._reobserveTimers.delete(id);
264
+ // A reconnect in the meantime has already opened a new stream; opening another would leave one untracked.
265
+ if (!this._registered || this._disposed || this._observations.has(id)) {
240
266
  return;
241
267
  }
242
268
 
243
269
  this._logger.info('Re-establishing reactor observation', { reactorId: id });
244
270
  this.startObservation(id, reactorType, eventTypes, validateInstance);
245
- }, Reactors._reobserveDelayMs));
271
+ }, delayMs));
246
272
 
247
273
  handle.unref?.();
274
+ this._reobserveTimers.set(id, handle);
248
275
  }
249
276
 
250
277
  private async observeReactor(
@@ -253,17 +280,20 @@ export class Reactors implements IReactors {
253
280
  eventSequenceId: string,
254
281
  eventTypes: ReactorEventTypeEntry[],
255
282
  validateInstance: (instance: object) => void
256
- ): Promise<void> {
283
+ ): Promise<ObservationStreamOutcome> {
257
284
  const batchMethods = getReactorBatchMethods(reactorType, this._clientArtifacts.eventTypes);
258
285
  const queue = new AsyncQueue<ReactorMessage>();
259
286
  const controller = new AbortController();
260
287
  this._queues.set(id, queue);
261
288
  this._observations.set(id, controller);
289
+ const connectionId = this._lifecycle.connectionId;
290
+ const backoff = this.reconnectBackoffFor(id);
291
+ backoff.streamOpened();
262
292
 
263
293
  queue.send({
264
294
  Content: {
265
295
  Value0: {
266
- ConnectionId: this._lifecycle.connectionId,
296
+ ConnectionId: connectionId,
267
297
  EventStore: this._eventStoreName,
268
298
  Namespace: this._namespace,
269
299
  Reactor: {
@@ -290,6 +320,8 @@ export class Reactors implements IReactors {
290
320
  }
291
321
  });
292
322
 
323
+ let iterator: AsyncIterator<EventsToObserve> | undefined;
324
+ let streamFinished = false;
293
325
  try {
294
326
  const reactorInstance = this._artifactActivator ? undefined : new (reactorType as new () => Record<string, Function>)();
295
327
  if (reactorInstance) validateInstance(reactorInstance);
@@ -304,17 +336,44 @@ export class Reactors implements IReactors {
304
336
  logger: this._logger, connectionLogger: this._connection.logger
305
337
  });
306
338
 
307
- for await (const eventsToObserve of this._connection.reactors.observe(queue, { signal: controller.signal })) {
308
- const result = await dispatcher.dispatch(eventsToObserve);
339
+ // Pull each message by hand so only a failure of the stream itself is classified: an error from a
340
+ // handler is the handler's failure, and must never make the whole client reconnect.
341
+ iterator = this._connection.reactors.observe(queue, { signal: controller.signal })[Symbol.asyncIterator]();
342
+ for (;;) {
343
+ let next: IteratorResult<EventsToObserve>;
344
+ try {
345
+ next = await iterator.next();
346
+ } catch (streamError) {
347
+ streamFinished = true;
348
+ return this.streamFailed(id, queue, controller.signal, connectionId, streamError);
349
+ }
350
+
351
+ if (next.done) {
352
+ streamFinished = true;
353
+ break;
354
+ }
355
+
356
+ backoff.streamDelivered();
357
+ const result = await dispatcher.dispatch(next.value);
309
358
  queue.send({ Content: { Value0: undefined, Value1: result } });
310
359
  }
311
- } catch (err) {
312
- if (!this._queues.has(id)) {
360
+
361
+ if (this._queues.get(id) !== queue) {
313
362
  this._logger.debug('Reactor observation stream closed cleanly', { reactorId: id });
314
- } else {
315
- this._logger.error('Reactor observation stream ended unexpectedly', { reactorId: id, error: err });
363
+ return 'superseded';
316
364
  }
365
+
366
+ return 'ended';
367
+ } catch (handlerError) {
368
+ if (this._queues.get(id) !== queue) return 'superseded';
369
+ this._logger.error('Reactor observation failed while handling a delivery', { reactorId: id, error: handlerError });
370
+ return 'ended';
317
371
  } finally {
372
+ if (!streamFinished) {
373
+ controller.abort();
374
+ void iterator?.return?.()?.catch(() => undefined);
375
+ }
376
+
318
377
  // Only retire our own queue: a reconnect can already have replaced it,
319
378
  // and deleting the new one would leave that observation untracked and
320
379
  // leak a duplicate stream on every reconnect.
@@ -326,7 +385,31 @@ export class Reactors implements IReactors {
326
385
  }
327
386
  }
328
387
 
388
+ private streamFailed(id: string, queue: AsyncQueue<ReactorMessage>, signal: AbortSignal, connectionId: string, error: unknown): ObservationStreamOutcome {
389
+ // A late error from a stream that a disconnect, a dispose or a newer stream replaced says nothing about now.
390
+ if (this._queues.get(id) !== queue) {
391
+ this._logger.debug('Reactor observation stream closed cleanly', { reactorId: id });
392
+ return 'superseded';
393
+ }
394
+
395
+ const kind = classifyStreamError(error);
396
+ if (kind === StreamErrorKind.Cancelled && signal.aborted) return 'stopped';
397
+ if (kind === StreamErrorKind.SessionLost) {
398
+ // The kernel lost this client's registration. Opening the same stream with the same connection id
399
+ // can never work, so reconnect the whole client, which re-registers every reactor.
400
+ this._logger.warn('Reactor observation stream lost its session; reconnecting the client', { reactorId: id, error });
401
+ this._lifecycle.requestReconnect(connectionId, 'reactor-session-lost', error,
402
+ handlerError => this._logger.error('Reconnect request handler failed', { reactorId: id, error: handlerError }));
403
+ return 'sessionLost';
404
+ }
405
+
406
+ this._logger.error('Reactor observation stream ended unexpectedly', { reactorId: id, error });
407
+ return 'ended';
408
+ }
409
+
329
410
  private disconnectAll(): void {
411
+ for (const timer of this._reobserveTimers.values()) clearTimeout(timer);
412
+ this._reobserveTimers.clear();
330
413
  for (const controller of this._observations.values()) controller.abort();
331
414
  for (const queue of this._queues.values()) queue.complete();
332
415
  this._observations.clear();