npm - @akross/artemis-ads-sdk - Versions diffs - 3.4.0 - Mend

@akross/artemis-ads-sdk 3.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (116) hide show

package/README.md +662 -0
package/dist/ads-core/AdsManager.d.ts +14 -0
package/dist/ads-core/AdsManager.d.ts.map +1 -0
package/dist/ads-core/index.d.ts +5 -0
package/dist/ads-core/index.d.ts.map +1 -0
package/dist/ads-core/util/AADeviceContextHelper.d.ts +30 -0
package/dist/ads-core/util/AADeviceContextHelper.d.ts.map +1 -0
package/dist/ads-core/util/AAMediaTypeValidator.d.ts +27 -0
package/dist/ads-core/util/AAMediaTypeValidator.d.ts.map +1 -0
package/dist/ads-core/util/index.d.ts +3 -0
package/dist/ads-core/util/index.d.ts.map +1 -0
package/dist/akross-ads-sdk.esm.js +1 -0
package/dist/akross-ads-sdk.iife.js +1 -0
package/dist/akross-ads-sdk.min.js +1 -0
package/dist/akross-ads-sdk.umd.js +1 -0
package/dist/constants/ErrorMessages.d.ts +10 -0
package/dist/constants/ErrorMessages.d.ts.map +1 -0
package/dist/core/AAManager.d.ts +23 -0
package/dist/core/AAManager.d.ts.map +1 -0
package/dist/core/network/ApiFactory.d.ts +16 -0
package/dist/core/network/ApiFactory.d.ts.map +1 -0
package/dist/core/network/ServicesAds.d.ts +15 -0
package/dist/core/network/ServicesAds.d.ts.map +1 -0
package/dist/core/network/index.d.ts +5 -0
package/dist/core/network/index.d.ts.map +1 -0
package/dist/core/network/interceptor/RestInterceptor.d.ts +6 -0
package/dist/core/network/interceptor/RestInterceptor.d.ts.map +1 -0
package/dist/events/AAEventsCallbackHelper.d.ts +48 -0
package/dist/events/AAEventsCallbackHelper.d.ts.map +1 -0
package/dist/events/index.d.ts +2 -0
package/dist/events/index.d.ts.map +1 -0
package/dist/index.d.ts +43 -0
package/dist/index.d.ts.map +1 -0
package/dist/modules/image/ArtemisAdsBannerLoader.d.ts +31 -0
package/dist/modules/image/ArtemisAdsBannerLoader.d.ts.map +1 -0
package/dist/modules/image/index.d.ts +3 -0
package/dist/modules/image/index.d.ts.map +1 -0
package/dist/modules/index.d.ts +3 -0
package/dist/modules/index.d.ts.map +1 -0
package/dist/modules/rv/index.d.ts +3 -0
package/dist/modules/rv/index.d.ts.map +1 -0
package/dist/modules/rv/programmatic/AARewardedVideo.d.ts +24 -0
package/dist/modules/rv/programmatic/AARewardedVideo.d.ts.map +1 -0
package/dist/modules/rv/programmatic/GAMRewardedVideoWrapper.d.ts +32 -0
package/dist/modules/rv/programmatic/GAMRewardedVideoWrapper.d.ts.map +1 -0
package/dist/modules/rv/programmatic/index.d.ts +4 -0
package/dist/modules/rv/programmatic/index.d.ts.map +1 -0
package/dist/modules/rv/programmatic/utils/WaterfallResultHelper.d.ts +23 -0
package/dist/modules/rv/programmatic/utils/WaterfallResultHelper.d.ts.map +1 -0
package/dist/modules/rv/programmatic/utils/index.d.ts +2 -0
package/dist/modules/rv/programmatic/utils/index.d.ts.map +1 -0
package/dist/modules/rv/vast/AAVastPlayer.d.ts +52 -0
package/dist/modules/rv/vast/AAVastPlayer.d.ts.map +1 -0
package/dist/modules/rv/vast/AAVastPlayerUI.d.ts +19 -0
package/dist/modules/rv/vast/AAVastPlayerUI.d.ts.map +1 -0
package/dist/modules/rv/vast/index.d.ts +2 -0
package/dist/modules/rv/vast/index.d.ts.map +1 -0
package/dist/types/ArtemisSdkConfig.d.ts +19 -0
package/dist/types/ArtemisSdkConfig.d.ts.map +1 -0
package/dist/types/index.d.ts +3 -0
package/dist/types/index.d.ts.map +1 -0
package/dist/types/models/AAAdWatchResult.d.ts +14 -0
package/dist/types/models/AAAdWatchResult.d.ts.map +1 -0
package/dist/types/models/AABenefitOffer.d.ts +11 -0
package/dist/types/models/AABenefitOffer.d.ts.map +1 -0
package/dist/types/models/AACampaign.d.ts +16 -0
package/dist/types/models/AACampaign.d.ts.map +1 -0
package/dist/types/models/AACampaignConfig.d.ts +15 -0
package/dist/types/models/AACampaignConfig.d.ts.map +1 -0
package/dist/types/models/AACampaignRequest.d.ts +12 -0
package/dist/types/models/AACampaignRequest.d.ts.map +1 -0
package/dist/types/models/AACampaignResponse.d.ts +13 -0
package/dist/types/models/AACampaignResponse.d.ts.map +1 -0
package/dist/types/models/AACampaignResult.d.ts +15 -0
package/dist/types/models/AACampaignResult.d.ts.map +1 -0
package/dist/types/models/AACampaignStatus.d.ts +6 -0
package/dist/types/models/AACampaignStatus.d.ts.map +1 -0
package/dist/types/models/AAContent.d.ts +18 -0
package/dist/types/models/AAContent.d.ts.map +1 -0
package/dist/types/models/AAError.d.ts +6 -0
package/dist/types/models/AAError.d.ts.map +1 -0
package/dist/types/models/AAHeader.d.ts +9 -0
package/dist/types/models/AAHeader.d.ts.map +1 -0
package/dist/types/models/AALayout.d.ts +15 -0
package/dist/types/models/AALayout.d.ts.map +1 -0
package/dist/types/models/AAMainData.d.ts +13 -0
package/dist/types/models/AAMainData.d.ts.map +1 -0
package/dist/types/models/AAMedia.d.ts +21 -0
package/dist/types/models/AAMedia.d.ts.map +1 -0
package/dist/types/models/AAMediaResults.d.ts +12 -0
package/dist/types/models/AAMediaResults.d.ts.map +1 -0
package/dist/types/models/AAMediaTypes.d.ts +17 -0
package/dist/types/models/AAMediaTypes.d.ts.map +1 -0
package/dist/types/models/AASuccess.d.ts +14 -0
package/dist/types/models/AASuccess.d.ts.map +1 -0
package/dist/types/models/AAZone.d.ts +9 -0
package/dist/types/models/AAZone.d.ts.map +1 -0
package/dist/types/models/UserDataCache.d.ts +14 -0
package/dist/types/models/UserDataCache.d.ts.map +1 -0
package/dist/types/models/index.d.ts +20 -0
package/dist/types/models/index.d.ts.map +1 -0
package/dist/utils/AAMediaResultHelper.d.ts +52 -0
package/dist/utils/AAMediaResultHelper.d.ts.map +1 -0
package/dist/utils/ExternalJsLoader.d.ts +3 -0
package/dist/utils/ExternalJsLoader.d.ts.map +1 -0
package/dist/utils/GlobalLoadingOverlay.d.ts +9 -0
package/dist/utils/GlobalLoadingOverlay.d.ts.map +1 -0
package/dist/utils/PreferencesUtil.d.ts +18 -0
package/dist/utils/PreferencesUtil.d.ts.map +1 -0
package/dist/utils/index.d.ts +7 -0
package/dist/utils/index.d.ts.map +1 -0
package/dist/utils/logger.d.ts +9 -0
package/dist/utils/logger.d.ts.map +1 -0
package/dist/utils/version.d.ts +15 -0
package/dist/utils/version.d.ts.map +1 -0
package/package.json +84 -0

package/README.md ADDED Viewed

@@ -0,0 +1,662 @@
+# @akross/artemis-ads-sdk
+SDK JavaScript para o AdServer Akross Artemis - Carregamento de banners e mídias publicitárias.
+## 🚀 Características
+- **TypeScript Vanilla**: Sem dependências de frameworks
+- **Múltiplos Builds**: UMD (NPM), IIFE (CDN) e ESM (sites modernos)
+- **API Global**: `window.AkrossAds` para uso em Flutter Web/WebView
+- **WebView Bridge**: Comunicação automática via `window.Akross.postMessage`
+- **Banner Loader**: Carregamento otimizado de banners com fit inteligente
+- **Sample Interativa**: Interface web para testes locais
+## 📦 Instalação
+```bash
+npm install @akross/artemis-ads-sdk
+```
+## 🎯 Uso Básico
+### Inicialização do SDK
+```javascript
+import { init, ArtemisAdsBannerLoader } from '@akross/artemis-ads-sdk';
+// Configuração do SDK
+const sdkConfig = {
+  baseUrl: 'https://api.akross.com.br',
+  appId: 'seu-app-id',
+  appVersion: '1.0.0',
+  debug: true
+};
+// Inicializar SDK
+const sdk = await init(sdkConfig);
+```
+### Carregamento de Banner
+```javascript
+// Criar instância do banner loader
+const bannerLoader = new ArtemisAdsBannerLoader('#banner-container');
+// Configurar listeners
+bannerLoader.setSuccessListener({
+  onSuccess: (analyticsTag) => {
+    console.log('Banner carregado:', analyticsTag);
+  }
+});
+bannerLoader.setErrorListener({
+  onError: () => {
+    console.log('Erro ao carregar banner');
+  }
+});
+bannerLoader.setClickListener({
+  onClick: (analyticsTag) => {
+    console.log('Banner clicado:', analyticsTag);
+  }
+});
+// Carregar banner por Zone ID
+await bannerLoader.loadZone('sua-zone-id');
+// Ou carregar com dados de mídia específicos
+await bannerLoader.loadBanner(mediaData);
+```
+## 🎯 Exemplos
+### React/Next.js
+```tsx
+import { useEffect, useRef } from 'react';
+import { ArtemisAdsBannerLoader } from '@akross/artemis-ads-sdk';
+export default function BannerAd({ zoneId }) {
+  const bannerRef = useRef(null);
+  useEffect(() => {
+    if (bannerRef.current) {
+      const loader = new ArtemisAdsBannerLoader(bannerRef.current);
+      loader.loadZone(zoneId);
+    }
+  }, [zoneId]);
+  return <div ref={bannerRef} style={{ width: '300px', height: '250px' }} />;
+}
+```
+### Vanilla JavaScript
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <script src="https://unpkg.com/@akross/artemis-ads-sdk/dist/akross-ads-sdk.umd.js"></script>
+</head>
+<body>
+  <div id="banner-container" style="width: 300px; height: 250px;"></div>
+  <script>
+    const bannerLoader = new window.AkrossAds.ArtemisAdsBannerLoader('#banner-container');
+    bannerLoader.loadZone('sua-zone-id');
+  </script>
+</body>
+</html>
+```
+### Via Script Tag (IIFE)
+```html
+<script src="https://cdn.akross.com/sdk/akross-ads-sdk.iife.js"></script>
+<script>
+  // Inicializa o SDK
+  const sdk = window.AkrossAds.init({
+    baseUrl: 'https://api.akross.com/ads',
+    debug: true,
+    webViewBridge: {
+      enabled: true
+    }
+  });
+  // Carrega um anúncio
+  sdk.loadAd(document.getElementById('ad-container'), {
+    adId: 'my-ad',
+    slotId: 'banner-slot',
+    adServerUrl: 'https://api.akross.com/ads',
+    dimensions: { width: 300, height: 250 }
+  });
+</script>
+```
+### Via ES Modules
+```javascript
+import { init } from '@akross/artemis-ads-sdk';
+const sdk = init({
+  baseUrl: 'https://api.akross.com/ads',
+  debug: true
+});
+// Usar o SDK...
+```
+### Via CommonJS/UMD
+```javascript
+const { init } = require('@akross/artemis-ads-sdk');
+const sdk = init({
+  baseUrl: 'https://api.akross.com/ads'
+});
+```
+## 📚 API Reference
+### ArtemisAdsBannerLoader
+#### Métodos
+- `loadZone(zoneId: string, userKeyType?: string)`: Carrega banner por Zone ID
+- `loadBanner(media: any)`: Carrega banner com dados de mídia específicos
+- `setSuccessListener(listener)`: Define callback de sucesso
+- `setErrorListener(listener)`: Define callback de erro
+- `setClickListener(listener)`: Define callback de clique
+- `destroy()`: Destrói a instância e limpa recursos
+#### Listeners
+```typescript
+interface ArtemisAdsBannerLoaderSuccessListener {
+  onSuccess(analyticsTag?: string): void;
+}
+interface ArtemisAdsBannerLoaderErrorListener {
+  onError(): void;
+}
+interface ArtemisAdsBannerLoaderClickListener {
+  onClick(analyticsTag?: string): void;
+}
+```
+### API Principal
+#### Inicialização
+```javascript
+const sdk = window.AkrossAds.init({
+  baseUrl: 'https://api.akross.com/ads',    // URL base do servidor
+  timeout: 10000,                          // Timeout em ms
+  debug: false,                            // Modo debug
+  webViewBridge: {                         // Configurações do WebView
+    enabled: true,
+    targetOrigin: '*'                      // Origem permitida
+  }
+});
+```
+#### Carregar Anúncio
+```javascript
+const response = await sdk.loadAd(element, {
+  adId: 'unique-ad-id',
+  slotId: 'slot-identifier',
+  adServerUrl: 'https://api.akross.com/ads',
+  dimensions: { width: 300, height: 250 },
+  options: { /* parâmetros adicionais */ }
+});
+```
+#### Gerenciar Anúncios
+```javascript
+// Criar instância de anúncio
+const adInstance = sdk.createAd(config);
+// Carregar anúncio
+await adInstance.load();
+// Atualizar anúncio
+await adInstance.refresh();
+// Destruir anúncio
+adInstance.destroy();
+// Obter anúncios ativos
+const activeAds = sdk.getActiveAds();
+// Destruir todos os anúncios
+sdk.destroyAll();
+```
+## 🔧 Configuração
+### Configuração do SDK
+```typescript
+interface SDKConfig {
+  baseUrl: string;
+  appId: string;
+  appVersion: string;
+  debug?: boolean;
+  timeout?: number;
+  webViewBridge?: {
+    enabled: boolean;
+    targetOrigin?: string;
+  };
+}
+```
+### Configuração de Mídia
+```typescript
+interface MediaData {
+  uuid: string;
+  type: 'image';
+  title: string;
+  content: {
+    url: string;
+  };
+  externalUrl?: {
+    url: string;
+  };
+  analytics?: {
+    impression: string;
+    click: string;
+  };
+}
+```
+## 🌐 WebView Integration
+O SDK detecta automaticamente quando está rodando em um WebView e configura o bridge de comunicação:
+```javascript
+// Verifica se está em WebView
+if (sdk.isWebView()) {
+  console.log('Executando em WebView');
+}
+// Obtém informações do WebView
+const webViewInfo = sdk.getWebViewInfo();
+console.log(webViewInfo);
+// Envia mensagem para o WebView
+sdk.sendToWebView('ad_click', {
+  adId: 'my-ad',
+  timestamp: Date.now()
+});
+```
+## 🏗️ Builds Disponíveis
+### 📦 Formatos de Build
+Após executar `npm run build:release`, os seguintes arquivos serão gerados em `dist/`:
+#### 1. **UMD** (`akross-ads-sdk.umd.js`)
+- **Uso**: NPM, Node.js, bundlers
+- **Tamanho**: ~70KB (minificado)
+- **Sourcemap**: ❌ (release)
+#### 2. **IIFE** (`akross-ads-sdk.iife.js`)
+- **Uso**: CDN, HTML direto
+- **Tamanho**: ~69KB (minificado)
+- **Sourcemap**: ❌ (release)
+#### 3. **ESM** (`akross-ads-sdk.esm.js`)
+- **Uso**: Sites modernos, import/export
+- **Tamanho**: ~67KB (minificado)
+- **Sourcemap**: ❌ (release)
+#### 4. **Min** (`akross-ads-sdk.min.js`) - **RELEASE ONLY**
+- **Uso**: CDN público, máxima performance
+- **Tamanho**: ~69KB (ultra-minificado)
+- **Sourcemap**: ❌
+- **Otimizações**: Máxima compressão, sem console.log
+#### 5. **Types** (`index.d.ts`)
+- **Uso**: TypeScript definitions
+- **Tamanho**: ~1KB
+### 📊 Comparação de Tamanhos
+| Build | Tamanho | Sourcemap | Console | Uso |
+|-------|---------|-----------|---------|-----|
+| Dev | ~500KB | ✅ | ✅ | Desenvolvimento |
+| Prod | ~150KB | ❌ | ❌ | Teste |
+| Release | ~70KB | ❌ | ❌ | Produção |
+### ⚡ Otimizações de Release
+#### ✅ Otimizações Aplicadas
+- **Minificação**: Terser com 2-3 passadas
+- **Console**: Removido em produção (`drop_console: true`)
+- **Comentários**: Removidos (`removeComments: true`)
+- **Sourcemaps**: Desabilitados para release
+- **Mangle**: Variáveis e propriedades privadas
+- **Dead Code**: Eliminação de código não utilizado
+- **Tree Shaking**: Automático via Rollup
+#### 🎯 Performance
+- **Tamanho**: ~70KB gzipped
+- **Load time**: <100ms
+- **Memory**: <2MB
+- **Compatibility**: IE11+
+## 🧪 Sample
+### 🚀 Como executar o Sample
+#### 1. **Desenvolvimento com Live Reload**
+```bash
+# Executa build em watch mode + live-server
+npm run dev
+# Acesse: http://localhost:3000
+```
+#### 2. **Build Automático do Sample**
+```bash
+# Build automático (recomendado)
+npm run build:sample
+# Servir sample localmente
+cd sample
+python -m http.server 8000
+# ou
+npx serve sample
+# Acesse: http://localhost:8000
+```
+#### 3. **Build Manual do Sample**
+```bash
+# 1. Gerar build do SDK
+npm run build:release
+# 2. Copiar build para sample
+cp dist/akross-ads-sdk.iife.js sample/
+# 3. Servir sample localmente
+cd sample
+python -m http.server 8000
+# ou
+npx serve sample
+# Acesse: http://localhost:8000
+```
+#### 4. **Sample com Build de Desenvolvimento**
+```bash
+# Build com sourcemaps (para debug)
+npm run build:dev
+# Copiar para sample
+cp dist/akross-ads-sdk.iife.js sample/
+# Servir sample
+npx serve sample
+```
+### 🎯 Funcionalidades do Sample
+A sample inclui:
+- **Gerenciamento de Usuário**: Definir userId, headers customizados
+- **Gerenciamento de Anúncios**: Solicitar campanhas, testar mídias
+- **Testes de Mídias**: VAST, VPAID, Programático, Banner
+- **Banner Loader**: Teste de diferentes tamanhos de banner
+- **Interface Interativa**: Botões para testar todas as funcionalidades
+- **Logs em Tempo Real**: Console com logs detalhados
+- **Configurações Dinâmicas**: Alterar parâmetros em tempo real
+### 📁 Estrutura do Sample
+```
+sample/
+├── index.html              # Interface principal
+├── demo.js                 # Lógica da sample
+├── akross-ads-sdk.iife.js  # SDK build (copiado do dist/)
+└── styles/                 # CSS (se houver)
+```
+### 🔧 Configuração do Sample
+O sample usa configurações padrão que podem ser alteradas em `demo.js`:
+```javascript
+const sdkConfig = {
+    baseUrl: 'https://ads.timfun.com.br/adserver/',
+    debug: true,
+    timeout: 10000,
+    appId: 'com.example.myapp',
+    appVersion: '1.0.0',
+    artemisAdsAppId: 'akross-app-123',
+    primaryColor: '#ff0000'
+};
+```
+## 🛠️ Desenvolvimento
+### 📋 Scripts Disponíveis
+#### 🔧 Desenvolvimento
+```bash
+# Instalar dependências
+npm install
+# Build de desenvolvimento (com sourcemaps e logs)
+npm run build:dev
+# Build em modo watch
+npm run build:watch
+# Desenvolvimento com live-server
+npm run dev
+# Limpar build
+npm run clean
+# Verificar tipos
+npm run type-check
+# Linting
+npm run lint
+npm run lint:fix
+```
+#### 🏭 Produção
+```bash
+# Build de produção (minificado, sem sourcemaps)
+npm run build:prod
+# Build de release (ultra-otimizado)
+npm run build:release
+# Testar build
+npm run test:build
+# Build completo (limpeza + build + verificação)
+npm run prepublishOnly
+```
+#### 📦 Publicação NPM
+```bash
+# Publicar patch (3.4.0.1 -> 3.4.0.2)
+npm run publish:patch
+# Publicar minor (3.4.0.1 -> 3.4.1.0)
+npm run publish:minor
+# Publicar major (3.4.0.1 -> 4.0.0.0)
+npm run publish:major
+# Testar pacote localmente
+npm pack
+```
+## 🔄 WebView Bridge
+O SDK implementa comunicação bidirecional com WebView:
+### Mensagens Enviadas para WebView:
+- `ad_request` - Requisição de anúncio
+- `ad_response` - Resposta do anúncio
+- `ad_error` - Erro no carregamento
+- `ad_click` - Clique no anúncio
+- `ad_impression` - Impressão do anúncio
+### Mensagens Recebidas do WebView:
+- `ad_request` - Solicitação de anúncio
+- `ad_error` - Erro reportado
+- `ad_click` - Clique reportado
+## 🛠️ Estrutura do Projeto
+### 📁 Estrutura Principal
+```
+src/
+├── ads-core/                    # Core do sistema de anúncios
+│   ├── AdsManager.ts           # Gerenciador principal de anúncios
+│   ├── network/                # Camada de rede
+│   │   ├── ApiFactory.ts       # Factory para APIs
+│   │   ├── ServicesAds.ts      # Serviços de anúncios
+│   │   └── interceptor/         # Interceptadores HTTP
+│   └── util/                   # Utilitários do core
+│       └── AAMediaTypeValidator.ts
+├── core/
+│   └── AAManager.ts            # Gerenciador principal do SDK
+├── events/
+│   └── AAEventsCallbackHelper.ts # Helper para eventos
+├── modules/                    # Módulos específicos
+│   ├── image/                  # Banner Loader
+│   │   └── ArtemisAdsBannerLoader.ts
+│   ├── programmatic/           # Anúncios programáticos
+│   │   ├── AARewardedVideoHandler.ts
+│   │   └── GAMRewardedVideoWrapper.ts
+│   └── vast/                   # Player VAST
+│       ├── AAVastPlayer.ts
+│       └── AAVastPlayerUI.ts
+├── types/                      # Definições TypeScript
+│   ├── ArtemisSdkConfig.ts     # Configurações do SDK
+│   └── models/                 # Modelos de dados
+│       ├── AAMedia.ts
+│       ├── AACampaign.ts
+│       └── ... (outros modelos)
+├── utils/                      # Utilitários gerais
+│   ├── AAMediaResultHelper.ts  # Helper para resultados
+│   ├── AAReportHelper.ts       # Helper para relatórios
+│   ├── logger.ts               # Sistema de logging
+│   └── ... (outros utils)
+└── index.ts                    # Ponto de entrada principal
+```
+### 📁 Build Output
+```
+dist/
+├── akross-ads-sdk.umd.js       # UMD (NPM)
+├── akross-ads-sdk.iife.js      # IIFE (CDN)
+├── akross-ads-sdk.esm.js       # ESM (moderno)
+├── akross-ads-sdk.min.js       # Ultra-min (release)
+├── index.d.ts                  # TypeScript definitions
+├── ads-core/                   # Definições do core
+├── core/                       # Definições do core
+├── events/                     # Definições de eventos
+├── modules/                    # Definições dos módulos
+├── types/                      # Definições de tipos
+└── utils/                      # Definições de utilitários
+```
+### 📁 Sample
+```
+sample/
+├── index.html                  # Interface da sample
+├── demo.js                     # Lógica da sample
+├── akross-ads-sdk.iife.js      # SDK build (copiado)
+└── styles/                     # CSS (se houver)
+```
+### 🔧 Configurações de Build
+```
+rollup.config.js                # Configuração principal
+rollup.simple.release.config.js  # Configuração de release
+tsconfig.json                   # Configuração TypeScript
+package.json                    # Dependências e scripts
+.npmignore                      # Arquivos ignorados no NPM
+setup-npm.js                    # Script de configuração NPM
+```
+## 📋 Tipos TypeScript
+```typescript
+interface AdConfig {
+  adId: string;
+  slotId: string;
+  adServerUrl: string;
+  dimensions?: { width: number; height: number };
+  options?: Record<string, any>;
+}
+interface AdResponse {
+  success: boolean;
+  html?: string;
+  imageUrl?: string;
+  clickUrl?: string;
+  dimensions?: { width: number; height: number };
+  error?: string;
+}
+interface SDKConfig {
+  baseUrl: string;
+  timeout?: number;
+  debug?: boolean;
+  webViewBridge?: {
+    enabled: boolean;
+    targetOrigin?: string;
+  };
+}
+```
+## 🚀 Deploy
+**NPM**
+```bash
+npm run build:release
+npm publish
+```
+**CDN**
+```bash
+npm run build:release
+# Usar: dist/akross-ads-sdk.min.js
+```
+**Sites**
+```bash
+npm run build:prod
+# Usar: dist/akross-ads-sdk.iife.js
+```
+## 📄 Licença
+MIT License - veja o arquivo LICENSE para detalhes.
+## 🤝 Contribuição
+1. Fork o projeto
+2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)
+3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)
+4. Push para a branch (`git push origin feature/AmazingFeature`)
+5. Abra um Pull Request
+## 📞 Suporte
+- GitHub: [https://github.com/akross/artemis-ads-sdk-js](https://github.com/akross/artemis-ads-sdk-js)
+- Issues: [https://github.com/akross/artemis-ads-sdk-js/issues](https://github.com/akross/artemis-ads-sdk-js/issues)

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

@@ -0,0 +1,14 @@
+import { AACampaign, AACampaignResult } from '../types/models';
+export declare class AdsManager {
+    private logger;
+    private eventsHelper;
+    constructor(appId?: string, appVersion?: string, debug?: boolean);
+    requestCampaign(zoneId: string, size?: number, contextInfo?: {
+        [key: string]: string;
+    }, userKeyType?: string): Promise<AACampaignResult>;
+    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>;
+    static getSdkVersion(): string;
+}
+//# sourceMappingURL=AdsManager.d.ts.map

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

@@ -0,0 +1 @@

+ {"version":3,"file":"AdsManager.d.ts","sourceRoot":"","sources":["../../src/ads-core/AdsManager.ts"],"names":[],"mappings":"AAMA,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;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"}

package/dist/ads-core/index.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+export { AdsManager } from './AdsManager';
+export * from '../core/network';
+export * from './util';
+export * from '../types/models';
+//# sourceMappingURL=index.d.ts.map

package/dist/ads-core/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ads-core/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC"}

package/dist/ads-core/util/AADeviceContextHelper.d.ts ADDED Viewed

@@ -0,0 +1,30 @@
+export declare class AADeviceContextHelper {
+    private logger;
+    private cachedDeviceInfo;
+    constructor();
+    getDeviceContext(): Promise<{
+        [key: string]: string;
+    }>;
+    getSdkVersion(): string;
+    clearCache(): void;
+    getBrowserInfo(): {
+        [key: string]: string;
+    };
+    getScreenInfo(): {
+        [key: string]: string;
+    };
+    private getFallbackContext;
+    private getDeviceId;
+    private generateDeviceFingerprint;
+    private getBrowserBrand;
+    private getHardwareInfo;
+    private getManufacturer;
+    private getModel;
+    private getProduct;
+    private getOSVersion;
+    private getLocation;
+    private getAdId;
+}
+export declare function getAADeviceContextHelper(): AADeviceContextHelper;
+export declare function createAADeviceContextHelper(): AADeviceContextHelper;
+//# sourceMappingURL=AADeviceContextHelper.d.ts.map