@voxket-ai/voxket-live 1.0.46 → 1.0.49

package/CONSUMER_SETUP.md

@@ -0,0 +1,82 @@
+# Consumer App Setup Guide
+
+If you're experiencing the "Cannot read properties of undefined (reading 'ReactCurrentDispatcher')" error, follow these steps:
+
+## Step 1: Ensure React Version Compatibility
+
+Make sure your consumer app uses React 18.3.x or compatible:
+
+```json
+{
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  }
+}
+```
+
+## Step 2: Clean Install
+
+```bash
+rm -rf node_modules package-lock.json
+npm install
+```
+
+## Step 3: Next.js Configuration (if using Next.js)
+
+Add this to your `next.config.js`:
+
+```javascript
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  experimental: {
+    esmExternals: false
+  },
+  webpack: (config, { isServer }) => {
+    if (!isServer) {
+      config.resolve.fallback = {
+        ...config.resolve.fallback,
+        fs: false,
+        net: false,
+        tls: false,
+      };
+    }
+    
+    // Ensure React is resolved to the same instance
+    config.resolve.alias = {
+      ...config.resolve.alias,
+      'react': require.resolve('react'),
+      'react-dom': require.resolve('react-dom'),
+    };
+    
+    return config;
+  },
+};
+
+module.exports = nextConfig;
+```
+
+## Step 4: Usage
+
+```tsx
+'use client'; // For Next.js app router
+
+import React from 'react';
+import { VoxketClient } from '@voxket-ai/voxket-live';
+
+function MyComponent() {
+  return (
+    <VoxketClient 
+      config={{
+        // your config
+      }}
+    />
+  );
+}
+```
+
+## Troubleshooting
+
+1. **Clear cache**: `rm -rf .next` (for Next.js) or equivalent for your bundler
+2. **Check React versions**: Ensure all React-related packages use the same version
+3. **Bundle analyzer**: Use webpack-bundle-analyzer to check for duplicate React instances

package/README.md

@@ -22,11 +22,13 @@ or
 yarn add @voxket-ai/voxket-live
 ```
 
-The package is currently published at version `1.0.13`. For the latest version, you can use:
+The package is currently published at version `1.0.49`. For the latest version, you can use:
 ```bash
 npm install @voxket-ai/voxket-live@latest
 ```
 
+⚠️ **Troubleshooting**: If you encounter React-related errors, please see [CONSUMER_SETUP.md](./CONSUMER_SETUP.md) for detailed setup instructions.
+
 ## Usage
 
 To use the Voxket Live widget in your React application, simply import and use the component. **No separate CSS import is required** - styles are automatically included: