@wix/auto_sdk_blog_posts 1.0.167 → 1.0.169

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 (47) hide show
  1. package/build/cjs/index.d.ts +11 -15
  2. package/build/cjs/index.js +24 -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 +19 -6
  6. package/build/cjs/index.typings.js.map +1 -1
  7. package/build/cjs/meta.js +13 -0
  8. package/build/cjs/meta.js.map +1 -1
  9. package/build/cjs/schemas.d.ts +82 -84
  10. package/build/cjs/schemas.js +147 -153
  11. package/build/cjs/schemas.js.map +1 -1
  12. package/build/es/index.d.mts +11 -15
  13. package/build/es/index.mjs +24 -16
  14. package/build/es/index.mjs.map +1 -1
  15. package/build/es/index.typings.d.mts +17 -29
  16. package/build/es/index.typings.mjs +19 -6
  17. package/build/es/index.typings.mjs.map +1 -1
  18. package/build/es/meta.mjs +13 -0
  19. package/build/es/meta.mjs.map +1 -1
  20. package/build/es/schemas.d.mts +82 -84
  21. package/build/es/schemas.mjs +147 -153
  22. package/build/es/schemas.mjs.map +1 -1
  23. package/build/internal/cjs/index.d.ts +11 -15
  24. package/build/internal/cjs/index.js +24 -16
  25. package/build/internal/cjs/index.js.map +1 -1
  26. package/build/internal/cjs/index.typings.d.ts +486 -31
  27. package/build/internal/cjs/index.typings.js +19 -6
  28. package/build/internal/cjs/index.typings.js.map +1 -1
  29. package/build/internal/cjs/meta.d.ts +518 -2
  30. package/build/internal/cjs/meta.js +13 -0
  31. package/build/internal/cjs/meta.js.map +1 -1
  32. package/build/internal/cjs/schemas.d.ts +82 -84
  33. package/build/internal/cjs/schemas.js +147 -153
  34. package/build/internal/cjs/schemas.js.map +1 -1
  35. package/build/internal/es/index.d.mts +11 -15
  36. package/build/internal/es/index.mjs +24 -16
  37. package/build/internal/es/index.mjs.map +1 -1
  38. package/build/internal/es/index.typings.d.mts +486 -31
  39. package/build/internal/es/index.typings.mjs +19 -6
  40. package/build/internal/es/index.typings.mjs.map +1 -1
  41. package/build/internal/es/meta.d.mts +518 -2
  42. package/build/internal/es/meta.mjs +13 -0
  43. package/build/internal/es/meta.mjs.map +1 -1
  44. package/build/internal/es/schemas.d.mts +82 -84
  45. package/build/internal/es/schemas.mjs +147 -153
  46. package/build/internal/es/schemas.mjs.map +1 -1
  47. package/package.json +4 -4
@@ -65,6 +65,14 @@ interface Post {
65
65
  hashtags?: string[];
66
66
  /** Whether commenting on the post is enabled. */
67
67
  commentingEnabled?: boolean;
68
+ /**
69
+ * Dynamic post count info Comment Count, Like Count, View Count.
70
+ * @internal
71
+ * @deprecated Dynamic post count info Comment Count, Like Count, View Count.
72
+ * @replacedBy metrics
73
+ * @targetRemovalDate 2024-06-30
74
+ */
75
+ postCountInfo?: PostCountInfo;
68
76
  /** Estimated reading time (calculated automatically). */
69
77
  minutesToRead?: number;
70
78
  /** Image placed at the top of the blog page. Only displays on mobile devices. */
@@ -104,8 +112,22 @@ interface Post {
104
112
  * @format LANGUAGE_TAG
105
113
  */
106
114
  language?: string | null;
115
+ /**
116
+ * Post metrics.
117
+ * Deprecated on '2022-02-15', data can be inconsistent, for consistent data please use 'PostService#GetPostMetrics' API instead
118
+ * @internal
119
+ * @deprecated
120
+ */
121
+ metrics?: Metrics;
107
122
  /** SEO data. */
108
123
  seoData?: SeoSchema;
124
+ /**
125
+ * Reserved for internal use.
126
+ * @internal
127
+ * @readonly
128
+ * @maxLength 400000
129
+ */
130
+ content?: string | null;
109
131
  /**
110
132
  * Contact ID of the post's owner. See the Contacts API for more info.
111
133
  * @format GUID
@@ -126,6 +148,19 @@ interface Post {
126
148
  * @readonly
127
149
  */
128
150
  preview?: boolean;
151
+ /**
152
+ * Reserved for internal use.
153
+ * @internal
154
+ * @maxLength 24
155
+ */
156
+ contentId?: string | null;
157
+ /**
158
+ * Reserved for internal use.
159
+ * @internal
160
+ * @readonly
161
+ * @format GUID
162
+ */
163
+ mostRecentContributorId?: string | null;
129
164
  /**
130
165
  * 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).
131
166
  *
@@ -135,17 +170,75 @@ interface Post {
135
170
  moderationDetails?: ModerationDetails;
136
171
  /** Post cover media. */
137
172
  media?: Media;
173
+ /**
174
+ * Post rich content as a string.
175
+ * @internal
176
+ * @readonly
177
+ * @maxLength 8000000
178
+ */
179
+ richContentString?: string | null;
180
+ /**
181
+ * Post rich content as compressed binary data
182
+ * @internal
183
+ * @readonly
184
+ */
185
+ richContentCompressed?: Uint8Array | null;
138
186
  /**
139
187
  * Indicates if there is a draft post with changes that have not yet been published.
140
188
  * @readonly
141
189
  */
142
190
  hasUnpublishedChanges?: boolean;
191
+ /**
192
+ * List of the post's translated posts.
193
+ * @internal
194
+ * @readonly
195
+ * @maxSize 1000
196
+ */
197
+ translations?: PostTranslation[];
198
+ /**
199
+ * Identifies whether excerpt was set by contributor.
200
+ * True - excerpt was set by contributor.
201
+ * False - excerpt was generated from content.
202
+ * @internal
203
+ * @readonly
204
+ */
205
+ customExcerpt?: boolean;
143
206
  /**
144
207
  * Post reference ID. You can reference the post from other entities, for example, comments.
145
208
  * @readonly
146
209
  * @maxLength 24
147
210
  */
148
211
  referenceId?: string | null;
212
+ /**
213
+ * Reserved for internal use.
214
+ * @internal
215
+ * @readonly
216
+ * @maxLength 24
217
+ */
218
+ internalId?: string | null;
219
+ /**
220
+ * Reserved for internal use.
221
+ * @internal
222
+ * @readonly
223
+ * @maxSize 10
224
+ * @maxLength 24
225
+ */
226
+ internalCategoryIds?: string[];
227
+ /**
228
+ * Reserved for internal use.
229
+ * @internal
230
+ * @readonly
231
+ * @maxSize 3
232
+ * @maxLength 24
233
+ */
234
+ internalRelatedPostIds?: string[];
235
+ /**
236
+ * Identifies if post is created from template
237
+ * Reserved for internal use.
238
+ * @internal
239
+ * @readonly
240
+ */
241
+ isDemo?: boolean | null;
149
242
  }
150
243
  interface PageUrl {
151
244
  /** The base URL. For premium sites, this is the domain. For free sites, this is the site URL. For example, `mysite.wixsite.com/mysite`. */
@@ -187,11 +280,29 @@ interface Image {
187
280
  width?: number;
188
281
  /** Image alt text. */
189
282
  altText?: string | null;
283
+ /**
284
+ * Image URL expiration date (when relevant).
285
+ * @internal
286
+ * @readonly
287
+ */
288
+ urlExpirationDate?: Date | null;
190
289
  /**
191
290
  * Image filename.
192
291
  * @readonly
193
292
  */
194
293
  filename?: string | null;
294
+ /**
295
+ * Image size in bytes.
296
+ * @internal
297
+ * @readonly
298
+ * @format DECIMAL_VALUE
299
+ */
300
+ sizeInBytes?: string | null;
301
+ /**
302
+ * Focal point of the image.
303
+ * @internal
304
+ */
305
+ focalPoint?: FocalPoint;
195
306
  }
196
307
  interface FocalPoint {
197
308
  /** X-coordinate of the focal point. */
@@ -219,6 +330,18 @@ interface Metrics {
219
330
  * @readonly
220
331
  */
221
332
  views?: number;
333
+ /**
334
+ * Total number of post ratings.
335
+ * @internal
336
+ * @readonly
337
+ */
338
+ totalRatings?: number;
339
+ /**
340
+ * Average rating of post from 1 to 5.
341
+ * @internal
342
+ * @readonly
343
+ */
344
+ averageRating?: number;
222
345
  }
223
346
  /**
224
347
  * The SEO schema object contains data about different types of meta tags. It makes sure that the information about your page is presented properly to search engines.
@@ -2928,6 +3051,11 @@ interface WixMedia {
2928
3051
  interface VideoV2 {
2929
3052
  /** WixMedia ID. */
2930
3053
  id?: string;
3054
+ /**
3055
+ * Original video URL.
3056
+ * @internal
3057
+ */
3058
+ url?: string;
2931
3059
  /**
2932
3060
  * Available resolutions for the video, starting with the optimal resolution.
2933
3061
  * @readonly
@@ -2939,6 +3067,55 @@ interface VideoV2 {
2939
3067
  * @readonly
2940
3068
  */
2941
3069
  filename?: string | null;
3070
+ /**
3071
+ * Video posters.
3072
+ * @internal
3073
+ * @readonly
3074
+ */
3075
+ posters?: Image[];
3076
+ /**
3077
+ * Original video size in bytes.
3078
+ * @internal
3079
+ * @readonly
3080
+ * @format DECIMAL_VALUE
3081
+ */
3082
+ sizeInBytes?: string | null;
3083
+ /**
3084
+ * Video URL expiration date (when relevant).
3085
+ * @internal
3086
+ * @readonly
3087
+ */
3088
+ urlExpirationDate?: Date | null;
3089
+ /**
3090
+ * Original video duration in milliseconds.
3091
+ * @internal
3092
+ * @readonly
3093
+ */
3094
+ durationInMilliseconds?: number | null;
3095
+ /**
3096
+ * A short title for the video. will be used for SEO purposes.
3097
+ * @internal
3098
+ * @maxLength 300
3099
+ */
3100
+ title?: string | null;
3101
+ /**
3102
+ * A long description for the video. will be used for SEO purposes.
3103
+ * @internal
3104
+ * @maxLength 2000
3105
+ */
3106
+ description?: string | null;
3107
+ /**
3108
+ * Original video height.
3109
+ * @internal
3110
+ * @readonly
3111
+ */
3112
+ height?: number | null;
3113
+ /**
3114
+ * Original video width.
3115
+ * @internal
3116
+ * @readonly
3117
+ */
3118
+ width?: number | null;
2942
3119
  }
2943
3120
  interface VideoResolution {
2944
3121
  /** Video URL. */
@@ -2947,8 +3124,68 @@ interface VideoResolution {
2947
3124
  height?: number;
2948
3125
  /** Video width. */
2949
3126
  width?: number;
3127
+ /**
3128
+ * Deprecated. Use the `posters` property in the parent entity instead.
3129
+ * @internal
3130
+ * @deprecated
3131
+ */
3132
+ poster?: Image;
2950
3133
  /** Video format for example, mp4, hls. */
2951
3134
  format?: string;
3135
+ /**
3136
+ * Deprecated. Use the `urlExpirationDate` property in the parent entity instead.
3137
+ * @internal
3138
+ * @deprecated
3139
+ */
3140
+ urlExpirationDate?: Date | null;
3141
+ /**
3142
+ * Deprecated. Use the `sizeInBytes` property in the parent entity instead. Size cannot be provided per resolution.
3143
+ * @internal
3144
+ * @format DECIMAL_VALUE
3145
+ * @deprecated
3146
+ */
3147
+ sizeInBytes?: string | null;
3148
+ /**
3149
+ * Video quality. For example: 480p, 720p.
3150
+ * @internal
3151
+ */
3152
+ quality?: string | null;
3153
+ /**
3154
+ * Video filename.
3155
+ * @internal
3156
+ */
3157
+ filename?: string | null;
3158
+ /**
3159
+ * Video duration in seconds.
3160
+ * @internal
3161
+ * @readonly
3162
+ * @deprecated Video duration in seconds.
3163
+ * @replacedBy duration_in_milliseconds
3164
+ * @targetRemovalDate 2024-08-01
3165
+ */
3166
+ durationInSeconds?: number | null;
3167
+ /**
3168
+ * Video duration in milliseconds.
3169
+ * @internal
3170
+ * @readonly
3171
+ */
3172
+ durationInMilliseconds?: number | null;
3173
+ /**
3174
+ * When true, this is a protected asset, and calling the URL will return a 403 error.
3175
+ * In order to access private assets, make a request to:
3176
+ * `GenerateFileDownloadUrl` with the WixMedia id and specify the asset_key in the request
3177
+ * @internal
3178
+ * @readonly
3179
+ */
3180
+ private?: boolean | null;
3181
+ /**
3182
+ * Key to identify the video resolution's relationship to the original media in WixMedia.
3183
+ * Can be used to request a download for the specific video resolution.
3184
+ * For example: 480p.mp4, 720p.mp4, 1080p.mp4, trailer-720p.mp4, clip-720p.mp4
3185
+ * @internal
3186
+ * @readonly
3187
+ */
3188
+ assetKey?: string | null;
2952
3189
  }
2953
3190
  interface EmbedMedia {
2954
3191
  /** Thumbnail details. */
@@ -3162,8 +3399,18 @@ interface DomainEventBodyOneOf {
3162
3399
  }
3163
3400
  interface EntityCreatedEvent {
3164
3401
  entityAsJson?: string;
3402
+ /**
3403
+ * Indicates the event was triggered by a restore-from-trashbin operation for a previously deleted entity
3404
+ * @internal
3405
+ */
3406
+ triggeredByUndelete?: boolean | null;
3165
3407
  /** Indicates the event was triggered by a restore-from-trashbin operation for a previously deleted entity */
3166
3408
  restoreInfo?: RestoreInfo;
3409
+ /**
3410
+ * Optional domain-specific metadata defined by the API owner, encoded as JSON.
3411
+ * @internal
3412
+ */
3413
+ additionalMetadataAsJson?: string | null;
3167
3414
  }
3168
3415
  interface RestoreInfo {
3169
3416
  deletedDate?: Date | null;
@@ -3175,10 +3422,42 @@ interface EntityUpdatedEvent {
3175
3422
  * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
3176
3423
  */
3177
3424
  currentEntityAsJson?: string;
3425
+ /**
3426
+ * This field is currently part of the of the EntityUpdatedEvent msg, but scala/node libraries which implements the domain events standard
3427
+ * wont populate it / have any reference to it in the API.
3428
+ * The main reason for it is that fetching the old entity from the DB will have a performance hit on an update operation so unless truly needed,
3429
+ * the developer should send only the new (current) entity.
3430
+ * An additional reason is not wanting to send this additional entity over the wire (kafka) since in some cases it can be really big
3431
+ * Developers that must reflect the old entity will have to implement their own domain event sender mechanism which will follow the DomainEvent proto message.
3432
+ * @internal
3433
+ * @deprecated
3434
+ */
3435
+ previousEntityAsJson?: string | null;
3436
+ /**
3437
+ * Map of fully qualified field paths to their previous values for fields that changed.
3438
+ * For more details please see [AIP](https://dev.wix.com/docs/rnd-general/articles/p13n-guidelines-aips/guidance-aips/design-patterns/7016-events#modified-fields-format)
3439
+ * @internal
3440
+ */
3441
+ modifiedFields?: Record<string, any>;
3442
+ /**
3443
+ * Optional domain-specific metadata defined by the API owner, encoded as JSON.
3444
+ * @internal
3445
+ */
3446
+ additionalMetadataAsJson?: string | null;
3178
3447
  }
3179
3448
  interface EntityDeletedEvent {
3449
+ /**
3450
+ * Indicates if the entity is sent to trash-bin. only available when trash-bin is enabled
3451
+ * @internal
3452
+ */
3453
+ movedToTrash?: boolean | null;
3180
3454
  /** Entity that was deleted. */
3181
3455
  deletedEntityAsJson?: string | null;
3456
+ /**
3457
+ * Optional domain-specific metadata defined by the API owner, encoded as JSON.
3458
+ * @internal
3459
+ */
3460
+ additionalMetadataAsJson?: string | null;
3182
3461
  }
3183
3462
  interface ActionEvent {
3184
3463
  bodyAsJson?: string;
@@ -3321,6 +3600,20 @@ interface PeriodPublicationsCount {
3321
3600
  interface QueryPostCountStatsRequest {
3322
3601
  /** Start of time range to return, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time format. */
3323
3602
  rangeStart?: Date | null;
3603
+ /**
3604
+ * __Deprecated.__ Use `months` instead.
3605
+ * This property will be removed on June 30, 2023.
3606
+ *
3607
+ * Non-inclusive end of time range to return, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time format.
3608
+ * @internal
3609
+ * @deprecated __Deprecated.__ Use `months` instead.
3610
+ * This property will be removed on June 30, 2023.
3611
+ *
3612
+ * Non-inclusive end of time range to return, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time format.
3613
+ * @replacedBy months
3614
+ * @targetRemovalDate 2024-06-30
3615
+ */
3616
+ rangeEnd?: Date | null;
3324
3617
  /**
3325
3618
  * Order of returned results.
3326
3619
  *
@@ -3410,6 +3703,12 @@ interface PostCountersUpdated extends PostCountersUpdatedInitiatorOneOf {
3410
3703
  * @format GUID
3411
3704
  */
3412
3705
  postId?: string;
3706
+ /**
3707
+ * Internal ID of the post which counters were updated.
3708
+ * @internal
3709
+ * @maxLength 24
3710
+ */
3711
+ postInternalId?: string;
3413
3712
  /** Field of the updated counter. */
3414
3713
  updatedCounterField?: FieldWithLiterals;
3415
3714
  /** New counter value. */
@@ -3443,6 +3742,18 @@ declare enum Field {
3443
3742
  /** @enumType */
3444
3743
  type FieldWithLiterals = Field | 'UNKNOWN' | 'TOTAL_COMMENTS' | 'LIKE_COUNT' | 'VIEW_COUNT' | 'RATING_COUNT';
3445
3744
  interface PostOwnerChanged {
3745
+ /**
3746
+ * Member ID of the post's owner before the change.
3747
+ * @internal
3748
+ * @format GUID
3749
+ */
3750
+ oldMemberId?: string;
3751
+ /**
3752
+ * Member ID of the post's owner after the change.
3753
+ * @internal
3754
+ * @format GUID
3755
+ */
3756
+ newMemberId?: string;
3446
3757
  }
3447
3758
  interface InitialPostsCopied {
3448
3759
  /** Number of posts copied. */
@@ -3455,6 +3766,21 @@ interface GetPostRequest {
3455
3766
  * @maxLength 38
3456
3767
  */
3457
3768
  postId: string;
3769
+ /**
3770
+ * __Deprecated.__ Use `fieldsets` instead.
3771
+ * This parameter will be removed on June 30, 2023.
3772
+ *
3773
+ * List of post fields to be included in the response.
3774
+ * @internal
3775
+ * @maxSize 20
3776
+ * @deprecated __Deprecated.__ Use `fieldsets` instead.
3777
+ * This parameter will be removed on June 30, 2023.
3778
+ *
3779
+ * List of post fields to be included in the response.
3780
+ * @replacedBy fieldsets
3781
+ * @targetRemovalDate 2024-06-30
3782
+ */
3783
+ fieldsToInclude?: PostFieldFieldWithLiterals[];
3458
3784
  /**
3459
3785
  * List of additional post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
3460
3786
  * the response in addition to the post’s base fields. Base fields don’t include any of the supported fieldset values. By default
@@ -3465,6 +3791,11 @@ interface GetPostRequest {
3465
3791
  }
3466
3792
  declare enum PostFieldField {
3467
3793
  UNKNOWN = "UNKNOWN",
3794
+ /**
3795
+ * Deprecated use `METRICS` instead.
3796
+ * @internal
3797
+ */
3798
+ COUNTERS = "COUNTERS",
3468
3799
  /** Includes post URL when present. */
3469
3800
  URL = "URL",
3470
3801
  /** Includes post content text string when present. */
@@ -3473,12 +3804,69 @@ declare enum PostFieldField {
3473
3804
  METRICS = "METRICS",
3474
3805
  /** Includes SEO data. */
3475
3806
  SEO = "SEO",
3807
+ /**
3808
+ * Includes post content as a stringified DraftJS document.
3809
+ * Reserved for internal use.
3810
+ * @internal
3811
+ */
3812
+ CONTENT = "CONTENT",
3813
+ /**
3814
+ * Includes internal ID field.
3815
+ * Reserved for internal use.
3816
+ * @internal
3817
+ */
3818
+ INTERNAL_ID = "INTERNAL_ID",
3476
3819
  /** Includes post owner's contact ID. */
3477
3820
  CONTACT_ID = "CONTACT_ID",
3478
3821
  /** Includes post rich content. */
3479
3822
  RICH_CONTENT = "RICH_CONTENT",
3823
+ /**
3824
+ * Includes post rich content string.
3825
+ * @internal
3826
+ */
3827
+ RICH_CONTENT_STRING = "RICH_CONTENT_STRING",
3828
+ /**
3829
+ * Includes compressed post rich content string.
3830
+ * @internal
3831
+ */
3832
+ RICH_CONTENT_COMPRESSED = "RICH_CONTENT_COMPRESSED",
3833
+ /**
3834
+ * Includes post translations.
3835
+ * @internal
3836
+ */
3837
+ TRANSLATIONS = "TRANSLATIONS",
3480
3838
  /** Includes post reference ID field. */
3481
- REFERENCE_ID = "REFERENCE_ID"
3839
+ REFERENCE_ID = "REFERENCE_ID",
3840
+ /**
3841
+ * If provided, all content fields exclude paid content.
3842
+ * @internal
3843
+ */
3844
+ EXCLUDE_PAID_CONTENT = "EXCLUDE_PAID_CONTENT",
3845
+ /**
3846
+ * Needed for post proxy to work correctly.
3847
+ * @internal
3848
+ */
3849
+ SEO_DATA = "SEO_DATA",
3850
+ /**
3851
+ * Needed for post proxy to work correctly.
3852
+ * @internal
3853
+ */
3854
+ OWNER = "OWNER",
3855
+ /**
3856
+ * Needed for post proxy to work correctly.
3857
+ * @internal
3858
+ */
3859
+ HAS_UNPUBLISHED_CHANGES = "HAS_UNPUBLISHED_CHANGES",
3860
+ /**
3861
+ * Needed for post proxy to work correctly.
3862
+ * @internal
3863
+ */
3864
+ HEADING = "HEADING",
3865
+ /**
3866
+ * Needed for post proxy to work correctly.
3867
+ * @internal
3868
+ */
3869
+ IMAGE = "IMAGE"
3482
3870
  }
3483
3871
  /** @enumType */
3484
3872
  type PostFieldFieldWithLiterals = PostFieldField | 'UNKNOWN' | 'URL' | 'CONTENT_TEXT' | 'METRICS' | 'SEO' | 'CONTACT_ID' | 'RICH_CONTENT' | 'REFERENCE_ID';
@@ -3493,6 +3881,21 @@ interface GetPostBySlugRequest {
3493
3881
  * @maxLength 200
3494
3882
  */
3495
3883
  slug: string;
3884
+ /**
3885
+ * __Deprecated.__ Use `fieldsets` instead.
3886
+ * This parameter will be removed on June 30, 2023.
3887
+ *
3888
+ * List of post fields to be included in the response.
3889
+ * @internal
3890
+ * @maxSize 20
3891
+ * @deprecated __Deprecated.__ Use `fieldsets` instead.
3892
+ * This parameter will be removed on June 30, 2023.
3893
+ *
3894
+ * List of post fields to be included in the response.
3895
+ * @replacedBy fieldsets
3896
+ * @targetRemovalDate 2024-06-30
3897
+ */
3898
+ fieldsToInclude?: PostFieldFieldWithLiterals[];
3496
3899
  /**
3497
3900
  * List of additional post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
3498
3901
  * the response in addition to the post’s base fields. Base fields don’t include any of the supported fieldset values. By default
@@ -3552,6 +3955,21 @@ interface ListPostsRequest {
3552
3955
  sort?: GetPostsSortWithLiterals;
3553
3956
  /** Pagination options. */
3554
3957
  paging?: BlogPaging;
3958
+ /**
3959
+ * __Deprecated.__ Use `fieldsets` instead.
3960
+ * This parameter will be removed on June 30, 2023.
3961
+ *
3962
+ * List of post fields to be included in the response.
3963
+ * @internal
3964
+ * @maxSize 20
3965
+ * @deprecated __Deprecated.__ Use `fieldsets` instead.
3966
+ * This parameter will be removed on June 30, 2023.
3967
+ *
3968
+ * List of post fields to be included in the response.
3969
+ * @replacedBy fieldsets
3970
+ * @targetRemovalDate 2024-06-30
3971
+ */
3972
+ fieldsToInclude?: PostFieldFieldWithLiterals[];
3555
3973
  /**
3556
3974
  * Language filter.
3557
3975
  *
@@ -3588,7 +4006,12 @@ declare enum GetPostsSort {
3588
4006
  /** Ordered by `title` in ascending order. */
3589
4007
  TITLE_ASC = "TITLE_ASC",
3590
4008
  /** Ordered by `title` in descending order. */
3591
- TITLE_DESC = "TITLE_DESC"
4009
+ TITLE_DESC = "TITLE_DESC",
4010
+ /**
4011
+ * Sorting by post rating descending.
4012
+ * @internal
4013
+ */
4014
+ RATING = "RATING"
3592
4015
  }
3593
4016
  /** @enumType */
3594
4017
  type GetPostsSortWithLiterals = GetPostsSort | 'FEED' | 'PUBLISHED_DATE_ASC' | 'PUBLISHED_DATE_DESC' | 'VIEW_COUNT' | 'LIKE_COUNT' | 'TITLE_ASC' | 'TITLE_DESC';
@@ -3635,6 +4058,64 @@ interface MetaData {
3635
4058
  cursor?: string | null;
3636
4059
  }
3637
4060
  interface QueryPostsRequest {
4061
+ /**
4062
+ * __Deprecated.__ Use `query` instead.
4063
+ * This parameter will be removed on June 30, 2023.
4064
+ *
4065
+ * Pagination options.
4066
+ * @internal
4067
+ * @deprecated __Deprecated.__ Use `query` instead.
4068
+ * This parameter will be removed on June 30, 2023.
4069
+ *
4070
+ * Pagination options.
4071
+ * @replacedBy query
4072
+ * @targetRemovalDate 2024-06-30
4073
+ */
4074
+ paging?: BlogPaging;
4075
+ /**
4076
+ * __Deprecated.__ Use `query` instead.
4077
+ * This parameter will be removed on June 30, 2023.
4078
+ *
4079
+ * Filter object.
4080
+ * @internal
4081
+ * @deprecated __Deprecated.__ Use `query` instead.
4082
+ * This parameter will be removed on June 30, 2023.
4083
+ *
4084
+ * Filter object.
4085
+ * @replacedBy query
4086
+ * @targetRemovalDate 2024-06-30
4087
+ */
4088
+ filter?: Record<string, any> | null;
4089
+ /**
4090
+ * __Deprecated.__ Use `query` instead.
4091
+ * This parameter will be removed on June 30, 2023.
4092
+ *
4093
+ * Sorting options.
4094
+ * @internal
4095
+ * @maxSize 3
4096
+ * @deprecated __Deprecated.__ Use `query` instead.
4097
+ * This parameter will be removed on June 30, 2023.
4098
+ *
4099
+ * Sorting options.
4100
+ * @replacedBy query
4101
+ * @targetRemovalDate 2024-06-30
4102
+ */
4103
+ sort?: Sorting[];
4104
+ /**
4105
+ * __Deprecated.__ Use `fieldsets` instead.
4106
+ * This parameter will be removed on June 30, 2023.
4107
+ *
4108
+ * List of post fields to be included in the response.
4109
+ * @internal
4110
+ * @maxSize 20
4111
+ * @deprecated __Deprecated.__ Use `fieldsets` instead.
4112
+ * This parameter will be removed on June 30, 2023.
4113
+ *
4114
+ * List of post fields to be included in the response.
4115
+ * @replacedBy fieldsets
4116
+ * @targetRemovalDate 2024-06-30
4117
+ */
4118
+ fieldsToInclude?: PostFieldFieldWithLiterals[];
3638
4119
  /** Query options. */
3639
4120
  query?: PlatformQuery;
3640
4121
  /**
@@ -3653,6 +4134,20 @@ interface Sorting {
3653
4134
  fieldName?: string;
3654
4135
  /** Sort order. */
3655
4136
  order?: SortOrderWithLiterals;
4137
+ /**
4138
+ * When `field_name` is a property of repeated field that is marked as `MATCH_ITEMS` and sort should be done by
4139
+ * a specific element from a collection, filter can/should be provided to ensure correct sort value is picked.
4140
+ *
4141
+ * If multiple filters are provided, they are combined with AND operator.
4142
+ *
4143
+ * Example:
4144
+ * Given we have document like {"id": "1", "nestedField": [{"price": 10, "region": "EU"}, {"price": 20, "region": "US"}]}
4145
+ * and `nestedField` is marked as `MATCH_ITEMS`, to ensure that sorting is done by correct region, filter should be
4146
+ * { fieldName: "nestedField.price", "select_items_by": [{"nestedField.region": "US"}] }
4147
+ * @internal
4148
+ * @maxSize 10
4149
+ */
4150
+ selectItemsBy?: Record<string, any>[] | null;
3656
4151
  /**
3657
4152
  * Origin point for geo-distance sorting on a GEO field
3658
4153
  * results are ordered by distance from this point (ASC = nearest first, DESC = farthest first).
@@ -3727,6 +4222,20 @@ interface CursorPaging {
3727
4222
  interface QueryPostsResponse {
3728
4223
  /** List of retrieved posts. */
3729
4224
  posts?: Post[];
4225
+ /**
4226
+ * __Deprecated.__ Use `pagingMetadata` instead.
4227
+ * This property will be removed on June 30, 2023.
4228
+ *
4229
+ * Details on the paged set of results returned.
4230
+ * @internal
4231
+ * @deprecated __Deprecated.__ Use `pagingMetadata` instead.
4232
+ * This property will be removed on June 30, 2023.
4233
+ *
4234
+ * Details on the paged set of results returned.
4235
+ * @replacedBy pagingMetadata
4236
+ * @targetRemovalDate 2024-06-30
4237
+ */
4238
+ metaData?: MetaData;
3730
4239
  /** Details on the paged set of results returned. */
3731
4240
  pagingMetadata?: PagingMetadataV2;
3732
4241
  }
@@ -3741,6 +4250,13 @@ interface PagingMetadataV2 {
3741
4250
  tooManyToCount?: boolean | null;
3742
4251
  /** Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used. */
3743
4252
  cursors?: Cursors;
4253
+ /**
4254
+ * Indicates if there are more results after the current page.
4255
+ * If `true`, another page of results can be retrieved.
4256
+ * If `false`, this is the last page.
4257
+ * @internal
4258
+ */
4259
+ hasNext?: boolean | null;
3744
4260
  }
3745
4261
  interface Cursors {
3746
4262
  /**