@webority/mobile-core 0.0.26 → 0.0.28

package/lib/typescript/module/push/push.d.ts

@@ -26,6 +26,42 @@ export interface PushConfig {
     /** Whether a notification shown while the app is open plays its sound. Defaults to true. */
     playSoundInForeground?: () => boolean;
 }
+/** A button on a notification category. */
+export interface PushCategoryAction {
+    id: string;
+    title: string;
+    /** Whether the tap brings the app to the foreground. Defaults to true. */
+    opensApp?: boolean;
+    /** iOS only: the title shows in red. */
+    destructive?: boolean;
+    /** Turns the button into a reply box; the text arrives as `userText`. */
+    textInput?: {
+        submitTitle: string;
+        placeholder: string;
+    };
+    /** iOS only: the phone must be unlocked before the action runs. */
+    authenticationRequired?: boolean;
+}
+/** A set of buttons a push names through its category id. */
+export interface PushCategory {
+    id: string;
+    actions: PushCategoryAction[];
+}
+/** A button tap on a notification. */
+export interface PushAction {
+    actionId: string;
+    /** What the person typed, for a `textInput` action. */
+    userText?: string;
+    data: Record<string, string>;
+    /** The notification's identifier on the phone, not a server id in `data`. */
+    notificationId: string;
+}
+export type PushActionHandler = (action: PushAction) => Promise<void> | void;
+export interface PushLocalNotification {
+    title: string;
+    body: string;
+    data?: Record<string, string>;
+}
 export type PushStatus = 'unknown' | 'granted' | 'denied' | 'unavailable';
 export interface PushState {
     status: PushStatus;
@@ -41,15 +77,31 @@ interface SubscriptionLike {
 }
 interface NotificationResponseLike {
     actionIdentifier: string;
+    userText?: string;
     notification: {
         request: {
             identifier: string;
+            /** A background task receives the raw content, where data may still be a JSON `dataString`. */
             content: {
                 data?: Record<string, unknown> | null;
+                dataString?: string;
             };
         };
     };
 }
+interface NotificationActionLike {
+    identifier: string;
+    buttonTitle: string;
+    textInput?: {
+        submitButtonTitle: string;
+        placeholder: string;
+    };
+    options: {
+        opensAppToForeground: boolean;
+        isDestructive: boolean;
+        isAuthenticationRequired: boolean;
+    };
+}
 interface DevicePushTokenLike {
     type: string;
     data: unknown;
@@ -76,10 +128,22 @@ export interface PushNotificationsLike {
         importance: number;
     }) => Promise<unknown>;
     setBadgeCountAsync: (count: number) => Promise<boolean>;
+    setNotificationCategoryAsync: (identifier: string, actions: NotificationActionLike[]) => Promise<unknown>;
+    scheduleNotificationAsync: (request: {
+        content: {
+            title: string;
+            body: string;
+            data: Record<string, string>;
+        };
+        trigger: null;
+    }) => Promise<string>;
+    registerTaskAsync: (taskName: string) => Promise<unknown>;
     AndroidImportance: {
         DEFAULT: number;
         HIGH: number;
     };
+    /** The `actionIdentifier` of a plain tap on the notification body. */
+    DEFAULT_ACTION_IDENTIFIER: string;
 }
 export interface PushModules {
     notifications: PushNotificationsLike;
@@ -92,6 +156,16 @@ export interface PushModules {
  * included. Pass `null` to restore expo-notifications.
  */
 export declare const setPushImplementation: (impl: PushModules | null) => void;
+/**
+ * The only place expo-notifications and expo-application are named. Expo Go is
+ * checked first because expo-notifications refuses remote push there and its
+ * import throws on Android. Exported for `./task`; not on the `/push` entry.
+ */
+export declare const resolveModules: () => PushModules | null;
+export declare const toPushAction: (response: NotificationResponseLike) => PushAction;
+export declare const toNotificationActions: (actions: PushCategoryAction[]) => NotificationActionLike[];
+/** The payload of the background notification task: routes button taps, ignores received pushes. */
+export declare const routeTaskPayload: (payload: unknown) => Promise<void>;
 /**
  * Wires push at startup: the foreground handler, Android channels, and tap
  * handling, including the tap that launched the app. Calling it again only
@@ -110,6 +184,20 @@ export declare const enablePush: () => Promise<"granted" | "denied" | "unavailab
 export declare const disablePush: () => Promise<void>;
 /** Sets the app icon badge; a no-op where push is unavailable or the launcher has no badge. */
 export declare const setBadgeCount: (count: number) => Promise<void>;
+/**
+ * Registers the button sets a push can name by category id. Call it at every
+ * start, with the same ids on both platforms. On Android the buttons show only
+ * on notifications expo-notifications draws, such as `notifyLocal`.
+ */
+export declare const setCategories: (categories: PushCategory[]) => Promise<void>;
+/**
+ * Handles button taps while JavaScript is running; a plain tap still goes to
+ * `onOpen`. For taps on a killed app use `definePushActionTask` from
+ * `/push/task`, which sets this handler too. Returns a function that removes it.
+ */
+export declare const onAction: (handler: PushActionHandler) => (() => void);
+/** Shows a notification from the phone itself, for example when a button's request failed. */
+export declare const notifyLocal: ({ title, body, data }: PushLocalNotification) => Promise<void>;
 /** Push status for a settings switch, re-rendering when it changes. */
 export declare const usePush: () => PushState & {
     enable: () => Promise<void>;

package/lib/typescript/module/push/task.d.ts

@@ -0,0 +1,15 @@
+import { type PushActionHandler } from './push.js';
+export type { PushAction, PushActionHandler } from './push.js';
+/**
+ * Handles notification button taps in every app state, the killed app
+ * included. Call it once at module scope in the app's entry file (index.js),
+ * before the root component registers: a tap on a killed app starts the
+ * JavaScript bundle without the UI, so nothing later in the app runs.
+ *
+ * Android runs the handler from a background notification task
+ * (expo-task-manager). iOS has no such task for button taps: it launches the
+ * app in the background and the response reaches the listener this sets up.
+ * The handler's promise is awaited, so a request it makes can finish first.
+ */
+export declare const definePushActionTask: (handler: PushActionHandler) => void;
+//# sourceMappingURL=task.d.ts.map

package/lib/typescript/module/utils/base64.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Base64 of raw bytes, for a `data:` URI. Builds a Latin-1 string a chunk at a
+ * time and hands it to the engine's native `btoa` (Hermes ships it), which is
+ * many times faster on the JS thread than encoding byte by byte in JS.
+ */
+export declare const encodeBase64: (buffer: ArrayBuffer) => string;
+//# sourceMappingURL=base64.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webority/mobile-core",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "description": "Platform layer for Webority React Native apps: HTTP clients, auth/token storage, config, logging, formatters, validators, network status, permissions, storage and version checks. No UI.",
   "keywords": [
     "react-native",
@@ -171,6 +171,16 @@
         "default": "./lib/commonjs/push/index.js"
       }
     },
+    "./push/task": {
+      "import": {
+        "types": "./lib/typescript/module/push/task.d.ts",
+        "default": "./lib/module/push/task.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/push/task.d.ts",
+        "default": "./lib/commonjs/push/task.js"
+      }
+    },
     "./smsRetriever": {
       "import": {
         "types": "./lib/typescript/module/smsRetriever/index.d.ts",
@@ -242,6 +252,7 @@
     "expo-secure-store": ">=57.0.0",
     "expo-sharing": ">=57.0.0",
     "expo-sqlite": ">=57.0.0",
+    "expo-task-manager": ">=57.0.0",
     "react": "^19.1.0",
     "react-native": ">=0.81.0"
   },
@@ -275,6 +286,9 @@
     },
     "expo-sharing": {
       "optional": true
+    },
+    "expo-task-manager": {
+      "optional": true
     }
   },
   "publishConfig": {