@melony/react 0.2.1 → 0.2.2

package/dist/index.cjs

@@ -4,13 +4,74 @@ var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
 // src/providers/melony-provider.tsx
+
+// src/utils/message-converter.ts
+var defaultGetRole = (e) => e.meta?.role || "assistant";
+var defaultGetRunId = (e) => e.meta?.runId;
+var defaultGetThreadId = (e) => e.meta?.threadId || e.meta?.state?.threadId;
+var defaultShouldStartNewMessage = (event, current, utils) => {
+  if (!current) return true;
+  const role = utils.getRole(event);
+  const runId = utils.getRunId(event);
+  if (current.role !== role) return true;
+  if (runId && current.runId && runId !== current.runId) return true;
+  return false;
+};
+var defaultProcessEvent = (event, current) => {
+  if (event.type === "text-delta" && event.data?.delta) {
+    current.content += event.data.delta;
+  } else if (event.type === "text") {
+    current.content += event.data?.content || event.data?.text || "";
+  } else {
+    current.uiEvents.push(event);
+  }
+};
+function convertEventsToAggregatedMessages(events, options = {}) {
+  const getRole = options.getRole || defaultGetRole;
+  const getRunId = options.getRunId || defaultGetRunId;
+  const getThreadId = options.getThreadId || defaultGetThreadId;
+  const shouldStartNewMessage = options.shouldStartNewMessage || defaultShouldStartNewMessage;
+  const processEvent = options.processEvent || defaultProcessEvent;
+  if (events.length === 0) return [];
+  const messages = [];
+  let currentMessage = null;
+  for (const event of events) {
+    if (shouldStartNewMessage(event, currentMessage, { getRole, getRunId, getThreadId })) {
+      currentMessage = {
+        role: getRole(event),
+        content: "",
+        runId: getRunId(event),
+        threadId: getThreadId(event),
+        uiEvents: []
+      };
+      messages.push(currentMessage);
+    }
+    if (currentMessage) {
+      processEvent(event, currentMessage);
+      if (!currentMessage.runId) {
+        const runId = getRunId(event);
+        if (runId) {
+          currentMessage.runId = runId;
+        }
+      }
+      if (!currentMessage.threadId) {
+        const threadId = getThreadId(event);
+        if (threadId) {
+          currentMessage.threadId = threadId;
+        }
+      }
+    }
+  }
+  return messages;
+}
 var MelonyContext = react.createContext(
   void 0
 );
 var MelonyProvider = ({
   children,
   client,
-  initialEvents
+  initialEvents,
+  aggregationOptions
 }) => {
   const [state, setState] = react.useState(client.getState());
   react.useEffect(() => {
@@ -22,9 +83,14 @@ var MelonyProvider = ({
     const unsubscribe = client.subscribe(setState);
     return unsubscribe;
   }, [client]);
+  const messages = react.useMemo(
+    () => convertEventsToAggregatedMessages(state.events, aggregationOptions),
+    [state.events, aggregationOptions]
+  );
   const contextValue = react.useMemo(
     () => ({
       ...state,
+      messages,
       sendEvent: async (event) => {
         const generator = client.sendEvent(event);
         for await (const _ of generator) {
@@ -33,7 +99,7 @@ var MelonyProvider = ({
       reset: client.reset.bind(client),
       client
     }),
-    [state, client]
+    [state, messages, client]
   );
   return /* @__PURE__ */ jsxRuntime.jsx(MelonyContext.Provider, { value: contextValue, children });
 };
@@ -47,6 +113,12 @@ var useMelony = () => {
 
 exports.MelonyContext = MelonyContext;
 exports.MelonyProvider = MelonyProvider;
+exports.convertEventsToAggregatedMessages = convertEventsToAggregatedMessages;
+exports.defaultGetRole = defaultGetRole;
+exports.defaultGetRunId = defaultGetRunId;
+exports.defaultGetThreadId = defaultGetThreadId;
+exports.defaultProcessEvent = defaultProcessEvent;
+exports.defaultShouldStartNewMessage = defaultShouldStartNewMessage;
 exports.useMelony = useMelony;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/providers/melony-provider.tsx","../src/hooks/use-melony.ts"],"names":["createContext","useState","useEffect","useMemo","useContext"],"mappings":";;;;;;AAoBO,IAAM,aAAA,GAAgBA,mBAAA;AAAA,EAC3B;AACF;AAQO,IAAM,iBAAgD,CAAC;AAAA,EAC5D,QAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAA,KAAM;AACJ,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,IAAIC,cAAA,CAAsB,MAAA,CAAO,UAAU,CAAA;AAGjE,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,eAAe,MAAA,IAAU,MAAA,CAAO,UAAS,CAAE,MAAA,CAAO,WAAW,CAAA,EAAG;AAClE,MAAA,MAAA,CAAO,MAAM,aAAa,CAAA;AAAA,IAC5B;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAGL,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,WAAA,GAAc,MAAA,CAAO,SAAA,CAAU,QAAQ,CAAA;AAC7C,IAAA,OAAO,WAAA;AAAA,EACT,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,YAAA,GAAeC,aAAA;AAAA,IACnB,OAAO;AAAA,MACL,GAAG,KAAA;AAAA,MACH,SAAA,EAAW,OAAO,KAAA,KAAiB;AACjC,QAAA,MAAM,SAAA,GAAY,MAAA,CAAO,SAAA,CAAU,KAAK,CAAA;AAExC,QAAA,WAAA,MAAiB,KAAK,SAAA,EAAW;AAAA,QAEjC;AAAA,MACF,CAAA;AAAA,MACA,KAAA,EAAO,MAAA,CAAO,KAAA,CAAM,IAAA,CAAK,MAAM,CAAA;AAAA,MAC/B;AAAA,KACF,CAAA;AAAA,IACA,CAAC,OAAO,MAAM;AAAA,GAChB;AAEA,EAAA,sCACG,aAAA,CAAc,QAAA,EAAd,EAAuB,KAAA,EAAO,cAC5B,QAAA,EACH,CAAA;AAEJ;ACpEO,IAAM,YAAY,MAA0B;AACjD,EAAA,MAAM,OAAA,GAAUC,iBAAW,aAAa,CAAA;AACxC,EAAA,IAAI,YAAY,MAAA,EAAW;AACzB,IAAA,MAAM,IAAI,MAAM,gDAAgD,CAAA;AAAA,EAClE;AAEA,EAAA,OAAO,OAAA;AACT","file":"index.cjs","sourcesContent":["import React, {\n  createContext,\n  useEffect,\n  useState,\n  useMemo,\n  ReactNode,\n} from \"react\";\nimport { MelonyClient, ClientState } from \"melony/client\";\nimport {\n  Config,\n  Event,\n} from \"melony\";\n\nexport interface MelonyContextValue extends ClientState {\n  sendEvent: (event: Event) => Promise<void>;\n  reset: (events?: Event[]) => void;\n  client: MelonyClient;\n  config?: Config;\n}\n\nexport const MelonyContext = createContext<MelonyContextValue | undefined>(\n  undefined,\n);\n\nexport interface MelonyProviderProps {\n  children: ReactNode;\n  client: MelonyClient;\n  initialEvents?: Event[];\n}\n\nexport const MelonyProvider: React.FC<MelonyProviderProps> = ({\n  children,\n  client,\n  initialEvents,\n}) => {\n  const [state, setState] = useState<ClientState>(client.getState());\n\n  // Handle initial events on mount only\n  useEffect(() => {\n    if (initialEvents?.length && client.getState().events.length === 0) {\n      client.reset(initialEvents);\n    }\n  }, []); // Empty deps - run once on mount\n\n  // Subscribe to state changes\n  useEffect(() => {\n    const unsubscribe = client.subscribe(setState);\n    return unsubscribe;\n  }, [client]);\n\n  const contextValue = useMemo(\n    () => ({\n      ...state,\n      sendEvent: async (event: Event) => {\n        const generator = client.sendEvent(event);\n        // Consume the generator to ensure event processing completes\n        for await (const _ of generator) {\n          // Events are handled by the client subscription\n        }\n      },\n      reset: client.reset.bind(client),\n      client,\n    }),\n    [state, client],\n  );\n\n  return (\n    <MelonyContext.Provider value={contextValue}>\n      {children}\n    </MelonyContext.Provider>\n  );\n};","import { useContext } from \"react\";\nimport { MelonyContext, MelonyContextValue } from \"@/providers/melony-provider\";\n\nexport const useMelony = (): MelonyContextValue => {\n  const context = useContext(MelonyContext);\n  if (context === undefined) {\n    throw new Error(\"useMelony must be used within a MelonyProvider\");\n  }\n\n  return context;\n};\n"]}
+{"version":3,"sources":["../src/utils/message-converter.ts","../src/providers/melony-provider.tsx","../src/hooks/use-melony.ts"],"names":["createContext","useState","useEffect","useMemo","useContext"],"mappings":"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","file":"index.cjs","sourcesContent":["import { Event, Role } from \"melony\";\n\n/**\n * A message aggregated from multiple events.\n */\nexport interface AggregatedMessage {\n  /** The role of the sender (user, assistant, or system) */\n  role: Role;\n  /** The text content of the message, aggregated from text events */\n  content: string;\n  /** The unique ID for the run that produced this message */\n  runId?: string;\n  /** The ID of the thread this message belongs to */\n  threadId?: string;\n  /** UI events (e.g. SDUI components) associated with this message */\n  uiEvents: Event[];\n}\n\n/**\n * Options for configuring how events are aggregated into messages.\n */\nexport interface AggregateOptions<TEvent extends Event = Event> {\n  /**\n   * Custom logic to extract the role from an event.\n   * Defaults to event.meta.role or 'assistant'.\n   */\n  getRole?: (event: TEvent) => Role;\n\n  /**\n   * Custom logic to extract the runId from an event.\n   * Defaults to event.meta.runId.\n   */\n  getRunId?: (event: TEvent) => string | undefined;\n\n  /**\n   * Custom logic to extract the threadId from an event.\n   * Defaults to event.meta.threadId.\n   */\n  getThreadId?: (event: TEvent) => string | undefined;\n\n  /**\n   * Custom logic to determine if a new message should be started.\n   * By default, starts a new message if:\n   * 1. There is no current message.\n   * 2. The role of the event is different from the current message.\n   * 3. The runId of the event is different from the current message's runId.\n   */\n  shouldStartNewMessage?: (\n    event: TEvent,\n    currentMessage: AggregatedMessage | null,\n    options: { getRole: (e: TEvent) => Role; getRunId: (e: TEvent) => string | undefined }\n  ) => boolean;\n\n  /**\n   * Custom logic to process an event and update the current message.\n   * By default:\n   * - 'text-delta' events append their delta to the message content.\n   * - 'text' events append their content or text to the message content.\n   * - All other events are added to the message's uiEvents array.\n   */\n  processEvent?: (\n    event: TEvent,\n    currentMessage: AggregatedMessage,\n  ) => void;\n}\n\n/**\n * Default implementation for extracting role from an event.\n */\nexport const defaultGetRole = <T extends Event>(e: T): Role => e.meta?.role || \"assistant\";\n\n/**\n * Default implementation for extracting runId from an event.\n */\nexport const defaultGetRunId = <T extends Event>(e: T): string | undefined => e.meta?.runId;\n\n/**\n * Default implementation for extracting threadId from an event.\n */\nexport const defaultGetThreadId = <T extends Event>(e: T): string | undefined => e.meta?.threadId || e.meta?.state?.threadId;\n\n/**\n * Default logic for determining if a new message should start.\n */\nexport const defaultShouldStartNewMessage = <T extends Event>(\n  event: T,\n  current: AggregatedMessage | null,\n  utils: { getRole: (e: T) => Role; getRunId: (e: T) => string | undefined; getThreadId: (e: T) => string | undefined }\n): boolean => {\n  if (!current) return true;\n  const role = utils.getRole(event);\n  const runId = utils.getRunId(event);\n  \n  // Start new message if role changes\n  if (current.role !== role) return true;\n  \n  // Start new message if runId changes (and both have runIds)\n  if (runId && current.runId && runId !== current.runId) return true;\n  \n  return false;\n};\n\n/**\n * Default logic for processing an event into a message.\n */\nexport const defaultProcessEvent = <T extends Event>(event: T, current: AggregatedMessage): void => {\n  if (event.type === \"text-delta\" && (event.data as any)?.delta) {\n    current.content += (event.data as any).delta;\n  } else if (event.type === \"text\") {\n    current.content += (event.data as any)?.content || (event.data as any)?.text || \"\";\n  } else {\n    current.uiEvents.push(event);\n  }\n};\n\n/**\n * Helper to aggregate a list of events into a list of messages.\n * This is useful for rendering a chat-like interface from a raw event stream.\n * \n * @param events The list of events to aggregate.\n * @param options Configuration for aggregation logic.\n * @returns An array of aggregated messages.\n */\nexport function convertEventsToAggregatedMessages<TEvent extends Event = Event>(\n  events: TEvent[],\n  options: AggregateOptions<TEvent> = {}\n): AggregatedMessage[] {\n  const getRole = options.getRole || defaultGetRole;\n  const getRunId = options.getRunId || defaultGetRunId;\n  const getThreadId = options.getThreadId || defaultGetThreadId;\n  const shouldStartNewMessage = options.shouldStartNewMessage || defaultShouldStartNewMessage;\n  const processEvent = options.processEvent || defaultProcessEvent;\n\n  if (events.length === 0) return [];\n\n  const messages: AggregatedMessage[] = [];\n  let currentMessage: AggregatedMessage | null = null;\n\n  for (const event of events) {\n    if (shouldStartNewMessage(event, currentMessage, { getRole, getRunId, getThreadId })) {\n      currentMessage = {\n        role: getRole(event),\n        content: \"\",\n        runId: getRunId(event),\n        threadId: getThreadId(event),\n        uiEvents: [],\n      };\n      messages.push(currentMessage);\n    }\n\n    if (currentMessage) {\n      processEvent(event, currentMessage);\n      \n      // If current message didn't have a runId but this event does, update it\n      if (!currentMessage.runId) {\n        const runId = getRunId(event);\n        if (runId) {\n          currentMessage.runId = runId;\n        }\n      }\n\n      // If current message didn't have a threadId but this event does, update it\n      if (!currentMessage.threadId) {\n        const threadId = getThreadId(event);\n        if (threadId) {\n          currentMessage.threadId = threadId;\n        }\n      }\n    }\n  }\n\n  return messages;\n}\n","import React, {\n  createContext,\n  useEffect,\n  useState,\n  useMemo,\n  ReactNode,\n} from \"react\";\nimport { MelonyClient, ClientState } from \"melony/client\";\nimport {\n  Config,\n  Event,\n} from \"melony\";\nimport { \n  AggregatedMessage, \n  AggregateOptions, \n  convertEventsToAggregatedMessages \n} from \"../utils/message-converter\";\n\nexport interface MelonyContextValue extends ClientState {\n  sendEvent: (event: Event) => Promise<void>;\n  reset: (events?: Event[]) => void;\n  client: MelonyClient;\n  config?: Config;\n  messages: AggregatedMessage[];\n}\n\nexport const MelonyContext = createContext<MelonyContextValue | undefined>(\n  undefined,\n);\n\nexport interface MelonyProviderProps {\n  children: ReactNode;\n  client: MelonyClient;\n  initialEvents?: Event[];\n  aggregationOptions?: AggregateOptions;\n}\n\nexport const MelonyProvider: React.FC<MelonyProviderProps> = ({\n  children,\n  client,\n  initialEvents,\n  aggregationOptions,\n}) => {\n  const [state, setState] = useState<ClientState>(client.getState());\n\n  // Handle initial events on mount only\n  useEffect(() => {\n    if (initialEvents?.length && client.getState().events.length === 0) {\n      client.reset(initialEvents);\n    }\n  }, []); // Empty deps - run once on mount\n\n  // Subscribe to state changes\n  useEffect(() => {\n    const unsubscribe = client.subscribe(setState);\n    return unsubscribe;\n  }, [client]);\n\n  const messages = useMemo(\n    () => convertEventsToAggregatedMessages(state.events, aggregationOptions),\n    [state.events, aggregationOptions]\n  );\n\n  const contextValue = useMemo(\n    () => ({\n      ...state,\n      messages,\n      sendEvent: async (event: Event) => {\n        const generator = client.sendEvent(event);\n        // Consume the generator to ensure event processing completes\n        for await (const _ of generator) {\n          // Events are handled by the client subscription\n        }\n      },\n      reset: client.reset.bind(client),\n      client,\n    }),\n    [state, messages, client],\n  );\n\n  return (\n    <MelonyContext.Provider value={contextValue}>\n      {children}\n    </MelonyContext.Provider>\n  );\n};","import { useContext } from \"react\";\nimport { MelonyContext, MelonyContextValue } from \"@/providers/melony-provider\";\n\nexport const useMelony = (): MelonyContextValue => {\n  const context = useContext(MelonyContext);\n  if (context === undefined) {\n    throw new Error(\"useMelony must be used within a MelonyProvider\");\n  }\n\n  return context;\n};\n"]}

package/dist/index.d.cts

@@ -1,21 +1,111 @@
 import React, { ReactNode } from 'react';
 import { ClientState, MelonyClient } from 'melony/client';
-import { Event, Config } from 'melony';
+import { Role, Event, Config } from 'melony';
+
+/**
+ * A message aggregated from multiple events.
+ */
+interface AggregatedMessage {
+    /** The role of the sender (user, assistant, or system) */
+    role: Role;
+    /** The text content of the message, aggregated from text events */
+    content: string;
+    /** The unique ID for the run that produced this message */
+    runId?: string;
+    /** The ID of the thread this message belongs to */
+    threadId?: string;
+    /** UI events (e.g. SDUI components) associated with this message */
+    uiEvents: Event[];
+}
+/**
+ * Options for configuring how events are aggregated into messages.
+ */
+interface AggregateOptions<TEvent extends Event = Event> {
+    /**
+     * Custom logic to extract the role from an event.
+     * Defaults to event.meta.role or 'assistant'.
+     */
+    getRole?: (event: TEvent) => Role;
+    /**
+     * Custom logic to extract the runId from an event.
+     * Defaults to event.meta.runId.
+     */
+    getRunId?: (event: TEvent) => string | undefined;
+    /**
+     * Custom logic to extract the threadId from an event.
+     * Defaults to event.meta.threadId.
+     */
+    getThreadId?: (event: TEvent) => string | undefined;
+    /**
+     * Custom logic to determine if a new message should be started.
+     * By default, starts a new message if:
+     * 1. There is no current message.
+     * 2. The role of the event is different from the current message.
+     * 3. The runId of the event is different from the current message's runId.
+     */
+    shouldStartNewMessage?: (event: TEvent, currentMessage: AggregatedMessage | null, options: {
+        getRole: (e: TEvent) => Role;
+        getRunId: (e: TEvent) => string | undefined;
+    }) => boolean;
+    /**
+     * Custom logic to process an event and update the current message.
+     * By default:
+     * - 'text-delta' events append their delta to the message content.
+     * - 'text' events append their content or text to the message content.
+     * - All other events are added to the message's uiEvents array.
+     */
+    processEvent?: (event: TEvent, currentMessage: AggregatedMessage) => void;
+}
+/**
+ * Default implementation for extracting role from an event.
+ */
+declare const defaultGetRole: <T extends Event>(e: T) => Role;
+/**
+ * Default implementation for extracting runId from an event.
+ */
+declare const defaultGetRunId: <T extends Event>(e: T) => string | undefined;
+/**
+ * Default implementation for extracting threadId from an event.
+ */
+declare const defaultGetThreadId: <T extends Event>(e: T) => string | undefined;
+/**
+ * Default logic for determining if a new message should start.
+ */
+declare const defaultShouldStartNewMessage: <T extends Event>(event: T, current: AggregatedMessage | null, utils: {
+    getRole: (e: T) => Role;
+    getRunId: (e: T) => string | undefined;
+    getThreadId: (e: T) => string | undefined;
+}) => boolean;
+/**
+ * Default logic for processing an event into a message.
+ */
+declare const defaultProcessEvent: <T extends Event>(event: T, current: AggregatedMessage) => void;
+/**
+ * Helper to aggregate a list of events into a list of messages.
+ * This is useful for rendering a chat-like interface from a raw event stream.
+ *
+ * @param events The list of events to aggregate.
+ * @param options Configuration for aggregation logic.
+ * @returns An array of aggregated messages.
+ */
+declare function convertEventsToAggregatedMessages<TEvent extends Event = Event>(events: TEvent[], options?: AggregateOptions<TEvent>): AggregatedMessage[];
 
 interface MelonyContextValue extends ClientState {
     sendEvent: (event: Event) => Promise<void>;
     reset: (events?: Event[]) => void;
     client: MelonyClient;
     config?: Config;
+    messages: AggregatedMessage[];
 }
 declare const MelonyContext: React.Context<MelonyContextValue | undefined>;
 interface MelonyProviderProps {
     children: ReactNode;
     client: MelonyClient;
     initialEvents?: Event[];
+    aggregationOptions?: AggregateOptions;
 }
 declare const MelonyProvider: React.FC<MelonyProviderProps>;
 
 declare const useMelony: () => MelonyContextValue;
 
-export { MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, useMelony };
+export { type AggregateOptions, type AggregatedMessage, MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony };

package/dist/index.d.ts

@@ -1,21 +1,111 @@
 import React, { ReactNode } from 'react';
 import { ClientState, MelonyClient } from 'melony/client';
-import { Event, Config } from 'melony';
+import { Role, Event, Config } from 'melony';
+
+/**
+ * A message aggregated from multiple events.
+ */
+interface AggregatedMessage {
+    /** The role of the sender (user, assistant, or system) */
+    role: Role;
+    /** The text content of the message, aggregated from text events */
+    content: string;
+    /** The unique ID for the run that produced this message */
+    runId?: string;
+    /** The ID of the thread this message belongs to */
+    threadId?: string;
+    /** UI events (e.g. SDUI components) associated with this message */
+    uiEvents: Event[];
+}
+/**
+ * Options for configuring how events are aggregated into messages.
+ */
+interface AggregateOptions<TEvent extends Event = Event> {
+    /**
+     * Custom logic to extract the role from an event.
+     * Defaults to event.meta.role or 'assistant'.
+     */
+    getRole?: (event: TEvent) => Role;
+    /**
+     * Custom logic to extract the runId from an event.
+     * Defaults to event.meta.runId.
+     */
+    getRunId?: (event: TEvent) => string | undefined;
+    /**
+     * Custom logic to extract the threadId from an event.
+     * Defaults to event.meta.threadId.
+     */
+    getThreadId?: (event: TEvent) => string | undefined;
+    /**
+     * Custom logic to determine if a new message should be started.
+     * By default, starts a new message if:
+     * 1. There is no current message.
+     * 2. The role of the event is different from the current message.
+     * 3. The runId of the event is different from the current message's runId.
+     */
+    shouldStartNewMessage?: (event: TEvent, currentMessage: AggregatedMessage | null, options: {
+        getRole: (e: TEvent) => Role;
+        getRunId: (e: TEvent) => string | undefined;
+    }) => boolean;
+    /**
+     * Custom logic to process an event and update the current message.
+     * By default:
+     * - 'text-delta' events append their delta to the message content.
+     * - 'text' events append their content or text to the message content.
+     * - All other events are added to the message's uiEvents array.
+     */
+    processEvent?: (event: TEvent, currentMessage: AggregatedMessage) => void;
+}
+/**
+ * Default implementation for extracting role from an event.
+ */
+declare const defaultGetRole: <T extends Event>(e: T) => Role;
+/**
+ * Default implementation for extracting runId from an event.
+ */
+declare const defaultGetRunId: <T extends Event>(e: T) => string | undefined;
+/**
+ * Default implementation for extracting threadId from an event.
+ */
+declare const defaultGetThreadId: <T extends Event>(e: T) => string | undefined;
+/**
+ * Default logic for determining if a new message should start.
+ */
+declare const defaultShouldStartNewMessage: <T extends Event>(event: T, current: AggregatedMessage | null, utils: {
+    getRole: (e: T) => Role;
+    getRunId: (e: T) => string | undefined;
+    getThreadId: (e: T) => string | undefined;
+}) => boolean;
+/**
+ * Default logic for processing an event into a message.
+ */
+declare const defaultProcessEvent: <T extends Event>(event: T, current: AggregatedMessage) => void;
+/**
+ * Helper to aggregate a list of events into a list of messages.
+ * This is useful for rendering a chat-like interface from a raw event stream.
+ *
+ * @param events The list of events to aggregate.
+ * @param options Configuration for aggregation logic.
+ * @returns An array of aggregated messages.
+ */
+declare function convertEventsToAggregatedMessages<TEvent extends Event = Event>(events: TEvent[], options?: AggregateOptions<TEvent>): AggregatedMessage[];
 
 interface MelonyContextValue extends ClientState {
     sendEvent: (event: Event) => Promise<void>;
     reset: (events?: Event[]) => void;
     client: MelonyClient;
     config?: Config;
+    messages: AggregatedMessage[];
 }
 declare const MelonyContext: React.Context<MelonyContextValue | undefined>;
 interface MelonyProviderProps {
     children: ReactNode;
     client: MelonyClient;
     initialEvents?: Event[];
+    aggregationOptions?: AggregateOptions;
 }
 declare const MelonyProvider: React.FC<MelonyProviderProps>;
 
 declare const useMelony: () => MelonyContextValue;
 
-export { MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, useMelony };
+export { type AggregateOptions, type AggregatedMessage, MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony };

package/dist/index.js

@@ -2,13 +2,74 @@ import { createContext, useState, useEffect, useMemo, useContext } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
 // src/providers/melony-provider.tsx
+
+// src/utils/message-converter.ts
+var defaultGetRole = (e) => e.meta?.role || "assistant";
+var defaultGetRunId = (e) => e.meta?.runId;
+var defaultGetThreadId = (e) => e.meta?.threadId || e.meta?.state?.threadId;
+var defaultShouldStartNewMessage = (event, current, utils) => {
+  if (!current) return true;
+  const role = utils.getRole(event);
+  const runId = utils.getRunId(event);
+  if (current.role !== role) return true;
+  if (runId && current.runId && runId !== current.runId) return true;
+  return false;
+};
+var defaultProcessEvent = (event, current) => {
+  if (event.type === "text-delta" && event.data?.delta) {
+    current.content += event.data.delta;
+  } else if (event.type === "text") {
+    current.content += event.data?.content || event.data?.text || "";
+  } else {
+    current.uiEvents.push(event);
+  }
+};
+function convertEventsToAggregatedMessages(events, options = {}) {
+  const getRole = options.getRole || defaultGetRole;
+  const getRunId = options.getRunId || defaultGetRunId;
+  const getThreadId = options.getThreadId || defaultGetThreadId;
+  const shouldStartNewMessage = options.shouldStartNewMessage || defaultShouldStartNewMessage;
+  const processEvent = options.processEvent || defaultProcessEvent;
+  if (events.length === 0) return [];
+  const messages = [];
+  let currentMessage = null;
+  for (const event of events) {
+    if (shouldStartNewMessage(event, currentMessage, { getRole, getRunId, getThreadId })) {
+      currentMessage = {
+        role: getRole(event),
+        content: "",
+        runId: getRunId(event),
+        threadId: getThreadId(event),
+        uiEvents: []
+      };
+      messages.push(currentMessage);
+    }
+    if (currentMessage) {
+      processEvent(event, currentMessage);
+      if (!currentMessage.runId) {
+        const runId = getRunId(event);
+        if (runId) {
+          currentMessage.runId = runId;
+        }
+      }
+      if (!currentMessage.threadId) {
+        const threadId = getThreadId(event);
+        if (threadId) {
+          currentMessage.threadId = threadId;
+        }
+      }
+    }
+  }
+  return messages;
+}
 var MelonyContext = createContext(
   void 0
 );
 var MelonyProvider = ({
   children,
   client,
-  initialEvents
+  initialEvents,
+  aggregationOptions
 }) => {
   const [state, setState] = useState(client.getState());
   useEffect(() => {
@@ -20,9 +81,14 @@ var MelonyProvider = ({
     const unsubscribe = client.subscribe(setState);
     return unsubscribe;
   }, [client]);
+  const messages = useMemo(
+    () => convertEventsToAggregatedMessages(state.events, aggregationOptions),
+    [state.events, aggregationOptions]
+  );
   const contextValue = useMemo(
     () => ({
       ...state,
+      messages,
       sendEvent: async (event) => {
         const generator = client.sendEvent(event);
         for await (const _ of generator) {
@@ -31,7 +97,7 @@ var MelonyProvider = ({
       reset: client.reset.bind(client),
       client
     }),
-    [state, client]
+    [state, messages, client]
   );
   return /* @__PURE__ */ jsx(MelonyContext.Provider, { value: contextValue, children });
 };
@@ -43,6 +109,6 @@ var useMelony = () => {
   return context;
 };
 
-export { MelonyContext, MelonyProvider, useMelony };
+export { MelonyContext, MelonyProvider, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/providers/melony-provider.tsx","../src/hooks/use-melony.ts"],"names":[],"mappings":";;;;AAoBO,IAAM,aAAA,GAAgB,aAAA;AAAA,EAC3B;AACF;AAQO,IAAM,iBAAgD,CAAC;AAAA,EAC5D,QAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAA,KAAM;AACJ,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,IAAI,QAAA,CAAsB,MAAA,CAAO,UAAU,CAAA;AAGjE,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,eAAe,MAAA,IAAU,MAAA,CAAO,UAAS,CAAE,MAAA,CAAO,WAAW,CAAA,EAAG;AAClE,MAAA,MAAA,CAAO,MAAM,aAAa,CAAA;AAAA,IAC5B;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAGL,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,WAAA,GAAc,MAAA,CAAO,SAAA,CAAU,QAAQ,CAAA;AAC7C,IAAA,OAAO,WAAA;AAAA,EACT,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,YAAA,GAAe,OAAA;AAAA,IACnB,OAAO;AAAA,MACL,GAAG,KAAA;AAAA,MACH,SAAA,EAAW,OAAO,KAAA,KAAiB;AACjC,QAAA,MAAM,SAAA,GAAY,MAAA,CAAO,SAAA,CAAU,KAAK,CAAA;AAExC,QAAA,WAAA,MAAiB,KAAK,SAAA,EAAW;AAAA,QAEjC;AAAA,MACF,CAAA;AAAA,MACA,KAAA,EAAO,MAAA,CAAO,KAAA,CAAM,IAAA,CAAK,MAAM,CAAA;AAAA,MAC/B;AAAA,KACF,CAAA;AAAA,IACA,CAAC,OAAO,MAAM;AAAA,GAChB;AAEA,EAAA,2BACG,aAAA,CAAc,QAAA,EAAd,EAAuB,KAAA,EAAO,cAC5B,QAAA,EACH,CAAA;AAEJ;ACpEO,IAAM,YAAY,MAA0B;AACjD,EAAA,MAAM,OAAA,GAAU,WAAW,aAAa,CAAA;AACxC,EAAA,IAAI,YAAY,MAAA,EAAW;AACzB,IAAA,MAAM,IAAI,MAAM,gDAAgD,CAAA;AAAA,EAClE;AAEA,EAAA,OAAO,OAAA;AACT","file":"index.js","sourcesContent":["import React, {\n  createContext,\n  useEffect,\n  useState,\n  useMemo,\n  ReactNode,\n} from \"react\";\nimport { MelonyClient, ClientState } from \"melony/client\";\nimport {\n  Config,\n  Event,\n} from \"melony\";\n\nexport interface MelonyContextValue extends ClientState {\n  sendEvent: (event: Event) => Promise<void>;\n  reset: (events?: Event[]) => void;\n  client: MelonyClient;\n  config?: Config;\n}\n\nexport const MelonyContext = createContext<MelonyContextValue | undefined>(\n  undefined,\n);\n\nexport interface MelonyProviderProps {\n  children: ReactNode;\n  client: MelonyClient;\n  initialEvents?: Event[];\n}\n\nexport const MelonyProvider: React.FC<MelonyProviderProps> = ({\n  children,\n  client,\n  initialEvents,\n}) => {\n  const [state, setState] = useState<ClientState>(client.getState());\n\n  // Handle initial events on mount only\n  useEffect(() => {\n    if (initialEvents?.length && client.getState().events.length === 0) {\n      client.reset(initialEvents);\n    }\n  }, []); // Empty deps - run once on mount\n\n  // Subscribe to state changes\n  useEffect(() => {\n    const unsubscribe = client.subscribe(setState);\n    return unsubscribe;\n  }, [client]);\n\n  const contextValue = useMemo(\n    () => ({\n      ...state,\n      sendEvent: async (event: Event) => {\n        const generator = client.sendEvent(event);\n        // Consume the generator to ensure event processing completes\n        for await (const _ of generator) {\n          // Events are handled by the client subscription\n        }\n      },\n      reset: client.reset.bind(client),\n      client,\n    }),\n    [state, client],\n  );\n\n  return (\n    <MelonyContext.Provider value={contextValue}>\n      {children}\n    </MelonyContext.Provider>\n  );\n};","import { useContext } from \"react\";\nimport { MelonyContext, MelonyContextValue } from \"@/providers/melony-provider\";\n\nexport const useMelony = (): MelonyContextValue => {\n  const context = useContext(MelonyContext);\n  if (context === undefined) {\n    throw new Error(\"useMelony must be used within a MelonyProvider\");\n  }\n\n  return context;\n};\n"]}
+{"version":3,"sources":["../src/utils/message-converter.ts","../src/providers/melony-provider.tsx","../src/hooks/use-melony.ts"],"names":[],"mappings":";;;;;;AAqEO,IAAM,cAAA,GAAiB,CAAkB,CAAA,KAAe,CAAA,CAAE,MAAM,IAAA,IAAQ;AAKxE,IAAM,eAAA,GAAkB,CAAkB,CAAA,KAA6B,CAAA,CAAE,IAAA,EAAM;AAK/E,IAAM,kBAAA,GAAqB,CAAkB,CAAA,KAA6B,CAAA,CAAE,MAAM,QAAA,IAAY,CAAA,CAAE,MAAM,KAAA,EAAO;AAK7G,IAAM,4BAAA,GAA+B,CAC1C,KAAA,EACA,OAAA,EACA,KAAA,KACY;AACZ,EAAA,IAAI,CAAC,SAAS,OAAO,IAAA;AACrB,EAAA,MAAM,IAAA,GAAO,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA;AAChC,EAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,QAAA,CAAS,KAAK,CAAA;AAGlC,EAAA,IAAI,OAAA,CAAQ,IAAA,KAAS,IAAA,EAAM,OAAO,IAAA;AAGlC,EAAA,IAAI,SAAS,OAAA,CAAQ,KAAA,IAAS,KAAA,KAAU,OAAA,CAAQ,OAAO,OAAO,IAAA;AAE9D,EAAA,OAAO,KAAA;AACT;AAKO,IAAM,mBAAA,GAAsB,CAAkB,KAAA,EAAU,OAAA,KAAqC;AAClG,EAAA,IAAI,KAAA,CAAM,IAAA,KAAS,YAAA,IAAiB,KAAA,CAAM,MAAc,KAAA,EAAO;AAC7D,IAAA,OAAA,CAAQ,OAAA,IAAY,MAAM,IAAA,CAAa,KAAA;AAAA,EACzC,CAAA,MAAA,IAAW,KAAA,CAAM,IAAA,KAAS,MAAA,EAAQ;AAChC,IAAA,OAAA,CAAQ,WAAY,KAAA,CAAM,IAAA,EAAc,OAAA,IAAY,KAAA,CAAM,MAAc,IAAA,IAAQ,EAAA;AAAA,EAClF,CAAA,MAAO;AACL,IAAA,OAAA,CAAQ,QAAA,CAAS,KAAK,KAAK,CAAA;AAAA,EAC7B;AACF;AAUO,SAAS,iCAAA,CACd,MAAA,EACA,OAAA,GAAoC,EAAC,EAChB;AACrB,EAAA,MAAM,OAAA,GAAU,QAAQ,OAAA,IAAW,cAAA;AACnC,EAAA,MAAM,QAAA,GAAW,QAAQ,QAAA,IAAY,eAAA;AACrC,EAAA,MAAM,WAAA,GAAc,QAAQ,WAAA,IAAe,kBAAA;AAC3C,EAAA,MAAM,qBAAA,GAAwB,QAAQ,qBAAA,IAAyB,4BAAA;AAC/D,EAAA,MAAM,YAAA,GAAe,QAAQ,YAAA,IAAgB,mBAAA;AAE7C,EAAA,IAAI,MAAA,CAAO,MAAA,KAAW,CAAA,EAAG,OAAO,EAAC;AAEjC,EAAA,MAAM,WAAgC,EAAC;AACvC,EAAA,IAAI,cAAA,GAA2C,IAAA;AAE/C,EAAA,KAAA,MAAW,SAAS,MAAA,EAAQ;AAC1B,IAAA,IAAI,qBAAA,CAAsB,OAAO,cAAA,EAAgB,EAAE,SAAS,QAAA,EAAU,WAAA,EAAa,CAAA,EAAG;AACpF,MAAA,cAAA,GAAiB;AAAA,QACf,IAAA,EAAM,QAAQ,KAAK,CAAA;AAAA,QACnB,OAAA,EAAS,EAAA;AAAA,QACT,KAAA,EAAO,SAAS,KAAK,CAAA;AAAA,QACrB,QAAA,EAAU,YAAY,KAAK,CAAA;AAAA,QAC3B,UAAU;AAAC,OACb;AACA,MAAA,QAAA,CAAS,KAAK,cAAc,CAAA;AAAA,IAC9B;AAEA,IAAA,IAAI,cAAA,EAAgB;AAClB,MAAA,YAAA,CAAa,OAAO,cAAc,CAAA;AAGlC,MAAA,IAAI,CAAC,eAAe,KAAA,EAAO;AACzB,QAAA,MAAM,KAAA,GAAQ,SAAS,KAAK,CAAA;AAC5B,QAAA,IAAI,KAAA,EAAO;AACT,UAAA,cAAA,CAAe,KAAA,GAAQ,KAAA;AAAA,QACzB;AAAA,MACF;AAGA,MAAA,IAAI,CAAC,eAAe,QAAA,EAAU;AAC5B,QAAA,MAAM,QAAA,GAAW,YAAY,KAAK,CAAA;AAClC,QAAA,IAAI,QAAA,EAAU;AACZ,UAAA,cAAA,CAAe,QAAA,GAAW,QAAA;AAAA,QAC5B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,QAAA;AACT;AClJO,IAAM,aAAA,GAAgB,aAAA;AAAA,EAC3B;AACF;AASO,IAAM,iBAAgD,CAAC;AAAA,EAC5D,QAAA;AAAA,EACA,MAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF,CAAA,KAAM;AACJ,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,IAAI,QAAA,CAAsB,MAAA,CAAO,UAAU,CAAA;AAGjE,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,eAAe,MAAA,IAAU,MAAA,CAAO,UAAS,CAAE,MAAA,CAAO,WAAW,CAAA,EAAG;AAClE,MAAA,MAAA,CAAO,MAAM,aAAa,CAAA;AAAA,IAC5B;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAGL,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,WAAA,GAAc,MAAA,CAAO,SAAA,CAAU,QAAQ,CAAA;AAC7C,IAAA,OAAO,WAAA;AAAA,EACT,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,QAAA,GAAW,OAAA;AAAA,IACf,MAAM,iCAAA,CAAkC,KAAA,CAAM,MAAA,EAAQ,kBAAkB,CAAA;AAAA,IACxE,CAAC,KAAA,CAAM,MAAA,EAAQ,kBAAkB;AAAA,GACnC;AAEA,EAAA,MAAM,YAAA,GAAe,OAAA;AAAA,IACnB,OAAO;AAAA,MACL,GAAG,KAAA;AAAA,MACH,QAAA;AAAA,MACA,SAAA,EAAW,OAAO,KAAA,KAAiB;AACjC,QAAA,MAAM,SAAA,GAAY,MAAA,CAAO,SAAA,CAAU,KAAK,CAAA;AAExC,QAAA,WAAA,MAAiB,KAAK,SAAA,EAAW;AAAA,QAEjC;AAAA,MACF,CAAA;AAAA,MACA,KAAA,EAAO,MAAA,CAAO,KAAA,CAAM,IAAA,CAAK,MAAM,CAAA;AAAA,MAC/B;AAAA,KACF,CAAA;AAAA,IACA,CAAC,KAAA,EAAO,QAAA,EAAU,MAAM;AAAA,GAC1B;AAEA,EAAA,2BACG,aAAA,CAAc,QAAA,EAAd,EAAuB,KAAA,EAAO,cAC5B,QAAA,EACH,CAAA;AAEJ;AClFO,IAAM,YAAY,MAA0B;AACjD,EAAA,MAAM,OAAA,GAAU,WAAW,aAAa,CAAA;AACxC,EAAA,IAAI,YAAY,MAAA,EAAW;AACzB,IAAA,MAAM,IAAI,MAAM,gDAAgD,CAAA;AAAA,EAClE;AAEA,EAAA,OAAO,OAAA;AACT","file":"index.js","sourcesContent":["import { Event, Role } from \"melony\";\n\n/**\n * A message aggregated from multiple events.\n */\nexport interface AggregatedMessage {\n  /** The role of the sender (user, assistant, or system) */\n  role: Role;\n  /** The text content of the message, aggregated from text events */\n  content: string;\n  /** The unique ID for the run that produced this message */\n  runId?: string;\n  /** The ID of the thread this message belongs to */\n  threadId?: string;\n  /** UI events (e.g. SDUI components) associated with this message */\n  uiEvents: Event[];\n}\n\n/**\n * Options for configuring how events are aggregated into messages.\n */\nexport interface AggregateOptions<TEvent extends Event = Event> {\n  /**\n   * Custom logic to extract the role from an event.\n   * Defaults to event.meta.role or 'assistant'.\n   */\n  getRole?: (event: TEvent) => Role;\n\n  /**\n   * Custom logic to extract the runId from an event.\n   * Defaults to event.meta.runId.\n   */\n  getRunId?: (event: TEvent) => string | undefined;\n\n  /**\n   * Custom logic to extract the threadId from an event.\n   * Defaults to event.meta.threadId.\n   */\n  getThreadId?: (event: TEvent) => string | undefined;\n\n  /**\n   * Custom logic to determine if a new message should be started.\n   * By default, starts a new message if:\n   * 1. There is no current message.\n   * 2. The role of the event is different from the current message.\n   * 3. The runId of the event is different from the current message's runId.\n   */\n  shouldStartNewMessage?: (\n    event: TEvent,\n    currentMessage: AggregatedMessage | null,\n    options: { getRole: (e: TEvent) => Role; getRunId: (e: TEvent) => string | undefined }\n  ) => boolean;\n\n  /**\n   * Custom logic to process an event and update the current message.\n   * By default:\n   * - 'text-delta' events append their delta to the message content.\n   * - 'text' events append their content or text to the message content.\n   * - All other events are added to the message's uiEvents array.\n   */\n  processEvent?: (\n    event: TEvent,\n    currentMessage: AggregatedMessage,\n  ) => void;\n}\n\n/**\n * Default implementation for extracting role from an event.\n */\nexport const defaultGetRole = <T extends Event>(e: T): Role => e.meta?.role || \"assistant\";\n\n/**\n * Default implementation for extracting runId from an event.\n */\nexport const defaultGetRunId = <T extends Event>(e: T): string | undefined => e.meta?.runId;\n\n/**\n * Default implementation for extracting threadId from an event.\n */\nexport const defaultGetThreadId = <T extends Event>(e: T): string | undefined => e.meta?.threadId || e.meta?.state?.threadId;\n\n/**\n * Default logic for determining if a new message should start.\n */\nexport const defaultShouldStartNewMessage = <T extends Event>(\n  event: T,\n  current: AggregatedMessage | null,\n  utils: { getRole: (e: T) => Role; getRunId: (e: T) => string | undefined; getThreadId: (e: T) => string | undefined }\n): boolean => {\n  if (!current) return true;\n  const role = utils.getRole(event);\n  const runId = utils.getRunId(event);\n  \n  // Start new message if role changes\n  if (current.role !== role) return true;\n  \n  // Start new message if runId changes (and both have runIds)\n  if (runId && current.runId && runId !== current.runId) return true;\n  \n  return false;\n};\n\n/**\n * Default logic for processing an event into a message.\n */\nexport const defaultProcessEvent = <T extends Event>(event: T, current: AggregatedMessage): void => {\n  if (event.type === \"text-delta\" && (event.data as any)?.delta) {\n    current.content += (event.data as any).delta;\n  } else if (event.type === \"text\") {\n    current.content += (event.data as any)?.content || (event.data as any)?.text || \"\";\n  } else {\n    current.uiEvents.push(event);\n  }\n};\n\n/**\n * Helper to aggregate a list of events into a list of messages.\n * This is useful for rendering a chat-like interface from a raw event stream.\n * \n * @param events The list of events to aggregate.\n * @param options Configuration for aggregation logic.\n * @returns An array of aggregated messages.\n */\nexport function convertEventsToAggregatedMessages<TEvent extends Event = Event>(\n  events: TEvent[],\n  options: AggregateOptions<TEvent> = {}\n): AggregatedMessage[] {\n  const getRole = options.getRole || defaultGetRole;\n  const getRunId = options.getRunId || defaultGetRunId;\n  const getThreadId = options.getThreadId || defaultGetThreadId;\n  const shouldStartNewMessage = options.shouldStartNewMessage || defaultShouldStartNewMessage;\n  const processEvent = options.processEvent || defaultProcessEvent;\n\n  if (events.length === 0) return [];\n\n  const messages: AggregatedMessage[] = [];\n  let currentMessage: AggregatedMessage | null = null;\n\n  for (const event of events) {\n    if (shouldStartNewMessage(event, currentMessage, { getRole, getRunId, getThreadId })) {\n      currentMessage = {\n        role: getRole(event),\n        content: \"\",\n        runId: getRunId(event),\n        threadId: getThreadId(event),\n        uiEvents: [],\n      };\n      messages.push(currentMessage);\n    }\n\n    if (currentMessage) {\n      processEvent(event, currentMessage);\n      \n      // If current message didn't have a runId but this event does, update it\n      if (!currentMessage.runId) {\n        const runId = getRunId(event);\n        if (runId) {\n          currentMessage.runId = runId;\n        }\n      }\n\n      // If current message didn't have a threadId but this event does, update it\n      if (!currentMessage.threadId) {\n        const threadId = getThreadId(event);\n        if (threadId) {\n          currentMessage.threadId = threadId;\n        }\n      }\n    }\n  }\n\n  return messages;\n}\n","import React, {\n  createContext,\n  useEffect,\n  useState,\n  useMemo,\n  ReactNode,\n} from \"react\";\nimport { MelonyClient, ClientState } from \"melony/client\";\nimport {\n  Config,\n  Event,\n} from \"melony\";\nimport { \n  AggregatedMessage, \n  AggregateOptions, \n  convertEventsToAggregatedMessages \n} from \"../utils/message-converter\";\n\nexport interface MelonyContextValue extends ClientState {\n  sendEvent: (event: Event) => Promise<void>;\n  reset: (events?: Event[]) => void;\n  client: MelonyClient;\n  config?: Config;\n  messages: AggregatedMessage[];\n}\n\nexport const MelonyContext = createContext<MelonyContextValue | undefined>(\n  undefined,\n);\n\nexport interface MelonyProviderProps {\n  children: ReactNode;\n  client: MelonyClient;\n  initialEvents?: Event[];\n  aggregationOptions?: AggregateOptions;\n}\n\nexport const MelonyProvider: React.FC<MelonyProviderProps> = ({\n  children,\n  client,\n  initialEvents,\n  aggregationOptions,\n}) => {\n  const [state, setState] = useState<ClientState>(client.getState());\n\n  // Handle initial events on mount only\n  useEffect(() => {\n    if (initialEvents?.length && client.getState().events.length === 0) {\n      client.reset(initialEvents);\n    }\n  }, []); // Empty deps - run once on mount\n\n  // Subscribe to state changes\n  useEffect(() => {\n    const unsubscribe = client.subscribe(setState);\n    return unsubscribe;\n  }, [client]);\n\n  const messages = useMemo(\n    () => convertEventsToAggregatedMessages(state.events, aggregationOptions),\n    [state.events, aggregationOptions]\n  );\n\n  const contextValue = useMemo(\n    () => ({\n      ...state,\n      messages,\n      sendEvent: async (event: Event) => {\n        const generator = client.sendEvent(event);\n        // Consume the generator to ensure event processing completes\n        for await (const _ of generator) {\n          // Events are handled by the client subscription\n        }\n      },\n      reset: client.reset.bind(client),\n      client,\n    }),\n    [state, messages, client],\n  );\n\n  return (\n    <MelonyContext.Provider value={contextValue}>\n      {children}\n    </MelonyContext.Provider>\n  );\n};","import { useContext } from \"react\";\nimport { MelonyContext, MelonyContextValue } from \"@/providers/melony-provider\";\n\nexport const useMelony = (): MelonyContextValue => {\n  const context = useContext(MelonyContext);\n  if (context === undefined) {\n    throw new Error(\"useMelony must be used within a MelonyProvider\");\n  }\n\n  return context;\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melony/react",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "main": "dist/index.js",
   "type": "module",
   "sideEffects": false,
@@ -33,7 +33,7 @@
     "react": ">=18"
   },
   "dependencies": {
-    "melony": "^0.2.1"
+    "melony": "^0.2.2"
   },
   "devDependencies": {
     "@types/react": "^19.1.12",