@humeai/voice-embed 0.0.0-beta.21 → 0.0.0-beta.23

package/README.md

@@ -0,0 +1,82 @@
+<div align="center">
+  <img src="https://storage.googleapis.com/hume-public-logos/hume/hume-banner.png">
+  <h1>Hume AI Voice Embed SDK</h1>
+  <p>
+    <strong>Integrate Hume's Empathic Voice Interface directly into your web application</strong>
+  </p>
+</div>
+
+## Overview
+
+This package enables you to integrate a widget that runs Hume's Empathic Voice Interface any Javascript application. It abstracts away the complexities of managing websocket connections, capturing user audio via the client's microphone, and handling the playback of the interface's audio responses. The widget is embedded into your web page through an iframe. 
+
+There are two packages needed to embed your own widget. Install this package to embed the widget to your application. Code for the widget itself can be found at [https://github.com/HumeAI/empathic-voice-embed-renderer](https://github.com/HumeAI/empathic-voice-embed-renderer). 
+
+## Prerequisites
+
+Before installing this package, please ensure your development environment meets the following requirement:
+
+- Node.js (`v18.0.0` or higher).
+
+To verify your Node.js version, run this command in your terminal:
+
+```sh
+node --version
+```
+
+If your Node.js version is below `18.0.0`, update it to meet the requirement. For updating Node.js, visit [Node.js' official site](https://nodejs.org/) or use a version management tool like nvm for a more seamless upgrade process.
+
+## Installation
+
+Add `@humeai/voice-embed` to your project by running this command in your project directory:
+
+```bash
+npm install @humeai/voice-embed
+```
+
+This will download and include the package in your project, making it ready for import and use within your React components.
+
+```tsx
+import { EmbeddedVoice } from '@humeai/voice-embed';
+```
+
+__NOTE:__ If you are building a React application, you can use our React voice embed SDK instead of this one. [Documentation can be found here](https://github.com/HumeAI/empathic-voice-api-js/blob/main/packages/embed-react).
+
+## Usage
+
+### Quickstart
+
+Here's a simple example to get you started with the `EmbeddedVoice` component:
+
+```tsx
+import {
+  type CloseHandler,
+  EmbeddedVoice as EA,
+  type EmbeddedVoiceConfig,
+  type TranscriptMessageHandler,
+} from '@humeai/voice-embed';
+
+const embeddedVoice = EA.create({
+    // Configuration options
+});
+```
+
+**Note:** For integration within server components, instantiate `EmbeddedVoice` within a client component. For more information checkout the [Next.js documentation on client components](https://nextjs.org/docs/app/building-your-application/rendering/client-components).
+
+### Configuration options
+
+Configuration options for the embedded voice include all props that are accepted by the VoiceProvider in the [@humeai/voice-react package](https://github.com/HumeAI/empathic-voice-api-js/blob/main/packages/react).
+
+In addition, it accepts a few other configurations specific to creating a widget:
+
+| Option              | Required | Description                                                                                                                                                                                                                                                                                                                         |
+| ----------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `isEmbedOpen`       | yes      | Determines the initial visibility of the widget. Assign `true` to render the widget as open on initial load, and `false` to start with the widget closed. While the widget's UI provides a trigger to toggle its visibility, this prop also enables external control over the widget's visibility state through a parent component. |
+| rendererUrl       | no       | URL where the widget itself is hosted. If blank, this defaults the Hume AI widget, https://voice-widget.hume.ai. An example of this widget can be found at [http://hume.ai](http://hume.ai).                                                                                                                                                                                                                                      |
+| `onMessage`         | no       | Callback function to invoke upon receiving a message through the web socket.                                                                                                                                                                                                                                                        |
+| `onClose`           | no       | Callback function to invoke upon the web socket connection being closed.                                                                                                                                                                                                                                                            |
+| `openOnMount`           | no       | Boolean which indicates whether the widget should be initialized in an open or closed state. Set as `true` if you want it to be open. The default value is `false`.                                                                                                                                                                                                                                                             |
+
+## Support
+
+If you have questions or require assistance pertaining to this package, [reach out to us on Discord](https://hume.ai/discord)!

package/dist/index.d.mts

@@ -405,7 +405,7 @@ declare const FrameToClientActionSchema: z.ZodUnion<[z.ZodObject<{
                 end: number;
             } | null | undefined;
         }>;
-        from_tts: z.ZodCatch<z.ZodBoolean>;
+        from_text: z.ZodCatch<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         type: "assistant_message";
         message: {
@@ -422,7 +422,7 @@ declare const FrameToClientActionSchema: z.ZodUnion<[z.ZodObject<{
                 end: number;
             } | null | undefined;
         };
-        from_tts: boolean;
+        from_text: boolean;
     }, {
         type: "assistant_message";
         message: {
@@ -439,7 +439,7 @@ declare const FrameToClientActionSchema: z.ZodUnion<[z.ZodObject<{
                 end: number;
             } | null | undefined;
         };
-        from_tts?: unknown;
+        from_text?: unknown;
     }>, {
         type: "assistant_message";
         message: {
@@ -456,7 +456,7 @@ declare const FrameToClientActionSchema: z.ZodUnion<[z.ZodObject<{
                 end: number;
             } | null | undefined;
         };
-        from_tts: boolean;
+        from_text: boolean;
     } & {
         receivedAt: Date;
     }, {
@@ -475,7 +475,7 @@ declare const FrameToClientActionSchema: z.ZodUnion<[z.ZodObject<{
                 end: number;
             } | null | undefined;
         };
-        from_tts?: unknown;
+        from_text?: unknown;
     }>]>;
 }, "strip", z.ZodTypeAny, {
     type: "transcript_message";
@@ -512,7 +512,7 @@ declare const FrameToClientActionSchema: z.ZodUnion<[z.ZodObject<{
                 end: number;
             } | null | undefined;
         };
-        from_tts: boolean;
+        from_text: boolean;
     } & {
         receivedAt: Date;
     });
@@ -549,7 +549,7 @@ declare const FrameToClientActionSchema: z.ZodUnion<[z.ZodObject<{
                 end: number;
             } | null | undefined;
         };
-        from_tts?: unknown;
+        from_text?: unknown;
     };
 }>, z.ZodObject<{
     type: z.ZodLiteral<"resize_frame">;
@@ -624,7 +624,7 @@ declare const TRANSCRIPT_MESSAGE_ACTION: (message: UserTranscriptMessage | Assis
                 end: number;
             } | null | undefined;
         };
-        from_tts: boolean;
+        from_text: boolean;
     } & {
         receivedAt: Date;
     });

package/dist/index.d.ts

@@ -405,7 +405,7 @@ declare const FrameToClientActionSchema: z.ZodUnion<[z.ZodObject<{
                 end: number;
             } | null | undefined;
         }>;
-        from_tts: z.ZodCatch<z.ZodBoolean>;
+        from_text: z.ZodCatch<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         type: "assistant_message";
         message: {
@@ -422,7 +422,7 @@ declare const FrameToClientActionSchema: z.ZodUnion<[z.ZodObject<{
                 end: number;
             } | null | undefined;
         };
-        from_tts: boolean;
+        from_text: boolean;
     }, {
         type: "assistant_message";
         message: {
@@ -439,7 +439,7 @@ declare const FrameToClientActionSchema: z.ZodUnion<[z.ZodObject<{
                 end: number;
             } | null | undefined;
         };
-        from_tts?: unknown;
+        from_text?: unknown;
     }>, {
         type: "assistant_message";
         message: {
@@ -456,7 +456,7 @@ declare const FrameToClientActionSchema: z.ZodUnion<[z.ZodObject<{
                 end: number;
             } | null | undefined;
         };
-        from_tts: boolean;
+        from_text: boolean;
     } & {
         receivedAt: Date;
     }, {
@@ -475,7 +475,7 @@ declare const FrameToClientActionSchema: z.ZodUnion<[z.ZodObject<{
                 end: number;
             } | null | undefined;
         };
-        from_tts?: unknown;
+        from_text?: unknown;
     }>]>;
 }, "strip", z.ZodTypeAny, {
     type: "transcript_message";
@@ -512,7 +512,7 @@ declare const FrameToClientActionSchema: z.ZodUnion<[z.ZodObject<{
                 end: number;
             } | null | undefined;
         };
-        from_tts: boolean;
+        from_text: boolean;
     } & {
         receivedAt: Date;
     });
@@ -549,7 +549,7 @@ declare const FrameToClientActionSchema: z.ZodUnion<[z.ZodObject<{
                 end: number;
             } | null | undefined;
         };
-        from_tts?: unknown;
+        from_text?: unknown;
     };
 }>, z.ZodObject<{
     type: z.ZodLiteral<"resize_frame">;
@@ -624,7 +624,7 @@ declare const TRANSCRIPT_MESSAGE_ACTION: (message: UserTranscriptMessage | Assis
                 end: number;
             } | null | undefined;
         };
-        from_tts: boolean;
+        from_text: boolean;
     } & {
         receivedAt: Date;
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@humeai/voice-embed",
-  "version": "0.0.0-beta.21",
+  "version": "0.0.0-beta.23",
   "description": "",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -23,12 +23,12 @@
     "tsup": "^8.0.2",
     "typescript": "^5.4.3",
     "vitest": "^1.4.0",
-    "@humeai/typescript-config": "0.0.0",
-    "@humeai/eslint-config": "0.0.1"
+    "@humeai/eslint-config": "0.0.1",
+    "@humeai/typescript-config": "0.0.0"
   },
   "dependencies": {
     "zod": "^3.22.4",
-    "@humeai/voice": "0.0.0-beta.21"
+    "@humeai/voice": "0.0.0-beta.23"
   },
   "browserslist": [
     "last 2 Chrome versions, last 2 iOS major versions, Firefox ESR, not dead"