@crowdedkingdoms/crowdyjs 8.0.0 → 8.0.1

package/dist/world.d.ts

@@ -84,7 +84,8 @@ export declare class ActorClient {
     /**
      * 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.
+     * applied echo — your own `ActorUpdateNotification` (the sender is included in
+     * the chunk fan-out), correlated by `sequenceNumber`.
      *
      * 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,
@@ -94,7 +95,8 @@ export declare class ActorClient {
      *   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`).
+     * @returns The correlated {@link SpatialNotification} (your own
+     *   `ActorUpdateNotification` self-echo).
      * @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.
@@ -106,8 +108,9 @@ export declare class ActorClient {
     /**
      * 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.
+     * path and resolves with the applied echo — your own `ActorUpdateNotification`
+     * (the sender is included in the chunk fan-out). `appId` and `uuid` are filled
+     * in for you.
      *
      * @param state - Actor state blob, base64-encoded (may be `''` for a
      *   registration-only update).
@@ -118,7 +121,8 @@ export declare class ActorClient {
      *     actor's `defaultDistance`.
      *   - `decayRate` — decay algorithm 0-5; defaults to the actor's
      *     `defaultDecayRate`.
-     * @returns The correlated {@link SpatialNotification} (`ActorUpdateResponse`).
+     * @returns The correlated {@link SpatialNotification} (your own
+     *   `ActorUpdateNotification` self-echo).
      * @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.
@@ -131,8 +135,8 @@ export declare class ActorClient {
     /**
      * 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.
+     * echo — your own `VoxelUpdateNotification` (the sender is included in the
+     * chunk fan-out). `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
@@ -144,7 +148,8 @@ export declare class ActorClient {
      *   - `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`).
+     * @returns The correlated {@link SpatialNotification} (your own
+     *   `VoxelUpdateNotification` self-echo).
      * @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.

package/dist/world.d.ts.map

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

package/dist/world.js

@@ -66,7 +66,8 @@ export class ActorClient {
     /**
      * 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.
+     * applied echo — your own `ActorUpdateNotification` (the sender is included in
+     * the chunk fan-out), correlated by `sequenceNumber`.
      *
      * 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,
@@ -76,7 +77,8 @@ export class ActorClient {
      *   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`).
+     * @returns The correlated {@link SpatialNotification} (your own
+     *   `ActorUpdateNotification` self-echo).
      * @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.
@@ -91,8 +93,9 @@ export class ActorClient {
     /**
      * 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.
+     * path and resolves with the applied echo — your own `ActorUpdateNotification`
+     * (the sender is included in the chunk fan-out). `appId` and `uuid` are filled
+     * in for you.
      *
      * @param state - Actor state blob, base64-encoded (may be `''` for a
      *   registration-only update).
@@ -103,7 +106,8 @@ export class ActorClient {
      *     actor's `defaultDistance`.
      *   - `decayRate` — decay algorithm 0-5; defaults to the actor's
      *     `defaultDecayRate`.
-     * @returns The correlated {@link SpatialNotification} (`ActorUpdateResponse`).
+     * @returns The correlated {@link SpatialNotification} (your own
+     *   `ActorUpdateNotification` self-echo).
      * @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.
@@ -130,8 +134,8 @@ export class ActorClient {
     /**
      * 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.
+     * echo — your own `VoxelUpdateNotification` (the sender is included in the
+     * chunk fan-out). `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
@@ -143,7 +147,8 @@ export class ActorClient {
      *   - `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`).
+     * @returns The correlated {@link SpatialNotification} (your own
+     *   `VoxelUpdateNotification` self-echo).
      * @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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crowdedkingdoms/crowdyjs",
-  "version": "8.0.0",
+  "version": "8.0.1",
   "description": "Client SDK for Crowded Kingdoms GraphQL API with UDP proxy support",
   "type": "module",
   "main": "dist/index.js",
@@ -21,12 +21,13 @@
     "MIGRATION.md"
   ],
   "scripts": {
-    "sync-schema": "node scripts/sync-schema.mjs",
-    "precodegen": "npm run sync-schema",
+    "schema:sync": "npm run schema:sync:prod",
+    "schema:sync:prod": "node scripts/sync-schema.mjs --prod",
+    "schema:sync:local": "node scripts/sync-schema.mjs --local",
+    "schema:sync:paths": "node scripts/sync-schema.mjs",
     "codegen": "graphql-codegen --config codegen.ts",
     "check:schema": "npm run codegen && git diff --exit-code schema.gql src/generated/graphql.ts",
     "codegen:watch": "graphql-codegen --config codegen.ts --watch",
-    "prebuild": "npm run codegen",
     "build": "tsc",
     "test": "npm run build && node --test --test-concurrency=1 test/unit/*.test.mjs test/e2e/*.test.mjs",
     "test:unit": "npm run build && node --test test/unit/*.test.mjs",
@@ -61,6 +62,7 @@
     "@graphql-codegen/typed-document-node": "^6.1.8",
     "@graphql-codegen/typescript": "^5.0.10",
     "@graphql-codegen/typescript-operations": "^5.1.0",
+    "@graphql-tools/merge": "^9.1.10",
     "@types/node": "^22.10.7",
     "typescript": "^5.7.3",
     "ws": "^8.20.0"