@fudanda/client 2.20261024.1-beta.1 → 2.20261024.1-beta.2

package/dist/shared/analytics/contracts/session-replays.d.ts

@@ -0,0 +1,536 @@
+import * as z from 'zod';
+export declare const replaySessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    mode: z.ZodEnum<{
+        buffer: "buffer";
+        stream: "stream";
+    }>;
+    status: z.ZodEnum<{
+        completed: "completed";
+        expired: "expired";
+        recording: "recording";
+    }>;
+    triggers: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            error: "error";
+            manual: "manual";
+            rage_click: "rage_click";
+            sampled: "sampled";
+            white_screen: "white_screen";
+        }>;
+        at: z.ZodString;
+        refId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    startedAt: z.ZodString;
+    lastActivityAt: z.ZodString;
+    endedAt: z.ZodNullable<z.ZodString>;
+    durationMs: z.ZodInt;
+    segmentCount: z.ZodInt;
+    totalBytes: z.ZodInt;
+    errorCount: z.ZodInt;
+    pageCount: z.ZodInt;
+    clickCount: z.ZodInt;
+    pagePaths: z.ZodArray<z.ZodString>;
+    clickLabels: z.ZodArray<z.ZodString>;
+    entryPageUrl: z.ZodNullable<z.ZodString>;
+    source: z.ZodEnum<{
+        server: "server";
+        web_admin: "web_admin";
+        web_member: "web_member";
+    }>;
+    appId: z.ZodString;
+    environment: z.ZodEnum<{
+        development: "development";
+        production: "production";
+        staging: "staging";
+    }>;
+    userId: z.ZodNullable<z.ZodInt>;
+    username: z.ZodNullable<z.ZodString>;
+    memberId: z.ZodNullable<z.ZodInt>;
+    browser: z.ZodNullable<z.ZodString>;
+    os: z.ZodNullable<z.ZodString>;
+    deviceType: z.ZodNullable<z.ZodEnum<{
+        bot: "bot";
+        desktop: "desktop";
+        mobile: "mobile";
+        tablet: "tablet";
+        unknown: "unknown";
+    }>>;
+    sdkVersion: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type ReplaySession = z.infer<typeof replaySessionSchema>;
+export declare const replaySegmentMetaSchema: z.ZodObject<{
+    id: z.ZodInt;
+    replayId: z.ZodString;
+    seq: z.ZodInt;
+    fromTs: z.ZodString;
+    toTs: z.ZodString;
+    byteSize: z.ZodInt;
+    eventCount: z.ZodInt;
+    hasFullSnapshot: z.ZodBoolean;
+}, z.core.$strip>;
+export type ReplaySegmentMeta = z.infer<typeof replaySegmentMetaSchema>;
+export declare const replaySessionDetailSchema: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    mode: z.ZodEnum<{
+        buffer: "buffer";
+        stream: "stream";
+    }>;
+    status: z.ZodEnum<{
+        completed: "completed";
+        expired: "expired";
+        recording: "recording";
+    }>;
+    triggers: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            error: "error";
+            manual: "manual";
+            rage_click: "rage_click";
+            sampled: "sampled";
+            white_screen: "white_screen";
+        }>;
+        at: z.ZodString;
+        refId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    startedAt: z.ZodString;
+    lastActivityAt: z.ZodString;
+    endedAt: z.ZodNullable<z.ZodString>;
+    durationMs: z.ZodInt;
+    segmentCount: z.ZodInt;
+    totalBytes: z.ZodInt;
+    errorCount: z.ZodInt;
+    pageCount: z.ZodInt;
+    clickCount: z.ZodInt;
+    pagePaths: z.ZodArray<z.ZodString>;
+    clickLabels: z.ZodArray<z.ZodString>;
+    entryPageUrl: z.ZodNullable<z.ZodString>;
+    source: z.ZodEnum<{
+        server: "server";
+        web_admin: "web_admin";
+        web_member: "web_member";
+    }>;
+    appId: z.ZodString;
+    environment: z.ZodEnum<{
+        development: "development";
+        production: "production";
+        staging: "staging";
+    }>;
+    userId: z.ZodNullable<z.ZodInt>;
+    username: z.ZodNullable<z.ZodString>;
+    memberId: z.ZodNullable<z.ZodInt>;
+    browser: z.ZodNullable<z.ZodString>;
+    os: z.ZodNullable<z.ZodString>;
+    deviceType: z.ZodNullable<z.ZodEnum<{
+        bot: "bot";
+        desktop: "desktop";
+        mobile: "mobile";
+        tablet: "tablet";
+        unknown: "unknown";
+    }>>;
+    sdkVersion: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    segments: z.ZodArray<z.ZodObject<{
+        id: z.ZodInt;
+        replayId: z.ZodString;
+        seq: z.ZodInt;
+        fromTs: z.ZodString;
+        toTs: z.ZodString;
+        byteSize: z.ZodInt;
+        eventCount: z.ZodInt;
+        hasFullSnapshot: z.ZodBoolean;
+    }, z.core.$strip>>;
+    errors: z.ZodArray<z.ZodObject<{
+        id: z.ZodInt;
+        groupId: z.ZodInt;
+        errorType: z.ZodEnum<{
+            console_error: "console_error";
+            crash: "crash";
+            cron_failure: "cron_failure";
+            event_failure: "event_failure";
+            http_error: "http_error";
+            job_failure: "job_failure";
+            js_error: "js_error";
+            logged_error: "logged_error";
+            process_crash: "process_crash";
+            promise_rejection: "promise_rejection";
+            resource_error: "resource_error";
+            server_exception: "server_exception";
+            white_screen: "white_screen";
+        }>;
+        level: z.ZodEnum<{
+            error: "error";
+            fatal: "fatal";
+            info: "info";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    perfEvents: z.ZodArray<z.ZodObject<{
+        metricName: z.ZodString;
+        metricValue: z.ZodNumber;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    siblings: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            expired: "expired";
+            recording: "recording";
+        }>;
+        startedAt: z.ZodString;
+        durationMs: z.ZodInt;
+        errorCount: z.ZodInt;
+        entryPageUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ReplaySessionDetail = z.infer<typeof replaySessionDetailSchema>;
+export declare const replayStorageStatsSchema: z.ZodObject<{
+    totalBytes: z.ZodNumber;
+    totalCount: z.ZodInt;
+    todayBytes: z.ZodNumber;
+    todayCount: z.ZodInt;
+    quotaMb: z.ZodInt;
+    usagePercent: z.ZodNumber;
+}, z.core.$strip>;
+export type ReplayStorageStats = z.infer<typeof replayStorageStatsSchema>;
+export declare const replayClickHeatmapSchema: z.ZodObject<{
+    points: z.ZodArray<z.ZodObject<{
+        x: z.ZodInt;
+        y: z.ZodInt;
+        count: z.ZodInt;
+    }, z.core.$strip>>;
+    total: z.ZodInt;
+}, z.core.$strip>;
+export type ReplayClickHeatmap = z.infer<typeof replayClickHeatmapSchema>;
+export declare const replayAccessLogSchema: z.ZodObject<{
+    id: z.ZodInt;
+    replayId: z.ZodString;
+    replayOwner: z.ZodNullable<z.ZodString>;
+    userId: z.ZodInt;
+    username: z.ZodNullable<z.ZodString>;
+    action: z.ZodString;
+    ip: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type ReplayAccessLog = z.infer<typeof replayAccessLogSchema>;
+export declare const replayIdParam: z.ZodObject<{
+    id: z.ZodUUID;
+}, z.core.$strip>;
+export declare const replaySegmentParam: z.ZodObject<{
+    id: z.ZodUUID;
+    seq: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+export declare const replayListQuery: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    status: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodLiteral<"">, z.ZodTransform<undefined, "">>, z.ZodEnum<{
+        completed: "completed";
+        expired: "expired";
+        recording: "recording";
+    }>]>>;
+    mode: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodLiteral<"">, z.ZodTransform<undefined, "">>, z.ZodEnum<{
+        buffer: "buffer";
+        stream: "stream";
+    }>]>>;
+    triggerType: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodLiteral<"">, z.ZodTransform<undefined, "">>, z.ZodEnum<{
+        error: "error";
+        manual: "manual";
+        rage_click: "rage_click";
+        sampled: "sampled";
+        white_screen: "white_screen";
+    }>]>>;
+    keyword: z.ZodOptional<z.ZodString>;
+    hasError: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodLiteral<"">, z.ZodTransform<undefined, "">>, z.ZodCodec<z.ZodString, z.ZodBoolean>]>>;
+    source: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodLiteral<"">, z.ZodTransform<undefined, "">>, z.ZodEnum<{
+        web_admin: "web_admin";
+        web_member: "web_member";
+    }>]>>;
+    pagePath: z.ZodOptional<z.ZodString>;
+    clickLabel: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const replayHeatmapPagesQuery: z.ZodObject<{
+    days: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export declare const replayHeatmapQuery: z.ZodObject<{
+    pagePath: z.ZodString;
+    days: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export declare const replayAccessLogListQuery: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    replayId: z.ZodOptional<z.ZodUUID>;
+    keyword: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const replayIdsBody: z.ZodObject<{
+    ids: z.ZodArray<z.ZodUUID>;
+}, z.core.$strip>;
+export declare const sessionReplayContract: import("../../core/contract.js").Contract<{
+    readonly ingestSegment: import("../../core/contract.js").UnboundOperation<"post", "/segments", undefined, undefined, import("../../core/contract.js").MultipartBody<z.ZodObject<{
+        meta: z.ZodString;
+        data: z.ZodUnknown;
+    }, z.core.$strip>>, z.ZodNull, "json", undefined>;
+    readonly list: import("../../core/contract.js").UnboundOperation<"get", "/", undefined, z.ZodObject<{
+        page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        status: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodLiteral<"">, z.ZodTransform<undefined, "">>, z.ZodEnum<{
+            completed: "completed";
+            expired: "expired";
+            recording: "recording";
+        }>]>>;
+        mode: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodLiteral<"">, z.ZodTransform<undefined, "">>, z.ZodEnum<{
+            buffer: "buffer";
+            stream: "stream";
+        }>]>>;
+        triggerType: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodLiteral<"">, z.ZodTransform<undefined, "">>, z.ZodEnum<{
+            error: "error";
+            manual: "manual";
+            rage_click: "rage_click";
+            sampled: "sampled";
+            white_screen: "white_screen";
+        }>]>>;
+        keyword: z.ZodOptional<z.ZodString>;
+        hasError: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodLiteral<"">, z.ZodTransform<undefined, "">>, z.ZodCodec<z.ZodString, z.ZodBoolean>]>>;
+        source: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodLiteral<"">, z.ZodTransform<undefined, "">>, z.ZodEnum<{
+            web_admin: "web_admin";
+            web_member: "web_member";
+        }>]>>;
+        pagePath: z.ZodOptional<z.ZodString>;
+        clickLabel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, undefined, z.ZodObject<{
+        list: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            sessionId: z.ZodString;
+            mode: z.ZodEnum<{
+                buffer: "buffer";
+                stream: "stream";
+            }>;
+            status: z.ZodEnum<{
+                completed: "completed";
+                expired: "expired";
+                recording: "recording";
+            }>;
+            triggers: z.ZodArray<z.ZodObject<{
+                type: z.ZodEnum<{
+                    error: "error";
+                    manual: "manual";
+                    rage_click: "rage_click";
+                    sampled: "sampled";
+                    white_screen: "white_screen";
+                }>;
+                at: z.ZodString;
+                refId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            startedAt: z.ZodString;
+            lastActivityAt: z.ZodString;
+            endedAt: z.ZodNullable<z.ZodString>;
+            durationMs: z.ZodInt;
+            segmentCount: z.ZodInt;
+            totalBytes: z.ZodInt;
+            errorCount: z.ZodInt;
+            pageCount: z.ZodInt;
+            clickCount: z.ZodInt;
+            pagePaths: z.ZodArray<z.ZodString>;
+            clickLabels: z.ZodArray<z.ZodString>;
+            entryPageUrl: z.ZodNullable<z.ZodString>;
+            source: z.ZodEnum<{
+                server: "server";
+                web_admin: "web_admin";
+                web_member: "web_member";
+            }>;
+            appId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                production: "production";
+                staging: "staging";
+            }>;
+            userId: z.ZodNullable<z.ZodInt>;
+            username: z.ZodNullable<z.ZodString>;
+            memberId: z.ZodNullable<z.ZodInt>;
+            browser: z.ZodNullable<z.ZodString>;
+            os: z.ZodNullable<z.ZodString>;
+            deviceType: z.ZodNullable<z.ZodEnum<{
+                bot: "bot";
+                desktop: "desktop";
+                mobile: "mobile";
+                tablet: "tablet";
+                unknown: "unknown";
+            }>>;
+            sdkVersion: z.ZodNullable<z.ZodString>;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+        total: z.ZodInt;
+        page: z.ZodInt;
+        pageSize: z.ZodInt;
+    }, z.core.$strip>, "json", undefined>;
+    readonly stats: import("../../core/contract.js").UnboundOperation<"get", "/stats", undefined, undefined, undefined, z.ZodObject<{
+        totalBytes: z.ZodNumber;
+        totalCount: z.ZodInt;
+        todayBytes: z.ZodNumber;
+        todayCount: z.ZodInt;
+        quotaMb: z.ZodInt;
+        usagePercent: z.ZodNumber;
+    }, z.core.$strip>, "json", undefined>;
+    readonly heatmapPages: import("../../core/contract.js").UnboundOperation<"get", "/heatmap/pages", undefined, z.ZodObject<{
+        days: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>, undefined, z.ZodArray<z.ZodString>, "json", undefined>;
+    readonly heatmap: import("../../core/contract.js").UnboundOperation<"get", "/heatmap", undefined, z.ZodObject<{
+        pagePath: z.ZodString;
+        days: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>, undefined, z.ZodObject<{
+        points: z.ZodArray<z.ZodObject<{
+            x: z.ZodInt;
+            y: z.ZodInt;
+            count: z.ZodInt;
+        }, z.core.$strip>>;
+        total: z.ZodInt;
+    }, z.core.$strip>, "json", undefined>;
+    readonly accessLogs: import("../../core/contract.js").UnboundOperation<"get", "/access-logs", undefined, z.ZodObject<{
+        page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        replayId: z.ZodOptional<z.ZodUUID>;
+        keyword: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, undefined, z.ZodObject<{
+        list: z.ZodArray<z.ZodObject<{
+            id: z.ZodInt;
+            replayId: z.ZodString;
+            replayOwner: z.ZodNullable<z.ZodString>;
+            userId: z.ZodInt;
+            username: z.ZodNullable<z.ZodString>;
+            action: z.ZodString;
+            ip: z.ZodNullable<z.ZodString>;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+        total: z.ZodInt;
+        page: z.ZodInt;
+        pageSize: z.ZodInt;
+    }, z.core.$strip>, "json", undefined>;
+    readonly removeBatch: import("../../core/contract.js").UnboundOperation<"delete", "/batch", undefined, undefined, z.ZodObject<{
+        ids: z.ZodArray<z.ZodUUID>;
+    }, z.core.$strip>, z.ZodNull, "json", undefined>;
+    readonly detail: import("../../core/contract.js").UnboundOperation<"get", "/{id}", z.ZodObject<{
+        id: z.ZodUUID;
+    }, z.core.$strip>, undefined, undefined, z.ZodObject<{
+        id: z.ZodString;
+        sessionId: z.ZodString;
+        mode: z.ZodEnum<{
+            buffer: "buffer";
+            stream: "stream";
+        }>;
+        status: z.ZodEnum<{
+            completed: "completed";
+            expired: "expired";
+            recording: "recording";
+        }>;
+        triggers: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                error: "error";
+                manual: "manual";
+                rage_click: "rage_click";
+                sampled: "sampled";
+                white_screen: "white_screen";
+            }>;
+            at: z.ZodString;
+            refId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        startedAt: z.ZodString;
+        lastActivityAt: z.ZodString;
+        endedAt: z.ZodNullable<z.ZodString>;
+        durationMs: z.ZodInt;
+        segmentCount: z.ZodInt;
+        totalBytes: z.ZodInt;
+        errorCount: z.ZodInt;
+        pageCount: z.ZodInt;
+        clickCount: z.ZodInt;
+        pagePaths: z.ZodArray<z.ZodString>;
+        clickLabels: z.ZodArray<z.ZodString>;
+        entryPageUrl: z.ZodNullable<z.ZodString>;
+        source: z.ZodEnum<{
+            server: "server";
+            web_admin: "web_admin";
+            web_member: "web_member";
+        }>;
+        appId: z.ZodString;
+        environment: z.ZodEnum<{
+            development: "development";
+            production: "production";
+            staging: "staging";
+        }>;
+        userId: z.ZodNullable<z.ZodInt>;
+        username: z.ZodNullable<z.ZodString>;
+        memberId: z.ZodNullable<z.ZodInt>;
+        browser: z.ZodNullable<z.ZodString>;
+        os: z.ZodNullable<z.ZodString>;
+        deviceType: z.ZodNullable<z.ZodEnum<{
+            bot: "bot";
+            desktop: "desktop";
+            mobile: "mobile";
+            tablet: "tablet";
+            unknown: "unknown";
+        }>>;
+        sdkVersion: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+        segments: z.ZodArray<z.ZodObject<{
+            id: z.ZodInt;
+            replayId: z.ZodString;
+            seq: z.ZodInt;
+            fromTs: z.ZodString;
+            toTs: z.ZodString;
+            byteSize: z.ZodInt;
+            eventCount: z.ZodInt;
+            hasFullSnapshot: z.ZodBoolean;
+        }, z.core.$strip>>;
+        errors: z.ZodArray<z.ZodObject<{
+            id: z.ZodInt;
+            groupId: z.ZodInt;
+            errorType: z.ZodEnum<{
+                console_error: "console_error";
+                crash: "crash";
+                cron_failure: "cron_failure";
+                event_failure: "event_failure";
+                http_error: "http_error";
+                job_failure: "job_failure";
+                js_error: "js_error";
+                logged_error: "logged_error";
+                process_crash: "process_crash";
+                promise_rejection: "promise_rejection";
+                resource_error: "resource_error";
+                server_exception: "server_exception";
+                white_screen: "white_screen";
+            }>;
+            level: z.ZodEnum<{
+                error: "error";
+                fatal: "fatal";
+                info: "info";
+                warning: "warning";
+            }>;
+            message: z.ZodString;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+        perfEvents: z.ZodArray<z.ZodObject<{
+            metricName: z.ZodString;
+            metricValue: z.ZodNumber;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+        siblings: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            status: z.ZodEnum<{
+                completed: "completed";
+                expired: "expired";
+                recording: "recording";
+            }>;
+            startedAt: z.ZodString;
+            durationMs: z.ZodInt;
+            errorCount: z.ZodInt;
+            entryPageUrl: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, "json", undefined>;
+    readonly segmentData: import("../../core/contract.js").UnboundOperation<"get", "/{id}/segments/{seq}/data", z.ZodObject<{
+        id: z.ZodUUID;
+        seq: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>, undefined, undefined, z.ZodNull, "file", undefined>;
+}>;
+//# sourceMappingURL=session-replays.d.ts.map

package/dist/shared/analytics/contracts/session-replays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-replays.d.ts","sourceRoot":"","sources":["../../../src/analytics/contracts/session-replays.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAkBzB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BA,CAAC;AAEjC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,uBAAuB;;;;;;;;;iBASA,CAAC;AAErC,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAGxE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBA,CAAC;AAEvC,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAG5E,eAAO,MAAM,wBAAwB;;;;;;;iBAOA,CAAC;AAEtC,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAG1E,eAAO,MAAM,wBAAwB;;;;;;;iBAGA,CAAC;AAEtC,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAG1E,eAAO,MAAM,qBAAqB;;;;;;;;;iBASA,CAAC;AAEnC,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAOpE,eAAO,MAAM,aAAa;;iBAExB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;iBAE7B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS1B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;iBAAwC,CAAC;AAE7E,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;iBAGnC,CAAC;AAGH,eAAO,MAAM,aAAa;;iBAExB,CAAC;AASH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBF,CAAC"}

package/dist/shared/analytics/contracts/session-replays.js

@@ -0,0 +1,143 @@
+import * as z from 'zod';
+import { keywordQuery, paginated, paginationQuery, queryBool, queryEnum } from '../../core/api-schemas.js';
+import { defineContract, fileField, multipart, op } from '../../core/contract.js';
+import { ANALYTICS_DEVICE_TYPES, ANALYTICS_ENVIRONMENTS, ANALYTICS_EVENT_SOURCES, ERROR_LEVELS, ERROR_TYPES, REPLAY_MODES, REPLAY_STATUSES, REPLAY_TRIGGER_TYPES, } from '../constants.js';
+import { replayTriggerSchema } from '../validation.js';
+import { daysQuery } from './_query.js';
+export const replaySessionSchema = z.object({
+    id: z.string().meta({ description: '回放会话 ID（客户端生成 UUID）' }),
+    sessionId: z.string().meta({ description: 'tracker 会话 ID' }),
+    mode: z.enum(REPLAY_MODES),
+    status: z.enum(REPLAY_STATUSES),
+    triggers: z.array(replayTriggerSchema),
+    startedAt: z.string(),
+    lastActivityAt: z.string(),
+    endedAt: z.string().nullable(),
+    durationMs: z.int(),
+    segmentCount: z.int(),
+    totalBytes: z.int(),
+    errorCount: z.int(),
+    pageCount: z.int(),
+    clickCount: z.int(),
+    pagePaths: z.array(z.string()).meta({ description: '访问过的页面路径（去重索引，内容检索用）' }),
+    clickLabels: z.array(z.string()).meta({ description: '点击过的元素文案（去重索引，内容检索用）' }),
+    entryPageUrl: z.string().nullable(),
+    source: z.enum(ANALYTICS_EVENT_SOURCES),
+    appId: z.string(),
+    environment: z.enum(ANALYTICS_ENVIRONMENTS),
+    userId: z.int().nullable(),
+    username: z.string().nullable(),
+    memberId: z.int().nullable(),
+    browser: z.string().nullable(),
+    os: z.string().nullable(),
+    deviceType: z.enum(ANALYTICS_DEVICE_TYPES).nullable(),
+    sdkVersion: z.string().nullable(),
+    createdAt: z.string(),
+}).meta({ id: 'ReplaySession' });
+export const replaySegmentMetaSchema = z.object({
+    id: z.int(),
+    replayId: z.string(),
+    seq: z.int(),
+    fromTs: z.string(),
+    toTs: z.string(),
+    byteSize: z.int(),
+    eventCount: z.int(),
+    hasFullSnapshot: z.boolean().meta({ description: '含 rrweb 全量快照的分片可作为播放起点' }),
+}).meta({ id: 'ReplaySegmentMeta' });
+export const replaySessionDetailSchema = replaySessionSchema.extend({
+    segments: z.array(replaySegmentMetaSchema),
+    errors: z.array(z.object({
+        id: z.int(),
+        groupId: z.int(),
+        errorType: z.enum(ERROR_TYPES),
+        level: z.enum(ERROR_LEVELS),
+        message: z.string(),
+        createdAt: z.string(),
+    })),
+    perfEvents: z.array(z.object({
+        metricName: z.string(),
+        metricValue: z.number(),
+        createdAt: z.string(),
+    })).meta({ description: '回放期间的 Web Vitals 性能事件（时间轴标注）' }),
+    siblings: z.array(z.object({
+        id: z.string(),
+        status: z.enum(REPLAY_STATUSES),
+        startedAt: z.string(),
+        durationMs: z.int(),
+        errorCount: z.int(),
+        entryPageUrl: z.string().nullable(),
+    })).meta({ description: '同一浏览器会话的其它回放片段（旅程拼接）' }),
+}).meta({ id: 'ReplaySessionDetail' });
+export const replayStorageStatsSchema = z.object({
+    totalBytes: z.number(),
+    totalCount: z.int(),
+    todayBytes: z.number(),
+    todayCount: z.int(),
+    quotaMb: z.int().meta({ description: '配额（MB，0=不限制）' }),
+    usagePercent: z.number().meta({ description: '配额使用率（%，无配额时为 0）' }),
+}).meta({ id: 'ReplayStorageStats' });
+export const replayClickHeatmapSchema = z.object({
+    points: z.array(z.object({ x: z.int(), y: z.int(), count: z.int() })),
+    total: z.int(),
+}).meta({ id: 'ReplayClickHeatmap' });
+export const replayAccessLogSchema = z.object({
+    id: z.int(),
+    replayId: z.string(),
+    replayOwner: z.string().nullable(),
+    userId: z.int(),
+    username: z.string().nullable(),
+    action: z.string(),
+    ip: z.string().nullable(),
+    createdAt: z.string(),
+}).meta({ id: 'ReplayAccessLog' });
+const REPLAY_ID_EXAMPLE = '11111111-1111-4111-8111-111111111111';
+export const replayIdParam = z.object({
+    id: z.uuid().meta({ description: '回放会话 ID', example: REPLAY_ID_EXAMPLE }),
+});
+export const replaySegmentParam = replayIdParam.extend({
+    seq: z.coerce.number().int().min(0).meta({ description: '分片序号（从 0 计）', example: 0 }),
+});
+export const replayListQuery = paginationQuery.extend({
+    status: queryEnum(REPLAY_STATUSES),
+    mode: queryEnum(REPLAY_MODES),
+    triggerType: queryEnum(REPLAY_TRIGGER_TYPES),
+    keyword: keywordQuery('用户名 / 入口页 / 回放 ID / 会话 ID'),
+    hasError: queryBool('仅含错误的回放'),
+    source: queryEnum(['web_admin', 'web_member']),
+    pagePath: keywordQuery('页面路径', { description: '内容检索：访问过的页面路径（模糊）', max: 256 }),
+    clickLabel: keywordQuery('点击文案', { description: '内容检索：点击过的元素文案（模糊）', max: 64 }),
+});
+export const replayHeatmapPagesQuery = z.object({ days: daysQuery(90, 30) });
+export const replayHeatmapQuery = z.object({
+    pagePath: z.string().min(1).max(256),
+    days: daysQuery(90, 30),
+});
+export const replayAccessLogListQuery = paginationQuery.extend({
+    replayId: z.uuid().optional(),
+    keyword: keywordQuery(),
+});
+export const replayIdsBody = z.object({
+    ids: z.array(z.uuid()).min(1).max(100),
+});
+const replaySegmentUploadBody = multipart(z.object({
+    meta: z.string().meta({ description: '分片元信息 JSON（形态见 replaySegmentUploadMetaSchema）' }),
+    data: fileField('gzip 压缩的 rrweb 事件数组'),
+}));
+export const sessionReplayContract = defineContract('/api/session-replays', {
+    ingestSegment: op.post('/segments', { body: replaySegmentUploadBody, public: true, summary: '上报回放分片（multipart：meta JSON + gzip 二进制）' }),
+    list: op.get('/', { access: { permission: 'monitor:replay:list' }, query: replayListQuery, response: paginated(replaySessionSchema), summary: '回放会话列表' }),
+    stats: op.get('/stats', { access: { permission: 'monitor:replay:list' }, response: replayStorageStatsSchema, summary: '回放存储统计（容量看板）' }),
+    heatmapPages: op.get('/heatmap/pages', { access: { permission: 'monitor:replay:list' }, query: replayHeatmapPagesQuery, response: z.array(z.string()), summary: '有点击热力数据的页面清单' }),
+    heatmap: op.get('/heatmap', { access: { permission: 'monitor:replay:list' }, query: replayHeatmapQuery, response: replayClickHeatmapSchema, summary: '页面点击热力聚合（2% 网格）' }),
+    accessLogs: op.get('/access-logs', { access: { permission: 'monitor:replay:manage' }, query: replayAccessLogListQuery, response: paginated(replayAccessLogSchema), summary: '回放访问审计（谁查看了谁的录像）' }),
+    removeBatch: op.delete('/batch', { access: { permission: 'monitor:replay:manage' }, body: replayIdsBody, summary: '批量删除回放会话' }),
+    detail: op.get('/{id}', { access: { permission: 'monitor:replay:list' }, params: replayIdParam, response: replaySessionDetailSchema, summary: '回放会话详情（含分片清单与关联错误）' }),
+    segmentData: op.get('/{id}/segments/{seq}/data', {
+        access: { permission: 'monitor:replay:list' },
+        params: replaySegmentParam,
+        kind: 'file',
+        summary: '拉取回放分片数据（gzip JSON 透传）',
+        description: '响应体为 Content-Encoding: gzip 的 JSON 事件数组，浏览器按编码自动解压。',
+    }),
+}, { tags: ['SessionReplays'] });
+//# sourceMappingURL=session-replays.js.map