@rodrigocoliveira/mobile-app-bridge 0.1.0

package/dist/web/index.js

@@ -0,0 +1,112 @@
+import {
+  BRIDGE_EVENT,
+  DEFAULT_TIMEOUT,
+  ErrorCode,
+  isBridgeMessage
+} from "../chunk-SEQSUJLW.js";
+
+// src/web/errors.ts
+var BridgeError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "BridgeError";
+    this.code = code;
+  }
+};
+
+// src/web/client.ts
+function createBridgeClient(getWindow) {
+  const pending = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Map();
+  let attachedTo;
+  let counter = 0;
+  function appWindow() {
+    const win = getWindow();
+    return win?.ReactNativeWebView ? win : void 0;
+  }
+  function handle(detail) {
+    if (!isBridgeMessage(detail)) return;
+    if (detail.kind === "evt") {
+      const subscribers = listeners.get(detail.name);
+      if (subscribers) for (const listener of [...subscribers]) listener(detail.data);
+      return;
+    }
+    if (detail.kind !== "res") return;
+    const entry = pending.get(detail.id);
+    if (!entry) return;
+    pending.delete(detail.id);
+    if (entry.timer !== void 0) clearTimeout(entry.timer);
+    if (detail.ok) entry.resolve(detail.result);
+    else entry.reject(new BridgeError(detail.error.code, detail.error.message));
+  }
+  function attach(win) {
+    if (attachedTo === win) return;
+    attachedTo = win;
+    win.addEventListener(BRIDGE_EVENT, (event) => handle(event.detail));
+  }
+  function nextId() {
+    return globalThis.crypto?.randomUUID?.() ?? `${Date.now().toString(36)}-${(counter++).toString(36)}`;
+  }
+  return {
+    get isApp() {
+      return appWindow() !== void 0;
+    },
+    get info() {
+      return appWindow()?.__MOBILE_APP_BRIDGE__ ?? null;
+    },
+    call(method, params, callOptions = {}) {
+      const win = appWindow();
+      if (!win?.ReactNativeWebView) {
+        return Promise.reject(new BridgeError(ErrorCode.NOT_IN_APP, `Cannot call "${method}" outside the mobile app`));
+      }
+      attach(win);
+      const id = nextId();
+      const request = { bridge: 1, kind: "req", id, method };
+      if (params !== void 0) request.params = params;
+      let payload;
+      try {
+        payload = JSON.stringify(request);
+      } catch {
+        return Promise.reject(new BridgeError(ErrorCode.INVALID_PARAMS, `Params for "${method}" are not JSON-serializable`));
+      }
+      const timeout = callOptions.timeout ?? DEFAULT_TIMEOUT;
+      const postMessage = win.ReactNativeWebView.postMessage.bind(win.ReactNativeWebView);
+      return new Promise((resolve, reject) => {
+        const timer = timeout > 0 ? setTimeout(() => {
+          if (pending.delete(id)) {
+            reject(new BridgeError(ErrorCode.TIMEOUT, `"${method}" did not respond within ${timeout}ms`));
+          }
+        }, timeout) : void 0;
+        pending.set(id, { resolve, reject, timer });
+        postMessage(payload);
+      });
+    },
+    on(name, listener) {
+      const win = appWindow();
+      if (win) attach(win);
+      let subscribers = listeners.get(name);
+      if (!subscribers) {
+        subscribers = /* @__PURE__ */ new Set();
+        listeners.set(name, subscribers);
+      }
+      const typed = listener;
+      subscribers.add(typed);
+      return () => {
+        subscribers.delete(typed);
+      };
+    }
+  };
+}
+
+// src/web/index.ts
+var bridge = createBridgeClient(
+  () => typeof window === "undefined" ? void 0 : window
+);
+export {
+  BridgeError,
+  ErrorCode,
+  bridge,
+  createBridgeClient
+};
+//# sourceMappingURL=index.js.map

package/dist/web/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/web/errors.ts","../../src/web/client.ts","../../src/web/index.ts"],"sourcesContent":["export class BridgeError extends Error {\n  readonly code: string\n\n  constructor(code: string, message: string) {\n    super(message)\n    this.name = 'BridgeError'\n    this.code = code\n  }\n}\n","import {\n  BRIDGE_EVENT,\n  DEFAULT_TIMEOUT,\n  ErrorCode,\n  isBridgeMessage,\n  type AppInfo,\n  type RequestMessage,\n} from '../shared/protocol'\nimport { BridgeError } from './errors'\n\nexport interface BridgeWindow {\n  __MOBILE_APP_BRIDGE__?: AppInfo\n  ReactNativeWebView?: { postMessage(message: string): void }\n  addEventListener(type: string, listener: (event: Event) => void): void\n}\n\nexport interface CallOptions {\n  /** Milliseconds to wait for the native response. Defaults to 30s; 0 disables the timeout. */\n  timeout?: number\n}\n\nexport interface BridgeClient {\n  readonly isApp: boolean\n  readonly info: AppInfo | null\n  call<T = unknown>(method: string, params?: unknown, options?: CallOptions): Promise<T>\n  on<T = unknown>(name: string, listener: (data: T) => void): () => void\n}\n\ninterface PendingCall {\n  resolve: (value: unknown) => void\n  reject: (error: BridgeError) => void\n  timer: ReturnType<typeof setTimeout> | undefined\n}\n\ntype Listener = (data: unknown) => void\n\nexport function createBridgeClient(\n  getWindow: () => BridgeWindow | undefined,\n): BridgeClient {\n  const pending = new Map<string, PendingCall>()\n  const listeners = new Map<string, Set<Listener>>()\n  let attachedTo: BridgeWindow | undefined\n  let counter = 0\n\n  /** Inside the app whenever react-native-webview's bridge object exists (same rule as the Agendart bridge). */\n  function appWindow(): BridgeWindow | undefined {\n    const win = getWindow()\n    return win?.ReactNativeWebView ? win : undefined\n  }\n\n  function handle(detail: unknown) {\n    if (!isBridgeMessage(detail)) return\n    if (detail.kind === 'evt') {\n      // Events are fire-and-forget: without a subscriber they are dropped. Anything that must not be\n      // lost (e.g. \"app opened from a notification\") is exposed as a method the page calls when ready.\n      const subscribers = listeners.get(detail.name)\n      if (subscribers) for (const listener of [...subscribers]) listener(detail.data)\n      return\n    }\n    if (detail.kind !== 'res') return\n\n    const entry = pending.get(detail.id)\n    if (!entry) return\n    pending.delete(detail.id)\n    if (entry.timer !== undefined) clearTimeout(entry.timer)\n    if (detail.ok) entry.resolve(detail.result)\n    else entry.reject(new BridgeError(detail.error.code, detail.error.message))\n  }\n\n  function attach(win: BridgeWindow) {\n    if (attachedTo === win) return\n    attachedTo = win\n    win.addEventListener(BRIDGE_EVENT, (event) => handle((event as CustomEvent).detail))\n  }\n\n  function nextId(): string {\n    return globalThis.crypto?.randomUUID?.() ?? `${Date.now().toString(36)}-${(counter++).toString(36)}`\n  }\n\n  return {\n    get isApp() {\n      return appWindow() !== undefined\n    },\n\n    get info() {\n      return appWindow()?.__MOBILE_APP_BRIDGE__ ?? null\n    },\n\n    call<T = unknown>(method: string, params?: unknown, callOptions: CallOptions = {}): Promise<T> {\n      const win = appWindow()\n      if (!win?.ReactNativeWebView) {\n        return Promise.reject(new BridgeError(ErrorCode.NOT_IN_APP, `Cannot call \"${method}\" outside the mobile app`))\n      }\n      attach(win)\n\n      const id = nextId()\n      const request: RequestMessage = { bridge: 1, kind: 'req', id, method }\n      if (params !== undefined) request.params = params\n\n      let payload: string\n      try {\n        payload = JSON.stringify(request)\n      } catch {\n        return Promise.reject(new BridgeError(ErrorCode.INVALID_PARAMS, `Params for \"${method}\" are not JSON-serializable`))\n      }\n\n      const timeout = callOptions.timeout ?? DEFAULT_TIMEOUT\n      const postMessage = win.ReactNativeWebView.postMessage.bind(win.ReactNativeWebView)\n\n      return new Promise<T>((resolve, reject) => {\n        const timer =\n          timeout > 0\n            ? setTimeout(() => {\n                if (pending.delete(id)) {\n                  reject(new BridgeError(ErrorCode.TIMEOUT, `\"${method}\" did not respond within ${timeout}ms`))\n                }\n              }, timeout)\n            : undefined\n        pending.set(id, { resolve: resolve as (value: unknown) => void, reject, timer })\n        postMessage(payload)\n      })\n    },\n\n    on<T = unknown>(name: string, listener: (data: T) => void): () => void {\n      const win = appWindow()\n      if (win) attach(win)\n\n      let subscribers = listeners.get(name)\n      if (!subscribers) {\n        subscribers = new Set()\n        listeners.set(name, subscribers)\n      }\n      const typed = listener as Listener\n      subscribers.add(typed)\n\n      return () => {\n        subscribers.delete(typed)\n      }\n    },\n  }\n}\n","import { createBridgeClient, type BridgeWindow } from './client'\n\n/** Shared client for the current page. Safe to import during SSR: it only reads `window` when used. */\nexport const bridge = createBridgeClient(() =>\n  typeof window === 'undefined' ? undefined : (window as unknown as BridgeWindow),\n)\n\nexport { createBridgeClient } from './client'\nexport type { BridgeClient, BridgeWindow, CallOptions } from './client'\nexport { BridgeError } from './errors'\nexport { ErrorCode } from '../shared/protocol'\nexport type { AppInfo } from '../shared/protocol'\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "@rodrigocoliveira/mobile-app-bridge",
+  "version": "0.1.0",
+  "description": "Promise-based bridge between a web app and the Expo WebView shell that loads it",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rodrigocoliveira/mobile-app-bridge.git"
+  },
+  "homepage": "https://github.com/rodrigocoliveira/mobile-app-bridge#readme",
+  "bugs": "https://github.com/rodrigocoliveira/mobile-app-bridge/issues",
+  "keywords": [
+    "expo",
+    "react-native",
+    "webview",
+    "bridge",
+    "postmessage"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    "./web": {
+      "import": {
+        "types": "./dist/web/index.d.ts",
+        "default": "./dist/web/index.js"
+      },
+      "require": {
+        "types": "./dist/web/index.d.cts",
+        "default": "./dist/web/index.cjs"
+      }
+    },
+    "./native": {
+      "import": {
+        "types": "./dist/native/index.d.ts",
+        "default": "./dist/native/index.js"
+      },
+      "require": {
+        "types": "./dist/native/index.d.cts",
+        "default": "./dist/native/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "bun test",
+    "check:dist": "bun run scripts/check-dist.ts",
+    "changeset": "changeset",
+    "version": "changeset version && bun install --lockfile-only",
+    "release": "bun run build && bun run check:dist && changeset publish",
+    "example:web": "bun run build && bun run example/web/serve.ts"
+  },
+  "peerDependencies": {
+    "expo-constants": ">=17",
+    "react": ">=18",
+    "react-native": ">=0.76",
+    "react-native-webview": ">=13.10"
+  },
+  "peerDependenciesMeta": {
+    "expo-constants": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    },
+    "react-native-webview": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^3.0.3",
+    "@types/bun": "^1.4.1",
+    "@types/react": "~19.2.0",
+    "expo-constants": "~57.0.20",
+    "react": "19.2.3",
+    "react-native": "0.86.3",
+    "react-native-webview": "13.16.1",
+    "tsup": "^8.5.1",
+    "typescript": "~5.9.3"
+  }
+}