소스 맵

{
  "compilerOptions": {
    "sourceMap": true, // 소스 맵 생성
    "inlineSourceMap": false, // 별도 파일로 생성
    "inlineSources": false, // 원본 소스 포함 안 함
    "outDir": "dist"
  }
}

// ✅ 권장: 별도 파일 (개발/프로덕션 모두)
{
  "compilerOptions": {
    "sourceMap": true,
    "inlineSourceMap": false
  }
}

// ❌ 인라인 (번들 크기 증가)
{
  "compilerOptions": {
    "sourceMap": false,
    "inlineSourceMap": true  // .js 파일 내 포함
  }
}

Error: User not found
    at UserModelClass.findById (dist/models/user.model.js:45:15)
    at processUser (dist/services/user.service.js:12:28)
    at async main (dist/index.js:8:20)

Error: User not found
    at UserModelClass.findById (src/models/user.model.ts:32:11)
    at processUser (src/services/user.service.ts:8:24)
    at async main (src/index.ts:5:15)

# Node.js 12.12.0 이상
node --enable-source-maps dist/index.js

{
  "scripts": {
    "start": "node --enable-source-maps dist/index.js",
    "dev": "node --enable-source-maps --watch dist/index.js"
  }
}

# tsx는 자동으로 소스 맵 지원
pnpm dev

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Sonamu Dev Server",
      "runtimeExecutable": "pnpm",
      "runtimeArgs": ["dev"],
      "cwd": "${workspaceFolder}",
      "console": "integratedTerminal",
      "sourceMaps": true,
      "outFiles": ["${workspaceFolder}/dist/**/*.js"],
      "skipFiles": ["<node_internals>/**", "node_modules/**"]
    },
    {
      "type": "node",
      "request": "launch",
      "name": "Run Test",
      "runtimeExecutable": "pnpm",
      "runtimeArgs": ["test", "${file}"],
      "cwd": "${workspaceFolder}",
      "console": "integratedTerminal",
      "sourceMaps": true
    }
  ]
}

// 개발 환경
{
  "compilerOptions": {
    "sourceMap": true,
    "inlineSources": false // 원본 소스 포함 안 함
  }
}

# 소스 맵 파일 제외
dist/
├── index.js           ✅ 배포
├── index.js.map       ❌ 제외 (또는 별도 저장)

# Sentry CLI 예시
sentry-cli releases files VERSION upload-sourcemaps ./dist

# tsconfig.json 확인
cat tsconfig.json | grep sourceMap

# 빌드 후 .map 파일 확인
ls -la dist/**/*.map

{
  "compilerOptions": {
    "sourceMap": true // 명시적으로 활성화
  }
}

# --enable-source-maps 플래그 추가
node --enable-source-maps dist/index.js

# 또는 tsx 사용 (자동 지원)
pnpm tsx dist/index.js

// launch.json
{
  "sourceMaps": true, // 활성화 확인
  "outFiles": [
    "${workspaceFolder}/dist/**/*.js" // 올바른 경로
  ]
}

# 클린 빌드
rm -rf dist/
pnpm build

# 또는 개발 모드 재시작
pnpm dev

# 소스 맵 파일 확인
cat dist/index.js.map | jq .sources

# 출력 예시:
# [
#   "../src/index.ts",
#   "../src/models/user.model.ts"
# ]

import { SourceMapConsumer } from "source-map";
import fs from "fs";

const rawSourceMap = JSON.parse(fs.readFileSync("dist/index.js.map", "utf-8"));

SourceMapConsumer.with(rawSourceMap, null, (consumer) => {
  // 컴파일된 위치 -> 원본 위치
  const pos = consumer.originalPositionFor({
    line: 45,
    column: 15,
  });

  console.log(pos);
  // {
  //   source: '../src/index.ts',
  //   line: 32,
  //   column: 11,
  //   name: 'findUser'
  // }
});

// vite.config.ts
export default defineConfig({
  build: {
    sourcemap: true, // 프로덕션 빌드에도 포함
  },
});

{
  "compilerOptions": {
    "sourceMap": true // 개발 시 필수
  }
}

# 소스 맵은 빌드 시 생성
dist/**/*.map

# 프로덕션 소스 맵은 별도 관리
production-sourcemaps/

// 환경별 tsconfig
// tsconfig.prod.json
{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "sourceMap": false  // 프로덕션에서는 비활성화
  }
}

// package.json
{
  "scripts": {
    "build:dev": "tsc",
    "build:prod": "tsc -p tsconfig.prod.json"
  }
}

// 에러 발생 시 원본 위치 매핑
import { SourceMapConsumer } from "source-map";

async function mapError(error: Error) {
  // 스택 트레이스 파싱
  const match = error.stack?.match(/dist\/(.+):(\d+):(\d+)/);
  if (!match) return error;

  const [, file, line, column] = match;
  const mapFile = `sourcemaps/${file}.map`;

  // 소스 맵으로 원본 위치 찾기
  const rawMap = JSON.parse(fs.readFileSync(mapFile, "utf-8"));
  const consumer = await new SourceMapConsumer(rawMap);

  const original = consumer.originalPositionFor({
    line: parseInt(line),
    column: parseInt(column),
  });

  return {
    ...error,
    originalFile: original.source,
    originalLine: original.line,
    originalColumn: original.column,
  };
}

pnpm add source-map-support

// index.ts 상단
import "source-map-support/register";

import { installSourceMapSupport } from "@esbuild-kit/core-utils";
installSourceMapSupport();