@wix/auto_sdk_automations_automations-v-2 1.0.84 → 1.0.85

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.
@@ -88,17 +88,19 @@ interface AIMetadata {
88
88
  }
89
89
  interface ActionSettings {
90
90
  /**
91
- * Permanent actions. PermanentAction's skipActionExpression cannot be modified.
91
+ * IDs of actions whose `skipActionExpression` can't be modified.
92
92
  *
93
- * When empty, all actions can be set as skipped
93
+ * An action's `skipActionExpression` determines whether the action is skipped. Including an action's ID in this array makes its `skipActionExpression` permanent, so it can't be changed.
94
+ *
95
+ * When empty, the `skipActionExpression` of all actions can be edited.
94
96
  * @maxSize 30
95
97
  * @format GUID
96
98
  */
97
99
  permanentActionIds?: string[];
98
100
  /**
99
- * Read-only actions. Read-only actions cannot be edited.
101
+ * IDs of read-only actions. Read-only actions cannot be modified.
100
102
  *
101
- * When empty, all actions are editable.
103
+ * When empty and the automation's `settings.readonly` is `false`, all actions are modifiable.
102
104
  * @maxSize 30
103
105
  * @format GUID
104
106
  */
@@ -308,15 +310,29 @@ declare enum Type {
308
310
  UNKNOWN_ACTION_TYPE = "UNKNOWN_ACTION_TYPE",
309
311
  /** Defined by a [Wix app](https://dev.wix.com/docs/rest/business-management/automations/automations/automations-v2/configure-your-automation#app-defined-action). This action type is available in the site dashboard. */
310
312
  APP_DEFINED = "APP_DEFINED",
311
- /** Condition. This determines which action runs next. */
313
+ /**
314
+ * Condition action. Evaluates a condition to determine which action runs next.
315
+ *
316
+ * Learn more about [adding and setting up conditions](https://support.wix.com/en/article/the-new-automation-builder-understanding-conditions-operators) in Wix Automations.
317
+ *
318
+ * > **Note**: When `skipActionExpression` evaluates to `true`, the actions in `conditionInfo.truePostActionIds` run and those in `conditionInfo.falsePostActionIds` are skipped.
319
+ */
312
320
  CONDITION = "CONDITION",
321
+ /**
322
+ * Code condition action. Evaluates custom code to determine which action runs next.
323
+ *
324
+ * Learn more about [adding and setting up conditions](https://support.wix.com/en/article/the-new-automation-builder-understanding-conditions-operators) in Wix Automations.
325
+ *
326
+ * > **Note**: When `skipActionExpression` evaluates to `true`, the actions in `codeConditionInfo.truePostActionIds` run and those in `codeConditionInfo.falsePostActionIds` are skipped.
327
+ */
328
+ CODE_CONDITION = "CODE_CONDITION",
313
329
  /** Delay. The automation must wait before executing the next step. */
314
330
  DELAY = "DELAY",
315
331
  /** Rate-limiter. This stops the automation flow if the subsequent action has reached its maximum allowed executions. */
316
332
  RATE_LIMIT = "RATE_LIMIT"
317
333
  }
318
334
  /** @enumType */
319
- type TypeWithLiterals = Type | 'UNKNOWN_ACTION_TYPE' | 'APP_DEFINED' | 'CONDITION' | 'DELAY' | 'RATE_LIMIT';
335
+ type TypeWithLiterals = Type | 'UNKNOWN_ACTION_TYPE' | 'APP_DEFINED' | 'CONDITION' | 'CODE_CONDITION' | 'DELAY' | 'RATE_LIMIT';
320
336
  interface AppDefinedAction {
321
337
  /**
322
338
  * ID of the app that defines the action.
@@ -534,15 +550,15 @@ interface Trigger {
534
550
  overrideSchema?: Record<string, any> | null;
535
551
  }
536
552
  interface Action extends ActionInfoOneOf {
537
- /** Details of the action when its `type` is `APP_DEFINED`. */
553
+ /** Details of the action whose `type` is `APP_DEFINED`. */
538
554
  appDefinedInfo?: AppDefinedAction;
539
- /** Details of the action when its `type` is `CONDITION`. */
555
+ /** Details of the action whose `type` is `CONDITION`. */
540
556
  conditionInfo?: ConditionAction;
541
- /** Details of the action when its `type` is `CODE_CONDITION`. */
557
+ /** Details of the action whose `type` is `CODE_CONDITION`. */
542
558
  codeConditionInfo?: CodeConditionAction;
543
- /** Details of the action when its `type` is `DELAY`. */
559
+ /** Details of the action whose `type` is `DELAY`. */
544
560
  delayInfo?: DelayAction;
545
- /** Details of the action when its `type` is `RATE_LIMIT`. */
561
+ /** Details of the action whose `type` is `RATE_LIMIT`. */
546
562
  rateLimitInfo?: RateLimitAction;
547
563
  /**
548
564
  * Action ID.
@@ -570,24 +586,24 @@ interface Action extends ActionInfoOneOf {
570
586
  */
571
587
  namespace?: string | null;
572
588
  /**
573
- * Evaluated to boolean to decide whether the action is skipped.
574
- * For ConditionAction: if skipped, true_post_action_ids execute; false_post_action_ids are skipped
575
- * SplitAction and OutputAction do not support skip_action_expression
589
+ * Evaluated to determine whether the action is skipped. When evaluated to `true`, the action is skipped. Otherwise, the action runs.
590
+ *
591
+ * When empty, the action runs.
576
592
  * @maxLength 1000
577
593
  */
578
594
  skipActionExpression?: string | null;
579
595
  }
580
596
  /** @oneof */
581
597
  interface ActionInfoOneOf {
582
- /** Details of the action when its `type` is `APP_DEFINED`. */
598
+ /** Details of the action whose `type` is `APP_DEFINED`. */
583
599
  appDefinedInfo?: AppDefinedAction;
584
- /** Details of the action when its `type` is `CONDITION`. */
600
+ /** Details of the action whose `type` is `CONDITION`. */
585
601
  conditionInfo?: ConditionAction;
586
- /** Details of the action when its `type` is `CODE_CONDITION`. */
602
+ /** Details of the action whose `type` is `CODE_CONDITION`. */
587
603
  codeConditionInfo?: CodeConditionAction;
588
- /** Details of the action when its `type` is `DELAY`. */
604
+ /** Details of the action whose `type` is `DELAY`. */
589
605
  delayInfo?: DelayAction;
590
- /** Details of the action when its `type` is `RATE_LIMIT`. */
606
+ /** Details of the action whose `type` is `RATE_LIMIT`. */
591
607
  rateLimitInfo?: RateLimitAction;
592
608
  }
593
609
  interface FilterableAppDefinedActions {
@@ -651,11 +667,12 @@ interface AutomationSettings {
651
667
  hidden?: boolean;
652
668
  /**
653
669
  * Whether the automation is read-only.
654
- * If true - modifications to the automation trigger or action/s are disabled.
655
- * **Note**: this setting takes precedent over triggerSettings/actionSettings.
656
- * If false - allows selective read-only settings via those fields.
657
670
  *
658
- * Default: `false`
671
+ * When `true`, site owners can't modify the automation or any of its actions. When `false`, users can configure specific actions as skippable or read-only using `settings.actionSettings`.
672
+ *
673
+ * Default: `false`.
674
+ *
675
+ * > **Note**: Setting `readOnly` to `true` overrides `settings.actionSettings`.
659
676
  */
660
677
  readonly?: boolean;
661
678
  /**
@@ -665,7 +682,7 @@ interface AutomationSettings {
665
682
  */
666
683
  disableDelete?: boolean;
667
684
  /**
668
- * Whether to disable the option to change the automation's `configuration.status`, for example from `ACTIVE` to `INACTIVE`.
685
+ * Whether to disable the option to change the automation's `configuration.status`.
669
686
  *
670
687
  * Default: `false`.
671
688
  */
@@ -861,6 +861,7 @@ var Type = /* @__PURE__ */ ((Type2) => {
861
861
  Type2["UNKNOWN_ACTION_TYPE"] = "UNKNOWN_ACTION_TYPE";
862
862
  Type2["APP_DEFINED"] = "APP_DEFINED";
863
863
  Type2["CONDITION"] = "CONDITION";
864
+ Type2["CODE_CONDITION"] = "CODE_CONDITION";
864
865
  Type2["DELAY"] = "DELAY";
865
866
  Type2["RATE_LIMIT"] = "RATE_LIMIT";
866
867
  return Type2;