Source Maps

{
  "compilerOptions": {
    "sourceMap": true, // Generate source maps
    "inlineSourceMap": false, // Generate as separate files
    "inlineSources": false, // Don't include original sources
    "outDir": "dist"
  }
}

// Recommended: Separate files (for both development and production)
{
  "compilerOptions": {
    "sourceMap": true,
    "inlineSourceMap": false
  }
}

// Inline (increases bundle size)
{
  "compilerOptions": {
    "sourceMap": false,
    "inlineSourceMap": true  // Included in .js files
  }
}

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 or later
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 automatically supports source maps
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
    }
  ]
}

// Development environment
{
  "compilerOptions": {
    "sourceMap": true,
    "inlineSources": false // Don't include original sources
  }
}

# Exclude source map files
dist/
├── index.js           ✅ Deploy
├── index.js.map       ❌ Exclude (or store separately)

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

# Check tsconfig.json
cat tsconfig.json | grep sourceMap

# Check for .map files after build
ls -la dist/**/*.map

{
  "compilerOptions": {
    "sourceMap": true // Explicitly enable
  }
}

# Add --enable-source-maps flag
node --enable-source-maps dist/index.js

# Or use tsx (automatic support)
pnpm tsx dist/index.js

// launch.json
{
  "sourceMaps": true, // Verify enabled
  "outFiles": [
    "${workspaceFolder}/dist/**/*.js" // Correct path
  ]
}

# Clean build
rm -rf dist/
pnpm build

# Or restart development mode
pnpm dev

# Check source map file
cat dist/index.js.map | jq .sources

# Example output:
# [
#   "../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) => {
  // Compiled position -> Original position
  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, // Include in production builds
  },
});

{
  "compilerOptions": {
    "sourceMap": true // Essential for development
  }
}

# Source maps are generated during build
dist/**/*.map

# Manage production source maps separately
production-sourcemaps/

// Environment-specific tsconfig
// tsconfig.prod.json
{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "sourceMap": false  // Disable in production
  }
}

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

// Map original location when error occurs
import { SourceMapConsumer } from "source-map";

async function mapError(error: Error) {
  // Parse stack trace
  const match = error.stack?.match(/dist\/(.+):(\d+):(\d+)/);
  if (!match) return error;

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

  // Find original location with source 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

// Top of index.ts
import "source-map-support/register";

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