@backtrack-js/browser 0.4.2 → 0.5.1

package/bin/symbolize.cjs

@@ -7,9 +7,77 @@ const {
   sourceContentFor
 } = require('@jridgewell/trace-mapping');
 
-// ponytail: parser inicial cobre stacks V8; adicionar Firefox/Safari quando fixtures reais exigirem.
 const FRAME_WITH_FUNCTION = /^\s*at\s+(.+?)\s+\((.+):(\d+):(\d+)\)\s*$/;
+const FRAME_WITHOUT_FUNCTION_PARENS = /^\s*at\s+\((.+):(\d+):(\d+)\)\s*$/;
 const FRAME_WITHOUT_FUNCTION = /^\s*at\s+(.+):(\d+):(\d+)\s*$/;
+const FRAME_FIREFOX_SAFARI = /^\s*(.*?)\s*@\s*(.+):(\d+):(\d+)\s*$/;
+
+/**
+ * Analisa uma linha de stack trace (V8, Firefox ou Safari) e extrai
+ * nome da função, arquivo gerado, linha e coluna.
+ * @param {string} line
+ * @returns {{ functionName?: string, generatedFile: string, generatedLine: number, generatedColumn: number } | undefined}
+ */
+function parseStackFrame(line) {
+  if (!line || typeof line !== 'string') {
+    return undefined;
+  }
+
+  let functionName = undefined;
+  let generatedFile = undefined;
+  let lineStr = undefined;
+  let colStr = undefined;
+
+  const withFnMatch = line.match(FRAME_WITH_FUNCTION);
+  if (withFnMatch) {
+    functionName = withFnMatch[1].trim();
+    generatedFile = withFnMatch[2].trim();
+    lineStr = withFnMatch[3];
+    colStr = withFnMatch[4];
+  } else {
+    const withoutFnParensMatch = line.match(FRAME_WITHOUT_FUNCTION_PARENS);
+    if (withoutFnParensMatch) {
+      generatedFile = withoutFnParensMatch[1].trim();
+      lineStr = withoutFnParensMatch[2];
+      colStr = withoutFnParensMatch[3];
+    } else {
+      const withoutFnMatch = line.match(FRAME_WITHOUT_FUNCTION);
+      if (withoutFnMatch) {
+        generatedFile = withoutFnMatch[1].trim();
+        lineStr = withoutFnMatch[2];
+        colStr = withoutFnMatch[3];
+      } else {
+        const ffSafariMatch = line.match(FRAME_FIREFOX_SAFARI);
+        if (ffSafariMatch) {
+          const fn = ffSafariMatch[1].trim();
+          functionName = fn.length > 0 ? fn : undefined;
+          generatedFile = ffSafariMatch[2].trim();
+          lineStr = ffSafariMatch[3];
+          colStr = ffSafariMatch[4];
+        }
+      }
+    }
+  }
+
+  if (!generatedFile || !lineStr || !colStr) {
+    return undefined;
+  }
+
+  const generatedLine = parseInt(lineStr, 10);
+  const generatedColumn = parseInt(colStr, 10);
+
+  if (!Number.isInteger(generatedLine) || generatedLine <= 0 ||
+      !Number.isInteger(generatedColumn) || generatedColumn <= 0) {
+    return undefined;
+  }
+
+  return {
+    functionName,
+    generatedFile,
+    generatedLine,
+    generatedColumn
+  };
+}
 
 /**
  * Remove query string, hash, diretórios e decodifica URL para obter o nome do bundle.
@@ -220,45 +288,14 @@ function symbolicateStack(stack, options) {
   const traceMapCache = new Map();
 
   const lines = stack.split(/\r?\n/);
-  // Ignora a primeira linha contendo a mensagem do erro (se não for um frame)
-  const candidateLines = lines.length > 1 && !lines[0].trim().startsWith('at ')
-    ? lines.slice(1)
-    : lines;
-
-  for (const line of candidateLines) {
-    let parsedFunctionName = undefined;
-    let generatedFile = undefined;
-    let lineStr = undefined;
-    let colStr = undefined;
-
-    const withFnMatch = line.match(FRAME_WITH_FUNCTION);
-    if (withFnMatch) {
-      parsedFunctionName = withFnMatch[1];
-      generatedFile = withFnMatch[2];
-      lineStr = withFnMatch[3];
-      colStr = withFnMatch[4];
-    } else {
-      const withoutFnMatch = line.match(FRAME_WITHOUT_FUNCTION);
-      if (withoutFnMatch) {
-        generatedFile = withoutFnMatch[1];
-        lineStr = withoutFnMatch[2];
-        colStr = withoutFnMatch[3];
-      }
-    }
 
-    if (!generatedFile || !lineStr || !colStr) {
-      // Ignora linhas que não correspondam a um frame
+  for (const line of lines) {
+    const parsed = parseStackFrame(line);
+    if (!parsed) {
       continue;
     }
 
-    const generatedLine = parseInt(lineStr, 10);
-    const generatedColumn = parseInt(colStr, 10);
-
-    // Valida que linha e coluna são inteiros positivos
-    if (!Number.isInteger(generatedLine) || generatedLine <= 0 ||
-        !Number.isInteger(generatedColumn) || generatedColumn <= 0) {
-      continue;
-    }
+    const { functionName, generatedFile, generatedLine, generatedColumn } = parsed;
 
     const bundleName = extractBundleName(generatedFile);
     const matchingMaps = bundleMapFiles.get(bundleName);
@@ -267,7 +304,7 @@ function symbolicateStack(stack, options) {
       generatedFile,
       generatedLine,
       generatedColumn,
-      ...(parsedFunctionName ? { functionName: parsedFunctionName } : {})
+      ...(functionName ? { functionName } : {})
     };
 
     if (!matchingMaps || matchingMaps.length === 0) {
@@ -284,13 +321,17 @@ function symbolicateStack(stack, options) {
     }
 
     const mapPath = matchingMaps[0];
-    let traceMap = traceMapCache.get(mapPath);
-    if (!traceMap) {
+    let cached = traceMapCache.get(mapPath);
+    if (!cached) {
       try {
         const rawContent = fs.readFileSync(mapPath, 'utf-8');
         const parsedJson = JSON.parse(rawContent);
-        traceMap = new TraceMap(parsedJson);
-        traceMapCache.set(mapPath, traceMap);
+        const declaredBundle = parsedJson.file && typeof parsedJson.file === 'string'
+          ? extractBundleName(parsedJson.file)
+          : null;
+        const traceMap = new TraceMap(parsedJson);
+        cached = { traceMap, declaredBundle };
+        traceMapCache.set(mapPath, cached);
       } catch (err) {
         result.frames.push(unresolvedFrame);
         result.unresolvedCount++;
@@ -299,7 +340,19 @@ function symbolicateStack(stack, options) {
       }
     }
 
-    // A coluna da stack do navegador (V8) é 1-based, enquanto o TraceMap espera coluna 0-based
+    if (cached.declaredBundle && cached.declaredBundle !== bundleName) {
+      result.frames.push(unresolvedFrame);
+      result.unresolvedCount++;
+      const mapName = path.basename(mapPath);
+      result.warnings.push(
+        `Source map ${mapName} declara o bundle ${cached.declaredBundle}, mas o frame pertence a ${bundleName}.`
+      );
+      continue;
+    }
+
+    const traceMap = cached.traceMap;
+
+    // A coluna da stack do navegador (V8/Firefox/Safari) é 1-based, enquanto o TraceMap espera coluna 0-based
     const lookupColumn = generatedColumn > 0 ? generatedColumn - 1 : 0;
     let original = null;
     try {
@@ -326,7 +379,7 @@ function symbolicateStack(stack, options) {
       sourceFile: normalizeSourceFile(original.source),
       sourceLine: original.line,
       sourceColumn: original.column,
-      functionName: original.name ?? parsedFunctionName
+      ...((original.name ?? functionName) ? { functionName: original.name ?? functionName } : {})
     };
 
     const { context, warning } = extractContext(traceMap, original.source, original.line, contextLines);
@@ -388,6 +441,7 @@ Argumentos obrigatórios:
   --sourcemaps <diretório>       Diretório contendo os arquivos .map
 
 Opções adicionais:
+  --release <versão>            Versão da release para validação de compatibilidade
   --output <arquivo>            Caminho do arquivo de saída (padrão: <incidente>.symbolicated.ffr.json)
   --context-lines <número>      Quantidade de linhas de contexto antes e depois do erro (0-10, padrão: 3)
   -h, --help                    Mostra esta mensagem de ajuda
@@ -422,6 +476,7 @@ async function run(args = []) {
   let incidentPath = null;
   let sourcemapsDir = null;
   let outputPath = null;
+  let releaseArg = null;
   let contextLines = 3;
 
   for (let i = 0; i < args.length; i++) {
@@ -434,6 +489,13 @@ async function run(args = []) {
       sourcemapsDir = args[++i];
     } else if (arg === '--output') {
       outputPath = args[++i];
+    } else if (arg === '--release') {
+      releaseArg = args[++i];
+      if (!releaseArg || releaseArg.startsWith('-')) {
+        console.error('[Backtrack] Erro: Opção --release exige uma versão.');
+        process.exitCode = 1;
+        return 1;
+      }
     } else if (arg === '--context-lines') {
       const val = parseInt(args[++i], 10);
       if (!Number.isNaN(val)) {
@@ -546,37 +608,112 @@ async function run(args = []) {
     }
   }
 
-  let errorEventsCount = 0;
-  let totalResolvedFrames = 0;
-  let totalUnresolvedFrames = 0;
   const allWarnings = [];
 
+  const artifactRelease = artifact.context && typeof artifact.context.release === 'string'
+    ? artifact.context.release
+    : undefined;
+
+  let releaseStatusMsg = null;
+
+  if (releaseArg) {
+    if (artifactRelease) {
+      if (artifactRelease !== releaseArg) {
+        console.error(
+          `[Backtrack] Erro: Release informada (${releaseArg}) é incompatível com a release do incidente (${artifactRelease}).`
+        );
+        process.exitCode = 1;
+        return 1;
+      } else {
+        releaseStatusMsg = `Release: ${releaseArg} (release informada compatível)`;
+      }
+    } else {
+      allWarnings.push('A versão da release não pôde ser confirmada.');
+    }
+  } else if (artifactRelease) {
+    releaseStatusMsg = `Release do incidente: ${artifactRelease}`;
+    allWarnings.push(`Os source maps devem pertencer exatamente à release ${artifactRelease}.`);
+  }
+
+  let errorEventsCount = 0;
+  let exceptionResolvedFrames = 0;
+  let exceptionUnresolvedFrames = 0;
+  let reactResolvedFrames = 0;
+  let reactUnresolvedFrames = 0;
+
   const newTimeline = artifact.timeline.map((event) => {
-    if (event.type !== 'error' || !event.stack || typeof event.stack !== 'string') {
+    if (event.type !== 'error') {
+      return event;
+    }
+
+    const hasStack = typeof event.stack === 'string' && event.stack.trim().length > 0;
+    const hasComponentStack = typeof event.componentStack === 'string' && event.componentStack.trim().length > 0;
+
+    if (!hasStack && !hasComponentStack) {
       return event;
     }
 
     errorEventsCount++;
-    const result = symbolicateStack(event.stack, {
-      sourceMapsDirectory: sourcemapsDir,
-      contextLines
-    });
-
-    totalResolvedFrames += result.resolvedCount;
-    totalUnresolvedFrames += result.unresolvedCount;
-    if (result.warnings && result.warnings.length > 0) {
-      allWarnings.push(...result.warnings);
+
+    let stackFrames = [];
+    let stackResolvedCount = 0;
+    if (hasStack) {
+      const stackResult = symbolicateStack(event.stack, {
+        sourceMapsDirectory: sourcemapsDir,
+        contextLines
+      });
+      stackResolvedCount = stackResult.resolvedCount;
+      exceptionResolvedFrames += stackResult.resolvedCount;
+      exceptionUnresolvedFrames += stackResult.unresolvedCount;
+      if (stackResult.warnings && stackResult.warnings.length > 0) {
+        allWarnings.push(...stackResult.warnings);
+      }
+      stackFrames = stackResult.frames;
     }
 
+    let componentFrames = [];
+    let componentResolvedCount = 0;
+    if (hasComponentStack) {
+      const componentResult = symbolicateStack(event.componentStack, {
+        sourceMapsDirectory: sourcemapsDir,
+        contextLines
+      });
+      componentResolvedCount = componentResult.resolvedCount;
+      reactResolvedFrames += componentResult.resolvedCount;
+      reactUnresolvedFrames += componentResult.unresolvedCount;
+      if (componentResult.warnings && componentResult.warnings.length > 0) {
+        allWarnings.push(...componentResult.warnings);
+      }
+      componentFrames = componentResult.frames;
+    }
+
+    // Preserva stack e componentStack exatamente como recebidas.
+    // Não remove resolvedStack ou resolvedComponentStack existente se a nova execução não resolver nada.
+    const resolvedStack = stackFrames.length > 0 &&
+      (stackResolvedCount > 0 || !event.resolvedStack?.length)
+      ? stackFrames
+      : event.resolvedStack;
+
+    const resolvedComponentStack = componentFrames.length > 0 &&
+      (componentResolvedCount > 0 || !event.resolvedComponentStack?.length)
+      ? componentFrames
+      : event.resolvedComponentStack;
+
     return {
       ...event,
-      ...(result.frames.length > 0
-        ? { resolvedStack: result.frames }
+      ...(resolvedStack && resolvedStack.length > 0
+        ? { resolvedStack }
+        : {}),
+      ...(resolvedComponentStack && resolvedComponentStack.length > 0
+        ? { resolvedComponentStack }
         : {})
     };
   });
 
-  if (totalResolvedFrames === 0 && totalUnresolvedFrames === 0) {
+  const totalResolved = exceptionResolvedFrames + reactResolvedFrames;
+  const totalUnresolved = exceptionUnresolvedFrames + reactUnresolvedFrames;
+
+  if (totalResolved === 0 && totalUnresolved === 0) {
     console.log('[Backtrack] Nenhuma stack compatível foi encontrada.');
     process.exitCode = 0;
     return 0;
@@ -584,16 +721,21 @@ async function run(args = []) {
 
   const uniqueWarnings = Array.from(new Set(allWarnings));
 
-  if (totalUnresolvedFrames > 0) {
+  if (totalUnresolved > 0) {
     console.log('[Backtrack] Symbolication parcial.\n');
   } else {
     console.log('[Backtrack] Symbolication concluída.\n');
   }
 
   console.log(`Incidente: ${artifact.incident.id}`);
+  if (releaseStatusMsg) {
+    console.log(releaseStatusMsg);
+  }
   console.log(`Erros encontrados: ${errorEventsCount}`);
-  console.log(`Frames resolvidos: ${totalResolvedFrames}`);
-  console.log(`Frames não resolvidos: ${totalUnresolvedFrames}`);
+  console.log(`Frames da exceção resolvidos: ${exceptionResolvedFrames}`);
+  console.log(`Frames da exceção não resolvidos: ${exceptionUnresolvedFrames}`);
+  console.log(`Frames React resolvidos: ${reactResolvedFrames}`);
+  console.log(`Frames React não resolvidos: ${reactUnresolvedFrames}`);
   console.log(`Saída: ${resolvedOutput}`);
 
   if (uniqueWarnings.length > 0) {
@@ -642,6 +784,7 @@ if (require.main === module) {
 }
 
 module.exports = {
+  parseStackFrame,
   symbolicateStack,
   FRAME_WITH_FUNCTION,
   FRAME_WITHOUT_FUNCTION,

package/dev-server/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@backtrack-js/browser/dev-server",
+  "main": "../dist/dev-server.cjs",
+  "module": "../dist/dev-server.js",
+  "types": "../dist/dev-server/index.d.ts"
+}

package/dist/dev-server/index.d.ts

@@ -0,0 +1,2 @@
+export { createBacktrackMiddleware, type BacktrackMiddlewareOptions, type ConnectLikeMiddleware } from './middleware';
+//# sourceMappingURL=index.d.ts.map

package/dist/dev-server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dev-server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC3B,MAAM,cAAc,CAAC"}

package/dist/dev-server/middleware.d.ts

@@ -0,0 +1,14 @@
+import type { IncomingMessage, ServerResponse } from 'http';
+export interface BacktrackMiddlewareOptions {
+    /** Absolute directory; use only one middleware instance per directory. */
+    directory?: string;
+    /** Alias for directory. */
+    outputDir?: string;
+    allowedOrigins?: string[];
+    maxBodyBytes?: number;
+    maxIncidents?: number;
+    maxStorageBytes?: number;
+}
+export type ConnectLikeMiddleware = (req: IncomingMessage, res: ServerResponse, next?: (err?: unknown) => void) => void;
+export declare function createBacktrackMiddleware(options: BacktrackMiddlewareOptions): ConnectLikeMiddleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/dev-server/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/dev-server/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAM5D,MAAM,WAAW,0BAA0B;IACzC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AACD,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;AAmCxH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,qBAAqB,CAqKpG"}

package/dist/dev-server.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("fs"),y=require("path"),I=require("./markdown-Ao5Ah9MF.cjs"),U=/^[a-zA-Z0-9_-]{1,128}$/,W=/^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i,_=t=>U.test(t)&&!W.test(t),A=t=>["localhost","127.0.0.1","[::1]"].includes(t.toLowerCase()),Q=t=>t==="127.0.0.1"||t==="::1"||t==="::ffff:127.0.0.1";function V(t,o){if(!Q(t.socket.remoteAddress))return!1;try{const S=t.headers.host;if(!S)return!1;const d=new URL(`http://${S}`);if(d.host!==S.toLowerCase()||!A(d.hostname))return!1;const f=t.headers.origin;if(!f)return!(o!=null&&o.length);const h=new URL(f);return!["http:","https:"].includes(h.protocol)||!A(h.hostname)||h.origin!==f?!1:o!=null&&o.length?o.includes(f):h.host===d.host}catch{return!1}}const Z=(t,o)=>t.triggeredAt-o.triggeredAt||(t.id<o.id?-1:t.id>o.id?1:0);function m(t){return e.existsSync(t)&&e.lstatSync(t).isFile()}function G(t){var L;const o=(t==null?void 0:t.directory)??(t==null?void 0:t.outputDir);if(!t||typeof o!="string"||!y.isAbsolute(o))throw new Error('[Backtrack dev-server] A opção "directory" (ou "outputDir") absoluta é obrigatória.');const S=y.resolve(o),d=y.join(S,"incidents"),f=y.join(S,"latest.md"),h=t.maxBodyBytes??50*1024*1024,F=t.maxIncidents??20,v=t.maxStorageBytes??200*1024*1024;for(const i of[h,F,v])if(!Number.isSafeInteger(i)||i<=0)throw new Error("Backtrack limits must be positive safe integers.");if((L=t.allowedOrigins)!=null&&L.some(i=>{try{const r=new URL(i);return!A(r.hostname)||!["http:","https:"].includes(r.protocol)||r.origin!==i}catch{return!0}}))throw new Error("Backtrack origins must be local HTTP(S) origins.");let P=Promise.resolve();function x(){const i=[];for(const r of e.readdirSync(d)){if(!r.endsWith(".json"))continue;const s=r.slice(0,-5);if(!_(s))continue;const n=y.join(d,r),c=y.join(d,`${s}.md`);try{if(!m(n)||!m(c)||e.statSync(n).size>h)continue;const a=I.validateFlightRecorderArtifact(JSON.parse(e.readFileSync(n,"utf8")));if(!a.success||a.data.incident.id!==s||!e.readFileSync(c,"utf8").startsWith(`# Incidente Backtrack
+`))continue;i.push({id:s,jsonPath:n,mdPath:c,triggeredAt:a.data.incident.triggeredAt,size:e.statSync(n).size+e.statSync(c).size})}catch{}}return i.sort(Z)}function D(){const i=x(),r=i[i.length-1];if(!r)throw new Error("No complete incident to publish");const s=`> **Artefato completo:** [\`${r.id}.json\`](incidents/${r.id}.json)
+
+`+e.readFileSync(r.mdPath,"utf8"),n=`${f}.${Date.now()}.tmp`;try{e.writeFileSync(n,s,{encoding:"utf8",flag:"wx"}),e.renameSync(n,f)}finally{m(n)&&e.unlinkSync(n)}return r.id}function E(i){const r=x();let s=r.length,n=r.reduce((c,a)=>c+a.size,e.statSync(f).size);for(const c of r){if(s<=F&&n<=v)break;c.id!==i&&(e.unlinkSync(c.mdPath),e.unlinkSync(c.jsonPath),s--,n-=c.size)}}return(i,r,s)=>{const n=(l,$)=>{!r.destroyed&&!r.headersSent&&(r.writeHead(l,{"Content-Type":"application/json",...l===405?{Allow:"POST"}:{}}),r.end(JSON.stringify($)))};if((i.url||"").split("?")[0]!=="/__backtrack/incident"){s?s():n(404,{error:"Not found"});return}if(i.method!=="POST"){n(405,{error:"Method Not Allowed"});return}if((i.headers["content-type"]||"").split(";")[0].trim().toLowerCase()!=="application/json"){n(415,{error:"Unsupported Media Type: application/json required"});return}if(!V(i,t.allowedOrigins)){n(403,{error:"Forbidden: invalid origin or non-local access"});return}let c=0,a=!1;const p=[];i.on("error",()=>{a=!0,p.length=0}),i.on("aborted",()=>{a=!0,p.length=0}),i.on("data",l=>{a||(c+=l.length,c>h?(a=!0,p.length=0,r.setHeader("Connection","close"),n(413,{error:"Payload Too Large"})):p.push(l))}),i.on("end",()=>{if(a)return;const l=Buffer.concat(p).toString("utf8");p.length=0;let $;try{$=JSON.parse(l)}catch{n(400,{error:"Invalid JSON"});return}const z=I.validateFlightRecorderArtifact($);if(!z.success){n(400,{error:"Invalid artifact schema"});return}const M=z.data,g=M.incident.id;if(!_(g)){n(400,{error:"Invalid incident ID format"});return}P=P.then(()=>{try{for(const u of[S,d]){if(e.existsSync(u)&&!e.lstatSync(u).isDirectory())throw new Error("Invalid output directory");e.mkdirSync(u,{recursive:!0})}const w=y.join(d,`${g}.json`),k=y.join(d,`${g}.md`),j=e.existsSync(w),O=e.existsSync(k);if(j&&(!m(w)||e.readFileSync(w,"utf8")!==l)||O&&(!m(k)||!j)){n(409,{error:"Conflict: incident ID exists with different content"});return}if(j&&O){const u=D();E(u),n(200,{id:g,status:"already_persisted"});return}const N=I.formatIncidentMarkdown(M),H=`> **Artefato completo:** [\`${g}.json\`](incidents/${g}.json)
+
+`;if(Buffer.byteLength(l)+2*Buffer.byteLength(N)+Buffer.byteLength(H)>v){n(413,{error:"Incident size exceeds maxStorageBytes limit"});return}const R=`${Date.now()}-${Math.random().toString(36).slice(2)}`,B=`${w}.${R}.tmp`,b=`${k}.${R}.tmp`;let T=!1,C=!1;try{j||e.writeFileSync(B,l,{encoding:"utf8",flag:"wx"}),e.writeFileSync(b,N,{encoding:"utf8",flag:"wx"}),j||(e.renameSync(B,w),T=!0),e.renameSync(b,k),C=!0,D()}catch(u){throw C&&m(k)&&e.unlinkSync(k),T&&m(w)&&e.unlinkSync(w),u}finally{for(const u of[B,b])m(u)&&e.unlinkSync(u)}const J=x();E(J[J.length-1].id),n(201,{id:g,status:"saved"})}catch{n(500,{error:"Failed to persist incident"})}})})}}exports.createBacktrackMiddleware=G;
+//# sourceMappingURL=dev-server.cjs.map

package/dist/dev-server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.cjs","sources":["../src/dev-server/middleware.ts"],"sourcesContent":["import type { IncomingMessage, ServerResponse } from 'http';\nimport fs from 'fs';\nimport path from 'path';\nimport { validateFlightRecorderArtifact } from '../validation/validate';\nimport { formatIncidentMarkdown } from '../utils/markdown';\n\nexport interface BacktrackMiddlewareOptions {\n  /** Absolute directory; use only one middleware instance per directory. */\n  directory?: string;\n  /** Alias for directory. */\n  outputDir?: string;\n  allowedOrigins?: string[];\n  maxBodyBytes?: number;\n  maxIncidents?: number;\n  maxStorageBytes?: number;\n}\nexport type ConnectLikeMiddleware = (req: IncomingMessage, res: ServerResponse, next?: (err?: unknown) => void) => void;\nconst SAFE_ID = /^[a-zA-Z0-9_-]{1,128}$/;\nconst RESERVED_ID = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i;\nconst safeId = (id: string) => SAFE_ID.test(id) && !RESERVED_ID.test(id);\nconst localHostname = (name: string) => ['localhost', '127.0.0.1', '[::1]'].includes(name.toLowerCase());\nconst localAddress = (address?: string) => address === '127.0.0.1' || address === '::1' || address === '::ffff:127.0.0.1';\nfunction allowedRequest(req: IncomingMessage, origins?: string[]): boolean {\n  if (!localAddress(req.socket.remoteAddress)) return false;\n  try {\n    const host = req.headers.host;\n    if (!host) return false;\n    const target = new URL(`http://${host}`);\n    if (target.host !== host.toLowerCase() || !localHostname(target.hostname)) return false;\n    const origin = req.headers.origin;\n    if (!origin) return !origins?.length;\n    const source = new URL(origin);\n    if (!['http:', 'https:'].includes(source.protocol) || !localHostname(source.hostname) || source.origin !== origin) return false;\n    return origins?.length ? origins.includes(origin) : source.host === target.host;\n  } catch {\n    return false;\n  }\n}\ninterface ManagedIncident {\n  id: string;\n  triggeredAt: number;\n  jsonPath: string;\n  mdPath: string;\n  size: number;\n}\nconst compareIncidents = (a: ManagedIncident, b: ManagedIncident) =>\n  a.triggeredAt - b.triggeredAt || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0);\nfunction regularFile(file: string): boolean {\n  return fs.existsSync(file) && fs.lstatSync(file).isFile();\n}\n\nexport function createBacktrackMiddleware(options: BacktrackMiddlewareOptions): ConnectLikeMiddleware {\n  const dir = options?.directory ?? options?.outputDir;\n  if (!options || typeof dir !== 'string' || !path.isAbsolute(dir)) {\n    throw new Error('[Backtrack dev-server] A opção \"directory\" (ou \"outputDir\") absoluta é obrigatória.');\n  }\n  const baseDirectory = path.resolve(dir);\n  const incidentsDir = path.join(baseDirectory, 'incidents');\n  const latestPath = path.join(baseDirectory, 'latest.md');\n  const maxBodyBytes = options.maxBodyBytes ?? 50 * 1024 * 1024;\n  const maxIncidents = options.maxIncidents ?? 20;\n  const maxStorageBytes = options.maxStorageBytes ?? 200 * 1024 * 1024;\n  for (const value of [maxBodyBytes, maxIncidents, maxStorageBytes]) {\n    if (!Number.isSafeInteger(value) || value <= 0) throw new Error('Backtrack limits must be positive safe integers.');\n  }\n  if (options.allowedOrigins?.some(origin => {\n    try {\n      const url = new URL(origin);\n      return !localHostname(url.hostname) || !['http:', 'https:'].includes(url.protocol) || url.origin !== origin;\n    } catch { return true; }\n  })) throw new Error('Backtrack origins must be local HTTP(S) origins.');\n\n  // ponytail: synchronous local writes serialized per instance; use async IO if measured dev-server latency warrants it.\n  let persistenceQueue = Promise.resolve();\n  function scan(): ManagedIncident[] {\n    const list: ManagedIncident[] = [];\n    for (const file of fs.readdirSync(incidentsDir)) {\n      if (!file.endsWith('.json')) continue;\n      const id = file.slice(0, -5);\n      if (!safeId(id)) continue;\n      const jsonPath = path.join(incidentsDir, file);\n      const mdPath = path.join(incidentsDir, `${id}.md`);\n      try {\n        if (!regularFile(jsonPath) || !regularFile(mdPath) || fs.statSync(jsonPath).size > maxBodyBytes) continue;\n        const validated = validateFlightRecorderArtifact(JSON.parse(fs.readFileSync(jsonPath, 'utf8')));\n        if (!validated.success || validated.data.incident.id !== id) continue;\n        if (!fs.readFileSync(mdPath, 'utf8').startsWith('# Incidente Backtrack\\n')) continue;\n        list.push({ id, jsonPath, mdPath, triggeredAt: validated.data.incident.triggeredAt, size: fs.statSync(jsonPath).size + fs.statSync(mdPath).size });\n      } catch {\n        // Unknown, incomplete or invalid files are never retention candidates.\n      }\n    }\n    return list.sort(compareIncidents);\n  }\n  function publishLatest(): string {\n    const list = scan();\n    const latest = list[list.length - 1];\n    if (!latest) throw new Error('No complete incident to publish');\n    const content = `> **Artefato completo:** [\\`${latest.id}.json\\`](incidents/${latest.id}.json)\\n\\n` + fs.readFileSync(latest.mdPath, 'utf8');\n    const temporary = `${latestPath}.${Date.now()}.tmp`;\n    try {\n      fs.writeFileSync(temporary, content, { encoding: 'utf8', flag: 'wx' });\n      fs.renameSync(temporary, latestPath);\n    } finally {\n      if (regularFile(temporary)) fs.unlinkSync(temporary);\n    }\n    return latest.id;\n  }\n  function retain(latestId: string): void {\n    const list = scan();\n    let count = list.length;\n    let size = list.reduce((total, item) => total + item.size, fs.statSync(latestPath).size);\n    for (const item of list) {\n      if (count <= maxIncidents && size <= maxStorageBytes) break;\n      if (item.id === latestId) continue;\n      fs.unlinkSync(item.mdPath);\n      fs.unlinkSync(item.jsonPath);\n      count--;\n      size -= item.size;\n    }\n  }\n  return (req, res, next) => {\n    const respond = (status: number, body: Record<string, unknown>) => {\n      if (!res.destroyed && !res.headersSent) {\n        res.writeHead(status, { 'Content-Type': 'application/json', ...(status === 405 ? { Allow: 'POST' } : {}) });\n        res.end(JSON.stringify(body));\n      }\n    };\n    if ((req.url || '').split('?')[0] !== '/__backtrack/incident') {\n      if (next) next(); else respond(404, { error: 'Not found' });\n      return;\n    }\n    if (req.method !== 'POST') { respond(405, { error: 'Method Not Allowed' }); return; }\n    if ((req.headers['content-type'] || '').split(';')[0].trim().toLowerCase() !== 'application/json') {\n      respond(415, { error: 'Unsupported Media Type: application/json required' }); return;\n    }\n    if (!allowedRequest(req, options.allowedOrigins)) { respond(403, { error: 'Forbidden: invalid origin or non-local access' }); return; }\n    let bytes = 0;\n    let rejected = false;\n    const chunks: Buffer[] = [];\n    req.on('error', () => { rejected = true; chunks.length = 0; });\n    req.on('aborted', () => { rejected = true; chunks.length = 0; });\n    req.on('data', (chunk: Buffer) => {\n      if (rejected) return;\n      bytes += chunk.length;\n      if (bytes > maxBodyBytes) {\n        rejected = true;\n        chunks.length = 0;\n        res.setHeader('Connection', 'close');\n        respond(413, { error: 'Payload Too Large' });\n        // Drain without retaining data so the HTTP response can reach the client.\n      } else chunks.push(chunk);\n    });\n    req.on('end', () => {\n      if (rejected) return;\n      const rawBody = Buffer.concat(chunks).toString('utf8');\n      chunks.length = 0;\n      let parsed: unknown;\n      try { parsed = JSON.parse(rawBody); }\n      catch { respond(400, { error: 'Invalid JSON' }); return; }\n      const validated = validateFlightRecorderArtifact(parsed);\n      if (!validated.success) { respond(400, { error: 'Invalid artifact schema' }); return; }\n      const artifact = validated.data;\n      const id = artifact.incident.id;\n      if (!safeId(id)) { respond(400, { error: 'Invalid incident ID format' }); return; }\n      persistenceQueue = persistenceQueue.then(() => {\n        try {\n          for (const dir of [baseDirectory, incidentsDir]) {\n            if (fs.existsSync(dir) && !fs.lstatSync(dir).isDirectory()) throw new Error('Invalid output directory');\n            fs.mkdirSync(dir, { recursive: true });\n          }\n          const jsonPath = path.join(incidentsDir, `${id}.json`);\n          const mdPath = path.join(incidentsDir, `${id}.md`);\n          const jsonExists = fs.existsSync(jsonPath);\n          const mdExists = fs.existsSync(mdPath);\n          if ((jsonExists && (!regularFile(jsonPath) || fs.readFileSync(jsonPath, 'utf8') !== rawBody)) ||\n              (mdExists && (!regularFile(mdPath) || !jsonExists))) {\n            respond(409, { error: 'Conflict: incident ID exists with different content' }); return;\n          }\n          if (jsonExists && mdExists) {\n            const latestId = publishLatest();\n            retain(latestId);\n            respond(200, { id, status: 'already_persisted' }); return;\n          }\n          const markdown = formatIncidentMarkdown(artifact);\n          const header = `> **Artefato completo:** [\\`${id}.json\\`](incidents/${id}.json)\\n\\n`;\n          if (Buffer.byteLength(rawBody) + 2 * Buffer.byteLength(markdown) + Buffer.byteLength(header) > maxStorageBytes) {\n            respond(413, { error: 'Incident size exceeds maxStorageBytes limit' }); return;\n          }\n          const nonce = `${Date.now()}-${Math.random().toString(36).slice(2)}`;\n          const tmpJson = `${jsonPath}.${nonce}.tmp`;\n          const tmpMd = `${mdPath}.${nonce}.tmp`;\n          let createdJson = false;\n          let createdMd = false;\n          try {\n            if (!jsonExists) fs.writeFileSync(tmpJson, rawBody, { encoding: 'utf8', flag: 'wx' });\n            fs.writeFileSync(tmpMd, markdown, { encoding: 'utf8', flag: 'wx' });\n            if (!jsonExists) { fs.renameSync(tmpJson, jsonPath); createdJson = true; }\n            fs.renameSync(tmpMd, mdPath); createdMd = true;\n            publishLatest();\n          } catch (error) {\n            if (createdMd && regularFile(mdPath)) fs.unlinkSync(mdPath);\n            if (createdJson && regularFile(jsonPath)) fs.unlinkSync(jsonPath);\n            throw error;\n          } finally {\n            for (const file of [tmpJson, tmpMd]) if (regularFile(file)) fs.unlinkSync(file);\n          }\n          const list = scan();\n          retain(list[list.length - 1].id);\n          respond(201, { id, status: 'saved' });\n        } catch {\n          respond(500, { error: 'Failed to persist incident' });\n        }\n      });\n    });\n  };\n}\r\n"],"names":["SAFE_ID","RESERVED_ID","safeId","id","localHostname","name","localAddress","address","allowedRequest","req","origins","host","target","origin","source","compareIncidents","a","b","regularFile","file","fs","createBacktrackMiddleware","options","dir","path","baseDirectory","incidentsDir","latestPath","maxBodyBytes","maxIncidents","maxStorageBytes","value","_a","url","persistenceQueue","scan","list","jsonPath","mdPath","validated","validateFlightRecorderArtifact","publishLatest","latest","content","temporary","retain","latestId","count","size","total","item","res","next","respond","status","body","bytes","rejected","chunks","chunk","rawBody","parsed","artifact","jsonExists","mdExists","markdown","formatIncidentMarkdown","header","nonce","tmpJson","tmpMd","createdJson","createdMd","error"],"mappings":"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"}

package/dist/dev-server.js

@@ -0,0 +1,173 @@
+import e from "fs";
+import y from "path";
+import { v as J, f as U } from "./markdown-D3C94OlY.js";
+const W = /^[a-zA-Z0-9_-]{1,128}$/, Q = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i, _ = (t) => W.test(t) && !Q.test(t), b = (t) => ["localhost", "127.0.0.1", "[::1]"].includes(t.toLowerCase()), V = (t) => t === "127.0.0.1" || t === "::1" || t === "::ffff:127.0.0.1";
+function Z(t, i) {
+  if (!V(t.socket.remoteAddress)) return !1;
+  try {
+    const S = t.headers.host;
+    if (!S) return !1;
+    const d = new URL(`http://${S}`);
+    if (d.host !== S.toLowerCase() || !b(d.hostname)) return !1;
+    const u = t.headers.origin;
+    if (!u) return !(i != null && i.length);
+    const h = new URL(u);
+    return !["http:", "https:"].includes(h.protocol) || !b(h.hostname) || h.origin !== u ? !1 : i != null && i.length ? i.includes(u) : h.host === d.host;
+  } catch {
+    return !1;
+  }
+}
+const G = (t, i) => t.triggeredAt - i.triggeredAt || (t.id < i.id ? -1 : t.id > i.id ? 1 : 0);
+function m(t) {
+  return e.existsSync(t) && e.lstatSync(t).isFile();
+}
+function q(t) {
+  var E;
+  const i = (t == null ? void 0 : t.directory) ?? (t == null ? void 0 : t.outputDir);
+  if (!t || typeof i != "string" || !y.isAbsolute(i))
+    throw new Error('[Backtrack dev-server] A opção "directory" (ou "outputDir") absoluta é obrigatória.');
+  const S = y.resolve(i), d = y.join(S, "incidents"), u = y.join(S, "latest.md"), h = t.maxBodyBytes ?? 50 * 1024 * 1024, A = t.maxIncidents ?? 20, $ = t.maxStorageBytes ?? 200 * 1024 * 1024;
+  for (const o of [h, A, $])
+    if (!Number.isSafeInteger(o) || o <= 0) throw new Error("Backtrack limits must be positive safe integers.");
+  if ((E = t.allowedOrigins) != null && E.some((o) => {
+    try {
+      const r = new URL(o);
+      return !b(r.hostname) || !["http:", "https:"].includes(r.protocol) || r.origin !== o;
+    } catch {
+      return !0;
+    }
+  })) throw new Error("Backtrack origins must be local HTTP(S) origins.");
+  let F = Promise.resolve();
+  function v() {
+    const o = [];
+    for (const r of e.readdirSync(d)) {
+      if (!r.endsWith(".json")) continue;
+      const c = r.slice(0, -5);
+      if (!_(c)) continue;
+      const n = y.join(d, r), s = y.join(d, `${c}.md`);
+      try {
+        if (!m(n) || !m(s) || e.statSync(n).size > h) continue;
+        const a = J(JSON.parse(e.readFileSync(n, "utf8")));
+        if (!a.success || a.data.incident.id !== c || !e.readFileSync(s, "utf8").startsWith(`# Incidente Backtrack
+`)) continue;
+        o.push({ id: c, jsonPath: n, mdPath: s, triggeredAt: a.data.incident.triggeredAt, size: e.statSync(n).size + e.statSync(s).size });
+      } catch {
+      }
+    }
+    return o.sort(G);
+  }
+  function P() {
+    const o = v(), r = o[o.length - 1];
+    if (!r) throw new Error("No complete incident to publish");
+    const c = `> **Artefato completo:** [\`${r.id}.json\`](incidents/${r.id}.json)
+
+` + e.readFileSync(r.mdPath, "utf8"), n = `${u}.${Date.now()}.tmp`;
+    try {
+      e.writeFileSync(n, c, { encoding: "utf8", flag: "wx" }), e.renameSync(n, u);
+    } finally {
+      m(n) && e.unlinkSync(n);
+    }
+    return r.id;
+  }
+  function D(o) {
+    const r = v();
+    let c = r.length, n = r.reduce((s, a) => s + a.size, e.statSync(u).size);
+    for (const s of r) {
+      if (c <= A && n <= $) break;
+      s.id !== o && (e.unlinkSync(s.mdPath), e.unlinkSync(s.jsonPath), c--, n -= s.size);
+    }
+  }
+  return (o, r, c) => {
+    const n = (l, x) => {
+      !r.destroyed && !r.headersSent && (r.writeHead(l, { "Content-Type": "application/json", ...l === 405 ? { Allow: "POST" } : {} }), r.end(JSON.stringify(x)));
+    };
+    if ((o.url || "").split("?")[0] !== "/__backtrack/incident") {
+      c ? c() : n(404, { error: "Not found" });
+      return;
+    }
+    if (o.method !== "POST") {
+      n(405, { error: "Method Not Allowed" });
+      return;
+    }
+    if ((o.headers["content-type"] || "").split(";")[0].trim().toLowerCase() !== "application/json") {
+      n(415, { error: "Unsupported Media Type: application/json required" });
+      return;
+    }
+    if (!Z(o, t.allowedOrigins)) {
+      n(403, { error: "Forbidden: invalid origin or non-local access" });
+      return;
+    }
+    let s = 0, a = !1;
+    const w = [];
+    o.on("error", () => {
+      a = !0, w.length = 0;
+    }), o.on("aborted", () => {
+      a = !0, w.length = 0;
+    }), o.on("data", (l) => {
+      a || (s += l.length, s > h ? (a = !0, w.length = 0, r.setHeader("Connection", "close"), n(413, { error: "Payload Too Large" })) : w.push(l));
+    }), o.on("end", () => {
+      if (a) return;
+      const l = Buffer.concat(w).toString("utf8");
+      w.length = 0;
+      let x;
+      try {
+        x = JSON.parse(l);
+      } catch {
+        n(400, { error: "Invalid JSON" });
+        return;
+      }
+      const L = J(x);
+      if (!L.success) {
+        n(400, { error: "Invalid artifact schema" });
+        return;
+      }
+      const z = L.data, g = z.incident.id;
+      if (!_(g)) {
+        n(400, { error: "Invalid incident ID format" });
+        return;
+      }
+      F = F.then(() => {
+        try {
+          for (const f of [S, d]) {
+            if (e.existsSync(f) && !e.lstatSync(f).isDirectory()) throw new Error("Invalid output directory");
+            e.mkdirSync(f, { recursive: !0 });
+          }
+          const p = y.join(d, `${g}.json`), k = y.join(d, `${g}.md`), j = e.existsSync(p), N = e.existsSync(k);
+          if (j && (!m(p) || e.readFileSync(p, "utf8") !== l) || N && (!m(k) || !j)) {
+            n(409, { error: "Conflict: incident ID exists with different content" });
+            return;
+          }
+          if (j && N) {
+            const f = P();
+            D(f), n(200, { id: g, status: "already_persisted" });
+            return;
+          }
+          const O = U(z), H = `> **Artefato completo:** [\`${g}.json\`](incidents/${g}.json)
+
+`;
+          if (Buffer.byteLength(l) + 2 * Buffer.byteLength(O) + Buffer.byteLength(H) > $) {
+            n(413, { error: "Incident size exceeds maxStorageBytes limit" });
+            return;
+          }
+          const M = `${Date.now()}-${Math.random().toString(36).slice(2)}`, B = `${p}.${M}.tmp`, I = `${k}.${M}.tmp`;
+          let R = !1, T = !1;
+          try {
+            j || e.writeFileSync(B, l, { encoding: "utf8", flag: "wx" }), e.writeFileSync(I, O, { encoding: "utf8", flag: "wx" }), j || (e.renameSync(B, p), R = !0), e.renameSync(I, k), T = !0, P();
+          } catch (f) {
+            throw T && m(k) && e.unlinkSync(k), R && m(p) && e.unlinkSync(p), f;
+          } finally {
+            for (const f of [B, I]) m(f) && e.unlinkSync(f);
+          }
+          const C = v();
+          D(C[C.length - 1].id), n(201, { id: g, status: "saved" });
+        } catch {
+          n(500, { error: "Failed to persist incident" });
+        }
+      });
+    });
+  };
+}
+export {
+  q as createBacktrackMiddleware
+};
+//# sourceMappingURL=dev-server.js.map