@wix/auto_sdk_blog_posts 1.0.174 → 1.0.175

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
@@ -4354,14 +4354,13 @@ declare function onPostUpdated(handler: (event: PostUpdatedEnvelope) => void | P
4354
4354
  /**
4355
4355
  * Retrieves the number of published posts per month within a specified time range.
4356
4356
  *
4357
- *
4358
- * The `queryPostCountStats()` function returns a Promise that resolves to the number of posts per month within the specified time range.
4359
- *
4360
- * 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.
4361
- *
4362
- * >**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.
4357
+ * The time range is set using the `rangeStart` and `months` properties.
4358
+ * The time range always starts on the 1st day of the month set in `rangeStart` and
4359
+ * includes the number of `months` following `rangeStart`.
4360
+ * For example, if `rangeStart` is set to `'2022-03-13'` and `months` is set to `4`,
4361
+ * 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.
4362
+ * > 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.
4363
4363
  * @public
4364
- * @param options - Options specifying time frame, sort, and filter.
4365
4364
  * @permissionId BLOG.READ-PUBLICATION
4366
4365
  * @applicableIdentity APP
4367
4366
  * @returns Get Blog Post Count Stats response
@@ -4402,7 +4401,6 @@ interface QueryPostCountStatsOptions {
4402
4401
  /**
4403
4402
  * Retrieves the total amount of published posts of the blog.
4404
4403
  * @public
4405
- * @param options - Language Options.
4406
4404
  * @permissionId BLOG.READ-PUBLICATION
4407
4405
  * @applicableIdentity APP
4408
4406
  * @fqn com.wixpress.npm.communities.platformized.blog.BlogStatsService.GetTotalPosts
@@ -4423,12 +4421,12 @@ interface GetTotalPostsOptions {
4423
4421
  * @param postId - Post ID.
4424
4422
  * @public
4425
4423
  * @requiredField postId
4426
- * @param options - Options specifying which fields to return.
4427
4424
  * @permissionId BLOG.READ-PUBLICATION
4428
4425
  * @applicableIdentity APP
4426
+ * @returns Retrieved post info.
4429
4427
  * @fqn com.wixpress.npm.communities.platformized.blog.v3.PostService.GetPost
4430
4428
  */
4431
- 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>>;
4429
+ 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>>;
4432
4430
  interface GetPostOptions {
4433
4431
  /**
4434
4432
  * List of additional post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
@@ -4448,7 +4446,6 @@ interface GetPostOptions {
4448
4446
  * @param slug - Slug of the post to retrieve.
4449
4447
  * @public
4450
4448
  * @requiredField slug
4451
- * @param options - Options specifying which fields to return.
4452
4449
  * @permissionId BLOG.READ-PUBLICATION
4453
4450
  * @applicableIdentity APP
4454
4451
  * @fqn com.wixpress.npm.communities.platformized.blog.v3.PostService.GetPostBySlug
@@ -4476,7 +4473,6 @@ interface GetPostBySlugOptions {
4476
4473
  * - `paging.limit` is `50`.
4477
4474
  * - `paging.offset` is `0`.
4478
4475
  * @public
4479
- * @param options - Sort, filter, and paging options.
4480
4476
  * @permissionId BLOG.READ-PUBLICATION
4481
4477
  * @applicableIdentity APP
4482
4478
  * @fqn com.wixpress.npm.communities.platformized.blog.v3.PostService.ListPosts
@@ -4547,26 +4543,18 @@ interface ListPostsOptions {
4547
4543
  fieldsets?: PostFieldFieldWithLiterals[];
4548
4544
  }
4549
4545
  /**
4550
- * Creates a query to retrieve a list of posts.
4551
- *
4552
- *
4553
- * The `queryPosts()` function builds a query to retrieve a list of up to 100 posts, and returns a `PostsQueryBuilder` object.
4554
- *
4555
- * The returned object contains the query definition which is typically used to run the query using the `find()` function.
4546
+ * Retrieves a list of up to 100 posts, given the provided paging, filtering, and sorting.
4556
4547
  *
4557
- * 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.
4558
- *
4559
- * `queryPosts()` runs with these `PostsQueryBuilder` defaults that you can override:
4560
- * + `limit(50)`
4561
- * + `descending('firstPublishedDate')`
4562
- *
4563
- * Note that the default limit is `'50'`, but the max limit is `'100'`.
4564
- *
4565
- * To learn how to query posts, refer to the table below.
4548
+ * Query Posts runs with these defaults, which you can override:
4549
+ * - `firstPublishedDate` is sorted in descending order, with pinned posts first.
4550
+ * - `paging.limit` is `50`.
4551
+ * - `paging.offset` is `0`.
4566
4552
  *
4567
- * 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`.
4553
+ * To learn about working with _Query_ endpoints, see
4554
+ * [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language),
4555
+ * [Sorting and Paging](https://dev.wix.com/api/rest/getting-started/sorting-and-paging), and
4556
+ * [Field Projection](https://dev.wix.com/api/rest/getting-started/field-projection).
4568
4557
  * @public
4569
- * @param options - Options specifying which fields to return.
4570
4558
  * @permissionId BLOG.READ-PUBLICATION
4571
4559
  * @applicableIdentity APP
4572
4560
  * @fqn com.wixpress.npm.communities.platformized.blog.v3.PostService.QueryPosts
@@ -1766,8 +1766,8 @@ async function getPost2(postId, options) {
1766
1766
  paths: [{ path: "post.media.wixMedia.videoV2" }]
1767
1767
  }
1768
1768
  ]),
1769
- ["post.richContent", "post.rich_content"]
1770
- );
1769
+ ["post.richContent"]
1770
+ )?.post;
1771
1771
  } catch (err) {
1772
1772
  const transformedError = sdkTransformError(
1773
1773
  err,
@@ -1814,7 +1814,7 @@ async function getPostBySlug2(slug, options) {
1814
1814
  paths: [{ path: "post.media.wixMedia.videoV2" }]
1815
1815
  }
1816
1816
  ]),
1817
- ["post.richContent", "post.rich_content"]
1817
+ ["post.richContent"]
1818
1818
  );
1819
1819
  } catch (err) {
1820
1820
  const transformedError = sdkTransformError(
@@ -1873,7 +1873,7 @@ async function listPosts2(options) {
1873
1873
  paths: [{ path: "posts.media.wixMedia.videoV2" }]
1874
1874
  }
1875
1875
  ]),
1876
- ["posts.richContent", "posts.rich_content"]
1876
+ ["posts.richContent"]
1877
1877
  );
1878
1878
  } catch (err) {
1879
1879
  const transformedError = sdkTransformError(
@@ -1943,7 +1943,7 @@ function queryPosts2(options) {
1943
1943
  paths: [{ path: "posts.media.wixMedia.videoV2" }]
1944
1944
  }
1945
1945
  ]),
1946
- ["posts.richContent", "posts.rich_content"]
1946
+ ["posts.richContent"]
1947
1947
  );
1948
1948
  return {
1949
1949
  items: transformedData?.posts,
@@ -1991,7 +1991,7 @@ async function typedQueryPosts(query, options) {
1991
1991
  paths: [{ path: "posts.media.wixMedia.videoV2" }]
1992
1992
  }
1993
1993
  ]),
1994
- ["posts.richContent", "posts.rich_content"]
1994
+ ["posts.richContent"]
1995
1995
  );
1996
1996
  } catch (err) {
1997
1997
  const transformedError = sdkTransformError(