@guidelytech/react 0.15.0 → 0.17.0

package/README.md

@@ -66,7 +66,46 @@ they read the bootstrap payload — `<GuidelyProvider flagsPayload={…} flagAtt
 `account`), so server HTML and hydration match; without a payload they return fallbacks.
 `GuidelyProvider` also accepts `flags={false}` to turn flags off or `flags={{ … }}` for client options.
 
+## Error monitoring
+
+The client already reports uncaught errors and unhandled rejections, with breadcrumbs. React's
+render errors never reach `window.onerror` in production, so catch them the way Sentry's React SDK
+does (`Sentry.ErrorBoundary` → `GuidelyErrorBoundary`, `withErrorBoundary` →
+`withGuidelyErrorBoundary`, `reactErrorHandler` → `guidelyReactErrorHandler`):
+
+```tsx
+import { GuidelyErrorBoundary, guidelyReactErrorHandler, useGuidely } from "@guidelytech/react";
+
+<GuidelyErrorBoundary
+  fallback={({ error, eventId, resetError }) => <Oops onRetry={resetError} reference={eventId} />}
+  tags={{ area: "checkout" }}
+  beforeCapture={(context, error, componentStack) => { context.extra = { cartId }; }}
+>
+  <Checkout />
+</GuidelyErrorBoundary>;
+
+// React 19 roots: errors no boundary catches, caught ones and recovered hydration errors.
+createRoot(el, { onUncaughtError: guidelyReactErrorHandler(), onCaughtError: guidelyReactErrorHandler(), onRecoverableError: guidelyReactErrorHandler() });
+
+// Anywhere below the provider: the full capture API.
+const guidely = useGuidely();
+guidely.captureException(err, { tags: { area: "billing" }, level: "warning" });
+guidely.addBreadcrumb({ category: "cart", message: "Coupon applied" });
+```
+
+| Export | Description |
+|---|---|
+| `<GuidelyErrorBoundary>` | Reports render errors (`mechanism: react.errorboundary`, the component stack in `contexts.react`) and renders `fallback` (an element or `({ error, componentStack, eventId, resetError }) => …`; nothing without one). Props: `onError`, `beforeCapture(context, error, componentStack)`, `onReset`, `tags`, `extra`, `fingerprint`, `level`, `handled` (default: a fallback was given), `showDialog`, `client`. Errors in the provider's first render are sent as soon as it has its client. |
+| `withGuidelyErrorBoundary(Component, props)` | The HOC form. |
+| `useCaptureException(error, hint?)` | Reports an error page's `error` prop once (Next.js `error.tsx`, React Router `errorElement`); returns the event id. |
+| `guidelyReactErrorHandler(client?, callback?)` | For `createRoot`/`hydrateRoot`'s `onUncaughtError` / `onCaughtError` / `onRecoverableError`. Errors a `GuidelyErrorBoundary` caught are left to it; each error object is sent once. `callback` replaces React's logging. |
+| `useGuidely().captureException` / `captureMessage` / `addBreadcrumb` / `setTag(s)` / `setExtra(s)` / `setContext` / `setUser` | The client's capture API (no-ops that return `""` before the provider has a client). |
+
+Options go under `errors` on the provider (`<GuidelyProvider errors={{ sampleRate: 0.5, beforeSend }}>`).
+
 Types re-exported: `GuidelyClient`, `GuidelyOptions`, `GuidelyEvents`, `GuidelyUser`,
-`ChecklistProgressState`, `PublishedGuide`, `GuideState`, `GuidelyProviderProps`, and from
+`ChecklistProgressState`, `PublishedGuide`, `GuideState`, `GuidelyProviderProps`,
+`GuidelyErrorBoundaryProps`, `ErrorBoundaryFallbackProps`, `ReactErrorInfo`, `Breadcrumb`,
+`CaptureContext`, `ErrorEvent`, `ErrorLevelName`, `ErrorMonitoringOptions`, `ExceptionDetail`, and from
 `@guidelytech/flags`: `FlagsClient`, `FlagsClientOptions`, `FlagDetails`, `FlagsBootstrap`,
 `FlagsPayload`, `Attributes`, `JsonValue`, `EvaluationResult`.

package/dist/index.cjs

@@ -4,6 +4,7 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -17,6 +18,7 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 // src/index.tsx
 var index_exports = {};
@@ -25,8 +27,11 @@ __export(index_exports, {
   FeatureFlag: () => FeatureFlag,
   FeatureValue: () => FeatureValue,
   FlagsProvider: () => FlagsProvider,
+  GuidelyErrorBoundary: () => GuidelyErrorBoundary,
   GuidelyProvider: () => GuidelyProvider,
+  guidelyReactErrorHandler: () => guidelyReactErrorHandler,
   noopClient: () => noopClient,
+  useCaptureException: () => useCaptureException,
   useChecklistProgress: () => useChecklistProgress,
   useFeatureValue: () => useFeatureValue,
   useFlag: () => useFlag,
@@ -38,26 +43,151 @@ __export(index_exports, {
   useGuidely: () => useGuidely,
   useGuidelyEvent: () => useGuidelyEvent,
   useGuidelyIdentify: () => useGuidelyIdentify,
-  useGuidelyReady: () => useGuidelyReady
+  useGuidelyReady: () => useGuidelyReady,
+  withGuidelyErrorBoundary: () => withGuidelyErrorBoundary
 });
 module.exports = __toCommonJS(index_exports);
 var import_flags2 = require("@guidelytech/flags");
+var import_sdk_core2 = require("@guidelytech/sdk-core");
+var import_react4 = require("react");
+
+// src/context.ts
+var import_react = require("react");
+var GuidelyContext = (0, import_react.createContext)(null);
+
+// src/errors.tsx
 var import_sdk_core = require("@guidelytech/sdk-core");
 var import_react2 = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var reported = /* @__PURE__ */ new WeakSet();
+var stackOf = (info) => (info?.componentStack ?? "").slice(0, 8e3);
+function liveClient(client) {
+  try {
+    if (client && !client.getState().destroyed) return client;
+    const current = import_sdk_core.GuidelyClient.get();
+    return current && !current.getState().destroyed ? current : null;
+  } catch {
+    return null;
+  }
+}
+var pending = [];
+function drainPendingErrors(client) {
+  for (const p of pending.splice(0)) {
+    let eventId = "";
+    try {
+      eventId = client.captureException(p.error, p.ctx) || "";
+    } catch {
+    }
+    if (eventId) p.done?.(eventId);
+  }
+}
+function capture(client, error, ctx, done) {
+  if (error && typeof error === "object") {
+    if (reported.has(error)) return "";
+    reported.add(error);
+  }
+  const c = liveClient(client);
+  if (!c) {
+    if (pending.length < 10) pending.push({ error, ctx, done });
+    return "";
+  }
+  try {
+    return c.captureException(error, ctx) || "";
+  } catch {
+    return "";
+  }
+}
+var EMPTY = { error: null, componentStack: "", eventId: "" };
+var GuidelyErrorBoundary = class extends import_react2.Component {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "state", { ...EMPTY, failed: false });
+    __publicField(this, "resetError", () => {
+      const { error, componentStack, eventId } = this.state;
+      this.props.onReset?.(error, componentStack, eventId);
+      this.setState({ ...EMPTY, failed: false });
+    });
+  }
+  static getDerivedStateFromError(error) {
+    return { error, failed: true };
+  }
+  componentDidCatch(error, info) {
+    const { tags, extra, fingerprint, level, handled, fallback, beforeCapture, onError, showDialog } = this.props;
+    const componentStack = stackOf(info);
+    const ctx = {
+      level: level ?? "error",
+      ...tags ? { tags: { ...tags } } : {},
+      ...extra ? { extra: { ...extra } } : {},
+      ...fingerprint ? { fingerprint } : {},
+      contexts: { react: { version: import_react2.version, componentStack } },
+      mechanism: { type: "react.errorboundary", handled: handled ?? !!fallback }
+    };
+    try {
+      beforeCapture?.(ctx, error, componentStack);
+    } catch {
+    }
+    const client = this.props.client ?? this.context;
+    const eventId = capture(client, error, ctx, (id) => {
+      if (this.state.error === error) this.setState({ eventId: id });
+    });
+    this.setState({ componentStack, eventId });
+    onError?.(error, componentStack, eventId);
+    if (showDialog && eventId) {
+      try {
+        liveClient(client)?.showBugReport?.();
+      } catch {
+      }
+    }
+  }
+  render() {
+    if (!this.state.failed) return this.props.children;
+    const { fallback } = this.props;
+    if (typeof fallback === "function") return fallback({ error: this.state.error, componentStack: this.state.componentStack, eventId: this.state.eventId, resetError: this.resetError });
+    return fallback ?? null;
+  }
+};
+__publicField(GuidelyErrorBoundary, "contextType", GuidelyContext);
+function withGuidelyErrorBoundary(Wrapped, options = {}) {
+  const name = Wrapped.displayName || Wrapped.name || "Component";
+  const WithBoundary = (props) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(GuidelyErrorBoundary, { ...options, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Wrapped, { ...props }) });
+  WithBoundary.displayName = `guidelyErrorBoundary(${name})`;
+  return WithBoundary;
+}
+function useCaptureException(error, hint) {
+  const client = (0, import_react2.useContext)(GuidelyContext);
+  const [eventId, setEventId] = (0, import_react2.useState)("");
+  (0, import_react2.useEffect)(() => {
+    if (error === null || error === void 0) return;
+    const id = capture(client, error, { ...hint ?? {}, mechanism: hint?.mechanism ?? { type: "react.errorpage", handled: true } }, setEventId);
+    if (id) setEventId(id);
+  }, [client, error]);
+  return eventId;
+}
+function guidelyReactErrorHandler(client, callback) {
+  return (error, errorInfo = {}) => {
+    let eventId = "";
+    if (!(errorInfo.errorBoundary instanceof GuidelyErrorBoundary)) {
+      const caught = errorInfo.errorBoundary !== void 0 && errorInfo.errorBoundary !== null;
+      eventId = capture(client ?? null, error, { contexts: { react: { version: import_react2.version, componentStack: stackOf(errorInfo) } }, mechanism: { type: "react", handled: caught } });
+    }
+    if (callback) callback(error, errorInfo, eventId);
+    else console.error(error);
+  };
+}
 
 // src/flags.tsx
 var import_flags = require("@guidelytech/flags");
-var import_react = require("react");
-var import_jsx_runtime = require("react/jsx-runtime");
-var FlagsContext = (0, import_react.createContext)(null);
-var EMPTY = (0, import_flags.createStaticFlags)();
+var import_react3 = require("react");
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var FlagsContext = (0, import_react3.createContext)(null);
+var EMPTY2 = (0, import_flags.createStaticFlags)();
 function useReader() {
-  const src = (0, import_react.useContext)(FlagsContext);
-  return src?.client ?? src?.bootstrap ?? EMPTY;
+  const src = (0, import_react3.useContext)(FlagsContext);
+  return src?.client ?? src?.bootstrap ?? EMPTY2;
 }
 function useFlagsValue(select) {
   const reader = useReader();
-  const cache = (0, import_react.useRef)(null);
+  const cache = (0, import_react3.useRef)(null);
   const get = () => {
     const value = select(reader);
     const c = cache.current;
@@ -65,7 +195,7 @@ function useFlagsValue(select) {
     cache.current = { reader, value };
     return value;
   };
-  return (0, import_react.useSyncExternalStore)(reader.subscribe, get, get);
+  return (0, import_react3.useSyncExternalStore)(reader.subscribe, get, get);
 }
 function useFlag(key, fallback = false) {
   return useFlagsValue((r) => r.isEnabled(key, fallback));
@@ -83,29 +213,29 @@ function useFlagsReady() {
   return useFlagsValue((r) => r.isReady());
 }
 function useFlagsClient() {
-  return (0, import_react.useContext)(FlagsContext)?.client ?? null;
+  return (0, import_react3.useContext)(FlagsContext)?.client ?? null;
 }
 function Feature({ flag, children, fallback = null }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: useFlag(flag) ? children : fallback });
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children: useFlag(flag) ? children : fallback });
 }
 var FeatureFlag = Feature;
 function FeatureValue({ flag, value, children, fallback = null }) {
   const current = useFeatureValue(flag, null);
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: (0, import_flags.jsonEquals)(current, value) ? children : fallback });
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children: (0, import_flags.jsonEquals)(current, value) ? children : fallback });
 }
 function useBootstrap(payload, attributes) {
   const key = (0, import_flags.stableStringify)(attributes);
-  return (0, import_react.useMemo)(() => payload ? (0, import_flags.createStaticFlags)({ payload, attributes }) : EMPTY, [payload, key]);
+  return (0, import_react3.useMemo)(() => payload ? (0, import_flags.createStaticFlags)({ payload, attributes }) : EMPTY2, [payload, key]);
 }
 function FlagsProvider({ children, client: external, payload, ...options }) {
-  const [created, setCreated] = (0, import_react.useState)(null);
-  const optionsRef = (0, import_react.useRef)(options);
+  const [created, setCreated] = (0, import_react3.useState)(null);
+  const optionsRef = (0, import_react3.useRef)(options);
   optionsRef.current = options;
   const sdkKey = options.sdkKey ?? options.projectId;
   const { apiUrl, environment } = options;
-  const payloadRef = (0, import_react.useRef)(payload);
+  const payloadRef = (0, import_react3.useRef)(payload);
   payloadRef.current = payload;
-  (0, import_react.useEffect)(() => {
+  (0, import_react3.useEffect)(() => {
     if (external || !sdkKey || typeof window === "undefined") return;
     let c;
     try {
@@ -123,51 +253,51 @@ function FlagsProvider({ children, client: external, payload, ...options }) {
   const client = external ?? created;
   const attributes = options.attributes ?? {};
   const attrsKey = (0, import_flags.stableStringify)(attributes);
-  (0, import_react.useEffect)(() => {
+  (0, import_react3.useEffect)(() => {
     if (client && options.attributes) client.setAttributes(options.attributes);
   }, [client, attrsKey]);
   const bootstrap = useBootstrap(payload, attributes);
-  const value = (0, import_react.useMemo)(() => ({ client, bootstrap }), [client, bootstrap]);
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(FlagsContext.Provider, { value, children });
+  const value = (0, import_react3.useMemo)(() => ({ client, bootstrap }), [client, bootstrap]);
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(FlagsContext.Provider, { value, children });
 }
 
 // src/index.tsx
-var import_jsx_runtime2 = require("react/jsx-runtime");
-var GuidelyContext = (0, import_react2.createContext)(null);
+var import_jsx_runtime3 = require("react/jsx-runtime");
 function userAttributes(user) {
   if (!user?.id) return {};
   return { ...user.traits ?? {}, id: user.id, ...user.account ? { account: { ...user.account.traits ?? {}, id: user.account.id } } : {} };
 }
 function GuidelyProvider({ children, user, flagsPayload, flagAttributes, ...options }) {
-  const [client, setClient] = (0, import_react2.useState)(null);
-  const optionsRef = (0, import_react2.useRef)(options);
+  const [client, setClient] = (0, import_react4.useState)(null);
+  const optionsRef = (0, import_react4.useRef)(options);
   optionsRef.current = options;
-  const userRef = (0, import_react2.useRef)(user);
+  const userRef = (0, import_react4.useRef)(user);
   userRef.current = user;
   const flagsOpts = options.flags === false ? null : options.flags ?? {};
   const payload = flagsPayload ?? flagsOpts?.payload ?? null;
-  const payloadRef = (0, import_react2.useRef)(payload);
+  const payloadRef = (0, import_react4.useRef)(payload);
   payloadRef.current = payload;
-  const appAttributes = (0, import_react2.useMemo)(() => ({ ...flagsOpts?.attributes ?? {}, ...flagAttributes ?? {} }), [(0, import_flags2.stableStringify)(flagsOpts?.attributes ?? {}), (0, import_flags2.stableStringify)(flagAttributes ?? {})]);
-  const appAttributesRef = (0, import_react2.useRef)(appAttributes);
+  const appAttributes = (0, import_react4.useMemo)(() => ({ ...flagsOpts?.attributes ?? {}, ...flagAttributes ?? {} }), [(0, import_flags2.stableStringify)(flagsOpts?.attributes ?? {}), (0, import_flags2.stableStringify)(flagAttributes ?? {})]);
+  const appAttributesRef = (0, import_react4.useRef)(appAttributes);
   appAttributesRef.current = appAttributes;
   const { projectId, environment, apiUrl } = options;
-  (0, import_react2.useEffect)(() => {
+  (0, import_react4.useEffect)(() => {
     if (typeof window === "undefined" || !projectId) return;
     const o = optionsRef.current;
-    const c = (0, import_sdk_core.createGuidely)({ ...o, projectId, environment, apiUrl, user: userRef.current?.id ? userRef.current : void 0, flags: o.flags === false ? false : { ...o.flags ?? {}, payload: payloadRef.current ?? void 0, attributes: appAttributesRef.current } });
+    const c = (0, import_sdk_core2.createGuidely)({ ...o, projectId, environment, apiUrl, user: userRef.current?.id ? userRef.current : void 0, flags: o.flags === false ? false : { ...o.flags ?? {}, payload: payloadRef.current ?? void 0, attributes: appAttributesRef.current } });
     setClient(c);
+    drainPendingErrors(c);
     return () => {
       c.destroy();
       setClient((cur) => cur === c ? null : cur);
     };
   }, [projectId, environment, apiUrl]);
-  (0, import_react2.useEffect)(() => {
+  (0, import_react4.useEffect)(() => {
     client?.flags.setAttributes(appAttributes);
   }, [client, appAttributes]);
   const userKey = user ? JSON.stringify([user.id, user.traits ?? null, user.account ?? null]) : "";
-  const hadUser = (0, import_react2.useRef)(false);
-  (0, import_react2.useEffect)(() => {
+  const hadUser = (0, import_react4.useRef)(false);
+  (0, import_react4.useEffect)(() => {
     if (!client) return;
     if (user && user.id) {
       hadUser.current = true;
@@ -178,8 +308,8 @@ function GuidelyProvider({ children, user, flagsPayload, flagAttributes, ...opti
     }
   }, [client, userKey]);
   const bootstrap = useBootstrap(payload, { ...userAttributes(user), ...appAttributes });
-  const flags = (0, import_react2.useMemo)(() => ({ client: client?.flags ?? null, bootstrap }), [client, bootstrap]);
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(GuidelyContext.Provider, { value: client, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(FlagsContext.Provider, { value: flags, children }) });
+  const flags = (0, import_react4.useMemo)(() => ({ client: client?.flags ?? null, bootstrap }), [client, bootstrap]);
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(GuidelyContext.Provider, { value: client, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(FlagsContext.Provider, { value: flags, children }) });
 }
 var NOOP_RESULTS = {
   init: Promise.resolve(),
@@ -200,7 +330,9 @@ var NOOP_RESULTS = {
   getSessionId: "",
   isRecording: false,
   agentConversation: false,
-  trackAgentTurn: false
+  trackAgentTurn: false,
+  captureException: "",
+  captureMessage: ""
 };
 var noopFlags = new Proxy((0, import_flags2.createStaticFlags)(), {
   get(target, prop, receiver) {
@@ -228,12 +360,12 @@ var noopClient = new Proxy({}, {
   }
 });
 function useGuidely() {
-  return (0, import_react2.useContext)(GuidelyContext) ?? noopClient;
+  return (0, import_react4.useContext)(GuidelyContext) ?? noopClient;
 }
 function useGuidelyReady() {
-  const client = (0, import_react2.useContext)(GuidelyContext);
-  const [ready, setReady] = (0, import_react2.useState)(false);
-  (0, import_react2.useEffect)(() => {
+  const client = (0, import_react4.useContext)(GuidelyContext);
+  const [ready, setReady] = (0, import_react4.useState)(false);
+  (0, import_react4.useEffect)(() => {
     if (!client) {
       setReady(false);
       return;
@@ -244,27 +376,27 @@ function useGuidelyReady() {
   return ready;
 }
 function useGuidelyIdentify(userId, traits, account) {
-  const client = (0, import_react2.useContext)(GuidelyContext);
+  const client = (0, import_react4.useContext)(GuidelyContext);
   const key = JSON.stringify([userId ?? null, traits ?? null, account ?? null]);
-  (0, import_react2.useEffect)(() => {
+  (0, import_react4.useEffect)(() => {
     if (!client || !userId) return;
     void client.identify(userId, traits, account);
   }, [client, key]);
 }
 function useGuidelyEvent(event, handler) {
-  const client = (0, import_react2.useContext)(GuidelyContext);
-  const ref = (0, import_react2.useRef)(handler);
+  const client = (0, import_react4.useContext)(GuidelyContext);
+  const ref = (0, import_react4.useRef)(handler);
   ref.current = handler;
-  (0, import_react2.useEffect)(() => {
+  (0, import_react4.useEffect)(() => {
     if (!client) return;
     const cb = ((...args) => ref.current(...args));
     return client.on(event, cb);
   }, [client, event]);
 }
 function useChecklistProgress(idOrKey) {
-  const client = (0, import_react2.useContext)(GuidelyContext);
-  const [progress, setProgress] = (0, import_react2.useState)({ completedTaskIds: [], completedAt: null, dismissedAt: null });
-  (0, import_react2.useEffect)(() => {
+  const client = (0, import_react4.useContext)(GuidelyContext);
+  const [progress, setProgress] = (0, import_react4.useState)({ completedTaskIds: [], completedAt: null, dismissedAt: null });
+  (0, import_react4.useEffect)(() => {
     if (!client) return;
     const update = () => setProgress(client.getChecklistProgress(idOrKey));
     update();
@@ -274,9 +406,9 @@ function useChecklistProgress(idOrKey) {
   return progress;
 }
 function useGuideState(idOrKey) {
-  const client = (0, import_react2.useContext)(GuidelyContext);
-  const [state, setState] = (0, import_react2.useState)({ active: false, completed: false, stepId: null, stepIndex: -1, guide: null });
-  (0, import_react2.useEffect)(() => {
+  const client = (0, import_react4.useContext)(GuidelyContext);
+  const [state, setState] = (0, import_react4.useState)({ active: false, completed: false, stepId: null, stepIndex: -1, guide: null });
+  (0, import_react4.useEffect)(() => {
     if (!client) return;
     const matches = (g) => g.id === idOrKey || g.key === idOrKey;
     const compute = () => {
@@ -297,8 +429,11 @@ function useGuideState(idOrKey) {
   FeatureFlag,
   FeatureValue,
   FlagsProvider,
+  GuidelyErrorBoundary,
   GuidelyProvider,
+  guidelyReactErrorHandler,
   noopClient,
+  useCaptureException,
   useChecklistProgress,
   useFeatureValue,
   useFlag,
@@ -310,6 +445,7 @@ function useGuideState(idOrKey) {
   useGuidely,
   useGuidelyEvent,
   useGuidelyIdentify,
-  useGuidelyReady
+  useGuidelyReady,
+  withGuidelyErrorBoundary
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.tsx","../src/flags.tsx"],"sourcesContent":["import { createStaticFlags, stableStringify, type Attributes, type FlagDetails, type FlagsBootstrap, type FlagsClient } from \"@guidelytech/flags\";\nimport { createGuidely, type ChecklistProgressState, type GuidelyClient, type GuidelyEvents, type GuidelyOptions, type GuidelyUser, type PublishedGuide } from \"@guidelytech/sdk-core\";\nimport { createContext, useContext, useEffect, useMemo, useRef, useState, type ReactNode } from \"react\";\nimport { FlagsContext, useBootstrap, type FlagsSource } from \"./flags\";\n\nexport type { GuidelyClient, GuidelyOptions, GuidelyEvents, GuidelyUser, ChecklistProgressState, PublishedGuide, AgentTurnInput, AgentTurnRedactor } from \"@guidelytech/sdk-core\";\nexport { useFlag, useFeatureValue, useFlagDetails, useFlags, useFlagsReady, useFlagsClient, Feature, FeatureFlag, FeatureValue, FlagsProvider } from \"./flags\";\nexport type { FeatureProps, FeatureValueProps, FlagsProviderProps } from \"./flags\";\nexport type { FlagsClient, FlagsClientOptions, FlagDetails, FlagsBootstrap, FlagsPayload, Attributes, JsonValue, EvaluationResult } from \"@guidelytech/flags\";\n\nconst GuidelyContext = createContext<GuidelyClient | null>(null);\n\nexport interface GuidelyProviderProps extends Omit<GuidelyOptions, \"user\"> {\n  /** Identify this user as soon as the client is ready; `undefined` resets the identity. */\n  user?: GuidelyUser | null;\n  /**\n   * Flags bootstrap from the server (`getFlagsBootstrap()` / `client.getPayload()`): flag hooks\n   * render the same values on the server, during hydration and after.\n   */\n  flagsPayload?: FlagsBootstrap | null;\n  /** Extra flag attributes (merged over the automatic identity, page and device attributes). */\n  flagAttributes?: Attributes;\n  children?: ReactNode;\n}\n\n/** The attributes the server knows about a user: what bootstrap snapshots evaluate with. */\nfunction userAttributes(user: GuidelyUser | null | undefined): Attributes {\n  if (!user?.id) return {};\n  return { ...(user.traits ?? {}), id: user.id, ...(user.account ? { account: { ...(user.account.traits ?? {}), id: user.account.id } } : {}) };\n}\n\n/**\n * Creates one Guidely client for the subtree. The client is created inside an effect (never\n * during SSR) and destroyed on unmount, so React Strict Mode's double-invoke is harmless.\n */\nexport function GuidelyProvider({ children, user, flagsPayload, flagAttributes, ...options }: GuidelyProviderProps) {\n  const [client, setClient] = useState<GuidelyClient | null>(null);\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  const userRef = useRef(user);\n  userRef.current = user;\n  const flagsOpts = options.flags === false ? null : (options.flags ?? {});\n  const payload = flagsPayload ?? flagsOpts?.payload ?? null;\n  const payloadRef = useRef(payload);\n  payloadRef.current = payload;\n  const appAttributes = useMemo(() => ({ ...(flagsOpts?.attributes ?? {}), ...(flagAttributes ?? {}) }), [stableStringify(flagsOpts?.attributes ?? {}), stableStringify(flagAttributes ?? {})]);\n  const appAttributesRef = useRef(appAttributes);\n  appAttributesRef.current = appAttributes;\n  const { projectId, environment, apiUrl } = options;\n\n  useEffect(() => {\n    if (typeof window === \"undefined\" || !projectId) return;\n    const o = optionsRef.current;\n    // The user is known up front so flags evaluate for them from the first render (no flicker).\n    const c = createGuidely({ ...o, projectId, environment, apiUrl, user: userRef.current?.id ? userRef.current : undefined, flags: o.flags === false ? false : { ...(o.flags ?? {}), payload: payloadRef.current ?? undefined, attributes: appAttributesRef.current } });\n    setClient(c);\n    return () => {\n      c.destroy();\n      setClient((cur) => (cur === c ? null : cur));\n    };\n  }, [projectId, environment, apiUrl]);\n\n  useEffect(() => {\n    client?.flags.setAttributes(appAttributes);\n  }, [client, appAttributes]);\n\n  const userKey = user ? JSON.stringify([user.id, user.traits ?? null, user.account ?? null]) : \"\";\n  const hadUser = useRef(false);\n  useEffect(() => {\n    if (!client) return;\n    if (user && user.id) {\n      hadUser.current = true;\n      void client.identify(user.id, user.traits, user.account);\n    } else if (hadUser.current) {\n      hadUser.current = false;\n      client.reset();\n    }\n  }, [client, userKey]);\n\n  const bootstrap = useBootstrap(payload, { ...userAttributes(user), ...appAttributes });\n  const flags = useMemo<FlagsSource>(() => ({ client: client?.flags ?? null, bootstrap }), [client, bootstrap]);\n  return (\n    <GuidelyContext.Provider value={client}>\n      <FlagsContext.Provider value={flags}>{children}</FlagsContext.Provider>\n    </GuidelyContext.Provider>\n  );\n}\n\nconst NOOP_RESULTS: Record<string, unknown> = {\n  init: Promise.resolve(),\n  ready: Promise.resolve(),\n  identify: Promise.resolve(),\n  setAccount: Promise.resolve(),\n  updateTraits: Promise.resolve(),\n  refresh: Promise.resolve(),\n  startGuide: false,\n  getActiveGuide: null,\n  getGuides: [],\n  getChecklistProgress: { completedTaskIds: [], completedAt: null, dismissedAt: null },\n  isGuideCompleted: false,\n  on: () => {},\n  getState: { ready: false, destroyed: false },\n  getContext: null,\n  getSessionId: \"\",\n  isRecording: false,\n  agentConversation: false,\n  trackAgentTurn: false,\n};\n\n/** Flags that serve every fallback; `useGuidely().flags` before the provider has a client. */\nconst noopFlags = new Proxy(createStaticFlags() as unknown as FlagsClient, {\n  get(target, prop, receiver) {\n    if (prop in target) return Reflect.get(target, prop, receiver);\n    if (prop === \"ready\" || prop === \"refresh\" || prop === \"flush\") return () => Promise.resolve();\n    if (prop === \"getPayload\") return () => null;\n    if (prop === \"forUser\") return () => target;\n    return typeof prop === \"string\" ? () => undefined : undefined;\n  },\n});\n\nconst missing = <T,>(key: string, fallback: T): FlagDetails<T> => ({ key, value: fallback, reason: \"FLAG_NOT_FOUND\", inExperiment: false, usedFallback: true });\n\n/** Methods whose no-op answer depends on the arguments (flag getters return the fallback). */\nconst NOOP_FUNCTIONS: Record<string, (...args: any[]) => unknown> = {\n  isFeatureEnabled: (_key: string, fallback = false) => fallback,\n  getFeatureValue: (_key: string, fallback: unknown) => fallback,\n  getFeatureDetails: (key: string, fallback: unknown) => missing(key, fallback),\n  onFlagsChange: () => () => {},\n};\n\n/** A client that ignores every call; returned by `useGuidely()` on the server and before the provider mounts. */\nexport const noopClient: GuidelyClient = new Proxy({} as GuidelyClient, {\n  get(_target, prop) {\n    if (prop === \"options\") return { projectId: \"\" };\n    if (prop === \"flags\") return noopFlags;\n    if (typeof prop !== \"string\") return undefined;\n    return NOOP_FUNCTIONS[prop] ?? (() => NOOP_RESULTS[prop]);\n  },\n});\n\n/** The Guidely client, or a no-op client during SSR / before the provider has mounted. */\nexport function useGuidely(): GuidelyClient {\n  return useContext(GuidelyContext) ?? noopClient;\n}\n\n/** True once the client has loaded its configuration. */\nexport function useGuidelyReady(): boolean {\n  const client = useContext(GuidelyContext);\n  const [ready, setReady] = useState(false);\n  useEffect(() => {\n    if (!client) {\n      setReady(false);\n      return;\n    }\n    if (client.getState().ready) setReady(true);\n    return client.on(\"ready\", () => setReady(true));\n  }, [client]);\n  return ready;\n}\n\n/** Identifies the user whenever the arguments change. */\nexport function useGuidelyIdentify(userId: string | null | undefined, traits?: Record<string, unknown>, account?: GuidelyUser[\"account\"]): void {\n  const client = useContext(GuidelyContext);\n  const key = JSON.stringify([userId ?? null, traits ?? null, account ?? null]);\n  useEffect(() => {\n    if (!client || !userId) return;\n    void client.identify(userId, traits, account);\n  }, [client, key]);\n}\n\n/** Subscribes to a client event for the lifetime of the component. */\nexport function useGuidelyEvent<K extends keyof GuidelyEvents>(event: K, handler: GuidelyEvents[K]): void {\n  const client = useContext(GuidelyContext);\n  const ref = useRef(handler);\n  ref.current = handler;\n  useEffect(() => {\n    if (!client) return;\n    const cb = ((...args: unknown[]) => (ref.current as (...a: unknown[]) => void)(...args)) as GuidelyEvents[K];\n    return client.on(event, cb);\n  }, [client, event]);\n}\n\n/** Live checklist progress for a checklist guide (by id or key). */\nexport function useChecklistProgress(idOrKey: string): ChecklistProgressState {\n  const client = useContext(GuidelyContext);\n  const [progress, setProgress] = useState<ChecklistProgressState>({ completedTaskIds: [], completedAt: null, dismissedAt: null });\n  useEffect(() => {\n    if (!client) return;\n    const update = () => setProgress(client.getChecklistProgress(idOrKey));\n    update();\n    const offs = [client.on(\"ready\", update), client.on(\"identify\", update), client.on(\"checklist:task\", update), client.on(\"checklist:complete\", update)];\n    return () => offs.forEach((off) => off());\n  }, [client, idOrKey]);\n  return progress;\n}\n\nexport interface GuideState {\n  /** The guide is currently showing. */\n  active: boolean;\n  completed: boolean;\n  stepId: string | null;\n  stepIndex: number;\n  guide: PublishedGuide | null;\n}\n\n/** Live state of a guide (by id or key): active, completed, current step. */\nexport function useGuideState(idOrKey: string): GuideState {\n  const client = useContext(GuidelyContext);\n  const [state, setState] = useState<GuideState>({ active: false, completed: false, stepId: null, stepIndex: -1, guide: null });\n  useEffect(() => {\n    if (!client) return;\n    const matches = (g: PublishedGuide) => g.id === idOrKey || g.key === idOrKey;\n    const compute = () => {\n      const guide = client.getGuides().find(matches) ?? null;\n      const active = client.getActiveGuide();\n      const s = client.getState().activeGuide;\n      setState({ active: !!active && matches(active), completed: client.isGuideCompleted(idOrKey), stepId: active && matches(active) ? ((s as { stepId?: string | null } | null)?.stepId ?? null) : null, stepIndex: active && matches(active) ? ((s as { stepIndex?: number } | null)?.stepIndex ?? -1) : -1, guide });\n    };\n    compute();\n    const offs = ([\"ready\", \"identify\", \"guide:start\", \"guide:step\", \"guide:complete\", \"guide:dismiss\", \"guide:skip\"] as const).map((e) => client.on(e, compute));\n    return () => offs.forEach((off) => off());\n  }, [client, idOrKey]);\n  return state;\n}\n","import { createFlagsClient, createStaticFlags, jsonEquals, stableStringify, type Attributes, type FlagDetails, type FlagValue, type FlagsBootstrap, type FlagsClient, type FlagsClientOptions, type FlagsReader, type JsonValue } from \"@guidelytech/flags\";\nimport { createContext, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore, type ReactNode } from \"react\";\n\n/** What the flag hooks read: the live client once created, else a static snapshot of the bootstrap payload. */\nexport interface FlagsSource {\n  client: FlagsClient | null;\n  bootstrap: FlagsReader;\n}\n\nexport const FlagsContext = createContext<FlagsSource | null>(null);\n\nconst EMPTY = createStaticFlags();\n\nfunction useReader(): FlagsReader {\n  const src = useContext(FlagsContext);\n  return src?.client ?? src?.bootstrap ?? EMPTY;\n}\n\n/**\n * Subscribes to the flags with `useSyncExternalStore`. Values are compared deeply so object\n * flags keep their identity between renders. The server snapshot is the bootstrap payload, so\n * server-rendered HTML and hydration agree.\n */\nfunction useFlagsValue<T>(select: (reader: FlagsReader) => T): T {\n  const reader = useReader();\n  const cache = useRef<{ reader: FlagsReader; value: T } | null>(null);\n  const get = () => {\n    const value = select(reader);\n    const c = cache.current;\n    if (c && c.reader === reader && jsonEquals(c.value, value)) return c.value;\n    cache.current = { reader, value };\n    return value;\n  };\n  return useSyncExternalStore(reader.subscribe, get, get);\n}\n\n/** Is the boolean flag on? `fallback` (default `false`) until flags load, or when missing. */\nexport function useFlag(key: string, fallback = false): boolean {\n  return useFlagsValue((r) => r.isEnabled(key, fallback));\n}\n\n/** A flag's value (string, number, JSON…); `fallback` when missing or of a different type. */\nexport function useFeatureValue<T extends JsonValue>(key: string, fallback: T): FlagValue<T> {\n  return useFlagsValue((r) => r.getValue(key, fallback));\n}\n\n/** A flag's value plus why it was served (reason, rule, variation, experiment). */\nexport function useFlagDetails<T extends JsonValue>(key: string, fallback: T): FlagDetails<FlagValue<T>> {\n  return useFlagsValue((r) => r.getDetails(key, fallback));\n}\n\n/** Every flag's value (records no exposures). */\nexport function useFlags(): Record<string, JsonValue> {\n  return useFlagsValue((r) => r.getAll());\n}\n\n/** True once flags have loaded (or failed to and serve fallbacks); true from the start with a bootstrap payload. */\nexport function useFlagsReady(): boolean {\n  return useFlagsValue((r) => r.isReady());\n}\n\n/** The flags client (`null` on the server and before the provider has created it). */\nexport function useFlagsClient(): FlagsClient | null {\n  return useContext(FlagsContext)?.client ?? null;\n}\n\nexport interface FeatureProps {\n  flag: string;\n  children?: ReactNode;\n  /** Rendered while the flag is off (default: nothing). */\n  fallback?: ReactNode;\n}\n\n/** Renders `children` when the boolean flag is on, else `fallback`. */\nexport function Feature({ flag, children, fallback = null }: FeatureProps) {\n  return <>{useFlag(flag) ? children : fallback}</>;\n}\n\n/** Alias of {@link Feature}. */\nexport const FeatureFlag = Feature;\n\nexport interface FeatureValueProps extends FeatureProps {\n  /** Renders `children` when the flag's value equals this (deep equality). */\n  value: JsonValue;\n}\n\n/** Renders `children` when the flag's value equals `value` (e.g. an experiment variation), else `fallback`. */\nexport function FeatureValue({ flag, value, children, fallback = null }: FeatureValueProps) {\n  const current = useFeatureValue<JsonValue>(flag, null);\n  return <>{jsonEquals(current, value) ? children : fallback}</>;\n}\n\n/** A static snapshot for SSR and hydration, rebuilt only when the payload or attributes change. */\nexport function useBootstrap(payload: FlagsBootstrap | null | undefined, attributes: Attributes): FlagsReader {\n  const key = stableStringify(attributes);\n  return useMemo(() => (payload ? createStaticFlags({ payload, attributes }) : EMPTY), [payload, key]);\n}\n\nexport interface FlagsProviderProps extends Omit<FlagsClientOptions, \"payload\"> {\n  /** Bootstrap from the server (`getPayload()`): renders the same values on the server and in the browser. */\n  payload?: FlagsBootstrap | null;\n  /** Use an existing client instead of creating one. */\n  client?: FlagsClient;\n  children?: ReactNode;\n}\n\n/**\n * Feature flags only (no guides or analytics). Creates a flags client in an effect (never during\n * SSR) and destroys it on unmount; until then hooks read the `payload` snapshot. Changing\n * `attributes` re-evaluates without recreating the client.\n *\n * ```tsx\n * <FlagsProvider sdkKey=\"pk_prod_…\" attributes={{ id: user.id, plan: user.plan }} payload={bootstrap}>\n * ```\n */\nexport function FlagsProvider({ children, client: external, payload, ...options }: FlagsProviderProps) {\n  const [created, setCreated] = useState<FlagsClient | null>(null);\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  const sdkKey = options.sdkKey ?? options.projectId;\n  const { apiUrl, environment } = options;\n  const payloadRef = useRef(payload);\n  payloadRef.current = payload;\n\n  useEffect(() => {\n    if (external || !sdkKey || typeof window === \"undefined\") return;\n    let c: FlagsClient;\n    try {\n      c = createFlagsClient({ ...optionsRef.current, sdkKey, payload: payloadRef.current ?? undefined });\n    } catch (err) {\n      optionsRef.current.onError?.(err instanceof Error ? err : new Error(String(err)));\n      return;\n    }\n    setCreated(c);\n    return () => {\n      c.destroy();\n      setCreated((cur) => (cur === c ? null : cur));\n    };\n  }, [external, sdkKey, apiUrl, environment]);\n\n  const client = external ?? created;\n  const attributes = options.attributes ?? {};\n  const attrsKey = stableStringify(attributes);\n  useEffect(() => {\n    if (client && options.attributes) client.setAttributes(options.attributes);\n  }, [client, attrsKey]);\n\n  const bootstrap = useBootstrap(payload, attributes);\n  const value = useMemo<FlagsSource>(() => ({ client, bootstrap }), [client, bootstrap]);\n  return <FlagsContext.Provider value={value}>{children}</FlagsContext.Provider>;\n}\n"],"mappings":"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","names":["import_flags","import_react","import_jsx_runtime"]}
+{"version":3,"sources":["../src/index.tsx","../src/context.ts","../src/errors.tsx","../src/flags.tsx"],"sourcesContent":["import { createStaticFlags, stableStringify, type Attributes, type FlagDetails, type FlagsBootstrap, type FlagsClient } from \"@guidelytech/flags\";\nimport { createGuidely, type ChecklistProgressState, type GuidelyClient, type GuidelyEvents, type GuidelyOptions, type GuidelyUser, type PublishedGuide } from \"@guidelytech/sdk-core\";\nimport { useContext, useEffect, useMemo, useRef, useState, type ReactNode } from \"react\";\nimport { GuidelyContext } from \"./context\";\nimport { drainPendingErrors } from \"./errors\";\nimport { FlagsContext, useBootstrap, type FlagsSource } from \"./flags\";\n\nexport type { GuidelyClient, GuidelyOptions, GuidelyEvents, GuidelyUser, ChecklistProgressState, PublishedGuide, AgentTurnInput, AgentTurnRedactor } from \"@guidelytech/sdk-core\";\nexport { useFlag, useFeatureValue, useFlagDetails, useFlags, useFlagsReady, useFlagsClient, Feature, FeatureFlag, FeatureValue, FlagsProvider } from \"./flags\";\nexport type { FeatureProps, FeatureValueProps, FlagsProviderProps } from \"./flags\";\nexport type { FlagsClient, FlagsClientOptions, FlagDetails, FlagsBootstrap, FlagsPayload, Attributes, JsonValue, EvaluationResult } from \"@guidelytech/flags\";\nexport { GuidelyErrorBoundary, withGuidelyErrorBoundary, useCaptureException, guidelyReactErrorHandler } from \"./errors\";\nexport type { GuidelyErrorBoundaryProps, ErrorBoundaryFallbackProps, ReactErrorInfo } from \"./errors\";\nexport type { Breadcrumb, CaptureContext, ErrorEvent, ErrorLevelName, ErrorMonitoringOptions, ExceptionDetail } from \"@guidelytech/sdk-core\";\n\nexport interface GuidelyProviderProps extends Omit<GuidelyOptions, \"user\"> {\n  /** Identify this user as soon as the client is ready; `undefined` resets the identity. */\n  user?: GuidelyUser | null;\n  /**\n   * Flags bootstrap from the server (`getFlagsBootstrap()` / `client.getPayload()`): flag hooks\n   * render the same values on the server, during hydration and after.\n   */\n  flagsPayload?: FlagsBootstrap | null;\n  /** Extra flag attributes (merged over the automatic identity, page and device attributes). */\n  flagAttributes?: Attributes;\n  children?: ReactNode;\n}\n\n/** The attributes the server knows about a user: what bootstrap snapshots evaluate with. */\nfunction userAttributes(user: GuidelyUser | null | undefined): Attributes {\n  if (!user?.id) return {};\n  return { ...(user.traits ?? {}), id: user.id, ...(user.account ? { account: { ...(user.account.traits ?? {}), id: user.account.id } } : {}) };\n}\n\n/**\n * Creates one Guidely client for the subtree. The client is created inside an effect (never\n * during SSR) and destroyed on unmount, so React Strict Mode's double-invoke is harmless.\n */\nexport function GuidelyProvider({ children, user, flagsPayload, flagAttributes, ...options }: GuidelyProviderProps) {\n  const [client, setClient] = useState<GuidelyClient | null>(null);\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  const userRef = useRef(user);\n  userRef.current = user;\n  const flagsOpts = options.flags === false ? null : (options.flags ?? {});\n  const payload = flagsPayload ?? flagsOpts?.payload ?? null;\n  const payloadRef = useRef(payload);\n  payloadRef.current = payload;\n  const appAttributes = useMemo(() => ({ ...(flagsOpts?.attributes ?? {}), ...(flagAttributes ?? {}) }), [stableStringify(flagsOpts?.attributes ?? {}), stableStringify(flagAttributes ?? {})]);\n  const appAttributesRef = useRef(appAttributes);\n  appAttributesRef.current = appAttributes;\n  const { projectId, environment, apiUrl } = options;\n\n  useEffect(() => {\n    if (typeof window === \"undefined\" || !projectId) return;\n    const o = optionsRef.current;\n    // The user is known up front so flags evaluate for them from the first render (no flicker).\n    const c = createGuidely({ ...o, projectId, environment, apiUrl, user: userRef.current?.id ? userRef.current : undefined, flags: o.flags === false ? false : { ...(o.flags ?? {}), payload: payloadRef.current ?? undefined, attributes: appAttributesRef.current } });\n    setClient(c);\n    // Render errors caught before the client existed (the first render) go out now.\n    drainPendingErrors(c);\n    return () => {\n      c.destroy();\n      setClient((cur) => (cur === c ? null : cur));\n    };\n  }, [projectId, environment, apiUrl]);\n\n  useEffect(() => {\n    client?.flags.setAttributes(appAttributes);\n  }, [client, appAttributes]);\n\n  const userKey = user ? JSON.stringify([user.id, user.traits ?? null, user.account ?? null]) : \"\";\n  const hadUser = useRef(false);\n  useEffect(() => {\n    if (!client) return;\n    if (user && user.id) {\n      hadUser.current = true;\n      void client.identify(user.id, user.traits, user.account);\n    } else if (hadUser.current) {\n      hadUser.current = false;\n      client.reset();\n    }\n  }, [client, userKey]);\n\n  const bootstrap = useBootstrap(payload, { ...userAttributes(user), ...appAttributes });\n  const flags = useMemo<FlagsSource>(() => ({ client: client?.flags ?? null, bootstrap }), [client, bootstrap]);\n  return (\n    <GuidelyContext.Provider value={client}>\n      <FlagsContext.Provider value={flags}>{children}</FlagsContext.Provider>\n    </GuidelyContext.Provider>\n  );\n}\n\nconst NOOP_RESULTS: Record<string, unknown> = {\n  init: Promise.resolve(),\n  ready: Promise.resolve(),\n  identify: Promise.resolve(),\n  setAccount: Promise.resolve(),\n  updateTraits: Promise.resolve(),\n  refresh: Promise.resolve(),\n  startGuide: false,\n  getActiveGuide: null,\n  getGuides: [],\n  getChecklistProgress: { completedTaskIds: [], completedAt: null, dismissedAt: null },\n  isGuideCompleted: false,\n  on: () => {},\n  getState: { ready: false, destroyed: false },\n  getContext: null,\n  getSessionId: \"\",\n  isRecording: false,\n  agentConversation: false,\n  trackAgentTurn: false,\n  captureException: \"\",\n  captureMessage: \"\",\n};\n\n/** Flags that serve every fallback; `useGuidely().flags` before the provider has a client. */\nconst noopFlags = new Proxy(createStaticFlags() as unknown as FlagsClient, {\n  get(target, prop, receiver) {\n    if (prop in target) return Reflect.get(target, prop, receiver);\n    if (prop === \"ready\" || prop === \"refresh\" || prop === \"flush\") return () => Promise.resolve();\n    if (prop === \"getPayload\") return () => null;\n    if (prop === \"forUser\") return () => target;\n    return typeof prop === \"string\" ? () => undefined : undefined;\n  },\n});\n\nconst missing = <T,>(key: string, fallback: T): FlagDetails<T> => ({ key, value: fallback, reason: \"FLAG_NOT_FOUND\", inExperiment: false, usedFallback: true });\n\n/** Methods whose no-op answer depends on the arguments (flag getters return the fallback). */\nconst NOOP_FUNCTIONS: Record<string, (...args: any[]) => unknown> = {\n  isFeatureEnabled: (_key: string, fallback = false) => fallback,\n  getFeatureValue: (_key: string, fallback: unknown) => fallback,\n  getFeatureDetails: (key: string, fallback: unknown) => missing(key, fallback),\n  onFlagsChange: () => () => {},\n};\n\n/** A client that ignores every call; returned by `useGuidely()` on the server and before the provider mounts. */\nexport const noopClient: GuidelyClient = new Proxy({} as GuidelyClient, {\n  get(_target, prop) {\n    if (prop === \"options\") return { projectId: \"\" };\n    if (prop === \"flags\") return noopFlags;\n    if (typeof prop !== \"string\") return undefined;\n    return NOOP_FUNCTIONS[prop] ?? (() => NOOP_RESULTS[prop]);\n  },\n});\n\n/** The Guidely client, or a no-op client during SSR / before the provider has mounted. */\nexport function useGuidely(): GuidelyClient {\n  return useContext(GuidelyContext) ?? noopClient;\n}\n\n/** True once the client has loaded its configuration. */\nexport function useGuidelyReady(): boolean {\n  const client = useContext(GuidelyContext);\n  const [ready, setReady] = useState(false);\n  useEffect(() => {\n    if (!client) {\n      setReady(false);\n      return;\n    }\n    if (client.getState().ready) setReady(true);\n    return client.on(\"ready\", () => setReady(true));\n  }, [client]);\n  return ready;\n}\n\n/** Identifies the user whenever the arguments change. */\nexport function useGuidelyIdentify(userId: string | null | undefined, traits?: Record<string, unknown>, account?: GuidelyUser[\"account\"]): void {\n  const client = useContext(GuidelyContext);\n  const key = JSON.stringify([userId ?? null, traits ?? null, account ?? null]);\n  useEffect(() => {\n    if (!client || !userId) return;\n    void client.identify(userId, traits, account);\n  }, [client, key]);\n}\n\n/** Subscribes to a client event for the lifetime of the component. */\nexport function useGuidelyEvent<K extends keyof GuidelyEvents>(event: K, handler: GuidelyEvents[K]): void {\n  const client = useContext(GuidelyContext);\n  const ref = useRef(handler);\n  ref.current = handler;\n  useEffect(() => {\n    if (!client) return;\n    const cb = ((...args: unknown[]) => (ref.current as (...a: unknown[]) => void)(...args)) as GuidelyEvents[K];\n    return client.on(event, cb);\n  }, [client, event]);\n}\n\n/** Live checklist progress for a checklist guide (by id or key). */\nexport function useChecklistProgress(idOrKey: string): ChecklistProgressState {\n  const client = useContext(GuidelyContext);\n  const [progress, setProgress] = useState<ChecklistProgressState>({ completedTaskIds: [], completedAt: null, dismissedAt: null });\n  useEffect(() => {\n    if (!client) return;\n    const update = () => setProgress(client.getChecklistProgress(idOrKey));\n    update();\n    const offs = [client.on(\"ready\", update), client.on(\"identify\", update), client.on(\"checklist:task\", update), client.on(\"checklist:complete\", update)];\n    return () => offs.forEach((off) => off());\n  }, [client, idOrKey]);\n  return progress;\n}\n\nexport interface GuideState {\n  /** The guide is currently showing. */\n  active: boolean;\n  completed: boolean;\n  stepId: string | null;\n  stepIndex: number;\n  guide: PublishedGuide | null;\n}\n\n/** Live state of a guide (by id or key): active, completed, current step. */\nexport function useGuideState(idOrKey: string): GuideState {\n  const client = useContext(GuidelyContext);\n  const [state, setState] = useState<GuideState>({ active: false, completed: false, stepId: null, stepIndex: -1, guide: null });\n  useEffect(() => {\n    if (!client) return;\n    const matches = (g: PublishedGuide) => g.id === idOrKey || g.key === idOrKey;\n    const compute = () => {\n      const guide = client.getGuides().find(matches) ?? null;\n      const active = client.getActiveGuide();\n      const s = client.getState().activeGuide;\n      setState({ active: !!active && matches(active), completed: client.isGuideCompleted(idOrKey), stepId: active && matches(active) ? ((s as { stepId?: string | null } | null)?.stepId ?? null) : null, stepIndex: active && matches(active) ? ((s as { stepIndex?: number } | null)?.stepIndex ?? -1) : -1, guide });\n    };\n    compute();\n    const offs = ([\"ready\", \"identify\", \"guide:start\", \"guide:step\", \"guide:complete\", \"guide:dismiss\", \"guide:skip\"] as const).map((e) => client.on(e, compute));\n    return () => offs.forEach((off) => off());\n  }, [client, idOrKey]);\n  return state;\n}\n","import type { GuidelyClient } from \"@guidelytech/sdk-core\";\nimport { createContext } from \"react\";\n\n/** The provider's client (null outside a `GuidelyProvider` and before it has created one). */\nexport const GuidelyContext = createContext<GuidelyClient | null>(null);\n","import { GuidelyClient, type CaptureContext, type ErrorLevelName } from \"@guidelytech/sdk-core\";\nimport { Component, useContext, useEffect, useState, version, type ComponentType, type ErrorInfo, type ReactNode } from \"react\";\nimport { GuidelyContext } from \"./context\";\n\n/**\n * Error monitoring for React (Sentry's `ErrorBoundary`, `withErrorBoundary` and `reactErrorHandler`):\n * render errors become `exception` events with the component stack in `contexts.react`. Kept out\n * of index.tsx so the provider only re-exports it.\n */\n\n/** Errors already reported, so a boundary and a root error handler never send the same error twice. */\nconst reported = new WeakSet<object>();\n\n/** The component stack React reports, trimmed (it rides in the error's 64 KB detail). */\nconst stackOf = (info: { componentStack?: string | null } | undefined) => (info?.componentStack ?? \"\").slice(0, 8000);\n\n/** The given client, else the provider's, else the live client `createGuidely()` made. Null when none is usable. */\nfunction liveClient(client: GuidelyClient | null | undefined): GuidelyClient | null {\n  try {\n    if (client && !client.getState().destroyed) return client;\n    const current = GuidelyClient.get();\n    return current && !current.getState().destroyed ? current : null;\n  } catch {\n    return null;\n  }\n}\n\n/** `captureException`'s second argument. */\ntype Hint = CaptureContext & Record<string, unknown>;\n\ninterface Pending {\n  error: unknown;\n  ctx: Hint;\n  done?: (eventId: string) => void;\n}\n\n/**\n * Errors thrown before any client exists: a render error in the provider's first render is caught\n * before the provider's effect creates the client. Sent by the next client the provider creates.\n */\nconst pending: Pending[] = [];\n\n/** Sends the errors kept while no client existed (called by `GuidelyProvider` once it has one). */\nexport function drainPendingErrors(client: GuidelyClient): void {\n  for (const p of pending.splice(0)) {\n    let eventId = \"\";\n    try {\n      eventId = client.captureException(p.error, p.ctx) || \"\";\n    } catch {\n      // never throw into the app\n    }\n    if (eventId) p.done?.(eventId);\n  }\n}\n\n/**\n * Captures without ever throwing into the app; returns the event id (\"\" when nothing was sent, or\n * when the error waits for a client, in which case `done` gets the id later).\n */\nfunction capture(client: GuidelyClient | null, error: unknown, ctx: Hint, done?: (eventId: string) => void): string {\n  if (error && typeof error === \"object\") {\n    if (reported.has(error)) return \"\";\n    reported.add(error);\n  }\n  const c = liveClient(client);\n  if (!c) {\n    if (pending.length < 10) pending.push({ error, ctx, done });\n    return \"\";\n  }\n  try {\n    return c.captureException(error, ctx) || \"\";\n  } catch {\n    return \"\";\n  }\n}\n\nexport interface ErrorBoundaryFallbackProps {\n  error: unknown;\n  componentStack: string;\n  /** The Guidely event id (\"\" when nothing was sent: error tracking off, no consent, filtered). */\n  eventId: string;\n  /** Clears the error and renders the children again. */\n  resetError(): void;\n}\n\nexport interface GuidelyErrorBoundaryProps {\n  children?: ReactNode;\n  /** Rendered instead of the children after an error (an element, or a function of the error). Nothing is rendered without one. */\n  fallback?: ReactNode | ((props: ErrorBoundaryFallbackProps) => ReactNode);\n  /** Called after the error is reported (`eventId` is \"\" when it waits for the provider's client, or was not sent). */\n  onError?: (error: unknown, componentStack: string, eventId: string) => void;\n  /** Edit what is sent (`context.tags.area = \"checkout\"`), like Sentry's `beforeCapture(scope, …)`. */\n  beforeCapture?: (context: CaptureContext, error: unknown, componentStack: string) => void;\n  /** Called by `resetError()`, before the children render again. */\n  onReset?: (error: unknown, componentStack: string, eventId: string) => void;\n  /** Opens the bug-report dialog for the event, when this SDK version has one. */\n  showDialog?: boolean;\n  tags?: CaptureContext[\"tags\"];\n  extra?: CaptureContext[\"extra\"];\n  fingerprint?: string[];\n  /** Default `error`. */\n  level?: ErrorLevelName;\n  /** Marks the error handled (default: true when a `fallback` is given, as Sentry does). */\n  handled?: boolean;\n  /** The client to report to (default: the `GuidelyProvider`'s, else the live `createGuidely()` client). */\n  client?: GuidelyClient | null;\n}\n\ninterface BoundaryState {\n  error: unknown;\n  componentStack: string;\n  eventId: string;\n}\n\nconst EMPTY: BoundaryState = { error: null, componentStack: \"\", eventId: \"\" };\n\n/**\n * Catches render errors in its children, reports them (`mechanism: react.errorboundary`) and\n * renders `fallback`. Works without a provider when a client was made with `createGuidely()`.\n *\n * ```tsx\n * <GuidelyErrorBoundary fallback={({ resetError }) => <button onClick={resetError}>Try again</button>} tags={{ area: \"checkout\" }}>\n *   <Checkout />\n * </GuidelyErrorBoundary>\n * ```\n */\nexport class GuidelyErrorBoundary extends Component<GuidelyErrorBoundaryProps, BoundaryState & { failed: boolean }> {\n  static override contextType = GuidelyContext;\n  declare context: GuidelyClient | null;\n  override state = { ...EMPTY, failed: false };\n\n  static getDerivedStateFromError(error: unknown): Partial<BoundaryState & { failed: boolean }> {\n    return { error, failed: true };\n  }\n\n  override componentDidCatch(error: unknown, info: ErrorInfo): void {\n    const { tags, extra, fingerprint, level, handled, fallback, beforeCapture, onError, showDialog } = this.props;\n    const componentStack = stackOf(info);\n    const ctx: Hint = {\n      level: level ?? \"error\",\n      ...(tags ? { tags: { ...tags } } : {}),\n      ...(extra ? { extra: { ...extra } } : {}),\n      ...(fingerprint ? { fingerprint } : {}),\n      contexts: { react: { version, componentStack } },\n      mechanism: { type: \"react.errorboundary\", handled: handled ?? !!fallback },\n    };\n    try {\n      beforeCapture?.(ctx, error, componentStack);\n    } catch {\n      // A throwing hook still reports the error as it was.\n    }\n    const client = this.props.client ?? this.context;\n    const eventId = capture(client, error, ctx, (id) => {\n      // Sent later, once the provider created its client: show the id if this error is still up.\n      if (this.state.error === error) this.setState({ eventId: id });\n    });\n    this.setState({ componentStack, eventId });\n    onError?.(error, componentStack, eventId);\n    if (showDialog && eventId) {\n      try {\n        // The \"Report a bug\" dialog links the report to the page's last exception: this one.\n        (liveClient(client) as unknown as { showBugReport?: () => void } | null)?.showBugReport?.();\n      } catch {\n        // No dialog: the error is reported all the same.\n      }\n    }\n  }\n\n  resetError = (): void => {\n    const { error, componentStack, eventId } = this.state;\n    this.props.onReset?.(error, componentStack, eventId);\n    this.setState({ ...EMPTY, failed: false });\n  };\n\n  override render(): ReactNode {\n    if (!this.state.failed) return this.props.children;\n    const { fallback } = this.props;\n    if (typeof fallback === \"function\") return fallback({ error: this.state.error, componentStack: this.state.componentStack, eventId: this.state.eventId, resetError: this.resetError });\n    return fallback ?? null;\n  }\n}\n\n/** Wraps a component in a `GuidelyErrorBoundary` (Sentry's `withErrorBoundary`). */\nexport function withGuidelyErrorBoundary<P extends object>(Wrapped: ComponentType<P>, options: Omit<GuidelyErrorBoundaryProps, \"children\"> = {}): ComponentType<P> {\n  const name = Wrapped.displayName || Wrapped.name || \"Component\";\n  const WithBoundary = (props: P) => (\n    <GuidelyErrorBoundary {...options}>\n      <Wrapped {...props} />\n    </GuidelyErrorBoundary>\n  );\n  WithBoundary.displayName = `guidelyErrorBoundary(${name})`;\n  return WithBoundary;\n}\n\n/**\n * Reports `error` once (per error object) when it is set: for error pages that receive the error as\n * a prop, such as Next.js `error.tsx` or React Router's `errorElement`. Returns the event id.\n */\nexport function useCaptureException(error: unknown, hint?: Hint): string {\n  const client = useContext(GuidelyContext);\n  const [eventId, setEventId] = useState(\"\");\n  useEffect(() => {\n    if (error === null || error === undefined) return;\n    const id = capture(client, error, { ...(hint ?? {}), mechanism: hint?.mechanism ?? { type: \"react.errorpage\", handled: true } }, setEventId);\n    if (id) setEventId(id);\n    // The hint is read once per error; changing it alone does not report again.\n  }, [client, error]);\n  return eventId;\n}\n\n/** What React 19 passes to `onUncaughtError` / `onCaughtError` / `onRecoverableError`. */\nexport interface ReactErrorInfo {\n  componentStack?: string | null;\n  /** `onCaughtError` only: the boundary that caught the error. */\n  errorBoundary?: unknown;\n}\n\n/**\n * React 19 root error hooks (Sentry's `reactErrorHandler`):\n *\n * ```ts\n * createRoot(el, {\n *   onUncaughtError: guidelyReactErrorHandler(),\n *   onCaughtError: guidelyReactErrorHandler(),\n *   onRecoverableError: guidelyReactErrorHandler(),\n * });\n * ```\n *\n * Errors caught by a boundary are reported as handled; errors a `GuidelyErrorBoundary` caught are\n * left to it. The client defaults to the live `createGuidely()` / provider client at the time of\n * the error. `callback` replaces React's default logging (the error is `console.error`ed without one).\n */\nexport function guidelyReactErrorHandler(client?: GuidelyClient | null, callback?: (error: unknown, errorInfo: ReactErrorInfo, eventId: string) => void): (error: unknown, errorInfo?: ReactErrorInfo) => void {\n  return (error, errorInfo = {}) => {\n    let eventId = \"\";\n    if (!(errorInfo.errorBoundary instanceof GuidelyErrorBoundary)) {\n      const caught = errorInfo.errorBoundary !== undefined && errorInfo.errorBoundary !== null;\n      eventId = capture(client ?? null, error, { contexts: { react: { version, componentStack: stackOf(errorInfo) } }, mechanism: { type: \"react\", handled: caught } });\n    }\n    if (callback) callback(error, errorInfo, eventId);\n    else console.error(error);\n  };\n}\n","import { createFlagsClient, createStaticFlags, jsonEquals, stableStringify, type Attributes, type FlagDetails, type FlagValue, type FlagsBootstrap, type FlagsClient, type FlagsClientOptions, type FlagsReader, type JsonValue } from \"@guidelytech/flags\";\nimport { createContext, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore, type ReactNode } from \"react\";\n\n/** What the flag hooks read: the live client once created, else a static snapshot of the bootstrap payload. */\nexport interface FlagsSource {\n  client: FlagsClient | null;\n  bootstrap: FlagsReader;\n}\n\nexport const FlagsContext = createContext<FlagsSource | null>(null);\n\nconst EMPTY = createStaticFlags();\n\nfunction useReader(): FlagsReader {\n  const src = useContext(FlagsContext);\n  return src?.client ?? src?.bootstrap ?? EMPTY;\n}\n\n/**\n * Subscribes to the flags with `useSyncExternalStore`. Values are compared deeply so object\n * flags keep their identity between renders. The server snapshot is the bootstrap payload, so\n * server-rendered HTML and hydration agree.\n */\nfunction useFlagsValue<T>(select: (reader: FlagsReader) => T): T {\n  const reader = useReader();\n  const cache = useRef<{ reader: FlagsReader; value: T } | null>(null);\n  const get = () => {\n    const value = select(reader);\n    const c = cache.current;\n    if (c && c.reader === reader && jsonEquals(c.value, value)) return c.value;\n    cache.current = { reader, value };\n    return value;\n  };\n  return useSyncExternalStore(reader.subscribe, get, get);\n}\n\n/** Is the boolean flag on? `fallback` (default `false`) until flags load, or when missing. */\nexport function useFlag(key: string, fallback = false): boolean {\n  return useFlagsValue((r) => r.isEnabled(key, fallback));\n}\n\n/** A flag's value (string, number, JSON…); `fallback` when missing or of a different type. */\nexport function useFeatureValue<T extends JsonValue>(key: string, fallback: T): FlagValue<T> {\n  return useFlagsValue((r) => r.getValue(key, fallback));\n}\n\n/** A flag's value plus why it was served (reason, rule, variation, experiment). */\nexport function useFlagDetails<T extends JsonValue>(key: string, fallback: T): FlagDetails<FlagValue<T>> {\n  return useFlagsValue((r) => r.getDetails(key, fallback));\n}\n\n/** Every flag's value (records no exposures). */\nexport function useFlags(): Record<string, JsonValue> {\n  return useFlagsValue((r) => r.getAll());\n}\n\n/** True once flags have loaded (or failed to and serve fallbacks); true from the start with a bootstrap payload. */\nexport function useFlagsReady(): boolean {\n  return useFlagsValue((r) => r.isReady());\n}\n\n/** The flags client (`null` on the server and before the provider has created it). */\nexport function useFlagsClient(): FlagsClient | null {\n  return useContext(FlagsContext)?.client ?? null;\n}\n\nexport interface FeatureProps {\n  flag: string;\n  children?: ReactNode;\n  /** Rendered while the flag is off (default: nothing). */\n  fallback?: ReactNode;\n}\n\n/** Renders `children` when the boolean flag is on, else `fallback`. */\nexport function Feature({ flag, children, fallback = null }: FeatureProps) {\n  return <>{useFlag(flag) ? children : fallback}</>;\n}\n\n/** Alias of {@link Feature}. */\nexport const FeatureFlag = Feature;\n\nexport interface FeatureValueProps extends FeatureProps {\n  /** Renders `children` when the flag's value equals this (deep equality). */\n  value: JsonValue;\n}\n\n/** Renders `children` when the flag's value equals `value` (e.g. an experiment variation), else `fallback`. */\nexport function FeatureValue({ flag, value, children, fallback = null }: FeatureValueProps) {\n  const current = useFeatureValue<JsonValue>(flag, null);\n  return <>{jsonEquals(current, value) ? children : fallback}</>;\n}\n\n/** A static snapshot for SSR and hydration, rebuilt only when the payload or attributes change. */\nexport function useBootstrap(payload: FlagsBootstrap | null | undefined, attributes: Attributes): FlagsReader {\n  const key = stableStringify(attributes);\n  return useMemo(() => (payload ? createStaticFlags({ payload, attributes }) : EMPTY), [payload, key]);\n}\n\nexport interface FlagsProviderProps extends Omit<FlagsClientOptions, \"payload\"> {\n  /** Bootstrap from the server (`getPayload()`): renders the same values on the server and in the browser. */\n  payload?: FlagsBootstrap | null;\n  /** Use an existing client instead of creating one. */\n  client?: FlagsClient;\n  children?: ReactNode;\n}\n\n/**\n * Feature flags only (no guides or analytics). Creates a flags client in an effect (never during\n * SSR) and destroys it on unmount; until then hooks read the `payload` snapshot. Changing\n * `attributes` re-evaluates without recreating the client.\n *\n * ```tsx\n * <FlagsProvider sdkKey=\"pk_prod_…\" attributes={{ id: user.id, plan: user.plan }} payload={bootstrap}>\n * ```\n */\nexport function FlagsProvider({ children, client: external, payload, ...options }: FlagsProviderProps) {\n  const [created, setCreated] = useState<FlagsClient | null>(null);\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  const sdkKey = options.sdkKey ?? options.projectId;\n  const { apiUrl, environment } = options;\n  const payloadRef = useRef(payload);\n  payloadRef.current = payload;\n\n  useEffect(() => {\n    if (external || !sdkKey || typeof window === \"undefined\") return;\n    let c: FlagsClient;\n    try {\n      c = createFlagsClient({ ...optionsRef.current, sdkKey, payload: payloadRef.current ?? undefined });\n    } catch (err) {\n      optionsRef.current.onError?.(err instanceof Error ? err : new Error(String(err)));\n      return;\n    }\n    setCreated(c);\n    return () => {\n      c.destroy();\n      setCreated((cur) => (cur === c ? null : cur));\n    };\n  }, [external, sdkKey, apiUrl, environment]);\n\n  const client = external ?? created;\n  const attributes = options.attributes ?? {};\n  const attrsKey = stableStringify(attributes);\n  useEffect(() => {\n    if (client && options.attributes) client.setAttributes(options.attributes);\n  }, [client, attrsKey]);\n\n  const bootstrap = useBootstrap(payload, attributes);\n  const value = useMemo<FlagsSource>(() => ({ client, bootstrap }), [client, bootstrap]);\n  return <FlagsContext.Provider value={value}>{children}</FlagsContext.Provider>;\n}\n"],"mappings":"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","names":["import_flags","import_sdk_core","import_react","import_react","import_react","import_jsx_runtime","EMPTY","import_jsx_runtime"]}