@akross/artemis-ads-sdk 3.7.10 → 3.7.12

package/CHANGELOG.md

@@ -5,6 +5,31 @@ Todas as mudanças notáveis do projeto são documentadas neste arquivo.
 O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/),
 e este projeto adere ao [Versionamento Semântico](https://semver.org/lang/pt-BR/).
 
+## [3.7.12] - 2026-04-28
+
+### Adicionado
+
+- **Roteamento de `contextInfo` para Google Ad Manager (KVPs + PPS)**: `requestCampaign(zoneId, size, contextInfo)` agora propaga chaves prefixadas para o GAM, mantendo o contexto Artemis com a chave strip-ada:
+  - `kvp-gam-<k>=v` → custom targeting no slot GAM (`slot.setTargeting(<k>, v)`) + contexto Artemis como `<k>=v`
+  - `pps-gam-<k>=v` → Publisher Provided Signals via chaves IAB reservadas (`IAB_AUDIENCE_1_1`, `IAB_CONTENT_2_2`, etc.) + contexto Artemis como `<k>=v`
+  - chaves sem prefixo continuam indo apenas para o contexto Artemis
+- **`splitContext` / `GamTargeting`** (`src/utils/ContextSplitter.ts`): função pura que separa o `contextInfo` em `artemisContext` (strip-ado) e `gamTargeting`. Em colisão entre chave crua e prefixada, a crua vence no contexto Artemis (com warning); a prefixada sempre vai pro GAM. Exportadas via `src/utils/index.ts`.
+- **`AAMedia.gamTargeting`**: campo opcional injetado dinamicamente pelo `AdsManager` em cada mídia da resposta. Não serializado.
+- **`safeframe` em `VideoV2`** (`src/types/models/AAContent.ts`): novo campo `'ENABLED' | 'INSECURE'` que controla, por mídia, o `VpaidMode` do IMA SDK ao reproduzir criativos VPAID. Parse defensivo — qualquer valor diferente de `"INSECURE"` cai em `ENABLED` (default seguro), garantindo retrocompatibilidade com payloads antigos sem a chave.
+
+### Alterado
+
+- **`AdsManager.requestCampaign`**: chama o splitter antes de montar a request; envia somente o contexto strip-ado para o adserver Artemis.
+- **`GAMRewardedVideoWrapper`**: novo método interno `applyGamTargeting()` aplica KVPs e PPS no slot via `setTargeting`. `AARewardedVideo` repassa `media.gamTargeting` ao construir o wrapper.
+- **IMA SDK — `VpaidMode` agora decidido por mídia** (`src/modules/rv/vast/AAVastPlayer.ts`): em vez de fixo, o player escolhe `VpaidMode.INSECURE` quando `media.content.video.safeframe === 'INSECURE'` e `VpaidMode.ENABLED` caso contrário. O default permanece `ENABLED` (criativo VPAID isolado em iframe cross-domain tipo SafeFrame); o adserver pode optar por `INSECURE` por mídia quando o criativo precisa de acesso ao `window` da página host. O hook `imaConfig` em `AAVastPlayerConfig` continua disponível para sobrescrever a escolha por integração.
+- **`AARewardedVideo.loadVideoFallback`**: ao montar a mídia VAST in-house de fallback (quando a programática falha), seta `safeframe: 'ENABLED'` explicitamente no `content.video`. Como o fallback é gerado client-side sem JSON do adserver, queremos modo seguro por padrão.
+
+### Portabilidade
+
+- Porta da feature equivalente da SDK Android v3.7.11 (`AAContextSplitter.kt` + `AdManagerAdRequestExt.kt`). Veja `docs/feature-gam-context-routing.md`.
+
+---
+
 ## [3.7.10] - 2026-04-10
 
 ### Corrigido

package/dist/ads-core/AdsManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdsManager.d.ts","sourceRoot":"","sources":["../../src/ads-core/AdsManager.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,UAAU,EAAsB,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AASjF,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAyB;gBAEjC,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe;IAS1D,eAAe,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAU,EAChB,WAAW,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EACvC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC;IA2Ff,WAAW,CACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAiCH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsClH,4BAA4B,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCxF,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC7E,0BAA0B,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAkCH,mBAAmB,CAC9B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAkCH,qBAAqB,CAChC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;WAkCF,aAAa,IAAI,MAAM;CAItC"}
+{"version":3,"file":"AdsManager.d.ts","sourceRoot":"","sources":["../../src/ads-core/AdsManager.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,UAAU,EAAsB,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAUjF,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAyB;gBAEjC,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe;IAS1D,eAAe,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAU,EAChB,WAAW,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EACvC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC;IAmGf,WAAW,CACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAiCH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsClH,4BAA4B,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCxF,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC7E,0BAA0B,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAkCH,mBAAmB,CAC9B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAkCH,qBAAqB,CAChC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;WAkCF,aAAa,IAAI,MAAM;CAItC"}