@anweather/game-plugin-ssdk 1.9.0 → 1.10.0

package/dist-cjs/runtime/blobClient.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlobStoreError = exports.blobOwner = void 0;
+exports.isVersionConflict = isVersionConflict;
+exports.createBlobClient = createBlobClient;
+exports.casUpdate = casUpdate;
+exports.blobOwner = {
+    save: (saveFileId) => `save:${saveFileId}`,
+    player: (participantId) => `player:${participantId}`,
+    world: (worldId) => `world:${worldId}`,
+};
+class BlobStoreError extends Error {
+    type;
+    status;
+    details;
+    constructor(type, status, details) {
+        super(`${type}: ${String(details.message ?? status)}`);
+        this.type = type;
+        this.status = status;
+        this.details = details;
+        this.name = "BlobStoreError";
+    }
+}
+exports.BlobStoreError = BlobStoreError;
+function isVersionConflict(e) {
+    return e instanceof BlobStoreError && e.type === "VersionConflict";
+}
+const ERROR_TYPES = new Set([
+    "VersionConflict", "BlobTooLarge", "BlobQuotaExceeded", "BlobOwnerNotFound", "InvalidBlobRequest", "PluginUnauthorized",
+]);
+function createBlobClient(options) {
+    const doFetch = options.fetchImpl ?? fetch;
+    const timeoutMs = options.timeoutMs ?? 5000;
+    const root = `${options.platformUrl}/internal/plugins/${encodeURIComponent(options.gameType)}/blobs`;
+    async function call(method, path, body) {
+        const headers = {};
+        if (options.authToken)
+            headers["X-Plugin-Auth"] = `Bearer ${options.authToken}`;
+        if (body !== undefined)
+            headers["Content-Type"] = "application/json";
+        const res = await doFetch(`${root}/${path}`, {
+            method,
+            headers,
+            body: body === undefined ? undefined : JSON.stringify(body),
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        const text = await res.text();
+        const parsed = text ? JSON.parse(text) : {};
+        if (res.ok)
+            return parsed;
+        const type = (res.headers.get("X-Amzn-Errortype") ?? parsed.__type ?? "");
+        if (ERROR_TYPES.has(type))
+            throw new BlobStoreError(type, res.status, parsed);
+        throw new Error(`blob store ${method} ${path}: ${res.status} ${text.slice(0, 200)}`);
+    }
+    const at = (owner, key) => key === undefined ? encodeURIComponent(owner) : `${encodeURIComponent(owner)}/${encodeURIComponent(key)}`;
+    return {
+        get: (owner, key) => call("GET", at(owner, key)),
+        put: (owner, key, value, expectedVersion) => call("PUT", at(owner, key), { value, expectedVersion }),
+        delete: (owner, key, expectedVersion) => call("DELETE", at(owner, key) + (expectedVersion === undefined ? "" : `?expectedVersion=${expectedVersion}`)),
+        batchGet: async (owner, keys) => (await call("POST", `${at(owner)}/batch-get`, { keys })).items,
+        batchPut: async (owner, writes) => (await call("POST", `${at(owner)}/batch-put`, { writes })).items,
+        list: (owner) => call("GET", at(owner)),
+    };
+}
+async function casUpdate(client, owner, key, change, maxAttempts = 5) {
+    for (let attempt = 1;; attempt++) {
+        const current = await client.get(owner, key);
+        const next = change(current.version === 0 ? undefined : current.value);
+        if (next === undefined)
+            return { value: current.value, version: current.version };
+        try {
+            const { version } = await client.put(owner, key, next, current.version);
+            return { value: next, version };
+        }
+        catch (e) {
+            if (!isVersionConflict(e) || attempt >= maxAttempts)
+                throw e;
+        }
+    }
+}

package/dist-cjs/runtime/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runtimeVersion = exports.PLUGIN_PROTOCOL_VERSION = exports.assertConformance = exports.runConformance = exports.createRegistrationLoop = exports.createPluginApp = exports.servePlugin = exports.createGamePluginService = exports.mountSsdkHandler = void 0;
+exports.isVersionConflict = exports.BlobStoreError = exports.blobOwner = exports.casUpdate = exports.createBlobClient = exports.runtimeVersion = exports.PLUGIN_PROTOCOL_VERSION = exports.assertConformance = exports.runConformance = exports.createRegistrationLoop = exports.createPluginApp = exports.servePlugin = exports.createGamePluginService = exports.mountSsdkHandler = void 0;
 var express_1 = require("./express");
 Object.defineProperty(exports, "mountSsdkHandler", { enumerable: true, get: function () { return express_1.mountSsdkHandler; } });
 var defaultService_1 = require("./defaultService");
@@ -16,3 +16,9 @@ Object.defineProperty(exports, "assertConformance", { enumerable: true, get: fun
 var version_1 = require("./version");
 Object.defineProperty(exports, "PLUGIN_PROTOCOL_VERSION", { enumerable: true, get: function () { return version_1.PLUGIN_PROTOCOL_VERSION; } });
 Object.defineProperty(exports, "runtimeVersion", { enumerable: true, get: function () { return version_1.runtimeVersion; } });
+var blobClient_1 = require("./blobClient");
+Object.defineProperty(exports, "createBlobClient", { enumerable: true, get: function () { return blobClient_1.createBlobClient; } });
+Object.defineProperty(exports, "casUpdate", { enumerable: true, get: function () { return blobClient_1.casUpdate; } });
+Object.defineProperty(exports, "blobOwner", { enumerable: true, get: function () { return blobClient_1.blobOwner; } });
+Object.defineProperty(exports, "BlobStoreError", { enumerable: true, get: function () { return blobClient_1.BlobStoreError; } });
+Object.defineProperty(exports, "isVersionConflict", { enumerable: true, get: function () { return blobClient_1.isVersionConflict; } });