@edge-markets/connect 1.6.0 → 1.7.0

package/README.md

@@ -87,12 +87,14 @@ Get environment-specific URLs:
 ```typescript
 import {
   getEnvironmentConfig,
+  getLinkUrl,
   EDGE_SCOPES,
   formatScopeForEnvironment,
 } from '@edge-markets/connect'
 
 const config = getEnvironmentConfig('staging')
 console.log(config.apiBaseUrl) // https://...
+console.log(getLinkUrl('staging')) // https://oauth.staging-app.edgeboost.io/oauth/link
 
 // Format scopes for your environment
 const scopes = formatScopeForEnvironment(EDGE_SCOPES.BALANCE_READ, 'staging')

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 type EdgeEnvironment = 'production' | 'staging' | 'sandbox' | 'development';
+declare const EDGE_LINK_PATH = "/oauth/link";
 interface EdgeEnvironmentConfig {
     /**
      * @deprecated cognitoDomain is no longer used. Token exchange now goes through EdgeBoost API.
@@ -12,6 +13,14 @@ interface EdgeEnvironmentConfig {
 }
 declare const EDGE_ENVIRONMENTS: Readonly<Record<EdgeEnvironment, EdgeEnvironmentConfig>>;
 declare function getEnvironmentConfig(environment: EdgeEnvironment): EdgeEnvironmentConfig;
+/**
+ * Resolves the hosted Link UI URL for an environment.
+ *
+ * `linkUrl` is an advanced override for nonstandard deployments. It accepts
+ * either the full Link URL (`https://oauth.example.com/oauth/link`) or just the
+ * hosted OAuth origin (`https://oauth.example.com`).
+ */
+declare function getLinkUrl(environment: EdgeEnvironment, linkUrl?: string): string;
 declare function isProductionEnvironment(environment: EdgeEnvironment): boolean;
 declare function getAvailableEnvironments(): readonly EdgeEnvironment[];
 
@@ -2327,7 +2336,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).
  */
@@ -3212,4 +3230,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_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, isApiError, isAuthenticationError, isConsentRequiredError, isEdgeError, isIdentityVerificationError, isNetworkError, isProductionEnvironment, isValidScope, type operations, parseScope, type paths };
+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 };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 type EdgeEnvironment = 'production' | 'staging' | 'sandbox' | 'development';
+declare const EDGE_LINK_PATH = "/oauth/link";
 interface EdgeEnvironmentConfig {
     /**
      * @deprecated cognitoDomain is no longer used. Token exchange now goes through EdgeBoost API.
@@ -12,6 +13,14 @@ interface EdgeEnvironmentConfig {
 }
 declare const EDGE_ENVIRONMENTS: Readonly<Record<EdgeEnvironment, EdgeEnvironmentConfig>>;
 declare function getEnvironmentConfig(environment: EdgeEnvironment): EdgeEnvironmentConfig;
+/**
+ * Resolves the hosted Link UI URL for an environment.
+ *
+ * `linkUrl` is an advanced override for nonstandard deployments. It accepts
+ * either the full Link URL (`https://oauth.example.com/oauth/link`) or just the
+ * hosted OAuth origin (`https://oauth.example.com`).
+ */
+declare function getLinkUrl(environment: EdgeEnvironment, linkUrl?: string): string;
 declare function isProductionEnvironment(environment: EdgeEnvironment): boolean;
 declare function getAvailableEnvironments(): readonly EdgeEnvironment[];
 
@@ -2327,7 +2336,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).
  */
@@ -3212,4 +3230,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_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, isApiError, isAuthenticationError, isConsentRequiredError, isEdgeError, isIdentityVerificationError, isNetworkError, isProductionEnvironment, isValidScope, type operations, parseScope, type paths };
+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 };

package/dist/index.js

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   ALL_EDGE_SCOPES: () => ALL_EDGE_SCOPES,
   EDGE_ENVIRONMENTS: () => EDGE_ENVIRONMENTS,
+  EDGE_LINK_PATH: () => EDGE_LINK_PATH,
   EDGE_SCOPES: () => EDGE_SCOPES,
   EDGE_WEBHOOK_EVENT_TYPES: () => EDGE_WEBHOOK_EVENT_TYPES,
   EdgeApiError: () => EdgeApiError,
@@ -49,6 +50,7 @@ __export(index_exports, {
   formatScopesForEnvironment: () => formatScopesForEnvironment,
   getAvailableEnvironments: () => getAvailableEnvironments,
   getEnvironmentConfig: () => getEnvironmentConfig,
+  getLinkUrl: () => getLinkUrl,
   isApiError: () => isApiError,
   isAuthenticationError: () => isAuthenticationError,
   isConsentRequiredError: () => isConsentRequiredError,
@@ -88,12 +90,13 @@ var EDGE_WEBHOOK_EVENT_TYPES = [
 ];
 
 // src/config/environments.ts
+var EDGE_LINK_PATH = "/oauth/link";
 var EDGE_ENVIRONMENTS = {
   production: {
     cognitoDomain: "https://edge-connect.auth.us-east-1.amazoncognito.com",
-    apiBaseUrl: "https://api.edgeboost.com/connect/v1",
-    oauthBaseUrl: "https://api.edgeboost.com/api/v3/oauth",
-    userClientUrl: "https://app.edgeboost.com",
+    apiBaseUrl: "https://connect.edgeboost.io/connect/v1",
+    oauthBaseUrl: "https://connect.edgeboost.io/connect/oauth",
+    userClientUrl: "https://oauth.edgeboost.io",
     displayName: "Production",
     isProduction: true
   },
@@ -109,15 +112,15 @@ var EDGE_ENVIRONMENTS = {
     // 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.bet",
+    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://sandbox-api.edgeboost.com/connect/v1",
-    oauthBaseUrl: "https://sandbox-api.edgeboost.com/api/v3/oauth",
-    userClientUrl: "https://sandbox.edgeboost.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",
     displayName: "Sandbox",
     isProduction: false
   },
@@ -143,6 +146,17 @@ var EDGE_ENVIRONMENTS = {
 function getEnvironmentConfig(environment) {
   return EDGE_ENVIRONMENTS[environment];
 }
+function getLinkUrl(environment, linkUrl) {
+  const configuredUrl = linkUrl?.trim();
+  const url = new URL(configuredUrl || `${EDGE_ENVIRONMENTS[environment].userClientUrl}${EDGE_LINK_PATH}`);
+  const normalizedPath = url.pathname.replace(/\/+$/, "");
+  if (!normalizedPath || normalizedPath === "/" || normalizedPath === "/oauth") {
+    url.pathname = EDGE_LINK_PATH;
+  } else {
+    url.pathname = normalizedPath;
+  }
+  return url.toString();
+}
 function isProductionEnvironment(environment) {
   return EDGE_ENVIRONMENTS[environment].isProduction;
 }
@@ -342,6 +356,7 @@ var SDK_NAME = "@edge-markets/connect";
 0 && (module.exports = {
   ALL_EDGE_SCOPES,
   EDGE_ENVIRONMENTS,
+  EDGE_LINK_PATH,
   EDGE_SCOPES,
   EDGE_WEBHOOK_EVENT_TYPES,
   EdgeApiError,
@@ -369,6 +384,7 @@ var SDK_NAME = "@edge-markets/connect";
   formatScopesForEnvironment,
   getAvailableEnvironments,
   getEnvironmentConfig,
+  getLinkUrl,
   isApiError,
   isAuthenticationError,
   isConsentRequiredError,

package/dist/index.mjs

@@ -25,12 +25,13 @@ var EDGE_WEBHOOK_EVENT_TYPES = [
 ];
 
 // src/config/environments.ts
+var EDGE_LINK_PATH = "/oauth/link";
 var EDGE_ENVIRONMENTS = {
   production: {
     cognitoDomain: "https://edge-connect.auth.us-east-1.amazoncognito.com",
-    apiBaseUrl: "https://api.edgeboost.com/connect/v1",
-    oauthBaseUrl: "https://api.edgeboost.com/api/v3/oauth",
-    userClientUrl: "https://app.edgeboost.com",
+    apiBaseUrl: "https://connect.edgeboost.io/connect/v1",
+    oauthBaseUrl: "https://connect.edgeboost.io/connect/oauth",
+    userClientUrl: "https://oauth.edgeboost.io",
     displayName: "Production",
     isProduction: true
   },
@@ -46,15 +47,15 @@ var EDGE_ENVIRONMENTS = {
     // 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.bet",
+    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://sandbox-api.edgeboost.com/connect/v1",
-    oauthBaseUrl: "https://sandbox-api.edgeboost.com/api/v3/oauth",
-    userClientUrl: "https://sandbox.edgeboost.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",
     displayName: "Sandbox",
     isProduction: false
   },
@@ -80,6 +81,17 @@ var EDGE_ENVIRONMENTS = {
 function getEnvironmentConfig(environment) {
   return EDGE_ENVIRONMENTS[environment];
 }
+function getLinkUrl(environment, linkUrl) {
+  const configuredUrl = linkUrl?.trim();
+  const url = new URL(configuredUrl || `${EDGE_ENVIRONMENTS[environment].userClientUrl}${EDGE_LINK_PATH}`);
+  const normalizedPath = url.pathname.replace(/\/+$/, "");
+  if (!normalizedPath || normalizedPath === "/" || normalizedPath === "/oauth") {
+    url.pathname = EDGE_LINK_PATH;
+  } else {
+    url.pathname = normalizedPath;
+  }
+  return url.toString();
+}
 function isProductionEnvironment(environment) {
   return EDGE_ENVIRONMENTS[environment].isProduction;
 }
@@ -278,6 +290,7 @@ var SDK_NAME = "@edge-markets/connect";
 export {
   ALL_EDGE_SCOPES,
   EDGE_ENVIRONMENTS,
+  EDGE_LINK_PATH,
   EDGE_SCOPES,
   EDGE_WEBHOOK_EVENT_TYPES,
   EdgeApiError,
@@ -305,6 +318,7 @@ export {
   formatScopesForEnvironment,
   getAvailableEnvironments,
   getEnvironmentConfig,
+  getLinkUrl,
   isApiError,
   isAuthenticationError,
   isConsentRequiredError,

package/package.json

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