@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.
- package/dist/analytics/analytics.cjs +1 -1
- package/dist/analytics/analytics.js +2 -2
- package/dist/analytics/log-build.cjs +1 -1
- package/dist/analytics/log-build.js +3 -3
- package/dist/{chunk-SSSN5FXC.js → chunk-HERAHLM2.js} +1 -1
- package/dist/{chunk-IIECZFXN.js → chunk-LITOQH56.js} +1 -1
- package/dist/{chunk-34RMFKFB.js → chunk-LUW6RDA7.js} +1 -1
- package/dist/{chunk-JHUICVBT.js → chunk-ONDFEA5R.js} +1 -1
- package/dist/{chunk-PADMH2RJ.js → chunk-V2SKOQYF.js} +1 -1
- package/dist/constants.cjs +1 -1
- package/dist/constants.js +1 -1
- package/dist/docs/api/02-config.md +55 -1
- package/dist/docs/development/authentication/providers/03-setting-up-github.md +29 -0
- package/dist/docs/development/bring-your-own-documentation/custom-pages/02-adding-custom-docs.md +2 -2
- package/dist/docs/development/bring-your-own-documentation/custom-pages/03-components.md +17 -0
- package/dist/docs/development/components/07-resource-references.md +7 -1
- package/dist/docs/development/components/components/05-architecture-graph.md +65 -0
- package/dist/docs/development/components/components/{05-attachments.md → 06-attachments.md} +1 -1
- package/dist/docs/development/components/components/{06-channel-information.md → 07-channel-information.md} +1 -1
- package/dist/docs/development/components/components/{07-custom-properties.md → 08-custom-properties.md} +1 -1
- package/dist/docs/development/components/components/{08-design.md → 09-design.md} +1 -1
- package/dist/docs/development/components/components/{09-entitymap.md → 10-entitymap.md} +1 -1
- package/dist/docs/development/components/components/{10-flow.md → 11-flow.md} +1 -1
- package/dist/docs/development/components/components/{11-link.md → 12-link.md} +1 -1
- package/dist/docs/development/components/components/{12-mermaid-file-loader.md → 13-mermaid-file-loader.md} +1 -1
- package/dist/docs/development/components/components/{13-message-table.md → 14-message-table.md} +1 -1
- package/dist/docs/development/components/components/{14-nodegraph.md → 15-nodegraph.md} +1 -1
- package/dist/docs/development/components/components/{15-openapi.md → 16-openapi.md} +1 -1
- package/dist/docs/development/components/components/{16-prompt.md → 17-prompt.md} +1 -1
- package/dist/docs/development/components/components/{17-remote-schema.md → 18-remote-schema.md} +1 -1
- package/dist/docs/development/components/components/{18-resource-group-table.md → 19-resource-group-table.md} +1 -1
- package/dist/docs/development/components/components/{19-resource-link.md → 20-resource-link.md} +1 -1
- package/dist/docs/development/components/components/{20-schema.md → 21-schema.md} +1 -1
- package/dist/docs/development/components/components/{21-schema-viewer.md → 22-schema-viewer.md} +1 -1
- package/dist/docs/development/components/components/{22-steps.md → 23-steps.md} +1 -1
- package/dist/docs/development/components/components/{23-tabs.md → 24-tabs.md} +1 -1
- package/dist/docs/development/components/components/{24-tiles.md → 25-tiles.md} +1 -1
- package/dist/docs/development/components/components/{25-visibility.md → 26-visibility.md} +1 -1
- package/dist/docs/development/customization/04-documentation-sidebar.md +3 -3
- package/dist/docs/development/customization/05-resource-sidebar.md +235 -0
- package/dist/docs/development/customization/09-embed-eventcatalog.md +179 -0
- package/dist/docs/development/customization/_category_.json +1 -1
- package/dist/docs/development/deployment/build-and-deploy.md +4 -0
- package/dist/docs/development/deployment/hosting-options.md +1 -1
- package/dist/docs/development/deployment/link-validation.md +105 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/00-overview.md +76 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/01-setup.md +144 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/_category_.json +10 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/how-to/01-configure-rules.md +130 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/how-to/02-run-in-ci.md +93 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/how-to/03-use-custom-frontmatter.md +81 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/how-to/04-reference-external-catalogs.md +51 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/how-to/05-fix-common-problems.md +120 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/how-to/_category_.json +12 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/reference/01-cli.md +109 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/reference/02-configuration.md +120 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/reference/03-rules.md +287 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/reference/04-versions.md +77 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/reference/05-supported-resources.md +75 -0
- package/dist/docs/development/developer-tools/eventcatalog-linter/reference/_category_.json +12 -0
- package/dist/docs/development/guides/97-architecture-graph.md +78 -0
- package/dist/docs/development/guides/domains/02-create-domain.md +1 -1
- package/dist/docs/development/guides/domains/03-ownership-and-language/02-adding-ubiquitous-language.md +29 -0
- package/dist/docs/development/guides/domains/09-reference.md +10 -0
- package/dist/docs/development/guides/resources/messages/04-message-channels/02-adding-channels.md +2 -2
- package/dist/docs/development/guides/resources/messages/04-message-channels/04-adding-messages-to-services.md +8 -0
- package/dist/docs/development/guides/resources/schemas/03-add-specifications-to-services/01-add-openapi-specifications.md +2 -2
- package/dist/docs/development/guides/resources/schemas/03-add-specifications-to-services/02-add-asyncapi-specifications.md +3 -3
- package/dist/docs/development/guides/systems/05-system-context-maps.md +2 -0
- package/dist/docs/development/license-keys/license-validation.md +7 -3
- package/dist/docs/development/license-keys/overview.md +7 -3
- package/dist/docs/development/upgrading/upgrading.md +3 -3
- package/dist/docs/development/upgrading/v2.md +3 -3
- package/dist/docs/federation/00-overview.md +158 -0
- package/dist/docs/federation/01-first-federation.md +199 -0
- package/dist/docs/federation/_category_.json +12 -0
- package/dist/docs/federation/explanation/_category_.json +12 -0
- package/dist/docs/federation/explanation/how-it-works.md +129 -0
- package/dist/docs/federation/explanation/lockfile-and-cache.md +134 -0
- package/dist/docs/federation/explanation/mvp-status-and-feedback.md +86 -0
- package/dist/docs/federation/explanation/ownership-and-references.md +134 -0
- package/dist/docs/federation/how-to/_category_.json +12 -0
- package/dist/docs/federation/how-to/configure-github-sources.md +156 -0
- package/dist/docs/federation/how-to/configure-validation-rules.md +127 -0
- package/dist/docs/federation/how-to/run-in-ci.md +138 -0
- package/dist/docs/federation/how-to/share-assets-and-components.md +125 -0
- package/dist/docs/federation/how-to/use-local-sources.md +138 -0
- package/dist/docs/{plugins/eventcatalog-federation → federation/legacy-federation}/00-introduction.md +11 -2
- package/dist/docs/{plugins/eventcatalog-federation → federation/legacy-federation}/01-installation.md +11 -3
- package/dist/docs/{plugins/eventcatalog-federation → federation/legacy-federation}/02-plugin-configuration.md +11 -2
- package/dist/docs/{plugins/eventcatalog-federation → federation/legacy-federation}/03-examples.md +11 -1
- package/dist/docs/{plugins/eventcatalog-federation → federation/legacy-federation}/04-configuration.md +11 -1
- package/dist/docs/{plugins/eventcatalog-federation → federation/legacy-federation}/05-setup-team-catalog.md +11 -2
- package/dist/docs/federation/legacy-federation/_category_.json +12 -0
- package/dist/docs/federation/reference/_category_.json +12 -0
- package/dist/docs/federation/reference/cli.md +122 -0
- package/dist/docs/federation/reference/configuration.md +192 -0
- package/dist/docs/federation/reference/diagnostic-rules.md +173 -0
- package/dist/docs/federation/reference/generated-output.md +118 -0
- package/dist/docs/federation/reference/supported-content.md +86 -0
- package/dist/docs/federation/reference/troubleshooting.md +208 -0
- package/dist/docs/plugins/01-intro.md +3 -3
- package/dist/docs/plugins/03-all-plugins.md +2 -2
- package/dist/docs/plugins/asyncapi/00-intro.md +4 -4
- package/dist/docs/plugins/asyncapi/02-plugin-configuration.md +4 -4
- package/dist/docs/plugins/backstage/00-overview.md +53 -0
- package/dist/docs/plugins/backstage/01-get-started.md +95 -0
- package/dist/docs/plugins/backstage/02-embed-entity-tabs.md +109 -0
- package/dist/docs/plugins/backstage/03-add-overview-cards.md +79 -0
- package/dist/docs/plugins/backstage/04-control-theme-and-size.md +54 -0
- package/dist/docs/plugins/backstage/05-migrate-to-annotations.md +49 -0
- package/dist/docs/plugins/backstage/06-configuration.md +85 -0
- package/dist/docs/plugins/backstage/07-components.md +129 -0
- package/dist/docs/plugins/backstage/08-how-embeds-work.md +52 -0
- package/dist/docs/plugins/backstage/_category_.json +4 -3
- package/dist/docs/plugins/eventbridge/00-intro.md +5 -5
- package/dist/docs/plugins/eventbridge/03-api.md +3 -3
- package/dist/docs/plugins/graphql/00-intro.md +2 -2
- package/dist/docs/plugins/graphql/02-plugin-configuration.md +2 -2
- package/dist/docs/plugins/hookdeck/01-intro.md +1 -1
- package/dist/docs/plugins/openapi/00-intro.md +1 -1
- package/dist/eventcatalog.cjs +1 -1
- package/dist/eventcatalog.js +5 -5
- package/dist/generate.cjs +1 -1
- package/dist/generate.js +3 -3
- package/dist/utils/cli-logger.cjs +1 -1
- package/dist/utils/cli-logger.js +2 -2
- package/eventcatalog/src/components/SchemaExplorer/AvroSchemaViewer.tsx +21 -19
- package/eventcatalog/src/components/SchemaExplorer/JSONSchemaViewer.tsx +79 -77
- package/eventcatalog/src/components/SchemaExplorer/ProtobufSchemaViewer.test.tsx +91 -0
- package/eventcatalog/src/components/SchemaExplorer/ProtobufSchemaViewer.tsx +115 -33
- package/eventcatalog/src/components/SchemaExplorer/SchemaViewerHover.test.tsx +33 -0
- package/eventcatalog/src/components/SchemaExplorer/protobuf-validation.test.ts +84 -0
- package/eventcatalog/src/components/SchemaExplorer/protobuf-validation.ts +149 -0
- package/eventcatalog/src/utils/protobuf-schema.ts +211 -16
- package/package.json +3 -3
- package/dist/docs/cli/channels.md +0 -180
- package/dist/docs/cli/commands.md +0 -183
- package/dist/docs/cli/custom-docs.md +0 -78
- package/dist/docs/cli/data-products.md +0 -177
- package/dist/docs/cli/data-stores.md +0 -166
- package/dist/docs/cli/diagrams.md +0 -147
- package/dist/docs/cli/domains.md +0 -280
- package/dist/docs/cli/entities.md +0 -138
- package/dist/docs/cli/events.md +0 -186
- package/dist/docs/cli/export.md +0 -27
- package/dist/docs/cli/governance.md +0 -24
- package/dist/docs/cli/messages.md +0 -69
- package/dist/docs/cli/queries.md +0 -183
- package/dist/docs/cli/services.md +0 -266
- package/dist/docs/cli/snapshots.md +0 -44
- package/dist/docs/cli/teams.md +0 -75
- package/dist/docs/cli/users.md +0 -75
- package/dist/docs/cli/utilities.md +0 -43
- package/dist/docs/development/developer-tools/eventcatalog-linter.md +0 -732
- package/dist/docs/plugins/backstage/00-intro.md +0 -67
- package/dist/docs/plugins/backstage/01-installation.md +0 -242
- package/dist/docs/plugins/backstage/02-api.md +0 -51
- package/dist/docs/plugins/backstage/03-examples.md +0 -12
- package/dist/docs/plugins/eventcatalog-federation/_category_.json +0 -11
package/dist/docs/cli/domains.md
DELETED
|
@@ -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
|
-
---
|
package/dist/docs/cli/events.md
DELETED
|
@@ -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
|
-
---
|
package/dist/docs/cli/export.md
DELETED
|
@@ -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
|
-
---
|