A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
feat(crazygames): add score submissions and saved training credits
yhh8b65234e3eff
diff --git a/.github/workflows/build.yml b/.github/workflows/build.ymlindex c59469608..d3f25dbf0 100644--- a/.github/workflows/build.yml+++ b/.github/workflows/build.yml@@ -72,6 +72,8 @@ jobs:run: |node pipeline/bin/estella.mjs export examples/mobile-controls --profile crazygames --wasm build/wasm/web --out output/crazygames-training-ci-export --json output/crazygames-training-ci-export.jsonnode tools/tests/crazygames-training.e2e.mjs --dir output/crazygames-training-ci-export --out output/crazygames-training-ci-check+ node tools/tests/export-crazygames-score-fixture.mjs --wasm build/wasm/web --out output/crazygames-training-ci-score-export+ node tools/tests/crazygames-training.e2e.mjs --dir output/crazygames-training-ci-score-export --expect-scores --out output/crazygames-training-ci-score-check- name: Upload hash-bound local observations and screenshotsif: always()uses: actions/upload-artifact@v7diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 8c6338a55..31972ebaa 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -16,6 +16,8 @@ published separately; it ships inside the editor.### Added+- **CrazyGames scores and saved training credits follow platform contracts.** Optional Scores submission encrypts finite scores in the official HTML5 format; the editor exposes the client encryption key only for CrazyGames. The example saves earned credits through SDK Data, restores them on reload and preserves unreadable or externally changed progress. A sent score does not certify leaderboard acceptance, and SDK saving does not certify cloud backup.+- **CrazyGames Web exports connect the official v3 SDK.** Channel profiles initialize loading notifications, rewarded and midgame ads, SDK Data storage and host audio mute. Failed initialization disables host services without blocking training; save errors remain explicit, and engine storage clearing preserves other publisher data. Unused achievement services defer their storage read so unavailable saving does not block startup. The editor offers channel selection and the Mobile Controls profile reports authored gameplay transitions. Leaderboards and official platform/device acceptance remain pending.### Changed@@ -24,6 +26,8 @@ published separately; it ships inside the editor.### Fixed+- **AudioPlugin checks platform initialization before subscribing to host mute.** Independent audio backend tests and direct construction no longer fail while reading an optional platform capability.+- **Text measurement avoids GPU glyph pages.** Input caret measurements and inline rich-text layout retain the same rasterized glyph advances, bearings and dimensions in CPU caches without packing or uploading textures. Ordinary text drawing keeps its existing atlas; measurement-only atlases reject draw submission instead of emitting invalid texture references.- **Inline rich text releases its own measurement atlas.** Cleanup belongs to each App, so closing an older preview cannot remove a newer preview's inline image children. Exiting releases measurement glyph pages and repeated cleanup remains safe.diff --git a/desktop b/desktopindex f90131c03..f0a73ef84 160000--- a/desktop+++ b/desktop@@ -1 +1 @@-Subproject commit f90131c03dbb90d3b8eb2275ffdce9712b07d179+Subproject commit f0a73ef84e5db145a03e607d84fbbda742851793diff --git a/docs/astro/src/data/apiStability.generated.json b/docs/astro/src/data/apiStability.generated.jsonindex d01b47adb..783c83a59 100644--- a/docs/astro/src/data/apiStability.generated.json+++ b/docs/astro/src/data/apiStability.generated.json@@ -3,10 +3,10 @@"counts": {"public": 115,"beta": 103,- "experimental": 2196,+ "experimental": 2197,"deprecated": 3},- "total": 2414,+ "total": 2415,"subsystems": [{"id": "mobile-controls",diff --git a/examples/mobile-controls/README.md b/examples/mobile-controls/README.mdindex 8ade6b57d..998bf239a 100644--- a/examples/mobile-controls/README.md+++ b/examples/mobile-controls/README.md@@ -90,8 +90,10 @@ Export with `node pipeline/bin/estella.mjs export examples/mobile-controls--profile crazygames --out output/crazygames-training-web`. This profile usesthe same authored room and START / PAUSE / REPLAY / WATCH AD controls. Gameplayevents go to `CrazyGames.SDK.game`; focus changes do not emit gameplay events,-because the SDK handles focus itself. Credits in this training example remain-session-only.+because the SDK handles focus itself. Reward credits load and save through+the engine's `Storage` API on this channel. A page reload restores saved credits.+Unreadable, disabled or externally changed saves are preserved; failed saving+is displayed as session-only progress. Poki credits remain session-only.The export host awaits the official v3 SDK, reports loading, and connects theexisting Ads service to rewarded and midgame callbacks. Only `adFinished`@@ -107,9 +109,23 @@ envelope, and `Storage.clear()` preserves other publisher data. The SDK'soverall 1 MB limit still applies. A synchronous save is not acknowledgment ofcloud backup or proof of cross-account restoration.-Leaderboard integration, official platform QA and physical-device acceptance-remain separate work. This profile does not claim those checks are complete.+For an invited leaderboard, configure the 32-byte Base64 client Encryption Key+under Web packaging in the editor (`packaging.platforms.web.leaderboardEncryptionKey`).+The key is shipped in the client; never enter the server API Key. After three+hits, SEND SCORE submits the round's three points through `Scores.submit`.+Without a configured key or SDK score capability, the button is disabled.+The platform leaderboard must use matching score rules. The engine encrypts+the numeric score using the official HTML5 AES-GCM format and sends both values.+A successful call means sent, not that the server accepted a ranking.++The headless score fixture copies this source into a temporary directory and+uses a known mock-only key. It is not a platform credential and must not be+used for a production submission. Ordinary example profiles carry no key.+Official platform QA, leaderboard invitation/configuration, cross-account+cloud restoration and physical-device acceptance remain separate checks.See the official [SDK introduction](https://docs.crazygames.com/sdk/intro/),[game lifecycle](https://docs.crazygames.com/sdk/game/),[video ads](https://docs.crazygames.com/sdk/video-ads/) and[Data module](https://docs.crazygames.com/sdk/data/).+For scores, see [leaderboard requirements](https://docs.crazygames.com/sdk/leaderboards/)+and [client score submission](https://docs.crazygames.com/sdk/leaderboards-client/).diff --git a/examples/mobile-controls/src/main.ts b/examples/mobile-controls/src/main.tsindex af1a2a094..bda4a1054 100644--- a/examples/mobile-controls/src/main.ts+++ b/examples/mobile-controls/src/main.ts@@ -25,7 +25,7 @@ const refreshStatus = (world: World): void => {if (status === null || !world.valid(status)) return;const caps = Device.capabilities();const content = trainer- ? `${trainer.phase.toUpperCase()} / ${trainer.message}\nRound: ${trainer.hits} / 3 hits / Credits: ${trainer.credits} / Motion: ${motion ? motionData : 'off'} / ${message}`+ ? `${trainer.phase.toUpperCase()} / ${trainer.message}\nRound: ${trainer.hits} / 3 hits / Credits: ${trainer.credits} / ${trainer.saveMessage || `Motion: ${motion ? motionData : 'off'} / ${message}`}`: `${message}\nHits: ${hits} / Sensor data: ${motion ? motionData : 'off'} / Vibration API: ${caps.vibration ? 'available' : 'unavailable'}`;if (world.get(status, Text).content !== content) world.insert(status, Text, { ...world.get(status, Text), content });};diff --git a/examples/mobile-controls/src/pokiTraining.ts b/examples/mobile-controls/src/pokiTraining.tsindex 7def23db4..0e8ed589f 100644--- a/examples/mobile-controls/src/pokiTraining.ts+++ b/examples/mobile-controls/src/pokiTraining.ts@@ -12,11 +12,13 @@ export interface TrainingHooks {gameplayStop(): void;reset(): void;changed(): void;+ rewardGranted?(credits: number): void;}export class TrainingSession {phase: TrainingPhase = 'menu';credits = 0;hits = 0;+ saveMessage = '';message = 'Press START to begin a three-hit training round.';private hidden = false;private disposed = false;@@ -61,7 +63,7 @@ export class TrainingSession {try {const result = await this.ads.showRewarded(this.adUnit);if (this.disposed) return;- if (result.completed) { this.credits++; this.message = 'Reward earned: +1 training credit.'; }+ if (result.completed) { this.credits++; this.message = 'Reward earned: +1 training credit.'; this.hooks.rewardGranted?.(this.credits); }else this.message = 'Video not completed. No reward granted.';} catch {if (this.disposed) return;diff --git a/examples/mobile-controls/src/pokiTrainingUI.ts b/examples/mobile-controls/src/pokiTrainingUI.tsindex b6eaf8751..0a5ee8322 100644--- a/examples/mobile-controls/src/pokiTrainingUI.ts+++ b/examples/mobile-controls/src/pokiTrainingUI.ts@@ -1,7 +1,8 @@// SPDX-License-Identifier: Apache-2.0// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team-import { createButton, spawnUIEntity, Text, Name, UIPositionType, px, type AdsAPI } from 'esengine';+import { createButton, spawnUIEntity, Text, Name, UIPositionType, px, Storage, Scores, type AdsAPI } from 'esengine';import { TrainingSession } from './pokiTraining';+import { TrainingSave } from './trainingSave';type ButtonOptions = Parameters<typeof createButton>[0];interface PokiGameplay { gameplayStart(): void; gameplayStop(): void }@@ -13,6 +14,8 @@ export function setupWebTraining(if (typeof document === 'undefined') return null;const channel = document.documentElement?.dataset?.webChannel;if (channel !== 'poki' && channel !== 'crazygames') return null;+ const save = channel === 'crazygames' ? new TrainingSave(Storage) : null;+ let submittingScore = false;const notify = (event: keyof PokiGameplay): void => {if (channel === 'crazygames' && document.documentElement.dataset.webSdkReady !== 'true') return;const hosts = globalThis as unknown as { PokiSDK?: PokiGameplay; CrazyGames?: { SDK?: { game?: PokiGameplay } } };@@ -22,26 +25,37 @@ export function setupWebTraining(};const controls: Array<{ button: ReturnType<typeof createButton>; label: ReturnType<typeof spawnUIEntity> }> = [];const update = (): void => {- if (controls.length !== 3 || !world.valid(parent) || world.isDestructionPending(parent)) return;+ if (controls.length !== (channel === 'crazygames' ? 4 : 3) || !world.valid(parent) || world.isDestructionPending(parent)) return;const phase = session.phase;- const labels = [phase === 'menu' ? 'START' : phase === 'finished' ? 'REPLAY' : 'RESUME', 'PAUSE', ads.available ? 'WATCH AD +1' : 'ADS UNAVAILABLE'];+ const labels = [phase === 'menu' ? 'START' : phase === 'finished' ? 'REPLAY' : 'RESUME', 'PAUSE', ads.available ? (channel === 'crazygames' ? 'AD +1' : 'WATCH AD +1') : (channel === 'crazygames' ? 'NO ADS' : 'ADS UNAVAILABLE'), Scores.available ? 'SEND SCORE' : 'NO SCORES'];controls.forEach(({ button, label }, index) => {- button.setDisabled(index === 0 ? phase === 'playing' || phase === 'ad'- : index === 1 ? phase !== 'playing' : !ads.available || phase === 'ad');+ button.setDisabled(submittingScore || (index === 0 ? phase === 'playing' || phase === 'ad'+ : index === 1 ? phase !== 'playing' : index === 2 ? !ads.available || phase === 'ad' : !Scores.available || phase !== 'finished'));world.insert(label, Text, { ...world.get(label, Text), content: labels[index] });});refresh();};const session = new TrainingSession(ads, {gameplayStart: () => notify('gameplayStart'), gameplayStop: () => notify('gameplayStop'), reset, changed: update,+ rewardGranted: credits => { save?.save(credits); if (save) session.saveMessage = save.message; },}, channel);+ if (save) { session.credits = save.load(); session.saveMessage = save.message; }const actions = [() => { void session.begin(); }, () => session.pause(), () => { void session.reward(); }];- for (let index = 0; index < 3; index++) {+ if (channel === 'crazygames') actions.push(() => {+ if (submittingScore || session.phase !== 'finished' || !Scores.available) return;+ submittingScore = true; session.message = 'Sending round score...'; update();+ void Scores.submit(session.hits).then(() => {+ session.message = 'Score sent. Platform ranking validation is pending.';+ }, () => { session.message = 'Score submission failed. You can retry.'; }).finally(() => {+ submittingScore = false; update();+ });+ });+ for (let index = 0; index < actions.length; index++) {const button = createButton({ world, events, parent, userGesture: true,- node: { position: UIPositionType.Absolute, insetLeft: px(232 + index * 118), insetTop: px(346), width: px(112), height: px(36) },+ node: { position: UIPositionType.Absolute, insetLeft: px(channel === 'crazygames' ? 220 + index * 92 : 232 + index * 118), insetTop: px(346), width: px(channel === 'crazygames' ? 88 : 112), height: px(36) },onClick: actions[index],});- world.insert(button.entity, Name, { value: ['TrainingStart', 'TrainingPause', 'TrainingReward'][index] });+ world.insert(button.entity, Name, { value: ['TrainingStart', 'TrainingPause', 'TrainingReward', 'TrainingScore'][index] });const label = spawnUIEntity({ world, parent: button.entity, node: { fill: true }, text: { content: '', fontSize: 13 } });controls.push({ button, label });}diff --git a/examples/mobile-controls/src/trainingSave.ts b/examples/mobile-controls/src/trainingSave.tsnew file mode 100644index 000000000..a6e1138ce--- /dev/null+++ b/examples/mobile-controls/src/trainingSave.ts@@ -0,0 +1,42 @@+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+export interface CreditStorage { getString(key: string): string | undefined; setString(key: string, value: string): void }+const KEY = 'mobile-controls.training-credits.v1';++/** Demonstrates SDK saving while preserving unreadable or externally changed progress. */+export class TrainingSave {+ message = '';+ private snapshot: string | undefined;+ private loaded = false;+ constructor(private readonly storage: CreditStorage) {}+ load(): number {+ try {+ const raw = this.storage.getString(KEY);+ const value: unknown = raw === undefined ? { version: 1, credits: 0 } : JSON.parse(raw);+ if (!value || typeof value !== 'object' || !('version' in value) || value.version !== 1+ || !('credits' in value) || !Number.isSafeInteger(value.credits) || (value.credits as number) < 0) {+ throw new Error('invalid saved credits');+ }+ this.snapshot = raw; this.loaded = true;+ this.message = 'SDK save ready';+ return value.credits as number;+ } catch {+ this.loaded = false; this.message = 'Save unavailable; progress kept in this session';+ return 0;+ }+ }+ save(credits: number): void {+ if (!this.loaded) return;+ try {+ if (!Number.isSafeInteger(credits) || credits < 0) throw new Error('invalid credits');+ if (this.storage.getString(KEY) !== this.snapshot) {+ this.loaded = false;+ this.message = 'Saved progress changed; reload before saving';+ return;+ }+ const raw = JSON.stringify({ version: 1, credits });+ this.storage.setString(KEY, raw); this.snapshot = raw;+ this.message = 'Saved to SDK; cloud backup pending';+ } catch { this.message = 'Save failed; progress kept in this session'; }+ }+}diff --git a/pipeline/src/export/exportGame.ts b/pipeline/src/export/exportGame.tsindex 4dca72884..d6802744f 100644--- a/pipeline/src/export/exportGame.ts+++ b/pipeline/src/export/exportGame.ts@@ -478,6 +478,7 @@ export interface ExportGameOptions {scriptsEntry?: string;/** Browser distribution channel; standalone leaves the original Web policy intact. */webChannel?: 'poki' | 'crazygames';+ leaderboardEncryptionKey?: string;sdkDistDir: string;/** The engine runtime to copy. */wasmDir: string;@@ -1178,6 +1179,8 @@ async function produceExport(opts: ExportGameOptions): Promise<ExportGameResult>const gameConfig: PackagedGameConfig = {entryScene: opts.entryScene, scenes,...(platform === 'web' && opts.webChannel ? { webChannel: opts.webChannel } : {}),+ ...(platform === 'web' && opts.webChannel === 'crazygames' && opts.leaderboardEncryptionKey+ ? { leaderboardEncryptionKey: opts.leaderboardEncryptionKey } : {}),...(scriptsFile ? { scripts: scriptsFile } : {}),...packagedRuntimeFields(runtime),...(hotUpdate ? { hotUpdate } : {}),diff --git a/pipeline/src/export/projectExportOptions.ts b/pipeline/src/export/projectExportOptions.tsindex 0b38b4e7c..a2d45a9bf 100644--- a/pipeline/src/export/projectExportOptions.ts+++ b/pipeline/src/export/projectExportOptions.ts@@ -107,6 +107,8 @@ export async function projectExportOptions(? { androidKey: () => androidReleaseKey(root, plat.android!.releaseKey!, secrets.androidKeyPassphrase) }: {}),...(platform === 'web' && (plat?.web?.channel === 'poki' || plat?.web?.channel === 'crazygames') ? { webChannel: plat.web.channel } : {}),+ ...(platform === 'web' && plat?.web?.channel === 'crazygames' && plat.web.leaderboardEncryptionKey+ ? { leaderboardEncryptionKey: plat.web.leaderboardEncryptionKey } : {}),desktopProductName: plat?.desktop?.productName,desktopChannel: plat?.desktop?.channel,steam: plat?.desktop?.steam,diff --git a/pipeline/src/project/format.ts b/pipeline/src/project/format.tsindex 7a4dccf2b..3b1a7e6b7 100644--- a/pipeline/src/project/format.ts+++ b/pipeline/src/project/format.ts@@ -409,7 +409,7 @@ export interface ProjectPackaging {/** Per-platform packaging config: each target's slice of the app identity, plus* whatever only it has (a WeChat appid, an Android versionCode). */platforms?: {- web?: { channel?: 'standalone' | 'poki' | 'crazygames' };+ web?: { channel?: 'standalone' | 'poki' | 'crazygames'; leaderboardEncryptionKey?: string };wechat?: WeChatPackaging;douyin?: MiniGamePackaging;bilibili?: MiniGamePackaging;@@ -914,7 +914,15 @@ export function parseManifest(raw: unknown): ProjectManifest {if (web.channel !== undefined && web.channel !== 'standalone' && web.channel !== 'poki' && web.channel !== 'crazygames') {throw new Error('packaging.platforms.web.channel must be standalone, poki or crazygames');}- if (web.channel) platforms.web = { channel: web.channel as 'standalone' | 'poki' | 'crazygames' };+ const config: NonNullable<NonNullable<ProjectPackaging['platforms']>['web']> = {};+ if (web.channel) config.channel = web.channel as 'standalone' | 'poki' | 'crazygames';+ if (web.leaderboardEncryptionKey !== undefined && web.leaderboardEncryptionKey !== '') {+ if (typeof web.leaderboardEncryptionKey !== 'string' || !/^[A-Za-z0-9+/]{42}[AEIMQUYcgkosw048]=$/.test(web.leaderboardEncryptionKey)) {+ throw new Error('packaging.platforms.web.leaderboardEncryptionKey must be a base64-encoded 32-byte client encryption key');+ }+ config.leaderboardEncryptionKey = web.leaderboardEncryptionKey;+ }+ if (Object.keys(config).length) platforms.web = config;}const wx = pl.wechat as Record<string, unknown> | undefined;if (wx && typeof wx === 'object') {diff --git a/pipeline/src/runtime/crazyGamesProfile.ts b/pipeline/src/runtime/crazyGamesProfile.tsindex 8fda6588d..aa0d6c78f 100644--- a/pipeline/src/runtime/crazyGamesProfile.ts+++ b/pipeline/src/runtime/crazyGamesProfile.ts@@ -9,6 +9,7 @@ export interface CrazyGamesData {}export interface CrazyGamesSdk {init(): Promise<void>;+ user?: { submitScore(payload: { score: number; encryptedScore: string }): void | Promise<void> };ad: { requestAd(type: 'rewarded' | 'midgame', callbacks: {adStarted(): void; adFinished(): void; adError(error: unknown): void;}): void };@@ -51,6 +52,19 @@ export function crazyGamesAdProvider(sdk: CrazyGamesSdk): AdProvider {}export const CRAZYGAMES_STORAGE_KEY = 'estella.storage.v1';++/** Official HTML5 wire format: random 12-byte IV followed by AES-GCM ciphertext/tag. */+export async function encryptCrazyGamesScore(score: number, encryptionKey: string, crypto: Crypto = globalThis.crypto): Promise<string> {+ if (!Number.isFinite(score)) throw new Error('Score must be finite');+ if (!/^[A-Za-z0-9+/]{42}[AEIMQUYcgkosw048]=$/.test(encryptionKey)) throw new Error('CrazyGames score encryption key must encode 32 bytes');+ const bytes = Uint8Array.from(atob(encryptionKey), char => char.charCodeAt(0));+ const iv = crypto.getRandomValues(new Uint8Array(12));+ const key = await crypto.subtle.importKey('raw', bytes, { name: 'AES-GCM' }, false, ['encrypt']);+ const encrypted = await crypto.subtle.encrypt({ name: 'AES-GCM', iv }, key, new TextEncoder().encode(String(score)));+ const combined = new Uint8Array(iv.length + encrypted.byteLength);+ combined.set(iv); combined.set(new Uint8Array(encrypted), iv.length);+ return btoa(String.fromCharCode(...combined));+}type StorageAdapter = Pick<PlatformAdapter, 'getStorageItem' | 'setStorageItem' | 'removeStorageItem' | 'clearStorage'>;/** One engine-owned envelope supports prefix clearing without deleting other SDK data. */@@ -88,7 +102,7 @@ export function crazyGamesStorage(data: CrazyGamesData | undefined): StorageAdap}export async function initializeCrazyGames(- sdk: CrazyGamesSdk | undefined, warn: (message: string, error?: unknown) => void, timeoutMs = 10000,+ sdk: CrazyGamesSdk | undefined, warn: (message: string, error?: unknown) => void, timeoutMs = 10000, scoreKey?: string,) {let initialized = false;let timer: ReturnType<typeof setTimeout> | undefined;@@ -107,6 +121,11 @@ export async function initializeCrazyGames(return {provider: initialized && sdk ? crazyGamesAdProvider(sdk) : null,storage: crazyGamesStorage(initialized ? sdk?.data : undefined),+ submitScore: initialized && sdk?.user?.submitScore && scoreKey && globalThis.crypto?.subtle+ ? async (score: number): Promise<void> => {+ const encryptedScore = await encryptCrazyGamesScore(score, scoreKey);+ await sdk.user!.submitScore({ score, encryptedScore });+ } : undefined,onAudioMute(callback: (muted: boolean) => void): () => void {if (!initialized || !sdk) { callback(false); return () => {}; }let active = true;diff --git a/pipeline/src/runtime/gameHost.ts b/pipeline/src/runtime/gameHost.tsindex 39f3b92f5..0fe630f3f 100644--- a/pipeline/src/runtime/gameHost.ts+++ b/pipeline/src/runtime/gameHost.ts@@ -112,10 +112,10 @@ async function boot(): Promise<void> {? await initializePoki((window as unknown as { PokiSDK?: PokiSdk }).PokiSDK, (message, error) => console.warn(message, error)): null;const crazyGames = cfg.webChannel === 'crazygames'- ? await initializeCrazyGames((window as unknown as { CrazyGames?: { SDK: CrazyGamesSdk } }).CrazyGames?.SDK, (message, error) => console.warn(message, error))+ ? await initializeCrazyGames((window as unknown as { CrazyGames?: { SDK: CrazyGamesSdk } }).CrazyGames?.SDK, (message, error) => console.warn(message, error), 10000, cfg.leaderboardEncryptionKey): null;if (crazyGames) {- extendPlatform({ ...crazyGames.storage, onAudioMute: crazyGames.onAudioMute });+ extendPlatform({ ...crazyGames.storage, onAudioMute: crazyGames.onAudioMute, submitScore: crazyGames.submitScore });document.documentElement.dataset.webSdkReady = String(crazyGames.provider !== null);}// Before the engine boots, so a boot that fails is still heard by the editor.diff --git a/pipeline/tests/crazygames-profile.test.ts b/pipeline/tests/crazygames-profile.test.tsindex 7f433aa72..c1f3d6c2d 100644--- a/pipeline/tests/crazygames-profile.test.ts+++ b/pipeline/tests/crazygames-profile.test.ts@@ -1,7 +1,8 @@// SPDX-License-Identifier: Apache-2.0// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Teamimport { describe, it, expect, vi } from 'vitest';-import { crazyGamesAdProvider, crazyGamesStorage, initializeCrazyGames, CRAZYGAMES_STORAGE_KEY, type CrazyGamesSdk } from '../src/runtime/crazyGamesProfile';+import { crazyGamesAdProvider, crazyGamesStorage, initializeCrazyGames, encryptCrazyGamesScore, CRAZYGAMES_STORAGE_KEY, type CrazyGamesSdk } from '../src/runtime/crazyGamesProfile';+import { webcrypto } from 'node:crypto';import { parseManifest } from '../src/project/format';import { projectExportOptions } from '../src/export/projectExportOptions';@@ -20,6 +21,44 @@ function fixture() {}describe('CrazyGames channel adapter', () => {+ it('preserves a client score key only on CrazyGames Web exports', async () => {+ const key = Buffer.alloc(32, 7).toString('base64');+ const manifest = parseManifest({ name: 'Game', packaging: { platforms: { web: { channel: 'crazygames', leaderboardEncryptionKey: key } } } });+ expect((await projectExportOptions(process.cwd(), manifest, 'web')).leaderboardEncryptionKey).toBe(key);+ expect((await projectExportOptions(process.cwd(), manifest, 'wechat')).leaderboardEncryptionKey).toBeUndefined();+ manifest.packaging!.platforms!.web!.channel = 'poki';+ expect((await projectExportOptions(process.cwd(), manifest, 'web')).leaderboardEncryptionKey).toBeUndefined();+ for (const invalid of ['broken', Buffer.alloc(16).toString('base64'), 42]) {+ expect(() => parseManifest({ name: 'Game', packaging: { platforms: { web: { leaderboardEncryptionKey: invalid } } } })).toThrow('32-byte');+ }+ });+ it('uses random IVs and the documented decryptable AES-GCM score payload', async () => {+ const keyBytes = new Uint8Array(32).fill(7), key = Buffer.from(keyBytes).toString('base64');+ const crypto = webcrypto as unknown as Crypto;+ const first = await encryptCrazyGamesScore(152.1, key, crypto);+ const second = await encryptCrazyGamesScore(152.1, key, crypto);+ expect(first).not.toBe(second);+ const payload = Uint8Array.from(Buffer.from(first, 'base64'));+ const imported = await crypto.subtle.importKey('raw', keyBytes, { name: 'AES-GCM' }, false, ['decrypt']);+ const plain = await crypto.subtle.decrypt({ name: 'AES-GCM', iv: payload.slice(0, 12) }, imported, payload.slice(12));+ expect(new TextDecoder().decode(plain)).toBe('152.1');+ await expect(encryptCrazyGamesScore(NaN, key, crypto)).rejects.toThrow('finite');+ await expect(encryptCrazyGamesScore(10, 'invalid', crypto)).rejects.toThrow('32 bytes');+ });+ it('enables score submission only after initialization with a configured SDK user method', async () => {+ const { sdk } = fixture(), key = Buffer.alloc(32, 7).toString('base64');+ sdk.user = { submitScore: vi.fn(async () => {}) };+ const session = await initializeCrazyGames(sdk, vi.fn(), 10000, key);+ await session.submitScore!(42);+ expect(sdk.user.submitScore).toHaveBeenCalledWith({ score: 42, encryptedScore: expect.any(String) });+ await expect(session.submitScore!(Infinity)).rejects.toThrow('finite');+ expect(sdk.user.submitScore).toHaveBeenCalledOnce();+ vi.mocked(sdk.user.submitScore).mockRejectedValueOnce(new Error('host rejected'));+ await expect(session.submitScore!(2)).rejects.toThrow('host rejected');+ expect((await initializeCrazyGames(sdk, vi.fn())).submitScore).toBeUndefined();+ sdk.init = vi.fn(async () => { throw new Error('init failed'); });+ expect((await initializeCrazyGames(sdk, vi.fn(), 10000, key)).submitScore).toBeUndefined();+ });it('preserves the named Web channel and rejects misspellings', async () => {const manifest = parseManifest({ name: 'Game', packaging: { profiles: { cg: { platform: 'web', platforms: { web: { channel: 'crazygames' } } } } } });expect((await projectExportOptions(process.cwd(), manifest, 'web', 'cg')).webChannel).toBe('crazygames');diff --git a/pipeline/tests/export-splash.test.ts b/pipeline/tests/export-splash.test.tsindex 6d25ffea1..2ba93b983 100644--- a/pipeline/tests/export-splash.test.ts+++ b/pipeline/tests/export-splash.test.ts@@ -50,7 +50,7 @@ beforeAll(() => {afterAll(() => rmSync(root, { recursive: true, force: true, maxRetries: 10, retryDelay: 50 }));/** Export for web and hand back the page plus whatever the build said about it. */-async function page(splash?: ProjectPackaging['splash'], webChannel?: 'poki' | 'crazygames'): Promise<{ html: string; warnings: string[]; splashBytes?: number }> {+async function page(splash?: ProjectPackaging['splash'], webChannel?: 'poki' | 'crazygames', leaderboardEncryptionKey?: string): Promise<{ html: string; config: Record<string, unknown>; warnings: string[]; splashBytes?: number }> {const outDir = path.join(root, `dist-${Math.random().toString(36).slice(2)}`);const res = await exportGame({root,@@ -60,12 +60,12 @@ async function page(splash?: ProjectPackaging['splash'], webChannel?: 'poki' | 'wasmDir: path.join(root, '_wasm'),outDir,title: 'My Game',- platform: 'web', webChannel,+ platform: 'web', webChannel, leaderboardEncryptionKey,runtime: runtimeConfigOf({ designResolution: { width: 800, height: 600 } }),splash,});expect(res.ok, res.errors.join('\n')).toBe(true);- return { html: readFileSync(path.join(outDir, 'index.html'), 'utf8'), warnings: res.warnings, splashBytes: res.size?.splashBytes };+ return { html: readFileSync(path.join(outDir, 'index.html'), 'utf8'), config: JSON.parse(readFileSync(path.join(outDir, 'game.config.json'), 'utf8')), warnings: res.warnings, splashBytes: res.size?.splashBytes };}describe('the exported page’s start screen', () => {@@ -130,6 +130,12 @@ describe('the exported page’s start screen', () => {describe('Poki host page', () => {+ it('packages the client leaderboard key only for CrazyGames', async () => {+ const key = Buffer.alloc(32, 7).toString('base64');+ expect((await page(undefined, 'crazygames', key)).config.leaderboardEncryptionKey).toBe(key);+ expect((await page(undefined, 'poki', key)).config.leaderboardEncryptionKey).toBeUndefined();+ expect((await page(undefined, undefined, key)).config.leaderboardEncryptionKey).toBeUndefined();+ });it('loads CrazyGames v3 before the game without injecting Poki', async () => {const { html } = await page(undefined, 'crazygames');const script = '<script src="https://sdk.crazygames.com/crazygames-sdk-v3.js"></script>';diff --git a/sdk/etc/index.api.md b/sdk/etc/index.api.mdindex cde5f8e21..5ea152cf1 100644--- a/sdk/etc/index.api.md+++ b/sdk/etc/index.api.md@@ -1,7 +1,7 @@# API surface — esengine/index<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 115 public · 91 beta · 1580 experimental · 3 deprecated+Symbols: 115 public · 91 beta · 1581 experimental · 3 deprecated## ABI_LAYOUT_HASH — const @experimental```@@ -5549,6 +5549,7 @@ depthLayers: number | undefinedengineBytes: number | undefinedentryScene: stringhotUpdate: { remoteRoot?: string; persistUpdateKey?: string; } | undefined+leaderboardEncryptionKey: string | undefinedmsaaSamples: number | undefinedoutputTransform: "none" | "aces" | undefinedphysicsConfig: Physics2DPluginConfig | undefined@@ -6017,6 +6018,7 @@ setWindowSize: ((width: number, height: number) => void) | undefinedshare: ((options: PlatformShareOptions) => void) | undefinedsteamAchievements: ((appId: number) => AchievementProvider | null) | undefinedsteamIdentity: (() => { id: string; name: string; } | null) | undefined+submitScore: ((score: number) => Promise<void>) | undefinedunbindInputEvents: (() => void) | undefinedwriteCacheFile: ((key: string, bytes: ArrayBuffer) => Promise<void>) | undefined```@@ -7591,6 +7593,11 @@ system: string'work' | 'wait'```+## Scores — const @experimental+```+{ readonly available: boolean; submit(score: number): Promise<void>; }+```+## ScreenAxis — interface @experimental```depth: numberdiff --git a/sdk/etc/index.native.api.md b/sdk/etc/index.native.api.mdindex 60c72fcba..c8456b0ae 100644--- a/sdk/etc/index.native.api.md+++ b/sdk/etc/index.native.api.md@@ -1,7 +1,7 @@# API surface — esengine/index.native<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 115 public · 96 beta · 1599 experimental · 3 deprecated+Symbols: 115 public · 96 beta · 1600 experimental · 3 deprecated## ABI_LAYOUT_HASH — const @experimental```@@ -5752,6 +5752,7 @@ depthLayers: number | undefinedengineBytes: number | undefinedentryScene: stringhotUpdate: { remoteRoot?: string; persistUpdateKey?: string; } | undefined+leaderboardEncryptionKey: string | undefinedmsaaSamples: number | undefinedoutputTransform: "none" | "aces" | undefinedphysicsConfig: Physics2DPluginConfig | undefined@@ -6220,6 +6221,7 @@ setWindowSize: ((width: number, height: number) => void) | undefinedshare: ((options: PlatformShareOptions) => void) | undefinedsteamAchievements: ((appId: number) => AchievementProvider | null) | undefinedsteamIdentity: (() => { id: string; name: string; } | null) | undefined+submitScore: ((score: number) => Promise<void>) | undefinedunbindInputEvents: (() => void) | undefinedwriteCacheFile: ((key: string, bytes: ArrayBuffer) => Promise<void>) | undefined```@@ -7804,6 +7806,11 @@ system: string'work' | 'wait'```+## Scores — const @experimental+```+{ readonly available: boolean; submit(score: number): Promise<void>; }+```+## ScreenAxis — interface @experimental```depth: numberdiff --git a/sdk/etc/index.node.api.md b/sdk/etc/index.node.api.mdindex 409a01c6a..ca795fef1 100644--- a/sdk/etc/index.node.api.md+++ b/sdk/etc/index.node.api.md@@ -1,7 +1,7 @@# API surface — esengine/index.node<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 115 public · 93 beta · 1579 experimental · 3 deprecated+Symbols: 115 public · 93 beta · 1580 experimental · 3 deprecated## ANCHOR_AXES — const @experimental```@@ -5544,6 +5544,7 @@ depthLayers: number | undefinedengineBytes: number | undefinedentryScene: stringhotUpdate: { remoteRoot?: string; persistUpdateKey?: string; } | undefined+leaderboardEncryptionKey: string | undefinedmsaaSamples: number | undefinedoutputTransform: "none" | "aces" | undefinedphysicsConfig: Physics2DPluginConfig | undefined@@ -6012,6 +6013,7 @@ setWindowSize: ((width: number, height: number) => void) | undefinedshare: ((options: PlatformShareOptions) => void) | undefinedsteamAchievements: ((appId: number) => AchievementProvider | null) | undefinedsteamIdentity: (() => { id: string; name: string; } | null) | undefined+submitScore: ((score: number) => Promise<void>) | undefinedunbindInputEvents: (() => void) | undefinedwriteCacheFile: ((key: string, bytes: ArrayBuffer) => Promise<void>) | undefined```@@ -7586,6 +7588,11 @@ system: string'work' | 'wait'```+## Scores — const @experimental+```+{ readonly available: boolean; submit(score: number): Promise<void>; }+```+## ScreenAxis — interface @experimental```depth: numberdiff --git a/sdk/etc/minigame.api.md b/sdk/etc/minigame.api.mdindex 4523cc99d..3f266ad47 100644--- a/sdk/etc/minigame.api.md+++ b/sdk/etc/minigame.api.md@@ -1,7 +1,7 @@# API surface — esengine/minigame<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 115 public · 91 beta · 1601 experimental · 3 deprecated+Symbols: 115 public · 91 beta · 1602 experimental · 3 deprecated## ANCHOR_AXES — const @experimental```@@ -5837,6 +5837,7 @@ depthLayers: number | undefinedengineBytes: number | undefinedentryScene: stringhotUpdate: { remoteRoot?: string; persistUpdateKey?: string; } | undefined+leaderboardEncryptionKey: string | undefinedmsaaSamples: number | undefinedoutputTransform: "none" | "aces" | undefinedphysicsConfig: Physics2DPluginConfig | undefined@@ -6305,6 +6306,7 @@ setWindowSize: ((width: number, height: number) => void) | undefinedshare: ((options: PlatformShareOptions) => void) | undefinedsteamAchievements: ((appId: number) => AchievementProvider | null) | undefinedsteamIdentity: (() => { id: string; name: string; } | null) | undefined+submitScore: ((score: number) => Promise<void>) | undefinedunbindInputEvents: (() => void) | undefinedwriteCacheFile: ((key: string, bytes: ArrayBuffer) => Promise<void>) | undefined```@@ -7879,6 +7881,11 @@ system: string'work' | 'wait'```+## Scores — const @experimental+```+{ readonly available: boolean; submit(score: number): Promise<void>; }+```+## ScreenAxis — interface @experimental```depth: numberdiff --git a/sdk/etc/wechat.api.md b/sdk/etc/wechat.api.mdindex 71a59987a..8627c5b3c 100644--- a/sdk/etc/wechat.api.md+++ b/sdk/etc/wechat.api.md@@ -1,7 +1,7 @@# API surface — esengine/wechat<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 115 public · 91 beta · 1592 experimental · 3 deprecated+Symbols: 115 public · 91 beta · 1593 experimental · 3 deprecated## ANCHOR_AXES — const @experimental```@@ -5551,6 +5551,7 @@ depthLayers: number | undefinedengineBytes: number | undefinedentryScene: stringhotUpdate: { remoteRoot?: string; persistUpdateKey?: string; } | undefined+leaderboardEncryptionKey: string | undefinedmsaaSamples: number | undefinedoutputTransform: "none" | "aces" | undefinedphysicsConfig: Physics2DPluginConfig | undefined@@ -6019,6 +6020,7 @@ setWindowSize: ((width: number, height: number) => void) | undefinedshare: ((options: PlatformShareOptions) => void) | undefinedsteamAchievements: ((appId: number) => AchievementProvider | null) | undefinedsteamIdentity: (() => { id: string; name: string; } | null) | undefined+submitScore: ((score: number) => Promise<void>) | undefinedunbindInputEvents: (() => void) | undefinedwriteCacheFile: ((key: string, bytes: ArrayBuffer) => Promise<void>) | undefined```@@ -7593,6 +7595,11 @@ system: string'work' | 'wait'```+## Scores — const @experimental+```+{ readonly available: boolean; submit(score: number): Promise<void>; }+```+## ScreenAxis — interface @experimental```depth: numberdiff --git a/sdk/src/audio/AudioPlugin.ts b/sdk/src/audio/AudioPlugin.tsindex b9bb441c7..abfdd0601 100644--- a/sdk/src/audio/AudioPlugin.ts+++ b/sdk/src/audio/AudioPlugin.ts@@ -7,7 +7,7 @@ import { Res, Time, type TimeData } from '../ecs/resource';import { Audio, AudioAPI, setAudioHostSuspended } from './Audio';import { AudioSource, AudioListener, type AudioSourceData, type AudioListenerData } from './AudioComponents';import { WorldTransform, type WorldTransformData } from '../ecs/component';-import { getPlatform, platformCreateAudioBackend, platformOnMemoryWarning } from '../platform/base';+import { getPlatform, isPlatformInitialized, platformCreateAudioBackend, platformOnMemoryWarning } from '../platform/base';import { q } from '../math/quat';import { calculateAttenuation, calculatePanning, spatialDistance, type SpatialAudioConfig, AttenuationModel } from './SpatialAudio';import type { AudioHandle } from './PlatformAudioBackend';@@ -79,7 +79,9 @@ export class AudioPlugin implements Plugin {const audio = new AudioAPI(backend, mixer);app.insertResource(Audio, audio);const muteOwner = {};- const offAudioMute = getPlatform().onAudioMute?.(muted => setAudioHostSuspended(audio, muteOwner, muted)) ?? (() => {});+ const offAudioMute = (isPlatformInitialized()+ ? getPlatform().onAudioMute?.(muted => setAudioHostSuspended(audio, muteOwner, muted))+ : undefined) ?? (() => {});// OS memory pressure → drop the decoded-buffer warm cache. Held// buffers keep playing; re-fetch cost returns only for evicted ones.diff --git a/sdk/src/core-runtime.ts b/sdk/src/core-runtime.tsindex 9ff0c83df..393a061f4 100644--- a/sdk/src/core-runtime.ts+++ b/sdk/src/core-runtime.ts@@ -274,6 +274,7 @@ export {} from './ecs/resource';export { Storage } from './util/storage';+export { Scores } from './services/scores';// =============================================================================// Inputdiff --git a/sdk/src/platform/types.ts b/sdk/src/platform/types.tsindex 4451e74a0..fd3b32d5b 100644--- a/sdk/src/platform/types.ts+++ b/sdk/src/platform/types.ts@@ -672,6 +672,9 @@ export interface PlatformAdapter {/** Host audio policy; game volume/resume controls cannot override it. */onAudioMute?(handler: (muted: boolean) => void): () => void;+ /** Send one score to the host. Completion does not certify ranking acceptance. */+ submitScore?(score: number): Promise<void>;+getStorageItem(key: string): string | null;setStorageItem(key: string, value: string): void;removeStorageItem(key: string): void;diff --git a/sdk/src/runtime/packagedRuntime.ts b/sdk/src/runtime/packagedRuntime.tsindex f9595ee05..8718a296e 100644--- a/sdk/src/runtime/packagedRuntime.ts+++ b/sdk/src/runtime/packagedRuntime.ts@@ -39,6 +39,8 @@ import type { AotManifest } from '../ecs/aot/AotSystems';export interface PackagedGameConfig {/** External Web distribution SDK selected by this export. */webChannel?: 'poki' | 'crazygames';+ /** Public client encryption key for invited CrazyGames leaderboards; never a server API key. */+ leaderboardEncryptionKey?: string;/** Project-relative path of the scene the game boots into. */entryScene: string;/** Every switchable scene (SceneManager name + cooked path); includes the entry. */diff --git a/sdk/src/services/scores.ts b/sdk/src/services/scores.tsnew file mode 100644index 000000000..a7b330760--- /dev/null+++ b/sdk/src/services/scores.ts@@ -0,0 +1,17 @@+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+import { getPlatform, isPlatformInitialized } from '../platform/base';++/** Optional host score submission, independent of friends/open-data boards. */+export const Scores = {+ get available(): boolean {+ return isPlatformInitialized() && getPlatform().submitScore !== undefined;+ },+ /** A resolved submission means sent; host validation may still reject the score. */+ async submit(score: number): Promise<void> {+ if (!Number.isFinite(score)) throw new Error('Score must be finite');+ const platform = getPlatform();+ if (!platform.submitScore) throw new Error('Score submission unavailable on this host');+ await platform.submitScore(score);+ },+};diff --git a/sdk/tests/audio-plugin-lifecycle.test.ts b/sdk/tests/audio-plugin-lifecycle.test.tsindex cdf5880ef..161313a18 100644--- a/sdk/tests/audio-plugin-lifecycle.test.ts+++ b/sdk/tests/audio-plugin-lifecycle.test.ts@@ -7,6 +7,7 @@ const muteListeners = new Set<(muted: boolean) => void>();let hostMuted = false;vi.mock('../src/platform/base', async original => ({...await original<typeof import('../src/platform/base')>(),+ isPlatformInitialized: () => true,getPlatform: () => ({ onAudioMute: (callback: (muted: boolean) => void) => {muteListeners.add(callback); callback(hostMuted);return () => muteListeners.delete(callback);diff --git a/sdk/tests/scores.test.ts b/sdk/tests/scores.test.tsnew file mode 100644index 000000000..224ebadc0--- /dev/null+++ b/sdk/tests/scores.test.ts@@ -0,0 +1,21 @@+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+import { afterEach, expect, it, vi } from 'vitest';+import { Scores } from '../src/services/scores';+const host = vi.hoisted(() => ({ initialized: true, submitScore: undefined as undefined | ((score: number) => Promise<void>) }));+vi.mock('../src/platform/base', () => ({ getPlatform: () => host, isPlatformInitialized: () => host.initialized }));+afterEach(() => { host.initialized=true; host.submitScore=undefined; });+it('reports absent capability and rejects submission instead of pretending success', async () => {+ expect(Scores.available).toBe(false);+ await expect(Scores.submit(12)).rejects.toThrow('unavailable');+ host.initialized=false; expect(Scores.available).toBe(false);+});+it('forwards finite scores with the host receiver and preserves host failures', async () => {+ const submitted=vi.fn(async function(this: unknown, _score: number) { expect(this).toBe(host); });+ host.submitScore=submitted; expect(Scores.available).toBe(true);+ await Scores.submit(12.5);expect(submitted).toHaveBeenCalledWith(12.5);+ for(const value of [NaN,Infinity,-Infinity]) await expect(Scores.submit(value)).rejects.toThrow('finite');+ expect(submitted).toHaveBeenCalledOnce();+ submitted.mockRejectedValueOnce(new Error('host failure'));+ await expect(Scores.submit(4)).rejects.toThrow('host failure');+});diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjsindex 518b74ce7..a04b7200c 100644--- a/tools/releaseNotes.mjs+++ b/tools/releaseNotes.mjs@@ -28,6 +28,10 @@ export const NOTES_FLOOR = 'v0.65.0';* the reader recognises anyway.*/export const NOTED = {+ 'feat(crazygames): add score submissions and saved training credits':+ { note: 'CrazyGames scores and saved training credits follow platform contracts.' },+ 'feat(settings): configure CrazyGames client score encryption key':+ { note: 'CrazyGames scores and saved training credits follow platform contracts.' },'perf(ui): keep text measurement atlases off GPU':{ note: 'Text measurement avoids GPU glyph pages.' },'feat(crazygames): connect Web ads storage and host audio policy':diff --git a/tools/tests/crazygames-training.e2e.mjs b/tools/tests/crazygames-training.e2e.mjsindex 16a033fce..ee05e06ac 100644--- a/tools/tests/crazygames-training.e2e.mjs+++ b/tools/tests/crazygames-training.e2e.mjs@@ -21,6 +21,10 @@ const files=(under='')=>fs.readdirSync(path.join(root,under),{withFileTypes:truereturn [file];});const identities=Object.fromEntries(files().map(file=>[file,sha(path.join(root,file))]));+const config=JSON.parse(fs.readFileSync(path.join(root,'game.config.json'),'utf8'));+const expectsScores=args.includes('--expect-scores');+assert.equal(Boolean(config.leaderboardEncryptionKey),expectsScores,'Export must match the score test mode');+if(expectsScores)assert.equal(config.leaderboardEncryptionKey,Buffer.alloc(32,7).toString('base64'),'Use the mock fixture client key');const mime={'.html':'text/html','.js':'text/javascript','.mjs':'text/javascript','.json':'application/json','.wasm':'application/wasm','.png':'image/png'};const server=http.createServer((req,res)=>{try {@@ -36,7 +40,7 @@ const browser=await chromium.launch({headless:true,args:['--enable-unsafe-swiftsconst report={mode:'local-mock',headless:true,status:'failed',identities,verifierSha256:sha(new URL(import.meta.url)),cases:[],pending:['Official CrazyGames QA','Production ad fill','Cross-account cloud restoration','Physical-device and audible quality acceptance','Leaderboards']};try {- for (const mode of ['normal','init-failed','sdk-missing','save-disabled']) {+ for (const mode of ['normal','init-failed','sdk-missing','save-disabled','save-corrupt']) {const context=await browser.newContext({viewport:{width:800,height:450}}), page=await context.newPage();const observation={mode,status:'failed',errors:[],unexpectedRequests:[]};report.cases.push(observation);page.on('pageerror',error=>observation.errors.push(String(error)));@@ -48,7 +52,9 @@ try {const url=route.request().url();if (url.startsWith(origin+'/')) return route.continue();if (url==='https://sdk.crazygames.com/crazygames-sdk-v3.js') return route.fulfill({contentType:'text/javascript',body:mode==='sdk-missing' ? '' : `- window.__events=[];window.__settingsListeners=new Set();window.__data=new Map();+ window.__events=[];window.__settingsListeners=new Set();window.__scores=[];+ window.__data=new Map(JSON.parse(localStorage.getItem('__crazygames_mock_data') ?? '[]'));+ ${mode==='save-corrupt' ? `__data.set('estella.storage.v1',JSON.stringify({'esengine:mobile-controls.training-credits.v1':'broken'}));` : ''}const record=event=>__events.push(event);window.CrazyGames={SDK:{init(){record('init');return ${mode==='init-failed' ? 'Promise.reject(new Error("blocked"))' : 'Promise.resolve()'}},@@ -56,8 +62,9 @@ try {gameplayStart(){record('start')},gameplayStop(){record('stop')},addSettingsChangeListener(cb){__settingsListeners.add(cb)},removeSettingsChangeListener(cb){__settingsListeners.delete(cb)}},ad:{requestAd(type,cb){record(type);window.__ad=cb;cb.adStarted()}},+ user:{submitScore(payload){record('score');__scores.push(payload)}},data:{getItem(key){${mode==='save-disabled' ? 'throw new Error("Progress Save disabled");' : 'return __data.get(key) ?? null;'}},- setItem(key,value){__data.set(key,value)},removeItem(key){__data.delete(key)}}+ setItem(key,value){__data.set(key,value);localStorage.setItem('__crazygames_mock_data',JSON.stringify([...__data]))},removeItem(key){__data.delete(key)}}}};window.__mute=value=>{CrazyGames.SDK.game.settings.muteAudio=value;for(const cb of __settingsListeners)cb({muteAudio:value})};`});@@ -71,8 +78,9 @@ try {const box=await page.evaluate(n=>__estellaCooked.probe([n]).at[n],name);assert(box,`Missing ${name}`);await page.mouse.click(400+box.x,225-box.y);};- const phase=value=>page.waitForFunction(v=>__estellaCooked.probe(['DeviceStatus']).at.DeviceStatus.text.startsWith(v),value.toUpperCase());- const active=mode==='normal'||mode==='save-disabled';+ const phase=value=>page.waitForFunction(v=>window.__estellaCooked?.probe(['DeviceStatus']).at.DeviceStatus?.text?.startsWith(v),value.toUpperCase());+ const active=mode==='normal'||mode==='save-disabled'||mode==='save-corrupt';+ assert.equal(await page.evaluate(async()=>(await import('esengine')).Scores.available),active && expectsScores);assert.deepEqual(await page.evaluate(()=>window.__events ?? []),mode==='sdk-missing' ? [] : active ? ['init','loading','loaded'] : ['init']);await click('TrainingStart');await phase('playing');if (active) {@@ -94,6 +102,36 @@ try {assert.match(await page.evaluate(()=>__estellaCooked.probe(['DeviceStatus']).at.DeviceStatus.text),/Credits: 1/);await click('TrainingPause');await phase('paused');await click('TrainingStart');await phase('ad');await page.evaluate(()=>__ad.adFinished());await phase('playing');+ observation.gameplayEvents=await page.evaluate(()=>__events.slice());+ assert.deepEqual(observation.gameplayEvents,['init','loading','loaded','start','stop','rewarded','start','stop','rewarded','start','stop','midgame','start']);+ if(expectsScores) {+ const at=await page.evaluate(()=>__estellaCooked.probe(['Player','Target']).at);+ if(Math.abs(at.Target.y-at.Player.y)>15) {+ const vertical=at.Target.y>at.Player.y?'KeyW':'KeyS';await page.keyboard.down(vertical);+ await page.waitForFunction(()=>{const p=__estellaCooked.probe(['Player','Target']).at;return Math.abs(p.Player.y-p.Target.y)<15;});await page.keyboard.up(vertical);+ }+ const current=await page.evaluate(()=>__estellaCooked.probe(['Player','Target']).at);+ const horizontal=current.Target.x>current.Player.x?'KeyD':'KeyA';await page.keyboard.down(horizontal);+ await page.waitForFunction(()=>{const p=__estellaCooked.probe(['Player','Target']).at;return Math.hypot(p.Player.x-p.Target.x,p.Player.y-p.Target.y)<60;});await page.keyboard.up(horizontal);+ for(let hit=0;hit<3;hit++){await page.keyboard.press('Space',{delay:80});await page.waitForTimeout(80);}+ await phase('finished');await click('TrainingScore');+ await page.waitForFunction(()=>__estellaCooked.probe(['DeviceStatus']).at.DeviceStatus.text.includes('Score sent'));+ observation.score=await page.evaluate(async()=>{+ const payload=__scores[0],bytes=Uint8Array.from(atob(payload.encryptedScore),char=>char.charCodeAt(0));+ const key=await crypto.subtle.importKey('raw',new Uint8Array(32).fill(7),{name:'AES-GCM'},false,['decrypt']);+ const plaintext=await crypto.subtle.decrypt({name:'AES-GCM',iv:bytes.slice(0,12)},key,bytes.slice(12));+ return {score:payload.score,decrypted:new TextDecoder().decode(plaintext),count:__scores.length};+ });+ assert.deepEqual(observation.score,{score:3,decrypted:'3',count:1});+ }+ if(mode==='normal') {+ await page.reload();await phase('menu');await page.waitForFunction(()=>!document.getElementById('es-splash'));+ observation.restoredCredits=await page.evaluate(()=>__estellaCooked.probe(['DeviceStatus']).at.DeviceStatus.text);+ assert.match(observation.restoredCredits,/Credits: 1/);+ } else {+ assert.match(await page.evaluate(()=>__estellaCooked.probe(['DeviceStatus']).at.DeviceStatus.text),/Save unavailable/);+ if(mode==='save-corrupt')assert.equal(await page.evaluate(()=>JSON.parse(__data.get('estella.storage.v1'))['esengine:mobile-controls.training-credits.v1']),'broken');+ }observation.storage=await page.evaluate(async()=>{const {Storage}=await import('esengine');try {Storage.setString('training-check','retained');const restored=Storage.getString('training-check');@@ -101,9 +139,8 @@ try {return {restored,cleared:Storage.has('training-check'),publisher:CrazyGames.SDK.data.getItem('publisher-data')};} catch(error) {return {error:String(error),localFallback:localStorage.getItem('esengine:training-check')};}});- if (mode==='normal') assert.deepEqual(observation.storage,{restored:'retained',cleared:false,publisher:'keep'});+ if (mode!=='save-disabled') assert.deepEqual(observation.storage,{restored:'retained',cleared:false,publisher:'keep'});else {assert.match(observation.storage.error,/Progress Save disabled/);assert.equal(observation.storage.localFallback,null);}- assert.deepEqual(await page.evaluate(()=>__events),['init','loading','loaded','start','stop','rewarded','start','stop','rewarded','start','stop','midgame','start']);} else {assert.match(await page.evaluate(()=>__estellaCooked.probe(['TrainingReward']).at.TrainingReward ? __estellaCooked.probe(['DeviceStatus']).at.DeviceStatus.text : ''),/Credits: 0/);observation.storage=await page.evaluate(async()=>{try{(await import('esengine')).Storage.setString('training-check','bad');return 'unexpected success';}catch(error){return String(error);}});diff --git a/tools/tests/export-crazygames-score-fixture.mjs b/tools/tests/export-crazygames-score-fixture.mjsnew file mode 100644index 000000000..14e4e57e6--- /dev/null+++ b/tools/tests/export-crazygames-score-fixture.mjs@@ -0,0 +1,23 @@+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+/** A disposable source copy with a known mock-only client key, exported through the real CLI. */+import fs from 'node:fs';+import path from 'node:path';+import { execFileSync } from 'node:child_process';+const args=process.argv.slice(2), flag=name=>args[args.indexOf(name)+1];+if(!args.includes('--wasm')||!args.includes('--out'))throw Error('Expected --wasm <runtime> --out <export>');+const workspace=process.cwd(), output=path.resolve(workspace,'output');+fs.mkdirSync(output,{recursive:true});+const temporary=fs.mkdtempSync(path.join(output,'crazygames-score-source-'));+try {+ const source=path.join(workspace,'examples/mobile-controls'), project=path.join(temporary,'game');+ fs.cpSync(source,project,{recursive:true,filter:file=>!path.relative(source,file).split(path.sep).some(part=>part.startsWith('dist-')||part==='.esengine')});+ const manifestPath=path.join(project,'project.esproject'), manifest=JSON.parse(fs.readFileSync(manifestPath,'utf8'));+ manifest.packaging.profiles.crazygames.platforms.web.leaderboardEncryptionKey=Buffer.alloc(32,7).toString('base64');+ fs.writeFileSync(manifestPath,JSON.stringify(manifest,null,2));+ execFileSync(process.execPath,['pipeline/bin/estella.mjs','export',project,'--profile','crazygames','--wasm',path.resolve(flag('--wasm')),'--out',path.resolve(flag('--out'))],{cwd:workspace,stdio:'inherit',windowsHide:true});+} finally {+ const resolved=path.resolve(temporary);+ if(path.dirname(resolved)!==output||!path.basename(resolved).startsWith('crazygames-score-source-'))throw Error('Unsafe temporary source path');+ fs.rmSync(resolved,{recursive:true,force:true,maxRetries:10,retryDelay:50});+}diff --git a/tools/tests/training-save.test.ts b/tools/tests/training-save.test.tsnew file mode 100644index 000000000..a4899ecee--- /dev/null+++ b/tools/tests/training-save.test.ts@@ -0,0 +1,40 @@+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+import { expect, it, vi } from 'vitest';+import { TrainingSave } from '../../examples/mobile-controls/src/trainingSave';+function fixture(raw?: string) {+ let value = raw;+ const storage = { getString: vi.fn(() => value), setString: vi.fn((_key: string, next: string) => { value = next; }) };+ return { storage, change: (next: string) => { value = next; }, current: () => value };+}+it('loads before saving and restores earned credits on a new session', () => {+ const { storage } = fixture(), first=new TrainingSave(storage);+ expect(first.load()).toBe(0); first.save(1);+ expect(first.message).toContain('cloud backup pending');+ expect(new TrainingSave(storage).load()).toBe(1);+});+it('never overwrites corrupt, future-version or invalid credit records', () => {+ for(const raw of ['bad','null','{"version":2,"credits":5}','{"version":1,"credits":-1}','{"version":1,"credits":1.5}']) {+ const { storage, current }=fixture(raw), save=new TrainingSave(storage);+ expect(save.load()).toBe(0);save.save(1);+ expect(storage.setString).not.toHaveBeenCalled();expect(current()).toBe(raw);+ expect(save.message).toContain('Save unavailable');+ }+});+it('keeps session progress explicit after storage failures and can retry an unchanged record', () => {+ const { storage }=fixture(), save=new TrainingSave(storage);save.load();+ storage.setString.mockImplementationOnce(()=>{throw new Error('quota');});save.save(1);+ expect(save.message).toContain('Save failed');save.save(2);+ expect(new TrainingSave(storage).load()).toBe(2);+});+it('refuses to overwrite external progress changes and never writes before a successful load', () => {+ const { storage, change }=fixture(), save=new TrainingSave(storage);+ save.save(1);expect(storage.setString).not.toHaveBeenCalled();save.load();+ change('{"version":1,"credits":20}');save.save(2);save.save(3);+ expect(storage.setString).not.toHaveBeenCalled();expect(save.message).toContain('changed');+});+it('surfaces unreadable storage as session-only progress without writing fallback', () => {+ const {storage}=fixture();storage.getString.mockImplementation(()=>{throw new Error('disabled');});+ const save=new TrainingSave(storage);expect(save.load()).toBe(0);save.save(1);+ expect(storage.setString).not.toHaveBeenCalled();expect(save.message).toContain('session');+});