v2.0 (#49)

.github/workflows/link-check.yml

@@ -3,9 +3,9 @@ name: Check Markdown links
 on:
   workflow_dispatch:
   push:
-    branches: [main]
+    branches: [ main ]
   pull_request:
-    branches: [main, 'v[0-9]+.[0-9]+']
+    branches: [ main, 'v[0-9]+.[0-9]+' ]
 
 jobs:
   markdown-link-check:

.github/workflows/python-codestyle.yml

@@ -3,11 +3,11 @@ name: Python Codestyle
 on:
   workflow_dispatch:
   push:
-    branches: [main]
+    branches: [ main ]
     paths:
       - '**/*.py'
   pull_request:
-    branches: [main, 'v[0-9]+.[0-9]+']
+    branches: [ main, 'v[0-9]+.[0-9]+' ]
     paths:
       - '**/*.py'
 

.github/workflows/python-demos.yml

@@ -3,14 +3,14 @@ name: Python Demos
 on:
   workflow_dispatch:
   push:
-    branches: [main]
+    branches: [ main ]
     paths:
       - '.github/workflows/python-demos.yml'
       - 'demo/python/**'
       - '!demo/python/README.md'
       - 'resources/audio_samples/test.wav'
   pull_request:
-    branches: [main, 'v[0-9]+.[0-9]+']
+    branches: [ main, 'v[0-9]+.[0-9]+' ]
     paths:
       - '.github/workflows/python-demos.yml'
       - 'demo/python/**'

.github/workflows/python-perf.yml

@@ -3,7 +3,7 @@ name: Python Performance
 on:
   workflow_dispatch:
   push:
-    branches: [main]
+    branches: [ main ]
     paths:
       - '.github/workflows/python-perf.yml'
       - 'binding/python/__init__.py'
@@ -18,7 +18,7 @@ on:
       - 'lib/windows/**'
       - 'resources/audio_samples/test.wav'
   pull_request:
-    branches: [main, 'v[0-9]+.[0-9]+']
+    branches: [ main, 'v[0-9]+.[0-9]+' ]
     paths:
       - '.github/workflows/python-perf.yml'
       - 'binding/python/__init__.py'

.github/workflows/python.yml

@@ -3,7 +3,7 @@ name: Python
 on:
   workflow_dispatch:
   push:
-    branches: [main]
+    branches: [ main ]
     paths:
       - '.github/workflows/python.yml'
       - 'binding/python/**'
@@ -17,7 +17,7 @@ on:
       - 'resources/audio_samples/noise.wav'
       - 'resources/audio_samples/test.wav'
   pull_request:
-    branches: [main, 'v[0-9]+.[0-9]+']
+    branches: [ main, 'v[0-9]+.[0-9]+' ]
     paths:
       - '.github/workflows/python.yml'
       - 'binding/python/**'

.github/workflows/spell-check.yml

@@ -3,9 +3,9 @@ name: SpellCheck
 on:
   workflow_dispatch:
   push:
-    branches: [main]
+    branches: [ main ]
   pull_request:
-    branches: [main, 'v[0-9]+.[0-9]+']
+    branches: [ main, 'v[0-9]+.[0-9]+' ]
 
 jobs:
   spellcheck:

.github/workflows/web-demos.yml

@@ -25,7 +25,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [14.x, 16.x, 18.x, 20.x]
+        node-version: [16.x, 18.x, 20.x]
 
     steps:
     - uses: actions/checkout@v3
@@ -35,6 +35,10 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
 
+    - name: Build Web SDK
+      run: yarn && yarn copywasm && yarn build
+      working-directory: binding/web
+
     - name: Pre-build dependencies
       run: npm install yarn
 

.github/workflows/web-perf.yml

@@ -58,4 +58,4 @@ jobs:
         run: yarn setup-test
 
       - name: Test
-        run: yarn test-perf --env ACCESS_KEY=${{secrets.PV_VALID_ACCESS_KEY}},NUM_TEST_ITERATIONS=20,PROC_PERFORMANCE_THRESHOLD_SEC=0.8
+        run: yarn test-perf --env ACCESS_KEY=${{secrets.PV_VALID_ACCESS_KEY}},NUM_TEST_ITERATIONS=15,PROC_PERFORMANCE_THRESHOLD_SEC=${{ matrix.procPerformanceThresholdSec }}

.github/workflows/web.yml

@@ -31,7 +31,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [14.x, 16.x, 18.x, 20.x]
+        node-version: [16.x, 18.x, 20.x]
 
     steps:
       - uses: actions/checkout@v3

README.md

@@ -314,6 +314,14 @@ Replace `${ACCESS_KEY}` with yours obtained from [Picovoice Console](https://con
 
 ## Releases
 
-### v1.0.0 February 7th, 2023
+### v2.0.0 - November 24th, 2023
 
-- Initial release.
+- Improvements to error reporting
+- Upgrades to authorization and authentication system
+- Various bug fixes and improvements
+- Web min support bumped to Node 16
+- iOS support bumped to iOS 13
+
+### v1.0.0 - February 7th, 2023
+
+- Initial release

binding/android/Koala/koala/build.gradle

@@ -2,7 +2,7 @@ apply plugin: 'com.android.library'
 
 ext {
     PUBLISH_GROUP_ID = 'ai.picovoice'
-    PUBLISH_VERSION = '1.0.0'
+    PUBLISH_VERSION = '2.0.0'
     PUBLISH_ARTIFACT_ID = 'koala-android'
 }
 
@@ -40,12 +40,12 @@ dependencies {
 }
 
 task copyLibs(type: Copy) {
-    from("${rootDir}/../../lib/android")
+    from("${rootDir}/../../../lib/android")
     into("${rootDir}/koala/src/main/jniLibs")
 }
 
 task copyParams(type: Copy) {
-    from("${rootDir}/../../lib/common")
+    from("${rootDir}/../../../lib/common")
     into("${rootDir}/koala/src/main/res/raw")
 }
 

binding/android/Koala/koala/src/main/java/ai/picovoice/koala/Koala.java

@@ -27,13 +27,18 @@
 public class Koala {
 
     private static String defaultModelPath;
+    private static String _sdk = "android";
 
     static {
         System.loadLibrary("pv_koala");
     }
 
     private long handle;
 
+    public static void setSdk(String sdk) {
+        Koala._sdk = sdk;
+    }
+
     /**
      * Constructor.
      *
@@ -43,6 +48,7 @@ public class Koala {
      * @throws KoalaException if there is an error while initializing Koala.
      */
     private Koala(String accessKey, String modelPath) throws KoalaException {
+        KoalaNative.setSdk(Koala._sdk);
         handle = KoalaNative.init(accessKey, modelPath);
     }
 

binding/android/Koala/koala/src/main/java/ai/picovoice/koala/KoalaNative.java

@@ -14,12 +14,14 @@
 
 class KoalaNative {
 
-    static native int getSampleRate();
-
     static native String getVersion();
 
     static native int getFrameLength();
 
+    static native int getSampleRate();
+
+    static native void setSdk(String sdk);
+
     static native long init(String accessKey, String modelPath) throws KoalaException;
 
     static native void delete(long object);

binding/android/Koala/koala/src/main/java/ai/picovoice/koala/exception/KoalaActivationException.java

@@ -1,7 +1,9 @@
 /*
     Copyright 2023 Picovoice Inc.
+
     You may not use this file except in compliance with the license. A copy of the license is
     located in the "LICENSE" file accompanying this source.
+
     Unless required by applicable law or agreed to in writing, software distributed under the
     License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
     express or implied. See the License for the specific language governing permissions and
@@ -18,5 +20,8 @@ public KoalaActivationException(Throwable cause) {
     public KoalaActivationException(String message) {
         super(message);
     }
-}
 
+    public KoalaActivationException(String message, String[] messageStack) {
+        super(message, messageStack);
+    }
+}

binding/android/Koala/koala/src/main/java/ai/picovoice/koala/exception/KoalaActivationLimitException.java

@@ -1,7 +1,9 @@
 /*
     Copyright 2023 Picovoice Inc.
+
     You may not use this file except in compliance with the license. A copy of the license is
     located in the "LICENSE" file accompanying this source.
+
     Unless required by applicable law or agreed to in writing, software distributed under the
     License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
     express or implied. See the License for the specific language governing permissions and
@@ -18,5 +20,8 @@ public KoalaActivationLimitException(Throwable cause) {
     public KoalaActivationLimitException(String message) {
         super(message);
     }
-}
 
+    public KoalaActivationLimitException(String message, String[] messageStack) {
+        super(message, messageStack);
+    }
+}

binding/android/Koala/koala/src/main/java/ai/picovoice/koala/exception/KoalaActivationRefusedException.java

@@ -1,7 +1,9 @@
 /*
     Copyright 2023 Picovoice Inc.
+
     You may not use this file except in compliance with the license. A copy of the license is
     located in the "LICENSE" file accompanying this source.
+
     Unless required by applicable law or agreed to in writing, software distributed under the
     License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
     express or implied. See the License for the specific language governing permissions and
@@ -18,5 +20,8 @@ public KoalaActivationRefusedException(Throwable cause) {
     public KoalaActivationRefusedException(String message) {
         super(message);
     }
-}
 
+    public KoalaActivationRefusedException(String message, String[] messageStack) {
+        super(message, messageStack);
+    }
+}

binding/android/Koala/koala/src/main/java/ai/picovoice/koala/exception/KoalaActivationThrottledException.java

@@ -1,7 +1,9 @@
 /*
     Copyright 2023 Picovoice Inc.
+
     You may not use this file except in compliance with the license. A copy of the license is
     located in the "LICENSE" file accompanying this source.
+
     Unless required by applicable law or agreed to in writing, software distributed under the
     License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
     express or implied. See the License for the specific language governing permissions and
@@ -18,5 +20,8 @@ public KoalaActivationThrottledException(Throwable cause) {
     public KoalaActivationThrottledException(String message) {
         super(message);
     }
-}
 
+    public KoalaActivationThrottledException(String message, String[] messageStack) {
+        super(message, messageStack);
+    }
+}

binding/android/Koala/koala/src/main/java/ai/picovoice/koala/exception/KoalaException.java

@@ -1,7 +1,9 @@
 /*
     Copyright 2023 Picovoice Inc.
+
     You may not use this file except in compliance with the license. A copy of the license is
     located in the "LICENSE" file accompanying this source.
+
     Unless required by applicable law or agreed to in writing, software distributed under the
     License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
     express or implied. See the License for the specific language governing permissions and
@@ -11,12 +13,42 @@
 package ai.picovoice.koala;
 
 public class KoalaException extends Exception {
+    private final String message;
+    private final String[] messageStack;
+
     public KoalaException(Throwable cause) {
         super(cause);
+        this.message = cause.getMessage();
+        this.messageStack = null;
     }
 
     public KoalaException(String message) {
         super(message);
+        this.message = message;
+        this.messageStack = null;
     }
-}
 
+    public KoalaException(String message, String[] messageStack) {
+        super(message);
+        this.message = message;
+        this.messageStack = messageStack;
+    }
+
+    public String[] getMessageStack() {
+        return this.messageStack;
+    }
+
+    @Override
+    public String getMessage() {
+        StringBuilder sb = new StringBuilder(message);
+        if (messageStack != null) {
+            if (messageStack.length > 0) {
+                sb.append(":");
+                for (int i = 0; i < messageStack.length; i++) {
+                    sb.append(String.format("\n  [%d] %s", i, messageStack[i]));
+                }
+            }
+        }
+        return sb.toString();
+    }
+}

binding/android/Koala/koala/src/main/java/ai/picovoice/koala/exception/KoalaIOException.java

@@ -1,7 +1,9 @@
 /*
     Copyright 2023 Picovoice Inc.
+
     You may not use this file except in compliance with the license. A copy of the license is
     located in the "LICENSE" file accompanying this source.
+
     Unless required by applicable law or agreed to in writing, software distributed under the
     License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
     express or implied. See the License for the specific language governing permissions and
@@ -18,5 +20,8 @@ public KoalaIOException(Throwable cause) {
     public KoalaIOException(String message) {
         super(message);
     }
-}
 
+    public KoalaIOException(String message, String[] messageStack) {
+        super(message, messageStack);
+    }
+}

binding/android/Koala/koala/src/main/java/ai/picovoice/koala/exception/KoalaInvalidArgumentException.java

@@ -1,7 +1,9 @@
 /*
     Copyright 2023 Picovoice Inc.
+
     You may not use this file except in compliance with the license. A copy of the license is
     located in the "LICENSE" file accompanying this source.
+
     Unless required by applicable law or agreed to in writing, software distributed under the
     License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
     express or implied. See the License for the specific language governing permissions and
@@ -18,5 +20,8 @@ public KoalaInvalidArgumentException(Throwable cause) {
     public KoalaInvalidArgumentException(String message) {
         super(message);
     }
-}
 
+    public KoalaInvalidArgumentException(String message, String[] messageStack) {
+        super(message, messageStack);
+    }
+}