feat(clerk-sdk-node): Teach node-sdk to work with fetch

Polyfill global.fetch only in Node environments if necessary and increase interoperability for the SDK across Node and V8 runtime environments.

Fixes #127

packages/backend-core/src/api/index.ts

@@ -2,5 +2,5 @@ export * from './ClerkBackendApi';
 export * from './resources';
 export { ClerkAPIResponseError } from './errors';
 
-export type { APIClient } from './endpoints/AbstractApi';
+export type { APIClient, APIRequestOptions } from './endpoints/AbstractApi';
 export type { Session } from './resources/Session';

packages/edge/src/vercel-edge/ClerkAPI.ts

@@ -1,22 +1,46 @@
-import { ClerkBackendAPI } from '@clerk/backend-core';
+import { ClerkAPIResponseError, ClerkBackendAPI } from '@clerk/backend-core';
 
-import { PACKAGE_REPO } from '../constants';
 import { LIB_NAME, LIB_VERSION } from '../info';
 
 export const ClerkAPI = new ClerkBackendAPI({
   libName: LIB_NAME,
   libVersion: LIB_VERSION,
-  packageRepo: PACKAGE_REPO,
-  fetcher: (url, { method, authorization, contentType, userAgent, body }) => {
-    return fetch(url, {
-      method,
-      headers: {
-        authorization: authorization,
-        'Content-Type': contentType,
-        'User-Agent': userAgent,
-        'X-Clerk-SDK': `vercel-edge/${LIB_VERSION}`,
-      },
-      ...(body && { body: JSON.stringify(body) }),
-    }).then(body => (contentType === 'text/html' ? body : body.json()));
+  apiClient: {
+    async request({ url, method, queryParams, headerParams, bodyParams }) {
+      // Build final URL with search parameters
+      const finalUrl = new URL(url || '');
+
+      if (queryParams) {
+        for (const [key, val] of Object.entries(queryParams as Record<string, string | string[]>)) {
+          // Support array values for queryParams such as { foo: [42, 43] }
+          if (val) {
+            [val].flat().forEach(v => finalUrl.searchParams.append(key, v));
+          }
+        }
+      }
+
+      const response = await fetch(finalUrl.href, {
+        method,
+        headers: {
+          ...(headerParams as Record<string, string>),
+          'X-Clerk-SDK': `vercel-edge/${LIB_VERSION}`,
+        },
+        ...(bodyParams && Object.keys(bodyParams).length > 0 && { body: JSON.stringify(bodyParams) }),
+      });
+
+      // Parse JSON or Text response.
+      const isJSONResponse = headerParams && headerParams['Content-Type'] === 'application/json';
+      const data = await (isJSONResponse ? response.json() : response.text());
+
+      // Check for errors
+      if (!response.ok) {
+        throw new ClerkAPIResponseError(response.statusText, {
+          data: data?.errors || data,
+          status: response.status,
+        });
+      }
+
+      return data;
+    },
   },
 });

packages/edge/src/vercel-edge/index.ts

@@ -2,14 +2,28 @@ import { AuthStatus, Base, createGetToken, createSignedOutState } from '@clerk/b
 import { ClerkJWTClaims } from '@clerk/types';
 import { NextFetchEvent, NextRequest, NextResponse } from 'next/server';
 
-import { ClerkAPI } from './ClerkAPI';
+import { ClerkAPI } from './ClerkApi';
 import {
+  AuthData,
   NextMiddlewareResult,
+  RequestWithAuth,
   WithEdgeMiddlewareAuthCallback,
   WithEdgeMiddlewareAuthMiddlewareResult,
   WithEdgeMiddlewareAuthOptions,
 } from './types';
-import { injectAuthIntoRequest } from './utils';
+
+export function injectAuthIntoRequest(req: NextRequest, authData: AuthData): RequestWithAuth {
+  const { user, session, userId, sessionId, getToken, claims } = authData;
+  const auth = {
+    userId,
+    sessionId,
+    getToken,
+    claims,
+  };
+
+  /* Object.assign is used here as NextRequest properties also include Symbols */
+  return Object.assign(req, { auth, user, session });
+}
 
 /**
  *
@@ -55,8 +69,7 @@ const users = ClerkAPI.users;
 export { allowlistIdentifiers, clients, emails, invitations, organizations, sessions, smsMessages, users };
 
 async function fetchInterstitial() {
-  const response = await ClerkAPI.fetchInterstitial<Response>();
-  return response.text();
+  return ClerkAPI.fetchInterstitial<string>();
 }
 
 export function withEdgeMiddlewareAuth<