cordova-plugin-harfin-pgs-v2 1.0.0

package/README.md

@@ -0,0 +1,9 @@
+# cordova-plugin-harfin-pgs-v2
+
+Independent Cordova Android bridge for Google Play Games Services v2.
+
+Active: PlayGamesSdk.initialize, GamesSignInClient.isAuthenticated, and play-services-games-v2:22.1.0.
+
+Saved Games action names saveCloud, loadCloud and hasCloudSave are scaffolded. The native layer obtains a SnapshotsClient but intentionally returns a clear error until the save schema and synchronization flow are implemented. This preparation package writes no cloud data.
+
+Publish this package to npm, then reference cordova-plugin-harfin-pgs-v2 version 1.0.0 from the HarfinPGS GDevelop extension.

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "cordova-plugin-harfin-pgs-v2",
+  "version": "1.0.0",
+  "description": "Google Play Games Services v2 Cordova bridge for Harf'in Izinde.",
+  "cordova": {
+    "id": "cordova-plugin-harfin-pgs-v2",
+    "platforms": [
+      "android"
+    ]
+  },
+  "keywords": [
+    "ecosystem:cordova",
+    "cordova-android",
+    "google-play-games",
+    "pgs-v2",
+    "saved-games"
+  ],
+  "license": "UNLICENSED",
+  "private": false,
+  "engines": {
+    "cordova": ">=11.0.0"
+  },
+  "files": [
+    "plugin.xml",
+    "src/android/HarfinPlayGamesV2.java",
+    "src/android/pgs-v2-repositories.gradle",
+    "www/harfin-play-games-v2.js",
+    "README.md"
+  ]
+}

package/plugin.xml

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<plugin xmlns="http://apache.org/cordova/ns/plugins/1.0" xmlns:android="http://schemas.android.com/apk/res/android" id="cordova-plugin-harfin-pgs-v2" version="1.0.0">
+  <name>HarfinPlayGamesV2</name>
+  <description>Google Play Games Services v2 initialization, authentication and Saved Games bridge.</description>
+  <license>UNLICENSED</license>
+  <keywords>cordova,android,google-play-games,v2,saved-games</keywords>
+  <engines>
+    <engine name="cordova" version=">=11.0.0" />
+  </engines>
+  <js-module src="www/harfin-play-games-v2.js" name="HarfinPlayGamesV2"><clobbers target="HarfinPlayGamesV2" /></js-module>
+  <platform name="android">
+    <preference name="PLAY_GAMES_PROJECT_ID" default="593340834504" />
+    <config-file target="res/xml/config.xml" parent="/*">
+      <feature name="HarfinPlayGamesV2"><param name="android-package" value="com.metkasu.harfinizinde.pgs.HarfinPlayGamesV2" />
+        <param name="onload" value="true" /></feature>
+    </config-file>
+    <config-file target="AndroidManifest.xml" parent="/manifest/application">
+      <meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/game_services_project_id" />
+    </config-file>
+    <config-file target="app/src/main/res/values/cdv_strings.xml" parent="/resources">
+      <string name="game_services_project_id" translatable="false">$PLAY_GAMES_PROJECT_ID</string>
+    </config-file>
+    <framework src="com.google.android.gms:play-services-games-v2:22.1.0" />
+    <framework src="src/android/pgs-v2-repositories.gradle" custom="true" type="gradleReference" />
+    <source-file src="src/android/HarfinPlayGamesV2.java" target-dir="src/com/metkasu/harfinizinde/pgs" />
+  </platform>
+</plugin>

package/src/android/HarfinPlayGamesV2.java

@@ -0,0 +1,121 @@
+package com.metkasu.harfinizinde.pgs;
+
+import android.app.Activity;
+import android.content.Context;
+import com.google.android.gms.games.AuthenticationResult;
+import com.google.android.gms.games.PlayGames;
+import com.google.android.gms.games.PlayGamesSdk;
+import com.google.android.gms.games.SnapshotsClient;
+import org.apache.cordova.CallbackContext;
+import org.apache.cordova.CordovaPlugin;
+import org.apache.cordova.PluginResult;
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+/** PGS v2 bridge. Saved Games actions are scaffolded but intentionally do not persist data yet. */
+public final class HarfinPlayGamesV2 extends CordovaPlugin {
+    private static final String SNAPSHOT_NAME = "harfin_izinde_save_v1";
+    private final Object initializationLock = new Object();
+    private volatile boolean initialized = false;
+
+    @Override
+    protected void pluginInitialize() {
+        initializeSdk();
+    }
+
+    private void initializeSdk() {
+        if (initialized) return;
+        synchronized (initializationLock) {
+            if (initialized) return;
+            Activity activity = cordova.getActivity();
+            if (activity == null) throw new IllegalStateException("Cordova activity is not available.");
+            Context applicationContext = activity.getApplicationContext();
+            PlayGamesSdk.initialize(applicationContext);
+            initialized = true;
+        }
+    }
+
+    @Override
+    public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {
+        Activity activity = cordova.getActivity();
+        if (activity == null) {
+            callbackContext.error("Cordova activity is not available.");
+            return true;
+        }
+        if ("initialize".equals(action)) {
+            activity.runOnUiThread(() -> {
+                try {
+                    initializeSdk();
+                    callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, true));
+                } catch (RuntimeException exception) {
+                    callbackContext.error(errorMessage("PGS v2 initialization failed", exception));
+                }
+            });
+            return true;
+        }
+        if ("isAuthenticated".equals(action)) {
+            activity.runOnUiThread(() -> checkAuthentication(callbackContext));
+            return true;
+        }
+        if ("saveCloud".equals(action)) {
+            String payload = args.optString(0, null);
+            if (payload == null || payload.trim().isEmpty()) {
+                callbackContext.error("saveCloud requires a UTF-8 JSON payload.");
+                return true;
+            }
+            try { new JSONObject(payload); } catch (JSONException exception) {
+                callbackContext.error("saveCloud payload is not valid JSON.");
+                return true;
+            }
+            activity.runOnUiThread(() -> savedGamesScaffold("saveCloud", callbackContext));
+            return true;
+        }
+        if ("loadCloud".equals(action)) {
+            activity.runOnUiThread(() -> savedGamesScaffold("loadCloud", callbackContext));
+            return true;
+        }
+        if ("hasCloudSave".equals(action)) {
+            activity.runOnUiThread(() -> savedGamesScaffold("hasCloudSave", callbackContext));
+            return true;
+        }
+        return false;
+    }
+
+    private void checkAuthentication(CallbackContext callbackContext) {
+        try {
+            initializeSdk();
+            Activity activity = cordova.getActivity();
+            PlayGames.getGamesSignInClient(activity).isAuthenticated().addOnCompleteListener(task -> {
+                if (!task.isSuccessful()) {
+                    callbackContext.error(errorMessage("PGS v2 authentication check failed", task.getException()));
+                    return;
+                }
+                AuthenticationResult result = task.getResult();
+                boolean authenticated = result != null && result.isAuthenticated();
+                callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, authenticated));
+            });
+        } catch (RuntimeException exception) {
+            callbackContext.error(errorMessage("PGS v2 authentication check failed", exception));
+        }
+    }
+
+    private void savedGamesScaffold(String action, CallbackContext callbackContext) {
+        try {
+            initializeSdk();
+            Activity activity = cordova.getActivity();
+            SnapshotsClient snapshotsClient = PlayGames.getSnapshotsClient(activity);
+            if (snapshotsClient == null) {
+                callbackContext.error("PGS v2 SnapshotsClient is unavailable.");
+                return;
+            }
+            callbackContext.error(action + " Saved Games scaffold is present but persistence is not enabled yet. Snapshot: " + SNAPSHOT_NAME);
+        } catch (RuntimeException exception) {
+            callbackContext.error(errorMessage("PGS v2 Saved Games scaffold failed", exception));
+        }
+    }
+    private static String errorMessage(String prefix, Exception exception) {
+        if (exception == null || exception.getMessage() == null || exception.getMessage().trim().isEmpty()) return prefix;
+        return prefix + ": " + exception.getMessage();
+    }
+}

package/src/android/pgs-v2-repositories.gradle

@@ -0,0 +1,5 @@
+// Applied by Cordova on every Android prepare.
+repositories {
+    google()
+    mavenCentral()
+}

package/www/harfin-play-games-v2.js

@@ -0,0 +1,32 @@
+'use strict';
+var exec = require('cordova/exec');
+function asBoolean(value) {
+    return value === true || value === 1 || value === '1' || value === 'true';
+}
+exports.initialize = function () {
+    return new Promise(function (resolve, reject) {
+        exec(function (value) { resolve(asBoolean(value)); }, reject, 'HarfinPlayGamesV2', 'initialize', []);
+    });
+};
+exports.isAuthenticated = function () {
+    return new Promise(function (resolve, reject) {
+        exec(function (value) { resolve(asBoolean(value)); }, reject, 'HarfinPlayGamesV2', 'isAuthenticated', []);
+    });
+};
+
+exports.saveCloud = function (json) {
+    var payload = typeof json === "string" ? json : JSON.stringify(json);
+    return new Promise(function (resolve, reject) {
+        exec(resolve, reject, "HarfinPlayGamesV2", "saveCloud", [payload]);
+    });
+};
+exports.loadCloud = function () {
+    return new Promise(function (resolve, reject) {
+        exec(resolve, reject, "HarfinPlayGamesV2", "loadCloud", []);
+    });
+};
+exports.hasCloudSave = function () {
+    return new Promise(function (resolve, reject) {
+        exec(function (value) { resolve(asBoolean(value)); }, reject, "HarfinPlayGamesV2", "hasCloudSave", []);
+    });
+};