@datocms/cma-client 3.1.0 → 3.1.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.
@@ -609,7 +609,7 @@ export type ItemInstancesTargetSchema = Item[];
609
609
  */
610
610
  export type ItemInstancesHrefSchema = {
611
611
  /**
612
- * For Modular Content fields and Structured Text fields. If set, returns full payload for nested blocks instead of IDs
612
+ * For Modular Content, Structured Text and Single Block fields. If set, returns full payload for nested blocks instead of IDs
613
613
  */
614
614
  nested?: boolean;
615
615
  /**
@@ -679,7 +679,7 @@ export type ItemReferencesTargetSchema = Item[];
679
679
  */
680
680
  export type ItemReferencesHrefSchema = {
681
681
  /**
682
- * For Modular Content fields and Structured Text fields, return full payload for nested blocks instead of IDs
682
+ * For Modular Content, Structured Text and Single Block fields, return full payload for nested blocks instead of IDs
683
683
  */
684
684
  nested?: boolean;
685
685
  /**
@@ -694,7 +694,7 @@ export type ItemReferencesHrefSchema = {
694
694
  */
695
695
  export type ItemSelfHrefSchema = {
696
696
  /**
697
- * For Modular Content fields and Structured Text fields. If set, returns full payload for nested blocks instead of IDs
697
+ * For Modular Content, Structured Text and Single Block fields. If set, returns full payload for nested blocks instead of IDs
698
698
  */
699
699
  nested?: boolean;
700
700
  /**
@@ -895,7 +895,7 @@ export type ItemVersionInstancesTargetSchema = ItemVersion[];
895
895
  */
896
896
  export type ItemVersionInstancesHrefSchema = {
897
897
  /**
898
- * For Modular Content fields and Structured Text fields. If set, returns full payload for nested blocks instead of IDs
898
+ * For Modular Content, Structured Text and Single Block fields. If set, returns full payload for nested blocks instead of IDs
899
899
  */
900
900
  nested?: boolean;
901
901
  /**
@@ -1026,7 +1026,7 @@ export type UploadReferencesTargetSchema = Item[];
1026
1026
  */
1027
1027
  export type UploadReferencesHrefSchema = {
1028
1028
  /**
1029
- * For Modular Content fields and Structured Text fields, return full payload for nested blocks instead of IDs
1029
+ * For Modular Content, Structured Text and Single Block fields, return full payload for nested blocks instead of IDs
1030
1030
  */
1031
1031
  nested?: boolean;
1032
1032
  /**
@@ -5093,6 +5093,18 @@ export type JobData = {
5093
5093
  * </details>
5094
5094
  *
5095
5095
  * <details>
5096
+ * <summary>Single Block (<code>single_block</code>)</summary>
5097
+ *
5098
+ * | Property | Value |
5099
+ * | ------------------------------ | ----------------------------------------------- |
5100
+ * | Code | `single_block` |
5101
+ * | Built-in editors for the field | `framed_single_block`, `frameless_single_block` |
5102
+ * | Required validators | `single_block_blocks` |
5103
+ * | Other validators available | `required` |
5104
+ *
5105
+ * </details>
5106
+ *
5107
+ * <details>
5096
5108
  * <summary>Structured text (<code>structured_text</code>)</summary>
5097
5109
  *
5098
5110
  * | Property | Value |
@@ -5394,6 +5406,17 @@ export type JobData = {
5394
5406
  *
5395
5407
  * Only accept references to block records of the specified block models.
5396
5408
  *
5409
+ * | Parameter | Type | Required | Description |
5410
+ * | ------------ | ----------------------- | -------- | ------------------------------ |
5411
+ * | `item_types` | `Array<Block Model ID>` | ✅ | Set of allowed Block Model IDs |
5412
+ *
5413
+ * </details>
5414
+ *
5415
+ * <details>
5416
+ * <summary><code>single_block_blocks</code></summary>
5417
+ *
5418
+ * Only accept references to block records of the specified block models.
5419
+ *
5397
5420
  * | Parameter | Type | Required | Description |
5398
5421
  * | ------------ | ----------------------- | -------- | ------------------------------ |
5399
5422
  * | `item_types` | `Array<Block Model ID>` | ✅ | Set of allowed Block Model IDs |
@@ -5613,10 +5636,10 @@ export type JobData = {
5613
5636
  *
5614
5637
  * Built-in editor for _seo_ fields.
5615
5638
  *
5616
- * | Parameter | Type | Required | Description |
5617
- * | ---------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
5618
- * | `fields` | `Array<String>` | ✅ | Specify which fields of the SEO input should be visible to editors. Valid values: `"title"`, `"description"`, `"image"`, `"no_index"`, `"twitter_card"` |
5619
- * | `previews` | `Array<String>` | ✅ | Specify which previews should be visible to editors. Valid values: `"google_search"`, `"twitter"`, `"slack"`, `"whatsapp"`, `"telegram"`, `"facebook"` |
5639
+ * | Parameter | Type | Required | Description |
5640
+ * | ---------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
5641
+ * | `fields` | `Array<String>` | ✅ | Specify which fields of the SEO input should be visible to editors. Valid values: `"title"`, `"description"`, `"image"`, `"no_index"`, `"twitter_card"` |
5642
+ * | `previews` | `Array<String>` | ✅ | Specify which previews should be visible to editors. Valid values: `"google_search"`, `"twitter"`, `"slack"`, `"whatsapp"`, `"telegram"`, `"facebook"`, `"linkedin"` |
5620
5643
  *
5621
5644
  * </details>
5622
5645
  *
@@ -5632,6 +5655,17 @@ export type JobData = {
5632
5655
  * </details>
5633
5656
  *
5634
5657
  * <details>
5658
+ * <summary><code>framed_single_block</code></summary>
5659
+ *
5660
+ * Built-in editor for _Single block_ fields.
5661
+ *
5662
+ * | Parameter | Type | Required | Description |
5663
+ * | ----------------- | --------- | -------- | ---------------------------------------------------------- |
5664
+ * | `start_collapsed` | `Boolean` | | Whether you want block record collapsed by default or not |
5665
+ *
5666
+ * </details>
5667
+ *
5668
+ * <details>
5635
5669
  * <summary><code>structured_text</code></summary>
5636
5670
  *
5637
5671
  * Built-in editor for _Structured text_ fields.
@@ -5676,25 +5710,26 @@ export type Field = {
5676
5710
  * Type of input
5677
5711
  */
5678
5712
  field_type:
5679
- | 'string'
5680
- | 'text'
5681
5713
  | 'boolean'
5682
- | 'integer'
5683
- | 'float'
5714
+ | 'color'
5684
5715
  | 'date'
5685
5716
  | 'date_time'
5686
- | 'color'
5687
- | 'json'
5688
- | 'lat_lon'
5689
- | 'seo'
5690
- | 'slug'
5691
- | 'video'
5692
5717
  | 'file'
5718
+ | 'float'
5693
5719
  | 'gallery'
5720
+ | 'integer'
5721
+ | 'json'
5722
+ | 'lat_lon'
5694
5723
  | 'link'
5695
5724
  | 'links'
5696
5725
  | 'rich_text'
5697
- | 'structured_text';
5726
+ | 'seo'
5727
+ | 'single_block'
5728
+ | 'slug'
5729
+ | 'string'
5730
+ | 'structured_text'
5731
+ | 'text'
5732
+ | 'video';
5698
5733
  /**
5699
5734
  * Whether the field needs to be multilanguage or not
5700
5735
  */
@@ -5802,25 +5837,26 @@ export type FieldAttributes = {
5802
5837
  * Type of input
5803
5838
  */
5804
5839
  field_type:
5805
- | 'string'
5806
- | 'text'
5807
5840
  | 'boolean'
5808
- | 'integer'
5809
- | 'float'
5841
+ | 'color'
5810
5842
  | 'date'
5811
5843
  | 'date_time'
5812
- | 'color'
5813
- | 'json'
5814
- | 'lat_lon'
5815
- | 'seo'
5816
- | 'slug'
5817
- | 'video'
5818
5844
  | 'file'
5845
+ | 'float'
5819
5846
  | 'gallery'
5847
+ | 'integer'
5848
+ | 'json'
5849
+ | 'lat_lon'
5820
5850
  | 'link'
5821
5851
  | 'links'
5822
5852
  | 'rich_text'
5823
- | 'structured_text';
5853
+ | 'seo'
5854
+ | 'single_block'
5855
+ | 'slug'
5856
+ | 'string'
5857
+ | 'structured_text'
5858
+ | 'text'
5859
+ | 'video';
5824
5860
  /**
5825
5861
  * Whether the field needs to be multilanguage or not
5826
5862
  */
@@ -5933,25 +5969,26 @@ export type FieldCreateSchema = {
5933
5969
  * Type of input
5934
5970
  */
5935
5971
  field_type:
5936
- | 'string'
5937
- | 'text'
5938
5972
  | 'boolean'
5939
- | 'integer'
5940
- | 'float'
5973
+ | 'color'
5941
5974
  | 'date'
5942
5975
  | 'date_time'
5943
- | 'color'
5944
- | 'json'
5945
- | 'lat_lon'
5946
- | 'seo'
5947
- | 'slug'
5948
- | 'video'
5949
5976
  | 'file'
5977
+ | 'float'
5950
5978
  | 'gallery'
5979
+ | 'integer'
5980
+ | 'json'
5981
+ | 'lat_lon'
5951
5982
  | 'link'
5952
5983
  | 'links'
5953
5984
  | 'rich_text'
5954
- | 'structured_text';
5985
+ | 'seo'
5986
+ | 'single_block'
5987
+ | 'slug'
5988
+ | 'string'
5989
+ | 'structured_text'
5990
+ | 'text'
5991
+ | 'video';
5955
5992
  /**
5956
5993
  * Field API key
5957
5994
  */
@@ -6130,25 +6167,26 @@ export type FieldUpdateSchema = {
6130
6167
  * Type of input
6131
6168
  */
6132
6169
  field_type?:
6133
- | 'string'
6134
- | 'text'
6135
6170
  | 'boolean'
6136
- | 'integer'
6137
- | 'float'
6171
+ | 'color'
6138
6172
  | 'date'
6139
6173
  | 'date_time'
6140
- | 'color'
6141
- | 'json'
6142
- | 'lat_lon'
6143
- | 'seo'
6144
- | 'slug'
6145
- | 'video'
6146
6174
  | 'file'
6175
+ | 'float'
6147
6176
  | 'gallery'
6177
+ | 'integer'
6178
+ | 'json'
6179
+ | 'lat_lon'
6148
6180
  | 'link'
6149
6181
  | 'links'
6150
6182
  | 'rich_text'
6151
- | 'structured_text';
6183
+ | 'seo'
6184
+ | 'single_block'
6185
+ | 'slug'
6186
+ | 'string'
6187
+ | 'structured_text'
6188
+ | 'text'
6189
+ | 'video';
6152
6190
  /**
6153
6191
  * Field hint
6154
6192
  */
@@ -9722,35 +9760,31 @@ export type PublicInfo = {
9722
9760
  * Specifies the color-scheme for the project
9723
9761
  */
9724
9762
  theme: {
9725
- primary_color?: {
9763
+ primary_color: {
9726
9764
  red: number;
9727
9765
  green: number;
9728
9766
  blue: number;
9729
9767
  alpha: number;
9730
9768
  [k: string]: unknown;
9731
9769
  };
9732
- light_color?: {
9770
+ light_color: {
9733
9771
  red: number;
9734
9772
  green: number;
9735
9773
  blue: number;
9736
9774
  alpha: number;
9737
- [k: string]: unknown;
9738
9775
  };
9739
- accent_color?: {
9776
+ accent_color: {
9740
9777
  red: number;
9741
9778
  green: number;
9742
9779
  blue: number;
9743
9780
  alpha: number;
9744
- [k: string]: unknown;
9745
9781
  };
9746
- dark_color?: {
9782
+ dark_color: {
9747
9783
  red: number;
9748
9784
  green: number;
9749
9785
  blue: number;
9750
9786
  alpha: number;
9751
- [k: string]: unknown;
9752
9787
  };
9753
- [k: string]: unknown;
9754
9788
  };
9755
9789
  /**
9756
9790
  * Additional information (only returned on authenticated requests)
@@ -9805,35 +9839,31 @@ export type PublicInfoAttributes = {
9805
9839
  * Specifies the color-scheme for the project
9806
9840
  */
9807
9841
  theme: {
9808
- primary_color?: {
9842
+ primary_color: {
9809
9843
  red: number;
9810
9844
  green: number;
9811
9845
  blue: number;
9812
9846
  alpha: number;
9813
9847
  [k: string]: unknown;
9814
9848
  };
9815
- light_color?: {
9849
+ light_color: {
9816
9850
  red: number;
9817
9851
  green: number;
9818
9852
  blue: number;
9819
9853
  alpha: number;
9820
- [k: string]: unknown;
9821
9854
  };
9822
- accent_color?: {
9855
+ accent_color: {
9823
9856
  red: number;
9824
9857
  green: number;
9825
9858
  blue: number;
9826
9859
  alpha: number;
9827
- [k: string]: unknown;
9828
9860
  };
9829
- dark_color?: {
9861
+ dark_color: {
9830
9862
  red: number;
9831
9863
  green: number;
9832
9864
  blue: number;
9833
9865
  alpha: number;
9834
- [k: string]: unknown;
9835
9866
  };
9836
- [k: string]: unknown;
9837
9867
  };
9838
9868
  /**
9839
9869
  * Additional information (only returned on authenticated requests)
@@ -10131,39 +10161,42 @@ export type Site = {
10131
10161
  * Specifies the theme to use in administrative area
10132
10162
  */
10133
10163
  theme: {
10164
+ /**
10165
+ * If type is monochromatic, the hue will determine the color palette. Dark color is a legacy property, and it won't be used on the interface
10166
+ */
10167
+ type: 'custom' | 'monochromatic';
10168
+ /**
10169
+ * If the type is monochromatic, the value will fall between 0 and 359. If it's not, the value will be null.
10170
+ */
10171
+ hue: number | null;
10134
10172
  primary_color: {
10135
10173
  red: number;
10136
10174
  green: number;
10137
10175
  blue: number;
10138
10176
  alpha: number;
10139
- [k: string]: unknown;
10140
10177
  };
10141
10178
  light_color: {
10142
10179
  red: number;
10143
10180
  green: number;
10144
10181
  blue: number;
10145
10182
  alpha: number;
10146
- [k: string]: unknown;
10147
10183
  };
10148
10184
  accent_color: {
10149
10185
  red: number;
10150
10186
  green: number;
10151
10187
  blue: number;
10152
10188
  alpha: number;
10153
- [k: string]: unknown;
10154
10189
  };
10155
10190
  dark_color: {
10156
10191
  red: number;
10157
10192
  green: number;
10158
10193
  blue: number;
10159
10194
  alpha: number;
10160
- [k: string]: unknown;
10161
10195
  };
10162
10196
  /**
10163
- * The site logo
10197
+ * The upload ID that is used as the logo for the project
10164
10198
  */
10165
10199
  logo: string | null;
10166
- [k: string]: unknown;
10167
10200
  };
10168
10201
  /**
10169
10202
  * Specifies default global settings
@@ -10318,39 +10351,42 @@ export type SiteAttributes = {
10318
10351
  * Specifies the theme to use in administrative area
10319
10352
  */
10320
10353
  theme: {
10354
+ /**
10355
+ * If type is monochromatic, the hue will determine the color palette. Dark color is a legacy property, and it won't be used on the interface
10356
+ */
10357
+ type: 'custom' | 'monochromatic';
10358
+ /**
10359
+ * If the type is monochromatic, the value will fall between 0 and 359. If it's not, the value will be null.
10360
+ */
10361
+ hue: number | null;
10321
10362
  primary_color: {
10322
10363
  red: number;
10323
10364
  green: number;
10324
10365
  blue: number;
10325
10366
  alpha: number;
10326
- [k: string]: unknown;
10327
10367
  };
10328
10368
  light_color: {
10329
10369
  red: number;
10330
10370
  green: number;
10331
10371
  blue: number;
10332
10372
  alpha: number;
10333
- [k: string]: unknown;
10334
10373
  };
10335
10374
  accent_color: {
10336
10375
  red: number;
10337
10376
  green: number;
10338
10377
  blue: number;
10339
10378
  alpha: number;
10340
- [k: string]: unknown;
10341
10379
  };
10342
10380
  dark_color: {
10343
10381
  red: number;
10344
10382
  green: number;
10345
10383
  blue: number;
10346
10384
  alpha: number;
10347
- [k: string]: unknown;
10348
10385
  };
10349
10386
  /**
10350
- * The site logo
10387
+ * The upload ID that is used as the logo for the project
10351
10388
  */
10352
10389
  logo: string | null;
10353
- [k: string]: unknown;
10354
10390
  };
10355
10391
  /**
10356
10392
  * Specifies default global settings
@@ -10458,44 +10494,57 @@ export type SiteUpdateSchema = {
10458
10494
  * Site name
10459
10495
  */
10460
10496
  name?: string;
10461
- /**
10462
- * Specifies the theme to use in administrative area
10463
- */
10464
- theme?: {
10465
- primary_color: {
10466
- red: number;
10467
- green: number;
10468
- blue: number;
10469
- alpha: number;
10470
- [k: string]: unknown;
10471
- };
10472
- light_color: {
10473
- red: number;
10474
- green: number;
10475
- blue: number;
10476
- alpha: number;
10477
- [k: string]: unknown;
10478
- };
10479
- accent_color: {
10480
- red: number;
10481
- green: number;
10482
- blue: number;
10483
- alpha: number;
10484
- [k: string]: unknown;
10485
- };
10486
- dark_color: {
10487
- red: number;
10488
- green: number;
10489
- blue: number;
10490
- alpha: number;
10491
- [k: string]: unknown;
10492
- };
10493
- /**
10494
- * The site logo
10495
- */
10496
- logo: string | null;
10497
- [k: string]: unknown;
10498
- };
10497
+ theme?:
10498
+ | {
10499
+ /**
10500
+ * Type of theme color palette
10501
+ */
10502
+ type: 'monochromatic';
10503
+ /**
10504
+ * If the type is monochromatic, the value will fall between 0 and 359. If it's not, the value will be null.
10505
+ */
10506
+ hue: number | null;
10507
+ /**
10508
+ * The upload ID that is used as the logo for the project
10509
+ */
10510
+ logo: string | null;
10511
+ [k: string]: unknown;
10512
+ }
10513
+ | {
10514
+ /**
10515
+ * Type of theme color palette
10516
+ */
10517
+ type?: 'custom';
10518
+ /**
10519
+ * The upload ID that is used as the logo for the project
10520
+ */
10521
+ logo: string | null;
10522
+ primary_color: {
10523
+ red: number;
10524
+ green: number;
10525
+ blue: number;
10526
+ alpha: number;
10527
+ };
10528
+ light_color: {
10529
+ red: number;
10530
+ green: number;
10531
+ blue: number;
10532
+ alpha: number;
10533
+ };
10534
+ accent_color: {
10535
+ red: number;
10536
+ green: number;
10537
+ blue: number;
10538
+ alpha: number;
10539
+ };
10540
+ dark_color?: {
10541
+ red: number;
10542
+ green: number;
10543
+ blue: number;
10544
+ alpha: number;
10545
+ };
10546
+ [k: string]: unknown;
10547
+ };
10499
10548
  /**
10500
10549
  * Available locales
10501
10550
  */