@pmate/bridge 0.1.7 → 0.1.8

package/README.md

@@ -0,0 +1,10 @@
+# Native application opening
+
+The application catalog and deployment URL lookup belong to the apps API. The bridge only opens the resolved URL in a separate native WebView, leaving its caller alive.
+
+```tsx
+import { openApp, useIsPmate } from "@pmate/bridge"
+await openApp({ url: "https://issues.pmate.chat/" })
+```
+
+Requires a host implementing `container.openApp`. Resolves `{ opened: true }` after native presentation, not after page load. Rejects unsupported hosts and invalid URLs; callers must display the error. HTTPS and loopback HTTP are allowed; embedded URL credentials are rejected. No authentication token is added to the URL. Closing the child returns to its existing parent. Browser apps should use their explicit browser navigation path instead.

package/package.json

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

package/src/hooks.ts

@@ -1,6 +1,7 @@
 import { useCallback, useEffect, useState } from "react"
 import { useOptionalPmateBridgeContext } from "./context"
 import {
+  openApp,
   getFallbackSafeInsets,
   getNotificationStatus,
   getPushToken,
@@ -111,3 +112,7 @@ export function useGetPushToken() {
     [context]
   )
 }
+
+export function useOpenApp() {
+  return openApp
+}

package/src/index.ts

@@ -2,6 +2,7 @@ export * from "./PmateBridgeProvider"
 export * from "./SafeAreaVarsProvider"
 export * from "./hooks"
 export {
+  openApp,
   cancelAlarm,
   cancelAllAlarms,
   connectBluetoothDevice,

package/src/internal.ts

@@ -245,3 +245,13 @@ export function onBluetoothEvent(
   }
   return (window as PmateWindow).PmateBridge!.on!(`bluetooth.${eventName}`, handler)
 }
+
+/** Native only. Errors are surfaced; this never navigates or replaces the caller. */
+export async function openApp(options: import("./types").OpenAppOptions): Promise<import("./types").OpenAppResult> {
+  const url = new URL(options.url)
+  const local = ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname)
+  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 })
+}

package/src/types.ts

@@ -207,3 +207,7 @@ export interface BluetoothDataEvent {
   encoding: BluetoothBinaryEncoding
   receivedAt: number
 }
+
+/** Opens a separate native WebView. The caller resolves the app URL via the apps API. */
+export interface OpenAppOptions { url: string }
+export interface OpenAppResult { opened: true }