@crowdedkingdomstudios/crowdyjs 2.1.2 → 4.0.0

package/dist/realtime.d.ts

@@ -0,0 +1,89 @@
+import type { SessionStore } from './session.js';
+import type { CrowdyLogger } from './logger.js';
+import { CrowdyRealtimeError } from './errors.js';
+import { type UdpNotificationsSubscription } from './generated/graphql.js';
+export type RealtimeStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'disconnected' | 'failed';
+export type UdpNotification = NonNullable<UdpNotificationsSubscription['udpNotifications']>;
+export type SpatialNotification = Extract<UdpNotification, {
+    sequenceNumber: number;
+}>;
+export interface UdpNotificationHandlers {
+    actorUpdate?: (notification: Extract<UdpNotification, {
+        __typename?: 'ActorUpdateNotification';
+    }>) => void;
+    actorUpdateResponse?: (notification: Extract<UdpNotification, {
+        __typename?: 'ActorUpdateResponse';
+    }>) => void;
+    voxelUpdate?: (notification: Extract<UdpNotification, {
+        __typename?: 'VoxelUpdateNotification';
+    }>) => void;
+    voxelUpdateResponse?: (notification: Extract<UdpNotification, {
+        __typename?: 'VoxelUpdateResponse';
+    }>) => void;
+    audio?: (notification: Extract<UdpNotification, {
+        __typename?: 'ClientAudioNotification';
+    }>) => void;
+    text?: (notification: Extract<UdpNotification, {
+        __typename?: 'ClientTextNotification';
+    }>) => void;
+    clientEvent?: (notification: Extract<UdpNotification, {
+        __typename?: 'ClientEventNotification';
+    }>) => void;
+    serverEvent?: (notification: Extract<UdpNotification, {
+        __typename?: 'ServerEventNotification';
+    }>) => void;
+    singleActorMessage?: (notification: Extract<UdpNotification, {
+        __typename?: 'SingleActorMessageNotification';
+    }>) => void;
+    genericError?: (notification: Extract<UdpNotification, {
+        __typename?: 'GenericErrorResponse';
+    }>) => void;
+    connectionEvent?: (notification: Extract<UdpNotification, {
+        __typename?: 'RealtimeConnectionEvent';
+    }>) => void;
+    error?: (error: CrowdyRealtimeError) => void;
+    any?: (notification: UdpNotification) => void;
+}
+export interface RealtimeConfig {
+    wsUrl?: string;
+    wsEndpoint?: string;
+    retryAttempts?: number;
+    retryInitialDelayMs?: number;
+    retryMaxDelayMs?: number;
+    waitTimeoutMs?: number;
+    logger?: CrowdyLogger;
+}
+export declare class RealtimeClient {
+    private readonly session;
+    private readonly wsUrl;
+    private readonly logger;
+    private readonly retryAttempts;
+    private readonly retryInitialDelayMs;
+    private readonly retryMaxDelayMs;
+    private readonly waitTimeoutMs;
+    private client;
+    private release;
+    private desired;
+    private statusValue;
+    private readonly statusListeners;
+    private readonly subscribers;
+    private readonly pending;
+    private nextSubscriberId;
+    constructor(config: RealtimeConfig | undefined, session: SessionStore);
+    status(): RealtimeStatus;
+    onStatus(listener: (status: RealtimeStatus) => void): () => void;
+    connect(): void;
+    disconnect(): void;
+    close(): void;
+    subscribe(handlers: UdpNotificationHandlers): () => void;
+    waitForSequence(sequenceNumber: number, timeoutMs?: number): Promise<SpatialNotification>;
+    private ensureSubscription;
+    private restart;
+    private dispatch;
+    private resolvePending;
+    private removePending;
+    private rejectAllPending;
+    private dispatchError;
+    private setStatus;
+}
+//# sourceMappingURL=realtime.d.ts.map

package/dist/realtime.d.ts.map

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

package/dist/realtime.js

@@ -0,0 +1,273 @@
+import { print } from 'graphql';
+import { createClient } from 'graphql-ws';
+import { silentLogger } from './logger.js';
+import { CrowdyRealtimeError } from './errors.js';
+import { UdpNotificationsDocument, } from './generated/graphql.js';
+export class RealtimeClient {
+    constructor(config = {}, session) {
+        this.session = session;
+        this.client = null;
+        this.release = null;
+        this.desired = false;
+        this.statusValue = 'idle';
+        this.statusListeners = new Set();
+        this.subscribers = new Map();
+        this.pending = new Map();
+        this.nextSubscriberId = 1;
+        this.wsUrl = config.wsUrl || config.wsEndpoint || 'ws://localhost:3000/graphql';
+        this.logger = config.logger ?? silentLogger;
+        this.retryAttempts = config.retryAttempts ?? 8;
+        this.retryInitialDelayMs = config.retryInitialDelayMs ?? 250;
+        this.retryMaxDelayMs = config.retryMaxDelayMs ?? 5000;
+        this.waitTimeoutMs = config.waitTimeoutMs ?? 5000;
+        this.session.onChange((token) => {
+            if (!this.desired)
+                return;
+            if (!token) {
+                this.disconnect();
+                this.dispatchError(new CrowdyRealtimeError('Realtime disconnected because the session token was cleared', {
+                    code: 'AUTH_CLEARED',
+                    retryable: false,
+                }));
+                return;
+            }
+            this.restart();
+        });
+    }
+    status() {
+        return this.statusValue;
+    }
+    onStatus(listener) {
+        this.statusListeners.add(listener);
+        listener(this.statusValue);
+        return () => {
+            this.statusListeners.delete(listener);
+        };
+    }
+    connect() {
+        this.desired = true;
+        this.ensureSubscription();
+    }
+    disconnect() {
+        this.desired = false;
+        this.release?.();
+        this.release = null;
+        this.client?.dispose();
+        this.client = null;
+        this.setStatus('disconnected');
+    }
+    close() {
+        this.disconnect();
+        this.subscribers.clear();
+        this.rejectAllPending(new CrowdyRealtimeError('Realtime client closed', { retryable: false }));
+    }
+    subscribe(handlers) {
+        const id = `s${this.nextSubscriberId++}`;
+        this.subscribers.set(id, handlers);
+        this.connect();
+        return () => {
+            this.subscribers.delete(id);
+            if (this.subscribers.size === 0 && this.desired) {
+                this.disconnect();
+            }
+        };
+    }
+    waitForSequence(sequenceNumber, timeoutMs = this.waitTimeoutMs) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.removePending(sequenceNumber, wait);
+                reject(new CrowdyRealtimeError(`Timed out waiting for UDP response sequence ${sequenceNumber}`, { code: 'UDP_SEQUENCE_TIMEOUT', retryable: true }));
+            }, timeoutMs);
+            const wait = { resolve, reject, timer };
+            const waits = this.pending.get(sequenceNumber) ?? [];
+            waits.push(wait);
+            this.pending.set(sequenceNumber, waits);
+        });
+    }
+    ensureSubscription() {
+        if (this.release)
+            return;
+        const token = this.session.getToken();
+        if (!token) {
+            const error = new CrowdyRealtimeError('Must be authenticated to subscribe', {
+                code: 'AUTH_REQUIRED',
+                retryable: false,
+            });
+            this.setStatus('failed');
+            this.dispatchError(error);
+            throw error;
+        }
+        this.setStatus('connecting');
+        this.client = createClient({
+            url: this.wsUrl,
+            lazy: true,
+            retryAttempts: this.retryAttempts,
+            connectionParams: () => {
+                const currentToken = this.session.getToken();
+                return currentToken ? { Authorization: `Bearer ${currentToken}` } : {};
+            },
+            retryWait: async (retries) => {
+                this.setStatus('reconnecting');
+                const delay = Math.min(this.retryMaxDelayMs, this.retryInitialDelayMs * 2 ** retries);
+                const jitter = Math.floor(Math.random() * this.retryInitialDelayMs);
+                await new Promise((resolve) => setTimeout(resolve, delay + jitter));
+            },
+            on: {
+                connected: () => this.setStatus('connected'),
+                closed: () => {
+                    if (this.desired) {
+                        this.setStatus('reconnecting');
+                    }
+                    else {
+                        this.setStatus('disconnected');
+                    }
+                },
+                error: (error) => {
+                    this.logger.error?.('Realtime WebSocket error', error);
+                    this.dispatchError(new CrowdyRealtimeError('Realtime WebSocket error', {
+                        code: 'WEBSOCKET_ERROR',
+                        retryable: true,
+                        cause: error,
+                    }));
+                },
+            },
+        });
+        this.release = this.client.subscribe({ query: print(UdpNotificationsDocument) }, {
+            next: (message) => {
+                const data = message.data;
+                const notification = data?.udpNotifications;
+                if (notification)
+                    this.dispatch(notification);
+                if (message.errors?.length) {
+                    this.dispatchError(new CrowdyRealtimeError(message.errors[0]?.message ?? 'Subscription error', {
+                        code: 'SUBSCRIPTION_ERROR',
+                        retryable: true,
+                        cause: message.errors,
+                    }));
+                }
+            },
+            error: (error) => {
+                this.setStatus('failed');
+                this.dispatchError(new CrowdyRealtimeError('Realtime subscription failed', {
+                    code: 'SUBSCRIPTION_FAILED',
+                    retryable: true,
+                    cause: error,
+                }));
+            },
+            complete: () => {
+                this.release = null;
+                if (this.desired) {
+                    this.setStatus('reconnecting');
+                    this.ensureSubscription();
+                }
+            },
+        });
+    }
+    restart() {
+        this.release?.();
+        this.release = null;
+        this.client?.dispose();
+        this.client = null;
+        this.ensureSubscription();
+    }
+    dispatch(notification) {
+        this.resolvePending(notification);
+        for (const handlers of [...this.subscribers.values()]) {
+            try {
+                handlers.any?.(notification);
+                switch (notification.__typename) {
+                    case 'ActorUpdateNotification':
+                        handlers.actorUpdate?.(notification);
+                        break;
+                    case 'ActorUpdateResponse':
+                        handlers.actorUpdateResponse?.(notification);
+                        break;
+                    case 'VoxelUpdateNotification':
+                        handlers.voxelUpdate?.(notification);
+                        break;
+                    case 'VoxelUpdateResponse':
+                        handlers.voxelUpdateResponse?.(notification);
+                        break;
+                    case 'ClientAudioNotification':
+                        handlers.audio?.(notification);
+                        break;
+                    case 'ClientTextNotification':
+                        handlers.text?.(notification);
+                        break;
+                    case 'ClientEventNotification':
+                        handlers.clientEvent?.(notification);
+                        break;
+                    case 'ServerEventNotification':
+                        handlers.serverEvent?.(notification);
+                        break;
+                    case 'SingleActorMessageNotification':
+                        handlers.singleActorMessage?.(notification);
+                        break;
+                    case 'GenericErrorResponse':
+                        handlers.genericError?.(notification);
+                        break;
+                    case 'RealtimeConnectionEvent':
+                        handlers.connectionEvent?.(notification);
+                        break;
+                }
+            }
+            catch (error) {
+                this.logger.error?.('Realtime notification handler threw', error);
+            }
+        }
+    }
+    resolvePending(notification) {
+        if (!('sequenceNumber' in notification))
+            return;
+        const waits = this.pending.get(notification.sequenceNumber);
+        if (!waits?.length)
+            return;
+        this.pending.delete(notification.sequenceNumber);
+        for (const wait of waits) {
+            clearTimeout(wait.timer);
+            if (notification.__typename === 'GenericErrorResponse') {
+                wait.reject(new CrowdyRealtimeError(`UDP request failed: ${notification.errorCode}`, {
+                    code: notification.errorCode,
+                    retryable: false,
+                }));
+            }
+            else {
+                wait.resolve(notification);
+            }
+        }
+    }
+    removePending(sequenceNumber, wait) {
+        const waits = this.pending.get(sequenceNumber);
+        if (!waits)
+            return;
+        const next = waits.filter((candidate) => candidate !== wait);
+        if (next.length) {
+            this.pending.set(sequenceNumber, next);
+        }
+        else {
+            this.pending.delete(sequenceNumber);
+        }
+    }
+    rejectAllPending(error) {
+        for (const waits of this.pending.values()) {
+            for (const wait of waits) {
+                clearTimeout(wait.timer);
+                wait.reject(error);
+            }
+        }
+        this.pending.clear();
+    }
+    dispatchError(error) {
+        for (const handlers of [...this.subscribers.values()]) {
+            handlers.error?.(error);
+        }
+    }
+    setStatus(status) {
+        if (status === this.statusValue)
+            return;
+        this.statusValue = status;
+        for (const listener of [...this.statusListeners]) {
+            listener(status);
+        }
+    }
+}

package/dist/session.d.ts

@@ -0,0 +1,27 @@
+export type SessionListener = (token: string | null) => void;
+export interface TokenStore {
+    get(): string | null | Promise<string | null>;
+    set(token: string): void | Promise<void>;
+    clear(): void | Promise<void>;
+}
+export declare class BrowserLocalStorageTokenStore implements TokenStore {
+    private readonly key;
+    constructor(key?: string);
+    get(): string | null;
+    set(token: string): void;
+    clear(): void;
+}
+export declare class SessionStore {
+    private readonly tokenStore?;
+    private token;
+    private readonly listeners;
+    constructor(tokenStore?: TokenStore | undefined);
+    restore(): Promise<string | null>;
+    getToken(): string | null;
+    setToken(token: string | null, options?: {
+        persist?: boolean;
+    }): void;
+    clear(): void;
+    onChange(listener: SessionListener): () => void;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,GAAG,IAAI,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,qBAAa,6BAA8B,YAAW,UAAU;IAClD,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,SAAmB;IAEnD,GAAG,IAAI,MAAM,GAAG,IAAI;IAKpB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKxB,KAAK,IAAI,IAAI;CAId;AAED,qBAAa,YAAY;IAIX,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAHxC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;gBAE3B,UAAU,CAAC,EAAE,UAAU,YAAA;IAE9C,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMvC,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAiBzE,KAAK,IAAI,IAAI;IAIb,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;CAOhD"}

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"}