@oyna360/game-sdk 0.6.3 → 0.7.1

package/dist/index.js

@@ -12,14 +12,21 @@ exports.unlockAchievement = unlockAchievement;
 exports.getAchievements = getAchievements;
 exports.getWallet = getWallet;
 exports.convertGems = convertGems;
+exports.getProducts = getProducts;
+exports.purchaseProduct = purchaseProduct;
+exports.getPurchaseStatus = getPurchaseStatus;
+exports.getPurchaseReceipts = getPurchaseReceipts;
+exports.getInventory = getInventory;
+exports.consumeItem = consumeItem;
+exports.getExchangeStatus = getExchangeStatus;
 exports.endSession = endSession;
 const types_1 = require("./types");
 Object.defineProperty(exports, "SDK_VERSION", { enumerable: true, get: function () { return types_1.SDK_VERSION; } });
 const DEFAULT_INIT_TIMEOUT_MS = 10_000;
 const IFRAME_PROBE_MS = 400;
 const DEFAULT_REQUEST_TIMEOUT_MS = 10_000;
-const DEV_AUTH_MESSAGE = 'oyna360:dev-auth';
-const DEV_CODE_QUERY = 'oyna_dev_code';
+const DEV_AUTH_MESSAGE = "oyna360:dev-auth";
+const DEV_CODE_QUERY = "oyna_dev_code";
 let initPayload = null;
 /** Origin of the platform parent after the first trusted iframe message. */
 let trustedPlatformOrigin = null;
@@ -28,14 +35,14 @@ let directPlatformUrl = null;
 const initWaiters = [];
 function isEmbeddedInPlatform() {
     try {
-        return typeof window !== 'undefined' && window.parent !== window;
+        return typeof window !== "undefined" && window.parent !== window;
     }
     catch {
         return true;
     }
 }
 function rememberDirectPlatformUrl(url) {
-    const trimmed = url.replace(/\/$/, '');
+    const trimmed = url.replace(/\/$/, "");
     if (trimmed)
         directPlatformUrl = trimmed;
 }
@@ -50,17 +57,17 @@ function asInitPayload(message) {
     };
 }
 function isCompleteInit(data) {
-    if (!data || typeof data !== 'object')
+    if (!data || typeof data !== "object")
         return false;
     const m = data;
-    return (m.type === 'platform:init' &&
+    return (m.type === "platform:init" &&
         !!m.session?.token &&
         !!m.user?.id &&
         !!m.game?.slug &&
         !!m.avatar?.presetKey);
 }
 function rememberTrustedOrigin(origin) {
-    if (!trustedPlatformOrigin && origin && origin !== 'null') {
+    if (!trustedPlatformOrigin && origin && origin !== "null") {
         trustedPlatformOrigin = origin;
     }
 }
@@ -70,7 +77,7 @@ function rememberTrustedOrigin(origin) {
 function getParentMessageTarget() {
     if (trustedPlatformOrigin)
         return trustedPlatformOrigin;
-    if (typeof window !== 'undefined') {
+    if (typeof window !== "undefined") {
         const raw = window.__OYNA360_DEV__?.platformWebUrl;
         if (raw) {
             try {
@@ -81,7 +88,7 @@ function getParentMessageTarget() {
             }
         }
         try {
-            if (typeof document !== 'undefined' && document.referrer) {
+            if (typeof document !== "undefined" && document.referrer) {
                 return new URL(document.referrer).origin;
             }
         }
@@ -89,7 +96,7 @@ function getParentMessageTarget() {
             /* ignore */
         }
     }
-    return '*';
+    return "*";
 }
 /**
  * Only accept postMessage traffic from the real platform parent.
@@ -97,7 +104,7 @@ function getParentMessageTarget() {
  * here so settleInit → publish → onMessage cannot recurse.
  */
 function isTrustedPlatformMessage(event) {
-    if (typeof window === 'undefined')
+    if (typeof window === "undefined")
         return false;
     if (!isEmbeddedInPlatform())
         return false;
@@ -109,16 +116,16 @@ function isTrustedPlatformMessage(event) {
 }
 /** Publish standard platform:init for lobby-sdk / game listeners (same-window). */
 function publishPlatformInit(payload) {
-    if (typeof window === 'undefined')
+    if (typeof window === "undefined")
         return;
     const message = {
-        type: 'platform:init',
+        type: "platform:init",
         version: types_1.SDK_VERSION,
         ...payload,
     };
     window.__OYNA360_PLATFORM_INIT__ = message;
     window.__OYNA360_PLATFORM_INIT_OK__ = true;
-    window.dispatchEvent(new MessageEvent('message', {
+    window.dispatchEvent(new MessageEvent("message", {
         data: message,
         origin: window.location.origin,
     }));
@@ -142,16 +149,18 @@ function onMessage(event) {
     const data = event.data;
     if (!isCompleteInit(data)) {
         // Production parent may send init; accept even if avatar missing for backward compat
-        if (!data || typeof data !== 'object' || data.type !== 'platform:init') {
+        if (!data ||
+            typeof data !== "object" ||
+            data.type !== "platform:init") {
             return;
         }
         const message = data;
         if (!message.session?.token || !message.user?.id || !message.game?.slug)
             return;
         const avatar = message.avatar ?? {
-            presetId: 'default',
-            presetKey: 'default-1',
-            presetKind: 'procedural',
+            presetId: "default",
+            presetKey: "default-1",
+            presetKind: "procedural",
             customConfig: {},
         };
         rememberTrustedOrigin(event.origin);
@@ -165,14 +174,14 @@ function onMessage(event) {
     settleInit(asInitPayload(data));
 }
 function signalReady() {
-    if (typeof window === 'undefined')
+    if (typeof window === "undefined")
         return;
     if (!isEmbeddedInPlatform())
         return;
-    window.parent.postMessage({ type: 'platform:ready' }, getParentMessageTarget());
+    window.parent.postMessage({ type: "platform:ready" }, getParentMessageTarget());
 }
-if (typeof window !== 'undefined') {
-    window.addEventListener('message', onMessage);
+if (typeof window !== "undefined") {
+    window.addEventListener("message", onMessage);
     signalReady();
 }
 function postToPlatform(outboundType, payload, resultType, timeoutMs = DEFAULT_REQUEST_TIMEOUT_MS, stableRequestId) {
@@ -181,23 +190,24 @@ function postToPlatform(outboundType, payload, resultType, timeoutMs = DEFAULT_R
             reject(new Error(`${outboundType} requires the platform iframe parent`));
             return;
         }
-        const requestId = stableRequestId ?? (typeof crypto !== 'undefined' && crypto.randomUUID
-            ? crypto.randomUUID()
-            : `${Date.now()}-${Math.random()}`);
+        const requestId = stableRequestId ??
+            (typeof crypto !== "undefined" && crypto.randomUUID
+                ? crypto.randomUUID()
+                : `${Date.now()}-${Math.random()}`);
         const timer = setTimeout(() => {
-            window.removeEventListener('message', onResult);
-            reject(new Error('Platform SDK request timeout'));
+            window.removeEventListener("message", onResult);
+            reject(new Error("Platform SDK request timeout"));
         }, timeoutMs);
         function onResult(event) {
             if (!isTrustedPlatformMessage(event))
                 return;
             const data = event.data;
-            if (!data || typeof data !== 'object' || data.type !== resultType)
+            if (!data || typeof data !== "object" || data.type !== resultType)
                 return;
             if (data.requestId !== requestId)
                 return;
             clearTimeout(timer);
-            window.removeEventListener('message', onResult);
+            window.removeEventListener("message", onResult);
             rememberTrustedOrigin(event.origin);
             const error = data.error;
             if (error) {
@@ -206,41 +216,41 @@ function postToPlatform(outboundType, payload, resultType, timeoutMs = DEFAULT_R
             }
             resolve(data.result);
         }
-        window.addEventListener('message', onResult);
+        window.addEventListener("message", onResult);
         window.parent.postMessage({ type: outboundType, requestId, ...payload }, getParentMessageTarget());
     });
 }
 function nestErrorMessage(data, fallback) {
-    if (!data || typeof data !== 'object')
+    if (!data || typeof data !== "object")
         return fallback;
     const message = data.message;
-    if (typeof message === 'string')
+    if (typeof message === "string")
         return message;
     if (Array.isArray(message))
-        return message.join(', ');
+        return message.join(", ");
     return fallback;
 }
 /** Direct Development / top-level: call platform REST with the game session token. */
 async function apiRequest(path, options = {}) {
     const base = directPlatformUrl;
     if (!base) {
-        throw new Error('Direct API calls require platformUrl. Pass PlatformSDK.init({ platformUrl, gameSlug }) or window.__OYNA360_DEV__.');
+        throw new Error("Direct API calls require platformUrl. Pass PlatformSDK.init({ platformUrl, gameSlug }) or window.__OYNA360_DEV__.");
     }
     const headers = {
-        Accept: 'application/json',
+        Accept: "application/json",
     };
     if (options.body !== undefined) {
-        headers['Content-Type'] = 'application/json';
+        headers["Content-Type"] = "application/json";
     }
     if (options.auth !== false) {
         const token = initPayload?.session?.token;
         if (!token) {
-            throw new Error('PlatformSDK.init() must complete before calling this API');
+            throw new Error("PlatformSDK.init() must complete before calling this API");
         }
         headers.Authorization = `Bearer ${token}`;
     }
     const response = await fetch(`${base}${path}`, {
-        method: options.method ?? (options.body !== undefined ? 'POST' : 'GET'),
+        method: options.method ?? (options.body !== undefined ? "POST" : "GET"),
         headers,
         body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
     });
@@ -260,19 +270,27 @@ async function markDirectSessionReady() {
     if (!directPlatformUrl || !initPayload?.session?.token)
         return;
     try {
-        await apiRequest('/sessions/ready', { method: 'POST' });
+        await apiRequest("/sessions/ready", { method: "POST" });
     }
     catch {
         // Non-fatal: presence analytics only
     }
 }
 function resolveDevConfig(options) {
-    const fromWindow = typeof window !== 'undefined' ? window.__OYNA360_DEV__ : undefined;
-    const platformUrl = (options?.platformUrl || fromWindow?.platformUrl || '').replace(/\/$/, '');
-    const gameSlug = (options?.gameSlug || fromWindow?.gameSlug || '').trim();
-    const clientId = (options?.dev?.clientId || fromWindow?.clientId || '').trim();
-    const credential = (options?.dev?.credential || fromWindow?.credential || '').trim();
-    let platformWebUrl = (options?.platformWebUrl || fromWindow?.platformWebUrl || '').replace(/\/$/, '');
+    const fromWindow = typeof window !== "undefined" ? window.__OYNA360_DEV__ : undefined;
+    const platformUrl = (options?.platformUrl ||
+        fromWindow?.platformUrl ||
+        "").replace(/\/$/, "");
+    const gameSlug = (options?.gameSlug || fromWindow?.gameSlug || "").trim();
+    const clientId = (options?.dev?.clientId ||
+        fromWindow?.clientId ||
+        "").trim();
+    const credential = (options?.dev?.credential ||
+        fromWindow?.credential ||
+        "").trim();
+    let platformWebUrl = (options?.platformWebUrl ||
+        fromWindow?.platformWebUrl ||
+        "").replace(/\/$/, "");
     if (!platformWebUrl && platformUrl) {
         try {
             // Same host as API by default (production reverse-proxy). Locally set platformWebUrl explicitly
@@ -280,7 +298,7 @@ function resolveDevConfig(options) {
             platformWebUrl = new URL(platformUrl).origin;
         }
         catch {
-            platformWebUrl = '';
+            platformWebUrl = "";
         }
     }
     return { platformUrl, platformWebUrl, gameSlug, clientId, credential };
@@ -288,41 +306,41 @@ function resolveDevConfig(options) {
 async function runCredentialGatewayBootstrap(options) {
     const { platformUrl, clientId, credential } = resolveDevConfig(options);
     if (!platformUrl || !clientId || !credential) {
-        throw new Error('Developer Environment requires platformUrl + dev.clientId + dev.credential. ' +
-            'Create them at /developer and pass PlatformSDK.init({ platformUrl, dev: { clientId, credential } }).');
+        throw new Error("Developer Environment requires platformUrl + dev.clientId + dev.credential. " +
+            "Create them at /developer and pass PlatformSDK.init({ platformUrl, dev: { clientId, credential } }).");
     }
     rememberDirectPlatformUrl(platformUrl);
     const origin = window.location.origin;
     const response = await fetch(`${platformUrl}/dev/gateway/session`, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
         body: JSON.stringify({ clientId, credential, origin }),
     });
     const data = await response.json().catch(() => ({}));
     if (!response.ok) {
-        const msg = typeof data.message === 'string'
+        const msg = typeof data.message === "string"
             ? data.message
             : Array.isArray(data.message)
-                ? data.message.join(', ')
-                : 'Dev gateway session failed';
+                ? data.message.join(", ")
+                : "Dev gateway session failed";
         throw new Error(msg);
     }
     const payload = data;
     if (!payload?.session?.token || !payload.avatar || !payload.lobby?.wsUrl) {
-        throw new Error('Invalid SdkInitPayload from dev gateway');
+        throw new Error("Invalid SdkInitPayload from dev gateway");
     }
     return payload;
 }
 function readCodeFromUrl() {
-    if (typeof window === 'undefined')
+    if (typeof window === "undefined")
         return null;
     try {
         const url = new URL(window.location.href);
         const code = url.searchParams.get(DEV_CODE_QUERY);
         if (code) {
             url.searchParams.delete(DEV_CODE_QUERY);
-            url.searchParams.delete('oyna_dev_slug');
-            window.history.replaceState({}, '', url.toString());
+            url.searchParams.delete("oyna_dev_slug");
+            window.history.replaceState({}, "", url.toString());
         }
         return code;
     }
@@ -332,22 +350,22 @@ function readCodeFromUrl() {
 }
 async function exchangeDevCode(platformUrl, code, gameOrigin) {
     const response = await fetch(`${platformUrl}/dev/game-auth/exchange`, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
         body: JSON.stringify({ code, gameOrigin }),
     });
     const data = await response.json().catch(() => ({}));
     if (!response.ok) {
-        const msg = typeof data.message === 'string'
+        const msg = typeof data.message === "string"
             ? data.message
             : Array.isArray(data.message)
-                ? data.message.join(', ')
-                : 'Development authorization exchange failed';
+                ? data.message.join(", ")
+                : "Development authorization exchange failed";
         throw new Error(msg);
     }
     const payload = data;
     if (!payload?.session?.token || !payload.avatar || !payload.lobby?.wsUrl) {
-        throw new Error('Invalid SdkInitPayload from development exchange');
+        throw new Error("Invalid SdkInitPayload from development exchange");
     }
     return payload;
 }
@@ -356,13 +374,13 @@ function openDevAuthorizePopup(authUrl) {
     const height = 720;
     const left = Math.max(0, Math.floor(window.screenX + (window.outerWidth - width) / 2));
     const top = Math.max(0, Math.floor(window.screenY + (window.outerHeight - height) / 2));
-    return window.open(authUrl, 'oyna360-dev-auth', `popup=yes,width=${width},height=${height},left=${left},top=${top}`);
+    return window.open(authUrl, "oyna360-dev-auth", `popup=yes,width=${width},height=${height},left=${left},top=${top}`);
 }
 async function runDirectDevelopmentBootstrap(options) {
     const { platformUrl, platformWebUrl, gameSlug } = resolveDevConfig(options);
     if (!platformUrl || !gameSlug || !platformWebUrl) {
-        throw new Error('Direct Development Mode requires platformUrl + gameSlug (and platformWebUrl). ' +
-            'Set PlatformSDK.init({ platformUrl, gameSlug }) or window.__OYNA360_DEV__.');
+        throw new Error("Direct Development Mode requires platformUrl + gameSlug (and platformWebUrl). " +
+            "Set PlatformSDK.init({ platformUrl, gameSlug }) or window.__OYNA360_DEV__.");
     }
     rememberDirectPlatformUrl(platformUrl);
     const gameOrigin = window.location.origin;
@@ -370,17 +388,18 @@ async function runDirectDevelopmentBootstrap(options) {
     if (existingCode) {
         return exchangeDevCode(platformUrl, existingCode, gameOrigin);
     }
-    const returnPath = `${window.location.pathname}${window.location.search}${window.location.hash}` || '/';
-    const authUrl = new URL('/dev/game-auth', platformWebUrl);
-    authUrl.searchParams.set('slug', gameSlug);
-    authUrl.searchParams.set('origin', gameOrigin);
-    authUrl.searchParams.set('return', returnPath.startsWith('/') ? returnPath : '/');
+    const returnPath = `${window.location.pathname}${window.location.search}${window.location.hash}` ||
+        "/";
+    const authUrl = new URL("/dev/game-auth", platformWebUrl);
+    authUrl.searchParams.set("slug", gameSlug);
+    authUrl.searchParams.set("origin", gameOrigin);
+    authUrl.searchParams.set("return", returnPath.startsWith("/") ? returnPath : "/");
     return new Promise((resolve, reject) => {
         const timeoutMs = options?.timeout ?? 120_000;
         let settled = false;
         const cleanup = () => {
             window.clearTimeout(timer);
-            window.removeEventListener('message', onAuthMessage);
+            window.removeEventListener("message", onAuthMessage);
         };
         const finish = (payload) => {
             if (settled)
@@ -397,15 +416,15 @@ async function runDirectDevelopmentBootstrap(options) {
             reject(err);
         };
         const timer = window.setTimeout(() => {
-            fail(new Error('Direct Development authorization timed out. Log in on the Oyna360 authorize page and allow popups.'));
+            fail(new Error("Direct Development authorization timed out. Log in on the Oyna360 authorize page and allow popups."));
         }, timeoutMs);
         const onAuthMessage = (event) => {
             const data = event.data;
-            if (!data || typeof data !== 'object')
+            if (!data || typeof data !== "object")
                 return;
             if (data.type !== DEV_AUTH_MESSAGE)
                 return;
-            let expectedOrigin = '';
+            let expectedOrigin = "";
             try {
                 expectedOrigin = new URL(platformWebUrl).origin;
             }
@@ -419,7 +438,7 @@ async function runDirectDevelopmentBootstrap(options) {
                 return;
             void exchangeDevCode(platformUrl, code, gameOrigin).then(finish, fail);
         };
-        window.addEventListener('message', onAuthMessage);
+        window.addEventListener("message", onAuthMessage);
         const popup = openDevAuthorizePopup(authUrl.toString());
         if (!popup) {
             // Popup blocked → full redirect; after login, game reloads with ?oyna_dev_code=
@@ -438,7 +457,7 @@ function waitForIframeInit(timeoutMs) {
             const index = initWaiters.findIndex((w) => w.timer === timer);
             if (index >= 0)
                 initWaiters.splice(index, 1);
-            reject(new Error('Platform SDK init timeout — is the game running inside the platform?'));
+            reject(new Error("Platform SDK init timeout — is the game running inside the platform?"));
         }, timeoutMs);
         initWaiters.push({ resolve, reject, timer });
         signalReady();
@@ -454,8 +473,8 @@ async function init(options) {
     if (initPayload) {
         return initPayload;
     }
-    if (typeof window === 'undefined') {
-        throw new Error('PlatformSDK.init() requires a browser environment');
+    if (typeof window === "undefined") {
+        throw new Error("PlatformSDK.init() requires a browser environment");
     }
     // Pin API base early so Direct Dev feature calls work after init.
     const earlyDev = resolveDevConfig(options);
@@ -472,13 +491,14 @@ async function init(options) {
         }
     }
     // Already delivered by a trusted writer (this SDK or lobby-sdk after origin check)
-    if (window.__OYNA360_PLATFORM_INIT_OK__ && window.__OYNA360_PLATFORM_INIT__?.session?.token) {
+    if (window.__OYNA360_PLATFORM_INIT_OK__ &&
+        window.__OYNA360_PLATFORM_INIT__?.session?.token) {
         const cached = asInitPayload(window.__OYNA360_PLATFORM_INIT__);
         if (!cached.avatar) {
             cached.avatar = {
-                presetId: 'default',
-                presetKey: 'default-1',
-                presetKind: 'procedural',
+                presetId: "default",
+                presetKey: "default-1",
+                presetKind: "procedural",
                 customConfig: {},
             };
         }
@@ -524,11 +544,11 @@ function isReady() {
 async function submitScore(score) {
     const payload = await init();
     if (score < 0 || !Number.isFinite(score)) {
-        throw new Error('Score must be a non-negative number');
+        throw new Error("Score must be a non-negative number");
     }
     const floorScore = Math.floor(score);
-    return callPlatformFeature('platform:score:submit', { sessionToken: payload.session.token, score: floorScore }, 'platform:score:result', () => apiRequest(`/games/${payload.game.slug}/scores`, {
-        method: 'POST',
+    return callPlatformFeature("platform:score:submit", { sessionToken: payload.session.token, score: floorScore }, "platform:score:result", () => apiRequest(`/games/${payload.game.slug}/scores`, {
+        method: "POST",
         body: { score: floorScore },
     }));
 }
@@ -536,63 +556,118 @@ async function submitScore(score) {
 async function getLeaderboard(limit = 20) {
     const payload = await init();
     const safeLimit = Math.min(Math.max(Math.floor(limit) || 20, 1), 100);
-    return callPlatformFeature('platform:leaderboard:get', { limit: safeLimit }, 'platform:leaderboard:result', () => apiRequest(`/games/${payload.game.slug}/leaderboard?limit=${safeLimit}`, { auth: false }));
+    return callPlatformFeature("platform:leaderboard:get", { limit: safeLimit }, "platform:leaderboard:result", () => apiRequest(`/games/${payload.game.slug}/leaderboard?limit=${safeLimit}`, { auth: false }));
 }
 /** Unlock an achievement for the current player. Idempotent. */
 async function unlockAchievement(key) {
     const payload = await init();
     if (!key.trim()) {
-        throw new Error('Achievement key is required');
+        throw new Error("Achievement key is required");
     }
     const achievementKey = key.trim();
-    return callPlatformFeature('platform:achievement:unlock', { sessionToken: payload.session.token, key: achievementKey }, 'platform:achievement:unlock:result', () => apiRequest(`/games/${payload.game.slug}/achievements/unlock`, {
-        method: 'POST',
+    return callPlatformFeature("platform:achievement:unlock", { sessionToken: payload.session.token, key: achievementKey }, "platform:achievement:unlock:result", () => apiRequest(`/games/${payload.game.slug}/achievements/unlock`, {
+        method: "POST",
         body: { key: achievementKey },
     }));
 }
 /** List achievements with unlock status for the current player. */
 async function getAchievements() {
     const payload = await init();
-    return callPlatformFeature('platform:achievements:get', {}, 'platform:achievements:result', () => apiRequest(`/games/${payload.game.slug}/achievements/me`));
+    return callPlatformFeature("platform:achievements:get", {}, "platform:achievements:result", () => apiRequest(`/games/${payload.game.slug}/achievements/me`));
 }
 /** Platform gem balance + coins-per-gem rate for this game. */
 async function getWallet() {
     const payload = await init();
-    return callPlatformFeature('platform:wallet:get', {}, 'platform:wallet:result', () => apiRequest(`/games/${payload.game.slug}/wallet`));
+    return callPlatformFeature("platform:wallet:get", {}, "platform:wallet:result", () => apiRequest(`/games/${payload.game.slug}/wallet`));
 }
 /**
  * Convert platform gems into in-game coins.
  * Platform deducts gems; the game must credit `coinsReceived` to its own economy.
  */
-async function convertGems(gems, requestId) {
+function operationId(value) {
+    const id = value ??
+        (typeof crypto !== "undefined" && crypto.randomUUID
+            ? crypto.randomUUID()
+            : Date.now().toString(36) + "-" + Math.random().toString(36).slice(2));
+    if (!/^[A-Za-z0-9_-]{8,128}$/.test(id))
+        throw new Error("requestId must contain 8-128 ASCII letters, digits, underscores or hyphens");
+    return id;
+}
+function requiredOperationId(value) {
+    if (typeof value !== "string")
+        throw new Error("requestId is required");
+    return operationId(value);
+}
+function itemKey(value) {
+    if (!/^[A-Za-z0-9:_-]{1,100}$/.test(value))
+        throw new Error("Invalid item ID");
+    return value;
+}
+async function commerce(operation, args = {}) {
     const payload = await init();
-    if (!Number.isInteger(gems) || gems < 1) {
-        throw new Error('gems must be a positive integer');
-    }
-    if (requestId !== undefined && !/^[A-Za-z0-9_-]{8,128}$/.test(requestId)) {
-        throw new Error('requestId must contain 8-128 ASCII letters, digits, underscores or hyphens');
-    }
-    return callPlatformFeature('platform:gems:exchange', { sessionToken: payload.session.token, gems }, 'platform:gems:exchange:result', () => apiRequest(`/games/${payload.game.slug}/wallet/exchange`, {
-        method: 'POST',
-        body: { gems, requestId },
-    }), requestId);
+    return callPlatformFeature("platform:commerce:request", { operation, args }, "platform:commerce:result", () => apiRequest(`/games/${encodeURIComponent(payload.game.slug)}/commerce`, { method: "POST", body: { operation, args } }));
+}
+async function convertGems(gems, requestId) {
+    if (!Number.isSafeInteger(gems) || gems < 1)
+        throw new Error("gems must be a positive safe integer");
+    return commerce("exchange", {
+        gems,
+        requestId: operationId(requestId),
+    });
+}
+function getProducts() {
+    return commerce("products");
+}
+/** Persist requestId before sending and reuse it when recovering/retrying the same purchase. */
+function purchaseProduct(itemId, requestId) {
+    return commerce("purchase", {
+        itemId: itemKey(itemId),
+        requestId: operationId(requestId),
+    });
+}
+function getPurchaseStatus(requestId) {
+    return commerce("purchaseStatus", {
+        requestId: requiredOperationId(requestId),
+    });
+}
+function getPurchaseReceipts(cursor) {
+    if (cursor !== undefined && !/^[A-Za-z0-9-]{1,100}$/.test(cursor))
+        throw new Error("Invalid receipt cursor");
+    return commerce("receipts", cursor ? { cursor } : {});
+}
+function getInventory() {
+    return commerce("inventory");
+}
+function consumeItem(itemId, quantity, requestId) {
+    if (!Number.isSafeInteger(quantity) || quantity < 1)
+        throw new Error("quantity must be a positive safe integer");
+    return commerce("consume", {
+        itemId: itemKey(itemId),
+        quantity,
+        requestId: operationId(requestId),
+    });
+}
+function getExchangeStatus(requestId) {
+    return commerce("exchangeStatus", {
+        requestId: requiredOperationId(requestId),
+    });
 }
 async function endSession() {
     const token = initPayload?.session.token;
-    if (!token || typeof window === 'undefined')
+    if (!token || typeof window === "undefined")
         return;
     if (isEmbeddedInPlatform()) {
         const target = getParentMessageTarget();
         window.parent.postMessage({
-            type: 'platform:session:end',
+            type: "platform:session:end",
             sessionToken: token,
         }, target);
         return;
     }
     if (directPlatformUrl) {
         try {
-            await apiRequest('/sessions/end', {
-                method: 'POST',
+            await apiRequest("/sessions/end", {
+                method: "POST",
                 body: { token },
                 auth: false,
             });
@@ -615,6 +690,13 @@ exports.PlatformSDK = {
     getAchievements,
     getWallet,
     convertGems,
+    getProducts,
+    purchaseProduct,
+    getPurchaseStatus,
+    getPurchaseReceipts,
+    getInventory,
+    consumeItem,
+    getExchangeStatus,
     endSession,
 };
 exports.default = exports.PlatformSDK;