Node.js CJS vs ESM 모듈 시스템 완전 정리

{
  "type": "module",
  "main": "./dist/index.cjs",
  "module": "./dist/index.js",
  "exports": {
    ".": {
      "import": "./dist/index.js",
      "require": "./dist/index.cjs"
    }
  }
}

// ESM에서는 __dirname, __filename이 없음
import { fileURLToPath } from 'url';
import { dirname, join } from 'path';

const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);

const configPath = join(__dirname, '../config/app.json');

// ESM에서 동적 로드 (CJS require와 비슷)
const module = await import('./plugin.js');

// 조건부 로드
async function loadConfig() {
  if (process.env.NODE_ENV === 'test') {
    return (await import('./config.test.js')).default;
  }
  return (await import('./config.js')).default;
}

// CJS에서 ESM 패키지를 동기적으로 require할 수 없음
// ❌ const esm = require('pure-esm-package'); // 에러!

// ✅ 동적 import 사용
async function main() {
  const { default: chalk } = await import('chalk');
  console.log(chalk.green('Hello!'));
}

// tsconfig.json
{
  "compilerOptions": {
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "target": "ES2022"
  }
}

// TypeScript ESM에서 반드시 확장자 포함
import { helper } from './utils/helper.js'; // .ts가 아닌 .js

# tsup으로 CJS + ESM 동시 빌드
tsup src/index.ts --format cjs,esm --dts