@edge-markets/connect-link 1.5.0 → 1.6.0

package/README.md

@@ -93,11 +93,16 @@ interface EdgeLinkConfig {
   onExit?: (metadata) => void   // Called when user exits
   onEvent?: (event) => void     // Called for analytics events
   scopes?: EdgeScope[]          // Scopes to request (default: all)
-  linkUrl?: string              // Custom Link URL (dev only)
+  linkUrl?: string              // Custom Link URL/origin (dev only)
   redirectUri?: string          // Legacy popup callback URI (migration only)
 }
 ```
 
+The SDK derives the hosted Link URL from `environment`; staging defaults to
+`https://oauth.staging-app.edgeboost.io/oauth/link`. `linkUrl` is only needed for
+nonstandard deployments. If provided as an origin, for example
+`https://oauth.example.com`, the SDK appends `/oauth/link`.
+
 Popup integrations are origin-based. Register your frontend origin with EDGE
 for `postMessage` validation, for example:
 
@@ -325,9 +330,3 @@ function ConnectButton() {
 
 MIT
 
-
-
-
-
-
-

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { EdgeLinkConfigBase, EdgeScope, EdgeLinkSuccess, EdgeLinkExit, SdkGeolocation, PKCEPair } from '@edge-markets/connect';
+import { EdgeLinkConfigBase, EdgeScope, SdkGeolocation, EdgeLinkSuccess, EdgeLinkExit, PKCEPair } from '@edge-markets/connect';
 export { ALL_EDGE_SCOPES, EDGE_SCOPES, EdgeEnvironment, EdgeError, EdgeLinkEvent, EdgeLinkEventName, EdgeLinkExit, EdgeLinkSuccess, EdgePopupBlockedError, EdgeScope, EdgeStateMismatchError, PKCEPair, SdkGeolocation, isEdgeError } from '@edge-markets/connect';
 
 /**
@@ -200,18 +200,6 @@ declare class EdgeLink {
     private cleanup;
 }
 
-interface UseEdgeLinkConfig extends Omit<EdgeLinkConfig, 'onSuccess' | 'onExit'> {
-    onSuccess?: (result: EdgeLinkSuccess) => void | Promise<void>;
-    onExit?: (metadata: EdgeLinkExit) => void;
-}
-interface UseEdgeLinkReturn {
-    open: (options?: EdgeLinkOpenOptions) => void;
-    ready: boolean;
-    error: Error | null;
-    isOpen: boolean;
-}
-declare function useEdgeLink(config: UseEdgeLinkConfig): UseEdgeLinkReturn;
-
 /**
  * EdgeTransferVerify - Transfer Verification Launcher for EDGE Connect
  *
@@ -634,6 +622,37 @@ declare class EdgeTransferVerify {
     private handleUserClose;
 }
 
+interface UseEdgeLinkConfig extends Omit<EdgeLinkConfig, 'onSuccess' | 'onExit'> {
+    onSuccess?: (result: EdgeLinkSuccess) => void | Promise<void>;
+    onExit?: (metadata: EdgeLinkExit) => void;
+}
+interface UseEdgeLinkReturn {
+    open: (options?: EdgeLinkOpenOptions) => void;
+    ready: boolean;
+    error: Error | null;
+    isOpen: boolean;
+}
+declare function useEdgeLink(config: UseEdgeLinkConfig): UseEdgeLinkReturn;
+interface UseEdgeTransferVerifyConfig extends Omit<EdgeTransferVerifyConfig, 'onSuccess' | 'onError' | 'onCancel' | 'onExpired' | 'onLoaded' | 'onEvent'> {
+    onSuccess?: (event: TransferVerifyEvent) => void | Promise<void>;
+    onError?: (event: TransferVerifyEvent) => void | Promise<void>;
+    onCancel?: (event: TransferVerifyEvent) => void | Promise<void>;
+    onExpired?: (event: TransferVerifyEvent) => void | Promise<void>;
+    onLoaded?: (event: TransferVerifyEvent) => void | Promise<void>;
+    onEvent?: (event: TransferVerifyEvent) => void | Promise<void>;
+}
+interface UseEdgeTransferVerifyReturn {
+    open: () => void;
+    close: () => void;
+    destroy: () => void;
+    ready: boolean;
+    isOpen: boolean;
+    isLoaded: boolean;
+    lastEvent: TransferVerifyEvent | null;
+    error: Error | null;
+}
+declare function useEdgeTransferVerify(config: UseEdgeTransferVerifyConfig): UseEdgeTransferVerifyReturn;
+
 /**
  * Iframe Manager
  *
@@ -879,4 +898,4 @@ declare function generateState(): string;
  */
 declare function assertCryptoAvailable(): void;
 
-export { EdgeLink, type EdgeLinkConfig, type EdgeLinkOpenOptions, EdgeTransferVerify, type EdgeTransferVerifyConfig, type GeolocationOptions, type IframeCallbacks, type IframeConfig, IframeManager, type TransferVerifyEvent, type TransferVerifyEventType, type TransferVerifyMode, type UseEdgeLinkConfig, type UseEdgeLinkReturn, assertCryptoAvailable, collectGeolocation, generatePKCE, generateState, useEdgeLink };
+export { EdgeLink, type EdgeLinkConfig, type EdgeLinkOpenOptions, EdgeTransferVerify, type EdgeTransferVerifyConfig, type GeolocationOptions, type IframeCallbacks, type IframeConfig, IframeManager, type TransferVerifyEvent, type TransferVerifyEventType, type TransferVerifyMode, type UseEdgeLinkConfig, type UseEdgeLinkReturn, type UseEdgeTransferVerifyConfig, type UseEdgeTransferVerifyReturn, assertCryptoAvailable, collectGeolocation, generatePKCE, generateState, useEdgeLink, useEdgeTransferVerify };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { EdgeLinkConfigBase, EdgeScope, EdgeLinkSuccess, EdgeLinkExit, SdkGeolocation, PKCEPair } from '@edge-markets/connect';
+import { EdgeLinkConfigBase, EdgeScope, SdkGeolocation, EdgeLinkSuccess, EdgeLinkExit, PKCEPair } from '@edge-markets/connect';
 export { ALL_EDGE_SCOPES, EDGE_SCOPES, EdgeEnvironment, EdgeError, EdgeLinkEvent, EdgeLinkEventName, EdgeLinkExit, EdgeLinkSuccess, EdgePopupBlockedError, EdgeScope, EdgeStateMismatchError, PKCEPair, SdkGeolocation, isEdgeError } from '@edge-markets/connect';
 
 /**
@@ -200,18 +200,6 @@ declare class EdgeLink {
     private cleanup;
 }
 
-interface UseEdgeLinkConfig extends Omit<EdgeLinkConfig, 'onSuccess' | 'onExit'> {
-    onSuccess?: (result: EdgeLinkSuccess) => void | Promise<void>;
-    onExit?: (metadata: EdgeLinkExit) => void;
-}
-interface UseEdgeLinkReturn {
-    open: (options?: EdgeLinkOpenOptions) => void;
-    ready: boolean;
-    error: Error | null;
-    isOpen: boolean;
-}
-declare function useEdgeLink(config: UseEdgeLinkConfig): UseEdgeLinkReturn;
-
 /**
  * EdgeTransferVerify - Transfer Verification Launcher for EDGE Connect
  *
@@ -634,6 +622,37 @@ declare class EdgeTransferVerify {
     private handleUserClose;
 }
 
+interface UseEdgeLinkConfig extends Omit<EdgeLinkConfig, 'onSuccess' | 'onExit'> {
+    onSuccess?: (result: EdgeLinkSuccess) => void | Promise<void>;
+    onExit?: (metadata: EdgeLinkExit) => void;
+}
+interface UseEdgeLinkReturn {
+    open: (options?: EdgeLinkOpenOptions) => void;
+    ready: boolean;
+    error: Error | null;
+    isOpen: boolean;
+}
+declare function useEdgeLink(config: UseEdgeLinkConfig): UseEdgeLinkReturn;
+interface UseEdgeTransferVerifyConfig extends Omit<EdgeTransferVerifyConfig, 'onSuccess' | 'onError' | 'onCancel' | 'onExpired' | 'onLoaded' | 'onEvent'> {
+    onSuccess?: (event: TransferVerifyEvent) => void | Promise<void>;
+    onError?: (event: TransferVerifyEvent) => void | Promise<void>;
+    onCancel?: (event: TransferVerifyEvent) => void | Promise<void>;
+    onExpired?: (event: TransferVerifyEvent) => void | Promise<void>;
+    onLoaded?: (event: TransferVerifyEvent) => void | Promise<void>;
+    onEvent?: (event: TransferVerifyEvent) => void | Promise<void>;
+}
+interface UseEdgeTransferVerifyReturn {
+    open: () => void;
+    close: () => void;
+    destroy: () => void;
+    ready: boolean;
+    isOpen: boolean;
+    isLoaded: boolean;
+    lastEvent: TransferVerifyEvent | null;
+    error: Error | null;
+}
+declare function useEdgeTransferVerify(config: UseEdgeTransferVerifyConfig): UseEdgeTransferVerifyReturn;
+
 /**
  * Iframe Manager
  *
@@ -879,4 +898,4 @@ declare function generateState(): string;
  */
 declare function assertCryptoAvailable(): void;
 
-export { EdgeLink, type EdgeLinkConfig, type EdgeLinkOpenOptions, EdgeTransferVerify, type EdgeTransferVerifyConfig, type GeolocationOptions, type IframeCallbacks, type IframeConfig, IframeManager, type TransferVerifyEvent, type TransferVerifyEventType, type TransferVerifyMode, type UseEdgeLinkConfig, type UseEdgeLinkReturn, assertCryptoAvailable, collectGeolocation, generatePKCE, generateState, useEdgeLink };
+export { EdgeLink, type EdgeLinkConfig, type EdgeLinkOpenOptions, EdgeTransferVerify, type EdgeTransferVerifyConfig, type GeolocationOptions, type IframeCallbacks, type IframeConfig, IframeManager, type TransferVerifyEvent, type TransferVerifyEventType, type TransferVerifyMode, type UseEdgeLinkConfig, type UseEdgeLinkReturn, type UseEdgeTransferVerifyConfig, type UseEdgeTransferVerifyReturn, assertCryptoAvailable, collectGeolocation, generatePKCE, generateState, useEdgeLink, useEdgeTransferVerify };

package/dist/index.js

@@ -33,7 +33,8 @@ __export(index_exports, {
   generatePKCE: () => generatePKCE,
   generateState: () => generateState,
   isEdgeError: () => import_connect3.isEdgeError,
-  useEdgeLink: () => useEdgeLink
+  useEdgeLink: () => useEdgeLink,
+  useEdgeTransferVerify: () => useEdgeTransferVerify
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -356,8 +357,7 @@ var EdgeLink = class {
     assertCryptoAvailable();
     this.config = config;
     this.popup = new PopupManager();
-    const envConfig = (0, import_connect.getEnvironmentConfig)(config.environment);
-    this.expectedOrigin = config.linkUrl ? new URL(config.linkUrl).origin : new URL(envConfig.userClientUrl).origin;
+    this.expectedOrigin = new URL((0, import_connect.getLinkUrl)(config.environment, config.linkUrl)).origin;
     this.setupMessageListener();
   }
   // ===========================================================================
@@ -482,9 +482,7 @@ var EdgeLink = class {
    * - Returning code via postMessage
    */
   buildLinkUrl(scopes) {
-    const envConfig = (0, import_connect.getEnvironmentConfig)(this.config.environment);
-    const baseUrl = this.config.linkUrl || `${envConfig.userClientUrl}/oauth/link`;
-    const url = new URL(baseUrl);
+    const url = new URL((0, import_connect.getLinkUrl)(this.config.environment, this.config.linkUrl));
     url.searchParams.set("client_id", this.config.clientId);
     url.searchParams.set("state", this.state);
     url.searchParams.set("code_challenge", this.pkce.challenge);
@@ -615,56 +613,6 @@ var EdgeLink = class {
 
 // src/hooks.ts
 var import_react = require("react");
-function useEdgeLink(config) {
-  const linkRef = (0, import_react.useRef)(null);
-  const [ready, setReady] = (0, import_react.useState)(false);
-  const [error, setError] = (0, import_react.useState)(null);
-  const [isOpen, setIsOpen] = (0, import_react.useState)(false);
-  const configRef = (0, import_react.useRef)(config);
-  configRef.current = config;
-  (0, import_react.useEffect)(() => {
-    try {
-      linkRef.current = new EdgeLink({
-        ...configRef.current,
-        onSuccess: (result) => {
-          setIsOpen(false);
-          configRef.current.onSuccess?.(result);
-        },
-        onExit: (metadata) => {
-          setIsOpen(false);
-          configRef.current.onExit?.(metadata);
-        },
-        onEvent: (event) => {
-          if (event.eventName === "OPEN") setIsOpen(true);
-          if (event.eventName === "CLOSE") setIsOpen(false);
-          configRef.current.onEvent?.(event);
-        }
-      });
-      setReady(true);
-      setError(null);
-    } catch (err) {
-      setError(err instanceof Error ? err : new Error("Failed to initialize EdgeLink"));
-      setReady(false);
-    }
-    return () => {
-      linkRef.current?.destroy();
-      linkRef.current = null;
-      setReady(false);
-    };
-  }, [config.clientId, config.environment]);
-  const open = (0, import_react.useCallback)((options) => {
-    if (!linkRef.current) {
-      setError(new Error("EdgeLink not initialized"));
-      return;
-    }
-    try {
-      linkRef.current.open(options);
-    } catch (err) {
-      setError(err instanceof Error ? err : new Error("Failed to open EdgeLink"));
-    }
-  }, []);
-  return { open, ready, error, isOpen };
-}
 
 // src/edge-transfer-verify.ts
 var import_connect2 = require("@edge-markets/connect");
@@ -1221,6 +1169,153 @@ var EdgeTransferVerify = class {
   }
 };
 
+// src/hooks.ts
+function useEdgeLink(config) {
+  const linkRef = (0, import_react.useRef)(null);
+  const [ready, setReady] = (0, import_react.useState)(false);
+  const [error, setError] = (0, import_react.useState)(null);
+  const [isOpen, setIsOpen] = (0, import_react.useState)(false);
+  const configRef = (0, import_react.useRef)(config);
+  configRef.current = config;
+  (0, import_react.useEffect)(() => {
+    try {
+      linkRef.current = new EdgeLink({
+        ...configRef.current,
+        onSuccess: (result) => {
+          setIsOpen(false);
+          configRef.current.onSuccess?.(result);
+        },
+        onExit: (metadata) => {
+          setIsOpen(false);
+          configRef.current.onExit?.(metadata);
+        },
+        onEvent: (event) => {
+          if (event.eventName === "OPEN") setIsOpen(true);
+          if (event.eventName === "CLOSE") setIsOpen(false);
+          configRef.current.onEvent?.(event);
+        }
+      });
+      setReady(true);
+      setError(null);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to initialize EdgeLink"));
+      setReady(false);
+    }
+    return () => {
+      linkRef.current?.destroy();
+      linkRef.current = null;
+      setReady(false);
+    };
+  }, [config.clientId, config.environment]);
+  const open = (0, import_react.useCallback)((options) => {
+    if (!linkRef.current) {
+      setError(new Error("EdgeLink not initialized"));
+      return;
+    }
+    try {
+      linkRef.current.open(options);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to open EdgeLink"));
+    }
+  }, []);
+  return { open, ready, error, isOpen };
+}
+function useEdgeTransferVerify(config) {
+  const verifyRef = (0, import_react.useRef)(null);
+  const [ready, setReady] = (0, import_react.useState)(false);
+  const [isOpen, setIsOpen] = (0, import_react.useState)(false);
+  const [isLoaded, setIsLoaded] = (0, import_react.useState)(false);
+  const [lastEvent, setLastEvent] = (0, import_react.useState)(null);
+  const [error, setError] = (0, import_react.useState)(null);
+  const configRef = (0, import_react.useRef)(config);
+  configRef.current = config;
+  (0, import_react.useEffect)(() => {
+    if ((configRef.current.mode || "iframe") === "iframe" && !configRef.current.container) {
+      verifyRef.current = null;
+      setReady(false);
+      setError(null);
+      setIsLoaded(false);
+      setLastEvent(null);
+      return;
+    }
+    try {
+      verifyRef.current = new EdgeTransferVerify({
+        ...configRef.current,
+        onSuccess: (event) => {
+          setIsOpen(false);
+          setLastEvent(event);
+          void configRef.current.onSuccess?.(event);
+        },
+        onError: (event) => {
+          setIsOpen(false);
+          setLastEvent(event);
+          setError(new Error(event.error || "EDGE transfer verification failed"));
+          void configRef.current.onError?.(event);
+        },
+        onCancel: (event) => {
+          setIsOpen(false);
+          setLastEvent(event);
+          void configRef.current.onCancel?.(event);
+        },
+        onExpired: (event) => {
+          setIsOpen(false);
+          setLastEvent(event);
+          void configRef.current.onExpired?.(event);
+        },
+        onLoaded: (event) => {
+          setIsLoaded(true);
+          setLastEvent(event);
+          void configRef.current.onLoaded?.(event);
+        },
+        onEvent: (event) => {
+          setLastEvent(event);
+          void configRef.current.onEvent?.(event);
+        }
+      });
+      setReady(true);
+      setError(null);
+      setIsLoaded(false);
+      setLastEvent(null);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to initialize EdgeTransferVerify"));
+      setReady(false);
+    }
+    return () => {
+      verifyRef.current?.destroy();
+      verifyRef.current = null;
+      setReady(false);
+      setIsOpen(false);
+      setIsLoaded(false);
+    };
+  }, [config.verificationUrl, config.sessionId, config.nonce, config.mode, config.container]);
+  const open = (0, import_react.useCallback)(() => {
+    if (!verifyRef.current) {
+      setError(new Error("EdgeTransferVerify not initialized"));
+      return;
+    }
+    try {
+      verifyRef.current.open();
+      setIsOpen(true);
+      setError(null);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to open EdgeTransferVerify"));
+      setIsOpen(false);
+    }
+  }, []);
+  const close = (0, import_react.useCallback)(() => {
+    verifyRef.current?.close();
+    setIsOpen(false);
+  }, []);
+  const destroy = (0, import_react.useCallback)(() => {
+    verifyRef.current?.destroy();
+    verifyRef.current = null;
+    setReady(false);
+    setIsOpen(false);
+    setIsLoaded(false);
+  }, []);
+  return { open, close, destroy, ready, isOpen, isLoaded, lastEvent, error };
+}
+
 // src/geolocation.ts
 async function collectGeolocation(options) {
   if (typeof navigator === "undefined" || !navigator.geolocation) {
@@ -1263,5 +1358,6 @@ var import_connect4 = require("@edge-markets/connect");
   generatePKCE,
   generateState,
   isEdgeError,
-  useEdgeLink
+  useEdgeLink,
+  useEdgeTransferVerify
 });

package/dist/index.mjs

@@ -3,7 +3,7 @@ import {
   ALL_EDGE_SCOPES,
   EdgePopupBlockedError,
   formatScopesForEnvironment,
-  getEnvironmentConfig
+  getLinkUrl
 } from "@edge-markets/connect";
 
 // src/pkce.ts
@@ -322,8 +322,7 @@ var EdgeLink = class {
     assertCryptoAvailable();
     this.config = config;
     this.popup = new PopupManager();
-    const envConfig = getEnvironmentConfig(config.environment);
-    this.expectedOrigin = config.linkUrl ? new URL(config.linkUrl).origin : new URL(envConfig.userClientUrl).origin;
+    this.expectedOrigin = new URL(getLinkUrl(config.environment, config.linkUrl)).origin;
     this.setupMessageListener();
   }
   // ===========================================================================
@@ -448,9 +447,7 @@ var EdgeLink = class {
    * - Returning code via postMessage
    */
   buildLinkUrl(scopes) {
-    const envConfig = getEnvironmentConfig(this.config.environment);
-    const baseUrl = this.config.linkUrl || `${envConfig.userClientUrl}/oauth/link`;
-    const url = new URL(baseUrl);
+    const url = new URL(getLinkUrl(this.config.environment, this.config.linkUrl));
     url.searchParams.set("client_id", this.config.clientId);
     url.searchParams.set("state", this.state);
     url.searchParams.set("code_challenge", this.pkce.challenge);
@@ -580,57 +577,7 @@ var EdgeLink = class {
 };
 
 // src/hooks.ts
-import { useEffect, useRef, useCallback, useState } from "react";
-function useEdgeLink(config) {
-  const linkRef = useRef(null);
-  const [ready, setReady] = useState(false);
-  const [error, setError] = useState(null);
-  const [isOpen, setIsOpen] = useState(false);
-  const configRef = useRef(config);
-  configRef.current = config;
-  useEffect(() => {
-    try {
-      linkRef.current = new EdgeLink({
-        ...configRef.current,
-        onSuccess: (result) => {
-          setIsOpen(false);
-          configRef.current.onSuccess?.(result);
-        },
-        onExit: (metadata) => {
-          setIsOpen(false);
-          configRef.current.onExit?.(metadata);
-        },
-        onEvent: (event) => {
-          if (event.eventName === "OPEN") setIsOpen(true);
-          if (event.eventName === "CLOSE") setIsOpen(false);
-          configRef.current.onEvent?.(event);
-        }
-      });
-      setReady(true);
-      setError(null);
-    } catch (err) {
-      setError(err instanceof Error ? err : new Error("Failed to initialize EdgeLink"));
-      setReady(false);
-    }
-    return () => {
-      linkRef.current?.destroy();
-      linkRef.current = null;
-      setReady(false);
-    };
-  }, [config.clientId, config.environment]);
-  const open = useCallback((options) => {
-    if (!linkRef.current) {
-      setError(new Error("EdgeLink not initialized"));
-      return;
-    }
-    try {
-      linkRef.current.open(options);
-    } catch (err) {
-      setError(err instanceof Error ? err : new Error("Failed to open EdgeLink"));
-    }
-  }, []);
-  return { open, ready, error, isOpen };
-}
+import { useCallback, useEffect, useRef, useState } from "react";
 
 // src/edge-transfer-verify.ts
 import { EdgePopupBlockedError as EdgePopupBlockedError2 } from "@edge-markets/connect";
@@ -1187,6 +1134,153 @@ var EdgeTransferVerify = class {
   }
 };
 
+// src/hooks.ts
+function useEdgeLink(config) {
+  const linkRef = useRef(null);
+  const [ready, setReady] = useState(false);
+  const [error, setError] = useState(null);
+  const [isOpen, setIsOpen] = useState(false);
+  const configRef = useRef(config);
+  configRef.current = config;
+  useEffect(() => {
+    try {
+      linkRef.current = new EdgeLink({
+        ...configRef.current,
+        onSuccess: (result) => {
+          setIsOpen(false);
+          configRef.current.onSuccess?.(result);
+        },
+        onExit: (metadata) => {
+          setIsOpen(false);
+          configRef.current.onExit?.(metadata);
+        },
+        onEvent: (event) => {
+          if (event.eventName === "OPEN") setIsOpen(true);
+          if (event.eventName === "CLOSE") setIsOpen(false);
+          configRef.current.onEvent?.(event);
+        }
+      });
+      setReady(true);
+      setError(null);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to initialize EdgeLink"));
+      setReady(false);
+    }
+    return () => {
+      linkRef.current?.destroy();
+      linkRef.current = null;
+      setReady(false);
+    };
+  }, [config.clientId, config.environment]);
+  const open = useCallback((options) => {
+    if (!linkRef.current) {
+      setError(new Error("EdgeLink not initialized"));
+      return;
+    }
+    try {
+      linkRef.current.open(options);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to open EdgeLink"));
+    }
+  }, []);
+  return { open, ready, error, isOpen };
+}
+function useEdgeTransferVerify(config) {
+  const verifyRef = useRef(null);
+  const [ready, setReady] = useState(false);
+  const [isOpen, setIsOpen] = useState(false);
+  const [isLoaded, setIsLoaded] = useState(false);
+  const [lastEvent, setLastEvent] = useState(null);
+  const [error, setError] = useState(null);
+  const configRef = useRef(config);
+  configRef.current = config;
+  useEffect(() => {
+    if ((configRef.current.mode || "iframe") === "iframe" && !configRef.current.container) {
+      verifyRef.current = null;
+      setReady(false);
+      setError(null);
+      setIsLoaded(false);
+      setLastEvent(null);
+      return;
+    }
+    try {
+      verifyRef.current = new EdgeTransferVerify({
+        ...configRef.current,
+        onSuccess: (event) => {
+          setIsOpen(false);
+          setLastEvent(event);
+          void configRef.current.onSuccess?.(event);
+        },
+        onError: (event) => {
+          setIsOpen(false);
+          setLastEvent(event);
+          setError(new Error(event.error || "EDGE transfer verification failed"));
+          void configRef.current.onError?.(event);
+        },
+        onCancel: (event) => {
+          setIsOpen(false);
+          setLastEvent(event);
+          void configRef.current.onCancel?.(event);
+        },
+        onExpired: (event) => {
+          setIsOpen(false);
+          setLastEvent(event);
+          void configRef.current.onExpired?.(event);
+        },
+        onLoaded: (event) => {
+          setIsLoaded(true);
+          setLastEvent(event);
+          void configRef.current.onLoaded?.(event);
+        },
+        onEvent: (event) => {
+          setLastEvent(event);
+          void configRef.current.onEvent?.(event);
+        }
+      });
+      setReady(true);
+      setError(null);
+      setIsLoaded(false);
+      setLastEvent(null);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to initialize EdgeTransferVerify"));
+      setReady(false);
+    }
+    return () => {
+      verifyRef.current?.destroy();
+      verifyRef.current = null;
+      setReady(false);
+      setIsOpen(false);
+      setIsLoaded(false);
+    };
+  }, [config.verificationUrl, config.sessionId, config.nonce, config.mode, config.container]);
+  const open = useCallback(() => {
+    if (!verifyRef.current) {
+      setError(new Error("EdgeTransferVerify not initialized"));
+      return;
+    }
+    try {
+      verifyRef.current.open();
+      setIsOpen(true);
+      setError(null);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to open EdgeTransferVerify"));
+      setIsOpen(false);
+    }
+  }, []);
+  const close = useCallback(() => {
+    verifyRef.current?.close();
+    setIsOpen(false);
+  }, []);
+  const destroy = useCallback(() => {
+    verifyRef.current?.destroy();
+    verifyRef.current = null;
+    setReady(false);
+    setIsOpen(false);
+    setIsLoaded(false);
+  }, []);
+  return { open, close, destroy, ready, isOpen, isLoaded, lastEvent, error };
+}
+
 // src/geolocation.ts
 async function collectGeolocation(options) {
   if (typeof navigator === "undefined" || !navigator.geolocation) {
@@ -1228,5 +1322,6 @@ export {
   generatePKCE,
   generateState,
   isEdgeError,
-  useEdgeLink
+  useEdgeLink,
+  useEdgeTransferVerify
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edge-markets/connect-link",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Browser SDK for EDGE Connect popup authentication",
   "author": "EdgeBoost",
   "license": "MIT",
@@ -21,7 +21,7 @@
     }
   },
   "dependencies": {
-    "@edge-markets/connect": "^1.5.1"
+    "@edge-markets/connect": "^1.7.0"
   },
   "peerDependencies": {
     "react": ">=17.0.0"