@livx.cc/native-kit 0.26.0 → 0.28.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@livx.cc/native-kit",
-  "version": "0.26.0",
-  "description": "Isomorphic native-capabilities kit for PWAs — same API in browser and in an appwrap native shell. Zero dependencies.",
+  "version": "0.28.0",
+  "description": "Isomorphic native-capabilities kit for PWAs \u2014 same API in browser and in an appwrap native shell. Zero dependencies.",
   "license": "MIT",
   "author": "Elya Livshitz",
   "homepage": "https://github.com/Livshitz/appwrap#readme",
@@ -37,7 +37,8 @@
     "src"
   ],
   "scripts": {
-    "build": "bun build src/index.ts --outdir=dist --format=esm && bun build src/index.ts --outfile=dist/native-kit.iife.js --format=iife --global-name=NativeKitLib"
+    "typecheck": "tsc --noEmit",
+    "build": "tsc --noEmit && bun build src/index.ts --outdir=dist --format=esm && bun build src/index.ts --outfile=dist/native-kit.iife.js --format=iife --global-name=NativeKitLib"
   },
   "devDependencies": {
     "typescript": "^5.4.0"

package/src/core/web-adapter.ts

@@ -417,6 +417,7 @@ export class WebAdapter implements NativeKitAdapter {
       case 'push.requestPermission':
       case 'push.register':
       case 'push.unregister':
+      case 'push.sendTest':
         throw new KitError('UNSUPPORTED', 'No native remote push on web — use Web Push (VAPID) in your app, or run inside the appwrap shell');
 
       default:

package/src/modules/push.ts

@@ -65,6 +65,13 @@ export class PushModule {
     return this.kit.invoke('push.unregister');
   }
 
+  /** Dev/demo: ask your backend (via `push.registrationUrl`) to push THIS device on demand. The shell
+   *  POSTs the token natively (no WebView CORS) with `test:true`. Resolves `{ status }` (the backend's
+   *  HTTP code). Requires a configured registrationUrl + a registered token. */
+  sendTest(): Promise<{ status: number }> {
+    return this.kit.invoke('push.sendTest', undefined, { timeoutMs: 20_000 });
+  }
+
   /** Foreground message delivery (app open, no tap). */
   onMessage(cb: (m: PushMessage) => void): Unsubscribe {
     return this.kit.on('push.message', (p) => cb(p as PushMessage));

package/src/modules/scanner.ts

@@ -53,7 +53,9 @@ export class ScannerModule {
 
   /** Open the scanner; resolve the first code, or `{ cancelled: true }` if dismissed. */
   scan(opts: ScanOptions = {}): Promise<ScanResult | ScanCancelled> {
-    return this.kit.invoke('scanner.scan', opts);
+    // Open-ended: the camera stays up until a code is found or the user cancels — lining up a QR
+    // routinely takes longer than the 10s invoke default, which would abandon the scan mid-aim.
+    return this.kit.invoke('scanner.scan', opts, { timeoutMs: 300_000 });
   }
 
   /** Dismiss an in-progress {@link scan} (its promise then resolves `{ cancelled: true }`). */

package/src/modules/speech.ts

@@ -68,7 +68,9 @@ export class SpeechModule {
 
   /** Speak `text` aloud; resolves when the utterance finishes (or is stopped). */
   speak(text: string, opts: SpeakOptions = {}): Promise<void> {
-    return this.kit.invoke('speech.speak', { text, ...opts });
+    // Resolves only when the utterance (or its queue) finishes — easily exceeds the 10s invoke
+    // default for longer text or back-to-back speak() calls, dropping the result. Give it room.
+    return this.kit.invoke('speech.speak', { text, ...opts }, { timeoutMs: 120_000 });
   }
 
   /** Cancel the current/queued utterance immediately. */
@@ -84,7 +86,9 @@ export class SpeechModule {
   /** Start capturing the mic; resolves the FINAL transcript. With `{ partial:true }`, interim
    *  results stream via {@link onPartial}. Throws `KitError('UNSUPPORTED')` where STT is absent. */
   listen(opts: ListenOptions = {}): Promise<string> {
-    return this.kit.invoke('speech.listen', opts);
+    // Open-ended: resolves on the final result or when stopListening() is called — a person may take
+    // a while to speak, so it must not be cut off by the 10s invoke default.
+    return this.kit.invoke('speech.listen', opts, { timeoutMs: 600_000 });
   }
 
   /** Stop capture early; the pending {@link listen} resolves with the best transcript so far. */