@crowdedkingdoms/crowdyjs 13.0.2 → 13.2.0

package/dist/domains/gameModel.js

@@ -6,7 +6,7 @@ GameModelCreateSessionDocument, GameModelJoinSessionDocument, GameModelSetSessio
 // Studio authoring ops
 GameModelSeedDocument, GameModelUpsertContainerTypeDocument, GameModelUpsertPropertyDefDocument, GameModelDeletePropertyDefDocument, GameModelDeleteContainerTypeDocument, GameModelUpsertFunctionDocument, GameModelDeleteFunctionDocument, GameModelDefineFeatureDocument, GameModelGrantTierFeatureDocument, GameModelSetPolicyDocument, GameModelTypeSchemaDocument, GameModelContainerTypesDocument, GameModelPropertyDefsDocument, GameModelFunctionDocument, GameModelFunctionsDocument, GameModelFeaturesDocument, GameModelTierFeaturesDocument, GameModelPolicyDocument, GameModelRevokeTierFeatureDocument, GameModelEventsConnectionDocument, 
 // Automations (autonomous processes / NPCs)
-GameModelUpsertAutomationDocument, GameModelDeleteAutomationDocument, GameModelSetAutomationEnabledDocument, GameModelUpsertAutomationTriggerDocument, GameModelDeleteAutomationTriggerDocument, GameModelSetAutomationPolicyDocument, GameModelRunAutomationDocument, GameModelAutomationsDocument, GameModelAutomationDocument, GameModelAutomationTriggersDocument, GameModelAutomationPolicyDocument, GameModelAutomationRunsDocument, GameModelAutomationStatsDocument, GameModelAppDiagnosticsDocument, } from '../generated/graphql.js';
+GameModelUpsertAutomationDocument, GameModelDeleteAutomationDocument, GameModelSetAutomationEnabledDocument, GameModelUpsertAutomationTriggerDocument, GameModelDeleteAutomationTriggerDocument, GameModelSetAutomationPolicyDocument, GameModelRunAutomationDocument, GameModelAutomationsDocument, GameModelAutomationDocument, GameModelAutomationTriggersDocument, GameModelAutomationPolicyDocument, GameModelAutomationRunsDocument, GameModelAutomationStatsDocument, GameModelAppDiagnosticsDocument, GameModelScheduleInvokeDocument, GameModelCancelTimerDocument, GameModelTimersDocument, } from '../generated/graphql.js';
 export class GameModelAPI {
     constructor(gql, ws) {
         this.gql = gql;
@@ -852,12 +852,26 @@ export class GameModelAPI {
     /**
      * **Automations** — create an event trigger that fires an automation in
      * reaction to model activity (`function_invoked` | `property_changed` |
-     * `container_created`), matched in the API server post-commit. Requires the
-     * app-admin **`manage_apps`** permission.
+     * `container_created` | `player_count_changed`), matched in the API server
+     * post-commit. Requires the app-admin **`manage_apps`** permission.
+     *
+     * Each event matches on its own filters, and a filter the event does not
+     * match on is rejected rather than silently never firing:
+     * `function_invoked` takes `functionName` and `containerTypeName` (the type
+     * of the invocation's `self` container); `property_changed` takes
+     * `containerTypeName`, `propertyKey`, and `writeSource`;
+     * `container_created` takes `containerTypeName`; `player_count_changed`
+     * takes none.
+     *
+     * `writeSource` decides which writes a `property_changed` trigger sees:
+     * `direct` (a {@link GameModelAPI.setProperty} call), `function` (a mutation
+     * applied inside an invoke, automation run, or timer fire), or `any`
+     * (default). Most game logic writes properties from inside functions, so a
+     * trigger watching such a property needs `function` or `any`.
      *
      * @param input - {@link UpsertAutomationTriggerInput}: `appId`,
-     *   `automationName`, `onEvent`, optional `functionName` /
-     *   `containerTypeName` / `propertyKey` filters, and `debounceMs`.
+     *   `automationName`, `onEvent`, the filters valid for that event, and
+     *   `debounceMs`.
      * @returns The created {@link GmAutomationTrigger}.
      */
     async upsertAutomationTrigger(input) {
@@ -878,7 +892,8 @@ export class GameModelAPI {
     /**
      * **Automations** — set the app's automation policy (platform guardrails: the
      * kill switch, max automations, the minimum schedule interval floor, max
-     * fan-out, max event cascade depth, and the aggregate per-minute run ceiling).
+     * fan-out, max event cascade depth, the aggregate per-minute run ceiling, and
+     * the timer floor / pending-timer ceiling).
      * Requires the app-admin **`manage_apps`** permission.
      *
      * @param input - {@link SetAutomationPolicyInput}.
@@ -927,6 +942,10 @@ export class GameModelAPI {
      * **Automations** — list event triggers for an app, optionally filtered to one
      * automation by name. Requires the app-admin **`manage_apps`** permission.
      *
+     * Use this to debug a trigger that isn't firing: `warnings` reports filters
+     * that can never match, `lastMatchedAt` is null until the trigger has
+     * actually dispatched a run, and `matchCount24h` shows recent activity.
+     *
      * @param variables - `{ appId, automationName? }`.
      * @returns The {@link GmAutomationTrigger}s.
      */
@@ -983,4 +1002,56 @@ export class GameModelAPI {
         const data = await this.gql.request(GameModelAppDiagnosticsDocument, variables);
         return data.gameModelAppDiagnostics;
     }
+    /**
+     * **Timers** — arm a one-shot timer: invoke a function once, after a delay.
+     * The timer is durable (it survives an API restart) and claimed by exactly one
+     * replica, so it fires once. Requires the app-admin **`manage_apps`**
+     * permission, because a timer fires headlessly with system authority rather
+     * than a player's.
+     *
+     * For player-driven delays, declare a `timers` effect on the function instead
+     * (see {@link GameModelAPI.upsertFunction}) so the delay is part of your game
+     * logic and is armed atomically with that invocation's mutations.
+     *
+     * The target function must be `autonomousInvocable`. Pass `dedupeKey` to make
+     * re-arming replace the pending timer instead of queueing another fire, which
+     * is how you implement "reset the countdown".
+     *
+     * @param input - {@link ScheduleInvokeInput}: `appId`, `functionName`,
+     *   `selfContainerId`, `delayMs`, and optional `paramsJson`, `sessionId`, and
+     *   `dedupeKey`.
+     * @returns The armed {@link GmTimer}.
+     */
+    async scheduleInvoke(input) {
+        const data = await this.gql.request(GameModelScheduleInvokeDocument, { input });
+        return data.gameModelScheduleInvoke;
+    }
+    /**
+     * **Timers** — cancel pending timers by id or by dedupe key. A timer already
+     * claimed for execution cannot be cancelled. Requires the app-admin
+     * **`manage_apps`** permission.
+     *
+     * @param variables - `{ appId, timerId?, dedupeKey? }` (supply at least one
+     *   selector).
+     * @returns How many pending timers were removed.
+     */
+    async cancelTimer(variables) {
+        const data = await this.gql.request(GameModelCancelTimerDocument, variables);
+        return data.gameModelCancelTimer;
+    }
+    /**
+     * **Timers** — list pending one-shot timers, soonest first. A timer leaves
+     * this list the instant it is claimed for execution, so an empty list means
+     * nothing is *scheduled* — not that nothing ran. Fires that already happened
+     * appear in {@link GameModelAPI.automationRuns} with
+     * `triggerSource: 'timer'`. Requires the app-admin **`manage_apps`**
+     * permission.
+     *
+     * @param variables - `{ appId, sessionId?, limit? }` (limit 1-200, default 50).
+     * @returns The pending {@link GmTimer}s.
+     */
+    async timers(variables) {
+        const data = await this.gql.request(GameModelTimersDocument, variables);
+        return data.gameModelTimers;
+    }
 }

package/dist/domains/udp.d.ts

@@ -44,6 +44,12 @@ export declare class UdpAPI {
     constructor(gql: GraphQLClient, subs: SubscriptionManager, metrics?: RealtimeMetrics | undefined);
     /** Count a message accepted for sending (see `client.metrics`). */
     private record;
+    /**
+     * Try to send over the binary relay (`crowdy-relay-v1`). Returns `null`
+     * when the relay is not active/ready so the caller falls back to the
+     * GraphQL mutation. Client-side serialize + HMAC; no GraphQL on this path.
+     */
+    private sendViaRelay;
     /**
      * Open (or re-fetch) the UDP proxy session for this game token. Idempotent:
      * if a session is already open it returns the existing status; on first open

package/dist/domains/udp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"udp.d.ts","sourceRoot":"","sources":["../../src/domains/udp.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"udp.d.ts","sourceRoot":"","sources":["../../src/domains/udp.ts"],"names":[],"mappings":"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"}

package/dist/domains/udp.js

@@ -1,6 +1,7 @@
 import { ConnectUdpProxyDocument, DisconnectUdpProxyDocument, UdpProxyConnectionStatusDocument, SendActorUpdateDocument, SendVoxelUpdateDocument, SendAudioPacketDocument, SendTextPacketDocument, SendClientEventDocument, SendSingleActorMessageDocument, SendChannelMessageDocument, } from '../generated/graphql.js';
 import { payloadBytesOf } from '../metrics.js';
 import { SequenceAllocator } from '../utils.js';
+import { serializeActorUpdate, serializeAudioPacket, serializeChannelMessage, serializeClientEvent, serializeSingleActorMessage, serializeTextPacket, serializeVoxelUpdate, } from '../binary-wire.js';
 /**
  * UDP proxy access for browser-style clients that can't open raw UDP sockets.
  * Exposed as `client.udp`; for game loops prefer the ergonomic, app-scoped
@@ -45,6 +46,31 @@ export class UdpAPI {
     record(kind, input) {
         this.metrics?.recordSent(kind, payloadBytesOf(input));
     }
+    /**
+     * Try to send over the binary relay (`crowdy-relay-v1`). Returns `null`
+     * when the relay is not active/ready so the caller falls back to the
+     * GraphQL mutation. Client-side serialize + HMAC; no GraphQL on this path.
+     */
+    async sendViaRelay(serialize) {
+        if (!this.subs.usingBinaryTransport())
+            return null;
+        if (!this.subs.binarySendReady()) {
+            // Relay configured but not open yet (e.g. right after subscribe or a
+            // token rotation). Wait briefly rather than falling back to HTTP — an
+            // HTTP send would open a parallel GraphQL proxy session for the same
+            // token whose idle teardown deauthorizes it under the relay session.
+            const ready = await this.subs.ensureBinaryReady(2000);
+            if (!ready)
+                return null;
+        }
+        try {
+            return await this.subs.sendBinaryFrame(serialize);
+        }
+        catch {
+            // Relay hiccup (socket flapped mid-send) — let GraphQL carry this one.
+            return null;
+        }
+    }
     /**
      * Open (or re-fetch) the UDP proxy session for this game token. Idempotent:
      * if a session is already open it returns the existing status; on first open
@@ -60,6 +86,19 @@ export class UdpAPI {
      *   valid bearer game token.
      */
     async connect() {
+        if (this.subs.usingBinaryTransport()) {
+            // Binary relay mode: the relay session (opened by subscribe) IS the
+            // proxy session. Never open a parallel GraphQL proxy session for the
+            // same token — its idle teardown would deauthorize the token on the
+            // game server underneath the relay.
+            const ready = await this.subs.ensureBinaryReady();
+            return {
+                connected: ready,
+                serverIp6: null,
+                serverClientPort: null,
+                lastMessageTime: null,
+            };
+        }
         const data = await this.gql.request(ConnectUdpProxyDocument, undefined);
         return data.connectUdpProxy;
     }
@@ -73,6 +112,10 @@ export class UdpAPI {
      * @throws {CrowdyGraphQLError} on auth failures.
      */
     async disconnect() {
+        if (this.subs.usingBinaryTransport()) {
+            this.subs.disconnect();
+            return true;
+        }
         const data = await this.gql.request(DisconnectUdpProxyDocument, undefined);
         return data.disconnectUdpProxy;
     }
@@ -120,6 +163,11 @@ export class UdpAPI {
      *   token, or `BAD_USER_INPUT` for a malformed packet.
      */
     async sendActorUpdate(input) {
+        const viaRelay = await this.sendViaRelay((ctx) => serializeActorUpdate(ctx, input));
+        if (viaRelay !== null) {
+            this.record('actorUpdate', input);
+            return viaRelay;
+        }
         if (this.subs.wsUplinkReady()) {
             try {
                 const data = await this.subs.executeMutation(SendActorUpdateDocument, {
@@ -219,6 +267,11 @@ export class UdpAPI {
      * @throws {CrowdyGraphQLError} on auth/validation failures.
      */
     async sendVoxelUpdate(input) {
+        const viaRelay = await this.sendViaRelay((ctx) => serializeVoxelUpdate(ctx, input));
+        if (viaRelay !== null) {
+            this.record('voxelUpdate', input);
+            return viaRelay;
+        }
         const data = await this.gql.request(SendVoxelUpdateDocument, { input });
         this.record('voxelUpdate', input);
         return data.sendVoxelUpdate;
@@ -272,6 +325,11 @@ export class UdpAPI {
      * @throws {CrowdyGraphQLError} on auth/validation failures.
      */
     async sendAudioPacket(input) {
+        const viaRelay = await this.sendViaRelay((ctx) => serializeAudioPacket(ctx, input));
+        if (viaRelay !== null) {
+            this.record('audio', input);
+            return viaRelay;
+        }
         const data = await this.gql.request(SendAudioPacketDocument, { input });
         this.record('audio', input);
         return data.sendAudioPacket;
@@ -321,6 +379,11 @@ export class UdpAPI {
      * @throws {CrowdyGraphQLError} on auth/validation failures.
      */
     async sendTextPacket(input) {
+        const viaRelay = await this.sendViaRelay((ctx) => serializeTextPacket(ctx, input));
+        if (viaRelay !== null) {
+            this.record('text', input);
+            return viaRelay;
+        }
         const data = await this.gql.request(SendTextPacketDocument, { input });
         this.record('text', input);
         return data.sendTextPacket;
@@ -374,6 +437,11 @@ export class UdpAPI {
      * @throws {CrowdyGraphQLError} on auth/validation failures.
      */
     async sendClientEvent(input) {
+        const viaRelay = await this.sendViaRelay((ctx) => serializeClientEvent(ctx, input));
+        if (viaRelay !== null) {
+            this.record('clientEvent', input);
+            return viaRelay;
+        }
         const data = await this.gql.request(SendClientEventDocument, { input });
         this.record('clientEvent', input);
         return data.sendClientEvent;
@@ -425,6 +493,11 @@ export class UdpAPI {
      * @throws {CrowdyGraphQLError} on auth/validation failures.
      */
     async sendSingleActorMessage(input) {
+        const viaRelay = await this.sendViaRelay((ctx) => serializeSingleActorMessage(ctx, input));
+        if (viaRelay !== null) {
+            this.record('singleActorMessage', input);
+            return viaRelay;
+        }
         const data = await this.gql.request(SendSingleActorMessageDocument, {
             input,
         });
@@ -452,6 +525,11 @@ export class UdpAPI {
      * @throws {CrowdyGraphQLError} on auth/validation failures.
      */
     async sendChannelMessage(input) {
+        const viaRelay = await this.sendViaRelay((ctx) => serializeChannelMessage(ctx, input));
+        if (viaRelay !== null) {
+            this.record('channelMessage', input);
+            return viaRelay;
+        }
         const data = await this.gql.request(SendChannelMessageDocument, { input });
         this.record('channelMessage', input);
         return data.sendChannelMessage;