@wix/auto_sdk_suppliers-hub_products 1.0.0
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.
- package/build/cjs/index.d.ts +175 -0
- package/build/cjs/index.js +1670 -0
- package/build/cjs/index.js.map +1 -0
- package/build/cjs/index.typings.d.ts +25 -0
- package/build/cjs/index.typings.js +1420 -0
- package/build/cjs/index.typings.js.map +1 -0
- package/build/cjs/meta.d.ts +1915 -0
- package/build/cjs/meta.js +1120 -0
- package/build/cjs/meta.js.map +1 -0
- package/build/cjs/suppliershub-marketplace-product-v1-product-products.universal-DInaBID7.d.ts +2721 -0
- package/build/es/index.d.mts +175 -0
- package/build/es/index.mjs +1611 -0
- package/build/es/index.mjs.map +1 -0
- package/build/es/index.typings.d.mts +25 -0
- package/build/es/index.typings.mjs +1364 -0
- package/build/es/index.typings.mjs.map +1 -0
- package/build/es/meta.d.mts +1915 -0
- package/build/es/meta.mjs +1063 -0
- package/build/es/meta.mjs.map +1 -0
- package/build/es/package.json +3 -0
- package/build/es/suppliershub-marketplace-product-v1-product-products.universal-DInaBID7.d.mts +2721 -0
- package/build/internal/cjs/index.d.ts +175 -0
- package/build/internal/cjs/index.js +1670 -0
- package/build/internal/cjs/index.js.map +1 -0
- package/build/internal/cjs/index.typings.d.ts +25 -0
- package/build/internal/cjs/index.typings.js +1420 -0
- package/build/internal/cjs/index.typings.js.map +1 -0
- package/build/internal/cjs/meta.d.ts +1915 -0
- package/build/internal/cjs/meta.js +1120 -0
- package/build/internal/cjs/meta.js.map +1 -0
- package/build/internal/cjs/suppliershub-marketplace-product-v1-product-products.universal-DInaBID7.d.ts +2721 -0
- package/build/internal/es/index.d.mts +175 -0
- package/build/internal/es/index.mjs +1611 -0
- package/build/internal/es/index.mjs.map +1 -0
- package/build/internal/es/index.typings.d.mts +25 -0
- package/build/internal/es/index.typings.mjs +1364 -0
- package/build/internal/es/index.typings.mjs.map +1 -0
- package/build/internal/es/meta.d.mts +1915 -0
- package/build/internal/es/meta.mjs +1063 -0
- package/build/internal/es/meta.mjs.map +1 -0
- package/build/internal/es/suppliershub-marketplace-product-v1-product-products.universal-DInaBID7.d.mts +2721 -0
- package/meta/package.json +3 -0
- package/package.json +54 -0
|
@@ -0,0 +1,1915 @@
|
|
|
1
|
+
import { ag as CreateProductRequest$1, ah as CreateProductResponse$1, ai as GetProductRequest$1, aj as GetProductResponse$1, ak as UpdateProductRequest$1, al as UpdateProductResponse$1, am as DeleteProductRequest$1, an as DeleteProductResponse$1, ao as BulkCreateProductsRequest$1, a as BulkCreateProductsResponse$1, at as BulkUpdateProductsRequest$1, c as BulkUpdateProductsResponse$1, av as BulkDeleteProductsRequest$1, d as BulkDeleteProductsResponse$1, ax as QueryProductsRequest$1, aC as QueryProductsResponse$1, aF as SearchProductsRequest$1, S as SearchProductsResponse$1, be as BulkUpdateProductTagsRequest$1, g as BulkUpdateProductTagsResponse$1, bg as BulkUpdateProductTagsByFilterRequest$1, j as BulkUpdateProductTagsByFilterResponse$1, bh as QueryCategoriesRequest$1, l as QueryCategoriesResponse$1 } from './suppliershub-marketplace-product-v1-product-products.universal-DInaBID7.mjs';
|
|
2
|
+
import '@wix/sdk-types';
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* A product provided by a business partner and displayed in the Wix Marketplace.
|
|
6
|
+
*
|
|
7
|
+
* Products can be of type DROPSHIPPING, WHOLESALE, or both.
|
|
8
|
+
* Wix users can discover and add these products to their stores.
|
|
9
|
+
*/
|
|
10
|
+
interface Product {
|
|
11
|
+
/**
|
|
12
|
+
* Product ID.
|
|
13
|
+
* @format GUID
|
|
14
|
+
* @readonly
|
|
15
|
+
*/
|
|
16
|
+
id?: string | null;
|
|
17
|
+
/**
|
|
18
|
+
* Date and time the product was created.
|
|
19
|
+
* @readonly
|
|
20
|
+
*/
|
|
21
|
+
createdDate?: Date | null;
|
|
22
|
+
/**
|
|
23
|
+
* Date and time the product was updated.
|
|
24
|
+
* @readonly
|
|
25
|
+
*/
|
|
26
|
+
updatedDate?: Date | null;
|
|
27
|
+
/** Information about the business partner providing this product. */
|
|
28
|
+
providerInfo?: ProviderInfo;
|
|
29
|
+
/**
|
|
30
|
+
* Product name.
|
|
31
|
+
* @minLength 1
|
|
32
|
+
* @maxLength 100
|
|
33
|
+
*/
|
|
34
|
+
name?: string | null;
|
|
35
|
+
/**
|
|
36
|
+
* Product description.
|
|
37
|
+
* @maxLength 64000
|
|
38
|
+
*/
|
|
39
|
+
description?: string | null;
|
|
40
|
+
/**
|
|
41
|
+
* Whether the product is visible in the Marketplace.
|
|
42
|
+
*
|
|
43
|
+
* Default: `true`
|
|
44
|
+
*/
|
|
45
|
+
visible?: boolean | null;
|
|
46
|
+
/** Product media. */
|
|
47
|
+
media?: Media;
|
|
48
|
+
/**
|
|
49
|
+
* Business model types this product supports.
|
|
50
|
+
* @minSize 1
|
|
51
|
+
* @maxSize 2
|
|
52
|
+
*/
|
|
53
|
+
types?: ProductTypeWithLiterals[];
|
|
54
|
+
/**
|
|
55
|
+
* Product options that customers can choose from.
|
|
56
|
+
*
|
|
57
|
+
* Options display available product variations like size and color to help buyers make purchase decisions.
|
|
58
|
+
* Currently, options are informational only and don't create separate inventory items or variants.
|
|
59
|
+
*
|
|
60
|
+
* There are 2 predefined option types you can use:
|
|
61
|
+
* - `color`: Color choices for the product. Values should be standard color names. For example, `"Black"`, `"White"`, `"Yellow"`.
|
|
62
|
+
* - `size`: Size choices for the product. Values should be standard size labels. For example, `"S"`, `"M"`, `"L"`, `"XL"`.
|
|
63
|
+
* @maxSize 6
|
|
64
|
+
*/
|
|
65
|
+
options?: ProductOption[];
|
|
66
|
+
/**
|
|
67
|
+
* Promotional ribbon text displayed on the product.
|
|
68
|
+
*
|
|
69
|
+
* For example, `"New Arrival"` or `"Bestseller"`.
|
|
70
|
+
* @minLength 1
|
|
71
|
+
* @maxLength 30
|
|
72
|
+
*/
|
|
73
|
+
ribbonName?: string | null;
|
|
74
|
+
/**
|
|
75
|
+
* Brand name.
|
|
76
|
+
* @minLength 1
|
|
77
|
+
* @maxLength 50
|
|
78
|
+
*/
|
|
79
|
+
brand?: string | null;
|
|
80
|
+
/** Time required to process orders before shipping. */
|
|
81
|
+
orderProcessingTime?: TimeInterval;
|
|
82
|
+
/**
|
|
83
|
+
* Countries and regions where this product can be shipped, with location-specific pricing and timing.
|
|
84
|
+
* @maxSize 100
|
|
85
|
+
*/
|
|
86
|
+
shippingDestinations?: ShippingDestination[];
|
|
87
|
+
/**
|
|
88
|
+
* Minimum price, in USD.
|
|
89
|
+
* @decimalValue options { gte:0, lte:999999999, maxScale:2 }
|
|
90
|
+
*/
|
|
91
|
+
minimumPrice?: string | null;
|
|
92
|
+
/**
|
|
93
|
+
* Country where the product is manufactured or originates from, in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
|
|
94
|
+
* @format COUNTRY
|
|
95
|
+
*/
|
|
96
|
+
productOrigin?: string | null;
|
|
97
|
+
/**
|
|
98
|
+
* List of categories that directly contain this product.
|
|
99
|
+
*
|
|
100
|
+
* Each category's namespace must match at least one of the product's types.
|
|
101
|
+
* For example, if a product has type `DROPSHIPPING`, its categories must use `DROPSHIPPING_NAMESPACE`.
|
|
102
|
+
* Products with both `DROPSHIPPING` and `WHOLESALE` types can have categories from both namespaces.
|
|
103
|
+
* @maxSize 50
|
|
104
|
+
*/
|
|
105
|
+
directCategories?: ProductCategory[];
|
|
106
|
+
/**
|
|
107
|
+
* List of categories that directly contain this product, as well as their parent categories.
|
|
108
|
+
* @readonly
|
|
109
|
+
* @maxSize 2000
|
|
110
|
+
*/
|
|
111
|
+
allCategories?: ProductCategory[];
|
|
112
|
+
/**
|
|
113
|
+
* Wholesale-specific configuration including tiered pricing and minimum order quantities.
|
|
114
|
+
*
|
|
115
|
+
* Required when `types` includes `WHOLESALE`.
|
|
116
|
+
*/
|
|
117
|
+
wholesaleOptions?: WholesaleOptions;
|
|
118
|
+
/** Information about the supplier including name, rating, and trust status. */
|
|
119
|
+
supplierInfo?: SupplierInfo;
|
|
120
|
+
/**
|
|
121
|
+
* Print-on-demand-specific configuration including supported print technologies and mockup assets.
|
|
122
|
+
*
|
|
123
|
+
* Required when `types` include `PRINT_ON_DEMAND`.
|
|
124
|
+
*/
|
|
125
|
+
printOnDemandOptions?: PrintOnDemandOptions;
|
|
126
|
+
/**
|
|
127
|
+
* Information about the product sizing
|
|
128
|
+
* @maxSize 5
|
|
129
|
+
*/
|
|
130
|
+
sizeGuides?: SizeGuide[];
|
|
131
|
+
/** Product tags for organization and filtering. */
|
|
132
|
+
tags?: Tags;
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* Information about the business partner providing the product.
|
|
136
|
+
*
|
|
137
|
+
* Provider information is immutable after product creation.
|
|
138
|
+
*/
|
|
139
|
+
interface ProviderInfo {
|
|
140
|
+
/**
|
|
141
|
+
* Provider application ID.
|
|
142
|
+
* @format GUID
|
|
143
|
+
* @readonly
|
|
144
|
+
*/
|
|
145
|
+
appId?: string | null;
|
|
146
|
+
/**
|
|
147
|
+
* Unique product identifier on the provider's platform.
|
|
148
|
+
*
|
|
149
|
+
* This field serves as the external system's primary key for synchronization and prevents
|
|
150
|
+
* duplicate products from being created. Once set, you can't change this field.
|
|
151
|
+
* @minLength 1
|
|
152
|
+
* @maxLength 36
|
|
153
|
+
* @immutable
|
|
154
|
+
*/
|
|
155
|
+
productId?: string | null;
|
|
156
|
+
/**
|
|
157
|
+
* Date and time the product was created on the provider's platform.
|
|
158
|
+
*
|
|
159
|
+
* This field helps maintain the connection to the original product source.
|
|
160
|
+
* Once set, you can't change this field.
|
|
161
|
+
* @immutable
|
|
162
|
+
*/
|
|
163
|
+
productCreatedDate?: Date | null;
|
|
164
|
+
/**
|
|
165
|
+
* Product URL on the provider's platform.
|
|
166
|
+
* @format WEB_URL
|
|
167
|
+
*/
|
|
168
|
+
url?: string | null;
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* Product media.
|
|
172
|
+
*
|
|
173
|
+
* The first image in the `items` array becomes the main image.
|
|
174
|
+
*/
|
|
175
|
+
interface Media {
|
|
176
|
+
/**
|
|
177
|
+
* Primary product image, automatically set from the first item in the `items` array.
|
|
178
|
+
* @readonly
|
|
179
|
+
*/
|
|
180
|
+
main?: Image;
|
|
181
|
+
/**
|
|
182
|
+
* Product images. The first image becomes the main image.
|
|
183
|
+
* @maxSize 15
|
|
184
|
+
*/
|
|
185
|
+
items?: Image[];
|
|
186
|
+
}
|
|
187
|
+
interface Image {
|
|
188
|
+
/** WixMedia image ID. */
|
|
189
|
+
id?: string;
|
|
190
|
+
/** Image URL. */
|
|
191
|
+
url?: string;
|
|
192
|
+
/**
|
|
193
|
+
* Original image height.
|
|
194
|
+
* @readonly
|
|
195
|
+
*/
|
|
196
|
+
height?: number;
|
|
197
|
+
/**
|
|
198
|
+
* Original image width.
|
|
199
|
+
* @readonly
|
|
200
|
+
*/
|
|
201
|
+
width?: number;
|
|
202
|
+
/** Image alt text. */
|
|
203
|
+
altText?: string | null;
|
|
204
|
+
/**
|
|
205
|
+
* Image filename.
|
|
206
|
+
* @readonly
|
|
207
|
+
*/
|
|
208
|
+
filename?: string | null;
|
|
209
|
+
}
|
|
210
|
+
interface FocalPoint {
|
|
211
|
+
/** X-coordinate of the focal point. */
|
|
212
|
+
x?: number;
|
|
213
|
+
/** Y-coordinate of the focal point. */
|
|
214
|
+
y?: number;
|
|
215
|
+
/** crop by height */
|
|
216
|
+
height?: number | null;
|
|
217
|
+
/** crop by width */
|
|
218
|
+
width?: number | null;
|
|
219
|
+
}
|
|
220
|
+
/** Business model types that products can support. */
|
|
221
|
+
declare enum ProductType {
|
|
222
|
+
/** Product is fulfilled by the supplier without inventory management by the store owner. */
|
|
223
|
+
DROPSHIPPING = "DROPSHIPPING",
|
|
224
|
+
/** Product is sold in bulk quantities with tiered pricing. */
|
|
225
|
+
WHOLESALE = "WHOLESALE",
|
|
226
|
+
/** Product is manufactured after purchase; no pre‑held inventory. */
|
|
227
|
+
PRINT_ON_DEMAND = "PRINT_ON_DEMAND"
|
|
228
|
+
}
|
|
229
|
+
/** @enumType */
|
|
230
|
+
type ProductTypeWithLiterals = ProductType | 'DROPSHIPPING' | 'WHOLESALE' | 'PRINT_ON_DEMAND';
|
|
231
|
+
/**
|
|
232
|
+
* Product option like size, color, or material.
|
|
233
|
+
*
|
|
234
|
+
* Each option can have multiple values that customers can choose from.
|
|
235
|
+
*/
|
|
236
|
+
interface ProductOption {
|
|
237
|
+
/**
|
|
238
|
+
* Option name.
|
|
239
|
+
*
|
|
240
|
+
* There are 2 predefined options you can use:
|
|
241
|
+
* - `color`: Represents color choices for the product. Values should be standard color names. For example, `"Black"`, `"White"`, `"Yellow"`.
|
|
242
|
+
* - `size`: Represents size choices for the product. Values should be standard size labels. For example, `"S"`, `"M"`, `"L"`, `"XL"`.
|
|
243
|
+
* @minLength 1
|
|
244
|
+
* @maxLength 50
|
|
245
|
+
*/
|
|
246
|
+
name?: string;
|
|
247
|
+
/**
|
|
248
|
+
* Optional description explaining the option.
|
|
249
|
+
* @maxLength 200
|
|
250
|
+
*/
|
|
251
|
+
description?: string | null;
|
|
252
|
+
/**
|
|
253
|
+
* Available values for this option.
|
|
254
|
+
* @maxSize 100
|
|
255
|
+
*/
|
|
256
|
+
values?: OptionValue[];
|
|
257
|
+
}
|
|
258
|
+
/** A single value for a product option. */
|
|
259
|
+
interface OptionValue extends OptionValueValueOneOf {
|
|
260
|
+
/**
|
|
261
|
+
* Simple text value.
|
|
262
|
+
*
|
|
263
|
+
* For example, `"L"` for size or `"Cotton"` for material.
|
|
264
|
+
* @minLength 1
|
|
265
|
+
* @maxLength 50
|
|
266
|
+
*/
|
|
267
|
+
simpleValue?: string;
|
|
268
|
+
/** Color option with name and hex code. */
|
|
269
|
+
color?: ColorOption;
|
|
270
|
+
}
|
|
271
|
+
/** @oneof */
|
|
272
|
+
interface OptionValueValueOneOf {
|
|
273
|
+
/**
|
|
274
|
+
* Simple text value.
|
|
275
|
+
*
|
|
276
|
+
* For example, `"L"` for size or `"Cotton"` for material.
|
|
277
|
+
* @minLength 1
|
|
278
|
+
* @maxLength 50
|
|
279
|
+
*/
|
|
280
|
+
simpleValue?: string;
|
|
281
|
+
/** Color option with name and hex code. */
|
|
282
|
+
color?: ColorOption;
|
|
283
|
+
}
|
|
284
|
+
/** Color option with display name and hex color code. */
|
|
285
|
+
interface ColorOption {
|
|
286
|
+
/**
|
|
287
|
+
* Color name.
|
|
288
|
+
*
|
|
289
|
+
* For example, `"Black"` or `"Navy Blue"`.
|
|
290
|
+
* Use 'Multicolor' for mixed colors. When using 'Multicolor', do not provide a hex value.
|
|
291
|
+
* @minLength 1
|
|
292
|
+
* @maxLength 50
|
|
293
|
+
*/
|
|
294
|
+
name?: string;
|
|
295
|
+
/**
|
|
296
|
+
* Hex color code.
|
|
297
|
+
*
|
|
298
|
+
* For example, `"#000000"` for black. Omit for 'Multicolor'.
|
|
299
|
+
* @format COLOR_HEX
|
|
300
|
+
*/
|
|
301
|
+
hex?: string | null;
|
|
302
|
+
}
|
|
303
|
+
/**
|
|
304
|
+
* Time range with minimum and maximum values.
|
|
305
|
+
*
|
|
306
|
+
* Used for processing times, shipping times, and other duration ranges.
|
|
307
|
+
*/
|
|
308
|
+
interface TimeInterval {
|
|
309
|
+
/** Minimum time in the range. */
|
|
310
|
+
min?: TimeValue;
|
|
311
|
+
/** Maximum time in the range. */
|
|
312
|
+
max?: TimeValue;
|
|
313
|
+
}
|
|
314
|
+
/** Time duration with numeric value and unit. */
|
|
315
|
+
interface TimeValue {
|
|
316
|
+
/**
|
|
317
|
+
* Numeric time value. For example, `2` for "2 days".
|
|
318
|
+
* @min 1
|
|
319
|
+
*/
|
|
320
|
+
value?: number;
|
|
321
|
+
/** Time unit for the value. */
|
|
322
|
+
unit?: TimeUnitWithLiterals;
|
|
323
|
+
}
|
|
324
|
+
/** Units of time for duration values. */
|
|
325
|
+
declare enum TimeUnit {
|
|
326
|
+
/** Days. */
|
|
327
|
+
DAY = "DAY",
|
|
328
|
+
/** Weeks. */
|
|
329
|
+
WEEK = "WEEK",
|
|
330
|
+
/** Months. */
|
|
331
|
+
MONTH = "MONTH"
|
|
332
|
+
}
|
|
333
|
+
/** @enumType */
|
|
334
|
+
type TimeUnitWithLiterals = TimeUnit | 'DAY' | 'WEEK' | 'MONTH';
|
|
335
|
+
/**
|
|
336
|
+
* Shipping information for a specific destination or region.
|
|
337
|
+
*
|
|
338
|
+
* Defines where a product can be shipped and the associated costs and timing.
|
|
339
|
+
*/
|
|
340
|
+
interface ShippingDestination extends ShippingDestinationCountriesOptionsOneOf {
|
|
341
|
+
/**
|
|
342
|
+
* Specific countries.
|
|
343
|
+
*
|
|
344
|
+
* Used when `countrySelections` is `SPECIFIC_COUNTRY`.
|
|
345
|
+
*/
|
|
346
|
+
specificCountrySelections?: Countries;
|
|
347
|
+
/** Indicates if shipping applies to selected countries or to all other regions. */
|
|
348
|
+
countrySelections?: CountrySelectionsWithLiterals;
|
|
349
|
+
/**
|
|
350
|
+
* Minimum shipping cost to this destination in USD.
|
|
351
|
+
* @decimalValue options { gte:0, lte:999999999, maxScale:3 }
|
|
352
|
+
*/
|
|
353
|
+
minimumShippingCost?: string;
|
|
354
|
+
/** Expected shipping time to this destination. */
|
|
355
|
+
shippingTime?: TimeInterval;
|
|
356
|
+
/**
|
|
357
|
+
* Minimum Product Cost to the Shipping Location
|
|
358
|
+
* @decimalValue options { gte:0, lte:999999999, maxScale:3 }
|
|
359
|
+
*/
|
|
360
|
+
minimumProductCost?: string | null;
|
|
361
|
+
}
|
|
362
|
+
/** @oneof */
|
|
363
|
+
interface ShippingDestinationCountriesOptionsOneOf {
|
|
364
|
+
/**
|
|
365
|
+
* Specific countries.
|
|
366
|
+
*
|
|
367
|
+
* Used when `countrySelections` is `SPECIFIC_COUNTRY`.
|
|
368
|
+
*/
|
|
369
|
+
specificCountrySelections?: Countries;
|
|
370
|
+
}
|
|
371
|
+
/** Shipping destination selection type. */
|
|
372
|
+
declare enum CountrySelections {
|
|
373
|
+
/** All countries not specifically listed elsewhere. */
|
|
374
|
+
REST_OF_THE_WORLD = "REST_OF_THE_WORLD",
|
|
375
|
+
/** Specific countries listed in the `countries` field. */
|
|
376
|
+
SPECIFIC_COUNTRY = "SPECIFIC_COUNTRY"
|
|
377
|
+
}
|
|
378
|
+
/** @enumType */
|
|
379
|
+
type CountrySelectionsWithLiterals = CountrySelections | 'REST_OF_THE_WORLD' | 'SPECIFIC_COUNTRY';
|
|
380
|
+
interface Countries {
|
|
381
|
+
/**
|
|
382
|
+
* Country codes, in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1) format.
|
|
383
|
+
* @format COUNTRY
|
|
384
|
+
* @minSize 1
|
|
385
|
+
* @maxSize 100
|
|
386
|
+
*/
|
|
387
|
+
countries?: string[] | null;
|
|
388
|
+
}
|
|
389
|
+
/** Inventory information for a product including count tier and quantity. */
|
|
390
|
+
interface Inventory {
|
|
391
|
+
/**
|
|
392
|
+
* Abstracted inventory level calculated from quantity.
|
|
393
|
+
* @readonly
|
|
394
|
+
*/
|
|
395
|
+
tier?: InventoryTierWithLiterals;
|
|
396
|
+
/**
|
|
397
|
+
* Exact inventory quantity.
|
|
398
|
+
*
|
|
399
|
+
* Always returned when tier is `LOW` for [Get Product](https://dev.wix.com/docs/api-reference/business-solutions/suppliers-hub/products/get-product).
|
|
400
|
+
* Returned as request parameter when tier is not `LOW` for [Get Product](https://dev.wix.com/docs/api-reference/business-solutions/suppliers-hub/products/get-product).
|
|
401
|
+
* Not returned for [Search Products](https://dev.wix.com/docs/api-reference/business-solutions/suppliers-hub/products/search-products).
|
|
402
|
+
*/
|
|
403
|
+
quantity?: number | null;
|
|
404
|
+
}
|
|
405
|
+
/** Abstracted inventory levels. */
|
|
406
|
+
declare enum InventoryTier {
|
|
407
|
+
/** No inventory available. */
|
|
408
|
+
EMPTY = "EMPTY",
|
|
409
|
+
/** Low inventory level. */
|
|
410
|
+
LOW = "LOW",
|
|
411
|
+
/** Medium inventory level. */
|
|
412
|
+
MEDIUM = "MEDIUM",
|
|
413
|
+
/** High inventory level. */
|
|
414
|
+
HIGH = "HIGH"
|
|
415
|
+
}
|
|
416
|
+
/** @enumType */
|
|
417
|
+
type InventoryTierWithLiterals = InventoryTier | 'EMPTY' | 'LOW' | 'MEDIUM' | 'HIGH';
|
|
418
|
+
/** Category assignment information for a product. */
|
|
419
|
+
interface ProductCategory {
|
|
420
|
+
/**
|
|
421
|
+
* Category ID.
|
|
422
|
+
* @format GUID
|
|
423
|
+
*/
|
|
424
|
+
id?: string;
|
|
425
|
+
/**
|
|
426
|
+
* Product's position within this category.
|
|
427
|
+
* @max 200
|
|
428
|
+
* @readonly
|
|
429
|
+
*/
|
|
430
|
+
index?: number | null;
|
|
431
|
+
/** The namespace of the category tree this assignment belongs to. */
|
|
432
|
+
namespace?: CategoryNamespaceWithLiterals;
|
|
433
|
+
}
|
|
434
|
+
/** Defines the available category trees namespaces. */
|
|
435
|
+
declare enum CategoryNamespace {
|
|
436
|
+
/** Namespace for the dropshipping category tree. */
|
|
437
|
+
DROPSHIPPING_NAMESPACE = "DROPSHIPPING_NAMESPACE",
|
|
438
|
+
/** Namespace for the wholesale category tree. */
|
|
439
|
+
WHOLESALE_NAMESPACE = "WHOLESALE_NAMESPACE",
|
|
440
|
+
/** Namespace for the print on demand category tree. */
|
|
441
|
+
PRINT_ON_DEMAND_NAMESPACE = "PRINT_ON_DEMAND_NAMESPACE"
|
|
442
|
+
}
|
|
443
|
+
/** @enumType */
|
|
444
|
+
type CategoryNamespaceWithLiterals = CategoryNamespace | 'DROPSHIPPING_NAMESPACE' | 'WHOLESALE_NAMESPACE' | 'PRINT_ON_DEMAND_NAMESPACE';
|
|
445
|
+
/**
|
|
446
|
+
* Configuration for wholesale products including tiered pricing.
|
|
447
|
+
*
|
|
448
|
+
* Required when product types include `WHOLESALE`.
|
|
449
|
+
*/
|
|
450
|
+
interface WholesaleOptions {
|
|
451
|
+
/**
|
|
452
|
+
* Tiered pricing based on order quantity ranges.
|
|
453
|
+
*
|
|
454
|
+
* Price tiers must be continuous with no gaps in quantity ranges.
|
|
455
|
+
* For example, if tier 1 covers quantities 1-100, tier 2 must start at 101.
|
|
456
|
+
* The system validates tier continuity when creating or updating products.
|
|
457
|
+
* @maxSize 5
|
|
458
|
+
*/
|
|
459
|
+
priceTiers?: PriceTier[];
|
|
460
|
+
/**
|
|
461
|
+
* Minimum quantity required for wholesale orders.
|
|
462
|
+
* @min 1
|
|
463
|
+
*/
|
|
464
|
+
minimumOrderQuantity?: number | null;
|
|
465
|
+
}
|
|
466
|
+
/**
|
|
467
|
+
* Price tier with quantity range and corresponding pricing.
|
|
468
|
+
*
|
|
469
|
+
* Defines pricing for a specific quantity range in wholesale orders.
|
|
470
|
+
*/
|
|
471
|
+
interface PriceTier {
|
|
472
|
+
/**
|
|
473
|
+
* Minimum price for this quantity tier in USD.
|
|
474
|
+
*
|
|
475
|
+
* If `priceTo` isn't specified, this price applies to all quantities in the tier.
|
|
476
|
+
* @decimalValue options { gte:0, lte:999999999, maxScale:3 }
|
|
477
|
+
*/
|
|
478
|
+
priceFrom?: string;
|
|
479
|
+
/**
|
|
480
|
+
* Maximum price for this quantity tier in USD.
|
|
481
|
+
*
|
|
482
|
+
* Optional for fixed-price tiers.
|
|
483
|
+
* @decimalValue options { gte:0, lte:999999999, maxScale:3 }
|
|
484
|
+
*/
|
|
485
|
+
priceTo?: string | null;
|
|
486
|
+
/**
|
|
487
|
+
* Minimum quantity for this price tier, inclusive.
|
|
488
|
+
* @min 1
|
|
489
|
+
*/
|
|
490
|
+
countFrom?: number | null;
|
|
491
|
+
/**
|
|
492
|
+
* Maximum quantity for this price tier, inclusive.
|
|
493
|
+
*
|
|
494
|
+
* If not specified, this tier applies to all quantities greater or equal to `countFrom`.
|
|
495
|
+
* @min 1
|
|
496
|
+
*/
|
|
497
|
+
countTo?: number | null;
|
|
498
|
+
}
|
|
499
|
+
interface SupplierInfo {
|
|
500
|
+
/**
|
|
501
|
+
* Supplier ID.
|
|
502
|
+
*
|
|
503
|
+
* When provided, references a supplier in the Marketplace Supplier service.
|
|
504
|
+
* The system automatically retrieves and populates the supplier's name, rating, and verification status.
|
|
505
|
+
* @format GUID
|
|
506
|
+
*/
|
|
507
|
+
id?: string | null;
|
|
508
|
+
/**
|
|
509
|
+
* Supplier name.
|
|
510
|
+
*
|
|
511
|
+
* Automatically populated from the Supplier service when `id` is provided.
|
|
512
|
+
* @minLength 1
|
|
513
|
+
* @maxLength 200
|
|
514
|
+
* @readonly
|
|
515
|
+
*/
|
|
516
|
+
name?: string | null;
|
|
517
|
+
/**
|
|
518
|
+
* Supplier rating from 1.00 to 5.00.
|
|
519
|
+
*
|
|
520
|
+
* Automatically populated from the Supplier service when `id` is provided.
|
|
521
|
+
* @decimalValue options { gte:1, lte:5, maxScale:2 }
|
|
522
|
+
* @readonly
|
|
523
|
+
*/
|
|
524
|
+
rating?: string | null;
|
|
525
|
+
/**
|
|
526
|
+
* Whether the supplier has been verified by the Marketplace.
|
|
527
|
+
*
|
|
528
|
+
* Verified suppliers have completed the Marketplace verification process.
|
|
529
|
+
* Automatically populated from the Supplier service when `id` is provided.
|
|
530
|
+
*
|
|
531
|
+
* Default: `false`
|
|
532
|
+
* @readonly
|
|
533
|
+
*/
|
|
534
|
+
verified?: boolean;
|
|
535
|
+
}
|
|
536
|
+
interface PrintOnDemandOptions {
|
|
537
|
+
/**
|
|
538
|
+
* Set of possible print technologies for the Product
|
|
539
|
+
* @minSize 1
|
|
540
|
+
* @maxSize 3
|
|
541
|
+
*/
|
|
542
|
+
printTechnologies?: PrintTechnologyWithLiterals[];
|
|
543
|
+
/**
|
|
544
|
+
* Mockup image of the product with 'Your Image Here' text.
|
|
545
|
+
* @readonly
|
|
546
|
+
*/
|
|
547
|
+
mockupImage?: Image;
|
|
548
|
+
}
|
|
549
|
+
declare enum PrintTechnology {
|
|
550
|
+
/** Transfers printed on film and heat-pressed onto fabric. */
|
|
551
|
+
DIRECT_TO_FILM = "DIRECT_TO_FILM",
|
|
552
|
+
/** Ink directly onto garment. */
|
|
553
|
+
DIRECT_TO_GARMENT = "DIRECT_TO_GARMENT",
|
|
554
|
+
/** Panels are printed first, then sewn. All‑over coverage with precise placements. */
|
|
555
|
+
CUT_SEW_SUBLIMATION = "CUT_SEW_SUBLIMATION",
|
|
556
|
+
/** Non‑DTG digital methods (e.g., roll‑to‑roll). */
|
|
557
|
+
DIGITAL_PRINTING = "DIGITAL_PRINTING",
|
|
558
|
+
/** Stitched threads, premium look. */
|
|
559
|
+
EMBROIDERY = "EMBROIDERY",
|
|
560
|
+
/** Dye infused into polyester/poly‑coated substrates. */
|
|
561
|
+
SUBLIMATION = "SUBLIMATION",
|
|
562
|
+
/** Cures ink with UV light on rigid or treated surfaces. */
|
|
563
|
+
UV_PRINTING = "UV_PRINTING",
|
|
564
|
+
/** Pattern/design is knitted, not printed. */
|
|
565
|
+
KNITWEAR = "KNITWEAR",
|
|
566
|
+
/** Designs are printed directly onto rolls of fabric, which are then cut and sewn into the final product. */
|
|
567
|
+
DIRECT_TO_FABRIC = "DIRECT_TO_FABRIC"
|
|
568
|
+
}
|
|
569
|
+
/** @enumType */
|
|
570
|
+
type PrintTechnologyWithLiterals = PrintTechnology | 'DIRECT_TO_FILM' | 'DIRECT_TO_GARMENT' | 'CUT_SEW_SUBLIMATION' | 'DIGITAL_PRINTING' | 'EMBROIDERY' | 'SUBLIMATION' | 'UV_PRINTING' | 'KNITWEAR' | 'DIRECT_TO_FABRIC';
|
|
571
|
+
interface SizeGuide {
|
|
572
|
+
/** Sizes units (inches or cm) */
|
|
573
|
+
measurementUnit?: MeasurementUnitWithLiterals;
|
|
574
|
+
/**
|
|
575
|
+
* Text description of the size guide
|
|
576
|
+
* @maxLength 8000
|
|
577
|
+
*/
|
|
578
|
+
description?: string | null;
|
|
579
|
+
/**
|
|
580
|
+
* Image for the size guide
|
|
581
|
+
* @format WEB_URL
|
|
582
|
+
*/
|
|
583
|
+
imageUrl?: string | null;
|
|
584
|
+
/**
|
|
585
|
+
* Text description of the image content
|
|
586
|
+
* @maxLength 8000
|
|
587
|
+
*/
|
|
588
|
+
imageDescription?: string | null;
|
|
589
|
+
/**
|
|
590
|
+
* Sizes specifications
|
|
591
|
+
* @maxSize 10
|
|
592
|
+
*/
|
|
593
|
+
specifications?: Specification[];
|
|
594
|
+
}
|
|
595
|
+
declare enum MeasurementUnit {
|
|
596
|
+
CM = "CM",
|
|
597
|
+
INCHES = "INCHES"
|
|
598
|
+
}
|
|
599
|
+
/** @enumType */
|
|
600
|
+
type MeasurementUnitWithLiterals = MeasurementUnit | 'CM' | 'INCHES';
|
|
601
|
+
interface Specification {
|
|
602
|
+
/**
|
|
603
|
+
* What is measured, e.g. chest, waist, sleeve
|
|
604
|
+
* @maxLength 50
|
|
605
|
+
*/
|
|
606
|
+
category?: string;
|
|
607
|
+
/**
|
|
608
|
+
* Measurements for different sizes
|
|
609
|
+
* @minSize 1
|
|
610
|
+
* @maxSize 50
|
|
611
|
+
*/
|
|
612
|
+
measurements?: Measurement[];
|
|
613
|
+
}
|
|
614
|
+
interface Measurement extends MeasurementValueOneOf {
|
|
615
|
+
/**
|
|
616
|
+
* The value of the size in case of single value
|
|
617
|
+
* @minLength 1
|
|
618
|
+
* @maxLength 50
|
|
619
|
+
*/
|
|
620
|
+
singleValue?: string;
|
|
621
|
+
/** The value of the size in case of range (min/max) */
|
|
622
|
+
range?: MeasurementValueRange;
|
|
623
|
+
/**
|
|
624
|
+
* Product size, e.g. S, M, L
|
|
625
|
+
* @maxLength 50
|
|
626
|
+
*/
|
|
627
|
+
sizeLabel?: string;
|
|
628
|
+
}
|
|
629
|
+
/** @oneof */
|
|
630
|
+
interface MeasurementValueOneOf {
|
|
631
|
+
/**
|
|
632
|
+
* The value of the size in case of single value
|
|
633
|
+
* @minLength 1
|
|
634
|
+
* @maxLength 50
|
|
635
|
+
*/
|
|
636
|
+
singleValue?: string;
|
|
637
|
+
/** The value of the size in case of range (min/max) */
|
|
638
|
+
range?: MeasurementValueRange;
|
|
639
|
+
}
|
|
640
|
+
interface MeasurementValueRange {
|
|
641
|
+
/**
|
|
642
|
+
* Minimum value
|
|
643
|
+
* @minLength 1
|
|
644
|
+
* @maxLength 50
|
|
645
|
+
*/
|
|
646
|
+
minimum?: string;
|
|
647
|
+
/**
|
|
648
|
+
* Maximum value
|
|
649
|
+
* @minLength 1
|
|
650
|
+
* @maxLength 50
|
|
651
|
+
*/
|
|
652
|
+
maximum?: string;
|
|
653
|
+
}
|
|
654
|
+
/**
|
|
655
|
+
* Common object for tags.
|
|
656
|
+
* Should be use as in this example:
|
|
657
|
+
* message Foo {
|
|
658
|
+
* option (.wix.api.decomposite_of) = "wix.commons.v2.tags.Foo";
|
|
659
|
+
* string id = 1;
|
|
660
|
+
* ...
|
|
661
|
+
* Tags tags = 5
|
|
662
|
+
* }
|
|
663
|
+
*
|
|
664
|
+
* example of taggable entity
|
|
665
|
+
* {
|
|
666
|
+
* id: "123"
|
|
667
|
+
* tags: {
|
|
668
|
+
* public_tags: {
|
|
669
|
+
* tag_ids:["11","22"]
|
|
670
|
+
* },
|
|
671
|
+
* private_tags: {
|
|
672
|
+
* tag_ids: ["33", "44"]
|
|
673
|
+
* }
|
|
674
|
+
* }
|
|
675
|
+
* }
|
|
676
|
+
*/
|
|
677
|
+
interface Tags {
|
|
678
|
+
/** Tags that require an additional permission in order to access them, normally not given to site members or visitors. */
|
|
679
|
+
privateTags?: TagList;
|
|
680
|
+
/** Tags that are exposed to anyone who has access to the labeled entity itself, including site members and visitors. */
|
|
681
|
+
publicTags?: TagList;
|
|
682
|
+
}
|
|
683
|
+
interface TagList {
|
|
684
|
+
/**
|
|
685
|
+
* List of tag IDs.
|
|
686
|
+
* @maxSize 100
|
|
687
|
+
* @maxLength 5
|
|
688
|
+
*/
|
|
689
|
+
tagIds?: string[];
|
|
690
|
+
}
|
|
691
|
+
/**
|
|
692
|
+
* Event payload for product tag modifications.
|
|
693
|
+
*
|
|
694
|
+
* Triggered when product tags are updated via bulk tag operations.
|
|
695
|
+
*/
|
|
696
|
+
interface TagsModified {
|
|
697
|
+
/** Product with updated tags. */
|
|
698
|
+
product?: Product;
|
|
699
|
+
/** Tags that were added to the product. */
|
|
700
|
+
assignedTags?: Tags;
|
|
701
|
+
/** Tags that were removed from the product. */
|
|
702
|
+
unassignedTags?: Tags;
|
|
703
|
+
}
|
|
704
|
+
interface CreateProductRequest {
|
|
705
|
+
/** Product to create. Must include all required fields for the specified product types. */
|
|
706
|
+
product: Product;
|
|
707
|
+
}
|
|
708
|
+
interface CreateProductResponse {
|
|
709
|
+
/** Created product with assigned ID and read-only fields populated. */
|
|
710
|
+
product?: Product;
|
|
711
|
+
}
|
|
712
|
+
interface GetProductRequest {
|
|
713
|
+
/**
|
|
714
|
+
* Product ID.
|
|
715
|
+
* @format GUID
|
|
716
|
+
*/
|
|
717
|
+
productId: string;
|
|
718
|
+
}
|
|
719
|
+
/** Additional fields that can be requested in API responses. */
|
|
720
|
+
declare enum RequestedField {
|
|
721
|
+
/** Include exact inventory quantity in the response. */
|
|
722
|
+
INVENTORY_QUANTITY = "INVENTORY_QUANTITY"
|
|
723
|
+
}
|
|
724
|
+
/** @enumType */
|
|
725
|
+
type RequestedFieldWithLiterals = RequestedField | 'INVENTORY_QUANTITY';
|
|
726
|
+
interface GetProductResponse {
|
|
727
|
+
/** Retrieved product. */
|
|
728
|
+
product?: Product;
|
|
729
|
+
}
|
|
730
|
+
interface UpdateProductRequest {
|
|
731
|
+
/** Product to update. May be partial - only fields to be updated need to be provided. */
|
|
732
|
+
product: Product;
|
|
733
|
+
}
|
|
734
|
+
interface UpdateProductResponse {
|
|
735
|
+
/** Updated product. */
|
|
736
|
+
product?: Product;
|
|
737
|
+
}
|
|
738
|
+
interface DeleteProductRequest {
|
|
739
|
+
/**
|
|
740
|
+
* Product ID.
|
|
741
|
+
* @format GUID
|
|
742
|
+
*/
|
|
743
|
+
productId: string;
|
|
744
|
+
}
|
|
745
|
+
interface DeleteProductResponse {
|
|
746
|
+
}
|
|
747
|
+
interface BulkCreateProductsRequest {
|
|
748
|
+
/**
|
|
749
|
+
* Products to create. Each must include all required fields for the specified product types.
|
|
750
|
+
* @minSize 1
|
|
751
|
+
* @maxSize 100
|
|
752
|
+
*/
|
|
753
|
+
products: Product[];
|
|
754
|
+
/**
|
|
755
|
+
* Whether to return the created products in the response.
|
|
756
|
+
*
|
|
757
|
+
* Default: `false`
|
|
758
|
+
*/
|
|
759
|
+
returnEntity?: boolean;
|
|
760
|
+
}
|
|
761
|
+
interface BulkCreateProductsResponse {
|
|
762
|
+
/**
|
|
763
|
+
* Results of the bulk create operation, one per input product.
|
|
764
|
+
* @minSize 1
|
|
765
|
+
* @maxSize 100
|
|
766
|
+
*/
|
|
767
|
+
results?: BulkProductResult[];
|
|
768
|
+
/** Metadata about the bulk operation including success and failure counts. */
|
|
769
|
+
bulkActionMetadata?: BulkActionMetadata;
|
|
770
|
+
}
|
|
771
|
+
interface ItemMetadata {
|
|
772
|
+
/**
|
|
773
|
+
* Item ID. Should always be available, unless it's impossible. For example, when failing to create an item.
|
|
774
|
+
* @format GUID
|
|
775
|
+
*/
|
|
776
|
+
id?: string | null;
|
|
777
|
+
/** Index of the item within the request array. Allows for correlation between request and response items. */
|
|
778
|
+
originalIndex?: number;
|
|
779
|
+
/** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
|
|
780
|
+
success?: boolean;
|
|
781
|
+
/** Details about the error in case of failure. */
|
|
782
|
+
error?: ApplicationError;
|
|
783
|
+
}
|
|
784
|
+
interface ApplicationError {
|
|
785
|
+
/** Error code. */
|
|
786
|
+
code?: string;
|
|
787
|
+
/** Description of the error. */
|
|
788
|
+
description?: string;
|
|
789
|
+
/** Data related to the error. */
|
|
790
|
+
data?: Record<string, any> | null;
|
|
791
|
+
}
|
|
792
|
+
interface BulkProductResult {
|
|
793
|
+
/** Metadata regarding the specific single create operation */
|
|
794
|
+
itemMetadata?: ItemMetadata;
|
|
795
|
+
/** Only exists if `returnEntity` was set to true in the request */
|
|
796
|
+
item?: Product;
|
|
797
|
+
}
|
|
798
|
+
interface BulkActionMetadata {
|
|
799
|
+
/** Number of items that were successfully processed. */
|
|
800
|
+
totalSuccesses?: number;
|
|
801
|
+
/** Number of items that couldn't be processed. */
|
|
802
|
+
totalFailures?: number;
|
|
803
|
+
/** Number of failures without details because detailed failure threshold was exceeded. */
|
|
804
|
+
undetailedFailures?: number;
|
|
805
|
+
}
|
|
806
|
+
interface BulkUpdateProductsRequest {
|
|
807
|
+
/**
|
|
808
|
+
* Products to update. Each can be partial based on its field mask.
|
|
809
|
+
* @minSize 1
|
|
810
|
+
* @maxSize 100
|
|
811
|
+
*/
|
|
812
|
+
products: MaskedProduct[];
|
|
813
|
+
/**
|
|
814
|
+
* Whether to return the updated products in the response.
|
|
815
|
+
*
|
|
816
|
+
* Default: `false`
|
|
817
|
+
*/
|
|
818
|
+
returnEntity?: boolean;
|
|
819
|
+
}
|
|
820
|
+
interface MaskedProduct {
|
|
821
|
+
/** Product to update. May be partial - only fields to be updated need to be provided. */
|
|
822
|
+
product?: Product;
|
|
823
|
+
}
|
|
824
|
+
interface BulkUpdateProductsResponse {
|
|
825
|
+
/**
|
|
826
|
+
* Results
|
|
827
|
+
* @minSize 1
|
|
828
|
+
* @maxSize 100
|
|
829
|
+
*/
|
|
830
|
+
results?: BulkUpdateProductsResponseBulkProductResult[];
|
|
831
|
+
/** Metadata regarding the bulk update operation */
|
|
832
|
+
bulkActionMetadata?: BulkActionMetadata;
|
|
833
|
+
}
|
|
834
|
+
interface BulkUpdateProductsResponseBulkProductResult {
|
|
835
|
+
/** Metadata regarding the specific single update operation */
|
|
836
|
+
itemMetadata?: ItemMetadata;
|
|
837
|
+
/** Only exists if `returnEntity` was set to true in the request */
|
|
838
|
+
item?: Product;
|
|
839
|
+
}
|
|
840
|
+
interface BulkDeleteProductsRequest {
|
|
841
|
+
/**
|
|
842
|
+
* Product IDs to delete.
|
|
843
|
+
* @minSize 1
|
|
844
|
+
* @maxSize 100
|
|
845
|
+
* @format GUID
|
|
846
|
+
*/
|
|
847
|
+
productIds: string[];
|
|
848
|
+
}
|
|
849
|
+
interface BulkDeleteProductsResponse {
|
|
850
|
+
/**
|
|
851
|
+
* Results
|
|
852
|
+
* @minSize 1
|
|
853
|
+
* @maxSize 100
|
|
854
|
+
*/
|
|
855
|
+
results?: BulkDeleteProductsResponseBulkProductResult[];
|
|
856
|
+
/** Metadata regarding the bulk delete operation */
|
|
857
|
+
bulkActionMetadata?: BulkActionMetadata;
|
|
858
|
+
}
|
|
859
|
+
interface BulkDeleteProductsResponseBulkProductResult {
|
|
860
|
+
/** Metadata regarding the specific single delete operation */
|
|
861
|
+
itemMetadata?: ItemMetadata;
|
|
862
|
+
}
|
|
863
|
+
interface QueryProductsRequest {
|
|
864
|
+
/** Query parameters including filter, sort, and paging options. */
|
|
865
|
+
query?: CommonCursorQuery;
|
|
866
|
+
}
|
|
867
|
+
interface CommonCursorQuery extends CommonCursorQueryPagingMethodOneOf {
|
|
868
|
+
/** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
|
|
869
|
+
cursorPaging?: CommonCursorPaging;
|
|
870
|
+
/**
|
|
871
|
+
* Filter object in the following format:
|
|
872
|
+
* `"filter" : {
|
|
873
|
+
* "fieldName1": "value1",
|
|
874
|
+
* "fieldName2":{"$operator":"value2"}
|
|
875
|
+
* }`
|
|
876
|
+
* Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
|
|
877
|
+
*/
|
|
878
|
+
filter?: Record<string, any> | null;
|
|
879
|
+
/**
|
|
880
|
+
* Sort object in the following format:
|
|
881
|
+
* `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
|
|
882
|
+
* @maxSize 5
|
|
883
|
+
*/
|
|
884
|
+
sort?: CommonSorting[];
|
|
885
|
+
}
|
|
886
|
+
/** @oneof */
|
|
887
|
+
interface CommonCursorQueryPagingMethodOneOf {
|
|
888
|
+
/** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
|
|
889
|
+
cursorPaging?: CommonCursorPaging;
|
|
890
|
+
}
|
|
891
|
+
interface CommonSorting {
|
|
892
|
+
/**
|
|
893
|
+
* Name of the field to sort by.
|
|
894
|
+
* @maxLength 512
|
|
895
|
+
*/
|
|
896
|
+
fieldName?: string;
|
|
897
|
+
/** Sort order. */
|
|
898
|
+
order?: CommonSortOrderWithLiterals;
|
|
899
|
+
/**
|
|
900
|
+
* Filters to specify which element to use for sorting when `fieldName` refers to a repeated field marked as `MATCH_ITEMS`.
|
|
901
|
+
*
|
|
902
|
+
* These filters ensure the correct element is selected from the collection for sorting. Multiple filters are combined using the `AND` operator.
|
|
903
|
+
*
|
|
904
|
+
* For example, for a document like `{"id": "1", "nestedField": [{"price": 10, "region": "EU"}, {"price": 20, "region": "US"}]}`,
|
|
905
|
+
* if `nestedField` is marked as `MATCH_ITEMS`, sorting by price in the US region requires:
|
|
906
|
+
* `{fieldName: "nestedField.price", "selectItemsBy": [{"nestedField.region": "US"}]}`.
|
|
907
|
+
* @maxSize 10
|
|
908
|
+
*/
|
|
909
|
+
selectItemsBy?: Record<string, any>[] | null;
|
|
910
|
+
}
|
|
911
|
+
declare enum CommonSortOrder {
|
|
912
|
+
ASC = "ASC",
|
|
913
|
+
DESC = "DESC"
|
|
914
|
+
}
|
|
915
|
+
/** @enumType */
|
|
916
|
+
type CommonSortOrderWithLiterals = CommonSortOrder | 'ASC' | 'DESC';
|
|
917
|
+
interface CommonCursorPaging {
|
|
918
|
+
/**
|
|
919
|
+
* Maximum number of items to return in the results.
|
|
920
|
+
* @max 100
|
|
921
|
+
*/
|
|
922
|
+
limit?: number | null;
|
|
923
|
+
/**
|
|
924
|
+
* Pointer to the next or previous page in the list of results.
|
|
925
|
+
*
|
|
926
|
+
* Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
|
|
927
|
+
* Not relevant for the first request.
|
|
928
|
+
* @maxLength 16000
|
|
929
|
+
*/
|
|
930
|
+
cursor?: string | null;
|
|
931
|
+
}
|
|
932
|
+
interface QueryProductsResponse {
|
|
933
|
+
/** Products matching the query. */
|
|
934
|
+
products?: Product[];
|
|
935
|
+
/** Paging information for retrieving additional results. */
|
|
936
|
+
pagingMetadata?: CommonCursorPagingMetadata;
|
|
937
|
+
}
|
|
938
|
+
interface CommonCursorPagingMetadata {
|
|
939
|
+
/** Number of items returned in the response. */
|
|
940
|
+
count?: number | null;
|
|
941
|
+
/** Cursor strings that point to the next page, previous page, or both. */
|
|
942
|
+
cursors?: CommonCursors;
|
|
943
|
+
/**
|
|
944
|
+
* Whether there are more pages to retrieve following the current page.
|
|
945
|
+
*
|
|
946
|
+
* + `true`: Another page of results can be retrieved.
|
|
947
|
+
* + `false`: This is the last page.
|
|
948
|
+
*/
|
|
949
|
+
hasNext?: boolean | null;
|
|
950
|
+
}
|
|
951
|
+
interface CommonCursors {
|
|
952
|
+
/**
|
|
953
|
+
* Cursor string pointing to the next page in the list of results.
|
|
954
|
+
* @maxLength 16000
|
|
955
|
+
*/
|
|
956
|
+
next?: string | null;
|
|
957
|
+
/**
|
|
958
|
+
* Cursor pointing to the previous page in the list of results.
|
|
959
|
+
* @maxLength 16000
|
|
960
|
+
*/
|
|
961
|
+
prev?: string | null;
|
|
962
|
+
}
|
|
963
|
+
interface SearchProductsRequest {
|
|
964
|
+
/** Search parameters including filter, sort, full-text search, and aggregations. */
|
|
965
|
+
search?: CursorSearch;
|
|
966
|
+
}
|
|
967
|
+
interface CursorSearch extends CursorSearchPagingMethodOneOf {
|
|
968
|
+
/**
|
|
969
|
+
* Cursor pointing to page of results.
|
|
970
|
+
* When requesting 'cursor_paging.cursor', no `filter`, `sort` or `search` can be provided.
|
|
971
|
+
*/
|
|
972
|
+
cursorPaging?: CommonCursorPaging;
|
|
973
|
+
/** A filter object. See documentation [here](https://bo.wix.com/wix-docs/rnd/platformization-guidelines/api-query-language#platformization-guidelines_api-query-language_defining-in-protobuf) */
|
|
974
|
+
filter?: Record<string, any> | null;
|
|
975
|
+
/**
|
|
976
|
+
* Sort object in the form [{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]
|
|
977
|
+
* @maxSize 10
|
|
978
|
+
*/
|
|
979
|
+
sort?: CommonSorting[];
|
|
980
|
+
/**
|
|
981
|
+
* Aggregations | Faceted search: refers to a way to explore large amounts of data by displaying summaries about various partitions of the data and later allowing to narrow the navigation to a specific partition.
|
|
982
|
+
* @maxSize 10
|
|
983
|
+
*/
|
|
984
|
+
aggregations?: Aggregation[];
|
|
985
|
+
/** Free text to match in searchable fields */
|
|
986
|
+
search?: SearchDetails;
|
|
987
|
+
/**
|
|
988
|
+
* UTC offset or IANA time zone. Valid values are
|
|
989
|
+
* ISO 8601 UTC offsets, such as +02:00 or -06:00,
|
|
990
|
+
* and IANA time zone IDs, such as Europe/Rome
|
|
991
|
+
*
|
|
992
|
+
* Affects all filters and aggregations returned values.
|
|
993
|
+
* You may override this behavior in a specific filter by providing
|
|
994
|
+
* timestamps including time zone. e.g. `"2023-12-20T10:52:34.795Z"`
|
|
995
|
+
* @maxLength 50
|
|
996
|
+
*/
|
|
997
|
+
timeZone?: string | null;
|
|
998
|
+
}
|
|
999
|
+
/** @oneof */
|
|
1000
|
+
interface CursorSearchPagingMethodOneOf {
|
|
1001
|
+
/**
|
|
1002
|
+
* Cursor pointing to page of results.
|
|
1003
|
+
* When requesting 'cursor_paging.cursor', no `filter`, `sort` or `search` can be provided.
|
|
1004
|
+
*/
|
|
1005
|
+
cursorPaging?: CommonCursorPaging;
|
|
1006
|
+
}
|
|
1007
|
+
interface Aggregation extends AggregationKindOneOf {
|
|
1008
|
+
/** Value aggregation */
|
|
1009
|
+
value?: ValueAggregation;
|
|
1010
|
+
/** Range aggregation */
|
|
1011
|
+
range?: RangeAggregation;
|
|
1012
|
+
/** Scalar aggregation */
|
|
1013
|
+
scalar?: ScalarAggregation;
|
|
1014
|
+
/** Date histogram aggregation */
|
|
1015
|
+
dateHistogram?: DateHistogramAggregation;
|
|
1016
|
+
/** Nested aggregation */
|
|
1017
|
+
nested?: NestedAggregation;
|
|
1018
|
+
/**
|
|
1019
|
+
* User-defined name of aggregation, should be unique, will appear in aggregation results
|
|
1020
|
+
* @maxLength 100
|
|
1021
|
+
*/
|
|
1022
|
+
name?: string | null;
|
|
1023
|
+
/** Type of aggregation, client must provide matching aggregation field below */
|
|
1024
|
+
type?: AggregationTypeWithLiterals;
|
|
1025
|
+
/**
|
|
1026
|
+
* Field to aggregate by, use dot notation to specify json path
|
|
1027
|
+
* @maxLength 200
|
|
1028
|
+
*/
|
|
1029
|
+
fieldPath?: string;
|
|
1030
|
+
}
|
|
1031
|
+
/** @oneof */
|
|
1032
|
+
interface AggregationKindOneOf {
|
|
1033
|
+
/** Value aggregation */
|
|
1034
|
+
value?: ValueAggregation;
|
|
1035
|
+
/** Range aggregation */
|
|
1036
|
+
range?: RangeAggregation;
|
|
1037
|
+
/** Scalar aggregation */
|
|
1038
|
+
scalar?: ScalarAggregation;
|
|
1039
|
+
/** Date histogram aggregation */
|
|
1040
|
+
dateHistogram?: DateHistogramAggregation;
|
|
1041
|
+
/** Nested aggregation */
|
|
1042
|
+
nested?: NestedAggregation;
|
|
1043
|
+
}
|
|
1044
|
+
interface RangeBucket {
|
|
1045
|
+
/** Inclusive lower bound of the range. Required if to is not given */
|
|
1046
|
+
from?: number | null;
|
|
1047
|
+
/** Exclusive upper bound of the range. Required if from is not given */
|
|
1048
|
+
to?: number | null;
|
|
1049
|
+
}
|
|
1050
|
+
declare enum SortType {
|
|
1051
|
+
/** Should sort by number of matches */
|
|
1052
|
+
COUNT = "COUNT",
|
|
1053
|
+
/** Should sort by value of the field alphabetically */
|
|
1054
|
+
VALUE = "VALUE"
|
|
1055
|
+
}
|
|
1056
|
+
/** @enumType */
|
|
1057
|
+
type SortTypeWithLiterals = SortType | 'COUNT' | 'VALUE';
|
|
1058
|
+
declare enum SortDirection {
|
|
1059
|
+
/** Should sort in descending order */
|
|
1060
|
+
DESC = "DESC",
|
|
1061
|
+
/** Should sort in ascending order */
|
|
1062
|
+
ASC = "ASC"
|
|
1063
|
+
}
|
|
1064
|
+
/** @enumType */
|
|
1065
|
+
type SortDirectionWithLiterals = SortDirection | 'DESC' | 'ASC';
|
|
1066
|
+
declare enum MissingValues {
|
|
1067
|
+
/** Should missing values be excluded from the aggregation results */
|
|
1068
|
+
EXCLUDE = "EXCLUDE",
|
|
1069
|
+
/** Should missing values be included in the aggregation results */
|
|
1070
|
+
INCLUDE = "INCLUDE"
|
|
1071
|
+
}
|
|
1072
|
+
/** @enumType */
|
|
1073
|
+
type MissingValuesWithLiterals = MissingValues | 'EXCLUDE' | 'INCLUDE';
|
|
1074
|
+
interface IncludeMissingValuesOptions {
|
|
1075
|
+
/**
|
|
1076
|
+
* Can specify custom bucket name. Defaults are [string -> "N/A"], [int -> "0"], [bool -> "false"] ...
|
|
1077
|
+
* @maxLength 20
|
|
1078
|
+
*/
|
|
1079
|
+
addToBucket?: string;
|
|
1080
|
+
}
|
|
1081
|
+
declare enum ScalarType {
|
|
1082
|
+
/** Count of distinct values */
|
|
1083
|
+
COUNT_DISTINCT = "COUNT_DISTINCT",
|
|
1084
|
+
/** Minimum value */
|
|
1085
|
+
MIN = "MIN",
|
|
1086
|
+
/** Maximum value */
|
|
1087
|
+
MAX = "MAX"
|
|
1088
|
+
}
|
|
1089
|
+
/** @enumType */
|
|
1090
|
+
type ScalarTypeWithLiterals = ScalarType | 'COUNT_DISTINCT' | 'MIN' | 'MAX';
|
|
1091
|
+
interface ValueAggregation extends ValueAggregationOptionsOneOf {
|
|
1092
|
+
/** Options for including missing values */
|
|
1093
|
+
includeOptions?: IncludeMissingValuesOptions;
|
|
1094
|
+
/** Should sort by number of matches or value of the field */
|
|
1095
|
+
sortType?: SortTypeWithLiterals;
|
|
1096
|
+
/** Should sort in ascending or descending order */
|
|
1097
|
+
sortDirection?: SortDirectionWithLiterals;
|
|
1098
|
+
/** How many aggregations would you like to return? Can be between 1 and 250. 10 is the default. */
|
|
1099
|
+
limit?: number | null;
|
|
1100
|
+
/** Should missing values be included or excluded from the aggregation results. Default is EXCLUDE */
|
|
1101
|
+
missingValues?: MissingValuesWithLiterals;
|
|
1102
|
+
}
|
|
1103
|
+
/** @oneof */
|
|
1104
|
+
interface ValueAggregationOptionsOneOf {
|
|
1105
|
+
/** Options for including missing values */
|
|
1106
|
+
includeOptions?: IncludeMissingValuesOptions;
|
|
1107
|
+
}
|
|
1108
|
+
declare enum NestedAggregationType {
|
|
1109
|
+
/** An aggregation where result buckets are dynamically built - one per unique value */
|
|
1110
|
+
VALUE = "VALUE",
|
|
1111
|
+
/** An aggregation, where user can define set of ranges - each representing a bucket */
|
|
1112
|
+
RANGE = "RANGE",
|
|
1113
|
+
/** A single-value metric aggregation - e.g. min, max, sum, avg */
|
|
1114
|
+
SCALAR = "SCALAR",
|
|
1115
|
+
/** An aggregation, where result buckets are dynamically built - one per time interval (hour, day, week, etc.) */
|
|
1116
|
+
DATE_HISTOGRAM = "DATE_HISTOGRAM"
|
|
1117
|
+
}
|
|
1118
|
+
/** @enumType */
|
|
1119
|
+
type NestedAggregationTypeWithLiterals = NestedAggregationType | 'VALUE' | 'RANGE' | 'SCALAR' | 'DATE_HISTOGRAM';
|
|
1120
|
+
interface RangeAggregation {
|
|
1121
|
+
/**
|
|
1122
|
+
* List of range buckets, where during aggregation each entity will be placed in the first bucket where its value falls into based on provided range bounds
|
|
1123
|
+
* @maxSize 50
|
|
1124
|
+
*/
|
|
1125
|
+
buckets?: RangeBucket[];
|
|
1126
|
+
}
|
|
1127
|
+
interface ScalarAggregation {
|
|
1128
|
+
/** Define the operator for the scalar aggregation */
|
|
1129
|
+
type?: ScalarTypeWithLiterals;
|
|
1130
|
+
}
|
|
1131
|
+
interface DateHistogramAggregation {
|
|
1132
|
+
/** Interval for date histogram aggregation */
|
|
1133
|
+
interval?: IntervalWithLiterals;
|
|
1134
|
+
}
|
|
1135
|
+
declare enum Interval {
|
|
1136
|
+
/** Yearly interval */
|
|
1137
|
+
YEAR = "YEAR",
|
|
1138
|
+
/** Monthly interval */
|
|
1139
|
+
MONTH = "MONTH",
|
|
1140
|
+
/** Weekly interval */
|
|
1141
|
+
WEEK = "WEEK",
|
|
1142
|
+
/** Daily interval */
|
|
1143
|
+
DAY = "DAY",
|
|
1144
|
+
/** Hourly interval */
|
|
1145
|
+
HOUR = "HOUR",
|
|
1146
|
+
/** Minute interval */
|
|
1147
|
+
MINUTE = "MINUTE",
|
|
1148
|
+
/** Second interval */
|
|
1149
|
+
SECOND = "SECOND"
|
|
1150
|
+
}
|
|
1151
|
+
/** @enumType */
|
|
1152
|
+
type IntervalWithLiterals = Interval | 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND';
|
|
1153
|
+
interface NestedAggregationItem extends NestedAggregationItemKindOneOf {
|
|
1154
|
+
/** Value aggregation */
|
|
1155
|
+
value?: ValueAggregation;
|
|
1156
|
+
/** Range aggregation */
|
|
1157
|
+
range?: RangeAggregation;
|
|
1158
|
+
/** Scalar aggregation */
|
|
1159
|
+
scalar?: ScalarAggregation;
|
|
1160
|
+
/** Date histogram aggregation */
|
|
1161
|
+
dateHistogram?: DateHistogramAggregation;
|
|
1162
|
+
/**
|
|
1163
|
+
* User-defined name of aggregation, should be unique, will appear in aggregation results
|
|
1164
|
+
* @maxLength 100
|
|
1165
|
+
*/
|
|
1166
|
+
name?: string | null;
|
|
1167
|
+
/** Type of aggregation, client must provide matching aggregation field below */
|
|
1168
|
+
type?: NestedAggregationTypeWithLiterals;
|
|
1169
|
+
/**
|
|
1170
|
+
* Field to aggregate by, use dont notation to specify json path
|
|
1171
|
+
* @maxLength 200
|
|
1172
|
+
*/
|
|
1173
|
+
fieldPath?: string;
|
|
1174
|
+
}
|
|
1175
|
+
/** @oneof */
|
|
1176
|
+
interface NestedAggregationItemKindOneOf {
|
|
1177
|
+
/** Value aggregation */
|
|
1178
|
+
value?: ValueAggregation;
|
|
1179
|
+
/** Range aggregation */
|
|
1180
|
+
range?: RangeAggregation;
|
|
1181
|
+
/** Scalar aggregation */
|
|
1182
|
+
scalar?: ScalarAggregation;
|
|
1183
|
+
/** Date histogram aggregation */
|
|
1184
|
+
dateHistogram?: DateHistogramAggregation;
|
|
1185
|
+
}
|
|
1186
|
+
declare enum AggregationType {
|
|
1187
|
+
/** An aggregation where result buckets are dynamically built - one per unique value */
|
|
1188
|
+
VALUE = "VALUE",
|
|
1189
|
+
/** An aggregation, where user can define set of ranges - each representing a bucket */
|
|
1190
|
+
RANGE = "RANGE",
|
|
1191
|
+
/** A single-value metric aggregation - e.g. min, max, sum, avg */
|
|
1192
|
+
SCALAR = "SCALAR",
|
|
1193
|
+
/** An aggregation, where result buckets are dynamically built - one per time interval (hour, day, week, etc.) */
|
|
1194
|
+
DATE_HISTOGRAM = "DATE_HISTOGRAM",
|
|
1195
|
+
/** Multi-level aggregation, where each next aggregation is nested within previous one */
|
|
1196
|
+
NESTED = "NESTED"
|
|
1197
|
+
}
|
|
1198
|
+
/** @enumType */
|
|
1199
|
+
type AggregationTypeWithLiterals = AggregationType | 'VALUE' | 'RANGE' | 'SCALAR' | 'DATE_HISTOGRAM' | 'NESTED';
|
|
1200
|
+
/** Nested aggregation expressed through a list of aggregation where each next aggregation is nested within previous one */
|
|
1201
|
+
interface NestedAggregation {
|
|
1202
|
+
/**
|
|
1203
|
+
* Flattened list of aggregations, where each next aggregation is nested within previous one
|
|
1204
|
+
* @minSize 2
|
|
1205
|
+
* @maxSize 3
|
|
1206
|
+
*/
|
|
1207
|
+
nestedAggregations?: NestedAggregationItem[];
|
|
1208
|
+
}
|
|
1209
|
+
interface SearchDetails {
|
|
1210
|
+
/**
|
|
1211
|
+
* Search term or expression
|
|
1212
|
+
* @maxLength 100
|
|
1213
|
+
*/
|
|
1214
|
+
expression?: string | null;
|
|
1215
|
+
}
|
|
1216
|
+
declare enum Mode {
|
|
1217
|
+
/** Any of the search terms must be present */
|
|
1218
|
+
OR = "OR",
|
|
1219
|
+
/** All search terms must be present */
|
|
1220
|
+
AND = "AND"
|
|
1221
|
+
}
|
|
1222
|
+
/** @enumType */
|
|
1223
|
+
type ModeWithLiterals = Mode | 'OR' | 'AND';
|
|
1224
|
+
interface SearchProductsResponse {
|
|
1225
|
+
/** Products matching the search criteria. */
|
|
1226
|
+
products?: Product[];
|
|
1227
|
+
/** Paging information for retrieving additional results. */
|
|
1228
|
+
pagingMetadata?: CommonCursorPagingMetadata;
|
|
1229
|
+
/** Aggregation results for faceted search. */
|
|
1230
|
+
aggregationData?: AggregationData;
|
|
1231
|
+
}
|
|
1232
|
+
interface AggregationData {
|
|
1233
|
+
/**
|
|
1234
|
+
* key = aggregation name (as derived from search request)
|
|
1235
|
+
* @maxSize 10000
|
|
1236
|
+
*/
|
|
1237
|
+
results?: AggregationResults[];
|
|
1238
|
+
}
|
|
1239
|
+
interface ValueAggregationResult {
|
|
1240
|
+
/**
|
|
1241
|
+
* Value of the field
|
|
1242
|
+
* @maxLength 100
|
|
1243
|
+
*/
|
|
1244
|
+
value?: string;
|
|
1245
|
+
/** Count of entities with this value */
|
|
1246
|
+
count?: number;
|
|
1247
|
+
}
|
|
1248
|
+
interface RangeAggregationResult {
|
|
1249
|
+
/** Inclusive lower bound of the range */
|
|
1250
|
+
from?: number | null;
|
|
1251
|
+
/** Exclusive upper bound of the range */
|
|
1252
|
+
to?: number | null;
|
|
1253
|
+
/** Count of entities in this range */
|
|
1254
|
+
count?: number;
|
|
1255
|
+
}
|
|
1256
|
+
interface NestedAggregationResults extends NestedAggregationResultsResultOneOf {
|
|
1257
|
+
/** Value aggregation results */
|
|
1258
|
+
values?: ValueResults;
|
|
1259
|
+
/** Range aggregation results */
|
|
1260
|
+
ranges?: RangeResults;
|
|
1261
|
+
/** Scalar aggregation results */
|
|
1262
|
+
scalar?: AggregationResultsScalarResult;
|
|
1263
|
+
/**
|
|
1264
|
+
* User-defined name of aggregation, matches the one provided in request
|
|
1265
|
+
* @maxLength 100
|
|
1266
|
+
*/
|
|
1267
|
+
name?: string;
|
|
1268
|
+
/** Type of aggregation that matches result */
|
|
1269
|
+
type?: AggregationTypeWithLiterals;
|
|
1270
|
+
/**
|
|
1271
|
+
* Field to aggregate by, matches the one provided in request
|
|
1272
|
+
* @maxLength 200
|
|
1273
|
+
*/
|
|
1274
|
+
fieldPath?: string;
|
|
1275
|
+
}
|
|
1276
|
+
/** @oneof */
|
|
1277
|
+
interface NestedAggregationResultsResultOneOf {
|
|
1278
|
+
/** Value aggregation results */
|
|
1279
|
+
values?: ValueResults;
|
|
1280
|
+
/** Range aggregation results */
|
|
1281
|
+
ranges?: RangeResults;
|
|
1282
|
+
/** Scalar aggregation results */
|
|
1283
|
+
scalar?: AggregationResultsScalarResult;
|
|
1284
|
+
}
|
|
1285
|
+
interface ValueResults {
|
|
1286
|
+
/**
|
|
1287
|
+
* List of value aggregations
|
|
1288
|
+
* @maxSize 250
|
|
1289
|
+
*/
|
|
1290
|
+
results?: ValueAggregationResult[];
|
|
1291
|
+
}
|
|
1292
|
+
interface RangeResults {
|
|
1293
|
+
/**
|
|
1294
|
+
* List of ranges returned in same order as requested
|
|
1295
|
+
* @maxSize 50
|
|
1296
|
+
*/
|
|
1297
|
+
results?: RangeAggregationResult[];
|
|
1298
|
+
}
|
|
1299
|
+
interface AggregationResultsScalarResult {
|
|
1300
|
+
/** Type of scalar aggregation */
|
|
1301
|
+
type?: ScalarTypeWithLiterals;
|
|
1302
|
+
/** Value of the scalar aggregation */
|
|
1303
|
+
value?: number;
|
|
1304
|
+
}
|
|
1305
|
+
interface NestedValueAggregationResult {
|
|
1306
|
+
/**
|
|
1307
|
+
* Value of the field
|
|
1308
|
+
* @maxLength 1000
|
|
1309
|
+
*/
|
|
1310
|
+
value?: string;
|
|
1311
|
+
/** Nested aggregations */
|
|
1312
|
+
nestedResults?: NestedAggregationResults;
|
|
1313
|
+
}
|
|
1314
|
+
interface ValueResult {
|
|
1315
|
+
/**
|
|
1316
|
+
* Value of the field
|
|
1317
|
+
* @maxLength 1000
|
|
1318
|
+
*/
|
|
1319
|
+
value?: string;
|
|
1320
|
+
/** Count of entities with this value */
|
|
1321
|
+
count?: number | null;
|
|
1322
|
+
}
|
|
1323
|
+
interface RangeResult {
|
|
1324
|
+
/** Inclusive lower bound of the range */
|
|
1325
|
+
from?: number | null;
|
|
1326
|
+
/** Exclusive upper bound of the range */
|
|
1327
|
+
to?: number | null;
|
|
1328
|
+
/** Count of entities in this range */
|
|
1329
|
+
count?: number | null;
|
|
1330
|
+
}
|
|
1331
|
+
interface ScalarResult {
|
|
1332
|
+
/** Value of the scalar aggregation */
|
|
1333
|
+
value?: number;
|
|
1334
|
+
}
|
|
1335
|
+
interface NestedResultValue extends NestedResultValueResultOneOf {
|
|
1336
|
+
/** Value aggregation result */
|
|
1337
|
+
value?: ValueResult;
|
|
1338
|
+
/** Range aggregation result */
|
|
1339
|
+
range?: RangeResult;
|
|
1340
|
+
/** Scalar aggregation result */
|
|
1341
|
+
scalar?: ScalarResult;
|
|
1342
|
+
/** Date histogram aggregation result */
|
|
1343
|
+
dateHistogram?: ValueResult;
|
|
1344
|
+
}
|
|
1345
|
+
/** @oneof */
|
|
1346
|
+
interface NestedResultValueResultOneOf {
|
|
1347
|
+
/** Value aggregation result */
|
|
1348
|
+
value?: ValueResult;
|
|
1349
|
+
/** Range aggregation result */
|
|
1350
|
+
range?: RangeResult;
|
|
1351
|
+
/** Scalar aggregation result */
|
|
1352
|
+
scalar?: ScalarResult;
|
|
1353
|
+
/** Date histogram aggregation result */
|
|
1354
|
+
dateHistogram?: ValueResult;
|
|
1355
|
+
}
|
|
1356
|
+
interface Results {
|
|
1357
|
+
/** List of nested aggregations */
|
|
1358
|
+
results?: Record<string, NestedResultValue>;
|
|
1359
|
+
}
|
|
1360
|
+
interface DateHistogramResult {
|
|
1361
|
+
/**
|
|
1362
|
+
* Date in ISO 8601 format
|
|
1363
|
+
* @maxLength 100
|
|
1364
|
+
*/
|
|
1365
|
+
value?: string;
|
|
1366
|
+
/** Count of documents in the bucket */
|
|
1367
|
+
count?: number;
|
|
1368
|
+
}
|
|
1369
|
+
interface GroupByValueResults {
|
|
1370
|
+
/**
|
|
1371
|
+
* List of value aggregations
|
|
1372
|
+
* @maxSize 1000
|
|
1373
|
+
*/
|
|
1374
|
+
results?: NestedValueAggregationResult[];
|
|
1375
|
+
}
|
|
1376
|
+
interface DateHistogramResults {
|
|
1377
|
+
/**
|
|
1378
|
+
* List of date histogram aggregations
|
|
1379
|
+
* @maxSize 200
|
|
1380
|
+
*/
|
|
1381
|
+
results?: DateHistogramResult[];
|
|
1382
|
+
}
|
|
1383
|
+
/**
|
|
1384
|
+
* Results of `NESTED` aggregation type in a flattened form
|
|
1385
|
+
* aggregations in resulting array are keyed by requested aggregation `name`.
|
|
1386
|
+
*/
|
|
1387
|
+
interface NestedResults {
|
|
1388
|
+
/**
|
|
1389
|
+
* List of nested aggregations
|
|
1390
|
+
* @maxSize 1000
|
|
1391
|
+
*/
|
|
1392
|
+
results?: Results[];
|
|
1393
|
+
}
|
|
1394
|
+
interface AggregationResults extends AggregationResultsResultOneOf {
|
|
1395
|
+
/** Value aggregation results */
|
|
1396
|
+
values?: ValueResults;
|
|
1397
|
+
/** Range aggregation results */
|
|
1398
|
+
ranges?: RangeResults;
|
|
1399
|
+
/** Scalar aggregation results */
|
|
1400
|
+
scalar?: AggregationResultsScalarResult;
|
|
1401
|
+
/** Group by value aggregation results */
|
|
1402
|
+
groupedByValue?: GroupByValueResults;
|
|
1403
|
+
/** Date histogram aggregation results */
|
|
1404
|
+
dateHistogram?: DateHistogramResults;
|
|
1405
|
+
/** Nested aggregation results */
|
|
1406
|
+
nested?: NestedResults;
|
|
1407
|
+
/**
|
|
1408
|
+
* User-defined name of aggregation as derived from search request
|
|
1409
|
+
* @maxLength 100
|
|
1410
|
+
*/
|
|
1411
|
+
name?: string;
|
|
1412
|
+
/** Type of aggregation that must match provided kind as derived from search request */
|
|
1413
|
+
type?: AggregationTypeWithLiterals;
|
|
1414
|
+
/**
|
|
1415
|
+
* Field to aggregate by as derived from search request
|
|
1416
|
+
* @maxLength 200
|
|
1417
|
+
*/
|
|
1418
|
+
fieldPath?: string;
|
|
1419
|
+
}
|
|
1420
|
+
/** @oneof */
|
|
1421
|
+
interface AggregationResultsResultOneOf {
|
|
1422
|
+
/** Value aggregation results */
|
|
1423
|
+
values?: ValueResults;
|
|
1424
|
+
/** Range aggregation results */
|
|
1425
|
+
ranges?: RangeResults;
|
|
1426
|
+
/** Scalar aggregation results */
|
|
1427
|
+
scalar?: AggregationResultsScalarResult;
|
|
1428
|
+
/** Group by value aggregation results */
|
|
1429
|
+
groupedByValue?: GroupByValueResults;
|
|
1430
|
+
/** Date histogram aggregation results */
|
|
1431
|
+
dateHistogram?: DateHistogramResults;
|
|
1432
|
+
/** Nested aggregation results */
|
|
1433
|
+
nested?: NestedResults;
|
|
1434
|
+
}
|
|
1435
|
+
interface BulkUpdateProductTagsRequest {
|
|
1436
|
+
/**
|
|
1437
|
+
* Product IDs to update tags for.
|
|
1438
|
+
* @minSize 1
|
|
1439
|
+
* @maxSize 100
|
|
1440
|
+
* @format GUID
|
|
1441
|
+
*/
|
|
1442
|
+
productIds: string[];
|
|
1443
|
+
/** Tags to assign to the products. */
|
|
1444
|
+
assignTags?: Tags;
|
|
1445
|
+
/** Tags to remove from the products. */
|
|
1446
|
+
unassignTags?: Tags;
|
|
1447
|
+
}
|
|
1448
|
+
interface BulkUpdateProductTagsResponse {
|
|
1449
|
+
/**
|
|
1450
|
+
* Results
|
|
1451
|
+
* @minSize 1
|
|
1452
|
+
* @maxSize 100
|
|
1453
|
+
*/
|
|
1454
|
+
results?: BulkUpdateProductTagsResult[];
|
|
1455
|
+
/** Metadata regarding the bulk update operation */
|
|
1456
|
+
bulkActionMetadata?: BulkActionMetadata;
|
|
1457
|
+
}
|
|
1458
|
+
interface BulkUpdateProductTagsResult {
|
|
1459
|
+
/** Metadata regarding the specific single update operation */
|
|
1460
|
+
itemMetadata?: ItemMetadata;
|
|
1461
|
+
}
|
|
1462
|
+
interface BulkUpdateProductTagsByFilterRequest {
|
|
1463
|
+
/** Filter to select products for tag updates. Empty filter updates all products. */
|
|
1464
|
+
filter: Record<string, any> | null;
|
|
1465
|
+
/** Tags to assign to matching products. */
|
|
1466
|
+
assignTags?: Tags;
|
|
1467
|
+
/** Tags to remove from matching products. */
|
|
1468
|
+
unassignTags?: Tags;
|
|
1469
|
+
}
|
|
1470
|
+
interface BulkUpdateProductTagsByFilterResponse {
|
|
1471
|
+
/**
|
|
1472
|
+
* Job ID for tracking the asynchronous tag update operation.
|
|
1473
|
+
* @format GUID
|
|
1474
|
+
*/
|
|
1475
|
+
jobId?: string;
|
|
1476
|
+
}
|
|
1477
|
+
interface QueryCategoriesRequest {
|
|
1478
|
+
/** Query parameters including filter, sort, and paging options. */
|
|
1479
|
+
query?: CursorQuery;
|
|
1480
|
+
/** The namespace this category belongs to. */
|
|
1481
|
+
namespace: CategoryNamespaceWithLiterals;
|
|
1482
|
+
/** Whether non visible categories should be included in the response. Default is `false`. */
|
|
1483
|
+
returnNonVisibleCategories?: boolean;
|
|
1484
|
+
}
|
|
1485
|
+
interface CursorQuery extends CursorQueryPagingMethodOneOf {
|
|
1486
|
+
/** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
|
|
1487
|
+
cursorPaging?: CursorPaging;
|
|
1488
|
+
/**
|
|
1489
|
+
* Filter object in the following format:
|
|
1490
|
+
* `"filter" : {
|
|
1491
|
+
* "fieldName1": "value1",
|
|
1492
|
+
* "fieldName2":{"$operator":"value2"}
|
|
1493
|
+
* }`
|
|
1494
|
+
* Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
|
|
1495
|
+
*/
|
|
1496
|
+
filter?: Record<string, any> | null;
|
|
1497
|
+
/**
|
|
1498
|
+
* Sort object in the following format:
|
|
1499
|
+
* `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
|
|
1500
|
+
* @maxSize 5
|
|
1501
|
+
*/
|
|
1502
|
+
sort?: Sorting[];
|
|
1503
|
+
}
|
|
1504
|
+
/** @oneof */
|
|
1505
|
+
interface CursorQueryPagingMethodOneOf {
|
|
1506
|
+
/** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
|
|
1507
|
+
cursorPaging?: CursorPaging;
|
|
1508
|
+
}
|
|
1509
|
+
interface Sorting {
|
|
1510
|
+
/**
|
|
1511
|
+
* Name of the field to sort by.
|
|
1512
|
+
* @maxLength 512
|
|
1513
|
+
*/
|
|
1514
|
+
fieldName?: string;
|
|
1515
|
+
/** Sort order. */
|
|
1516
|
+
order?: SortOrderWithLiterals;
|
|
1517
|
+
/**
|
|
1518
|
+
* Filters to specify which element to use for sorting when `fieldName` refers to a repeated field marked as `MATCH_ITEMS`.
|
|
1519
|
+
*
|
|
1520
|
+
* These filters ensure the correct element is selected from the collection for sorting. Multiple filters are combined using the `AND` operator.
|
|
1521
|
+
*
|
|
1522
|
+
* For example, for a document like `{"id": "1", "nestedField": [{"price": 10, "region": "EU"}, {"price": 20, "region": "US"}]}`,
|
|
1523
|
+
* if `nestedField` is marked as `MATCH_ITEMS`, sorting by price in the US region requires:
|
|
1524
|
+
* `{fieldName: "nestedField.price", "selectItemsBy": [{"nestedField.region": "US"}]}`.
|
|
1525
|
+
* @maxSize 10
|
|
1526
|
+
*/
|
|
1527
|
+
selectItemsBy?: Record<string, any>[] | null;
|
|
1528
|
+
}
|
|
1529
|
+
declare enum SortOrder {
|
|
1530
|
+
ASC = "ASC",
|
|
1531
|
+
DESC = "DESC"
|
|
1532
|
+
}
|
|
1533
|
+
/** @enumType */
|
|
1534
|
+
type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
|
|
1535
|
+
interface CursorPaging {
|
|
1536
|
+
/**
|
|
1537
|
+
* Maximum number of items to return in the results.
|
|
1538
|
+
* @max 1000
|
|
1539
|
+
*/
|
|
1540
|
+
limit?: number | null;
|
|
1541
|
+
/**
|
|
1542
|
+
* Pointer to the next or previous page in the list of results.
|
|
1543
|
+
*
|
|
1544
|
+
* Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
|
|
1545
|
+
* Not relevant for the first request.
|
|
1546
|
+
* @maxLength 16000
|
|
1547
|
+
*/
|
|
1548
|
+
cursor?: string | null;
|
|
1549
|
+
}
|
|
1550
|
+
interface QueryCategoriesResponse {
|
|
1551
|
+
/** Categories matching the query. */
|
|
1552
|
+
categories?: Category[];
|
|
1553
|
+
/** Paging information for retrieving additional results. */
|
|
1554
|
+
pagingMetadata?: CursorPagingMetadata;
|
|
1555
|
+
}
|
|
1556
|
+
/**
|
|
1557
|
+
* A category for organizing Marketplace products.
|
|
1558
|
+
*
|
|
1559
|
+
* Categories form a hierarchical structure to help store owners discover relevant products.
|
|
1560
|
+
*/
|
|
1561
|
+
interface Category {
|
|
1562
|
+
/**
|
|
1563
|
+
* Category ID.
|
|
1564
|
+
* @format GUID
|
|
1565
|
+
* @readonly
|
|
1566
|
+
*/
|
|
1567
|
+
id?: string | null;
|
|
1568
|
+
/**
|
|
1569
|
+
* Category name.
|
|
1570
|
+
* @minLength 1
|
|
1571
|
+
* @maxLength 80
|
|
1572
|
+
*/
|
|
1573
|
+
name?: string | null;
|
|
1574
|
+
/**
|
|
1575
|
+
* Category description.
|
|
1576
|
+
* @minLength 1
|
|
1577
|
+
* @maxLength 600
|
|
1578
|
+
*/
|
|
1579
|
+
description?: string | null;
|
|
1580
|
+
/**
|
|
1581
|
+
* Number of items in this category.
|
|
1582
|
+
* @readonly
|
|
1583
|
+
*/
|
|
1584
|
+
itemCount?: number;
|
|
1585
|
+
/**
|
|
1586
|
+
* Navigation path from root to this category.
|
|
1587
|
+
*
|
|
1588
|
+
* The current category isn't included in the list.
|
|
1589
|
+
* @readonly
|
|
1590
|
+
* @maxSize 5
|
|
1591
|
+
*/
|
|
1592
|
+
breadcrumbs?: Breadcrumb[];
|
|
1593
|
+
/**
|
|
1594
|
+
* Parent category information in the hierarchy.
|
|
1595
|
+
* @immutable
|
|
1596
|
+
*/
|
|
1597
|
+
parentCategory?: ParentCategory;
|
|
1598
|
+
/**
|
|
1599
|
+
* URL-friendly category identifier.
|
|
1600
|
+
* @format URL_SLUG
|
|
1601
|
+
*/
|
|
1602
|
+
slug?: string | null;
|
|
1603
|
+
/**
|
|
1604
|
+
* Whether the category is visible in the Marketplace.
|
|
1605
|
+
*
|
|
1606
|
+
* Default: `true`
|
|
1607
|
+
*/
|
|
1608
|
+
visible?: boolean | null;
|
|
1609
|
+
}
|
|
1610
|
+
interface Breadcrumb {
|
|
1611
|
+
/**
|
|
1612
|
+
* Ancestor category ID.
|
|
1613
|
+
* @format GUID
|
|
1614
|
+
*/
|
|
1615
|
+
categoryId?: string;
|
|
1616
|
+
/**
|
|
1617
|
+
* Ancestor category name.
|
|
1618
|
+
* @minLength 1
|
|
1619
|
+
* @maxLength 80
|
|
1620
|
+
*/
|
|
1621
|
+
categoryName?: string;
|
|
1622
|
+
/**
|
|
1623
|
+
* Ancestor category slug.
|
|
1624
|
+
* @minLength 1
|
|
1625
|
+
* @maxLength 100
|
|
1626
|
+
*/
|
|
1627
|
+
categorySlug?: string;
|
|
1628
|
+
}
|
|
1629
|
+
/** Information about a category's parent in the hierarchy. */
|
|
1630
|
+
interface ParentCategory {
|
|
1631
|
+
/**
|
|
1632
|
+
* Parent category ID.
|
|
1633
|
+
* @format GUID
|
|
1634
|
+
*/
|
|
1635
|
+
id?: string | null;
|
|
1636
|
+
/**
|
|
1637
|
+
* Index position of the category within the parent category.
|
|
1638
|
+
* @readonly
|
|
1639
|
+
*/
|
|
1640
|
+
index?: number | null;
|
|
1641
|
+
}
|
|
1642
|
+
interface CursorPagingMetadata {
|
|
1643
|
+
/** Number of items returned in the response. */
|
|
1644
|
+
count?: number | null;
|
|
1645
|
+
/** Cursor strings that point to the next page, previous page, or both. */
|
|
1646
|
+
cursors?: Cursors;
|
|
1647
|
+
/**
|
|
1648
|
+
* Whether there are more pages to retrieve following the current page.
|
|
1649
|
+
*
|
|
1650
|
+
* + `true`: Another page of results can be retrieved.
|
|
1651
|
+
* + `false`: This is the last page.
|
|
1652
|
+
*/
|
|
1653
|
+
hasNext?: boolean | null;
|
|
1654
|
+
}
|
|
1655
|
+
interface Cursors {
|
|
1656
|
+
/**
|
|
1657
|
+
* Cursor string pointing to the next page in the list of results.
|
|
1658
|
+
* @maxLength 16000
|
|
1659
|
+
*/
|
|
1660
|
+
next?: string | null;
|
|
1661
|
+
/**
|
|
1662
|
+
* Cursor pointing to the previous page in the list of results.
|
|
1663
|
+
* @maxLength 16000
|
|
1664
|
+
*/
|
|
1665
|
+
prev?: string | null;
|
|
1666
|
+
}
|
|
1667
|
+
interface BulkAddProductsToStoreRequest {
|
|
1668
|
+
/**
|
|
1669
|
+
* Products to add to the user's store.
|
|
1670
|
+
* @minSize 1
|
|
1671
|
+
* @maxSize 50
|
|
1672
|
+
*/
|
|
1673
|
+
productReferences?: ProductReference[];
|
|
1674
|
+
}
|
|
1675
|
+
interface ProductReference {
|
|
1676
|
+
/**
|
|
1677
|
+
* Product ID.
|
|
1678
|
+
* @format GUID
|
|
1679
|
+
*/
|
|
1680
|
+
productId?: string;
|
|
1681
|
+
/**
|
|
1682
|
+
* Provider app ID.
|
|
1683
|
+
* @format GUID
|
|
1684
|
+
* @readonly
|
|
1685
|
+
*/
|
|
1686
|
+
appId?: string;
|
|
1687
|
+
/**
|
|
1688
|
+
* Additional metadata for the product reference.
|
|
1689
|
+
*
|
|
1690
|
+
* For example, internal identifiers on the provider's platform.
|
|
1691
|
+
*/
|
|
1692
|
+
options?: Record<string, any> | null;
|
|
1693
|
+
/**
|
|
1694
|
+
* Whether the product is visible in the store.
|
|
1695
|
+
*
|
|
1696
|
+
* Default: `false`
|
|
1697
|
+
*/
|
|
1698
|
+
visibleInStore?: boolean;
|
|
1699
|
+
}
|
|
1700
|
+
interface BulkAddProductsToStoreResponse {
|
|
1701
|
+
/**
|
|
1702
|
+
* Results of adding products to the store, one per input product.
|
|
1703
|
+
* @minSize 1
|
|
1704
|
+
* @maxSize 50
|
|
1705
|
+
*/
|
|
1706
|
+
results?: BulkAddProductToStoreResult[];
|
|
1707
|
+
/** Metadata about the bulk operation including success and failure counts. */
|
|
1708
|
+
bulkActionMetadata?: BulkActionMetadata;
|
|
1709
|
+
}
|
|
1710
|
+
interface BulkAddProductToStoreResult {
|
|
1711
|
+
/** Metadata regarding the specific single operation */
|
|
1712
|
+
itemMetadata?: ItemMetadata;
|
|
1713
|
+
/** Product added to the user's store */
|
|
1714
|
+
item?: ProductReference;
|
|
1715
|
+
}
|
|
1716
|
+
interface DomainEvent extends DomainEventBodyOneOf {
|
|
1717
|
+
createdEvent?: EntityCreatedEvent;
|
|
1718
|
+
updatedEvent?: EntityUpdatedEvent;
|
|
1719
|
+
deletedEvent?: EntityDeletedEvent;
|
|
1720
|
+
actionEvent?: ActionEvent;
|
|
1721
|
+
/** Event ID. With this ID you can easily spot duplicated events and ignore them. */
|
|
1722
|
+
id?: string;
|
|
1723
|
+
/**
|
|
1724
|
+
* Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
|
|
1725
|
+
* For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
|
|
1726
|
+
*/
|
|
1727
|
+
entityFqdn?: string;
|
|
1728
|
+
/**
|
|
1729
|
+
* Event action name, placed at the top level to make it easier for users to dispatch messages.
|
|
1730
|
+
* For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
|
|
1731
|
+
*/
|
|
1732
|
+
slug?: string;
|
|
1733
|
+
/** ID of the entity associated with the event. */
|
|
1734
|
+
entityId?: string;
|
|
1735
|
+
/** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
|
|
1736
|
+
eventTime?: Date | null;
|
|
1737
|
+
/**
|
|
1738
|
+
* Whether the event was triggered as a result of a privacy regulation application
|
|
1739
|
+
* (for example, GDPR).
|
|
1740
|
+
*/
|
|
1741
|
+
triggeredByAnonymizeRequest?: boolean | null;
|
|
1742
|
+
/** If present, indicates the action that triggered the event. */
|
|
1743
|
+
originatedFrom?: string | null;
|
|
1744
|
+
/**
|
|
1745
|
+
* A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number.
|
|
1746
|
+
* You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
|
|
1747
|
+
*/
|
|
1748
|
+
entityEventSequence?: string | null;
|
|
1749
|
+
}
|
|
1750
|
+
/** @oneof */
|
|
1751
|
+
interface DomainEventBodyOneOf {
|
|
1752
|
+
createdEvent?: EntityCreatedEvent;
|
|
1753
|
+
updatedEvent?: EntityUpdatedEvent;
|
|
1754
|
+
deletedEvent?: EntityDeletedEvent;
|
|
1755
|
+
actionEvent?: ActionEvent;
|
|
1756
|
+
}
|
|
1757
|
+
interface EntityCreatedEvent {
|
|
1758
|
+
entityAsJson?: string;
|
|
1759
|
+
/** Indicates the event was triggered by a restore-from-trashbin operation for a previously deleted entity */
|
|
1760
|
+
restoreInfo?: RestoreInfo;
|
|
1761
|
+
}
|
|
1762
|
+
interface RestoreInfo {
|
|
1763
|
+
deletedDate?: Date | null;
|
|
1764
|
+
}
|
|
1765
|
+
interface EntityUpdatedEvent {
|
|
1766
|
+
/**
|
|
1767
|
+
* Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
|
|
1768
|
+
* This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
|
|
1769
|
+
* We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
|
|
1770
|
+
*/
|
|
1771
|
+
currentEntityAsJson?: string;
|
|
1772
|
+
}
|
|
1773
|
+
interface EntityDeletedEvent {
|
|
1774
|
+
/** Entity that was deleted. */
|
|
1775
|
+
deletedEntityAsJson?: string | null;
|
|
1776
|
+
}
|
|
1777
|
+
interface ActionEvent {
|
|
1778
|
+
bodyAsJson?: string;
|
|
1779
|
+
}
|
|
1780
|
+
interface Empty {
|
|
1781
|
+
}
|
|
1782
|
+
interface MessageEnvelope {
|
|
1783
|
+
/**
|
|
1784
|
+
* App instance ID.
|
|
1785
|
+
* @format GUID
|
|
1786
|
+
*/
|
|
1787
|
+
instanceId?: string | null;
|
|
1788
|
+
/**
|
|
1789
|
+
* Event type.
|
|
1790
|
+
* @maxLength 150
|
|
1791
|
+
*/
|
|
1792
|
+
eventType?: string;
|
|
1793
|
+
/** The identification type and identity data. */
|
|
1794
|
+
identity?: IdentificationData;
|
|
1795
|
+
/** Stringify payload. */
|
|
1796
|
+
data?: string;
|
|
1797
|
+
/** Details related to the account */
|
|
1798
|
+
accountInfo?: AccountInfo;
|
|
1799
|
+
}
|
|
1800
|
+
interface IdentificationData extends IdentificationDataIdOneOf {
|
|
1801
|
+
/**
|
|
1802
|
+
* ID of a site visitor that has not logged in to the site.
|
|
1803
|
+
* @format GUID
|
|
1804
|
+
*/
|
|
1805
|
+
anonymousVisitorId?: string;
|
|
1806
|
+
/**
|
|
1807
|
+
* ID of a site visitor that has logged in to the site.
|
|
1808
|
+
* @format GUID
|
|
1809
|
+
*/
|
|
1810
|
+
memberId?: string;
|
|
1811
|
+
/**
|
|
1812
|
+
* ID of a Wix user (site owner, contributor, etc.).
|
|
1813
|
+
* @format GUID
|
|
1814
|
+
*/
|
|
1815
|
+
wixUserId?: string;
|
|
1816
|
+
/**
|
|
1817
|
+
* ID of an app.
|
|
1818
|
+
* @format GUID
|
|
1819
|
+
*/
|
|
1820
|
+
appId?: string;
|
|
1821
|
+
/** @readonly */
|
|
1822
|
+
identityType?: WebhookIdentityTypeWithLiterals;
|
|
1823
|
+
}
|
|
1824
|
+
/** @oneof */
|
|
1825
|
+
interface IdentificationDataIdOneOf {
|
|
1826
|
+
/**
|
|
1827
|
+
* ID of a site visitor that has not logged in to the site.
|
|
1828
|
+
* @format GUID
|
|
1829
|
+
*/
|
|
1830
|
+
anonymousVisitorId?: string;
|
|
1831
|
+
/**
|
|
1832
|
+
* ID of a site visitor that has logged in to the site.
|
|
1833
|
+
* @format GUID
|
|
1834
|
+
*/
|
|
1835
|
+
memberId?: string;
|
|
1836
|
+
/**
|
|
1837
|
+
* ID of a Wix user (site owner, contributor, etc.).
|
|
1838
|
+
* @format GUID
|
|
1839
|
+
*/
|
|
1840
|
+
wixUserId?: string;
|
|
1841
|
+
/**
|
|
1842
|
+
* ID of an app.
|
|
1843
|
+
* @format GUID
|
|
1844
|
+
*/
|
|
1845
|
+
appId?: string;
|
|
1846
|
+
}
|
|
1847
|
+
declare enum WebhookIdentityType {
|
|
1848
|
+
UNKNOWN = "UNKNOWN",
|
|
1849
|
+
ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
|
|
1850
|
+
MEMBER = "MEMBER",
|
|
1851
|
+
WIX_USER = "WIX_USER",
|
|
1852
|
+
APP = "APP"
|
|
1853
|
+
}
|
|
1854
|
+
/** @enumType */
|
|
1855
|
+
type WebhookIdentityTypeWithLiterals = WebhookIdentityType | 'UNKNOWN' | 'ANONYMOUS_VISITOR' | 'MEMBER' | 'WIX_USER' | 'APP';
|
|
1856
|
+
interface AccountInfo {
|
|
1857
|
+
/**
|
|
1858
|
+
* ID of the Wix account associated with the event.
|
|
1859
|
+
* @format GUID
|
|
1860
|
+
*/
|
|
1861
|
+
accountId?: string | null;
|
|
1862
|
+
/**
|
|
1863
|
+
* ID of the parent Wix account. Only included when accountId belongs to a child account.
|
|
1864
|
+
* @format GUID
|
|
1865
|
+
*/
|
|
1866
|
+
parentAccountId?: string | null;
|
|
1867
|
+
/**
|
|
1868
|
+
* ID of the Wix site associated with the event. Only included when the event is tied to a specific site.
|
|
1869
|
+
* @format GUID
|
|
1870
|
+
*/
|
|
1871
|
+
siteId?: string | null;
|
|
1872
|
+
}
|
|
1873
|
+
/** @docsIgnore */
|
|
1874
|
+
type BulkUpdateProductTagsApplicationErrors = {
|
|
1875
|
+
code?: 'EMPTY_ASSIGN_AND_UNASSIGN_LISTS';
|
|
1876
|
+
description?: string;
|
|
1877
|
+
data?: Record<string, any>;
|
|
1878
|
+
};
|
|
1879
|
+
/** @docsIgnore */
|
|
1880
|
+
type BulkUpdateProductTagsByFilterApplicationErrors = {
|
|
1881
|
+
code?: 'EMPTY_ASSIGN_AND_UNASSIGN_LISTS';
|
|
1882
|
+
description?: string;
|
|
1883
|
+
data?: Record<string, any>;
|
|
1884
|
+
};
|
|
1885
|
+
|
|
1886
|
+
type __PublicMethodMetaInfo<K = string, M = unknown, T = unknown, S = unknown, Q = unknown, R = unknown> = {
|
|
1887
|
+
getUrl: (context: any) => string;
|
|
1888
|
+
httpMethod: K;
|
|
1889
|
+
path: string;
|
|
1890
|
+
pathParams: M;
|
|
1891
|
+
__requestType: T;
|
|
1892
|
+
__originalRequestType: S;
|
|
1893
|
+
__responseType: Q;
|
|
1894
|
+
__originalResponseType: R;
|
|
1895
|
+
};
|
|
1896
|
+
declare function createProduct(): __PublicMethodMetaInfo<'POST', {}, CreateProductRequest$1, CreateProductRequest, CreateProductResponse$1, CreateProductResponse>;
|
|
1897
|
+
declare function getProduct(): __PublicMethodMetaInfo<'GET', {
|
|
1898
|
+
productId: string;
|
|
1899
|
+
}, GetProductRequest$1, GetProductRequest, GetProductResponse$1, GetProductResponse>;
|
|
1900
|
+
declare function updateProduct(): __PublicMethodMetaInfo<'PATCH', {
|
|
1901
|
+
productId: string;
|
|
1902
|
+
}, UpdateProductRequest$1, UpdateProductRequest, UpdateProductResponse$1, UpdateProductResponse>;
|
|
1903
|
+
declare function deleteProduct(): __PublicMethodMetaInfo<'DELETE', {
|
|
1904
|
+
productId: string;
|
|
1905
|
+
}, DeleteProductRequest$1, DeleteProductRequest, DeleteProductResponse$1, DeleteProductResponse>;
|
|
1906
|
+
declare function bulkCreateProducts(): __PublicMethodMetaInfo<'POST', {}, BulkCreateProductsRequest$1, BulkCreateProductsRequest, BulkCreateProductsResponse$1, BulkCreateProductsResponse>;
|
|
1907
|
+
declare function bulkUpdateProducts(): __PublicMethodMetaInfo<'PATCH', {}, BulkUpdateProductsRequest$1, BulkUpdateProductsRequest, BulkUpdateProductsResponse$1, BulkUpdateProductsResponse>;
|
|
1908
|
+
declare function bulkDeleteProducts(): __PublicMethodMetaInfo<'POST', {}, BulkDeleteProductsRequest$1, BulkDeleteProductsRequest, BulkDeleteProductsResponse$1, BulkDeleteProductsResponse>;
|
|
1909
|
+
declare function queryProducts(): __PublicMethodMetaInfo<'POST', {}, QueryProductsRequest$1, QueryProductsRequest, QueryProductsResponse$1, QueryProductsResponse>;
|
|
1910
|
+
declare function searchProducts(): __PublicMethodMetaInfo<'POST', {}, SearchProductsRequest$1, SearchProductsRequest, SearchProductsResponse$1, SearchProductsResponse>;
|
|
1911
|
+
declare function bulkUpdateProductTags(): __PublicMethodMetaInfo<'POST', {}, BulkUpdateProductTagsRequest$1, BulkUpdateProductTagsRequest, BulkUpdateProductTagsResponse$1, BulkUpdateProductTagsResponse>;
|
|
1912
|
+
declare function bulkUpdateProductTagsByFilter(): __PublicMethodMetaInfo<'POST', {}, BulkUpdateProductTagsByFilterRequest$1, BulkUpdateProductTagsByFilterRequest, BulkUpdateProductTagsByFilterResponse$1, BulkUpdateProductTagsByFilterResponse>;
|
|
1913
|
+
declare function queryCategories(): __PublicMethodMetaInfo<'POST', {}, QueryCategoriesRequest$1, QueryCategoriesRequest, QueryCategoriesResponse$1, QueryCategoriesResponse>;
|
|
1914
|
+
|
|
1915
|
+
export { type AccountInfo as AccountInfoOriginal, type ActionEvent as ActionEventOriginal, type AggregationData as AggregationDataOriginal, type AggregationKindOneOf as AggregationKindOneOfOriginal, type Aggregation as AggregationOriginal, type AggregationResults as AggregationResultsOriginal, type AggregationResultsResultOneOf as AggregationResultsResultOneOfOriginal, type AggregationResultsScalarResult as AggregationResultsScalarResultOriginal, AggregationType as AggregationTypeOriginal, type AggregationTypeWithLiterals as AggregationTypeWithLiteralsOriginal, type ApplicationError as ApplicationErrorOriginal, type Breadcrumb as BreadcrumbOriginal, type BulkActionMetadata as BulkActionMetadataOriginal, type BulkAddProductToStoreResult as BulkAddProductToStoreResultOriginal, type BulkAddProductsToStoreRequest as BulkAddProductsToStoreRequestOriginal, type BulkAddProductsToStoreResponse as BulkAddProductsToStoreResponseOriginal, type BulkCreateProductsRequest as BulkCreateProductsRequestOriginal, type BulkCreateProductsResponse as BulkCreateProductsResponseOriginal, type BulkDeleteProductsRequest as BulkDeleteProductsRequestOriginal, type BulkDeleteProductsResponseBulkProductResult as BulkDeleteProductsResponseBulkProductResultOriginal, type BulkDeleteProductsResponse as BulkDeleteProductsResponseOriginal, type BulkProductResult as BulkProductResultOriginal, type BulkUpdateProductTagsApplicationErrors as BulkUpdateProductTagsApplicationErrorsOriginal, type BulkUpdateProductTagsByFilterApplicationErrors as BulkUpdateProductTagsByFilterApplicationErrorsOriginal, type BulkUpdateProductTagsByFilterRequest as BulkUpdateProductTagsByFilterRequestOriginal, type BulkUpdateProductTagsByFilterResponse as BulkUpdateProductTagsByFilterResponseOriginal, type BulkUpdateProductTagsRequest as BulkUpdateProductTagsRequestOriginal, type BulkUpdateProductTagsResponse as BulkUpdateProductTagsResponseOriginal, type BulkUpdateProductTagsResult as BulkUpdateProductTagsResultOriginal, type BulkUpdateProductsRequest as BulkUpdateProductsRequestOriginal, type BulkUpdateProductsResponseBulkProductResult as BulkUpdateProductsResponseBulkProductResultOriginal, type BulkUpdateProductsResponse as BulkUpdateProductsResponseOriginal, CategoryNamespace as CategoryNamespaceOriginal, type CategoryNamespaceWithLiterals as CategoryNamespaceWithLiteralsOriginal, type Category as CategoryOriginal, type ColorOption as ColorOptionOriginal, type CommonCursorPagingMetadata as CommonCursorPagingMetadataOriginal, type CommonCursorPaging as CommonCursorPagingOriginal, type CommonCursorQuery as CommonCursorQueryOriginal, type CommonCursorQueryPagingMethodOneOf as CommonCursorQueryPagingMethodOneOfOriginal, type CommonCursors as CommonCursorsOriginal, CommonSortOrder as CommonSortOrderOriginal, type CommonSortOrderWithLiterals as CommonSortOrderWithLiteralsOriginal, type CommonSorting as CommonSortingOriginal, type Countries as CountriesOriginal, CountrySelections as CountrySelectionsOriginal, type CountrySelectionsWithLiterals as CountrySelectionsWithLiteralsOriginal, type CreateProductRequest as CreateProductRequestOriginal, type CreateProductResponse as CreateProductResponseOriginal, type CursorPagingMetadata as CursorPagingMetadataOriginal, type CursorPaging as CursorPagingOriginal, type CursorQuery as CursorQueryOriginal, type CursorQueryPagingMethodOneOf as CursorQueryPagingMethodOneOfOriginal, type CursorSearch as CursorSearchOriginal, type CursorSearchPagingMethodOneOf as CursorSearchPagingMethodOneOfOriginal, type Cursors as CursorsOriginal, type DateHistogramAggregation as DateHistogramAggregationOriginal, type DateHistogramResult as DateHistogramResultOriginal, type DateHistogramResults as DateHistogramResultsOriginal, type DeleteProductRequest as DeleteProductRequestOriginal, type DeleteProductResponse as DeleteProductResponseOriginal, type DomainEventBodyOneOf as DomainEventBodyOneOfOriginal, type DomainEvent as DomainEventOriginal, type Empty as EmptyOriginal, type EntityCreatedEvent as EntityCreatedEventOriginal, type EntityDeletedEvent as EntityDeletedEventOriginal, type EntityUpdatedEvent as EntityUpdatedEventOriginal, type FocalPoint as FocalPointOriginal, type GetProductRequest as GetProductRequestOriginal, type GetProductResponse as GetProductResponseOriginal, type GroupByValueResults as GroupByValueResultsOriginal, type IdentificationDataIdOneOf as IdentificationDataIdOneOfOriginal, type IdentificationData as IdentificationDataOriginal, type Image as ImageOriginal, type IncludeMissingValuesOptions as IncludeMissingValuesOptionsOriginal, Interval as IntervalOriginal, type IntervalWithLiterals as IntervalWithLiteralsOriginal, type Inventory as InventoryOriginal, InventoryTier as InventoryTierOriginal, type InventoryTierWithLiterals as InventoryTierWithLiteralsOriginal, type ItemMetadata as ItemMetadataOriginal, type MaskedProduct as MaskedProductOriginal, type Measurement as MeasurementOriginal, MeasurementUnit as MeasurementUnitOriginal, type MeasurementUnitWithLiterals as MeasurementUnitWithLiteralsOriginal, type MeasurementValueOneOf as MeasurementValueOneOfOriginal, type MeasurementValueRange as MeasurementValueRangeOriginal, type Media as MediaOriginal, type MessageEnvelope as MessageEnvelopeOriginal, MissingValues as MissingValuesOriginal, type MissingValuesWithLiterals as MissingValuesWithLiteralsOriginal, Mode as ModeOriginal, type ModeWithLiterals as ModeWithLiteralsOriginal, type NestedAggregationItemKindOneOf as NestedAggregationItemKindOneOfOriginal, type NestedAggregationItem as NestedAggregationItemOriginal, type NestedAggregation as NestedAggregationOriginal, type NestedAggregationResults as NestedAggregationResultsOriginal, type NestedAggregationResultsResultOneOf as NestedAggregationResultsResultOneOfOriginal, NestedAggregationType as NestedAggregationTypeOriginal, type NestedAggregationTypeWithLiterals as NestedAggregationTypeWithLiteralsOriginal, type NestedResultValue as NestedResultValueOriginal, type NestedResultValueResultOneOf as NestedResultValueResultOneOfOriginal, type NestedResults as NestedResultsOriginal, type NestedValueAggregationResult as NestedValueAggregationResultOriginal, type OptionValue as OptionValueOriginal, type OptionValueValueOneOf as OptionValueValueOneOfOriginal, type ParentCategory as ParentCategoryOriginal, type PriceTier as PriceTierOriginal, type PrintOnDemandOptions as PrintOnDemandOptionsOriginal, PrintTechnology as PrintTechnologyOriginal, type PrintTechnologyWithLiterals as PrintTechnologyWithLiteralsOriginal, type ProductCategory as ProductCategoryOriginal, type ProductOption as ProductOptionOriginal, type Product as ProductOriginal, type ProductReference as ProductReferenceOriginal, ProductType as ProductTypeOriginal, type ProductTypeWithLiterals as ProductTypeWithLiteralsOriginal, type ProviderInfo as ProviderInfoOriginal, type QueryCategoriesRequest as QueryCategoriesRequestOriginal, type QueryCategoriesResponse as QueryCategoriesResponseOriginal, type QueryProductsRequest as QueryProductsRequestOriginal, type QueryProductsResponse as QueryProductsResponseOriginal, type RangeAggregation as RangeAggregationOriginal, type RangeAggregationResult as RangeAggregationResultOriginal, type RangeBucket as RangeBucketOriginal, type RangeResult as RangeResultOriginal, type RangeResults as RangeResultsOriginal, RequestedField as RequestedFieldOriginal, type RequestedFieldWithLiterals as RequestedFieldWithLiteralsOriginal, type RestoreInfo as RestoreInfoOriginal, type Results as ResultsOriginal, type ScalarAggregation as ScalarAggregationOriginal, type ScalarResult as ScalarResultOriginal, ScalarType as ScalarTypeOriginal, type ScalarTypeWithLiterals as ScalarTypeWithLiteralsOriginal, type SearchDetails as SearchDetailsOriginal, type SearchProductsRequest as SearchProductsRequestOriginal, type SearchProductsResponse as SearchProductsResponseOriginal, type ShippingDestinationCountriesOptionsOneOf as ShippingDestinationCountriesOptionsOneOfOriginal, type ShippingDestination as ShippingDestinationOriginal, type SizeGuide as SizeGuideOriginal, SortDirection as SortDirectionOriginal, type SortDirectionWithLiterals as SortDirectionWithLiteralsOriginal, SortOrder as SortOrderOriginal, type SortOrderWithLiterals as SortOrderWithLiteralsOriginal, SortType as SortTypeOriginal, type SortTypeWithLiterals as SortTypeWithLiteralsOriginal, type Sorting as SortingOriginal, type Specification as SpecificationOriginal, type SupplierInfo as SupplierInfoOriginal, type TagList as TagListOriginal, type TagsModified as TagsModifiedOriginal, type Tags as TagsOriginal, type TimeInterval as TimeIntervalOriginal, TimeUnit as TimeUnitOriginal, type TimeUnitWithLiterals as TimeUnitWithLiteralsOriginal, type TimeValue as TimeValueOriginal, type UpdateProductRequest as UpdateProductRequestOriginal, type UpdateProductResponse as UpdateProductResponseOriginal, type ValueAggregationOptionsOneOf as ValueAggregationOptionsOneOfOriginal, type ValueAggregation as ValueAggregationOriginal, type ValueAggregationResult as ValueAggregationResultOriginal, type ValueResult as ValueResultOriginal, type ValueResults as ValueResultsOriginal, WebhookIdentityType as WebhookIdentityTypeOriginal, type WebhookIdentityTypeWithLiterals as WebhookIdentityTypeWithLiteralsOriginal, type WholesaleOptions as WholesaleOptionsOriginal, type __PublicMethodMetaInfo, bulkCreateProducts, bulkDeleteProducts, bulkUpdateProductTags, bulkUpdateProductTagsByFilter, bulkUpdateProducts, createProduct, deleteProduct, getProduct, queryCategories, queryProducts, searchProducts, updateProduct };
|