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

When compiled JS is relocated (e.g., postbuild copies dist/ to a
deployment directory), source map relative paths resolve to wrong
absolute paths. The file tag would contain bogus paths like
/.amplify-hosting/compute/src/routes/admin.ts instead of the real
project path.

This extracts the src/-relative portion from the stack trace path
and reconstructs it using the real project root found via tsconfig.json.

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

Author: veksen

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

@@ -1,6 +1,7 @@
 import { alreadyHasComment, serializeTags } from "./sqlcommenter.js";
 import { als } from "./als.js";
 import { pushW3CTraceContext } from "./tracing.js";
+import { resolveFilePath } from "./path.js";
 
 const LIBRARY_NAME = "sqlcommenter-drizzle";
 
@@ -54,7 +55,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-drizzle/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-drizzle/test/path.spec.ts

@@ -2,7 +2,11 @@ import { test } from "node:test";
 import assert from "node:assert";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
-import { findProjectRoot, _resetProjectRootCache } from "../src/path.js";
+import {
+  findProjectRoot,
+  resolveFilePath,
+  _resetProjectRootCache,
+} from "../src/path.js";
 
 test("findProjectRoot", async (t) => {
   t.afterEach(() => {
@@ -23,3 +27,47 @@ 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");
+  });
+});