@pushmesh/sdk 0.7.2 → 0.7.3-rc.3

package/README.md

@@ -1,64 +1,95 @@
 # @pushmesh/sdk
 
-SDK React Native do **PushMesh** — push próprio com recibo real de entrega,
-reativação de permissão (módulo Reativa) e banners in-app.
+React Native SDK for **PushMesh** — push notifications with **real delivery
+receipts**, permission re-activation and in-app banners.
 
-- TypeScript, build CJS único e **minificado com nomes preservados** (stack
-  trace legível no app, sem source map), `sideEffects: false`
-- Compatível com New Architecture (Fabric) — testado contra RN 0.83
-- Runtime: **fetch nativo** (sem axios) + `@notifee/react-native` + AsyncStorage
-- **Dois modos**: zero-config (Android via FCM por código; iOS via APNs direto —
-  ambos **sem Firebase no app**) ou modo host (o token vem do app)
-- Inclui **API clássica** (`/compat`), compatível com o formato de SDK de push
-  mais difundido do mercado — migração sem reescrever o app
+> 🇧🇷 **Este guia também existe em português:** [README.pt-BR.md](./README.pt-BR.md)
 
-> **Guia completo** (zero-config em detalhe, modo host, API clássica, rotas,
-> imagem no iOS, permissões, caminho nativo): <https://docs.pushmesh.io> — o
-> mesmo guia mora no repositório, em `sdk/docs/GUIA-INTEGRACAO.md`.
-> · A doc de cada método vive no hover do editor (JSDoc embarcado nos tipos).
+- TypeScript, single CJS build, **minified with identifiers preserved** (readable
+  stack traces in your app, no source map needed), `sideEffects: false`
+- New Architecture (Fabric) compatible — tested against RN 0.83
+- Runtime: **native fetch** (no axios) + `@notifee/react-native` + AsyncStorage
+- **Two modes**: zero-config (Android over FCM by code; iOS over APNs directly —
+  both **without Firebase in your app**) or host mode (your app owns the token)
+- Ships a **classic API** (`/compat`) matching the most widespread push SDK
+  format on the market — migrate without rewriting your app
 
-## Instalação
+> **Full guide** (zero-config in depth, host mode, classic API, routes, iOS
+> images, permissions, the native path): <https://docs.pushmesh.io>
+> · Per-method documentation lives in your editor's hover (JSDoc ships with the
+> types).
+
+## Install
 
 ```bash
 npm install @pushmesh/sdk @notifee/react-native @react-native-async-storage/async-storage
 cd ios && bundle exec pod install   # iOS
 ```
 
-## Começo rápido (zero-config — recomendado)
+## Expo — zero native setup
+
+```bash
+npx expo install @pushmesh/sdk @notifee/react-native @react-native-async-storage/async-storage
+```
+
+```json
+{ "expo": { "plugins": [["@pushmesh/sdk", { "modo": "producao" }]] } }
+```
+
+Then `npx expo prebuild`. The config plugin does the iOS work Apple requires and
+nothing else: the Push Notifications capability, `remote-notification` background
+mode, and the **Notification Service Extension** — the only way an iPhone can
+download a push image. That extension is normally a five-minute manual dance in
+Xcode, repeated after every prebuild; here it is generated, idempotent, and it
+inherits your app's iOS deployment target (an extension built for a newer iOS
+silently never runs on older devices).
+
+**Android needs no plugin at all** — and that is the point. The native module
+already declares `POST_NOTIFICATIONS`, the receiver and the click trampoline, and
+zero-config fetches Firebase parameters at runtime. **Your app never carries
+`google-services.json`**, so no credential file in your repo.
+
+Plugin options: `modo` (`"desenvolvimento"` default | `"producao"` — TestFlight
+and the App Store both need `producao`), `imagemNoPush` (default `true`),
+`iconeNotificacao`, `corNotificacao`.
 
-Sem Firebase no app: cadastre o app no painel PushMesh (Android: cole o
-`google-services.json` em Configurações → FCM; iOS: suba a chave `.p8` em
-Configurações → APNs e habilite Push Notifications + Background Modes →
-Remote notifications no Xcode). No app:
+## Quick start (zero-config — recommended)
+
+No Firebase SDK in your app. Register the app in the PushMesh dashboard
+(Android: paste `google-services.json` under Settings → FCM; iOS: upload your
+`.p8` key under Settings → APNs, and enable Push Notifications plus Background
+Modes → Remote notifications in Xcode). Then, in your app:
 
 ```js
 import PushMesh from '@pushmesh/sdk';
 
 await PushMesh.init({
-  appId: 'UUID_DO_APP_NO_PUSHMESH', // SÓ ISSO é obrigatório
+  appId: 'YOUR_APP_UUID_IN_PUSHMESH', // the ONLY required field
   appVersion: '1.0.3',
-  // baseUrl é OPCIONAL — sem ela vale o servidor oficial
-  // (https://push.pushmesh.io). Passe uma URL só para self-host.
+  // baseUrl is OPTIONAL — without it the official server is used
+  // (https://api.pushmesh.io). Pass a URL only when self-hosting.
 });
-// no login do app: PushMesh.login(idDoUsuario);
+// when your app logs the user in: PushMesh.login(userId);
 ```
 
-Banners in-app: uma linha — monte `<PushMeshInAppHost />` (exportado pelo
-pacote) uma vez na raiz da sua árvore. Para o SDK se pendurar sozinho na raiz,
-`init({ ..., inAppAutoMontar: true })` — automático é **opt-in**, porque ele
-mexe no provedor de wrapper do React Native.
+In-app banners are one line: mount `<PushMeshInAppHost />` (exported by the
+package) once at the root of your tree. To let the SDK mount itself at the root,
+use `init({ ..., inAppAutoMontar: true })` — automatic mounting is **opt-in**,
+because it touches React Native's wrapper provider.
 
-Registro, token, display, recibo real e clique funcionam sem mais nenhuma
-linha. Imagem no push do iOS exige a Notification Service Extension — código
-pronto e guia de 5 min em `ios/NotificationService/LEIA-ME.md`.
+Registration, token handling, display, real receipts and click handling all work
+with no further code. Images in iOS pushes require the Notification Service
+Extension — ready-made code and a 5-minute guide in
+[`ios/NotificationService/README.md`](./ios/NotificationService/README.md).
 
-## Modo host (app com Firebase próprio)
+## Host mode (app with its own Firebase)
 
-Quem já tem Firebase passa `getToken` e nada muda (o zero-config nem é acionado):
+If you already have Firebase, pass `getToken` and nothing else changes
+(zero-config never kicks in):
 
 ```js
 await PushMesh.init({
-  appId: 'UUID_DO_APP_NO_PUSHMESH',
+  appId: 'YOUR_APP_UUID_IN_PUSHMESH',
   getToken: () => messaging().getToken(),
 });
 messaging().onTokenRefresh(t => PushMesh.setToken(t));
@@ -73,88 +104,68 @@ messaging().onNotificationOpenedApp(m => PushMesh.notifications.handleClick(m.da
 `receipts.handlePushData` · `notifications.{handleClick,addEventListener,removeEventListener}` ·
 `permissions.{checkAndReport,openNotificationSettings,canRequestNatively}` ·
 `user.{addTag,addTags,removeTag,removeTags}` · `inapp.{pending,track}` ·
-`definirGatilho`/`removerGatilho`/`limparGatilhos` (gatilho no aplicativo) ·
+`definirGatilho`/`removerGatilho`/`limparGatilhos` (in-app triggers) ·
 `triggers.*` · `doctor()`.
 
-Cada método tem JSDoc completo no hover do editor; assinaturas e semântica no
-[guia](https://docs.pushmesh.io). A **API clássica**
-(initialize/Notifications/User/InAppMessages) vem no entry `@pushmesh/sdk/compat`.
+Every method carries full JSDoc on hover; signatures and semantics are in the
+[guide](https://docs.pushmesh.io). The **classic API**
+(initialize/Notifications/User/InAppMessages) ships in the `@pushmesh/sdk/compat`
+entry point.
 
-## Leve por contrato
+## Light by contract
 
-O SDK roda no celular do cliente final — cada request e cada kB são orçados:
+This SDK runs on your end users' phones — every request and every kB is
+budgeted:
 
-- **Zero polling** — rede só no init, no `AppState → active` e no push recebido;
-- **Registro idempotente** — re-init com o mesmo payload = 1 request (provado em teste);
-- **Fila offline educada** — backoff com jitter, `Retry-After` honrado, máx.
-  10 tentativas e 5 requests concorrentes no flush (provado em teste);
-- **Orçamento de pacote** — `npm run size` falha o build se o payload JS do
-  tarball passar do teto (o código nativo Android/iOS não conta — vira código
-  compilado, não bundle JS).
+- **Zero polling** — the network is touched only on init, on `AppState → active`
+  and when a push arrives;
+- **Idempotent registration** — re-init with the same payload = 1 request
+  (proven by test);
+- **Polite offline queue** — backoff with jitter, `Retry-After` honoured, at most
+  10 attempts and 5 concurrent requests per flush (proven by test);
+- **Package budget** — `npm run size` fails the build if the tarball's JS payload
+  exceeds the ceiling (Android/iOS native code does not count — it becomes
+  compiled code, not JS bundle).
 
-## Diagnóstico
+## Diagnostics
 
 ```bash
-npx pushmesh-doctor --base-url https://push.pushmesh.io \
+npx pushmesh-doctor --base-url https://api.pushmesh.io \
   --app-id <uuid> [--player-id <uuid>] [--api-key pm_live_...]
 ```
 
-Exit code `0` = tudo verde; cada falha sai com "como corrigir". Dentro do app,
-`PushMesh.doctor()` imprime o equivalente on-device. Para testar sem push
-real, use o device sandbox: `getToken: async () => 'test:ok'` (detalhes no guia).
+Exit code `0` means everything is green; each failure prints how to fix it.
+Inside the app, `PushMesh.doctor()` prints the on-device equivalent. To test
+without a real push, use the device sandbox: `getToken: async () => 'test:ok'`
+(details in the guide).
+
+> The CLI and the SDK's runtime messages currently speak Portuguese. The API,
+> the types and this documentation are English.
 
-## Requisitos
+## Requirements
 
-| Item | Mínimo |
+| Item | Minimum |
 |---|---|
-| React Native | 0.71 (New Architecture testada em 0.83) |
+| React Native | 0.71 (New Architecture tested on 0.83) |
 | React | 17 |
 | Node (build/CLI) | 18 |
-| iOS | 15.1 (alinhado ao mínimo do RN do app) |
-| Android | conforme o `minSdk` do app |
+| iOS | 15.1 (matching your app's RN minimum) |
+| Android | whatever your app's `minSdk` is |
 
-Peer dependencies: `@notifee/react-native` ≥ 7 e
+Peer dependencies: `@notifee/react-native` ≥ 7 and
 `@react-native-async-storage/async-storage` ≥ 1.17.
 
-## Desenvolvimento do SDK
+## Developing the SDK
 
 ```bash
 npm install
 npm run typecheck    # tsc --noEmit
-npm test             # jest com mocks (sem device)
-npm run build        # CJS minificado (nomes preservados) em dist/cjs
-npm run test:types   # tsd — contrato dos exports (roda DEPOIS do build)
-npm run size         # orçamento: payload JS ≤ 40 kB (nativo não conta)
-```
-
-## Licença
-
-MIT — PushMesh 2026. Ver [LICENSE](LICENSE).
-
----
-
-## English summary
-
-React Native SDK for **PushMesh** — self-hosted-capable push with real delivery
-receipts, permission re-activation and in-app banners.
-
-```bash
-npm install @pushmesh/sdk @notifee/react-native @react-native-async-storage/async-storage
-cd ios && bundle exec pod install
+npm test             # jest with mocks (no device needed)
+npm run build        # minified CJS (identifiers preserved) into dist/cjs
+npm run test:types   # tsd — export contract (runs AFTER the build)
+npm run size         # budget: JS payload ≤ 40 kB (native does not count)
 ```
 
-```js
-import PushMesh from '@pushmesh/sdk';
-
-await PushMesh.init({ appId: 'YOUR_APP_UUID' }); // App ID is the only required field
-PushMesh.login(userId);                          // when your app logs the user in
-```
+## License
 
-Zero-config mode needs **no Firebase SDK in your app**: Android gets FCM
-credentials at runtime, iOS talks APNs directly with the `.p8` key you upload in
-the dashboard. Already using Firebase? Pass `getToken` and keep your setup
-(host mode). A drop-in **classic API** lives in `@pushmesh/sdk/compat` for
-migrating from the most widespread push SDK format without rewriting your app.
-Full documentation: <https://docs.pushmesh.io> — the same guide lives in this
-repository at `sdk/docs/GUIA-INTEGRACAO.md` (Portuguese, with an English
-summary at the end). MIT licensed.
+MIT — PushMesh 2026. See [LICENSE](LICENSE).

package/README.pt-BR.md

@@ -0,0 +1,163 @@
+# @pushmesh/sdk
+
+SDK React Native do **PushMesh** — push com **recibo real de entrega**,
+reativação de permissão (módulo Reativa) e banners in-app.
+
+> 🇺🇸 **This guide is also available in English:** [README.md](./README.md)
+
+- TypeScript, build CJS único e **minificado com nomes preservados** (stack
+  trace legível no app, sem source map), `sideEffects: false`
+- Compatível com New Architecture (Fabric) — testado contra RN 0.83
+- Runtime: **fetch nativo** (sem axios) + `@notifee/react-native` + AsyncStorage
+- **Dois modos**: zero-config (Android via FCM por código; iOS via APNs direto —
+  ambos **sem Firebase no app**) ou modo host (o token vem do app)
+- Inclui **API clássica** (`/compat`), compatível com o formato de SDK de push
+  mais difundido do mercado — migração sem reescrever o app
+
+> **Guia completo** (zero-config em detalhe, modo host, API clássica, rotas,
+> imagem no iOS, permissões, caminho nativo): <https://docs.pushmesh.io> — o
+> mesmo guia mora no repositório, em `sdk/docs/GUIA-INTEGRACAO.md`.
+> · A doc de cada método vive no hover do editor (JSDoc embarcado nos tipos).
+
+## Instalação
+
+```bash
+npm install @pushmesh/sdk @notifee/react-native @react-native-async-storage/async-storage
+cd ios && bundle exec pod install   # iOS
+```
+
+## Expo — sem tocar em código nativo
+
+```bash
+npx expo install @pushmesh/sdk @notifee/react-native @react-native-async-storage/async-storage
+```
+
+```json
+{ "expo": { "plugins": [["@pushmesh/sdk", { "modo": "producao" }]] } }
+```
+
+Depois, `npx expo prebuild`. O plugin faz o que a Apple obriga e nada além: a
+capability Push Notifications, o modo `remote-notification` e a **Notification
+Service Extension** — a única forma de o iPhone baixar a imagem de um push. Essa
+extensão normalmente são cinco minutos no Xcode, refeitos a cada prebuild; aqui
+ela é gerada, é idempotente, e herda o iOS mínimo do SEU app (extensão criada
+num iOS mais novo simplesmente não roda nos aparelhos antigos — sem erro
+nenhum).
+
+**O Android não precisa de plugin** — e é justamente aí que está a vantagem: o
+módulo nativo já declara `POST_NOTIFICATIONS`, o receiver e o trampolim de
+clique, e o zero-config busca os parâmetros do Firebase em tempo de execução.
+**O seu app nunca carrega o `google-services.json`**, então nenhum arquivo de
+credencial entra no repositório.
+
+Opções: `modo` (`"desenvolvimento"` padrão | `"producao"` — TestFlight e App
+Store exigem `producao`), `imagemNoPush` (padrão `true`), `iconeNotificacao`,
+`corNotificacao`.
+
+## Começo rápido (zero-config — recomendado)
+
+Sem Firebase no app: cadastre o app no painel PushMesh (Android: cole o
+`google-services.json` em Configurações → FCM; iOS: suba a chave `.p8` em
+Configurações → APNs e habilite Push Notifications + Background Modes →
+Remote notifications no Xcode). No app:
+
+```js
+import PushMesh from '@pushmesh/sdk';
+
+await PushMesh.init({
+  appId: 'UUID_DO_APP_NO_PUSHMESH', // SÓ ISSO é obrigatório
+  appVersion: '1.0.3',
+  // baseUrl é OPCIONAL — sem ela vale o servidor oficial
+  // (https://api.pushmesh.io). Passe uma URL só para self-host.
+});
+// no login do app: PushMesh.login(idDoUsuario);
+```
+
+Banners in-app: uma linha — monte `<PushMeshInAppHost />` (exportado pelo
+pacote) uma vez na raiz da sua árvore. Para o SDK se pendurar sozinho na raiz,
+`init({ ..., inAppAutoMontar: true })` — automático é **opt-in**, porque ele
+mexe no provedor de wrapper do React Native.
+
+Registro, token, display, recibo real e clique funcionam sem mais nenhuma
+linha. Imagem no push do iOS exige a Notification Service Extension — código
+pronto e guia de 5 min em
+[`ios/NotificationService/LEIA-ME.md`](./ios/NotificationService/LEIA-ME.md).
+
+## Modo host (app com Firebase próprio)
+
+Quem já tem Firebase passa `getToken` e nada muda (o zero-config nem é acionado):
+
+```js
+await PushMesh.init({
+  appId: 'UUID_DO_APP_NO_PUSHMESH',
+  getToken: () => messaging().getToken(),
+});
+messaging().onTokenRefresh(t => PushMesh.setToken(t));
+messaging().onMessage(m => PushMesh.receipts.handlePushData(m.data));
+messaging().setBackgroundMessageHandler(async m => { PushMesh.receipts.handlePushData(m.data); });
+messaging().onNotificationOpenedApp(m => PushMesh.notifications.handleClick(m.data));
+```
+
+## API
+
+`PushMesh.init` · `setToken` · `login` · `logout` · `getPlayerId` ·
+`receipts.handlePushData` · `notifications.{handleClick,addEventListener,removeEventListener}` ·
+`permissions.{checkAndReport,openNotificationSettings,canRequestNatively}` ·
+`user.{addTag,addTags,removeTag,removeTags}` · `inapp.{pending,track}` ·
+`definirGatilho`/`removerGatilho`/`limparGatilhos` (gatilho no aplicativo) ·
+`triggers.*` · `doctor()`.
+
+Cada método tem JSDoc completo no hover do editor; assinaturas e semântica no
+[guia](https://docs.pushmesh.io). A **API clássica**
+(initialize/Notifications/User/InAppMessages) vem no entry `@pushmesh/sdk/compat`.
+
+## Leve por contrato
+
+O SDK roda no celular do cliente final — cada request e cada kB são orçados:
+
+- **Zero polling** — rede só no init, no `AppState → active` e no push recebido;
+- **Registro idempotente** — re-init com o mesmo payload = 1 request (provado em teste);
+- **Fila offline educada** — backoff com jitter, `Retry-After` honrado, máx.
+  10 tentativas e 5 requests concorrentes no flush (provado em teste);
+- **Orçamento de pacote** — `npm run size` falha o build se o payload JS do
+  tarball passar do teto (o código nativo Android/iOS não conta — vira código
+  compilado, não bundle JS).
+
+## Diagnóstico
+
+```bash
+npx pushmesh-doctor --base-url https://api.pushmesh.io \
+  --app-id <uuid> [--player-id <uuid>] [--api-key pm_live_...]
+```
+
+Exit code `0` = tudo verde; cada falha sai com "como corrigir". Dentro do app,
+`PushMesh.doctor()` imprime o equivalente on-device. Para testar sem push
+real, use o device sandbox: `getToken: async () => 'test:ok'` (detalhes no guia).
+
+## Requisitos
+
+| Item | Mínimo |
+|---|---|
+| React Native | 0.71 (New Architecture testada em 0.83) |
+| React | 17 |
+| Node (build/CLI) | 18 |
+| iOS | 15.1 (alinhado ao mínimo do RN do app) |
+| Android | conforme o `minSdk` do app |
+
+Peer dependencies: `@notifee/react-native` ≥ 7 e
+`@react-native-async-storage/async-storage` ≥ 1.17.
+
+## Desenvolvimento do SDK
+
+```bash
+npm install
+npm run typecheck    # tsc --noEmit
+npm test             # jest com mocks (sem device)
+npm run build        # CJS minificado (nomes preservados) em dist/cjs
+npm run test:types   # tsd — contrato dos exports (roda DEPOIS do build)
+npm run size         # orçamento: payload JS ≤ 40 kB (nativo não conta)
+```
+
+## Licença
+
+MIT — PushMesh 2026. Ver [LICENSE](LICENSE).

package/app.plugin.js

@@ -0,0 +1,8 @@
+/**
+ * Ponto de entrada do plugin de configuração do Expo.
+ *
+ * O Expo procura EXATAMENTE `app.plugin.js` na raiz do pacote quando alguém
+ * escreve `"plugins": ["@pushmesh/sdk"]`. É só o encaminhamento — a
+ * implementação mora em `plugin/index.js`.
+ */
+module.exports = require('./plugin');

package/dist/cjs/boot.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true}),exports.boot=boot;const auto_1=require("./inapp/auto"),permissions_1=require("./permissions"),players_1=require("./players");async function boot(config){true===config.inAppAutoMontar&&(0,auto_1.montarInAppAutomaticamente)(),await(0,players_1.init)(config),(0,permissions_1.attachAppStateHook)(),(0,permissions_1.checkAndReport)().catch(e=>console.warn("[PushMesh] checkAndReport falhou",e))}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true}),exports.boot=boot;const auto_1=require("./inapp/auto"),permissions_1=require("./permissions"),players_1=require("./players");async function boot(config){if(true===config.inAppAutoMontar&&(0,auto_1.montarInAppAutomaticamente)(),await(0,players_1.init)(config),(0,permissions_1.attachAppStateHook)(),true===config.pedirPermissao)try{await(0,permissions_1.reativarNotificacoes)()}catch(e){console.warn("[PushMesh] pedirPermissao falhou",e)}(0,permissions_1.checkAndReport)().then(permissions_1.avisarSeMudo).catch(e=>console.warn("[PushMesh] checkAndReport falhou",e))}

package/dist/cjs/doctor.d.ts

@@ -7,7 +7,7 @@
  * (a lei do erro que ensina).
  *
  * Uso:
- *   npx pushmesh-doctor --base-url https://push.pushmesh.io \
+ *   npx pushmesh-doctor --base-url https://api.pushmesh.io \
  *     --app-id <uuid> [--player-id <uuid>] [--api-key pm_live_...] [--timeout 8000]
  *
  * Exit code: 0 = tudo verde · 1 = ao menos uma falha.
@@ -23,5 +23,5 @@ declare function fetchJson(url: string, timeoutMs: number, headers?: Record<stri
     status: number;
     json: any;
 }>;
-declare const USO = "pushmesh-doctor \u2014 diagn\u00F3stico da integra\u00E7\u00E3o PushMesh.\n\nUso:\n  npx pushmesh-doctor --base-url <url> --app-id <uuid> [op\u00E7\u00F5es]\n\nObrigat\u00F3rios:\n  --base-url <url>     servidor PushMesh (oficial: https://push.pushmesh.io)\n  --app-id <uuid>      App ID do app no painel\n\nOpcionais:\n  --player-id <uuid>   confere um aparelho j\u00E1 registrado\n  --api-key pm_live_\u2026  destrava as checagens que exigem autentica\u00E7\u00E3o\n  --timeout <ms>       timeout por requisi\u00E7\u00E3o (padr\u00E3o: 8000)\n  -h, --help           mostra esta ajuda\n\nExit code: 0 = tudo verde \u00B7 1 = ao menos uma falha.\nDoc: https://docs.pushmesh.io";
+declare const USO = "pushmesh-doctor \u2014 diagn\u00F3stico da integra\u00E7\u00E3o PushMesh.\n\nUso:\n  npx pushmesh-doctor --base-url <url> --app-id <uuid> [op\u00E7\u00F5es]\n\nObrigat\u00F3rios:\n  --base-url <url>     servidor PushMesh (oficial: https://api.pushmesh.io)\n  --app-id <uuid>      App ID do app no painel\n\nOpcionais:\n  --player-id <uuid>   confere um aparelho j\u00E1 registrado\n  --api-key pm_live_\u2026  destrava as checagens que exigem autentica\u00E7\u00E3o\n  --timeout <ms>       timeout por requisi\u00E7\u00E3o (padr\u00E3o: 8000)\n  -h, --help           mostra esta ajuda\n\nExit code: 0 = tudo verde \u00B7 1 = ao menos uma falha.\nDoc: https://docs.pushmesh.io";
 declare function main(): Promise<void>;

package/dist/cjs/doctor.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-"use strict";function parseArgs(argv){const args={};for(let i=0;i<argv.length;i++){const a=argv[i];if(a.startsWith("--")){const key=a.slice(2),next=argv[i+1];next&&!next.startsWith("--")?(args[key]=next,i++):args[key]="true"}}return args}async function fetchJson(url,timeoutMs,headers){const controller=new AbortController,timer=setTimeout(()=>controller.abort(),timeoutMs);try{const res=await fetch(url,{headers:headers,signal:controller.signal}),text=await res.text();let json=null;try{json=JSON.parse(text)}catch{json=text}return{status:res.status,json:json}}finally{clearTimeout(timer)}}const USO="pushmesh-doctor — diagnóstico da integração PushMesh.\n\nUso:\n  npx pushmesh-doctor --base-url <url> --app-id <uuid> [opções]\n\nObrigatórios:\n  --base-url <url>     servidor PushMesh (oficial: https://push.pushmesh.io)\n  --app-id <uuid>      App ID do app no painel\n\nOpcionais:\n  --player-id <uuid>   confere um aparelho já registrado\n  --api-key pm_live_…  destrava as checagens que exigem autenticação\n  --timeout <ms>       timeout por requisição (padrão: 8000)\n  -h, --help           mostra esta ajuda\n\nExit code: 0 = tudo verde · 1 = ao menos uma falha.\nDoc: https://docs.pushmesh.io";async function main(){const argv=process.argv.slice(2);(0===argv.length||argv.includes("--help")||argv.includes("-h"))&&(console.log(USO),process.exit(0));const args=parseArgs(argv),checks=[],baseUrl=(args["base-url"]||"").replace(/\/+$/,"");baseUrl||(console.error("FALHA: --base-url é obrigatório.\n  Como corrigir: npx pushmesh-doctor --base-url https://push.pushmesh.io --app-id <uuid>"),process.exit(1));const timeoutMs=Number(args.timeout||8e3);let health=null;try{const res=await fetchJson(`${baseUrl}/health`,timeoutMs);health=res.json,200===res.status&&health&&"ok"===health.status?checks.push({nome:"baseUrl alcançável + /health ok",ok:true,detalhe:`versao=${health.versao??"?"} papel=${health.papel??"?"} pg=${health.pg??"?"} valkey=${health.valkey??"?"}`}):checks.push({nome:"baseUrl alcançável + /health ok",ok:false,detalhe:`HTTP ${res.status}`,comoCorrigir:'o /health do PUSHMESH deve responder 200 {"status":"ok"}. Verifique se o serviço está no ar (systemctl status pushmesh) e se o LB está healthy.'})}catch(e){checks.push({nome:"baseUrl alcançável + /health ok",ok:false,detalhe:String(e),comoCorrigir:"confira a URL (sem barra final), DNS/TLS do domínio e se esta máquina alcança o servidor (VPN/firewall). "})}health&&"ok"===health.status&&("ok"!==health.pg&&checks.push({nome:"Postgres saudável",ok:false,detalhe:`pg=${health.pg} pg_down_ha_s=${health.pg_down_ha_s??"?"}`,comoCorrigir:"O banco do serviço está fora do ar e a API responde 503 por contrato — não é a integração do seu app. Aguarde o restabelecimento ou fale com o suporte."}),"ok"!==health.valkey&&checks.push({nome:"Valkey saudável",ok:null,detalhe:`valkey=${health.valkey} — o serviço está em modo degradado, mas segue entregando`}));const appId=args["app-id"],playerId=args["player-id"],apiKey=args["api-key"];if(playerId&&!apiKey)checks.push({nome:"player registrado",ok:null,detalhe:"pulado: GET /players/:id exige --api-key (rota de servidor, Basic auth)"});else if(playerId&&apiKey){appId||(console.error("FALHA: --app-id é obrigatório junto com --player-id."),process.exit(1));try{const res=await fetchJson(`${baseUrl}/api/v1/players/${encodeURIComponent(playerId)}?app_id=${encodeURIComponent(appId)}`,timeoutMs,{Authorization:`Basic ${apiKey}`});if(200===res.status&&res.json){const p=res.json;checks.push({nome:"player registrado",ok:true,detalhe:`id=${playerId}`}),checks.push(p.identifier?{nome:"token de push presente",ok:true,detalhe:"identifier preenchido"}:{nome:"token de push presente",ok:false,detalhe:"identifier vazio",comoCorrigir:"o device se registrou sem token. No app, confira config.getToken / PushMesh.setToken e o google-services.json."});const nt=p.notification_types;checks.push(1===nt?{nome:"permissão de notificação",ok:true,detalhe:"notification_types=1 (ativo)"}:{nome:"permissão de notificação",ok:0===nt&&null,detalhe:`notification_types=${nt}`,comoCorrigir:-2===nt?"usuário bloqueou. Use a campanha Reativa: botão open_notification_settings + detecção de virada no foreground.":"permissão nunca solicitada. canRequestNatively()=true: dá para pedir o prompt nativo (spec §4)."}),p.invalid_identifier&&checks.push({nome:"token válido no FCM/APNs",ok:false,detalhe:"invalid_identifier=true (token morto — UNREGISTERED)",comoCorrigir:"o app precisa abrir uma vez para re-registrar com token novo (upsert por app_id+token)."})}else 404===res.status?checks.push({nome:"player registrado",ok:false,detalhe:`404 — player ${playerId} não existe nesse tenant`,comoCorrigir:"confira app_id e player_id (o player_id é o devices.uuid devolvido pelo POST /players, guardado no AsyncStorage pm:player_id)."}):401===res.status?checks.push({nome:"player registrado",ok:false,detalhe:"401 — api_key ausente/revogada ou app_id ≠ app da chave",comoCorrigir:"confira a api_key do app; se rotacionou, a antiga segue válida por 24h."}):checks.push({nome:"player registrado",ok:false,detalhe:`HTTP ${res.status}: ${JSON.stringify(res.json)}`})}catch(e){checks.push({nome:"player registrado",ok:false,detalhe:String(e),comoCorrigir:"falha de rede consultando o player — veja o item baseUrl acima."})}}console.log(`\npushmesh-doctor — ${baseUrl}\n${"=".repeat(60)}`);let falhas=0;for(const c of checks){const marca=true===c.ok?"OK   ":null===c.ok?"INFO ":"FALHA";false===c.ok&&falhas++,console.log(`${marca} ${c.nome}: ${c.detalhe}`),c.comoCorrigir&&console.log(`     → como corrigir: ${c.comoCorrigir}`)}console.log("=".repeat(60)),console.log(0===falhas?"Tudo verde.":`${falhas} falha(s) — corrija na ordem acima.`),process.exit(0===falhas?0:1)}main().catch(e=>{console.error(`pushmesh-doctor quebrou: ${String(e)}`),process.exit(1)});
+"use strict";function parseArgs(argv){const args={};for(let i=0;i<argv.length;i++){const a=argv[i];if(a.startsWith("--")){const key=a.slice(2),next=argv[i+1];next&&!next.startsWith("--")?(args[key]=next,i++):args[key]="true"}}return args}async function fetchJson(url,timeoutMs,headers){const controller=new AbortController,timer=setTimeout(()=>controller.abort(),timeoutMs);try{const res=await fetch(url,{headers:headers,signal:controller.signal}),text=await res.text();let json=null;try{json=JSON.parse(text)}catch{json=text}return{status:res.status,json:json}}finally{clearTimeout(timer)}}const USO="pushmesh-doctor — diagnóstico da integração PushMesh.\n\nUso:\n  npx pushmesh-doctor --base-url <url> --app-id <uuid> [opções]\n\nObrigatórios:\n  --base-url <url>     servidor PushMesh (oficial: https://api.pushmesh.io)\n  --app-id <uuid>      App ID do app no painel\n\nOpcionais:\n  --player-id <uuid>   confere um aparelho já registrado\n  --api-key pm_live_…  destrava as checagens que exigem autenticação\n  --timeout <ms>       timeout por requisição (padrão: 8000)\n  -h, --help           mostra esta ajuda\n\nExit code: 0 = tudo verde · 1 = ao menos uma falha.\nDoc: https://docs.pushmesh.io";async function main(){const argv=process.argv.slice(2);(0===argv.length||argv.includes("--help")||argv.includes("-h"))&&(console.log(USO),process.exit(0));const args=parseArgs(argv),checks=[],baseUrl=(args["base-url"]||"").replace(/\/+$/,"");baseUrl||(console.error("FALHA: --base-url é obrigatório.\n  Como corrigir: npx pushmesh-doctor --base-url https://api.pushmesh.io --app-id <uuid>"),process.exit(1));const timeoutMs=Number(args.timeout||8e3);let health=null;try{const res=await fetchJson(`${baseUrl}/health`,timeoutMs);health=res.json,200===res.status&&health&&"ok"===health.status?checks.push({nome:"baseUrl alcançável + /health ok",ok:true,detalhe:`versao=${health.versao??"?"} papel=${health.papel??"?"} pg=${health.pg??"?"} valkey=${health.valkey??"?"}`}):checks.push({nome:"baseUrl alcançável + /health ok",ok:false,detalhe:`HTTP ${res.status}`,comoCorrigir:'o /health do PUSHMESH deve responder 200 {"status":"ok"}. Verifique se o serviço está no ar (systemctl status pushmesh) e se o LB está healthy.'})}catch(e){checks.push({nome:"baseUrl alcançável + /health ok",ok:false,detalhe:String(e),comoCorrigir:"confira a URL (sem barra final), DNS/TLS do domínio e se esta máquina alcança o servidor (VPN/firewall). "})}health&&"ok"===health.status&&("ok"!==health.pg&&checks.push({nome:"Postgres saudável",ok:false,detalhe:`pg=${health.pg} pg_down_ha_s=${health.pg_down_ha_s??"?"}`,comoCorrigir:"O banco do serviço está fora do ar e a API responde 503 por contrato — não é a integração do seu app. Aguarde o restabelecimento ou fale com o suporte."}),"ok"!==health.valkey&&checks.push({nome:"Valkey saudável",ok:null,detalhe:`valkey=${health.valkey} — o serviço está em modo degradado, mas segue entregando`}));const appId=args["app-id"],playerId=args["player-id"],apiKey=args["api-key"];if(playerId&&!apiKey)checks.push({nome:"player registrado",ok:null,detalhe:"pulado: GET /players/:id exige --api-key (rota de servidor, Basic auth)"});else if(playerId&&apiKey){appId||(console.error("FALHA: --app-id é obrigatório junto com --player-id."),process.exit(1));try{const res=await fetchJson(`${baseUrl}/api/v1/players/${encodeURIComponent(playerId)}?app_id=${encodeURIComponent(appId)}`,timeoutMs,{Authorization:`Basic ${apiKey}`});if(200===res.status&&res.json){const p=res.json;checks.push({nome:"player registrado",ok:true,detalhe:`id=${playerId}`}),checks.push(p.identifier?{nome:"token de push presente",ok:true,detalhe:"identifier preenchido"}:{nome:"token de push presente",ok:false,detalhe:"identifier vazio",comoCorrigir:"o device se registrou sem token. No app, confira config.getToken / PushMesh.setToken e o google-services.json."});const nt=p.notification_types;checks.push(1===nt?{nome:"permissão de notificação",ok:true,detalhe:"notification_types=1 (ativo)"}:{nome:"permissão de notificação",ok:0===nt&&null,detalhe:`notification_types=${nt}`,comoCorrigir:-2===nt?"usuário bloqueou. Use a campanha Reativa: botão open_notification_settings + detecção de virada no foreground.":"permissão nunca solicitada. canRequestNatively()=true: dá para pedir o prompt nativo (spec §4)."}),p.invalid_identifier&&checks.push({nome:"token válido no FCM/APNs",ok:false,detalhe:"invalid_identifier=true (token morto — UNREGISTERED)",comoCorrigir:"o app precisa abrir uma vez para re-registrar com token novo (upsert por app_id+token)."})}else 404===res.status?checks.push({nome:"player registrado",ok:false,detalhe:`404 — player ${playerId} não existe nesse tenant`,comoCorrigir:"confira app_id e player_id (o player_id é o devices.uuid devolvido pelo POST /players, guardado no AsyncStorage pm:player_id)."}):401===res.status?checks.push({nome:"player registrado",ok:false,detalhe:"401 — api_key ausente/revogada ou app_id ≠ app da chave",comoCorrigir:"confira a api_key do app; se rotacionou, a antiga segue válida por 24h."}):checks.push({nome:"player registrado",ok:false,detalhe:`HTTP ${res.status}: ${JSON.stringify(res.json)}`})}catch(e){checks.push({nome:"player registrado",ok:false,detalhe:String(e),comoCorrigir:"falha de rede consultando o player — veja o item baseUrl acima."})}}console.log(`\npushmesh-doctor — ${baseUrl}\n${"=".repeat(60)}`);let falhas=0;for(const c of checks){const marca=true===c.ok?"OK   ":null===c.ok?"INFO ":"FALHA";false===c.ok&&falhas++,console.log(`${marca} ${c.nome}: ${c.detalhe}`),c.comoCorrigir&&console.log(`     → como corrigir: ${c.comoCorrigir}`)}console.log("=".repeat(60)),console.log(0===falhas?"Tudo verde.":`${falhas} falha(s) — corrija na ordem acima.`),process.exit(0===falhas?0:1)}main().catch(e=>{console.error(`pushmesh-doctor quebrou: ${String(e)}`),process.exit(1)});

package/dist/cjs/index.d.ts

@@ -22,7 +22,7 @@ import { definirGatilho, definirGatilhos, lerGatilhos, limparGatilhos, removerGa
 export declare const PushMesh: {
     /**
      * Inicializa o SDK — uma vez no boot do app. SÓ o `appId` é obrigatório:
-     * sem `baseUrl` vale o servidor oficial (https://push.pushmesh.io).
+     * sem `baseUrl` vale o servidor oficial (https://api.pushmesh.io).
      * Chamadas concorrentes compartilham o mesmo boot (um registro só).
      */
     init: typeof boot;

package/dist/cjs/perfil.d.ts

@@ -20,7 +20,7 @@
  * linha sozinho (script `version` → scripts/sync-versao.mjs); editando à mão,
  * suba as duas.
  */
-export declare const SDK_VERSAO = "0.7.2";
+export declare const SDK_VERSAO = "0.7.3-rc.3";
 export interface PerfilDispositivo {
     device_os?: string;
     fabricante?: string;

package/dist/cjs/perfil.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true}),exports.SDK_VERSAO=void 0,exports.coletarPerfil=coletarPerfil;const react_native_1=require("react-native"),storage_1=require("./storage");function moduloPerfil(){const mods=react_native_1.NativeModules;return"ios"===react_native_1.Platform.OS?mods.PushMeshApns:mods.PushMeshFirebase}function timezoneId(){try{return Intl.DateTimeFormat().resolvedOptions().timeZone||void 0}catch{return}}function pais(){try{const loc=Intl.DateTimeFormat().resolvedOptions().locale,m=/[-_]([A-Za-z]{2})(?:[-_]|$)/.exec(loc);return m?m[1].toUpperCase():void 0}catch{return}}async function proximaSessao(){const atual=Number(await(0,storage_1.getItem)(storage_1.KEYS.sessoes)??"0"),proxima=Number.isFinite(atual)&&atual>=0?atual+1:1;return await(0,storage_1.setItem)(storage_1.KEYS.sessoes,String(proxima)),proxima}function semVazios(p){const out={};for(const[k,v]of Object.entries(p))null!=v&&""!==v&&(out[k]=v);return out}async function coletarPerfil(){const perfil={sdk_versao:exports.SDK_VERSAO,timezone_id:timezoneId(),pais:pais()};try{perfil.sessoes=await proximaSessao()}catch{}try{const nativo=moduloPerfil();if(nativo?.perfilDispositivo){const n=await nativo.perfilDispositivo();Object.assign(perfil,{device_os:n.device_os,fabricante:n.fabricante,modelo:n.modelo,net_type:n.net_type,carrier:n.carrier,rooted:n.rooted,standby_bucket:n.standby_bucket,bateria_irrestrita:n.bateria_irrestrita,notif_permissoes:n.notif_permissoes,instalacao_id:n.instalacao_id})}}catch{}if(!perfil.device_os){const v=react_native_1.Platform.Version;perfil.device_os="string"==typeof v?v:String(v)}if(!perfil.fabricante){const c=react_native_1.Platform.constants;perfil.fabricante="ios"===react_native_1.Platform.OS?"Apple":c?.Manufacturer}return semVazios(perfil)}exports.SDK_VERSAO="0.7.2";
+"use strict";Object.defineProperty(exports,"__esModule",{value:true}),exports.SDK_VERSAO=void 0,exports.coletarPerfil=coletarPerfil;const react_native_1=require("react-native"),storage_1=require("./storage");function moduloPerfil(){const mods=react_native_1.NativeModules;return"ios"===react_native_1.Platform.OS?mods.PushMeshApns:mods.PushMeshFirebase}function timezoneId(){try{return Intl.DateTimeFormat().resolvedOptions().timeZone||void 0}catch{return}}function pais(){try{const loc=Intl.DateTimeFormat().resolvedOptions().locale,m=/[-_]([A-Za-z]{2})(?:[-_]|$)/.exec(loc);return m?m[1].toUpperCase():void 0}catch{return}}async function proximaSessao(){const atual=Number(await(0,storage_1.getItem)(storage_1.KEYS.sessoes)??"0"),proxima=Number.isFinite(atual)&&atual>=0?atual+1:1;return await(0,storage_1.setItem)(storage_1.KEYS.sessoes,String(proxima)),proxima}function semVazios(p){const out={};for(const[k,v]of Object.entries(p))null!=v&&""!==v&&(out[k]=v);return out}async function coletarPerfil(){const perfil={sdk_versao:exports.SDK_VERSAO,timezone_id:timezoneId(),pais:pais()};try{perfil.sessoes=await proximaSessao()}catch{}try{const nativo=moduloPerfil();if(nativo?.perfilDispositivo){const n=await nativo.perfilDispositivo();Object.assign(perfil,{device_os:n.device_os,fabricante:n.fabricante,modelo:n.modelo,net_type:n.net_type,carrier:n.carrier,rooted:n.rooted,standby_bucket:n.standby_bucket,bateria_irrestrita:n.bateria_irrestrita,notif_permissoes:n.notif_permissoes,instalacao_id:n.instalacao_id})}}catch{}if(!perfil.device_os){const v=react_native_1.Platform.Version;perfil.device_os="string"==typeof v?v:String(v)}if(!perfil.fabricante){const c=react_native_1.Platform.constants;perfil.fabricante="ios"===react_native_1.Platform.OS?"Apple":c?.Manufacturer}return semVazios(perfil)}exports.SDK_VERSAO="0.7.3-rc.3";

package/dist/cjs/permissions.d.ts

@@ -52,3 +52,20 @@ export declare function markReativaPending(messageId: string): Promise<void>;
 export declare function attachAppStateHook(): void;
 /** Remove o hook (hot reload / testes). */
 export declare function detachAppStateHook(): void;
+/**
+ * Grita quando o aparelho está MUDO — o defeito mais caro deste produto, e o
+ * mais silencioso.
+ *
+ * Sem a permissão, tudo dá "certo": o aparelho registra, o disparo responde
+ * `successful: 1`, o FCM aceita — e nada aparece na tela, e `recebidos` fica em
+ * zero para sempre. No Android 12 ou anterior isso quase não acontecia (a
+ * permissão vinha concedida de fábrica); a partir do Android 13 ela virou
+ * pedido em tempo de execução, então o app que nunca pede é um app cujo push
+ * nunca chega — e o integrador só descobre em produção, olhando um painel que
+ * diz "entregue".
+ *
+ * O SDK não pode pedir a permissão sozinho (ver `pedirPermissao` em types.ts),
+ * mas pode se recusar a ficar calado. Uma linha de console, uma vez por boot,
+ * dizendo o que fazer.
+ */
+export declare function avisarSeMudo(tipos: RpNotificationTypes): void;

package/dist/cjs/permissions.js

@@ -1 +1 @@
-"use strict";var __createBinding=this&&this.__createBinding||(Object.create?function(o,m,k,k2){void 0===k2&&(k2=k);var desc=Object.getOwnPropertyDescriptor(m,k);desc&&!("get"in desc?!m.__esModule:desc.writable||desc.configurable)||(desc={enumerable:true,get:function(){return m[k]}}),Object.defineProperty(o,k2,desc)}:function(o,m,k,k2){void 0===k2&&(k2=k),o[k2]=m[k]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(o,v){Object.defineProperty(o,"default",{enumerable:true,value:v})}:function(o,v){o.default=v}),__importStar=this&&this.__importStar||function(){var ownKeys=function(o){return ownKeys=Object.getOwnPropertyNames||function(o){var ar=[];for(var k in o)Object.prototype.hasOwnProperty.call(o,k)&&(ar[ar.length]=k);return ar},ownKeys(o)};return function(mod){if(mod&&mod.__esModule)return mod;var result={};if(null!=mod)for(var k=ownKeys(mod),i=0;i<k.length;i++)"default"!==k[i]&&__createBinding(result,mod,k[i]);return __setModuleDefault(result,mod),result}}();Object.defineProperty(exports,"__esModule",{value:true}),exports.mapAuthorizationStatus=mapAuthorizationStatus,exports.readNotificationTypes=readNotificationTypes,exports.canRequestNatively=canRequestNatively,exports.openNotificationSettings=openNotificationSettings,exports.reativarNotificacoes=reativarNotificacoes,exports.checkAndReport=checkAndReport,exports.markReativaPending=markReativaPending,exports.attachAppStateHook=attachAppStateHook,exports.detachAppStateHook=detachAppStateHook;const react_native_1=__importStar(require("@notifee/react-native")),react_native_2=require("react-native"),queue_1=require("./queue"),state_1=require("./state"),storage_1=require("./storage"),types_1=require("./types");function mapAuthorizationStatus(status){switch(status){case react_native_1.AuthorizationStatus.AUTHORIZED:case react_native_1.AuthorizationStatus.PROVISIONAL:return types_1.RpNotificationTypes.Ativo;case react_native_1.AuthorizationStatus.DENIED:return types_1.RpNotificationTypes.Bloqueado;case react_native_1.AuthorizationStatus.NOT_DETERMINED:default:return types_1.RpNotificationTypes.NuncaPerguntou}}async function readNotificationTypes(){return mapAuthorizationStatus((await react_native_1.default.getNotificationSettings()).authorizationStatus)}async function canRequestNatively(){return(await react_native_1.default.getNotificationSettings()).authorizationStatus===react_native_1.AuthorizationStatus.NOT_DETERMINED&&("ios"===react_native_2.Platform.OS||"android"===react_native_2.Platform.OS&&Number(react_native_2.Platform.Version)>=33)}async function openNotificationSettings(){if("android"===react_native_2.Platform.OS)return void await react_native_1.default.openNotificationSettings();const nativo=react_native_2.NativeModules.PushMeshApns;if(nativo?.abrirAjustesDeNotificacao)try{if(await nativo.abrirAjustesDeNotificacao())return}catch{}await react_native_2.Linking.openSettings()}async function reativarNotificacoes(){return await canRequestNatively()?await react_native_1.default.requestPermission():await openNotificationSettings(),1===await checkAndReport()}async function checkAndReport(){const current=await readNotificationTypes(),previousRaw=await(0,storage_1.getItem)(storage_1.KEYS.notificationTypes),previous=null===previousRaw?null:Number(previousRaw);if(previous===current)return current;const playerId=state_1.state.playerId??await(0,storage_1.getItem)(storage_1.KEYS.playerId);if(playerId&&state_1.state.config){const{sendOrQueue:sendOrQueue}=await Promise.resolve().then(()=>__importStar(require("./queue")));await sendOrQueue("PUT",`/api/v1/players/${playerId}`,{app_id:(0,state_1.requireConfig)().appId,notification_types:current}),await(0,storage_1.setItem)(storage_1.KEYS.notificationTypes,String(current))}if(current===types_1.RpNotificationTypes.Ativo&&null!==previous&&previous!==types_1.RpNotificationTypes.Ativo){const reativaPending=await(0,storage_1.getItem)(storage_1.KEYS.reativaPending);if(reativaPending){const{track:track}=await Promise.resolve().then(()=>__importStar(require("./inapp")));await track("reativou",reativaPending),await(0,storage_1.setItem)(storage_1.KEYS.reativaPending,"")}}return current}async function markReativaPending(messageId){await(0,storage_1.setItem)(storage_1.KEYS.reativaPending,messageId)}function attachAppStateHook(){state_1.state.appStateSubscription||(state_1.state.appStateSubscription=react_native_2.AppState.addEventListener("change",nextState=>{if("active"===nextState){const bgDesde=state_1.state.emBackgroundDesde;state_1.state.emBackgroundDesde=null,checkAndReport().catch(e=>console.warn("[PushMesh] checkAndReport falhou",e)),(0,queue_1.flushQueue)().catch(()=>{}),Promise.resolve().then(()=>__importStar(require("./inapp/lifecycle"))).then(m=>m.aoVoltarAoForeground(bgDesde)).catch(()=>{})}else null===state_1.state.emBackgroundDesde&&(state_1.state.emBackgroundDesde=Date.now())}))}function detachAppStateHook(){state_1.state.appStateSubscription?.remove(),state_1.state.appStateSubscription=null}
+"use strict";var __createBinding=this&&this.__createBinding||(Object.create?function(o,m,k,k2){void 0===k2&&(k2=k);var desc=Object.getOwnPropertyDescriptor(m,k);desc&&!("get"in desc?!m.__esModule:desc.writable||desc.configurable)||(desc={enumerable:true,get:function(){return m[k]}}),Object.defineProperty(o,k2,desc)}:function(o,m,k,k2){void 0===k2&&(k2=k),o[k2]=m[k]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(o,v){Object.defineProperty(o,"default",{enumerable:true,value:v})}:function(o,v){o.default=v}),__importStar=this&&this.__importStar||function(){var ownKeys=function(o){return ownKeys=Object.getOwnPropertyNames||function(o){var ar=[];for(var k in o)Object.prototype.hasOwnProperty.call(o,k)&&(ar[ar.length]=k);return ar},ownKeys(o)};return function(mod){if(mod&&mod.__esModule)return mod;var result={};if(null!=mod)for(var k=ownKeys(mod),i=0;i<k.length;i++)"default"!==k[i]&&__createBinding(result,mod,k[i]);return __setModuleDefault(result,mod),result}}();Object.defineProperty(exports,"__esModule",{value:true}),exports.mapAuthorizationStatus=mapAuthorizationStatus,exports.readNotificationTypes=readNotificationTypes,exports.canRequestNatively=canRequestNatively,exports.openNotificationSettings=openNotificationSettings,exports.reativarNotificacoes=reativarNotificacoes,exports.checkAndReport=checkAndReport,exports.markReativaPending=markReativaPending,exports.attachAppStateHook=attachAppStateHook,exports.detachAppStateHook=detachAppStateHook,exports.avisarSeMudo=avisarSeMudo;const react_native_1=__importStar(require("@notifee/react-native")),react_native_2=require("react-native"),queue_1=require("./queue"),state_1=require("./state"),storage_1=require("./storage"),types_1=require("./types");function mapAuthorizationStatus(status){switch(status){case react_native_1.AuthorizationStatus.AUTHORIZED:case react_native_1.AuthorizationStatus.PROVISIONAL:return types_1.RpNotificationTypes.Ativo;case react_native_1.AuthorizationStatus.DENIED:return types_1.RpNotificationTypes.Bloqueado;case react_native_1.AuthorizationStatus.NOT_DETERMINED:default:return types_1.RpNotificationTypes.NuncaPerguntou}}async function readNotificationTypes(){return mapAuthorizationStatus((await react_native_1.default.getNotificationSettings()).authorizationStatus)}async function canRequestNatively(){return(await react_native_1.default.getNotificationSettings()).authorizationStatus===react_native_1.AuthorizationStatus.NOT_DETERMINED&&("ios"===react_native_2.Platform.OS||"android"===react_native_2.Platform.OS&&Number(react_native_2.Platform.Version)>=33)}async function openNotificationSettings(){if("android"===react_native_2.Platform.OS)return void await react_native_1.default.openNotificationSettings();const nativo=react_native_2.NativeModules.PushMeshApns;if(nativo?.abrirAjustesDeNotificacao)try{if(await nativo.abrirAjustesDeNotificacao())return}catch{}await react_native_2.Linking.openSettings()}async function reativarNotificacoes(){return await canRequestNatively()?await react_native_1.default.requestPermission():await openNotificationSettings(),1===await checkAndReport()}async function checkAndReport(){const current=await readNotificationTypes(),previousRaw=await(0,storage_1.getItem)(storage_1.KEYS.notificationTypes),previous=null===previousRaw?null:Number(previousRaw);if(previous===current)return current;const playerId=state_1.state.playerId??await(0,storage_1.getItem)(storage_1.KEYS.playerId);if(playerId&&state_1.state.config){const{sendOrQueue:sendOrQueue}=await Promise.resolve().then(()=>__importStar(require("./queue")));await sendOrQueue("PUT",`/api/v1/players/${playerId}`,{app_id:(0,state_1.requireConfig)().appId,notification_types:current}),await(0,storage_1.setItem)(storage_1.KEYS.notificationTypes,String(current))}if(current===types_1.RpNotificationTypes.Ativo&&null!==previous&&previous!==types_1.RpNotificationTypes.Ativo){const reativaPending=await(0,storage_1.getItem)(storage_1.KEYS.reativaPending);if(reativaPending){const{track:track}=await Promise.resolve().then(()=>__importStar(require("./inapp")));await track("reativou",reativaPending),await(0,storage_1.setItem)(storage_1.KEYS.reativaPending,"")}}return current}async function markReativaPending(messageId){await(0,storage_1.setItem)(storage_1.KEYS.reativaPending,messageId)}function attachAppStateHook(){state_1.state.appStateSubscription||(state_1.state.appStateSubscription=react_native_2.AppState.addEventListener("change",nextState=>{if("active"===nextState){const bgDesde=state_1.state.emBackgroundDesde;state_1.state.emBackgroundDesde=null,checkAndReport().catch(e=>console.warn("[PushMesh] checkAndReport falhou",e)),(0,queue_1.flushQueue)().catch(()=>{}),Promise.resolve().then(()=>__importStar(require("./inapp/lifecycle"))).then(m=>m.aoVoltarAoForeground(bgDesde)).catch(()=>{})}else null===state_1.state.emBackgroundDesde&&(state_1.state.emBackgroundDesde=Date.now())}))}function detachAppStateHook(){state_1.state.appStateSubscription?.remove(),state_1.state.appStateSubscription=null}function avisarSeMudo(tipos){if(1===tipos)return;const comoResolver="chame await PushMesh.permissions.reativarNotificacoes() no momento certo do seu fluxo, ou passe { pedirPermissao: true } no init para pedir logo no boot.";console.warn(0===tipos?`[PushMesh] Este aparelho está com a notificação BLOQUEADA. O push vai ser aceito pelo FCM/APNs e NÃO vai aparecer na tela — e o recibo de entrega nunca chega. Como resolver: ${comoResolver}`:`[PushMesh] A permissão de notificação ainda não foi pedida a esta pessoa (Android 13+ e iOS exigem o pedido). Enquanto isso o push é entregue e não aparece. Como resolver: ${comoResolver}`)}

package/dist/cjs/state.d.ts

@@ -6,7 +6,7 @@ import type { PushMeshConfig } from './types';
  * como override para servidor próprio ou para apontar num servidor local
  * durante o desenvolvimento.
  */
-export declare const BASE_URL_PADRAO = "https://push.pushmesh.io";
+export declare const BASE_URL_PADRAO = "https://api.pushmesh.io";
 export declare function requireConfig(): PushMeshConfig;
 /** baseUrl sem barra final, para montar rotas sem '//'. */
 export declare function baseUrl(): string;

package/dist/cjs/state.js

@@ -1 +1 @@
-"use strict";function __resetForTests(){exports.state.appStateSubscription&&exports.state.appStateSubscription.remove(),exports.state.config=null,exports.state.playerId=null,exports.state.token=null,exports.state.externalUserId=null,exports.state.appStateSubscription=null,exports.state.emBackgroundDesde=null,exports.state.flushing=false,exports.state.initEmVoo=null,exports.state.logoutPendente=false,exports.state.transporte=null}function requireConfig(){if(!exports.state.config)throw new Error("[PushMesh] init() ainda não foi chamado. Como corrigir: chame PushMesh.init({ appId }) no boot do app.");return exports.state.config}function baseUrl(){return(requireConfig().baseUrl??exports.BASE_URL_PADRAO).replace(/\/+$/,"")}function emDesenvolvimento(){return"undefined"!=typeof __DEV__&&true===__DEV__}function validarBaseUrl(url){const limpa=url.trim();if(!(/^https:\/\//i.test(limpa)||/^http:\/\/(localhost|127\.0\.0\.1|10\.0\.2\.2|10\.0\.3\.2|\[::1\])(:\d+)?(\/|$)/i.test(limpa)&&emDesenvolvimento()))throw new Error("[PushMesh] baseUrl precisa ser https:// — pelo corpo das requisições trafegam o token de push e o external_user_id do usuário. Como corrigir: use https no servidor (http só é aceito para localhost em builds de desenvolvimento).")}Object.defineProperty(exports,"__esModule",{value:true}),exports.state=exports.BASE_URL_PADRAO=void 0,exports.__resetForTests=__resetForTests,exports.requireConfig=requireConfig,exports.baseUrl=baseUrl,exports.emDesenvolvimento=emDesenvolvimento,exports.validarBaseUrl=validarBaseUrl,exports.BASE_URL_PADRAO="https://push.pushmesh.io",exports.state={config:null,perfil:{},playerId:null,token:null,externalUserId:null,appStateSubscription:null,emBackgroundDesde:null,flushing:false,initEmVoo:null,logoutPendente:false,transporte:null};
+"use strict";function __resetForTests(){exports.state.appStateSubscription&&exports.state.appStateSubscription.remove(),exports.state.config=null,exports.state.playerId=null,exports.state.token=null,exports.state.externalUserId=null,exports.state.appStateSubscription=null,exports.state.emBackgroundDesde=null,exports.state.flushing=false,exports.state.initEmVoo=null,exports.state.logoutPendente=false,exports.state.transporte=null}function requireConfig(){if(!exports.state.config)throw new Error("[PushMesh] init() ainda não foi chamado. Como corrigir: chame PushMesh.init({ appId }) no boot do app.");return exports.state.config}function baseUrl(){return(requireConfig().baseUrl??exports.BASE_URL_PADRAO).replace(/\/+$/,"")}function emDesenvolvimento(){return"undefined"!=typeof __DEV__&&true===__DEV__}function validarBaseUrl(url){const limpa=url.trim();if(!(/^https:\/\//i.test(limpa)||/^http:\/\/(localhost|127\.0\.0\.1|10\.0\.2\.2|10\.0\.3\.2|\[::1\])(:\d+)?(\/|$)/i.test(limpa)&&emDesenvolvimento()))throw new Error("[PushMesh] baseUrl precisa ser https:// — pelo corpo das requisições trafegam o token de push e o external_user_id do usuário. Como corrigir: use https no servidor (http só é aceito para localhost em builds de desenvolvimento).")}Object.defineProperty(exports,"__esModule",{value:true}),exports.state=exports.BASE_URL_PADRAO=void 0,exports.__resetForTests=__resetForTests,exports.requireConfig=requireConfig,exports.baseUrl=baseUrl,exports.emDesenvolvimento=emDesenvolvimento,exports.validarBaseUrl=validarBaseUrl,exports.BASE_URL_PADRAO="https://api.pushmesh.io",exports.state={config:null,perfil:{},playerId:null,token:null,externalUserId:null,appStateSubscription:null,emBackgroundDesde:null,flushing:false,initEmVoo:null,logoutPendente:false,transporte:null};

package/dist/cjs/types.d.ts

@@ -24,7 +24,7 @@ export interface PushMeshConfig {
     appId: string;
     /**
      * Base URL do servidor PUSHMESH. OPCIONAL — sem ela vale o servidor
-     * oficial (https://push.pushmesh.io); só o `appId` basta para
+     * oficial (https://api.pushmesh.io); só o `appId` basta para
      * integrar. Passe uma URL para servidor próprio ou local no desenvolvimento
      * (http:// só é aceito para localhost em build de desenvolvimento).
      */
@@ -69,6 +69,22 @@ export interface PushMeshConfig {
      * `<PushMeshInAppHost />` na raiz: é uma linha e é o caminho provado.
      */
     inAppAutoMontar?: boolean;
+    /**
+     * Pede a permissão de notificação logo no `init` — o atalho de UMA LINHA
+     * para quem quer o caminho mais curto até o push funcionando.
+     *
+     * **Continua sendo opt-in, e o padrão continua sendo NÃO pedir.** Quem
+     * escolhe o momento do pedido é o aplicativo, não a biblioteca: no iOS a
+     * pessoa só é perguntada UMA vez na vida do app, e queimar esse tiro no
+     * primeiro segundo — antes de qualquer contexto — é a forma clássica de
+     * perder metade da base para sempre.
+     *
+     * Ligue quando o seu app não tem um "momento certo" melhor (ferramenta
+     * interna, app cujo valor central É a notificação, protótipo). Para o resto,
+     * deixe desligado e chame `PushMesh.permissions.reativarNotificacoes()` no
+     * ponto do seu fluxo em que a permissão faz sentido para a pessoa.
+     */
+    pedirPermissao?: boolean;
 }
 /**
  * Ação (discriminada por `tipo`) — contrato In-App V1 §2.1 / V2 §2.5.

package/ios/NotificationService/README.md

@@ -0,0 +1,108 @@
+# Images in iOS pushes — Notification Service Extension
+
+**Time: ~5 minutes, once per app.** After this, every message carrying an image
+shows that image on the iPhone, with nothing else to configure.
+
+> 🇧🇷 **Este guia também existe em português:** [LEIA-ME.md](./LEIA-ME.md)
+
+## Why there is a manual step here
+
+This SDK is "your App ID is enough" — and it stays that way everywhere else.
+This is the one step **Apple imposes** and no SDK can remove:
+
+- the server already sends everything (`mutable-content: 1` and the image URL in
+  the payload). That part is done and does not depend on you;
+- on iOS, whatever **downloads** the image is a separate process from your app,
+  called a *Notification Service Extension*. That process **only exists if your
+  project has a target of that type**;
+- without that target, the iPhone ignores `mutable-content` **silently**: the
+  notification arrives perfectly, just with no image. This is exactly the
+  "the image shows on Android but not on iOS" symptom.
+
+No code inside the app fixes it: with the app backgrounded or closed, the app
+does not even run when the push arrives. On Android none of this is needed —
+there the SDK itself downloads and displays.
+
+## Step by step
+
+1. Open your project in Xcode (`ios/YourApp.xcworkspace`).
+2. **File → New → Target… → Notification Service Extension → Next**.
+3. **Product Name**: `PushMeshNotificationService` (any name works).
+   Check **Team** (same as the app) and **Language: Swift** → **Finish**.
+4. Xcode asks whether to activate the new *scheme*: click **Cancel** — that keeps
+   your app's scheme selected to run.
+5. Xcode created a folder with a sample `NotificationService.swift`. Replace its
+   contents with ours, using **one command** at the root of your app:
+
+   ```sh
+   cp node_modules/@pushmesh/sdk/ios/NotificationService/PushMeshNotificationService.swift \
+      ios/PushMeshNotificationService/NotificationService.swift
+   ```
+
+   (adjust the destination path if you named the target differently)
+6. Run the app on a **real device**. Done.
+
+No `pod install`, no Podfile changes and no `AppDelegate` edits: the extension
+has no dependencies — only `Foundation` and `UserNotifications`, which ship with
+the system.
+
+## Details that cost you an afternoon if missed
+
+| Point | What to do |
+|---|---|
+| **Minimum Deployments** | Set the extension target to the **same** value as the app (e.g. iOS 15.1). Xcode usually creates the target on the newest iOS — and then, on every device running an earlier version, the extension simply **does not run** (no error, no warning: the image just never appears). |
+| **Bundle Identifier** | It must start with the app's: `com.yourcompany.app` → `com.yourcompany.app.PushMeshNotificationService`. Xcode gets this right on creation; but if you **rename the app's bundle later**, the extension's is **not** renamed with it and the build starts failing on signing. |
+| **Team / signing** | Same Team as the app. With **automatic** signing, Xcode creates the extension's profile by itself. With **manual** signing, you need a **second App ID + provisioning profile** (for the extension's bundle) in Apple's portal — the classic oversight when signing by hand. |
+| **NSExtensionPrincipalClass** | **Leave it alone.** The generated Info.plist points at `$(PRODUCT_MODULE_NAME).NotificationService`, and our file's class is called `NotificationService` precisely to match. Renaming the class without renaming it there makes the extension not run **silently**. |
+| **If you prefer dragging the file** (instead of `cp`) | Delete the generated `NotificationService.swift` first — two classes with the same name will not compile. When dragging, **uncheck "Copy items if needed"** and set *Target Membership* to **the extension target only**, never the app. Upside: `npm update` refreshes the file for you. Downside: your build now depends on `node_modules`. |
+
+### What is **not** needed (do not waste time)
+
+- **App Groups**: no. Those would only matter for the extension to exchange data
+  with the app — it does not; it downloads the image and delivers.
+- **Keychain Sharing**, **Background Modes** or **Push Notifications** *on the
+  extension target*: no. The **Push Notifications** capability stays on the
+  **app** target, where it already was.
+- **CocoaPods / Podfile**: no. The extension has no dependencies at all.
+- Touching the dashboard: no. Just fill in the image on the message — the server
+  already sends the flag that wakes the extension when there is media.
+
+## Limits that are Apple's (and what the extension does with them)
+
+- **Accepted formats**: `jpg`, `png`, `gif`. `webp`, `heic` and `avif` are
+  refused by iOS — serve jpg/png/gif from your CDN.
+- **Size**: up to 10 MB. In practice a good push image is **under 1 MB** (the
+  device downloads it at display time, often on a poor network).
+- **HTTPS**: mandatory. An `http://` URL is blocked by App Transport Security and
+  the download never leaves.
+- **Deadline**: Apple gives the extension ~30s. Ours uses 10s per attempt and 20s
+  overall; if it runs out, it delivers the notification **without** the image.
+- **How it looks**: thumbnail on the right of the banner; the large image appears
+  when the notification is **expanded** (pull down / long press).
+
+On any failure — 404, refused format, CDN down, deadline exceeded — **the
+notification still arrives complete, just without the image**. That is a law of
+this file and it is proven by an executable test in the SDK suite
+(`__tests__/ios-nse.test.ts`).
+
+## How to tell it is working
+
+With the iPhone connected to your Mac, open **Console.app**, select the device
+and filter for `[PushMesh NSE]`. Every give-up is logged with the **cause** and
+the **fix** (invalid URL, 404, unaccepted format, file too large, deadline
+exceeded).
+
+If **no** `[PushMesh NSE]` line shows up when a push with an image arrives, the
+extension is not running — recheck *Minimum Deployments* and *Bundle Identifier*
+in the table above.
+
+> Test on a **real device**. On the simulator, notification extension behaviour
+> varies with the Xcode version: a push without an image there proves nothing.
+
+## What this extension does not do yet
+
+**Delivery receipts in background / with the app closed.** Today iOS only counts
+what the app sees (app open, and taps on the notification); on Android the
+receipt is already real in all three states. That is the next front for this same
+extension — when it lands, the installation step stays exactly this one, with no
+rework.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pushmesh/sdk",
-  "version": "0.7.2",
-  "description": "SDK React Native do PUSHMESH — push com recibo real de entrega, reativação de permissão e banners in-app. API clássica inclusa.",
+  "version": "0.7.3-rc.3",
+  "description": "React Native SDK for PushMesh — push notifications with real delivery receipts, permission re-activation and in-app banners. Classic API included. (Guia em português: README.pt-BR.md)",
   "license": "MIT",
   "private": false,
   "main": "./dist/cjs/index.js",
@@ -20,7 +20,7 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "pushmesh-doctor": "./dist/cjs/doctor.js"
+    "pushmesh-doctor": "dist/cjs/doctor.js"
   },
   "sideEffects": false,
   "files": [
@@ -30,7 +30,10 @@
     "pushmesh-sdk.podspec",
     "react-native.config.js",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "README.pt-BR.md",
+    "app.plugin.js",
+    "plugin"
   ],
   "homepage": "https://pushmesh.io",
   "bugs": {
@@ -60,6 +63,7 @@
     "react-native": ">=0.71.0"
   },
   "devDependencies": {
+    "@expo/config-plugins": "^54.0.0",
     "@notifee/react-native": "^9.1.8",
     "@react-native-async-storage/async-storage": "^2.1.2",
     "@types/jest": "^29.5.14",
@@ -108,6 +112,15 @@
     "delivery-receipt",
     "android",
     "ios",
-    "sdk"
+    "sdk",
+    "delivery-receipts",
+    "push-sdk",
+    "react-native-push",
+    "mobile-push",
+    "onesignal-alternative",
+    "in-app-banners",
+    "expo",
+    "expo-config-plugin",
+    "expo-plugin"
   ]
 }

package/plugin/index.js

@@ -0,0 +1,226 @@
+/**
+ * Plugin de configuração do Expo para o @pushmesh/sdk.
+ *
+ * POR QUE EXISTE: num app Expo o `ios/` e o `android/` são GERADOS no prebuild,
+ * então tudo que se edita à mão no Xcode é apagado na próxima geração. Sem
+ * plugin, integrar push num app Expo obriga a sair do fluxo gerenciado — que é
+ * exatamente o oposto da promessa "uma linha e funciona".
+ *
+ * O QUE ELE FAZ (e o que deliberadamente NÃO faz):
+ *
+ *   Android → NADA. E isso é a vantagem, não uma lacuna: o módulo nativo já
+ *   declara POST_NOTIFICATIONS, o receiver e o trampolim de clique no próprio
+ *   AndroidManifest, e o modo zero-config busca os parâmetros do Firebase em
+ *   tempo de execução (GET /api/v1/apps/{id}/firebase_params). O app NÃO
+ *   precisa do google-services.json nem do plugin com.google.gms — o que
+ *   outros SDKs de push exigem e o que, num app Expo, significa carregar um
+ *   arquivo de credencial no repositório.
+ *
+ *   iOS → o que a Apple obriga e nenhum SDK consegue evitar:
+ *     1. a capability Push Notifications (entitlement `aps-environment`);
+ *     2. `remote-notification` em UIBackgroundModes — sem isso o iOS não
+ *        entrega push com o app em segundo plano;
+ *     3. a Notification Service Extension, que é a ÚNICA forma de o iPhone
+ *        baixar a imagem de um push. É o passo que a documentação descreve
+ *        como "5 minutos no Xcode, uma vez por app": aqui ele vira zero
+ *        minutos, e sobrevive ao prebuild.
+ *
+ * USO no app.json / app.config.js:
+ *
+ *   { "expo": { "plugins": [
+ *       ["@pushmesh/sdk", { "modo": "producao" }]
+ *   ] } }
+ *
+ * Sem opções, os padrões cobrem o caso comum.
+ */
+const {
+  AndroidConfig,
+  withEntitlementsPlist,
+  withInfoPlist,
+  withXcodeProject,
+  withDangerousMod,
+  createRunOncePlugin,
+} = require('@expo/config-plugins');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const pkg = require('../package.json');
+
+/** Nome do alvo da extensão. Fixo de propósito: o Info.plist gerado aponta
+ *  para `$(PRODUCT_MODULE_NAME).NotificationService`, e renomear sem renomear
+ *  lá faz a extensão não rodar EM SILÊNCIO. */
+const ALVO_NSE = 'PushMeshNotificationService';
+
+// ---------------------------------------------------------------------------
+// iOS — 1. capability Push Notifications
+// ---------------------------------------------------------------------------
+const comEntitlementPush = (config, { modo }) =>
+  withEntitlementsPlist(config, cfg => {
+    // 'development' usa o APNs de sandbox; 'production' o de produção. Errar
+    // isto é a armadilha clássica do push no iOS: o token de um ambiente é
+    // recusado no outro com BadDeviceToken, e o sintoma é "não chega nada".
+    // TestFlight e App Store usam PRODUÇÃO, mesmo em build de teste.
+    cfg.modResults['aps-environment'] = modo === 'producao' ? 'production' : 'development';
+    return cfg;
+  });
+
+// ---------------------------------------------------------------------------
+// iOS — 2. entrega em segundo plano
+// ---------------------------------------------------------------------------
+const comBackgroundModes = config =>
+  withInfoPlist(config, cfg => {
+    const modos = cfg.modResults.UIBackgroundModes ?? [];
+    if (!modos.includes('remote-notification')) modos.push('remote-notification');
+    cfg.modResults.UIBackgroundModes = modos;
+    return cfg;
+  });
+
+// ---------------------------------------------------------------------------
+// iOS — 3. a Notification Service Extension (imagem no push)
+// ---------------------------------------------------------------------------
+
+/** Escreve os arquivos da extensão dentro de `ios/<ALVO_NSE>/`. */
+const comArquivosDaExtensao = config =>
+  withDangerousMod(config, [
+    'ios',
+    async cfg => {
+      const destino = path.join(cfg.modRequest.platformProjectRoot, ALVO_NSE);
+      fs.mkdirSync(destino, { recursive: true });
+
+      // O Swift vem do pacote: uma fonte só para o código da extensão, então
+      // `npm update` atualiza a extensão junto com o SDK.
+      const origem = path.join(
+        __dirname,
+        '..',
+        'ios',
+        'NotificationService',
+        'PushMeshNotificationService.swift',
+      );
+      fs.copyFileSync(origem, path.join(destino, 'NotificationService.swift'));
+
+      // NSExtensionPrincipalClass casa com a classe do arquivo acima.
+      fs.writeFileSync(
+        path.join(destino, 'Info.plist'),
+        `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleDisplayName</key><string>${ALVO_NSE}</string>
+  <key>CFBundleExecutable</key><string>$(EXECUTABLE_NAME)</string>
+  <key>CFBundleIdentifier</key><string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+  <key>CFBundleInfoDictionaryVersion</key><string>6.0</string>
+  <key>CFBundleName</key><string>$(PRODUCT_NAME)</string>
+  <key>CFBundlePackageType</key><string>$(PRODUCT_BUNDLE_PACKAGE_TYPE)</string>
+  <key>CFBundleShortVersionString</key><string>$(MARKETING_VERSION)</string>
+  <key>CFBundleVersion</key><string>$(CURRENT_PROJECT_VERSION)</string>
+  <key>NSExtension</key>
+  <dict>
+    <key>NSExtensionPointIdentifier</key><string>com.apple.usernotifications.service</string>
+    <key>NSExtensionPrincipalClass</key><string>$(PRODUCT_MODULE_NAME).NotificationService</string>
+  </dict>
+</dict>
+</plist>
+`,
+      );
+      return cfg;
+    },
+  ]);
+
+/** Cria o alvo da extensão no projeto do Xcode. */
+const comAlvoDaExtensao = config =>
+  withXcodeProject(config, cfg => {
+    const projeto = cfg.modResults;
+
+    // Idempotente: o prebuild roda de novo a cada `expo prebuild`, e criar o
+    // alvo duas vezes deixa o projeto impossível de compilar.
+    if (projeto.pbxTargetByName(ALVO_NSE)) return cfg;
+
+    const bundleApp = cfg.ios?.bundleIdentifier;
+    if (!bundleApp) {
+      throw new Error(
+        '[@pushmesh/sdk] defina ios.bundleIdentifier no app.json antes do prebuild — ' +
+          'o bundle da extensão deriva dele.',
+      );
+    }
+
+    const grupo = projeto.addPbxGroup(
+      ['NotificationService.swift', 'Info.plist'],
+      ALVO_NSE,
+      ALVO_NSE,
+    );
+    // Pendura o grupo na raiz do projeto (o grupo sem nome é a raiz).
+    const grupos = projeto.hash.project.objects.PBXGroup;
+    for (const chave of Object.keys(grupos)) {
+      if (grupos[chave].name === undefined && grupos[chave].path === undefined) {
+        projeto.addToPbxGroup(grupo.uuid, chave);
+        break;
+      }
+    }
+
+    const alvo = projeto.addTarget(ALVO_NSE, 'app_extension', ALVO_NSE, `${bundleApp}.${ALVO_NSE}`);
+    projeto.addBuildPhase([], 'PBXSourcesBuildPhase', 'Sources', alvo.uuid);
+    projeto.addBuildPhase([], 'PBXResourcesBuildPhase', 'Resources', alvo.uuid);
+    projeto.addBuildPhase([], 'PBXFrameworksBuildPhase', 'Frameworks', alvo.uuid);
+    projeto.addSourceFile('NotificationService.swift', { target: alvo.uuid }, grupo.uuid);
+
+    // O alvo TEM de aceitar as mesmas versões de iOS que o app: o Xcode cria a
+    // extensão no iOS mais novo, e aí ela simplesmente NÃO RODA em aparelho
+    // com versão anterior — sem erro, sem aviso, a imagem só não aparece.
+    const minimoDoApp = cfg.ios?.deploymentTarget ?? '15.1';
+    const configs = projeto.pbxXCBuildConfigurationSection();
+    for (const chave of Object.keys(configs)) {
+      const build = configs[chave].buildSettings;
+      if (!build || build.PRODUCT_NAME !== `"${ALVO_NSE}"`) continue;
+      build.IPHONEOS_DEPLOYMENT_TARGET = minimoDoApp;
+      build.INFOPLIST_FILE = `"${ALVO_NSE}/Info.plist"`;
+      build.SWIFT_VERSION = '5.0';
+      build.TARGETED_DEVICE_FAMILY = '"1,2"';
+      build.CODE_SIGN_STYLE = 'Automatic';
+    }
+    return cfg;
+  });
+
+// ---------------------------------------------------------------------------
+// Android — só o ícone/cor, quando o app pedir
+// ---------------------------------------------------------------------------
+const comIconeAndroid = (config, { iconeNotificacao, corNotificacao }) => {
+  if (!iconeNotificacao && !corNotificacao) return config;
+  return AndroidConfig.Manifest.withAndroidManifest(config, cfg => {
+    const app = AndroidConfig.Manifest.getMainApplicationOrThrow(cfg.modResults);
+    const meta = (nome, valor) =>
+      AndroidConfig.Manifest.addMetaDataItemToMainApplication(app, nome, valor, 'resource');
+    if (iconeNotificacao) meta('com.google.firebase.messaging.default_notification_icon', iconeNotificacao);
+    if (corNotificacao) meta('com.google.firebase.messaging.default_notification_color', corNotificacao);
+    return cfg;
+  });
+};
+
+// ---------------------------------------------------------------------------
+const comPushMesh = (config, opcoes = {}) => {
+  const {
+    modo = 'desenvolvimento',
+    imagemNoPush = true,
+    iconeNotificacao,
+    corNotificacao,
+  } = opcoes;
+
+  if (modo !== 'desenvolvimento' && modo !== 'producao') {
+    throw new Error(
+      `[@pushmesh/sdk] modo "${modo}" desconhecido — use "desenvolvimento" ou "producao".`,
+    );
+  }
+
+  let cfg = config;
+  cfg = comEntitlementPush(cfg, { modo });
+  cfg = comBackgroundModes(cfg);
+  if (imagemNoPush) {
+    cfg = comArquivosDaExtensao(cfg);
+    cfg = comAlvoDaExtensao(cfg);
+  }
+  cfg = comIconeAndroid(cfg, { iconeNotificacao, corNotificacao });
+  return cfg;
+};
+
+// `createRunOncePlugin` evita aplicar duas vezes quando o plugin aparece em
+// mais de um lugar da árvore de configuração.
+module.exports = createRunOncePlugin(comPushMesh, pkg.name, pkg.version);