@condorinst/mobile-bridge 0.16.0 → 0.18.0

package/dist/index.d.cts

@@ -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;
@@ -207,6 +251,11 @@ interface UserDevicePayload {
  * defensivamente. Não são opcionais no tipo de propósito — opcional
  * esconderia o skew de versão em vez de deixá-lo explícito.
  *
+ * ⚠️ O `nativeVersion` só chega ao cliente a partir do **SDK 0.17.0**: até a
+ * `0.16.x` o shell respondia o handshake do cliente apenas com o
+ * `shellVersion`, então essa checagem era impossível de cumprir de dentro do
+ * iframe.
+ *
  * `null` significa **canal ausente nesta geração de hardware**, nunca "leitura
  * zero": `0.0` é leitura válida. Mesma distinção que o backend faz com
  * `float | null`.
@@ -557,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;
     /**
@@ -593,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.
@@ -639,6 +698,16 @@ declare const Bridge: CondorBridge;
 
 interface BridgeClientHandshakeAck {
     shellVersion: string;
+    /**
+     * Versão do schema do **nativo**, repassada pelo shell — `null` se o nativo
+     * ainda não respondeu ou não existe (mock de browser).
+     *
+     * É por este número que um cliente decide se pode depender de capacidade
+     * nova: não há negociação de versão, e o cliente sandboxed não alcança o
+     * nativo por nenhum outro caminho. Ex.: canais crus de luz
+     * (`light_sensor_*` em `deviceLightSensors`) existem a partir da `0.16.0`.
+     */
+    nativeVersion: string | null;
     accepted: boolean;
 }
 interface CondorBridgeClient {
@@ -755,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<{
@@ -765,6 +835,15 @@ declare const ShellToClientMessage: v.VariantSchema<"type", [v.ObjectSchema<{
     readonly type: v.LiteralSchema<"handshake-ack", undefined>;
     readonly ack: v.ObjectSchema<{
         readonly shellVersion: v.StringSchema<undefined>;
+        /**
+         * Versão do schema declarada pelo **nativo**, repassada pelo shell.
+         *
+         * `null` quando o nativo ainda não respondeu (ou não existe, como no
+         * mock de browser). O cliente roda dentro de um iframe sandboxed e não
+         * fala com o nativo diretamente, então este é o **único** caminho pelo
+         * qual ele descobre de qual versão são as capacidades disponíveis.
+         */
+        readonly nativeVersion: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly accepted: v.BooleanSchema<undefined>;
     }, undefined>;
 }, undefined>, v.ObjectSchema<{
@@ -817,6 +896,8 @@ interface ConfirmationRequest {
 interface SandboxVerifyResult {
     flutterBridgeReachable: boolean;
     condorBridgeReachable: boolean;
+    /** `window.CondorNative` visível no iframe (v0.18.0). */
+    nativeChannelReachable: boolean;
     ok: boolean;
 }
 
@@ -868,6 +949,13 @@ declare class BridgeShell {
     private readonly onConfirm?;
     private readonly subscriptions;
     private detached;
+    /**
+     * Versão do nativo, obtida uma vez e cacheada. `null` até o nativo
+     * responder — e permanentemente `null` num browser sem nativo.
+     */
+    private nativeVersion;
+    /** Handshake com o nativo em voo; garante uma única chamada. */
+    private nativeHandshake;
     private pendingVerifies;
     constructor(opts: BridgeShellOptions);
     /**
@@ -923,7 +1011,17 @@ declare class BridgeShell {
     private handleSubscribe;
     private handleUnsubscribe;
     private handleSend;
+    /**
+     * Obtém o `nativeVersion`, disparando o handshake com o nativo na primeira
+     * vez e cacheando o resultado.
+     *
+     * ⚠️ `Bridge.handshake` **não tem timeout**: a Promise só resolve quando o
+     * nativo emite `handshake-ack`. Num browser sem nativo ela nunca resolve,
+     * então o `race` abaixo é o que garante que o cliente sempre receba
+     * resposta — com `null` — em vez de ficar pendurado.
+     */
+    private resolveNativeVersion;
     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.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;
@@ -207,6 +251,11 @@ interface UserDevicePayload {
  * defensivamente. Não são opcionais no tipo de propósito — opcional
  * esconderia o skew de versão em vez de deixá-lo explícito.
  *
+ * ⚠️ O `nativeVersion` só chega ao cliente a partir do **SDK 0.17.0**: até a
+ * `0.16.x` o shell respondia o handshake do cliente apenas com o
+ * `shellVersion`, então essa checagem era impossível de cumprir de dentro do
+ * iframe.
+ *
  * `null` significa **canal ausente nesta geração de hardware**, nunca "leitura
  * zero": `0.0` é leitura válida. Mesma distinção que o backend faz com
  * `float | null`.
@@ -557,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;
     /**
@@ -593,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.
@@ -639,6 +698,16 @@ declare const Bridge: CondorBridge;
 
 interface BridgeClientHandshakeAck {
     shellVersion: string;
+    /**
+     * Versão do schema do **nativo**, repassada pelo shell — `null` se o nativo
+     * ainda não respondeu ou não existe (mock de browser).
+     *
+     * É por este número que um cliente decide se pode depender de capacidade
+     * nova: não há negociação de versão, e o cliente sandboxed não alcança o
+     * nativo por nenhum outro caminho. Ex.: canais crus de luz
+     * (`light_sensor_*` em `deviceLightSensors`) existem a partir da `0.16.0`.
+     */
+    nativeVersion: string | null;
     accepted: boolean;
 }
 interface CondorBridgeClient {
@@ -755,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<{
@@ -765,6 +835,15 @@ declare const ShellToClientMessage: v.VariantSchema<"type", [v.ObjectSchema<{
     readonly type: v.LiteralSchema<"handshake-ack", undefined>;
     readonly ack: v.ObjectSchema<{
         readonly shellVersion: v.StringSchema<undefined>;
+        /**
+         * Versão do schema declarada pelo **nativo**, repassada pelo shell.
+         *
+         * `null` quando o nativo ainda não respondeu (ou não existe, como no
+         * mock de browser). O cliente roda dentro de um iframe sandboxed e não
+         * fala com o nativo diretamente, então este é o **único** caminho pelo
+         * qual ele descobre de qual versão são as capacidades disponíveis.
+         */
+        readonly nativeVersion: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly accepted: v.BooleanSchema<undefined>;
     }, undefined>;
 }, undefined>, v.ObjectSchema<{
@@ -817,6 +896,8 @@ interface ConfirmationRequest {
 interface SandboxVerifyResult {
     flutterBridgeReachable: boolean;
     condorBridgeReachable: boolean;
+    /** `window.CondorNative` visível no iframe (v0.18.0). */
+    nativeChannelReachable: boolean;
     ok: boolean;
 }
 
@@ -868,6 +949,13 @@ declare class BridgeShell {
     private readonly onConfirm?;
     private readonly subscriptions;
     private detached;
+    /**
+     * Versão do nativo, obtida uma vez e cacheada. `null` até o nativo
+     * responder — e permanentemente `null` num browser sem nativo.
+     */
+    private nativeVersion;
+    /** Handshake com o nativo em voo; garante uma única chamada. */
+    private nativeHandshake;
     private pendingVerifies;
     constructor(opts: BridgeShellOptions);
     /**
@@ -923,7 +1011,17 @@ declare class BridgeShell {
     private handleSubscribe;
     private handleUnsubscribe;
     private handleSend;
+    /**
+     * Obtém o `nativeVersion`, disparando o handshake com o nativo na primeira
+     * vez e cacheando o resultado.
+     *
+     * ⚠️ `Bridge.handshake` **não tem timeout**: a Promise só resolve quando o
+     * nativo emite `handshake-ack`. Num browser sem nativo ela nunca resolve,
+     * então o `race` abaixo é o que garante que o cliente sempre receba
+     * resposta — com `null` — em vez de ficar pendurado.
+     */
+    private resolveNativeVersion;
     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 ?? {});
   },
@@ -632,6 +654,8 @@ function onMessage(event) {
         pendingHandshake2 = null;
         resolve({
           shellVersion: msg.ack?.shellVersion ?? "unknown",
+          // `?? null` cobre o shell anterior à 0.17.0, que não mandava o campo.
+          nativeVersion: msg.ack?.nativeVersion ?? null,
           accepted: msg.ack?.accepted ?? false
         });
       }
@@ -645,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;
     }
@@ -771,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,
@@ -790,6 +817,15 @@ var HandshakeAckMessage = v.object({
   type: v.literal("handshake-ack"),
   ack: v.object({
     shellVersion: v.string(),
+    /**
+     * Versão do schema declarada pelo **nativo**, repassada pelo shell.
+     *
+     * `null` quando o nativo ainda não respondeu (ou não existe, como no
+     * mock de browser). O cliente roda dentro de um iframe sandboxed e não
+     * fala com o nativo diretamente, então este é o **único** caminho pelo
+     * qual ele descobre de qual versão são as capacidades disponíveis.
+     */
+    nativeVersion: v.nullable(v.string()),
     accepted: v.boolean()
   })
 });
@@ -810,12 +846,14 @@ var ShellToClientMessage = v.variant("type", [
 ]);
 
 // src/bridge-shell.ts
-var SHELL_VERSION = "0.5.1";
+var SHELL_VERSION = "0.6.0";
+var NATIVE_HANDSHAKE_TIMEOUT_MS = 2e3;
 var VERIFY_TIMEOUT_MS = 2e3;
 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; },
@@ -823,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; },
@@ -848,6 +893,13 @@ var BridgeShell = class {
   constructor(opts) {
     this.subscriptions = /* @__PURE__ */ new Map();
     this.detached = false;
+    /**
+     * Versão do nativo, obtida uma vez e cacheada. `null` até o nativo
+     * responder — e permanentemente `null` num browser sem nativo.
+     */
+    this.nativeVersion = null;
+    /** Handshake com o nativo em voo; garante uma única chamada. */
+    this.nativeHandshake = null;
     // Map de `verify-sandbox` round-trips pendentes — key gerada por nonce.
     this.pendingVerifies = /* @__PURE__ */ new Map();
     this.onMessage = async (event) => {
@@ -872,9 +924,11 @@ var BridgeShell = class {
           await this.handleSend(msg.command, msg.args ?? {});
           break;
         case "handshake":
-          this.postToClient({
-            type: "handshake-ack",
-            ack: { shellVersion: SHELL_VERSION, accepted: true }
+          void this.resolveNativeVersion().then((nativeVersion) => {
+            this.postToClient({
+              type: "handshake-ack",
+              ack: { shellVersion: SHELL_VERSION, nativeVersion, accepted: true }
+            });
           });
           break;
         case "jsError":
@@ -894,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
               });
             }
@@ -1053,6 +1109,29 @@ var BridgeShell = class {
     }
     Bridge.send(command, args);
   }
+  /**
+   * Obtém o `nativeVersion`, disparando o handshake com o nativo na primeira
+   * vez e cacheando o resultado.
+   *
+   * ⚠️ `Bridge.handshake` **não tem timeout**: a Promise só resolve quando o
+   * nativo emite `handshake-ack`. Num browser sem nativo ela nunca resolve,
+   * então o `race` abaixo é o que garante que o cliente sempre receba
+   * resposta — com `null` — em vez de ficar pendurado.
+   */
+  async resolveNativeVersion() {
+    if (this.nativeVersion !== null) return this.nativeVersion;
+    if (!this.nativeHandshake) {
+      this.nativeHandshake = Bridge.handshake({ clientVersion: SHELL_VERSION }).then((ack) => {
+        this.nativeVersion = ack.nativeVersion;
+      }).catch(() => {
+      });
+    }
+    await Promise.race([
+      this.nativeHandshake,
+      new Promise((resolve) => setTimeout(resolve, NATIVE_HANDSHAKE_TIMEOUT_MS))
+    ]);
+    return this.nativeVersion;
+  }
   postToClient(msg) {
     if (this.detached) return;
     this.iframe.contentWindow?.postMessage(msg, "*");
@@ -1062,6 +1141,7 @@ export {
   BRIDGE_KEYS,
   Bridge,
   BridgeClient,
-  BridgeShell
+  BridgeShell,
+  NATIVE_CHANNEL_NAME
 };
 //# sourceMappingURL=index.js.map