@edge-markets/connect 1.9.2 → 1.10.0

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 type EdgeEnvironment = 'production' | 'sandbox';
+type EdgeDeploymentCell = 'staging' | 'sandbox-staging' | 'sandbox-production' | 'production';
 declare const EDGE_LINK_PATH = "/oauth/link";
 interface EdgeEnvironmentConfig {
     apiBaseUrl: string;
@@ -7,8 +8,18 @@ interface EdgeEnvironmentConfig {
     displayName: string;
     isProduction: boolean;
 }
+interface EdgeDeploymentCellConfig extends EdgeEnvironmentConfig {
+    environment: EdgeEnvironment;
+    awsAccountId: '124355668944' | '471257598653';
+    issuer: string;
+    scopePrefix: 'edge-connect-staging/' | 'edge-connect-sandbox/' | 'edge-connect/';
+    partnerFacing: boolean;
+}
+declare const EDGE_DEPLOYMENT_CELLS: Readonly<Record<EdgeDeploymentCell, EdgeDeploymentCellConfig>>;
 declare const EDGE_ENVIRONMENTS: Readonly<Record<EdgeEnvironment, EdgeEnvironmentConfig>>;
 declare function getEnvironmentConfig(environment: EdgeEnvironment): EdgeEnvironmentConfig;
+declare function getDeploymentCellConfig(cell: EdgeDeploymentCell): EdgeDeploymentCellConfig;
+declare function getAvailableDeploymentCells(): readonly EdgeDeploymentCell[];
 /**
  * Resolves the hosted Link UI URL for an environment.
  *
@@ -59,6 +70,12 @@ declare const EDGE_SCOPES: {
      * Required for: `GET /v1/balance`
      */
     readonly BALANCE_READ: "balance.read";
+    /**
+     * Compare partner-held identity data with the authenticated EDGE profile.
+     * This is separately allowlisted and returns only a coarse advisory result.
+     * Required for: `POST /connect/v2/identity/match`
+     */
+    readonly IDENTITY_MATCH: "identity.match";
     /**
      * Reserved for future fund transfers and EDGE-hosted verification sessions.
      * Not available in sandbox or production. Requesting this scope from Link
@@ -2469,6 +2486,32 @@ interface VerifyIdentityResult {
     verified: true;
     scores: VerifyIdentityScores;
 }
+interface IdentityMatchLegalName {
+    givenName: string;
+    familyName: string;
+}
+interface IdentityMatchAddress {
+    line1: string;
+    line2?: string;
+    locality: string;
+    region: string;
+    postalCode: string;
+    country: 'US';
+}
+/** Partner-held data only. Never populate this from `getUser()`. */
+interface IdentityMatchOptions {
+    /** Opaque 16-255 character key. Reuse it only when retrying the exact same request. */
+    idempotencyKey: string;
+    legalName: IdentityMatchLegalName;
+    address?: IdentityMatchAddress;
+}
+type IdentityMatchResultValue = 'match' | 'no_match' | 'insufficient_data';
+interface IdentityMatchResult {
+    decisionId: string;
+    result: IdentityMatchResultValue;
+    matcherVersion: string;
+    evaluatedAt: string;
+}
 /**
  * Geolocation data collected by the SDK from the browser or device.
  *
@@ -3109,6 +3152,17 @@ declare class EdgeIdentityVerificationError extends EdgeError {
     readonly fieldErrors: Record<string, string>;
     constructor(fieldErrors: Record<string, string>, message?: string);
 }
+/** Stable identity-match precondition/idempotency failure. Submitted identity data is never attached. */
+declare class EdgeIdentityMatchConflictError extends EdgeError {
+    constructor(code: 'idempotency_conflict' | 'idempotency_in_progress' | 'match_not_eligible', message?: string);
+}
+declare class EdgeIdentityMatchAttemptLimitError extends EdgeError {
+    readonly retryAfterSeconds?: number;
+    constructor(retryAfterSeconds?: number, message?: string);
+}
+declare class EdgeIdentityMatchUnavailableError extends EdgeError {
+    constructor(message?: string);
+}
 /**
  * Thrown when a popup is blocked by the browser.
  *
@@ -3191,6 +3245,7 @@ declare function isApiError(error: unknown): error is EdgeApiError;
  * Type guard for identity verification errors.
  */
 declare function isIdentityVerificationError(error: unknown): error is EdgeIdentityVerificationError;
+declare function isIdentityMatchError(error: unknown): error is EdgeIdentityMatchConflictError | EdgeIdentityMatchAttemptLimitError | EdgeIdentityMatchUnavailableError;
 /**
  * Type guard for network errors.
  */
@@ -3244,4 +3299,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, 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 };
+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_DEPLOYMENT_CELLS, EDGE_ENVIRONMENTS, EDGE_LINK_PATH, EDGE_SCOPES, EDGE_WEBHOOK_EVENT_TYPES, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, type EdgeDeploymentCell, type EdgeDeploymentCellConfig, type EdgeEnvironment, type EdgeEnvironmentConfig, EdgeError, EdgeFeatureUnavailableError, EdgeIdentityMatchAttemptLimitError, EdgeIdentityMatchConflictError, EdgeIdentityMatchUnavailableError, 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 IdentityMatchAddress, type IdentityMatchLegalName, type IdentityMatchOptions, type IdentityMatchResult, type IdentityMatchResultValue, 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, getAvailableDeploymentCells, getAvailableEnvironments, getDeploymentCellConfig, getEnvironmentConfig, getLinkUrl, isApiError, isAuthenticationError, isConsentRequiredError, isEdgeError, isFeatureUnavailableError, isIdentityMatchError, isIdentityVerificationError, isNetworkError, isProductionEnvironment, isTransferWriteScope, isValidScope, type operations, parseScope, type paths };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 type EdgeEnvironment = 'production' | 'sandbox';
+type EdgeDeploymentCell = 'staging' | 'sandbox-staging' | 'sandbox-production' | 'production';
 declare const EDGE_LINK_PATH = "/oauth/link";
 interface EdgeEnvironmentConfig {
     apiBaseUrl: string;
@@ -7,8 +8,18 @@ interface EdgeEnvironmentConfig {
     displayName: string;
     isProduction: boolean;
 }
+interface EdgeDeploymentCellConfig extends EdgeEnvironmentConfig {
+    environment: EdgeEnvironment;
+    awsAccountId: '124355668944' | '471257598653';
+    issuer: string;
+    scopePrefix: 'edge-connect-staging/' | 'edge-connect-sandbox/' | 'edge-connect/';
+    partnerFacing: boolean;
+}
+declare const EDGE_DEPLOYMENT_CELLS: Readonly<Record<EdgeDeploymentCell, EdgeDeploymentCellConfig>>;
 declare const EDGE_ENVIRONMENTS: Readonly<Record<EdgeEnvironment, EdgeEnvironmentConfig>>;
 declare function getEnvironmentConfig(environment: EdgeEnvironment): EdgeEnvironmentConfig;
+declare function getDeploymentCellConfig(cell: EdgeDeploymentCell): EdgeDeploymentCellConfig;
+declare function getAvailableDeploymentCells(): readonly EdgeDeploymentCell[];
 /**
  * Resolves the hosted Link UI URL for an environment.
  *
@@ -59,6 +70,12 @@ declare const EDGE_SCOPES: {
      * Required for: `GET /v1/balance`
      */
     readonly BALANCE_READ: "balance.read";
+    /**
+     * Compare partner-held identity data with the authenticated EDGE profile.
+     * This is separately allowlisted and returns only a coarse advisory result.
+     * Required for: `POST /connect/v2/identity/match`
+     */
+    readonly IDENTITY_MATCH: "identity.match";
     /**
      * Reserved for future fund transfers and EDGE-hosted verification sessions.
      * Not available in sandbox or production. Requesting this scope from Link
@@ -2469,6 +2486,32 @@ interface VerifyIdentityResult {
     verified: true;
     scores: VerifyIdentityScores;
 }
+interface IdentityMatchLegalName {
+    givenName: string;
+    familyName: string;
+}
+interface IdentityMatchAddress {
+    line1: string;
+    line2?: string;
+    locality: string;
+    region: string;
+    postalCode: string;
+    country: 'US';
+}
+/** Partner-held data only. Never populate this from `getUser()`. */
+interface IdentityMatchOptions {
+    /** Opaque 16-255 character key. Reuse it only when retrying the exact same request. */
+    idempotencyKey: string;
+    legalName: IdentityMatchLegalName;
+    address?: IdentityMatchAddress;
+}
+type IdentityMatchResultValue = 'match' | 'no_match' | 'insufficient_data';
+interface IdentityMatchResult {
+    decisionId: string;
+    result: IdentityMatchResultValue;
+    matcherVersion: string;
+    evaluatedAt: string;
+}
 /**
  * Geolocation data collected by the SDK from the browser or device.
  *
@@ -3109,6 +3152,17 @@ declare class EdgeIdentityVerificationError extends EdgeError {
     readonly fieldErrors: Record<string, string>;
     constructor(fieldErrors: Record<string, string>, message?: string);
 }
+/** Stable identity-match precondition/idempotency failure. Submitted identity data is never attached. */
+declare class EdgeIdentityMatchConflictError extends EdgeError {
+    constructor(code: 'idempotency_conflict' | 'idempotency_in_progress' | 'match_not_eligible', message?: string);
+}
+declare class EdgeIdentityMatchAttemptLimitError extends EdgeError {
+    readonly retryAfterSeconds?: number;
+    constructor(retryAfterSeconds?: number, message?: string);
+}
+declare class EdgeIdentityMatchUnavailableError extends EdgeError {
+    constructor(message?: string);
+}
 /**
  * Thrown when a popup is blocked by the browser.
  *
@@ -3191,6 +3245,7 @@ declare function isApiError(error: unknown): error is EdgeApiError;
  * Type guard for identity verification errors.
  */
 declare function isIdentityVerificationError(error: unknown): error is EdgeIdentityVerificationError;
+declare function isIdentityMatchError(error: unknown): error is EdgeIdentityMatchConflictError | EdgeIdentityMatchAttemptLimitError | EdgeIdentityMatchUnavailableError;
 /**
  * Type guard for network errors.
  */
@@ -3244,4 +3299,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, 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 };
+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_DEPLOYMENT_CELLS, EDGE_ENVIRONMENTS, EDGE_LINK_PATH, EDGE_SCOPES, EDGE_WEBHOOK_EVENT_TYPES, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, type EdgeDeploymentCell, type EdgeDeploymentCellConfig, type EdgeEnvironment, type EdgeEnvironmentConfig, EdgeError, EdgeFeatureUnavailableError, EdgeIdentityMatchAttemptLimitError, EdgeIdentityMatchConflictError, EdgeIdentityMatchUnavailableError, 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 IdentityMatchAddress, type IdentityMatchLegalName, type IdentityMatchOptions, type IdentityMatchResult, type IdentityMatchResultValue, 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, getAvailableDeploymentCells, getAvailableEnvironments, getDeploymentCellConfig, getEnvironmentConfig, getLinkUrl, isApiError, isAuthenticationError, isConsentRequiredError, isEdgeError, isFeatureUnavailableError, isIdentityMatchError, isIdentityVerificationError, isNetworkError, isProductionEnvironment, isTransferWriteScope, isValidScope, type operations, parseScope, type paths };

package/dist/index.js

@@ -23,6 +23,7 @@ __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_DEPLOYMENT_CELLS: () => EDGE_DEPLOYMENT_CELLS,
   EDGE_ENVIRONMENTS: () => EDGE_ENVIRONMENTS,
   EDGE_LINK_PATH: () => EDGE_LINK_PATH,
   EDGE_SCOPES: () => EDGE_SCOPES,
@@ -32,6 +33,9 @@ __export(index_exports, {
   EdgeConsentRequiredError: () => EdgeConsentRequiredError,
   EdgeError: () => EdgeError,
   EdgeFeatureUnavailableError: () => EdgeFeatureUnavailableError,
+  EdgeIdentityMatchAttemptLimitError: () => EdgeIdentityMatchAttemptLimitError,
+  EdgeIdentityMatchConflictError: () => EdgeIdentityMatchConflictError,
+  EdgeIdentityMatchUnavailableError: () => EdgeIdentityMatchUnavailableError,
   EdgeIdentityVerificationError: () => EdgeIdentityVerificationError,
   EdgeInsufficientScopeError: () => EdgeInsufficientScopeError,
   EdgeNetworkError: () => EdgeNetworkError,
@@ -52,7 +56,9 @@ __export(index_exports, {
   TRANSFER_TYPES: () => TRANSFER_TYPES,
   formatScopeForEnvironment: () => formatScopeForEnvironment,
   formatScopesForEnvironment: () => formatScopesForEnvironment,
+  getAvailableDeploymentCells: () => getAvailableDeploymentCells,
   getAvailableEnvironments: () => getAvailableEnvironments,
+  getDeploymentCellConfig: () => getDeploymentCellConfig,
   getEnvironmentConfig: () => getEnvironmentConfig,
   getLinkUrl: () => getLinkUrl,
   isApiError: () => isApiError,
@@ -60,6 +66,7 @@ __export(index_exports, {
   isConsentRequiredError: () => isConsentRequiredError,
   isEdgeError: () => isEdgeError,
   isFeatureUnavailableError: () => isFeatureUnavailableError,
+  isIdentityMatchError: () => isIdentityMatchError,
   isIdentityVerificationError: () => isIdentityVerificationError,
   isNetworkError: () => isNetworkError,
   isProductionEnvironment: () => isProductionEnvironment,
@@ -97,28 +104,72 @@ var EDGE_WEBHOOK_EVENT_TYPES = [
 
 // src/config/environments.ts
 var EDGE_LINK_PATH = "/oauth/link";
-var EDGE_ENVIRONMENTS = {
+var EDGE_DEPLOYMENT_CELLS = {
+  staging: {
+    environment: "sandbox",
+    apiBaseUrl: "https://connect-staging.edgeboost.io/connect/v1",
+    oauthBaseUrl: "https://connect-staging.edgeboost.io/connect/oauth",
+    userClientUrl: "https://oauth.staging-app.edgeboost.io",
+    issuer: "https://jwks.connect-staging.edgeboost.io",
+    scopePrefix: "edge-connect-staging/",
+    awsAccountId: "124355668944",
+    displayName: "Staging",
+    isProduction: false,
+    partnerFacing: false
+  },
+  "sandbox-staging": {
+    environment: "sandbox",
+    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",
+    issuer: "https://jwks.sandbox.connect.staging.edgeboost.io",
+    scopePrefix: "edge-connect-sandbox/",
+    awsAccountId: "124355668944",
+    displayName: "Sandbox staging",
+    isProduction: false,
+    partnerFacing: false
+  },
+  "sandbox-production": {
+    environment: "sandbox",
+    apiBaseUrl: "https://sandbox.connect.edgeboost.io/connect/v1",
+    oauthBaseUrl: "https://sandbox.connect.edgeboost.io/connect/oauth",
+    userClientUrl: "https://sandbox-oauth.edgeboost.io",
+    issuer: "https://jwks.sandbox.connect.edgeboost.io",
+    scopePrefix: "edge-connect-sandbox/",
+    awsAccountId: "471257598653",
+    displayName: "Sandbox production",
+    isProduction: false,
+    partnerFacing: true
+  },
   production: {
+    environment: "production",
     apiBaseUrl: "https://connect.edgeboost.io/connect/v1",
     oauthBaseUrl: "https://connect.edgeboost.io/connect/oauth",
     userClientUrl: "https://oauth.edgeboost.io",
+    issuer: "https://jwks.connect.edgeboost.io",
+    scopePrefix: "edge-connect/",
+    awsAccountId: "471257598653",
     displayName: "Production",
-    isProduction: true
-  },
-  sandbox: {
-    // 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
+    isProduction: true,
+    partnerFacing: true
   }
 };
+var EDGE_ENVIRONMENTS = {
+  production: EDGE_DEPLOYMENT_CELLS.production,
+  // The public SDK has two choices. "sandbox" is the canonical partner
+  // sandbox in the production account; internal staging cells use explicit
+  // deployment-cell configuration instead of another public environment enum.
+  sandbox: EDGE_DEPLOYMENT_CELLS["sandbox-production"]
+};
 function getEnvironmentConfig(environment) {
   return EDGE_ENVIRONMENTS[environment];
 }
+function getDeploymentCellConfig(cell) {
+  return EDGE_DEPLOYMENT_CELLS[cell];
+}
+function getAvailableDeploymentCells() {
+  return Object.keys(EDGE_DEPLOYMENT_CELLS);
+}
 function getLinkUrl(environment, linkUrl) {
   const configuredUrl = linkUrl?.trim();
   const url = new URL(configuredUrl || `${EDGE_ENVIRONMENTS[environment].userClientUrl}${EDGE_LINK_PATH}`);
@@ -149,6 +200,12 @@ var EDGE_SCOPES = {
    * Required for: `GET /v1/balance`
    */
   BALANCE_READ: "balance.read",
+  /**
+   * Compare partner-held identity data with the authenticated EDGE profile.
+   * This is separately allowlisted and returns only a coarse advisory result.
+   * Required for: `POST /connect/v2/identity/match`
+   */
+  IDENTITY_MATCH: "identity.match",
   /**
    * Reserved for future fund transfers and EDGE-hosted verification sessions.
    * Not available in sandbox or production. Requesting this scope from Link
@@ -160,16 +217,18 @@ var EDGE_SCOPES = {
   TRANSFER_WRITE: "transfer.write"
 };
 var ACTIVE_EDGE_SCOPES = [EDGE_SCOPES.USER_READ, EDGE_SCOPES.BALANCE_READ];
-var RESERVED_EDGE_SCOPES = [EDGE_SCOPES.TRANSFER_WRITE];
+var RESERVED_EDGE_SCOPES = [EDGE_SCOPES.IDENTITY_MATCH, 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",
+  [EDGE_SCOPES.IDENTITY_MATCH]: "Compare partner-held identity details and return a coarse advisory result",
   [EDGE_SCOPES.TRANSFER_WRITE]: "Transfers are not available yet"
 };
 var SCOPE_ICONS = {
   [EDGE_SCOPES.USER_READ]: "user",
   [EDGE_SCOPES.BALANCE_READ]: "wallet",
+  [EDGE_SCOPES.IDENTITY_MATCH]: "shield-check",
   [EDGE_SCOPES.TRANSFER_WRITE]: "arrow-left-right"
 };
 function formatScopeForEnvironment(scope, environment) {
@@ -289,6 +348,31 @@ var EdgeIdentityVerificationError = class extends EdgeError {
     this.fieldErrors = fieldErrors;
   }
 };
+var EdgeIdentityMatchConflictError = class extends EdgeError {
+  constructor(code, message) {
+    super(code, message || "Identity match could not be completed because a request precondition failed.", 409);
+    this.name = "EdgeIdentityMatchConflictError";
+  }
+};
+var EdgeIdentityMatchAttemptLimitError = class extends EdgeError {
+  constructor(retryAfterSeconds, message) {
+    super("identity_match_attempt_limit", message || "Identity match attempt limit reached. Retry later.", 429, {
+      retryAfterSeconds
+    });
+    this.name = "EdgeIdentityMatchAttemptLimitError";
+    this.retryAfterSeconds = retryAfterSeconds;
+  }
+};
+var EdgeIdentityMatchUnavailableError = class extends EdgeError {
+  constructor(message) {
+    super(
+      "identity_match_unavailable",
+      message || "Identity match is temporarily unavailable. Retry with the same idempotency key.",
+      503
+    );
+    this.name = "EdgeIdentityMatchUnavailableError";
+  }
+};
 var EdgePopupBlockedError = class extends EdgeError {
   constructor() {
     super("popup_blocked", "Popup was blocked by the browser. Please allow popups for this site and try again.");
@@ -334,6 +418,9 @@ function isApiError(error) {
 function isIdentityVerificationError(error) {
   return error instanceof EdgeIdentityVerificationError;
 }
+function isIdentityMatchError(error) {
+  return error instanceof EdgeIdentityMatchConflictError || error instanceof EdgeIdentityMatchAttemptLimitError || error instanceof EdgeIdentityMatchUnavailableError;
+}
 function isNetworkError(error) {
   return error instanceof EdgeNetworkError;
 }
@@ -349,6 +436,7 @@ var SDK_NAME = "@edge-markets/connect";
   ACTIVE_EDGE_SCOPES,
   ALL_EDGE_SCOPES,
   EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE,
+  EDGE_DEPLOYMENT_CELLS,
   EDGE_ENVIRONMENTS,
   EDGE_LINK_PATH,
   EDGE_SCOPES,
@@ -358,6 +446,9 @@ var SDK_NAME = "@edge-markets/connect";
   EdgeConsentRequiredError,
   EdgeError,
   EdgeFeatureUnavailableError,
+  EdgeIdentityMatchAttemptLimitError,
+  EdgeIdentityMatchConflictError,
+  EdgeIdentityMatchUnavailableError,
   EdgeIdentityVerificationError,
   EdgeInsufficientScopeError,
   EdgeNetworkError,
@@ -378,7 +469,9 @@ var SDK_NAME = "@edge-markets/connect";
   TRANSFER_TYPES,
   formatScopeForEnvironment,
   formatScopesForEnvironment,
+  getAvailableDeploymentCells,
   getAvailableEnvironments,
+  getDeploymentCellConfig,
   getEnvironmentConfig,
   getLinkUrl,
   isApiError,
@@ -386,6 +479,7 @@ var SDK_NAME = "@edge-markets/connect";
   isConsentRequiredError,
   isEdgeError,
   isFeatureUnavailableError,
+  isIdentityMatchError,
   isIdentityVerificationError,
   isNetworkError,
   isProductionEnvironment,

package/dist/index.mjs

@@ -26,28 +26,72 @@ var EDGE_WEBHOOK_EVENT_TYPES = [
 
 // src/config/environments.ts
 var EDGE_LINK_PATH = "/oauth/link";
-var EDGE_ENVIRONMENTS = {
+var EDGE_DEPLOYMENT_CELLS = {
+  staging: {
+    environment: "sandbox",
+    apiBaseUrl: "https://connect-staging.edgeboost.io/connect/v1",
+    oauthBaseUrl: "https://connect-staging.edgeboost.io/connect/oauth",
+    userClientUrl: "https://oauth.staging-app.edgeboost.io",
+    issuer: "https://jwks.connect-staging.edgeboost.io",
+    scopePrefix: "edge-connect-staging/",
+    awsAccountId: "124355668944",
+    displayName: "Staging",
+    isProduction: false,
+    partnerFacing: false
+  },
+  "sandbox-staging": {
+    environment: "sandbox",
+    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",
+    issuer: "https://jwks.sandbox.connect.staging.edgeboost.io",
+    scopePrefix: "edge-connect-sandbox/",
+    awsAccountId: "124355668944",
+    displayName: "Sandbox staging",
+    isProduction: false,
+    partnerFacing: false
+  },
+  "sandbox-production": {
+    environment: "sandbox",
+    apiBaseUrl: "https://sandbox.connect.edgeboost.io/connect/v1",
+    oauthBaseUrl: "https://sandbox.connect.edgeboost.io/connect/oauth",
+    userClientUrl: "https://sandbox-oauth.edgeboost.io",
+    issuer: "https://jwks.sandbox.connect.edgeboost.io",
+    scopePrefix: "edge-connect-sandbox/",
+    awsAccountId: "471257598653",
+    displayName: "Sandbox production",
+    isProduction: false,
+    partnerFacing: true
+  },
   production: {
+    environment: "production",
     apiBaseUrl: "https://connect.edgeboost.io/connect/v1",
     oauthBaseUrl: "https://connect.edgeboost.io/connect/oauth",
     userClientUrl: "https://oauth.edgeboost.io",
+    issuer: "https://jwks.connect.edgeboost.io",
+    scopePrefix: "edge-connect/",
+    awsAccountId: "471257598653",
     displayName: "Production",
-    isProduction: true
-  },
-  sandbox: {
-    // 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
+    isProduction: true,
+    partnerFacing: true
   }
 };
+var EDGE_ENVIRONMENTS = {
+  production: EDGE_DEPLOYMENT_CELLS.production,
+  // The public SDK has two choices. "sandbox" is the canonical partner
+  // sandbox in the production account; internal staging cells use explicit
+  // deployment-cell configuration instead of another public environment enum.
+  sandbox: EDGE_DEPLOYMENT_CELLS["sandbox-production"]
+};
 function getEnvironmentConfig(environment) {
   return EDGE_ENVIRONMENTS[environment];
 }
+function getDeploymentCellConfig(cell) {
+  return EDGE_DEPLOYMENT_CELLS[cell];
+}
+function getAvailableDeploymentCells() {
+  return Object.keys(EDGE_DEPLOYMENT_CELLS);
+}
 function getLinkUrl(environment, linkUrl) {
   const configuredUrl = linkUrl?.trim();
   const url = new URL(configuredUrl || `${EDGE_ENVIRONMENTS[environment].userClientUrl}${EDGE_LINK_PATH}`);
@@ -78,6 +122,12 @@ var EDGE_SCOPES = {
    * Required for: `GET /v1/balance`
    */
   BALANCE_READ: "balance.read",
+  /**
+   * Compare partner-held identity data with the authenticated EDGE profile.
+   * This is separately allowlisted and returns only a coarse advisory result.
+   * Required for: `POST /connect/v2/identity/match`
+   */
+  IDENTITY_MATCH: "identity.match",
   /**
    * Reserved for future fund transfers and EDGE-hosted verification sessions.
    * Not available in sandbox or production. Requesting this scope from Link
@@ -89,16 +139,18 @@ var EDGE_SCOPES = {
   TRANSFER_WRITE: "transfer.write"
 };
 var ACTIVE_EDGE_SCOPES = [EDGE_SCOPES.USER_READ, EDGE_SCOPES.BALANCE_READ];
-var RESERVED_EDGE_SCOPES = [EDGE_SCOPES.TRANSFER_WRITE];
+var RESERVED_EDGE_SCOPES = [EDGE_SCOPES.IDENTITY_MATCH, 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",
+  [EDGE_SCOPES.IDENTITY_MATCH]: "Compare partner-held identity details and return a coarse advisory result",
   [EDGE_SCOPES.TRANSFER_WRITE]: "Transfers are not available yet"
 };
 var SCOPE_ICONS = {
   [EDGE_SCOPES.USER_READ]: "user",
   [EDGE_SCOPES.BALANCE_READ]: "wallet",
+  [EDGE_SCOPES.IDENTITY_MATCH]: "shield-check",
   [EDGE_SCOPES.TRANSFER_WRITE]: "arrow-left-right"
 };
 function formatScopeForEnvironment(scope, environment) {
@@ -218,6 +270,31 @@ var EdgeIdentityVerificationError = class extends EdgeError {
     this.fieldErrors = fieldErrors;
   }
 };
+var EdgeIdentityMatchConflictError = class extends EdgeError {
+  constructor(code, message) {
+    super(code, message || "Identity match could not be completed because a request precondition failed.", 409);
+    this.name = "EdgeIdentityMatchConflictError";
+  }
+};
+var EdgeIdentityMatchAttemptLimitError = class extends EdgeError {
+  constructor(retryAfterSeconds, message) {
+    super("identity_match_attempt_limit", message || "Identity match attempt limit reached. Retry later.", 429, {
+      retryAfterSeconds
+    });
+    this.name = "EdgeIdentityMatchAttemptLimitError";
+    this.retryAfterSeconds = retryAfterSeconds;
+  }
+};
+var EdgeIdentityMatchUnavailableError = class extends EdgeError {
+  constructor(message) {
+    super(
+      "identity_match_unavailable",
+      message || "Identity match is temporarily unavailable. Retry with the same idempotency key.",
+      503
+    );
+    this.name = "EdgeIdentityMatchUnavailableError";
+  }
+};
 var EdgePopupBlockedError = class extends EdgeError {
   constructor() {
     super("popup_blocked", "Popup was blocked by the browser. Please allow popups for this site and try again.");
@@ -263,6 +340,9 @@ function isApiError(error) {
 function isIdentityVerificationError(error) {
   return error instanceof EdgeIdentityVerificationError;
 }
+function isIdentityMatchError(error) {
+  return error instanceof EdgeIdentityMatchConflictError || error instanceof EdgeIdentityMatchAttemptLimitError || error instanceof EdgeIdentityMatchUnavailableError;
+}
 function isNetworkError(error) {
   return error instanceof EdgeNetworkError;
 }
@@ -277,6 +357,7 @@ export {
   ACTIVE_EDGE_SCOPES,
   ALL_EDGE_SCOPES,
   EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE,
+  EDGE_DEPLOYMENT_CELLS,
   EDGE_ENVIRONMENTS,
   EDGE_LINK_PATH,
   EDGE_SCOPES,
@@ -286,6 +367,9 @@ export {
   EdgeConsentRequiredError,
   EdgeError,
   EdgeFeatureUnavailableError,
+  EdgeIdentityMatchAttemptLimitError,
+  EdgeIdentityMatchConflictError,
+  EdgeIdentityMatchUnavailableError,
   EdgeIdentityVerificationError,
   EdgeInsufficientScopeError,
   EdgeNetworkError,
@@ -306,7 +390,9 @@ export {
   TRANSFER_TYPES,
   formatScopeForEnvironment,
   formatScopesForEnvironment,
+  getAvailableDeploymentCells,
   getAvailableEnvironments,
+  getDeploymentCellConfig,
   getEnvironmentConfig,
   getLinkUrl,
   isApiError,
@@ -314,6 +400,7 @@ export {
   isConsentRequiredError,
   isEdgeError,
   isFeatureUnavailableError,
+  isIdentityMatchError,
   isIdentityVerificationError,
   isNetworkError,
   isProductionEnvironment,

package/package.json

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