@mpgd/platform 0.15.0 → 0.16.0

package/dist/ads.d.ts

@@ -57,6 +57,8 @@ export interface AdProvider {
   readonly protocol: typeof adProtocol;
   readonly protocolVersion: typeof adProtocolVersion;
   readonly rewardSignal: 'immediate' | 'delayed';
+  /** Defaults to requested. Some hosts require audio to continue until physical start. */
+  readonly presentationAudio?: 'requested' | 'started';
   getAvailability(input: AdPlacementInput): Promise<AdAvailability>;
   preload(input: AdPlacementInput): Promise<AdPreparationResult>;
   show(input: AdShowInput): Promise<AdShowResult>;

package/dist/ads.js

@@ -219,6 +219,9 @@ export function toAdAdapter(provider) {
     if (provider.rewardSignal !== 'immediate' && provider.rewardSignal !== 'delayed') {
         throw new TypeError('Invalid advertising provider reward signal.');
     }
+    if (provider.presentationAudio !== undefined && provider.presentationAudio !== 'requested' && provider.presentationAudio !== 'started') {
+        throw new TypeError('Invalid advertising presentation audio policy.');
+    }
     return {
         provider,
         async preload(input) {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import type { AdProvider } from './ads.js';
-export type PlatformTarget = 'browser' | 'microsoft-store' | 'android' | 'ios' | 'ait' | 'reddit' | 'verse8' | 'telegram' | 'tauri' | 'wechat' | 'tiktok';
+export type PlatformTarget = 'browser' | 'microsoft-store' | 'android' | 'ios' | 'ait' | 'reddit' | 'verse8' | 'crazygames' | 'telegram' | 'tauri' | 'wechat' | 'tiktok';
 export type StarterLogicalProductId = 'COINS_100' | 'COINS_500' | 'REMOVE_ADS';
 export type LogicalProductId = StarterLogicalProductId | (string & Record<never, never>);
 export type StarterLogicalAdPlacementId = 'CONTINUE_AFTER_FAIL' | 'STAGE_END_INTERSTITIAL';
@@ -381,6 +381,18 @@ export interface SecureCredentialStore {
     readonly key: string;
   }): Promise<void>;
 }
+/** Platform telemetry only; it never pauses execution or grants a reward. */
+export interface GameActivityAdapter {
+  /** The host already accounts for focus changes; avoid duplicate gameplay events. */
+  readonly handlesFocusChanges?: boolean;
+  setLoading(loading: boolean): void;
+  setGameplayActive(active: boolean): void;
+}
+/** Host audio policy takes precedence over an in-game sound toggle. */
+export interface GameSettingsAdapter {
+  getAudioMuted(): boolean;
+  onAudioMuteChange(callback: (muted: boolean) => void): () => void;
+}
 export interface PlatformGateway {
   readonly target: PlatformTarget;
   getCapabilities(): Promise<PlatformCapabilities>;
@@ -397,5 +409,7 @@ export interface PlatformGateway {
   readonly sharing?: ShareAdapter;
   readonly notifications?: NotificationSubscriptionAdapter;
   readonly promotions?: PromotionRewardAdapter;
+  readonly gameActivity?: GameActivityAdapter;
+  readonly gameSettings?: GameSettingsAdapter;
 }
 export declare function createUnsupportedCapabilities(): PlatformCapabilities;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/platform",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Shared platform gateway, monetization, ads, leaderboard, identity, lifecycle, and storage contracts for mpgd games.",
   "license": "MIT",
   "repository": {