@wix/auto_sdk_events_categories 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.
Files changed (111) hide show
  1. package/build/cjs/index.d.ts +1 -0
  2. package/build/cjs/index.js +18 -0
  3. package/build/cjs/index.js.map +1 -0
  4. package/build/cjs/index.typings.d.ts +1 -0
  5. package/build/cjs/index.typings.js +18 -0
  6. package/build/cjs/index.typings.js.map +1 -0
  7. package/build/cjs/meta.d.ts +1 -0
  8. package/build/cjs/meta.js +18 -0
  9. package/build/cjs/meta.js.map +1 -0
  10. package/build/cjs/src/events-v1-category-categories.context.d.ts +17 -0
  11. package/build/cjs/src/events-v1-category-categories.context.js +24 -0
  12. package/build/cjs/src/events-v1-category-categories.context.js.map +1 -0
  13. package/build/cjs/src/events-v1-category-categories.http.d.ts +57 -0
  14. package/build/cjs/src/events-v1-category-categories.http.js +851 -0
  15. package/build/cjs/src/events-v1-category-categories.http.js.map +1 -0
  16. package/build/cjs/src/events-v1-category-categories.meta.d.ts +37 -0
  17. package/build/cjs/src/events-v1-category-categories.meta.js +275 -0
  18. package/build/cjs/src/events-v1-category-categories.meta.js.map +1 -0
  19. package/build/cjs/src/events-v1-category-categories.public.d.ts +141 -0
  20. package/build/cjs/src/events-v1-category-categories.public.js +89 -0
  21. package/build/cjs/src/events-v1-category-categories.public.js.map +1 -0
  22. package/build/cjs/src/events-v1-category-categories.types.d.ts +430 -0
  23. package/build/cjs/src/events-v1-category-categories.types.js +33 -0
  24. package/build/cjs/src/events-v1-category-categories.types.js.map +1 -0
  25. package/build/cjs/src/events-v1-category-categories.universal.d.ts +748 -0
  26. package/build/cjs/src/events-v1-category-categories.universal.js +605 -0
  27. package/build/cjs/src/events-v1-category-categories.universal.js.map +1 -0
  28. package/build/es/index.d.ts +1 -0
  29. package/build/es/index.js +2 -0
  30. package/build/es/index.js.map +1 -0
  31. package/build/es/index.typings.d.ts +1 -0
  32. package/build/es/index.typings.js +2 -0
  33. package/build/es/index.typings.js.map +1 -0
  34. package/build/es/meta.d.ts +1 -0
  35. package/build/es/meta.js +2 -0
  36. package/build/es/meta.js.map +1 -0
  37. package/build/es/package.json +3 -0
  38. package/build/es/src/events-v1-category-categories.context.d.ts +17 -0
  39. package/build/es/src/events-v1-category-categories.context.js +17 -0
  40. package/build/es/src/events-v1-category-categories.context.js.map +1 -0
  41. package/build/es/src/events-v1-category-categories.http.d.ts +57 -0
  42. package/build/es/src/events-v1-category-categories.http.js +835 -0
  43. package/build/es/src/events-v1-category-categories.http.js.map +1 -0
  44. package/build/es/src/events-v1-category-categories.meta.d.ts +37 -0
  45. package/build/es/src/events-v1-category-categories.meta.js +236 -0
  46. package/build/es/src/events-v1-category-categories.meta.js.map +1 -0
  47. package/build/es/src/events-v1-category-categories.public.d.ts +141 -0
  48. package/build/es/src/events-v1-category-categories.public.js +69 -0
  49. package/build/es/src/events-v1-category-categories.public.js.map +1 -0
  50. package/build/es/src/events-v1-category-categories.types.d.ts +430 -0
  51. package/build/es/src/events-v1-category-categories.types.js +30 -0
  52. package/build/es/src/events-v1-category-categories.types.js.map +1 -0
  53. package/build/es/src/events-v1-category-categories.universal.d.ts +748 -0
  54. package/build/es/src/events-v1-category-categories.universal.js +566 -0
  55. package/build/es/src/events-v1-category-categories.universal.js.map +1 -0
  56. package/build/internal/cjs/index.d.ts +1 -0
  57. package/build/internal/cjs/index.js +18 -0
  58. package/build/internal/cjs/index.js.map +1 -0
  59. package/build/internal/cjs/index.typings.d.ts +1 -0
  60. package/build/internal/cjs/index.typings.js +18 -0
  61. package/build/internal/cjs/index.typings.js.map +1 -0
  62. package/build/internal/cjs/meta.d.ts +1 -0
  63. package/build/internal/cjs/meta.js +18 -0
  64. package/build/internal/cjs/meta.js.map +1 -0
  65. package/build/internal/cjs/src/events-v1-category-categories.context.d.ts +17 -0
  66. package/build/internal/cjs/src/events-v1-category-categories.context.js +24 -0
  67. package/build/internal/cjs/src/events-v1-category-categories.context.js.map +1 -0
  68. package/build/internal/cjs/src/events-v1-category-categories.http.d.ts +57 -0
  69. package/build/internal/cjs/src/events-v1-category-categories.http.js +851 -0
  70. package/build/internal/cjs/src/events-v1-category-categories.http.js.map +1 -0
  71. package/build/internal/cjs/src/events-v1-category-categories.meta.d.ts +37 -0
  72. package/build/internal/cjs/src/events-v1-category-categories.meta.js +275 -0
  73. package/build/internal/cjs/src/events-v1-category-categories.meta.js.map +1 -0
  74. package/build/internal/cjs/src/events-v1-category-categories.public.d.ts +141 -0
  75. package/build/internal/cjs/src/events-v1-category-categories.public.js +89 -0
  76. package/build/internal/cjs/src/events-v1-category-categories.public.js.map +1 -0
  77. package/build/internal/cjs/src/events-v1-category-categories.types.d.ts +430 -0
  78. package/build/internal/cjs/src/events-v1-category-categories.types.js +33 -0
  79. package/build/internal/cjs/src/events-v1-category-categories.types.js.map +1 -0
  80. package/build/internal/cjs/src/events-v1-category-categories.universal.d.ts +748 -0
  81. package/build/internal/cjs/src/events-v1-category-categories.universal.js +605 -0
  82. package/build/internal/cjs/src/events-v1-category-categories.universal.js.map +1 -0
  83. package/build/internal/es/index.d.ts +1 -0
  84. package/build/internal/es/index.js +2 -0
  85. package/build/internal/es/index.js.map +1 -0
  86. package/build/internal/es/index.typings.d.ts +1 -0
  87. package/build/internal/es/index.typings.js +2 -0
  88. package/build/internal/es/index.typings.js.map +1 -0
  89. package/build/internal/es/meta.d.ts +1 -0
  90. package/build/internal/es/meta.js +2 -0
  91. package/build/internal/es/meta.js.map +1 -0
  92. package/build/internal/es/src/events-v1-category-categories.context.d.ts +17 -0
  93. package/build/internal/es/src/events-v1-category-categories.context.js +17 -0
  94. package/build/internal/es/src/events-v1-category-categories.context.js.map +1 -0
  95. package/build/internal/es/src/events-v1-category-categories.http.d.ts +57 -0
  96. package/build/internal/es/src/events-v1-category-categories.http.js +835 -0
  97. package/build/internal/es/src/events-v1-category-categories.http.js.map +1 -0
  98. package/build/internal/es/src/events-v1-category-categories.meta.d.ts +37 -0
  99. package/build/internal/es/src/events-v1-category-categories.meta.js +236 -0
  100. package/build/internal/es/src/events-v1-category-categories.meta.js.map +1 -0
  101. package/build/internal/es/src/events-v1-category-categories.public.d.ts +141 -0
  102. package/build/internal/es/src/events-v1-category-categories.public.js +69 -0
  103. package/build/internal/es/src/events-v1-category-categories.public.js.map +1 -0
  104. package/build/internal/es/src/events-v1-category-categories.types.d.ts +430 -0
  105. package/build/internal/es/src/events-v1-category-categories.types.js +30 -0
  106. package/build/internal/es/src/events-v1-category-categories.types.js.map +1 -0
  107. package/build/internal/es/src/events-v1-category-categories.universal.d.ts +748 -0
  108. package/build/internal/es/src/events-v1-category-categories.universal.js +566 -0
  109. package/build/internal/es/src/events-v1-category-categories.universal.js.map +1 -0
  110. package/meta/package.json +3 -0
  111. package/package.json +52 -0
@@ -0,0 +1,748 @@
1
+ export interface Category {
2
+ /**
3
+ * Category ID.
4
+ * @readonly
5
+ */
6
+ _id?: string;
7
+ /** Category name. */
8
+ name?: string;
9
+ /**
10
+ * Date and time when category was created.
11
+ * @readonly
12
+ */
13
+ _createdDate?: Date | null;
14
+ /**
15
+ * The total number of draft and published events assigned to the category.
16
+ * @readonly
17
+ */
18
+ counts?: CategoryCounts;
19
+ /**
20
+ * Category state. Possible values:
21
+ * - `MANUAL`: Category is created manually by the user.
22
+ * - `AUTO`: Category is created automatically.
23
+ * - `RECURRING_EVENT`: Category is created automatically when publishing recurring events.
24
+ * - `HIDDEN`: Category can't be seen.
25
+ *
26
+ * Default: `MANUAL`.
27
+ *
28
+ * **Note:** The WIX_EVENTS.MANAGE_AUTO_CATEGORIES permission is required to use states other than `MANUAL`.
29
+ */
30
+ states?: State[];
31
+ }
32
+ export interface CategoryCounts {
33
+ /** Total number of published events assigned to the category. Deleted events are excluded. */
34
+ assignedEventsCount?: number | null;
35
+ /** Total number of draft events assigned to the category. */
36
+ assignedDraftEventsCount?: number | null;
37
+ }
38
+ export declare enum State {
39
+ /** Created manually by the user. */
40
+ MANUAL = "MANUAL",
41
+ /** Created automatically. */
42
+ AUTO = "AUTO",
43
+ /** Created when publishing recurring events. */
44
+ RECURRING_EVENT = "RECURRING_EVENT",
45
+ /** Category is hidden. */
46
+ HIDDEN = "HIDDEN"
47
+ }
48
+ export interface CreateCategoryRequest {
49
+ /** Category to create. */
50
+ category: Category;
51
+ }
52
+ export interface CreateCategoryResponse {
53
+ /** Created category. */
54
+ category?: Category;
55
+ }
56
+ export interface BulkCreateCategoryRequest {
57
+ /** Categories to create. */
58
+ categories: Category[];
59
+ }
60
+ export interface BulkCreateCategoryResponse {
61
+ /** Bulk create results. */
62
+ results?: BulkCategoryResult[];
63
+ /** Metadata of results. */
64
+ bulkActionMetadata?: BulkActionMetadata;
65
+ }
66
+ export interface BulkCategoryResult {
67
+ /** Metadata. */
68
+ itemMetadata?: ItemMetadata;
69
+ /** Created categories. */
70
+ item?: Category;
71
+ }
72
+ export interface ItemMetadata {
73
+ /** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
74
+ _id?: string | null;
75
+ /** Index of the item within the request array. Allows for correlation between request and response items. */
76
+ originalIndex?: number;
77
+ /** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
78
+ success?: boolean;
79
+ /** Details about the error in case of failure. */
80
+ error?: ApplicationError;
81
+ }
82
+ export interface ApplicationError {
83
+ /** Error code. */
84
+ code?: string;
85
+ /** Description of the error. */
86
+ description?: string;
87
+ /** Data related to the error. */
88
+ data?: Record<string, any> | null;
89
+ }
90
+ export interface BulkActionMetadata {
91
+ /** Number of items that were successfully processed. */
92
+ totalSuccesses?: number;
93
+ /** Number of items that couldn't be processed. */
94
+ totalFailures?: number;
95
+ /** Number of failures without details due to exceeding the threshold for detailed failures. */
96
+ undetailedFailures?: number;
97
+ }
98
+ export interface UpdateCategoryRequest {
99
+ /** Category to update. */
100
+ category: Category;
101
+ }
102
+ export interface UpdateCategoryResponse {
103
+ /** Updated category. */
104
+ category?: Category;
105
+ }
106
+ export interface DeleteCategoryRequest {
107
+ /** ID of category to be deleted. */
108
+ categoryId: string;
109
+ }
110
+ export interface DeleteCategoryResponse {
111
+ }
112
+ export interface QueryCategoriesRequest {
113
+ /** Options to use when querying categories. See [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language) for more details. */
114
+ query: QueryV2;
115
+ /**
116
+ * Predefined sets of fields to return.
117
+ * - `COUNTS`: Returns `assignedEventsCount`.
118
+ */
119
+ fieldset?: CategoryFieldset[];
120
+ }
121
+ export interface QueryV2 extends QueryV2PagingMethodOneOf {
122
+ /**
123
+ * Pointer to page of results using offset.
124
+ * See [Pagination](https://dev.wix.com/api/rest/getting-started/pagination).
125
+ */
126
+ paging?: Paging;
127
+ /** Filter. See [supported fields and operators](https://dev.wix.com/api/rest/wix-events/wix-events/filter-and-sort#wix-events_wix-events_filter-and-sort_list-query-events). */
128
+ filter?: Record<string, any> | null;
129
+ /**
130
+ * Sort object in the form [{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]
131
+ * See [supported fields](https://dev.wix.com/api/rest/wix-events/wix-events/filter-and-sort#wix-events_wix-events_filter-and-sort_list-query-events).
132
+ */
133
+ sort?: Sorting[];
134
+ }
135
+ /** @oneof */
136
+ export interface QueryV2PagingMethodOneOf {
137
+ /**
138
+ * Pointer to page of results using offset.
139
+ * See [Pagination](https://dev.wix.com/api/rest/getting-started/pagination).
140
+ */
141
+ paging?: Paging;
142
+ }
143
+ export interface Sorting {
144
+ /** Name of the field to sort by */
145
+ fieldName?: string;
146
+ /** Sort order (ASC/DESC). Defaults to ASC */
147
+ order?: SortOrder;
148
+ }
149
+ export declare enum SortOrder {
150
+ ASC = "ASC",
151
+ DESC = "DESC"
152
+ }
153
+ export interface Paging {
154
+ /** Number of items to load per page. */
155
+ limit?: number | null;
156
+ /** Number of items to skip in the current sort order. */
157
+ offset?: number | null;
158
+ }
159
+ export declare enum CategoryFieldset {
160
+ /** Include `assignedEventsCount` in the response. */
161
+ COUNTS = "COUNTS"
162
+ }
163
+ export interface QueryCategoriesResponse {
164
+ /** List of categories. */
165
+ categories?: Category[];
166
+ /** Metadata for the paginated results. */
167
+ metaData?: PagingMetadataV2;
168
+ }
169
+ export interface PagingMetadataV2 {
170
+ /** Number of items returned in the response. */
171
+ count?: number | null;
172
+ /** Offset that was requested. */
173
+ offset?: number | null;
174
+ /** Total number of items that match the query. Returned if offset paging is used and the `tooManyToCount` flag is not set. */
175
+ total?: number | null;
176
+ /** Flag that indicates the server failed to calculate the `total` field. */
177
+ tooManyToCount?: boolean | null;
178
+ /** Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used. */
179
+ cursors?: Cursors;
180
+ }
181
+ export interface Cursors {
182
+ /** Cursor string pointing to the next page in the list of results. */
183
+ next?: string | null;
184
+ /** Cursor pointing to the previous page in the list of results. */
185
+ prev?: string | null;
186
+ }
187
+ export interface AssignEventsRequest {
188
+ /** ID of category to which events should be assigned. */
189
+ categoryId: string;
190
+ /** A list of events IDs. */
191
+ eventId: string[];
192
+ }
193
+ export interface AssignEventsResponse {
194
+ }
195
+ export interface BulkAssignEventsRequest {
196
+ /** A list of category IDs to which events should be assigned. */
197
+ categoryId: string[];
198
+ /** A list of events IDs. */
199
+ eventId: string[];
200
+ }
201
+ export interface BulkAssignEventsResponse {
202
+ /** Bulk assign results. */
203
+ results?: BulkCategoryResult[];
204
+ /** Metadata of results. */
205
+ bulkActionMetadata?: BulkActionMetadata;
206
+ }
207
+ export interface BulkAssignEventsAsyncRequest {
208
+ /** Category IDs. */
209
+ categoryId: string[];
210
+ /**
211
+ * Criteria that must be met for an event to be considered for the bulk assign. Supported filters for this API:
212
+ * - `_id`: [`eq()`](https://www.wix.com/velo/reference/wix-events-v2/categories/categoriesquerybuilder/eq)
213
+ * - `name`: [`eq()`](https://www.wix.com/velo/reference/wix-events-v2/categories/categoriesquerybuilder/eq)
214
+ */
215
+ filter: Record<string, any> | null;
216
+ }
217
+ export interface BulkAssignEventsAsyncResponse {
218
+ }
219
+ export interface UnassignEventsRequest {
220
+ /** Category ID. */
221
+ categoryId: string;
222
+ /** A list of events IDs. */
223
+ eventId: string[];
224
+ }
225
+ export interface UnassignEventsResponse {
226
+ }
227
+ export interface BulkUnassignEventsRequest {
228
+ /** A list of category IDs. */
229
+ categoryId: string[];
230
+ /** A list of events IDs. */
231
+ eventId?: string[];
232
+ }
233
+ export interface BulkUnassignEventsResponse {
234
+ /** Results. */
235
+ results?: BulkCategoryResult[];
236
+ /** Metadata of results. */
237
+ bulkActionMetadata?: BulkActionMetadata;
238
+ }
239
+ export interface BulkUnassignEventsAsyncRequest {
240
+ /** Category ID. */
241
+ categoryId: string[];
242
+ /**
243
+ * Criteria that must be met for an event to be considered for the bulk assign. Supported filters for this API:
244
+ * - `_id`: [`eq()`](https://www.wix.com/velo/reference/wix-events-v2/categories/categoriesquerybuilder/eq)
245
+ * - `name`: [`eq()`](https://www.wix.com/velo/reference/wix-events-v2/categories/categoriesquerybuilder/eq)
246
+ */
247
+ filter: Record<string, any> | null;
248
+ }
249
+ export interface BulkUnassignEventsAsyncResponse {
250
+ }
251
+ export interface ListEventCategoriesRequest {
252
+ /** Event ID. */
253
+ eventId: string;
254
+ }
255
+ export interface ListEventCategoriesResponse {
256
+ /** A list of categories. */
257
+ categories?: Category[];
258
+ }
259
+ export interface ReorderCategoryEventsRequest extends ReorderCategoryEventsRequestReferenceEventOneOf {
260
+ /** Move the event before defined `eventId`. */
261
+ beforeEventId?: string;
262
+ /** Move the event after defined `eventId`. */
263
+ afterEventId?: string;
264
+ /** Category ID. */
265
+ categoryId: string;
266
+ /** Event ID. */
267
+ eventId?: string;
268
+ }
269
+ /** @oneof */
270
+ export interface ReorderCategoryEventsRequestReferenceEventOneOf {
271
+ /** Move the event before defined `eventId`. */
272
+ beforeEventId?: string;
273
+ /** Move the event after defined `eventId`. */
274
+ afterEventId?: string;
275
+ }
276
+ export interface ReorderCategoryEventsResponse {
277
+ }
278
+ export interface DomainEvent extends DomainEventBodyOneOf {
279
+ createdEvent?: EntityCreatedEvent;
280
+ updatedEvent?: EntityUpdatedEvent;
281
+ deletedEvent?: EntityDeletedEvent;
282
+ actionEvent?: ActionEvent;
283
+ /**
284
+ * Unique event ID.
285
+ * Allows clients to ignore duplicate webhooks.
286
+ */
287
+ _id?: string;
288
+ /**
289
+ * Assumes actions are also always typed to an entity_type
290
+ * Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction
291
+ */
292
+ entityFqdn?: string;
293
+ /**
294
+ * This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug)
295
+ * This is although the created/updated/deleted notion is duplication of the oneof types
296
+ * Example: created/updated/deleted/started/completed/email_opened
297
+ */
298
+ slug?: string;
299
+ /** ID of the entity associated with the event. */
300
+ entityId?: string;
301
+ /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z */
302
+ eventTime?: Date | null;
303
+ /**
304
+ * Whether the event was triggered as a result of a privacy regulation application
305
+ * (for example, GDPR).
306
+ */
307
+ triggeredByAnonymizeRequest?: boolean | null;
308
+ /** If present, indicates the action that triggered the event. */
309
+ originatedFrom?: string | null;
310
+ /**
311
+ * A sequence number defining the order of updates to the underlying entity.
312
+ * For example, given that some entity was updated at 16:00 and than again at 16:01,
313
+ * it is guaranteed that the sequence number of the second update is strictly higher than the first.
314
+ * As the consumer, you can use this value to ensure that you handle messages in the correct order.
315
+ * To do so, you will need to persist this number on your end, and compare the sequence number from the
316
+ * message against the one you have stored. Given that the stored number is higher, you should ignore the message.
317
+ */
318
+ entityEventSequence?: string | null;
319
+ }
320
+ /** @oneof */
321
+ export interface DomainEventBodyOneOf {
322
+ createdEvent?: EntityCreatedEvent;
323
+ updatedEvent?: EntityUpdatedEvent;
324
+ deletedEvent?: EntityDeletedEvent;
325
+ actionEvent?: ActionEvent;
326
+ }
327
+ export interface EntityCreatedEvent {
328
+ entity?: string;
329
+ }
330
+ export interface RestoreInfo {
331
+ deletedDate?: Date | null;
332
+ }
333
+ export interface EntityUpdatedEvent {
334
+ /**
335
+ * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
336
+ * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
337
+ * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
338
+ */
339
+ currentEntity?: string;
340
+ }
341
+ export interface EntityDeletedEvent {
342
+ /** Entity that was deleted */
343
+ deletedEntity?: string | null;
344
+ }
345
+ export interface ActionEvent {
346
+ body?: string;
347
+ }
348
+ export interface MessageEnvelope {
349
+ /** App instance ID. */
350
+ instanceId?: string | null;
351
+ /** Event type. */
352
+ eventType?: string;
353
+ /** The identification type and identity data. */
354
+ identity?: IdentificationData;
355
+ /** Stringify payload. */
356
+ data?: string;
357
+ }
358
+ export interface IdentificationData extends IdentificationDataIdOneOf {
359
+ /** ID of a site visitor that has not logged in to the site. */
360
+ anonymousVisitorId?: string;
361
+ /** ID of a site visitor that has logged in to the site. */
362
+ memberId?: string;
363
+ /** ID of a Wix user (site owner, contributor, etc.). */
364
+ wixUserId?: string;
365
+ /** ID of an app. */
366
+ appId?: string;
367
+ /** @readonly */
368
+ identityType?: WebhookIdentityType;
369
+ }
370
+ /** @oneof */
371
+ export interface IdentificationDataIdOneOf {
372
+ /** ID of a site visitor that has not logged in to the site. */
373
+ anonymousVisitorId?: string;
374
+ /** ID of a site visitor that has logged in to the site. */
375
+ memberId?: string;
376
+ /** ID of a Wix user (site owner, contributor, etc.). */
377
+ wixUserId?: string;
378
+ /** ID of an app. */
379
+ appId?: string;
380
+ }
381
+ export declare enum WebhookIdentityType {
382
+ UNKNOWN = "UNKNOWN",
383
+ ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
384
+ MEMBER = "MEMBER",
385
+ WIX_USER = "WIX_USER",
386
+ APP = "APP"
387
+ }
388
+ export interface CategoryNonNullableFields {
389
+ _id: string;
390
+ name: string;
391
+ states: State[];
392
+ }
393
+ export interface CreateCategoryResponseNonNullableFields {
394
+ category?: CategoryNonNullableFields;
395
+ }
396
+ interface ApplicationErrorNonNullableFields {
397
+ code: string;
398
+ description: string;
399
+ }
400
+ interface ItemMetadataNonNullableFields {
401
+ originalIndex: number;
402
+ success: boolean;
403
+ error?: ApplicationErrorNonNullableFields;
404
+ }
405
+ interface BulkCategoryResultNonNullableFields {
406
+ itemMetadata?: ItemMetadataNonNullableFields;
407
+ item?: CategoryNonNullableFields;
408
+ }
409
+ interface BulkActionMetadataNonNullableFields {
410
+ totalSuccesses: number;
411
+ totalFailures: number;
412
+ undetailedFailures: number;
413
+ }
414
+ export interface BulkCreateCategoryResponseNonNullableFields {
415
+ results: BulkCategoryResultNonNullableFields[];
416
+ bulkActionMetadata?: BulkActionMetadataNonNullableFields;
417
+ }
418
+ export interface UpdateCategoryResponseNonNullableFields {
419
+ category?: CategoryNonNullableFields;
420
+ }
421
+ export interface QueryCategoriesResponseNonNullableFields {
422
+ categories: CategoryNonNullableFields[];
423
+ }
424
+ export interface BulkAssignEventsResponseNonNullableFields {
425
+ results: BulkCategoryResultNonNullableFields[];
426
+ bulkActionMetadata?: BulkActionMetadataNonNullableFields;
427
+ }
428
+ export interface BulkUnassignEventsResponseNonNullableFields {
429
+ results: BulkCategoryResultNonNullableFields[];
430
+ bulkActionMetadata?: BulkActionMetadataNonNullableFields;
431
+ }
432
+ export interface ListEventCategoriesResponseNonNullableFields {
433
+ categories: CategoryNonNullableFields[];
434
+ }
435
+ /**
436
+ * Creates a category.
437
+ * @public
438
+ * @requiredField category
439
+ * @param category - Category to create.
440
+ * @permissionId WIX_EVENTS.MANAGE_CATEGORIES
441
+ * @permissionScope Manage Events - all permissions
442
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS
443
+ * @applicableIdentity APP
444
+ * @returns Created category.
445
+ * @fqn wix.events.categories.CategoryManagement.CreateCategory
446
+ */
447
+ export declare function createCategory(category: Category): Promise<Category & CategoryNonNullableFields>;
448
+ /**
449
+ * Creates multipe categories at once.
450
+ * @param categories - Categories to create.
451
+ * @public
452
+ * @requiredField categories
453
+ * @permissionId WIX_EVENTS.MANAGE_CATEGORIES
454
+ * @permissionScope Manage Events - all permissions
455
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS
456
+ * @applicableIdentity APP
457
+ * @fqn wix.events.categories.CategoryManagement.BulkCreateCategory
458
+ */
459
+ export declare function bulkCreateCategory(categories: Category[]): Promise<BulkCreateCategoryResponse & BulkCreateCategoryResponseNonNullableFields>;
460
+ /**
461
+ * Updates an existing category.
462
+ * @param _id - Category ID.
463
+ * @public
464
+ * @requiredField _id
465
+ * @requiredField category
466
+ * @permissionId WIX_EVENTS.MANAGE_CATEGORIES
467
+ * @permissionScope Manage Events - all permissions
468
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS
469
+ * @applicableIdentity APP
470
+ * @returns Updated category.
471
+ * @fqn wix.events.categories.CategoryManagement.UpdateCategory
472
+ */
473
+ export declare function updateCategory(_id: string, category: UpdateCategory): Promise<Category & CategoryNonNullableFields>;
474
+ export interface UpdateCategory {
475
+ /**
476
+ * Category ID.
477
+ * @readonly
478
+ */
479
+ _id?: string;
480
+ /** Category name. */
481
+ name?: string;
482
+ /**
483
+ * Date and time when category was created.
484
+ * @readonly
485
+ */
486
+ _createdDate?: Date | null;
487
+ /**
488
+ * The total number of draft and published events assigned to the category.
489
+ * @readonly
490
+ */
491
+ counts?: CategoryCounts;
492
+ /**
493
+ * Category state. Possible values:
494
+ * - `MANUAL`: Category is created manually by the user.
495
+ * - `AUTO`: Category is created automatically.
496
+ * - `RECURRING_EVENT`: Category is created automatically when publishing recurring events.
497
+ * - `HIDDEN`: Category can't be seen.
498
+ *
499
+ * Default: `MANUAL`.
500
+ *
501
+ * **Note:** The WIX_EVENTS.MANAGE_AUTO_CATEGORIES permission is required to use states other than `MANUAL`.
502
+ */
503
+ states?: State[];
504
+ }
505
+ /**
506
+ * Deletes a category.
507
+ * @param categoryId - ID of category to be deleted.
508
+ * @public
509
+ * @requiredField categoryId
510
+ * @permissionId WIX_EVENTS.MANAGE_CATEGORIES
511
+ * @permissionScope Manage Events - all permissions
512
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS
513
+ * @applicableIdentity APP
514
+ * @fqn wix.events.categories.CategoryManagement.DeleteCategory
515
+ */
516
+ export declare function deleteCategory(categoryId: string): Promise<void>;
517
+ /**
518
+ * Creates a query to retrieve a list of categories.
519
+ *
520
+ *
521
+ * The `queryCategories()` function builds a query to retrieve a list of categories and returns a `CategoriesQueryBuilder` object.
522
+ *
523
+ * The returned object contains the query definition, which is typically used to run the query using the [`find()`](https://www.wix.com/velo/reference/wix-events-v2/categories/categoriesquerybuilder/find) function.
524
+ *
525
+ * You can refine the query by chaining `CategoriesQueryBuilder` functions onto the query. `CategoriesQueryBuilder` functions enable you to sort, filter, and control the results `queryCategories()` returns.
526
+ *
527
+ * `queryCategories()` runs with these `CategoriesQueryBuilder` defaults, which you can override:
528
+ *
529
+ * - [`limit(50)`](https://www.wix.com/velo/reference/wix-events-v2/categories/categoriesquerybuilder/limit)
530
+ * @public
531
+ * @param options - Options to use when querying categories.
532
+ * @permissionScope Read Events - all read permissions
533
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.READ-EVENTS
534
+ * @permissionScope Manage Events - all permissions
535
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS
536
+ * @permissionScope Read Events
537
+ * @permissionScopeId SCOPE.DC-EVENTS.READ-EVENTS
538
+ * @permissionScope Manage Guest List
539
+ * @permissionScopeId SCOPE.DC-EVENTS.MANAGE-GUEST-LIST
540
+ * @permissionScope Manage Events
541
+ * @permissionScopeId SCOPE.DC-EVENTS.MANAGE-EVENTS
542
+ * @permissionId WIX_EVENTS.READ_CATEGORIES
543
+ * @applicableIdentity APP
544
+ * @applicableIdentity VISITOR
545
+ * @fqn wix.events.categories.CategoryManagement.QueryCategories
546
+ */
547
+ export declare function queryCategories(options?: QueryCategoriesOptions): CategoriesQueryBuilder;
548
+ export interface QueryCategoriesOptions {
549
+ /**
550
+ * Predefined sets of fields to return.
551
+ * - `COUNTS`: Returns `assignedEventsCount`.
552
+ */
553
+ fieldset?: CategoryFieldset[] | undefined;
554
+ }
555
+ interface QueryOffsetResult {
556
+ currentPage: number | undefined;
557
+ totalPages: number | undefined;
558
+ totalCount: number | undefined;
559
+ hasNext: () => boolean;
560
+ hasPrev: () => boolean;
561
+ length: number;
562
+ pageSize: number;
563
+ }
564
+ export interface CategoriesQueryResult extends QueryOffsetResult {
565
+ items: Category[];
566
+ query: CategoriesQueryBuilder;
567
+ next: () => Promise<CategoriesQueryResult>;
568
+ prev: () => Promise<CategoriesQueryResult>;
569
+ }
570
+ export interface CategoriesQueryBuilder {
571
+ /** @param propertyName - Property whose value is compared with `value`.
572
+ * @param value - Value to compare against.
573
+ */
574
+ eq: (propertyName: '_id' | 'name', value: any) => CategoriesQueryBuilder;
575
+ /** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments. */
576
+ ascending: (...propertyNames: Array<'_createdDate'>) => CategoriesQueryBuilder;
577
+ /** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments. */
578
+ descending: (...propertyNames: Array<'_createdDate'>) => CategoriesQueryBuilder;
579
+ /** @param limit - Number of items to return, which is also the `pageSize` of the results object. */
580
+ limit: (limit: number) => CategoriesQueryBuilder;
581
+ /** @param skip - Number of items to skip in the query results before returning the results. */
582
+ skip: (skip: number) => CategoriesQueryBuilder;
583
+ find: () => Promise<CategoriesQueryResult>;
584
+ }
585
+ /**
586
+ * Assigns events to a single category.
587
+ * @param categoryId - ID of category to which events should be assigned.
588
+ * @param eventId - A list of events IDs.
589
+ * @public
590
+ * @requiredField categoryId
591
+ * @requiredField eventId
592
+ * @permissionId WIX_EVENTS.MANAGE_CATEGORIES
593
+ * @permissionScope Manage Events - all permissions
594
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS
595
+ * @applicableIdentity APP
596
+ * @fqn wix.events.categories.CategoryManagement.AssignEvents
597
+ */
598
+ export declare function assignEvents(categoryId: string, eventId: string[]): Promise<void>;
599
+ /**
600
+ * Assigns events to multiple categories at once.
601
+ * @param categoryId - A list of category IDs to which events should be assigned.
602
+ * @public
603
+ * @requiredField categoryId
604
+ * @requiredField options
605
+ * @requiredField options.eventId
606
+ * @param options - Options to use when assigning events to multiple categories.
607
+ * @permissionId WIX_EVENTS.MANAGE_CATEGORIES
608
+ * @permissionScope Manage Events - all permissions
609
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS
610
+ * @applicableIdentity APP
611
+ * @fqn wix.events.categories.CategoryManagement.BulkAssignEvents
612
+ */
613
+ export declare function bulkAssignEvents(categoryId: string[], options: BulkAssignEventsOptions): Promise<BulkAssignEventsResponse & BulkAssignEventsResponseNonNullableFields>;
614
+ export interface BulkAssignEventsOptions {
615
+ /** A list of events IDs. */
616
+ eventId: string[];
617
+ }
618
+ /**
619
+ * Assigns events that match given filter criteria to multiple categories.
620
+ *
621
+ * Unlike the [`bulkAssignEvents()`](https://www.wix.com/velo/reference/wix-events-v2/categories/bulkassignevents) function, this function can handle numerous requests and is less prone to failures.
622
+ *
623
+ * However, the events will not be instantly assigned to the categories (as with `bulkAssignEvents()`), but rather after some time. In this case, if try to [`listEventCategories`](https://www.wix.com/velo/reference/wix-events-v2/categories/listeventcategories) or [`queryCategories`](https://www.wix.com/velo/reference/wix-events-v2/categories/querycategories), you might not get the correct response.
624
+ * @param categoryId - Category IDs.
625
+ * @public
626
+ * @requiredField categoryId
627
+ * @requiredField options
628
+ * @requiredField options.filter
629
+ * @param options - Options to use when assigning events to multiple categories.
630
+ * @permissionId WIX_EVENTS.MANAGE_CATEGORIES
631
+ * @permissionScope Manage Events - all permissions
632
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS
633
+ * @applicableIdentity APP
634
+ * @fqn wix.events.categories.CategoryManagement.BulkAssignEventsAsync
635
+ */
636
+ export declare function bulkAssignEventsAsync(categoryId: string[], options: BulkAssignEventsAsyncOptions): Promise<void>;
637
+ export interface BulkAssignEventsAsyncOptions {
638
+ /**
639
+ * Criteria that must be met for an event to be considered for the bulk assign. Supported filters for this API:
640
+ * - `_id`: [`eq()`](https://www.wix.com/velo/reference/wix-events-v2/categories/categoriesquerybuilder/eq)
641
+ * - `name`: [`eq()`](https://www.wix.com/velo/reference/wix-events-v2/categories/categoriesquerybuilder/eq)
642
+ */
643
+ filter: Record<string, any> | null;
644
+ }
645
+ /**
646
+ * Unassigns events from a category.
647
+ * @param categoryId - Category ID.
648
+ * @param eventId - A list of events IDs.
649
+ * @public
650
+ * @requiredField categoryId
651
+ * @requiredField eventId
652
+ * @permissionId WIX_EVENTS.MANAGE_CATEGORIES
653
+ * @permissionScope Manage Events - all permissions
654
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS
655
+ * @applicableIdentity APP
656
+ * @fqn wix.events.categories.CategoryManagement.UnassignEvents
657
+ */
658
+ export declare function unassignEvents(categoryId: string, eventId: string[]): Promise<void>;
659
+ /**
660
+ * Unassigns events from multiple categories at once.
661
+ * @param categoryId - A list of category IDs.
662
+ * @public
663
+ * @requiredField categoryId
664
+ * @param options - Options to use when removing events from multiple categories.
665
+ * @permissionId WIX_EVENTS.MANAGE_CATEGORIES
666
+ * @permissionScope Manage Events - all permissions
667
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS
668
+ * @applicableIdentity APP
669
+ * @fqn wix.events.categories.CategoryManagement.BulkUnassignEvents
670
+ */
671
+ export declare function bulkUnassignEvents(categoryId: string[], options?: BulkUnassignEventsOptions): Promise<BulkUnassignEventsResponse & BulkUnassignEventsResponseNonNullableFields>;
672
+ export interface BulkUnassignEventsOptions {
673
+ /** A list of events IDs. */
674
+ eventId?: string[];
675
+ }
676
+ /**
677
+ * Removes events that match given filter criteria from multiple categories.
678
+ *
679
+ * Unlike the [`bulkUnassignEvents()`](https://www.wix.com/velo/reference/wix-events-v2/categories/bulkunassignevents) function, this function can handle numerous requests and is less prone to failures.
680
+ *
681
+ * However, the events will not be instantly removed from the categories (as with `bulkUnassignEvents()`), but rather after some time. In this case, if try to [`listEventCategories`](https://www.wix.com/velo/reference/wix-events-v2/categories/listeventcategories) or [`queryCategories`](https://www.wix.com/velo/reference/wix-events-v2/categories/querycategories), you might not get the correct response.
682
+ * @param categoryId - Category ID.
683
+ * @public
684
+ * @requiredField categoryId
685
+ * @requiredField options
686
+ * @requiredField options.filter
687
+ * @param options - Options to use when removing events from multiple categories.
688
+ * @permissionId WIX_EVENTS.MANAGE_CATEGORIES
689
+ * @permissionScope Manage Events - all permissions
690
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS
691
+ * @applicableIdentity APP
692
+ * @fqn wix.events.categories.CategoryManagement.BulkUnassignEventsAsync
693
+ */
694
+ export declare function bulkUnassignEventsAsync(categoryId: string[], options: BulkUnassignEventsAsyncOptions): Promise<void>;
695
+ export interface BulkUnassignEventsAsyncOptions {
696
+ /**
697
+ * Criteria that must be met for an event to be considered for the bulk assign. Supported filters for this API:
698
+ * - `_id`: [`eq()`](https://www.wix.com/velo/reference/wix-events-v2/categories/categoriesquerybuilder/eq)
699
+ * - `name`: [`eq()`](https://www.wix.com/velo/reference/wix-events-v2/categories/categoriesquerybuilder/eq)
700
+ */
701
+ filter: Record<string, any> | null;
702
+ }
703
+ /**
704
+ * Retrieves a list of categories that are not in the `HIDDEN` state.
705
+ * @param eventId - Event ID.
706
+ * @public
707
+ * @requiredField eventId
708
+ * @permissionId WIX_EVENTS.READ_CATEGORIES
709
+ * @permissionScope Read Events - all read permissions
710
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.READ-EVENTS
711
+ * @permissionScope Manage Events - all permissions
712
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS
713
+ * @permissionScope Read Events
714
+ * @permissionScopeId SCOPE.DC-EVENTS.READ-EVENTS
715
+ * @permissionScope Manage Guest List
716
+ * @permissionScopeId SCOPE.DC-EVENTS.MANAGE-GUEST-LIST
717
+ * @permissionScope Manage Events
718
+ * @permissionScopeId SCOPE.DC-EVENTS.MANAGE-EVENTS
719
+ * @applicableIdentity APP
720
+ * @applicableIdentity VISITOR
721
+ * @fqn wix.events.categories.CategoryManagement.ListEventCategories
722
+ */
723
+ export declare function listEventCategories(eventId: string): Promise<ListEventCategoriesResponse & ListEventCategoriesResponseNonNullableFields>;
724
+ /**
725
+ * Change the order of events that are assigned to the same category on the Events Widget.
726
+ *
727
+ *
728
+ * For more information see [this article](https://support.wix.com/en/article/creating-and-displaying-event-categories)
729
+ * @param categoryId - Category ID.
730
+ * @public
731
+ * @requiredField categoryId
732
+ * @param options - Options to use when reordering events.
733
+ * @permissionId WIX_EVENTS.MANAGE_CATEGORIES
734
+ * @permissionScope Manage Events - all permissions
735
+ * @permissionScopeId SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS
736
+ * @applicableIdentity APP
737
+ * @fqn wix.events.categories.CategoryManagement.ReorderCategoryEvents
738
+ */
739
+ export declare function reorderCategoryEvents(categoryId: string, options?: ReorderCategoryEventsOptions): Promise<void>;
740
+ export interface ReorderCategoryEventsOptions extends ReorderCategoryEventsRequestReferenceEventOneOf {
741
+ /** Event ID. */
742
+ eventId?: string;
743
+ /** Move the event before defined `eventId`. */
744
+ beforeEventId?: string;
745
+ /** Move the event after defined `eventId`. */
746
+ afterEventId?: string;
747
+ }
748
+ export {};