@epilot/sdk 2.20.18 → 2.20.20

package/dist/{journey-runtime-EFWGEDUE.cjs → journey-runtime-BVSPJTYH.cjs}

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkW6R2J6KQcjs = require('./chunk-W6R2J6KQ.cjs');
+var _chunkX7UJYAG5cjs = require('./chunk-X7UJYAG5.cjs');
 require('./chunk-NJK5F5TF.cjs');
-exports. default = _chunkW6R2J6KQcjs.require_journey_runtime.call(void 0, );
+exports. default = _chunkX7UJYAG5cjs.require_journey_runtime.call(void 0, );

package/dist/{journey-runtime-VCADGDRV.js → journey-runtime-S5I3K4NH.js}

@@ -1,5 +1,5 @@
 import {
   require_journey_runtime
-} from "./chunk-HL4MZXEK.js";
+} from "./chunk-SJS5S6Z5.js";
 import "./chunk-YPSWSI3M.js";
 export default require_journey_runtime();

package/dist/{journey.d-6Bs1uNLT.d.ts → journey.d-DvwLALwc.d.cts}

@@ -1682,6 +1682,13 @@ declare namespace Components {
              * 12
              */
             mapping_config_version?: number;
+            /**
+             * What this save changed, for the revision history to list. Distinct from `name`, which is the journey's own name. A publish replaces it with the version name.
+             *
+             * example:
+             * Changes to Steps and Logic
+             */
+            revision_name?: string;
         }
         export interface JourneyRevisionSummary {
             /**
@@ -1720,6 +1727,17 @@ declare namespace Components {
              */
             mapping_config_version?: number;
         }
+        /**
+         * Which revision the runtime read served: the requested one, or the published version when no revision was requested. Absent while the journey has not adopted versioning and on legacy `version` reads.
+         *
+         */
+        export interface JourneyServedRevision {
+            /**
+             * example:
+             * 42
+             */
+            revision_id?: string;
+        }
         export interface JourneyValidationError {
             /**
              * Error type identifier
@@ -2243,6 +2261,11 @@ declare namespace Paths {
              */
             export type Id = string; // uuid
             export type OrgId = string;
+            /**
+             * example:
+             * 42
+             */
+            export type RevisionId = string;
             export type Source = string;
             export type Version = number;
         }
@@ -2255,12 +2278,17 @@ declare namespace Paths {
         }
         export interface QueryParameters {
             version?: Parameters.Version;
+            revision_id?: /**
+             * example:
+             * 42
+             */
+            Parameters.RevisionId;
             source?: Parameters.Source;
             orgId?: Parameters.OrgId;
         }
         namespace Responses {
             /**
-             * Journeys read from the API always carry an explicit `settings.isActive`. The flag remains optional in request bodies.
+             * Which revision the runtime read served: the requested one, or the published version when no revision was requested. Absent while the journey has not adopted versioning and on legacy `version` reads.
              *
              */
             export interface $200 {
@@ -2552,6 +2580,11 @@ declare namespace Paths {
                 featureFlags?: {
                     [name: string]: any;
                 };
+                /**
+                 * example:
+                 * 42
+                 */
+                revision_id?: string;
             }
         }
     }
@@ -3766,6 +3799,7 @@ type JourneyRevisionConflict = Components.Schemas.JourneyRevisionConflict;
 type JourneyRevisionList = Components.Schemas.JourneyRevisionList;
 type JourneyRevisionRequest = Components.Schemas.JourneyRevisionRequest;
 type JourneyRevisionSummary = Components.Schemas.JourneyRevisionSummary;
+type JourneyServedRevision = Components.Schemas.JourneyServedRevision;
 type JourneyValidationError = Components.Schemas.JourneyValidationError;
 type JourneyValidationResponse = Components.Schemas.JourneyValidationResponse;
 type PatchUpdateJourneyRequest = Components.Schemas.PatchUpdateJourneyRequest;
@@ -3778,4 +3812,4 @@ type SearchJourneysResponse = Components.Schemas.SearchJourneysResponse;
 type TemplateSettings = Components.Schemas.TemplateSettings;
 type ValidationRuleRef = Components.Schemas.ValidationRuleRef;
 
-export { type SearchJourneysQueryRequest as A, type ButtonOption as B, type Client as C, type SearchJourneysResponse as D, type EnvironmentMap as E, type GenerateDocumentRequest as G, type Journey as J, type OperationMethods as O, Paths as P, type RuleRef as R, type S3Reference as S, type TemplateSettings as T, type ValidationRuleRef as V, Components as a, type PathsDictionary as b, type EnvironmentMapEntry as c, type GenerateDocumentResponse as d, type GetJourneysResponse as e, GetSettingsForJourney as f, type JourneyActivationGuarantee as g, type JourneyAuditInfo as h, type JourneyCreationRequest as i, type JourneyCreationRequestV2 as j, type JourneyEnvironmentResponse as k, type JourneyEnvironmentVariablesResponse as l, type JourneyFeatureFlags as m, type JourneyProductsResponse as n, type JourneyPublishState as o, type JourneyResponse as p, type JourneyRevision as q, type JourneyRevisionConflict as r, type JourneyRevisionList as s, type JourneyRevisionRequest as t, type JourneyRevisionSummary as u, type JourneyValidationError as v, type JourneyValidationResponse as w, type PatchUpdateJourneyRequest as x, type PublishResult as y, type PublishRevisionRequest as z };
+export { type PublishRevisionRequest as A, type ButtonOption as B, type Client as C, type SearchJourneysQueryRequest as D, type EnvironmentMap as E, type SearchJourneysResponse as F, type GenerateDocumentRequest as G, type Journey as J, type OperationMethods as O, Paths as P, type RuleRef as R, type S3Reference as S, type TemplateSettings as T, type ValidationRuleRef as V, Components as a, type PathsDictionary as b, type EnvironmentMapEntry as c, type GenerateDocumentResponse as d, type GetJourneysResponse as e, GetSettingsForJourney as f, type JourneyActivationGuarantee as g, type JourneyAuditInfo as h, type JourneyCreationRequest as i, type JourneyCreationRequestV2 as j, type JourneyEnvironmentResponse as k, type JourneyEnvironmentVariablesResponse as l, type JourneyFeatureFlags as m, type JourneyProductsResponse as n, type JourneyPublishState as o, type JourneyResponse as p, type JourneyRevision as q, type JourneyRevisionConflict as r, type JourneyRevisionList as s, type JourneyRevisionRequest as t, type JourneyRevisionSummary as u, type JourneyServedRevision as v, type JourneyValidationError as w, type JourneyValidationResponse as x, type PatchUpdateJourneyRequest as y, type PublishResult as z };

package/dist/{journey.d-6Bs1uNLT.d.cts → journey.d-DvwLALwc.d.ts}

@@ -1682,6 +1682,13 @@ declare namespace Components {
              * 12
              */
             mapping_config_version?: number;
+            /**
+             * What this save changed, for the revision history to list. Distinct from `name`, which is the journey's own name. A publish replaces it with the version name.
+             *
+             * example:
+             * Changes to Steps and Logic
+             */
+            revision_name?: string;
         }
         export interface JourneyRevisionSummary {
             /**
@@ -1720,6 +1727,17 @@ declare namespace Components {
              */
             mapping_config_version?: number;
         }
+        /**
+         * Which revision the runtime read served: the requested one, or the published version when no revision was requested. Absent while the journey has not adopted versioning and on legacy `version` reads.
+         *
+         */
+        export interface JourneyServedRevision {
+            /**
+             * example:
+             * 42
+             */
+            revision_id?: string;
+        }
         export interface JourneyValidationError {
             /**
              * Error type identifier
@@ -2243,6 +2261,11 @@ declare namespace Paths {
              */
             export type Id = string; // uuid
             export type OrgId = string;
+            /**
+             * example:
+             * 42
+             */
+            export type RevisionId = string;
             export type Source = string;
             export type Version = number;
         }
@@ -2255,12 +2278,17 @@ declare namespace Paths {
         }
         export interface QueryParameters {
             version?: Parameters.Version;
+            revision_id?: /**
+             * example:
+             * 42
+             */
+            Parameters.RevisionId;
             source?: Parameters.Source;
             orgId?: Parameters.OrgId;
         }
         namespace Responses {
             /**
-             * Journeys read from the API always carry an explicit `settings.isActive`. The flag remains optional in request bodies.
+             * Which revision the runtime read served: the requested one, or the published version when no revision was requested. Absent while the journey has not adopted versioning and on legacy `version` reads.
              *
              */
             export interface $200 {
@@ -2552,6 +2580,11 @@ declare namespace Paths {
                 featureFlags?: {
                     [name: string]: any;
                 };
+                /**
+                 * example:
+                 * 42
+                 */
+                revision_id?: string;
             }
         }
     }
@@ -3766,6 +3799,7 @@ type JourneyRevisionConflict = Components.Schemas.JourneyRevisionConflict;
 type JourneyRevisionList = Components.Schemas.JourneyRevisionList;
 type JourneyRevisionRequest = Components.Schemas.JourneyRevisionRequest;
 type JourneyRevisionSummary = Components.Schemas.JourneyRevisionSummary;
+type JourneyServedRevision = Components.Schemas.JourneyServedRevision;
 type JourneyValidationError = Components.Schemas.JourneyValidationError;
 type JourneyValidationResponse = Components.Schemas.JourneyValidationResponse;
 type PatchUpdateJourneyRequest = Components.Schemas.PatchUpdateJourneyRequest;
@@ -3778,4 +3812,4 @@ type SearchJourneysResponse = Components.Schemas.SearchJourneysResponse;
 type TemplateSettings = Components.Schemas.TemplateSettings;
 type ValidationRuleRef = Components.Schemas.ValidationRuleRef;
 
-export { type SearchJourneysQueryRequest as A, type ButtonOption as B, type Client as C, type SearchJourneysResponse as D, type EnvironmentMap as E, type GenerateDocumentRequest as G, type Journey as J, type OperationMethods as O, Paths as P, type RuleRef as R, type S3Reference as S, type TemplateSettings as T, type ValidationRuleRef as V, Components as a, type PathsDictionary as b, type EnvironmentMapEntry as c, type GenerateDocumentResponse as d, type GetJourneysResponse as e, GetSettingsForJourney as f, type JourneyActivationGuarantee as g, type JourneyAuditInfo as h, type JourneyCreationRequest as i, type JourneyCreationRequestV2 as j, type JourneyEnvironmentResponse as k, type JourneyEnvironmentVariablesResponse as l, type JourneyFeatureFlags as m, type JourneyProductsResponse as n, type JourneyPublishState as o, type JourneyResponse as p, type JourneyRevision as q, type JourneyRevisionConflict as r, type JourneyRevisionList as s, type JourneyRevisionRequest as t, type JourneyRevisionSummary as u, type JourneyValidationError as v, type JourneyValidationResponse as w, type PatchUpdateJourneyRequest as x, type PublishResult as y, type PublishRevisionRequest as z };
+export { type PublishRevisionRequest as A, type ButtonOption as B, type Client as C, type SearchJourneysQueryRequest as D, type EnvironmentMap as E, type SearchJourneysResponse as F, type GenerateDocumentRequest as G, type Journey as J, type OperationMethods as O, Paths as P, type RuleRef as R, type S3Reference as S, type TemplateSettings as T, type ValidationRuleRef as V, Components as a, type PathsDictionary as b, type EnvironmentMapEntry as c, type GenerateDocumentResponse as d, type GetJourneysResponse as e, GetSettingsForJourney as f, type JourneyActivationGuarantee as g, type JourneyAuditInfo as h, type JourneyCreationRequest as i, type JourneyCreationRequestV2 as j, type JourneyEnvironmentResponse as k, type JourneyEnvironmentVariablesResponse as l, type JourneyFeatureFlags as m, type JourneyProductsResponse as n, type JourneyPublishState as o, type JourneyResponse as p, type JourneyRevision as q, type JourneyRevisionConflict as r, type JourneyRevisionList as s, type JourneyRevisionRequest as t, type JourneyRevisionSummary as u, type JourneyServedRevision as v, type JourneyValidationError as w, type JourneyValidationResponse as x, type PatchUpdateJourneyRequest as y, type PublishResult as z };

package/docs/automation.md

@@ -146,8 +146,6 @@ const { data } = await automationClient.searchFlows(...)
 - [`TriggerEventEntityActivity`](#triggerevententityactivity)
 - [`TriggerEventMessaging`](#triggereventmessaging)
 - [`TriggerEventEntityOperation`](#triggerevententityoperation)
-- [`TriggerEventEventCatalog`](#triggereventeventcatalog)
-- [`TriggerEventPayloadRef`](#triggereventpayloadref)
 - [`ApiCallerContext`](#apicallercontext)
 - [`ExecutionStatus`](#executionstatus)
 - [`GetExecutionsResp`](#getexecutionsresp)
@@ -177,7 +175,6 @@ const { data } = await automationClient.searchFlows(...)
 - [`EntitySearchFilter`](#entitysearchfilter)
 - [`EntitySearchFilterValue`](#entitysearchfiltervalue)
 - [`EntityManualTrigger`](#entitymanualtrigger)
-- [`EventCatalogTrigger`](#eventcatalogtrigger)
 - [`TriggerCondition`](#triggercondition)
 - [`Comparison`](#comparison)
 - [`FilterConditionOnEvent`](#filterconditiononevent)
@@ -213,7 +210,6 @@ const { data } = await client.searchFlows({
   from: 1,
   trigger_source_id: 'example',
   target_workflow: 'example',
-  trigger_event_name: 'example',
   include_flows: true,
 })
 ```
@@ -1320,16 +1316,6 @@ type AutomationFlow = {
     configuration?: {
       journey_id?: { ... }
     }
-  } | {
-    id?: string // uuid
-    type: "event_catalog"
-    configuration: {
-      event_name: { ... }
-      event_version: { ... }
-      entity_node_id: { ... }
-      entity_schema: { ... }
-      ignore_automation_triggered?: { ... }
-    }
   }>
   trigger_conditions?: Array<{
     source: string
@@ -1350,6 +1336,16 @@ type AutomationFlow = {
     allow_failure?: boolean
     statements?: Array<{
       id?: { ... }
+      source?: { ... }
+      operation?: { ... }
+      values?: { ... }
+    }>
+  }>
+  schedules?: Array<{
+    id: string
+    scheduleApiId?: string
+    numberOfUnits?: number
+    timePeriod?: "minutes" | "hours" | "days" | "weeks" | "months"
   // ...
 }
 ```
@@ -1412,10 +1408,6 @@ type SearchAutomationsResp = {
       id?: { ... }
       type: { ... }
       configuration?: { ... }
-    } | {
-      id?: { ... }
-      type: { ... }
-      configuration: { ... }
     }>
     trigger_conditions?: Array<{
       source: { ... }
@@ -1465,6 +1457,10 @@ type SearchAutomationsResp = {
       type?: { ... }
       config?: { ... }
     } | {
+      type?: { ... }
+      config?: { ... }
+    } | {
+      type?: { ... }
   // ...
 }
 ```
@@ -1540,16 +1536,6 @@ type AnyTrigger = {
   configuration?: {
     journey_id?: string // uuid
   }
-} | {
-  id?: string // uuid
-  type: "event_catalog"
-  configuration: {
-    event_name: string
-    event_version: string
-    entity_node_id: string
-    entity_schema: string
-    ignore_automation_triggered?: boolean
-  }
 }
 ```
 
@@ -2295,6 +2281,7 @@ type GraphContextEntry = {
       cardinality?: { ... }
       fields?: { ... }
       filter?: { ... }
+      optional?: { ... }
     }>
     edges: Array<{
       from: { ... }
@@ -2326,6 +2313,7 @@ type GraphDefinition = {
       attribute: { ... }
       value: { ... }
     }>
+    optional?: boolean
   }>
   edges: Array<{
     from: string
@@ -2346,6 +2334,7 @@ type GraphNode = {
     attribute: string
     value: string | number | boolean
   }>
+  optional?: boolean
 }
 ```
 
@@ -2594,7 +2583,31 @@ type AssignEntityConfig = {
     email?: string
   }>
   write_mode?: "replace" | "append"
-  assignment_type?: "direct"
+  assignment_type?: "direct" | "sequential" | "even_distribution"
+  candidate_group?: {
+    type: "user" | "partner_user" | "partner_organization" | "group"
+    user_id?: string
+    group_id?: string
+    org_id?: string
+    partner_id?: string
+    display_name?: string
+    email?: string
+  }
+  reset_interval?: "daily" | "weekly" | "monthly" | "never"
+  workload_filter?: {
+    attribute?: string
+    values?: string[]
+  }
+  fallback?: "leave_unassigned" | "assign_to_fallback"
+  fallback_assignees?: Array<{
+    type: "user" | "partner_user" | "partner_organization" | "group"
+    user_id?: string
+    group_id?: string
+    org_id?: string
+    partner_id?: string
+    display_name?: string
+    email?: string
+  }>
   source?: {
     id?: string
     origin?: "trigger" | "action"
@@ -2623,7 +2636,31 @@ type AssignEntityActionConfig = {
       email?: { ... }
     }>
     write_mode?: "replace" | "append"
-    assignment_type?: "direct"
+    assignment_type?: "direct" | "sequential" | "even_distribution"
+    candidate_group?: {
+      type: { ... }
+      user_id?: { ... }
+      group_id?: { ... }
+      org_id?: { ... }
+      partner_id?: { ... }
+      display_name?: { ... }
+      email?: { ... }
+    }
+    reset_interval?: "daily" | "weekly" | "monthly" | "never"
+    workload_filter?: {
+      attribute?: { ... }
+      values?: { ... }
+    }
+    fallback?: "leave_unassigned" | "assign_to_fallback"
+    fallback_assignees?: Array<{
+      type: { ... }
+      user_id?: { ... }
+      group_id?: { ... }
+      org_id?: { ... }
+      partner_id?: { ... }
+      display_name?: { ... }
+      email?: { ... }
+    }>
     source?: {
       id?: { ... }
       origin?: { ... }
@@ -2660,7 +2697,31 @@ type AssignEntityAction = {
       email?: { ... }
     }>
     write_mode?: "replace" | "append"
-    assignment_type?: "direct"
+    assignment_type?: "direct" | "sequential" | "even_distribution"
+    candidate_group?: {
+      type: { ... }
+      user_id?: { ... }
+      group_id?: { ... }
+      org_id?: { ... }
+      partner_id?: { ... }
+      display_name?: { ... }
+      email?: { ... }
+    }
+    reset_interval?: "daily" | "weekly" | "monthly" | "never"
+    workload_filter?: {
+      attribute?: { ... }
+      values?: { ... }
+    }
+    fallback?: "leave_unassigned" | "assign_to_fallback"
+    fallback_assignees?: Array<{
+      type: { ... }
+      user_id?: { ... }
+      group_id?: { ... }
+      org_id?: { ... }
+      partner_id?: { ... }
+      display_name?: { ... }
+      email?: { ... }
+    }>
     source?: {
       id?: { ... }
       origin?: { ... }
@@ -3334,7 +3395,7 @@ type ConditionStatement = {
   source?: {
     id?: string
     origin?: "trigger" | "action"
-    originType?: "entity" | "workflow" | "journey_block" | "event"
+    originType?: "entity" | "workflow" | "journey_block"
     schema?: string
     attribute?: string
     attributeType?: "string" | "text" | "number" | "boolean" | "date" | "datetime" | "tags" | "country" | "email" | "phone" | "product" | "price" | "status" | "relation" | "multiselect" | "select" | "radio" | "relation_user" | "purpose" | "label" | "payment" | "relation_payment_method"
@@ -3656,42 +3717,6 @@ type TriggerEventEntityOperation = {
 }
 ```
 
-### `TriggerEventEventCatalog`
-
-Set on executions started by an Event Catalog event (see EventCatalogTrigger). The full event payload is not stored inline (it may be up to 256 KB) but by reference in `payload_ref`; automation workers hydrate it before every action.
-
-
-```ts
-type TriggerEventEventCatalog = {
-  type: "event_catalog"
-  org_id: string
-  entity_id: string
-  entity_node_id: string
-  event_id: string
-  event_name: string
-  event_version: string
-  published_version?: string
-  event_time?: string // date-time
-  trigger_source_type?: string
-  trigger_source?: string
-  payload_ref?: {
-    bucket: string
-    key: string
-  }
-}
-```
-
-### `TriggerEventPayloadRef`
-
-S3 reference to the stored trigger event payload (`_downgrades` stripped, downgraded to the pinned version)
-
-```ts
-type TriggerEventPayloadRef = {
-  bucket: string
-  key: string
-}
-```
-
 ### `ApiCallerContext`
 
 ```ts
@@ -4413,25 +4438,6 @@ type EntityManualTrigger = {
 }
 ```
 
-### `EventCatalogTrigger`
-
-Starts the flow when an Event Catalog event is published for the organization. The execution runs in the context of one entity from the event's entity graph (`entity_node_id`), and the event payload is available to conditions and actions as the `event` variable context.
-
-
-```ts
-type EventCatalogTrigger = {
-  id?: string // uuid
-  type: "event_catalog"
-  configuration: {
-    event_name: string
-    event_version: string
-    entity_node_id: string
-    entity_schema: string
-    ignore_automation_triggered?: boolean
-  }
-}
-```
-
 ### `TriggerCondition`
 
 ```ts

package/docs/journey.md

@@ -65,6 +65,7 @@ const { data } = await journeyClient.getJourneysByOrgId(...)
 - [`SearchJourneysQueryRequest`](#searchjourneysqueryrequest)
 - [`SearchJourneysResponse`](#searchjourneysresponse)
 - [`Journey`](#journey)
+- [`JourneyServedRevision`](#journeyservedrevision)
 - [`JourneyActivationGuarantee`](#journeyactivationguarantee)
 - [`JourneyFeatureFlags`](#journeyfeatureflags)
 - [`JourneyAuditInfo`](#journeyauditinfo)
@@ -121,6 +122,7 @@ Get journey by id. Private journeys requires valid private token to be passed
 const { data } = await client.getJourney({
   id: '123e4567-e89b-12d3-a456-426614174000',
   version: 1,
+  revision_id: 'example',
   source: 'example',
   orgId: 'example',
 })
@@ -248,7 +250,8 @@ const { data } = await client.getJourney({
   "deletedAt": "string",
   "version": 0,
   "revisions": 0,
-  "featureFlags": {}
+  "featureFlags": {},
+  "revision_id": "42"
 }
 ```
 
@@ -396,7 +399,8 @@ const { data } = await client.createJourneyRevision(
     __lastModifiedAt: 'string',
     parent_revision_id: '41',
     based_on_revision_id: '37',
-    mapping_config_version: 12
+    mapping_config_version: 12,
+    revision_name: 'Changes to Steps and Logic'
   },
 )
 ```
@@ -2732,6 +2736,17 @@ type Journey = {
 }
 ```
 
+### `JourneyServedRevision`
+
+Which revision the runtime read served: the requested one, or the published version when no revision was requested. Absent while the journey has not adopted versioning and on legacy `version` reads.
+
+
+```ts
+type JourneyServedRevision = {
+  revision_id?: string
+}
+```
+
 ### `JourneyActivationGuarantee`
 
 Journeys read from the API always carry an explicit `settings.isActive`. The flag remains optional in request bodies.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.20.18",
+  "version": "2.20.20",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",