@arbium/enterprise-agent-connect-client 0.1.2-dev.d2aa5ca → 0.2.1-dev.fd7a648

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/lib/schema.d.ts CHANGED
@@ -73,6 +73,76 @@ export interface paths {
73
73
  patch?: never;
74
74
  trace?: never;
75
75
  };
76
+ "/orgs/{org}/connectors": {
77
+ parameters: {
78
+ query?: never;
79
+ header?: never;
80
+ path?: never;
81
+ cookie?: never;
82
+ };
83
+ /** The apps the organization can use: the deployment's and its own internal apps */
84
+ get: operations["orgConnectors"];
85
+ put?: never;
86
+ post?: never;
87
+ delete?: never;
88
+ options?: never;
89
+ head?: never;
90
+ patch?: never;
91
+ trace?: never;
92
+ };
93
+ "/orgs/{org}/internal-apps": {
94
+ parameters: {
95
+ query?: never;
96
+ header?: never;
97
+ path?: never;
98
+ cookie?: never;
99
+ };
100
+ /** The organization's own apps, as saved */
101
+ get: operations["internalApps"];
102
+ put?: never;
103
+ post?: never;
104
+ delete?: never;
105
+ options?: never;
106
+ head?: never;
107
+ patch?: never;
108
+ trace?: never;
109
+ };
110
+ "/orgs/{org}/internal-apps/{app}": {
111
+ parameters: {
112
+ query?: never;
113
+ header?: never;
114
+ path?: never;
115
+ cookie?: never;
116
+ };
117
+ /** One of the organization's own apps, as saved */
118
+ get: operations["internalApp"];
119
+ /** Adds or replaces one of the organization's own apps; a replace may cut or remove its connection and agents' access */
120
+ put: operations["saveInternalApp"];
121
+ post?: never;
122
+ /** Removes one of the organization's own apps, its connection and every agent's access to it */
123
+ delete: operations["deleteInternalApp"];
124
+ options?: never;
125
+ head?: never;
126
+ patch?: never;
127
+ trace?: never;
128
+ };
129
+ "/internal-apps/draft": {
130
+ parameters: {
131
+ query?: never;
132
+ header?: never;
133
+ path?: never;
134
+ cookie?: never;
135
+ };
136
+ get?: never;
137
+ put?: never;
138
+ /** Drafts an internal app's definition from an OpenAPI 3.x spec (JSON) */
139
+ post: operations["draftInternalApp"];
140
+ delete?: never;
141
+ options?: never;
142
+ head?: never;
143
+ patch?: never;
144
+ trace?: never;
145
+ };
76
146
  "/providers": {
77
147
  parameters: {
78
148
  query?: never;
@@ -965,6 +1035,9 @@ export interface components {
965
1035
  label: string;
966
1036
  values: string[];
967
1037
  warning?: string;
1038
+ labels?: {
1039
+ [key: string]: string;
1040
+ };
968
1041
  };
969
1042
  CheckOutcome: {
970
1043
  /** @constant */
@@ -1069,6 +1142,7 @@ export interface components {
1069
1142
  field: string;
1070
1143
  value: string;
1071
1144
  };
1145
+ capabilities?: string[];
1072
1146
  }[];
1073
1147
  afterConnect: {
1074
1148
  title: string;
@@ -1102,6 +1176,7 @@ export interface components {
1102
1176
  field: string;
1103
1177
  value: string;
1104
1178
  };
1179
+ capabilities?: string[];
1105
1180
  }[];
1106
1181
  fields: {
1107
1182
  id: string;
@@ -1119,6 +1194,8 @@ export interface components {
1119
1194
  field: string;
1120
1195
  value: string;
1121
1196
  };
1197
+ /** @default false */
1198
+ optional: boolean;
1122
1199
  }[];
1123
1200
  capabilities: {
1124
1201
  id: string;
@@ -1216,6 +1293,7 @@ export interface components {
1216
1293
  path: string;
1217
1294
  label: string;
1218
1295
  show: string;
1296
+ name?: string;
1219
1297
  match?: {
1220
1298
  [key: string]: string | number | boolean;
1221
1299
  };
@@ -1235,6 +1313,7 @@ export interface components {
1235
1313
  path: string;
1236
1314
  label: string;
1237
1315
  show: string;
1316
+ name?: string;
1238
1317
  match?: {
1239
1318
  [key: string]: string | number | boolean;
1240
1319
  };
@@ -1690,10 +1769,7 @@ export interface components {
1690
1769
  deliveryId: string[];
1691
1770
  types: {
1692
1771
  type: string;
1693
- same?: [
1694
- string,
1695
- string
1696
- ];
1772
+ since?: string;
1697
1773
  }[];
1698
1774
  };
1699
1775
  };
@@ -1822,6 +1898,36 @@ export interface components {
1822
1898
  name: string;
1823
1899
  detail: string | null;
1824
1900
  };
1901
+ InternalApp: {
1902
+ id: string;
1903
+ organizationId: string;
1904
+ /** @description A connector.json with an http, soap, odata or sql block, as written (docs/http-connector.md) */
1905
+ definition: {
1906
+ [key: string]: unknown;
1907
+ };
1908
+ problem: string | null;
1909
+ createdBy: string;
1910
+ /** @description ISO 8601, UTC */
1911
+ createdAt: string;
1912
+ updatedBy: string;
1913
+ /** @description ISO 8601, UTC */
1914
+ updatedAt: string;
1915
+ };
1916
+ InternalAppDraft: {
1917
+ /** @description A connector.json with an http, soap, odata or sql block, as written (docs/http-connector.md) */
1918
+ definition: {
1919
+ [key: string]: unknown;
1920
+ };
1921
+ notes: string[];
1922
+ problem: string | null;
1923
+ };
1924
+ InternalAppSaved: {
1925
+ app: components["schemas"]["InternalApp"];
1926
+ connector: components["schemas"]["Connector"];
1927
+ created: boolean;
1928
+ disconnected: boolean;
1929
+ grantsRemoved: string[];
1930
+ };
1825
1931
  Limits: {
1826
1932
  [key: string]: string[] | string | {
1827
1933
  [key: string]: string;
@@ -2450,6 +2556,380 @@ export interface operations {
2450
2556
  };
2451
2557
  };
2452
2558
  };
2559
+ orgConnectors: {
2560
+ parameters: {
2561
+ query?: never;
2562
+ header?: never;
2563
+ path: {
2564
+ org: string;
2565
+ };
2566
+ cookie?: never;
2567
+ };
2568
+ requestBody?: never;
2569
+ responses: {
2570
+ /** @description OK */
2571
+ 200: {
2572
+ headers: {
2573
+ [name: string]: unknown;
2574
+ };
2575
+ content: {
2576
+ "application/json": components["schemas"]["Connector"][];
2577
+ };
2578
+ };
2579
+ /** @description Refused */
2580
+ 400: {
2581
+ headers: {
2582
+ [name: string]: unknown;
2583
+ };
2584
+ content: {
2585
+ "application/json": components["schemas"]["Error"];
2586
+ };
2587
+ };
2588
+ /** @description Refused */
2589
+ 401: {
2590
+ headers: {
2591
+ [name: string]: unknown;
2592
+ };
2593
+ content: {
2594
+ "application/json": components["schemas"]["Error"];
2595
+ };
2596
+ };
2597
+ /** @description Refused */
2598
+ 404: {
2599
+ headers: {
2600
+ [name: string]: unknown;
2601
+ };
2602
+ content: {
2603
+ "application/json": components["schemas"]["Error"];
2604
+ };
2605
+ };
2606
+ /** @description Refused */
2607
+ 422: {
2608
+ headers: {
2609
+ [name: string]: unknown;
2610
+ };
2611
+ content: {
2612
+ "application/json": components["schemas"]["Error"];
2613
+ };
2614
+ };
2615
+ };
2616
+ };
2617
+ internalApps: {
2618
+ parameters: {
2619
+ query?: never;
2620
+ header?: never;
2621
+ path: {
2622
+ org: string;
2623
+ };
2624
+ cookie?: never;
2625
+ };
2626
+ requestBody?: never;
2627
+ responses: {
2628
+ /** @description OK */
2629
+ 200: {
2630
+ headers: {
2631
+ [name: string]: unknown;
2632
+ };
2633
+ content: {
2634
+ "application/json": components["schemas"]["InternalApp"][];
2635
+ };
2636
+ };
2637
+ /** @description Refused */
2638
+ 400: {
2639
+ headers: {
2640
+ [name: string]: unknown;
2641
+ };
2642
+ content: {
2643
+ "application/json": components["schemas"]["Error"];
2644
+ };
2645
+ };
2646
+ /** @description Refused */
2647
+ 401: {
2648
+ headers: {
2649
+ [name: string]: unknown;
2650
+ };
2651
+ content: {
2652
+ "application/json": components["schemas"]["Error"];
2653
+ };
2654
+ };
2655
+ /** @description Refused */
2656
+ 404: {
2657
+ headers: {
2658
+ [name: string]: unknown;
2659
+ };
2660
+ content: {
2661
+ "application/json": components["schemas"]["Error"];
2662
+ };
2663
+ };
2664
+ /** @description Refused */
2665
+ 422: {
2666
+ headers: {
2667
+ [name: string]: unknown;
2668
+ };
2669
+ content: {
2670
+ "application/json": components["schemas"]["Error"];
2671
+ };
2672
+ };
2673
+ };
2674
+ };
2675
+ internalApp: {
2676
+ parameters: {
2677
+ query?: never;
2678
+ header?: never;
2679
+ path: {
2680
+ org: string;
2681
+ app: string;
2682
+ };
2683
+ cookie?: never;
2684
+ };
2685
+ requestBody?: never;
2686
+ responses: {
2687
+ /** @description OK */
2688
+ 200: {
2689
+ headers: {
2690
+ [name: string]: unknown;
2691
+ };
2692
+ content: {
2693
+ "application/json": components["schemas"]["InternalApp"];
2694
+ };
2695
+ };
2696
+ /** @description Refused */
2697
+ 400: {
2698
+ headers: {
2699
+ [name: string]: unknown;
2700
+ };
2701
+ content: {
2702
+ "application/json": components["schemas"]["Error"];
2703
+ };
2704
+ };
2705
+ /** @description Refused */
2706
+ 401: {
2707
+ headers: {
2708
+ [name: string]: unknown;
2709
+ };
2710
+ content: {
2711
+ "application/json": components["schemas"]["Error"];
2712
+ };
2713
+ };
2714
+ /** @description Refused */
2715
+ 404: {
2716
+ headers: {
2717
+ [name: string]: unknown;
2718
+ };
2719
+ content: {
2720
+ "application/json": components["schemas"]["Error"];
2721
+ };
2722
+ };
2723
+ /** @description Refused */
2724
+ 422: {
2725
+ headers: {
2726
+ [name: string]: unknown;
2727
+ };
2728
+ content: {
2729
+ "application/json": components["schemas"]["Error"];
2730
+ };
2731
+ };
2732
+ };
2733
+ };
2734
+ saveInternalApp: {
2735
+ parameters: {
2736
+ query?: never;
2737
+ header?: never;
2738
+ path: {
2739
+ org: string;
2740
+ app: string;
2741
+ };
2742
+ cookie?: never;
2743
+ };
2744
+ requestBody: {
2745
+ content: {
2746
+ "application/json": {
2747
+ /** @description A connector.json with an http, soap, odata or sql block, as written (docs/http-connector.md) */
2748
+ definition: {
2749
+ [key: string]: unknown;
2750
+ };
2751
+ by: string;
2752
+ };
2753
+ };
2754
+ };
2755
+ responses: {
2756
+ /** @description OK */
2757
+ 200: {
2758
+ headers: {
2759
+ [name: string]: unknown;
2760
+ };
2761
+ content: {
2762
+ "application/json": components["schemas"]["InternalAppSaved"];
2763
+ };
2764
+ };
2765
+ /** @description Refused */
2766
+ 400: {
2767
+ headers: {
2768
+ [name: string]: unknown;
2769
+ };
2770
+ content: {
2771
+ "application/json": components["schemas"]["Error"];
2772
+ };
2773
+ };
2774
+ /** @description Refused */
2775
+ 401: {
2776
+ headers: {
2777
+ [name: string]: unknown;
2778
+ };
2779
+ content: {
2780
+ "application/json": components["schemas"]["Error"];
2781
+ };
2782
+ };
2783
+ /** @description Refused */
2784
+ 404: {
2785
+ headers: {
2786
+ [name: string]: unknown;
2787
+ };
2788
+ content: {
2789
+ "application/json": components["schemas"]["Error"];
2790
+ };
2791
+ };
2792
+ /** @description Refused */
2793
+ 422: {
2794
+ headers: {
2795
+ [name: string]: unknown;
2796
+ };
2797
+ content: {
2798
+ "application/json": components["schemas"]["Error"];
2799
+ };
2800
+ };
2801
+ };
2802
+ };
2803
+ deleteInternalApp: {
2804
+ parameters: {
2805
+ query?: never;
2806
+ header?: never;
2807
+ path: {
2808
+ org: string;
2809
+ app: string;
2810
+ };
2811
+ cookie?: never;
2812
+ };
2813
+ requestBody: {
2814
+ content: {
2815
+ "application/json": {
2816
+ by: string;
2817
+ };
2818
+ };
2819
+ };
2820
+ responses: {
2821
+ /** @description OK */
2822
+ 204: {
2823
+ headers: {
2824
+ [name: string]: unknown;
2825
+ };
2826
+ content?: never;
2827
+ };
2828
+ /** @description Refused */
2829
+ 400: {
2830
+ headers: {
2831
+ [name: string]: unknown;
2832
+ };
2833
+ content: {
2834
+ "application/json": components["schemas"]["Error"];
2835
+ };
2836
+ };
2837
+ /** @description Refused */
2838
+ 401: {
2839
+ headers: {
2840
+ [name: string]: unknown;
2841
+ };
2842
+ content: {
2843
+ "application/json": components["schemas"]["Error"];
2844
+ };
2845
+ };
2846
+ /** @description Refused */
2847
+ 404: {
2848
+ headers: {
2849
+ [name: string]: unknown;
2850
+ };
2851
+ content: {
2852
+ "application/json": components["schemas"]["Error"];
2853
+ };
2854
+ };
2855
+ /** @description Refused */
2856
+ 422: {
2857
+ headers: {
2858
+ [name: string]: unknown;
2859
+ };
2860
+ content: {
2861
+ "application/json": components["schemas"]["Error"];
2862
+ };
2863
+ };
2864
+ };
2865
+ };
2866
+ draftInternalApp: {
2867
+ parameters: {
2868
+ query?: never;
2869
+ header?: never;
2870
+ path?: never;
2871
+ cookie?: never;
2872
+ };
2873
+ requestBody: {
2874
+ content: {
2875
+ "application/json": {
2876
+ spec: {
2877
+ [key: string]: unknown;
2878
+ };
2879
+ id: string;
2880
+ operations?: string[];
2881
+ tags?: string[];
2882
+ };
2883
+ };
2884
+ };
2885
+ responses: {
2886
+ /** @description OK */
2887
+ 200: {
2888
+ headers: {
2889
+ [name: string]: unknown;
2890
+ };
2891
+ content: {
2892
+ "application/json": components["schemas"]["InternalAppDraft"];
2893
+ };
2894
+ };
2895
+ /** @description Refused */
2896
+ 400: {
2897
+ headers: {
2898
+ [name: string]: unknown;
2899
+ };
2900
+ content: {
2901
+ "application/json": components["schemas"]["Error"];
2902
+ };
2903
+ };
2904
+ /** @description Refused */
2905
+ 401: {
2906
+ headers: {
2907
+ [name: string]: unknown;
2908
+ };
2909
+ content: {
2910
+ "application/json": components["schemas"]["Error"];
2911
+ };
2912
+ };
2913
+ /** @description Refused */
2914
+ 404: {
2915
+ headers: {
2916
+ [name: string]: unknown;
2917
+ };
2918
+ content: {
2919
+ "application/json": components["schemas"]["Error"];
2920
+ };
2921
+ };
2922
+ /** @description Refused */
2923
+ 422: {
2924
+ headers: {
2925
+ [name: string]: unknown;
2926
+ };
2927
+ content: {
2928
+ "application/json": components["schemas"]["Error"];
2929
+ };
2930
+ };
2931
+ };
2932
+ };
2453
2933
  providers: {
2454
2934
  parameters: {
2455
2935
  query?: never;
package/lib/steps.d.ts CHANGED
@@ -17,8 +17,10 @@ export declare function choiceValues(connector: {
17
17
  export declare const isChosen: (option: ChosenOption | undefined, chosen: Record<string, string>) => boolean;
18
18
  /** The choice fields shown: one that `requires` an earlier choice only while it is made. */
19
19
  export declare const askedFields: (fields: Field[], values: Record<string, string>) => Field[];
20
- /** The steps that apply under the chosen options (a step with `option` only while chosen). */
21
- export declare function chosenSteps(connector: Connector, steps: Step[], values: Record<string, string>): Step[];
20
+ /** The steps that apply under the chosen options (a step with `option` only while chosen)
21
+ * and, given `ticked`, the ticked capabilities (a step with `capabilities` only while one of
22
+ * them is). */
23
+ export declare function chosenSteps(connector: Connector, steps: Step[], values: Record<string, string>, ticked?: readonly string[]): Step[];
22
24
  /** Choices that change the permissions the setup steps ask for: made in step 1, with what
23
25
  * agents may do, so the steps after it already show those permissions. */
24
26
  export declare function permissionChoices(connector: Connector): Field[];
@@ -39,6 +41,12 @@ export declare function keyApps(agent: Agent, connectors: Connector[]): Connecto
39
41
  export declare function keysUsing(agents: Agent[], connectorId: string): number;
40
42
  /** The values a connected app reported for its discover probe, e.g. Jira project keys. */
41
43
  export declare function discovered(connector: Connector, checks: Check[] | null): string[];
44
+ /** The same, each with the label to show for it (the value itself when the app gave none),
45
+ * e.g. a NetSuite subsidiary's name for its id. */
46
+ export declare function discoveredChoices(connector: Connector, checks: Check[] | null): {
47
+ value: string;
48
+ label: string;
49
+ }[];
42
50
  /** Parses free-typed list input ("KAN, SAM1") into values. */
43
51
  export declare function splitList(raw: string): string[];
44
52
  /** Shown under Click through for a step the vendor offers only as commands. */
@@ -211,6 +219,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
211
219
  field: string;
212
220
  value: string;
213
221
  };
222
+ capabilities?: string[];
214
223
  }[];
215
224
  afterConnect: {
216
225
  title: string;
@@ -240,6 +249,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
240
249
  field: string;
241
250
  value: string;
242
251
  };
252
+ capabilities?: string[];
243
253
  }[];
244
254
  fields: {
245
255
  id: string;
@@ -257,6 +267,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
257
267
  field: string;
258
268
  value: string;
259
269
  };
270
+ optional: boolean;
260
271
  }[];
261
272
  capabilities: {
262
273
  id: string;
@@ -340,6 +351,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
340
351
  path: string;
341
352
  label: string;
342
353
  show: string;
354
+ name?: string;
343
355
  match?: {
344
356
  [key: string]: string | number | boolean;
345
357
  };
@@ -357,6 +369,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
357
369
  path: string;
358
370
  label: string;
359
371
  show: string;
372
+ name?: string;
360
373
  match?: {
361
374
  [key: string]: string | number | boolean;
362
375
  };
@@ -712,7 +725,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
712
725
  deliveryId: string[];
713
726
  types: {
714
727
  type: string;
715
- same?: [string, string];
728
+ since?: string;
716
729
  }[];
717
730
  };
718
731
  };
@@ -790,6 +803,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
790
803
  field: string;
791
804
  value: string;
792
805
  };
806
+ capabilities?: string[];
793
807
  }[];
794
808
  afterConnect: {
795
809
  title: string;
@@ -819,6 +833,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
819
833
  field: string;
820
834
  value: string;
821
835
  };
836
+ capabilities?: string[];
822
837
  }[];
823
838
  fields: {
824
839
  id: string;
@@ -836,6 +851,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
836
851
  field: string;
837
852
  value: string;
838
853
  };
854
+ optional: boolean;
839
855
  }[];
840
856
  capabilities: {
841
857
  id: string;
@@ -919,6 +935,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
919
935
  path: string;
920
936
  label: string;
921
937
  show: string;
938
+ name?: string;
922
939
  match?: {
923
940
  [key: string]: string | number | boolean;
924
941
  };
@@ -936,6 +953,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
936
953
  path: string;
937
954
  label: string;
938
955
  show: string;
956
+ name?: string;
939
957
  match?: {
940
958
  [key: string]: string | number | boolean;
941
959
  };
@@ -1291,7 +1309,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
1291
1309
  deliveryId: string[];
1292
1310
  types: {
1293
1311
  type: string;
1294
- same?: [string, string];
1312
+ since?: string;
1295
1313
  }[];
1296
1314
  };
1297
1315
  };