@modbender/capacitor-play-games 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,86 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.3.0] - 2026-09-08
+
+Forked from `@idleflowgames/capacitor-play-games` 0.2.1. Upstream's GitHub
+repository 404s while its npm package remains published, so the source was
+recovered from the published tarball; see "About this fork" in the README for
+what that recovery involved.
+
+### Fixed
+
+- Android: apply the Kotlin Android plugin. The build script declared
+  `kotlin-gradle-plugin` on the buildscript classpath and used a
+  `kotlin { compilerOptions { ... } }` block without ever applying the plugin,
+  so Gradle failed with `Could not find method kotlin()` before compiling any
+  source. Verified by reproduction: with the line reverted the build fails with
+  that exact error, and with it applied `assembleDebug` succeeds against a
+  Capacitor 8 app on Gradle 8.14.3 / AGP 8.13.0 / JDK 21.
+
+### Changed
+
+- Renamed to `@modbender/capacitor-play-games`, and the SwiftPM product from
+  `IdleflowgamesCapacitorPlayGames` to `ModbenderCapacitorPlayGames` to match —
+  Capacitor derives the product name from the full scoped package name.
+- Toolchain: pnpm to bun; dropped the Biome and SwiftLint dev dependencies
+  rather than ship lint configuration that has never been run here.
+
+### Unchanged
+
+- The Android namespace stays `com.idleflowgames.playgames`, so this tree diffs
+  cleanly against the 0.2.1 tarball.
+
+## [0.2.1] - 2026-07-30
+
+### Changed
+
+- Android: Play Games Services v2 SDK 21.0.0 to 22.0.0. The 22.0.0 public API
+  is additive over 21.0.0 (it adds `GameStatsClient` and `PlayerGameEvent`),
+  every symbol this plugin calls is unchanged, and no plugin source changed.
+- Android: Android Gradle Plugin 9.3.1, Kotlin Gradle Plugin 2.4.10.
+- Toolchain to latest: TypeScript 6 to 7.0.2 (the native `tsgo` compiler),
+  Biome 2.5.6, Capacitor 8.4.2, rollup 4.62.3, rimraf 6.1.3,
+  `@capacitor/docgen` 0.3.1, pnpm 11.18.0.
+- iOS: `capacitor-swift-pm` floor 8.4.2.
+- CI: `actions/setup-node` v7.
+
+### Requirements
+
+- Android `minSdkVersion` 24. Play Games Services v2 SDK 22.0.0 raises its own
+  floor from 21 to 24, so an app that sets `minSdkVersion` below 24 fails the
+  manifest merge. This module already defaulted to 24, and Capacitor 8 requires
+  24, so an app on stock Capacitor 8 settings needs no change.
+
+## [0.2.0] - 2026-07-12
+
+### Added
+
+- `requestServerSideAccess({ serverClientId, forceRefresh? })` (Android): a
+  one-time OAuth 2.0 server auth code for the signed-in Play Games player, for a
+  backend to exchange for the authoritative player id (Play Games Services v2
+  `GamesSignInClient.requestServerSideAccess`).
+- `fetchIdentityVerificationSignature()` (iOS): a GameKit identity-verification
+  bundle (`GKLocalPlayer.fetchItems(forIdentityVerificationSignature:)`) a backend
+  verifies against Apple's certificate to trust the Game Center player id.
+- Both methods have a safe no-op web fallback and reject as unimplemented on the
+  non-owning native platform.
+
+## [0.1.0] - 2026-06-20
+
+### Added
+
+- Initial release.
+- Sign-in (silent + interactive) and player profile.
+- Achievement unlock / increment and the native achievements UI.
+- Leaderboard score submission and the native leaderboard UI.
+- Saved Games (load / save / list / delete) with most-recently-modified conflict
+  resolution.
+- `signInStateChanged` event for system-driven auth changes.
+- Android via Google Play Games Services v2, iOS via Apple GameKit, with a safe
+  no-op web fallback. iOS registers via `CAPBridgedPlugin` (Capacitor 8 Swift
+  registration, no Objective-C `.m` file required).

package/CapacitorPlayGames.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapacitorPlayGames'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license']
+  s.homepage = 'https://github.com/modbender/capacitor-play-games'
+  s.author = 'modbender'
+  s.source = { :git => 'https://github.com/modbender/capacitor-play-games.git', :tag => s.version.to_s }
+  s.source_files = 'ios/Plugin/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '14.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+end

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Idle Flow Games (original work)
+Copyright (c) 2026 modbender (fork)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Package.swift

@@ -0,0 +1,36 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+// Package/product/target names carry the npm scope ("Modbender…") because
+// Capacitor's `cap sync ios` derives the SwiftPM product name from the FULL
+// scoped package name (@modbender/capacitor-play-games →
+// ModbenderCapacitorPlayGames, PascalCased scope+name, same as
+// @capacitor-community/admob → CapacitorCommunityAdmob). The consuming app's
+// generated Package.swift references that derived name, so the product here must
+// match it exactly or `xcodebuild -resolvePackageDependencies` fails with
+// "product 'ModbenderCapacitorPlayGames' not found". The Swift module is
+// renamed with it; nothing imports it by name and Capacitor registers the
+// plugin via the Objective-C runtime, so the rename is source-compatible.
+let package = Package(
+    name: "ModbenderCapacitorPlayGames",
+    platforms: [.iOS(.v14)],
+    products: [
+        .library(
+            name: "ModbenderCapacitorPlayGames",
+            targets: ["ModbenderCapacitorPlayGames"]
+        )
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.4.2")
+    ],
+    targets: [
+        .target(
+            name: "ModbenderCapacitorPlayGames",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Plugin"
+        )
+    ]
+)