@mpgd/platform 0.10.0 → 0.12.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type PlatformTarget = 'browser' | 'microsoft-store' | 'android' | 'ios' | 'ait' | 'reddit' | 'verse8' | 'telegram' | 'tauri';
+export type PlatformTarget = 'browser' | 'microsoft-store' | 'android' | 'ios' | 'ait' | 'reddit' | 'verse8' | 'telegram' | 'tauri' | 'wechat' | 'tiktok';
 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';
@@ -24,6 +24,28 @@ export interface PlatformEvidenceEnvelope {
   readonly schema: string;
   readonly payload: Readonly<Record<string, string | number | boolean>>;
 }
+export interface PlatformOperationFailure {
+  readonly code: string;
+  readonly retryable: boolean;
+}
+/**
+* Provider-neutral error raised when a platform bridge rejects an operation.
+*
+* Adapters preserve a stable, non-sensitive code and retry hint so game UI can
+* distinguish configuration, environment, and transient failures without
+* importing a provider SDK or parsing localized error messages.
+*/
+export declare class PlatformOperationError extends Error implements PlatformOperationFailure {
+  readonly name = "PlatformOperationError";
+  readonly code: string;
+  readonly retryable: boolean;
+  constructor(input?: Readonly<{
+    readonly code?: unknown;
+    readonly message?: unknown;
+    readonly retryable?: unknown;
+  }>);
+}
+export declare function readPlatformOperationFailure(error: unknown): PlatformOperationFailure | null;
 export interface PurchaseResult {
   readonly status: 'completed' | 'cancelled' | 'pending' | 'failed';
   readonly transactionId?: string;

package/dist/index.js

@@ -1,3 +1,46 @@
+/**
+ * Provider-neutral error raised when a platform bridge rejects an operation.
+ *
+ * Adapters preserve a stable, non-sensitive code and retry hint so game UI can
+ * distinguish configuration, environment, and transient failures without
+ * importing a provider SDK or parsing localized error messages.
+ */
+export class PlatformOperationError extends Error {
+    name = 'PlatformOperationError';
+    code;
+    retryable;
+    constructor(input) {
+        const diagnostics = input ?? {};
+        super(typeof diagnostics.message === 'string'
+            ? diagnostics.message
+            : 'The platform operation failed.');
+        this.code = normalizePlatformOperationCode(diagnostics.code);
+        this.retryable = diagnostics.retryable === true;
+    }
+}
+export function readPlatformOperationFailure(error) {
+    if (error instanceof PlatformOperationError) {
+        return { code: error.code, retryable: error.retryable };
+    }
+    if (typeof error !== 'object' || error === null || Array.isArray(error)) {
+        return null;
+    }
+    const record = error;
+    return typeof record.code === 'string'
+        && isPlatformOperationCode(record.code)
+        && typeof record.retryable === 'boolean'
+        ? { code: record.code, retryable: record.retryable }
+        : null;
+}
+function normalizePlatformOperationCode(code) {
+    return isPlatformOperationCode(code) ? code : 'PLATFORM_OPERATION_FAILED';
+}
+function isPlatformOperationCode(code) {
+    return typeof code === 'string'
+        && code.length > 0
+        && code.length <= 128
+        && /^[A-Z][A-Z0-9_:-]*$/u.test(code);
+}
 export function resolveShareCompletion(result) {
     if (result.status !== 'shared') {
         return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/platform",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Shared platform gateway, monetization, ads, leaderboard, identity, lifecycle, and storage contracts for mpgd games.",
   "license": "MIT",
   "repository": {