@wix/crm 1.0.165 → 1.0.167

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.
@@ -2095,7 +2095,7 @@ interface ExtendedField$1 {
2095
2095
  /**
2096
2096
  * Extended field namespace.
2097
2097
  *
2098
- * Extended fields created by site collaborators or 3rd-party apps
2098
+ * Extended fields created through by calling the Find Or Create Extended Field method
2099
2099
  * are automatically assigned to the `custom` namespace.
2100
2100
  * @readonly
2101
2101
  */
@@ -2109,11 +2109,11 @@ interface ExtendedField$1 {
2109
2109
  * the value can be accessed at `extendedFields["custom.notes"]`.
2110
2110
  *
2111
2111
  * `key` is generated when the extended field is created
2112
- * and cannot be modified, even if `displayName` changes.
2112
+ * and can't be modified, even if `displayName` changes.
2113
2113
  * @readonly
2114
2114
  */
2115
2115
  key?: string;
2116
- /** Display name shown in the Contact List. */
2116
+ /** Display name shown in the contact list. */
2117
2117
  displayName?: string;
2118
2118
  /**
2119
2119
  * Type of data the field holds.
@@ -2152,9 +2152,9 @@ declare enum FieldDataType$1 {
2152
2152
  URL = "URL"
2153
2153
  }
2154
2154
  declare enum FieldType$1 {
2155
- /** The field is a system field managed by Wix. System fields cannot be modified by 3rd-party apps or site contributors. */
2155
+ /** Field is a system field managed by Wix. System fields can't be modified by calling the Update Extended Field method. */
2156
2156
  SYSTEM = "SYSTEM",
2157
- /** The field is a custom field and can be modified by 3rd-party apps or site contributors. */
2157
+ /** Field is a custom field and can be modified by calling the Update Extended Field method. */
2158
2158
  USER_DEFINED = "USER_DEFINED"
2159
2159
  }
2160
2160
  interface Sorting$5 {
@@ -2203,10 +2203,10 @@ interface PagingMetadata$3 {
2203
2203
  /** Custom field to find or create. */
2204
2204
  interface FindOrCreateExtendedFieldRequest$1 {
2205
2205
  /**
2206
- * Display name to find or create.
2206
+ * Display name to retrieve or create.
2207
2207
  *
2208
2208
  * If an existing custom field is an exact match
2209
- * for the specified `displayName`,
2209
+ * for the specified display name,
2210
2210
  * the existing field is returned.
2211
2211
  * If not, a new field is created and returned.
2212
2212
  */
@@ -2215,11 +2215,6 @@ interface FindOrCreateExtendedFieldRequest$1 {
2215
2215
  * Type of data the field holds.
2216
2216
  * Ignored if an existing field is an exact match
2217
2217
  * for the specified display name.
2218
- *
2219
- * - `TEXT`: Accepts strings.
2220
- * - `NUMBER`: Accepts floats.
2221
- * - `DATE`: Accepts dates formatted as `YYYY-MM-DD`.
2222
- * - `URL`: Accepts strings. Prepends `https://` if no protocol is included.
2223
2218
  */
2224
2219
  dataType?: FieldDataType$1;
2225
2220
  }
@@ -2230,8 +2225,7 @@ interface FindOrCreateExtendedFieldResponse$1 {
2230
2225
  /**
2231
2226
  * Indicates whether the extended field was just created or already existed.
2232
2227
  *
2233
- * If the field was just created, returns `true`.
2234
- * If the field already existed, returns `false`.
2228
+ * Returns `true` if the field was just created.
2235
2229
  */
2236
2230
  newField?: boolean;
2237
2231
  }
@@ -2244,7 +2238,8 @@ interface GetExtendedFieldRequest$1 {
2244
2238
  * For example, if the key is "custom.patronus",
2245
2239
  * the value can be accessed at `info.extendedFields.items["custom.patronus"]`.
2246
2240
  *
2247
- * Once set, `key` cannot be modified, even if `displayName` changes.
2241
+ * `key` is generated when the extended field is created.
2242
+ * It can't be modified, even if `displayName` is updated.
2248
2243
  */
2249
2244
  key: string;
2250
2245
  }
@@ -2254,12 +2249,12 @@ interface GetExtendedFieldResponse$1 {
2254
2249
  field?: ExtendedField$1;
2255
2250
  }
2256
2251
  interface UpdateExtendedFieldRequest$1 {
2257
- /** Field to update. */
2252
+ /** Extended field to rename. */
2258
2253
  field?: ExtendedField$1;
2259
2254
  }
2260
2255
  /** Updated extended field. */
2261
2256
  interface UpdateExtendedFieldResponse$1 {
2262
- /** Updated extended field. */
2257
+ /** Renamed extended field. */
2263
2258
  field?: ExtendedField$1;
2264
2259
  }
2265
2260
  interface DeleteExtendedFieldRequest$1 {
@@ -2328,7 +2323,7 @@ interface ExtendedField {
2328
2323
  /**
2329
2324
  * Extended field namespace.
2330
2325
  *
2331
- * Extended fields created by site collaborators or 3rd-party apps
2326
+ * Extended fields created through by calling the Find Or Create Extended Field method
2332
2327
  * are automatically assigned to the `custom` namespace.
2333
2328
  * @readonly
2334
2329
  */
@@ -2337,34 +2332,24 @@ interface ExtendedField {
2337
2332
  * Extended field key.
2338
2333
  *
2339
2334
  * When accessing contact data,
2340
- * extended field data is available at `fields[key]`.
2335
+ * extended field data is available at `extendedFields[key]`.
2341
2336
  * For example, if the key is "custom.notes",
2342
- * the value can be accessed at `fields["custom.notes"]`.
2337
+ * the value can be accessed at `extendedFields["custom.notes"]`.
2343
2338
  *
2344
2339
  * `key` is generated when the extended field is created
2345
- * and cannot be modified, even if `displayName` changes.
2340
+ * and can't be modified, even if `displayName` changes.
2346
2341
  * @readonly
2347
2342
  */
2348
2343
  key?: string;
2349
- /** Display name shown in the Contact List. */
2344
+ /** Display name shown in the contact list. */
2350
2345
  displayName?: string;
2351
2346
  /**
2352
2347
  * Type of data the field holds.
2353
- *
2354
- * One of:
2355
- * - `"TEXT"`: Accepts strings.
2356
- * - `"NUMBER"`: Accepts floats.
2357
- * - `"DATE"`: Accepts dates formatted as `YYYY-MM-DD`.
2358
- * - `"URL"`: Accepts strings. Prepends `https://` if no protocol is included.
2359
2348
  * @readonly
2360
2349
  */
2361
2350
  dataType?: FieldDataType;
2362
2351
  /**
2363
2352
  * Indicates whether the extended field is a system field or custom field.
2364
- *
2365
- * One of:
2366
- * - `"SYSTEM"`: System field managed by Wix. System fields cannot be modified by 3rd-party apps or site contributors.
2367
- * - `"USER_DEFINED"`: Custom field that can be modified by 3rd-party apps or site admins.
2368
2353
  * @readonly
2369
2354
  */
2370
2355
  fieldType?: FieldType;
@@ -2395,9 +2380,9 @@ declare enum FieldDataType {
2395
2380
  URL = "URL"
2396
2381
  }
2397
2382
  declare enum FieldType {
2398
- /** The field is a system field managed by Wix. System fields cannot be modified by 3rd-party apps or site contributors. */
2383
+ /** Field is a system field managed by Wix. System fields can't be modified by calling the Update Extended Field method. */
2399
2384
  SYSTEM = "SYSTEM",
2400
- /** The field is a custom field and can be modified by 3rd-party apps or site contributors. */
2385
+ /** Field is a custom field and can be modified by calling the Update Extended Field method. */
2401
2386
  USER_DEFINED = "USER_DEFINED"
2402
2387
  }
2403
2388
  interface Sorting$4 {
@@ -2446,10 +2431,10 @@ interface PagingMetadata$2 {
2446
2431
  /** Custom field to find or create. */
2447
2432
  interface FindOrCreateExtendedFieldRequest {
2448
2433
  /**
2449
- * Display name to find or create.
2434
+ * Display name to retrieve or create.
2450
2435
  *
2451
2436
  * If an existing custom field is an exact match
2452
- * for the specified `displayName`,
2437
+ * for the specified display name,
2453
2438
  * the existing field is returned.
2454
2439
  * If not, a new field is created and returned.
2455
2440
  */
@@ -2457,12 +2442,7 @@ interface FindOrCreateExtendedFieldRequest {
2457
2442
  /**
2458
2443
  * Type of data the field holds.
2459
2444
  * Ignored if an existing field is an exact match
2460
- * for the specified display name. One of:
2461
- *
2462
- * - `"TEXT"`: Accepts strings.
2463
- * - `"NUMBER"`: Accepts floats.
2464
- * - `"DATE"`: Accepts dates formatted as `YYYY-MM-DD`.
2465
- * - `"URL"`: Accepts strings. Prepends `https://` if no protocol is included.
2445
+ * for the specified display name.
2466
2446
  */
2467
2447
  dataType?: FieldDataType;
2468
2448
  }
@@ -2473,8 +2453,7 @@ interface FindOrCreateExtendedFieldResponse {
2473
2453
  /**
2474
2454
  * Indicates whether the extended field was just created or already existed.
2475
2455
  *
2476
- * If the field was just created, returns `true`.
2477
- * If the field already existed, returns `false`.
2456
+ * Returns `true` if the field was just created.
2478
2457
  */
2479
2458
  newField?: boolean;
2480
2459
  }
@@ -2483,11 +2462,12 @@ interface GetExtendedFieldRequest {
2483
2462
  * Extended field key.
2484
2463
  *
2485
2464
  * When accessing contact data,
2486
- * extended field values are available at `fields[key]`.
2487
- * For example, if the key is "custom.notes",
2488
- * the value can be accessed at `fields["custom.notes"]`.
2465
+ * extended field values are available at `info.extendedFields.items[key]`.
2466
+ * For example, if the key is "custom.patronus",
2467
+ * the value can be accessed at `info.extendedFields.items["custom.patronus"]`.
2489
2468
  *
2490
- * Once set, `key` cannot be modified, even if `displayName` changes.
2469
+ * `key` is generated when the extended field is created.
2470
+ * It can't be modified, even if `displayName` is updated.
2491
2471
  */
2492
2472
  key: string;
2493
2473
  }
@@ -2497,12 +2477,12 @@ interface GetExtendedFieldResponse {
2497
2477
  field?: ExtendedField;
2498
2478
  }
2499
2479
  interface UpdateExtendedFieldRequest {
2500
- /** Field to update. */
2480
+ /** Extended field to rename. */
2501
2481
  field?: ExtendedField;
2502
2482
  }
2503
2483
  /** Updated extended field. */
2504
2484
  interface UpdateExtendedFieldResponse {
2505
- /** Updated extended field. */
2485
+ /** Renamed extended field. */
2506
2486
  field?: ExtendedField;
2507
2487
  }
2508
2488
  interface DeleteExtendedFieldRequest {
@@ -2602,14 +2582,14 @@ interface ContactLabel$1 {
2602
2582
  /**
2603
2583
  * Label namespace.
2604
2584
  *
2605
- * Labels created by site admins or 3rd-party apps
2585
+ * Labels created by calling the Find Or Create Label method
2606
2586
  * are automatically assigned to the `custom` namespace.
2607
2587
  * @readonly
2608
2588
  */
2609
2589
  namespace?: string | null;
2610
2590
  /**
2611
2591
  * Display name for the namespace,
2612
- * used to organize the list of labels in the site Dashboard.
2592
+ * used to organize the list of labels in the site dashboard.
2613
2593
  * @readonly
2614
2594
  */
2615
2595
  namespaceDisplayName?: string | null;
@@ -2617,11 +2597,11 @@ interface ContactLabel$1 {
2617
2597
  * Label key.
2618
2598
  *
2619
2599
  * `key` is generated when the label is created.
2620
- * It cannot be modified, even if `displayName` is updated.
2600
+ * It can't be modified, even if `displayName` is updated.
2621
2601
  * @readonly
2622
2602
  */
2623
2603
  key?: string;
2624
- /** Label display name shown in the Dashboard. */
2604
+ /** Label display name shown in the dashboard. */
2625
2605
  displayName?: string;
2626
2606
  /**
2627
2607
  * Label type indicating how the label was created.
@@ -2640,11 +2620,11 @@ interface ContactLabel$1 {
2640
2620
  updatedDate?: Date | null;
2641
2621
  }
2642
2622
  declare enum LabelType$1 {
2643
- /** Default system label for the Contact List. */
2623
+ /** Default system label for the contact list. */
2644
2624
  SYSTEM = "SYSTEM",
2645
- /** Label created by a site contributor or 3rd-party app. */
2625
+ /** Label created by calling the Find Or Create Label method. */
2646
2626
  USER_DEFINED = "USER_DEFINED",
2647
- /** Label created by a Wix app. */
2627
+ /** Label created by an app built by Wix. */
2648
2628
  WIX_APP_DEFINED = "WIX_APP_DEFINED"
2649
2629
  }
2650
2630
  interface Sorting$3 {
@@ -2698,7 +2678,10 @@ interface FindOrCreateLabelRequest$1 {
2698
2678
  * If not, a new label is created and returned.
2699
2679
  */
2700
2680
  displayName: string;
2701
- /** Language for localization. */
2681
+ /**
2682
+ * Language for localization.
2683
+ * 2-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format.
2684
+ */
2702
2685
  language?: string | null;
2703
2686
  }
2704
2687
  /** Label that was found or created. */
@@ -2708,8 +2691,7 @@ interface FindOrCreateLabelResponse$1 {
2708
2691
  /**
2709
2692
  * Indicates whether the label was just created or already existed.
2710
2693
  *
2711
- * If the label was just created, returns `true`.
2712
- * If it already existed, returns `false`.
2694
+ * Returns `true` if the label was just created.
2713
2695
  */
2714
2696
  newLabel?: boolean;
2715
2697
  }
@@ -2718,10 +2700,13 @@ interface GetLabelRequest$1 {
2718
2700
  * Label key.
2719
2701
  *
2720
2702
  * `key` is generated when the label is created.
2721
- * It cannot be modified, even if `displayName` is updated.
2703
+ * It can't be modified, even if `displayName` is updated.
2722
2704
  */
2723
2705
  key: string;
2724
- /** Language for localization. */
2706
+ /**
2707
+ * Language for localization.
2708
+ * 2-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format.
2709
+ */
2725
2710
  language?: string | null;
2726
2711
  }
2727
2712
  /** The specified label. */
@@ -2730,14 +2715,17 @@ interface GetLabelResponse$1 {
2730
2715
  label?: ContactLabel$1;
2731
2716
  }
2732
2717
  interface UpdateLabelRequest$1 {
2733
- /** Label details to update. */
2718
+ /** Label to rename. */
2734
2719
  label?: ContactLabel$1;
2735
- /** Language for localization. */
2720
+ /**
2721
+ * Language for localization.
2722
+ * 2-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format.
2723
+ */
2736
2724
  language?: string | null;
2737
2725
  }
2738
2726
  /** Updated label. */
2739
2727
  interface UpdateLabelResponse$1 {
2740
- /** Updated label. */
2728
+ /** Renamed label. */
2741
2729
  label?: ContactLabel$1;
2742
2730
  }
2743
2731
  interface DeleteLabelRequest$1 {
@@ -2749,7 +2737,10 @@ interface DeleteLabelResponse$1 {
2749
2737
  interface QueryLabelsRequest$1 {
2750
2738
  /** Query options. */
2751
2739
  query?: Query$1;
2752
- /** Language for localization. */
2740
+ /**
2741
+ * Language for localization.
2742
+ * 2-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format.
2743
+ */
2753
2744
  language?: string | null;
2754
2745
  }
2755
2746
  interface Query$1 {
@@ -2807,14 +2798,14 @@ interface ContactLabel {
2807
2798
  /**
2808
2799
  * Label namespace.
2809
2800
  *
2810
- * Labels created by site admins or 3rd-party apps
2801
+ * Labels created by calling the Find Or Create Label method
2811
2802
  * are automatically assigned to the `custom` namespace.
2812
2803
  * @readonly
2813
2804
  */
2814
2805
  namespace?: string | null;
2815
2806
  /**
2816
2807
  * Display name for the namespace,
2817
- * used to organize the list of labels in the site Dashboard.
2808
+ * used to organize the list of labels in the site dashboard.
2818
2809
  * @readonly
2819
2810
  */
2820
2811
  namespaceDisplayName?: string | null;
@@ -2822,18 +2813,14 @@ interface ContactLabel {
2822
2813
  * Label key.
2823
2814
  *
2824
2815
  * `key` is generated when the label is created.
2825
- * It cannot be modified, even if `displayName` is updated.
2816
+ * It can't be modified, even if `displayName` is updated.
2826
2817
  * @readonly
2827
2818
  */
2828
2819
  key?: string;
2829
- /** Label display name shown in the Dashboard. */
2820
+ /** Label display name shown in the dashboard. */
2830
2821
  displayName?: string;
2831
2822
  /**
2832
- * Label type.
2833
- *
2834
- * - `"SYSTEM"`: The label is a default system label for the Contact List.
2835
- * - `"USER_DEFINED"`: The label was created by a site contributor or 3rd-party app.
2836
- * - `"WIX_APP_DEFINED"`: The label was created by a Wix app.
2823
+ * Label type indicating how the label was created.
2837
2824
  * @readonly
2838
2825
  */
2839
2826
  labelType?: LabelType;
@@ -2849,11 +2836,11 @@ interface ContactLabel {
2849
2836
  _updatedDate?: Date | null;
2850
2837
  }
2851
2838
  declare enum LabelType {
2852
- /** Default system label for the Contact List. */
2839
+ /** Default system label for the contact list. */
2853
2840
  SYSTEM = "SYSTEM",
2854
- /** Label created by a site contributor or 3rd-party app. */
2841
+ /** Label created by calling the Find Or Create Label method. */
2855
2842
  USER_DEFINED = "USER_DEFINED",
2856
- /** Label created by a Wix app. */
2843
+ /** Label created by an app built by Wix. */
2857
2844
  WIX_APP_DEFINED = "WIX_APP_DEFINED"
2858
2845
  }
2859
2846
  interface Sorting$2 {
@@ -2907,7 +2894,10 @@ interface FindOrCreateLabelRequest {
2907
2894
  * If not, a new label is created and returned.
2908
2895
  */
2909
2896
  displayName: string;
2910
- /** Language for localization. */
2897
+ /**
2898
+ * Language for localization.
2899
+ * 2-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format.
2900
+ */
2911
2901
  language?: string | null;
2912
2902
  }
2913
2903
  /** Label that was found or created. */
@@ -2917,8 +2907,7 @@ interface FindOrCreateLabelResponse {
2917
2907
  /**
2918
2908
  * Indicates whether the label was just created or already existed.
2919
2909
  *
2920
- * If the label was just created, returns `true`.
2921
- * If it already existed, returns `false`.
2910
+ * Returns `true` if the label was just created.
2922
2911
  */
2923
2912
  newLabel?: boolean;
2924
2913
  }
@@ -2927,10 +2916,13 @@ interface GetLabelRequest {
2927
2916
  * Label key.
2928
2917
  *
2929
2918
  * `key` is generated when the label is created.
2930
- * It cannot be modified, even if `displayName` is updated.
2919
+ * It can't be modified, even if `displayName` is updated.
2931
2920
  */
2932
2921
  key: string;
2933
- /** Language for localization. */
2922
+ /**
2923
+ * Language for localization.
2924
+ * 2-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format.
2925
+ */
2934
2926
  language?: string | null;
2935
2927
  }
2936
2928
  /** The specified label. */
@@ -2939,14 +2931,17 @@ interface GetLabelResponse {
2939
2931
  label?: ContactLabel;
2940
2932
  }
2941
2933
  interface UpdateLabelRequest {
2942
- /** Label details to update. */
2934
+ /** Label to rename. */
2943
2935
  label?: ContactLabel;
2944
- /** Language for localization. */
2936
+ /**
2937
+ * Language for localization.
2938
+ * 2-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format.
2939
+ */
2945
2940
  language?: string | null;
2946
2941
  }
2947
2942
  /** Updated label. */
2948
2943
  interface UpdateLabelResponse {
2949
- /** Updated label. */
2944
+ /** Renamed label. */
2950
2945
  label?: ContactLabel;
2951
2946
  }
2952
2947
  interface DeleteLabelRequest {
@@ -2958,7 +2953,10 @@ interface DeleteLabelResponse {
2958
2953
  interface QueryLabelsRequest {
2959
2954
  /** Query options. */
2960
2955
  query?: Query;
2961
- /** Language for localization. */
2956
+ /**
2957
+ * Language for localization.
2958
+ * 2-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format.
2959
+ */
2962
2960
  language?: string | null;
2963
2961
  }
2964
2962
  interface Query {