@pushmesh/sdk 0.7.2

package/dist/cjs/players.js

@@ -0,0 +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.payloadHash=payloadHash,exports.buildRegisterPayload=buildRegisterPayload,exports.__resetRegistroForTests=__resetRegistroForTests,exports.register=register,exports.login=login,exports.logout=logout,exports.init=init,exports.setToken=setToken,exports.getPlayerId=getPlayerId;const react_native_1=require("react-native"),http_1=require("./http"),perfil_1=require("./perfil"),queue_1=require("./queue"),state_1=require("./state"),storage_1=require("./storage"),types_1=require("./types"),GERACAO_REGISTRO=5;function payloadHash(payload){const{sessoes:_sessoes,...semSessoes}=payload,dia=(new Date).toISOString().slice(0,10),s=`g${GERACAO_REGISTRO}|d${dia}|${JSON.stringify(semSessoes,Object.keys(semSessoes).sort())}`;let h=2166136261;for(let i=0;i<s.length;i++)h^=s.charCodeAt(i),h=Math.imul(h,16777619);return(h>>>0).toString(16)}function resolveDeviceType(config){return config.deviceType&&"auto"!==config.deviceType?config.deviceType:"ios"===react_native_1.Platform.OS?types_1.RpDeviceType.IOS:types_1.RpDeviceType.Android}function resolveDeviceModel(config){if(config.deviceModel)return config.deviceModel;const constants=react_native_1.Platform.constants;return constants?.Model}function resolveLanguage(){try{return Intl.DateTimeFormat().resolvedOptions().locale}catch{return}}function resolveTimezoneOffsetSegundos(){try{const off=60*-(new Date).getTimezoneOffset();return Number.isFinite(off)?off:void 0}catch{return}}function buildRegisterPayload(){const config=(0,state_1.requireConfig)();if(!state_1.state.token)throw new Error("[PushMesh] sem token de push. Como corrigir: passe config.getToken no init ou chame PushMesh.setToken(token) quando o Firebase entregar o token.");const payload={app_id:config.appId,identifier:state_1.state.token,device_type:resolveDeviceType(config)};state_1.state.transporte&&(payload.transporte=state_1.state.transporte),state_1.state.externalUserId?payload.external_user_id=state_1.state.externalUserId:state_1.state.logoutPendente&&(payload.external_user_id=null),config.appVersion&&(payload.app_version=config.appVersion);const model=resolveDeviceModel(config);model&&(payload.device_model=model);const language=resolveLanguage();language&&(payload.language=language);const timezone=resolveTimezoneOffsetSegundos();void 0!==timezone&&(payload.timezone=timezone);const{modelo:modeloPerfil,...perfilSemModelo}=state_1.state.perfil;return Object.assign(payload,perfilSemModelo),!payload.device_model&&modeloPerfil&&(payload.device_model=modeloPerfil),payload}let registroEmVoo=null;function __resetRegistroForTests(){registroEmVoo=null}async function register(){const hash=payloadHash(buildRegisterPayload());if(registroEmVoo?.hash===hash)return registroEmVoo.promessa;const entrada={hash:hash,promessa:(registroEmVoo?.promessa??Promise.resolve(null)).then(registrarAgora,registrarAgora)};registroEmVoo=entrada;const liberar=()=>{registroEmVoo===entrada&&(registroEmVoo=null)};return entrada.promessa.then(liberar,liberar),entrada.promessa}async function registrarAgora(){const payload=buildRegisterPayload(),hash=payloadHash(payload),cachedHash=await(0,storage_1.getItem)(storage_1.KEYS.regHash),cachedPlayerId=await(0,storage_1.getItem)(storage_1.KEYS.playerId);if(cachedHash===hash&&cachedPlayerId)return state_1.state.playerId=cachedPlayerId,cachedPlayerId;const res=await(0,http_1.post)("/api/v1/players",payload);if(!res.ok)return console.warn(`[PushMesh] POST /players respondeu ${res.status}`),null;const body=res.json;if(!body?.id)return console.warn("[PushMesh] POST /players sem id na resposta"),null;state_1.state.playerId=body.id,await(0,storage_1.setItem)(storage_1.KEYS.playerId,body.id),await(0,storage_1.setItem)(storage_1.KEYS.regHash,hash),state_1.state.logoutPendente&&(state_1.state.logoutPendente=false,await(0,storage_1.removeItem)(storage_1.KEYS.logoutPendente));const{sincronizarReciboNativo:sincronizarReciboNativo}=await Promise.resolve().then(()=>__importStar(require("./zeroconfig")));await sincronizarReciboNativo(body.id).catch(()=>{});const{syncTagsPendentes:syncTagsPendentes}=await Promise.resolve().then(()=>__importStar(require("./tags")));return await syncTagsPendentes().catch(()=>{}),body.id}async function login(externalUserId){(0,state_1.requireConfig)(),state_1.state.externalUserId=externalUserId,await(0,storage_1.setItem)(storage_1.KEYS.externalUserId,externalUserId),state_1.state.logoutPendente=false,await(0,storage_1.removeItem)(storage_1.KEYS.logoutPendente);const playerId=await ensurePlayerId();playerId&&await(0,queue_1.sendOrQueue)("PUT",`/api/v1/players/${playerId}`,{app_id:(0,state_1.requireConfig)().appId,external_user_id:externalUserId})}async function logout(){(0,state_1.requireConfig)(),state_1.state.externalUserId=null,await(0,storage_1.removeItem)(storage_1.KEYS.externalUserId),state_1.state.logoutPendente=true,await(0,storage_1.setItem)(storage_1.KEYS.logoutPendente,"1");const playerId=state_1.state.playerId??await(0,storage_1.getItem)(storage_1.KEYS.playerId);playerId&&await(0,queue_1.sendOrQueue)("PUT",`/api/v1/players/${playerId}`,{app_id:(0,state_1.requireConfig)().appId,external_user_id:null})}async function ensurePlayerId(){if(state_1.state.playerId)return state_1.state.playerId;const cached=await(0,storage_1.getItem)(storage_1.KEYS.playerId);return cached&&(state_1.state.playerId=cached),cached}function textoOutroAppId(anterior,novo){return`[PushMesh] init com appId ${novo}, mas o SDK já está inicializado com ${anterior}. Como corrigir: o SDK é singleton do processo — use UM appId no boot do app.`}async function init(config){if(!config.appId)throw new Error("[PushMesh] config.appId é obrigatório.");if(state_1.state.initEmVoo){if(state_1.state.config&&state_1.state.config.appId!==config.appId)throw new Error(textoOutroAppId(state_1.state.config.appId,config.appId));return state_1.state.initEmVoo}const promessa=bootstrap(config);state_1.state.initEmVoo=promessa;try{await promessa}finally{state_1.state.initEmVoo=null}}async function bootstrap(config){state_1.state.config&&state_1.state.config.appId!==config.appId&&console.warn(textoOutroAppId(state_1.state.config.appId,config.appId));const baseUrl=config.baseUrl?.trim()||state_1.BASE_URL_PADRAO;if((0,state_1.validarBaseUrl)(baseUrl),state_1.state.config={...config,baseUrl:baseUrl},config=state_1.state.config,state_1.state.perfil=await(0,perfil_1.coletarPerfil)(),state_1.state.playerId=await(0,storage_1.getItem)(storage_1.KEYS.playerId),state_1.state.token=await(0,storage_1.getItem)(storage_1.KEYS.token),state_1.state.transporte="apns"===await(0,storage_1.getItem)(storage_1.KEYS.transporte)?"apns":null,state_1.state.externalUserId=await(0,storage_1.getItem)(storage_1.KEYS.externalUserId),state_1.state.logoutPendente="1"===await(0,storage_1.getItem)(storage_1.KEYS.logoutPendente),config.externalUserId&&config.externalUserId!==state_1.state.externalUserId&&await login(config.externalUserId).catch(e=>console.warn("[PushMesh] externalUserId do init não propagou agora — vai no registro",e)),config.getToken){state_1.state.transporte&&(state_1.state.transporte=null,await(0,storage_1.removeItem)(storage_1.KEYS.transporte));try{const token=await config.getToken();token&&token!==state_1.state.token&&(state_1.state.token=token,await(0,storage_1.setItem)(storage_1.KEYS.token,token))}catch(e){console.warn("[PushMesh] config.getToken falhou",e)}}else if("android"===react_native_1.Platform.OS){const{bootZeroConfigAndroid:bootZeroConfigAndroid}=await Promise.resolve().then(()=>__importStar(require("./zeroconfig")));await bootZeroConfigAndroid()}else{const{bootZeroConfigIos:bootZeroConfigIos}=await Promise.resolve().then(()=>__importStar(require("./zeroconfig")));await bootZeroConfigIos()}if(state_1.state.token)try{await register()}catch(e){console.warn("[PushMesh] registro falhou (rede?) — retenta no próximo boot",e)}if(!config.getToken)try{const zc=await Promise.resolve().then(()=>__importStar(require("./zeroconfig")));"android"===react_native_1.Platform.OS?(await zc.drenarMensagensPendentes(),await zc.processarCliqueInicial()):await zc.processarCliquePendenteIos()}catch(e){console.warn("[PushMesh] falha no pós-registro do zero-config (buffer/clique)",e)}await(0,queue_1.flushQueue)().catch(()=>{})}async function setToken(token){if(token&&token!==state_1.state.token&&(state_1.state.token=token,await(0,storage_1.setItem)(storage_1.KEYS.token,token),state_1.state.config))try{await register()}catch(e){console.warn("[PushMesh] registro pós-setToken falhou",e)}}async function getPlayerId(){return ensurePlayerId()}

package/dist/cjs/queue.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/queue.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true}),exports.FLUSH_CONCURRENCY=void 0,exports.__resetQueueForTests=__resetQueueForTests,exports.__drainQueueLockForTests=__drainQueueLockForTests,exports.backoffMs=backoffMs,exports.enqueue=enqueue,exports.sendOrQueue=sendOrQueue,exports.flushQueue=flushQueue;const http_1=require("./http"),storage_1=require("./storage"),state_1=require("./state"),MAX_ATTEMPTS=10,MAX_QUEUE_ITEMS=500,BASE_DELAY_MS=1e3,MAX_DELAY_MS=3e5,JITTER_MS=1e3;exports.FLUSH_CONCURRENCY=5;let localId=0,ultimoNascimento=0;function agoraMonotonico(){return ultimoNascimento=Math.max(Date.now(),ultimoNascimento+1),ultimoNascimento}function nextId(){return localId+=1,`${agoraMonotonico()}-${localId}`}function criadoEm(item){return Number(item.id.split("-")[0])||0}function chaveEstado(item){if("PUT"!==item.method)return null;const campos=Object.keys(item.body).filter(c=>"app_id"!==c).sort().join(",");return`${item.path}#${campos}`}const superadoEm=new Map;function marcarSuperado(chave,quando){chave&&quando>(superadoEm.get(chave)??0)&&superadoEm.set(chave,quando)}function estaSuperado(item){const chave=chaveEstado(item);return null!==chave&&(superadoEm.get(chave)??0)>criadoEm(item)}function avisaDescarte(item,motivo){console.warn(`[PushMesh] ${item.method} ${item.path} descartado — ${motivo}`)}function coalescer(itens){const posicao=new Map,saida=[];for(const item of itens){if(estaSuperado(item))continue;const chave=chaveEstado(item);if(null===chave){saida.push(item);continue}const idx=posicao.get(chave);void 0===idx?posicao.set(chave,saida.push(item)-1):criadoEm(item)>=criadoEm(saida[idx])&&(saida[idx]=item)}return saida}let naoPersistidos=[];function __resetQueueForTests(){superadoEm.clear(),naoPersistidos=[]}function guardarEmMemoria(itens){naoPersistidos.push(...itens),naoPersistidos.length>MAX_QUEUE_ITEMS&&naoPersistidos.splice(0,naoPersistidos.length-MAX_QUEUE_ITEMS)}let cadeia=Promise.resolve();function comTrava(op){const proxima=cadeia.then(op,op);return cadeia=proxima.then(()=>{},()=>{}),proxima}async function __drainQueueLockForTests(){await cadeia}function backoffMs(attempts,jitter=Math.random){return Math.min(BASE_DELAY_MS*2**attempts,MAX_DELAY_MS)+Math.floor(jitter()*JITTER_MS)}async function enqueue(method,path,body,delayMs=0){const novo={id:nextId(),method:method,path:path,body:body,attempts:0,nextAttemptAt:Date.now()+delayMs};marcarSuperado(chaveEstado(novo),criadoEm(novo)),await comTrava(async()=>{const{valor:valor,falhou:falhou}=await(0,storage_1.getJsonSeguro)(storage_1.KEYS.queue,[]);if(falhou)return guardarEmMemoria([novo]),void console.warn("[PushMesh] fila ilegível agora (storage ocupado) — item guardado em memória");const queue=coalescer([...valor,...naoPersistidos,novo]);if(naoPersistidos=[],queue.length>MAX_QUEUE_ITEMS){const descartados=queue.length-MAX_QUEUE_ITEMS;queue.splice(0,descartados),console.warn(`[PushMesh] fila cheia (teto ${MAX_QUEUE_ITEMS}) — ${descartados} item(ns) antigo(s) descartado(s)`)}await(0,storage_1.setJson)(storage_1.KEYS.queue,queue)})}async function sendOrQueue(method,path,body){const nascimento=agoraMonotonico();try{const res=await(0,http_1.request)(method,path,body);return 429===res.status||res.status>=500?(await enqueue(method,path,body,res.retryAfterMs??backoffMs(1)),true):res.ok?(marcarSuperado(chaveEstado({method:method,path:path,body:body}),nascimento),await purgarSuperados(),true):(avisaDescarte({method:method,path:path},`${res.status}: retry não corrige payload inválido`),false)}catch(e){if(e instanceof http_1.NetworkError)return await enqueue(method,path,body),true;throw e}}async function purgarSuperados(){await comTrava(async()=>{const{valor:valor,falhou:falhou}=await(0,storage_1.getJsonSeguro)(storage_1.KEYS.queue,[]);if(!falhou&&valor.length>0){const vivos=valor.filter(item=>!estaSuperado(item));vivos.length!==valor.length&&await(0,storage_1.setJson)(storage_1.KEYS.queue,vivos)}const{valor:emVoo,falhou:falhouVoo}=await(0,storage_1.getJsonSeguro)(storage_1.KEYS.queueInflight,[]);if(!falhouVoo&&emVoo.length>0){const vivosVoo=emVoo.filter(item=>!estaSuperado(item));vivosVoo.length!==emVoo.length&&await(0,storage_1.setJson)(storage_1.KEYS.queueInflight,vivosVoo)}})}async function resolverPlayer(item){if(null!==item.body.player_id)return true;const playerId=state_1.state.playerId??await(0,storage_1.getItem)(storage_1.KEYS.playerId);return!!playerId&&(item.body={...item.body,player_id:playerId},true)}async function processItem(item,now){const retry=(delayMs,attempts)=>attempts<10?{...item,attempts:attempts,nextAttemptAt:now+delayMs}:null;if(estaSuperado(item))return avisaDescarte(item,"escrita mais nova do mesmo campo já foi enviada"),null;if(!await resolverPlayer(item))return retry(backoffMs(item.attempts+1),item.attempts+1);try{const res=await(0,http_1.request)(item.method,item.path,item.body);return res.ok?null:429===res.status||res.status>=500?retry(res.retryAfterMs??backoffMs(item.attempts+1),item.attempts+1):(avisaDescarte(item,`${res.status}: retry não corrige payload inválido`),null)}catch{return retry(backoffMs(item.attempts+1),item.attempts+1)}}async function flushQueue(now=Date.now()){if(!state_1.state.flushing){state_1.state.flushing=true;try{const due=await comTrava(async()=>{const{valor:pendentes,falhou:falhou}=await(0,storage_1.getJsonSeguro)(storage_1.KEYS.queue,[]);if(falhou)return[];const{valor:emVoo,falhou:falhouVoo}=await(0,storage_1.getJsonSeguro)(storage_1.KEYS.queueInflight,[]);if(falhouVoo)return[];if(pendentes.length+emVoo.length+naoPersistidos.length===0)return[];const queue=coalescer([...emVoo,...pendentes,...naoPersistidos]);naoPersistidos=[];const prontos=queue.filter(item=>item.nextAttemptAt<=now),adiados=queue.filter(item=>item.nextAttemptAt>now);return await(0,storage_1.setJson)(storage_1.KEYS.queue,adiados),await(0,storage_1.setJson)(storage_1.KEYS.queueInflight,prontos),prontos});if(0===due.length)return;const devolver=[];let cursor=0;const worker=async()=>{for(;cursor<due.length;){const item=due[cursor++];try{const kept=await processItem(item,now);kept&&devolver.push(kept)}catch{devolver.push({...item,attempts:item.attempts+1,nextAttemptAt:now+backoffMs(item.attempts+1)})}}};await Promise.all(Array.from({length:Math.min(exports.FLUSH_CONCURRENCY,due.length)},()=>worker())),await comTrava(async()=>{const{valor:atual,falhou:falhou}=await(0,storage_1.getJsonSeguro)(storage_1.KEYS.queue,[]);if(falhou)return void guardarEmMemoria(devolver);const mesclado=coalescer([...devolver,...atual]);mesclado.length>MAX_QUEUE_ITEMS&&mesclado.splice(0,mesclado.length-MAX_QUEUE_ITEMS),await(0,storage_1.setJson)(storage_1.KEYS.queue,mesclado),await(0,storage_1.setJson)(storage_1.KEYS.queueInflight,[])})}finally{state_1.state.flushing=false}}}

package/dist/cjs/receipts.d.ts

@@ -0,0 +1,32 @@
+/** Apenas para testes: limpa o cache em memória (o storage é mockado à parte). */
+export declare function __resetLruForTests(): void;
+/** Eventos aceitos pelo servidor em POST /receipts. */
+export type EventoRecibo = 'recebido' | 'clique';
+/**
+ * Envia o recibo. Fire-and-forget: falha de rede/5xx vai para a fila offline e é
+ * reenviada no próximo init/foreground. Nunca duplica (LRU-64).
+ *
+ * O `evento` entra na CHAVE do dedup: entrega e clique são fatos distintos da
+ * MESMA notificação. Com a chave só no notification_id, o clique batia no
+ * "já visto" (a entrega sempre passa antes) e o POST nem saía — o painel
+ * mostrava cliques zerados para sempre. Defeito real, visto em campo.
+ *
+ * ORDEM É LEI (2026-08-01): o "já visto" só é marcado DEPOIS de o envio ser aceito
+ * (entregue ou guardado na fila). Devolve true quando o recibo foi aceito.
+ */
+export declare function sendReceipt(notificationId: string, rcpt: string, evento?: EventoRecibo): Promise<boolean>;
+/**
+ * Ponto de entrada: chame com o `data` da mensagem FCM/APNs recebida
+ * (foreground onMessage, background handler e notificação que abriu o app).
+ * No-op silencioso para pushes que não são do PUSHMESH (sem pm_msg_id).
+ *
+ * Dispara o evento 'foregroundWillDisplay' para os listeners registrados
+ * (dedup pelo LRU: duplicata não dispara 2x para pushes PUSHMESH).
+ */
+export declare function handlePushData(data: unknown): Promise<boolean>;
+/**
+ * Usuário tocou na notificação: dispara 'click' para os listeners e garante
+ * o recibo de entrega (dedup interno — se o foreground já recebeu, não repete).
+ * Chame no getInitialNotification / onNotificationOpenedApp do app host.
+ */
+export declare function handleClick(data: unknown): Promise<void>;

package/dist/cjs/receipts.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true}),exports.__resetLruForTests=__resetLruForTests,exports.sendReceipt=sendReceipt,exports.handlePushData=handlePushData,exports.handleClick=handleClick;const react_native_1=require("react-native"),events_1=require("./events"),queue_1=require("./queue"),state_1=require("./state"),storage_1=require("./storage"),LRU_SIZE=64;let lru=null;async function loadLru(){if(lru)return lru;const{valor:valor,falhou:falhou}=await(0,storage_1.getJsonSeguro)(storage_1.KEYS.receiptLru,[]);return falhou||(lru=valor),valor}async function markSeen(msgId){const list=await loadLru(),idx=list.indexOf(msgId);for(idx>=0&&list.splice(idx,1),list.push(msgId);list.length>64;)list.shift();lru===list&&await(0,storage_1.setJson)(storage_1.KEYS.receiptLru,list)}async function wasSeen(msgId){return(await loadLru()).includes(msgId)}function __resetLruForTests(){lru=null}async function sendReceipt(notificationId,rcpt,evento="recebido"){const chave="recebido"===evento?notificationId:`${notificationId}#${evento}`;if(await wasSeen(chave))return false;const config=(0,state_1.requireConfig)(),playerId=state_1.state.playerId??await(0,storage_1.getItem)(storage_1.KEYS.playerId),corpo={app_id:config.appId,notification_id:notificationId,player_id:playerId,rcpt:rcpt,evento:evento};let aceito;return playerId?aceito=await(0,queue_1.sendOrQueue)("POST","/api/v1/receipts",corpo):(console.warn("[PushMesh] recibo antes do registro — guardado na fila até existir player_id"),await(0,queue_1.enqueue)("POST","/api/v1/receipts",corpo),aceito=true),aceito&&await markSeen(chave),aceito}async function handlePushData(data){if(!data||"object"!=typeof data)return false;const d=data,msgId="string"==typeof d.pm_msg_id?d.pm_msg_id:null,rcpt="string"==typeof d.pm_rcpt?d.pm_rcpt:null;if(!msgId||!rcpt)return(0,events_1.emitNotificationEvent)("foregroundWillDisplay",d),false;const primeiraVez=!await wasSeen(msgId);try{return await sendReceipt(msgId,rcpt)}catch(e){return console.warn("[PushMesh] falha ao processar recibo",e),false}finally{primeiraVez&&(0,events_1.emitNotificationEvent)("foregroundWillDisplay",d)}}async function handleClick(data){if(!data||"object"!=typeof data)return;const d=data,msgId="string"==typeof d.pm_msg_id?d.pm_msg_id:null,rcpt="string"==typeof d.pm_rcpt?d.pm_rcpt:null;if(msgId&&rcpt&&await sendReceipt(msgId,rcpt,"clique").catch(e=>console.warn("[PushMesh] recibo do clique falhou",e)),(0,events_1.emitNotificationEvent)("click",d),"ios"===react_native_1.Platform.OS&&!temNativoApns()){const url="string"==typeof d.pm_url?d.pm_url.trim():"";url&&abrirQuandoAtivo(url)}}function temNativoApns(){return!!react_native_1.NativeModules.PushMeshApns}function abrirQuandoAtivo(url){const abrir=()=>react_native_1.Linking.openURL(url).catch(e=>console.warn("[PushMesh] não deu para abrir a pm_url do clique",e));if("active"===react_native_1.AppState.currentState)return void abrir();let feito=false;const sub=react_native_1.AppState.addEventListener("change",estado=>{feito||"active"!==estado||(feito=true,sub?.remove?.(),clearTimeout(timer),abrir())}),timer=setTimeout(()=>{feito||(feito=true,sub?.remove?.(),console.warn("[PushMesh] app não ficou ativo a tempo — pm_url não foi aberta"))},1e4)}

package/dist/cjs/state.d.ts

@@ -0,0 +1,21 @@
+import type { PushMeshConfig } from './types';
+/**
+ * Servidor oficial do PUSHMESH — usado quando o app NÃO passa `baseUrl`.
+ *
+ * O cliente integra com UMA linha (`PushMesh.init({ appId })`); `baseUrl` fica
+ * 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 function requireConfig(): PushMeshConfig;
+/** baseUrl sem barra final, para montar rotas sem '//'. */
+export declare function baseUrl(): string;
+/**
+ * HTTPS é obrigatório fora de desenvolvimento.
+ *
+ * Pelo corpo das rotas do SDK trafega o token de push e o external_user_id — que nos
+ * apps da casa é o CPF. Em `http://` isso vai em claro para qualquer um no mesmo
+ * Wi-Fi. Só liberamos texto puro em __DEV__ e para host local (emulador/simulador),
+ * onde o tráfego não sai da máquina.
+ */
+export declare function validarBaseUrl(url: string): void;

package/dist/cjs/state.js

@@ -0,0 +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};

package/dist/cjs/storage.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/storage.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=this&&this.__importDefault||function(mod){return mod&&mod.__esModule?mod:{default:mod}};Object.defineProperty(exports,"__esModule",{value:true}),exports.KEYS=void 0,exports.getItem=getItem,exports.setItem=setItem,exports.removeItem=removeItem,exports.getJsonSeguro=getJsonSeguro,exports.getJson=getJson,exports.setJson=setJson;const async_storage_1=__importDefault(require("@react-native-async-storage/async-storage"));async function getItem(key){try{return await async_storage_1.default.getItem(key)}catch{return null}}async function setItem(key,value){try{await async_storage_1.default.setItem(key,value)}catch{}}async function removeItem(key){try{await async_storage_1.default.removeItem(key)}catch{}}async function getJsonSeguro(key,fallback){let raw;try{raw=await async_storage_1.default.getItem(key)}catch{return{valor:fallback,falhou:true}}if(!raw)return{valor:fallback,falhou:false};try{return{valor:JSON.parse(raw),falhou:false}}catch{return{valor:fallback,falhou:false}}}async function getJson(key,fallback){return(await getJsonSeguro(key,fallback)).valor}async function setJson(key,value){await setItem(key,JSON.stringify(value))}exports.KEYS={playerId:"pm:player_id",regHash:"pm:reg_hash",externalUserId:"pm:external_user_id",logoutPendente:"pm:logout_pendente",token:"pm:token",transporte:"pm:transporte",firebaseParams:"pm:firebase_params",notificationTypes:"pm:notif_types",receiptLru:"pm:receipt_lru",sessoes:"pm:sessoes",queue:"pm:queue",queueInflight:"pm:queue_inflight",reativaPending:"pm:reativa_pending",tags:"pm:tags",triggers:"pm:triggers",inappPacote:"pm:inapp_pacote",inappEstado:"pm:inapp_estado",inappSessao:"pm:inapp_sessao"};

package/dist/cjs/tags.d.ts

@@ -0,0 +1,13 @@
+export declare function addTags(tags: Record<string, string>): Promise<void>;
+export declare function addTag(key: string, value: string): Promise<void>;
+export declare function removeTags(keys: string[]): Promise<void>;
+export declare function removeTag(key: string): Promise<void>;
+/** Mapa atual de tags (cache local). */
+export declare function getTags(): Promise<Record<string, string>>;
+/**
+ * Sincroniza tags que ficaram só no cache local por não haver player ainda.
+ * Chamado logo após um registro bem-sucedido — sem isto, quem chamou addTag antes
+ * do init terminar (o caso comum) só via a tag chegar ao servidor na PRÓXIMA vez que
+ * mexesse nela; nada no fluxo re-tentava.
+ */
+export declare function syncTagsPendentes(): Promise<void>;

package/dist/cjs/tags.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true}),exports.addTags=addTags,exports.addTag=addTag,exports.removeTags=removeTags,exports.removeTag=removeTag,exports.getTags=getTags,exports.syncTagsPendentes=syncTagsPendentes;const queue_1=require("./queue"),state_1=require("./state"),storage_1=require("./storage");async function syncTags(tags){if(!state_1.state.config)return;const playerId=state_1.state.playerId??await(0,storage_1.getItem)(storage_1.KEYS.playerId);playerId&&await(0,queue_1.sendOrQueue)("PUT",`/api/v1/players/${playerId}`,{app_id:(0,state_1.requireConfig)().appId,tags:tags})}async function addTags(tags){const next={...await(0,storage_1.getJson)(storage_1.KEYS.tags,{}),...tags};await(0,storage_1.setJson)(storage_1.KEYS.tags,next),await syncTags(next)}async function addTag(key,value){await addTags({[key]:value})}async function removeTags(keys){const next={...await(0,storage_1.getJson)(storage_1.KEYS.tags,{})};for(const key of keys)delete next[key];await(0,storage_1.setJson)(storage_1.KEYS.tags,next),await syncTags(next)}async function removeTag(key){await removeTags([key])}async function getTags(){return(0,storage_1.getJson)(storage_1.KEYS.tags,{})}async function syncTagsPendentes(){const tags=await(0,storage_1.getJson)(storage_1.KEYS.tags,{});0!==Object.keys(tags).length&&await syncTags(tags)}

package/dist/cjs/triggers.d.ts

@@ -0,0 +1,22 @@
+/** Valor de um gatilho do app: texto, número ou booleano. */
+export type RpValorGatilho = string | number | boolean;
+type Mapa = Record<string, RpValorGatilho>;
+/** Define vários gatilhos de uma vez (mescla com os que já existem). */
+export declare function definirGatilhos(gatilhos: Mapa): Promise<void>;
+/** Define um gatilho do app (ex.: `definirGatilho('tela', 'checkout')`). */
+export declare function definirGatilho(chave: string, valor: RpValorGatilho): Promise<void>;
+/** Remove vários gatilhos do mapa. */
+export declare function removerGatilhos(chaves: string[]): Promise<void>;
+/** Remove um gatilho (ex.: ao sair da tela que o definiu). */
+export declare function removerGatilho(chave: string): Promise<void>;
+/** Esvazia o mapa de gatilhos do app. */
+export declare function limparGatilhos(): Promise<void>;
+/** Mapa atual de gatilhos do app (leitura local). */
+export declare function lerGatilhos(): Promise<Mapa>;
+export declare const addTriggers: typeof definirGatilhos;
+export declare const addTrigger: typeof definirGatilho;
+export declare const removeTriggers: typeof removerGatilhos;
+export declare const removeTrigger: typeof removerGatilho;
+export declare const clearTriggers: typeof limparGatilhos;
+export declare const getTriggers: typeof lerGatilhos;
+export {};

package/dist/cjs/triggers.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true}),exports.getTriggers=exports.clearTriggers=exports.removeTrigger=exports.removeTriggers=exports.addTrigger=exports.addTriggers=void 0,exports.definirGatilhos=definirGatilhos,exports.definirGatilho=definirGatilho,exports.removerGatilhos=removerGatilhos,exports.removerGatilho=removerGatilho,exports.limparGatilhos=limparGatilhos,exports.lerGatilhos=lerGatilhos;const lifecycle_1=require("./inapp/lifecycle"),storage_1=require("./storage");async function ler(){return(0,storage_1.getJson)(storage_1.KEYS.triggers,{})}async function gravar(mapa){await(0,storage_1.setJson)(storage_1.KEYS.triggers,mapa),(0,lifecycle_1.aoMudarGatilhos)()}async function definirGatilhos(gatilhos){await gravar({...await ler(),...gatilhos})}async function definirGatilho(chave,valor){await definirGatilhos({[chave]:valor})}async function removerGatilhos(chaves){const mapa={...await ler()};for(const chave of chaves)delete mapa[chave];await gravar(mapa)}async function removerGatilho(chave){await removerGatilhos([chave])}async function limparGatilhos(){await gravar({})}async function lerGatilhos(){return ler()}exports.addTriggers=definirGatilhos,exports.addTrigger=definirGatilho,exports.removeTriggers=removerGatilhos,exports.removeTrigger=removerGatilho,exports.clearTriggers=limparGatilhos,exports.getTriggers=lerGatilhos;

package/dist/cjs/types.d.ts

@@ -0,0 +1,258 @@
+/**
+ * Tipos públicos do SDK PUSHMESH.
+ *
+ * Contrato das rotas de SDK:
+ * rotas de SDK são públicas (app_id no corpo, sem Authorization),
+ * rate-limited por IP no servidor.
+ */
+/** device_type do contrato de registro (0 iOS / 1 Android). */
+export declare enum RpDeviceType {
+    IOS = 0,
+    Android = 1
+}
+/** notification_types do contrato de permissão (SPEC_INAPP_REATIVACAO §1). */
+export declare enum RpNotificationTypes {
+    /** ativo / inscrito */
+    Ativo = 1,
+    /** nunca perguntou / desconhecido (notDetermined) */
+    NuncaPerguntou = 0,
+    /** bloqueou / desinscreveu (denied) */
+    Bloqueado = -2
+}
+export interface PushMeshConfig {
+    /** UUID do app no PUSHMESH (obrigatório). */
+    appId: string;
+    /**
+     * Base URL do servidor PUSHMESH. OPCIONAL — sem ela vale o servidor
+     * oficial (https://push.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).
+     */
+    baseUrl?: string;
+    /**
+     * Provedor do token de push do app host (MODO HOST). O SDK não embute o
+     * Firebase do host: quem já tem @react-native-firebase/messaging entrega o
+     * token por aqui OU chama PushMesh.setToken(token) depois do init.
+     *
+     * Opcional (MODO ZERO-CONFIG): sem getToken, o SDK obtém o token sozinho —
+     * no Android, busca os parâmetros públicos do Firebase no servidor
+     * (GET /api/v1/apps/:appId/firebase_params) e inicializa o FirebaseApp do
+     * app por código; no iOS, captura o token APNs DIRETO via módulo nativo
+     * (sem Firebase; o registro sai com transporte 'apns').
+     * getToken SEMPRE vence quando presente (precedência do modo host — nesse
+     * caso o transporte segue o default do servidor, 'fcm').
+     */
+    getToken?: () => Promise<string>;
+    /**
+     * device_type explícito. Default: 'auto' (0 iOS / 1 Android via Platform).
+     */
+    deviceType?: 'auto' | RpDeviceType;
+    /** Versão do app (ex.: '3.2.1') — vai no registro do player. */
+    appVersion?: string;
+    /** Modelo do aparelho (ex.: 'SM-A32') — se omitido o SDK tenta Platform.constants. */
+    deviceModel?: string;
+    /**
+     * external_user_id já conhecido no boot (ex.: CPF salvo em sessão).
+     * Equivalente a chamar login() logo após o init — inclusive na TROCA de
+     * usuário: se diferir do gravado, o init faz o login do novo (o anterior
+     * não fica colado no aparelho).
+     */
+    externalUserId?: string;
+    /** Timeout de rede por chamada em ms. Default: 10000. */
+    requestTimeoutMs?: number;
+    /**
+     * Montagem AUTOMÁTICA do host in-app. Default: **false** (opt-in) enquanto a
+     * via segura não fica pronta: hoje ela troca o provedor de wrapper do React
+     * Native, e um wrapper registrado pelo app ANTES de importar o SDK seria
+     * apagado (o RN só tem setter, não devolve o wrapper atual) — SafeArea,
+     * Redux, tema sumiriam em silêncio. Com o padrão, monte
+     * `<PushMeshInAppHost />` na raiz: é uma linha e é o caminho provado.
+     */
+    inAppAutoMontar?: boolean;
+}
+/**
+ * Ação (discriminada por `tipo`) — contrato In-App V1 §2.1 / V2 §2.5.
+ * F1/F2 aceitam exatamente estes três; o SDK confirma `open_url` com
+ * `Linking.canOpenURL` antes de abrir (falha fecha limpo, nunca crasha o host).
+ */
+export type RpInAppAction = {
+    tipo: 'dismiss';
+} | {
+    tipo: 'open_url';
+    url: string;
+} | {
+    tipo: 'open_notification_settings';
+};
+/** Botão de conteúdo — rótulo + ação (contrato §2.1). */
+export interface RpInAppButton {
+    texto: string;
+    acao: RpInAppAction;
+}
+/** Formatos servidos (contrato V2 §4). */
+export type RpInAppFormato = 'banner_top' | 'banner_bottom' | 'modal' | 'fullscreen';
+export interface RpBlocoTexto {
+    tipo: 'texto';
+    texto: string;
+    fonte?: 'sistema' | 'serifada' | 'monoespacada';
+    peso?: 'regular' | 'medio' | 'negrito';
+    italico?: boolean;
+    sublinhado?: boolean;
+    cor?: string;
+    tamanho?: number;
+    alinhamento?: 'esquerda' | 'centro' | 'direita';
+}
+export interface RpBlocoImagem {
+    tipo: 'imagem';
+    url: string;
+    acao_click?: RpInAppAction | null;
+    sangra?: boolean;
+    raio?: number;
+    /** Respiro por lado em px (0..64, default 0) — contrato V2 §2.2. Campo
+     * ausente = tudo 0. Sem este tipo o painel emitiria e o SDK descartaria
+     * em silêncio (a classe de bug que zerou o funil na F1). */
+    margens?: {
+        topo?: number;
+        direita?: number;
+        baixo?: number;
+        esquerda?: number;
+    };
+}
+export interface RpBlocoBotao {
+    tipo: 'botao';
+    texto: string;
+    acao: RpInAppAction;
+    cor_fundo?: string;
+    cor_texto?: string;
+    raio?: number;
+    /**
+     * Tipografia do RÓTULO — os MESMOS nomes e valores do bloco de texto (o
+     * renderizador reusa as mesmas funções: uma implementação só). Campo ausente
+     * = o desenho de hoje (peso 600, 15 px, fonte do sistema, centralizado).
+     * Sem estes campos no tipo, o painel emitiria e o SDK DESCARTARIA em
+     * silêncio — a classe de bug que já nos mordeu quatro vezes.
+     */
+    fonte?: 'sistema' | 'serifada' | 'monoespacada';
+    peso?: 'regular' | 'medio' | 'negrito';
+    italico?: boolean;
+    sublinhado?: boolean;
+    tamanho?: number;
+    alinhamento?: 'esquerda' | 'centro' | 'direita';
+}
+export interface RpBlocoEspacador {
+    tipo: 'espacador';
+    altura: number;
+}
+/** União aberta: o `{ tipo: string }` final é o cinto de segurança (V9). */
+export type RpBloco = RpBlocoTexto | RpBlocoImagem | RpBlocoBotao | RpBlocoEspacador | {
+    tipo: string;
+};
+/** Chrome da mensagem — superset aditivo do estilo V1 (contrato V2 §3). */
+export interface RpInAppEstilo {
+    fundo?: string;
+    texto?: string;
+    botao_fundo?: string;
+    botao_texto?: string;
+    raio?: number;
+    escurecer?: number;
+    padding_px?: number;
+    imagem_sangra?: boolean;
+    fundo_imagem?: string | null;
+    /**
+     * X de fechar. `cor` é o glifo e `fundo` é o chip atrás dele; AUSENTES, o
+     * renderizador decide por CONTRASTE AUTOMÁTICO (nunca X preto sobre cartão
+     * preto, nunca chip escuro sob glifo escuro). Sem `cor`/`fundo` no tipo, o
+     * campo do painel seria descartado em silêncio.
+     */
+    close?: {
+        mostrar?: boolean;
+        icone?: 'x' | 'x_circulo' | 'seta';
+        tamanho?: number;
+        cor?: string;
+        /**
+         * Chip atrás do glifo. AUSENTE e `null` são DIFERENTES (contrato V2 §3.2):
+         * ausente = o renderizador decide (chip automático quando há arte atrás);
+         * `null` = SEM chip, e vence até o automático — é a mão do operador dizendo
+         * "não quero". Sem o `| null` aqui o SDK engolia o `null` como ausente e o
+         * chip VOLTAVA depois de tirado (achado do auditor 2026-08-04).
+         */
+        fundo?: string | null;
+    };
+    acao_card?: RpInAppAction | null;
+}
+/**
+ * `conteudo` resolvido (flat) que vem no pending: OU os campos fixos do V1,
+ * OU a pilha `blocos[]` do schema 2 — nunca os dois (contrato V2 §1.1).
+ */
+export interface RpInAppConteudo {
+    imagem?: string | null;
+    titulo?: string | null;
+    corpo?: string | null;
+    botao?: RpInAppButton | null;
+    botao_secundario?: RpInAppButton | null;
+    acao_card?: RpInAppAction | null;
+    blocos?: RpBloco[];
+}
+/**
+ * QUANDO a mensagem aparece (contrato §2.3), sempre decidido NO APARELHO.
+ * Forma PLANA: campo que não pertence ao `tipo` vem ausente — e o aparelho
+ * ignora o que sobrar, nunca adivinha.
+ */
+export interface RpInAppGatilho {
+    /** `ao_abrir` · `evento` · `sessao_duracao` · `inatividade` (desconhecido é ignorado). */
+    tipo: string;
+    /** atraso entre a condição casar e exibir (0..60000). */
+    atraso_ms?: number;
+    /** SÓ `evento`: chave que o app define com `PushMesh.definirGatilho`. */
+    chave?: string;
+    /** SÓ `evento`: como comparar. */
+    comparador?: 'igual' | 'diferente' | 'maior' | 'menor' | 'existe' | 'nao_existe';
+    /** SÓ `evento`: o TIPO deste valor manda na comparação (texto ou número). */
+    valor?: string | number;
+    /** SÓ `sessao_duracao`: segundos nesta sessão. */
+    segundos?: number;
+    /** SÓ `inatividade`: horas desde a última abertura do app. */
+    horas?: number;
+}
+/** Regras que o APARELHO aplica (device-first) — contrato §2.4/§2.3.6. */
+export interface RpInAppRegras {
+    /** exibições no total neste aparelho (0 = ilimitado). */
+    cap_total?: number;
+    /** respiro entre exibições da mesma campanha (horas). */
+    cooldown_h?: number;
+    /** auto-dismiss em ms (0 = desligado). */
+    fechar_apos_ms?: number;
+    /** cronograma: não exibir ANTES deste instante (ISO-8601 UTC; null = já). */
+    inicia_em?: string | null;
+    expira_em?: string | null;
+    prioridade?: number;
+}
+/** Uma mensagem do pacote (GET /api/v1/inapp/pending §2). */
+export interface RpInAppMessage {
+    id: string;
+    /** pm_iam — o SDK só ECOA no recibo; NUNCA calcula (contrato §3). */
+    prova?: string;
+    /** schema SERVIDO (1 campos fixos · 2 blocos · 3 + gatilhos novos). */
+    schema?: 1 | 2 | 3;
+    formato: RpInAppFormato;
+    conteudo: RpInAppConteudo;
+    estilo?: RpInAppEstilo;
+    gatilho?: RpInAppGatilho;
+    regras?: RpInAppRegras;
+}
+/**
+ * O pacote da sessão (GET /api/v1/inapp/pending §1). O aparelho o guarda com
+ * ETag e decide a exibição localmente durante toda a `validade_s`.
+ */
+export interface RpInAppPacote {
+    pacote_id: string | null;
+    messages: RpInAppMessage[];
+    validade_s: number;
+    cap_global_h: number;
+    etag: string | null;
+}
+/**
+ * Eventos do funil in-app (contrato §4.1). F1 envia `impressao | clique |
+ * fechou`; `reativou`/`imagem_falhou` são reservados da F2 (o servidor ainda
+ * não os aceita — o SDK os trata como no-op até lá).
+ */
+export type RpInAppEventType = 'impressao' | 'clique' | 'fechou' | 'reativou' | 'imagem_falhou';

package/dist/cjs/types.js

@@ -0,0 +1 @@
+"use strict";var RpDeviceType,RpNotificationTypes;Object.defineProperty(exports,"__esModule",{value:true}),exports.RpNotificationTypes=exports.RpDeviceType=void 0,function(RpDeviceType){RpDeviceType[RpDeviceType.IOS=0]="IOS",RpDeviceType[RpDeviceType.Android=1]="Android"}(RpDeviceType||(exports.RpDeviceType=RpDeviceType={})),function(RpNotificationTypes){RpNotificationTypes[RpNotificationTypes.Ativo=1]="Ativo",RpNotificationTypes[RpNotificationTypes.NuncaPerguntou=0]="NuncaPerguntou",RpNotificationTypes[RpNotificationTypes.Bloqueado=-2]="Bloqueado"}(RpNotificationTypes||(exports.RpNotificationTypes=RpNotificationTypes={}));

package/dist/cjs/zeroconfig.d.ts

@@ -0,0 +1,45 @@
+/** Parâmetros públicos do Firebase Android (contrato do servidor). */
+export interface FirebaseParamsAndroid {
+    project_id?: string | null;
+    sender_id: string;
+    app_id: string;
+    api_key: string;
+    package_name?: string;
+}
+/** Apenas para testes. */
+export declare function __resetZeroConfigForTests(): void;
+/**
+ * Marcador do dual-run: a mensagem é NOSSA quando tem chave `pmx_*` (bloco de
+ * exibição data-only do servidor). ESPELHO do `isNossa` no Kotlin
+ * (PushMeshMessageRouter) — mudou aqui, muda lá. Mensagem sem o marcador é
+ * de outra origem (ex.: provedor legado) e passa intocada.
+ */
+export declare function mensagemDoPushMesh(data: Record<string, unknown>): boolean;
+/**
+ * Boot do modo zero-config Android. Chamado por players.init quando não há
+ * getToken. Nunca lança — falhas viram warn que ensina.
+ */
+export declare function bootZeroConfigAndroid(): Promise<void>;
+/**
+ * Entrega ao nativo Android a config do recibo DIRETO (POST Kotlin mesmo com
+ * o JS morto). Chamado por players.register() após cada registro bem-sucedido.
+ */
+export declare function sincronizarReciboNativo(playerId: string): Promise<void>;
+/**
+ * Boot do modo zero-config iOS: APNs DIRETO (sem Firebase). Chamado por
+ * players.init quando não há getToken e a plataforma é iOS.
+ * Nunca lança — falhas viram warn que ensina.
+ */
+export declare function bootZeroConfigIos(): Promise<void>;
+/**
+ * Drena as mensagens recebidas SEM JS ativo (app morto/background), bufferizadas
+ * pelo nativo. Chamado por players.init DEPOIS do register() — o recibo de
+ * entrega precisa do player_id, que só existe após o registro.
+ * No-op quando o módulo nativo está ausente (o boot já avisou).
+ * Um item que falha NÃO derruba o resto do buffer.
+ */
+export declare function drenarMensagensPendentes(): Promise<void>;
+/** Clique com o app MORTO (Android): extras do launch intent via nativo. */
+export declare function processarCliqueInicial(): Promise<void>;
+/** Clique com o app MORTO (iOS): payload pendente guardado pelo nativo. */
+export declare function processarCliquePendenteIos(): Promise<void>;

package/dist/cjs/zeroconfig.js

@@ -0,0 +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.__resetZeroConfigForTests=__resetZeroConfigForTests,exports.mensagemDoPushMesh=mensagemDoPushMesh,exports.bootZeroConfigAndroid=bootZeroConfigAndroid,exports.sincronizarReciboNativo=sincronizarReciboNativo,exports.bootZeroConfigIos=bootZeroConfigIos,exports.drenarMensagensPendentes=drenarMensagensPendentes,exports.processarCliqueInicial=processarCliqueInicial,exports.processarCliquePendenteIos=processarCliquePendenteIos;const react_native_1=require("react-native"),http_1=require("./http"),receipts_1=require("./receipts"),state_1=require("./state"),storage_1=require("./storage"),ERRO_ANDROID_NAO_CONFIGURADO="[PushMesh] zero-config: app Android não configurado no servidor. Como corrigir: cole o google-services.json no painel (Configurações → FCM) ou passe getToken no init.",ERRO_RESPOSTA_NAO_JSON="[PushMesh] zero-config: firebase_params respondeu 200 SEM JSON (portal cativo/proxy?) — não é o painel. Como corrigir: saia da rede com portal; retenta no próximo boot.",ERRO_MODULO_AUSENTE="[PushMesh] zero-config: módulo nativo PushMeshFirebase ausente (JS puro/Expo Go). Como corrigir: rebuild nativo (npx react-native run-android) ou passe getToken no init.",ERRO_MODULO_APNS_AUSENTE="[PushMesh] zero-config iOS: módulo nativo PushMeshApns ausente (JS puro/Expo Go). Como corrigir: cd ios && pod install + rebuild, ou passe getToken no init.";function moduloNativo(){return react_native_1.NativeModules.PushMeshFirebase}function moduloApns(){return react_native_1.NativeModules.PushMeshApns}let eventosConectados=false,eventosApnsConectados=false;function __resetZeroConfigForTests(){eventosConectados=false,eventosApnsConectados=false}function mensagemDoPushMesh(data){return Object.keys(data).some(k=>k.startsWith("pmx_"))}async function bootZeroConfigAndroid(){const nativo=moduloNativo();if(!nativo)return void console.warn(ERRO_MODULO_AUSENTE);conectarEventos();const cached=await lerParamsCache();if(cached)return await configureNativo(nativo,cached),await sincronizarToken(nativo),void revalidarParamsEmBackground(nativo,cached);const fresco=await buscarFirebaseParams();fresco&&(await(0,storage_1.setItem)(storage_1.KEYS.firebaseParams,JSON.stringify(fresco)),await configureNativo(nativo,fresco),await sincronizarToken(nativo))}async function lerParamsCache(){const raw=await(0,storage_1.getItem)(storage_1.KEYS.firebaseParams);if(!raw)return null;try{const parsed=JSON.parse(raw);return parsed&&"string"==typeof parsed.app_id?parsed:null}catch{return null}}async function buscarFirebaseParams(){let res;try{res=await(0,http_1.get)(`/api/v1/apps/${(0,state_1.requireConfig)().appId}/firebase_params`)}catch(e){return console.warn("[PushMesh] zero-config: rede falhou em firebase_params — retenta no boot.",e),null}if(!res.ok)return console.warn(`[PushMesh] zero-config: firebase_params respondeu ${res.status}.`),null;if(!res.json||"object"!=typeof res.json)return console.warn(ERRO_RESPOSTA_NAO_JSON),null;return res.json.android||(console.warn(ERRO_ANDROID_NAO_CONFIGURADO),null)}async function configureNativo(nativo,params){try{await nativo.configure({app_id:params.app_id,api_key:params.api_key,sender_id:params.sender_id,project_id:params.project_id??null})}catch(e){console.warn("[PushMesh] zero-config: configure nativo falhou — confira o painel (Configurações → FCM) ou passe getToken no init.",e)}}async function sincronizarToken(nativo,viaRevalidacao=false){let token=null;try{token=await nativo.getToken()}catch(e){console.warn("[PushMesh] zero-config: getToken nativo falhou — tentando token pendente",e)}if(token||(token=await nativo.getPendingToken().catch(()=>null)),await nativo.clearPendingToken().catch(()=>{}),token&&token!==state_1.state.token){if(viaRevalidacao){const{setToken:setToken}=await Promise.resolve().then(()=>__importStar(require("./players")));return void await setToken(token)}state_1.state.token=token,await(0,storage_1.setItem)(storage_1.KEYS.token,token)}}function revalidarParamsEmBackground(nativo,cached){(async()=>{const fresco=await buscarFirebaseParams();fresco&&JSON.stringify(fresco)!==JSON.stringify(cached)&&(await(0,storage_1.setItem)(storage_1.KEYS.firebaseParams,JSON.stringify(fresco)),await configureNativo(nativo,fresco),await sincronizarToken(nativo,true))})().catch(e=>console.warn("[PushMesh] revalidação de firebase_params falhou",e))}async function sincronizarReciboNativo(playerId){if("android"!==react_native_1.Platform.OS)return;const nativo=moduloNativo();nativo&&state_1.state.config&&await nativo.setReceiptConfig({base_url:(0,state_1.baseUrl)(),app_id:state_1.state.config.appId,player_id:playerId})}async function bootZeroConfigIos(){const nativo=moduloApns();if(nativo){conectarEventosApns(nativo),"apns"!==state_1.state.transporte&&(state_1.state.transporte="apns",await(0,storage_1.setItem)(storage_1.KEYS.transporte,"apns"));try{const token=await nativo.getToken();token&&token!==state_1.state.token&&(state_1.state.token=token,await(0,storage_1.setItem)(storage_1.KEYS.token,token))}catch(e){console.warn("[PushMesh] zero-config iOS: falha ao obter o token APNs. Como corrigir: capability Push Notifications no Xcode (device físico) ou getToken no init.",e)}}else console.warn(ERRO_MODULO_APNS_AUSENTE)}function conectarEventosApns(nativo){if(eventosApnsConectados)return;eventosApnsConectados=true;const emitter=new react_native_1.NativeEventEmitter(nativo);emitter.addListener("PushMeshApnsToken",token=>{"string"==typeof token&&token&&Promise.resolve().then(()=>__importStar(require("./players"))).then(m=>m.setToken(token)).catch(e=>console.warn("[PushMesh] falha no re-registro pós-token-apns",e))}),emitter.addListener("PushMeshApnsMessage",userInfo=>{(0,receipts_1.handlePushData)(extrairData(userInfo)).catch(e=>console.warn("[PushMesh] falha ao processar PushMeshApnsMessage",e))}),emitter.addListener("PushMeshApnsClick",userInfo=>{(0,receipts_1.handleClick)(extrairData(userInfo)).catch(e=>console.warn("[PushMesh] falha ao processar PushMeshApnsClick",e))})}async function drenarMensagensPendentes(){const nativo=moduloNativo();if(!nativo)return;const pendentes=await nativo.getPendingMessages();for(const data of pendentes)try{await processarMensagemNativa(data)}catch(e){console.warn("[PushMesh] item do buffer falhou — processando o resto",e)}}async function processarCliqueInicial(){const nativo=moduloNativo();if(!nativo)return;const data=await nativo.getInitialNotification();data&&await(0,receipts_1.handleClick)(data)}async function processarCliquePendenteIos(){const nativo=moduloApns();if(!nativo)return;const data=await nativo.getPendingClick();data&&await(0,receipts_1.handleClick)(data)}function conectarEventos(){eventosConectados||(eventosConectados=true,react_native_1.DeviceEventEmitter.addListener("PushMeshMessage",payload=>{processarMensagemNativa(extrairData(payload)).catch(e=>console.warn("[PushMesh] falha ao processar PushMeshMessage",e))}),react_native_1.DeviceEventEmitter.addListener("PushMeshTokenRefresh",token=>{"string"==typeof token&&token&&Promise.resolve().then(()=>__importStar(require("./players"))).then(m=>m.setToken(token)).catch(e=>console.warn("[PushMesh] falha no re-registro pós-token-refresh",e))}),react_native_1.DeviceEventEmitter.addListener("PushMeshNotificationClick",payload=>{(0,receipts_1.handleClick)(extrairData(payload)).catch(e=>console.warn("[PushMesh] falha ao processar PushMeshNotificationClick",e))}))}function extrairData(payload){if(!payload||"object"!=typeof payload)return{};const p=payload;return p.data&&"object"==typeof p.data?p.data:p}async function processarMensagemNativa(data){await(0,receipts_1.handlePushData)(data)}

package/ios/NotificationService/LEIA-ME.md

@@ -0,0 +1,105 @@
+# Imagem no push do iOS — Notification Service Extension
+
+**Tempo: ~5 minutos, uma vez por app.** Depois disso, toda mensagem com
+imagem passa a mostrar a imagem no iPhone, sem mexer em mais nada.
+
+## Por que existe um passo manual aqui
+
+O SDK é "só o App ID basta" — e continua sendo em tudo o mais. Este passo é o
+único que a **Apple impõe** e que nenhum SDK consegue eliminar:
+
+- o servidor já manda tudo (`mutable-content: 1` e a URL da imagem no
+  payload). Essa parte está pronta e não depende de você;
+- no iOS, quem **baixa** a imagem é um processo separado do app, chamado
+  *Notification Service Extension*. Esse processo **só existe se o projeto
+  tiver um alvo (target) desse tipo**;
+- sem esse alvo, o iPhone ignora o `mutable-content` **em silêncio**: a
+  notificação chega certinha, só que sem imagem. É exatamente o sintoma "no
+  Android a imagem aparece, no iOS não".
+
+Nenhum código dentro do app resolve: com o app em segundo plano ou fechado, o
+app nem roda quando o push chega. No Android nada disso é preciso — lá o
+próprio SDK baixa e exibe.
+
+## Passo a passo
+
+1. Abra o projeto no Xcode (`ios/SeuApp.xcworkspace`).
+2. **File → New → Target… → Notification Service Extension → Next**.
+3. **Product Name**: `PushMeshNotificationService` (o nome é livre).
+   Confira **Team** (o mesmo do app) e **Language: Swift** → **Finish**.
+4. O Xcode pergunta se quer ativar o novo *scheme*: pode clicar em **Cancel**
+   — assim o esquema do app continua selecionado para rodar.
+5. O Xcode criou uma pasta com um `NotificationService.swift` de exemplo.
+   Substitua o conteúdo dele pelo nosso, com **um comando** na raiz do app:
+
+   ```sh
+   cp node_modules/@pushmesh/sdk/ios/NotificationService/PushMeshNotificationService.swift \
+      ios/PushMeshNotificationService/NotificationService.swift
+   ```
+
+   (ajuste o caminho de destino se você deu outro nome ao alvo)
+6. Rode o app em **aparelho real**. Pronto.
+
+Não é preciso `pod install`, não é preciso mexer no Podfile e não é preciso
+tocar no `AppDelegate`: a extensão não usa nenhuma dependência — só
+`Foundation` e `UserNotifications`, que já vêm no sistema.
+
+## Detalhes que custam uma tarde se passarem batido
+
+| Ponto | O que fazer |
+|---|---|
+| **Minimum Deployments** | Ponha no alvo da extensão o **mesmo** valor do app (ex.: iOS 15.1). O Xcode costuma criar o alvo com o iOS mais recente — e aí, em todo aparelho com versão anterior, a extensão simplesmente **não roda** (sem erro, sem aviso: a imagem só não aparece). |
+| **Bundle Identifier** | Tem de começar com o do app: `com.suaempresa.app` → `com.suaempresa.app.PushMeshNotificationService`. O Xcode acerta sozinho ao criar; mas se você **renomear o bundle do app depois**, o da extensão **não** é renomeado junto e a build passa a falhar na assinatura. |
+| **Team / assinatura** | Mesmo Team do app. Com assinatura **automática**, o Xcode cria o perfil da extensão sozinho. Com assinatura **manual**, você precisa de um **segundo App ID + perfil de provisionamento** (o do bundle da extensão) no portal da Apple — é o esquecimento clássico de quem assina na mão. |
+| **NSExtensionPrincipalClass** | **Não mexa.** O Info.plist gerado aponta para `$(PRODUCT_MODULE_NAME).NotificationService`, e a classe do nosso arquivo se chama `NotificationService` justamente para casar. Renomear a classe sem renomear lá faz a extensão não rodar **em silêncio**. |
+| **Se preferir arrastar o arquivo** (em vez do `cp`) | Apague antes o `NotificationService.swift` gerado — duas classes com o mesmo nome não compilam. Ao arrastar, **desmarque "Copy items if needed"** e marque em *Target Membership* **só o alvo da extensão**, nunca o app. Vantagem: `npm update` atualiza o arquivo sozinho. Desvantagem: o build passa a depender do `node_modules`. |
+
+### O que **não** é necessário (não perca tempo)
+
+- **App Groups**: não. Só seriam precisos para a extensão trocar dados com o
+  app — ela não troca; baixa a imagem e entrega.
+- **Keychain Sharing**, **Background Modes** ou **Push Notifications** *no
+  alvo da extensão*: não. A capability **Push Notifications** fica no alvo do
+  **app**, como já estava.
+- **CocoaPods / Podfile**: não. A extensão não tem dependência nenhuma.
+- Mexer no painel: não. Basta preencher a imagem na mensagem — o servidor já
+  manda a flag que acorda a extensão quando há mídia.
+
+## Limites que são da Apple (e o que a extensão faz com eles)
+
+- **Formatos aceitos**: `jpg`, `png`, `gif`. `webp`, `heic` e `avif` são
+  recusados pelo iOS — use jpg/png/gif na CDN.
+- **Tamanho**: até 10 MB. Na prática, imagem de push boa é **abaixo de 1 MB**
+  (o aparelho baixa na hora de exibir, muitas vezes em rede ruim).
+- **HTTPS**: obrigatório. URL `http://` é bloqueada pelo App Transport
+  Security e o download nem sai.
+- **Prazo**: a Apple dá ~30s à extensão. A nossa usa 10s por tentativa e
+  20s no total; estourou, entrega a notificação **sem** a imagem.
+- **Como aparece**: miniatura à direita no banner; a imagem grande aparece
+  quando a notificação é **expandida** (puxar para baixo / manter pressionado).
+
+Em qualquer falha — 404, formato recusado, CDN fora do ar, prazo estourado —
+**a notificação chega inteira, só sem imagem**. Isso é lei do arquivo e está
+provado por teste executável na suíte do SDK (`__tests__/ios-nse.test.ts`).
+
+## Como saber se está funcionando
+
+Com o iPhone conectado ao Mac, abra o **Console.app**, selecione o aparelho e
+filtre por `[PushMesh NSE]`. Cada desistência é logada com a **causa** e o
+**como corrigir** (URL inválida, 404, formato não aceito, arquivo grande
+demais, prazo estourado).
+
+Se **nenhuma** linha `[PushMesh NSE]` aparece quando chega um push com
+imagem, a extensão não está rodando — reveja o *Minimum Deployments* e o
+*Bundle Identifier* da tabela acima.
+
+> Teste em **aparelho real**. No simulador o comportamento das extensões de
+> notificação varia conforme a versão do Xcode: um push sem imagem lá não
+> prova nada.
+
+## O que esta extensão ainda não faz
+
+**Recibo de entrega em segundo plano/app fechado.** Hoje o iOS só contabiliza
+o que o app vê (app aberto e toque na notificação); no Android o recibo já é
+real nos três estados. É a próxima frente desta mesma extensão — quando
+chegar, o passo de instalação continuará sendo este mesmo, sem retrabalho.