@pmate/bridge 0.1.5 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmate/bridge",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "files": [
     "src",
     "global.d.ts"
@@ -15,11 +15,11 @@
     }
   },
   "devDependencies": {
-    "@types/react": "catalog:",
-    "react": "catalog:"
+    "@types/react": "^19.2.7",
+    "react": "^19.1.1"
   },
   "main": "src/index.ts",
   "exports": {
     ".": "./src/index.ts"
   }
-}
+}

package/src/PmateBridgeProvider.tsx

@@ -2,6 +2,8 @@ import { PropsWithChildren, ReactNode, useEffect, useMemo, useState } from "reac
 import { PmateBridgeContext } from "./context"
 import {
   getFallbackSafeInsets,
+  getNotificationStatus,
+  getPushToken,
   pickFileBridge,
   readDeviceInfo,
   readIsPmate,
@@ -84,6 +86,8 @@ export function PmateBridgeProvider({
       safeInsetsState,
       deviceInfoState,
       requestPermissions: requestPermissionsBridge,
+      getNotificationStatus,
+      getPushToken,
       pickFile: pickFileBridge,
     }),
     [deviceInfoState, isPmate, safeInsetsState]

package/src/context.tsx

@@ -1,8 +1,11 @@
 import { createContext, useContext } from "react"
 import type {
   DeviceInfoState,
+  NotificationStatus,
   PermissionResult,
   PickedFile,
+  PushTokenInfo,
+  PushTokenOptions,
   SafeInsetsState,
 } from "./types"
 
@@ -11,6 +14,8 @@ export interface PmateBridgeContextValue {
   safeInsetsState: SafeInsetsState
   deviceInfoState: DeviceInfoState
   requestPermissions: (permissions: string[]) => Promise<PermissionResult>
+  getNotificationStatus: () => Promise<NotificationStatus>
+  getPushToken: (options?: PushTokenOptions) => Promise<PushTokenInfo | undefined>
   pickFile: () => Promise<PickedFile[]>
 }
 

package/src/hooks.ts

@@ -2,13 +2,15 @@ import { useCallback, useEffect, useState } from "react"
 import { useOptionalPmateBridgeContext } from "./context"
 import {
   getFallbackSafeInsets,
+  getNotificationStatus,
+  getPushToken,
   pickFileBridge,
   readDeviceInfo,
   readIsPmate,
   readSafeInsets,
   requestPermissionsBridge,
 } from "./internal"
-import type { DeviceInfoState, SafeInsetsState } from "./types"
+import type { DeviceInfoState, PushTokenOptions, SafeInsetsState } from "./types"
 
 export function useIsPmate() {
   return useOptionalPmateBridgeContext()?.isPmate ?? readIsPmate()
@@ -93,3 +95,19 @@ export function useRequestPermissions() {
     [context]
   )
 }
+
+export function useNotificationStatus() {
+  const context = useOptionalPmateBridgeContext()
+  return useCallback(
+    () => context?.getNotificationStatus() ?? getNotificationStatus(),
+    [context]
+  )
+}
+
+export function useGetPushToken() {
+  const context = useOptionalPmateBridgeContext()
+  return useCallback(
+    (options?: PushTokenOptions) => context?.getPushToken(options) ?? getPushToken(options),
+    [context]
+  )
+}

package/src/index.ts

@@ -2,15 +2,24 @@ export * from "./PmateBridgeProvider"
 export * from "./SafeAreaVarsProvider"
 export * from "./hooks"
 export {
+  cancelAlarm,
+  cancelAllAlarms,
   connectBluetoothDevice,
   disconnectBluetoothDevice,
+  getAlarm,
+  getAlarmCapabilities,
   getBluetoothCapabilities,
   getConnectedBluetoothDevices,
   getNotificationStatus,
   getPushToken,
+  isAndroidDevice,
+  isIOSDevice,
+  listAlarms,
+  onAlarmEvent,
   onBluetoothEvent,
   readBluetooth,
   requestBluetoothPermission,
+  scheduleAlarm,
   scanBluetoothDevices,
   stopBluetoothScan,
   subscribeBluetooth,

package/src/internal.ts

@@ -1,4 +1,7 @@
 import type {
+  Alarm,
+  AlarmCapabilities,
+  AlarmEventName,
   BluetoothCapabilities,
   BluetoothConnectOptions,
   BluetoothConnection,
@@ -18,6 +21,7 @@ import type {
   PushTokenInfo,
   PushTokenOptions,
   SafeInsets,
+  ScheduleAlarmInput,
 } from "./types"
 
 type PmateWindow = Window & {
@@ -43,6 +47,18 @@ export function readIsPmate() {
   return hasWindow() && !!(window as PmateWindow).isPmate
 }
 
+function normalizedPlatform(info?: Pick<DeviceInfo, "platform"> | null) {
+  return info?.platform?.trim().toLowerCase() ?? ""
+}
+
+export function isAndroidDevice(info?: Pick<DeviceInfo, "platform"> | null) {
+  return normalizedPlatform(info) === "android"
+}
+
+export function isIOSDevice(info?: Pick<DeviceInfo, "platform"> | null) {
+  return normalizedPlatform(info) === "ios"
+}
+
 async function callBridge<T>(functionName: string, params?: unknown): Promise<T | undefined> {
   try {
     return await (window as PmateWindow).PmateBridge?.call<T>(functionName, params)
@@ -112,7 +128,10 @@ export async function getNotificationStatus(): Promise<NotificationStatus> {
 export async function getPushToken(
   options?: PushTokenOptions
 ): Promise<PushTokenInfo | undefined> {
-  return callBridge<PushTokenInfo>("notification.getPushToken", options ?? null)
+  if (!hasWindow() || !(window as PmateWindow).PmateBridge?.call) {
+    return undefined
+  }
+  return requireBridge<PushTokenInfo>("notification.getPushToken", options ?? null)
 }
 
 export async function pickFileBridge(): Promise<PickedFile[]> {
@@ -120,6 +139,50 @@ export async function pickFileBridge(): Promise<PickedFile[]> {
   return files ?? []
 }
 
+export async function getAlarmCapabilities(): Promise<AlarmCapabilities> {
+  const capabilities = await callBridge<AlarmCapabilities>("alarm.getCapabilities")
+  return (
+    capabilities ?? {
+      supported: false,
+      systemAlarm: false,
+      appAlarm: false,
+      exact: false,
+      repeating: false,
+      notificationPermission: "unsupported",
+    }
+  )
+}
+
+export function scheduleAlarm(input: ScheduleAlarmInput): Promise<Alarm> {
+  return requireBridge<Alarm>("alarm.schedule", input)
+}
+
+export async function getAlarm(id: string): Promise<Alarm | undefined> {
+  return callBridge<Alarm>("alarm.get", { id })
+}
+
+export function listAlarms(): Promise<{ alarms: Alarm[] }> {
+  return requireBridge<{ alarms: Alarm[] }>("alarm.list")
+}
+
+export function cancelAlarm(id: string): Promise<{ cancelled: true }> {
+  return requireBridge<{ cancelled: true }>("alarm.cancel", { id })
+}
+
+export function cancelAllAlarms(): Promise<{ cancelled: true }> {
+  return requireBridge<{ cancelled: true }>("alarm.cancelAll")
+}
+
+export function onAlarmEvent(
+  eventName: AlarmEventName,
+  handler: (payload: unknown) => void
+): () => void {
+  if (!hasWindow() || !(window as PmateWindow).PmateBridge?.on) {
+    throw new Error("Pmate bridge event subscription is unavailable")
+  }
+  return (window as PmateWindow).PmateBridge!.on!(`alarm.${eventName}`, handler)
+}
+
 export function getBluetoothCapabilities(): Promise<BluetoothCapabilities> {
   return requireBridge<BluetoothCapabilities>("bluetooth.getCapabilities")
 }

package/src/types.ts

@@ -17,6 +17,7 @@ export interface DeviceInfo {
   systemVersion: string
   model: string
   idiom: string
+  manufacturer?: string
 }
 
 export interface DeviceInfoState {
@@ -61,6 +62,59 @@ export interface PushTokenOptions {
   providers?: PushProvider[]
 }
 
+export type AlarmDeliveryMode = "systemAlarm" | "appAlarm"
+export type AlarmDeliveryPreference =
+  | "preferSystemAlarm"
+  | "preferAppAlarm"
+  | "systemAlarmOnly"
+export type AlarmPermissionState =
+  | "granted"
+  | "denied"
+  | "notDetermined"
+  | "unsupported"
+export type AlarmRepeatRule =
+  | { type: "none" }
+  | { type: "interval"; intervalMs: number }
+  | { type: "daily"; timeOfDay: string; timezone?: string }
+export type AlarmState = "scheduled" | "triggered" | "cancelled"
+export type AlarmEventName = "triggered" | "cancelled" | "error"
+
+export interface AlarmCapabilities {
+  supported: boolean
+  systemAlarm: boolean
+  appAlarm: boolean
+  exact: boolean
+  repeating: boolean
+  notificationPermission: AlarmPermissionState
+  minimumIntervalMs?: number
+  maximumScheduledCount?: number
+}
+
+export interface Alarm {
+  id: string
+  title?: string
+  body?: string
+  deliveryMode: AlarmDeliveryMode
+  scheduledAt: number
+  repeat: AlarmRepeatRule
+  payload?: Record<string, unknown>
+  state: AlarmState
+  createdAt: number
+  updatedAt: number
+  lastTriggeredAt?: number
+  nextTriggerAt?: number
+}
+
+export interface ScheduleAlarmInput {
+  id?: string
+  title?: string
+  body?: string
+  scheduledAt: number
+  repeat?: AlarmRepeatRule
+  deliveryPreference?: AlarmDeliveryPreference
+  payload?: Record<string, unknown>
+}
+
 export type BluetoothTransport = "ble" | "classic"
 export type BluetoothBinaryEncoding = "base64" | "hex" | "utf-8"
 export type BluetoothEventName =