@anweather/game-plugin-ssdk 1.17.0 → 1.18.0

package/dist-cjs/runtime/blobClient.js

@@ -3,11 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BlobStoreError = exports.blobOwner = void 0;
 exports.isVersionConflict = isVersionConflict;
 exports.createBlobClient = createBlobClient;
+exports.allBlobOwners = allBlobOwners;
 exports.casUpdate = casUpdate;
 exports.blobOwner = {
     save: (saveFileId) => `save:${saveFileId}`,
     player: (participantId) => `player:${participantId}`,
     world: (worldId) => `world:${worldId}`,
+    space: (spaceId) => `space:${spaceId}`,
 };
 class BlobStoreError extends Error {
     type;
@@ -31,7 +33,7 @@ const ERROR_TYPES = new Set([
 function createBlobClient(options) {
     const doFetch = options.fetchImpl ?? fetch;
     const timeoutMs = options.timeoutMs ?? 5000;
-    const root = `${options.platformUrl}/internal/plugins/${encodeURIComponent(options.gameType)}/blobs`;
+    const root = `${options.platformUrl}/internal/plugins/${encodeURIComponent(options.gameType)}`;
     async function call(method, path, body) {
         const headers = {};
         if (options.authToken)
@@ -53,7 +55,7 @@ function createBlobClient(options) {
             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)}`;
+    const at = (owner, key) => key === undefined ? `blobs/${encodeURIComponent(owner)}` : `blobs/${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 }),
@@ -61,8 +63,24 @@ function createBlobClient(options) {
         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)),
+        listOwners: (prefix = "", page = {}) => {
+            const query = new URLSearchParams({ prefix });
+            if (page.after !== undefined)
+                query.set("after", page.after);
+            if (page.limit !== undefined)
+                query.set("limit", String(page.limit));
+            return call("GET", `blob-owners?${query}`);
+        },
     };
 }
+async function* allBlobOwners(client, prefix = "", pageSize) {
+    let after;
+    do {
+        const page = await client.listOwners(prefix, { after, limit: pageSize });
+        yield* page.owners;
+        after = page.nextToken;
+    } while (after !== undefined);
+}
 async function casUpdate(client, owner, key, change, maxAttempts = 5) {
     for (let attempt = 1;; attempt++) {
         const current = await client.get(owner, key);

package/dist-cjs/runtime/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_LINK_FRAME_BYTES = exports.LinkCloseCode = exports.LIVE_PATH = exports.LIVE_PROTOCOL_VERSION = exports.assertLiveConformance = exports.runLiveConformance = exports.loadRoomCheckpoint = exports.createLiveHarness = exports.attachLive = 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;
+exports.MAX_MEMBERSHIP_AGE_MS = exports.FakeSpaceClient = exports.NotASpaceMemberError = exports.SpaceApiError = exports.isAlreadyASpace = exports.createMembershipGuard = exports.createSpaceClient = exports.MAX_LINK_FRAME_BYTES = exports.LinkCloseCode = exports.LIVE_PATH = exports.LIVE_PROTOCOL_VERSION = exports.assertLiveConformance = exports.runLiveConformance = exports.loadRoomCheckpoint = exports.createLiveHarness = exports.attachLive = exports.isVersionConflict = exports.BlobStoreError = exports.allBlobOwners = 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");
@@ -20,6 +20,7 @@ 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, "allBlobOwners", { enumerable: true, get: function () { return blobClient_1.allBlobOwners; } });
 Object.defineProperty(exports, "BlobStoreError", { enumerable: true, get: function () { return blobClient_1.BlobStoreError; } });
 Object.defineProperty(exports, "isVersionConflict", { enumerable: true, get: function () { return blobClient_1.isVersionConflict; } });
 var server_1 = require("./live/server");
@@ -36,3 +37,11 @@ Object.defineProperty(exports, "LIVE_PROTOCOL_VERSION", { enumerable: true, get:
 Object.defineProperty(exports, "LIVE_PATH", { enumerable: true, get: function () { return protocol_1.LIVE_PATH; } });
 Object.defineProperty(exports, "LinkCloseCode", { enumerable: true, get: function () { return protocol_1.LinkCloseCode; } });
 Object.defineProperty(exports, "MAX_LINK_FRAME_BYTES", { enumerable: true, get: function () { return protocol_1.MAX_LINK_FRAME_BYTES; } });
+var spaceClient_1 = require("./spaceClient");
+Object.defineProperty(exports, "createSpaceClient", { enumerable: true, get: function () { return spaceClient_1.createSpaceClient; } });
+Object.defineProperty(exports, "createMembershipGuard", { enumerable: true, get: function () { return spaceClient_1.createMembershipGuard; } });
+Object.defineProperty(exports, "isAlreadyASpace", { enumerable: true, get: function () { return spaceClient_1.isAlreadyASpace; } });
+Object.defineProperty(exports, "SpaceApiError", { enumerable: true, get: function () { return spaceClient_1.SpaceApiError; } });
+Object.defineProperty(exports, "NotASpaceMemberError", { enumerable: true, get: function () { return spaceClient_1.NotASpaceMemberError; } });
+Object.defineProperty(exports, "FakeSpaceClient", { enumerable: true, get: function () { return spaceClient_1.FakeSpaceClient; } });
+Object.defineProperty(exports, "MAX_MEMBERSHIP_AGE_MS", { enumerable: true, get: function () { return spaceClient_1.MAX_MEMBERSHIP_AGE_MS; } });

package/dist-cjs/runtime/spaceClient.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FakeSpaceClient = exports.NotASpaceMemberError = exports.MAX_MEMBERSHIP_AGE_MS = exports.SpaceApiError = void 0;
+exports.isAlreadyASpace = isAlreadyASpace;
+exports.createSpaceClient = createSpaceClient;
+exports.createMembershipGuard = createMembershipGuard;
+class SpaceApiError 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 = "SpaceApiError";
+    }
+}
+exports.SpaceApiError = SpaceApiError;
+function isAlreadyASpace(e) {
+    return e instanceof SpaceApiError && e.type === "SpaceAlreadyExists";
+}
+const ERROR_TYPES = new Set([
+    "SpaceNotFound", "InvalidSpaceImport", "SpaceImportDisabled", "SpaceAlreadyExists", "InviteCodeTaken", "PluginUnauthorized",
+]);
+function createSpaceClient(options) {
+    const doFetch = options.fetchImpl ?? fetch;
+    const timeoutMs = options.timeoutMs ?? 5000;
+    const base = `${options.platformUrl}/internal/plugins/${encodeURIComponent(options.gameType)}`;
+    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(`${base}/${path}`, {
+            method,
+            headers,
+            body: body === undefined ? undefined : JSON.stringify(body),
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        const text = await res.text();
+        let parsed = {};
+        try {
+            parsed = text ? JSON.parse(text) : {};
+        }
+        catch {
+        }
+        if (res.ok)
+            return parsed;
+        const type = (res.headers.get("X-Amzn-Errortype") ?? parsed.__type ?? "");
+        if (ERROR_TYPES.has(type))
+            throw new SpaceApiError(type, res.status, parsed);
+        throw new Error(`spaces ${method} ${path}: ${res.status} ${text.slice(0, 200)}`);
+    }
+    return {
+        get: async (spaceId) => {
+            try {
+                return await call("GET", `spaces/${encodeURIComponent(spaceId)}`);
+            }
+            catch (e) {
+                if (e instanceof SpaceApiError && e.type === "SpaceNotFound")
+                    return null;
+                throw e;
+            }
+        },
+        import: (spaceId, body) => call("PUT", `spaces/${encodeURIComponent(spaceId)}/import`, body),
+        counts: () => call("GET", "space-counts"),
+    };
+}
+exports.MAX_MEMBERSHIP_AGE_MS = 15_000;
+class NotASpaceMemberError extends Error {
+    spaceId;
+    playerId;
+    constructor(spaceId, playerId) {
+        super(`${playerId} is not an ACTIVE member of Space ${spaceId}`);
+        this.spaceId = spaceId;
+        this.playerId = playerId;
+        this.name = "NotASpaceMemberError";
+    }
+}
+exports.NotASpaceMemberError = NotASpaceMemberError;
+function createMembershipGuard(client, options = {}) {
+    const maxAgeMs = Math.min(options.maxAgeMs ?? exports.MAX_MEMBERSHIP_AGE_MS, exports.MAX_MEMBERSHIP_AGE_MS);
+    const now = options.now ?? Date.now;
+    const cache = new Map();
+    function space(spaceId) {
+        const t = now();
+        const cached = cache.get(spaceId);
+        if (cached && t - cached.at < maxAgeMs)
+            return cached.read;
+        for (const [id, entry] of cache)
+            if (t - entry.at >= maxAgeMs)
+                cache.delete(id);
+        const read = client.get(spaceId);
+        cache.set(spaceId, { at: t, read });
+        const forget = () => {
+            if (cache.get(spaceId)?.read === read)
+                cache.delete(spaceId);
+        };
+        read.then((s) => { if (s === null)
+            forget(); }, forget);
+        return read;
+    }
+    const isMember = (s, playerId) => s !== null && s.members.some((m) => m.playerId === playerId && m.status === "ACTIVE");
+    return {
+        space,
+        isActiveMember: async (spaceId, playerId) => isMember(await space(spaceId), playerId),
+        assertActiveMember: async (spaceId, playerId) => {
+            const s = await space(spaceId);
+            if (!isMember(s, playerId))
+                throw new NotASpaceMemberError(spaceId, playerId);
+            return s;
+        },
+        invalidate: (spaceId) => (spaceId === undefined ? cache.clear() : void cache.delete(spaceId)),
+    };
+}
+class FakeSpaceClient {
+    options;
+    spaces = new Map();
+    calls = [];
+    names = new Map();
+    importEnabled = true;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    add(space) {
+        const at = new Date(0).toISOString();
+        this.spaces.set(space.id, {
+            space: { id: space.id, name: space.name ?? "Space", ownerId: space.ownerId, settings: space.settings ?? {}, archived: false, revision: 1 },
+            inviteCode: space.inviteCode ? normalizeCode(space.inviteCode) : null,
+            members: new Map([[space.ownerId, { playerId: space.ownerId, role: "OWNER", status: "ACTIVE", joinedAt: at, statusAt: at }]]),
+        });
+    }
+    setStatus(spaceId, playerId, status) {
+        const s = this.spaces.get(spaceId);
+        if (!s)
+            throw new Error(`no Space ${spaceId}`);
+        const at = new Date().toISOString();
+        const current = s.members.get(playerId);
+        s.members.set(playerId, current ? { ...current, status, statusAt: at } : { playerId, role: "MEMBER", status, joinedAt: at, statusAt: at });
+        s.space.revision++;
+        s.imported = undefined;
+    }
+    archive(spaceId) {
+        const s = this.spaces.get(spaceId);
+        if (!s)
+            throw new Error(`no Space ${spaceId}`);
+        s.space.archived = true;
+        s.space.revision++;
+        s.imported = undefined;
+    }
+    async get(spaceId) {
+        this.calls.push(`get ${spaceId}`);
+        const s = this.spaces.get(spaceId);
+        return s ? this.view(s) : null;
+    }
+    async import(spaceId, body) {
+        this.calls.push(`import ${spaceId}`);
+        const refuse = (type, status, details = {}) => {
+            throw new SpaceApiError(type, status, { message: type, ...details });
+        };
+        if (!this.importEnabled)
+            refuse("SpaceImportDisabled", 403);
+        const owners = body.members.filter((m) => m.role === "OWNER");
+        if (owners.length !== 1 || owners[0].playerId !== body.ownerId || owners[0].status !== "ACTIVE") {
+            refuse("InvalidSpaceImport", 400, { message: "exactly one ACTIVE OWNER, who is ownerId" });
+        }
+        const code = body.inviteCode ? normalizeCode(body.inviteCode) : null;
+        const key = JSON.stringify({ ...body, inviteCode: code, settings: body.settings ?? {} });
+        const existing = this.spaces.get(spaceId);
+        if (existing) {
+            if (existing.imported === key)
+                return { created: false, space: this.view(existing) };
+            refuse("SpaceAlreadyExists", 409);
+        }
+        if (this.options.players) {
+            const known = new Set(this.options.players);
+            const unknown = [...new Set([body.ownerId, ...body.members.map((m) => m.playerId)])].filter((p) => !known.has(p));
+            if (unknown.length > 0)
+                refuse("InvalidSpaceImport", 400, { unknownPlayerIds: unknown });
+        }
+        if (code && [...this.spaces.values()].some((s) => s.inviteCode === code))
+            refuse("InviteCodeTaken", 409);
+        const stored = {
+            space: { id: spaceId, name: body.name.trim(), ownerId: body.ownerId, settings: body.settings ?? {}, archived: false, revision: 1 },
+            inviteCode: code,
+            members: new Map(body.members.map((m) => [m.playerId, { ...m }])),
+            imported: key,
+        };
+        this.spaces.set(spaceId, stored);
+        return { created: true, space: this.view(stored) };
+    }
+    async counts() {
+        this.calls.push("counts");
+        const all = [...this.spaces.values()];
+        return {
+            spaces: all.length,
+            inviteCodes: all.filter((s) => s.inviteCode !== null).length,
+            activeMembers: all.reduce((n, s) => n + [...s.members.values()].filter((m) => m.status === "ACTIVE").length, 0),
+        };
+    }
+    view(s) {
+        const members = [...s.members.values()]
+            .filter((m) => m.status === "ACTIVE")
+            .sort((a, b) => (a.role === b.role ? a.joinedAt.localeCompare(b.joinedAt) : a.role === "OWNER" ? -1 : 1))
+            .map((m) => ({ playerId: m.playerId, displayName: this.names.get(m.playerId), role: m.role, status: "ACTIVE" }));
+        return { ...s.space, settings: { ...s.space.settings }, members };
+    }
+}
+exports.FakeSpaceClient = FakeSpaceClient;
+function normalizeCode(code) {
+    return code.toUpperCase().replace(/[\s\-_.]/g, "");
+}

package/dist-cjs/src/models/models_0.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValidateMoveInput = exports.MoveValidation = exports.SelectBotMoveOutput = exports.SelectBotMoveInput = exports.IsOutOfTurnMoveOutput = exports.IsOutOfTurnMoveInput = exports.IsConfigMoveOutput = exports.IsConfigMoveInput = exports.InitializeGameInput = exports.HealthOutput = exports.GetSaveFileEditorStateOutput = exports.GetSaveFileEditorStateInput = exports.GetPlayerViewOutput = exports.GetPlayerViewInput = exports.GameTypeMetadata = exports.GameStatusOutput = exports.PluginStateOnlyInput = exports.GameResultOutput = exports.Outcome = exports.DescribeSaveFileOutput = exports.DescribeSaveFileInput = exports.BotSkillLevelEntry = exports.AssignParticipantsOutput = exports.AssignParticipantsInput = exports.SaveFileEditRejectedError = exports.ApplySaveFileEditOutput = exports.ApplySaveFileEditInput = exports.PluginStateUpdate = exports.InvalidMoveError = exports.ApplyMoveInput = exports.Move = void 0;
+exports.ValidateMoveInput = exports.MoveValidation = exports.SelectBotMoveOutput = exports.SelectBotMoveInput = exports.IsOutOfTurnMoveOutput = exports.IsOutOfTurnMoveInput = exports.IsConfigMoveOutput = exports.IsConfigMoveInput = exports.InitializeGameInput = exports.HealthOutput = exports.GetSaveFileEditorStateOutput = exports.GetSaveFileEditorStateInput = exports.GetPlayerViewOutput = exports.GetPlayerViewInput = exports.GameTypeMetadata = exports.SpaceCapability = exports.GameStatusOutput = exports.PluginStateOnlyInput = exports.GameResultOutput = exports.Outcome = exports.DescribeSaveFileOutput = exports.DescribeSaveFileInput = exports.BotSkillLevelEntry = exports.AssignParticipantsOutput = exports.AssignParticipantsInput = exports.SaveFileEditRejectedError = exports.ApplySaveFileEditOutput = exports.ApplySaveFileEditInput = exports.PluginStateUpdate = exports.InvalidMoveError = exports.ApplyMoveInput = exports.Move = void 0;
 const server_common_1 = require("@aws-smithy/server-common");
 var Move;
 (function (Move) {
@@ -411,6 +411,43 @@ var GameStatusOutput;
         ];
     };
 })(GameStatusOutput || (exports.GameStatusOutput = GameStatusOutput = {}));
+var SpaceCapability;
+(function (SpaceCapability) {
+    const memberValidators = {};
+    SpaceCapability.validate = (obj, path = "") => {
+        function getMemberValidator(member) {
+            if (memberValidators[member] === undefined) {
+                switch (member) {
+                    case "maxMembers": {
+                        memberValidators["maxMembers"] = new server_common_1.CompositeValidator([
+                            new server_common_1.RequiredValidator(),
+                        ]);
+                        break;
+                    }
+                    case "label": {
+                        memberValidators["label"] = new server_common_1.NoOpValidator();
+                        break;
+                    }
+                    case "settingsSchema": {
+                        memberValidators["settingsSchema"] = new server_common_1.NoOpValidator();
+                        break;
+                    }
+                    case "gameConfig": {
+                        memberValidators["gameConfig"] = new server_common_1.NoOpValidator();
+                        break;
+                    }
+                }
+            }
+            return memberValidators[member];
+        }
+        return [
+            ...getMemberValidator("maxMembers").validate(obj.maxMembers, `${path}/maxMembers`),
+            ...getMemberValidator("label").validate(obj.label, `${path}/label`),
+            ...getMemberValidator("settingsSchema").validate(obj.settingsSchema, `${path}/settingsSchema`),
+            ...getMemberValidator("gameConfig").validate(obj.gameConfig, `${path}/gameConfig`),
+        ];
+    };
+})(SpaceCapability || (exports.SpaceCapability = SpaceCapability = {}));
 var GameTypeMetadata;
 (function (GameTypeMetadata) {
     const memberValidators = {};
@@ -490,6 +527,10 @@ var GameTypeMetadata;
                         memberValidators["hasSaveFileEditor"] = new server_common_1.NoOpValidator();
                         break;
                     }
+                    case "spaces": {
+                        memberValidators["spaces"] = new server_common_1.CompositeStructureValidator(new server_common_1.NoOpValidator(), SpaceCapability.validate);
+                        break;
+                    }
                 }
             }
             return memberValidators[member];
@@ -510,6 +551,7 @@ var GameTypeMetadata;
             ...getMemberValidator("hasSaveFiles").validate(obj.hasSaveFiles, `${path}/hasSaveFiles`),
             ...getMemberValidator("hasSaveSummary").validate(obj.hasSaveSummary, `${path}/hasSaveSummary`),
             ...getMemberValidator("hasSaveFileEditor").validate(obj.hasSaveFileEditor, `${path}/hasSaveFileEditor`),
+            ...getMemberValidator("spaces").validate(obj.spaces, `${path}/spaces`),
         ];
     };
 })(GameTypeMetadata || (exports.GameTypeMetadata = GameTypeMetadata = {}));

package/dist-cjs/src/protocols/Aws_restJson1.js

@@ -642,6 +642,7 @@ const serializeGetMetadataResponse = async (input, ctx) => {
         'id': [],
         'maxPlayers': [],
         'minPlayers': [],
+        'spaces': _ => se_SpaceCapability(_, context),
         'spectatorSafe': [],
         'teamPlay': [],
     }));
@@ -1054,6 +1055,14 @@ const se_BotSkillLevelList = (input, context) => {
 const se_ParticipantIdList = (input, context) => {
     return input.filter((e) => e != null);
 };
+const se_SpaceCapability = (input, context) => {
+    return (0, smithy_client_1.take)(input, {
+        'gameConfig': _ => se_Document(_, context),
+        'label': [],
+        'maxMembers': [],
+        'settingsSchema': _ => se_Document(_, context),
+    });
+};
 const se_Document = (input, context) => {
     return input;
 };