@epilot/sdk 2.1.0-rc.0 → 2.1.0

package/definitions/journey.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "Journey API",
     "description": "API to configure journeys",
-    "version": "1.1.0"
+    "version": "1.4.0"
   },
   "security": [
     {
@@ -94,6 +94,9 @@
           {},
           {
             "EpilotAuth": []
+          },
+          {
+            "PortalAuth": []
           }
         ],
         "tags": [
@@ -299,7 +302,7 @@
             "schema": {
               "type": "string",
               "format": "Yn",
-              "example": true
+              "example": "true"
             }
           }
         ],
@@ -313,6 +316,16 @@
                 }
               }
             }
+          },
+          "400": {
+            "description": "Validation failed (when validation mode is STRICT)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JourneyValidationError"
+                }
+              }
+            }
           }
         }
       },
@@ -347,6 +360,16 @@
               }
             }
           },
+          "400": {
+            "description": "Validation failed (when validation mode is STRICT)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JourneyValidationError"
+                }
+              }
+            }
+          },
           "409": {
             "description": "The Journey has been modified since your last read, please refresh it and try again"
           }
@@ -389,6 +412,16 @@
               }
             }
           },
+          "400": {
+            "description": "Validation failed (when validation mode is STRICT)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JourneyValidationError"
+                }
+              }
+            }
+          },
           "404": {
             "description": "Journey or associated entity not found",
             "content": {
@@ -505,7 +538,7 @@
             "schema": {
               "type": "string",
               "format": "Yn",
-              "example": true
+              "example": "true"
             }
           }
         ],
@@ -519,6 +552,16 @@
                 }
               }
             }
+          },
+          "400": {
+            "description": "Validation failed (when validation mode is STRICT)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JourneyValidationError"
+                }
+              }
+            }
           }
         }
       },
@@ -551,6 +594,16 @@
               }
             }
           },
+          "400": {
+            "description": "Validation failed (when validation mode is STRICT)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JourneyValidationError"
+                }
+              }
+            }
+          },
           "404": {
             "description": "Journey or associated entity not found",
             "content": {
@@ -606,6 +659,16 @@
               }
             }
           },
+          "400": {
+            "description": "Validation failed (when validation mode is STRICT)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JourneyValidationError"
+                }
+              }
+            }
+          },
           "404": {
             "description": "Journey or associated entity not found",
             "content": {
@@ -896,16 +959,19 @@
               "type": "string"
             },
             "feature": {
-              "type": "array"
+              "type": "array",
+              "items": {}
             },
             "product_images": {
-              "type": "array"
+              "type": "array",
+              "items": {}
             },
             "legal_footnote": {
               "type": "string"
             },
             "product_downloads": {
-              "type": "array"
+              "type": "array",
+              "items": {}
             },
             "price": {
               "type": "object"
@@ -1166,7 +1232,8 @@
                               "type": "object"
                             },
                             {
-                              "type": "array"
+                              "type": "array",
+                              "items": {}
                             }
                           ]
                         },
@@ -1343,6 +1410,26 @@
                 "type": "string",
                 "nullable": true
               },
+              "addressSuggestionsCountryCode": {
+                "type": "string",
+                "nullable": true,
+                "description": "Country code for address format (e.g. DE, AT, CH, LU)"
+              },
+              "addressSuggestionsEnableAutoComplete": {
+                "type": "boolean",
+                "description": "Whether address auto-complete is enabled"
+              },
+              "addressSuggestionsSource": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Sources for address auto-complete (e.g. deutschePostService, customAddressesFile)"
+              },
+              "addressSuggestionsEnableFreeText": {
+                "type": "boolean",
+                "description": "Whether free text input is allowed when auto-complete is on"
+              },
               "useNewDesign": {
                 "type": "boolean",
                 "deprecated": true,
@@ -1652,7 +1739,8 @@
                               "type": "object"
                             },
                             {
-                              "type": "array"
+                              "type": "array",
+                              "items": {}
                             }
                           ]
                         },
@@ -1817,6 +1905,26 @@
                 "type": "string",
                 "nullable": true
               },
+              "addressSuggestionsCountryCode": {
+                "type": "string",
+                "nullable": true,
+                "description": "Country code for address format (e.g. DE, AT, CH, LU)"
+              },
+              "addressSuggestionsEnableAutoComplete": {
+                "type": "boolean",
+                "description": "Whether address auto-complete is enabled"
+              },
+              "addressSuggestionsSource": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Sources for address auto-complete (e.g. deutschePostService, customAddressesFile)"
+              },
+              "addressSuggestionsEnableFreeText": {
+                "type": "boolean",
+                "description": "Whether free text input is allowed when auto-complete is on"
+              },
               "useNewDesign": {
                 "type": "boolean",
                 "deprecated": true,
@@ -2042,6 +2150,140 @@
           "revisions"
         ]
       },
+      "JourneyValidationResponse": {
+        "type": "object",
+        "properties": {
+          "valid": {
+            "type": "boolean",
+            "description": "Whether the journey configuration is valid"
+          },
+          "errors": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "description": "Pattern type (e.g. PatternA_DotsInStepId)"
+                },
+                "severity": {
+                  "type": "string",
+                  "enum": [
+                    "critical",
+                    "high",
+                    "medium",
+                    "low"
+                  ]
+                },
+                "message": {
+                  "type": "string"
+                },
+                "affectedStepIds": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "count": {
+                  "type": "integer"
+                },
+                "autoFix": {
+                  "type": "object",
+                  "properties": {
+                    "feasible": {
+                      "type": "boolean"
+                    },
+                    "confidence": {
+                      "type": "string",
+                      "enum": [
+                        "high",
+                        "medium",
+                        "low"
+                      ]
+                    },
+                    "reason": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            },
+            "description": "List of detected validation errors"
+          },
+          "warnings": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                }
+              }
+            },
+            "description": "List of warnings (non-critical issues)"
+          }
+        },
+        "required": [
+          "valid",
+          "errors"
+        ]
+      },
+      "JourneyValidationError": {
+        "type": "object",
+        "properties": {
+          "error": {
+            "type": "string",
+            "example": "ValidationError",
+            "description": "Error type identifier"
+          },
+          "message": {
+            "type": "string",
+            "example": "Journey configuration validation failed",
+            "description": "High-level error message"
+          },
+          "details": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "pattern": {
+                  "type": "string",
+                  "description": "Validation pattern that failed"
+                },
+                "severity": {
+                  "type": "string",
+                  "enum": [
+                    "critical",
+                    "high",
+                    "medium",
+                    "low"
+                  ]
+                },
+                "message": {
+                  "type": "string",
+                  "description": "Detailed error message"
+                },
+                "count": {
+                  "type": "integer",
+                  "description": "Number of issues found"
+                }
+              }
+            },
+            "description": "Detailed validation errors for each pattern that failed"
+          }
+        },
+        "required": [
+          "error",
+          "message",
+          "details"
+        ]
+      },
       "S3Reference": {
         "type": "object",
         "properties": {
@@ -2124,7 +2366,7 @@
             "description": "The file entity id, used when persisting a new template version with updated settings",
             "type": "string",
             "format": "uuid",
-            "example": "1a2b3c4d-5e6f-7g8h-9i0j-1k2l3m4n5o6p"
+            "example": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
           }
         }
       },
@@ -2327,13 +2569,16 @@
         "scheme": "bearer",
         "description": "Epilot Authorization Bearer Token - public access token / user token",
         "bearerFormat": "JWT"
+      },
+      "PortalAuth": {
+        "type": "http",
+        "scheme": "bearer",
+        "description": "Portal Authorization Bearer Token",
+        "bearerFormat": "JWT"
       }
     }
   },
   "servers": [
-    {
-      "url": "https://journey-config.sls.epilot.io"
-    },
     {
       "url": "https://journey-config.sls.epilot.io"
     }