@epistola.app/epistola-client 2.0.0-beta.3 → 2.0.0-rc.1

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 (468) hide show
  1. package/CHANGELOG.md +35 -20
  2. package/README.md +18 -9
  3. package/dist/collect/resultCollector.d.ts.map +1 -1
  4. package/dist/collect/resultCollector.js +3 -1
  5. package/dist/collect/resultCollector.js.map +1 -1
  6. package/dist/error/problemDetailException.d.ts +24 -3
  7. package/dist/error/problemDetailException.d.ts.map +1 -1
  8. package/dist/error/problemDetailException.js +29 -2
  9. package/dist/error/problemDetailException.js.map +1 -1
  10. package/dist/generated/api/apis/AttributesApi.d.ts +2 -2
  11. package/dist/generated/api/apis/AttributesApi.js +2 -2
  12. package/dist/generated/api/apis/CatalogsApi.d.ts +14 -6
  13. package/dist/generated/api/apis/CatalogsApi.d.ts.map +1 -1
  14. package/dist/generated/api/apis/CatalogsApi.js +13 -7
  15. package/dist/generated/api/apis/CatalogsApi.js.map +1 -1
  16. package/dist/generated/api/apis/CodeListsApi.d.ts +2 -2
  17. package/dist/generated/api/apis/CodeListsApi.js +2 -2
  18. package/dist/generated/api/apis/ConsumersApi.d.ts +4 -4
  19. package/dist/generated/api/apis/ConsumersApi.js +4 -4
  20. package/dist/generated/api/apis/EnvironmentsApi.d.ts +2 -2
  21. package/dist/generated/api/apis/EnvironmentsApi.js +2 -2
  22. package/dist/generated/api/apis/FontsApi.d.ts +2 -2
  23. package/dist/generated/api/apis/FontsApi.js +2 -2
  24. package/dist/generated/api/apis/GenerationApi.d.ts +6 -6
  25. package/dist/generated/api/apis/GenerationApi.js +7 -7
  26. package/dist/generated/api/apis/GenerationApi.js.map +1 -1
  27. package/dist/generated/api/apis/ImagesApi.d.ts +2 -2
  28. package/dist/generated/api/apis/ImagesApi.js +2 -2
  29. package/dist/generated/api/apis/QualityProfilesApi.d.ts +2 -2
  30. package/dist/generated/api/apis/QualityProfilesApi.js +2 -2
  31. package/dist/generated/api/apis/SearchApi.d.ts +2 -2
  32. package/dist/generated/api/apis/SearchApi.js +2 -2
  33. package/dist/generated/api/apis/StencilsApi.d.ts +2 -2
  34. package/dist/generated/api/apis/StencilsApi.js +2 -2
  35. package/dist/generated/api/apis/SystemApi.d.ts +2 -2
  36. package/dist/generated/api/apis/SystemApi.js +2 -2
  37. package/dist/generated/api/apis/TemplatesApi.d.ts +2 -2
  38. package/dist/generated/api/apis/TemplatesApi.js +2 -2
  39. package/dist/generated/api/apis/TenantsApi.d.ts +2 -2
  40. package/dist/generated/api/apis/TenantsApi.js +2 -2
  41. package/dist/generated/api/apis/ThemesApi.d.ts +2 -2
  42. package/dist/generated/api/apis/ThemesApi.js +2 -2
  43. package/dist/generated/api/apis/VariantsApi.d.ts +2 -2
  44. package/dist/generated/api/apis/VariantsApi.js +2 -2
  45. package/dist/generated/api/models/AmbiguousVariantProblemDetail.d.ts +2 -2
  46. package/dist/generated/api/models/AmbiguousVariantProblemDetail.js +2 -2
  47. package/dist/generated/api/models/ApproveConsumerRequest.d.ts +2 -2
  48. package/dist/generated/api/models/ApproveConsumerRequest.js +2 -2
  49. package/dist/generated/api/models/AttributeDto.d.ts +2 -2
  50. package/dist/generated/api/models/AttributeDto.js +2 -2
  51. package/dist/generated/api/models/AttributeListResponse.d.ts +2 -2
  52. package/dist/generated/api/models/AttributeListResponse.js +2 -2
  53. package/dist/generated/api/models/AvailableCatalogReleases.d.ts +11 -5
  54. package/dist/generated/api/models/AvailableCatalogReleases.d.ts.map +1 -1
  55. package/dist/generated/api/models/AvailableCatalogReleases.js +7 -2
  56. package/dist/generated/api/models/AvailableCatalogReleases.js.map +1 -1
  57. package/dist/generated/api/models/AvailableReleaseDependencyDto.d.ts +2 -2
  58. package/dist/generated/api/models/AvailableReleaseDependencyDto.js +2 -2
  59. package/dist/generated/api/models/AvailableReleaseDto.d.ts +2 -2
  60. package/dist/generated/api/models/AvailableReleaseDto.js +2 -2
  61. package/dist/generated/api/models/BatchGenerationItem.d.ts +2 -2
  62. package/dist/generated/api/models/BatchGenerationItem.js +2 -2
  63. package/dist/generated/api/models/BehindReleaseDto.d.ts +2 -2
  64. package/dist/generated/api/models/BehindReleaseDto.js +2 -2
  65. package/dist/generated/api/models/BlockStylePreset.d.ts +2 -2
  66. package/dist/generated/api/models/BlockStylePreset.js +2 -2
  67. package/dist/generated/api/models/CatalogChangesDto.d.ts +2 -2
  68. package/dist/generated/api/models/CatalogChangesDto.js +2 -2
  69. package/dist/generated/api/models/CatalogDependencyDto.d.ts +2 -2
  70. package/dist/generated/api/models/CatalogDependencyDto.js +2 -2
  71. package/dist/generated/api/models/CatalogDependencyListResponse.d.ts +2 -2
  72. package/dist/generated/api/models/CatalogDependencyListResponse.js +2 -2
  73. package/dist/generated/api/models/CatalogDependencyRequirement.d.ts +2 -2
  74. package/dist/generated/api/models/CatalogDependencyRequirement.js +2 -2
  75. package/dist/generated/api/models/CatalogDraftInUseProblemDetail.d.ts +70 -0
  76. package/dist/generated/api/models/CatalogDraftInUseProblemDetail.d.ts.map +1 -0
  77. package/dist/generated/api/models/CatalogDraftInUseProblemDetail.js +64 -0
  78. package/dist/generated/api/models/CatalogDraftInUseProblemDetail.js.map +1 -0
  79. package/dist/generated/api/models/CatalogDraftMergePreview.d.ts +2 -2
  80. package/dist/generated/api/models/CatalogDraftMergePreview.js +2 -2
  81. package/dist/generated/api/models/CatalogDraftMergeResource.d.ts +2 -2
  82. package/dist/generated/api/models/CatalogDraftMergeResource.js +2 -2
  83. package/dist/generated/api/models/CatalogDraftMergeSides.d.ts +2 -2
  84. package/dist/generated/api/models/CatalogDraftMergeSides.js +2 -2
  85. package/dist/generated/api/models/CatalogDraftRefDto.d.ts +51 -0
  86. package/dist/generated/api/models/CatalogDraftRefDto.d.ts.map +1 -0
  87. package/dist/generated/api/models/CatalogDraftRefDto.js +61 -0
  88. package/dist/generated/api/models/CatalogDraftRefDto.js.map +1 -0
  89. package/dist/generated/api/models/CatalogDraftReleasePreview.d.ts +2 -2
  90. package/dist/generated/api/models/CatalogDraftReleasePreview.js +2 -2
  91. package/dist/generated/api/models/CatalogDto.d.ts +2 -2
  92. package/dist/generated/api/models/CatalogDto.js +2 -2
  93. package/dist/generated/api/models/CatalogLevelChangeDto.d.ts +2 -2
  94. package/dist/generated/api/models/CatalogLevelChangeDto.js +2 -2
  95. package/dist/generated/api/models/CatalogListResponse.d.ts +2 -2
  96. package/dist/generated/api/models/CatalogListResponse.js +2 -2
  97. package/dist/generated/api/models/CatalogMergeBaseRef.d.ts +2 -2
  98. package/dist/generated/api/models/CatalogMergeBaseRef.js +2 -2
  99. package/dist/generated/api/models/CatalogMergeOutcome.d.ts +2 -2
  100. package/dist/generated/api/models/CatalogMergeOutcome.js +2 -2
  101. package/dist/generated/api/models/CatalogMergeSide.d.ts +2 -2
  102. package/dist/generated/api/models/CatalogMergeSide.js +2 -2
  103. package/dist/generated/api/models/CatalogPresetDto.d.ts +2 -2
  104. package/dist/generated/api/models/CatalogPresetDto.js +2 -2
  105. package/dist/generated/api/models/CatalogReadOnlyProblemDetail.d.ts +2 -2
  106. package/dist/generated/api/models/CatalogReadOnlyProblemDetail.js +2 -2
  107. package/dist/generated/api/models/CatalogReadOnlyReason.d.ts +2 -2
  108. package/dist/generated/api/models/CatalogReadOnlyReason.js +2 -2
  109. package/dist/generated/api/models/CatalogReleaseDto.d.ts +2 -2
  110. package/dist/generated/api/models/CatalogReleaseDto.js +2 -2
  111. package/dist/generated/api/models/CatalogReleaseListResponse.d.ts +2 -2
  112. package/dist/generated/api/models/CatalogReleaseListResponse.js +2 -2
  113. package/dist/generated/api/models/CatalogReleaseRefDto.d.ts +2 -2
  114. package/dist/generated/api/models/CatalogReleaseRefDto.js +2 -2
  115. package/dist/generated/api/models/CatalogReleaseStatus.d.ts +2 -2
  116. package/dist/generated/api/models/CatalogReleaseStatus.js +2 -2
  117. package/dist/generated/api/models/CatalogRenderingDefaultsTooNewProblemDetail.d.ts +2 -2
  118. package/dist/generated/api/models/CatalogRenderingDefaultsTooNewProblemDetail.js +2 -2
  119. package/dist/generated/api/models/CatalogThemeReference.d.ts +2 -2
  120. package/dist/generated/api/models/CatalogThemeReference.js +2 -2
  121. package/dist/generated/api/models/CatalogVersionBehindProblemDetail.d.ts +2 -2
  122. package/dist/generated/api/models/CatalogVersionBehindProblemDetail.js +2 -2
  123. package/dist/generated/api/models/CodeListAuthType.d.ts +2 -2
  124. package/dist/generated/api/models/CodeListAuthType.js +2 -2
  125. package/dist/generated/api/models/CodeListBindingRef.d.ts +2 -2
  126. package/dist/generated/api/models/CodeListBindingRef.js +2 -2
  127. package/dist/generated/api/models/CodeListDto.d.ts +2 -2
  128. package/dist/generated/api/models/CodeListDto.js +2 -2
  129. package/dist/generated/api/models/CodeListEntriesResponse.d.ts +2 -2
  130. package/dist/generated/api/models/CodeListEntriesResponse.js +2 -2
  131. package/dist/generated/api/models/CodeListEntryDto.d.ts +2 -2
  132. package/dist/generated/api/models/CodeListEntryDto.js +2 -2
  133. package/dist/generated/api/models/CodeListListResponse.d.ts +2 -2
  134. package/dist/generated/api/models/CodeListListResponse.js +2 -2
  135. package/dist/generated/api/models/CodeListSourceType.d.ts +2 -2
  136. package/dist/generated/api/models/CodeListSourceType.js +2 -2
  137. package/dist/generated/api/models/CollectMeta.d.ts +2 -2
  138. package/dist/generated/api/models/CollectMeta.js +2 -2
  139. package/dist/generated/api/models/CollectRequest.d.ts +2 -2
  140. package/dist/generated/api/models/CollectRequest.js +2 -2
  141. package/dist/generated/api/models/ConsumerDto.d.ts +2 -2
  142. package/dist/generated/api/models/ConsumerDto.js +2 -2
  143. package/dist/generated/api/models/ConsumerListResponse.d.ts +2 -2
  144. package/dist/generated/api/models/ConsumerListResponse.js +2 -2
  145. package/dist/generated/api/models/ConsumerNodeDto.d.ts +2 -2
  146. package/dist/generated/api/models/ConsumerNodeDto.js +2 -2
  147. package/dist/generated/api/models/ConsumerPermissions.d.ts +8 -3
  148. package/dist/generated/api/models/ConsumerPermissions.d.ts.map +1 -1
  149. package/dist/generated/api/models/ConsumerPermissions.js +2 -2
  150. package/dist/generated/api/models/ConsumerPermissions.js.map +1 -1
  151. package/dist/generated/api/models/CreateAttributeRequest.d.ts +2 -2
  152. package/dist/generated/api/models/CreateAttributeRequest.js +2 -2
  153. package/dist/generated/api/models/CreateCatalogReleaseRequest.d.ts +2 -2
  154. package/dist/generated/api/models/CreateCatalogReleaseRequest.js +2 -2
  155. package/dist/generated/api/models/CreateCodeListRequest.d.ts +2 -2
  156. package/dist/generated/api/models/CreateCodeListRequest.js +2 -2
  157. package/dist/generated/api/models/CreateEnvironmentRequest.d.ts +2 -2
  158. package/dist/generated/api/models/CreateEnvironmentRequest.js +2 -2
  159. package/dist/generated/api/models/CreateQualityProfileRequest.d.ts +2 -2
  160. package/dist/generated/api/models/CreateQualityProfileRequest.js +2 -2
  161. package/dist/generated/api/models/CreateStencilRequest.d.ts +2 -2
  162. package/dist/generated/api/models/CreateStencilRequest.js +2 -2
  163. package/dist/generated/api/models/CreateTemplateRequest.d.ts +2 -2
  164. package/dist/generated/api/models/CreateTemplateRequest.js +2 -2
  165. package/dist/generated/api/models/CreateTenantRequest.d.ts +2 -2
  166. package/dist/generated/api/models/CreateTenantRequest.js +2 -2
  167. package/dist/generated/api/models/CreateThemeRequest.d.ts +2 -2
  168. package/dist/generated/api/models/CreateThemeRequest.js +2 -2
  169. package/dist/generated/api/models/CreateVariantRequest.d.ts +2 -2
  170. package/dist/generated/api/models/CreateVariantRequest.js +2 -2
  171. package/dist/generated/api/models/DataExampleDto.d.ts +2 -2
  172. package/dist/generated/api/models/DataExampleDto.js +2 -2
  173. package/dist/generated/api/models/DataModelValidationError.d.ts +2 -2
  174. package/dist/generated/api/models/DataModelValidationError.js +2 -2
  175. package/dist/generated/api/models/DataModelValidationProblemDetail.d.ts +2 -2
  176. package/dist/generated/api/models/DataModelValidationProblemDetail.js +2 -2
  177. package/dist/generated/api/models/DeploymentDto.d.ts +2 -2
  178. package/dist/generated/api/models/DeploymentDto.js +2 -2
  179. package/dist/generated/api/models/DeploymentEventDto.d.ts +2 -2
  180. package/dist/generated/api/models/DeploymentEventDto.js +2 -2
  181. package/dist/generated/api/models/DeploymentHistoryResponse.d.ts +2 -2
  182. package/dist/generated/api/models/DeploymentHistoryResponse.js +2 -2
  183. package/dist/generated/api/models/DeploymentListResponse.d.ts +2 -2
  184. package/dist/generated/api/models/DeploymentListResponse.js +2 -2
  185. package/dist/generated/api/models/DocumentDto.d.ts +2 -2
  186. package/dist/generated/api/models/DocumentDto.js +2 -2
  187. package/dist/generated/api/models/DocumentGenerationItemDto.d.ts +2 -2
  188. package/dist/generated/api/models/DocumentGenerationItemDto.js +2 -2
  189. package/dist/generated/api/models/DocumentGenerationJobDto.d.ts +2 -2
  190. package/dist/generated/api/models/DocumentGenerationJobDto.js +2 -2
  191. package/dist/generated/api/models/DocumentListResponse.d.ts +2 -2
  192. package/dist/generated/api/models/DocumentListResponse.js +2 -2
  193. package/dist/generated/api/models/EnvironmentDto.d.ts +2 -2
  194. package/dist/generated/api/models/EnvironmentDto.js +2 -2
  195. package/dist/generated/api/models/EnvironmentListResponse.d.ts +2 -2
  196. package/dist/generated/api/models/EnvironmentListResponse.js +2 -2
  197. package/dist/generated/api/models/FontDto.d.ts +2 -2
  198. package/dist/generated/api/models/FontDto.js +2 -2
  199. package/dist/generated/api/models/FontListResponse.d.ts +2 -2
  200. package/dist/generated/api/models/FontListResponse.js +2 -2
  201. package/dist/generated/api/models/FontVariantDto.d.ts +2 -2
  202. package/dist/generated/api/models/FontVariantDto.js +2 -2
  203. package/dist/generated/api/models/ForbiddenProblemDetail.d.ts +2 -2
  204. package/dist/generated/api/models/ForbiddenProblemDetail.js +2 -2
  205. package/dist/generated/api/models/GenerateBatchRequest.d.ts +2 -2
  206. package/dist/generated/api/models/GenerateBatchRequest.js +2 -2
  207. package/dist/generated/api/models/GenerateDocumentRequest.d.ts +2 -2
  208. package/dist/generated/api/models/GenerateDocumentRequest.js +2 -2
  209. package/dist/generated/api/models/GenerationItemStatus.d.ts +2 -2
  210. package/dist/generated/api/models/GenerationItemStatus.js +2 -2
  211. package/dist/generated/api/models/GenerationJobItemListResponse.d.ts +2 -2
  212. package/dist/generated/api/models/GenerationJobItemListResponse.js +2 -2
  213. package/dist/generated/api/models/GenerationJobListResponse.d.ts +2 -2
  214. package/dist/generated/api/models/GenerationJobListResponse.js +2 -2
  215. package/dist/generated/api/models/GenerationJobResponse.d.ts +2 -2
  216. package/dist/generated/api/models/GenerationJobResponse.js +2 -2
  217. package/dist/generated/api/models/GenerationJobStatus.d.ts +2 -2
  218. package/dist/generated/api/models/GenerationJobStatus.js +2 -2
  219. package/dist/generated/api/models/GenerationJobType.d.ts +2 -2
  220. package/dist/generated/api/models/GenerationJobType.js +2 -2
  221. package/dist/generated/api/models/GenerationResult.d.ts +2 -2
  222. package/dist/generated/api/models/GenerationResult.js +2 -2
  223. package/dist/generated/api/models/ImageDto.d.ts +2 -2
  224. package/dist/generated/api/models/ImageDto.js +2 -2
  225. package/dist/generated/api/models/ImageListResponse.d.ts +2 -2
  226. package/dist/generated/api/models/ImageListResponse.js +2 -2
  227. package/dist/generated/api/models/ImportCatalogResponse.d.ts +2 -2
  228. package/dist/generated/api/models/ImportCatalogResponse.js +2 -2
  229. package/dist/generated/api/models/InstallCatalogReleaseResponse.d.ts +2 -2
  230. package/dist/generated/api/models/InstallCatalogReleaseResponse.js +2 -2
  231. package/dist/generated/api/models/InvalidDataField.d.ts +2 -2
  232. package/dist/generated/api/models/InvalidDataField.js +2 -2
  233. package/dist/generated/api/models/Margins.d.ts +2 -2
  234. package/dist/generated/api/models/Margins.js +2 -2
  235. package/dist/generated/api/models/MarkStencilReadyResponse.d.ts +2 -2
  236. package/dist/generated/api/models/MarkStencilReadyResponse.js +2 -2
  237. package/dist/generated/api/models/MergeBaseMissingProblemDetail.d.ts +2 -2
  238. package/dist/generated/api/models/MergeBaseMissingProblemDetail.js +2 -2
  239. package/dist/generated/api/models/MergeConflictsUnresolvedProblemDetail.d.ts +2 -2
  240. package/dist/generated/api/models/MergeConflictsUnresolvedProblemDetail.js +2 -2
  241. package/dist/generated/api/models/MergeIntoCatalogDraftRequest.d.ts +2 -2
  242. package/dist/generated/api/models/MergeIntoCatalogDraftRequest.js +2 -2
  243. package/dist/generated/api/models/MergeIntoCatalogDraftResponse.d.ts +2 -2
  244. package/dist/generated/api/models/MergeIntoCatalogDraftResponse.js +2 -2
  245. package/dist/generated/api/models/MissingDataField.d.ts +2 -2
  246. package/dist/generated/api/models/MissingDataField.js +2 -2
  247. package/dist/generated/api/models/MissingReleaseDependency.d.ts +2 -2
  248. package/dist/generated/api/models/MissingReleaseDependency.js +2 -2
  249. package/dist/generated/api/models/MissingReleaseDependencyReason.d.ts +2 -2
  250. package/dist/generated/api/models/MissingReleaseDependencyReason.js +2 -2
  251. package/dist/generated/api/models/Node.d.ts +2 -2
  252. package/dist/generated/api/models/Node.js +2 -2
  253. package/dist/generated/api/models/Orientation.d.ts +2 -2
  254. package/dist/generated/api/models/Orientation.js +2 -2
  255. package/dist/generated/api/models/PageFormat.d.ts +2 -2
  256. package/dist/generated/api/models/PageFormat.js +2 -2
  257. package/dist/generated/api/models/PageMeta.d.ts +2 -2
  258. package/dist/generated/api/models/PageMeta.js +2 -2
  259. package/dist/generated/api/models/PageSettings.d.ts +2 -2
  260. package/dist/generated/api/models/PageSettings.js +2 -2
  261. package/dist/generated/api/models/PartitionAssignment.d.ts +7 -3
  262. package/dist/generated/api/models/PartitionAssignment.d.ts.map +1 -1
  263. package/dist/generated/api/models/PartitionAssignment.js +2 -2
  264. package/dist/generated/api/models/PartitionAssignment.js.map +1 -1
  265. package/dist/generated/api/models/PingRequest.d.ts +2 -2
  266. package/dist/generated/api/models/PingRequest.js +2 -2
  267. package/dist/generated/api/models/PongDetailsDto.d.ts +2 -2
  268. package/dist/generated/api/models/PongDetailsDto.js +2 -2
  269. package/dist/generated/api/models/PongResponse.d.ts +2 -2
  270. package/dist/generated/api/models/PongResponse.js +2 -2
  271. package/dist/generated/api/models/PreviewDocumentRequest.d.ts +9 -7
  272. package/dist/generated/api/models/PreviewDocumentRequest.d.ts.map +1 -1
  273. package/dist/generated/api/models/PreviewDocumentRequest.js +4 -4
  274. package/dist/generated/api/models/PreviewDocumentRequest.js.map +1 -1
  275. package/dist/generated/api/models/ProblemDetail.d.ts +2 -2
  276. package/dist/generated/api/models/ProblemDetail.js +2 -2
  277. package/dist/generated/api/models/PublishReleaseToRegistryRequest.d.ts +2 -2
  278. package/dist/generated/api/models/PublishReleaseToRegistryRequest.js +2 -2
  279. package/dist/generated/api/models/QualityBinding.d.ts +2 -2
  280. package/dist/generated/api/models/QualityBinding.js +2 -2
  281. package/dist/generated/api/models/QualityProfileDto.d.ts +2 -2
  282. package/dist/generated/api/models/QualityProfileDto.js +2 -2
  283. package/dist/generated/api/models/QualityProfileListResponse.d.ts +2 -2
  284. package/dist/generated/api/models/QualityProfileListResponse.js +2 -2
  285. package/dist/generated/api/models/QualityProfileRef.d.ts +2 -2
  286. package/dist/generated/api/models/QualityProfileRef.js +2 -2
  287. package/dist/generated/api/models/QualityRule.d.ts +2 -2
  288. package/dist/generated/api/models/QualityRule.js +2 -2
  289. package/dist/generated/api/models/QualityRuleExamples.d.ts +2 -2
  290. package/dist/generated/api/models/QualityRuleExamples.js +2 -2
  291. package/dist/generated/api/models/QualityRuleOverride.d.ts +2 -2
  292. package/dist/generated/api/models/QualityRuleOverride.js +2 -2
  293. package/dist/generated/api/models/QualityRuleScope.d.ts +2 -2
  294. package/dist/generated/api/models/QualityRuleScope.js +2 -2
  295. package/dist/generated/api/models/QualitySeverity.d.ts +2 -2
  296. package/dist/generated/api/models/QualitySeverity.js +2 -2
  297. package/dist/generated/api/models/RegisterConsumerRequest.d.ts +2 -2
  298. package/dist/generated/api/models/RegisterConsumerRequest.js +2 -2
  299. package/dist/generated/api/models/RegistryReleaseDto.d.ts +2 -2
  300. package/dist/generated/api/models/RegistryReleaseDto.js +2 -2
  301. package/dist/generated/api/models/RegistryReleaseListResponse.d.ts +2 -2
  302. package/dist/generated/api/models/RegistryReleaseListResponse.js +2 -2
  303. package/dist/generated/api/models/RejectConsumerRequest.d.ts +2 -2
  304. package/dist/generated/api/models/RejectConsumerRequest.js +2 -2
  305. package/dist/generated/api/models/ReleaseCatalogDraftRequest.d.ts +2 -2
  306. package/dist/generated/api/models/ReleaseCatalogDraftRequest.js +2 -2
  307. package/dist/generated/api/models/ReleaseCatalogDraftResponse.d.ts +7 -6
  308. package/dist/generated/api/models/ReleaseCatalogDraftResponse.d.ts.map +1 -1
  309. package/dist/generated/api/models/ReleaseCatalogDraftResponse.js +5 -4
  310. package/dist/generated/api/models/ReleaseCatalogDraftResponse.js.map +1 -1
  311. package/dist/generated/api/models/ReleaseDependenciesMissingProblemDetail.d.ts +2 -2
  312. package/dist/generated/api/models/ReleaseDependenciesMissingProblemDetail.js +2 -2
  313. package/dist/generated/api/models/ReleaseDependenciesUnreleasedProblemDetail.d.ts +2 -2
  314. package/dist/generated/api/models/ReleaseDependenciesUnreleasedProblemDetail.js +2 -2
  315. package/dist/generated/api/models/ReleaseDependencyDto.d.ts +2 -2
  316. package/dist/generated/api/models/ReleaseDependencyDto.js +2 -2
  317. package/dist/generated/api/models/ReleaseInUseProblemDetail.d.ts +2 -2
  318. package/dist/generated/api/models/ReleaseInUseProblemDetail.js +2 -2
  319. package/dist/generated/api/models/ReleasePublicationDto.d.ts +2 -2
  320. package/dist/generated/api/models/ReleasePublicationDto.js +2 -2
  321. package/dist/generated/api/models/ReleasePublicationStatus.d.ts +2 -2
  322. package/dist/generated/api/models/ReleasePublicationStatus.js +2 -2
  323. package/dist/generated/api/models/ReleaseRegistryDto.d.ts +2 -2
  324. package/dist/generated/api/models/ReleaseRegistryDto.js +2 -2
  325. package/dist/generated/api/models/ReleaseRegistryKind.d.ts +2 -2
  326. package/dist/generated/api/models/ReleaseRegistryKind.js +2 -2
  327. package/dist/generated/api/models/ReleaseRegistryListResponse.d.ts +2 -2
  328. package/dist/generated/api/models/ReleaseRegistryListResponse.js +2 -2
  329. package/dist/generated/api/models/ReleasedChangeDto.d.ts +2 -2
  330. package/dist/generated/api/models/ReleasedChangeDto.js +2 -2
  331. package/dist/generated/api/models/ReleasedDependencyDto.d.ts +2 -2
  332. package/dist/generated/api/models/ReleasedDependencyDto.js +2 -2
  333. package/dist/generated/api/models/ResourceChangeDto.d.ts +2 -2
  334. package/dist/generated/api/models/ResourceChangeDto.js +2 -2
  335. package/dist/generated/api/models/ResourceStatus.d.ts +2 -2
  336. package/dist/generated/api/models/ResourceStatus.js +2 -2
  337. package/dist/generated/api/models/RotatePublicKeyRequest.d.ts +2 -2
  338. package/dist/generated/api/models/RotatePublicKeyRequest.js +2 -2
  339. package/dist/generated/api/models/SearchHit.d.ts +2 -2
  340. package/dist/generated/api/models/SearchHit.js +2 -2
  341. package/dist/generated/api/models/SearchHitCatalog.d.ts +2 -2
  342. package/dist/generated/api/models/SearchHitCatalog.js +2 -2
  343. package/dist/generated/api/models/SearchHitVariant.d.ts +2 -2
  344. package/dist/generated/api/models/SearchHitVariant.js +2 -2
  345. package/dist/generated/api/models/SearchKindCount.d.ts +2 -2
  346. package/dist/generated/api/models/SearchKindCount.js +2 -2
  347. package/dist/generated/api/models/SearchResults.d.ts +2 -2
  348. package/dist/generated/api/models/SearchResults.js +2 -2
  349. package/dist/generated/api/models/Slot.d.ts +2 -2
  350. package/dist/generated/api/models/Slot.js +2 -2
  351. package/dist/generated/api/models/StencilContentDto.d.ts +2 -2
  352. package/dist/generated/api/models/StencilContentDto.js +2 -2
  353. package/dist/generated/api/models/StencilDto.d.ts +2 -2
  354. package/dist/generated/api/models/StencilDto.js +2 -2
  355. package/dist/generated/api/models/StencilListResponse.d.ts +2 -2
  356. package/dist/generated/api/models/StencilListResponse.js +2 -2
  357. package/dist/generated/api/models/StencilSummaryDto.d.ts +2 -2
  358. package/dist/generated/api/models/StencilSummaryDto.js +2 -2
  359. package/dist/generated/api/models/StencilUsageDto.d.ts +2 -2
  360. package/dist/generated/api/models/StencilUsageDto.js +2 -2
  361. package/dist/generated/api/models/StencilUsageListResponse.d.ts +2 -2
  362. package/dist/generated/api/models/StencilUsageListResponse.js +2 -2
  363. package/dist/generated/api/models/TemplateDataValidationError.d.ts +2 -2
  364. package/dist/generated/api/models/TemplateDataValidationError.js +2 -2
  365. package/dist/generated/api/models/TemplateDataValidationProblemDetail.d.ts +2 -2
  366. package/dist/generated/api/models/TemplateDataValidationProblemDetail.js +2 -2
  367. package/dist/generated/api/models/TemplateDataValidationResult.d.ts +2 -2
  368. package/dist/generated/api/models/TemplateDataValidationResult.js +2 -2
  369. package/dist/generated/api/models/TemplateDocument.d.ts +2 -2
  370. package/dist/generated/api/models/TemplateDocument.js +2 -2
  371. package/dist/generated/api/models/TemplateDto.d.ts +2 -2
  372. package/dist/generated/api/models/TemplateDto.js +2 -2
  373. package/dist/generated/api/models/TemplateListResponse.d.ts +2 -2
  374. package/dist/generated/api/models/TemplateListResponse.js +2 -2
  375. package/dist/generated/api/models/TemplateSummaryDto.d.ts +2 -2
  376. package/dist/generated/api/models/TemplateSummaryDto.js +2 -2
  377. package/dist/generated/api/models/TenantDto.d.ts +2 -2
  378. package/dist/generated/api/models/TenantDto.js +2 -2
  379. package/dist/generated/api/models/TenantListResponse.d.ts +2 -2
  380. package/dist/generated/api/models/TenantListResponse.js +2 -2
  381. package/dist/generated/api/models/ThemeDto.d.ts +2 -2
  382. package/dist/generated/api/models/ThemeDto.js +2 -2
  383. package/dist/generated/api/models/ThemeListResponse.d.ts +2 -2
  384. package/dist/generated/api/models/ThemeListResponse.js +2 -2
  385. package/dist/generated/api/models/ThemeRef.d.ts +2 -2
  386. package/dist/generated/api/models/ThemeRef.js +2 -2
  387. package/dist/generated/api/models/UnreleasedCatalogDependency.d.ts +2 -2
  388. package/dist/generated/api/models/UnreleasedCatalogDependency.js +2 -2
  389. package/dist/generated/api/models/UpdateAttributeRequest.d.ts +2 -2
  390. package/dist/generated/api/models/UpdateAttributeRequest.js +2 -2
  391. package/dist/generated/api/models/UpdateCatalogDependenciesRequest.d.ts +2 -2
  392. package/dist/generated/api/models/UpdateCatalogDependenciesRequest.js +2 -2
  393. package/dist/generated/api/models/UpdateCatalogReleaseRequest.d.ts +2 -2
  394. package/dist/generated/api/models/UpdateCatalogReleaseRequest.js +2 -2
  395. package/dist/generated/api/models/UpdateCodeListEntryHiddenRequest.d.ts +2 -2
  396. package/dist/generated/api/models/UpdateCodeListEntryHiddenRequest.js +2 -2
  397. package/dist/generated/api/models/UpdateCodeListRequest.d.ts +2 -2
  398. package/dist/generated/api/models/UpdateCodeListRequest.js +2 -2
  399. package/dist/generated/api/models/UpdateConsumerRequest.d.ts +4 -2
  400. package/dist/generated/api/models/UpdateConsumerRequest.d.ts.map +1 -1
  401. package/dist/generated/api/models/UpdateConsumerRequest.js +2 -2
  402. package/dist/generated/api/models/UpdateConsumerRequest.js.map +1 -1
  403. package/dist/generated/api/models/UpdateEnvironmentRequest.d.ts +2 -2
  404. package/dist/generated/api/models/UpdateEnvironmentRequest.js +2 -2
  405. package/dist/generated/api/models/UpdateQualityProfileRequest.d.ts +2 -2
  406. package/dist/generated/api/models/UpdateQualityProfileRequest.js +2 -2
  407. package/dist/generated/api/models/UpdateStencilContentRequest.d.ts +2 -2
  408. package/dist/generated/api/models/UpdateStencilContentRequest.js +2 -2
  409. package/dist/generated/api/models/UpdateStencilRequest.d.ts +2 -2
  410. package/dist/generated/api/models/UpdateStencilRequest.js +2 -2
  411. package/dist/generated/api/models/UpdateTemplateRequest.d.ts +2 -2
  412. package/dist/generated/api/models/UpdateTemplateRequest.js +2 -2
  413. package/dist/generated/api/models/UpdateTenantRequest.d.ts +2 -2
  414. package/dist/generated/api/models/UpdateTenantRequest.js +2 -2
  415. package/dist/generated/api/models/UpdateThemeRequest.d.ts +2 -2
  416. package/dist/generated/api/models/UpdateThemeRequest.js +2 -2
  417. package/dist/generated/api/models/UpdateVariantContentRequest.d.ts +2 -2
  418. package/dist/generated/api/models/UpdateVariantContentRequest.js +2 -2
  419. package/dist/generated/api/models/UpdateVariantRequest.d.ts +2 -2
  420. package/dist/generated/api/models/UpdateVariantRequest.js +2 -2
  421. package/dist/generated/api/models/ValidateTemplateDataRequest.d.ts +2 -2
  422. package/dist/generated/api/models/ValidateTemplateDataRequest.js +2 -2
  423. package/dist/generated/api/models/ValidationError.d.ts +2 -2
  424. package/dist/generated/api/models/ValidationError.js +2 -2
  425. package/dist/generated/api/models/ValidationProblemDetail.d.ts +2 -2
  426. package/dist/generated/api/models/ValidationProblemDetail.js +2 -2
  427. package/dist/generated/api/models/VariantContentDto.d.ts +2 -2
  428. package/dist/generated/api/models/VariantContentDto.js +2 -2
  429. package/dist/generated/api/models/VariantDto.d.ts +2 -2
  430. package/dist/generated/api/models/VariantDto.js +2 -2
  431. package/dist/generated/api/models/VariantListResponse.d.ts +2 -2
  432. package/dist/generated/api/models/VariantListResponse.js +2 -2
  433. package/dist/generated/api/models/VariantSelectionAttribute.d.ts +2 -2
  434. package/dist/generated/api/models/VariantSelectionAttribute.js +2 -2
  435. package/dist/generated/api/models/VariantSummaryDto.d.ts +2 -2
  436. package/dist/generated/api/models/VariantSummaryDto.js +2 -2
  437. package/dist/generated/api/models/index.d.ts +2 -0
  438. package/dist/generated/api/models/index.d.ts.map +1 -1
  439. package/dist/generated/api/models/index.js +2 -0
  440. package/dist/generated/api/models/index.js.map +1 -1
  441. package/dist/generated/api/runtime.d.ts +2 -2
  442. package/dist/generated/api/runtime.js +2 -2
  443. package/dist/generated/contractOperations.js +1 -1
  444. package/dist/generated/contractOperations.js.map +1 -1
  445. package/dist/generated/contractVersion.d.ts +1 -1
  446. package/dist/generated/contractVersion.d.ts.map +1 -1
  447. package/dist/generated/contractVersion.js +1 -1
  448. package/dist/generated/contractVersion.js.map +1 -1
  449. package/dist/generated/knownProblemSlugs.d.ts +7 -1
  450. package/dist/generated/knownProblemSlugs.d.ts.map +1 -1
  451. package/dist/generated/knownProblemSlugs.js +7 -1
  452. package/dist/generated/knownProblemSlugs.js.map +1 -1
  453. package/dist/generated/knownValidationCodes.d.ts +3 -3
  454. package/dist/generated/knownValidationCodes.d.ts.map +1 -1
  455. package/dist/generated/knownValidationCodes.js +3 -3
  456. package/dist/generated/knownValidationCodes.js.map +1 -1
  457. package/dist/generated/modelValidation.d.ts +4 -2
  458. package/dist/generated/modelValidation.d.ts.map +1 -1
  459. package/dist/generated/modelValidation.js +13 -1
  460. package/dist/generated/modelValidation.js.map +1 -1
  461. package/dist/http/operations.d.ts +4 -2
  462. package/dist/http/operations.d.ts.map +1 -1
  463. package/dist/http/operations.js +23 -5
  464. package/dist/http/operations.js.map +1 -1
  465. package/dist/index.d.ts +1 -1
  466. package/dist/index.d.ts.map +1 -1
  467. package/dist/index.js.map +1 -1
  468. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -9,8 +9,21 @@ records contract changes; this file records changes to the hand-written library
9
9
 
10
10
  ## [Unreleased]
11
11
 
12
+ ### Fixed
13
+
14
+ - `ResultCollector.partitionFor`, `isMyPartition` and `routingKeyToMe` answer as before the
15
+ assignment is known when it names a `hash` other than `murmur3`, instead of routing with murmur3
16
+ regardless and sending results to other nodes.
17
+
12
18
  ### Added
13
19
 
20
+ - `ProblemDetailException.dependents`, `heldResources` and `isCatalogDraftInUseProblem` surface a
21
+ `catalog-draft-in-use` problem (409 from `deleteCatalogRelease`, which refuses to discard a draft
22
+ something outside it relies on): the drafts of other catalogs whose dependency declarations name
23
+ it, each a `CatalogDraftRef` (the generated `CatalogDraftRefDto`; an entry missing a member is
24
+ dropped), and the resources only it holds that something outside it still uses, as
25
+ `resourceType/resourceKey`. `environments`, `pinnedBy` and `isReleaseInUseProblem` stay, for
26
+ `release-in-use`, which no operation answers yet.
14
27
  - `KnownValidationCodes` (and the `KnownValidationCode` type), generated from the contract's
15
28
  `x-validation-codes` registry: one constant per code that says why a field of a
16
29
  `validation-error` failed. Compare a field error's `code` (`undefined` when the server sent none)
@@ -57,31 +70,33 @@ records contract changes; this file records changes to the hand-written library
57
70
 
58
71
  ### Changed
59
72
 
60
- - **BREAKING:** a resource's address is its `key` (#84). The hand-written API follows the
61
- generated one: `TemplateDataValidator.validate`, `TemplateSchemaValidator.validate`,
62
- `ServerTemplateDataValidator.validate` and `SchemaCache.getOrLoad` / `evict` take
63
- `(tenantKey, registry, namespace, catalogKey, templateKey, …)`; `ServerValidationTarget` takes
64
- `variantKey` and `environmentKey` in place of `variantId` and `environmentId`; and
65
- `ResultCollector.builder().tenantId(…)` is now `.tenantKey(…)`. The generated request parameters
66
- and models carry the same renames (`tenantKey`, `templateKey`, …, and `key` in place of `slug` and
67
- of a create request's `id`).
68
- - **BREAKING:** a catalog is addressed by registry, namespace and key. `TemplateDataValidator.validate`,
69
- `TemplateSchemaValidator.validate` and `ServerTemplateDataValidator.validate` take
70
- `(tenantId, registry, namespace, catalogKey, templateId, data)` in place of
71
- `(tenantId, catalogId, templateId, data)`, the registry in its path-segment form (`~` for the
72
- server's default registry, or named in full, such as `acme.com`) and the namespace a plain slug.
73
- `SchemaCache.getOrLoad` / `evict` are keyed the same way. `ValidatingGenerationApi` hands a
74
- pre-flighting validator the request's `registry`, or `~` when the request leaves it out or null.
75
- - **BREAKING:** `ServerValidationTarget` takes a `versionRange` (a version range such as `1.4.0` or
76
- `^1.4.0`, sent as the request's `versionRange`) in place of `versionId`, matching contract 2.0's
77
- generation by release. It may be combined with `environmentKey`; without either, the catalog's
78
- latest release is checked.
73
+ - `findOperation` breaks a tie between two path templates with as many literal segments by the
74
+ first segment where they differ, a literal winning over a parameter, rather than by comparing the
75
+ templates as strings. `GET /documents/jobs/content` matched both `getGenerationJobStatus` and the
76
+ moved `downloadDocument` (`/documents/{documentId}/content`), and resolved to the latter, so the
77
+ request asked for a PDF. Neither id can be `jobs` or `content` in practice, both being UUIDs.
78
+ - **BREAKING:** contract 2.0 addresses a resource by its `key` (#84), a catalog by registry,
79
+ namespace and key, and renders a release rather than a template version. Against 1.4, the
80
+ hand-written API changes as follows:
81
+ - `TemplateDataValidator.validate`, `TemplateSchemaValidator.validate` and
82
+ `ServerTemplateDataValidator.validate` take `(tenantKey, registry, namespace, catalogKey,
83
+ templateKey, data)` in place of `(tenantId, catalogId, templateId, data)`, the registry in its
84
+ path-segment form (`~` for the server's default registry, or named in full, such as
85
+ `acme.com`). `SchemaCache.getOrLoad` / `evict` are keyed the same way. `ValidatingGenerationApi`
86
+ hands a pre-flighting validator the request's `registry`, or `~` when the request leaves it out
87
+ or null.
88
+ - `ServerValidationTarget` takes `variantKey` and `environmentKey` in place of `variantId` and
89
+ `environmentId`, and a `versionRange` (`1.4.0`, `^1.4.0`, sent as the request's
90
+ `versionRange`) in place of `versionId`. Without a range or an environment, the catalog's
91
+ highest release is checked.
92
+ - `ResultCollector.builder().tenantId(…)` is now `.tenantKey(…)`.
93
+ - The generated request parameters and models carry the same renames (`tenantKey`,
94
+ `templateKey`, …, and `key` in place of `slug` and of a create request's `id`).
79
95
  - Results handed to a `ResultCollector` handler carry the template's catalog as `registry`,
80
96
  `namespace` and `catalogKey`, always set, next to `version`, which is null for a result
81
97
  rendered from a draft.
82
98
  - The README no longer mentions the `X-API-Key` header: the contract dropped it, and the client
83
99
  only ever sent `Authorization: ApiKey <key>`.
84
-
85
100
  - **Template data is validated by the server, not by a bundled schema compiler.**
86
101
  `TemplateSchemaValidator` and `ValidatingGenerationApi` now call `validateTemplateData` through a
87
102
  pluggable `TemplateDataValidator`, whose only shipped implementation is
package/README.md CHANGED
@@ -123,6 +123,12 @@ member it does not know is ignored, and an enum value it does not know is kept a
123
123
  received, though the generated type does not list it. Keep a `default` branch when switching on an
124
124
  enum.
125
125
 
126
+ What a client ignores it cannot send back. A request built from a response carries only the members
127
+ this client knows. That matters where a write replaces what was read: a template document read with
128
+ `getVariantContent` and written back with `updateVariantContent` loses every member a newer catalog wire version added.
129
+ Edit template documents with a client at least as new as the server, and change a consumer's
130
+ permissions by sending only the resources you change, never the object you read.
131
+
126
132
  ## Error handling
127
133
 
128
134
  Catch `ProblemDetailException` and switch on `typeSlug` against `KnownProblemSlugs`. The slug list is
@@ -140,8 +146,6 @@ try {
140
146
  case KnownProblemSlugs.NOT_FOUND:
141
147
  log.warn(`tenant not found: ${e.detail}`)
142
148
  break
143
- case KnownProblemSlugs.FORBIDDEN:
144
- throw new PermissionError(e.detail)
145
149
  case KnownProblemSlugs.VALIDATION_ERROR:
146
150
  for (const err of e.errors) log.warn(`${err.field}: ${err.message}`) // field-level ValidationProblemDetail
147
151
  break
@@ -177,9 +181,10 @@ try {
177
181
  case KnownProblemSlugs.CATALOG_VERSION_BEHIND:
178
182
  log.warn(`the draft is behind ${e.behind.join(', ')}`) // releaseCatalogDraft: name them in acknowledgedBehind
179
183
  break
180
- case KnownProblemSlugs.RELEASE_IN_USE:
181
- // deleteCatalogRelease: undeploy it, and release the catalogs that pin it without it
182
- log.warn(`deployed to ${e.environments.join(', ')}; pinned by ${e.pinnedBy.map((r) => `${r.catalogKey}@${r.version}`).join(', ')}`)
184
+ case KnownProblemSlugs.CATALOG_DRAFT_IN_USE:
185
+ // deleteCatalogRelease: drafts of other catalogs name the draft, or it alone holds resources
186
+ // something outside it uses (resourceType/resourceKey); change those first
187
+ log.warn(`named by ${e.dependents.map((d) => `${d.catalogKey}: ${d.releaseName}`).join(', ')}; holds ${e.heldResources.join(', ')}`)
183
188
  break
184
189
  case KnownProblemSlugs.AMBIGUOUS_VARIANT:
185
190
  log.warn(`several variants match: ${e.tiedVariants.join(', ')}`) // generateDocument, previewDocument: name one by variantKey
@@ -227,7 +232,8 @@ ResponseError` sites keep working. It exposes `type`, `typeSlug`, `title`, `prob
227
232
  `missingDependencies`, `unreleasedDependencies`, `readOnlyReason`, `unresolvedConflicts`,
228
233
  `isMergeConflictsUnresolvedProblem`, `missingBaseVersion`, `missingBaseFingerprint`,
229
234
  `isMergeBaseMissingProblem`, `behind`, `isCatalogVersionBehindProblem`, `environments`,
230
- `pinnedBy`, `isReleaseInUseProblem`, `tiedVariants`, `isAmbiguousVariantProblem`,
235
+ `pinnedBy`, `isReleaseInUseProblem`, `dependents`, `heldResources`, `isCatalogDraftInUseProblem`,
236
+ `tiedVariants`, `isAmbiguousVariantProblem`,
231
237
  `requiredPermission`, `refusedTenantKey`, `requiredPlatformRole`, `refusalReason`,
232
238
  `isForbiddenProblem`, `extensions` (every member
233
239
  outside the base members, RFC 9457's five and `help`), `statusCode`, `rawBody`, `isValidationProblem`,
@@ -240,6 +246,12 @@ releases. `unreleasedDependencies` lists each such draft (`registry`, `namespace
240
246
  `releaseId`, `releaseName`); release them first, or send `releaseDependencies: true` to release them
241
247
  along with the draft.
242
248
 
249
+ A `catalog-draft-in-use` problem (409) means `deleteCatalogRelease` was refused because something
250
+ outside the draft still relies on it. `dependents` lists the drafts of other catalogs whose
251
+ dependency declarations name it (`registry`, `namespace`, `catalogKey`, `releaseId`, `releaseName`),
252
+ and `heldResources` the resources only it holds that something outside it still uses, as
253
+ `resourceType/resourceKey` (`theme/house-style`); change those first.
254
+
243
255
  A `release-dependencies-missing` problem (409) means `deployCatalogRelease` was refused because releases
244
256
  of other catalogs the release pins cannot be had: the tenant does not have them and they could not
245
257
  be fetched or verified. `missingDependencies` lists each, with a `reason` kept as the string the
@@ -303,9 +315,6 @@ validateCreateTenantRequest({ key: 'Acme Corp', name: 'Acme' }) // throws Model
303
315
  Each failure carries a **JSON Pointer** into the data (`/customer/email`), the JSON Schema `keyword`
304
316
  that failed, and a human-readable `message` — so a form can mark the field that is wrong.
305
317
 
306
- `validateTemplateData` arrived with contract **1.4.0**; against an older server the call fails like
307
- any other unknown operation rather than reporting unvalidated data as acceptable.
308
-
309
318
  ### Validating in-process instead
310
319
 
311
320
  To avoid a request per check — pre-flighting a large batch, say — implement `TemplateDataValidator`
@@ -1 +1 @@
1
- {"version":3,"file":"resultCollector.d.ts","sourceRoot":"","sources":["../../src/collect/resultCollector.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"resultCollector.d.ts","sourceRoot":"","sources":["../../src/collect/resultCollector.ts"],"names":[],"mappings":"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"}
@@ -234,7 +234,9 @@ export class ResultCollector {
234
234
  return;
235
235
  }
236
236
  this.assignment = current;
237
- this.routing = PartitionRouting.of(current.total, current.mine);
237
+ // A hash this client does not implement gets no routing: the wrong algorithm would send results
238
+ // to other nodes, while no routing only loses node affinity.
239
+ this.routing = current.hash === 'murmur3' ? PartitionRouting.of(current.total, current.mine) : undefined;
238
240
  this.settings.metricsListener?.onPartitionChange?.(previous, current);
239
241
  }
240
242
  sleep(durationMs) {
@@ -1 +1 @@
1
- {"version":3,"file":"resultCollector.js","sourceRoot":"","sources":["../../src/collect/resultCollector.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"resultCollector.js","sourceRoot":"","sources":["../../src/collect/resultCollector.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import type { CatalogReadOnlyReason, CatalogReleaseRefDto, DataModelValidationError, InvalidDataField, MissingDataField, MissingReleaseDependency, MissingReleaseDependencyReason, ProblemDetail, UnreleasedCatalogDependency, ValidationError } from '../generated/api/models/index.js';
1
+ import type { CatalogDraftRefDto, CatalogReadOnlyReason, CatalogReleaseRefDto, DataModelValidationError, InvalidDataField, MissingDataField, MissingReleaseDependency, MissingReleaseDependencyReason, ProblemDetail, UnreleasedCatalogDependency, ValidationError } from '../generated/api/models/index.js';
2
2
  import { ResponseError } from '../generated/api/runtime.js';
3
3
  /**
4
4
  * A {@link ResponseError} carrying a parsed [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457)
@@ -170,8 +170,9 @@ export declare class ProblemDetailException extends ResponseError {
170
170
  /** True when this problem said the draft is behind releases the request did not acknowledge. */
171
171
  get isCatalogVersionBehindProblem(): boolean;
172
172
  /**
173
- * The environments a `release-in-use` problem (409, from `deleteCatalogRelease`) says deploy the
174
- * release; empty for any other problem, and when none does.
173
+ * The environments a `release-in-use` problem (409) says deploy the release; empty for any other
174
+ * problem, and when none does. No operation deletes a released release yet; discarding a draft is
175
+ * refused with `catalog-draft-in-use` ({@link dependents}, {@link heldResources}).
175
176
  */
176
177
  get environments(): readonly string[];
177
178
  /**
@@ -181,6 +182,21 @@ export declare class ProblemDetailException extends ResponseError {
181
182
  get pinnedBy(): readonly CatalogReleaseRef[];
182
183
  /** True when this problem said the release cannot be deleted while something uses it. */
183
184
  get isReleaseInUseProblem(): boolean;
185
+ /**
186
+ * The drafts of other catalogs a `catalog-draft-in-use` problem (409, from `deleteCatalogRelease`)
187
+ * says name the draft in their dependency declarations, in the order the server listed them;
188
+ * empty for any other problem, and when none does. Change their declarations, or discard them,
189
+ * first. An entry that does not carry all five members as strings is dropped rather than guessed at.
190
+ */
191
+ get dependents(): readonly CatalogDraftRef[];
192
+ /**
193
+ * The resources a `catalog-draft-in-use` problem says only the draft holds while something outside
194
+ * it still uses them, each as `resourceType/resourceKey` (`theme/house-style`); empty for any
195
+ * other problem, and when none.
196
+ */
197
+ get heldResources(): readonly string[];
198
+ /** True when this problem said the draft cannot be discarded while something relies on it. */
199
+ get isCatalogDraftInUseProblem(): boolean;
184
200
  /**
185
201
  * The keys of the variants an `ambiguous-variant` problem (409, from generating or previewing a
186
202
  * document) says match the request's attributes equally well: name one by `variantKey`, or send
@@ -235,4 +251,9 @@ export type UnreleasedDependency = Readonly<UnreleasedCatalogDependency>;
235
251
  * `pinnedBy` member: the generated `CatalogReleaseRefDto`.
236
252
  */
237
253
  export type CatalogReleaseRef = Readonly<CatalogReleaseRefDto>;
254
+ /**
255
+ * One draft a problem names in full, such as each entry of a `catalog-draft-in-use` problem's
256
+ * `dependents` member: the generated `CatalogDraftRefDto`.
257
+ */
258
+ export type CatalogDraftRef = Readonly<CatalogDraftRefDto>;
238
259
  //# sourceMappingURL=problemDetailException.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"problemDetailException.d.ts","sourceRoot":"","sources":["../../src/error/problemDetailException.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"problemDetailException.d.ts","sourceRoot":"","sources":["../../src/error/problemDetailException.ts"],"names":[],"mappings":"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"}
@@ -221,8 +221,9 @@ export class ProblemDetailException extends ResponseError {
221
221
  return this.typeSlug === KnownProblemSlugs.CATALOG_VERSION_BEHIND;
222
222
  }
223
223
  /**
224
- * The environments a `release-in-use` problem (409, from `deleteCatalogRelease`) says deploy the
225
- * release; empty for any other problem, and when none does.
224
+ * The environments a `release-in-use` problem (409) says deploy the release; empty for any other
225
+ * problem, and when none does. No operation deletes a released release yet; discarding a draft is
226
+ * refused with `catalog-draft-in-use` ({@link dependents}, {@link heldResources}).
226
227
  */
227
228
  get environments() {
228
229
  return stringsAt(this.extensions, ProblemExtensionMembers.ENVIRONMENTS);
@@ -238,6 +239,27 @@ export class ProblemDetailException extends ResponseError {
238
239
  get isReleaseInUseProblem() {
239
240
  return this.typeSlug === KnownProblemSlugs.RELEASE_IN_USE;
240
241
  }
242
+ /**
243
+ * The drafts of other catalogs a `catalog-draft-in-use` problem (409, from `deleteCatalogRelease`)
244
+ * says name the draft in their dependency declarations, in the order the server listed them;
245
+ * empty for any other problem, and when none does. Change their declarations, or discard them,
246
+ * first. An entry that does not carry all five members as strings is dropped rather than guessed at.
247
+ */
248
+ get dependents() {
249
+ return objectsAt(this.extensions, ProblemExtensionMembers.DEPENDENTS).filter(isCatalogDraftRef);
250
+ }
251
+ /**
252
+ * The resources a `catalog-draft-in-use` problem says only the draft holds while something outside
253
+ * it still uses them, each as `resourceType/resourceKey` (`theme/house-style`); empty for any
254
+ * other problem, and when none.
255
+ */
256
+ get heldResources() {
257
+ return stringsAt(this.extensions, ProblemExtensionMembers.HELD_RESOURCES);
258
+ }
259
+ /** True when this problem said the draft cannot be discarded while something relies on it. */
260
+ get isCatalogDraftInUseProblem() {
261
+ return this.typeSlug === KnownProblemSlugs.CATALOG_DRAFT_IN_USE;
262
+ }
241
263
  /**
242
264
  * The keys of the variants an `ambiguous-variant` problem (409, from generating or previewing a
243
265
  * document) says match the request's attributes equally well: name one by `variantKey`, or send
@@ -312,6 +334,11 @@ function isCatalogReleaseRef(entry) {
312
334
  const record = entry;
313
335
  return CATALOG_RELEASE_REF_MEMBERS.every((member) => typeof record[member] === 'string');
314
336
  }
337
+ const CATALOG_DRAFT_REF_MEMBERS = ['registry', 'namespace', 'catalogKey', 'releaseId', 'releaseName'];
338
+ function isCatalogDraftRef(entry) {
339
+ const record = entry;
340
+ return CATALOG_DRAFT_REF_MEMBERS.every((member) => typeof record[member] === 'string');
341
+ }
315
342
  /** One extension member's array of strings, or empty when absent; entries that are not strings are dropped. */
316
343
  function stringsAt(extensions, member) {
317
344
  const value = extensions[member];
@@ -1 +1 @@
1
- {"version":3,"file":"problemDetailException.js","sourceRoot":"","sources":["../../src/error/problemDetailException.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"problemDetailException.js","sourceRoot":"","sources":["../../src/error/problemDetailException.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,oCAAoC;AAepC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAA;AAC9F,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IAG5C,OAAO;IAEP,MAAM;IAKN,gBAAgB;IAMhB,UAAU;IAEV,UAAU;IAEV,OAAO;IAnBlB;IACE,yFAAyF;IAChF,OAAsB;IAC/B,+FAA+F;IACtF,MAAkC;IAC3C;;;OAGG;IACM,gBAA+E;IACxF;;;;OAIG;IACM,UAA6C;IACtD,6CAA6C;IACpC,UAAkB;IAC3B,qCAAqC;IAC5B,OAAe,EACxB,QAAkB;QAElB,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA;uBApBzC,OAAO;sBAEP,MAAM;gCAKN,gBAAgB;0BAMhB,UAAU;0BAEV,UAAU;uBAEV,OAAO;IAIlB,CAAC;IAED,+DAA+D;IAC/D,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,UAAU,CAAA;IACxC,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ;QACV,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC;IAED,2EAA2E;IAC3E,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAA;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAA;IAC5B,CAAC;IAED,uFAAuF;IACvF,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAA;IAC5B,CAAC;IAED,mGAAmG;IACnG,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IAC9B,CAAC;IAED;;;;;OAKG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAA;IAC1B,CAAC;IAED,oEAAoE;IACpE,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED,iFAAiF;IACjF,IAAI,4BAA4B;QAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;IACtD,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,aAAa;QACf,OAAO,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,uBAAuB,CAAC,cAAc,CAAgC,CAAA;IAC1G,CAAC;IAED,0FAA0F;IAC1F,IAAI,aAAa;QACf,OAAO,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,uBAAuB,CAAC,cAAc,CAAgC,CAAA;IAC1G,CAAC;IAED,qEAAqE;IACrE,IAAI,qBAAqB;QACvB,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAA;IACvE,CAAC;IAED;;;;;;;;;OASG;IACH,IAAI,mBAAmB;QACrB,OAAO,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,uBAAuB,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAA;IAC7G,CAAC;IAED,sEAAsE;IACtE,IAAI,mCAAmC;QACrC,OAAO,IAAI,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAA;IAC5C,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,sBAAsB;QACxB,OAAO,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,uBAAuB,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAA;IACnH,CAAC;IAED,2FAA2F;IAC3F,IAAI,sCAAsC;QACxC,OAAO,IAAI,CAAC,sBAAsB,CAAC,MAAM,GAAG,CAAC,CAAA;IAC/C,CAAC;IAED;;;;;;OAMG;IACH,IAAI,cAAc;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,CAAA;QACvE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;IACtD,CAAC;IAED,0EAA0E;IAC1E,IAAI,wBAAwB;QAC1B,OAAO,IAAI,CAAC,cAAc,KAAK,SAAS,CAAA;IAC1C,CAAC;IAED;;;;OAIG;IACH,IAAI,mBAAmB;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,oBAAoB,CAAC,CAAA;QAC3E,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACxG,CAAC;IAED,4EAA4E;IAC5E,IAAI,iCAAiC;QACnC,OAAO,IAAI,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAA;IAC5C,CAAC;IAED;;;;;OAKG;IACH,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,sBAAsB,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAA;IACrE,CAAC;IAED;;;OAGG;IACH,IAAI,sBAAsB;QACxB,OAAO,IAAI,CAAC,sBAAsB,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAA;IACzE,CAAC;IAED,iFAAiF;IACjF,IAAI,yBAAyB;QAC3B,OAAO,IAAI,CAAC,kBAAkB,KAAK,SAAS,CAAA;IAC9C,CAAC;IAED;;;;OAIG;IACH,IAAI,MAAM;QACR,OAAO,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAA;IACnE,CAAC;IAED,gGAAgG;IAChG,IAAI,6BAA6B;QAC/B,OAAO,IAAI,CAAC,QAAQ,KAAK,iBAAiB,CAAC,sBAAsB,CAAA;IACnE,CAAC;IAED;;;;OAIG;IACH,IAAI,YAAY;QACd,OAAO,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,uBAAuB,CAAC,YAAY,CAAC,CAAA;IACzE,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ;QACV,OAAO,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAA;IAClG,CAAC;IAED,yFAAyF;IACzF,IAAI,qBAAqB;QACvB,OAAO,IAAI,CAAC,QAAQ,KAAK,iBAAiB,CAAC,cAAc,CAAA;IAC3D,CAAC;IAED;;;;;OAKG;IACH,IAAI,UAAU;QACZ,OAAO,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAA;IACjG,CAAC;IAED;;;;OAIG;IACH,IAAI,aAAa;QACf,OAAO,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,uBAAuB,CAAC,cAAc,CAAC,CAAA;IAC3E,CAAC;IAED,8FAA8F;IAC9F,IAAI,0BAA0B;QAC5B,OAAO,IAAI,CAAC,QAAQ,KAAK,iBAAiB,CAAC,oBAAoB,CAAA;IACjE,CAAC;IAED;;;;OAIG;IACH,IAAI,YAAY;QACd,OAAO,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,uBAAuB,CAAC,aAAa,CAAC,CAAA;IAC1E,CAAC;IAED,uEAAuE;IACvE,IAAI,yBAAyB;QAC3B,OAAO,IAAI,CAAC,QAAQ,KAAK,iBAAiB,CAAC,iBAAiB,CAAA;IAC9D,CAAC;IAED,4EAA4E;IAC5E,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,QAAQ,KAAK,iBAAiB,CAAC,SAAS,CAAA;IACtD,CAAC;IAED;;;;OAIG;IACH,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,eAAe,CAAC,uBAAuB,CAAC,mBAAmB,CAAC,CAAA;IAC1E,CAAC;IAED;;;;OAIG;IACH,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,eAAe,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAA;IACjE,CAAC;IAED;;;OAGG;IACH,IAAI,oBAAoB;QACtB,OAAO,IAAI,CAAC,eAAe,CAAC,uBAAuB,CAAC,sBAAsB,CAAC,CAAA;IAC7E,CAAC;IAED;;;OAGG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,eAAe,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAC7D,CAAC;IAEO,eAAe,CAAC,MAAc;QACpC,IAAI,IAAI,CAAC,QAAQ,KAAK,iBAAiB,CAAC,SAAS;YAAE,OAAO,SAAS,CAAA;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;QACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;IACtD,CAAC;IAEO,sBAAsB,CAAC,MAAc;QAC3C,IAAI,IAAI,CAAC,QAAQ,KAAK,iBAAiB,CAAC,kBAAkB;YAAE,OAAO,SAAS,CAAA;QAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;QACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;IACtD,CAAC;CACF;AAYD,MAAM,0BAA0B,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAA;AAExG,SAAS,mBAAmB,CAAC,KAAa;IACxC,MAAM,MAAM,GAAG,KAAgC,CAAA;IAC/C,OAAO,0BAA0B,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAA;AACzF,CAAC;AAQD,MAAM,6BAA6B,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,CAAU,CAAA;AAElH,SAAS,sBAAsB,CAAC,KAAa;IAC3C,MAAM,MAAM,GAAG,KAAgC,CAAA;IAC/C,OAAO,6BAA6B,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAA;AAC5F,CAAC;AAQD,MAAM,2BAA2B,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,CAAU,CAAA;AAE5G,SAAS,mBAAmB,CAAC,KAAa;IACxC,MAAM,MAAM,GAAG,KAAgC,CAAA;IAC/C,OAAO,2BAA2B,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAA;AAC1F,CAAC;AAQD,MAAM,yBAAyB,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,CAAU,CAAA;AAE9G,SAAS,iBAAiB,CAAC,KAAa;IACtC,MAAM,MAAM,GAAG,KAAgC,CAAA;IAC/C,OAAO,yBAAyB,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAA;AACxF,CAAC;AAED,+GAA+G;AAC/G,SAAS,SAAS,CAAC,UAA6C,EAAE,MAAc;IAC9E,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAChC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACxG,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAAC,UAA6C,EAAE,MAAc;IAC9E,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAA;IACX,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;AACvH,CAAC;AAED,SAAS,YAAY,CAAC,MAAc,EAAE,OAAsB;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,CAAA;IAC7C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAA;AACxF,CAAC"}
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * Epistola API
3
- * Epistola generates documents, PDFs, from templates. Authors design the templates; applications send data and get documents back. This API manages templates and the catalogs that hold them, and generates documents from them, asynchronously and at volume. ## Glossary - **Tenant**: an organisation, isolated from every other. Everything else lives in one, under `/tenants/{tenantKey}`. - **Catalog**: a set of templates and everything they use, released as a whole. A catalog is named by three parts together: a **registry**, the DNS name of where it is published (`exchange.epistola.app`, or a domain that publishes its own, `acme.com`); a **namespace**, its publisher within that registry (`acme-corp`); and its key (`letters`). In a path, `~` stands for the server\'s default registry. The registry `local` names catalogs that never leave the organisation: valid within its own installations, refused by an Exchange. - **Release**: the catalog as a whole at one point, in one of two statuses. A **draft release**, or **draft**, is editable and has no version; a **released** release is immutable and has a version. \"Release `1.4.0`\" means the released one. - **Version**: the number of a released release, its `version` (`1.4.0`), a SemVer core version, or a patch release number (`1.3.1-gemeente-x.1`, see \"Versions and version ranges\"). A **version range**, `versionRange` (`^1.4.0`), selects the highest release that satisfies it, for a request that renders; it never matches a draft. - **Content hash**: what identifies a released release, its `contentHash` (`v6:…`), a hash of its content alone, not of its name or number: two releases with one content hash are the same release, whatever they are called. Names and numbers point at content hashes. - **Releasing**: turning a draft into a released release, as a version. A release keeps its id, its `releaseId`, assigned by the server, and its name when it is released, so a draft released as `1.4.1` is the same release, addressed by its `releaseId` or by `1.4.1`. - **Publishing**: making a catalog available in a registry, for other tenants and installations to install from. Only released releases are ever published; releasing is not publishing. - **Base**: the release a draft started from; its changes are measured against it. A draft is **behind** a release whose changes it may lack (see \"Releases\"). A changed resource is **ready** once someone marks it reviewed; a draft is released only when it changed something and all its changes are (`getCatalogChanges`). - **Editable** catalogs: every catalog has releases and drafts, wherever its releases come from (its **source**: an exchange, a registry, a file, or the server itself). Whether a catalog can be changed depends on the installation, which may only receive and run releases, and on whether the server supplies the catalog itself (`CatalogDto.editable`, `readOnlyReason`). - **Environment**: where documents are generated for a purpose, such as `staging` or `production`. A **deployment** makes an environment serve a release of a catalog; a request through the environment renders what it serves. - **Template**: one kind of document, with its data contract (the JSON Schema its data must meet) and data examples. A **variant** is one rendering of a template, for a language or a brand, chosen by its key or by **attributes** (such as `locale`); an attribute\'s values may come from a **code list** of `{code, label}` entries. A **stencil** is reusable template content, a **theme** a reusable set of styles, and a **preset** a named block style a catalog declares and its themes style. - **Consumer** (experimental): an application registered in a tenant, with its own permissions. ## Getting started 1. **Get an API key** from a tenant manager. A key belongs to one tenant and carries the roles it was issued with: `CONTENT_VIEWER` to find templates and read jobs and documents, and `DOCUMENT_GENERATOR` to generate. 2. **Send these headers** on every request (the client libraries set all but the key): ``` Authorization: ApiKey <key> Accept: application/vnd.epistola.v2+json Content-Type: application/vnd.epistola.v2+json (with a request body) User-Agent: epistola-contract/2.0.0 your-app/1.0 X-EP-Node-Id: <this host or pod> ``` 3. **Find your template.** `GET /tenants/{tenantKey}/catalogs` lists the catalogs, each with its `registry`, `namespace`, `catalogKey` and `highestVersion`. `GET /tenants/{tenantKey}/catalogs/{registry}/{namespace}/{catalogKey}/releases/{release}/templates`, with that version as `{release}`, lists that release\'s templates, and `getTemplate` shows a template\'s data contract. 4. **Generate.** `POST /tenants/{tenantKey}/documents/generate` with the template and its data: ```json {\"namespace\": \"acme-corp\", \"catalogKey\": \"letters\", \"templateKey\": \"invoice\", \"variantKey\": \"english\", \"data\": {\"customer\": {\"name\": \"Jane Smith\"}}} ``` It answers `202` with a `requestId` and, in `Location`, the job\'s address. Without a `versionRange` or an `environmentKey`, the catalog\'s highest release renders. 5. **Poll the job**, `GET /tenants/{tenantKey}/documents/jobs/{requestId}`, until `request.status` is `completed` (or `failed` or `cancelled`). Each item names its `documentId`. 6. **Download** the PDF: `GET /tenants/{tenantKey}/documents/{documentId}`. `validateTemplateData` checks data against a template\'s contract before you submit it, and `previewDocument` renders one document synchronously, for previews only. For high volume, poll no jobs: collect finished results as a stream instead (`collectGenerationResults`), each delivered to the node that asked for it and acknowledged when handled. That is the advanced path; the client libraries\' result collectors implement it. ## Template model A variant\'s content (`getVariantContent`, `updateVariantContent`) and a stencil\'s are a template document: a flat graph of nodes and slots, linked by id. A node is one block, of a component type such as `text`, `table` or `conditional`; a slot is a named place in a node that holds child nodes, such as a table\'s `cell-0-1` or a conditional\'s `body` and `else`. The catalog contract\'s [component registry](https://github.com/epistola-app/epistola-contract/blob/main/contracts/catalog/registry/component-registry.json) and [style registry](https://github.com/epistola-app/epistola-contract/blob/main/contracts/catalog/registry/style-registry.json) define every component and style, with examples, and the [template model guide](https://github.com/epistola-app/epistola-contract/blob/main/contracts/api/docs/template-model.md) walks through a complete letter: the example `updateVariantContent` shows. ## Media types The media type carries the API\'s major version. Contract 2.x uses `application/vnd.epistola.v2+json`, and `application/vnd.epistola.v2+ndjson` for the result stream, in `Accept` and in `Content-Type`. Problems are `application/problem+json`. ## Client identity Every request identifies the client with two headers: - **`User-Agent`** (required): [RFC 9110](https://www.rfc-editor.org/rfc/rfc9110#name-user-agent) product tokens, the first of which **must** be `epistola-contract/{version}`, the contract version the client was built against. Further tokens describe the rest of the stack: `epistola-contract/x.y.z valtimo-epistola-plugin/1.2.0 gzac/5.0.0`. - **`X-EP-Node-Id`** (required): the client node, such as its Kubernetes pod name, container id or hostname. The client libraries set both, the contract version and the hostname; an application can append its own product tokens and override the node id. ## Releases A catalog consists of releases, addressed as `/catalogs/{registry}/{namespace}/{catalogKey}/releases/{release}`, with the catalog\'s resources below each. A draft is addressed by its `releaseId`; a released release by its `releaseId` or its version, which address the same release. Every write to a released release is refused with 409. - A catalog that can be changed has **any number of drafts**, each named, each started from a released release (its base) or from another draft (`createCatalogRelease`). The base never moves. `listCatalogReleases` lists a catalog\'s releases, drafts included, each with its `status` (`?status=draft` for the drafts only) and, once released, its `contentHash` (`?contentHash=` for the releases with that content); a catalog (`CatalogDto`) does not list them. - **Any draft can be released.** Its version follows from the kind of change against its base: fixes raise the patch, additions the minor, anything that breaks callers the major (`previewCatalogDraftRelease`). The author may choose a higher version, never a lower one or one another release has. A fix to an older line is a draft from a release of that line: from `1.4.0`, while `1.5.0` and `2.0.0` exist, it is released as `1.4.1`. - **Drafts are independent copies**: releasing one changes no other. A draft is **behind** each release whose version is between its base and the version it would get, and each release released after it was started whose version is below that one; it lacks their changes unless an author applied them by hand. `getCatalogRelease` lists them, and releasing a draft that is behind must acknowledge them. - **Merging a release into a draft** (alpha, `x-experimental`): `previewCatalogDraftMerge` shows, per resource, per catalog setting (default theme and presets, entries of type `catalog`) and per catalog used (entries of type `catalogDependency`), each with the entries it goes with (`needs`), against the merge base (the closest release both descend from), what only the draft changed (`ours`), what only the release changed (`theirs`) and what both changed differently (`conflict`); `mergeIntoCatalogDraft` takes theirs and applies a resolution, `ours` or `theirs`, per conflict. The draft then contains the release and is no longer behind it; its base does not move. The preview\'s `token`, sent back as `expectedToken`, makes the merge apply what the preview showed or nothing (`merge-preview-outdated`). A conflict can also be resolved to content combined from its sides (`getCatalogDraftMergeSides`, then `mergedContent`), reviewed before the draft is released. The merge needs the merge base installed; the preview names one that is not (`missingBase`), and the merge is refused with `merge-base-missing`. - **Release registries** (alpha, `x-experimental`, ADR 0008) move releases between installations: an Epistola Exchange the installation is connected to, or a container registry it is configured with (`listReleaseRegistries`). A released release is published to one (`publishReleaseToRegistry`), and another installation lists the releases of a catalog there (`listRegistryReleases`) and installs one (`installRegistryRelease`) as an import does. A release registry is named by the installation; it is not the `{registry}` of a catalog\'s name. - **Quality profiles** (alpha, `x-experimental`, contract ADR 0010) record how an organisation writes: rules with a plain-language intent, a severity and extras per kind of checking system (`listQualityProfiles` and the rest of the group). A release binds the profiles every template in it is checked against, and a template adds its own (`quality` on `CatalogReleaseDto` and `TemplateDto`). Documents are rendered from releases, and a version range never matches a draft. A draft renders only in a preview that names its `releaseId`, and in an environment it is deployed to. Importing a catalog archive (`importCatalog`) installs the release the archive carries, at its version, beside the releases the tenant already has; it never creates or changes a draft. A catalog with a source (`CatalogDto.source`) installs releases from it the same way (`installCatalogRelease`), and `listAvailableCatalogReleases` lists those the tenant does not have yet, older lines included. Nothing is updated in place or removed: deploying decides what an environment serves. A release keeps its id and number wherever it moves, so it is the same release in every installation. There are no catalog types: receiving releases works whether or not the catalog can be changed, and every write to one that cannot is refused with 409 `catalog-read-only`. ## Deploying An environment serves releases of catalogs (`deployCatalogRelease`): released ones, several of one catalog if need be, and at most one draft per catalog, rendered live. A request through the environment (`environmentKey`) renders: - with **no `versionRange`**: the catalog\'s deployed draft if there is one, else the highest release the environment serves; - with a **range or an exact version**: the highest served release that satisfies it. A draft never matches: it has no version. Rollback is undeploying the newer release. Deploying a draft replaces the draft the environment served for that catalog, and an environment marked **production** (`EnvironmentDto.production`) serves no draft. A document rendered from a draft carries the draft\'s `releaseId` and its name at render time (`releaseName`), with a null `version`, and its PDF a preview watermark. Releasing a deployed draft keeps its `releaseId`, so the environment then serves it as released; discarding the draft ends the deployment. ## Versions and version ranges A version (`ReleaseVersion`) is a SemVer core version, `MAJOR.MINOR.PATCH` without leading zeros, as the holder of the catalog\'s namespace issues it, or a **patch release** number, `MAJOR.MINOR.PATCH-<namespace>.<N>`, at most 128 characters. Wherever the contract names one exact version it has that form, and is called `version`; every member called `version` is one. A patch release is how someone who does not hold a catalog\'s namespace fixes a release of it (a municipality fixing a supplier\'s catalog): it is labelled with a namespace they hold, and numbered from 1, `1.3.1-gemeente-x.1`. As a SemVer pre-release it sorts below its core and above every release below that, `1.3.0` < `1.3.1-gemeente-x.1` < `1.3.1`, so the holder\'s next release supersedes it, and the two never collide: the holder never uses a label, the patcher never issues a plain number (contract ADR 0003). Which namespaces a tenant holds is the installation\'s to know; the contract checks the shape. \"Highest\" always means by this order, a patch release included. A request that selects a release to render or check (generation, preview, validation) takes a version range, `versionRange`, in the npm SemVer range grammar: an exact version (`1.4.0`), a caret (`^1.4.0`), a tilde (`~1.4.0`), comparators (`>=1.0.0 <2.0.0`), a hyphen range (`1.0.0 - 2.0.0`), or a `||` union of these. The highest release that satisfies it renders, and responses name the exact release used. A range is at most 256 characters, so an exact release number (at most 128) always fits, and a comparator pair of patch release numbers usually does. A range matches a patch release as npm matches a pre-release: only when one of its comparators names a pre-release of the same `MAJOR.MINOR.PATCH`, such as the exact number (`1.3.1-gemeente-x.1`) or `>=1.3.1-gemeente-x.1 <1.4.0`; `^1.3.0` never selects one. ## Catalog dependencies A catalog that uses another catalog\'s resources declares that catalog once, with the exact release of it that it renders with (`version`), never a range. References into the other catalog name the catalog but no version, so a release renders with exactly the releases its declarations pin. In a draft, a declaration may name a draft of the other catalog instead (`releaseId`), to build on work that is not released yet. A released release pins only released releases: releasing such a draft is refused (`release-dependencies-unreleased`) unless the request releases those drafts along with it (`releaseDependencies`), in one transaction. ## Catalog identity A catalog\'s key alone is not unique: two publishers can each publish `letters`. The registry and the namespace complete its name, and the same namespace in two registries is two namespaces. Which registry is a server\'s default is configuration; in a path, `/catalogs/~/acme-corp/letters/…` and `/catalogs/exchange.epistola.app/acme-corp/letters/…` address the same catalog when `exchange.epistola.app` is the default, and `~` may be sent percent-encoded as `%7E`. In a body, a catalog is named by separate `registry`, `namespace` and `catalogKey` members, and a reference into another catalog by an alias: 1. **A request that names a catalog** (a generation or preview target, a dependency declaration) may omit `registry`, or send null, for the default registry. (An import\'s `registry` defaults to the one the archive names.) 2. **A reference from one catalog\'s release to a resource of another** names that catalog by the **alias** the release\'s dependency declarations give it (`CatalogAlias`, in the member `catalogKey`), never by registry or namespace: a template model\'s `themeRef`, its stencil and image nodes, a `fontFamily` (catalog content, portable catalog wire v8, contract ADR 0003), and the references this API reads and writes beside it, a release\'s default theme (`CatalogThemeReference`), an attribute\'s code-list binding and an attribute criterion in variant selection (`VariantSelectionAttribute`, resolved through the release that renders). Omitted or null, or the catalog\'s own key, is the catalog itself. A declaration (`CatalogDependencyDto`, `listCatalogDependencies`) maps each alias to the catalog\'s full name and the release it pins; that is where a client finds the name. Because content names the alias, it means the same in every installation and under any name, and pinning another release changes no content. An alias is by default the catalog\'s key (`CatalogDependencyRequirement.alias`). Responses write every registry in full, by its name, never `~`, so a value read from one installation means the same catalog on another. Content documents are returned as stored. ## Concurrency Updates can be made conditional. Templates, variants, themes, stencils, code lists, attributes, releases, environments, tenants and consumers carry a revision, which reading or updating one returns as a strong `ETag` header: a quoted decimal integer such as `\"7\"`. Send it back as `If-Match` on an update: if the resource changed since you read it, the update is refused with 412 `resource-modified` and nothing changes; read it again, reapply your change and retry. Without `If-Match` an update applies unconditionally, and the last write wins. What a revision covers: - a template: its own properties, data contract and data examples; - a variant: its title, description, attributes and template model, so `getVariant` and `getVariantContent` return the same `ETag`, and `updateVariant` and `updateVariantContent` take either; - a release: its name, default theme, presets and dependency declarations, so `getCatalogRelease` and `listCatalogDependencies` return the same `ETag`, and `updateCatalogRelease` and `updateCatalogDependencies` take either; - a code list: its properties and entries, whether each is hidden included, so `updateCodeListEntryHidden` takes the code list\'s `ETag`; - an environment: its name and production mark, not what it serves. ## Authentication Credentials go in the `Authorization` header: - **API key**, `Authorization: ApiKey <key>`: the supported method. A tenant manager issues each key for one tenant, with a set of tenant roles. The scheme name is case-insensitive. - **Bearer JWT** (**experimental**), `Authorization: Bearer <jwt>`: issued by an OAuth 2.0 identity provider, or self-signed with a key pair registered through the Consumers API. The [authentication guide](https://github.com/epistola-app/epistola-contract/blob/main/contracts/api/docs/auth.md) has the details. ## Authorization Each operation names the permissions it requires (`x-required-permissions`), such as `TEMPLATE_VIEW`, `TEMPLATE_EDIT`, `DOCUMENT_GENERATE` and `CATALOG_MANAGE`. A caller has them through its tenant roles (`CONTENT_VIEWER`, `CONTENT_AUTHOR`, `DOCUMENT_GENERATOR`, `CONTENT_PUBLISHER`, `TENANT_ADMINISTRATOR`), the roles stored on its API key. Managing tenants needs the platform role `TENANT_MANAGER`. A request member that needs a permission beyond its operation\'s says so in its description: changing a quality binding (`quality`, alpha) needs `QUALITY_EDIT` as well. ## Errors Errors are [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) problem details, with `Content-Type: application/problem+json`: - `type` (URI): what went wrong, the stable value to switch on. It is `https://epistola.app/errors/{slug}`, which documents the problem type; - `title`: a short summary; - `status`: the HTTP status code; - `detail` (optional): what happened this time; - `instance` (optional): this occurrence; - `help` (optional): the type\'s page with this request\'s context, such as the `operation` that answered, for hints that fit it. It names this contract\'s terms only, never a value. A problem may add members of its own, such as the field-level `errors` of a `validation-error`; ignore members you do not recognize. The problem types are listed, machine-readably, in this document\'s `x-problem-types` extension, and in the [error type registry](https://github.com/epistola-app/epistola-contract/blob/main/contracts/api/docs/error-types.md). A server answers only with the types registered there. A type names a problem a caller can act on differently; anything else is the generic type of its status, so a missing resource is `not-found` whichever resource it is, and a refused authorization `forbidden`. New types may be added in a minor version: handle a type you do not recognize by its `status`, as the generic type of that status, and keep a fallback when switching on them. Six statuses are not listed on each operation, because any operation may answer them: 405 `method-not-allowed`, 406 `not-acceptable`, 413 `content-too-large` and 415 `unsupported-media-type` (the last two where it takes a body), 500 `internal-error`, and 501 `operation-not-implemented`. `x-problem-types` marks them `anyOperation: true`. ## Compatibility within 2.x A minor version adds and never takes away, so a client built against an earlier 2.x keeps working against a later 2.x server. A minor version may add: - operations, and optional request members and query parameters; - **response members**: ignore a member you do not recognize; - **enum values in responses**: a status, kind or reason may gain a value. Treat one you do not recognize as unknown rather than failing, and keep a default branch when switching on an enum. The client libraries read it without failing: the Kotlin, Jakarta and .NET enums as their `unknown_default_open_api` member (`UNKNOWN_DEFAULT_OPEN_API` in Jakarta, `UnknownDefaultOpenApi` in .NET), the Python client as an unknown member that keeps the value, and the Node.js client as the string received; - problem types and validation codes (see \"Errors\"). It never removes or renames a member or an enum value, makes an optional request member required, or narrows what a request may send. A server refuses a request enum value it does not know with 400, so never send `unknown_default_open_api`. Operations and members marked `x-experimental` are outside these rules. ## Experimental parts and server support Operations and members marked `x-experimental: true`, the consumer model (Bearer JWT and the Consumers API) among them, may still change. Epistola Suite, the server that implements this contract, may not implement them yet, nor every part of the rest: installing missing dependency releases when deploying, recording who requested a document, an attribute\'s `description`, listing a stencil\'s usage in a released release, and a dependency alias other than the catalog\'s key among them. An operation a server does not implement yet answers 501 `operation-not-implemented`.
3
+ * Epistola generates documents, PDFs, from templates. Authors design the templates; applications send data and get documents back. This API manages templates and the catalogs that hold them, and generates documents from them, asynchronously and at volume. ## Glossary - **Tenant**: an organisation, isolated from every other. Everything else lives in one, under `/tenants/{tenantKey}`. - **Catalog**: a set of templates and everything they use, released as a whole. A catalog is named by three parts together: a **registry**, the DNS name of where it is published (`exchange.epistola.app`, or a domain that publishes its own, `acme.com`); a **namespace**, its publisher within that registry (`acme-corp`); and its key (`letters`). In a path, `~` stands for the server\'s default registry. The registry `local` names catalogs that never leave the organisation: valid within its own installations, refused by an Exchange. - **Release**: the catalog as a whole at one point, in one of two statuses. A **draft release**, or **draft**, is editable and has no version; a **released** release is immutable and has a version. \"Release `1.4.0`\" means the released one. - **Version**: the number of a released release, its `version` (`1.4.0`), a SemVer core version, or a patch release number (`1.3.1-gemeente-x.1`, see \"Versions and version ranges\"). A **version range**, `versionRange` (`^1.4.0`), selects the highest release that satisfies it, for a request that renders; it never matches a draft. - **Content hash**: what identifies a released release, its `contentHash` (`v6:…`), a hash of its content alone, not of its name or number: two releases with one content hash are the same release, whatever they are called. Names and numbers point at content hashes. - **Releasing**: turning a draft into a released release, as a version. A release keeps its id, its `releaseId`, assigned by the server, and its name when it is released, so a draft released as `1.4.1` is the same release, addressed by its `releaseId` or by `1.4.1`. - **Publishing**: making a catalog available in a registry, for other tenants and installations to install from. Only released releases are ever published; releasing is not publishing. - **Base**: the release a draft started from; its changes are measured against it. A draft is **behind** a release whose changes it may lack (see \"Releases\"). A changed resource is **ready** once someone marks it reviewed; a draft is released only when it changed something and all its changes are (`getCatalogChanges`). - **Editable** catalogs: every catalog has releases and drafts, wherever its releases come from (its **source**: an exchange, a registry, a file, or the server itself). Whether a catalog can be changed depends on the installation, which may only receive and run releases, and on whether the server supplies the catalog itself (`CatalogDto.editable`, `readOnlyReason`). - **Environment**: where documents are generated for a purpose, such as `staging` or `production`. A **deployment** makes an environment serve a release of a catalog; a request through the environment renders what it serves. - **Template**: one kind of document, with its data contract (the JSON Schema its data must meet) and data examples. A **variant** is one rendering of a template, for a language or a brand, chosen by its key or by **attributes** (such as `locale`); an attribute\'s values may come from a **code list** of `{code, label}` entries. A **stencil** is reusable template content, a **theme** a reusable set of styles, and a **preset** a named block style a catalog declares and its themes style. - **Consumer** (experimental): an application registered in a tenant, with its own permissions. ## Getting started 1. **Get an API key** from a tenant manager. A key belongs to one tenant and carries the roles it was issued with: `CONTENT_VIEWER` to find templates, and `DOCUMENT_GENERATOR` to generate and to read jobs and documents (`DOCUMENT_READER` reads them without generating). 2. **Send these headers** on every request (the client libraries set all but the key): ``` Authorization: ApiKey <key> Accept: application/vnd.epistola.v2+json Content-Type: application/vnd.epistola.v2+json (with a request body) User-Agent: epistola-contract/2.0.0 your-app/1.0 X-EP-Node-Id: <this host or pod> ``` 3. **Find your template.** `GET /tenants/{tenantKey}/catalogs` lists the catalogs, each with its `registry`, `namespace`, `catalogKey` and `highestVersion`. `GET /tenants/{tenantKey}/catalogs/{registry}/{namespace}/{catalogKey}/releases/{release}/templates`, with that version as `{release}`, lists that release\'s templates, and `getTemplate` shows a template\'s data contract. 4. **Generate.** `POST /tenants/{tenantKey}/documents/generate` with the template and its data: ```json {\"namespace\": \"acme-corp\", \"catalogKey\": \"letters\", \"templateKey\": \"invoice\", \"variantKey\": \"english\", \"data\": {\"customer\": {\"name\": \"Jane Smith\"}}} ``` It answers `202` with a `requestId` and, in `Location`, the job\'s address. Without a `versionRange` or an `environmentKey`, the catalog\'s highest release renders. 5. **Poll the job**, `GET /tenants/{tenantKey}/documents/jobs/{requestId}`, until its `status` is `completed` (or `failed` or `cancelled`). Its items, `GET /tenants/{tenantKey}/documents/jobs/{requestId}/items`, each name their `documentId`. 6. **Download** the PDF: `GET /tenants/{tenantKey}/documents/{documentId}/content`. `validateTemplateData` checks data against a template\'s contract before you submit it, and `previewDocument` renders one document synchronously, for previews only. For high volume, poll no jobs: collect finished results as a stream instead (`collectGenerationResults`), each delivered to the node that asked for it and acknowledged when handled. That is the advanced path; the client libraries\' result collectors implement it. ## Template model A variant\'s content (`getVariantContent`, `updateVariantContent`) and a stencil\'s are a template document: a flat graph of nodes and slots, linked by id. A node is one block, of a component type such as `text`, `table` or `conditional`; a slot is a named place in a node that holds child nodes, such as a table\'s `cell-0-1` or a conditional\'s `body` and `else`. The catalog contract\'s [component registry](https://github.com/epistola-app/epistola-contract/blob/main/contracts/catalog/registry/component-registry.json) and [style registry](https://github.com/epistola-app/epistola-contract/blob/main/contracts/catalog/registry/style-registry.json) define every component and style, with examples, and the [template model guide](https://github.com/epistola-app/epistola-contract/blob/main/contracts/api/docs/template-model.md) walks through a complete letter: the example `updateVariantContent` shows. ## Media types The media type carries the API\'s major version. Contract 2.x uses `application/vnd.epistola.v2+json`, and `application/vnd.epistola.v2+ndjson` for the result stream, in `Accept` and in `Content-Type`. Problems are `application/problem+json`. ## Client identity Every request identifies the client with two headers: - **`User-Agent`** (required): [RFC 9110](https://www.rfc-editor.org/rfc/rfc9110#name-user-agent) product tokens, the first of which **must** be `epistola-contract/{version}`, the contract version the client was built against. Further tokens describe the rest of the stack: `epistola-contract/x.y.z valtimo-epistola-plugin/1.2.0 gzac/5.0.0`. - **`X-EP-Node-Id`** (required): the client node, such as its Kubernetes pod name, container id or hostname. The client libraries set both, the contract version and the hostname; an application can append its own product tokens and override the node id. ## Releases A catalog consists of releases, addressed as `/catalogs/{registry}/{namespace}/{catalogKey}/releases/{release}`, with the catalog\'s resources below each. A draft is addressed by its `releaseId`; a released release by its `releaseId` or its version, which address the same release. Every write to a released release is refused with 409. - A catalog that can be changed has **any number of drafts**, each named, each started from a released release (its base) or from another draft (`createCatalogRelease`). The base never moves. `listCatalogReleases` lists a catalog\'s releases, drafts included, each with its `status` (`?status=draft` for the drafts only) and, once released, its `contentHash` (`?contentHash=` for the releases with that content); a catalog (`CatalogDto`) does not list them. - **Any draft can be released.** Its version follows from the kind of change against its base: fixes raise the patch, additions the minor, anything that breaks callers the major (`previewCatalogDraftRelease`). The author may choose a higher version, never a lower one or one another release has. A fix to an older line is a draft from a release of that line: from `1.4.0`, while `1.5.0` and `2.0.0` exist, it is released as `1.4.1`. - **Drafts are independent copies**: releasing one changes no other. A draft is **behind** each release whose version is between its base and the version it would get, and each release released after it was started whose version is below that one; it lacks their changes unless an author applied them by hand. `getCatalogRelease` lists them, and releasing a draft that is behind must acknowledge them. - **Merging a release into a draft** (alpha, `x-experimental`): `previewCatalogDraftMerge` shows, per resource, per catalog setting (default theme and presets, entries of type `catalog`) and per catalog used (entries of type `catalogDependency`), each with the entries it goes with (`needs`), against the merge base (the closest release both descend from), what only the draft changed (`ours`), what only the release changed (`theirs`) and what both changed differently (`conflict`); `mergeIntoCatalogDraft` takes theirs and applies a resolution, `ours` or `theirs`, per conflict. The draft then contains the release and is no longer behind it; its base does not move. The preview\'s `token`, sent back as `expectedToken`, makes the merge apply what the preview showed or nothing (`merge-preview-outdated`). A conflict can also be resolved to content combined from its sides (`getCatalogDraftMergeSides`, then `mergedContent`), reviewed before the draft is released. The merge needs the merge base installed; the preview names one that is not (`missingBase`), and the merge is refused with `merge-base-missing`. - **Release registries** (alpha, `x-experimental`, ADR 0008) move releases between installations: an Epistola Exchange the installation is connected to, or a container registry it is configured with (`listReleaseRegistries`). A released release is published to one (`publishReleaseToRegistry`), and another installation lists the releases of a catalog there (`listRegistryReleases`) and installs one (`installRegistryRelease`) as an import does. A release registry is named by the installation; it is not the `{registry}` of a catalog\'s name. - **Quality profiles** (alpha, `x-experimental`, contract ADR 0010) record how an organisation writes: rules with a plain-language intent, a severity and extras per kind of checking system (`listQualityProfiles` and the rest of the group). A release binds the profiles every template in it is checked against, and a template adds its own (`quality` on `CatalogReleaseDto` and `TemplateDto`). Documents are rendered from releases, and a version range never matches a draft. A draft renders only in a preview that names its `releaseId`, and in an environment it is deployed to. Importing a catalog archive (`importCatalog`) installs the release the archive carries, at its version, beside the releases the tenant already has; it never creates or changes a draft. A catalog with a source (`CatalogDto.source`) installs releases from it the same way (`installCatalogRelease`), and `listAvailableCatalogReleases` lists those the tenant does not have yet, older lines included. Nothing is updated in place or removed: deploying decides what an environment serves. A release keeps its id and number wherever it moves, so it is the same release in every installation. There are no catalog types: receiving releases works whether or not the catalog can be changed, and every write to one that cannot is refused with 409 `catalog-read-only`. ## Deploying An environment serves releases of catalogs (`deployCatalogRelease`): released ones, several of one catalog if need be, and at most one draft per catalog, rendered live. A request through the environment (`environmentKey`) renders: - with **no `versionRange`**: the catalog\'s deployed draft if there is one, else the highest release the environment serves; - with a **range or an exact version**: the highest served release that satisfies it. A draft never matches: it has no version. Rollback is undeploying the newer release. Deploying a draft replaces the draft the environment served for that catalog, and an environment marked **production** (`EnvironmentDto.production`) serves no draft. A document rendered from a draft carries the draft\'s `releaseId` and its name at render time (`releaseName`), with a null `version`, and its PDF a preview watermark. Releasing a deployed draft keeps its `releaseId`, so the environment then serves it as released; discarding the draft ends the deployment. ## Versions and version ranges A version (`ReleaseVersion`) is a SemVer core version, `MAJOR.MINOR.PATCH` without leading zeros, as the holder of the catalog\'s namespace issues it, or a **patch release** number, `MAJOR.MINOR.PATCH-<namespace>.<N>`, at most 128 characters. Wherever the contract names one exact version it has that form, and is called `version`; every member called `version` is one. A patch release is how someone who does not hold a catalog\'s namespace fixes a release of it (a municipality fixing a supplier\'s catalog): it is labelled with a namespace they hold, and numbered from 1, `1.3.1-gemeente-x.1`. As a SemVer pre-release it sorts below its core and above every release below that, `1.3.0` < `1.3.1-gemeente-x.1` < `1.3.1`, so the holder\'s next release supersedes it, and the two never collide: the holder never uses a label, the patcher never issues a plain number (contract ADR 0003). Which namespaces a tenant holds is the installation\'s to know; the contract checks the shape. \"Highest\" always means by this order, a patch release included. A request that selects a release to render or check (generation, preview, validation) takes a version range, `versionRange`, in the npm SemVer range grammar: an exact version (`1.4.0`), a caret (`^1.4.0`), a tilde (`~1.4.0`), comparators (`>=1.0.0 <2.0.0`), a hyphen range (`1.0.0 - 2.0.0`), or a `||` union of these. The highest release that satisfies it renders, and responses name the exact release used. A range is at most 256 characters, so an exact release number (at most 128) always fits, and a comparator pair of patch release numbers usually does. A range matches a patch release as npm matches a pre-release: only when one of its comparators names a pre-release of the same `MAJOR.MINOR.PATCH`, such as the exact number (`1.3.1-gemeente-x.1`) or `>=1.3.1-gemeente-x.1 <1.4.0`; `^1.3.0` never selects one. ## Catalog dependencies A catalog that uses another catalog\'s resources declares that catalog once, with the exact release of it that it renders with (`version`), never a range. References into the other catalog name the catalog but no version, so a release renders with exactly the releases its declarations pin. In a draft, a declaration may name a draft of the other catalog instead (`releaseId`), to build on work that is not released yet. A released release pins only released releases: releasing such a draft is refused (`release-dependencies-unreleased`) unless the request releases those drafts along with it (`releaseDependencies`), in one transaction. ## Catalog identity A catalog\'s key alone is not unique: two publishers can each publish `letters`. The registry and the namespace complete its name, and the same namespace in two registries is two namespaces. Which registry is a server\'s default is configuration; in a path, `/catalogs/~/acme-corp/letters/…` and `/catalogs/exchange.epistola.app/acme-corp/letters/…` address the same catalog when `exchange.epistola.app` is the default, and `~` may be sent percent-encoded as `%7E`. In a body, a catalog is named by separate `registry`, `namespace` and `catalogKey` members, and a reference into another catalog by an alias: 1. **A request that names a catalog** (a generation or preview target, a dependency declaration) may omit `registry`, or send null, for the default registry. (An import\'s `registry` defaults to the one the archive names.) 2. **A reference from one catalog\'s release to a resource of another** names that catalog by the **alias** the release\'s dependency declarations give it (`CatalogAlias`, in the member `catalogKey`), never by registry or namespace: a template model\'s `themeRef`, its stencil and image nodes, a `fontFamily` (catalog content, portable catalog wire v8, contract ADR 0003), and the references this API reads and writes beside it, a release\'s default theme (`CatalogThemeReference`), an attribute\'s code-list binding and an attribute criterion in variant selection (`VariantSelectionAttribute`, resolved through the release that renders). Omitted or null, or the catalog\'s own key, is the catalog itself. A declaration (`CatalogDependencyDto`, `listCatalogDependencies`) maps each alias to the catalog\'s full name and the release it pins; that is where a client finds the name. Because content names the alias, it means the same in every installation and under any name, and pinning another release changes no content. An alias is by default the catalog\'s key (`CatalogDependencyRequirement.alias`). Responses write every registry in full, by its name, never `~`, so a value read from one installation means the same catalog on another. Content documents are returned as stored. ## Concurrency Updates can be made conditional. Templates, variants, themes, stencils, code lists, attributes, releases, environments, tenants and consumers carry a revision, which reading or updating one returns as a strong `ETag` header: a quoted decimal integer such as `\"7\"`. Send it back as `If-Match` on an update: if the resource changed since you read it, the update is refused with 412 `resource-modified` and nothing changes; read it again, reapply your change and retry. Without `If-Match` an update applies unconditionally, and the last write wins. What a revision covers: - a template: its own properties, data contract and data examples; - a variant: its name, description, attributes and template model, so `getVariant` and `getVariantContent` return the same `ETag`, and `updateVariant` and `updateVariantContent` take either; - a release: its name, default theme, presets and dependency declarations, so `getCatalogRelease` and `listCatalogDependencies` return the same `ETag`, and `updateCatalogRelease` and `updateCatalogDependencies` take either; - a code list: its properties and entries, whether each is hidden included, so `updateCodeListEntryHidden` takes the code list\'s `ETag`; - an environment: its name and production mark, not what it serves. ## Authentication Credentials go in the `Authorization` header: - **API key**, `Authorization: ApiKey <key>`: the supported method. A tenant manager issues each key for one tenant, with a set of tenant roles. The scheme name is case-insensitive. - **Bearer JWT** (**experimental**), `Authorization: Bearer <jwt>`: issued by an OAuth 2.0 identity provider, or self-signed with a key pair registered through the Consumers API. The [authentication guide](https://github.com/epistola-app/epistola-contract/blob/main/contracts/api/docs/auth.md) has the details. ## Authorization Each operation names the permissions it requires (`x-required-permissions`), such as `TEMPLATE_VIEW`, `TEMPLATE_EDIT`, `DOCUMENT_GENERATE` and `CATALOG_MANAGE`. A caller has them through its tenant roles (`CONTENT_VIEWER`, `CONTENT_AUTHOR`, `DOCUMENT_GENERATOR`, `DOCUMENT_READER`, `CONTENT_PUBLISHER`, `TENANT_ADMINISTRATOR`), the roles stored on its API key. Managing tenants needs the platform role `TENANT_MANAGER`. A request member that needs a permission beyond its operation\'s says so in its description: changing a quality binding (`quality`, alpha) needs `QUALITY_EDIT` as well. ## Errors Errors are [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) problem details, with `Content-Type: application/problem+json`: - `type` (URI): what went wrong, the stable value to switch on. It is `https://epistola.app/errors/{slug}`, which documents the problem type; - `title`: a short summary; - `status`: the HTTP status code; - `detail` (optional): what happened this time; - `instance` (optional): this occurrence; - `help` (optional): the type\'s page with this request\'s context, such as the `operation` that answered, for hints that fit it. It names this contract\'s terms only, never a value. A problem may add members of its own, such as the field-level `errors` of a `validation-error`; ignore members you do not recognize. The problem types are listed, machine-readably, in this document\'s `x-problem-types` extension, and in the [error type registry](https://github.com/epistola-app/epistola-contract/blob/main/contracts/api/docs/error-types.md). A server answers only with the types registered there. A type names a problem a caller can act on differently; anything else is the generic type of its status, so a missing resource is `not-found` whichever resource it is, and a refused authorization `forbidden`. New types may be added in a minor version: handle a type you do not recognize by its `status`, as the generic type of that status, and keep a fallback when switching on them. Six statuses are not listed on each operation, because any operation may answer them: 405 `method-not-allowed`, 406 `not-acceptable`, 413 `content-too-large` and 415 `unsupported-media-type` (the last two where it takes a body), 500 `internal-error`, and 501 `operation-not-implemented`. `x-problem-types` marks them `anyOperation: true`. ## Compatibility within 2.x A minor version adds and never takes away, so a client built against an earlier 2.x keeps working against a later 2.x server. A minor version may add: - operations, and optional request members and query parameters; - **response members**: ignore a member you do not recognize; - **enum values in responses**: a status, kind or reason may gain a value. Treat one you do not recognize as unknown rather than failing, and keep a default branch when switching on an enum. The client libraries read it without failing: the Kotlin, Jakarta and .NET enums as their `unknown_default_open_api` member (`UNKNOWN_DEFAULT_OPEN_API` in Jakarta, `UnknownDefaultOpenApi` in .NET), the Python client as an unknown member that keeps the value, and the Node.js client as the string received; - problem types and validation codes (see \"Errors\"); - roles and permissions (`x-authorization`), and resources and levels of a consumer\'s permissions (`ConsumerPermissions`). An operation keeps requiring what it required: when a minor version moves an operation to a new permission, every role that granted the old one grants the new one; - a catalog wire version (`x-epistola-catalog-contract`). Every new component type and every new member of a template document (`TemplateDocument`, `Node`, `Slot`) raises it. An installation refuses an archive of a newer wire version as a whole (`CATALOG_SCHEMA_TOO_NEW`), rather than reading part of it. It never removes or renames a member or an enum value, makes an optional request member required, or narrows what a request may send. A server refuses a request enum value it does not know with 400, so never send `unknown_default_open_api`. Operations and members marked `x-experimental` are outside these rules. A minor version adds members and parameters only after the existing ones, so the positional arguments of the generated clients keep their meaning; a major version may reorder them. A new optional parameter or member still changes the generated method and constructor signatures: rebuild against the client library you ship with, which may then ask for code changes, rather than replace its binary. A client that reads a template document and writes it back (`getVariantContent` and `updateVariantContent`, and the same for stencils) sends only the members it knows, and the write replaces the document. Edit template documents with a client at least as new as the server\'s catalog wire version, or the members it does not know are lost. ## Experimental parts and server support Operations and members marked `x-experimental: true`, the consumer model (Bearer JWT and the Consumers API) among them, may still change. Epistola Suite, the server that implements this contract, may not implement them yet, nor every part of the rest: installing missing dependency releases when deploying, recording who requested a document, listing a stencil\'s usage in a released release, and a dependency alias other than the catalog\'s key among them. An operation a server does not implement yet answers 501 `operation-not-implemented`.
4
4
  *
5
- * The version of the OpenAPI document: 2.0.0-beta.3
5
+ * The version of the OpenAPI document: 2.0.0-rc.1
6
6
  *
7
7
  *
8
8
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).