@jgengine/convex 0.49.1 → 0.51.0

package/dist/createConvexBackend.d.ts

@@ -13,8 +13,8 @@ export type ConvexBackendOptions<TRawPresenceRow extends {
     client: ConvexReactClient;
     gameId: string;
     userId: string;
-    api?: ConvexGameApi;
-    poseTuning?: PoseSyncTuning;
+    api?: ConvexGameApi | undefined;
+    poseTuning?: PoseSyncTuning | undefined;
     presence?: {
         functions: ConvexPresenceFunctions;
         mapRow: (row: TRawPresenceRow) => TPresenceRow;

package/dist/createConvexGameTransport.d.ts

@@ -15,23 +15,23 @@ export type ConvexGameApi = {
     runtime: {
         joinServer: FunctionReference<"mutation", "public", {
             gameId: string;
-            serverId?: string;
+            serverId?: string | undefined;
             mode?: string;
             visibility?: "public" | "private";
             joinCode?: string;
-            externalId?: string;
+            externalId?: string | undefined;
             sessionId?: string;
         }, JoinServerOutcome>;
         leaveServer: FunctionReference<"mutation", "public", {
             serverId: string;
-            externalId?: string;
+            externalId?: string | undefined;
             sessionId?: string;
         }, null>;
         runCommand: FunctionReference<"mutation", "public", {
             serverId: string;
             command: string;
             input: unknown;
-            externalId?: string;
+            externalId?: string | undefined;
         }, {
             ok: true;
         } | {
@@ -42,7 +42,7 @@ export type ConvexGameApi = {
             serverId: string;
             action: string;
             entry: unknown;
-            externalId?: string;
+            externalId?: string | undefined;
         }, null>;
         getServer: FunctionReference<"query", "public", {
             serverId: string;
@@ -55,13 +55,13 @@ export type ConvexGameApi = {
         getFeed: FunctionReference<"query", "public", {
             serverId: string;
             action: string;
-            externalId?: string;
+            externalId?: string | undefined;
         }, unknown[]>;
     };
     presence: {
         list: FunctionReference<"query", "public", {
             serverId: string;
-            externalId?: string;
+            externalId?: string | undefined;
             viewerChunkKey?: string;
         }, PresencePoseRow[]>;
         sync: FunctionReference<"mutation", "public", {
@@ -76,7 +76,7 @@ export type ConvexGameApi = {
             sessionId?: string;
             kind?: string;
             label?: string;
-            externalId?: string;
+            externalId?: string | undefined;
         }, {
             pose: {
                 x: number;
@@ -98,13 +98,13 @@ export type ConvexGameApi = {
         messages: FunctionReference<"query", "public", {
             serverId: string;
             channelId: string;
-            externalId?: string;
+            externalId?: string | undefined;
         }, ChatMessage[]>;
         sendMessage: FunctionReference<"mutation", "public", {
             serverId: string;
             channelId: string;
             body: string;
-            externalId?: string;
+            externalId?: string | undefined;
         }, ChatSendOutcome>;
     };
     leaderboard: {

package/dist/createConvexGameTransport.js

@@ -104,6 +104,14 @@ export function createConvexPresenceSync(client, api, config, tuning) {
     const viewerChunks = new Map();
     const refreshers = new Map();
     const lastSentAt = new Map();
+    // A pose row outlives its tab unless something ends it; the last unsubscribe and an unload both do.
+    const leave = (serverId) => {
+        void client.mutation(api.presence.leave, { serverId, ...(config.userId === undefined ? {} : { externalId: config.userId }) }).catch(() => undefined);
+    };
+    const onPageHide = () => {
+        for (const serverId of refreshers.keys())
+            leave(serverId);
+    };
     return {
         subscribe(serverId, onChange) {
             let unsubscribe;
@@ -115,6 +123,8 @@ export function createConvexPresenceSync(client, api, config, tuning) {
             let listeners = refreshers.get(serverId);
             if (listeners === undefined) {
                 listeners = new Set();
+                if (refreshers.size === 0)
+                    globalThis.addEventListener?.("pagehide", onPageHide);
                 refreshers.set(serverId, listeners);
             }
             listeners.add(refresh);
@@ -127,6 +137,9 @@ export function createConvexPresenceSync(client, api, config, tuning) {
                     viewerChunks.delete(serverId);
                     gates.delete(serverId);
                     lastSentAt.delete(serverId);
+                    leave(serverId);
+                    if (refreshers.size === 0)
+                        globalThis.removeEventListener?.("pagehide", onPageHide);
                 }
             };
         },

package/dist/hostedServer.d.ts

@@ -39,7 +39,7 @@ export interface HostedWorldOutcome<T> {
   */
 export declare function invokeHostedWorld<T>(invocation: HostedWorldInvocation<T>): Promise<HostedWorldOutcome<T>>;
 /** Default minimum elapsed ms before `tickHostedWorlds` advances a world — override via the factory's `tickMs`. */
-export declare const JG_HOSTED_TICK_MS = 1000;
+export declare const JG_HOSTED_TICK_MS = 50;
 /**
  * The Convex counterpart of ws's `createWorldGameHost`: serves GameContext worlds statelessly by
  * reconstructing a hosted session from the persisted `jgHostedWorlds` row on every invocation via
@@ -53,9 +53,9 @@ export declare function createHostedGameServerFunctions(options: {
     tickMs?: number;
 }): {
     getHostedServer: import("convex/server").RegisteredQuery<"public", {
-        externalId?: string | undefined;
+        externalId?: string;
         gameId: string;
-        serverId?: string | undefined;
+        serverId?: string;
     }, Promise<{
         serverId: string;
         gameId: string;
@@ -64,24 +64,24 @@ export declare function createHostedGameServerFunctions(options: {
         memberUserIds: string[];
     } | null>>;
     joinHostedServer: import("convex/server").RegisteredMutation<"public", {
-        externalId?: string | undefined;
+        externalId?: string;
         gameId: string;
-        serverId?: string | undefined;
+        serverId?: string;
     }, Promise<{
         serverId: string;
         isNew: boolean;
     }>>;
     leaveHostedServer: import("convex/server").RegisteredMutation<"public", {
-        externalId?: string | undefined;
+        externalId?: string;
         gameId: string;
-        serverId?: string | undefined;
+        serverId?: string;
     }, Promise<null>>;
     runHostedCommand: import("convex/server").RegisteredMutation<"public", {
         command: string;
-        externalId?: string | undefined;
+        externalId?: string;
         gameId: string;
         input: any;
-        serverId?: string | undefined;
+        serverId?: string;
     }, Promise<{
         ok: false;
         reason: string;
@@ -89,10 +89,10 @@ export declare function createHostedGameServerFunctions(options: {
         ok: true;
     }>>;
     submitHostedInput: import("convex/server").RegisteredMutation<"public", {
-        externalId?: string | undefined;
+        externalId?: string;
         frame: any;
         gameId: string;
-        serverId?: string | undefined;
+        serverId?: string;
     }, Promise<null>>;
     tickHostedWorlds: import("convex/server").RegisteredMutation<"internal", {}, Promise<{
         ticked: number;

package/dist/hostedServer.js

@@ -2,6 +2,7 @@ import { defineSchema, internalMutationGeneric, mutationGeneric, queryGeneric, }
 import { ConvexError, v } from "convex/values";
 import { createHostedGameRunner, INPUT_COMMAND } from "@jgengine/core/runtime/hostedGameRunner";
 import { createHostedWorldSessionAsync, } from "@jgengine/core/runtime/hostedWorldSession";
+import { DEFAULT_HOST_TICK_MS, resolveHostTickMs } from "@jgengine/core/runtime/hostPolicy";
 import { commitIfRevisionMatch } from "./occ.js";
 import { jgengineHostedTables, resolveActor } from "./server.js";
 /**
@@ -40,7 +41,7 @@ const query = queryGeneric;
 const mutation = mutationGeneric;
 const internalMutation = internalMutationGeneric;
 /** Default minimum elapsed ms before `tickHostedWorlds` advances a world — override via the factory's `tickMs`. */
-export const JG_HOSTED_TICK_MS = 1_000;
+export const JG_HOSTED_TICK_MS = DEFAULT_HOST_TICK_MS;
 async function getWorldRow(ctx, gameId, serverId) {
     return await ctx.db
         .query("jgHostedWorlds")
@@ -100,7 +101,7 @@ async function persistWorldRow(ctx, args) {
   */
 export function createHostedGameServerFunctions(options) {
     const mode = options.auth ?? "anonymous";
-    const tickMs = options.tickMs ?? JG_HOSTED_TICK_MS;
+    const tickMs = resolveHostTickMs(options.tickMs ?? JG_HOSTED_TICK_MS);
     function resolveGame(gameId) {
         const game = options.games[gameId];
         if (game === undefined)

package/dist/resolveConvexMultiplayer.d.ts

@@ -7,7 +7,7 @@ export declare function randomConvexPlayerId(): string;
 export declare function resolveConvexMultiplayer(args: {
     game: GameDefinition;
     gameId: string;
-    url?: string;
+    url?: string | undefined;
     client?: ConvexReactClient;
     api?: ConvexGameApi;
     userId?: string;