Add camera-claim schema: venues, cameras, claim lifecycle

New query/mutation surface for the camera-claim flow: getVenues (with
per-camera availability), getActiveClaim, claimCamera, endClaim,
extendClaim, plus VenueGQL / VenueCameraGQL / CameraClaimGQL /
ClaimStatusEnum types.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

src/operations/config.gql

@@ -6,6 +6,7 @@ query getDeployedConfig {
     firebase
     minimumAllowedAppVersion
     subscriptionGatingEnabled
+    quotaEnforcementEnabled
     bannerMessages {
       color
       dismissible

src/operations/feed.gql

@@ -47,6 +47,12 @@ fragment VideoCardFields on VideoGQL {
   pocketSize
   tags {
     name
+    tagClasses {
+      name
+    }
+  }
+  playerSummaries {
+    ...PlayerSummaryFields
   }
   currentProcessing {
     id
@@ -95,6 +101,27 @@ query GetVideoFeedSessionCount(
   }
 }
 
+# Minimal query for the Home recency nudge ("you haven't recorded in N days").
+# Only the most recent session's start time — avoids pulling the full
+# VideoCardFields payload (reactions, comments, player summaries, etc.).
+query GetLastSessionDate(
+  $filters: VideoFilterInput = null
+  $includePrivate: IncludePrivateEnum = MINE
+  $feedInput: VideoFeedInputGQL = null
+) {
+  getFeedVideos(
+    limit: 1
+    filters: $filters
+    includePrivate: $includePrivate
+    feedInput: $feedInput
+  ) {
+    videos {
+      id
+      startTime
+    }
+  }
+}
+
 query GetVideoFeed(
   $limit: Int! = 5
   $after: String = null

src/operations/shooter.gql

@@ -1,3 +1,18 @@
+fragment PlayerSummaryFields on PlayerSummaryGQL {
+  clusterId
+  userId
+  username
+  profileImageUri
+  representativeFullFrameUrl
+  totalShots
+  totalShotsMade
+  makePercentage
+  score
+  longestRun
+  averageDifficulty
+  averageTimeBetweenShots
+}
+
 fragment PlayerClusterShotFields on PlayerClusterShotGQL {
   shotId
   bboxX1
@@ -15,7 +30,10 @@ fragment PlayerClusterFields on PlayerClusterGQL {
   clusterId
   nShots
   userId
+  username
+  profileImageUri
   confirmed
+  score
   shots {
     ...PlayerClusterShotFields
   }

src/operations/shots.gql

@@ -132,6 +132,38 @@ query GetShotsByIds($ids: [Int!]!) {
   }
 }
 
+# Lightweight clip boundaries for condensed session playback. The inline
+# session player only needs each shot's frame/time window to seek between
+# shots — this skips the heavy ShotWithAllFeatures payload (cue/pocketing
+# features, serialized shot paths, annotations, nested video/playlist). The
+# startTime/endTime @client resolvers derive their values from the frame
+# fields + the video (looked up internally), so this is all they require.
+fragment ShotClipRange on ShotGQL {
+  id
+  videoId
+  startFrame
+  endFrame
+  startTime @client
+  endTime @client
+}
+
+query GetShotClipRanges(
+  $filterInput: FilterInput!
+  $shotsOrdering: GetShotsOrdering
+  $limit: Int
+) {
+  getOrderedShots(
+    filterInput: $filterInput
+    shotsOrdering: $shotsOrdering
+    limit: $limit
+  ) {
+    count
+    shots {
+      ...ShotClipRange
+    }
+  }
+}
+
 fragment ShotWithAllFeatures on ShotGQL {
   id
   videoId

src/operations/user.gql

@@ -49,6 +49,39 @@ query GetUserPlayTime($userId: Int!, $filters: VideoFilterInput) {
   }
 }
 
+query GetUploadQuotaStatus {
+  getQuotaStatus {
+    tierName
+    periodStart
+    periodEnd
+    durationUsedSeconds
+    durationLimitSeconds
+    maxVideoDurationSeconds
+    durationRemainingSeconds
+    canUpload
+    importQuotaBuckets {
+      quotaKey
+      appliesToUploadKind
+      periodStart
+      periodEnd
+      durationUsedSeconds
+      durationLimitSeconds
+      durationRemainingSeconds
+      canUpload
+    }
+    recordingQuotaBuckets {
+      quotaKey
+      appliesToUploadKind
+      periodStart
+      periodEnd
+      durationUsedSeconds
+      durationLimitSeconds
+      durationRemainingSeconds
+      canUpload
+    }
+  }
+}
+
 query getUsernames(
   $matchString: String!
   $limit: Int = null

src/operations/video.gql

@@ -83,6 +83,9 @@ query GetVideoDetails($videoId: Int!) {
       }
       name
     }
+    playerSummaries {
+      ...PlayerSummaryFields
+    }
   }
 }
 
@@ -136,6 +139,15 @@ query GetVideoSocialDetailsById($videoId: Int!) {
   }
 }
 
+# Full card payload for a single video — reuses the same VideoCardFields
+# fragment the feed list uses, so the session-detail meta header shares one
+# source of truth (and the normalized Apollo cache) with the feed card.
+query GetVideoCard($videoId: Int!) {
+  getVideo(videoId: $videoId) {
+    ...VideoCardFields
+  }
+}
+
 query GetVideos($videoIds: [Int!]!) {
   getVideos(videoIds: $videoIds) {
     ...VideoStreamMetadata

src/schema.gql

@@ -11,6 +11,8 @@ type Query {
   myChallengeInvitations: [ChallengeInvitation!]!
   ruleSets: [RuleSet!]!
   myChallengeEntries: [ChallengeEntry!]!
+  getVenues: [VenueGQL!]!
+  getActiveClaim: CameraClaimGQL
   getDeployedConfig: DeployedConfigGQL!
   waitFor(duration: Float!): Float!
   getFeedVideos(
@@ -406,6 +408,7 @@ type VideoGQL {
   currentProcessing: VideoProcessingGQL
   reactions: [ReactionGQL!]!
   comments: [CommentGQL!]!
+  playerSummaries: [PlayerSummaryGQL!]!
 }
 
 type ShotGQL {
@@ -665,6 +668,63 @@ type CommentGQL {
   replies: [CommentGQL!]!
 }
 
+type PlayerSummaryGQL {
+  clusterId: Int!
+  userId: Int
+  username: String
+  profileImageUri: String
+  representativeFullFrameUrl: String
+  totalShots: Int!
+  totalShotsMade: Int!
+  makePercentage: Float!
+  score: Int
+  longestRun: Int!
+  averageDifficulty: Float
+  averageTimeBetweenShots: Float
+}
+
+type VenueGQL {
+  id: Int!
+  name: String!
+  latitude: Float
+  longitude: Float
+  cameras: [VenueCameraGQL!]!
+}
+
+type VenueCameraGQL {
+  id: Int!
+  venueId: Int!
+  tableLabel: String!
+  enabled: Boolean!
+  isAvailable: Boolean!
+}
+
+type CameraClaimGQL {
+  id: Int!
+  cameraId: Int!
+  userId: Int!
+  videoId: Int
+  status: ClaimStatusEnum!
+  expiresAt: DateTime
+  endedAt: DateTime
+  createdAt: DateTime!
+}
+
+enum ClaimStatusEnum {
+  REQUESTED
+  CODE_ISSUED
+  SCANNING
+  SCAN_CONFIRMED
+  INGESTING
+  ACTIVE
+  ENDED_BY_USER
+  EXPIRED
+  STREAM_LOST
+  STREAM_UNREACHABLE
+  CODE_EXPIRED
+  RELEASED_INACTIVE
+}
+
 type DeployedConfigGQL {
   allowNewUsers: Boolean!
   firebase: Boolean!
@@ -672,6 +732,7 @@ type DeployedConfigGQL {
   environment: String!
   minimumAllowedAppVersion: String!
   subscriptionGatingEnabled: Boolean!
+  quotaEnforcementEnabled: Boolean!
   bannerMessages: [BannerGQL!]!
   defaultAndroidRecordingFormat: StreamSegmentTypeEnum!
   bucketUrl: String!
@@ -866,7 +927,10 @@ type PlayerClusterGQL {
   clusterId: Int!
   nShots: Int!
   userId: Int
+  username: String
+  profileImageUri: String
   confirmed: Boolean!
+  score: Int
   shots: [PlayerClusterShotGQL!]!
 }
 
@@ -1021,6 +1085,19 @@ type QuotaStatusGQL {
   durationUsedSeconds: Float!
   durationLimitSeconds: Int
   maxVideoDurationSeconds: Int
+  importQuotaBuckets: [QuotaBucketStatusGQL!]!
+  recordingQuotaBuckets: [QuotaBucketStatusGQL!]!
+  durationRemainingSeconds: Float
+  canUpload: Boolean!
+}
+
+type QuotaBucketStatusGQL {
+  quotaKey: String!
+  appliesToUploadKind: String!
+  periodStart: DateTime!
+  periodEnd: DateTime!
+  durationUsedSeconds: Float!
+  durationLimitSeconds: Int
   durationRemainingSeconds: Float
   canUpload: Boolean!
 }
@@ -1096,6 +1173,9 @@ type Mutation {
   submitChallengeEntry(entryId: ID!, videoId: ID!): ChallengeEntry!
   dismissChallenge(challengeId: ID!): Boolean!
   undismissChallenge(challengeId: ID!): Boolean!
+  claimCamera(cameraId: Int!, durationMinutes: Int! = 60): CameraClaimGQL!
+  endClaim(claimId: Int!): CameraClaimGQL!
+  extendClaim(claimId: Int!, additionalMinutes: Int! = 60): CameraClaimGQL!
   setLoggerLevel(path: String!, level: String!): Boolean!
   reactToVideo(videoId: Int!, reaction: ReactionEnum): Boolean!
   commentOnVideo(
@@ -1199,6 +1279,7 @@ input FinalizePlayerAssignmentsInput {
 input ClusterAssignmentInput {
   clusterId: Int!
   userId: Int = null
+  score: Int = null
 }
 
 input ShotMoveInput {