@amp-labs/react 2.7.11 → 2.7.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/build/index.d.ts CHANGED
@@ -1,7 +1,8 @@
1
- import { Config } from '../../generated-sources/api/src';
2
- import { Connection } from '../../generated-sources/api/src';
3
1
  import { default as default_2 } from 'react';
2
+ import { Dispatch } from 'react';
4
3
  import { JSX as JSX_2 } from 'react/jsx-runtime';
4
+ import { SetStateAction } from 'react';
5
+ import { UseQueryResult } from '@tanstack/react-query';
5
6
 
6
7
  export declare const AmpersandContext: default_2.Context<null>;
7
8
 
@@ -24,9 +25,478 @@ declare interface AmpersandProviderProps {
24
25
  children: default_2.ReactNode;
25
26
  }
26
27
 
27
- export { Config }
28
+ /**
29
+ *
30
+ * @export
31
+ * @interface Backfill
32
+ */
33
+ declare interface Backfill {
34
+ /**
35
+ *
36
+ * @type {DefaultPeriod}
37
+ * @memberof Backfill
38
+ */
39
+ defaultPeriod: DefaultPeriod;
40
+ }
41
+
42
+ /**
43
+ *
44
+ * @export
45
+ * @interface BackfillConfig
46
+ */
47
+ declare interface BackfillConfig {
48
+ /**
49
+ *
50
+ * @type {DefaultPeriodConfig}
51
+ * @memberof BackfillConfig
52
+ */
53
+ defaultPeriod: DefaultPeriodConfig;
54
+ }
55
+
56
+ /**
57
+ * Ampersand public API
58
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
59
+ *
60
+ * The version of the OpenAPI document: 1.0.0
61
+ *
62
+ *
63
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
64
+ * https://openapi-generator.tech
65
+ * Do not edit the class manually.
66
+ */
67
+ /**
68
+ *
69
+ * @export
70
+ * @interface BaseProxyConfig
71
+ */
72
+ declare interface BaseProxyConfig {
73
+ /**
74
+ *
75
+ * @type {boolean}
76
+ * @memberof BaseProxyConfig
77
+ */
78
+ enabled?: boolean;
79
+ }
80
+
81
+ /**
82
+ *
83
+ * @export
84
+ * @interface BaseReadConfigObject
85
+ */
86
+ declare interface BaseReadConfigObject {
87
+ /**
88
+ * The name of the object to read from.
89
+ * @type {string}
90
+ * @memberof BaseReadConfigObject
91
+ */
92
+ objectName?: string;
93
+ /**
94
+ * The schedule for reading the object, in cron syntax.
95
+ * @type {string}
96
+ * @memberof BaseReadConfigObject
97
+ */
98
+ schedule?: string;
99
+ /**
100
+ * The name of the destination that the result should be sent to.
101
+ * @type {string}
102
+ * @memberof BaseReadConfigObject
103
+ */
104
+ destination?: string;
105
+ /**
106
+ * This is a map of field names to booleans indicating whether they should be read. If a field is already included in `selectedFieldMappings`, it does not need to be included here.
107
+ * @type {{ [key: string]: boolean; }}
108
+ * @memberof BaseReadConfigObject
109
+ */
110
+ selectedFields?: {
111
+ [key: string]: boolean;
112
+ };
113
+ /**
114
+ * This is a map of field names to their value mappings.
115
+ * @type {{ [key: string]: { [key: string]: string; }; }}
116
+ * @memberof BaseReadConfigObject
117
+ */
118
+ selectedValueMappings?: {
119
+ [key: string]: {
120
+ [key: string]: string;
121
+ };
122
+ };
123
+ /**
124
+ * This is a map of mapToNames to field names. (A mapTo name is the name the builder wants to map a field to when it lands in their destination.)
125
+ * @type {{ [key: string]: string; }}
126
+ * @memberof BaseReadConfigObject
127
+ */
128
+ selectedFieldMappings?: {
129
+ [key: string]: string;
130
+ };
131
+ /**
132
+ *
133
+ * @type {SelectedFieldsAutoConfig}
134
+ * @memberof BaseReadConfigObject
135
+ */
136
+ selectedFieldsAuto?: SelectedFieldsAutoConfig;
137
+ /**
138
+ *
139
+ * @type {BackfillConfig}
140
+ * @memberof BaseReadConfigObject
141
+ */
142
+ backfill?: BackfillConfig;
143
+ }
144
+
145
+ /**
146
+ *
147
+ * @export
148
+ * @interface BaseWriteConfigObject
149
+ */
150
+ declare interface BaseWriteConfigObject {
151
+ /**
152
+ * The name of the object to write to.
153
+ * @type {string}
154
+ * @memberof BaseWriteConfigObject
155
+ */
156
+ objectName: string;
157
+ /**
158
+ * This is a map of field names to default values. These values will be used when writing to the object.
159
+ * @type {{ [key: string]: ValueDefault; }}
160
+ * @memberof BaseWriteConfigObject
161
+ * @deprecated
162
+ */
163
+ selectedValueDefaults?: {
164
+ [key: string]: ValueDefault;
165
+ };
166
+ /**
167
+ * This is a map of field names to their settings.
168
+ * @type {{ [key: string]: FieldSetting; }}
169
+ * @memberof BaseWriteConfigObject
170
+ */
171
+ selectedFieldSettings?: {
172
+ [key: string]: FieldSetting;
173
+ };
174
+ }
175
+
176
+ /**
177
+ *
178
+ * @export
179
+ * @interface Config
180
+ */
181
+ export declare interface Config {
182
+ /**
183
+ * The config ID.
184
+ * @type {string}
185
+ * @memberof Config
186
+ */
187
+ id: string;
188
+ /**
189
+ * The ID of the revision that this config is based on.
190
+ * @type {string}
191
+ * @memberof Config
192
+ */
193
+ revisionId: string;
194
+ /**
195
+ * The time the config was created.
196
+ * @type {Date}
197
+ * @memberof Config
198
+ */
199
+ createTime: Date;
200
+ /**
201
+ * The person who created the config, in the format of "consumer:{consumer-id}" or "builder:{builder-id}".
202
+ * @type {string}
203
+ * @memberof Config
204
+ */
205
+ createdBy: string;
206
+ /**
207
+ *
208
+ * @type {ConfigContent}
209
+ * @memberof Config
210
+ */
211
+ content: ConfigContent;
212
+ }
213
+
214
+ /**
215
+ *
216
+ * @export
217
+ * @interface ConfigContent
218
+ */
219
+ declare interface ConfigContent {
220
+ /**
221
+ * The SaaS API that we are integrating with.
222
+ * @type {string}
223
+ * @memberof ConfigContent
224
+ */
225
+ provider: string;
226
+ /**
227
+ *
228
+ * @type {ReadConfig}
229
+ * @memberof ConfigContent
230
+ */
231
+ read?: ReadConfig;
232
+ /**
233
+ *
234
+ * @type {WriteConfig}
235
+ * @memberof ConfigContent
236
+ */
237
+ write?: WriteConfig;
238
+ /**
239
+ *
240
+ * @type {BaseProxyConfig}
241
+ * @memberof ConfigContent
242
+ */
243
+ proxy?: BaseProxyConfig;
244
+ /**
245
+ *
246
+ * @type {SubscribeConfig}
247
+ * @memberof ConfigContent
248
+ */
249
+ subscribe?: SubscribeConfig;
250
+ }
251
+
252
+ /**
253
+ * Ampersand public API
254
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
255
+ *
256
+ * The version of the OpenAPI document: 1.0.0
257
+ *
258
+ *
259
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
260
+ * https://openapi-generator.tech
261
+ * Do not edit the class manually.
262
+ */
263
+ /**
264
+ *
265
+ * @export
266
+ * @interface ConfigCreateEvent
267
+ */
268
+ declare interface ConfigCreateEvent {
269
+ /**
270
+ * Conditions to enable create events.
271
+ * @type {string}
272
+ * @memberof ConfigCreateEvent
273
+ */
274
+ enabled: ConfigCreateEventEnabledEnum;
275
+ }
276
+
277
+ /**
278
+ * @export
279
+ */
280
+ declare const ConfigCreateEventEnabledEnum: {
281
+ readonly Always: "always";
282
+ };
283
+
284
+ declare type ConfigCreateEventEnabledEnum = typeof ConfigCreateEventEnabledEnum[keyof typeof ConfigCreateEventEnabledEnum];
285
+
286
+ /**
287
+ * Ampersand public API
288
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
289
+ *
290
+ * The version of the OpenAPI document: 1.0.0
291
+ *
292
+ *
293
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
294
+ * https://openapi-generator.tech
295
+ * Do not edit the class manually.
296
+ */
297
+ /**
298
+ *
299
+ * @export
300
+ * @interface ConfigDeleteEvent
301
+ */
302
+ declare interface ConfigDeleteEvent {
303
+ /**
304
+ * Conditions to enable delete events.
305
+ * @type {string}
306
+ * @memberof ConfigDeleteEvent
307
+ */
308
+ enabled: ConfigDeleteEventEnabledEnum;
309
+ }
310
+
311
+ /**
312
+ * @export
313
+ */
314
+ declare const ConfigDeleteEventEnabledEnum: {
315
+ readonly Always: "always";
316
+ };
317
+
318
+ declare type ConfigDeleteEventEnabledEnum = typeof ConfigDeleteEventEnabledEnum[keyof typeof ConfigDeleteEventEnabledEnum];
319
+
320
+ /**
321
+ * Ampersand public API
322
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
323
+ *
324
+ * The version of the OpenAPI document: 1.0.0
325
+ *
326
+ *
327
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
328
+ * https://openapi-generator.tech
329
+ * Do not edit the class manually.
330
+ */
331
+ /**
332
+ *
333
+ * @export
334
+ * @interface ConfigUpdateEvent
335
+ */
336
+ declare interface ConfigUpdateEvent {
337
+ /**
338
+ * Conditions to enable update events.
339
+ * @type {string}
340
+ * @memberof ConfigUpdateEvent
341
+ */
342
+ enabled: ConfigUpdateEventEnabledEnum;
343
+ /**
344
+ * Whether to watch fields all fields automatically.
345
+ * @type {string}
346
+ * @memberof ConfigUpdateEvent
347
+ */
348
+ watchFieldsAuto?: ConfigUpdateEventWatchFieldsAutoEnum;
349
+ /**
350
+ * The fields that should be watched.
351
+ * @type {Array<string>}
352
+ * @memberof ConfigUpdateEvent
353
+ */
354
+ requiredWatchFields?: Array<string>;
355
+ }
356
+
357
+ /**
358
+ * @export
359
+ */
360
+ declare const ConfigUpdateEventEnabledEnum: {
361
+ readonly Always: "always";
362
+ };
363
+
364
+ declare type ConfigUpdateEventEnabledEnum = typeof ConfigUpdateEventEnabledEnum[keyof typeof ConfigUpdateEventEnabledEnum];
365
+
366
+ /**
367
+ * @export
368
+ */
369
+ declare const ConfigUpdateEventWatchFieldsAutoEnum: {
370
+ readonly All: "all";
371
+ };
372
+
373
+ declare type ConfigUpdateEventWatchFieldsAutoEnum = typeof ConfigUpdateEventWatchFieldsAutoEnum[keyof typeof ConfigUpdateEventWatchFieldsAutoEnum];
374
+
375
+ /**
376
+ *
377
+ * @export
378
+ * @interface Connection
379
+ */
380
+ export declare interface Connection {
381
+ /**
382
+ * The connection ID.
383
+ * @type {string}
384
+ * @memberof Connection
385
+ */
386
+ id: string;
387
+ /**
388
+ * The Ampersand project ID.
389
+ * @type {string}
390
+ * @memberof Connection
391
+ */
392
+ projectId: string;
393
+ /**
394
+ * The SaaS provider that this Connection is for.
395
+ * @type {string}
396
+ * @memberof Connection
397
+ */
398
+ provider: string;
399
+ /**
400
+ *
401
+ * @type {ProviderApp}
402
+ * @memberof Connection
403
+ */
404
+ providerApp?: ProviderApp;
405
+ /**
406
+ *
407
+ * @type {Group}
408
+ * @memberof Connection
409
+ */
410
+ group: Group;
411
+ /**
412
+ *
413
+ * @type {Consumer}
414
+ * @memberof Connection
415
+ */
416
+ consumer: Consumer;
417
+ /**
418
+ * If available, the identifier for the provider workspace (e.g. the Salesforce subdomain)
419
+ * @type {string}
420
+ * @memberof Connection
421
+ */
422
+ providerWorkspaceRef?: string;
423
+ /**
424
+ * If available, the ID that Salesforce/Hubspot uses to identify this user (e.g. Salesforce has IDs in the form of https://login.salesforce.com/id/00D4x0000019CQTEA2/0054x000000orJ4AA)
425
+ * @type {string}
426
+ * @memberof Connection
427
+ */
428
+ providerConsumerRef?: string;
429
+ /**
430
+ * The time the connection was created.
431
+ * @type {Date}
432
+ * @memberof Connection
433
+ */
434
+ createTime: Date;
435
+ /**
436
+ * The time the connection was last updated.
437
+ * @type {Date}
438
+ * @memberof Connection
439
+ */
440
+ updateTime?: Date;
441
+ /**
442
+ * The authentication scheme used for this connection.
443
+ * @type {string}
444
+ * @memberof Connection
445
+ */
446
+ authScheme: ConnectionAuthSchemeEnum;
447
+ /**
448
+ * The status of the connection.
449
+ * @type {string}
450
+ * @memberof Connection
451
+ */
452
+ status: ConnectionStatusEnum;
453
+ /**
454
+ *
455
+ * @type {Oauth2AuthorizationCodeTokensOnly}
456
+ * @memberof Connection
457
+ */
458
+ oauth2AuthorizationCode?: Oauth2AuthorizationCodeTokensOnly;
459
+ /**
460
+ * The API key used while making the connection.
461
+ * @type {string}
462
+ * @memberof Connection
463
+ */
464
+ apiKey?: string;
465
+ /**
466
+ *
467
+ * @type {{ [key: string]: ProviderMetadataInfo; }}
468
+ * @memberof Connection
469
+ */
470
+ providerMetadata?: {
471
+ [key: string]: ProviderMetadataInfo;
472
+ };
473
+ }
474
+
475
+ /**
476
+ * @export
477
+ */
478
+ declare const ConnectionAuthSchemeEnum: {
479
+ readonly None: "none";
480
+ readonly ApiKey: "apiKey";
481
+ readonly Basic: "basic";
482
+ readonly Oauth2AuthorizationCode: "oauth2/authorizationCode";
483
+ readonly Oauth2AuthorizationCodePkce: "oauth2/authorizationCodePKCE";
484
+ readonly Oauth2ClientCredentials: "oauth2/clientCredentials";
485
+ readonly Oauth2Password: "oauth2/password";
486
+ };
487
+
488
+ declare type ConnectionAuthSchemeEnum = typeof ConnectionAuthSchemeEnum[keyof typeof ConnectionAuthSchemeEnum];
489
+
490
+ /**
491
+ * @export
492
+ */
493
+ declare const ConnectionStatusEnum: {
494
+ readonly Created: "created";
495
+ readonly Working: "working";
496
+ readonly BadCredentials: "bad_credentials";
497
+ };
28
498
 
29
- export { Connection }
499
+ declare type ConnectionStatusEnum = typeof ConnectionStatusEnum[keyof typeof ConnectionStatusEnum];
30
500
 
31
501
  export declare function ConnectProvider({ provider, consumerRef, consumerName, groupRef, groupName, redirectUrl, onSuccess, onDisconnectSuccess, onConnectSuccess, }: ConnectProviderProps): JSX_2.Element;
32
502
 
@@ -54,6 +524,117 @@ declare interface ConnectProviderProps {
54
524
  onDisconnectSuccess?: (connection: Connection) => void;
55
525
  }
56
526
 
527
+ /**
528
+ * Ampersand public API
529
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
530
+ *
531
+ * The version of the OpenAPI document: 1.0.0
532
+ *
533
+ *
534
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
535
+ * https://openapi-generator.tech
536
+ * Do not edit the class manually.
537
+ */
538
+ /**
539
+ *
540
+ * @export
541
+ * @interface Consumer
542
+ */
543
+ declare interface Consumer {
544
+ /**
545
+ * The consumer reference.
546
+ * @type {string}
547
+ * @memberof Consumer
548
+ */
549
+ consumerRef: string;
550
+ /**
551
+ * The name of the consumer.
552
+ * @type {string}
553
+ * @memberof Consumer
554
+ */
555
+ consumerName: string;
556
+ /**
557
+ * The Ampersand project ID.
558
+ * @type {string}
559
+ * @memberof Consumer
560
+ */
561
+ projectId: string;
562
+ /**
563
+ * The time the consumer was created.
564
+ * @type {Date}
565
+ * @memberof Consumer
566
+ */
567
+ createTime: Date;
568
+ /**
569
+ * The time the consumer was last updated.
570
+ * @type {Date}
571
+ * @memberof Consumer
572
+ */
573
+ updateTime?: Date;
574
+ }
575
+
576
+ /**
577
+ * Ampersand public API
578
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
579
+ *
580
+ * The version of the OpenAPI document: 1.0.0
581
+ *
582
+ *
583
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
584
+ * https://openapi-generator.tech
585
+ * Do not edit the class manually.
586
+ */
587
+ /**
588
+ *
589
+ * @export
590
+ * @interface DefaultPeriod
591
+ */
592
+ declare interface DefaultPeriod {
593
+ /**
594
+ * Number of days in past to backfill from. 0 is no backfill. e.g) if 10, then backfill last 10 days of data. Required if fullHistory is not set.
595
+ * @type {number}
596
+ * @memberof DefaultPeriod
597
+ */
598
+ days?: number;
599
+ /**
600
+ * If true, backfill all history. Required if days is not set.
601
+ * @type {boolean}
602
+ * @memberof DefaultPeriod
603
+ */
604
+ fullHistory?: boolean;
605
+ }
606
+
607
+ /**
608
+ * Ampersand public API
609
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
610
+ *
611
+ * The version of the OpenAPI document: 1.0.0
612
+ *
613
+ *
614
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
615
+ * https://openapi-generator.tech
616
+ * Do not edit the class manually.
617
+ */
618
+ /**
619
+ *
620
+ * @export
621
+ * @interface DefaultPeriodConfig
622
+ */
623
+ declare interface DefaultPeriodConfig {
624
+ /**
625
+ * Number of days in past to backfill from. 0 is no backfill. e.g) if 10, then backfill last 10 days of data. Required if fullHistory is not set.
626
+ * @type {number}
627
+ * @memberof DefaultPeriodConfig
628
+ */
629
+ days?: number;
630
+ /**
631
+ * If true, backfill all history. Required if days is not set.
632
+ * @type {boolean}
633
+ * @memberof DefaultPeriodConfig
634
+ */
635
+ fullHistory?: boolean;
636
+ }
637
+
57
638
  /**
58
639
  * A map of object names to FieldMappingEntry arrays, with each FieldMappingEntry representing a field.
59
640
  */
@@ -85,53 +666,1477 @@ export declare type FieldMappingEntry = {
85
666
  fieldName?: string;
86
667
  };
87
668
 
88
- export declare function InstallIntegration({ integration, consumerRef, consumerName, groupRef, groupName, onInstallSuccess, onUpdateSuccess, onUninstallSuccess, fieldMapping, }: InstallIntegrationProps): JSX_2.Element;
89
-
90
- declare interface InstallIntegrationProps {
669
+ /**
670
+ *
671
+ * @export
672
+ * @interface FieldMetadata
673
+ */
674
+ declare interface FieldMetadata {
91
675
  /**
92
- * The name of the integration from amp.yaml
676
+ * The name of the field from the provider API.
677
+ * @type {string}
678
+ * @memberof FieldMetadata
93
679
  */
94
- integration: string;
680
+ fieldName: string;
95
681
  /**
96
- * The ID that your app uses to identify this end user.
682
+ * The display name of the field from the provider API.
683
+ * @type {string}
684
+ * @memberof FieldMetadata
97
685
  */
98
- consumerRef: string;
686
+ displayName: string;
99
687
  /**
100
- * The display name that your app uses for this end user.
688
+ * A normalized field type
689
+ * @type {string}
690
+ * @memberof FieldMetadata
101
691
  */
102
- consumerName?: string;
692
+ valueType?: FieldMetadataValueTypeEnum;
103
693
  /**
104
- * The ID that your app uses to identify the user's company, org, or team.
694
+ * Raw field type from the provider API.
695
+ * @type {string}
696
+ * @memberof FieldMetadata
105
697
  */
106
- groupRef: string;
698
+ providerType?: string;
107
699
  /**
108
- * The display name that your app uses for this company, org or team.
700
+ * Whether the field is read-only.
701
+ * @type {boolean}
702
+ * @memberof FieldMetadata
109
703
  */
110
- groupName?: string;
704
+ readOnly?: boolean;
111
705
  /**
112
- * Dynamic field mappings that need to be filled out by a consumer.
113
- * @experimental
706
+ * If the valueType is singleSelect or multiSelect, this is a list of possible values
707
+ * @type {Array<FieldValue>}
708
+ * @memberof FieldMetadata
114
709
  */
115
- fieldMapping?: FieldMapping;
116
- onInstallSuccess?: (installationId: string, config: Config) => void;
117
- onUpdateSuccess?: (installationId: string, config: Config) => void;
118
- onUninstallSuccess?: (installationId: string) => void;
710
+ values?: Array<FieldValue>;
119
711
  }
120
712
 
121
- declare interface MappedValue {
122
- mappedValue: string;
123
- mappedDisplayValue: string;
124
- }
713
+ /**
714
+ * @export
715
+ */
716
+ declare const FieldMetadataValueTypeEnum: {
717
+ readonly String: "string";
718
+ readonly Boolean: "boolean";
719
+ readonly SingleSelect: "singleSelect";
720
+ readonly MultiSelect: "multiSelect";
721
+ readonly Date: "date";
722
+ readonly Datetime: "datetime";
723
+ readonly Int: "int";
724
+ readonly Float: "float";
725
+ readonly Other: "other";
726
+ };
125
727
 
126
- export declare function useAmpersandProvider(): never;
728
+ declare type FieldMetadataValueTypeEnum = typeof FieldMetadataValueTypeEnum[keyof typeof FieldMetadataValueTypeEnum];
127
729
 
128
- export declare const useIsIntegrationInstalled: (integration: string, groupRef: string) => UseIsIntegrationInstalledResult;
730
+ /**
731
+ *
732
+ * @export
733
+ * @interface FieldSetting
734
+ */
735
+ declare interface FieldSetting {
736
+ /**
737
+ *
738
+ * @type {FieldSettingDefault}
739
+ * @memberof FieldSetting
740
+ */
741
+ _default?: FieldSettingDefault;
742
+ /**
743
+ * Whether the default value should be applied when creating a record.
744
+ * @type {string}
745
+ * @memberof FieldSetting
746
+ */
747
+ writeOnCreate?: FieldSettingWriteOnCreateEnum;
748
+ /**
749
+ * Whether the default value should be applied when updating a record.
750
+ * @type {string}
751
+ * @memberof FieldSetting
752
+ */
753
+ writeOnUpdate?: FieldSettingWriteOnUpdateEnum;
754
+ }
129
755
 
130
- declare interface UseIsIntegrationInstalledResult {
131
- isLoading: boolean;
132
- isLoaded: boolean;
756
+ /**
757
+ * Ampersand public API
758
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
759
+ *
760
+ * The version of the OpenAPI document: 1.0.0
761
+ *
762
+ *
763
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
764
+ * https://openapi-generator.tech
765
+ * Do not edit the class manually.
766
+ */
767
+ /**
768
+ * Only use one of stringValue, integerValue, booleanValue.
769
+ * @export
770
+ * @interface FieldSettingDefault
771
+ */
772
+ declare interface FieldSettingDefault {
773
+ /**
774
+ * The default string value to apply to a field
775
+ * @type {string}
776
+ * @memberof FieldSettingDefault
777
+ */
778
+ stringValue?: string;
779
+ /**
780
+ * The default integer value to apply to a field
781
+ * @type {number}
782
+ * @memberof FieldSettingDefault
783
+ */
784
+ integerValue?: number;
785
+ /**
786
+ * The default boolean value to apply to a field
787
+ * @type {boolean}
788
+ * @memberof FieldSettingDefault
789
+ */
790
+ booleanValue?: boolean;
791
+ }
792
+
793
+ /**
794
+ * @export
795
+ */
796
+ declare const FieldSettingWriteOnCreateEnum: {
797
+ readonly Always: "always";
798
+ readonly Never: "never";
799
+ };
800
+
801
+ declare type FieldSettingWriteOnCreateEnum = typeof FieldSettingWriteOnCreateEnum[keyof typeof FieldSettingWriteOnCreateEnum];
802
+
803
+ /**
804
+ * @export
805
+ */
806
+ declare const FieldSettingWriteOnUpdateEnum: {
807
+ readonly Always: "always";
808
+ readonly Never: "never";
809
+ };
810
+
811
+ declare type FieldSettingWriteOnUpdateEnum = typeof FieldSettingWriteOnUpdateEnum[keyof typeof FieldSettingWriteOnUpdateEnum];
812
+
813
+ /**
814
+ * Ampersand public API
815
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
816
+ *
817
+ * The version of the OpenAPI document: 1.0.0
818
+ *
819
+ *
820
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
821
+ * https://openapi-generator.tech
822
+ * Do not edit the class manually.
823
+ */
824
+ /**
825
+ * Represents a field value
826
+ * @export
827
+ * @interface FieldValue
828
+ */
829
+ declare interface FieldValue {
830
+ /**
831
+ * The internal value used by the system
832
+ * @type {string}
833
+ * @memberof FieldValue
834
+ */
835
+ value: string;
836
+ /**
837
+ * The human-readable display value
838
+ * @type {string}
839
+ * @memberof FieldValue
840
+ */
841
+ displayValue: string;
842
+ }
843
+
844
+ /**
845
+ * Ampersand public API
846
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
847
+ *
848
+ * The version of the OpenAPI document: 1.0.0
849
+ *
850
+ *
851
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
852
+ * https://openapi-generator.tech
853
+ * Do not edit the class manually.
854
+ */
855
+ /**
856
+ *
857
+ * @export
858
+ * @interface Group
859
+ */
860
+ declare interface Group {
861
+ /**
862
+ * The ID of the user group that has access to this installation.
863
+ * @type {string}
864
+ * @memberof Group
865
+ */
866
+ groupRef: string;
867
+ /**
868
+ * The name of the user group that has access to this installation.
869
+ * @type {string}
870
+ * @memberof Group
871
+ */
872
+ groupName: string;
873
+ /**
874
+ * The Ampersand project ID.
875
+ * @type {string}
876
+ * @memberof Group
877
+ */
878
+ projectId: string;
879
+ /**
880
+ * The time the group was created.
881
+ * @type {Date}
882
+ * @memberof Group
883
+ */
884
+ createTime: Date;
885
+ /**
886
+ * The time the group was last updated.
887
+ * @type {Date}
888
+ * @memberof Group
889
+ */
890
+ updateTime?: Date;
891
+ }
892
+
893
+ /**
894
+ *
895
+ * @export
896
+ * @interface HydratedIntegration
897
+ */
898
+ declare interface HydratedIntegration {
899
+ /**
900
+ *
901
+ * @type {string}
902
+ * @memberof HydratedIntegration
903
+ */
904
+ name: string;
905
+ /**
906
+ *
907
+ * @type {string}
908
+ * @memberof HydratedIntegration
909
+ */
910
+ displayName?: string;
911
+ /**
912
+ *
913
+ * @type {string}
914
+ * @memberof HydratedIntegration
915
+ */
916
+ provider: string;
917
+ /**
918
+ *
919
+ * @type {HydratedIntegrationRead}
920
+ * @memberof HydratedIntegration
921
+ */
922
+ read?: HydratedIntegrationRead;
923
+ /**
924
+ *
925
+ * @type {HydratedIntegrationWrite}
926
+ * @memberof HydratedIntegration
927
+ */
928
+ write?: HydratedIntegrationWrite;
929
+ /**
930
+ *
931
+ * @type {HydratedIntegrationProxy}
932
+ * @memberof HydratedIntegration
933
+ */
934
+ proxy?: HydratedIntegrationProxy;
935
+ }
936
+
937
+ /**
938
+ * @type HydratedIntegrationField
939
+ *
940
+ * @export
941
+ */
942
+ declare type HydratedIntegrationField = HydratedIntegrationFieldExistent | IntegrationFieldMapping;
943
+
944
+ /**
945
+ * Ampersand public API
946
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
947
+ *
948
+ * The version of the OpenAPI document: 1.0.0
949
+ *
950
+ *
951
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
952
+ * https://openapi-generator.tech
953
+ * Do not edit the class manually.
954
+ */
955
+ /**
956
+ *
957
+ * @export
958
+ * @interface HydratedIntegrationFieldExistent
959
+ */
960
+ declare interface HydratedIntegrationFieldExistent {
961
+ /**
962
+ *
963
+ * @type {string}
964
+ * @memberof HydratedIntegrationFieldExistent
965
+ */
966
+ fieldName: string;
967
+ /**
968
+ *
969
+ * @type {string}
970
+ * @memberof HydratedIntegrationFieldExistent
971
+ */
972
+ displayName: string;
973
+ /**
974
+ * The field name to map to in the destination.
975
+ * @type {string}
976
+ * @memberof HydratedIntegrationFieldExistent
977
+ */
978
+ mapToName?: string;
979
+ /**
980
+ * The display name to map to in the destination.
981
+ * @type {string}
982
+ * @memberof HydratedIntegrationFieldExistent
983
+ */
984
+ mapToDisplayName?: string;
985
+ }
986
+
987
+ /**
988
+ *
989
+ * @export
990
+ * @interface HydratedIntegrationObject
991
+ */
992
+ declare interface HydratedIntegrationObject {
993
+ /**
994
+ * Error message if there was an issue hydrating this object.
995
+ * @type {string}
996
+ * @memberof HydratedIntegrationObject
997
+ */
998
+ error?: string;
999
+ /**
1000
+ *
1001
+ * @type {string}
1002
+ * @memberof HydratedIntegrationObject
1003
+ */
1004
+ objectName: string;
1005
+ /**
1006
+ *
1007
+ * @type {string}
1008
+ * @memberof HydratedIntegrationObject
1009
+ */
1010
+ displayName: string;
1011
+ /**
1012
+ * An object name to map to.
1013
+ * @type {string}
1014
+ * @memberof HydratedIntegrationObject
1015
+ */
1016
+ mapToName?: string;
1017
+ /**
1018
+ * A display name to map to.
1019
+ * @type {string}
1020
+ * @memberof HydratedIntegrationObject
1021
+ */
1022
+ mapToDisplayName?: string;
1023
+ /**
1024
+ *
1025
+ * @type {string}
1026
+ * @memberof HydratedIntegrationObject
1027
+ */
1028
+ destination: string;
1029
+ /**
1030
+ *
1031
+ * @type {string}
1032
+ * @memberof HydratedIntegrationObject
1033
+ */
1034
+ schedule: string;
1035
+ /**
1036
+ *
1037
+ * @type {Array<HydratedIntegrationField>}
1038
+ * @memberof HydratedIntegrationObject
1039
+ */
1040
+ requiredFields?: Array<HydratedIntegrationField>;
1041
+ /**
1042
+ *
1043
+ * @type {Array<HydratedIntegrationField>}
1044
+ * @memberof HydratedIntegrationObject
1045
+ */
1046
+ optionalFields?: Array<HydratedIntegrationField>;
1047
+ /**
1048
+ *
1049
+ * @type {OptionalFieldsAutoOption}
1050
+ * @memberof HydratedIntegrationObject
1051
+ */
1052
+ optionalFieldsAuto?: OptionalFieldsAutoOption;
1053
+ /**
1054
+ * This is a list of all fields on the object for a particular SaaS instance, including their display names.
1055
+ * @type {Array<HydratedIntegrationField>}
1056
+ * @memberof HydratedIntegrationObject
1057
+ */
1058
+ allFields?: Array<HydratedIntegrationField>;
1059
+ /**
1060
+ * This is a map of all fields on the object including their metadata (such as display name and type), the keys of the map are the field names.
1061
+ * @type {{ [key: string]: FieldMetadata; }}
1062
+ * @memberof HydratedIntegrationObject
1063
+ */
1064
+ allFieldsMetadata?: {
1065
+ [key: string]: FieldMetadata;
1066
+ };
1067
+ /**
1068
+ *
1069
+ * @type {Backfill}
1070
+ * @memberof HydratedIntegrationObject
1071
+ */
1072
+ backfill?: Backfill;
1073
+ }
1074
+
1075
+ /**
1076
+ * Ampersand public API
1077
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
1078
+ *
1079
+ * The version of the OpenAPI document: 1.0.0
1080
+ *
1081
+ *
1082
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
1083
+ * https://openapi-generator.tech
1084
+ * Do not edit the class manually.
1085
+ */
1086
+ /**
1087
+ *
1088
+ * @export
1089
+ * @interface HydratedIntegrationProxy
1090
+ */
1091
+ declare interface HydratedIntegrationProxy {
1092
+ /**
1093
+ *
1094
+ * @type {boolean}
1095
+ * @memberof HydratedIntegrationProxy
1096
+ */
1097
+ enabled?: boolean;
1098
+ }
1099
+
1100
+ /**
1101
+ *
1102
+ * @export
1103
+ * @interface HydratedIntegrationRead
1104
+ */
1105
+ declare interface HydratedIntegrationRead {
1106
+ /**
1107
+ *
1108
+ * @type {Array<HydratedIntegrationObject>}
1109
+ * @memberof HydratedIntegrationRead
1110
+ */
1111
+ objects?: Array<HydratedIntegrationObject>;
1112
+ }
1113
+
1114
+ /**
1115
+ *
1116
+ * @export
1117
+ * @interface HydratedIntegrationWrite
1118
+ */
1119
+ declare interface HydratedIntegrationWrite {
1120
+ /**
1121
+ *
1122
+ * @type {Array<HydratedIntegrationWriteObject>}
1123
+ * @memberof HydratedIntegrationWrite
1124
+ */
1125
+ objects?: Array<HydratedIntegrationWriteObject>;
1126
+ }
1127
+
1128
+ /**
1129
+ *
1130
+ * @export
1131
+ * @interface HydratedIntegrationWriteObject
1132
+ */
1133
+ declare interface HydratedIntegrationWriteObject {
1134
+ /**
1135
+ *
1136
+ * @type {string}
1137
+ * @memberof HydratedIntegrationWriteObject
1138
+ */
1139
+ objectName: string;
1140
+ /**
1141
+ *
1142
+ * @type {string}
1143
+ * @memberof HydratedIntegrationWriteObject
1144
+ */
1145
+ displayName: string;
1146
+ /**
1147
+ *
1148
+ * @type {ValueDefaults}
1149
+ * @memberof HydratedIntegrationWriteObject
1150
+ */
1151
+ valueDefaults?: ValueDefaults;
1152
+ }
1153
+
1154
+ /**
1155
+ *
1156
+ * @export
1157
+ * @interface HydratedRevision
1158
+ */
1159
+ declare interface HydratedRevision {
1160
+ /**
1161
+ * The revision ID.
1162
+ * @type {string}
1163
+ * @memberof HydratedRevision
1164
+ */
1165
+ id: string;
1166
+ /**
1167
+ * The spec version string.
1168
+ * @type {string}
1169
+ * @memberof HydratedRevision
1170
+ */
1171
+ specVersion: string;
1172
+ /**
1173
+ * The time the revision was created.
1174
+ * @type {Date}
1175
+ * @memberof HydratedRevision
1176
+ */
1177
+ createTime: Date;
1178
+ /**
1179
+ *
1180
+ * @type {HydratedIntegration}
1181
+ * @memberof HydratedRevision
1182
+ */
1183
+ content: HydratedIntegration;
1184
+ }
1185
+
1186
+ /**
1187
+ *
1188
+ * @export
1189
+ * @interface Installation
1190
+ */
1191
+ declare interface Installation {
1192
+ /**
1193
+ * The installation ID.
1194
+ * @type {string}
1195
+ * @memberof Installation
1196
+ */
1197
+ id: string;
1198
+ /**
1199
+ * The Ampersand project ID.
1200
+ * @type {string}
1201
+ * @memberof Installation
1202
+ */
1203
+ projectId: string;
1204
+ /**
1205
+ * The integration ID.
1206
+ * @type {string}
1207
+ * @memberof Installation
1208
+ */
1209
+ integrationId: string;
1210
+ /**
1211
+ *
1212
+ * @type {Group}
1213
+ * @memberof Installation
1214
+ */
1215
+ group?: Group;
1216
+ /**
1217
+ * The health status of the installation ("healthy", "unhealthy").
1218
+ * @type {string}
1219
+ * @memberof Installation
1220
+ */
1221
+ healthStatus: string;
1222
+ /**
1223
+ *
1224
+ * @type {Connection}
1225
+ * @memberof Installation
1226
+ */
1227
+ connection: Connection;
1228
+ /**
1229
+ * The time the integration was first installed.
1230
+ * @type {Date}
1231
+ * @memberof Installation
1232
+ */
1233
+ createTime: Date;
1234
+ /**
1235
+ * The person who did the installation, in the format of "consumer:{consumer-id}".
1236
+ * @type {string}
1237
+ * @memberof Installation
1238
+ */
1239
+ createdBy: string;
1240
+ /**
1241
+ * The time the installation was last updated with a new config.
1242
+ * @type {Date}
1243
+ * @memberof Installation
1244
+ */
1245
+ updateTime?: Date;
1246
+ /**
1247
+ *
1248
+ * @type {Config}
1249
+ * @memberof Installation
1250
+ */
1251
+ config: Config;
1252
+ }
1253
+
1254
+ /**
1255
+ * Bridge type for config content that can be used for both creation and updates.
1256
+ * This type makes all fields optional to match UpdateInstallationConfigContent,
1257
+ * but when used for creation, the provider field should be provided.
1258
+ */
1259
+ export declare type InstallationConfigContent = Partial<ConfigContent>;
1260
+
1261
+ declare interface InstallationContextValue {
1262
+ integrationNameOrId: string;
1263
+ consumerRef: string;
1264
+ consumerName?: string;
1265
+ groupRef: string;
1266
+ groupName?: string;
1267
+ }
1268
+
1269
+ export declare function InstallationProvider({ children, integration, consumerRef, consumerName, groupRef, groupName, }: InstallationProviderProps): JSX_2.Element;
1270
+
1271
+ declare interface InstallationProviderProps {
1272
+ integration: string;
1273
+ consumerRef: string;
1274
+ consumerName?: string;
1275
+ groupRef: string;
1276
+ groupName?: string;
1277
+ children: React.ReactNode;
1278
+ }
1279
+
1280
+ export declare function InstallIntegration({ integration, consumerRef, consumerName, groupRef, groupName, onInstallSuccess, onUpdateSuccess, onUninstallSuccess, fieldMapping, }: InstallIntegrationProps): JSX_2.Element;
1281
+
1282
+ declare interface InstallIntegrationProps {
1283
+ /**
1284
+ * The name of the integration from amp.yaml
1285
+ */
1286
+ integration: string;
1287
+ /**
1288
+ * The ID that your app uses to identify this end user.
1289
+ */
1290
+ consumerRef: string;
1291
+ /**
1292
+ * The display name that your app uses for this end user.
1293
+ */
1294
+ consumerName?: string;
1295
+ /**
1296
+ * The ID that your app uses to identify the user's company, org, or team.
1297
+ */
1298
+ groupRef: string;
1299
+ /**
1300
+ * The display name that your app uses for this company, org or team.
1301
+ */
1302
+ groupName?: string;
1303
+ /**
1304
+ * Dynamic field mappings that need to be filled out by a consumer.
1305
+ * @experimental
1306
+ */
1307
+ fieldMapping?: FieldMapping;
1308
+ onInstallSuccess?: (installationId: string, config: Config) => void;
1309
+ onUpdateSuccess?: (installationId: string, config: Config) => void;
1310
+ onUninstallSuccess?: (installationId: string) => void;
1311
+ }
1312
+
1313
+ /**
1314
+ * Ampersand public API
1315
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
1316
+ *
1317
+ * The version of the OpenAPI document: 1.0.0
1318
+ *
1319
+ *
1320
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
1321
+ * https://openapi-generator.tech
1322
+ * Do not edit the class manually.
1323
+ */
1324
+ /**
1325
+ *
1326
+ * @export
1327
+ * @interface IntegrationFieldMapping
1328
+ */
1329
+ declare interface IntegrationFieldMapping {
1330
+ /**
1331
+ *
1332
+ * @type {string}
1333
+ * @memberof IntegrationFieldMapping
1334
+ */
1335
+ mapToName: string;
1336
+ /**
1337
+ *
1338
+ * @type {string}
1339
+ * @memberof IntegrationFieldMapping
1340
+ */
1341
+ mapToDisplayName?: string;
1342
+ /**
1343
+ *
1344
+ * @type {string}
1345
+ * @memberof IntegrationFieldMapping
1346
+ */
1347
+ _default?: string;
1348
+ /**
1349
+ *
1350
+ * @type {string}
1351
+ * @memberof IntegrationFieldMapping
1352
+ */
1353
+ prompt?: string;
1354
+ }
1355
+
1356
+ declare interface MappedValue {
1357
+ mappedValue: string;
1358
+ mappedDisplayValue: string;
1359
+ }
1360
+
1361
+ /**
1362
+ *
1363
+ * @export
1364
+ * @interface Oauth2AuthorizationCodeTokensOnly
1365
+ */
1366
+ declare interface Oauth2AuthorizationCodeTokensOnly {
1367
+ /**
1368
+ *
1369
+ * @type {Oauth2AuthorizationCodeTokensOnlyAccessToken}
1370
+ * @memberof Oauth2AuthorizationCodeTokensOnly
1371
+ */
1372
+ accessToken?: Oauth2AuthorizationCodeTokensOnlyAccessToken;
1373
+ /**
1374
+ *
1375
+ * @type {Oauth2AuthorizationCodeTokensOnlyRefreshToken}
1376
+ * @memberof Oauth2AuthorizationCodeTokensOnly
1377
+ */
1378
+ refreshToken?: Oauth2AuthorizationCodeTokensOnlyRefreshToken;
1379
+ /**
1380
+ * The scopes for the tokens.
1381
+ * @type {Array<string>}
1382
+ * @memberof Oauth2AuthorizationCodeTokensOnly
1383
+ */
1384
+ scopes?: Array<string>;
1385
+ }
1386
+
1387
+ /**
1388
+ * Ampersand public API
1389
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
1390
+ *
1391
+ * The version of the OpenAPI document: 1.0.0
1392
+ *
1393
+ *
1394
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
1395
+ * https://openapi-generator.tech
1396
+ * Do not edit the class manually.
1397
+ */
1398
+ /**
1399
+ * The access token for the connection.
1400
+ * @export
1401
+ * @interface Oauth2AuthorizationCodeTokensOnlyAccessToken
1402
+ */
1403
+ declare interface Oauth2AuthorizationCodeTokensOnlyAccessToken {
1404
+ /**
1405
+ *
1406
+ * @type {string}
1407
+ * @memberof Oauth2AuthorizationCodeTokensOnlyAccessToken
1408
+ */
1409
+ token: string;
1410
+ /**
1411
+ *
1412
+ * @type {Date}
1413
+ * @memberof Oauth2AuthorizationCodeTokensOnlyAccessToken
1414
+ */
1415
+ issuedAt?: Date;
1416
+ /**
1417
+ *
1418
+ * @type {Date}
1419
+ * @memberof Oauth2AuthorizationCodeTokensOnlyAccessToken
1420
+ */
1421
+ expiresAt?: Date;
1422
+ }
1423
+
1424
+ /**
1425
+ * Ampersand public API
1426
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
1427
+ *
1428
+ * The version of the OpenAPI document: 1.0.0
1429
+ *
1430
+ *
1431
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
1432
+ * https://openapi-generator.tech
1433
+ * Do not edit the class manually.
1434
+ */
1435
+ /**
1436
+ * The refresh token to use for the connection.
1437
+ * @export
1438
+ * @interface Oauth2AuthorizationCodeTokensOnlyRefreshToken
1439
+ */
1440
+ declare interface Oauth2AuthorizationCodeTokensOnlyRefreshToken {
1441
+ /**
1442
+ *
1443
+ * @type {string}
1444
+ * @memberof Oauth2AuthorizationCodeTokensOnlyRefreshToken
1445
+ */
1446
+ token: string;
1447
+ /**
1448
+ *
1449
+ * @type {Date}
1450
+ * @memberof Oauth2AuthorizationCodeTokensOnlyRefreshToken
1451
+ */
1452
+ issuedAt?: Date;
1453
+ /**
1454
+ *
1455
+ * @type {Date}
1456
+ * @memberof Oauth2AuthorizationCodeTokensOnlyRefreshToken
1457
+ */
1458
+ expiresAt?: Date;
1459
+ }
1460
+
1461
+ /**
1462
+ *
1463
+ * @export
1464
+ */
1465
+ declare const OptionalFieldsAutoOption: {
1466
+ readonly All: "all";
1467
+ };
1468
+
1469
+ declare type OptionalFieldsAutoOption = typeof OptionalFieldsAutoOption[keyof typeof OptionalFieldsAutoOption];
1470
+
1471
+ /**
1472
+ * Ampersand public API
1473
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
1474
+ *
1475
+ * The version of the OpenAPI document: 1.0.0
1476
+ *
1477
+ *
1478
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
1479
+ * https://openapi-generator.tech
1480
+ * Do not edit the class manually.
1481
+ */
1482
+ /**
1483
+ *
1484
+ * @export
1485
+ * @interface ProviderApp
1486
+ */
1487
+ declare interface ProviderApp {
1488
+ /**
1489
+ * The provider app ID.
1490
+ * @type {string}
1491
+ * @memberof ProviderApp
1492
+ */
1493
+ id: string;
1494
+ /**
1495
+ * The Ampersand project ID.
1496
+ * @type {string}
1497
+ * @memberof ProviderApp
1498
+ */
1499
+ projectId: string;
1500
+ /**
1501
+ * The ID used by the provider to identify the app (optional).
1502
+ * @type {string}
1503
+ * @memberof ProviderApp
1504
+ */
1505
+ externalRef?: string;
1506
+ /**
1507
+ * The SaaS provider that this app connects to.
1508
+ * @type {string}
1509
+ * @memberof ProviderApp
1510
+ */
1511
+ provider: string;
1512
+ /**
1513
+ * The OAuth client ID for this app.
1514
+ * @type {string}
1515
+ * @memberof ProviderApp
1516
+ */
1517
+ clientId: string;
1518
+ /**
1519
+ * The OAuth scopes for this app.
1520
+ * @type {Array<string>}
1521
+ * @memberof ProviderApp
1522
+ */
1523
+ scopes?: Array<string>;
1524
+ /**
1525
+ * The time the provider app was created.
1526
+ * @type {Date}
1527
+ * @memberof ProviderApp
1528
+ */
1529
+ createTime: Date;
1530
+ /**
1531
+ * The time the provider app was updated.
1532
+ * @type {Date}
1533
+ * @memberof ProviderApp
1534
+ */
1535
+ updateTime?: Date;
1536
+ }
1537
+
1538
+ /**
1539
+ * Ampersand public API
1540
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
1541
+ *
1542
+ * The version of the OpenAPI document: 1.0.0
1543
+ *
1544
+ *
1545
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
1546
+ * https://openapi-generator.tech
1547
+ * Do not edit the class manually.
1548
+ */
1549
+ /**
1550
+ *
1551
+ * @export
1552
+ * @interface ProviderMetadataInfo
1553
+ */
1554
+ declare interface ProviderMetadataInfo {
1555
+ /**
1556
+ * The value of the metadata field
1557
+ * @type {string}
1558
+ * @memberof ProviderMetadataInfo
1559
+ */
1560
+ value: string;
1561
+ /**
1562
+ * The source of the metadata field
1563
+ * @type {string}
1564
+ * @memberof ProviderMetadataInfo
1565
+ */
1566
+ source: ProviderMetadataInfoSourceEnum;
1567
+ /**
1568
+ * The human-readable name for the field
1569
+ * @type {string}
1570
+ * @memberof ProviderMetadataInfo
1571
+ */
1572
+ displayName?: string;
1573
+ }
1574
+
1575
+ /**
1576
+ * @export
1577
+ */
1578
+ declare const ProviderMetadataInfoSourceEnum: {
1579
+ readonly Input: "input";
1580
+ readonly Token: "token";
1581
+ readonly Provider: "provider";
1582
+ };
1583
+
1584
+ declare type ProviderMetadataInfoSourceEnum = typeof ProviderMetadataInfoSourceEnum[keyof typeof ProviderMetadataInfoSourceEnum];
1585
+
1586
+ /**
1587
+ *
1588
+ * @export
1589
+ * @interface ReadConfig
1590
+ */
1591
+ declare interface ReadConfig {
1592
+ /**
1593
+ *
1594
+ * @type {{ [key: string]: ReadConfigObject; }}
1595
+ * @memberof ReadConfig
1596
+ */
1597
+ objects: {
1598
+ [key: string]: ReadConfigObject;
1599
+ };
1600
+ }
1601
+
1602
+ /**
1603
+ *
1604
+ * @export
1605
+ * @interface ReadConfigObject
1606
+ */
1607
+ declare interface ReadConfigObject {
1608
+ /**
1609
+ * The name of the object to read from.
1610
+ * @type {string}
1611
+ * @memberof ReadConfigObject
1612
+ */
1613
+ objectName: string;
1614
+ /**
1615
+ * The schedule for reading the object, in cron syntax.
1616
+ * @type {string}
1617
+ * @memberof ReadConfigObject
1618
+ */
1619
+ schedule: string;
1620
+ /**
1621
+ * The name of the destination that the result should be sent to.
1622
+ * @type {string}
1623
+ * @memberof ReadConfigObject
1624
+ */
1625
+ destination: string;
1626
+ /**
1627
+ * This is a map of field names to booleans indicating whether they should be read. If a field is already included in `selectedFieldMappings`, it does not need to be included here.
1628
+ * @type {{ [key: string]: boolean; }}
1629
+ * @memberof ReadConfigObject
1630
+ */
1631
+ selectedFields: {
1632
+ [key: string]: boolean;
1633
+ };
1634
+ /**
1635
+ * This is a map of field names to their value mappings.
1636
+ * @type {{ [key: string]: { [key: string]: string; }; }}
1637
+ * @memberof ReadConfigObject
1638
+ */
1639
+ selectedValueMappings?: {
1640
+ [key: string]: {
1641
+ [key: string]: string;
1642
+ };
1643
+ };
1644
+ /**
1645
+ * This is a map of mapToNames to field names. (A mapTo name is the name the builder wants to map a field to when it lands in their destination.)
1646
+ * @type {{ [key: string]: string; }}
1647
+ * @memberof ReadConfigObject
1648
+ */
1649
+ selectedFieldMappings: {
1650
+ [key: string]: string;
1651
+ };
1652
+ /**
1653
+ *
1654
+ * @type {SelectedFieldsAutoConfig}
1655
+ * @memberof ReadConfigObject
1656
+ */
1657
+ selectedFieldsAuto?: SelectedFieldsAutoConfig;
1658
+ /**
1659
+ *
1660
+ * @type {BackfillConfig}
1661
+ * @memberof ReadConfigObject
1662
+ */
1663
+ backfill?: BackfillConfig;
1664
+ }
1665
+
1666
+ /**
1667
+ * If selectedFieldsAuto is set to all, all fields will be read.
1668
+ * @export
1669
+ */
1670
+ declare const SelectedFieldsAutoConfig: {
1671
+ readonly SelectedFieldsAll: "all";
1672
+ };
1673
+
1674
+ declare type SelectedFieldsAutoConfig = typeof SelectedFieldsAutoConfig[keyof typeof SelectedFieldsAutoConfig];
1675
+
1676
+ /**
1677
+ *
1678
+ * @export
1679
+ * @interface SubscribeConfig
1680
+ */
1681
+ declare interface SubscribeConfig {
1682
+ /**
1683
+ *
1684
+ * @type {{ [key: string]: SubscribeConfigObject; }}
1685
+ * @memberof SubscribeConfig
1686
+ */
1687
+ objects: {
1688
+ [key: string]: SubscribeConfigObject;
1689
+ };
1690
+ }
1691
+
1692
+ /**
1693
+ *
1694
+ * @export
1695
+ * @interface SubscribeConfigObject
1696
+ */
1697
+ declare interface SubscribeConfigObject {
1698
+ /**
1699
+ * Whether to inherit fields and mappings from the read config.
1700
+ * @type {boolean}
1701
+ * @memberof SubscribeConfigObject
1702
+ */
1703
+ inheritFieldsAndMappings: boolean;
1704
+ /**
1705
+ * The name of the object to subscribe to.
1706
+ * @type {string}
1707
+ * @memberof SubscribeConfigObject
1708
+ */
1709
+ objectName: string;
1710
+ /**
1711
+ * The name of the destination that the result should be sent to.
1712
+ * @type {string}
1713
+ * @memberof SubscribeConfigObject
1714
+ */
1715
+ destination: string;
1716
+ /**
1717
+ *
1718
+ * @type {ConfigCreateEvent}
1719
+ * @memberof SubscribeConfigObject
1720
+ */
1721
+ createEvent?: ConfigCreateEvent;
1722
+ /**
1723
+ *
1724
+ * @type {ConfigUpdateEvent}
1725
+ * @memberof SubscribeConfigObject
1726
+ */
1727
+ updateEvent?: ConfigUpdateEvent;
1728
+ /**
1729
+ *
1730
+ * @type {ConfigDeleteEvent}
1731
+ * @memberof SubscribeConfigObject
1732
+ */
1733
+ deleteEvent?: ConfigDeleteEvent;
1734
+ }
1735
+
1736
+ export declare function useAmpersandProvider(): never;
1737
+
1738
+ export declare function useConfig(): {
1739
+ draft: Partial<ConfigContent>;
1740
+ get: () => Partial<ConfigContent>;
1741
+ reset: () => void;
1742
+ setDraft: Dispatch<SetStateAction<Partial<ConfigContent>>>;
1743
+ readObject: (objectName: string) => {
1744
+ object: BaseReadConfigObject | undefined;
1745
+ getSelectedField: (fieldName: string) => boolean;
1746
+ setSelectedField: (params: {
1747
+ fieldName: string;
1748
+ selected: boolean;
1749
+ }) => void;
1750
+ getFieldMapping: (fieldName: string) => string | undefined;
1751
+ setFieldMapping: (params: {
1752
+ fieldName: string;
1753
+ mapToName: string;
1754
+ }) => void;
1755
+ };
1756
+ writeObject: (objectName: string) => {
1757
+ object: BaseWriteConfigObject | undefined;
1758
+ setEnableWrite: () => void;
1759
+ setDisableWrite: () => void;
1760
+ getWriteObject: () => BaseWriteConfigObject | undefined;
1761
+ getSelectedFieldSettings: (fieldName: string) => FieldSetting | undefined;
1762
+ setSelectedFieldSettings: (params: {
1763
+ fieldName: string;
1764
+ settings: FieldSetting;
1765
+ }) => void;
1766
+ getDefaultValues: (fieldName: string) => FieldSettingDefault | undefined;
1767
+ setDefaultValues: (params: {
1768
+ fieldName: string;
1769
+ value: FieldSettingDefault;
1770
+ }) => void;
1771
+ getWriteOnCreateSetting: (fieldName: string) => FieldSettingWriteOnCreateEnum | undefined;
1772
+ setWriteOnCreateSetting: (params: {
1773
+ fieldName: string;
1774
+ value: FieldSettingWriteOnCreateEnum;
1775
+ }) => void;
1776
+ getWriteOnUpdateSetting: (fieldName: string) => FieldSettingWriteOnUpdateEnum | undefined;
1777
+ setWriteOnUpdateSetting: (params: {
1778
+ fieldName: string;
1779
+ value: FieldSettingWriteOnUpdateEnum;
1780
+ }) => void;
1781
+ };
1782
+ };
1783
+
1784
+ /**
1785
+ * Connection manager that gives a connection if one is available.
1786
+ * Loading and error states are also returned.
1787
+ */
1788
+ export declare const useConnection: () => {
1789
+ connection: Connection | undefined;
1790
+ error: Error | null;
1791
+ isPending: boolean;
1792
+ isFetching: boolean;
1793
+ isError: boolean;
1794
+ isSuccess: boolean;
1795
+ };
1796
+
1797
+ /**
1798
+ * create installation hook
1799
+ * @returns {Object} An object containing:
1800
+ * - `createInstallation` (function): A function to create the installation.
1801
+ * - `isIdle` (boolean): Whether the mutation is idle.
1802
+ * - `isPending` (boolean): Whether the mutation is pending.
1803
+ * - `error` (Error | null): The error object, if any.
1804
+ * - `errorMsg` (string | null): The error message, if any.
1805
+ */
1806
+ export declare function useCreateInstallation(): {
1807
+ createInstallation: ({ config, onSuccess, onError, onSettled, }: {
1808
+ config: InstallationConfigContent;
1809
+ onSuccess?: (data: Installation) => void;
1810
+ onError?: (error: Error) => void;
1811
+ onSettled?: () => void;
1812
+ }) => void;
1813
+ isIdle: boolean;
1814
+ isPending: boolean;
1815
+ error: Error | null;
1816
+ errorMsg: string | null;
1817
+ };
1818
+
1819
+ /**
1820
+ * delete installation hook
1821
+ * @returns {Object} An object containing:
1822
+ * - `deleteInstallation` (function): A function to delete the installation.
1823
+ * - `isIdle` (boolean): Whether the mutation is idle.
1824
+ * - `isPending` (boolean): Whether the mutation is pending.
1825
+ * - `error` (Error | null): The error object, if any.
1826
+ * - `errorMsg` (string | null): The error message, if any.
1827
+ */
1828
+ export declare function useDeleteInstallation(): {
1829
+ deleteInstallation: ({ onSuccess, onError, onSettled, }: {
1830
+ onSuccess?: () => void;
1831
+ onError?: (error: Error) => void;
1832
+ onSettled?: () => void;
1833
+ }) => void;
1834
+ isIdle: boolean;
1835
+ isPending: boolean;
1836
+ error: Error | null;
1837
+ errorMsg: string | null;
1838
+ };
1839
+
1840
+ /**
1841
+ * gets hydrated revision using headless hooks to fill in details
1842
+ * @returns
1843
+ */
1844
+ export declare const useHydratedRevisionQuery: () => UseQueryResult<HydratedRevision, Error>;
1845
+
1846
+ /**
1847
+ * useInstallation hook
1848
+ * @returns {Object} An object containing:
1849
+ * - `installation` (Installation | undefined): The installation object.
1850
+ * - `isPending` (boolean): Whether the query is pending.
1851
+ * - `isFetching` (boolean): Whether the query is fetching.
1852
+ * - `isError` (boolean): Whether the query is in an error state.
1853
+ * - `isSuccess` (boolean): Whether the query is in a success state.
1854
+ * - `error` (Error | null): The error object, if any.
1855
+ * - `errorMsg` (string | null): The error message, if any.
1856
+ */
1857
+ export declare function useInstallation(): {
1858
+ installation: Installation | undefined;
1859
+ isPending: boolean;
1860
+ isFetching: boolean;
1861
+ isError: boolean;
1862
+ isSuccess: boolean;
1863
+ error: Error | null;
1864
+ };
1865
+
1866
+ export declare function useInstallationProps(): InstallationContextValue;
1867
+
1868
+ export declare const useIsIntegrationInstalled: (integration: string, groupRef: string) => UseIsIntegrationInstalledResult;
1869
+
1870
+ declare interface UseIsIntegrationInstalledResult {
1871
+ isLoading: boolean;
1872
+ isLoaded: boolean;
133
1873
  isIntegrationInstalled: boolean | null;
134
1874
  config?: Config;
135
1875
  }
136
1876
 
1877
+ /**
1878
+ * useManifest retrieves data from `amp.yaml` file, plus the customer's SaaS instance.
1879
+ * @returns Manifest object
1880
+ *
1881
+ * if object is not found, returns null for the object, getRequiredFields, getOptionalFields,
1882
+ * getCustomerFieldsForObject, getCustomerFieldsMetadataForObject
1883
+ *
1884
+ */
1885
+ export declare function useManifest(): {
1886
+ isPending: boolean;
1887
+ isFetching: boolean;
1888
+ isError: boolean;
1889
+ isSuccess: boolean;
1890
+ error: Error | null;
1891
+ getReadObject: (objectName: string) => {
1892
+ object: HydratedIntegrationObject | null;
1893
+ getRequiredFields: () => HydratedIntegrationField[] | null;
1894
+ getOptionalFields: () => HydratedIntegrationField[] | null;
1895
+ };
1896
+ getCustomerFieldsForObject: (objectName: string) => HydratedIntegrationField[] | null;
1897
+ getCustomerFieldsMetadataForObject: (objectName: string) => {
1898
+ allFieldsMetaData: {
1899
+ [key: string]: FieldMetadata;
1900
+ } | null;
1901
+ getField: (field: string) => FieldMetadata | null;
1902
+ };
1903
+ data: HydratedRevision | undefined;
1904
+ };
1905
+
1906
+ /**
1907
+ * update installation hook
1908
+ * @returns {Object} An object containing:
1909
+ * - `updateInstallation` (function): A function to update the installation.
1910
+ * - `isIdle` (boolean): Whether the mutation is idle.
1911
+ * - `isPending` (boolean): Whether the mutation is pending.
1912
+ * - `error` (Error | null): The error object, if any.
1913
+ * - `errorMsg` (string | null): The error message, if any.
1914
+ */
1915
+ export declare function useUpdateInstallation(): {
1916
+ updateInstallation: ({ config, onSuccess, onError, onSettled, }: {
1917
+ config: InstallationConfigContent;
1918
+ onSuccess?: (data: Installation) => void;
1919
+ onError?: (error: Error) => void;
1920
+ onSettled?: () => void;
1921
+ }) => void;
1922
+ isIdle: boolean;
1923
+ isPending: boolean;
1924
+ error: Error | null;
1925
+ errorMsg: string | null;
1926
+ };
1927
+
1928
+ /**
1929
+ * @type ValueDefault
1930
+ *
1931
+ * @export
1932
+ */
1933
+ declare type ValueDefault = ValueDefaultBoolean | ValueDefaultInteger | ValueDefaultString;
1934
+
1935
+ /**
1936
+ * Ampersand public API
1937
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
1938
+ *
1939
+ * The version of the OpenAPI document: 1.0.0
1940
+ *
1941
+ *
1942
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
1943
+ * https://openapi-generator.tech
1944
+ * Do not edit the class manually.
1945
+ */
1946
+ /**
1947
+ *
1948
+ * @export
1949
+ * @interface ValueDefaultBoolean
1950
+ */
1951
+ declare interface ValueDefaultBoolean {
1952
+ /**
1953
+ * The value to be used as a default.
1954
+ * @type {boolean}
1955
+ * @memberof ValueDefaultBoolean
1956
+ */
1957
+ value: boolean;
1958
+ /**
1959
+ * Whether the default value should be applied when updating a record.
1960
+ * If set to `always`, the default value will be applied when updating a record.
1961
+ * If set to `never`, the default value will not be applied when updating a record,
1962
+ * only when creating a record.
1963
+ * If unspecified, then `always` is assumed.
1964
+ * @type {string}
1965
+ * @memberof ValueDefaultBoolean
1966
+ */
1967
+ applyOnUpdate?: ValueDefaultBooleanApplyOnUpdateEnum;
1968
+ }
1969
+
1970
+ /**
1971
+ * @export
1972
+ */
1973
+ declare const ValueDefaultBooleanApplyOnUpdateEnum: {
1974
+ readonly Always: "always";
1975
+ readonly Never: "never";
1976
+ };
1977
+
1978
+ declare type ValueDefaultBooleanApplyOnUpdateEnum = typeof ValueDefaultBooleanApplyOnUpdateEnum[keyof typeof ValueDefaultBooleanApplyOnUpdateEnum];
1979
+
1980
+ /**
1981
+ * Ampersand public API
1982
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
1983
+ *
1984
+ * The version of the OpenAPI document: 1.0.0
1985
+ *
1986
+ *
1987
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
1988
+ * https://openapi-generator.tech
1989
+ * Do not edit the class manually.
1990
+ */
1991
+ /**
1992
+ *
1993
+ * @export
1994
+ * @interface ValueDefaultInteger
1995
+ */
1996
+ declare interface ValueDefaultInteger {
1997
+ /**
1998
+ * The value to be used as a default.
1999
+ * @type {number}
2000
+ * @memberof ValueDefaultInteger
2001
+ */
2002
+ value: number;
2003
+ /**
2004
+ * Whether the default value should be applied when updating a record.
2005
+ * If set to `always`, the default value will be applied when updating a record.
2006
+ * If set to `never`, the default value will not be applied when updating a record,
2007
+ * only when creating a record.
2008
+ * If unspecified, then `always` is assumed.
2009
+ * @type {string}
2010
+ * @memberof ValueDefaultInteger
2011
+ */
2012
+ applyOnUpdate?: ValueDefaultIntegerApplyOnUpdateEnum;
2013
+ }
2014
+
2015
+ /**
2016
+ * @export
2017
+ */
2018
+ declare const ValueDefaultIntegerApplyOnUpdateEnum: {
2019
+ readonly Always: "always";
2020
+ readonly Never: "never";
2021
+ };
2022
+
2023
+ declare type ValueDefaultIntegerApplyOnUpdateEnum = typeof ValueDefaultIntegerApplyOnUpdateEnum[keyof typeof ValueDefaultIntegerApplyOnUpdateEnum];
2024
+
2025
+ /**
2026
+ * Ampersand public API
2027
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
2028
+ *
2029
+ * The version of the OpenAPI document: 1.0.0
2030
+ *
2031
+ *
2032
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
2033
+ * https://openapi-generator.tech
2034
+ * Do not edit the class manually.
2035
+ */
2036
+ /**
2037
+ * Configuration to set default write values for object fields.
2038
+ * @export
2039
+ * @interface ValueDefaults
2040
+ */
2041
+ declare interface ValueDefaults {
2042
+ /**
2043
+ * If true, users can set default values for any field.
2044
+ * @type {boolean}
2045
+ * @memberof ValueDefaults
2046
+ */
2047
+ allowAnyFields?: boolean;
2048
+ }
2049
+
2050
+ /**
2051
+ * Ampersand public API
2052
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
2053
+ *
2054
+ * The version of the OpenAPI document: 1.0.0
2055
+ *
2056
+ *
2057
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
2058
+ * https://openapi-generator.tech
2059
+ * Do not edit the class manually.
2060
+ */
2061
+ /**
2062
+ *
2063
+ * @export
2064
+ * @interface ValueDefaultString
2065
+ */
2066
+ declare interface ValueDefaultString {
2067
+ /**
2068
+ * The value to be used as a default.
2069
+ * @type {string}
2070
+ * @memberof ValueDefaultString
2071
+ */
2072
+ value: string;
2073
+ /**
2074
+ * Whether the default value should be applied when updating a record.
2075
+ * If set to `always`, the default value will be applied when updating a record.
2076
+ * If set to `never`, the default value will not be applied when updating a record,
2077
+ * only when creating a record.
2078
+ * If unspecified, then `always` is assumed.
2079
+ * @type {string}
2080
+ * @memberof ValueDefaultString
2081
+ */
2082
+ applyOnUpdate?: ValueDefaultStringApplyOnUpdateEnum;
2083
+ }
2084
+
2085
+ /**
2086
+ * @export
2087
+ */
2088
+ declare const ValueDefaultStringApplyOnUpdateEnum: {
2089
+ readonly Always: "always";
2090
+ readonly Never: "never";
2091
+ };
2092
+
2093
+ declare type ValueDefaultStringApplyOnUpdateEnum = typeof ValueDefaultStringApplyOnUpdateEnum[keyof typeof ValueDefaultStringApplyOnUpdateEnum];
2094
+
2095
+ /**
2096
+ *
2097
+ * @export
2098
+ * @interface WriteConfig
2099
+ */
2100
+ declare interface WriteConfig {
2101
+ /**
2102
+ *
2103
+ * @type {{ [key: string]: WriteConfigObject; }}
2104
+ * @memberof WriteConfig
2105
+ */
2106
+ objects?: {
2107
+ [key: string]: WriteConfigObject;
2108
+ };
2109
+ }
2110
+
2111
+ /**
2112
+ *
2113
+ * @export
2114
+ * @interface WriteConfigObject
2115
+ */
2116
+ declare interface WriteConfigObject {
2117
+ /**
2118
+ * The name of the object to write to.
2119
+ * @type {string}
2120
+ * @memberof WriteConfigObject
2121
+ */
2122
+ objectName: string;
2123
+ /**
2124
+ * This is a map of field names to default values. These values will be used when writing to the object.
2125
+ * @type {{ [key: string]: ValueDefault; }}
2126
+ * @memberof WriteConfigObject
2127
+ * @deprecated
2128
+ */
2129
+ selectedValueDefaults?: {
2130
+ [key: string]: ValueDefault;
2131
+ };
2132
+ /**
2133
+ * This is a map of field names to their settings.
2134
+ * @type {{ [key: string]: FieldSetting; }}
2135
+ * @memberof WriteConfigObject
2136
+ */
2137
+ selectedFieldSettings?: {
2138
+ [key: string]: FieldSetting;
2139
+ };
2140
+ }
2141
+
137
2142
  export { }