@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,78 +0,0 @@
1
- ---
2
- id: cli-custom-docs
3
- title: Custom Docs
4
- sidebar_label: Custom Docs
5
- sidebar_position: 10
6
- ---
7
-
8
- # Custom Docs CLI Commands
9
-
10
- Manage custom docs in your EventCatalog from the command line.
11
-
12
- ## getCustomDoc
13
-
14
- Returns a custom doc from EventCatalog by its path
15
-
16
- **Arguments:**
17
- | Name | Type | Required | Description |
18
- |------|------|----------|-------------|
19
- | path | string | Yes | Path to the custom doc |
20
-
21
- **Examples:**
22
-
23
- ```bash
24
- # Get a custom doc
25
- npx @eventcatalog/cli getCustomDoc "/getting-started"
26
- ```
27
-
28
- ---
29
-
30
- ## getCustomDocs
31
-
32
- Returns all custom docs from EventCatalog
33
-
34
- **Arguments:**
35
- | Name | Type | Required | Description |
36
- |------|------|----------|-------------|
37
- | options | json | No | Options: {path?} |
38
-
39
- **Examples:**
40
-
41
- ```bash
42
- # Get all custom docs
43
- npx @eventcatalog/cli getCustomDocs
44
- ```
45
-
46
- ---
47
-
48
- ## writeCustomDoc
49
-
50
- Writes a custom doc to EventCatalog
51
-
52
- **Arguments:**
53
- | Name | Type | Required | Description |
54
- |------|------|----------|-------------|
55
- | customDoc | json | Yes | Custom doc object with id, title, and markdown |
56
- | options | json | No | Options: {path?, override?} |
57
-
58
-
59
-
60
- ---
61
-
62
- ## rmCustomDoc
63
-
64
- Removes a custom doc by its path
65
-
66
- **Arguments:**
67
- | Name | Type | Required | Description |
68
- |------|------|----------|-------------|
69
- | path | string | Yes | Path to the custom doc to remove |
70
-
71
- **Examples:**
72
-
73
- ```bash
74
- # Remove a custom doc
75
- npx @eventcatalog/cli rmCustomDoc "/getting-started"
76
- ```
77
-
78
- ---
@@ -1,177 +0,0 @@
1
- ---
2
- id: cli-data-products
3
- title: Data Products
4
- sidebar_label: Data Products
5
- sidebar_position: 13
6
- ---
7
-
8
- # Data Products CLI Commands
9
-
10
- Manage data products in your EventCatalog from the command line.
11
-
12
- ## getDataProduct
13
-
14
- Returns a data product from EventCatalog by its ID
15
-
16
- **Arguments:**
17
- | Name | Type | Required | Description |
18
- |------|------|----------|-------------|
19
- | id | string | Yes | The ID of the data product to retrieve |
20
- | version | string | No | Specific version to retrieve |
21
-
22
- **Examples:**
23
-
24
- ```bash
25
- # Get the latest data product
26
- npx @eventcatalog/cli getDataProduct "customer-360"
27
-
28
- # Get a specific version
29
- npx @eventcatalog/cli getDataProduct "customer-360" "1.0.0"
30
- ```
31
-
32
- ---
33
-
34
- ## getDataProducts
35
-
36
- Returns all data products 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 data products
47
- npx @eventcatalog/cli getDataProducts
48
- ```
49
-
50
- ---
51
-
52
- ## writeDataProduct
53
-
54
- Writes a data product to EventCatalog
55
-
56
- **Arguments:**
57
- | Name | Type | Required | Description |
58
- |------|------|----------|-------------|
59
- | options | json | No | Options: {path?, override?, versionExistingContent?} |
60
-
61
-
62
-
63
- ---
64
-
65
- ## writeDataProductToDomain
66
-
67
- Writes a data product to a specific domain
68
-
69
- **Arguments:**
70
- | Name | Type | Required | Description |
71
- |------|------|----------|-------------|
72
- | dataProduct | json | Yes | Data product object |
73
- | domain | json | Yes | Domain reference: {id, version?} |
74
- | options | json | No | Options |
75
-
76
-
77
-
78
- ---
79
-
80
- ## rmDataProduct
81
-
82
- Removes a data product by its path
83
-
84
- **Arguments:**
85
- | Name | Type | Required | Description |
86
- |------|------|----------|-------------|
87
- | path | string | Yes | Path to the data product |
88
-
89
- **Examples:**
90
-
91
- ```bash
92
- # Remove a data product
93
- npx @eventcatalog/cli rmDataProduct "/customer-360"
94
- ```
95
-
96
- ---
97
-
98
- ## rmDataProductById
99
-
100
- Removes a data product by its ID
101
-
102
- **Arguments:**
103
- | Name | Type | Required | Description |
104
- |------|------|----------|-------------|
105
- | id | string | Yes | The ID of the data product to remove |
106
- | version | string | No | Specific version to remove |
107
-
108
- **Examples:**
109
-
110
- ```bash
111
- # Remove a data product
112
- npx @eventcatalog/cli rmDataProductById "customer-360"
113
- ```
114
-
115
- ---
116
-
117
- ## versionDataProduct
118
-
119
- Moves the current data product to a versioned directory
120
-
121
- **Arguments:**
122
- | Name | Type | Required | Description |
123
- |------|------|----------|-------------|
124
- | id | string | Yes | The ID of the data product to version |
125
-
126
- **Examples:**
127
-
128
- ```bash
129
- # Version a data product
130
- npx @eventcatalog/cli versionDataProduct "customer-360"
131
- ```
132
-
133
- ---
134
-
135
- ## addFileToDataProduct
136
-
137
- Adds a file to a data product
138
-
139
- **Arguments:**
140
- | Name | Type | Required | Description |
141
- |------|------|----------|-------------|
142
- | id | string | Yes | The ID of the data product |
143
- | file | json | Yes | File object: {content, fileName} |
144
- | version | string | No | Specific version |
145
-
146
-
147
-
148
- ---
149
-
150
- ## addDataProductToDomain
151
-
152
- Adds a data product reference to a domain
153
-
154
- **Arguments:**
155
- | Name | Type | Required | Description |
156
- |------|------|----------|-------------|
157
- | domainId | string | Yes | The ID of the domain |
158
- | dataProduct | json | Yes | Data product reference: {id, version} |
159
- | domainVersion | string | No | Specific domain version |
160
-
161
-
162
-
163
- ---
164
-
165
- ## dataProductHasVersion
166
-
167
- Checks if a specific version of a data product exists
168
-
169
- **Arguments:**
170
- | Name | Type | Required | Description |
171
- |------|------|----------|-------------|
172
- | id | string | Yes | The ID of the data product |
173
- | version | string | Yes | Version to check |
174
-
175
-
176
-
177
- ---
@@ -1,166 +0,0 @@
1
- ---
2
- id: cli-data-stores
3
- title: Data Stores
4
- sidebar_label: Data Stores
5
- sidebar_position: 12
6
- ---
7
-
8
- # Data Stores CLI Commands
9
-
10
- Manage data stores in your EventCatalog from the command line.
11
-
12
- ## getDataStore
13
-
14
- Returns a data store from EventCatalog by its ID
15
-
16
- **Arguments:**
17
- | Name | Type | Required | Description |
18
- |------|------|----------|-------------|
19
- | id | string | Yes | The ID of the data store to retrieve |
20
- | version | string | No | Specific version to retrieve |
21
-
22
- **Examples:**
23
-
24
- ```bash
25
- # Get the latest data store
26
- npx @eventcatalog/cli getDataStore "orders-db"
27
-
28
- # Get a specific version
29
- npx @eventcatalog/cli getDataStore "orders-db" "1.0.0"
30
- ```
31
-
32
- ---
33
-
34
- ## getDataStores
35
-
36
- Returns all data stores 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 data stores
47
- npx @eventcatalog/cli getDataStores
48
- ```
49
-
50
- ---
51
-
52
- ## writeDataStore
53
-
54
- Writes a data store to EventCatalog
55
-
56
- **Arguments:**
57
- | Name | Type | Required | Description |
58
- |------|------|----------|-------------|
59
- | options | json | No | Options: {path?, override?, versionExistingContent?} |
60
-
61
-
62
-
63
- ---
64
-
65
- ## writeDataStoreToService
66
-
67
- Writes a data store to a specific service
68
-
69
- **Arguments:**
70
- | Name | Type | Required | Description |
71
- |------|------|----------|-------------|
72
- | dataStore | json | Yes | Data store object |
73
- | service | json | Yes | Service reference: {id, version?} |
74
-
75
-
76
-
77
- ---
78
-
79
- ## rmDataStore
80
-
81
- Removes a data store by its path
82
-
83
- **Arguments:**
84
- | Name | Type | Required | Description |
85
- |------|------|----------|-------------|
86
- | path | string | Yes | Path to the data store |
87
-
88
- **Examples:**
89
-
90
- ```bash
91
- # Remove a data store
92
- npx @eventcatalog/cli rmDataStore "/orders-db"
93
- ```
94
-
95
- ---
96
-
97
- ## rmDataStoreById
98
-
99
- Removes a data store by its ID
100
-
101
- **Arguments:**
102
- | Name | Type | Required | Description |
103
- |------|------|----------|-------------|
104
- | id | string | Yes | The ID of the data store to remove |
105
- | version | string | No | Specific version to remove |
106
-
107
- **Examples:**
108
-
109
- ```bash
110
- # Remove a data store
111
- npx @eventcatalog/cli rmDataStoreById "orders-db"
112
- ```
113
-
114
- ---
115
-
116
- ## versionDataStore
117
-
118
- Moves the current data store to a versioned directory
119
-
120
- **Arguments:**
121
- | Name | Type | Required | Description |
122
- |------|------|----------|-------------|
123
- | id | string | Yes | The ID of the data store to version |
124
-
125
- **Examples:**
126
-
127
- ```bash
128
- # Version a data store
129
- npx @eventcatalog/cli versionDataStore "orders-db"
130
- ```
131
-
132
- ---
133
-
134
- ## addFileToDataStore
135
-
136
- Adds a file to a data store
137
-
138
- **Arguments:**
139
- | Name | Type | Required | Description |
140
- |------|------|----------|-------------|
141
- | id | string | Yes | The ID of the data store |
142
- | file | json | Yes | File object: {content, fileName} |
143
- | version | string | No | Specific version |
144
-
145
-
146
-
147
- ---
148
-
149
- ## dataStoreHasVersion
150
-
151
- Checks if a specific version of a data store exists
152
-
153
- **Arguments:**
154
- | Name | Type | Required | Description |
155
- |------|------|----------|-------------|
156
- | id | string | Yes | The ID of the data store |
157
- | version | string | Yes | Version to check |
158
-
159
- **Examples:**
160
-
161
- ```bash
162
- # Check if version exists
163
- npx @eventcatalog/cli dataStoreHasVersion "orders-db" "1.0.0"
164
- ```
165
-
166
- ---
@@ -1,147 +0,0 @@
1
- ---
2
- id: cli-diagrams
3
- title: Diagrams
4
- sidebar_label: Diagrams
5
- sidebar_position: 14
6
- ---
7
-
8
- # Diagrams CLI Commands
9
-
10
- Manage diagrams in your EventCatalog from the command line.
11
-
12
- ## getDiagram
13
-
14
- Returns a diagram from EventCatalog by its ID
15
-
16
- **Arguments:**
17
- | Name | Type | Required | Description |
18
- |------|------|----------|-------------|
19
- | id | string | Yes | The ID of the diagram to retrieve |
20
- | version | string | No | Specific version to retrieve |
21
-
22
- **Examples:**
23
-
24
- ```bash
25
- # Get the latest diagram
26
- npx @eventcatalog/cli getDiagram "ArchitectureDiagram"
27
-
28
- # Get a specific version
29
- npx @eventcatalog/cli getDiagram "ArchitectureDiagram" "1.0.0"
30
- ```
31
-
32
- ---
33
-
34
- ## getDiagrams
35
-
36
- Returns all diagrams 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 diagrams
47
- npx @eventcatalog/cli getDiagrams
48
- ```
49
-
50
- ---
51
-
52
- ## writeDiagram
53
-
54
- Writes a diagram to EventCatalog
55
-
56
- **Arguments:**
57
- | Name | Type | Required | Description |
58
- |------|------|----------|-------------|
59
- | options | json | No | Options: {path?, override?, versionExistingContent?} |
60
-
61
-
62
-
63
- ---
64
-
65
- ## rmDiagram
66
-
67
- Removes a diagram by its path
68
-
69
- **Arguments:**
70
- | Name | Type | Required | Description |
71
- |------|------|----------|-------------|
72
- | path | string | Yes | Path to the diagram |
73
-
74
- **Examples:**
75
-
76
- ```bash
77
- # Remove a diagram
78
- npx @eventcatalog/cli rmDiagram "/ArchitectureDiagram"
79
- ```
80
-
81
- ---
82
-
83
- ## rmDiagramById
84
-
85
- Removes a diagram by its ID
86
-
87
- **Arguments:**
88
- | Name | Type | Required | Description |
89
- |------|------|----------|-------------|
90
- | id | string | Yes | The ID of the diagram to remove |
91
- | version | string | No | Specific version to remove |
92
-
93
- **Examples:**
94
-
95
- ```bash
96
- # Remove a diagram
97
- npx @eventcatalog/cli rmDiagramById "ArchitectureDiagram"
98
- ```
99
-
100
- ---
101
-
102
- ## versionDiagram
103
-
104
- Moves the current diagram to a versioned directory
105
-
106
- **Arguments:**
107
- | Name | Type | Required | Description |
108
- |------|------|----------|-------------|
109
- | id | string | Yes | The ID of the diagram to version |
110
-
111
- **Examples:**
112
-
113
- ```bash
114
- # Version a diagram
115
- npx @eventcatalog/cli versionDiagram "ArchitectureDiagram"
116
- ```
117
-
118
- ---
119
-
120
- ## addFileToDiagram
121
-
122
- Adds a file to a diagram
123
-
124
- **Arguments:**
125
- | Name | Type | Required | Description |
126
- |------|------|----------|-------------|
127
- | id | string | Yes | The ID of the diagram |
128
- | file | json | Yes | File object: {content, fileName} |
129
- | version | string | No | Specific version |
130
-
131
-
132
-
133
- ---
134
-
135
- ## diagramHasVersion
136
-
137
- Checks if a specific version of a diagram exists
138
-
139
- **Arguments:**
140
- | Name | Type | Required | Description |
141
- |------|------|----------|-------------|
142
- | id | string | Yes | The ID of the diagram |
143
- | version | string | Yes | Version to check |
144
-
145
-
146
-
147
- ---