@clocktone/game-sdk 1.0.0

package/android/src/main/kotlin/com/playloop/plugins/applovinmax/PlayLoopAppLovinMaxPlugin.kt

@@ -0,0 +1,316 @@
+package com.playloop.plugins.applovinmax
+
+import android.util.Log
+import android.view.Gravity
+import android.view.View
+import android.widget.FrameLayout
+import com.applovin.mediation.MaxAd
+import com.applovin.mediation.MaxAdListener
+import com.applovin.mediation.MaxAdViewAdListener
+import com.applovin.mediation.MaxError
+import com.applovin.mediation.MaxReward
+import com.applovin.mediation.MaxRewardedAdListener
+import com.applovin.mediation.ads.MaxAdView
+import com.applovin.mediation.ads.MaxInterstitialAd
+import com.applovin.mediation.ads.MaxRewardedAd
+import com.applovin.sdk.AppLovinMediationProvider
+import com.applovin.sdk.AppLovinSdk
+import com.applovin.sdk.AppLovinSdkInitializationConfiguration
+import com.applovin.sdk.AppLovinSdkUtils
+import com.getcapacitor.JSObject
+import com.getcapacitor.Plugin
+import com.getcapacitor.PluginCall
+import com.getcapacitor.PluginMethod
+import com.getcapacitor.annotation.CapacitorPlugin
+
+@CapacitorPlugin(name = "PlayLoopAppLovinMax")
+class PlayLoopAppLovinMaxPlugin : Plugin() {
+
+    companion object {
+        private const val TAG = "PlayLoopAppLovinMax"
+    }
+
+    private var rewardedAd: MaxRewardedAd? = null
+    private var interstitialAd: MaxInterstitialAd? = null
+    private var bannerAdView: MaxAdView? = null
+    private var pendingRewardedCall: PluginCall? = null
+    private var pendingInterstitialCall: PluginCall? = null
+    private var userEarnedReward = false
+
+    @PluginMethod
+    fun initialize(call: PluginCall) {
+        val sdkKey = call.getString("sdkKey") ?: run {
+            call.reject("SDK key parameter missing")
+            return
+        }
+        val rewardedAdUnitId = call.getString("rewardedAdUnitId") ?: run {
+            call.reject("Rewarded unit identifier missing")
+            return
+        }
+        val interstitialAdUnitId = call.getString("interstitialAdUnitId") ?: run {
+            call.reject("Interstitial unit identifier missing")
+            return
+        }
+        val bannerAdUnitId = call.getString("bannerAdUnitId")
+
+        activity.runOnUiThread {
+            val initConfig = AppLovinSdkInitializationConfiguration.builder(sdkKey, activity)
+                .setMediationProvider(AppLovinMediationProvider.MAX)
+                .build()
+
+            AppLovinSdk.getInstance(activity).initialize(initConfig) {
+                Log.d(TAG, "Ad mediation ready")
+
+                // Create and load rewarded ad
+                rewardedAd = MaxRewardedAd.getInstance(rewardedAdUnitId, activity.applicationContext)
+                rewardedAd?.setListener(rewardedAdListener)
+                rewardedAd?.loadAd()
+
+                // Create and load interstitial ad
+                interstitialAd = MaxInterstitialAd(interstitialAdUnitId, activity.applicationContext)
+                interstitialAd?.setListener(interstitialAdListener)
+                interstitialAd?.loadAd()
+
+                // Pre-create banner if ad unit ID provided
+                if (bannerAdUnitId != null) {
+                    createBannerAdView(bannerAdUnitId)
+                }
+
+                call.resolve()
+            }
+        }
+    }
+
+    @PluginMethod
+    fun showRewardedAd(call: PluginCall) {
+        activity.runOnUiThread {
+            val ad = rewardedAd
+            if (ad == null || !ad.isReady) {
+                val ret = JSObject()
+                ret.put("rewarded", false)
+                call.resolve(ret)
+                return@runOnUiThread
+            }
+
+            pendingRewardedCall = call
+            userEarnedReward = false
+            ad.showAd(activity)
+        }
+    }
+
+    @PluginMethod
+    fun showInterstitial(call: PluginCall) {
+        activity.runOnUiThread {
+            val ad = interstitialAd
+            if (ad == null || !ad.isReady) {
+                val ret = JSObject()
+                ret.put("shown", false)
+                call.resolve(ret)
+                return@runOnUiThread
+            }
+
+            pendingInterstitialCall = call
+            ad.showAd(activity)
+        }
+    }
+
+    @PluginMethod
+    fun showBanner(call: PluginCall) {
+        activity.runOnUiThread {
+            val adView = bannerAdView
+            if (adView == null) {
+                val ret = JSObject()
+                ret.put("shown", false)
+                call.resolve(ret)
+                return@runOnUiThread
+            }
+
+            val position = call.getString("position", "bottom")
+            val gravity = if (position == "top") Gravity.TOP else Gravity.BOTTOM
+
+            val params = adView.layoutParams as? FrameLayout.LayoutParams
+            if (params != null) {
+                params.gravity = gravity or Gravity.CENTER_HORIZONTAL
+                adView.layoutParams = params
+            }
+
+            adView.visibility = View.VISIBLE
+            adView.startAutoRefresh()
+
+            val ret = JSObject()
+            ret.put("shown", true)
+            call.resolve(ret)
+        }
+    }
+
+    @PluginMethod
+    fun hideBanner(call: PluginCall) {
+        activity.runOnUiThread {
+            bannerAdView?.visibility = View.GONE
+            bannerAdView?.stopAutoRefresh()
+            call.resolve()
+        }
+    }
+
+    @PluginMethod
+    fun destroyBanner(call: PluginCall) {
+        activity.runOnUiThread {
+            bannerAdView?.let { adView ->
+                adView.stopAutoRefresh()
+                adView.visibility = View.GONE
+                (adView.parent as? FrameLayout)?.removeView(adView)
+                adView.destroy()
+            }
+            bannerAdView = null
+            call.resolve()
+        }
+    }
+
+    private fun createBannerAdView(adUnitId: String) {
+        val adView = MaxAdView(adUnitId, activity.applicationContext)
+        adView.setListener(bannerAdListener)
+
+        // Standard banner size: 320×50 on phones, 728×90 on tablets
+        val isTablet = AppLovinSdkUtils.isTablet(activity)
+        val heightDp = if (isTablet) 90 else 50
+        val heightPx = AppLovinSdkUtils.dpToPx(activity, heightDp)
+
+        val params = FrameLayout.LayoutParams(
+            FrameLayout.LayoutParams.MATCH_PARENT,
+            heightPx
+        )
+        params.gravity = Gravity.BOTTOM or Gravity.CENTER_HORIZONTAL
+        adView.layoutParams = params
+
+        // Start hidden
+        adView.visibility = View.GONE
+
+        // Add to the activity's root view
+        val rootView = activity.findViewById<FrameLayout>(android.R.id.content)
+        rootView.addView(adView)
+
+        // Load the first ad
+        adView.loadAd()
+
+        bannerAdView = adView
+        Log.d(TAG, "Strip unit ready: $adUnitId")
+    }
+
+    // ─── Rewarded Ad Listener ───
+
+    private val rewardedAdListener = object : MaxRewardedAdListener {
+        override fun onAdLoaded(ad: MaxAd) {
+            Log.d(TAG, "Incentive unit ready")
+        }
+
+        override fun onAdLoadFailed(adUnitId: String, error: MaxError) {
+            Log.d(TAG, "Incentive unit fetch err: ${error.message}")
+        }
+
+        override fun onAdDisplayed(ad: MaxAd) {
+            Log.d(TAG, "Incentive unit shown")
+        }
+
+        override fun onAdDisplayFailed(ad: MaxAd, error: MaxError) {
+            Log.d(TAG, "Incentive unit present err: ${error.message}")
+            val ret = JSObject()
+            ret.put("rewarded", false)
+            pendingRewardedCall?.resolve(ret)
+            pendingRewardedCall = null
+            rewardedAd?.loadAd()
+        }
+
+        override fun onAdClicked(ad: MaxAd) {
+            Log.d(TAG, "Incentive unit tapped")
+        }
+
+        override fun onAdHidden(ad: MaxAd) {
+            Log.d(TAG, "Incentive unit closed, credited=$userEarnedReward")
+            val ret = JSObject()
+            ret.put("rewarded", userEarnedReward)
+            pendingRewardedCall?.resolve(ret)
+            pendingRewardedCall = null
+            userEarnedReward = false
+            rewardedAd?.loadAd()
+        }
+
+        override fun onUserRewarded(ad: MaxAd, reward: MaxReward) {
+            Log.d(TAG, "Credit granted: ${reward.amount} ${reward.label}")
+            userEarnedReward = true
+        }
+    }
+
+    // ─── Interstitial Ad Listener ───
+
+    private val interstitialAdListener = object : MaxAdListener {
+        override fun onAdLoaded(ad: MaxAd) {
+            Log.d(TAG, "Fullscreen unit ready")
+        }
+
+        override fun onAdLoadFailed(adUnitId: String, error: MaxError) {
+            Log.d(TAG, "Fullscreen unit fetch err: ${error.message}")
+        }
+
+        override fun onAdDisplayed(ad: MaxAd) {
+            Log.d(TAG, "Fullscreen unit shown")
+        }
+
+        override fun onAdDisplayFailed(ad: MaxAd, error: MaxError) {
+            Log.d(TAG, "Fullscreen unit present err: ${error.message}")
+            val ret = JSObject()
+            ret.put("shown", false)
+            pendingInterstitialCall?.resolve(ret)
+            pendingInterstitialCall = null
+            interstitialAd?.loadAd()
+        }
+
+        override fun onAdClicked(ad: MaxAd) {
+            Log.d(TAG, "Fullscreen unit tapped")
+        }
+
+        override fun onAdHidden(ad: MaxAd) {
+            Log.d(TAG, "Fullscreen unit closed")
+            val ret = JSObject()
+            ret.put("shown", true)
+            pendingInterstitialCall?.resolve(ret)
+            pendingInterstitialCall = null
+            interstitialAd?.loadAd()
+        }
+    }
+
+    // ─── Banner Ad Listener ───
+
+    private val bannerAdListener = object : MaxAdViewAdListener {
+        override fun onAdLoaded(ad: MaxAd) {
+            Log.d(TAG, "Strip unit fetched")
+        }
+
+        override fun onAdLoadFailed(adUnitId: String, error: MaxError) {
+            Log.d(TAG, "Strip unit fetch err: ${error.message}")
+        }
+
+        override fun onAdDisplayed(ad: MaxAd) {
+            Log.d(TAG, "Strip unit shown")
+        }
+
+        override fun onAdDisplayFailed(ad: MaxAd, error: MaxError) {
+            Log.d(TAG, "Strip unit present err: ${error.message}")
+        }
+
+        override fun onAdClicked(ad: MaxAd) {
+            Log.d(TAG, "Strip unit tapped")
+        }
+
+        override fun onAdHidden(ad: MaxAd) {
+            Log.d(TAG, "Strip unit closed")
+        }
+
+        override fun onAdExpanded(ad: MaxAd) {
+            Log.d(TAG, "Strip unit expanded")
+        }
+
+        override fun onAdCollapsed(ad: MaxAd) {
+            Log.d(TAG, "Strip unit collapsed")
+        }
+    }
+}

package/android/src/main/kotlin/com/playloop/plugins/deviceid/PlayLoopDeviceIdPlugin.kt

@@ -0,0 +1,30 @@
+package com.playloop.plugins.deviceid
+
+import android.util.Log
+import com.google.android.gms.appset.AppSet
+import com.getcapacitor.JSObject
+import com.getcapacitor.Plugin
+import com.getcapacitor.PluginCall
+import com.getcapacitor.PluginMethod
+import com.getcapacitor.annotation.CapacitorPlugin
+
+@CapacitorPlugin(name = "PlayLoopDeviceId")
+class PlayLoopDeviceIdPlugin : Plugin() {
+
+    companion object {
+        private const val TAG = "PlayLoopDeviceId"
+    }
+
+    @PluginMethod
+    fun getAppSetId(call: PluginCall) {
+        val client = AppSet.getClient(activity)
+        client.appSetIdInfo.addOnSuccessListener { info ->
+            val ret = JSObject()
+            ret.put("id", info.id)
+            call.resolve(ret)
+        }.addOnFailureListener { e ->
+            Log.e(TAG, "Device identifier retrieval unsuccessful", e)
+            call.reject("Device identifier retrieval failed: ${e.message}")
+        }
+    }
+}

package/dist/loader/cjs/index.js

@@ -0,0 +1,72 @@
+'use strict';
+
+/**
+ * PlayLoop SDK Loader — thin bootstrap for CDN-delivered SDK.
+ *
+ * Games bundle this loader via their build tool (Vite/Webpack).
+ * It shims CapacitorCore, fetches the SDK version from the backend,
+ * loads the IIFE script from CDN, and returns the typed constructor.
+ */
+/** Compute widget top-bar height from window.innerWidth — no SDK load required. */
+function getWidgetHeight() {
+    if (typeof window === 'undefined')
+        return 0;
+    const scale = Math.min(window.innerWidth / 360, 1.33);
+    return Math.round(48 * scale + 3) + 16;
+}
+const DEFAULT_FALLBACK = 'https://getplayloop.com/sdk/v0.8.5/playloop-sdk.js';
+/**
+ * Load the PlayLoop SDK from CDN and return the constructor.
+ *
+ * 1. Shims `window.CapacitorCore` so the IIFE can resolve `@capacitor/core`
+ * 2. Fetches `/s/arcade/sdk-ver` to get the latest CDN URL
+ * 3. Injects a `<script>` tag for the IIFE bundle
+ * 4. Returns the typed `PlayLoopSDK` constructor
+ */
+async function loadPlayLoopSDK(options) {
+    // 1. Shim CapacitorCore for the IIFE's UMD/globals wrapper
+    if (!window.CapacitorCore) {
+        try {
+            const capCore = await import('@capacitor/core');
+            window.CapacitorCore = capCore;
+        }
+        catch {
+            if (window.Capacitor) {
+                window.CapacitorCore = { Capacitor: window.Capacitor };
+            }
+            else {
+                window.CapacitorCore = {};
+            }
+        }
+    }
+    // 2. Fetch SDK version from backend
+    const timeout = options.timeoutMs ?? 5000;
+    const fallback = options.fallbackUrl ?? DEFAULT_FALLBACK;
+    let scriptUrl = fallback;
+    try {
+        const res = await fetch(`${options.apiBaseUrl}/s/arcade/sdk-ver`, { signal: AbortSignal.timeout(timeout) });
+        const data = await res.json();
+        if (data.enabled && data.url)
+            scriptUrl = data.url;
+    }
+    catch (e) {
+        console.warn('[PlayLoopLoader] Version fetch failed, using fallback:', e);
+    }
+    // 3. Load the IIFE script
+    await new Promise((resolve, reject) => {
+        const script = document.createElement('script');
+        script.src = scriptUrl;
+        script.onload = () => resolve();
+        script.onerror = () => reject(new Error(`Failed to load SDK from ${scriptUrl}`));
+        document.head.appendChild(script);
+    });
+    console.log(`[PlayLoopLoader] SDK loaded from ${scriptUrl}`);
+    // 4. Return typed constructor
+    const ctor = window.PlayLoopSDK?.PlayLoopSDK;
+    if (!ctor)
+        throw new Error('[PlayLoopLoader] window.PlayLoopSDK.PlayLoopSDK not found after script load');
+    return ctor;
+}
+
+exports.getWidgetHeight = getWidgetHeight;
+exports.loadPlayLoopSDK = loadPlayLoopSDK;

package/dist/loader/esm/index.js

@@ -0,0 +1,69 @@
+/**
+ * PlayLoop SDK Loader — thin bootstrap for CDN-delivered SDK.
+ *
+ * Games bundle this loader via their build tool (Vite/Webpack).
+ * It shims CapacitorCore, fetches the SDK version from the backend,
+ * loads the IIFE script from CDN, and returns the typed constructor.
+ */
+/** Compute widget top-bar height from window.innerWidth — no SDK load required. */
+function getWidgetHeight() {
+    if (typeof window === 'undefined')
+        return 0;
+    const scale = Math.min(window.innerWidth / 360, 1.33);
+    return Math.round(48 * scale + 3) + 16;
+}
+const DEFAULT_FALLBACK = 'https://getplayloop.com/sdk/v0.8.5/playloop-sdk.js';
+/**
+ * Load the PlayLoop SDK from CDN and return the constructor.
+ *
+ * 1. Shims `window.CapacitorCore` so the IIFE can resolve `@capacitor/core`
+ * 2. Fetches `/s/arcade/sdk-ver` to get the latest CDN URL
+ * 3. Injects a `<script>` tag for the IIFE bundle
+ * 4. Returns the typed `PlayLoopSDK` constructor
+ */
+async function loadPlayLoopSDK(options) {
+    // 1. Shim CapacitorCore for the IIFE's UMD/globals wrapper
+    if (!window.CapacitorCore) {
+        try {
+            const capCore = await import('@capacitor/core');
+            window.CapacitorCore = capCore;
+        }
+        catch {
+            if (window.Capacitor) {
+                window.CapacitorCore = { Capacitor: window.Capacitor };
+            }
+            else {
+                window.CapacitorCore = {};
+            }
+        }
+    }
+    // 2. Fetch SDK version from backend
+    const timeout = options.timeoutMs ?? 5000;
+    const fallback = options.fallbackUrl ?? DEFAULT_FALLBACK;
+    let scriptUrl = fallback;
+    try {
+        const res = await fetch(`${options.apiBaseUrl}/s/arcade/sdk-ver`, { signal: AbortSignal.timeout(timeout) });
+        const data = await res.json();
+        if (data.enabled && data.url)
+            scriptUrl = data.url;
+    }
+    catch (e) {
+        console.warn('[PlayLoopLoader] Version fetch failed, using fallback:', e);
+    }
+    // 3. Load the IIFE script
+    await new Promise((resolve, reject) => {
+        const script = document.createElement('script');
+        script.src = scriptUrl;
+        script.onload = () => resolve();
+        script.onerror = () => reject(new Error(`Failed to load SDK from ${scriptUrl}`));
+        document.head.appendChild(script);
+    });
+    console.log(`[PlayLoopLoader] SDK loaded from ${scriptUrl}`);
+    // 4. Return typed constructor
+    const ctor = window.PlayLoopSDK?.PlayLoopSDK;
+    if (!ctor)
+        throw new Error('[PlayLoopLoader] window.PlayLoopSDK.PlayLoopSDK not found after script load');
+    return ctor;
+}
+
+export { getWidgetHeight, loadPlayLoopSDK };

package/dist/types/CashableSDK.d.ts

@@ -0,0 +1,46 @@
+import { CashableSDKConfig, IAds, AdConfig } from './types.js';
+import { UIModule } from './ui/UIModule.js';
+import { SessionModule } from './modules/SessionModule.js';
+import { RewardsModule } from './modules/RewardsModule.js';
+import { AnalyticsModule } from './modules/AnalyticsModule.js';
+import { FeatureFlagModule } from './modules/FeatureFlagModule.js';
+import { BabylonPlugin } from './babylon/BabylonPlugin.js';
+
+declare class CashableSDK {
+    private config;
+    private transport;
+    private emitter;
+    private unsubTransportEvents;
+    private unsubRewardsCoins;
+    private _session;
+    private _rewards;
+    private _ads;
+    private _analytics;
+    private _featureFlags;
+    private _babylon;
+    private _ui;
+    private _isAuthenticated;
+    readonly mode: 'embedded' | 'standalone';
+    constructor(config: CashableSDKConfig);
+    init(): Promise<void>;
+    get session(): SessionModule;
+    get rewards(): RewardsModule;
+    get ads(): IAds;
+    get analytics(): AnalyticsModule;
+    /** Whether the SDK has a linked user on the backend. Always true in embedded mode. */
+    get isAuthenticated(): boolean;
+    /** Feature flag / remote config module. Null if not initialized. */
+    get featureFlags(): FeatureFlagModule | null;
+    getTopBarHeight(): number;
+    /** Convenience getter for ad configuration values (with defaults). */
+    get adConfig(): Readonly<AdConfig>;
+    /** UI module for standalone mode (top bar, sponsored modal). Null if not available. */
+    get ui(): UIModule | null;
+    get babylon(): BabylonPlugin;
+    onFreeze(handler: () => void): () => void;
+    onResume(handler: () => void): () => void;
+    dispose(): void;
+    private detectMode;
+}
+
+export { CashableSDK };

package/dist/types/adapters/CapacitorAdsAdapter.d.ts

@@ -0,0 +1,25 @@
+import { IAdsAdapter, BannerPosition } from '../types.js';
+
+interface AppLovinConfig {
+    sdkKey: string;
+    rewardedAdUnitId: string;
+    interstitialAdUnitId: string;
+    bannerAdUnitId?: string;
+    debug?: boolean;
+}
+declare class CapacitorAdsAdapter implements IAdsAdapter {
+    private plugin;
+    private config;
+    private initialized;
+    private initPromise;
+    private debug;
+    constructor(config: AppLovinConfig);
+    initialize(): Promise<void>;
+    showRewardedVideo(): Promise<boolean>;
+    showInterstitial(): Promise<boolean>;
+    showBanner(position?: BannerPosition): Promise<boolean>;
+    hideBanner(): Promise<void>;
+    destroyBanner(): Promise<void>;
+}
+
+export { CapacitorAdsAdapter };

package/dist/types/adapters/WebViewAdsAdapter.d.ts

@@ -0,0 +1,13 @@
+import { IAdsAdapter, ITransport, BannerPosition } from '../types.js';
+
+declare class WebViewAdsAdapter implements IAdsAdapter {
+    private transport;
+    constructor(transport: ITransport);
+    showRewardedVideo(): Promise<boolean>;
+    showInterstitial(): Promise<boolean>;
+    showBanner(position?: BannerPosition): Promise<boolean>;
+    hideBanner(): Promise<void>;
+    destroyBanner(): Promise<void>;
+}
+
+export { WebViewAdsAdapter };

package/dist/types/babylon/BabylonPlugin.d.ts

@@ -0,0 +1,17 @@
+type BabylonEngine = {
+    stopRenderLoop(renderFunction?: () => void): void;
+    runRenderLoop(renderFunction: () => void): void;
+};
+type BabylonScene = {
+    render(): void;
+};
+declare class BabylonPlugin {
+    private engine;
+    private scene;
+    bindScene(scene: BabylonScene, engine?: BabylonEngine): void;
+    freeze(): void;
+    resume(): void;
+    dispose(): void;
+}
+
+export { BabylonPlugin };

package/dist/types/babylon/index.d.ts

@@ -0,0 +1,17 @@
+type BabylonEngine = {
+    stopRenderLoop(renderFunction?: () => void): void;
+    runRenderLoop(renderFunction: () => void): void;
+};
+type BabylonScene = {
+    render(): void;
+};
+declare class BabylonPlugin {
+    private engine;
+    private scene;
+    bindScene(scene: BabylonScene, engine?: BabylonEngine): void;
+    freeze(): void;
+    resume(): void;
+    dispose(): void;
+}
+
+export { BabylonPlugin };