@merittdev/horus-lens 0.0.1

package/dist/index.d-BA540Fae.d.ts

@@ -0,0 +1,80 @@
+import { A as AppContext, R as ReportMetadata, T as TargetElement, a as Annotation } from './index.d-Bzgtl7-B.js';
+
+interface LensConfig {
+    accessId: string;
+    endpoint?: string;
+    replay?: {
+        windowMs?: number;
+    } | false;
+    app?: AppContext;
+    maxConsoleEntries?: number;
+    maxNetworkEntries?: number;
+    beforeSend?: (metadata: ReportMetadata) => ReportMetadata | null;
+    /** Capture a page screenshot on submit (best-effort). Default `true`. */
+    screenshot?: boolean;
+    debug?: boolean;
+}
+/**
+ * Per-report opt-outs for the captured data. Every flag defaults to `true`;
+ * setting one to `false` skips both the corresponding asset upload and its
+ * metadata mirror. Config-level `screenshot: false` still wins over
+ * `include.screenshot: true`.
+ */
+interface SubmitReportIncludes {
+    replay?: boolean;
+    console?: boolean;
+    network?: boolean;
+    errors?: boolean;
+    screenshot?: boolean;
+    dom?: boolean;
+}
+interface SubmitReportInput {
+    comment?: string;
+    annotations?: Annotation[];
+    target?: TargetElement;
+    attachments?: {
+        blob: Blob;
+        contentType: string;
+    }[];
+    /** Element hidden from the screenshot capture (e.g. the overlay host). */
+    excludeFromScreenshot?: HTMLElement;
+    /** Selective data opt-outs; each flag defaults to `true`. */
+    include?: SubmitReportIncludes;
+}
+declare class LensClient {
+    private readonly accessId;
+    private readonly endpoint;
+    private readonly replayWindowMs;
+    private readonly debug;
+    private readonly screenshotEnabled;
+    private readonly beforeSend?;
+    private app;
+    private readonly consoleBuffer;
+    private readonly networkBuffer;
+    private readonly errorBuffer;
+    private readonly transport;
+    private readonly replay;
+    private teardowns;
+    private started;
+    constructor(config: LensConfig);
+    start(): void;
+    stop(): void;
+    setApp(app: Partial<AppContext>): void;
+    captureTarget(el: Element): TargetElement;
+    /** Begin an explicit "record steps" session (no-op if replay is disabled). */
+    startRecording(): void;
+    /** Stop the active recording; returns its duration, or `null` if none / disabled. */
+    stopRecording(): {
+        durationMs: number;
+    } | null;
+    /** Discard a retained manual recording and fall back to the rolling window. */
+    discardRecording(): void;
+    /** True while an explicit recording is in progress. */
+    isRecording(): boolean;
+    submitReport(input: SubmitReportInput): Promise<{
+        reportId: string;
+    }>;
+    private warn;
+}
+
+export { type LensConfig as L, LensClient as a };

package/dist/index.d-Bzgtl7-B.d.cts

@@ -0,0 +1,161 @@
+import { z } from 'zod';
+
+declare const AppContextSchema: z.ZodObject<{
+    release: z.ZodOptional<z.ZodString>;
+    gitSha: z.ZodOptional<z.ZodString>;
+    environment: z.ZodOptional<z.ZodString>;
+    featureFlags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>>;
+    user: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        organization: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type AppContext = z.infer<typeof AppContextSchema>;
+/** DOM path + React fiber path of the element the reporter targeted. */
+declare const TargetElementSchema: z.ZodObject<{
+    domPath: z.ZodOptional<z.ZodString>;
+    tagName: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    boundingRect: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    reactComponents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type TargetElement = z.infer<typeof TargetElementSchema>;
+declare const AnnotationSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        rect: "rect";
+        ellipse: "ellipse";
+        arrow: "arrow";
+    }>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    viewport: z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type Annotation = z.infer<typeof AnnotationSchema>;
+declare const ReportMetadataSchema: z.ZodObject<{
+    comment: z.ZodOptional<z.ZodString>;
+    annotations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            rect: "rect";
+            ellipse: "ellipse";
+            arrow: "arrow";
+        }>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        viewport: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>>;
+    target: z.ZodOptional<z.ZodObject<{
+        domPath: z.ZodOptional<z.ZodString>;
+        tagName: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        boundingRect: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        reactComponents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    env: z.ZodObject<{
+        url: z.ZodString;
+        route: z.ZodOptional<z.ZodString>;
+        referrer: z.ZodOptional<z.ZodString>;
+        userAgent: z.ZodString;
+        browser: z.ZodOptional<z.ZodString>;
+        os: z.ZodOptional<z.ZodString>;
+        device: z.ZodOptional<z.ZodEnum<{
+            desktop: "desktop";
+            tablet: "tablet";
+            mobile: "mobile";
+        }>>;
+        viewport: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>;
+        screen: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>;
+        devicePixelRatio: z.ZodNumber;
+        language: z.ZodString;
+        timezone: z.ZodString;
+        theme: z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>>;
+        online: z.ZodOptional<z.ZodBoolean>;
+        capturedAt: z.ZodNumber;
+    }, z.core.$strip>;
+    app: z.ZodOptional<z.ZodObject<{
+        release: z.ZodOptional<z.ZodString>;
+        gitSha: z.ZodOptional<z.ZodString>;
+        environment: z.ZodOptional<z.ZodString>;
+        featureFlags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>>;
+        user: z.ZodOptional<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            organization: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    errors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        message: z.ZodString;
+        stack: z.ZodOptional<z.ZodString>;
+        source: z.ZodEnum<{
+            "window.onerror": "window.onerror";
+            unhandledrejection: "unhandledrejection";
+            "console.error": "console.error";
+            "react-boundary": "react-boundary";
+        }>;
+        timestamp: z.ZodNumber;
+    }, z.core.$strip>>>;
+    consoleTail: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        level: z.ZodEnum<{
+            log: "log";
+            info: "info";
+            warn: "warn";
+            error: "error";
+            debug: "debug";
+        }>;
+        args: z.ZodArray<z.ZodString>;
+        timestamp: z.ZodNumber;
+    }, z.core.$strip>>>;
+    networkTail: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        method: z.ZodString;
+        url: z.ZodString;
+        status: z.ZodNullable<z.ZodNumber>;
+        ok: z.ZodNullable<z.ZodBoolean>;
+        durationMs: z.ZodNullable<z.ZodNumber>;
+        requestType: z.ZodEnum<{
+            fetch: "fetch";
+            xhr: "xhr";
+        }>;
+        startedAt: z.ZodNumber;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    sdk: z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type ReportMetadata = z.infer<typeof ReportMetadataSchema>;
+
+export type { AppContext as A, ReportMetadata as R, TargetElement as T, Annotation as a };

package/dist/index.d-Bzgtl7-B.d.ts

@@ -0,0 +1,161 @@
+import { z } from 'zod';
+
+declare const AppContextSchema: z.ZodObject<{
+    release: z.ZodOptional<z.ZodString>;
+    gitSha: z.ZodOptional<z.ZodString>;
+    environment: z.ZodOptional<z.ZodString>;
+    featureFlags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>>;
+    user: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        organization: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type AppContext = z.infer<typeof AppContextSchema>;
+/** DOM path + React fiber path of the element the reporter targeted. */
+declare const TargetElementSchema: z.ZodObject<{
+    domPath: z.ZodOptional<z.ZodString>;
+    tagName: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    boundingRect: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    reactComponents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type TargetElement = z.infer<typeof TargetElementSchema>;
+declare const AnnotationSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        rect: "rect";
+        ellipse: "ellipse";
+        arrow: "arrow";
+    }>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    viewport: z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type Annotation = z.infer<typeof AnnotationSchema>;
+declare const ReportMetadataSchema: z.ZodObject<{
+    comment: z.ZodOptional<z.ZodString>;
+    annotations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            rect: "rect";
+            ellipse: "ellipse";
+            arrow: "arrow";
+        }>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        viewport: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>>;
+    target: z.ZodOptional<z.ZodObject<{
+        domPath: z.ZodOptional<z.ZodString>;
+        tagName: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        boundingRect: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        reactComponents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    env: z.ZodObject<{
+        url: z.ZodString;
+        route: z.ZodOptional<z.ZodString>;
+        referrer: z.ZodOptional<z.ZodString>;
+        userAgent: z.ZodString;
+        browser: z.ZodOptional<z.ZodString>;
+        os: z.ZodOptional<z.ZodString>;
+        device: z.ZodOptional<z.ZodEnum<{
+            desktop: "desktop";
+            tablet: "tablet";
+            mobile: "mobile";
+        }>>;
+        viewport: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>;
+        screen: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>;
+        devicePixelRatio: z.ZodNumber;
+        language: z.ZodString;
+        timezone: z.ZodString;
+        theme: z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>>;
+        online: z.ZodOptional<z.ZodBoolean>;
+        capturedAt: z.ZodNumber;
+    }, z.core.$strip>;
+    app: z.ZodOptional<z.ZodObject<{
+        release: z.ZodOptional<z.ZodString>;
+        gitSha: z.ZodOptional<z.ZodString>;
+        environment: z.ZodOptional<z.ZodString>;
+        featureFlags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>>;
+        user: z.ZodOptional<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            organization: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    errors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        message: z.ZodString;
+        stack: z.ZodOptional<z.ZodString>;
+        source: z.ZodEnum<{
+            "window.onerror": "window.onerror";
+            unhandledrejection: "unhandledrejection";
+            "console.error": "console.error";
+            "react-boundary": "react-boundary";
+        }>;
+        timestamp: z.ZodNumber;
+    }, z.core.$strip>>>;
+    consoleTail: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        level: z.ZodEnum<{
+            log: "log";
+            info: "info";
+            warn: "warn";
+            error: "error";
+            debug: "debug";
+        }>;
+        args: z.ZodArray<z.ZodString>;
+        timestamp: z.ZodNumber;
+    }, z.core.$strip>>>;
+    networkTail: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        method: z.ZodString;
+        url: z.ZodString;
+        status: z.ZodNullable<z.ZodNumber>;
+        ok: z.ZodNullable<z.ZodBoolean>;
+        durationMs: z.ZodNullable<z.ZodNumber>;
+        requestType: z.ZodEnum<{
+            fetch: "fetch";
+            xhr: "xhr";
+        }>;
+        startedAt: z.ZodNumber;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    sdk: z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type ReportMetadata = z.infer<typeof ReportMetadataSchema>;
+
+export type { AppContext as A, ReportMetadata as R, TargetElement as T, Annotation as a };

package/dist/index.d-DOCLVJGS.d.cts

@@ -0,0 +1,80 @@
+import { A as AppContext, R as ReportMetadata, T as TargetElement, a as Annotation } from './index.d-Bzgtl7-B.cjs';
+
+interface LensConfig {
+    accessId: string;
+    endpoint?: string;
+    replay?: {
+        windowMs?: number;
+    } | false;
+    app?: AppContext;
+    maxConsoleEntries?: number;
+    maxNetworkEntries?: number;
+    beforeSend?: (metadata: ReportMetadata) => ReportMetadata | null;
+    /** Capture a page screenshot on submit (best-effort). Default `true`. */
+    screenshot?: boolean;
+    debug?: boolean;
+}
+/**
+ * Per-report opt-outs for the captured data. Every flag defaults to `true`;
+ * setting one to `false` skips both the corresponding asset upload and its
+ * metadata mirror. Config-level `screenshot: false` still wins over
+ * `include.screenshot: true`.
+ */
+interface SubmitReportIncludes {
+    replay?: boolean;
+    console?: boolean;
+    network?: boolean;
+    errors?: boolean;
+    screenshot?: boolean;
+    dom?: boolean;
+}
+interface SubmitReportInput {
+    comment?: string;
+    annotations?: Annotation[];
+    target?: TargetElement;
+    attachments?: {
+        blob: Blob;
+        contentType: string;
+    }[];
+    /** Element hidden from the screenshot capture (e.g. the overlay host). */
+    excludeFromScreenshot?: HTMLElement;
+    /** Selective data opt-outs; each flag defaults to `true`. */
+    include?: SubmitReportIncludes;
+}
+declare class LensClient {
+    private readonly accessId;
+    private readonly endpoint;
+    private readonly replayWindowMs;
+    private readonly debug;
+    private readonly screenshotEnabled;
+    private readonly beforeSend?;
+    private app;
+    private readonly consoleBuffer;
+    private readonly networkBuffer;
+    private readonly errorBuffer;
+    private readonly transport;
+    private readonly replay;
+    private teardowns;
+    private started;
+    constructor(config: LensConfig);
+    start(): void;
+    stop(): void;
+    setApp(app: Partial<AppContext>): void;
+    captureTarget(el: Element): TargetElement;
+    /** Begin an explicit "record steps" session (no-op if replay is disabled). */
+    startRecording(): void;
+    /** Stop the active recording; returns its duration, or `null` if none / disabled. */
+    stopRecording(): {
+        durationMs: number;
+    } | null;
+    /** Discard a retained manual recording and fall back to the rolling window. */
+    discardRecording(): void;
+    /** True while an explicit recording is in progress. */
+    isRecording(): boolean;
+    submitReport(input: SubmitReportInput): Promise<{
+        reportId: string;
+    }>;
+    private warn;
+}
+
+export { type LensConfig as L, LensClient as a };