@cratis/chronicle 6.63.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 (366) hide show
  1. package/artifacts/DefaultClientArtifactsProvider.ts +5 -0
  2. package/artifacts/IClientArtifactsProvider.ts +3 -0
  3. package/dist/artifacts/DefaultClientArtifactsProvider.d.ts +2 -0
  4. package/dist/artifacts/DefaultClientArtifactsProvider.d.ts.map +1 -1
  5. package/dist/artifacts/DefaultClientArtifactsProvider.js +4 -0
  6. package/dist/artifacts/DefaultClientArtifactsProvider.js.map +1 -1
  7. package/dist/artifacts/IClientArtifactsProvider.d.ts +2 -0
  8. package/dist/artifacts/IClientArtifactsProvider.d.ts.map +1 -1
  9. package/dist/projections/for_Graphs/given/a_discovered_graph.d.ts +2 -1
  10. package/dist/projections/for_Graphs/given/a_discovered_graph.d.ts.map +1 -1
  11. package/dist/projections/for_Graphs/given/a_discovered_graph.js +3 -2
  12. package/dist/projections/for_Graphs/given/a_discovered_graph.js.map +1 -1
  13. package/dist/projections/for_Graphs/given/a_graph_with_views.d.ts +40 -0
  14. package/dist/projections/for_Graphs/given/a_graph_with_views.d.ts.map +1 -0
  15. package/dist/projections/for_Graphs/given/a_graph_with_views.js +80 -0
  16. package/dist/projections/for_Graphs/given/a_graph_with_views.js.map +1 -0
  17. package/dist/projections/for_Graphs/given/organization.d.ts +2 -1
  18. package/dist/projections/for_Graphs/given/organization.d.ts.map +1 -1
  19. package/dist/projections/for_Graphs/given/organization.js +3 -2
  20. package/dist/projections/for_Graphs/given/organization.js.map +1 -1
  21. package/dist/projections/graphs/Graphs.d.ts +5 -0
  22. package/dist/projections/graphs/Graphs.d.ts.map +1 -1
  23. package/dist/projections/graphs/Graphs.js +43 -0
  24. package/dist/projections/graphs/Graphs.js.map +1 -1
  25. package/dist/projections/graphs/IGraphs.d.ts +9 -2
  26. package/dist/projections/graphs/IGraphs.d.ts.map +1 -1
  27. package/dist/projections/graphs/index.d.ts +1 -0
  28. package/dist/projections/graphs/index.d.ts.map +1 -1
  29. package/dist/projections/graphs/index.js +1 -0
  30. package/dist/projections/graphs/index.js.map +1 -1
  31. package/dist/projections/graphs/views/AmbiguousDirection.d.ts +16 -0
  32. package/dist/projections/graphs/views/AmbiguousDirection.d.ts.map +1 -0
  33. package/dist/projections/graphs/views/AmbiguousDirection.js +21 -0
  34. package/dist/projections/graphs/views/AmbiguousDirection.js.map +1 -0
  35. package/dist/projections/graphs/views/DuplicateViewName.d.ts +16 -0
  36. package/dist/projections/graphs/views/DuplicateViewName.d.ts.map +1 -0
  37. package/dist/projections/graphs/views/DuplicateViewName.js +21 -0
  38. package/dist/projections/graphs/views/DuplicateViewName.js.map +1 -0
  39. package/dist/projections/graphs/views/EdgeNotIncidentOnRoot.d.ts +17 -0
  40. package/dist/projections/graphs/views/EdgeNotIncidentOnRoot.d.ts.map +1 -0
  41. package/dist/projections/graphs/views/EdgeNotIncidentOnRoot.js +22 -0
  42. package/dist/projections/graphs/views/EdgeNotIncidentOnRoot.js.map +1 -0
  43. package/dist/projections/graphs/views/EdgePropertyViewNotUsedAsTarget.d.ts +14 -0
  44. package/dist/projections/graphs/views/EdgePropertyViewNotUsedAsTarget.d.ts.map +1 -0
  45. package/dist/projections/graphs/views/EdgePropertyViewNotUsedAsTarget.js +19 -0
  46. package/dist/projections/graphs/views/EdgePropertyViewNotUsedAsTarget.js.map +1 -0
  47. package/dist/projections/graphs/views/EdgePropertyViewSharedAcrossEdges.d.ts +15 -0
  48. package/dist/projections/graphs/views/EdgePropertyViewSharedAcrossEdges.d.ts.map +1 -0
  49. package/dist/projections/graphs/views/EdgePropertyViewSharedAcrossEdges.js +20 -0
  50. package/dist/projections/graphs/views/EdgePropertyViewSharedAcrossEdges.js.map +1 -0
  51. package/dist/projections/graphs/views/FollowsOptions.d.ts +16 -0
  52. package/dist/projections/graphs/views/FollowsOptions.d.ts.map +1 -0
  53. package/dist/projections/graphs/views/FollowsOptions.js +4 -0
  54. package/dist/projections/graphs/views/FollowsOptions.js.map +1 -0
  55. package/dist/projections/graphs/views/GraphEdgeDirection.d.ts +10 -0
  56. package/dist/projections/graphs/views/GraphEdgeDirection.d.ts.map +1 -0
  57. package/dist/projections/graphs/views/GraphEdgeDirection.js +13 -0
  58. package/dist/projections/graphs/views/GraphEdgeDirection.js.map +1 -0
  59. package/dist/projections/graphs/views/GraphView.d.ts +13 -0
  60. package/dist/projections/graphs/views/GraphView.d.ts.map +1 -0
  61. package/dist/projections/graphs/views/GraphView.js +4 -0
  62. package/dist/projections/graphs/views/GraphView.js.map +1 -0
  63. package/dist/projections/graphs/views/GraphViewBuildResult.d.ts +15 -0
  64. package/dist/projections/graphs/views/GraphViewBuildResult.d.ts.map +1 -0
  65. package/dist/projections/graphs/views/GraphViewBuildResult.js +4 -0
  66. package/dist/projections/graphs/views/GraphViewBuildResult.js.map +1 -0
  67. package/dist/projections/graphs/views/GraphViewCardinality.d.ts +10 -0
  68. package/dist/projections/graphs/views/GraphViewCardinality.d.ts.map +1 -0
  69. package/dist/projections/graphs/views/GraphViewCardinality.js +13 -0
  70. package/dist/projections/graphs/views/GraphViewCardinality.js.map +1 -0
  71. package/dist/projections/graphs/views/GraphViewDefinition.d.ts +15 -0
  72. package/dist/projections/graphs/views/GraphViewDefinition.d.ts.map +1 -0
  73. package/dist/projections/graphs/views/GraphViewDefinition.js +4 -0
  74. package/dist/projections/graphs/views/GraphViewDefinition.js.map +1 -0
  75. package/dist/projections/graphs/views/GraphViewDefinitionBuilder.d.ts +30 -0
  76. package/dist/projections/graphs/views/GraphViewDefinitionBuilder.d.ts.map +1 -0
  77. package/dist/projections/graphs/views/GraphViewDefinitionBuilder.js +259 -0
  78. package/dist/projections/graphs/views/GraphViewDefinitionBuilder.js.map +1 -0
  79. package/dist/projections/graphs/views/GraphViewDefinitionSerializer.d.ts +21 -0
  80. package/dist/projections/graphs/views/GraphViewDefinitionSerializer.d.ts.map +1 -0
  81. package/dist/projections/graphs/views/GraphViewDefinitionSerializer.js +77 -0
  82. package/dist/projections/graphs/views/GraphViewDefinitionSerializer.js.map +1 -0
  83. package/dist/projections/graphs/views/GraphViewEdgeReference.d.ts +6 -0
  84. package/dist/projections/graphs/views/GraphViewEdgeReference.d.ts.map +1 -0
  85. package/dist/projections/graphs/views/GraphViewEdgeReference.js +4 -0
  86. package/dist/projections/graphs/views/GraphViewEdgeReference.js.map +1 -0
  87. package/dist/projections/graphs/views/GraphViewMember.d.ts +8 -0
  88. package/dist/projections/graphs/views/GraphViewMember.d.ts.map +1 -0
  89. package/dist/projections/graphs/views/GraphViewMember.js +4 -0
  90. package/dist/projections/graphs/views/GraphViewMember.js.map +1 -0
  91. package/dist/projections/graphs/views/GraphViewMemberKind.d.ts +12 -0
  92. package/dist/projections/graphs/views/GraphViewMemberKind.d.ts.map +1 -0
  93. package/dist/projections/graphs/views/GraphViewMemberKind.js +15 -0
  94. package/dist/projections/graphs/views/GraphViewMemberKind.js.map +1 -0
  95. package/dist/projections/graphs/views/GraphViewMemberMetadata.d.ts +22 -0
  96. package/dist/projections/graphs/views/GraphViewMemberMetadata.d.ts.map +1 -0
  97. package/dist/projections/graphs/views/GraphViewMemberMetadata.js +4 -0
  98. package/dist/projections/graphs/views/GraphViewMemberMetadata.js.map +1 -0
  99. package/dist/projections/graphs/views/GraphViewPropertyMember.d.ts +13 -0
  100. package/dist/projections/graphs/views/GraphViewPropertyMember.d.ts.map +1 -0
  101. package/dist/projections/graphs/views/GraphViewPropertyMember.js +4 -0
  102. package/dist/projections/graphs/views/GraphViewPropertyMember.js.map +1 -0
  103. package/dist/projections/graphs/views/GraphViewReason.d.ts +33 -0
  104. package/dist/projections/graphs/views/GraphViewReason.d.ts.map +1 -0
  105. package/dist/projections/graphs/views/GraphViewReason.js +36 -0
  106. package/dist/projections/graphs/views/GraphViewReason.js.map +1 -0
  107. package/dist/projections/graphs/views/GraphViewRelationMember.d.ts +21 -0
  108. package/dist/projections/graphs/views/GraphViewRelationMember.d.ts.map +1 -0
  109. package/dist/projections/graphs/views/GraphViewRelationMember.js +4 -0
  110. package/dist/projections/graphs/views/GraphViewRelationMember.js.map +1 -0
  111. package/dist/projections/graphs/views/GraphViewSchema.d.ts +10 -0
  112. package/dist/projections/graphs/views/GraphViewSchema.d.ts.map +1 -0
  113. package/dist/projections/graphs/views/GraphViewSchema.js +4 -0
  114. package/dist/projections/graphs/views/GraphViewSchema.js.map +1 -0
  115. package/dist/projections/graphs/views/GraphViewSchemaEdge.d.ts +14 -0
  116. package/dist/projections/graphs/views/GraphViewSchemaEdge.d.ts.map +1 -0
  117. package/dist/projections/graphs/views/GraphViewSchemaEdge.js +4 -0
  118. package/dist/projections/graphs/views/GraphViewSchemaEdge.js.map +1 -0
  119. package/dist/projections/graphs/views/GraphViewSchemaNode.d.ts +10 -0
  120. package/dist/projections/graphs/views/GraphViewSchemaNode.d.ts.map +1 -0
  121. package/dist/projections/graphs/views/GraphViewSchemaNode.js +4 -0
  122. package/dist/projections/graphs/views/GraphViewSchemaNode.js.map +1 -0
  123. package/dist/projections/graphs/views/GraphViewSerializerOptions.d.ts +9 -0
  124. package/dist/projections/graphs/views/GraphViewSerializerOptions.d.ts.map +1 -0
  125. package/dist/projections/graphs/views/GraphViewSerializerOptions.js +4 -0
  126. package/dist/projections/graphs/views/GraphViewSerializerOptions.js.map +1 -0
  127. package/dist/projections/graphs/views/RecursiveView.d.ts +15 -0
  128. package/dist/projections/graphs/views/RecursiveView.d.ts.map +1 -0
  129. package/dist/projections/graphs/views/RecursiveView.js +20 -0
  130. package/dist/projections/graphs/views/RecursiveView.js.map +1 -0
  131. package/dist/projections/graphs/views/RelationTargetNotAView.d.ts +16 -0
  132. package/dist/projections/graphs/views/RelationTargetNotAView.d.ts.map +1 -0
  133. package/dist/projections/graphs/views/RelationTargetNotAView.js +21 -0
  134. package/dist/projections/graphs/views/RelationTargetNotAView.js.map +1 -0
  135. package/dist/projections/graphs/views/TargetLabelMismatch.d.ts +18 -0
  136. package/dist/projections/graphs/views/TargetLabelMismatch.d.ts.map +1 -0
  137. package/dist/projections/graphs/views/TargetLabelMismatch.js +23 -0
  138. package/dist/projections/graphs/views/TargetLabelMismatch.js.map +1 -0
  139. package/dist/projections/graphs/views/UnknownEdge.d.ts +16 -0
  140. package/dist/projections/graphs/views/UnknownEdge.d.ts.map +1 -0
  141. package/dist/projections/graphs/views/UnknownEdge.js +21 -0
  142. package/dist/projections/graphs/views/UnknownEdge.js.map +1 -0
  143. package/dist/projections/graphs/views/UnknownEdgeProperty.d.ts +17 -0
  144. package/dist/projections/graphs/views/UnknownEdgeProperty.d.ts.map +1 -0
  145. package/dist/projections/graphs/views/UnknownEdgeProperty.js +22 -0
  146. package/dist/projections/graphs/views/UnknownEdgeProperty.js.map +1 -0
  147. package/dist/projections/graphs/views/UnknownNodeProperty.d.ts +17 -0
  148. package/dist/projections/graphs/views/UnknownNodeProperty.d.ts.map +1 -0
  149. package/dist/projections/graphs/views/UnknownNodeProperty.js +22 -0
  150. package/dist/projections/graphs/views/UnknownNodeProperty.js.map +1 -0
  151. package/dist/projections/graphs/views/ViewIsAlsoSchema.d.ts +14 -0
  152. package/dist/projections/graphs/views/ViewIsAlsoSchema.d.ts.map +1 -0
  153. package/dist/projections/graphs/views/ViewIsAlsoSchema.js +19 -0
  154. package/dist/projections/graphs/views/ViewIsAlsoSchema.js.map +1 -0
  155. package/dist/projections/graphs/views/ViewOfMetadata.d.ts +8 -0
  156. package/dist/projections/graphs/views/ViewOfMetadata.d.ts.map +1 -0
  157. package/dist/projections/graphs/views/ViewOfMetadata.js +4 -0
  158. package/dist/projections/graphs/views/ViewOfMetadata.js.map +1 -0
  159. package/dist/projections/graphs/views/ViewOfOptions.d.ts +6 -0
  160. package/dist/projections/graphs/views/ViewOfOptions.d.ts.map +1 -0
  161. package/dist/projections/graphs/views/ViewOfOptions.js +4 -0
  162. package/dist/projections/graphs/views/ViewOfOptions.js.map +1 -0
  163. package/dist/projections/graphs/views/ViewRootNotANode.d.ts +16 -0
  164. package/dist/projections/graphs/views/ViewRootNotANode.d.ts.map +1 -0
  165. package/dist/projections/graphs/views/ViewRootNotANode.js +21 -0
  166. package/dist/projections/graphs/views/ViewRootNotANode.js.map +1 -0
  167. package/dist/projections/graphs/views/declareGraphViewMember.d.ts +17 -0
  168. package/dist/projections/graphs/views/declareGraphViewMember.d.ts.map +1 -0
  169. package/dist/projections/graphs/views/declareGraphViewMember.js +31 -0
  170. package/dist/projections/graphs/views/declareGraphViewMember.js.map +1 -0
  171. package/dist/projections/graphs/views/follows.d.ts +13 -0
  172. package/dist/projections/graphs/views/follows.d.ts.map +1 -0
  173. package/dist/projections/graphs/views/follows.js +24 -0
  174. package/dist/projections/graphs/views/follows.js.map +1 -0
  175. package/dist/projections/graphs/views/fromEdge.d.ts +10 -0
  176. package/dist/projections/graphs/views/fromEdge.d.ts.map +1 -0
  177. package/dist/projections/graphs/views/fromEdge.js +15 -0
  178. package/dist/projections/graphs/views/fromEdge.js.map +1 -0
  179. package/dist/projections/graphs/views/index.d.ts +41 -0
  180. package/dist/projections/graphs/views/index.d.ts.map +1 -0
  181. package/dist/projections/graphs/views/index.js +28 -0
  182. package/dist/projections/graphs/views/index.js.map +1 -0
  183. package/dist/projections/graphs/views/viewKey.d.ts +8 -0
  184. package/dist/projections/graphs/views/viewKey.d.ts.map +1 -0
  185. package/dist/projections/graphs/views/viewKey.js +13 -0
  186. package/dist/projections/graphs/views/viewKey.js.map +1 -0
  187. package/dist/projections/graphs/views/viewOf.d.ts +22 -0
  188. package/dist/projections/graphs/views/viewOf.d.ts.map +1 -0
  189. package/dist/projections/graphs/views/viewOf.js +41 -0
  190. package/dist/projections/graphs/views/viewOf.js.map +1 -0
  191. package/dist/projections/graphs/views/viewProperty.d.ts +9 -0
  192. package/dist/projections/graphs/views/viewProperty.d.ts.map +1 -0
  193. package/dist/projections/graphs/views/viewProperty.js +14 -0
  194. package/dist/projections/graphs/views/viewProperty.js.map +1 -0
  195. package/dist/testing/InProcessAppendMetadata.d.ts +30 -0
  196. package/dist/testing/InProcessAppendMetadata.d.ts.map +1 -0
  197. package/dist/testing/InProcessAppendMetadata.js +107 -0
  198. package/dist/testing/InProcessAppendMetadata.js.map +1 -0
  199. package/dist/testing/InProcessBatchAppend.d.ts +62 -0
  200. package/dist/testing/InProcessBatchAppend.d.ts.map +1 -0
  201. package/dist/testing/InProcessBatchAppend.js +131 -0
  202. package/dist/testing/InProcessBatchAppend.js.map +1 -0
  203. package/dist/testing/InProcessEventPayload.d.ts +23 -0
  204. package/dist/testing/InProcessEventPayload.d.ts.map +1 -0
  205. package/dist/testing/InProcessEventPayload.js +94 -0
  206. package/dist/testing/InProcessEventPayload.js.map +1 -0
  207. package/dist/testing/InProcessEventReadCriteria.d.ts +9 -0
  208. package/dist/testing/InProcessEventReadCriteria.d.ts.map +1 -0
  209. package/dist/testing/InProcessEventReadCriteria.js +4 -0
  210. package/dist/testing/InProcessEventReadCriteria.js.map +1 -0
  211. package/dist/testing/InProcessEventReadFilter.d.ts +14 -0
  212. package/dist/testing/InProcessEventReadFilter.d.ts.map +1 -0
  213. package/dist/testing/InProcessEventReadFilter.js +31 -0
  214. package/dist/testing/InProcessEventReadFilter.js.map +1 -0
  215. package/dist/testing/InProcessEventSequence.d.ts +8 -5
  216. package/dist/testing/InProcessEventSequence.d.ts.map +1 -1
  217. package/dist/testing/InProcessEventSequence.js +59 -275
  218. package/dist/testing/InProcessEventSequence.js.map +1 -1
  219. package/dist/testing/InProcessEventSequenceEnvironment.d.ts +13 -0
  220. package/dist/testing/InProcessEventSequenceEnvironment.d.ts.map +1 -0
  221. package/dist/testing/InProcessEventSequenceEnvironment.js +4 -0
  222. package/dist/testing/InProcessEventSequenceEnvironment.js.map +1 -0
  223. package/dist/testing/InProcessSingleAppend.d.ts +34 -0
  224. package/dist/testing/InProcessSingleAppend.d.ts.map +1 -0
  225. package/dist/testing/InProcessSingleAppend.js +95 -0
  226. package/dist/testing/InProcessSingleAppend.js.map +1 -0
  227. package/dist/testing/projections/ProjectionCapabilities.d.ts +0 -8
  228. package/dist/testing/projections/ProjectionCapabilities.d.ts.map +1 -1
  229. package/dist/testing/projections/ProjectionCapabilities.js +21 -312
  230. package/dist/testing/projections/ProjectionCapabilities.js.map +1 -1
  231. package/dist/testing/projections/ProjectionCapabilityReject.d.ts +3 -0
  232. package/dist/testing/projections/ProjectionCapabilityReject.d.ts.map +1 -0
  233. package/dist/testing/projections/ProjectionCapabilityReject.js +4 -0
  234. package/dist/testing/projections/ProjectionCapabilityReject.js.map +1 -0
  235. package/dist/testing/projections/ProjectionCapabilityReporter.d.ts +12 -0
  236. package/dist/testing/projections/ProjectionCapabilityReporter.d.ts.map +1 -0
  237. package/dist/testing/projections/ProjectionCapabilityReporter.js +33 -0
  238. package/dist/testing/projections/ProjectionCapabilityReporter.js.map +1 -0
  239. package/dist/testing/projections/ProjectionDefinitionCapabilities.d.ts +11 -0
  240. package/dist/testing/projections/ProjectionDefinitionCapabilities.d.ts.map +1 -0
  241. package/dist/testing/projections/ProjectionDefinitionCapabilities.js +45 -0
  242. package/dist/testing/projections/ProjectionDefinitionCapabilities.js.map +1 -0
  243. package/dist/testing/projections/ProjectionEventSchemaResolver.d.ts +13 -0
  244. package/dist/testing/projections/ProjectionEventSchemaResolver.d.ts.map +1 -0
  245. package/dist/testing/projections/ProjectionEventSchemaResolver.js +22 -0
  246. package/dist/testing/projections/ProjectionEventSchemaResolver.js.map +1 -0
  247. package/dist/testing/projections/ProjectionExpressionCapabilities.d.ts +19 -0
  248. package/dist/testing/projections/ProjectionExpressionCapabilities.d.ts.map +1 -0
  249. package/dist/testing/projections/ProjectionExpressionCapabilities.js +103 -0
  250. package/dist/testing/projections/ProjectionExpressionCapabilities.js.map +1 -0
  251. package/dist/testing/projections/ProjectionInitialValueCapabilities.d.ts +16 -0
  252. package/dist/testing/projections/ProjectionInitialValueCapabilities.d.ts.map +1 -0
  253. package/dist/testing/projections/ProjectionInitialValueCapabilities.js +72 -0
  254. package/dist/testing/projections/ProjectionInitialValueCapabilities.js.map +1 -0
  255. package/dist/testing/projections/ProjectionMappingCapabilities.d.ts +21 -0
  256. package/dist/testing/projections/ProjectionMappingCapabilities.d.ts.map +1 -0
  257. package/dist/testing/projections/ProjectionMappingCapabilities.js +86 -0
  258. package/dist/testing/projections/ProjectionMappingCapabilities.js.map +1 -0
  259. package/dist/testing/projections/ProjectionMappingValidation.d.ts +9 -0
  260. package/dist/testing/projections/ProjectionMappingValidation.d.ts.map +1 -0
  261. package/dist/testing/projections/ProjectionMappingValidation.js +4 -0
  262. package/dist/testing/projections/ProjectionMappingValidation.js.map +1 -0
  263. package/dist/testing/projections/ProjectionReadModelCapabilities.d.ts +11 -0
  264. package/dist/testing/projections/ProjectionReadModelCapabilities.d.ts.map +1 -0
  265. package/dist/testing/projections/ProjectionReadModelCapabilities.js +40 -0
  266. package/dist/testing/projections/ProjectionReadModelCapabilities.js.map +1 -0
  267. package/dist/testing/projections/ProjectionRootCapabilities.d.ts +20 -0
  268. package/dist/testing/projections/ProjectionRootCapabilities.d.ts.map +1 -0
  269. package/dist/testing/projections/ProjectionRootCapabilities.js +73 -0
  270. package/dist/testing/projections/ProjectionRootCapabilities.js.map +1 -0
  271. package/dist/testing/projections/ProjectionScalarConverter.d.ts +21 -0
  272. package/dist/testing/projections/ProjectionScalarConverter.d.ts.map +1 -0
  273. package/dist/testing/projections/ProjectionScalarConverter.js +105 -0
  274. package/dist/testing/projections/ProjectionScalarConverter.js.map +1 -0
  275. package/dist/testing/projections/ProjectionSchemaCapabilities.d.ts +26 -0
  276. package/dist/testing/projections/ProjectionSchemaCapabilities.d.ts.map +1 -0
  277. package/dist/testing/projections/ProjectionSchemaCapabilities.js +109 -0
  278. package/dist/testing/projections/ProjectionSchemaCapabilities.js.map +1 -0
  279. package/dist/testing/projections/ProjectionValueConverter.d.ts +5 -0
  280. package/dist/testing/projections/ProjectionValueConverter.d.ts.map +1 -1
  281. package/dist/testing/projections/ProjectionValueConverter.js +36 -84
  282. package/dist/testing/projections/ProjectionValueConverter.js.map +1 -1
  283. package/dist/tsconfig.tsbuildinfo +1 -1
  284. package/dist/types/DecoratorType.d.ts +3 -1
  285. package/dist/types/DecoratorType.d.ts.map +1 -1
  286. package/dist/types/DecoratorType.js +2 -0
  287. package/dist/types/DecoratorType.js.map +1 -1
  288. package/package.json +2 -2
  289. package/projections/for_Graphs/given/a_discovered_graph.ts +3 -2
  290. package/projections/for_Graphs/given/a_graph_with_views.ts +91 -0
  291. package/projections/for_Graphs/given/organization.ts +3 -2
  292. package/projections/for_Graphs/given/organization_with_views.fixture.ts +129 -0
  293. package/projections/for_Graphs/when_building_graph_views.spec.ts +218 -0
  294. package/projections/for_Graphs/when_declaring_an_invalid_graph_view.spec.ts +229 -0
  295. package/projections/for_Graphs/when_declaring_graph_views.standard.spec.ts +49 -0
  296. package/projections/for_Graphs/when_discovering_graph_views.spec.ts +58 -0
  297. package/projections/graphs/Graphs.ts +44 -0
  298. package/projections/graphs/IGraphs.ts +10 -2
  299. package/projections/graphs/index.ts +1 -0
  300. package/projections/graphs/views/AmbiguousDirection.ts +23 -0
  301. package/projections/graphs/views/DuplicateViewName.ts +23 -0
  302. package/projections/graphs/views/EdgeNotIncidentOnRoot.ts +24 -0
  303. package/projections/graphs/views/EdgePropertyViewNotUsedAsTarget.ts +21 -0
  304. package/projections/graphs/views/EdgePropertyViewSharedAcrossEdges.ts +22 -0
  305. package/projections/graphs/views/FollowsOptions.ts +20 -0
  306. package/projections/graphs/views/GraphEdgeDirection.ts +13 -0
  307. package/projections/graphs/views/GraphView.ts +18 -0
  308. package/projections/graphs/views/GraphViewBuildResult.ts +19 -0
  309. package/projections/graphs/views/GraphViewCardinality.ts +13 -0
  310. package/projections/graphs/views/GraphViewDefinition.ts +20 -0
  311. package/projections/graphs/views/GraphViewDefinitionBuilder.ts +322 -0
  312. package/projections/graphs/views/GraphViewDefinitionSerializer.ts +90 -0
  313. package/projections/graphs/views/GraphViewEdgeReference.ts +8 -0
  314. package/projections/graphs/views/GraphViewMember.ts +11 -0
  315. package/projections/graphs/views/GraphViewMemberKind.ts +16 -0
  316. package/projections/graphs/views/GraphViewMemberMetadata.ts +31 -0
  317. package/projections/graphs/views/GraphViewPropertyMember.ts +18 -0
  318. package/projections/graphs/views/GraphViewReason.ts +47 -0
  319. package/projections/graphs/views/GraphViewRelationMember.ts +29 -0
  320. package/projections/graphs/views/GraphViewSchema.ts +14 -0
  321. package/projections/graphs/views/GraphViewSchemaEdge.ts +20 -0
  322. package/projections/graphs/views/GraphViewSchemaNode.ts +14 -0
  323. package/projections/graphs/views/GraphViewSerializerOptions.ts +11 -0
  324. package/projections/graphs/views/RecursiveView.ts +22 -0
  325. package/projections/graphs/views/RelationTargetNotAView.ts +23 -0
  326. package/projections/graphs/views/TargetLabelMismatch.ts +25 -0
  327. package/projections/graphs/views/UnknownEdge.ts +23 -0
  328. package/projections/graphs/views/UnknownEdgeProperty.ts +24 -0
  329. package/projections/graphs/views/UnknownNodeProperty.ts +24 -0
  330. package/projections/graphs/views/ViewIsAlsoSchema.ts +21 -0
  331. package/projections/graphs/views/ViewOfMetadata.ts +11 -0
  332. package/projections/graphs/views/ViewOfOptions.ts +8 -0
  333. package/projections/graphs/views/ViewRootNotANode.ts +23 -0
  334. package/projections/graphs/views/declareGraphViewMember.ts +36 -0
  335. package/projections/graphs/views/follows.ts +28 -0
  336. package/projections/graphs/views/fromEdge.ts +17 -0
  337. package/projections/graphs/views/index.ts +43 -0
  338. package/projections/graphs/views/viewKey.ts +15 -0
  339. package/projections/graphs/views/viewOf.ts +50 -0
  340. package/projections/graphs/views/viewProperty.ts +16 -0
  341. package/testing/InProcessAppendMetadata.ts +119 -0
  342. package/testing/InProcessBatchAppend.ts +142 -0
  343. package/testing/InProcessEventPayload.ts +100 -0
  344. package/testing/InProcessEventReadCriteria.ts +11 -0
  345. package/testing/InProcessEventReadFilter.ts +37 -0
  346. package/testing/InProcessEventSequence.ts +63 -257
  347. package/testing/InProcessEventSequenceEnvironment.ts +16 -0
  348. package/testing/InProcessSingleAppend.ts +99 -0
  349. package/testing/for_InProcessEventSequence/when_preserving_validation_and_commit_order.spec.ts +95 -0
  350. package/testing/projections/ProjectionCapabilities.ts +23 -279
  351. package/testing/projections/ProjectionCapabilityReject.ts +5 -0
  352. package/testing/projections/ProjectionCapabilityReporter.ts +31 -0
  353. package/testing/projections/ProjectionDefinitionCapabilities.ts +45 -0
  354. package/testing/projections/ProjectionEventSchemaResolver.ts +23 -0
  355. package/testing/projections/ProjectionExpressionCapabilities.ts +101 -0
  356. package/testing/projections/ProjectionInitialValueCapabilities.ts +73 -0
  357. package/testing/projections/ProjectionMappingCapabilities.ts +85 -0
  358. package/testing/projections/ProjectionMappingValidation.ts +12 -0
  359. package/testing/projections/ProjectionReadModelCapabilities.ts +42 -0
  360. package/testing/projections/ProjectionRootCapabilities.ts +75 -0
  361. package/testing/projections/ProjectionScalarConverter.ts +106 -0
  362. package/testing/projections/ProjectionSchemaCapabilities.ts +112 -0
  363. package/testing/projections/ProjectionValueConverter.ts +37 -76
  364. package/testing/projections/for_ProjectionCapabilities/when_reporting_the_first_unsupported_operation.spec.ts +74 -0
  365. package/testing/projections/for_ProjectionValueConverter/when_converting_structured_and_scalar_values.spec.ts +64 -0
  366. package/types/DecoratorType.ts +4 -1
@@ -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
+ }
@@ -0,0 +1,119 @@
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 { Guid } from '@cratis/fundamentals';
5
+ import { toContractsGuid } from '../connection/Guid.js';
6
+ import { Identity } from '../identity/Identity.js';
7
+ import type { prepareSingleAppend } from '../eventSequences/prepareSingleAppend.js';
8
+ import type { AppendOptions } from '../eventSequences/AppendOptions.js';
9
+ import type { EventForEventSourceId } from '../eventSequences/EventForEventSourceId.js';
10
+ import { hasNamedTags } from './singleAppendRoute.js';
11
+ import type { InProcessEventSequenceEnvironment } from './InProcessEventSequenceEnvironment.js';
12
+
13
+ /** Prepares only the metadata domain proven by the in-process append fixtures. */
14
+ export class InProcessAppendMetadata {
15
+ constructor(private readonly environment: InProcessEventSequenceEnvironment) {}
16
+
17
+ batch(options?: AppendOptions): void {
18
+ if (options === undefined) return;
19
+ if (!this.optionsObject(options)) {
20
+ throw this.environment.unsupported('appendMany.options', this.environment.sequenceId, 'Append options must be an object.');
21
+ }
22
+ if (hasNamedTags(options.namedTags)) throw this.environment.unsupported('appendMany.namedTags', this.environment.sequenceId, 'Named tags are not fixture-backed.');
23
+ this.batchKeys(options);
24
+ this.subject(options);
25
+ this.tags(options);
26
+ }
27
+
28
+ entry(entry: EventForEventSourceId): void {
29
+ if (!this.entryObject(entry) || this.unknown(entry,
30
+ ['eventSourceId', 'event', 'eventSourceType', 'eventStreamType', 'eventStreamId', 'subject', 'occurred', 'tags', 'namedTags'])) {
31
+ throw this.environment.unsupported('appendMany.entry', this.environment.sequenceId, 'Unrecognized per-entry metadata.');
32
+ }
33
+ if (hasNamedTags(entry.namedTags)) throw this.environment.unsupported('appendMany.namedTags', this.environment.sequenceId, 'Named tags are not fixture-backed.');
34
+ if (entry.occurred !== undefined) this.checkedDate(entry.occurred, 'appendMany.occurred');
35
+ this.subject(entry);
36
+ this.tags(entry);
37
+ }
38
+
39
+ guid(value: string | Guid, operation: string): void {
40
+ try {
41
+ toContractsGuid(Guid.as(value));
42
+ if (!/^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$/i.test(value.toString())) throw new Error('Invalid GUID.');
43
+ } catch { throw this.environment.unsupported(operation, this.environment.sequenceId, 'Correlation ID must be a valid GUID.'); }
44
+ }
45
+
46
+ checkedDate(value: Date, operation: string): Date {
47
+ if (!(value instanceof Date) || !this.validTime(value)) {
48
+ throw this.environment.unsupported(operation, this.environment.sequenceId, 'Occurrence must be within UTC years 1–9999 at millisecond precision.');
49
+ }
50
+ return new Date(value);
51
+ }
52
+
53
+ source(source: string, operation: string): void {
54
+ if (typeof source !== 'string' || !/^[A-Za-z0-9_-]+$/.test(source)) {
55
+ throw this.environment.unsupported(operation, String(source), 'Only simple source identifiers are fixture-backed.');
56
+ }
57
+ }
58
+
59
+ private subject(metadata: Pick<AppendOptions, 'subject'>): void {
60
+ if (!this.validSubject(metadata)) {
61
+ throw this.environment.unsupported('appendMany.subject', this.environment.sequenceId, 'Subject must be a string.');
62
+ }
63
+ }
64
+
65
+ private validSubject(metadata: Pick<AppendOptions, 'subject'>): boolean {
66
+ return metadata.subject === undefined || metadata.subject === null || typeof metadata.subject === 'string';
67
+ }
68
+
69
+ private tags(metadata: Pick<AppendOptions, 'tags'>): void {
70
+ if (metadata.tags && !this.stringTags(metadata)) {
71
+ throw this.environment.unsupported('appendMany.tags', this.environment.sequenceId, 'Only plain string tags are fixture-backed.');
72
+ }
73
+ }
74
+
75
+ unsupportedOptions(options?: AppendOptions): boolean {
76
+ if (options?.concurrencyScope !== undefined || options?.concurrencyScopes !== undefined) return true;
77
+ return options?.eventSourceId !== undefined;
78
+ }
79
+
80
+ storedSubject(subject: string | undefined, eventSourceId: string): string {
81
+ // Match the kernel's string.IsNullOrWhiteSpace, including U+0085 but not U+FEFF.
82
+ return subject && !/^\p{White_Space}*$/u.test(subject) ? subject : eventSourceId;
83
+ }
84
+
85
+ private batchKeys(options: AppendOptions): void {
86
+ const allowed = ['correlationId', 'sourceType', 'streamType', 'streamId', 'subject', 'occurred', 'tags', 'namedTags'];
87
+ if (this.unknown(options, allowed) || this.unsupportedOptions(options)) {
88
+ throw this.environment.unsupported('appendMany.options', this.environment.sequenceId, 'Concurrency and unrecognized metadata are not fixture-backed.');
89
+ }
90
+ }
91
+
92
+ private unknown(value: object, allowed: string[]): boolean {
93
+ return Reflect.ownKeys(value).some(key => !allowed.includes(String(key)));
94
+ }
95
+
96
+ private validTime(value: Date): boolean {
97
+ return !Number.isNaN(value.getTime()) && value.getUTCFullYear() >= 1 && value.getUTCFullYear() <= 9999;
98
+ }
99
+
100
+ private stringTags(metadata: Pick<AppendOptions, 'tags'>): boolean {
101
+ return Array.isArray(metadata.tags) && !metadata.tags.some(tag => typeof tag !== 'string');
102
+ }
103
+
104
+ private entryObject(value: unknown): boolean {
105
+ return !!value && typeof value === 'object';
106
+ }
107
+
108
+ private optionsObject(value: unknown): boolean {
109
+ return this.entryObject(value) && !Array.isArray(value);
110
+ }
111
+
112
+ ambientContext(identity: Identity, chain: ReturnType<typeof prepareSingleAppend>['causationChain']): boolean {
113
+ return identity === Identity.system && this.emptyRoot(chain);
114
+ }
115
+
116
+ private emptyRoot(chain: ReturnType<typeof prepareSingleAppend>['causationChain']): boolean {
117
+ return chain.length === 2 && Object.keys(chain[0].properties).length === 0;
118
+ }
119
+ }
@@ -0,0 +1,142 @@
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 { AppendedEvent } from '../events/AppendedEvent.js';
5
+ import { EventObservationState } from '@cratis/chronicle.contracts';
6
+ import { getEventTypeFor } from '../events/eventTypeDecorator.js';
7
+ import { Tag } from '../events/Tag.js';
8
+ import type { AppendOptions } from '../eventSequences/AppendOptions.js';
9
+ import type { AppendResult } from '../eventSequences/AppendResult.js';
10
+ import type { EventForEventSourceId } from '../eventSequences/EventForEventSourceId.js';
11
+ import { EventSequenceNumber } from '../eventSequences/EventSequenceNumber.js';
12
+ import { prepareBatchAppend } from '../eventSequences/prepareBatchAppend.js';
13
+ import { InProcessAppendMetadata } from './InProcessAppendMetadata.js';
14
+ import { InProcessEventPayload } from './InProcessEventPayload.js';
15
+ import type { InProcessEventSequenceEnvironment } from './InProcessEventSequenceEnvironment.js';
16
+ import { UnsupportedEventSequenceOperation } from './UnsupportedEventSequenceOperation.js';
17
+
18
+ /** Stages a complete batch; the sequence alone decides whether to commit it. */
19
+ export class InProcessBatchAppend {
20
+ private readonly metadata: InProcessAppendMetadata;
21
+
22
+ constructor(private readonly environment: InProcessEventSequenceEnvironment, private readonly payload: InProcessEventPayload,
23
+ private readonly success: (sequence: EventSequenceNumber, artifact: string) => AppendResult) {
24
+ this.metadata = new InProcessAppendMetadata(environment);
25
+ }
26
+
27
+ prepare(sourceOrEvents: string | EventForEventSourceId[], eventsOrOptions: object[] | AppendOptions | undefined, options: AppendOptions | undefined, position: number) {
28
+ const entries = typeof sourceOrEvents === 'string' ? eventsOrOptions as object[] : sourceOrEvents;
29
+ const shared = typeof sourceOrEvents === 'string' ? options : eventsOrOptions as AppendOptions | undefined;
30
+ this.validateEntries(entries, shared, typeof sourceOrEvents === 'string');
31
+ const prepared = this.serialize(sourceOrEvents, entries, shared);
32
+ this.metadata.guid(prepared.correlationId, 'appendMany.correlationId');
33
+ this.context(prepared, entries.length);
34
+ const staged = prepared.eventsForEventSourceIds.map((_, index) => this.stage(prepared, index, position));
35
+ return { prepared, staged };
36
+ }
37
+
38
+ private validateEntries(entries: object[], shared: AppendOptions | undefined, sameSource: boolean): void {
39
+ this.array(entries);
40
+ this.metadata.batch(shared);
41
+ this.sharedOccurrence(shared);
42
+ for (const entry of entries) {
43
+ if (sameSource) break;
44
+ this.metadata.entry(entry as EventForEventSourceId);
45
+ }
46
+ }
47
+
48
+ private sharedOccurrence(shared?: AppendOptions): void {
49
+ if (shared?.occurred !== undefined) this.metadata.checkedDate(shared.occurred, 'appendMany.occurred');
50
+ }
51
+
52
+ private array(entries: object[]): void {
53
+ if (!Array.isArray(entries)) throw this.environment.unsupported('appendMany.arguments', this.environment.sequenceId, 'Events must be an array.');
54
+ if (!entries.length) throw this.environment.unsupported('appendMany.empty', this.environment.sequenceId, 'The kernel rejects an empty batch.');
55
+ }
56
+
57
+ private serialize(sourceOrEvents: string | EventForEventSourceId[], entries: object[], shared?: AppendOptions) {
58
+ try {
59
+ const batchOptions = this.options(shared);
60
+ if (batchOptions?.correlationId !== undefined) this.metadata.guid(batchOptions.correlationId, 'appendMany.correlationId');
61
+ return typeof sourceOrEvents === 'string'
62
+ ? prepareBatchAppend(sourceOrEvents, entries, batchOptions)
63
+ : prepareBatchAppend(sourceOrEvents, batchOptions);
64
+ } catch (error) {
65
+ if (error instanceof UnsupportedEventSequenceOperation) throw error;
66
+ throw this.environment.unsupported('appendMany.serialization', this.environment.sequenceId, `Batch preparation failed: ${String(error)}.`);
67
+ }
68
+ }
69
+
70
+ private options(shared?: AppendOptions): AppendOptions | undefined {
71
+ return shared?.correlationId === undefined && this.environment.correlationId ? this.withCorrelation(shared) : shared;
72
+ }
73
+
74
+ private withCorrelation(shared?: AppendOptions): AppendOptions {
75
+ const metadata = shared ?? {};
76
+ return { correlationId: this.environment.correlationId!(), sourceType: metadata.sourceType, streamType: metadata.streamType,
77
+ streamId: metadata.streamId, subject: metadata.subject, occurred: metadata.occurred, tags: metadata.tags,
78
+ namedTags: metadata.namedTags };
79
+ }
80
+
81
+ private context({ identity, batchCausationChain }: ReturnType<typeof prepareBatchAppend>, count: number): void {
82
+ if (!this.metadata.ambientContext(identity, batchCausationChain) || !this.batchContext(batchCausationChain, count)) {
83
+ throw this.environment.unsupported('appendMany.context', this.environment.sequenceId, 'Ambient identity or causation metadata is not fixture-backed.');
84
+ }
85
+ }
86
+
87
+ private batchContext(chain: ReturnType<typeof prepareBatchAppend>['batchCausationChain'], count: number): boolean {
88
+ return chain[1].type.name === 'TypeScriptClient.AppendMany' && chain[1].properties.count === String(count);
89
+ }
90
+
91
+ private stage(prepared: ReturnType<typeof prepareBatchAppend>, index: number, position: number) {
92
+ const { eventSourceId, event } = prepared.eventsForEventSourceIds[index];
93
+ this.eventInstance(event);
94
+ this.metadata.source(eventSourceId, 'appendMany.source');
95
+ const wire = prepared.eventsToAppend[index];
96
+ this.route(wire);
97
+ this.tags(wire, event);
98
+ const occurred = wire.Occurred ? this.metadata.checkedDate(new Date(wire.Occurred.Value), 'appendMany.occurred')
99
+ : this.metadata.checkedDate(this.environment.clock(), 'appendMany.clock');
100
+ const content = this.payload.checkedContent(event, wire.Content, 'appendMany.content');
101
+ const hash = this.payload.hash(wire.EventType.Id, eventSourceId, content);
102
+ const sequenceNumber = new EventSequenceNumber(BigInt(position + index));
103
+ const eventType = getEventTypeFor(event.constructor);
104
+ const stored: AppendedEvent = { eventType, content, context: {
105
+ eventStore: this.environment.store, namespace: this.environment.namespace, sequenceNumber: sequenceNumber.value, eventSourceId,
106
+ eventSourceType: wire.EventSourceType || 'Default', eventStreamType: wire.EventStreamType || 'All',
107
+ eventStreamId: wire.EventStreamId || 'Default', subject: this.metadata.storedSubject(wire.Subject, eventSourceId), hash, causedBy: prepared.identity,
108
+ observationState: EventObservationState.Initial, eventType, occurred, correlationId: prepared.correlationId.toString(),
109
+ causation: prepared.batchCausationChain.map(item => ({ type: item.type.name, occurred: item.occurred, properties: { ...item.properties } })),
110
+ tags: wire.Tags.map(tag => new Tag(tag)), namedTags: []
111
+ } };
112
+ return { stored, result: this.success(sequenceNumber, event.constructor.name) };
113
+ }
114
+
115
+ private eventInstance(event: object): void {
116
+ if (!this.registeredEvent(event)) {
117
+ throw this.environment.unsupported('appendMany.event', event?.constructor?.name ?? this.environment.sequenceId, 'Event is not in the selected catalog.');
118
+ }
119
+ }
120
+
121
+ private registeredEvent(event: object): boolean {
122
+ return !!event && typeof event === 'object' && this.environment.catalog.has(event.constructor);
123
+ }
124
+
125
+ private route(wire: ReturnType<typeof prepareBatchAppend>['eventsToAppend'][number]): void {
126
+ for (const [name, value] of Object.entries({ sourceType: wire.EventSourceType, streamType: wire.EventStreamType, streamId: wire.EventStreamId })) {
127
+ if (value !== undefined && !this.routeIdentifier(value)) {
128
+ throw this.environment.unsupported(`appendMany.${name}`, String(value), 'Only simple metadata identifiers are fixture-backed.');
129
+ }
130
+ }
131
+ }
132
+
133
+ private routeIdentifier(value: unknown): boolean {
134
+ return typeof value === 'string' && /^[A-Za-z0-9_-]*$/.test(value);
135
+ }
136
+
137
+ private tags(wire: ReturnType<typeof prepareBatchAppend>['eventsToAppend'][number], event: object): void {
138
+ if (wire.Tags.some(tag => !/^[A-Za-z0-9_-]+$/.test(tag))) {
139
+ throw this.environment.unsupported('appendMany.tags', event.constructor.name, 'Only simple string tags are fixture-backed.');
140
+ }
141
+ }
142
+ }
@@ -0,0 +1,100 @@
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 { createHash } from 'node:crypto';
5
+ import { conceptAsTypeKey, JsonSerializer, typeKeyOf, type Constructor } from '@cratis/fundamentals';
6
+ import type { AppendedEvent } from '../events/AppendedEvent.js';
7
+ import { EventType } from '../events/EventType.js';
8
+ import { EventTypeId } from '../events/EventTypeId.js';
9
+ import { EventTypeGeneration } from '../events/EventTypeGeneration.js';
10
+ import { Tag } from '../events/Tag.js';
11
+ import { Identity } from '../identity/Identity.js';
12
+ import type { JsonSchema } from '../schemas/JsonSchema.js';
13
+ import { matchesEventField } from './EventFieldSchema.js';
14
+ import type { InProcessConstraints } from './InProcessConstraints.js';
15
+ import type { InProcessEventSequenceEnvironment } from './InProcessEventSequenceEnvironment.js';
16
+
17
+ /** Schema-bound payload validation, canonical hashing, and isolated history snapshots. */
18
+ export class InProcessEventPayload {
19
+ constructor(private readonly environment: InProcessEventSequenceEnvironment, private readonly constraints?: InProcessConstraints) {}
20
+
21
+ checkedContent(event: object, serialized: string, operation: string,
22
+ mismatchReason = 'Content differs from the event schema.'): Record<string, unknown> {
23
+ const content = this.parse(serialized, event, operation);
24
+ const metadata = this.environment.catalog.get(event.constructor)!;
25
+ const properties = metadata.schema.properties!;
26
+ if (!this.objectWithProperties(content, properties) || !this.matchesProperties(event, content, properties)) {
27
+ throw this.environment.unsupported(operation, event.constructor.name, mismatchReason);
28
+ }
29
+ return content;
30
+ }
31
+
32
+ hash(typeId: string, source: string, content: Record<string, unknown>): string {
33
+ const canonical = Object.fromEntries(Object.entries(content).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0));
34
+ return createHash('sha256').update(`${typeId}|${source}|${JSON.stringify(canonical)}`).digest('base64');
35
+ }
36
+
37
+ snapshot(event: AppendedEvent): AppendedEvent {
38
+ const eventType = new EventType(new EventTypeId(event.eventType.id.value),
39
+ new EventTypeGeneration(event.eventType.generation.value), event.eventType.tombstone);
40
+ const causedBy = event.context.causedBy;
41
+ return {
42
+ eventType,
43
+ content: JSON.parse(JSON.stringify(event.content)) as Record<string, unknown>,
44
+ context: { ...event.context, eventType, occurred: new Date(event.context.occurred),
45
+ causedBy: causedBy && new Identity(causedBy.subject, causedBy.name, causedBy.userName, causedBy.onBehalfOf),
46
+ causation: event.context.causation.map(item => ({ ...item, occurred: item.occurred && new Date(item.occurred), properties: { ...item.properties } })),
47
+ tags: event.context.tags.map(item => new Tag(item.value)),
48
+ namedTags: [...(event.context.namedTags ?? [])] }
49
+ };
50
+ }
51
+
52
+ private parse(serialized: string, event: object, operation: string): Record<string, unknown> {
53
+ try { return JSON.parse(serialized) as Record<string, unknown>; }
54
+ catch { throw this.environment.unsupported(operation, event.constructor.name, 'Content must be valid JSON.'); }
55
+ }
56
+
57
+ private objectWithProperties(content: Record<string, unknown>, properties: Record<string, JsonSchema>): boolean {
58
+ if (!this.isObject(content)) return false;
59
+ return Object.keys(content).length === Object.keys(properties).length;
60
+ }
61
+
62
+ private isObject(content: unknown): boolean {
63
+ return !!content && typeof content === 'object' && !Array.isArray(content);
64
+ }
65
+
66
+ private matchesProperties(event: object, content: Record<string, unknown>, properties: Record<string, JsonSchema>): boolean {
67
+ return Object.entries(properties).every(property => this.matchesSchema(event, content, property));
68
+ }
69
+
70
+ private matchesSchema(event: object, content: Record<string, unknown>, [key, property]: [string, JsonSchema]): boolean {
71
+ return this.matchesProperty(content, key, property) && this.matchesConstraint(event, content, key) && this.matchesText(content[key], property);
72
+ }
73
+
74
+ private matchesProperty(content: Record<string, unknown>, key: string, property: JsonSchema): boolean {
75
+ return Object.hasOwn(content, key) && matchesEventField(content[key], property);
76
+ }
77
+
78
+ private matchesText(value: unknown, property: JsonSchema): boolean {
79
+ if (property.type !== 'string' || property.format !== undefined) return true;
80
+ return /^[\x20-\x21\x23-\x5b\x5d-\x7e\u00e9]*$/.test(value as string);
81
+ }
82
+
83
+ private matchesConstraint(event: object, content: Record<string, unknown>, key: string): boolean {
84
+ const metadata = this.environment.catalog.get(event.constructor)!;
85
+ if (!this.constraints?.isConstrainedProperty(metadata.eventType.id.value, key)) return true;
86
+ return this.matchesConstrainedValue(Reflect.get(event, key), content[key]);
87
+ }
88
+
89
+ private matchesConstrainedValue(value: unknown, content: unknown): boolean {
90
+ // Use production serialization for concepts, not their wrapper object's runtime type.
91
+ // Keep rejecting other unproven conversions, such as a Date assigned to a string field.
92
+ if (this.serializedConcept(value)) return JsonSerializer.serialize(value) === JSON.stringify(content);
93
+ return value === content;
94
+ }
95
+
96
+ private serializedConcept(value: unknown): boolean {
97
+ if (!value || typeof value !== 'object') return false;
98
+ return [conceptAsTypeKey, 'Guid'].includes(typeKeyOf(value.constructor as Constructor) ?? '');
99
+ }
100
+ }
@@ -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
+ /** Validated read criteria; route sentinels deliberately do not narrow history. */
5
+ export interface InProcessEventReadCriteria {
6
+ readonly source?: string;
7
+ readonly sourceType?: string;
8
+ readonly streamType?: string;
9
+ readonly streamId?: string;
10
+ readonly ids: readonly string[];
11
+ }
@@ -0,0 +1,37 @@
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 { AppendedEvent } from '../events/AppendedEvent.js';
5
+ import type { InProcessEventReadCriteria } from './InProcessEventReadCriteria.js';
6
+
7
+ /** Applies the same source, route-sentinel, and event-type semantics to each read surface. */
8
+ export class InProcessEventReadFilter {
9
+ constructor(private readonly criteria: InProcessEventReadCriteria) {}
10
+
11
+ matches(event: AppendedEvent): boolean {
12
+ return this.source(event) && this.sourceType(event) && this.streamType(event) && this.streamId(event) && this.eventType(event);
13
+ }
14
+
15
+ private source(event: AppendedEvent): boolean {
16
+ return this.criteria.source === undefined || event.context.eventSourceId === this.criteria.source;
17
+ }
18
+
19
+ private sourceType(event: AppendedEvent): boolean {
20
+ const value = this.criteria.sourceType;
21
+ return value === undefined || value === 'Default' || event.context.eventSourceType === value;
22
+ }
23
+
24
+ private streamType(event: AppendedEvent): boolean {
25
+ const value = this.criteria.streamType;
26
+ return value === undefined || value === 'All' || event.context.eventStreamType === value;
27
+ }
28
+
29
+ private streamId(event: AppendedEvent): boolean {
30
+ const value = this.criteria.streamId;
31
+ return value === undefined || value === 'Default' || event.context.eventStreamId === value;
32
+ }
33
+
34
+ private eventType(event: AppendedEvent): boolean {
35
+ return !this.criteria.ids.length || this.criteria.ids.includes(event.eventType.id.value);
36
+ }
37
+ }