@crowdedkingdomstudios/crowdyjs 5.1.0 → 5.2.1

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -5,4 +5,57 @@
 // exactly one canonical UdpErrorCode shape. The hand-written enum that
 // used to live here drifted from the schema (`AppNotFound` etc.); see
 // generated/graphql.ts for the source of truth.
+/**
+ * Reason codes returned by the UDP game servers and surfaced on
+ * {@link GenericErrorResponse}'s `errorCode` (re-exported from the codegen enum
+ * so the SDK has exactly one canonical shape). `NoError` means success; every
+ * other value is a failure. The numeric value is the byte sent on the wire;
+ * the SDK exposes the name. Note that a failed message does **not** always
+ * produce an error — some auth failures are dropped silently.
+ *
+ * Each member and the server condition it represents:
+ * - `NoError` — no error (the byte `0`); the message was accepted.
+ * - `UnknownError` — unspecified server error (the byte `1`); retry, and report
+ *   it if it persists.
+ * - `AppNotFound` — no app matches the supplied appId.
+ * - `AppNotLoaded` — the app exists but isn't currently loaded/active on this
+ *   server.
+ * - `InvalidAppId` — the appId was missing, zero, or otherwise not valid.
+ * - `ChunkNotFound` — no chunk exists at the referenced coordinates.
+ * - `InvalidRequest` — the message was malformed or failed validation; check the
+ *   byte layout.
+ * - `InvalidStateData` — the state/payload bytes were invalid for this message
+ *   type.
+ * - `NameTooLong` — a supplied name exceeded the maximum length.
+ * - `UserNotAuthenticated` — this client has no authenticated session on the
+ *   server; complete the UDP token handshake (or open the UDP proxy) before
+ *   sending spatial messages.
+ * - `Unauthorized` — the caller lacks the runtime/grid permission for this
+ *   action. Grid permissions can load asynchronously, so the first message into
+ *   a newly entered region may transiently return this — retry shortly.
+ * - `UserNotAppAdmin` — the action requires app-admin privileges (the
+ *   `manage_apps` permission).
+ * - `InvalidToken` — the game token was rejected (expired, malformed, or
+ *   revoked); re-authenticate against the Management API for a fresh token.
+ * - `InvalidTokenLength` — the supplied token was not a valid length.
+ * - `GameTokenWrongSize` — the game token isn't the expected length; send the
+ *   exact token returned by login (don't trim or re-encode it).
+ * - `GridAlreadyExists` — a grid already exists at these coordinates.
+ * - `GridOverlapsExisting` — the requested grid overlaps an existing grid.
+ * - `GridOutsideAssignment` — the target coordinates fall outside any grid
+ *   assigned to the caller.
+ * - `InvalidGridCoordinates` — the grid coordinates were invalid.
+ * - `NoMatchingGridAssignment` — no grid assignment covers the referenced
+ *   coordinates.
+ * - `BadPassword` — the password did not match (login validation).
+ * - `EmailNotFound` — no account matches the supplied email (login validation).
+ * - `EmailAlreadyExists` — registration failed because the email is already in
+ *   use.
+ * - `EmailInvalid` — email failed format validation.
+ * - `EmailTooLong` / `EmailTooShort` — email failed maximum-/minimum-length
+ *   validation.
+ * - `PasswordTooLong` / `PasswordTooShort` — password failed maximum-/minimum-
+ *   length validation.
+ * - `GamertagAlreadyExists` — the requested gamertag is already taken.
+ */
 export { UdpErrorCode } from './generated/graphql.js';

package/dist/utils.d.ts

@@ -1,12 +1,98 @@
 import type { ChunkCoordinatesInput } from './generated/graphql.js';
+/**
+ * Allocates the per-client `sequenceNumber` stamped on outgoing spatial
+ * messages (actor / voxel / audio / text / event sends). The `...AndWait`
+ * helpers use it to correlate each send with the echo or
+ * {@link GenericErrorResponse} the server fans back on the `udpNotifications`
+ * subscription (matched via `sequenceNumber`).
+ *
+ * Values are a single **unsigned byte**: they advance monotonically and wrap
+ * modulo 256 (…, 254, 255, 0, 1, …), mirroring the uint8 carried on the UDP
+ * wire. This is for **correlation only** — a `sequenceNumber` is *not* an
+ * idempotency key, and with just 256 distinct values you should treat an echo
+ * as matched as soon as it arrives rather than keeping many sends in flight at
+ * once.
+ *
+ * Allocate one instance per client/connection so its counter stays private to
+ * that session.
+ */
 export declare class SequenceAllocator {
     private nextValue;
+    /**
+     * @param seed - The first value {@link next} will return, truncated to a
+     *   byte (`seed & 0xff`). Defaults to `1`.
+     */
     constructor(seed?: number);
+    /**
+     * Return the current sequence value, then advance the counter by one
+     * (wrapping back to `0` after `255`).
+     *
+     * @returns The next sequence number to stamp on a send, in the inclusive
+     *   range `0`–`255`.
+     */
     next(): number;
 }
+/**
+ * Mint a fresh Crowdy actor id: 16 cryptographically random bytes rendered as
+ * **32 lowercase-hex ASCII characters** (e.g.
+ * `"0123456789abcdef0123456789abcdef"`).
+ *
+ * This is the UDP-wire actor id used throughout the SDK — it is **not** a
+ * hyphenated RFC-4122 UUID and carries no dashes or version/variant bits. The
+ * result always satisfies {@link validateCrowdyUuid} (exactly 32 ASCII bytes).
+ *
+ * Requires a Web Crypto `crypto.getRandomValues` global (present in browsers
+ * and modern Node, or polyfilled).
+ *
+ * @returns A new 32-character hex actor id.
+ */
 export declare function generateCrowdyUuid(): string;
+/**
+ * Assert that `uuid` is a well-formed Crowdy actor id — **exactly 32 bytes
+ * when UTF-8 encoded**. Because the wire id is plain ASCII that means 32 ASCII
+ * characters; any non-ASCII character encodes to multiple bytes and so fails
+ * the check. Call it before sending an id you didn't obtain from
+ * {@link generateCrowdyUuid} or the server.
+ *
+ * @param uuid - The candidate actor id.
+ * @throws {CrowdyProtocolError} if the id is not exactly 32 UTF-8 bytes.
+ */
 export declare function validateCrowdyUuid(uuid: string): void;
+/**
+ * Encode raw bytes as a base64 string for the SDK's binary fields — the
+ * `state`, `audioData`, `payload`, and similar blobs on spatial sends and
+ * notifications all travel as base64 over the wire.
+ *
+ * Uses the `btoa` global; each `Uint8Array` element is treated as one byte.
+ * Inverse of {@link decodeBase64}.
+ *
+ * @param bytes - The binary payload to encode.
+ * @returns The base64-encoded representation.
+ */
 export declare function encodeBase64(bytes: Uint8Array): string;
+/**
+ * Decode a base64 string from a binary SDK/wire field (e.g. a notification's
+ * `state` / `audioData` / `payload`) back into raw bytes.
+ *
+ * Uses the `atob` global. Inverse of {@link encodeBase64}.
+ *
+ * @param value - The base64 text to decode.
+ * @returns The decoded bytes.
+ */
 export declare function decodeBase64(value: string): Uint8Array;
+/**
+ * Assert that a chunk address fits the wire format: each of `x`, `y`, `z` must
+ * be a valid **signed 64-bit integer**
+ * (−9,223,372,036,854,775,808 … 9,223,372,036,854,775,807). Chunk coordinates
+ * travel as int64 decimal strings, so this guards against values that would
+ * overflow the server's int64 columns before you send them.
+ *
+ * Each axis is parsed with `BigInt()`, so a number or a decimal string is
+ * accepted; a non-integer literal is rejected by `BigInt()` itself (a native
+ * `SyntaxError`) before the range check runs.
+ *
+ * @param chunk - The chunk coordinates to validate.
+ * @throws {CrowdyProtocolError} if any axis is outside the signed int64 range.
+ */
 export declare function validateChunkCoordinates(chunk: ChunkCoordinatesInput): void;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAW,MAAM,wBAAwB,CAAC;AAE7E,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,SAAI;IAIpB,IAAI,IAAI,MAAM;CAKf;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAM3C;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAMtD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAOtD;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAS3E"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAW,MAAM,wBAAwB,CAAC;AAE7E;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAS;IAE1B;;;OAGG;gBACS,IAAI,SAAI;IAIpB;;;;;;OAMG;IACH,IAAI,IAAI,MAAM;CAKf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAM3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAMtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAOtD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAS3E"}

package/dist/utils.js

@@ -1,14 +1,56 @@
 import { CrowdyProtocolError } from './errors.js';
+/**
+ * Allocates the per-client `sequenceNumber` stamped on outgoing spatial
+ * messages (actor / voxel / audio / text / event sends). The `...AndWait`
+ * helpers use it to correlate each send with the echo or
+ * {@link GenericErrorResponse} the server fans back on the `udpNotifications`
+ * subscription (matched via `sequenceNumber`).
+ *
+ * Values are a single **unsigned byte**: they advance monotonically and wrap
+ * modulo 256 (…, 254, 255, 0, 1, …), mirroring the uint8 carried on the UDP
+ * wire. This is for **correlation only** — a `sequenceNumber` is *not* an
+ * idempotency key, and with just 256 distinct values you should treat an echo
+ * as matched as soon as it arrives rather than keeping many sends in flight at
+ * once.
+ *
+ * Allocate one instance per client/connection so its counter stays private to
+ * that session.
+ */
 export class SequenceAllocator {
+    /**
+     * @param seed - The first value {@link next} will return, truncated to a
+     *   byte (`seed & 0xff`). Defaults to `1`.
+     */
     constructor(seed = 1) {
         this.nextValue = seed & 0xff;
     }
+    /**
+     * Return the current sequence value, then advance the counter by one
+     * (wrapping back to `0` after `255`).
+     *
+     * @returns The next sequence number to stamp on a send, in the inclusive
+     *   range `0`–`255`.
+     */
     next() {
         const value = this.nextValue;
         this.nextValue = (this.nextValue + 1) & 0xff;
         return value;
     }
 }
+/**
+ * Mint a fresh Crowdy actor id: 16 cryptographically random bytes rendered as
+ * **32 lowercase-hex ASCII characters** (e.g.
+ * `"0123456789abcdef0123456789abcdef"`).
+ *
+ * This is the UDP-wire actor id used throughout the SDK — it is **not** a
+ * hyphenated RFC-4122 UUID and carries no dashes or version/variant bits. The
+ * result always satisfies {@link validateCrowdyUuid} (exactly 32 ASCII bytes).
+ *
+ * Requires a Web Crypto `crypto.getRandomValues` global (present in browsers
+ * and modern Node, or polyfilled).
+ *
+ * @returns A new 32-character hex actor id.
+ */
 export function generateCrowdyUuid() {
     const bytes = new Uint8Array(16);
     crypto.getRandomValues(bytes);
@@ -16,6 +58,16 @@ export function generateCrowdyUuid() {
         .map((byte) => byte.toString(16).padStart(2, '0'))
         .join('');
 }
+/**
+ * Assert that `uuid` is a well-formed Crowdy actor id — **exactly 32 bytes
+ * when UTF-8 encoded**. Because the wire id is plain ASCII that means 32 ASCII
+ * characters; any non-ASCII character encodes to multiple bytes and so fails
+ * the check. Call it before sending an id you didn't obtain from
+ * {@link generateCrowdyUuid} or the server.
+ *
+ * @param uuid - The candidate actor id.
+ * @throws {CrowdyProtocolError} if the id is not exactly 32 UTF-8 bytes.
+ */
 export function validateCrowdyUuid(uuid) {
     if (new TextEncoder().encode(uuid).length !== 32) {
         throw new CrowdyProtocolError({
@@ -23,6 +75,17 @@ export function validateCrowdyUuid(uuid) {
         });
     }
 }
+/**
+ * Encode raw bytes as a base64 string for the SDK's binary fields — the
+ * `state`, `audioData`, `payload`, and similar blobs on spatial sends and
+ * notifications all travel as base64 over the wire.
+ *
+ * Uses the `btoa` global; each `Uint8Array` element is treated as one byte.
+ * Inverse of {@link decodeBase64}.
+ *
+ * @param bytes - The binary payload to encode.
+ * @returns The base64-encoded representation.
+ */
 export function encodeBase64(bytes) {
     let binary = '';
     for (const byte of bytes) {
@@ -30,6 +93,15 @@ export function encodeBase64(bytes) {
     }
     return btoa(binary);
 }
+/**
+ * Decode a base64 string from a binary SDK/wire field (e.g. a notification's
+ * `state` / `audioData` / `payload`) back into raw bytes.
+ *
+ * Uses the `atob` global. Inverse of {@link encodeBase64}.
+ *
+ * @param value - The base64 text to decode.
+ * @returns The decoded bytes.
+ */
 export function decodeBase64(value) {
     const binary = atob(value);
     const bytes = new Uint8Array(binary.length);
@@ -38,6 +110,20 @@ export function decodeBase64(value) {
     }
     return bytes;
 }
+/**
+ * Assert that a chunk address fits the wire format: each of `x`, `y`, `z` must
+ * be a valid **signed 64-bit integer**
+ * (−9,223,372,036,854,775,808 … 9,223,372,036,854,775,807). Chunk coordinates
+ * travel as int64 decimal strings, so this guards against values that would
+ * overflow the server's int64 columns before you send them.
+ *
+ * Each axis is parsed with `BigInt()`, so a number or a decimal string is
+ * accepted; a non-integer literal is rejected by `BigInt()` itself (a native
+ * `SyntaxError`) before the range check runs.
+ *
+ * @param chunk - The chunk coordinates to validate.
+ * @throws {CrowdyProtocolError} if any axis is outside the signed int64 range.
+ */
 export function validateChunkCoordinates(chunk) {
     for (const axis of ['x', 'y', 'z']) {
         const value = BigInt(chunk[axis]);

package/dist/world.d.ts

@@ -1,33 +1,212 @@
 import type { UdpAPI } from './domains/udp.js';
 import type { ActorUpdateRequestInput, ChunkCoordinatesInput, ClientEventNotificationInput, ClientTextPacketInput, Scalars, VoxelUpdateRequestInput } from './generated/graphql.js';
 import type { SpatialNotification, UdpNotificationHandlers } from './realtime.js';
+/**
+ * Options for {@link WorldClient.actor}. All fields are optional.
+ */
 export interface ActorOptions {
+    /**
+     * The actor's id: exactly 32 ASCII characters (the UDP-wire id), **not** a
+     * hyphenated RFC-4122 UUID. Omit to mint a fresh one with
+     * {@link generateCrowdyUuid}. Validated when the {@link ActorClient} is
+     * created.
+     */
     uuid?: string;
+    /**
+     * Default chunk replication radius (in chunk units, 0-8) applied to
+     * {@link ActorClient.sendState} when the call doesn't override `distance`.
+     */
     defaultDistance?: number;
+    /**
+     * Default replication decay algorithm (0 none, 1 exponential, 2 linear 50%,
+     * 3 linear 25%, 4 linear 10%, 5 linear 5%) applied to
+     * {@link ActorClient.sendState} when the call doesn't override `decayRate`.
+     */
     defaultDecayRate?: number;
 }
+/**
+ * Ergonomic, **app-scoped** realtime facade returned by `client.world(appId)`.
+ * Wraps {@link UdpAPI}, passing `appId` for you on every spatial send and
+ * subscription so you never repeat it — the recommended entry point for game
+ * loops; the lower-level `client.udp` remains available. Requires the same
+ * authenticated bearer game token as `client.udp`.
+ */
 export declare class WorldClient {
     private readonly appId;
     private readonly udp;
     constructor(appId: Scalars['BigInt']['input'], udp: UdpAPI);
+    /**
+     * Create an {@link ActorClient} bound to this app. The actor tracks its
+     * current chunk after {@link ActorClient.join} (so later sends don't repeat
+     * the chunk) and allocates `sequenceNumber`s for its `...AndWait` calls.
+     *
+     * @param options - {@link ActorOptions}. If `uuid` is omitted a fresh
+     *   32-character id is generated; `defaultDistance` / `defaultDecayRate`
+     *   become this actor's per-call defaults for {@link ActorClient.sendState}.
+     * @returns A new {@link ActorClient}.
+     * @throws {CrowdyProtocolError} if a supplied `uuid` is not exactly 32 bytes
+     *   when UTF-8 encoded.
+     */
     actor(options?: ActorOptions): ActorClient;
+    /**
+     * Open an app-scoped subscription, passing this world's `appId` to
+     * {@link UdpAPI.subscribe} for you. The first subscriber opens the shared
+     * WebSocket; the last to unsubscribe closes it.
+     *
+     * @param handlers - {@link UdpNotificationHandlers} (see {@link UdpAPI.subscribe}).
+     * @returns An unsubscribe function that detaches these handlers (and closes
+     *   the shared WebSocket if it was the last subscription).
+     * @throws {CrowdyRealtimeError} `code === 'AUTH_REQUIRED'` if there is no
+     *   session token.
+     */
     subscribe(handlers: UdpNotificationHandlers): () => void;
 }
+/**
+ * A single actor (player / NPC) in one app's realtime world, created via
+ * `client.world(appId).actor(...)`. Holds a stable 32-character {@link uuid}
+ * and remembers the actor's current chunk after {@link join}, so the spatial
+ * helpers ({@link sendState}, {@link sendVoxelUpdate}, {@link sendText},
+ * {@link sendEvent}) don't need the chunk repeated. Those helpers use the UDP
+ * `...AndWait` path and resolve with the correlated echo/notification, so they
+ * require an active subscription (e.g. {@link WorldClient.subscribe}).
+ */
 export declare class ActorClient {
     private readonly appId;
     private readonly udp;
     private readonly options;
+    /**
+     * This actor's id: exactly 32 ASCII characters (the UDP-wire id), **not** an
+     * RFC-4122 UUID. Set at construction and validated.
+     */
     readonly uuid: string;
     private chunk;
     constructor(appId: Scalars['BigInt']['input'], udp: UdpAPI, options: Required<Pick<ActorOptions, 'uuid'>> & Pick<ActorOptions, 'defaultDistance' | 'defaultDecayRate'>);
+    /**
+     * Enter a chunk: records it as this actor's current chunk and sends an
+     * initial actor update to register presence there. Resolves with the server's
+     * applied `ActorUpdateResponse` echo.
+     *
+     * The **first** spatial message to a brand-new chunk may be dropped
+     * server-side while grid permissions load, so if this rejects with a timeout,
+     * simply call `join` again (the two-client tests register twice).
+     *
+     * @param chunk - The chunk to enter, `{ x, y, z }` with each axis a signed
+     *   int64 decimal string. A chunk is a 16x16x16 voxel cube.
+     * @param state - Initial actor state blob, base64-encoded. Defaults to `'AA=='`
+     *   (a single zero byte), i.e. registration-only.
+     * @returns The correlated {@link SpatialNotification} (`ActorUpdateResponse`).
+     * @throws {CrowdyProtocolError} if `chunk` is outside signed int64 range.
+     * @throws {CrowdyGraphQLError} if the underlying send is rejected.
+     * @throws {CrowdyTimeoutError} if the HTTP send leg times out.
+     * @throws {CrowdyRealtimeError} if no echo arrives within the timeout
+     *   (`code === 'UDP_SEQUENCE_TIMEOUT'`) or the server returns a matching
+     *   `GenericErrorResponse`.
+     */
     join(chunk: ChunkCoordinatesInput, state?: string): Promise<SpatialNotification>;
+    /**
+     * Send a state update for this actor to its current chunk (set by
+     * {@link join}) or to `options.chunk` if provided. Uses the UDP `...AndWait`
+     * path and resolves with the applied `ActorUpdateResponse` echo. `appId` and
+     * `uuid` are filled in for you.
+     *
+     * @param state - Actor state blob, base64-encoded (may be `''` for a
+     *   registration-only update).
+     * @param options - Optional overrides:
+     *   - `chunk` — `{ x, y, z }` (signed int64 decimal strings) to send to
+     *     instead of the tracked chunk.
+     *   - `distance` — replication radius in chunk units, 0-8; defaults to the
+     *     actor's `defaultDistance`.
+     *   - `decayRate` — decay algorithm 0-5; defaults to the actor's
+     *     `defaultDecayRate`.
+     * @returns The correlated {@link SpatialNotification} (`ActorUpdateResponse`).
+     * @throws {Error} `'Actor must join a chunk before sending state'` if no chunk
+     *   has been joined and none is supplied.
+     * @throws {CrowdyProtocolError} if the resolved chunk is outside int64 range.
+     * @throws {CrowdyGraphQLError} if the underlying send is rejected.
+     * @throws {CrowdyTimeoutError} if the HTTP send leg times out.
+     * @throws {CrowdyRealtimeError} on echo timeout
+     *   (`code === 'UDP_SEQUENCE_TIMEOUT'`) or a matching `GenericErrorResponse`.
+     */
     sendState(state: string, options?: Partial<Pick<ActorUpdateRequestInput, 'chunk' | 'distance' | 'decayRate'>>): Promise<SpatialNotification>;
+    /**
+     * Send a voxel (block) update from this actor to its current chunk (or
+     * `input.chunk`). Uses the UDP `...AndWait` path and resolves with the applied
+     * `VoxelUpdateResponse` echo. `appId`, `uuid`, and `chunk` are filled in for
+     * you.
+     *
+     * @param input - Voxel fields minus `appId`/`uuid`/`chunk`:
+     *   - `voxel` — `{ x, y, z }` voxel coordinates within the chunk, each an
+     *     int16 (-32768 to 32767).
+     *   - `voxelType` — the new voxel type id.
+     *   - `voxelState` — voxel state blob, base64-encoded.
+     *   - `distance` — replication radius in chunk units, 0-8; defaults to 8.
+     *   - `decayRate` — decay algorithm 0-5; defaults to 0 (none).
+     *   - `sequenceNumber` — optional uint8 (0-255) correlation id.
+     *   - `chunk` — optional `{ x, y, z }` (signed int64 decimal strings) to
+     *     override the tracked chunk.
+     * @returns The correlated {@link SpatialNotification} (`VoxelUpdateResponse`).
+     * @throws {Error} `'Actor must join a chunk before sending voxel updates'` if
+     *   no chunk has been joined and none is supplied.
+     * @throws {CrowdyProtocolError} if the resolved chunk is outside int64 range.
+     * @throws {CrowdyGraphQLError} if the underlying send is rejected.
+     * @throws {CrowdyTimeoutError} if the HTTP send leg times out.
+     * @throws {CrowdyRealtimeError} on echo timeout
+     *   (`code === 'UDP_SEQUENCE_TIMEOUT'`) or a matching `GenericErrorResponse`.
+     */
     sendVoxelUpdate(input: Omit<VoxelUpdateRequestInput, 'appId' | 'uuid' | 'chunk'> & {
         chunk?: ChunkCoordinatesInput;
     }): Promise<SpatialNotification>;
+    /**
+     * Send a spatial text/chat packet from this actor to its current chunk (or
+     * `input.chunk`), fanned out to nearby actors as a `ClientTextNotification`.
+     *
+     * Uses the UDP `...AndWait` path, but the server does **not** echo text back
+     * to the sender, so on success there is typically no notification to resolve
+     * and this will reject with a timeout — use it to surface send errors, or
+     * prefer `client.udp.sendTextPacket(...)` for plain fire-and-forget. `appId`,
+     * `uuid`, and `chunk` are filled in for you.
+     *
+     * @param text - Message content, UTF-8 (plain text, not base64).
+     * @param input - Optional extra fields: `distance` (chunk units, 0-8, default
+     *   8), `decayRate` (0-5, default 0), `sequenceNumber` (uint8), and `chunk` to
+     *   override the tracked chunk.
+     * @returns The correlated {@link SpatialNotification}, if one is delivered.
+     * @throws {Error} `'Actor must join a chunk before sending text'` if no chunk
+     *   has been joined and none is supplied.
+     * @throws {CrowdyProtocolError} if the resolved chunk is outside int64 range.
+     * @throws {CrowdyGraphQLError} if the underlying send is rejected.
+     * @throws {CrowdyTimeoutError} if the HTTP send leg times out.
+     * @throws {CrowdyRealtimeError} on timeout (`code === 'UDP_SEQUENCE_TIMEOUT'`)
+     *   or a matching `GenericErrorResponse`.
+     */
     sendText(text: string, input?: Partial<Omit<ClientTextPacketInput, 'appId' | 'uuid' | 'text' | 'chunk'>> & {
         chunk?: ChunkCoordinatesInput;
     }): Promise<SpatialNotification>;
+    /**
+     * Send a custom, app-defined client event from this actor to its current
+     * chunk (or `input.chunk`); nearby actors receive a `ClientEventNotification`.
+     *
+     * Uses the UDP `...AndWait` path, but the server does **not** echo events back
+     * to the sender, so on success there is typically no notification to resolve
+     * and this will reject with a timeout — use it to surface send errors, or
+     * prefer `client.udp.sendClientEvent(...)` for plain fire-and-forget. `appId`,
+     * `uuid`, and `chunk` are filled in for you.
+     *
+     * @param eventType - App-defined event id, a uint16 (0-65535).
+     * @param state - Event state blob, base64-encoded; format defined by the event
+     *   type.
+     * @param input - Optional extra fields: `distance` (chunk units, 0-8, default
+     *   8), `decayRate` (0-5, default 0), `sequenceNumber` (uint8), and `chunk` to
+     *   override the tracked chunk.
+     * @returns The correlated {@link SpatialNotification}, if one is delivered.
+     * @throws {Error} `'Actor must join a chunk before sending events'` if no
+     *   chunk has been joined and none is supplied.
+     * @throws {CrowdyProtocolError} if the resolved chunk is outside int64 range.
+     * @throws {CrowdyGraphQLError} if the underlying send is rejected.
+     * @throws {CrowdyTimeoutError} if the HTTP send leg times out.
+     * @throws {CrowdyRealtimeError} on timeout (`code === 'UDP_SEQUENCE_TIMEOUT'`)
+     *   or a matching `GenericErrorResponse`.
+     */
     sendEvent(eventType: number, state: string, input?: Partial<Omit<ClientEventNotificationInput, 'appId' | 'uuid' | 'eventType' | 'state' | 'chunk'>> & {
         chunk?: ChunkCoordinatesInput;
     }): Promise<SpatialNotification>;
@@ -36,6 +215,19 @@ export declare class ActorClient {
      * the chunk it currently occupies (the sender must know the target's chunk).
      * Only that one actor receives it. Fire-and-forget: there is no echo to the
      * sender, so this resolves to the send acknowledgement, not a notification.
+     *
+     * @param targetUuid - The destination actor's id: exactly 32 ASCII characters
+     *   (not RFC-4122).
+     * @param payload - Message body, base64-encoded; opaque to the server.
+     * @param targetChunk - The destination actor's current `{ x, y, z }` chunk
+     *   (each axis a signed int64 decimal string).
+     * @param options - `sequenceNumber`: optional uint8 (0-255) correlation id
+     *   (used only to correlate a `GenericErrorResponse`).
+     * @returns `true` when the datagram was accepted for sending — **not**
+     *   confirmation of delivery.
+     * @throws {CrowdyProtocolError} if `targetUuid` is not exactly 32 bytes, or
+     *   `targetChunk` is outside signed int64 range.
+     * @throws {CrowdyGraphQLError} on auth/validation failures.
      */
     sendToActor(targetUuid: string, payload: string, targetChunk: ChunkCoordinatesInput, options?: {
         sequenceNumber?: number;

package/dist/world.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../src/world.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,EAC5B,qBAAqB,EACrB,OAAO,EACP,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGlF,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,GAAG,EAAE,MAAM;IAG9B,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,WAAW;IAQ9C,SAAS,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,IAAI;CAGzD;AAED,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,KAAK,CAAsC;gBAGhC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAC5D,IAAI,CAAC,YAAY,EAAE,iBAAiB,GAAG,kBAAkB,CAAC;IAMxD,IAAI,CACR,KAAK,EAAE,qBAAqB,EAC5B,KAAK,SAAS,GACb,OAAO,CAAC,mBAAmB,CAAC;IAKzB,SAAS,CACb,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC,CAAM,GACvF,OAAO,CAAC,mBAAmB,CAAC;IAgBzB,eAAe,CACnB,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG;QACjE,KAAK,CAAC,EAAE,qBAAqB,CAAC;KAC/B,GACA,OAAO,CAAC,mBAAmB,CAAC;IAczB,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG;QACjF,KAAK,CAAC,EAAE,qBAAqB,CAAC;KAC1B,GACL,OAAO,CAAC,mBAAmB,CAAC;IAezB,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,GAAG;QACvG,KAAK,CAAC,EAAE,qBAAqB,CAAC;KAC1B,GACL,OAAO,CAAC,mBAAmB,CAAC;IAgB/B;;;;;OAKG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,qBAAqB,EAClC,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAO,GACxC,OAAO,CAAC,OAAO,CAAC;CAWpB"}
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../src/world.ts"],"names":[],"mappings":"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"}