@eventcatalog/sdk 2.12.0 → 2.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cli-docs.mjs CHANGED
@@ -1393,6 +1393,107 @@ var cliFunctions = [
1393
1393
  ]
1394
1394
  },
1395
1395
  // ================================
1396
+ // Diagrams
1397
+ // ================================
1398
+ {
1399
+ name: "getDiagram",
1400
+ description: "Returns a diagram from EventCatalog by its ID",
1401
+ category: "Diagrams",
1402
+ args: [
1403
+ { name: "id", type: "string", required: true, description: "The ID of the diagram to retrieve" },
1404
+ { name: "version", type: "string", required: false, description: "Specific version to retrieve" }
1405
+ ],
1406
+ examples: [
1407
+ { description: "Get the latest diagram", command: 'npx @eventcatalog/sdk getDiagram "ArchitectureDiagram"' },
1408
+ { description: "Get a specific version", command: 'npx @eventcatalog/sdk getDiagram "ArchitectureDiagram" "1.0.0"' }
1409
+ ]
1410
+ },
1411
+ {
1412
+ name: "getDiagrams",
1413
+ description: "Returns all diagrams from EventCatalog",
1414
+ category: "Diagrams",
1415
+ args: [{ name: "options", type: "json", required: false, description: "Options: {latestOnly?}" }],
1416
+ examples: [
1417
+ { description: "Get all diagrams", command: "npx @eventcatalog/sdk getDiagrams" },
1418
+ { description: "Get only latest versions", command: `npx @eventcatalog/sdk getDiagrams '{"latestOnly":true}'` }
1419
+ ]
1420
+ },
1421
+ {
1422
+ name: "writeDiagram",
1423
+ description: "Writes a diagram to EventCatalog",
1424
+ category: "Diagrams",
1425
+ args: [
1426
+ {
1427
+ name: "diagram",
1428
+ type: "json",
1429
+ required: true,
1430
+ description: "Diagram object with id, name, version, and markdown"
1431
+ },
1432
+ { name: "options", type: "json", required: false, description: "Options: {path?, override?, versionExistingContent?}" }
1433
+ ],
1434
+ examples: [
1435
+ {
1436
+ description: "Write a new diagram",
1437
+ command: `npx @eventcatalog/sdk writeDiagram '{"id":"ArchitectureDiagram","name":"Architecture Diagram","version":"1.0.0","markdown":"# Architecture Diagram"}'`
1438
+ }
1439
+ ]
1440
+ },
1441
+ {
1442
+ name: "rmDiagram",
1443
+ description: "Removes a diagram by its path",
1444
+ category: "Diagrams",
1445
+ args: [{ name: "path", type: "string", required: true, description: "Path to the diagram" }],
1446
+ examples: [{ description: "Remove a diagram", command: 'npx @eventcatalog/sdk rmDiagram "/ArchitectureDiagram"' }]
1447
+ },
1448
+ {
1449
+ name: "rmDiagramById",
1450
+ description: "Removes a diagram by its ID",
1451
+ category: "Diagrams",
1452
+ args: [
1453
+ { name: "id", type: "string", required: true, description: "The ID of the diagram to remove" },
1454
+ { name: "version", type: "string", required: false, description: "Specific version to remove" }
1455
+ ],
1456
+ examples: [{ description: "Remove a diagram", command: 'npx @eventcatalog/sdk rmDiagramById "ArchitectureDiagram"' }]
1457
+ },
1458
+ {
1459
+ name: "versionDiagram",
1460
+ description: "Moves the current diagram to a versioned directory",
1461
+ category: "Diagrams",
1462
+ args: [{ name: "id", type: "string", required: true, description: "The ID of the diagram to version" }],
1463
+ examples: [{ description: "Version a diagram", command: 'npx @eventcatalog/sdk versionDiagram "ArchitectureDiagram"' }]
1464
+ },
1465
+ {
1466
+ name: "addFileToDiagram",
1467
+ description: "Adds a file to a diagram",
1468
+ category: "Diagrams",
1469
+ args: [
1470
+ { name: "id", type: "string", required: true, description: "The ID of the diagram" },
1471
+ { name: "file", type: "json", required: true, description: "File object: {content, fileName}" },
1472
+ { name: "version", type: "string", required: false, description: "Specific version" }
1473
+ ],
1474
+ examples: [
1475
+ {
1476
+ description: "Add a file to a diagram",
1477
+ command: `npx @eventcatalog/sdk addFileToDiagram "ArchitectureDiagram" '{"content":"...","fileName":"diagram.png"}'`
1478
+ }
1479
+ ]
1480
+ },
1481
+ {
1482
+ name: "diagramHasVersion",
1483
+ description: "Checks if a specific version of a diagram exists",
1484
+ category: "Diagrams",
1485
+ args: [
1486
+ { name: "id", type: "string", required: true, description: "The ID of the diagram" },
1487
+ { name: "version", type: "string", required: true, description: "Version to check" }
1488
+ ],
1489
+ examples: [
1490
+ {
1491
+ description: "Check if version exists",
1492
+ command: 'npx @eventcatalog/sdk diagramHasVersion "ArchitectureDiagram" "1.0.0"'
1493
+ }
1494
+ ]
1495
+ },
1496
+ // ================================
1396
1497
  // Messages
1397
1498
  // ================================
1398
1499
  {