@crowdedkingdomstudios/crowdyjs 5.0.1 → 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/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":"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,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,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;gBAErB,MAAM,GAAE,kBAAuB;IAyD3C,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

@@ -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;
+    }
+}

package/dist/generated/graphql.d.ts

@@ -3345,15 +3345,9 @@ export type SingleActorMessageNotification = {
 };
 export type Subscription = {
     __typename?: 'Subscription';
-    /** Realtime stream of successful function-invocation events for an app, optionally narrowed to one session. Backed by Postgres NOTIFY so it fans out across game-api replicas without Buddy. Poll gameModelEvents if you prefer pull-based delivery. */
-    gameModelEventStream: Maybe<GmEvent>;
     /** Downlink from the game server (responses, notifications, GenericErrorResponse, and RealtimeConnectionEvent). On subscribe, opens a UDP proxy session if none exists (least-loaded server). Connection failures are delivered as RealtimeConnectionEvent. Unsubscribing stops delivery only; call disconnectUdpProxy to release the session. */
     udpNotifications: Maybe<UdpNotification>;
 };
-export type SubscriptionGameModelEventStreamArgs = {
-    appId: Scalars['BigInt']['input'];
-    sessionId?: InputMaybe<Scalars['String']['input']>;
-};
 export type TeleportRequestInput = {
     appId: Scalars['BigInt']['input'];
     chunkAddress: ChunkCoordinatesInput;
@@ -6139,6 +6133,332 @@ export type UserAppStatesQuery = {
         updatedAt: string;
     }>;
 };
+export type AddTeamMemberMutationVariables = Exact<{
+    groupId: Scalars['BigInt']['input'];
+    userId: Scalars['BigInt']['input'];
+}>;
+export type AddTeamMemberMutation = {
+    __typename?: 'Mutation';
+    addTeamMember: {
+        __typename?: 'GroupMember';
+        groupMemberId: string;
+        groupId: string;
+        userId: string;
+        status: string;
+        createdAt: string;
+        roles: Array<{
+            __typename?: 'GroupRole';
+            groupRoleId: string;
+            roleName: string;
+            rank: number;
+            isSystem: boolean;
+            permissions: Array<string>;
+        }>;
+    };
+};
+export type CreateTeamMutationVariables = Exact<{
+    input: CreateTeamInput;
+}>;
+export type CreateTeamMutation = {
+    __typename?: 'Mutation';
+    createTeam: {
+        __typename?: 'Group';
+        groupId: string;
+        appId: string;
+        groupType: string;
+        name: string;
+        description: string | null;
+        ownerUserId: string | null;
+        membershipPolicy: string;
+        status: string;
+        defaultRoleId: string | null;
+        createdAt: string;
+    };
+};
+export type CreateTeamRoleMutationVariables = Exact<{
+    input: CreateGroupRoleInput;
+}>;
+export type CreateTeamRoleMutation = {
+    __typename?: 'Mutation';
+    createTeamRole: {
+        __typename?: 'GroupRole';
+        groupRoleId: string;
+        groupId: string;
+        roleName: string;
+        rank: number;
+        isSystem: boolean;
+        permissions: Array<string>;
+        createdAt: string;
+    };
+};
+export type DeleteTeamMutationVariables = Exact<{
+    groupId: Scalars['BigInt']['input'];
+}>;
+export type DeleteTeamMutation = {
+    __typename?: 'Mutation';
+    deleteTeam: boolean;
+};
+export type DeleteTeamRoleMutationVariables = Exact<{
+    groupRoleId: Scalars['BigInt']['input'];
+}>;
+export type DeleteTeamRoleMutation = {
+    __typename?: 'Mutation';
+    deleteTeamRole: boolean;
+};
+export type JoinTeamMutationVariables = Exact<{
+    groupId: Scalars['BigInt']['input'];
+}>;
+export type JoinTeamMutation = {
+    __typename?: 'Mutation';
+    joinTeam: {
+        __typename?: 'GroupMember';
+        groupMemberId: string;
+        groupId: string;
+        userId: string;
+        status: string;
+        createdAt: string;
+        roles: Array<{
+            __typename?: 'GroupRole';
+            groupRoleId: string;
+            roleName: string;
+            rank: number;
+            isSystem: boolean;
+            permissions: Array<string>;
+        }>;
+    };
+};
+export type LeaveTeamMutationVariables = Exact<{
+    groupId: Scalars['BigInt']['input'];
+}>;
+export type LeaveTeamMutation = {
+    __typename?: 'Mutation';
+    leaveTeam: boolean;
+};
+export type MyTeamsQueryVariables = Exact<{
+    appId: Scalars['BigInt']['input'];
+}>;
+export type MyTeamsQuery = {
+    __typename?: 'Query';
+    myTeams: Array<{
+        __typename?: 'GroupMembership';
+        permissions: Array<string>;
+        joinedAt: string;
+        group: {
+            __typename?: 'Group';
+            groupId: string;
+            appId: string;
+            groupType: string;
+            name: string;
+            description: string | null;
+            ownerUserId: string | null;
+            membershipPolicy: string;
+            status: string;
+            defaultRoleId: string | null;
+            createdAt: string;
+        };
+        roles: Array<{
+            __typename?: 'GroupRole';
+            groupRoleId: string;
+            roleName: string;
+            rank: number;
+            isSystem: boolean;
+            permissions: Array<string>;
+        }>;
+    }>;
+};
+export type RemoveTeamMemberMutationVariables = Exact<{
+    groupId: Scalars['BigInt']['input'];
+    userId: Scalars['BigInt']['input'];
+}>;
+export type RemoveTeamMemberMutation = {
+    __typename?: 'Mutation';
+    removeTeamMember: boolean;
+};
+export type RequestToJoinTeamMutationVariables = Exact<{
+    groupId: Scalars['BigInt']['input'];
+}>;
+export type RequestToJoinTeamMutation = {
+    __typename?: 'Mutation';
+    requestToJoinTeam: {
+        __typename?: 'GroupMember';
+        groupMemberId: string;
+        groupId: string;
+        userId: string;
+        status: string;
+        createdAt: string;
+        roles: Array<{
+            __typename?: 'GroupRole';
+            groupRoleId: string;
+            roleName: string;
+            rank: number;
+            isSystem: boolean;
+            permissions: Array<string>;
+        }>;
+    };
+};
+export type SetTeamMemberRolesMutationVariables = Exact<{
+    input: SetMemberRolesInput;
+}>;
+export type SetTeamMemberRolesMutation = {
+    __typename?: 'Mutation';
+    setTeamMemberRoles: {
+        __typename?: 'GroupMember';
+        groupMemberId: string;
+        groupId: string;
+        userId: string;
+        status: string;
+        createdAt: string;
+        roles: Array<{
+            __typename?: 'GroupRole';
+            groupRoleId: string;
+            roleName: string;
+            rank: number;
+            isSystem: boolean;
+            permissions: Array<string>;
+        }>;
+    };
+};
+export type SetTeamPolicyMutationVariables = Exact<{
+    input: SetTeamPolicyInput;
+}>;
+export type SetTeamPolicyMutation = {
+    __typename?: 'Mutation';
+    setTeamPolicy: {
+        __typename?: 'AppGroupPolicy';
+        appId: string;
+        groupType: string;
+        creationPolicy: string;
+        defaultMembershipPolicy: string;
+        maxMembers: number | null;
+        maxGroupsPerUser: number | null;
+    };
+};
+export type TeamQueryVariables = Exact<{
+    groupId: Scalars['BigInt']['input'];
+}>;
+export type TeamQuery = {
+    __typename?: 'Query';
+    team: {
+        __typename?: 'Group';
+        groupId: string;
+        appId: string;
+        groupType: string;
+        name: string;
+        description: string | null;
+        ownerUserId: string | null;
+        membershipPolicy: string;
+        status: string;
+        defaultRoleId: string | null;
+        createdAt: string;
+    };
+};
+export type TeamMembersQueryVariables = Exact<{
+    groupId: Scalars['BigInt']['input'];
+}>;
+export type TeamMembersQuery = {
+    __typename?: 'Query';
+    teamMembers: Array<{
+        __typename?: 'GroupMember';
+        groupMemberId: string;
+        groupId: string;
+        userId: string;
+        status: string;
+        createdAt: string;
+        roles: Array<{
+            __typename?: 'GroupRole';
+            groupRoleId: string;
+            roleName: string;
+            rank: number;
+            isSystem: boolean;
+            permissions: Array<string>;
+        }>;
+    }>;
+};
+export type TeamPolicyQueryVariables = Exact<{
+    appId: Scalars['BigInt']['input'];
+}>;
+export type TeamPolicyQuery = {
+    __typename?: 'Query';
+    teamPolicy: {
+        __typename?: 'AppGroupPolicy';
+        appId: string;
+        groupType: string;
+        creationPolicy: string;
+        defaultMembershipPolicy: string;
+        maxMembers: number | null;
+        maxGroupsPerUser: number | null;
+    };
+};
+export type TeamRolesQueryVariables = Exact<{
+    groupId: Scalars['BigInt']['input'];
+}>;
+export type TeamRolesQuery = {
+    __typename?: 'Query';
+    teamRoles: Array<{
+        __typename?: 'GroupRole';
+        groupRoleId: string;
+        groupId: string;
+        roleName: string;
+        rank: number;
+        isSystem: boolean;
+        permissions: Array<string>;
+        createdAt: string;
+    }>;
+};
+export type TeamsQueryVariables = Exact<{
+    appId: Scalars['BigInt']['input'];
+}>;
+export type TeamsQuery = {
+    __typename?: 'Query';
+    teams: Array<{
+        __typename?: 'Group';
+        groupId: string;
+        appId: string;
+        groupType: string;
+        name: string;
+        description: string | null;
+        ownerUserId: string | null;
+        membershipPolicy: string;
+        status: string;
+        defaultRoleId: string | null;
+        createdAt: string;
+    }>;
+};
+export type UpdateTeamMutationVariables = Exact<{
+    input: UpdateTeamInput;
+}>;
+export type UpdateTeamMutation = {
+    __typename?: 'Mutation';
+    updateTeam: {
+        __typename?: 'Group';
+        groupId: string;
+        appId: string;
+        groupType: string;
+        name: string;
+        description: string | null;
+        ownerUserId: string | null;
+        membershipPolicy: string;
+        status: string;
+        defaultRoleId: string | null;
+        createdAt: string;
+    };
+};
+export type UpdateTeamRoleMutationVariables = Exact<{
+    input: UpdateGroupRoleInput;
+}>;
+export type UpdateTeamRoleMutation = {
+    __typename?: 'Mutation';
+    updateTeamRole: {
+        __typename?: 'GroupRole';
+        groupRoleId: string;
+        groupId: string;
+        roleName: string;
+        rank: number;
+        isSystem: boolean;
+        permissions: Array<string>;
+        createdAt: string;
+    };
+};
 export type TeleportRequestMutationVariables = Exact<{
     input: TeleportRequestInput;
 }>;
@@ -6799,6 +7119,25 @@ export declare const DeleteUserAppStateDocument: DocumentNode<DeleteUserAppState
 export declare const UpdateUserAppStateDocument: DocumentNode<UpdateUserAppStateMutation, UpdateUserAppStateMutationVariables>;
 export declare const UserAppStateDocument: DocumentNode<UserAppStateQuery, UserAppStateQueryVariables>;
 export declare const UserAppStatesDocument: DocumentNode<UserAppStatesQuery, UserAppStatesQueryVariables>;
+export declare const AddTeamMemberDocument: DocumentNode<AddTeamMemberMutation, AddTeamMemberMutationVariables>;
+export declare const CreateTeamDocument: DocumentNode<CreateTeamMutation, CreateTeamMutationVariables>;
+export declare const CreateTeamRoleDocument: DocumentNode<CreateTeamRoleMutation, CreateTeamRoleMutationVariables>;
+export declare const DeleteTeamDocument: DocumentNode<DeleteTeamMutation, DeleteTeamMutationVariables>;
+export declare const DeleteTeamRoleDocument: DocumentNode<DeleteTeamRoleMutation, DeleteTeamRoleMutationVariables>;
+export declare const JoinTeamDocument: DocumentNode<JoinTeamMutation, JoinTeamMutationVariables>;
+export declare const LeaveTeamDocument: DocumentNode<LeaveTeamMutation, LeaveTeamMutationVariables>;
+export declare const MyTeamsDocument: DocumentNode<MyTeamsQuery, MyTeamsQueryVariables>;
+export declare const RemoveTeamMemberDocument: DocumentNode<RemoveTeamMemberMutation, RemoveTeamMemberMutationVariables>;
+export declare const RequestToJoinTeamDocument: DocumentNode<RequestToJoinTeamMutation, RequestToJoinTeamMutationVariables>;
+export declare const SetTeamMemberRolesDocument: DocumentNode<SetTeamMemberRolesMutation, SetTeamMemberRolesMutationVariables>;
+export declare const SetTeamPolicyDocument: DocumentNode<SetTeamPolicyMutation, SetTeamPolicyMutationVariables>;
+export declare const TeamDocument: DocumentNode<TeamQuery, TeamQueryVariables>;
+export declare const TeamMembersDocument: DocumentNode<TeamMembersQuery, TeamMembersQueryVariables>;
+export declare const TeamPolicyDocument: DocumentNode<TeamPolicyQuery, TeamPolicyQueryVariables>;
+export declare const TeamRolesDocument: DocumentNode<TeamRolesQuery, TeamRolesQueryVariables>;
+export declare const TeamsDocument: DocumentNode<TeamsQuery, TeamsQueryVariables>;
+export declare const UpdateTeamDocument: DocumentNode<UpdateTeamMutation, UpdateTeamMutationVariables>;
+export declare const UpdateTeamRoleDocument: DocumentNode<UpdateTeamRoleMutation, UpdateTeamRoleMutationVariables>;
 export declare const TeleportRequestDocument: DocumentNode<TeleportRequestMutation, TeleportRequestMutationVariables>;
 export declare const ConnectUdpProxyDocument: DocumentNode<ConnectUdpProxyMutation, ConnectUdpProxyMutationVariables>;
 export declare const DisconnectUdpProxyDocument: DocumentNode<DisconnectUdpProxyMutation, DisconnectUdpProxyMutationVariables>;