@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
@@ -3,6 +3,7 @@
3
3
 
4
4
  import type { Constructor } from '@cratis/fundamentals';
5
5
  import type { GraphRegistration } from './GraphRegistration.js';
6
+ import type { GraphViewDefinition } from './views/GraphViewDefinition.js';
6
7
 
7
8
  /**
8
9
  * Defines a system for the property graphs an application declares, with the decorators and with the fluent builder,
@@ -13,8 +14,15 @@ export interface IGraphs {
13
14
  readonly registrations: readonly GraphRegistration[];
14
15
 
15
16
  /**
16
- * Gets the declarations that could not be turned into a registration, and why. One invalid graph does not
17
- * take the rest of the graphs down with it.
17
+ * Gets the definitions of the views declared over the graphs, one per graph that has views, as found by the last
18
+ * call to {@link IGraphs.discover}. The definitions are not registered with the kernel. Optional so
19
+ * implementations written before graph views keep working.
20
+ */
21
+ readonly viewDefinitions?: readonly GraphViewDefinition[];
22
+
23
+ /**
24
+ * Gets the declarations that could not be turned into a registration, and why, including views that break
25
+ * the rules of a view. One invalid graph or view does not take the rest of the graphs down with it.
18
26
  */
19
27
  readonly failures: ReadonlyMap<Constructor, Error>;
20
28
 
@@ -49,3 +49,4 @@ export { GraphKeyPropertyNotFound } from './GraphKeyPropertyNotFound.js';
49
49
  export { GraphElementCannotBeReadModel } from './GraphElementCannotBeReadModel.js';
50
50
  export { GraphHasDuplicateElement } from './GraphHasDuplicateElement.js';
51
51
  export { GraphDeclaredMoreThanOnce } from './GraphDeclaredMoreThanOnce.js';
52
+ export * from './views/index.js';
@@ -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 follows an edge that starts and ends at the same label without saying in which direction.
8
+ */
9
+ export class AmbiguousDirection extends Error {
10
+ /** The stable reason code of the rule that was broken. */
11
+ readonly reason = GraphViewReason.AmbiguousDirection;
12
+
13
+ /**
14
+ * Creates a new {@link AmbiguousDirection}.
15
+ * @param view - The view type.
16
+ * @param member - The name of the member.
17
+ * @param edge - The edge type.
18
+ */
19
+ constructor(view: Function, member: string, edge: string) {
20
+ super(`The member '${member}' of the view '${view.name}' follows '${edge}', which starts and ends at the same label. State the direction.`);
21
+ this.name = 'AmbiguousDirection';
22
+ }
23
+ }
@@ -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 two views of a graph have the same name.
8
+ */
9
+ export class DuplicateViewName extends Error {
10
+ /** The stable reason code of the rule that was broken. */
11
+ readonly reason = GraphViewReason.DuplicateViewName;
12
+
13
+ /**
14
+ * Creates a new {@link DuplicateViewName}.
15
+ * @param view - The view type that repeats the name.
16
+ * @param graph - The name of the graph.
17
+ * @param name - The name of the view.
18
+ */
19
+ constructor(view: Function, graph: string, name: string) {
20
+ super(`The view '${view.name}' repeats the view name '${name}' in the graph '${graph}'. Give it another name with viewOf.`);
21
+ this.name = 'DuplicateViewName';
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 a relation follows an edge that does not start or end at the root of the view.
8
+ */
9
+ export class EdgeNotIncidentOnRoot extends Error {
10
+ /** The stable reason code of the rule that was broken. */
11
+ readonly reason = GraphViewReason.EdgeNotIncidentOnRoot;
12
+
13
+ /**
14
+ * Creates a new {@link EdgeNotIncidentOnRoot}.
15
+ * @param view - The view type.
16
+ * @param member - The name of the member.
17
+ * @param edge - The edge type.
18
+ * @param root - The label of the root of the view.
19
+ */
20
+ constructor(view: Function, member: string, edge: string, root: string) {
21
+ super(`The member '${member}' of the view '${view.name}' follows '${edge}' in a direction that does not start at '${root}', the root of the view.`);
22
+ this.name = 'EdgeNotIncidentOnRoot';
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 with edge property members is not the target of any relation.
8
+ */
9
+ export class EdgePropertyViewNotUsedAsTarget extends Error {
10
+ /** The stable reason code of the rule that was broken. */
11
+ readonly reason = GraphViewReason.EdgePropertyViewNotUsedAsTarget;
12
+
13
+ /**
14
+ * Creates a new {@link EdgePropertyViewNotUsedAsTarget}.
15
+ * @param view - The view type.
16
+ */
17
+ constructor(view: Function) {
18
+ super(`The view '${view.name}' has members that read edge properties, but no relation yields it, so there is no edge to read them from.`);
19
+ this.name = 'EdgePropertyViewNotUsedAsTarget';
20
+ }
21
+ }
@@ -0,0 +1,22 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import { GraphViewReason } from './GraphViewReason.js';
5
+
6
+ /**
7
+ * Error raised when a view with edge property members is the target of relations of more than one edge type.
8
+ */
9
+ export class EdgePropertyViewSharedAcrossEdges extends Error {
10
+ /** The stable reason code of the rule that was broken. */
11
+ readonly reason = GraphViewReason.EdgePropertyViewSharedAcrossEdges;
12
+
13
+ /**
14
+ * Creates a new {@link EdgePropertyViewSharedAcrossEdges}.
15
+ * @param view - The view type.
16
+ * @param edges - The edge types of the relations that yield the view.
17
+ */
18
+ constructor(view: Function, edges: readonly string[]) {
19
+ super(`The view '${view.name}' has members that read edge properties, but relations of more than one edge type yield it (${edges.join(', ')}). Use one view per edge type.`);
20
+ this.name = 'EdgePropertyViewSharedAcrossEdges';
21
+ }
22
+ }
@@ -0,0 +1,20 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import type { GraphEdgeDirection } from './GraphEdgeDirection.js';
5
+ import type { GraphViewCardinality } from './GraphViewCardinality.js';
6
+
7
+ /** Options of the follows decorator. */
8
+ export interface FollowsOptions {
9
+ /**
10
+ * Whether the relation yields a list or a single item. TypeScript erases generic arguments, so the type of the
11
+ * member cannot say which one it is. Defaults to {@link GraphViewCardinality.Many}.
12
+ */
13
+ readonly cardinality?: GraphViewCardinality;
14
+
15
+ /**
16
+ * The direction in which the edge is followed. It is derived from the labels of the edge, except for an edge
17
+ * that starts and ends at the same label, which needs it to be stated.
18
+ */
19
+ readonly direction?: GraphEdgeDirection;
20
+ }
@@ -0,0 +1,13 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ /**
5
+ * Represents the direction in which a relation follows an edge, seen from the root node of the view.
6
+ */
7
+ export enum GraphEdgeDirection {
8
+ /** The root node is the source of the edge. */
9
+ Outgoing = 'outgoing',
10
+
11
+ /** The root node is the target of the edge. */
12
+ Incoming = 'incoming'
13
+ }
@@ -0,0 +1,18 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import type { GraphViewMember } from './GraphViewMember.js';
5
+
6
+ /**
7
+ * Represents a view over a graph as it is declared: anchored at one node label, with its members in declaration order.
8
+ */
9
+ export interface GraphView {
10
+ /** The name of the view, unique in its graph. */
11
+ readonly name: string;
12
+
13
+ /** The label of the node the view is anchored at. */
14
+ readonly root: string;
15
+
16
+ /** The members of the view, in the order they are declared. */
17
+ readonly members: readonly GraphViewMember[];
18
+ }
@@ -0,0 +1,19 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import type { Constructor } from '@cratis/fundamentals';
5
+ import type { GraphViewDefinition } from './GraphViewDefinition.js';
6
+
7
+ /**
8
+ * Represents the outcome of building the views of one graph.
9
+ */
10
+ export interface GraphViewBuildResult {
11
+ /**
12
+ * The definition of the views. It is missing when any view of the graph is invalid: a view can be read only
13
+ * together with the views it nests, so the views of a graph are emitted together or not at all.
14
+ */
15
+ readonly definition?: GraphViewDefinition;
16
+
17
+ /** The views that are invalid, and why. The error of each carries the reason code. */
18
+ readonly failures: ReadonlyMap<Constructor, Error>;
19
+ }
@@ -0,0 +1,13 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ /**
5
+ * Represents how many related items a relation of a graph view yields.
6
+ */
7
+ export enum GraphViewCardinality {
8
+ /** A list of related items. A relation without any related node yields an empty list. */
9
+ Many = 'many',
10
+
11
+ /** A single related item. A relation without any related node yields null. */
12
+ One = 'one'
13
+ }
@@ -0,0 +1,20 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import type { GraphView } from './GraphView.js';
5
+ import type { GraphViewSchema } from './GraphViewSchema.js';
6
+
7
+ /**
8
+ * Represents the views declared over a graph. It is the transport and conformance form of the views, shared by the
9
+ * Cratis clients: it is emitted from the declarations, never written by hand.
10
+ */
11
+ export interface GraphViewDefinition {
12
+ /** The name of the graph the views read. */
13
+ readonly graph: string;
14
+
15
+ /** The nodes and edges the views were validated against. It is written only when the serializer is asked to. */
16
+ readonly schema?: GraphViewSchema;
17
+
18
+ /** The views, sorted by name. */
19
+ readonly views: readonly GraphView[];
20
+ }
@@ -0,0 +1,322 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import type { Constructor } from '@cratis/fundamentals';
5
+ import { TypeIntrospector } from '../../../types/index.js';
6
+ import { getEdgeMetadata } from '../edge.js';
7
+ import type { GraphEdgeModel } from '../GraphEdgeModel.js';
8
+ import type { GraphModel } from '../GraphModel.js';
9
+ import { GraphSchemaWriter } from '../GraphSchemaWriter.js';
10
+ import { isGraphElement } from '../isGraphElement.js';
11
+ import { AmbiguousDirection } from './AmbiguousDirection.js';
12
+ import { DuplicateViewName } from './DuplicateViewName.js';
13
+ import { EdgeNotIncidentOnRoot } from './EdgeNotIncidentOnRoot.js';
14
+ import { EdgePropertyViewNotUsedAsTarget } from './EdgePropertyViewNotUsedAsTarget.js';
15
+ import { EdgePropertyViewSharedAcrossEdges } from './EdgePropertyViewSharedAcrossEdges.js';
16
+ import { GraphEdgeDirection } from './GraphEdgeDirection.js';
17
+ import { GraphViewCardinality } from './GraphViewCardinality.js';
18
+ import type { GraphViewBuildResult } from './GraphViewBuildResult.js';
19
+ import type { GraphViewDefinition } from './GraphViewDefinition.js';
20
+ import type { GraphViewEdgeReference } from './GraphViewEdgeReference.js';
21
+ import type { GraphViewMember } from './GraphViewMember.js';
22
+ import { getGraphViewMemberMetadata } from './declareGraphViewMember.js';
23
+ import { GraphViewMemberKind } from './GraphViewMemberKind.js';
24
+ import { RecursiveView } from './RecursiveView.js';
25
+ import { RelationTargetNotAView } from './RelationTargetNotAView.js';
26
+ import { TargetLabelMismatch } from './TargetLabelMismatch.js';
27
+ import { UnknownEdge } from './UnknownEdge.js';
28
+ import { UnknownEdgeProperty } from './UnknownEdgeProperty.js';
29
+ import { UnknownNodeProperty } from './UnknownNodeProperty.js';
30
+ import { ViewIsAlsoSchema } from './ViewIsAlsoSchema.js';
31
+ import { getViewOfMetadata } from './viewOf.js';
32
+ import { ViewRootNotANode } from './ViewRootNotANode.js';
33
+
34
+ interface NodeInfo {
35
+ readonly label: string;
36
+ readonly keyProperty: string;
37
+ readonly properties: readonly string[];
38
+ }
39
+
40
+ interface EdgeInfo {
41
+ readonly edgeType: string;
42
+ readonly identifiedBy?: string;
43
+ readonly sourceLabel: string;
44
+ readonly targetLabel: string;
45
+ readonly properties: readonly string[];
46
+ }
47
+
48
+ interface PropertyMemberInfo {
49
+ readonly kind: GraphViewMemberKind.Property;
50
+ readonly name: string;
51
+ readonly source: string;
52
+ }
53
+
54
+ interface EdgePropertyMemberInfo {
55
+ readonly kind: GraphViewMemberKind.EdgeProperty;
56
+ readonly name: string;
57
+ readonly requested: string;
58
+ source?: string;
59
+ }
60
+
61
+ interface RelationMemberInfo {
62
+ readonly kind: GraphViewMemberKind.Relation;
63
+ readonly name: string;
64
+ readonly edge: EdgeInfo;
65
+ readonly direction: GraphEdgeDirection;
66
+ readonly cardinality: GraphViewCardinality;
67
+ readonly target: Function;
68
+ readonly targetName: string;
69
+ }
70
+
71
+ type MemberInfo = PropertyMemberInfo | EdgePropertyMemberInfo | RelationMemberInfo;
72
+
73
+ interface ViewInfo {
74
+ readonly type: Constructor;
75
+ readonly name: string;
76
+ readonly node: NodeInfo;
77
+ readonly members: readonly MemberInfo[];
78
+ }
79
+
80
+ /**
81
+ * Validates the views declared over a graph and builds their {@link GraphViewDefinition}. Every rule of a view has a
82
+ * reason code, carried by the error that reports it. One invalid view never stops the discovery of anything else; it
83
+ * is reported, and the views of its graph are then withheld as a whole, because a view is read together with the views
84
+ * it nests.
85
+ */
86
+ export class GraphViewDefinitionBuilder {
87
+ private readonly _schemaWriter = new GraphSchemaWriter();
88
+
89
+ /**
90
+ * Builds the definition of the views of one graph.
91
+ * @param model - The {@link GraphModel} the views read.
92
+ * @param views - The view types that name the graph.
93
+ * @returns The {@link GraphViewBuildResult}.
94
+ */
95
+ build(model: GraphModel, views: readonly Constructor[]): GraphViewBuildResult {
96
+ const failures = new Map<Constructor, Error>();
97
+ const nodes = new Map<Function, NodeInfo>(model.nodes.map(node => [node.type, {
98
+ label: node.label,
99
+ keyProperty: node.keyProperty,
100
+ properties: Object.keys(this._schemaWriter.propertiesOf(node.type, []))
101
+ }]));
102
+ const edgesByClass = new Map<Function, EdgeInfo>();
103
+ const edgesByType = new Map<string, EdgeInfo>();
104
+ for (const edge of model.edges) {
105
+ const info = this.edgeInfo(edge, nodes);
106
+ edgesByClass.set(edge.type, info);
107
+ edgesByType.set(edge.edgeType, info);
108
+ }
109
+
110
+ const declared = new Set<Function>(views);
111
+ const names = new Set<string>();
112
+ const resolved = new Map<Constructor, ViewInfo>();
113
+ for (const type of views) {
114
+ try {
115
+ resolved.set(type, this.resolve(model.name, type, declared, names, nodes, edgesByClass, edgesByType));
116
+ } catch (error) {
117
+ failures.set(type, error instanceof Error ? error : new Error(String(error)));
118
+ }
119
+ }
120
+
121
+ this.validateAcrossViews(resolved, edgesByType, failures);
122
+ if (failures.size > 0) return { failures };
123
+
124
+ const definition: GraphViewDefinition = {
125
+ graph: model.name,
126
+ schema: {
127
+ nodes: [...nodes.values()].map(node => ({ label: node.label, key: node.keyProperty, properties: node.properties })),
128
+ edges: [...edgesByType.values()].map(edge => ({
129
+ type: edge.edgeType,
130
+ source: edge.sourceLabel,
131
+ target: edge.targetLabel,
132
+ ...(edge.identifiedBy === undefined ? {} : { identifiedBy: edge.identifiedBy }),
133
+ properties: edge.properties
134
+ }))
135
+ },
136
+ views: [...resolved.values()]
137
+ .map(view => ({ name: view.name, root: view.node.label, members: view.members.map(member => this.member(member)) }))
138
+ .sort((left, right) => (left.name === right.name ? 0 : left.name < right.name ? -1 : 1))
139
+ };
140
+ return { definition, failures };
141
+ }
142
+
143
+ private edgeInfo(edge: GraphEdgeModel, nodes: ReadonlyMap<Function, NodeInfo>): EdgeInfo {
144
+ return {
145
+ edgeType: edge.edgeType,
146
+ identifiedBy: edge.identifyingProperty,
147
+ sourceLabel: nodes.get(edge.sourceNode)?.label ?? '',
148
+ targetLabel: nodes.get(edge.targetNode)?.label ?? '',
149
+ properties: Object.keys(this._schemaWriter.propertiesOf(edge.type, edge.excludedProperties))
150
+ };
151
+ }
152
+
153
+ private resolve(
154
+ graph: string,
155
+ type: Constructor,
156
+ declared: ReadonlySet<Function>,
157
+ names: Set<string>,
158
+ nodes: ReadonlyMap<Function, NodeInfo>,
159
+ edgesByClass: ReadonlyMap<Function, EdgeInfo>,
160
+ edgesByType: ReadonlyMap<string, EdgeInfo>
161
+ ): ViewInfo {
162
+ const metadata = getViewOfMetadata(type)!;
163
+ const name = metadata.name;
164
+ const duplicate = names.has(name);
165
+ names.add(name);
166
+ if (isGraphElement(type)) throw new ViewIsAlsoSchema(type);
167
+ if (duplicate) throw new DuplicateViewName(type, graph, name);
168
+
169
+ const rootType = metadata.root();
170
+ const node = nodes.get(rootType);
171
+ if (node === undefined) throw new ViewRootNotANode(type, graph, rootType);
172
+
173
+ const members: MemberInfo[] = [];
174
+ for (const property of TypeIntrospector.getTrackedProperties(type)) {
175
+ const member = getGraphViewMemberMetadata(type.prototype, property);
176
+ if (member === undefined) continue;
177
+
178
+ const requested = member.source ?? property;
179
+ switch (member.kind) {
180
+ case GraphViewMemberKind.Property: {
181
+ const source = member.isKey ? node.keyProperty : this.find(node.properties, requested);
182
+ if (source === undefined) throw new UnknownNodeProperty(type, property, node.label, requested);
183
+ members.push({ kind: GraphViewMemberKind.Property, name: property, source });
184
+ break;
185
+ }
186
+ case GraphViewMemberKind.EdgeProperty:
187
+ members.push({ kind: GraphViewMemberKind.EdgeProperty, name: property, requested });
188
+ break;
189
+ case GraphViewMemberKind.Relation: {
190
+ const edge = this.edgeOf(member.edge!, edgesByClass, edgesByType);
191
+ if (edge === undefined) throw new UnknownEdge(type, property, this.edgeName(member.edge!));
192
+ const direction = this.directionOf(type, property, edge, node, member.direction);
193
+ const target = member.view!();
194
+ if (!declared.has(target)) throw new RelationTargetNotAView(type, property, target);
195
+ const expected = direction === GraphEdgeDirection.Outgoing ? edge.targetLabel : edge.sourceLabel;
196
+ const actual = nodes.get(getViewOfMetadata(target)!.root())?.label;
197
+ if (actual !== undefined && actual !== expected) throw new TargetLabelMismatch(type, property, target, expected, actual);
198
+ members.push({
199
+ kind: GraphViewMemberKind.Relation,
200
+ name: property,
201
+ edge,
202
+ direction,
203
+ cardinality: member.cardinality ?? GraphViewCardinality.Many,
204
+ target,
205
+ targetName: getViewOfMetadata(target)!.name
206
+ });
207
+ break;
208
+ }
209
+ }
210
+ }
211
+
212
+ return { type, name, node, members };
213
+ }
214
+
215
+ private directionOf(type: Function, member: string, edge: EdgeInfo, node: NodeInfo, explicit: GraphEdgeDirection | undefined): GraphEdgeDirection {
216
+ const outgoing = edge.sourceLabel === node.label;
217
+ const incoming = edge.targetLabel === node.label;
218
+ if (!outgoing && !incoming) throw new EdgeNotIncidentOnRoot(type, member, edge.edgeType, node.label);
219
+ if (outgoing && incoming) {
220
+ if (explicit === undefined) throw new AmbiguousDirection(type, member, edge.edgeType);
221
+ return explicit;
222
+ }
223
+
224
+ const derived = outgoing ? GraphEdgeDirection.Outgoing : GraphEdgeDirection.Incoming;
225
+ // An explicit direction the edge cannot be followed in does not start at the root of the view.
226
+ if (explicit !== undefined && explicit !== derived) throw new EdgeNotIncidentOnRoot(type, member, edge.edgeType, node.label);
227
+ return derived;
228
+ }
229
+
230
+ private validateAcrossViews(resolved: ReadonlyMap<Constructor, ViewInfo>, edgesByType: ReadonlyMap<string, EdgeInfo>, failures: Map<Constructor, Error>): void {
231
+ const used = new Map<Function, Set<string>>();
232
+ for (const view of resolved.values()) {
233
+ for (const member of view.members) {
234
+ if (member.kind !== GraphViewMemberKind.Relation) continue;
235
+ const edges = used.get(member.target) ?? new Set<string>();
236
+ edges.add(member.edge.edgeType);
237
+ used.set(member.target, edges);
238
+ }
239
+ }
240
+
241
+ for (const view of resolved.values()) {
242
+ try {
243
+ const cycle = this.cycleThrough(view, resolved);
244
+ if (cycle !== undefined) throw new RecursiveView(view.type, cycle);
245
+ this.validateEdgeProperties(view, used.get(view.type), edgesByType);
246
+ } catch (error) {
247
+ failures.set(view.type, error instanceof Error ? error : new Error(String(error)));
248
+ }
249
+ }
250
+ }
251
+
252
+ private validateEdgeProperties(view: ViewInfo, edges: ReadonlySet<string> | undefined, edgesByType: ReadonlyMap<string, EdgeInfo>): void {
253
+ const members = view.members.filter((member): member is EdgePropertyMemberInfo => member.kind === GraphViewMemberKind.EdgeProperty);
254
+ if (members.length === 0) return;
255
+ if (edges === undefined || edges.size === 0) throw new EdgePropertyViewNotUsedAsTarget(view.type);
256
+ if (edges.size > 1) throw new EdgePropertyViewSharedAcrossEdges(view.type, [...edges]);
257
+
258
+ const edge = edgesByType.get([...edges][0])!;
259
+ for (const member of members) {
260
+ member.source = this.find(edge.properties, member.requested);
261
+ if (member.source === undefined) throw new UnknownEdgeProperty(view.type, member.name, edge.edgeType, member.requested);
262
+ }
263
+ }
264
+
265
+ private cycleThrough(start: ViewInfo, resolved: ReadonlyMap<Constructor, ViewInfo>): string[] | undefined {
266
+ const visited = new Set<Function>();
267
+ const walk = (current: ViewInfo, path: string[]): string[] | undefined => {
268
+ for (const member of current.members) {
269
+ if (member.kind !== GraphViewMemberKind.Relation) continue;
270
+ const next = resolved.get(member.target as Constructor);
271
+ if (next === undefined) continue;
272
+ if (next === start) return [...path, next.name];
273
+ if (visited.has(next.type)) continue;
274
+ visited.add(next.type);
275
+ const found = walk(next, [...path, next.name]);
276
+ if (found !== undefined) return found;
277
+ }
278
+
279
+ return undefined;
280
+ };
281
+
282
+ return walk(start, [start.name]);
283
+ }
284
+
285
+ private member(member: MemberInfo): GraphViewMember {
286
+ switch (member.kind) {
287
+ case GraphViewMemberKind.Relation:
288
+ return {
289
+ name: member.name,
290
+ kind: member.kind,
291
+ edge: member.edge.edgeType,
292
+ direction: member.direction,
293
+ cardinality: member.cardinality,
294
+ view: member.targetName
295
+ };
296
+ case GraphViewMemberKind.EdgeProperty:
297
+ return { name: member.name, kind: member.kind, source: member.source! };
298
+ default:
299
+ return { name: member.name, kind: member.kind, source: member.source };
300
+ }
301
+ }
302
+
303
+ private edgeOf(
304
+ reference: GraphViewEdgeReference,
305
+ edgesByClass: ReadonlyMap<Function, EdgeInfo>,
306
+ edgesByType: ReadonlyMap<string, EdgeInfo>
307
+ ): EdgeInfo | undefined {
308
+ return typeof reference === 'string' ? edgesByType.get(reference) : edgesByClass.get(reference());
309
+ }
310
+
311
+ private edgeName(reference: GraphViewEdgeReference): string {
312
+ if (typeof reference === 'string') return reference;
313
+ const type = reference();
314
+ return getEdgeMetadata(type)?.type ?? type.name;
315
+ }
316
+
317
+ // Names are matched without regard to case, and an exact match wins.
318
+ private find(names: readonly string[], wanted: string): string | undefined {
319
+ const lowered = wanted.toLowerCase();
320
+ return names.find(name => name === wanted) ?? names.find(name => name.toLowerCase() === lowered);
321
+ }
322
+ }