@wix/auto_sdk_stores_ribbons-v-3 1.0.11 → 1.0.12

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 (134) hide show
  1. package/build/index.d.mts +136 -0
  2. package/build/index.d.ts +136 -0
  3. package/build/index.js +872 -0
  4. package/build/index.js.map +1 -0
  5. package/build/index.mjs +833 -0
  6. package/build/index.mjs.map +1 -0
  7. package/build/internal/index.d.mts +136 -0
  8. package/build/internal/index.d.ts +136 -0
  9. package/build/internal/index.js +872 -0
  10. package/build/internal/index.js.map +1 -0
  11. package/build/internal/index.mjs +833 -0
  12. package/build/internal/index.mjs.map +1 -0
  13. package/build/internal/meta.d.mts +394 -0
  14. package/build/internal/meta.d.ts +394 -0
  15. package/build/internal/meta.js +580 -0
  16. package/build/internal/meta.js.map +1 -0
  17. package/build/internal/meta.mjs +544 -0
  18. package/build/internal/meta.mjs.map +1 -0
  19. package/build/{es/src/stores-catalog-v3-ribbon-ribbons-v-3.types.d.ts → internal/stores-catalog-v3-ribbon-ribbons-v-3.universal-DWKP9-aP.d.mts} +308 -68
  20. package/build/{cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.types.d.ts → internal/stores-catalog-v3-ribbon-ribbons-v-3.universal-DWKP9-aP.d.ts} +308 -68
  21. package/build/meta.d.mts +394 -0
  22. package/build/meta.d.ts +394 -0
  23. package/build/meta.js +580 -0
  24. package/build/meta.js.map +1 -0
  25. package/build/meta.mjs +544 -0
  26. package/build/meta.mjs.map +1 -0
  27. package/build/{internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.types.d.ts → stores-catalog-v3-ribbon-ribbons-v-3.universal-DWKP9-aP.d.mts} +308 -68
  28. package/build/{internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.types.d.ts → stores-catalog-v3-ribbon-ribbons-v-3.universal-DWKP9-aP.d.ts} +308 -68
  29. package/package.json +12 -11
  30. package/build/cjs/index.d.ts +0 -1
  31. package/build/cjs/index.js +0 -18
  32. package/build/cjs/index.js.map +0 -1
  33. package/build/cjs/index.typings.d.ts +0 -1
  34. package/build/cjs/index.typings.js +0 -18
  35. package/build/cjs/index.typings.js.map +0 -1
  36. package/build/cjs/meta.d.ts +0 -1
  37. package/build/cjs/meta.js +0 -18
  38. package/build/cjs/meta.js.map +0 -1
  39. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.context.d.ts +0 -24
  40. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.context.js +0 -30
  41. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.context.js.map +0 -1
  42. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.http.d.ts +0 -59
  43. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.http.js +0 -410
  44. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.http.js.map +0 -1
  45. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.meta.d.ts +0 -28
  46. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.meta.js +0 -218
  47. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.meta.js.map +0 -1
  48. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.public.d.ts +0 -119
  49. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.public.js +0 -104
  50. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.public.js.map +0 -1
  51. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.types.js +0 -24
  52. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.types.js.map +0 -1
  53. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.universal.d.ts +0 -1237
  54. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.universal.js +0 -606
  55. package/build/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.universal.js.map +0 -1
  56. package/build/es/index.d.ts +0 -1
  57. package/build/es/index.js +0 -2
  58. package/build/es/index.js.map +0 -1
  59. package/build/es/index.typings.d.ts +0 -1
  60. package/build/es/index.typings.js +0 -2
  61. package/build/es/index.typings.js.map +0 -1
  62. package/build/es/meta.d.ts +0 -1
  63. package/build/es/meta.js +0 -2
  64. package/build/es/meta.js.map +0 -1
  65. package/build/es/package.json +0 -3
  66. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.context.d.ts +0 -24
  67. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.context.js +0 -24
  68. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.context.js.map +0 -1
  69. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.http.d.ts +0 -59
  70. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.http.js +0 -397
  71. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.http.js.map +0 -1
  72. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.meta.d.ts +0 -28
  73. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.meta.js +0 -182
  74. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.meta.js.map +0 -1
  75. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.public.d.ts +0 -119
  76. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.public.js +0 -88
  77. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.public.js.map +0 -1
  78. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.types.js +0 -21
  79. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.types.js.map +0 -1
  80. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.universal.d.ts +0 -1237
  81. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.universal.js +0 -570
  82. package/build/es/src/stores-catalog-v3-ribbon-ribbons-v-3.universal.js.map +0 -1
  83. package/build/internal/cjs/index.d.ts +0 -1
  84. package/build/internal/cjs/index.js +0 -18
  85. package/build/internal/cjs/index.js.map +0 -1
  86. package/build/internal/cjs/index.typings.d.ts +0 -1
  87. package/build/internal/cjs/index.typings.js +0 -18
  88. package/build/internal/cjs/index.typings.js.map +0 -1
  89. package/build/internal/cjs/meta.d.ts +0 -1
  90. package/build/internal/cjs/meta.js +0 -18
  91. package/build/internal/cjs/meta.js.map +0 -1
  92. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.context.d.ts +0 -24
  93. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.context.js +0 -30
  94. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.context.js.map +0 -1
  95. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.http.d.ts +0 -59
  96. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.http.js +0 -410
  97. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.http.js.map +0 -1
  98. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.meta.d.ts +0 -28
  99. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.meta.js +0 -218
  100. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.meta.js.map +0 -1
  101. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.public.d.ts +0 -119
  102. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.public.js +0 -104
  103. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.public.js.map +0 -1
  104. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.types.js +0 -24
  105. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.types.js.map +0 -1
  106. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.universal.d.ts +0 -1237
  107. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.universal.js +0 -606
  108. package/build/internal/cjs/src/stores-catalog-v3-ribbon-ribbons-v-3.universal.js.map +0 -1
  109. package/build/internal/es/index.d.ts +0 -1
  110. package/build/internal/es/index.js +0 -2
  111. package/build/internal/es/index.js.map +0 -1
  112. package/build/internal/es/index.typings.d.ts +0 -1
  113. package/build/internal/es/index.typings.js +0 -2
  114. package/build/internal/es/index.typings.js.map +0 -1
  115. package/build/internal/es/meta.d.ts +0 -1
  116. package/build/internal/es/meta.js +0 -2
  117. package/build/internal/es/meta.js.map +0 -1
  118. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.context.d.ts +0 -24
  119. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.context.js +0 -24
  120. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.context.js.map +0 -1
  121. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.http.d.ts +0 -59
  122. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.http.js +0 -397
  123. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.http.js.map +0 -1
  124. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.meta.d.ts +0 -28
  125. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.meta.js +0 -182
  126. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.meta.js.map +0 -1
  127. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.public.d.ts +0 -119
  128. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.public.js +0 -88
  129. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.public.js.map +0 -1
  130. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.types.js +0 -21
  131. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.types.js.map +0 -1
  132. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.universal.d.ts +0 -1237
  133. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.universal.js +0 -570
  134. package/build/internal/es/src/stores-catalog-v3-ribbon-ribbons-v-3.universal.js.map +0 -1
@@ -1,1237 +0,0 @@
1
- import { NonNullablePaths } from '@wix/sdk-types';
2
- /** A Ribbon is a visual element that you can assign to products to highlight them on your site. */
3
- export interface Ribbon {
4
- /**
5
- * Ribbon ID.
6
- * @format GUID
7
- * @readonly
8
- */
9
- _id?: string | null;
10
- /**
11
- * Revision number, which increments by 1 each time the ribbon is updated.
12
- * To prevent conflicting changes,
13
- * the current revision must be passed when updating the ribbon.
14
- *
15
- * Ignored when creating a ribbon.
16
- * @readonly
17
- */
18
- revision?: string | null;
19
- /**
20
- * Date and time the ribbon was created.
21
- * @readonly
22
- */
23
- _createdDate?: Date | null;
24
- /**
25
- * Date and time the ribbon was updated.
26
- * @readonly
27
- */
28
- _updatedDate?: Date | null;
29
- /**
30
- * Ribbon name.
31
- * @minLength 1
32
- * @maxLength 30
33
- */
34
- name?: string;
35
- /**
36
- * Number of products this ribbon is assigned to.
37
- * > **Note:** Returned only when you pass `"ASSIGNED_PRODUCT_COUNT"` to the `fields` array in Ribbon API requests.
38
- * @readonly
39
- */
40
- assignedProductCount?: number | null;
41
- }
42
- export interface InvalidateCache extends InvalidateCacheGetByOneOf {
43
- /**
44
- * Invalidate by msId. NOT recommended, as this will invalidate the entire site cache!
45
- * @format GUID
46
- */
47
- metaSiteId?: string;
48
- /**
49
- * Invalidate by Site ID. NOT recommended, as this will invalidate the entire site cache!
50
- * @format GUID
51
- */
52
- siteId?: string;
53
- /** Invalidate by App */
54
- app?: App;
55
- /** Invalidate by page id */
56
- page?: Page;
57
- /** Invalidate by URI path */
58
- uri?: URI;
59
- /** Invalidate by file (for media files such as PDFs) */
60
- file?: File;
61
- /** Invalidate by custom tag. Tags used in BO invalidation are disabled for this endpoint (more info: https://wix-bo.com/dev/clear-ssr-cache) */
62
- customTag?: CustomTag;
63
- /**
64
- * tell us why you're invalidating the cache. You don't need to add your app name
65
- * @maxLength 256
66
- */
67
- reason?: string | null;
68
- /** Is local DS */
69
- localDc?: boolean;
70
- hardPurge?: boolean;
71
- }
72
- /** @oneof */
73
- export interface InvalidateCacheGetByOneOf {
74
- /**
75
- * Invalidate by msId. NOT recommended, as this will invalidate the entire site cache!
76
- * @format GUID
77
- */
78
- metaSiteId?: string;
79
- /**
80
- * Invalidate by Site ID. NOT recommended, as this will invalidate the entire site cache!
81
- * @format GUID
82
- */
83
- siteId?: string;
84
- /** Invalidate by App */
85
- app?: App;
86
- /** Invalidate by page id */
87
- page?: Page;
88
- /** Invalidate by URI path */
89
- uri?: URI;
90
- /** Invalidate by file (for media files such as PDFs) */
91
- file?: File;
92
- /** Invalidate by custom tag. Tags used in BO invalidation are disabled for this endpoint (more info: https://wix-bo.com/dev/clear-ssr-cache) */
93
- customTag?: CustomTag;
94
- }
95
- export interface App {
96
- /**
97
- * The AppDefId
98
- * @minLength 1
99
- */
100
- appDefId?: string;
101
- /**
102
- * The instance Id
103
- * @format GUID
104
- */
105
- instanceId?: string;
106
- }
107
- export interface Page {
108
- /**
109
- * the msid the page is on
110
- * @format GUID
111
- */
112
- metaSiteId?: string;
113
- /**
114
- * Invalidate by Page ID
115
- * @minLength 1
116
- */
117
- pageId?: string;
118
- }
119
- export interface URI {
120
- /**
121
- * the msid the URI is on
122
- * @format GUID
123
- */
124
- metaSiteId?: string;
125
- /**
126
- * URI path to invalidate (e.g. page/my/path) - without leading/trailing slashes
127
- * @minLength 1
128
- */
129
- uriPath?: string;
130
- }
131
- export interface File {
132
- /**
133
- * the msid the file is related to
134
- * @format GUID
135
- */
136
- metaSiteId?: string;
137
- /**
138
- * Invalidate by filename (for media files such as PDFs)
139
- * @minLength 1
140
- * @maxLength 256
141
- */
142
- fileName?: string;
143
- }
144
- export interface CustomTag {
145
- /**
146
- * the msid the tag is related to
147
- * @format GUID
148
- */
149
- metaSiteId?: string;
150
- /**
151
- * Tag to invalidate by
152
- * @minLength 1
153
- * @maxLength 256
154
- */
155
- tag?: string;
156
- }
157
- export interface CreateRibbonRequest {
158
- /** Ribbon to create. */
159
- ribbon: Ribbon;
160
- }
161
- export interface CreateRibbonResponse {
162
- /** Created ribbon. */
163
- ribbon?: Ribbon;
164
- }
165
- export interface GetRibbonRequest {
166
- /**
167
- * Ribbon ID.
168
- * @format GUID
169
- */
170
- ribbonId: string;
171
- /**
172
- * Fields to include in the response.
173
- *
174
- * Supported values: `ASSIGNED_PRODUCTS_COUNT`
175
- * @maxSize 100
176
- */
177
- fields?: RequestedFieldsWithLiterals[];
178
- }
179
- export declare enum RequestedFields {
180
- UNKNOWN_REQUESTED_FIELD = "UNKNOWN_REQUESTED_FIELD",
181
- ASSIGNED_PRODUCT_COUNT = "ASSIGNED_PRODUCT_COUNT"
182
- }
183
- /** @enumType */
184
- export type RequestedFieldsWithLiterals = RequestedFields | 'UNKNOWN_REQUESTED_FIELD' | 'ASSIGNED_PRODUCT_COUNT';
185
- export interface GetRibbonResponse {
186
- /** Ribbon. */
187
- ribbon?: Ribbon;
188
- }
189
- export interface UpdateRibbonRequest {
190
- /** Ribbon to update. */
191
- ribbon: Ribbon;
192
- /**
193
- * Fields to include in the response.
194
- *
195
- * Supported values: `ASSIGNED_PRODUCTS_COUNT`
196
- * @maxSize 100
197
- */
198
- fields?: RequestedFieldsWithLiterals[];
199
- }
200
- export interface UpdateRibbonResponse {
201
- /** Updated Ribbon. */
202
- ribbon?: Ribbon;
203
- }
204
- export interface DeleteRibbonRequest {
205
- /**
206
- * Ribbon ID.
207
- * @format GUID
208
- */
209
- ribbonId: string;
210
- }
211
- export interface DeleteRibbonResponse {
212
- }
213
- export interface QueryRibbonsRequest {
214
- /** Query options. */
215
- query?: CursorQuery;
216
- /**
217
- * Fields to include in the response.
218
- *
219
- * Supported values: `ASSIGNED_PRODUCTS_COUNT`
220
- * @maxSize 100
221
- */
222
- fields?: RequestedFieldsWithLiterals[];
223
- }
224
- export interface CursorQuery extends CursorQueryPagingMethodOneOf {
225
- /** 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`. */
226
- cursorPaging?: CursorPaging;
227
- /**
228
- * Filter object in the following format:
229
- * `"filter" : {
230
- * "fieldName1": "value1",
231
- * "fieldName2":{"$operator":"value2"}
232
- * }`
233
- * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
234
- */
235
- filter?: Record<string, any> | null;
236
- /**
237
- * Sort object in the following format:
238
- * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
239
- * @maxSize 4
240
- */
241
- sort?: Sorting[];
242
- }
243
- /** @oneof */
244
- export interface CursorQueryPagingMethodOneOf {
245
- /** 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`. */
246
- cursorPaging?: CursorPaging;
247
- }
248
- export interface Sorting {
249
- /**
250
- * Name of the field to sort by.
251
- * @maxLength 512
252
- */
253
- fieldName?: string;
254
- /** Sort order. */
255
- order?: SortOrderWithLiterals;
256
- }
257
- export declare enum SortOrder {
258
- /** Ascending order. */
259
- ASC = "ASC",
260
- /** Descending order. */
261
- DESC = "DESC"
262
- }
263
- /** @enumType */
264
- export type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
265
- export interface CursorPaging {
266
- /**
267
- * Maximum number of items to return in the results.
268
- * @max 100
269
- */
270
- limit?: number | null;
271
- /**
272
- * Pointer to the next or previous page in the list of results.
273
- *
274
- * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
275
- * Not relevant for the first request.
276
- * @maxLength 16000
277
- */
278
- cursor?: string | null;
279
- }
280
- export interface QueryRibbonsResponse {
281
- /**
282
- * List of ribbons.
283
- * @minSize 1
284
- * @maxSize 100
285
- */
286
- ribbons?: Ribbon[];
287
- /** Details on the paged set of results returned. */
288
- pagingMetadata?: CursorPagingMetadata;
289
- }
290
- export interface CursorPagingMetadata {
291
- /** Number of items returned in the response. */
292
- count?: number | null;
293
- /** Cursor strings that point to the next page, previous page, or both. */
294
- cursors?: Cursors;
295
- /**
296
- * Whether there are more pages to retrieve following the current page.
297
- *
298
- * + `true`: Another page of results can be retrieved.
299
- * + `false`: This is the last page.
300
- */
301
- hasNext?: boolean | null;
302
- }
303
- export interface Cursors {
304
- /**
305
- * Cursor string pointing to the next page in the list of results.
306
- * @maxLength 16000
307
- */
308
- next?: string | null;
309
- /**
310
- * Cursor pointing to the previous page in the list of results.
311
- * @maxLength 16000
312
- */
313
- prev?: string | null;
314
- }
315
- export interface BulkCreateRibbonsRequest {
316
- /**
317
- * Ribbons to create.
318
- * @minSize 1
319
- * @maxSize 100
320
- */
321
- ribbons: Ribbon[];
322
- /**
323
- * Whether to return the full created ribbon entities in the response.
324
- *
325
- * Default: `false`
326
- */
327
- returnEntity?: boolean;
328
- }
329
- export interface BulkCreateRibbonsResponse {
330
- /**
331
- * Ribbons created by bulk action.
332
- * @maxSize 100
333
- */
334
- results?: V3BulkRibbonResult[];
335
- /** Bulk action metadata. */
336
- bulkActionMetadata?: BulkActionMetadata;
337
- }
338
- export interface V3BulkRibbonResult {
339
- /** Bulk action metadata for ribbon. */
340
- itemMetadata?: ItemMetadata;
341
- /**
342
- * Full ribbon entity.
343
- *
344
- * Returned only if `returnEntity: true` is passed in the request.
345
- */
346
- item?: Ribbon;
347
- }
348
- export interface ItemMetadata {
349
- /**
350
- * Item ID. Should always be available, unless it's impossible (for example, when failing to create an item).
351
- * @format GUID
352
- */
353
- _id?: string | null;
354
- /** Index of the item within the request array. Allows for correlation between request and response items. */
355
- originalIndex?: number;
356
- /** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
357
- success?: boolean;
358
- /** Details about the error in case of failure. */
359
- error?: ApplicationError;
360
- }
361
- export interface ApplicationError {
362
- /** Error code. */
363
- code?: string;
364
- /** Description of the error. */
365
- description?: string;
366
- /** Data related to the error. */
367
- data?: Record<string, any> | null;
368
- }
369
- export interface BulkActionMetadata {
370
- /** Number of items that were successfully processed. */
371
- totalSuccesses?: number;
372
- /** Number of items that couldn't be processed. */
373
- totalFailures?: number;
374
- /** Number of failures without details because detailed failure threshold was exceeded. */
375
- undetailedFailures?: number;
376
- }
377
- export interface BulkUpdateRibbonsRequest {
378
- /**
379
- * List of ribbons to update.
380
- * @minSize 1
381
- * @maxSize 100
382
- */
383
- ribbons: MaskedRibbon[];
384
- /**
385
- * Whether to return the full updated ribbon entities in the response.
386
- *
387
- * Default: `false`
388
- */
389
- returnEntity?: boolean;
390
- /**
391
- * Fields to include in the response.
392
- *
393
- * Supported values: `ASSIGNED_PRODUCTS_COUNT`
394
- * @maxSize 100
395
- */
396
- fields?: RequestedFieldsWithLiterals[];
397
- }
398
- export interface MaskedRibbon {
399
- /** Ribbon to update. */
400
- ribbon?: Ribbon;
401
- /** Explicit list of fields to update. */
402
- fieldMask?: string[];
403
- }
404
- export interface BulkUpdateRibbonsResponse {
405
- /**
406
- * Ribbons updated by bulk action.
407
- * @maxSize 100
408
- */
409
- results?: V3BulkRibbonResult[];
410
- /** Bulk action metadata. */
411
- bulkActionMetadata?: BulkActionMetadata;
412
- }
413
- export interface GetOrCreateRibbonRequest {
414
- /**
415
- * Ribbon name to retrieve or create.
416
- * @minLength 1
417
- * @maxLength 30
418
- */
419
- ribbonName: string;
420
- /**
421
- * Fields to include in the response.
422
- *
423
- * Supported values: `ASSIGNED_PRODUCTS_COUNT`
424
- * @maxSize 100
425
- */
426
- fields?: RequestedFieldsWithLiterals[];
427
- }
428
- export interface GetOrCreateRibbonResponse {
429
- /** Ribbon. */
430
- ribbon?: Ribbon;
431
- }
432
- export interface BulkGetOrCreateRibbonsRequest {
433
- /**
434
- * Ribbon names to retrieve or create.
435
- * @minLength 1
436
- * @maxLength 30
437
- * @minSize 1
438
- * @maxSize 100
439
- */
440
- ribbonNames: string[];
441
- /**
442
- * Fields to include in the response.
443
- *
444
- * Supported values: `ASSIGNED_PRODUCTS_COUNT`
445
- * @maxSize 100
446
- */
447
- fields?: RequestedFieldsWithLiterals[];
448
- }
449
- export interface BulkGetOrCreateRibbonsResponse {
450
- /**
451
- * Ribbons retrieved or created by bulk action.
452
- * @maxSize 100
453
- */
454
- results?: V3BulkRibbonResult[];
455
- /** Bulk action metadata. */
456
- bulkActionMetadata?: BulkActionMetadata;
457
- }
458
- export interface BulkDeleteRibbonsRequest {
459
- /**
460
- * IDs of ribbons to delete.
461
- * @format GUID
462
- * @minSize 1
463
- * @maxSize 100
464
- */
465
- ribbonIds: string[];
466
- }
467
- export interface BulkDeleteRibbonsResponse {
468
- /**
469
- * Ribbons deleted by bulk action.
470
- * @maxSize 100
471
- */
472
- results?: BulkRibbonResult[];
473
- /** Bulk action metadata. */
474
- bulkActionMetadata?: BulkActionMetadata;
475
- }
476
- export interface BulkRibbonResult {
477
- /** Bulk action metadata for ribbon. */
478
- itemMetadata?: ItemMetadata;
479
- }
480
- export interface DomainEvent extends DomainEventBodyOneOf {
481
- createdEvent?: EntityCreatedEvent;
482
- updatedEvent?: EntityUpdatedEvent;
483
- deletedEvent?: EntityDeletedEvent;
484
- actionEvent?: ActionEvent;
485
- /** Event ID. With this ID you can easily spot duplicated events and ignore them. */
486
- _id?: string;
487
- /**
488
- * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
489
- * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
490
- */
491
- entityFqdn?: string;
492
- /**
493
- * Event action name, placed at the top level to make it easier for users to dispatch messages.
494
- * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
495
- */
496
- slug?: string;
497
- /** ID of the entity associated with the event. */
498
- entityId?: string;
499
- /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
500
- eventTime?: Date | null;
501
- /**
502
- * Whether the event was triggered as a result of a privacy regulation application
503
- * (for example, GDPR).
504
- */
505
- triggeredByAnonymizeRequest?: boolean | null;
506
- /** If present, indicates the action that triggered the event. */
507
- originatedFrom?: string | null;
508
- /**
509
- * 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.
510
- * 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.
511
- */
512
- entityEventSequence?: string | null;
513
- }
514
- /** @oneof */
515
- export interface DomainEventBodyOneOf {
516
- createdEvent?: EntityCreatedEvent;
517
- updatedEvent?: EntityUpdatedEvent;
518
- deletedEvent?: EntityDeletedEvent;
519
- actionEvent?: ActionEvent;
520
- }
521
- export interface EntityCreatedEvent {
522
- entity?: string;
523
- }
524
- export interface RestoreInfo {
525
- deletedDate?: Date | null;
526
- }
527
- export interface EntityUpdatedEvent {
528
- /**
529
- * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
530
- * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
531
- * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
532
- */
533
- currentEntity?: string;
534
- }
535
- export interface EntityDeletedEvent {
536
- /** Entity that was deleted. */
537
- deletedEntity?: string | null;
538
- }
539
- export interface ActionEvent {
540
- body?: string;
541
- }
542
- export interface Empty {
543
- }
544
- export interface MessageEnvelope {
545
- /**
546
- * App instance ID.
547
- * @format GUID
548
- */
549
- instanceId?: string | null;
550
- /**
551
- * Event type.
552
- * @maxLength 150
553
- */
554
- eventType?: string;
555
- /** The identification type and identity data. */
556
- identity?: IdentificationData;
557
- /** Stringify payload. */
558
- data?: string;
559
- }
560
- export interface IdentificationData extends IdentificationDataIdOneOf {
561
- /**
562
- * ID of a site visitor that has not logged in to the site.
563
- * @format GUID
564
- */
565
- anonymousVisitorId?: string;
566
- /**
567
- * ID of a site visitor that has logged in to the site.
568
- * @format GUID
569
- */
570
- memberId?: string;
571
- /**
572
- * ID of a Wix user (site owner, contributor, etc.).
573
- * @format GUID
574
- */
575
- wixUserId?: string;
576
- /**
577
- * ID of an app.
578
- * @format GUID
579
- */
580
- appId?: string;
581
- /** @readonly */
582
- identityType?: WebhookIdentityTypeWithLiterals;
583
- }
584
- /** @oneof */
585
- export interface IdentificationDataIdOneOf {
586
- /**
587
- * ID of a site visitor that has not logged in to the site.
588
- * @format GUID
589
- */
590
- anonymousVisitorId?: string;
591
- /**
592
- * ID of a site visitor that has logged in to the site.
593
- * @format GUID
594
- */
595
- memberId?: string;
596
- /**
597
- * ID of a Wix user (site owner, contributor, etc.).
598
- * @format GUID
599
- */
600
- wixUserId?: string;
601
- /**
602
- * ID of an app.
603
- * @format GUID
604
- */
605
- appId?: string;
606
- }
607
- export declare enum WebhookIdentityType {
608
- UNKNOWN = "UNKNOWN",
609
- ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
610
- MEMBER = "MEMBER",
611
- WIX_USER = "WIX_USER",
612
- APP = "APP"
613
- }
614
- /** @enumType */
615
- export type WebhookIdentityTypeWithLiterals = WebhookIdentityType | 'UNKNOWN' | 'ANONYMOUS_VISITOR' | 'MEMBER' | 'WIX_USER' | 'APP';
616
- export interface BaseEventMetadata {
617
- /**
618
- * App instance ID.
619
- * @format GUID
620
- */
621
- instanceId?: string | null;
622
- /**
623
- * Event type.
624
- * @maxLength 150
625
- */
626
- eventType?: string;
627
- /** The identification type and identity data. */
628
- identity?: IdentificationData;
629
- }
630
- export interface EventMetadata extends BaseEventMetadata {
631
- /** Event ID. With this ID you can easily spot duplicated events and ignore them. */
632
- _id?: string;
633
- /**
634
- * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
635
- * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
636
- */
637
- entityFqdn?: string;
638
- /**
639
- * Event action name, placed at the top level to make it easier for users to dispatch messages.
640
- * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
641
- */
642
- slug?: string;
643
- /** ID of the entity associated with the event. */
644
- entityId?: string;
645
- /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
646
- eventTime?: Date | null;
647
- /**
648
- * Whether the event was triggered as a result of a privacy regulation application
649
- * (for example, GDPR).
650
- */
651
- triggeredByAnonymizeRequest?: boolean | null;
652
- /** If present, indicates the action that triggered the event. */
653
- originatedFrom?: string | null;
654
- /**
655
- * 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.
656
- * 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.
657
- */
658
- entityEventSequence?: string | null;
659
- }
660
- export interface RibbonCreatedEnvelope {
661
- entity: Ribbon;
662
- metadata: EventMetadata;
663
- }
664
- /** @permissionScope Manage Stores - all permissions
665
- * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
666
- * @permissionScope Read ribbons in v3 catalog
667
- * @permissionScopeId SCOPE.STORES.RIBBON_READ
668
- * @permissionScope Manage Stores
669
- * @permissionScopeId SCOPE.STORES.MANAGE-STORES
670
- * @permissionScope Read v3 catalog
671
- * @permissionScopeId SCOPE.STORES.CATALOG_READ
672
- * @permissionScope Manage Products
673
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
674
- * @permissionScope Read Stores - all read permissions
675
- * @permissionScopeId SCOPE.DC-STORES-MEGA.READ-STORES
676
- * @permissionScope Read Products
677
- * @permissionScopeId SCOPE.DC-STORES.READ-PRODUCTS
678
- * @permissionScope Manage Restaurants - all permissions
679
- * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
680
- * @permissionScope Product write in v3 catalog
681
- * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
682
- * @permissionScope Manage v3 catalog
683
- * @permissionScopeId SCOPE.STORES.CATALOG_WRITE
684
- * @permissionScope Manage Orders
685
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-ORDERS
686
- * @permissionId WIX_STORES.RIBBON_READ
687
- * @webhook
688
- * @eventType wix.stores.catalog.v3.ribbon_created
689
- * @slug created
690
- * @documentationMaturity preview
691
- */
692
- export declare function onRibbonCreated(handler: (event: RibbonCreatedEnvelope) => void | Promise<void>): void;
693
- export interface RibbonDeletedEnvelope {
694
- entity: Ribbon;
695
- metadata: EventMetadata;
696
- }
697
- /** @permissionScope Manage Stores - all permissions
698
- * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
699
- * @permissionScope Read ribbons in v3 catalog
700
- * @permissionScopeId SCOPE.STORES.RIBBON_READ
701
- * @permissionScope Manage Stores
702
- * @permissionScopeId SCOPE.STORES.MANAGE-STORES
703
- * @permissionScope Read v3 catalog
704
- * @permissionScopeId SCOPE.STORES.CATALOG_READ
705
- * @permissionScope Manage Products
706
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
707
- * @permissionScope Read Stores - all read permissions
708
- * @permissionScopeId SCOPE.DC-STORES-MEGA.READ-STORES
709
- * @permissionScope Read Products
710
- * @permissionScopeId SCOPE.DC-STORES.READ-PRODUCTS
711
- * @permissionScope Manage Restaurants - all permissions
712
- * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
713
- * @permissionScope Product write in v3 catalog
714
- * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
715
- * @permissionScope Manage v3 catalog
716
- * @permissionScopeId SCOPE.STORES.CATALOG_WRITE
717
- * @permissionScope Manage Orders
718
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-ORDERS
719
- * @permissionId WIX_STORES.RIBBON_READ
720
- * @webhook
721
- * @eventType wix.stores.catalog.v3.ribbon_deleted
722
- * @slug deleted
723
- * @documentationMaturity preview
724
- */
725
- export declare function onRibbonDeleted(handler: (event: RibbonDeletedEnvelope) => void | Promise<void>): void;
726
- export interface RibbonUpdatedEnvelope {
727
- entity: Ribbon;
728
- metadata: EventMetadata;
729
- }
730
- /** @permissionScope Manage Stores - all permissions
731
- * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
732
- * @permissionScope Read ribbons in v3 catalog
733
- * @permissionScopeId SCOPE.STORES.RIBBON_READ
734
- * @permissionScope Manage Stores
735
- * @permissionScopeId SCOPE.STORES.MANAGE-STORES
736
- * @permissionScope Read v3 catalog
737
- * @permissionScopeId SCOPE.STORES.CATALOG_READ
738
- * @permissionScope Manage Products
739
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
740
- * @permissionScope Read Stores - all read permissions
741
- * @permissionScopeId SCOPE.DC-STORES-MEGA.READ-STORES
742
- * @permissionScope Read Products
743
- * @permissionScopeId SCOPE.DC-STORES.READ-PRODUCTS
744
- * @permissionScope Manage Restaurants - all permissions
745
- * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
746
- * @permissionScope Product write in v3 catalog
747
- * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
748
- * @permissionScope Manage v3 catalog
749
- * @permissionScopeId SCOPE.STORES.CATALOG_WRITE
750
- * @permissionScope Manage Orders
751
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-ORDERS
752
- * @permissionId WIX_STORES.RIBBON_READ
753
- * @webhook
754
- * @eventType wix.stores.catalog.v3.ribbon_updated
755
- * @slug updated
756
- * @documentationMaturity preview
757
- */
758
- export declare function onRibbonUpdated(handler: (event: RibbonUpdatedEnvelope) => void | Promise<void>): void;
759
- type RibbonNonNullablePaths = `name`;
760
- /**
761
- * Creates a ribbon.
762
- *
763
- * To assign the ribbon to a product, include the `ribbon.id` or `ribbon.name` when [creating](https://dev.wix.com/docs/rest/business-solutions/stores/catalog-v3/products-v3/create-product) or [updating](https://dev.wix.com/docs/rest/business-solutions/stores/catalog-v3/products-v3/update-product) a product.
764
- * @param ribbon - Ribbon to create.
765
- * @public
766
- * @documentationMaturity preview
767
- * @requiredField ribbon
768
- * @requiredField ribbon.name
769
- * @permissionId WIX_STORES.RIBBON_CREATE
770
- * @permissionScope Manage Stores - all permissions
771
- * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
772
- * @permissionScope Manage Stores
773
- * @permissionScopeId SCOPE.STORES.MANAGE-STORES
774
- * @permissionScope Manage Products
775
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
776
- * @permissionScope Ribbon write in v3 catalog
777
- * @permissionScopeId SCOPE.STORES.RIBBON_WRITE
778
- * @permissionScope Product write in v3 catalog
779
- * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
780
- * @permissionScope Manage v3 catalog
781
- * @permissionScopeId SCOPE.STORES.CATALOG_WRITE
782
- * @applicableIdentity APP
783
- * @returns Created ribbon.
784
- * @fqn wix.stores.catalog.ribbon.v3.RibbonService.CreateRibbon
785
- */
786
- export declare function createRibbon(ribbon: NonNullablePaths<Ribbon, `name`>): Promise<NonNullablePaths<Ribbon, RibbonNonNullablePaths>>;
787
- /**
788
- * Retrieves a ribbon.
789
- * @param ribbonId - Ribbon ID.
790
- * @public
791
- * @documentationMaturity preview
792
- * @requiredField ribbonId
793
- * @permissionId WIX_STORES.RIBBON_READ
794
- * @permissionScope Manage Stores - all permissions
795
- * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
796
- * @permissionScope Read ribbons in v3 catalog
797
- * @permissionScopeId SCOPE.STORES.RIBBON_READ
798
- * @permissionScope Manage Stores
799
- * @permissionScopeId SCOPE.STORES.MANAGE-STORES
800
- * @permissionScope Read v3 catalog
801
- * @permissionScopeId SCOPE.STORES.CATALOG_READ
802
- * @permissionScope Manage Products
803
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
804
- * @permissionScope Read Stores - all read permissions
805
- * @permissionScopeId SCOPE.DC-STORES-MEGA.READ-STORES
806
- * @permissionScope Read Products
807
- * @permissionScopeId SCOPE.DC-STORES.READ-PRODUCTS
808
- * @permissionScope Manage Restaurants - all permissions
809
- * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
810
- * @permissionScope Product write in v3 catalog
811
- * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
812
- * @permissionScope Manage v3 catalog
813
- * @permissionScopeId SCOPE.STORES.CATALOG_WRITE
814
- * @permissionScope Manage Orders
815
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-ORDERS
816
- * @applicableIdentity APP
817
- * @returns Ribbon.
818
- * @fqn wix.stores.catalog.ribbon.v3.RibbonService.GetRibbon
819
- */
820
- export declare function getRibbon(ribbonId: string, options?: GetRibbonOptions): Promise<NonNullablePaths<Ribbon, RibbonNonNullablePaths>>;
821
- export interface GetRibbonOptions {
822
- /**
823
- * Fields to include in the response.
824
- *
825
- * Supported values: `ASSIGNED_PRODUCTS_COUNT`
826
- * @maxSize 100
827
- */
828
- fields?: RequestedFieldsWithLiterals[];
829
- }
830
- /**
831
- * Updates a ribbon.
832
- *
833
- *
834
- * Each time the ribbon is updated, `revision` increments by 1.
835
- * The current `revision` must be passed when updating the ribbon.
836
- * This ensures you're working with the latest ribbon and prevents unintended overwrites.
837
- * @param _id - Ribbon ID.
838
- * @public
839
- * @documentationMaturity preview
840
- * @requiredField _id
841
- * @requiredField ribbon
842
- * @requiredField ribbon.revision
843
- * @permissionId WIX_STORES.RIBBON_UPDATE
844
- * @permissionScope Manage Stores - all permissions
845
- * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
846
- * @permissionScope Manage Stores
847
- * @permissionScopeId SCOPE.STORES.MANAGE-STORES
848
- * @permissionScope Manage Products
849
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
850
- * @permissionScope Ribbon write in v3 catalog
851
- * @permissionScopeId SCOPE.STORES.RIBBON_WRITE
852
- * @permissionScope Product write in v3 catalog
853
- * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
854
- * @permissionScope Manage v3 catalog
855
- * @permissionScopeId SCOPE.STORES.CATALOG_WRITE
856
- * @applicableIdentity APP
857
- * @returns Updated Ribbon.
858
- * @fqn wix.stores.catalog.ribbon.v3.RibbonService.UpdateRibbon
859
- */
860
- export declare function updateRibbon(_id: string, ribbon: NonNullablePaths<UpdateRibbon, `revision`>, options?: UpdateRibbonOptions): Promise<NonNullablePaths<Ribbon, RibbonNonNullablePaths>>;
861
- export interface UpdateRibbon {
862
- /**
863
- * Ribbon ID.
864
- * @format GUID
865
- * @readonly
866
- */
867
- _id?: string | null;
868
- /**
869
- * Revision number, which increments by 1 each time the ribbon is updated.
870
- * To prevent conflicting changes,
871
- * the current revision must be passed when updating the ribbon.
872
- *
873
- * Ignored when creating a ribbon.
874
- * @readonly
875
- */
876
- revision?: string | null;
877
- /**
878
- * Date and time the ribbon was created.
879
- * @readonly
880
- */
881
- _createdDate?: Date | null;
882
- /**
883
- * Date and time the ribbon was updated.
884
- * @readonly
885
- */
886
- _updatedDate?: Date | null;
887
- /**
888
- * Ribbon name.
889
- * @minLength 1
890
- * @maxLength 30
891
- */
892
- name?: string;
893
- /**
894
- * Number of products this ribbon is assigned to.
895
- * > **Note:** Returned only when you pass `"ASSIGNED_PRODUCT_COUNT"` to the `fields` array in Ribbon API requests.
896
- * @readonly
897
- */
898
- assignedProductCount?: number | null;
899
- }
900
- export interface UpdateRibbonOptions {
901
- /**
902
- * Fields to include in the response.
903
- *
904
- * Supported values: `ASSIGNED_PRODUCTS_COUNT`
905
- * @maxSize 100
906
- */
907
- fields?: RequestedFieldsWithLiterals[];
908
- }
909
- /**
910
- * Deletes a ribbon.
911
- *
912
- *
913
- * > **Note:** Deleting a ribbon will also remove it from all products it is assigned to.
914
- * @param ribbonId - Ribbon ID.
915
- * @public
916
- * @documentationMaturity preview
917
- * @requiredField ribbonId
918
- * @permissionId WIX_STORES.RIBBON_DELETE
919
- * @permissionScope Manage Stores - all permissions
920
- * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
921
- * @permissionScope Manage Stores
922
- * @permissionScopeId SCOPE.STORES.MANAGE-STORES
923
- * @permissionScope Manage Products
924
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
925
- * @permissionScope Ribbon write in v3 catalog
926
- * @permissionScopeId SCOPE.STORES.RIBBON_WRITE
927
- * @permissionScope Product write in v3 catalog
928
- * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
929
- * @permissionScope Manage v3 catalog
930
- * @permissionScopeId SCOPE.STORES.CATALOG_WRITE
931
- * @applicableIdentity APP
932
- * @fqn wix.stores.catalog.ribbon.v3.RibbonService.DeleteRibbon
933
- */
934
- export declare function deleteRibbon(ribbonId: string): Promise<void>;
935
- /**
936
- * Retrieves a list of up to 100 ribbons, given the provided filtering, sorting, and cursor paging.
937
- * Pass supported values to the `fields` array in the request to include those fields in the response.
938
- *
939
- *
940
- * Query Brands runs with these defaults, which you can override:
941
- *
942
- * - `createdDate` is sorted in `DESC` order
943
- * - `cursorPaging.limit` is `100`
944
- *
945
- * For field support for filters and sorting,
946
- * see [Ribbons: Supported Filters and Sorting](https://dev.wix.com/docs/rest/business-solutions/stores/catalog-v3/ribbons-v3/supported-filters-and-sorting).
947
- *
948
- * To learn about working with _Query_ endpoints, see
949
- * [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language),
950
- * and [Sorting and Paging](https://dev.wix.com/docs/rest/articles/getting-started/sorting-and-paging).
951
- * @public
952
- * @documentationMaturity preview
953
- * @permissionScope Manage Stores - all permissions
954
- * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
955
- * @permissionScope Read ribbons in v3 catalog
956
- * @permissionScopeId SCOPE.STORES.RIBBON_READ
957
- * @permissionScope Manage Stores
958
- * @permissionScopeId SCOPE.STORES.MANAGE-STORES
959
- * @permissionScope Read v3 catalog
960
- * @permissionScopeId SCOPE.STORES.CATALOG_READ
961
- * @permissionScope Manage Products
962
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
963
- * @permissionScope Read Stores - all read permissions
964
- * @permissionScopeId SCOPE.DC-STORES-MEGA.READ-STORES
965
- * @permissionScope Read Products
966
- * @permissionScopeId SCOPE.DC-STORES.READ-PRODUCTS
967
- * @permissionScope Manage Restaurants - all permissions
968
- * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
969
- * @permissionScope Product write in v3 catalog
970
- * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
971
- * @permissionScope Manage v3 catalog
972
- * @permissionScopeId SCOPE.STORES.CATALOG_WRITE
973
- * @permissionScope Manage Orders
974
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-ORDERS
975
- * @permissionId WIX_STORES.RIBBON_READ
976
- * @applicableIdentity APP
977
- * @fqn wix.stores.catalog.ribbon.v3.RibbonService.QueryRibbons
978
- */
979
- export declare function queryRibbons(options?: QueryRibbonsOptions): RibbonsQueryBuilder;
980
- export interface QueryRibbonsOptions {
981
- /**
982
- * Fields to include in the response.
983
- *
984
- * Supported values: `ASSIGNED_PRODUCTS_COUNT`
985
- * @maxSize 100
986
- */
987
- fields?: RequestedFieldsWithLiterals[] | undefined;
988
- }
989
- interface QueryCursorResult {
990
- cursors: Cursors;
991
- hasNext: () => boolean;
992
- hasPrev: () => boolean;
993
- length: number;
994
- pageSize: number;
995
- }
996
- export interface RibbonsQueryResult extends QueryCursorResult {
997
- items: Ribbon[];
998
- query: RibbonsQueryBuilder;
999
- next: () => Promise<RibbonsQueryResult>;
1000
- prev: () => Promise<RibbonsQueryResult>;
1001
- }
1002
- export interface RibbonsQueryBuilder {
1003
- /** @param propertyName - Property whose value is compared with `value`.
1004
- * @param value - Value to compare against.
1005
- * @documentationMaturity preview
1006
- */
1007
- eq: (propertyName: '_id' | '_createdDate' | '_updatedDate' | 'name', value: any) => RibbonsQueryBuilder;
1008
- /** @param propertyName - Property whose value is compared with `value`.
1009
- * @param value - Value to compare against.
1010
- * @documentationMaturity preview
1011
- */
1012
- ne: (propertyName: '_id' | '_createdDate' | '_updatedDate' | 'name', value: any) => RibbonsQueryBuilder;
1013
- /** @param propertyName - Property whose value is compared with `value`.
1014
- * @param value - Value to compare against.
1015
- * @documentationMaturity preview
1016
- */
1017
- ge: (propertyName: '_id' | '_createdDate' | '_updatedDate' | 'name', value: any) => RibbonsQueryBuilder;
1018
- /** @param propertyName - Property whose value is compared with `value`.
1019
- * @param value - Value to compare against.
1020
- * @documentationMaturity preview
1021
- */
1022
- gt: (propertyName: '_id' | '_createdDate' | '_updatedDate' | 'name', value: any) => RibbonsQueryBuilder;
1023
- /** @param propertyName - Property whose value is compared with `value`.
1024
- * @param value - Value to compare against.
1025
- * @documentationMaturity preview
1026
- */
1027
- le: (propertyName: '_id' | '_createdDate' | '_updatedDate' | 'name', value: any) => RibbonsQueryBuilder;
1028
- /** @param propertyName - Property whose value is compared with `value`.
1029
- * @param value - Value to compare against.
1030
- * @documentationMaturity preview
1031
- */
1032
- lt: (propertyName: '_id' | '_createdDate' | '_updatedDate' | 'name', value: any) => RibbonsQueryBuilder;
1033
- /** @param propertyName - Property whose value is compared with `string`.
1034
- * @param string - String to compare against. Case-insensitive.
1035
- * @documentationMaturity preview
1036
- */
1037
- startsWith: (propertyName: '_id' | 'name', value: string) => RibbonsQueryBuilder;
1038
- /** @param propertyName - Property whose value is compared with `values`.
1039
- * @param values - List of values to compare against.
1040
- * @documentationMaturity preview
1041
- */
1042
- hasSome: (propertyName: '_id' | '_createdDate' | '_updatedDate' | 'name', value: any[]) => RibbonsQueryBuilder;
1043
- /** @documentationMaturity preview */
1044
- in: (propertyName: '_id' | '_createdDate' | '_updatedDate' | 'name', value: any) => RibbonsQueryBuilder;
1045
- /** @documentationMaturity preview */
1046
- exists: (propertyName: '_id' | '_createdDate' | '_updatedDate' | 'name', value: boolean) => RibbonsQueryBuilder;
1047
- /** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
1048
- * @documentationMaturity preview
1049
- */
1050
- ascending: (...propertyNames: Array<'_createdDate' | '_updatedDate' | 'name'>) => RibbonsQueryBuilder;
1051
- /** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
1052
- * @documentationMaturity preview
1053
- */
1054
- descending: (...propertyNames: Array<'_createdDate' | '_updatedDate' | 'name'>) => RibbonsQueryBuilder;
1055
- /** @param limit - Number of items to return, which is also the `pageSize` of the results object.
1056
- * @documentationMaturity preview
1057
- */
1058
- limit: (limit: number) => RibbonsQueryBuilder;
1059
- /** @param cursor - A pointer to specific record
1060
- * @documentationMaturity preview
1061
- */
1062
- skipTo: (cursor: string) => RibbonsQueryBuilder;
1063
- /** @documentationMaturity preview */
1064
- find: () => Promise<RibbonsQueryResult>;
1065
- }
1066
- /**
1067
- * Creates multiple ribbons.
1068
- * @param ribbons - Ribbons to create.
1069
- * @public
1070
- * @documentationMaturity preview
1071
- * @requiredField ribbons
1072
- * @requiredField ribbons.name
1073
- * @permissionId WIX_STORES.RIBBON_CREATE
1074
- * @permissionScope Manage Stores - all permissions
1075
- * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
1076
- * @permissionScope Manage Stores
1077
- * @permissionScopeId SCOPE.STORES.MANAGE-STORES
1078
- * @permissionScope Manage Products
1079
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
1080
- * @permissionScope Ribbon write in v3 catalog
1081
- * @permissionScopeId SCOPE.STORES.RIBBON_WRITE
1082
- * @permissionScope Product write in v3 catalog
1083
- * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
1084
- * @permissionScope Manage v3 catalog
1085
- * @permissionScopeId SCOPE.STORES.CATALOG_WRITE
1086
- * @applicableIdentity APP
1087
- * @fqn wix.stores.catalog.ribbon.v3.RibbonService.BulkCreateRibbons
1088
- */
1089
- export declare function bulkCreateRibbons(ribbons: NonNullablePaths<Ribbon, `name`>[], options?: BulkCreateRibbonsOptions): Promise<NonNullablePaths<BulkCreateRibbonsResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | {
1090
- [P in RibbonNonNullablePaths]: `results.${number}.item.${P}`;
1091
- }[RibbonNonNullablePaths] | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`>>;
1092
- export interface BulkCreateRibbonsOptions {
1093
- /**
1094
- * Whether to return the full created ribbon entities in the response.
1095
- *
1096
- * Default: `false`
1097
- */
1098
- returnEntity?: boolean;
1099
- }
1100
- /**
1101
- * Updates multiple ribbons.
1102
- *
1103
- * Each time a ribbon is updated, `revision` increments by 1.
1104
- * The current `revision` must be passed when updating a ribbon.
1105
- * This ensures you're working with the latest ribbon and prevents unintended overwrites.
1106
- * @param ribbons - List of ribbons to update.
1107
- * @public
1108
- * @documentationMaturity preview
1109
- * @requiredField ribbons
1110
- * @requiredField ribbons.ribbon._id
1111
- * @requiredField ribbons.ribbon.revision
1112
- * @permissionId WIX_STORES.RIBBON_UPDATE
1113
- * @permissionScope Manage Stores - all permissions
1114
- * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
1115
- * @permissionScope Manage Stores
1116
- * @permissionScopeId SCOPE.STORES.MANAGE-STORES
1117
- * @permissionScope Manage Products
1118
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
1119
- * @permissionScope Ribbon write in v3 catalog
1120
- * @permissionScopeId SCOPE.STORES.RIBBON_WRITE
1121
- * @permissionScope Product write in v3 catalog
1122
- * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
1123
- * @permissionScope Manage v3 catalog
1124
- * @permissionScopeId SCOPE.STORES.CATALOG_WRITE
1125
- * @applicableIdentity APP
1126
- * @fqn wix.stores.catalog.ribbon.v3.RibbonService.BulkUpdateRibbons
1127
- */
1128
- export declare function bulkUpdateRibbons(ribbons: NonNullablePaths<MaskedRibbon, `ribbon._id` | `ribbon.revision`>[], options?: BulkUpdateRibbonsOptions): Promise<NonNullablePaths<BulkUpdateRibbonsResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | {
1129
- [P in RibbonNonNullablePaths]: `results.${number}.item.${P}`;
1130
- }[RibbonNonNullablePaths] | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`>>;
1131
- export interface BulkUpdateRibbonsOptions {
1132
- /**
1133
- * Whether to return the full updated ribbon entities in the response.
1134
- *
1135
- * Default: `false`
1136
- */
1137
- returnEntity?: boolean;
1138
- /**
1139
- * Fields to include in the response.
1140
- *
1141
- * Supported values: `ASSIGNED_PRODUCTS_COUNT`
1142
- * @maxSize 100
1143
- */
1144
- fields?: RequestedFieldsWithLiterals[];
1145
- }
1146
- /**
1147
- * Retrieves a ribbon by name, or creates a ribbon if one with the passed `ribbonName` doesn't exist.
1148
- * @param ribbonName - Ribbon name to retrieve or create.
1149
- * @public
1150
- * @documentationMaturity preview
1151
- * @requiredField ribbonName
1152
- * @permissionId WIX_STORES.RIBBON_GET_OR_CREATE
1153
- * @permissionScope Manage Stores - all permissions
1154
- * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
1155
- * @permissionScope Manage Stores
1156
- * @permissionScopeId SCOPE.STORES.MANAGE-STORES
1157
- * @permissionScope Manage Products
1158
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
1159
- * @permissionScope Ribbon write in v3 catalog
1160
- * @permissionScopeId SCOPE.STORES.RIBBON_WRITE
1161
- * @permissionScope Product write in v3 catalog
1162
- * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
1163
- * @permissionScope Manage v3 catalog
1164
- * @permissionScopeId SCOPE.STORES.CATALOG_WRITE
1165
- * @applicableIdentity APP
1166
- * @fqn wix.stores.catalog.ribbon.v3.RibbonService.GetOrCreateRibbon
1167
- */
1168
- export declare function getOrCreateRibbon(ribbonName: string, options?: GetOrCreateRibbonOptions): Promise<NonNullablePaths<GetOrCreateRibbonResponse, {
1169
- [P in RibbonNonNullablePaths]: `ribbon.${P}`;
1170
- }[RibbonNonNullablePaths]>>;
1171
- export interface GetOrCreateRibbonOptions {
1172
- /**
1173
- * Fields to include in the response.
1174
- *
1175
- * Supported values: `ASSIGNED_PRODUCTS_COUNT`
1176
- * @maxSize 100
1177
- */
1178
- fields?: RequestedFieldsWithLiterals[];
1179
- }
1180
- /**
1181
- * Retrieves multiple ribbons by name, or creates multiple ribbons if those with the passed `ribbonNames` don't exist.
1182
- * @param ribbonNames - Ribbon names to retrieve or create.
1183
- * @public
1184
- * @documentationMaturity preview
1185
- * @requiredField ribbonNames
1186
- * @permissionId WIX_STORES.RIBBON_GET_OR_CREATE
1187
- * @permissionScope Manage Stores - all permissions
1188
- * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
1189
- * @permissionScope Manage Stores
1190
- * @permissionScopeId SCOPE.STORES.MANAGE-STORES
1191
- * @permissionScope Manage Products
1192
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
1193
- * @permissionScope Ribbon write in v3 catalog
1194
- * @permissionScopeId SCOPE.STORES.RIBBON_WRITE
1195
- * @permissionScope Product write in v3 catalog
1196
- * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
1197
- * @permissionScope Manage v3 catalog
1198
- * @permissionScopeId SCOPE.STORES.CATALOG_WRITE
1199
- * @applicableIdentity APP
1200
- * @fqn wix.stores.catalog.ribbon.v3.RibbonService.BulkGetOrCreateRibbons
1201
- */
1202
- export declare function bulkGetOrCreateRibbons(ribbonNames: string[], options?: BulkGetOrCreateRibbonsOptions): Promise<NonNullablePaths<BulkGetOrCreateRibbonsResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | {
1203
- [P in RibbonNonNullablePaths]: `results.${number}.item.${P}`;
1204
- }[RibbonNonNullablePaths] | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`>>;
1205
- export interface BulkGetOrCreateRibbonsOptions {
1206
- /**
1207
- * Fields to include in the response.
1208
- *
1209
- * Supported values: `ASSIGNED_PRODUCTS_COUNT`
1210
- * @maxSize 100
1211
- */
1212
- fields?: RequestedFieldsWithLiterals[];
1213
- }
1214
- /**
1215
- * Deletes multiple ribbons.
1216
- * @param ribbonIds - IDs of ribbons to delete.
1217
- * @public
1218
- * @documentationMaturity preview
1219
- * @requiredField ribbonIds
1220
- * @permissionId WIX_STORES.RIBBON_DELETE
1221
- * @permissionScope Manage Stores - all permissions
1222
- * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
1223
- * @permissionScope Manage Stores
1224
- * @permissionScopeId SCOPE.STORES.MANAGE-STORES
1225
- * @permissionScope Manage Products
1226
- * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
1227
- * @permissionScope Ribbon write in v3 catalog
1228
- * @permissionScopeId SCOPE.STORES.RIBBON_WRITE
1229
- * @permissionScope Product write in v3 catalog
1230
- * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
1231
- * @permissionScope Manage v3 catalog
1232
- * @permissionScopeId SCOPE.STORES.CATALOG_WRITE
1233
- * @applicableIdentity APP
1234
- * @fqn wix.stores.catalog.ribbon.v3.RibbonService.BulkDeleteRibbons
1235
- */
1236
- export declare function bulkDeleteRibbons(ribbonIds: string[]): Promise<NonNullablePaths<BulkDeleteRibbonsResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`>>;
1237
- export {};