@eventcatalog/core 4.10.13 → 4.10.14

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 (160) hide show
  1. package/dist/analytics/analytics.cjs +1 -1
  2. package/dist/analytics/analytics.js +2 -2
  3. package/dist/analytics/log-build.cjs +1 -1
  4. package/dist/analytics/log-build.js +3 -3
  5. package/dist/{chunk-SSSN5FXC.js → chunk-HERAHLM2.js} +1 -1
  6. package/dist/{chunk-IIECZFXN.js → chunk-LITOQH56.js} +1 -1
  7. package/dist/{chunk-34RMFKFB.js → chunk-LUW6RDA7.js} +1 -1
  8. package/dist/{chunk-JHUICVBT.js → chunk-ONDFEA5R.js} +1 -1
  9. package/dist/{chunk-PADMH2RJ.js → chunk-V2SKOQYF.js} +1 -1
  10. package/dist/constants.cjs +1 -1
  11. package/dist/constants.js +1 -1
  12. package/dist/docs/api/02-config.md +55 -1
  13. package/dist/docs/development/authentication/providers/03-setting-up-github.md +29 -0
  14. package/dist/docs/development/bring-your-own-documentation/custom-pages/02-adding-custom-docs.md +2 -2
  15. package/dist/docs/development/bring-your-own-documentation/custom-pages/03-components.md +17 -0
  16. package/dist/docs/development/components/07-resource-references.md +7 -1
  17. package/dist/docs/development/components/components/05-architecture-graph.md +65 -0
  18. package/dist/docs/development/components/components/{05-attachments.md → 06-attachments.md} +1 -1
  19. package/dist/docs/development/components/components/{06-channel-information.md → 07-channel-information.md} +1 -1
  20. package/dist/docs/development/components/components/{07-custom-properties.md → 08-custom-properties.md} +1 -1
  21. package/dist/docs/development/components/components/{08-design.md → 09-design.md} +1 -1
  22. package/dist/docs/development/components/components/{09-entitymap.md → 10-entitymap.md} +1 -1
  23. package/dist/docs/development/components/components/{10-flow.md → 11-flow.md} +1 -1
  24. package/dist/docs/development/components/components/{11-link.md → 12-link.md} +1 -1
  25. package/dist/docs/development/components/components/{12-mermaid-file-loader.md → 13-mermaid-file-loader.md} +1 -1
  26. package/dist/docs/development/components/components/{13-message-table.md → 14-message-table.md} +1 -1
  27. package/dist/docs/development/components/components/{14-nodegraph.md → 15-nodegraph.md} +1 -1
  28. package/dist/docs/development/components/components/{15-openapi.md → 16-openapi.md} +1 -1
  29. package/dist/docs/development/components/components/{16-prompt.md → 17-prompt.md} +1 -1
  30. package/dist/docs/development/components/components/{17-remote-schema.md → 18-remote-schema.md} +1 -1
  31. package/dist/docs/development/components/components/{18-resource-group-table.md → 19-resource-group-table.md} +1 -1
  32. package/dist/docs/development/components/components/{19-resource-link.md → 20-resource-link.md} +1 -1
  33. package/dist/docs/development/components/components/{20-schema.md → 21-schema.md} +1 -1
  34. package/dist/docs/development/components/components/{21-schema-viewer.md → 22-schema-viewer.md} +1 -1
  35. package/dist/docs/development/components/components/{22-steps.md → 23-steps.md} +1 -1
  36. package/dist/docs/development/components/components/{23-tabs.md → 24-tabs.md} +1 -1
  37. package/dist/docs/development/components/components/{24-tiles.md → 25-tiles.md} +1 -1
  38. package/dist/docs/development/components/components/{25-visibility.md → 26-visibility.md} +1 -1
  39. package/dist/docs/development/customization/04-documentation-sidebar.md +3 -3
  40. package/dist/docs/development/customization/05-resource-sidebar.md +235 -0
  41. package/dist/docs/development/customization/09-embed-eventcatalog.md +179 -0
  42. package/dist/docs/development/customization/_category_.json +1 -1
  43. package/dist/docs/development/deployment/build-and-deploy.md +4 -0
  44. package/dist/docs/development/deployment/hosting-options.md +1 -1
  45. package/dist/docs/development/deployment/link-validation.md +105 -0
  46. package/dist/docs/development/developer-tools/eventcatalog-linter/00-overview.md +76 -0
  47. package/dist/docs/development/developer-tools/eventcatalog-linter/01-setup.md +144 -0
  48. package/dist/docs/development/developer-tools/eventcatalog-linter/_category_.json +10 -0
  49. package/dist/docs/development/developer-tools/eventcatalog-linter/how-to/01-configure-rules.md +130 -0
  50. package/dist/docs/development/developer-tools/eventcatalog-linter/how-to/02-run-in-ci.md +93 -0
  51. package/dist/docs/development/developer-tools/eventcatalog-linter/how-to/03-use-custom-frontmatter.md +81 -0
  52. package/dist/docs/development/developer-tools/eventcatalog-linter/how-to/04-reference-external-catalogs.md +51 -0
  53. package/dist/docs/development/developer-tools/eventcatalog-linter/how-to/05-fix-common-problems.md +120 -0
  54. package/dist/docs/development/developer-tools/eventcatalog-linter/how-to/_category_.json +12 -0
  55. package/dist/docs/development/developer-tools/eventcatalog-linter/reference/01-cli.md +109 -0
  56. package/dist/docs/development/developer-tools/eventcatalog-linter/reference/02-configuration.md +120 -0
  57. package/dist/docs/development/developer-tools/eventcatalog-linter/reference/03-rules.md +287 -0
  58. package/dist/docs/development/developer-tools/eventcatalog-linter/reference/04-versions.md +77 -0
  59. package/dist/docs/development/developer-tools/eventcatalog-linter/reference/05-supported-resources.md +75 -0
  60. package/dist/docs/development/developer-tools/eventcatalog-linter/reference/_category_.json +12 -0
  61. package/dist/docs/development/guides/97-architecture-graph.md +78 -0
  62. package/dist/docs/development/guides/domains/02-create-domain.md +1 -1
  63. package/dist/docs/development/guides/domains/03-ownership-and-language/02-adding-ubiquitous-language.md +29 -0
  64. package/dist/docs/development/guides/domains/09-reference.md +10 -0
  65. package/dist/docs/development/guides/resources/messages/04-message-channels/02-adding-channels.md +2 -2
  66. package/dist/docs/development/guides/resources/messages/04-message-channels/04-adding-messages-to-services.md +8 -0
  67. package/dist/docs/development/guides/resources/schemas/03-add-specifications-to-services/01-add-openapi-specifications.md +2 -2
  68. package/dist/docs/development/guides/resources/schemas/03-add-specifications-to-services/02-add-asyncapi-specifications.md +3 -3
  69. package/dist/docs/development/guides/systems/05-system-context-maps.md +2 -0
  70. package/dist/docs/development/license-keys/license-validation.md +7 -3
  71. package/dist/docs/development/license-keys/overview.md +7 -3
  72. package/dist/docs/development/upgrading/upgrading.md +3 -3
  73. package/dist/docs/development/upgrading/v2.md +3 -3
  74. package/dist/docs/federation/00-overview.md +158 -0
  75. package/dist/docs/federation/01-first-federation.md +199 -0
  76. package/dist/docs/federation/_category_.json +12 -0
  77. package/dist/docs/federation/explanation/_category_.json +12 -0
  78. package/dist/docs/federation/explanation/how-it-works.md +129 -0
  79. package/dist/docs/federation/explanation/lockfile-and-cache.md +134 -0
  80. package/dist/docs/federation/explanation/mvp-status-and-feedback.md +86 -0
  81. package/dist/docs/federation/explanation/ownership-and-references.md +134 -0
  82. package/dist/docs/federation/how-to/_category_.json +12 -0
  83. package/dist/docs/federation/how-to/configure-github-sources.md +156 -0
  84. package/dist/docs/federation/how-to/configure-validation-rules.md +127 -0
  85. package/dist/docs/federation/how-to/run-in-ci.md +138 -0
  86. package/dist/docs/federation/how-to/share-assets-and-components.md +125 -0
  87. package/dist/docs/federation/how-to/use-local-sources.md +138 -0
  88. package/dist/docs/{plugins/eventcatalog-federation → federation/legacy-federation}/00-introduction.md +11 -2
  89. package/dist/docs/{plugins/eventcatalog-federation → federation/legacy-federation}/01-installation.md +11 -3
  90. package/dist/docs/{plugins/eventcatalog-federation → federation/legacy-federation}/02-plugin-configuration.md +11 -2
  91. package/dist/docs/{plugins/eventcatalog-federation → federation/legacy-federation}/03-examples.md +11 -1
  92. package/dist/docs/{plugins/eventcatalog-federation → federation/legacy-federation}/04-configuration.md +11 -1
  93. package/dist/docs/{plugins/eventcatalog-federation → federation/legacy-federation}/05-setup-team-catalog.md +11 -2
  94. package/dist/docs/federation/legacy-federation/_category_.json +12 -0
  95. package/dist/docs/federation/reference/_category_.json +12 -0
  96. package/dist/docs/federation/reference/cli.md +122 -0
  97. package/dist/docs/federation/reference/configuration.md +192 -0
  98. package/dist/docs/federation/reference/diagnostic-rules.md +173 -0
  99. package/dist/docs/federation/reference/generated-output.md +118 -0
  100. package/dist/docs/federation/reference/supported-content.md +86 -0
  101. package/dist/docs/federation/reference/troubleshooting.md +208 -0
  102. package/dist/docs/plugins/01-intro.md +3 -3
  103. package/dist/docs/plugins/03-all-plugins.md +2 -2
  104. package/dist/docs/plugins/asyncapi/00-intro.md +4 -4
  105. package/dist/docs/plugins/asyncapi/02-plugin-configuration.md +4 -4
  106. package/dist/docs/plugins/backstage/00-overview.md +53 -0
  107. package/dist/docs/plugins/backstage/01-get-started.md +95 -0
  108. package/dist/docs/plugins/backstage/02-embed-entity-tabs.md +109 -0
  109. package/dist/docs/plugins/backstage/03-add-overview-cards.md +79 -0
  110. package/dist/docs/plugins/backstage/04-control-theme-and-size.md +54 -0
  111. package/dist/docs/plugins/backstage/05-migrate-to-annotations.md +49 -0
  112. package/dist/docs/plugins/backstage/06-configuration.md +85 -0
  113. package/dist/docs/plugins/backstage/07-components.md +129 -0
  114. package/dist/docs/plugins/backstage/08-how-embeds-work.md +52 -0
  115. package/dist/docs/plugins/backstage/_category_.json +4 -3
  116. package/dist/docs/plugins/eventbridge/00-intro.md +5 -5
  117. package/dist/docs/plugins/eventbridge/03-api.md +3 -3
  118. package/dist/docs/plugins/graphql/00-intro.md +2 -2
  119. package/dist/docs/plugins/graphql/02-plugin-configuration.md +2 -2
  120. package/dist/docs/plugins/hookdeck/01-intro.md +1 -1
  121. package/dist/docs/plugins/openapi/00-intro.md +1 -1
  122. package/dist/eventcatalog.cjs +1 -1
  123. package/dist/eventcatalog.js +5 -5
  124. package/dist/generate.cjs +1 -1
  125. package/dist/generate.js +3 -3
  126. package/dist/utils/cli-logger.cjs +1 -1
  127. package/dist/utils/cli-logger.js +2 -2
  128. package/eventcatalog/src/components/SchemaExplorer/AvroSchemaViewer.tsx +21 -19
  129. package/eventcatalog/src/components/SchemaExplorer/JSONSchemaViewer.tsx +79 -77
  130. package/eventcatalog/src/components/SchemaExplorer/ProtobufSchemaViewer.test.tsx +91 -0
  131. package/eventcatalog/src/components/SchemaExplorer/ProtobufSchemaViewer.tsx +115 -33
  132. package/eventcatalog/src/components/SchemaExplorer/SchemaViewerHover.test.tsx +33 -0
  133. package/eventcatalog/src/components/SchemaExplorer/protobuf-validation.test.ts +84 -0
  134. package/eventcatalog/src/components/SchemaExplorer/protobuf-validation.ts +149 -0
  135. package/eventcatalog/src/utils/protobuf-schema.ts +211 -16
  136. package/package.json +3 -3
  137. package/dist/docs/cli/channels.md +0 -180
  138. package/dist/docs/cli/commands.md +0 -183
  139. package/dist/docs/cli/custom-docs.md +0 -78
  140. package/dist/docs/cli/data-products.md +0 -177
  141. package/dist/docs/cli/data-stores.md +0 -166
  142. package/dist/docs/cli/diagrams.md +0 -147
  143. package/dist/docs/cli/domains.md +0 -280
  144. package/dist/docs/cli/entities.md +0 -138
  145. package/dist/docs/cli/events.md +0 -186
  146. package/dist/docs/cli/export.md +0 -27
  147. package/dist/docs/cli/governance.md +0 -24
  148. package/dist/docs/cli/messages.md +0 -69
  149. package/dist/docs/cli/queries.md +0 -183
  150. package/dist/docs/cli/services.md +0 -266
  151. package/dist/docs/cli/snapshots.md +0 -44
  152. package/dist/docs/cli/teams.md +0 -75
  153. package/dist/docs/cli/users.md +0 -75
  154. package/dist/docs/cli/utilities.md +0 -43
  155. package/dist/docs/development/developer-tools/eventcatalog-linter.md +0 -732
  156. package/dist/docs/plugins/backstage/00-intro.md +0 -67
  157. package/dist/docs/plugins/backstage/01-installation.md +0 -242
  158. package/dist/docs/plugins/backstage/02-api.md +0 -51
  159. package/dist/docs/plugins/backstage/03-examples.md +0 -12
  160. package/dist/docs/plugins/eventcatalog-federation/_category_.json +0 -11
@@ -1,280 +0,0 @@
1
- ---
2
- id: cli-domains
3
- title: Domains
4
- sidebar_label: Domains
5
- sidebar_position: 6
6
- ---
7
-
8
- # Domains CLI Commands
9
-
10
- Manage domains in your EventCatalog from the command line.
11
-
12
- ## getDomain
13
-
14
- Returns a domain from EventCatalog by its ID
15
-
16
- **Arguments:**
17
- | Name | Type | Required | Description |
18
- |------|------|----------|-------------|
19
- | id | string | Yes | The ID of the domain to retrieve |
20
- | version | string | No | Specific version to retrieve |
21
-
22
- **Examples:**
23
-
24
- ```bash
25
- # Get the latest domain
26
- npx @eventcatalog/cli getDomain "Orders"
27
-
28
- # Get a specific version
29
- npx @eventcatalog/cli getDomain "Orders" "1.0.0"
30
- ```
31
-
32
- ---
33
-
34
- ## getDomains
35
-
36
- Returns all domains from EventCatalog
37
-
38
- **Arguments:**
39
- | Name | Type | Required | Description |
40
- |------|------|----------|-------------|
41
- | options | json | No | Options: {latestOnly?} |
42
-
43
- **Examples:**
44
-
45
- ```bash
46
- # Get all domains
47
- npx @eventcatalog/cli getDomains
48
- ```
49
-
50
- ---
51
-
52
- ## writeDomain
53
-
54
- Writes a domain to EventCatalog
55
-
56
- **Arguments:**
57
- | Name | Type | Required | Description |
58
- |------|------|----------|-------------|
59
- | domain | json | Yes | Domain object with id, name, version, and markdown |
60
- | options | json | No | Options: {path?, override?, versionExistingContent?} |
61
-
62
-
63
-
64
- ---
65
-
66
- ## rmDomain
67
-
68
- Removes a domain by its path
69
-
70
- **Arguments:**
71
- | Name | Type | Required | Description |
72
- |------|------|----------|-------------|
73
- | path | string | Yes | Path to the domain |
74
-
75
- **Examples:**
76
-
77
- ```bash
78
- # Remove a domain
79
- npx @eventcatalog/cli rmDomain "/Orders"
80
- ```
81
-
82
- ---
83
-
84
- ## rmDomainById
85
-
86
- Removes a domain by its ID
87
-
88
- **Arguments:**
89
- | Name | Type | Required | Description |
90
- |------|------|----------|-------------|
91
- | id | string | Yes | The ID of the domain to remove |
92
- | version | string | No | Specific version to remove |
93
-
94
- **Examples:**
95
-
96
- ```bash
97
- # Remove a domain
98
- npx @eventcatalog/cli rmDomainById "Orders"
99
- ```
100
-
101
- ---
102
-
103
- ## versionDomain
104
-
105
- Moves the current domain to a versioned directory
106
-
107
- **Arguments:**
108
- | Name | Type | Required | Description |
109
- |------|------|----------|-------------|
110
- | id | string | Yes | The ID of the domain to version |
111
-
112
- **Examples:**
113
-
114
- ```bash
115
- # Version a domain
116
- npx @eventcatalog/cli versionDomain "Orders"
117
- ```
118
-
119
- ---
120
-
121
- ## addFileToDomain
122
-
123
- Adds a file to a domain
124
-
125
- **Arguments:**
126
- | Name | Type | Required | Description |
127
- |------|------|----------|-------------|
128
- | id | string | Yes | The ID of the domain |
129
- | file | json | Yes | File object: {content, fileName} |
130
- | version | string | No | Specific version |
131
-
132
-
133
-
134
- ---
135
-
136
- ## addServiceToDomain
137
-
138
- Adds a service to a domain
139
-
140
- **Arguments:**
141
- | Name | Type | Required | Description |
142
- |------|------|----------|-------------|
143
- | domainId | string | Yes | The ID of the domain |
144
- | service | json | Yes | Service reference: {id, version} |
145
- | domainVersion | string | No | Specific domain version |
146
-
147
-
148
-
149
- ---
150
-
151
- ## addSubDomainToDomain
152
-
153
- Adds a subdomain to a domain
154
-
155
- **Arguments:**
156
- | Name | Type | Required | Description |
157
- |------|------|----------|-------------|
158
- | domainId | string | Yes | The ID of the parent domain |
159
- | subDomain | json | Yes | Subdomain reference: {id, version} |
160
- | domainVersion | string | No | Specific domain version |
161
-
162
-
163
-
164
- ---
165
-
166
- ## addEntityToDomain
167
-
168
- Adds an entity to a domain
169
-
170
- **Arguments:**
171
- | Name | Type | Required | Description |
172
- |------|------|----------|-------------|
173
- | domainId | string | Yes | The ID of the domain |
174
- | entity | json | Yes | Entity reference: {id, version} |
175
- | domainVersion | string | No | Specific domain version |
176
-
177
-
178
-
179
- ---
180
-
181
- ## addEventToDomain
182
-
183
- Adds an event relationship to a domain
184
-
185
- **Arguments:**
186
- | Name | Type | Required | Description |
187
- |------|------|----------|-------------|
188
- | domainId | string | Yes | The ID of the domain |
189
- | direction | string | Yes | Direction: "sends" or "receives" |
190
- | event | json | Yes | Event reference: {id, version} |
191
- | domainVersion | string | No | Specific domain version |
192
-
193
-
194
-
195
- ---
196
-
197
- ## addCommandToDomain
198
-
199
- Adds a command relationship to a domain
200
-
201
- **Arguments:**
202
- | Name | Type | Required | Description |
203
- |------|------|----------|-------------|
204
- | domainId | string | Yes | The ID of the domain |
205
- | direction | string | Yes | Direction: "sends" or "receives" |
206
- | command | json | Yes | Command reference: {id, version} |
207
- | domainVersion | string | No | Specific domain version |
208
-
209
-
210
-
211
- ---
212
-
213
- ## addQueryToDomain
214
-
215
- Adds a query relationship to a domain
216
-
217
- **Arguments:**
218
- | Name | Type | Required | Description |
219
- |------|------|----------|-------------|
220
- | domainId | string | Yes | The ID of the domain |
221
- | direction | string | Yes | Direction: "sends" or "receives" |
222
- | query | json | Yes | Query reference: {id, version} |
223
- | domainVersion | string | No | Specific domain version |
224
-
225
-
226
-
227
- ---
228
-
229
- ## addUbiquitousLanguageToDomain
230
-
231
- Adds ubiquitous language definitions to a domain
232
-
233
- **Arguments:**
234
- | Name | Type | Required | Description |
235
- |------|------|----------|-------------|
236
- | domainId | string | Yes | The ID of the domain |
237
- | dictionary | json | Yes | Array of {term, definition} objects |
238
- | domainVersion | string | No | Specific domain version |
239
-
240
-
241
-
242
- ---
243
-
244
- ## getUbiquitousLanguageFromDomain
245
-
246
- Gets ubiquitous language definitions from a domain
247
-
248
- **Arguments:**
249
- | Name | Type | Required | Description |
250
- |------|------|----------|-------------|
251
- | domainId | string | Yes | The ID of the domain |
252
- | domainVersion | string | No | Specific domain version |
253
-
254
- **Examples:**
255
-
256
- ```bash
257
- # Get ubiquitous language
258
- npx @eventcatalog/cli getUbiquitousLanguageFromDomain "Orders"
259
- ```
260
-
261
- ---
262
-
263
- ## domainHasVersion
264
-
265
- Checks if a specific version of a domain exists
266
-
267
- **Arguments:**
268
- | Name | Type | Required | Description |
269
- |------|------|----------|-------------|
270
- | id | string | Yes | The ID of the domain |
271
- | version | string | Yes | Version to check |
272
-
273
- **Examples:**
274
-
275
- ```bash
276
- # Check if version exists
277
- npx @eventcatalog/cli domainHasVersion "Orders" "1.0.0"
278
- ```
279
-
280
- ---
@@ -1,138 +0,0 @@
1
- ---
2
- id: cli-entities
3
- title: Entities
4
- sidebar_label: Entities
5
- sidebar_position: 11
6
- ---
7
-
8
- # Entities CLI Commands
9
-
10
- Manage entities in your EventCatalog from the command line.
11
-
12
- ## getEntity
13
-
14
- Returns an entity from EventCatalog by its ID
15
-
16
- **Arguments:**
17
- | Name | Type | Required | Description |
18
- |------|------|----------|-------------|
19
- | id | string | Yes | The ID of the entity to retrieve |
20
- | version | string | No | Specific version to retrieve |
21
-
22
- **Examples:**
23
-
24
- ```bash
25
- # Get the latest entity
26
- npx @eventcatalog/cli getEntity "Order"
27
-
28
- # Get a specific version
29
- npx @eventcatalog/cli getEntity "Order" "1.0.0"
30
- ```
31
-
32
- ---
33
-
34
- ## getEntities
35
-
36
- Returns all entities from EventCatalog
37
-
38
- **Arguments:**
39
- | Name | Type | Required | Description |
40
- |------|------|----------|-------------|
41
- | options | json | No | Options: {latestOnly?} |
42
-
43
- **Examples:**
44
-
45
- ```bash
46
- # Get all entities
47
- npx @eventcatalog/cli getEntities
48
- ```
49
-
50
- ---
51
-
52
- ## writeEntity
53
-
54
- Writes an entity to EventCatalog
55
-
56
- **Arguments:**
57
- | Name | Type | Required | Description |
58
- |------|------|----------|-------------|
59
- | entity | json | Yes | Entity object with id, name, version, and markdown |
60
- | options | json | No | Options: {path?, override?, versionExistingContent?} |
61
-
62
-
63
-
64
- ---
65
-
66
- ## rmEntity
67
-
68
- Removes an entity by its path
69
-
70
- **Arguments:**
71
- | Name | Type | Required | Description |
72
- |------|------|----------|-------------|
73
- | path | string | Yes | Path to the entity |
74
-
75
- **Examples:**
76
-
77
- ```bash
78
- # Remove an entity
79
- npx @eventcatalog/cli rmEntity "/Order"
80
- ```
81
-
82
- ---
83
-
84
- ## rmEntityById
85
-
86
- Removes an entity by its ID
87
-
88
- **Arguments:**
89
- | Name | Type | Required | Description |
90
- |------|------|----------|-------------|
91
- | id | string | Yes | The ID of the entity to remove |
92
- | version | string | No | Specific version to remove |
93
-
94
- **Examples:**
95
-
96
- ```bash
97
- # Remove an entity
98
- npx @eventcatalog/cli rmEntityById "Order"
99
- ```
100
-
101
- ---
102
-
103
- ## versionEntity
104
-
105
- Moves the current entity to a versioned directory
106
-
107
- **Arguments:**
108
- | Name | Type | Required | Description |
109
- |------|------|----------|-------------|
110
- | id | string | Yes | The ID of the entity to version |
111
-
112
- **Examples:**
113
-
114
- ```bash
115
- # Version an entity
116
- npx @eventcatalog/cli versionEntity "Order"
117
- ```
118
-
119
- ---
120
-
121
- ## entityHasVersion
122
-
123
- Checks if a specific version of an entity exists
124
-
125
- **Arguments:**
126
- | Name | Type | Required | Description |
127
- |------|------|----------|-------------|
128
- | id | string | Yes | The ID of the entity |
129
- | version | string | Yes | Version to check |
130
-
131
- **Examples:**
132
-
133
- ```bash
134
- # Check if version exists
135
- npx @eventcatalog/cli entityHasVersion "Order" "1.0.0"
136
- ```
137
-
138
- ---
@@ -1,186 +0,0 @@
1
- ---
2
- id: cli-events
3
- title: Events
4
- sidebar_label: Events
5
- sidebar_position: 2
6
- ---
7
-
8
- # Events CLI Commands
9
-
10
- Manage events in your EventCatalog from the command line.
11
-
12
- ## getEvent
13
-
14
- Returns an event from EventCatalog by its ID
15
-
16
- **Arguments:**
17
- | Name | Type | Required | Description |
18
- |------|------|----------|-------------|
19
- | id | string | Yes | The ID of the event to retrieve |
20
- | version | string | No | Specific version to retrieve (supports semver) |
21
- | options | json | No | Options object, e.g. {"attachSchema": true} |
22
-
23
- **Examples:**
24
-
25
- ```bash
26
- # Get the latest version of an event
27
- npx @eventcatalog/cli getEvent "OrderCreated"
28
-
29
- # Get a specific version
30
- npx @eventcatalog/cli getEvent "OrderCreated" "1.0.0"
31
- ```
32
-
33
- ---
34
-
35
- ## getEvents
36
-
37
- Returns all events from EventCatalog
38
-
39
- **Arguments:** None
40
-
41
- **Examples:**
42
-
43
- ```bash
44
- # Get all events
45
- npx @eventcatalog/cli getEvents
46
- ```
47
-
48
- ---
49
-
50
- ## writeEvent
51
-
52
- Writes an event to EventCatalog
53
-
54
- **Arguments:**
55
- | Name | Type | Required | Description |
56
- |------|------|----------|-------------|
57
- | event | json | Yes | Event object with id, name, version, and markdown |
58
-
59
-
60
-
61
- ---
62
-
63
- ## writeEventToService
64
-
65
- Writes an event to a specific service in EventCatalog
66
-
67
- **Arguments:**
68
- | Name | Type | Required | Description |
69
- |------|------|----------|-------------|
70
- | event | json | Yes | Event object with id, name, version, and markdown |
71
- | service | json | Yes | Service reference: {id, version?} |
72
- | options | json | No | Options: {path?, format?, override?} |
73
-
74
-
75
-
76
- ---
77
-
78
- ## rmEvent
79
-
80
- Removes an event by its path
81
-
82
- **Arguments:**
83
- | Name | Type | Required | Description |
84
- |------|------|----------|-------------|
85
- | path | string | Yes | Path to the event, e.g. /InventoryAdjusted |
86
-
87
- **Examples:**
88
-
89
- ```bash
90
- # Remove an event by path
91
- npx @eventcatalog/cli rmEvent "/InventoryAdjusted"
92
- ```
93
-
94
- ---
95
-
96
- ## rmEventById
97
-
98
- Removes an event by its ID
99
-
100
- **Arguments:**
101
- | Name | Type | Required | Description |
102
- |------|------|----------|-------------|
103
- | id | string | Yes | The ID of the event to remove |
104
- | version | string | No | Specific version to remove |
105
-
106
- **Examples:**
107
-
108
- ```bash
109
- # Remove latest version
110
- npx @eventcatalog/cli rmEventById "OrderCreated"
111
-
112
- # Remove specific version
113
- npx @eventcatalog/cli rmEventById "OrderCreated" "1.0.0"
114
- ```
115
-
116
- ---
117
-
118
- ## versionEvent
119
-
120
- Moves the current event to a versioned directory
121
-
122
- **Arguments:**
123
- | Name | Type | Required | Description |
124
- |------|------|----------|-------------|
125
- | id | string | Yes | The ID of the event to version |
126
-
127
- **Examples:**
128
-
129
- ```bash
130
- # Version an event
131
- npx @eventcatalog/cli versionEvent "OrderCreated"
132
- ```
133
-
134
- ---
135
-
136
- ## addFileToEvent
137
-
138
- Adds a file to an event
139
-
140
- **Arguments:**
141
- | Name | Type | Required | Description |
142
- |------|------|----------|-------------|
143
- | id | string | Yes | The ID of the event |
144
- | file | json | Yes | File object: {content, fileName} |
145
- | version | string | No | Specific version to add file to |
146
-
147
-
148
-
149
- ---
150
-
151
- ## addSchemaToEvent
152
-
153
- Adds a schema file to an event
154
-
155
- **Arguments:**
156
- | Name | Type | Required | Description |
157
- |------|------|----------|-------------|
158
- | id | string | Yes | The ID of the event |
159
- | schema | json | Yes | Schema object: {schema, fileName} |
160
- | version | string | No | Specific version to add schema to |
161
-
162
-
163
-
164
- ---
165
-
166
- ## eventHasVersion
167
-
168
- Checks if a specific version of an event exists
169
-
170
- **Arguments:**
171
- | Name | Type | Required | Description |
172
- |------|------|----------|-------------|
173
- | id | string | Yes | The ID of the event |
174
- | version | string | Yes | Version to check (supports semver) |
175
-
176
- **Examples:**
177
-
178
- ```bash
179
- # Check if version exists
180
- npx @eventcatalog/cli eventHasVersion "OrderCreated" "1.0.0"
181
-
182
- # Check with semver range
183
- npx @eventcatalog/cli eventHasVersion "OrderCreated" "1.0.x"
184
- ```
185
-
186
- ---
@@ -1,27 +0,0 @@
1
- ---
2
- id: cli-export
3
- title: Export
4
- sidebar_label: Export
5
- sidebar_position: 17
6
- ---
7
-
8
- # Export CLI Commands
9
-
10
- Manage export in your EventCatalog from the command line.
11
-
12
- ## export
13
-
14
- Export catalog resources to EventCatalog DSL (.ec) format
15
-
16
- **Arguments:**
17
- | Name | Type | Required | Description |
18
- |------|------|----------|-------------|
19
- | all | boolean | No | Export the entire catalog (all resource types) |
20
- | id | string | No | Resource ID (omit to export all of the given type) |
21
- | version | string | No | Resource version (defaults to latest) |
22
- | stdout | boolean | No | Print to stdout instead of writing a file |
23
- | output | string | No | Output file path (defaults to <id>.ec or catalog.ec) |
24
-
25
-
26
-
27
- ---
@@ -1,24 +0,0 @@
1
- ---
2
- id: cli-governance
3
- title: Governance
4
- sidebar_label: Governance
5
- sidebar_position: 19
6
- ---
7
-
8
- # Governance CLI Commands
9
-
10
- Manage governance in your EventCatalog from the command line.
11
-
12
- ## governanceCheck
13
-
14
- Compare the current catalog (or a target branch) against a base branch and evaluate governance rules defined in governance.yaml (or governance.yml)
15
-
16
- **Arguments:**
17
- | Name | Type | Required | Description |
18
- |------|------|----------|-------------|
19
- | --base | string | No | Base branch to compare against (default: main) |
20
- | --format | string | No | Output format: text or json (default: text) |
21
-
22
-
23
-
24
- ---
@@ -1,69 +0,0 @@
1
- ---
2
- id: cli-messages
3
- title: Messages
4
- sidebar_label: Messages
5
- sidebar_position: 15
6
- ---
7
-
8
- # Messages CLI Commands
9
-
10
- Manage messages in your EventCatalog from the command line.
11
-
12
- ## getProducersAndConsumersForMessage
13
-
14
- Returns the producers and consumers (services) for a given message
15
-
16
- **Arguments:**
17
- | Name | Type | Required | Description |
18
- |------|------|----------|-------------|
19
- | id | string | Yes | The ID of the message |
20
- | version | string | No | Specific version |
21
-
22
-
23
-
24
- ---
25
-
26
- ## getConsumersOfSchema
27
-
28
- Returns services that consume a given schema
29
-
30
- **Arguments:**
31
- | Name | Type | Required | Description |
32
- |------|------|----------|-------------|
33
- | schemaPath | string | Yes | Path to the schema file |
34
-
35
-
36
-
37
- ---
38
-
39
- ## getProducersOfSchema
40
-
41
- Returns services that produce a given schema
42
-
43
- **Arguments:**
44
- | Name | Type | Required | Description |
45
- |------|------|----------|-------------|
46
- | schemaPath | string | Yes | Path to the schema file |
47
-
48
-
49
-
50
- ---
51
-
52
- ## getOwnersForResource
53
-
54
- Returns the owners (users/teams) for a given resource
55
-
56
- **Arguments:**
57
- | Name | Type | Required | Description |
58
- |------|------|----------|-------------|
59
- | id | string | Yes | The ID of the resource |
60
- | version | string | No | Specific version |
61
-
62
- **Examples:**
63
-
64
- ```bash
65
- # Get owners for a resource
66
- npx @eventcatalog/cli getOwnersForResource "OrderService"
67
- ```
68
-
69
- ---