@crowdedkingdomstudios/crowdyjs 2.1.1 → 3.0.0

package/dist/auth-state.d.ts

@@ -1,21 +1,11 @@
+import { SessionStore, type SessionListener, type TokenStore } from './session.js';
+export type AuthStateListener = SessionListener;
 /**
- * Single source of truth for the auth token within one CrowdyClient instance.
- *
- * Both the HTTP client (`GraphQLClient`) and the WebSocket subscription
- * manager observe this. Anything that mutates auth state - the typed
- * `client.auth.login()` / `register()` / `logout()` family, or external
- * callers - flows through `setToken()` so subscription requests can never
- * silently fail with "Must be authenticated to subscribe".
- *
- * (Replaces the previous arrangement where GraphQLClient and
- * SubscriptionManager each held their own copy of the token.)
+ * Backwards-compatible internal name for the v3 SessionStore. Public callers
+ * should use `client.session`; older domain wrappers still accept AuthState.
  */
-export type AuthStateListener = (token: string | null) => void;
-export declare class AuthState {
-    private token;
-    private listeners;
-    getToken(): string | null;
-    setToken(token: string | null): void;
+export declare class AuthState extends SessionStore {
+    constructor(tokenStore?: TokenStore);
     subscribe(listener: AuthStateListener): () => void;
 }
 //# sourceMappingURL=auth-state.d.ts.map

package/dist/auth-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-state.d.ts","sourceRoot":"","sources":["../src/auth-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAE/D,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,SAAS,CAAgC;IAEjD,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAYpC,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;CAQnD"}
+{"version":3,"file":"auth-state.d.ts","sourceRoot":"","sources":["../src/auth-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAEnF,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEhD;;;GAGG;AACH,qBAAa,SAAU,SAAQ,YAAY;gBAC7B,UAAU,CAAC,EAAE,UAAU;IAInC,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;CAGnD"}

package/dist/auth-state.js

@@ -1,30 +1,13 @@
-export class AuthState {
-    constructor() {
-        this.token = null;
-        this.listeners = new Set();
-    }
-    getToken() {
-        return this.token;
-    }
-    setToken(token) {
-        if (token === this.token)
-            return;
-        this.token = token;
-        for (const listener of this.listeners) {
-            try {
-                listener(token);
-            }
-            catch (error) {
-                console.error('AuthState listener threw:', error);
-            }
-        }
+import { SessionStore } from './session.js';
+/**
+ * Backwards-compatible internal name for the v3 SessionStore. Public callers
+ * should use `client.session`; older domain wrappers still accept AuthState.
+ */
+export class AuthState extends SessionStore {
+    constructor(tokenStore) {
+        super(tokenStore);
     }
     subscribe(listener) {
-        this.listeners.add(listener);
-        // Replay current value immediately so listeners initialize correctly.
-        listener(this.token);
-        return () => {
-            this.listeners.delete(listener);
-        };
+        return this.onChange(listener);
     }
 }

package/dist/client.d.ts

@@ -7,27 +7,36 @@
  * `client.auth.login`, `client.udp.sendActorUpdate`).
  */
 import type { TypedDocumentNode } from '@graphql-typed-document-node/core';
-import { AuthState } from './auth-state.js';
+import type { SessionStore } from './session.js';
+import type { CrowdyLogger } from './logger.js';
 export interface GraphQLClientConfig {
+    httpUrl?: string;
     graphqlEndpoint?: string;
     timeout?: number;
+    logger?: CrowdyLogger;
 }
 export declare class GraphQLClient {
     private readonly graphqlEndpoint;
     private readonly timeout;
-    private readonly authState;
-    constructor(config: GraphQLClientConfig | undefined, authState: AuthState);
+    private readonly session;
+    private readonly logger;
+    constructor(config: GraphQLClientConfig | undefined, session: SessionStore);
     getEndpoint(): string;
     /**
      * Execute a typed GraphQL operation produced by codegen and return the
      * `data` payload. Throws on transport errors, GraphQL errors, or timeouts.
      */
-    request<TResult, TVariables>(document: TypedDocumentNode<TResult, TVariables>, variables?: TVariables): Promise<TResult>;
+    request<TResult, TVariables>(document: TypedDocumentNode<TResult, TVariables>, variables?: TVariables, options?: {
+        signal?: AbortSignal;
+    }): Promise<TResult>;
     /**
      * Internal escape hatch for raw query strings (used by hand-written
      * adapters that haven't migrated to typed documents yet). Prefer
      * `request()` with a `TypedDocumentNode`.
      */
-    query<T = any>(query: string, variables?: Record<string, any>): Promise<T>;
+    query<T = any>(query: string, variables?: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+    }): Promise<T>;
 }
+export { GraphQLClient as GraphQLTransport };
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,MAAM,EAAE,mBAAmB,YAAK,EAAE,SAAS,EAAE,SAAS;IAOlE,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,UAAU,EAC/B,QAAQ,EAAE,iBAAiB,CAAC,OAAO,EAAE,UAAU,CAAC,EAChD,SAAS,CAAC,EAAE,UAAU,GACrB,OAAO,CAAC,OAAO,CAAC;IAKnB;;;;OAIG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAClC,OAAO,CAAC,CAAC,CAAC;CAgDd"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAWhD,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,mBAAmB,YAAK,EAAE,OAAO,EAAE,YAAY;IAQnE,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,UAAU,EAC/B,QAAQ,EAAE,iBAAiB,CAAC,OAAO,EAAE,UAAU,CAAC,EAChD,SAAS,CAAC,EAAE,UAAU,EACtB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACrC,OAAO,CAAC,OAAO,CAAC;IASnB;;;;OAIG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACvC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACrC,OAAO,CAAC,CAAC,CAAC;CA+Cd;AAED,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/client.js

@@ -7,12 +7,15 @@
  * `client.auth.login`, `client.udp.sendActorUpdate`).
  */
 import { print } from 'graphql';
+import { silentLogger } from './logger.js';
+import { CrowdyError, CrowdyGraphQLError, CrowdyHttpError, CrowdyNetworkError, CrowdyTimeoutError, } from './errors.js';
 export class GraphQLClient {
-    constructor(config = {}, authState) {
+    constructor(config = {}, session) {
         this.graphqlEndpoint =
-            config.graphqlEndpoint || 'http://localhost:3000/graphql';
+            config.httpUrl || config.graphqlEndpoint || 'http://localhost:3000/graphql';
         this.timeout = config.timeout || 60000;
-        this.authState = authState;
+        this.session = session;
+        this.logger = config.logger ?? silentLogger;
     }
     getEndpoint() {
         return this.graphqlEndpoint;
@@ -21,19 +24,20 @@ export class GraphQLClient {
      * Execute a typed GraphQL operation produced by codegen and return the
      * `data` payload. Throws on transport errors, GraphQL errors, or timeouts.
      */
-    async request(document, variables) {
+    async request(document, variables, options = {}) {
         const queryStr = print(document);
-        return this.query(queryStr, (variables ?? {}));
+        return this.query(queryStr, (variables ?? {}), options);
     }
     /**
      * Internal escape hatch for raw query strings (used by hand-written
      * adapters that haven't migrated to typed documents yet). Prefer
      * `request()` with a `TypedDocumentNode`.
      */
-    async query(query, variables = {}) {
+    async query(query, variables = {}, options = {}) {
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-        const token = this.authState.getToken();
+        const token = this.session.getToken();
+        const signal = options.signal ?? controller.signal;
         try {
             const requestBody = { query, variables };
             const response = await fetch(this.graphqlEndpoint, {
@@ -43,32 +47,33 @@ export class GraphQLClient {
                     ...(token ? { Authorization: `Bearer ${token}` } : {}),
                 },
                 body: JSON.stringify(requestBody),
-                signal: controller.signal,
+                signal,
             });
             clearTimeout(timeoutId);
             if (!response.ok) {
                 const errorText = await response.text();
-                throw new Error(`HTTP error! status: ${response.status}, body: ${errorText}`);
+                throw new CrowdyHttpError(response.status, errorText);
             }
             const result = await response.json();
             if (result.errors) {
-                const error = result.errors[0];
-                const errorMessage = Array.isArray(error.message)
-                    ? error.message.join(', ')
-                    : error.message;
-                throw new Error(errorMessage);
+                throw new CrowdyGraphQLError(result.errors);
             }
             return result.data;
         }
         catch (error) {
             clearTimeout(timeoutId);
             if (error instanceof Error && error.name === 'AbortError') {
-                throw new Error('Request timeout exceeded when trying to connect');
+                throw new CrowdyTimeoutError(this.timeout);
             }
-            if (error instanceof Error) {
+            if (error instanceof CrowdyError) {
                 throw error;
             }
-            throw new Error(`Network error: ${error}`);
+            if (error instanceof Error) {
+                throw new CrowdyNetworkError(error);
+            }
+            this.logger.error?.('GraphQL request failed', error);
+            throw new CrowdyNetworkError(error);
         }
     }
 }
+export { GraphQLClient as GraphQLTransport };

package/dist/crowdy-client.d.ts

@@ -5,6 +5,12 @@
  * shortcuts are gone - use `client.auth.login()` / `client.udp.sendActorUpdate()`
  * instead.
  */
+import { AuthState } from './auth-state.js';
+import { GraphQLClient } from './client.js';
+import { SubscriptionManager } from './subscriptions.js';
+import type { CrowdyLogger } from './logger.js';
+import type { TokenStore } from './session.js';
+import { WorldClient } from './world.js';
 import { AuthAPI } from './domains/auth.js';
 import { UsersAPI } from './domains/users.js';
 import { OrganizationsAPI } from './domains/organizations.js';
@@ -21,14 +27,24 @@ import { StateAPI } from './domains/state.js';
 import { ServerStatusAPI } from './domains/serverStatus.js';
 import { UdpAPI } from './domains/udp.js';
 export interface CrowdyClientConfig {
+    httpUrl?: string;
+    wsUrl?: string;
     graphqlEndpoint?: string;
     wsEndpoint?: string;
     timeout?: number;
+    tokenStore?: TokenStore;
+    logger?: CrowdyLogger;
+    realtime?: {
+        retryAttempts?: number;
+        retryInitialDelayMs?: number;
+        retryMaxDelayMs?: number;
+        waitTimeoutMs?: number;
+    };
 }
 export declare class CrowdyClient {
-    private readonly authState;
-    private readonly client;
-    private readonly subscriptions;
+    readonly session: AuthState;
+    readonly graphql: GraphQLClient;
+    readonly realtime: SubscriptionManager;
     readonly auth: AuthAPI;
     readonly users: UsersAPI;
     readonly orgs: OrganizationsAPI;
@@ -45,7 +61,9 @@ export declare class CrowdyClient {
     readonly serverStatus: ServerStatusAPI;
     readonly udp: UdpAPI;
     constructor(config?: CrowdyClientConfig);
+    world(appId: string): WorldClient;
     /** Closes the WebSocket and clears the in-memory auth token. */
     close(): void;
 }
+export declare function createCrowdyClient(config?: CrowdyClientConfig): CrowdyClient;
 //# sourceMappingURL=crowdy-client.d.ts.map

package/dist/crowdy-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crowdy-client.d.ts","sourceRoot":"","sources":["../src/crowdy-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAY;IAGvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IAGpD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,MAAM,GAAE,kBAAuB;IA4B3C,gEAAgE;IAChE,KAAK,IAAI,IAAI;CAId"}
+{"version":3,"file":"crowdy-client.d.ts","sourceRoot":"","sources":["../src/crowdy-client.ts"],"names":[],"mappings":"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"}

package/dist/crowdy-client.js

@@ -8,6 +8,7 @@
 import { AuthState } from './auth-state.js';
 import { GraphQLClient } from './client.js';
 import { SubscriptionManager } from './subscriptions.js';
+import { WorldClient } from './world.js';
 import { AuthAPI } from './domains/auth.js';
 import { UsersAPI } from './domains/users.js';
 import { OrganizationsAPI } from './domains/organizations.js';
@@ -25,28 +26,44 @@ import { ServerStatusAPI } from './domains/serverStatus.js';
 import { UdpAPI } from './domains/udp.js';
 export class CrowdyClient {
     constructor(config = {}) {
-        this.authState = new AuthState();
-        this.client = new GraphQLClient({ graphqlEndpoint: config.graphqlEndpoint, timeout: config.timeout }, this.authState);
-        this.subscriptions = new SubscriptionManager({ wsEndpoint: config.wsEndpoint }, this.authState);
-        this.auth = new AuthAPI(this.client, this.authState);
-        this.users = new UsersAPI(this.client);
-        this.orgs = new OrganizationsAPI(this.client);
-        this.apps = new AppsAPI(this.client);
-        this.appAccess = new AppAccessAPI(this.client);
-        this.billing = new BillingAPI(this.client);
-        this.quotas = new QuotasAPI(this.client);
-        this.payments = new PaymentsAPI(this.client);
-        this.chunks = new ChunksAPI(this.client);
-        this.voxels = new VoxelsAPI(this.client);
-        this.actors = new ActorsAPI(this.client);
-        this.teleport = new TeleportAPI(this.client);
-        this.state = new StateAPI(this.client);
-        this.serverStatus = new ServerStatusAPI(this.client);
-        this.udp = new UdpAPI(this.client, this.subscriptions);
+        this.session = new AuthState(config.tokenStore);
+        this.graphql = new GraphQLClient({
+            httpUrl: config.httpUrl,
+            graphqlEndpoint: config.graphqlEndpoint,
+            timeout: config.timeout,
+            logger: config.logger,
+        }, this.session);
+        this.realtime = new SubscriptionManager({
+            wsUrl: config.wsUrl,
+            wsEndpoint: config.wsEndpoint,
+            logger: config.logger,
+            ...config.realtime,
+        }, this.session);
+        this.auth = new AuthAPI(this.graphql, this.session);
+        this.users = new UsersAPI(this.graphql);
+        this.orgs = new OrganizationsAPI(this.graphql);
+        this.apps = new AppsAPI(this.graphql);
+        this.appAccess = new AppAccessAPI(this.graphql);
+        this.billing = new BillingAPI(this.graphql);
+        this.quotas = new QuotasAPI(this.graphql);
+        this.payments = new PaymentsAPI(this.graphql);
+        this.chunks = new ChunksAPI(this.graphql);
+        this.voxels = new VoxelsAPI(this.graphql);
+        this.actors = new ActorsAPI(this.graphql);
+        this.teleport = new TeleportAPI(this.graphql);
+        this.state = new StateAPI(this.graphql);
+        this.serverStatus = new ServerStatusAPI(this.graphql);
+        this.udp = new UdpAPI(this.graphql, this.realtime);
+    }
+    world(appId) {
+        return new WorldClient(appId, this.udp);
     }
     /** Closes the WebSocket and clears the in-memory auth token. */
     close() {
-        this.subscriptions.close();
-        this.authState.setToken(null);
+        this.realtime.close();
+        this.session.setToken(null);
     }
 }
+export function createCrowdyClient(config = {}) {
+    return new CrowdyClient(config);
+}

package/dist/domains/serverStatus.d.ts

@@ -1,5 +1,5 @@
 import type { GraphQLClient } from '../client.js';
-import { type ServerWithLeastClientsQuery, type GraphqlServersQuery, type ActiveGraphQlServersQuery, type VersionInfoQuery } from '../generated/graphql.js';
+import { type ServerWithLeastClientsQuery, type GraphqlServersQuery, type ActiveGraphQlServersQuery, type VersionInfoQuery, type GameClientBootstrapQuery, type GameClientBootstrapQueryVariables } from '../generated/graphql.js';
 /**
  * Server status / version info queries.
  *
@@ -17,5 +17,6 @@ export declare class ServerStatusAPI {
     listAll(): Promise<GraphqlServersQuery['graphqlServers']>;
     listActiveGraphqlServers(): Promise<ActiveGraphQlServersQuery['activeGraphQLServers']>;
     versionInfo(): Promise<VersionInfoQuery['versionInfo']>;
+    gameClientBootstrap(appId: GameClientBootstrapQueryVariables['appId']): Promise<GameClientBootstrapQuery['gameClientBootstrap']>;
 }
 //# sourceMappingURL=serverStatus.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"serverStatus.d.ts","sourceRoot":"","sources":["../../src/domains/serverStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAEL,KAAK,2BAA2B,EAEhC,KAAK,mBAAmB,EAExB,KAAK,yBAAyB,EAE9B,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;GASG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAEhC,sBAAsB,IAAI,OAAO,CAAC,2BAA2B,CAAC,wBAAwB,CAAC,CAAC;IAKxF,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IAKzD,wBAAwB,IAAI,OAAO,CAAC,yBAAyB,CAAC,sBAAsB,CAAC,CAAC;IAKtF,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;CAI9D"}
+{"version":3,"file":"serverStatus.d.ts","sourceRoot":"","sources":["../../src/domains/serverStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAEL,KAAK,2BAA2B,EAEhC,KAAK,mBAAmB,EAExB,KAAK,yBAAyB,EAE9B,KAAK,gBAAgB,EAErB,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EACvC,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;GASG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAEhC,sBAAsB,IAAI,OAAO,CAAC,2BAA2B,CAAC,wBAAwB,CAAC,CAAC;IAKxF,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IAKzD,wBAAwB,IAAI,OAAO,CAAC,yBAAyB,CAAC,sBAAsB,CAAC,CAAC;IAKtF,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAKvD,mBAAmB,CACvB,KAAK,EAAE,iCAAiC,CAAC,OAAO,CAAC,GAChD,OAAO,CAAC,wBAAwB,CAAC,qBAAqB,CAAC,CAAC;CAI5D"}

package/dist/domains/serverStatus.js

@@ -1,4 +1,4 @@
-import { ServerWithLeastClientsDocument, GraphqlServersDocument, ActiveGraphQlServersDocument, VersionInfoDocument, } from '../generated/graphql.js';
+import { ServerWithLeastClientsDocument, GraphqlServersDocument, ActiveGraphQlServersDocument, VersionInfoDocument, GameClientBootstrapDocument, } from '../generated/graphql.js';
 /**
  * Server status / version info queries.
  *
@@ -29,4 +29,8 @@ export class ServerStatusAPI {
         const data = await this.gql.request(VersionInfoDocument, undefined);
         return data.versionInfo;
     }
+    async gameClientBootstrap(appId) {
+        const data = await this.gql.request(GameClientBootstrapDocument, { appId });
+        return data.gameClientBootstrap;
+    }
 }

package/dist/domains/udp.d.ts

@@ -1,7 +1,7 @@
 import type { GraphQLClient } from '../client.js';
 import type { SubscriptionManager, UdpNotificationHandlers } from '../subscriptions.js';
 import { type ConnectUdpProxyMutation, type UdpProxyConnectionStatusQuery, type SendActorUpdateMutationVariables, type SendVoxelUpdateMutationVariables, type SendAudioPacketMutationVariables, type SendTextPacketMutationVariables, type SendClientEventMutationVariables } from '../generated/graphql.js';
-import type { UnsubscribeFn } from '../types.js';
+import type { SpatialNotification } from '../realtime.js';
 /**
  * UDP proxy access for browser-style clients that can't open raw UDP
  * sockets. Exposed as `client.udp`. All send mutations go over the same
@@ -12,21 +12,38 @@ import type { UnsubscribeFn } from '../types.js';
 export declare class UdpAPI {
     private gql;
     private subs;
+    private readonly sequences;
     constructor(gql: GraphQLClient, subs: SubscriptionManager);
     connect(): Promise<ConnectUdpProxyMutation['connectUdpProxy']>;
     disconnect(): Promise<boolean>;
     connectionStatus(): Promise<UdpProxyConnectionStatusQuery['udpProxyConnectionStatus']>;
     sendActorUpdate(input: SendActorUpdateMutationVariables['input']): Promise<boolean>;
+    sendActorUpdateAndWait(input: SendActorUpdateMutationVariables['input'], options?: {
+        timeoutMs?: number;
+    }): Promise<SpatialNotification>;
     sendVoxelUpdate(input: SendVoxelUpdateMutationVariables['input']): Promise<boolean>;
+    sendVoxelUpdateAndWait(input: SendVoxelUpdateMutationVariables['input'], options?: {
+        timeoutMs?: number;
+    }): Promise<SpatialNotification>;
     sendAudioPacket(input: SendAudioPacketMutationVariables['input']): Promise<boolean>;
+    sendAudioPacketAndWait(input: SendAudioPacketMutationVariables['input'], options?: {
+        timeoutMs?: number;
+    }): Promise<SpatialNotification>;
     sendTextPacket(input: SendTextPacketMutationVariables['input']): Promise<boolean>;
+    sendTextPacketAndWait(input: SendTextPacketMutationVariables['input'], options?: {
+        timeoutMs?: number;
+    }): Promise<SpatialNotification>;
     sendClientEvent(input: SendClientEventMutationVariables['input']): Promise<boolean>;
+    sendClientEventAndWait(input: SendClientEventMutationVariables['input'], options?: {
+        timeoutMs?: number;
+    }): Promise<SpatialNotification>;
     /**
      * Subscribe to udpNotifications. Pass any combination of typename
      * handlers; the returned function detaches all of them. The first
      * subscriber opens the shared WebSocket; the last one to leave closes
      * it.
      */
-    subscribe(handlers: UdpNotificationHandlers): UnsubscribeFn;
+    subscribe(handlers: UdpNotificationHandlers): () => void;
+    private withSequence;
 }
 //# sourceMappingURL=udp.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"udp.d.ts","sourceRoot":"","sources":["../../src/domains/udp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAEL,KAAK,uBAAuB,EAG5B,KAAK,6BAA6B,EAElC,KAAK,gCAAgC,EAErC,KAAK,gCAAgC,EAErC,KAAK,gCAAgC,EAErC,KAAK,+BAA+B,EAEpC,KAAK,gCAAgC,EACtC,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;GAMG;AACH,qBAAa,MAAM;IAEf,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,IAAI;gBADJ,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,mBAAmB;IAG7B,OAAO,IAAI,OAAO,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;IAK9D,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAK9B,gBAAgB,IAAI,OAAO,CAC/B,6BAA6B,CAAC,0BAA0B,CAAC,CAC1D;IAQK,eAAe,CACnB,KAAK,EAAE,gCAAgC,CAAC,OAAO,CAAC,GAC/C,OAAO,CAAC,OAAO,CAAC;IAKb,eAAe,CACnB,KAAK,EAAE,gCAAgC,CAAC,OAAO,CAAC,GAC/C,OAAO,CAAC,OAAO,CAAC;IAKb,eAAe,CACnB,KAAK,EAAE,gCAAgC,CAAC,OAAO,CAAC,GAC/C,OAAO,CAAC,OAAO,CAAC;IAKb,cAAc,CAClB,KAAK,EAAE,+BAA+B,CAAC,OAAO,CAAC,GAC9C,OAAO,CAAC,OAAO,CAAC;IAKb,eAAe,CACnB,KAAK,EAAE,gCAAgC,CAAC,OAAO,CAAC,GAC/C,OAAO,CAAC,OAAO,CAAC;IAKnB;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,uBAAuB,GAAG,aAAa;CAG5D"}
+{"version":3,"file":"udp.d.ts","sourceRoot":"","sources":["../../src/domains/udp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAEL,KAAK,uBAAuB,EAG5B,KAAK,6BAA6B,EAElC,KAAK,gCAAgC,EAErC,KAAK,gCAAgC,EAErC,KAAK,gCAAgC,EAErC,KAAK,+BAA+B,EAEpC,KAAK,gCAAgC,EACtC,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG1D;;;;;;GAMG;AACH,qBAAa,MAAM;IAIf,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,IAAI;IAJd,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;gBAG3C,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,mBAAmB;IAG7B,OAAO,IAAI,OAAO,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;IAK9D,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAK9B,gBAAgB,IAAI,OAAO,CAC/B,6BAA6B,CAAC,0BAA0B,CAAC,CAC1D;IAQK,eAAe,CACnB,KAAK,EAAE,gCAAgC,CAAC,OAAO,CAAC,GAC/C,OAAO,CAAC,OAAO,CAAC;IAKb,sBAAsB,CAC1B,KAAK,EAAE,gCAAgC,CAAC,OAAO,CAAC,EAChD,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,mBAAmB,CAAC;IAOzB,eAAe,CACnB,KAAK,EAAE,gCAAgC,CAAC,OAAO,CAAC,GAC/C,OAAO,CAAC,OAAO,CAAC;IAKb,sBAAsB,CAC1B,KAAK,EAAE,gCAAgC,CAAC,OAAO,CAAC,EAChD,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,mBAAmB,CAAC;IAOzB,eAAe,CACnB,KAAK,EAAE,gCAAgC,CAAC,OAAO,CAAC,GAC/C,OAAO,CAAC,OAAO,CAAC;IAKb,sBAAsB,CAC1B,KAAK,EAAE,gCAAgC,CAAC,OAAO,CAAC,EAChD,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,mBAAmB,CAAC;IAOzB,cAAc,CAClB,KAAK,EAAE,+BAA+B,CAAC,OAAO,CAAC,GAC9C,OAAO,CAAC,OAAO,CAAC;IAKb,qBAAqB,CACzB,KAAK,EAAE,+BAA+B,CAAC,OAAO,CAAC,EAC/C,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,mBAAmB,CAAC;IAOzB,eAAe,CACnB,KAAK,EAAE,gCAAgC,CAAC,OAAO,CAAC,GAC/C,OAAO,CAAC,OAAO,CAAC;IAKb,sBAAsB,CAC1B,KAAK,EAAE,gCAAgC,CAAC,OAAO,CAAC,EAChD,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,mBAAmB,CAAC;IAO/B;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,IAAI;IAIxD,OAAO,CAAC,YAAY;CAQrB"}

package/dist/domains/udp.js

@@ -1,4 +1,5 @@
 import { ConnectUdpProxyDocument, DisconnectUdpProxyDocument, UdpProxyConnectionStatusDocument, SendActorUpdateDocument, SendVoxelUpdateDocument, SendAudioPacketDocument, SendTextPacketDocument, SendClientEventDocument, } from '../generated/graphql.js';
+import { SequenceAllocator } from '../utils.js';
 /**
  * UDP proxy access for browser-style clients that can't open raw UDP
  * sockets. Exposed as `client.udp`. All send mutations go over the same
@@ -10,6 +11,7 @@ export class UdpAPI {
     constructor(gql, subs) {
         this.gql = gql;
         this.subs = subs;
+        this.sequences = new SequenceAllocator();
     }
     async connect() {
         const data = await this.gql.request(ConnectUdpProxyDocument, undefined);
@@ -27,22 +29,52 @@ export class UdpAPI {
         const data = await this.gql.request(SendActorUpdateDocument, { input });
         return data.sendActorUpdate;
     }
+    async sendActorUpdateAndWait(input, options = {}) {
+        const request = this.withSequence(input);
+        const wait = this.subs.waitForSequence(request.sequenceNumber, options.timeoutMs);
+        await this.sendActorUpdate(request);
+        return wait;
+    }
     async sendVoxelUpdate(input) {
         const data = await this.gql.request(SendVoxelUpdateDocument, { input });
         return data.sendVoxelUpdate;
     }
+    async sendVoxelUpdateAndWait(input, options = {}) {
+        const request = this.withSequence(input);
+        const wait = this.subs.waitForSequence(request.sequenceNumber, options.timeoutMs);
+        await this.sendVoxelUpdate(request);
+        return wait;
+    }
     async sendAudioPacket(input) {
         const data = await this.gql.request(SendAudioPacketDocument, { input });
         return data.sendAudioPacket;
     }
+    async sendAudioPacketAndWait(input, options = {}) {
+        const request = this.withSequence(input);
+        const wait = this.subs.waitForSequence(request.sequenceNumber, options.timeoutMs);
+        await this.sendAudioPacket(request);
+        return wait;
+    }
     async sendTextPacket(input) {
         const data = await this.gql.request(SendTextPacketDocument, { input });
         return data.sendTextPacket;
     }
+    async sendTextPacketAndWait(input, options = {}) {
+        const request = this.withSequence(input);
+        const wait = this.subs.waitForSequence(request.sequenceNumber, options.timeoutMs);
+        await this.sendTextPacket(request);
+        return wait;
+    }
     async sendClientEvent(input) {
         const data = await this.gql.request(SendClientEventDocument, { input });
         return data.sendClientEvent;
     }
+    async sendClientEventAndWait(input, options = {}) {
+        const request = this.withSequence(input);
+        const wait = this.subs.waitForSequence(request.sequenceNumber, options.timeoutMs);
+        await this.sendClientEvent(request);
+        return wait;
+    }
     /**
      * Subscribe to udpNotifications. Pass any combination of typename
      * handlers; the returned function detaches all of them. The first
@@ -52,4 +84,10 @@ export class UdpAPI {
     subscribe(handlers) {
         return this.subs.subscribe(handlers);
     }
+    withSequence(input) {
+        return {
+            ...input,
+            sequenceNumber: input.sequenceNumber ?? this.sequences.next(),
+        };
+    }
 }

package/dist/errors.d.ts

@@ -0,0 +1,42 @@
+export interface CrowdyGraphQLErrorPayload {
+    message: string;
+    locations?: readonly unknown[];
+    path?: readonly (string | number)[];
+    extensions?: Record<string, unknown>;
+}
+export interface CrowdyErrorOptions {
+    message: string;
+    cause?: unknown;
+}
+export declare class CrowdyError extends Error {
+    readonly cause?: unknown;
+    constructor(options: CrowdyErrorOptions);
+}
+export declare class CrowdyHttpError extends CrowdyError {
+    readonly status: number;
+    readonly body: string;
+    constructor(status: number, body: string);
+}
+export declare class CrowdyGraphQLError extends CrowdyError {
+    readonly graphqlErrors: CrowdyGraphQLErrorPayload[];
+    constructor(errors: CrowdyGraphQLErrorPayload[]);
+    get code(): unknown;
+}
+export declare class CrowdyNetworkError extends CrowdyError {
+    constructor(cause: unknown);
+}
+export declare class CrowdyTimeoutError extends CrowdyError {
+    constructor(timeoutMs: number);
+}
+export declare class CrowdyRealtimeError extends CrowdyError {
+    readonly code?: string;
+    readonly retryable?: boolean;
+    constructor(message: string, options?: {
+        code?: string;
+        retryable?: boolean;
+        cause?: unknown;
+    });
+}
+export declare class CrowdyProtocolError extends CrowdyError {
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC/B,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,OAAO,EAAE,kBAAkB;CAKxC;AAED,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAKzC;AAED,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,QAAQ,CAAC,aAAa,EAAE,yBAAyB,EAAE,CAAC;gBAExC,MAAM,EAAE,yBAAyB,EAAE;IAK/C,IAAI,IAAI,IAAI,OAAO,CAElB;CACF;AAED,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,KAAK,EAAE,OAAO;CAG3B;AAED,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,SAAS,EAAE,MAAM;CAG9B;AAED,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAKnG;AAED,qBAAa,mBAAoB,SAAQ,WAAW;CAAG"}

package/dist/errors.js

@@ -0,0 +1,42 @@
+export class CrowdyError extends Error {
+    constructor(options) {
+        super(options.message);
+        this.name = new.target.name;
+        this.cause = options.cause;
+    }
+}
+export class CrowdyHttpError extends CrowdyError {
+    constructor(status, body) {
+        super({ message: `HTTP ${status}: ${body}` });
+        this.status = status;
+        this.body = body;
+    }
+}
+export class CrowdyGraphQLError extends CrowdyError {
+    constructor(errors) {
+        super({ message: errors.map((error) => error.message).join('; ') });
+        this.graphqlErrors = errors;
+    }
+    get code() {
+        return this.graphqlErrors[0]?.extensions?.code;
+    }
+}
+export class CrowdyNetworkError extends CrowdyError {
+    constructor(cause) {
+        super({ message: `Network error: ${String(cause)}`, cause });
+    }
+}
+export class CrowdyTimeoutError extends CrowdyError {
+    constructor(timeoutMs) {
+        super({ message: `Request timed out after ${timeoutMs}ms` });
+    }
+}
+export class CrowdyRealtimeError extends CrowdyError {
+    constructor(message, options = {}) {
+        super({ message, cause: options.cause });
+        this.code = options.code;
+        this.retryable = options.retryable;
+    }
+}
+export class CrowdyProtocolError extends CrowdyError {
+}