This file is a merged representation of a subset of the codebase, containing specifically included files, combined into a single document by Repomix.
<file_summary> This section contains a summary of this file.
This file contains a packed representation of a subset of the repository's contents that is considered the most important context. It is designed to be easily consumable by AI systems for analysis, code review, or other automated processes.<file_format> The content is organized as follows:
- This summary section
- Repository information
- Directory structure
- Repository files (if enabled)
- Multiple file entries, each consisting of:
- File path as an attribute
- Full contents of the file </file_format>
<usage_guidelines>
- This file should be treated as read-only. Any changes should be made to the original repository files, not this packed version.
- When processing this file, use the file path to distinguish between different files in the repository.
- Be aware that this file may contain sensitive information. Handle it with the same level of security as you would the original repository. </usage_guidelines>
</file_summary>
<directory_structure> src/ core/ sourcemap-formatter.test.ts sourcemap-formatter.ts test/ ava.config.mjs package.json tsconfig.json </directory_structure>
This section contains the contents of the repository's files. export default { workerThreads: false, extensions: { ts: "module", }, nodeArguments: ["--import=tsx"], environmentVariables: { KIT_TEST: "true", }, verbose: true, files: ["src/**/*.test.ts", "test/**/*.test.ts"], } import ava from 'ava' import { SourcemapErrorFormatter } from './sourcemap-formatter.js' import os from 'os' import { fileURLToPath } from 'url'const __filename = fileURLToPath(import.meta.url)
ava('formatError should parse basic error stack', (t) => {
const error = new Error('Test error')
error.stack = Error: Test error at testFunction (/path/to/file.js:10:5) at Object.<anonymous> (/path/to/file.js:20:1) at Module._compile (node:internal/modules/cjs/loader:1000:10)
const result = SourcemapErrorFormatter.formatError(error)
t.is(result.message, 'Test error') t.is(result.name, 'Error') t.is(result.frames.length, 3) t.is(result.frames[0].file, os.platform() === 'win32' ? '\path\to\file.js' : '/path/to/file.js') t.is(result.frames[0].line, 10) t.is(result.frames[0].column, 5) t.is(result.frames[0].function, 'testFunction') })
ava('formatError should handle file:// URLs', (t) => {
const error = new Error('Test error')
error.stack = Error: Test error at file:///Users/test/script.js:5:10 at file://C:/Users/test/script.js:10:20
const result = SourcemapErrorFormatter.formatError(error)
t.is(result.frames.length, 2)
// First frame - Unix style if (os.platform() === 'win32') { t.is(result.frames[0].file, '\Users\test\script.js') } else { t.is(result.frames[0].file, '/Users/test/script.js') }
// Second frame - Windows style if (os.platform() === 'win32') { t.is(result.frames[1].file, 'C:\Users\test\script.js') } else { t.is(result.frames[1].file, 'C:/Users/test/script.js') } })
ava('formatError should remove query parameters', (t) => {
const error = new Error('Test error')
error.stack = Error: Test error at file:///path/to/file.js?uuid=12345:10:5
const result = SourcemapErrorFormatter.formatError(error)
t.is(result.frames[0].file, os.platform() === 'win32' ? '\path\to\file.js' : '/path/to/file.js') t.is(result.frames[0].line, 10) t.is(result.frames[0].column, 5) })
ava('formatError should skip node_modules by default', (t) => {
const error = new Error('Test error')
error.stack = Error: Test error at userFunction (/app/src/index.js:10:5) at moduleFunction (/app/node_modules/lodash/index.js:100:10) at internal/process (/internal/process/task_queues.js:95:5) at anotherUserFunction (/app/src/utils.js:20:15)
const result = SourcemapErrorFormatter.formatError(error) const formatted = result.stack.split('\n')
// Should include error message and two user functions only t.is(formatted.length, 3) t.true(formatted[1].includes('userFunction')) t.true(formatted[2].includes('anotherUserFunction')) t.false(result.stack.includes('node_modules')) t.false(result.stack.includes('internal/process')) })
ava('formatError should include all frames with KIT_ERROR_VERBOSE', (t) => { const originalVerbose = process.env.KIT_ERROR_VERBOSE process.env.KIT_ERROR_VERBOSE = 'true'
const error = new Error('Test error')
error.stack = Error: Test error at userFunction (/app/src/index.js:10:5) at moduleFunction (/app/node_modules/lodash/index.js:100:10)
const result = SourcemapErrorFormatter.formatError(error)
t.true(result.stack.includes('node_modules'))
// Restore original value if (originalVerbose === undefined) { delete process.env.KIT_ERROR_VERBOSE } else { process.env.KIT_ERROR_VERBOSE = originalVerbose } })
ava('extractErrorLocation should return first relevant frame', (t) => {
const error = new Error('Test error')
error.stack = Error: Test error at internal/modules (/node:internal/modules/cjs/loader:1000:10) at userFunction (${__filename}:10:5) at anotherFunction (/nonexistent/file.js:20:15)
const location = SourcemapErrorFormatter.extractErrorLocation(error)
t.not(location, null) t.is(location?.file, __filename) t.is(location?.line, 10) t.is(location?.column, 5) })
ava('resolveFilePath should handle various path formats', (t) => { // Test absolute path const resolved = SourcemapErrorFormatter.resolveFilePath(__filename) t.is(resolved, __filename)
// Test file:// URL
const fileUrl = file://${__filename}
const resolvedUrl = SourcemapErrorFormatter.resolveFilePath(fileUrl)
t.is(resolvedUrl, __filename)
// Test non-existent file const nonExistent = SourcemapErrorFormatter.resolveFilePath('/nonexistent/file.js') t.is(nonExistent, null) })
ava('resolveFilePath should try TypeScript extensions', (t) => { // This test assumes the test file exists as .ts const jsPath = __filename.replace(/.ts$/, '.js') const resolved = SourcemapErrorFormatter.resolveFilePath(jsPath)
// Should find the .ts version t.is(resolved, __filename) })
import { existsSync } from 'fs' import { isAbsolute, normalize, resolve } from 'path' import os from 'os'export interface StackFrame { file: string line: number column: number function?: string isNative?: boolean isEval?: boolean isConstructor?: boolean }
export interface FormattedError { message: string name: string stack: string frames: StackFrame[] originalStack?: string }
export class SourcemapErrorFormatter { private static readonly STACK_FRAME_REGEX = /^\s*at\s+(?:(.+?)\s+()?(.+?):(\d+):(\d+))?$/ private static readonly WINDOWS_PATH_REGEX = /^([a-zA-Z]:\|\\)/ private static readonly FILE_URL_REGEX = /^file:///
/**
- Formats an error with enhanced stack trace information */ static formatError(error: Error): FormattedError { const frames = this.parseStackTrace(error.stack || '')
return {
message: error.message,
name: error.name,
stack: this.formatStackTrace(frames, error),
frames,
originalStack: error.stack
}
}
/**
- Parses a stack trace string into structured frames */ private static parseStackTrace(stack: string): StackFrame[] { const lines = stack.split('\n') const frames: StackFrame[] = []
for (const line of lines) {
const match = line.match(this.STACK_FRAME_REGEX)
if (match) {
const [, functionName, fileRaw, lineStr, columnStr] = match
// Clean up file path
let file = fileRaw
.replace(this.FILE_URL_REGEX, '')
.replace(/\?.*$/, '') // Remove query parameters
// Handle Windows paths
if (os.platform() === 'win32' && file.startsWith('/')) {
// Convert /C:/path to C:/path on Windows
file = file.substring(1)
}
// Ensure absolute paths remain absolute after normalization
const isAbsolutePath = file.startsWith('/') || this.WINDOWS_PATH_REGEX.test(file)
file = normalize(file)
// On Unix, normalize may strip leading slash, restore it if needed
if (isAbsolutePath && !file.startsWith('/') && os.platform() !== 'win32') {
file = '/' + file
}
frames.push({
file,
line: parseInt(lineStr, 10),
column: parseInt(columnStr, 10),
function: functionName || '<anonymous>',
isNative: line.includes('native'),
isEval: line.includes('eval'),
isConstructor: line.includes('new ')
})
}
}
return frames
}
/**
- Formats stack frames back into a readable stack trace
*/
private static formatStackTrace(frames: StackFrame[], error: Error): string {
const lines = [
${error.name}: ${error.message}]
for (const frame of frames) {
// Skip node_modules and internal frames unless in verbose mode
if (!process.env.KIT_ERROR_VERBOSE && this.shouldSkipFrame(frame)) {
continue
}
const location = `${frame.file}:${frame.line}:${frame.column}`
const functionPart = frame.function !== '<anonymous>'
? `${frame.function} (${location})`
: location
lines.push(` at ${functionPart}`)
}
return lines.join('\n')
}
/**
- Determines if a frame should be skipped in the output */ private static shouldSkipFrame(frame: StackFrame): boolean { const skipPatterns = [ /node_modules/, /internal/modules/, /internal/process/, /internal/timers/ ]
return skipPatterns.some(pattern => pattern.test(frame.file))
}
/**
- Extracts error location for the error prompt */ static extractErrorLocation(error: Error): { file: string; line: number; column: number } | null { const formatted = this.formatError(error)
// Find first non-internal frame
const relevantFrame = formatted.frames.find(frame =>
!this.shouldSkipFrame(frame) &&
existsSync(frame.file)
)
if (relevantFrame) {
return {
file: relevantFrame.file,
line: relevantFrame.line,
column: relevantFrame.column
}
}
return null
}
/**
-
Validates and resolves a file path */ static resolveFilePath(filePath: string, basePath?: string): string | null { try { // Remove file:// protocol if present let cleanPath = filePath.replace(this.FILE_URL_REGEX, '')
// Handle Windows paths if (os.platform() === 'win32' && cleanPath.startsWith('/')) { cleanPath = cleanPath.substring(1) }
// Resolve relative paths const isAbsolutePath = cleanPath.startsWith('/') || this.WINDOWS_PATH_REGEX.test(cleanPath) let resolvedPath = isAbsolute(cleanPath) ? normalize(cleanPath) : resolve(basePath || process.cwd(), cleanPath)
// On Unix, normalize may strip leading slash, restore it if needed
if (isAbsolutePath && !resolvedPath.startsWith('/') && os.platform() !== 'win32') { resolvedPath = '/' + resolvedPath }// Check if file exists if (existsSync(resolvedPath)) { return resolvedPath }
// Try with .ts extension if .js doesn't exist const tsPath = resolvedPath.replace(/.js$/, '.ts') if (existsSync(tsPath)) { return tsPath }
// Try with .tsx extension const tsxPath = resolvedPath.replace(/.js$/, '.tsx') if (existsSync(tsxPath)) { return tsxPath }
return null } catch (error) { return null } } }