@wix/auto_sdk_online-programs_sections 1.0.29 → 1.0.31

package/build/cjs/index.typings.d.ts

@@ -218,8 +218,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[];
 }
@@ -241,8 +243,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[];
 }
@@ -300,8 +304,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[];
 }
@@ -331,11 +337,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[];
 }
@@ -355,8 +367,10 @@ interface UpdateSectionRequest {
     /** Section to update. Include `section.id`, `section.revision`, and the fields to update. */
     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[];
 }
@@ -391,11 +405,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[];
 }
@@ -507,11 +527,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[];
 }
@@ -529,8 +555,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[];
 }
@@ -543,7 +571,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
@@ -552,8 +580,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[];
 }
@@ -594,8 +624,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[];
 }
@@ -786,6 +818,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
@@ -800,8 +834,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[];
 }
@@ -810,6 +846,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
@@ -823,15 +861,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
@@ -843,11 +881,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[];
 }
@@ -916,8 +960,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[];
 }
@@ -937,6 +983,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.
@@ -945,7 +994,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
@@ -956,11 +1005,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;
 }
@@ -1117,11 +1172,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
@@ -1132,11 +1189,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[];
 }
@@ -1144,6 +1207,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
@@ -1155,8 +1222,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[];
 }
@@ -1166,19 +1235,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
@@ -1187,8 +1253,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/cjs/index.typings.js

@@ -822,10 +822,10 @@ async function cloneSection2(sectionId, options) {
     throw transformedError;
   }
 }
-async function moveSection2(options) {
-  const { httpClient, sideEffects } = arguments[1];
+async function moveSection2(sectionId, options) {
+  const { httpClient, sideEffects } = arguments[2];
   const payload = (0, import_rename_all_nested_keys.renameKeysFromSDKRequestToRESTRequest)({
-    sectionId: options?.sectionId,
+    sectionId,
     afterSectionId: options?.afterSectionId,
     revision: options?.revision,
     fields: options?.fields
@@ -842,14 +842,14 @@ async function moveSection2(options) {
       {
         spreadPathsToArguments: {},
         explicitPathsToArguments: {
-          sectionId: "$[0].sectionId",
-          afterSectionId: "$[0].afterSectionId",
-          revision: "$[0].revision",
-          fields: "$[0].fields"
+          sectionId: "$[0]",
+          afterSectionId: "$[1].afterSectionId",
+          revision: "$[1].revision",
+          fields: "$[1].fields"
         },
         singleArgumentUnchanged: false
       },
-      ["options"]
+      ["sectionId", "options"]
     );
     sideEffects?.onError?.(err);
     throw transformedError;