@edge-markets/connect 1.8.0 → 1.9.1

package/README.md

@@ -92,13 +92,13 @@ import {
   formatScopeForEnvironment,
 } from '@edge-markets/connect'
 
-const config = getEnvironmentConfig('staging')
+const config = getEnvironmentConfig('sandbox')
 console.log(config.apiBaseUrl) // https://...
-console.log(getLinkUrl('staging')) // https://oauth.staging-app.edgeboost.io/oauth/link
+console.log(getLinkUrl('sandbox')) // https://sandbox-oauth.staging-app.edgeboost.io/oauth/link
 
 // Format scopes for your environment
-const scopes = formatScopeForEnvironment(EDGE_SCOPES.BALANCE_READ, 'staging')
-// Returns: 'edge-connect-staging/balance.read'
+const scopes = formatScopeForEnvironment(EDGE_SCOPES.BALANCE_READ, 'sandbox')
+// Returns: 'edge-connect-sandbox/balance.read'
 ```
 
 ### Error Handling
@@ -153,7 +153,9 @@ try {
 | `EDGE_ENVIRONMENTS` | All environment configs |
 | `getEnvironmentConfig(env)` | Get config for environment |
 | `EDGE_SCOPES` | Available OAuth scopes |
-| `ALL_EDGE_SCOPES` | All scopes as array |
+| `ACTIVE_EDGE_SCOPES` | Scopes enabled for current partner integrations |
+| `ALL_EDGE_SCOPES` | Alias for all currently requestable scopes |
+| `RESERVED_EDGE_SCOPES` | Future-only scopes that should not be requested |
 | `formatScopeForEnvironment(scope, env)` | Format scope for Cognito |
 
 ### Errors

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-type EdgeEnvironment = 'production' | 'staging' | 'sandbox' | 'development';
+type EdgeEnvironment = 'production' | 'sandbox';
 declare const EDGE_LINK_PATH = "/oauth/link";
 interface EdgeEnvironmentConfig {
     /**
@@ -32,6 +32,7 @@ declare function getAvailableEnvironments(): readonly EdgeEnvironment[];
  *
  * @module @edge-markets/connect/config
  */
+
 /**
  * Available OAuth scopes for EDGE Connect.
  *
@@ -45,7 +46,7 @@ declare function getAvailableEnvironments(): readonly EdgeEnvironment[];
  *   scopes: [EDGE_SCOPES.USER_READ, EDGE_SCOPES.BALANCE_READ],
  * })
  *
- * // Or request all scopes
+ * // Or request all currently enabled scopes
  * link.open({
  *   scopes: ALL_EDGE_SCOPES,
  * })
@@ -63,9 +64,10 @@ declare const EDGE_SCOPES: {
      */
     readonly BALANCE_READ: "balance.read";
     /**
-     * Initiate fund transfers and create EDGE-hosted verification sessions.
-     * Not available yet. Requesting this scope from Link SDKs fails with
-     * EdgeFeatureUnavailableError until EDGE enables transfers for partners.
+     * Reserved for future fund transfers and EDGE-hosted verification sessions.
+     * Not available in sandbox or production. Requesting this scope from Link
+     * SDKs fails with EdgeFeatureUnavailableError until EDGE enables transfers
+     * for a partner.
      *
      * Required for: `POST /v1/transfer`, `POST /v1/transfer/:id/verification-session`, `GET /v1/transfers`
      */
@@ -76,27 +78,34 @@ declare const EDGE_SCOPES: {
  */
 type EdgeScope = (typeof EDGE_SCOPES)[keyof typeof EDGE_SCOPES];
 /**
- * All available scopes as an array.
- * Use when you need full access to all API features.
+ * Scopes active for current EDGE Connect partner integrations.
+ *
+ * Transfers are intentionally unavailable for now, so SDK Link flows request
+ * this set by default.
+ */
+declare const ACTIVE_EDGE_SCOPES: readonly EdgeScope[];
+/**
+ * Reserved scopes kept in the SDK catalog for future feature launches.
+ *
+ * Do not request these scopes unless EDGE has explicitly enabled the feature
+ * for your integration.
+ */
+declare const RESERVED_EDGE_SCOPES: readonly EdgeScope[];
+/**
+ * All currently requestable scopes as an array.
+ * This intentionally excludes reserved scopes such as `transfer.write`.
  *
  * @example
  * ```typescript
  * const link = new EdgeLink({
  *   clientId: 'your-client-id',
- *   environment: 'staging',
- *   scopes: ALL_EDGE_SCOPES, // Request all permissions
+ *   environment: 'sandbox',
+ *   scopes: ALL_EDGE_SCOPES, // Same values as ACTIVE_EDGE_SCOPES today
  *   onSuccess: handleSuccess,
  * })
  * ```
  */
 declare const ALL_EDGE_SCOPES: readonly EdgeScope[];
-/**
- * Scopes active for current EDGE Connect partner integrations.
- *
- * Transfers are intentionally unavailable for now, so SDK default Link flows
- * should request this set rather than {@link ALL_EDGE_SCOPES}.
- */
-declare const ACTIVE_EDGE_SCOPES: readonly EdgeScope[];
 /**
  * Human-readable descriptions for each scope.
  * Useful for building custom consent UIs or explaining permissions.
@@ -113,26 +122,20 @@ declare const SCOPE_ICONS: Readonly<Record<EdgeScope, string>>;
  * Different environments may use different scope prefixes in the API Gateway.
  * This function handles the prefix automatically.
  *
- * Note: 'development' environment uses 'staging' scope prefix because it
- * connects to the staging API Gateway for local testing.
- *
  * @param scope - The scope to format
  * @param environment - The target environment
  * @returns The full scope string for API Gateway authorization
  *
  * @example
  * ```typescript
- * formatScopeForEnvironment('user.read', 'staging')
- * // Returns: 'edge-connect-staging/user.read'
+ * formatScopeForEnvironment('user.read', 'sandbox')
+ * // Returns: 'edge-connect-sandbox/user.read'
  *
  * formatScopeForEnvironment('user.read', 'production')
  * // Returns: 'edge-connect/user.read'
- *
- * formatScopeForEnvironment('user.read', 'development')
- * // Returns: 'edge-connect-staging/user.read' (maps to staging)
  * ```
  */
-declare function formatScopeForEnvironment(scope: EdgeScope, environment: 'production' | 'staging' | 'sandbox' | 'development'): string;
+declare function formatScopeForEnvironment(scope: EdgeScope, environment: EdgeEnvironment): string;
 /**
  * Formats multiple scopes for an environment.
  *
@@ -140,11 +143,11 @@ declare function formatScopeForEnvironment(scope: EdgeScope, environment: 'produ
  * @param environment - The target environment
  * @returns Array of full scope strings
  */
-declare function formatScopesForEnvironment(scopes: readonly EdgeScope[] | EdgeScope[], environment: 'production' | 'staging' | 'sandbox' | 'development'): string[];
+declare function formatScopesForEnvironment(scopes: readonly EdgeScope[] | EdgeScope[], environment: EdgeEnvironment): string[];
 /**
  * Parses a full scope string to extract the base scope.
  *
- * @param fullScope - The full scope string (e.g., 'edge-connect-staging/user.read')
+ * @param fullScope - The full scope string (e.g., 'edge-connect-sandbox/user.read')
  * @returns The base scope (e.g., 'user.read') or null if invalid
  */
 declare function parseScope(fullScope: string): EdgeScope | null;
@@ -155,7 +158,7 @@ declare function isValidScope(scope: string): scope is EdgeScope;
 /**
  * Checks whether a scope string requests the future transfer feature.
  * Accepts either short scopes (`transfer.write`) or formatted environment
- * scopes (`edge-connect-staging/transfer.write`).
+ * scopes (`edge-connect-sandbox/transfer.write`).
  */
 declare function isTransferWriteScope(scope: string): boolean;
 
@@ -2782,7 +2785,7 @@ interface EdgeTokens {
  * ```typescript
  * const link = new EdgeLink({
  *   clientId: 'your-client-id',
- *   environment: 'staging',
+ *   environment: 'sandbox',
  *   onSuccess: (result: EdgeLinkSuccess) => {
  *     // Send to your backend
  *     fetch('/api/edge/exchange', {
@@ -3205,7 +3208,7 @@ declare function isFeatureUnavailableError(error: unknown): error is EdgeFeature
  *
  * This package provides the foundation for building EDGE Connect integrations:
  * - Type definitions generated from the OpenAPI spec
- * - Environment configuration (production, staging, sandbox)
+ * - Environment configuration (production, sandbox)
  * - OAuth scope constants
  * - Typed error classes
  *
@@ -3245,4 +3248,4 @@ declare const SDK_VERSION = "1.0.0";
  */
 declare const SDK_NAME = "@edge-markets/connect";
 
-export { ACTIVE_EDGE_SCOPES, ALL_EDGE_SCOPES, type ApiError, type Balance, type BaseWebhookEvent, type ConsentRequiredError, type ConsentRevokedEventData, type CreateVerificationSessionRequest, EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE, EDGE_ENVIRONMENTS, EDGE_LINK_PATH, EDGE_SCOPES, EDGE_WEBHOOK_EVENT_TYPES, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, type EdgeEnvironment, type EdgeEnvironmentConfig, EdgeError, EdgeFeatureUnavailableError, EdgeIdentityVerificationError, EdgeInsufficientScopeError, type EdgeLinkConfigBase, type EdgeLinkEvent, type EdgeLinkEventName, type EdgeLinkExit, type EdgeLinkSuccess, EdgeNetworkError, EdgeNotFoundError, EdgePopupBlockedError, EdgePopupClosedError, type EdgeScope, EdgeStateMismatchError, EdgeTokenExchangeError, type EdgeTokens, EdgeValidationError, type EdgeWebhookEvent, type EdgeWebhookEventType, type InitiateTransferRequest, type ListTransfersParams, OTP_METHODS, type OtpMethod, type PKCEPair, type RevokeConsentResponse, SCOPE_DESCRIPTIONS, SCOPE_ICONS, SDK_NAME, SDK_VERSION, type SdkGeolocation, TRANSFER_CATEGORIES, TRANSFER_STATUSES, TRANSFER_TYPES, type Transfer, type TransferCategory, type TransferCompletedEventData, type TransferExpiredEventData, type TransferFailedEventData, type TransferList, type TransferListItem, type TransferProcessingEventData, type TransferStatus, type TransferType, type User, type UserAddress, type VerificationSession, type VerificationSessionStatus, type VerificationSessionStatusResponse, type VerifyIdentityAddress, type VerifyIdentityOptions, type VerifyIdentityResult, type VerifyIdentityScores, type components, formatScopeForEnvironment, formatScopesForEnvironment, getAvailableEnvironments, getEnvironmentConfig, getLinkUrl, isApiError, isAuthenticationError, isConsentRequiredError, isEdgeError, isFeatureUnavailableError, isIdentityVerificationError, isNetworkError, isProductionEnvironment, isTransferWriteScope, isValidScope, type operations, parseScope, type paths };
+export { ACTIVE_EDGE_SCOPES, ALL_EDGE_SCOPES, type ApiError, type Balance, type BaseWebhookEvent, type ConsentRequiredError, type ConsentRevokedEventData, type CreateVerificationSessionRequest, EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE, EDGE_ENVIRONMENTS, EDGE_LINK_PATH, EDGE_SCOPES, EDGE_WEBHOOK_EVENT_TYPES, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, type EdgeEnvironment, type EdgeEnvironmentConfig, EdgeError, EdgeFeatureUnavailableError, EdgeIdentityVerificationError, EdgeInsufficientScopeError, type EdgeLinkConfigBase, type EdgeLinkEvent, type EdgeLinkEventName, type EdgeLinkExit, type EdgeLinkSuccess, EdgeNetworkError, EdgeNotFoundError, EdgePopupBlockedError, EdgePopupClosedError, type EdgeScope, EdgeStateMismatchError, EdgeTokenExchangeError, type EdgeTokens, EdgeValidationError, type EdgeWebhookEvent, type EdgeWebhookEventType, type InitiateTransferRequest, type ListTransfersParams, OTP_METHODS, type OtpMethod, type PKCEPair, RESERVED_EDGE_SCOPES, type RevokeConsentResponse, SCOPE_DESCRIPTIONS, SCOPE_ICONS, SDK_NAME, SDK_VERSION, type SdkGeolocation, TRANSFER_CATEGORIES, TRANSFER_STATUSES, TRANSFER_TYPES, type Transfer, type TransferCategory, type TransferCompletedEventData, type TransferExpiredEventData, type TransferFailedEventData, type TransferList, type TransferListItem, type TransferProcessingEventData, type TransferStatus, type TransferType, type User, type UserAddress, type VerificationSession, type VerificationSessionStatus, type VerificationSessionStatusResponse, type VerifyIdentityAddress, type VerifyIdentityOptions, type VerifyIdentityResult, type VerifyIdentityScores, type components, formatScopeForEnvironment, formatScopesForEnvironment, getAvailableEnvironments, getEnvironmentConfig, getLinkUrl, isApiError, isAuthenticationError, isConsentRequiredError, isEdgeError, isFeatureUnavailableError, isIdentityVerificationError, isNetworkError, isProductionEnvironment, isTransferWriteScope, isValidScope, type operations, parseScope, type paths };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-type EdgeEnvironment = 'production' | 'staging' | 'sandbox' | 'development';
+type EdgeEnvironment = 'production' | 'sandbox';
 declare const EDGE_LINK_PATH = "/oauth/link";
 interface EdgeEnvironmentConfig {
     /**
@@ -32,6 +32,7 @@ declare function getAvailableEnvironments(): readonly EdgeEnvironment[];
  *
  * @module @edge-markets/connect/config
  */
+
 /**
  * Available OAuth scopes for EDGE Connect.
  *
@@ -45,7 +46,7 @@ declare function getAvailableEnvironments(): readonly EdgeEnvironment[];
  *   scopes: [EDGE_SCOPES.USER_READ, EDGE_SCOPES.BALANCE_READ],
  * })
  *
- * // Or request all scopes
+ * // Or request all currently enabled scopes
  * link.open({
  *   scopes: ALL_EDGE_SCOPES,
  * })
@@ -63,9 +64,10 @@ declare const EDGE_SCOPES: {
      */
     readonly BALANCE_READ: "balance.read";
     /**
-     * Initiate fund transfers and create EDGE-hosted verification sessions.
-     * Not available yet. Requesting this scope from Link SDKs fails with
-     * EdgeFeatureUnavailableError until EDGE enables transfers for partners.
+     * Reserved for future fund transfers and EDGE-hosted verification sessions.
+     * Not available in sandbox or production. Requesting this scope from Link
+     * SDKs fails with EdgeFeatureUnavailableError until EDGE enables transfers
+     * for a partner.
      *
      * Required for: `POST /v1/transfer`, `POST /v1/transfer/:id/verification-session`, `GET /v1/transfers`
      */
@@ -76,27 +78,34 @@ declare const EDGE_SCOPES: {
  */
 type EdgeScope = (typeof EDGE_SCOPES)[keyof typeof EDGE_SCOPES];
 /**
- * All available scopes as an array.
- * Use when you need full access to all API features.
+ * Scopes active for current EDGE Connect partner integrations.
+ *
+ * Transfers are intentionally unavailable for now, so SDK Link flows request
+ * this set by default.
+ */
+declare const ACTIVE_EDGE_SCOPES: readonly EdgeScope[];
+/**
+ * Reserved scopes kept in the SDK catalog for future feature launches.
+ *
+ * Do not request these scopes unless EDGE has explicitly enabled the feature
+ * for your integration.
+ */
+declare const RESERVED_EDGE_SCOPES: readonly EdgeScope[];
+/**
+ * All currently requestable scopes as an array.
+ * This intentionally excludes reserved scopes such as `transfer.write`.
  *
  * @example
  * ```typescript
  * const link = new EdgeLink({
  *   clientId: 'your-client-id',
- *   environment: 'staging',
- *   scopes: ALL_EDGE_SCOPES, // Request all permissions
+ *   environment: 'sandbox',
+ *   scopes: ALL_EDGE_SCOPES, // Same values as ACTIVE_EDGE_SCOPES today
  *   onSuccess: handleSuccess,
  * })
  * ```
  */
 declare const ALL_EDGE_SCOPES: readonly EdgeScope[];
-/**
- * Scopes active for current EDGE Connect partner integrations.
- *
- * Transfers are intentionally unavailable for now, so SDK default Link flows
- * should request this set rather than {@link ALL_EDGE_SCOPES}.
- */
-declare const ACTIVE_EDGE_SCOPES: readonly EdgeScope[];
 /**
  * Human-readable descriptions for each scope.
  * Useful for building custom consent UIs or explaining permissions.
@@ -113,26 +122,20 @@ declare const SCOPE_ICONS: Readonly<Record<EdgeScope, string>>;
  * Different environments may use different scope prefixes in the API Gateway.
  * This function handles the prefix automatically.
  *
- * Note: 'development' environment uses 'staging' scope prefix because it
- * connects to the staging API Gateway for local testing.
- *
  * @param scope - The scope to format
  * @param environment - The target environment
  * @returns The full scope string for API Gateway authorization
  *
  * @example
  * ```typescript
- * formatScopeForEnvironment('user.read', 'staging')
- * // Returns: 'edge-connect-staging/user.read'
+ * formatScopeForEnvironment('user.read', 'sandbox')
+ * // Returns: 'edge-connect-sandbox/user.read'
  *
  * formatScopeForEnvironment('user.read', 'production')
  * // Returns: 'edge-connect/user.read'
- *
- * formatScopeForEnvironment('user.read', 'development')
- * // Returns: 'edge-connect-staging/user.read' (maps to staging)
  * ```
  */
-declare function formatScopeForEnvironment(scope: EdgeScope, environment: 'production' | 'staging' | 'sandbox' | 'development'): string;
+declare function formatScopeForEnvironment(scope: EdgeScope, environment: EdgeEnvironment): string;
 /**
  * Formats multiple scopes for an environment.
  *
@@ -140,11 +143,11 @@ declare function formatScopeForEnvironment(scope: EdgeScope, environment: 'produ
  * @param environment - The target environment
  * @returns Array of full scope strings
  */
-declare function formatScopesForEnvironment(scopes: readonly EdgeScope[] | EdgeScope[], environment: 'production' | 'staging' | 'sandbox' | 'development'): string[];
+declare function formatScopesForEnvironment(scopes: readonly EdgeScope[] | EdgeScope[], environment: EdgeEnvironment): string[];
 /**
  * Parses a full scope string to extract the base scope.
  *
- * @param fullScope - The full scope string (e.g., 'edge-connect-staging/user.read')
+ * @param fullScope - The full scope string (e.g., 'edge-connect-sandbox/user.read')
  * @returns The base scope (e.g., 'user.read') or null if invalid
  */
 declare function parseScope(fullScope: string): EdgeScope | null;
@@ -155,7 +158,7 @@ declare function isValidScope(scope: string): scope is EdgeScope;
 /**
  * Checks whether a scope string requests the future transfer feature.
  * Accepts either short scopes (`transfer.write`) or formatted environment
- * scopes (`edge-connect-staging/transfer.write`).
+ * scopes (`edge-connect-sandbox/transfer.write`).
  */
 declare function isTransferWriteScope(scope: string): boolean;
 
@@ -2782,7 +2785,7 @@ interface EdgeTokens {
  * ```typescript
  * const link = new EdgeLink({
  *   clientId: 'your-client-id',
- *   environment: 'staging',
+ *   environment: 'sandbox',
  *   onSuccess: (result: EdgeLinkSuccess) => {
  *     // Send to your backend
  *     fetch('/api/edge/exchange', {
@@ -3205,7 +3208,7 @@ declare function isFeatureUnavailableError(error: unknown): error is EdgeFeature
  *
  * This package provides the foundation for building EDGE Connect integrations:
  * - Type definitions generated from the OpenAPI spec
- * - Environment configuration (production, staging, sandbox)
+ * - Environment configuration (production, sandbox)
  * - OAuth scope constants
  * - Typed error classes
  *
@@ -3245,4 +3248,4 @@ declare const SDK_VERSION = "1.0.0";
  */
 declare const SDK_NAME = "@edge-markets/connect";
 
-export { ACTIVE_EDGE_SCOPES, ALL_EDGE_SCOPES, type ApiError, type Balance, type BaseWebhookEvent, type ConsentRequiredError, type ConsentRevokedEventData, type CreateVerificationSessionRequest, EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE, EDGE_ENVIRONMENTS, EDGE_LINK_PATH, EDGE_SCOPES, EDGE_WEBHOOK_EVENT_TYPES, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, type EdgeEnvironment, type EdgeEnvironmentConfig, EdgeError, EdgeFeatureUnavailableError, EdgeIdentityVerificationError, EdgeInsufficientScopeError, type EdgeLinkConfigBase, type EdgeLinkEvent, type EdgeLinkEventName, type EdgeLinkExit, type EdgeLinkSuccess, EdgeNetworkError, EdgeNotFoundError, EdgePopupBlockedError, EdgePopupClosedError, type EdgeScope, EdgeStateMismatchError, EdgeTokenExchangeError, type EdgeTokens, EdgeValidationError, type EdgeWebhookEvent, type EdgeWebhookEventType, type InitiateTransferRequest, type ListTransfersParams, OTP_METHODS, type OtpMethod, type PKCEPair, type RevokeConsentResponse, SCOPE_DESCRIPTIONS, SCOPE_ICONS, SDK_NAME, SDK_VERSION, type SdkGeolocation, TRANSFER_CATEGORIES, TRANSFER_STATUSES, TRANSFER_TYPES, type Transfer, type TransferCategory, type TransferCompletedEventData, type TransferExpiredEventData, type TransferFailedEventData, type TransferList, type TransferListItem, type TransferProcessingEventData, type TransferStatus, type TransferType, type User, type UserAddress, type VerificationSession, type VerificationSessionStatus, type VerificationSessionStatusResponse, type VerifyIdentityAddress, type VerifyIdentityOptions, type VerifyIdentityResult, type VerifyIdentityScores, type components, formatScopeForEnvironment, formatScopesForEnvironment, getAvailableEnvironments, getEnvironmentConfig, getLinkUrl, isApiError, isAuthenticationError, isConsentRequiredError, isEdgeError, isFeatureUnavailableError, isIdentityVerificationError, isNetworkError, isProductionEnvironment, isTransferWriteScope, isValidScope, type operations, parseScope, type paths };
+export { ACTIVE_EDGE_SCOPES, ALL_EDGE_SCOPES, type ApiError, type Balance, type BaseWebhookEvent, type ConsentRequiredError, type ConsentRevokedEventData, type CreateVerificationSessionRequest, EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE, EDGE_ENVIRONMENTS, EDGE_LINK_PATH, EDGE_SCOPES, EDGE_WEBHOOK_EVENT_TYPES, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, type EdgeEnvironment, type EdgeEnvironmentConfig, EdgeError, EdgeFeatureUnavailableError, EdgeIdentityVerificationError, EdgeInsufficientScopeError, type EdgeLinkConfigBase, type EdgeLinkEvent, type EdgeLinkEventName, type EdgeLinkExit, type EdgeLinkSuccess, EdgeNetworkError, EdgeNotFoundError, EdgePopupBlockedError, EdgePopupClosedError, type EdgeScope, EdgeStateMismatchError, EdgeTokenExchangeError, type EdgeTokens, EdgeValidationError, type EdgeWebhookEvent, type EdgeWebhookEventType, type InitiateTransferRequest, type ListTransfersParams, OTP_METHODS, type OtpMethod, type PKCEPair, RESERVED_EDGE_SCOPES, type RevokeConsentResponse, SCOPE_DESCRIPTIONS, SCOPE_ICONS, SDK_NAME, SDK_VERSION, type SdkGeolocation, TRANSFER_CATEGORIES, TRANSFER_STATUSES, TRANSFER_TYPES, type Transfer, type TransferCategory, type TransferCompletedEventData, type TransferExpiredEventData, type TransferFailedEventData, type TransferList, type TransferListItem, type TransferProcessingEventData, type TransferStatus, type TransferType, type User, type UserAddress, type VerificationSession, type VerificationSessionStatus, type VerificationSessionStatusResponse, type VerifyIdentityAddress, type VerifyIdentityOptions, type VerifyIdentityResult, type VerifyIdentityScores, type components, formatScopeForEnvironment, formatScopesForEnvironment, getAvailableEnvironments, getEnvironmentConfig, getLinkUrl, isApiError, isAuthenticationError, isConsentRequiredError, isEdgeError, isFeatureUnavailableError, isIdentityVerificationError, isNetworkError, isProductionEnvironment, isTransferWriteScope, isValidScope, type operations, parseScope, type paths };

package/dist/index.js

@@ -42,6 +42,7 @@ __export(index_exports, {
   EdgeTokenExchangeError: () => EdgeTokenExchangeError,
   EdgeValidationError: () => EdgeValidationError,
   OTP_METHODS: () => OTP_METHODS,
+  RESERVED_EDGE_SCOPES: () => RESERVED_EDGE_SCOPES,
   SCOPE_DESCRIPTIONS: () => SCOPE_DESCRIPTIONS,
   SCOPE_ICONS: () => SCOPE_ICONS,
   SDK_NAME: () => SDK_NAME,
@@ -105,47 +106,16 @@ var EDGE_ENVIRONMENTS = {
     displayName: "Production",
     isProduction: true
   },
-  staging: {
-    cognitoDomain: "https://edge-connect-staging.auth.us-east-1.amazoncognito.com",
-    // Staging partner API — mTLS-enforced. Requires a partner client
-    // certificate on every request. Routed through API Gateway → VPC Link →
-    // internal ALB → ECS. Direct routes to the backend (e.g.
-    // backend.connect-staging.edgeboost.io) no longer exist.
-    apiBaseUrl: "https://connect-staging.edgeboost.io/connect/v1",
-    // OAuth token exchange — partner-facing, also mTLS-enforced.
-    oauthBaseUrl: "https://connect-staging.edgeboost.io/connect/oauth",
-    // User-facing captive frame for the Link SDK enrollment and transfer
-    // verification flows. Served from the edge-connect-oauth Vite app
-    // deployed on Amplify. No mTLS — browser traffic.
-    userClientUrl: "https://oauth.staging-app.edgeboost.io",
-    displayName: "Staging",
-    isProduction: false
-  },
   sandbox: {
     cognitoDomain: "https://edge-connect-sandbox.auth.us-east-1.amazoncognito.com",
-    apiBaseUrl: "https://api-sandbox.staging.edgeboost.io/connect/v1",
-    oauthBaseUrl: "https://api-sandbox.staging.edgeboost.io/api/v3/oauth",
-    userClientUrl: "https://oauth.staging-app.edgeboost.io",
+    // Sandbox partner API — mTLS-enforced. Uses its own sandbox gateway and
+    // sandbox OAuth/JWKS issuer. The browser Link UI is served from a separate
+    // sandbox host.
+    apiBaseUrl: "https://sandbox.connect.staging.edgeboost.io/connect/v1",
+    oauthBaseUrl: "https://sandbox.connect.staging.edgeboost.io/connect/oauth",
+    userClientUrl: "https://sandbox-oauth.staging-app.edgeboost.io",
     displayName: "Sandbox",
     isProduction: false
-  },
-  /**
-   * Development environment for local testing with API Gateway.
-   *
-   * Architecture:
-   * - apiBaseUrl: Goes through API Gateway → ngrok → local backend (JWT validated by API Gateway)
-   * - oauthBaseUrl: Goes directly to ngrok → local backend (consent/token exchange)
-   * - userClientUrl: ngrok tunnel to local edgeboost-user-client (consent popup)
-   *
-   * The ngrok URL is configured in edgeboost-api/ngrok.yml with a static domain.
-   */
-  development: {
-    cognitoDomain: "https://edge-connect-staging.auth.us-east-1.amazoncognito.com",
-    apiBaseUrl: "https://connect-staging.edgeboost.io/connect/v1",
-    oauthBaseUrl: "https://revocable-overvaliantly-emmalyn.ngrok-free.app/oauth",
-    userClientUrl: "https://edgeboost-user-client.ngrok-free.app",
-    displayName: "Development",
-    isProduction: false
   }
 };
 function getEnvironmentConfig(environment) {
@@ -182,16 +152,18 @@ var EDGE_SCOPES = {
    */
   BALANCE_READ: "balance.read",
   /**
-   * Initiate fund transfers and create EDGE-hosted verification sessions.
-   * Not available yet. Requesting this scope from Link SDKs fails with
-   * EdgeFeatureUnavailableError until EDGE enables transfers for partners.
+   * Reserved for future fund transfers and EDGE-hosted verification sessions.
+   * Not available in sandbox or production. Requesting this scope from Link
+   * SDKs fails with EdgeFeatureUnavailableError until EDGE enables transfers
+   * for a partner.
    *
    * Required for: `POST /v1/transfer`, `POST /v1/transfer/:id/verification-session`, `GET /v1/transfers`
    */
   TRANSFER_WRITE: "transfer.write"
 };
-var ALL_EDGE_SCOPES = Object.values(EDGE_SCOPES);
 var ACTIVE_EDGE_SCOPES = [EDGE_SCOPES.USER_READ, EDGE_SCOPES.BALANCE_READ];
+var RESERVED_EDGE_SCOPES = [EDGE_SCOPES.TRANSFER_WRITE];
+var ALL_EDGE_SCOPES = ACTIVE_EDGE_SCOPES;
 var SCOPE_DESCRIPTIONS = {
   [EDGE_SCOPES.USER_READ]: "View your profile information (name and email)",
   [EDGE_SCOPES.BALANCE_READ]: "View your EdgeBoost account balance",
@@ -203,8 +175,7 @@ var SCOPE_ICONS = {
   [EDGE_SCOPES.TRANSFER_WRITE]: "arrow-left-right"
 };
 function formatScopeForEnvironment(scope, environment) {
-  const effectiveEnv = environment === "development" ? "staging" : environment;
-  const prefix = effectiveEnv === "production" ? "edge-connect" : `edge-connect-${effectiveEnv}`;
+  const prefix = environment === "production" ? "edge-connect" : `edge-connect-${environment}`;
   return `${prefix}/${scope}`;
 }
 function formatScopesForEnvironment(scopes, environment) {
@@ -399,6 +370,7 @@ var SDK_NAME = "@edge-markets/connect";
   EdgeTokenExchangeError,
   EdgeValidationError,
   OTP_METHODS,
+  RESERVED_EDGE_SCOPES,
   SCOPE_DESCRIPTIONS,
   SCOPE_ICONS,
   SDK_NAME,

package/dist/index.mjs

@@ -35,47 +35,16 @@ var EDGE_ENVIRONMENTS = {
     displayName: "Production",
     isProduction: true
   },
-  staging: {
-    cognitoDomain: "https://edge-connect-staging.auth.us-east-1.amazoncognito.com",
-    // Staging partner API — mTLS-enforced. Requires a partner client
-    // certificate on every request. Routed through API Gateway → VPC Link →
-    // internal ALB → ECS. Direct routes to the backend (e.g.
-    // backend.connect-staging.edgeboost.io) no longer exist.
-    apiBaseUrl: "https://connect-staging.edgeboost.io/connect/v1",
-    // OAuth token exchange — partner-facing, also mTLS-enforced.
-    oauthBaseUrl: "https://connect-staging.edgeboost.io/connect/oauth",
-    // User-facing captive frame for the Link SDK enrollment and transfer
-    // verification flows. Served from the edge-connect-oauth Vite app
-    // deployed on Amplify. No mTLS — browser traffic.
-    userClientUrl: "https://oauth.staging-app.edgeboost.io",
-    displayName: "Staging",
-    isProduction: false
-  },
   sandbox: {
     cognitoDomain: "https://edge-connect-sandbox.auth.us-east-1.amazoncognito.com",
-    apiBaseUrl: "https://api-sandbox.staging.edgeboost.io/connect/v1",
-    oauthBaseUrl: "https://api-sandbox.staging.edgeboost.io/api/v3/oauth",
-    userClientUrl: "https://oauth.staging-app.edgeboost.io",
+    // Sandbox partner API — mTLS-enforced. Uses its own sandbox gateway and
+    // sandbox OAuth/JWKS issuer. The browser Link UI is served from a separate
+    // sandbox host.
+    apiBaseUrl: "https://sandbox.connect.staging.edgeboost.io/connect/v1",
+    oauthBaseUrl: "https://sandbox.connect.staging.edgeboost.io/connect/oauth",
+    userClientUrl: "https://sandbox-oauth.staging-app.edgeboost.io",
     displayName: "Sandbox",
     isProduction: false
-  },
-  /**
-   * Development environment for local testing with API Gateway.
-   *
-   * Architecture:
-   * - apiBaseUrl: Goes through API Gateway → ngrok → local backend (JWT validated by API Gateway)
-   * - oauthBaseUrl: Goes directly to ngrok → local backend (consent/token exchange)
-   * - userClientUrl: ngrok tunnel to local edgeboost-user-client (consent popup)
-   *
-   * The ngrok URL is configured in edgeboost-api/ngrok.yml with a static domain.
-   */
-  development: {
-    cognitoDomain: "https://edge-connect-staging.auth.us-east-1.amazoncognito.com",
-    apiBaseUrl: "https://connect-staging.edgeboost.io/connect/v1",
-    oauthBaseUrl: "https://revocable-overvaliantly-emmalyn.ngrok-free.app/oauth",
-    userClientUrl: "https://edgeboost-user-client.ngrok-free.app",
-    displayName: "Development",
-    isProduction: false
   }
 };
 function getEnvironmentConfig(environment) {
@@ -112,16 +81,18 @@ var EDGE_SCOPES = {
    */
   BALANCE_READ: "balance.read",
   /**
-   * Initiate fund transfers and create EDGE-hosted verification sessions.
-   * Not available yet. Requesting this scope from Link SDKs fails with
-   * EdgeFeatureUnavailableError until EDGE enables transfers for partners.
+   * Reserved for future fund transfers and EDGE-hosted verification sessions.
+   * Not available in sandbox or production. Requesting this scope from Link
+   * SDKs fails with EdgeFeatureUnavailableError until EDGE enables transfers
+   * for a partner.
    *
    * Required for: `POST /v1/transfer`, `POST /v1/transfer/:id/verification-session`, `GET /v1/transfers`
    */
   TRANSFER_WRITE: "transfer.write"
 };
-var ALL_EDGE_SCOPES = Object.values(EDGE_SCOPES);
 var ACTIVE_EDGE_SCOPES = [EDGE_SCOPES.USER_READ, EDGE_SCOPES.BALANCE_READ];
+var RESERVED_EDGE_SCOPES = [EDGE_SCOPES.TRANSFER_WRITE];
+var ALL_EDGE_SCOPES = ACTIVE_EDGE_SCOPES;
 var SCOPE_DESCRIPTIONS = {
   [EDGE_SCOPES.USER_READ]: "View your profile information (name and email)",
   [EDGE_SCOPES.BALANCE_READ]: "View your EdgeBoost account balance",
@@ -133,8 +104,7 @@ var SCOPE_ICONS = {
   [EDGE_SCOPES.TRANSFER_WRITE]: "arrow-left-right"
 };
 function formatScopeForEnvironment(scope, environment) {
-  const effectiveEnv = environment === "development" ? "staging" : environment;
-  const prefix = effectiveEnv === "production" ? "edge-connect" : `edge-connect-${effectiveEnv}`;
+  const prefix = environment === "production" ? "edge-connect" : `edge-connect-${environment}`;
   return `${prefix}/${scope}`;
 }
 function formatScopesForEnvironment(scopes, environment) {
@@ -328,6 +298,7 @@ export {
   EdgeTokenExchangeError,
   EdgeValidationError,
   OTP_METHODS,
+  RESERVED_EDGE_SCOPES,
   SCOPE_DESCRIPTIONS,
   SCOPE_ICONS,
   SDK_NAME,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edge-markets/connect",
-  "version": "1.8.0",
+  "version": "1.9.1",
   "description": "Core types, configuration, and utilities for EDGE Connect SDK",
   "author": "EdgeBoost",
   "license": "MIT",