@eventcatalog/sdk 2.16.0 → 2.17.1

package/dist/index.d.mts

@@ -360,6 +360,86 @@ interface ToDSLOptions {
     hydrate?: boolean;
 }
 
+type SnapshotGitInfo = {
+    branch: string;
+    commit: string;
+    dirty: boolean;
+};
+type SnapshotResources = {
+    domains: Record<string, any>[];
+    services: Record<string, any>[];
+    messages: {
+        events: Record<string, any>[];
+        commands: Record<string, any>[];
+        queries: Record<string, any>[];
+    };
+    channels: Record<string, any>[];
+};
+type CatalogSnapshot = {
+    snapshotVersion: string;
+    catalogVersion: string;
+    label: string;
+    createdAt: string;
+    git?: SnapshotGitInfo;
+    resources: SnapshotResources;
+};
+type SnapshotOptions = {
+    label?: string;
+    outputDir?: string;
+    git?: SnapshotGitInfo;
+};
+type SnapshotResult = {
+    filePath: string;
+    snapshot: CatalogSnapshot;
+};
+type SnapshotMeta = {
+    label: string;
+    createdAt: string;
+    filePath: string;
+    git?: SnapshotGitInfo;
+};
+type SnapshotResourceType = 'event' | 'command' | 'query' | 'service' | 'domain' | 'channel';
+type ResourceChangeType = 'added' | 'removed' | 'modified' | 'versioned';
+type ResourceChange = {
+    resourceId: string;
+    version: string;
+    type: SnapshotResourceType;
+    changeType: ResourceChangeType;
+    changedFields?: string[];
+    previousVersion?: string;
+    newVersion?: string;
+};
+type RelationshipChange = {
+    serviceId: string;
+    serviceVersion: string;
+    resourceId: string;
+    resourceVersion?: string;
+    direction: 'sends' | 'receives';
+    changeType: 'added' | 'removed';
+};
+type DiffSummary = {
+    totalChanges: number;
+    resourcesAdded: number;
+    resourcesRemoved: number;
+    resourcesModified: number;
+    resourcesVersioned: number;
+    relationshipsAdded: number;
+    relationshipsRemoved: number;
+};
+type SnapshotDiff = {
+    snapshotA: {
+        label: string;
+        createdAt: string;
+    };
+    snapshotB: {
+        label: string;
+        createdAt: string;
+    };
+    summary: DiffSummary;
+    resources: ResourceChange[];
+    relationships: RelationshipChange[];
+};
+
 /**
  * Init the SDK for EventCatalog
  *
@@ -1445,6 +1525,17 @@ declare const _default: (path: string) => {
      * @returns Service[]
      */
     getProducersOfSchema: (path: string) => Promise<Service[]>;
+    /**
+     * Returns the schema for a given message (event, command or query) by its id and version.
+     * If no version is given, the latest version is used.
+     * @param id - The id of the message to get the schema for
+     * @param version - Optional version of the message
+     * @returns { schema: string, fileName: string } | undefined
+     */
+    getSchemaForMessage: (id: string, version?: string) => Promise<{
+        schema: string;
+        fileName: string;
+    } | undefined>;
     /**
      * Returns the owners for a given resource (e.g domain, service, event, command, query, etc.)
      * @param id - The id of the resource to get the owners for
@@ -1770,7 +1861,10 @@ declare const _default: (path: string) => {
      * const dsl = await sdk.toDSL(services, { type: 'service', hydrate: true });
      * ```
      */
+    createSnapshot: (options?: SnapshotOptions) => Promise<SnapshotResult>;
+    diffSnapshots: (snapshotAPath: string, snapshotBPath: string) => Promise<SnapshotDiff>;
+    listSnapshots: () => Promise<SnapshotMeta[]>;
     toDSL: (resource: (Event | Command | Query | Service | Domain) | (Event | Command | Query | Service | Domain)[], options: ToDSLOptions) => Promise<string>;
 };
 
-export { type Badge, type BaseSchema, type Changelog, type Channel, type ChannelPointer, type Command, type Container, type CustomDoc, type DataProduct, type DataProductOutputPointer, type Diagram, type Domain, type Entity, type Event, type EventCatalog, type Message, type Operation, type Query, type ReceivesPointer, type ResourceGroup, type ResourcePointer, type SendsPointer, type Service, type Specification, type Specifications, type Team, type UbiquitousLanguage, type UbiquitousLanguageDictionary, type User, _default as default };
+export { type Badge, type BaseSchema, type CatalogSnapshot, type Changelog, type Channel, type ChannelPointer, type Command, type Container, type CustomDoc, type DataProduct, type DataProductOutputPointer, type Diagram, type DiffSummary, type Domain, type Entity, type Event, type EventCatalog, type Message, type Operation, type Query, type ReceivesPointer, type RelationshipChange, type ResourceChange, type ResourceChangeType, type ResourceGroup, type ResourcePointer, type SendsPointer, type Service, type SnapshotDiff, type SnapshotGitInfo, type SnapshotMeta, type SnapshotOptions, type SnapshotResourceType, type SnapshotResources, type SnapshotResult, type Specification, type Specifications, type Team, type UbiquitousLanguage, type UbiquitousLanguageDictionary, type User, _default as default };

package/dist/index.d.ts

@@ -360,6 +360,86 @@ interface ToDSLOptions {
     hydrate?: boolean;
 }
 
+type SnapshotGitInfo = {
+    branch: string;
+    commit: string;
+    dirty: boolean;
+};
+type SnapshotResources = {
+    domains: Record<string, any>[];
+    services: Record<string, any>[];
+    messages: {
+        events: Record<string, any>[];
+        commands: Record<string, any>[];
+        queries: Record<string, any>[];
+    };
+    channels: Record<string, any>[];
+};
+type CatalogSnapshot = {
+    snapshotVersion: string;
+    catalogVersion: string;
+    label: string;
+    createdAt: string;
+    git?: SnapshotGitInfo;
+    resources: SnapshotResources;
+};
+type SnapshotOptions = {
+    label?: string;
+    outputDir?: string;
+    git?: SnapshotGitInfo;
+};
+type SnapshotResult = {
+    filePath: string;
+    snapshot: CatalogSnapshot;
+};
+type SnapshotMeta = {
+    label: string;
+    createdAt: string;
+    filePath: string;
+    git?: SnapshotGitInfo;
+};
+type SnapshotResourceType = 'event' | 'command' | 'query' | 'service' | 'domain' | 'channel';
+type ResourceChangeType = 'added' | 'removed' | 'modified' | 'versioned';
+type ResourceChange = {
+    resourceId: string;
+    version: string;
+    type: SnapshotResourceType;
+    changeType: ResourceChangeType;
+    changedFields?: string[];
+    previousVersion?: string;
+    newVersion?: string;
+};
+type RelationshipChange = {
+    serviceId: string;
+    serviceVersion: string;
+    resourceId: string;
+    resourceVersion?: string;
+    direction: 'sends' | 'receives';
+    changeType: 'added' | 'removed';
+};
+type DiffSummary = {
+    totalChanges: number;
+    resourcesAdded: number;
+    resourcesRemoved: number;
+    resourcesModified: number;
+    resourcesVersioned: number;
+    relationshipsAdded: number;
+    relationshipsRemoved: number;
+};
+type SnapshotDiff = {
+    snapshotA: {
+        label: string;
+        createdAt: string;
+    };
+    snapshotB: {
+        label: string;
+        createdAt: string;
+    };
+    summary: DiffSummary;
+    resources: ResourceChange[];
+    relationships: RelationshipChange[];
+};
+
 /**
  * Init the SDK for EventCatalog
  *
@@ -1445,6 +1525,17 @@ declare const _default: (path: string) => {
      * @returns Service[]
      */
     getProducersOfSchema: (path: string) => Promise<Service[]>;
+    /**
+     * Returns the schema for a given message (event, command or query) by its id and version.
+     * If no version is given, the latest version is used.
+     * @param id - The id of the message to get the schema for
+     * @param version - Optional version of the message
+     * @returns { schema: string, fileName: string } | undefined
+     */
+    getSchemaForMessage: (id: string, version?: string) => Promise<{
+        schema: string;
+        fileName: string;
+    } | undefined>;
     /**
      * Returns the owners for a given resource (e.g domain, service, event, command, query, etc.)
      * @param id - The id of the resource to get the owners for
@@ -1770,7 +1861,10 @@ declare const _default: (path: string) => {
      * const dsl = await sdk.toDSL(services, { type: 'service', hydrate: true });
      * ```
      */
+    createSnapshot: (options?: SnapshotOptions) => Promise<SnapshotResult>;
+    diffSnapshots: (snapshotAPath: string, snapshotBPath: string) => Promise<SnapshotDiff>;
+    listSnapshots: () => Promise<SnapshotMeta[]>;
     toDSL: (resource: (Event | Command | Query | Service | Domain) | (Event | Command | Query | Service | Domain)[], options: ToDSLOptions) => Promise<string>;
 };
 
-export { type Badge, type BaseSchema, type Changelog, type Channel, type ChannelPointer, type Command, type Container, type CustomDoc, type DataProduct, type DataProductOutputPointer, type Diagram, type Domain, type Entity, type Event, type EventCatalog, type Message, type Operation, type Query, type ReceivesPointer, type ResourceGroup, type ResourcePointer, type SendsPointer, type Service, type Specification, type Specifications, type Team, type UbiquitousLanguage, type UbiquitousLanguageDictionary, type User, _default as default };
+export { type Badge, type BaseSchema, type CatalogSnapshot, type Changelog, type Channel, type ChannelPointer, type Command, type Container, type CustomDoc, type DataProduct, type DataProductOutputPointer, type Diagram, type DiffSummary, type Domain, type Entity, type Event, type EventCatalog, type Message, type Operation, type Query, type ReceivesPointer, type RelationshipChange, type ResourceChange, type ResourceChangeType, type ResourceGroup, type ResourcePointer, type SendsPointer, type Service, type SnapshotDiff, type SnapshotGitInfo, type SnapshotMeta, type SnapshotOptions, type SnapshotResourceType, type SnapshotResources, type SnapshotResult, type Specification, type Specifications, type Team, type UbiquitousLanguage, type UbiquitousLanguageDictionary, type User, _default as default };