@useparagon/connect 2.2.8-experimental-18633.2 → 2.2.8-experimental.2

package/dist/src/ConnectSDK.d.ts

@@ -6,7 +6,7 @@ import { PersonaMeta } from './entities/persona.interface';
 import { ExternalFilePicker } from './file-picker/types';
 import SDKEventEmitter from './SDKEventEmitter';
 import { ConnectSdkEnvironments } from './server.types';
-import { AuthenticateOptions, AuthenticatedConnectUser, CompleteInstallOptions, ConnectInputValue, Props as ConnectModalProps, ConnectParams, ConnectUser, CreateConfigurationOptions, CredentialConfigOptions, CustomDropdownField, DataType, DeleteConfigurationOptions, DisableWorkflowOptions, DynamicDataSource, DynamicDefaultInput, DynamicFieldMappingLoaderType, DynamicFieldMappingOptionsResult, EnumInputValue, EventInfo, GetIntegrationAccountOptions, IConnectSDK, InputSources, InstallFlowStage, InstallIntegrationOptions, InstallOptions, IntegrationConfig, IntegrationConnectInput, IntegrationInstallEvent, KeyedSource, LoadCustomDropdownOptionsResult, ProxyRequestOptions, SerializedConnectInput, SetDataSourcesConfig, StartOptions, TriggerWorkflowRequest, UninstallOptions, UpdateConfigurationOptions, UpdateWorkflowStateResponse, UserProvidedIntegrationConfig } from './types';
+import { AuthenticateOptions, AuthenticatedConnectUser, CompleteInstallOptions, ConnectInputValue, Props as ConnectModalProps, ConnectParams, ConnectUser, CreateConfigurationOptions, CredentialConfigOptions, DataType, DeleteConfigurationOptions, DisableWorkflowOptions, DynamicDefaultInput, DynamicFieldMappingLoaderType, DynamicFieldMappingOptionsResult, EnumInputValue, EventInfo, GetIntegrationAccountOptions, IConnectSDK, InstallFlowStage, InstallIntegrationOptions, InstallOptions, IntegrationConfig, IntegrationConnectInput, IntegrationInstallEvent, KeyedSource, LoadCustomDropdownOptionsResult, ProxyRequestOptions, StartOptions, TriggerWorkflowRequest, UninstallOptions, UpdateConfigurationOptions, UpdateWorkflowStateResponse, UserProvidedIntegrationConfig } from './types';
 export declare const PARAGON_OVERFLOW_EMPTY_VALUE = "PARAGON_OVERFLOW_EMPTY_VALUE";
 export { ExternalFilePicker };
 export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
@@ -51,10 +51,6 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
      * Dynamic field mapping loaders for handling dynamic object types and integration fields
      */
     private dynamicFieldMappingLoaders;
-    private globalDropdownOptions;
-    private globalMapObjectFields;
-    private integrationSpecificDropdownOptions;
-    private integrationSpecificMapObjectFields;
     installFlow: InstallFlow;
     constructor(environmentsOrHost?: ConnectSdkEnvironments | string, flags?: {
         skipBootstrapWithLastKnownState?: boolean;
@@ -79,6 +75,18 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
      * @param validateIsEnabled boolean
      */
     validateAction(action: string): void;
+    /**
+     * Validates that the provided `externalId` and `selectedCredentialId` install options are
+     * mutually exclusive, and that the `externalId` is not already in use for the given integration.
+     *
+     * `selectedCredentialId` accepts either a Paragon credential UUID, a plain `externalId` string,
+     * or an `ext:<value>` prefixed string — all resolve to a credential by its customer-supplied `externalId`.
+     * The `ext:` prefix is optional and only required when the externalId value itself looks like a UUID.
+     *
+     * Throws a descriptive error in either case so the developer gets actionable feedback before
+     * the OAuth popup opens.
+     */
+    private validateExternalIdOptions;
     /**
      * checks if the integration is installed.
      * Assumes that the user is authenticated
@@ -179,17 +187,7 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
     }): Promise<IntegrationInstallEvent | undefined>;
     _oauthErrorCallback(errorMessage: string | object, event?: MessageEvent): Promise<void>;
     customDropdownOptionsLoaders: Record<string, (cursor?: string | undefined, search?: string | undefined) => LoadCustomDropdownOptionsResult>;
-    /**
-     * Display the Paragon Connect modal
-     */
     _loadCustomDropdownOptions(key: string, cursor?: string | undefined, search?: string | undefined): LoadCustomDropdownOptionsResult;
-    setDataSources(config: SetDataSourcesConfig): void;
-    private processDropdownSources;
-    private processMapObjectFieldSources;
-    resolveCustomDropdownSource(key: string | undefined, integrationName: string): CustomDropdownField[] | null;
-    private resolveMapObjectFieldSource;
-    private isDynamicFieldMappingConfig;
-    hasCustomDropdownLoader(key: string | undefined): boolean;
     /**
      * Send a Connect API request. Automatically handles authorization and errors.
      *
@@ -359,7 +357,7 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
      * @param userSettingsUpdate - A partial map of input IDs <> values to update the workflow's settings
      * @param settings - Optional object with selectedCredentialId or selectedConfigurationId
      * @returns Promise with the new user state and an array of errors, if any were found
-     * @throws Error if the workflow is not enabled or if the integration is not found
+     * @throws Error if the workflow ID is not found in the configuration
      */
     updateWorkflowUserSettings(integration: string, workflowId: string, userSettingsUpdate: Record<string, any>, settings?: CredentialConfigOptions): Promise<{
         userState: AuthenticatedConnectUser;
@@ -386,10 +384,9 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
      * @param parameters - Optional array of parameters to be used in the request.
      * @returns A promise that resolves with the field options or logs an error if the request fails.
      */
-    getFieldOptions({ integration, action, source, search, cursor, parameters, selectedCredentialId, }: {
+    getFieldOptions({ integration, action, search, cursor, parameters, selectedCredentialId, }: {
         integration: string;
-        action?: string;
-        source?: DynamicDataSource<any>;
+        action: string;
         search?: string;
         cursor?: string | number | false;
         parameters?: KeyedSource<DataType.ANY>[];
@@ -400,7 +397,6 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
         nextPageCursor: string | null;
     }>;
     getDataSourceOptions(integrationName: string, action: string): Promise<import("./types").DataSource | undefined>;
-    getSourcesForInput(integrationName: string, action: string, input: SerializedConnectInput): InputSources | null;
     getAccountTypeOptions(integrationName: string): import("./types").AccountType[];
     getPreOptions(integrationName: string, accountTypeId?: string): IntegrationConnectInput[];
     getPostOptions(integrationName: string): IntegrationConnectInput[];