@wix/wix-data-items-common 1.0.236 → 1.0.237

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 (43) hide show
  1. package/dist/cjs/api/PipelineBuilder.js +2 -2
  2. package/dist/cjs/api/PipelineBuilder.js.map +1 -1
  3. package/dist/cjs/api/WixDataAggregate.js.map +1 -1
  4. package/dist/cjs/api/WixDataFilter.js.map +1 -1
  5. package/dist/cjs/api/WixDataQuery.js.map +1 -1
  6. package/dist/cjs/api/WixDataSearch.js.map +1 -1
  7. package/dist/cjs/api/expressions/expressions.js.map +1 -1
  8. package/dist/cjs/api/stages/FilterStage.js.map +1 -1
  9. package/dist/cjs/api/stages/GroupStage.js +3 -1
  10. package/dist/cjs/api/stages/GroupStage.js.map +1 -1
  11. package/dist/cjs/api/stages/ProjectStage.js.map +1 -1
  12. package/dist/cjs/api/stages/SortStage.js.map +1 -1
  13. package/dist/cjs/api/stages/stages.js.map +1 -1
  14. package/dist/cjs/api/types.js.map +1 -1
  15. package/dist/cjs/filter/WithFilter.js.map +1 -1
  16. package/dist/cjs/types/data-item-types.js.map +1 -1
  17. package/dist/esm/api/PipelineBuilder.js +2 -2
  18. package/dist/esm/api/stages/FilterStage.js.map +1 -1
  19. package/dist/esm/api/stages/GroupStage.js +3 -1
  20. package/dist/esm/api/stages/GroupStage.js.map +1 -1
  21. package/dist/esm/api/stages/ProjectStage.js.map +1 -1
  22. package/dist/types/api/PipelineBuilder.d.ts +4 -4
  23. package/dist/types/api/WixDataAggregate.d.ts +7 -7
  24. package/dist/types/api/WixDataFilter.d.ts +50 -84
  25. package/dist/types/api/WixDataFilter.d.ts.map +1 -1
  26. package/dist/types/api/WixDataQuery.d.ts +44 -71
  27. package/dist/types/api/WixDataQuery.d.ts.map +1 -1
  28. package/dist/types/api/WixDataSearch.d.ts +33 -33
  29. package/dist/types/api/expressions/expressions.d.ts +13 -13
  30. package/dist/types/api/stages/FilterStage.d.ts +70 -123
  31. package/dist/types/api/stages/FilterStage.d.ts.map +1 -1
  32. package/dist/types/api/stages/GroupStage.d.ts +20 -19
  33. package/dist/types/api/stages/GroupStage.d.ts.map +1 -1
  34. package/dist/types/api/stages/ProjectStage.d.ts +6 -7
  35. package/dist/types/api/stages/ProjectStage.d.ts.map +1 -1
  36. package/dist/types/api/stages/SortStage.d.ts +2 -2
  37. package/dist/types/api/stages/stages.d.ts +16 -8
  38. package/dist/types/api/stages/stages.d.ts.map +1 -1
  39. package/dist/types/api/types.d.ts +2 -2
  40. package/dist/types/filter/WithFilter.d.ts +26 -42
  41. package/dist/types/filter/WithFilter.d.ts.map +1 -1
  42. package/dist/types/types/data-item-types.d.ts +6 -6
  43. package/package.json +2 -2
@@ -19,20 +19,18 @@ export interface FilterStage extends PipelineStage, WithFilter<FilterStage> {
19
19
  */
20
20
  readonly invalidArguments: string[];
21
21
  /**
22
- * Filters pipeline data to match items whose specified field value equals the specified value.
22
+ * Filters pipeline data to match items where the value of the specified field equals the specified value.
23
23
  *
24
- * The `eq()` method refines this aggregate pipeline filter to only
25
- * match items where the value of the specified field equals the specified `value`.
24
+ * The `eq()` method refines the filter to only match items where the value of the specified field equals the specified value.
26
25
  *
27
- * It only matches values of the same type. For example, a number value stored
28
- * as a String type does not match the same number stored as a Number type.
26
+ * It only matches values of the same [data type](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-types-in-wix-data). For example, a number value stored as a string does not match the same number stored as a number.
29
27
  *
30
- * Matching strings with `eq()` is case sensitive, so `"text"` is not equal to `"Text"`.
28
+ * Matching strings with `eq()` is case sensitive, so `"text"` is not considered equal to `"Text"`.
31
29
  *
32
- * If `field` points to a collection field of type array, `eq()` includes the item as long as at least one array element matches the specified `value`.
30
+ * If `field` points to a collection field of type array, `eq()` includes the item as long as at least one array element matches the specified value.
33
31
  * @public
34
32
  * @documentationMaturity preview
35
- * @param field - Field whose value is compared with `value`.
33
+ * @param field - Field whose value is compared with the specified value.
36
34
  * @requiredField field
37
35
  * @param value - Value to compare with.
38
36
  * @requiredField value
@@ -40,21 +38,18 @@ export interface FilterStage extends PipelineStage, WithFilter<FilterStage> {
40
38
  */
41
39
  eq(field: string, value: any): FilterStage;
42
40
  /**
43
- * Filters pipeline data to match items whose specified field value does not equal the specified value.
41
+ * Filters pipeline data to match items where the value of the specified field does not equal the specified value.
44
42
  *
45
- * The `ne()` method refines this aggregate pipeline filter to only
46
- * match items where the value of the specified field does not equal the specified `value`.
43
+ * The `ne()` method refines the filter to only match items where the value of the specified field does not equal the specified value.
47
44
  *
48
- * It only matches values of the same type. For example, a number value stored
49
- * as a String type is considered not equal to the same number stored as a Number type.
45
+ * It only matches values of the same [data type](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-types-in-wix-data). For example, a number value stored as a string is considered not equal to the same number stored as a number.
50
46
  *
51
- * Matching strings with `ne()` is case sensitive, so `"text"` is not equal to `"Text"`.
47
+ * Matching strings with `ne()` is case sensitive, so `"text"` is not considered equal to `"Text"`.
52
48
  *
53
- * If the value of `field` is an array, `ne()` includes items
54
- * in which none of the elements of the array match the specified `value`.
49
+ * If the value of `field` is an array, `ne()` matches items where none of the array's elements match the specified value.
55
50
  * @public
56
51
  * @documentationMaturity preview
57
- * @param field - Field whose value is compared with `value`.
52
+ * @param field - Field whose value is compared with the specified value.
58
53
  * @requiredField field
59
54
  * @param value - Value to match.
60
55
  * @requiredField value
@@ -62,30 +57,22 @@ export interface FilterStage extends PipelineStage, WithFilter<FilterStage> {
62
57
  */
63
58
  ne(field: string, value: any): FilterStage;
64
59
  /**
65
- * Filters pipeline data to match items whose specified field value is greater than or equal to the specified
66
- * value.
60
+ * Filters pipeline data to match items where the value of the specified field is greater than or equal to the specified value.
67
61
  *
68
- * The `ge()` method refines this aggregate pipeline filter to only
69
- * match items where the value of the specified field is greater than or
70
- * equal to the specified `value`.
62
+ * The `ge()` method refines the filter to only match items where the value of the specified field is greater than or equal to the specified value.
71
63
  *
72
- * It only matches values of the same type. For example, a number value stored
73
- * as a String type does not match the same number stored as a Number type.
64
+ * It only matches values of the same [data type](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-types-in-wix-data). For example, a number value stored as a string does not match the same number stored as a string.
74
65
  *
75
- * If a field contains a number as a String, that value is compared
76
- * alphabetically and not numerically. Items that do not have a value for the
77
- * specified field are ranked lowest.
66
+ * If a field contains a number as a string, that value is compared alphabetically and not numerically. Items that do not have a value for the specified field are ranked lowest.
78
67
  *
79
68
  * The following field types can be compared:
80
69
  * - Number: Compares numerically.
81
70
  * - Date: Compares JavaScript Date objects.
82
- * - String: Compares lexicographically,
83
- * so `"abc"` is greater than or equal to `"ABC"` (because of the greater than),
84
- * but `"ABC"` is not greater than or equal to `"abc"`.
71
+ * - String: Compares lexicographically, so `"abc"` is greater than or equal to `"ABC"` (because of the greater than), but `"ABC"` is not greater than or equal to `"abc"`.
85
72
  * - Reference: Compares by the ID of the referenced item as a String.
86
73
  * @public
87
74
  * @documentationMaturity preview
88
- * @param field - Field whose value is compared with `value`.
75
+ * @param field - Field whose value is compared with the specified value.
89
76
  * @requiredField field
90
77
  * @param value - Value to match.
91
78
  * @requiredField value
@@ -93,17 +80,13 @@ export interface FilterStage extends PipelineStage, WithFilter<FilterStage> {
93
80
  */
94
81
  ge(field: string, value: string | number | Date): FilterStage;
95
82
  /**
96
- * Filters pipeline data to match items whose specified field value is greater than the specified value.
83
+ * Filters pipeline data to match items where the value of the specified field is greater than the specified value.
97
84
  *
98
- * The `gt()` method refines this aggregate pipeline filter to only match
99
- * items where the value of the specified field is greater than the specified `value`.
85
+ * The `gt()` method refines the filter to only match items where the value of the specified field is greater than the specified value.
100
86
  *
101
- * It only matches values of the same type. For example, a number value stored
102
- * as a String type does not match the same number stored as a Number type.
87
+ * It only matches values of the same [data type](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-types-in-wix-data). For example, a number value stored as a string does not match the same number stored as a string.
103
88
  *
104
- * If a field contains a number as a String, that value is compared
105
- * alphabetically and not numerically. Items that do not have a value for the
106
- * specified field are ranked lowest.
89
+ * If a field contains a number as a string, that value is compared alphabetically and not numerically. Items that do not have a value for the specified field are ranked lowest.
107
90
  *
108
91
  * The following field types can be compared:
109
92
  * - Number: Compares numerically.
@@ -112,38 +95,30 @@ export interface FilterStage extends PipelineStage, WithFilter<FilterStage> {
112
95
  * - Reference: Compares by the ID of the referenced item as a String.
113
96
  * @public
114
97
  * @documentationMaturity preview
115
- * @param field - Field whose value is compared with `value`.
98
+ * @param field - Field whose value is compared with the specified value.
116
99
  * @requiredField field
117
100
  * @param value - Value to match.
118
101
  * @requiredField value
119
- * @returns An object with the filter definition, based on the supplied parameters.
102
+ * @returns Refined filter.
120
103
  */
121
104
  gt(field: string, value: string | number | Date): FilterStage;
122
105
  /**
123
- * Filters pipeline data to match items whose specified field value is less than or equal to the specified
124
- * value.
106
+ * Filters pipeline data to match items where the value of the specified field is less than or equal to the specified value.
125
107
  *
126
- * The `le()` method refines this aggregate pipeline filter to only match
127
- * items where the value of the specified field is less than or equal to the
128
- * specified `value`.
108
+ * The `le()` method refines the filter to only match items where the value of the specified field is less than or equal to the specified value.
129
109
  *
130
- * It only matches values of the same type. For example, a number value stored
131
- * as a String type does not match the same number stored as a Number type.
110
+ * It only matches values of the same [data type](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-types-in-wix-data). For example, a number value stored as a string does not match the same number stored as a string.
132
111
  *
133
- * If a field contains a number as a String, that value is compared
134
- * alphabetically and not numerically. Items that do not have a value for the
135
- * specified field are ranked lowest.
112
+ * If a field contains a number as a string, that value is compared alphabetically and not numerically. Items that do not have a value for the specified field are ranked lowest.
136
113
  *
137
114
  * The following field types can be compared:
138
115
  * - Number: Compares numerically.
139
116
  * - Date: Compares JavaScript Date objects.
140
- * - String: Compares lexicographically,
141
- * so `"ABC"` is less than or equal to `"abc"` (because of the less than),
142
- * but `"abc"` is not less than or equal to `"ABC"`.
117
+ * - String: Compares lexicographically, so `"ABC"` is less than or equal to `"abc"` (because of the less than), but `"abc"` is not less than or equal to `"ABC"`.
143
118
  * - Reference: Compares by the ID of the referenced item as a String.
144
119
  * @public
145
120
  * @documentationMaturity preview
146
- * @param field - Field whose value is compared with `value`.
121
+ * @param field - Field whose value is compared with the specified value.
147
122
  * @requiredField field
148
123
  * @param value - Value to match.
149
124
  * @requiredField value
@@ -151,17 +126,13 @@ export interface FilterStage extends PipelineStage, WithFilter<FilterStage> {
151
126
  */
152
127
  le(field: string, value: string | number | Date): FilterStage;
153
128
  /**
154
- * Filters pipeline data to match items whose specified field value is less than the specified value.
129
+ * Filters pipeline data to match items where the value of the specified field is less than the specified value.
155
130
  *
156
- * The `lt()` method refines this aggregate pipeline filter to only match
157
- * items where the value of the specified field is less than the specified `value`.
131
+ * The `lt()` method refines the filter to only match items where the value of the specified field is less than the specified value.
158
132
  *
159
- * It only matches values of the same type. For example, a number value stored
160
- * as a String type does not match the same number stored as a Number type.
133
+ * It only matches values of the same [data type](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-types-in-wix-data). For example, a number value stored as a string does not match the same number stored as a string.
161
134
  *
162
- * If a field contains a number as a String, that value is compared
163
- * alphabetically and not numerically. Items that do not have a value for the
164
- * specified field are ranked lowest.
135
+ * If a field contains a number as a string, that value is compared alphabetically and not numerically. Items that do not have a value for the specified field are ranked lowest.
165
136
  *
166
137
  * The following field types can be compared:
167
138
  * - Number: Compares numerically.
@@ -170,24 +141,24 @@ export interface FilterStage extends PipelineStage, WithFilter<FilterStage> {
170
141
  * - Reference: Compares by the ID of the referenced item as a String.
171
142
  * @public
172
143
  * @documentationMaturity preview
173
- * @param field - Field whose value is compared with `value`.
144
+ * @param field - Field whose value is compared with the specified value.
174
145
  * @requiredField field
175
146
  * @param value - Value to match.
176
147
  * @requiredField value
177
- * @returns An object with the filter definition, based on the supplied parameters.
148
+ * @returns Refined filter.
178
149
  */
179
150
  lt(field: string, value: string | number | Date): FilterStage;
180
151
  /**
181
152
  * Filters pipeline data to match items whose specified field has any value.
182
153
  *
183
- * The `isNotEmpty()` method refines this aggregate pipeline filter to only match items where the
154
+ * The `isNotEmpty()` method refines the aggregate pipeline filter to only match items where the
184
155
  * value of the specified field is not `null` or `undefined`.
185
156
  *
186
157
  * If the field contains any value at all for a given item, including the
187
158
  * empty string or an invalid value, that item will match the filter.
188
159
  * @public
189
160
  * @documentationMaturity preview
190
- * @param field - Field in which to check for a value.
161
+ * @param field - Field to check for a value.
191
162
  * @requiredField field
192
163
  * @returns Refined filter.
193
164
  */
@@ -195,32 +166,25 @@ export interface FilterStage extends PipelineStage, WithFilter<FilterStage> {
195
166
  /**
196
167
  * Filters pipeline data to match items whose specified field does not exist or does not have any value.
197
168
  *
198
- * The `isEmpty()` method refines this aggregate pipeline filter to only match items where the
199
- * value of the specified field is `null` or `undefined` or the field does
200
- * not exist.
169
+ * The `isEmpty()` method refines the aggregate pipeline filter to only match items where the value of the specified field is `null` or `undefined` or the field does not exist.
201
170
  *
202
- * If the field contains any value at all for a given item, including the
203
- * empty string or an invalid value, that item will match the filter.
171
+ * If the field contains any value at all for a given item, including an empty string or an invalid value, that item does not match the filter.
204
172
  * @public
205
173
  * @documentationMaturity preview
206
- * @param field - Field in which to check for a value.
174
+ * @param field - Field to check for a value.
207
175
  * @requiredField field
208
- * @returns An object representing the refined filter.
176
+ * @returns Refined filter.
209
177
  */
210
178
  isEmpty(field: string): FilterStage;
211
179
  /**
212
- * Filters pipeline data to match items whose specified field value starts with a specified string.
180
+ * Filters pipeline data to match items where the value of the specified field starts with a specified value.
213
181
  *
214
- * The `startsWith()` method refines this aggregate pipeline filter to
215
- * only match items where the value of the specified field starts with the
216
- * defined `string`. Matching with `startsWith()` is not case sensitive, so `"TEXT"` starts
217
- * with `"tex"`.
182
+ * The `startsWith()` method refines the filter to only match items where the value of the specified field starts with the specified value. Matching with `startsWith()` is not case sensitive, so `"TEXT"` is considered to start with `"tex"`.
218
183
  *
219
- * You can only use `startsWith()` with a field whose value is a String or Reference.
220
- * When using a Reference, `startsWith()` matches by the ID of the referenced item as Strings.
184
+ * You can only use `startsWith()` with a [field of type](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-types-in-wix-data) string or reference. When matching a field of type reference, `startsWith()` matches by the ID of the referenced item as a string.
221
185
  * @public
222
186
  * @documentationMaturity preview
223
- * @param field - Field whose value is compared with the `value` parameter.
187
+ * @param field - Field whose value is compared with the specified value.
224
188
  * @requiredField field
225
189
  * @param value - Value to look for at the beginning of the specified field value.
226
190
  * @requiredField value
@@ -228,18 +192,14 @@ export interface FilterStage extends PipelineStage, WithFilter<FilterStage> {
228
192
  */
229
193
  startsWith(field: string, value: string): FilterStage;
230
194
  /**
231
- * Filters pipeline data to match items whose specified field value ends with a specified string.
195
+ * Filters pipeline data to match items where the value of the specified field ends with a specified value.
232
196
  *
233
- * The `endsWith()` method refines this aggregate pipeline filter to only
234
- * match items where the value of the specified field ends with the specified
235
- * `string`. Matching with `endsWith()` is not case sensitive, so `"TEXT"` ends
236
- * with `"ext"`.
197
+ * The `endsWith()` method refines the filter to only match items where the value of the specified field ends with the specified value. Matching with `endsWith()` is not case sensitive, so `"TEXT"` is considered to end with `"ext"`.
237
198
  *
238
- * You can only use `endsWith()` with a field whose value is a String or Reference.
239
- * When using a Reference, `endsWith()` matches by the ID of the referenced item as Strings.
199
+ * You can only use `endsWith()` with a [field of type](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-types-in-wix-data) string or reference. When matching a field of type reference, `endsWith()` matches by the ID of the referenced item as a string.
240
200
  * @public
241
201
  * @documentationMaturity preview
242
- * @param field - Field whose value is compared with the string.
202
+ * @param field - Field whose value is compared with the specified value.
243
203
  * @requiredField field
244
204
  * @param value - Value to look for at the end of the specified field value.
245
205
  * @requiredField value
@@ -247,42 +207,35 @@ export interface FilterStage extends PipelineStage, WithFilter<FilterStage> {
247
207
  */
248
208
  endsWith(field: string, value: string): FilterStage;
249
209
  /**
250
- * Filters pipeline data to match items whose specified field value contains the specified value.
210
+ * Filters pipeline data to match items where the value of the specified field contains the specified value.
251
211
  *
252
212
  * The `contains()` method refines the aggregate pipeline filter to only match items for which the value of the specified field contains the specified value. `contains()` is not case-sensitive, so the value `sunday` is considered to contain the value `Sun`.
253
213
  *
254
- * You can use `contains()` with a field whose type is a string or a reference. However, for fields whose type is reference, `contains()` matches by the ID of the referenced item as a string. Instead, use the [`eq()`](https://dev.wix.com/docs/sdk/backend-modules/data/wix-data-items-sdk-1-0-0/wix-data-filter/eq) method.
214
+ * You can use `contains()` with a [field of type](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-types-in-wix-data) string or reference. For fields of type reference, `contains()` matches by the ID of the referenced item as a string. To match by other data types, use the [`eq()`](https://dev.wix.com/docs/sdk/backend-modules/data/wix-data-items-sdk-1-0-0/wix-data-filter/eq) method.
255
215
  * @public
256
216
  * @documentationMaturity preview
257
- * @param field - Field whose value is compared with the provided value.
217
+ * @param field - Field whose value is matched with the specified value.
258
218
  * @requiredField field
259
- * @param value - Value to locate in the specified field value.
219
+ * @param value - Value to locate in the specified field.
260
220
  * @requiredField value
261
221
  * @returns Refined filter.
262
222
  */
263
223
  contains(field: string, value: string): FilterStage;
264
224
  /**
265
- * Filters pipeline data to match items whose specified field value equals any of the specified `values`
266
- * parameters.
225
+ * Filters pipeline data to match items where the value of the specified field equals any of the specified values.
267
226
  *
268
- * The `hasSome()` method refines this aggregate pipeline filter to
269
- * only match items where the value of the specified field equals any of
270
- * the specified values.
227
+ * The `hasSome()` method refines the filter to only match items where the value of the specified field contains any of the specified values.
271
228
  *
272
- * Matching strings with `hasSome()` is case sensitive, so `"text"` is not equal to `"Text"`.
229
+ * Matching strings with `hasSome()` is case sensitive, so `"text"` is not considered equal to `"Text"`.
273
230
  *
274
- * If the value of the specified field is an array, `hasSome()` will match
275
- * if any of the elements of that array match any of the specified values.
231
+ * If the value of the specified field is an array, `hasSome()` matches items where any of the array's elements match any of the specified values.
276
232
  *
277
- * If the specified field contains multiple references, pass item IDs in the
278
- * `value` field. In such a case, `hasSome()` will match if any of the
279
- * multiple references match any of the specified ID values.
233
+ * If the specified field contains multiple references, specify their item IDs. In such a case, `hasSome()` matches if any of the references match any of the specified ID values.
280
234
  *
281
- * You can specify a list of values to match by providing an array of
282
- * String, Number, or Date types as the `value` parameters.
235
+ * You can specify a list of values to match by providing an array of strings, numbers, or dates.
283
236
  * @public
284
237
  * @documentationMaturity preview
285
- * @param field - Field whose value is compared with `value`.
238
+ * @param field - Field whose value is compared with the specified values.
286
239
  * @requiredField field
287
240
  * @param values - Values to match.
288
241
  * @requiredField values
@@ -296,28 +249,22 @@ export interface FilterStage extends PipelineStage, WithFilter<FilterStage> {
296
249
  */
297
250
  hasSome(field: string, values: Comparable[]): FilterStage;
298
251
  /**
299
- * Filters pipeline data to match items whose specified field values equals all of the specified `value`
300
- * parameters.
252
+ * Filters pipeline data to match items where the values of the specified field equal all of the specified values.
301
253
  *
302
- * The `hasAll()` method refines this aggregate pipeline filter to
303
- * only match items where the value of the specified field equals all of
304
- * the specified values.
254
+ * The `hasAll()` method refines the filter to only match items where the value of the specified field equals all of the specified values.
305
255
  *
306
- * Matching strings with `hasAll()` is case sensitive, so `"text"` is not equal to `"Text"`.
256
+ * Matching strings with `hasAll()` is case sensitive, so `"text"` is not considered equal to `"Text"`.
307
257
  *
308
- * If the value of the specified field is an array, `hasAll()` will match
309
- * if there is a match in the elements of that array for all of the specified
310
- * values.
258
+ * If the value of the specified field is an array, `hasAll()` matches items where all the elements of that array match all of the specified values.
311
259
  *
312
- * You can specify a list of values to match by providing an array of
313
- * String, Number, or Date types as the `value` parameters.
260
+ * You can specify a list of values to match by providing an array of strings, numbers, or dates.
314
261
  * @public
315
262
  * @documentationMaturity preview
316
- * @param field - Field whose value is compared with `values`.
263
+ * @param field - Field whose value is compared with the specified values.
317
264
  * @requiredField field
318
265
  * @param values - Values to match.
319
266
  * @requiredField values
320
- * @returns An object representing the refined filter.
267
+ * @returns Refined filter.
321
268
  */
322
269
  hasAll(field: string, ...values: Comparable[]): FilterStage;
323
270
  /**
@@ -397,9 +344,9 @@ export interface FilterStage extends PipelineStage, WithFilter<FilterStage> {
397
344
  */
398
345
  not(filter: FilterStage): FilterStage;
399
346
  /**
400
- * Filters pipeline data to match items whose specified field value is within the defined range.
347
+ * Filters pipeline data to match items where the value of the specified field is within the defined range.
401
348
  *
402
- * The `between()` method refines this aggregate pipeline filter to match items for which the value of the specified field is greater than or equal to `rangeStart` and less than `rangeEnd`. The method only compares values of [the same type](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-type).
349
+ * The `between()` method refines the filter to match items for which the value of the specified field is greater than or equal to `rangeStart` and less than `rangeEnd`. The method only compares values of [the same type](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-types-in-wix-data).
403
350
  *
404
351
  * The following types can be compared:
405
352
  * - Number: Compared numerically.
@@ -1 +1 @@
1
- {"version":3,"file":"FilterStage.d.ts","sourceRoot":"","sources":["../../../../src/api/stages/FilterStage.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"FilterStage.d.ts","sourceRoot":"","sources":["../../../../src/api/stages/FilterStage.ts"],"names":[],"mappings":"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"}
@@ -10,9 +10,9 @@ export interface GroupStage extends PipelineStage {
10
10
  *
11
11
  * The `by()` method configures the aggregation pipeline to group items for which the specified `expression` resolves to the same value. The `key` and resolved `expression` determine the result item's unique `_id` property.
12
12
  *
13
- * > **Note**: When `by()` is not called or when called with no parameters, all items are placed in a single group.
13
+ * > **Note**: When `by()` is not called or when it is called with no parameters, all items are placed in a single group.
14
14
  *
15
- * @param expression - Expression to determine the grouping value. Items with matching values are grouped together.
15
+ * @param expression - Expression to determine the grouping value. Items with matching values are grouped together. Learn more about using [expressions in aggregation pipelines](https://dev.wix.com/docs/sdk/backend-modules/data/items/wix-data-aggregate-pipeline-expressions/introduction).
16
16
  * @param key - Name of the field in the result that contains the grouping value.
17
17
  * @returns GroupStage object.
18
18
  */
@@ -24,8 +24,8 @@ export interface GroupStage extends PipelineStage {
24
24
  *
25
25
  * @public
26
26
  * @documentationMaturity preview
27
- * @param expression - Expression to calculate the group's total sum. Expression must resolve to a number.
28
- * @param resultFieldName - Field key in the output item to store the result in.
27
+ * @param expression - Expression to calculate the group's total sum. Expression must resolve to a number. Learn more about using [expressions in aggregation pipelines](https://dev.wix.com/docs/sdk/backend-modules/data/items/wix-data-aggregate-pipeline-expressions/introduction).
28
+ * @param resultFieldName - Field to store the result in.
29
29
  *
30
30
  * Learn more about [field keys](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-id-velo-by-wix-only).
31
31
  * @returns GroupStage object.
@@ -38,8 +38,8 @@ export interface GroupStage extends PipelineStage {
38
38
  *
39
39
  * @public
40
40
  * @documentationMaturity preview
41
- * @param expression - Expression to calculate the group's average value. The expression must resolve to a number.
42
- * @param resultFieldName - Field key in the output item to store the result in.
41
+ * @param expression - Expression to calculate the group's average value. The expression must resolve to a number. Learn more about using [expressions in aggregation pipelines](https://dev.wix.com/docs/sdk/backend-modules/data/items/wix-data-aggregate-pipeline-expressions/introduction).
42
+ * @param resultFieldName - Field to store the result in.
43
43
  *
44
44
  * Learn more about [field keys](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-id-velo-by-wix-only).
45
45
  * @returns GroupStage object.
@@ -52,8 +52,8 @@ export interface GroupStage extends PipelineStage {
52
52
  *
53
53
  * @public
54
54
  * @documentationMaturity preview
55
- * @param expression - Expression to find the group's minimum value. Expression must resolve to a comparable value, such as a number or string.
56
- * @param resultFieldName - Field key in the output item to store the result in.
55
+ * @param expression - Expression to find the group's minimum value. Expression must resolve to a comparable value, such as a number or string. Learn more about using [expressions in aggregation pipelines](https://dev.wix.com/docs/sdk/backend-modules/data/items/wix-data-aggregate-pipeline-expressions/introduction).
56
+ * @param resultFieldName - Field to store the result in.
57
57
  *
58
58
  * Learn more about [field keys](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-id-velo-by-wix-only).
59
59
  * @returns GroupStage object.
@@ -66,8 +66,8 @@ export interface GroupStage extends PipelineStage {
66
66
  *
67
67
  * @public
68
68
  * @documentationMaturity preview
69
- * @param expression - Expression to find the group's maximum value. Expression must resolve to a comparable value, such as a number or string.
70
- * @param resultFieldName - Field key in the output item to store the result in.
69
+ * @param expression - Expression to find the group's maximum value. Expression must resolve to a comparable value, such as a number or string. Learn more about using [expressions in aggregation pipelines](https://dev.wix.com/docs/sdk/backend-modules/data/items/wix-data-aggregate-pipeline-expressions/introduction).
70
+ * @param resultFieldName - Field to store the result in.
71
71
  *
72
72
  * Learn more about [field keys](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-id-velo-by-wix-only).
73
73
  * @returns GroupStage object.
@@ -80,7 +80,7 @@ export interface GroupStage extends PipelineStage {
80
80
  *
81
81
  * @public
82
82
  * @documentationMaturity preview
83
- * @param resultFieldName - Field key in the output item to store the result in.
83
+ * @param resultFieldName - Field to store the result in.
84
84
  *
85
85
  * Learn more about [field keys](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-id-velo-by-wix-only).
86
86
  * @returns GroupStage object.
@@ -93,8 +93,8 @@ export interface GroupStage extends PipelineStage {
93
93
  *
94
94
  * @public
95
95
  * @documentationMaturity preview
96
- * @param expression - Expression to find the first item in the group.
97
- * @param resultFieldName - Field key in the output item to store the result in.
96
+ * @param expression - Expression to find the first item in the group. Learn more about using [expressions in aggregation pipelines](https://dev.wix.com/docs/sdk/backend-modules/data/items/wix-data-aggregate-pipeline-expressions/introduction).
97
+ * @param resultFieldName - Field to store the result in.
98
98
  *
99
99
  * Learn more about [field keys](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-id-velo-by-wix-only).
100
100
  * @returns GroupStage object.
@@ -107,8 +107,8 @@ export interface GroupStage extends PipelineStage {
107
107
  *
108
108
  * @public
109
109
  * @documentationMaturity preview
110
- * @param expression - Expression to find the last item in the group.
111
- * @param resultFieldName - Field key in the output item to store the result in.
110
+ * @param expression - Expression to find the last item in the group. Learn more about using [expressions in aggregation pipelines](https://dev.wix.com/docs/sdk/backend-modules/data/items/wix-data-aggregate-pipeline-expressions/introduction).
111
+ * @param resultFieldName - Field to store the result in.
112
112
  *
113
113
  * Learn more about [field keys](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-id-velo-by-wix-only).
114
114
  * @returns GroupStage object.
@@ -121,11 +121,10 @@ export interface GroupStage extends PipelineStage {
121
121
  *
122
122
  * @public
123
123
  * @documentationMaturity preview
124
- * @param expression - Expression to collect items into an array.
125
- * @param resultFieldName - Field key in the output item to store the result in.
124
+ * @param expression - Expression to collect items into an array. Learn more about using [expressions in aggregation pipelines](https://dev.wix.com/docs/sdk/backend-modules/data/items/wix-data-aggregate-pipeline-expressions/introduction).
125
+ * @param resultFieldName - Field to store the result in.
126
126
  *
127
127
  * Learn more about [field keys](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-id-velo-by-wix-only).
128
-
129
128
  * @returns GroupStage object.
130
129
  */
131
130
  push(expression: Expression, resultFieldName: string): GroupStage;
@@ -143,7 +142,9 @@ export declare class GroupStageImpl implements GroupStage {
143
142
  last(expression: Expression, resultFieldName: string): GroupStage;
144
143
  push(expression: Expression, resultFieldName: string): GroupStage;
145
144
  private addAccumulator;
146
- /** @private */
145
+ /**
146
+ * @internal
147
+ */
147
148
  build(): apiTypes.Stage;
148
149
  }
149
150
  //# sourceMappingURL=GroupStage.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"GroupStage.d.ts","sourceRoot":"","sources":["../../../../src/api/stages/GroupStage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,2BAA2B,CAAA;AAC7E,OAAO,KAAK,QAAQ,MAAM,6BAA6B,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C;;;;;;;;;;OAUG;IACH,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAAA;IACnD;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;IAChE;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;IAChE;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;IAChE;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;IAChE;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;IAC1C;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;IAClE;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;IACjE;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;CAClE;AAED,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,YAAY,CAAoB;IAExC,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU;IAKnD,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAIhE,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAIhE,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAIhE,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAIhE,KAAK,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU;IAQ1C,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAIlE,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAIjE,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAIjE,OAAO,CAAC,cAAc;IAStB,eAAe;IACf,KAAK,IAAI,QAAQ,CAAC,KAAK;CAgBxB"}
1
+ {"version":3,"file":"GroupStage.d.ts","sourceRoot":"","sources":["../../../../src/api/stages/GroupStage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,2BAA2B,CAAA;AAC7E,OAAO,KAAK,QAAQ,MAAM,6BAA6B,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C;;;;;;;;;;OAUG;IACH,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAAA;IACnD;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;IAChE;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;IAChE;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;IAChE;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;IAChE;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;IAC1C;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;IAClE;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;IACjE;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAAA;CAClE;AAED,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,YAAY,CAAoB;IAExC,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU;IAKnD,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAIhE,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAIhE,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAIhE,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAIhE,KAAK,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU;IAQ1C,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAIlE,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAIjE,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAIjE,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,KAAK,IAAI,QAAQ,CAAC,KAAK;CAgBxB"}
@@ -16,7 +16,7 @@ export interface ProjectStage extends PipelineStage {
16
16
  *
17
17
  * @public
18
18
  * @documentationMaturity preview
19
- * @param fieldNames - Key of the field to include in the result. Use dot notation to specify nested fields. For example, `user.name` or `product.price`.
19
+ * @param fieldNames - Fields to include in the result. Use dot notation to specify nested fields. For example, `user.name` or `product.price`.
20
20
  *
21
21
  * Learn more about [field keys](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-id-velo-by-wix-only).
22
22
  * @returns ProjectStage object.
@@ -29,20 +29,19 @@ export interface ProjectStage extends PipelineStage {
29
29
  *
30
30
  * @public
31
31
  * @documentationMaturity preview
32
- * @param fieldNames - Key of the field to exclude from the result. Use dot notation to specify nested fields. For example, `user.name` or `product.price`.
32
+ * @param fieldNames - Fields to exclude from the result. Use dot notation to specify nested fields. For example, `user.name` or `product.price`.
33
33
  *
34
34
  * Learn more about [field keys](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-id-velo-by-wix-only).
35
35
  * @returns ProjectStage object.
36
36
  */
37
37
  exclude(...fieldNames: string[]): ProjectStage;
38
38
  /**
39
- * Reshapes a new field based on the specified expression.
40
- * The field used by the expression is not included in the result.
39
+ * Reshapes a new field based on the specified expression. The result does not include the field used in the expression. For example, reshaping `basePrice` to add `tax` results in a new field `totalPrice` that does not include `basePrice` or `tax`.
41
40
  *
42
41
  * @public
43
42
  * @documentationMaturity preview
44
- * @param expression - Expression to resolve. The result of the expression becomes the value of the new field.
45
- * @param resultFieldName - Key of the field to create in the result.
43
+ * @param expression - Expression to resolve. The result of the expression becomes the value of the new field. Learn more about using [expressions in aggregation pipelines](https://dev.wix.com/docs/sdk/backend-modules/data/items/wix-data-aggregate-pipeline-expressions/introduction).
44
+ * @param resultFieldName - Field to create in the result.
46
45
  *
47
46
  * Learn more about [field keys](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-id-velo-by-wix-only).
48
47
  * @returns ProjectStage object.
@@ -54,7 +53,7 @@ export interface ProjectStage extends PipelineStage {
54
53
  * @public
55
54
  * @documentationMaturity preview
56
55
  * @param stage - Projected stage to nest.
57
- * @param resultFieldName - Key of the field in which to nest the projected stage.
56
+ * @param resultFieldName - Field to nest the projected stage in.
58
57
  *
59
58
  * Learn more about [field keys](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-id-velo-by-wix-only).
60
59
  * @returns ProjectStage object.
@@ -1 +1 @@
1
- {"version":3,"file":"ProjectStage.d.ts","sourceRoot":"","sources":["../../../../src/api/stages/ProjectStage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACtD,OAAO,KAAK,QAAQ,MAAM,6BAA6B,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAA;IACxB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,GAAG,UAAU,EAAE,MAAM,EAAE,GAAG,YAAY,CAAA;IAC9C;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,GAAG,UAAU,EAAE,MAAM,EAAE,GAAG,YAAY,CAAA;IAC9C;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,YAAY,CAAA;IACtE;;;;;;;;;;OAUG;IACH,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,GAAG,YAAY,CAAA;CAC1E;AAED,qBAAa,gBAAiB,YAAW,YAAY;IACnD,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAK;IAE7B,OAAO,CAAC,GAAG,UAAU,EAAE,MAAM,EAAE,GAAG,YAAY;IAO9C,OAAO,CAAC,GAAG,UAAU,EAAE,MAAM,EAAE,GAAG,YAAY;IAO9C,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,YAAY;IAKtE,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,GAAG,YAAY;IAIzE,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,wBAAwB;IAQhC,eAAe;IACf,KAAK,IAAI,QAAQ,CAAC,KAAK;CAGxB"}
1
+ {"version":3,"file":"ProjectStage.d.ts","sourceRoot":"","sources":["../../../../src/api/stages/ProjectStage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACtD,OAAO,KAAK,QAAQ,MAAM,6BAA6B,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAA;IACxB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,GAAG,UAAU,EAAE,MAAM,EAAE,GAAG,YAAY,CAAA;IAC9C;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,GAAG,UAAU,EAAE,MAAM,EAAE,GAAG,YAAY,CAAA;IAC9C;;;;;;;;;;OAUG;IACH,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,YAAY,CAAA;IACtE;;;;;;;;;;OAUG;IACH,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,GAAG,YAAY,CAAA;CAC1E;AAED,qBAAa,gBAAiB,YAAW,YAAY;IACnD,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAK;IAE7B,OAAO,CAAC,GAAG,UAAU,EAAE,MAAM,EAAE,GAAG,YAAY;IAO9C,OAAO,CAAC,GAAG,UAAU,EAAE,MAAM,EAAE,GAAG,YAAY;IAO9C,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,YAAY;IAKtE,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,GAAG,YAAY;IAIzE,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,wBAAwB;IAQhC,eAAe;IACf,KAAK,IAAI,QAAQ,CAAC,KAAK;CAGxB"}
@@ -19,7 +19,7 @@ export interface SortStage extends PipelineStage {
19
19
  *
20
20
  * @public
21
21
  * @documentationMaturity preview
22
- * @param fields - Fields used in the sort.
22
+ * @param fields - Fields to sort by.
23
23
  * @returns SortStage object.
24
24
  */
25
25
  ascending(...fields: string[]): SortStage;
@@ -38,7 +38,7 @@ export interface SortStage extends PipelineStage {
38
38
  *
39
39
  * @public
40
40
  * @documentationMaturity preview
41
- * @param fields - Fields used in the sort.
41
+ * @param fields - Fields to sort by.
42
42
  * @returns SortStage object.
43
43
  */
44
44
  descending(...fields: string[]): SortStage;