@merittdev/horus-lens 0.0.1 → 0.0.3

package/dist/react.d.cts

@@ -1,6 +1,6 @@
 import * as react from 'react';
-import { Component, ReactNode, ContextType } from 'react';
-import { a as LensClient, L as LensConfig } from './index.d-DOCLVJGS.cjs';
+import { ReactNode, Component, ContextType } from 'react';
+import { L as LensConfig, a as LensClient } from './index.d-DOCLVJGS.cjs';
 import { z } from 'zod';
 import './index.d-Bzgtl7-B.cjs';
 
@@ -49,13 +49,25 @@ declare const AppContextSchema: z.ZodObject<{
 }, z.core.$strip>;
 type AppContext = z.infer<typeof AppContextSchema>;
 
-interface LensProviderProps extends Omit<BootOptions, 'force'> {
+interface LensProps extends Omit<BootOptions, 'force'> {
     accessId: string;
     /** Activate regardless of ?lens=true — e.g. pass your preview-env flag. */
     enabled?: boolean;
-    children: ReactNode;
+    /**
+     * Optional: <Lens /> mounts standalone anywhere in the tree. Wrap children
+     * only when descendants need the `useLens()` context.
+     */
+    children?: ReactNode;
 }
-declare function LensProvider(props: LensProviderProps): react.JSX.Element;
+/**
+ * Mounts the Lens issue-capture overlay. Renders nothing itself — drop
+ * `<Lens accessId="lai_…" />` into your root layout and the overlay appears
+ * for sessions gated in via `?lens=true` (or force it with `enabled`).
+ */
+declare function Lens(props: LensProps): react.JSX.Element;
+/** Back-compat alias — `<Lens />` is the canonical name. */
+declare const LensProvider: typeof Lens;
+type LensProviderProps = LensProps;
 
 interface Identity {
     id?: string;
@@ -97,4 +109,4 @@ declare class LensErrorBoundary extends Component<Props, State> {
 /** 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 };
+export { Lens, LensErrorBoundary, type LensProps, LensProvider, type LensProviderProps, getComponentStack, isGateActive, useLens };

package/dist/react.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
-import { Component, ReactNode, ContextType } from 'react';
-import { a as LensClient, L as LensConfig } from './index.d-BA540Fae.js';
+import { ReactNode, Component, ContextType } from 'react';
+import { L as LensConfig, a as LensClient } from './index.d-BA540Fae.js';
 import { z } from 'zod';
 import './index.d-Bzgtl7-B.js';
 
@@ -49,13 +49,25 @@ declare const AppContextSchema: z.ZodObject<{
 }, z.core.$strip>;
 type AppContext = z.infer<typeof AppContextSchema>;
 
-interface LensProviderProps extends Omit<BootOptions, 'force'> {
+interface LensProps extends Omit<BootOptions, 'force'> {
     accessId: string;
     /** Activate regardless of ?lens=true — e.g. pass your preview-env flag. */
     enabled?: boolean;
-    children: ReactNode;
+    /**
+     * Optional: <Lens /> mounts standalone anywhere in the tree. Wrap children
+     * only when descendants need the `useLens()` context.
+     */
+    children?: ReactNode;
 }
-declare function LensProvider(props: LensProviderProps): react.JSX.Element;
+/**
+ * Mounts the Lens issue-capture overlay. Renders nothing itself — drop
+ * `<Lens accessId="lai_…" />` into your root layout and the overlay appears
+ * for sessions gated in via `?lens=true` (or force it with `enabled`).
+ */
+declare function Lens(props: LensProps): react.JSX.Element;
+/** Back-compat alias — `<Lens />` is the canonical name. */
+declare const LensProvider: typeof Lens;
+type LensProviderProps = LensProps;
 
 interface Identity {
     id?: string;
@@ -97,4 +109,4 @@ declare class LensErrorBoundary extends Component<Props, State> {
 /** 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 };
+export { Lens, LensErrorBoundary, type LensProps, LensProvider, type LensProviderProps, getComponentStack, isGateActive, useLens };

package/dist/react.js

@@ -1,8 +1,8 @@
 import {
   boot,
   isGateActive
-} from "./chunk-DU7HNRF4.js";
-import "./chunk-S6S3ZZQA.js";
+} from "./chunk-CTBY5XIN.js";
+import "./chunk-XRONR4GR.js";
 import "./chunk-DWOH2ENF.js";
 import "./chunk-PZ5AY32C.js";
 
@@ -14,7 +14,7 @@ import { useContext } from "react";
 import { Component } from "react";
 import { jsx as jsx2 } from "react/jsx-runtime";
 var LensContext = createContext(null);
-function LensProvider(props) {
+function Lens(props) {
   const { children, enabled, ...bootOptions } = props;
   const [browser, setBrowser] = useState(null);
   useEffect(() => {
@@ -28,8 +28,9 @@ function LensProvider(props) {
       setBrowser(null);
     };
   }, [props.accessId]);
-  return /* @__PURE__ */ jsx(LensContext.Provider, { value: browser, children });
+  return /* @__PURE__ */ jsx(LensContext.Provider, { value: browser, children: children ?? null });
 }
+var LensProvider = Lens;
 function useLens() {
   const browser = useContext(LensContext);
   return {
@@ -99,6 +100,7 @@ function getComponentStack(el) {
   return names;
 }
 export {
+  Lens,
   LensErrorBoundary,
   LensProvider,
   getComponentStack,

package/dist/react.js.map

@@ -1 +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"]}
+{"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 LensProps extends Omit<BootOptions, 'force'> {\n  accessId: string;\n  /** Activate regardless of ?lens=true — e.g. pass your preview-env flag. */\n  enabled?: boolean;\n  /**\n   * Optional: <Lens /> mounts standalone anywhere in the tree. Wrap children\n   * only when descendants need the `useLens()` context.\n   */\n  children?: ReactNode;\n}\n\n/**\n * Mounts the Lens issue-capture overlay. Renders nothing itself — drop\n * `<Lens accessId=\"lai_…\" />` into your root layout and the overlay appears\n * for sessions gated in via `?lens=true` (or force it with `enabled`).\n */\nexport function Lens(props: LensProps) {\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 ?? null}</LensContext.Provider>;\n}\n\n/** Back-compat alias — `<Lens />` is the canonical name. */\nexport const LensProvider = Lens;\nexport type LensProviderProps = LensProps;\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 { Lens, LensProvider } from './provider.js';\nexport type { LensProps, 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;ADsCrB,SAAA,WAAA;AEtCT,SAAS,kBAAkB;ACA3B,SAAS,iBAAiB;AAmChB,SAAA,OAAAA,YAAA;AFhCH,IAAM,cAAc,cAAkC,IAAI;ADmB1D,SAAS,KAAK,OAAkB;AACrC,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,UAAA,YAAY,KAAA,CAAK;AACjE;AAGO,IAAM,eAAe;AE/BrB,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/server.cjs

@@ -0,0 +1,109 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server.ts
+var server_exports = {};
+__export(server_exports, {
+  HOSTED_LENS_API_URL: () => HOSTED_LENS_API_URL,
+  createLensProjectsRoute: () => createLensProjectsRoute,
+  createLensProxy: () => createLensProxy
+});
+module.exports = __toCommonJS(server_exports);
+
+// ../dashboard/dist/server.js
+var HOSTED_LENS_API_URL = "https://api-lens.meritt.app";
+function envProjects() {
+  const raw = process.env.LENS_PROJECTS;
+  if (raw) {
+    try {
+      const parsed = JSON.parse(raw);
+      if (Array.isArray(parsed)) {
+        return parsed.filter(
+          (p) => !!p && typeof p.name === "string" && typeof p.accessId === "string" && typeof p.secretKey === "string"
+        );
+      }
+    } catch {
+      console.warn("[lens] LENS_PROJECTS is not valid JSON \u2014 ignoring");
+    }
+  }
+  const accessId = process.env.LENS_ACCESS_ID;
+  const secretKey = process.env.LENS_SECRET_KEY;
+  if (accessId && secretKey) return [{ name: "default", accessId, secretKey }];
+  return [];
+}
+function resolveOptions(options) {
+  return {
+    apiUrl: (options?.apiUrl ?? process.env.LENS_API_URL ?? HOSTED_LENS_API_URL).replace(/\/+$/, ""),
+    projects: options?.projects ?? envProjects(),
+    adminToken: options?.adminToken ?? process.env.LENS_ADMIN_TOKEN ?? ""
+  };
+}
+function pickProject(projects, selector) {
+  if (projects.length === 0) return null;
+  if (selector) {
+    const match = projects.find((p) => p.name === selector || p.accessId === selector);
+    if (match) return match;
+  }
+  return projects[0] ?? null;
+}
+function createLensProxy(options) {
+  const handler = async (req, ctx) => {
+    const { apiUrl, projects, adminToken } = resolveOptions(options);
+    const { path } = await ctx.params;
+    const search = new URL(req.url).search;
+    const target = `${apiUrl}/${path.join("/")}${search}`;
+    const isProjectCreate = req.method === "POST" && path.join("/") === "v1/projects";
+    const wizardToken = req.headers.get("x-lens-token");
+    const project = pickProject(projects, req.headers.get("x-lens-project"));
+    const token = isProjectCreate ? adminToken : wizardToken?.startsWith("las_") ? wizardToken : project?.secretKey ?? "";
+    const body = req.method === "GET" || req.method === "HEAD" ? void 0 : await req.text();
+    const res = await fetch(target, {
+      method: req.method,
+      headers: {
+        authorization: `Bearer ${token}`,
+        ...body ? { "content-type": req.headers.get("content-type") ?? "application/json" } : {}
+      },
+      body,
+      cache: "no-store"
+    });
+    const buffer = await res.arrayBuffer();
+    return new Response(buffer, {
+      status: res.status,
+      headers: { "content-type": res.headers.get("content-type") ?? "application/json" }
+    });
+  };
+  return { GET: handler, POST: handler, PUT: handler, PATCH: handler, DELETE: handler };
+}
+function createLensProjectsRoute(options) {
+  return {
+    GET: () => {
+      const { projects } = resolveOptions(options);
+      return Response.json({
+        projects: projects.map(({ name, accessId }) => ({ name, accessId }))
+      });
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HOSTED_LENS_API_URL,
+  createLensProjectsRoute,
+  createLensProxy
+});
+//# sourceMappingURL=server.cjs.map

package/dist/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../../dashboard/src/server/proxy.ts"],"sourcesContent":["export * from '@horus-lens/dashboard/server';\n","/**\n * Server-side glue for hosting <LensDashboard> — framework-agnostic (standard\n * Request/Response, so it drops into Next.js App Router route files, Remix\n * resource routes, etc.).\n *\n * This is the ONLY part of the package that reads environment variables, and\n * it only ever executes on the host's server:\n *\n *   LENS_PROJECTS     JSON array: [{\"name\",\"accessId\",\"secretKey\"}, …]\n *   LENS_ACCESS_ID /\n *   LENS_SECRET_KEY   legacy single-project fallback\n *   LENS_ADMIN_TOKEN  optional — enables project creation from the wizard\n *   LENS_API_URL      optional override (self-hosting / local dev)\n *\n * Usage (Next.js):\n *   // app/api/lens/[...path]/route.ts\n *   import { createLensProxy } from '@merittdev/horus-lens/server'\n *   export const { GET, POST, PUT, PATCH, DELETE } = createLensProxy()\n *\n *   // app/api/lens-projects/route.ts\n *   import { createLensProjectsRoute } from '@merittdev/horus-lens/server'\n *   export const { GET } = createLensProjectsRoute()\n */\n\n// Runs under Node on the host's server; typed locally to keep @types/node out\n// of this browser-focused package.\ndeclare const process: { env: Record<string, string | undefined> };\n\nexport const HOSTED_LENS_API_URL = 'https://api-lens.meritt.app';\n\nexport interface LensProjectEntry {\n  name: string;\n  accessId: string;\n  secretKey: string;\n}\n\nexport interface LensServerOptions {\n  /** Lens API base. Default: env LENS_API_URL, else the hosted API. */\n  apiUrl?: string;\n  /** Project registry. Default: env LENS_PROJECTS (JSON), else the legacy pair. */\n  projects?: LensProjectEntry[];\n  /** Admin token for POST /v1/projects. Default: env LENS_ADMIN_TOKEN. */\n  adminToken?: string;\n}\n\nfunction envProjects(): LensProjectEntry[] {\n  const raw = process.env.LENS_PROJECTS;\n  if (raw) {\n    try {\n      const parsed: unknown = JSON.parse(raw);\n      if (Array.isArray(parsed)) {\n        return parsed.filter(\n          (p): p is LensProjectEntry =>\n            !!p &&\n            typeof (p as LensProjectEntry).name === 'string' &&\n            typeof (p as LensProjectEntry).accessId === 'string' &&\n            typeof (p as LensProjectEntry).secretKey === 'string',\n        );\n      }\n    } catch {\n      console.warn('[lens] LENS_PROJECTS is not valid JSON — ignoring');\n    }\n  }\n  const accessId = process.env.LENS_ACCESS_ID;\n  const secretKey = process.env.LENS_SECRET_KEY;\n  if (accessId && secretKey) return [{ name: 'default', accessId, secretKey }];\n  return [];\n}\n\nfunction resolveOptions(options?: LensServerOptions) {\n  return {\n    apiUrl: (options?.apiUrl ?? process.env.LENS_API_URL ?? HOSTED_LENS_API_URL).replace(/\\/+$/, ''),\n    projects: options?.projects ?? envProjects(),\n    adminToken: options?.adminToken ?? process.env.LENS_ADMIN_TOKEN ?? '',\n  };\n}\n\nfunction pickProject(projects: LensProjectEntry[], selector: string | null): LensProjectEntry | null {\n  if (projects.length === 0) return null;\n  if (selector) {\n    const match = projects.find((p) => p.name === selector || p.accessId === selector);\n    if (match) return match;\n  }\n  return projects[0] ?? null;\n}\n\n/** Next.js App Router passes ctx.params as a Promise (15+) or plain object. */\ntype RouteContext = { params: { path: string[] } | Promise<{ path: string[] }> };\ntype ProxyHandler = (req: Request, ctx: RouteContext) => Promise<Response>;\n\n/**\n * Authenticated pass-through to the Lens API. Credentials attach HERE, on the\n * server: the browser only ever names a project via `x-lens-project`. During\n * first-run provisioning the wizard forwards its just-minted secret via\n * `x-lens-token`, which wins over the registry.\n */\nexport function createLensProxy(options?: LensServerOptions): Record<\n  'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE',\n  ProxyHandler\n> {\n  const handler: ProxyHandler = async (req, ctx) => {\n    const { apiUrl, projects, adminToken } = resolveOptions(options);\n    const { path } = await ctx.params;\n    const search = new URL(req.url).search;\n    const target = `${apiUrl}/${path.join('/')}${search}`;\n\n    const isProjectCreate = req.method === 'POST' && path.join('/') === 'v1/projects';\n    const wizardToken = req.headers.get('x-lens-token');\n    const project = pickProject(projects, req.headers.get('x-lens-project'));\n\n    const token = isProjectCreate\n      ? adminToken\n      : wizardToken?.startsWith('las_')\n        ? wizardToken\n        : (project?.secretKey ?? '');\n\n    const body = req.method === 'GET' || req.method === 'HEAD' ? undefined : await req.text();\n\n    const res = await fetch(target, {\n      method: req.method,\n      headers: {\n        authorization: `Bearer ${token}`,\n        ...(body ? { 'content-type': req.headers.get('content-type') ?? 'application/json' } : {}),\n      },\n      body,\n      cache: 'no-store',\n    });\n\n    const buffer = await res.arrayBuffer();\n    return new Response(buffer, {\n      status: res.status,\n      headers: { 'content-type': res.headers.get('content-type') ?? 'application/json' },\n    });\n  };\n\n  return { GET: handler, POST: handler, PUT: handler, PATCH: handler, DELETE: handler };\n}\n\n/** Names + access ids for the project switcher — never the secrets. */\nexport function createLensProjectsRoute(options?: LensServerOptions): { GET: () => Response } {\n  return {\n    GET: () => {\n      const { projects } = resolveOptions(options);\n      return Response.json({\n        projects: projects.map(({ name, accessId }) => ({ name, accessId })),\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC4BO,IAAM,sBAAsB;AAiBnC,SAAS,cAAkC;AACzC,QAAM,MAAM,QAAQ,IAAI;AACxB,MAAI,KAAK;AACP,QAAI;AACF,YAAM,SAAkB,KAAK,MAAM,GAAG;AACtC,UAAI,MAAM,QAAQ,MAAM,GAAG;AACzB,eAAO,OAAO;UACZ,CAAC,MACC,CAAC,CAAC,KACF,OAAQ,EAAuB,SAAS,YACxC,OAAQ,EAAuB,aAAa,YAC5C,OAAQ,EAAuB,cAAc;QACjD;MACF;IACF,QAAQ;AACN,cAAQ,KAAK,wDAAmD;IAClE;EACF;AACA,QAAM,WAAW,QAAQ,IAAI;AAC7B,QAAM,YAAY,QAAQ,IAAI;AAC9B,MAAI,YAAY,UAAW,QAAO,CAAC,EAAE,MAAM,WAAW,UAAU,UAAU,CAAC;AAC3E,SAAO,CAAC;AACV;AAEA,SAAS,eAAe,SAA6B;AACnD,SAAO;IACL,SAAS,SAAS,UAAU,QAAQ,IAAI,gBAAgB,qBAAqB,QAAQ,QAAQ,EAAE;IAC/F,UAAU,SAAS,YAAY,YAAY;IAC3C,YAAY,SAAS,cAAc,QAAQ,IAAI,oBAAoB;EACrE;AACF;AAEA,SAAS,YAAY,UAA8B,UAAkD;AACnG,MAAI,SAAS,WAAW,EAAG,QAAO;AAClC,MAAI,UAAU;AACZ,UAAM,QAAQ,SAAS,KAAK,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,aAAa,QAAQ;AACjF,QAAI,MAAO,QAAO;EACpB;AACA,SAAO,SAAS,CAAC,KAAK;AACxB;AAYO,SAAS,gBAAgB,SAG9B;AACA,QAAM,UAAwB,OAAO,KAAK,QAAQ;AAChD,UAAM,EAAE,QAAQ,UAAU,WAAW,IAAI,eAAe,OAAO;AAC/D,UAAM,EAAE,KAAK,IAAI,MAAM,IAAI;AAC3B,UAAM,SAAS,IAAI,IAAI,IAAI,GAAG,EAAE;AAChC,UAAM,SAAS,GAAG,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC,GAAG,MAAM;AAEnD,UAAM,kBAAkB,IAAI,WAAW,UAAU,KAAK,KAAK,GAAG,MAAM;AACpE,UAAM,cAAc,IAAI,QAAQ,IAAI,cAAc;AAClD,UAAM,UAAU,YAAY,UAAU,IAAI,QAAQ,IAAI,gBAAgB,CAAC;AAEvE,UAAM,QAAQ,kBACV,aACA,aAAa,WAAW,MAAM,IAC5B,cACC,SAAS,aAAa;AAE7B,UAAM,OAAO,IAAI,WAAW,SAAS,IAAI,WAAW,SAAS,SAAY,MAAM,IAAI,KAAK;AAExF,UAAM,MAAM,MAAM,MAAM,QAAQ;MAC9B,QAAQ,IAAI;MACZ,SAAS;QACP,eAAe,UAAU,KAAK;QAC9B,GAAI,OAAO,EAAE,gBAAgB,IAAI,QAAQ,IAAI,cAAc,KAAK,mBAAmB,IAAI,CAAC;MAC1F;MACA;MACA,OAAO;IACT,CAAC;AAED,UAAM,SAAS,MAAM,IAAI,YAAY;AACrC,WAAO,IAAI,SAAS,QAAQ;MAC1B,QAAQ,IAAI;MACZ,SAAS,EAAE,gBAAgB,IAAI,QAAQ,IAAI,cAAc,KAAK,mBAAmB;IACnF,CAAC;EACH;AAEA,SAAO,EAAE,KAAK,SAAS,MAAM,SAAS,KAAK,SAAS,OAAO,SAAS,QAAQ,QAAQ;AACtF;AAGO,SAAS,wBAAwB,SAAsD;AAC5F,SAAO;IACL,KAAK,MAAM;AACT,YAAM,EAAE,SAAS,IAAI,eAAe,OAAO;AAC3C,aAAO,SAAS,KAAK;QACnB,UAAU,SAAS,IAAI,CAAC,EAAE,MAAM,SAAS,OAAO,EAAE,MAAM,SAAS,EAAE;MACrE,CAAC;IACH;EACF;AACF;","names":[]}

package/dist/server.d.cts

@@ -0,0 +1,59 @@
+/**
+ * Server-side glue for hosting <LensDashboard> — framework-agnostic (standard
+ * Request/Response, so it drops into Next.js App Router route files, Remix
+ * resource routes, etc.).
+ *
+ * This is the ONLY part of the package that reads environment variables, and
+ * it only ever executes on the host's server:
+ *
+ *   LENS_PROJECTS     JSON array: [{"name","accessId","secretKey"}, …]
+ *   LENS_ACCESS_ID /
+ *   LENS_SECRET_KEY   legacy single-project fallback
+ *   LENS_ADMIN_TOKEN  optional — enables project creation from the wizard
+ *   LENS_API_URL      optional override (self-hosting / local dev)
+ *
+ * Usage (Next.js):
+ *   // app/api/lens/[...path]/route.ts
+ *   import { createLensProxy } from '@merittdev/horus-lens/server'
+ *   export const { GET, POST, PUT, PATCH, DELETE } = createLensProxy()
+ *
+ *   // app/api/lens-projects/route.ts
+ *   import { createLensProjectsRoute } from '@merittdev/horus-lens/server'
+ *   export const { GET } = createLensProjectsRoute()
+ */
+declare const HOSTED_LENS_API_URL = "https://api-lens.meritt.app";
+interface LensProjectEntry {
+    name: string;
+    accessId: string;
+    secretKey: string;
+}
+interface LensServerOptions {
+    /** Lens API base. Default: env LENS_API_URL, else the hosted API. */
+    apiUrl?: string;
+    /** Project registry. Default: env LENS_PROJECTS (JSON), else the legacy pair. */
+    projects?: LensProjectEntry[];
+    /** Admin token for POST /v1/projects. Default: env LENS_ADMIN_TOKEN. */
+    adminToken?: string;
+}
+/** Next.js App Router passes ctx.params as a Promise (15+) or plain object. */
+type RouteContext = {
+    params: {
+        path: string[];
+    } | Promise<{
+        path: string[];
+    }>;
+};
+type ProxyHandler = (req: Request, ctx: RouteContext) => Promise<Response>;
+/**
+ * Authenticated pass-through to the Lens API. Credentials attach HERE, on the
+ * server: the browser only ever names a project via `x-lens-project`. During
+ * first-run provisioning the wizard forwards its just-minted secret via
+ * `x-lens-token`, which wins over the registry.
+ */
+declare function createLensProxy(options?: LensServerOptions): Record<'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', ProxyHandler>;
+/** Names + access ids for the project switcher — never the secrets. */
+declare function createLensProjectsRoute(options?: LensServerOptions): {
+    GET: () => Response;
+};
+
+export { HOSTED_LENS_API_URL, type LensProjectEntry, type LensServerOptions, createLensProjectsRoute, createLensProxy };

package/dist/server.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Server-side glue for hosting <LensDashboard> — framework-agnostic (standard
+ * Request/Response, so it drops into Next.js App Router route files, Remix
+ * resource routes, etc.).
+ *
+ * This is the ONLY part of the package that reads environment variables, and
+ * it only ever executes on the host's server:
+ *
+ *   LENS_PROJECTS     JSON array: [{"name","accessId","secretKey"}, …]
+ *   LENS_ACCESS_ID /
+ *   LENS_SECRET_KEY   legacy single-project fallback
+ *   LENS_ADMIN_TOKEN  optional — enables project creation from the wizard
+ *   LENS_API_URL      optional override (self-hosting / local dev)
+ *
+ * Usage (Next.js):
+ *   // app/api/lens/[...path]/route.ts
+ *   import { createLensProxy } from '@merittdev/horus-lens/server'
+ *   export const { GET, POST, PUT, PATCH, DELETE } = createLensProxy()
+ *
+ *   // app/api/lens-projects/route.ts
+ *   import { createLensProjectsRoute } from '@merittdev/horus-lens/server'
+ *   export const { GET } = createLensProjectsRoute()
+ */
+declare const HOSTED_LENS_API_URL = "https://api-lens.meritt.app";
+interface LensProjectEntry {
+    name: string;
+    accessId: string;
+    secretKey: string;
+}
+interface LensServerOptions {
+    /** Lens API base. Default: env LENS_API_URL, else the hosted API. */
+    apiUrl?: string;
+    /** Project registry. Default: env LENS_PROJECTS (JSON), else the legacy pair. */
+    projects?: LensProjectEntry[];
+    /** Admin token for POST /v1/projects. Default: env LENS_ADMIN_TOKEN. */
+    adminToken?: string;
+}
+/** Next.js App Router passes ctx.params as a Promise (15+) or plain object. */
+type RouteContext = {
+    params: {
+        path: string[];
+    } | Promise<{
+        path: string[];
+    }>;
+};
+type ProxyHandler = (req: Request, ctx: RouteContext) => Promise<Response>;
+/**
+ * Authenticated pass-through to the Lens API. Credentials attach HERE, on the
+ * server: the browser only ever names a project via `x-lens-project`. During
+ * first-run provisioning the wizard forwards its just-minted secret via
+ * `x-lens-token`, which wins over the registry.
+ */
+declare function createLensProxy(options?: LensServerOptions): Record<'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', ProxyHandler>;
+/** Names + access ids for the project switcher — never the secrets. */
+declare function createLensProjectsRoute(options?: LensServerOptions): {
+    GET: () => Response;
+};
+
+export { HOSTED_LENS_API_URL, type LensProjectEntry, type LensServerOptions, createLensProjectsRoute, createLensProxy };

package/dist/server.js

@@ -0,0 +1,82 @@
+import "./chunk-PZ5AY32C.js";
+
+// ../dashboard/dist/server.js
+var HOSTED_LENS_API_URL = "https://api-lens.meritt.app";
+function envProjects() {
+  const raw = process.env.LENS_PROJECTS;
+  if (raw) {
+    try {
+      const parsed = JSON.parse(raw);
+      if (Array.isArray(parsed)) {
+        return parsed.filter(
+          (p) => !!p && typeof p.name === "string" && typeof p.accessId === "string" && typeof p.secretKey === "string"
+        );
+      }
+    } catch {
+      console.warn("[lens] LENS_PROJECTS is not valid JSON \u2014 ignoring");
+    }
+  }
+  const accessId = process.env.LENS_ACCESS_ID;
+  const secretKey = process.env.LENS_SECRET_KEY;
+  if (accessId && secretKey) return [{ name: "default", accessId, secretKey }];
+  return [];
+}
+function resolveOptions(options) {
+  return {
+    apiUrl: (options?.apiUrl ?? process.env.LENS_API_URL ?? HOSTED_LENS_API_URL).replace(/\/+$/, ""),
+    projects: options?.projects ?? envProjects(),
+    adminToken: options?.adminToken ?? process.env.LENS_ADMIN_TOKEN ?? ""
+  };
+}
+function pickProject(projects, selector) {
+  if (projects.length === 0) return null;
+  if (selector) {
+    const match = projects.find((p) => p.name === selector || p.accessId === selector);
+    if (match) return match;
+  }
+  return projects[0] ?? null;
+}
+function createLensProxy(options) {
+  const handler = async (req, ctx) => {
+    const { apiUrl, projects, adminToken } = resolveOptions(options);
+    const { path } = await ctx.params;
+    const search = new URL(req.url).search;
+    const target = `${apiUrl}/${path.join("/")}${search}`;
+    const isProjectCreate = req.method === "POST" && path.join("/") === "v1/projects";
+    const wizardToken = req.headers.get("x-lens-token");
+    const project = pickProject(projects, req.headers.get("x-lens-project"));
+    const token = isProjectCreate ? adminToken : wizardToken?.startsWith("las_") ? wizardToken : project?.secretKey ?? "";
+    const body = req.method === "GET" || req.method === "HEAD" ? void 0 : await req.text();
+    const res = await fetch(target, {
+      method: req.method,
+      headers: {
+        authorization: `Bearer ${token}`,
+        ...body ? { "content-type": req.headers.get("content-type") ?? "application/json" } : {}
+      },
+      body,
+      cache: "no-store"
+    });
+    const buffer = await res.arrayBuffer();
+    return new Response(buffer, {
+      status: res.status,
+      headers: { "content-type": res.headers.get("content-type") ?? "application/json" }
+    });
+  };
+  return { GET: handler, POST: handler, PUT: handler, PATCH: handler, DELETE: handler };
+}
+function createLensProjectsRoute(options) {
+  return {
+    GET: () => {
+      const { projects } = resolveOptions(options);
+      return Response.json({
+        projects: projects.map(({ name, accessId }) => ({ name, accessId }))
+      });
+    }
+  };
+}
+export {
+  HOSTED_LENS_API_URL,
+  createLensProjectsRoute,
+  createLensProxy
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../dashboard/src/server/proxy.ts"],"sourcesContent":["/**\n * Server-side glue for hosting <LensDashboard> — framework-agnostic (standard\n * Request/Response, so it drops into Next.js App Router route files, Remix\n * resource routes, etc.).\n *\n * This is the ONLY part of the package that reads environment variables, and\n * it only ever executes on the host's server:\n *\n *   LENS_PROJECTS     JSON array: [{\"name\",\"accessId\",\"secretKey\"}, …]\n *   LENS_ACCESS_ID /\n *   LENS_SECRET_KEY   legacy single-project fallback\n *   LENS_ADMIN_TOKEN  optional — enables project creation from the wizard\n *   LENS_API_URL      optional override (self-hosting / local dev)\n *\n * Usage (Next.js):\n *   // app/api/lens/[...path]/route.ts\n *   import { createLensProxy } from '@merittdev/horus-lens/server'\n *   export const { GET, POST, PUT, PATCH, DELETE } = createLensProxy()\n *\n *   // app/api/lens-projects/route.ts\n *   import { createLensProjectsRoute } from '@merittdev/horus-lens/server'\n *   export const { GET } = createLensProjectsRoute()\n */\n\n// Runs under Node on the host's server; typed locally to keep @types/node out\n// of this browser-focused package.\ndeclare const process: { env: Record<string, string | undefined> };\n\nexport const HOSTED_LENS_API_URL = 'https://api-lens.meritt.app';\n\nexport interface LensProjectEntry {\n  name: string;\n  accessId: string;\n  secretKey: string;\n}\n\nexport interface LensServerOptions {\n  /** Lens API base. Default: env LENS_API_URL, else the hosted API. */\n  apiUrl?: string;\n  /** Project registry. Default: env LENS_PROJECTS (JSON), else the legacy pair. */\n  projects?: LensProjectEntry[];\n  /** Admin token for POST /v1/projects. Default: env LENS_ADMIN_TOKEN. */\n  adminToken?: string;\n}\n\nfunction envProjects(): LensProjectEntry[] {\n  const raw = process.env.LENS_PROJECTS;\n  if (raw) {\n    try {\n      const parsed: unknown = JSON.parse(raw);\n      if (Array.isArray(parsed)) {\n        return parsed.filter(\n          (p): p is LensProjectEntry =>\n            !!p &&\n            typeof (p as LensProjectEntry).name === 'string' &&\n            typeof (p as LensProjectEntry).accessId === 'string' &&\n            typeof (p as LensProjectEntry).secretKey === 'string',\n        );\n      }\n    } catch {\n      console.warn('[lens] LENS_PROJECTS is not valid JSON — ignoring');\n    }\n  }\n  const accessId = process.env.LENS_ACCESS_ID;\n  const secretKey = process.env.LENS_SECRET_KEY;\n  if (accessId && secretKey) return [{ name: 'default', accessId, secretKey }];\n  return [];\n}\n\nfunction resolveOptions(options?: LensServerOptions) {\n  return {\n    apiUrl: (options?.apiUrl ?? process.env.LENS_API_URL ?? HOSTED_LENS_API_URL).replace(/\\/+$/, ''),\n    projects: options?.projects ?? envProjects(),\n    adminToken: options?.adminToken ?? process.env.LENS_ADMIN_TOKEN ?? '',\n  };\n}\n\nfunction pickProject(projects: LensProjectEntry[], selector: string | null): LensProjectEntry | null {\n  if (projects.length === 0) return null;\n  if (selector) {\n    const match = projects.find((p) => p.name === selector || p.accessId === selector);\n    if (match) return match;\n  }\n  return projects[0] ?? null;\n}\n\n/** Next.js App Router passes ctx.params as a Promise (15+) or plain object. */\ntype RouteContext = { params: { path: string[] } | Promise<{ path: string[] }> };\ntype ProxyHandler = (req: Request, ctx: RouteContext) => Promise<Response>;\n\n/**\n * Authenticated pass-through to the Lens API. Credentials attach HERE, on the\n * server: the browser only ever names a project via `x-lens-project`. During\n * first-run provisioning the wizard forwards its just-minted secret via\n * `x-lens-token`, which wins over the registry.\n */\nexport function createLensProxy(options?: LensServerOptions): Record<\n  'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE',\n  ProxyHandler\n> {\n  const handler: ProxyHandler = async (req, ctx) => {\n    const { apiUrl, projects, adminToken } = resolveOptions(options);\n    const { path } = await ctx.params;\n    const search = new URL(req.url).search;\n    const target = `${apiUrl}/${path.join('/')}${search}`;\n\n    const isProjectCreate = req.method === 'POST' && path.join('/') === 'v1/projects';\n    const wizardToken = req.headers.get('x-lens-token');\n    const project = pickProject(projects, req.headers.get('x-lens-project'));\n\n    const token = isProjectCreate\n      ? adminToken\n      : wizardToken?.startsWith('las_')\n        ? wizardToken\n        : (project?.secretKey ?? '');\n\n    const body = req.method === 'GET' || req.method === 'HEAD' ? undefined : await req.text();\n\n    const res = await fetch(target, {\n      method: req.method,\n      headers: {\n        authorization: `Bearer ${token}`,\n        ...(body ? { 'content-type': req.headers.get('content-type') ?? 'application/json' } : {}),\n      },\n      body,\n      cache: 'no-store',\n    });\n\n    const buffer = await res.arrayBuffer();\n    return new Response(buffer, {\n      status: res.status,\n      headers: { 'content-type': res.headers.get('content-type') ?? 'application/json' },\n    });\n  };\n\n  return { GET: handler, POST: handler, PUT: handler, PATCH: handler, DELETE: handler };\n}\n\n/** Names + access ids for the project switcher — never the secrets. */\nexport function createLensProjectsRoute(options?: LensServerOptions): { GET: () => Response } {\n  return {\n    GET: () => {\n      const { projects } = resolveOptions(options);\n      return Response.json({\n        projects: projects.map(({ name, accessId }) => ({ name, accessId })),\n      });\n    },\n  };\n}\n"],"mappings":";;;AA4BO,IAAM,sBAAsB;AAiBnC,SAAS,cAAkC;AACzC,QAAM,MAAM,QAAQ,IAAI;AACxB,MAAI,KAAK;AACP,QAAI;AACF,YAAM,SAAkB,KAAK,MAAM,GAAG;AACtC,UAAI,MAAM,QAAQ,MAAM,GAAG;AACzB,eAAO,OAAO;UACZ,CAAC,MACC,CAAC,CAAC,KACF,OAAQ,EAAuB,SAAS,YACxC,OAAQ,EAAuB,aAAa,YAC5C,OAAQ,EAAuB,cAAc;QACjD;MACF;IACF,QAAQ;AACN,cAAQ,KAAK,wDAAmD;IAClE;EACF;AACA,QAAM,WAAW,QAAQ,IAAI;AAC7B,QAAM,YAAY,QAAQ,IAAI;AAC9B,MAAI,YAAY,UAAW,QAAO,CAAC,EAAE,MAAM,WAAW,UAAU,UAAU,CAAC;AAC3E,SAAO,CAAC;AACV;AAEA,SAAS,eAAe,SAA6B;AACnD,SAAO;IACL,SAAS,SAAS,UAAU,QAAQ,IAAI,gBAAgB,qBAAqB,QAAQ,QAAQ,EAAE;IAC/F,UAAU,SAAS,YAAY,YAAY;IAC3C,YAAY,SAAS,cAAc,QAAQ,IAAI,oBAAoB;EACrE;AACF;AAEA,SAAS,YAAY,UAA8B,UAAkD;AACnG,MAAI,SAAS,WAAW,EAAG,QAAO;AAClC,MAAI,UAAU;AACZ,UAAM,QAAQ,SAAS,KAAK,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,aAAa,QAAQ;AACjF,QAAI,MAAO,QAAO;EACpB;AACA,SAAO,SAAS,CAAC,KAAK;AACxB;AAYO,SAAS,gBAAgB,SAG9B;AACA,QAAM,UAAwB,OAAO,KAAK,QAAQ;AAChD,UAAM,EAAE,QAAQ,UAAU,WAAW,IAAI,eAAe,OAAO;AAC/D,UAAM,EAAE,KAAK,IAAI,MAAM,IAAI;AAC3B,UAAM,SAAS,IAAI,IAAI,IAAI,GAAG,EAAE;AAChC,UAAM,SAAS,GAAG,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC,GAAG,MAAM;AAEnD,UAAM,kBAAkB,IAAI,WAAW,UAAU,KAAK,KAAK,GAAG,MAAM;AACpE,UAAM,cAAc,IAAI,QAAQ,IAAI,cAAc;AAClD,UAAM,UAAU,YAAY,UAAU,IAAI,QAAQ,IAAI,gBAAgB,CAAC;AAEvE,UAAM,QAAQ,kBACV,aACA,aAAa,WAAW,MAAM,IAC5B,cACC,SAAS,aAAa;AAE7B,UAAM,OAAO,IAAI,WAAW,SAAS,IAAI,WAAW,SAAS,SAAY,MAAM,IAAI,KAAK;AAExF,UAAM,MAAM,MAAM,MAAM,QAAQ;MAC9B,QAAQ,IAAI;MACZ,SAAS;QACP,eAAe,UAAU,KAAK;QAC9B,GAAI,OAAO,EAAE,gBAAgB,IAAI,QAAQ,IAAI,cAAc,KAAK,mBAAmB,IAAI,CAAC;MAC1F;MACA;MACA,OAAO;IACT,CAAC;AAED,UAAM,SAAS,MAAM,IAAI,YAAY;AACrC,WAAO,IAAI,SAAS,QAAQ;MAC1B,QAAQ,IAAI;MACZ,SAAS,EAAE,gBAAgB,IAAI,QAAQ,IAAI,cAAc,KAAK,mBAAmB;IACnF,CAAC;EACH;AAEA,SAAO,EAAE,KAAK,SAAS,MAAM,SAAS,KAAK,SAAS,OAAO,SAAS,QAAQ,QAAQ;AACtF;AAGO,SAAS,wBAAwB,SAAsD;AAC5F,SAAO;IACL,KAAK,MAAM;AACT,YAAM,EAAE,SAAS,IAAI,eAAe,OAAO;AAC3C,aAAO,SAAS,KAAK;QACnB,UAAU,SAAS,IAAI,CAAC,EAAE,MAAM,SAAS,OAAO,EAAE,MAAM,SAAS,EAAE;MACrE,CAAC;IACH;EACF;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@merittdev/horus-lens",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Lens — context-rich issue capture for web apps: overlay, replay, and drop-in dashboard components",
   "license": "MIT",
   "type": "module",
@@ -34,7 +34,12 @@
     },
     "./dashboard/styles.css": "./dist/dashboard.css",
     "./dist/dashboard.css": "./dist/dashboard.css",
-    "./cdn": "./dist/lens.min.js"
+    "./cdn": "./dist/lens.min.js",
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    }
   },
   "peerDependencies": {
     "react": ">=18",
@@ -51,15 +56,36 @@
   "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/core": "0.0.1",
     "@horus-lens/dashboard": "0.0.1",
+    "@horus-lens/react": "0.0.1",
     "@horus-lens/shared": "0.0.1"
   },
   "publishConfig": {
     "access": "public"
   },
+  "keywords": [
+    "bug-reporting",
+    "session-replay",
+    "rrweb",
+    "feedback",
+    "issue-tracking",
+    "linear",
+    "jira",
+    "github",
+    "screenshot",
+    "developer-tools"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Meritt-dev/horus-lens.git",
+    "directory": "packages/lens"
+  },
+  "homepage": "https://github.com/Meritt-dev/horus-lens#readme",
+  "bugs": {
+    "url": "https://github.com/Meritt-dev/horus-lens/issues"
+  },
   "scripts": {
     "build": "tsup && node scripts/copy-assets.mjs",
     "typecheck": "tsc --noEmit",