@crowdedkingdomstudios/crowdyjs 2.1.2 → 4.0.0

package/dist/subscriptions.js

@@ -1,192 +1 @@
-/**
- * WebSocket subscription manager for the udpNotifications stream.
- *
- * Owns one shared `graphql-transport-ws` socket and dispatches incoming
- * `udpNotifications` payloads to per-typename handler arrays. Reads its
- * bearer token from `AuthState` so HTTP and WS auth can never drift.
- *
- * Public API is now `subscribe(handlers)` which returns an unsubscribe
- * function; the per-handler `onActorUpdate` etc. shims are gone.
- */
-export class SubscriptionManager {
-    constructor(config = {}, authState) {
-        this.wsClient = null;
-        this.wsUnsubscribe = null;
-        this.subscriptionId = null;
-        this.subscribers = new Map();
-        this.nextSubscriberId = 1;
-        this.wsEndpoint = config.wsEndpoint || 'ws://localhost:3000/graphql';
-        this.authState = authState;
-    }
-    /**
-     * Register handlers for the udpNotifications stream. The first call opens
-     * the shared socket (provided we have a token); subsequent calls reuse it.
-     * The returned function detaches just this set of handlers and closes the
-     * socket once the last subscriber leaves.
-     */
-    subscribe(handlers) {
-        const id = `s${this.nextSubscriberId++}`;
-        this.subscribers.set(id, { id, handlers });
-        this.ensureSubscription();
-        return () => {
-            this.subscribers.delete(id);
-            this.checkIfShouldUnsubscribe();
-        };
-    }
-    ensureSubscription() {
-        if (!this.wsClient ||
-            (this.wsClient.readyState !== WebSocket.OPEN &&
-                this.wsClient.readyState !== WebSocket.CONNECTING)) {
-            this.startSubscription();
-        }
-    }
-    startSubscription() {
-        const token = this.authState.getToken();
-        if (!token) {
-            throw new Error('Must be authenticated to subscribe');
-        }
-        this.subscriptionId = `udp-notifications-${Date.now()}`;
-        const ws = new WebSocket(this.wsEndpoint, 'graphql-transport-ws');
-        this.wsClient = ws;
-        ws.onopen = () => {
-            ws.send(JSON.stringify({
-                type: 'connection_init',
-                payload: {
-                    Authorization: `Bearer ${token}`,
-                },
-            }));
-        };
-        ws.onmessage = (event) => {
-            try {
-                const message = JSON.parse(typeof event.data === 'string' ? event.data : '');
-                if (message.type === 'connection_ack') {
-                    ws.send(JSON.stringify({
-                        id: this.subscriptionId,
-                        type: 'subscribe',
-                        payload: { query: UDP_NOTIFICATIONS_QUERY },
-                    }));
-                }
-                else if (message.type === 'next') {
-                    if (message.payload?.data?.udpNotifications === null)
-                        return;
-                    const notification = message.payload?.data
-                        ?.udpNotifications;
-                    if (notification) {
-                        this.dispatch(notification);
-                    }
-                    else if (message.payload?.errors) {
-                        console.error('Subscription errors:', message.payload.errors);
-                    }
-                }
-                else if (message.type === 'error') {
-                    console.error('Subscription error:', message.payload);
-                }
-                else if (message.type === 'complete') {
-                    if (this.wsClient === ws)
-                        this.wsClient = null;
-                }
-                else if (message.type === 'ping') {
-                    ws.send(JSON.stringify({ type: 'pong' }));
-                }
-            }
-            catch (error) {
-                console.error('Error parsing WebSocket message:', error);
-            }
-        };
-        ws.onerror = (error) => {
-            console.error('WebSocket error:', error);
-        };
-        ws.onclose = (event) => {
-            if (event.code !== 1000) {
-                console.warn(`WebSocket closed unexpectedly: ${event.reason || event.code}`);
-            }
-            if (this.wsClient === ws)
-                this.wsClient = null;
-        };
-        this.wsUnsubscribe = () => {
-            if (ws.readyState === WebSocket.OPEN) {
-                if (this.subscriptionId) {
-                    ws.send(JSON.stringify({
-                        id: this.subscriptionId,
-                        type: 'complete',
-                    }));
-                }
-                ws.close();
-            }
-            if (this.wsClient === ws)
-                this.wsClient = null;
-            this.wsUnsubscribe = null;
-        };
-    }
-    dispatch(notification) {
-        const type = notification.__typename;
-        if (!type) {
-            console.warn('Received notification without __typename:', notification);
-            return;
-        }
-        // Snapshot the subscribers list so handlers that mutate the registry
-        // (e.g. by calling close()) don't affect this dispatch loop.
-        for (const sub of [...this.subscribers.values()]) {
-            try {
-                switch (type) {
-                    case 'ActorUpdateNotification':
-                        sub.handlers.onActorUpdate?.(notification);
-                        break;
-                    case 'ActorUpdateResponse':
-                        sub.handlers.onActorUpdateResponse?.(notification);
-                        break;
-                    case 'VoxelUpdateNotification':
-                        sub.handlers.onVoxelUpdate?.(notification);
-                        break;
-                    case 'VoxelUpdateResponse':
-                        sub.handlers.onVoxelUpdateResponse?.(notification);
-                        break;
-                    case 'ClientAudioNotification':
-                        sub.handlers.onClientAudio?.(notification);
-                        break;
-                    case 'ClientTextNotification':
-                        sub.handlers.onClientText?.(notification);
-                        break;
-                    case 'ClientEventNotification':
-                        sub.handlers.onClientEvent?.(notification);
-                        break;
-                    case 'ServerEventNotification':
-                        sub.handlers.onServerEvent?.(notification);
-                        break;
-                    case 'GenericErrorResponse':
-                        sub.handlers.onGenericError?.(notification);
-                        break;
-                }
-            }
-            catch (error) {
-                console.error(`Handler for ${type} threw:`, error);
-            }
-        }
-    }
-    checkIfShouldUnsubscribe() {
-        if (this.subscribers.size === 0 && this.wsUnsubscribe) {
-            this.wsUnsubscribe();
-            this.wsUnsubscribe = null;
-        }
-    }
-    close() {
-        this.subscribers.clear();
-        if (this.wsUnsubscribe) {
-            this.wsUnsubscribe();
-        }
-    }
-}
-const UDP_NOTIFICATIONS_QUERY = `subscription {
-  udpNotifications {
-    __typename
-    ... on ActorUpdateNotification { appId chunkX chunkY chunkZ distance decayRate uuid state sequenceNumber epochMillis }
-    ... on VoxelUpdateNotification { appId chunkX chunkY chunkZ distance decayRate uuid voxelX voxelY voxelZ voxelType voxelState sequenceNumber epochMillis }
-    ... on GenericErrorResponse { sequenceNumber errorCode }
-    ... on ActorUpdateResponse { appId chunkX chunkY chunkZ distance decayRate uuid sequenceNumber epochMillis }
-    ... on VoxelUpdateResponse { appId chunkX chunkY chunkZ distance decayRate uuid sequenceNumber epochMillis }
-    ... on ClientAudioNotification { appId chunkX chunkY chunkZ distance decayRate uuid audioData sequenceNumber epochMillis }
-    ... on ClientTextNotification { appId chunkX chunkY chunkZ distance decayRate uuid text sequenceNumber epochMillis }
-    ... on ClientEventNotification { appId chunkX chunkY chunkZ distance decayRate uuid eventType state sequenceNumber epochMillis }
-    ... on ServerEventNotification { appId chunkX chunkY chunkZ distance decayRate uuid eventType state sequenceNumber epochMillis }
-  }
-}`;
+export { RealtimeClient as SubscriptionManager, } from './realtime.js';

package/dist/types.d.ts

@@ -22,37 +22,8 @@ export interface VoxelCoordinatesInput {
     y: number;
     z: number;
 }
-export declare enum UdpErrorCode {
-    NO_ERROR = "NO_ERROR",
-    UNKNOWN_ERROR = "UNKNOWN_ERROR",
-    EMAIL_NOT_FOUND = "EMAIL_NOT_FOUND",
-    BAD_PASSWORD = "BAD_PASSWORD",
-    EMAIL_ALREADY_EXISTS = "EMAIL_ALREADY_EXISTS",
-    INVALID_TOKEN = "INVALID_TOKEN",
-    APP_NOT_FOUND = "APP_NOT_FOUND",
-    UNAUTHORIZED = "UNAUTHORIZED",
-    APP_NOT_LOADED = "APP_NOT_LOADED",
-    EMAIL_TOO_SHORT = "EMAIL_TOO_SHORT",
-    EMAIL_TOO_LONG = "EMAIL_TOO_LONG",
-    PASSWORD_TOO_SHORT = "PASSWORD_TOO_SHORT",
-    PASSWORD_TOO_LONG = "PASSWORD_TOO_LONG",
-    GAME_TOKEN_WRONG_SIZE = "GAME_TOKEN_WRONG_SIZE",
-    NAME_TOO_LONG = "NAME_TOO_LONG",
-    INVALID_REQUEST = "INVALID_REQUEST",
-    EMAIL_INVALID = "EMAIL_INVALID",
-    INVALID_TOKEN_LENGTH = "INVALID_TOKEN_LENGTH",
-    INVALID_APP_ID = "INVALID_APP_ID",
-    CHUNK_NOT_FOUND = "CHUNK_NOT_FOUND",
-    USER_NOT_AUTHENTICATED = "USER_NOT_AUTHENTICATED",
-    INVALID_STATE_DATA = "INVALID_STATE_DATA",
-    USER_NOT_APP_ADMIN = "USER_NOT_APP_ADMIN",
-    GRID_OUTSIDE_ASSIGNMENT = "GRID_OUTSIDE_ASSIGNMENT",
-    NO_MATCHING_GRID_ASSIGNMENT = "NO_MATCHING_GRID_ASSIGNMENT",
-    INVALID_GRID_COORDINATES = "INVALID_GRID_COORDINATES",
-    GRID_ALREADY_EXISTS = "GRID_ALREADY_EXISTS",
-    GRID_OVERLAPS_EXISTING = "GRID_OVERLAPS_EXISTING",
-    GAMERTAG_ALREADY_EXISTS = "GAMERTAG_ALREADY_EXISTS"
-}
+export { UdpErrorCode } from './generated/graphql.js';
+import type { UdpErrorCode } from './generated/graphql.js';
 export interface User {
     userId: BigInt;
     email?: string;

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,36 +1,8 @@
 /**
  * Type definitions for Crowded Kingdoms SDK
  */
-// Error codes
-export var UdpErrorCode;
-(function (UdpErrorCode) {
-    UdpErrorCode["NO_ERROR"] = "NO_ERROR";
-    UdpErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
-    UdpErrorCode["EMAIL_NOT_FOUND"] = "EMAIL_NOT_FOUND";
-    UdpErrorCode["BAD_PASSWORD"] = "BAD_PASSWORD";
-    UdpErrorCode["EMAIL_ALREADY_EXISTS"] = "EMAIL_ALREADY_EXISTS";
-    UdpErrorCode["INVALID_TOKEN"] = "INVALID_TOKEN";
-    UdpErrorCode["APP_NOT_FOUND"] = "APP_NOT_FOUND";
-    UdpErrorCode["UNAUTHORIZED"] = "UNAUTHORIZED";
-    UdpErrorCode["APP_NOT_LOADED"] = "APP_NOT_LOADED";
-    UdpErrorCode["EMAIL_TOO_SHORT"] = "EMAIL_TOO_SHORT";
-    UdpErrorCode["EMAIL_TOO_LONG"] = "EMAIL_TOO_LONG";
-    UdpErrorCode["PASSWORD_TOO_SHORT"] = "PASSWORD_TOO_SHORT";
-    UdpErrorCode["PASSWORD_TOO_LONG"] = "PASSWORD_TOO_LONG";
-    UdpErrorCode["GAME_TOKEN_WRONG_SIZE"] = "GAME_TOKEN_WRONG_SIZE";
-    UdpErrorCode["NAME_TOO_LONG"] = "NAME_TOO_LONG";
-    UdpErrorCode["INVALID_REQUEST"] = "INVALID_REQUEST";
-    UdpErrorCode["EMAIL_INVALID"] = "EMAIL_INVALID";
-    UdpErrorCode["INVALID_TOKEN_LENGTH"] = "INVALID_TOKEN_LENGTH";
-    UdpErrorCode["INVALID_APP_ID"] = "INVALID_APP_ID";
-    UdpErrorCode["CHUNK_NOT_FOUND"] = "CHUNK_NOT_FOUND";
-    UdpErrorCode["USER_NOT_AUTHENTICATED"] = "USER_NOT_AUTHENTICATED";
-    UdpErrorCode["INVALID_STATE_DATA"] = "INVALID_STATE_DATA";
-    UdpErrorCode["USER_NOT_APP_ADMIN"] = "USER_NOT_APP_ADMIN";
-    UdpErrorCode["GRID_OUTSIDE_ASSIGNMENT"] = "GRID_OUTSIDE_ASSIGNMENT";
-    UdpErrorCode["NO_MATCHING_GRID_ASSIGNMENT"] = "NO_MATCHING_GRID_ASSIGNMENT";
-    UdpErrorCode["INVALID_GRID_COORDINATES"] = "INVALID_GRID_COORDINATES";
-    UdpErrorCode["GRID_ALREADY_EXISTS"] = "GRID_ALREADY_EXISTS";
-    UdpErrorCode["GRID_OVERLAPS_EXISTING"] = "GRID_OVERLAPS_EXISTING";
-    UdpErrorCode["GAMERTAG_ALREADY_EXISTS"] = "GAMERTAG_ALREADY_EXISTS";
-})(UdpErrorCode || (UdpErrorCode = {}));
+// Error codes - re-exported from the codegen-derived enum so the SDK has
+// exactly one canonical UdpErrorCode shape. The hand-written enum that
+// used to live here drifted from the schema (`AppNotFound` etc.); see
+// generated/graphql.ts for the source of truth.
+export { UdpErrorCode } from './generated/graphql.js';

package/dist/utils.d.ts

@@ -0,0 +1,12 @@
+import type { ChunkCoordinatesInput } from './generated/graphql.js';
+export declare class SequenceAllocator {
+    private nextValue;
+    constructor(seed?: number);
+    next(): number;
+}
+export declare function generateCrowdyUuid(): string;
+export declare function validateCrowdyUuid(uuid: string): void;
+export declare function encodeBase64(bytes: Uint8Array): string;
+export declare function decodeBase64(value: string): Uint8Array;
+export declare function validateChunkCoordinates(chunk: ChunkCoordinatesInput): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAW,MAAM,wBAAwB,CAAC;AAE7E,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,SAAI;IAIpB,IAAI,IAAI,MAAM;CAKf;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAM3C;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAMtD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAOtD;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAS3E"}

package/dist/utils.js

@@ -0,0 +1,50 @@
+import { CrowdyProtocolError } from './errors.js';
+export class SequenceAllocator {
+    constructor(seed = 1) {
+        this.nextValue = seed & 0xff;
+    }
+    next() {
+        const value = this.nextValue;
+        this.nextValue = (this.nextValue + 1) & 0xff;
+        return value;
+    }
+}
+export function generateCrowdyUuid() {
+    const bytes = new Uint8Array(16);
+    crypto.getRandomValues(bytes);
+    return Array.from(bytes)
+        .map((byte) => byte.toString(16).padStart(2, '0'))
+        .join('');
+}
+export function validateCrowdyUuid(uuid) {
+    if (new TextEncoder().encode(uuid).length !== 32) {
+        throw new CrowdyProtocolError({
+            message: 'Crowdy UUID must be exactly 32 bytes when UTF-8 encoded',
+        });
+    }
+}
+export function encodeBase64(bytes) {
+    let binary = '';
+    for (const byte of bytes) {
+        binary += String.fromCharCode(byte);
+    }
+    return btoa(binary);
+}
+export function decodeBase64(value) {
+    const binary = atob(value);
+    const bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index += 1) {
+        bytes[index] = binary.charCodeAt(index);
+    }
+    return bytes;
+}
+export function validateChunkCoordinates(chunk) {
+    for (const axis of ['x', 'y', 'z']) {
+        const value = BigInt(chunk[axis]);
+        if (value < -9223372036854775808n || value > 9223372036854775807n) {
+            throw new CrowdyProtocolError({
+                message: `Chunk coordinate ${axis} is outside signed int64 range`,
+            });
+        }
+    }
+}

package/dist/world.d.ts

@@ -0,0 +1,44 @@
+import type { UdpAPI } from './domains/udp.js';
+import type { ActorUpdateRequestInput, ChunkCoordinatesInput, ClientEventNotificationInput, ClientTextPacketInput, Scalars, VoxelUpdateRequestInput } from './generated/graphql.js';
+import type { SpatialNotification, UdpNotificationHandlers } from './realtime.js';
+export interface ActorOptions {
+    uuid?: string;
+    defaultDistance?: number;
+    defaultDecayRate?: number;
+}
+export declare class WorldClient {
+    private readonly appId;
+    private readonly udp;
+    constructor(appId: Scalars['BigInt']['input'], udp: UdpAPI);
+    actor(options?: ActorOptions): ActorClient;
+    subscribe(handlers: UdpNotificationHandlers): () => void;
+}
+export declare class ActorClient {
+    private readonly appId;
+    private readonly udp;
+    private readonly options;
+    readonly uuid: string;
+    private chunk;
+    constructor(appId: Scalars['BigInt']['input'], udp: UdpAPI, options: Required<Pick<ActorOptions, 'uuid'>> & Pick<ActorOptions, 'defaultDistance' | 'defaultDecayRate'>);
+    join(chunk: ChunkCoordinatesInput, state?: string): Promise<SpatialNotification>;
+    sendState(state: string, options?: Partial<Pick<ActorUpdateRequestInput, 'chunk' | 'distance' | 'decayRate'>>): Promise<SpatialNotification>;
+    sendVoxelUpdate(input: Omit<VoxelUpdateRequestInput, 'appId' | 'uuid' | 'chunk'> & {
+        chunk?: ChunkCoordinatesInput;
+    }): Promise<SpatialNotification>;
+    sendText(text: string, input?: Partial<Omit<ClientTextPacketInput, 'appId' | 'uuid' | 'text' | 'chunk'>> & {
+        chunk?: ChunkCoordinatesInput;
+    }): Promise<SpatialNotification>;
+    sendEvent(eventType: number, state: string, input?: Partial<Omit<ClientEventNotificationInput, 'appId' | 'uuid' | 'eventType' | 'state' | 'chunk'>> & {
+        chunk?: ChunkCoordinatesInput;
+    }): Promise<SpatialNotification>;
+    /**
+     * Send a direct message to a single other actor, identified by its UUID and
+     * the chunk it currently occupies (the sender must know the target's chunk).
+     * Only that one actor receives it. Fire-and-forget: there is no echo to the
+     * sender, so this resolves to the send acknowledgement, not a notification.
+     */
+    sendToActor(targetUuid: string, payload: string, targetChunk: ChunkCoordinatesInput, options?: {
+        sequenceNumber?: number;
+    }): Promise<boolean>;
+}
+//# sourceMappingURL=world.d.ts.map

package/dist/world.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../src/world.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,EAC5B,qBAAqB,EACrB,OAAO,EACP,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGlF,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,GAAG,EAAE,MAAM;IAG9B,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,WAAW;IAQ9C,SAAS,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,IAAI;CAGzD;AAED,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,KAAK,CAAsC;gBAGhC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAC5D,IAAI,CAAC,YAAY,EAAE,iBAAiB,GAAG,kBAAkB,CAAC;IAMxD,IAAI,CACR,KAAK,EAAE,qBAAqB,EAC5B,KAAK,SAAS,GACb,OAAO,CAAC,mBAAmB,CAAC;IAKzB,SAAS,CACb,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC,CAAM,GACvF,OAAO,CAAC,mBAAmB,CAAC;IAgBzB,eAAe,CACnB,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG;QACjE,KAAK,CAAC,EAAE,qBAAqB,CAAC;KAC/B,GACA,OAAO,CAAC,mBAAmB,CAAC;IAczB,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG;QACjF,KAAK,CAAC,EAAE,qBAAqB,CAAC;KAC1B,GACL,OAAO,CAAC,mBAAmB,CAAC;IAezB,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,GAAG;QACvG,KAAK,CAAC,EAAE,qBAAqB,CAAC;KAC1B,GACL,OAAO,CAAC,mBAAmB,CAAC;IAgB/B;;;;;OAKG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,qBAAqB,EAClC,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAO,GACxC,OAAO,CAAC,OAAO,CAAC;CAWpB"}

package/dist/world.js

@@ -0,0 +1,105 @@
+import { generateCrowdyUuid, validateChunkCoordinates, validateCrowdyUuid } from './utils.js';
+export class WorldClient {
+    constructor(appId, udp) {
+        this.appId = appId;
+        this.udp = udp;
+    }
+    actor(options = {}) {
+        return new ActorClient(this.appId, this.udp, {
+            uuid: options.uuid ?? generateCrowdyUuid(),
+            defaultDistance: options.defaultDistance,
+            defaultDecayRate: options.defaultDecayRate,
+        });
+    }
+    subscribe(handlers) {
+        return this.udp.subscribe(handlers);
+    }
+}
+export class ActorClient {
+    constructor(appId, udp, options) {
+        this.appId = appId;
+        this.udp = udp;
+        this.options = options;
+        this.chunk = null;
+        validateCrowdyUuid(options.uuid);
+        this.uuid = options.uuid;
+    }
+    async join(chunk, state = 'AA==') {
+        this.chunk = chunk;
+        return this.sendState(state, { chunk });
+    }
+    async sendState(state, options = {}) {
+        const chunk = options.chunk ?? this.chunk;
+        if (!chunk) {
+            throw new Error('Actor must join a chunk before sending state');
+        }
+        validateChunkCoordinates(chunk);
+        return this.udp.sendActorUpdateAndWait({
+            appId: this.appId,
+            chunk,
+            uuid: this.uuid,
+            state,
+            distance: options.distance ?? this.options.defaultDistance,
+            decayRate: options.decayRate ?? this.options.defaultDecayRate,
+        });
+    }
+    async sendVoxelUpdate(input) {
+        const chunk = input.chunk ?? this.chunk;
+        if (!chunk) {
+            throw new Error('Actor must join a chunk before sending voxel updates');
+        }
+        validateChunkCoordinates(chunk);
+        return this.udp.sendVoxelUpdateAndWait({
+            ...input,
+            appId: this.appId,
+            chunk,
+            uuid: this.uuid,
+        });
+    }
+    async sendText(text, input = {}) {
+        const chunk = input.chunk ?? this.chunk;
+        if (!chunk) {
+            throw new Error('Actor must join a chunk before sending text');
+        }
+        validateChunkCoordinates(chunk);
+        return this.udp.sendTextPacketAndWait({
+            ...input,
+            appId: this.appId,
+            chunk,
+            uuid: this.uuid,
+            text,
+        });
+    }
+    async sendEvent(eventType, state, input = {}) {
+        const chunk = input.chunk ?? this.chunk;
+        if (!chunk) {
+            throw new Error('Actor must join a chunk before sending events');
+        }
+        validateChunkCoordinates(chunk);
+        return this.udp.sendClientEventAndWait({
+            ...input,
+            appId: this.appId,
+            chunk,
+            uuid: this.uuid,
+            eventType,
+            state,
+        });
+    }
+    /**
+     * Send a direct message to a single other actor, identified by its UUID and
+     * the chunk it currently occupies (the sender must know the target's chunk).
+     * Only that one actor receives it. Fire-and-forget: there is no echo to the
+     * sender, so this resolves to the send acknowledgement, not a notification.
+     */
+    async sendToActor(targetUuid, payload, targetChunk, options = {}) {
+        validateCrowdyUuid(targetUuid);
+        validateChunkCoordinates(targetChunk);
+        return this.udp.sendSingleActorMessage({
+            appId: this.appId,
+            chunk: targetChunk,
+            targetUuid,
+            payload,
+            sequenceNumber: options.sequenceNumber,
+        });
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crowdedkingdomstudios/crowdyjs",
-  "version": "2.1.2",
+  "version": "4.0.0",
   "description": "Client SDK for Crowded Kingdoms GraphQL API with UDP proxy support",
   "type": "module",
   "main": "dist/index.js",
@@ -9,19 +9,26 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./generated": {
+      "import": "./dist/generated/graphql.js",
+      "types": "./dist/generated/graphql.d.ts"
     }
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "MIGRATION.md"
   ],
   "scripts": {
     "sync-schema": "node scripts/sync-schema.mjs",
     "precodegen": "npm run sync-schema",
     "codegen": "graphql-codegen --config codegen.ts",
+    "check:schema": "npm run codegen && git diff --exit-code schema.gql src/generated/graphql.ts",
     "codegen:watch": "graphql-codegen --config codegen.ts --watch",
     "prebuild": "npm run codegen",
     "build": "tsc",
+    "test": "npm run build && node --test test/*.test.mjs",
     "watch": "tsc --watch",
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run clean && npm run build"
@@ -52,11 +59,13 @@
     "@graphql-codegen/typescript": "^5.0.10",
     "@graphql-codegen/typescript-operations": "^5.1.0",
     "@types/node": "^22.10.7",
+    "pg": "^8.21.0",
     "typescript": "^5.7.3",
     "ws": "^8.20.0"
   },
   "dependencies": {
     "@graphql-typed-document-node/core": "^3.2.0",
-    "graphql": "^16.13.2"
+    "graphql": "^16.13.2",
+    "graphql-ws": "^6.0.8"
   }
 }

package/dist/domains/appAccess.d.ts

@@ -1,23 +0,0 @@
-import type { GraphQLClient } from '../client.js';
-import { type AppAccessTiersQuery, type AppAccessTiersQueryVariables, type MyAppAccessQuery, type MyAppAccessQueryVariables, type AppUserAccessByAppQuery, type AppUserAccessByAppQueryVariables, type CreateAccessTierMutation, type CreateAccessTierMutationVariables, type UpdateAccessTierMutation, type UpdateAccessTierMutationVariables, type ArchiveAccessTierMutationVariables, type GrantAppAccessMutation, type GrantAppAccessMutationVariables, type RevokeAppAccessMutation, type RevokeAppAccessMutationVariables } from '../generated/graphql.js';
-/**
- * App access tiers + per-user app access management. Exposed as
- * `client.appAccess`.
- */
-export declare class AppAccessAPI {
-    private gql;
-    constructor(gql: GraphQLClient);
-    listTiers(appId: AppAccessTiersQueryVariables['appId']): Promise<AppAccessTiersQuery['appAccessTiers']>;
-    myAccess(appId: MyAppAccessQueryVariables['appId']): Promise<MyAppAccessQuery['myAppAccess']>;
-    listAccess(args: AppUserAccessByAppQueryVariables): Promise<AppUserAccessByAppQuery['appUserAccessByApp']>;
-    createTier(input: CreateAccessTierMutationVariables['input']): Promise<CreateAccessTierMutation['createAccessTier']>;
-    updateTier(args: UpdateAccessTierMutationVariables): Promise<UpdateAccessTierMutation['updateAccessTier']>;
-    archiveTier(tierId: ArchiveAccessTierMutationVariables['tierId']): Promise<{
-        tierId: any;
-        status: string;
-        updatedAt: any;
-    }>;
-    grant(input: GrantAppAccessMutationVariables['input']): Promise<GrantAppAccessMutation['grantAppAccess']>;
-    revoke(args: RevokeAppAccessMutationVariables): Promise<RevokeAppAccessMutation['revokeAppAccess']>;
-}
-//# sourceMappingURL=appAccess.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"appAccess.d.ts","sourceRoot":"","sources":["../../src/domains/appAccess.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EAEjC,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAE9B,KAAK,uBAAuB,EAC5B,KAAK,gCAAgC,EAErC,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EAEtC,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EAEtC,KAAK,kCAAkC,EAEvC,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EAEpC,KAAK,uBAAuB,EAC5B,KAAK,gCAAgC,EACtC,MAAM,yBAAyB,CAAC;AAEjC;;;GAGG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAEhC,SAAS,CACb,KAAK,EAAE,4BAA4B,CAAC,OAAO,CAAC,GAC3C,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IAK3C,QAAQ,CACZ,KAAK,EAAE,yBAAyB,CAAC,OAAO,CAAC,GACxC,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAKrC,UAAU,CACd,IAAI,EAAE,gCAAgC,GACrC,OAAO,CAAC,uBAAuB,CAAC,oBAAoB,CAAC,CAAC;IAKnD,UAAU,CACd,KAAK,EAAE,iCAAiC,CAAC,OAAO,CAAC,GAChD,OAAO,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;IAKlD,UAAU,CACd,IAAI,EAAE,iCAAiC,GACtC,OAAO,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;IAKlD,WAAW,CACf,MAAM,EAAE,kCAAkC,CAAC,QAAQ,CAAC,GACnD,OAAO,CAAC;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,GAAG,CAAA;KAAE,CAAC;IAKrD,KAAK,CACT,KAAK,EAAE,+BAA+B,CAAC,OAAO,CAAC,GAC9C,OAAO,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAK9C,MAAM,CACV,IAAI,EAAE,gCAAgC,GACrC,OAAO,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;CAIvD"}

package/dist/domains/appAccess.js

@@ -1,42 +0,0 @@
-import { AppAccessTiersDocument, MyAppAccessDocument, AppUserAccessByAppDocument, CreateAccessTierDocument, UpdateAccessTierDocument, ArchiveAccessTierDocument, GrantAppAccessDocument, RevokeAppAccessDocument, } from '../generated/graphql.js';
-/**
- * App access tiers + per-user app access management. Exposed as
- * `client.appAccess`.
- */
-export class AppAccessAPI {
-    constructor(gql) {
-        this.gql = gql;
-    }
-    async listTiers(appId) {
-        const data = await this.gql.request(AppAccessTiersDocument, { appId });
-        return data.appAccessTiers;
-    }
-    async myAccess(appId) {
-        const data = await this.gql.request(MyAppAccessDocument, { appId });
-        return data.myAppAccess;
-    }
-    async listAccess(args) {
-        const data = await this.gql.request(AppUserAccessByAppDocument, args);
-        return data.appUserAccessByApp;
-    }
-    async createTier(input) {
-        const data = await this.gql.request(CreateAccessTierDocument, { input });
-        return data.createAccessTier;
-    }
-    async updateTier(args) {
-        const data = await this.gql.request(UpdateAccessTierDocument, args);
-        return data.updateAccessTier;
-    }
-    async archiveTier(tierId) {
-        const data = await this.gql.request(ArchiveAccessTierDocument, { tierId });
-        return data.archiveAccessTier;
-    }
-    async grant(input) {
-        const data = await this.gql.request(GrantAppAccessDocument, { input });
-        return data.grantAppAccess;
-    }
-    async revoke(args) {
-        const data = await this.gql.request(RevokeAppAccessDocument, args);
-        return data.revokeAppAccess;
-    }
-}