@crowdedkingdomstudios/crowdyjs 5.1.0 → 5.2.1

package/MIGRATION.md

@@ -1,3 +1,67 @@
+# CrowdyJS v5.2.1 Notes
+
+v5.2.1 is **documentation-only** — no API, type, or behavior changes.
+
+## Changed
+
+- Comprehensive TSDoc across the entire public surface (every sub-client class
+  and method, the error classes, the realtime types, the token store, and the
+  config). Descriptions mirror the GraphQL schema's field semantics and add
+  SDK-specific notes — auth/permission requirements, the stable
+  `extensions.code`s each call can throw, encoding/units conventions (`BigInt`
+  as decimal strings, base64 blobs, 32-char actor ids, chunk-unit distances),
+  idempotency-key replay/`IDEMPOTENCY_CONFLICT` behavior, and realtime
+  `...AndWait` echo/timeout semantics. These now show up on hover in your IDE
+  and in the published `.d.ts`.
+- Two doc-accuracy fixes: `...AndWait` echo timeouts reject with
+  `CrowdyRealtimeError` (`code === 'UDP_SEQUENCE_TIMEOUT'`), not
+  `CrowdyTimeoutError`; and only actor/voxel sends echo to the sender, so the
+  audio/text/event `...AndWait` variants are documented as fire-and-forget-with-error-wait.
+
+---
+
+# CrowdyJS v5.2 Notes
+
+v5.2 is additive at the SDK API level (new optional parameters only) and
+refreshes the bundled schema, but it **raises the minimum server version**.
+
+## Added
+
+- **Idempotency keys on destructive mutations.** The four destructive
+  game-client mutations now accept an optional idempotency key. Replaying the
+  same call with the same key returns the first result instead of re-applying
+  the side effect; the same key with different arguments returns an
+  `IDEMPOTENCY_CONFLICT` error. Keys expire server-side after 24h.
+
+  ```ts
+  const key = crypto.randomUUID();
+  await client.actors.delete(uuid, key);   // first call deletes
+  await client.actors.delete(uuid, key);   // retry replays the first result
+  await client.teams.remove(groupId, key);
+  await client.teams.leave(groupId, key);
+  await client.voxels.rollback({ ...input, idempotencyKey: key }); // input field
+  ```
+
+  All four parameters are optional and trailing, so existing call sites are
+  unchanged.
+
+- **Refreshed bundled schema.** Re-synced against `cks-management-api` and
+  `cks-game-api` so generated types now include the new Relay-style `*Connection`
+  queries (offset `limit`/`offset` args are now marked `@deprecated`), the
+  machine-readable `@requiresPermission` directive metadata, and the enumerated
+  error codes. `CrowdyGraphQLError` already surfaces these via `extensions.code`,
+  `extensions.remediation`, and `extensions.requiredPermission` — no new error
+  class is needed.
+
+## Requires
+
+- `cks-game-api >= v0.10.3` and `cks-management-api >= v0.1.70`. The destructive
+  mutation documents now send the `idempotencyKey` argument, so those four
+  operations require a server that defines it. Point the SDK at an environment
+  running release **v0.1.19** or later.
+
+---
+
 # CrowdyJS v5.1 Notes
 
 v5.1 is additive and non-breaking.

package/README.md

@@ -10,6 +10,8 @@ npm install @crowdedkingdomstudios/crowdyjs
 
 CrowdyJS v4 targets browsers by default and uses native `fetch`, `WebSocket`, `crypto`, `btoa`, and `atob`. Node tools can still use the SDK, but must provide browser-compatible globals when opening realtime connections.
 
+> **Server compatibility:** v5.2+ targets environments on release **v0.1.19 or later** (`cks-game-api >= v0.10.3`, `cks-management-api >= v0.1.70`). The destructive mutations send an `idempotencyKey` argument that older servers don't define.
+
 ## Quick start
 
 ```ts
@@ -207,6 +209,23 @@ Transport and protocol failures throw structured error classes:
 - `CrowdyRealtimeError` — realtime subscription couldn't be established or was dropped.
 - `CrowdyProtocolError` — server response failed schema validation.
 
+GraphQL errors carry a stable `extensions.code` (e.g. `UNAUTHENTICATED`, `SCOPE_MISSING`, `FORBIDDEN`, `IDEMPOTENCY_CONFLICT`) plus, where applicable, `extensions.remediation` and `extensions.requiredPermission`. Branch on `error.extensions?.code` rather than parsing messages.
+
+## Idempotent retries
+
+Destructive game-client mutations accept an optional **idempotency key**. Pass a stable key (e.g. `crypto.randomUUID()`) and a network retry replays the first result instead of applying the side effect twice. Reusing a key with different arguments throws a `CrowdyGraphQLError` with `extensions.code === 'IDEMPOTENCY_CONFLICT'`. Keys expire server-side after 24h.
+
+```ts
+const key = crypto.randomUUID();
+await client.actors.delete(uuid, key);          // first call deletes
+await client.actors.delete(uuid, key);          // retry → replays the first result
+await client.teams.remove(groupId, key);        // deleteTeam
+await client.teams.leave(groupId, key);         // leaveTeam
+await client.voxels.rollback({ ...input, idempotencyKey: key }); // input field
+```
+
+The key parameter is optional and trailing, so it's safe to omit. Requires a server on release v0.1.19+ (see Server compatibility above).
+
 ## Auth notes
 
 - Use `client.auth.setToken(token)` if you need to seed a token externally (e.g. when restoring auth from a non-default storage).

package/dist/client.d.ts

@@ -9,34 +9,127 @@
 import type { TypedDocumentNode } from '@graphql-typed-document-node/core';
 import type { SessionStore } from './session.js';
 import type { CrowdyLogger } from './logger.js';
+/**
+ * Configuration for {@link GraphQLClient}, the low-level HTTP transport. You
+ * normally don't build this yourself — `CrowdyClient` constructs the transport
+ * from its own config — but it is exported for advanced or standalone use.
+ */
 export interface GraphQLClientConfig {
+    /**
+     * Absolute base URL of the GraphQL HTTP service (e.g.
+     * `https://game.example.com/graphql`). Used when {@link graphqlEndpoint} is
+     * not set. When both are omitted the client falls back to
+     * `http://localhost:3000/graphql`.
+     */
     httpUrl?: string;
+    /**
+     * Explicit GraphQL endpoint URL. Takes precedence over {@link httpUrl} when
+     * both are provided.
+     */
     graphqlEndpoint?: string;
+    /**
+     * Per-request timeout in **milliseconds**. When it elapses the request is
+     * aborted and a {@link CrowdyTimeoutError} is thrown. Defaults to `60000`
+     * (60 seconds).
+     */
     timeout?: number;
+    /**
+     * Optional logger for transport diagnostics. Defaults to a silent logger
+     * that discards all output.
+     */
     logger?: CrowdyLogger;
 }
+/**
+ * Low-level HTTP transport for GraphQL operations against the game or
+ * management API. It POSTs operations to a single endpoint, attaches the
+ * shared Bearer token read fresh from the {@link SessionStore} on every
+ * request (so the HTTP client and the realtime socket never disagree about who
+ * is authenticated), enforces a timeout, and normalizes every failure into a
+ * typed {@link CrowdyError} subclass.
+ *
+ * Most consumers should use the typed sub-clients on `CrowdyClient` instead;
+ * reach for this directly only via the low-level escape hatch
+ * (`client.graphql.request(...)`).
+ *
+ * Failure modes:
+ * - {@link CrowdyHttpError} — the endpoint returned a non-2xx HTTP status.
+ * - {@link CrowdyGraphQLError} — a 200 response whose `errors[]` was non-empty.
+ * - {@link CrowdyNetworkError} — `fetch` itself failed (DNS, TLS, refused).
+ * - {@link CrowdyTimeoutError} — the request exceeded
+ *   {@link GraphQLClientConfig.timeout}.
+ *
+ * Also exported under the alias {@link GraphQLTransport}.
+ */
 export declare class GraphQLClient {
     private readonly graphqlEndpoint;
     private readonly timeout;
     private readonly session;
     private readonly logger;
+    /**
+     * @param config - Endpoint, timeout, and logger options; see
+     *   {@link GraphQLClientConfig}.
+     * @param session - Shared session/token store. Its current token is read
+     *   fresh on every request and sent as `Authorization: Bearer <token>`, so
+     *   HTTP auth always tracks the active session.
+     */
     constructor(config: GraphQLClientConfig | undefined, session: SessionStore);
+    /**
+     * The resolved GraphQL endpoint URL this client POSTs to.
+     *
+     * @returns The absolute endpoint URL.
+     */
     getEndpoint(): string;
     /**
-     * Execute a typed GraphQL operation produced by codegen and return the
-     * `data` payload. Throws on transport errors, GraphQL errors, or timeouts.
+     * Execute a typed GraphQL operation produced by codegen and return its
+     * `data` payload. This is the preferred entry point: the
+     * {@link TypedDocumentNode} ties `variables` and the result together so both
+     * are fully type-checked.
+     *
+     * @typeParam TResult - The operation's result (`data`) type.
+     * @typeParam TVariables - The operation's variables type.
+     * @param document - The typed operation document (e.g. `ActorDocument`).
+     * @param variables - Variables for the operation; omit for operations that
+     *   take none.
+     * @param options - Optional `signal` to abort the request from your own
+     *   `AbortController` (in addition to the built-in timeout).
+     * @returns The operation's `data` payload.
+     * @throws {CrowdyHttpError} on a non-2xx HTTP status.
+     * @throws {CrowdyGraphQLError} when the response carries a non-empty
+     *   `errors[]` array.
+     * @throws {CrowdyNetworkError} on a network-level `fetch` failure.
+     * @throws {CrowdyTimeoutError} when the request exceeds the configured
+     *   timeout.
      */
     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`.
+     * Escape hatch for executing a **raw** GraphQL query string. Prefer
+     * {@link request} with a {@link TypedDocumentNode}; this exists for
+     * hand-written adapters that haven't migrated to typed documents yet. It
+     * POSTs `{ query, variables }`, attaches the Bearer token, applies the
+     * timeout, and unwraps the response's `data`.
+     *
+     * @typeParam T - Expected shape of the returned `data` (defaults to `any`).
+     * @param query - The GraphQL document text.
+     * @param variables - Variable values keyed by name. Defaults to `{}`.
+     * @param options - Optional `signal` to abort from your own
+     *   `AbortController`; otherwise the internal timeout controls abortion.
+     * @returns The response's `data` payload, typed as `T`.
+     * @throws {CrowdyHttpError} on a non-2xx HTTP status.
+     * @throws {CrowdyGraphQLError} when the response carries a non-empty
+     *   `errors[]` array.
+     * @throws {CrowdyNetworkError} on a network-level `fetch` failure.
+     * @throws {CrowdyTimeoutError} when the request exceeds the configured
+     *   timeout.
      */
     query<T = any>(query: string, variables?: Record<string, unknown>, options?: {
         signal?: AbortSignal;
     }): Promise<T>;
 }
+/**
+ * Alias for {@link GraphQLClient}, provided so callers can refer to the HTTP
+ * layer as a "transport". The two names are the exact same class.
+ */
 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,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;IAUnE,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"}
+{"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;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,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;IAEtC;;;;;;OAMG;gBACS,MAAM,EAAE,mBAAmB,YAAK,EAAE,OAAO,EAAE,YAAY;IAUnE;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;;;;;;;;;;;;;;;;;OAoBG;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;;;;;;;;;;;;;;;;;;;OAmBG;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;;;GAGG;AACH,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/client.js

@@ -9,7 +9,35 @@
 import { print } from 'graphql';
 import { silentLogger } from './logger.js';
 import { CrowdyError, CrowdyGraphQLError, CrowdyHttpError, CrowdyNetworkError, CrowdyTimeoutError, } from './errors.js';
+/**
+ * Low-level HTTP transport for GraphQL operations against the game or
+ * management API. It POSTs operations to a single endpoint, attaches the
+ * shared Bearer token read fresh from the {@link SessionStore} on every
+ * request (so the HTTP client and the realtime socket never disagree about who
+ * is authenticated), enforces a timeout, and normalizes every failure into a
+ * typed {@link CrowdyError} subclass.
+ *
+ * Most consumers should use the typed sub-clients on `CrowdyClient` instead;
+ * reach for this directly only via the low-level escape hatch
+ * (`client.graphql.request(...)`).
+ *
+ * Failure modes:
+ * - {@link CrowdyHttpError} — the endpoint returned a non-2xx HTTP status.
+ * - {@link CrowdyGraphQLError} — a 200 response whose `errors[]` was non-empty.
+ * - {@link CrowdyNetworkError} — `fetch` itself failed (DNS, TLS, refused).
+ * - {@link CrowdyTimeoutError} — the request exceeded
+ *   {@link GraphQLClientConfig.timeout}.
+ *
+ * Also exported under the alias {@link GraphQLTransport}.
+ */
 export class GraphQLClient {
+    /**
+     * @param config - Endpoint, timeout, and logger options; see
+     *   {@link GraphQLClientConfig}.
+     * @param session - Shared session/token store. Its current token is read
+     *   fresh on every request and sent as `Authorization: Bearer <token>`, so
+     *   HTTP auth always tracks the active session.
+     */
     constructor(config = {}, session) {
         this.graphqlEndpoint =
             config.graphqlEndpoint ||
@@ -19,21 +47,58 @@ export class GraphQLClient {
         this.session = session;
         this.logger = config.logger ?? silentLogger;
     }
+    /**
+     * The resolved GraphQL endpoint URL this client POSTs to.
+     *
+     * @returns The absolute endpoint URL.
+     */
     getEndpoint() {
         return this.graphqlEndpoint;
     }
     /**
-     * Execute a typed GraphQL operation produced by codegen and return the
-     * `data` payload. Throws on transport errors, GraphQL errors, or timeouts.
+     * Execute a typed GraphQL operation produced by codegen and return its
+     * `data` payload. This is the preferred entry point: the
+     * {@link TypedDocumentNode} ties `variables` and the result together so both
+     * are fully type-checked.
+     *
+     * @typeParam TResult - The operation's result (`data`) type.
+     * @typeParam TVariables - The operation's variables type.
+     * @param document - The typed operation document (e.g. `ActorDocument`).
+     * @param variables - Variables for the operation; omit for operations that
+     *   take none.
+     * @param options - Optional `signal` to abort the request from your own
+     *   `AbortController` (in addition to the built-in timeout).
+     * @returns The operation's `data` payload.
+     * @throws {CrowdyHttpError} on a non-2xx HTTP status.
+     * @throws {CrowdyGraphQLError} when the response carries a non-empty
+     *   `errors[]` array.
+     * @throws {CrowdyNetworkError} on a network-level `fetch` failure.
+     * @throws {CrowdyTimeoutError} when the request exceeds the configured
+     *   timeout.
      */
     async request(document, variables, options = {}) {
         const queryStr = print(document);
         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`.
+     * Escape hatch for executing a **raw** GraphQL query string. Prefer
+     * {@link request} with a {@link TypedDocumentNode}; this exists for
+     * hand-written adapters that haven't migrated to typed documents yet. It
+     * POSTs `{ query, variables }`, attaches the Bearer token, applies the
+     * timeout, and unwraps the response's `data`.
+     *
+     * @typeParam T - Expected shape of the returned `data` (defaults to `any`).
+     * @param query - The GraphQL document text.
+     * @param variables - Variable values keyed by name. Defaults to `{}`.
+     * @param options - Optional `signal` to abort from your own
+     *   `AbortController`; otherwise the internal timeout controls abortion.
+     * @returns The response's `data` payload, typed as `T`.
+     * @throws {CrowdyHttpError} on a non-2xx HTTP status.
+     * @throws {CrowdyGraphQLError} when the response carries a non-empty
+     *   `errors[]` array.
+     * @throws {CrowdyNetworkError} on a network-level `fetch` failure.
+     * @throws {CrowdyTimeoutError} when the request exceeds the configured
+     *   timeout.
      */
     async query(query, variables = {}, options = {}) {
         const controller = new AbortController();
@@ -78,4 +143,8 @@ export class GraphQLClient {
         }
     }
 }
+/**
+ * Alias for {@link GraphQLClient}, provided so callers can refer to the HTTP
+ * layer as a "transport". The two names are the exact same class.
+ */
 export { GraphQLClient as GraphQLTransport };

package/dist/crowdy-client.d.ts

@@ -59,13 +59,25 @@ export interface CrowdyClientConfig {
     managementUrl?: string;
     /** management-api GraphQL endpoint. Defaults to `${managementUrl}/graphql`. */
     managementGraphqlEndpoint?: string;
+    /** Per-request HTTP timeout in milliseconds (applies to both endpoints). */
     timeout?: number;
+    /**
+     * Persistence for the Bearer token across reloads. `BrowserLocalStorageTokenStore`
+     * is provided; supply your own for SSR/Node. When omitted the token lives only
+     * in memory for the lifetime of the client.
+     */
     tokenStore?: TokenStore;
+    /** Optional logger for SDK diagnostics (request/realtime lifecycle). */
     logger?: CrowdyLogger;
+    /** Realtime (WebSocket) tuning for reconnect backoff and `...AndWait` timeouts. */
     realtime?: {
+        /** Max reconnect attempts before giving up (default tuned for browsers). */
         retryAttempts?: number;
+        /** Initial reconnect backoff in milliseconds. */
         retryInitialDelayMs?: number;
+        /** Maximum reconnect backoff in milliseconds (the backoff is capped here). */
         retryMaxDelayMs?: number;
+        /** Default timeout for `...AndWait` round-trips that await a matching echo. */
         waitTimeoutMs?: number;
     };
 }
@@ -78,20 +90,31 @@ export declare class CrowdyClient {
     readonly realtime: SubscriptionManager;
     /** management-api HTTP client. Same `AuthState` as `graphql`. */
     readonly management: GraphQLClient;
+    /** Auth + session: login, register, logout, password/email flows. */
     readonly auth: AuthAPI;
+    /** Current-user identity: `me`, gamertag, account deletion. */
     readonly users: UsersAPI;
+    /** App discovery + routing (which game-api serves a given app). */
     readonly apps: AppsAPI;
     /** Public platform discovery (shared game-api URL, free app quota). */
     readonly platform: PlatformAPI;
+    /** Chunk reads/writes: terrain, LODs, chunk state, distance queries. */
     readonly chunks: ChunksAPI;
+    /** Voxel reads/writes: list, history, rollback, single-voxel edits. */
     readonly voxels: VoxelsAPI;
+    /** Persisted-actor CRUD (durable records; realtime is `udp`/`world`). */
     readonly actors: ActorsAPI;
+    /** Teleport: move an actor to a destination chunk/world. */
     readonly teleport: TeleportAPI;
+    /** Per-user/per-app persisted state blobs. */
     readonly state: StateAPI;
+    /** Server status + version discovery (UDP availability, version floors). */
     readonly serverStatus: ServerStatusAPI;
+    /** Channels: location-independent pub/sub messaging groups. */
     readonly channels: ChannelsAPI;
     /** Teams: app-scoped player groups with roles and delegated management. */
     readonly teams: TeamsAPI;
+    /** UDP proxy: spatial sends + the shared realtime notification subscription. */
     readonly udp: UdpAPI;
     /** Abstract game model: containers, properties, functions, sessions. */
     readonly gameModel: GameModelAPI;
@@ -100,6 +123,14 @@ export declare class CrowdyClient {
     setToken(token: string | null): void;
     /** Read the current Bearer token (null if no session). */
     getToken(): string | null;
+    /**
+     * Ergonomic, app-scoped realtime facade. `client.world(appId)` returns a
+     * {@link WorldClient} whose `actor()` and `subscribe()` helpers pass `appId`
+     * for you and manage chunk/sequence bookkeeping — the recommended entry point
+     * for game loops. The lower-level `client.udp` remains available.
+     *
+     * @param appId - The app to scope realtime traffic to (BigInt as a decimal string).
+     */
     world(appId: string): WorldClient;
     /** Closes the WebSocket and clears the in-memory auth token. */
     close(): void;

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;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,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,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IAEjC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAGnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE;QACT,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,qBAAa,YAAY;IACvB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IAGnC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAG/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,QAAQ,EAAE,WAAW,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;gBAErB,MAAM,GAAE,kBAAuB;IA0D3C,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIpC,0DAA0D;IAC1D,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAIjC,gEAAgE;IAChE,KAAK,IAAI,IAAI;CAId;AAED,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,kBAAuB,GAC9B,YAAY,CAEd"}
+{"version":3,"file":"crowdy-client.d.ts","sourceRoot":"","sources":["../src/crowdy-client.ts"],"names":[],"mappings":"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"}

package/dist/crowdy-client.js

@@ -88,6 +88,14 @@ export class CrowdyClient {
     getToken() {
         return this.session.getToken();
     }
+    /**
+     * Ergonomic, app-scoped realtime facade. `client.world(appId)` returns a
+     * {@link WorldClient} whose `actor()` and `subscribe()` helpers pass `appId`
+     * for you and manage chunk/sequence bookkeeping — the recommended entry point
+     * for game loops. The lower-level `client.udp` remains available.
+     *
+     * @param appId - The app to scope realtime traffic to (BigInt as a decimal string).
+     */
     world(appId) {
         return new WorldClient(appId, this.udp);
     }

package/dist/domains/actors.d.ts

@@ -1,22 +1,105 @@
 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.
+ * Persisted-actor (player / NPC) CRUD and filtering on the **game-api**.
+ * Exposed as `client.actors`.
  *
- * Note: this is the persisted-actor API. For high-frequency replication see
- * the existing `client.sendActorUpdate()` UDP path (unchanged).
+ * An "actor" here is the durable, server-stored record of a participant
+ * (identity, owning app, optional avatar, last-known chunk, and a state blob) —
+ * not the high-frequency spatial replication stream. For real-time position
+ * and state fan-out use the UDP path instead (`client.udp.sendActorUpdate(...)`
+ * or the ergonomic `client.world(appId).actor()` helper), which is unchanged
+ * and far cheaper per update.
  *
- * Exposed as `client.actors`.
+ * Actor ids are exactly **32 ASCII characters** (the UDP-wire actor id), **not**
+ * a hyphenated RFC-4122 UUID. Use {@link generateCrowdyUuid} to mint one.
+ * `BigInt` values (`appId`, `avatarId`, `userId`) are sent and received as
+ * decimal strings.
+ *
+ * Every method requires an authenticated session (a Bearer token set via
+ * `client.auth.login()` or `client.setToken()`) and that the caller is
+ * entitled to the target app, or it throws {@link CrowdyGraphQLError}
+ * (`UNAUTHENTICATED` / `FORBIDDEN`).
  */
 export declare class ActorsAPI {
     private gql;
     constructor(gql: GraphQLClient);
+    /**
+     * Fetch a single persisted actor by its 32-character actor id.
+     *
+     * @param uuid - The actor's 32-ASCII-character id.
+     * @returns The {@link Actor}, or `null` if no actor with that id exists.
+     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `FORBIDDEN` if the caller
+     *   isn't entitled to the actor's app.
+     */
     get(uuid: ActorQueryVariables['uuid']): Promise<ActorQuery['actor']>;
+    /**
+     * List persisted actors, optionally narrowed by an {@link ActorFilterInput}
+     * (e.g. by app, owning user, or avatar). Omit the filter to use its defaults.
+     *
+     * @param filter - Optional filter; fields are ANDed together.
+     * @returns The matching actors.
+     * @throws {CrowdyGraphQLError} on auth/validation failures.
+     */
     list(filter?: ActorsQueryVariables['filter']): Promise<ActorsQuery['actors']>;
+    /**
+     * Resolve many actors in one round-trip by id (and/or the other keys the
+     * {@link BatchActorLookupInput} accepts). Prefer this over calling
+     * {@link get} in a loop — it avoids N requests and N auth checks.
+     *
+     * @param input - The batch lookup keys.
+     * @returns The actors that were found (missing ids are simply omitted).
+     */
     batchLookup(input: BatchLookupActorsQueryVariables['input']): Promise<BatchLookupActorsQuery['batchLookupActors']>;
+    /**
+     * Create a persisted actor. `input.uuid` must be a unique 32-ASCII-character
+     * id and `input.appId` the owning app; `chunk` is the initial grid position.
+     * `avatarId`, `privateState`, and `publicState` are optional (state blobs are
+     * base64-encoded binary).
+     *
+     * @param input - {@link CreateActorInput}.
+     * @returns The newly created {@link Actor}.
+     * @throws {CrowdyGraphQLError} `BAD_USER_INPUT` (e.g. malformed/duplicate
+     *   uuid), `FORBIDDEN` if not entitled to the app, or `UNAUTHENTICATED`.
+     */
     create(input: CreateActorMutationVariables['input']): Promise<CreateActorMutation['createActor']>;
+    /**
+     * Patch an existing actor. Only the fields present on `input` change; omitted
+     * fields are left untouched.
+     *
+     * @param uuid - The actor's 32-character id.
+     * @param input - Fields to change ({@link UpdateActorInput}).
+     * @returns The updated {@link Actor}.
+     * @throws {CrowdyGraphQLError} if the actor doesn't exist or the caller lacks
+     *   access.
+     */
     update(uuid: UpdateActorMutationVariables['uuid'], input: UpdateActorMutationVariables['input']): Promise<UpdateActorMutation['updateActor']>;
-    delete(uuid: DeleteActorMutationVariables['uuid']): Promise<DeleteActorMutation['deleteActor']>;
+    /**
+     * Delete a persisted actor.
+     *
+     * Pass an `idempotencyKey` to make retries safe: replaying with the same key
+     * returns the first result instead of re-applying, while the same key with a
+     * **different** `uuid` throws {@link CrowdyGraphQLError} with
+     * `code === 'IDEMPOTENCY_CONFLICT'`. Keys expire server-side after 24h.
+     * Requires game-api ≥ v0.10.3.
+     *
+     * @param uuid - The actor's 32-character id.
+     * @param idempotencyKey - Optional client-supplied key for safe retries.
+     * @returns The deleted {@link Actor} (its identifying fields).
+     * @throws {CrowdyGraphQLError} `IDEMPOTENCY_CONFLICT`, `FORBIDDEN`, or
+     *   `UNAUTHENTICATED`.
+     */
+    delete(uuid: DeleteActorMutationVariables['uuid'], idempotencyKey?: DeleteActorMutationVariables['idempotencyKey']): Promise<DeleteActorMutation['deleteActor']>;
+    /**
+     * Replace just an actor's state blob(s) without touching its other fields —
+     * a lighter write than {@link update} when only `privateState`/`publicState`
+     * change. State is base64-encoded binary.
+     *
+     * @param uuid - The actor's 32-character id.
+     * @param input - {@link UpdateActorStateInput}.
+     * @returns The updated {@link Actor}.
+     * @throws {CrowdyGraphQLError} on auth/validation failures.
+     */
     updateState(uuid: UpdateActorStateMutationVariables['uuid'], input: UpdateActorStateMutationVariables['input']): Promise<UpdateActorStateMutation['updateActorState']>;
 }
 //# sourceMappingURL=actors.d.ts.map

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAEtC;;;;;;;OAOG;IACG,GAAG,CAAC,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAK1E;;;;;;;OAOG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAKnF;;;;;;;OAOG;IACG,WAAW,CACf,KAAK,EAAE,+BAA+B,CAAC,OAAO,CAAC,GAC9C,OAAO,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;IAKvD;;;;;;;;;;OAUG;IACG,MAAM,CACV,KAAK,EAAE,4BAA4B,CAAC,OAAO,CAAC,GAC3C,OAAO,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAK9C;;;;;;;;;OASG;IACG,MAAM,CACV,IAAI,EAAE,4BAA4B,CAAC,MAAM,CAAC,EAC1C,KAAK,EAAE,4BAA4B,CAAC,OAAO,CAAC,GAC3C,OAAO,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAK9C;;;;;;;;;;;;;;OAcG;IACG,MAAM,CACV,IAAI,EAAE,4BAA4B,CAAC,MAAM,CAAC,EAC1C,cAAc,CAAC,EAAE,4BAA4B,CAAC,gBAAgB,CAAC,GAC9D,OAAO,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAK9C;;;;;;;;;OASG;IACG,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"}