@uniformdev/canvas 17.0.0 → 17.1.1-alpha.152
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.
- package/dist/chunk-PFL3XEAQ.mjs +4 -0
- package/dist/cli/cli.d.ts +1 -1
- package/dist/cli/cli.js +44 -45
- package/dist/cli/cli.mjs +22 -22
- package/dist/{createEventBus-aea3860f.d.ts → createEventBus-b9cdb6ff.d.ts} +540 -47
- package/dist/index.d.ts +1582 -60
- package/dist/index.esm.js +1 -1
- package/dist/index.js +2 -3
- package/dist/index.mjs +1 -1
- package/package.json +6 -6
- package/dist/chunk-VQFPUXRX.mjs +0 -5
@@ -125,6 +125,12 @@ interface external$1 {
|
|
125
125
|
"application/json": external$1["swagger.yml"]["components"]["schemas"]["Error"];
|
126
126
|
};
|
127
127
|
};
|
128
|
+
/** Resource not found */
|
129
|
+
NotFoundError: {
|
130
|
+
content: {
|
131
|
+
"application/json": external$1["swagger.yml"]["components"]["schemas"]["Error"];
|
132
|
+
};
|
133
|
+
};
|
128
134
|
/** Too many requests in allowed time period */
|
129
135
|
RateLimitError: unknown;
|
130
136
|
/** Execution error occurred */
|
@@ -270,25 +276,21 @@ interface external$1 {
|
|
270
276
|
* @description Defines a binding from a resource data value to a component parameter value. Do not use.
|
271
277
|
*/
|
272
278
|
ComponentParameterBinding: {
|
273
|
-
/**
|
274
|
-
|
275
|
-
* a map of JSON Pointers in the target parameter to JSON Pointers in the source resource data.
|
276
|
-
* Used to bind to object-type values.
|
277
|
-
* e.g. { "/prop1/thing": "/res1/things/value" } would set the target parameter's `value` to
|
278
|
-
* {
|
279
|
-
* prop1: {
|
280
|
-
* thing: "value of /res1/things/value resource"
|
281
|
-
* }
|
282
|
-
* }
|
283
|
-
*/
|
284
|
-
pointer: string | {
|
285
|
-
[key: string]: string;
|
286
|
-
};
|
279
|
+
/** @description A JSON Pointer expression that defines the binding directly to the parameter value */
|
280
|
+
pointer: string;
|
287
281
|
/**
|
288
282
|
* @description The syntax of the binding (currently always 'jptr')
|
289
283
|
* @enum {string}
|
290
284
|
*/
|
291
285
|
syntax: "jptr";
|
286
|
+
/**
|
287
|
+
* @description Whether the binding should cause an error if it cannot be resolved.
|
288
|
+
* If true, and the binding cannot be resolved, an error will be returned by the binding process.
|
289
|
+
* If false, and the binding cannot be resolved, the parameter will be removed from the bound composition.
|
290
|
+
*
|
291
|
+
* @default false
|
292
|
+
*/
|
293
|
+
required?: boolean;
|
292
294
|
};
|
293
295
|
/** @description Defines the shape of a component instance served by the composition API. */
|
294
296
|
ComponentInstance: {
|
@@ -304,12 +306,24 @@ interface external$1 {
|
|
304
306
|
slots?: {
|
305
307
|
[key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
|
306
308
|
};
|
309
|
+
/** @description Unique identifier of the component within the composition. This is not set unless specifically requested via `withComponentIDs` API parameter. */
|
310
|
+
_id?: string;
|
307
311
|
/** @description Indicates this component instance should be sourced from a pattern library pattern. */
|
308
312
|
_pattern?: string;
|
313
|
+
_data?: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinitions"];
|
314
|
+
/**
|
315
|
+
* @deprecated
|
316
|
+
* @description Data definitions coming from a pattern resolved for this component. Merged with _data during resolution.
|
317
|
+
* Means nothing for PUTs; it will be ignored.
|
318
|
+
*/
|
319
|
+
_patternData?: {
|
320
|
+
[key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinition"];
|
321
|
+
};
|
309
322
|
/**
|
310
323
|
* @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
|
311
324
|
* CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
|
312
325
|
* NOTFOUND: The pattern ID referenced could not be found. It may have been deleted, or not be published yet.
|
326
|
+
* Means nothing for PUTs; it will be ignored.
|
313
327
|
*
|
314
328
|
* @enum {string}
|
315
329
|
*/
|
@@ -335,6 +349,141 @@ interface external$1 {
|
|
335
349
|
_slug?: string | null;
|
336
350
|
/** @description Friendly name of this component. */
|
337
351
|
_name: string;
|
352
|
+
_data?: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinitions"];
|
353
|
+
};
|
354
|
+
/**
|
355
|
+
* @deprecated
|
356
|
+
* @description Basic information about an integration data connector (i.e. "Master environment of the stable space", "Yelp API", "Sanity dev dataset"). This data is provided to list responses.
|
357
|
+
*/
|
358
|
+
DataConnectionInfo: {
|
359
|
+
/** @description Public ID of the data connector */
|
360
|
+
id: string;
|
361
|
+
/** @description Display name of the data connector */
|
362
|
+
displayName: string;
|
363
|
+
/** @description The type of data connector this connects to (e.g. 'cms-items', provided by an intalled integration) */
|
364
|
+
connectorType: string;
|
365
|
+
/** @description Base resource URL of the data connector. No trailing slash. */
|
366
|
+
baseUrl?: string;
|
367
|
+
};
|
368
|
+
/**
|
369
|
+
* @deprecated
|
370
|
+
* @description An instance of an integration data connector (i.e. "Master environment of the stable space", "Yelp API", "Sanity dev dataset"). These are created in the UI and shared across a whole project.
|
371
|
+
*/
|
372
|
+
DataConnection: {
|
373
|
+
/** @description Public ID of the data connector */
|
374
|
+
id: string;
|
375
|
+
/** @description Display name of the data connector */
|
376
|
+
displayName: string;
|
377
|
+
/** @description The type of data connector this connects to (e.g. 'cms-items', provided by an intalled integration) */
|
378
|
+
connectorType: string;
|
379
|
+
/** @description Base resource URL of the data connector. No trailing slash. */
|
380
|
+
baseUrl: string;
|
381
|
+
/** @description HTTP headers to pass with requests to the data connector */
|
382
|
+
headers?: {
|
383
|
+
[key: string]: string;
|
384
|
+
};
|
385
|
+
/** @description Query String parameters to pass with requests to the data connector */
|
386
|
+
parameters?: {
|
387
|
+
[key: string]: string;
|
388
|
+
};
|
389
|
+
/** @description Variables needed to make calls to the data connector */
|
390
|
+
variables?: {
|
391
|
+
[key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataVariable"];
|
392
|
+
};
|
393
|
+
/** @description Custom configuration specific to the data connection being defined */
|
394
|
+
custom?: {
|
395
|
+
[key: string]: unknown;
|
396
|
+
};
|
397
|
+
};
|
398
|
+
/**
|
399
|
+
* @deprecated
|
400
|
+
* @description A specific type of data that a Data Connection can provide (i.e. "Recipe", "Recipes List by Tag", "Yelp Reviews of My Restaurant"). These are created in the UI and shared a whole project.
|
401
|
+
*/
|
402
|
+
DataType: {
|
403
|
+
/** @description Public ID of the data connector */
|
404
|
+
id: string;
|
405
|
+
/** @description Display name of the data connector */
|
406
|
+
displayName: string;
|
407
|
+
/** @description Public ID of the associated data connector */
|
408
|
+
connectionId: string;
|
409
|
+
/**
|
410
|
+
* @description A connector-specific archetype for this data type; used to select UI as well as perform any
|
411
|
+
* necessary post-processing on the response. e.g. 'cms-entry', 'cms-query'. Can be undefined if
|
412
|
+
* no special UI or processing is required.
|
413
|
+
*/
|
414
|
+
archetype?: string;
|
415
|
+
/** @description Resource path, appended to the data connection's baseUrl (e.g. baseUrl = https://base.url, path = /v1/endpoint -> final URL https://base.url/v1/endpoint). Must have leading slash. */
|
416
|
+
path: string;
|
417
|
+
/** @description HTTP headers to pass with requests to the data connector */
|
418
|
+
headers?: {
|
419
|
+
[key: string]: string;
|
420
|
+
};
|
421
|
+
/** @description Query String parameters to pass with requests to the data connector */
|
422
|
+
parameters?: {
|
423
|
+
[key: string]: string;
|
424
|
+
};
|
425
|
+
/** @description Body to pass with requests to the data connector */
|
426
|
+
body?: string;
|
427
|
+
/**
|
428
|
+
* @description HTTP method to use with requests to the data connector.
|
429
|
+
* @default GET
|
430
|
+
* @enum {string}
|
431
|
+
*/
|
432
|
+
method: "GET" | "POST" | "HEAD";
|
433
|
+
/** @description Variables needed to make calls to the data connector */
|
434
|
+
variables?: {
|
435
|
+
[key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataVariable"];
|
436
|
+
};
|
437
|
+
/** @description Custom configuration specific to the data connection being defined */
|
438
|
+
custom?: {
|
439
|
+
[key: string]: unknown;
|
440
|
+
};
|
441
|
+
};
|
442
|
+
/**
|
443
|
+
* @deprecated
|
444
|
+
* @description Defines the shape of a data variable on a Data Connector or Data Type
|
445
|
+
*/
|
446
|
+
DataVariable: {
|
447
|
+
/** @description Display name of the data variable */
|
448
|
+
displayName?: string;
|
449
|
+
/**
|
450
|
+
* @description Type of the data variable
|
451
|
+
* @default text
|
452
|
+
*/
|
453
|
+
type: string;
|
454
|
+
/** @description Default value of the data variable */
|
455
|
+
default: string;
|
456
|
+
/**
|
457
|
+
* @description Where the variable value is set. Static = set to static value by the author. Dynamic = set to a dynamic value by a runtime API request from the frontend (default is used in the editor).
|
458
|
+
* @enum {string}
|
459
|
+
*/
|
460
|
+
setBy: "static" | "dynamic";
|
461
|
+
};
|
462
|
+
/**
|
463
|
+
* @deprecated
|
464
|
+
* @description Data definitions attached to this component. The property name is the key of the data in the data document.
|
465
|
+
* Note: data definitions are inherited from ancestors at runtime (and may be overridden by descendants that use the same key).
|
466
|
+
*/
|
467
|
+
CompositionDataDefinitions: {
|
468
|
+
[key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinition"];
|
469
|
+
};
|
470
|
+
/**
|
471
|
+
* @deprecated
|
472
|
+
* @description Data definition attached to this component
|
473
|
+
*/
|
474
|
+
CompositionDataDefinition: {
|
475
|
+
/** @description Public ID of the data type that provides this data */
|
476
|
+
type: string;
|
477
|
+
/** @description Whether this data is a pattern parameter that has to be overridden when a pattern is referenced on another composition. If this is not a pattern composition, this has no meaning and should not be used. If unspecified, the default is false. */
|
478
|
+
isPatternParameter?: boolean;
|
479
|
+
variables?: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataVariables"];
|
480
|
+
};
|
481
|
+
/**
|
482
|
+
* @deprecated
|
483
|
+
* @description Static variable values for this composition.
|
484
|
+
*/
|
485
|
+
CompositionDataVariables: {
|
486
|
+
[key: string]: string;
|
338
487
|
};
|
339
488
|
};
|
340
489
|
};
|
@@ -477,25 +626,21 @@ interface components$1 {
|
|
477
626
|
* @description Defines a binding from a resource data value to a component parameter value. Do not use.
|
478
627
|
*/
|
479
628
|
ComponentParameterBinding: {
|
480
|
-
/**
|
481
|
-
|
482
|
-
* a map of JSON Pointers in the target parameter to JSON Pointers in the source resource data.
|
483
|
-
* Used to bind to object-type values.
|
484
|
-
* e.g. { "/prop1/thing": "/res1/things/value" } would set the target parameter's `value` to
|
485
|
-
* {
|
486
|
-
* prop1: {
|
487
|
-
* thing: "value of /res1/things/value resource"
|
488
|
-
* }
|
489
|
-
* }
|
490
|
-
*/
|
491
|
-
pointer: string | {
|
492
|
-
[key: string]: string;
|
493
|
-
};
|
629
|
+
/** @description A JSON Pointer expression that defines the binding directly to the parameter value */
|
630
|
+
pointer: string;
|
494
631
|
/**
|
495
632
|
* @description The syntax of the binding (currently always 'jptr')
|
496
633
|
* @enum {string}
|
497
634
|
*/
|
498
635
|
syntax: "jptr";
|
636
|
+
/**
|
637
|
+
* @description Whether the binding should cause an error if it cannot be resolved.
|
638
|
+
* If true, and the binding cannot be resolved, an error will be returned by the binding process.
|
639
|
+
* If false, and the binding cannot be resolved, the parameter will be removed from the bound composition.
|
640
|
+
*
|
641
|
+
* @default false
|
642
|
+
*/
|
643
|
+
required?: boolean;
|
499
644
|
};
|
500
645
|
/** @description Defines the shape of a component instance served by the composition API. */
|
501
646
|
ComponentInstance: {
|
@@ -511,12 +656,24 @@ interface components$1 {
|
|
511
656
|
slots?: {
|
512
657
|
[key: string]: components$1["schemas"]["ComponentInstance"][];
|
513
658
|
};
|
659
|
+
/** @description Unique identifier of the component within the composition. This is not set unless specifically requested via `withComponentIDs` API parameter. */
|
660
|
+
_id?: string;
|
514
661
|
/** @description Indicates this component instance should be sourced from a pattern library pattern. */
|
515
662
|
_pattern?: string;
|
663
|
+
_data?: components$1["schemas"]["CompositionDataDefinitions"];
|
664
|
+
/**
|
665
|
+
* @deprecated
|
666
|
+
* @description Data definitions coming from a pattern resolved for this component. Merged with _data during resolution.
|
667
|
+
* Means nothing for PUTs; it will be ignored.
|
668
|
+
*/
|
669
|
+
_patternData?: {
|
670
|
+
[key: string]: components$1["schemas"]["CompositionDataDefinition"];
|
671
|
+
};
|
516
672
|
/**
|
517
673
|
* @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
|
518
674
|
* CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
|
519
675
|
* NOTFOUND: The pattern ID referenced could not be found. It may have been deleted, or not be published yet.
|
676
|
+
* Means nothing for PUTs; it will be ignored.
|
520
677
|
*
|
521
678
|
* @enum {string}
|
522
679
|
*/
|
@@ -542,6 +699,141 @@ interface components$1 {
|
|
542
699
|
_slug?: string | null;
|
543
700
|
/** @description Friendly name of this component. */
|
544
701
|
_name: string;
|
702
|
+
_data?: components$1["schemas"]["CompositionDataDefinitions"];
|
703
|
+
};
|
704
|
+
/**
|
705
|
+
* @deprecated
|
706
|
+
* @description Basic information about an integration data connector (i.e. "Master environment of the stable space", "Yelp API", "Sanity dev dataset"). This data is provided to list responses.
|
707
|
+
*/
|
708
|
+
DataConnectionInfo: {
|
709
|
+
/** @description Public ID of the data connector */
|
710
|
+
id: string;
|
711
|
+
/** @description Display name of the data connector */
|
712
|
+
displayName: string;
|
713
|
+
/** @description The type of data connector this connects to (e.g. 'cms-items', provided by an intalled integration) */
|
714
|
+
connectorType: string;
|
715
|
+
/** @description Base resource URL of the data connector. No trailing slash. */
|
716
|
+
baseUrl?: string;
|
717
|
+
};
|
718
|
+
/**
|
719
|
+
* @deprecated
|
720
|
+
* @description An instance of an integration data connector (i.e. "Master environment of the stable space", "Yelp API", "Sanity dev dataset"). These are created in the UI and shared across a whole project.
|
721
|
+
*/
|
722
|
+
DataConnection: {
|
723
|
+
/** @description Public ID of the data connector */
|
724
|
+
id: string;
|
725
|
+
/** @description Display name of the data connector */
|
726
|
+
displayName: string;
|
727
|
+
/** @description The type of data connector this connects to (e.g. 'cms-items', provided by an intalled integration) */
|
728
|
+
connectorType: string;
|
729
|
+
/** @description Base resource URL of the data connector. No trailing slash. */
|
730
|
+
baseUrl: string;
|
731
|
+
/** @description HTTP headers to pass with requests to the data connector */
|
732
|
+
headers?: {
|
733
|
+
[key: string]: string;
|
734
|
+
};
|
735
|
+
/** @description Query String parameters to pass with requests to the data connector */
|
736
|
+
parameters?: {
|
737
|
+
[key: string]: string;
|
738
|
+
};
|
739
|
+
/** @description Variables needed to make calls to the data connector */
|
740
|
+
variables?: {
|
741
|
+
[key: string]: components$1["schemas"]["DataVariable"];
|
742
|
+
};
|
743
|
+
/** @description Custom configuration specific to the data connection being defined */
|
744
|
+
custom?: {
|
745
|
+
[key: string]: unknown;
|
746
|
+
};
|
747
|
+
};
|
748
|
+
/**
|
749
|
+
* @deprecated
|
750
|
+
* @description A specific type of data that a Data Connection can provide (i.e. "Recipe", "Recipes List by Tag", "Yelp Reviews of My Restaurant"). These are created in the UI and shared a whole project.
|
751
|
+
*/
|
752
|
+
DataType: {
|
753
|
+
/** @description Public ID of the data connector */
|
754
|
+
id: string;
|
755
|
+
/** @description Display name of the data connector */
|
756
|
+
displayName: string;
|
757
|
+
/** @description Public ID of the associated data connector */
|
758
|
+
connectionId: string;
|
759
|
+
/**
|
760
|
+
* @description A connector-specific archetype for this data type; used to select UI as well as perform any
|
761
|
+
* necessary post-processing on the response. e.g. 'cms-entry', 'cms-query'. Can be undefined if
|
762
|
+
* no special UI or processing is required.
|
763
|
+
*/
|
764
|
+
archetype?: string;
|
765
|
+
/** @description Resource path, appended to the data connection's baseUrl (e.g. baseUrl = https://base.url, path = /v1/endpoint -> final URL https://base.url/v1/endpoint). Must have leading slash. */
|
766
|
+
path: string;
|
767
|
+
/** @description HTTP headers to pass with requests to the data connector */
|
768
|
+
headers?: {
|
769
|
+
[key: string]: string;
|
770
|
+
};
|
771
|
+
/** @description Query String parameters to pass with requests to the data connector */
|
772
|
+
parameters?: {
|
773
|
+
[key: string]: string;
|
774
|
+
};
|
775
|
+
/** @description Body to pass with requests to the data connector */
|
776
|
+
body?: string;
|
777
|
+
/**
|
778
|
+
* @description HTTP method to use with requests to the data connector.
|
779
|
+
* @default GET
|
780
|
+
* @enum {string}
|
781
|
+
*/
|
782
|
+
method: "GET" | "POST" | "HEAD";
|
783
|
+
/** @description Variables needed to make calls to the data connector */
|
784
|
+
variables?: {
|
785
|
+
[key: string]: components$1["schemas"]["DataVariable"];
|
786
|
+
};
|
787
|
+
/** @description Custom configuration specific to the data connection being defined */
|
788
|
+
custom?: {
|
789
|
+
[key: string]: unknown;
|
790
|
+
};
|
791
|
+
};
|
792
|
+
/**
|
793
|
+
* @deprecated
|
794
|
+
* @description Defines the shape of a data variable on a Data Connector or Data Type
|
795
|
+
*/
|
796
|
+
DataVariable: {
|
797
|
+
/** @description Display name of the data variable */
|
798
|
+
displayName?: string;
|
799
|
+
/**
|
800
|
+
* @description Type of the data variable
|
801
|
+
* @default text
|
802
|
+
*/
|
803
|
+
type: string;
|
804
|
+
/** @description Default value of the data variable */
|
805
|
+
default: string;
|
806
|
+
/**
|
807
|
+
* @description Where the variable value is set. Static = set to static value by the author. Dynamic = set to a dynamic value by a runtime API request from the frontend (default is used in the editor).
|
808
|
+
* @enum {string}
|
809
|
+
*/
|
810
|
+
setBy: "static" | "dynamic";
|
811
|
+
};
|
812
|
+
/**
|
813
|
+
* @deprecated
|
814
|
+
* @description Data definitions attached to this component. The property name is the key of the data in the data document.
|
815
|
+
* Note: data definitions are inherited from ancestors at runtime (and may be overridden by descendants that use the same key).
|
816
|
+
*/
|
817
|
+
CompositionDataDefinitions: {
|
818
|
+
[key: string]: components$1["schemas"]["CompositionDataDefinition"];
|
819
|
+
};
|
820
|
+
/**
|
821
|
+
* @deprecated
|
822
|
+
* @description Data definition attached to this component
|
823
|
+
*/
|
824
|
+
CompositionDataDefinition: {
|
825
|
+
/** @description Public ID of the data type that provides this data */
|
826
|
+
type: string;
|
827
|
+
/** @description Whether this data is a pattern parameter that has to be overridden when a pattern is referenced on another composition. If this is not a pattern composition, this has no meaning and should not be used. If unspecified, the default is false. */
|
828
|
+
isPatternParameter?: boolean;
|
829
|
+
variables?: components$1["schemas"]["CompositionDataVariables"];
|
830
|
+
};
|
831
|
+
/**
|
832
|
+
* @deprecated
|
833
|
+
* @description Static variable values for this composition.
|
834
|
+
*/
|
835
|
+
CompositionDataVariables: {
|
836
|
+
[key: string]: string;
|
545
837
|
};
|
546
838
|
};
|
547
839
|
}
|
@@ -594,10 +886,12 @@ interface paths {
|
|
594
886
|
projectId: string;
|
595
887
|
/** Specify a single composition ID to fetch. Changes response from list to single. */
|
596
888
|
compositionId?: string;
|
889
|
+
/** Specify multiple composition IDs to fetch. Response type will be a list. */
|
890
|
+
compositionIDs?: string[];
|
597
891
|
/** Specify a single composition to fetch by slug. Changes response from list to single. */
|
598
892
|
slug?: string;
|
599
|
-
/** The component type to filter by */
|
600
|
-
type?: string;
|
893
|
+
/** The component type (by public ID) to filter by. Note that this filters the root composition type only; components in slots are not matched by this filter. */
|
894
|
+
type?: string[];
|
601
895
|
/** State of compositions to fetch. 0 = draft, 64 = published. */
|
602
896
|
state?: number;
|
603
897
|
/** Number of records to skip */
|
@@ -605,7 +899,7 @@ interface paths {
|
|
605
899
|
/** Max number of records to return */
|
606
900
|
limit?: number;
|
607
901
|
/**
|
608
|
-
* Signals an enhancer proxy to skip processing enhancements to the data and return raw data only.
|
902
|
+
* @deprecated Signals an enhancer proxy to skip processing enhancements to the data and return raw data only.
|
609
903
|
* This improves performance if you do not require enhanced component data.
|
610
904
|
* If calling the Canvas API directly with no enhancer proxy, this has no effect.
|
611
905
|
*/
|
@@ -616,6 +910,39 @@ interface paths {
|
|
616
910
|
* data embedded into it, and serialize the pattern data separately.
|
617
911
|
*/
|
618
912
|
skipPatternResolution?: boolean;
|
913
|
+
/**
|
914
|
+
* If true the `_id` unique identifier of each non-root component will be part of the response data.
|
915
|
+
* If false, the `_id` will not be present in the API response.
|
916
|
+
*/
|
917
|
+
withComponentIDs?: boolean;
|
918
|
+
/**
|
919
|
+
* Matches compositions where their name, slug, or definition name contains the specified keyword.
|
920
|
+
* NOT a full text search; does not match composition contents.
|
921
|
+
*/
|
922
|
+
keyword?: string;
|
923
|
+
/**
|
924
|
+
* Matches compositions based on whether they are a pattern composition or a regular composition.
|
925
|
+
* If true, only pattern compositions will be returned.
|
926
|
+
* If false, only regular compositions will be returned.
|
927
|
+
* If omitted, both pattern and regular compositions will be returned.
|
928
|
+
*/
|
929
|
+
pattern?: boolean;
|
930
|
+
/** Sets the sorting of the results. If unspecified, results are sorted by name ascending. */
|
931
|
+
orderBy?: ("updated_at_DESC" | "updated_at_ASC" | "created_at_DESC" | "created_at_ASC" | "name_DESC" | "name_ASC" | "slug_DESC" | "slug_ASC")[];
|
932
|
+
/**
|
933
|
+
* @deprecated Returns the UI status string of the composition.
|
934
|
+
* This internal status is subject to change without notice, and is thus marked deprecated to discourage use of internal data.
|
935
|
+
*/
|
936
|
+
withUIStatus?: boolean;
|
937
|
+
/**
|
938
|
+
* @deprecated Filters composition lists by the UI status of the composition.
|
939
|
+
* This internal status is subject to change without notice, and is thus marked deprecated to discourage use of internal data.
|
940
|
+
*/
|
941
|
+
uiStatus?: ("Draft" | "Modified" | "Published" | "Orphan")[];
|
942
|
+
/** Filters composition lists by the user who created them. The user is specified by their identity subject. */
|
943
|
+
createdBy?: string;
|
944
|
+
/** Filters composition lists by the user who last updated them. The user is specified by their identity subject. */
|
945
|
+
updatedBy?: string;
|
619
946
|
};
|
620
947
|
};
|
621
948
|
responses: {
|
@@ -717,6 +1044,12 @@ interface components {
|
|
717
1044
|
CompositionApiResponse: {
|
718
1045
|
/** @description State of compositions to fetch. 0 = draft, 64 = published. */
|
719
1046
|
state: number;
|
1047
|
+
/**
|
1048
|
+
* @deprecated
|
1049
|
+
* @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withUIStatus` option is true.
|
1050
|
+
* @enum {string}
|
1051
|
+
*/
|
1052
|
+
uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
|
720
1053
|
/**
|
721
1054
|
* Format: uuid
|
722
1055
|
* @description The project ID that this layout data is part of
|
@@ -770,6 +1103,12 @@ interface external {
|
|
770
1103
|
"application/json": external["swagger.yml"]["components"]["schemas"]["Error"];
|
771
1104
|
};
|
772
1105
|
};
|
1106
|
+
/** Resource not found */
|
1107
|
+
NotFoundError: {
|
1108
|
+
content: {
|
1109
|
+
"application/json": external["swagger.yml"]["components"]["schemas"]["Error"];
|
1110
|
+
};
|
1111
|
+
};
|
773
1112
|
/** Too many requests in allowed time period */
|
774
1113
|
RateLimitError: unknown;
|
775
1114
|
/** Execution error occurred */
|
@@ -915,25 +1254,21 @@ interface external {
|
|
915
1254
|
* @description Defines a binding from a resource data value to a component parameter value. Do not use.
|
916
1255
|
*/
|
917
1256
|
ComponentParameterBinding: {
|
918
|
-
/**
|
919
|
-
|
920
|
-
* a map of JSON Pointers in the target parameter to JSON Pointers in the source resource data.
|
921
|
-
* Used to bind to object-type values.
|
922
|
-
* e.g. { "/prop1/thing": "/res1/things/value" } would set the target parameter's `value` to
|
923
|
-
* {
|
924
|
-
* prop1: {
|
925
|
-
* thing: "value of /res1/things/value resource"
|
926
|
-
* }
|
927
|
-
* }
|
928
|
-
*/
|
929
|
-
pointer: string | {
|
930
|
-
[key: string]: string;
|
931
|
-
};
|
1257
|
+
/** @description A JSON Pointer expression that defines the binding directly to the parameter value */
|
1258
|
+
pointer: string;
|
932
1259
|
/**
|
933
1260
|
* @description The syntax of the binding (currently always 'jptr')
|
934
1261
|
* @enum {string}
|
935
1262
|
*/
|
936
1263
|
syntax: "jptr";
|
1264
|
+
/**
|
1265
|
+
* @description Whether the binding should cause an error if it cannot be resolved.
|
1266
|
+
* If true, and the binding cannot be resolved, an error will be returned by the binding process.
|
1267
|
+
* If false, and the binding cannot be resolved, the parameter will be removed from the bound composition.
|
1268
|
+
*
|
1269
|
+
* @default false
|
1270
|
+
*/
|
1271
|
+
required?: boolean;
|
937
1272
|
};
|
938
1273
|
/** @description Defines the shape of a component instance served by the composition API. */
|
939
1274
|
ComponentInstance: {
|
@@ -949,12 +1284,24 @@ interface external {
|
|
949
1284
|
slots?: {
|
950
1285
|
[key: string]: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
|
951
1286
|
};
|
1287
|
+
/** @description Unique identifier of the component within the composition. This is not set unless specifically requested via `withComponentIDs` API parameter. */
|
1288
|
+
_id?: string;
|
952
1289
|
/** @description Indicates this component instance should be sourced from a pattern library pattern. */
|
953
1290
|
_pattern?: string;
|
1291
|
+
_data?: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinitions"];
|
1292
|
+
/**
|
1293
|
+
* @deprecated
|
1294
|
+
* @description Data definitions coming from a pattern resolved for this component. Merged with _data during resolution.
|
1295
|
+
* Means nothing for PUTs; it will be ignored.
|
1296
|
+
*/
|
1297
|
+
_patternData?: {
|
1298
|
+
[key: string]: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinition"];
|
1299
|
+
};
|
954
1300
|
/**
|
955
1301
|
* @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
|
956
1302
|
* CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
|
957
1303
|
* NOTFOUND: The pattern ID referenced could not be found. It may have been deleted, or not be published yet.
|
1304
|
+
* Means nothing for PUTs; it will be ignored.
|
958
1305
|
*
|
959
1306
|
* @enum {string}
|
960
1307
|
*/
|
@@ -980,6 +1327,141 @@ interface external {
|
|
980
1327
|
_slug?: string | null;
|
981
1328
|
/** @description Friendly name of this component. */
|
982
1329
|
_name: string;
|
1330
|
+
_data?: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinitions"];
|
1331
|
+
};
|
1332
|
+
/**
|
1333
|
+
* @deprecated
|
1334
|
+
* @description Basic information about an integration data connector (i.e. "Master environment of the stable space", "Yelp API", "Sanity dev dataset"). This data is provided to list responses.
|
1335
|
+
*/
|
1336
|
+
DataConnectionInfo: {
|
1337
|
+
/** @description Public ID of the data connector */
|
1338
|
+
id: string;
|
1339
|
+
/** @description Display name of the data connector */
|
1340
|
+
displayName: string;
|
1341
|
+
/** @description The type of data connector this connects to (e.g. 'cms-items', provided by an intalled integration) */
|
1342
|
+
connectorType: string;
|
1343
|
+
/** @description Base resource URL of the data connector. No trailing slash. */
|
1344
|
+
baseUrl?: string;
|
1345
|
+
};
|
1346
|
+
/**
|
1347
|
+
* @deprecated
|
1348
|
+
* @description An instance of an integration data connector (i.e. "Master environment of the stable space", "Yelp API", "Sanity dev dataset"). These are created in the UI and shared across a whole project.
|
1349
|
+
*/
|
1350
|
+
DataConnection: {
|
1351
|
+
/** @description Public ID of the data connector */
|
1352
|
+
id: string;
|
1353
|
+
/** @description Display name of the data connector */
|
1354
|
+
displayName: string;
|
1355
|
+
/** @description The type of data connector this connects to (e.g. 'cms-items', provided by an intalled integration) */
|
1356
|
+
connectorType: string;
|
1357
|
+
/** @description Base resource URL of the data connector. No trailing slash. */
|
1358
|
+
baseUrl: string;
|
1359
|
+
/** @description HTTP headers to pass with requests to the data connector */
|
1360
|
+
headers?: {
|
1361
|
+
[key: string]: string;
|
1362
|
+
};
|
1363
|
+
/** @description Query String parameters to pass with requests to the data connector */
|
1364
|
+
parameters?: {
|
1365
|
+
[key: string]: string;
|
1366
|
+
};
|
1367
|
+
/** @description Variables needed to make calls to the data connector */
|
1368
|
+
variables?: {
|
1369
|
+
[key: string]: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataVariable"];
|
1370
|
+
};
|
1371
|
+
/** @description Custom configuration specific to the data connection being defined */
|
1372
|
+
custom?: {
|
1373
|
+
[key: string]: unknown;
|
1374
|
+
};
|
1375
|
+
};
|
1376
|
+
/**
|
1377
|
+
* @deprecated
|
1378
|
+
* @description A specific type of data that a Data Connection can provide (i.e. "Recipe", "Recipes List by Tag", "Yelp Reviews of My Restaurant"). These are created in the UI and shared a whole project.
|
1379
|
+
*/
|
1380
|
+
DataType: {
|
1381
|
+
/** @description Public ID of the data connector */
|
1382
|
+
id: string;
|
1383
|
+
/** @description Display name of the data connector */
|
1384
|
+
displayName: string;
|
1385
|
+
/** @description Public ID of the associated data connector */
|
1386
|
+
connectionId: string;
|
1387
|
+
/**
|
1388
|
+
* @description A connector-specific archetype for this data type; used to select UI as well as perform any
|
1389
|
+
* necessary post-processing on the response. e.g. 'cms-entry', 'cms-query'. Can be undefined if
|
1390
|
+
* no special UI or processing is required.
|
1391
|
+
*/
|
1392
|
+
archetype?: string;
|
1393
|
+
/** @description Resource path, appended to the data connection's baseUrl (e.g. baseUrl = https://base.url, path = /v1/endpoint -> final URL https://base.url/v1/endpoint). Must have leading slash. */
|
1394
|
+
path: string;
|
1395
|
+
/** @description HTTP headers to pass with requests to the data connector */
|
1396
|
+
headers?: {
|
1397
|
+
[key: string]: string;
|
1398
|
+
};
|
1399
|
+
/** @description Query String parameters to pass with requests to the data connector */
|
1400
|
+
parameters?: {
|
1401
|
+
[key: string]: string;
|
1402
|
+
};
|
1403
|
+
/** @description Body to pass with requests to the data connector */
|
1404
|
+
body?: string;
|
1405
|
+
/**
|
1406
|
+
* @description HTTP method to use with requests to the data connector.
|
1407
|
+
* @default GET
|
1408
|
+
* @enum {string}
|
1409
|
+
*/
|
1410
|
+
method: "GET" | "POST" | "HEAD";
|
1411
|
+
/** @description Variables needed to make calls to the data connector */
|
1412
|
+
variables?: {
|
1413
|
+
[key: string]: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataVariable"];
|
1414
|
+
};
|
1415
|
+
/** @description Custom configuration specific to the data connection being defined */
|
1416
|
+
custom?: {
|
1417
|
+
[key: string]: unknown;
|
1418
|
+
};
|
1419
|
+
};
|
1420
|
+
/**
|
1421
|
+
* @deprecated
|
1422
|
+
* @description Defines the shape of a data variable on a Data Connector or Data Type
|
1423
|
+
*/
|
1424
|
+
DataVariable: {
|
1425
|
+
/** @description Display name of the data variable */
|
1426
|
+
displayName?: string;
|
1427
|
+
/**
|
1428
|
+
* @description Type of the data variable
|
1429
|
+
* @default text
|
1430
|
+
*/
|
1431
|
+
type: string;
|
1432
|
+
/** @description Default value of the data variable */
|
1433
|
+
default: string;
|
1434
|
+
/**
|
1435
|
+
* @description Where the variable value is set. Static = set to static value by the author. Dynamic = set to a dynamic value by a runtime API request from the frontend (default is used in the editor).
|
1436
|
+
* @enum {string}
|
1437
|
+
*/
|
1438
|
+
setBy: "static" | "dynamic";
|
1439
|
+
};
|
1440
|
+
/**
|
1441
|
+
* @deprecated
|
1442
|
+
* @description Data definitions attached to this component. The property name is the key of the data in the data document.
|
1443
|
+
* Note: data definitions are inherited from ancestors at runtime (and may be overridden by descendants that use the same key).
|
1444
|
+
*/
|
1445
|
+
CompositionDataDefinitions: {
|
1446
|
+
[key: string]: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinition"];
|
1447
|
+
};
|
1448
|
+
/**
|
1449
|
+
* @deprecated
|
1450
|
+
* @description Data definition attached to this component
|
1451
|
+
*/
|
1452
|
+
CompositionDataDefinition: {
|
1453
|
+
/** @description Public ID of the data type that provides this data */
|
1454
|
+
type: string;
|
1455
|
+
/** @description Whether this data is a pattern parameter that has to be overridden when a pattern is referenced on another composition. If this is not a pattern composition, this has no meaning and should not be used. If unspecified, the default is false. */
|
1456
|
+
isPatternParameter?: boolean;
|
1457
|
+
variables?: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataVariables"];
|
1458
|
+
};
|
1459
|
+
/**
|
1460
|
+
* @deprecated
|
1461
|
+
* @description Static variable values for this composition.
|
1462
|
+
*/
|
1463
|
+
CompositionDataVariables: {
|
1464
|
+
[key: string]: string;
|
983
1465
|
};
|
984
1466
|
};
|
985
1467
|
};
|
@@ -991,9 +1473,14 @@ declare type Components = components['schemas'];
|
|
991
1473
|
declare type SharedComponents = components$1['schemas'];
|
992
1474
|
declare type Api = paths['/api/v1/canvas'];
|
993
1475
|
/** Query parameter options for GET /api/v1/canvas */
|
994
|
-
declare type CompositionGetParameters = Api['get']['parameters']['query']
|
1476
|
+
declare type CompositionGetParameters = Omit<Api['get']['parameters']['query'], 'type'> & {
|
1477
|
+
type?: string | string[];
|
1478
|
+
};
|
1479
|
+
declare type CompositionGetOrderBy = NonNullable<Api['get']['parameters']['query']['orderBy']>[0];
|
995
1480
|
/** The GET response from /api/v1/canvas when `component` or `slug` params are specified */
|
996
1481
|
declare type CompositionGetResponse = Components['CompositionApiResponse'];
|
1482
|
+
/** @deprecated - internal use, do not rely on this value */
|
1483
|
+
declare type CompositionUIStatus = NonNullable<Components['CompositionApiResponse']['uiStatus']>;
|
997
1484
|
/** The GET response from /api/v1/canvas when `component` or `slug` are not specified */
|
998
1485
|
declare type CompositionGetListResponse = Components['CompositionListResponse'];
|
999
1486
|
/** The PUT request body for /api/v1/canvas */
|
@@ -1015,6 +1502,12 @@ declare type ComponentParameter<TValue = unknown> = Omit<SharedComponents['Compo
|
|
1015
1502
|
};
|
1016
1503
|
/** Defines a binding from a resource data value to a component parameter value. */
|
1017
1504
|
declare type ComponentParameterBinding = SharedComponents['ComponentParameterBinding'];
|
1505
|
+
/** Variables defined for this composition. */
|
1506
|
+
declare type CompositionDataVariables = SharedComponents['CompositionDataVariables'];
|
1507
|
+
/** Defines the shape of a resource bound to a composition */
|
1508
|
+
declare type CompositionDataDefinitions = SharedComponents['CompositionDataDefinitions'];
|
1509
|
+
/** Defines the shape of a resource bound to a composition */
|
1510
|
+
declare type CompositionDataDefinition = SharedComponents['CompositionDataDefinition'];
|
1018
1511
|
/** Defines the shape of a component instance served by the composition API. */
|
1019
1512
|
declare type ComponentInstance = SharedComponents['ComponentInstance'] & {
|
1020
1513
|
/** Data for the component instance, provided by a component enhancer. Never set in unenhanced data. */
|
@@ -1053,4 +1546,4 @@ declare global {
|
|
1053
1546
|
*/
|
1054
1547
|
declare function createEventBus(): Promise<PreviewEventBus | undefined>;
|
1055
1548
|
|
1056
|
-
export {
|
1549
|
+
export { CompositionListAPIResponse as A, CompositionAPIOptions as B, ComponentInstance as C, ComponentParameterBinding as D, CompositionDataVariables as E, CompositionDataDefinitions as F, CompositionDataDefinition as G, CanvasDefinitions as H, ChannelSubscription as I, createEventBus as J, PreviewEventBus as P, RootComponentInstance as R, ComponentParameter as a, CompositionGetParameters as b, components$1 as c, CompositionPutParameters as d, CompositionDeleteParameters as e, ComponentDefinitionGetParameters as f, ComponentDefinitionPutParameters as g, ComponentDefinitionDeleteParameters as h, ComponentDefinitionGetResponse as i, ComponentDefinitionAPIResponse as j, ComponentDefinitionAPIPutRequest as k, ComponentDefinitionAPIDeleteRequest as l, ComponentDefinitionListAPIOptions as m, ComponentDefinitionParameter as n, ComponentDefinitionVariant as o, ComponentDefinitionSlugSettings as p, ComponentDefinitionSlot as q, ComponentDefinitionPermission as r, ComponentDefinition as s, CreatingComponentDefinition as t, CompositionGetOrderBy as u, CompositionGetResponse as v, CompositionUIStatus as w, CompositionGetListResponse as x, CompositionAPIResponse as y, CompositionAPIDeleteRequest as z };
|