@crowdedkingdomstudios/crowdyjs 2.1.1 → 3.0.0

package/dist/session.js

@@ -0,0 +1,61 @@
+export class BrowserLocalStorageTokenStore {
+    constructor(key = 'crowdyjs:token') {
+        this.key = key;
+    }
+    get() {
+        if (typeof localStorage === 'undefined')
+            return null;
+        return localStorage.getItem(this.key);
+    }
+    set(token) {
+        if (typeof localStorage === 'undefined')
+            return;
+        localStorage.setItem(this.key, token);
+    }
+    clear() {
+        if (typeof localStorage === 'undefined')
+            return;
+        localStorage.removeItem(this.key);
+    }
+}
+export class SessionStore {
+    constructor(tokenStore) {
+        this.tokenStore = tokenStore;
+        this.token = null;
+        this.listeners = new Set();
+    }
+    async restore() {
+        const token = (await this.tokenStore?.get()) ?? null;
+        this.setToken(token, { persist: false });
+        return token;
+    }
+    getToken() {
+        return this.token;
+    }
+    setToken(token, options = {}) {
+        if (token === this.token)
+            return;
+        this.token = token;
+        if (options.persist !== false) {
+            if (token) {
+                void this.tokenStore?.set(token);
+            }
+            else {
+                void this.tokenStore?.clear();
+            }
+        }
+        for (const listener of [...this.listeners]) {
+            listener(token);
+        }
+    }
+    clear() {
+        this.setToken(null);
+    }
+    onChange(listener) {
+        this.listeners.add(listener);
+        listener(this.token);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+}

package/dist/subscriptions.d.ts

@@ -1,49 +1,2 @@
-/**
- * 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.
- */
-import { AuthState } from './auth-state.js';
-import type { ActorUpdateHandler, ActorUpdateResponseHandler, VoxelUpdateHandler, VoxelUpdateResponseHandler, ClientAudioHandler, ClientTextHandler, ClientEventHandler, ServerEventHandler, GenericErrorHandler, UnsubscribeFn } from './types.js';
-export interface UdpNotificationHandlers {
-    onActorUpdate?: ActorUpdateHandler;
-    onActorUpdateResponse?: ActorUpdateResponseHandler;
-    onVoxelUpdate?: VoxelUpdateHandler;
-    onVoxelUpdateResponse?: VoxelUpdateResponseHandler;
-    onClientAudio?: ClientAudioHandler;
-    onClientText?: ClientTextHandler;
-    onClientEvent?: ClientEventHandler;
-    onServerEvent?: ServerEventHandler;
-    onGenericError?: GenericErrorHandler;
-}
-export interface SubscriptionManagerConfig {
-    wsEndpoint?: string;
-}
-export declare class SubscriptionManager {
-    private readonly wsEndpoint;
-    private readonly authState;
-    private wsClient;
-    private wsUnsubscribe;
-    private subscriptionId;
-    private subscribers;
-    private nextSubscriberId;
-    constructor(config: SubscriptionManagerConfig | undefined, 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: UdpNotificationHandlers): UnsubscribeFn;
-    private ensureSubscription;
-    private startSubscription;
-    private dispatch;
-    private checkIfShouldUnsubscribe;
-    close(): void;
-}
+export { RealtimeClient as SubscriptionManager, type RealtimeConfig as SubscriptionManagerConfig, type UdpNotificationHandlers, } from './realtime.js';
 //# sourceMappingURL=subscriptions.d.ts.map

package/dist/subscriptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../src/subscriptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAEV,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,uBAAuB;IACtC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,qBAAqB,CAAC,EAAE,0BAA0B,CAAC;IACnD,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,qBAAqB,CAAC,EAAE,0BAA0B,CAAC;IACnD,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,cAAc,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAOD,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,MAAM,EAAE,yBAAyB,YAAK,EAAE,SAAS,EAAE,SAAS;IAKxE;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,uBAAuB,GAAG,aAAa;IAU3D,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,iBAAiB;IAsFzB,OAAO,CAAC,QAAQ;IA6ChB,OAAO,CAAC,wBAAwB;IAOhC,KAAK,IAAI,IAAI;CAMd"}
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../src/subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,IAAI,mBAAmB,EACrC,KAAK,cAAc,IAAI,yBAAyB,EAChD,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC"}

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/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,35 @@
+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>;
+}
+//# 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;CAehC"}

package/dist/world.js

@@ -0,0 +1,88 @@
+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,
+        });
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crowdedkingdomstudios/crowdyjs",
-  "version": "2.1.1",
+  "version": "3.0.0",
   "description": "Client SDK for Crowded Kingdoms GraphQL API with UDP proxy support",
   "type": "module",
   "main": "dist/index.js",
@@ -9,17 +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"
@@ -55,6 +64,7 @@
   },
   "dependencies": {
     "@graphql-typed-document-node/core": "^3.2.0",
-    "graphql": "^16.13.2"
+    "graphql": "^16.13.2",
+    "graphql-ws": "^6.0.8"
   }
 }