@wix/auto_sdk_online-programs_sections 1.0.29 → 1.0.31

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

@@ -224,8 +224,10 @@ interface CreateSectionRequest {
     /** Section to create. Must include `section.program_id`. */
     section: Section;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -247,8 +249,10 @@ interface BulkCreateSectionsRequest {
      */
     sections: Section[];
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -311,8 +315,10 @@ interface BulkCreateSectionRequest {
      */
     sections?: Section[];
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -342,11 +348,17 @@ interface GetSectionRequest {
      * @format GUID
      */
     sectionId: string;
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -373,8 +385,10 @@ interface UpdateSectionRequest {
      */
     fieldMask?: string[];
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -409,11 +423,17 @@ interface DeleteAllProgramSectionsResponse {
 interface QuerySectionsRequest {
     /** WQL expression. */
     query?: CursorQuery;
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -546,11 +566,17 @@ interface ListSectionsRequest {
      * @format GUID
      */
     programId: string;
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -568,8 +594,10 @@ interface CloneSectionRequest {
      */
     sectionId: string;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -582,7 +610,7 @@ interface MoveSectionRequest {
      * ID of the section to move.
      * @format GUID
      */
-    sectionId?: string;
+    sectionId: string;
     /**
      * ID of the section that the moved section should be placed after. Leave empty to move the section to the beginning of the program.
      * @format GUID
@@ -591,8 +619,10 @@ interface MoveSectionRequest {
     /** Current revision of the section. When provided, it must match the current revision to protect against conflicting updates. */
     revision?: string;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -633,8 +663,10 @@ interface RestoreSectionFromTrashRequest {
      */
     sectionId?: string;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -825,6 +857,8 @@ interface AccountInfo {
  *
  * The section is added to the program identified by `section.program_id`. Provide that program ID in the request. Set `section.description.title` for the section title. The stored ordering value is assigned automatically.
  *
+ * A program can contain up to 1,000 sections. This call fails if creating the section would exceed that limit.
+ *
  * To create multiple sections in a single API call, call [Bulk Create Sections](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/bulk-create-sections).
  * @param section - Section to create. Must include `section.program_id`.
  * @public
@@ -839,8 +873,10 @@ interface AccountInfo {
 declare function createSection(section: NonNullablePaths<Section, `programId`, 0>, options?: CreateSectionOptions): Promise<NonNullablePaths<Section, `programId` | `description.title` | `ordering` | `delayInDays`, 1>>;
 interface CreateSectionOptions {
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -849,6 +885,8 @@ interface CreateSectionOptions {
  *
  * All sections in the request must include `program_id` and belong to the same program. Set `description.title` for each section title. The stored ordering values are assigned automatically.
  *
+ * A program can contain up to 1,000 sections. This call fails if creating the requested sections would exceed that limit.
+ *
  * To create a single section, call [Create Section](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/create-section).
  * @param sections - List of sections to create. Each section must include `program_id`, and all sections must belong to the same program.
  * @public
@@ -862,15 +900,15 @@ interface CreateSectionOptions {
 declare function bulkCreateSections(sections: NonNullablePaths<Section, `programId`, 0>[], options?: BulkCreateSectionsOptions): Promise<NonNullablePaths<BulkCreateSectionsResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.action` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 4>>;
 interface BulkCreateSectionsOptions {
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
 /**
  * Retrieves a section.
- *
- * `descriptionFieldSet` is retained for backward compatibility. Current section responses return the section title.
  * @param sectionId - ID of the Section to retrieve.
  * @public
  * @documentationMaturity preview
@@ -882,11 +920,17 @@ interface BulkCreateSectionsOptions {
  */
 declare function getSection(sectionId: string, options?: GetSectionOptions): Promise<NonNullablePaths<Section, `programId` | `description.title` | `ordering` | `delayInDays`, 1>>;
 interface GetSectionOptions {
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -961,8 +1005,10 @@ interface UpdateSectionOptions {
         extendedFields?: ExtendedFields;
     };
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -982,6 +1028,9 @@ declare function deleteSection(sectionId: string): Promise<void>;
 /**
  * Retrieves a list of up to 1,000 sections, given the provided paging, filtering, and sorting.
  *
+ * Use this method when you need to filter sections, apply custom sorting or paging, or query across programs.
+ * When you know the program ID and need all sections in program order, call [List Sections](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/list-sections).
+ *
  * Query Sections runs with these defaults, which you can override:
  *
  * - `createdDate` is sorted in `DESC` order.
@@ -990,7 +1039,7 @@ declare function deleteSection(sectionId: string): Promise<void>;
  *
  * Supported filter fields are `programId`, `id`, and `delayInDays`.
  * Supported sorting fields are `id`, `delayInDays`, `createdDate`, and `ordering`. When sorting by a field other than `programId`, also filter by `programId`.
- * `descriptionFieldSet` is retained for backward compatibility. Current section responses return the section title.
+ * Section extended fields aren't supported for filtering or sorting. Queries that reference them are rejected.
  *
  * To learn about working with Query methods, see [API Query Language](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language), [Sorting and Paging](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-sorting-and-paging), and [Field Projection](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-field-projection).
  * @public
@@ -1001,11 +1050,17 @@ declare function deleteSection(sectionId: string): Promise<void>;
  */
 declare function querySections(options?: QuerySectionsOptions): SectionsQueryBuilder;
 interface QuerySectionsOptions {
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals | undefined;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[] | undefined;
 }
@@ -1176,11 +1231,13 @@ declare const utils: {
     query: _wix_sdk_types.QueryHelpers<Section, SectionQuerySpec, SectionQuery>;
 };
 /**
- * Retrieves the sections in a program.
+ * Retrieves all sections in a program.
  *
- * Results are sorted by `ordering` in ascending order. `descriptionFieldSet` is retained for backward compatibility. Current section responses return the section title.
+ * Use this method when you know the program ID and need all sections in program order.
  *
- * To filter or sort sections, call [Query Sections](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/query-sections).
+ * Results are sorted by `ordering` in ascending order.
+ *
+ * To filter sections, apply custom sorting or paging, or query across programs, call [Query Sections](https://dev.wix.com/docs/api-reference/business-management/online-programs/sections/query-sections).
  * @param programId - Program ID to list sections for.
  * @public
  * @documentationMaturity preview
@@ -1191,11 +1248,17 @@ declare const utils: {
  */
 declare function listSections(programId: string, options?: ListSectionsOptions): Promise<NonNullablePaths<ListSectionsResponse, `sections` | `sections.${number}.programId` | `sections.${number}.description.title` | `sections.${number}.ordering` | `sections.${number}.delayInDays`, 3>>;
 interface ListSectionsOptions {
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -1203,6 +1266,10 @@ interface ListSectionsOptions {
  * Clones a section.
  *
  * The cloned section is added to the same program after the current last section. Translation content and extended field data are copied to the cloned section.
+ *
+ * Steps are cloned asynchronously after this call returns. The `section.total_steps` value in the response may not reflect the eventual number of cloned steps. Until cloning finishes, Get, List, and Query calls may return a lower actual step count.
+ *
+ * A program can contain up to 1,000 sections. This call fails if cloning the section would exceed that limit.
  * @param sectionId - ID of the section to clone.
  * @public
  * @documentationMaturity preview
@@ -1214,8 +1281,10 @@ interface ListSectionsOptions {
 declare function cloneSection(sectionId: string, options?: CloneSectionOptions): Promise<NonNullablePaths<CloneSectionResponse, `section.programId` | `section.description.title` | `section.ordering` | `section.delayInDays`, 2>>;
 interface CloneSectionOptions {
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -1225,19 +1294,16 @@ interface CloneSectionOptions {
  * Each time the section is updated, its `revision` increments by 1. When provided, `revision` must match the current section revision to protect against conflicting updates.
  *
  * If `afterSectionId` isn't specified, the section is moved to the beginning of the program. The stored ordering value is recalculated automatically.
+ * @param sectionId - ID of the section to move.
  * @public
  * @documentationMaturity preview
+ * @requiredField sectionId
  * @permissionId ONLINE_PROGRAMS.SECTION_UPDATE
  * @applicableIdentity APP
  * @fqn wix.onlineprograms.sections.v3.SectionsService.MoveSection
  */
-declare function moveSection(options?: MoveSectionOptions): Promise<NonNullablePaths<MoveSectionResponse, `section.programId` | `section.description.title` | `section.ordering` | `section.delayInDays`, 2>>;
+declare function moveSection(sectionId: string, options?: MoveSectionOptions): Promise<NonNullablePaths<MoveSectionResponse, `section.programId` | `section.description.title` | `section.ordering` | `section.delayInDays`, 2>>;
 interface MoveSectionOptions {
-    /**
-     * ID of the section to move.
-     * @format GUID
-     */
-    sectionId?: string;
     /**
      * ID of the section that the moved section should be placed after. Leave empty to move the section to the beginning of the program.
      * @format GUID
@@ -1246,8 +1312,10 @@ interface MoveSectionOptions {
     /** Current revision of the section. When provided, it must match the current revision to protect against conflicting updates. */
     revision?: string;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }

package/build/internal/es/meta.d.mts

@@ -224,8 +224,10 @@ interface CreateSectionRequest {
     /** Section to create. Must include `section.program_id`. */
     section: Section;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -247,8 +249,10 @@ interface BulkCreateSectionsRequest {
      */
     sections: Section[];
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -311,8 +315,10 @@ interface BulkCreateSectionRequest {
      */
     sections?: Section[];
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -342,11 +348,17 @@ interface GetSectionRequest {
      * @format GUID
      */
     sectionId: string;
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -373,8 +385,10 @@ interface UpdateSectionRequest {
      */
     fieldMask?: string[];
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -409,11 +423,17 @@ interface DeleteAllProgramSectionsResponse {
 interface QuerySectionsRequest {
     /** WQL expression. */
     query?: CursorQuery;
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -546,11 +566,17 @@ interface ListSectionsRequest {
      * @format GUID
      */
     programId: string;
-    /** Compatibility option for existing integrations. Current section responses return the section title. */
+    /**
+     * Deprecated: Current section responses always include the section title. This field is ignored.
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
+     */
     descriptionFieldSet?: DescriptionFieldSetWithLiterals;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -568,8 +594,10 @@ interface CloneSectionRequest {
      */
     sectionId: string;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -582,7 +610,7 @@ interface MoveSectionRequest {
      * ID of the section to move.
      * @format GUID
      */
-    sectionId?: string;
+    sectionId: string;
     /**
      * ID of the section that the moved section should be placed after. Leave empty to move the section to the beginning of the program.
      * @format GUID
@@ -591,8 +619,10 @@ interface MoveSectionRequest {
     /** Current revision of the section. When provided, it must match the current revision to protect against conflicting updates. */
     revision?: string;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }
@@ -633,8 +663,10 @@ interface RestoreSectionFromTrashRequest {
      */
     sectionId?: string;
     /**
-     * Predefined sets of fields to return.
+     * Deprecated: `total_steps` is always returned. This field is ignored.
      * @maxSize 1
+     * @deprecated
+     * @targetRemovalDate 2026-12-31
      */
     fields?: RequestedFieldsWithLiterals[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/auto_sdk_online-programs_sections",
-  "version": "1.0.29",
+  "version": "1.0.31",
   "license": "MIT",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -50,5 +50,5 @@
       "fqdn": "wix.online_programs.v3.section"
     }
   },
-  "falconPackageHash": "a5ba7173a7a46e224979d177775a46458a57d16f94eaeaae96044287"
+  "falconPackageHash": "437fc9edc7d6ba1c81d5b89b5b845f6101f339faeb81c5a218b8407a"
 }