@livx.cc/native-kit 0.44.0 → 0.45.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@livx.cc/native-kit",
-  "version": "0.44.0",
-  "description": "Isomorphic native-capabilities kit for PWAs \u2014 same API in browser and in an appwrap native shell. Zero dependencies.",
+  "version": "0.45.0",
+  "description": "Isomorphic native-capabilities kit for PWAs — same API in browser and in an appwrap native shell. Zero dependencies.",
   "license": "MIT",
   "author": "Elya Livshitz",
   "homepage": "https://github.com/Livshitz/appwrap#readme",

package/src/core/NativeKit.ts

@@ -113,7 +113,7 @@ export class NativeKit {
   /**
    * Additive, string-keyed registry mirroring the eager fields above (SAME instances) — a new
    * capability-access path out-of-repo module packs register into (e.g. the billing/health/widget
-   * EE packs call `kit.modules.registerModule(...)`). For core modules `kit.getModule('haptics')
+   * out-of-tree packs call `kit.modules.registerModule(...)`). For core modules `kit.getModule('haptics')
    * === kit.haptics`. Fails loud on miss.
    */
   public readonly modules = new ModuleRegistry();
@@ -142,7 +142,7 @@ export class NativeKit {
     this.options = { ...new NativeKitOptions(), ...options };
     // Mirror the eager CORE fields into the string-keyed registry (same instances, no behaviour
     // change). Typed as a plain string map — not `Record<keyof KitModuleRegistry, unknown>` — because
-    // out-of-repo packs augment KitModuleRegistry with keys CE never mounts (billing/health/widget);
+    // out-of-repo packs augment KitModuleRegistry with keys the core never mounts (billing/health/widget);
     // those are registered by the pack's register<Name>Kit(), not here.
     const eager: Record<string, unknown> = {
       haptics: this.haptics, share: this.share, screen: this.screen, keyboard: this.keyboard,

package/src/modules/notifications.ts

@@ -30,6 +30,20 @@ export interface ScheduleOptions {
    * badge unchanged. Set 0 to clear on delivery.
    */
   badge?: number;
+  /**
+   * Deliver WITHOUT the alert sound. Default (omitted/false) plays the system alert sound on
+   * both platforms — a scheduled notification is an alert, and a silent one is almost never
+   * what the caller meant. Android honours this on API 29+ only.
+   */
+  silent?: boolean;
+  /**
+   * Custom alert sound — either a file name the app already bundles, or an http(s) URL to audio in
+   * any format (mp3 included). iOS never fetches a sound itself and only plays LinearPCM in a
+   * caf/aiff/wav container under 30s, so the shell downloads a URL once, transcodes it, caches it in
+   * `Library/Sounds`, and hands the OS the resulting file name. Anything that fails along the way
+   * falls back to the DEFAULT alert — never to silence. iOS only; Android uses its channel sound.
+   */
+  sound?: string;
 }
 
 export class NotificationsModule {