@inkeep/cxkit-primitives 0.0.0-dev-20250221234142

package/dist/providers/base-events-provider.js

@@ -0,0 +1,39 @@
+"use client";
+import { jsx as f } from "react/jsx-runtime";
+import { useMemo as d, useCallback as y, createContext as x, useContext as B } from "react";
+import { logEvent as C } from "../atoms/api/analytics/events.js";
+import { useInkeepConfig as P } from "./config-provider.js";
+import { useUser as b } from "./user-provider.js";
+const m = x(void 0), M = ({ children: e }) => {
+  const { baseSettings: t, interactionType: o } = P(), { apiKey: s, analyticsBaseUrl: n, tags: r, analytics: p, env: u } = t, { userProperties: a } = b(), i = d(
+    () => ({
+      widgetLibraryVersion: "0.4.9",
+      interactionType: o,
+      tags: r
+    }),
+    [o, r]
+  ), c = !p.optOutAllAnalytics && u !== "DEVELOPMENT", E = { logEvent: y(
+    async (v) => {
+      const g = {
+        ...i,
+        ...v.properties
+      }, l = {
+        eventName: v.eventName,
+        properties: g,
+        userProperties: a
+      };
+      c && C(l, s, n), t.logEventCallback?.(l);
+    },
+    [c, t, s, n, a, i]
+  ) };
+  return /* @__PURE__ */ f(m.Provider, { value: E, children: e });
+}, O = () => {
+  const e = B(m);
+  if (!e)
+    throw new Error("useBaseEvents must be used within a BaseEventsProvider");
+  return e;
+};
+export {
+  M as BaseEventsProvider,
+  O as useBaseEvents
+};

package/dist/providers/chat-events-provider.cjs

@@ -0,0 +1 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("react/jsx-runtime"),s=require("react"),b=require("../atoms/api/analytics/conversation.cjs"),q=require("./config-provider.cjs"),x=require("./conversation-provider.cjs"),y=require("./user-provider.cjs"),g=require("./base-events-provider.cjs"),p=s.createContext(void 0),m=({children:t})=>{const{baseSettings:P}=q.useInkeepConfig(),{apiKey:u,analyticsBaseUrl:v,tags:d}=P,{userProperties:l}=y.useUser(),{logEvent:C}=g.useBaseEvents(),{conversation:i,setConversation:h}=x.useInkeepConversation(),o=s.useRef(i.id);s.useEffect(()=>{o.current=i.id},[i.id]);const f=["chat_message_submitted","chat_message_bot_response_received","intelligent_form_primary_submitted","intelligent_form_qa_response"],a=s.useCallback(async e=>{const n=o.current,r=await b.logConversation(n,{messages:e,tags:d,userProperties:l},u,v);return r&&h(r),r},[v,u,d,l,h]),_={logEvent:s.useCallback(async e=>{let n=o.current;if(f.includes(e.eventName)&&"messages"in e.properties){const E=await a(e.properties.messages);E&&(n=E.id,o.current=n)}const r={...e,properties:{...e.properties,conversationId:n}};C(r)},[C,a]),logConversation:a};return c.jsx(p.Provider,{value:_,children:t})},j=({children:t})=>c.jsx(g.BaseEventsProvider,{children:c.jsx(m,{children:t})}),w=()=>{const t=s.useContext(p);if(!t)throw new Error("useChatEvents must be used within a ChatEventsProvider");return t};exports.ChatEventsProvider=m;exports.ChatEventsProviderWithBase=j;exports.useChatEvents=w;

package/dist/providers/chat-events-provider.d.cts

@@ -0,0 +1,12 @@
+import { ConversationResponse, InkeepEvent, Message } from '@inkeep/cxkit-types';
+export type ChatEventsContextValue = {
+    logEvent: (event: InkeepEvent) => void;
+    logConversation: (messages: Message[]) => Promise<ConversationResponse | undefined>;
+};
+export declare const ChatEventsProvider: React.FC<{
+    children: React.ReactNode;
+}>;
+export declare const ChatEventsProviderWithBase: React.FC<{
+    children: React.ReactNode;
+}>;
+export declare const useChatEvents: () => ChatEventsContextValue;

package/dist/providers/chat-events-provider.d.ts

@@ -0,0 +1,12 @@
+import { ConversationResponse, InkeepEvent, Message } from '@inkeep/cxkit-types';
+export type ChatEventsContextValue = {
+    logEvent: (event: InkeepEvent) => void;
+    logConversation: (messages: Message[]) => Promise<ConversationResponse | undefined>;
+};
+export declare const ChatEventsProvider: React.FC<{
+    children: React.ReactNode;
+}>;
+export declare const ChatEventsProviderWithBase: React.FC<{
+    children: React.ReactNode;
+}>;
+export declare const useChatEvents: () => ChatEventsContextValue;

package/dist/providers/chat-events-provider.js

@@ -0,0 +1,66 @@
+"use client";
+import { jsx as a } from "react/jsx-runtime";
+import { useRef as _, useEffect as b, useCallback as C, createContext as x, useContext as P } from "react";
+import { logConversation as w } from "../atoms/api/analytics/conversation.js";
+import { useInkeepConfig as y } from "./config-provider.js";
+import { useInkeepConversation as I } from "./conversation-provider.js";
+import { useUser as B } from "./user-provider.js";
+import { useBaseEvents as k, BaseEventsProvider as U } from "./base-events-provider.js";
+const f = x(void 0), j = ({ children: t }) => {
+  const { baseSettings: h } = y(), { apiKey: c, analyticsBaseUrl: u, tags: v } = h, { userProperties: m } = B(), { logEvent: p } = k(), { conversation: r, setConversation: d } = I(), o = _(r.id);
+  b(() => {
+    o.current = r.id;
+  }, [r.id]);
+  const g = [
+    "chat_message_submitted",
+    "chat_message_bot_response_received",
+    "intelligent_form_primary_submitted",
+    "intelligent_form_qa_response"
+  ], i = C(
+    async (e) => {
+      const s = o.current, n = await w(
+        s,
+        {
+          messages: e,
+          tags: v,
+          userProperties: m
+        },
+        c,
+        u
+      );
+      return n && d(n), n;
+    },
+    [u, c, v, m, d]
+  ), E = {
+    logEvent: C(
+      async (e) => {
+        let s = o.current;
+        if (g.includes(e.eventName) && "messages" in e.properties) {
+          const l = await i(e.properties.messages);
+          l && (s = l.id, o.current = s);
+        }
+        const n = {
+          ...e,
+          properties: {
+            ...e.properties,
+            conversationId: s
+          }
+        };
+        p(n);
+      },
+      [p, i]
+    ),
+    logConversation: i
+  };
+  return /* @__PURE__ */ a(f.Provider, { value: E, children: t });
+}, A = ({ children: t }) => /* @__PURE__ */ a(U, { children: /* @__PURE__ */ a(j, { children: t }) }), D = () => {
+  const t = P(f);
+  if (!t)
+    throw new Error("useChatEvents must be used within a ChatEventsProvider");
+  return t;
+};
+export {
+  j as ChatEventsProvider,
+  A as ChatEventsProviderWithBase,
+  D as useChatEvents
+};

package/dist/providers/chat-form-provider.cjs

@@ -0,0 +1 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const q=require("react/jsx-runtime"),o=require("react"),M=require("react-hook-form"),O=require("./conversation-provider.cjs"),P=require("../components/modal/modal-provider.cjs"),R=require("../utils/form.cjs"),x="root.serverError",S=o.createContext(void 0);function f(){const[t,n]=o.useState(null),[C,u]=o.useState(!1),{conversation:i}=O.useInkeepConversation(),h=P.useModal(),v=e=>{n(e)},E=()=>{n(null),u(!1),t?.buttons.close?.action==="CLOSE_MODAL"&&h?.closeModal()},c=o.useMemo(()=>t?.fields.map(e=>{const r=e;return"_type"in e&&e._type==="INCLUDE_CHAT_SESSION"&&(r.required=!1,r.inputType="CHECKBOX",i.id||(r.isHidden=!0)),r}),[t?.fields,i.id]),a=c?.find(e=>"_type"in e&&e._type==="INCLUDE_CHAT_SESSION"),s=o.useMemo(()=>R.getFormDefaultValues(c),[c]),{control:F,handleSubmit:b,formState:{errors:m,isSubmitting:p},setError:_,reset:l}=M.useForm({defaultValues:s});o.useEffect(()=>{s&&l(s)},[l,s]);const w=b(async e=>{const r=typeof window>"u"?"":window.location.href,g=i.id&&a&&e[a.name]?i:null;try{await t?.buttons.submit.onSubmit({values:e,conversation:g,client:{currentUrl:r}}),u(!0)}catch(d){_(x,{message:d instanceof Error?d.message:"Something went wrong."})}}),y=m?.root?.serverError;return{form:t,openForm:v,closeForm:E,handleSubmit:w,isSuccess:C,isSubmitting:p,formError:y,fields:c,errors:m,control:F,defaultValues:s}}const I=({children:t})=>{const n=f();return q.jsx(S.Provider,{value:n,children:t})},H=()=>{const t=o.useContext(S);if(!t)throw new Error("useChatForm must be used within a ChatFormProvider");return t};exports.ChatFormProvider=I;exports.useChatForm=H;exports.useChatFormState=f;

package/dist/providers/chat-form-provider.d.cts

@@ -0,0 +1,23 @@
+import { FormConfig, FormField } from '@inkeep/cxkit-types';
+import { Message, FieldErrors, Control } from 'react-hook-form';
+export type ChatFormContextValue = ReturnType<typeof useChatFormState>;
+export declare function useChatFormState(): {
+    form: FormConfig | null;
+    openForm: (formConfig: FormConfig) => void;
+    closeForm: () => void;
+    handleSubmit: (e?: React.BaseSyntheticEvent) => Promise<void>;
+    isSuccess: boolean;
+    isSubmitting: boolean;
+    formError: Partial<{
+        type: string | number;
+        message: Message;
+    }> | undefined;
+    fields: FormField[] | undefined;
+    errors: FieldErrors<Record<string, any>>;
+    control: Control<Record<string, any>, any>;
+    defaultValues: Record<string, any>;
+};
+export declare const ChatFormProvider: React.FC<{
+    children: React.ReactNode;
+}>;
+export declare const useChatForm: () => ChatFormContextValue;

package/dist/providers/chat-form-provider.d.ts

@@ -0,0 +1,23 @@
+import { FormConfig, FormField } from '@inkeep/cxkit-types';
+import { Message, FieldErrors, Control } from 'react-hook-form';
+export type ChatFormContextValue = ReturnType<typeof useChatFormState>;
+export declare function useChatFormState(): {
+    form: FormConfig | null;
+    openForm: (formConfig: FormConfig) => void;
+    closeForm: () => void;
+    handleSubmit: (e?: React.BaseSyntheticEvent) => Promise<void>;
+    isSuccess: boolean;
+    isSubmitting: boolean;
+    formError: Partial<{
+        type: string | number;
+        message: Message;
+    }> | undefined;
+    fields: FormField[] | undefined;
+    errors: FieldErrors<Record<string, any>>;
+    control: Control<Record<string, any>, any>;
+    defaultValues: Record<string, any>;
+};
+export declare const ChatFormProvider: React.FC<{
+    children: React.ReactNode;
+}>;
+export declare const useChatForm: () => ChatFormContextValue;

package/dist/providers/chat-form-provider.js

@@ -0,0 +1,66 @@
+"use client";
+import { jsx as x } from "react/jsx-runtime";
+import { useState as f, useMemo as d, useEffect as I, createContext as O, useContext as M } from "react";
+import { useForm as N } from "react-hook-form";
+import { useInkeepConversation as R } from "./conversation-provider.js";
+import { useModal as A } from "../components/modal/modal-provider.js";
+import { getFormDefaultValues as D } from "../utils/form.js";
+const H = "root.serverError", S = O(void 0);
+function L() {
+  const [o, n] = f(null), [p, c] = f(!1), { conversation: s } = R(), C = A(), E = (t) => {
+    n(t);
+  }, h = () => {
+    n(null), c(!1), o?.buttons.close?.action === "CLOSE_MODAL" && C?.closeModal();
+  }, i = d(() => o?.fields.map((t) => {
+    const e = t;
+    return "_type" in t && t._type === "INCLUDE_CHAT_SESSION" && (e.required = !1, e.inputType = "CHECKBOX", s.id || (e.isHidden = !0)), e;
+  }), [o?.fields, s.id]), a = i?.find((t) => "_type" in t && t._type === "INCLUDE_CHAT_SESSION"), r = d(() => D(i), [i]), {
+    control: v,
+    handleSubmit: F,
+    formState: { errors: u, isSubmitting: b },
+    setError: _,
+    reset: m
+  } = N({
+    defaultValues: r
+  });
+  I(() => {
+    r && m(r);
+  }, [m, r]);
+  const w = F(async (t) => {
+    const e = typeof window > "u" ? "" : window.location.href, g = s.id && a && t[a.name] ? s : null;
+    try {
+      await o?.buttons.submit.onSubmit({ values: t, conversation: g, client: { currentUrl: e } }), c(!0);
+    } catch (l) {
+      _(H, {
+        message: l instanceof Error ? l.message : "Something went wrong."
+      });
+    }
+  }), y = u?.root?.serverError;
+  return {
+    form: o,
+    openForm: E,
+    closeForm: h,
+    handleSubmit: w,
+    isSuccess: p,
+    isSubmitting: b,
+    formError: y,
+    fields: i,
+    errors: u,
+    control: v,
+    defaultValues: r
+  };
+}
+const K = ({ children: o }) => {
+  const n = L();
+  return /* @__PURE__ */ x(S.Provider, { value: n, children: o });
+}, X = () => {
+  const o = M(S);
+  if (!o)
+    throw new Error("useChatForm must be used within a ChatFormProvider");
+  return o;
+};
+export {
+  K as ChatFormProvider,
+  X as useChatForm,
+  L as useChatFormState
+};

package/dist/providers/config-provider.cjs

@@ -0,0 +1 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("react/jsx-runtime"),p=require("merge-anything"),o=require("react"),r=require("../utils/default-settings.cjs"),E=require("../atoms/shadow/context.cjs"),a={ChatButton:"CHAT_BUTTON",CustomTrigger:"CUSTOM_TRIGGER",SearchBar:"SEARCH_BAR",EmbeddedChat:"EMBEDDED_CHAT",EmbeddedSearch:"EMBEDDED_SEARCH",EmbeddedSearchAndChat:"EMBEDDED_SEARCH_AND_CHAT",IntelligentForm:"INTELLIGENT_FORM"},c={prefix:"ikp",aiChatSettings:r.defaultInkeepAIChatSettings,baseSettings:r.defaultInkeepBaseSettings,searchSettings:r.defaultInkeepSearchSettings,interactionType:a.EmbeddedChat},g=o.createContext(c),h=({children:t,value:i})=>{const d=E.useShadow(),u=(s,e,n)=>(n==="apiKey"&&!e&&!i?.baseSettings?.baseUrl&&console.warn("Inkeep API key is missing."),n==="tools"&&Array.isArray(e)?(s||[]).concat(e):["baseSettings","searchSettings","aiChatSettings"].includes(n)&&!e?s:e),C={baseSettings:d??{}},S=p.mergeAndCompare(u,c,C,i??{});return f.jsx(g.Provider,{value:S,children:t})},I=()=>{const t=o.useContext(g);if(!t)throw new Error("useInkeepConfig must be used within a ConfigProvider");return t};exports.InkeepConfigProvider=h;exports.WebWidgetInteractionType=a;exports.useInkeepConfig=I;

package/dist/providers/config-provider.d.cts

@@ -0,0 +1,24 @@
+import { ReactNode } from 'react';
+import { DefaultInkeepAIChatSettings, DefaultInkeepBaseSettings, DefaultInkeepSearchSettings } from '../utils/default-settings';
+import { InkeepConfig } from '@inkeep/cxkit-types';
+export declare const WebWidgetInteractionType: {
+    readonly ChatButton: "CHAT_BUTTON";
+    readonly CustomTrigger: "CUSTOM_TRIGGER";
+    readonly SearchBar: "SEARCH_BAR";
+    readonly EmbeddedChat: "EMBEDDED_CHAT";
+    readonly EmbeddedSearch: "EMBEDDED_SEARCH";
+    readonly EmbeddedSearchAndChat: "EMBEDDED_SEARCH_AND_CHAT";
+    readonly IntelligentForm: "INTELLIGENT_FORM";
+};
+export interface WidgetConfig extends InkeepConfig {
+    aiChatSettings: InkeepConfig['aiChatSettings'] & DefaultInkeepAIChatSettings;
+    baseSettings: InkeepConfig['baseSettings'] & DefaultInkeepBaseSettings;
+    searchSettings: InkeepConfig['searchSettings'] & DefaultInkeepSearchSettings;
+}
+interface InkeepConfigProviderProps {
+    children: ReactNode;
+    value?: Partial<InkeepConfig>;
+}
+export declare const InkeepConfigProvider: ({ children, value }: InkeepConfigProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const useInkeepConfig: () => WidgetConfig;
+export {};

package/dist/providers/config-provider.d.ts

@@ -0,0 +1,24 @@
+import { ReactNode } from 'react';
+import { DefaultInkeepAIChatSettings, DefaultInkeepBaseSettings, DefaultInkeepSearchSettings } from '../utils/default-settings';
+import { InkeepConfig } from '@inkeep/cxkit-types';
+export declare const WebWidgetInteractionType: {
+    readonly ChatButton: "CHAT_BUTTON";
+    readonly CustomTrigger: "CUSTOM_TRIGGER";
+    readonly SearchBar: "SEARCH_BAR";
+    readonly EmbeddedChat: "EMBEDDED_CHAT";
+    readonly EmbeddedSearch: "EMBEDDED_SEARCH";
+    readonly EmbeddedSearchAndChat: "EMBEDDED_SEARCH_AND_CHAT";
+    readonly IntelligentForm: "INTELLIGENT_FORM";
+};
+export interface WidgetConfig extends InkeepConfig {
+    aiChatSettings: InkeepConfig['aiChatSettings'] & DefaultInkeepAIChatSettings;
+    baseSettings: InkeepConfig['baseSettings'] & DefaultInkeepBaseSettings;
+    searchSettings: InkeepConfig['searchSettings'] & DefaultInkeepSearchSettings;
+}
+interface InkeepConfigProviderProps {
+    children: ReactNode;
+    value?: Partial<InkeepConfig>;
+}
+export declare const InkeepConfigProvider: ({ children, value }: InkeepConfigProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const useInkeepConfig: () => WidgetConfig;
+export {};

package/dist/providers/config-provider.js

@@ -0,0 +1,37 @@
+"use client";
+import { jsx as d } from "react/jsx-runtime";
+import { mergeAndCompare as C } from "merge-anything";
+import { createContext as g, useContext as p } from "react";
+import { defaultInkeepSearchSettings as f, defaultInkeepBaseSettings as m, defaultInkeepAIChatSettings as E } from "../utils/default-settings.js";
+import { useShadow as S } from "../atoms/shadow/context.js";
+const h = {
+  ChatButton: "CHAT_BUTTON",
+  CustomTrigger: "CUSTOM_TRIGGER",
+  SearchBar: "SEARCH_BAR",
+  EmbeddedChat: "EMBEDDED_CHAT",
+  EmbeddedSearch: "EMBEDDED_SEARCH",
+  EmbeddedSearchAndChat: "EMBEDDED_SEARCH_AND_CHAT",
+  IntelligentForm: "INTELLIGENT_FORM"
+}, i = {
+  prefix: "ikp",
+  // Default prefix
+  aiChatSettings: E,
+  baseSettings: m,
+  searchSettings: f,
+  interactionType: h.EmbeddedChat
+}, s = g(i), B = ({ children: t, value: r }) => {
+  const a = S(), c = C((o, e, n) => (n === "apiKey" && !e && !r?.baseSettings?.baseUrl && console.warn("Inkeep API key is missing."), n === "tools" && Array.isArray(e) ? (o || []).concat(e) : ["baseSettings", "searchSettings", "aiChatSettings"].includes(n) && !e ? o : e), i, {
+    baseSettings: a ?? {}
+  }, r ?? {});
+  return /* @__PURE__ */ d(s.Provider, { value: c, children: t });
+}, x = () => {
+  const t = p(s);
+  if (!t)
+    throw new Error("useInkeepConfig must be used within a ConfigProvider");
+  return t;
+};
+export {
+  B as InkeepConfigProvider,
+  h as WebWidgetInteractionType,
+  x as useInkeepConfig
+};

package/dist/providers/conversation-provider.cjs

@@ -0,0 +1 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("react/jsx-runtime"),o=require("react"),h=require("./config-provider.cjs"),C="conversationId",l=o.createContext(null),S=({children:n})=>{const i=w(),{aiChatSettings:c}=h.useInkeepConfig(),t=c.chatId||i,s={id:"",messages:[]},[r,a]=o.useState(s),e=()=>{a(s)},u=o.useMemo(()=>({conversation:r,setConversation:a,chatId:t,resetConversation:e}),[r,t]);return p.jsx(l.Provider,{value:u,children:n})},f=()=>{const n=o.useContext(l);if(!n)throw new Error("useInkeepConversation must be used within an InkeepConversationProvider");return n};function w(){const[n,i]=o.useState(void 0),{aiChatSettings:c}=h.useInkeepConfig(),{shareChatUrlBasePath:t}=c;return o.useEffect(()=>{if(!t||typeof window>"u")return;const s=e=>e.endsWith("/")?e.slice(0,-1):e,r=()=>{const{origin:e,pathname:u,search:m}=window.location,d=new URL(t),I=s(u),P=s(d.pathname);if(e===d.origin&&I===P){const v=new URLSearchParams(m).get(C);v&&i(v)}};r();const a=()=>r();return window.addEventListener("popstate",a),()=>{window.removeEventListener("popstate",a)}},[t]),n}exports.InkeepConversationProvider=S;exports.SHARE_QUERY_PARAM=C;exports.useInkeepConversation=f;

package/dist/providers/conversation-provider.d.cts

@@ -0,0 +1,12 @@
+import { ConversationResponse } from '@inkeep/cxkit-types';
+export declare const SHARE_QUERY_PARAM = "conversationId";
+export interface InkeepConversationContextValue {
+    conversation: ConversationResponse;
+    setConversation: React.Dispatch<React.SetStateAction<ConversationResponse>>;
+    chatId: string | undefined;
+    resetConversation: () => void;
+}
+export declare const InkeepConversationProvider: React.FC<{
+    children: React.ReactNode;
+}>;
+export declare const useInkeepConversation: () => InkeepConversationContextValue;

package/dist/providers/conversation-provider.d.ts

@@ -0,0 +1,12 @@
+import { ConversationResponse } from '@inkeep/cxkit-types';
+export declare const SHARE_QUERY_PARAM = "conversationId";
+export interface InkeepConversationContextValue {
+    conversation: ConversationResponse;
+    setConversation: React.Dispatch<React.SetStateAction<ConversationResponse>>;
+    chatId: string | undefined;
+    resetConversation: () => void;
+}
+export declare const InkeepConversationProvider: React.FC<{
+    children: React.ReactNode;
+}>;
+export declare const useInkeepConversation: () => InkeepConversationContextValue;

package/dist/providers/conversation-provider.js

@@ -0,0 +1,49 @@
+"use client";
+import { jsx as I } from "react/jsx-runtime";
+import { useState as u, useMemo as f, createContext as w, useContext as P, useEffect as S } from "react";
+import { useInkeepConfig as m } from "./config-provider.js";
+const g = "conversationId", v = w(null), z = ({ children: t }) => {
+  const a = x(), { aiChatSettings: i } = m(), n = i.chatId || a, o = {
+    id: "",
+    messages: []
+  }, [s, r] = u(o), e = () => {
+    r(o);
+  }, c = f(
+    () => ({
+      conversation: s,
+      setConversation: r,
+      chatId: n,
+      resetConversation: e
+    }),
+    [s, n]
+  );
+  return /* @__PURE__ */ I(v.Provider, { value: c, children: t });
+}, L = () => {
+  const t = P(v);
+  if (!t)
+    throw new Error("useInkeepConversation must be used within an InkeepConversationProvider");
+  return t;
+};
+function x() {
+  const [t, a] = u(void 0), { aiChatSettings: i } = m(), { shareChatUrlBasePath: n } = i;
+  return S(() => {
+    if (!n || typeof window > "u") return;
+    const o = (e) => e.endsWith("/") ? e.slice(0, -1) : e, s = () => {
+      const { origin: e, pathname: c, search: C } = window.location, d = new URL(n), l = o(c), p = o(d.pathname);
+      if (e === d.origin && l === p) {
+        const h = new URLSearchParams(C).get(g);
+        h && a(h);
+      }
+    };
+    s();
+    const r = () => s();
+    return window.addEventListener("popstate", r), () => {
+      window.removeEventListener("popstate", r);
+    };
+  }, [n]), t;
+}
+export {
+  z as InkeepConversationProvider,
+  g as SHARE_QUERY_PARAM,
+  L as useInkeepConversation
+};

package/dist/providers/feedback-item-provider.cjs

@@ -0,0 +1 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("react/jsx-runtime"),t=require("react"),r=t.createContext(void 0),s=({children:e,name:o})=>{const c=t.useRef(null);return n.jsx(r.Provider,{value:{name:o,focusItem:c},children:e})},u=()=>{const e=t.useContext(r);if(!e)throw new Error("useFeedbackItem must be used within a FeedbackItemProvider");return e};exports.FeedbackItemProvider=s;exports.useFeedbackItem=u;

package/dist/providers/feedback-item-provider.d.cts

@@ -0,0 +1,10 @@
+import { FeedbackItemType } from '@inkeep/cxkit-types';
+export type FeedbackItemContextValue = {
+    name: FeedbackItemType;
+    focusItem: React.RefObject<HTMLElement | null>;
+};
+export declare const FeedbackItemProvider: React.FC<{
+    children: React.ReactNode;
+    name: FeedbackItemType;
+}>;
+export declare const useFeedbackItem: () => FeedbackItemContextValue;

package/dist/providers/feedback-item-provider.d.ts

@@ -0,0 +1,10 @@
+import { FeedbackItemType } from '@inkeep/cxkit-types';
+export type FeedbackItemContextValue = {
+    name: FeedbackItemType;
+    focusItem: React.RefObject<HTMLElement | null>;
+};
+export declare const FeedbackItemProvider: React.FC<{
+    children: React.ReactNode;
+    name: FeedbackItemType;
+}>;
+export declare const useFeedbackItem: () => FeedbackItemContextValue;

package/dist/providers/feedback-item-provider.js

@@ -0,0 +1,16 @@
+"use client";
+import { jsx as n } from "react/jsx-runtime";
+import { useRef as c, createContext as s, useContext as u } from "react";
+const t = s(void 0), i = ({ children: e, name: o }) => {
+  const r = c(null);
+  return /* @__PURE__ */ n(t.Provider, { value: { name: o, focusItem: r }, children: e });
+}, a = () => {
+  const e = u(t);
+  if (!e)
+    throw new Error("useFeedbackItem must be used within a FeedbackItemProvider");
+  return e;
+};
+export {
+  i as FeedbackItemProvider,
+  a as useFeedbackItem
+};

package/dist/providers/feedback-provider.cjs

@@ -0,0 +1 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("react/jsx-runtime"),n=require("react"),x=require("../atoms/api/analytics/feedback.cjs"),M=require("../components/embedded-chat/chat-provider.cjs"),l=require("../utils/misc.cjs"),S=require("./config-provider.cjs"),E=require("./conversation-provider.cjs"),j=require("./chat-events-provider.cjs"),I=require("./user-provider.cjs"),f=n.createContext(void 0);function R(){const{baseSettings:e}=S.useInkeepConfig(),{apiKey:s,analyticsBaseUrl:o}=e,[b,g]=n.useState(null),[F,h]=n.useState({}),{conversation:k}=E.useInkeepConversation(),{messages:c,selectedWorkflow:m}=M.useChat(),{userProperties:p}=I.useUser(),{logEvent:C}=j.useChatEvents(),r=n.useCallback(async(t,a,i=[])=>{const u=await x.submitFeedback({type:a,messageId:t,reasons:i,apiKey:s,apiUrl:o,userProperties:p});u&&h(d=>({...d,[t]:{type:u.type,reasons:u.reasons}}));const v=c.findIndex(d=>d.id===t),w=c[v],y={conversationId:k.id,question:l.getMessageContent(c[v-1]),answer:l.getMessageContent(w),messageId:t,reasons:i,workflowId:m?.id};C({eventName:a==="positive"?"chat_thumbs_up_feedback_submitted":"chat_thumbs_down_feedback_submitted",properties:y})},[c,k]),P=n.useCallback(async t=>{r(t,"positive")},[r]),q=n.useCallback(async(t,a)=>{const i=$(a);r(t,"negative",i)},[r]);return{feedback:F,currentFeedback:b,setCurrentFeedback:g,submitPositiveFeedback:P,submitNegativeFeedback:q}}const U=({children:e})=>{const s=R();return _.jsx(f.Provider,{value:s,children:e})},N=()=>{const e=n.useContext(f);if(!e)throw new Error("useFeedback must be used within a FeedbackProvider");return e};function $(e){const s=[];for(const o in e)e[o]==="on"&&s.push({label:o,details:e[`${o}:description`]||""});return s.length>0?s:[]}exports.FeedbackProvider=U;exports.useMessageFeedback=N;

package/dist/providers/feedback-provider.d.cts

@@ -0,0 +1,19 @@
+import { FeebackReason, FeedbackType } from '@inkeep/cxkit-types';
+import { Dispatch, SetStateAction } from 'react';
+export type FeedbackContextValue = ReturnType<typeof useFeedback>;
+export type MessageFeedbackItem = Record<string, {
+    type: FeedbackType;
+    reasons: FeebackReason[] | null;
+}>;
+declare function useFeedback(): {
+    feedback: MessageFeedbackItem;
+    currentFeedback: string | null;
+    setCurrentFeedback: Dispatch<SetStateAction<string | null>>;
+    submitPositiveFeedback: (messageId: string) => Promise<void>;
+    submitNegativeFeedback: (messageId: string, reasonsData: Record<string, FormDataEntryValue>) => Promise<void>;
+};
+export declare const FeedbackProvider: React.FC<{
+    children: React.ReactNode;
+}>;
+export declare const useMessageFeedback: () => FeedbackContextValue;
+export {};

package/dist/providers/feedback-provider.d.ts

@@ -0,0 +1,19 @@
+import { FeebackReason, FeedbackType } from '@inkeep/cxkit-types';
+import { Dispatch, SetStateAction } from 'react';
+export type FeedbackContextValue = ReturnType<typeof useFeedback>;
+export type MessageFeedbackItem = Record<string, {
+    type: FeedbackType;
+    reasons: FeebackReason[] | null;
+}>;
+declare function useFeedback(): {
+    feedback: MessageFeedbackItem;
+    currentFeedback: string | null;
+    setCurrentFeedback: Dispatch<SetStateAction<string | null>>;
+    submitPositiveFeedback: (messageId: string) => Promise<void>;
+    submitNegativeFeedback: (messageId: string, reasonsData: Record<string, FormDataEntryValue>) => Promise<void>;
+};
+export declare const FeedbackProvider: React.FC<{
+    children: React.ReactNode;
+}>;
+export declare const useMessageFeedback: () => FeedbackContextValue;
+export {};

package/dist/providers/feedback-provider.js

@@ -0,0 +1,82 @@
+"use client";
+import { jsx as E } from "react/jsx-runtime";
+import { createContext as I, useContext as U, useState as f, useCallback as u } from "react";
+import { submitFeedback as M } from "../atoms/api/analytics/feedback.js";
+import { useChat as N } from "../components/embedded-chat/chat-provider.js";
+import { getMessageContent as p } from "../utils/misc.js";
+import { useInkeepConfig as S } from "./config-provider.js";
+import { useInkeepConversation as j } from "./conversation-provider.js";
+import { useChatEvents as q } from "./chat-events-provider.js";
+import { useUser as B } from "./user-provider.js";
+const l = I(void 0);
+function K() {
+  const { baseSettings: e } = S(), { apiKey: s, analyticsBaseUrl: o } = e, [b, v] = f(null), [F, h] = f({}), { conversation: m } = j(), { messages: n, selectedWorkflow: g } = N(), { userProperties: C } = B(), { logEvent: w } = q(), r = u(
+    async (t, c, i = []) => {
+      const a = await M({
+        type: c,
+        messageId: t,
+        reasons: i,
+        apiKey: s,
+        apiUrl: o,
+        userProperties: C
+      });
+      a && h((d) => ({
+        ...d,
+        [t]: { type: a.type, reasons: a.reasons }
+      }));
+      const k = n.findIndex((d) => d.id === t), y = n[k], P = {
+        conversationId: m.id,
+        question: p(n[k - 1]),
+        answer: p(y),
+        messageId: t,
+        reasons: i,
+        workflowId: g?.id
+      };
+      w({
+        eventName: c === "positive" ? "chat_thumbs_up_feedback_submitted" : "chat_thumbs_down_feedback_submitted",
+        properties: P
+      });
+    },
+    [n, m]
+  ), _ = u(
+    async (t) => {
+      r(t, "positive");
+    },
+    [r]
+  ), x = u(
+    async (t, c) => {
+      const i = R(c);
+      r(t, "negative", i);
+    },
+    [r]
+  );
+  return {
+    feedback: F,
+    currentFeedback: b,
+    setCurrentFeedback: v,
+    submitPositiveFeedback: _,
+    submitNegativeFeedback: x
+  };
+}
+const O = ({ children: e }) => {
+  const s = K();
+  return /* @__PURE__ */ E(l.Provider, { value: s, children: e });
+}, Q = () => {
+  const e = U(l);
+  if (!e)
+    throw new Error("useFeedback must be used within a FeedbackProvider");
+  return e;
+};
+function R(e) {
+  const s = [];
+  for (const o in e)
+    e[o] === "on" && s.push({
+      label: o,
+      details: e[`${o}:description`] || ""
+    });
+  return s.length > 0 ? s : [];
+}
+export {
+  O as FeedbackProvider,
+  Q as useMessageFeedback
+};

package/dist/providers/form-field-provider.cjs

@@ -0,0 +1 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("react/jsx-runtime"),o=require("react"),F=require("./chat-form-provider.cjs"),t=o.createContext(void 0),d=({children:e,field:r,fieldProps:i,autoFocus:n})=>{const{errors:s}=F.useChatForm(),u=s[r.name];return c.jsx(t.Provider,{value:{field:r,fieldProps:i,error:u,autoFocus:n},children:e})},m=()=>{const e=o.useContext(t);if(!e)throw new Error("useFormField must be used within a FormFieldProvider");return e};exports.FormFieldProvider=d;exports.useFormField=m;

package/dist/providers/form-field-provider.d.cts

@@ -0,0 +1,15 @@
+import { FormField } from '@inkeep/cxkit-types';
+import { ControllerRenderProps, FieldErrors } from 'react-hook-form';
+interface FormFieldCtx {
+    field: FormField;
+    fieldProps: ControllerRenderProps<Record<string, any>, string>;
+    autoFocus?: boolean;
+}
+export interface FormFieldContextValue extends FormFieldCtx {
+    error: FieldErrors<Record<string, any>>[number];
+}
+export declare const FormFieldProvider: React.FC<{
+    children: React.ReactNode;
+} & FormFieldCtx>;
+export declare const useFormField: () => FormFieldContextValue;
+export {};

package/dist/providers/form-field-provider.d.ts

@@ -0,0 +1,15 @@
+import { FormField } from '@inkeep/cxkit-types';
+import { ControllerRenderProps, FieldErrors } from 'react-hook-form';
+interface FormFieldCtx {
+    field: FormField;
+    fieldProps: ControllerRenderProps<Record<string, any>, string>;
+    autoFocus?: boolean;
+}
+export interface FormFieldContextValue extends FormFieldCtx {
+    error: FieldErrors<Record<string, any>>[number];
+}
+export declare const FormFieldProvider: React.FC<{
+    children: React.ReactNode;
+} & FormFieldCtx>;
+export declare const useFormField: () => FormFieldContextValue;
+export {};