@wix/auto_sdk_blog_posts 1.0.139 → 1.0.141

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

@@ -316,6 +316,10 @@ interface Node extends NodeDataOneOf {
     layoutCellData?: LayoutCellData;
     /** Data for a shape node. */
     shapeData?: ShapeData;
+    /** Data for a card node. */
+    cardData?: CardData;
+    /** Data for a table of contents node. */
+    tocData?: TocData;
     /** Node type. Use `APP_EMBED` for nodes that embed content from other Wix apps. Use `EMBED` to embed content in [oEmbed](https://oembed.com/) format. */
     type?: NodeTypeWithLiterals;
     /** Node ID. */
@@ -385,6 +389,10 @@ interface NodeDataOneOf {
     layoutCellData?: LayoutCellData;
     /** Data for a shape node. */
     shapeData?: ShapeData;
+    /** Data for a card node. */
+    cardData?: CardData;
+    /** Data for a table of contents node. */
+    tocData?: TocData;
 }
 declare enum NodeType {
     PARAGRAPH = "PARAGRAPH",
@@ -421,10 +429,12 @@ declare enum NodeType {
     CAPTION = "CAPTION",
     LAYOUT = "LAYOUT",
     LAYOUT_CELL = "LAYOUT_CELL",
-    SHAPE = "SHAPE"
+    SHAPE = "SHAPE",
+    CARD = "CARD",
+    TOC = "TOC"
 }
 /** @enumType */
-type NodeTypeWithLiterals = NodeType | 'PARAGRAPH' | 'TEXT' | 'HEADING' | 'BULLETED_LIST' | 'ORDERED_LIST' | 'LIST_ITEM' | 'BLOCKQUOTE' | 'CODE_BLOCK' | 'VIDEO' | 'DIVIDER' | 'FILE' | 'GALLERY' | 'GIF' | 'HTML' | 'IMAGE' | 'LINK_PREVIEW' | 'MAP' | 'POLL' | 'APP_EMBED' | 'BUTTON' | 'COLLAPSIBLE_LIST' | 'TABLE' | 'EMBED' | 'COLLAPSIBLE_ITEM' | 'COLLAPSIBLE_ITEM_TITLE' | 'COLLAPSIBLE_ITEM_BODY' | 'TABLE_CELL' | 'TABLE_ROW' | 'EXTERNAL' | 'AUDIO' | 'CAPTION' | 'LAYOUT' | 'LAYOUT_CELL' | 'SHAPE';
+type NodeTypeWithLiterals = NodeType | 'PARAGRAPH' | 'TEXT' | 'HEADING' | 'BULLETED_LIST' | 'ORDERED_LIST' | 'LIST_ITEM' | 'BLOCKQUOTE' | 'CODE_BLOCK' | 'VIDEO' | 'DIVIDER' | 'FILE' | 'GALLERY' | 'GIF' | 'HTML' | 'IMAGE' | 'LINK_PREVIEW' | 'MAP' | 'POLL' | 'APP_EMBED' | 'BUTTON' | 'COLLAPSIBLE_LIST' | 'TABLE' | 'EMBED' | 'COLLAPSIBLE_ITEM' | 'COLLAPSIBLE_ITEM_TITLE' | 'COLLAPSIBLE_ITEM_BODY' | 'TABLE_CELL' | 'TABLE_ROW' | 'EXTERNAL' | 'AUDIO' | 'CAPTION' | 'LAYOUT' | 'LAYOUT_CELL' | 'SHAPE' | 'CARD' | 'TOC';
 interface NodeStyle {
     /** The top padding value in pixels. */
     paddingTop?: string | null;
@@ -445,6 +455,55 @@ interface ButtonData {
     /** Button link details. */
     link?: Link;
 }
+/** Background type */
+declare enum BackgroundType {
+    /** Solid color background */
+    COLOR = "COLOR",
+    /** Gradient background */
+    GRADIENT = "GRADIENT"
+}
+/** @enumType */
+type BackgroundTypeWithLiterals = BackgroundType | 'COLOR' | 'GRADIENT';
+interface Gradient {
+    /** Gradient type. */
+    type?: GradientTypeWithLiterals;
+    /**
+     * Color stops for the gradient.
+     * @maxSize 1000
+     */
+    stops?: Stop[];
+    /** Angle in degrees for linear gradient (0-360). */
+    angle?: number | null;
+    /**
+     * Horizontal center position for radial gradient (0-100).
+     * @max 100
+     */
+    centerX?: number | null;
+    /**
+     * Vertical center position for radial gradient (0-100).
+     * @max 100
+     */
+    centerY?: number | null;
+}
+/** Gradient type. */
+declare enum GradientType {
+    /** Linear gradient. */
+    LINEAR = "LINEAR",
+    /** Radial gradient. */
+    RADIAL = "RADIAL"
+}
+/** @enumType */
+type GradientTypeWithLiterals = GradientType | 'LINEAR' | 'RADIAL';
+/** A single color stop in the gradient. */
+interface Stop {
+    /**
+     * Stop color as hex value.
+     * @format COLOR_HEX
+     */
+    color?: string | null;
+    /** Stop position (0-1). */
+    position?: number | null;
+}
 interface Border {
     /**
      * Deprecated: Use `borderWidth` in `styles` instead.
@@ -474,6 +533,18 @@ interface Colors {
      */
     background?: string | null;
 }
+/** Background styling (color or gradient) */
+interface Background {
+    /** Background type. */
+    type?: BackgroundTypeWithLiterals;
+    /**
+     * Background color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
+    color?: string | null;
+    /** Gradient configuration. */
+    gradient?: Gradient;
+}
 interface PluginContainerData {
     /** The width of the node when it's displayed. */
     width?: PluginContainerDataWidth;
@@ -594,17 +665,23 @@ interface Styles {
      */
     textColorHover?: string | null;
     /**
-     * Background color as a hexadecimal value.
+     * Deprecated: Use `background` instead.
      * @format COLOR_HEX
+     * @deprecated
      */
     backgroundColor?: string | null;
     /**
-     * Background color as a hexadecimal value (hover state).
+     * Deprecated: Use `backgroundHover` instead.
      * @format COLOR_HEX
+     * @deprecated
      */
     backgroundColorHover?: string | null;
     /** Button size option, one of `SMALL`, `MEDIUM` or `LARGE`. Defaults to `MEDIUM`. */
     buttonSize?: string | null;
+    /** Background styling (color or gradient). */
+    background?: Background;
+    /** Background styling for hover state (color or gradient). */
+    backgroundHover?: Background;
 }
 interface Link extends LinkDataOneOf {
     /** The absolute URL for the linked document. */
@@ -986,6 +1063,8 @@ interface HTMLData extends HTMLDataDataOneOf {
      * @deprecated
      */
     isAdsense?: boolean | null;
+    /** The WixelWidget ID for AI_WIDGET source nodes. */
+    widgetId?: string;
     /** Styling for the HTML node's container. Height property is irrelevant for HTML embeds when autoHeight is set to `true`. */
     containerData?: PluginContainerData;
     /** The type of HTML code. */
@@ -1004,14 +1083,17 @@ interface HTMLDataDataOneOf {
      * @deprecated
      */
     isAdsense?: boolean | null;
+    /** The WixelWidget ID for AI_WIDGET source nodes. */
+    widgetId?: string;
 }
 declare enum Source {
     HTML = "HTML",
     ADSENSE = "ADSENSE",
-    AI = "AI"
+    AI = "AI",
+    AI_WIDGET = "AI_WIDGET"
 }
 /** @enumType */
-type SourceWithLiterals = Source | 'HTML' | 'ADSENSE' | 'AI';
+type SourceWithLiterals = Source | 'HTML' | 'ADSENSE' | 'AI' | 'AI_WIDGET';
 interface ImageData {
     /** Styling for the image's container. */
     containerData?: PluginContainerData;
@@ -1241,7 +1323,7 @@ interface OptionLayout {
     /** Sets whether to display option images. Defaults to `false`. */
     enableImage?: boolean | null;
 }
-declare enum BackgroundType {
+declare enum PollDesignBackgroundType {
     /** Color background type */
     COLOR = "COLOR",
     /** Image background type */
@@ -1250,8 +1332,8 @@ declare enum BackgroundType {
     GRADIENT = "GRADIENT"
 }
 /** @enumType */
-type BackgroundTypeWithLiterals = BackgroundType | 'COLOR' | 'IMAGE' | 'GRADIENT';
-interface Gradient {
+type PollDesignBackgroundTypeWithLiterals = PollDesignBackgroundType | 'COLOR' | 'IMAGE' | 'GRADIENT';
+interface BackgroundGradient {
     /** The gradient angle in degrees. */
     angle?: number | null;
     /**
@@ -1265,7 +1347,7 @@ interface Gradient {
      */
     lastColor?: string | null;
 }
-interface Background extends BackgroundBackgroundOneOf {
+interface PollDesignBackground extends PollDesignBackgroundBackgroundOneOf {
     /**
      * The background color as a hexademical value.
      * @format COLOR_HEX
@@ -1274,12 +1356,12 @@ interface Background extends BackgroundBackgroundOneOf {
     /** An image to use for the background. */
     image?: V1Media;
     /** Details for a gradient background. */
-    gradient?: Gradient;
+    gradient?: BackgroundGradient;
     /** Background type. For each option, include the relevant details. */
-    type?: BackgroundTypeWithLiterals;
+    type?: PollDesignBackgroundTypeWithLiterals;
 }
 /** @oneof */
-interface BackgroundBackgroundOneOf {
+interface PollDesignBackgroundBackgroundOneOf {
     /**
      * The background color as a hexademical value.
      * @format COLOR_HEX
@@ -1288,11 +1370,11 @@ interface BackgroundBackgroundOneOf {
     /** An image to use for the background. */
     image?: V1Media;
     /** Details for a gradient background. */
-    gradient?: Gradient;
+    gradient?: BackgroundGradient;
 }
 interface PollDesign {
     /** Background styling. */
-    background?: Background;
+    background?: PollDesignBackground;
     /** Border radius in pixels. */
     borderRadius?: number | null;
 }
@@ -1975,12 +2057,13 @@ interface CaptionData {
 }
 interface LayoutData {
     /**
-     * Background color as a hexadecimal value.
+     * Deprecated: Use `background` instead.
      * @format COLOR_HEX
+     * @deprecated
      */
     backgroundColor?: string | null;
     /** Background image. */
-    backgroundImage?: BackgroundImage;
+    backgroundImage?: LayoutDataBackgroundImage;
     /**
      * Border color as a hexadecimal value.
      * @format COLOR_HEX
@@ -1988,15 +2071,16 @@ interface LayoutData {
     borderColor?: string | null;
     /** Border width in pixels. */
     borderWidth?: number | null;
-    /** Border */
+    /** Border radius in pixels. */
     borderRadius?: number | null;
     /**
-     * Backdrop color as a hexadecimal value.
+     * Deprecated: Use `backdrop` instead.
      * @format COLOR_HEX
+     * @deprecated
      */
     backdropColor?: string | null;
-    /** Backdrop image.radius in pixels. */
-    backdropImage?: BackgroundImage;
+    /** Backdrop image. */
+    backdropImage?: LayoutDataBackgroundImage;
     /** Backdrop top padding. */
     backdropPaddingTop?: number | null;
     /** Backdrop bottom padding */
@@ -2020,8 +2104,12 @@ interface LayoutData {
     designTarget?: DesignTargetWithLiterals;
     /** Banner configuration. When present, this layout is displayed as a banner. */
     banner?: Banner;
+    /** Background styling (color or gradient). */
+    background?: LayoutDataBackground;
+    /** Backdrop styling (color or gradient). */
+    backdrop?: Backdrop;
 }
-declare enum Scaling {
+declare enum ImageScalingScaling {
     /** Auto image scaling */
     AUTO = "AUTO",
     /** Contain image scaling */
@@ -2030,7 +2118,7 @@ declare enum Scaling {
     COVER = "COVER"
 }
 /** @enumType */
-type ScalingWithLiterals = Scaling | 'AUTO' | 'CONTAIN' | 'COVER';
+type ImageScalingScalingWithLiterals = ImageScalingScaling | 'AUTO' | 'CONTAIN' | 'COVER';
 declare enum ImagePosition {
     /** Image positioned at the center */
     CENTER = "CENTER",
@@ -2061,13 +2149,31 @@ declare enum BannerOrigin {
 }
 /** @enumType */
 type BannerOriginWithLiterals = BannerOrigin | 'IMAGE' | 'LAYOUT';
-interface BackgroundImage {
+/** Background type */
+declare enum LayoutDataBackgroundType {
+    /** Solid color background */
+    COLOR = "COLOR",
+    /** Gradient background */
+    GRADIENT = "GRADIENT"
+}
+/** @enumType */
+type LayoutDataBackgroundTypeWithLiterals = LayoutDataBackgroundType | 'COLOR' | 'GRADIENT';
+/** Backdrop type */
+declare enum BackdropType {
+    /** Solid color backdrop */
+    COLOR = "COLOR",
+    /** Gradient backdrop */
+    GRADIENT = "GRADIENT"
+}
+/** @enumType */
+type BackdropTypeWithLiterals = BackdropType | 'COLOR' | 'GRADIENT';
+interface LayoutDataBackgroundImage {
     /** Background image. */
     media?: V1Media;
     /** Background image opacity. */
     opacity?: number | null;
     /** Background image scaling. */
-    scaling?: ScalingWithLiterals;
+    scaling?: ImageScalingScalingWithLiterals;
     /** Position of background. Defaults to `CENTER`. */
     position?: ImagePositionWithLiterals;
 }
@@ -2101,6 +2207,30 @@ interface Banner {
     /** Origin of the banner */
     origin?: BannerOriginWithLiterals;
 }
+/** Background styling (color or gradient) */
+interface LayoutDataBackground {
+    /** Background type. */
+    type?: LayoutDataBackgroundTypeWithLiterals;
+    /**
+     * Background color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
+    color?: string | null;
+    /** Gradient configuration. */
+    gradient?: Gradient;
+}
+/** Backdrop styling (color or gradient) */
+interface Backdrop {
+    /** Backdrop type. */
+    type?: BackdropTypeWithLiterals;
+    /**
+     * Backdrop color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
+    color?: string | null;
+    /** Gradient configuration. */
+    gradient?: Gradient;
+}
 interface LayoutCellData {
     /** Size of the cell in 12 columns grid. */
     colSpan?: number | null;
@@ -2122,6 +2252,120 @@ interface ShapeDataStyles {
     /** Map of original color keys to their new color values. */
     colors?: Record<string, string>;
 }
+interface CardData {
+    /** Background styling (color or gradient). */
+    background?: CardDataBackground;
+    /** Background image. */
+    backgroundImage?: BackgroundImage;
+}
+declare enum Scaling {
+    /** Auto image scaling */
+    AUTO = "AUTO",
+    /** Contain image scaling */
+    CONTAIN = "CONTAIN",
+    /** Cover image scaling */
+    COVER = "COVER"
+}
+/** @enumType */
+type ScalingWithLiterals = Scaling | 'AUTO' | 'CONTAIN' | 'COVER';
+declare enum ImagePositionPosition {
+    /** Image positioned at the center */
+    CENTER = "CENTER",
+    /** Image positioned on the left */
+    CENTER_LEFT = "CENTER_LEFT",
+    /** Image positioned on the right */
+    CENTER_RIGHT = "CENTER_RIGHT",
+    /** Image positioned at the center top */
+    TOP = "TOP",
+    /** Image positioned at the top left */
+    TOP_LEFT = "TOP_LEFT",
+    /** Image positioned at the top right */
+    TOP_RIGHT = "TOP_RIGHT",
+    /** Image positioned at the center bottom */
+    BOTTOM = "BOTTOM",
+    /** Image positioned at the bottom left */
+    BOTTOM_LEFT = "BOTTOM_LEFT",
+    /** Image positioned at the bottom right */
+    BOTTOM_RIGHT = "BOTTOM_RIGHT"
+}
+/** @enumType */
+type ImagePositionPositionWithLiterals = ImagePositionPosition | 'CENTER' | 'CENTER_LEFT' | 'CENTER_RIGHT' | 'TOP' | 'TOP_LEFT' | 'TOP_RIGHT' | 'BOTTOM' | 'BOTTOM_LEFT' | 'BOTTOM_RIGHT';
+/** Background type */
+declare enum CardDataBackgroundType {
+    /** Solid color background */
+    COLOR = "COLOR",
+    /** Gradient background */
+    GRADIENT = "GRADIENT"
+}
+/** @enumType */
+type CardDataBackgroundTypeWithLiterals = CardDataBackgroundType | 'COLOR' | 'GRADIENT';
+/** Background styling (color or gradient) */
+interface CardDataBackground {
+    /** Background type. */
+    type?: CardDataBackgroundTypeWithLiterals;
+    /**
+     * Background color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
+    color?: string | null;
+    /** Gradient configuration. */
+    gradient?: Gradient;
+}
+interface BackgroundImage {
+    /** Background image. */
+    media?: V1Media;
+    /** Background image opacity. */
+    opacity?: number | null;
+    /** Background image scaling. */
+    scaling?: ScalingWithLiterals;
+    /** Position of background. Defaults to `CENTER`. */
+    position?: ImagePositionPositionWithLiterals;
+}
+interface TocData {
+    /** Heading levels included in the table of contents. Default: [1, 2, 3, 4, 5, 6]. */
+    includedHeadings?: number[];
+    /** List style. Default: PLAIN. */
+    listStyle?: ListStyleWithLiterals;
+    /** Optional override for the font size in pixels. */
+    fontSize?: number | null;
+    /** Optional override for the vertical spacing between items in pixels. */
+    itemSpacing?: number | null;
+    /**
+     * Optional override for the text color.
+     * @format COLOR_HEX
+     */
+    color?: string | null;
+    /** Indentation style. Default: NESTED. */
+    indentation?: IndentationWithLiterals;
+}
+/** List style. */
+declare enum ListStyle {
+    /** No markers (default) */
+    PLAIN = "PLAIN",
+    /** Numbered list */
+    NUMBERED = "NUMBERED",
+    /** Alphabetic letters */
+    LETTERS = "LETTERS",
+    /** Roman numerals */
+    ROMAN = "ROMAN",
+    /** Bulleted list */
+    BULLETED = "BULLETED",
+    /** Alphabetical index */
+    ALPHABETICAL_INDEX = "ALPHABETICAL_INDEX",
+    /** Alphabetical index (compact top-row only) */
+    ALPHABETICAL_INDEX_COMPACT = "ALPHABETICAL_INDEX_COMPACT"
+}
+/** @enumType */
+type ListStyleWithLiterals = ListStyle | 'PLAIN' | 'NUMBERED' | 'LETTERS' | 'ROMAN' | 'BULLETED' | 'ALPHABETICAL_INDEX' | 'ALPHABETICAL_INDEX_COMPACT';
+/** Indentation style. */
+declare enum Indentation {
+    /** Sub-headings indented under parents (default) */
+    NESTED = "NESTED",
+    /** All items at the same level */
+    FLAT = "FLAT"
+}
+/** @enumType */
+type IndentationWithLiterals = Indentation | 'NESTED' | 'FLAT';
 interface Metadata {
     /** Schema version. */
     version?: number;
@@ -3910,14 +4154,13 @@ declare function onPostUpdated(handler: (event: PostUpdatedEnvelope) => void | P
 /**
  * Retrieves the number of published posts per month within a specified time range.
  *
- *
- * The `queryPostCountStats()` function returns a Promise that resolves to the number of posts per month within the specified time range.
- *
- * You can set the time range using the `rangeStart` and `months` properties. The time range always starts on the 1st day of the month set in `rangeStart` and includes the number of `months` following `rangeStart`. For example, if `rangeStart` is set to `'2022-03-13'` and `months` is set to `4`, the time range will be from `'2022-03-01'` until `'2022-06-30'`. The time range ends on the last day of the month.
- *
- * >**Note:** If there are no published posts in a specific month, that month is not included in the response. For example, let's say a blog has `0` posts dated in February 2022. If `rangeStart` is set to `'2022-01-01'` and `months` is set to `3`, the response includes `postCount` values for January and March, but not February.
+ * The time range is set using the `rangeStart` and `months` properties.
+ * The time range always starts on the 1st day of the month set in `rangeStart` and
+ * includes the number of `months` following `rangeStart`.
+ * For example, if `rangeStart` is set to `'2022-03-13'` and `months` is set to `4`,
+ * the time range will be from `'2022-03-01'` until `'2022-06-30'`. The time range always ends on the last day of the month.
+ * > Note: If there are no published posts in a month within the time range, that month is not included in the response. For example, let's say a blog has `0` posts dated in February 2022. If `rangeStart` is set to `'2022-01-01'` and `months` is set to `3`, the response includes `postCount` values for January and March, but not February.
  * @public
- * @param options - Options specifying time frame, sort, and filter.
  * @permissionId BLOG.READ-PUBLICATION
  * @applicableIdentity APP
  * @returns Get Blog Post Count Stats response
@@ -3958,7 +4201,6 @@ interface QueryPostCountStatsOptions {
 /**
  * Retrieves the total amount of published posts of the blog.
  * @public
- * @param options - Language Options.
  * @permissionId BLOG.READ-PUBLICATION
  * @applicableIdentity APP
  * @fqn com.wixpress.npm.communities.platformized.blog.BlogStatsService.GetTotalPosts
@@ -3979,12 +4221,12 @@ interface GetTotalPostsOptions {
  * @param postId - Post ID.
  * @public
  * @requiredField postId
- * @param options - Options specifying which fields to return.
  * @permissionId BLOG.READ-PUBLICATION
  * @applicableIdentity APP
+ * @returns Retrieved post info.
  * @fqn com.wixpress.npm.communities.platformized.blog.v3.PostService.GetPost
  */
-declare function getPost(postId: string, options?: GetPostOptions): Promise<NonNullablePaths<GetPostResponse, `post._id` | `post.title` | `post.excerpt` | `post.slug` | `post.featured` | `post.pinned` | `post.categoryIds` | `post.memberId` | `post.hashtags` | `post.commentingEnabled` | `post.minutesToRead` | `post.tagIds` | `post.relatedPostIds` | `post.pricingPlanIds` | `post.seoData.tags` | `post.seoData.tags.${number}.type` | `post.seoData.tags.${number}.children` | `post.seoData.tags.${number}.custom` | `post.seoData.tags.${number}.disabled` | `post.seoData.settings.preventAutoRedirect` | `post.seoData.settings.keywords` | `post.seoData.settings.keywords.${number}.term` | `post.seoData.settings.keywords.${number}.isMain` | `post.preview` | `post.moderationDetails.submittedBy` | `post.moderationDetails.status` | `post.media.embedMedia.thumbnail.url` | `post.media.embedMedia.thumbnail.width` | `post.media.embedMedia.thumbnail.height` | `post.media.embedMedia.video.url` | `post.media.embedMedia.video.width` | `post.media.embedMedia.video.height` | `post.media.displayed` | `post.media.custom` | `post.hasUnpublishedChanges`, 7>>;
+declare function getPost(postId: string, options?: GetPostOptions): Promise<NonNullablePaths<Post, `_id` | `title` | `excerpt` | `slug` | `featured` | `pinned` | `categoryIds` | `memberId` | `hashtags` | `commentingEnabled` | `minutesToRead` | `tagIds` | `relatedPostIds` | `pricingPlanIds` | `seoData.tags` | `seoData.tags.${number}.type` | `seoData.tags.${number}.children` | `seoData.tags.${number}.custom` | `seoData.tags.${number}.disabled` | `seoData.settings.preventAutoRedirect` | `seoData.settings.keywords` | `seoData.settings.keywords.${number}.term` | `seoData.settings.keywords.${number}.isMain` | `preview` | `moderationDetails.submittedBy` | `moderationDetails.status` | `media.embedMedia.thumbnail.url` | `media.embedMedia.thumbnail.width` | `media.embedMedia.thumbnail.height` | `media.embedMedia.video.url` | `media.embedMedia.video.width` | `media.embedMedia.video.height` | `media.displayed` | `media.custom` | `hasUnpublishedChanges`, 6>>;
 interface GetPostOptions {
     /**
      * List of additional post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
@@ -4004,7 +4246,6 @@ interface GetPostOptions {
  * @param slug - Slug of the post to retrieve.
  * @public
  * @requiredField slug
- * @param options - Options specifying which fields to return.
  * @permissionId BLOG.READ-PUBLICATION
  * @applicableIdentity APP
  * @fqn com.wixpress.npm.communities.platformized.blog.v3.PostService.GetPostBySlug
@@ -4032,7 +4273,6 @@ interface GetPostBySlugOptions {
  * - `paging.limit` is `50`.
  * - `paging.offset` is `0`.
  * @public
- * @param options - Sort, filter, and paging options.
  * @permissionId BLOG.READ-PUBLICATION
  * @applicableIdentity APP
  * @fqn com.wixpress.npm.communities.platformized.blog.v3.PostService.ListPosts
@@ -4103,26 +4343,18 @@ interface ListPostsOptions {
     fieldsets?: PostFieldFieldWithLiterals[];
 }
 /**
- * Creates a query to retrieve a list of posts.
+ * Retrieves a list of up to 100 posts, given the provided paging, filtering, and sorting.
  *
+ * Query Posts runs with these defaults, which you can override:
+ * - `firstPublishedDate` is sorted in descending order, with pinned posts first.
+ * - `paging.limit` is `50`.
+ * - `paging.offset` is `0`.
  *
- * The `queryPosts()` function builds a query to retrieve a list of up to 100 posts, and returns a `PostsQueryBuilder` object.
- *
- * The returned object contains the query definition which is typically used to run the query using the `find()` function.
- *
- * You can refine the query by chaining `PostsQueryBuilder` functions onto the query. `PostsQueryBuilder` functions enable you to sort, filter, and control the results that `queryPosts()` returns.
- *
- * `queryPosts()` runs with these `PostsQueryBuilder` defaults that you can override:
- * + `limit(50)`
- * + `descending('firstPublishedDate')`
- *
- * Note that the default limit is `'50'`, but the max limit is `'100'`.
- *
- * To learn how to query posts, refer to the table below.
- *
- * The following `PostsQueryBuilder` functions are supported for the `queryPosts()` function. For a full description of the Posts object, see the object returned for the `items` property in `PostsQueryResult`.
+ * To learn about working with _Query_ endpoints, see
+ * [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language),
+ * [Sorting and Paging](https://dev.wix.com/api/rest/getting-started/sorting-and-paging), and
+ * [Field Projection](https://dev.wix.com/api/rest/getting-started/field-projection).
  * @public
- * @param options - Options specifying which fields to return.
  * @permissionId BLOG.READ-PUBLICATION
  * @applicableIdentity APP
  * @fqn com.wixpress.npm.communities.platformized.blog.v3.PostService.QueryPosts
@@ -4379,7 +4611,7 @@ type PostQuery = {
 };
 declare const utils: {
     query: {
-        /** @enumType */
+        /** Data for a spoiler decoration. */
         QueryBuilder: () => _wix_sdk_types.QueryBuilder<Post, PostQuerySpec, PostQuery>;
         Filter: _wix_sdk_types.FilterFactory<Post, PostQuerySpec>;
         Sort: _wix_sdk_types.SortFactory<PostQuerySpec>;
@@ -4398,4 +4630,4 @@ declare const utils: {
  */
 declare function getPostMetrics(postId: string): Promise<NonNullablePaths<GetPostMetricsResponse, `metrics.comments` | `metrics.likes` | `metrics.views`, 3>>;
 
-export { type AccountInfo, type AccountInfoMetadata, type ActionEvent, Alignment, type AlignmentWithLiterals, type AnchorData, type AppEmbedData, type AppEmbedDataAppDataOneOf, AppType, type AppTypeWithLiterals, AspectRatio, type AspectRatioWithLiterals, type AudioData, type Background, type BackgroundBackgroundOneOf, type BackgroundImage, BackgroundType, type BackgroundTypeWithLiterals, type Banner, BannerOrigin, type BannerOriginWithLiterals, type BaseEventMetadata, type BlockquoteData, type BlogPaging, type BookingData, type Border, type BorderColors, type BorderWidths, type BulkDeletePostsRequest, type BulkDeletePostsResponse, type BulkGetPostReactionsRequest, type BulkGetPostReactionsResponse, type BulletedListData, type ButtonData, ButtonDataType, type ButtonDataTypeWithLiterals, type ButtonStyles, type CaptionData, type CardStyles, type Category, type CategoryTranslation, type CellStyle, type CodeBlockData, type CollapsibleListData, type ColorData, type Colors, type CommonQueryWithEntityContext, type ConvertDraftJsToRichContentRequest, type ConvertDraftJsToRichContentResponse, type ConvertRichContentToDraftJsRequest, type ConvertRichContentToDraftJsResponse, type CreateDraftPostFromTemplateRequest, type CreateDraftPostFromTemplateResponse, Crop, type CropWithLiterals, type CursorPaging, type Cursors, type Decoration, type DecorationDataOneOf, DecorationType, type DecorationTypeWithLiterals, type DeletePostRequest, type DeletePostResponse, type Design, DesignTarget, type DesignTargetWithLiterals, type Dimensions, Direction, type DirectionWithLiterals, type DividerData, DividerDataAlignment, type DividerDataAlignmentWithLiterals, type DocumentStyle, type DomainEvent, type DomainEventBodyOneOf, type DraftPost, type DraftPostTranslation, type EmbedData, type EmbedMedia, type EmbedThumbnail, type EmbedVideo, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type EventData, type EventMetadata, Field, type FieldWithLiterals, type FileData, type FileSource, type FileSourceDataOneOf, type FocalPoint, type FontFamilyData, type FontSizeData, FontType, type FontTypeWithLiterals, type GIF, type GIFData, GIFType, type GIFTypeWithLiterals, type GalleryData, type GalleryOptions, type GalleryOptionsLayout, type GetPostBySlugOptions, type GetPostBySlugRequest, type GetPostBySlugResponse, type GetPostCountPerMonthRequest, type GetPostCountPerMonthResponse, type GetPostCountsRequest, type GetPostCountsResponse, type GetPostMetricsRequest, type GetPostMetricsResponse, type GetPostOptions, type GetPostRequest, type GetPostResponse, GetPostTemplatesSort, type GetPostTemplatesSortWithLiterals, GetPostsSort, type GetPostsSortWithLiterals, type GetTemplateRequest, type GetTemplateResponse, type GetTotalLikesPerMemberRequest, type GetTotalLikesPerMemberResponse, type GetTotalPostsOptions, type GetTotalPostsRequest, type GetTotalPostsResponse, type GetTotalPublicationsRequest, type GetTotalPublicationsResponse, type Gradient, type HTMLData, type HTMLDataDataOneOf, type HeadingData, type Height, type IdentificationData, type IdentificationDataIdOneOf, type Image, type ImageData, type ImageDataStyles, ImagePosition, type ImagePositionWithLiterals, type ImageStyles, InitialExpandedItems, type InitialExpandedItemsWithLiterals, type InitialPostsCopied, type Item, type ItemDataOneOf, type ItemStyle, type Keyword, Layout, type LayoutCellData, type LayoutData, LayoutType, type LayoutTypeWithLiterals, type LayoutWithLiterals, type LikePostRequest, type LikePostResponse, LineStyle, type LineStyleWithLiterals, type Link, type LinkData, type LinkDataOneOf, type LinkPreviewData, type LinkPreviewDataStyles, type ListDemoPostsRequest, type ListDemoPostsResponse, type ListPostsArchiveRequest, type ListPostsArchiveResponse, type ListPostsOptions, type ListPostsRequest, type ListPostsResponse, type ListTemplatesRequest, type ListTemplatesResponse, type ListValue, type MapData, type MapSettings, MapType, type MapTypeWithLiterals, type Media, type MediaMediaOneOf, type MentionData, type MessageEnvelope, type MetaData, type Metadata, type Metrics, type ModerationDetails, ModerationStatusStatus, type ModerationStatusStatusWithLiterals, type Node, type NodeDataOneOf, type NodeStyle, NodeType, type NodeTypeWithLiterals, NullValue, type NullValueWithLiterals, type Oembed, type Option, type OptionDesign, type OptionLayout, Order, type OrderWithLiterals, type OrderedListData, Orientation, type OrientationWithLiterals, Origin, type OriginWithLiterals, type PDFSettings, type Paging, type PagingMetadataV2, type ParagraphData, type PeriodPostCount, type PeriodPublicationsCount, type Permissions, type PinPostRequest, type PinPostResponse, Placement, type PlacementWithLiterals, type PlatformQuery, type PlatformQueryPagingMethodOneOf, type PlaybackOptions, type PluginContainerData, PluginContainerDataAlignment, type PluginContainerDataAlignmentWithLiterals, type PluginContainerDataWidth, type PluginContainerDataWidthDataOneOf, type Poll, type PollData, type PollDataLayout, type PollDesign, type PollLayout, PollLayoutDirection, type PollLayoutDirectionWithLiterals, PollLayoutType, type PollLayoutTypeWithLiterals, type PollSettings, Position, type PositionWithLiterals, type Post, type PostCategoriesUpdated, type PostCount, type PostCountInfo, type PostCountPerMonth, type PostCountersUpdated, type PostCountersUpdatedInitiatorOneOf, type PostCreatedEnvelope, type PostDeletedEnvelope, PostFieldField, type PostFieldFieldWithLiterals, type PostLiked, type PostLikedEnvelope, type PostLikedInitiatorOneOf, type PostOwnerChanged, type PostQuery, type PostQuerySpec, type PostTagsUpdated, type PostTranslation, type PostUnliked, type PostUnlikedEnvelope, type PostUnlikedInitiatorOneOf, type PostUpdatedEnvelope, type PostsQueryBuilder, type PostsQueryResult, type PricingData, type QueryPostCountStatsOptions, type QueryPostCountStatsRequest, type QueryPostCountStatsResponse, type QueryPostsOptions, type QueryPostsRequest, type QueryPostsResponse, type QueryPublicationsCountStatsRequest, QueryPublicationsCountStatsRequestOrder, type QueryPublicationsCountStatsRequestOrderWithLiterals, type QueryPublicationsCountStatsResponse, type Reactions, type Rel, Resizing, type ResizingWithLiterals, ResponsivenessBehaviour, type ResponsivenessBehaviourWithLiterals, type RestoreInfo, type RibbonStyles, type RichContent, Scaling, type ScalingWithLiterals, type ScheduledPostPublished, type SeoSchema, type Settings, type ShapeData, type ShapeDataStyles, SortOrder, type SortOrderWithLiterals, type Sorting, Source, type SourceWithLiterals, type Spoiler, type SpoilerData, Status, type StatusWithLiterals, type Styles, type StylesBorder, StylesPosition, type StylesPositionWithLiterals, type TableCellData, type TableData, type Tag, Target, type TargetWithLiterals, TextAlignment, type TextAlignmentWithLiterals, type TextData, type TextNodeStyle, type TextStyle, type Thumbnails, ThumbnailsAlignment, type ThumbnailsAlignmentWithLiterals, Type, type TypeWithLiterals, type UnlikePostRequest, type UnlikePostResponse, type UnpinPostRequest, type UnpinPostResponse, type V1Media, VerticalAlignment, VerticalAlignmentAlignment, type VerticalAlignmentAlignmentWithLiterals, type VerticalAlignmentWithLiterals, type Video, type VideoData, type VideoResolution, ViewMode, type ViewModeWithLiterals, type ViewPostRequest, type ViewPostResponse, ViewRole, type ViewRoleWithLiterals, VoteRole, type VoteRoleWithLiterals, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, Width, WidthType, type WidthTypeWithLiterals, type WidthWithLiterals, type WixMedia, getPost, getPostBySlug, getPostMetrics, getTotalPosts, listPosts, onPostCreated, onPostDeleted, onPostLiked, onPostUnliked, onPostUpdated, queryPostCountStats, queryPosts, typedQueryPosts, utils };
+export { type AccountInfo, type AccountInfoMetadata, type ActionEvent, Alignment, type AlignmentWithLiterals, type AnchorData, type AppEmbedData, type AppEmbedDataAppDataOneOf, AppType, type AppTypeWithLiterals, AspectRatio, type AspectRatioWithLiterals, type AudioData, type Backdrop, BackdropType, type BackdropTypeWithLiterals, type Background, type BackgroundGradient, type BackgroundImage, BackgroundType, type BackgroundTypeWithLiterals, type Banner, BannerOrigin, type BannerOriginWithLiterals, type BaseEventMetadata, type BlockquoteData, type BlogPaging, type BookingData, type Border, type BorderColors, type BorderWidths, type BulkDeletePostsRequest, type BulkDeletePostsResponse, type BulkGetPostReactionsRequest, type BulkGetPostReactionsResponse, type BulletedListData, type ButtonData, ButtonDataType, type ButtonDataTypeWithLiterals, type ButtonStyles, type CaptionData, type CardData, type CardDataBackground, CardDataBackgroundType, type CardDataBackgroundTypeWithLiterals, type CardStyles, type Category, type CategoryTranslation, type CellStyle, type CodeBlockData, type CollapsibleListData, type ColorData, type Colors, type CommonQueryWithEntityContext, type ConvertDraftJsToRichContentRequest, type ConvertDraftJsToRichContentResponse, type ConvertRichContentToDraftJsRequest, type ConvertRichContentToDraftJsResponse, type CreateDraftPostFromTemplateRequest, type CreateDraftPostFromTemplateResponse, Crop, type CropWithLiterals, type CursorPaging, type Cursors, type Decoration, type DecorationDataOneOf, DecorationType, type DecorationTypeWithLiterals, type DeletePostRequest, type DeletePostResponse, type Design, DesignTarget, type DesignTargetWithLiterals, type Dimensions, Direction, type DirectionWithLiterals, type DividerData, DividerDataAlignment, type DividerDataAlignmentWithLiterals, type DocumentStyle, type DomainEvent, type DomainEventBodyOneOf, type DraftPost, type DraftPostTranslation, type EmbedData, type EmbedMedia, type EmbedThumbnail, type EmbedVideo, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type EventData, type EventMetadata, Field, type FieldWithLiterals, type FileData, type FileSource, type FileSourceDataOneOf, type FocalPoint, type FontFamilyData, type FontSizeData, FontType, type FontTypeWithLiterals, type GIF, type GIFData, GIFType, type GIFTypeWithLiterals, type GalleryData, type GalleryOptions, type GalleryOptionsLayout, type GetPostBySlugOptions, type GetPostBySlugRequest, type GetPostBySlugResponse, type GetPostCountPerMonthRequest, type GetPostCountPerMonthResponse, type GetPostCountsRequest, type GetPostCountsResponse, type GetPostMetricsRequest, type GetPostMetricsResponse, type GetPostOptions, type GetPostRequest, type GetPostResponse, GetPostTemplatesSort, type GetPostTemplatesSortWithLiterals, GetPostsSort, type GetPostsSortWithLiterals, type GetTemplateRequest, type GetTemplateResponse, type GetTotalLikesPerMemberRequest, type GetTotalLikesPerMemberResponse, type GetTotalPostsOptions, type GetTotalPostsRequest, type GetTotalPostsResponse, type GetTotalPublicationsRequest, type GetTotalPublicationsResponse, type Gradient, GradientType, type GradientTypeWithLiterals, type HTMLData, type HTMLDataDataOneOf, type HeadingData, type Height, type IdentificationData, type IdentificationDataIdOneOf, type Image, type ImageData, type ImageDataStyles, ImagePosition, ImagePositionPosition, type ImagePositionPositionWithLiterals, type ImagePositionWithLiterals, ImageScalingScaling, type ImageScalingScalingWithLiterals, type ImageStyles, Indentation, type IndentationWithLiterals, InitialExpandedItems, type InitialExpandedItemsWithLiterals, type InitialPostsCopied, type Item, type ItemDataOneOf, type ItemStyle, type Keyword, Layout, type LayoutCellData, type LayoutData, type LayoutDataBackground, type LayoutDataBackgroundImage, LayoutDataBackgroundType, type LayoutDataBackgroundTypeWithLiterals, LayoutType, type LayoutTypeWithLiterals, type LayoutWithLiterals, type LikePostRequest, type LikePostResponse, LineStyle, type LineStyleWithLiterals, type Link, type LinkData, type LinkDataOneOf, type LinkPreviewData, type LinkPreviewDataStyles, type ListDemoPostsRequest, type ListDemoPostsResponse, type ListPostsArchiveRequest, type ListPostsArchiveResponse, type ListPostsOptions, type ListPostsRequest, type ListPostsResponse, ListStyle, type ListStyleWithLiterals, type ListTemplatesRequest, type ListTemplatesResponse, type ListValue, type MapData, type MapSettings, MapType, type MapTypeWithLiterals, type Media, type MediaMediaOneOf, type MentionData, type MessageEnvelope, type MetaData, type Metadata, type Metrics, type ModerationDetails, ModerationStatusStatus, type ModerationStatusStatusWithLiterals, type Node, type NodeDataOneOf, type NodeStyle, NodeType, type NodeTypeWithLiterals, NullValue, type NullValueWithLiterals, type Oembed, type Option, type OptionDesign, type OptionLayout, Order, type OrderWithLiterals, type OrderedListData, Orientation, type OrientationWithLiterals, Origin, type OriginWithLiterals, type PDFSettings, type Paging, type PagingMetadataV2, type ParagraphData, type PeriodPostCount, type PeriodPublicationsCount, type Permissions, type PinPostRequest, type PinPostResponse, Placement, type PlacementWithLiterals, type PlatformQuery, type PlatformQueryPagingMethodOneOf, type PlaybackOptions, type PluginContainerData, PluginContainerDataAlignment, type PluginContainerDataAlignmentWithLiterals, type PluginContainerDataWidth, type PluginContainerDataWidthDataOneOf, type Poll, type PollData, type PollDataLayout, type PollDesign, type PollDesignBackground, type PollDesignBackgroundBackgroundOneOf, PollDesignBackgroundType, type PollDesignBackgroundTypeWithLiterals, type PollLayout, PollLayoutDirection, type PollLayoutDirectionWithLiterals, PollLayoutType, type PollLayoutTypeWithLiterals, type PollSettings, Position, type PositionWithLiterals, type Post, type PostCategoriesUpdated, type PostCount, type PostCountInfo, type PostCountPerMonth, type PostCountersUpdated, type PostCountersUpdatedInitiatorOneOf, type PostCreatedEnvelope, type PostDeletedEnvelope, PostFieldField, type PostFieldFieldWithLiterals, type PostLiked, type PostLikedEnvelope, type PostLikedInitiatorOneOf, type PostOwnerChanged, type PostQuery, type PostQuerySpec, type PostTagsUpdated, type PostTranslation, type PostUnliked, type PostUnlikedEnvelope, type PostUnlikedInitiatorOneOf, type PostUpdatedEnvelope, type PostsQueryBuilder, type PostsQueryResult, type PricingData, type QueryPostCountStatsOptions, type QueryPostCountStatsRequest, type QueryPostCountStatsResponse, type QueryPostsOptions, type QueryPostsRequest, type QueryPostsResponse, type QueryPublicationsCountStatsRequest, QueryPublicationsCountStatsRequestOrder, type QueryPublicationsCountStatsRequestOrderWithLiterals, type QueryPublicationsCountStatsResponse, type Reactions, type Rel, Resizing, type ResizingWithLiterals, ResponsivenessBehaviour, type ResponsivenessBehaviourWithLiterals, type RestoreInfo, type RibbonStyles, type RichContent, Scaling, type ScalingWithLiterals, type ScheduledPostPublished, type SeoSchema, type Settings, type ShapeData, type ShapeDataStyles, SortOrder, type SortOrderWithLiterals, type Sorting, Source, type SourceWithLiterals, type Spoiler, type SpoilerData, Status, type StatusWithLiterals, type Stop, type Styles, type StylesBorder, StylesPosition, type StylesPositionWithLiterals, type TableCellData, type TableData, type Tag, Target, type TargetWithLiterals, TextAlignment, type TextAlignmentWithLiterals, type TextData, type TextNodeStyle, type TextStyle, type Thumbnails, ThumbnailsAlignment, type ThumbnailsAlignmentWithLiterals, type TocData, Type, type TypeWithLiterals, type UnlikePostRequest, type UnlikePostResponse, type UnpinPostRequest, type UnpinPostResponse, type V1Media, VerticalAlignment, VerticalAlignmentAlignment, type VerticalAlignmentAlignmentWithLiterals, type VerticalAlignmentWithLiterals, type Video, type VideoData, type VideoResolution, ViewMode, type ViewModeWithLiterals, type ViewPostRequest, type ViewPostResponse, ViewRole, type ViewRoleWithLiterals, VoteRole, type VoteRoleWithLiterals, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, Width, WidthType, type WidthTypeWithLiterals, type WidthWithLiterals, type WixMedia, getPost, getPostBySlug, getPostMetrics, getTotalPosts, listPosts, onPostCreated, onPostDeleted, onPostLiked, onPostUnliked, onPostUpdated, queryPostCountStats, queryPosts, typedQueryPosts, utils };