ray-logger-core 0.0.1

package/types.d.ts

@@ -0,0 +1,181 @@
+export declare const PACKAGE_NAME: "@ray-web-logger/core";
+export declare const SESSION_EXPORT_SCHEMA_VERSION: 1;
+export declare const DEFAULT_MEMORY_FLUSH_THRESHOLD_BYTES = 1048576;
+export declare const DEFAULT_RRWEB_CHECKOUT_EVERY_NMS = 30000;
+export declare const DEFAULT_INDEXED_DB_NAME = "ray-web-logger-webLogger";
+export declare const DEFAULT_SESSION_STORAGE_KEY = "__web_logger_session__";
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type SerializedValue = JsonValue | {
+    type: 'unserializable' | 'circular';
+    reason: string;
+    preview?: string;
+};
+export interface SessionExport {
+    schemaVersion: number;
+    sessionId: string;
+    persistentSessionId?: string;
+    exportedAt: string;
+    export?: {
+        kind: 'full' | 'since';
+        sinceMs?: number;
+        rrwebAnchorSeq?: number;
+        includesRrwebBaseline?: boolean;
+        replayableStandalone?: boolean;
+    };
+    events: WebLoggerEvent[];
+}
+export type WebLoggerEvent = BaseWebLoggerEvent & ({
+    type: 'console';
+    payload: ConsolePayload;
+} | {
+    type: 'error';
+    payload: ErrorPayload;
+} | {
+    type: 'network';
+    payload: NetworkPayload;
+} | {
+    type: 'rrweb';
+    payload: RrwebPayload;
+} | {
+    type: 'storage';
+    payload: StoragePayload;
+} | {
+    type: 'cookie';
+    payload: CookiePayload;
+});
+export interface BaseWebLoggerEvent {
+    sessionId: string;
+    seq: number;
+    timestamp: number;
+}
+/** 与规格 DevTools 对齐的 `console.*` 方法名；采集时写入 `ConsolePayload.level`，宿主无实现则跳过 patch。 */
+export declare const CONSOLE_CAPTURE_METHODS: readonly ["debug", "log", "info", "warn", "error", "trace", "dir", "dirxml", "table", "group", "groupCollapsed", "groupEnd", "assert", "count", "countReset", "time", "timeLog", "timeEnd"];
+export type ConsoleCaptureMethod = (typeof CONSOLE_CAPTURE_METHODS)[number];
+/**
+ * Console 的一条栈帧或可单独展示的**业务调用点**（对标 DevTools 右侧「`文件:行`」）。
+ * 字段均为可选，便于渐进 rollout、宿主差异与隐私裁剪（详见 ADR-0002）。
+ */
+export interface ConsoleStackFrame {
+    /** 展示用短名（如 URL 的 basename） */
+    file?: string;
+    /** 脚本完整 URL / 路径；敏感场景可由配置省略或哈希化 */
+    url?: string;
+    line?: number;
+    column?: number;
+    functionName?: string;
+}
+export interface ConsolePayload {
+    level: ConsoleCaptureMethod | string;
+    args: SerializedValue[];
+    /**
+     * **用户**调用 `console.*` 的**首要**定位：采集侧应跳过本 SDK patch 帧与宿主 `console` 内建帧后再取第一帧。
+     * 回放用于行内右侧主链（对标 Chrome）。
+     */
+    callSite?: ConsoleStackFrame;
+    /** 原始栈字符串；如 `console.trace()`、或未解析为多帧时的兜底 */
+    stack?: string;
+    /** 结构化多帧；`trace` 等可整表展示；`callSite` 可与 `stackFrames[0]` 对齐或单独给出 */
+    stackFrames?: ConsoleStackFrame[];
+}
+export interface ErrorPayload {
+    message: string;
+    stack?: string;
+    source?: string;
+}
+export type NetworkPayload = NetworkPayloadSuccess | NetworkPayloadFailed;
+export interface NetworkPayloadBase {
+    url: string;
+    method: string;
+    durationMs?: number;
+    bodySkippedReason?: string;
+}
+export interface NetworkPayloadSuccess extends NetworkPayloadBase {
+    outcome: 'success';
+    status: number;
+    durationMs: number;
+    requestHeaders?: Record<string, string>;
+    responseHeaders?: Record<string, string>;
+    requestBody?: string | null;
+    responseBody?: string | null;
+}
+export interface NetworkPayloadFailed extends NetworkPayloadBase {
+    outcome: 'failed';
+    error: {
+        message: string;
+        name?: string;
+        code?: string | number;
+    };
+}
+/**
+ * 与 rrweb@2.0.0-alpha.20 对齐的最小事件子集。
+ * 保留原生 data 字段，不在 core 中改写 rrweb 事件语义。
+ */
+export interface RrwebEvent {
+    type: number;
+    timestamp: number;
+    data?: unknown;
+}
+export interface RrwebPayload {
+    rrwebEvent: RrwebEvent;
+}
+export interface StoragePayload {
+    area: 'local' | 'session';
+    op: 'set' | 'remove' | 'clear' | 'snapshot' | string;
+    key?: string;
+    value?: string | null;
+    entries?: Record<string, string>;
+    skipped?: StorageSnapshotSkippedItem[];
+}
+export interface CookiePayload {
+    name?: string;
+    value?: string;
+    op: 'set' | 'delete' | 'snapshot' | string;
+    domain?: string;
+    expires?: string;
+    maxAge?: string;
+    cookies?: CookieSnapshotItem[];
+    skipped?: CookieSnapshotSkippedItem[];
+}
+export interface StorageSnapshotSkippedItem {
+    key: string;
+    reason: 'disallowed' | string;
+}
+export interface CookieSnapshotItem {
+    name: string;
+    value: string;
+}
+export interface CookieSnapshotSkippedItem {
+    name: string;
+    reason: 'disallowed' | string;
+}
+export interface WebLoggerConfig {
+    enableRecordResponseBody?: boolean;
+    enableRecordRequestBody?: boolean;
+    disallowRecordSearches?: string[];
+    enableRecordRequestHeaders?: boolean;
+    enableRecordResponseHeaders?: boolean;
+    disallowRecordRequestHeaders?: string[];
+    disallowRecordResponseHeaders?: string[];
+    disallowRecordStorageKeys?: string[];
+    disallowRecordCookieKeys?: string[];
+    memoryFlushThresholdBytes?: number;
+    sessionStorageKey?: string;
+    recordConsoleCallSite?: boolean;
+    rrwebCheckoutEveryNms?: number;
+}
+export interface WebLoggerController {
+    readonly sessionId: string;
+    readonly persistentSessionId?: string;
+    record(event: NewWebLoggerEvent): WebLoggerEvent;
+    flushToIdb(): Promise<void>;
+    exportFull(): Promise<SessionExport>;
+    exportSince(sinceMs: number): Promise<SessionExport>;
+    destroy(): void;
+}
+export type NewWebLoggerEvent = Omit<WebLoggerEvent, 'sessionId' | 'seq' | 'timestamp'> & {
+    timestamp?: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/types.d.ts.map

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

package/types.js

@@ -0,0 +1,28 @@
+export const PACKAGE_NAME = '@ray-web-logger/core';
+export const SESSION_EXPORT_SCHEMA_VERSION = 1;
+export const DEFAULT_MEMORY_FLUSH_THRESHOLD_BYTES = 1_048_576;
+export const DEFAULT_RRWEB_CHECKOUT_EVERY_NMS = 30_000;
+export const DEFAULT_INDEXED_DB_NAME = 'ray-web-logger-webLogger';
+export const DEFAULT_SESSION_STORAGE_KEY = '__web_logger_session__';
+/** 与规格 DevTools 对齐的 `console.*` 方法名；采集时写入 `ConsolePayload.level`，宿主无实现则跳过 patch。 */
+export const CONSOLE_CAPTURE_METHODS = [
+    'debug',
+    'log',
+    'info',
+    'warn',
+    'error',
+    'trace',
+    'dir',
+    'dirxml',
+    'table',
+    'group',
+    'groupCollapsed',
+    'groupEnd',
+    'assert',
+    'count',
+    'countReset',
+    'time',
+    'timeLog',
+    'timeEnd',
+];
+//# sourceMappingURL=types.js.map

package/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,sBAA+B,CAAC;AAC5D,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAU,CAAC;AACxD,MAAM,CAAC,MAAM,oCAAoC,GAAG,SAAS,CAAC;AAC9D,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAC;AACvD,MAAM,CAAC,MAAM,uBAAuB,GAAG,0BAA0B,CAAC;AAClE,MAAM,CAAC,MAAM,2BAA2B,GAAG,wBAAwB,CAAC;AA4CpE,oFAAoF;AACpF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,OAAO;IACP,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,KAAK;IACL,QAAQ;IACR,OAAO;IACP,OAAO;IACP,gBAAgB;IAChB,UAAU;IACV,QAAQ;IACR,OAAO;IACP,YAAY;IACZ,MAAM;IACN,SAAS;IACT,SAAS;CACD,CAAC"}

package/utils/console-stack.d.ts

@@ -0,0 +1,12 @@
+import type { ConsoleCaptureMethod, ConsoleStackFrame } from '../types';
+export interface ConsoleStackCaptureOptions {
+    stack: string | undefined;
+    method: ConsoleCaptureMethod;
+}
+/** 从同步 `new Error().stack` 推导 `ConsolePayload` 中与调用位置相关的可选字段（非 trace 不写 `stack/stackFrames`，控制体积）。 */
+export declare function deriveConsoleLocationFields(options: ConsoleStackCaptureOptions): {
+    callSite?: ConsoleStackFrame;
+    stack?: string;
+    stackFrames?: ConsoleStackFrame[];
+};
+//# sourceMappingURL=console-stack.d.ts.map

package/utils/console-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-stack.d.ts","sourceRoot":"","sources":["../../src/utils/console-stack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAexE,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,sGAAsG;AACtG,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,0BAA0B,GAAG;IAChF,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACnC,CAkCA"}

package/utils/console-stack.js

@@ -0,0 +1,141 @@
+/** Collector 与其它 web-logger 内部帧需在展示前跳过 */
+const INTERNAL_STACK_MARKERS = [
+    '/collectors/console',
+    '\\collectors\\console',
+    'collectors/console.ts',
+    'collectors\\console.ts',
+    'collectors/console.js',
+    'collectors\\console.js',
+    '@ray-web-logger/core',
+    'packages/core/src/collectors/console',
+    'packages\\core\\src\\collectors\\console',
+];
+/** 从同步 `new Error().stack` 推导 `ConsolePayload` 中与调用位置相关的可选字段（非 trace 不写 `stack/stackFrames`，控制体积）。 */
+export function deriveConsoleLocationFields(options) {
+    const { stack, method } = options;
+    if (!stack?.trim()) {
+        return {};
+    }
+    const rawLines = splitStackLines(stack);
+    const parsedFrames = [];
+    for (const raw of rawLines) {
+        if (!raw.trim()) {
+            continue;
+        }
+        const frame = parseStackLine(raw);
+        if (frame.url !== undefined || frame.line !== undefined || frame.file !== undefined) {
+            parsedFrames.push({ raw, frame });
+        }
+    }
+    const userFrames = dropInternalPrefix(parsedFrames);
+    if (userFrames.length === 0) {
+        return method === 'trace' ? { stack } : {};
+    }
+    const callSite = normalizeFrame(userFrames[0].frame);
+    if (method !== 'trace') {
+        return { callSite };
+    }
+    return {
+        callSite,
+        stack,
+        stackFrames: userFrames.map((f) => normalizeFrame(f.frame)),
+    };
+}
+function splitStackLines(stack) {
+    return stack.split(/\r?\n/);
+}
+function parseStackLine(line) {
+    const trimmed = line.trim();
+    const ff = /^(.+?)@(.+):(\d+):(\d+)$/.exec(trimmed);
+    if (ff && !trimmed.startsWith('at ')) {
+        const url = ff[2];
+        return {
+            functionName: ff[1] || undefined,
+            url,
+            line: Number(ff[3]),
+            column: Number(ff[4]),
+            file: basenameFromUrl(url),
+        };
+    }
+    const parenOpen = trimmed.lastIndexOf('(');
+    const parenClose = trimmed.lastIndexOf(')');
+    if (trimmed.startsWith('at ') && parenOpen !== -1 && parenClose > parenOpen) {
+        const inside = trimmed.slice(parenOpen + 1, parenClose);
+        const loc = parseUrlLineColumn(inside);
+        if (loc) {
+            const head = trimmed.slice(3, parenOpen).trim();
+            return {
+                functionName: head || undefined,
+                url: loc.url,
+                line: loc.line,
+                column: loc.column,
+                file: basenameFromUrl(loc.url),
+            };
+        }
+    }
+    if (trimmed.startsWith('at ')) {
+        const rest = trimmed.slice(3).trim();
+        const loc = parseUrlLineColumn(rest);
+        if (loc) {
+            return {
+                url: loc.url,
+                line: loc.line,
+                column: loc.column,
+                file: basenameFromUrl(loc.url),
+            };
+        }
+    }
+    return {};
+}
+function parseUrlLineColumn(s) {
+    const m = /^(.*):(\d+):(\d+)$/.exec(s);
+    if (!m) {
+        return undefined;
+    }
+    return { url: m[1], line: Number(m[2]), column: Number(m[3]) };
+}
+function basenameFromUrl(url) {
+    const trimmed = url.trim();
+    if (!trimmed || trimmed === '(native)') {
+        return undefined;
+    }
+    try {
+        const u = new URL(trimmed);
+        const seg = u.pathname.split('/').filter(Boolean);
+        return seg[seg.length - 1] || trimmed;
+    }
+    catch {
+        const parts = trimmed.split(/[/\\]/);
+        const last = parts[parts.length - 1];
+        return last || trimmed;
+    }
+}
+function isInternalFrame(raw, frame) {
+    if (raw.includes('(native)')) {
+        return true;
+    }
+    const blob = `${raw} ${frame.url ?? ''}`;
+    for (const marker of INTERNAL_STACK_MARKERS) {
+        if (blob.includes(marker)) {
+            return true;
+        }
+    }
+    return false;
+}
+function dropInternalPrefix(frames) {
+    let i = 0;
+    while (i < frames.length && isInternalFrame(frames[i].raw, frames[i].frame)) {
+        i += 1;
+    }
+    return frames.slice(i);
+}
+function normalizeFrame(frame) {
+    const url = frame.url;
+    const file = frame.file ?? (url ? basenameFromUrl(url) : undefined);
+    return {
+        ...frame,
+        file,
+        ...(url ? { url } : {}),
+    };
+}
+//# sourceMappingURL=console-stack.js.map

package/utils/console-stack.js.map

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

package/utils/serialize.d.ts

@@ -0,0 +1,4 @@
+import type { SerializedValue } from '../types';
+export declare function serializeValue(value: unknown): SerializedValue;
+export declare function serializeArgs(args: readonly unknown[]): SerializedValue[];
+//# sourceMappingURL=serialize.d.ts.map

package/utils/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/utils/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,eAAe,EAAE,MAAM,UAAU,CAAC;AAM3D,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAE9D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,eAAe,EAAE,CAEzE"}

package/utils/serialize.js

@@ -0,0 +1,57 @@
+const MAX_DEPTH = 5;
+const MAX_ARRAY_ITEMS = 50;
+const MAX_OBJECT_KEYS = 50;
+export function serializeValue(value) {
+    return serializeUnknown(value, new WeakSet(), 0);
+}
+export function serializeArgs(args) {
+    return args.map((arg) => serializeValue(arg));
+}
+function serializeUnknown(value, seen, depth) {
+    if (value === null ||
+        typeof value === 'string' ||
+        typeof value === 'number' ||
+        typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'undefined') {
+        return { type: 'unserializable', reason: 'undefined' };
+    }
+    if (typeof value === 'bigint') {
+        return { type: 'unserializable', reason: 'bigint', preview: value.toString() };
+    }
+    if (typeof value === 'symbol' || typeof value === 'function') {
+        return { type: 'unserializable', reason: typeof value, preview: String(value) };
+    }
+    if (depth >= MAX_DEPTH) {
+        return { type: 'unserializable', reason: 'max-depth', preview: previewValue(value) };
+    }
+    if (seen.has(value)) {
+        return { type: 'circular', reason: 'circular-reference', preview: previewValue(value) };
+    }
+    seen.add(value);
+    if (value instanceof Error) {
+        return {
+            name: value.name,
+            message: value.message,
+            stack: value.stack ?? null,
+        };
+    }
+    if (Array.isArray(value)) {
+        return value.slice(0, MAX_ARRAY_ITEMS).map((item) => serializeUnknown(item, seen, depth + 1));
+    }
+    const result = {};
+    for (const key of Object.keys(value).slice(0, MAX_OBJECT_KEYS)) {
+        result[key] = serializeUnknown(value[key], seen, depth + 1);
+    }
+    return result;
+}
+function previewValue(value) {
+    try {
+        return String(value);
+    }
+    catch {
+        return Object.prototype.toString.call(value);
+    }
+}
+//# sourceMappingURL=serialize.js.map

package/utils/serialize.js.map

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