@turnkey/core 2.6.0 → 2.7.0

package/dist/__generated__/sdk-client-base.mjs

@@ -1,5 +1,5 @@
 import { VERSION } from './version.mjs';
-import { TERMINAL_ACTIVITY_STATUSES, TurnkeyRequestError, TurnkeyError, TurnkeyErrorCodes } from '@turnkey/sdk-types';
+import { TERMINAL_ACTIVITY_STATUSES, ActivityStatus, TurnkeyRequestError, TurnkeyError, TurnkeyErrorCodes } from '@turnkey/sdk-types';
 import { StamperType } from '../__types__/enums.mjs';
 
 /* @generated by codegen. DO NOT EDIT BY HAND */
@@ -6044,6 +6044,9 @@ class TurnkeySDKClientBase {
         if (config.walletStamper) {
             this.walletStamper = config.walletStamper;
         }
+        if (config.attestedStamper) {
+            this.attestedStamper = config.attestedStamper;
+        }
         if (config.storageManager) {
             this.storageManager = config.storageManager;
         }
@@ -6061,6 +6064,9 @@ class TurnkeySDKClientBase {
             else if (this.walletStamper) {
                 this.defaultStamperType = StamperType.Wallet;
             }
+            else if (this.attestedStamper) {
+                this.defaultStamperType = StamperType.Attested;
+            }
             else {
                 this.defaultStamperType = undefined;
             }
@@ -6078,6 +6084,8 @@ class TurnkeySDKClientBase {
                 return this.passkeyStamper;
             case StamperType.Wallet:
                 return this.walletStamper;
+            case StamperType.Attested:
+                return this.attestedStamper;
             default:
                 return this.apiKeyStamper;
         }
@@ -6108,7 +6116,7 @@ class TurnkeySDKClientBase {
      */
     handleActivityResponse(activityData, resultKey) {
         const { result, status } = activityData.activity;
-        if (status === "ACTIVITY_STATUS_COMPLETED" && result) {
+        if (status === ActivityStatus.COMPLETED && result) {
             // If a specific resultKey was provided, use it
             if (resultKey && result[resultKey]) {
                 return {
@@ -6128,6 +6136,52 @@ class TurnkeySDKClientBase {
         }
         return activityData;
     }
+    /**
+     * If the activity requires MFA (AUTHENTICATORS_NEEDED) or consensus
+     * (CONSENSUS_NEEDED) and an onMfaRequired callback is configured, fetch the
+     * MFA statuses for the activity, invoke the callback, and then poll for
+     * completion. Returns the (possibly updated) activity data.
+     * @internal
+     */
+    async handleMfaIfNeeded(activityData, stampWith) {
+        const AUTHENTICATORS_NEEDED = ActivityStatus.AUTHENTICATORS_NEEDED;
+        // We need to check for CONSENSUS_NEEDED as well, since that can also involve MFA (user is NOT the proposer but has MFA).
+        const CONSENSUS_NEEDED = ActivityStatus.CONSENSUS_NEEDED;
+        const activityStatus = activityData.activity.status;
+        // Only AUTHENTICATORS_NEEDED and CONSENSUS_NEEDED can involve MFA.
+        // Anything else is returned as-is.
+        if (activityStatus !== AUTHENTICATORS_NEEDED &&
+            activityStatus !== CONSENSUS_NEEDED) {
+            return activityData;
+        }
+        if (!this.config.onMfaRequired) {
+            return activityData;
+        }
+        // Fetch the MFA statuses for this activity.
+        const { mfaStatuses } = await this.getMfaStatus({
+            activityId: activityData.activity.id,
+            organizationId: activityData.activity.organizationId,
+        }, stampWith);
+        // For CONSENSUS_NEEDED there may be no MFA statuses.
+        // In that case, return the activity as-is.
+        if (activityStatus === CONSENSUS_NEEDED &&
+            (!mfaStatuses || mfaStatuses.length === 0)) {
+            return activityData;
+        }
+        const mfaContext = {
+            activityId: activityData.activity.id,
+            fingerprint: activityData.activity.fingerprint,
+            organizationId: activityData.activity.organizationId,
+            activityType: activityData.activity.type,
+            activityStatus,
+            mfaStatuses,
+        };
+        // Await the callback — it should resolve when MFA approval is complete
+        await this.config.onMfaRequired(mfaContext);
+        // After callback resolves, poll for the updated activity status
+        activityData = await this.pollForCompletion(activityData.activity.id, stampWith);
+        return activityData;
+    }
     async request(url, body, stampWith) {
         const fullUrl = this.config.apiBaseUrl + url;
         const stringifiedBody = JSON.stringify(body);
@@ -6167,6 +6221,8 @@ class TurnkeySDKClientBase {
         if (!TERMINAL_ACTIVITY_STATUSES.includes(activityData.activity.status)) {
             activityData = await this.pollForCompletion(activityData.activity.id, stampWith);
         }
+        // Handle MFA if needed (callback gate + re-poll)
+        activityData = await this.handleMfaIfNeeded(activityData, stampWith);
         return this.handleActivityResponse(activityData, resultKey);
     }
     async activityDecision(url, body, stampWith) {
@@ -6252,6 +6308,8 @@ class TurnkeySDKClientBase {
             if (!TERMINAL_ACTIVITY_STATUSES.includes(activityData.activity.status)) {
                 activityData = await this.pollForCompletion(activityData.activity.id);
             }
+            // Handle MFA if needed (callback gate + re-poll)
+            activityData = await this.handleMfaIfNeeded(activityData);
             return this.handleActivityResponse(activityData, options?.resultKey);
         }
         return data;