@mpgd/game-services 0.16.0 → 0.17.1

package/dist/operation-results.d.ts

@@ -1,6 +1,8 @@
 /** Shared response shapes with no schema, DOM or transport dependencies. */
 export interface VerifyPurchaseResponse {
   readonly verified: boolean;
+  /** Explicit non-grant decision; older servers may omit this field. */
+  readonly disposition?: 'pending' | 'rejected';
   readonly ledgerEntryId?: string;
   readonly alreadyProcessed: boolean;
   readonly reason?: string;
@@ -15,6 +17,8 @@ export interface PurchaseGrantFinalization {
 }
 export interface ClaimAdRewardResponse {
   readonly granted: boolean;
+  /** Explicit non-grant decision; older servers may omit this field. */
+  readonly disposition?: 'pending' | 'rejected';
   readonly ledgerEntryId?: string;
   readonly alreadyProcessed: boolean;
   readonly reason?: string;

package/dist/operations.d.ts

@@ -23,7 +23,7 @@ export interface GameServicesRewardedAdInput {
   readonly idempotencyKey: string;
 }
 export interface GameServicesRewardedAdResult {
-  readonly status: 'granted' | 'skipped' | 'unavailable' | 'failed' | 'rejected';
+  readonly status: 'granted' | 'pending' | 'skipped' | 'unavailable' | 'failed' | 'rejected';
   readonly reward: RewardedAdResult;
   readonly claim?: ClaimAdRewardResponse;
   readonly ledgerEntryId?: string;

package/dist/runtime.d.ts

@@ -2,6 +2,7 @@ import type { AnalyticsSink } from '@mpgd/analytics';
 import type { PlatformGateway, PlatformTarget } from '@mpgd/platform';
 import { type GameServicesBackendApi, type GameServicesBackendTransport, type GameServicesClient, type GameServicesHeaderResolver } from './client.js';
 import type { GameServicesLedgerTarget } from './types.js';
+import { type MonetizationOperationStore, type RecoverableMonetizationClient } from './monetization-recovery.js';
 export type GameServicesAuthorityMode = 'production' | 'non-production';
 export type GameServicesRuntimeMode = 'disabled' | 'local' | 'http' | 'orpc';
 export type GameServicesDisabledReason = 'unsupported_target' | 'missing_authoritative_backend' | 'invalid_authoritative_backend' | 'local_backend_not_allowed' | 'local_backend_unavailable';
@@ -11,6 +12,7 @@ export interface GameServicesRuntime {
   readonly baseUrl?: string;
   readonly target?: GameServicesLedgerTarget;
   readonly client?: GameServicesClient;
+  readonly monetizationRecovery?: RecoverableMonetizationClient;
 }
 interface CreateGameServicesRuntimeCommonInput {
   readonly gateway: PlatformGateway;
@@ -28,6 +30,8 @@ interface CreateGameServicesRuntimeCommonInput {
   readonly analytics?: AnalyticsSink;
   readonly analyticsSessionId?: string;
   readonly now?: () => string;
+  /** Durable, compare-and-swap journal for purchase and rewarded-ad recovery. */
+  readonly operationStore?: MonetizationOperationStore;
 }
 export type CreateGameServicesRuntimeInput = CreateGameServicesRuntimeCommonInput & ({
   readonly transport?: 'http';

package/dist/runtime.js

@@ -1,4 +1,5 @@
 import { createGameServicesClient, createGameServicesFetchBackendTransport, createGameServicesHttpBackendApi, createGameServicesOrpcBackendApi, createGameServicesOrpcClient, resolveGameServicesRequestHeaders, } from './client.js';
+import { createRecoverableMonetizationClient, } from './monetization-recovery.js';
 export function createGameServicesRuntime(input) {
     assertAuthorityMode(input.authorityMode);
     assertTransport(input.transport);
@@ -47,24 +48,38 @@ export function createGameServicesRuntime(input) {
         mode = 'local';
         backend = input.localBackend;
     }
+    const clientInput = {
+        gateway: input.gateway,
+        backend,
+        playerId: input.playerId,
+        target,
+        ...(input.deploymentTarget === undefined
+            ? {}
+            : { deploymentTarget: input.deploymentTarget }),
+        ...(input.analytics === undefined ? {} : { analytics: input.analytics }),
+        ...(input.analyticsSessionId === undefined
+            ? {}
+            : { analyticsSessionId: input.analyticsSessionId }),
+        ...(input.now === undefined ? {} : { now: input.now }),
+    };
+    const client = createGameServicesClient(clientInput);
+    const monetizationRecovery = input.operationStore === undefined
+        ? undefined
+        : createRecoverableMonetizationClient({ ...clientInput, operationStore: input.operationStore });
+    let routedClient = client;
+    if (monetizationRecovery !== undefined) {
+        routedClient = {
+            ...client,
+            purchase: monetizationRecovery.purchase,
+            claimRewardedAd: monetizationRecovery.claimRewardedAd,
+        };
+    }
     return {
         mode,
         ...(baseUrl === undefined ? {} : { baseUrl }),
         target,
-        client: createGameServicesClient({
-            gateway: input.gateway,
-            backend,
-            playerId: input.playerId,
-            target,
-            ...(input.deploymentTarget === undefined
-                ? {}
-                : { deploymentTarget: input.deploymentTarget }),
-            ...(input.analytics === undefined ? {} : { analytics: input.analytics }),
-            ...(input.analyticsSessionId === undefined
-                ? {}
-                : { analyticsSessionId: input.analyticsSessionId }),
-            ...(input.now === undefined ? {} : { now: input.now }),
-        }),
+        client: routedClient,
+        ...(monetizationRecovery === undefined ? {} : { monetizationRecovery }),
     };
 }
 function withRuntimeHeaders(transport, input) {

package/dist/server.d.ts

@@ -4,6 +4,7 @@ import { type GameServicesBackendApi, type GameServicesBackendTransport, type Ga
 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';
+export { gameServicesRequestLimits, GameServicesRequestValidationError } from './validation.js';
 type CorsHeaders = Record<string, string>;
 export interface CreateGameServicesBackendInput {
   readonly catalog: ProductCatalog;
@@ -19,14 +20,26 @@ export interface CreateGameServicesBackendInput {
   readonly evidenceVerificationTimeoutMs?: number;
   readonly purchaseGrantFinalizationTimeoutMs?: number;
   readonly purchaseGrantFinalizer?: GameServicesPurchaseGrantFinalizer;
+  /**
+  * Receives unexpected (non-validation) failures such as store errors before the
+  * transport answers with the generic `INTERNAL_ERROR` code. Defaults to `console.error`.
+  * The hook is diagnostics only: if it throws or returns a rejecting promise, the failure
+  * is logged and the generic error response is still returned.
+  */
+  readonly onInternalError?: GameServicesInternalErrorHandler;
 }
+export type GameServicesInternalErrorHandler = (error: unknown) => void;
 export type GameServicesDeploymentTargetBindings = Readonly<Partial<Record<GameServicesAdRewardTarget | GameServicesStoreTarget, string>>>;
 export interface GameServicesBackendApiHandler {
   readonly version?: string;
   handle(request: GameServicesBackendTransportRequest): Promise<GameServicesBackendTransportResponse>;
 }
+/** Stable error codes emitted by the backend API handler and the HTTP fetch handler. */
+export type GameServicesBackendErrorCode = 'INVALID_REQUEST' | 'INVALID_JSON' | 'PAYLOAD_TOO_LARGE' | 'METHOD_NOT_ALLOWED' | 'UNKNOWN_ENDPOINT' | 'INTERNAL_ERROR';
 export interface GameServicesBackendErrorResponse {
-  readonly error: string;
+  readonly error: GameServicesBackendErrorCode;
+  /** Present only for `INVALID_REQUEST`; never carries internal failure details. */
+  readonly message?: string;
 }
 export interface GameServicesStore {
   recordEntitlementGrant(input: EntitlementLedgerGrant): Promise<EntitlementLedgerResult>;
@@ -57,6 +70,11 @@ export interface CreateGameServicesFetchHandlerOptions {
   readonly corsHeaders?: CorsHeaders;
   readonly healthPath?: string;
   readonly version?: string;
+  /** Request bodies above this byte size are rejected with 413. */
+  readonly maxBodyBytes?: number;
+}
+export interface CreateGameServicesRouterOptions {
+  readonly onInternalError?: GameServicesInternalErrorHandler;
 }
 export interface CreateGameServicesRpcFetchHandlerOptions extends CreateGameServicesFetchHandlerOptions {
   readonly prefix?: string;
@@ -99,7 +117,7 @@ export declare function createInMemoryGameServicesStore(): InMemoryGameServicesS
 export declare function createGameServicesBackend(input: CreateGameServicesBackendInput): GameServicesBackendApi;
 export declare function createGameServicesBackendApiHandler(input: CreateGameServicesBackendInput): GameServicesBackendApiHandler;
 export declare function createInProcessGameServicesBackendTransport(handler: GameServicesBackendApiHandler): GameServicesBackendTransport;
-export declare function createGameServicesRouter(backend: GameServicesBackendApi): {
+export declare function createGameServicesRouter(backend: GameServicesBackendApi, options?: CreateGameServicesRouterOptions): {
   health: import("@orpc/server").ImplementedProcedure<GameServicesOrpcContext & object, object, import("@orpc/contract").Schema<void, void>, import("@orpc/contract").Schema<GameServicesHealthResponse, GameServicesHealthResponse>, object>;
   commerce: {
     verifyPurchase: import("@orpc/server").ImplementedProcedure<GameServicesOrpcContext & object, object, import("@orpc/contract").Schema<VerifyPurchaseRequest, VerifyPurchaseRequest>, import("@orpc/contract").Schema<VerifyPurchaseResponse, VerifyPurchaseResponse>, object>;