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

package/dist/src/ConnectSDK.d.ts

@@ -75,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
@@ -175,9 +187,6 @@ 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;
     /**
      * Send a Connect API request. Automatically handles authorization and errors.
@@ -254,8 +263,12 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
     private getIntegrationForWorkflow;
     private updateLocalState;
     /**
-     * gets the user data from api `/sdk/me`
-     * userMeta header is passed to support user metadata upsert based on authentication options
+     * Sends user metadata to the API via PATCH /sdk/me (request body supports non-ASCII).
+     */
+    private patchUserMetadata;
+    /**
+     * Gets the user data from api `/sdk/me`.
+     * User metadata is set via PATCH after this succeeds when provided in authenticate (see updateLocalState).
      */
     private fetchUserData;
     /**
@@ -344,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;