@edge-markets/connect-react-native 1.4.1 → 1.5.0

package/README.md

@@ -133,9 +133,14 @@ React hook for EdgeLink integration.
 | `environment` | `'production' \| 'staging' \| 'sandbox'` | ✅ | Environment |
 | `redirectUri` | `string` | ✅ | Deep link URI for callback |
 | `scopes` | `EdgeScope[]` | ❌ | Requested permissions |
-| `linkUrl` | `string` | ❌ | Custom Link URL (dev only) |
+| `linkUrl` | `string` | ❌ | Custom Link URL/origin (dev only) |
 | `useExternalBrowser` | `boolean` | ❌ | Use external browser |
 
+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`.
+
 **Returns:**
 | Property | Type | Description |
 |----------|------|-------------|
@@ -304,10 +309,3 @@ Install and import `react-native-get-random-values` before any crypto operations
 
 MIT
 
-
-
-
-
-
-
-

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { EdgeLinkConfigBase, EdgeEnvironment, EdgeScope, EdgeLinkSuccess, EdgeLinkEvent, SdkGeolocation, PKCEPair } from '@edge-markets/connect';
-export { ALL_EDGE_SCOPES, Balance, EDGE_ENVIRONMENTS, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, EdgeEnvironment, EdgeError, EdgeLinkEvent, EdgeLinkEventName, EdgeLinkExit, EdgeLinkSuccess, EdgeNetworkError, EdgePopupBlockedError, EdgeScope, EdgeStateMismatchError, EdgeTokenExchangeError, EdgeTokens, PKCEPair, SCOPE_DESCRIPTIONS, SdkGeolocation, Transfer, User, formatScopesForEnvironment, getEnvironmentConfig, isApiError, isAuthenticationError, isConsentRequiredError, isNetworkError } from '@edge-markets/connect';
+export { ACTIVE_EDGE_SCOPES, ALL_EDGE_SCOPES, Balance, EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE, EDGE_ENVIRONMENTS, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, EdgeEnvironment, EdgeError, EdgeFeatureUnavailableError, EdgeLinkEvent, EdgeLinkEventName, EdgeLinkExit, EdgeLinkSuccess, EdgeNetworkError, EdgePopupBlockedError, EdgeScope, EdgeStateMismatchError, EdgeTokenExchangeError, EdgeTokens, PKCEPair, SCOPE_DESCRIPTIONS, SdkGeolocation, Transfer, User, formatScopesForEnvironment, getEnvironmentConfig, isApiError, isAuthenticationError, isConsentRequiredError, isFeatureUnavailableError, isNetworkError } from '@edge-markets/connect';
 
 interface EdgeLinkConfig extends EdgeLinkConfigBase {
     redirectUri: string;
@@ -18,6 +18,8 @@ declare class EdgeLink {
     close(): Promise<void>;
     destroy(): void;
     private buildLinkUrl;
+    private getScopes;
+    private assertActiveScopes;
     private setupLinkListener;
     private removeLinkListener;
     private processCallback;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { EdgeLinkConfigBase, EdgeEnvironment, EdgeScope, EdgeLinkSuccess, EdgeLinkEvent, SdkGeolocation, PKCEPair } from '@edge-markets/connect';
-export { ALL_EDGE_SCOPES, Balance, EDGE_ENVIRONMENTS, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, EdgeEnvironment, EdgeError, EdgeLinkEvent, EdgeLinkEventName, EdgeLinkExit, EdgeLinkSuccess, EdgeNetworkError, EdgePopupBlockedError, EdgeScope, EdgeStateMismatchError, EdgeTokenExchangeError, EdgeTokens, PKCEPair, SCOPE_DESCRIPTIONS, SdkGeolocation, Transfer, User, formatScopesForEnvironment, getEnvironmentConfig, isApiError, isAuthenticationError, isConsentRequiredError, isNetworkError } from '@edge-markets/connect';
+export { ACTIVE_EDGE_SCOPES, ALL_EDGE_SCOPES, Balance, EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE, EDGE_ENVIRONMENTS, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, EdgeEnvironment, EdgeError, EdgeFeatureUnavailableError, EdgeLinkEvent, EdgeLinkEventName, EdgeLinkExit, EdgeLinkSuccess, EdgeNetworkError, EdgePopupBlockedError, EdgeScope, EdgeStateMismatchError, EdgeTokenExchangeError, EdgeTokens, PKCEPair, SCOPE_DESCRIPTIONS, SdkGeolocation, Transfer, User, formatScopesForEnvironment, getEnvironmentConfig, isApiError, isAuthenticationError, isConsentRequiredError, isFeatureUnavailableError, isNetworkError } from '@edge-markets/connect';
 
 interface EdgeLinkConfig extends EdgeLinkConfigBase {
     redirectUri: string;
@@ -18,6 +18,8 @@ declare class EdgeLink {
     close(): Promise<void>;
     destroy(): void;
     private buildLinkUrl;
+    private getScopes;
+    private assertActiveScopes;
     private setupLinkListener;
     private removeLinkListener;
     private processCallback;

package/dist/index.js

@@ -30,12 +30,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ACTIVE_EDGE_SCOPES: () => import_connect2.ACTIVE_EDGE_SCOPES,
   ALL_EDGE_SCOPES: () => import_connect2.ALL_EDGE_SCOPES,
+  EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE: () => import_connect2.EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE,
   EDGE_ENVIRONMENTS: () => import_connect2.EDGE_ENVIRONMENTS,
   EdgeApiError: () => import_connect2.EdgeApiError,
   EdgeAuthenticationError: () => import_connect2.EdgeAuthenticationError,
   EdgeConsentRequiredError: () => import_connect2.EdgeConsentRequiredError,
   EdgeError: () => import_connect2.EdgeError,
+  EdgeFeatureUnavailableError: () => import_connect2.EdgeFeatureUnavailableError,
   EdgeLink: () => EdgeLink,
   EdgeNetworkError: () => import_connect2.EdgeNetworkError,
   EdgePopupBlockedError: () => import_connect2.EdgePopupBlockedError,
@@ -50,6 +53,7 @@ __export(index_exports, {
   isApiError: () => import_connect2.isApiError,
   isAuthenticationError: () => import_connect2.isAuthenticationError,
   isConsentRequiredError: () => import_connect2.isConsentRequiredError,
+  isFeatureUnavailableError: () => import_connect2.isFeatureUnavailableError,
   isNetworkError: () => import_connect2.isNetworkError,
   isSecureCryptoAvailable: () => isSecureCryptoAvailable,
   useEdgeLink: () => useEdgeLink,
@@ -60,8 +64,8 @@ module.exports = __toCommonJS(index_exports);
 var import_connect2 = require("@edge-markets/connect");
 
 // src/edge-link.ts
-var import_react_native = require("react-native");
 var import_connect = require("@edge-markets/connect");
+var import_react_native = require("react-native");
 
 // src/pkce.ts
 function hasNativeCrypto() {
@@ -381,6 +385,8 @@ var EdgeLink = class {
       console.warn("[EdgeLink] Already open");
       return;
     }
+    const scopes = this.getScopes();
+    this.assertActiveScopes(scopes);
     this.emitEvent("OPEN");
     this.isOpen = true;
     try {
@@ -423,10 +429,8 @@ var EdgeLink = class {
     this.cleanup();
   }
   buildLinkUrl() {
-    const envConfig = (0, import_connect.getEnvironmentConfig)(this.config.environment);
-    const baseUrl = this.config.linkUrl || `${envConfig.userClientUrl}/oauth/link`;
-    const url = new URL(baseUrl);
-    const scopes = this.config.scopes || import_connect.ALL_EDGE_SCOPES;
+    const url = new URL((0, import_connect.getLinkUrl)(this.config.environment, this.config.linkUrl));
+    const scopes = this.getScopes();
     url.searchParams.set("client_id", this.config.clientId);
     url.searchParams.set("state", this.state);
     url.searchParams.set("code_challenge", this.pkce.challenge);
@@ -438,6 +442,14 @@ var EdgeLink = class {
     url.searchParams.set("flow", "redirect");
     return url.toString();
   }
+  getScopes() {
+    return this.config.scopes || import_connect.ACTIVE_EDGE_SCOPES;
+  }
+  assertActiveScopes(scopes) {
+    if (scopes.some((scope) => (0, import_connect.isTransferWriteScope)(scope))) {
+      throw new import_connect.EdgeFeatureUnavailableError();
+    }
+  }
   setupLinkListener() {
     this.removeLinkListener();
     this.linkListener = import_react_native.Linking.addEventListener("url", ({ url }) => {
@@ -570,21 +582,23 @@ function useEdgeLink(config) {
       linkRef.current?.destroy();
       linkRef.current = null;
     };
-  }, [
-    config.clientId,
-    config.environment,
-    config.redirectUri,
-    config.scopes,
-    config.linkUrl,
-    config.useExternalBrowser
-  ]);
+  }, [config.clientId, config.environment, config.redirectUri, config.scopes, config.linkUrl, config.useExternalBrowser]);
   const open = (0, import_react.useCallback)(async () => {
     if (!linkRef.current) return;
     setIsOpen(true);
     setIsSuccess(false);
     setIsError(false);
     setError(null);
-    await linkRef.current.open();
+    try {
+      await linkRef.current.open();
+    } catch (err) {
+      setIsOpen(false);
+      setIsError(true);
+      setError({
+        code: err instanceof Error && "code" in err ? String(err.code) : "open_failed",
+        message: err instanceof Error ? err.message : "Failed to open EdgeLink"
+      });
+    }
   }, []);
   const close = (0, import_react.useCallback)(async () => {
     if (!linkRef.current) return;
@@ -696,12 +710,15 @@ async function collectGeolocation() {
 }
 // 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_ENVIRONMENTS,
   EdgeApiError,
   EdgeAuthenticationError,
   EdgeConsentRequiredError,
   EdgeError,
+  EdgeFeatureUnavailableError,
   EdgeLink,
   EdgeNetworkError,
   EdgePopupBlockedError,
@@ -716,6 +733,7 @@ async function collectGeolocation() {
   isApiError,
   isAuthenticationError,
   isConsentRequiredError,
+  isFeatureUnavailableError,
   isNetworkError,
   isSecureCryptoAvailable,
   useEdgeLink,

package/dist/index.mjs

@@ -1,31 +1,37 @@
 // src/index.ts
 import {
-  ALL_EDGE_SCOPES as ALL_EDGE_SCOPES2,
+  ACTIVE_EDGE_SCOPES as ACTIVE_EDGE_SCOPES2,
+  ALL_EDGE_SCOPES,
+  EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE,
   EDGE_ENVIRONMENTS,
   EdgeApiError,
   EdgeAuthenticationError,
   EdgeConsentRequiredError,
   EdgeError,
+  EdgeFeatureUnavailableError as EdgeFeatureUnavailableError2,
   EdgeNetworkError,
   EdgePopupBlockedError,
   EdgeStateMismatchError,
   EdgeTokenExchangeError,
   SCOPE_DESCRIPTIONS,
   formatScopesForEnvironment as formatScopesForEnvironment2,
-  getEnvironmentConfig as getEnvironmentConfig2,
+  getEnvironmentConfig,
   isApiError,
   isAuthenticationError,
   isConsentRequiredError,
+  isFeatureUnavailableError,
   isNetworkError
 } from "@edge-markets/connect";
 
 // src/edge-link.ts
-import { Linking, Platform } from "react-native";
 import {
-  getEnvironmentConfig,
-  ALL_EDGE_SCOPES,
-  formatScopesForEnvironment
+  ACTIVE_EDGE_SCOPES,
+  EdgeFeatureUnavailableError,
+  formatScopesForEnvironment,
+  getLinkUrl,
+  isTransferWriteScope
 } from "@edge-markets/connect";
+import { Linking, Platform } from "react-native";
 
 // src/pkce.ts
 function hasNativeCrypto() {
@@ -345,6 +351,8 @@ var EdgeLink = class {
       console.warn("[EdgeLink] Already open");
       return;
     }
+    const scopes = this.getScopes();
+    this.assertActiveScopes(scopes);
     this.emitEvent("OPEN");
     this.isOpen = true;
     try {
@@ -387,10 +395,8 @@ var EdgeLink = class {
     this.cleanup();
   }
   buildLinkUrl() {
-    const envConfig = getEnvironmentConfig(this.config.environment);
-    const baseUrl = this.config.linkUrl || `${envConfig.userClientUrl}/oauth/link`;
-    const url = new URL(baseUrl);
-    const scopes = this.config.scopes || ALL_EDGE_SCOPES;
+    const url = new URL(getLinkUrl(this.config.environment, this.config.linkUrl));
+    const scopes = this.getScopes();
     url.searchParams.set("client_id", this.config.clientId);
     url.searchParams.set("state", this.state);
     url.searchParams.set("code_challenge", this.pkce.challenge);
@@ -402,6 +408,14 @@ var EdgeLink = class {
     url.searchParams.set("flow", "redirect");
     return url.toString();
   }
+  getScopes() {
+    return this.config.scopes || ACTIVE_EDGE_SCOPES;
+  }
+  assertActiveScopes(scopes) {
+    if (scopes.some((scope) => isTransferWriteScope(scope))) {
+      throw new EdgeFeatureUnavailableError();
+    }
+  }
   setupLinkListener() {
     this.removeLinkListener();
     this.linkListener = Linking.addEventListener("url", ({ url }) => {
@@ -534,21 +548,23 @@ function useEdgeLink(config) {
       linkRef.current?.destroy();
       linkRef.current = null;
     };
-  }, [
-    config.clientId,
-    config.environment,
-    config.redirectUri,
-    config.scopes,
-    config.linkUrl,
-    config.useExternalBrowser
-  ]);
+  }, [config.clientId, config.environment, config.redirectUri, config.scopes, config.linkUrl, config.useExternalBrowser]);
   const open = useCallback(async () => {
     if (!linkRef.current) return;
     setIsOpen(true);
     setIsSuccess(false);
     setIsError(false);
     setError(null);
-    await linkRef.current.open();
+    try {
+      await linkRef.current.open();
+    } catch (err) {
+      setIsOpen(false);
+      setIsError(true);
+      setError({
+        code: err instanceof Error && "code" in err ? String(err.code) : "open_failed",
+        message: err instanceof Error ? err.message : "Failed to open EdgeLink"
+      });
+    }
   }, []);
   const close = useCallback(async () => {
     if (!linkRef.current) return;
@@ -659,12 +675,15 @@ async function collectGeolocation() {
   return null;
 }
 export {
-  ALL_EDGE_SCOPES2 as ALL_EDGE_SCOPES,
+  ACTIVE_EDGE_SCOPES2 as ACTIVE_EDGE_SCOPES,
+  ALL_EDGE_SCOPES,
+  EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE,
   EDGE_ENVIRONMENTS,
   EdgeApiError,
   EdgeAuthenticationError,
   EdgeConsentRequiredError,
   EdgeError,
+  EdgeFeatureUnavailableError2 as EdgeFeatureUnavailableError,
   EdgeLink,
   EdgeNetworkError,
   EdgePopupBlockedError,
@@ -675,10 +694,11 @@ export {
   formatScopesForEnvironment2 as formatScopesForEnvironment,
   generatePKCE,
   generateState,
-  getEnvironmentConfig2 as getEnvironmentConfig,
+  getEnvironmentConfig,
   isApiError,
   isAuthenticationError,
   isConsentRequiredError,
+  isFeatureUnavailableError,
   isNetworkError,
   isSecureCryptoAvailable,
   useEdgeLink,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edge-markets/connect-react-native",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "React Native SDK for EDGE Connect authentication flow for mobile apps",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -30,7 +30,7 @@
   "author": "EdgeBoost",
   "license": "MIT",
   "dependencies": {
-    "@edge-markets/connect": "^1.5.1"
+    "@edge-markets/connect": "^1.8.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0",