@useparagon/connect 1.0.34 → 1.0.35-experimental.10

package/dist/src/ConnectSDK.d.ts

@@ -1,17 +1,18 @@
 import { IConnectCredential } from './entities/connectCredential.interface';
 import { IConnectCredentialConfig } from './entities/connectCredentialConfig.interface';
-import { OauthCallbackResponse } from './entities/credential.interface';
+import { AuthenticationScheme, OauthCallbackResponse } from './entities/credential.interface';
 import { IConnectIntegrationWithCredentialInfo, IIntegrationMetadata } from './entities/integration.interface';
 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, Props as ConnectModalProps, ConnectParams, ConnectUser, CreateConfigurationOptions, CredentialConfigOptions, DeleteConfigurationOptions, DisableWorkflowOptions, EventInfo, GetIntegrationAccountOptions, IConnectSDK, InstallIntegrationOptions, IntegrationInstallEvent, LoadCustomDropdownOptionsResult, TriggerWorkflowRequest, UninstallOptions, UpdateConfigurationOptions } from './types';
+import { AccountType, AuthenticateOptions, AuthenticatedConnectUser, ComboInputDataSource, CompleteInstallOptions, ConnectInputValue, Props as ConnectModalProps, ConnectParams, ConnectUser, CreateConfigurationOptions, CredentialConfigOptions, DataType, DeleteConfigurationOptions, DisableWorkflowOptions, EventInfo, GetIntegrationAccountOptions, IConnectSDK, InstallIntegrationOptions, InstallOptions, IntegrationConfig, IntegrationConnectInput, IntegrationInstallEvent, KeyedSource, LoadCustomDropdownOptionsResult, SerializedConnectInput, TriggerWorkflowRequest, UninstallOptions, UpdateConfigurationOptions, UpdateWorkflowStateResponse } from './types';
 export declare const PARAGON_OVERFLOW_EMPTY_VALUE = "PARAGON_OVERFLOW_EMPTY_VALUE";
 export { ExternalFilePicker };
 export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
     root: HTMLIFrameElement | undefined;
     private rootLoaded;
+    private isHeadless;
     /**
      * sometime DOMContentLoaded event firing twice
      * so it was creating two iframes see PARA-8749
@@ -45,9 +46,11 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
      * so that we will be able to know whether style is added in body or not
      */
     private originalBodyOverflow;
+    installFlow: InstallFlow;
     constructor(environmentsOrHost?: ConnectSdkEnvironments | string, flags?: {
         skipBootstrapWithLastKnownState?: boolean;
     });
+    setHeadless(headless: boolean): void;
     /**
      * post message handler
      * @param event
@@ -82,6 +85,7 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
      * unauthenticated contexts, as a fallback.
      */
     private loadState;
+    getIntegrationId(integration: string): string;
     /**
      * Saves the current SDK state into localStorage, if available.
      */
@@ -116,6 +120,18 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
      * Logout the currently authenticated end user from the Paragon SDK.
      */
     logout(): void;
+    private removeOptionDuplicates;
+    startOAuthFlow(action: string, apiInstallationOptions: InstallOptions & CredentialConfigOptions, options?: {
+        onSuccess?: (connectCredentialId: string) => void;
+        onError?: (error: unknown) => void;
+    }): void;
+    private getIntegrationByName;
+    private getSelectedMultipleAccountTypes;
+    /**
+     * in chrome getting issue for asynchronous popup opening
+     * see PARA-1505
+     */
+    private getAccountName;
     /**
      * Display the Paragon Connect modal
      */
@@ -128,6 +144,7 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
      * @returns The integration object if found, otherwise undefined.
      */
     _getIntegration(integrationId: string): IConnectIntegrationWithCredentialInfo | undefined;
+    getIntegrationBySlug(integrationName: string): IConnectIntegrationWithCredentialInfo;
     _oauthCallback(oauthResponse: OauthCallbackResponse, credentialId?: string): Promise<void>;
     _oauthErrorCallback(errorMessage: string | object, event?: MessageEvent): Promise<void>;
     customDropdownOptionsLoaders: Record<string, (cursor?: string | undefined, search?: string | undefined) => LoadCustomDropdownOptionsResult>;
@@ -223,6 +240,7 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
      * we also need integration config and other credentials info which is not included in `sdk/me`
      */
     private fetchIntegrations;
+    private getIntegrationIcon;
     /**
      * Updates internal state where integration information may be used.
      */
@@ -267,4 +285,122 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
     destroyConfiguration({ id, credentialId }: DeleteConfigurationOptions): Promise<void>;
     updateConfiguration({ id, credentialId, meta, }: UpdateConfigurationOptions): Promise<IConnectCredentialConfig>;
     private pollForCredential;
+    /**
+     * Returns integration config
+     * @param integration
+     * @returns
+     */
+    getIntegrationConfig(integration: string): IntegrationConfig;
+    private getIntegrationCredential;
+    /**
+     * Updates stored User Settings for an integration or workflow.
+     *
+     * @param integration - An integration name, e.g. "googledrive"
+     * @param userSettingsUpdate - A partial map of input IDs <> values to update the user'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
+     */
+    updateIntegrationUserSettings(integration: string, userSettingsUpdate: Record<string, any>, settings?: CredentialConfigOptions): Promise<{
+        userState: AuthenticatedConnectUser;
+        errors: string[];
+    }>;
+    /**
+     * Updates user settings for a specific workflow within an integration.
+     *
+     * @param integration - An integration name, e.g. "googledrive"
+     * @param workflowId - The ID of the workflow to update settings for
+     * @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
+     */
+    updateWorkflowUserSettings(integration: string, workflowId: string, userSettingsUpdate: Record<string, any>, settings?: CredentialConfigOptions): Promise<{
+        userState: AuthenticatedConnectUser;
+        errors: string[];
+    }>;
+    /**
+     * Updates the enabled/disabled state of multiple workflows for a given integration.
+     *
+     * @param workflowStateUpdate - An object mapping workflow IDs to their desired enabled state (true/false)
+     * @param options - Optional settings for credential and configuration selection
+     * @param options.selectedCredentialId - Optional ID of the specific credential to use
+     * @param options.selectedConfigurationId - Optional ID of the specific configuration to use
+     * @returns Promise that resolves with the updated user state and any errors that occurred during the update
+     * @throws Error if no valid credential is found or if the integration is not enabled
+     */
+    updateWorkflowState(workflowStateUpdate: Record<string, boolean>, options?: CredentialConfigOptions): Promise<UpdateWorkflowStateResponse>;
+    /**
+     * Retrieves field options for a specific integration action.
+     *
+     * @param integration - The integration type to validate and retrieve field options for.
+     * @param action - The specific action within the integration to retrieve field options for.
+     * @param search - Optional search term to filter field options.
+     * @param cursor - Optional cursor for pagination, can be a string, number, or false.
+     * @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, search, cursor, parameters, }: {
+        integration: string;
+        action: string;
+        search?: string;
+        cursor?: string | number | false;
+        parameters: KeyedSource<DataType.ANY>[];
+    }): Promise<{
+        data: {
+            value: string;
+            label: string;
+        }[];
+        nextPageCursor: string | null;
+    }>;
+    getDataSourceOptions(integrationName: string, action: string): Promise<ComboInputDataSource>;
+    getAccountTypeOptions(integrationName: string): AccountType[];
+    getPreOptions(integrationName: string, accountTypeId?: string): KeyedSource<DataType.ANY>[] | IntegrationConnectInput[];
+    getPostOptions(integrationName: string): IntegrationConnectInput[];
+}
+export declare class InstallFlow {
+    private readonly paragon;
+    private integrationName;
+    private accountType;
+    private preOptions;
+    private postOptions;
+    private credentialId;
+    private onNext;
+    private onComplete;
+    constructor(paragon: ConnectSDK);
+    start(integrationName: string, startOptions?: StartOptions): Promise<InstallFlowStage>;
+    getScheme(): null | AuthenticationScheme;
+    private requiresAccountType;
+    private requiresPreOptions;
+    private requiresPostOptions;
+    setAccountType(accountType: string, onError: (error: unknown) => void): void;
+    setPreOptions(options: Record<string, ConnectInputValue>, onError: (error: unknown) => void): void;
+    setPostOptions(options: Record<string, ConnectInputValue>, onError: (error: unknown) => void): void;
+    getAccountType(): string | null;
+    getPreOptions(): Record<string, ConnectInputValue> | null;
+    getPostOptions(): Record<string, ConnectInputValue> | null;
+    next(): InstallFlowStage;
 }
+type AccountTypeStage = {
+    stage: 'accountType';
+    options: AccountType[];
+    done: false;
+};
+type PreOptionsStage = {
+    stage: 'preOptions';
+    options: IntegrationConnectInput[] | KeyedSource<DataType.ANY>[] | SerializedConnectInput[];
+    done: false;
+};
+type PostOptionsStage = {
+    stage: 'postOptions';
+    options: IntegrationConnectInput[];
+    done: false;
+};
+type DoneStage = {
+    stage: 'done';
+    done: true;
+};
+type InstallFlowStage = AccountTypeStage | PreOptionsStage | PostOptionsStage | DoneStage;
+type StartOptions = {
+    onComplete?: VoidFunction;
+    onNext?: (nextState: InstallFlowStage) => void;
+};