@edge-markets/connect-react-native 1.4.2 → 1.5.1

package/README.md

@@ -74,7 +74,7 @@ import { Button, Alert } from 'react-native'
 function ConnectEdgeButton() {
   const { open, isOpen, isSuccess, result, error, reset } = useEdgeLink({
     clientId: 'your-client-id',
-    environment: 'staging',
+    environment: 'sandbox',
     redirectUri: 'myapp://oauth/callback',
   })
 
@@ -130,14 +130,14 @@ React hook for EdgeLink integration.
 | Property | Type | Required | Description |
 |----------|------|----------|-------------|
 | `clientId` | `string` | ✅ | Your OAuth client ID |
-| `environment` | `'production' \| 'staging' \| 'sandbox'` | ✅ | Environment |
+| `environment` | `'production' \| 'sandbox'` | ✅ | Environment |
 | `redirectUri` | `string` | ✅ | Deep link URI for callback |
 | `scopes` | `EdgeScope[]` | ❌ | Requested permissions |
 | `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
+The SDK derives the hosted Link URL from `environment`; sandbox defaults to
+`https://sandbox-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`.
 
@@ -162,7 +162,7 @@ import { EdgeLink } from '@edge-markets/connect-react-native'
 
 const link = new EdgeLink({
   clientId: 'your-client-id',
-  environment: 'staging',
+  environment: 'sandbox',
   redirectUri: 'myapp://oauth/callback',
   onSuccess: (result) => {
     console.log('Auth code:', result.code)
@@ -262,7 +262,7 @@ import { EdgeConnectServer } from '@edge-markets/connect-node'
 const server = new EdgeConnectServer({
   clientId: 'your-client-id',
   clientSecret: 'your-client-secret',
-  environment: 'staging',
+  environment: 'sandbox',
 })
 
 // In your API endpoint

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, RESERVED_EDGE_SCOPES, 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;
@@ -85,7 +87,7 @@ interface UseEdgeLinkReturn {
  * function ConnectButton() {
  *   const { open, isOpen, isSuccess, result, error } = useEdgeLink({
  *     clientId: 'your-client-id',
- *     environment: 'staging',
+ *     environment: 'sandbox',
  *     redirectUri: 'myapp://oauth/callback',
  *   })
  *

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, RESERVED_EDGE_SCOPES, 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;
@@ -85,7 +87,7 @@ interface UseEdgeLinkReturn {
  * function ConnectButton() {
  *   const { open, isOpen, isSuccess, result, error } = useEdgeLink({
  *     clientId: 'your-client-id',
- *     environment: 'staging',
+ *     environment: 'sandbox',
  *     redirectUri: 'myapp://oauth/callback',
  *   })
  *

package/dist/index.js

@@ -30,17 +30,21 @@ 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,
   EdgeStateMismatchError: () => import_connect2.EdgeStateMismatchError,
   EdgeTokenExchangeError: () => import_connect2.EdgeTokenExchangeError,
+  RESERVED_EDGE_SCOPES: () => import_connect2.RESERVED_EDGE_SCOPES,
   SCOPE_DESCRIPTIONS: () => import_connect2.SCOPE_DESCRIPTIONS,
   collectGeolocation: () => collectGeolocation,
   formatScopesForEnvironment: () => import_connect2.formatScopesForEnvironment,
@@ -50,6 +54,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,
@@ -381,6 +386,8 @@ var EdgeLink = class {
       console.warn("[EdgeLink] Already open");
       return;
     }
+    const scopes = this.getScopes();
+    this.assertActiveScopes(scopes);
     this.emitEvent("OPEN");
     this.isOpen = true;
     try {
@@ -424,7 +431,7 @@ var EdgeLink = class {
   }
   buildLinkUrl() {
     const url = new URL((0, import_connect.getLinkUrl)(this.config.environment, this.config.linkUrl));
-    const scopes = this.config.scopes || import_connect.ALL_EDGE_SCOPES;
+    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);
@@ -436,6 +443,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 }) => {
@@ -568,21 +583,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;
@@ -694,17 +711,21 @@ 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,
   EdgeStateMismatchError,
   EdgeTokenExchangeError,
+  RESERVED_EDGE_SCOPES,
   SCOPE_DESCRIPTIONS,
   collectGeolocation,
   formatScopesForEnvironment,
@@ -714,6 +735,7 @@ async function collectGeolocation() {
   isApiError,
   isAuthenticationError,
   isConsentRequiredError,
+  isFeatureUnavailableError,
   isNetworkError,
   isSecureCryptoAvailable,
   useEdgeLink,

package/dist/index.mjs

@@ -1,11 +1,15 @@
 // src/index.ts
 import {
-  ALL_EDGE_SCOPES as ALL_EDGE_SCOPES2,
+  ACTIVE_EDGE_SCOPES as ACTIVE_EDGE_SCOPES2,
+  ALL_EDGE_SCOPES,
+  RESERVED_EDGE_SCOPES,
+  EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE,
   EDGE_ENVIRONMENTS,
   EdgeApiError,
   EdgeAuthenticationError,
   EdgeConsentRequiredError,
   EdgeError,
+  EdgeFeatureUnavailableError as EdgeFeatureUnavailableError2,
   EdgeNetworkError,
   EdgePopupBlockedError,
   EdgeStateMismatchError,
@@ -16,14 +20,17 @@ import {
   isApiError,
   isAuthenticationError,
   isConsentRequiredError,
+  isFeatureUnavailableError,
   isNetworkError
 } from "@edge-markets/connect";
 
 // src/edge-link.ts
 import {
-  ALL_EDGE_SCOPES,
+  ACTIVE_EDGE_SCOPES,
+  EdgeFeatureUnavailableError,
   formatScopesForEnvironment,
-  getLinkUrl
+  getLinkUrl,
+  isTransferWriteScope
 } from "@edge-markets/connect";
 import { Linking, Platform } from "react-native";
 
@@ -345,6 +352,8 @@ var EdgeLink = class {
       console.warn("[EdgeLink] Already open");
       return;
     }
+    const scopes = this.getScopes();
+    this.assertActiveScopes(scopes);
     this.emitEvent("OPEN");
     this.isOpen = true;
     try {
@@ -388,7 +397,7 @@ var EdgeLink = class {
   }
   buildLinkUrl() {
     const url = new URL(getLinkUrl(this.config.environment, this.config.linkUrl));
-    const scopes = this.config.scopes || ALL_EDGE_SCOPES;
+    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);
@@ -400,6 +409,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 }) => {
@@ -532,21 +549,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;
@@ -657,17 +676,21 @@ 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,
   EdgeStateMismatchError,
   EdgeTokenExchangeError,
+  RESERVED_EDGE_SCOPES,
   SCOPE_DESCRIPTIONS,
   collectGeolocation,
   formatScopesForEnvironment2 as formatScopesForEnvironment,
@@ -677,6 +700,7 @@ export {
   isApiError,
   isAuthenticationError,
   isConsentRequiredError,
+  isFeatureUnavailableError,
   isNetworkError,
   isSecureCryptoAvailable,
   useEdgeLink,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edge-markets/connect-react-native",
-  "version": "1.4.2",
+  "version": "1.5.1",
   "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.6.1"
+    "@edge-markets/connect": "^1.9.1"
   },
   "peerDependencies": {
     "react": ">=18.0.0",