Add player cluster + labeling mutation types

Schema additions for the per-video player labeling UI:
  * `PlayerClusterGQL` / `PlayerClusterShotGQL` — read shape.
  * `FinalizePlayerAssignmentsInput` + `ClusterAssignmentInput` +
    `ShotMoveInput` — write shape.
  * Query: `videoPlayerClusters(videoId)`.
  * Mutation: `finalizePlayerAssignments(input)`.

Generated by `just gql` from the backend type definitions in
`railbird/datatypes/gql/shooter.py` and resolvers in
`railbird/server/resolvers/shooter.py`.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

src/index.tsx

@@ -205,6 +205,11 @@ export enum ClientUploadStatusEnum {
   UploadEnabled = "UPLOAD_ENABLED",
 }
 
+export type ClusterAssignmentInput = {
+  clusterId: Scalars["Int"]["input"];
+  userId?: InputMaybe<Scalars["Int"]["input"]>;
+};
+
 export type CommentGql = {
   __typename?: "CommentGQL";
   id: Scalars["Int"]["output"];
@@ -224,6 +229,11 @@ export type CreateBucketSetInput = {
   keyName: Scalars["String"]["input"];
 };
 
+export type CreateCustomerPortalSessionResultGql = {
+  __typename?: "CreateCustomerPortalSessionResultGQL";
+  portalUrl: Scalars["String"]["output"];
+};
+
 export type CreateSubscriptionResultGql = {
   __typename?: "CreateSubscriptionResultGQL";
   checkoutUrl: Scalars["String"]["output"];
@@ -2177,6 +2187,12 @@ export type FilterInput =
       videoId: Array<Scalars["Int"]["input"]>;
     };
 
+export type FinalizePlayerAssignmentsInput = {
+  clusterAssignments?: Array<ClusterAssignmentInput>;
+  shotMoves?: Array<ShotMoveInput>;
+  videoId: Scalars["Int"]["input"];
+};
+
 export type FloatOrdering = {
   descending?: Scalars["Boolean"]["input"];
   startingAt?: InputMaybe<Scalars["Float"]["input"]>;
@@ -2373,6 +2389,7 @@ export type Mutation = {
   commentOnVideo: Scalars["Boolean"]["output"];
   createBucketSet: BucketSetGql;
   createChallenge: Challenge;
+  createCustomerPortalSession: CreateCustomerPortalSessionResultGql;
   createRuleSet: RuleSet;
   createSubscription: CreateSubscriptionResultGql;
   createUploadStream: CreateUploadStreamReturn;
@@ -2388,6 +2405,7 @@ export type Mutation = {
   editUploadStream: Scalars["Boolean"]["output"];
   editUser: UserGql;
   ensureStripeCustomerExists: UserGql;
+  finalizePlayerAssignments: Array<PlayerClusterGql>;
   findPrerecordTableLayout?: Maybe<HomographyInfoGql>;
   followUser: UserGql;
   getHlsInitUploadLink: GetUploadLinkReturn;
@@ -2511,6 +2529,10 @@ export type MutationEditUserArgs = {
   input: EditUserInputGql;
 };
 
+export type MutationFinalizePlayerAssignmentsArgs = {
+  input: FinalizePlayerAssignmentsInput;
+};
+
 export type MutationFindPrerecordTableLayoutArgs = {
   b64Image: Scalars["String"]["input"];
   videoId: Scalars["Int"]["input"];
@@ -2673,6 +2695,29 @@ export type PageInfoGql = {
   hasNextPage: Scalars["Boolean"]["output"];
 };
 
+export type PlayerClusterGql = {
+  __typename?: "PlayerClusterGQL";
+  clusterId: Scalars["Int"]["output"];
+  confirmed: Scalars["Boolean"]["output"];
+  nShots: Scalars["Int"]["output"];
+  shots: Array<PlayerClusterShotGql>;
+  userId?: Maybe<Scalars["Int"]["output"]>;
+  videoId: Scalars["Int"]["output"];
+};
+
+export type PlayerClusterShotGql = {
+  __typename?: "PlayerClusterShotGQL";
+  bboxX1: Scalars["Int"]["output"];
+  bboxX2: Scalars["Int"]["output"];
+  bboxY1: Scalars["Int"]["output"];
+  bboxY2: Scalars["Int"]["output"];
+  confidence: Scalars["Float"]["output"];
+  cropUrl?: Maybe<Scalars["String"]["output"]>;
+  fullFrameUrl?: Maybe<Scalars["String"]["output"]>;
+  isConfirmed: Scalars["Boolean"]["output"];
+  shotId: Scalars["Int"]["output"];
+};
+
 export enum PocketEnum {
   Corner = "CORNER",
   Side = "SIDE",
@@ -2783,6 +2828,7 @@ export type Query = {
   notifications: NotificationConnection;
   ruleSets: Array<RuleSet>;
   unreadNotificationCount: Scalars["Int"]["output"];
+  videoPlayerClusters: Array<PlayerClusterGql>;
   waitFor: Scalars["Float"]["output"];
 };
 
@@ -2949,6 +2995,10 @@ export type QueryNotificationsArgs = {
   offset?: Scalars["Int"]["input"];
 };
 
+export type QueryVideoPlayerClustersArgs = {
+  videoId: Scalars["Int"]["input"];
+};
+
 export type QueryWaitForArgs = {
   duration: Scalars["Float"]["input"];
 };
@@ -3166,6 +3216,11 @@ export type ShotGql = {
   videoId: Scalars["Int"]["output"];
 };
 
+export type ShotMoveInput = {
+  newClusterId: Scalars["Int"]["input"];
+  shotId: Scalars["Int"]["input"];
+};
+
 export type ShotsOrderingComponent =
   | {
       difficulty: FloatOrdering;
@@ -3264,6 +3319,7 @@ export type StripeProductGql = {
 export type StripeSubscriptionOptionsGql = {
   __typename?: "StripeSubscriptionOptionsGQL";
   products: Array<StripeProductGql>;
+  trialPeriodDays?: Maybe<Scalars["Int"]["output"]>;
 };
 
 export enum StripeSubscriptionStatusEnum {
@@ -5571,6 +5627,23 @@ export type GetUserTagsQuery = {
   }>;
 };
 
+export type GetGameTypeTagMetricsQueryVariables = Exact<{
+  input: GameTypeTagMetricsInput;
+}>;
+
+export type GetGameTypeTagMetricsQuery = {
+  __typename?: "Query";
+  getGameTypeTagMetrics: Array<{
+    __typename?: "GameTypeTagMetric";
+    tagName: string;
+    tagLabel: string;
+    tableSize?: number | null;
+    shotCount: number;
+    madeShots: number;
+    makeRate: number;
+  }>;
+};
+
 export type FollowUserMutationVariables = Exact<{
   followedUserId: Scalars["Int"]["input"];
 }>;
@@ -11554,6 +11627,84 @@ export type GetUserTagsQueryResult = Apollo.QueryResult<
   GetUserTagsQuery,
   GetUserTagsQueryVariables
 >;
+export const GetGameTypeTagMetricsDocument = gql`
+  query GetGameTypeTagMetrics($input: GameTypeTagMetricsInput!) {
+    getGameTypeTagMetrics(input: $input) {
+      tagName
+      tagLabel
+      tableSize
+      shotCount
+      madeShots
+      makeRate
+    }
+  }
+`;
+
+/**
+ * __useGetGameTypeTagMetricsQuery__
+ *
+ * To run a query within a React component, call `useGetGameTypeTagMetricsQuery` and pass it any options that fit your needs.
+ * When your component renders, `useGetGameTypeTagMetricsQuery` returns an object from Apollo Client that contains loading, error, and data properties
+ * you can use to render your UI.
+ *
+ * @param baseOptions options that will be passed into the query, supported options are listed on: https://www.apollographql.com/docs/react/api/react-hooks/#options;
+ *
+ * @example
+ * const { data, loading, error } = useGetGameTypeTagMetricsQuery({
+ *   variables: {
+ *      input: // value for 'input'
+ *   },
+ * });
+ */
+export function useGetGameTypeTagMetricsQuery(
+  baseOptions: Apollo.QueryHookOptions<
+    GetGameTypeTagMetricsQuery,
+    GetGameTypeTagMetricsQueryVariables
+  >,
+) {
+  const options = { ...defaultOptions, ...baseOptions };
+  return Apollo.useQuery<
+    GetGameTypeTagMetricsQuery,
+    GetGameTypeTagMetricsQueryVariables
+  >(GetGameTypeTagMetricsDocument, options);
+}
+export function useGetGameTypeTagMetricsLazyQuery(
+  baseOptions?: Apollo.LazyQueryHookOptions<
+    GetGameTypeTagMetricsQuery,
+    GetGameTypeTagMetricsQueryVariables
+  >,
+) {
+  const options = { ...defaultOptions, ...baseOptions };
+  return Apollo.useLazyQuery<
+    GetGameTypeTagMetricsQuery,
+    GetGameTypeTagMetricsQueryVariables
+  >(GetGameTypeTagMetricsDocument, options);
+}
+export function useGetGameTypeTagMetricsSuspenseQuery(
+  baseOptions?: Apollo.SuspenseQueryHookOptions<
+    GetGameTypeTagMetricsQuery,
+    GetGameTypeTagMetricsQueryVariables
+  >,
+) {
+  const options = { ...defaultOptions, ...baseOptions };
+  return Apollo.useSuspenseQuery<
+    GetGameTypeTagMetricsQuery,
+    GetGameTypeTagMetricsQueryVariables
+  >(GetGameTypeTagMetricsDocument, options);
+}
+export type GetGameTypeTagMetricsQueryHookResult = ReturnType<
+  typeof useGetGameTypeTagMetricsQuery
+>;
+export type GetGameTypeTagMetricsLazyQueryHookResult = ReturnType<
+  typeof useGetGameTypeTagMetricsLazyQuery
+>;
+export type GetGameTypeTagMetricsSuspenseQueryHookResult = ReturnType<
+  typeof useGetGameTypeTagMetricsSuspenseQuery
+>;
+export type GetGameTypeTagMetricsQueryResult = Apollo.QueryResult<
+  GetGameTypeTagMetricsQuery,
+  GetGameTypeTagMetricsQueryVariables
+>;
 export const FollowUserDocument = gql`
   mutation followUser($followedUserId: Int!) {
     followUser(followedUserId: $followedUserId) {

src/operations/user.gql

@@ -92,6 +92,17 @@ query GetUserTags {
   }
 }
 
+query GetGameTypeTagMetrics($input: GameTypeTagMetricsInput!) {
+  getGameTypeTagMetrics(input: $input) {
+    tagName
+    tagLabel
+    tableSize
+    shotCount
+    madeShots
+    makeRate
+  }
+}
+
 mutation followUser($followedUserId: Int!) {
   followUser(followedUserId: $followedUserId) {
     id

src/schema.gql

@@ -28,7 +28,7 @@ type Query {
   getLongestRunsLeaderboard(
     interval: TimeInterval = null
     when: DateTime = null
-    limit: Int! = 100
+    limit: Int! = 50
     requiredTags: [String!] = null
   ): RunLeaderboardGQL!
   getMakesLeaderboard(
@@ -49,6 +49,7 @@ type Query {
     limit: Int! = 500
     countRespectsLimit: Boolean! = false
   ): GetRunsResult!
+  videoPlayerClusters(videoId: Int!): [PlayerClusterGQL!]!
   getShotAnnotationTypes(errorTypes: Boolean = false): [ShotAnnotationTypeGQL!]!
   getTableState(
     b64Image: String!
@@ -860,6 +861,27 @@ input DatetimeOrdering {
   startingAt: DateTime = null
 }
 
+type PlayerClusterGQL {
+  videoId: Int!
+  clusterId: Int!
+  nShots: Int!
+  userId: Int
+  confirmed: Boolean!
+  shots: [PlayerClusterShotGQL!]!
+}
+
+type PlayerClusterShotGQL {
+  shotId: Int!
+  bboxX1: Int!
+  bboxY1: Int!
+  bboxX2: Int!
+  bboxY2: Int!
+  confidence: Float!
+  isConfirmed: Boolean!
+  cropUrl: String
+  fullFrameUrl: String
+}
+
 type TableStateGQL {
   identifierToPosition: [[Float!]!]!
   homography: HomographyInfoGQL
@@ -940,6 +962,7 @@ type UserRelationship {
 
 type StripeSubscriptionOptionsGQL {
   products: [StripeProductGQL!]!
+  trialPeriodDays: Int
 }
 
 type StripeProductGQL {
@@ -1093,6 +1116,9 @@ type Mutation {
   markAllNotificationsAsRead: Boolean!
   markNotificationsAsRead(notificationIds: [Int!]!): Boolean!
   deleteNotification(notificationId: Int!): Boolean!
+  finalizePlayerAssignments(
+    input: FinalizePlayerAssignmentsInput!
+  ): [PlayerClusterGQL!]!
   addAnnotationToShot(
     shotId: Int!
     annotationName: String!
@@ -1117,6 +1143,7 @@ type Mutation {
   ensureStripeCustomerExists: UserGQL!
   deleteUser: Boolean!
   createSubscription(priceId: String!): CreateSubscriptionResultGQL!
+  createCustomerPortalSession: CreateCustomerPortalSessionResultGQL!
   cancelSubscription: UserSubscriptionStatusGQL!
   grantManualEntitlement(
     userId: Int!
@@ -1163,6 +1190,22 @@ enum ReportReasonEnum {
   OTHER
 }
 
+input FinalizePlayerAssignmentsInput {
+  videoId: Int!
+  clusterAssignments: [ClusterAssignmentInput!]! = []
+  shotMoves: [ShotMoveInput!]! = []
+}
+
+input ClusterAssignmentInput {
+  clusterId: Int!
+  userId: Int = null
+}
+
+input ShotMoveInput {
+  shotId: Int!
+  newClusterId: Int!
+}
+
 type AddShotAnnotationReturn {
   value: SuccessfulAddAddShotAnnotationErrors!
 }
@@ -1256,6 +1299,10 @@ type CreateSubscriptionResultGQL {
   sessionId: String!
 }
 
+type CreateCustomerPortalSessionResultGQL {
+  portalUrl: String!
+}
+
 enum CancellationReasonEnum {
   DONT_PLAY_ENOUGH
   TOO_EXPENSIVE