fix! Change to ES Modules to support dynamic loading in Next.js

jsonbailey · jsonbailey · commit 3a14126709cc · 2025-11-19T14:27:13.000Z
diff --git a/packages/ai-providers/server-ai-langchain/package.json b/packages/ai-providers/server-ai-langchain/package.json
@@ -9,7 +9,14 @@
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "type": "commonjs",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
   "scripts": {
     "build": "npx tsc",
     "lint": "npx eslint . --ext .ts",
@@ -27,6 +34,7 @@
   "author": "LaunchDarkly",
   "license": "Apache-2.0",
   "devDependencies": {
+    "@langchain/community": "^0.3.0",
     "@langchain/core": "^0.3.0",
     "@launchdarkly/server-sdk-ai": "^0.14.1",
     "@trivago/prettier-plugin-sort-imports": "^4.1.1",
@@ -47,6 +55,7 @@
     "typescript": "5.1.6"
   },
   "peerDependencies": {
+    "@langchain/community": "^0.2.0 || ^0.3.0",
     "@langchain/core": "^0.2.0 || ^0.3.0",
     "@launchdarkly/server-sdk-ai": "^0.14.0",
     "langchain": "^0.2.0 || ^0.3.0"
diff --git a/packages/ai-providers/server-ai-langchain/tsconfig.json b/packages/ai-providers/server-ai-langchain/tsconfig.json
@@ -1,7 +1,7 @@
 {
   "compilerOptions": {
     "target": "ES2020",
-    "module": "CommonJS",
+    "module": "ES2020",
     "lib": ["ES2020"],
     "moduleResolution": "node",
     "esModuleInterop": true,
diff --git a/packages/ai-providers/server-ai-openai/package.json b/packages/ai-providers/server-ai-openai/package.json
@@ -9,7 +9,14 @@
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "type": "commonjs",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
   "scripts": {
     "build": "npx tsc",
     "lint": "npx eslint . --ext .ts",
diff --git a/packages/ai-providers/server-ai-openai/tsconfig.json b/packages/ai-providers/server-ai-openai/tsconfig.json
@@ -1,7 +1,7 @@
 {
   "compilerOptions": {
     "target": "ES2020",
-    "module": "CommonJS",
+    "module": "ES2020",
     "lib": ["ES2020"],
     "moduleResolution": "node",
     "esModuleInterop": true,
diff --git a/packages/ai-providers/server-ai-vercel/package.json b/packages/ai-providers/server-ai-vercel/package.json
@@ -9,7 +9,14 @@
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "type": "commonjs",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
   "scripts": {
     "build": "npx tsc",
     "lint": "npx eslint . --ext .ts",
diff --git a/packages/ai-providers/server-ai-vercel/tsconfig.json b/packages/ai-providers/server-ai-vercel/tsconfig.json
@@ -1,7 +1,7 @@
 {
   "compilerOptions": {
     "target": "ES2020",
-    "module": "CommonJS",
+    "module": "ES2020",
     "lib": ["ES2020"],
     "moduleResolution": "node",
     "esModuleInterop": true,
diff --git a/packages/sdk/server-ai/package.json b/packages/sdk/server-ai/package.json
@@ -9,9 +9,16 @@
   },
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
-  "type": "commonjs",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js",
+      "default": "./dist/src/index.js"
+    }
+  },
   "scripts": {
-    "build": "npx tsc",
+    "build": "npx tsc && ../../../scripts/replace-version.sh .",
     "lint": "npx eslint . --ext .ts",
     "prettier": "prettier --write '**/*.@(js|ts|tsx|json|css)' --ignore-path ../../../.prettierignore",
     "lint:fix": "yarn run lint --fix",
diff --git a/packages/sdk/server-ai/src/LDAIClientImpl.ts b/packages/sdk/server-ai/src/LDAIClientImpl.ts
@@ -1,4 +1,4 @@
-import * as Mustache from 'mustache';
+import Mustache from 'mustache';
 
 import { LDContext, LDLogger } from '@launchdarkly/js-server-sdk-common';
 
diff --git a/packages/sdk/server-ai/src/LDAIConfigTrackerImpl.ts b/packages/sdk/server-ai/src/LDAIConfigTrackerImpl.ts
@@ -1,6 +1,5 @@
 import { LDContext } from '@launchdarkly/js-server-sdk-common';
 
-import { name as aiSdkName, version as aiSdkVersion } from '../package.json';
 import { LDAIConfigTracker } from './api/config';
 import { LDAIMetricSummary } from './api/config/LDAIConfigTracker';
 import { EvalScore, JudgeResponse } from './api/judge/types';
@@ -14,6 +13,9 @@ import {
 } from './api/metrics';
 import { LDClientMin } from './LDClientMin';
 
+const aiSdkName = '@launchdarkly/server-sdk-ai';
+const aiSdkVersion = '__LD_VERSION__';
+
 export class LDAIConfigTrackerImpl implements LDAIConfigTracker {
   private _trackedMetrics: LDAIMetricSummary = {};
 
diff --git a/packages/sdk/server-ai/src/api/judge/Judge.ts b/packages/sdk/server-ai/src/api/judge/Judge.ts
@@ -1,4 +1,4 @@
-import * as Mustache from 'mustache';
+import Mustache from 'mustache';
 
 import { LDLogger } from '@launchdarkly/js-server-sdk-common';
 
diff --git a/packages/sdk/server-ai/src/api/providers/AIProviderFactory.ts b/packages/sdk/server-ai/src/api/providers/AIProviderFactory.ts
@@ -43,9 +43,13 @@ export class AIProviderFactory {
     // Try each provider in order
     // eslint-disable-next-line no-restricted-syntax
     for (const providerType of providersToTry) {
+      logger?.debug(
+        `Attempting to create AIProvider for: ${aiConfig.provider?.name} with provider type: ${providerType}`,
+      );
       // eslint-disable-next-line no-await-in-loop
       const provider = await this._tryCreateProvider(providerType, aiConfig, logger);
       if (provider) {
+        logger?.debug(`Successfully created AIProvider for: ${aiConfig.provider?.name}`);
         return provider;
       }
     }
@@ -93,58 +97,35 @@ export class AIProviderFactory {
     providerType: SupportedAIProvider,
     aiConfig: LDAIConfigKind,
     logger?: LDLogger,
-  ): Promise<AIProvider | undefined> {
-    switch (providerType) {
-      case 'openai':
-        return this._createProvider(
-          '@launchdarkly/server-sdk-ai-openai',
-          'OpenAIProvider',
-          aiConfig,
-          logger,
-        );
-      case 'langchain':
-        return this._createProvider(
-          '@launchdarkly/server-sdk-ai-langchain',
-          'LangChainProvider',
-          aiConfig,
-          logger,
-        );
-      case 'vercel':
-        return this._createProvider(
-          '@launchdarkly/server-sdk-ai-vercel',
-          'VercelProvider',
-          aiConfig,
-          logger,
-        );
-      default:
-        return undefined;
-    }
-  }
-
-  /**
-   * Create a provider instance dynamically.
-   */
-  private static async _createProvider(
-    packageName: string,
-    providerClassName: string,
-    aiConfig: LDAIConfigKind,
-    logger?: LDLogger,
   ): Promise<AIProvider | undefined> {
     try {
-      // Try to dynamically import the provider
-      // This will work if the package is installed
-      // eslint-disable-next-line import/no-extraneous-dependencies, global-require, import/no-dynamic-require
-      const { [providerClassName]: ProviderClass } = require(packageName);
+      let module;
 
-      const provider = await ProviderClass.create(aiConfig, logger);
-      logger?.debug(
-        `Successfully created AIProvider for: ${aiConfig.provider?.name} with package ${packageName}`,
-      );
-      return provider;
-    } catch (error) {
-      // If the provider is not available or creation fails, return undefined
+      switch (providerType) {
+        case 'openai': {
+          // eslint-disable-next-line import/no-extraneous-dependencies
+          module = await import('@launchdarkly/server-sdk-ai-openai' as any);
+          const provider = (await module.OpenAIProvider.create(aiConfig, logger)) as AIProvider;
+          return provider;
+        }
+        case 'langchain': {
+          // eslint-disable-next-line import/no-extraneous-dependencies
+          module = await import('@launchdarkly/server-sdk-ai-langchain' as any);
+          const provider = (await module.LangChainProvider.create(aiConfig, logger)) as AIProvider;
+          return provider;
+        }
+        case 'vercel': {
+          // eslint-disable-next-line import/no-extraneous-dependencies
+          module = await import('@launchdarkly/server-sdk-ai-vercel' as any);
+          const provider = (await module.VercelProvider.create(aiConfig, logger)) as AIProvider;
+          return provider;
+        }
+        default:
+          return undefined;
+      }
+    } catch (error: any) {
       logger?.warn(
-        `Error creating AIProvider for: ${aiConfig.provider?.name} with package ${packageName}: ${error}`,
+        `Unable to create AIProvider. Check that you have installed the correct package. ${error.message}`,
       );
       return undefined;
     }
diff --git a/packages/sdk/server-ai/tsconfig.json b/packages/sdk/server-ai/tsconfig.json
@@ -3,13 +3,13 @@
     // Uses "." so it can load package.json.
     "rootDir": ".",
     "outDir": "dist",
-    "target": "es2017",
-    "lib": ["es6"],
-    "module": "commonjs",
+    "target": "es2020",
+    "lib": ["es2020"],
+    "module": "ES2020",
     "strict": true,
     "noImplicitOverride": true,
-    // Needed for CommonJS modules.
     "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
     "sourceMap": true,
     "declaration": true,
     "declarationMap": true, // enables importers to jump to source

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"compilerOptions": {`
`3`	`3`	`"target": "ES2020",`
`4`		`- "module": "CommonJS",`
	`4`	`+ "module": "ES2020",`
`5`	`5`	`"lib": ["ES2020"],`
`6`	`6`	`"moduleResolution": "node",`
`7`	`7`	`"esModuleInterop": true,`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-import * as Mustache from 'mustache';`
	`1`	`+import Mustache from 'mustache';`
`2`	`2`
`3`	`3`	`import { LDContext, LDLogger } from '@launchdarkly/js-server-sdk-common';`
`4`	`4`