@edge-markets/connect-node 1.9.0 → 1.10.1

package/README.md

@@ -92,7 +92,9 @@ Supported environment variables:
 | `EDGE_PARTNER_CLIENT_SECRET` | Partner machine-to-machine client secret for webhook sync |
 | `EDGE_MTLS_CERT` / `EDGE_MTLS_CERT_PATH` | Client certificate PEM or file path |
 | `EDGE_MTLS_KEY` / `EDGE_MTLS_KEY_PATH` | Client private key PEM or file path |
-| `EDGE_MTLS_CA` / `EDGE_MTLS_CA_PATH` | Optional extra server trust root PEM or file path |
+| `EDGE_SERVER_CA_PEM` / `EDGE_SERVER_CA_PEM_PATH` | Optional extra server trust root PEM or file path |
+| `EDGE_MTLS_CA` / `EDGE_MTLS_CA_PATH` | Legacy alias for optional extra server trust root PEM or file path |
+| `EDGE_REQUIRE_MTLS` | Set to `true` to fail startup unless client cert and key are configured |
 | `EDGE_TIMEOUT_MS` | Optional request timeout in milliseconds |
 
 Use inline PEMs with escaped newlines (`\n`) or file paths. If both are set,
@@ -194,6 +196,40 @@ to Node's default public trust roots instead of replacing them.
 
 Do not disable TLS verification and do not set `NODE_TLS_REJECT_UNAUTHORIZED=0`.
 
+### Next.js and Vercel Route Handlers
+
+`@edge-markets/connect-node` is a Node.js server SDK. In Next.js Route Handlers,
+force the Node runtime before importing or constructing the SDK:
+
+```typescript
+export const runtime = 'nodejs'
+
+import { createEdgeConnectServerFromEnv } from '@edge-markets/connect-node'
+
+const { server: edge } = createEdgeConnectServerFromEnv({
+  requireMtls: true,
+})
+```
+
+Do not import this package from Client Components, browser code, middleware, or
+Edge Runtime handlers. It reads server-only secrets and uses Node TLS APIs for
+mTLS.
+
+If you are pinned to an older SDK version and your Next.js/Turbopack build logs
+show `dynamic usage of require is not supported`, externalize the package as an
+app-level mitigation until you can upgrade:
+
+```typescript
+// next.config.ts
+import type { NextConfig } from 'next'
+
+const nextConfig: NextConfig = {
+  serverExternalPackages: ['@edge-markets/connect-node', 'undici'],
+}
+
+export default nextConfig
+```
+
 ## Token Exchange
 
 After EdgeLink completes, exchange the code for tokens:

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import * as node_https from 'node:https';
 import { EdgeEnvironment, TransferCategory, Transfer, VerificationSession, TransferType, TransferStatus, User, VerifyIdentityOptions, VerifyIdentityResult, Balance, ListTransfersParams, TransferList, CreateVerificationSessionRequest, VerificationSessionStatusResponse, EdgeTokens, EdgeWebhookEvent, EdgeWebhookEventType } from '@edge-markets/connect';
-export { Balance, BaseWebhookEvent, ConsentRevokedEventData, CreateVerificationSessionRequest, EDGE_WEBHOOK_EVENT_TYPES, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, EdgeEnvironment, EdgeError, EdgeIdentityVerificationError, EdgeInsufficientScopeError, EdgeNetworkError, EdgeNotFoundError, EdgeTokenExchangeError, EdgeTokens, EdgeValidationError, EdgeWebhookEvent, EdgeWebhookEventType, ListTransfersParams, SdkGeolocation, TRANSFER_CATEGORIES, Transfer, TransferCategory, TransferCompletedEventData, TransferExpiredEventData, TransferFailedEventData, TransferList, TransferListItem, TransferProcessingEventData, TransferStatus, TransferType, User, UserAddress, VerificationSession, VerificationSessionStatus, VerificationSessionStatusResponse, VerifyIdentityAddress, VerifyIdentityOptions, VerifyIdentityResult, VerifyIdentityScores, getEnvironmentConfig, isApiError, isAuthenticationError, isConsentRequiredError, isEdgeError, isIdentityVerificationError, isNetworkError, isProductionEnvironment } from '@edge-markets/connect';
+export { ACTIVE_EDGE_SCOPES, Balance, BaseWebhookEvent, ConsentRevokedEventData, CreateVerificationSessionRequest, EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE, EDGE_WEBHOOK_EVENT_TYPES, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, EdgeEnvironment, EdgeError, EdgeFeatureUnavailableError, EdgeIdentityVerificationError, EdgeInsufficientScopeError, EdgeNetworkError, EdgeNotFoundError, EdgeTokenExchangeError, EdgeTokens, EdgeValidationError, EdgeWebhookEvent, EdgeWebhookEventType, ListTransfersParams, SdkGeolocation, TRANSFER_CATEGORIES, Transfer, TransferCategory, TransferCompletedEventData, TransferExpiredEventData, TransferFailedEventData, TransferList, TransferListItem, TransferProcessingEventData, TransferStatus, TransferType, User, UserAddress, VerificationSession, VerificationSessionStatus, VerificationSessionStatusResponse, VerifyIdentityAddress, VerifyIdentityOptions, VerifyIdentityResult, VerifyIdentityScores, getEnvironmentConfig, isApiError, isAuthenticationError, isConsentRequiredError, isEdgeError, isFeatureUnavailableError, isIdentityVerificationError, isNetworkError, isProductionEnvironment } from '@edge-markets/connect';
 
 type RequestEndpoint = 'connect_api' | 'oauth_token' | 'partner_webhook_sync';
 interface RequestInfo {
@@ -175,14 +175,13 @@ declare class EdgeUserClient {
         revoked: boolean;
     }>;
     /**
-     * Creates an EDGE-hosted transfer verification session.
-     * Returns a `verificationUrl` to open in an iframe or popup.
-     * The handoff token is single-use and expires in 120 seconds.
+     * Reserved for a future transfer release.
+     * Currently throws EdgeFeatureUnavailableError before validation or network I/O.
      */
     createVerificationSession(transferId: string, options: CreateVerificationSessionRequest): Promise<VerificationSession>;
     /**
-     * Polls the status of a verification session.
-     * Use as an alternative to postMessage events.
+     * Reserved for a future transfer release.
+     * Currently throws EdgeFeatureUnavailableError before validation or network I/O.
      */
     getVerificationSessionStatus(transferId: string, sessionId: string): Promise<VerificationSessionStatusResponse>;
 }

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as node_https from 'node:https';
 import { EdgeEnvironment, TransferCategory, Transfer, VerificationSession, TransferType, TransferStatus, User, VerifyIdentityOptions, VerifyIdentityResult, Balance, ListTransfersParams, TransferList, CreateVerificationSessionRequest, VerificationSessionStatusResponse, EdgeTokens, EdgeWebhookEvent, EdgeWebhookEventType } from '@edge-markets/connect';
-export { Balance, BaseWebhookEvent, ConsentRevokedEventData, CreateVerificationSessionRequest, EDGE_WEBHOOK_EVENT_TYPES, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, EdgeEnvironment, EdgeError, EdgeIdentityVerificationError, EdgeInsufficientScopeError, EdgeNetworkError, EdgeNotFoundError, EdgeTokenExchangeError, EdgeTokens, EdgeValidationError, EdgeWebhookEvent, EdgeWebhookEventType, ListTransfersParams, SdkGeolocation, TRANSFER_CATEGORIES, Transfer, TransferCategory, TransferCompletedEventData, TransferExpiredEventData, TransferFailedEventData, TransferList, TransferListItem, TransferProcessingEventData, TransferStatus, TransferType, User, UserAddress, VerificationSession, VerificationSessionStatus, VerificationSessionStatusResponse, VerifyIdentityAddress, VerifyIdentityOptions, VerifyIdentityResult, VerifyIdentityScores, getEnvironmentConfig, isApiError, isAuthenticationError, isConsentRequiredError, isEdgeError, isIdentityVerificationError, isNetworkError, isProductionEnvironment } from '@edge-markets/connect';
+export { ACTIVE_EDGE_SCOPES, Balance, BaseWebhookEvent, ConsentRevokedEventData, CreateVerificationSessionRequest, EDGE_CONNECT_FEATURE_UNAVAILABLE_MESSAGE, EDGE_WEBHOOK_EVENT_TYPES, EdgeApiError, EdgeAuthenticationError, EdgeConsentRequiredError, EdgeEnvironment, EdgeError, EdgeFeatureUnavailableError, EdgeIdentityVerificationError, EdgeInsufficientScopeError, EdgeNetworkError, EdgeNotFoundError, EdgeTokenExchangeError, EdgeTokens, EdgeValidationError, EdgeWebhookEvent, EdgeWebhookEventType, ListTransfersParams, SdkGeolocation, TRANSFER_CATEGORIES, Transfer, TransferCategory, TransferCompletedEventData, TransferExpiredEventData, TransferFailedEventData, TransferList, TransferListItem, TransferProcessingEventData, TransferStatus, TransferType, User, UserAddress, VerificationSession, VerificationSessionStatus, VerificationSessionStatusResponse, VerifyIdentityAddress, VerifyIdentityOptions, VerifyIdentityResult, VerifyIdentityScores, getEnvironmentConfig, isApiError, isAuthenticationError, isConsentRequiredError, isEdgeError, isFeatureUnavailableError, isIdentityVerificationError, isNetworkError, isProductionEnvironment } from '@edge-markets/connect';
 
 type RequestEndpoint = 'connect_api' | 'oauth_token' | 'partner_webhook_sync';
 interface RequestInfo {
@@ -175,14 +175,13 @@ declare class EdgeUserClient {
         revoked: boolean;
     }>;
     /**
-     * Creates an EDGE-hosted transfer verification session.
-     * Returns a `verificationUrl` to open in an iframe or popup.
-     * The handoff token is single-use and expires in 120 seconds.
+     * Reserved for a future transfer release.
+     * Currently throws EdgeFeatureUnavailableError before validation or network I/O.
      */
     createVerificationSession(transferId: string, options: CreateVerificationSessionRequest): Promise<VerificationSession>;
     /**
-     * Polls the status of a verification session.
-     * Use as an alternative to postMessage events.
+     * Reserved for a future transfer release.
+     * Currently throws EdgeFeatureUnavailableError before validation or network I/O.
      */
     getVerificationSessionStatus(transferId: string, sessionId: string): Promise<VerificationSessionStatusResponse>;
 }