@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,183 +0,0 @@
1
- ---
2
- id: cli-queries
3
- title: Queries
4
- sidebar_label: Queries
5
- sidebar_position: 4
6
- ---
7
-
8
- # Queries CLI Commands
9
-
10
- Manage queries in your EventCatalog from the command line.
11
-
12
- ## getQuery
13
-
14
- Returns a query from EventCatalog by its ID
15
-
16
- **Arguments:**
17
- | Name | Type | Required | Description |
18
- |------|------|----------|-------------|
19
- | id | string | Yes | The ID of the query to retrieve |
20
- | version | string | No | Specific version to retrieve |
21
-
22
- **Examples:**
23
-
24
- ```bash
25
- # Get the latest query
26
- npx @eventcatalog/cli getQuery "GetOrder"
27
-
28
- # Get a specific version
29
- npx @eventcatalog/cli getQuery "GetOrder" "1.0.0"
30
- ```
31
-
32
- ---
33
-
34
- ## getQueries
35
-
36
- Returns all queries from EventCatalog
37
-
38
- **Arguments:**
39
- | Name | Type | Required | Description |
40
- |------|------|----------|-------------|
41
- | options | json | No | Options: {latestOnly?, attachSchema?} |
42
-
43
- **Examples:**
44
-
45
- ```bash
46
- # Get all queries
47
- npx @eventcatalog/cli getQueries
48
- ```
49
-
50
- ---
51
-
52
- ## writeQuery
53
-
54
- Writes a query to EventCatalog
55
-
56
- **Arguments:**
57
- | Name | Type | Required | Description |
58
- |------|------|----------|-------------|
59
- | query | json | Yes | Query object with id, name, version, and markdown |
60
- | options | json | No | Options: {path?, override?, versionExistingContent?} |
61
-
62
-
63
-
64
- ---
65
-
66
- ## writeQueryToService
67
-
68
- Writes a query to a specific service
69
-
70
- **Arguments:**
71
- | Name | Type | Required | Description |
72
- |------|------|----------|-------------|
73
- | query | json | Yes | Query object |
74
- | service | json | Yes | Service reference: {id, version?} |
75
- | options | json | No | Options: {path?, format?, override?} |
76
-
77
-
78
-
79
- ---
80
-
81
- ## rmQuery
82
-
83
- Removes a query by its path
84
-
85
- **Arguments:**
86
- | Name | Type | Required | Description |
87
- |------|------|----------|-------------|
88
- | path | string | Yes | Path to the query |
89
-
90
- **Examples:**
91
-
92
- ```bash
93
- # Remove a query
94
- npx @eventcatalog/cli rmQuery "/GetOrder"
95
- ```
96
-
97
- ---
98
-
99
- ## rmQueryById
100
-
101
- Removes a query by its ID
102
-
103
- **Arguments:**
104
- | Name | Type | Required | Description |
105
- |------|------|----------|-------------|
106
- | id | string | Yes | The ID of the query to remove |
107
- | version | string | No | Specific version to remove |
108
-
109
- **Examples:**
110
-
111
- ```bash
112
- # Remove a query
113
- npx @eventcatalog/cli rmQueryById "GetOrder"
114
- ```
115
-
116
- ---
117
-
118
- ## versionQuery
119
-
120
- Moves the current query to a versioned directory
121
-
122
- **Arguments:**
123
- | Name | Type | Required | Description |
124
- |------|------|----------|-------------|
125
- | id | string | Yes | The ID of the query to version |
126
-
127
- **Examples:**
128
-
129
- ```bash
130
- # Version a query
131
- npx @eventcatalog/cli versionQuery "GetOrder"
132
- ```
133
-
134
- ---
135
-
136
- ## addFileToQuery
137
-
138
- Adds a file to a query
139
-
140
- **Arguments:**
141
- | Name | Type | Required | Description |
142
- |------|------|----------|-------------|
143
- | id | string | Yes | The ID of the query |
144
- | file | json | Yes | File object: {content, fileName} |
145
- | version | string | No | Specific version |
146
-
147
-
148
-
149
- ---
150
-
151
- ## addSchemaToQuery
152
-
153
- Adds a schema to a query
154
-
155
- **Arguments:**
156
- | Name | Type | Required | Description |
157
- |------|------|----------|-------------|
158
- | id | string | Yes | The ID of the query |
159
- | schema | json | Yes | Schema object: {schema, fileName} |
160
- | version | string | No | Specific version |
161
-
162
-
163
-
164
- ---
165
-
166
- ## queryHasVersion
167
-
168
- Checks if a specific version of a query exists
169
-
170
- **Arguments:**
171
- | Name | Type | Required | Description |
172
- |------|------|----------|-------------|
173
- | id | string | Yes | The ID of the query |
174
- | version | string | Yes | Version to check |
175
-
176
- **Examples:**
177
-
178
- ```bash
179
- # Check if version exists
180
- npx @eventcatalog/cli queryHasVersion "GetOrder" "1.0.0"
181
- ```
182
-
183
- ---
@@ -1,266 +0,0 @@
1
- ---
2
- id: cli-services
3
- title: Services
4
- sidebar_label: Services
5
- sidebar_position: 5
6
- ---
7
-
8
- # Services CLI Commands
9
-
10
- Manage services in your EventCatalog from the command line.
11
-
12
- ## getService
13
-
14
- Returns a service from EventCatalog by its ID
15
-
16
- **Arguments:**
17
- | Name | Type | Required | Description |
18
- |------|------|----------|-------------|
19
- | id | string | Yes | The ID of the service to retrieve |
20
- | version | string | No | Specific version to retrieve |
21
-
22
- **Examples:**
23
-
24
- ```bash
25
- # Get the latest service
26
- npx @eventcatalog/cli getService "OrderService"
27
-
28
- # Get a specific version
29
- npx @eventcatalog/cli getService "OrderService" "1.0.0"
30
- ```
31
-
32
- ---
33
-
34
- ## getServices
35
-
36
- Returns all services 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 services
47
- npx @eventcatalog/cli getServices
48
- ```
49
-
50
- ---
51
-
52
- ## writeService
53
-
54
- Writes a service to EventCatalog
55
-
56
- **Arguments:**
57
- | Name | Type | Required | Description |
58
- |------|------|----------|-------------|
59
- | service | json | Yes | Service object with id, name, version, and markdown |
60
- | options | json | No | Options: {path?, override?, versionExistingContent?} |
61
-
62
-
63
-
64
- ---
65
-
66
- ## writeServiceToDomain
67
-
68
- Writes a service to a specific domain
69
-
70
- **Arguments:**
71
- | Name | Type | Required | Description |
72
- |------|------|----------|-------------|
73
- | service | json | Yes | Service object |
74
- | domain | json | Yes | Domain reference: {id, version?} |
75
- | options | json | No | Options |
76
-
77
-
78
-
79
- ---
80
-
81
- ## rmService
82
-
83
- Removes a service by its path
84
-
85
- **Arguments:**
86
- | Name | Type | Required | Description |
87
- |------|------|----------|-------------|
88
- | path | string | Yes | Path to the service |
89
-
90
- **Examples:**
91
-
92
- ```bash
93
- # Remove a service
94
- npx @eventcatalog/cli rmService "/OrderService"
95
- ```
96
-
97
- ---
98
-
99
- ## rmServiceById
100
-
101
- Removes a service by its ID
102
-
103
- **Arguments:**
104
- | Name | Type | Required | Description |
105
- |------|------|----------|-------------|
106
- | id | string | Yes | The ID of the service to remove |
107
- | version | string | No | Specific version to remove |
108
-
109
- **Examples:**
110
-
111
- ```bash
112
- # Remove a service
113
- npx @eventcatalog/cli rmServiceById "OrderService"
114
- ```
115
-
116
- ---
117
-
118
- ## versionService
119
-
120
- Moves the current service to a versioned directory
121
-
122
- **Arguments:**
123
- | Name | Type | Required | Description |
124
- |------|------|----------|-------------|
125
- | id | string | Yes | The ID of the service to version |
126
-
127
- **Examples:**
128
-
129
- ```bash
130
- # Version a service
131
- npx @eventcatalog/cli versionService "OrderService"
132
- ```
133
-
134
- ---
135
-
136
- ## addFileToService
137
-
138
- Adds a file to a service
139
-
140
- **Arguments:**
141
- | Name | Type | Required | Description |
142
- |------|------|----------|-------------|
143
- | id | string | Yes | The ID of the service |
144
- | file | json | Yes | File object: {content, fileName} |
145
- | version | string | No | Specific version |
146
-
147
-
148
-
149
- ---
150
-
151
- ## addEventToService
152
-
153
- Adds an event relationship to a service
154
-
155
- **Arguments:**
156
- | Name | Type | Required | Description |
157
- |------|------|----------|-------------|
158
- | serviceId | string | Yes | The ID of the service |
159
- | direction | string | Yes | Direction: "sends" or "receives" |
160
- | event | json | Yes | Event reference: {id, version} |
161
- | serviceVersion | string | No | Specific service version |
162
-
163
-
164
-
165
- ---
166
-
167
- ## addCommandToService
168
-
169
- Adds a command relationship to a service
170
-
171
- **Arguments:**
172
- | Name | Type | Required | Description |
173
- |------|------|----------|-------------|
174
- | serviceId | string | Yes | The ID of the service |
175
- | direction | string | Yes | Direction: "sends" or "receives" |
176
- | command | json | Yes | Command reference: {id, version} |
177
- | serviceVersion | string | No | Specific service version |
178
-
179
-
180
-
181
- ---
182
-
183
- ## addQueryToService
184
-
185
- Adds a query relationship to a service
186
-
187
- **Arguments:**
188
- | Name | Type | Required | Description |
189
- |------|------|----------|-------------|
190
- | serviceId | string | Yes | The ID of the service |
191
- | direction | string | Yes | Direction: "sends" or "receives" |
192
- | query | json | Yes | Query reference: {id, version} |
193
- | serviceVersion | string | No | Specific service version |
194
-
195
-
196
-
197
- ---
198
-
199
- ## addEntityToService
200
-
201
- Adds an entity to a service
202
-
203
- **Arguments:**
204
- | Name | Type | Required | Description |
205
- |------|------|----------|-------------|
206
- | serviceId | string | Yes | The ID of the service |
207
- | entity | json | Yes | Entity reference: {id, version} |
208
- | serviceVersion | string | No | Specific service version |
209
-
210
-
211
-
212
- ---
213
-
214
- ## addDataStoreToService
215
-
216
- Adds a data store relationship to a service
217
-
218
- **Arguments:**
219
- | Name | Type | Required | Description |
220
- |------|------|----------|-------------|
221
- | serviceId | string | Yes | The ID of the service |
222
- | relationship | string | Yes | Relationship: "writesTo" or "readsFrom" |
223
- | dataStore | json | Yes | Data store reference: {id, version} |
224
- | serviceVersion | string | No | Specific service version |
225
-
226
-
227
-
228
- ---
229
-
230
- ## serviceHasVersion
231
-
232
- Checks if a specific version of a service exists
233
-
234
- **Arguments:**
235
- | Name | Type | Required | Description |
236
- |------|------|----------|-------------|
237
- | id | string | Yes | The ID of the service |
238
- | version | string | Yes | Version to check |
239
-
240
- **Examples:**
241
-
242
- ```bash
243
- # Check if version exists
244
- npx @eventcatalog/cli serviceHasVersion "OrderService" "1.0.0"
245
- ```
246
-
247
- ---
248
-
249
- ## getSpecificationFilesForService
250
-
251
- Returns specification files (OpenAPI, AsyncAPI) for a service
252
-
253
- **Arguments:**
254
- | Name | Type | Required | Description |
255
- |------|------|----------|-------------|
256
- | id | string | Yes | The ID of the service |
257
- | version | string | No | Specific version |
258
-
259
- **Examples:**
260
-
261
- ```bash
262
- # Get spec files
263
- npx @eventcatalog/cli getSpecificationFilesForService "OrderService"
264
- ```
265
-
266
- ---
@@ -1,44 +0,0 @@
1
- ---
2
- id: cli-snapshots
3
- title: Snapshots
4
- sidebar_label: Snapshots
5
- sidebar_position: 18
6
- ---
7
-
8
- # Snapshots CLI Commands
9
-
10
- Manage snapshots in your EventCatalog from the command line.
11
-
12
- ## createSnapshot
13
-
14
- Take a point-in-time snapshot of the entire catalog, capturing all resources and their metadata as a JSON file
15
-
16
- **Arguments:** None
17
-
18
-
19
-
20
- ---
21
-
22
- ## diffSnapshots
23
-
24
- Compare two snapshot files and output a structured diff showing added, removed, modified, and versioned resources plus relationship changes
25
-
26
- **Arguments:**
27
- | Name | Type | Required | Description |
28
- |------|------|----------|-------------|
29
- | fileA | string | Yes | Path to the first (older) snapshot file |
30
- | fileB | string | Yes | Path to the second (newer) snapshot file |
31
-
32
-
33
-
34
- ---
35
-
36
- ## listSnapshots
37
-
38
- List all snapshots in the catalog .snapshots directory with their labels, timestamps, and git info
39
-
40
- **Arguments:** None
41
-
42
-
43
-
44
- ---
@@ -1,75 +0,0 @@
1
- ---
2
- id: cli-teams
3
- title: Teams
4
- sidebar_label: Teams
5
- sidebar_position: 8
6
- ---
7
-
8
- # Teams CLI Commands
9
-
10
- Manage teams in your EventCatalog from the command line.
11
-
12
- ## getTeam
13
-
14
- Returns a team from EventCatalog by its ID
15
-
16
- **Arguments:**
17
- | Name | Type | Required | Description |
18
- |------|------|----------|-------------|
19
- | id | string | Yes | The ID of the team to retrieve |
20
-
21
- **Examples:**
22
-
23
- ```bash
24
- # Get a team
25
- npx @eventcatalog/cli getTeam "platform-team"
26
- ```
27
-
28
- ---
29
-
30
- ## getTeams
31
-
32
- Returns all teams from EventCatalog
33
-
34
- **Arguments:** None
35
-
36
- **Examples:**
37
-
38
- ```bash
39
- # Get all teams
40
- npx @eventcatalog/cli getTeams
41
- ```
42
-
43
- ---
44
-
45
- ## writeTeam
46
-
47
- Writes a team to EventCatalog
48
-
49
- **Arguments:**
50
- | Name | Type | Required | Description |
51
- |------|------|----------|-------------|
52
- | team | json | Yes | Team object with id, name, and markdown |
53
- | options | json | No | Options: {path?, override?} |
54
-
55
-
56
-
57
- ---
58
-
59
- ## rmTeamById
60
-
61
- Removes a team by its ID
62
-
63
- **Arguments:**
64
- | Name | Type | Required | Description |
65
- |------|------|----------|-------------|
66
- | id | string | Yes | The ID of the team to remove |
67
-
68
- **Examples:**
69
-
70
- ```bash
71
- # Remove a team
72
- npx @eventcatalog/cli rmTeamById "platform-team"
73
- ```
74
-
75
- ---
@@ -1,75 +0,0 @@
1
- ---
2
- id: cli-users
3
- title: Users
4
- sidebar_label: Users
5
- sidebar_position: 9
6
- ---
7
-
8
- # Users CLI Commands
9
-
10
- Manage users in your EventCatalog from the command line.
11
-
12
- ## getUser
13
-
14
- Returns a user from EventCatalog by their ID
15
-
16
- **Arguments:**
17
- | Name | Type | Required | Description |
18
- |------|------|----------|-------------|
19
- | id | string | Yes | The ID of the user to retrieve |
20
-
21
- **Examples:**
22
-
23
- ```bash
24
- # Get a user
25
- npx @eventcatalog/cli getUser "jsmith"
26
- ```
27
-
28
- ---
29
-
30
- ## getUsers
31
-
32
- Returns all users from EventCatalog
33
-
34
- **Arguments:** None
35
-
36
- **Examples:**
37
-
38
- ```bash
39
- # Get all users
40
- npx @eventcatalog/cli getUsers
41
- ```
42
-
43
- ---
44
-
45
- ## writeUser
46
-
47
- Writes a user to EventCatalog
48
-
49
- **Arguments:**
50
- | Name | Type | Required | Description |
51
- |------|------|----------|-------------|
52
- | user | json | Yes | User object with id, name, and markdown |
53
- | options | json | No | Options: {path?, override?} |
54
-
55
-
56
-
57
- ---
58
-
59
- ## rmUserById
60
-
61
- Removes a user by their ID
62
-
63
- **Arguments:**
64
- | Name | Type | Required | Description |
65
- |------|------|----------|-------------|
66
- | id | string | Yes | The ID of the user to remove |
67
-
68
- **Examples:**
69
-
70
- ```bash
71
- # Remove a user
72
- npx @eventcatalog/cli rmUserById "jsmith"
73
- ```
74
-
75
- ---
@@ -1,43 +0,0 @@
1
- ---
2
- id: cli-utilities
3
- title: Utilities
4
- sidebar_label: Utilities
5
- sidebar_position: 16
6
- ---
7
-
8
- # Utilities CLI Commands
9
-
10
- Manage utilities in your EventCatalog from the command line.
11
-
12
- ## dumpCatalog
13
-
14
- Dumps the entire catalog to a JSON structure
15
-
16
- **Arguments:** None
17
-
18
- **Examples:**
19
-
20
- ```bash
21
- # Dump entire catalog
22
- npx @eventcatalog/cli dumpCatalog
23
-
24
- # Dump and save to file
25
- npx @eventcatalog/cli dumpCatalog > catalog.json
26
- ```
27
-
28
- ---
29
-
30
- ## getEventCatalogConfigurationFile
31
-
32
- Returns the EventCatalog configuration file
33
-
34
- **Arguments:** None
35
-
36
- **Examples:**
37
-
38
- ```bash
39
- # Get config file
40
- npx @eventcatalog/cli getEventCatalogConfigurationFile
41
- ```
42
-
43
- ---