@wix/auto_sdk_editor-branches_branches 1.0.20 → 1.0.21

package/build/es/index.typings.d.mts

@@ -5,9 +5,9 @@ import { NonNullablePaths } from '@wix/sdk-types';
  * Read more about branches in this [article](https://support.wix.com/en/article/about-test-sites).
  */
 interface Branch extends BranchSourceOneOf {
-    /** Source branch properties. Use when source_type = SOURCE_BRANCH. */
+    /** Source branch properties. Use when `sourceType` = `SOURCE_BRANCH`. */
     sourceBranchProperties?: SourceBranch;
-    /** Source template properties. Use when source_type = SOURCE_TEMPLATE. */
+    /** Source template properties. Use when `sourceType` = `SOURCE_TEMPLATE`. */
     sourceTemplateProperties?: SourceTemplate;
     /**
      * Branch ID.
@@ -29,7 +29,7 @@ interface Branch extends BranchSourceOneOf {
      * @maxLength 50
      */
     name?: string | null;
-    /** Source type. Must be aligned with the corresponding source properties in the oneof below. */
+    /** Source type. Must be aligned with the corresponding source properties below. */
     sourceType?: SourceTypeWithLiterals;
     /**
      * Date and time the branch was last published, if relevant.
@@ -37,12 +37,12 @@ interface Branch extends BranchSourceOneOf {
      */
     lastPublishDate?: string | null;
     /**
-     * Editor type.
+     * Wix editor type.
      * @readonly
      */
     editorType?: EditorType;
     /**
-     * Default branch
+     * Whether this branch is the default.
      * @readonly
      */
     default?: boolean | null;
@@ -64,19 +64,19 @@ interface Branch extends BranchSourceOneOf {
 }
 /** @oneof */
 interface BranchSourceOneOf {
-    /** Source branch properties. Use when source_type = SOURCE_BRANCH. */
+    /** Source branch properties. Use when `sourceType` = `SOURCE_BRANCH`. */
     sourceBranchProperties?: SourceBranch;
-    /** Source template properties. Use when source_type = SOURCE_TEMPLATE. */
+    /** Source template properties. Use when `sourceType` = `SOURCE_TEMPLATE`. */
     sourceTemplateProperties?: SourceTemplate;
 }
 declare enum Type {
     /** Unknown branch type. */
     UNKNOWN_TYPE = "UNKNOWN_TYPE",
-    /** A branch created by a Wix user, that can be accessed for editing and publishing via the editor UI. */
+    /** A branch created by a Wix user, that can be accessed for editing and publishing in the editor UI. */
     USER = "USER",
-    /** A branch created for technical purposes, unrelated to the Wix user. For internal use, can't be accessed via the editor UI. */
+    /** A branch created for technical purposes, unrelated to the Wix user. For internal use, can't be accessed in the editor UI. */
     TECHNICAL = "TECHNICAL",
-    /** The original branch of the site, created when the site is created. Can be accessed for editing and publishing in the editor. */
+    /** The original branch of the site, created when the site is created. Can be accessed for editing and publishing in the editor UI. */
     ORIGINAL_BRANCH = "ORIGINAL_BRANCH"
 }
 /** @enumType */
@@ -84,23 +84,23 @@ type TypeWithLiterals = Type | 'UNKNOWN_TYPE' | 'USER' | 'TECHNICAL' | 'ORIGINAL
 declare enum SourceType {
     /** Unknown source type. Do not use - will cause ILLEGAL_SOURCE_TYPE error. */
     UNKNOWN_SOURCE_TYPE = "UNKNOWN_SOURCE_TYPE",
-    /** This branch's source was a branch. Must be used with source_branch_properties. */
+    /** This branch's source was a branch. Must be used with `sourceBranchProperties`. */
     SOURCE_BRANCH = "SOURCE_BRANCH",
-    /** This branch's source was a template. Must be used with source_template_properties. For internal use. */
+    /** This branch's source was a template. Must be used with `sourceTemplateProperties`. For internal use. */
     SOURCE_TEMPLATE = "SOURCE_TEMPLATE"
 }
 /** @enumType */
 type SourceTypeWithLiterals = SourceType | 'UNKNOWN_SOURCE_TYPE' | 'SOURCE_BRANCH' | 'SOURCE_TEMPLATE';
 interface EditorType {
-    /** Editor type */
+    /** Wix editor types. */
     editorTypeOptions?: EditorTypeOptionsWithLiterals;
 }
 declare enum EditorTypeOptions {
-    /** Unknown editor type */
+    /** Unknown editor type. Not supported. */
     UNKNOWN_EDITOR_TYPE = "UNKNOWN_EDITOR_TYPE",
-    /** STUDIO */
+    /** Wix Studio Editor. */
     STUDIO = "STUDIO",
-    /** CLASSIC */
+    /** Wix's Classic Editor. */
     CLASSIC = "CLASSIC"
 }
 /** @enumType */
@@ -111,7 +111,7 @@ interface SourceBranch {
      * @format GUID
      */
     branchId?: string;
-    /** Source branch revision. */
+    /** Revision number, which increments by 1 each time the branch is updated. To prevent conflicting changes, the current revision must be passed when updating the branch. */
     branchRevision?: string | null;
 }
 interface SourceTemplate {
@@ -169,7 +169,7 @@ interface DeleteBranchRequest {
 interface DeleteBranchResponse {
 }
 interface QueryBranchesRequest {
-    /** WQL expression. */
+    /** Query options. */
     query?: CursorQuery;
 }
 interface CursorQuery extends CursorQueryPagingMethodOneOf {
@@ -180,13 +180,13 @@ interface CursorQuery extends CursorQueryPagingMethodOneOf {
      *
      * Filterable fields:
      *
-     * `type`
-     * `name`
-     * `updatedDate`
-     * `createdDate`
-     * `lastPublishDate`
-     * `sourceBranchProperties.branchId`
-     * `sourceBranchProperties.branchRevision`
+     * - `type`,
+     * - `name`,
+     * - `updatedDate`,
+     * - `createdDate`,
+     * - `lastPublishDate`,
+     * - `sourceBranchProperties.branchId`,
+     * - `sourceBranchProperties.branchRevision`
      *
      * All operators are valid.
      */
@@ -196,9 +196,9 @@ interface CursorQuery extends CursorQueryPagingMethodOneOf {
      *
      * Sortable fields:
      *
-     * `updatedDate`
-     * `createdDate`
-     * `lastPublishDate`
+     * - `updatedDate`,
+     * - `createdDate`,
+     * - `lastPublishDate`
      * @maxSize 5
      */
     sort?: Sorting[];
@@ -241,7 +241,7 @@ interface CursorPaging {
 interface QueryBranchesResponse {
     /** List of branches. */
     branches?: Branch[];
-    /** Paging metadata */
+    /** Metadata of the paginated results. */
     pagingMetadata?: CursorPagingMetadata;
 }
 interface CursorPagingMetadata {
@@ -783,7 +783,7 @@ interface PicassoUnassigned {
 }
 interface SetDefaultBranchRequest {
     /**
-     * Branch Id.
+     * Branch ID.
      * @format GUID
      */
     branchId: string;
@@ -1022,7 +1022,9 @@ interface BranchCreatedEnvelope {
     entity: Branch;
     metadata: EventMetadata;
 }
-/** @permissionScope Manage Site Branches
+/**
+ * Triggered when a branch is created.
+ * @permissionScope Manage Site Branches
  * @permissionScopeId SCOPE.DC-DOCUMENT-MANAGEMENT.MANAGE-BRANCHES
  * @permissionId EDITOR.BRANCH_READ
  * @webhook
@@ -1034,7 +1036,9 @@ interface BranchDeletedEnvelope {
     entity: Branch;
     metadata: EventMetadata;
 }
-/** @permissionScope Manage Site Branches
+/**
+ * Triggered when a branch is deleted.
+ * @permissionScope Manage Site Branches
  * @permissionScopeId SCOPE.DC-DOCUMENT-MANAGEMENT.MANAGE-BRANCHES
  * @permissionId EDITOR.BRANCH_READ
  * @webhook
@@ -1046,7 +1050,9 @@ interface BranchUpdatedEnvelope {
     entity: Branch;
     metadata: EventMetadata;
 }
-/** @permissionScope Manage Site Branches
+/**
+ * Triggered when a branch is updated.
+ * @permissionScope Manage Site Branches
  * @permissionScopeId SCOPE.DC-DOCUMENT-MANAGEMENT.MANAGE-BRANCHES
  * @permissionId EDITOR.BRANCH_READ
  * @webhook
@@ -1058,10 +1064,10 @@ declare function onBranchUpdated(handler: (event: BranchUpdatedEnvelope) => void
  * Creates a branch.
  * If a source branch is not provided, the branch will include a blank website.
  *
- * *Important:** The `source_type` field must be aligned with the corresponding source properties:
- * - When `source_type` is `SOURCE_BRANCH`, you must provide `source_branch_properties`
- * - When `source_type` is `SOURCE_TEMPLATE`, you must provide `source_template_properties`
- * - Using `UNKNOWN_SOURCE_TYPE` or mismatched properties will result in `ILLEGAL_SOURCE_TYPE` error
+ * > **Important:** The `sourceType` field must be aligned with the corresponding source properties:
+ * - When `sourceType` is `SOURCE_BRANCH`, you must provide `source_branch_properties`.
+ * - When `sourceType` is `SOURCE_TEMPLATE`, you must provide `source_template_properties`.
+ * - Using `UNKNOWN_SOURCE_TYPE` or mismatched properties will result in an `ILLEGAL_SOURCE_TYPE` error.
  * @param branch - Branch to be created.
  * @public
  * @requiredField branch
@@ -1087,7 +1093,7 @@ declare function getBranch(branchId: string): Promise<NonNullablePaths<Branch, `
 /**
  * Updates a branch.
  *
- * `ORIGINAL_BRANCH` types can't be updated.
+ * Note that `ORIGINAL_BRANCH` types can't be updated.
  * @param _id - Branch ID.
  * @public
  * @requiredField _id
@@ -1102,9 +1108,9 @@ declare function updateBranch(_id: string, branch: NonNullablePaths<UpdateBranch
     __applicationErrorsType?: UpdateBranchApplicationErrors;
 }>;
 interface UpdateBranch {
-    /** Source branch properties. Use when source_type = SOURCE_BRANCH. */
+    /** Source branch properties. Use when `sourceType` = `SOURCE_BRANCH`. */
     sourceBranchProperties?: SourceBranch;
-    /** Source template properties. Use when source_type = SOURCE_TEMPLATE. */
+    /** Source template properties. Use when `sourceType` = `SOURCE_TEMPLATE`. */
     sourceTemplateProperties?: SourceTemplate;
     /**
      * Branch ID.
@@ -1126,7 +1132,7 @@ interface UpdateBranch {
      * @maxLength 50
      */
     name?: string | null;
-    /** Source type. Must be aligned with the corresponding source properties in the oneof below. */
+    /** Source type. Must be aligned with the corresponding source properties below. */
     sourceType?: SourceTypeWithLiterals;
     /**
      * Date and time the branch was last published, if relevant.
@@ -1134,12 +1140,12 @@ interface UpdateBranch {
      */
     lastPublishDate?: string | null;
     /**
-     * Editor type.
+     * Wix editor type.
      * @readonly
      */
     editorType?: EditorType;
     /**
-     * Default branch
+     * Whether this branch is the default.
      * @readonly
      */
     default?: boolean | null;
@@ -1239,7 +1245,7 @@ interface BranchesQueryBuilder {
 }
 /**
  * Sets the specified branch as the default.
- * @param branchId - Branch Id.
+ * @param branchId - Branch ID.
  * @public
  * @requiredField branchId
  * @permissionId EDITOR.SET_DEFAULT_BRANCH