@mpgd/platform 0.18.0 → 0.20.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import type { AdProvider } from './ads.js';
+import type { CommerceProvider } from './commerce-contract.js';
 export type PlatformTarget = 'browser' | 'microsoft-store' | 'android' | 'ios' | 'ait' | 'reddit' | 'verse8' | 'crazygames' | 'oneplay' | 'telegram' | 'tauri' | 'wechat' | 'tiktok';
 export type StarterLogicalProductId = 'COINS_100' | 'COINS_500' | 'REMOVE_ADS';
 export type LogicalProductId = StarterLogicalProductId | (string & Record<never, never>);
@@ -208,6 +209,45 @@ export interface LeaderboardAdapter {
 export type PlatformProviderAvailability = 'unsupported' | 'configuration-required' | 'action-required' | 'temporarily-unavailable' | 'available';
 /** Existing capabilities and integrations annotated by optional providers. */
 export type PlatformProviderFeature = 'nativeIap' | 'subscriptionIap' | 'rewardedAds' | 'interstitialAds' | 'bannerAds' | 'nativeLeaderboard' | 'identityUpgrade' | 'pushNotifications';
+export type CommerceFinishOwner = 'client' | 'server' | 'host' | 'none';
+export type CommerceEvidenceAuthority = 'client-token' | 'host-callback' | 'adapter-settled' | 'server-push';
+export type CommerceAccountBindingPolicy = 'required' | 'optional' | 'host';
+export interface CommercePurchaseCapabilities {
+  readonly consumable: boolean;
+  readonly durable: boolean;
+  readonly subscription: boolean;
+  readonly quantity: boolean;
+}
+export interface CommerceCatalogCapabilities {
+  readonly products: boolean;
+  readonly offers: boolean;
+  readonly localizedPrice: boolean;
+}
+export interface CommerceLifecycleCapabilities {
+  readonly availablePurchases: boolean;
+  readonly pending: boolean;
+  readonly restore: boolean;
+  readonly events: boolean;
+  /** Who finishes a granted purchase. */
+  readonly finish: CommerceFinishOwner;
+}
+export interface CommerceAuthorityCapabilities {
+  /** What the backend verifies to grant. */
+  readonly evidence: CommerceEvidenceAuthority;
+  readonly accountBinding: CommerceAccountBindingPolicy;
+}
+/**
+* Commerce v2 capability declaration (`@mpgd/platform/commerce`). Declared
+* here so the main entry stays free of validator imports; code branches on
+* these declarations, never on a store id or target name.
+*/
+export interface CommerceCapabilities {
+  readonly purchase: CommercePurchaseCapabilities;
+  readonly catalog: CommerceCatalogCapabilities;
+  readonly lifecycle: CommerceLifecycleCapabilities;
+  readonly authority: CommerceAuthorityCapabilities;
+  readonly availability: PlatformProviderAvailability;
+}
 export interface PlatformCapabilities {
   readonly nativeIap: boolean;
   /** Optional for adapters published before subscription-specific support. */
@@ -227,6 +267,12 @@ export interface PlatformCapabilities {
   readonly localizedContent: boolean;
   /** Explains a false capability without claiming an unavailable SDK works. */
   readonly providerAvailability?: Readonly<Partial<Record<PlatformProviderFeature, PlatformProviderAvailability>>>;
+  /**
+  * Optional commerce v2 capability block. When present it must be a fresh
+  * object on every read with no unknown keys, and `nativeIap` and
+  * `subscriptionIap` must equal `deriveLegacyCommerceCapabilities(commerce)`.
+  */
+  readonly commerce?: CommerceCapabilities;
 }
 export interface PlayerIdentity {
   readonly playerId: string;
@@ -436,6 +482,13 @@ export interface PlatformGateway {
   getCapabilities(): Promise<PlatformCapabilities>;
   readonly identity: IdentityAdapter;
   readonly commerce: CommerceAdapter;
+  /**
+  * Optional commerce v2 provider (`@mpgd/platform/commerce`). Transitional:
+  * adapters expose it next to the v1 `commerce` adapter until C4 removes v1,
+  * and the game-services reconciler (C1) prefers it when present. Absent on
+  * gateways whose target has no v2 provider.
+  */
+  readonly commerceV2?: CommerceProvider;
   readonly ads: AdAdapter;
   readonly leaderboard: LeaderboardAdapter;
   readonly lifecycle: LifecycleAdapter;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/platform",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "Shared platform gateway, monetization, ads, leaderboard, identity, lifecycle, and storage contracts for mpgd games.",
   "license": "MIT",
   "repository": {
@@ -44,12 +44,28 @@
     "./storage-conformance": {
       "types": "./dist/storage-conformance.d.ts",
       "default": "./dist/storage-conformance.js"
+    },
+    "./commerce": {
+      "types": "./dist/commerce.d.ts",
+      "default": "./dist/commerce.js"
+    },
+    "./commerce-vectors": {
+      "types": "./dist/commerce-vectors.d.ts",
+      "default": "./dist/commerce-vectors.js"
+    },
+    "./commerce-conformance": {
+      "types": "./dist/commerce-conformance.d.ts",
+      "default": "./dist/commerce-conformance.js"
     }
   },
   "files": [
     "dist"
   ],
+  "dependencies": {
+    "typia": "13.0.2"
+  },
   "devDependencies": {
+    "@ttsc/unplugin": "0.30.4",
     "ttsc": "0.30.4",
     "typescript": "7.0.2",
     "vitest": "^4.0.0"
@@ -64,6 +80,6 @@
     "lint": "ttsc --noEmit",
     "format": "ttsc format",
     "fix": "ttsc fix",
-    "test": "vitest run && node test/capability-conformance-dist-import.mjs && node test/storage-conformance-dist-import.mjs && node test/ads-dist-import.mjs"
+    "test": "vitest run && node test/capability-conformance-dist-import.mjs && node test/storage-conformance-dist-import.mjs && node test/ads-dist-import.mjs && node test/commerce-dist-import.mjs && node test/commerce-conformance-dist-import.mjs && cd ../.. && node tools/run-ttsx.mjs packages/platform/test/commerce-derived-key-parity.ts"
   }
 }