npm - @melony/react - Versions diffs - 0.2.4 → 0.2.6 - Mend

@melony/react 0.2.4 → 0.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.cjs CHANGED Viewed

@@ -66,7 +66,9 @@ var MelonyProvider = ({
   children,
   client,
   initialEvents,
-  aggregationOptions
+  initialAdditionalBody,
+  aggregationOptions,
+  eventHandlers
 }) => {
   const [state, setState] = react.useState(client.getState());
   react.useEffect(() => {
@@ -82,19 +84,32 @@ var MelonyProvider = ({
     () => convertEventsToAggregatedMessages(state.events, aggregationOptions),
     [state.events, aggregationOptions]
   );
+  const send = react.useCallback(async (event, additionalBody) => {
+    const handler = eventHandlers?.[event.type];
+    if (handler) {
+      await handler(event, { client });
+      return;
+    }
+    const generator = client.send(event, { ...initialAdditionalBody, ...additionalBody });
+    for await (const _ of generator) {
+    }
+  }, [client, eventHandlers, initialAdditionalBody]);
+  const reset = react.useCallback((events = []) => {
+    client.reset(events);
+  }, [client]);
+  const stop = react.useCallback(() => {
+    client.stop();
+  }, [client]);
   const contextValue = react.useMemo(
     () => ({
       ...state,
       messages,
-      send: async (event) => {
-        const generator = client.send(event);
-        for await (const _ of generator) {
-        }
-      },
-      reset: client.reset.bind(client),
+      send,
+      reset,
+      stop,
       client
     }),
-    [state, messages, client]
+    [state, messages, send, reset, stop, client]
   );
   return /* @__PURE__ */ jsxRuntime.jsx(MelonyContext.Provider, { value: contextValue, children });
 };
@@ -109,6 +124,7 @@ function useMelonyInit(url, params = {}) {
   const [data, setData] = react.useState(null);
   const [loading, setLoading] = react.useState(true);
   const [error, setError] = react.useState(null);
+  const { client } = useMelony();
   react.useEffect(() => {
     let isMounted = true;
     async function init() {
@@ -127,9 +143,9 @@ function useMelonyInit(url, params = {}) {
         if (!response.ok) {
           throw new Error(`Failed to initialize: ${response.statusText}`);
         }
-        const json = await response.json();
+        const data2 = await response.json();
         if (isMounted) {
-          setData(json);
+          setData(data2);
         }
       } catch (err) {
         if (isMounted) {

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/utils/message-converter.ts","../src/providers/melony-provider.tsx","../src/hooks/use-melony.ts","../src/hooks/use-melony-init.ts"],"names":["createContext","useState","useEffect","useMemo","useContext"],"mappings":"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","file":"index.cjs","sourcesContent":["import { Event, RuntimeContext } 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: string;\n /* The content of the message, containing the events /\n content: Event[];\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}\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) => string;\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) => string; getRunId: (e: TEvent) => string \| undefined }\n ) => boolean;\n\n /\n Custom logic to process an event and update the current message.\n * By default, events are simply added to the message's content 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): string => e.type === \"user:text\" ? \"user\" : \"assistant\";\n\n/\n Default implementation for extracting runId from an event.\n /\nexport const defaultGetRunId = <T extends Event>(e: T, context?: RuntimeContext<any, T>): string \| undefined => {\n return context?.runId;\n};\n\n/\n Default implementation for extracting threadId from an event.\n /\nexport const defaultGetThreadId = <T extends Event>(e: T): string \| undefined => e.data?.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) => string; 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 current.content.push(event);\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 };\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 send: (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 send: async (event: Event) => {\n const generator = client.send(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","import { useEffect, useState } from \"react\";\n\n/\n A hook to initialize a Melony application by fetching the initial UI state.\n * \n * @param url The API endpoint to fetch the initial state from.\n * @param params Optional query parameters to include in the request.\n * @returns An object containing the UI data, loading state, and any error encountered.\n */\nexport function useMelonyInit<T = any>(\n url: string, \n params: Record<string, string \| number \| boolean \| undefined> = {}\n) {\n const [data, setData] = useState<T \| null>(null);\n const [loading, setLoading] = useState(true);\n const [error, setError] = useState<Error \| null>(null);\n\n useEffect(() => {\n let isMounted = true;\n\n async function init() {\n try {\n setLoading(true);\n setError(null);\n\n const searchParams = new URLSearchParams();\n Object.entries(params).forEach(([key, value]) => {\n if (value !== undefined) {\n searchParams.append(key, String(value));\n }\n });\n \n const queryString = searchParams.toString();\n const fullUrl = queryString ? `${url}${url.includes('?') ? '&' : '?'}${queryString}` : url;\n \n const response = await fetch(fullUrl);\n if (!response.ok) {\n throw new Error(`Failed to initialize: ${response.statusText}`);\n }\n const json = await response.json();\n \n if (isMounted) {\n setData(json);\n }\n } catch (err) {\n if (isMounted) {\n setError(err instanceof Error ? err : new Error(String(err)));\n }\n } finally {\n if (isMounted) {\n setLoading(false);\n }\n }\n }\n\n init();\n\n return () => {\n isMounted = false;\n };\n }, [url, JSON.stringify(params)]);\n\n return { data, loading, error };\n}\n"]}
1	+ {"version":3,"sources":["../src/utils/message-converter.ts","../src/providers/melony-provider.tsx","../src/hooks/use-melony.ts","../src/hooks/use-melony-init.ts"],"names":["createContext","useState","useEffect","useMemo","useCallback","useContext","data"],"mappings":"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","file":"index.cjs","sourcesContent":["import { Event, RuntimeContext } 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: string;\n /* The content of the message, containing the events /\n content: Event[];\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}\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) => string;\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) => string; getRunId: (e: TEvent) => string \| undefined }\n ) => boolean;\n\n /\n Custom logic to process an event and update the current message.\n * By default, events are simply added to the message's content 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): string => e.type === \"user:text\" ? \"user\" : \"assistant\";\n\n/\n Default implementation for extracting runId from an event.\n /\nexport const defaultGetRunId = <T extends Event>(e: T, context?: RuntimeContext<any, T>): string \| undefined => {\n return context?.runId;\n};\n\n/\n Default implementation for extracting threadId from an event.\n /\nexport const defaultGetThreadId = <T extends Event>(e: T): string \| undefined => e.data?.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) => string; 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 current.content.push(event);\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 };\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 useCallback,\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 send: (event: Event, additionalBody?: Record<string, any>) => Promise<void>;\n reset: (events?: Event[]) => void;\n stop: () => void;\n client: MelonyClient;\n config?: Config;\n messages: AggregatedMessage[];\n}\n\nexport const MelonyContext = createContext<MelonyContextValue \| undefined>(\n undefined,\n);\n\nexport type ClientHandler<TEvent extends Event = Event> = (\n event: TEvent,\n context: { client: MelonyClient<TEvent> }\n) => void \| Promise<void>;\n\nexport interface MelonyProviderProps {\n children: ReactNode;\n client: MelonyClient;\n initialEvents?: Event[];\n initialAdditionalBody?: Record<string, any>;\n aggregationOptions?: AggregateOptions;\n eventHandlers?: Record<string, ClientHandler>;\n}\n\nexport const MelonyProvider: React.FC<MelonyProviderProps> = ({\n children,\n client,\n initialEvents,\n initialAdditionalBody,\n aggregationOptions,\n eventHandlers,\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 send = useCallback(async (event: Event, additionalBody?: Record<string, any>) => {\n const handler = eventHandlers?.[event.type];\n if (handler) {\n await handler(event, { client });\n return;\n }\n\n const generator = client.send(event, { ...initialAdditionalBody, ...additionalBody });\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 }, [client, eventHandlers, initialAdditionalBody]);\n\n const reset = useCallback((events: Event[] = []) => {\n client.reset(events);\n }, [client]);\n\n const stop = useCallback(() => {\n client.stop();\n }, [client]);\n\n const contextValue = useMemo(\n () => ({\n ...state,\n messages,\n send,\n reset,\n stop,\n client,\n }),\n [state, messages, send, reset, stop, 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","import { useEffect, useState } from \"react\";\nimport { useMelony } from \"./use-melony\";\n\n/\n Fetches the initial UI state from a jsonResponse endpoint.\n */\nexport function useMelonyInit<T = any>(\n url: string,\n params: Record<string, string \| number \| boolean \| undefined> = {}\n) {\n const [data, setData] = useState<T \| null>(null);\n const [loading, setLoading] = useState(true);\n const [error, setError] = useState<Error \| null>(null);\n const { client } = useMelony();\n\n useEffect(() => {\n let isMounted = true;\n\n async function init() {\n try {\n setLoading(true);\n setError(null);\n\n const searchParams = new URLSearchParams();\n Object.entries(params).forEach(([key, value]) => {\n if (value !== undefined) {\n searchParams.append(key, String(value));\n }\n });\n\n const queryString = searchParams.toString();\n const fullUrl = queryString ? `${url}${url.includes('?') ? '&' : '?'}${queryString}` : url;\n\n const response = await fetch(fullUrl);\n if (!response.ok) {\n throw new Error(`Failed to initialize: ${response.statusText}`);\n }\n\n const data = await response.json();\n\n if (isMounted) {\n setData(data);\n }\n } catch (err) {\n if (isMounted) {\n setError(err instanceof Error ? err : new Error(String(err)));\n }\n } finally {\n if (isMounted) {\n setLoading(false);\n }\n }\n }\n\n init();\n\n return () => {\n isMounted = false;\n };\n }, [url, JSON.stringify(params)]);\n\n return { data, loading, error };\n}\n"]}

package/dist/index.d.cts CHANGED Viewed

@@ -86,29 +86,31 @@ declare const defaultProcessEvent: <T extends Event>(event: T, current: Aggregat
 declare function convertEventsToAggregatedMessages<TEvent extends Event = Event>(events: TEvent[], options?: AggregateOptions<TEvent>): AggregatedMessage[];
 interface MelonyContextValue extends ClientState {
-    send: (event: Event) => Promise<void>;
+    send: (event: Event, additionalBody?: Record<string, any>) => Promise<void>;
     reset: (events?: Event[]) => void;
+    stop: () => void;
     client: MelonyClient;
     config?: Config;
     messages: AggregatedMessage[];
 }
 declare const MelonyContext: React.Context<MelonyContextValue | undefined>;
+type ClientHandler<TEvent extends Event = Event> = (event: TEvent, context: {
+    client: MelonyClient<TEvent>;
+}) => void | Promise<void>;
 interface MelonyProviderProps {
     children: ReactNode;
     client: MelonyClient;
     initialEvents?: Event[];
+    initialAdditionalBody?: Record<string, any>;
     aggregationOptions?: AggregateOptions;
+    eventHandlers?: Record<string, ClientHandler>;
 }
 declare const MelonyProvider: React.FC<MelonyProviderProps>;
 declare const useMelony: () => MelonyContextValue;
 /**
- * A hook to initialize a Melony application by fetching the initial UI state.
- *
- * @param url The API endpoint to fetch the initial state from.
- * @param params Optional query parameters to include in the request.
- * @returns An object containing the UI data, loading state, and any error encountered.
+ * Fetches the initial UI state from a jsonResponse endpoint.
  */
 declare function useMelonyInit<T = any>(url: string, params?: Record<string, string | number | boolean | undefined>): {
     data: T | null;
@@ -116,4 +118,4 @@ declare function useMelonyInit<T = any>(url: string, params?: Record<string, str
     error: Error | null;
 };
-export { type AggregateOptions, type AggregatedMessage, MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony, useMelonyInit };
+export { type AggregateOptions, type AggregatedMessage, type ClientHandler, MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony, useMelonyInit };

package/dist/index.d.ts CHANGED Viewed

@@ -86,29 +86,31 @@ declare const defaultProcessEvent: <T extends Event>(event: T, current: Aggregat
 declare function convertEventsToAggregatedMessages<TEvent extends Event = Event>(events: TEvent[], options?: AggregateOptions<TEvent>): AggregatedMessage[];
 interface MelonyContextValue extends ClientState {
-    send: (event: Event) => Promise<void>;
+    send: (event: Event, additionalBody?: Record<string, any>) => Promise<void>;
     reset: (events?: Event[]) => void;
+    stop: () => void;
     client: MelonyClient;
     config?: Config;
     messages: AggregatedMessage[];
 }
 declare const MelonyContext: React.Context<MelonyContextValue | undefined>;
+type ClientHandler<TEvent extends Event = Event> = (event: TEvent, context: {
+    client: MelonyClient<TEvent>;
+}) => void | Promise<void>;
 interface MelonyProviderProps {
     children: ReactNode;
     client: MelonyClient;
     initialEvents?: Event[];
+    initialAdditionalBody?: Record<string, any>;
     aggregationOptions?: AggregateOptions;
+    eventHandlers?: Record<string, ClientHandler>;
 }
 declare const MelonyProvider: React.FC<MelonyProviderProps>;
 declare const useMelony: () => MelonyContextValue;
 /**
- * A hook to initialize a Melony application by fetching the initial UI state.
- *
- * @param url The API endpoint to fetch the initial state from.
- * @param params Optional query parameters to include in the request.
- * @returns An object containing the UI data, loading state, and any error encountered.
+ * Fetches the initial UI state from a jsonResponse endpoint.
  */
 declare function useMelonyInit<T = any>(url: string, params?: Record<string, string | number | boolean | undefined>): {
     data: T | null;
@@ -116,4 +118,4 @@ declare function useMelonyInit<T = any>(url: string, params?: Record<string, str
     error: Error | null;
 };
-export { type AggregateOptions, type AggregatedMessage, MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony, useMelonyInit };
+export { type AggregateOptions, type AggregatedMessage, type ClientHandler, MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony, useMelonyInit };

package/dist/index.js CHANGED Viewed

@@ -1,4 +1,4 @@
-import { createContext, useState, useEffect, useMemo, useContext } from 'react';
+import { createContext, useState, useEffect, useMemo, useCallback, useContext } from 'react';
 import { jsx } from 'react/jsx-runtime';
 // src/providers/melony-provider.tsx
@@ -64,7 +64,9 @@ var MelonyProvider = ({
   children,
   client,
   initialEvents,
-  aggregationOptions
+  initialAdditionalBody,
+  aggregationOptions,
+  eventHandlers
 }) => {
   const [state, setState] = useState(client.getState());
   useEffect(() => {
@@ -80,19 +82,32 @@ var MelonyProvider = ({
     () => convertEventsToAggregatedMessages(state.events, aggregationOptions),
     [state.events, aggregationOptions]
   );
+  const send = useCallback(async (event, additionalBody) => {
+    const handler = eventHandlers?.[event.type];
+    if (handler) {
+      await handler(event, { client });
+      return;
+    }
+    const generator = client.send(event, { ...initialAdditionalBody, ...additionalBody });
+    for await (const _ of generator) {
+    }
+  }, [client, eventHandlers, initialAdditionalBody]);
+  const reset = useCallback((events = []) => {
+    client.reset(events);
+  }, [client]);
+  const stop = useCallback(() => {
+    client.stop();
+  }, [client]);
   const contextValue = useMemo(
     () => ({
       ...state,
       messages,
-      send: async (event) => {
-        const generator = client.send(event);
-        for await (const _ of generator) {
-        }
-      },
-      reset: client.reset.bind(client),
+      send,
+      reset,
+      stop,
       client
     }),
-    [state, messages, client]
+    [state, messages, send, reset, stop, client]
   );
   return /* @__PURE__ */ jsx(MelonyContext.Provider, { value: contextValue, children });
 };
@@ -107,6 +122,7 @@ function useMelonyInit(url, params = {}) {
   const [data, setData] = useState(null);
   const [loading, setLoading] = useState(true);
   const [error, setError] = useState(null);
+  const { client } = useMelony();
   useEffect(() => {
     let isMounted = true;
     async function init() {
@@ -125,9 +141,9 @@ function useMelonyInit(url, params = {}) {
         if (!response.ok) {
           throw new Error(`Failed to initialize: ${response.statusText}`);
         }
-        const json = await response.json();
+        const data2 = await response.json();
         if (isMounted) {
-          setData(json);
+          setData(data2);
         }
       } catch (err) {
         if (isMounted) {

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/utils/message-converter.ts","../src/providers/melony-provider.tsx","../src/hooks/use-melony.ts","../src/hooks/use-melony-init.ts"],"names":["useState","useEffect"],"mappings":"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","file":"index.js","sourcesContent":["import { Event, RuntimeContext } 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: string;\n /* The content of the message, containing the events /\n content: Event[];\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}\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) => string;\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) => string; getRunId: (e: TEvent) => string \| undefined }\n ) => boolean;\n\n /\n Custom logic to process an event and update the current message.\n * By default, events are simply added to the message's content 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): string => e.type === \"user:text\" ? \"user\" : \"assistant\";\n\n/\n Default implementation for extracting runId from an event.\n /\nexport const defaultGetRunId = <T extends Event>(e: T, context?: RuntimeContext<any, T>): string \| undefined => {\n return context?.runId;\n};\n\n/\n Default implementation for extracting threadId from an event.\n /\nexport const defaultGetThreadId = <T extends Event>(e: T): string \| undefined => e.data?.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) => string; 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 current.content.push(event);\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 };\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 send: (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 send: async (event: Event) => {\n const generator = client.send(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","import { useEffect, useState } from \"react\";\n\n/\n A hook to initialize a Melony application by fetching the initial UI state.\n * \n * @param url The API endpoint to fetch the initial state from.\n * @param params Optional query parameters to include in the request.\n * @returns An object containing the UI data, loading state, and any error encountered.\n */\nexport function useMelonyInit<T = any>(\n url: string, \n params: Record<string, string \| number \| boolean \| undefined> = {}\n) {\n const [data, setData] = useState<T \| null>(null);\n const [loading, setLoading] = useState(true);\n const [error, setError] = useState<Error \| null>(null);\n\n useEffect(() => {\n let isMounted = true;\n\n async function init() {\n try {\n setLoading(true);\n setError(null);\n\n const searchParams = new URLSearchParams();\n Object.entries(params).forEach(([key, value]) => {\n if (value !== undefined) {\n searchParams.append(key, String(value));\n }\n });\n \n const queryString = searchParams.toString();\n const fullUrl = queryString ? `${url}${url.includes('?') ? '&' : '?'}${queryString}` : url;\n \n const response = await fetch(fullUrl);\n if (!response.ok) {\n throw new Error(`Failed to initialize: ${response.statusText}`);\n }\n const json = await response.json();\n \n if (isMounted) {\n setData(json);\n }\n } catch (err) {\n if (isMounted) {\n setError(err instanceof Error ? err : new Error(String(err)));\n }\n } finally {\n if (isMounted) {\n setLoading(false);\n }\n }\n }\n\n init();\n\n return () => {\n isMounted = false;\n };\n }, [url, JSON.stringify(params)]);\n\n return { data, loading, error };\n}\n"]}
1	+ {"version":3,"sources":["../src/utils/message-converter.ts","../src/providers/melony-provider.tsx","../src/hooks/use-melony.ts","../src/hooks/use-melony-init.ts"],"names":["useState","useEffect","data"],"mappings":";;;;;;AAgEO,IAAM,iBAAiB,CAAkB,CAAA,KAAiB,CAAA,CAAE,IAAA,KAAS,cAAc,MAAA,GAAS;AAK5F,IAAM,eAAA,GAAkB,CAAkB,CAAA,EAAM,OAAA,KAAyD;AAC9G,EAAA,OAAO,OAAA,EAAS,KAAA;AAClB;AAKO,IAAM,kBAAA,GAAqB,CAAkB,CAAA,KAA6B,CAAA,CAAE,IAAA,EAAM;AAKlF,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,OAAA,CAAQ,OAAA,CAAQ,KAAK,KAAK,CAAA;AAC5B;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,SAAS,EAAC;AAAA,QACV,KAAA,EAAO,SAAS,KAAK,CAAA;AAAA,QACrB,QAAA,EAAU,YAAY,KAAK;AAAA,OAC7B;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;ACtIO,IAAM,aAAA,GAAgB,aAAA;AAAA,EAC3B;AACF;AAgBO,IAAM,iBAAgD,CAAC;AAAA,EAC5D,QAAA;AAAA,EACA,MAAA;AAAA,EACA,aAAA;AAAA,EACA,qBAAA;AAAA,EACA,kBAAA;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,IAAA,GAAO,WAAA,CAAY,OAAO,KAAA,EAAc,cAAA,KAAyC;AACrF,IAAA,MAAM,OAAA,GAAU,aAAA,GAAgB,KAAA,CAAM,IAAI,CAAA;AAC1C,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,MAAM,OAAA,CAAQ,KAAA,EAAO,EAAE,MAAA,EAAQ,CAAA;AAC/B,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,SAAA,GAAY,OAAO,IAAA,CAAK,KAAA,EAAO,EAAE,GAAG,qBAAA,EAAuB,GAAG,cAAA,EAAgB,CAAA;AAEpF,IAAA,WAAA,MAAiB,KAAK,SAAA,EAAW;AAAA,IAEjC;AAAA,EACF,CAAA,EAAG,CAAC,MAAA,EAAQ,aAAA,EAAe,qBAAqB,CAAC,CAAA;AAEjD,EAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,CAAC,MAAA,GAAkB,EAAC,KAAM;AAClD,IAAA,MAAA,CAAO,MAAM,MAAM,CAAA;AAAA,EACrB,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,IAAA,GAAO,YAAY,MAAM;AAC7B,IAAA,MAAA,CAAO,IAAA,EAAK;AAAA,EACd,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,YAAA,GAAe,OAAA;AAAA,IACnB,OAAO;AAAA,MACL,GAAG,KAAA;AAAA,MACH,QAAA;AAAA,MACA,IAAA;AAAA,MACA,KAAA;AAAA,MACA,IAAA;AAAA,MACA;AAAA,KACF,CAAA;AAAA,IACA,CAAC,KAAA,EAAO,QAAA,EAAU,IAAA,EAAM,KAAA,EAAO,MAAM,MAAM;AAAA,GAC7C;AAEA,EAAA,2BACG,aAAA,CAAc,QAAA,EAAd,EAAuB,KAAA,EAAO,cAC5B,QAAA,EACH,CAAA;AAEJ;AC9GO,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;ACJO,SAAS,aAAA,CACd,GAAA,EACA,MAAA,GAAgE,EAAC,EACjE;AACA,EAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAIA,SAAmB,IAAI,CAAA;AAC/C,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,SAAS,IAAI,CAAA;AAC3C,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,SAAuB,IAAI,CAAA;AACrD,EAAA,MAAM,EAAE,MAAA,EAAO,GAAI,SAAA,EAAU;AAE7B,EAAAC,UAAU,MAAM;AACd,IAAA,IAAI,SAAA,GAAY,IAAA;AAEhB,IAAA,eAAe,IAAA,GAAO;AACpB,MAAA,IAAI;AACF,QAAA,UAAA,CAAW,IAAI,CAAA;AACf,QAAA,QAAA,CAAS,IAAI,CAAA;AAEb,QAAA,MAAM,YAAA,GAAe,IAAI,eAAA,EAAgB;AACzC,QAAA,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,GAAA,EAAK,KAAK,CAAA,KAAM;AAC/C,UAAA,IAAI,UAAU,KAAA,CAAA,EAAW;AACvB,YAAA,YAAA,CAAa,MAAA,CAAO,GAAA,EAAK,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,UACxC;AAAA,QACF,CAAC,CAAA;AAED,QAAA,MAAM,WAAA,GAAc,aAAa,QAAA,EAAS;AAC1C,QAAA,MAAM,OAAA,GAAU,WAAA,GAAc,CAAA,EAAG,GAAG,CAAA,EAAG,GAAA,CAAI,QAAA,CAAS,GAAG,CAAA,GAAI,GAAA,GAAM,GAAG,CAAA,EAAG,WAAW,CAAA,CAAA,GAAK,GAAA;AAEvF,QAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,OAAO,CAAA;AACpC,QAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,UAAA,MAAM,IAAI,KAAA,CAAM,CAAA,sBAAA,EAAyB,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,QAChE;AAEA,QAAA,MAAMC,KAAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AAEjC,QAAA,IAAI,SAAA,EAAW;AACb,UAAA,OAAA,CAAQA,KAAI,CAAA;AAAA,QACd;AAAA,MACF,SAAS,GAAA,EAAK;AACZ,QAAA,IAAI,SAAA,EAAW;AACb,UAAA,QAAA,CAAS,GAAA,YAAe,QAAQ,GAAA,GAAM,IAAI,MAAM,MAAA,CAAO,GAAG,CAAC,CAAC,CAAA;AAAA,QAC9D;AAAA,MACF,CAAA,SAAE;AACA,QAAA,IAAI,SAAA,EAAW;AACb,UAAA,UAAA,CAAW,KAAK,CAAA;AAAA,QAClB;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAA,EAAK;AAEL,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,KAAA;AAAA,IACd,CAAA;AAAA,EACF,GAAG,CAAC,GAAA,EAAK,KAAK,SAAA,CAAU,MAAM,CAAC,CAAC,CAAA;AAEhC,EAAA,OAAO,EAAE,IAAA,EAAM,OAAA,EAAS,KAAA,EAAM;AAChC","file":"index.js","sourcesContent":["import { Event, RuntimeContext } 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: string;\n /* The content of the message, containing the events /\n content: Event[];\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}\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) => string;\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) => string; getRunId: (e: TEvent) => string \| undefined }\n ) => boolean;\n\n /\n Custom logic to process an event and update the current message.\n * By default, events are simply added to the message's content 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): string => e.type === \"user:text\" ? \"user\" : \"assistant\";\n\n/\n Default implementation for extracting runId from an event.\n /\nexport const defaultGetRunId = <T extends Event>(e: T, context?: RuntimeContext<any, T>): string \| undefined => {\n return context?.runId;\n};\n\n/\n Default implementation for extracting threadId from an event.\n /\nexport const defaultGetThreadId = <T extends Event>(e: T): string \| undefined => e.data?.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) => string; 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 current.content.push(event);\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 };\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 useCallback,\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 send: (event: Event, additionalBody?: Record<string, any>) => Promise<void>;\n reset: (events?: Event[]) => void;\n stop: () => void;\n client: MelonyClient;\n config?: Config;\n messages: AggregatedMessage[];\n}\n\nexport const MelonyContext = createContext<MelonyContextValue \| undefined>(\n undefined,\n);\n\nexport type ClientHandler<TEvent extends Event = Event> = (\n event: TEvent,\n context: { client: MelonyClient<TEvent> }\n) => void \| Promise<void>;\n\nexport interface MelonyProviderProps {\n children: ReactNode;\n client: MelonyClient;\n initialEvents?: Event[];\n initialAdditionalBody?: Record<string, any>;\n aggregationOptions?: AggregateOptions;\n eventHandlers?: Record<string, ClientHandler>;\n}\n\nexport const MelonyProvider: React.FC<MelonyProviderProps> = ({\n children,\n client,\n initialEvents,\n initialAdditionalBody,\n aggregationOptions,\n eventHandlers,\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 send = useCallback(async (event: Event, additionalBody?: Record<string, any>) => {\n const handler = eventHandlers?.[event.type];\n if (handler) {\n await handler(event, { client });\n return;\n }\n\n const generator = client.send(event, { ...initialAdditionalBody, ...additionalBody });\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 }, [client, eventHandlers, initialAdditionalBody]);\n\n const reset = useCallback((events: Event[] = []) => {\n client.reset(events);\n }, [client]);\n\n const stop = useCallback(() => {\n client.stop();\n }, [client]);\n\n const contextValue = useMemo(\n () => ({\n ...state,\n messages,\n send,\n reset,\n stop,\n client,\n }),\n [state, messages, send, reset, stop, 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","import { useEffect, useState } from \"react\";\nimport { useMelony } from \"./use-melony\";\n\n/\n Fetches the initial UI state from a jsonResponse endpoint.\n */\nexport function useMelonyInit<T = any>(\n url: string,\n params: Record<string, string \| number \| boolean \| undefined> = {}\n) {\n const [data, setData] = useState<T \| null>(null);\n const [loading, setLoading] = useState(true);\n const [error, setError] = useState<Error \| null>(null);\n const { client } = useMelony();\n\n useEffect(() => {\n let isMounted = true;\n\n async function init() {\n try {\n setLoading(true);\n setError(null);\n\n const searchParams = new URLSearchParams();\n Object.entries(params).forEach(([key, value]) => {\n if (value !== undefined) {\n searchParams.append(key, String(value));\n }\n });\n\n const queryString = searchParams.toString();\n const fullUrl = queryString ? `${url}${url.includes('?') ? '&' : '?'}${queryString}` : url;\n\n const response = await fetch(fullUrl);\n if (!response.ok) {\n throw new Error(`Failed to initialize: ${response.statusText}`);\n }\n\n const data = await response.json();\n\n if (isMounted) {\n setData(data);\n }\n } catch (err) {\n if (isMounted) {\n setError(err instanceof Error ? err : new Error(String(err)));\n }\n } finally {\n if (isMounted) {\n setLoading(false);\n }\n }\n }\n\n init();\n\n return () => {\n isMounted = false;\n };\n }, [url, JSON.stringify(params)]);\n\n return { data, loading, error };\n}\n"]}

package/package.json CHANGED Viewed

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