@backtrack-js/browser 0.4.0

package/dist/types/timeline.d.ts

@@ -0,0 +1,74 @@
+export type TimelineEventType = 'console' | 'error' | 'network' | 'navigation' | 'marker' | 'performance';
+export interface TimelineEventBase {
+    id: string;
+    timestamp: number;
+    sequence: number;
+    type: TimelineEventType;
+}
+export type ConsoleLogLevel = 'log' | 'warn' | 'error';
+export interface ConsoleTimelineEvent extends TimelineEventBase {
+    type: 'console';
+    level: ConsoleLogLevel;
+    args: unknown[];
+}
+export type ErrorSource = 'window' | 'unhandledrejection' | 'react' | 'manual';
+export interface SourceCodeContext {
+    before: string[];
+    line: string;
+    after: string[];
+}
+export interface ResolvedStackFrame {
+    generatedFile: string;
+    generatedLine: number;
+    generatedColumn: number;
+    sourceFile?: string;
+    sourceLine?: number;
+    sourceColumn?: number;
+    functionName?: string;
+    context?: SourceCodeContext;
+}
+export interface ErrorTimelineEvent extends TimelineEventBase {
+    type: 'error';
+    name: string;
+    message: string;
+    stack?: string;
+    filename?: string;
+    lineno?: number;
+    colno?: number;
+    source: ErrorSource;
+    componentStack?: string;
+    resolvedStack?: ResolvedStackFrame[];
+}
+export type NetworkResult = 'success' | 'error' | 'timeout' | 'abort';
+export interface NetworkTimelineEvent extends TimelineEventBase {
+    type: 'network';
+    method: string;
+    url: string;
+    status: number;
+    durationMs: number;
+    result: NetworkResult;
+    requestHeaders?: Record<string, string>;
+    requestBody?: string;
+    responseHeaders?: Record<string, string>;
+    responseBody?: string;
+}
+export type NavigationKind = 'initial' | 'pushState' | 'replaceState' | 'popstate' | 'hashchange';
+export interface NavigationTimelineEvent extends TimelineEventBase {
+    type: 'navigation';
+    fromUrl?: string;
+    toUrl: string;
+    kind: NavigationKind;
+}
+export interface MarkerTimelineEvent extends TimelineEventBase {
+    type: 'marker';
+    label: string;
+    data?: Record<string, unknown>;
+}
+export interface PerformanceTimelineEvent extends TimelineEventBase {
+    type: 'performance';
+    metric: 'longtask' | 'fps_drop';
+    durationMs: number;
+    details?: string;
+}
+export type TimelineEvent = ConsoleTimelineEvent | ErrorTimelineEvent | NetworkTimelineEvent | NavigationTimelineEvent | MarkerTimelineEvent | PerformanceTimelineEvent;
+//# sourceMappingURL=timeline.d.ts.map

package/dist/types/timeline.d.ts.map

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

package/dist/types/transport.d.ts

@@ -0,0 +1,6 @@
+import type { FlightRecorderArtifact } from './artifact';
+export interface BacktrackTransport {
+    send(artifact: FlightRecorderArtifact): Promise<void>;
+}
+export type BeforeSend = (artifact: FlightRecorderArtifact) => FlightRecorderArtifact | null | Promise<FlightRecorderArtifact | null>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/types/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/types/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED,MAAM,MAAM,UAAU,GAAG,CACvB,QAAQ,EAAE,sBAAsB,KAE9B,sBAAsB,GACtB,IAAI,GACJ,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC"}

package/dist/utils/compression.d.ts

@@ -0,0 +1,28 @@
+import type { FlightRecorderArtifact } from '../types/artifact';
+export declare const MAX_ARTIFACT_BYTES: number;
+/** Cancels the producer as soon as the accumulated bytes exceed the limit. */
+export declare function readLimitedStream(stream: ReadableStream<Uint8Array>, limit?: number): Promise<Uint8Array>;
+export declare function readResponseBytes(response: Response, limit?: number): Promise<Uint8Array>;
+/**
+ * Verifica se os bytes contêm o número mágico do cabeçalho Gzip (0x1f, 0x8b).
+ */
+export declare function isGzip(bytes: Uint8Array): boolean;
+/**
+ * Comprime uma string UTF-8 ou Uint8Array utilizando CompressionStream('gzip') nativo.
+ */
+export declare function compressGzip(data: string | Uint8Array): Promise<Uint8Array>;
+/**
+ * Descompacta bytes Gzip para string UTF-8 utilizando DecompressionStream('gzip') nativo.
+ * Se os bytes não forem Gzip, decodifica diretamente como UTF-8.
+ */
+export declare function decompressGzip(data: Uint8Array, limit?: number): Promise<string>;
+/**
+ * Serializa um artefato canônico v1 e comprime com Gzip nativo.
+ */
+export declare function compressArtifact(artifact: FlightRecorderArtifact): Promise<Uint8Array>;
+/**
+ * Descompacta e valida um artefato a partir de ArrayBuffer, Uint8Array ou string.
+ * Suporta transparentemente tanto arquivos compactados (.gz) quanto JSON comum.
+ */
+export declare function decompressArtifact(data: ArrayBuffer | Uint8Array | string | unknown, limit?: number): Promise<FlightRecorderArtifact>;
+//# sourceMappingURL=compression.d.ts.map

package/dist/utils/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../src/utils/compression.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AAMnD,8EAA8E;AAC9E,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAAE,KAAK,SAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsB3H;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,SAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CA6B3G;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAajF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,SAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAalG;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAG5F;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,EACjD,KAAK,SAAqB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CAsCjC"}

package/dist/utils/gist-uploader.d.ts

@@ -0,0 +1,12 @@
+import type { FlightRecorderArtifact } from '../types/artifact';
+export interface GistUploadResult {
+    gistId: string;
+    gistUrl: string;
+    rawUrl: string;
+}
+/**
+ * Faz o upload de um artefato .ffr.json como um Gist Secreto no GitHub.
+ * Requer um Personal Access Token com o escopo 'gist'.
+ */
+export declare function uploadArtifactToGist(artifact: FlightRecorderArtifact, githubToken: string): Promise<GistUploadResult>;
+//# sourceMappingURL=gist-uploader.d.ts.map

package/dist/utils/gist-uploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gist-uploader.d.ts","sourceRoot":"","sources":["../../src/utils/gist-uploader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,sBAAsB,EAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CA6D3B"}

package/dist/utils/markdown.d.ts

@@ -0,0 +1,12 @@
+import type { FlightRecorderArtifact } from '../types/artifact';
+export interface MarkdownFormatOptions {
+    replayUrl?: string;
+    maxBreadcrumbs?: number;
+}
+/**
+ * Gera um resumo formatado em Markdown para debug (estilo Sentry)
+ * pronto para ser colado em IAs (Gemini, Claude, ChatGPT), Jira ou GitHub Issues.
+ * Sem emojis, com breadcrumbs, stack traces e contexto completo.
+ */
+export declare function formatIncidentMarkdown(artifact: FlightRecorderArtifact, options?: MarkdownFormatOptions): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/utils/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAQhE,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAWD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,sBAAsB,EAChC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,CAsLR"}

package/dist/validation/validate.d.ts

@@ -0,0 +1,27 @@
+import type { FlightRecorderArtifact, TimelineEvent } from '../types';
+export interface ValidationSuccess {
+    success: true;
+    data: FlightRecorderArtifact;
+}
+export interface ValidationFailure {
+    success: false;
+    errors: string[];
+}
+export type ValidationResult = ValidationSuccess | ValidationFailure;
+/**
+ * Valida se annotationImage é estritamente uma imagem data:base64 segura (png, jpeg ou webp),
+ * rejeitando http:, https:, javascript:, file: e payloads acima de 10 MB.
+ */
+export declare function isValidAnnotationImage(value: unknown): value is string;
+/** Validates the envelope and the minimum rrweb payload before handing it to the player. */
+export declare function isReplayEvent(value: unknown): boolean;
+/**
+ * Valida a integridade e o schema de um artefato .ffr.json do Flight Recorder.
+ * Rejeita formatos incompatíveis, campos ausentes ou tipos inválidos.
+ */
+export declare function validateFlightRecorderArtifact(input: unknown): ValidationResult;
+/**
+ * Ordena eventos da timeline por timestamp crescente e sequence crescente.
+ */
+export declare function sortTimelineEvents(events: TimelineEvent[]): TimelineEvent[];
+//# sourceMappingURL=validate.d.ts.map

package/dist/validation/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/validation/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EAEtB,aAAa,EAEd,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,sBAAsB,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AA0BrE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAQtE;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA4BrD;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAyf/E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAO3E"}