@livx.cc/native-kit 0.45.3 → 0.45.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livx.cc/native-kit",
-  "version": "0.45.3",
+  "version": "0.45.5",
   "description": "Isomorphic native-capabilities kit for PWAs — same API in browser and in an appwrap native shell. Zero dependencies.",
   "license": "MIT",
   "author": "Elya Livshitz",

package/src/core/web-adapter.ts

@@ -268,7 +268,36 @@ export class WebAdapter implements NativeKitAdapter {
       case 'notifications.schedule': {
         if (Notification.permission !== 'granted') throw new KitError('DENIED', 'Permission not granted');
         const delay = (p.delaySec ?? 1) * 1000;
-        setTimeout(() => new Notification(p.title, { body: p.body }), delay);
+        // Rich options degrade one step at a time rather than all-or-nothing: `icon`/`image` are
+        // honoured by the plain Notification constructor, but ACTION BUTTONS exist only on
+        // ServiceWorkerRegistration.showNotification — so use the SW when there is one and fall back
+        // to a button-less banner when there isn't, instead of refusing the call.
+        const opts: NotificationOptions & { image?: string; actions?: Array<{ action: string; title: string }> } = {
+          body: p.body,
+          icon: p.icon,
+          tag: p.sender || undefined,
+          silent: !!p.silent,
+          data: { url: p.deepLink, actions: p.actions },
+        };
+        if (p.image) opts.image = p.image;
+        const buttons: Array<{ id: string; title: string }> = Array.isArray(p.actions) ? p.actions.slice(0, 3) : [];
+        setTimeout(async () => {
+          const reg = buttons.length ? await navigator.serviceWorker?.ready.catch(() => null) : null;
+          if (reg && buttons.length) {
+            opts.actions = buttons.map((b) => ({ action: b.id, title: b.title }));
+            await reg.showNotification(p.title, opts).catch((e: Error) => console.warn('[kit] showNotification failed', e));
+            return;
+          }
+          const n = new Notification(p.title, opts);
+          // A tap on the banner focuses this tab and follows the deep link when it is a web URL —
+          // a custom scheme is a native-only target and navigating to it here would just error.
+          n.onclick = () => {
+            window.focus();
+            const url = String(p.deepLink ?? '');
+            if (/^https?:\/\//i.test(url)) location.href = url;
+            n.close();
+          };
+        }, delay);
         return { id: p.id ?? Date.now() % 100000 } as T;
       }
       case 'notifications.pending':

package/src/index.ts

@@ -27,7 +27,7 @@ export type { Orientation, OrientationLock } from './modules/screen';
 export type { KeyboardInfo } from './modules/keyboard';
 export type { FsDirectory, FsEncoding, FsEntry, PickedFile } from './modules/fs';
 export type { DeviceInfo } from './modules/device';
-export type { ScheduleOptions } from './modules/notifications';
+export type { ScheduleOptions, NotificationAction } from './modules/notifications';
 export type { PushMessage, PushPlatform, PushToken } from './modules/push';
 export type { GeoPosition } from './modules/geo';
 export type { HeadingSample } from './modules/heading';

package/src/modules/notifications.ts

@@ -44,6 +44,31 @@ export interface ScheduleOptions {
    * falls back to the DEFAULT alert — never to silence. iOS only; Android uses its channel sound.
    */
   sound?: string;
+  /**
+   * HERO ARTWORK — an image URL or data-URI that turns the banner into a rich card: an expandable
+   * attachment on iOS (UNNotificationAttachment) and a BigPictureStyle image on Android. A failed
+   * download degrades to a plain banner rather than dropping the notification.
+   */
+  image?: string;
+  /**
+   * Up to 3 tappable BUTTONS. Each carries its own `deepLink` (falling back to the notification's
+   * when omitted), delivered through the same `deeplink.open` event as a banner tap — so
+   * `kit.lifecycle.onDeepLink` routes a button tap with no extra wiring. iOS draws 2 on a collapsed
+   * banner (4 expanded), Android 3; extra entries, and entries missing an id or title, are dropped.
+   * On the web they need a service worker (buttons are a ServiceWorkerRegistration feature) —
+   * without one the banner still shows, just without buttons.
+   */
+  actions?: NotificationAction[];
+}
+
+/** One tappable button on a rich notification. */
+export interface NotificationAction {
+  /** Stable id — what identifies the tapped button. */
+  id: string;
+  /** Button label. */
+  title: string;
+  /** Where the tap lands. Defaults to the notification's own `deepLink`. */
+  deepLink?: string;
 }
 
 export class NotificationsModule {