Picovoice · ErisMik · Nov 29, 2025
diff --git a/.github/workflows/react-codestyle.yml b/.github/workflows/react-codestyle.yml
@@ -31,9 +31,6 @@ jobs:
       with:
         node-version: lts/*
 
-    - name: Pre-build dependencies
-      run: npm install yarn
-
     - name: Run Binding Linter
       run: yarn && yarn lint
       working-directory: binding/react

diff --git a/.github/workflows/react-demos.yml b/.github/workflows/react-demos.yml
@@ -26,7 +26,7 @@ jobs:
     strategy:
       matrix:
         os: [ ubuntu-latest, windows-latest, macos-latest ]
-        node-version: [ 16.x, 18.x, 20.x ]
+        node-version: [ 18.x, 20.x, 22.x, 24.x ]
 
     steps:
     - uses: actions/checkout@v3
@@ -36,8 +36,15 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
 
-    - name: Pre-build dependencies
-      run: npm install yarn
+# ************** REMOVE AFTER RELEASE ********************
+    - name: Build Web SDK
+      run: yarn install && yarn copywasm && yarn copyppn && yarn build
+      working-directory: binding/web
+
+    - name: Install dependencies
+      run: yarn install && yarn build
+      working-directory: binding/react
+# ************** REMOVE AFTER RELEASE ********************
 
     - name: Install dependencies
       run: yarn install

diff --git a/.github/workflows/react.yml b/.github/workflows/react.yml
@@ -29,7 +29,8 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [16.x, 18.x, 20.x]
+        device: [ cpu:1, cpu ]
+        node-version: [ 18.x, 20.x, 22.x, 24.x ]
 
     steps:
     - uses: actions/checkout@v3
@@ -39,8 +40,11 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
 
-    - name: Pre-build dependencies
-      run: npm install yarn
+# ************** REMOVE AFTER RELEASE ********************
+    - name: Build Web SDK
+      run: yarn install && yarn copywasm && yarn copyppn && yarn build
+      working-directory: binding/web
+# ************** REMOVE AFTER RELEASE ********************
 
     - name: Install dependencies
       run: yarn install
@@ -55,4 +59,4 @@ jobs:
       run: yarn setup-test
 
     - name: Run test
-      run: yarn test --env ACCESS_KEY=${{secrets.PV_VALID_ACCESS_KEY}}
+      run: yarn test --env ACCESS_KEY=${{secrets.PV_VALID_ACCESS_KEY}},DEVICE=${{ matrix.device }}
diff --git a/.github/workflows/web-codestyle.yml b/.github/workflows/web-codestyle.yml
@@ -5,14 +5,14 @@ on:
   push:
     branches: [ master ]
     paths:
-      - '**/web/*.js'
-      - '**/web/*.ts'
+      - 'binding/web/*.js'
+      - 'binding/web/*.ts'
       - '.github/workflows/web-codestyle.yml'
   pull_request:
     branches: [ master, 'v[0-9]+.[0-9]+' ]
     paths:
-      - '**/web/*.js'
-      - '**/web/*.ts'
+      - 'binding/web/*.js'
+      - 'binding/web/*.ts'
       - '.github/workflows/web-codestyle.yml'
 
 jobs:
@@ -27,9 +27,6 @@ jobs:
         with:
           node-version: lts/*
 
-      - name: Pre-build dependencies
-        run: npm install yarn
-
       - name: Run Binding Linter
         run: yarn && yarn lint
         working-directory: binding/web
diff --git a/.github/workflows/web-demos.yml b/.github/workflows/web-demos.yml
@@ -25,7 +25,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [18.x, 20.x, 22.x]
+        node-version: [18.x, 20.x, 22.x, 24.x]
 
     steps:
     - uses: actions/checkout@v3
@@ -35,8 +35,11 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
 
-    - name: Pre-build dependencies
-      run: npm install yarn
+# ************** REMOVE AFTER RELEASE ********************
+    - name: Build Web SDK
+      run: yarn install && yarn copywasm && yarn copyppn && yarn build
+      working-directory: binding/web
+# ************** REMOVE AFTER RELEASE ********************
 
     - name: Install dependencies
       run: yarn install
diff --git a/.github/workflows/web-perf.yml b/.github/workflows/web-perf.yml
@@ -39,9 +39,6 @@ jobs:
         with:
           node-version: ${{ matrix.node-version }}
 
-      - name: Pre-build dependencies
-        run: npm install yarn
-
       - name: Install dependencies
         run: yarn install
 
@@ -55,4 +52,4 @@ jobs:
         run: yarn setup-test
 
       - name: Test
-        run: yarn test-perf --env ACCESS_KEY=${{secrets.PV_VALID_ACCESS_KEY}},NUM_TEST_ITERATIONS=20,INIT_PERFORMANCE_THRESHOLD_SEC=${{matrix.initPerformanceThresholdSec}},PROC_PERFORMANCE_THRESHOLD_SEC=${{matrix.procPerformanceThresholdSec}}
+        run: yarn test-perf --env ACCESS_KEY=${{secrets.PV_VALID_ACCESS_KEY}},DEVICE=cpu:1,NUM_TEST_ITERATIONS=20,INIT_PERFORMANCE_THRESHOLD_SEC=${{matrix.initPerformanceThresholdSec}},PROC_PERFORMANCE_THRESHOLD_SEC=${{matrix.procPerformanceThresholdSec}}
diff --git a/.github/workflows/web.yml b/.github/workflows/web.yml
@@ -35,7 +35,8 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [16.x, 18.x, 20.x]
+        device: [ cpu:1, cpu ]
+        node-version: [18.x, 20.x, 22.x, 24.x]
 
     steps:
       - uses: actions/checkout@v3
@@ -45,9 +46,6 @@ jobs:
         with:
           node-version: ${{ matrix.node-version }}
 
-      - name: Pre-build dependencies
-        run: npm install yarn
-
       - name: Install dependencies
         run: yarn install
 
@@ -61,4 +59,4 @@ jobs:
         run: yarn setup-test
 
       - name: Test
-        run: yarn test --env ACCESS_KEY=${{secrets.PV_VALID_ACCESS_KEY}}
+        run: yarn test --env ACCESS_KEY=${{secrets.PV_VALID_ACCESS_KEY}},DEVICE=${{ matrix.device }}
diff --git a/binding/react/package.json b/binding/react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@picovoice/rhino-react",
-  "version": "3.0.3",
+  "version": "4.0.0",
   "description": "React component for Rhino Web SDK",
   "entry": "src/index.ts",
   "module": "dist/esm/index.js",
@@ -73,6 +73,6 @@
     "react-dom": ">=17"
   },
   "dependencies": {
-    "@picovoice/rhino-web": "=3.0.3"
+    "@picovoice/rhino-web": "file:../web"
   }
 }
diff --git a/binding/react/test/use_rhino.test.ts b/binding/react/test/use_rhino.test.ts
@@ -7,6 +7,7 @@ import rhinoParams from '@/rhino_params.js';
 import testData from './test_data.json';
 
 const ACCESS_KEY = Cypress.env('ACCESS_KEY');
+const DEVICE = Cypress.env('DEVICE');
 
 describe('Rhino binding', () => {
   it('should be able to init via public path', () => {
@@ -16,7 +17,8 @@ describe('Rhino binding', () => {
       () => result.current.init(
         ACCESS_KEY,
         { publicPath: "/test/contexts/coffee_maker_wasm.rhn", forceWrite: true },
-        { publicPath: "/test/rhino_params.pv", forceWrite: true }
+        { publicPath: "/test/rhino_params.pv", forceWrite: true },
+        { device: DEVICE }
       )
     ).then(() => {
       expect(result.current.isLoaded).to.be.true;
@@ -36,7 +38,8 @@ describe('Rhino binding', () => {
       () => result.current.init(
         ACCESS_KEY,
         { publicPath: "/test/contexts/coffee_maker_wasm.rhn", forceWrite: true },
-        { base64: rhinoParams, forceWrite: true }
+        { base64: rhinoParams, forceWrite: true },
+        { device: DEVICE }
       )
     ).then(() => {
       expect(result.current.isLoaded).to.be.true;
@@ -50,7 +53,8 @@ describe('Rhino binding', () => {
       () => result.current.init(
         ACCESS_KEY,
         { publicPath: "/test/contexts/coffee_maker_wasm.rhn", forceWrite: true },
-        { publicPath: "/rhino_params_failed.pv", forceWrite: true }
+        { publicPath: "/rhino_params_failed.pv", forceWrite: true },
+        { device: DEVICE }
       )
     ).then(() => {
       expect(result.current.isLoaded).to.be.false;
@@ -65,7 +69,8 @@ describe('Rhino binding', () => {
       () => result.current.init(
         '',
         { publicPath: "/test/contexts/coffee_maker_wasm.rhn", forceWrite: true },
-        { publicPath: "/test/rhino_params.pv", forceWrite: true }
+        { publicPath: "/test/rhino_params.pv", forceWrite: true },
+        { device: DEVICE }
       )
     ).then(() => {
       expect(result.current.isLoaded).to.be.false;
@@ -87,7 +92,8 @@ describe('Rhino binding', () => {
           {
             publicPath: testInfo.language === 'en' ? "/test/rhino_params.pv" : `/test/rhino_params_${testInfo.language}.pv`,
             forceWrite: true,
-          }
+          },
+          { device: DEVICE }
         )
       ).then(() => {
         expect(result.current.isLoaded).to.be.true;
@@ -124,7 +130,8 @@ describe('Rhino binding', () => {
           {
             publicPath: testInfo.language === 'en' ? "/test/rhino_params.pv" : `/test/rhino_params_${testInfo.language}.pv`,
             forceWrite: true,
-          }
+          },
+          { device: DEVICE }
         )
       ).then(() => {
         expect(result.current.isLoaded).to.be.true;

diff --git a/binding/web/.gitignore b/binding/web/.gitignore
@@ -1,6 +1,6 @@
 node_modules
 dist
-lib/pv_rhino*.wasm
+src/lib/*
 src/rhino_64.ts
 contexts/*.rhn
 test/contexts/*.rhn

diff --git a/binding/web/README.md b/binding/web/README.md
@@ -35,11 +35,28 @@ Rhino is:
 - Firefox
 - Safari
 
+## Requirements
+
+The Eagle Web Binding uses [SharedArrayBuffer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer).
+
+Include the following headers in the response to enable the use of `SharedArrayBuffers`:
+
+```
+Cross-Origin-Opener-Policy: same-origin
+Cross-Origin-Embedder-Policy: require-corp
+```
+
+Refer to our [Web demo](../../demo/web) for an example on creating a server with the corresponding response headers.
+
+Browsers that don't support `SharedArrayBuffers` or applications that don't include the required headers will fall back to using standard `ArrayBuffers`. This will disable multithreaded processing.
+
 ### Restrictions
 
 IndexedDB is required to use `Rhino` in a worker thread. Browsers without IndexedDB support
 (i.e. Firefox Incognito Mode) should use `Rhino` in the main thread.
 
+Multi-threading is only enabled for Rhino when using on a web worker.
+
 ## Installation
 
 ### Package

diff --git a/binding/web/cypress.config.ts b/binding/web/cypress.config.ts
@@ -7,10 +7,18 @@
     "PROC_PERFORMANCE_THRESHOLD_SEC": 1.2
   },
   e2e: {
-    defaultCommandTimeout: 30000,
     supportFile: "cypress/support/index.ts",
     specPattern: "test/*.test.{js,jsx,ts,tsx}",
     video: false,
     screenshotOnRunFailure: false,
+    defaultCommandTimeout: 30000,
+    setupNodeEvents(on, config) {
+      on('before:browser:launch', (browser, launchOptions) => {
+        if (browser.name === 'chrome') {
+          launchOptions.args.push('--enable-features=SharedArrayBuffer');
+        }
+        return launchOptions;
+      });
+    },
   },
 });
diff --git a/binding/web/cypress/tsconfig.json b/binding/web/cypress/tsconfig.json
@@ -1,7 +1,7 @@
 {
   "extends": "../tsconfig.json",
   "compilerOptions": {
-    "types": ["cypress"]
+    "types": ["cypress", "node"]
   },
   "include": [
     "../test/**/*.ts",

diff --git a/binding/web/module.d.ts b/binding/web/module.d.ts
@@ -8,6 +8,11 @@ declare module "*.rhn" {
   export default content;
 }
 
+declare module "*.txt" {
+  const content: string;
+  export default content;
+}
+
 declare module 'web-worker:*' {
   const WorkerFactory: new () => Worker;
   export default WorkerFactory;

diff --git a/binding/web/package.json b/binding/web/package.json
@@ -3,7 +3,7 @@
   "description": "Rhino Speech-to-Intent engine for web browsers (via WebAssembly)",
   "author": "Picovoice Inc",
   "license": "Apache-2.0",
-  "version": "3.0.3",
+  "version": "4.0.0",
   "keywords": [
     "rhino",
     "web",
@@ -29,11 +29,11 @@
     "format": "prettier --write \"**/*.{js,ts,json}\"",
     "copywasm": "node scripts/copy_wasm.js",
     "setup-test": "node scripts/setup_test.js && npx pvbase64 -i ./test/rhino_params.pv -o ./test/rhino_params.js",
-    "test": "cypress run --spec test/rhino.test.ts",
-    "test-perf": "cypress run --spec test/rhino_perf.test.ts"
+    "test": "cypress run --spec test/rhino.test.ts --browser chrome",
+    "test-perf": "cypress run --spec test/rhino_perf.test.ts --browser chrome"
   },
   "dependencies": {
-    "@picovoice/web-utils": "=1.3.1"
+    "@picovoice/web-utils": "=1.4.3"
   },
   "devDependencies": {
     "@babel/core": "^7.21.3",
@@ -45,6 +45,8 @@
     "@rollup/plugin-node-resolve": "^15.0.1",
     "@rollup/plugin-terser": "^0.4.0",
     "@rollup/pluginutils": "^5.0.2",
+    "@types/emscripten": "1.40.0",
+    "@types/node": "^18.13.0",
     "@typescript-eslint/eslint-plugin": "^5.51.0",
     "@typescript-eslint/parser": "^5.51.0",
     "async-mutex": "^0.4.0",
@@ -62,6 +64,6 @@
     "wasm-feature-detect": "^1.5.0"
   },
   "engines": {
-    "node": ">=16"
+    "node": ">=18"
   }
 }
diff --git a/binding/web/rollup.config.js b/binding/web/rollup.config.js
@@ -69,7 +69,7 @@ export default {
       exclude: '**/node_modules/**',
     }),
     base64({
-      include: ['./lib/**/*.wasm'],
+      include: ['./src/lib/*.wasm', './src/lib/*.txt'],
     }),
   ],
 };