@useparagon/connect 2.2.3-experimental.2 → 2.2.3-experimental.4

package/dist/src/types/action.d.ts

@@ -1,6 +1,6 @@
 import { ReactNode } from 'react';
 import { AuthenticationScheme } from '../entities/credential.interface';
-import { CustomDropdownField, DynamicMappingField, DynamicMappingOptions, SidebarInput } from './connect';
+import { CustomDropdownField, DynamicMappingField, DynamicMappingOptions, InstructionStage, SidebarInput } from './connect';
 import { DataType, KeyedSource, Source } from './resolvers';
 export declare enum SidebarInputType {
     Auth = "AUTH",
@@ -399,4 +399,5 @@ export type AccountType = {
      */
     skipPostOAuthInputs?: boolean;
 };
+export type InstructionMetadata = Pick<InstructionStage, 'content' | 'ctas' | 'finish' | 'packageInstallUrl'>;
 export {};

package/dist/src/types/connect.d.ts

@@ -5,7 +5,7 @@ import { PersonaMeta } from '../entities/persona.interface';
 import { AccountType, BooleanInput, ComboInput, CopyableButtonInput, CustomDropdownInput, DataSource, DynamicComboInput, DynamicEnumInput, EmailInput, FieldMapperInput, FileInput, IntegrationConnectInput, NumberInput, PasswordInput, PermissionInput, SidebarInputType, SwitchInput, URLInput, ValueTextInput } from './action';
 import { InstallFlowError } from './errors';
 import { OrConditions } from './resolvers';
-import { CredentialConfigOptions } from './sdk';
+import { CredentialConfigOptions, IntegrationInstallEvent } from './sdk';
 export { CredentialStatus } from '../entities/connectCredential.interface';
 export type { IntegrationMetadata } from '../entities/integration.interface';
 export * from './errors';
@@ -217,6 +217,9 @@ export type SDKIntegrationConfig = {
     dataSources: {
         [key: string]: DataSource;
     };
+    authSchemeOptions?: {
+        packageInstallUrl?: string;
+    };
 };
 /**
  * The contents of the `integrations` field for an authenticated ConnectUser.
@@ -242,11 +245,35 @@ export declare const INFER_CONTENT_TYPE_FROM_CONNECT_OPTIONS = "auto";
 export declare const SELECTED_CREDENTIAL_ID_HEADER = "X-Paragon-Credential";
 export declare const SELECTED_CREDENTIAL_CONFIG_ID_HEADER = "X-Paragon-Configuration-Id";
 export declare const SDK_VERSION_HEADER = "X-Paragon-SDK-Version";
+export type Link = {
+    label: string;
+    type: 'link';
+    href: string;
+};
+export type FinishButton = {
+    type: 'finishButton';
+    label: string;
+    onClick: () => void;
+};
+export type CopyButton = {
+    label: string;
+    type: 'copyButton';
+    copyText: string;
+};
+export type CTA = Link | CopyButton;
 export type AccountTypeStage = {
     stage: 'accountType';
     options: AccountType[];
     done: false;
 };
+export type InstructionStage = {
+    stage: 'instruction';
+    content: string;
+    ctas: CTA[];
+    finish: FinishButton;
+    packageInstallUrl: string;
+    done: false;
+};
 export type PreOptionsStage = {
     stage: 'preOptions';
     options: IntegrationConnectInput[];
@@ -257,11 +284,15 @@ export type PostOptionsStage = {
     options: IntegrationConnectInput[];
     done: false;
 };
+export type OAuthStage = {
+    stage: 'oauth';
+    done: false;
+};
 export type DoneStage = {
     stage: 'done';
     done: true;
 };
-export type InstallFlowStage = AccountTypeStage | PreOptionsStage | PostOptionsStage | DoneStage;
+export type InstallFlowStage = AccountTypeStage | InstructionStage | PreOptionsStage | OAuthStage | PostOptionsStage | DoneStage;
 export type OnErrorContext = {
     /**
      * The stage of the install flow that failed.
@@ -272,7 +303,7 @@ export type StartOptions = {
     /**
      * Callback to be called when the installation is complete
      */
-    onComplete?: VoidFunction;
+    onComplete?: (installationEvent: IntegrationInstallEvent) => void;
     onNext?: (nextState: InstallFlowStage) => void;
     /**
      * Callback to be called when the installation fails.
@@ -294,4 +325,7 @@ export type StartOptions = {
      * Closes the popup and raises an error if the flow is not completed within the given timeout.
      */
     oauthTimeout?: number;
+    allowMultipleCredentials?: boolean;
+    overrideRedirectUrl?: string;
+    selectedCredentialId?: string;
 };

package/dist/src/types/sdk.d.ts

@@ -118,7 +118,7 @@ export interface IConnectSDK {
      * Invoked by the OAuth popup after finishing the credential exchange.
      * @private
      */
-    _oauthCallback(credential: OauthCallbackResponse, credentialId?: string): Promise<void>;
+    _oauthCallback(credential: OauthCallbackResponse, credentialId?: string): Promise<IntegrationInstallEvent | undefined>;
     /**
      * **Do not call this function directly.**
      *
@@ -262,7 +262,7 @@ export interface IConnectSDK {
     getPreOptions(params: string): any;
     getPostOptions(params: string): any;
     startOAuthFlow(action: string, apiInstallationOptions: InstallOptions & CredentialConfigOptions, options?: {
-        onSuccess?: (connectCredentialId: string) => void;
+        onSuccess?: (installationEvent: IntegrationInstallEvent) => void;
         onError?: (error: unknown) => void;
     }): void;
     getFieldOptions(options: {
@@ -278,6 +278,7 @@ export interface IConnectSDK {
     }>;
     getDataSourceOptions(integrationName: string, action: string): Promise<DataSource | undefined>;
     installFlow: InstallFlow;
+    getAssetUrl(name: string): string;
 }
 /**
  * sdk install options
@@ -440,6 +441,7 @@ export type FilePickerOptions = {
         googledrive?: {
             viewMode?: google.picker.DocsViewMode;
             includeFolders?: boolean;
+            enableSharedDrives?: boolean;
         };
         box?: {
             container?: string;

package/dist/src/utils/dedent.d.ts

@@ -0,0 +1 @@
+export declare function dedent(str: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useparagon/connect",
-  "version": "2.2.3-experimental.2",
+  "version": "2.2.3-experimental.4",
   "description": "Embed integrations into your app with the Paragon SDK",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",