@capgo/capacitor-speech-recognition 7.0.1 → 7.2.0

package/README.md

@@ -73,6 +73,7 @@ Add the following keys to your app `Info.plist`:
 * [`isListening()`](#islistening)
 * [`checkPermissions()`](#checkpermissions)
 * [`requestPermissions()`](#requestpermissions)
+* [`getPluginVersion()`](#getpluginversion)
 * [`addListener('endOfSegmentedSession', ...)`](#addlistenerendofsegmentedsession-)
 * [`addListener('segmentResults', ...)`](#addlistenersegmentresults-)
 * [`addListener('partialResults', ...)`](#addlistenerpartialresults-)
@@ -184,6 +185,21 @@ Requests the microphone + speech recognition permissions.
 --------------------
 
 
+### getPluginVersion()
+
+```typescript
+getPluginVersion() => Promise<{ version: string; }>
+```
+
+Returns the native plugin version bundled with this package.
+
+Useful when reporting issues to confirm that native and JS versions match.
+
+**Returns:** <code>Promise&lt;{ version: string; }&gt;</code>
+
+--------------------
+
+
 ### addListener('endOfSegmentedSession', ...)
 
 ```typescript

package/android/src/main/java/app/capgo/speechrecognition/Receiver.java

@@ -11,6 +11,7 @@ import com.getcapacitor.PluginCall;
 import java.util.List;
 
 public class Receiver extends BroadcastReceiver implements Constants {
+
     private List<String> supportedLanguagesList;
     private String languagePref;
     private final PluginCall call;

package/android/src/main/java/app/capgo/speechrecognition/SpeechRecognitionPlugin.java

@@ -34,6 +34,7 @@ public class SpeechRecognitionPlugin extends Plugin implements Constants {
 
     public static final String SPEECH_RECOGNITION = "speechRecognition";
     private static final String TAG = "SpeechRecognition";
+    private static final String PLUGIN_VERSION = "7.0.0";
 
     private Receiver languageReceiver;
     private SpeechRecognizer speechRecognizer;
@@ -63,11 +64,13 @@ public class SpeechRecognitionPlugin extends Plugin implements Constants {
     @PluginMethod
     public void start(PluginCall call) {
         if (!SpeechRecognizer.isRecognitionAvailable(bridge.getContext())) {
+            Logger.warn(TAG, "start() called but speech recognizer unavailable");
             call.unavailable(NOT_AVAILABLE);
             return;
         }
 
         if (getPermissionState(SPEECH_RECOGNITION) != PermissionState.GRANTED) {
+            Logger.warn(TAG, "start() missing RECORD_AUDIO permission");
             call.reject(MISSING_PERMISSION);
             return;
         }
@@ -78,11 +81,23 @@ public class SpeechRecognitionPlugin extends Plugin implements Constants {
         boolean partialResults = call.getBoolean("partialResults", false);
         boolean popup = call.getBoolean("popup", false);
         int allowForSilence = call.getInt("allowForSilence", 0);
+        Logger.info(
+            TAG,
+            String.format(
+                "Starting recognition | lang=%s maxResults=%d partial=%s popup=%s allowForSilence=%d",
+                language,
+                maxResults,
+                partialResults,
+                popup,
+                allowForSilence
+            )
+        );
         beginListening(language, maxResults, prompt, partialResults, popup, call, allowForSilence);
     }
 
     @PluginMethod
     public void stop(final PluginCall call) {
+        Logger.info(TAG, "stop() requested");
         try {
             stopListening();
         } catch (Exception ex) {
@@ -130,6 +145,13 @@ public class SpeechRecognitionPlugin extends Plugin implements Constants {
         requestPermissionForAlias(SPEECH_RECOGNITION, call, "permissionsCallback");
     }
 
+    @PluginMethod
+    public void getPluginVersion(PluginCall call) {
+        JSObject ret = new JSObject();
+        ret.put("version", PLUGIN_VERSION);
+        call.resolve(ret);
+    }
+
     @PermissionCallback
     private void permissionsCallback(PluginCall call) {
         String state = permissionStateValue(getPermissionState(SPEECH_RECOGNITION));
@@ -229,6 +251,7 @@ public class SpeechRecognitionPlugin extends Plugin implements Constants {
                 try {
                     lock.lock();
                     if (listening) {
+                        Logger.debug(TAG, "Stopping inline recognizer");
                         speechRecognizer.stopListening();
                         listening(false);
                     }
@@ -280,6 +303,7 @@ public class SpeechRecognitionPlugin extends Plugin implements Constants {
                 JSObject ret = new JSObject();
                 ret.put("status", "started");
                 notifyListeners(LISTENING_EVENT, ret);
+                Logger.debug(TAG, "Listening started");
             } finally {
                 lock.unlock();
             }
@@ -313,6 +337,7 @@ public class SpeechRecognitionPlugin extends Plugin implements Constants {
         public void onError(int error) {
             stopListening();
             String errorMssg = getErrorText(error);
+            Logger.error(TAG, "Recognizer error: " + errorMssg, null);
 
             if (call != null) {
                 call.reject(errorMssg);
@@ -325,6 +350,7 @@ public class SpeechRecognitionPlugin extends Plugin implements Constants {
 
             try {
                 JSArray jsArray = new JSArray(matches);
+                Logger.debug(TAG, "Received final results count=" + (matches == null ? 0 : matches.size()));
 
                 if (call != null) {
                     if (!partialResults) {
@@ -353,6 +379,7 @@ public class SpeechRecognitionPlugin extends Plugin implements Constants {
                     JSObject ret = new JSObject();
                     ret.put("matches", previousPartialResults);
                     notifyListeners(PARTIAL_RESULTS_EVENT, ret);
+                    Logger.debug(TAG, "Partial results updated");
                 }
             } catch (Exception ex) {}
         }
@@ -367,12 +394,14 @@ public class SpeechRecognitionPlugin extends Plugin implements Constants {
                 JSObject ret = new JSObject();
                 ret.put("matches", new JSArray(matches));
                 notifyListeners(SEGMENT_RESULTS_EVENT, ret);
+                Logger.debug(TAG, "Segment results emitted");
             } catch (Exception ignored) {}
         }
 
         @Override
         public void onEndOfSegmentedSession() {
             notifyListeners(END_OF_SEGMENT_EVENT, new JSObject());
+            Logger.debug(TAG, "Segmented session ended");
         }
 
         @Override

package/dist/docs.json

@@ -94,6 +94,16 @@
         ],
         "slug": "requestpermissions"
       },
+      {
+        "name": "getPluginVersion",
+        "signature": "() => Promise<{ version: string; }>",
+        "parameters": [],
+        "returns": "Promise<{ version: string; }>",
+        "tags": [],
+        "docs": "Returns the native plugin version bundled with this package.\n\nUseful when reporting issues to confirm that native and JS versions match.",
+        "complexTypes": [],
+        "slug": "getpluginversion"
+      },
       {
         "name": "addListener",
         "signature": "(eventName: 'endOfSegmentedSession', listenerFunc: () => void) => Promise<PluginListenerHandle>",

package/dist/esm/definitions.d.ts

@@ -107,6 +107,14 @@ export interface SpeechRecognitionPlugin {
      * Requests the microphone + speech recognition permissions.
      */
     requestPermissions(): Promise<SpeechRecognitionPermissionStatus>;
+    /**
+     * Returns the native plugin version bundled with this package.
+     *
+     * Useful when reporting issues to confirm that native and JS versions match.
+     */
+    getPluginVersion(): Promise<{
+        version: string;
+    }>;
     /**
      * Listen for segmented session completion events (Android only).
      */

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Permission map returned by `checkPermissions` and `requestPermissions`.\n *\n * On Android the state maps to the `RECORD_AUDIO` permission.\n * On iOS it combines speech recognition plus microphone permission.\n */\nexport interface SpeechRecognitionPermissionStatus {\n  speechRecognition: PermissionState;\n}\n\n/**\n * Configure how the recognizer behaves when calling {@link SpeechRecognitionPlugin.start}.\n */\nexport interface SpeechRecognitionStartOptions {\n  /**\n   * Locale identifier such as `en-US`. When omitted the device language is used.\n   */\n  language?: string;\n  /**\n   * Maximum number of final matches returned by native APIs. Defaults to `5`.\n   */\n  maxResults?: number;\n  /**\n   * Prompt message shown inside the Android system dialog (ignored on iOS).\n   */\n  prompt?: string;\n  /**\n   * When `true`, Android shows the OS speech dialog instead of running inline recognition.\n   * Defaults to `false`.\n   */\n  popup?: boolean;\n  /**\n   * Emits partial transcription updates through the `partialResults` listener while audio is captured.\n   */\n  partialResults?: boolean;\n  /**\n   * Enables native punctuation handling where supported (iOS 16+).\n   */\n  addPunctuation?: boolean;\n  /**\n   * Allow a number of milliseconds of silence before splitting the recognition session into segments.\n   * Required to be greater than zero and currently supported on Android only.\n   */\n  allowForSilence?: number;\n}\n\n/**\n * Raised whenever a partial transcription is produced.\n */\nexport interface SpeechRecognitionPartialResultEvent {\n  matches: string[];\n}\n\n/**\n * Raised whenever a segmented result is produced (Android only).\n */\nexport interface SpeechRecognitionSegmentResultEvent {\n  matches: string[];\n}\n\n/**\n * Raised when the listening state changes.\n */\nexport interface SpeechRecognitionListeningEvent {\n  status: 'started' | 'stopped';\n}\n\nexport interface SpeechRecognitionAvailability {\n  available: boolean;\n}\n\nexport interface SpeechRecognitionMatches {\n  matches?: string[];\n}\n\nexport interface SpeechRecognitionLanguages {\n  languages: string[];\n}\n\nexport interface SpeechRecognitionListening {\n  listening: boolean;\n}\n\nexport interface SpeechRecognitionPlugin {\n  /**\n   * Checks whether the native speech recognition service is usable on the current device.\n   */\n  available(): Promise<SpeechRecognitionAvailability>;\n  /**\n   * Begins capturing audio and transcribing speech.\n   *\n   * When `partialResults` is `true`, the returned promise resolves immediately and updates are\n   * streamed through the `partialResults` listener until {@link stop} is called.\n   */\n  start(options?: SpeechRecognitionStartOptions): Promise<SpeechRecognitionMatches>;\n  /**\n   * Stops listening and tears down native resources.\n   */\n  stop(): Promise<void>;\n  /**\n   * Gets the locales supported by the underlying recognizer.\n   *\n   * Android 13+ devices no longer expose this list; in that case `languages` is empty.\n   */\n  getSupportedLanguages(): Promise<SpeechRecognitionLanguages>;\n  /**\n   * Returns whether the plugin is actively listening for speech.\n   */\n  isListening(): Promise<SpeechRecognitionListening>;\n  /**\n   * Gets the current permission state.\n   */\n  checkPermissions(): Promise<SpeechRecognitionPermissionStatus>;\n  /**\n   * Requests the microphone + speech recognition permissions.\n   */\n  requestPermissions(): Promise<SpeechRecognitionPermissionStatus>;\n  /**\n   * Listen for segmented session completion events (Android only).\n   */\n  addListener(eventName: 'endOfSegmentedSession', listenerFunc: () => void): Promise<PluginListenerHandle>;\n  /**\n   * Listen for segmented recognition results (Android only).\n   */\n  addListener(\n    eventName: 'segmentResults',\n    listenerFunc: (event: SpeechRecognitionSegmentResultEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Listen for partial transcription updates emitted while `partialResults` is enabled.\n   */\n  addListener(\n    eventName: 'partialResults',\n    listenerFunc: (event: SpeechRecognitionPartialResultEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Listen for changes to the native listening state.\n   */\n  addListener(\n    eventName: 'listeningState',\n    listenerFunc: (event: SpeechRecognitionListeningEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Removes every registered listener.\n   */\n  removeAllListeners(): Promise<void>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Permission map returned by `checkPermissions` and `requestPermissions`.\n *\n * On Android the state maps to the `RECORD_AUDIO` permission.\n * On iOS it combines speech recognition plus microphone permission.\n */\nexport interface SpeechRecognitionPermissionStatus {\n  speechRecognition: PermissionState;\n}\n\n/**\n * Configure how the recognizer behaves when calling {@link SpeechRecognitionPlugin.start}.\n */\nexport interface SpeechRecognitionStartOptions {\n  /**\n   * Locale identifier such as `en-US`. When omitted the device language is used.\n   */\n  language?: string;\n  /**\n   * Maximum number of final matches returned by native APIs. Defaults to `5`.\n   */\n  maxResults?: number;\n  /**\n   * Prompt message shown inside the Android system dialog (ignored on iOS).\n   */\n  prompt?: string;\n  /**\n   * When `true`, Android shows the OS speech dialog instead of running inline recognition.\n   * Defaults to `false`.\n   */\n  popup?: boolean;\n  /**\n   * Emits partial transcription updates through the `partialResults` listener while audio is captured.\n   */\n  partialResults?: boolean;\n  /**\n   * Enables native punctuation handling where supported (iOS 16+).\n   */\n  addPunctuation?: boolean;\n  /**\n   * Allow a number of milliseconds of silence before splitting the recognition session into segments.\n   * Required to be greater than zero and currently supported on Android only.\n   */\n  allowForSilence?: number;\n}\n\n/**\n * Raised whenever a partial transcription is produced.\n */\nexport interface SpeechRecognitionPartialResultEvent {\n  matches: string[];\n}\n\n/**\n * Raised whenever a segmented result is produced (Android only).\n */\nexport interface SpeechRecognitionSegmentResultEvent {\n  matches: string[];\n}\n\n/**\n * Raised when the listening state changes.\n */\nexport interface SpeechRecognitionListeningEvent {\n  status: 'started' | 'stopped';\n}\n\nexport interface SpeechRecognitionAvailability {\n  available: boolean;\n}\n\nexport interface SpeechRecognitionMatches {\n  matches?: string[];\n}\n\nexport interface SpeechRecognitionLanguages {\n  languages: string[];\n}\n\nexport interface SpeechRecognitionListening {\n  listening: boolean;\n}\n\nexport interface SpeechRecognitionPlugin {\n  /**\n   * Checks whether the native speech recognition service is usable on the current device.\n   */\n  available(): Promise<SpeechRecognitionAvailability>;\n  /**\n   * Begins capturing audio and transcribing speech.\n   *\n   * When `partialResults` is `true`, the returned promise resolves immediately and updates are\n   * streamed through the `partialResults` listener until {@link stop} is called.\n   */\n  start(options?: SpeechRecognitionStartOptions): Promise<SpeechRecognitionMatches>;\n  /**\n   * Stops listening and tears down native resources.\n   */\n  stop(): Promise<void>;\n  /**\n   * Gets the locales supported by the underlying recognizer.\n   *\n   * Android 13+ devices no longer expose this list; in that case `languages` is empty.\n   */\n  getSupportedLanguages(): Promise<SpeechRecognitionLanguages>;\n  /**\n   * Returns whether the plugin is actively listening for speech.\n   */\n  isListening(): Promise<SpeechRecognitionListening>;\n  /**\n   * Gets the current permission state.\n   */\n  checkPermissions(): Promise<SpeechRecognitionPermissionStatus>;\n  /**\n   * Requests the microphone + speech recognition permissions.\n   */\n  requestPermissions(): Promise<SpeechRecognitionPermissionStatus>;\n  /**\n   * Returns the native plugin version bundled with this package.\n   *\n   * Useful when reporting issues to confirm that native and JS versions match.\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n  /**\n   * Listen for segmented session completion events (Android only).\n   */\n  addListener(eventName: 'endOfSegmentedSession', listenerFunc: () => void): Promise<PluginListenerHandle>;\n  /**\n   * Listen for segmented recognition results (Android only).\n   */\n  addListener(\n    eventName: 'segmentResults',\n    listenerFunc: (event: SpeechRecognitionSegmentResultEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Listen for partial transcription updates emitted while `partialResults` is enabled.\n   */\n  addListener(\n    eventName: 'partialResults',\n    listenerFunc: (event: SpeechRecognitionPartialResultEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Listen for changes to the native listening state.\n   */\n  addListener(\n    eventName: 'listeningState',\n    listenerFunc: (event: SpeechRecognitionListeningEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Removes every registered listener.\n   */\n  removeAllListeners(): Promise<void>;\n}\n"]}

package/dist/esm/web.d.ts

@@ -8,4 +8,7 @@ export declare class SpeechRecognitionWeb extends WebPlugin implements SpeechRec
     isListening(): Promise<SpeechRecognitionListening>;
     checkPermissions(): Promise<SpeechRecognitionPermissionStatus>;
     requestPermissions(): Promise<SpeechRecognitionPermissionStatus>;
+    getPluginVersion(): Promise<{
+        version: string;
+    }>;
 }

package/dist/esm/web.js

@@ -21,5 +21,8 @@ export class SpeechRecognitionWeb extends WebPlugin {
     requestPermissions() {
         throw this.unimplemented('Speech recognition permissions are not handled on the web.');
     }
+    async getPluginVersion() {
+        return { version: 'web' };
+    }
 }
 //# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAY5C,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IACjD,SAAS;QACP,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,QAAwC;QAC5C,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI;QACF,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;IAED,qBAAqB;QACnB,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;IAED,WAAW;QACT,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;IAED,gBAAgB;QACd,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC,CAAC;IACzF,CAAC;IAED,kBAAkB;QAChB,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC,CAAC;IACzF,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  SpeechRecognitionAvailability,\n  SpeechRecognitionLanguages,\n  SpeechRecognitionListening,\n  SpeechRecognitionMatches,\n  SpeechRecognitionPermissionStatus,\n  SpeechRecognitionPlugin,\n  SpeechRecognitionStartOptions,\n} from './definitions';\n\nexport class SpeechRecognitionWeb extends WebPlugin implements SpeechRecognitionPlugin {\n  available(): Promise<SpeechRecognitionAvailability> {\n    throw this.unimplemented('Speech recognition is not available on the web.');\n  }\n\n  start(_options?: SpeechRecognitionStartOptions): Promise<SpeechRecognitionMatches> {\n    throw this.unimplemented('Speech recognition is not available on the web.');\n  }\n\n  stop(): Promise<void> {\n    throw this.unimplemented('Speech recognition is not available on the web.');\n  }\n\n  getSupportedLanguages(): Promise<SpeechRecognitionLanguages> {\n    throw this.unimplemented('Speech recognition is not available on the web.');\n  }\n\n  isListening(): Promise<SpeechRecognitionListening> {\n    throw this.unimplemented('Speech recognition is not available on the web.');\n  }\n\n  checkPermissions(): Promise<SpeechRecognitionPermissionStatus> {\n    throw this.unimplemented('Speech recognition permissions are not handled on the web.');\n  }\n\n  requestPermissions(): Promise<SpeechRecognitionPermissionStatus> {\n    throw this.unimplemented('Speech recognition permissions are not handled on the web.');\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAY5C,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IACjD,SAAS;QACP,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,QAAwC;QAC5C,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI;QACF,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;IAED,qBAAqB;QACnB,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;IAED,WAAW;QACT,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;IAED,gBAAgB;QACd,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC,CAAC;IACzF,CAAC;IAED,kBAAkB;QAChB,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC,CAAC;IACzF,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  SpeechRecognitionAvailability,\n  SpeechRecognitionLanguages,\n  SpeechRecognitionListening,\n  SpeechRecognitionMatches,\n  SpeechRecognitionPermissionStatus,\n  SpeechRecognitionPlugin,\n  SpeechRecognitionStartOptions,\n} from './definitions';\n\nexport class SpeechRecognitionWeb extends WebPlugin implements SpeechRecognitionPlugin {\n  available(): Promise<SpeechRecognitionAvailability> {\n    throw this.unimplemented('Speech recognition is not available on the web.');\n  }\n\n  start(_options?: SpeechRecognitionStartOptions): Promise<SpeechRecognitionMatches> {\n    throw this.unimplemented('Speech recognition is not available on the web.');\n  }\n\n  stop(): Promise<void> {\n    throw this.unimplemented('Speech recognition is not available on the web.');\n  }\n\n  getSupportedLanguages(): Promise<SpeechRecognitionLanguages> {\n    throw this.unimplemented('Speech recognition is not available on the web.');\n  }\n\n  isListening(): Promise<SpeechRecognitionListening> {\n    throw this.unimplemented('Speech recognition is not available on the web.');\n  }\n\n  checkPermissions(): Promise<SpeechRecognitionPermissionStatus> {\n    throw this.unimplemented('Speech recognition permissions are not handled on the web.');\n  }\n\n  requestPermissions(): Promise<SpeechRecognitionPermissionStatus> {\n    throw this.unimplemented('Speech recognition permissions are not handled on the web.');\n  }\n\n  async getPluginVersion(): Promise<{ version: string }> {\n    return { version: 'web' };\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -28,6 +28,9 @@ class SpeechRecognitionWeb extends core.WebPlugin {
     requestPermissions() {
         throw this.unimplemented('Speech recognition permissions are not handled on the web.');
     }
+    async getPluginVersion() {
+        return { version: 'web' };
+    }
 }
 
 var web = /*#__PURE__*/Object.freeze({

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst SpeechRecognition = registerPlugin('SpeechRecognition', {\n    web: () => import('./web').then((m) => new m.SpeechRecognitionWeb()),\n});\nexport * from './definitions';\nexport { SpeechRecognition };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class SpeechRecognitionWeb extends WebPlugin {\n    available() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    start(_options) {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    stop() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    getSupportedLanguages() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    isListening() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    checkPermissions() {\n        throw this.unimplemented('Speech recognition permissions are not handled on the web.');\n    }\n    requestPermissions() {\n        throw this.unimplemented('Speech recognition permissions are not handled on the web.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,iBAAiB,GAAGA,mBAAc,CAAC,mBAAmB,EAAE;AAC9D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;AACxE,CAAC;;ACFM,MAAM,oBAAoB,SAASC,cAAS,CAAC;AACpD,IAAI,SAAS,GAAG;AAChB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ,IAAI,KAAK,CAAC,QAAQ,EAAE;AACpB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ,IAAI,IAAI,GAAG;AACX,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ,IAAI,qBAAqB,GAAG;AAC5B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ,IAAI,WAAW,GAAG;AAClB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ,IAAI,gBAAgB,GAAG;AACvB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;AAC9F,IAAI;AACJ,IAAI,kBAAkB,GAAG;AACzB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;AAC9F,IAAI;AACJ;;;;;;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst SpeechRecognition = registerPlugin('SpeechRecognition', {\n    web: () => import('./web').then((m) => new m.SpeechRecognitionWeb()),\n});\nexport * from './definitions';\nexport { SpeechRecognition };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class SpeechRecognitionWeb extends WebPlugin {\n    available() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    start(_options) {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    stop() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    getSupportedLanguages() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    isListening() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    checkPermissions() {\n        throw this.unimplemented('Speech recognition permissions are not handled on the web.');\n    }\n    requestPermissions() {\n        throw this.unimplemented('Speech recognition permissions are not handled on the web.');\n    }\n    async getPluginVersion() {\n        return { version: 'web' };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,iBAAiB,GAAGA,mBAAc,CAAC,mBAAmB,EAAE;AAC9D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;AACxE,CAAC;;ACFM,MAAM,oBAAoB,SAASC,cAAS,CAAC;AACpD,IAAI,SAAS,GAAG;AAChB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ,IAAI,KAAK,CAAC,QAAQ,EAAE;AACpB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ,IAAI,IAAI,GAAG;AACX,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ,IAAI,qBAAqB,GAAG;AAC5B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ,IAAI,WAAW,GAAG;AAClB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ,IAAI,gBAAgB,GAAG;AACvB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;AAC9F,IAAI;AACJ,IAAI,kBAAkB,GAAG;AACzB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;AAC9F,IAAI;AACJ,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;AACjC,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -27,6 +27,9 @@ var capacitorCapacitorSpeechRecognition = (function (exports, core) {
         requestPermissions() {
             throw this.unimplemented('Speech recognition permissions are not handled on the web.');
         }
+        async getPluginVersion() {
+            return { version: 'web' };
+        }
     }
 
     var web = /*#__PURE__*/Object.freeze({

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst SpeechRecognition = registerPlugin('SpeechRecognition', {\n    web: () => import('./web').then((m) => new m.SpeechRecognitionWeb()),\n});\nexport * from './definitions';\nexport { SpeechRecognition };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class SpeechRecognitionWeb extends WebPlugin {\n    available() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    start(_options) {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    stop() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    getSupportedLanguages() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    isListening() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    checkPermissions() {\n        throw this.unimplemented('Speech recognition permissions are not handled on the web.');\n    }\n    requestPermissions() {\n        throw this.unimplemented('Speech recognition permissions are not handled on the web.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,iBAAiB,GAAGA,mBAAc,CAAC,mBAAmB,EAAE;IAC9D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;IACxE,CAAC;;ICFM,MAAM,oBAAoB,SAASC,cAAS,CAAC;IACpD,IAAI,SAAS,GAAG;IAChB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ,IAAI,KAAK,CAAC,QAAQ,EAAE;IACpB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ,IAAI,IAAI,GAAG;IACX,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ,IAAI,qBAAqB,GAAG;IAC5B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ,IAAI,WAAW,GAAG;IAClB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ,IAAI,gBAAgB,GAAG;IACvB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;IAC9F,IAAI;IACJ,IAAI,kBAAkB,GAAG;IACzB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;IAC9F,IAAI;IACJ;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst SpeechRecognition = registerPlugin('SpeechRecognition', {\n    web: () => import('./web').then((m) => new m.SpeechRecognitionWeb()),\n});\nexport * from './definitions';\nexport { SpeechRecognition };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class SpeechRecognitionWeb extends WebPlugin {\n    available() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    start(_options) {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    stop() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    getSupportedLanguages() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    isListening() {\n        throw this.unimplemented('Speech recognition is not available on the web.');\n    }\n    checkPermissions() {\n        throw this.unimplemented('Speech recognition permissions are not handled on the web.');\n    }\n    requestPermissions() {\n        throw this.unimplemented('Speech recognition permissions are not handled on the web.');\n    }\n    async getPluginVersion() {\n        return { version: 'web' };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,iBAAiB,GAAGA,mBAAc,CAAC,mBAAmB,EAAE;IAC9D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;IACxE,CAAC;;ICFM,MAAM,oBAAoB,SAASC,cAAS,CAAC;IACpD,IAAI,SAAS,GAAG;IAChB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ,IAAI,KAAK,CAAC,QAAQ,EAAE;IACpB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ,IAAI,IAAI,GAAG;IACX,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ,IAAI,qBAAqB,GAAG;IAC5B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ,IAAI,WAAW,GAAG;IAClB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ,IAAI,gBAAgB,GAAG;IACvB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;IAC9F,IAAI;IACJ,IAAI,kBAAkB,GAAG;IACzB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;IAC9F,IAAI;IACJ,IAAI,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;IACjC,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Sources/SpeechRecognitionPlugin/SpeechRecognitionPlugin.swift

@@ -11,6 +11,7 @@ private enum PermissionState: String {
 
 @objc(SpeechRecognitionPlugin)
 public final class SpeechRecognitionPlugin: CAPPlugin, CAPBridgedPlugin {
+    private let pluginVersion: String = "7.2.0"
     public let identifier = "SpeechRecognitionPlugin"
     public let jsName = "SpeechRecognition"
     public let pluginMethods: [CAPPluginMethod] = [
@@ -20,7 +21,8 @@ public final class SpeechRecognitionPlugin: CAPPlugin, CAPBridgedPlugin {
         CAPPluginMethod(name: "getSupportedLanguages", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "isListening", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "checkPermissions", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "requestPermissions", returnType: CAPPluginReturnPromise)
+        CAPPluginMethod(name: "requestPermissions", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getPluginVersion", returnType: CAPPluginReturnPromise)
     ]
 
     private let audioEngine = AVAudioEngine()
@@ -41,11 +43,13 @@ public final class SpeechRecognitionPlugin: CAPPlugin, CAPBridgedPlugin {
 
     @objc func start(_ call: CAPPluginCall) {
         if self.audioEngine.isRunning || recognitionTask != nil {
+            CAPLog.print("[SpeechRecognition] Attempted to start while already running")
             call.reject("Speech recognition is already running.")
             return
         }
 
         guard isSpeechPermissionGranted else {
+            CAPLog.print("[SpeechRecognition] Missing speech permission, rejecting start()")
             call.reject("Missing speech recognition permission.")
             return
         }
@@ -59,9 +63,11 @@ public final class SpeechRecognitionPlugin: CAPPlugin, CAPBridgedPlugin {
 
         self.activeCall = call
         self.currentOptions = options
+        CAPLog.print("[SpeechRecognition] Starting session | language=\(options.language) partialResults=\(options.partialResults) punctuation=\(options.addPunctuation)")
 
         AVAudioSession.sharedInstance().requestRecordPermission { granted in
             guard granted else {
+                CAPLog.print("[SpeechRecognition] Microphone permission denied by user")
                 DispatchQueue.main.async {
                     call.reject("User denied microphone access.")
                     self.cleanupRecognition(notifyStop: false)
@@ -76,6 +82,7 @@ public final class SpeechRecognitionPlugin: CAPPlugin, CAPBridgedPlugin {
     }
 
     @objc func stop(_ call: CAPPluginCall) {
+        CAPLog.print("[SpeechRecognition] stop() invoked")
         cleanupRecognition(notifyStop: true)
         call.resolve()
     }
@@ -209,6 +216,7 @@ public final class SpeechRecognitionPlugin: CAPPlugin, CAPBridgedPlugin {
 
     private func cleanupRecognition(notifyStop: Bool) {
         DispatchQueue.main.async {
+            CAPLog.print("[SpeechRecognition] Cleaning up recognition resources")
             if self.audioEngine.isRunning {
                 self.audioEngine.stop()
             }
@@ -234,6 +242,7 @@ public final class SpeechRecognitionPlugin: CAPPlugin, CAPBridgedPlugin {
 
     private func handleRecognitionError(_ error: Error) {
         DispatchQueue.main.async {
+            CAPLog.print("[SpeechRecognition] Error from recognizer: \(error.localizedDescription)")
             self.cleanupRecognition(notifyStop: true)
             self.activeCall?.reject(error.localizedDescription)
         }
@@ -272,6 +281,10 @@ public final class SpeechRecognitionPlugin: CAPPlugin, CAPBridgedPlugin {
 
         return .granted
     }
+
+    @objc func getPluginVersion(_ call: CAPPluginCall) {
+        call.resolve(["version": pluginVersion])
+    }
 }
 
 private struct RecognitionOptions {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-speech-recognition",
-  "version": "7.0.1",
+  "version": "7.2.0",
   "description": "Capacitor plugin for comprehensive on-device speech recognition with live partial results.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -39,8 +39,8 @@
     "verify:web": "npm run build",
     "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
     "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
-    "eslint": "eslint . --ext .ts",
-    "prettier": "prettier \"**/*.{css,html,ts,js,java,kt}\" --plugin=prettier-plugin-java",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
     "swiftlint": "node-swiftlint",
     "docgen": "docgen --api SpeechRecognitionPlugin --output-readme README.md --output-json dist/docs.json",
     "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",