Bridge reference

The Bridge exposes window.PWA2APP to your page, on your allowed origin. The @pwa2app/bridge SDK wraps it with types and web fallbacks.

Optional features

A method tied to a feature only exists if it is enabled in the application's configuration; otherwise the call returns NOT_ENABLED.

camera photos location files clipboard notifications biometric vibration

Methods

Method	Feature	Calls/s	Parameters	Result
`bridge.handshake`	always available	5	—	protocol_versions, runtime_version, platform, enabled_features
`device.info`	always available	5	—	platform, os_version, sdk_int, manufacturer, model, app_version, runtime_version
`device.vibrate`	`vibration`	5	`pattern : array ≤ 20 éléments`	—
`network.status`	always available	5	—	online, type
`app.version`	always available	5	—	version_name, version_code
`app.openSettings`	always available	2	—	—
`app.exit`	always available	1	—	—
`statusBar.setStyle`	always available	5	`style : "light" \| "dark"`	—
`statusBar.setColor`	always available	5	`color : string`	—
`haptics.impact`	always available	10	`style : "light" \| "medium" \| "heavy"`	—
`share.share`	always available	2	`title : string ≤ 200 car.` `text : string ≤ 5000 car.` `url : string ≤ 2000 car.`	shared
`clipboard.readText`	`clipboard`	1	—	text
`clipboard.writeText`	`clipboard`	5	`text : string ≤ 100000 car.`	—
`location.getCurrent`	`location`	2	`precision : "approximate" \| "precise"` `timeout_ms : integer [1000…60000]`	lat, lng, accuracy_m, timestamp
`location.watch`	`location`	1	`precision : "approximate" \| "precise"` `interval_ms : integer [1000…600000]`	watch_id
`location.clearWatch`	`location`	5	`watch_id : string`	—
`camera.capture`	`camera`	2	`quality : number [0.1…1]` `max_size_px : integer [200…4096]`	mime, data_base64, width, height, size
`camera.pickImage`	`photos`	2	`quality : number [0.1…1]` `max_size_px : integer [200…4096]`	mime, data_base64, width, height, size
`files.pick`	`files`	2	`mime_types : array ≤ 10 éléments`	name, mime, size, data_base64
`files.save`	`files`	2	`name : string ≤ 100 car.` `mime : string` `data_base64 : string`	saved
`files.share`	`files`	2	`name : string ≤ 100 car.` `mime : string` `data_base64 : string`	shared
`notifications.requestPermission`	`notifications`	2	—	granted
`notifications.getToken`	`notifications`	2	—	NOT_SUPPORTED en V1 Android (FCM non embarqué)
`notifications.schedule`	`notifications`	5	`id : string` `title : string ≤ 100 car.` `body : string ≤ 500 car.` `delay_ms : integer [0…]`	id
`notifications.cancel`	`notifications`	5	`id : string`	—
`biometric.isAvailable`	`biometric`	2	—	available
`biometric.authenticate`	`biometric`	1	`reason : string ≤ 200 car.`	authenticated

Bridge error codes

NOT_SUPPORTED NOT_ENABLED PERMISSION_DENIED INVALID_PARAMS ORIGIN_NOT_ALLOWED RATE_LIMITED CANCELLED TIMEOUT INTERNAL VERSION_MISMATCH

Events

network.change — { online, type } — changement de connectivité
location.update — { watch_id, lat, lng, accuracy_m, timestamp } — position d'une surveillance
notification.opened — { id } — notification locale touchée
app.resume — {} — application revenue au premier plan
app.pause — {} — application passée en arrière-plan

Example

import { PWA2APP } from "@pwa2app/bridge";

if (PWA2APP.isNative()) {
  const position = await PWA2APP.location.getCurrent({ precision: "approximate" });
  console.log(position.lat, position.lng);
}

SDK: bridge/javascript folder of the project; in a regular browser, functions with a web equivalent use it.