@livx.cc/appwrap 0.26.0 → 0.28.1

package/runtime/app/shell/handlers-speech.ts

@@ -2,23 +2,25 @@ import { Utils, isAndroid, isIOS } from '@nativescript/core';
 import { bridge } from './bridge';
 import { requestPermissions } from './android-helpers';
 
-// AVFoundation / Speech globals (NS auto-links the frameworks via metadata when referenced).
-declare const AVSpeechSynthesizer: any;
-declare const AVSpeechUtterance: any;
-declare const AVSpeechSynthesisVoice: any;
-declare const AVAudioEngine: any;
-declare const AVAudioSession: any;
-declare const AVAudioSessionCategoryPlayAndRecord: any;
-declare const AVAudioSessionModeMeasurement: any;
-declare const SFSpeechRecognizer: any;
-declare const SFSpeechAudioBufferRecognitionRequest: any;
-declare const SFSpeechRecognizerAuthorizationStatusAuthorized: any;
-declare const NSLocale: any;
-declare const android: any;
-declare const java: any;
-
 const err = (code: string, message: string) => Object.assign(new Error(message), { code });
 
+// iOS speech-synthesizer delegate — both finish & cancel settle the pending speak (the JS
+// `speakPending` is captured via the `onSettle` instance field, assigned after `new()`).
+@NativeClass()
+class SpeakDelegate extends NSObject implements AVSpeechSynthesizerDelegate {
+  static ObjCProtocols = [AVSpeechSynthesizerDelegate];
+  onSettle?: () => void;
+  static new(): SpeakDelegate {
+    return <SpeakDelegate>super.new();
+  }
+  speechSynthesizerDidFinishSpeechUtterance(_s: AVSpeechSynthesizer, _u: AVSpeechUtterance): void {
+    this.onSettle?.();
+  }
+  speechSynthesizerDidCancelSpeechUtterance(_s: AVSpeechSynthesizer, _u: AVSpeechUtterance): void {
+    this.onSettle?.();
+  }
+}
+
 /**
  * Voice I/O. TTS: iOS AVSpeechSynthesizer / Android TextToSpeech — speak resolves on finish.
  * STT: iOS SFSpeechRecognizer + AVAudioEngine mic tap / Android SpeechRecognizer — listen resolves
@@ -37,15 +39,15 @@ export function registerSpeechHandlers(): void {
 function registerIos(): void {
   // Strong refs while a session is live — ARC would otherwise free the synthesizer/engine/delegate
   // the moment the JS locals fall out of scope (same hazard as handlers-scanner/oauth).
-  let synth: any = null;
-  let speakDelegate: any = null;
+  let synth: AVSpeechSynthesizer | null = null;
+  let speakDelegate: SpeakDelegate | null = null;
   let speakPending: { resolve: () => void } | null = null;
 
-  let engine: any = null;
-  let recognizer: any = null;
-  let request: any = null;
-  let task: any = null;
-  let listenPending: { resolve: (v: string) => void; reject: (e: any) => void } | null = null;
+  let engine: AVAudioEngine | null = null;
+  let recognizer: SFSpeechRecognizer | null = null;
+  let request: SFSpeechAudioBufferRecognitionRequest | null = null;
+  let task: SFSpeechRecognitionTask | null = null;
+  let listenPending: { resolve: (v: string) => void; reject: (e: Error) => void } | null = null;
   let best = '';
 
   const teardownListen = () => {
@@ -71,18 +73,8 @@ function registerIos(): void {
         try {
           if (!synth) {
             synth = AVSpeechSynthesizer.new();
-            const DelegateClass = (NSObject as any).extend(
-              {
-                speechSynthesizerDidFinishSpeechUtterance(_s: any, _u: any) {
-                  const p = speakPending; speakPending = null; p?.resolve();
-                },
-                speechSynthesizerDidCancelSpeechUtterance(_s: any, _u: any) {
-                  const p = speakPending; speakPending = null; p?.resolve();
-                },
-              },
-              { protocols: [] }
-            );
-            speakDelegate = DelegateClass.new();
+            speakDelegate = SpeakDelegate.new();
+            speakDelegate.onSettle = () => { const p = speakPending; speakPending = null; p?.resolve(); };
             synth.delegate = speakDelegate;
           }
           // A new speak resolves any prior pending (its utterance is being superseded).
@@ -136,8 +128,8 @@ function registerIos(): void {
       best = '';
       listenPending = { resolve, reject };
 
-      SFSpeechRecognizer.requestAuthorization((status: any) => {
-        if (status !== SFSpeechRecognizerAuthorizationStatusAuthorized) {
+      SFSpeechRecognizer.requestAuthorization((status: SFSpeechRecognizerAuthorizationStatus) => {
+        if (status !== SFSpeechRecognizerAuthorizationStatus.Authorized) {
           const p = listenPending; listenPending = null;
           p?.reject(err('DENIED', 'Speech recognition not authorized'));
           return;
@@ -167,17 +159,18 @@ function registerIos(): void {
 
             const session = AVAudioSession.sharedInstance();
             session.setCategoryModeOptionsError(AVAudioSessionCategoryPlayAndRecord, AVAudioSessionModeMeasurement, 1 /* duckOthers */, null);
-            session.setActiveWithOptionsError(true, 0, null);
+            // 0 = no activation flags; not a named member of the options enum, so cast (preserve value).
+            session.setActiveWithOptionsError(true, 0 as AVAudioSessionSetActiveOptions, null);
 
             engine = AVAudioEngine.new();
             request = SFSpeechAudioBufferRecognitionRequest.new();
             request.shouldReportPartialResults = !!params?.partial;
 
-            task = recognizer.recognitionTaskWithRequestResultHandler(request, (result: any, error: any) => {
+            task = recognizer.recognitionTaskWithRequestResultHandler(request, (result: SFSpeechRecognitionResult, error: NSError) => {
               if (result) {
                 best = String(result.bestTranscription?.formattedString ?? best);
-                if (params?.partial && !result.isFinal) bridge.emit('speech.partial', { transcript: best });
-                if (result.isFinal && listenPending) settleListen();
+                if (params?.partial && !result.final) bridge.emit('speech.partial', { transcript: best });
+                if (result.final && listenPending) settleListen();
               }
               if (error && listenPending) {
                 const p = listenPending; listenPending = null;
@@ -188,7 +181,7 @@ function registerIos(): void {
 
             const input = engine.inputNode;
             const format = input.outputFormatForBus(0);
-            input.installTapOnBusBufferSizeFormatBlock(0, 1024, format, (buffer: any, _when: any) => {
+            input.installTapOnBusBufferSizeFormatBlock(0, 1024, format, (buffer: AVAudioPCMBuffer, _when: AVAudioTime) => {
               request?.appendAudioPCMBuffer(buffer);
             });
             engine.prepare();
@@ -206,11 +199,11 @@ function registerIos(): void {
 
 function registerAndroid(): void {
   // TextToSpeech + SpeechRecognizer are plain Java → direct interop, no kotlin flag, no gradle dep.
-  let tts: any = null;
+  let tts: android.speech.tts.TextToSpeech | null = null;
   let ttsReady = false;
   const ctx = () => Utils.android.getApplicationContext();
 
-  const ensureTts = (): Promise<any> =>
+  const ensureTts = (): Promise<android.speech.tts.TextToSpeech | null> =>
     new Promise((resolve) => {
       if (tts && ttsReady) { resolve(tts); return; }
       tts = new android.speech.tts.TextToSpeech(
@@ -236,7 +229,8 @@ function registerAndroid(): void {
     const id = 'u' + Date.now();
     return new Promise<void>((resolve) => {
       engine.setOnUtteranceProgressListener(
-        new android.speech.tts.UtteranceProgressListener({
+        // NS interop: subclass the abstract Java class via object-literal ctor (untypeable — cast base).
+        new (android.speech.tts.UtteranceProgressListener as any)({
           onStart() {},
           onDone() { resolve(); },
           onError() { resolve(); }, // resolve regardless — speak() promises completion, not success
@@ -264,8 +258,8 @@ function registerAndroid(): void {
   });
 
   // STT — SpeechRecognizer must be created + driven on the main (UI) thread.
-  let recognizer: any = null;
-  let listenPending: { resolve: (v: string) => void; reject: (e: any) => void } | null = null;
+  let recognizer: android.speech.SpeechRecognizer | null = null;
+  let listenPending: { resolve: (v: string) => void; reject: (e: Error) => void } | null = null;
   let best = '';
 
   const settle = () => {
@@ -295,7 +289,7 @@ function registerAndroid(): void {
             return;
           }
           recognizer = android.speech.SpeechRecognizer.createSpeechRecognizer(ctx());
-          const pickText = (b: any): string => {
+          const pickText = (b: android.os.Bundle): string => {
             const arr = b?.getStringArrayList(android.speech.SpeechRecognizer.RESULTS_RECOGNITION);
             return arr && arr.size() ? String(arr.get(0)) : '';
           };
@@ -303,12 +297,12 @@ function registerAndroid(): void {
             new android.speech.RecognitionListener({
               onReadyForSpeech() {}, onBeginningOfSpeech() {}, onRmsChanged() {},
               onBufferReceived() {}, onEndOfSpeech() {}, onEvent() {},
-              onPartialResults(b: any) {
+              onPartialResults(b: android.os.Bundle) {
                 if (!params?.partial) return;
                 const t = pickText(b);
                 if (t) { best = t; bridge.emit('speech.partial', { transcript: t }); }
               },
-              onResults(b: any) {
+              onResults(b: android.os.Bundle) {
                 const t = pickText(b);
                 if (t) best = t;
                 if (listenPending) settle();

package/runtime/app/shell/handlers-system.ts

@@ -1,7 +1,7 @@
 import { Application, ApplicationSettings, Color, Utils, isAndroid, isIOS } from '@nativescript/core';
 import { bridge } from './bridge';
 
-declare const android: any, androidx: any, java: any;
+declare const androidx: any; // no NS types: androidx
 
 const err = (code: string, message: string) => Object.assign(new Error(message), { code });
 
@@ -119,6 +119,70 @@ export function registerSystemHandlers(): void {
 
   bridge.register('app.environment', () => appEnvironment());
 
+  // Probe whether the OS can open a URL. Custom schemes need declaring up-front (iOS
+  // LSApplicationQueriesSchemes via appwrap.json.queryUrlSchemes; Android <queries> via
+  // queryPackages) — common schemes (http/https/tel/mailto/sms) resolve without declaration.
+  bridge.register('app.canOpenUrl', ({ url }: { url: string }) => {
+    const target = String(url ?? '');
+    if (!target) return false;
+    if (isIOS) {
+      const nsUrl = NSURL.URLWithString(target);
+      return !!nsUrl && UIApplication.sharedApplication.canOpenURL(nsUrl);
+    }
+    if (isAndroid) {
+      const pm = Utils.android.getApplicationContext().getPackageManager();
+      const intent = new android.content.Intent(
+        android.content.Intent.ACTION_VIEW,
+        android.net.Uri.parse(target)
+      );
+      return pm.resolveActivity(intent, 0) != null;
+    }
+    return false;
+  });
+
+  // Home-screen long-press quick actions. iOS: UIApplication.shortcutItems. Android: dynamic
+  // ShortcutManager shortcuts (API 25+; no-op below) whose launch intent carries appwrap_shortcut=<id>.
+  bridge.register('app.setShortcuts', ({ items }: { items: Array<{ id: string; title: string; subtitle?: string }> }) => {
+    const list = (items ?? []).filter((i) => i && i.id && i.title);
+    if (isIOS) {
+      Utils.dispatchToMainThread(() => {
+        const arr = NSMutableArray.alloc().init();
+        for (const i of list) {
+          const item = UIApplicationShortcutItem.alloc().initWithTypeLocalizedTitleLocalizedSubtitleIconUserInfo(
+            String(i.id), String(i.title), i.subtitle ? String(i.subtitle) : null, null, null
+          );
+          arr.addObject(item);
+        }
+        UIApplication.sharedApplication.shortcutItems = arr as any;
+      });
+    } else if (isAndroid) {
+      if (android.os.Build.VERSION.SDK_INT < 25) return; // ShortcutManager is API 25+
+      const ctx = Utils.android.getApplicationContext();
+      const sm = ctx.getSystemService(android.content.Context.SHORTCUT_SERVICE); // API 25+ string const
+      if (!sm) return;
+      const launchClass = (Application.android.foregroundActivity ?? Application.android.startActivity)?.getClass();
+      const shortcuts = new java.util.ArrayList();
+      for (const i of list) {
+        const intent = new android.content.Intent(android.content.Intent.ACTION_VIEW);
+        if (launchClass) intent.setClassName(ctx, launchClass.getName());
+        intent.putExtra('appwrap_shortcut', String(i.id));
+        intent.addFlags(android.content.Intent.FLAG_ACTIVITY_NEW_TASK | android.content.Intent.FLAG_ACTIVITY_CLEAR_TOP);
+        const b = new android.content.pm.ShortcutInfo.Builder(ctx, String(i.id))
+          .setShortLabel(String(i.title))
+          .setLongLabel(String(i.subtitle ?? i.title))
+          .setIntent(intent);
+        shortcuts.add(b.build());
+      }
+      sm.setDynamicShortcuts(shortcuts);
+    }
+  });
+
+  // Privacy screen — hide content in the app-switcher / block screenshots. iOS: cover the key window
+  // with a blur while inactive/backgrounded (wired via the app lifecycle below). Android: FLAG_SECURE.
+  bridge.register('screen.setPrivacy', ({ enabled }: { enabled: boolean }) => {
+    setPrivacyScreen(!!enabled);
+  });
+
   bridge.register('browser.open', ({ url, toolbarColor }: { url: string; toolbarColor?: string }) => {
     const target = String(url ?? '');
     if (!target) throw err('NATIVE_ERROR', 'browser.open: empty url');
@@ -139,3 +203,60 @@ export function registerSystemHandlers(): void {
     }
   });
 }
+
+// ── privacy screen ────────────────────────────────────────────────────
+// iOS keeps the enabled flag + lazily wires the lifecycle hooks once. The cover MUST go on at
+// `willResignActive` — that fires BEFORE the app-switcher snapshot, whereas NS's suspendEvent
+// (≈ didEnterBackground) fires AFTER it, so suspendEvent alone would leak the first snapshot. We
+// observe the raw UIApplicationWillResignActiveNotification for the cover, removing it on
+// becomeActive. Android flips FLAG_SECURE immediately (also blocks screenshots).
+let privacyEnabled = false;
+let privacyCover: UIView | null = null;
+let privacyLifecycleWired = false;
+
+function setPrivacyScreen(enabled: boolean): void {
+  privacyEnabled = enabled;
+  if (isIOS) {
+    wireIosPrivacyLifecycle();
+    if (!enabled) Utils.dispatchToMainThread(removeIosPrivacyCover); // disabling mid-foreground
+  } else if (isAndroid) {
+    Utils.dispatchToMainThread(() => {
+      const activity = Application.android.foregroundActivity ?? Application.android.startActivity;
+      const FLAG_SECURE = android.view.WindowManager.LayoutParams.FLAG_SECURE;
+      const window = activity?.getWindow();
+      if (!window) return;
+      if (enabled) window.setFlags(FLAG_SECURE, FLAG_SECURE);
+      else window.clearFlags(FLAG_SECURE);
+    });
+  }
+}
+
+function wireIosPrivacyLifecycle(): void {
+  if (privacyLifecycleWired) return;
+  privacyLifecycleWired = true;
+  const center = NSNotificationCenter.defaultCenter;
+  // willResignActive → cover BEFORE the OS captures the app-switcher snapshot (the critical timing).
+  center.addObserverForNameObjectQueueUsingBlock(
+    UIApplicationWillResignActiveNotification, null, null, () => { if (privacyEnabled) addIosPrivacyCover(); }
+  );
+  // didBecomeActive → reveal again once the user returns.
+  center.addObserverForNameObjectQueueUsingBlock(
+    UIApplicationDidBecomeActiveNotification, null, null, () => removeIosPrivacyCover()
+  );
+}
+
+function addIosPrivacyCover(): void {
+  const window = UIApplication.sharedApplication.keyWindow;
+  if (!window || privacyCover) return;
+  const effect = UIBlurEffect.effectWithStyle(UIBlurEffectStyle.SystemMaterial);
+  const blur = UIVisualEffectView.alloc().initWithEffect(effect);
+  blur.frame = window.bounds;
+  blur.autoresizingMask = UIViewAutoresizing.FlexibleWidth | UIViewAutoresizing.FlexibleHeight;
+  window.addSubview(blur);
+  privacyCover = blur;
+}
+
+function removeIosPrivacyCover(): void {
+  privacyCover?.removeFromSuperview();
+  privacyCover = null;
+}

package/runtime/app/shell/handlers.ts

@@ -7,6 +7,7 @@ import { showBanner, dismissBanner } from './banner';
 import { setStatusBarStyle } from './status-bar';
 import { buildCapabilityMap } from './capabilities.manifest';
 import { ACTIVE_MODULE_NAMES } from './active-modules.generated';
+import { consumePendingBackgroundTaskId } from './background-context';
 
 /** Build identifier for the native shell bundle — bump per deploy to spot stale bundles. */
 export const SHELL_BUILD = 'updates-devmenu-3';
@@ -27,12 +28,17 @@ export function registerHandlers(): void {
     // kit degrades gracefully. Push is special — gated by per-platform build config, not the manifest.
     const capabilities = buildCapabilityMap(new Set(ACTIVE_MODULE_NAMES), isIOS ? 'ios' : 'android') as Record<string, 'native' | 'none'>;
     capabilities.push = (isIOS ? SHELL_CONFIG.pushIos : SHELL_CONFIG.pushAndroid) ? 'native' : 'none';
+    // Background launch: the headless runner (handlers-background) set the wake id before loading this
+    // (offscreen) WebView. Report it so `kit.backgroundTask` dispatches the registered handler. Consumed
+    // (read-once) so a later foreground handshake in the same process never re-reports a stale wake.
+    const backgroundTaskId = consumePendingBackgroundTaskId();
     return {
       protocol: 1,
       platform: isIOS ? 'ios' : 'android',
       app: { id: SHELL_CONFIG.appId, name: SHELL_CONFIG.name, version: SHELL_CONFIG.version, build: SHELL_BUILD, loader: SHELL_CONFIG.loader },
       debug: { lastNotifTap: safeJson(ApplicationSettings.getString('kit:__notifTap', '')) },
       capabilities,
+      ...(backgroundTaskId ? { backgroundTaskId } : {}),
     };
   });
 
@@ -74,7 +80,7 @@ export function registerHandlers(): void {
       const items = NSMutableArray.new();
       if (content) items.addObject(content);
       const controller = UIActivityViewController.alloc().initWithActivityItemsApplicationActivities(
-        items as any,
+        items,
         null
       );
       const rootVC = Utils.ios.getRootViewController();
@@ -102,6 +108,7 @@ export function registerHandlers(): void {
       if (text) items.addObject(text);
       const tmp = NSTemporaryDirectory();
       (files ?? []).forEach((f, i) => {
+        // 0 = no decoding options; the enum has no zero member, so cast the raw bitmask value.
         const data = NSData.alloc().initWithBase64EncodedStringOptions(f.base64, 0 as unknown as NSDataBase64DecodingOptions);
         if (!data) return;
         const filePath = tmp + i + '-' + (f.name || 'file'); // index-prefix: avoid same-name collisions in one call
@@ -109,7 +116,7 @@ export function registerHandlers(): void {
         items.addObject(NSURL.fileURLWithPath(filePath));
       });
       const controller = UIActivityViewController.alloc().initWithActivityItemsApplicationActivities(
-        items as any,
+        items,
         null
       );
       const rootVC = Utils.ios.getRootViewController();
@@ -181,6 +188,6 @@ function safeJson(s: string): unknown {
 
 function vibrateAndroid(ms: number): void {
   const context = Utils.android.getApplicationContext();
-  const vibrator = context.getSystemService(android.content.Context.VIBRATOR_SERVICE);
+  const vibrator = context.getSystemService(android.content.Context.VIBRATOR_SERVICE) as android.os.Vibrator;
   vibrator?.vibrate(ms);
 }

package/runtime/app/shell/ios-frameworks.d.ts

@@ -1,44 +1,9 @@
-/**
- * Ambient declarations for iOS frameworks not covered by the default
- * @nativescript/types-ios reference set (LocalAuthentication, CoreLocation,
- * PhotosUI). Marshalled at runtime by the NativeScript iOS runtime regardless.
- */
-declare const LAContext: any;
-declare const LAPolicy: any;
-declare const LABiometryType: any;
-declare const CLLocationManager: any;
-declare const CLAuthorizationStatus: any;
-declare const CLLocationManagerDelegate: any;
-declare const kCLLocationAccuracyHundredMeters: number;
-declare type CLLocation = any;
-declare type CLLocationManager = any;
-declare const PHPickerConfiguration: any;
-declare const PHPickerViewController: any;
-declare const PHPickerViewControllerDelegate: any;
-declare type PHPickerResult = any;
-declare type PHPickerViewController = any;
-// StoreKit / CoreMotion / ContactsUI / EventKit (parity handlers)
-declare const SKStoreReviewController: any;
-declare const CMMotionManager: any;
-declare const CMPedometer: any;
-// HealthKit (health/steps module)
-declare const HKHealthStore: any;
-declare const HKObjectType: any;
-declare const HKQuery: any;
-declare const HKStatisticsQuery: any;
-declare const HKStatisticsOptions: any;
-declare const HKUnit: any;
-declare const CNContactPickerViewController: any;
-declare const CNContactPickerDelegate: any;
-// Contacts framework (contacts.getAll bulk read — CNContactStore, vs the ContactsUI picker above)
-declare const CNContactStore: any;
-declare const CNEntityType: any;
-declare const CNContactFetchRequest: any;
-declare const CNContactGivenNameKey: any;
-declare const CNContactFamilyNameKey: any;
-declare const CNContactPhoneNumbersKey: any;
-declare const CNContactEmailAddressesKey: any;
-declare const EKEventStore: any;
-declare const EKEvent: any;
-declare const EKSpan: any;
-declare const EKEntityType: any;
+// Neutralizer stub — intentionally EMPTY. Do NOT add `declare const X: any` here.
+//
+// Real iOS framework types come from the @nativescript/types-ios references in `references.d.ts`.
+// This file exists ONLY so `appwrap sync` copies it over `native/app/shell/ios-frameworks.d.ts`,
+// overwriting a stale PRE-`references.d.ts` generated relic of the same name. That relic declared
+// every framework symbol as `declare const X: any` (a VALUE); once handlers annotate params with the
+// real types (e.g. `mm: CMMotionManager`), the value-shadow makes the build throw TS2749 ("refers to
+// a value, used as a type"). Shipping this empty stub self-heals any native/ on the next sync.
+export {};