@crowdedkingdoms/crowdyjs 12.0.0 → 12.2.0

package/dist/player-host/control-gate.js

@@ -0,0 +1,197 @@
+/**
+ * The game's synchronous takeover seam around CrowdyJS's lease manager.
+ * Capture listeners revoke before the game's own gameplay listeners run, but
+ * never cancel or synthesize the human event. Offline Stop stays effective
+ * with no GraphQL connection.
+ */
+export class PlayerControlGate {
+    constructor(clearAgentIntent, options = {}) {
+        this.clearAgentIntent = clearAgentIntent;
+        this.options = options;
+        this.listeners = new Set();
+        this.leaseManager = null;
+        this.controller = null;
+        this.locallyRevokedLeaseIds = new Set();
+        this.started = false;
+        this.lastHumanInputAt = Number.NEGATIVE_INFINITY;
+        this.offlineStop = false;
+        this.keyboardInput = (event) => {
+            this.takeHumanInput(event.code === 'Escape' ? 'ESCAPE' : 'HUMAN_INPUT');
+        };
+        this.pointerInput = () => {
+            this.takeHumanInput('HUMAN_INPUT');
+        };
+        this.mouseMove = (event) => {
+            if (event.movementX !== 0 || event.movementY !== 0 || event.buttons !== 0) {
+                this.takeHumanInput('HUMAN_INPUT');
+            }
+        };
+        this.pageHide = () => {
+            this.disconnected();
+        };
+        this.offline = () => {
+            this.disconnected();
+        };
+        this.visibilityChange = () => {
+            if (this.documentValue?.visibilityState === 'hidden')
+                this.disconnected();
+        };
+        this.windowValue =
+            options.window ?? (typeof window === 'undefined' ? null : window);
+        this.documentValue =
+            options.document ?? (typeof document === 'undefined' ? null : document);
+        this.now = options.now ?? Date.now;
+    }
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        const win = this.windowValue;
+        const doc = this.documentValue;
+        win?.addEventListener('keydown', this.keyboardInput, true);
+        win?.addEventListener('mousedown', this.pointerInput, true);
+        win?.addEventListener('pointerdown', this.pointerInput, true);
+        win?.addEventListener('mousemove', this.mouseMove, true);
+        win?.addEventListener('wheel', this.pointerInput, true);
+        win?.addEventListener('touchstart', this.pointerInput, true);
+        win?.addEventListener('pagehide', this.pageHide, true);
+        win?.addEventListener('offline', this.offline, true);
+        doc?.addEventListener('visibilitychange', this.visibilityChange, true);
+    }
+    destroy() {
+        if (this.started) {
+            this.started = false;
+            const win = this.windowValue;
+            const doc = this.documentValue;
+            win?.removeEventListener('keydown', this.keyboardInput, true);
+            win?.removeEventListener('mousedown', this.pointerInput, true);
+            win?.removeEventListener('pointerdown', this.pointerInput, true);
+            win?.removeEventListener('mousemove', this.mouseMove, true);
+            win?.removeEventListener('wheel', this.pointerInput, true);
+            win?.removeEventListener('touchstart', this.pointerInput, true);
+            win?.removeEventListener('pagehide', this.pageHide, true);
+            win?.removeEventListener('offline', this.offline, true);
+            doc?.removeEventListener('visibilitychange', this.visibilityChange, true);
+        }
+        this.preempt('DISCONNECTED', false);
+        this.unbind();
+        this.listeners.clear();
+    }
+    bind(leaseManager, controller) {
+        if (this.leaseManager &&
+            (this.leaseManager !== leaseManager || this.controller !== controller)) {
+            this.preempt('CLIENT_REATTACHED', false);
+        }
+        this.leaseManager = leaseManager;
+        this.controller = controller;
+        this.offlineStop = false;
+        this.emit();
+        return () => {
+            if (this.leaseManager === leaseManager &&
+                this.controller === controller) {
+                this.preempt('DISCONNECTED', false);
+                this.unbind();
+            }
+        };
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.snapshot());
+        return () => this.listeners.delete(listener);
+    }
+    snapshot() {
+        return {
+            bound: Boolean(this.leaseManager && this.controller),
+            activeLease: this.activeLease(),
+            ...(this.lastPreemption ? { lastPreemption: this.lastPreemption } : {}),
+            humanInputActive: this.humanInputActive(),
+            offlineStop: this.offlineStop,
+        };
+    }
+    humanInputActive() {
+        return (this.now() - this.lastHumanInputAt <
+            (this.options.humanInputActiveMs ?? 150));
+    }
+    preempt(reason, notifyServer = true) {
+        const lease = this.activeLease();
+        if (lease)
+            this.locallyRevokedLeaseIds.add(lease.leaseId);
+        try {
+            if (this.leaseManager)
+                this.leaseManager.preempt(reason);
+            else
+                this.clearAgentIntent(reason);
+        }
+        catch {
+            // CrowdyJS still clears the lease in its own finally block. A host
+            // cleanup bug must not interrupt the human event or offline Stop.
+        }
+        finally {
+            this.lastPreemption = reason;
+            this.options.onPreempt?.(reason);
+            this.emit();
+        }
+        if (notifyServer && lease && this.controller) {
+            void this.controller
+                .revokeLease(lease.leaseId, reason)
+                .catch(() => undefined);
+        }
+    }
+    /** Immediate local Pause; remote persistence is best effort. */
+    pause() {
+        this.preempt('HUMAN_STOP', false);
+        void this.controller?.pause().catch(() => undefined);
+    }
+    /** Immediate local Stop remains effective with no GraphQL connection. */
+    stop() {
+        this.offlineStop = true;
+        this.preempt('HUMAN_STOP', false);
+        void this.controller?.stop().catch(() => undefined);
+        this.emit();
+    }
+    death() {
+        this.preempt('DEATH');
+    }
+    contextChanged() {
+        this.preempt('CONTEXT_CHANGED');
+    }
+    permissionChanged() {
+        this.preempt('PERMISSION_CHANGED');
+    }
+    controlTargetChanged() {
+        this.preempt('CONTROL_TARGET_CHANGED');
+    }
+    disconnected() {
+        this.preempt('DISCONNECTED', false);
+    }
+    activeLease() {
+        const local = this.leaseManager?.snapshot().lease;
+        if (local?.status === 'ACTIVE' &&
+            !this.locallyRevokedLeaseIds.has(local.leaseId)) {
+            return local;
+        }
+        return (this.controller
+            ?.getState()
+            .leases.find((lease) => lease.kind === 'PLAY' &&
+            lease.status === 'ACTIVE' &&
+            !this.locallyRevokedLeaseIds.has(lease.leaseId)) ?? null);
+    }
+    unbind() {
+        this.leaseManager = null;
+        this.controller = null;
+        this.locallyRevokedLeaseIds.clear();
+        this.emit();
+    }
+    takeHumanInput(reason) {
+        this.lastHumanInputAt = this.now();
+        if (this.activeLease())
+            this.preempt(reason);
+        else
+            this.emit();
+    }
+    emit() {
+        const snapshot = this.snapshot();
+        for (const listener of [...this.listeners])
+            listener(snapshot);
+    }
+}

package/dist/player-host/index.d.ts

@@ -1,5 +1,7 @@
 export { AgentControlLeaseManager, type AgentControlDispatchV1, type AgentControlLeaseManagerOptionsV1, type AgentControlLeaseSnapshotV1, type AgentObservationDispatchV1, } from './lease-manager.js';
 export { GAME_COMMAND_RESULT_SCHEMA_V1, GAME_COMMAND_SCHEMAS_V1, GAME_COMMAND_SCHEMA_V1, GAME_OBSERVATION_SCHEMA_V1, OBSERVE_REQUEST_SCHEMA_V1, PLAYER_HOST_CAPABILITIES_SCHEMA_V1, } from './schemas.js';
 export { createPlayerHostAgentTools, type PlayerHostAgentToolsV1, } from './tools.js';
+export { PlayerControlGate, type PlayerControlGateAgentControl, type PlayerControlGateOptions, type PlayerControlGateSnapshot, } from './control-gate.js';
+export { AGENT_CONTROL_BANNER_STYLES, AgentControlBanner, ensureAgentControlBannerStyles, type AgentControlBannerController, } from './control-banner.js';
 export type { GameChatSendCommandV1, GameCombatAttackCommandV1, GameCommandResultV1, GameCommandV1, GameCraftCommandV1, GameInteractCommandV1, GameInventoryConsumeCommandV1, GameInventorySelectCommandV1, GameInventoryTransferCommandV1, GameLookCommandV1, GameMountCommandV1, GameMoveCommandV1, GameObservationActorV1, GameObservationInventoryV1, GameObservationV1, GameStopCommandV1, GameTravelTeleportCommandV1, ObserveRequestV1, PlayerHostAdapterV1, PlayerHostCapabilitiesV1, PlayerHostCommandCapabilityV1, PlayerHostCommandKind, PlayerHostLeaseScope, PlayerHostLookV1, PlayerHostVector3V1, ValidatedGateV1, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/player-host/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/player-host/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,iCAAiC,EACtC,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,GAChC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,kCAAkC,GACnC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,0BAA0B,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,6BAA6B,EAC7B,4BAA4B,EAC5B,8BAA8B,EAC9B,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,EAC1B,iBAAiB,EACjB,iBAAiB,EACjB,2BAA2B,EAC3B,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/player-host/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,iCAAiC,EACtC,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,GAChC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,kCAAkC,GACnC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,0BAA0B,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,8BAA8B,EAC9B,KAAK,4BAA4B,GAClC,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,6BAA6B,EAC7B,4BAA4B,EAC5B,8BAA8B,EAC9B,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,EAC1B,iBAAiB,EACjB,iBAAiB,EACjB,2BAA2B,EAC3B,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/player-host/index.js

@@ -1,3 +1,5 @@
 export { AgentControlLeaseManager, } from './lease-manager.js';
 export { GAME_COMMAND_RESULT_SCHEMA_V1, GAME_COMMAND_SCHEMAS_V1, GAME_COMMAND_SCHEMA_V1, GAME_OBSERVATION_SCHEMA_V1, OBSERVE_REQUEST_SCHEMA_V1, PLAYER_HOST_CAPABILITIES_SCHEMA_V1, } from './schemas.js';
 export { createPlayerHostAgentTools, } from './tools.js';
+export { PlayerControlGate, } from './control-gate.js';
+export { AGENT_CONTROL_BANNER_STYLES, AgentControlBanner, ensureAgentControlBannerStyles, } from './control-banner.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crowdedkingdoms/crowdyjs",
-  "version": "12.0.0",
+  "version": "12.2.0",
   "description": "Browser-first Crowded Kingdoms SDK with GraphQL, realtime, and local Rust authoring support",
   "type": "module",
   "main": "dist/index.js",
@@ -29,6 +29,10 @@
     "./player-host": {
       "import": "./dist/player-host/index.js",
       "types": "./dist/player-host/index.d.ts"
+    },
+    "./player-glue-worker": {
+      "import": "./dist/player-runtime/player-glue-worker.js",
+      "types": "./dist/player-runtime/player-glue-worker.d.ts"
     }
   },
   "sideEffects": false,
@@ -88,6 +92,7 @@
     "@graphql-codegen/typescript-operations": "^5.1.0",
     "@graphql-tools/merge": "^9.1.10",
     "@types/node": "^22.10.7",
+    "happy-dom": "^20.11.1",
     "typescript": "^5.7.3",
     "ws": "^8.21.1"
   },