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;
@@ -2462,7 +2480,6 @@ export type MutationCreateSubscriptionArgs = {
 
 export type MutationCreateUploadStreamArgs = {
   expectedDurationSeconds?: InputMaybe<Scalars["Float"]["input"]>;
-  uploadKind?: InputMaybe<UploadKindEnum>;
   videoMetadata: VideoMetadataInput;
 };
 
@@ -2512,6 +2529,10 @@ export type MutationEditUserArgs = {
   input: EditUserInputGql;
 };
 
+export type MutationFinalizePlayerAssignmentsArgs = {
+  input: FinalizePlayerAssignmentsInput;
+};
+
 export type MutationFindPrerecordTableLayoutArgs = {
   b64Image: Scalars["String"]["input"];
   videoId: Scalars["Int"]["input"];
@@ -2674,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",
@@ -2784,6 +2828,7 @@ export type Query = {
   notifications: NotificationConnection;
   ruleSets: Array<RuleSet>;
   unreadNotificationCount: Scalars["Int"]["output"];
+  videoPlayerClusters: Array<PlayerClusterGql>;
   waitFor: Scalars["Float"]["output"];
 };
 
@@ -2950,6 +2995,10 @@ export type QueryNotificationsArgs = {
   offset?: Scalars["Int"]["input"];
 };
 
+export type QueryVideoPlayerClustersArgs = {
+  videoId: Scalars["Int"]["input"];
+};
+
 export type QueryWaitForArgs = {
   duration: Scalars["Float"]["input"];
 };
@@ -2960,11 +3009,9 @@ export type QuotaStatusGql = {
   durationLimitSeconds?: Maybe<Scalars["Int"]["output"]>;
   durationRemainingSeconds?: Maybe<Scalars["Float"]["output"]>;
   durationUsedSeconds: Scalars["Float"]["output"];
-  importUploadPermission: UploadPermissionGql;
   maxVideoDurationSeconds?: Maybe<Scalars["Int"]["output"]>;
   periodEnd: Scalars["DateTime"]["output"];
   periodStart: Scalars["DateTime"]["output"];
-  recordingPermission: UploadPermissionGql;
   tierName: Scalars["String"]["output"];
 };
 
@@ -3169,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;
@@ -3267,6 +3319,7 @@ export type StripeProductGql = {
 export type StripeSubscriptionOptionsGql = {
   __typename?: "StripeSubscriptionOptionsGQL";
   products: Array<StripeProductGql>;
+  trialPeriodDays?: Maybe<Scalars["Int"]["output"]>;
 };
 
 export enum StripeSubscriptionStatusEnum {
@@ -3350,11 +3403,6 @@ export type UpdateShotAnnotationReturn = {
   shot?: Maybe<ShotGql>;
 };
 
-export enum UploadKindEnum {
-  Import = "IMPORT",
-  Recording = "RECORDING",
-}
-
 export type UploadLink = {
   __typename?: "UploadLink";
   headers: Array<Maybe<Header>>;
@@ -3367,12 +3415,6 @@ export type UploadLinkGetProfileUploadLinkErrors =
 
 export type UploadLinkGetUploadLinkErrors = GetUploadLinkErrors | UploadLink;
 
-export type UploadPermissionGql = {
-  __typename?: "UploadPermissionGQL";
-  allowed: Scalars["Boolean"]["output"];
-  reason?: Maybe<Scalars["String"]["output"]>;
-};
-
 export type UploadSegmentGql = {
   __typename?: "UploadSegmentGQL";
   durationInSeconds?: Maybe<Scalars["Float"]["output"]>;

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 {
@@ -998,17 +1021,10 @@ type QuotaStatusGQL {
   durationUsedSeconds: Float!
   durationLimitSeconds: Int
   maxVideoDurationSeconds: Int
-  recordingPermission: UploadPermissionGQL!
-  importUploadPermission: UploadPermissionGQL!
   durationRemainingSeconds: Float
   canUpload: Boolean!
 }
 
-type UploadPermissionGQL {
-  allowed: Boolean!
-  reason: String
-}
-
 type UserPlayTimeGQL {
   totalSeconds: Float!
 }
@@ -1100,6 +1116,9 @@ type Mutation {
   markAllNotificationsAsRead: Boolean!
   markNotificationsAsRead(notificationIds: [Int!]!): Boolean!
   deleteNotification(notificationId: Int!): Boolean!
+  finalizePlayerAssignments(
+    input: FinalizePlayerAssignmentsInput!
+  ): [PlayerClusterGQL!]!
   addAnnotationToShot(
     shotId: Int!
     annotationName: String!
@@ -1124,6 +1143,7 @@ type Mutation {
   ensureStripeCustomerExists: UserGQL!
   deleteUser: Boolean!
   createSubscription(priceId: String!): CreateSubscriptionResultGQL!
+  createCustomerPortalSession: CreateCustomerPortalSessionResultGQL!
   cancelSubscription: UserSubscriptionStatusGQL!
   grantManualEntitlement(
     userId: Int!
@@ -1141,7 +1161,6 @@ type Mutation {
   findPrerecordTableLayout(b64Image: String!, videoId: Int!): HomographyInfoGQL
   createUploadStream(
     videoMetadata: VideoMetadataInput!
-    uploadKind: UploadKindEnum = null
     expectedDurationSeconds: Float = null
   ): CreateUploadStreamReturn!
   getUploadLink(videoId: Int!, segmentIndex: Int!): GetUploadLinkReturn!
@@ -1171,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!
 }
@@ -1264,6 +1299,10 @@ type CreateSubscriptionResultGQL {
   sessionId: String!
 }
 
+type CreateCustomerPortalSessionResultGQL {
+  portalUrl: String!
+}
+
 enum CancellationReasonEnum {
   DONT_PLAY_ENOUGH
   TOO_EXPENSIVE
@@ -1310,11 +1349,6 @@ input VideoResolution {
   height: Int!
 }
 
-enum UploadKindEnum {
-  RECORDING
-  IMPORT
-}
-
 type GetUploadLinkReturn {
   value: UploadLinkGetUploadLinkErrors!
   stream: UploadStreamGQL