@gabagool-sdk/react-native 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+## 0.3.0
+
+* **Funciona sem polyfill de crypto**: o core não exige mais `crypto.getRandomValues` (ver `@gabagool-sdk/core` 0.3.0); `react-native-get-random-values` passa de obrigatório (0.2.x) a recomendado: se o app tiver, é usado e os ids ganham aleatoriedade criptográfica; sem ele os ids saem de `Math.random`. Requer `@gabagool-sdk/core` ^0.3.0.
+* **Fix do Metro**: o campo `"react-native"` do `package.json` apontava para `src/index.ts`, e o Metro resolvia o fonte TS com imports `./x.js` e quebrava. Agora aponta para o JS compilado (`dist/index.js`, o mesmo do `main`), que já vai no pacote (`files`).
+
+## 0.2.1
+
+* `GabagoolAds.setRewardedSsv({ userId?, customData? })`: SSV do rewarded, mesma semântica do Dart e do core (antes ou depois do `init`; `userId` > `identify`; `customData` ≤ 1024). O adapter aplica `serverSideVerificationOptions` (`react-native-google-mobile-ads` 17.x) no `RewardedAd.createForAdRequest`. Não testado em aparelho. Requer `@gabagool-sdk/core` ^0.2.1.
+
 ## 0.2.0
 
 * `GabagoolAds.onPaidEvent` (e opção `onPaidEvent` no `init`): receita de toda impressão, repassada do core. O lado nativo do RN continua parcial (API presente; emissão coberta pelos testes do core). Requer `@gabagool-sdk/core` ^0.2.0.

package/README.md

@@ -5,7 +5,7 @@ O servidor Gabagool decide segmento, ad units e pisos a cada `init`; o piso vai
 **key-value de targeting** (a key de piso é configurada no painel Gabagool, com a grafia exata do
 valor do piso). Sem configuração do servidor, o SDK não exibe anúncios.
 
-**Limitação da versão 0.2.0:** o formato **native** ainda não é suportado neste pacote
+**Limitação da versão 0.2.x:** o formato **native** ainda não é suportado neste pacote
 (interstitial, rewarded, banner e app open já funcionam). Android é o alvo testado;
 no iOS, passe `installInfoProvider` no `init` (o plugin de Play Install Referrer é Android-only).
 
@@ -15,6 +15,27 @@ Mais detalhes: https://gabagool.com.br
 
 ```bash
 npm install @gabagool-sdk/react-native react-native-google-mobile-ads @react-native-async-storage/async-storage react-native-play-install-referrer
+# recomendado (opcional a partir da 0.3.0):
+npm install react-native-get-random-values
+```
+
+**Polyfill de `crypto.getRandomValues`: recomendado a partir da 0.3.0, obrigatório na 0.2.x.**
+- **0.3.0 ou mais nova**: o SDK funciona sem o polyfill. Se faltar `crypto.getRandomValues`, os ids de evento e de
+  instalação saem de `Math.random` (servem como id, não como segredo). Com o polyfill instalado, ele é usado sozinho e
+  os ids ganham aleatoriedade criptográfica, por isso é o recomendado.
+- **0.2.x**: sem o polyfill o `init` falha com `crypto.getRandomValues() not supported` e nenhum anúncio aparece
+  (confirmado em aparelho em 14/11/2026). Atualize para a 0.3.0 ou instale o polyfill.
+
+Se instalar, importe na **primeira linha do arquivo de entrada** do app, antes de qualquer import do SDK:
+
+```js
+// index.js — primeira linha, antes de qualquer import do @gabagool-sdk
+import 'react-native-get-random-values';
+import { AppRegistry } from 'react-native';
+import App from './App';
+import { name as appName } from './app.json';
+
+AppRegistry.registerComponent(appName, () => App);
 ```
 
 Você precisa de uma **chave de API** (`x-api-key`) do seu app, gerada no painel Gabagool.
@@ -36,6 +57,7 @@ no `Info.plist` conforme a documentação do `react-native-google-mobile-ads`.
 ## 3. Init
 
 ```tsx
+// se instalou o polyfill recomendado, ele já foi importado na 1ª linha do index.js (seção 1)
 import { GabagoolAds } from '@gabagool-sdk/react-native';
 
 await GabagoolAds.init('SUA_API_KEY', 'https://apps.gabagool.com.br', 'com.seu.app', {
@@ -62,6 +84,14 @@ const result = await GabagoolAds.showInterstitial('home');
 const reward = await GabagoolAds.showRewarded('bonus');
 ```
 
+**SSV (Server-Side Verification)**: para validar a recompensa no seu backend, defina `userId`/`customData` (antes ou depois do `init`; sem `userId`, vale o do `identify`):
+
+```tsx
+GabagoolAds.setRewardedSsv({ userId: 'user-123', customData: '{"pack":"coins_50"}' });
+```
+
+Vira `serverSideVerificationOptions` do `react-native-google-mobile-ads` no load do rewarded (`customData` até 1024 chars). Callback, assinatura e limites: `docs/SSV-REWARDED.md`. Não testado em aparelho nem contra o callback real do Google.
+
 ### Banner
 
 ```tsx

package/dist/adapter.d.ts

@@ -1,4 +1,4 @@
-import { type AdHandle, type AdNetworkAdapter, type FloorKV, type LoadResult, type ShowResult } from '@gabagool-sdk/core';
+import { type AdHandle, type AdNetworkAdapter, type FloorKV, type LoadResult, type RewardedLoadOptions, type ShowResult } from '@gabagool-sdk/core';
 /** Adapter do core para a API estável do Invertase 17.x. */
 export declare class ReactNativeGmaAdapter implements AdNetworkAdapter {
     private sequence;
@@ -9,7 +9,7 @@ export declare class ReactNativeGmaAdapter implements AdNetworkAdapter {
     /** Falha do initialize() não trava o app (como a Dart): segue e os loads reportam seus próprios erros. */
     initialize(): Promise<void>;
     loadInterstitial(adUnit: string, floorKV?: FloorKV): Promise<LoadResult>;
-    loadRewarded(adUnit: string, floorKV?: FloorKV): Promise<LoadResult>;
+    loadRewarded(adUnit: string, floorKV?: FloorKV, opts?: RewardedLoadOptions): Promise<LoadResult>;
     loadAppOpen(adUnit: string, floorKV?: FloorKV): Promise<LoadResult>;
     loadBanner(adUnit: string, _floorKV?: FloorKV): Promise<LoadResult>;
     /** Native ainda não portado para RN (Invertase NativeAd): reporta erro explícito, nunca fill falso. */

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAC;AA4B5B,4DAA4D;AAC5D,qBAAa,qBAAsB,YAAW,gBAAgB;IAC5D,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IACjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAE5D,0GAA0G;IAC1G,QAAQ,CAAC,6BAA6B,QAAQ;IAE9C,0GAA0G;IACpG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAGxE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAGpE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAI7D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAWzE,uGAAuG;IACjG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1E,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;IAI9B,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,OAAO,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;IAM3B,IAAI,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAuCvC,OAAO,CAAC,cAAc;IAyCtB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,MAAM;CAGf"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,mBAAmB,EAExB,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAC;AA+B5B,4DAA4D;AAC5D,qBAAa,qBAAsB,YAAW,gBAAgB;IAC5D,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IACjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAE5D,0GAA0G;IAC1G,QAAQ,CAAC,6BAA6B,QAAQ;IAE9C,0GAA0G;IACpG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAGxE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAGhG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAI7D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAWzE,uGAAuG;IACjG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1E,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;IAI9B,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,OAAO,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;IAM3B,IAAI,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAuCvC,OAAO,CAAC,cAAc;IAyCtB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,MAAM;CAGf"}

package/dist/adapter.js

@@ -24,8 +24,8 @@ export class ReactNativeGmaAdapter {
     loadInterstitial(adUnit, floorKV) {
         return this.loadFullscreen('interstitial', adUnit, floorKV);
     }
-    loadRewarded(adUnit, floorKV) {
-        return this.loadFullscreen('rewarded', adUnit, floorKV);
+    loadRewarded(adUnit, floorKV, opts) {
+        return this.loadFullscreen('rewarded', adUnit, floorKV, opts?.ssv);
     }
     loadAppOpen(adUnit, floorKV) {
         return this.loadFullscreen('app_open', adUnit, floorKV);
@@ -99,11 +99,11 @@ export class ReactNativeGmaAdapter {
             }
         });
     }
-    loadFullscreen(format, adUnit, floorKV) {
+    loadFullscreen(format, adUnit, floorKV, ssv) {
         return new Promise((resolve) => {
             let native;
             try {
-                const request = this.requestOptions(adUnit, floorKV);
+                const request = this.requestOptions(adUnit, floorKV, format === 'rewarded' ? ssv : undefined);
                 const created = format === 'app_open'
                     ? AppOpenAd.createForAdRequest(adUnit, request)
                     : format === 'rewarded'
@@ -149,9 +149,13 @@ export class ReactNativeGmaAdapter {
             }
         });
     }
-    requestOptions(adUnit, floorKV) {
+    requestOptions(adUnit, floorKV, ssv) {
         const kv = this.requestFloor(adUnit, floorKV);
-        return kv ? { customTargeting: kv } : undefined;
+        // Invertase: RequestOptions.serverSideVerificationOptions { userId, customData } (só no RewardedAd; vazio => omitido)
+        const ssvOptions = ssv && (ssv.userId !== undefined || ssv.customData !== undefined)
+            ? { serverSideVerificationOptions: { ...(ssv.userId !== undefined ? { userId: ssv.userId } : {}), ...(ssv.customData !== undefined ? { customData: ssv.customData } : {}) } }
+            : {};
+        return kv || ssvOptions.serverSideVerificationOptions ? { ...(kv ? { customTargeting: kv } : {}), ...ssvOptions } : undefined;
     }
     requestFloor(adUnit, floorKV) {
         return networkOf(adUnit) === 'gam' && floorKV && Object.keys(floorKV).length > 0 ? { ...floorKV } : undefined;

package/dist/facade.d.ts

@@ -1,4 +1,4 @@
-import { type AdHandle, type AdNetworkAdapter, type BootAdResult, type FetchLike, type Gabagool, type GateResult, type InterstitialShowResult, type KVStorage, type OnPaidEvent, type RewardedResult, type TelemetryTransport, type WrapperConfig } from '@gabagool-sdk/core';
+import { type AdHandle, type AdNetworkAdapter, type BootAdResult, type FetchLike, type Gabagool, type GateResult, type InterstitialShowResult, type KVStorage, type OnPaidEvent, type RewardedResult, type RewardedSsv, type TelemetryTransport, type WrapperConfig } from '@gabagool-sdk/core';
 import { ReactNativeGmaAdapter } from './adapter.js';
 import { type InstallInfoProvider } from './installInfo.js';
 export interface GabagoolInitOptions {
@@ -38,6 +38,14 @@ export declare class GabagoolAds {
      * telemetria; exceção do callback é engolida. Pode ser atribuído antes ou depois do `init`.
      */
     static onPaidEvent: OnPaidEvent | null;
+    /** SSV guardado aqui: setRewardedSsv antes do init sobrevive à recriação do core. */
+    private static ssv;
+    /**
+     * SSV do rewarded (Server-Side Verification): `userId`/`customData` chegam no callback do Google ao seu backend.
+     * Vale antes ou depois do `init` (próximos loads; um rewarded já carregado mantém o que tinha). Sem `userId`, usa o do
+     * `identify`. Sem argumentos limpa. `customData` acima de 1024 chars é cortado (com aviso). Ver docs/SSV-REWARDED.md.
+     */
+    static setRewardedSsv(ssv?: RewardedSsv): void;
     static get core(): Gabagool;
     static init(apiKey: string, baseUrl: string, appId: string, options?: GabagoolInitOptions): Promise<void>;
     static showInterstitial(screen?: string): Promise<InterstitialShowResult>;

package/dist/facade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"facade.d.ts","sourceRoot":"","sources":["../src/facade.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"facade.d.ts","sourceRoot":"","sources":["../src/facade.ts"],"names":[],"mappings":"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"}

package/dist/facade.js

@@ -28,6 +28,17 @@ export class GabagoolAds {
      * telemetria; exceção do callback é engolida. Pode ser atribuído antes ou depois do `init`.
      */
     static onPaidEvent = null;
+    /** SSV guardado aqui: setRewardedSsv antes do init sobrevive à recriação do core. */
+    static ssv;
+    /**
+     * SSV do rewarded (Server-Side Verification): `userId`/`customData` chegam no callback do Google ao seu backend.
+     * Vale antes ou depois do `init` (próximos loads; um rewarded já carregado mantém o que tinha). Sem `userId`, usa o do
+     * `identify`. Sem argumentos limpa. `customData` acima de 1024 chars é cortado (com aviso). Ver docs/SSV-REWARDED.md.
+     */
+    static setRewardedSsv(ssv) {
+        this.ssv = ssv;
+        this.instance.setRewardedSsv(ssv);
+    }
     static get core() { return this.instance; }
     static async init(apiKey, baseUrl, appId, options = {}) {
         if (options.onPaidEvent)
@@ -36,6 +47,7 @@ export class GabagoolAds {
         this.instance.dispose();
         this.resetReady();
         this.instance = createGabagool();
+        this.instance.setRewardedSsv(this.ssv);
         const adapter = options.adapter ?? new ReactNativeGmaAdapter();
         this.gmaAdapter = adapter instanceof ReactNativeGmaAdapter ? adapter : null;
         if (this.gmaAdapter)

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@gabagool-sdk/react-native",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "React Native SDK for Gabagool Apps monetization: interstitial, rewarded and banner ads with server-side config, price floors and gating, on top of Google Mobile Ads (Ad Manager / AdMob).",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "react-native": "src/index.ts",
+  "react-native": "dist/index.js",
   "files": [
     "dist",
     "src",
@@ -23,7 +23,7 @@
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@gabagool-sdk/core": "^0.2.0"
+    "@gabagool-sdk/core": "^0.3.0"
   },
   "peerDependencies": {
     "@react-native-async-storage/async-storage": "^3.1.1",

package/src/adapter.ts

@@ -15,9 +15,14 @@ import {
   type AdNetworkAdapter,
   type FloorKV,
   type LoadResult,
+  type RewardedLoadOptions,
+  type RewardedSsv,
   type ShowResult,
 } from '@gabagool-sdk/core';
-type RequestOptions = { customTargeting?: Record<string, string | number | (string | number)[]> };
+type RequestOptions = {
+  customTargeting?: Record<string, string | number | (string | number)[]>;
+  serverSideVerificationOptions?: { userId?: string; customData?: string };
+};
 
 type Remove = () => void;
 type EventPayload = Error & { code?: string; reason?: string; phase?: 'load' | 'show' };
@@ -61,8 +66,8 @@ export class ReactNativeGmaAdapter implements AdNetworkAdapter {
   loadInterstitial(adUnit: string, floorKV?: FloorKV): Promise<LoadResult> {
     return this.loadFullscreen('interstitial', adUnit, floorKV);
   }
-  loadRewarded(adUnit: string, floorKV?: FloorKV): Promise<LoadResult> {
-    return this.loadFullscreen('rewarded', adUnit, floorKV);
+  loadRewarded(adUnit: string, floorKV?: FloorKV, opts?: RewardedLoadOptions): Promise<LoadResult> {
+    return this.loadFullscreen('rewarded', adUnit, floorKV, opts?.ssv);
   }
   loadAppOpen(adUnit: string, floorKV?: FloorKV): Promise<LoadResult> {
     return this.loadFullscreen('app_open', adUnit, floorKV);
@@ -137,11 +142,11 @@ export class ReactNativeGmaAdapter implements AdNetworkAdapter {
     });
   }
 
-  private loadFullscreen(format: Exclude<AdFormat, 'banner'>, adUnit: string, floorKV?: FloorKV): Promise<LoadResult> {
+  private loadFullscreen(format: Exclude<AdFormat, 'banner'>, adUnit: string, floorKV?: FloorKV, ssv?: RewardedSsv): Promise<LoadResult> {
     return new Promise((resolve) => {
       let native: NativeFullscreen;
       try {
-        const request = this.requestOptions(adUnit, floorKV);
+        const request = this.requestOptions(adUnit, floorKV, format === 'rewarded' ? ssv : undefined);
         const created = format === 'app_open'
           ? AppOpenAd.createForAdRequest(adUnit, request)
           : format === 'rewarded'
@@ -178,9 +183,13 @@ export class ReactNativeGmaAdapter implements AdNetworkAdapter {
     });
   }
 
-  private requestOptions(adUnit: string, floorKV?: FloorKV): RequestOptions | undefined {
+  private requestOptions(adUnit: string, floorKV?: FloorKV, ssv?: RewardedSsv): RequestOptions | undefined {
     const kv = this.requestFloor(adUnit, floorKV);
-    return kv ? { customTargeting: kv } : undefined;
+    // Invertase: RequestOptions.serverSideVerificationOptions { userId, customData } (só no RewardedAd; vazio => omitido)
+    const ssvOptions = ssv && (ssv.userId !== undefined || ssv.customData !== undefined)
+      ? { serverSideVerificationOptions: { ...(ssv.userId !== undefined ? { userId: ssv.userId } : {}), ...(ssv.customData !== undefined ? { customData: ssv.customData } : {}) } }
+      : {};
+    return kv || ssvOptions.serverSideVerificationOptions ? { ...(kv ? { customTargeting: kv } : {}), ...ssvOptions } : undefined;
   }
 
   private requestFloor(adUnit: string, floorKV?: FloorKV): FloorKV | undefined {

package/src/facade.ts

@@ -13,6 +13,7 @@ import {
   type KVStorage,
   type OnPaidEvent,
   type RewardedResult,
+  type RewardedSsv,
   type TelemetryTransport,
   type WrapperConfig,
 } from '@gabagool-sdk/core';
@@ -71,6 +72,19 @@ export class GabagoolAds {
    */
   static onPaidEvent: OnPaidEvent | null = null;
 
+  /** SSV guardado aqui: setRewardedSsv antes do init sobrevive à recriação do core. */
+  private static ssv: RewardedSsv | undefined;
+
+  /**
+   * SSV do rewarded (Server-Side Verification): `userId`/`customData` chegam no callback do Google ao seu backend.
+   * Vale antes ou depois do `init` (próximos loads; um rewarded já carregado mantém o que tinha). Sem `userId`, usa o do
+   * `identify`. Sem argumentos limpa. `customData` acima de 1024 chars é cortado (com aviso). Ver docs/SSV-REWARDED.md.
+   */
+  static setRewardedSsv(ssv?: RewardedSsv): void {
+    this.ssv = ssv;
+    this.instance.setRewardedSsv(ssv);
+  }
+
   static get core(): Gabagool { return this.instance; }
 
   static async init(apiKey: string, baseUrl: string, appId: string, options: GabagoolInitOptions = {}): Promise<void> {
@@ -79,6 +93,7 @@ export class GabagoolAds {
     this.instance.dispose();
     this.resetReady();
     this.instance = createGabagool();
+    this.instance.setRewardedSsv(this.ssv);
 
     const adapter = options.adapter ?? new ReactNativeGmaAdapter();
     this.gmaAdapter = adapter instanceof ReactNativeGmaAdapter ? adapter : null;