@pmate/bridge 0.1.8 → 0.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmate/bridge",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "files": [
     "src",
     "global.d.ts"

package/src/index.ts

@@ -3,6 +3,8 @@ export * from "./SafeAreaVarsProvider"
 export * from "./hooks"
 export {
   openApp,
+  getPendingAppOpen,
+  onAppOpenRequested,
   cancelAlarm,
   cancelAllAlarms,
   connectBluetoothDevice,

package/src/internal.ts

@@ -253,5 +253,26 @@ export async function openApp(options: import("./types").OpenAppOptions): Promis
   if ((url.protocol !== "https:" && !(local && url.protocol === "http:")) || url.username || url.password) {
     return Promise.reject(new Error("App URL must use HTTPS (or loopback HTTP) without credentials"))
   }
-  return requireBridge<import("./types").OpenAppResult>("container.openApp", { url: url.href })
+  const notificationId = options.notificationId
+  if (notificationId !== undefined && (!notificationId || notificationId.length > 512)) throw new Error("Invalid notification ID")
+  const result = await requireBridge<import("./types").OpenAppResult>("container.openApp", { url: url.href, ...(notificationId === undefined ? {} : { notificationId }) })
+  if (result?.opened !== true) throw new Error("Native app opening was not confirmed")
+  return result
+}
+
+/** Available only to a native host's designated launcher. Older hosts reject it. */
+export async function getPendingAppOpen(): Promise<import("./types").AppOpenIntent | null> {
+  const result = await requireBridge<import("./types").AppOpenIntent | null>("container.getPendingAppOpen")
+  if (result === null) return null
+  if (!result || typeof result.appId !== "string" || !result.appId || result.appId.length > 128
+    || typeof result.notificationId !== "string" || !result.notificationId || result.notificationId.length > 512
+    || typeof result.origin !== "string" || result.origin.length > 2048) throw new Error("Invalid application notification")
+  const origin = new URL(result.origin)
+  if (origin.protocol !== "https:" || origin.username || origin.password || origin.pathname !== "/" || origin.search || origin.hash) throw new Error("Invalid application notification origin")
+  return { appId: result.appId, notificationId: result.notificationId, origin: origin.origin }
+}
+
+/** A hint to re-read the pending intent; the event itself never supplies a URL to open. */
+export function onAppOpenRequested(handler: () => void): () => void {
+  return hasWindow() ? (window as PmateWindow).PmateBridge?.on?.("container.appOpenRequested", handler) ?? (() => {}) : () => {}
 }

package/src/types.ts

@@ -209,5 +209,7 @@ export interface BluetoothDataEvent {
 }
 
 /** Opens a separate native WebView. The caller resolves the app URL via the apps API. */
-export interface OpenAppOptions { url: string }
+export interface OpenAppOptions { url: string; notificationId?: string }
 export interface OpenAppResult { opened: true }
+/** Destination only; notification content is delivered to the target app after authentication. */
+export interface AppOpenIntent { appId: string; notificationId: string; origin: string }