SDK changelog

The current SDK is 1.1.0. The script at /sdk/v1.js always serves the newest 1.x release, and 1.x releases only add things: a game built for 1.0 keeps working unchanged. Bundler users can upgrade @gems-arcadia/sdk whenever they like; GemsArcadia.version tells you which one is loaded.

1. v1.1.0 · ACHIEVEMENTS

   2026-10-03

   ADDED

   • unlockAchievement(key) unlocks one of your game's achievements for the player and resolves { ok: true, achievement, unlocked, newlyUnlocked, unlockedAt, testMode } or { ok: false, reason }. Never rejects.
   • unlockAchievement bridge request. The message protocol stays at version 1.
   • Keys are checked in the SDK first: anything that isn't lower-case letters, digits, - and _ (max 48 characters) resolves INVALID_KEY without a round trip.
   • Types AchievementUnlock, UnlockedAchievement, UnlockAchievementResult and UnlockAchievementFailure in the ESM build.
   • Mock mode answers unlockAchievement() with testMode: true and newlyUnlocked: false, so you can wire it up without the arcade.

2. v1.0.0 · FIRST COIN

   2026-10-02

   ADDED

   • init(), insertCoin(), getBalance(), submitScore(score), ready(), on() / off() and the mock helpers.
   • Events coinInserted, balanceChanged, pause and resume.
   • Script build at /sdk/v1.js (global GemsArcadia) and the @gems-arcadia/sdk ESM package with types.