npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

cordova-plugin-metkasu-admob

v0.1.1

Published

Fail-closed Android Next-Gen AdMob bridge with UMP and a two-ad rewarded preload buffer

Readme

0.1.1: Production is supported with explicit valid IDs and release configuration, as requested by the owner. UI visibility is separate. The older hard production lock described below is superseded. METKASU_ADMOB_APP_ID has a default and can be overridden at Cordova installation; it is not a secret.

cordova-plugin-metkasu-admob 0.1.1

Reusable Android Cordova advertising bridge. Default is DISABLED. No native onload initialization and no advertising timers. This version permits TEST only, on a debuggable application or a separate application ID ending .adstest. PRODUCTION is rejected even if JavaScript requests it. There is no date-based reactivation.

SDK and installation

  • Google Mobile Ads Next-Gen com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0.
  • Google UMP com.google.android.ump:user-messaging-platform:4.0.0.
  • Cordova Android >=13, minSdk >=24, compileSdk >=35; actual transitive dependencies may require a higher compileSdk in your cloud environment.
  • Google Maven + Maven Central only. No JitPack or jcenter.

Do not install alongside admob-plus-cordova or another legacy Mobile Ads plugin. Installation and Gradle guards reject common old plugins and play-services-ads / play-services-ads-lite dependencies. They do not exclude PGS, Firebase or Billing libraries.

After approved NPM publication, use cordova plugin add [email protected]. For local install validation before publication, use the package folder. GDevelop integration declares a pinned Cordova dependency in an events extension and includes the JS controller/facade in that extension. See the parent integration directory for generated projects and validation reports.

API

// Development application only. Never set this in the Play production game.
MetkasuAdMob.listen(event => console.log(event.type, event.state));
const init = await MetkasuAdMob.call('initialize', { mode: 'TEST', testDeviceIds: [] });
if (init.state !== 'DISABLED' && init.state !== 'ERROR') {
  await MetkasuAdMob.call('preload', { format: 'rewarded' });
}
// ONLY in response to an explicit player action; do not call from preload callbacks.
await MetkasuAdMob.call('show', {
  format: 'rewarded', requestId: 'unique-per-attempt',
  scene: 'unique-scene-instance', placement: 'daily-2x'
});

Actions: initialize, preload, show, status, hideBanner, privacyOptions, disable. Formats: rewarded, interstitial, banner. Events: state, reward, dismiss, showfail. States: DISABLED / INITIALIZING / LOADING / READY / SHOWING / UNAVAILABLE / ERROR. MetkasuAdMobController.createController(config, nativeInvoker) supplies the higher-level gates and once-only JS reward consumption.

All IDs used by this native release are Google's demo IDs; JavaScript cannot replace them with production IDs. Test device IDs are supported in request configuration, not logged. Advertising IDs, user details and SDK response data are not sent to application logs. SDK internal logs remain SDK-owned.

Consent and cache

UMP requests a consent-information update each initialization, then shows the required consent form. canRequestAds() must pass before SDK initialization or any ad operation. Mobile Ads initializes on a background executor. If UMP fails and cannot authorize requests, initialization returns DISABLED; this plugin never assumes that the game's welcome/privacy acknowledgment is advertising consent. Sample app ID must also appear in the UMP manifest metadata. A test-device UMP error/no consent can prevent demo loading; diagnose this on a device without bypassing the gate.

If privacyOptionsRequired is returned, the host must expose privacyOptions; the supplied GDevelop facade adds an entry while Settings is open. Changing choices disables preloading until a new initialization/app session; no silent restart is attempted.

Rewarded preloading calls RewardedAdPreloader.start once with new PreloadConfiguration(request, 2). This constructor was checked in the published 1.6.0 AAR. pollAd is called only for a player show request; the SDK owns replenishment, retries and expiration. No application loop restarts preload from callbacks. Two is a target capacity, not a guarantee of two available ads. Rewarded and interstitial ready-state checks do not remove cached ads. The SDK's app-wide preload limit still applies.

Banner preload does not display the banner. Explicit display reserves WebView bottom margin so the banner does not cover game controls; if margin reservation is unsupported, display returns UNAVAILABLE. Hide/pause restores the original margin. Placement still requires real-device screen validation.

Reward safety

Only the native earned-reward callback emits reward. Native atomic receipt and the JS request ID prevent duplicates. Scene instance + placement are echoed and checked; stale scene rewards are discarded. Dismiss and show failure do not award. The SDK cannot credit the game's economy by itself; only the game's existing validated reward flow can do so. Client receipts do not provide server-side fraud-proof currency verification.

Verification status

npm test uses simulated SDK events, including five consecutive rewards. No live advertising is requested by tests. Java sources were compiled separately with ECJ/Java 17 against the actual Next-Gen 1.6.0, UMP 4.0.0 and Cordova 13 artifacts. This is not a full Android Gradle/AAB build, a dependency-tree resolution test, an emulator test or a real ad-show test. GDevelop cloud Android build and actual consent/reward/cache behavior remain unverified. Do not describe this package as production-verified.

NPM publication requires owner approval. This source package has not been published by this task. The ads-off 1.6.5 game intentionally does not require this unpublished native package, so publication does not block its export.