@wix/auto_sdk_benefit-programs_pools 1.0.1 → 1.0.2

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 (21) hide show
  1. package/build/cjs/src/benefit-programs-v1-pool-pools.types.d.ts +442 -99
  2. package/build/cjs/src/benefit-programs-v1-pool-pools.types.js.map +1 -1
  3. package/build/cjs/src/benefit-programs-v1-pool-pools.universal.d.ts +486 -103
  4. package/build/cjs/src/benefit-programs-v1-pool-pools.universal.js +6 -0
  5. package/build/cjs/src/benefit-programs-v1-pool-pools.universal.js.map +1 -1
  6. package/build/es/src/benefit-programs-v1-pool-pools.types.d.ts +442 -99
  7. package/build/es/src/benefit-programs-v1-pool-pools.types.js.map +1 -1
  8. package/build/es/src/benefit-programs-v1-pool-pools.universal.d.ts +486 -103
  9. package/build/es/src/benefit-programs-v1-pool-pools.universal.js +6 -0
  10. package/build/es/src/benefit-programs-v1-pool-pools.universal.js.map +1 -1
  11. package/build/internal/cjs/src/benefit-programs-v1-pool-pools.types.d.ts +442 -99
  12. package/build/internal/cjs/src/benefit-programs-v1-pool-pools.types.js.map +1 -1
  13. package/build/internal/cjs/src/benefit-programs-v1-pool-pools.universal.d.ts +486 -103
  14. package/build/internal/cjs/src/benefit-programs-v1-pool-pools.universal.js +6 -0
  15. package/build/internal/cjs/src/benefit-programs-v1-pool-pools.universal.js.map +1 -1
  16. package/build/internal/es/src/benefit-programs-v1-pool-pools.types.d.ts +442 -99
  17. package/build/internal/es/src/benefit-programs-v1-pool-pools.types.js.map +1 -1
  18. package/build/internal/es/src/benefit-programs-v1-pool-pools.universal.d.ts +486 -103
  19. package/build/internal/es/src/benefit-programs-v1-pool-pools.universal.js +6 -0
  20. package/build/internal/es/src/benefit-programs-v1-pool-pools.universal.js.map +1 -1
  21. package/package.json +2 -2
@@ -1,6 +1,7 @@
1
1
  export interface Pool {
2
2
  /**
3
3
  * Pool ID.
4
+ * @format GUID
4
5
  * @readonly
5
6
  */
6
7
  id?: string | null;
@@ -24,16 +25,19 @@ export interface Pool {
24
25
  updatedDate?: Date | null;
25
26
  /**
26
27
  * Pool definition from which this benefit pool was created.
28
+ * @format GUID
27
29
  * @readonly
28
30
  */
29
31
  poolDefinitionId?: string | null;
30
32
  /**
31
33
  * Program definition from which this benefit pool was provisioned.
34
+ * @format GUID
32
35
  * @readonly
33
36
  */
34
37
  programDefinitionId?: string | null;
35
38
  /**
36
39
  * ID of the program to which this benefit pool is associated.
40
+ * @format GUID
37
41
  * @readonly
38
42
  */
39
43
  programId?: string | null;
@@ -54,9 +58,15 @@ export interface Pool {
54
58
  * Pool name.
55
59
  *
56
60
  * It's recommended to keep the same as the associated pool definition's `displayName`.
61
+ * @maxLength 64
57
62
  */
58
63
  displayName?: string;
59
- /** External system that is the source of the program creation. For example, `wix-pricing-plans`, `wix-loyalty`. */
64
+ /**
65
+ * External system that is the source of the program creation. For example, `wix-pricing-plans`, `wix-loyalty`.
66
+ * @immutable
67
+ * @minLength 1
68
+ * @maxLength 50
69
+ */
60
70
  namespace?: string | null;
61
71
  /**
62
72
  * Custom field data for the pool object.
@@ -108,20 +118,38 @@ export declare enum PoolStatus {
108
118
  RENEWING = "RENEWING"
109
119
  }
110
120
  export interface CommonIdentificationData extends CommonIdentificationDataIdOneOf {
111
- /** ID of a site visitor that has not logged in to the site. */
121
+ /**
122
+ * ID of a site visitor that has not logged in to the site.
123
+ * @format GUID
124
+ */
112
125
  anonymousVisitorId?: string;
113
- /** ID of a site visitor that has logged in to the site. */
126
+ /**
127
+ * ID of a site visitor that has logged in to the site.
128
+ * @format GUID
129
+ */
114
130
  memberId?: string;
115
- /** ID of a Wix user (site owner, contributor, etc.). */
131
+ /**
132
+ * ID of a Wix user (site owner, contributor, etc.).
133
+ * @format GUID
134
+ */
116
135
  wixUserId?: string;
117
136
  }
118
137
  /** @oneof */
119
138
  export interface CommonIdentificationDataIdOneOf {
120
- /** ID of a site visitor that has not logged in to the site. */
139
+ /**
140
+ * ID of a site visitor that has not logged in to the site.
141
+ * @format GUID
142
+ */
121
143
  anonymousVisitorId?: string;
122
- /** ID of a site visitor that has logged in to the site. */
144
+ /**
145
+ * ID of a site visitor that has logged in to the site.
146
+ * @format GUID
147
+ */
123
148
  memberId?: string;
124
- /** ID of a Wix user (site owner, contributor, etc.). */
149
+ /**
150
+ * ID of a Wix user (site owner, contributor, etc.).
151
+ * @format GUID
152
+ */
125
153
  wixUserId?: string;
126
154
  }
127
155
  export declare enum IdentityType {
@@ -135,7 +163,10 @@ export declare enum IdentityType {
135
163
  WIX_USER = "WIX_USER"
136
164
  }
137
165
  export interface Details {
138
- /** Array of benefits, each containing price and policy settings specific to that benefit within the pool. */
166
+ /**
167
+ * Array of benefits, each containing price and policy settings specific to that benefit within the pool.
168
+ * @maxSize 10
169
+ */
139
170
  benefits?: Benefit[];
140
171
  /**
141
172
  * Settings that control the initial credits and renewal cycle configurations of the benefit pool.
@@ -165,6 +196,7 @@ export interface Benefit {
165
196
  * An unique identifier for a pool benefit.
166
197
  *
167
198
  * This key is consistent across the pool definition and all its associated benefit pools.
199
+ * @maxLength 64
168
200
  */
169
201
  benefitKey?: string;
170
202
  /**
@@ -173,6 +205,8 @@ export interface Benefit {
173
205
  * This ID is returned when calling Create Item.
174
206
  *
175
207
  * It is used to link the specific benefit item to its corresponding location within the benefit pool, ensuring proper association between the item and the pool definition.
208
+ * @format GUID
209
+ * @immutable
176
210
  * @readonly
177
211
  */
178
212
  itemSetId?: string | null;
@@ -181,6 +215,7 @@ export interface Benefit {
181
215
  * Represents the cost to redeem the benefit.
182
216
  *
183
217
  * Don't set a price if the `details.creditConfiguration` is empty. Since the benefits have an unlimited redemption limit, they can't have an associated price.
218
+ * @decimalValue options { gte:0, maxScale:4 }
184
219
  */
185
220
  price?: string | null;
186
221
  /**
@@ -191,11 +226,21 @@ export interface Benefit {
191
226
  policyExpression?: PolicyExpression;
192
227
  /** Additional info that was set by the benefit provider. */
193
228
  additionalData?: Record<string, any> | null;
194
- /** ID of the app providing the benefit. */
229
+ /**
230
+ * ID of the app providing the benefit.
231
+ * @format GUID
232
+ * @immutable
233
+ */
195
234
  providerAppId?: string | null;
196
- /** Benefit display name. */
235
+ /**
236
+ * Benefit display name.
237
+ * @maxLength 40
238
+ */
197
239
  displayName?: string | null;
198
- /** Benefit description. */
240
+ /**
241
+ * Benefit description.
242
+ * @maxLength 255
243
+ */
199
244
  description?: string | null;
200
245
  }
201
246
  export interface PolicyExpression extends PolicyExpressionExpressionOneOf {
@@ -241,11 +286,19 @@ export interface PolicyExpressionNot {
241
286
  expression?: PolicyExpression;
242
287
  }
243
288
  export interface PolicyExpressionAnd {
244
- /** Specify policy terms where all policy conditions must be met. Must specify an object with an `expressions` property. */
289
+ /**
290
+ * Specify policy terms where all policy conditions must be met. Must specify an object with an `expressions` property.
291
+ * @minSize 2
292
+ * @maxSize 10
293
+ */
245
294
  expressions?: PolicyExpression[];
246
295
  }
247
296
  export interface PolicyExpressionOr {
248
- /** Specify policy terms where at least one of the possible specified policy conditions is met. Must specify an object with an `expressions` property. */
297
+ /**
298
+ * Specify policy terms where at least one of the possible specified policy conditions is met. Must specify an object with an `expressions` property.
299
+ * @minSize 2
300
+ * @maxSize 10
301
+ */
249
302
  expressions?: PolicyExpression[];
250
303
  }
251
304
  export interface Policy extends PolicyPolicyOneOf {
@@ -281,13 +334,25 @@ export interface FixedIntervalPolicy {
281
334
  fromWeekDay?: WeekDay;
282
335
  /** Weekday that this interval ends at. If this field is set, then `fromWeekDay` must also be set. */
283
336
  toWeekDay?: WeekDay;
284
- /** Hour that this interval starts from. If this field is set, then `toHour` must also be set. */
337
+ /**
338
+ * Hour that this interval starts from. If this field is set, then `toHour` must also be set.
339
+ * @max 23
340
+ */
285
341
  fromHour?: number | null;
286
- /** Hour that this interval ends at. If this field is set, then `fromHour` must also be set. */
342
+ /**
343
+ * Hour that this interval ends at. If this field is set, then `fromHour` must also be set.
344
+ * @max 23
345
+ */
287
346
  toHour?: number | null;
288
- /** Minute that this interval starts from. If this field is set, then `toMinute` must also be set. */
347
+ /**
348
+ * Minute that this interval starts from. If this field is set, then `toMinute` must also be set.
349
+ * @max 59
350
+ */
289
351
  fromMinute?: number | null;
290
- /** Minute that this interval ends at. If this field is set, then `fromMinute` must also be set. */
352
+ /**
353
+ * Minute that this interval ends at. If this field is set, then `fromMinute` must also be set.
354
+ * @max 59
355
+ */
291
356
  toMinute?: number | null;
292
357
  }
293
358
  export declare enum WeekDay {
@@ -339,19 +404,31 @@ export declare enum RateLimitedPolicyType {
339
404
  }
340
405
  /** Custom policy as implemented by the Entitlement Policy Provider */
341
406
  export interface CustomPolicy {
342
- /** References a specific custom policy on the provider's system */
407
+ /**
408
+ * References a specific custom policy on the provider's system
409
+ * @format GUID
410
+ */
343
411
  id?: string;
344
- /** Custom policy provider id */
412
+ /**
413
+ * Custom policy provider id
414
+ * @format GUID
415
+ */
345
416
  appId?: string | null;
346
417
  /** Additional info for this custom policy. It's going to be passed to the policy provider during eligibility checks */
347
418
  additionalData?: Record<string, any> | null;
348
419
  }
349
420
  export interface CreditConfiguration {
350
- /** The initial total amount of credits available in this benefit pool. */
421
+ /**
422
+ * The initial total amount of credits available in this benefit pool.
423
+ * @decimalValue options { gte:0, maxScale:4 }
424
+ */
351
425
  amount?: string;
352
426
  /** Rollover configuration. */
353
427
  rolloverConfiguration?: RolloverConfiguration;
354
- /** Display name of the unit. */
428
+ /**
429
+ * Display name of the unit.
430
+ * @maxLength 32
431
+ */
355
432
  unitDisplayName?: string | null;
356
433
  }
357
434
  export interface RolloverConfiguration {
@@ -361,6 +438,7 @@ export interface RolloverConfiguration {
361
438
  * The maximum amount of credits that can be transferred to the next benefit renewal cycle.
362
439
  *
363
440
  * If current balance exceeds this cap, no credits will transfer into the next renewal cycle until the balance is within the allowable limit.
441
+ * @decimalValue options { gte:0, maxScale:4 }
364
442
  */
365
443
  balanceCap?: string | null;
366
444
  }
@@ -378,6 +456,7 @@ export interface ExtendedFields {
378
456
  export interface ProgramDefinitionInfo {
379
457
  /**
380
458
  * ID of the program definition that provisioned the program associated with this benefit pool.
459
+ * @format GUID
381
460
  * @readonly
382
461
  */
383
462
  id?: string;
@@ -385,6 +464,7 @@ export interface ProgramDefinitionInfo {
385
464
  * External ID of the program definition that provisioned this program.
386
465
  *
387
466
  * This identifies the source program definition in the external system.
467
+ * @format GUID
388
468
  * @readonly
389
469
  */
390
470
  externalId?: string | null;
@@ -392,6 +472,7 @@ export interface ProgramDefinitionInfo {
392
472
  export interface ProgramInfo {
393
473
  /**
394
474
  * ID of the program associated with this benefit pool.
475
+ * @format GUID
395
476
  * @readonly
396
477
  */
397
478
  id?: string;
@@ -399,6 +480,7 @@ export interface ProgramInfo {
399
480
  * External ID of the program associated with this benefit pool.
400
481
  *
401
482
  * This identifies the source program in the external system.
483
+ * @format GUID
402
484
  * @readonly
403
485
  */
404
486
  externalId?: string | null;
@@ -426,18 +508,27 @@ export interface BenefitRedeemed {
426
508
  redemptionDetails?: RedemptionDetails;
427
509
  }
428
510
  export interface RedemptionDetails {
429
- /** Id of the redemption transaction */
511
+ /**
512
+ * Id of the redemption transaction
513
+ * @format GUID
514
+ */
430
515
  transactionId?: string;
431
516
  /** Reference of the item that is being redeemed */
432
517
  itemReference?: ItemReference;
433
- /** Number of of items to redeem */
518
+ /**
519
+ * Number of of items to redeem
520
+ * @min 1
521
+ */
434
522
  itemCount?: number;
435
523
  /**
436
524
  * Date at which the item will be used. Target date does not necessarily equal the redemption date. Credits are redeemed immediately.
437
525
  * This date is only used for validations that may be performed by entitlement providers
438
526
  */
439
527
  targetDate?: Date | null;
440
- /** Idempotency key */
528
+ /**
529
+ * Idempotency key
530
+ * @maxLength 200
531
+ */
441
532
  idempotencyKey?: string;
442
533
  /** Additional info provided during redemption */
443
534
  additionalData?: Record<string, any> | null;
@@ -445,11 +536,20 @@ export interface RedemptionDetails {
445
536
  beneficiary?: CommonIdentificationData;
446
537
  }
447
538
  export interface ItemReference {
448
- /** External ID of the item. */
539
+ /**
540
+ * External ID of the item.
541
+ * @format GUID
542
+ */
449
543
  externalId?: string;
450
- /** Item category. */
544
+ /**
545
+ * Item category.
546
+ * @maxLength 20
547
+ */
451
548
  category?: string;
452
- /** ID of the application providing the benefits. */
549
+ /**
550
+ * ID of the application providing the benefits.
551
+ * @format GUID
552
+ */
453
553
  providerAppId?: string;
454
554
  }
455
555
  export interface PoolPaused {
@@ -473,13 +573,19 @@ export interface BenefitReserved {
473
573
  export interface BenefitReservationCanceled {
474
574
  /** Pool which was used to perform this transaction */
475
575
  pool?: Pool;
476
- /** Id of the canceled reservation transaction */
576
+ /**
577
+ * Id of the canceled reservation transaction
578
+ * @format GUID
579
+ */
477
580
  transactionId?: string;
478
581
  }
479
582
  export interface BenefitReservationReleased {
480
583
  /** Pool which was used to perform this transaction */
481
584
  pool?: Pool;
482
- /** Id of the released reservation transaction */
585
+ /**
586
+ * Id of the released reservation transaction
587
+ * @format GUID
588
+ */
483
589
  transactionId?: string;
484
590
  }
485
591
  export interface CreatePoolRequest {
@@ -491,7 +597,10 @@ export interface CreatePoolResponse {
491
597
  pool?: Pool;
492
598
  }
493
599
  export interface GetPoolRequest {
494
- /** ID of the pool to retrieve. */
600
+ /**
601
+ * ID of the pool to retrieve.
602
+ * @format GUID
603
+ */
495
604
  poolId: string;
496
605
  }
497
606
  export interface GetPoolResponse {
@@ -507,7 +616,10 @@ export interface UpdatePoolResponse {
507
616
  pool?: Pool;
508
617
  }
509
618
  export interface DeletePoolRequest {
510
- /** ID of the pool to delete. */
619
+ /**
620
+ * ID of the pool to delete.
621
+ * @format GUID
622
+ */
511
623
  poolId?: string;
512
624
  }
513
625
  export interface DeletePoolResponse {
@@ -531,6 +643,7 @@ export interface CursorQuery extends CursorQueryPagingMethodOneOf {
531
643
  /**
532
644
  * Sort object in the following format:
533
645
  * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
646
+ * @maxSize 5
534
647
  */
535
648
  sort?: Sorting[];
536
649
  }
@@ -540,7 +653,10 @@ export interface CursorQueryPagingMethodOneOf {
540
653
  cursorPaging?: CursorPaging;
541
654
  }
542
655
  export interface Sorting {
543
- /** Name of the field to sort by. */
656
+ /**
657
+ * Name of the field to sort by.
658
+ * @maxLength 512
659
+ */
544
660
  fieldName?: string;
545
661
  /** Sort order. */
546
662
  order?: SortOrder;
@@ -552,13 +668,17 @@ export declare enum SortOrder {
552
668
  DESC = "DESC"
553
669
  }
554
670
  export interface CursorPaging {
555
- /** Maximum number of items to return in the results. */
671
+ /**
672
+ * Maximum number of items to return in the results.
673
+ * @max 100
674
+ */
556
675
  limit?: number | null;
557
676
  /**
558
677
  * Pointer to the next or previous page in the list of results.
559
678
  *
560
679
  * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
561
680
  * Not relevant for the first request.
681
+ * @maxLength 16000
562
682
  */
563
683
  cursor?: string | null;
564
684
  }
@@ -582,13 +702,22 @@ export interface CursorPagingMetadata {
582
702
  hasNext?: boolean | null;
583
703
  }
584
704
  export interface Cursors {
585
- /** Cursor string pointing to the next page in the list of results. */
705
+ /**
706
+ * Cursor string pointing to the next page in the list of results.
707
+ * @maxLength 16000
708
+ */
586
709
  next?: string | null;
587
- /** Cursor pointing to the previous page in the list of results. */
710
+ /**
711
+ * Cursor pointing to the previous page in the list of results.
712
+ * @maxLength 16000
713
+ */
588
714
  prev?: string | null;
589
715
  }
590
716
  export interface RedeemBenefitRequest {
591
- /** ID of the benefit pool being redeemed. */
717
+ /**
718
+ * ID of the benefit pool being redeemed.
719
+ * @format GUID
720
+ */
592
721
  poolId: string;
593
722
  /** Reference of the benefit item that is being redeemed. */
594
723
  itemReference: ItemReference;
@@ -596,9 +725,13 @@ export interface RedeemBenefitRequest {
596
725
  * Key of the specific benefit to be redeemed.
597
726
  *
598
727
  * This needs to be specified to ensure the correct benefit is redeemed.
728
+ * @maxLength 64
599
729
  */
600
730
  benefitKey: string;
601
- /** Number of of items to redeem. */
731
+ /**
732
+ * Number of of items to redeem.
733
+ * @min 1
734
+ */
602
735
  count?: number;
603
736
  /**
604
737
  * Date when the benefit item will be used.
@@ -611,6 +744,7 @@ export interface RedeemBenefitRequest {
611
744
  /**
612
745
  * Unique identifier, generated by the client.
613
746
  * Used to recognize repeated attempts to make the same request.
747
+ * @maxLength 200
614
748
  */
615
749
  idempotencyKey: string;
616
750
  /** Additional information. */
@@ -621,67 +755,121 @@ export interface RedeemBenefitRequest {
621
755
  * Module that is the source of the benefit pool creation.
622
756
  *
623
757
  * Must match the previously defined namespace in the associated pool definition.
758
+ * @minLength 1
759
+ * @maxLength 50
624
760
  */
625
761
  namespace: string;
626
762
  }
627
763
  export interface RedeemBenefitResponse {
628
- /** Id of the resulting transaction. */
764
+ /**
765
+ * Id of the resulting transaction.
766
+ * @format GUID
767
+ */
629
768
  transactionId?: string;
630
769
  }
631
770
  export interface NotEnoughBalance {
632
- /** Pool ID */
771
+ /**
772
+ * Pool ID
773
+ * @format GUID
774
+ */
633
775
  poolId?: string;
634
776
  /** Item reference */
635
777
  itemReference?: ItemReference;
636
- /** Price of the item expressed in credits */
778
+ /**
779
+ * Price of the item expressed in credits
780
+ * @decimalValue options { maxScale:4 }
781
+ */
637
782
  availableBalance?: string;
638
- /** Price of the item expressed in credits */
783
+ /**
784
+ * Price of the item expressed in credits
785
+ * @decimalValue options { maxScale:4 }
786
+ */
639
787
  requestedBalance?: string;
640
788
  }
641
789
  export interface PolicyExpressionEvaluatedToFalse {
642
- /** Pool ID */
790
+ /**
791
+ * Pool ID
792
+ * @format GUID
793
+ */
643
794
  poolId?: string;
644
795
  /** Item reference */
645
796
  itemReference?: ItemReference;
646
- /** Failure details */
797
+ /**
798
+ * Failure details
799
+ * @maxSize 10
800
+ */
647
801
  failureDetails?: FailureDetails[];
648
802
  }
649
803
  export interface FailureDetails {
650
- /** Failure code */
804
+ /**
805
+ * Failure code
806
+ * @minLength 1
807
+ * @maxLength 64
808
+ */
651
809
  code?: string;
652
- /** Failure message */
810
+ /**
811
+ * Failure message
812
+ * @maxLength 256
813
+ */
653
814
  message?: string | null;
654
- /** Policy id */
815
+ /**
816
+ * Policy id
817
+ * @format GUID
818
+ */
655
819
  policyId?: string | null;
656
- /** App that owns the policy */
820
+ /**
821
+ * App that owns the policy
822
+ * @format GUID
823
+ */
657
824
  appId?: string | null;
658
825
  /** Information provided by the policy */
659
826
  errorData?: Record<string, any> | null;
660
827
  }
661
828
  export interface PoolNotActive {
662
- /** Pool ID */
829
+ /**
830
+ * Pool ID
831
+ * @format GUID
832
+ */
663
833
  poolId?: string;
664
834
  /** Pool status */
665
835
  poolStatus?: PoolStatus;
666
836
  }
667
837
  export interface PoolNotFound {
668
- /** Pool ID */
838
+ /**
839
+ * Pool ID
840
+ * @format GUID
841
+ */
669
842
  poolId?: string;
670
843
  }
671
844
  export interface BenefitAlreadyRedeemed {
672
- /** Pool ID */
845
+ /**
846
+ * Pool ID
847
+ * @format GUID
848
+ */
673
849
  poolId?: string;
674
- /** Idempotency key of the request that failed */
850
+ /**
851
+ * Idempotency key of the request that failed
852
+ * @maxLength 200
853
+ */
675
854
  idempotencyKey?: string;
676
855
  }
677
856
  export interface BenefitNotFound {
678
- /** Pool ID */
857
+ /**
858
+ * Pool ID
859
+ * @format GUID
860
+ */
679
861
  poolId?: string;
680
- /** Key of the referenced benefit, if provided */
862
+ /**
863
+ * Key of the referenced benefit, if provided
864
+ * @format GUID
865
+ */
681
866
  benefitKey?: string | null;
682
867
  }
683
868
  export interface ReserveBenefitRequest {
684
- /** Id of the pool that is being redeemed from */
869
+ /**
870
+ * Id of the pool that is being redeemed from
871
+ * @format GUID
872
+ */
685
873
  poolId?: string;
686
874
  /** Reference of the item that is being redeemed. */
687
875
  itemReference?: ItemReference;
@@ -691,9 +879,13 @@ export interface ReserveBenefitRequest {
691
879
  * This key must be specified to ensure the correct benefit is redeemed.
692
880
  *
693
881
  * Default: The first eligible benefit in the benefit pool will be redeemed.
882
+ * @maxLength 64
694
883
  */
695
884
  benefitKey?: string | null;
696
- /** Number of items to redeem. */
885
+ /**
886
+ * Number of items to redeem.
887
+ * @min 1
888
+ */
697
889
  count?: number;
698
890
  /**
699
891
  * Date when the benefit item will be used.
@@ -703,7 +895,10 @@ export interface ReserveBenefitRequest {
703
895
  * Used for the app providing the benefit items to manage the logistics associated with the item.
704
896
  */
705
897
  targetDate?: Date | null;
706
- /** Idempotency key */
898
+ /**
899
+ * Idempotency key
900
+ * @maxLength 200
901
+ */
707
902
  idempotencyKey?: string;
708
903
  /** Additional info */
709
904
  additionalData?: Record<string, any> | null;
@@ -715,31 +910,51 @@ export interface ReserveBenefitRequest {
715
910
  * This value must correspond with the previously defined namespace established when creating the associated pool definition.
716
911
  *
717
912
  * It ensures efficient processing and management of pools and benefits.
913
+ * @minLength 1
914
+ * @maxLength 50
718
915
  */
719
916
  namespace?: string;
720
917
  }
721
918
  export interface ReserveBenefitResponse {
722
- /** Id of the transaction that was created as a result of this request */
919
+ /**
920
+ * Id of the transaction that was created as a result of this request
921
+ * @format GUID
922
+ */
723
923
  transactionId?: string;
724
924
  }
725
925
  export interface CancelBenefitReservationRequest {
726
- /** Id of the transaction that was created as a result of this request */
926
+ /**
927
+ * Id of the transaction that was created as a result of this request
928
+ * @format GUID
929
+ */
727
930
  transactionId?: string;
728
931
  }
729
932
  export interface CancelBenefitReservationResponse {
730
- /** Id of the transaction that was created as a result of this request */
933
+ /**
934
+ * Id of the transaction that was created as a result of this request
935
+ * @format GUID
936
+ */
731
937
  transactionId?: string;
732
938
  }
733
939
  export interface ReleaseBenefitReservationRequest {
734
- /** Id of the transaction that was created as a result of this request */
940
+ /**
941
+ * Id of the transaction that was created as a result of this request
942
+ * @format GUID
943
+ */
735
944
  transactionId?: string;
736
945
  }
737
946
  export interface ReleaseBenefitReservationResponse {
738
- /** Id of the transaction that was created as a result of this request */
947
+ /**
948
+ * Id of the transaction that was created as a result of this request
949
+ * @format GUID
950
+ */
739
951
  transactionId?: string;
740
952
  }
741
953
  export interface CheckBenefitEligibilityRequest {
742
- /** ID of the benefit pool to check eligibility against. */
954
+ /**
955
+ * ID of the benefit pool to check eligibility against.
956
+ * @format GUID
957
+ */
743
958
  poolId: string;
744
959
  /**
745
960
  * Key of the benefit to be redeemed, associated with a particular benefit.
@@ -747,6 +962,7 @@ export interface CheckBenefitEligibilityRequest {
747
962
  * This key must be specified to ensure the correct benefit is redeemed.
748
963
  *
749
964
  * Default: The first eligible benefit in the benefit pool will be redeemed.
965
+ * @maxLength 64
750
966
  */
751
967
  benefitKey?: string | null;
752
968
  /** Reference of the item for which to check benefit's eligibility. */
@@ -755,6 +971,7 @@ export interface CheckBenefitEligibilityRequest {
755
971
  * Number of items for which to check eligibility.
756
972
  *
757
973
  * This number will be evaluated against the policies and credit balance of the benefit pool to determine if sufficient funds are met for the specified number of items.
974
+ * @min 1
758
975
  */
759
976
  count?: number;
760
977
  /**
@@ -775,6 +992,8 @@ export interface CheckBenefitEligibilityRequest {
775
992
  * This value must correspond with the previously defined namespace established when creating the associated pool definition.
776
993
  *
777
994
  * It ensures efficient processing and management of pools and benefits.
995
+ * @minLength 1
996
+ * @maxLength 50
778
997
  */
779
998
  namespace: string;
780
999
  }
@@ -820,14 +1039,21 @@ export interface EligibilityCheckResultResultOneOf {
820
1039
  export interface EligibleBenefit {
821
1040
  /**
822
1041
  * Pool ID
1042
+ * @format GUID
823
1043
  * @readonly
824
1044
  */
825
1045
  poolId?: string;
826
- /** Key of the specific benefit. */
1046
+ /**
1047
+ * Key of the specific benefit.
1048
+ * @maxLength 64
1049
+ */
827
1050
  benefitKey?: string;
828
1051
  /** Item reference */
829
1052
  itemReference?: ItemReference;
830
- /** Price of the item expressed in credits */
1053
+ /**
1054
+ * Price of the item expressed in credits
1055
+ * @decimalValue options { gte:0, maxScale:4 }
1056
+ */
831
1057
  price?: string | null;
832
1058
  }
833
1059
  export declare enum EligibilityCheckResultType {
@@ -847,11 +1073,18 @@ export declare enum EligibilityCheckResultType {
847
1073
  POOL_NOT_FOUND = "POOL_NOT_FOUND"
848
1074
  }
849
1075
  export interface Eligible {
850
- /** Eligible benefits. */
1076
+ /**
1077
+ * Eligible benefits.
1078
+ * @maxSize 100
1079
+ */
851
1080
  eligibleBenefits?: EligibleBenefit[];
852
1081
  }
853
1082
  export interface BulkCheckBenefitEligibilityRequest {
854
- /** Benefits to check eligibility. */
1083
+ /**
1084
+ * Benefits to check eligibility.
1085
+ * @minSize 1
1086
+ * @maxSize 100
1087
+ */
855
1088
  benefitSelectors?: BenefitSelector[];
856
1089
  /**
857
1090
  * Module that is the source of the benefit pool creation.
@@ -859,15 +1092,23 @@ export interface BulkCheckBenefitEligibilityRequest {
859
1092
  * This value must correspond with the previously defined namespace established when creating the associated pool definition.
860
1093
  *
861
1094
  * It ensures efficient processing and management of pools and benefits.
1095
+ * @minLength 1
1096
+ * @maxLength 50
862
1097
  */
863
1098
  namespace: string;
864
1099
  /** Benefit pool owner. */
865
1100
  beneficiary?: CommonIdentificationData;
866
1101
  }
867
1102
  export interface BenefitSelector {
868
- /** ID of the pool to check for eligibility. */
1103
+ /**
1104
+ * ID of the pool to check for eligibility.
1105
+ * @format GUID
1106
+ */
869
1107
  poolId?: string;
870
- /** ID of the benefit to check for eligibility. */
1108
+ /**
1109
+ * ID of the benefit to check for eligibility.
1110
+ * @maxLength 64
1111
+ */
871
1112
  benefitKey?: string | null;
872
1113
  /** Reference of the item for which to check benefit's eligibility. */
873
1114
  itemReference?: ItemReference;
@@ -875,6 +1116,7 @@ export interface BenefitSelector {
875
1116
  * Number of items for which to check eligibility.
876
1117
  *
877
1118
  * This number will be evaluated against the policies and credit balance of the benefit pool to determine if sufficient funds are met for the specified number of items.
1119
+ * @min 1
878
1120
  */
879
1121
  count?: number;
880
1122
  /**
@@ -889,7 +1131,11 @@ export interface BenefitSelector {
889
1131
  additionalData?: Record<string, any> | null;
890
1132
  }
891
1133
  export interface BulkCheckBenefitEligibilityResponse {
892
- /** List of results for pool benefit eligibility. */
1134
+ /**
1135
+ * List of results for pool benefit eligibility.
1136
+ * @minSize 1
1137
+ * @maxSize 100
1138
+ */
893
1139
  results?: BulkEligibilityCheckResult[];
894
1140
  }
895
1141
  export interface BulkEligibilityCheckResult {
@@ -905,6 +1151,7 @@ export interface GetEligibleBenefitsRequest {
905
1151
  * Number of items for which to check eligibility.
906
1152
  *
907
1153
  * This number will be evaluated against the policies and credit balance of the benefit pool to determine if sufficient funds are met for the specified number of items.
1154
+ * @min 1
908
1155
  */
909
1156
  count?: number;
910
1157
  /**
@@ -925,6 +1172,8 @@ export interface GetEligibleBenefitsRequest {
925
1172
  * This value must correspond with the previously defined namespace established when creating the associated pool definition.
926
1173
  *
927
1174
  * It ensures efficient processing and management of pools and benefits.
1175
+ * @minLength 1
1176
+ * @maxLength 50
928
1177
  */
929
1178
  namespace: string;
930
1179
  }
@@ -943,11 +1192,17 @@ export declare enum ListPoolsRequestType {
943
1192
  BY_ITEM_REFERENCE = "BY_ITEM_REFERENCE"
944
1193
  }
945
1194
  export interface ByItemReference {
946
- /** A list of filters */
1195
+ /**
1196
+ * A list of filters
1197
+ * @maxSize 100
1198
+ */
947
1199
  filters?: ByItemReferenceFilter[];
948
1200
  /** Beneficiary of the pool */
949
1201
  beneficiary?: CommonIdentificationData;
950
- /** Returns pools that are in the following statuses */
1202
+ /**
1203
+ * Returns pools that are in the following statuses
1204
+ * @maxSize 10
1205
+ */
951
1206
  poolStatuses?: PoolStatus[];
952
1207
  }
953
1208
  export interface ByItemReferenceFilter {
@@ -965,6 +1220,7 @@ export interface Filter extends FilterFilterOneOf {
965
1220
  * This value must correspond with the previously defined namespace established when creating the associated pool definition.
966
1221
  *
967
1222
  * It ensures efficient processing and management of pools and benefits.
1223
+ * @maxLength 50
968
1224
  */
969
1225
  namespace?: string;
970
1226
  }
@@ -974,7 +1230,10 @@ export interface FilterFilterOneOf {
974
1230
  byItemReferenceOptions?: ByItemReference;
975
1231
  }
976
1232
  export interface ListPoolsResponse {
977
- /** The retrieved pools */
1233
+ /**
1234
+ * The retrieved pools
1235
+ * @maxSize 100
1236
+ */
978
1237
  pools?: PoolWithItems[];
979
1238
  /** Paging information */
980
1239
  metadata?: CursorPagingMetadata;
@@ -982,11 +1241,18 @@ export interface ListPoolsResponse {
982
1241
  export interface PoolWithItems {
983
1242
  /** The pool */
984
1243
  pool?: Pool;
985
- /** The items in the pool */
1244
+ /**
1245
+ * The items in the pool
1246
+ * @maxSize 100
1247
+ */
986
1248
  itemReference?: ItemReference[];
987
1249
  }
988
1250
  export interface BulkUpdatePoolsRequest {
989
- /** Pools to update. */
1251
+ /**
1252
+ * Pools to update.
1253
+ * @minSize 1
1254
+ * @maxSize 100
1255
+ */
990
1256
  pools?: MaskedPool[];
991
1257
  /**
992
1258
  * Whether to return the full pool definition entities.
@@ -1006,6 +1272,8 @@ export interface BulkUpdatePoolsResponse {
1006
1272
  * List of results for each pool.
1007
1273
  *
1008
1274
  * Includes the pool, pool metadata, and whether the update was successful.
1275
+ * @minSize 1
1276
+ * @maxSize 100
1009
1277
  */
1010
1278
  results?: BulkPoolResult[];
1011
1279
  /** Bulk action metadata. */
@@ -1018,7 +1286,10 @@ export interface BulkPoolResult {
1018
1286
  pool?: Pool;
1019
1287
  }
1020
1288
  export interface ItemMetadata {
1021
- /** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
1289
+ /**
1290
+ * Item ID. Should always be available, unless it's impossible (for example, when failing to create an item).
1291
+ * @format GUID
1292
+ */
1022
1293
  id?: string | null;
1023
1294
  /** Index of the item within the request array. Allows for correlation between request and response items. */
1024
1295
  originalIndex?: number;
@@ -1046,20 +1317,35 @@ export interface BulkActionMetadata {
1046
1317
  export interface ProvisionPoolsForProgramRequest {
1047
1318
  /** Reference of the template that is used to provision the pools */
1048
1319
  poolDefinitionLookupId?: PoolDefinitionLookupId;
1049
- /** Program that the provisioned pools are part of */
1320
+ /**
1321
+ * Program that the provisioned pools are part of
1322
+ * @format GUID
1323
+ */
1050
1324
  programId?: string;
1051
1325
  }
1052
1326
  export interface PoolDefinitionLookupId extends PoolDefinitionLookupIdIdOneOf {
1053
- /** Pool definition ID. */
1327
+ /**
1328
+ * Pool definition ID.
1329
+ * @format GUID
1330
+ */
1054
1331
  poolDefinitionId?: string;
1055
- /** Program definition ID. */
1332
+ /**
1333
+ * Program definition ID.
1334
+ * @format GUID
1335
+ */
1056
1336
  programDefinitionId?: string;
1057
1337
  }
1058
1338
  /** @oneof */
1059
1339
  export interface PoolDefinitionLookupIdIdOneOf {
1060
- /** Pool definition ID. */
1340
+ /**
1341
+ * Pool definition ID.
1342
+ * @format GUID
1343
+ */
1061
1344
  poolDefinitionId?: string;
1062
- /** Program definition ID. */
1345
+ /**
1346
+ * Program definition ID.
1347
+ * @format GUID
1348
+ */
1063
1349
  programDefinitionId?: string;
1064
1350
  }
1065
1351
  export interface ProvisionPoolsForProgramResponse extends ProvisionPoolsForProgramResponseResultOneOf {
@@ -1067,7 +1353,10 @@ export interface ProvisionPoolsForProgramResponse extends ProvisionPoolsForProgr
1067
1353
  syncOptions?: SyncResult;
1068
1354
  /** Async result */
1069
1355
  asyncOptions?: AsyncResult;
1070
- /** Job ID of the program provision associated with this pool. */
1356
+ /**
1357
+ * Job ID of the program provision associated with this pool.
1358
+ * @format GUID
1359
+ */
1071
1360
  jobId?: string;
1072
1361
  /** Type of the result */
1073
1362
  type?: ProvisionPoolsForProgramResponseType;
@@ -1092,7 +1381,10 @@ export interface SyncResult {
1092
1381
  success?: boolean;
1093
1382
  }
1094
1383
  export interface AsyncResult {
1095
- /** Job ID of the program provision associated with this pool. */
1384
+ /**
1385
+ * Job ID of the program provision associated with this pool.
1386
+ * @format GUID
1387
+ */
1096
1388
  jobId?: string;
1097
1389
  }
1098
1390
  export interface InvalidPoolDefinitionReference {
@@ -1100,11 +1392,17 @@ export interface InvalidPoolDefinitionReference {
1100
1392
  poolDefinitionLookupId?: PoolDefinitionLookupId;
1101
1393
  }
1102
1394
  export interface RenewPoolsForProgramRequest {
1103
- /** Package of pools to grant. Package id should be the same that was used to provision programs. */
1395
+ /**
1396
+ * Package of pools to grant. Package id should be the same that was used to provision programs.
1397
+ * @format GUID
1398
+ */
1104
1399
  programId?: string;
1105
1400
  }
1106
1401
  export interface RenewPoolsForProgramResponse {
1107
- /** Job id of the renewal job */
1402
+ /**
1403
+ * Job id of the renewal job
1404
+ * @format GUID
1405
+ */
1108
1406
  jobId?: string;
1109
1407
  }
1110
1408
  export interface UpdatePoolStatusRequest extends UpdatePoolStatusRequestPoolSelectorOneOf {
@@ -1130,23 +1428,38 @@ export declare enum PoolSelectorType {
1130
1428
  BY_PROGRAM_ID = "BY_PROGRAM_ID"
1131
1429
  }
1132
1430
  export interface ByPoolDefinitionIdAndProgramDefinitionIdOptions {
1133
- /** Pool definition id */
1431
+ /**
1432
+ * Pool definition id
1433
+ * @format GUID
1434
+ */
1134
1435
  poolDefinitionId?: string;
1135
- /** Program definition id */
1436
+ /**
1437
+ * Program definition id
1438
+ * @format GUID
1439
+ */
1136
1440
  programDefinitionId?: string | null;
1137
1441
  }
1138
1442
  export interface ByProgramIdOptions {
1139
- /** Program id */
1443
+ /**
1444
+ * Program id
1445
+ * @format GUID
1446
+ */
1140
1447
  programId?: string;
1141
1448
  /** Additional data that gets added to the event once the async job completes */
1142
1449
  additionalData?: Record<string, any> | null;
1143
1450
  }
1144
1451
  export interface UpdatePoolStatusResponse {
1145
- /** Job ID of the program provision associated with this pool. */
1452
+ /**
1453
+ * Job ID of the program provision associated with this pool.
1454
+ * @format GUID
1455
+ */
1146
1456
  jobId?: string;
1147
1457
  }
1148
1458
  export interface CountNumberOfPoolsInProvisioningStatusRequest {
1149
- /** Program id */
1459
+ /**
1460
+ * Program id
1461
+ * @format GUID
1462
+ */
1150
1463
  programId?: string;
1151
1464
  }
1152
1465
  export interface CountNumberOfPoolsInProvisioningStatusResponse {
@@ -1226,9 +1539,15 @@ export interface ActionEvent {
1226
1539
  bodyAsJson?: string;
1227
1540
  }
1228
1541
  export interface MessageEnvelope {
1229
- /** App instance ID. */
1542
+ /**
1543
+ * App instance ID.
1544
+ * @format GUID
1545
+ */
1230
1546
  instanceId?: string | null;
1231
- /** Event type. */
1547
+ /**
1548
+ * Event type.
1549
+ * @maxLength 150
1550
+ */
1232
1551
  eventType?: string;
1233
1552
  /** The identification type and identity data. */
1234
1553
  identity?: IdentificationData;
@@ -1236,26 +1555,50 @@ export interface MessageEnvelope {
1236
1555
  data?: string;
1237
1556
  }
1238
1557
  export interface IdentificationData extends IdentificationDataIdOneOf {
1239
- /** ID of a site visitor that has not logged in to the site. */
1558
+ /**
1559
+ * ID of a site visitor that has not logged in to the site.
1560
+ * @format GUID
1561
+ */
1240
1562
  anonymousVisitorId?: string;
1241
- /** ID of a site visitor that has logged in to the site. */
1563
+ /**
1564
+ * ID of a site visitor that has logged in to the site.
1565
+ * @format GUID
1566
+ */
1242
1567
  memberId?: string;
1243
- /** ID of a Wix user (site owner, contributor, etc.). */
1568
+ /**
1569
+ * ID of a Wix user (site owner, contributor, etc.).
1570
+ * @format GUID
1571
+ */
1244
1572
  wixUserId?: string;
1245
- /** ID of an app. */
1573
+ /**
1574
+ * ID of an app.
1575
+ * @format GUID
1576
+ */
1246
1577
  appId?: string;
1247
1578
  /** @readonly */
1248
1579
  identityType?: WebhookIdentityType;
1249
1580
  }
1250
1581
  /** @oneof */
1251
1582
  export interface IdentificationDataIdOneOf {
1252
- /** ID of a site visitor that has not logged in to the site. */
1583
+ /**
1584
+ * ID of a site visitor that has not logged in to the site.
1585
+ * @format GUID
1586
+ */
1253
1587
  anonymousVisitorId?: string;
1254
- /** ID of a site visitor that has logged in to the site. */
1588
+ /**
1589
+ * ID of a site visitor that has logged in to the site.
1590
+ * @format GUID
1591
+ */
1255
1592
  memberId?: string;
1256
- /** ID of a Wix user (site owner, contributor, etc.). */
1593
+ /**
1594
+ * ID of a Wix user (site owner, contributor, etc.).
1595
+ * @format GUID
1596
+ */
1257
1597
  wixUserId?: string;
1258
- /** ID of an app. */
1598
+ /**
1599
+ * ID of an app.
1600
+ * @format GUID
1601
+ */
1259
1602
  appId?: string;
1260
1603
  }
1261
1604
  export declare enum WebhookIdentityType {