react-native-notify-kit 10.8.1 → 10.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-notify-kit",
-  "version": "10.8.1",
+  "version": "10.9.0",
   "author": "Marco Crupi",
   "description": "Maintained Notifee-compatible React Native notifications library for Android, iOS, FCM Mode, rich notifications, foreground services, and Expo CNG development builds.",
   "main": "dist/index.js",
@@ -33,7 +33,7 @@
     "test:server": "jest --config jest.config.server.js",
     "prepare": "yarn run build",
     "prepack": "yarn run build:server && cd ../.. && bash build_ios_core.sh && bash scripts/verify-ios-core-generation.sh && bash scripts/prepack-cli.sh",
-    "postpack": "rm -rf cli",
+    "postpack": "node ../../scripts/cli-artifacts.cjs postpack",
     "prepublishOnly": "cd ../.. && yarn run build:core",
     "format:android": "google-java-format --replace -i $(find . -type f -name \"*.java\" ! -path \"*/node_modules/*\" ! -path \"*/generated/*\")",
     "format:android:check": "google-java-format --set-exit-if-changed --replace -i $(find . -type f -name \"*.java\" ! -path \"*/node_modules/*\" ! -path \"*/generated/*\")",
@@ -56,13 +56,14 @@
     "react-native": "0.85.3",
     "rimraf": "^3.0.2",
     "ts-jest": "^29.2.5",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "xcode": "^3.0.1"
   },
   "optionalDependencies": {
     "chalk": "^4.1.0",
     "commander": "^12.0.0",
     "plist": "^3.1.0",
-    "xcode": "^3.0.1"
+    "simple-plist": "^1.3.1"
   },
   "peerDependencies": {
     "expo": "*",
@@ -131,6 +132,8 @@
     "/server/tsconfig.json",
     "/server/package.json",
     "/cli/dist",
-    "/cli/bin"
+    "/cli/bin",
+    "/cli/vendor",
+    "/cli/package.json"
   ]
 }

package/src/NotifeeNativeModule.web.ts

@@ -1,4 +1,4 @@
-import { NativeModulesStatic } from 'react-native';
+import type { NativeModules } from 'react-native';
 import NotifeeJSEventEmitter from './NotifeeJSEventEmitter';
 
 export interface NativeModuleConfig {
@@ -19,7 +19,7 @@ export default class NotifeeNativeModule {
     return NotifeeJSEventEmitter;
   }
 
-  public get native(): NativeModulesStatic {
+  public get native(): typeof NativeModules {
     return {};
   }
 }

package/src/types/Notification.ts

@@ -428,6 +428,10 @@ export enum EventType {
    * @platform android
    */
   FG_TIMEOUT = 9,
+
+  /** Best-effort Android voluntary run-limit handling, after native teardown attempts.
+   * Does not certify AMS teardown, task completion or JavaScript cancellation. */
+  FG_RUN_LIMIT_REACHED = 10,
 }
 
 /**
@@ -436,6 +440,15 @@ export enum EventType {
  * View the [Events](/react-native/events) documentation to learn more.
  */
 export interface EventDetail {
+  /** Native handling of an accepted voluntary expiry; no delivery guarantee. */
+  foregroundServiceRunLimit?: {
+    requestedDurationMs: number;
+    deadlineElapsed: number;
+    deliveredElapsed: number;
+    demotion: 'returned' | 'failed';
+    conditionalStop: 'accepted' | 'refused' | 'deferred' | 'failed';
+  };
+
   /**
    * The notification this event relates to.
    *

package/src/types/NotificationAndroid.ts

@@ -39,6 +39,16 @@ export interface NotificationAndroid {
    */
   asForegroundService?: boolean;
 
+  /**
+   * Best-effort attempt to demote (REMOVE) and stop a single dataSync foreground run.
+   * Android API 35+ only. Disabled when undefined. Integer milliseconds, 60,000–18,000,000.
+   * Measured from the first successful promotion using elapsed realtime, including sleep.
+   * Same-ID updates do not extend the deadline; changing/enabling it requires a new run.
+   * Inexact alarms may arrive minutes late or never. A resolved displayNotification Promise
+   * does not confirm scheduling. This does not cancel JavaScript or application work.
+   */
+  foregroundServiceBestEffortStopAfterMs?: number;
+
   /**
    * When set to `true` the screen will light up when the notification is displayed.
    *

package/src/validators/validateAndroidNotification.ts

@@ -1,7 +1,7 @@
 /*
  * Copyright (c) 2016-present Invertase Limited
  */
-import { Image } from 'react-native';
+import { Image, Platform } from 'react-native';
 
 import {
   objectHasProperty,
@@ -126,6 +126,31 @@ export default function validateAndroidNotification(
     out.asForegroundService = android.asForegroundService;
   }
 
+  const runLimit = android.foregroundServiceBestEffortStopAfterMs;
+  if (!isUndefined(runLimit)) {
+    const path = "'notification.android.foregroundServiceBestEffortStopAfterMs'";
+    if (!Number.isSafeInteger(runLimit) || runLimit < 60000 || runLimit > 18000000) {
+      throw new Error(`${path} expected a safe integer between 60000 and 18000000 milliseconds.`);
+    }
+    if (!out.asForegroundService) {
+      throw new Error(`${path} requires asForegroundService: true.`);
+    }
+    if (Platform.OS === 'android' && Number(Platform.Version) < 35) {
+      throw new Error(`${path} requires Android API 35+.`);
+    }
+    if (
+      android.foregroundServiceTypes !== undefined &&
+      (!isArray(android.foregroundServiceTypes) ||
+        android.foregroundServiceTypes.length !== 1 ||
+        android.foregroundServiceTypes[0] !==
+          AndroidForegroundServiceType.FOREGROUND_SERVICE_TYPE_DATA_SYNC)
+    ) {
+      throw new Error(`${path} requires a single dataSync foreground service type.`);
+    }
+    // An omitted type is resolved and checked against the merged manifest before native START.
+    out.foregroundServiceBestEffortStopAfterMs = runLimit;
+  }
+
   /**
    * foregroundServiceBehavior
    */
@@ -341,6 +366,11 @@ export default function validateAndroidNotification(
 
     if (isNumber(android.largeIcon) || isObject(android.largeIcon)) {
       const image = Image.resolveAssetSource(android.largeIcon);
+      if (!image || !isString(image.uri) || /^[\s\u0085]*$/.test(image.uri)) {
+        throw new Error(
+          "'notification.android.largeIcon' expected a React Native ImageResource value or a valid string URL.",
+        );
+      }
       out.largeIcon = image.uri;
     } else {
       out.largeIcon = android.largeIcon;

package/src/validators/validateAndroidStyle.ts

@@ -36,7 +36,11 @@ export function validateAndroidBigPictureStyle(
 
   if (isNumber(style.picture) || isObject(style.picture)) {
     const image = Image.resolveAssetSource(style.picture);
-
+    if (!image || !isString(image.uri) || /^[\s\u0085]*$/.test(image.uri)) {
+      throw new Error(
+        "'notification.android.style' BigPictureStyle: 'picture' expected a number or object created using the 'require()' method or a valid string URL.",
+      );
+    }
     out.picture = image.uri;
   }
 
@@ -53,7 +57,11 @@ export function validateAndroidBigPictureStyle(
     }
     if (isNumber(style.largeIcon) || isObject(style.largeIcon)) {
       const image = Image.resolveAssetSource(style.largeIcon);
-
+      if (!image || !isString(image.uri) || /^[\s\u0085]*$/.test(image.uri)) {
+        throw new Error(
+          "'notification.android.style' BigPictureStyle: 'largeIcon' expected a React Native ImageResource value or a valid string URL.",
+        );
+      }
       out.largeIcon = image.uri;
     } else {
       out.largeIcon = style.largeIcon;

package/src/validators/validateIOSAttachment.ts

@@ -2,7 +2,6 @@
  * Copyright (c) 2016-present Invertase Limited
  */
 
-// @ts-ignore
 import { Image } from 'react-native';
 
 import {
@@ -42,6 +41,11 @@ export default function validateIOSAttachment(
 
   if (isNumber(attachment.url) || isObject(attachment.url)) {
     const image = Image.resolveAssetSource(attachment.url);
+    if (!image || !isString(image.uri) || /^[\s\u0085]*$/.test(image.uri)) {
+      throw new Error(
+        "'attachment.url' expected a React Native ImageResource value or a valid string URL.",
+      );
+    }
     out.url = image.uri;
   }
 

package/src/version.ts

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '10.8.1';
+export const version = '10.9.0';