@condorinst/mobile-bridge 0.17.0 → 0.18.0

package/dist/index.d.ts

@@ -82,6 +82,49 @@ interface DevPanelOptions {
     autoRespondDelayMs?: number;
 }
 
+/**
+ * Detecção do host nativo + adapter pattern.
+ *
+ * **v0.1.0:** lançava erro quando `window.flutter_inappwebview` ausente.
+ * **v0.2.0:** ativa mock adapter (`createMockAdapter`) — destrava dev em
+ * browser comum sem buildar APK.
+ * **v0.18.0:** canal `window.CondorNative` (JavaScript channel do
+ * `webview_flutter`) — detectado **antes** do `flutter_inappwebview`, que
+ * segue suportado por transição. O canal só aceita string: a mensagem vai
+ * serializada em JSON. E o gancho `setOutgoingStamp` permite ao shell
+ * carimbar toda mensagem de saída (ex.: nonce da Camada 3) sem monkey-patch
+ * do host.
+ *
+ * Adapter ativo é cached na primeira chamada de `getActiveAdapter()`.
+ * Tests devem chamar `__resetAdapterForTests()` no `beforeEach` para
+ * forçar re-detecção (ex.: após instalar/remover `window.CondorNative`).
+ */
+
+/**
+ * Nome do JavaScript channel registrado pelo nativo
+ * (`WebViewController.addJavaScriptChannel`). Não pode ser `CondorBridge`: o
+ * plugin publica o canal como `window.<nome>`, o que colidiria com o emitter
+ * `window.CondorBridge` instalado por este SDK.
+ */
+declare const NATIVE_CHANNEL_NAME = "CondorNative";
+interface FlutterInAppWebView {
+    callHandler(name: string, ...args: unknown[]): Promise<unknown>;
+}
+interface NativeChannel {
+    postMessage(message: string): void;
+}
+declare global {
+    interface Window {
+        flutter_inappwebview?: FlutterInAppWebView;
+        CondorNative?: NativeChannel;
+    }
+}
+/**
+ * Transforma toda mensagem JS → Native imediatamente antes do envio.
+ * Recebe e devolve o envelope `{type, version, payload}`.
+ */
+type OutgoingStamp = (message: Record<string, unknown>) => Record<string, unknown>;
+
 /**
  * Catálogo das chaves do bridge JS↔Native.
  *
@@ -132,7 +175,8 @@ type BridgeKey = (typeof BRIDGE_KEYS)[keyof typeof BRIDGE_KEYS];
  */
 /**
  * Mensagem JS → Native, enviada via
- * `window.flutter_inappwebview.callHandler('CondorBridge', msg)`.
+ * `window.CondorNative.postMessage(JSON.stringify(msg))` (v0.18.0+) ou, no
+ * host legado, `window.flutter_inappwebview.callHandler('CondorBridge', msg)`.
  */
 interface BridgeIncomingMessage {
     type: string;
@@ -562,8 +606,8 @@ interface MockState {
 interface CondorBridge {
     /**
      * `true` quando o adapter ativo é mock (browser dev, sem
-     * `window.flutter_inappwebview`). `false` quando rodando dentro do
-     * WebView Flutter.
+     * `window.CondorNative` nem `window.flutter_inappwebview`). `false` quando
+     * rodando dentro do WebView Flutter.
      */
     readonly isMock: boolean;
     /**
@@ -598,6 +642,16 @@ interface CondorBridge {
      * `Bridge.send('openSettings')`.
      */
     openSettings(): void;
+    /**
+     * Registra uma transformação aplicada a **toda** mensagem JS → Native
+     * (`handshake` inclusive) imediatamente antes do envio. `null` remove.
+     *
+     * Existe para o shell carimbar o nonce da Camada 3
+     * (`payload._shellNonce`) num ponto único — antes da 0.18.0 isso exigia
+     * monkey-patch de `flutter_inappwebview.callHandler`, que não existe no
+     * canal `CondorNative`. Código de cliente não deve usar.
+     */
+    setOutgoingStamp(stamp: OutgoingStamp | null): void;
     /**
      * Dispara `window.CondorBridge.emit(key, payload)` programaticamente —
      * útil para simular eventos nativos em testes e dev em browser.
@@ -770,6 +824,7 @@ declare const ClientToShellMessage: v.VariantSchema<"type", [v.ObjectSchema<{
     readonly type: v.LiteralSchema<"sandbox-verify-response", undefined>;
     readonly flutterBridgeReachable: v.BooleanSchema<undefined>;
     readonly condorBridgeReachable: v.BooleanSchema<undefined>;
+    readonly nativeChannelReachable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
 }, undefined>], undefined>;
 type ClientToShellMessage = v.InferOutput<typeof ClientToShellMessage>;
 declare const ShellToClientMessage: v.VariantSchema<"type", [v.ObjectSchema<{
@@ -841,6 +896,8 @@ interface ConfirmationRequest {
 interface SandboxVerifyResult {
     flutterBridgeReachable: boolean;
     condorBridgeReachable: boolean;
+    /** `window.CondorNative` visível no iframe (v0.18.0). */
+    nativeChannelReachable: boolean;
     ok: boolean;
 }
 
@@ -967,4 +1024,4 @@ declare class BridgeShell {
     private postToClient;
 }
 
-export { type AutoRespondResponse, BRIDGE_KEYS, Bridge, BridgeClient, type BridgeClientHandshakeAck, type BridgeIncomingMessage, type BridgeKey, type BridgeOutgoingEvent, BridgeShell, type BridgeShellOptions, ClientToShellMessage, type CondorBridge, type CondorBridgeClient, type ConfirmationRequest, type DeleteMemoryAckPayload, type DevPanelOptions, type DeviceConnectionPayload, type DeviceLightSensorsPayload, type DeviceNotificationPayload, type HandshakeAck, type HandshakeOptions, type KeyPayloads, type LanguagePayload, type LightSensorsActlumus1Data, type LightSensorsActlumus2Data, type LightSensorsRawChannels, type MockMessage, type MockState, type PayloadOf, type PingPongPayload, type RealTimeAckPayload, type RequestPermissionPayload, type SandboxVerifyResult, type SensorLogPayload, type SensorLogQueryPayload, type ShellPolicy, ShellToClientMessage, type SyncTimeAckPayload, type SystemStatusPayload, type UserDevicePayload };
+export { type AutoRespondResponse, BRIDGE_KEYS, Bridge, BridgeClient, type BridgeClientHandshakeAck, type BridgeIncomingMessage, type BridgeKey, type BridgeOutgoingEvent, BridgeShell, type BridgeShellOptions, ClientToShellMessage, type CondorBridge, type CondorBridgeClient, type ConfirmationRequest, type DeleteMemoryAckPayload, type DevPanelOptions, type DeviceConnectionPayload, type DeviceLightSensorsPayload, type DeviceNotificationPayload, type HandshakeAck, type HandshakeOptions, type KeyPayloads, type LanguagePayload, type LightSensorsActlumus1Data, type LightSensorsActlumus2Data, type LightSensorsRawChannels, type MockMessage, type MockState, NATIVE_CHANNEL_NAME, type OutgoingStamp, type PayloadOf, type PingPongPayload, type RealTimeAckPayload, type RequestPermissionPayload, type SandboxVerifyResult, type SensorLogPayload, type SensorLogQueryPayload, type ShellPolicy, ShellToClientMessage, type SyncTimeAckPayload, type SystemStatusPayload, type UserDevicePayload };

package/dist/index.js

@@ -430,8 +430,22 @@ function createMockAdapter() {
 }
 
 // src/internal/native.ts
+var NATIVE_CHANNEL_NAME = "CondorNative";
+var outgoingStamp = null;
+function setOutgoingStamp(stamp) {
+  outgoingStamp = stamp;
+}
 var activeAdapter = null;
-function createRealAdapter(host) {
+function createChannelAdapter(channel) {
+  return {
+    isMock: false,
+    // Canal único: o `handlerName` não viaja — o nativo roteia por `type`.
+    callHandler(_handlerName, payload) {
+      channel.postMessage(JSON.stringify(payload));
+    }
+  };
+}
+function createLegacyAdapter(host) {
   return {
     isMock: false,
     callHandler(handlerName, payload) {
@@ -443,9 +457,13 @@ function detectAdapter() {
   if (typeof window === "undefined") {
     return createMockAdapter();
   }
+  const channel = window.CondorNative;
+  if (channel && typeof channel.postMessage === "function") {
+    return createChannelAdapter(channel);
+  }
   const host = window.flutter_inappwebview;
   if (host && typeof host.callHandler === "function") {
-    return createRealAdapter(host);
+    return createLegacyAdapter(host);
   }
   return createMockAdapter();
 }
@@ -456,7 +474,8 @@ function getActiveAdapter() {
   return activeAdapter;
 }
 function callNative(handlerName, payload) {
-  getActiveAdapter().callHandler(handlerName, payload);
+  const stamped = outgoingStamp ? outgoingStamp(payload) : payload;
+  getActiveAdapter().callHandler(handlerName, stamped);
 }
 
 // src/internal/subscribers.ts
@@ -572,6 +591,9 @@ var Bridge = {
   openSettings() {
     this.send("openSettings");
   },
+  setOutgoingStamp(stamp) {
+    setOutgoingStamp(stamp);
+  },
   mockEmit(key, payload) {
     requireMockAdapter().triggerEmit(key, payload ?? {});
   },
@@ -647,7 +669,8 @@ function onMessage(event) {
       postToShell({
         type: "sandbox-verify-response",
         flutterBridgeReachable: typeof w.flutter_inappwebview !== "undefined",
-        condorBridgeReachable: typeof w.CondorBridge !== "undefined"
+        condorBridgeReachable: typeof w.CondorBridge !== "undefined",
+        nativeChannelReachable: typeof w.CondorNative !== "undefined"
       });
       break;
     }
@@ -773,7 +796,9 @@ var JsErrorMessage = v.object({
 var SandboxVerifyResponseMessage = v.object({
   type: v.literal("sandbox-verify-response"),
   flutterBridgeReachable: v.boolean(),
-  condorBridgeReachable: v.boolean()
+  condorBridgeReachable: v.boolean(),
+  // Opcional: clientes com SDK < 0.18.0 não enviam.
+  nativeChannelReachable: v.optional(v.boolean())
 });
 var ClientToShellMessage = v.variant("type", [
   SubscribeMessage,
@@ -828,6 +853,7 @@ var OVERRIDE_PREFIX = `<script>
 (function(){
   try { delete window.flutter_inappwebview; } catch (_) {}
   try { delete window.CondorBridge; } catch (_) {}
+  try { delete window.CondorNative; } catch (_) {}
   try {
     Object.defineProperty(window, 'flutter_inappwebview', {
       get: function(){ return undefined; },
@@ -835,6 +861,13 @@ var OVERRIDE_PREFIX = `<script>
       configurable: false,
     });
   } catch (_) {}
+  try {
+    Object.defineProperty(window, 'CondorNative', {
+      get: function(){ return undefined; },
+      set: function(_){ /* no-op: bloqueia o canal do webview_flutter no iframe */ },
+      configurable: false,
+    });
+  } catch (_) {}
   try {
     Object.defineProperty(window, 'CondorBridge', {
       get: function(){ return undefined; },
@@ -915,10 +948,12 @@ var BridgeShell = class {
             if (pending) {
               clearTimeout(pending.timer);
               this.pendingVerifies.delete(first);
-              const ok = !msg.flutterBridgeReachable && !msg.condorBridgeReachable;
+              const nativeChannelReachable = msg.nativeChannelReachable ?? false;
+              const ok = !msg.flutterBridgeReachable && !msg.condorBridgeReachable && !nativeChannelReachable;
               pending.resolve({
                 flutterBridgeReachable: msg.flutterBridgeReachable,
                 condorBridgeReachable: msg.condorBridgeReachable,
+                nativeChannelReachable,
                 ok
               });
             }
@@ -1106,6 +1141,7 @@ export {
   BRIDGE_KEYS,
   Bridge,
   BridgeClient,
-  BridgeShell
+  BridgeShell,
+  NATIVE_CHANNEL_NAME
 };
 //# sourceMappingURL=index.js.map