@askdepth/react 0.1.0

package/README.md

@@ -0,0 +1,133 @@
+# @askdepth/react
+
+React 18+ and Next.js adapter for Askdepth. It mounts `@askdepth/core` from a client component, maps frustration clicks back to React components, and can stamp JSX with source locations at compile time.
+
+- **Client-only:** the package entry starts with `'use client'`. Server Components import the provider without starting listeners.
+- **Idempotent mount:** a second provider with the same config does not attach another set of core listeners.
+- **Route changes:** `history.pushState`, `replaceState`, and `popstate` emit `page_view` events. Query strings and fragments are omitted; dynamic path segments are redacted, while a small allowlist of common static route names is retained. Next.js App Router navigation has not been verified end to end.
+- **Component location:** `data-askdepth-src` / `data-askdepth-id` when the compiler plugin is installed, otherwise a React Fiber walk.
+
+## Installation
+
+```bash
+pnpm add @askdepth/react @askdepth/core react react-dom
+```
+
+Peer dependencies: `react` and `react-dom` `>=18`. The compiler plugin dependencies (`unplugin`, Babel parser) install with this package and stay out of the browser runtime bundle.
+
+## Provider
+
+```tsx
+'use client';
+
+import { AskdepthProvider } from '@askdepth/react';
+
+export function Providers({ children }: { children: React.ReactNode }) {
+  return (
+    <AskdepthProvider
+      writeKey={process.env.NEXT_PUBLIC_ASKDEPTH_WRITE_KEY!}
+      endpoint={process.env.NEXT_PUBLIC_ASKDEPTH_ENDPOINT!}
+      consent="granted"
+      environment={process.env.NODE_ENV === 'production' ? 'production' : 'development'}
+      replay={true}
+    >
+      {children}
+    </AskdepthProvider>
+  );
+}
+```
+
+`useAskdepth()` returns `track`, `identify`, `getTraceparent`, `isReady`, and `getSessionId`. Outside the provider those methods are no-ops.
+
+## Error boundary
+
+`<AskdepthCatch>` reports a handled `ERROR_CLICK` through core's frustration event path, which triggers the replay flash when replay is enabled. Core uses a recent click selector when available, attaches the resolved component location, and sanitizes and bounds the error and React component stacks. The error message sent in telemetry is generic.
+
+```tsx
+import { AskdepthCatch } from '@askdepth/react';
+
+<AskdepthCatch fallback={(error, reset) => <button onClick={reset}>{error.message}</button>}>
+  <Checkout />
+</AskdepthCatch>
+```
+
+## Compiler plugin
+
+Development and staging add `data-askdepth-src="src/components/Button.tsx:42:10"`. Production adds `data-askdepth-id="cmp_"` plus the first 8 hex characters of SHA-256 over that same `path:line:column` label, so source paths stay out of the bundle. Production builds also write private lookup files to `.askdepth/component-maps/<build-id>/`; set `ASKDEPTH_BUILD_ID` to your deployment ID and retain these files in private build artifacts for resolving IDs later. Set `ASKDEPTH_COMPONENT_MAP_DIR` to move the output, including for Turbopack. For the Vite, Webpack, and Rspack plugins, `buildId` and `mappingDir` override the environment defaults. Keep the mapping directory outside publicly served assets.
+
+```ts
+import { askdepthVitePlugin } from '@askdepth/react/plugin';
+
+export default defineConfig({
+  plugins: [react(), askdepthVitePlugin({ environment: process.env.NODE_ENV })],
+});
+```
+
+```js
+const { withAskdepth } = require('@askdepth/react/plugin');
+
+module.exports = withAskdepth({
+  // existing Next config; the helper adds the plugin to client and server webpack builds
+});
+```
+
+Or push the plugin yourself in a Webpack build:
+
+```js
+const { askdepthWebpackPlugin } = require('@askdepth/react/plugin');
+
+webpack(config) {
+  config.plugins.push(askdepthWebpackPlugin({ environment: process.env.NODE_ENV }));
+  return config;
+}
+```
+
+`withAskdepth` configures the webpack compiler. For Turbopack, configure the package's separate loader in `next.config.js`. The rules below cover both `.tsx` and `.jsx` files and use the current `turbopack` key (Next.js 15.3+ and 16):
+
+```js
+module.exports = {
+  turbopack: {
+    rules: {
+      '*.tsx': {
+        loaders: ['@askdepth/react/turbopack-loader'],
+        as: '*.tsx',
+      },
+      '*.jsx': {
+        loaders: ['@askdepth/react/turbopack-loader'],
+        as: '*.jsx',
+      },
+    },
+  },
+};
+```
+
+For Next.js 15.0–15.2, put the same `rules` object under `experimental.turbo` instead of `turbopack`. In Next.js 16, Turbopack is the default and does not apply the `webpack()` hook; use `next dev --webpack` / `next build --webpack` when using `withAskdepth`.
+
+The loader passes its generated source map through the webpack loader callback. Rspack uses `askdepthRspackPlugin` from `@askdepth/react/plugin`. The Vite, Next.js, and Rspack integrations have unit coverage; a real Next.js/Vite application build is not part of this repository's current checks.
+
+Without the plugin, `resolveComponentLocation` walks the Fiber tree from the DOM node and returns the nearest composite component name plus its ancestors.
+
+## Props
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| `writeKey` | `string` | *(required)* | Client write key sent as `x-askdepth-write-key`. `apiKey` is an alias. |
+| `projectId` | `string` | | UUID/CUID project identifier. Required when the write key is not itself a UUID/CUID. |
+| `endpoint` | `string` | | Ingest URL. Required before collectors start. |
+| `consent` | `'granted' \| 'denied' \| 'unknown'` | `'unknown'` | User consent state. |
+| `replay` | `boolean \| object` | `false` | Session replay, forwarded to core. |
+| `sampleRate` | `number` | `1` | Session sampling probability. |
+| `environment` | `'production' \| 'staging' \| 'development'` | `'production'` | Forwarded to core. |
+| `allowedTracingOrigins` | `string[]` | `[]` | Origins that receive `traceparent`. |
+
+## Bundle budget
+
+The runtime entry (`dist/index.mjs`) stays under 4.8 KB gzip. The compiler plugin is a separate Node entry and is not part of that budget.
+
+## Ingest compatibility status
+
+The local SDK and `apps/analytics-ingest` worktrees currently share protocol version `0.1.0`, telemetry envelope schemas, and the `x-askdepth-write-key` project-binding flow. Replay uploads use bounded binary chunks. The package version stays at its published `0.1.1`; this source change needs a Changesets-generated release before external consumers receive protocol `0.1.0`. The ingest Docker build has not been validated against that published dependency, and shared network conformance tests have not run. Treat browser write keys as publishable restricted keys, not secrets.
+
+## License
+
+MIT © [Askdepth](https://github.com/askdepth)

package/dist/index.cjs

@@ -0,0 +1,357 @@
+'use client';
+'use strict';
+
+var core = require('@askdepth/core');
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/constants.ts
+var ASKDEPTH_SRC_ATTR = "data-askdepth-src";
+var ASKDEPTH_ID_ATTR = "data-askdepth-id";
+var FIBER_KEY_PREFIX = "__reactFiber$";
+var LEGACY_FIBER_KEY_PREFIX = "__reactInternalInstance$";
+var PAGE_VIEW_EVENT = "page_view";
+var COMPOSITE_FIBER_TAGS = /* @__PURE__ */ new Set([0, 1, 2, 11, 14, 15, 16]);
+
+// src/fiber.ts
+var MAX_FIBER_DEPTH = 64;
+function componentNameOf(type, seen) {
+  if (!type || typeof type === "string" || typeof type === "symbol") return null;
+  if (typeof type === "function") {
+    const fn = type;
+    return fn.displayName || fn.name || null;
+  }
+  if (typeof type !== "object" || seen.has(type)) return null;
+  seen.add(type);
+  return type.displayName || type.name || componentNameOf(type.render, seen) || componentNameOf(type.type, seen) || type._payload?._result?.displayName || type._payload?._result?.name || null;
+}
+function readAttr(props, key) {
+  const value = props?.[key];
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function fiberKey(target) {
+  return Object.getOwnPropertyNames(target).find(
+    (name) => name.startsWith(FIBER_KEY_PREFIX) || name.startsWith(LEGACY_FIBER_KEY_PREFIX)
+  );
+}
+function locationFrom(componentName, componentStack, sourceAttr, hashId) {
+  const location = { componentName, componentStack };
+  if (sourceAttr) location.sourceAttr = sourceAttr;
+  if (hashId) location.hashId = hashId;
+  return location;
+}
+function resolveComponentLocation(target) {
+  const directSrc = target.getAttribute(ASKDEPTH_SRC_ATTR) ?? void 0;
+  const directId = target.getAttribute(ASKDEPTH_ID_ATTR) ?? void 0;
+  const key = fiberKey(target);
+  if (!key && !directSrc && !directId) return null;
+  const stack = [];
+  let primaryName = "";
+  let sourceAttr = directSrc;
+  let hashId = directId;
+  let fiber = key ? target[key] ?? null : null;
+  let depth = 0;
+  while (fiber && depth < MAX_FIBER_DEPTH) {
+    depth += 1;
+    const tag = fiber.tag;
+    if (typeof tag === "number" && COMPOSITE_FIBER_TAGS.has(tag) && fiber.type && typeof fiber.type !== "symbol" && typeof fiber.type !== "string") {
+      const name = componentNameOf(fiber.type, /* @__PURE__ */ new Set()) ?? "Anonymous";
+      if (!name.startsWith("Askdepth")) {
+        if (!primaryName) primaryName = name;
+        stack.push(name);
+      }
+    }
+    if (!sourceAttr) {
+      sourceAttr = readAttr(fiber.memoizedProps, ASKDEPTH_SRC_ATTR) ?? readAttr(fiber.pendingProps, ASKDEPTH_SRC_ATTR) ?? readAttr(fiber.alternate?.memoizedProps, ASKDEPTH_SRC_ATTR);
+    }
+    if (!hashId) {
+      hashId = readAttr(fiber.memoizedProps, ASKDEPTH_ID_ATTR) ?? readAttr(fiber.pendingProps, ASKDEPTH_ID_ATTR) ?? readAttr(fiber.alternate?.memoizedProps, ASKDEPTH_ID_ATTR);
+    }
+    fiber = fiber.return ?? null;
+  }
+  if (!primaryName && !sourceAttr && !hashId) return null;
+  return locationFrom(
+    primaryName || target.tagName.toLowerCase(),
+    stack.length > 0 ? stack : [target.tagName.toLowerCase()],
+    sourceAttr,
+    hashId
+  );
+}
+
+// src/interaction.ts
+var DEFAULT_MAX_INTERACTION_AGE_MS = 5e3;
+var last = null;
+var activeRefCount = 0;
+var clickListener = null;
+function elementFrom(target) {
+  if (typeof Element === "undefined") return null;
+  if (target instanceof Element) return target;
+  if (typeof Node !== "undefined" && target instanceof Node) return target.parentElement;
+  return null;
+}
+function getLastUserInteraction(maxAgeMs = DEFAULT_MAX_INTERACTION_AGE_MS) {
+  if (!last) return null;
+  if (Date.now() - last.timestamp > maxAgeMs) {
+    last = null;
+    return null;
+  }
+  return last;
+}
+function clearLastUserInteraction() {
+  last = null;
+}
+function installInteractionMemory() {
+  if (typeof window === "undefined") return () => void 0;
+  activeRefCount += 1;
+  if (!clickListener) {
+    clickListener = (event) => {
+      const target = elementFrom(event.target);
+      if (!target) return;
+      last = { targetElement: target, timestamp: Date.now() };
+    };
+    window.addEventListener("click", clickListener, { capture: true, passive: true });
+  }
+  let unsubscribed = false;
+  return () => {
+    if (unsubscribed) return;
+    unsubscribed = true;
+    activeRefCount = Math.max(0, activeRefCount - 1);
+    if (activeRefCount === 0 && clickListener) {
+      window.removeEventListener("click", clickListener, { capture: true });
+      clickListener = null;
+      last = null;
+    }
+  };
+}
+var activeRefCount2 = 0;
+var restore = null;
+var pageViewNotify = null;
+var unsubscribeConsent = null;
+var initialPageViewPending = false;
+var MAX_INPUT_PATH_LENGTH = 4096;
+var MAX_PATH_SEGMENTS = 12;
+var STATIC_ROUTE_SEGMENTS = /* @__PURE__ */ new Set([
+  "about",
+  "account",
+  "admin",
+  "api",
+  "app",
+  "auth",
+  "billing",
+  "blog",
+  "cart",
+  "checkout",
+  "contact",
+  "dashboard",
+  "docs",
+  "home",
+  "login",
+  "logout",
+  "orders",
+  "pricing",
+  "products",
+  "profile",
+  "search",
+  "settings",
+  "signup",
+  "support",
+  "users",
+  "v1"
+]);
+function currentUrl() {
+  const pathname = window.location.pathname || "/";
+  const bounded = pathname.slice(0, MAX_INPUT_PATH_LENGTH);
+  const segments = bounded.split("/").filter(Boolean);
+  const safe = segments.slice(0, MAX_PATH_SEGMENTS).map(
+    (segment) => STATIC_ROUTE_SEGMENTS.has(segment) ? segment : ":redacted"
+  );
+  if (pathname.length > MAX_INPUT_PATH_LENGTH || segments.length > MAX_PATH_SEGMENTS) {
+    safe.push(":truncated");
+  }
+  return safe.length > 0 ? `/${safe.join("/")}` : "/";
+}
+function startPageViews() {
+  if (typeof window === "undefined" || typeof window.history?.pushState !== "function") {
+    return () => void 0;
+  }
+  activeRefCount2 += 1;
+  if (!restore) {
+    const notify = () => {
+      if (activeRefCount2 > 0) {
+        core.Askdepth.track(PAGE_VIEW_EVENT, { url: currentUrl() });
+      }
+    };
+    pageViewNotify = notify;
+    initialPageViewPending = !core.Askdepth.isInitialized();
+    notify();
+    const currentPushState = window.history.pushState;
+    const currentReplaceState = window.history.replaceState;
+    const originalPushState = currentPushState.__askdepth_original__ ?? currentPushState;
+    const originalReplaceState = currentReplaceState.__askdepth_original__ ?? currentReplaceState;
+    const isPushWrapped = Boolean(
+      currentPushState.__askdepth_page_view__
+    );
+    const isReplaceWrapped = Boolean(
+      currentReplaceState.__askdepth_page_view__
+    );
+    const wrap = (original) => {
+      const fn = function(...args) {
+        const result = original.apply(this, args);
+        notify();
+        return result;
+      };
+      fn.__askdepth_original__ = original;
+      fn.__askdepth_page_view__ = true;
+      return fn;
+    };
+    const wrappedPushState = isPushWrapped ? currentPushState : wrap(originalPushState);
+    const wrappedReplaceState = isReplaceWrapped ? currentReplaceState : wrap(originalReplaceState);
+    if (!isPushWrapped) {
+      window.history.pushState = wrappedPushState;
+    }
+    if (!isReplaceWrapped) {
+      window.history.replaceState = wrappedReplaceState;
+    }
+    restore = () => {
+      if (window.history.pushState !== wrappedPushState || window.history.replaceState !== wrappedReplaceState) return;
+      window.history.pushState = originalPushState;
+      window.history.replaceState = originalReplaceState;
+      restore = null;
+      pageViewNotify = null;
+      initialPageViewPending = false;
+    };
+  }
+  if (activeRefCount2 === 1 && pageViewNotify) {
+    window.addEventListener("popstate", pageViewNotify);
+    unsubscribeConsent = core.Askdepth.onConsentChange((consent) => {
+      if (consent === "granted" && initialPageViewPending) {
+        initialPageViewPending = false;
+        pageViewNotify?.();
+      }
+    });
+  }
+  let unsubscribed = false;
+  return () => {
+    if (unsubscribed) return;
+    unsubscribed = true;
+    activeRefCount2 = Math.max(0, activeRefCount2 - 1);
+    if (activeRefCount2 === 0) {
+      if (pageViewNotify) window.removeEventListener("popstate", pageViewNotify);
+      unsubscribeConsent?.();
+      unsubscribeConsent = null;
+      restore?.();
+    }
+  };
+}
+var AskdepthContext = react.createContext(null);
+var noopContext = {
+  track: () => void 0,
+  identify: () => void 0,
+  getTraceparent: () => null,
+  isReady: () => false,
+  getSessionId: () => null
+};
+function getNoopAskdepth() {
+  return noopContext;
+}
+var AskdepthProvider = (props) => {
+  const { children, apiKey, writeKey: propWriteKey, ...restOptions } = props;
+  const writeKey = propWriteKey ?? apiKey ?? "";
+  const options = {
+    ...restOptions,
+    writeKey
+  };
+  const key = JSON.stringify(options);
+  const stable = react.useMemo(() => options, [key]);
+  const booted = react.useRef(null);
+  const [initializedKey, setInitializedKey] = react.useState(null);
+  react.useEffect(() => {
+    if (typeof window === "undefined") return;
+    if (booted.current !== key) {
+      core.Askdepth.init(stable);
+      booted.current = key;
+      setInitializedKey(key);
+    }
+    const unbindResolver = core.Askdepth.registerComponentResolver(resolveComponentLocation);
+    const unbindInteraction = installInteractionMemory();
+    const unbindPageViews = startPageViews();
+    return () => {
+      unbindResolver();
+      unbindInteraction();
+      unbindPageViews();
+    };
+  }, [key, stable]);
+  const value = react.useMemo(
+    () => ({
+      track: (name, properties) => {
+        if (properties === void 0) core.Askdepth.track(name);
+        else core.Askdepth.track(name, properties);
+      },
+      identify: (userId, traits) => {
+        if (traits === void 0) core.Askdepth.identify(userId);
+        else core.Askdepth.identify(userId, traits);
+      },
+      getTraceparent: () => core.Askdepth.getTraceparent(),
+      isReady: () => core.Askdepth.isInitialized(),
+      getSessionId: () => core.Askdepth.getSessionId()
+    }),
+    [initializedKey]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(AskdepthContext.Provider, { value, children });
+};
+AskdepthProvider.displayName = "AskdepthProvider";
+function useAskdepth() {
+  return react.useContext(AskdepthContext) ?? getNoopAskdepth();
+}
+var AskdepthCatch = class extends react.Component {
+  static displayName = "AskdepthCatch";
+  reportTimer = null;
+  state = {
+    hasError: false,
+    error: null
+  };
+  static getDerivedStateFromError(error) {
+    return { hasError: true, error };
+  }
+  componentDidCatch(error, info) {
+    const target = getLastUserInteraction(500)?.targetElement ?? null;
+    const componentStack = info.componentStack ?? void 0;
+    if (core.Askdepth.isInitialized()) {
+      core.Askdepth.reportCaughtError(error, target, componentStack);
+    } else {
+      if (this.reportTimer) clearTimeout(this.reportTimer);
+      this.reportTimer = setTimeout(() => {
+        this.reportTimer = null;
+        core.Askdepth.reportCaughtError(error, target, componentStack);
+      }, 0);
+    }
+    clearLastUserInteraction();
+  }
+  componentWillUnmount() {
+    if (this.reportTimer) clearTimeout(this.reportTimer);
+  }
+  resetErrorBoundary = () => {
+    this.setState({ hasError: false, error: null });
+  };
+  render() {
+    if (this.state.hasError && this.state.error) {
+      const { fallback } = this.props;
+      if (typeof fallback === "function") return fallback(this.state.error, this.resetErrorBoundary);
+      if (fallback !== void 0) return fallback;
+      return /* @__PURE__ */ jsxRuntime.jsxs("div", { role: "alert", style: { padding: "16px", border: "1px solid #EF4444", borderRadius: "6px" }, children: [
+        /* @__PURE__ */ jsxRuntime.jsx("h2", { children: "Something went wrong" }),
+        /* @__PURE__ */ jsxRuntime.jsx("p", { children: "Please try again." }),
+        /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", onClick: this.resetErrorBoundary, children: "Try again" })
+      ] });
+    }
+    return this.props.children;
+  }
+};
+
+exports.AskdepthCatch = AskdepthCatch;
+exports.AskdepthContext = AskdepthContext;
+exports.AskdepthProvider = AskdepthProvider;
+exports.resolveComponentLocation = resolveComponentLocation;
+exports.useAskdepth = useAskdepth;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/fiber.ts","../src/interaction.ts","../src/page-view.ts","../src/provider.tsx","../src/hooks/use-askdepth.ts","../src/components/error-boundary.tsx"],"names":["activeRefCount","Askdepth","createContext","useMemo","useRef","useState","useEffect","jsx","useContext","Component","jsxs"],"mappings":"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","file":"index.cjs","sourcesContent":["export const ASKDEPTH_SRC_ATTR = 'data-askdepth-src';\nexport const ASKDEPTH_ID_ATTR = 'data-askdepth-id';\nexport const FIBER_KEY_PREFIX = '__reactFiber$';\nexport const LEGACY_FIBER_KEY_PREFIX = '__reactInternalInstance$';\nexport const PAGE_VIEW_EVENT = 'page_view';\nexport const ERROR_CLICK_EVENT = 'ERROR_CLICK';\n\n/** Function, Class, Indeterminate, ForwardRef, Memo, SimpleMemo, Lazy. */\nexport const COMPOSITE_FIBER_TAGS = new Set([0, 1, 2, 11, 14, 15, 16]);\n","import { ASKDEPTH_ID_ATTR, ASKDEPTH_SRC_ATTR, COMPOSITE_FIBER_TAGS, FIBER_KEY_PREFIX, LEGACY_FIBER_KEY_PREFIX } from './constants.js';\nimport type { ResolvedComponentLocation } from './types.js';\n\nconst MAX_FIBER_DEPTH = 64;\n\ninterface FiberType {\n  displayName?: string;\n  name?: string;\n  render?: FiberType;\n  type?: FiberType;\n  _payload?: {\n    _result?: {\n      displayName?: string;\n      name?: string;\n    };\n  };\n}\n\ninterface FiberNode {\n  tag?: number;\n  type?: FiberType | string | symbol | null;\n  return?: FiberNode | null;\n  memoizedProps?: Record<string, unknown> | null;\n  pendingProps?: Record<string, unknown> | null;\n  alternate?: FiberNode | null;\n}\n\nfunction componentNameOf(type: FiberNode['type'], seen: Set<object>): string | null {\n  if (!type || typeof type === 'string' || typeof type === 'symbol') return null;\n  if (typeof type === 'function') {\n    const fn = type as FiberType;\n    return fn.displayName || fn.name || null;\n  }\n  if (typeof type !== 'object' || seen.has(type)) return null;\n  seen.add(type);\n  return (\n    type.displayName ||\n    type.name ||\n    componentNameOf(type.render, seen) ||\n    componentNameOf(type.type, seen) ||\n    type._payload?._result?.displayName ||\n    type._payload?._result?.name ||\n    null\n  );\n}\n\nfunction readAttr(props: Record<string, unknown> | null | undefined, key: string): string | undefined {\n  const value = props?.[key];\n  return typeof value === 'string' && value.length > 0 ? value : undefined;\n}\n\nfunction fiberKey(target: Element): string | undefined {\n  return Object.getOwnPropertyNames(target).find(\n    (name) => name.startsWith(FIBER_KEY_PREFIX) || name.startsWith(LEGACY_FIBER_KEY_PREFIX),\n  );\n}\n\nfunction locationFrom(\n  componentName: string,\n  componentStack: string[],\n  sourceAttr: string | undefined,\n  hashId: string | undefined,\n): ResolvedComponentLocation {\n  const location: ResolvedComponentLocation = { componentName, componentStack };\n  if (sourceAttr) location.sourceAttr = sourceAttr;\n  if (hashId) location.hashId = hashId;\n  return location;\n}\n\nexport function resolveComponentLocation(target: Element): ResolvedComponentLocation | null {\n  const directSrc = target.getAttribute(ASKDEPTH_SRC_ATTR) ?? undefined;\n  const directId = target.getAttribute(ASKDEPTH_ID_ATTR) ?? undefined;\n  const key = fiberKey(target);\n  if (!key && !directSrc && !directId) return null;\n\n  const stack: string[] = [];\n  let primaryName = '';\n  let sourceAttr = directSrc;\n  let hashId = directId;\n  let fiber = key ? ((target as unknown as Record<string, FiberNode | undefined>)[key] ?? null) : null;\n  let depth = 0;\n\n  while (fiber && depth < MAX_FIBER_DEPTH) {\n    depth += 1;\n    const tag = fiber.tag;\n    if (\n      typeof tag === 'number' &&\n      COMPOSITE_FIBER_TAGS.has(tag) &&\n      fiber.type &&\n      typeof fiber.type !== 'symbol' &&\n      typeof fiber.type !== 'string'\n    ) {\n      const name = componentNameOf(fiber.type, new Set()) ?? 'Anonymous';\n      if (!name.startsWith('Askdepth')) {\n        if (!primaryName) primaryName = name;\n        stack.push(name);\n      }\n    }\n    if (!sourceAttr) {\n      sourceAttr =\n        readAttr(fiber.memoizedProps, ASKDEPTH_SRC_ATTR) ??\n        readAttr(fiber.pendingProps, ASKDEPTH_SRC_ATTR) ??\n        readAttr(fiber.alternate?.memoizedProps, ASKDEPTH_SRC_ATTR);\n    }\n    if (!hashId) {\n      hashId =\n        readAttr(fiber.memoizedProps, ASKDEPTH_ID_ATTR) ??\n        readAttr(fiber.pendingProps, ASKDEPTH_ID_ATTR) ??\n        readAttr(fiber.alternate?.memoizedProps, ASKDEPTH_ID_ATTR);\n    }\n    fiber = fiber.return ?? null;\n  }\n\n  if (!primaryName && !sourceAttr && !hashId) return null;\n\n  return locationFrom(\n    primaryName || target.tagName.toLowerCase(),\n    stack.length > 0 ? stack : [target.tagName.toLowerCase()],\n    sourceAttr,\n    hashId,\n  );\n}\n","export interface LastUserInteraction {\n  targetElement: Element;\n  timestamp: number;\n}\n\nexport const DEFAULT_MAX_INTERACTION_AGE_MS = 5_000;\n\nlet last: LastUserInteraction | null = null;\nlet activeRefCount = 0;\nlet clickListener: ((event: MouseEvent) => void) | null = null;\n\nfunction elementFrom(target: EventTarget | null): Element | null {\n  if (typeof Element === 'undefined') return null;\n  if (target instanceof Element) return target;\n  if (typeof Node !== 'undefined' && target instanceof Node) return target.parentElement;\n  return null;\n}\n\n/**\n * Returns the last user interaction if it occurred within `maxAgeMs`.\n * Automatically purges stale references to prevent retaining detached DOM trees.\n */\nexport function getLastUserInteraction(\n  maxAgeMs = DEFAULT_MAX_INTERACTION_AGE_MS,\n): LastUserInteraction | null {\n  if (!last) return null;\n  if (Date.now() - last.timestamp > maxAgeMs) {\n    last = null;\n    return null;\n  }\n  return last;\n}\n\n/**\n * Releases the stored DOM element immediately to facilitate garbage collection.\n */\nexport function clearLastUserInteraction(): void {\n  last = null;\n}\n\n/**\n * Installs interaction tracking with reference counting.\n * Returns an unsubscribe callback that removes the window listener once all providers unmount.\n */\nexport function installInteractionMemory(): () => void {\n  if (typeof window === 'undefined') return () => undefined;\n\n  activeRefCount += 1;\n  if (!clickListener) {\n    clickListener = (event: MouseEvent) => {\n      const target = elementFrom(event.target);\n      if (!target) return;\n      last = { targetElement: target, timestamp: Date.now() };\n    };\n    window.addEventListener('click', clickListener, { capture: true, passive: true });\n  }\n\n  let unsubscribed = false;\n  return () => {\n    if (unsubscribed) return;\n    unsubscribed = true;\n    activeRefCount = Math.max(0, activeRefCount - 1);\n    if (activeRefCount === 0 && clickListener) {\n      window.removeEventListener('click', clickListener, { capture: true });\n      clickListener = null;\n      last = null;\n    }\n  };\n}\n\nexport function resetInteractionMemoryForTests(): void {\n  if (clickListener && typeof window !== 'undefined') {\n    window.removeEventListener('click', clickListener, { capture: true });\n  }\n  clickListener = null;\n  activeRefCount = 0;\n  last = null;\n}\n","import { Askdepth } from '@askdepth/core';\nimport { PAGE_VIEW_EVENT } from './constants.js';\n\nlet activeRefCount = 0;\nlet restore: (() => void) | null = null;\nlet pageViewNotify: (() => void) | null = null;\nlet unsubscribeConsent: (() => void) | null = null;\nlet initialPageViewPending = false;\n\nconst MAX_INPUT_PATH_LENGTH = 4_096;\nconst MAX_PATH_SEGMENTS = 12;\nconst STATIC_ROUTE_SEGMENTS = new Set([\n  'about', 'account', 'admin', 'api', 'app', 'auth', 'billing', 'blog', 'cart',\n  'checkout', 'contact', 'dashboard', 'docs', 'home', 'login', 'logout',\n  'orders', 'pricing', 'products', 'profile', 'search', 'settings', 'signup',\n  'support', 'users', 'v1',\n]);\n\nexport function currentUrl(): string {\n  const pathname = window.location.pathname || '/';\n  const bounded = pathname.slice(0, MAX_INPUT_PATH_LENGTH);\n  const segments = bounded.split('/').filter(Boolean);\n  const safe = segments.slice(0, MAX_PATH_SEGMENTS).map((segment) =>\n    STATIC_ROUTE_SEGMENTS.has(segment) ? segment : ':redacted',\n  );\n  if (pathname.length > MAX_INPUT_PATH_LENGTH || segments.length > MAX_PATH_SEGMENTS) {\n    safe.push(':truncated');\n  }\n  return safe.length > 0 ? `/${safe.join('/')}` : '/';\n}\n\n/**\n * Starts automatic SPA route tracking.\n * Returns an unsubscription function that cleans up history overrides and listeners\n * when all providers unmount.\n */\nexport function startPageViews(): () => void {\n  if (typeof window === 'undefined' || typeof window.history?.pushState !== 'function') {\n    return () => undefined;\n  }\n\n  activeRefCount += 1;\n\n  if (!restore) {\n    const notify = () => {\n      if (activeRefCount > 0) {\n        Askdepth.track(PAGE_VIEW_EVENT, { url: currentUrl() });\n      }\n    };\n    pageViewNotify = notify;\n\n    // Emit initial page view on mount\n    initialPageViewPending = !Askdepth.isInitialized();\n    notify();\n\n    const currentPushState = window.history.pushState;\n    const currentReplaceState = window.history.replaceState;\n\n    const originalPushState =\n      ((currentPushState as unknown as { __askdepth_original__?: History['pushState'] }).__askdepth_original__) ??\n      currentPushState;\n    const originalReplaceState =\n      ((currentReplaceState as unknown as { __askdepth_original__?: History['replaceState'] }).__askdepth_original__) ??\n      currentReplaceState;\n\n    const isPushWrapped = Boolean(\n      (currentPushState as unknown as { __askdepth_page_view__?: boolean }).__askdepth_page_view__,\n    );\n    const isReplaceWrapped = Boolean(\n      (currentReplaceState as unknown as { __askdepth_page_view__?: boolean }).__askdepth_page_view__,\n    );\n\n    const wrap = (original: History['pushState']) => {\n      const fn = function (this: History, ...args: Parameters<History['pushState']>) {\n        const result = original.apply(this, args);\n        notify();\n        return result;\n      };\n      (fn as unknown as { __askdepth_original__: History['pushState']; __askdepth_page_view__: boolean }).__askdepth_original__ = original;\n      (fn as unknown as { __askdepth_page_view__: boolean }).__askdepth_page_view__ = true;\n      return fn;\n    };\n\n    const wrappedPushState = isPushWrapped ? currentPushState : wrap(originalPushState);\n    const wrappedReplaceState = isReplaceWrapped ? currentReplaceState : wrap(originalReplaceState);\n\n    if (!isPushWrapped) {\n      window.history.pushState = wrappedPushState;\n    }\n    if (!isReplaceWrapped) {\n      window.history.replaceState = wrappedReplaceState;\n    }\n    restore = () => {\n      // A replay or router wrapper may still sit above ours. Keep our wrapper so a remount can reuse it.\n      if (window.history.pushState !== wrappedPushState || window.history.replaceState !== wrappedReplaceState) return;\n      window.history.pushState = originalPushState;\n      window.history.replaceState = originalReplaceState;\n      restore = null;\n      pageViewNotify = null;\n      initialPageViewPending = false;\n    };\n  }\n\n  if (activeRefCount === 1 && pageViewNotify) {\n    window.addEventListener('popstate', pageViewNotify);\n    unsubscribeConsent = Askdepth.onConsentChange((consent) => {\n      if (consent === 'granted' && initialPageViewPending) {\n        initialPageViewPending = false;\n        pageViewNotify?.();\n      }\n    });\n  }\n\n  let unsubscribed = false;\n  return () => {\n    if (unsubscribed) return;\n    unsubscribed = true;\n    activeRefCount = Math.max(0, activeRefCount - 1);\n    if (activeRefCount === 0) {\n      if (pageViewNotify) window.removeEventListener('popstate', pageViewNotify);\n      unsubscribeConsent?.();\n      unsubscribeConsent = null;\n      restore?.();\n    }\n  };\n}\n\nexport function resetPageViewsForTests(): void {\n  if (pageViewNotify && typeof window !== 'undefined') window.removeEventListener('popstate', pageViewNotify);\n  unsubscribeConsent?.();\n  const currentPush = typeof window !== 'undefined' ? window.history?.pushState : undefined;\n  const currentReplace = typeof window !== 'undefined' ? window.history?.replaceState : undefined;\n  const origPush = (currentPush as unknown as { __askdepth_original__?: History['pushState'] })?.__askdepth_original__;\n  const origReplace = (currentReplace as unknown as { __askdepth_original__?: History['replaceState'] })?.__askdepth_original__;\n  restore?.();\n  if (origPush && typeof window !== 'undefined' && window.history) {\n    window.history.pushState = origPush;\n  }\n  if (origReplace && typeof window !== 'undefined' && window.history) {\n    window.history.replaceState = origReplace;\n  }\n  activeRefCount = 0;\n  restore = null;\n  pageViewNotify = null;\n  unsubscribeConsent = null;\n  initialPageViewPending = false;\n}\n","'use client';\n\nimport { Askdepth, type AskdepthInitOptions } from '@askdepth/core';\nimport React, { createContext, useEffect, useMemo, useRef, useState } from 'react';\nimport { resolveComponentLocation } from './fiber.js';\nimport { installInteractionMemory } from './interaction.js';\nimport { startPageViews } from './page-view.js';\nimport type { AskdepthContextValue, AskdepthProviderProps } from './types.js';\n\nexport const AskdepthContext = createContext<AskdepthContextValue | null>(null);\n\nconst noopContext: AskdepthContextValue = {\n  track: () => undefined,\n  identify: () => undefined,\n  getTraceparent: () => null,\n  isReady: () => false,\n  getSessionId: () => null,\n};\n\nexport function getNoopAskdepth(): AskdepthContextValue {\n  return noopContext;\n}\n\nexport const AskdepthProvider: React.FC<AskdepthProviderProps> = (props) => {\n  const { children, apiKey, writeKey: propWriteKey, ...restOptions } = props;\n  const writeKey = propWriteKey ?? apiKey ?? '';\n  const options: AskdepthInitOptions = {\n    ...restOptions,\n    writeKey,\n  };\n  const key = JSON.stringify(options);\n  const stable = useMemo(() => options, [key]);\n  const booted = useRef<string | null>(null);\n  const [initializedKey, setInitializedKey] = useState<string | null>(null);\n\n  useEffect(() => {\n    if (typeof window === 'undefined') return;\n    if (booted.current !== key) {\n      Askdepth.init(stable);\n      booted.current = key;\n      setInitializedKey(key);\n    }\n    const unbindResolver = Askdepth.registerComponentResolver(resolveComponentLocation);\n    const unbindInteraction = installInteractionMemory();\n    const unbindPageViews = startPageViews();\n    return () => {\n      unbindResolver();\n      unbindInteraction();\n      unbindPageViews();\n    };\n  }, [key, stable]);\n\n  const value = useMemo<AskdepthContextValue>(\n    () => ({\n      track: (name, properties) => {\n        if (properties === undefined) Askdepth.track(name);\n        else Askdepth.track(name, properties);\n      },\n      identify: (userId, traits) => {\n        if (traits === undefined) Askdepth.identify(userId);\n        else Askdepth.identify(userId, traits);\n      },\n      getTraceparent: () => Askdepth.getTraceparent(),\n      isReady: () => Askdepth.isInitialized(),\n      getSessionId: () => Askdepth.getSessionId(),\n    }),\n    [initializedKey],\n  );\n\n  return <AskdepthContext.Provider value={value}>{children}</AskdepthContext.Provider>;\n};\n\nAskdepthProvider.displayName = 'AskdepthProvider';\n","'use client';\n\nimport { useContext } from 'react';\nimport { AskdepthContext, getNoopAskdepth } from '../provider.js';\nimport type { AskdepthContextValue } from '../types.js';\n\nexport function useAskdepth(): AskdepthContextValue {\n  return useContext(AskdepthContext) ?? getNoopAskdepth();\n}\n","'use client';\n\nimport { Askdepth } from '@askdepth/core';\nimport React, { Component, type ErrorInfo, type ReactNode } from 'react';\nimport { clearLastUserInteraction, getLastUserInteraction } from '../interaction.js';\nimport type { AskdepthFallback } from '../types.js';\n\ninterface Props {\n  children?: ReactNode;\n  fallback?: AskdepthFallback;\n}\n\ninterface State {\n  hasError: boolean;\n  error: Error | null;\n}\n\nexport class AskdepthCatch extends Component<Props, State> {\n  public static displayName = 'AskdepthCatch';\n  private reportTimer: ReturnType<typeof setTimeout> | null = null;\n\n  public override state: State = {\n    hasError: false,\n    error: null,\n  };\n\n  public static getDerivedStateFromError(error: Error): State {\n    return { hasError: true, error };\n  }\n\n  public override componentDidCatch(error: Error, info: ErrorInfo): void {\n    const target = getLastUserInteraction(500)?.targetElement ?? null;\n    const componentStack = info.componentStack ?? undefined;\n    if (Askdepth.isInitialized()) {\n      Askdepth.reportCaughtError(error, target, componentStack);\n    } else {\n      if (this.reportTimer) clearTimeout(this.reportTimer);\n      this.reportTimer = setTimeout(() => {\n        this.reportTimer = null;\n        Askdepth.reportCaughtError(error, target, componentStack);\n      }, 0);\n    }\n    clearLastUserInteraction();\n  }\n\n  public override componentWillUnmount(): void {\n    if (this.reportTimer) clearTimeout(this.reportTimer);\n  }\n\n  private resetErrorBoundary = (): void => {\n    this.setState({ hasError: false, error: null });\n  };\n\n  public override render(): ReactNode {\n    if (this.state.hasError && this.state.error) {\n      const { fallback } = this.props;\n      if (typeof fallback === 'function') return fallback(this.state.error, this.resetErrorBoundary);\n      if (fallback !== undefined) return fallback;\n      return (\n        <div role=\"alert\" style={{ padding: '16px', border: '1px solid #EF4444', borderRadius: '6px' }}>\n          <h2>Something went wrong</h2>\n          <p>Please try again.</p>\n          <button type=\"button\" onClick={this.resetErrorBoundary}>\n            Try again\n          </button>\n        </div>\n      );\n    }\n    return this.props.children;\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,63 @@
+import React, { ReactNode, Component, ErrorInfo } from 'react';
+import { AskdepthInitOptions } from '@askdepth/core';
+export { AskdepthInitOptions, ConsentState } from '@askdepth/core';
+
+interface AskdepthContextValue {
+    track: (name: string, properties?: Record<string, unknown>) => void;
+    identify: (userId: string, traits?: Record<string, unknown>) => void;
+    getTraceparent: () => string | null;
+    isReady: () => boolean;
+    getSessionId: () => string | null;
+}
+type BaseProviderProps = Omit<AskdepthInitOptions, 'writeKey'> & {
+    children?: ReactNode;
+};
+type ProviderWithWriteKey = BaseProviderProps & {
+    /** Project write key */
+    writeKey: string;
+    /** Alias for writeKey */
+    apiKey?: string;
+};
+type ProviderWithApiKey = BaseProviderProps & {
+    /** Project write key */
+    writeKey?: string;
+    /** Alias for writeKey */
+    apiKey: string;
+};
+type AskdepthProviderProps = ProviderWithWriteKey | ProviderWithApiKey;
+interface ResolvedComponentLocation {
+    componentName: string;
+    /** Innermost composite component first. */
+    componentStack: string[];
+    sourceAttr?: string;
+    hashId?: string;
+}
+type AskdepthFallback = ReactNode | ((error: Error, reset: () => void) => ReactNode);
+
+declare const AskdepthContext: React.Context<AskdepthContextValue | null>;
+declare const AskdepthProvider: React.FC<AskdepthProviderProps>;
+
+declare function useAskdepth(): AskdepthContextValue;
+
+interface Props {
+    children?: ReactNode;
+    fallback?: AskdepthFallback;
+}
+interface State {
+    hasError: boolean;
+    error: Error | null;
+}
+declare class AskdepthCatch extends Component<Props, State> {
+    static displayName: string;
+    private reportTimer;
+    state: State;
+    static getDerivedStateFromError(error: Error): State;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    componentWillUnmount(): void;
+    private resetErrorBoundary;
+    render(): ReactNode;
+}
+
+declare function resolveComponentLocation(target: Element): ResolvedComponentLocation | null;
+
+export { AskdepthCatch, AskdepthContext, type AskdepthContextValue, type AskdepthFallback, AskdepthProvider, type AskdepthProviderProps, type ResolvedComponentLocation, resolveComponentLocation, useAskdepth };