@jgengine/convex 0.6.0 → 0.8.0

package/dist/createConvexGameTransport.js

@@ -1,21 +1,27 @@
+import { anyApi } from "convex/server";
+import { createPoseSyncGate } from "@jgengine/core/multiplayer/poseSyncGate";
+export function defaultConvexGameApi() {
+    return anyApi;
+}
 export function createConvexGameTransport(client, api, config) {
     return {
         async joinServer(args) {
             const result = await client.mutation(api.runtime.joinServer, {
                 gameId: config.gameId,
                 serverId: args.serverId,
+                externalId: config.userId,
             });
             return result;
         },
         async leaveServer(args) {
-            await client.mutation(api.runtime.leaveServer, args);
+            await client.mutation(api.runtime.leaveServer, { ...args, externalId: config.userId });
         },
         async runCommand(args) {
-            return await client.mutation(api.runtime.runCommand, args);
+            return await client.mutation(api.runtime.runCommand, { ...args, externalId: config.userId });
         },
     };
 }
-function watchConvexQuery(client, query, args, toView, onChange) {
+export function watchConvexQuery(client, query, args, toView, onChange) {
     const watch = client.watchQuery(query, args);
     const emit = () => {
         const result = watch.localQueryResult();
@@ -29,7 +35,7 @@ function watchConvexQuery(client, query, args, toView, onChange) {
 export function createConvexGameFeeds(client, api, config) {
     return {
         subscribeServer(serverId, onChange) {
-            return watchConvexQuery(client, api.runtime.getServer, { serverId }, (result) => result === null
+            return watchConvexQuery(client, api.runtime.getServer, { serverId, externalId: config.userId }, (result) => result === null
                 ? null
                 : {
                     serverId: result._id,
@@ -42,7 +48,7 @@ export function createConvexGameFeeds(client, api, config) {
         },
         subscribePlayer(args, onChange) {
             void args;
-            return watchConvexQuery(client, api.runtime.getPlayerProfile, { gameId: config.gameId }, (result) => result === null
+            return watchConvexQuery(client, api.runtime.getPlayerProfile, { gameId: config.gameId, externalId: config.userId }, (result) => result === null
                 ? null
                 : {
                     userId: result.userId,
@@ -52,7 +58,52 @@ export function createConvexGameFeeds(client, api, config) {
                 }, onChange);
         },
         subscribeFeed(args, onChange) {
-            return watchConvexQuery(client, api.runtime.getFeed, args, (entries) => ({ action: args.action, entries }), onChange);
+            return watchConvexQuery(client, api.runtime.getFeed, { ...args, externalId: config.userId }, (entries) => ({ action: args.action, entries }), onChange);
+        },
+    };
+}
+const DEFAULT_CONVEX_POSE_TUNING = {
+    minIntervalMs: 200,
+    heartbeatMs: 5_000,
+    positionEpsilon: 0.01,
+    verticalEpsilon: 0.01,
+    rotationEpsilon: 0.01,
+};
+export function createConvexPresenceSync(client, api, config, tuning) {
+    const gate = createPoseSyncGate(tuning ?? DEFAULT_CONVEX_POSE_TUNING);
+    return {
+        subscribe(serverId, onChange) {
+            return watchConvexQuery(client, api.presence.list, { serverId }, (rows) => rows, onChange);
+        },
+        syncPose(serverId, pose) {
+            if (!gate.evaluate(pose, Date.now()))
+                return;
+            void client
+                .mutation(api.presence.sync, { serverId, pose, externalId: config.userId })
+                .catch(() => undefined);
+        },
+    };
+}
+export function createConvexChatSync(client, api, config, serverId) {
+    return {
+        subscribe(channelId, onChange) {
+            return watchConvexQuery(client, api.chat.messages, { serverId, channelId, externalId: config.userId }, (messages) => messages, onChange);
+        },
+        async send(channelId, body) {
+            const outcome = await client.mutation(api.chat.sendMessage, {
+                serverId,
+                channelId,
+                body,
+                externalId: config.userId,
+            });
+            return outcome ?? { ok: true };
+        },
+    };
+}
+export function createConvexFeedWrites(client, api, config) {
+    return {
+        async pushFeedEntry(args) {
+            await client.mutation(api.runtime.pushFeedEntry, { ...args, externalId: config.userId });
         },
     };
 }

package/dist/resolveConvexMultiplayer.d.ts

@@ -0,0 +1,17 @@
+import { ConvexReactClient } from "convex/react";
+import type { GameDefinition } from "@jgengine/core/game/defineGame";
+import type { MultiplayerSession } from "@jgengine/core/runtime/transport";
+import type { PoseSyncTuning } from "@jgengine/core/multiplayer/poseSyncGate";
+import type { ConvexGameApi } from "./createConvexGameTransport.js";
+export declare function randomConvexPlayerId(): string;
+export declare function resolveConvexMultiplayer(args: {
+    game: GameDefinition;
+    gameId: string;
+    url?: string;
+    client?: ConvexReactClient;
+    api?: ConvexGameApi;
+    userId?: string;
+    force?: boolean;
+    feedActions?: string[];
+    poseTuning?: PoseSyncTuning;
+}): MultiplayerSession | null;

package/dist/resolveConvexMultiplayer.js

@@ -0,0 +1,26 @@
+import { ConvexReactClient } from "convex/react";
+import { multiplayerAdapterKind } from "@jgengine/core/runtime/adapter";
+import { createConvexBackend } from "./createConvexBackend.js";
+export function randomConvexPlayerId() {
+    return `player-${Math.random().toString(36).slice(2, 10)}`;
+}
+export function resolveConvexMultiplayer(args) {
+    if (args.force !== true && multiplayerAdapterKind(args.game.multiplayer) !== "convex")
+        return null;
+    const client = args.client ?? (args.url === undefined ? null : new ConvexReactClient(args.url));
+    if (client === null)
+        return null;
+    const userId = args.userId ?? randomConvexPlayerId();
+    return {
+        gameId: args.gameId,
+        userId,
+        backend: createConvexBackend({
+            client,
+            gameId: args.gameId,
+            userId,
+            api: args.api,
+            poseTuning: args.poseTuning,
+        }),
+        feedActions: args.feedActions ?? ["entity.died"],
+    };
+}

package/dist/server.d.ts

@@ -0,0 +1,506 @@
+import type { DataModelFromSchemaDefinition, GenericMutationCtx } from "convex/server";
+import type { GenericId } from "convex/values";
+import type { ChatMessage } from "@jgengine/core/game/chat";
+import type { ChatSendOutcome } from "@jgengine/core/multiplayer/chatContract";
+import type { GameRuntime } from "@jgengine/core/runtime/gameRuntime";
+import type { LeaderboardIncrement } from "@jgengine/core/runtime/hostPersistence";
+export declare function jgengineTables(): {
+    jgGameServers: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        createdAt: number;
+        dirtyAt?: number | undefined;
+        gameId: string;
+        lastSavedAt?: number | undefined;
+        memberUserIds: string[];
+        mode?: string | undefined;
+        modeConfig?: any;
+        revision: number;
+        save: "none" | {
+            auto: string;
+            scope: "chunks" | "player" | "player+chunks";
+        };
+        serverState: any;
+        sessionPlayers: any;
+        slotsPerServer: number;
+        status: "closed" | "open" | "running";
+        tickAnchorMs: number;
+        updatedAt: number;
+    }, {
+        gameId: import("convex/values").VString<string, "required">;
+        status: import("convex/values").VUnion<"closed" | "open" | "running", [import("convex/values").VLiteral<"open", "required">, import("convex/values").VLiteral<"running", "required">, import("convex/values").VLiteral<"closed", "required">], "required", never>;
+        mode: import("convex/values").VString<string | undefined, "optional">;
+        modeConfig: import("convex/values").VAny<any, "optional", string>;
+        memberUserIds: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+        slotsPerServer: import("convex/values").VFloat64<number, "required">;
+        save: import("convex/values").VUnion<"none" | {
+            auto: string;
+            scope: "chunks" | "player" | "player+chunks";
+        }, [import("convex/values").VLiteral<"none", "required">, import("convex/values").VObject<{
+            auto: string;
+            scope: "chunks" | "player" | "player+chunks";
+        }, {
+            auto: import("convex/values").VString<string, "required">;
+            scope: import("convex/values").VUnion<"chunks" | "player" | "player+chunks", [import("convex/values").VLiteral<"player", "required">, import("convex/values").VLiteral<"chunks", "required">, import("convex/values").VLiteral<"player+chunks", "required">], "required", never>;
+        }, "required", "auto" | "scope">], "required", "auto" | "scope">;
+        serverState: import("convex/values").VAny<any, "required", string>;
+        sessionPlayers: import("convex/values").VAny<any, "required", string>;
+        revision: import("convex/values").VFloat64<number, "required">;
+        tickAnchorMs: import("convex/values").VFloat64<number, "required">;
+        lastSavedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        dirtyAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "createdAt" | "dirtyAt" | "gameId" | "lastSavedAt" | "memberUserIds" | "mode" | "modeConfig" | "revision" | "save" | "save.auto" | "save.scope" | "serverState" | "sessionPlayers" | "slotsPerServer" | "status" | "tickAnchorMs" | "updatedAt" | `modeConfig.${string}` | `serverState.${string}` | `sessionPlayers.${string}`>, {
+        by_game_and_status: ["gameId", "status", "_creationTime"];
+    }, {}, {}>;
+    jgPlayerProfiles: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        createdAt: number;
+        dirtyAt?: number | undefined;
+        gameId: string;
+        playerState: any;
+        revision: number;
+        updatedAt: number;
+        userId: string;
+    }, {
+        userId: import("convex/values").VString<string, "required">;
+        gameId: import("convex/values").VString<string, "required">;
+        playerState: import("convex/values").VAny<any, "required", string>;
+        revision: import("convex/values").VFloat64<number, "required">;
+        dirtyAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "createdAt" | "dirtyAt" | "gameId" | "playerState" | "revision" | "updatedAt" | "userId" | `playerState.${string}`>, {
+        by_user_and_game: ["userId", "gameId", "_creationTime"];
+    }, {}, {}>;
+    jgWorldChunks: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        chunkKey: string;
+        dirtyAt?: number | undefined;
+        serverId: GenericId<"jgGameServers">;
+        snapshot: any;
+        updatedAt: number;
+    }, {
+        serverId: import("convex/values").VId<GenericId<"jgGameServers">, "required">;
+        chunkKey: import("convex/values").VString<string, "required">;
+        snapshot: import("convex/values").VAny<any, "required", string>;
+        dirtyAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "chunkKey" | "dirtyAt" | "serverId" | "snapshot" | "updatedAt" | `snapshot.${string}`>, {
+        by_server: ["serverId", "_creationTime"];
+        by_server_and_chunk: ["serverId", "chunkKey", "_creationTime"];
+    }, {}, {}>;
+    jgLeaderboardRows: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        gameId: string;
+        scope: "global" | "profile" | "server";
+        serverId?: GenericId<"jgGameServers"> | undefined;
+        stat: string;
+        updatedAt: number;
+        userId: string;
+        value: number;
+    }, {
+        gameId: import("convex/values").VString<string, "required">;
+        stat: import("convex/values").VString<string, "required">;
+        scope: import("convex/values").VUnion<"global" | "profile" | "server", [import("convex/values").VLiteral<"global", "required">, import("convex/values").VLiteral<"server", "required">, import("convex/values").VLiteral<"profile", "required">], "required", never>;
+        serverId: import("convex/values").VId<GenericId<"jgGameServers"> | undefined, "optional">;
+        userId: import("convex/values").VString<string, "required">;
+        value: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "gameId" | "scope" | "serverId" | "stat" | "updatedAt" | "userId" | "value">, {
+        by_game_scope_stat_value: ["gameId", "scope", "stat", "value", "_creationTime"];
+        by_user_scope_stat: ["userId", "scope", "stat", "_creationTime"];
+    }, {}, {}>;
+    jgFeedBuffers: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        action: string;
+        entries: any[];
+        serverId: GenericId<"jgGameServers">;
+        updatedAt: number;
+    }, {
+        serverId: import("convex/values").VId<GenericId<"jgGameServers">, "required">;
+        action: import("convex/values").VString<string, "required">;
+        entries: import("convex/values").VArray<any[], import("convex/values").VAny<any, "required", string>, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "action" | "entries" | "serverId" | "updatedAt">, {
+        by_server_and_action: ["serverId", "action", "_creationTime"];
+    }, {}, {}>;
+    jgPoses: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        rotationPitch: number;
+        rotationY: number;
+        serverId: string;
+        updatedAt: number;
+        userId: string;
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        serverId: import("convex/values").VString<string, "required">;
+        userId: import("convex/values").VString<string, "required">;
+        x: import("convex/values").VFloat64<number, "required">;
+        y: import("convex/values").VFloat64<number, "required">;
+        z: import("convex/values").VFloat64<number, "required">;
+        rotationY: import("convex/values").VFloat64<number, "required">;
+        rotationPitch: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "rotationPitch" | "rotationY" | "serverId" | "updatedAt" | "userId" | "x" | "y" | "z">, {
+        by_server: ["serverId", "_creationTime"];
+        by_server_and_user: ["serverId", "userId", "_creationTime"];
+    }, {}, {}>;
+    jgChatMessages: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        at: number;
+        body: string;
+        channelId: string;
+        serverId: string;
+        userId: string;
+    }, {
+        serverId: import("convex/values").VString<string, "required">;
+        channelId: import("convex/values").VString<string, "required">;
+        userId: import("convex/values").VString<string, "required">;
+        body: import("convex/values").VString<string, "required">;
+        at: import("convex/values").VFloat64<number, "required">;
+    }, "required", "at" | "body" | "channelId" | "serverId" | "userId">, {
+        by_server_channel: ["serverId", "channelId", "_creationTime"];
+    }, {}, {}>;
+};
+declare const schemaForTypes: import("convex/server").SchemaDefinition<{
+    jgGameServers: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        createdAt: number;
+        dirtyAt?: number | undefined;
+        gameId: string;
+        lastSavedAt?: number | undefined;
+        memberUserIds: string[];
+        mode?: string | undefined;
+        modeConfig?: any;
+        revision: number;
+        save: "none" | {
+            auto: string;
+            scope: "chunks" | "player" | "player+chunks";
+        };
+        serverState: any;
+        sessionPlayers: any;
+        slotsPerServer: number;
+        status: "closed" | "open" | "running";
+        tickAnchorMs: number;
+        updatedAt: number;
+    }, {
+        gameId: import("convex/values").VString<string, "required">;
+        status: import("convex/values").VUnion<"closed" | "open" | "running", [import("convex/values").VLiteral<"open", "required">, import("convex/values").VLiteral<"running", "required">, import("convex/values").VLiteral<"closed", "required">], "required", never>;
+        mode: import("convex/values").VString<string | undefined, "optional">;
+        modeConfig: import("convex/values").VAny<any, "optional", string>;
+        memberUserIds: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+        slotsPerServer: import("convex/values").VFloat64<number, "required">;
+        save: import("convex/values").VUnion<"none" | {
+            auto: string;
+            scope: "chunks" | "player" | "player+chunks";
+        }, [import("convex/values").VLiteral<"none", "required">, import("convex/values").VObject<{
+            auto: string;
+            scope: "chunks" | "player" | "player+chunks";
+        }, {
+            auto: import("convex/values").VString<string, "required">;
+            scope: import("convex/values").VUnion<"chunks" | "player" | "player+chunks", [import("convex/values").VLiteral<"player", "required">, import("convex/values").VLiteral<"chunks", "required">, import("convex/values").VLiteral<"player+chunks", "required">], "required", never>;
+        }, "required", "auto" | "scope">], "required", "auto" | "scope">;
+        serverState: import("convex/values").VAny<any, "required", string>;
+        sessionPlayers: import("convex/values").VAny<any, "required", string>;
+        revision: import("convex/values").VFloat64<number, "required">;
+        tickAnchorMs: import("convex/values").VFloat64<number, "required">;
+        lastSavedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        dirtyAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "createdAt" | "dirtyAt" | "gameId" | "lastSavedAt" | "memberUserIds" | "mode" | "modeConfig" | "revision" | "save" | "save.auto" | "save.scope" | "serverState" | "sessionPlayers" | "slotsPerServer" | "status" | "tickAnchorMs" | "updatedAt" | `modeConfig.${string}` | `serverState.${string}` | `sessionPlayers.${string}`>, {
+        by_game_and_status: ["gameId", "status", "_creationTime"];
+    }, {}, {}>;
+    jgPlayerProfiles: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        createdAt: number;
+        dirtyAt?: number | undefined;
+        gameId: string;
+        playerState: any;
+        revision: number;
+        updatedAt: number;
+        userId: string;
+    }, {
+        userId: import("convex/values").VString<string, "required">;
+        gameId: import("convex/values").VString<string, "required">;
+        playerState: import("convex/values").VAny<any, "required", string>;
+        revision: import("convex/values").VFloat64<number, "required">;
+        dirtyAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "createdAt" | "dirtyAt" | "gameId" | "playerState" | "revision" | "updatedAt" | "userId" | `playerState.${string}`>, {
+        by_user_and_game: ["userId", "gameId", "_creationTime"];
+    }, {}, {}>;
+    jgWorldChunks: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        chunkKey: string;
+        dirtyAt?: number | undefined;
+        serverId: GenericId<"jgGameServers">;
+        snapshot: any;
+        updatedAt: number;
+    }, {
+        serverId: import("convex/values").VId<GenericId<"jgGameServers">, "required">;
+        chunkKey: import("convex/values").VString<string, "required">;
+        snapshot: import("convex/values").VAny<any, "required", string>;
+        dirtyAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "chunkKey" | "dirtyAt" | "serverId" | "snapshot" | "updatedAt" | `snapshot.${string}`>, {
+        by_server: ["serverId", "_creationTime"];
+        by_server_and_chunk: ["serverId", "chunkKey", "_creationTime"];
+    }, {}, {}>;
+    jgLeaderboardRows: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        gameId: string;
+        scope: "global" | "profile" | "server";
+        serverId?: GenericId<"jgGameServers"> | undefined;
+        stat: string;
+        updatedAt: number;
+        userId: string;
+        value: number;
+    }, {
+        gameId: import("convex/values").VString<string, "required">;
+        stat: import("convex/values").VString<string, "required">;
+        scope: import("convex/values").VUnion<"global" | "profile" | "server", [import("convex/values").VLiteral<"global", "required">, import("convex/values").VLiteral<"server", "required">, import("convex/values").VLiteral<"profile", "required">], "required", never>;
+        serverId: import("convex/values").VId<GenericId<"jgGameServers"> | undefined, "optional">;
+        userId: import("convex/values").VString<string, "required">;
+        value: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "gameId" | "scope" | "serverId" | "stat" | "updatedAt" | "userId" | "value">, {
+        by_game_scope_stat_value: ["gameId", "scope", "stat", "value", "_creationTime"];
+        by_user_scope_stat: ["userId", "scope", "stat", "_creationTime"];
+    }, {}, {}>;
+    jgFeedBuffers: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        action: string;
+        entries: any[];
+        serverId: GenericId<"jgGameServers">;
+        updatedAt: number;
+    }, {
+        serverId: import("convex/values").VId<GenericId<"jgGameServers">, "required">;
+        action: import("convex/values").VString<string, "required">;
+        entries: import("convex/values").VArray<any[], import("convex/values").VAny<any, "required", string>, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "action" | "entries" | "serverId" | "updatedAt">, {
+        by_server_and_action: ["serverId", "action", "_creationTime"];
+    }, {}, {}>;
+    jgPoses: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        rotationPitch: number;
+        rotationY: number;
+        serverId: string;
+        updatedAt: number;
+        userId: string;
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        serverId: import("convex/values").VString<string, "required">;
+        userId: import("convex/values").VString<string, "required">;
+        x: import("convex/values").VFloat64<number, "required">;
+        y: import("convex/values").VFloat64<number, "required">;
+        z: import("convex/values").VFloat64<number, "required">;
+        rotationY: import("convex/values").VFloat64<number, "required">;
+        rotationPitch: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "rotationPitch" | "rotationY" | "serverId" | "updatedAt" | "userId" | "x" | "y" | "z">, {
+        by_server: ["serverId", "_creationTime"];
+        by_server_and_user: ["serverId", "userId", "_creationTime"];
+    }, {}, {}>;
+    jgChatMessages: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        at: number;
+        body: string;
+        channelId: string;
+        serverId: string;
+        userId: string;
+    }, {
+        serverId: import("convex/values").VString<string, "required">;
+        channelId: import("convex/values").VString<string, "required">;
+        userId: import("convex/values").VString<string, "required">;
+        body: import("convex/values").VString<string, "required">;
+        at: import("convex/values").VFloat64<number, "required">;
+    }, "required", "at" | "body" | "channelId" | "serverId" | "userId">, {
+        by_server_channel: ["serverId", "channelId", "_creationTime"];
+    }, {}, {}>;
+}, true>;
+type JGDataModel = DataModelFromSchemaDefinition<typeof schemaForTypes>;
+type JGMutationCtx = GenericMutationCtx<JGDataModel>;
+export type JgAuthMode = "anonymous" | "required";
+export declare function applyLeaderboardIncrements(ctx: JGMutationCtx, gameId: string, entries: LeaderboardIncrement[]): Promise<void>;
+export declare const JG_RUNTIME_TICK_MS = 1000;
+export declare function createGameServerFunctions(options?: {
+    runtimes?: GameRuntime[];
+    auth?: JgAuthMode;
+}): {
+    joinServer: import("convex/server").RegisteredMutation<"public", {
+        externalId?: string | undefined;
+        gameId: string;
+        mode?: string | undefined;
+        modeConfig?: any;
+        save?: "none" | {
+            auto: string;
+            scope: "chunks" | "player" | "player+chunks";
+        } | undefined;
+        serverId?: GenericId<"jgGameServers"> | undefined;
+        slotsPerServer?: number | undefined;
+    }, Promise<{
+        serverId: GenericId<"jgGameServers">;
+        isNew: boolean;
+    }>>;
+    leaveServer: import("convex/server").RegisteredMutation<"public", {
+        externalId?: string | undefined;
+        serverId: GenericId<"jgGameServers">;
+    }, Promise<null>>;
+    runCommand: import("convex/server").RegisteredMutation<"public", {
+        command: string;
+        externalId?: string | undefined;
+        input: any;
+        serverId: GenericId<"jgGameServers">;
+    }, Promise<{
+        ok: false;
+        reason: string;
+    } | {
+        ok: true;
+    }>>;
+    flushSave: import("convex/server").RegisteredMutation<"public", {
+        externalId?: string | undefined;
+        serverId: GenericId<"jgGameServers">;
+    }, Promise<boolean>>;
+    getServer: import("convex/server").RegisteredQuery<"public", {
+        externalId?: string | undefined;
+        serverId: GenericId<"jgGameServers">;
+    }, Promise<{
+        _id: GenericId<"jgGameServers">;
+        gameId: string;
+        status: "closed" | "open" | "running";
+        mode: string | undefined;
+        memberUserIds: string[];
+        slotsPerServer: number;
+        save: "none" | {
+            auto: string;
+            scope: "chunks" | "player" | "player+chunks";
+        };
+        revision: number;
+        serverState: any;
+        sessionPlayers: any;
+        updatedAt: number;
+    } | null>>;
+    getPlayerProfile: import("convex/server").RegisteredQuery<"public", {
+        externalId?: string | undefined;
+        gameId: string;
+    }, Promise<{
+        userId: string;
+        gameId: string;
+        playerState: any;
+        revision: number;
+        updatedAt: number;
+    } | null>>;
+    getFeed: import("convex/server").RegisteredQuery<"public", {
+        action: string;
+        externalId?: string | undefined;
+        serverId: GenericId<"jgGameServers">;
+    }, Promise<any[]>>;
+    pushFeedEntry: import("convex/server").RegisteredMutation<"public", {
+        action: string;
+        entry: any;
+        externalId?: string | undefined;
+        serverId: GenericId<"jgGameServers">;
+    }, Promise<null>>;
+    listOpenServers: import("convex/server").RegisteredQuery<"public", {
+        externalId?: string | undefined;
+        gameId: string;
+        limit?: number | undefined;
+    }, Promise<{
+        _id: GenericId<"jgGameServers">;
+        status: "closed" | "open" | "running";
+        memberCount: number;
+        slotsPerServer: number;
+        mode: string | undefined;
+        updatedAt: number;
+    }[]>>;
+    tickActiveServers: import("convex/server").RegisteredMutation<"internal", {}, Promise<{
+        ticked: number;
+        saved: number;
+    }>>;
+    flushDirtyServers: import("convex/server").RegisteredMutation<"internal", {}, Promise<{
+        saved: number;
+    }>>;
+};
+export declare function createLeaderboardFunctions(options?: {
+    auth?: JgAuthMode;
+}): {
+    getTop: import("convex/server").RegisteredQuery<"public", {
+        externalId?: string | undefined;
+        gameId: string;
+        limit?: number | undefined;
+        scope: "global" | "profile" | "server";
+        serverId?: GenericId<"jgGameServers"> | undefined;
+        stat: string;
+    }, Promise<{
+        userId: string;
+        value: number;
+    }[]>>;
+    getProfile: import("convex/server").RegisteredQuery<"public", {
+        externalId?: string | undefined;
+        gameId: string;
+        userId: string;
+    }, Promise<Record<string, number>>>;
+    incrementMany: import("convex/server").RegisteredMutation<"internal", {
+        entries: {
+            by: number;
+            scope: "global" | "profile" | "server";
+            serverId?: GenericId<"jgGameServers"> | undefined;
+            stat: string;
+            userId: string;
+        }[];
+        gameId: string;
+    }, Promise<null>>;
+};
+export declare function createPresenceFunctions(options?: {
+    auth?: JgAuthMode;
+    freshWindowMs?: number;
+}): {
+    list: import("convex/server").RegisteredQuery<"public", {
+        externalId?: string | undefined;
+        serverId: string;
+    }, Promise<{
+        userId: string;
+        position: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        rotationY: number;
+        rotationPitch: number;
+        lastSeenAt: number;
+    }[]>>;
+    sync: import("convex/server").RegisteredMutation<"public", {
+        externalId?: string | undefined;
+        pose: {
+            rotationPitch: number;
+            rotationY: number;
+            x: number;
+            y: number;
+            z: number;
+        };
+        serverId: string;
+    }, Promise<null>>;
+    leave: import("convex/server").RegisteredMutation<"public", {
+        externalId?: string | undefined;
+        serverId: string;
+    }, Promise<null>>;
+};
+export declare function createChatFunctions(options?: {
+    auth?: JgAuthMode;
+    historyLimit?: number;
+    maxBodyLength?: number;
+    minIntervalMs?: number;
+}): {
+    messages: import("convex/server").RegisteredQuery<"public", {
+        channelId: string;
+        externalId?: string | undefined;
+        serverId: string;
+    }, Promise<ChatMessage[]>>;
+    sendMessage: import("convex/server").RegisteredMutation<"public", {
+        body: string;
+        channelId: string;
+        externalId?: string | undefined;
+        serverId: string;
+    }, Promise<ChatSendOutcome>>;
+};
+export type JgCronSpec = {
+    name: string;
+    intervalSeconds: number;
+    functionKey: "tickActiveServers" | "flushDirtyServers";
+};
+export declare function jgengineCronSpecs(): readonly JgCronSpec[];
+export {};