feat: Added standalone platform support

Author: 9teen90nine

src/PlaygamaBridge.js

@@ -276,6 +276,8 @@ class PlaygamaBridge {
             platformId = this.#getPlatformId(configFileModule.options.forciblySetPlatformId.toLowerCase())
         } else if (url.searchParams.has('platform_id')) {
             platformId = this.#getPlatformId(url.searchParams.get('platform_id').toLowerCase())
+        } else if (__INCLUDE_STANDALONE__ && url.searchParams.get('platform') === PLATFORM_ID.STANDALONE) {
+            platformId = PLATFORM_ID.STANDALONE
         } else if (__INCLUDE_YANDEX__ && (url.hostname.includes(['y', 'a', 'n', 'd', 'e', 'x', '.', 'n', 'e', 't'].join('')) || url.hash.includes('yandex'))) {
             platformId = PLATFORM_ID.YANDEX
         } else if (__INCLUDE_CRAZY_GAMES__ && (url.hostname.includes('crazygames.') || url.hostname.includes('1001juegos.com'))) {

src/constants.js

@@ -26,6 +26,7 @@ export const PLATFORM_ID = {
     ABSOLUTE_GAMES: 'absolute_games',
     GAME_DISTRIBUTION: 'game_distribution',
     PLAYGAMA: 'playgama',
+    STANDALONE: 'standalone',
     PLAYDECK: 'playdeck',
     TELEGRAM: 'telegram',
     Y8: 'y8',

src/platform-bridges/PlaygamaPlatformBridge.js

@@ -28,14 +28,28 @@ import {
     PLATFORM_MESSAGE,
 } from '../constants'
 
-const SDK_URL = 'https://playgama.com/platform-sdk/v1.js'
-
 class PlaygamaPlatformBridge extends PlatformBridgeBase {
     // platform
     get platformId() {
         return PLATFORM_ID.PLAYGAMA
     }
 
+    get sdkUrl() {
+        return 'https://playgama.com/platform-sdk/v1.js'
+    }
+
+    get sdkGlobalName() {
+        return 'PLAYGAMA_SDK'
+    }
+
+    get platformSdk() {
+        return window[this.sdkGlobalName]
+    }
+
+    get platformLanguage() {
+        return this._platformSdk?.platformService?.getLanguage?.() || super.platformLanguage
+    }
+
     // advertisement
     get isInterstitialSupported() {
         return true
@@ -60,10 +74,6 @@ class PlaygamaPlatformBridge extends PlatformBridgeBase {
         return this.#isPaymentsSupported
     }
 
-    get platformLanguage() {
-        return this._platformSdk.platformService.getLanguage() || super.platformLanguage
-    }
-
     _isAdvancedBannersSupported = true
 
     #isPaymentsSupported = true
@@ -76,9 +86,9 @@ class PlaygamaPlatformBridge extends PlatformBridgeBase {
         if (!promiseDecorator) {
             promiseDecorator = this._createPromiseDecorator(ACTION_NAME.INITIALIZE)
 
-            addJavaScript(SDK_URL).then(() => {
-                waitFor('PLAYGAMA_SDK').then(() => {
-                    this._platformSdk = window.PLAYGAMA_SDK
+            addJavaScript(this.sdkUrl).then(() => {
+                waitFor(this.sdkGlobalName).then(() => {
+                    this._platformSdk = this.platformSdk
 
                     this._platformSdk.advService.subscribeToAdStateChanges((adType, state) => {
                         if (adType === 'interstitial') {
@@ -134,7 +144,7 @@ class PlaygamaPlatformBridge extends PlatformBridgeBase {
 
                     Promise.all([
                         this.#getPlayer(),
-                        this._platformSdk.platformService?.isReady,
+                        this._platformSdk.platformService?.isReady ?? Promise.resolve(),
                     ]).then(() => {
                         if (this._platformSdk.platformService?.getIsPaymentsSupported) {
                             this.#isPaymentsSupported = this._platformSdk.platformService.getIsPaymentsSupported()
@@ -143,7 +153,7 @@ class PlaygamaPlatformBridge extends PlatformBridgeBase {
                         this._resolvePromiseDecorator(ACTION_NAME.INITIALIZE)
                     })
 
-                    if (this._platformSdk.platformService.getAdditionalParams) {
+                    if (this._platformSdk.platformService?.getAdditionalParams) {
                         this._additionalData = this._platformSdk.platformService.getAdditionalParams() || {}
                     }
                 })
@@ -157,7 +167,7 @@ class PlaygamaPlatformBridge extends PlatformBridgeBase {
     sendMessage(message) {
         switch (message) {
             case PLATFORM_MESSAGE.GAME_READY: {
-                this._platformSdk.gameService.gameReady()
+                this._platformSdk.gameService?.gameReady?.()
                 return Promise.resolve()
             }
             default: {
@@ -235,7 +245,7 @@ class PlaygamaPlatformBridge extends PlatformBridgeBase {
                     data[key] = (typeof value !== 'string') ? JSON.stringify(value) : value
                 }
 
-                this._platformSdk.storageApi.setItems(data)
+                this._platformSdk.storageApi?.setItems?.(data)
                 return super.setDataToStorage(key, value, storageType)
             }
             default: {
@@ -271,7 +281,7 @@ class PlaygamaPlatformBridge extends PlatformBridgeBase {
                 })
             }
             case STORAGE_TYPE.LOCAL_STORAGE: {
-                this._platformSdk.storageApi.deleteItems(Array.isArray(key) ? key : [key])
+                this._platformSdk.storageApi?.deleteItems?.(Array.isArray(key) ? key : [key])
                 return super.deleteDataFromStorage(key, storageType)
             }
             default: {

src/platform-bridges/StandalonePlatformBridge.js

@@ -0,0 +1,45 @@
+/*
+ * This file is part of Playgama Bridge.
+ *
+ * Playgama Bridge is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * any later version.
+ *
+ * Playgama Bridge is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with Playgama Bridge. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import PlaygamaPlatformBridge from './PlaygamaPlatformBridge'
+import { PLATFORM_ID } from '../constants'
+
+class StandalonePlatformBridge extends PlaygamaPlatformBridge {
+    get platformId() {
+        return PLATFORM_ID.STANDALONE
+    }
+
+    get sdkUrl() {
+        return 'https://playgama.com/platform-sdk/wrap.v1.js'
+    }
+
+    get sdkGlobalName() {
+        return 'PLAYGAMA_WRAP'
+    }
+
+    get isExternalLinksAllowed() {
+        return true
+    }
+
+    get isPaymentsSupported() {
+        return true
+    }
+
+    _isAdvancedBannersSupported = false
+}
+
+export default StandalonePlatformBridge

src/platformImports.js

@@ -41,6 +41,9 @@ if (__INCLUDE_GAME_DISTRIBUTION__) {
 if (__INCLUDE_PLAYGAMA__) {
     platformImports[PLATFORM_ID.PLAYGAMA] = () => import('./platform-bridges/PlaygamaPlatformBridge')
 }
+if (__INCLUDE_STANDALONE__) {
+    platformImports[PLATFORM_ID.STANDALONE] = () => import('./platform-bridges/StandalonePlatformBridge')
+}
 if (__INCLUDE_PLAYDECK__) {
     platformImports[PLATFORM_ID.PLAYDECK] = () => import('./platform-bridges/PlayDeckPlatformBridge')
 }

tests/common/playgama/playgama.ts

@@ -48,12 +48,15 @@ export function createPlaygamaSdk(
         getAdditionalParams: vi.fn().mockReturnValue({}),
     }
 
-    testGlobalThis.PLAYGAMA_SDK = {
-        userService,
-        advService,
-        cloudSaveApi,
-        platformService,
-    }
+    const sdk = {
+        userService,
+        advService,
+        cloudSaveApi,
+        platformService,
+    }
+
+    testGlobalThis.PLAYGAMA_SDK = sdk
+    testGlobalThis.PLAYGAMA_WRAP = sdk
 
     return Promise.resolve()
 }

tests/common/types.ts

@@ -6,6 +6,7 @@ export type TestGlobalThis = Omit<typeof globalThis, 'addEventListener' | 'remov
     fetch?: ReturnType<typeof vi.fn>
     location?: Location
     PLAYGAMA_SDK?: PlaygamaSdk
+    PLAYGAMA_WRAP?: PlaygamaSdk
     AgRuSdkMethods?: {
         ShowCampaign: string
     }
@@ -22,4 +23,4 @@ export type TestGlobalThis = Omit<typeof globalThis, 'addEventListener' | 'remov
     parent?: {
         postMessage: (message: unknown, target: string) => void
     }
-}
+}

tests/src/bridge/initialize.e2e.spec.ts

@@ -15,9 +15,15 @@ describe('initialize (integration, PlaygamaBridge)', () => {
         PLATFORM_ID.MOCK,
         PLATFORM_ID.QA_TOOL,
         PLATFORM_ID.PLAYGAMA,
+        PLATFORM_ID.STANDALONE,
         PLATFORM_ID.ABSOLUTE_GAMES
     ])('Initialize by platform_id query parameter %s', async (platformId: string) => {
         const { bridge } = await createBridgeByUrl(`http://localhost/?platform_id=${platformId}`)
         expect(bridge.platform.id).toBe(platformId)
     })
+
+    test('Initialize standalone by platform query parameter', async () => {
+        const { bridge } = await createBridgeByUrl(`http://localhost/?platform=${PLATFORM_ID.STANDALONE}`)
+        expect(bridge.platform.id).toBe(PLATFORM_ID.STANDALONE)
+    })
 })