cordova-plugin-harfin-pgs-v2
v1.1.3
Published
Google Play Games Services v2 Cordova bridge for Harf'in Izinde.
Maintainers
Readme
cordova-plugin-harfin-pgs-v2 1.1.1
Android PGS v2 22.1.0. Cordova global: HarfinPlayGamesV2. Initialization and isAuthenticated() retain their 1.0.0 Promise API. Cloud methods resolve structured objects including native/transport/validation failures: {success:false,error,code}. They never access game local SaveData or force sign-in.
- saveCloud(json, progressValue): JSON object encoded as a string; progressValue is a non-negative safe integer Number, or BigInt up to 9223372036854775807n.
- loadCloud(): {success:true,exists:false}, or {success:true,exists:true,data,progressValue}.
- hasCloudSave(): {success:true,exists:boolean}.
- saveCloud success: {success:true,syncPending:boolean}.
- Values larger than Number.MAX_SAFE_INTEGER are returned as decimal strings in loadCloud.progressValue.
One snapshot: harfin_izinde_save_v1. UTF-8, highest-progress conflict policy. Unresolved conflicts fail without manual merging or deleting saves. Concurrent requests return BUSY; retry after the active operation finishes. Read-only handles are discarded/closed; no snapshot deletion API is used. Operations execute on Cordova's worker pool, not the main thread. Missing snapshot is mapped only from SNAPSHOT_NOT_FOUND, never from network/auth errors.
Network availability is checked before operations and immediately before saving. PGS can cache commits if connectivity drops during commit; success means SDK commit acceptance. syncPending exposes that condition, not a guarantee of remote synchronization. The plugin adds INTERNET and ACCESS_NETWORK_STATE (normal permissions, no popup). No access tokens or save payloads are logged.
This release contains no GDevelop gameplay or save schema integration. The existing HarfinPGS 1.0.0 extension's cloud wrappers are not compatible with this structured API; they must be updated separately before any game-side Saved Games calls are enabled.
1.1.1 adds signIn(): Promise, using GamesSignInClient.signIn() only on explicit user action. Native sign-in requests are serialized; cancellation/error never accesses local storage. loadCloud() also returns modifiedTime for read-only diagnostics. Snapshot name, UTF-8 schema handling, SDK 22.1.0 and highest-progress policy are unchanged.
1.1.3 Achievements
unlockAchievement(achievementId) returns a Promise of {success:true} or {success:false,code,error}. Non-empty real Play Console IDs are required; the native bridge verifies authentication before PlayGames.getAchievementsClient(activity).unlockImmediate(id). No automatic sign-in, snapshots, local saves or UI changes. Existing authentication and cloud APIs are unchanged.
