@backtrack-js/browser 0.4.0

package/bin/viewer.cjs

@@ -0,0 +1,143 @@
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const { exec } = require('child_process');
+
+const args = process.argv.slice(2);
+let port = 5173;
+
+let isExplicitPort = false;
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === '--port' || args[i] === '-p') {
+    port = parseInt(args[i + 1], 10) || 5173;
+    isExplicitPort = true;
+  }
+}
+
+const viewerDir = path.resolve(__dirname, '../dist/viewer');
+
+if (!fs.existsSync(viewerDir)) {
+  console.error('\x1b[31m[Backtrack]\x1b[0m Viewer build not found at dist/viewer.');
+  console.error('Please run "npm run build" in @backtrack-js/browser first.');
+  process.exit(1);
+}
+
+const MIME_TYPES = {
+  '.html': 'text/html; charset=utf-8',
+  '.js': 'application/javascript; charset=utf-8',
+  '.css': 'text/css; charset=utf-8',
+  '.json': 'application/json; charset=utf-8',
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.svg': 'image/svg+xml',
+  '.ico': 'image/x-icon',
+  '.woff': 'font/woff',
+  '.woff2': 'font/woff2'
+};
+
+function createServerInstance() {
+  return http.createServer((req, res) => {
+    // CORS permissivo para uso local e integração com ferramentas de desenvolvimento
+    res.setHeader('Access-Control-Allow-Origin', '*');
+    res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', '*');
+
+    if (req.method === 'OPTIONS') {
+      res.writeHead(204);
+      res.end();
+      return;
+    }
+
+    const reqUrl = req.url.split('?')[0];
+    let safePath = path.normalize(reqUrl).replace(/^(\.\.[\/\\])+/, '');
+    let filePath = path.join(viewerDir, safePath);
+
+    if (fs.existsSync(filePath) && fs.statSync(filePath).isDirectory()) {
+      filePath = path.join(filePath, 'index.html');
+    }
+
+    if (!fs.existsSync(filePath)) {
+      // SPA fallback
+      filePath = path.join(viewerDir, 'index.html');
+    }
+
+    const ext = path.extname(filePath).toLowerCase();
+    const contentType = MIME_TYPES[ext] || 'application/octet-stream';
+
+    fs.readFile(filePath, (err, content) => {
+      if (err) {
+        res.writeHead(500, { 'Content-Type': 'text/plain' });
+        res.end('Internal Server Error');
+        return;
+      }
+      res.writeHead(200, { 'Content-Type': contentType });
+      res.end(content);
+    });
+  });
+}
+
+const os = require('os');
+
+function start(targetPort) {
+  const server = createServerInstance();
+
+  server.on('error', (err) => {
+    if (err.code === 'EADDRINUSE') {
+      if (!isExplicitPort && targetPort < 5190) {
+        console.log(`\x1b[33m[Backtrack]\x1b[0m Porta ${targetPort} ocupada, tentando porta ${targetPort + 1}...`);
+        start(targetPort + 1);
+      } else {
+        console.error(`\x1b[31m[Backtrack]\x1b[0m A porta ${targetPort} já está em uso.`);
+        console.error(`Tente passar outra porta com: npm run viewer -- --port <porta>`);
+        process.exit(1);
+      }
+    } else {
+      console.error('\x1b[31m[Backtrack]\x1b[0m Erro no servidor:', err.message || err);
+      process.exit(1);
+    }
+  });
+
+  server.listen(targetPort, '0.0.0.0', () => {
+    const url = `http://localhost:${targetPort}`;
+    console.log('\n\x1b[36m[Backtrack Viewer]\x1b[0m');
+    console.log(`  > Local:   \x1b[32m${url}\x1b[0m`);
+
+    // Detecta o IP da máquina na rede local Wi-Fi / Ethernet
+    const nets = os.networkInterfaces();
+    for (const name of Object.keys(nets)) {
+      for (const net of nets[name] || []) {
+        if (net.family === 'IPv4' && !net.internal) {
+          console.log(`  > Network: \x1b[32mhttp://${net.address}:${targetPort}\x1b[0m`);
+        }
+      }
+    }
+
+    console.log('  > Ready to inspect incidents. Pressione Ctrl+C para encerrar.\n');
+
+    // Tenta abrir o navegador automaticamente
+    const startCmd =
+      process.platform === 'darwin'
+        ? `open "${url}"`
+        : process.platform === 'win32'
+        ? `start "" "${url}"`
+        : `xdg-open "${url}"`;
+
+    if (!process.env.BACKTRACK_NO_OPEN) {
+      exec(startCmd, () => {
+        // Ignora erros ao abrir automaticamente
+      });
+    }
+  });
+
+  return server;
+}
+
+if (typeof process.env.VITEST === 'undefined') {
+  start(port);
+}
+
+module.exports = {
+  createServerInstance,
+  start
+};

package/dist/capturers/console.d.ts

@@ -0,0 +1,18 @@
+import type { BatchWriter } from '../storage/batch-writer';
+export declare class ConsoleCapturer {
+    private writer;
+    private isRecording;
+    private sequenceProvider;
+    private originalLog;
+    private originalWarn;
+    private originalError;
+    private wrappedLog;
+    private wrappedWarn;
+    private wrappedError;
+    private isInsideHook;
+    constructor(writer: BatchWriter, sequenceProvider: () => number);
+    start(): void;
+    private handleConsole;
+    stop(): void;
+}
+//# sourceMappingURL=console.d.ts.map

package/dist/capturers/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/capturers/console.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAAe;IAEvC,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,aAAa,CAAqC;IAE1D,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,YAAY,CAAqC;IAEzD,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,MAAM;IAKxD,KAAK,IAAI,IAAI;IAuBpB,OAAO,CAAC,aAAa;IAkCd,IAAI,IAAI,IAAI;CAsBpB"}

package/dist/capturers/errors.d.ts

@@ -0,0 +1,22 @@
+import type { BatchWriter } from '../storage/batch-writer';
+import type { IncidentManager } from '../storage/incident-manager';
+import type { ErrorContext } from '../types/options';
+export declare class ErrorCapturer {
+    private writer;
+    private incidentManager;
+    private sequenceProvider;
+    private isRecording;
+    private errorHandler?;
+    private rejectionHandler?;
+    constructor(writer: BatchWriter, incidentManager: IncidentManager, sequenceProvider: () => number);
+    start(): void;
+    private handleGlobalError;
+    private handleUnhandledRejection;
+    /**
+     * API pública para capturar exceções explicitamente (ex: do SentryBoundary do uTicket).
+     */
+    captureException(error: unknown, context?: ErrorContext): Promise<string | undefined> | void;
+    private recordAndTriggerError;
+    stop(): void;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/capturers/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/capturers/errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,gBAAgB,CAAe;IACvC,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,YAAY,CAAC,CAA8B;IACnD,OAAO,CAAC,gBAAgB,CAAC,CAAyC;gBAGhE,MAAM,EAAE,WAAW,EACnB,eAAe,EAAE,eAAe,EAChC,gBAAgB,EAAE,MAAM,MAAM;IAOzB,KAAK,IAAI,IAAI;IAmBpB,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,wBAAwB;IA8BhC;;OAEG;IACI,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,IAAI;IAmCnG,OAAO,CAAC,qBAAqB;IAoDtB,IAAI,IAAI,IAAI;CAepB"}

package/dist/capturers/index.d.ts

@@ -0,0 +1,8 @@
+export * from './sanitizer';
+export * from './console';
+export * from './errors';
+export * from './network';
+export * from './navigation';
+export * from './rrweb';
+export * from './performance';
+//# sourceMappingURL=index.d.ts.map

package/dist/capturers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capturers/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC"}

package/dist/capturers/navigation.d.ts

@@ -0,0 +1,20 @@
+import type { BatchWriter } from '../storage/batch-writer';
+export interface NavigationCapturerConfig {
+    sanitizeUrlCallback?: (url: URL) => string;
+}
+export declare class NavigationCapturer {
+    private writer;
+    private sequenceProvider;
+    private config;
+    private isRecording;
+    private currentUrl;
+    private originalPushState;
+    private originalReplaceState;
+    private popstateHandler?;
+    private hashchangeHandler?;
+    constructor(writer: BatchWriter, sequenceProvider: () => number, config?: NavigationCapturerConfig);
+    start(): void;
+    private recordNavigation;
+    stop(): void;
+}
+//# sourceMappingURL=navigation.d.ts.map

package/dist/capturers/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/capturers/navigation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,MAAM,WAAW,wBAAwB;IACvC,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;CAC5C;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,gBAAgB,CAAe;IACvC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,iBAAiB,CAAgD;IACzE,OAAO,CAAC,oBAAoB,CAAmD;IAE/E,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,iBAAiB,CAAC,CAAa;gBAGrC,MAAM,EAAE,WAAW,EACnB,gBAAgB,EAAE,MAAM,MAAM,EAC9B,MAAM,CAAC,EAAE,wBAAwB;IAO5B,KAAK,IAAI,IAAI;IAyCpB,OAAO,CAAC,gBAAgB;IAoBjB,IAAI,IAAI,IAAI;CAwBpB"}

package/dist/capturers/network.d.ts

@@ -0,0 +1,30 @@
+import type { BatchWriter } from '../storage/batch-writer';
+import type { IncidentManager } from '../storage/incident-manager';
+export interface NetworkCapturerConfig {
+    captureHttpStatus: number[];
+    ignoredUrls?: (string | RegExp)[];
+    sanitizeUrlCallback?: (url: URL) => string;
+    capturePayloads?: boolean;
+    maxPayloadSize?: number;
+}
+export declare class NetworkCapturer {
+    private writer;
+    private incidentManager;
+    private sequenceProvider;
+    private config;
+    private isRecording;
+    private originalFetch;
+    private wrappedFetch;
+    private originalXHROpen;
+    private originalXHRSend;
+    private originalXHRSetHeader;
+    private xhrMetadata;
+    constructor(writer: BatchWriter, incidentManager: IncidentManager, sequenceProvider: () => number, config?: Partial<NetworkCapturerConfig>);
+    start(): void;
+    private shouldIgnoreUrl;
+    private instrumentFetch;
+    private instrumentXHR;
+    private recordNetworkEvent;
+    stop(): void;
+}
+//# sourceMappingURL=network.d.ts.map

package/dist/capturers/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/capturers/network.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAGnE,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAClC,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;IAC3C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,gBAAgB,CAAe;IACvC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,YAAY,CAAoC;IAExD,OAAO,CAAC,eAAe,CAAqD;IAC5E,OAAO,CAAC,eAAe,CAAqD;IAC5E,OAAO,CAAC,oBAAoB,CAAiE;IAC7F,OAAO,CAAC,WAAW,CAA8C;gBAG/D,MAAM,EAAE,WAAW,EACnB,eAAe,EAAE,eAAe,EAChC,gBAAgB,EAAE,MAAM,MAAM,EAC9B,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAclC,KAAK,IAAI,IAAI;IAQpB,OAAO,CAAC,eAAe;IAkCvB,OAAO,CAAC,eAAe;IAqHvB,OAAO,CAAC,aAAa;IA4HrB,OAAO,CAAC,kBAAkB;IAqDnB,IAAI,IAAI,IAAI;CA6BpB"}

package/dist/capturers/performance.d.ts

@@ -0,0 +1,15 @@
+import type { BatchWriter } from '../storage/batch-writer';
+export interface PerformanceCapturerConfig {
+    longTaskThresholdMs?: number;
+}
+export declare class PerformanceCapturer {
+    private writer;
+    private sequenceProvider;
+    private observer;
+    private isRecording;
+    private thresholdMs;
+    constructor(writer: BatchWriter, sequenceProvider: () => number, config?: PerformanceCapturerConfig);
+    start(): void;
+    stop(): void;
+}
+//# sourceMappingURL=performance.d.ts.map

package/dist/capturers/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/capturers/performance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,gBAAgB,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;gBAG1B,MAAM,EAAE,WAAW,EACnB,gBAAgB,EAAE,MAAM,MAAM,EAC9B,MAAM,CAAC,EAAE,yBAAyB;IAO7B,KAAK,IAAI,IAAI;IA0Cb,IAAI,IAAI,IAAI;CAWpB"}

package/dist/capturers/route-matcher.d.ts

@@ -0,0 +1,10 @@
+import type { RouteMatcher } from '../types/options';
+/**
+ * Converte um padrão de rota com wildcard (ex: '/checkout/*', '/auth/**') em RegExp.
+ */
+export declare function globToRegex(pattern: string): RegExp;
+/**
+ * Verifica se um pathname ou URL corresponde a alguma das regras de sensitiveRoutes configuradas.
+ */
+export declare function matchesSensitiveRoute(pathname: string, matchers?: RouteMatcher[]): boolean;
+//# sourceMappingURL=route-matcher.d.ts.map

package/dist/capturers/route-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-matcher.d.ts","sourceRoot":"","sources":["../../src/capturers/route-matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkBnD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,YAAY,EAAE,GACxB,OAAO,CAsCT"}

package/dist/capturers/rrweb.d.ts

@@ -0,0 +1,18 @@
+import type { BatchWriter } from '../storage/batch-writer';
+import type { PrivacyOptions } from '../types/options';
+export interface RrwebCapturerConfig {
+    privacy?: PrivacyOptions;
+    checkoutEveryNms?: number;
+}
+export declare class RrwebCapturer {
+    private writer;
+    private config;
+    private isRecording;
+    private stopRecordFn;
+    private droppedEventsCount;
+    constructor(writer: BatchWriter, config?: RrwebCapturerConfig);
+    getDroppedEventsCount(): number;
+    start(): void;
+    stop(): void;
+}
+//# sourceMappingURL=rrweb.d.ts.map

package/dist/capturers/rrweb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rrweb.d.ts","sourceRoot":"","sources":["../../src/capturers/rrweb.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,kBAAkB,CAAK;gBAEnB,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,mBAAmB;IAKtD,qBAAqB,IAAI,MAAM;IAI/B,KAAK,IAAI,IAAI;IAkFb,IAAI,IAAI,IAAI;CAapB"}

package/dist/capturers/sanitizer.d.ts

@@ -0,0 +1,37 @@
+export interface SanitizerConfig {
+    maxDepth?: number;
+    maxKeys?: number;
+    maxItems?: number;
+    maxStringLength?: number;
+    sanitizeUrlCallback?: (url: URL) => string;
+}
+/**
+ * Sanitiza uma URL conforme a seção 12.4 do SPEC.md:
+ * - Remove fragment (#...)
+ * - Preserva origin e pathname
+ * - Preserva apenas os NOMES dos query parameters (ordenados, sem valores)
+ * - Substitui UUIDs e IDs numéricos longos por :id
+ */
+export declare function sanitizeUrl(rawUrl: string, customCallback?: (url: URL) => string): string;
+/**
+ * Redige padrões reconhecíveis de segredos em texto puro.
+ */
+export declare function redactSensitiveString(str: string): string;
+/**
+ * Serializador e sanitizador universal à prova de falhas:
+ * - Detecta ciclos circulares
+ * - Limita profundidade, chaves e tamanho de strings
+ * - Redige propriedades e valores sensíveis
+ * - Suporta Error, BigInt, Function, DOM elements e primitivos
+ * - NUNCA lança exceção (operação total)
+ */
+export declare function sanitizeAndSerialize(input: unknown, config?: SanitizerConfig): unknown;
+/**
+ * Sanitiza strings de request e response body com redação de PII e teto máximo de tamanho.
+ */
+export declare function sanitizePayloadString(payload: string, maxLength?: number): string;
+/**
+ * Sanitiza headers HTTP redigindo Authorization, Cookies, Tokens e Chaves.
+ */
+export declare function sanitizeHeaders(headers: Record<string, string> | Headers | [string, string][] | undefined | null): Record<string, string> | undefined;
+//# sourceMappingURL=sanitizer.d.ts.map

package/dist/capturers/sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizer.d.ts","sourceRoot":"","sources":["../../src/capturers/sanitizer.ts"],"names":[],"mappings":"AA0CA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;CAC5C;AASD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,GAAG,MAAM,CA4BzF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAczD;AAUD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CA8HtF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB,GAAG,MAAM,CAgB5F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,SAAS,GAAG,IAAI,GAChF,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAgCpC"}

package/dist/core/flight-recorder.d.ts

@@ -0,0 +1,75 @@
+import { FlightRecorderDB } from '../storage/db';
+import type { FlightRecorder, FlightRecorderOptions, CaptureOptions, ErrorContext } from '../types/options';
+import type { RecorderHealth } from '../types/health';
+import type { IncidentSummary } from '../types/incident';
+import type { FlightRecorderArtifact } from '../types/artifact';
+export declare class FlightRecorderImpl implements FlightRecorder {
+    private static activeInstance;
+    private options;
+    private stateMachine;
+    private db;
+    private writer;
+    private retention;
+    private incidentManager;
+    private widget;
+    private consoleCapturer;
+    private errorCapturer;
+    private networkCapturer;
+    private navigationCapturer;
+    private rrwebCapturer;
+    private performanceCapturer;
+    private sequence;
+    private retentionIntervalTimer;
+    private retentionPromise;
+    private cachedStorageBytes;
+    private cachedIncidentCount;
+    private pageHideHandler?;
+    private beforeUnloadHandler?;
+    private visibilityChangeHandler?;
+    private cachedProtectedBytes;
+    private cachedBrowserEstimateBytes?;
+    private cachedBrowserQuotaBytes?;
+    constructor(options?: FlightRecorderOptions, customDb?: FlightRecorderDB);
+    static init(options?: FlightRecorderOptions, customDb?: FlightRecorderDB): Promise<FlightRecorderImpl>;
+    static hideWidget(): void;
+    static showWidget(): void;
+    static toggleWidget(): boolean;
+    static hide(): void;
+    static show(): void;
+    static toggle(): boolean;
+    static resetInstance(): Promise<void>;
+    static getInstance(): FlightRecorderImpl | null;
+    hideWidget(): void;
+    showWidget(): void;
+    toggleWidget(): boolean;
+    private nextSequence;
+    private getEnvironmentMetadata;
+    start(): Promise<void>;
+    private scheduleRetention;
+    private handleQuotaExceeded;
+    private updateStatsCache;
+    private sendIncident;
+    private stoppingPromise?;
+    private stopCapturers;
+    private clearRuntimeReferences;
+    stop(): Promise<void>;
+    capture(reason?: string, windowSeconds?: number, options?: CaptureOptions): Promise<string>;
+    captureException(error: unknown, context?: ErrorContext): Promise<string | undefined> | void;
+    listIncidents(): Promise<IncidentSummary[]>;
+    getArtifact(incidentId: string): Promise<FlightRecorderArtifact>;
+    exportIncident(incidentId: string, options?: {
+        compress?: boolean;
+        aiOptimized?: boolean;
+    }): Promise<FlightRecorderArtifact>;
+    deleteIncident(incidentId: string): Promise<void>;
+    clear(): Promise<void>;
+    getHealth(): RecorderHealth;
+    getSequence(): number;
+    flush(): Promise<void>;
+    destroy(): Promise<void>;
+}
+/**
+ * Função factory pública para instanciar o Flight Recorder.
+ */
+export declare function createFlightRecorder(options?: FlightRecorderOptions): FlightRecorder;
+//# sourceMappingURL=flight-recorder.d.ts.map

package/dist/core/flight-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flight-recorder.d.ts","sourceRoot":"","sources":["../../src/core/flight-recorder.ts"],"names":[],"mappings":"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"}

package/dist/core/state-machine.d.ts

@@ -0,0 +1,55 @@
+import type { RecorderState } from '../types/health';
+/**
+ * Eventos que causam transição de estado no Flight Recorder.
+ */
+export type RecorderTransitionEvent = {
+    type: 'START';
+} | {
+    type: 'STOP';
+} | {
+    type: 'TRIGGER_AUTO';
+} | {
+    type: 'TRIGGER_MANUAL';
+} | {
+    type: 'FINALIZE_INCIDENT';
+} | {
+    type: 'DEGRADE';
+    reason: string;
+} | {
+    type: 'RECOVER';
+};
+/**
+ * Representação da máquina de estados descrita na Seção 8 do SPEC.md:
+ *
+ * ```text
+ * stopped
+ *    │ start
+ *    ▼
+ * recording
+ *    │ trigger
+ *    ▼
+ * incident_pending
+ *    │ prazo posterior ou captura manual
+ *    ▼
+ * incident_finalized (lógico / transitório para persistência)
+ *    │ gravação contínua
+ *    └──────────────────────────────► recording
+ *
+ * qualquer estado operacional
+ *    │ falha parcial
+ *    ▼
+ * degraded
+ * ```
+ */
+export declare class RecorderStateMachine {
+    private currentState;
+    private degradedReasons;
+    private previousOperationalState;
+    constructor(initialState?: RecorderState);
+    getState(): RecorderState;
+    getDegradedReasons(): string[];
+    isDegraded(): boolean;
+    isRecording(): boolean;
+    transition(event: RecorderTransitionEvent): RecorderState;
+}
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/core/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../src/core/state-machine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,wBAAwB,CAA4B;gBAEhD,YAAY,GAAE,aAAyB;IAI5C,QAAQ,IAAI,aAAa;IAIzB,kBAAkB,IAAI,MAAM,EAAE;IAI9B,UAAU,IAAI,OAAO;IAIrB,WAAW,IAAI,OAAO;IAUtB,UAAU,CAAC,KAAK,EAAE,uBAAuB,GAAG,aAAa;CAuDjE"}