@livx.cc/native-kit 0.21.0 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livx.cc/native-kit",
-  "version": "0.21.0",
+  "version": "0.22.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",

package/src/core/web-adapter.ts

@@ -49,6 +49,7 @@ export class WebAdapter implements NativeKitAdapter {
       device: 'web',
       clipboard: navigator.clipboard ? 'web' : 'none',
       notifications: 'Notification' in window ? 'web' : 'none',
+      badge: typeof (navigator as any).setAppBadge === 'function' ? 'web' : 'none', // Badging API (PWA icon badge)
       biometrics: 'none',
       geo: 'geolocation' in navigator ? 'web' : 'none',
       photos: 'web',

package/src/modules/app.ts

@@ -31,6 +31,22 @@ export class AppModule {
     return this.kit.capability('app');
   }
 
+  /** 'native' where the OS exposes an app-icon badge (iOS always; Android launcher-dependent →
+   *  honest no-op) · 'web' where the Badging API exists · else 'none'. Branch on this, not try/catch. */
+  get badgeCapability() {
+    return this.kit.capability('badge');
+  }
+
+  /**
+   * Set (or clear, with `0`) the app-icon badge count — the small number on the home-screen icon.
+   * Convenience over the shared native badge path: iOS sets the springboard badge; Android is an
+   * honest no-op (launchers own badges); web uses the Badging API where present.
+   * Branch on {@link badgeCapability}.
+   */
+  badge(count: number): Promise<void> {
+    return this.kit.invoke('notifications.setBadge', { count });
+  }
+
   /** Install-level environment facts for analytics/identification (source, install id, timestamps). */
   environment(): Promise<AppEnvironment> {
     return this.kit.invoke('app.environment');