@wix/auto_sdk_blog_posts 1.0.160 → 1.0.161

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/build/cjs/index.d.ts +11 -15
  2. package/build/cjs/index.js +11 -16
  3. package/build/cjs/index.js.map +1 -1
  4. package/build/cjs/index.typings.d.ts +17 -29
  5. package/build/cjs/index.typings.js +6 -6
  6. package/build/cjs/index.typings.js.map +1 -1
  7. package/build/cjs/meta.js.map +1 -1
  8. package/build/cjs/schemas.d.ts +82 -84
  9. package/build/cjs/schemas.js +147 -153
  10. package/build/cjs/schemas.js.map +1 -1
  11. package/build/es/index.d.mts +11 -15
  12. package/build/es/index.mjs +11 -16
  13. package/build/es/index.mjs.map +1 -1
  14. package/build/es/index.typings.d.mts +17 -29
  15. package/build/es/index.typings.mjs +6 -6
  16. package/build/es/index.typings.mjs.map +1 -1
  17. package/build/es/meta.mjs.map +1 -1
  18. package/build/es/schemas.d.mts +82 -84
  19. package/build/es/schemas.mjs +147 -153
  20. package/build/es/schemas.mjs.map +1 -1
  21. package/build/internal/cjs/index.d.ts +11 -15
  22. package/build/internal/cjs/index.js +11 -16
  23. package/build/internal/cjs/index.js.map +1 -1
  24. package/build/internal/cjs/index.typings.d.ts +17 -29
  25. package/build/internal/cjs/index.typings.js +6 -6
  26. package/build/internal/cjs/index.typings.js.map +1 -1
  27. package/build/internal/cjs/meta.js.map +1 -1
  28. package/build/internal/cjs/schemas.d.ts +82 -84
  29. package/build/internal/cjs/schemas.js +147 -153
  30. package/build/internal/cjs/schemas.js.map +1 -1
  31. package/build/internal/es/index.d.mts +11 -15
  32. package/build/internal/es/index.mjs +11 -16
  33. package/build/internal/es/index.mjs.map +1 -1
  34. package/build/internal/es/index.typings.d.mts +17 -29
  35. package/build/internal/es/index.typings.mjs +6 -6
  36. package/build/internal/es/index.typings.mjs.map +1 -1
  37. package/build/internal/es/meta.mjs.map +1 -1
  38. package/build/internal/es/schemas.d.mts +82 -84
  39. package/build/internal/es/schemas.mjs +147 -153
  40. package/build/internal/es/schemas.mjs.map +1 -1
  41. package/package.json +2 -2
@@ -3953,14 +3953,13 @@ declare function onPostUpdated(handler: (event: PostUpdatedEnvelope) => void | P
3953
3953
  /**
3954
3954
  * Retrieves the number of published posts per month within a specified time range.
3955
3955
  *
3956
- *
3957
- * The `queryPostCountStats()` function returns a Promise that resolves to the number of posts per month within the specified time range.
3958
- *
3959
- * 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.
3960
- *
3961
- * >**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.
3956
+ * The time range is set using the `rangeStart` and `months` properties.
3957
+ * The time range always starts on the 1st day of the month set in `rangeStart` and
3958
+ * includes the number of `months` following `rangeStart`.
3959
+ * For example, if `rangeStart` is set to `'2022-03-13'` and `months` is set to `4`,
3960
+ * 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.
3961
+ * > 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.
3962
3962
  * @public
3963
- * @param options - Options specifying time frame, sort, and filter.
3964
3963
  * @permissionId BLOG.READ-PUBLICATION
3965
3964
  * @applicableIdentity APP
3966
3965
  * @returns Get Blog Post Count Stats response
@@ -4001,7 +4000,6 @@ interface QueryPostCountStatsOptions {
4001
4000
  /**
4002
4001
  * Retrieves the total amount of published posts of the blog.
4003
4002
  * @public
4004
- * @param options - Language Options.
4005
4003
  * @permissionId BLOG.READ-PUBLICATION
4006
4004
  * @applicableIdentity APP
4007
4005
  * @fqn com.wixpress.npm.communities.platformized.blog.BlogStatsService.GetTotalPosts
@@ -4022,12 +4020,12 @@ interface GetTotalPostsOptions {
4022
4020
  * @param postId - Post ID.
4023
4021
  * @public
4024
4022
  * @requiredField postId
4025
- * @param options - Options specifying which fields to return.
4026
4023
  * @permissionId BLOG.READ-PUBLICATION
4027
4024
  * @applicableIdentity APP
4025
+ * @returns Retrieved post info.
4028
4026
  * @fqn com.wixpress.npm.communities.platformized.blog.v3.PostService.GetPost
4029
4027
  */
4030
- 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>>;
4028
+ 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>>;
4031
4029
  interface GetPostOptions {
4032
4030
  /**
4033
4031
  * List of additional post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
@@ -4047,7 +4045,6 @@ interface GetPostOptions {
4047
4045
  * @param slug - Slug of the post to retrieve.
4048
4046
  * @public
4049
4047
  * @requiredField slug
4050
- * @param options - Options specifying which fields to return.
4051
4048
  * @permissionId BLOG.READ-PUBLICATION
4052
4049
  * @applicableIdentity APP
4053
4050
  * @fqn com.wixpress.npm.communities.platformized.blog.v3.PostService.GetPostBySlug
@@ -4075,7 +4072,6 @@ interface GetPostBySlugOptions {
4075
4072
  * - `paging.limit` is `50`.
4076
4073
  * - `paging.offset` is `0`.
4077
4074
  * @public
4078
- * @param options - Sort, filter, and paging options.
4079
4075
  * @permissionId BLOG.READ-PUBLICATION
4080
4076
  * @applicableIdentity APP
4081
4077
  * @fqn com.wixpress.npm.communities.platformized.blog.v3.PostService.ListPosts
@@ -4146,26 +4142,18 @@ interface ListPostsOptions {
4146
4142
  fieldsets?: PostFieldFieldWithLiterals[];
4147
4143
  }
4148
4144
  /**
4149
- * Creates a query to retrieve a list of posts.
4150
- *
4151
- *
4152
- * The `queryPosts()` function builds a query to retrieve a list of up to 100 posts, and returns a `PostsQueryBuilder` object.
4153
- *
4154
- * The returned object contains the query definition which is typically used to run the query using the `find()` function.
4145
+ * Retrieves a list of up to 100 posts, given the provided paging, filtering, and sorting.
4155
4146
  *
4156
- * 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.
4157
- *
4158
- * `queryPosts()` runs with these `PostsQueryBuilder` defaults that you can override:
4159
- * + `limit(50)`
4160
- * + `descending('firstPublishedDate')`
4161
- *
4162
- * Note that the default limit is `'50'`, but the max limit is `'100'`.
4163
- *
4164
- * To learn how to query posts, refer to the table below.
4147
+ * Query Posts runs with these defaults, which you can override:
4148
+ * - `firstPublishedDate` is sorted in descending order, with pinned posts first.
4149
+ * - `paging.limit` is `50`.
4150
+ * - `paging.offset` is `0`.
4165
4151
  *
4166
- * 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`.
4152
+ * To learn about working with _Query_ endpoints, see
4153
+ * [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language),
4154
+ * [Sorting and Paging](https://dev.wix.com/api/rest/getting-started/sorting-and-paging), and
4155
+ * [Field Projection](https://dev.wix.com/api/rest/getting-started/field-projection).
4167
4156
  * @public
4168
- * @param options - Options specifying which fields to return.
4169
4157
  * @permissionId BLOG.READ-PUBLICATION
4170
4158
  * @applicableIdentity APP
4171
4159
  * @fqn com.wixpress.npm.communities.platformized.blog.v3.PostService.QueryPosts
@@ -1620,8 +1620,8 @@ async function getPost2(postId, options) {
1620
1620
  paths: [{ path: "post.media.wixMedia.videoV2" }]
1621
1621
  }
1622
1622
  ]),
1623
- ["post.richContent", "post.rich_content"]
1624
- );
1623
+ ["post.richContent"]
1624
+ )?.post;
1625
1625
  } catch (err) {
1626
1626
  const transformedError = (0, import_transform_error.transformError)(
1627
1627
  err,
@@ -1668,7 +1668,7 @@ async function getPostBySlug2(slug, options) {
1668
1668
  paths: [{ path: "post.media.wixMedia.videoV2" }]
1669
1669
  }
1670
1670
  ]),
1671
- ["post.richContent", "post.rich_content"]
1671
+ ["post.richContent"]
1672
1672
  );
1673
1673
  } catch (err) {
1674
1674
  const transformedError = (0, import_transform_error.transformError)(
@@ -1727,7 +1727,7 @@ async function listPosts2(options) {
1727
1727
  paths: [{ path: "posts.media.wixMedia.videoV2" }]
1728
1728
  }
1729
1729
  ]),
1730
- ["posts.richContent", "posts.rich_content"]
1730
+ ["posts.richContent"]
1731
1731
  );
1732
1732
  } catch (err) {
1733
1733
  const transformedError = (0, import_transform_error.transformError)(
@@ -1797,7 +1797,7 @@ function queryPosts2(options) {
1797
1797
  paths: [{ path: "posts.media.wixMedia.videoV2" }]
1798
1798
  }
1799
1799
  ]),
1800
- ["posts.richContent", "posts.rich_content"]
1800
+ ["posts.richContent"]
1801
1801
  );
1802
1802
  return {
1803
1803
  items: transformedData?.posts,
@@ -1845,7 +1845,7 @@ async function typedQueryPosts(query, options) {
1845
1845
  paths: [{ path: "posts.media.wixMedia.videoV2" }]
1846
1846
  }
1847
1847
  ]),
1848
- ["posts.richContent", "posts.rich_content"]
1848
+ ["posts.richContent"]
1849
1849
  );
1850
1850
  } catch (err) {
1851
1851
  const transformedError = (0, import_transform_error.transformError)(