@anweather/game-plugin-ssdk 1.16.0 → 1.18.0

package/dist-cjs/runtime/servePlugin.js

@@ -9,6 +9,8 @@ const defaultService_1 = require("./defaultService");
 const express_2 = require("./express");
 const registration_1 = require("./registration");
 const version_1 = require("./version");
+const server_1 = require("./live/server");
+const auth_1 = require("./auth");
 const permissiveValidation = () => undefined;
 function createPluginApp(options) {
     const env = options.env ?? process.env;
@@ -34,7 +36,7 @@ function createPluginApp(options) {
             return next();
         if (!authToken)
             return next();
-        if (req.header("X-Plugin-Auth") === `Bearer ${authToken}`)
+        if ((0, auth_1.bearerMatches)(req.header("X-Plugin-Auth"), authToken))
             return next();
         res.status(401).json({ __type: "Unauthorized", message: "missing or invalid X-Plugin-Auth" });
     });
@@ -63,10 +65,14 @@ async function servePlugin(options) {
     });
     const boundPort = server.address().port;
     log.log(`${options.gameType} plugin backend listening on :${boundPort}`);
+    const live = options.live
+        ? (0, server_1.attachLive)(server, { gameType: options.gameType, authToken: built.authToken, live: options.live, log })
+        : undefined;
     built.registration.start();
     let closing;
     const close = () => (closing ??= (async () => {
         await built.registration.stop();
+        await live?.close();
         await new Promise((resolve) => server.close(() => resolve()));
     })());
     if (options.handleSignals ?? true) {
@@ -76,5 +82,5 @@ async function servePlugin(options) {
         process.once("SIGTERM", onSignal);
         process.once("SIGINT", onSignal);
     }
-    return { ...built, server, port: boundPort, close };
+    return { ...built, server, live, port: boundPort, close };
 }

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;
 };