@wix/auto_sdk_blog_posts 1.0.171 → 1.0.172

package/build/cjs/schemas.d.ts

@@ -43,91 +43,89 @@ declare const GetPostRequest: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const GetPostResponse: z.ZodObject<{
-    post: z.ZodOptional<z.ZodObject<{
-        _id: z.ZodOptional<z.ZodString>;
-        title: z.ZodOptional<z.ZodString>;
-        excerpt: z.ZodOptional<z.ZodString>;
-        contentText: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-        firstPublishedDate: z.ZodNullable<z.ZodOptional<z.ZodDate>>;
-        lastPublishedDate: z.ZodNullable<z.ZodOptional<z.ZodDate>>;
-        url: z.ZodOptional<z.ZodString>;
-        slug: z.ZodOptional<z.ZodString>;
-        featured: z.ZodOptional<z.ZodBoolean>;
-        pinned: z.ZodOptional<z.ZodBoolean>;
-        categoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        memberId: z.ZodOptional<z.ZodString>;
-        hashtags: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        commentingEnabled: z.ZodOptional<z.ZodBoolean>;
-        minutesToRead: z.ZodOptional<z.ZodNumber>;
-        heroImage: z.ZodOptional<z.ZodString>;
-        tagIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        relatedPostIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        pricingPlanIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        translationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-        language: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-        seoData: z.ZodOptional<z.ZodObject<{
-            tags: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                type: z.ZodOptional<z.ZodString>;
-                props: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
-                meta: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
-                children: z.ZodOptional<z.ZodString>;
-                custom: z.ZodOptional<z.ZodBoolean>;
-                disabled: z.ZodOptional<z.ZodBoolean>;
+    _id: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    excerpt: z.ZodOptional<z.ZodString>;
+    contentText: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    firstPublishedDate: z.ZodNullable<z.ZodOptional<z.ZodDate>>;
+    lastPublishedDate: z.ZodNullable<z.ZodOptional<z.ZodDate>>;
+    url: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    featured: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
+    categoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    memberId: z.ZodOptional<z.ZodString>;
+    hashtags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    commentingEnabled: z.ZodOptional<z.ZodBoolean>;
+    minutesToRead: z.ZodOptional<z.ZodNumber>;
+    heroImage: z.ZodOptional<z.ZodString>;
+    tagIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    relatedPostIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    pricingPlanIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    translationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    language: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    seoData: z.ZodOptional<z.ZodObject<{
+        tags: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodOptional<z.ZodString>;
+            props: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+            meta: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+            children: z.ZodOptional<z.ZodString>;
+            custom: z.ZodOptional<z.ZodBoolean>;
+            disabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        settings: z.ZodOptional<z.ZodObject<{
+            preventAutoRedirect: z.ZodOptional<z.ZodBoolean>;
+            keywords: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                term: z.ZodOptional<z.ZodString>;
+                isMain: z.ZodOptional<z.ZodBoolean>;
+                origin: z.ZodNullable<z.ZodOptional<z.ZodString>>;
             }, z.core.$strip>>>;
-            settings: z.ZodOptional<z.ZodObject<{
-                preventAutoRedirect: z.ZodOptional<z.ZodBoolean>;
-                keywords: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    term: z.ZodOptional<z.ZodString>;
-                    isMain: z.ZodOptional<z.ZodBoolean>;
-                    origin: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-                }, z.core.$strip>>>;
-            }, z.core.$strip>>;
         }, z.core.$strip>>;
-        contactId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-        richContent: z.ZodOptional<z.ZodAny>;
-        preview: z.ZodOptional<z.ZodBoolean>;
-        moderationDetails: z.ZodOptional<z.ZodObject<{
-            submittedBy: z.ZodOptional<z.ZodString>;
-            submittedDate: z.ZodNullable<z.ZodOptional<z.ZodDate>>;
-            status: z.ZodOptional<z.ZodEnum<{
-                UNKNOWN: "UNKNOWN";
-                APPROVED: "APPROVED";
-                REJECTED: "REJECTED";
-            }>>;
-            moderatedBy: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-            moderationDate: z.ZodNullable<z.ZodOptional<z.ZodDate>>;
-        }, z.core.$strip>>;
-        media: z.ZodOptional<z.ZodIntersection<z.ZodObject<{
-            displayed: z.ZodOptional<z.ZodBoolean>;
-            custom: z.ZodOptional<z.ZodBoolean>;
-            altText: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-        }, z.core.$strip>, z.ZodXor<readonly [z.ZodObject<{
-            wixMedia: z.ZodOptional<z.ZodNever>;
-            embedMedia: z.ZodOptional<z.ZodNever>;
-        }, z.core.$strip>, z.ZodObject<{
-            embedMedia: z.ZodOptional<z.ZodNever>;
-            wixMedia: z.ZodObject<{
-                image: z.ZodOptional<z.ZodString>;
-                videoV2: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>;
-        }, z.core.$strip>, z.ZodObject<{
-            wixMedia: z.ZodOptional<z.ZodNever>;
-            embedMedia: z.ZodObject<{
-                thumbnail: z.ZodOptional<z.ZodObject<{
-                    url: z.ZodOptional<z.ZodString>;
-                    width: z.ZodOptional<z.ZodNumber>;
-                    height: z.ZodOptional<z.ZodNumber>;
-                }, z.core.$strip>>;
-                video: z.ZodOptional<z.ZodObject<{
-                    url: z.ZodOptional<z.ZodString>;
-                    width: z.ZodOptional<z.ZodNumber>;
-                    height: z.ZodOptional<z.ZodNumber>;
-                }, z.core.$strip>>;
-            }, z.core.$strip>;
-        }, z.core.$strip>]>>>;
-        hasUnpublishedChanges: z.ZodOptional<z.ZodBoolean>;
-        referenceId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     }, z.core.$strip>>;
+    contactId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    richContent: z.ZodOptional<z.ZodAny>;
+    preview: z.ZodOptional<z.ZodBoolean>;
+    moderationDetails: z.ZodOptional<z.ZodObject<{
+        submittedBy: z.ZodOptional<z.ZodString>;
+        submittedDate: z.ZodNullable<z.ZodOptional<z.ZodDate>>;
+        status: z.ZodOptional<z.ZodEnum<{
+            UNKNOWN: "UNKNOWN";
+            APPROVED: "APPROVED";
+            REJECTED: "REJECTED";
+        }>>;
+        moderatedBy: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        moderationDate: z.ZodNullable<z.ZodOptional<z.ZodDate>>;
+    }, z.core.$strip>>;
+    media: z.ZodOptional<z.ZodIntersection<z.ZodObject<{
+        displayed: z.ZodOptional<z.ZodBoolean>;
+        custom: z.ZodOptional<z.ZodBoolean>;
+        altText: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>, z.ZodXor<readonly [z.ZodObject<{
+        wixMedia: z.ZodOptional<z.ZodNever>;
+        embedMedia: z.ZodOptional<z.ZodNever>;
+    }, z.core.$strip>, z.ZodObject<{
+        embedMedia: z.ZodOptional<z.ZodNever>;
+        wixMedia: z.ZodObject<{
+            image: z.ZodOptional<z.ZodString>;
+            videoV2: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        wixMedia: z.ZodOptional<z.ZodNever>;
+        embedMedia: z.ZodObject<{
+            thumbnail: z.ZodOptional<z.ZodObject<{
+                url: z.ZodOptional<z.ZodString>;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            video: z.ZodOptional<z.ZodObject<{
+                url: z.ZodOptional<z.ZodString>;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>]>>>;
+    hasUnpublishedChanges: z.ZodOptional<z.ZodBoolean>;
+    referenceId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
 declare const GetPostBySlugRequest: z.ZodObject<{
     slug: z.ZodString;
@@ -466,11 +464,11 @@ declare const QueryPostsRequest: z.ZodObject<{
             fieldName: z.ZodOptional<z.ZodEnum<{
                 slug: "slug";
                 title: "title";
-                firstPublishedDate: "firstPublishedDate";
-                lastPublishedDate: "lastPublishedDate";
                 featured: "featured";
                 pinned: "pinned";
                 commentingEnabled: "commentingEnabled";
+                firstPublishedDate: "firstPublishedDate";
+                lastPublishedDate: "lastPublishedDate";
             }>>;
             order: z.ZodOptional<z.ZodEnum<{
                 ASC: "ASC";

package/build/cjs/schemas.js

@@ -62,7 +62,7 @@ var QueryPostCountStatsRequest = z.object({
     timeZone: z.string().describe(
       "Time zone to use when calculating the start of the month.\n\n[UTC timezone offset](https://en.wikipedia.org/wiki/List_of_UTC_offsets) format. For example, New York time zone is `-05`."
     ).min(3).max(100).optional().nullable()
-  }).describe("Options specifying time frame, sort, and filter. ").optional()
+  }).optional()
 });
 var QueryPostCountStatsResponse = z.object({
   stats: z.array(
@@ -79,7 +79,7 @@ var GetTotalPostsRequest = z.object({
     language: z.string().describe(
       "Language filter.\n\n2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format.\nPass a language to receive the total amount of posts in that specified language."
     ).optional().nullable()
-  }).describe("Language Options.").optional()
+  }).optional()
 });
 var GetTotalPostsResponse = z.object({
   total: z.number().int().describe("Total amount of published posts.").min(0).optional()
@@ -99,167 +99,161 @@ var GetPostRequest = z.object({
         "REFERENCE_ID"
       ])
     ).max(20).optional()
-  }).describe("Options specifying which fields to return.").optional()
+  }).optional()
 });
 var GetPostResponse = z.object({
-  post: z.object({
-    _id: z.string().describe("Post ID.").regex(
-      /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
-      "Must be a valid GUID"
-    ).optional(),
-    title: z.string().describe("Post title.").max(200).optional(),
-    excerpt: z.string().describe(
-      "Post excerpt.\nCan be selected by a site contributor. By default, it is extracted from the content text's first characters.\n\nMax: 500 characters"
-    ).max(500).optional(),
-    contentText: z.string().describe("The post's content in plain text.").max(4e5).optional().nullable(),
-    firstPublishedDate: z.date().describe("Date the post was first published.").optional().nullable(),
-    lastPublishedDate: z.date().describe("Date the post was last published.").optional().nullable(),
-    url: z.string().describe("Post URL.").optional(),
-    slug: z.string().describe("Post slug. For example, `'post-slug'`.").max(100).optional(),
-    featured: z.boolean().describe("Whether the post is marked as featured.").optional(),
-    pinned: z.boolean().describe(
-      "Whether the post is pinned. If `true`, the post is placed at the top of the post list."
-    ).optional(),
-    categoryIds: z.array(z.string()).max(10).optional(),
-    memberId: z.string().describe("Member ID of the post's owner.").regex(
-      /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
-      "Must be a valid GUID"
-    ).optional(),
-    hashtags: z.array(z.string()).max(100).optional(),
-    commentingEnabled: z.boolean().describe("Whether commenting on the post is enabled.").optional(),
-    minutesToRead: z.number().int().describe("Estimated reading time (calculated automatically).").optional(),
-    heroImage: z.string().describe(
-      "Image placed at the top of the blog page. Only displays on mobile devices."
+  _id: z.string().describe("Post ID.").regex(
+    /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
+    "Must be a valid GUID"
+  ).optional(),
+  title: z.string().describe("Post title.").max(200).optional(),
+  excerpt: z.string().describe(
+    "Post excerpt.\nCan be selected by a site contributor. By default, it is extracted from the content text's first characters.\n\nMax: 500 characters"
+  ).max(500).optional(),
+  contentText: z.string().describe("The post's content in plain text.").max(4e5).optional().nullable(),
+  firstPublishedDate: z.date().describe("Date the post was first published.").optional().nullable(),
+  lastPublishedDate: z.date().describe("Date the post was last published.").optional().nullable(),
+  url: z.string().describe("Post URL.").optional(),
+  slug: z.string().describe("Post slug. For example, `'post-slug'`.").max(100).optional(),
+  featured: z.boolean().describe("Whether the post is marked as featured.").optional(),
+  pinned: z.boolean().describe(
+    "Whether the post is pinned. If `true`, the post is placed at the top of the post list."
+  ).optional(),
+  categoryIds: z.array(z.string()).max(10).optional(),
+  memberId: z.string().describe("Member ID of the post's owner.").regex(
+    /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
+    "Must be a valid GUID"
+  ).optional(),
+  hashtags: z.array(z.string()).max(100).optional(),
+  commentingEnabled: z.boolean().describe("Whether commenting on the post is enabled.").optional(),
+  minutesToRead: z.number().int().describe("Estimated reading time (calculated automatically).").optional(),
+  heroImage: z.string().describe(
+    "Image placed at the top of the blog page. Only displays on mobile devices."
+  ).optional(),
+  tagIds: z.array(z.string()).max(30).optional(),
+  relatedPostIds: z.array(z.string()).max(3).optional(),
+  pricingPlanIds: z.array(z.string()).max(100).optional(),
+  translationId: z.string().describe(
+    "ID of the translations of this post. All translations of a single post share the same `translationId`."
+  ).regex(
+    /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
+    "Must be a valid GUID"
+  ).optional().nullable(),
+  language: z.string().describe(
+    "Language the post is written in.\n\n2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format."
+  ).optional().nullable(),
+  seoData: z.object({
+    tags: z.array(
+      z.object({
+        type: z.string().describe(
+          "SEO tag type.\n\n\nSupported values: `title`, `meta`, `script`, `link`."
+        ).optional(),
+        props: z.record(z.string(), z.any()).describe(
+          'A `{"key": "value"}` pair object where each SEO tag property (`"name"`, `"content"`, `"rel"`, `"href"`) contains a value.\nFor example: `{"name": "description", "content": "the description itself"}`.'
+        ).optional().nullable(),
+        meta: z.record(z.string(), z.any()).describe(
+          'SEO tag metadata. For example, `{"height": 300, "width": 240}`.'
+        ).optional().nullable(),
+        children: z.string().describe(
+          "SEO tag inner content. For example, `<title> inner content </title>`."
+        ).optional(),
+        custom: z.boolean().describe(
+          "Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages) \u2014\ni.e. an entry from the site's Advanced/Custom Tags list.\n\nThis flag is scoped to that feature only. It is NOT an indicator of whether a standard tag\n(`title`, `description`, Open Graph, etc.) reflects a manually configured value versus a computed\ndefault/pattern \u2014 standard tags always resolve with `custom: false`, even when their content comes\nfrom a page's manually saved SEO title/description override. Don't use this field to verify whether\na live page reflects a manual per-page SEO edit.\n\nLimitation: when `ResolveStaticPageSeoTags` is called without `seoData`, the per-page SEO data is read\nonly from the Vibe/Wix-managed-headless override store. That store holds nothing for classic Wix Editor\nor Wix Studio pages, so even genuine Advanced/Custom Tags saved on those pages are missing from the\nresponse entirely \u2014 there, `false` means this API could not tell, not that no custom tag exists.\nPass `seoData` explicitly to resolve against a known set of tags."
+        ).optional(),
+        disabled: z.boolean().describe(
+          "Whether the tag is disabled. If the tag is disabled, people can't find your page when searching for this phrase in search engines."
+        ).optional()
+      })
     ).optional(),
-    tagIds: z.array(z.string()).max(30).optional(),
-    relatedPostIds: z.array(z.string()).max(3).optional(),
-    pricingPlanIds: z.array(z.string()).max(100).optional(),
-    translationId: z.string().describe(
-      "ID of the translations of this post. All translations of a single post share the same `translationId`."
-    ).regex(
-      /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
-      "Must be a valid GUID"
-    ).optional().nullable(),
-    language: z.string().describe(
-      "Language the post is written in.\n\n2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format."
-    ).optional().nullable(),
-    seoData: z.object({
-      tags: z.array(
+    settings: z.object({
+      preventAutoRedirect: z.boolean().describe(
+        "Whether the [automatical redirect visits](https://support.wix.com/en/article/customizing-your-pages-seo-settings-in-the-seo-panel) from the old URL to the new one is enabled.\n\n\nDefault: `false` (automatical redirect is enabled)."
+      ).optional(),
+      keywords: z.array(
         z.object({
-          type: z.string().describe(
-            "SEO tag type.\n\n\nSupported values: `title`, `meta`, `script`, `link`."
-          ).optional(),
-          props: z.record(z.string(), z.any()).describe(
-            'A `{"key": "value"}` pair object where each SEO tag property (`"name"`, `"content"`, `"rel"`, `"href"`) contains a value.\nFor example: `{"name": "description", "content": "the description itself"}`.'
-          ).optional().nullable(),
-          meta: z.record(z.string(), z.any()).describe(
-            'SEO tag metadata. For example, `{"height": 300, "width": 240}`.'
-          ).optional().nullable(),
-          children: z.string().describe(
-            "SEO tag inner content. For example, `<title> inner content </title>`."
-          ).optional(),
-          custom: z.boolean().describe(
-            'Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages).\n\nLimitation: when `ResolveStaticPageSeoTags` is called without `seoData`, the per-page SEO data is read\nonly from the Vibe/Wix-managed-headless override store. That store holds nothing for classic Wix Editor\nor Wix Studio pages, so custom tags saved on those pages are missing from the response entirely. For\nthose pages `false` therefore does not mean "not a custom tag" \u2014 it means this API could not tell.\nPass `seoData` explicitly to resolve against a known set of tags.'
-          ).optional(),
-          disabled: z.boolean().describe(
-            "Whether the tag is disabled. If the tag is disabled, people can't find your page when searching for this phrase in search engines."
-          ).optional()
+          term: z.string().describe("Keyword value.").optional(),
+          isMain: z.boolean().describe("Whether the keyword is the main focus keyword.").optional(),
+          origin: z.string().describe(
+            "The source that added the keyword terms to the SEO settings."
+          ).max(1e3).optional().nullable()
         })
-      ).optional(),
-      settings: z.object({
-        preventAutoRedirect: z.boolean().describe(
-          "Whether the [automatical redirect visits](https://support.wix.com/en/article/customizing-your-pages-seo-settings-in-the-seo-panel) from the old URL to the new one is enabled.\n\n\nDefault: `false` (automatical redirect is enabled)."
-        ).optional(),
-        keywords: z.array(
-          z.object({
-            term: z.string().describe("Keyword value.").optional(),
-            isMain: z.boolean().describe(
-              "Whether the keyword is the main focus keyword."
-            ).optional(),
-            origin: z.string().describe(
-              "The source that added the keyword terms to the SEO settings."
-            ).max(1e3).optional().nullable()
-          })
-        ).max(5).optional()
-      }).describe("SEO general settings.").optional()
-    }).describe("SEO data.").optional(),
-    contactId: z.string().describe(
-      "Contact ID of the post's owner. See the Contacts API for more info."
+      ).max(5).optional()
+    }).describe("SEO general settings.").optional()
+  }).describe("SEO data.").optional(),
+  contactId: z.string().describe(
+    "Contact ID of the post's owner. See the Contacts API for more info."
+  ).regex(
+    /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
+    "Must be a valid GUID"
+  ).optional().nullable(),
+  richContent: z.any().describe(
+    'Post rich content\n\n<widget src="https://apps.wix.com/_serverless/ricos-playground-services/goto/api-component" plugins="image.gallery.video.audio.divider.linkButton.html.giphy.codeBlock.file.hashtag.lineSpacing.indent.link.textColor.textHighlight.heading.verticalEmbed.table.collapsibleList.poll" exampleid="72c23a25-524f-4f70-a260-4a2777b6f5d5">\n<a href="https://dev.wix.com/docs/ricos/api-reference/ricos-document">See Ricos document reference</a>\n</widget>'
+  ).optional(),
+  preview: z.boolean().describe(
+    "Whether the returned content is a preview of premium content. Defaults to `false`.\nA preview displays a limited number of paragraphs of paid content to non-subscribed users."
+  ).optional(),
+  moderationDetails: z.object({
+    submittedBy: z.string().describe(
+      "Member ID of the person submitting the draft post for review."
     ).regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
-    ).optional().nullable(),
-    richContent: z.any().describe(
-      'Post rich content\n\n<widget src="https://apps.wix.com/_serverless/ricos-playground-services/goto/api-component" plugins="image.gallery.video.audio.divider.linkButton.html.giphy.codeBlock.file.hashtag.lineSpacing.indent.link.textColor.textHighlight.heading.verticalEmbed.table.collapsibleList.poll" exampleid="72c23a25-524f-4f70-a260-4a2777b6f5d5">\n<a href="https://dev.wix.com/docs/ricos/api-reference/ricos-document">See Ricos document reference</a>\n</widget>'
     ).optional(),
-    preview: z.boolean().describe(
-      "Whether the returned content is a preview of premium content. Defaults to `false`.\nA preview displays a limited number of paragraphs of paid content to non-subscribed users."
+    submittedDate: z.date().describe("Date the post was submitted for review.").optional().nullable(),
+    status: z.enum(["UNKNOWN", "APPROVED", "REJECTED"]).describe(
+      "Status indicating whether the submission was approved or rejected by the moderator."
     ).optional(),
-    moderationDetails: z.object({
-      submittedBy: z.string().describe(
-        "Member ID of the person submitting the draft post for review."
-      ).regex(
-        /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
-        "Must be a valid GUID"
-      ).optional(),
-      submittedDate: z.date().describe("Date the post was submitted for review.").optional().nullable(),
-      status: z.enum(["UNKNOWN", "APPROVED", "REJECTED"]).describe(
-        "Status indicating whether the submission was approved or rejected by the moderator."
+    moderatedBy: z.string().describe("Member ID of the person who approved or rejected the post.").regex(
+      /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
+      "Must be a valid GUID"
+    ).optional().nullable(),
+    moderationDate: z.date().describe("Date the post was approved or rejected.").optional().nullable()
+  }).describe(
+    "Post moderation details. Only relevant to posts submitted by [guest writers](https://support.wix.com/en/article/wix-blog-moderating-blog-posts-from-your-guest-writers).\n\nGuest writers have the ability to write posts but not publish them. These posts can be rejected or approved for publishing by a blog editor or Wix user."
+  ).optional(),
+  media: z.intersection(
+    z.object({
+      displayed: z.boolean().describe("Whether cover media is displayed.").optional(),
+      custom: z.boolean().describe(
+        "Whether custom cover media has been specified. If `false`, the first media item in the post's content serves as cover media."
       ).optional(),
-      moderatedBy: z.string().describe(
-        "Member ID of the person who approved or rejected the post."
-      ).regex(
-        /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
-        "Must be a valid GUID"
-      ).optional().nullable(),
-      moderationDate: z.date().describe("Date the post was approved or rejected.").optional().nullable()
-    }).describe(
-      "Post moderation details. Only relevant to posts submitted by [guest writers](https://support.wix.com/en/article/wix-blog-moderating-blog-posts-from-your-guest-writers).\n\nGuest writers have the ability to write posts but not publish them. These posts can be rejected or approved for publishing by a blog editor or Wix user."
-    ).optional(),
-    media: z.intersection(
+      altText: z.string().describe("Media alternative text.").min(1).max(1e3).optional().nullable()
+    }),
+    z.xor([
       z.object({
-        displayed: z.boolean().describe("Whether cover media is displayed.").optional(),
-        custom: z.boolean().describe(
-          "Whether custom cover media has been specified. If `false`, the first media item in the post's content serves as cover media."
-        ).optional(),
-        altText: z.string().describe("Media alternative text.").min(1).max(1e3).optional().nullable()
+        wixMedia: z.never().optional(),
+        embedMedia: z.never().optional()
       }),
-      z.xor([
-        z.object({
-          wixMedia: z.never().optional(),
-          embedMedia: z.never().optional()
-        }),
-        z.object({
-          embedMedia: z.never().optional(),
-          wixMedia: z.object({
-            image: z.string().describe("Image details.").optional(),
-            videoV2: z.string().describe("Video details.").optional()
-          }).describe("Wix Media details.")
-        }),
-        z.object({
-          wixMedia: z.never().optional(),
-          embedMedia: z.object({
-            thumbnail: z.object({
-              url: z.string().describe("Thumbnail url.").max(2e3).optional(),
-              width: z.number().int().describe("Thumbnail width.").min(0).optional(),
-              height: z.number().int().describe("Thumbnail height.").min(0).optional()
-            }).describe("Thumbnail details.").optional(),
-            video: z.object({
-              url: z.string().describe("Video url.").max(2e3).optional(),
-              width: z.number().int().describe("Video width.").min(0).optional(),
-              height: z.number().int().describe("Video height.").min(0).optional()
-            }).describe("Video details.").optional()
-          }).describe("Embed media details.")
-        })
-      ])
-    ).describe("Post cover media.").optional(),
-    hasUnpublishedChanges: z.boolean().describe(
-      "Indicates if there is a draft post with changes that have not yet been published."
-    ).optional(),
-    referenceId: z.string().describe(
-      "Post reference ID. You can reference the post from other entities, for example, comments."
-    ).max(24).optional().nullable()
-  }).describe("Retrieved post info.").optional()
+      z.object({
+        embedMedia: z.never().optional(),
+        wixMedia: z.object({
+          image: z.string().describe("Image details.").optional(),
+          videoV2: z.string().describe("Video details.").optional()
+        }).describe("Wix Media details.")
+      }),
+      z.object({
+        wixMedia: z.never().optional(),
+        embedMedia: z.object({
+          thumbnail: z.object({
+            url: z.string().describe("Thumbnail url.").max(2e3).optional(),
+            width: z.number().int().describe("Thumbnail width.").min(0).optional(),
+            height: z.number().int().describe("Thumbnail height.").min(0).optional()
+          }).describe("Thumbnail details.").optional(),
+          video: z.object({
+            url: z.string().describe("Video url.").max(2e3).optional(),
+            width: z.number().int().describe("Video width.").min(0).optional(),
+            height: z.number().int().describe("Video height.").min(0).optional()
+          }).describe("Video details.").optional()
+        }).describe("Embed media details.")
+      })
+    ])
+  ).describe("Post cover media.").optional(),
+  hasUnpublishedChanges: z.boolean().describe(
+    "Indicates if there is a draft post with changes that have not yet been published."
+  ).optional(),
+  referenceId: z.string().describe(
+    "Post reference ID. You can reference the post from other entities, for example, comments."
+  ).max(24).optional().nullable()
 });
 var GetPostBySlugRequest = z.object({
   slug: z.string().describe("Slug of the post to retrieve.").min(1).max(200),
@@ -277,7 +271,7 @@ var GetPostBySlugRequest = z.object({
       ])
     ).max(20).optional(),
     language: z.string().describe("Language of the post.").optional().nullable()
-  }).describe("Options specifying which fields to return.").optional()
+  }).optional()
 });
 var GetPostBySlugResponse = z.object({
   post: z.object({
@@ -337,7 +331,7 @@ var GetPostBySlugResponse = z.object({
             "SEO tag inner content. For example, `<title> inner content </title>`."
           ).optional(),
           custom: z.boolean().describe(
-            'Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages).\n\nLimitation: when `ResolveStaticPageSeoTags` is called without `seoData`, the per-page SEO data is read\nonly from the Vibe/Wix-managed-headless override store. That store holds nothing for classic Wix Editor\nor Wix Studio pages, so custom tags saved on those pages are missing from the response entirely. For\nthose pages `false` therefore does not mean "not a custom tag" \u2014 it means this API could not tell.\nPass `seoData` explicitly to resolve against a known set of tags.'
+            "Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages) \u2014\ni.e. an entry from the site's Advanced/Custom Tags list.\n\nThis flag is scoped to that feature only. It is NOT an indicator of whether a standard tag\n(`title`, `description`, Open Graph, etc.) reflects a manually configured value versus a computed\ndefault/pattern \u2014 standard tags always resolve with `custom: false`, even when their content comes\nfrom a page's manually saved SEO title/description override. Don't use this field to verify whether\na live page reflects a manual per-page SEO edit.\n\nLimitation: when `ResolveStaticPageSeoTags` is called without `seoData`, the per-page SEO data is read\nonly from the Vibe/Wix-managed-headless override store. That store holds nothing for classic Wix Editor\nor Wix Studio pages, so even genuine Advanced/Custom Tags saved on those pages are missing from the\nresponse entirely \u2014 there, `false` means this API could not tell, not that no custom tag exists.\nPass `seoData` explicitly to resolve against a known set of tags."
           ).optional(),
           disabled: z.boolean().describe(
             "Whether the tag is disabled. If the tag is disabled, people can't find your page when searching for this phrase in search engines."
@@ -482,7 +476,7 @@ var ListPostsRequest = z.object({
         "REFERENCE_ID"
       ])
     ).max(20).optional()
-  }).describe("Sort, filter, and paging options.").optional()
+  }).optional()
 });
 var ListPostsResponse = z.object({
   posts: z.array(
@@ -543,7 +537,7 @@ var ListPostsResponse = z.object({
               "SEO tag inner content. For example, `<title> inner content </title>`."
             ).optional(),
             custom: z.boolean().describe(
-              'Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages).\n\nLimitation: when `ResolveStaticPageSeoTags` is called without `seoData`, the per-page SEO data is read\nonly from the Vibe/Wix-managed-headless override store. That store holds nothing for classic Wix Editor\nor Wix Studio pages, so custom tags saved on those pages are missing from the response entirely. For\nthose pages `false` therefore does not mean "not a custom tag" \u2014 it means this API could not tell.\nPass `seoData` explicitly to resolve against a known set of tags.'
+              "Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages) \u2014\ni.e. an entry from the site's Advanced/Custom Tags list.\n\nThis flag is scoped to that feature only. It is NOT an indicator of whether a standard tag\n(`title`, `description`, Open Graph, etc.) reflects a manually configured value versus a computed\ndefault/pattern \u2014 standard tags always resolve with `custom: false`, even when their content comes\nfrom a page's manually saved SEO title/description override. Don't use this field to verify whether\na live page reflects a manual per-page SEO edit.\n\nLimitation: when `ResolveStaticPageSeoTags` is called without `seoData`, the per-page SEO data is read\nonly from the Vibe/Wix-managed-headless override store. That store holds nothing for classic Wix Editor\nor Wix Studio pages, so even genuine Advanced/Custom Tags saved on those pages are missing from the\nresponse entirely \u2014 there, `false` means this API could not tell, not that no custom tag exists.\nPass `seoData` explicitly to resolve against a known set of tags."
             ).optional(),
             disabled: z.boolean().describe(
               "Whether the tag is disabled. If the tag is disabled, people can't find your page when searching for this phrase in search engines."
@@ -773,7 +767,7 @@ var QueryPostsRequest = z.object({
         "REFERENCE_ID"
       ])
     ).max(20).optional()
-  }).describe("Options specifying which fields to return.").optional()
+  }).optional()
 });
 var QueryPostsResponse = z.object({
   posts: z.array(
@@ -834,7 +828,7 @@ var QueryPostsResponse = z.object({
               "SEO tag inner content. For example, `<title> inner content </title>`."
             ).optional(),
             custom: z.boolean().describe(
-              'Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages).\n\nLimitation: when `ResolveStaticPageSeoTags` is called without `seoData`, the per-page SEO data is read\nonly from the Vibe/Wix-managed-headless override store. That store holds nothing for classic Wix Editor\nor Wix Studio pages, so custom tags saved on those pages are missing from the response entirely. For\nthose pages `false` therefore does not mean "not a custom tag" \u2014 it means this API could not tell.\nPass `seoData` explicitly to resolve against a known set of tags.'
+              "Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages) \u2014\ni.e. an entry from the site's Advanced/Custom Tags list.\n\nThis flag is scoped to that feature only. It is NOT an indicator of whether a standard tag\n(`title`, `description`, Open Graph, etc.) reflects a manually configured value versus a computed\ndefault/pattern \u2014 standard tags always resolve with `custom: false`, even when their content comes\nfrom a page's manually saved SEO title/description override. Don't use this field to verify whether\na live page reflects a manual per-page SEO edit.\n\nLimitation: when `ResolveStaticPageSeoTags` is called without `seoData`, the per-page SEO data is read\nonly from the Vibe/Wix-managed-headless override store. That store holds nothing for classic Wix Editor\nor Wix Studio pages, so even genuine Advanced/Custom Tags saved on those pages are missing from the\nresponse entirely \u2014 there, `false` means this API could not tell, not that no custom tag exists.\nPass `seoData` explicitly to resolve against a known set of tags."
             ).optional(),
             disabled: z.boolean().describe(
               "Whether the tag is disabled. If the tag is disabled, people can't find your page when searching for this phrase in search engines."