feat(mikroorm): normalize source-map-resolved file paths

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: veksen

nodejs/sqlcommenter-nodejs/packages/sqlcommenter-mikroorm/src/index.ts

@@ -1,6 +1,7 @@
 import { alreadyHasTrailingComment, serializeTags, type Tag } from "./sqlcommenter.js";
 import { als } from "./als.js";
 import { pushW3CTraceContext } from "./tracing.js";
+import { resolveFilePath } from "./path.js";
 
 const LIBRARY_NAME = "sqlcommenter-mikroorm";
 
@@ -42,7 +43,7 @@ export function traceCaller(): string | undefined {
   }
   const match = methodCaller.match(filepathRegex);
   if (match) {
-    return match[1];
+    return resolveFilePath(match[1]);
   }
 }
 

nodejs/sqlcommenter-nodejs/packages/sqlcommenter-mikroorm/src/path.ts

@@ -28,6 +28,35 @@ export function findProjectRoot(): string {
   return projectRoot;
 }
 
+/**
+ * Resolves a file path from a stack trace to a correct absolute path.
+ *
+ * When compiled JS is relocated (e.g., postbuild copies `dist/` to a deployment directory),
+ * source-map-resolved paths become incorrect because the relative `sources` entries in
+ * `.map` files resolve against the new location instead of the original project.
+ *
+ * This extracts the `src/`-relative portion and reconstructs the path using the real
+ * project root.
+ *
+ * @param raw - A stack trace entry like "/wrong/path/src/routes/admin.ts:12:15"
+ * @returns The resolved path like "/project/root/src/routes/admin.ts:12:15"
+ */
+export function resolveFilePath(raw: string): string {
+  // Split off :line:column suffix
+  const match = raw.match(/^(.*?):(\d+:\d+)$/);
+  if (!match) {
+    return raw;
+  }
+  const [, filePath, lineCol] = match;
+  const srcIdx = filePath.indexOf("src/");
+  if (srcIdx < 0) {
+    return raw;
+  }
+  const projectRoot = findProjectRoot();
+  const relativePath = filePath.substring(srcIdx);
+  return `${projectRoot}/${relativePath}:${lineCol}`;
+}
+
 /** @internal Exposed for testing only */
 export function _resetProjectRootCache() {
   cachedProjectRoot = undefined;

nodejs/sqlcommenter-nodejs/packages/sqlcommenter-mikroorm/test/path.spec.ts

@@ -4,6 +4,7 @@ import { existsSync } from "node:fs";
 import { join } from "node:path";
 import {
   findProjectRoot,
+  resolveFilePath,
   _resetProjectRootCache,
 } from "../src/path.js";
 
@@ -26,3 +27,44 @@ test("findProjectRoot", async (t) => {
     assert.strictEqual(first, second);
   });
 });
+
+test("resolveFilePath", async (t) => {
+  t.afterEach(() => {
+    _resetProjectRootCache();
+  });
+
+  await t.test("resolves path with src/ to project root", () => {
+    const projectRoot = findProjectRoot();
+    const result = resolveFilePath(
+      "/wrong/deploy/dir/src/routes/admin.ts:12:15",
+    );
+    assert.strictEqual(result, `${projectRoot}/src/routes/admin.ts:12:15`);
+  });
+
+  await t.test("leaves path without src/ unchanged", () => {
+    const result = resolveFilePath("/some/other/path/routes/admin.ts:5:10");
+    assert.strictEqual(result, "/some/other/path/routes/admin.ts:5:10");
+  });
+
+  await t.test("preserves line:column suffix", () => {
+    const projectRoot = findProjectRoot();
+    const result = resolveFilePath("/bad/path/src/index.ts:99:3");
+    assert.strictEqual(result, `${projectRoot}/src/index.ts:99:3`);
+  });
+
+  await t.test("uses first src/ occurrence", () => {
+    const projectRoot = findProjectRoot();
+    const result = resolveFilePath(
+      "/deploy/src/nested/src/routes/admin.ts:1:1",
+    );
+    assert.strictEqual(
+      result,
+      `${projectRoot}/src/nested/src/routes/admin.ts:1:1`,
+    );
+  });
+
+  await t.test("returns raw string if no line:column suffix", () => {
+    const result = resolveFilePath("/some/path/src/file.ts");
+    assert.strictEqual(result, "/some/path/src/file.ts");
+  });
+});