@mpgd/game-services 0.14.0 → 0.15.1

package/README.md

@@ -0,0 +1,80 @@
+# Game services
+
+Client, contract, backend, and store helpers for authoritative game services.
+See [backend integration](../../docs/GAME_SERVICES_BACKEND.md) for the existing
+verification and ledger boundaries.
+
+## Optional operation progress
+
+`purchase(input, options?)` and `claimRewardedAd(input, options?)` accept optional
+`onProgress` observers. Existing one-argument calls and client doubles remain
+compatible. Types are available from `@mpgd/game-services/client` and the package
+root. No UI runtime or Phaser dependency is added.
+
+Headless consumers can import `GameServicesOperationClient` and operation types
+from `@mpgd/game-services/operations`. This entrypoint's declarations support
+`lib: ["ES2022"]`, `types: []`, and `skipLibCheck: false`; they do not require
+catalog validators, transport declarations, or DOM globals. Existing response
+type exports from `@mpgd/game-services/types` remain compatible.
+
+```ts
+await client.purchase(input, {
+  correlationId: 'view-operation-42',
+  onProgress: (event) => updateStatus(event),
+  onObserverError: (error) => reportUiObserverError(error),
+});
+```
+
+| Phase | Observed fact |
+| --- | --- |
+| `platform-requested` | The platform API request is about to be attempted |
+| `platform-result` | The platform API resolved; `status` retains its result code |
+| `server-requested` | The request has been constructed and the backend verification/claim call is about to be attempted |
+| `server-result` | The backend resolved; `accepted` mirrors verification or claim acceptance |
+| `completed` | The local invocation returned a normal result; `status` equals that result's status |
+| `exception` | The invocation threw; `at` identifies platform, server, or local processing |
+
+Purchase and rewarded-ad progress are discriminated by `kind` and `phase`.
+`sequence` starts at one per invocation and increases for each actual event.
+Events are frozen and calls have independent observers, sequences, and optional
+correlation IDs. Callback invocation order is deterministic; asynchronous callback
+completion order belongs to the callback. There is no event history, polling,
+retry, or cancellation mechanism.
+
+A platform request is not proof that a native screen opened, and a server stage
+is not proof that it closed. Native UI visibility cannot be inferred from these
+events. Platform ad completion/reward flags, backend acceptance, and the final
+service result remain separate. Progress is observation, never grant evidence.
+
+Successful verified purchases and claimed ads normally emit all five non-error
+stages. Cancelled, pending, failed, skipped, or unavailable platform results
+complete without fabricating backend stages. Unsupported targets emit only the
+local completed result, retaining existing rejected-result semantics. An
+authoritative Microsoft Store completion emits no duplicate verification.
+Verse8 purchases preserve the existing Agent8 grant restrictions and pending
+semantics. Backend rejection is normal completion; an exception leaves the
+outcome uncertain and does not mean the server denied a grant.
+
+Events do not copy receipts, provider evidence, auth headers, player IDs, ledger
+IDs, idempotency keys, raw responses, or provider exception details. A correlation
+ID is caller-supplied UI/diagnostic metadata: use an opaque, non-sensitive value.
+It is independent of the backend idempotency key and confers no grant authority.
+
+Synchronous callback exceptions and rejected callback promises are isolated.
+Observer promises are not awaited: slow or unsettled observers cannot delay a
+platform call, verification, claim, or business result. Optional `onObserverError`
+observes only observation failures; its own exceptions/rejections are consumed.
+There is no forced global logging or transport. Original business exceptions
+still reject the client promise unchanged. Existing analytics, purchase recovery,
+and retry policy are not redesigned by this observer API.
+
+The root `pnpm test` pipeline includes compiled client JS and public declaration
+consumption checks alongside the client and target conformance suites.
+
+All published entrypoints use explicit internal ESM module paths and are smoke-tested
+with native Node imports, without a bundler or TypeScript runtime loader.
+
+Headless consumers can import operation input/result/progress types and the two-method
+`GameServicesOperationClient` port from `@mpgd/game-services/operations`. This entrypoint
+has no runtime implementation and its declarations require no DOM or fetch globals.
+The full client continues to re-export the same operation types for compatibility.

package/dist/admob-ssv-conformance.d.ts

@@ -1,6 +1,6 @@
 import type { AdPlacements } from '@mpgd/catalog';
-import type { GameServicesEvidenceVerifier } from './evidence-verification';
-import type { ClaimAdRewardRequest } from './types';
+import type { GameServicesEvidenceVerifier } from './evidence-verification.js';
+import type { ClaimAdRewardRequest } from './types.js';
 export declare const adMobSsvConformanceChecks: readonly ['verified callback emits one transaction authority identity', 'missing callback remains pending', 'tampered signature fails closed', 'AdMob-decoded signed query bytes accept equivalent percent-encoding', 'missing and duplicate signed fields fail closed', 'unknown key fails closed', 'secp256k1 key feed entries verify', 'signed identity mismatch fails closed', 'timestamp age and future-skew boundaries fail closed', 'callbacks sharing one signed transaction preserve one authority identity'];
 export interface AdMobSsvConformanceReport {
   readonly checks: readonly string[];

package/dist/admob-ssv.d.ts

@@ -1,6 +1,6 @@
 import type { AdPlacementEntry } from '@mpgd/catalog';
-import type { GameServicesEvidenceVerifier } from './evidence-verification';
-import type { ClaimAdRewardRequest } from './types';
+import type { GameServicesEvidenceVerifier } from './evidence-verification.js';
+import type { ClaimAdRewardRequest } from './types.js';
 export declare const admobSsvCustomDataSchema = "mpgd.admob.ssv.binding.v1";
 export declare const defaultAdMobSsvMaximumCallbackAgeMs = 86400000;
 export declare const defaultAdMobSsvMaximumFutureSkewMs = 300000;

package/dist/app-store-verifier-conformance.d.ts

@@ -1,4 +1,4 @@
-import type { AppStoreEnvironment, AppStoreInAppPurchaseType, AppStoreTransactionPayload } from './app-store-verifier';
+import type { AppStoreEnvironment, AppStoreInAppPurchaseType, AppStoreTransactionPayload } from './app-store-verifier.js';
 export interface CreateAppStoreTransactionConformanceFixtureInput {
   readonly transactionId?: string;
   readonly originalTransactionId?: string;

package/dist/app-store-verifier.d.ts

@@ -1,4 +1,4 @@
-import type { GameServicesEvidenceVerifier } from './evidence-verification';
+import type { GameServicesEvidenceVerifier } from './evidence-verification.js';
 export type AppStoreEnvironment = 'Production' | 'Sandbox';
 export declare const appStoreServerApiBaseUrls: Readonly<{
   readonly Production: 'https://api.storekit.apple.com';

package/dist/apps-in-toss-evidence-verification-conformance.d.ts

@@ -1,5 +1,5 @@
-import { type AppsInTossPurchaseAuthority, type AppsInTossPurchaseAuthorityInput, type AppsInTossPurchaseAuthorityResult, type AppsInTossRewardAuthority, type AppsInTossRewardAuthorityInput, type AppsInTossRewardAuthorityResult, type CreateAppsInTossProductionEvidenceVerifierInput } from './apps-in-toss-evidence-verification';
-import type { GameServicesEvidenceVerifier } from './evidence-verification';
+import { type AppsInTossPurchaseAuthority, type AppsInTossPurchaseAuthorityInput, type AppsInTossPurchaseAuthorityResult, type AppsInTossRewardAuthority, type AppsInTossRewardAuthorityInput, type AppsInTossRewardAuthorityResult, type CreateAppsInTossProductionEvidenceVerifierInput } from './apps-in-toss-evidence-verification.js';
+import type { GameServicesEvidenceVerifier } from './evidence-verification.js';
 export declare const appsInTossProductionEvidenceConformanceScenarios: readonly ['callback-only-fail-closed', 'purchase-product-grant-callback', 'purchase-authority-retry', 'purchase-pending-order-restore', 'purchase-authority-matching', 'purchase-timestamp-normalization', 'reward-authority-retry-and-replay', 'reward-timestamp-validation', 'authority-errors-and-reward-matching'];
 export type AppsInTossProductionEvidenceConformanceScenario = (typeof appsInTossProductionEvidenceConformanceScenarios)[number];
 export type CreateAppsInTossProductionEvidenceVerifier = (input?: CreateAppsInTossProductionEvidenceVerifierInput) => GameServicesEvidenceVerifier;

package/dist/apps-in-toss-evidence-verification-conformance.js

@@ -1,5 +1,5 @@
-import { appsInTossPurchaseCallbackEvidenceSchema, createAppsInTossProductGrantCallback, createAppsInTossProductGrantVerificationPort, createAppsInTossProductionEvidenceVerifier, createAppsInTossPurchaseCallbackEvidence, createAppsInTossRewardCallbackEvidence, } from './apps-in-toss-evidence-verification';
-import { createGameServicesBackend, createInMemoryGameServicesStore, InMemoryGameServicesStore, } from './server';
+import { appsInTossPurchaseCallbackEvidenceSchema, createAppsInTossProductGrantCallback, createAppsInTossProductGrantVerificationPort, createAppsInTossProductionEvidenceVerifier, createAppsInTossPurchaseCallbackEvidence, createAppsInTossRewardCallbackEvidence, } from './apps-in-toss-evidence-verification.js';
+import { createGameServicesBackend, createInMemoryGameServicesStore, InMemoryGameServicesStore, } from './server.js';
 export const appsInTossProductionEvidenceConformanceScenarios = [
     'callback-only-fail-closed',
     'purchase-product-grant-callback',

package/dist/apps-in-toss-evidence-verification.d.ts

@@ -1,6 +1,6 @@
 import type { LogicalProductId, PlatformEvidenceEnvelope } from '@mpgd/platform';
-import type { GameServicesEvidenceVerifier } from './evidence-verification';
-import type { VerifyPurchaseRequest, VerifyPurchaseResponse } from './types';
+import type { GameServicesEvidenceVerifier } from './evidence-verification.js';
+import type { VerifyPurchaseRequest, VerifyPurchaseResponse } from './types.js';
 export declare const appsInTossPurchaseCallbackEvidenceSchema = "apps-in-toss.iap.callback.v1";
 export declare const appsInTossRewardCallbackEvidenceSchema = "apps-in-toss.rewarded-ad.callback.v1";
 /** Leaves five seconds of headroom inside the SDK's documented 30-second window. */

package/dist/apps-in-toss-partner-api.d.ts

@@ -1,4 +1,4 @@
-import type { NotificationTemplateData } from './notification-delivery';
+import type { NotificationTemplateData } from './notification-delivery.js';
 export declare const appsInTossPartnerApiBaseUrl = "https://apps-in-toss-api.toss.im";
 export declare const defaultAppsInTossPartnerApiTimeoutMs = 10000;
 /** Compatible with a Cloudflare mTLS certificate binding (`env.BINDING.fetch`). */

package/dist/client.d.ts

@@ -1,7 +1,10 @@
 import { type AnalyticsSink } from '@mpgd/analytics';
-import type { LeaderboardScoreInput, LogicalAdPlacementId, LogicalProductId, PlatformGateway, PlatformTarget, PurchaseResult, RewardedAdResult } from '@mpgd/platform';
-import type { GameServicesContractClient } from './contract';
-import type { ClaimAdRewardRequest, ClaimAdRewardResponse, GameServicesLedgerTarget, RecordLeaderboardScoreRequest, RecordLeaderboardScoreResponse, VerifyPurchaseRequest, VerifyPurchaseResponse } from './types';
+import type { LeaderboardScoreInput, PlatformGateway, PlatformTarget } from '@mpgd/platform';
+import type { GameServicesOperationClient } from './operations.js';
+export type { GameServicesOperationClient, GameServicesPurchaseInput, GameServicesPurchaseResult, GameServicesRewardedAdInput, GameServicesRewardedAdResult, } from './operations.js';
+import type { GameServicesContractClient } from './contract.js';
+import type { ClaimAdRewardRequest, ClaimAdRewardResponse, GameServicesLedgerTarget, RecordLeaderboardScoreRequest, RecordLeaderboardScoreResponse, VerifyPurchaseRequest, VerifyPurchaseResponse } from './types.js';
+export type { GameServicesOperationKind, GameServicesOperationLocation, GameServicesOperationOptions, GameServicesOperationProgress, GameServicesPurchaseProgress, GameServicesRewardedAdProgress, } from './operation-progress.js';
 export interface PurchaseVerificationApi {
   verifyPurchase(input: VerifyPurchaseRequest): Promise<VerifyPurchaseResponse>;
 }
@@ -64,9 +67,7 @@ export declare class GameServicesBackendError extends Error {
   readonly body: unknown;
   constructor(endpoint: GameServicesBackendEndpoint, status: number, body: unknown);
 }
-export interface GameServicesClient {
-  purchase(input: GameServicesPurchaseInput): Promise<GameServicesPurchaseResult>;
-  claimRewardedAd(input: GameServicesRewardedAdInput): Promise<GameServicesRewardedAdResult>;
+export interface GameServicesClient extends GameServicesOperationClient {
   submitLeaderboardScore(input: GameServicesLeaderboardInput): Promise<GameServicesLeaderboardResult>;
 }
 export interface CreateGameServicesClientInput {
@@ -79,27 +80,6 @@ export interface CreateGameServicesClientInput {
   readonly analyticsSessionId?: string;
   readonly now?: () => string;
 }
-export interface GameServicesPurchaseInput {
-  readonly productId: LogicalProductId;
-  readonly source: 'shop' | 'stage_fail' | 'result' | 'event';
-  readonly idempotencyKey: string;
-}
-export interface GameServicesPurchaseResult {
-  readonly status: 'granted' | 'cancelled' | 'pending' | 'failed' | 'rejected';
-  readonly purchase: PurchaseResult;
-  readonly verification?: VerifyPurchaseResponse;
-  readonly ledgerEntryId?: string;
-}
-export interface GameServicesRewardedAdInput {
-  readonly placementId: LogicalAdPlacementId;
-  readonly idempotencyKey: string;
-}
-export interface GameServicesRewardedAdResult {
-  readonly status: 'granted' | 'skipped' | 'unavailable' | 'failed' | 'rejected';
-  readonly reward: RewardedAdResult;
-  readonly claim?: ClaimAdRewardResponse;
-  readonly ledgerEntryId?: string;
-}
 export interface GameServicesLeaderboardInput extends LeaderboardScoreInput {
 }
 export interface GameServicesLeaderboardResult {

package/dist/client.js

@@ -1,6 +1,7 @@
 import { createORPCClient } from '@orpc/client';
 import { RPCLink } from '@orpc/client/fetch';
 import { createAnalyticsReporter } from '@mpgd/analytics';
+import { observeGameServicesOperation } from './operation-progress.js';
 export const gameServicesBackendEndpoints = {
     verifyPurchase: '/game-services/purchases/verify',
     claimAdReward: '/game-services/ad-rewards/claim',
@@ -27,176 +28,190 @@ export function createGameServicesClient(input) {
         ...(input.analytics === undefined ? {} : { sink: input.analytics }),
     });
     return {
-        async purchase(purchaseInput) {
-            const target = input.target;
-            if (!isGameServicesCommerceTarget(target)) {
-                const purchase = {
-                    status: 'failed',
-                    entitlementIds: [],
-                };
-                await analytics.track({
-                    name: 'purchase_rejected',
-                    properties: {
-                        productId: purchaseInput.productId,
-                        status: purchase.status,
-                        reason: 'unsupported_target',
-                    },
-                });
-                return {
-                    status: 'rejected',
-                    purchase,
-                };
-            }
-            const purchase = await input.gateway.commerce.purchase(purchaseInput);
-            if (target === 'verse8') {
-                const status = purchase.status === 'completed' ? 'rejected' : purchase.status;
-                await analytics.track({
-                    name: 'purchase_rejected',
-                    properties: {
-                        productId: purchaseInput.productId,
+        async purchase(purchaseInput, options) {
+            return observeGameServicesOperation('purchase', options, async (progress) => {
+                const target = input.target;
+                if (!isGameServicesCommerceTarget(target)) {
+                    const purchase = {
+                        status: 'failed',
+                        entitlementIds: [],
+                    };
+                    await analytics.track({
+                        name: 'purchase_rejected',
+                        properties: {
+                            productId: purchaseInput.productId,
+                            status: purchase.status,
+                            reason: 'unsupported_target',
+                        },
+                    });
+                    return {
+                        status: 'rejected',
+                        purchase,
+                    };
+                }
+                progress.platformRequested();
+                const purchase = await input.gateway.commerce.purchase(purchaseInput);
+                progress.platformResult(purchase.status);
+                if (target === 'verse8') {
+                    const status = purchase.status === 'completed' ? 'rejected' : purchase.status;
+                    await analytics.track({
+                        name: 'purchase_rejected',
+                        properties: {
+                            productId: purchaseInput.productId,
+                            status,
+                            reason: purchase.status === 'completed'
+                                ? 'verse8_grants_require_agent8_purchase_event'
+                                : purchase.status === 'pending'
+                                    ? 'agent8_purchase_event_pending'
+                                    : undefined,
+                        },
+                    });
+                    return {
                         status,
-                        reason: purchase.status === 'completed'
-                            ? 'verse8_grants_require_agent8_purchase_event'
-                            : purchase.status === 'pending'
-                                ? 'agent8_purchase_event_pending'
-                                : undefined,
-                    },
-                });
-                return {
-                    status,
-                    purchase,
+                        purchase,
+                    };
+                }
+                if (isAuthoritativeMicrosoftStoreCompletion(target, purchase)) {
+                    const result = {
+                        status: 'granted',
+                        purchase,
+                        ledgerEntryId: purchase.transactionId,
+                    };
+                    await analytics.track({
+                        name: 'purchase_granted',
+                        properties: {
+                            productId: purchaseInput.productId,
+                            status: result.status,
+                            ledgerEntryId: purchase.transactionId,
+                            alreadyProcessed: purchase.authoritativeGrant?.alreadyProcessed,
+                        },
+                    });
+                    return result;
+                }
+                if (purchase.status !== 'completed' || purchase.transactionId === undefined) {
+                    await analytics.track({
+                        name: 'purchase_rejected',
+                        properties: {
+                            productId: purchaseInput.productId,
+                            status: purchase.status,
+                            reason: purchaseRejectionReason(purchase),
+                        },
+                    });
+                    return {
+                        status: purchase.status === 'completed' ? 'rejected' : purchase.status,
+                        purchase,
+                    };
+                }
+                const verificationRequest = {
+                    target,
+                    ...(input.deploymentTarget === undefined || input.deploymentTarget === target
+                        ? {}
+                        : { deploymentTarget: input.deploymentTarget }),
+                    playerId: input.playerId,
+                    productId: purchaseInput.productId,
+                    platformTransactionId: purchase.transactionId,
+                    idempotencyKey: purchaseInput.idempotencyKey,
+                    purchasedAt: now(),
+                    ...(purchase.evidence === undefined ? {} : { evidence: purchase.evidence }),
                 };
-            }
-            if (isAuthoritativeMicrosoftStoreCompletion(target, purchase)) {
+                progress.serverRequested();
+                const verification = await input.backend.purchases.verifyPurchase(verificationRequest);
+                progress.serverResult(verification.verified);
                 const result = {
-                    status: 'granted',
+                    status: verification.verified ? 'granted' : 'rejected',
                     purchase,
-                    ledgerEntryId: purchase.transactionId,
+                    verification,
+                    ...(verification.ledgerEntryId === undefined
+                        ? {}
+                        : { ledgerEntryId: verification.ledgerEntryId }),
                 };
                 await analytics.track({
-                    name: 'purchase_granted',
+                    name: verification.verified ? 'purchase_granted' : 'purchase_rejected',
                     properties: {
                         productId: purchaseInput.productId,
                         status: result.status,
-                        ledgerEntryId: purchase.transactionId,
-                        alreadyProcessed: purchase.authoritativeGrant?.alreadyProcessed,
+                        ledgerEntryId: verification.ledgerEntryId,
+                        alreadyProcessed: verification.alreadyProcessed,
+                        reason: verification.reason,
                     },
                 });
                 return result;
-            }
-            if (purchase.status !== 'completed' || purchase.transactionId === undefined) {
-                await analytics.track({
-                    name: 'purchase_rejected',
-                    properties: {
-                        productId: purchaseInput.productId,
-                        status: purchase.status,
-                        reason: purchaseRejectionReason(purchase),
-                    },
-                });
-                return {
-                    status: purchase.status === 'completed' ? 'rejected' : purchase.status,
-                    purchase,
-                };
-            }
-            const verification = await input.backend.purchases.verifyPurchase({
-                target,
-                ...(input.deploymentTarget === undefined || input.deploymentTarget === target
-                    ? {}
-                    : { deploymentTarget: input.deploymentTarget }),
-                playerId: input.playerId,
-                productId: purchaseInput.productId,
-                platformTransactionId: purchase.transactionId,
-                idempotencyKey: purchaseInput.idempotencyKey,
-                purchasedAt: now(),
-                ...(purchase.evidence === undefined ? {} : { evidence: purchase.evidence }),
             });
-            const result = {
-                status: verification.verified ? 'granted' : 'rejected',
-                purchase,
-                verification,
-                ...(verification.ledgerEntryId === undefined
-                    ? {}
-                    : { ledgerEntryId: verification.ledgerEntryId }),
-            };
-            await analytics.track({
-                name: verification.verified ? 'purchase_granted' : 'purchase_rejected',
-                properties: {
-                    productId: purchaseInput.productId,
-                    status: result.status,
-                    ledgerEntryId: verification.ledgerEntryId,
-                    alreadyProcessed: verification.alreadyProcessed,
-                    reason: verification.reason,
-                },
-            });
-            return result;
         },
-        async claimRewardedAd(rewardInput) {
-            const target = input.target;
-            if (!isGameServicesAdRewardTarget(target)) {
-                const reward = {
-                    status: 'unavailable',
-                    rewardGranted: false,
+        async claimRewardedAd(rewardInput, options) {
+            return observeGameServicesOperation('rewarded-ad', options, async (progress) => {
+                const target = input.target;
+                if (!isGameServicesAdRewardTarget(target)) {
+                    const reward = {
+                        status: 'unavailable',
+                        rewardGranted: false,
+                    };
+                    await analytics.track({
+                        name: 'rewarded_ad_rejected',
+                        properties: {
+                            placementId: rewardInput.placementId,
+                            status: reward.status,
+                            rewardGranted: reward.rewardGranted,
+                            reason: 'unsupported_target',
+                        },
+                    });
+                    return {
+                        status: 'rejected',
+                        reward,
+                    };
+                }
+                progress.platformRequested();
+                const reward = await input.gateway.ads.showRewarded(rewardInput);
+                progress.platformResult(reward.status);
+                if (reward.status !== 'completed' || !reward.rewardGranted) {
+                    await analytics.track({
+                        name: 'rewarded_ad_rejected',
+                        properties: {
+                            placementId: rewardInput.placementId,
+                            status: reward.status,
+                            rewardGranted: reward.rewardGranted,
+                        },
+                    });
+                    return {
+                        status: reward.status === 'completed' ? 'rejected' : reward.status,
+                        reward,
+                    };
+                }
+                const claimRequest = {
+                    target,
+                    ...(input.deploymentTarget === undefined || input.deploymentTarget === target
+                        ? {}
+                        : { deploymentTarget: input.deploymentTarget }),
+                    playerId: input.playerId,
+                    placementId: rewardInput.placementId,
+                    ...(reward.ledgerEntryId === undefined
+                        ? {}
+                        : { platformImpressionId: reward.ledgerEntryId }),
+                    idempotencyKey: rewardInput.idempotencyKey,
+                    completedAt: now(),
+                    ...(reward.evidence === undefined ? {} : { evidence: reward.evidence }),
                 };
-                await analytics.track({
-                    name: 'rewarded_ad_rejected',
-                    properties: {
-                        placementId: rewardInput.placementId,
-                        status: reward.status,
-                        rewardGranted: reward.rewardGranted,
-                        reason: 'unsupported_target',
-                    },
-                });
-                return {
-                    status: 'rejected',
+                progress.serverRequested();
+                const claim = await input.backend.adRewards.claimAdReward(claimRequest);
+                progress.serverResult(claim.granted);
+                const result = {
+                    status: claim.granted ? 'granted' : 'rejected',
                     reward,
+                    claim,
+                    ...(claim.ledgerEntryId === undefined ? {} : { ledgerEntryId: claim.ledgerEntryId }),
                 };
-            }
-            const reward = await input.gateway.ads.showRewarded(rewardInput);
-            if (reward.status !== 'completed' || !reward.rewardGranted) {
                 await analytics.track({
-                    name: 'rewarded_ad_rejected',
+                    name: claim.granted ? 'rewarded_ad_granted' : 'rewarded_ad_rejected',
                     properties: {
                         placementId: rewardInput.placementId,
-                        status: reward.status,
-                        rewardGranted: reward.rewardGranted,
+                        status: result.status,
+                        ledgerEntryId: claim.ledgerEntryId,
+                        alreadyProcessed: claim.alreadyProcessed,
+                        reason: claim.reason,
                     },
                 });
-                return {
-                    status: reward.status === 'completed' ? 'rejected' : reward.status,
-                    reward,
-                };
-            }
-            const claim = await input.backend.adRewards.claimAdReward({
-                target,
-                ...(input.deploymentTarget === undefined || input.deploymentTarget === target
-                    ? {}
-                    : { deploymentTarget: input.deploymentTarget }),
-                playerId: input.playerId,
-                placementId: rewardInput.placementId,
-                ...(reward.ledgerEntryId === undefined
-                    ? {}
-                    : { platformImpressionId: reward.ledgerEntryId }),
-                idempotencyKey: rewardInput.idempotencyKey,
-                completedAt: now(),
-                ...(reward.evidence === undefined ? {} : { evidence: reward.evidence }),
-            });
-            const result = {
-                status: claim.granted ? 'granted' : 'rejected',
-                reward,
-                claim,
-                ...(claim.ledgerEntryId === undefined ? {} : { ledgerEntryId: claim.ledgerEntryId }),
-            };
-            await analytics.track({
-                name: claim.granted ? 'rewarded_ad_granted' : 'rewarded_ad_rejected',
-                properties: {
-                    placementId: rewardInput.placementId,
-                    status: result.status,
-                    ledgerEntryId: claim.ledgerEntryId,
-                    alreadyProcessed: claim.alreadyProcessed,
-                    reason: claim.reason,
-                },
+                return result;
             });
-            return result;
         },
         async submitLeaderboardScore(scoreInput) {
             const target = input.target;

package/dist/contract.d.ts

@@ -1,5 +1,5 @@
 import { type RouterContractClient } from '@orpc/contract';
-import type { ClaimAdRewardRequest, ClaimAdRewardResponse, RecordLeaderboardScoreRequest, RecordLeaderboardScoreResponse, VerifyPurchaseRequest, VerifyPurchaseResponse } from './types';
+import type { ClaimAdRewardRequest, ClaimAdRewardResponse, RecordLeaderboardScoreRequest, RecordLeaderboardScoreResponse, VerifyPurchaseRequest, VerifyPurchaseResponse } from './types.js';
 export interface GameServicesHealthResponse {
   readonly ok: true;
   readonly service: 'game-services';

package/dist/evidence-verification.d.ts

@@ -1,5 +1,5 @@
 import type { AdPlacements, ProductCatalog } from '@mpgd/catalog';
-import type { ClaimAdRewardRequest, EntitlementLedgerPayload, PurchaseGrantFinalization, VerifyPurchaseRequest } from './types';
+import type { ClaimAdRewardRequest, EntitlementLedgerPayload, PurchaseGrantFinalization, VerifyPurchaseRequest } from './types.js';
 export type EvidenceVerificationDecision = {
   readonly status: 'verified';
   readonly verificationId: string;

package/dist/google-play-purchase-conformance.d.ts

@@ -1,4 +1,4 @@
-import { type GooglePlayAcknowledgementState, type GooglePlayConsumptionState, type GooglePlayPurchaseState } from './google-play-purchase';
+import { type GooglePlayAcknowledgementState, type GooglePlayConsumptionState, type GooglePlayPurchaseState } from './google-play-purchase.js';
 export declare const googlePlayProductPurchaseConformanceEvidence: Readonly<{
   schema: "google-play.product-purchase.v2";
   payload: Readonly<{

package/dist/google-play-purchase-conformance.js

@@ -1,4 +1,4 @@
-import { googlePlayProductPurchaseEvidenceSchema, } from './google-play-purchase';
+import { googlePlayProductPurchaseEvidenceSchema, } from './google-play-purchase.js';
 export const googlePlayProductPurchaseConformanceEvidence = Object.freeze({
     schema: googlePlayProductPurchaseEvidenceSchema,
     payload: Object.freeze({

package/dist/google-play-purchase.d.ts

@@ -1,4 +1,4 @@
-import type { GameServicesEvidenceVerifier, GameServicesPurchaseGrantFinalizer, VerifyPurchaseEvidenceInput } from './evidence-verification';
+import type { GameServicesEvidenceVerifier, GameServicesPurchaseGrantFinalizer, VerifyPurchaseEvidenceInput } from './evidence-verification.js';
 export declare const googlePlayProductPurchaseEvidenceSchema = "google-play.product-purchase.v2";
 export type GooglePlayPurchaseState = 'PURCHASED' | 'CANCELLED' | 'PENDING' | 'PURCHASE_STATE_UNSPECIFIED';
 export type GooglePlayConsumptionState = 'CONSUMPTION_STATE_YET_TO_BE_CONSUMED' | 'CONSUMPTION_STATE_CONSUMED' | 'CONSUMPTION_STATE_UNSPECIFIED';

package/dist/index.d.ts

@@ -1,18 +1,18 @@
 export * from './admob-ssv.js';
-export * from './app-store-verifier';
-export * from './apps-in-toss-evidence-verification';
-export * from './apps-in-toss-partner-api';
-export * from './client';
-export * from './contract';
-export * from './evidence-verification';
-export * from './google-play-purchase';
-export * from './microsoft-store-identity';
-export * from './microsoft-store-purchase';
-export * from './notification-delivery';
-export * from './platform-order';
-export * from './progress-link';
+export * from './app-store-verifier.js';
+export * from './apps-in-toss-evidence-verification.js';
+export * from './apps-in-toss-partner-api.js';
+export * from './client.js';
+export * from './contract.js';
+export * from './evidence-verification.js';
+export * from './google-play-purchase.js';
+export * from './microsoft-store-identity.js';
+export * from './microsoft-store-purchase.js';
+export * from './notification-delivery.js';
+export * from './platform-order.js';
+export * from './progress-link.js';
 export * from './runtime.js';
-export * from './server';
-export * from './types';
-export * from './verified-leaderboard';
-export * from './verified-leaderboard-transport';
+export * from './server.js';
+export * from './types.js';
+export * from './verified-leaderboard.js';
+export * from './verified-leaderboard-transport.js';

package/dist/index.js

@@ -1,18 +1,18 @@
 export * from './admob-ssv.js';
-export * from './app-store-verifier';
-export * from './apps-in-toss-evidence-verification';
-export * from './apps-in-toss-partner-api';
-export * from './client';
-export * from './contract';
-export * from './evidence-verification';
-export * from './google-play-purchase';
-export * from './microsoft-store-identity';
-export * from './microsoft-store-purchase';
-export * from './notification-delivery';
-export * from './platform-order';
-export * from './progress-link';
+export * from './app-store-verifier.js';
+export * from './apps-in-toss-evidence-verification.js';
+export * from './apps-in-toss-partner-api.js';
+export * from './client.js';
+export * from './contract.js';
+export * from './evidence-verification.js';
+export * from './google-play-purchase.js';
+export * from './microsoft-store-identity.js';
+export * from './microsoft-store-purchase.js';
+export * from './notification-delivery.js';
+export * from './platform-order.js';
+export * from './progress-link.js';
 export * from './runtime.js';
-export * from './server';
-export * from './types';
-export * from './verified-leaderboard';
-export * from './verified-leaderboard-transport';
+export * from './server.js';
+export * from './types.js';
+export * from './verified-leaderboard.js';
+export * from './verified-leaderboard-transport.js';

package/dist/microsoft-store-identity.d.ts

@@ -1,4 +1,4 @@
-import type { MicrosoftStoreCollectionsCredentials } from './microsoft-store-purchase';
+import type { MicrosoftStoreCollectionsCredentials } from './microsoft-store-purchase.js';
 export declare const microsoftStoreIdentityCredentialsSchema: 'mpgd.microsoft-store.identity-credentials.v1';
 export declare const microsoftStoreIdentityCredentialsRequestUrl: 'https://microsoft-store-authority.internal/v1/credentials';
 export interface MicrosoftStoreIdentityCredentialsRequest {

package/dist/microsoft-store-purchase.d.ts

@@ -1,4 +1,4 @@
-import type { GameServicesEvidenceVerifier, GameServicesPurchaseGrantFinalizer, VerifyPurchaseEvidenceInput } from './evidence-verification';
+import type { GameServicesEvidenceVerifier, GameServicesPurchaseGrantFinalizer, VerifyPurchaseEvidenceInput } from './evidence-verification.js';
 export declare const microsoftStoreDigitalGoodsEvidenceSchema: 'mpgd.microsoft-store.digital-goods.v1';
 export declare const microsoftStoreCollectionsQueryUrl: 'https://collections.mp.microsoft.com/v9.0/collections/publisherQuery';
 export declare const microsoftStoreCollectionsConsumeUrl: 'https://collections.mp.microsoft.com/v8.0/collections/consume';

package/dist/notification-delivery.js

@@ -1,4 +1,4 @@
-import { assertOwnEnumerablePropertyLimit } from './validation';
+import { assertOwnEnumerablePropertyLimit } from './validation.js';
 const platformTargets = new Set([
     'browser',
     'android',

package/dist/operation-progress.d.ts

@@ -0,0 +1,47 @@
+import type { PurchaseResult, RewardedAdResult } from '@mpgd/platform';
+import type { GameServicesPurchaseResult, GameServicesRewardedAdResult } from './operations.js';
+export type GameServicesOperationKind = 'purchase' | 'rewarded-ad';
+export type GameServicesOperationLocation = 'local' | 'platform' | 'server';
+type PlatformStatus<K extends GameServicesOperationKind> = K extends 'purchase' ? PurchaseResult['status'] : RewardedAdResult['status'];
+type OperationResult<K extends GameServicesOperationKind> = K extends 'purchase' ? GameServicesPurchaseResult : GameServicesRewardedAdResult;
+type ProgressStage<K extends GameServicesOperationKind> = {
+  readonly phase: 'platform-requested';
+} | {
+  readonly phase: 'platform-result';
+  readonly status: PlatformStatus<K>;
+} | {
+  readonly phase: 'server-requested';
+} | {
+  readonly phase: 'server-result';
+  readonly accepted: boolean;
+} | {
+  readonly phase: 'completed';
+  readonly status: OperationResult<K>['status'];
+} | {
+  readonly phase: 'exception';
+  readonly at: GameServicesOperationLocation;
+};
+type OperationProgress<K extends GameServicesOperationKind> = ProgressStage<K> & {
+  readonly kind: K;
+  /** Invocation-local event order, starting at one. */
+  readonly sequence: number;
+  /** Optional UI/diagnostic correlation, never an idempotency key or grant proof. */
+  readonly correlationId?: string;
+};
+export type GameServicesPurchaseProgress = OperationProgress<'purchase'>;
+export type GameServicesRewardedAdProgress = OperationProgress<'rewarded-ad'>;
+export type GameServicesOperationProgress = GameServicesPurchaseProgress | GameServicesRewardedAdProgress;
+export interface GameServicesOperationOptions<TProgress = GameServicesOperationProgress> {
+  readonly onProgress?: (progress: TProgress) => void | Promise<void>;
+  readonly onObserverError?: (error: unknown) => void | Promise<void>;
+  readonly correlationId?: string;
+}
+interface OperationReporter<K extends GameServicesOperationKind> {
+  platformRequested(): void;
+  platformResult(status: PlatformStatus<K>): void;
+  serverRequested(): void;
+  serverResult(accepted: boolean): void;
+}
+/** Internal observation wrapper; it does not retry, cancel, verify, or grant anything. */
+export declare function observeGameServicesOperation<K extends GameServicesOperationKind>(kind: K, options: GameServicesOperationOptions<OperationProgress<K>> | undefined, operation: (reporter: OperationReporter<K>) => Promise<OperationResult<K>>): Promise<OperationResult<K>>;
+export {};

package/dist/operation-progress.js

@@ -0,0 +1,87 @@
+/** Internal observation wrapper; it does not retry, cancel, verify, or grant anything. */
+export async function observeGameServicesOperation(kind, options, operation) {
+    let onProgress;
+    let onObserverError;
+    let correlationId;
+    let sequence = 0;
+    let location = 'local';
+    function report(error) {
+        try {
+            if (typeof onObserverError === 'function') {
+                const result = onObserverError(error);
+                if (result !== undefined) {
+                    void Promise.resolve(result).catch(() => { });
+                }
+            }
+        }
+        catch {
+            // Diagnostic callbacks have no authority to change business results.
+        }
+    }
+    // Capture observation options once. Even accessor failures stay outside the business flow.
+    try {
+        onObserverError = options?.onObserverError;
+    }
+    catch {
+        // There is no safe error observer to invoke if retrieving it failed.
+    }
+    try {
+        onProgress = options?.onProgress;
+        const suppliedId = options?.correlationId;
+        if (typeof suppliedId === 'string') {
+            correlationId = suppliedId;
+        }
+    }
+    catch (error) {
+        report(error);
+    }
+    function emit(stage) {
+        sequence += 1;
+        if (typeof onProgress !== 'function') {
+            return;
+        }
+        const observer = onProgress;
+        const progress = Object.freeze({
+            ...stage,
+            kind,
+            sequence,
+            ...(correlationId === undefined ? {} : { correlationId }),
+        });
+        try {
+            const result = observer(progress);
+            if (result !== undefined) {
+                void Promise.resolve(result).catch(report);
+            }
+        }
+        catch (error) {
+            report(error);
+        }
+    }
+    const reporter = {
+        platformRequested() {
+            location = 'platform';
+            emit({ phase: 'platform-requested' });
+        },
+        platformResult(status) {
+            location = 'local';
+            emit({ phase: 'platform-result', status });
+        },
+        serverRequested() {
+            location = 'server';
+            emit({ phase: 'server-requested' });
+        },
+        serverResult(accepted) {
+            location = 'local';
+            emit({ phase: 'server-result', accepted });
+        },
+    };
+    try {
+        const result = await operation(reporter);
+        emit({ phase: 'completed', status: result.status });
+        return result;
+    }
+    catch (error) {
+        emit({ phase: 'exception', at: location });
+        throw error;
+    }
+}

package/dist/operation-results.d.ts

@@ -0,0 +1,21 @@
+/** Shared response shapes with no schema, DOM or transport dependencies. */
+export interface VerifyPurchaseResponse {
+  readonly verified: boolean;
+  readonly ledgerEntryId?: string;
+  readonly alreadyProcessed: boolean;
+  readonly reason?: string;
+  readonly finalization?: PurchaseGrantFinalization;
+}
+export type PurchaseGrantFinalizationAction = 'acknowledge' | 'consume' | 'finish' | 'complete';
+export interface PurchaseGrantFinalization {
+  readonly status: 'completed' | 'pending';
+  readonly action?: PurchaseGrantFinalizationAction;
+  readonly alreadyCompleted: boolean;
+  readonly reason?: string;
+}
+export interface ClaimAdRewardResponse {
+  readonly granted: boolean;
+  readonly ledgerEntryId?: string;
+  readonly alreadyProcessed: boolean;
+  readonly reason?: string;
+}

package/dist/operation-results.js

@@ -0,0 +1 @@
+export {};

package/dist/operations.d.ts

@@ -0,0 +1,30 @@
+import type { LogicalAdPlacementId, LogicalProductId, PurchaseResult, RewardedAdResult } from '@mpgd/platform';
+import type { GameServicesOperationOptions, GameServicesPurchaseProgress, GameServicesRewardedAdProgress } from './operation-progress.js';
+import type { ClaimAdRewardResponse, VerifyPurchaseResponse } from './operation-results.js';
+export type { GameServicesOperationKind, GameServicesOperationLocation, GameServicesOperationOptions, GameServicesOperationProgress, GameServicesPurchaseProgress, GameServicesRewardedAdProgress, } from './operation-progress.js';
+/** DOM-free public operation port, implemented by GameServicesClient. */
+export interface GameServicesOperationClient {
+  purchase(input: GameServicesPurchaseInput, options?: GameServicesOperationOptions<GameServicesPurchaseProgress>): Promise<GameServicesPurchaseResult>;
+  claimRewardedAd(input: GameServicesRewardedAdInput, options?: GameServicesOperationOptions<GameServicesRewardedAdProgress>): Promise<GameServicesRewardedAdResult>;
+}
+export interface GameServicesPurchaseInput {
+  readonly productId: LogicalProductId;
+  readonly source: 'shop' | 'stage_fail' | 'result' | 'event';
+  readonly idempotencyKey: string;
+}
+export interface GameServicesPurchaseResult {
+  readonly status: 'granted' | 'cancelled' | 'pending' | 'failed' | 'rejected';
+  readonly purchase: PurchaseResult;
+  readonly verification?: VerifyPurchaseResponse;
+  readonly ledgerEntryId?: string;
+}
+export interface GameServicesRewardedAdInput {
+  readonly placementId: LogicalAdPlacementId;
+  readonly idempotencyKey: string;
+}
+export interface GameServicesRewardedAdResult {
+  readonly status: 'granted' | 'skipped' | 'unavailable' | 'failed' | 'rejected';
+  readonly reward: RewardedAdResult;
+  readonly claim?: ClaimAdRewardResponse;
+  readonly ledgerEntryId?: string;
+}

package/dist/operations.js

@@ -0,0 +1 @@
+export {};

package/dist/progress-link.js

@@ -1,4 +1,4 @@
-import { assertOwnEnumerablePropertyLimit } from './validation';
+import { assertOwnEnumerablePropertyLimit } from './validation.js';
 export const gameProgressLimits = {
     maxIdentifierLength: 256,
     maxCompletedIds: 512,

package/dist/server.d.ts

@@ -1,9 +1,9 @@
 import { type AnalyticsSink } from '@mpgd/analytics';
 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 GameServicesStoreTarget, type LeaderboardScoreTransaction, type ProductGrantTransaction, type RecordLeaderboardScoreRequest, type RecordLeaderboardScoreResponse, type VerifyPurchaseRequest, type VerifyPurchaseResponse } from './types';
+import { type GameServicesBackendApi, type GameServicesBackendTransport, type GameServicesBackendTransportRequest, type GameServicesBackendTransportResponse } from './client.js';
+import { type GameServicesHealthResponse } from './contract.js';
+import { type GameServicesEvidenceVerifier, type GameServicesPurchaseGrantFinalizer } from './evidence-verification.js';
+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.js';
 type CorsHeaders = Record<string, string>;
 export interface CreateGameServicesBackendInput {
   readonly catalog: ProductCatalog;
@@ -113,5 +113,5 @@ export declare function createGameServicesRouter(backend: GameServicesBackendApi
 };
 export declare function createGameServicesRpcFetchHandler(router: ReturnType<typeof createGameServicesRouter>, options?: CreateGameServicesRpcFetchHandlerOptions): (request: Request) => Promise<Response>;
 export declare function createGameServicesHttpFetchHandler(handler: GameServicesBackendApiHandler, options?: CreateGameServicesFetchHandlerOptions): (request: Request) => Promise<Response>;
-export * from './notification-delivery';
-export * from './progress-link';
+export * from './notification-delivery.js';
+export * from './progress-link.js';

package/dist/server.js

@@ -2,10 +2,10 @@ import { implement } from '@orpc/server';
 import { RPCHandler } from '@orpc/server/fetch';
 import { createAnalyticsReporter } from '@mpgd/analytics';
 import { resolveAdPlacementPlatformId, resolveProductPlatformId, } from '@mpgd/catalog';
-import { gameServicesBackendEndpoints, } from './client';
-import { gameServicesContract } from './contract';
-import { createRejectingGameServicesEvidenceVerifier, } from './evidence-verification';
-import { assertClaimAdRewardRequest, assertClaimAdRewardResponse, assertEntitlementLedgerGrant, assertEntitlementLedgerResult, assertGameServicesDeploymentTarget, assertLeaderboardScoreTransaction, assertProductGrantTransaction, assertPurchaseGrantFinalization, assertRecordLeaderboardScoreRequest, assertRecordLeaderboardScoreResponse, assertVerifyPurchaseRequest, assertVerifyPurchaseResponse, } from './types';
+import { gameServicesBackendEndpoints, } from './client.js';
+import { gameServicesContract } from './contract.js';
+import { createRejectingGameServicesEvidenceVerifier, } from './evidence-verification.js';
+import { assertClaimAdRewardRequest, assertClaimAdRewardResponse, assertEntitlementLedgerGrant, assertEntitlementLedgerResult, assertGameServicesDeploymentTarget, assertLeaderboardScoreTransaction, assertProductGrantTransaction, assertPurchaseGrantFinalization, assertRecordLeaderboardScoreRequest, assertRecordLeaderboardScoreResponse, assertVerifyPurchaseRequest, assertVerifyPurchaseResponse, } from './types.js';
 export class InMemoryGameServicesStore {
     entitlementTransactionsByKey = new Map();
     entitlementTransactionsByEvidence = new Map();
@@ -622,6 +622,9 @@ function createStoredPurchaseRequest(request, transaction) {
     const purchasedAt = transaction.payload.purchasedAt;
     return {
         ...request,
+        // Evidence recovery can arrive with another request key. Consume/release must use the
+        // original durable grant generation, never the retry's newly supplied key.
+        idempotencyKey: transaction.idempotencyKey,
         ...(typeof platformTransactionId === 'string' && platformTransactionId.length > 0
             ? { platformTransactionId }
             : {}),
@@ -1157,5 +1160,5 @@ function applyCorsHeaders(headers, corsHeaders) {
         headers.set(key, value);
     }
 }
-export * from './notification-delivery';
-export * from './progress-link';
+export * from './notification-delivery.js';
+export * from './progress-link.js';

package/dist/types.d.ts

@@ -1,5 +1,7 @@
 import type { ProductGrant } from '@mpgd/catalog';
 import type { LeaderboardScoreInput, LogicalAdPlacementId, LogicalProductId, PlatformEvidenceEnvelope, PlatformTarget } from '@mpgd/platform';
+import type { ClaimAdRewardResponse, PurchaseGrantFinalization, VerifyPurchaseResponse } from './operation-results.js';
+export type { ClaimAdRewardResponse, PurchaseGrantFinalization, PurchaseGrantFinalizationAction, VerifyPurchaseResponse, } from './operation-results.js';
 export type { PlatformEvidenceEnvelope } from '@mpgd/platform';
 export type GameServicesStoreTarget = Extract<PlatformTarget, 'microsoft-store' | 'android' | 'ios' | 'ait'>;
 export type GameServicesAdRewardTarget = Extract<PlatformTarget, 'android' | 'ios' | 'ait' | 'verse8'>;
@@ -21,20 +23,6 @@ export interface VerifyPurchaseRequest {
   readonly purchasedAt: string;
   readonly evidence?: PlatformEvidenceEnvelope;
 }
-export interface VerifyPurchaseResponse {
-  readonly verified: boolean;
-  readonly ledgerEntryId?: string;
-  readonly alreadyProcessed: boolean;
-  readonly reason?: string;
-  readonly finalization?: PurchaseGrantFinalization;
-}
-export type PurchaseGrantFinalizationAction = 'acknowledge' | 'consume' | 'finish' | 'complete';
-export interface PurchaseGrantFinalization {
-  readonly status: 'completed' | 'pending';
-  readonly action?: PurchaseGrantFinalizationAction;
-  readonly alreadyCompleted: boolean;
-  readonly reason?: string;
-}
 export interface ClaimAdRewardRequest {
   readonly target: GameServicesAdRewardTarget;
   /** Deployment config key used to resolve game-owned platform placement identifiers. */
@@ -47,12 +35,6 @@ export interface ClaimAdRewardRequest {
   readonly completedAt: string;
   readonly evidence?: PlatformEvidenceEnvelope;
 }
-export interface ClaimAdRewardResponse {
-  readonly granted: boolean;
-  readonly ledgerEntryId?: string;
-  readonly alreadyProcessed: boolean;
-  readonly reason?: string;
-}
 export interface RecordLeaderboardScoreRequest extends LeaderboardScoreInput {
   readonly target: GameServicesLeaderboardTarget;
   readonly playerId: string;

package/dist/verified-leaderboard-conformance.d.ts

@@ -1,4 +1,4 @@
-import { type VerifiedLeaderboardService } from './verified-leaderboard';
+import { type VerifiedLeaderboardService } from './verified-leaderboard.js';
 export declare const verifiedLeaderboardConformanceScenarios: readonly ['first-selection-and-snapshot', 'best-selection-and-retry', 'deterministic-ties', 'identity-and-definition-conflicts', 'concurrent-idempotency', 'mutation-isolation', 'runtime-validation'];
 export type VerifiedLeaderboardConformanceScenario = (typeof verifiedLeaderboardConformanceScenarios)[number];
 export interface CreateVerifiedLeaderboardConformanceFixtureInput {

package/dist/verified-leaderboard-conformance.js

@@ -1,4 +1,4 @@
-import { assertRecordVerifiedLeaderboardAttemptResponse, assertVerifiedLeaderboardSnapshot, } from './verified-leaderboard';
+import { assertRecordVerifiedLeaderboardAttemptResponse, assertVerifiedLeaderboardSnapshot, } from './verified-leaderboard.js';
 export const verifiedLeaderboardConformanceScenarios = [
     'first-selection-and-snapshot',
     'best-selection-and-retry',

package/dist/verified-leaderboard-durability-conformance.d.ts

@@ -1,4 +1,4 @@
-import { type VerifiedLeaderboardService } from './verified-leaderboard';
+import { type VerifiedLeaderboardService } from './verified-leaderboard.js';
 export declare const verifiedLeaderboardDurabilityConformanceScenarios: readonly ['replacement-after-interrupted-retained-write', 'concurrent-retry-after-interrupted-retained-write', 'snapshot-after-interrupted-retained-write'];
 export type VerifiedLeaderboardDurabilityConformanceScenario = (typeof verifiedLeaderboardDurabilityConformanceScenarios)[number];
 export interface CreateVerifiedLeaderboardDurabilityConformanceFixtureInput {

package/dist/verified-leaderboard-durability-conformance.js

@@ -1,4 +1,4 @@
-import { assertRecordVerifiedLeaderboardAttemptResponse, assertVerifiedLeaderboardSnapshot, } from './verified-leaderboard';
+import { assertRecordVerifiedLeaderboardAttemptResponse, assertVerifiedLeaderboardSnapshot, } from './verified-leaderboard.js';
 export const verifiedLeaderboardDurabilityConformanceScenarios = [
     'replacement-after-interrupted-retained-write',
     'concurrent-retry-after-interrupted-retained-write',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/game-services",
-  "version": "0.14.0",
+  "version": "0.15.1",
   "description": "Client, contract, server, store, and test helpers for authoritative mpgd game services.",
   "license": "MIT",
   "repository": {
@@ -124,6 +124,10 @@
     "./verified-leaderboard-durability-conformance": {
       "types": "./dist/verified-leaderboard-durability-conformance.d.ts",
       "default": "./dist/verified-leaderboard-durability-conformance.js"
+    },
+    "./operations": {
+      "types": "./dist/operations.d.ts",
+      "default": "./dist/operations.js"
     }
   },
   "files": [
@@ -135,8 +139,8 @@
     "@orpc/contract": "2.0.0-beta.14",
     "@orpc/server": "2.0.0-beta.14",
     "@mpgd/analytics": "0.3.12",
-    "@mpgd/platform": "0.12.0",
-    "@mpgd/catalog": "0.7.2"
+    "@mpgd/catalog": "0.7.2",
+    "@mpgd/platform": "0.12.0"
   },
   "devDependencies": {
     "ttsc": "0.18.4",
@@ -152,6 +156,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/microsoft-store-purchase.test.ts && node tools/run-ttsx.mjs packages/game-services/src/microsoft-store-identity.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/client-progress.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/microsoft-store-identity.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"
   }
 }