@merittdev/horus-lens 0.0.1

package/dist/react.d.cts

@@ -0,0 +1,100 @@
+import * as react from 'react';
+import { Component, ReactNode, ContextType } from 'react';
+import { a as LensClient, L as LensConfig } from './index.d-DOCLVJGS.cjs';
+import { z } from 'zod';
+import './index.d-Bzgtl7-B.cjs';
+
+/** Read-only gate check (param OR persisted flag). Never mutates storage. */
+declare function isGateActive(paramName?: string): boolean;
+interface LensGlobal {
+    (...args: unknown[]): void;
+    q?: Array<ArrayLike<unknown>>;
+}
+declare global {
+    interface Window {
+        Lens?: LensGlobal;
+    }
+}
+
+interface BootOptions extends Partial<Omit<LensConfig, 'accessId'>> {
+    /** Falls back to a `<script data-lens-id>` attribute or a queued `init` call. */
+    accessId?: string;
+    /** Query param that gates activation. Default `'lens'` → `?lens=true`. */
+    paramName?: string;
+    /** Bypass the query-param gate (preview envs / the React provider). */
+    force?: boolean;
+}
+interface LensBrowser {
+    client: LensClient;
+    /** Open the report panel. */
+    open(): void;
+    /** Close the report panel (overlay stays mounted). */
+    close(): void;
+    /** Remove the overlay, stop the client, and clear gate persistence. */
+    destroy(): void;
+}
+
+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>;
+
+interface LensProviderProps extends Omit<BootOptions, 'force'> {
+    accessId: string;
+    /** Activate regardless of ?lens=true — e.g. pass your preview-env flag. */
+    enabled?: boolean;
+    children: ReactNode;
+}
+declare function LensProvider(props: LensProviderProps): react.JSX.Element;
+
+interface Identity {
+    id?: string;
+    email?: string;
+    name?: string;
+    organization?: string;
+}
+declare function useLens(): {
+    active: boolean;
+    open: () => void | undefined;
+    close: () => void | undefined;
+    identify: (user: Identity) => void | undefined;
+    setApp: (app: Partial<AppContext>) => void | undefined;
+    report: (input?: {
+        comment?: string;
+    }) => Promise<{
+        reportId: string;
+    } | null>;
+};
+
+declare const LensContext: react.Context<LensBrowser | null>;
+
+interface Props {
+    children: ReactNode;
+    fallback?: ReactNode;
+}
+interface State {
+    hasError: boolean;
+}
+declare class LensErrorBoundary extends Component<Props, State> {
+    static contextType: react.Context<LensBrowser | null>;
+    context: ContextType<typeof LensContext>;
+    state: State;
+    static getDerivedStateFromError(): State;
+    componentDidCatch(error: Error): void;
+    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react.JSX.Element | null | undefined;
+}
+
+/** Walk the React fiber tree from `el` upward, collecting component names. */
+declare function getComponentStack(el: Element): string[];
+
+export { LensErrorBoundary, LensProvider, type LensProviderProps, getComponentStack, isGateActive, useLens };

package/dist/react.d.ts

@@ -0,0 +1,100 @@
+import * as react from 'react';
+import { Component, ReactNode, ContextType } from 'react';
+import { a as LensClient, L as LensConfig } from './index.d-BA540Fae.js';
+import { z } from 'zod';
+import './index.d-Bzgtl7-B.js';
+
+/** Read-only gate check (param OR persisted flag). Never mutates storage. */
+declare function isGateActive(paramName?: string): boolean;
+interface LensGlobal {
+    (...args: unknown[]): void;
+    q?: Array<ArrayLike<unknown>>;
+}
+declare global {
+    interface Window {
+        Lens?: LensGlobal;
+    }
+}
+
+interface BootOptions extends Partial<Omit<LensConfig, 'accessId'>> {
+    /** Falls back to a `<script data-lens-id>` attribute or a queued `init` call. */
+    accessId?: string;
+    /** Query param that gates activation. Default `'lens'` → `?lens=true`. */
+    paramName?: string;
+    /** Bypass the query-param gate (preview envs / the React provider). */
+    force?: boolean;
+}
+interface LensBrowser {
+    client: LensClient;
+    /** Open the report panel. */
+    open(): void;
+    /** Close the report panel (overlay stays mounted). */
+    close(): void;
+    /** Remove the overlay, stop the client, and clear gate persistence. */
+    destroy(): void;
+}
+
+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>;
+
+interface LensProviderProps extends Omit<BootOptions, 'force'> {
+    accessId: string;
+    /** Activate regardless of ?lens=true — e.g. pass your preview-env flag. */
+    enabled?: boolean;
+    children: ReactNode;
+}
+declare function LensProvider(props: LensProviderProps): react.JSX.Element;
+
+interface Identity {
+    id?: string;
+    email?: string;
+    name?: string;
+    organization?: string;
+}
+declare function useLens(): {
+    active: boolean;
+    open: () => void | undefined;
+    close: () => void | undefined;
+    identify: (user: Identity) => void | undefined;
+    setApp: (app: Partial<AppContext>) => void | undefined;
+    report: (input?: {
+        comment?: string;
+    }) => Promise<{
+        reportId: string;
+    } | null>;
+};
+
+declare const LensContext: react.Context<LensBrowser | null>;
+
+interface Props {
+    children: ReactNode;
+    fallback?: ReactNode;
+}
+interface State {
+    hasError: boolean;
+}
+declare class LensErrorBoundary extends Component<Props, State> {
+    static contextType: react.Context<LensBrowser | null>;
+    context: ContextType<typeof LensContext>;
+    state: State;
+    static getDerivedStateFromError(): State;
+    componentDidCatch(error: Error): void;
+    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react.JSX.Element | null | undefined;
+}
+
+/** Walk the React fiber tree from `el` upward, collecting component names. */
+declare function getComponentStack(el: Element): string[];
+
+export { LensErrorBoundary, LensProvider, type LensProviderProps, getComponentStack, isGateActive, useLens };

package/dist/react.js

@@ -0,0 +1,108 @@
+import {
+  boot,
+  isGateActive
+} from "./chunk-DU7HNRF4.js";
+import "./chunk-S6S3ZZQA.js";
+import "./chunk-DWOH2ENF.js";
+import "./chunk-PZ5AY32C.js";
+
+// ../react/dist/index.js
+import { useEffect, useState } from "react";
+import { createContext } from "react";
+import { jsx } from "react/jsx-runtime";
+import { useContext } from "react";
+import { Component } from "react";
+import { jsx as jsx2 } from "react/jsx-runtime";
+var LensContext = createContext(null);
+function LensProvider(props) {
+  const { children, enabled, ...bootOptions } = props;
+  const [browser, setBrowser] = useState(null);
+  useEffect(() => {
+    const instance = boot({ ...bootOptions, force: enabled });
+    if (instance) {
+      instance.client.setApp({ extra: { framework: "react" } });
+    }
+    setBrowser(instance);
+    return () => {
+      instance?.destroy();
+      setBrowser(null);
+    };
+  }, [props.accessId]);
+  return /* @__PURE__ */ jsx(LensContext.Provider, { value: browser, children });
+}
+function useLens() {
+  const browser = useContext(LensContext);
+  return {
+    active: browser !== null,
+    open: () => browser?.open(),
+    close: () => browser?.close(),
+    identify: (user) => browser?.client.setApp({ user }),
+    setApp: (app) => browser?.client.setApp(app),
+    report: async (input) => {
+      if (!browser) return null;
+      return browser.client.submitReport({ comment: input?.comment });
+    }
+  };
+}
+var LensErrorBoundary = class extends Component {
+  static contextType = LensContext;
+  state = { hasError: false };
+  static getDerivedStateFromError() {
+    return { hasError: true };
+  }
+  componentDidCatch(error) {
+    const browser = this.context;
+    if (browser) {
+      browser.client.setApp({ extra: { lastBoundaryError: error.message } });
+      browser.open();
+    }
+  }
+  render() {
+    if (this.state.hasError) {
+      return this.props.fallback ?? /* @__PURE__ */ jsx2(
+        "div",
+        {
+          role: "alert",
+          style: {
+            padding: "12px 16px",
+            borderRadius: 8,
+            border: "1px solid rgba(0,0,0,0.1)",
+            font: "14px system-ui, sans-serif"
+          },
+          children: "Something went wrong."
+        }
+      );
+    }
+    return this.props.children;
+  }
+};
+function nameOf(type) {
+  if (!type || typeof type === "string") return void 0;
+  return type.displayName ?? type.name ?? type.render?.displayName ?? type.render?.name;
+}
+function getComponentStack(el) {
+  const names = [];
+  try {
+    const key = Object.keys(el).find((k) => k.startsWith("__reactFiber$"));
+    if (!key) return names;
+    let fiber = el[key] ?? null;
+    const seen = /* @__PURE__ */ new Set();
+    while (fiber && !seen.has(fiber)) {
+      seen.add(fiber);
+      const name = nameOf(fiber.type);
+      if (name) names.push(name);
+      fiber = fiber.return ?? null;
+    }
+  } catch {
+    return names;
+  }
+  return names;
+}
+export {
+  LensErrorBoundary,
+  LensProvider,
+  getComponentStack,
+  isGateActive,
+  useLens
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../react/src/provider.tsx","../../react/src/context.ts","../../react/src/use-lens.ts","../../react/src/error-boundary.tsx","../../react/src/fiber.ts","../../react/src/index.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\nimport type { ReactNode } from 'react';\nimport { boot } from '@horus-lens/browser';\nimport type { BootOptions, LensBrowser } from '@horus-lens/browser';\nimport { LensContext } from './context.js';\n\nexport interface LensProviderProps extends Omit<BootOptions, 'force'> {\n  accessId: string;\n  /** Activate regardless of ?lens=true — e.g. pass your preview-env flag. */\n  enabled?: boolean;\n  children: ReactNode;\n}\n\nexport function LensProvider(props: LensProviderProps) {\n  const { children, enabled, ...bootOptions } = props;\n  const [browser, setBrowser] = useState<LensBrowser | null>(null);\n\n  useEffect(() => {\n    const instance = boot({ ...bootOptions, force: enabled });\n    if (instance) {\n      instance.client.setApp({ extra: { framework: 'react' } });\n    }\n    setBrowser(instance);\n    return () => {\n      instance?.destroy();\n      setBrowser(null);\n    };\n  }, [props.accessId]);\n\n  return <LensContext.Provider value={browser}>{children}</LensContext.Provider>;\n}\n","import { createContext } from 'react';\nimport type { LensBrowser } from '@horus-lens/browser';\n\nexport const LensContext = createContext<LensBrowser | null>(null);\n","import { useContext } from 'react';\nimport type { AppContext } from '@horus-lens/shared';\nimport { LensContext } from './context.js';\n\ninterface Identity {\n  id?: string;\n  email?: string;\n  name?: string;\n  organization?: string;\n}\n\nexport function useLens() {\n  const browser = useContext(LensContext);\n\n  return {\n    active: browser !== null,\n    open: () => browser?.open(),\n    close: () => browser?.close(),\n    identify: (user: Identity) => browser?.client.setApp({ user }),\n    setApp: (app: Partial<AppContext>) => browser?.client.setApp(app),\n    report: async (input?: { comment?: string }): Promise<{ reportId: string } | null> => {\n      if (!browser) return null;\n      return browser.client.submitReport({ comment: input?.comment });\n    },\n  };\n}\n","import { Component } from 'react';\nimport type { ContextType, ReactNode } from 'react';\nimport { LensContext } from './context.js';\n\ninterface Props {\n  children: ReactNode;\n  fallback?: ReactNode;\n}\n\ninterface State {\n  hasError: boolean;\n}\n\nexport class LensErrorBoundary extends Component<Props, State> {\n  static contextType = LensContext;\n  declare context: ContextType<typeof LensContext>;\n\n  state: State = { hasError: false };\n\n  static getDerivedStateFromError(): State {\n    return { hasError: true };\n  }\n\n  componentDidCatch(error: Error) {\n    const browser = this.context;\n    if (browser) {\n      browser.client.setApp({ extra: { lastBoundaryError: error.message } });\n      browser.open();\n    }\n  }\n\n  render() {\n    if (this.state.hasError) {\n      return (\n        this.props.fallback ?? (\n          <div\n            role=\"alert\"\n            style={{\n              padding: '12px 16px',\n              borderRadius: 8,\n              border: '1px solid rgba(0,0,0,0.1)',\n              font: '14px system-ui, sans-serif',\n            }}\n          >\n            Something went wrong.\n          </div>\n        )\n      );\n    }\n    return this.props.children;\n  }\n}\n","interface FiberType {\n  displayName?: string;\n  name?: string;\n  render?: { displayName?: string; name?: string };\n}\n\ninterface FiberNode {\n  type?: FiberType | string | null;\n  return?: FiberNode | null;\n}\n\nfunction nameOf(type: FiberNode['type']): string | undefined {\n  if (!type || typeof type === 'string') return undefined;\n  return type.displayName ?? type.name ?? type.render?.displayName ?? type.render?.name;\n}\n\n/** Walk the React fiber tree from `el` upward, collecting component names. */\nexport function getComponentStack(el: Element): string[] {\n  const names: string[] = [];\n  try {\n    const key = Object.keys(el).find((k) => k.startsWith('__reactFiber$'));\n    if (!key) return names;\n\n    let fiber = (el as unknown as Record<string, FiberNode | undefined>)[key] ?? null;\n    const seen = new Set<FiberNode>();\n    while (fiber && !seen.has(fiber)) {\n      seen.add(fiber);\n      const name = nameOf(fiber.type);\n      if (name) names.push(name);\n      fiber = fiber.return ?? null;\n    }\n  } catch {\n    return names;\n  }\n  return names;\n}\n","export { LensProvider } from './provider.js';\nexport type { LensProviderProps } from './provider.js';\nexport { useLens } from './use-lens.js';\nexport { LensErrorBoundary } from './error-boundary.js';\nexport { getComponentStack } from './fiber.js';\nexport { isGateActive } from '@horus-lens/browser';\n"],"mappings":";;;;;;;;;AAAA,SAAS,WAAW,gBAAgB;ACApC,SAAS,qBAAqB;AD6BrB,SAAA,WAAA;AE7BT,SAAS,kBAAkB;ACA3B,SAAS,iBAAiB;AAmChB,SAAA,OAAAA,YAAA;AFhCH,IAAM,cAAc,cAAkC,IAAI;ADU1D,SAAS,aAAa,OAA0B;AACrD,QAAM,EAAE,UAAU,SAAS,GAAG,YAAY,IAAI;AAC9C,QAAM,CAAC,SAAS,UAAU,IAAI,SAA6B,IAAI;AAE/D,YAAU,MAAM;AACd,UAAM,WAAW,KAAK,EAAE,GAAG,aAAa,OAAO,QAAQ,CAAC;AACxD,QAAI,UAAU;AACZ,eAAS,OAAO,OAAO,EAAE,OAAO,EAAE,WAAW,QAAQ,EAAE,CAAC;IAC1D;AACA,eAAW,QAAQ;AACnB,WAAO,MAAM;AACX,gBAAU,QAAQ;AAClB,iBAAW,IAAI;IACjB;EACF,GAAG,CAAC,MAAM,QAAQ,CAAC;AAEnB,SAAO,oBAAC,YAAY,UAAZ,EAAqB,OAAO,SAAU,SAAA,CAAS;AACzD;AEnBO,SAAS,UAAU;AACxB,QAAM,UAAU,WAAW,WAAW;AAEtC,SAAO;IACL,QAAQ,YAAY;IACpB,MAAM,MAAM,SAAS,KAAK;IAC1B,OAAO,MAAM,SAAS,MAAM;IAC5B,UAAU,CAAC,SAAmB,SAAS,OAAO,OAAO,EAAE,KAAK,CAAC;IAC7D,QAAQ,CAAC,QAA6B,SAAS,OAAO,OAAO,GAAG;IAChE,QAAQ,OAAO,UAAuE;AACpF,UAAI,CAAC,QAAS,QAAO;AACrB,aAAO,QAAQ,OAAO,aAAa,EAAE,SAAS,OAAO,QAAQ,CAAC;IAChE;EACF;AACF;ACZO,IAAM,oBAAN,cAAgC,UAAwB;EAC7D,OAAO,cAAc;EAGrB,QAAe,EAAE,UAAU,MAAM;EAEjC,OAAO,2BAAkC;AACvC,WAAO,EAAE,UAAU,KAAK;EAC1B;EAEA,kBAAkB,OAAc;AAC9B,UAAM,UAAU,KAAK;AACrB,QAAI,SAAS;AACX,cAAQ,OAAO,OAAO,EAAE,OAAO,EAAE,mBAAmB,MAAM,QAAQ,EAAE,CAAC;AACrE,cAAQ,KAAK;IACf;EACF;EAEA,SAAS;AACP,QAAI,KAAK,MAAM,UAAU;AACvB,aACE,KAAK,MAAM,YACTC;QAAC;QAAA;UACC,MAAK;UACL,OAAO;YACL,SAAS;YACT,cAAc;YACd,QAAQ;YACR,MAAM;UACR;UACD,UAAA;QAAA;MAED;IAGN;AACA,WAAO,KAAK,MAAM;EACpB;AACF;ACxCA,SAAS,OAAO,MAA6C;AAC3D,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,SAAO,KAAK,eAAe,KAAK,QAAQ,KAAK,QAAQ,eAAe,KAAK,QAAQ;AACnF;AAGO,SAAS,kBAAkB,IAAuB;AACvD,QAAM,QAAkB,CAAC;AACzB,MAAI;AACF,UAAM,MAAM,OAAO,KAAK,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW,eAAe,CAAC;AACrE,QAAI,CAAC,IAAK,QAAO;AAEjB,QAAI,QAAS,GAAwD,GAAG,KAAK;AAC7E,UAAM,OAAO,oBAAI,IAAe;AAChC,WAAO,SAAS,CAAC,KAAK,IAAI,KAAK,GAAG;AAChC,WAAK,IAAI,KAAK;AACd,YAAM,OAAO,OAAO,MAAM,IAAI;AAC9B,UAAI,KAAM,OAAM,KAAK,IAAI;AACzB,cAAQ,MAAM,UAAU;IAC1B;EACF,QAAQ;AACN,WAAO;EACT;AACA,SAAO;AACT;","names":["jsx","jsx"]}

package/dist/rrweb-EYUUZIYR.js

@@ -0,0 +1,30 @@
+import {
+  EventType,
+  IncrementalSource,
+  MouseInteractions,
+  Replayer,
+  ReplayerEvents,
+  _mirror,
+  addCustomEvent,
+  canvasMutation,
+  freezePage,
+  record,
+  takeFullSnapshot,
+  utils
+} from "./chunk-DWOH2ENF.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  EventType,
+  IncrementalSource,
+  MouseInteractions,
+  Replayer,
+  ReplayerEvents,
+  addCustomEvent,
+  canvasMutation,
+  freezePage,
+  _mirror as mirror,
+  record,
+  takeFullSnapshot,
+  utils
+};
+//# sourceMappingURL=rrweb-EYUUZIYR.js.map

package/dist/rrweb-EYUUZIYR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@merittdev/horus-lens",
+  "version": "0.0.1",
+  "description": "Lens — context-rich issue capture for web apps: overlay, replay, and drop-in dashboard components",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js",
+      "require": "./dist/browser.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    },
+    "./dashboard": {
+      "types": "./dist/dashboard.d.ts",
+      "import": "./dist/dashboard.js",
+      "require": "./dist/dashboard.cjs"
+    },
+    "./dashboard/styles.css": "./dist/dashboard.css",
+    "./dist/dashboard.css": "./dist/dashboard.css",
+    "./cdn": "./dist/lens.min.js"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.3",
+    "@horus-lens/core": "0.0.1",
+    "@horus-lens/browser": "0.0.1",
+    "@horus-lens/react": "0.0.1",
+    "@horus-lens/dashboard": "0.0.1",
+    "@horus-lens/shared": "0.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup && node scripts/copy-assets.mjs",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  }
+}