@mpgd/platform 0.7.0 → 0.9.0

package/dist/capability-conformance.d.ts

@@ -1,5 +1,5 @@
 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 interface PlatformGatewayCapabilityConformanceTransition {
   readonly update: () => Promise<void> | void;
   readonly expectedCapabilities: PlatformCapabilities;

package/dist/capability-conformance.js

@@ -4,6 +4,7 @@ export const platformCapabilityKeys = Object.freeze([
     'rewardedAds',
     'interstitialAds',
     'nativeLeaderboard',
+    'remoteLeaderboard',
     'achievements',
     'cloudSave',
     'socialShare',

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[];
@@ -64,6 +69,31 @@ export interface AdAdapter {
     readonly placementId: LogicalAdPlacementId;
   }): Promise<InterstitialAdResult>;
 }
+export type PromotionRewardAvailability = 'available' | 'configuration-required' | 'unsupported';
+export type PromotionRewardResult = {
+  readonly status: 'granted';
+  /** Opaque provider receipt used by the game backend to finalize the authorized claim. */
+  readonly receiptKey: string;
+} | {
+  readonly status: 'pending' | 'unavailable' | 'failed';
+};
+/**
+* Optional platform-funded promotion surface.
+*
+* Games address logical campaign ids only. Platform promotion codes and reward
+* amounts belong to the target host configuration, while claim authorization
+* and receipt finalization remain server responsibilities.
+*/
+export interface PromotionRewardAdapter {
+  getAvailability(input: {
+    readonly campaignId: string;
+  }): Promise<PromotionRewardAvailability>;
+  grantReward(input: {
+    readonly campaignId: string;
+    /** Server-issued, single-use claim id. */
+    readonly idempotencyKey: string;
+  }): Promise<PromotionRewardResult>;
+}
 export interface LeaderboardScoreInput {
   readonly leaderboardId: string;
   readonly score: number;
@@ -86,6 +116,8 @@ export interface PlatformCapabilities {
   readonly rewardedAds: boolean;
   readonly interstitialAds: 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;
@@ -200,5 +232,6 @@ export interface PlatformGateway {
   readonly presentation?: PresentationAdapter;
   readonly sharing?: ShareAdapter;
   readonly notifications?: NotificationSubscriptionAdapter;
+  readonly promotions?: PromotionRewardAdapter;
 }
 export declare function createUnsupportedCapabilities(): PlatformCapabilities;

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.7.0",
+  "version": "0.9.0",
   "description": "Shared platform gateway, monetization, ads, leaderboard, identity, lifecycle, and storage contracts for mpgd games.",
   "license": "MIT",
   "repository": {