@wix/auto_sdk_blog_posts 1.0.175 → 1.0.177

package/build/internal/cjs/schemas.d.ts

@@ -43,89 +43,91 @@ declare const GetPostRequest: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const GetPostResponse: 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>;
-        }, 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>>;
+    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>;
             }, 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;
@@ -464,11 +466,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/internal/cjs/schemas.js

@@ -62,7 +62,7 @@ var QueryPostCountStatsRequest = /* @__PURE__ */ 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()
-  }).optional()
+  }).describe("Options specifying time frame, sort, and filter. ").optional()
 });
 var QueryPostCountStatsResponse = /* @__PURE__ */ z.object({
   stats: z.array(
@@ -79,7 +79,7 @@ var GetTotalPostsRequest = /* @__PURE__ */ 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()
-  }).optional()
+  }).describe("Language Options.").optional()
 });
 var GetTotalPostsResponse = /* @__PURE__ */ z.object({
   total: z.number().int().describe("Total amount of published posts.").min(0).optional()
@@ -99,161 +99,167 @@ var GetPostRequest = /* @__PURE__ */ z.object({
         "REFERENCE_ID"
       ])
     ).max(20).optional()
-  }).optional()
+  }).describe("Options specifying which fields to return.").optional()
 });
 var GetPostResponse = /* @__PURE__ */ 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."
-  ).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()
-      })
+  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(),
-    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."
-  ).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(
+    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(),
-    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."
+    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(),
-    moderatedBy: z.string().describe("Member ID of the person who approved or rejected the post.").regex(
+    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(),
-    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."
+    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`.\n\nWhich of these an API actually accepts depends on where the tag is being set: this\nlist is not a blanket guarantee across every API that reuses this message. Site SEO\nTags in particular accepts only `meta` (see `SiteSeoTags.tags`) and rejects\n`title`/`script`/`link` with a validation error even though they appear here \u2014\ncheck the field description of the specific `tags`-typed field you're writing to\nfor the types it actually supports and the error it returns.\n\nLimitation: `title` and `script` (e.g. a `script` tag with `props.type`\n`\"application/ld+json\"` carrying structured data) are supported only when\n`custom` is unset or `false`. Setting `custom: true` on a `title` or `script`\ntag is rejected with `TAG_TYPE_NOT_ALLOWED`, because `custom: true` routes the\nwrite through the site's Advanced/Custom Tags list. To write structured data,\nomit `custom` (or set it to `false`)."
+          ).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\nSetting this to `true` on a write restricts which `type` values are accepted\n\u2014 the same restriction the Advanced/Custom Tags UI enforces. `title` and\n`script` tags (including JSON-LD structured data) must be sent with `custom`\nomitted or `false`; sending them with `custom: true` is rejected with\n`TAG_TYPE_NOT_ALLOWED`.\n\nNote this is a separate restriction from Site SEO Tags' own type restriction on\n`SiteSeoTags.tags`: even with `custom` unset, Site SEO Tags rejects `script` (e.g.\nfor site-wide structured data) unconditionally. There is currently no way to set\nsite-wide, every-page structured data through any of these APIs \u2014 write a per-page\n`script` tag through the Item SEO Tags API instead.\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(),
-      altText: z.string().describe("Media alternative text.").min(1).max(1e3).optional().nullable()
-    }),
-    z.xor([
-      z.object({
-        wixMedia: z.never().optional(),
-        embedMedia: z.never().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."
+    ).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(),
+      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(),
+      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({
-        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.")
+        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()
       }),
-      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()
+      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()
 });
 var GetPostBySlugRequest = /* @__PURE__ */ z.object({
   slug: z.string().describe("Slug of the post to retrieve.").min(1).max(200),
@@ -271,7 +277,7 @@ var GetPostBySlugRequest = /* @__PURE__ */ z.object({
       ])
     ).max(20).optional(),
     language: z.string().describe("Language of the post.").optional().nullable()
-  }).optional()
+  }).describe("Options specifying which fields to return.").optional()
 });
 var GetPostBySlugResponse = /* @__PURE__ */ z.object({
   post: z.object({
@@ -319,7 +325,7 @@ var GetPostBySlugResponse = /* @__PURE__ */ z.object({
       tags: z.array(
         z.object({
           type: z.string().describe(
-            "SEO tag type.\n\n\nSupported values: `title`, `meta`, `script`, `link`."
+            "SEO tag type.\n\n\nSupported values: `title`, `meta`, `script`, `link`.\n\nWhich of these an API actually accepts depends on where the tag is being set: this\nlist is not a blanket guarantee across every API that reuses this message. Site SEO\nTags in particular accepts only `meta` (see `SiteSeoTags.tags`) and rejects\n`title`/`script`/`link` with a validation error even though they appear here \u2014\ncheck the field description of the specific `tags`-typed field you're writing to\nfor the types it actually supports and the error it returns.\n\nLimitation: `title` and `script` (e.g. a `script` tag with `props.type`\n`\"application/ld+json\"` carrying structured data) are supported only when\n`custom` is unset or `false`. Setting `custom: true` on a `title` or `script`\ntag is rejected with `TAG_TYPE_NOT_ALLOWED`, because `custom: true` routes the\nwrite through the site's Advanced/Custom Tags list. To write structured data,\nomit `custom` (or set it to `false`)."
           ).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"}`.'
@@ -331,7 +337,7 @@ var GetPostBySlugResponse = /* @__PURE__ */ 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) \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."
+            "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\nSetting this to `true` on a write restricts which `type` values are accepted\n\u2014 the same restriction the Advanced/Custom Tags UI enforces. `title` and\n`script` tags (including JSON-LD structured data) must be sent with `custom`\nomitted or `false`; sending them with `custom: true` is rejected with\n`TAG_TYPE_NOT_ALLOWED`.\n\nNote this is a separate restriction from Site SEO Tags' own type restriction on\n`SiteSeoTags.tags`: even with `custom` unset, Site SEO Tags rejects `script` (e.g.\nfor site-wide structured data) unconditionally. There is currently no way to set\nsite-wide, every-page structured data through any of these APIs \u2014 write a per-page\n`script` tag through the Item SEO Tags API instead.\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."
@@ -476,7 +482,7 @@ var ListPostsRequest = /* @__PURE__ */ z.object({
         "REFERENCE_ID"
       ])
     ).max(20).optional()
-  }).optional()
+  }).describe("Sort, filter, and paging options.").optional()
 });
 var ListPostsResponse = /* @__PURE__ */ z.object({
   posts: z.array(
@@ -525,7 +531,7 @@ var ListPostsResponse = /* @__PURE__ */ z.object({
         tags: z.array(
           z.object({
             type: z.string().describe(
-              "SEO tag type.\n\n\nSupported values: `title`, `meta`, `script`, `link`."
+              "SEO tag type.\n\n\nSupported values: `title`, `meta`, `script`, `link`.\n\nWhich of these an API actually accepts depends on where the tag is being set: this\nlist is not a blanket guarantee across every API that reuses this message. Site SEO\nTags in particular accepts only `meta` (see `SiteSeoTags.tags`) and rejects\n`title`/`script`/`link` with a validation error even though they appear here \u2014\ncheck the field description of the specific `tags`-typed field you're writing to\nfor the types it actually supports and the error it returns.\n\nLimitation: `title` and `script` (e.g. a `script` tag with `props.type`\n`\"application/ld+json\"` carrying structured data) are supported only when\n`custom` is unset or `false`. Setting `custom: true` on a `title` or `script`\ntag is rejected with `TAG_TYPE_NOT_ALLOWED`, because `custom: true` routes the\nwrite through the site's Advanced/Custom Tags list. To write structured data,\nomit `custom` (or set it to `false`)."
             ).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"}`.'
@@ -537,7 +543,7 @@ var ListPostsResponse = /* @__PURE__ */ 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) \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."
+              "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\nSetting this to `true` on a write restricts which `type` values are accepted\n\u2014 the same restriction the Advanced/Custom Tags UI enforces. `title` and\n`script` tags (including JSON-LD structured data) must be sent with `custom`\nomitted or `false`; sending them with `custom: true` is rejected with\n`TAG_TYPE_NOT_ALLOWED`.\n\nNote this is a separate restriction from Site SEO Tags' own type restriction on\n`SiteSeoTags.tags`: even with `custom` unset, Site SEO Tags rejects `script` (e.g.\nfor site-wide structured data) unconditionally. There is currently no way to set\nsite-wide, every-page structured data through any of these APIs \u2014 write a per-page\n`script` tag through the Item SEO Tags API instead.\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."
@@ -767,7 +773,7 @@ var QueryPostsRequest = /* @__PURE__ */ z.object({
         "REFERENCE_ID"
       ])
     ).max(20).optional()
-  }).optional()
+  }).describe("Options specifying which fields to return.").optional()
 });
 var QueryPostsResponse = /* @__PURE__ */ z.object({
   posts: z.array(
@@ -816,7 +822,7 @@ var QueryPostsResponse = /* @__PURE__ */ z.object({
         tags: z.array(
           z.object({
             type: z.string().describe(
-              "SEO tag type.\n\n\nSupported values: `title`, `meta`, `script`, `link`."
+              "SEO tag type.\n\n\nSupported values: `title`, `meta`, `script`, `link`.\n\nWhich of these an API actually accepts depends on where the tag is being set: this\nlist is not a blanket guarantee across every API that reuses this message. Site SEO\nTags in particular accepts only `meta` (see `SiteSeoTags.tags`) and rejects\n`title`/`script`/`link` with a validation error even though they appear here \u2014\ncheck the field description of the specific `tags`-typed field you're writing to\nfor the types it actually supports and the error it returns.\n\nLimitation: `title` and `script` (e.g. a `script` tag with `props.type`\n`\"application/ld+json\"` carrying structured data) are supported only when\n`custom` is unset or `false`. Setting `custom: true` on a `title` or `script`\ntag is rejected with `TAG_TYPE_NOT_ALLOWED`, because `custom: true` routes the\nwrite through the site's Advanced/Custom Tags list. To write structured data,\nomit `custom` (or set it to `false`)."
             ).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"}`.'
@@ -828,7 +834,7 @@ var QueryPostsResponse = /* @__PURE__ */ 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) \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."
+              "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\nSetting this to `true` on a write restricts which `type` values are accepted\n\u2014 the same restriction the Advanced/Custom Tags UI enforces. `title` and\n`script` tags (including JSON-LD structured data) must be sent with `custom`\nomitted or `false`; sending them with `custom: true` is rejected with\n`TAG_TYPE_NOT_ALLOWED`.\n\nNote this is a separate restriction from Site SEO Tags' own type restriction on\n`SiteSeoTags.tags`: even with `custom` unset, Site SEO Tags rejects `script` (e.g.\nfor site-wide structured data) unconditionally. There is currently no way to set\nsite-wide, every-page structured data through any of these APIs \u2014 write a per-page\n`script` tag through the Item SEO Tags API instead.\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."