@edge-markets/connect-link 1.5.1 → 1.7.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { EdgeLinkConfigBase, EdgeScope, EdgeLinkSuccess, EdgeLinkExit, SdkGeolocation, 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';
+import { EdgeLinkConfigBase, EdgeScope, SdkGeolocation, EdgeLinkSuccess, EdgeLinkExit, PKCEPair } from '@edge-markets/connect';
+export { ACTIVE_EDGE_SCOPES, ALL_EDGE_SCOPES, EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE, EDGE_SCOPES, EdgeEnvironment, EdgeError, EdgeFeatureUnavailableError, EdgeLinkEvent, EdgeLinkEventName, EdgeLinkExit, EdgeLinkSuccess, EdgePopupBlockedError, EdgeScope, EdgeStateMismatchError, PKCEPair, SdkGeolocation, isEdgeError, isFeatureUnavailableError } from '@edge-markets/connect';
 
 /**
  * EdgeLink - Popup Authentication for EDGE Connect
@@ -170,6 +170,7 @@ declare class EdgeLink {
      * - Returning code via postMessage
      */
     private buildLinkUrl;
+    private assertActiveScopes;
     /**
      * Sets up the postMessage listener.
      */
@@ -200,18 +201,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 +623,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 +899,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,5 +1,5 @@
-import { EdgeLinkConfigBase, EdgeScope, EdgeLinkSuccess, EdgeLinkExit, SdkGeolocation, 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';
+import { EdgeLinkConfigBase, EdgeScope, SdkGeolocation, EdgeLinkSuccess, EdgeLinkExit, PKCEPair } from '@edge-markets/connect';
+export { ACTIVE_EDGE_SCOPES, ALL_EDGE_SCOPES, EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE, EDGE_SCOPES, EdgeEnvironment, EdgeError, EdgeFeatureUnavailableError, EdgeLinkEvent, EdgeLinkEventName, EdgeLinkExit, EdgeLinkSuccess, EdgePopupBlockedError, EdgeScope, EdgeStateMismatchError, PKCEPair, SdkGeolocation, isEdgeError, isFeatureUnavailableError } from '@edge-markets/connect';
 
 /**
  * EdgeLink - Popup Authentication for EDGE Connect
@@ -170,6 +170,7 @@ declare class EdgeLink {
      * - Returning code via postMessage
      */
     private buildLinkUrl;
+    private assertActiveScopes;
     /**
      * Sets up the postMessage listener.
      */
@@ -200,18 +201,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 +623,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 +899,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

@@ -20,9 +20,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ACTIVE_EDGE_SCOPES: () => import_connect4.ACTIVE_EDGE_SCOPES,
   ALL_EDGE_SCOPES: () => import_connect4.ALL_EDGE_SCOPES,
+  EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE: () => import_connect3.EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE,
   EDGE_SCOPES: () => import_connect4.EDGE_SCOPES,
   EdgeError: () => import_connect3.EdgeError,
+  EdgeFeatureUnavailableError: () => import_connect3.EdgeFeatureUnavailableError,
   EdgeLink: () => EdgeLink,
   EdgePopupBlockedError: () => import_connect3.EdgePopupBlockedError,
   EdgeStateMismatchError: () => import_connect3.EdgeStateMismatchError,
@@ -33,7 +36,9 @@ __export(index_exports, {
   generatePKCE: () => generatePKCE,
   generateState: () => generateState,
   isEdgeError: () => import_connect3.isEdgeError,
-  useEdgeLink: () => useEdgeLink
+  isFeatureUnavailableError: () => import_connect3.isFeatureUnavailableError,
+  useEdgeLink: () => useEdgeLink,
+  useEdgeTransferVerify: () => useEdgeTransferVerify
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -387,6 +392,8 @@ var EdgeLink = class {
     if (this.isDestroyed) {
       throw new Error("EdgeLink: Cannot open - instance has been destroyed");
     }
+    const scopes = options.scopes || this.config.scopes || import_connect.ACTIVE_EDGE_SCOPES;
+    this.assertActiveScopes(scopes);
     if (this.popup.isOpen() || this.isInitializing) {
       this.popup.focus();
       return;
@@ -406,7 +413,7 @@ var EdgeLink = class {
       });
       throw new import_connect.EdgePopupBlockedError();
     }
-    this.initializeAuth(options.scopes || this.config.scopes || import_connect.ALL_EDGE_SCOPES);
+    this.initializeAuth(scopes);
   }
   /**
    * Closes the EdgeLink popup if open.
@@ -496,6 +503,11 @@ var EdgeLink = class {
     }
     return url.toString();
   }
+  assertActiveScopes(scopes) {
+    if (scopes.some((scope) => (0, import_connect.isTransferWriteScope)(scope))) {
+      throw new import_connect.EdgeFeatureUnavailableError();
+    }
+  }
   /**
    * Sets up the postMessage listener.
    */
@@ -612,56 +624,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");
@@ -920,6 +882,7 @@ var EdgeTransferVerify = class {
    * ```
    */
   open() {
+    assertTransferFeatureAvailable();
     if (this.isDestroyed) {
       throw new Error("EdgeTransferVerify: Cannot open - instance has been destroyed");
     }
@@ -1217,6 +1180,161 @@ var EdgeTransferVerify = class {
     this.config.onCancel?.(syntheticEvent);
   }
 };
+function assertTransferFeatureAvailable() {
+  if (!isTransferFeatureAvailable()) {
+    throw new import_connect2.EdgeFeatureUnavailableError();
+  }
+}
+function isTransferFeatureAvailable() {
+  return false;
+}
+
+// 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) {
@@ -1247,9 +1365,12 @@ var import_connect3 = require("@edge-markets/connect");
 var import_connect4 = require("@edge-markets/connect");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ACTIVE_EDGE_SCOPES,
   ALL_EDGE_SCOPES,
+  EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE,
   EDGE_SCOPES,
   EdgeError,
+  EdgeFeatureUnavailableError,
   EdgeLink,
   EdgePopupBlockedError,
   EdgeStateMismatchError,
@@ -1260,5 +1381,7 @@ var import_connect4 = require("@edge-markets/connect");
   generatePKCE,
   generateState,
   isEdgeError,
-  useEdgeLink
+  isFeatureUnavailableError,
+  useEdgeLink,
+  useEdgeTransferVerify
 });

package/dist/index.mjs

@@ -1,9 +1,11 @@
 // src/edge-link.ts
 import {
-  ALL_EDGE_SCOPES,
+  ACTIVE_EDGE_SCOPES,
+  EdgeFeatureUnavailableError,
   EdgePopupBlockedError,
   formatScopesForEnvironment,
-  getLinkUrl
+  getLinkUrl,
+  isTransferWriteScope
 } from "@edge-markets/connect";
 
 // src/pkce.ts
@@ -353,6 +355,8 @@ var EdgeLink = class {
     if (this.isDestroyed) {
       throw new Error("EdgeLink: Cannot open - instance has been destroyed");
     }
+    const scopes = options.scopes || this.config.scopes || ACTIVE_EDGE_SCOPES;
+    this.assertActiveScopes(scopes);
     if (this.popup.isOpen() || this.isInitializing) {
       this.popup.focus();
       return;
@@ -372,7 +376,7 @@ var EdgeLink = class {
       });
       throw new EdgePopupBlockedError();
     }
-    this.initializeAuth(options.scopes || this.config.scopes || ALL_EDGE_SCOPES);
+    this.initializeAuth(scopes);
   }
   /**
    * Closes the EdgeLink popup if open.
@@ -462,6 +466,11 @@ var EdgeLink = class {
     }
     return url.toString();
   }
+  assertActiveScopes(scopes) {
+    if (scopes.some((scope) => isTransferWriteScope(scope))) {
+      throw new EdgeFeatureUnavailableError();
+    }
+  }
   /**
    * Sets up the postMessage listener.
    */
@@ -577,60 +586,10 @@ 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";
+import { EdgeFeatureUnavailableError as EdgeFeatureUnavailableError2, EdgePopupBlockedError as EdgePopupBlockedError2 } from "@edge-markets/connect";
 
 // src/iframe-manager.ts
 var DEFAULT_TITLE = "EDGE Connect Transfer Verification";
@@ -886,6 +845,7 @@ var EdgeTransferVerify = class {
    * ```
    */
   open() {
+    assertTransferFeatureAvailable();
     if (this.isDestroyed) {
       throw new Error("EdgeTransferVerify: Cannot open - instance has been destroyed");
     }
@@ -1183,6 +1143,161 @@ var EdgeTransferVerify = class {
     this.config.onCancel?.(syntheticEvent);
   }
 };
+function assertTransferFeatureAvailable() {
+  if (!isTransferFeatureAvailable()) {
+    throw new EdgeFeatureUnavailableError2();
+  }
+}
+function isTransferFeatureAvailable() {
+  return false;
+}
+
+// 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) {
@@ -1209,12 +1324,23 @@ async function collectGeolocation(options) {
 }
 
 // src/index.ts
-import { EdgeError, EdgePopupBlockedError as EdgePopupBlockedError3, EdgeStateMismatchError, isEdgeError } from "@edge-markets/connect";
-import { ALL_EDGE_SCOPES as ALL_EDGE_SCOPES2, EDGE_SCOPES } from "@edge-markets/connect";
+import {
+  EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE,
+  EdgeError,
+  EdgeFeatureUnavailableError as EdgeFeatureUnavailableError3,
+  EdgePopupBlockedError as EdgePopupBlockedError3,
+  EdgeStateMismatchError,
+  isEdgeError,
+  isFeatureUnavailableError
+} from "@edge-markets/connect";
+import { ACTIVE_EDGE_SCOPES as ACTIVE_EDGE_SCOPES2, ALL_EDGE_SCOPES, EDGE_SCOPES } from "@edge-markets/connect";
 export {
-  ALL_EDGE_SCOPES2 as ALL_EDGE_SCOPES,
+  ACTIVE_EDGE_SCOPES2 as ACTIVE_EDGE_SCOPES,
+  ALL_EDGE_SCOPES,
+  EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE,
   EDGE_SCOPES,
   EdgeError,
+  EdgeFeatureUnavailableError3 as EdgeFeatureUnavailableError,
   EdgeLink,
   EdgePopupBlockedError3 as EdgePopupBlockedError,
   EdgeStateMismatchError,
@@ -1225,5 +1351,7 @@ export {
   generatePKCE,
   generateState,
   isEdgeError,
-  useEdgeLink
+  isFeatureUnavailableError,
+  useEdgeLink,
+  useEdgeTransferVerify
 };

package/package.json

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