@crowdedkingdoms/crowdyjs 8.0.0 → 8.1.0

package/dist/domains/host.d.ts

@@ -1,5 +1,5 @@
 import type { GraphQLClient } from '../client.js';
-import { type GameHostQuery, type ActorHeartbeatMutation } from '../generated/graphql.js';
+import { type GameHostQuery, type AmIGameHostQuery, type ActorHeartbeatMutation } from '../generated/graphql.js';
 /**
  * Game-host election + actor liveness heartbeat — exposed as `client.host`.
  *
@@ -7,8 +7,10 @@ import { type GameHostQuery, type ActorHeartbeatMutation } from '../generated/gr
  * game-api replicas (the user whose earliest still-connected actor was created
  * first wins). {@link heartbeat} refreshes the caller's actor freshness (keeping
  * them host-eligible) and returns the freshly-elected host in one round-trip —
- * call it on an interval shorter than the server's freshness window. Both
- * require a valid session; `appId` is a `BigInt` decimal string.
+ * call it on an interval shorter than the server's freshness window.
+ * {@link amIHost} is a UI convenience (not authoritative for mutations — use
+ * `gameModelInvoke`'s `is_host` policy for that). All require a valid session;
+ * `appId` is a `BigInt` decimal string.
  *
  * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` without a session.
  */
@@ -23,6 +25,15 @@ export declare class HostAPI {
      * @returns The elected {@link GameHost}, or `null`.
      */
     get(appId: string): Promise<GameHostQuery['gameHost']>;
+    /**
+     * Return whether the authenticated caller is the currently elected host for
+     * the app. Convenience for UI only — not authoritative for server mutations
+     * (use `gameModelInvoke`'s `is_host` policy for that).
+     *
+     * @param appId - The app to check host election for.
+     * @returns `true` if the caller is the elected host; otherwise `false`.
+     */
+    amIHost(appId: string): Promise<AmIGameHostQuery['amIGameHost']>;
     /**
      * Refresh the caller's actor freshness in an app and return the freshly
      * elected host. Returns `null` when no fresh actors exist for the app.

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

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/domains/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAEnD;;;;;;OAMG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAK5D;;;;;;OAMG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;CAIlF"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/domains/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;GAaG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAEnD;;;;;;OAMG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAK5D;;;;;;;OAOG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAKtE;;;;;;OAMG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;CAIlF"}

package/dist/domains/host.js

@@ -1,4 +1,4 @@
-import { GameHostDocument, ActorHeartbeatDocument, } from '../generated/graphql.js';
+import { GameHostDocument, AmIGameHostDocument, ActorHeartbeatDocument, } from '../generated/graphql.js';
 /**
  * Game-host election + actor liveness heartbeat — exposed as `client.host`.
  *
@@ -6,8 +6,10 @@ import { GameHostDocument, ActorHeartbeatDocument, } from '../generated/graphql.
  * game-api replicas (the user whose earliest still-connected actor was created
  * first wins). {@link heartbeat} refreshes the caller's actor freshness (keeping
  * them host-eligible) and returns the freshly-elected host in one round-trip —
- * call it on an interval shorter than the server's freshness window. Both
- * require a valid session; `appId` is a `BigInt` decimal string.
+ * call it on an interval shorter than the server's freshness window.
+ * {@link amIHost} is a UI convenience (not authoritative for mutations — use
+ * `gameModelInvoke`'s `is_host` policy for that). All require a valid session;
+ * `appId` is a `BigInt` decimal string.
  *
  * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` without a session.
  */
@@ -26,6 +28,18 @@ export class HostAPI {
         const data = await this.graphql.request(GameHostDocument, { appId });
         return data.gameHost;
     }
+    /**
+     * Return whether the authenticated caller is the currently elected host for
+     * the app. Convenience for UI only — not authoritative for server mutations
+     * (use `gameModelInvoke`'s `is_host` policy for that).
+     *
+     * @param appId - The app to check host election for.
+     * @returns `true` if the caller is the elected host; otherwise `false`.
+     */
+    async amIHost(appId) {
+        const data = await this.graphql.request(AmIGameHostDocument, { appId });
+        return data.amIGameHost;
+    }
     /**
      * Refresh the caller's actor freshness in an app and return the freshly
      * elected host. Returns `null` when no fresh actors exist for the app.

package/dist/domains/organizations.d.ts

@@ -101,13 +101,13 @@ export declare class OrganizationsAPI {
      * Mint a new org API token (for server-side studio backends). Requires the
      * `manage_tokens` org permission. The plaintext secret is returned **once**.
      *
-     * @param input - {@link CreateOrgTokenInput}: `orgId`, `name`, optional
-     *   `permissions` and `expiresAt`.
+     * @param input - {@link CreateOrgTokenInput}: `orgId`, optional `label` and
+     *   `expiresAt`.
      * @returns The created token including its one-time plaintext secret.
      */
     createToken(input: CreateOrgTokenInput): Promise<CreateOrgTokenMutation['createOrgToken']>;
     /**
-     * Update an org token's metadata (name / permissions / expiry). Requires the
+     * Update an org token's metadata (label / active flag / expiry). Requires the
      * `manage_tokens` org permission.
      *
      * @param orgTokenId - Numeric token id.

package/dist/domains/organizations.js

@@ -142,8 +142,8 @@ export class OrganizationsAPI {
      * Mint a new org API token (for server-side studio backends). Requires the
      * `manage_tokens` org permission. The plaintext secret is returned **once**.
      *
-     * @param input - {@link CreateOrgTokenInput}: `orgId`, `name`, optional
-     *   `permissions` and `expiresAt`.
+     * @param input - {@link CreateOrgTokenInput}: `orgId`, optional `label` and
+     *   `expiresAt`.
      * @returns The created token including its one-time plaintext secret.
      */
     async createToken(input) {
@@ -153,7 +153,7 @@ export class OrganizationsAPI {
         return data.createOrgToken;
     }
     /**
-     * Update an org token's metadata (name / permissions / expiry). Requires the
+     * Update an org token's metadata (label / active flag / expiry). Requires the
      * `manage_tokens` org permission.
      *
      * @param orgTokenId - Numeric token id.

package/dist/domains/quotas.d.ts

@@ -47,7 +47,7 @@ export declare class QuotasAPI {
      * Create or update a quota at an org or app scope. Requires `manage_quotas`
      * (super-admin for platform-global quotas).
      *
-     * @param input - {@link SetQuotaInput}: scope ids, `metric`, and `limit`.
+     * @param input - {@link SetQuotaInput}: scope ids, `metric`, and `limitValue`.
      * @returns The created/updated quota.
      */
     set(input: SetQuotaInput): Promise<SetQuotaMutation['setQuota']>;

package/dist/domains/quotas.js

@@ -57,7 +57,7 @@ export class QuotasAPI {
      * Create or update a quota at an org or app scope. Requires `manage_quotas`
      * (super-admin for platform-global quotas).
      *
-     * @param input - {@link SetQuotaInput}: scope ids, `metric`, and `limit`.
+     * @param input - {@link SetQuotaInput}: scope ids, `metric`, and `limitValue`.
      * @returns The created/updated quota.
      */
     async set(input) {

package/dist/domains/udp.d.ts

@@ -77,10 +77,13 @@ export declare class UdpAPI {
     /**
      * Send an actor (player/NPC) state update for spatial replication to nearby
      * chunks. Fire-and-forget; opens a UDP proxy session automatically if none
-     * exists. The applied echo (`ActorUpdateResponse`) and any failure
-     * (`GenericErrorResponse`) arrive asynchronously on {@link subscribe},
-     * correlated by `sequenceNumber`; use {@link sendActorUpdateAndWait} to await
-     * that echo inline.
+     * exists. There is no separate per-request response: the server fans the
+     * update out to every client in the target chunk **including the sender**, so
+     * your own applied update comes back as an `ActorUpdateNotification` carrying
+     * the same `sequenceNumber` (the legacy `ActorUpdateResponse` type is never
+     * emitted). Failures arrive as a `GenericErrorResponse`; both are delivered
+     * asynchronously on {@link subscribe} and correlated by `sequenceNumber`. Use
+     * {@link sendActorUpdateAndWait} to await that self-notification inline.
      *
      * @param input - {@link ActorUpdateRequestInput}:
      *   - `appId` — owning app id (`BigInt` as a decimal string).
@@ -106,17 +109,19 @@ export declare class UdpAPI {
     /**
      * Send an actor update and wait for the server's applied echo. Allocates a
      * `sequenceNumber` when `input.sequenceNumber` is omitted, registers the wait
-     * *before* sending, then resolves with the matching `ActorUpdateResponse`.
-     * Requires an active {@link subscribe} so the echo can be delivered over the
-     * shared WebSocket.
+     * *before* sending, then resolves with the matching notification. Because the
+     * server includes the sender in the chunk fan-out, the echo is your own
+     * `ActorUpdateNotification` with the same `sequenceNumber` (there is no
+     * `ActorUpdateResponse` on the wire). Requires an active {@link subscribe} so
+     * the self-notification can be delivered over the shared WebSocket.
      *
      * @param input - {@link ActorUpdateRequestInput} (see {@link sendActorUpdate}
      *   for field units/encoding). Omit `sequenceNumber` to let the SDK allocate
      *   one.
      * @param options - `timeoutMs`: how long to wait for the echo, in
      *   milliseconds; defaults to the client's realtime `waitTimeoutMs` (5000).
-     * @returns The correlated {@link SpatialNotification} (the `ActorUpdateResponse`
-     *   echo).
+     * @returns The correlated {@link SpatialNotification} (your own
+     *   `ActorUpdateNotification` self-echo).
      * @throws {CrowdyGraphQLError} if the underlying send is rejected.
      * @throws {CrowdyTimeoutError} if the HTTP send leg exceeds the client's
      *   request timeout.
@@ -141,10 +146,13 @@ export declare class UdpAPI {
     }): Promise<SpatialNotification>;
     /**
      * Send a single voxel (block) update for spatial replication to nearby
-     * chunks. Fire-and-forget; opens a UDP proxy session automatically. The
-     * applied echo (`VoxelUpdateResponse`) and failures (`GenericErrorResponse`)
-     * arrive asynchronously on {@link subscribe}; use
-     * {@link sendVoxelUpdateAndWait} to await the echo inline.
+     * chunks. Fire-and-forget; opens a UDP proxy session automatically. There is
+     * no separate per-request response: the change fans out to nearby clients
+     * **including the sender** as a `VoxelUpdateNotification` carrying the same
+     * `sequenceNumber` (the legacy `VoxelUpdateResponse` type is never emitted).
+     * Failures arrive as a `GenericErrorResponse`; both are delivered
+     * asynchronously on {@link subscribe}. Use {@link sendVoxelUpdateAndWait} to
+     * await the self-notification inline.
      *
      * @param input - {@link VoxelUpdateRequestInput}:
      *   - `appId` — owning app id (`BigInt` as a decimal string).
@@ -166,15 +174,18 @@ export declare class UdpAPI {
      */
     sendVoxelUpdate(input: SendVoxelUpdateMutationVariables['input']): Promise<boolean>;
     /**
-     * Send a voxel update and wait for the server's applied `VoxelUpdateResponse`
-     * echo. Allocates a `sequenceNumber` when omitted and requires an active
-     * {@link subscribe}.
+     * Send a voxel update and wait for the server's applied echo. Allocates a
+     * `sequenceNumber` when omitted and requires an active {@link subscribe}.
+     * Because the server includes the sender in the chunk fan-out, the echo is
+     * your own `VoxelUpdateNotification` with the same `sequenceNumber` (there is
+     * no `VoxelUpdateResponse` on the wire).
      *
      * @param input - {@link VoxelUpdateRequestInput} (see {@link sendVoxelUpdate}
      *   for field units/encoding).
      * @param options - `timeoutMs`: echo wait in milliseconds; defaults to the
      *   client's realtime `waitTimeoutMs` (5000).
-     * @returns The correlated {@link SpatialNotification} (`VoxelUpdateResponse`).
+     * @returns The correlated {@link SpatialNotification} (your own
+     *   `VoxelUpdateNotification` self-echo).
      * @throws {CrowdyGraphQLError} if the underlying send is rejected.
      * @throws {CrowdyTimeoutError} if the HTTP send leg times out.
      * @throws {CrowdyRealtimeError} on echo timeout

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

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

package/dist/domains/udp.js

@@ -85,10 +85,13 @@ export class UdpAPI {
     /**
      * Send an actor (player/NPC) state update for spatial replication to nearby
      * chunks. Fire-and-forget; opens a UDP proxy session automatically if none
-     * exists. The applied echo (`ActorUpdateResponse`) and any failure
-     * (`GenericErrorResponse`) arrive asynchronously on {@link subscribe},
-     * correlated by `sequenceNumber`; use {@link sendActorUpdateAndWait} to await
-     * that echo inline.
+     * exists. There is no separate per-request response: the server fans the
+     * update out to every client in the target chunk **including the sender**, so
+     * your own applied update comes back as an `ActorUpdateNotification` carrying
+     * the same `sequenceNumber` (the legacy `ActorUpdateResponse` type is never
+     * emitted). Failures arrive as a `GenericErrorResponse`; both are delivered
+     * asynchronously on {@link subscribe} and correlated by `sequenceNumber`. Use
+     * {@link sendActorUpdateAndWait} to await that self-notification inline.
      *
      * @param input - {@link ActorUpdateRequestInput}:
      *   - `appId` — owning app id (`BigInt` as a decimal string).
@@ -117,17 +120,19 @@ export class UdpAPI {
     /**
      * Send an actor update and wait for the server's applied echo. Allocates a
      * `sequenceNumber` when `input.sequenceNumber` is omitted, registers the wait
-     * *before* sending, then resolves with the matching `ActorUpdateResponse`.
-     * Requires an active {@link subscribe} so the echo can be delivered over the
-     * shared WebSocket.
+     * *before* sending, then resolves with the matching notification. Because the
+     * server includes the sender in the chunk fan-out, the echo is your own
+     * `ActorUpdateNotification` with the same `sequenceNumber` (there is no
+     * `ActorUpdateResponse` on the wire). Requires an active {@link subscribe} so
+     * the self-notification can be delivered over the shared WebSocket.
      *
      * @param input - {@link ActorUpdateRequestInput} (see {@link sendActorUpdate}
      *   for field units/encoding). Omit `sequenceNumber` to let the SDK allocate
      *   one.
      * @param options - `timeoutMs`: how long to wait for the echo, in
      *   milliseconds; defaults to the client's realtime `waitTimeoutMs` (5000).
-     * @returns The correlated {@link SpatialNotification} (the `ActorUpdateResponse`
-     *   echo).
+     * @returns The correlated {@link SpatialNotification} (your own
+     *   `ActorUpdateNotification` self-echo).
      * @throws {CrowdyGraphQLError} if the underlying send is rejected.
      * @throws {CrowdyTimeoutError} if the HTTP send leg exceeds the client's
      *   request timeout.
@@ -155,10 +160,13 @@ export class UdpAPI {
     }
     /**
      * Send a single voxel (block) update for spatial replication to nearby
-     * chunks. Fire-and-forget; opens a UDP proxy session automatically. The
-     * applied echo (`VoxelUpdateResponse`) and failures (`GenericErrorResponse`)
-     * arrive asynchronously on {@link subscribe}; use
-     * {@link sendVoxelUpdateAndWait} to await the echo inline.
+     * chunks. Fire-and-forget; opens a UDP proxy session automatically. There is
+     * no separate per-request response: the change fans out to nearby clients
+     * **including the sender** as a `VoxelUpdateNotification` carrying the same
+     * `sequenceNumber` (the legacy `VoxelUpdateResponse` type is never emitted).
+     * Failures arrive as a `GenericErrorResponse`; both are delivered
+     * asynchronously on {@link subscribe}. Use {@link sendVoxelUpdateAndWait} to
+     * await the self-notification inline.
      *
      * @param input - {@link VoxelUpdateRequestInput}:
      *   - `appId` — owning app id (`BigInt` as a decimal string).
@@ -183,15 +191,18 @@ export class UdpAPI {
         return data.sendVoxelUpdate;
     }
     /**
-     * Send a voxel update and wait for the server's applied `VoxelUpdateResponse`
-     * echo. Allocates a `sequenceNumber` when omitted and requires an active
-     * {@link subscribe}.
+     * Send a voxel update and wait for the server's applied echo. Allocates a
+     * `sequenceNumber` when omitted and requires an active {@link subscribe}.
+     * Because the server includes the sender in the chunk fan-out, the echo is
+     * your own `VoxelUpdateNotification` with the same `sequenceNumber` (there is
+     * no `VoxelUpdateResponse` on the wire).
      *
      * @param input - {@link VoxelUpdateRequestInput} (see {@link sendVoxelUpdate}
      *   for field units/encoding).
      * @param options - `timeoutMs`: echo wait in milliseconds; defaults to the
      *   client's realtime `waitTimeoutMs` (5000).
-     * @returns The correlated {@link SpatialNotification} (`VoxelUpdateResponse`).
+     * @returns The correlated {@link SpatialNotification} (your own
+     *   `VoxelUpdateNotification` self-echo).
      * @throws {CrowdyGraphQLError} if the underlying send is rejected.
      * @throws {CrowdyTimeoutError} if the HTTP send leg times out.
      * @throws {CrowdyRealtimeError} on echo timeout