@edge-markets/connect 1.6.1 → 1.8.0

package/dist/index.d.mts

@@ -64,6 +64,9 @@ 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.
+     *
      * Required for: `POST /v1/transfer`, `POST /v1/transfer/:id/verification-session`, `GET /v1/transfers`
      */
     readonly TRANSFER_WRITE: "transfer.write";
@@ -87,6 +90,13 @@ type EdgeScope = (typeof EDGE_SCOPES)[keyof typeof EDGE_SCOPES];
  * ```
  */
 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.
@@ -142,6 +152,12 @@ declare function parseScope(fullScope: string): EdgeScope | null;
  * Checks if a scope string is valid.
  */
 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`).
+ */
+declare function isTransferWriteScope(scope: string): boolean;
 
 /**
  * This file was auto-generated by openapi-typescript.
@@ -695,17 +711,7 @@ interface paths {
         put?: never;
         /**
          * Initiate a transfer
-         * @description Initiates a fund transfer that requires OTP verification.
-         *
-         *     **Transfer Types:**
-         *     - `debit`: Pull funds FROM user's EdgeBoost TO partner (user deposits to partner platform)
-         *     - `credit`: Push funds FROM partner TO user's EdgeBoost (user withdraws from partner platform)
-         *
-         *     **Idempotency:**
-         *     Use the `idempotencyKey` to safely retry requests. If a transfer with the same key exists, its current status will be returned.
-         *
-         *     **OTP Verification:**
-         *     After initiating, the transfer will be in `pending_verification` status. Call `POST /transfer/{transferId}/verification-session` to create an EDGE-hosted verification session and embed the returned `verificationUrl` in your frontend.
+         * @description Reserved for a future transfer release. Currently returns feature_unavailable with message: Feature not available yet, please contact Edge product team for more details.
          */
         post: operations['initiateTransfer'];
         delete?: never;
@@ -723,7 +729,7 @@ interface paths {
         };
         /**
          * Get transfer status
-         * @description Returns the current status of a transfer. Use this for polling after initiating a transfer.
+         * @description Reserved for a future transfer release. Currently returns feature_unavailable with message: Feature not available yet, please contact Edge product team for more details.
          */
         get: operations['getTransferStatus'];
         put?: never;
@@ -743,7 +749,7 @@ interface paths {
         };
         /**
          * List transfers
-         * @description Returns a paginated list of transfers for the authenticated user. Useful for reconciliation.
+         * @description Reserved for a future transfer release. Currently returns feature_unavailable with message: Feature not available yet, please contact Edge product team for more details.
          */
         get: operations['listTransfers'];
         put?: never;
@@ -2336,7 +2342,16 @@ type InitiateTransferRequest = components['schemas']['InitiateTransferRequestDto
  * }
  * ```
  */
-type Transfer = components['schemas']['TransferResponseDto'];
+type Transfer = components['schemas']['TransferResponseDto'] & {
+    /** Transfer direction. Present on status/list responses and newer initiate responses. */
+    type?: TransferType;
+    /** Transfer amount. String responses preserve cents; older list endpoints may use number. */
+    amount?: string | number;
+    /** Settlement category when attributed by the partner or default policy. */
+    category?: TransferCategory;
+    createdAt?: string;
+    updatedAt?: string;
+};
 /**
  * Transfer item in a list (includes additional fields like amount and timestamps).
  */
@@ -3002,6 +3017,14 @@ declare class EdgeInsufficientScopeError extends EdgeError {
     readonly missingScopes: string[];
     constructor(missingScopes: string[], message?: string);
 }
+declare const EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE = "Feature not available yet, please contact Edge product team for more details";
+/**
+ * Thrown when an SDK surface exists for a future EDGE Connect feature that is
+ * not active for partners yet.
+ */
+declare class EdgeFeatureUnavailableError extends EdgeError {
+    constructor(message?: string);
+}
 /**
  * Thrown when an API request fails with a known error.
  *
@@ -3173,6 +3196,7 @@ declare function isIdentityVerificationError(error: unknown): error is EdgeIdent
  * Type guard for network errors.
  */
 declare function isNetworkError(error: unknown): error is EdgeNetworkError;
+declare function isFeatureUnavailableError(error: unknown): error is EdgeFeatureUnavailableError;
 
 /**
  * @edge-markets/connect
@@ -3221,4 +3245,4 @@ declare const SDK_VERSION = "1.0.0";
  */
 declare const SDK_NAME = "@edge-markets/connect";
 
-export { ALL_EDGE_SCOPES, type ApiError, type Balance, type BaseWebhookEvent, type ConsentRequiredError, type ConsentRevokedEventData, type CreateVerificationSessionRequest, EDGE_ENVIRONMENTS, EDGE_LINK_PATH, EDGE_SCOPES, EDGE_WEBHOOK_EVENT_TYPES, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, type EdgeEnvironment, type EdgeEnvironmentConfig, EdgeError, 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, isIdentityVerificationError, isNetworkError, isProductionEnvironment, 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, 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

@@ -64,6 +64,9 @@ 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.
+     *
      * Required for: `POST /v1/transfer`, `POST /v1/transfer/:id/verification-session`, `GET /v1/transfers`
      */
     readonly TRANSFER_WRITE: "transfer.write";
@@ -87,6 +90,13 @@ type EdgeScope = (typeof EDGE_SCOPES)[keyof typeof EDGE_SCOPES];
  * ```
  */
 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.
@@ -142,6 +152,12 @@ declare function parseScope(fullScope: string): EdgeScope | null;
  * Checks if a scope string is valid.
  */
 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`).
+ */
+declare function isTransferWriteScope(scope: string): boolean;
 
 /**
  * This file was auto-generated by openapi-typescript.
@@ -695,17 +711,7 @@ interface paths {
         put?: never;
         /**
          * Initiate a transfer
-         * @description Initiates a fund transfer that requires OTP verification.
-         *
-         *     **Transfer Types:**
-         *     - `debit`: Pull funds FROM user's EdgeBoost TO partner (user deposits to partner platform)
-         *     - `credit`: Push funds FROM partner TO user's EdgeBoost (user withdraws from partner platform)
-         *
-         *     **Idempotency:**
-         *     Use the `idempotencyKey` to safely retry requests. If a transfer with the same key exists, its current status will be returned.
-         *
-         *     **OTP Verification:**
-         *     After initiating, the transfer will be in `pending_verification` status. Call `POST /transfer/{transferId}/verification-session` to create an EDGE-hosted verification session and embed the returned `verificationUrl` in your frontend.
+         * @description Reserved for a future transfer release. Currently returns feature_unavailable with message: Feature not available yet, please contact Edge product team for more details.
          */
         post: operations['initiateTransfer'];
         delete?: never;
@@ -723,7 +729,7 @@ interface paths {
         };
         /**
          * Get transfer status
-         * @description Returns the current status of a transfer. Use this for polling after initiating a transfer.
+         * @description Reserved for a future transfer release. Currently returns feature_unavailable with message: Feature not available yet, please contact Edge product team for more details.
          */
         get: operations['getTransferStatus'];
         put?: never;
@@ -743,7 +749,7 @@ interface paths {
         };
         /**
          * List transfers
-         * @description Returns a paginated list of transfers for the authenticated user. Useful for reconciliation.
+         * @description Reserved for a future transfer release. Currently returns feature_unavailable with message: Feature not available yet, please contact Edge product team for more details.
          */
         get: operations['listTransfers'];
         put?: never;
@@ -2336,7 +2342,16 @@ type InitiateTransferRequest = components['schemas']['InitiateTransferRequestDto
  * }
  * ```
  */
-type Transfer = components['schemas']['TransferResponseDto'];
+type Transfer = components['schemas']['TransferResponseDto'] & {
+    /** Transfer direction. Present on status/list responses and newer initiate responses. */
+    type?: TransferType;
+    /** Transfer amount. String responses preserve cents; older list endpoints may use number. */
+    amount?: string | number;
+    /** Settlement category when attributed by the partner or default policy. */
+    category?: TransferCategory;
+    createdAt?: string;
+    updatedAt?: string;
+};
 /**
  * Transfer item in a list (includes additional fields like amount and timestamps).
  */
@@ -3002,6 +3017,14 @@ declare class EdgeInsufficientScopeError extends EdgeError {
     readonly missingScopes: string[];
     constructor(missingScopes: string[], message?: string);
 }
+declare const EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE = "Feature not available yet, please contact Edge product team for more details";
+/**
+ * Thrown when an SDK surface exists for a future EDGE Connect feature that is
+ * not active for partners yet.
+ */
+declare class EdgeFeatureUnavailableError extends EdgeError {
+    constructor(message?: string);
+}
 /**
  * Thrown when an API request fails with a known error.
  *
@@ -3173,6 +3196,7 @@ declare function isIdentityVerificationError(error: unknown): error is EdgeIdent
  * Type guard for network errors.
  */
 declare function isNetworkError(error: unknown): error is EdgeNetworkError;
+declare function isFeatureUnavailableError(error: unknown): error is EdgeFeatureUnavailableError;
 
 /**
  * @edge-markets/connect
@@ -3221,4 +3245,4 @@ declare const SDK_VERSION = "1.0.0";
  */
 declare const SDK_NAME = "@edge-markets/connect";
 
-export { ALL_EDGE_SCOPES, type ApiError, type Balance, type BaseWebhookEvent, type ConsentRequiredError, type ConsentRevokedEventData, type CreateVerificationSessionRequest, EDGE_ENVIRONMENTS, EDGE_LINK_PATH, EDGE_SCOPES, EDGE_WEBHOOK_EVENT_TYPES, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, type EdgeEnvironment, type EdgeEnvironmentConfig, EdgeError, 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, isIdentityVerificationError, isNetworkError, isProductionEnvironment, 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, 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

@@ -20,7 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ACTIVE_EDGE_SCOPES: () => ACTIVE_EDGE_SCOPES,
   ALL_EDGE_SCOPES: () => ALL_EDGE_SCOPES,
+  EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE: () => EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE,
   EDGE_ENVIRONMENTS: () => EDGE_ENVIRONMENTS,
   EDGE_LINK_PATH: () => EDGE_LINK_PATH,
   EDGE_SCOPES: () => EDGE_SCOPES,
@@ -29,6 +31,7 @@ __export(index_exports, {
   EdgeAuthenticationError: () => EdgeAuthenticationError,
   EdgeConsentRequiredError: () => EdgeConsentRequiredError,
   EdgeError: () => EdgeError,
+  EdgeFeatureUnavailableError: () => EdgeFeatureUnavailableError,
   EdgeIdentityVerificationError: () => EdgeIdentityVerificationError,
   EdgeInsufficientScopeError: () => EdgeInsufficientScopeError,
   EdgeNetworkError: () => EdgeNetworkError,
@@ -55,9 +58,11 @@ __export(index_exports, {
   isAuthenticationError: () => isAuthenticationError,
   isConsentRequiredError: () => isConsentRequiredError,
   isEdgeError: () => isEdgeError,
+  isFeatureUnavailableError: () => isFeatureUnavailableError,
   isIdentityVerificationError: () => isIdentityVerificationError,
   isNetworkError: () => isNetworkError,
   isProductionEnvironment: () => isProductionEnvironment,
+  isTransferWriteScope: () => isTransferWriteScope,
   isValidScope: () => isValidScope,
   parseScope: () => parseScope
 });
@@ -178,15 +183,19 @@ 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.
+   *
    * 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 SCOPE_DESCRIPTIONS = {
   [EDGE_SCOPES.USER_READ]: "View your profile information (name and email)",
   [EDGE_SCOPES.BALANCE_READ]: "View your EdgeBoost account balance",
-  [EDGE_SCOPES.TRANSFER_WRITE]: "Transfer funds to and from your EdgeBoost account"
+  [EDGE_SCOPES.TRANSFER_WRITE]: "Transfers are not available yet"
 };
 var SCOPE_ICONS = {
   [EDGE_SCOPES.USER_READ]: "user",
@@ -210,6 +219,10 @@ function parseScope(fullScope) {
 function isValidScope(scope) {
   return Object.values(EDGE_SCOPES).includes(scope);
 }
+function isTransferWriteScope(scope) {
+  const normalized = typeof scope === "string" ? scope.trim() : "";
+  return normalized === EDGE_SCOPES.TRANSFER_WRITE || normalized.endsWith(`/${EDGE_SCOPES.TRANSFER_WRITE}`);
+}
 
 // src/errors/edge.error.ts
 var EdgeError = class _EdgeError extends Error {
@@ -270,6 +283,13 @@ var EdgeInsufficientScopeError = class extends EdgeError {
     this.missingScopes = missingScopes;
   }
 };
+var EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE = "Feature not available yet, please contact Edge product team for more details";
+var EdgeFeatureUnavailableError = class extends EdgeError {
+  constructor(message = EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE) {
+    super("feature_unavailable", message, 501);
+    this.name = "EdgeFeatureUnavailableError";
+  }
+};
 var EdgeApiError = class extends EdgeError {
   constructor(code, message, statusCode, details) {
     super(code, message, statusCode, details);
@@ -348,13 +368,18 @@ function isIdentityVerificationError(error) {
 function isNetworkError(error) {
   return error instanceof EdgeNetworkError;
 }
+function isFeatureUnavailableError(error) {
+  return error instanceof EdgeFeatureUnavailableError;
+}
 
 // src/index.ts
 var SDK_VERSION = "1.0.0";
 var SDK_NAME = "@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_ENVIRONMENTS,
   EDGE_LINK_PATH,
   EDGE_SCOPES,
@@ -363,6 +388,7 @@ var SDK_NAME = "@edge-markets/connect";
   EdgeAuthenticationError,
   EdgeConsentRequiredError,
   EdgeError,
+  EdgeFeatureUnavailableError,
   EdgeIdentityVerificationError,
   EdgeInsufficientScopeError,
   EdgeNetworkError,
@@ -389,9 +415,11 @@ var SDK_NAME = "@edge-markets/connect";
   isAuthenticationError,
   isConsentRequiredError,
   isEdgeError,
+  isFeatureUnavailableError,
   isIdentityVerificationError,
   isNetworkError,
   isProductionEnvironment,
+  isTransferWriteScope,
   isValidScope,
   parseScope
 });

package/dist/index.mjs

@@ -113,15 +113,19 @@ 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.
+   *
    * 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 SCOPE_DESCRIPTIONS = {
   [EDGE_SCOPES.USER_READ]: "View your profile information (name and email)",
   [EDGE_SCOPES.BALANCE_READ]: "View your EdgeBoost account balance",
-  [EDGE_SCOPES.TRANSFER_WRITE]: "Transfer funds to and from your EdgeBoost account"
+  [EDGE_SCOPES.TRANSFER_WRITE]: "Transfers are not available yet"
 };
 var SCOPE_ICONS = {
   [EDGE_SCOPES.USER_READ]: "user",
@@ -145,6 +149,10 @@ function parseScope(fullScope) {
 function isValidScope(scope) {
   return Object.values(EDGE_SCOPES).includes(scope);
 }
+function isTransferWriteScope(scope) {
+  const normalized = typeof scope === "string" ? scope.trim() : "";
+  return normalized === EDGE_SCOPES.TRANSFER_WRITE || normalized.endsWith(`/${EDGE_SCOPES.TRANSFER_WRITE}`);
+}
 
 // src/errors/edge.error.ts
 var EdgeError = class _EdgeError extends Error {
@@ -205,6 +213,13 @@ var EdgeInsufficientScopeError = class extends EdgeError {
     this.missingScopes = missingScopes;
   }
 };
+var EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE = "Feature not available yet, please contact Edge product team for more details";
+var EdgeFeatureUnavailableError = class extends EdgeError {
+  constructor(message = EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE) {
+    super("feature_unavailable", message, 501);
+    this.name = "EdgeFeatureUnavailableError";
+  }
+};
 var EdgeApiError = class extends EdgeError {
   constructor(code, message, statusCode, details) {
     super(code, message, statusCode, details);
@@ -283,12 +298,17 @@ function isIdentityVerificationError(error) {
 function isNetworkError(error) {
   return error instanceof EdgeNetworkError;
 }
+function isFeatureUnavailableError(error) {
+  return error instanceof EdgeFeatureUnavailableError;
+}
 
 // src/index.ts
 var SDK_VERSION = "1.0.0";
 var SDK_NAME = "@edge-markets/connect";
 export {
+  ACTIVE_EDGE_SCOPES,
   ALL_EDGE_SCOPES,
+  EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE,
   EDGE_ENVIRONMENTS,
   EDGE_LINK_PATH,
   EDGE_SCOPES,
@@ -297,6 +317,7 @@ export {
   EdgeAuthenticationError,
   EdgeConsentRequiredError,
   EdgeError,
+  EdgeFeatureUnavailableError,
   EdgeIdentityVerificationError,
   EdgeInsufficientScopeError,
   EdgeNetworkError,
@@ -323,9 +344,11 @@ export {
   isAuthenticationError,
   isConsentRequiredError,
   isEdgeError,
+  isFeatureUnavailableError,
   isIdentityVerificationError,
   isNetworkError,
   isProductionEnvironment,
+  isTransferWriteScope,
   isValidScope,
   parseScope
 };

package/package.json

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