@mpgd/game-services 0.11.1 → 0.12.0

package/dist/notification-delivery.js

@@ -8,6 +8,7 @@ const platformTargets = new Set([
     'verse8',
     'telegram',
     'tauri',
+    'microsoft-store',
 ]);
 const notificationTopics = new Set([
     'daily-ready',

package/dist/runtime.d.ts

@@ -20,6 +20,8 @@ export interface CreateGameServicesRuntimeInput {
   readonly deploymentTarget?: string;
   readonly baseUrl?: string;
   readonly transport?: 'http' | 'orpc';
+  /** Static headers sent with every authoritative game-services request. */
+  readonly headers?: Record<string, string>;
   readonly allowLocalBackend?: boolean;
   readonly localBackend?: GameServicesBackendApi;
   readonly analytics?: AnalyticsSink;

package/dist/runtime.js

@@ -19,9 +19,15 @@ export function createGameServicesRuntime(input) {
         }
         mode = input.transport === 'orpc' ? 'orpc' : 'http';
         backend = mode === 'orpc'
-            ? createGameServicesOrpcBackendApi(createGameServicesOrpcClient({ url: baseUrl }))
+            ? createGameServicesOrpcBackendApi(createGameServicesOrpcClient({
+                url: baseUrl,
+                ...(input.headers === undefined ? {} : { headers: input.headers }),
+            }))
             : createGameServicesHttpBackendApi({
-                transport: createGameServicesFetchBackendTransport({ baseUrl }),
+                transport: createGameServicesFetchBackendTransport({
+                    baseUrl,
+                    ...(input.headers === undefined ? {} : { headers: input.headers }),
+                }),
             });
     }
     else {
@@ -59,6 +65,7 @@ export function createGameServicesRuntime(input) {
 }
 export function resolveGameServicesLedgerTarget(target) {
     if (target === 'browser'
+        || target === 'microsoft-store'
         || target === 'android'
         || target === 'ios'
         || target === 'ait'

package/dist/server.d.ts

@@ -3,7 +3,7 @@ import { type AdPlacements, type ProductCatalog } from '@mpgd/catalog';
 import { type GameServicesBackendApi, type GameServicesBackendTransport, type GameServicesBackendTransportRequest, type GameServicesBackendTransportResponse } from './client';
 import { type GameServicesHealthResponse } from './contract';
 import { type GameServicesEvidenceVerifier, type GameServicesPurchaseGrantFinalizer } from './evidence-verification';
-import { type ClaimAdRewardRequest, type ClaimAdRewardResponse, type EntitlementLedgerGrant, type EntitlementLedgerResult, type GameServicesAdRewardTarget, type LeaderboardScoreTransaction, type ProductGrantTransaction, type RecordLeaderboardScoreRequest, type RecordLeaderboardScoreResponse, type VerifyPurchaseRequest, type VerifyPurchaseResponse } from './types';
+import { type ClaimAdRewardRequest, type ClaimAdRewardResponse, type EntitlementLedgerGrant, type EntitlementLedgerResult, type GameServicesAdRewardTarget, type GameServicesStoreTarget, type LeaderboardScoreTransaction, type ProductGrantTransaction, type RecordLeaderboardScoreRequest, type RecordLeaderboardScoreResponse, type VerifyPurchaseRequest, type VerifyPurchaseResponse } from './types';
 type CorsHeaders = Record<string, string>;
 export interface CreateGameServicesBackendInput {
   readonly catalog: ProductCatalog;
@@ -20,7 +20,7 @@ export interface CreateGameServicesBackendInput {
   readonly purchaseGrantFinalizationTimeoutMs?: number;
   readonly purchaseGrantFinalizer?: GameServicesPurchaseGrantFinalizer;
 }
-export type GameServicesDeploymentTargetBindings = Readonly<Partial<Record<GameServicesAdRewardTarget, string>>>;
+export type GameServicesDeploymentTargetBindings = Readonly<Partial<Record<GameServicesAdRewardTarget | GameServicesStoreTarget, string>>>;
 export interface GameServicesBackendApiHandler {
   readonly version?: string;
   handle(request: GameServicesBackendTransportRequest): Promise<GameServicesBackendTransportResponse>;

package/dist/server.js

@@ -318,6 +318,7 @@ export function createGameServicesHttpFetchHandler(handler, options = {}) {
     };
 }
 const gameServicesDeploymentTargetPlatforms = new Set([
+    'microsoft-store',
     'android',
     'ios',
     'ait',
@@ -445,6 +446,30 @@ async function verifyPurchaseWithStore(input, context) {
         },
     });
     if (grant.status === 'evidence_already_processed') {
+        const existingEvidence = await findEntitlementTransactionByEvidenceVerificationId(context.store, { source: 'purchase', evidenceVerificationId: verification.verificationId });
+        if (existingEvidence !== undefined
+            && matchesPurchaseEvidenceRecovery(existingEvidence, {
+                playerId: request.playerId,
+                grantId: request.productId,
+                target: request.target,
+                ...(request.deploymentTarget === undefined
+                    ? {}
+                    : { deploymentTarget: request.deploymentTarget }),
+                evidenceVerificationId: verification.verificationId,
+            })) {
+            const finalization = await finalizeExistingPurchaseGrant(request, existingEvidence, context);
+            // A different idempotency key is evidence replay unless a configured finalizer can resume
+            // the provider operation. Keep generic stores fail-closed while allowing Store consume
+            // recovery to report the already-recorded grant.
+            if (finalization !== undefined) {
+                return assertVerifyPurchaseResponse({
+                    verified: true,
+                    ledgerEntryId: existingEvidence.ledgerEntryId,
+                    alreadyProcessed: true,
+                    finalization,
+                });
+            }
+        }
         return assertVerifyPurchaseResponse({
             verified: false,
             alreadyProcessed: false,
@@ -947,9 +972,20 @@ async function recordedEntitlementMatchesRetry(store, result, identity) {
     return transaction !== undefined && matchesEntitlementRetry(transaction, identity);
 }
 function matchesEntitlementRetry(transaction, identity) {
+    return matchesEntitlementTransactionIdentity(transaction, identity)
+        && transaction.idempotencyKey === identity.idempotencyKey;
+}
+function matchesPurchaseEvidenceRecovery(transaction, identity) {
+    return matchesEntitlementTransactionIdentity(transaction, {
+        ...identity,
+        source: 'purchase',
+    })
+        && (transaction.evidenceVerificationId
+            ?? transaction.payload.evidenceVerificationId) === identity.evidenceVerificationId;
+}
+function matchesEntitlementTransactionIdentity(transaction, identity) {
     return transaction.source === identity.source
         && transaction.playerId === identity.playerId
-        && transaction.idempotencyKey === identity.idempotencyKey
         && transaction.grantId === identity.grantId
         && transaction.payload.target === identity.target
         && transaction.payload.deploymentTarget === identity.deploymentTarget;

package/dist/types.d.ts

@@ -1,10 +1,10 @@
 import type { ProductGrant } from '@mpgd/catalog';
 import type { LeaderboardScoreInput, LogicalAdPlacementId, LogicalProductId, PlatformEvidenceEnvelope, PlatformTarget } from '@mpgd/platform';
 export type { PlatformEvidenceEnvelope } from '@mpgd/platform';
-export type GameServicesStoreTarget = Extract<PlatformTarget, 'android' | 'ios' | 'ait'>;
+export type GameServicesStoreTarget = Extract<PlatformTarget, 'microsoft-store' | 'android' | 'ios' | 'ait'>;
 export type GameServicesAdRewardTarget = Extract<PlatformTarget, 'android' | 'ios' | 'ait' | 'verse8'>;
-export type GameServicesLeaderboardTarget = Extract<PlatformTarget, 'browser' | 'android' | 'ios' | 'ait' | 'reddit'>;
-export type GameServicesLedgerTarget = Extract<PlatformTarget, 'browser' | 'android' | 'ios' | 'ait' | 'reddit' | 'verse8'>;
+export type GameServicesLeaderboardTarget = Extract<PlatformTarget, 'browser' | 'microsoft-store' | 'android' | 'ios' | 'ait' | 'reddit'>;
+export type GameServicesLedgerTarget = Extract<PlatformTarget, 'browser' | 'microsoft-store' | 'android' | 'ios' | 'ait' | 'reddit' | 'verse8'>;
 export type PurchaseIdempotencyKey = string;
 export type AdRewardIdempotencyKey = string;
 export type EntitlementIdempotencyKey = PurchaseIdempotencyKey | AdRewardIdempotencyKey;

package/dist/types.js

@@ -128,8 +128,11 @@ function assertRecord(input, label) {
     }
 }
 function assertStoreTarget(input) {
-    if (input !== 'android' && input !== 'ios' && input !== 'ait') {
-        throw new Error('target must be android, ios, or ait.');
+    if (input !== 'microsoft-store'
+        && input !== 'android'
+        && input !== 'ios'
+        && input !== 'ait') {
+        throw new Error('target must be microsoft-store, android, ios, or ait.');
     }
 }
 function assertAdRewardTarget(input) {
@@ -167,11 +170,12 @@ const reservedDeploymentTargetNames = new Set([
 ]);
 function assertLeaderboardTarget(input) {
     if (input !== 'browser'
+        && input !== 'microsoft-store'
         && input !== 'android'
         && input !== 'ios'
         && input !== 'ait'
         && input !== 'reddit') {
-        throw new Error('target must be browser, android, ios, ait, or reddit.');
+        throw new Error('target must be browser, microsoft-store, android, ios, ait, or reddit.');
     }
 }
 function assertNonEmptyString(input, label) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/game-services",
-  "version": "0.11.1",
+  "version": "0.12.0",
   "description": "Client, contract, server, store, and test helpers for authoritative mpgd game services.",
   "license": "MIT",
   "repository": {
@@ -73,6 +73,10 @@
       "types": "./dist/google-play-purchase.d.ts",
       "default": "./dist/google-play-purchase.js"
     },
+    "./microsoft-store-purchase": {
+      "types": "./dist/microsoft-store-purchase.d.ts",
+      "default": "./dist/microsoft-store-purchase.js"
+    },
     "./google-play-purchase-conformance": {
       "types": "./dist/google-play-purchase-conformance.d.ts",
       "default": "./dist/google-play-purchase-conformance.js"
@@ -126,9 +130,9 @@
     "@orpc/client": "2.0.0-beta.14",
     "@orpc/contract": "2.0.0-beta.14",
     "@orpc/server": "2.0.0-beta.14",
-    "@mpgd/analytics": "0.3.8",
-    "@mpgd/catalog": "0.5.2",
-    "@mpgd/platform": "0.8.0"
+    "@mpgd/catalog": "0.6.0",
+    "@mpgd/platform": "0.9.0",
+    "@mpgd/analytics": "0.3.9"
   },
   "devDependencies": {
     "ttsc": "0.18.4",
@@ -144,6 +148,6 @@
     "lint": "ttsc --noEmit",
     "format": "ttsc format",
     "fix": "ttsc fix",
-    "test": "cd ../.. && node tools/run-ttsx.mjs packages/game-services/src/client.test.ts && node tools/run-ttsx.mjs packages/game-services/src/runtime.test.ts && node tools/run-ttsx.mjs packages/game-services/src/types.test.ts && node tools/run-ttsx.mjs packages/game-services/src/server.test.ts && node tools/run-ttsx.mjs packages/game-services/src/google-play-purchase.test.ts && node tools/run-ttsx.mjs packages/game-services/src/platform-order.test.ts && node tools/run-ttsx.mjs packages/game-services/src/progress-link.test.ts && node tools/run-ttsx.mjs packages/game-services/src/notification-delivery.test.ts && node tools/run-ttsx.mjs packages/game-services/src/admob-ssv.test.ts && node tools/run-ttsx.mjs packages/game-services/src/app-store-verifier.test.ts && node tools/run-ttsx.mjs packages/game-services/src/apps-in-toss-evidence-verification-conformance.test.ts && node tools/run-ttsx.mjs packages/game-services/src/apps-in-toss-partner-api.test.ts && node tools/run-ttsx.mjs packages/game-services/src/verified-leaderboard.test.ts && node tools/run-ttsx.mjs packages/game-services/src/verified-leaderboard-conformance.test.ts && node tools/run-ttsx.mjs packages/game-services/src/verified-leaderboard-durability-conformance.test.ts && node tools/run-ttsx.mjs packages/game-services/src/verified-leaderboard-transport.test.ts"
+    "test": "cd ../.. && node tools/run-ttsx.mjs packages/game-services/src/client.test.ts && node tools/run-ttsx.mjs packages/game-services/src/runtime.test.ts && node tools/run-ttsx.mjs packages/game-services/src/types.test.ts && node tools/run-ttsx.mjs packages/game-services/src/server.test.ts && node tools/run-ttsx.mjs packages/game-services/src/google-play-purchase.test.ts && node tools/run-ttsx.mjs packages/game-services/src/microsoft-store-purchase.test.ts && node tools/run-ttsx.mjs packages/game-services/src/platform-order.test.ts && node tools/run-ttsx.mjs packages/game-services/src/progress-link.test.ts && node tools/run-ttsx.mjs packages/game-services/src/notification-delivery.test.ts && node tools/run-ttsx.mjs packages/game-services/src/admob-ssv.test.ts && node tools/run-ttsx.mjs packages/game-services/src/app-store-verifier.test.ts && node tools/run-ttsx.mjs packages/game-services/src/apps-in-toss-evidence-verification-conformance.test.ts && node tools/run-ttsx.mjs packages/game-services/src/apps-in-toss-partner-api.test.ts && node tools/run-ttsx.mjs packages/game-services/src/verified-leaderboard.test.ts && node tools/run-ttsx.mjs packages/game-services/src/verified-leaderboard-conformance.test.ts && node tools/run-ttsx.mjs packages/game-services/src/verified-leaderboard-durability-conformance.test.ts && node tools/run-ttsx.mjs packages/game-services/src/verified-leaderboard-transport.test.ts"
   }
 }