@crowdedkingdomstudios/crowdyjs 5.0.0 → 5.1.0

package/MIGRATION.md

@@ -1,3 +1,34 @@
+# CrowdyJS v5.1 Notes
+
+v5.1 is additive and non-breaking.
+
+## Added
+
+- **`client.teams`** — the Teams API is now a first-class sub-client, mirroring
+  `client.channels`. Create / update / delete teams, manage membership and
+  roles, set the per-app team policy, and read `mine` (`myTeams`), `list`
+  (`teams`), `get`, `members`, `roles`, and `policy`. Teams are app-scoped
+  player groups with roles and delegated management (no realtime messaging
+  path — that is Channels).
+
+  ```ts
+  const team = await client.teams.create({ appId: '1', name: 'Red Squad' });
+  await client.teams.join(team.groupId);
+  const mine = await client.teams.mine('1');
+  ```
+
+## Removed
+
+- The `gameModelEventStream` GraphQL subscription has been removed from the Game
+  API and the bundled schema. It was never wrapped by a CrowdyJS method, so no
+  SDK call sites change. To react to game-model changes, have the mutating
+  client send a lightweight notification over the realtime UDP path — a channel
+  message (`client.udp.sendChannelMessage`, recommended) or a spatial client
+  event (`client.udp.sendClientEvent`) — and have peers re-pull authoritative
+  state via `client.gameModel.containerState(...)` / `client.gameModel.events(...)`.
+
+---
+
 # CrowdyJS v5 Migration Notes
 
 CrowdyJS v5 makes the realtime subscription **app-scoped** to fix a cross-app

package/README.md

@@ -65,7 +65,7 @@ Auth and user reads always target `managementUrl`. Everything else targets `http
 ## Game-loop lifecycle
 
 1. Authenticate with `client.auth.login()` or restore a previous token through `client.session.restore()`.
-2. Subscribe to UDP proxy notifications with `client.udp.subscribe()` (the SDK will open the realtime socket on demand).
+2. Subscribe to UDP proxy notifications with `client.udp.subscribe(handlers, appId)` — `appId` is **required** (the SDK opens the realtime socket on demand and scopes it to that app).
 3. Join a chunk by sending an initial actor update.
 4. Send actor, voxel, text, audio, and client-event updates through `client.udp` or the higher-level `client.world(appId)` helpers.
 5. Call `client.udp.disconnect()` when leaving the world.
@@ -76,43 +76,63 @@ Auth and user reads always target `managementUrl`. Everything else targets `http
 When a player is about to join an app, query its routing fields on the management API first:
 
 ```graphql
-query AppForRouting($id: BigInt!) {
-  app(id: $id) {
+query AppForRouting($appId: BigInt!) {
+  app(appId: $appId) {
     appId
     splitMode
+    deploymentTarget
     gameApiUrl
   }
 }
 ```
 
-If `splitMode && gameApiUrl`, the app lives behind its own Game API deployment. Build a **second** `CrowdyClient` with `httpUrl: gameApiUrl` (and the matching `wsUrl`) **sharing the same `tokenStore` as the first client**, then drive gameplay through that client. Apps without `splitMode` keep working against the default `httpUrl` you configured.
+`gameApiUrl` is populated for **both** dedicated (`splitMode`) and shared
+(`deploymentTarget: "shared"`) apps. When it's set, build a **second**
+`CrowdyClient` with `httpUrl: gameApiUrl` (and the matching `wsUrl`) **sharing the
+same `tokenStore` as the first client**, then drive gameplay through that client.
+Apps with no `gameApiUrl` keep working against the default `httpUrl` you
+configured.
 
 ## Realtime notifications
 
+`subscribe` takes the handlers **and a required `appId`** (second argument). The
+Game API scopes the realtime session to that app and rejects an app-agnostic
+subscription with a `RealtimeConnectionEvent` (`code: 'APP_ID_REQUIRED'`). Run
+one client per app (sharing the same `tokenStore`) when a player is in multiple
+apps at once.
+
 ```ts
-const unsubscribe = client.udp.subscribe({
-  actorUpdate: (event) => {
-    console.log(event.uuid, event.state);
-  },
-  voxelUpdate: (event) => { /* ... */ },
-  text: (event) => { /* ... */ },
-  audio: (event) => { /* ... */ },
-  clientEvent: (event) => { /* ... */ },
-  serverEvent: (event) => { /* ... */ },
-  singleActorMessage: (event) => {
-    // A direct actor-to-actor message addressed to you.
-    console.log(event.uuid, event.payload); // payload is base64
-  },
-  genericError: (event) => {
-    console.warn(event.sequenceNumber, event.errorCode);
-  },
-  connectionEvent: (event) => {
-    console.warn(event.code, event.message);
+const appId = '1';
+
+const unsubscribe = client.udp.subscribe(
+  {
+    actorUpdate: (event) => {
+      console.log(event.uuid, event.state);
+    },
+    voxelUpdate: (event) => { /* ... */ },
+    text: (event) => { /* ... */ },
+    audio: (event) => { /* ... */ },
+    clientEvent: (event) => { /* ... */ },
+    serverEvent: (event) => { /* ... */ },
+    singleActorMessage: (event) => {
+      // A direct actor-to-actor message addressed to you.
+      console.log(event.uuid, event.payload); // payload is base64
+    },
+    genericError: (event) => {
+      console.warn(event.sequenceNumber, event.errorCode);
+    },
+    connectionEvent: (event) => {
+      console.warn(event.code, event.message);
+    },
+    error: (error) => {
+      console.error(error.code, error.message);
+    },
   },
-  error: (error) => {
-    console.error(error.code, error.message);
-  },
-});
+  appId,
+);
+
+// Or use the world helper, which passes its appId automatically:
+//   client.world(appId).subscribe(handlers);
 
 client.realtime.onStatus((status) => {
   console.log('realtime:', status);

package/dist/crowdy-client.d.ts

@@ -37,6 +37,7 @@ import { TeleportAPI } from './domains/teleport.js';
 import { StateAPI } from './domains/state.js';
 import { ServerStatusAPI } from './domains/serverStatus.js';
 import { ChannelsAPI } from './domains/channels.js';
+import { TeamsAPI } from './domains/teams.js';
 import { UdpAPI } from './domains/udp.js';
 import { GameModelAPI } from './domains/gameModel.js';
 export interface CrowdyClientConfig {
@@ -89,6 +90,8 @@ export declare class CrowdyClient {
     readonly state: StateAPI;
     readonly serverStatus: ServerStatusAPI;
     readonly channels: ChannelsAPI;
+    /** Teams: app-scoped player groups with roles and delegated management. */
+    readonly teams: TeamsAPI;
     readonly udp: UdpAPI;
     /** Abstract game model: containers, properties, functions, sessions. */
     readonly gameModel: GameModelAPI;

package/dist/crowdy-client.d.ts.map

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

package/dist/crowdy-client.js

@@ -35,6 +35,7 @@ import { TeleportAPI } from './domains/teleport.js';
 import { StateAPI } from './domains/state.js';
 import { ServerStatusAPI } from './domains/serverStatus.js';
 import { ChannelsAPI } from './domains/channels.js';
+import { TeamsAPI } from './domains/teams.js';
 import { UdpAPI } from './domains/udp.js';
 import { GameModelAPI } from './domains/gameModel.js';
 export class CrowdyClient {
@@ -75,6 +76,7 @@ export class CrowdyClient {
         this.state = new StateAPI(this.graphql);
         this.serverStatus = new ServerStatusAPI(this.graphql);
         this.channels = new ChannelsAPI(this.graphql);
+        this.teams = new TeamsAPI(this.graphql);
         this.udp = new UdpAPI(this.graphql, this.realtime);
         this.gameModel = new GameModelAPI(this.graphql);
     }

package/dist/domains/teams.d.ts

@@ -0,0 +1,34 @@
+import type { GraphQLClient } from '../client.js';
+import { type MyTeamsQuery, type MyTeamsQueryVariables, type TeamsQuery, type TeamsQueryVariables, type TeamQuery, type TeamQueryVariables, type TeamMembersQuery, type TeamMembersQueryVariables, type TeamRolesQuery, type TeamRolesQueryVariables, type TeamPolicyQuery, type TeamPolicyQueryVariables, type SetTeamPolicyMutation, type SetTeamPolicyMutationVariables, type CreateTeamMutation, type CreateTeamMutationVariables, type UpdateTeamMutation, type UpdateTeamMutationVariables, type DeleteTeamMutationVariables, type JoinTeamMutation, type JoinTeamMutationVariables, type RequestToJoinTeamMutation, type RequestToJoinTeamMutationVariables, type LeaveTeamMutationVariables, type AddTeamMemberMutation, type AddTeamMemberMutationVariables, type RemoveTeamMemberMutationVariables, type SetTeamMemberRolesMutation, type SetTeamMemberRolesMutationVariables, type CreateTeamRoleMutation, type CreateTeamRoleMutationVariables, type UpdateTeamRoleMutation, type UpdateTeamRoleMutationVariables, type DeleteTeamRoleMutationVariables } from '../generated/graphql.js';
+/**
+ * Teams: app-scoped player groups with roles and delegated management, built
+ * on the same generic groups subsystem as Channels (group_type='team'). Team
+ * CRUD, membership, and roles run over the game-api GraphQL endpoint. Unlike
+ * channels, teams have no realtime messaging path.
+ *
+ * Exposed as `client.teams`.
+ */
+export declare class TeamsAPI {
+    private gql;
+    constructor(gql: GraphQLClient);
+    mine(appId: MyTeamsQueryVariables['appId']): Promise<MyTeamsQuery['myTeams']>;
+    list(appId: TeamsQueryVariables['appId']): Promise<TeamsQuery['teams']>;
+    get(groupId: TeamQueryVariables['groupId']): Promise<TeamQuery['team']>;
+    members(groupId: TeamMembersQueryVariables['groupId']): Promise<TeamMembersQuery['teamMembers']>;
+    roles(groupId: TeamRolesQueryVariables['groupId']): Promise<TeamRolesQuery['teamRoles']>;
+    policy(appId: TeamPolicyQueryVariables['appId']): Promise<TeamPolicyQuery['teamPolicy']>;
+    create(input: CreateTeamMutationVariables['input']): Promise<CreateTeamMutation['createTeam']>;
+    update(input: UpdateTeamMutationVariables['input']): Promise<UpdateTeamMutation['updateTeam']>;
+    remove(groupId: DeleteTeamMutationVariables['groupId']): Promise<boolean>;
+    setPolicy(input: SetTeamPolicyMutationVariables['input']): Promise<SetTeamPolicyMutation['setTeamPolicy']>;
+    join(groupId: JoinTeamMutationVariables['groupId']): Promise<JoinTeamMutation['joinTeam']>;
+    requestToJoin(groupId: RequestToJoinTeamMutationVariables['groupId']): Promise<RequestToJoinTeamMutation['requestToJoinTeam']>;
+    leave(groupId: LeaveTeamMutationVariables['groupId']): Promise<boolean>;
+    addMember(groupId: AddTeamMemberMutationVariables['groupId'], userId: AddTeamMemberMutationVariables['userId']): Promise<AddTeamMemberMutation['addTeamMember']>;
+    removeMember(groupId: RemoveTeamMemberMutationVariables['groupId'], userId: RemoveTeamMemberMutationVariables['userId']): Promise<boolean>;
+    setMemberRoles(input: SetTeamMemberRolesMutationVariables['input']): Promise<SetTeamMemberRolesMutation['setTeamMemberRoles']>;
+    createRole(input: CreateTeamRoleMutationVariables['input']): Promise<CreateTeamRoleMutation['createTeamRole']>;
+    updateRole(input: UpdateTeamRoleMutationVariables['input']): Promise<UpdateTeamRoleMutation['updateTeamRole']>;
+    deleteRole(groupRoleId: DeleteTeamRoleMutationVariables['groupRoleId']): Promise<boolean>;
+}
+//# sourceMappingURL=teams.d.ts.map

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

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

package/dist/domains/teams.js

@@ -0,0 +1,94 @@
+import { MyTeamsDocument, TeamsDocument, TeamDocument, TeamMembersDocument, TeamRolesDocument, TeamPolicyDocument, SetTeamPolicyDocument, CreateTeamDocument, UpdateTeamDocument, DeleteTeamDocument, JoinTeamDocument, RequestToJoinTeamDocument, LeaveTeamDocument, AddTeamMemberDocument, RemoveTeamMemberDocument, SetTeamMemberRolesDocument, CreateTeamRoleDocument, UpdateTeamRoleDocument, DeleteTeamRoleDocument, } from '../generated/graphql.js';
+/**
+ * Teams: app-scoped player groups with roles and delegated management, built
+ * on the same generic groups subsystem as Channels (group_type='team'). Team
+ * CRUD, membership, and roles run over the game-api GraphQL endpoint. Unlike
+ * channels, teams have no realtime messaging path.
+ *
+ * Exposed as `client.teams`.
+ */
+export class TeamsAPI {
+    constructor(gql) {
+        this.gql = gql;
+    }
+    // -- Queries --------------------------------------------------------------
+    async mine(appId) {
+        const data = await this.gql.request(MyTeamsDocument, { appId });
+        return data.myTeams;
+    }
+    async list(appId) {
+        const data = await this.gql.request(TeamsDocument, { appId });
+        return data.teams;
+    }
+    async get(groupId) {
+        const data = await this.gql.request(TeamDocument, { groupId });
+        return data.team;
+    }
+    async members(groupId) {
+        const data = await this.gql.request(TeamMembersDocument, { groupId });
+        return data.teamMembers;
+    }
+    async roles(groupId) {
+        const data = await this.gql.request(TeamRolesDocument, { groupId });
+        return data.teamRoles;
+    }
+    async policy(appId) {
+        const data = await this.gql.request(TeamPolicyDocument, { appId });
+        return data.teamPolicy;
+    }
+    // -- Team mutations -------------------------------------------------------
+    async create(input) {
+        const data = await this.gql.request(CreateTeamDocument, { input });
+        return data.createTeam;
+    }
+    async update(input) {
+        const data = await this.gql.request(UpdateTeamDocument, { input });
+        return data.updateTeam;
+    }
+    async remove(groupId) {
+        const data = await this.gql.request(DeleteTeamDocument, { groupId });
+        return data.deleteTeam;
+    }
+    async setPolicy(input) {
+        const data = await this.gql.request(SetTeamPolicyDocument, { input });
+        return data.setTeamPolicy;
+    }
+    // -- Membership mutations -------------------------------------------------
+    async join(groupId) {
+        const data = await this.gql.request(JoinTeamDocument, { groupId });
+        return data.joinTeam;
+    }
+    async requestToJoin(groupId) {
+        const data = await this.gql.request(RequestToJoinTeamDocument, { groupId });
+        return data.requestToJoinTeam;
+    }
+    async leave(groupId) {
+        const data = await this.gql.request(LeaveTeamDocument, { groupId });
+        return data.leaveTeam;
+    }
+    async addMember(groupId, userId) {
+        const data = await this.gql.request(AddTeamMemberDocument, { groupId, userId });
+        return data.addTeamMember;
+    }
+    async removeMember(groupId, userId) {
+        const data = await this.gql.request(RemoveTeamMemberDocument, { groupId, userId });
+        return data.removeTeamMember;
+    }
+    async setMemberRoles(input) {
+        const data = await this.gql.request(SetTeamMemberRolesDocument, { input });
+        return data.setTeamMemberRoles;
+    }
+    // -- Role mutations -------------------------------------------------------
+    async createRole(input) {
+        const data = await this.gql.request(CreateTeamRoleDocument, { input });
+        return data.createTeamRole;
+    }
+    async updateRole(input) {
+        const data = await this.gql.request(UpdateTeamRoleDocument, { input });
+        return data.updateTeamRole;
+    }
+    async deleteRole(groupRoleId) {
+        const data = await this.gql.request(DeleteTeamRoleDocument, { groupRoleId });
+        return data.deleteTeamRole;
+    }
+}