@epilot/sdk 2.20.33 → 2.20.34

package/dist/{event-catalog.d-CCE1qmBN.d.cts → event-catalog.d-BQqG_LGF.d.cts}

@@ -114,6 +114,52 @@ declare namespace Components {
             base_event_name: string;
             base_event_version: string;
         }
+        /**
+         * A pending successor to a published custom event, with the version it would become.
+         *
+         */
+        export interface CustomEventVersionDraft {
+            config: /* Event configuration with required fields */ EventConfig;
+            /**
+             * How the draft differs from the live version.
+             * - `none`: nothing changed, so there is nothing to publish.
+             * - `minor`: purely additive — new payload fields or new graph nodes. Pinned consumers keep
+             *   their exact shape once the additions are stripped.
+             * - `major`: an existing field's projection changed. The schema is unchanged, so only a
+             *   version bump tells a pinned consumer that familiar fields now carry different values.
+             * - `blocked`: removals, retypes or loosened requiredness. These need a transformer only a
+             *   human can author, or data that no longer travels with the event.
+             *
+             */
+            change_class: "none" | "minor" | "major" | "blocked";
+            /**
+             * The version this draft would be published as. Null when `change_class` is none or blocked.
+             * example:
+             * 1.1
+             */
+            next_version?: string | null;
+            /**
+             * Declared field-level changes against the live version.
+             */
+            changes: /**
+             * A field-level change descriptor. Powers the declarative half of the
+             * version DSL.
+             *
+             */
+            FieldChange[];
+            /**
+             * Fields whose projection changed while their schema stayed identical.
+             */
+            remapped_fields: string[];
+            /**
+             * Entity-graph nodes this draft adds, which surface as new top-level payload keys.
+             */
+            added_nodes: string[];
+            /**
+             * Why the draft cannot be versioned automatically. Present only when `change_class` is `blocked`.
+             */
+            blocked_reason?: string;
+        }
         /**
          * Custom v1 fields support graph-projected JSON Schema values and context entities; attachment semantics are built-in-only.
          */
@@ -1172,6 +1218,18 @@ declare namespace Components {
              */
             base_auto_trigger_enabled?: boolean;
         }
+        export interface PublishCustomEventVersionPayload {
+            /**
+             * One line describing what changed, shown on the event's version timeline. Derived from the
+             * diff when omitted.
+             *
+             */
+            change_summary?: string;
+            /**
+             * Optional longer-form prose (markdown) for the version timeline.
+             */
+            change_notes?: string;
+        }
         export interface PurposeFilterSnapshot {
             id: string;
             display_name: string;
@@ -1482,6 +1540,20 @@ declare namespace Paths {
             }
         }
     }
+    namespace DeleteCustomEventVersionDraft {
+        namespace Parameters {
+            export type EventName = string;
+        }
+        export interface PathParameters {
+            event_name: Parameters.EventName;
+        }
+        namespace Responses {
+            export interface $204 {
+            }
+            export interface $404 {
+            }
+        }
+    }
     namespace DeprecateCustomEvent {
         namespace Parameters {
             export type EventName = string;
@@ -1498,6 +1570,23 @@ declare namespace Paths {
             }
         }
     }
+    namespace GetCustomEventVersionDraft {
+        namespace Parameters {
+            export type EventName = string;
+        }
+        export interface PathParameters {
+            event_name: Parameters.EventName;
+        }
+        namespace Responses {
+            export type $200 = /**
+             * A pending successor to a published custom event, with the version it would become.
+             *
+             */
+            Components.Schemas.CustomEventVersionDraft;
+            export interface $404 {
+            }
+        }
+    }
     namespace GetEvent {
         namespace Parameters {
             export type EventName = string;
@@ -1809,6 +1898,48 @@ declare namespace Paths {
             }
         }
     }
+    namespace PublishCustomEventVersion {
+        namespace Parameters {
+            export type EventName = string;
+        }
+        export interface PathParameters {
+            event_name: Parameters.EventName;
+        }
+        export type RequestBody = Components.Schemas.PublishCustomEventVersionPayload;
+        namespace Responses {
+            export type $200 = /* Event configuration with required fields */ Components.Schemas.EventConfig;
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+            export interface $409 {
+            }
+        }
+    }
+    namespace PutCustomEventVersionDraft {
+        namespace Parameters {
+            export type EventName = string;
+        }
+        export interface PathParameters {
+            event_name: Parameters.EventName;
+        }
+        export type RequestBody = /* Complete immutable custom-event v1.0 definition projected from a required entity graph. Publication is a separate conditional action. */ Components.Schemas.CreateCustomEventPayload;
+        namespace Responses {
+            export type $200 = /**
+             * A pending successor to a published custom event, with the version it would become.
+             *
+             */
+            Components.Schemas.CustomEventVersionDraft;
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+            export interface $409 {
+            }
+            export interface $422 {
+            }
+        }
+    }
     namespace ReplaceCustomEventDraft {
         namespace Parameters {
             export type EventName = string;
@@ -2065,6 +2196,61 @@ interface OperationMethods {
     data?: Paths.PublishCustomEventDefinition.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.PublishCustomEventDefinition.Responses.$200>
+  /**
+   * getCustomEventVersionDraft - getCustomEventVersionDraft
+   * 
+   * Read the in-progress successor of a published custom event, together with the version it
+   * would be published as. The live version keeps firing while the successor is authored.
+   * 
+   */
+  'getCustomEventVersionDraft'(
+    parameters?: Parameters<Paths.GetCustomEventVersionDraft.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetCustomEventVersionDraft.Responses.$200>
+  /**
+   * putCustomEventVersionDraft - putCustomEventVersionDraft
+   * 
+   * Create or replace the successor of a published custom event. The published definition stays
+   * immutable and keeps firing; only publishing the draft promotes it.
+   * 
+   * The response classifies the change against the live version: additive changes mint a MINOR,
+   * a changed projection mints a MAJOR (the schema is identical, so nothing else would warn a
+   * pinned consumer that the values moved), and removals, retypes and loosened requiredness are
+   * rejected as `blocked` because no sound downgrade can be generated for them.
+   * 
+   */
+  'putCustomEventVersionDraft'(
+    parameters?: Parameters<Paths.PutCustomEventVersionDraft.PathParameters> | null,
+    data?: Paths.PutCustomEventVersionDraft.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PutCustomEventVersionDraft.Responses.$200>
+  /**
+   * deleteCustomEventVersionDraft - deleteCustomEventVersionDraft
+   * 
+   * Discard the next-version draft. The published version is untouched.
+   */
+  'deleteCustomEventVersionDraft'(
+    parameters?: Parameters<Paths.DeleteCustomEventVersionDraft.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.DeleteCustomEventVersionDraft.Responses.$204>
+  /**
+   * publishCustomEventVersion - publishCustomEventVersion
+   * 
+   * Publish the next-version draft as the event's new live version.
+   * 
+   * The version label, the declared field changes and the JSONata downgrade back to the previous
+   * version are all derived from the diff — never supplied by the caller — so the downgrade
+   * cannot disagree with the definition it accompanies. Consumers pinned to an earlier version
+   * keep receiving their own shape through the stamped downgrade chain.
+   * 
+   */
+  'publishCustomEventVersion'(
+    parameters?: Parameters<Paths.PublishCustomEventVersion.PathParameters> | null,
+    data?: Paths.PublishCustomEventVersion.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PublishCustomEventVersion.Responses.$200>
   /**
    * getEventJSONSchema - getEventJSONSchema
    * 
@@ -2255,6 +2441,65 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.PublishCustomEventDefinition.Responses.$200>
   }
+  ['/v1/events/{event_name}/version_draft']: {
+    /**
+     * getCustomEventVersionDraft - getCustomEventVersionDraft
+     * 
+     * Read the in-progress successor of a published custom event, together with the version it
+     * would be published as. The live version keeps firing while the successor is authored.
+     * 
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetCustomEventVersionDraft.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetCustomEventVersionDraft.Responses.$200>
+    /**
+     * putCustomEventVersionDraft - putCustomEventVersionDraft
+     * 
+     * Create or replace the successor of a published custom event. The published definition stays
+     * immutable and keeps firing; only publishing the draft promotes it.
+     * 
+     * The response classifies the change against the live version: additive changes mint a MINOR,
+     * a changed projection mints a MAJOR (the schema is identical, so nothing else would warn a
+     * pinned consumer that the values moved), and removals, retypes and loosened requiredness are
+     * rejected as `blocked` because no sound downgrade can be generated for them.
+     * 
+     */
+    'put'(
+      parameters?: Parameters<Paths.PutCustomEventVersionDraft.PathParameters> | null,
+      data?: Paths.PutCustomEventVersionDraft.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PutCustomEventVersionDraft.Responses.$200>
+    /**
+     * deleteCustomEventVersionDraft - deleteCustomEventVersionDraft
+     * 
+     * Discard the next-version draft. The published version is untouched.
+     */
+    'delete'(
+      parameters?: Parameters<Paths.DeleteCustomEventVersionDraft.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.DeleteCustomEventVersionDraft.Responses.$204>
+  }
+  ['/v1/events/{event_name}/version_draft:publish']: {
+    /**
+     * publishCustomEventVersion - publishCustomEventVersion
+     * 
+     * Publish the next-version draft as the event's new live version.
+     * 
+     * The version label, the declared field changes and the JSONata downgrade back to the previous
+     * version are all derived from the diff — never supplied by the caller — so the downgrade
+     * cannot disagree with the definition it accompanies. Consumers pinned to an earlier version
+     * keep receiving their own shape through the stamped downgrade chain.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.PublishCustomEventVersion.PathParameters> | null,
+      data?: Paths.PublishCustomEventVersion.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PublishCustomEventVersion.Responses.$200>
+  }
   ['/v1/events/{event_name}/json_schema']: {
     /**
      * getEventJSONSchema - getEventJSONSchema
@@ -2375,6 +2620,7 @@ type CommonEventMetadata = Components.Schemas.CommonEventMetadata;
 type ContextEntity = Components.Schemas.ContextEntity;
 type CreateCustomEventPayload = Components.Schemas.CreateCustomEventPayload;
 type CustomEventLineage = Components.Schemas.CustomEventLineage;
+type CustomEventVersionDraft = Components.Schemas.CustomEventVersionDraft;
 type CustomSchemaField = Components.Schemas.CustomSchemaField;
 type EntityOperationTrigger = Components.Schemas.EntityOperationTrigger;
 type Event = Components.Schemas.Event;
@@ -2394,6 +2640,7 @@ type InlineDowngradeStep = Components.Schemas.InlineDowngradeStep;
 type PreviewEventResponse = Components.Schemas.PreviewEventResponse;
 type PrimitiveField = Components.Schemas.PrimitiveField;
 type PublishCustomEventPayload = Components.Schemas.PublishCustomEventPayload;
+type PublishCustomEventVersionPayload = Components.Schemas.PublishCustomEventVersionPayload;
 type PurposeFilterSnapshot = Components.Schemas.PurposeFilterSnapshot;
 type SchemaField = Components.Schemas.SchemaField;
 type SearchOptions = Components.Schemas.SearchOptions;
@@ -2405,4 +2652,4 @@ type UpdateEventPayload = Components.Schemas.UpdateEventPayload;
 type ValidationIssue = Components.Schemas.ValidationIssue;
 type VersionMeta = Components.Schemas.VersionMeta;
 
-export { type AttachmentField as A, type VersionMeta as B, type Client as C, type EntityOperationTrigger as E, type FieldChange as F, type GraphDefinition as G, type InlineDowngradeStep as I, type OperationMethods as O, Paths as P, type SchemaField as S, type TriggerEventPayload as T, type UpdateEventPayload as U, type ValidationIssue as V, Components as a, type PathsDictionary as b, type CommonEventMetadata as c, type ContextEntity as d, type CreateCustomEventPayload as e, type CustomEventLineage as f, type CustomSchemaField as g, type Event as h, type EventAttachment as i, type EventConfig as j, type EventConfigBase as k, type EventJsonSchema as l, type EventMapping as m, type EventSummary as n, type EventVersionRegistrySummary as o, type FieldsParam as p, type GraphEdge as q, type GraphNode as r, type PreviewEventResponse as s, type PrimitiveField as t, type PublishCustomEventPayload as u, type PurposeFilterSnapshot as v, type SearchOptions as w, type SearchOptionsV2 as x, type SuccessCriterion as y, type TriggerEventResponse as z };
+export { type AttachmentField as A, type SuccessCriterion as B, type Client as C, type TriggerEventResponse as D, type EntityOperationTrigger as E, type FieldChange as F, type GraphDefinition as G, type VersionMeta as H, type InlineDowngradeStep as I, type OperationMethods as O, Paths as P, type SchemaField as S, type TriggerEventPayload as T, type UpdateEventPayload as U, type ValidationIssue as V, Components as a, type PathsDictionary as b, type CommonEventMetadata as c, type ContextEntity as d, type CreateCustomEventPayload as e, type CustomEventLineage as f, type CustomEventVersionDraft as g, type CustomSchemaField as h, type Event as i, type EventAttachment as j, type EventConfig as k, type EventConfigBase as l, type EventJsonSchema as m, type EventMapping as n, type EventSummary as o, type EventVersionRegistrySummary as p, type FieldsParam as q, type GraphEdge as r, type GraphNode as s, type PreviewEventResponse as t, type PrimitiveField as u, type PublishCustomEventPayload as v, type PublishCustomEventVersionPayload as w, type PurposeFilterSnapshot as x, type SearchOptions as y, type SearchOptionsV2 as z };

package/dist/{event-catalog.d-CCE1qmBN.d.ts → event-catalog.d-BQqG_LGF.d.ts}

@@ -114,6 +114,52 @@ declare namespace Components {
             base_event_name: string;
             base_event_version: string;
         }
+        /**
+         * A pending successor to a published custom event, with the version it would become.
+         *
+         */
+        export interface CustomEventVersionDraft {
+            config: /* Event configuration with required fields */ EventConfig;
+            /**
+             * How the draft differs from the live version.
+             * - `none`: nothing changed, so there is nothing to publish.
+             * - `minor`: purely additive — new payload fields or new graph nodes. Pinned consumers keep
+             *   their exact shape once the additions are stripped.
+             * - `major`: an existing field's projection changed. The schema is unchanged, so only a
+             *   version bump tells a pinned consumer that familiar fields now carry different values.
+             * - `blocked`: removals, retypes or loosened requiredness. These need a transformer only a
+             *   human can author, or data that no longer travels with the event.
+             *
+             */
+            change_class: "none" | "minor" | "major" | "blocked";
+            /**
+             * The version this draft would be published as. Null when `change_class` is none or blocked.
+             * example:
+             * 1.1
+             */
+            next_version?: string | null;
+            /**
+             * Declared field-level changes against the live version.
+             */
+            changes: /**
+             * A field-level change descriptor. Powers the declarative half of the
+             * version DSL.
+             *
+             */
+            FieldChange[];
+            /**
+             * Fields whose projection changed while their schema stayed identical.
+             */
+            remapped_fields: string[];
+            /**
+             * Entity-graph nodes this draft adds, which surface as new top-level payload keys.
+             */
+            added_nodes: string[];
+            /**
+             * Why the draft cannot be versioned automatically. Present only when `change_class` is `blocked`.
+             */
+            blocked_reason?: string;
+        }
         /**
          * Custom v1 fields support graph-projected JSON Schema values and context entities; attachment semantics are built-in-only.
          */
@@ -1172,6 +1218,18 @@ declare namespace Components {
              */
             base_auto_trigger_enabled?: boolean;
         }
+        export interface PublishCustomEventVersionPayload {
+            /**
+             * One line describing what changed, shown on the event's version timeline. Derived from the
+             * diff when omitted.
+             *
+             */
+            change_summary?: string;
+            /**
+             * Optional longer-form prose (markdown) for the version timeline.
+             */
+            change_notes?: string;
+        }
         export interface PurposeFilterSnapshot {
             id: string;
             display_name: string;
@@ -1482,6 +1540,20 @@ declare namespace Paths {
             }
         }
     }
+    namespace DeleteCustomEventVersionDraft {
+        namespace Parameters {
+            export type EventName = string;
+        }
+        export interface PathParameters {
+            event_name: Parameters.EventName;
+        }
+        namespace Responses {
+            export interface $204 {
+            }
+            export interface $404 {
+            }
+        }
+    }
     namespace DeprecateCustomEvent {
         namespace Parameters {
             export type EventName = string;
@@ -1498,6 +1570,23 @@ declare namespace Paths {
             }
         }
     }
+    namespace GetCustomEventVersionDraft {
+        namespace Parameters {
+            export type EventName = string;
+        }
+        export interface PathParameters {
+            event_name: Parameters.EventName;
+        }
+        namespace Responses {
+            export type $200 = /**
+             * A pending successor to a published custom event, with the version it would become.
+             *
+             */
+            Components.Schemas.CustomEventVersionDraft;
+            export interface $404 {
+            }
+        }
+    }
     namespace GetEvent {
         namespace Parameters {
             export type EventName = string;
@@ -1809,6 +1898,48 @@ declare namespace Paths {
             }
         }
     }
+    namespace PublishCustomEventVersion {
+        namespace Parameters {
+            export type EventName = string;
+        }
+        export interface PathParameters {
+            event_name: Parameters.EventName;
+        }
+        export type RequestBody = Components.Schemas.PublishCustomEventVersionPayload;
+        namespace Responses {
+            export type $200 = /* Event configuration with required fields */ Components.Schemas.EventConfig;
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+            export interface $409 {
+            }
+        }
+    }
+    namespace PutCustomEventVersionDraft {
+        namespace Parameters {
+            export type EventName = string;
+        }
+        export interface PathParameters {
+            event_name: Parameters.EventName;
+        }
+        export type RequestBody = /* Complete immutable custom-event v1.0 definition projected from a required entity graph. Publication is a separate conditional action. */ Components.Schemas.CreateCustomEventPayload;
+        namespace Responses {
+            export type $200 = /**
+             * A pending successor to a published custom event, with the version it would become.
+             *
+             */
+            Components.Schemas.CustomEventVersionDraft;
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+            export interface $409 {
+            }
+            export interface $422 {
+            }
+        }
+    }
     namespace ReplaceCustomEventDraft {
         namespace Parameters {
             export type EventName = string;
@@ -2065,6 +2196,61 @@ interface OperationMethods {
     data?: Paths.PublishCustomEventDefinition.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.PublishCustomEventDefinition.Responses.$200>
+  /**
+   * getCustomEventVersionDraft - getCustomEventVersionDraft
+   * 
+   * Read the in-progress successor of a published custom event, together with the version it
+   * would be published as. The live version keeps firing while the successor is authored.
+   * 
+   */
+  'getCustomEventVersionDraft'(
+    parameters?: Parameters<Paths.GetCustomEventVersionDraft.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetCustomEventVersionDraft.Responses.$200>
+  /**
+   * putCustomEventVersionDraft - putCustomEventVersionDraft
+   * 
+   * Create or replace the successor of a published custom event. The published definition stays
+   * immutable and keeps firing; only publishing the draft promotes it.
+   * 
+   * The response classifies the change against the live version: additive changes mint a MINOR,
+   * a changed projection mints a MAJOR (the schema is identical, so nothing else would warn a
+   * pinned consumer that the values moved), and removals, retypes and loosened requiredness are
+   * rejected as `blocked` because no sound downgrade can be generated for them.
+   * 
+   */
+  'putCustomEventVersionDraft'(
+    parameters?: Parameters<Paths.PutCustomEventVersionDraft.PathParameters> | null,
+    data?: Paths.PutCustomEventVersionDraft.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PutCustomEventVersionDraft.Responses.$200>
+  /**
+   * deleteCustomEventVersionDraft - deleteCustomEventVersionDraft
+   * 
+   * Discard the next-version draft. The published version is untouched.
+   */
+  'deleteCustomEventVersionDraft'(
+    parameters?: Parameters<Paths.DeleteCustomEventVersionDraft.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.DeleteCustomEventVersionDraft.Responses.$204>
+  /**
+   * publishCustomEventVersion - publishCustomEventVersion
+   * 
+   * Publish the next-version draft as the event's new live version.
+   * 
+   * The version label, the declared field changes and the JSONata downgrade back to the previous
+   * version are all derived from the diff — never supplied by the caller — so the downgrade
+   * cannot disagree with the definition it accompanies. Consumers pinned to an earlier version
+   * keep receiving their own shape through the stamped downgrade chain.
+   * 
+   */
+  'publishCustomEventVersion'(
+    parameters?: Parameters<Paths.PublishCustomEventVersion.PathParameters> | null,
+    data?: Paths.PublishCustomEventVersion.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PublishCustomEventVersion.Responses.$200>
   /**
    * getEventJSONSchema - getEventJSONSchema
    * 
@@ -2255,6 +2441,65 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.PublishCustomEventDefinition.Responses.$200>
   }
+  ['/v1/events/{event_name}/version_draft']: {
+    /**
+     * getCustomEventVersionDraft - getCustomEventVersionDraft
+     * 
+     * Read the in-progress successor of a published custom event, together with the version it
+     * would be published as. The live version keeps firing while the successor is authored.
+     * 
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetCustomEventVersionDraft.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetCustomEventVersionDraft.Responses.$200>
+    /**
+     * putCustomEventVersionDraft - putCustomEventVersionDraft
+     * 
+     * Create or replace the successor of a published custom event. The published definition stays
+     * immutable and keeps firing; only publishing the draft promotes it.
+     * 
+     * The response classifies the change against the live version: additive changes mint a MINOR,
+     * a changed projection mints a MAJOR (the schema is identical, so nothing else would warn a
+     * pinned consumer that the values moved), and removals, retypes and loosened requiredness are
+     * rejected as `blocked` because no sound downgrade can be generated for them.
+     * 
+     */
+    'put'(
+      parameters?: Parameters<Paths.PutCustomEventVersionDraft.PathParameters> | null,
+      data?: Paths.PutCustomEventVersionDraft.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PutCustomEventVersionDraft.Responses.$200>
+    /**
+     * deleteCustomEventVersionDraft - deleteCustomEventVersionDraft
+     * 
+     * Discard the next-version draft. The published version is untouched.
+     */
+    'delete'(
+      parameters?: Parameters<Paths.DeleteCustomEventVersionDraft.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.DeleteCustomEventVersionDraft.Responses.$204>
+  }
+  ['/v1/events/{event_name}/version_draft:publish']: {
+    /**
+     * publishCustomEventVersion - publishCustomEventVersion
+     * 
+     * Publish the next-version draft as the event's new live version.
+     * 
+     * The version label, the declared field changes and the JSONata downgrade back to the previous
+     * version are all derived from the diff — never supplied by the caller — so the downgrade
+     * cannot disagree with the definition it accompanies. Consumers pinned to an earlier version
+     * keep receiving their own shape through the stamped downgrade chain.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.PublishCustomEventVersion.PathParameters> | null,
+      data?: Paths.PublishCustomEventVersion.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PublishCustomEventVersion.Responses.$200>
+  }
   ['/v1/events/{event_name}/json_schema']: {
     /**
      * getEventJSONSchema - getEventJSONSchema
@@ -2375,6 +2620,7 @@ type CommonEventMetadata = Components.Schemas.CommonEventMetadata;
 type ContextEntity = Components.Schemas.ContextEntity;
 type CreateCustomEventPayload = Components.Schemas.CreateCustomEventPayload;
 type CustomEventLineage = Components.Schemas.CustomEventLineage;
+type CustomEventVersionDraft = Components.Schemas.CustomEventVersionDraft;
 type CustomSchemaField = Components.Schemas.CustomSchemaField;
 type EntityOperationTrigger = Components.Schemas.EntityOperationTrigger;
 type Event = Components.Schemas.Event;
@@ -2394,6 +2640,7 @@ type InlineDowngradeStep = Components.Schemas.InlineDowngradeStep;
 type PreviewEventResponse = Components.Schemas.PreviewEventResponse;
 type PrimitiveField = Components.Schemas.PrimitiveField;
 type PublishCustomEventPayload = Components.Schemas.PublishCustomEventPayload;
+type PublishCustomEventVersionPayload = Components.Schemas.PublishCustomEventVersionPayload;
 type PurposeFilterSnapshot = Components.Schemas.PurposeFilterSnapshot;
 type SchemaField = Components.Schemas.SchemaField;
 type SearchOptions = Components.Schemas.SearchOptions;
@@ -2405,4 +2652,4 @@ type UpdateEventPayload = Components.Schemas.UpdateEventPayload;
 type ValidationIssue = Components.Schemas.ValidationIssue;
 type VersionMeta = Components.Schemas.VersionMeta;
 
-export { type AttachmentField as A, type VersionMeta as B, type Client as C, type EntityOperationTrigger as E, type FieldChange as F, type GraphDefinition as G, type InlineDowngradeStep as I, type OperationMethods as O, Paths as P, type SchemaField as S, type TriggerEventPayload as T, type UpdateEventPayload as U, type ValidationIssue as V, Components as a, type PathsDictionary as b, type CommonEventMetadata as c, type ContextEntity as d, type CreateCustomEventPayload as e, type CustomEventLineage as f, type CustomSchemaField as g, type Event as h, type EventAttachment as i, type EventConfig as j, type EventConfigBase as k, type EventJsonSchema as l, type EventMapping as m, type EventSummary as n, type EventVersionRegistrySummary as o, type FieldsParam as p, type GraphEdge as q, type GraphNode as r, type PreviewEventResponse as s, type PrimitiveField as t, type PublishCustomEventPayload as u, type PurposeFilterSnapshot as v, type SearchOptions as w, type SearchOptionsV2 as x, type SuccessCriterion as y, type TriggerEventResponse as z };
+export { type AttachmentField as A, type SuccessCriterion as B, type Client as C, type TriggerEventResponse as D, type EntityOperationTrigger as E, type FieldChange as F, type GraphDefinition as G, type VersionMeta as H, type InlineDowngradeStep as I, type OperationMethods as O, Paths as P, type SchemaField as S, type TriggerEventPayload as T, type UpdateEventPayload as U, type ValidationIssue as V, Components as a, type PathsDictionary as b, type CommonEventMetadata as c, type ContextEntity as d, type CreateCustomEventPayload as e, type CustomEventLineage as f, type CustomEventVersionDraft as g, type CustomSchemaField as h, type Event as i, type EventAttachment as j, type EventConfig as k, type EventConfigBase as l, type EventJsonSchema as m, type EventMapping as n, type EventSummary as o, type EventVersionRegistrySummary as p, type FieldsParam as q, type GraphEdge as r, type GraphNode as s, type PreviewEventResponse as t, type PrimitiveField as u, type PublishCustomEventPayload as v, type PublishCustomEventVersionPayload as w, type PurposeFilterSnapshot as x, type SearchOptions as y, type SearchOptionsV2 as z };