Merge branch 'main' into docs/add-example-links

Author: weedon-openai

.changeset/breezy-files-divide.md

@@ -0,0 +1,5 @@
+---
+'@openai/chatkit-react': patch
+---
+
+Removed usage of React 19 only ref callback cleanup function

.changeset/config.json

@@ -6,6 +6,5 @@
   "linked": [],
   "access": "public",
   "baseBranch": "main",
-  "updateInternalDependencies": "patch",
-  "ignore": ["react-explorer"]
+  "updateInternalDependencies": "patch"
 }

.changeset/thick-eggs-know.md

@@ -0,0 +1,5 @@
+---
+'@openai/chatkit-react': minor
+---
+
+Exposed a ref to the underlying `OpenAIChatKit` DOM element in the return value of `useChatKit`

packages/chatkit-react/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @openai/chatkit-react
+
+## 1.0.0
+
+### Major Changes
+
+- 5e4488e: Initial release
+
+### Patch Changes
+
+- Updated dependencies [5e4488e]
+  - @openai/chatkit@1.0.0

packages/chatkit-react/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openai/chatkit-react",
-  "version": "0.0.0",
+  "version": "1.0.0",
   "description": "React bindings for the ChatKit Web Component.",
   "type": "module",
   "sideEffects": false,
@@ -43,5 +43,9 @@
     "access": "public",
     "provenance": false
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openai/chatkit-js"
+  },
   "license": "MIT"
 }

packages/chatkit-react/src/ChatKit.tsx

@@ -45,46 +45,39 @@ export const ChatKit = React.forwardRef<OpenAIChatKit, ChatKitProps>(
     return (
       <openai-chatkit
         ref={(chatKit) => {
-          ref.current = chatKit;
           control.setInstance(chatKit);
+
           if (typeof forwardedRef === 'function') {
             forwardedRef(chatKit);
           } else if (forwardedRef) {
             forwardedRef.current = chatKit;
           }
 
-          if (ref.current) {
-            const abortController = new AbortController();
-            const events = {
-              'chatkit.error': 'onError',
-              'chatkit.response.end': 'onResponseEnd',
-              'chatkit.response.start': 'onResponseStart',
-              'chatkit.log': 'onLog',
-              'chatkit.thread.change': 'onThreadChange',
-              'chatkit.thread.load.start': 'onThreadLoadStart',
-              'chatkit.thread.load.end': 'onThreadLoadEnd',
-            } satisfies {
-              [K in keyof ChatKitEvents]: ToEventHandlerKey<K>;
-            };
+          if (!ref.current) {
+            return;
+          }
+
+          const events: {
+            [K in keyof ChatKitEvents]: ToEventHandlerKey<K>;
+          } = {
+            'chatkit.error': 'onError',
+            'chatkit.response.end': 'onResponseEnd',
+            'chatkit.response.start': 'onResponseStart',
+            'chatkit.log': 'onLog',
+            'chatkit.thread.change': 'onThreadChange',
+            'chatkit.thread.load.start': 'onThreadLoadStart',
+            'chatkit.thread.load.end': 'onThreadLoadEnd',
+          };
 
-            for (const eventName of Object.keys(
-              events,
-            ) as (keyof ChatKitEvents)[]) {
-              ref.current.addEventListener(
-                eventName,
-                (e) => {
-                  const handler = control.handlers[events[eventName]];
-                  if (typeof handler === 'function') {
-                    handler(e.detail as any);
-                  }
-                },
-                { signal: abortController.signal },
-              );
-            }
+          const eventNames = Object.keys(events) as (keyof ChatKitEvents)[];
 
-            return () => {
-              abortController.abort();
-            };
+          for (const event of eventNames) {
+            ref.current.addEventListener(event, (e) => {
+              const handler = control.handlers[events[event]];
+              if (typeof handler === 'function') {
+                handler(e.detail as any);
+              }
+            });
           }
         }}
         {...htmlProps}

packages/chatkit-react/src/useChatKit.ts

@@ -50,6 +50,7 @@ export type ChatKitControl = {
 
 export type UseChatKitReturn = ChatKitMethods & {
   control: ChatKitControl;
+  ref: React.RefObject<OpenAIChatKit | null>;
 };
 
 export function useChatKit(options: UseChatKitOptions): UseChatKitReturn {
@@ -98,5 +99,8 @@ export function useChatKit(options: UseChatKitOptions): UseChatKitReturn {
     };
   }, [stableOptions, setInstance]);
 
-  return React.useMemo(() => ({ ...methods, control }), [methods, control]);
+  return React.useMemo(
+    () => ({ ...methods, control, ref }),
+    [methods, control],
+  );
 }

packages/chatkit/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @openai/chatkit
+
+## 1.0.0
+
+### Major Changes
+
+- 5e4488e: Initial release

packages/chatkit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openai/chatkit",
-  "version": "0.0.0",
+  "version": "1.0.0",
   "type": "module",
   "description": "Type definitions for the ChatKit Web Component.",
   "sideEffects": false,
@@ -22,5 +22,9 @@
     "access": "public",
     "provenance": false
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openai/chatkit-js"
+  },
   "license": "MIT"
 }