build: add file extensions to ESM imports (#139)

- Replace TypeScript compiler with esbuild for ESM build
- Add esbuild-plugin-file-path-extensions to generate proper .mjs imports
- Fix "Cannot find module" errors in Node.js ESM resolution
- Ensure published packages work correctly in production environments

resolves: trufnetwork/truf-network#1205

Author: MicBun

build-esm.js

@@ -0,0 +1,84 @@
+const esbuild = require('esbuild');
+const { esbuildPluginFilePathExtensions } = require('esbuild-plugin-file-path-extensions');
+const fs = require('fs');
+
+async function buildESM() {
+  try {
+    // Clean and create dist-esm directory
+    if (fs.existsSync('./dist-esm')) {
+      fs.rmSync('./dist-esm', { recursive: true, force: true });
+    }
+    fs.mkdirSync('./dist-esm', { recursive: true });
+
+    // Get all TypeScript files
+    const glob = require('glob');
+    const entryPoints = glob.sync('./src/**/*.ts');
+
+    // Build ESM with file path extensions
+    await esbuild.build({
+      entryPoints,
+      bundle: false, // Don't bundle - keep separate files
+      outdir: './dist-esm',
+      format: 'esm',
+      target: 'es2021',
+      platform: 'neutral',
+      sourcemap: false,
+      outExtension: { '.js': '.mjs' },
+      plugins: [esbuildPluginFilePathExtensions({
+        esmExtension: '.mjs',
+        filter: /\.ts$/
+      })],
+    });
+
+    // Create package.json for ESM
+    fs.writeFileSync('./dist-esm/package.json', '{"type":"module"}\n');
+
+    // Post-process to fix import extensions
+    const fixImportExtensions = (dir) => {
+      const files = fs.readdirSync(dir);
+      for (const file of files) {
+        const filePath = `${dir}/${file}`;
+        const stat = fs.statSync(filePath);
+
+        if (stat.isDirectory()) {
+          fixImportExtensions(filePath);
+        } else if (file.endsWith('.mjs')) {
+          let content = fs.readFileSync(filePath, 'utf8');
+
+          // Fix relative imports that don't have .mjs extension
+          content = content.replace(
+            /from\s+["'](\.[^"']+)["']/g,
+            (match, importPath) => {
+              if (!importPath.endsWith('.mjs') && !importPath.endsWith('.js')) {
+                return match.replace(importPath, importPath + '.mjs');
+              }
+              return match;
+            }
+          );
+
+          // Fix import statements too
+          content = content.replace(
+            /import\s+[^"']*from\s+["'](\.[^"']+)["']/g,
+            (match, importPath) => {
+              if (!importPath.endsWith('.mjs') && !importPath.endsWith('.js')) {
+                return match.replace(importPath, importPath + '.mjs');
+              }
+              return match;
+            }
+          );
+
+          fs.writeFileSync(filePath, content);
+        }
+      }
+    };
+
+    fixImportExtensions('./dist-esm');
+
+    console.log('✅ ESM build completed with file extensions');
+  } catch (error) {
+    console.error('❌ ESM build failed:', error);
+    process.exit(1);
+  }
+}
+
+buildESM();

package.json

@@ -1,14 +1,14 @@
 {
   "name": "@trufnetwork/kwil-js",
-  "version": "0.9.7",
+  "version": "0.9.8",
   "description": "",
   "main": "./dist/index.js",
-  "module": "./dist-esm/index.js",
+  "module": "./dist-esm/index.mjs",
   "types": "./dist/index.d.ts",
   "sideEffects": false,
   "exports": {
     ".": {
-      "import": "./dist-esm/index.js",
+      "import": "./dist-esm/index.mjs",
       "require": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
@@ -22,6 +22,7 @@
     "dist/**/*.js",
     "dist/**/*.d.ts",
     "dist-esm/**/*.js",
+    "dist-esm/**/*.mjs",
     "dist-esm/**/*.d.ts",
     "dist-esm/package.json",
     "!dist/**/*.map",
@@ -34,7 +35,7 @@
   ],
   "scripts": {
     "clean": "rimraf dist/* dist-esm/*",
-    "build": "pnpm run clean && tsc && tsc -p tsconfig.esm.json && node -e \"const fs=require('fs');fs.mkdirSync('dist-esm',{recursive:true});fs.writeFileSync('dist-esm/package.json','{\\\"type\\\":\\\"module\\\"}\\n');\"",
+    "build": "pnpm run clean && tsc && node build-esm.js",
     "type-check:esm": "tsc -p tsconfig.esm.json --noEmit",
     "commit": "git add . && git-cz",
     "prepare": "husky install",
@@ -62,9 +63,12 @@
     "copyfiles": "^2.4.1",
     "cz-conventional-changelog": "^3.3.0",
     "dotenv": "^16.4.5",
+    "esbuild": "^0.25.10",
+    "esbuild-plugin-file-path-extensions": "^2.1.4",
     "eslint": "^8.23.1",
     "eslint-config-prettier": "^8.5.0",
     "eslint-plugin-prettier": "^4.2.1",
+    "glob": "^11.0.3",
     "husky": "^8.0.3",
     "jest": "^29.7.0",
     "near-api-js": "^2.1.4",