@wix/auto_sdk_online-programs_participants 1.0.11 → 1.0.13

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 (41) hide show
  1. package/build/cjs/index.d.ts +6 -134
  2. package/build/cjs/index.js +161 -1489
  3. package/build/cjs/index.js.map +1 -1
  4. package/build/cjs/index.typings.d.ts +691 -12
  5. package/build/cjs/index.typings.js +174 -1372
  6. package/build/cjs/index.typings.js.map +1 -1
  7. package/build/cjs/meta.d.ts +184 -1274
  8. package/build/cjs/meta.js +19 -1060
  9. package/build/cjs/meta.js.map +1 -1
  10. package/build/es/index.d.mts +6 -134
  11. package/build/es/index.mjs +144 -1446
  12. package/build/es/index.mjs.map +1 -1
  13. package/build/es/index.typings.d.mts +691 -12
  14. package/build/es/index.typings.mjs +166 -1337
  15. package/build/es/index.typings.mjs.map +1 -1
  16. package/build/es/meta.d.mts +184 -1274
  17. package/build/es/meta.mjs +10 -1025
  18. package/build/es/meta.mjs.map +1 -1
  19. package/build/internal/cjs/index.d.ts +6 -145
  20. package/build/internal/cjs/index.js +161 -1489
  21. package/build/internal/cjs/index.js.map +1 -1
  22. package/build/internal/cjs/index.typings.d.ts +691 -12
  23. package/build/internal/cjs/index.typings.js +174 -1372
  24. package/build/internal/cjs/index.typings.js.map +1 -1
  25. package/build/internal/cjs/meta.d.ts +184 -1274
  26. package/build/internal/cjs/meta.js +19 -1060
  27. package/build/internal/cjs/meta.js.map +1 -1
  28. package/build/internal/es/index.d.mts +6 -145
  29. package/build/internal/es/index.mjs +144 -1446
  30. package/build/internal/es/index.mjs.map +1 -1
  31. package/build/internal/es/index.typings.d.mts +691 -12
  32. package/build/internal/es/index.typings.mjs +166 -1337
  33. package/build/internal/es/index.typings.mjs.map +1 -1
  34. package/build/internal/es/meta.d.mts +184 -1274
  35. package/build/internal/es/meta.mjs +10 -1025
  36. package/build/internal/es/meta.mjs.map +1 -1
  37. package/package.json +2 -2
  38. package/build/cjs/online-programs-v3-participant-participants.universal-DRubTE1O.d.ts +0 -2228
  39. package/build/es/online-programs-v3-participant-participants.universal-DRubTE1O.d.mts +0 -2228
  40. package/build/internal/cjs/online-programs-v3-participant-participants.universal-DUdmZP01.d.ts +0 -2238
  41. package/build/internal/es/online-programs-v3-participant-participants.universal-DUdmZP01.d.mts +0 -2238
@@ -1,2238 +0,0 @@
1
- import { QuerySpec, SearchSpec, Query, Search, NonNullablePaths } from '@wix/sdk-types';
2
-
3
- interface Participant {
4
- /**
5
- * Participant ID.
6
- * @format GUID
7
- * @readonly
8
- */
9
- _id?: string | null;
10
- /**
11
- * Participant revision (for optimistic concurrency control).
12
- * @readonly
13
- */
14
- revision?: string | null;
15
- /**
16
- * Participant creation date
17
- * @readonly
18
- */
19
- _createdDate?: Date | null;
20
- /**
21
- * Participant last update date
22
- * @readonly
23
- */
24
- _updatedDate?: Date | null;
25
- /**
26
- * Member ID of participant on site
27
- * @format GUID
28
- * @readonly
29
- */
30
- memberId?: string;
31
- /**
32
- * Program ID which participant participates in
33
- * @format GUID
34
- * @readonly
35
- */
36
- programId?: string;
37
- /**
38
- * Program completion progress
39
- * @readonly
40
- */
41
- progress?: Progress;
42
- /**
43
- * status of participation in the program
44
- * @readonly
45
- */
46
- status?: StatusWithLiterals;
47
- /**
48
- * Certificate issued to participant
49
- * @readonly
50
- */
51
- certificate?: Certificate;
52
- /** Additional info about when and how participant joined the program and which timeframes participant has to complete program. */
53
- joinedInfo?: JoinedInfo;
54
- /**
55
- * Site member info snapshot for the participant
56
- * @readonly
57
- */
58
- member?: Member;
59
- /**
60
- * Last activity date of the participant in the program (can either be status change or step resolution).
61
- * @readonly
62
- */
63
- lastActivityDate?: Date | null;
64
- /** Extended fields for participant (can be used for storing custom data). */
65
- extendedFields?: ExtendedFields;
66
- /** Tags for categorizing and organizing participants. */
67
- tags?: Tags;
68
- }
69
- declare enum JoinPath {
70
- /** Default value. This value is unused. */
71
- UNKNOWN_JOIN_PATH = "UNKNOWN_JOIN_PATH",
72
- /** Member joined to the program for free. */
73
- FREE = "FREE",
74
- /** Member was added to the program by site owner. */
75
- ADDED = "ADDED",
76
- /** Member paid once to join the program. */
77
- SINGLE_PAYMENT = "SINGLE_PAYMENT",
78
- /** Member has Paid Plan to join. */
79
- PAID_PLAN = "PAID_PLAN",
80
- /** Member joined with the Free Coupon. */
81
- FREE_COUPON = "FREE_COUPON"
82
- }
83
- /** @enumType */
84
- type JoinPathWithLiterals = JoinPath | 'UNKNOWN_JOIN_PATH' | 'FREE' | 'ADDED' | 'SINGLE_PAYMENT' | 'PAID_PLAN' | 'FREE_COUPON';
85
- interface SinglePaymentDetails {
86
- /**
87
- * ID of the cashier order which was used to pay for joining the program.
88
- * @format GUID
89
- * @immutable
90
- */
91
- paymentOrderId?: string;
92
- /**
93
- * ID of the offline transaction if offline payment flow from cashier was used.
94
- * @format GUID
95
- * @immutable
96
- */
97
- offlineTransactionId?: string | null;
98
- }
99
- interface PaidPlanDetails {
100
- /**
101
- * ID of the Paid Plan for which member has paid to join the program.
102
- * @format GUID
103
- * @immutable
104
- */
105
- paidPlanId?: string;
106
- }
107
- interface FreeCouponDetails {
108
- /**
109
- * ID of the coupon which was applied and gave 100% discount to join the program for free.
110
- * @format GUID
111
- * @immutable
112
- */
113
- freeCouponId?: string;
114
- }
115
- interface Progress {
116
- /** Number of program steps completed by member. */
117
- totalStepsCompleted?: number;
118
- /** Total number of program steps available to resolve. */
119
- totalStepsAvailable?: number;
120
- /**
121
- * Completion percentage.
122
- * @max 100
123
- */
124
- completionPercentage?: number;
125
- }
126
- declare enum Status {
127
- /** Default value. This value is unused. */
128
- UNKNOWN_STATUS = "UNKNOWN_STATUS",
129
- /** Member joined the program and became participant. */
130
- JOINED = "JOINED",
131
- /** Participant completed the program, and could join again. */
132
- COMPLETED = "COMPLETED",
133
- /** Participant failed to complete the program, and could join again. */
134
- FAILED = "FAILED",
135
- /** Participant with ended pricing plan (PP), will be joined as renew PP. */
136
- SUSPENDED = "SUSPENDED",
137
- /** Participant removed automatically after some program condition. */
138
- AUTO_REMOVED = "AUTO_REMOVED",
139
- /** Participant removed by site owner. */
140
- REMOVED = "REMOVED",
141
- /** Participant left the program by himself. */
142
- LEFT = "LEFT"
143
- }
144
- /** @enumType */
145
- type StatusWithLiterals = Status | 'UNKNOWN_STATUS' | 'JOINED' | 'COMPLETED' | 'FAILED' | 'SUSPENDED' | 'AUTO_REMOVED' | 'REMOVED' | 'LEFT';
146
- interface Certificate {
147
- /**
148
- * when certificate was issued, UTC.
149
- * @readonly
150
- */
151
- issuedDate?: Date | null;
152
- }
153
- interface JoinedInfo extends JoinedInfoJoinPathDetailsOneOf {
154
- /** Details about Single Payment join path. */
155
- singlePaymentDetails?: SinglePaymentDetails;
156
- /** Details about Paid Plan join path. */
157
- paidPlanDetails?: PaidPlanDetails;
158
- /** Details about Free Coupon join path. */
159
- freeCouponDetails?: FreeCouponDetails;
160
- /**
161
- * Time zone for site on which member joined the program.
162
- * @maxLength 50
163
- * @readonly
164
- */
165
- timeZone?: string;
166
- /**
167
- * Date when participant starts the program (is the same as join date if program does not have start date, otherwise can be later).
168
- * @format LOCAL_DATE
169
- * @readonly
170
- */
171
- startDate?: string;
172
- /**
173
- * How participant joined the program.
174
- * @immutable
175
- */
176
- joinPath?: JoinPathWithLiterals;
177
- /**
178
- * Date before which participant has to finish the program (is not empty only if program itself has finish date).
179
- * @format LOCAL_DATE
180
- * @readonly
181
- */
182
- finishDate?: string | null;
183
- }
184
- /** @oneof */
185
- interface JoinedInfoJoinPathDetailsOneOf {
186
- /** Details about Single Payment join path. */
187
- singlePaymentDetails?: SinglePaymentDetails;
188
- /** Details about Paid Plan join path. */
189
- paidPlanDetails?: PaidPlanDetails;
190
- /** Details about Free Coupon join path. */
191
- freeCouponDetails?: FreeCouponDetails;
192
- }
193
- interface Member {
194
- /**
195
- * First name of the site member.
196
- * @readonly
197
- * @maxLength 1000
198
- */
199
- firstName?: string | null;
200
- /**
201
- * Last name of the site member.
202
- * @readonly
203
- * @maxLength 1000
204
- */
205
- lastName?: string | null;
206
- /**
207
- * Email of the site member.
208
- * @readonly
209
- * @format EMAIL
210
- */
211
- email?: string | null;
212
- /**
213
- * Contact ID of the site member.
214
- * @format GUID
215
- * @readonly
216
- */
217
- contactId?: string;
218
- /**
219
- * Profile image URL of the site member.
220
- * @readonly
221
- * @format WEB_URL
222
- */
223
- profileImageUrl?: string | null;
224
- }
225
- interface ExtendedFields {
226
- /**
227
- * Extended field data. Each key corresponds to the namespace of the app that created the extended fields.
228
- * The value of each key is structured according to the schema defined when the extended fields were configured.
229
- *
230
- * You can only access fields for which you have the appropriate permissions.
231
- *
232
- * Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
233
- */
234
- namespaces?: Record<string, Record<string, any>>;
235
- }
236
- /**
237
- * Common object for tags.
238
- * Should be use as in this example:
239
- * message Foo {
240
- * option (.wix.api.decomposite_of) = "wix.commons.v2.tags.Foo";
241
- * string id = 1;
242
- * ...
243
- * Tags tags = 5
244
- * }
245
- *
246
- * example of taggable entity
247
- * {
248
- * id: "123"
249
- * tags: {
250
- * public_tags: {
251
- * tag_ids:["11","22"]
252
- * },
253
- * private_tags: {
254
- * tag_ids: ["33", "44"]
255
- * }
256
- * }
257
- * }
258
- */
259
- interface Tags {
260
- /** Tags that require an additional permission in order to access them, typically restricted from site members and visitors. */
261
- privateTags?: TagList;
262
- /** Tags that are exposed to anyone with access to the entity, including site members and visitors. */
263
- publicTags?: TagList;
264
- }
265
- interface TagList {
266
- /**
267
- * List of tag IDs.
268
- * @maxSize 100
269
- * @maxLength 5
270
- */
271
- tagIds?: string[];
272
- }
273
- interface ParticipantAdded {
274
- /**
275
- * Program ID which participant was added
276
- * @format GUID
277
- */
278
- programId?: string;
279
- /**
280
- * Member ID of participant on site
281
- * @format GUID
282
- */
283
- memberId?: string;
284
- }
285
- /** Domain event emitted when tags are modified */
286
- interface TagsModified {
287
- /** The Participant with updated tags */
288
- participant?: Participant;
289
- /** Tags that were assigned */
290
- assignedTags?: Tags;
291
- /** Tags that were unassigned */
292
- unassignedTags?: Tags;
293
- }
294
- interface CreateParticipantRequest {
295
- /** Participant to create */
296
- participant: Participant;
297
- }
298
- interface CreateParticipantResponse {
299
- /** Created participant */
300
- participant?: Participant;
301
- }
302
- interface BulkCreateParticipantRequest {
303
- /**
304
- * List of participants you want to create
305
- * @minSize 1
306
- * @maxSize 100
307
- */
308
- participants: Participant[];
309
- /** Whether to return entities in response or not. */
310
- returnEntity?: boolean;
311
- }
312
- interface BulkCreateParticipantResponse {
313
- /**
314
- * Results of bulk action.
315
- * @minSize 1
316
- * @maxSize 100
317
- */
318
- results?: BulkParticipantResult[];
319
- /** Metadata about whole bulk action. */
320
- bulkActionMetadata?: CommonBulkActionMetadata;
321
- }
322
- interface BulkParticipantResult {
323
- /** Metadata of item. */
324
- itemMetadata?: CommonItemMetadata;
325
- /** Item itself (empty if return_entity in request is false). */
326
- item?: Participant;
327
- }
328
- interface CommonItemMetadata {
329
- /** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
330
- _id?: string | null;
331
- /** Index of the item within the request array. Allows for correlation between request and response items. */
332
- originalIndex?: number;
333
- /** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
334
- success?: boolean;
335
- /** Details about the error in case of failure. */
336
- error?: ApplicationError;
337
- }
338
- interface ApplicationError {
339
- /** Error code. */
340
- code?: string;
341
- /** Description of the error. */
342
- description?: string;
343
- /** Data related to the error. */
344
- data?: Record<string, any> | null;
345
- }
346
- interface CommonBulkActionMetadata {
347
- /** Number of items that were successfully processed. */
348
- totalSuccesses?: number;
349
- /** Number of items that couldn't be processed. */
350
- totalFailures?: number;
351
- /** Number of failures without details because detailed failure threshold was exceeded. */
352
- undetailedFailures?: number;
353
- }
354
- interface BulkAddAllToProgramRequest {
355
- /**
356
- * Program to which bulk add participants.
357
- * @format GUID
358
- */
359
- programId: string;
360
- /**
361
- * Exclude site members.
362
- * @format GUID
363
- * @maxSize 100
364
- */
365
- excludeMemberIds?: string[];
366
- }
367
- interface BulkAddAllToProgramResponse {
368
- /**
369
- * Async infra job id which will process the request.
370
- * @format GUID
371
- */
372
- jobId?: string;
373
- }
374
- interface DeleteParticipantRequest {
375
- /**
376
- * Participants to delete
377
- * @format GUID
378
- */
379
- participantId: string;
380
- }
381
- interface DeleteParticipantResponse {
382
- }
383
- interface IssueCertificateRequest {
384
- /**
385
- * Participant to get certificate
386
- * @format GUID
387
- */
388
- participantId: string;
389
- }
390
- interface IssueCertificateResponse {
391
- /** Updated participant */
392
- participant?: Participant;
393
- }
394
- interface GetCompletionStatsRequest {
395
- /**
396
- * program id to get stats for
397
- * @format GUID
398
- */
399
- programId: string;
400
- }
401
- interface GetCompletionStatsResponse {
402
- /** Number of participants that completed the program */
403
- completedAll?: number;
404
- /** Percentage of participants that completed the program */
405
- completionRate?: number;
406
- }
407
- interface GetPremiumStatsRequest {
408
- }
409
- interface GetPremiumStatsResponse {
410
- /** True if site has Online Programs premium feature */
411
- hasPremium?: boolean;
412
- /** Count of active participants on the site */
413
- activeParticipantsCount?: number;
414
- /** Limit of active participants on a site without premium */
415
- activeParticipantsLimit?: number;
416
- }
417
- interface GetParticipantRequest {
418
- /**
419
- * Participant id to fetch
420
- * @format GUID
421
- */
422
- participantId: string;
423
- }
424
- interface GetParticipantResponse {
425
- /** existing participant */
426
- participant?: Participant;
427
- }
428
- interface QueryParticipantsRequest {
429
- /** Platformized query */
430
- query?: CursorQuery;
431
- }
432
- interface CursorQuery extends CursorQueryPagingMethodOneOf {
433
- /**
434
- * Cursor paging options.
435
- *
436
- * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
437
- */
438
- cursorPaging?: CursorPaging;
439
- /**
440
- * Filter object.
441
- *
442
- * Learn more about [filtering](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#filters).
443
- */
444
- filter?: Record<string, any> | null;
445
- /**
446
- * Sort object.
447
- *
448
- * Learn more about [sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#sorting).
449
- * @maxSize 5
450
- */
451
- sort?: Sorting[];
452
- }
453
- /** @oneof */
454
- interface CursorQueryPagingMethodOneOf {
455
- /**
456
- * Cursor paging options.
457
- *
458
- * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
459
- */
460
- cursorPaging?: CursorPaging;
461
- }
462
- interface Sorting {
463
- /**
464
- * Name of the field to sort by.
465
- * @maxLength 512
466
- */
467
- fieldName?: string;
468
- /** Sort order. */
469
- order?: SortOrderWithLiterals;
470
- }
471
- declare enum SortOrder {
472
- ASC = "ASC",
473
- DESC = "DESC"
474
- }
475
- /** @enumType */
476
- type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
477
- interface CursorPaging {
478
- /**
479
- * Maximum number of items to return in the results.
480
- * @max 100
481
- */
482
- limit?: number | null;
483
- /**
484
- * Pointer to the next or previous page in the list of results.
485
- *
486
- * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
487
- * Not relevant for the first request.
488
- * @maxLength 16000
489
- */
490
- cursor?: string | null;
491
- }
492
- interface QueryParticipantsResponse {
493
- /** found participants */
494
- participants?: Participant[];
495
- /** paging metadata */
496
- pagingMetadata?: CursorPagingMetadata;
497
- }
498
- interface CursorPagingMetadata {
499
- /** Number of items returned in current page. */
500
- count?: number | null;
501
- /** Cursor strings that point to the next page, previous page, or both. */
502
- cursors?: Cursors;
503
- /**
504
- * Whether there are more pages to retrieve following the current page.
505
- *
506
- * + `true`: Another page of results can be retrieved.
507
- * + `false`: This is the last page.
508
- */
509
- hasNext?: boolean | null;
510
- }
511
- interface Cursors {
512
- /**
513
- * Cursor string pointing to the next page in the list of results.
514
- * @maxLength 16000
515
- */
516
- next?: string | null;
517
- /**
518
- * Cursor pointing to the previous page in the list of results.
519
- * @maxLength 16000
520
- */
521
- prev?: string | null;
522
- }
523
- interface GetAccessStatusRequest {
524
- }
525
- interface GetAccessStatusResponse {
526
- /** True if participants cannot access online programs due to some limitations */
527
- blocked?: boolean;
528
- }
529
- interface BulkUpdateParticipantTagsRequest {
530
- /**
531
- * Participant IDs to update tags for (1-100 items)
532
- * @minSize 1
533
- * @maxSize 100
534
- * @format GUID
535
- */
536
- participantIds: string[];
537
- /** Tags to assign to the Participants */
538
- assignTags?: Tags;
539
- /** Tags to unassign from the Participants */
540
- unassignTags?: Tags;
541
- }
542
- interface BulkUpdateParticipantTagsResponse {
543
- /**
544
- * Results for each Participant
545
- * @minSize 1
546
- * @maxSize 100
547
- */
548
- results?: BulkUpdateParticipantTagsResult[];
549
- /** Metadata about the bulk operation */
550
- bulkActionMetadata?: CommonBulkActionMetadata;
551
- }
552
- interface BulkUpdateParticipantTagsResult {
553
- /** Metadata for this specific item */
554
- itemMetadata?: CommonItemMetadata;
555
- }
556
- interface BulkUpdateParticipantTagsByFilterRequest {
557
- /** WQL filter to select Participants */
558
- filter: Record<string, any> | null;
559
- /** Tags to assign to matching Participants */
560
- assignTags?: Tags;
561
- /** Tags to unassign from matching Participants */
562
- unassignTags?: Tags;
563
- }
564
- interface BulkUpdateParticipantTagsByFilterResponse {
565
- /**
566
- * Job ID for tracking the async operation
567
- * @format GUID
568
- */
569
- jobId?: string;
570
- }
571
- interface SearchParticipantsRequest {
572
- /** Query to search programs */
573
- search?: CursorSearch;
574
- }
575
- interface CursorSearch extends CursorSearchPagingMethodOneOf {
576
- /**
577
- * Cursor paging options.
578
- *
579
- * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
580
- */
581
- cursorPaging?: CursorPaging;
582
- /**
583
- * Filter object.
584
- *
585
- * Learn more about [filtering](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#filters).
586
- */
587
- filter?: Record<string, any> | null;
588
- /**
589
- * List of sort objects.
590
- *
591
- * Learn more about [sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#sorting).
592
- * @maxSize 10
593
- */
594
- sort?: Sorting[];
595
- /**
596
- * Logical groupings of data into facets, with summaries for each facet. For example, use aggregations to allow site visitors to narrow down their search results by selecting specific categories.
597
- * @maxSize 10
598
- */
599
- aggregations?: Aggregation[];
600
- /** Free text to match in searchable fields. */
601
- search?: SearchDetails;
602
- /**
603
- * Time zone to adjust date-time-based filters and aggregations, in ISO 8601 (including offsets) or IANA time zone database (including time zone IDs) format.
604
- * Applies to all relevant filters and aggregations, unless overridden by providing timestamps including time zone. For example, "2023-12-20T10:52:34.795Z".
605
- * @maxLength 50
606
- */
607
- timeZone?: string | null;
608
- }
609
- /** @oneof */
610
- interface CursorSearchPagingMethodOneOf {
611
- /**
612
- * Cursor paging options.
613
- *
614
- * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
615
- */
616
- cursorPaging?: CursorPaging;
617
- }
618
- interface Aggregation extends AggregationKindOneOf {
619
- /** A value aggregation calculates metrics such as count for specific fields within a dataset, providing insights into the overall distribution and key statistics of those values. For example, use a value aggregation to get the number (count) of products for each price listed in the store. */
620
- value?: ValueAggregation;
621
- /** A range aggregation calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. For example, use a range aggregation to compare the number of reservations made for parties of 4 or less to the number of reservations made for parties with 5 or more. */
622
- range?: RangeAggregation;
623
- /** A scalar aggregation calculates a single numerical value from a dataset, summarizing the dataset into one key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
624
- scalar?: ScalarAggregation;
625
- /** A date histogram calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.) For example, use a date histogram to find how many reservations have been made at a restaurant each week. */
626
- dateHistogram?: DateHistogramAggregation;
627
- /** A nested aggregation is applied within the results of another aggregation. Rather than aggregating directly on the primary dataset, first group data using one aggregation and then apply another aggregation within each group. It allows for more complex analyses where you can summarize data at different levels of detail or hierarchy. For example, to get the number of products that are in stock and out of stock for each price listed, first perform a value aggregation on `discountedPriceNumeric`, and a second value aggregation on `inStock`. */
628
- nested?: NestedAggregation;
629
- /**
630
- * Aggregation name, returned in `aggregations.results.name`.
631
- * @maxLength 100
632
- */
633
- name?: string | null;
634
- /** Type of aggregation to perform. Must align with the corresponding aggregation field. */
635
- type?: AggregationTypeWithLiterals;
636
- /**
637
- * Field to aggregate by. Use dot notation to specify a JSON path. For example, `order.address.streetName`.
638
- * @maxLength 200
639
- */
640
- fieldPath?: string;
641
- /**
642
- * Deprecated. Use `nested` instead.
643
- * @deprecated Deprecated. Use `nested` instead.
644
- * @replacedBy kind.nested
645
- * @targetRemovalDate 2024-03-30
646
- */
647
- groupBy?: GroupByAggregation;
648
- }
649
- /** @oneof */
650
- interface AggregationKindOneOf {
651
- /** A value aggregation calculates metrics such as count for specific fields within a dataset, providing insights into the overall distribution and key statistics of those values. For example, use a value aggregation to get the number (count) of products for each price listed in the store. */
652
- value?: ValueAggregation;
653
- /** A range aggregation calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. For example, use a range aggregation to compare the number of reservations made for parties of 4 or less to the number of reservations made for parties with 5 or more. */
654
- range?: RangeAggregation;
655
- /** A scalar aggregation calculates a single numerical value from a dataset, summarizing the dataset into one key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
656
- scalar?: ScalarAggregation;
657
- /** A date histogram calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.) For example, use a date histogram to find how many reservations have been made at a restaurant each week. */
658
- dateHistogram?: DateHistogramAggregation;
659
- /** A nested aggregation is applied within the results of another aggregation. Rather than aggregating directly on the primary dataset, first group data using one aggregation and then apply another aggregation within each group. It allows for more complex analyses where you can summarize data at different levels of detail or hierarchy. For example, to get the number of products that are in stock and out of stock for each price listed, first perform a value aggregation on `discountedPriceNumeric`, and a second value aggregation on `inStock`. */
660
- nested?: NestedAggregation;
661
- }
662
- interface RangeBucket {
663
- /** Inclusive lower bound of the range. Required if `to` is not provided. */
664
- from?: number | null;
665
- /** Exclusive upper bound of the range. Required if `from` is not provided. */
666
- to?: number | null;
667
- }
668
- declare enum SortType {
669
- /** Number of matches in the results. */
670
- COUNT = "COUNT",
671
- /** Alphabetically by the field value. */
672
- VALUE = "VALUE"
673
- }
674
- /** @enumType */
675
- type SortTypeWithLiterals = SortType | 'COUNT' | 'VALUE';
676
- declare enum SortDirection {
677
- /** Descending order. */
678
- DESC = "DESC",
679
- /** Ascending order. */
680
- ASC = "ASC"
681
- }
682
- /** @enumType */
683
- type SortDirectionWithLiterals = SortDirection | 'DESC' | 'ASC';
684
- declare enum MissingValues {
685
- /** Exclude missing values from the aggregation results. */
686
- EXCLUDE = "EXCLUDE",
687
- /** Include missing values in the aggregation results. */
688
- INCLUDE = "INCLUDE"
689
- }
690
- /** @enumType */
691
- type MissingValuesWithLiterals = MissingValues | 'EXCLUDE' | 'INCLUDE';
692
- interface IncludeMissingValuesOptions {
693
- /**
694
- * Specify a custom name for the bucket containing the missing values. Defaults are `"N/A"` for strings, `0` for integers, and `false` for booleans.
695
- * @maxLength 20
696
- */
697
- addToBucket?: string;
698
- }
699
- declare enum ScalarType {
700
- UNKNOWN_SCALAR_TYPE = "UNKNOWN_SCALAR_TYPE",
701
- /** Total number of distinct values. */
702
- COUNT_DISTINCT = "COUNT_DISTINCT",
703
- /** Minimum value. */
704
- MIN = "MIN",
705
- /** Maximum value. */
706
- MAX = "MAX"
707
- }
708
- /** @enumType */
709
- type ScalarTypeWithLiterals = ScalarType | 'UNKNOWN_SCALAR_TYPE' | 'COUNT_DISTINCT' | 'MIN' | 'MAX';
710
- interface ValueAggregation extends ValueAggregationOptionsOneOf {
711
- /** Options for including missing values in results. */
712
- includeOptions?: IncludeMissingValuesOptions;
713
- /** Sort type. */
714
- sortType?: SortTypeWithLiterals;
715
- /** Sort direction. */
716
- sortDirection?: SortDirectionWithLiterals;
717
- /**
718
- * Number of aggregation results to return.
719
- * Min: `1`
720
- * Max: `250`
721
- * Default: `10`
722
- */
723
- limit?: number | null;
724
- /**
725
- * Whether to include or exclude missing values in the aggregation results.
726
- * Default: `EXCLUDE`.
727
- */
728
- missingValues?: MissingValuesWithLiterals;
729
- }
730
- /** @oneof */
731
- interface ValueAggregationOptionsOneOf {
732
- /** Options for including missing values in results. */
733
- includeOptions?: IncludeMissingValuesOptions;
734
- }
735
- declare enum NestedAggregationType {
736
- UNKNOWN_AGGREGATION_TYPE = "UNKNOWN_AGGREGATION_TYPE",
737
- /** Calculates the distribution of a specific field's values within a dataset, providing insights into the overall distribution and key statistics of those values. */
738
- VALUE = "VALUE",
739
- /** Calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. */
740
- RANGE = "RANGE",
741
- /** Calculates a single numerical value from a dataset, summarizing the dataset into one key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
742
- SCALAR = "SCALAR",
743
- /** Calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.). */
744
- DATE_HISTOGRAM = "DATE_HISTOGRAM"
745
- }
746
- /** @enumType */
747
- type NestedAggregationTypeWithLiterals = NestedAggregationType | 'UNKNOWN_AGGREGATION_TYPE' | 'VALUE' | 'RANGE' | 'SCALAR' | 'DATE_HISTOGRAM';
748
- interface RangeAggregation {
749
- /**
750
- * List of range buckets. During aggregation each entity is placed in the first bucket its value falls into, based on the provided range bounds.
751
- * @maxSize 50
752
- */
753
- buckets?: RangeBucket[];
754
- }
755
- interface ScalarAggregation {
756
- /** Operator type for the scalar aggregation. */
757
- type?: ScalarTypeWithLiterals;
758
- }
759
- interface DateHistogramAggregation {
760
- /** Interval for date histogram aggregation. */
761
- interval?: IntervalWithLiterals;
762
- }
763
- declare enum Interval {
764
- UNKNOWN_INTERVAL = "UNKNOWN_INTERVAL",
765
- YEAR = "YEAR",
766
- MONTH = "MONTH",
767
- WEEK = "WEEK",
768
- DAY = "DAY",
769
- HOUR = "HOUR",
770
- MINUTE = "MINUTE",
771
- SECOND = "SECOND"
772
- }
773
- /** @enumType */
774
- type IntervalWithLiterals = Interval | 'UNKNOWN_INTERVAL' | 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND';
775
- interface NestedAggregationItem extends NestedAggregationItemKindOneOf {
776
- /** A value aggregation calculates the distribution of a specific field's values within a dataset, providing insights into the overall distribution and key statistics of those values. For example, use a value aggregation to get the number (count) of orders for each order status. */
777
- value?: ValueAggregation;
778
- /** A range aggregation calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. For example, use a range aggregation to compare the number of reservations made for parties of 4 or less to the number of reservations made for parties with 5 or more. If ranges overlap, a record that fits more than one range will only be counted in the first range that matches the criteria. */
779
- range?: RangeAggregation;
780
- /** A scalar aggregation calculates a single numerical value from a dataset, summarizing the dataset into one key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
781
- scalar?: ScalarAggregation;
782
- /** A date histogram calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.). For example, use a date histogram to determine how many reservations have been made at a restaurant each week. If ranges overlap, a record that fits more than one range will only be counted in the first range that matches the criteria. */
783
- dateHistogram?: DateHistogramAggregation;
784
- /**
785
- * Unique, caller-defined aggregation name, returned in `aggregations.results`.
786
- * @maxLength 100
787
- */
788
- name?: string | null;
789
- /** Type of aggregation to perform. The matching aggregation field must be passed. */
790
- type?: NestedAggregationTypeWithLiterals;
791
- /**
792
- * Field to aggregate by. Use dot notation to specify a JSON path. For example, `order.address.streetName`.
793
- * @maxLength 200
794
- */
795
- fieldPath?: string;
796
- }
797
- /** @oneof */
798
- interface NestedAggregationItemKindOneOf {
799
- /** A value aggregation calculates the distribution of a specific field's values within a dataset, providing insights into the overall distribution and key statistics of those values. For example, use a value aggregation to get the number (count) of orders for each order status. */
800
- value?: ValueAggregation;
801
- /** A range aggregation calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. For example, use a range aggregation to compare the number of reservations made for parties of 4 or less to the number of reservations made for parties with 5 or more. If ranges overlap, a record that fits more than one range will only be counted in the first range that matches the criteria. */
802
- range?: RangeAggregation;
803
- /** A scalar aggregation calculates a single numerical value from a dataset, summarizing the dataset into one key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
804
- scalar?: ScalarAggregation;
805
- /** A date histogram calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.). For example, use a date histogram to determine how many reservations have been made at a restaurant each week. If ranges overlap, a record that fits more than one range will only be counted in the first range that matches the criteria. */
806
- dateHistogram?: DateHistogramAggregation;
807
- }
808
- declare enum AggregationType {
809
- UNKNOWN_AGGREGATION_TYPE = "UNKNOWN_AGGREGATION_TYPE",
810
- /** Calculates the distribution of a specific field's values within a dataset, providing insights into the overall distribution and key statistics of those values. */
811
- VALUE = "VALUE",
812
- /** Calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. */
813
- RANGE = "RANGE",
814
- /** Calculates a single numerical value from a dataset, summarizing the dataset into one key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
815
- SCALAR = "SCALAR",
816
- /** Calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.). */
817
- DATE_HISTOGRAM = "DATE_HISTOGRAM",
818
- /** Flattened list of aggregations, where each aggregation is nested within previous one. */
819
- NESTED = "NESTED"
820
- }
821
- /** @enumType */
822
- type AggregationTypeWithLiterals = AggregationType | 'UNKNOWN_AGGREGATION_TYPE' | 'VALUE' | 'RANGE' | 'SCALAR' | 'DATE_HISTOGRAM' | 'NESTED';
823
- /** Nested aggregation expressed through a list of aggregation where each next aggregation is nested within previous one. */
824
- interface NestedAggregation {
825
- /**
826
- * Flattened list of aggregations, where each aggregation is nested within previous one.
827
- * @minSize 2
828
- * @maxSize 3
829
- */
830
- nestedAggregations?: NestedAggregationItem[];
831
- }
832
- interface GroupByAggregation extends GroupByAggregationKindOneOf {
833
- /** Value aggregation configuration. */
834
- value?: ValueAggregation;
835
- /**
836
- * Unique, caller-defined aggregation name, returned in `aggregations.results`.
837
- * @maxLength 100
838
- */
839
- name?: string | null;
840
- /**
841
- * Field to aggregate by.
842
- * @maxLength 200
843
- */
844
- fieldPath?: string;
845
- }
846
- /** @oneof */
847
- interface GroupByAggregationKindOneOf {
848
- /** Value aggregation configuration. */
849
- value?: ValueAggregation;
850
- }
851
- interface SearchDetails {
852
- /** Search mode. Defines the search logic for combining multiple terms in the `expression`. */
853
- mode?: ModeWithLiterals;
854
- /**
855
- * Search term or expression.
856
- * @maxLength 100
857
- */
858
- expression?: string | null;
859
- /**
860
- * Fields to search in. If the array is empty, all searchable fields are searched. Use dot notation to specify a JSON path. For example, `order.address.streetName`.
861
- * @maxLength 200
862
- * @maxSize 20
863
- */
864
- fields?: string[];
865
- /** Whether to enable the search function to use an algorithm to automatically find results that are close to the search expression, such as typos and declensions. */
866
- fuzzy?: boolean;
867
- }
868
- declare enum Mode {
869
- /** At least one of the search terms must be present. */
870
- OR = "OR",
871
- /** All search terms must be present. */
872
- AND = "AND"
873
- }
874
- /** @enumType */
875
- type ModeWithLiterals = Mode | 'OR' | 'AND';
876
- interface SearchParticipantsResponse {
877
- /** Participants matching the search criteria. */
878
- participants?: Participant[];
879
- /** Paging metadata. */
880
- pagingMetadata?: CursorPagingMetadata;
881
- /** Aggregation data in case aggregations were requested. */
882
- aggregationData?: AggregationData;
883
- }
884
- interface AggregationData {
885
- /**
886
- * key = aggregation name (as derived from search request).
887
- * @maxSize 10000
888
- */
889
- results?: AggregationResults[];
890
- }
891
- interface ValueAggregationResult {
892
- /**
893
- * Value of the field.
894
- * @maxLength 100
895
- */
896
- value?: string;
897
- /** Count of entities with this value. */
898
- count?: number;
899
- }
900
- interface RangeAggregationResult {
901
- /** Inclusive lower bound of the range. */
902
- from?: number | null;
903
- /** Exclusive upper bound of the range. */
904
- to?: number | null;
905
- /** Count of entities in this range. */
906
- count?: number;
907
- }
908
- interface NestedAggregationResults extends NestedAggregationResultsResultOneOf {
909
- /** Value aggregation results. */
910
- values?: ValueResults;
911
- /** Range aggregation results. */
912
- ranges?: RangeResults;
913
- /** Scalar aggregation results. */
914
- scalar?: AggregationResultsScalarResult;
915
- /**
916
- * User-defined name of aggregation, matches the one provided in request.
917
- * @maxLength 100
918
- */
919
- name?: string;
920
- /** Type of aggregation that matches result. */
921
- type?: AggregationTypeWithLiterals;
922
- /**
923
- * Field to aggregate by, matches the one provided in request.
924
- * @maxLength 200
925
- */
926
- fieldPath?: string;
927
- }
928
- /** @oneof */
929
- interface NestedAggregationResultsResultOneOf {
930
- /** Value aggregation results. */
931
- values?: ValueResults;
932
- /** Range aggregation results. */
933
- ranges?: RangeResults;
934
- /** Scalar aggregation results. */
935
- scalar?: AggregationResultsScalarResult;
936
- }
937
- interface ValueResults {
938
- /**
939
- * List of value aggregations.
940
- * @maxSize 250
941
- */
942
- results?: ValueAggregationResult[];
943
- }
944
- interface RangeResults {
945
- /**
946
- * List of ranges returned in same order as requested.
947
- * @maxSize 50
948
- */
949
- results?: RangeAggregationResult[];
950
- }
951
- interface AggregationResultsScalarResult {
952
- /** Type of scalar aggregation. */
953
- type?: ScalarTypeWithLiterals;
954
- /** Value of the scalar aggregation. */
955
- value?: number;
956
- }
957
- interface NestedValueAggregationResult {
958
- /**
959
- * Value of the field.
960
- * @maxLength 1000
961
- */
962
- value?: string;
963
- /** Nested aggregations. */
964
- nestedResults?: NestedAggregationResults;
965
- }
966
- interface ValueResult {
967
- /**
968
- * Value of the field.
969
- * @maxLength 1000
970
- */
971
- value?: string;
972
- /** Count of entities with this value. */
973
- count?: number | null;
974
- }
975
- interface RangeResult {
976
- /** Inclusive lower bound of the range. */
977
- from?: number | null;
978
- /** Exclusive upper bound of the range. */
979
- to?: number | null;
980
- /** Count of entities in this range. */
981
- count?: number | null;
982
- }
983
- interface ScalarResult {
984
- /** Value of the scalar aggregation. */
985
- value?: number;
986
- }
987
- interface NestedResultValue extends NestedResultValueResultOneOf {
988
- /** Value aggregation result. */
989
- value?: ValueResult;
990
- /** Range aggregation result. */
991
- range?: RangeResult;
992
- /** Scalar aggregation result. */
993
- scalar?: ScalarResult;
994
- /** Date histogram aggregation result. */
995
- dateHistogram?: ValueResult;
996
- }
997
- /** @oneof */
998
- interface NestedResultValueResultOneOf {
999
- /** Value aggregation result. */
1000
- value?: ValueResult;
1001
- /** Range aggregation result. */
1002
- range?: RangeResult;
1003
- /** Scalar aggregation result. */
1004
- scalar?: ScalarResult;
1005
- /** Date histogram aggregation result. */
1006
- dateHistogram?: ValueResult;
1007
- }
1008
- interface Results {
1009
- /** List of nested aggregations. */
1010
- results?: Record<string, NestedResultValue>;
1011
- }
1012
- interface DateHistogramResult {
1013
- /**
1014
- * Date in ISO 8601 format.
1015
- * @maxLength 100
1016
- */
1017
- value?: string;
1018
- /** Count of documents in the bucket. */
1019
- count?: number;
1020
- }
1021
- interface GroupByValueResults {
1022
- /**
1023
- * List of value aggregations.
1024
- * @maxSize 1000
1025
- */
1026
- results?: NestedValueAggregationResult[];
1027
- }
1028
- interface DateHistogramResults {
1029
- /**
1030
- * List of date histogram aggregations.
1031
- * @maxSize 200
1032
- */
1033
- results?: DateHistogramResult[];
1034
- }
1035
- /**
1036
- * Results of `NESTED` aggregation type in a flattened form.
1037
- * Aggregations in resulting array are keyed by requested aggregation `name`.
1038
- */
1039
- interface NestedResults {
1040
- /**
1041
- * List of nested aggregations.
1042
- * @maxSize 1000
1043
- */
1044
- results?: Results[];
1045
- }
1046
- interface AggregationResults extends AggregationResultsResultOneOf {
1047
- /** Value aggregation results. */
1048
- values?: ValueResults;
1049
- /** Range aggregation results. */
1050
- ranges?: RangeResults;
1051
- /** Scalar aggregation results. */
1052
- scalar?: AggregationResultsScalarResult;
1053
- /** Group by value aggregation results. */
1054
- groupedByValue?: GroupByValueResults;
1055
- /** Date histogram aggregation results. */
1056
- dateHistogram?: DateHistogramResults;
1057
- /** Nested aggregation results. */
1058
- nested?: NestedResults;
1059
- /**
1060
- * User-defined name of aggregation as derived from search request.
1061
- * @maxLength 100
1062
- */
1063
- name?: string;
1064
- /** Type of aggregation that must match provided kind as derived from search request. */
1065
- type?: AggregationTypeWithLiterals;
1066
- /**
1067
- * Field to aggregate by as derived from search request.
1068
- * @maxLength 200
1069
- */
1070
- fieldPath?: string;
1071
- }
1072
- /** @oneof */
1073
- interface AggregationResultsResultOneOf {
1074
- /** Value aggregation results. */
1075
- values?: ValueResults;
1076
- /** Range aggregation results. */
1077
- ranges?: RangeResults;
1078
- /** Scalar aggregation results. */
1079
- scalar?: AggregationResultsScalarResult;
1080
- /** Group by value aggregation results. */
1081
- groupedByValue?: GroupByValueResults;
1082
- /** Date histogram aggregation results. */
1083
- dateHistogram?: DateHistogramResults;
1084
- /** Nested aggregation results. */
1085
- nested?: NestedResults;
1086
- }
1087
- interface DomainEvent extends DomainEventBodyOneOf {
1088
- createdEvent?: EntityCreatedEvent;
1089
- updatedEvent?: EntityUpdatedEvent;
1090
- deletedEvent?: EntityDeletedEvent;
1091
- actionEvent?: ActionEvent;
1092
- /** Event ID. With this ID you can easily spot duplicated events and ignore them. */
1093
- _id?: string;
1094
- /**
1095
- * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
1096
- * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
1097
- */
1098
- entityFqdn?: string;
1099
- /**
1100
- * Event action name, placed at the top level to make it easier for users to dispatch messages.
1101
- * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
1102
- */
1103
- slug?: string;
1104
- /** ID of the entity associated with the event. */
1105
- entityId?: string;
1106
- /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
1107
- eventTime?: Date | null;
1108
- /**
1109
- * Whether the event was triggered as a result of a privacy regulation application
1110
- * (for example, GDPR).
1111
- */
1112
- triggeredByAnonymizeRequest?: boolean | null;
1113
- /** If present, indicates the action that triggered the event. */
1114
- originatedFrom?: string | null;
1115
- /**
1116
- * 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.
1117
- * 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.
1118
- */
1119
- entityEventSequence?: string | null;
1120
- }
1121
- /** @oneof */
1122
- interface DomainEventBodyOneOf {
1123
- createdEvent?: EntityCreatedEvent;
1124
- updatedEvent?: EntityUpdatedEvent;
1125
- deletedEvent?: EntityDeletedEvent;
1126
- actionEvent?: ActionEvent;
1127
- }
1128
- interface EntityCreatedEvent {
1129
- entity?: string;
1130
- }
1131
- interface RestoreInfo {
1132
- deletedDate?: Date | null;
1133
- }
1134
- interface EntityUpdatedEvent {
1135
- /**
1136
- * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
1137
- * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
1138
- * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
1139
- */
1140
- currentEntity?: string;
1141
- }
1142
- interface EntityDeletedEvent {
1143
- /** Entity that was deleted. */
1144
- deletedEntity?: string | null;
1145
- }
1146
- interface ActionEvent {
1147
- body?: string;
1148
- }
1149
- interface Empty {
1150
- }
1151
- interface BenefitNotification {
1152
- /**
1153
- * Plan unique ID
1154
- * @format GUID
1155
- */
1156
- planId?: string;
1157
- /**
1158
- * App def ID
1159
- * @format GUID
1160
- */
1161
- appDefId?: string;
1162
- /** Current benefit details */
1163
- benefit?: Benefit;
1164
- /** Previous benefit */
1165
- prevBenefit?: Benefit;
1166
- /** Notification event */
1167
- event?: EventWithLiterals;
1168
- }
1169
- interface Benefit {
1170
- /**
1171
- * Benefit unique ID
1172
- * @format GUID
1173
- * @readonly
1174
- */
1175
- _id?: string | null;
1176
- /** Benefit Type */
1177
- benefitType?: BenefitTypeWithLiterals;
1178
- /**
1179
- * Resource IDs that serves by this benefit
1180
- * @format GUID
1181
- */
1182
- resourceIds?: string[];
1183
- /** Amount of credits that provided by this benefit */
1184
- creditAmount?: number | null;
1185
- /**
1186
- * additional details related to benefit; limited to 20 entries, 20 symbols for key and 20 symbols for value
1187
- * @maxSize 20
1188
- */
1189
- customFields?: Record<string, string>;
1190
- /** return value only in case it required in the ListRequest, true means that benefit's type could be updated */
1191
- editable?: boolean | null;
1192
- /** Benefit behavior */
1193
- behavior?: Behavior;
1194
- /**
1195
- * Id of the app associated with this benefit
1196
- * @format GUID
1197
- * @readonly
1198
- */
1199
- appDefId?: string | null;
1200
- }
1201
- interface EntryPass {
1202
- }
1203
- interface Discount extends DiscountDiscountOneOf {
1204
- /**
1205
- * Fixed-rate percent off discount
1206
- * @decimalValue options { gt:0, lte:100, maxScale:2 }
1207
- */
1208
- percentOffRate?: string;
1209
- /**
1210
- * Absolute amount discount
1211
- * @decimalValue options { gt:0, maxScale:2 }
1212
- */
1213
- moneyOffAmount?: string;
1214
- }
1215
- /** @oneof */
1216
- interface DiscountDiscountOneOf {
1217
- /**
1218
- * Fixed-rate percent off discount
1219
- * @decimalValue options { gt:0, lte:100, maxScale:2 }
1220
- */
1221
- percentOffRate?: string;
1222
- /**
1223
- * Absolute amount discount
1224
- * @decimalValue options { gt:0, maxScale:2 }
1225
- */
1226
- moneyOffAmount?: string;
1227
- }
1228
- declare enum BenefitType {
1229
- /** Should never be used */
1230
- UNDEFINED = "UNDEFINED",
1231
- /** Limited benefit type */
1232
- LIMITED = "LIMITED",
1233
- /** Unlimited benefit type */
1234
- UNLIMITED = "UNLIMITED"
1235
- }
1236
- /** @enumType */
1237
- type BenefitTypeWithLiterals = BenefitType | 'UNDEFINED' | 'LIMITED' | 'UNLIMITED';
1238
- interface Behavior extends BehaviorBehaviorOneOf {
1239
- /** Entry pass for resources, e.g. a ticket for Bookings service or a ticket for Events. */
1240
- defaultBehavior?: EntryPass;
1241
- /** Discount applied to paid resources */
1242
- discount?: Discount;
1243
- }
1244
- /** @oneof */
1245
- interface BehaviorBehaviorOneOf {
1246
- /** Entry pass for resources, e.g. a ticket for Bookings service or a ticket for Events. */
1247
- defaultBehavior?: EntryPass;
1248
- /** Discount applied to paid resources */
1249
- discount?: Discount;
1250
- }
1251
- declare enum Event {
1252
- Updated = "Updated",
1253
- Deleted = "Deleted",
1254
- Created = "Created"
1255
- }
1256
- /** @enumType */
1257
- type EventWithLiterals = Event | 'Updated' | 'Deleted' | 'Created';
1258
- interface MessageEnvelope {
1259
- /**
1260
- * App instance ID.
1261
- * @format GUID
1262
- */
1263
- instanceId?: string | null;
1264
- /**
1265
- * Event type.
1266
- * @maxLength 150
1267
- */
1268
- eventType?: string;
1269
- /** The identification type and identity data. */
1270
- identity?: IdentificationData;
1271
- /** Stringify payload. */
1272
- data?: string;
1273
- }
1274
- interface IdentificationData extends IdentificationDataIdOneOf {
1275
- /**
1276
- * ID of a site visitor that has not logged in to the site.
1277
- * @format GUID
1278
- */
1279
- anonymousVisitorId?: string;
1280
- /**
1281
- * ID of a site visitor that has logged in to the site.
1282
- * @format GUID
1283
- */
1284
- memberId?: string;
1285
- /**
1286
- * ID of a Wix user (site owner, contributor, etc.).
1287
- * @format GUID
1288
- */
1289
- wixUserId?: string;
1290
- /**
1291
- * ID of an app.
1292
- * @format GUID
1293
- */
1294
- appId?: string;
1295
- /** @readonly */
1296
- identityType?: WebhookIdentityTypeWithLiterals;
1297
- }
1298
- /** @oneof */
1299
- interface IdentificationDataIdOneOf {
1300
- /**
1301
- * ID of a site visitor that has not logged in to the site.
1302
- * @format GUID
1303
- */
1304
- anonymousVisitorId?: string;
1305
- /**
1306
- * ID of a site visitor that has logged in to the site.
1307
- * @format GUID
1308
- */
1309
- memberId?: string;
1310
- /**
1311
- * ID of a Wix user (site owner, contributor, etc.).
1312
- * @format GUID
1313
- */
1314
- wixUserId?: string;
1315
- /**
1316
- * ID of an app.
1317
- * @format GUID
1318
- */
1319
- appId?: string;
1320
- }
1321
- declare enum WebhookIdentityType {
1322
- UNKNOWN = "UNKNOWN",
1323
- ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
1324
- MEMBER = "MEMBER",
1325
- WIX_USER = "WIX_USER",
1326
- APP = "APP"
1327
- }
1328
- /** @enumType */
1329
- type WebhookIdentityTypeWithLiterals = WebhookIdentityType | 'UNKNOWN' | 'ANONYMOUS_VISITOR' | 'MEMBER' | 'WIX_USER' | 'APP';
1330
- declare enum State {
1331
- /** Unknown state */
1332
- UNKNOWN_STATE = "UNKNOWN_STATE",
1333
- /** Member joined the program and became participant */
1334
- JOINED = "JOINED",
1335
- /** Participant completed the program, and could join again */
1336
- COMPLETED = "COMPLETED",
1337
- /** Participant failed to complete the program, and could join again */
1338
- FAILED = "FAILED",
1339
- /** Participant with ended pricing plan (PP), will be joined as renew PP */
1340
- SUSPENDED = "SUSPENDED",
1341
- /** Participant removed automatically after some program condition */
1342
- AUTO_REMOVED = "AUTO_REMOVED",
1343
- /** Participant removed by site owner */
1344
- REMOVED = "REMOVED",
1345
- /** Participant left the program by himself */
1346
- LEFT = "LEFT"
1347
- }
1348
- /** @enumType */
1349
- type StateWithLiterals = State | 'UNKNOWN_STATE' | 'JOINED' | 'COMPLETED' | 'FAILED' | 'SUSPENDED' | 'AUTO_REMOVED' | 'REMOVED' | 'LEFT';
1350
- interface BulkInviteToProgramRequest {
1351
- /**
1352
- * Program to which bulk invite participants.
1353
- * @format GUID
1354
- */
1355
- programId: string;
1356
- /**
1357
- * Return added participants in the response or not.
1358
- * @format GUID
1359
- * @minSize 1
1360
- * @maxSize 100
1361
- */
1362
- memberIds?: string[];
1363
- /** Return invited participants in the response or not. */
1364
- returnEntity?: boolean;
1365
- }
1366
- interface BulkInviteToProgramResponse {
1367
- /** Participants created by bulk action */
1368
- results?: BulkInviteToProgramResult[];
1369
- /** Bulk action metadata. */
1370
- bulkActionMetadata?: BulkActionMetadata;
1371
- }
1372
- interface ItemMetadata {
1373
- /** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
1374
- _id?: string | null;
1375
- /** Index of the item within the request array. Allows for correlation between request and response items. */
1376
- originalIndex?: number;
1377
- /** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
1378
- success?: boolean;
1379
- /** Details about the error in case of failure. */
1380
- error?: ApplicationError;
1381
- }
1382
- interface BulkInviteToProgramResult {
1383
- /** Invited participant metadata. */
1384
- itemMetadata?: ItemMetadata;
1385
- /** Invited participant */
1386
- item?: Participant;
1387
- }
1388
- interface BulkActionMetadata {
1389
- /** Number of items that were successfully processed. */
1390
- totalSuccesses?: number;
1391
- /** Number of items that couldn't be processed. */
1392
- totalFailures?: number;
1393
- /** Number of failures without details because detailed failure threshold was exceeded. */
1394
- undetailedFailures?: number;
1395
- }
1396
- interface ParticipantInvited {
1397
- /**
1398
- * Program to which bulk invite participants.
1399
- * @format GUID
1400
- */
1401
- programId?: string;
1402
- /**
1403
- * Invited member to program
1404
- * @format GUID
1405
- */
1406
- memberId?: string;
1407
- }
1408
- interface BulkInviteAllToProgramRequest {
1409
- /**
1410
- * Program to which bulk add participants.
1411
- * @format GUID
1412
- */
1413
- programId: string;
1414
- /**
1415
- * Exclude site members.
1416
- * @format GUID
1417
- * @maxSize 100
1418
- */
1419
- excludeMemberIds?: string[];
1420
- }
1421
- interface BulkInviteAllToProgramResponse {
1422
- /** Bulk action metadata. */
1423
- bulkActionMetadata?: BulkActionMetadata;
1424
- }
1425
- interface BulkAddToProgramRequest {
1426
- /**
1427
- * Program to which bulk add participants.
1428
- * @format GUID
1429
- */
1430
- programId: string;
1431
- /**
1432
- * Site members.
1433
- * @format GUID
1434
- * @minSize 1
1435
- * @maxSize 1000
1436
- */
1437
- memberIds?: string[];
1438
- /** Return added participants in the response or not. */
1439
- returnEntity?: boolean;
1440
- }
1441
- interface BulkAddToProgramResponse {
1442
- /** Participants created by bulk action */
1443
- results?: BulkAddToProgramResult[];
1444
- /** Bulk action metadata. */
1445
- bulkActionMetadata?: BulkActionMetadata;
1446
- }
1447
- interface BulkAddToProgramResult {
1448
- /** Added participant metadata. */
1449
- itemMetadata?: ItemMetadata;
1450
- /** Added participant */
1451
- item?: Participant;
1452
- }
1453
- interface BulkApproveParticipantRequest {
1454
- /**
1455
- * Participants to add
1456
- * @format GUID
1457
- * @maxSize 100
1458
- */
1459
- participantIds: string[];
1460
- /**
1461
- * program to approve participant
1462
- * @format GUID
1463
- */
1464
- programId?: string;
1465
- /** Return approved participants in the response or not */
1466
- returnEntity?: boolean;
1467
- }
1468
- interface BulkApproveParticipantResponse {
1469
- /** Participants approved by bulk action */
1470
- results?: BulkApproveParticipantResult[];
1471
- /** Bulk action metadata */
1472
- bulkActionMetadata?: BulkActionMetadata;
1473
- }
1474
- interface BulkApproveParticipantResult {
1475
- /** Approved participant metadata */
1476
- itemMetadata?: ItemMetadata;
1477
- /** Approved or existing participant */
1478
- item?: Participant;
1479
- }
1480
- interface ParticipantApproved {
1481
- /**
1482
- * Program ID which participant approved
1483
- * @format GUID
1484
- */
1485
- programId?: string;
1486
- /**
1487
- * Member ID of participant approved
1488
- * @format GUID
1489
- */
1490
- memberId?: string;
1491
- }
1492
- interface BulkApproveAllParticipantRequest {
1493
- /**
1494
- * Program to approve all participants.
1495
- * @format GUID
1496
- */
1497
- programId?: string;
1498
- /**
1499
- * Exclude site members.
1500
- * @format GUID
1501
- * @maxSize 100
1502
- */
1503
- excludeParticipantIds?: string[];
1504
- }
1505
- interface BulkApproveAllParticipantResponse {
1506
- /**
1507
- * Job id with async process
1508
- * @format GUID
1509
- */
1510
- jobId?: string;
1511
- }
1512
- interface ExportParticipantsStatsRequest {
1513
- /**
1514
- * program id to export data from
1515
- * @format GUID
1516
- */
1517
- programId: string;
1518
- }
1519
- interface ExportParticipantsStatsResponse {
1520
- }
1521
- interface ParticipantExportsFinished {
1522
- /**
1523
- * program id from which stats were exported
1524
- * @format GUID
1525
- */
1526
- programId?: string;
1527
- /**
1528
- * user id of program owner
1529
- * @format GUID
1530
- */
1531
- userId?: string;
1532
- /**
1533
- * url to download report
1534
- * @format WEB_URL
1535
- */
1536
- downloadUrl?: string;
1537
- /** days url will be downloadable */
1538
- downloadUrlTtlDays?: number;
1539
- }
1540
- /** @docsIgnore */
1541
- type CreateParticipantApplicationErrors = {
1542
- code?: 'INVALID_PAYMENT_INFO';
1543
- description?: string;
1544
- data?: Record<string, any>;
1545
- };
1546
- /** @docsIgnore */
1547
- type BulkUpdateParticipantTagsApplicationErrors = {
1548
- code?: 'EMPTY_ASSIGN_AND_UNASSIGN_LISTS';
1549
- description?: string;
1550
- data?: Record<string, any>;
1551
- };
1552
- /** @docsIgnore */
1553
- type BulkUpdateParticipantTagsByFilterApplicationErrors = {
1554
- code?: 'EMPTY_ASSIGN_AND_UNASSIGN_LISTS';
1555
- description?: string;
1556
- data?: Record<string, any>;
1557
- };
1558
- interface BaseEventMetadata {
1559
- /**
1560
- * App instance ID.
1561
- * @format GUID
1562
- */
1563
- instanceId?: string | null;
1564
- /**
1565
- * Event type.
1566
- * @maxLength 150
1567
- */
1568
- eventType?: string;
1569
- /** The identification type and identity data. */
1570
- identity?: IdentificationData;
1571
- }
1572
- interface EventMetadata extends BaseEventMetadata {
1573
- /** Event ID. With this ID you can easily spot duplicated events and ignore them. */
1574
- _id?: string;
1575
- /**
1576
- * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
1577
- * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
1578
- */
1579
- entityFqdn?: string;
1580
- /**
1581
- * Event action name, placed at the top level to make it easier for users to dispatch messages.
1582
- * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
1583
- */
1584
- slug?: string;
1585
- /** ID of the entity associated with the event. */
1586
- entityId?: string;
1587
- /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
1588
- eventTime?: Date | null;
1589
- /**
1590
- * Whether the event was triggered as a result of a privacy regulation application
1591
- * (for example, GDPR).
1592
- */
1593
- triggeredByAnonymizeRequest?: boolean | null;
1594
- /** If present, indicates the action that triggered the event. */
1595
- originatedFrom?: string | null;
1596
- /**
1597
- * 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.
1598
- * 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.
1599
- */
1600
- entityEventSequence?: string | null;
1601
- }
1602
- interface ParticipantAddedEnvelope {
1603
- data: ParticipantAdded;
1604
- metadata: EventMetadata;
1605
- }
1606
- /** @permissionScope Manage Challenges
1607
- * @permissionScopeId SCOPE.CHALLENGES.MANAGE
1608
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_READ
1609
- * @webhook
1610
- * @eventType wix.online_programs.v3.participant_added
1611
- * @slug added
1612
- * @documentationMaturity preview
1613
- */
1614
- declare function onParticipantAdded(handler: (event: ParticipantAddedEnvelope) => void | Promise<void>): void;
1615
- interface ParticipantApprovedEnvelope {
1616
- data: ParticipantApproved;
1617
- metadata: EventMetadata;
1618
- }
1619
- /** @permissionScope Manage Challenges
1620
- * @permissionScopeId SCOPE.CHALLENGES.MANAGE
1621
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_READ
1622
- * @webhook
1623
- * @eventType wix.online_programs.v3.participant_participant_approved
1624
- * @serviceIdentifier wix.onlineprograms.participants.v3.ManageParticipantsService
1625
- * @slug participant_approved
1626
- * @documentationMaturity preview
1627
- */
1628
- declare function onParticipantApproved(handler: (event: ParticipantApprovedEnvelope) => void | Promise<void>): void;
1629
- interface ParticipantInvitedEnvelope {
1630
- data: ParticipantInvited;
1631
- metadata: EventMetadata;
1632
- }
1633
- /** @permissionScope Manage Challenges
1634
- * @permissionScopeId SCOPE.CHALLENGES.MANAGE
1635
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_READ
1636
- * @webhook
1637
- * @eventType wix.online_programs.v3.participant_participant_invited
1638
- * @serviceIdentifier wix.onlineprograms.participants.v3.ManageParticipantsService
1639
- * @slug participant_invited
1640
- * @documentationMaturity preview
1641
- */
1642
- declare function onParticipantInvited(handler: (event: ParticipantInvitedEnvelope) => void | Promise<void>): void;
1643
- /**
1644
- * Create one participant.
1645
- * @param participant - Participant to create
1646
- * @public
1647
- * @documentationMaturity preview
1648
- * @requiredField participant
1649
- * @requiredField participant.joinedInfo.joinPath
1650
- * @requiredField participant.memberId
1651
- * @requiredField participant.programId
1652
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_CREATE
1653
- * @returns Created participant
1654
- * @fqn wix.onlineprograms.participants.v3.ParticipantsService.CreateParticipant
1655
- */
1656
- declare function createParticipant(participant: NonNullablePaths<Participant, `joinedInfo.joinPath` | `memberId` | `programId`, 3>): Promise<NonNullablePaths<Participant, `memberId` | `programId` | `progress.totalStepsCompleted` | `progress.totalStepsAvailable` | `progress.completionPercentage` | `status` | `joinedInfo.singlePaymentDetails.paymentOrderId` | `joinedInfo.paidPlanDetails.paidPlanId` | `joinedInfo.freeCouponDetails.freeCouponId` | `joinedInfo.timeZone` | `joinedInfo.startDate` | `joinedInfo.joinPath` | `member.contactId` | `tags.privateTags.tagIds`, 4> & {
1657
- __applicationErrorsType?: CreateParticipantApplicationErrors;
1658
- }>;
1659
- /**
1660
- * Creates participants in bulk.
1661
- * @param participants - List of participants you want to create
1662
- * @public
1663
- * @documentationMaturity preview
1664
- * @requiredField participants
1665
- * @requiredField participants.joinedInfo.joinPath
1666
- * @requiredField participants.memberId
1667
- * @requiredField participants.programId
1668
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_CREATE
1669
- * @fqn wix.onlineprograms.participants.v3.ParticipantsService.BulkCreateParticipant
1670
- */
1671
- declare function bulkCreateParticipant(participants: NonNullablePaths<Participant, `joinedInfo.joinPath` | `memberId` | `programId`, 3>[], options?: BulkCreateParticipantOptions): Promise<NonNullablePaths<BulkCreateParticipantResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.memberId` | `results.${number}.item.programId` | `results.${number}.item.progress.totalStepsCompleted` | `results.${number}.item.progress.totalStepsAvailable` | `results.${number}.item.progress.completionPercentage` | `results.${number}.item.status` | `results.${number}.item.joinedInfo.timeZone` | `results.${number}.item.joinedInfo.startDate` | `results.${number}.item.joinedInfo.joinPath` | `results.${number}.item.member.contactId` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
1672
- interface BulkCreateParticipantOptions {
1673
- /** Whether to return entities in response or not. */
1674
- returnEntity?: boolean;
1675
- }
1676
- /**
1677
- * Bulk adds all site members to program, but not more then 1000.
1678
- * Participant will be either created in state Joined, or updated to that state
1679
- * from pending one.
1680
- * @param programId - Program to which bulk add participants.
1681
- * @public
1682
- * @documentationMaturity preview
1683
- * @requiredField programId
1684
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_ADD
1685
- * @applicableIdentity APP
1686
- * @fqn wix.onlineprograms.participants.v3.ParticipantsService.BulkAddAllToProgram
1687
- */
1688
- declare function bulkAddAllToProgram(programId: string, options?: BulkAddAllToProgramOptions): Promise<NonNullablePaths<BulkAddAllToProgramResponse, `jobId`, 2>>;
1689
- interface BulkAddAllToProgramOptions {
1690
- /**
1691
- * Exclude site members.
1692
- * @format GUID
1693
- * @maxSize 100
1694
- */
1695
- excludeMemberIds?: string[];
1696
- }
1697
- /**
1698
- * Delete participant from program. Removes participant from member
1699
- * group. Leaves him in Social Group.
1700
- * @param participantId - Participants to delete
1701
- * @public
1702
- * @documentationMaturity preview
1703
- * @requiredField participantId
1704
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_DELETE
1705
- * @fqn wix.onlineprograms.participants.v3.ParticipantsService.DeleteParticipant
1706
- */
1707
- declare function deleteParticipant(participantId: string): Promise<void>;
1708
- /**
1709
- * Issue certificate by site admin
1710
- * @param participantId - Participant to get certificate
1711
- * @public
1712
- * @documentationMaturity preview
1713
- * @requiredField participantId
1714
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_ISSUE_CERTIFICATE
1715
- * @applicableIdentity APP
1716
- * @fqn wix.onlineprograms.participants.v3.ParticipantsService.IssueCertificate
1717
- */
1718
- declare function issueCertificate(participantId: string): Promise<NonNullablePaths<IssueCertificateResponse, `participant.memberId` | `participant.programId` | `participant.progress.totalStepsCompleted` | `participant.progress.totalStepsAvailable` | `participant.progress.completionPercentage` | `participant.status` | `participant.joinedInfo.singlePaymentDetails.paymentOrderId` | `participant.joinedInfo.paidPlanDetails.paidPlanId` | `participant.joinedInfo.freeCouponDetails.freeCouponId` | `participant.joinedInfo.timeZone` | `participant.joinedInfo.startDate` | `participant.joinedInfo.joinPath` | `participant.member.contactId` | `participant.tags.privateTags.tagIds`, 5>>;
1719
- /**
1720
- * Get program's completion stats
1721
- * @param programId - program id to get stats for
1722
- * @public
1723
- * @documentationMaturity preview
1724
- * @requiredField programId
1725
- * @permissionId ONLINE_PROGRAMS.STATS_READ
1726
- * @applicableIdentity APP
1727
- * @fqn wix.onlineprograms.participants.v3.ParticipantsService.GetCompletionStats
1728
- */
1729
- declare function getCompletionStats(programId: string): Promise<NonNullablePaths<GetCompletionStatsResponse, `completedAll` | `completionRate`, 2>>;
1730
- /**
1731
- * Get premium stats
1732
- * @public
1733
- * @documentationMaturity preview
1734
- * @permissionId ONLINE_PROGRAMS.STATS_READ
1735
- * @applicableIdentity APP
1736
- * @fqn wix.onlineprograms.participants.v3.ParticipantsService.GetPremiumStats
1737
- */
1738
- declare function getPremiumStats(): Promise<NonNullablePaths<GetPremiumStatsResponse, `hasPremium` | `activeParticipantsCount` | `activeParticipantsLimit`, 2>>;
1739
- /**
1740
- * Returns participant.
1741
- * @param participantId - Participant id to fetch
1742
- * @public
1743
- * @documentationMaturity preview
1744
- * @requiredField participantId
1745
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_READ
1746
- * @applicableIdentity APP
1747
- * @applicableIdentity MEMBER
1748
- * @returns existing participant
1749
- * @fqn wix.onlineprograms.participants.v3.ParticipantsService.GetParticipant
1750
- */
1751
- declare function getParticipant(participantId: string): Promise<NonNullablePaths<Participant, `memberId` | `programId` | `progress.totalStepsCompleted` | `progress.totalStepsAvailable` | `progress.completionPercentage` | `status` | `joinedInfo.singlePaymentDetails.paymentOrderId` | `joinedInfo.paidPlanDetails.paidPlanId` | `joinedInfo.freeCouponDetails.freeCouponId` | `joinedInfo.timeZone` | `joinedInfo.startDate` | `joinedInfo.joinPath` | `member.contactId` | `tags.privateTags.tagIds`, 4>>;
1752
- /**
1753
- * Query existing participants
1754
- * @public
1755
- * @documentationMaturity preview
1756
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_READ
1757
- * @applicableIdentity APP
1758
- * @applicableIdentity MEMBER
1759
- * @fqn wix.onlineprograms.participants.v3.ParticipantsService.QueryParticipants
1760
- */
1761
- declare function queryParticipants(): ParticipantsQueryBuilder;
1762
- interface QueryCursorResult {
1763
- cursors: Cursors;
1764
- hasNext: () => boolean;
1765
- hasPrev: () => boolean;
1766
- length: number;
1767
- pageSize: number;
1768
- }
1769
- interface ParticipantsQueryResult extends QueryCursorResult {
1770
- items: Participant[];
1771
- query: ParticipantsQueryBuilder;
1772
- next: () => Promise<ParticipantsQueryResult>;
1773
- prev: () => Promise<ParticipantsQueryResult>;
1774
- }
1775
- interface ParticipantsQueryBuilder {
1776
- /** @param propertyName - Property whose value is compared with `value`.
1777
- * @param value - Value to compare against.
1778
- * @documentationMaturity preview
1779
- */
1780
- eq: (propertyName: '_id' | 'memberId' | 'programId' | 'status', value: any) => ParticipantsQueryBuilder;
1781
- /** @param propertyName - Property whose value is compared with `value`.
1782
- * @param value - Value to compare against.
1783
- * @documentationMaturity preview
1784
- */
1785
- ge: (propertyName: 'joinedInfo.startDate', value: any) => ParticipantsQueryBuilder;
1786
- /** @param propertyName - Property whose value is compared with `value`.
1787
- * @param value - Value to compare against.
1788
- * @documentationMaturity preview
1789
- */
1790
- gt: (propertyName: 'joinedInfo.startDate', value: any) => ParticipantsQueryBuilder;
1791
- /** @param propertyName - Property whose value is compared with `value`.
1792
- * @param value - Value to compare against.
1793
- * @documentationMaturity preview
1794
- */
1795
- le: (propertyName: 'joinedInfo.startDate', value: any) => ParticipantsQueryBuilder;
1796
- /** @param propertyName - Property whose value is compared with `value`.
1797
- * @param value - Value to compare against.
1798
- * @documentationMaturity preview
1799
- */
1800
- lt: (propertyName: 'joinedInfo.startDate', value: any) => ParticipantsQueryBuilder;
1801
- /** @documentationMaturity preview */
1802
- in: (propertyName: '_id' | 'memberId' | 'status', value: any) => ParticipantsQueryBuilder;
1803
- /** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
1804
- * @documentationMaturity preview
1805
- */
1806
- ascending: (...propertyNames: Array<'_id' | '_createdDate' | 'status' | 'joinedInfo.startDate'>) => ParticipantsQueryBuilder;
1807
- /** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
1808
- * @documentationMaturity preview
1809
- */
1810
- descending: (...propertyNames: Array<'_id' | '_createdDate' | 'status' | 'joinedInfo.startDate'>) => ParticipantsQueryBuilder;
1811
- /** @param limit - Number of items to return, which is also the `pageSize` of the results object.
1812
- * @documentationMaturity preview
1813
- */
1814
- limit: (limit: number) => ParticipantsQueryBuilder;
1815
- /** @param cursor - A pointer to specific record
1816
- * @documentationMaturity preview
1817
- */
1818
- skipTo: (cursor: string) => ParticipantsQueryBuilder;
1819
- /** @documentationMaturity preview */
1820
- find: () => Promise<ParticipantsQueryResult>;
1821
- }
1822
- /**
1823
- * @hidden
1824
- * @fqn wix.onlineprograms.participants.v3.ParticipantsService.QueryParticipants
1825
- * @requiredField query
1826
- */
1827
- declare function typedQueryParticipants(query: ParticipantQuery): Promise<NonNullablePaths<QueryParticipantsResponse, `participants` | `participants.${number}.memberId` | `participants.${number}.programId` | `participants.${number}.progress.totalStepsCompleted` | `participants.${number}.progress.totalStepsAvailable` | `participants.${number}.progress.completionPercentage` | `participants.${number}.status` | `participants.${number}.joinedInfo.singlePaymentDetails.paymentOrderId` | `participants.${number}.joinedInfo.paidPlanDetails.paidPlanId` | `participants.${number}.joinedInfo.freeCouponDetails.freeCouponId` | `participants.${number}.joinedInfo.timeZone` | `participants.${number}.joinedInfo.startDate` | `participants.${number}.joinedInfo.joinPath` | `participants.${number}.member.contactId`, 6>>;
1828
- interface ParticipantQuerySpec extends QuerySpec {
1829
- paging: 'cursor';
1830
- wql: [
1831
- {
1832
- fields: ['_id', 'status'];
1833
- operators: ['$eq', '$in'];
1834
- sort: 'BOTH';
1835
- },
1836
- {
1837
- fields: ['memberId'];
1838
- operators: ['$eq', '$in'];
1839
- sort: 'NONE';
1840
- },
1841
- {
1842
- fields: ['programId'];
1843
- operators: ['$eq'];
1844
- sort: 'NONE';
1845
- },
1846
- {
1847
- fields: ['_createdDate'];
1848
- operators: [];
1849
- sort: 'BOTH';
1850
- },
1851
- {
1852
- fields: ['joinedInfo.startDate'];
1853
- operators: ['$gt', '$gte', '$lt', '$lte'];
1854
- sort: 'BOTH';
1855
- }
1856
- ];
1857
- }
1858
- type CommonQueryWithEntityContext = Query<Participant, ParticipantQuerySpec>;
1859
- type ParticipantQuery = {
1860
- /**
1861
- Cursor paging options.
1862
-
1863
- Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
1864
- */
1865
- cursorPaging?: {
1866
- /**
1867
- Maximum number of items to return in the results.
1868
- @max: 100
1869
- */
1870
- limit?: NonNullable<CommonQueryWithEntityContext['cursorPaging']>['limit'] | null;
1871
- /**
1872
- Pointer to the next or previous page in the list of results.
1873
-
1874
- Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
1875
- Not relevant for the first request.
1876
- @maxLength: 16000
1877
- */
1878
- cursor?: NonNullable<CommonQueryWithEntityContext['cursorPaging']>['cursor'] | null;
1879
- };
1880
- /**
1881
- Filter object.
1882
-
1883
- Learn more about [filtering](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#filters).
1884
- */
1885
- filter?: CommonQueryWithEntityContext['filter'] | null;
1886
- /**
1887
- Sort object.
1888
-
1889
- Learn more about [sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#sorting).
1890
- @maxSize: 5
1891
- */
1892
- sort?: {
1893
- /**
1894
- Name of the field to sort by.
1895
- @maxLength: 512
1896
- */
1897
- fieldName?: NonNullable<CommonQueryWithEntityContext['sort']>[number]['fieldName'];
1898
- /**
1899
- Sort order.
1900
- */
1901
- order?: NonNullable<CommonQueryWithEntityContext['sort']>[number]['order'];
1902
- }[];
1903
- };
1904
- /**
1905
- * Get access status
1906
- * @public
1907
- * @documentationMaturity preview
1908
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_READ
1909
- * @applicableIdentity APP
1910
- * @applicableIdentity MEMBER
1911
- * @fqn wix.onlineprograms.participants.v3.ParticipantsService.GetAccessStatus
1912
- */
1913
- declare function getAccessStatus(): Promise<NonNullablePaths<GetAccessStatusResponse, `blocked`, 2>>;
1914
- /**
1915
- * Updates tags for multiple Participants by IDs.
1916
- *
1917
- * Allows assigning and/or unassigning tags in a single operation.
1918
- * At least one of assign_tags or unassign_tags must be provided.
1919
- * @param participantIds - Participant IDs to update tags for (1-100 items)
1920
- * @public
1921
- * @documentationMaturity preview
1922
- * @requiredField participantIds
1923
- * @permissionId online_programs:v3:participant:bulk_update_participant_tags
1924
- * @fqn wix.onlineprograms.participants.v3.ParticipantsService.BulkUpdateParticipantTags
1925
- */
1926
- declare function bulkUpdateParticipantTags(participantIds: string[], options?: BulkUpdateParticipantTagsOptions): Promise<NonNullablePaths<BulkUpdateParticipantTagsResponse, `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`, 6> & {
1927
- __applicationErrorsType?: BulkUpdateParticipantTagsApplicationErrors;
1928
- }>;
1929
- interface BulkUpdateParticipantTagsOptions {
1930
- /** Tags to assign to the Participants */
1931
- assignTags?: Tags;
1932
- /** Tags to unassign from the Participants */
1933
- unassignTags?: Tags;
1934
- }
1935
- /**
1936
- * Updates tags for Participants matching a filter.
1937
- *
1938
- * Allows assigning and/or unassigning tags for all Participants matching the filter.
1939
- * Returns a job ID for tracking the async operation.
1940
- * @param filter - WQL filter to select Participants
1941
- * @public
1942
- * @documentationMaturity preview
1943
- * @requiredField filter
1944
- * @permissionId online_programs:v3:participant:bulk_update_participant_tags_by_filter
1945
- * @fqn wix.onlineprograms.participants.v3.ParticipantsService.BulkUpdateParticipantTagsByFilter
1946
- */
1947
- declare function bulkUpdateParticipantTagsByFilter(filter: Record<string, any>, options?: BulkUpdateParticipantTagsByFilterOptions): Promise<NonNullablePaths<BulkUpdateParticipantTagsByFilterResponse, `jobId`, 2> & {
1948
- __applicationErrorsType?: BulkUpdateParticipantTagsByFilterApplicationErrors;
1949
- }>;
1950
- interface BulkUpdateParticipantTagsByFilterOptions {
1951
- /** Tags to assign to matching Participants */
1952
- assignTags?: Tags;
1953
- /** Tags to unassign from matching Participants */
1954
- unassignTags?: Tags;
1955
- }
1956
- interface ParticipantSearchSpec extends SearchSpec {
1957
- searchable: ['member.email', 'member.firstName', 'member.lastName'];
1958
- aggregatable: [
1959
- '_id',
1960
- 'joinedInfo.startDate',
1961
- 'memberId',
1962
- 'programId',
1963
- 'status'
1964
- ];
1965
- paging: 'cursor';
1966
- wql: [
1967
- {
1968
- operators: ['$eq', '$in'];
1969
- fields: ['_id', 'status'];
1970
- sort: 'BOTH';
1971
- },
1972
- {
1973
- operators: ['$eq', '$in'];
1974
- fields: ['memberId'];
1975
- sort: 'NONE';
1976
- },
1977
- {
1978
- operators: ['$eq'];
1979
- fields: ['programId'];
1980
- sort: 'NONE';
1981
- },
1982
- {
1983
- operators: [];
1984
- fields: ['_createdDate'];
1985
- sort: 'BOTH';
1986
- },
1987
- {
1988
- operators: ['$gt', '$gte', '$lt', '$lte'];
1989
- fields: ['joinedInfo.startDate'];
1990
- sort: 'BOTH';
1991
- }
1992
- ];
1993
- }
1994
- type CommonSearchWithEntityContext = Search<Participant, ParticipantSearchSpec>;
1995
- type ParticipantSearch = {
1996
- /**
1997
- Cursor paging options.
1998
-
1999
- Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
2000
- */
2001
- cursorPaging?: {
2002
- /**
2003
- Maximum number of items to return in the results.
2004
- @max: 100
2005
- */
2006
- limit?: NonNullable<CommonSearchWithEntityContext['cursorPaging']>['limit'] | null;
2007
- /**
2008
- Pointer to the next or previous page in the list of results.
2009
-
2010
- Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
2011
- Not relevant for the first request.
2012
- @maxLength: 16000
2013
- */
2014
- cursor?: NonNullable<CommonSearchWithEntityContext['cursorPaging']>['cursor'] | null;
2015
- };
2016
- /**
2017
- Filter object.
2018
-
2019
- Learn more about [filtering](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#filters).
2020
- */
2021
- filter?: CommonSearchWithEntityContext['filter'] | null;
2022
- /**
2023
- List of sort objects.
2024
-
2025
- Learn more about [sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#sorting).
2026
- @maxSize: 10
2027
- */
2028
- sort?: {
2029
- /**
2030
- Name of the field to sort by.
2031
- @maxLength: 512
2032
- */
2033
- fieldName?: NonNullable<CommonSearchWithEntityContext['sort']>[number]['fieldName'];
2034
- /**
2035
- Sort order.
2036
- */
2037
- order?: NonNullable<CommonSearchWithEntityContext['sort']>[number]['order'];
2038
- }[];
2039
- /**
2040
- Logical groupings of data into facets, with summaries for each facet. For example, use aggregations to allow site visitors to narrow down their search results by selecting specific categories.
2041
- @maxSize: 10
2042
- */
2043
- aggregations?: {
2044
- /**
2045
- A value aggregation calculates metrics such as count for specific fields within a dataset, providing insights into the overall distribution and key statistics of those values. For example, use a value aggregation to get the number (count) of products for each price listed in the store.
2046
- */
2047
- value?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['value'];
2048
- /**
2049
- A range aggregation calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. For example, use a range aggregation to compare the number of reservations made for parties of 4 or less to the number of reservations made for parties with 5 or more.
2050
- */
2051
- range?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['range'];
2052
- /**
2053
- A scalar aggregation calculates a single numerical value from a dataset, summarizing the dataset into one key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`.
2054
- */
2055
- scalar?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['scalar'];
2056
- /**
2057
- A date histogram calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.) For example, use a date histogram to find how many reservations have been made at a restaurant each week.
2058
- */
2059
- dateHistogram?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['dateHistogram'];
2060
- /**
2061
- A nested aggregation is applied within the results of another aggregation. Rather than aggregating directly on the primary dataset, first group data using one aggregation and then apply another aggregation within each group. It allows for more complex analyses where you can summarize data at different levels of detail or hierarchy. For example, to get the number of products that are in stock and out of stock for each price listed, first perform a value aggregation on `discountedPriceNumeric`, and a second value aggregation on `inStock`.
2062
- */
2063
- nested?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['nested'];
2064
- /**
2065
- Aggregation name, returned in `aggregations.results.name`.
2066
- @maxLength: 100
2067
- */
2068
- name?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['name'] | null;
2069
- /**
2070
- Type of aggregation to perform. Must align with the corresponding aggregation field.
2071
- */
2072
- type?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['type'];
2073
- /**
2074
- Field to aggregate by. Use dot notation to specify a JSON path. For example, `order.address.streetName`.
2075
- @maxLength: 200
2076
- */
2077
- fieldPath?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['fieldPath'];
2078
- /**
2079
- Deprecated. Use `nested` instead.
2080
- @deprecated: Deprecated. Use `nested` instead.,
2081
- @replacedBy: kind.nested,
2082
- @targetRemovalDate: 2024-03-30
2083
- */
2084
- groupBy?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['groupBy'];
2085
- }[];
2086
- /**
2087
- Free text to match in searchable fields.
2088
- */
2089
- search?: {
2090
- /**
2091
- Search mode. Defines the search logic for combining multiple terms in the `expression`.
2092
- */
2093
- mode?: NonNullable<CommonSearchWithEntityContext['search']>['mode'];
2094
- /**
2095
- Search term or expression.
2096
- @maxLength: 100
2097
- */
2098
- expression?: NonNullable<CommonSearchWithEntityContext['search']>['expression'] | null;
2099
- /**
2100
- Fields to search in. If the array is empty, all searchable fields are searched. Use dot notation to specify a JSON path. For example, `order.address.streetName`.
2101
- @maxLength: 200,
2102
- @maxSize: 20
2103
- */
2104
- fields?: NonNullable<CommonSearchWithEntityContext['search']>['fields'];
2105
- /**
2106
- Whether to enable the search function to use an algorithm to automatically find results that are close to the search expression, such as typos and declensions.
2107
- */
2108
- fuzzy?: NonNullable<CommonSearchWithEntityContext['search']>['fuzzy'];
2109
- };
2110
- /**
2111
- Time zone to adjust date-time-based filters and aggregations, in ISO 8601 (including offsets) or IANA time zone database (including time zone IDs) format.
2112
- Applies to all relevant filters and aggregations, unless overridden by providing timestamps including time zone. For example, "2023-12-20T10:52:34.795Z".
2113
- @maxLength: 50
2114
- */
2115
- timeZone?: CommonSearchWithEntityContext['timeZone'] | null;
2116
- };
2117
- /**
2118
- * Bulk invites participants to program.
2119
- * For each member participant in Invited state is created.
2120
- * @param programId - Program to which bulk invite participants.
2121
- * @public
2122
- * @documentationMaturity preview
2123
- * @requiredField programId
2124
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_INVITE
2125
- * @applicableIdentity APP
2126
- * @fqn wix.onlineprograms.participants.v3.ManageParticipantsService.BulkInviteToProgram
2127
- */
2128
- declare function bulkInviteToProgram(programId: string, options?: BulkInviteToProgramOptions): Promise<NonNullablePaths<BulkInviteToProgramResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.memberId` | `results.${number}.item.programId` | `results.${number}.item.progress.totalStepsCompleted` | `results.${number}.item.progress.totalStepsAvailable` | `results.${number}.item.progress.completionPercentage` | `results.${number}.item.status` | `results.${number}.item.joinedInfo.timeZone` | `results.${number}.item.joinedInfo.startDate` | `results.${number}.item.joinedInfo.joinPath` | `results.${number}.item.member.contactId` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
2129
- interface BulkInviteToProgramOptions {
2130
- /**
2131
- * Return added participants in the response or not.
2132
- * @format GUID
2133
- * @minSize 1
2134
- * @maxSize 100
2135
- */
2136
- memberIds?: string[];
2137
- /** Return invited participants in the response or not. */
2138
- returnEntity?: boolean;
2139
- }
2140
- /**
2141
- * Bulk invites all participants to program, but not more then 1000.
2142
- * For each member participant in Invited state is created.
2143
- * @param programId - Program to which bulk add participants.
2144
- * @public
2145
- * @documentationMaturity preview
2146
- * @requiredField programId
2147
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_INVITE
2148
- * @applicableIdentity APP
2149
- * @fqn wix.onlineprograms.participants.v3.ManageParticipantsService.BulkInviteAllToProgram
2150
- */
2151
- declare function bulkInviteAllToProgram(programId: string, options?: BulkInviteAllToProgramOptions): Promise<NonNullablePaths<BulkInviteAllToProgramResponse, `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 3>>;
2152
- interface BulkInviteAllToProgramOptions {
2153
- /**
2154
- * Exclude site members.
2155
- * @format GUID
2156
- * @maxSize 100
2157
- */
2158
- excludeMemberIds?: string[];
2159
- }
2160
- /**
2161
- * Bulk adds participants to program.
2162
- * Participant will be either created in state Joined, or updated to that state
2163
- * from pending one.
2164
- * @param programId - Program to which bulk add participants.
2165
- * @public
2166
- * @documentationMaturity preview
2167
- * @requiredField programId
2168
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_ADD
2169
- * @applicableIdentity APP
2170
- * @fqn wix.onlineprograms.participants.v3.ManageParticipantsService.BulkAddToProgram
2171
- */
2172
- declare function bulkAddToProgram(programId: string, options?: BulkAddToProgramOptions): Promise<NonNullablePaths<BulkAddToProgramResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.memberId` | `results.${number}.item.programId` | `results.${number}.item.progress.totalStepsCompleted` | `results.${number}.item.progress.totalStepsAvailable` | `results.${number}.item.progress.completionPercentage` | `results.${number}.item.status` | `results.${number}.item.joinedInfo.timeZone` | `results.${number}.item.joinedInfo.startDate` | `results.${number}.item.joinedInfo.joinPath` | `results.${number}.item.member.contactId` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
2173
- interface BulkAddToProgramOptions {
2174
- /**
2175
- * Site members.
2176
- * @format GUID
2177
- * @minSize 1
2178
- * @maxSize 1000
2179
- */
2180
- memberIds?: string[];
2181
- /** Return added participants in the response or not. */
2182
- returnEntity?: boolean;
2183
- }
2184
- /**
2185
- * Bulk approves participants, who asked to join private program (aka in
2186
- * state `APPROVAL_PENDING`). If participant was in other state, no effect and
2187
- * error returned.
2188
- * @param participantIds - Participants to add
2189
- * @public
2190
- * @documentationMaturity preview
2191
- * @requiredField participantIds
2192
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_APPROVE
2193
- * @fqn wix.onlineprograms.participants.v3.ManageParticipantsService.BulkApproveParticipant
2194
- */
2195
- declare function bulkApproveParticipant(participantIds: string[], options?: BulkApproveParticipantOptions): Promise<NonNullablePaths<BulkApproveParticipantResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.memberId` | `results.${number}.item.programId` | `results.${number}.item.progress.totalStepsCompleted` | `results.${number}.item.progress.totalStepsAvailable` | `results.${number}.item.progress.completionPercentage` | `results.${number}.item.status` | `results.${number}.item.joinedInfo.timeZone` | `results.${number}.item.joinedInfo.startDate` | `results.${number}.item.joinedInfo.joinPath` | `results.${number}.item.member.contactId` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
2196
- interface BulkApproveParticipantOptions {
2197
- /**
2198
- * program to approve participant
2199
- * @format GUID
2200
- */
2201
- programId?: string;
2202
- /** Return approved participants in the response or not */
2203
- returnEntity?: boolean;
2204
- }
2205
- /**
2206
- * Bulk approves all pending participants, who asked to join private program (aka
2207
- * in state `APPROVAL_PENDING`).
2208
- * @public
2209
- * @documentationMaturity preview
2210
- * @permissionId ONLINE_PROGRAMS.PARTICIPANT_APPROVE
2211
- * @fqn wix.onlineprograms.participants.v3.ManageParticipantsService.BulkApproveAllParticipant
2212
- */
2213
- declare function bulkApproveAllParticipant(options?: BulkApproveAllParticipantOptions): Promise<NonNullablePaths<BulkApproveAllParticipantResponse, `jobId`, 2>>;
2214
- interface BulkApproveAllParticipantOptions {
2215
- /**
2216
- * Program to approve all participants.
2217
- * @format GUID
2218
- */
2219
- programId?: string;
2220
- /**
2221
- * Exclude site members.
2222
- * @format GUID
2223
- * @maxSize 100
2224
- */
2225
- excludeParticipantIds?: string[];
2226
- }
2227
- /**
2228
- * Exports data about participants as well as resolved steps in program.
2229
- * @param programId - program id to export data from
2230
- * @internal
2231
- * @documentationMaturity preview
2232
- * @requiredField programId
2233
- * @permissionId ONLINE_PROGRAMS.EXPORT_PARTICIPANTS_STATS
2234
- * @fqn wix.onlineprograms.participants.v3.ParticipantExportsService.ExportParticipantsStats
2235
- */
2236
- declare function exportParticipantsStats(programId: string): Promise<void>;
2237
-
2238
- export { type Certificate as $, type ParticipantQuery as A, type BulkCreateParticipantOptions as B, type CreateParticipantApplicationErrors as C, typedQueryParticipants as D, Status as E, SortOrder as F, type GetCompletionStatsResponse as G, SortType as H, type IssueCertificateResponse as I, JoinPath as J, SortDirection as K, ScalarType as L, MissingValues as M, NestedAggregationType as N, Interval as O, type Participant as P, AggregationType as Q, Mode as R, type SearchParticipantsResponse as S, BenefitType as T, Event as U, State as V, WebhookIdentityType as W, type SinglePaymentDetails as X, type PaidPlanDetails as Y, type FreeCouponDetails as Z, type Progress as _, type BulkCreateParticipantResponse as a, type RangeResult as a$, type JoinedInfo as a0, type JoinedInfoJoinPathDetailsOneOf as a1, type Member as a2, type ExtendedFields as a3, type Tags as a4, type TagList as a5, type ParticipantAdded as a6, type TagsModified as a7, type CreateParticipantRequest as a8, type CreateParticipantResponse as a9, type CursorSearch as aA, type CursorSearchPagingMethodOneOf as aB, type Aggregation as aC, type AggregationKindOneOf as aD, type RangeBucket as aE, type IncludeMissingValuesOptions as aF, type ValueAggregation as aG, type ValueAggregationOptionsOneOf as aH, type RangeAggregation as aI, type ScalarAggregation as aJ, type DateHistogramAggregation as aK, type NestedAggregationItem as aL, type NestedAggregationItemKindOneOf as aM, type NestedAggregation as aN, type GroupByAggregation as aO, type GroupByAggregationKindOneOf as aP, type SearchDetails as aQ, type AggregationData as aR, type ValueAggregationResult as aS, type RangeAggregationResult as aT, type NestedAggregationResults as aU, type NestedAggregationResultsResultOneOf as aV, type ValueResults as aW, type RangeResults as aX, type AggregationResultsScalarResult as aY, type NestedValueAggregationResult as aZ, type ValueResult as a_, type BulkCreateParticipantRequest as aa, type BulkParticipantResult as ab, type CommonItemMetadata as ac, type ApplicationError as ad, type CommonBulkActionMetadata as ae, type BulkAddAllToProgramRequest as af, type DeleteParticipantRequest as ag, type DeleteParticipantResponse as ah, type IssueCertificateRequest as ai, type GetCompletionStatsRequest as aj, type GetPremiumStatsRequest as ak, type GetParticipantRequest as al, type GetParticipantResponse as am, type QueryParticipantsRequest as an, type CursorQuery as ao, type CursorQueryPagingMethodOneOf as ap, type Sorting as aq, type CursorPaging as ar, type QueryParticipantsResponse as as, type CursorPagingMetadata as at, type Cursors as au, type GetAccessStatusRequest as av, type BulkUpdateParticipantTagsRequest as aw, type BulkUpdateParticipantTagsResult as ax, type BulkUpdateParticipantTagsByFilterRequest as ay, type SearchParticipantsRequest as az, type BulkAddAllToProgramOptions as b, type CommonQueryWithEntityContext as b$, type ScalarResult as b0, type NestedResultValue as b1, type NestedResultValueResultOneOf as b2, type Results as b3, type DateHistogramResult as b4, type GroupByValueResults as b5, type DateHistogramResults as b6, type NestedResults as b7, type AggregationResults as b8, type AggregationResultsResultOneOf as b9, type BulkApproveParticipantRequest as bA, type BulkApproveParticipantResult as bB, type ParticipantApproved as bC, type BulkApproveAllParticipantRequest as bD, type ExportParticipantsStatsRequest as bE, type ExportParticipantsStatsResponse as bF, type ParticipantExportsFinished as bG, type BaseEventMetadata as bH, type EventMetadata as bI, type ParticipantsQueryResult as bJ, type ParticipantQuerySpec as bK, type ParticipantSearchSpec as bL, type JoinPathWithLiterals as bM, type StatusWithLiterals as bN, type SortOrderWithLiterals as bO, type SortTypeWithLiterals as bP, type SortDirectionWithLiterals as bQ, type MissingValuesWithLiterals as bR, type ScalarTypeWithLiterals as bS, type NestedAggregationTypeWithLiterals as bT, type IntervalWithLiterals as bU, type AggregationTypeWithLiterals as bV, type ModeWithLiterals as bW, type BenefitTypeWithLiterals as bX, type EventWithLiterals as bY, type WebhookIdentityTypeWithLiterals as bZ, type StateWithLiterals as b_, type DomainEvent as ba, type DomainEventBodyOneOf as bb, type EntityCreatedEvent as bc, type RestoreInfo as bd, type EntityUpdatedEvent as be, type EntityDeletedEvent as bf, type ActionEvent as bg, type Empty as bh, type BenefitNotification as bi, type Benefit as bj, type EntryPass as bk, type Discount as bl, type DiscountDiscountOneOf as bm, type Behavior as bn, type BehaviorBehaviorOneOf as bo, type MessageEnvelope as bp, type IdentificationData as bq, type IdentificationDataIdOneOf as br, type BulkInviteToProgramRequest as bs, type ItemMetadata as bt, type BulkInviteToProgramResult as bu, type BulkActionMetadata as bv, type ParticipantInvited as bw, type BulkInviteAllToProgramRequest as bx, type BulkAddToProgramRequest as by, type BulkAddToProgramResult as bz, type BulkAddAllToProgramResponse as c, type CommonSearchWithEntityContext as c0, onParticipantAdded as c1, onParticipantApproved as c2, onParticipantInvited as c3, createParticipant as c4, bulkCreateParticipant as c5, bulkAddAllToProgram as c6, deleteParticipant as c7, issueCertificate as c8, getCompletionStats as c9, getPremiumStats as ca, getParticipant as cb, queryParticipants as cc, getAccessStatus as cd, bulkUpdateParticipantTags as ce, bulkUpdateParticipantTagsByFilter as cf, bulkInviteToProgram as cg, bulkInviteAllToProgram as ch, bulkAddToProgram as ci, bulkApproveParticipant as cj, bulkApproveAllParticipant as ck, exportParticipantsStats as cl, type GetPremiumStatsResponse as d, type GetAccessStatusResponse as e, type BulkUpdateParticipantTagsOptions as f, type BulkUpdateParticipantTagsResponse as g, type BulkUpdateParticipantTagsApplicationErrors as h, type BulkUpdateParticipantTagsByFilterOptions as i, type BulkUpdateParticipantTagsByFilterResponse as j, type BulkUpdateParticipantTagsByFilterApplicationErrors as k, type ParticipantSearch as l, type BulkInviteToProgramOptions as m, type BulkInviteToProgramResponse as n, type BulkInviteAllToProgramOptions as o, type BulkInviteAllToProgramResponse as p, type BulkAddToProgramOptions as q, type BulkAddToProgramResponse as r, type BulkApproveParticipantOptions as s, type BulkApproveParticipantResponse as t, type BulkApproveAllParticipantOptions as u, type BulkApproveAllParticipantResponse as v, type ParticipantAddedEnvelope as w, type ParticipantApprovedEnvelope as x, type ParticipantInvitedEnvelope as y, type ParticipantsQueryBuilder as z };