@crowdedkingdomstudios/crowdyjs 1.0.7 → 2.1.0

package/dist/client.js

@@ -1,28 +1,46 @@
 /**
- * Core GraphQL client for HTTP queries and mutations
+ * Minimal HTTP GraphQL client. Reads its bearer token from `AuthState` so the
+ * WebSocket subscription manager and HTTP client always agree on who's
+ * authenticated. The `login` / `register` / `connectUdpProxy` /
+ * `sendActorUpdate` / etc. shortcuts that used to live here are gone -
+ * everything goes through the typed sub-clients on `CrowdyClient` (e.g.
+ * `client.auth.login`, `client.udp.sendActorUpdate`).
  */
+import { print } from 'graphql';
 export class GraphQLClient {
-    constructor(config = {}) {
-        this.token = null;
-        this.graphqlEndpoint = config.graphqlEndpoint || 'http://localhost:3000/graphql';
+    constructor(config = {}, authState) {
+        this.graphqlEndpoint =
+            config.graphqlEndpoint || 'http://localhost:3000/graphql';
         this.timeout = config.timeout || 60000;
+        this.authState = authState;
     }
-    setAuthToken(token) {
-        this.token = token;
+    getEndpoint() {
+        return this.graphqlEndpoint;
     }
-    getAuthToken() {
-        return this.token;
+    /**
+     * 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) {
+        const queryStr = print(document);
+        return this.query(queryStr, (variables ?? {}));
     }
+    /**
+     * 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 = {}) {
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        const token = this.authState.getToken();
         try {
             const requestBody = { query, variables };
             const response = await fetch(this.graphqlEndpoint, {
                 method: 'POST',
                 headers: {
                     'Content-Type': 'application/json',
-                    ...(this.token && { Authorization: `Bearer ${this.token}` }),
+                    ...(token ? { Authorization: `Bearer ${token}` } : {}),
                 },
                 body: JSON.stringify(requestBody),
                 signal: controller.signal,
@@ -38,7 +56,6 @@ export class GraphQLClient {
                 const errorMessage = Array.isArray(error.message)
                     ? error.message.join(', ')
                     : error.message;
-                console.error('GraphQL error:', error);
                 throw new Error(errorMessage);
             }
             return result.data;
@@ -54,190 +71,4 @@ export class GraphQLClient {
             throw new Error(`Network error: ${error}`);
         }
     }
-    async login(email, password) {
-        const data = await this.query(`
-      mutation Login($input: LoginUserInput!) {
-        login(loginUserInput: $input) {
-          token
-          gameTokenId
-          user {
-            userId
-            email
-            gamertag
-          }
-        }
-      }
-    `, {
-            input: { email, password },
-        });
-        if (data.login?.token) {
-            this.setAuthToken(data.login.token);
-            return data.login;
-        }
-        throw new Error('Login failed');
-    }
-    async register(email, password, gamertag) {
-        const data = await this.query(`
-      mutation Register($input: RegisterUserInput!) {
-        register(registerUserInput: $input) {
-          token
-          gameTokenId
-          user {
-            userId
-            email
-            gamertag
-          }
-        }
-      }
-    `, {
-            input: { email, password, gamertag },
-        });
-        if (data.register?.token) {
-            this.setAuthToken(data.register.token);
-            return data.register;
-        }
-        throw new Error('Registration failed');
-    }
-    async connectUdpProxy() {
-        const data = await this.query(`
-      mutation ConnectUdpProxy {
-        connectUdpProxy {
-          connected
-          serverIp6
-          serverClientPort
-          lastMessageTime
-        }
-      }
-    `);
-        return data.connectUdpProxy;
-    }
-    async disconnectUdpProxy() {
-        const data = await this.query(`
-      mutation DisconnectUdpProxy {
-        disconnectUdpProxy
-      }
-    `);
-        return data.disconnectUdpProxy;
-    }
-    async getConnectionStatus() {
-        const data = await this.query(`
-      query GetConnectionStatus {
-        udpProxyConnectionStatus {
-          connected
-          serverIp6
-          serverClientPort
-          lastMessageTime
-        }
-      }
-    `);
-        return data.udpProxyConnectionStatus;
-    }
-    async sendActorUpdate(input) {
-        const normalizedInput = {
-            mapId: String(input.mapId),
-            chunk: {
-                x: String(input.chunk.x),
-                y: String(input.chunk.y),
-                z: String(input.chunk.z),
-            },
-            uuid: String(input.uuid),
-            state: String(input.state),
-            distance: input.distance ?? 8,
-            decayRate: input.decayRate ?? 0,
-            sequenceNumber: input.sequenceNumber ?? 0,
-        };
-        const data = await this.query(`
-      mutation SendActorUpdate($input: ActorUpdateRequestInput!) {
-        sendActorUpdate(input: $input)
-      }
-    `, { input: normalizedInput });
-        return data.sendActorUpdate;
-    }
-    async sendVoxelUpdate(input) {
-        const normalizedInput = {
-            mapId: String(input.mapId),
-            chunk: {
-                x: String(input.chunk.x),
-                y: String(input.chunk.y),
-                z: String(input.chunk.z),
-            },
-            uuid: String(input.uuid),
-            voxel: input.voxel,
-            voxelType: input.voxelType,
-            voxelState: String(input.voxelState),
-            distance: input.distance ?? 8,
-            decayRate: input.decayRate ?? 0,
-            sequenceNumber: input.sequenceNumber ?? 0,
-        };
-        const data = await this.query(`
-      mutation SendVoxelUpdate($input: VoxelUpdateRequestInput!) {
-        sendVoxelUpdate(input: $input)
-      }
-    `, { input: normalizedInput });
-        return data.sendVoxelUpdate;
-    }
-    async sendAudioPacket(input) {
-        const normalizedInput = {
-            mapId: String(input.mapId),
-            chunk: {
-                x: String(input.chunk.x),
-                y: String(input.chunk.y),
-                z: String(input.chunk.z),
-            },
-            uuid: String(input.uuid),
-            audioData: String(input.audioData),
-            distance: input.distance ?? 1,
-            decayRate: input.decayRate ?? 0,
-            sequenceNumber: input.sequenceNumber ?? 0,
-        };
-        const data = await this.query(`
-      mutation SendAudioPacket($input: ClientAudioPacketInput!) {
-        sendAudioPacket(input: $input)
-      }
-    `, { input: normalizedInput });
-        return data.sendAudioPacket;
-    }
-    async sendTextPacket(input) {
-        const normalizedInput = {
-            mapId: String(input.mapId),
-            chunk: {
-                x: String(input.chunk.x),
-                y: String(input.chunk.y),
-                z: String(input.chunk.z),
-            },
-            uuid: String(input.uuid),
-            text: String(input.text),
-            distance: input.distance ?? 1,
-            decayRate: input.decayRate ?? 0,
-            sequenceNumber: input.sequenceNumber ?? 0,
-        };
-        const data = await this.query(`
-      mutation SendTextPacket($input: ClientTextPacketInput!) {
-        sendTextPacket(input: $input)
-      }
-    `, { input: normalizedInput });
-        return data.sendTextPacket;
-    }
-    async sendClientEvent(input) {
-        const normalizedInput = {
-            mapId: String(input.mapId),
-            chunk: {
-                x: String(input.chunk.x),
-                y: String(input.chunk.y),
-                z: String(input.chunk.z),
-            },
-            uuid: String(input.uuid),
-            eventType: input.eventType,
-            state: String(input.state),
-            distance: input.distance ?? 8,
-            decayRate: input.decayRate ?? 0,
-            sequenceNumber: input.sequenceNumber ?? 0,
-        };
-        const data = await this.query(`
-      mutation SendClientEvent($input: ClientEventNotificationInput!) {
-        sendClientEvent(input: $input)
-      }
-    `, { input: normalizedInput });
-        return data.sendClientEvent;
-    }
 }

package/dist/crowdy-client.d.ts

@@ -1,31 +1,51 @@
 /**
- * Main CrowdyClient class - public API for the SDK
+ * Public surface of the SDK. Construct one `CrowdyClient` per session and
+ * access everything via the typed sub-clients (`client.auth`, `client.udp`,
+ * `client.orgs`, ...). The legacy `client.login()` / `client.sendActorUpdate`
+ * shortcuts are gone - use `client.auth.login()` / `client.udp.sendActorUpdate()`
+ * instead.
  */
-import type { CrowdyClientConfig, AuthResponse, UdpProxyConnectionStatus, ActorUpdateRequestInput, VoxelUpdateRequestInput, ClientAudioPacketInput, ClientTextPacketInput, ClientEventNotificationInput, ActorUpdateHandler, ActorUpdateResponseHandler, VoxelUpdateHandler, VoxelUpdateResponseHandler, ClientAudioHandler, ClientTextHandler, ClientEventHandler, ServerEventHandler, GenericErrorHandler, UnsubscribeFn } from './types.js';
+import { AuthAPI } from './domains/auth.js';
+import { UsersAPI } from './domains/users.js';
+import { OrganizationsAPI } from './domains/organizations.js';
+import { AppsAPI } from './domains/apps.js';
+import { AppAccessAPI } from './domains/appAccess.js';
+import { BillingAPI } from './domains/billing.js';
+import { QuotasAPI } from './domains/quotas.js';
+import { PaymentsAPI } from './domains/payments.js';
+import { ChunksAPI } from './domains/chunks.js';
+import { VoxelsAPI } from './domains/voxels.js';
+import { ActorsAPI } from './domains/actors.js';
+import { TeleportAPI } from './domains/teleport.js';
+import { StateAPI } from './domains/state.js';
+import { ServerStatusAPI } from './domains/serverStatus.js';
+import { UdpAPI } from './domains/udp.js';
+export interface CrowdyClientConfig {
+    graphqlEndpoint?: string;
+    wsEndpoint?: string;
+    timeout?: number;
+}
 export declare class CrowdyClient {
-    private client;
-    private subscriptions;
+    private readonly authState;
+    private readonly client;
+    private readonly subscriptions;
+    readonly auth: AuthAPI;
+    readonly users: UsersAPI;
+    readonly orgs: OrganizationsAPI;
+    readonly apps: AppsAPI;
+    readonly appAccess: AppAccessAPI;
+    readonly billing: BillingAPI;
+    readonly quotas: QuotasAPI;
+    readonly payments: PaymentsAPI;
+    readonly chunks: ChunksAPI;
+    readonly voxels: VoxelsAPI;
+    readonly actors: ActorsAPI;
+    readonly teleport: TeleportAPI;
+    readonly state: StateAPI;
+    readonly serverStatus: ServerStatusAPI;
+    readonly udp: UdpAPI;
     constructor(config?: CrowdyClientConfig);
-    login(email: string, password: string): Promise<AuthResponse>;
-    register(email: string, password: string, gamertag?: string): Promise<AuthResponse>;
-    getAuthToken(): string | null;
-    connectUdpProxy(): Promise<UdpProxyConnectionStatus>;
-    disconnectUdpProxy(): Promise<boolean>;
-    getConnectionStatus(): Promise<UdpProxyConnectionStatus>;
-    sendActorUpdate(input: ActorUpdateRequestInput): Promise<boolean>;
-    sendVoxelUpdate(input: VoxelUpdateRequestInput): Promise<boolean>;
-    sendAudioPacket(input: ClientAudioPacketInput): Promise<boolean>;
-    sendTextPacket(input: ClientTextPacketInput): Promise<boolean>;
-    sendClientEvent(input: ClientEventNotificationInput): Promise<boolean>;
-    onActorUpdate(handler: ActorUpdateHandler): UnsubscribeFn;
-    onActorUpdateResponse(handler: ActorUpdateResponseHandler): UnsubscribeFn;
-    onVoxelUpdate(handler: VoxelUpdateHandler): UnsubscribeFn;
-    onVoxelUpdateResponse(handler: VoxelUpdateResponseHandler): UnsubscribeFn;
-    onClientAudio(handler: ClientAudioHandler): UnsubscribeFn;
-    onClientText(handler: ClientTextHandler): UnsubscribeFn;
-    onClientEvent(handler: ClientEventHandler): UnsubscribeFn;
-    onServerEvent(handler: ServerEventHandler): UnsubscribeFn;
-    onGenericError(handler: GenericErrorHandler): UnsubscribeFn;
+    /** Closes the WebSocket and clears the in-memory auth token. */
     close(): void;
 }
 //# 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;;GAEG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,aAAa,CAAsB;gBAE/B,MAAM,GAAE,kBAAuB;IAYrC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAM7D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAMzF,YAAY,IAAI,MAAM,GAAG,IAAI;IAKvB,eAAe,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAIpD,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IAItC,mBAAmB,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAKxD,eAAe,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;IAKjE,eAAe,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;IAKjE,eAAe,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhE,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D,eAAe,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5E,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa;IAIzD,qBAAqB,CAAC,OAAO,EAAE,0BAA0B,GAAG,aAAa;IAIzE,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa;IAIzD,qBAAqB,CAAC,OAAO,EAAE,0BAA0B,GAAG,aAAa;IAIzE,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa;IAIzD,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa;IAIvD,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa;IAIzD,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa;IAIzD,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa;IAK3D,KAAK,IAAI,IAAI;CAId"}
+{"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"}

package/dist/crowdy-client.js

@@ -1,91 +1,52 @@
 /**
- * Main CrowdyClient class - public API for the SDK
+ * Public surface of the SDK. Construct one `CrowdyClient` per session and
+ * access everything via the typed sub-clients (`client.auth`, `client.udp`,
+ * `client.orgs`, ...). The legacy `client.login()` / `client.sendActorUpdate`
+ * 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 { AuthAPI } from './domains/auth.js';
+import { UsersAPI } from './domains/users.js';
+import { OrganizationsAPI } from './domains/organizations.js';
+import { AppsAPI } from './domains/apps.js';
+import { AppAccessAPI } from './domains/appAccess.js';
+import { BillingAPI } from './domains/billing.js';
+import { QuotasAPI } from './domains/quotas.js';
+import { PaymentsAPI } from './domains/payments.js';
+import { ChunksAPI } from './domains/chunks.js';
+import { VoxelsAPI } from './domains/voxels.js';
+import { ActorsAPI } from './domains/actors.js';
+import { TeleportAPI } from './domains/teleport.js';
+import { StateAPI } from './domains/state.js';
+import { ServerStatusAPI } from './domains/serverStatus.js';
+import { UdpAPI } from './domains/udp.js';
 export class CrowdyClient {
     constructor(config = {}) {
-        this.client = new GraphQLClient({
-            graphqlEndpoint: config.graphqlEndpoint,
-            timeout: config.timeout,
-        });
-        this.subscriptions = new SubscriptionManager({
-            wsEndpoint: config.wsEndpoint,
-        });
-    }
-    // Authentication
-    async login(email, password) {
-        const response = await this.client.login(email, password);
-        this.subscriptions.setAuthToken(response.token);
-        return response;
-    }
-    async register(email, password, gamertag) {
-        const response = await this.client.register(email, password, gamertag);
-        this.subscriptions.setAuthToken(response.token);
-        return response;
-    }
-    getAuthToken() {
-        return this.client.getAuthToken();
-    }
-    // UDP Proxy
-    async connectUdpProxy() {
-        return this.client.connectUdpProxy();
-    }
-    async disconnectUdpProxy() {
-        return this.client.disconnectUdpProxy();
-    }
-    async getConnectionStatus() {
-        return this.client.getConnectionStatus();
-    }
-    // Actor Updates
-    async sendActorUpdate(input) {
-        return this.client.sendActorUpdate(input);
-    }
-    // Voxel Updates
-    async sendVoxelUpdate(input) {
-        return this.client.sendVoxelUpdate(input);
-    }
-    // Client Packets
-    async sendAudioPacket(input) {
-        return this.client.sendAudioPacket(input);
-    }
-    async sendTextPacket(input) {
-        return this.client.sendTextPacket(input);
-    }
-    async sendClientEvent(input) {
-        return this.client.sendClientEvent(input);
-    }
-    // Type-specific subscription handlers
-    onActorUpdate(handler) {
-        return this.subscriptions.onActorUpdate(handler);
-    }
-    onActorUpdateResponse(handler) {
-        return this.subscriptions.onActorUpdateResponse(handler);
-    }
-    onVoxelUpdate(handler) {
-        return this.subscriptions.onVoxelUpdate(handler);
-    }
-    onVoxelUpdateResponse(handler) {
-        return this.subscriptions.onVoxelUpdateResponse(handler);
-    }
-    onClientAudio(handler) {
-        return this.subscriptions.onClientAudio(handler);
-    }
-    onClientText(handler) {
-        return this.subscriptions.onClientText(handler);
-    }
-    onClientEvent(handler) {
-        return this.subscriptions.onClientEvent(handler);
-    }
-    onServerEvent(handler) {
-        return this.subscriptions.onServerEvent(handler);
-    }
-    onGenericError(handler) {
-        return this.subscriptions.onGenericError(handler);
-    }
-    // Cleanup
+        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);
+    }
+    /** Closes the WebSocket and clears the in-memory auth token. */
     close() {
         this.subscriptions.close();
-        this.client.setAuthToken(null);
+        this.authState.setToken(null);
     }
 }

package/dist/domains/actors.d.ts

@@ -0,0 +1,22 @@
+import type { GraphQLClient } from '../client.js';
+import { type ActorQuery, type ActorQueryVariables, type ActorsQuery, type ActorsQueryVariables, type BatchLookupActorsQuery, type BatchLookupActorsQueryVariables, type CreateActorMutation, type CreateActorMutationVariables, type UpdateActorMutation, type UpdateActorMutationVariables, type DeleteActorMutation, type DeleteActorMutationVariables, type UpdateActorStateMutation, type UpdateActorStateMutationVariables } from '../generated/graphql.js';
+/**
+ * Actor (player / NPC) CRUD and filtering.
+ *
+ * Note: this is the persisted-actor API. For high-frequency replication see
+ * the existing `client.sendActorUpdate()` UDP path (unchanged).
+ *
+ * Exposed as `client.actors`.
+ */
+export declare class ActorsAPI {
+    private gql;
+    constructor(gql: GraphQLClient);
+    get(uuid: ActorQueryVariables['uuid']): Promise<ActorQuery['actor']>;
+    list(filter?: ActorsQueryVariables['filter']): Promise<ActorsQuery['actors']>;
+    batchLookup(input: BatchLookupActorsQueryVariables['input']): Promise<BatchLookupActorsQuery['batchLookupActors']>;
+    create(input: CreateActorMutationVariables['input']): Promise<CreateActorMutation['createActor']>;
+    update(uuid: UpdateActorMutationVariables['uuid'], input: UpdateActorMutationVariables['input']): Promise<UpdateActorMutation['updateActor']>;
+    delete(uuid: DeleteActorMutationVariables['uuid']): Promise<DeleteActorMutation['deleteActor']>;
+    updateState(uuid: UpdateActorStateMutationVariables['uuid'], input: UpdateActorStateMutationVariables['input']): Promise<UpdateActorStateMutation['updateActorState']>;
+}
+//# sourceMappingURL=actors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actors.d.ts","sourceRoot":"","sources":["../../src/domains/actors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,mBAAmB,EAExB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EAEzB,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EAEpC,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EAEjC,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EAEjC,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EAEjC,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EACvC,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;GAOG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAEhC,GAAG,CAAC,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAKpE,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAK7E,WAAW,CACf,KAAK,EAAE,+BAA+B,CAAC,OAAO,CAAC,GAC9C,OAAO,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;IAKjD,MAAM,CACV,KAAK,EAAE,4BAA4B,CAAC,OAAO,CAAC,GAC3C,OAAO,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAKxC,MAAM,CACV,IAAI,EAAE,4BAA4B,CAAC,MAAM,CAAC,EAC1C,KAAK,EAAE,4BAA4B,CAAC,OAAO,CAAC,GAC3C,OAAO,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAKxC,MAAM,CACV,IAAI,EAAE,4BAA4B,CAAC,MAAM,CAAC,GACzC,OAAO,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAKxC,WAAW,CACf,IAAI,EAAE,iCAAiC,CAAC,MAAM,CAAC,EAC/C,KAAK,EAAE,iCAAiC,CAAC,OAAO,CAAC,GAChD,OAAO,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;CAIzD"}

package/dist/domains/actors.js

@@ -0,0 +1,42 @@
+import { ActorDocument, ActorsDocument, BatchLookupActorsDocument, CreateActorDocument, UpdateActorDocument, DeleteActorDocument, UpdateActorStateDocument, } from '../generated/graphql.js';
+/**
+ * Actor (player / NPC) CRUD and filtering.
+ *
+ * Note: this is the persisted-actor API. For high-frequency replication see
+ * the existing `client.sendActorUpdate()` UDP path (unchanged).
+ *
+ * Exposed as `client.actors`.
+ */
+export class ActorsAPI {
+    constructor(gql) {
+        this.gql = gql;
+    }
+    async get(uuid) {
+        const data = await this.gql.request(ActorDocument, { uuid });
+        return data.actor;
+    }
+    async list(filter) {
+        const data = await this.gql.request(ActorsDocument, { filter });
+        return data.actors;
+    }
+    async batchLookup(input) {
+        const data = await this.gql.request(BatchLookupActorsDocument, { input });
+        return data.batchLookupActors;
+    }
+    async create(input) {
+        const data = await this.gql.request(CreateActorDocument, { input });
+        return data.createActor;
+    }
+    async update(uuid, input) {
+        const data = await this.gql.request(UpdateActorDocument, { uuid, input });
+        return data.updateActor;
+    }
+    async delete(uuid) {
+        const data = await this.gql.request(DeleteActorDocument, { uuid });
+        return data.deleteActor;
+    }
+    async updateState(uuid, input) {
+        const data = await this.gql.request(UpdateActorStateDocument, { uuid, input });
+        return data.updateActorState;
+    }
+}

package/dist/domains/appAccess.d.ts

@@ -0,0 +1,23 @@
+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

@@ -0,0 +1 @@
+{"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

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

package/dist/domains/apps.d.ts

@@ -0,0 +1,27 @@
+import type { GraphQLClient } from '../client.js';
+import { type AppQuery, type AppQueryVariables, type AppBySlugQuery, type AppBySlugQueryVariables, type MyAppsQuery, type AppsForOrgQuery, type AppsForOrgQueryVariables, type MarketplaceAppsQuery, type MarketplaceAppsQueryVariables, type CreateAppMutation, type CreateAppMutationVariables, type UpdateAppMutation, type UpdateAppMutationVariables, type ArchiveAppMutationVariables, type SetAppVisibilityMutation, type SetAppVisibilityMutationVariables } from '../generated/graphql.js';
+/**
+ * App (game / world) lifecycle and discovery. Exposed as `client.apps`.
+ *
+ * `marketplace()` is a public listing (no auth) of every app where
+ * visibility = PUBLIC and status = LIVE; the rest of the methods require
+ * either org-membership permissions or super admin.
+ */
+export declare class AppsAPI {
+    private gql;
+    constructor(gql: GraphQLClient);
+    marketplace(args?: MarketplaceAppsQueryVariables): Promise<MarketplaceAppsQuery['apps']>;
+    byId(appId: AppQueryVariables['appId']): Promise<AppQuery['app']>;
+    bySlug(args: AppBySlugQueryVariables): Promise<AppBySlugQuery['appBySlug']>;
+    myApps(): Promise<MyAppsQuery['myApps']>;
+    forOrg(orgSlug: AppsForOrgQueryVariables['orgSlug']): Promise<AppsForOrgQuery['appsForOrg']>;
+    create(input: CreateAppMutationVariables['input']): Promise<CreateAppMutation['createApp']>;
+    update(args: UpdateAppMutationVariables): Promise<UpdateAppMutation['updateApp']>;
+    archive(appId: ArchiveAppMutationVariables['appId']): Promise<{
+        appId: any;
+        status: string;
+        updatedAt: any;
+    }>;
+    setVisibility(args: SetAppVisibilityMutationVariables): Promise<SetAppVisibilityMutation['setAppVisibility']>;
+}
+//# sourceMappingURL=apps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apps.d.ts","sourceRoot":"","sources":["../../src/domains/apps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,iBAAiB,EAEtB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAE5B,KAAK,WAAW,EAEhB,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAE7B,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EAElC,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAE/B,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAE/B,KAAK,2BAA2B,EAEhC,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EACvC,MAAM,yBAAyB,CAAC;AAEjC;;;;;;GAMG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAEhC,WAAW,CACf,IAAI,GAAE,6BAAkC,GACvC,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAKlC,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAKjE,MAAM,CACV,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAKjC,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAKxC,MAAM,CACV,OAAO,EAAE,wBAAwB,CAAC,SAAS,CAAC,GAC3C,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IAKnC,MAAM,CACV,KAAK,EAAE,0BAA0B,CAAC,OAAO,CAAC,GACzC,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAKpC,MAAM,CACV,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAKpC,OAAO,CACX,KAAK,EAAE,2BAA2B,CAAC,OAAO,CAAC,GAC1C,OAAO,CAAC;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,GAAG,CAAA;KAAE,CAAC;IAKpD,aAAa,CACjB,IAAI,EAAE,iCAAiC,GACtC,OAAO,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;CAIzD"}