@akross/artemis-ads-sdk 3.7.5-beta.4 → 3.7.6

package/CHANGELOG.md

@@ -5,53 +5,40 @@ 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.5-beta.4] - 2026-02-07
+## [3.7.6] - 2026-03-03
 
-### Beta
+### Adicionado
 
-- Bump para nova beta de teste.
+- **API pública (Flutter)**: Novos métodos expostos no SDK e no `AdsManager` para o host/plugin Flutter: `sendMediaClickEvent(campaignId, trackingId, mediaId)` e `sendClickThroughEvent(campaignId, trackingId, mediaId)`.
 
----
+### Alterado
 
-## [3.7.5-beta.3] - 2026-02-07
+- **AAEventsCallbackHelper**: Parâmetro dos métodos de evento renomeado de `trackingId` para `requestId`, alinhando nomenclatura ao identificador real da requisição.
+- **AAEventsCallbackHelper**: Método `sendAdMediaClickEvent` renomeado para `sendMediaClickEvent`; uso atualizado em `ArtemisAdsBannerLoader` e `AAMedia`.
+- **AAEventsCallbackHelper**: `sendCampaignsImpressionEvent` simplificado — envia apenas impressão por campanha (removido o método `sendMultiCampaignSingleMediaImpressionEvent` e a lógica de mídia específica neste fluxo).
+- **Comentários da API**: Métodos `sendCampaignClickEvent` e `sendSuccessImpressionEvent` documentados como expostos para o host/plugin Flutter.
 
-### Adicionado (beta – teste com log)
+### Removido
 
-- **Classificação de falha de rede**: Teste de conectividade com `checkConnectivityWithTimeout(1s)` para classificar erro em `offline` / `timeout` / `unreachable` (sem usar navigator.onLine).
-- **requestCampaign**: Log de conectividade em falha de rede (`requestCampaign falhou | conectividade: <reason> | cause: ...`) e `campaignResult.networkErrorReason` para análise.
+- **AAEventsCallbackHelper**: Método `sendAdClickEvent` removido.
+- **AAEventsCallbackHelper**: Método `sendMultiCampaignSingleMediaImpressionEvent` removido (comportamento unificado em `sendCampaignsImpressionEvent`).
 
 ---
 
-## [3.7.5-beta.2] - 2026-02-07
+## [3.7.5] - 2026-02-19
 
 ### Adicionado
 
-- **ServicesAds.requestCampaign**: Em falha de rede (ex.: "Failed to fetch"), mensagem de erro detalhada com URL e sugestão (rede/CORS/servidor fora do ar).
-- **PreferencesUtil.getDebugMode()**: Em versões beta, retorna sempre `true` para habilitar todos os logs (debug, info, warn, error).
-
----
-
-## [3.7.5-beta.1] - 2026-02-07
+- **Eventos de callback expostos**: `success_impression` e `campaign-click` passam a ser emitidos e disponíveis para integração (em `AAEventsCallbackHelper`).
 
 ### Alterado
 
-- **Erros simplificados**: Mensagens de erro deixam de ser montadas manualmente; uso de `AAError(description, cause)` em `AdsManager.requestCampaign` e `AAManager.initialize`.
-- **AdsManager.requestCampaign**: Retornos antecipados (SDK não inicializado, userId vazio) passam a preencher `campaignResult.error` com `AAError` para o chamador obter a mensagem.
+- **Evento de clique na mídia**: O evento de clique deixou de usar o nome genérico `click` e passou a ser emitido como `media-click`, alinhado ao comportamento de outras mídias e evitando ambiguidade com `campaign-click`.
 
----
-
-## [3.7.5-beta.0] - 2026-02-07
-
-### Adicionado (beta – logs para troubleshooting)
-
-- **AdsManager.requestCampaign**: Erros do request de campanha passam a incluir detalhes (zoneId, size, userKeyType, userId, status HTTP, URL, responseBody, stack). Resultado expõe `errorDetails` no `AACampaignResult` e logs com mensagem única e objeto completo em debug.
-- **ServicesAds.requestCampaign**: Em respostas HTTP não-ok, o erro lançado inclui `status`, `statusText`, `responseBody` e `url` para facilitar diagnóstico.
-- **AAManager.initialize**: Erros de inicialização passam a incluir `errorDetails` (message, stack, configSummary, step) anexado ao Error rejeitado e logs detalhados; resumo da config (hasBaseUrl, proxyExternalScripts, hasLuminaToken, debugMode) sem dados sensíveis.
-- **AAManager.preloadScripts**: Try/catch separado por script (IMA, GPT, Lumina); logs identificam qual script falhou (warn + debug com message, stack, proxy).
-
-### Alterado
+### Corrigido
 
-- **AAError**: Campos `description` e `cause` passam a aceitar somente `string` (obrigatórios, default `''`).
+- **Eventos locais no clickthrough**: Ajuste do check `canSendLocalEvents` para permitir o envio de eventos locais (ex.: campaign-click) quando o usuário interage com o click-through ("Saiba mais") do anúncio.
+- **Resultado CANCELED no VAST**: Ao fechar o player VAST antes do fim do anúncio, o fluxo passa a retornar/emitir o resultado `AAMediaPlayResult.CANCELED`, permitindo tratar fechamento pelo usuário.
 
 ---
 

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

@@ -9,6 +9,10 @@ export declare class AdsManager {
     bannerClick(clickUrl: string, campaignId: string, requestId: string, mediaId: string): Promise<void>;
     sendEvent(event: string, campaignId: string, trackingId: string, mediaId?: string, source?: string): Promise<void>;
     sendCampaignsImpressionEvent(trackingId: string, campaigns: AACampaign[]): Promise<void>;
+    sendCampaignClickEvent(campaignId: string, trackingId: string): Promise<void>;
+    sendSuccessImpressionEvent(campaignId: string, trackingId: string, mediaId?: string): Promise<void>;
+    sendMediaClickEvent(campaignId: string, trackingId: string, mediaId: string): Promise<void>;
+    sendClickThroughEvent(campaignId: string, trackingId: string, mediaId: string): Promise<void>;
     static getSdkVersion(): string;
 }
 //# sourceMappingURL=AdsManager.d.ts.map

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,EAAU,MAAM,iBAAiB,CAAC;AAS1F,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;IAgGf,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;WAsCvF,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;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;IAmFf,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"}