@mpgd/platform 0.8.0 → 0.10.0

package/dist/capability-conformance.d.ts

@@ -1,5 +1,6 @@
 import type { PlatformCapabilities, PlatformGateway, PlatformTarget } from './index.js';
-export declare const platformCapabilityKeys: readonly ["nativeIap", "nativeAds", "rewardedAds", "interstitialAds", "nativeLeaderboard", "achievements", "cloudSave", "socialShare", "haptics", "localizedContent"];
+export declare const platformCapabilityKeys: readonly ["nativeIap", "nativeAds", "rewardedAds", "interstitialAds", "nativeLeaderboard", "remoteLeaderboard", "achievements", "cloudSave", "socialShare", "haptics", "localizedContent"];
+export declare const optionalPlatformCapabilityKeys: readonly ["bannerAds"];
 export interface PlatformGatewayCapabilityConformanceTransition {
   readonly update: () => Promise<void> | void;
   readonly expectedCapabilities: PlatformCapabilities;

package/dist/capability-conformance.js

@@ -4,12 +4,22 @@ export const platformCapabilityKeys = Object.freeze([
     'rewardedAds',
     'interstitialAds',
     'nativeLeaderboard',
+    'remoteLeaderboard',
     'achievements',
     'cloudSave',
     'socialShare',
     'haptics',
     'localizedContent',
 ]);
+export const optionalPlatformCapabilityKeys = Object.freeze([
+    'bannerAds',
+]);
+const allowedPlatformCapabilityKeys = Object.freeze([
+    ...platformCapabilityKeys,
+    ...optionalPlatformCapabilityKeys,
+]);
+const allowedPlatformCapabilityKeySet = new Set(allowedPlatformCapabilityKeys);
+const optionalPlatformCapabilityKeySet = new Set(optionalPlatformCapabilityKeys);
 /**
  * Runs provider-neutral capability checks against real adapter gateways or
  * target-configured wrappers. Every read must return a complete boolean
@@ -60,11 +70,15 @@ async function runFixture(fixture) {
 }
 function assertCapabilitySnapshot(actual, expected) {
     const actualKeys = Object.keys(actual).sort();
-    const expectedKeys = [...platformCapabilityKeys].sort();
-    assertEqual(JSON.stringify(actualKeys), JSON.stringify(expectedKeys), 'capability snapshots must contain exactly the public capability keys');
-    for (const key of platformCapabilityKeys) {
-        assertEqual(typeof actual[key], 'boolean', `capability ${key} must be a boolean`);
-        assertEqual(actual[key], expected[key], `capability ${key} must match the expected provider state`);
+    const missingKeys = platformCapabilityKeys.filter((key) => !Object.hasOwn(actual, key));
+    const unexpectedKeys = actualKeys.filter((key) => !allowedPlatformCapabilityKeySet.has(key));
+    assertEqual(JSON.stringify({ missingKeys, unexpectedKeys }), JSON.stringify({ missingKeys: [], unexpectedKeys: [] }), 'capability snapshots must contain all required keys and no unknown keys');
+    for (const key of allowedPlatformCapabilityKeys) {
+        const optional = optionalPlatformCapabilityKeySet.has(key);
+        if (!optional || Object.hasOwn(actual, key)) {
+            assertEqual(typeof actual[key], 'boolean', `capability ${key} must be a boolean`);
+        }
+        assertEqual(optional ? (actual[key] ?? false) : actual[key], optional ? (expected[key] ?? false) : expected[key], `capability ${key} must match the expected provider state`);
     }
 }
 function tryMutateSnapshot(snapshot) {
@@ -76,7 +90,8 @@ function tryMutateSnapshot(snapshot) {
     }
 }
 function hasCapabilityDifference(first, second) {
-    return platformCapabilityKeys.some((key) => first[key] !== second[key]);
+    return allowedPlatformCapabilityKeys
+        .some((key) => (first[key] ?? false) !== (second[key] ?? false));
 }
 function assert(condition, message) {
     if (!condition) {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type PlatformTarget = 'browser' | 'android' | 'ios' | 'ait' | 'reddit' | 'verse8' | 'telegram' | 'tauri';
+export type PlatformTarget = 'browser' | 'microsoft-store' | 'android' | 'ios' | 'ait' | 'reddit' | 'verse8' | 'telegram' | 'tauri';
 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';
@@ -29,6 +29,11 @@ export interface PurchaseResult {
   readonly transactionId?: string;
   readonly entitlementIds: readonly string[];
   readonly evidence?: PlatformEvidenceEnvelope;
+  /** Present only when the adapter already completed the authoritative server grant. */
+  readonly authoritativeGrant?: Readonly<{
+    readonly ledgerEntryId: string;
+    readonly alreadyProcessed?: boolean;
+  }>;
 }
 export interface PurchaseRestoreResult {
   readonly restoredEntitlements: readonly Entitlement[];
@@ -42,6 +47,16 @@ export interface RewardedAdResult {
 export interface InterstitialAdResult {
   readonly status: 'shown' | 'skipped' | 'unavailable';
 }
+/**
+* Result of mounting a platform-rendered inline banner into a game-owned surface.
+* The platform host owns the native/SDK attachment; games only reserve and name
+* a surface, so this contract does not leak DOM or provider types. Adapters must
+* release any partial attachment before resolving `unavailable` or `failed`;
+* games only need to unmount a successfully mounted banner.
+*/
+export interface BannerAdMountResult {
+  readonly status: 'mounted' | 'unavailable' | 'failed';
+}
 export interface CommerceAdapter {
   getProducts(): Promise<readonly ProductInfo[]>;
   purchase(input: {
@@ -63,6 +78,14 @@ export interface AdAdapter {
   showInterstitial?(input: {
     readonly placementId: LogicalAdPlacementId;
   }): Promise<InterstitialAdResult>;
+  mountBanner?(input: {
+    readonly placementId: LogicalAdPlacementId;
+    /** Host-resolvable identifier for an empty, game-owned inline ad surface. */
+    readonly surfaceId: string;
+  }): Promise<BannerAdMountResult>;
+  unmountBanner?(input: {
+    readonly surfaceId: string;
+  }): Promise<void>;
 }
 export type PromotionRewardAvailability = 'available' | 'configuration-required' | 'unsupported';
 export type PromotionRewardResult = {
@@ -110,7 +133,11 @@ export interface PlatformCapabilities {
   readonly nativeAds: boolean;
   readonly rewardedAds: boolean;
   readonly interstitialAds: boolean;
+  /** Optional for compatibility with adapters published before inline ads. */
+  readonly bannerAds?: boolean;
   readonly nativeLeaderboard: boolean;
+  /** A game-owned server leaderboard is available without a native platform surface. */
+  readonly remoteLeaderboard: boolean;
   readonly achievements: boolean;
   readonly cloudSave: boolean;
   readonly socialShare: boolean;

package/dist/index.js

@@ -14,6 +14,7 @@ export function createUnsupportedCapabilities() {
         rewardedAds: false,
         interstitialAds: false,
         nativeLeaderboard: false,
+        remoteLeaderboard: false,
         achievements: false,
         cloudSave: false,
         socialShare: false,

package/package.json

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